@maas/payload-plugin-media-cloud 0.0.31 → 0.0.33

package/dist/tus/stores/s3/{file-operations.d.mts → fileOperations.d.mts}

@@ -1,6 +1,6 @@
 import AWS from "@aws-sdk/client-s3";
 
-//#region src/tus/stores/s3/file-operations.d.ts
+//#region src/tus/stores/s3/fileOperations.d.ts
 type CalculateOptimalPartSizeArgs = {
   size?: number;
 };
@@ -63,4 +63,4 @@ declare class S3FileOperations {
 declare function calculateOffsetFromParts(args: CalculateOffsetFromPartsExportArgs): number;
 //#endregion
 export { S3FileOperations, calculateOffsetFromParts };
-//# sourceMappingURL=file-operations.d.mts.map
+//# sourceMappingURL=fileOperations.d.mts.map

package/dist/tus/stores/s3/{file-operations.mjs → fileOperations.mjs}

@@ -5,7 +5,7 @@ import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 
-//#region src/tus/stores/s3/file-operations.ts
+//#region src/tus/stores/s3/fileOperations.ts
 const { throwError } = useErrorHandler();
 var S3FileOperations = class {
 	constructor(maxMultipartParts, maxUploadSize, minPartSize, preferredPartSize) {
@@ -86,4 +86,4 @@ function calculateOffsetFromParts(args) {
 
 //#endregion
 export { S3FileOperations, calculateOffsetFromParts };
-//# sourceMappingURL=file-operations.mjs.map
+//# sourceMappingURL=fileOperations.mjs.map

package/dist/tus/stores/s3/fileOperations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileOperations.mjs","names":["crypto","fs","os","path","useErrorHandler","MediaCloudErrors","NodeFSError","AWS","CalculateOptimalPartSizeArgs","size","CalculateOffsetFromPartsArgs","parts","Array","Part","CalculatePartNumberArgs","GenerateUniqueTmpFileNameArgs","template","CalculateOffsetFromPartsExportArgs","Size","throwError","S3FileOperations","constructor","maxMultipartParts","maxUploadSize","minPartSize","preferredPartSize","calculateOptimalPartSize","args","uploadSize","undefined","optimalPartSize","Math","ceil","max","calculateOffsetFromParts","length","reduce","a","b","calculatePartNumber","PartNumber","generateUniqueTmpFileName","Promise","tries","i","randomId","randomBytes","toString","filePath","join","tmpdir","promises","access","constants","F_OK","error","nodeError","code","S3_UNIQUE_NAME_ERROR","Error"],"sources":["../../../../src/tus/stores/s3/fileOperations.ts"],"sourcesContent":["import crypto from 'node:crypto'\nimport fs from 'node:fs'\nimport os from 'node:os'\nimport path from 'node:path'\n\nimport { useErrorHandler } from '../../../hooks/useErrorHandler'\nimport { MediaCloudErrors } from '../../../types/errors'\n\nimport type { NodeFSError } from '../../../types'\nimport type AWS from '@aws-sdk/client-s3'\n\ntype CalculateOptimalPartSizeArgs = {\n  size?: number\n}\n\ntype CalculateOffsetFromPartsArgs = {\n  parts?: Array<AWS.Part>\n}\n\ntype CalculatePartNumberArgs = {\n  parts: Array<AWS.Part>\n}\n\ntype GenerateUniqueTmpFileNameArgs = {\n  template: string\n}\n\ntype CalculateOffsetFromPartsExportArgs = {\n  parts?: Array<{ Size?: number }>\n}\n\nconst { throwError } = useErrorHandler()\n\nexport class S3FileOperations {\n  constructor(\n    private maxMultipartParts: number,\n    private maxUploadSize: number,\n    private minPartSize: number,\n    private preferredPartSize: number\n  ) {}\n\n  /**\n   * Calculates the optimal part size for S3 multipart upload\n   * @param args - The function arguments\n   * @param args.size - The upload size in bytes (optional)\n   * @returns The optimal part size in bytes\n   */\n  calculateOptimalPartSize(args: CalculateOptimalPartSizeArgs): number {\n    const { size } = args\n    // When upload size is not known, default to preferredPartSize\n    // Assuming maxUploadSize can lead to extremely large chunks (hundreds of GB),\n    // which breaks streaming/resumable uploads in practice\n    let uploadSize = size\n    if (uploadSize === undefined) {\n      uploadSize = this.preferredPartSize\n    }\n\n    let optimalPartSize: number\n\n    // When upload is smaller or equal to preferredPartSize, upload in just one part\n    if (uploadSize <= this.preferredPartSize) {\n      optimalPartSize = uploadSize\n    }\n    // Does the upload fit in maxMultipartParts parts or less with preferredPartSize\n    else if (uploadSize <= this.preferredPartSize * this.maxMultipartParts) {\n      optimalPartSize = this.preferredPartSize\n      // The upload is too big for the preferred size\n      // We divide the size with the max amount of parts and round it up\n    } else {\n      optimalPartSize = Math.ceil(uploadSize / this.maxMultipartParts)\n    }\n\n    // Always ensure the part size is at least minPartSize\n    return Math.max(optimalPartSize, this.minPartSize)\n  }\n\n  /**\n   * Calculates the offset based on uploaded parts\n   * @param args - The function arguments\n   * @param args.parts - Array of uploaded parts (optional)\n   * @returns The total offset in bytes\n   */\n  calculateOffsetFromParts(args: CalculateOffsetFromPartsArgs): number {\n    const { parts } = args\n    return parts && parts.length > 0\n      ? parts.reduce((a, b) => a + (b.Size ?? 0), 0)\n      : 0\n  }\n\n  /**\n   * Calculates the next part number based on existing parts\n   * @param args - The function arguments\n   * @param args.parts - Array of uploaded parts\n   * @returns The next part number to use\n   */\n  calculatePartNumber(args: CalculatePartNumberArgs): number {\n    const { parts } = args\n    return parts.length > 0 ? parts[parts.length - 1].PartNumber! + 1 : 1\n  }\n\n  /**\n   * Generates a unique temporary file name\n   * @param args - The function arguments\n   * @param args.template - The template string for the file name\n   * @returns Promise that resolves to the unique file path\n   * @throws Error if unable to find unique name after max tries\n   */\n  async generateUniqueTmpFileName(\n    args: GenerateUniqueTmpFileNameArgs\n  ): Promise<string> {\n    const { template } = args\n    const tries = 5\n    for (let i = 0; i < tries; i++) {\n      const randomId = crypto.randomBytes(16).toString('hex')\n      const filePath = path.join(os.tmpdir(), `${template}${randomId}`)\n      try {\n        await fs.promises.access(filePath, fs.constants.F_OK)\n      } catch (error) {\n        const nodeError = error as NodeFSError\n        if (nodeError.code === 'ENOENT') {\n          return filePath\n        }\n      }\n    }\n    throwError(MediaCloudErrors.S3_UNIQUE_NAME_ERROR)\n    throw new Error() // This will never execute but satisfies TypeScript\n  }\n}\n\n/**\n * Calculates the total offset from uploaded parts\n * @param args - The function arguments\n * @param args.parts - Array of parts with size information (optional)\n * @returns The total offset in bytes\n */\nexport function calculateOffsetFromParts(\n  args: CalculateOffsetFromPartsExportArgs\n) {\n  const { parts } = args\n  return parts && parts.length > 0\n    ? parts.reduce((a, b) => a + (b.Size ?? 0), 0)\n    : 0\n}\n"],"mappings":";;;;;;;;AA+BA,MAAM,EAAEmB,eAAef,iBAAiB;AAExC,IAAagB,mBAAb,MAA8B;CAC5BC,YACE,AAAQC,mBACR,AAAQC,eACR,AAAQC,aACR,AAAQC,mBACR;EAJQH;EACAC;EACAC;EACAC;;;;;;;;CASVC,yBAAyBC,MAA4C;EACnE,MAAM,EAAElB,SAASkB;EAIjB,IAAIC,aAAanB;AACjB,MAAImB,eAAeC,OACjBD,cAAa,KAAKH;EAGpB,IAAIK;AAGJ,MAAIF,cAAc,KAAKH,kBACrBK,mBAAkBF;WAGXA,cAAc,KAAKH,oBAAoB,KAAKH,kBACnDQ,mBAAkB,KAAKL;MAIvBK,mBAAkBC,KAAKC,KAAKJ,aAAa,KAAKN,kBAAkB;AAIlE,SAAOS,KAAKE,IAAIH,iBAAiB,KAAKN,YAAY;;;;;;;;CASpDU,yBAAyBP,MAA4C;EACnE,MAAM,EAAEhB,UAAUgB;AAClB,SAAOhB,SAASA,MAAMwB,SAAS,IAC3BxB,MAAMyB,QAAQC,GAAGC,MAAMD,KAAKC,EAAEpB,QAAQ,IAAI,EAAE,GAC5C;;;;;;;;CASNqB,oBAAoBZ,MAAuC;EACzD,MAAM,EAAEhB,UAAUgB;AAClB,SAAOhB,MAAMwB,SAAS,IAAIxB,MAAMA,MAAMwB,SAAS,GAAGK,aAAc,IAAI;;;;;;;;;CAUtE,MAAMC,0BACJd,MACiB;EACjB,MAAM,EAAEX,aAAaW;EACrB,MAAMgB,QAAQ;AACd,OAAK,IAAIC,IAAI,GAAGA,IAAID,OAAOC,KAAK;GAC9B,MAAMC,WAAW7C,OAAO8C,YAAY,GAAG,CAACC,SAAS,MAAM;GACvD,MAAMC,WAAW7C,KAAK8C,KAAK/C,GAAGgD,QAAQ,EAAE,GAAGlC,WAAW6B,WAAW;AACjE,OAAI;AACF,UAAM5C,GAAGkD,SAASC,OAAOJ,UAAU/C,GAAGoD,UAAUC,KAAK;YAC9CC,OAAO;AAEd,QADkBA,MACJE,SAAS,SACrB,QAAOT;;;AAIb7B,aAAWd,iBAAiBqD,qBAAqB;AACjD,QAAM,IAAIC,OAAO;;;;;;;;;AAUrB,SAAgBzB,yBACdP,MACA;CACA,MAAM,EAAEhB,UAAUgB;AAClB,QAAOhB,SAASA,MAAMwB,SAAS,IAC3BxB,MAAMyB,QAAQC,GAAGC,MAAMD,KAAKC,EAAEpB,QAAQ,IAAI,EAAE,GAC5C"}

package/dist/tus/stores/s3/index.d.mts

@@ -1,5 +1,5 @@
 import { MediaCloudPluginOptions } from "../../../types/index.mjs";
-import { S3Store } from "./s3-store.mjs";
+import { S3Store } from "./s3Store.mjs";
 
 //#region src/tus/stores/s3/index.d.ts
 

package/dist/tus/stores/s3/index.mjs

@@ -1,9 +1,20 @@
 import { MediaCloudErrors } from "../../../types/errors.mjs";
-import { useErrorHandler } from "../../../hooks/useErrorHandler.mjs";
-import { S3Store } from "./s3-store.mjs";
+import { useMagicError } from "../../../error-handler/dist/index.mjs";
+import { S3Store } from "./s3Store.mjs";
 
 //#region src/tus/stores/s3/index.ts
-const { throwError } = useErrorHandler();
+const magicError = useMagicError({ prefix: "PLUGIN-MEDIA-CLOUD" });
+/**
+* Validates S3 configuration options
+* @param s3Config - The S3 configuration to validate
+* @throws {Error} When required S3 configuration is missing
+*/
+function validateS3Config(s3Config) {
+	magicError.assert(s3Config?.bucket, MediaCloudErrors.S3_CONFIG_MISSING);
+	magicError.assert(s3Config?.region, MediaCloudErrors.S3_CONFIG_MISSING);
+	magicError.assert(s3Config?.accessKeyId, MediaCloudErrors.S3_CONFIG_MISSING);
+	magicError.assert(s3Config?.secretAccessKey, MediaCloudErrors.S3_CONFIG_MISSING);
+}
 /**
 * Creates and configures an S3Store instance
 * @param s3Config - The S3 configuration options
@@ -11,17 +22,17 @@ const { throwError } = useErrorHandler();
 * @throws {Error} When required S3 configuration is missing
 */
 function createS3Store(s3Config) {
-	if (!s3Config?.bucket || !s3Config?.region || !s3Config?.accessKeyId || !s3Config?.secretAccessKey) throwError(MediaCloudErrors.S3_CONFIG_MISSING);
+	validateS3Config(s3Config);
 	return new S3Store({ s3ClientConfig: {
 		acl: "public-read",
-		bucket: s3Config.bucket,
+		bucket: s3Config?.bucket ?? "",
 		credentials: {
-			accessKeyId: s3Config.accessKeyId,
-			secretAccessKey: s3Config.secretAccessKey
+			accessKeyId: s3Config?.accessKeyId ?? "",
+			secretAccessKey: s3Config?.secretAccessKey ?? ""
 		},
-		endpoint: s3Config.endpoint,
+		endpoint: s3Config?.endpoint ?? "",
 		forcePathStyle: true,
-		region: s3Config.region
+		region: s3Config?.region ?? ""
 	} });
 }
 

package/dist/tus/stores/s3/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/tus/stores/s3/index.ts"],"sourcesContent":["import { MediaCloudErrors } from '../../../types/errors'\nimport { S3Store } from './s3-store'\nimport { useErrorHandler } from '../../../hooks/useErrorHandler'\n\nimport type { MediaCloudPluginOptions } from '../../../types'\n\nconst { throwError } = useErrorHandler()\n\n/**\n * Creates and configures an S3Store instance\n * @param s3Config - The S3 configuration options\n * @returns A configured S3Store instance\n * @throws {Error} When required S3 configuration is missing\n */\nexport function createS3Store(\n  s3Config: MediaCloudPluginOptions['s3']\n): S3Store {\n  // Validate S3 configuration\n  if (\n    !s3Config?.bucket ||\n    !s3Config?.region ||\n    !s3Config?.accessKeyId ||\n    !s3Config?.secretAccessKey\n  ) {\n    throwError(MediaCloudErrors.S3_CONFIG_MISSING)\n  }\n\n  // Create and return S3Store instance\n  return new S3Store({\n    s3ClientConfig: {\n      acl: 'public-read',\n      bucket: s3Config.bucket,\n      credentials: {\n        accessKeyId: s3Config.accessKeyId,\n        secretAccessKey: s3Config.secretAccessKey,\n      },\n      endpoint: s3Config.endpoint,\n      forcePathStyle: true,\n      region: s3Config.region,\n    },\n  })\n}\n"],"mappings":";;;;;AAMA,MAAM,EAAE,eAAe,iBAAiB;;;;;;;AAQxC,SAAgB,cACd,UACS;AAET,KACE,CAAC,UAAU,UACX,CAAC,UAAU,UACX,CAAC,UAAU,eACX,CAAC,UAAU,gBAEX,YAAW,iBAAiB,kBAAkB;AAIhD,QAAO,IAAI,QAAQ,EACjB,gBAAgB;EACd,KAAK;EACL,QAAQ,SAAS;EACjB,aAAa;GACX,aAAa,SAAS;GACtB,iBAAiB,SAAS;GAC3B;EACD,UAAU,SAAS;EACnB,gBAAgB;EAChB,QAAQ,SAAS;EAClB,EACF,CAAC"}
+{"version":3,"file":"index.mjs","names":["MediaCloudErrors","S3Store","useMagicError","MediaCloudPluginOptions","UseMagicErrorReturn","magicError","prefix","validateS3Config","s3Config","assert","bucket","S3_CONFIG_MISSING","region","accessKeyId","secretAccessKey","createS3Store","s3ClientConfig","acl","credentials","endpoint","forcePathStyle"],"sources":["../../../../src/tus/stores/s3/index.ts"],"sourcesContent":["import { MediaCloudErrors } from '../../../types/errors'\nimport { S3Store } from './s3Store'\nimport { useMagicError } from '@maas/error-handler'\n\nimport type { MediaCloudPluginOptions } from '../../../types'\nimport type { UseMagicErrorReturn } from '@maas/error-handler'\n\nconst magicError: UseMagicErrorReturn = useMagicError({\n  prefix: 'PLUGIN-MEDIA-CLOUD',\n})\n\n/**\n * Validates S3 configuration options\n * @param s3Config - The S3 configuration to validate\n * @throws {Error} When required S3 configuration is missing\n */\nfunction validateS3Config(s3Config: MediaCloudPluginOptions['s3']): void {\n  magicError.assert(s3Config?.bucket, MediaCloudErrors.S3_CONFIG_MISSING)\n  magicError.assert(s3Config?.region, MediaCloudErrors.S3_CONFIG_MISSING)\n  magicError.assert(s3Config?.accessKeyId, MediaCloudErrors.S3_CONFIG_MISSING)\n  magicError.assert(\n    s3Config?.secretAccessKey,\n    MediaCloudErrors.S3_CONFIG_MISSING\n  )\n}\n\n/**\n * Creates and configures an S3Store instance\n * @param s3Config - The S3 configuration options\n * @returns A configured S3Store instance\n * @throws {Error} When required S3 configuration is missing\n */\nexport function createS3Store(\n  s3Config: MediaCloudPluginOptions['s3']\n): S3Store {\n  validateS3Config(s3Config)\n\n  return new S3Store({\n    s3ClientConfig: {\n      acl: 'public-read',\n      bucket: s3Config?.bucket ?? '',\n      credentials: {\n        accessKeyId: s3Config?.accessKeyId ?? '',\n        secretAccessKey: s3Config?.secretAccessKey ?? '',\n      },\n      endpoint: s3Config?.endpoint ?? '',\n      forcePathStyle: true,\n      region: s3Config?.region ?? '',\n    },\n  })\n}\n"],"mappings":";;;;;AAOA,MAAMK,aAAkCH,cAAc,EACpDI,QAAQ,sBACT,CAAC;;;;;;AAOF,SAASC,iBAAiBC,UAA+C;AACvEH,YAAWI,OAAOD,UAAUE,QAAQV,iBAAiBW,kBAAkB;AACvEN,YAAWI,OAAOD,UAAUI,QAAQZ,iBAAiBW,kBAAkB;AACvEN,YAAWI,OAAOD,UAAUK,aAAab,iBAAiBW,kBAAkB;AAC5EN,YAAWI,OACTD,UAAUM,iBACVd,iBAAiBW,kBAClB;;;;;;;;AASH,SAAgBI,cACdP,UACS;AACTD,kBAAiBC,SAAS;AAE1B,QAAO,IAAIP,QAAQ,EACjBe,gBAAgB;EACdC,KAAK;EACLP,QAAQF,UAAUE,UAAU;EAC5BQ,aAAa;GACXL,aAAaL,UAAUK,eAAe;GACtCC,iBAAiBN,UAAUM,mBAAmB;GAC/C;EACDK,UAAUX,UAAUW,YAAY;EAChCC,gBAAgB;EAChBR,QAAQJ,UAAUI,UAAU;EAC9B,EACD,CAAC"}

package/dist/tus/stores/s3/{metadata-manager.d.mts → metadataManager.d.mts}

@@ -2,12 +2,13 @@ import { TusUploadMetadata } from "../../../types/index.mjs";
 import { S3 } from "@aws-sdk/client-s3";
 import { Upload } from "@tus/utils";
 
-//#region src/tus/stores/s3/metadata-manager.d.ts
+//#region src/tus/stores/s3/metadataManager.d.ts
 type GenerateInfoKeyArgs = {
   id: string;
 };
 type GeneratePartKeyArgs = {
   id: string;
+  prefix?: string;
   isIncomplete?: boolean;
 };
 type GetMetadataArgs = {
@@ -37,6 +38,7 @@ declare class S3MetadataManager {
    * Generates the S3 key for part files
    * @param args - The function arguments
    * @param args.id - The file ID
+   * @param args.prefix - Path prefix for nested media items
    * @param args.isIncomplete - Whether this is an incomplete part
    * @returns The S3 key for the part file
    */
@@ -68,4 +70,4 @@ declare class S3MetadataManager {
 }
 //#endregion
 export { S3MetadataManager };
-//# sourceMappingURL=metadata-manager.d.mts.map
+//# sourceMappingURL=metadataManager.d.mts.map

package/dist/tus/stores/s3/{metadata-manager.mjs → metadataManager.mjs}

@@ -2,7 +2,7 @@ import { MediaCloudLogs } from "../../../types/errors.mjs";
 import { useErrorHandler } from "../../../hooks/useErrorHandler.mjs";
 import { TUS_RESUMABLE, Upload } from "@tus/utils";
 
-//#region src/tus/stores/s3/metadata-manager.ts
+//#region src/tus/stores/s3/metadataManager.ts
 const { log } = useErrorHandler();
 var S3MetadataManager = class {
 	constructor(client, bucket, shouldUseExpirationTags, generateCompleteTag) {
@@ -18,19 +18,20 @@ var S3MetadataManager = class {
 	* @returns The S3 key for the metadata file
 	*/
 	generateInfoKey(args) {
-		const { id } = args;
-		return `${id}.info`;
+		return `${args.id}.info`;
 	}
 	/**
 	* Generates the S3 key for part files
 	* @param args - The function arguments
 	* @param args.id - The file ID
+	* @param args.prefix - Path prefix for nested media items
 	* @param args.isIncomplete - Whether this is an incomplete part
 	* @returns The S3 key for the part file
 	*/
 	generatePartKey(args) {
-		const { id, isIncomplete = false } = args;
+		const { id, prefix, isIncomplete = false } = args;
 		let key = id;
+		if (prefix) key = `${prefix}/${key}`;
 		if (isIncomplete) key += ".part";
 		return key;
 	}
@@ -110,4 +111,4 @@ var S3MetadataManager = class {
 
 //#endregion
 export { S3MetadataManager };
-//# sourceMappingURL=metadata-manager.mjs.map
+//# sourceMappingURL=metadataManager.mjs.map

package/dist/tus/stores/s3/metadataManager.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadataManager.mjs","names":["TUS_RESUMABLE","Upload","useErrorHandler","MediaCloudLogs","S3","TusUploadMetadata","GenerateInfoKeyArgs","id","GeneratePartKeyArgs","prefix","isIncomplete","GetMetadataArgs","SaveMetadataArgs","upload","uploadId","CompleteMetadataArgs","log","S3MetadataManager","constructor","client","bucket","shouldUseExpirationTags","generateCompleteTag","value","generateInfoKey","args","generatePartKey","key","getMetadata","Promise","Body","Metadata","getObject","Bucket","Key","file","JSON","parse","transformToString","parsedSize","size","undefined","Number","metadata","creation_date","offset","parseInt","isFinite","storage","saveMetadata","S3_STORE_METADATA_SAVING","putObject","stringify","Tagging","S3_STORE_METADATA_SAVED","completeMetadata"],"sources":["../../../../src/tus/stores/s3/metadataManager.ts"],"sourcesContent":["import { TUS_RESUMABLE, Upload } from '@tus/utils'\n\nimport { useErrorHandler } from '../../../hooks/useErrorHandler'\nimport { MediaCloudLogs } from '../../../types/errors'\n\nimport type { S3 } from '@aws-sdk/client-s3'\nimport type { TusUploadMetadata } from '../../../types'\n\ntype GenerateInfoKeyArgs = {\n  id: string\n}\n\ntype GeneratePartKeyArgs = {\n  id: string\n  prefix?: string\n  isIncomplete?: boolean\n}\n\ntype GetMetadataArgs = {\n  id: string\n}\n\ntype SaveMetadataArgs = {\n  upload: Upload\n  uploadId: string\n}\n\ntype CompleteMetadataArgs = {\n  upload: Upload\n}\n\nconst { log } = useErrorHandler()\n\nexport class S3MetadataManager {\n  constructor(\n    private client: S3,\n    private bucket: string,\n    private shouldUseExpirationTags: () => boolean,\n    private generateCompleteTag: (value: 'false' | 'true') => string | undefined\n  ) {}\n  /**\n   * Generates the S3 key for metadata info files\n   * @param args - The function arguments\n   * @param args.id - The file ID\n   * @returns The S3 key for the metadata file\n   */\n  generateInfoKey(args: GenerateInfoKeyArgs): string {\n    return `${args.id}.info`\n  }\n\n  /**\n   * Generates the S3 key for part files\n   * @param args - The function arguments\n   * @param args.id - The file ID\n   * @param args.prefix - Path prefix for nested media items\n   * @param args.isIncomplete - Whether this is an incomplete part\n   * @returns The S3 key for the part file\n   */\n  generatePartKey(args: GeneratePartKeyArgs): string {\n    const { id, prefix, isIncomplete = false } = args\n    let key = id\n\n    if (prefix) {\n      key = `${prefix}/${key}`\n    }\n\n    if (isIncomplete) {\n      key += '.part'\n    }\n\n    // TODO: introduce ObjectPrefixing for parts and incomplete parts\n    // ObjectPrefix is prepended to the name of each S3 object that is created\n    // to store uploaded files. It can be used to create a pseudo-directory\n    // structure in the bucket, e.g. \"path/to/my/uploads\".\n    return key\n  }\n\n  /**\n   * Retrieves upload metadata previously saved in `${file_id}.info`.\n   * Always fetches fresh data from S3 to ensure correctness.\n   * @param args - The function arguments\n   * @param args.id - The file ID to retrieve metadata for\n   * @returns Promise that resolves to the upload metadata\n   */\n  async getMetadata(args: GetMetadataArgs): Promise<TusUploadMetadata> {\n    const { id } = args\n\n    const { Body, Metadata } = await this.client.getObject({\n      Bucket: this.bucket,\n      Key: this.generateInfoKey({ id }),\n    })\n\n    const file = JSON.parse((await Body?.transformToString()) as string)\n\n    const parsedSize =\n      file.size === undefined || file.size === null\n        ? undefined\n        : Number(file.size)\n\n    const metadata: TusUploadMetadata = {\n      file: new Upload({\n        id,\n        creation_date: file.creation_date,\n        metadata: file.metadata,\n        offset: Number.parseInt(file.offset, 10),\n        size: Number.isFinite(parsedSize) ? parsedSize : undefined,\n        storage: file.storage,\n      }),\n      'tus-version': Metadata?.['tus-version'] as string,\n      'upload-id': (Metadata?.['upload-id'] || file['upload-id']) as string,\n    }\n\n    return metadata\n  }\n\n  /**\n   * Saves upload metadata to a `${file_id}.info` file on S3.\n   * The upload-id is stored in the S3 object metadata.\n   * @param args - The function arguments\n   * @param args.upload - The upload object containing metadata\n   * @param args.uploadId - The upload ID for the multipart upload\n   * @returns Promise that resolves when metadata is saved\n   */\n  async saveMetadata(args: SaveMetadataArgs): Promise<void> {\n    const { upload, uploadId } = args\n    log(MediaCloudLogs.S3_STORE_METADATA_SAVING)\n\n    await this.client.putObject({\n      Body: JSON.stringify(upload),\n      Bucket: this.bucket,\n      Key: this.generateInfoKey({ id: upload.id }),\n      Metadata: {\n        'tus-version': TUS_RESUMABLE,\n        'upload-id': uploadId,\n      },\n      Tagging: this.generateCompleteTag('false'),\n    })\n    log(MediaCloudLogs.S3_STORE_METADATA_SAVED)\n  }\n\n  /**\n   * Completes metadata by updating it with completion tags\n   * @param args - The function arguments\n   * @param args.upload - The completed upload object\n   * @returns Promise that resolves when metadata is updated\n   */\n  async completeMetadata(args: CompleteMetadataArgs): Promise<void> {\n    const { upload } = args\n\n    if (!this.shouldUseExpirationTags()) {\n      return\n    }\n\n    const metadata = await this.getMetadata({ id: upload.id })\n    const { 'upload-id': uploadId } = metadata\n\n    await this.client.putObject({\n      Body: JSON.stringify(upload),\n      Bucket: this.bucket,\n      Key: this.generateInfoKey({ id: upload.id }),\n      Metadata: {\n        'tus-version': TUS_RESUMABLE,\n        'upload-id': uploadId,\n      },\n      Tagging: this.generateCompleteTag('true'),\n    })\n  }\n}\n"],"mappings":";;;;;AA+BA,MAAM,EAAEgB,QAAQd,iBAAiB;AAEjC,IAAae,oBAAb,MAA+B;CAC7BC,YACE,AAAQC,QACR,AAAQC,QACR,AAAQC,yBACR,AAAQC,qBACR;EAJQH;EACAC;EACAC;EACAC;;;;;;;;CAQVE,gBAAgBC,MAAmC;AACjD,SAAO,GAAGA,KAAKlB,GAAE;;;;;;;;;;CAWnBmB,gBAAgBD,MAAmC;EACjD,MAAM,EAAElB,IAAIE,QAAQC,eAAe,UAAUe;EAC7C,IAAIE,MAAMpB;AAEV,MAAIE,OACFkB,OAAM,GAAGlB,OAAM,GAAIkB;AAGrB,MAAIjB,aACFiB,QAAO;AAOT,SAAOA;;;;;;;;;CAUT,MAAMC,YAAYH,MAAmD;EACnE,MAAM,EAAElB,OAAOkB;EAEf,MAAM,EAAEK,MAAMC,aAAa,MAAM,KAAKZ,OAAOa,UAAU;GACrDC,QAAQ,KAAKb;GACbc,KAAK,KAAKV,gBAAgB,EAAEjB,IAAI,CAAA;GACjC,CAAC;EAEF,MAAM4B,OAAOC,KAAKC,MAAO,MAAMP,MAAMQ,mBAAmB,CAAY;EAEpE,MAAMC,aACJJ,KAAKK,SAASC,UAAaN,KAAKK,SAAS,OACrCC,SACAC,OAAOP,KAAKK,KAAK;AAevB,SAboC;GAClCL,MAAM,IAAIlC,OAAO;IACfM;IACAqC,eAAeT,KAAKS;IACpBD,UAAUR,KAAKQ;IACfE,QAAQH,OAAOI,SAASX,KAAKU,QAAQ,GAAG;IACxCL,MAAME,OAAOK,SAASR,WAAW,GAAGA,aAAaE;IACjDO,SAASb,KAAKa;IACf,CAAC;GACF,eAAejB,WAAW;GAC1B,aAAcA,WAAW,gBAAgBI,KAAK;GAC/C;;;;;;;;;;CAaH,MAAMc,aAAaxB,MAAuC;EACxD,MAAM,EAAEZ,QAAQC,aAAaW;AAC7BT,MAAIb,eAAe+C,yBAAyB;AAE5C,QAAM,KAAK/B,OAAOgC,UAAU;GAC1BrB,MAAMM,KAAKgB,UAAUvC,OAAO;GAC5BoB,QAAQ,KAAKb;GACbc,KAAK,KAAKV,gBAAgB,EAAEjB,IAAIM,OAAON,IAAI,CAAC;GAC5CwB,UAAU;IACR,eAAe/B;IACf,aAAac;IACd;GACDuC,SAAS,KAAK/B,oBAAoB,QAAO;GAC1C,CAAC;AACFN,MAAIb,eAAemD,wBAAwB;;;;;;;;CAS7C,MAAMC,iBAAiB9B,MAA2C;EAChE,MAAM,EAAEZ,WAAWY;AAEnB,MAAI,CAAC,KAAKJ,yBAAyB,CACjC;EAIF,MAAM,EAAE,aAAaP,aADJ,MAAM,KAAKc,YAAY,EAAErB,IAAIM,OAAON,IAAI,CAAC;AAG1D,QAAM,KAAKY,OAAOgC,UAAU;GAC1BrB,MAAMM,KAAKgB,UAAUvC,OAAO;GAC5BoB,QAAQ,KAAKb;GACbc,KAAK,KAAKV,gBAAgB,EAAEjB,IAAIM,OAAON,IAAI,CAAC;GAC5CwB,UAAU;IACR,eAAe/B;IACf,aAAac;IACd;GACDuC,SAAS,KAAK/B,oBAAoB,OAAM;GACzC,CAAC"}

package/dist/tus/stores/s3/{parts-manager.d.mts → partsManager.d.mts}

@@ -1,12 +1,12 @@
 import { Semaphore } from "./semaphore.mjs";
-import { S3FileOperations } from "./file-operations.mjs";
 import { IncompletePartInfo, TusUploadMetadata } from "../../../types/index.mjs";
-import { S3MetadataManager } from "./metadata-manager.mjs";
+import { S3MetadataManager } from "./metadataManager.mjs";
+import { S3FileOperations } from "./fileOperations.mjs";
 import stream, { Readable } from "node:stream";
 import AWS, { S3 } from "@aws-sdk/client-s3";
 import fs from "node:fs";
 
-//#region src/tus/stores/s3/parts-manager.d.ts
+//#region src/tus/stores/s3/partsManager.d.ts
 type RetrievePartsArgs = {
   id: string;
   partNumberMarker?: string;
@@ -127,4 +127,4 @@ declare class S3PartsManager {
 }
 //#endregion
 export { S3PartsManager };
-//# sourceMappingURL=parts-manager.d.mts.map
+//# sourceMappingURL=partsManager.d.mts.map

package/dist/tus/stores/s3/{parts-manager.mjs → partsManager.mjs}

@@ -6,7 +6,7 @@ import { StreamSplitter } from "@tus/utils";
 import fs from "node:fs";
 import os from "node:os";
 
-//#region src/tus/stores/s3/parts-manager.ts
+//#region src/tus/stores/s3/partsManager.ts
 const { log, throwError } = useErrorHandler();
 var S3PartsManager = class {
 	constructor(client, bucket, minPartSize, partUploadSemaphore, metadataManager, fileOperations, generateCompleteTag) {
@@ -35,7 +35,10 @@ var S3PartsManager = class {
 		}
 		const params = {
 			Bucket: this.bucket,
-			Key: id,
+			Key: this.metadataManager.generatePartKey({
+				id,
+				prefix: metadata.file.metadata?.prefix ?? void 0
+			}),
 			PartNumberMarker: partNumberMarker,
 			UploadId: metadata["upload-id"]
 		};
@@ -62,8 +65,11 @@ var S3PartsManager = class {
 	async finishMultipartUpload(args) {
 		const { metadata, parts } = args;
 		const params = {
+			Key: this.metadataManager.generatePartKey({
+				id: metadata.file.id,
+				prefix: metadata.file.metadata?.prefix ?? void 0
+			}),
 			Bucket: this.bucket,
-			Key: metadata.file.id,
 			MultipartUpload: { Parts: parts.map((part) => {
 				return {
 					ETag: part.ETag,
@@ -74,8 +80,11 @@ var S3PartsManager = class {
 		};
 		try {
 			return (await this.client.completeMultipartUpload(params)).Location;
-		} catch (_error) {
-			throwError(MediaCloudErrors.TUS_UPLOAD_ERROR);
+		} catch (error) {
+			throwError({
+				...MediaCloudErrors.TUS_UPLOAD_ERROR,
+				cause: error
+			});
 			throw new Error();
 		}
 	}
@@ -88,10 +97,12 @@ var S3PartsManager = class {
 	async getIncompletePart(args) {
 		const { id } = args;
 		try {
+			const { file } = await this.metadataManager.getMetadata({ id });
 			return (await this.client.getObject({
 				Bucket: this.bucket,
 				Key: this.metadataManager.generatePartKey({
 					id,
+					prefix: file?.metadata?.prefix ?? void 0,
 					isIncomplete: true
 				})
 			})).Body;
@@ -109,11 +120,13 @@ var S3PartsManager = class {
 	async getIncompletePartSize(args) {
 		const { id } = args;
 		try {
+			const { file } = await this.metadataManager.getMetadata({ id });
 			return (await this.client.headObject({
 				Bucket: this.bucket,
 				Key: this.metadataManager.generatePartKey({
 					id,
-					isIncomplete: true
+					isIncomplete: true,
+					prefix: file?.metadata?.prefix ?? void 0
 				})
 			})).ContentLength;
 		} catch (error) {
@@ -129,13 +142,22 @@ var S3PartsManager = class {
 	*/
 	async deleteIncompletePart(args) {
 		const { id } = args;
-		await this.client.deleteObject({
-			Bucket: this.bucket,
-			Key: this.metadataManager.generatePartKey({
-				id,
-				isIncomplete: true
-			})
-		});
+		try {
+			const { file } = await this.metadataManager.getMetadata({ id });
+			await this.client.deleteObject({
+				Bucket: this.bucket,
+				Key: this.metadataManager.generatePartKey({
+					id,
+					isIncomplete: true,
+					prefix: file?.metadata?.prefix ?? void 0
+				})
+			});
+		} catch (error) {
+			throwError({
+				...MediaCloudErrors.S3_DELETE_ERROR,
+				cause: error
+			});
+		}
 	}
 	/**
 	* Downloads incomplete part to temporary file
@@ -187,17 +209,27 @@ var S3PartsManager = class {
 	*/
 	async uploadIncompletePart(args) {
 		const { id, readStream } = args;
-		const data = await this.client.putObject({
-			Body: readStream,
-			Bucket: this.bucket,
-			Key: this.metadataManager.generatePartKey({
-				id,
-				isIncomplete: true
-			}),
-			Tagging: this.generateCompleteTag("false")
-		});
-		log(MediaCloudLogs.S3_STORE_INCOMPLETE_PART_UPLOADED);
-		return data.ETag;
+		try {
+			const { file } = await this.metadataManager.getMetadata({ id });
+			const data = await this.client.putObject({
+				Body: readStream,
+				Bucket: this.bucket,
+				Key: this.metadataManager.generatePartKey({
+					id,
+					isIncomplete: true,
+					prefix: file?.metadata?.prefix ?? void 0
+				}),
+				Tagging: this.generateCompleteTag("false")
+			});
+			log(MediaCloudLogs.S3_STORE_INCOMPLETE_PART_UPLOADED);
+			return data.ETag;
+		} catch (error) {
+			throwError({
+				...MediaCloudErrors.TUS_UPLOAD_ERROR,
+				cause: error
+			});
+			throw error;
+		}
 	}
 	/**
 	* Uploads a single part
@@ -217,7 +249,10 @@ var S3PartsManager = class {
 		const params = {
 			Body: readStream,
 			Bucket: this.bucket,
-			Key: metadata.file.id,
+			Key: this.metadataManager.generatePartKey({
+				id: metadata.file.id,
+				prefix: metadata.file.metadata?.prefix ?? void 0
+			}),
 			PartNumber: partNumber,
 			UploadId: metadata["upload-id"]
 		};
@@ -226,9 +261,12 @@ var S3PartsManager = class {
 				ETag: (await this.client.uploadPart(params)).ETag,
 				PartNumber: partNumber
 			};
-		} catch (_error) {
-			throwError(MediaCloudErrors.TUS_UPLOAD_ERROR);
-			throw new Error();
+		} catch (error) {
+			throwError({
+				...MediaCloudErrors.TUS_UPLOAD_ERROR,
+				cause: error
+			});
+			throw error;
 		} finally {
 			permit();
 		}
@@ -320,4 +358,4 @@ var S3PartsManager = class {
 
 //#endregion
 export { S3PartsManager };
-//# sourceMappingURL=parts-manager.mjs.map
+//# sourceMappingURL=partsManager.mjs.map

package/dist/tus/stores/s3/partsManager.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"partsManager.mjs","names":["fs","os","stream","NoSuchKey","NotFound","S3","StreamSplitter","useErrorHandler","MediaCloudErrors","MediaCloudLogs","AWS","Readable","IncompletePartInfo","TusUploadMetadata","S3FileOperations","S3MetadataManager","Semaphore","SemaphorePermit","RetrievePartsArgs","id","partNumberMarker","FinishMultipartUploadArgs","metadata","parts","Array","Part","GetIncompletePartArgs","GetIncompletePartSizeArgs","DeleteIncompletePartArgs","DownloadIncompletePartArgs","UploadIncompletePartArgs","readStream","ReadStream","UploadPartArgs","partNumber","UploadPartsArgs","currentPartNumber","offset","log","throwError","S3PartsManager","constructor","client","bucket","minPartSize","partUploadSemaphore","metadataManager","fileOperations","generateCompleteTag","value","retrieveParts","args","Promise","getMetadata","MUX_UPLOAD_ID_MISSING","Error","params","ListPartsCommandInput","Bucket","Key","generatePartKey","prefix","file","undefined","PartNumberMarker","UploadId","data","listParts","Parts","IsTruncated","rest","NextPartNumberMarker","sort","a","b","PartNumber","finishMultipartUpload","MultipartUpload","map","part","ETag","result","completeMultipartUpload","Location","error","TUS_UPLOAD_ERROR","cause","getIncompletePart","getObject","isIncomplete","Body","getIncompletePartSize","headObject","ContentLength","deleteIncompletePart","deleteObject","S3_DELETE_ERROR","downloadIncompletePart","incompletePart","filePath","generateUniqueTmpFileName","template","incompletePartSize","byteCounterTransform","Transform","transform","chunk","_","callback","length","promises","pipeline","createWriteStream","createReadStream","options","cleanUpOnEnd","fileReader","on","unlink","err","destroy","createReader","path","size","rm","catch","uploadIncompletePart","putObject","Tagging","S3_STORE_INCOMPLETE_PART_UPLOADED","uploadPart","permit","acquire","UploadPartCommandInput","uploadParts","initialOffset","pendingChunkFilepath","bytesUploaded","splitterStream","chunkSize","calculateOptimalPartSize","directory","tmpdir","filepath","partSize","acquiredPermit","isFinalPart","uploadChunk","readable","mappedError","String","deferred","push","S3_STORE_CHUNK_REMOVAL_FAILED","reject","allSettled","all"],"sources":["../../../../src/tus/stores/s3/partsManager.ts"],"sourcesContent":["import fs from 'node:fs'\nimport os from 'node:os'\nimport stream from 'node:stream'\n\nimport { NoSuchKey, NotFound, type S3 } from '@aws-sdk/client-s3'\nimport { StreamSplitter } from '@tus/utils'\n\nimport { useErrorHandler } from '../../../hooks/useErrorHandler'\nimport { MediaCloudErrors, MediaCloudLogs } from '../../../types/errors'\n\nimport type AWS from '@aws-sdk/client-s3'\nimport type { Readable } from 'node:stream'\nimport type { IncompletePartInfo, TusUploadMetadata } from '../../../types'\nimport type { S3FileOperations } from './fileOperations'\nimport type { S3MetadataManager } from './metadataManager'\nimport type { Semaphore, SemaphorePermit } from './semaphore'\n\ntype RetrievePartsArgs = {\n  id: string\n  partNumberMarker?: string\n}\n\ntype FinishMultipartUploadArgs = {\n  metadata: TusUploadMetadata\n  parts: Array<AWS.Part>\n}\n\ntype GetIncompletePartArgs = {\n  id: string\n}\n\ntype GetIncompletePartSizeArgs = {\n  id: string\n}\n\ntype DeleteIncompletePartArgs = {\n  id: string\n}\n\ntype DownloadIncompletePartArgs = {\n  id: string\n}\n\ntype UploadIncompletePartArgs = {\n  id: string\n  readStream: fs.ReadStream | Readable\n}\n\ntype UploadPartArgs = {\n  metadata: TusUploadMetadata\n  readStream: fs.ReadStream | Readable\n  partNumber: number\n}\n\ntype UploadPartsArgs = {\n  metadata: TusUploadMetadata\n  readStream: stream.Readable\n  currentPartNumber: number\n  offset: number\n}\n\nconst { log, throwError } = useErrorHandler()\n\nexport class S3PartsManager {\n  constructor(\n    private client: S3,\n    private bucket: string,\n    private minPartSize: number,\n    private partUploadSemaphore: Semaphore,\n    private metadataManager: S3MetadataManager,\n    private fileOperations: S3FileOperations,\n    private generateCompleteTag: (value: 'false' | 'true') => string | undefined\n  ) {}\n\n  /**\n   * Gets the number of complete parts/chunks already uploaded to S3.\n   * Retrieves only consecutive parts.\n   * @param args - The function arguments\n   * @param args.id - The upload ID\n   * @param args.partNumberMarker - Marker for pagination (optional)\n   * @returns Promise that resolves to array of uploaded parts\n   */\n  async retrieveParts(args: RetrievePartsArgs): Promise<Array<AWS.Part>> {\n    const { id, partNumberMarker } = args\n    const metadata = await this.metadataManager.getMetadata({ id })\n\n    if (!metadata['upload-id']) {\n      throwError(MediaCloudErrors.MUX_UPLOAD_ID_MISSING)\n      throw new Error() // This will never execute but satisfies TypeScript\n    }\n\n    const params: AWS.ListPartsCommandInput = {\n      Bucket: this.bucket,\n      Key: this.metadataManager.generatePartKey({\n        id,\n        prefix: metadata.file.metadata?.prefix ?? undefined,\n      }),\n      PartNumberMarker: partNumberMarker,\n      UploadId: metadata['upload-id'],\n    }\n\n    const data = await this.client.listParts(params)\n\n    let parts = data.Parts ?? []\n\n    if (data.IsTruncated) {\n      const rest = await this.retrieveParts({\n        id,\n        partNumberMarker: data.NextPartNumberMarker,\n      })\n      parts = [...parts, ...rest]\n    }\n\n    if (!partNumberMarker) {\n      parts.sort((a, b) => (a.PartNumber || 0) - (b.PartNumber || 0))\n    }\n\n    return parts\n  }\n\n  /**\n   * Completes a multipart upload on S3.\n   * This is where S3 concatenates all the uploaded parts.\n   * @param args - The function arguments\n   * @param args.metadata - The upload metadata\n   * @param args.parts - Array of uploaded parts to complete\n   * @returns Promise that resolves to the location URL (optional)\n   */\n  async finishMultipartUpload(\n    args: FinishMultipartUploadArgs\n  ): Promise<string | undefined> {\n    const { metadata, parts } = args\n\n    const params = {\n      Key: this.metadataManager.generatePartKey({\n        id: metadata.file.id,\n        prefix: metadata.file.metadata?.prefix ?? undefined,\n      }),\n      Bucket: this.bucket,\n      MultipartUpload: {\n        Parts: parts.map((part) => {\n          return {\n            ETag: part.ETag,\n            PartNumber: part.PartNumber,\n          }\n        }),\n      },\n      UploadId: metadata['upload-id'],\n    }\n\n    try {\n      const result = await this.client.completeMultipartUpload(params)\n      return result.Location\n    } catch (error) {\n      throwError({ ...MediaCloudErrors.TUS_UPLOAD_ERROR, cause: error })\n      throw new Error() // This will never execute but satisfies TypeScript\n    }\n  }\n\n  /**\n   * Gets incomplete part from S3\n   * @param args - The function arguments\n   * @param args.id - The upload ID\n   * @returns Promise that resolves to readable stream or undefined if not found\n   */\n  async getIncompletePart(\n    args: GetIncompletePartArgs\n  ): Promise<Readable | undefined> {\n    const { id } = args\n\n    try {\n      const { file } = await this.metadataManager.getMetadata({ id })\n\n      const data = await this.client.getObject({\n        Bucket: this.bucket,\n        Key: this.metadataManager.generatePartKey({\n          id,\n          prefix: file?.metadata?.prefix ?? undefined,\n          isIncomplete: true,\n        }),\n      })\n      return data.Body as Readable\n    } catch (error) {\n      if (error instanceof NoSuchKey) {\n        return undefined\n      }\n      throw error\n    }\n  }\n\n  /**\n   * Gets the size of an incomplete part\n   * @param args - The function arguments\n   * @param args.id - The upload ID\n   * @returns Promise that resolves to part size or undefined if not found\n   */\n  async getIncompletePartSize(\n    args: GetIncompletePartSizeArgs\n  ): Promise<number | undefined> {\n    const { id } = args\n\n    try {\n      const { file } = await this.metadataManager.getMetadata({ id })\n\n      const data = await this.client.headObject({\n        Bucket: this.bucket,\n        Key: this.metadataManager.generatePartKey({\n          id,\n          isIncomplete: true,\n          prefix: file?.metadata?.prefix ?? undefined,\n        }),\n      })\n      return data.ContentLength\n    } catch (error) {\n      if (error instanceof NotFound) {\n        return undefined\n      }\n      throw error\n    }\n  }\n\n  /**\n   * Deletes an incomplete part\n   * @param args - The function arguments\n   * @param args.id - The upload ID\n   * @returns Promise that resolves when deletion is complete\n   */\n  async deleteIncompletePart(args: DeleteIncompletePartArgs): Promise<void> {\n    const { id } = args\n\n    try {\n      const { file } = await this.metadataManager.getMetadata({ id })\n\n      await this.client.deleteObject({\n        Bucket: this.bucket,\n        Key: this.metadataManager.generatePartKey({\n          id,\n          isIncomplete: true,\n          prefix: file?.metadata?.prefix ?? undefined,\n        }),\n      })\n    } catch (error) {\n      throwError({\n        ...MediaCloudErrors.S3_DELETE_ERROR,\n        cause: error,\n      })\n    }\n  }\n\n  /**\n   * Downloads incomplete part to temporary file\n   * @param args - The function arguments\n   * @param args.id - The upload ID\n   * @returns Promise that resolves to incomplete part info or undefined if not found\n   */\n  async downloadIncompletePart(\n    args: DownloadIncompletePartArgs\n  ): Promise<IncompletePartInfo | undefined> {\n    const { id } = args\n    const incompletePart = await this.getIncompletePart({ id })\n\n    if (!incompletePart) {\n      return\n    }\n    const filePath = await this.fileOperations.generateUniqueTmpFileName({\n      template: 'tus-s3-incomplete-part-',\n    })\n\n    try {\n      let incompletePartSize = 0\n\n      const byteCounterTransform = new stream.Transform({\n        transform(chunk, _, callback) {\n          incompletePartSize += chunk.length\n          callback(null, chunk)\n        },\n      })\n\n      // Write to temporary file\n      await stream.promises.pipeline(\n        incompletePart,\n        byteCounterTransform,\n        fs.createWriteStream(filePath)\n      )\n\n      const createReadStream = (options: { cleanUpOnEnd: boolean }) => {\n        const fileReader = fs.createReadStream(filePath)\n\n        if (options.cleanUpOnEnd) {\n          fileReader.on('end', () => {\n            fs.unlink(filePath, () => {})\n          })\n\n          fileReader.on('error', (err) => {\n            fileReader.destroy(err)\n            fs.unlink(filePath, () => {})\n          })\n        }\n\n        return fileReader\n      }\n\n      return {\n        createReader: createReadStream,\n        path: filePath,\n        size: incompletePartSize,\n      }\n    } catch (err) {\n      fs.promises.rm(filePath).catch(() => {})\n      throw err\n    }\n  }\n\n  /**\n   * Uploads an incomplete part\n   * @param args - The function arguments\n   * @param args.id - The upload ID\n   * @param args.readStream - The stream to read data from\n   * @returns Promise that resolves to the ETag of the uploaded part\n   */\n  async uploadIncompletePart(args: UploadIncompletePartArgs): Promise<string> {\n    const { id, readStream } = args\n    try {\n      const { file } = await this.metadataManager.getMetadata({ id })\n\n      const data = await this.client.putObject({\n        Body: readStream,\n        Bucket: this.bucket,\n        Key: this.metadataManager.generatePartKey({\n          id,\n          isIncomplete: true,\n          prefix: file?.metadata?.prefix ?? undefined,\n        }),\n        Tagging: this.generateCompleteTag('false'),\n      })\n      log(MediaCloudLogs.S3_STORE_INCOMPLETE_PART_UPLOADED)\n      return data.ETag as string\n    } catch (error) {\n      throwError({ ...MediaCloudErrors.TUS_UPLOAD_ERROR, cause: error })\n      throw error\n    }\n  }\n\n  /**\n   * Uploads a single part\n   * @param args - The function arguments\n   * @param args.metadata - The upload metadata\n   * @param args.readStream - The stream to read data from\n   * @param args.partNumber - The part number to upload\n   * @returns Promise that resolves to the ETag of the uploaded part\n   */\n  async uploadPart(args: UploadPartArgs): Promise<AWS.Part> {\n    const { metadata, readStream, partNumber } = args\n    const permit = await this.partUploadSemaphore.acquire()\n\n    if (!metadata['upload-id']) {\n      throwError(MediaCloudErrors.MUX_UPLOAD_ID_MISSING)\n      throw new Error() // This will never execute but satisfies TypeScript\n    }\n\n    const params: AWS.UploadPartCommandInput = {\n      Body: readStream,\n      Bucket: this.bucket,\n      Key: this.metadataManager.generatePartKey({\n        id: metadata.file.id,\n        prefix: metadata.file.metadata?.prefix ?? undefined,\n      }),\n      PartNumber: partNumber,\n      UploadId: metadata['upload-id'],\n    }\n\n    try {\n      const data = await this.client.uploadPart(params)\n      return { ETag: data.ETag, PartNumber: partNumber }\n    } catch (error) {\n      throwError({ ...MediaCloudErrors.TUS_UPLOAD_ERROR, cause: error })\n      throw error\n    } finally {\n      permit()\n    }\n  }\n\n  /**\n   * Uploads a stream to s3 using multiple parts\n   * @param args - The function arguments\n   * @param args.metadata - The upload metadata\n   * @param args.readStream - The stream to read data from\n   * @param args.currentPartNumber - The current part number to start from\n   * @param args.offset - The byte offset to start from\n   * @returns Promise that resolves to the number of bytes uploaded\n   */\n  async uploadParts(args: UploadPartsArgs): Promise<number> {\n    const { metadata, readStream, offset: initialOffset } = args\n    let { currentPartNumber } = args\n    let offset = initialOffset\n    const size = metadata.file.size\n    const promises: Promise<void>[] = []\n    let pendingChunkFilepath: null | string = null\n    let bytesUploaded = 0\n    let permit: SemaphorePermit | undefined = undefined\n\n    const splitterStream = new StreamSplitter({\n      chunkSize: this.fileOperations.calculateOptimalPartSize({ size }),\n      directory: os.tmpdir(),\n    })\n      .on('beforeChunkStarted', async () => {\n        permit = await this.partUploadSemaphore.acquire()\n      })\n      .on('chunkStarted', (filepath) => {\n        pendingChunkFilepath = filepath\n      })\n      .on('chunkFinished', ({ path, size: partSize }) => {\n        pendingChunkFilepath = null\n\n        const acquiredPermit = permit\n        const partNumber = currentPartNumber++\n\n        offset += partSize\n\n        const isFinalPart = size === offset\n\n        const uploadChunk = async () => {\n          try {\n            // Only the first chunk of each PATCH request can prepend\n            // an incomplete part (last chunk) from the previous request.\n            const readable = fs.createReadStream(path)\n            readable.on('error', function (error) {\n              throw error\n            })\n\n            switch (true) {\n              case partSize >= this.minPartSize || isFinalPart:\n                await this.uploadPart({\n                  metadata,\n                  readStream: readable,\n                  partNumber,\n                })\n                break\n              default:\n                await this.uploadIncompletePart({\n                  id: metadata.file.id,\n                  readStream: readable,\n                })\n                break\n            }\n\n            bytesUploaded += partSize\n          } catch (error) {\n            // Destroy the splitter to stop processing more chunks\n            const mappedError =\n              error instanceof Error ? error : new Error(String(error))\n            splitterStream.destroy(mappedError)\n            throw mappedError\n          } finally {\n            fs.promises.rm(path).catch(function () {})\n            acquiredPermit?.()\n          }\n        }\n\n        const deferred = uploadChunk()\n\n        promises.push(deferred)\n      })\n      .on('chunkError', () => {\n        permit?.()\n      })\n\n    try {\n      await stream.promises.pipeline(readStream, splitterStream)\n    } catch (error) {\n      if (pendingChunkFilepath !== null) {\n        try {\n          await fs.promises.rm(pendingChunkFilepath)\n        } catch {\n          log(MediaCloudLogs.S3_STORE_CHUNK_REMOVAL_FAILED)\n        }\n      }\n      const mappedError =\n        error instanceof Error ? error : new Error(String(error))\n      promises.push(Promise.reject(mappedError))\n    } finally {\n      // Wait for all promises\n      await Promise.allSettled(promises)\n      // Reject the promise if any of the promises reject\n      await Promise.all(promises)\n    }\n\n    return bytesUploaded\n  }\n}\n"],"mappings":"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"}

package/dist/tus/stores/s3/{s3-store.d.mts → s3Store.d.mts}

@@ -1,14 +1,14 @@
 import { Semaphore } from "./semaphore.mjs";
-import { S3ExpirationManager } from "./expiration-manager.mjs";
-import { S3FileOperations } from "./file-operations.mjs";
 import { S3StoreConfig } from "../../../types/index.mjs";
-import { S3MetadataManager } from "./metadata-manager.mjs";
-import { S3PartsManager } from "./parts-manager.mjs";
+import { S3MetadataManager } from "./metadataManager.mjs";
+import { S3ExpirationManager } from "./expirationManager.mjs";
+import { S3FileOperations } from "./fileOperations.mjs";
+import { S3PartsManager } from "./partsManager.mjs";
 import stream, { Readable } from "node:stream";
 import { S3 } from "@aws-sdk/client-s3";
 import { DataStore, Upload } from "@tus/utils";
 
-//#region src/tus/stores/s3/s3-store.d.ts
+//#region src/tus/stores/s3/s3Store.d.ts
 declare class S3Store extends DataStore {
   client: S3;
   bucket: string;
@@ -26,19 +26,6 @@ declare class S3Store extends DataStore {
   protected expirationManager: S3ExpirationManager;
   protected customEndpoint: string;
   constructor(options: S3StoreConfig);
-  /**
-   * Generate the key name for the info file
-   * @param id - The upload ID
-   * @returns The info file key
-   */
-  protected generateInfoKey(id: string): string;
-  /**
-   * Generate the key name for a part file
-   * @param id - The upload ID
-   * @param isIncompletePart - Whether this is an incomplete part (default: false)
-   * @returns The part file key
-   */
-  protected generatePartKey(id: string, isIncompletePart?: boolean): string;
   /**
    * Helper method to check if expiration tags should be used
    * @returns True if expiration tags should be used
@@ -47,7 +34,7 @@ declare class S3Store extends DataStore {
   /**
    * Generates a tag for marking complete/incomplete uploads
    * @param value - Either 'false' or 'true' to mark completion status
-   * @returns The tag string or undefined if tags shouldn't be used
+   * @returns The tag string or undefined if tags shouldn’t be used
    */
   protected generateCompleteTag(value: 'false' | 'true'): string | undefined;
   /**
@@ -55,55 +42,74 @@ declare class S3Store extends DataStore {
    * Also, a `${file_id}.info` file is created which holds some information
    * about the upload itself like: `upload-id`, `upload-length`, etc.
    * @param upload - The upload object to create
-   * @returns Promise that resolves to the created upload
+   * @return Promise that resolves to the created upload object with storage information
    */
   create(upload: Upload): Promise<Upload>;
   /**
-   * Declares the length of the upload
-   * @param file_id - The file ID
-   * @param upload_length - The length of the upload
-   * @returns Promise that resolves when length is declared
-   */
-  declareUploadLength(file_id: string, upload_length: number): Promise<void>;
-  /**
-   * Writes `buffer` to the file specified by the upload's `id` at `offset`
+   * Writes `buffer` to the file specified by the upload’s `id` at `offset`
    * @param readable - The readable stream to write
    * @param id - The upload ID
    * @param offset - The byte offset to write at
-   * @returns Promise that resolves to the number of bytes written
+   * @return Promise that resolves to the new offset after writing the data
    */
   write(readable: stream.Readable, id: string, offset: number): Promise<number>;
   /**
    * Returns the current state of the upload, i.e how much data has been
    * uploaded and if the upload is complete.
+   * @param id - The upload ID to retrieve
+   * @returns Promise that resolves to the upload object with current offset and storage information
    */
   getUpload(id: string): Promise<Upload>;
   /**
-   * Reads the file specified by the upload's `id` and returns a readable stream
+   * Reads the file specified by the upload’s `id` and returns a readable stream
+   * @param id - The upload ID to read
+   * @returns Promise that resolves to a readable stream of the file's contents
    */
   read(id: string): Promise<Readable>;
   /**
-   * Removes the file specified by the upload's `id`
+   *
+   * Moves the file specified by its `oldKey` to `newKey`.
+   * @param oldKey - The current S3 key of the file to be moved
+   * @param newKey - The new S3 key to move the file to
+   * @return Promise that resolves when the file has been successfully moved, or rejects with an error if the move operation fails
+   */
+  copy(oldKey: string, newKey: string): Promise<void>;
+  /**
+   * Removes files specified by the upload’s `id`
+   * @param id - The upload ID to remove
+   * @returns Promise that resolves when the file and its metadata have been removed
    */
   remove(id: string): Promise<void>;
+  /**
+   * Removes the .info file specified by the upload’s `id`
+   * @param id - The upload ID to clean up
+   * @returns Promise that resolves when the metadata file has been removed
+   */
+  cleanup(id: string): Promise<void>;
   /**
    * Combine all multipart uploads into a single object
+   * @param id - The upload ID to complete
+   * @returns Promise that resolves to the completed upload object with storage information
    */
   completeMultipartUpload(id: string): Promise<Upload>;
   /**
    * Get the full S3 URL for an uploaded file
+   * @param id - The upload ID to get the URL for
+   * @returns The full URL to access the uploaded file on S3
    */
   getUrl(id: string): string;
   /**
    * Deletes expired incomplete uploads.
    * Returns the number of deleted uploads.
+   * @returns Promise that resolves to the number of deleted uploads
    */
   deleteExpired(): Promise<number>;
   /**
    * Returns the expiration period in milliseconds
+   * @return The expiration period in milliseconds
    */
   getExpiration(): number;
 }
 //#endregion
 export { S3Store };
-//# sourceMappingURL=s3-store.d.mts.map
+//# sourceMappingURL=s3Store.d.mts.map