UpdateDatasetMetadata and UpdateFileMetadata use cases: use sourceLastUpdateTime

[g-saracca]

What this PR does / why we need it:

Updates the use cases UpdateDatasetMetadata and UpdateFileMetadata to use sourceLastUpdateTime query parameter for optimistic concurrency control.

Which issue(s) this PR closes:

• Closes File and Dataset use cases: extend to use sourceLastUpdateTime #343

Suggestions on how to test this:

Check test are passing.

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

Yes, added.

[Copilot]

Pull Request Overview

This PR extends the file and dataset update functionality to use sourceLastUpdateTime for optimistic concurrency control, replacing the previous internalVersionNumber approach for datasets and adding time-based conflict detection for file metadata updates.

• Replaces internalVersionNumber parameter with sourceLastUpdateTime for dataset updates
• Adds lastUpdateTime field to file models and enables optimistic locking for file metadata updates
• Updates all transformers to use string-based timestamps instead of Date objects for lastUpdateTime

Reviewed Changes

Copilot reviewed 18 out of 18 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/datasets/domain/models/Dataset.ts	Changes lastUpdateTime from Date to string type
src/datasets/domain/repositories/IDatasetsRepository.ts	Replaces internalVersionNumber with sourceLastUpdateTime parameter
src/datasets/domain/useCases/UpdateDataset.ts	Updates method signature and documentation for new timestamp-based approach
src/datasets/infra/repositories/DatasetsRepository.ts	Implements sourceLastUpdateTime query parameter instead of sourceInternalVersionNumber
src/datasets/infra/repositories/transformers/datasetTransformers.ts	Removes Date conversion for lastUpdateTime field
src/datasets/infra/repositories/transformers/datasetPreviewsTransformers.ts	Removes Date conversion for lastUpdateTime field
src/files/domain/models/FileModel.ts	Adds required lastUpdateTime field
src/files/domain/repositories/IFilesRepository.ts	Adds optional sourceLastUpdateTime parameter
src/files/domain/useCases/UpdateFileMetadata.ts	Adds sourceLastUpdateTime parameter with documentation
src/files/infra/repositories/FilesRepository.ts	Implements conditional sourceLastUpdateTime query parameter
src/files/infra/repositories/transformers/FilePayload.ts	Adds required lastUpdateTime field
src/files/infra/repositories/transformers/fileTransformers.ts	Maps lastUpdateTime from payload to model
test/integration/datasets/DatasetsRepository.test.ts	Updates test to use new timestamp-based conflict detection
test/integration/files/FilesRepository.test.ts	Adds comprehensive test for file metadata optimistic locking
test/testHelpers/datasets/datasetHelper.ts	Updates to use string instead of Date for lastUpdateTime
test/testHelpers/datasets/datasetPreviewHelper.ts	Updates to use string instead of Date for lastUpdateTime
test/testHelpers/files/filesHelper.ts	Adds lastUpdateTime field to test helpers
test/unit/files/UpdateFileMetadata.test.ts	Updates test expectations to include new undefined parameter

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[ekraffmiller]

looks good, approved

[ofahimIQSS]

Looks good, merging