feat: add use case

Author: g-saracca

src/files/domain/repositories/IFilesRepository.ts

@@ -59,4 +59,6 @@ export interface IFilesRepository {
     datasetId: number | string,
     uploadedFileDTOs: UploadedFileDTO[]
   ): Promise<undefined>
+
+  deleteFile(fileId: number | string): Promise<undefined>
 }

src/files/domain/useCases/DeleteFile.ts

@@ -0,0 +1,17 @@
+import { IFilesRepository } from '../repositories/IFilesRepository'
+import { UseCase } from '../../../core/domain/useCases/UseCase'
+
+export class DeleteFile implements UseCase<void> {
+  constructor(private readonly filesRepository: IFilesRepository) {}
+
+  /**
+   * Deletes a file.
+   * More detailed information about the file deletion behavior can be found in https://guides.dataverse.org/en/latest/api/native-api.html#deleting-files
+   *
+   * @param {number | string} [fileId] - The File identifier, which can be a string (for persistent identifiers), or a number (for numeric identifiers).
+   * @returns {Promise<void>} -This method does not return anything upon successful completion.
+   */
+  async execute(fileId: number | string): Promise<void> {
+    return await this.filesRepository.deleteFile(fileId)
+  }
+}

src/files/index.ts

@@ -11,6 +11,7 @@ import { GetFileAndDataset } from './domain/useCases/GetFileAndDataset'
 import { UploadFile } from './domain/useCases/UploadFile'
 import { DirectUploadClient } from './infra/clients/DirectUploadClient'
 import { AddUploadedFilesToDataset } from './domain/useCases/AddUploadedFilesToDataset'
+import { DeleteFile } from './domain/useCases/DeleteFile'
 
 const filesRepository = new FilesRepository()
 const directUploadClient = new DirectUploadClient(filesRepository)
@@ -26,6 +27,7 @@ const getFileAndDataset = new GetFileAndDataset(filesRepository)
 const getFileCitation = new GetFileCitation(filesRepository)
 const uploadFile = new UploadFile(directUploadClient)
 const addUploadedFilesToDataset = new AddUploadedFilesToDataset(filesRepository)
+const deleteFile = new DeleteFile(filesRepository)
 
 export {
   getDatasetFiles,
@@ -38,7 +40,8 @@ export {
   getFileAndDataset,
   getFileCitation,
   uploadFile,
-  addUploadedFilesToDataset
+  addUploadedFilesToDataset,
+  deleteFile
 }
 
 export { FileModel as File, FileEmbargo, FileChecksum } from './domain/models/FileModel'

src/files/infra/repositories/FilesRepository.ts

@@ -293,4 +293,12 @@ export class FilesRepository extends ApiRepository implements IFilesRepository {
       queryParams.searchText = fileSearchCriteria.searchText
     }
   }
+
+  public async deleteFile(fileId: number | string): Promise<undefined> {
+    return this.doDelete(this.buildApiEndpoint(this.filesResourceName, undefined, fileId))
+      .then(() => undefined)
+      .catch((error) => {
+        throw error
+      })
+  }
 }