Extend get guestbooks use case with stats and Download responses

[ChengShi-1]

What this PR does / why we need it:

• Get Guestbooks By Collection Id: Added optional includeStats support to getGuestbooksByCollectionId, returning usageCount and responseCount when requested.
• write use cases of downloading all responses of a collection or download responses of a guestbook

Which issue(s) this PR closes:

• Closes Add usage and response counts to get guestbooks use case #448

Related Dataverse PRs:

• Depends on #

Special notes for your reviewer:

Test failed about storage drive, so I also copy pastes a CollectionHelper.ts from this PR. waiting to be merged
https://github.com/IQSS/dataverse-client-javascript/pull/431/changes#diff-edac108c1a43d5773116d19797d04ecdf890fc97b5cf83ce2d56d38b9a7aca18

Suggestions on how to test this:

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

Additional documentation:

[Copilot]

Pull request overview

Adds optional guestbook usage/response statistics support to the “get guestbooks by collection” flow, aligning the client with the Dataverse API enhancement needed for the Manage Guestbooks UI.

Changes:

• Extended getGuestbooksByCollectionId to accept an optional includeStats flag and send it as a query parameter when enabled.
• Updated the Guestbook domain model to optionally expose usageCount and responseCount.
• Added/updated unit + integration tests, plus documentation and changelog entries.

Reviewed changes

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

Show a summary per file

File	Description
test/unit/guestbooks/GuestbooksRepository.test.ts	New unit coverage for repository query param behavior and error handling.
test/unit/guestbooks/GetGuestbooksByCollectionId.test.ts	Adds unit coverage for the use case passing includeStats.
test/integration/guestbooks/GuestbooksRepository.test.ts	Adds integration coverage for listing stats and verifying count changes via assignment + guest response submission.
src/guestbooks/infra/repositories/GuestbooksRepository.ts	Adds includeStats param and forwards it as query params when true.
src/guestbooks/domain/useCases/GetGuestbooksByCollectionId.ts	Extends use case API to accept includeStats.
src/guestbooks/domain/repositories/IGuestbooksRepository.ts	Updates repository interface to include optional includeStats.
src/guestbooks/domain/models/Guestbook.ts	Adds optional usageCount and responseCount fields.
docs/useCases.md	Documents the new includeStats parameter and updates example usage.
CHANGELOG.md	Adds an Unreleased entry describing the new includeStats support.

---

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