File: Use Case Get Available Dataset File Categories

[ChengShi-1]

What this PR does / why we need it:

In JSF, when we update Tags -> Edit Tags, there is a list of available categories populated from the dropdown lists, and some of them could be customized categories from other files in the same dataset.

Which issue(s) this PR closes:

• Closes File: Use Cases Get Available Dataset File Categories #336

Related Dataverse PRs:

• Depends on 11634 api get available file categories dataverse#11668

Special notes for your reviewer:

RoleHelper for testing changed because Revert "feat: "Link Dataset/Dataverse" permission"

Suggestions on how to test this:

Is there a release notes update needed for this change?:

Additional documentation:

[Copilot]

Pull Request Overview

This PR introduces a new use case to retrieve available file categories for a dataset, which supports the JSF feature for populating category dropdown lists when editing file tags. The categories include both default categories and custom categories from other files in the same dataset.

• Adds GetDatasetAvailableCategories use case and repository method
• Updates documentation links for existing file metadata update use cases
• Removes deprecated LinkDataverse and LinkDataset permissions from role definitions

Reviewed Changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/datasets/domain/useCases/GetDatasetAvailableCategories.ts	Implements new use case to retrieve available file categories for a dataset
src/datasets/infra/repositories/DatasetsRepository.ts	Adds repository method to fetch available categories from API endpoint
src/datasets/domain/repositories/IDatasetsRepository.ts	Adds interface method for getting dataset available categories
src/datasets/index.ts	Exports the new use case for public consumption
test/integration/datasets/DatasetsRepository.test.ts	Adds integration tests for the new repository method
test/functional/datasets/GetDatasetAvailableCategories.test.ts	Adds functional tests for the new use case
docs/useCases.md	Documents the new use case with usage examples
src/files/domain/useCases/UpdateFileTabularTags.ts	Fixes documentation URL fragment for tabular tags
src/files/domain/useCases/UpdateFileCategories.ts	Fixes documentation URL fragment for file categories
test/testHelpers/roles/roleHelper.ts	Removes deprecated link permissions from role definitions

[g-saracca]

Looks good, just one comment.

[ofahimIQSS]

hello! can you resolve the conflicts please :)

[g-saracca]

hello! can you resolve the conflicts please :)

All yours @ofahimIQSS

[ofahimIQSS]

looks good - merging