Add use case for setting default contributor

[vera]

What this PR does / why we need it:

This PR adds code for setting the default contributor role of a collection.

Which issue(s) this PR closes:

/

Related Dataverse PRs:

/

Special notes for your reviewer:

/

Suggestions on how to test this:

I've added tests and docs on how to use.

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

Yes

Additional documentation:

[Copilot]

Pull request overview

This PR adds a new Collections use case to set a collection’s default contributor role (Dataverse endpoint for assigning the default role to users creating datasets in a collection), wiring it through the repository layer, public exports, docs, and unit tests.

Changes:

• Add SetDefaultContributorRole use case and expose it from the collections public API.
• Implement setDefaultContributorRole in CollectionsRepository and add it to ICollectionsRepository.
• Document the new use case and add a unit test for the use case behavior.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
test/unit/collections/SetDefaultContributorRole.test.ts	Adds unit tests for the new use case.
src/collections/infra/repositories/CollectionsRepository.ts	Adds repository method calling the Dataverse API endpoint via PUT.
src/collections/index.ts	Exposes the new use case from the collections module.
src/collections/domain/useCases/SetDefaultContributorRole.ts	Introduces the new use case implementation and JSDoc.
src/collections/domain/repositories/ICollectionsRepository.ts	Extends the repository interface with the new method.
docs/useCases.md	Documents the new use case and adds it to the use-cases list.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[ChengShi-1]

Hi Vera, thanks for your contribution! Here are some suggestions

• Merge with dev to update
• update Changelog.md
• For roleAlias(see roles in Dataverse), we could have a built-in reference to export, similar toFileCitationFormat.ts in js-dataverse
  • For example, export enum RoleAlias { ADMIN = 'Admin', ...}
• add integration test proving the setDefault is working in different conditions
  • Successfully set a role, if possible, please check GET collection return a correct roleAlias
  • If this parameter is not set, the default value is: ':root'
  • maybe a few error conditions
• run npm run format npx prettier . --check before your commit to clear the format

[ChengShi-1]

Hi Vera, thanks for your contribution! Here are some suggestions

• Merge with dev to update

• update Changelog.md

• For roleAlias(see roles in Dataverse), we could have a built-in reference to export, similar toFileCitationFormat.ts in js-dataverse

  • For example, export enum RoleAlias { ADMIN = 'Admin', ...}

• add integration test proving the setDefault is working in different conditions

  • Successfully set a role, if possible, please check GET collection return a correct roleAlias
  • If this parameter is not set, the default value is: ':root'
  • maybe a few error conditions

• run npm run format npx prettier . --check before your commit to clear the format

Hi @vera , sorry I forgot to @ you earlier. Just mentioning you here in case you have time to follow up.

[vera]

@ChengShi-1 thanks for the reminder. I'll be on vacation for the rest of the month, but I'll be picking this up again in August (along with my other open PRs in this repo).

[vera]

Hey @ChengShi-1 , I think I've resolved all the feedback now.

For the integration test, I think currently there is no existing use case that allows to check that the correct roleAlias has been stored, but I've still added a simple integration test.

I've recently had a PR for a "Get default contributor role" API be merged into main Dataverse (IQSS/dataverse#12112), and I plan to open a separate PR for that in this repo.

[ChengShi-1]

Hey @ChengShi-1 , I think I've resolved all the feedback now.

For the integration test, I think currently there is no existing use case that allows to check that the correct roleAlias has been stored, but I've still added a simple integration test.

I've recently had a PR for a "Get default contributor role" API be merged into main Dataverse (IQSS/dataverse#12112), and I plan to open a separate PR for that in this repo.

Thanks, Vera! I'll review and QA it soon

[ChengShi-1]

Looks good!

Some lint errors in the following files, I suggest to run npx prettier --write . to fix all them. Also, you could run npm run lint to verify.

• SetDefaultContributorRole.ts:25
• roles/index.ts:11 (missing final newline)
• SetDefaultContributorRole.test.ts:12,23
• integration SetDefaultContributorRole.test.ts:53