@maas/payload-plugin-media-cloud 0.0.5 → 0.0.6

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","names":["muxClient: Mux | null","muxConfig: MediaCloudPluginOptions['mux']","s3Config: MediaCloudPluginOptions['s3']","args: CreateTusServerArgs","TusServer","tusServer: TusServer","req: PayloadRequest","args: CreateMuxEndpointsArgs","pluginOptions: MediaCloudPluginOptions","config: Config","mappedConfig: Config"],"sources":["../src/plugin.ts"],"sourcesContent":["import Mux from '@mux/mux-node'\n\nimport { cloudStoragePlugin } from '@payloadcms/plugin-cloud-storage'\nimport { initClientUploads } from '@payloadcms/plugin-cloud-storage/utilities'\nimport { getPayload, sanitizeConfig } from 'payload'\nimport { Server as TusServer, type DataStore } from '@tus/server'\n\nimport { MediaCloudError } from './types/errors'\nimport { useErrorHandler } from './hooks/useErrorHandler'\nimport { getStorageAdapter } from './adapter/storageAdapter'\nimport { getMediaCollection } from './collections/mediaCollection'\nimport { getMuxAssetHandler } from './endpoints/muxAssetHandler'\nimport { getMuxCreateUploadHandler } from './endpoints/muxCreateUploadHandler'\nimport { getMuxWebhookHandler } from './endpoints/muxWebhookHandler'\nimport { S3Store } from './tus/stores/s3/s3-store'\nimport { generateUniqueFilename } from './utils/file'\n\nimport type { Config, PayloadRequest } from 'payload'\nimport type { MediaCloudPluginOptions } from './types'\n\ninterface CreateTusServerArgs {\n  config: Config\n  s3Store: DataStore\n  pluginOptions: MediaCloudPluginOptions\n}\n\ninterface CreateMuxEndpointsArgs {\n  getMuxClient: () => Mux\n  pluginOptions: MediaCloudPluginOptions\n}\n\nconst { logError, throwError } = useErrorHandler()\n\nlet muxClient: Mux | null = null\n\n/**\n * Validates Mux configuration options\n * @param muxConfig - The Mux configuration to validate\n * @throws {Error} When required Mux configuration is missing\n */\nfunction validateMuxConfig(muxConfig: MediaCloudPluginOptions['mux']): void {\n  if (!muxConfig?.tokenId || !muxConfig?.tokenSecret) {\n    throwError(MediaCloudError.MUX_CONFIG_MISSING)\n  }\n}\n\n/**\n * Creates a new Mux client instance\n * @param muxConfig - The Mux configuration options\n * @returns A configured Mux client\n */\nfunction createMuxClient(muxConfig: MediaCloudPluginOptions['mux']): Mux {\n  // Create and return Mux client instance\n  return new Mux({\n    tokenId: muxConfig.tokenId,\n    tokenSecret: muxConfig.tokenSecret,\n    webhookSecret: muxConfig.webhookSecret,\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 */\nfunction createS3Store(s3Config: MediaCloudPluginOptions['s3']): S3Store {\n  // Validate S3 configuration\n  if (\n    !s3Config?.bucket ||\n    !s3Config?.region ||\n    !s3Config?.accessKeyId ||\n    !s3Config?.secretAccessKey\n  ) {\n    throwError(MediaCloudError.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\n/**\n * Creates a TUS server instance with S3 storage\n * @param args - The arguments for creating the TUS server\n * @returns A configured TusServer instance\n */\nfunction createTusServer(args: CreateTusServerArgs): TusServer {\n  const { config, s3Store, pluginOptions } = args\n\n  return new TusServer({\n    datastore: s3Store,\n    namingFunction: async (req, metadata) => {\n      try {\n        // Get Payload instance\n        const payload = await getPayload({\n          config: sanitizeConfig(config),\n        })\n\n        // Check if a file with the same name already exists in the media collection\n        const { docs } = await payload.find({\n          collection: 'media',\n          where: {\n            filename: {\n              equals: metadata?.filename || '',\n            },\n          },\n        })\n\n        // If a file with the same name exists, generate a unique filename\n        if (docs.length > 0) {\n          return generateUniqueFilename(metadata?.filename ?? '')\n        } else {\n          // If no file with the same name exists, return the original filename\n          return metadata?.filename || generateUniqueFilename('')\n        }\n      } catch (_error) {\n        // If an error occurs, log it and return the original filename\n        logError(MediaCloudError.NAMING_FUNCTION_ERROR)\n        return metadata?.filename || generateUniqueFilename('')\n      }\n    },\n    path: '/api/uploads',\n    respectForwardedHeaders: pluginOptions.s3.respectForwardedHeaders ?? false,\n  })\n}\n\n/**\n * Creates TUS upload endpoints for file handling\n * @param tusServer - The TUS server instance\n * @returns An array of endpoint configurations\n */\nfunction createTusEndpoints(tusServer: TusServer) {\n  /**\n   * Handles TUS requests through the server\n   * @param req - The payload request object\n   * @returns The server response\n   */\n  function tusHandler(req: PayloadRequest) {\n    return tusServer.handleWeb(req as Request)\n  }\n\n  return [\n    { handler: tusHandler, method: 'options' as const, path: '/uploads' },\n    { handler: tusHandler, method: 'post' as const, path: '/uploads' },\n    { handler: tusHandler, method: 'get' as const, path: '/uploads/:id' },\n    { handler: tusHandler, method: 'put' as const, path: '/uploads/:id' },\n    { handler: tusHandler, method: 'patch' as const, path: '/uploads/:id' },\n    { handler: tusHandler, method: 'delete' as const, path: '/uploads/:id' },\n  ]\n}\n\n/**\n * Creates Mux-related endpoints for asset handling\n * @param args - The arguments for creating Mux endpoints\n * @returns An array of Mux endpoint configurations\n */\nfunction createMuxEndpoints(args: CreateMuxEndpointsArgs) {\n  const { getMuxClient, pluginOptions } = args\n  return [\n    {\n      handler: getMuxWebhookHandler({ getMuxClient }),\n      method: 'get' as const,\n      path: '/mux/webhook',\n    },\n    {\n      handler: getMuxCreateUploadHandler({ getMuxClient, pluginOptions }),\n      method: 'post' as const,\n      path: '/mux/upload',\n    },\n    {\n      handler: getMuxAssetHandler({ getMuxClient }),\n      method: 'get' as const,\n      path: '/mux/asset',\n    },\n  ]\n}\n\n/**\n * Media Cloud Plugin for Payload CMS\n * Provides file upload capabilities using S3 storage and Mux video processing\n * @param pluginOptions - Configuration options for the plugin\n * @returns A function that configures the Payload config\n */\nexport function mediaCloudPlugin(pluginOptions: MediaCloudPluginOptions) {\n  return function (config: Config): Config {\n    if (!pluginOptions) {\n      logError(MediaCloudError.PLUGIN_NOT_CONFIGURED)\n      return config\n    }\n\n    const isPluginDisabled = pluginOptions.enabled === false\n\n    /**\n     * Gets or creates a Mux client instance\n     * @returns The Mux client instance\n     */\n    function getMuxClient(): Mux {\n      // Return existing Mux client if already created\n      if (muxClient) {\n        return muxClient\n      }\n      // Create and return a new Mux client\n      return createMuxClient(pluginOptions.mux)\n    }\n\n    // Validate Mux configuration\n    if (pluginOptions.mux) {\n      validateMuxConfig(pluginOptions.mux)\n      muxClient = getMuxClient()\n    } else {\n      logError(MediaCloudError.MUX_CONFIG_INCOMPLETE)\n      muxClient = null\n    }\n\n    const s3Store = createS3Store(pluginOptions.s3)\n    const tusServer = createTusServer({ config, s3Store, pluginOptions })\n    const mediaCollection = getMediaCollection({ s3Store })\n\n    if (isPluginDisabled) {\n      return config\n    }\n\n    // Initialize client uploads\n    initClientUploads({\n      clientHandler:\n        '@maas/payload-plugin-media-cloud/components#UploadHandler',\n      collections: {\n        media: {\n          clientUploads: true,\n          disableLocalStorage: true,\n        },\n      },\n      config,\n      enabled: true,\n      serverHandler: () => {\n        return Response.json(\n          { message: 'Server handler is not implemented' },\n          { status: 501 }\n        )\n      },\n      serverHandlerPath: '/media-cloud/upload',\n    })\n\n    const cloudStorageConfig = {\n      collections: {\n        media: {\n          adapter: getStorageAdapter({ getMuxClient, pluginOptions, s3Store }),\n          clientUploads: true,\n          disableLocalStorage: true,\n        },\n      },\n    }\n\n    const mappedConfig: Config = {\n      ...config,\n      admin: {\n        ...(config.admin ?? {}),\n        components: {\n          ...(config.admin?.components ?? {}),\n          providers: [\n            '@maas/payload-plugin-media-cloud/components#UploadManagerProvider',\n            ...(config.admin?.components?.providers ?? []),\n          ],\n        },\n      },\n      collections: [...(config.collections ?? []), mediaCollection],\n      endpoints: [\n        ...(config.endpoints ?? []),\n        ...createTusEndpoints(tusServer),\n        ...createMuxEndpoints({ getMuxClient, pluginOptions }),\n      ],\n    }\n\n    return cloudStoragePlugin(cloudStorageConfig)(mappedConfig)\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"plugin.js","names":["muxClient: Mux | null","muxConfig: MediaCloudPluginOptions['mux']","s3Config: MediaCloudPluginOptions['s3']","args: CreateTusServerArgs","TusServer","tusServer: TusServer","req: PayloadRequest","args: CreateMuxEndpointsArgs","pluginOptions: MediaCloudPluginOptions","config: Config","mappedConfig: Config"],"sources":["../src/plugin.ts"],"sourcesContent":["import Mux from '@mux/mux-node'\n\nimport { cloudStoragePlugin } from '@payloadcms/plugin-cloud-storage'\nimport { initClientUploads } from '@payloadcms/plugin-cloud-storage/utilities'\nimport { getPayload, sanitizeConfig } from 'payload'\nimport { Server as TusServer, type DataStore } from '@tus/server'\n\nimport { MediaCloudErrors } from './types/errors'\nimport { useErrorHandler } from './hooks/useErrorHandler'\nimport { getStorageAdapter } from './adapter/storageAdapter'\nimport { getMediaCollection } from './collections/mediaCollection'\nimport { getMuxAssetHandler } from './endpoints/muxAssetHandler'\nimport { getMuxCreateUploadHandler } from './endpoints/muxCreateUploadHandler'\nimport { getMuxWebhookHandler } from './endpoints/muxWebhookHandler'\nimport { S3Store } from './tus/stores/s3/s3-store'\nimport { generateUniqueFilename } from './utils/file'\n\nimport type { Config, PayloadRequest } from 'payload'\nimport type { MediaCloudPluginOptions } from './types'\n\ninterface CreateTusServerArgs {\n  config: Config\n  s3Store: DataStore\n  pluginOptions: MediaCloudPluginOptions\n}\n\ninterface CreateMuxEndpointsArgs {\n  getMuxClient: () => Mux\n  pluginOptions: MediaCloudPluginOptions\n}\n\nconst { logError, throwError } = useErrorHandler()\n\nlet muxClient: Mux | null = null\n\n/**\n * Validates Mux configuration options\n * @param muxConfig - The Mux configuration to validate\n * @throws {Error} When required Mux configuration is missing\n */\nfunction validateMuxConfig(muxConfig: MediaCloudPluginOptions['mux']): void {\n  if (!muxConfig?.tokenId || !muxConfig?.tokenSecret) {\n    throwError(MediaCloudErrors.MUX_CONFIG_MISSING)\n  }\n}\n\n/**\n * Creates a new Mux client instance\n * @param muxConfig - The Mux configuration options\n * @returns A configured Mux client\n */\nfunction createMuxClient(muxConfig: MediaCloudPluginOptions['mux']): Mux {\n  // Create and return Mux client instance\n  return new Mux({\n    tokenId: muxConfig.tokenId,\n    tokenSecret: muxConfig.tokenSecret,\n    webhookSecret: muxConfig.webhookSecret,\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 */\nfunction createS3Store(s3Config: MediaCloudPluginOptions['s3']): 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\n/**\n * Creates a TUS server instance with S3 storage\n * @param args - The arguments for creating the TUS server\n * @returns A configured TusServer instance\n */\nfunction createTusServer(args: CreateTusServerArgs): TusServer {\n  const { config, s3Store, pluginOptions } = args\n\n  return new TusServer({\n    datastore: s3Store,\n    namingFunction: async (req, metadata) => {\n      try {\n        // Get Payload instance\n        const payload = await getPayload({\n          config: sanitizeConfig(config),\n        })\n\n        // Check if a file with the same name already exists in the media collection\n        const { docs } = await payload.find({\n          collection: 'media',\n          where: {\n            filename: {\n              equals: metadata?.filename || '',\n            },\n          },\n        })\n\n        // If a file with the same name exists, generate a unique filename\n        if (docs.length > 0) {\n          return generateUniqueFilename(metadata?.filename ?? '')\n        } else {\n          // If no file with the same name exists, return the original filename\n          return metadata?.filename || generateUniqueFilename('')\n        }\n      } catch (_error) {\n        // If an error occurs, log it and return the original filename\n        logError(MediaCloudErrors.NAMING_FUNCTION_ERROR)\n        return metadata?.filename || generateUniqueFilename('')\n      }\n    },\n    path: '/api/uploads',\n    respectForwardedHeaders: pluginOptions.s3.respectForwardedHeaders ?? true,\n  })\n}\n\n/**\n * Creates TUS upload endpoints for file handling\n * @param tusServer - The TUS server instance\n * @returns An array of endpoint configurations\n */\nfunction createTusEndpoints(tusServer: TusServer) {\n  /**\n   * Handles TUS requests through the server\n   * @param req - The payload request object\n   * @returns The server response\n   */\n  function tusHandler(req: PayloadRequest) {\n    return tusServer.handleWeb(req as Request)\n  }\n\n  return [\n    { handler: tusHandler, method: 'options' as const, path: '/uploads' },\n    { handler: tusHandler, method: 'post' as const, path: '/uploads' },\n    { handler: tusHandler, method: 'get' as const, path: '/uploads/:id' },\n    { handler: tusHandler, method: 'put' as const, path: '/uploads/:id' },\n    { handler: tusHandler, method: 'patch' as const, path: '/uploads/:id' },\n    { handler: tusHandler, method: 'delete' as const, path: '/uploads/:id' },\n  ]\n}\n\n/**\n * Creates Mux-related endpoints for asset handling\n * @param args - The arguments for creating Mux endpoints\n * @returns An array of Mux endpoint configurations\n */\nfunction createMuxEndpoints(args: CreateMuxEndpointsArgs) {\n  const { getMuxClient, pluginOptions } = args\n  return [\n    {\n      handler: getMuxWebhookHandler({ getMuxClient }),\n      method: 'get' as const,\n      path: '/mux/webhook',\n    },\n    {\n      handler: getMuxCreateUploadHandler({ getMuxClient, pluginOptions }),\n      method: 'post' as const,\n      path: '/mux/upload',\n    },\n    {\n      handler: getMuxAssetHandler({ getMuxClient }),\n      method: 'get' as const,\n      path: '/mux/asset',\n    },\n  ]\n}\n\n/**\n * Media Cloud Plugin for Payload CMS\n * Provides file upload capabilities using S3 storage and Mux video processing\n * @param pluginOptions - Configuration options for the plugin\n * @returns A function that configures the Payload config\n */\nexport function mediaCloudPlugin(pluginOptions: MediaCloudPluginOptions) {\n  return function (config: Config): Config {\n    if (!pluginOptions) {\n      logError(MediaCloudErrors.PLUGIN_NOT_CONFIGURED)\n      return config\n    }\n\n    const isPluginDisabled = pluginOptions.enabled === false\n\n    /**\n     * Gets or creates a Mux client instance\n     * @returns The Mux client instance\n     */\n    function getMuxClient(): Mux {\n      // Return existing Mux client if already created\n      if (muxClient) {\n        return muxClient\n      }\n      // Create and return a new Mux client\n      return createMuxClient(pluginOptions.mux)\n    }\n\n    // Validate Mux configuration\n    if (pluginOptions.mux) {\n      validateMuxConfig(pluginOptions.mux)\n      muxClient = getMuxClient()\n    } else {\n      logError(MediaCloudErrors.MUX_CONFIG_INCOMPLETE)\n      muxClient = null\n    }\n\n    const s3Store = createS3Store(pluginOptions.s3)\n    const tusServer = createTusServer({ config, s3Store, pluginOptions })\n    const mediaCollection = getMediaCollection({ s3Store })\n\n    if (isPluginDisabled) {\n      return config\n    }\n\n    // Initialize client uploads\n    initClientUploads({\n      clientHandler:\n        '@maas/payload-plugin-media-cloud/components#UploadHandler',\n      collections: {\n        media: {\n          clientUploads: true,\n          disableLocalStorage: true,\n        },\n      },\n      config,\n      enabled: true,\n      serverHandler: () => {\n        return Response.json(\n          { message: 'Server handler is not implemented' },\n          { status: 501 }\n        )\n      },\n      serverHandlerPath: '/media-cloud/upload',\n    })\n\n    const cloudStorageConfig = {\n      collections: {\n        media: {\n          adapter: getStorageAdapter({ getMuxClient, pluginOptions, s3Store }),\n          clientUploads: true,\n          disableLocalStorage: true,\n        },\n      },\n    }\n\n    const mappedConfig: Config = {\n      ...config,\n      admin: {\n        ...(config.admin ?? {}),\n        components: {\n          ...(config.admin?.components ?? {}),\n          providers: [\n            '@maas/payload-plugin-media-cloud/components#UploadManagerProvider',\n            ...(config.admin?.components?.providers ?? []),\n          ],\n        },\n      },\n      collections: [...(config.collections ?? []), mediaCollection],\n      endpoints: [\n        ...(config.endpoints ?? []),\n        ...createTusEndpoints(tusServer),\n        ...createMuxEndpoints({ getMuxClient, pluginOptions }),\n      ],\n    }\n\n    return cloudStoragePlugin(cloudStorageConfig)(mappedConfig)\n  }\n}\n"],"mappings":"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"}

package/dist/tus/stores/s3/file-operations.js

@@ -1,4 +1,4 @@
-import { MediaCloudError } from "../../../types/errors.js";
+import { MediaCloudErrors } from "../../../types/errors.js";
 import { useErrorHandler } from "../../../hooks/useErrorHandler.js";
 import crypto from "node:crypto";
 import fs from "node:fs";
@@ -70,7 +70,7 @@ var S3FileOperations = class {
 				if (nodeError.code === "ENOENT") return filePath;
 			}
 		}
-		throwError(MediaCloudError.S3_UNIQUE_NAME_ERROR);
+		throwError(MediaCloudErrors.S3_UNIQUE_NAME_ERROR);
 		throw new Error();
 	}
 };

package/dist/tus/stores/s3/file-operations.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-operations.js","names":["maxMultipartParts: number","maxUploadSize: number","minPartSize: number","preferredPartSize: number","args: CalculateOptimalPartSizeArgs","optimalPartSize: number","args: CalculateOffsetFromPartsArgs","args: CalculatePartNumberArgs","args: GenerateUniqueTmpFileNameArgs","args: CalculateOffsetFromPartsExportArgs"],"sources":["../../../../src/tus/stores/s3/file-operations.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 { MediaCloudError } 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 we assume largest possible value (`maxUploadSize`)\n    let uploadSize = size\n    if (uploadSize === undefined) {\n      uploadSize = this.maxUploadSize\n    }\n\n    let optimalPartSize: number\n\n    // When upload is smaller or equal to PreferredPartSize, we 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(MediaCloudError.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,EAAE,YAAY,GAAG,iBAAiB;AAExC,IAAa,mBAAb,MAA8B;CAC5B,YACUA,mBACAC,eACAC,aACAC,mBACR;EAJQ;EACA;EACA;EACA;CACN;;;;;;;CAQJ,yBAAyBC,MAA4C;EACnE,MAAM,EAAE,MAAM,GAAG;EAEjB,IAAI,aAAa;AACjB,MAAI,eAAe,QACjB,aAAa,KAAK;EAGpB,IAAIC;AAGJ,MAAI,cAAc,KAAK,mBACrB,kBAAkB;WAGX,cAAc,KAAK,oBAAoB,KAAK,mBACnD,kBAAkB,KAAK;OAIvB,kBAAkB,KAAK,KAAK,aAAa,KAAK,kBAAkB;AAIlE,SAAO,KAAK,IAAI,iBAAiB,KAAK,YAAY;CACnD;;;;;;;CAQD,yBAAyBC,MAA4C;EACnE,MAAM,EAAE,OAAO,GAAG;AAClB,SAAO,SAAS,MAAM,SAAS,IAC3B,MAAM,OAAO,CAAC,GAAG,MAAM,KAAK,EAAE,QAAQ,IAAI,EAAE,GAC5C;CACL;;;;;;;CAQD,oBAAoBC,MAAuC;EACzD,MAAM,EAAE,OAAO,GAAG;AAClB,SAAO,MAAM,SAAS,IAAI,MAAM,MAAM,SAAS,GAAG,aAAc,IAAI;CACrE;;;;;;;;CASD,MAAM,0BACJC,MACiB;EACjB,MAAM,EAAE,UAAU,GAAG;EACrB,MAAM,QAAQ;AACd,OAAK,IAAI,IAAI,GAAG,IAAI,OAAO,KAAK;GAC9B,MAAM,WAAW,OAAO,YAAY,GAAG,CAAC,SAAS,MAAM;GACvD,MAAM,WAAW,KAAK,KAAK,GAAG,QAAQ,EAAE,GAAG,WAAW,UAAU,CAAC;AACjE,OAAI;IACF,MAAM,GAAG,SAAS,OAAO,UAAU,GAAG,UAAU,KAAK;GACtD,SAAQ,OAAO;IACd,MAAM,YAAY;AAClB,QAAI,UAAU,SAAS,SACrB,QAAO;GAEV;EACF;EACD,WAAW,gBAAgB,qBAAqB;AAChD,QAAM,IAAI;CACX;AACF;;;;;;;AAQD,SAAgB,yBACdC,MACA;CACA,MAAM,EAAE,OAAO,GAAG;AAClB,QAAO,SAAS,MAAM,SAAS,IAC3B,MAAM,OAAO,CAAC,GAAG,MAAM,KAAK,EAAE,QAAQ,IAAI,EAAE,GAC5C;AACL"}
+{"version":3,"file":"file-operations.js","names":["maxMultipartParts: number","maxUploadSize: number","minPartSize: number","preferredPartSize: number","args: CalculateOptimalPartSizeArgs","optimalPartSize: number","args: CalculateOffsetFromPartsArgs","args: CalculatePartNumberArgs","args: GenerateUniqueTmpFileNameArgs","args: CalculateOffsetFromPartsExportArgs"],"sources":["../../../../src/tus/stores/s3/file-operations.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, MediaCloudLogs } 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 we assume largest possible value (`maxUploadSize`)\n    let uploadSize = size\n    if (uploadSize === undefined) {\n      uploadSize = this.maxUploadSize\n    }\n\n    let optimalPartSize: number\n\n    // When upload is smaller or equal to PreferredPartSize, we 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,EAAE,YAAY,GAAG,iBAAiB;AAExC,IAAa,mBAAb,MAA8B;CAC5B,YACUA,mBACAC,eACAC,aACAC,mBACR;EAJQ;EACA;EACA;EACA;CACN;;;;;;;CAQJ,yBAAyBC,MAA4C;EACnE,MAAM,EAAE,MAAM,GAAG;EAEjB,IAAI,aAAa;AACjB,MAAI,eAAe,QACjB,aAAa,KAAK;EAGpB,IAAIC;AAGJ,MAAI,cAAc,KAAK,mBACrB,kBAAkB;WAGX,cAAc,KAAK,oBAAoB,KAAK,mBACnD,kBAAkB,KAAK;OAIvB,kBAAkB,KAAK,KAAK,aAAa,KAAK,kBAAkB;AAIlE,SAAO,KAAK,IAAI,iBAAiB,KAAK,YAAY;CACnD;;;;;;;CAQD,yBAAyBC,MAA4C;EACnE,MAAM,EAAE,OAAO,GAAG;AAClB,SAAO,SAAS,MAAM,SAAS,IAC3B,MAAM,OAAO,CAAC,GAAG,MAAM,KAAK,EAAE,QAAQ,IAAI,EAAE,GAC5C;CACL;;;;;;;CAQD,oBAAoBC,MAAuC;EACzD,MAAM,EAAE,OAAO,GAAG;AAClB,SAAO,MAAM,SAAS,IAAI,MAAM,MAAM,SAAS,GAAG,aAAc,IAAI;CACrE;;;;;;;;CASD,MAAM,0BACJC,MACiB;EACjB,MAAM,EAAE,UAAU,GAAG;EACrB,MAAM,QAAQ;AACd,OAAK,IAAI,IAAI,GAAG,IAAI,OAAO,KAAK;GAC9B,MAAM,WAAW,OAAO,YAAY,GAAG,CAAC,SAAS,MAAM;GACvD,MAAM,WAAW,KAAK,KAAK,GAAG,QAAQ,EAAE,GAAG,WAAW,UAAU,CAAC;AACjE,OAAI;IACF,MAAM,GAAG,SAAS,OAAO,UAAU,GAAG,UAAU,KAAK;GACtD,SAAQ,OAAO;IACd,MAAM,YAAY;AAClB,QAAI,UAAU,SAAS,SACrB,QAAO;GAEV;EACF;EACD,WAAW,iBAAiB,qBAAqB;AACjD,QAAM,IAAI;CACX;AACF;;;;;;;AAQD,SAAgB,yBACdC,MACA;CACA,MAAM,EAAE,OAAO,GAAG;AAClB,QAAO,SAAS,MAAM,SAAS,IAC3B,MAAM,OAAO,CAAC,GAAG,MAAM,KAAK,EAAE,QAAQ,IAAI,EAAE,GAC5C;AACL"}

package/dist/tus/stores/s3/metadata-manager.js

@@ -1,9 +1,9 @@
-import { MediaCloudError } from "../../../types/errors.js";
+import { MediaCloudLogs } from "../../../types/errors.js";
 import { useErrorHandler } from "../../../hooks/useErrorHandler.js";
 import { TUS_RESUMABLE, Upload } from "@tus/utils";
 
 //#region src/tus/stores/s3/metadata-manager.ts
-const { logConsole } = useErrorHandler();
+const { log } = useErrorHandler();
 var S3MetadataManager = class {
 	constructor(client, bucket, cache, shouldUseExpirationTags, generateCompleteTag) {
 		this.client = client;
@@ -79,7 +79,7 @@ var S3MetadataManager = class {
 	*/
 	async saveMetadata(args) {
 		const { upload, uploadId } = args;
-		logConsole(MediaCloudError.S3_STORE_METADATA_SAVING);
+		log(MediaCloudLogs.S3_STORE_METADATA_SAVING);
 		await this.client.putObject({
 			Body: JSON.stringify(upload),
 			Bucket: this.bucket,
@@ -90,7 +90,7 @@ var S3MetadataManager = class {
 			},
 			Tagging: this.generateCompleteTag("false")
 		});
-		logConsole(MediaCloudError.S3_STORE_METADATA_SAVED);
+		log(MediaCloudLogs.S3_STORE_METADATA_SAVED);
 	}
 	/**
 	* Completes metadata by updating it with completion tags
@@ -127,7 +127,7 @@ var S3MetadataManager = class {
 	*/
 	async clearCache(args) {
 		const { id } = args;
-		logConsole(MediaCloudError.S3_STORE_METADATA_CACHE_CLEARED);
+		log(MediaCloudLogs.S3_STORE_METADATA_CACHE_CLEARED);
 		await this.cache.delete(id);
 	}
 };

package/dist/tus/stores/s3/metadata-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-manager.js","names":["client: S3","bucket: string","cache: KvStore<TusUploadMetadata>","shouldUseExpirationTags: () => boolean","generateCompleteTag: (value: 'false' | 'true') => string | undefined","args: GenerateInfoKeyArgs","args: GeneratePartKeyArgs","args: GetMetadataArgs","metadata: TusUploadMetadata","args: SaveMetadataArgs","args: CompleteMetadataArgs","completedMetadata: TusUploadMetadata","args: ClearCacheArgs"],"sources":["../../../../src/tus/stores/s3/metadata-manager.ts"],"sourcesContent":["import { TUS_RESUMABLE, Upload } from '@tus/utils'\n\nimport { useErrorHandler } from '../../../hooks/useErrorHandler'\nimport { MediaCloudError } from '../../../types/errors'\n\nimport type { S3 } from '@aws-sdk/client-s3'\nimport type { KvStore } from '@tus/utils'\nimport type { TusUploadMetadata } from '../../../types'\n\ntype GenerateInfoKeyArgs = {\n  id: string\n}\n\ntype GeneratePartKeyArgs = {\n  id: 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\ntype ClearCacheArgs = {\n  id: string\n}\n\nconst { logConsole } = useErrorHandler()\n\nexport class S3MetadataManager {\n  constructor(\n    private client: S3,\n    private bucket: string,\n    private cache: KvStore<TusUploadMetadata>,\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    const { id } = args\n    return `${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.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, isIncomplete = false } = args\n    let key = id\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   * There's a small and simple caching mechanism to avoid multiple\n   * HTTP calls to S3.\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    const cached = await this.cache.get(id)\n    if (cached) {\n      return cached\n    }\n\n    const { Body, Metadata } = await this.client.getObject({\n      Bucket: this.bucket,\n      Key: this.generateInfoKey({ id }),\n    })\n    const file = JSON.parse((await Body?.transformToString()) as string)\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(file.size)\n          ? Number.parseInt(file.size, 10)\n          : undefined,\n        storage: file.storage,\n      }),\n      'tus-version': Metadata?.['tus-version'] as string,\n      'upload-id': Metadata?.['upload-id'] as string,\n    }\n    await this.cache.set(id, metadata)\n    return metadata\n  }\n\n  /**\n   * Saves upload metadata to a `${file_id}.info` file on S3.\n   * Please note that the file is empty and the metadata is saved\n   * on the S3 object's `Metadata` field, so that only a `headObject`\n   * is necessary to retrieve the data.\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    logConsole(MediaCloudError.S3_STORE_METADATA_SAVING)\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    logConsole(MediaCloudError.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    // Always update the cache with the completed upload\n    const metadata = await this.getMetadata({ id: upload.id })\n    const completedMetadata: TusUploadMetadata = {\n      ...metadata,\n      file: upload,\n    }\n    await this.cache.set(upload.id, completedMetadata)\n\n    if (!this.shouldUseExpirationTags()) {\n      return\n    }\n\n    const { 'upload-id': uploadId } = metadata\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  /**\n   * Removes cached data for a given file\n   * @param args - The function arguments\n   * @param args.id - The file ID to remove from cache\n   * @returns Promise that resolves when cache is cleared\n   */\n  async clearCache(args: ClearCacheArgs): Promise<void> {\n    const { id } = args\n    logConsole(MediaCloudError.S3_STORE_METADATA_CACHE_CLEARED)\n    await this.cache.delete(id)\n  }\n}\n"],"mappings":";;;;;AAmCA,MAAM,EAAE,YAAY,GAAG,iBAAiB;AAExC,IAAa,oBAAb,MAA+B;CAC7B,YACUA,QACAC,QACAC,OACAC,yBACAC,qBACR;EALQ;EACA;EACA;EACA;EACA;CACN;;;;;;;CAOJ,gBAAgBC,MAAmC;EACjD,MAAM,EAAE,IAAI,GAAG;AACf,SAAO,GAAG,GAAG,KAAK,CAAC;CACpB;;;;;;;;CASD,gBAAgBC,MAAmC;EACjD,MAAM,EAAE,IAAI,eAAe,OAAO,GAAG;EACrC,IAAI,MAAM;AACV,MAAI,cACF,OAAO;AAOT,SAAO;CACR;;;;;;;;;CAUD,MAAM,YAAYC,MAAmD;EACnE,MAAM,EAAE,IAAI,GAAG;EACf,MAAM,SAAS,MAAM,KAAK,MAAM,IAAI,GAAG;AACvC,MAAI,OACF,QAAO;EAGT,MAAM,EAAE,MAAM,UAAU,GAAG,MAAM,KAAK,OAAO,UAAU;GACrD,QAAQ,KAAK;GACb,KAAK,KAAK,gBAAgB,EAAE,GAAI,EAAC;EAClC,EAAC;EACF,MAAM,OAAO,KAAK,MAAO,MAAM,MAAM,mBAAmB,CAAY;EACpE,MAAMC,WAA8B;GAClC,MAAM,IAAI,OAAO;IACf;IACA,eAAe,KAAK;IACpB,UAAU,KAAK;IACf,QAAQ,OAAO,SAAS,KAAK,QAAQ,GAAG;IACxC,MAAM,OAAO,SAAS,KAAK,KAAK,GAC5B,OAAO,SAAS,KAAK,MAAM,GAAG,GAC9B;IACJ,SAAS,KAAK;GACf;GACD,eAAe,WAAW;GAC1B,aAAa,WAAW;EACzB;EACD,MAAM,KAAK,MAAM,IAAI,IAAI,SAAS;AAClC,SAAO;CACR;;;;;;;;;;;CAYD,MAAM,aAAaC,MAAuC;EACxD,MAAM,EAAE,QAAQ,UAAU,GAAG;EAC7B,WAAW,gBAAgB,yBAAyB;EACpD,MAAM,KAAK,OAAO,UAAU;GAC1B,MAAM,KAAK,UAAU,OAAO;GAC5B,QAAQ,KAAK;GACb,KAAK,KAAK,gBAAgB,EAAE,IAAI,OAAO,GAAI,EAAC;GAC5C,UAAU;IACR,eAAe;IACf,aAAa;GACd;GACD,SAAS,KAAK,oBAAoB,QAAQ;EAC3C,EAAC;EACF,WAAW,gBAAgB,wBAAwB;CACpD;;;;;;;CAQD,MAAM,iBAAiBC,MAA2C;EAChE,MAAM,EAAE,QAAQ,GAAG;EAEnB,MAAM,WAAW,MAAM,KAAK,YAAY,EAAE,IAAI,OAAO,GAAI,EAAC;EAC1D,MAAMC,oBAAuC;GAC3C,GAAG;GACH,MAAM;EACP;EACD,MAAM,KAAK,MAAM,IAAI,OAAO,IAAI,kBAAkB;AAElD,MAAI,CAAC,KAAK,yBAAyB,CACjC;EAGF,MAAM,EAAE,aAAa,UAAU,GAAG;EAClC,MAAM,KAAK,OAAO,UAAU;GAC1B,MAAM,KAAK,UAAU,OAAO;GAC5B,QAAQ,KAAK;GACb,KAAK,KAAK,gBAAgB,EAAE,IAAI,OAAO,GAAI,EAAC;GAC5C,UAAU;IACR,eAAe;IACf,aAAa;GACd;GACD,SAAS,KAAK,oBAAoB,OAAO;EAC1C,EAAC;CACH;;;;;;;CAQD,MAAM,WAAWC,MAAqC;EACpD,MAAM,EAAE,IAAI,GAAG;EACf,WAAW,gBAAgB,gCAAgC;EAC3D,MAAM,KAAK,MAAM,OAAO,GAAG;CAC5B;AACF"}
+{"version":3,"file":"metadata-manager.js","names":["client: S3","bucket: string","cache: KvStore<TusUploadMetadata>","shouldUseExpirationTags: () => boolean","generateCompleteTag: (value: 'false' | 'true') => string | undefined","args: GenerateInfoKeyArgs","args: GeneratePartKeyArgs","args: GetMetadataArgs","metadata: TusUploadMetadata","args: SaveMetadataArgs","args: CompleteMetadataArgs","completedMetadata: TusUploadMetadata","args: ClearCacheArgs"],"sources":["../../../../src/tus/stores/s3/metadata-manager.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 { KvStore } from '@tus/utils'\nimport type { TusUploadMetadata } from '../../../types'\n\ntype GenerateInfoKeyArgs = {\n  id: string\n}\n\ntype GeneratePartKeyArgs = {\n  id: 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\ntype ClearCacheArgs = {\n  id: string\n}\n\nconst { log } = useErrorHandler()\n\nexport class S3MetadataManager {\n  constructor(\n    private client: S3,\n    private bucket: string,\n    private cache: KvStore<TusUploadMetadata>,\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    const { id } = args\n    return `${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.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, isIncomplete = false } = args\n    let key = id\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   * There's a small and simple caching mechanism to avoid multiple\n   * HTTP calls to S3.\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    const cached = await this.cache.get(id)\n    if (cached) {\n      return cached\n    }\n\n    const { Body, Metadata } = await this.client.getObject({\n      Bucket: this.bucket,\n      Key: this.generateInfoKey({ id }),\n    })\n    const file = JSON.parse((await Body?.transformToString()) as string)\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(file.size)\n          ? Number.parseInt(file.size, 10)\n          : undefined,\n        storage: file.storage,\n      }),\n      'tus-version': Metadata?.['tus-version'] as string,\n      'upload-id': Metadata?.['upload-id'] as string,\n    }\n    await this.cache.set(id, metadata)\n    return metadata\n  }\n\n  /**\n   * Saves upload metadata to a `${file_id}.info` file on S3.\n   * Please note that the file is empty and the metadata is saved\n   * on the S3 object's `Metadata` field, so that only a `headObject`\n   * is necessary to retrieve the data.\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    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    // Always update the cache with the completed upload\n    const metadata = await this.getMetadata({ id: upload.id })\n    const completedMetadata: TusUploadMetadata = {\n      ...metadata,\n      file: upload,\n    }\n    await this.cache.set(upload.id, completedMetadata)\n\n    if (!this.shouldUseExpirationTags()) {\n      return\n    }\n\n    const { 'upload-id': uploadId } = metadata\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  /**\n   * Removes cached data for a given file\n   * @param args - The function arguments\n   * @param args.id - The file ID to remove from cache\n   * @returns Promise that resolves when cache is cleared\n   */\n  async clearCache(args: ClearCacheArgs): Promise<void> {\n    const { id } = args\n    log(MediaCloudLogs.S3_STORE_METADATA_CACHE_CLEARED)\n    await this.cache.delete(id)\n  }\n}\n"],"mappings":";;;;;AAmCA,MAAM,EAAE,KAAK,GAAG,iBAAiB;AAEjC,IAAa,oBAAb,MAA+B;CAC7B,YACUA,QACAC,QACAC,OACAC,yBACAC,qBACR;EALQ;EACA;EACA;EACA;EACA;CACN;;;;;;;CAOJ,gBAAgBC,MAAmC;EACjD,MAAM,EAAE,IAAI,GAAG;AACf,SAAO,GAAG,GAAG,KAAK,CAAC;CACpB;;;;;;;;CASD,gBAAgBC,MAAmC;EACjD,MAAM,EAAE,IAAI,eAAe,OAAO,GAAG;EACrC,IAAI,MAAM;AACV,MAAI,cACF,OAAO;AAOT,SAAO;CACR;;;;;;;;;CAUD,MAAM,YAAYC,MAAmD;EACnE,MAAM,EAAE,IAAI,GAAG;EACf,MAAM,SAAS,MAAM,KAAK,MAAM,IAAI,GAAG;AACvC,MAAI,OACF,QAAO;EAGT,MAAM,EAAE,MAAM,UAAU,GAAG,MAAM,KAAK,OAAO,UAAU;GACrD,QAAQ,KAAK;GACb,KAAK,KAAK,gBAAgB,EAAE,GAAI,EAAC;EAClC,EAAC;EACF,MAAM,OAAO,KAAK,MAAO,MAAM,MAAM,mBAAmB,CAAY;EACpE,MAAMC,WAA8B;GAClC,MAAM,IAAI,OAAO;IACf;IACA,eAAe,KAAK;IACpB,UAAU,KAAK;IACf,QAAQ,OAAO,SAAS,KAAK,QAAQ,GAAG;IACxC,MAAM,OAAO,SAAS,KAAK,KAAK,GAC5B,OAAO,SAAS,KAAK,MAAM,GAAG,GAC9B;IACJ,SAAS,KAAK;GACf;GACD,eAAe,WAAW;GAC1B,aAAa,WAAW;EACzB;EACD,MAAM,KAAK,MAAM,IAAI,IAAI,SAAS;AAClC,SAAO;CACR;;;;;;;;;;;CAYD,MAAM,aAAaC,MAAuC;EACxD,MAAM,EAAE,QAAQ,UAAU,GAAG;EAC7B,IAAI,eAAe,yBAAyB;EAC5C,MAAM,KAAK,OAAO,UAAU;GAC1B,MAAM,KAAK,UAAU,OAAO;GAC5B,QAAQ,KAAK;GACb,KAAK,KAAK,gBAAgB,EAAE,IAAI,OAAO,GAAI,EAAC;GAC5C,UAAU;IACR,eAAe;IACf,aAAa;GACd;GACD,SAAS,KAAK,oBAAoB,QAAQ;EAC3C,EAAC;EACF,IAAI,eAAe,wBAAwB;CAC5C;;;;;;;CAQD,MAAM,iBAAiBC,MAA2C;EAChE,MAAM,EAAE,QAAQ,GAAG;EAEnB,MAAM,WAAW,MAAM,KAAK,YAAY,EAAE,IAAI,OAAO,GAAI,EAAC;EAC1D,MAAMC,oBAAuC;GAC3C,GAAG;GACH,MAAM;EACP;EACD,MAAM,KAAK,MAAM,IAAI,OAAO,IAAI,kBAAkB;AAElD,MAAI,CAAC,KAAK,yBAAyB,CACjC;EAGF,MAAM,EAAE,aAAa,UAAU,GAAG;EAClC,MAAM,KAAK,OAAO,UAAU;GAC1B,MAAM,KAAK,UAAU,OAAO;GAC5B,QAAQ,KAAK;GACb,KAAK,KAAK,gBAAgB,EAAE,IAAI,OAAO,GAAI,EAAC;GAC5C,UAAU;IACR,eAAe;IACf,aAAa;GACd;GACD,SAAS,KAAK,oBAAoB,OAAO;EAC1C,EAAC;CACH;;;;;;;CAQD,MAAM,WAAWC,MAAqC;EACpD,MAAM,EAAE,IAAI,GAAG;EACf,IAAI,eAAe,gCAAgC;EACnD,MAAM,KAAK,MAAM,OAAO,GAAG;CAC5B;AACF"}

package/dist/tus/stores/s3/parts-manager.js

@@ -1,4 +1,4 @@
-import { MediaCloudError } from "../../../types/errors.js";
+import { MediaCloudErrors, MediaCloudLogs } from "../../../types/errors.js";
 import { useErrorHandler } from "../../../hooks/useErrorHandler.js";
 import stream from "node:stream";
 import { NoSuchKey, NotFound } from "@aws-sdk/client-s3";
@@ -7,7 +7,7 @@ import fs from "node:fs";
 import os from "node:os";
 
 //#region src/tus/stores/s3/parts-manager.ts
-const { throwError, logConsole } = useErrorHandler();
+const { throwError, log } = useErrorHandler();
 var S3PartsManager = class {
 	constructor(client, bucket, minPartSize, partUploadSemaphore, metadataManager, fileOperations, generateCompleteTag) {
 		this.client = client;
@@ -30,7 +30,7 @@ var S3PartsManager = class {
 		const { id, partNumberMarker } = args;
 		const metadata = await this.metadataManager.getMetadata({ id });
 		if (!metadata["upload-id"]) {
-			throwError(MediaCloudError.MUX_UPLOAD_ID_MISSING);
+			throwError(MediaCloudErrors.MUX_UPLOAD_ID_MISSING);
 			throw new Error();
 		}
 		const params = {
@@ -76,7 +76,7 @@ var S3PartsManager = class {
 			const result = await this.client.completeMultipartUpload(params);
 			return result.Location;
 		} catch (_error) {
-			throwError(MediaCloudError.TUS_UPLOAD_ERROR);
+			throwError(MediaCloudErrors.TUS_UPLOAD_ERROR);
 			throw new Error();
 		}
 	}
@@ -199,7 +199,7 @@ var S3PartsManager = class {
 			}),
 			Tagging: this.generateCompleteTag("false")
 		});
-		logConsole(MediaCloudError.S3_STORE_INCOMPLETE_PART_UPLOADED);
+		log(MediaCloudLogs.S3_STORE_INCOMPLETE_PART_UPLOADED);
 		return data.ETag;
 	}
 	/**
@@ -214,7 +214,7 @@ var S3PartsManager = class {
 		const { metadata, readStream, partNumber } = args;
 		const permit = await this.partUploadSemaphore.acquire();
 		if (!metadata["upload-id"]) {
-			throwError(MediaCloudError.MUX_UPLOAD_ID_MISSING);
+			throwError(MediaCloudErrors.MUX_UPLOAD_ID_MISSING);
 			throw new Error();
 		}
 		const params = {
@@ -231,7 +231,7 @@ var S3PartsManager = class {
 				PartNumber: partNumber
 			};
 		} catch (_error) {
-			throwError(MediaCloudError.TUS_UPLOAD_ERROR);
+			throwError(MediaCloudErrors.TUS_UPLOAD_ERROR);
 			throw new Error();
 		} finally {
 			permit();
@@ -310,7 +310,7 @@ var S3PartsManager = class {
 			if (pendingChunkFilepath !== null) try {
 				await fs.promises.rm(pendingChunkFilepath);
 			} catch {
-				logConsole(MediaCloudError.S3_STORE_CHUNK_REMOVAL_FAILED);
+				log(MediaCloudLogs.S3_STORE_CHUNK_REMOVAL_FAILED);
 			}
 			const mappedError = error instanceof Error ? error : new Error(String(error));
 			promises.push(Promise.reject(mappedError));

package/dist/tus/stores/s3/parts-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"parts-manager.js","names":["client: S3","bucket: string","minPartSize: number","partUploadSemaphore: Semaphore","metadataManager: S3MetadataManager","fileOperations: S3FileOperations","generateCompleteTag: (value: 'false' | 'true') => string | undefined","args: RetrievePartsArgs","params: AWS.ListPartsCommandInput","args: FinishMultipartUploadArgs","args: GetIncompletePartArgs","args: GetIncompletePartSizeArgs","args: DeleteIncompletePartArgs","args: DownloadIncompletePartArgs","options: { cleanUpOnEnd: boolean }","args: UploadIncompletePartArgs","args: UploadPartArgs","params: AWS.UploadPartCommandInput","args: UploadPartsArgs","promises: Promise<void>[]","pendingChunkFilepath: null | string","permit: SemaphorePermit | undefined"],"sources":["../../../../src/tus/stores/s3/parts-manager.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 { MediaCloudError } from '../../../types/errors'\n\nimport type { Readable } from 'node:stream'\nimport type AWS from '@aws-sdk/client-s3'\nimport type { IncompletePartInfo, TusUploadMetadata } from '../../../types'\nimport type { S3FileOperations } from './file-operations'\nimport type { S3MetadataManager } from './metadata-manager'\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 { throwError, logConsole } = 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(MediaCloudError.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: id,\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    const params = {\n      Bucket: this.bucket,\n      Key: metadata.file.id,\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(MediaCloudError.TUS_UPLOAD_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    try {\n      const data = await this.client.getObject({\n        Bucket: this.bucket,\n        Key: this.metadataManager.generatePartKey({ id, isIncomplete: true }),\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    try {\n      const data = await this.client.headObject({\n        Bucket: this.bucket,\n        Key: this.metadataManager.generatePartKey({ id, isIncomplete: true }),\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    await this.client.deleteObject({\n      Bucket: this.bucket,\n      Key: this.metadataManager.generatePartKey({ id, isIncomplete: true }),\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    const data = await this.client.putObject({\n      Body: readStream,\n      Bucket: this.bucket,\n      Key: this.metadataManager.generatePartKey({ id, isIncomplete: true }),\n      Tagging: this.generateCompleteTag('false'),\n    })\n    logConsole(MediaCloudError.S3_STORE_INCOMPLETE_PART_UPLOADED)\n    return data.ETag as string\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(MediaCloudError.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: metadata.file.id,\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(MediaCloudError.TUS_UPLOAD_ERROR)\n      throw new Error() // This will never execute but satisfies TypeScript\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          logConsole(MediaCloudError.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":";;;;;;;;;AA6DA,MAAM,EAAE,YAAY,YAAY,GAAG,iBAAiB;AAEpD,IAAa,iBAAb,MAA4B;CAC1B,YACUA,QACAC,QACAC,aACAC,qBACAC,iBACAC,gBACAC,qBACR;EAPQ;EACA;EACA;EACA;EACA;EACA;EACA;CACN;;;;;;;;;CAUJ,MAAM,cAAcC,MAAmD;EACrE,MAAM,EAAE,IAAI,kBAAkB,GAAG;EACjC,MAAM,WAAW,MAAM,KAAK,gBAAgB,YAAY,EAAE,GAAI,EAAC;AAE/D,MAAI,CAAC,SAAS,cAAc;GAC1B,WAAW,gBAAgB,sBAAsB;AACjD,SAAM,IAAI;EACX;EAED,MAAMC,SAAoC;GACxC,QAAQ,KAAK;GACb,KAAK;GACL,kBAAkB;GAClB,UAAU,SAAS;EACpB;EAED,MAAM,OAAO,MAAM,KAAK,OAAO,UAAU,OAAO;EAEhD,IAAI,QAAQ,KAAK,SAAS,CAAE;AAE5B,MAAI,KAAK,aAAa;GACpB,MAAM,OAAO,MAAM,KAAK,cAAc;IACpC;IACA,kBAAkB,KAAK;GACxB,EAAC;GACF,QAAQ,CAAC,GAAG,OAAO,GAAG,IAAK;EAC5B;AAED,MAAI,CAAC,kBACH,MAAM,KAAK,CAAC,GAAG,OAAO,EAAE,cAAc,MAAM,EAAE,cAAc,GAAG;AAGjE,SAAO;CACR;;;;;;;;;CAUD,MAAM,sBACJC,MAC6B;EAC7B,MAAM,EAAE,UAAU,OAAO,GAAG;EAC5B,MAAM,SAAS;GACb,QAAQ,KAAK;GACb,KAAK,SAAS,KAAK;GACnB,iBAAiB,EACf,OAAO,MAAM,IAAI,CAAC,SAAS;AACzB,WAAO;KACL,MAAM,KAAK;KACX,YAAY,KAAK;IAClB;GACF,EAAC,CACH;GACD,UAAU,SAAS;EACpB;AAED,MAAI;GACF,MAAM,SAAS,MAAM,KAAK,OAAO,wBAAwB,OAAO;AAChE,UAAO,OAAO;EACf,SAAQ,QAAQ;GACf,WAAW,gBAAgB,iBAAiB;AAC5C,SAAM,IAAI;EACX;CACF;;;;;;;CAQD,MAAM,kBACJC,MAC+B;EAC/B,MAAM,EAAE,IAAI,GAAG;AACf,MAAI;GACF,MAAM,OAAO,MAAM,KAAK,OAAO,UAAU;IACvC,QAAQ,KAAK;IACb,KAAK,KAAK,gBAAgB,gBAAgB;KAAE;KAAI,cAAc;IAAM,EAAC;GACtE,EAAC;AACF,UAAO,KAAK;EACb,SAAQ,OAAO;AACd,OAAI,iBAAiB,UACnB,QAAO;AAET,SAAM;EACP;CACF;;;;;;;CAQD,MAAM,sBACJC,MAC6B;EAC7B,MAAM,EAAE,IAAI,GAAG;AACf,MAAI;GACF,MAAM,OAAO,MAAM,KAAK,OAAO,WAAW;IACxC,QAAQ,KAAK;IACb,KAAK,KAAK,gBAAgB,gBAAgB;KAAE;KAAI,cAAc;IAAM,EAAC;GACtE,EAAC;AACF,UAAO,KAAK;EACb,SAAQ,OAAO;AACd,OAAI,iBAAiB,SACnB,QAAO;AAET,SAAM;EACP;CACF;;;;;;;CAQD,MAAM,qBAAqBC,MAA+C;EACxE,MAAM,EAAE,IAAI,GAAG;EACf,MAAM,KAAK,OAAO,aAAa;GAC7B,QAAQ,KAAK;GACb,KAAK,KAAK,gBAAgB,gBAAgB;IAAE;IAAI,cAAc;GAAM,EAAC;EACtE,EAAC;CACH;;;;;;;CAQD,MAAM,uBACJC,MACyC;EACzC,MAAM,EAAE,IAAI,GAAG;EACf,MAAM,iBAAiB,MAAM,KAAK,kBAAkB,EAAE,GAAI,EAAC;AAE3D,MAAI,CAAC,eACH;EAEF,MAAM,WAAW,MAAM,KAAK,eAAe,0BAA0B,EACnE,UAAU,0BACX,EAAC;AAEF,MAAI;GACF,IAAI,qBAAqB;GAEzB,MAAM,uBAAuB,IAAI,OAAO,UAAU,EAChD,UAAU,OAAO,GAAG,UAAU;IAC5B,sBAAsB,MAAM;IAC5B,SAAS,MAAM,MAAM;GACtB,EACF;GAGD,MAAM,OAAO,SAAS,SACpB,gBACA,sBACA,GAAG,kBAAkB,SAAS,CAC/B;GAED,MAAM,mBAAmB,CAACC,YAAuC;IAC/D,MAAM,aAAa,GAAG,iBAAiB,SAAS;AAEhD,QAAI,QAAQ,cAAc;KACxB,WAAW,GAAG,OAAO,MAAM;MACzB,GAAG,OAAO,UAAU,MAAM,CAAE,EAAC;KAC9B,EAAC;KAEF,WAAW,GAAG,SAAS,CAAC,QAAQ;MAC9B,WAAW,QAAQ,IAAI;MACvB,GAAG,OAAO,UAAU,MAAM,CAAE,EAAC;KAC9B,EAAC;IACH;AAED,WAAO;GACR;AAED,UAAO;IACL,cAAc;IACd,MAAM;IACN,MAAM;GACP;EACF,SAAQ,KAAK;GACZ,GAAG,SAAS,GAAG,SAAS,CAAC,MAAM,MAAM,CAAE,EAAC;AACxC,SAAM;EACP;CACF;;;;;;;;CASD,MAAM,qBAAqBC,MAAiD;EAC1E,MAAM,EAAE,IAAI,YAAY,GAAG;EAC3B,MAAM,OAAO,MAAM,KAAK,OAAO,UAAU;GACvC,MAAM;GACN,QAAQ,KAAK;GACb,KAAK,KAAK,gBAAgB,gBAAgB;IAAE;IAAI,cAAc;GAAM,EAAC;GACrE,SAAS,KAAK,oBAAoB,QAAQ;EAC3C,EAAC;EACF,WAAW,gBAAgB,kCAAkC;AAC7D,SAAO,KAAK;CACb;;;;;;;;;CAUD,MAAM,WAAWC,MAAyC;EACxD,MAAM,EAAE,UAAU,YAAY,YAAY,GAAG;EAC7C,MAAM,SAAS,MAAM,KAAK,oBAAoB,SAAS;AAEvD,MAAI,CAAC,SAAS,cAAc;GAC1B,WAAW,gBAAgB,sBAAsB;AACjD,SAAM,IAAI;EACX;EAED,MAAMC,SAAqC;GACzC,MAAM;GACN,QAAQ,KAAK;GACb,KAAK,SAAS,KAAK;GACnB,YAAY;GACZ,UAAU,SAAS;EACpB;AAED,MAAI;GACF,MAAM,OAAO,MAAM,KAAK,OAAO,WAAW,OAAO;AACjD,UAAO;IAAE,MAAM,KAAK;IAAM,YAAY;GAAY;EACnD,SAAQ,QAAQ;GACf,WAAW,gBAAgB,iBAAiB;AAC5C,SAAM,IAAI;EACX,UAAS;GACR,QAAQ;EACT;CACF;;;;;;;;;;CAWD,MAAM,YAAYC,MAAwC;EACxD,MAAM,EAAE,UAAU,YAAY,QAAQ,eAAe,GAAG;EACxD,IAAI,EAAE,mBAAmB,GAAG;EAC5B,IAAI,SAAS;EACb,MAAM,OAAO,SAAS,KAAK;EAC3B,MAAMC,WAA4B,CAAE;EACpC,IAAIC,uBAAsC;EAC1C,IAAI,gBAAgB;EACpB,IAAIC,SAAsC;EAE1C,MAAM,iBAAiB,IAAI,eAAe;GACxC,WAAW,KAAK,eAAe,yBAAyB,EAAE,KAAM,EAAC;GACjE,WAAW,GAAG,QAAQ;EACvB,GACE,GAAG,sBAAsB,YAAY;GACpC,SAAS,MAAM,KAAK,oBAAoB,SAAS;EAClD,EAAC,CACD,GAAG,gBAAgB,CAAC,aAAa;GAChC,uBAAuB;EACxB,EAAC,CACD,GAAG,iBAAiB,CAAC,EAAE,MAAM,MAAM,UAAU,KAAK;GACjD,uBAAuB;GAEvB,MAAM,iBAAiB;GACvB,MAAM,aAAa;GAEnB,UAAU;GAEV,MAAM,cAAc,SAAS;GAE7B,MAAM,cAAc,YAAY;AAC9B,QAAI;KAGF,MAAM,WAAW,GAAG,iBAAiB,KAAK;KAC1C,SAAS,GAAG,SAAS,SAAU,OAAO;AACpC,YAAM;KACP,EAAC;AAEF,aAAQ,MAAR;MACE,KAAK,YAAY,KAAK,eAAe;OACnC,MAAM,KAAK,WAAW;QACpB;QACA,YAAY;QACZ;OACD,EAAC;AACF;MACF;OACE,MAAM,KAAK,qBAAqB;QAC9B,IAAI,SAAS,KAAK;QAClB,YAAY;OACb,EAAC;AACF;KACH;KAED,iBAAiB;IAClB,SAAQ,OAAO;KAEd,MAAM,cACJ,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM;KAC1D,eAAe,QAAQ,YAAY;AACnC,WAAM;IACP,UAAS;KACR,GAAG,SAAS,GAAG,KAAK,CAAC,MAAM,WAAY,CAAE,EAAC;KAC1C,kBAAkB;IACnB;GACF;GAED,MAAM,WAAW,aAAa;GAE9B,SAAS,KAAK,SAAS;EACxB,EAAC,CACD,GAAG,cAAc,MAAM;GACtB,UAAU;EACX,EAAC;AAEJ,MAAI;GACF,MAAM,OAAO,SAAS,SAAS,YAAY,eAAe;EAC3D,SAAQ,OAAO;AACd,OAAI,yBAAyB,KAC3B,KAAI;IACF,MAAM,GAAG,SAAS,GAAG,qBAAqB;GAC3C,QAAO;IACN,WAAW,gBAAgB,8BAA8B;GAC1D;GAEH,MAAM,cACJ,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM;GAC1D,SAAS,KAAK,QAAQ,OAAO,YAAY,CAAC;EAC3C,UAAS;GAER,MAAM,QAAQ,WAAW,SAAS;GAElC,MAAM,QAAQ,IAAI,SAAS;EAC5B;AAED,SAAO;CACR;AACF"}
+{"version":3,"file":"parts-manager.js","names":["client: S3","bucket: string","minPartSize: number","partUploadSemaphore: Semaphore","metadataManager: S3MetadataManager","fileOperations: S3FileOperations","generateCompleteTag: (value: 'false' | 'true') => string | undefined","args: RetrievePartsArgs","params: AWS.ListPartsCommandInput","args: FinishMultipartUploadArgs","args: GetIncompletePartArgs","args: GetIncompletePartSizeArgs","args: DeleteIncompletePartArgs","args: DownloadIncompletePartArgs","options: { cleanUpOnEnd: boolean }","args: UploadIncompletePartArgs","args: UploadPartArgs","params: AWS.UploadPartCommandInput","args: UploadPartsArgs","promises: Promise<void>[]","pendingChunkFilepath: null | string","permit: SemaphorePermit | undefined"],"sources":["../../../../src/tus/stores/s3/parts-manager.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 { Readable } from 'node:stream'\nimport type AWS from '@aws-sdk/client-s3'\nimport type { IncompletePartInfo, TusUploadMetadata } from '../../../types'\nimport type { S3FileOperations } from './file-operations'\nimport type { S3MetadataManager } from './metadata-manager'\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 { throwError, log } = 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: id,\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    const params = {\n      Bucket: this.bucket,\n      Key: metadata.file.id,\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)\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    try {\n      const data = await this.client.getObject({\n        Bucket: this.bucket,\n        Key: this.metadataManager.generatePartKey({ id, isIncomplete: true }),\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    try {\n      const data = await this.client.headObject({\n        Bucket: this.bucket,\n        Key: this.metadataManager.generatePartKey({ id, isIncomplete: true }),\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    await this.client.deleteObject({\n      Bucket: this.bucket,\n      Key: this.metadataManager.generatePartKey({ id, isIncomplete: true }),\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    const data = await this.client.putObject({\n      Body: readStream,\n      Bucket: this.bucket,\n      Key: this.metadataManager.generatePartKey({ id, isIncomplete: true }),\n      Tagging: this.generateCompleteTag('false'),\n    })\n    log(MediaCloudLogs.S3_STORE_INCOMPLETE_PART_UPLOADED)\n    return data.ETag as string\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: metadata.file.id,\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)\n      throw new Error() // This will never execute but satisfies TypeScript\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":";;;;;;;;;AA6DA,MAAM,EAAE,YAAY,KAAK,GAAG,iBAAiB;AAE7C,IAAa,iBAAb,MAA4B;CAC1B,YACUA,QACAC,QACAC,aACAC,qBACAC,iBACAC,gBACAC,qBACR;EAPQ;EACA;EACA;EACA;EACA;EACA;EACA;CACN;;;;;;;;;CAUJ,MAAM,cAAcC,MAAmD;EACrE,MAAM,EAAE,IAAI,kBAAkB,GAAG;EACjC,MAAM,WAAW,MAAM,KAAK,gBAAgB,YAAY,EAAE,GAAI,EAAC;AAE/D,MAAI,CAAC,SAAS,cAAc;GAC1B,WAAW,iBAAiB,sBAAsB;AAClD,SAAM,IAAI;EACX;EAED,MAAMC,SAAoC;GACxC,QAAQ,KAAK;GACb,KAAK;GACL,kBAAkB;GAClB,UAAU,SAAS;EACpB;EAED,MAAM,OAAO,MAAM,KAAK,OAAO,UAAU,OAAO;EAEhD,IAAI,QAAQ,KAAK,SAAS,CAAE;AAE5B,MAAI,KAAK,aAAa;GACpB,MAAM,OAAO,MAAM,KAAK,cAAc;IACpC;IACA,kBAAkB,KAAK;GACxB,EAAC;GACF,QAAQ,CAAC,GAAG,OAAO,GAAG,IAAK;EAC5B;AAED,MAAI,CAAC,kBACH,MAAM,KAAK,CAAC,GAAG,OAAO,EAAE,cAAc,MAAM,EAAE,cAAc,GAAG;AAGjE,SAAO;CACR;;;;;;;;;CAUD,MAAM,sBACJC,MAC6B;EAC7B,MAAM,EAAE,UAAU,OAAO,GAAG;EAC5B,MAAM,SAAS;GACb,QAAQ,KAAK;GACb,KAAK,SAAS,KAAK;GACnB,iBAAiB,EACf,OAAO,MAAM,IAAI,CAAC,SAAS;AACzB,WAAO;KACL,MAAM,KAAK;KACX,YAAY,KAAK;IAClB;GACF,EAAC,CACH;GACD,UAAU,SAAS;EACpB;AAED,MAAI;GACF,MAAM,SAAS,MAAM,KAAK,OAAO,wBAAwB,OAAO;AAChE,UAAO,OAAO;EACf,SAAQ,QAAQ;GACf,WAAW,iBAAiB,iBAAiB;AAC7C,SAAM,IAAI;EACX;CACF;;;;;;;CAQD,MAAM,kBACJC,MAC+B;EAC/B,MAAM,EAAE,IAAI,GAAG;AACf,MAAI;GACF,MAAM,OAAO,MAAM,KAAK,OAAO,UAAU;IACvC,QAAQ,KAAK;IACb,KAAK,KAAK,gBAAgB,gBAAgB;KAAE;KAAI,cAAc;IAAM,EAAC;GACtE,EAAC;AACF,UAAO,KAAK;EACb,SAAQ,OAAO;AACd,OAAI,iBAAiB,UACnB,QAAO;AAET,SAAM;EACP;CACF;;;;;;;CAQD,MAAM,sBACJC,MAC6B;EAC7B,MAAM,EAAE,IAAI,GAAG;AACf,MAAI;GACF,MAAM,OAAO,MAAM,KAAK,OAAO,WAAW;IACxC,QAAQ,KAAK;IACb,KAAK,KAAK,gBAAgB,gBAAgB;KAAE;KAAI,cAAc;IAAM,EAAC;GACtE,EAAC;AACF,UAAO,KAAK;EACb,SAAQ,OAAO;AACd,OAAI,iBAAiB,SACnB,QAAO;AAET,SAAM;EACP;CACF;;;;;;;CAQD,MAAM,qBAAqBC,MAA+C;EACxE,MAAM,EAAE,IAAI,GAAG;EACf,MAAM,KAAK,OAAO,aAAa;GAC7B,QAAQ,KAAK;GACb,KAAK,KAAK,gBAAgB,gBAAgB;IAAE;IAAI,cAAc;GAAM,EAAC;EACtE,EAAC;CACH;;;;;;;CAQD,MAAM,uBACJC,MACyC;EACzC,MAAM,EAAE,IAAI,GAAG;EACf,MAAM,iBAAiB,MAAM,KAAK,kBAAkB,EAAE,GAAI,EAAC;AAE3D,MAAI,CAAC,eACH;EAEF,MAAM,WAAW,MAAM,KAAK,eAAe,0BAA0B,EACnE,UAAU,0BACX,EAAC;AAEF,MAAI;GACF,IAAI,qBAAqB;GAEzB,MAAM,uBAAuB,IAAI,OAAO,UAAU,EAChD,UAAU,OAAO,GAAG,UAAU;IAC5B,sBAAsB,MAAM;IAC5B,SAAS,MAAM,MAAM;GACtB,EACF;GAGD,MAAM,OAAO,SAAS,SACpB,gBACA,sBACA,GAAG,kBAAkB,SAAS,CAC/B;GAED,MAAM,mBAAmB,CAACC,YAAuC;IAC/D,MAAM,aAAa,GAAG,iBAAiB,SAAS;AAEhD,QAAI,QAAQ,cAAc;KACxB,WAAW,GAAG,OAAO,MAAM;MACzB,GAAG,OAAO,UAAU,MAAM,CAAE,EAAC;KAC9B,EAAC;KAEF,WAAW,GAAG,SAAS,CAAC,QAAQ;MAC9B,WAAW,QAAQ,IAAI;MACvB,GAAG,OAAO,UAAU,MAAM,CAAE,EAAC;KAC9B,EAAC;IACH;AAED,WAAO;GACR;AAED,UAAO;IACL,cAAc;IACd,MAAM;IACN,MAAM;GACP;EACF,SAAQ,KAAK;GACZ,GAAG,SAAS,GAAG,SAAS,CAAC,MAAM,MAAM,CAAE,EAAC;AACxC,SAAM;EACP;CACF;;;;;;;;CASD,MAAM,qBAAqBC,MAAiD;EAC1E,MAAM,EAAE,IAAI,YAAY,GAAG;EAC3B,MAAM,OAAO,MAAM,KAAK,OAAO,UAAU;GACvC,MAAM;GACN,QAAQ,KAAK;GACb,KAAK,KAAK,gBAAgB,gBAAgB;IAAE;IAAI,cAAc;GAAM,EAAC;GACrE,SAAS,KAAK,oBAAoB,QAAQ;EAC3C,EAAC;EACF,IAAI,eAAe,kCAAkC;AACrD,SAAO,KAAK;CACb;;;;;;;;;CAUD,MAAM,WAAWC,MAAyC;EACxD,MAAM,EAAE,UAAU,YAAY,YAAY,GAAG;EAC7C,MAAM,SAAS,MAAM,KAAK,oBAAoB,SAAS;AAEvD,MAAI,CAAC,SAAS,cAAc;GAC1B,WAAW,iBAAiB,sBAAsB;AAClD,SAAM,IAAI;EACX;EAED,MAAMC,SAAqC;GACzC,MAAM;GACN,QAAQ,KAAK;GACb,KAAK,SAAS,KAAK;GACnB,YAAY;GACZ,UAAU,SAAS;EACpB;AAED,MAAI;GACF,MAAM,OAAO,MAAM,KAAK,OAAO,WAAW,OAAO;AACjD,UAAO;IAAE,MAAM,KAAK;IAAM,YAAY;GAAY;EACnD,SAAQ,QAAQ;GACf,WAAW,iBAAiB,iBAAiB;AAC7C,SAAM,IAAI;EACX,UAAS;GACR,QAAQ;EACT;CACF;;;;;;;;;;CAWD,MAAM,YAAYC,MAAwC;EACxD,MAAM,EAAE,UAAU,YAAY,QAAQ,eAAe,GAAG;EACxD,IAAI,EAAE,mBAAmB,GAAG;EAC5B,IAAI,SAAS;EACb,MAAM,OAAO,SAAS,KAAK;EAC3B,MAAMC,WAA4B,CAAE;EACpC,IAAIC,uBAAsC;EAC1C,IAAI,gBAAgB;EACpB,IAAIC,SAAsC;EAE1C,MAAM,iBAAiB,IAAI,eAAe;GACxC,WAAW,KAAK,eAAe,yBAAyB,EAAE,KAAM,EAAC;GACjE,WAAW,GAAG,QAAQ;EACvB,GACE,GAAG,sBAAsB,YAAY;GACpC,SAAS,MAAM,KAAK,oBAAoB,SAAS;EAClD,EAAC,CACD,GAAG,gBAAgB,CAAC,aAAa;GAChC,uBAAuB;EACxB,EAAC,CACD,GAAG,iBAAiB,CAAC,EAAE,MAAM,MAAM,UAAU,KAAK;GACjD,uBAAuB;GAEvB,MAAM,iBAAiB;GACvB,MAAM,aAAa;GAEnB,UAAU;GAEV,MAAM,cAAc,SAAS;GAE7B,MAAM,cAAc,YAAY;AAC9B,QAAI;KAGF,MAAM,WAAW,GAAG,iBAAiB,KAAK;KAC1C,SAAS,GAAG,SAAS,SAAU,OAAO;AACpC,YAAM;KACP,EAAC;AAEF,aAAQ,MAAR;MACE,KAAK,YAAY,KAAK,eAAe;OACnC,MAAM,KAAK,WAAW;QACpB;QACA,YAAY;QACZ;OACD,EAAC;AACF;MACF;OACE,MAAM,KAAK,qBAAqB;QAC9B,IAAI,SAAS,KAAK;QAClB,YAAY;OACb,EAAC;AACF;KACH;KAED,iBAAiB;IAClB,SAAQ,OAAO;KAEd,MAAM,cACJ,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM;KAC1D,eAAe,QAAQ,YAAY;AACnC,WAAM;IACP,UAAS;KACR,GAAG,SAAS,GAAG,KAAK,CAAC,MAAM,WAAY,CAAE,EAAC;KAC1C,kBAAkB;IACnB;GACF;GAED,MAAM,WAAW,aAAa;GAE9B,SAAS,KAAK,SAAS;EACxB,EAAC,CACD,GAAG,cAAc,MAAM;GACtB,UAAU;EACX,EAAC;AAEJ,MAAI;GACF,MAAM,OAAO,SAAS,SAAS,YAAY,eAAe;EAC3D,SAAQ,OAAO;AACd,OAAI,yBAAyB,KAC3B,KAAI;IACF,MAAM,GAAG,SAAS,GAAG,qBAAqB;GAC3C,QAAO;IACN,IAAI,eAAe,8BAA8B;GAClD;GAEH,MAAM,cACJ,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM;GAC1D,SAAS,KAAK,QAAQ,OAAO,YAAY,CAAC;EAC3C,UAAS;GAER,MAAM,QAAQ,WAAW,SAAS;GAElC,MAAM,QAAQ,IAAI,SAAS;EAC5B;AAED,SAAO;CACR;AACF"}

package/dist/tus/stores/s3/s3-store.js

@@ -1,4 +1,4 @@
-import { MediaCloudError } from "../../../types/errors.js";
+import { MediaCloudLogs } from "../../../types/errors.js";
 import { useErrorHandler } from "../../../hooks/useErrorHandler.js";
 import { Semaphore } from "./semaphore.js";
 import { S3ExpirationManager } from "./expiration-manager.js";
@@ -10,7 +10,7 @@ import { NoSuchKey, NotFound, S3 } from "@aws-sdk/client-s3";
 import { DataStore, ERRORS, MemoryKvStore, TUS_RESUMABLE, Upload } from "@tus/utils";
 
 //#region src/tus/stores/s3/s3-store.ts
-const { logConsole } = useErrorHandler();
+const { log } = useErrorHandler();
 var S3Store = class extends DataStore {
 	client;
 	bucket;
@@ -97,7 +97,7 @@ var S3Store = class extends DataStore {
 	* @returns Promise that resolves to the created upload
 	*/
 	async create(upload) {
-		logConsole(MediaCloudError.S3_STORE_MULTIPART_INIT);
+		log(MediaCloudLogs.S3_STORE_MULTIPART_INIT);
 		const request = {
 			Bucket: this.bucket,
 			Key: upload.id,
@@ -117,7 +117,7 @@ var S3Store = class extends DataStore {
 			upload,
 			uploadId: response.UploadId
 		});
-		logConsole(MediaCloudError.S3_STORE_MULTIPART_CREATED);
+		log(MediaCloudLogs.S3_STORE_MULTIPART_CREATED);
 		return upload;
 	}
 	/**
@@ -182,7 +182,7 @@ var S3Store = class extends DataStore {
 			});
 			await this.metadataManager.completeMetadata({ upload: completedUpload });
 		} catch (error) {
-			logConsole(MediaCloudError.S3_STORE_UPLOAD_FAILED);
+			log(MediaCloudLogs.S3_STORE_UPLOAD_FAILED);
 			throw error;
 		}
 		return newOffset;
@@ -211,7 +211,7 @@ var S3Store = class extends DataStore {
 				size: metadata.file.size,
 				storage: metadata.file.storage
 			});
-			logConsole(MediaCloudError.S3_STORE_RETRIEVE_PARTS_ERROR);
+			log(MediaCloudLogs.S3_STORE_RETRIEVE_PARTS_ERROR);
 			throw error;
 		}
 		const incompletePartSize = await this.partsManager.getIncompletePartSize({ id });
@@ -226,7 +226,7 @@ var S3Store = class extends DataStore {
 	* Reads the file specified by the upload's `id` and returns a readable stream
 	*/
 	async read(id) {
-		logConsole(MediaCloudError.S3_STORE_READ_ATTEMPT);
+		log(MediaCloudLogs.S3_STORE_READ_ATTEMPT);
 		let retries = 3;
 		let lastError = null;
 		while (retries > 0) try {
@@ -234,15 +234,15 @@ var S3Store = class extends DataStore {
 				Bucket: this.bucket,
 				Key: id
 			});
-			logConsole(MediaCloudError.S3_STORE_READ_SUCCESS);
+			log(MediaCloudLogs.S3_STORE_READ_SUCCESS);
 			return data.Body;
 		} catch (error) {
-			logConsole(MediaCloudError.S3_STORE_READ_RETRY);
+			log(MediaCloudLogs.S3_STORE_READ_RETRY);
 			lastError = error;
 			retries--;
 			if (retries > 0) await new Promise((resolve) => setTimeout(resolve, 100));
 		}
-		logConsole(MediaCloudError.S3_STORE_READ_FAILED);
+		log(MediaCloudLogs.S3_STORE_READ_FAILED);
 		throw lastError || /* @__PURE__ */ new Error(`Failed to read file ${id} after retries`);
 	}
 	/**
@@ -262,7 +262,7 @@ var S3Store = class extends DataStore {
 				"NoSuchUpload",
 				"NotFound"
 			].includes(error.Code || "")) {
-				logConsole(MediaCloudError.S3_STORE_FILE_NOT_FOUND);
+				log(MediaCloudLogs.S3_STORE_FILE_NOT_FOUND);
 				throw ERRORS.FILE_NOT_FOUND;
 			}
 			throw error;

package/dist/tus/stores/s3/s3-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"s3-store.js","names":["options: S3StoreConfig","id: string","isIncompletePart: boolean","value: 'false' | 'true'","upload: Upload","request: AWS.CreateMultipartUploadCommandInput","file_id: string","upload_length: number","readable: stream.Readable","offset: number","metadata: TusUploadMetadata","lastError: Error | null","region: string"],"sources":["../../../../src/tus/stores/s3/s3-store.ts"],"sourcesContent":["import { NoSuchKey, NotFound, S3 } from '@aws-sdk/client-s3'\nimport {\n  DataStore,\n  ERRORS,\n  MemoryKvStore,\n  TUS_RESUMABLE,\n  Upload,\n  type KvStore,\n} from '@tus/utils'\nimport stream, { type Readable } from 'node:stream'\n\nimport { useErrorHandler } from '../../../hooks/useErrorHandler'\nimport { Semaphore } from './semaphore'\nimport { S3ExpirationManager } from './expiration-manager'\nimport { S3FileOperations } from './file-operations'\nimport { S3MetadataManager } from './metadata-manager'\nimport { S3PartsManager } from './parts-manager'\n\nimport type AWS from '@aws-sdk/client-s3'\nimport type { AWSError, S3StoreConfig, TusUploadMetadata } from '../../../types'\nimport { MediaCloudError } from '../../../types/errors'\n\nconst { logConsole } = useErrorHandler()\n\nexport class S3Store extends DataStore {\n  public client: S3\n  public bucket: string\n  public partSize = 8 * 1024 * 1024 // 8MB preferred part size\n  public minPartSize = 5 * 1024 * 1024 // 5MB minimum part size\n  public maxMultipartParts = 10_000\n  public maxUploadSize = 5_497_558_138_880 as const // 5TiB\n  public useTags = false\n  public expirationPeriodInMilliseconds = 0\n  protected acl?: string\n\n  protected cache: KvStore<TusUploadMetadata>\n  protected partUploadSemaphore: Semaphore\n  protected metadataManager: S3MetadataManager\n  protected fileOperations: S3FileOperations\n  protected partsManager: S3PartsManager\n  protected expirationManager: S3ExpirationManager\n  protected customEndpoint: string\n\n  constructor(options: S3StoreConfig) {\n    super()\n    const {\n      maxMultipartParts,\n      minPartSize,\n      partSize,\n      s3ClientConfig,\n      maxConcurrentPartUploads,\n      useTags,\n      expirationPeriodInMilliseconds,\n      cache,\n    } = options\n    const { acl, bucket, ...restS3ClientConfig } = s3ClientConfig\n\n    this.extensions = [\n      'creation',\n      'creation-with-upload',\n      'creation-defer-length',\n      'termination',\n      'expiration',\n    ]\n\n    this.bucket = bucket\n    this.acl = acl\n    this.client = new S3(restS3ClientConfig)\n    this.customEndpoint = String(restS3ClientConfig.endpoint)\n\n    this.partSize = partSize ?? this.partSize\n    this.minPartSize = minPartSize ?? this.minPartSize\n    this.maxMultipartParts = maxMultipartParts ?? this.maxMultipartParts\n\n    this.useTags = useTags ?? this.useTags\n    this.expirationPeriodInMilliseconds =\n      expirationPeriodInMilliseconds ?? this.expirationPeriodInMilliseconds\n    this.cache = cache ?? new MemoryKvStore<TusUploadMetadata>()\n    this.partUploadSemaphore = new Semaphore(maxConcurrentPartUploads ?? 60)\n\n    // Initialize component managers\n    this.metadataManager = new S3MetadataManager(\n      this.client,\n      this.bucket,\n      this.cache,\n      this.shouldUseExpirationTags.bind(this),\n      this.generateCompleteTag.bind(this)\n    )\n\n    this.fileOperations = new S3FileOperations(\n      this.maxMultipartParts,\n      this.maxUploadSize,\n      this.minPartSize,\n      this.partSize\n    )\n\n    this.partsManager = new S3PartsManager(\n      this.client,\n      this.bucket,\n      this.minPartSize,\n      this.partUploadSemaphore,\n      this.metadataManager,\n      this.fileOperations,\n      this.generateCompleteTag.bind(this)\n    )\n\n    this.expirationManager = new S3ExpirationManager(\n      this.client,\n      this.bucket,\n      this.expirationPeriodInMilliseconds,\n      this.generateInfoKey.bind(this),\n      this.generatePartKey.bind(this)\n    )\n\n    // Cleanup expired uploads when the store is initialized\n    this.deleteExpired()\n  }\n\n  /**\n   * Generate the key name for the info file\n   * @param id - The upload ID\n   * @returns The info file key\n   */\n  protected generateInfoKey(id: string): string {\n    return `${id}.info`\n  }\n\n  /**\n   * Generate the key name for a part file\n   * @param id - The upload ID\n   * @param isIncompletePart - Whether this is an incomplete part (default: false)\n   * @returns The part file key\n   */\n  protected generatePartKey(\n    id: string,\n    isIncompletePart: boolean = false\n  ): string {\n    return isIncompletePart ? `${id}.part` : id\n  }\n\n  /**\n   * Helper method to check if expiration tags should be used\n   * @returns True if expiration tags should be used\n   */\n  protected shouldUseExpirationTags(): boolean {\n    return this.expirationPeriodInMilliseconds !== 0 && this.useTags\n  }\n\n  /**\n   * Generates a tag for marking complete/incomplete uploads\n   * @param value - Either 'false' or 'true' to mark completion status\n   * @returns The tag string or undefined if tags shouldn't be used\n   */\n  protected generateCompleteTag(value: 'false' | 'true'): string | undefined {\n    if (!this.shouldUseExpirationTags()) {\n      return undefined\n    }\n    return `Tus-Completed=${value}`\n  }\n\n  /**\n   * Creates a multipart upload on S3 attaching any metadata to it.\n   * Also, a `${file_id}.info` file is created which holds some information\n   * about the upload itself like: `upload-id`, `upload-length`, etc.\n   * @param upload - The upload object to create\n   * @returns Promise that resolves to the created upload\n   */\n  public async create(upload: Upload): Promise<Upload> {\n    logConsole(MediaCloudError.S3_STORE_MULTIPART_INIT)\n    const request: AWS.CreateMultipartUploadCommandInput = {\n      Bucket: this.bucket,\n      Key: upload.id,\n      Metadata: { 'tus-version': TUS_RESUMABLE },\n    }\n\n    if (upload.metadata?.contentType) {\n      request.ContentType = upload.metadata.contentType as string\n    }\n\n    if (upload.metadata?.cacheControl) {\n      request.CacheControl = upload.metadata.cacheControl as string\n    }\n\n    if (this.acl) {\n      request.ACL = this.acl as AWS.ObjectCannedACL\n    }\n\n    upload.creation_date = new Date().toISOString()\n\n    const response = await this.client.createMultipartUpload(request)\n    upload.storage = {\n      type: 's3',\n      bucket: this.bucket,\n      path: response.Key as string,\n    }\n    await this.metadataManager.saveMetadata({\n      upload,\n      uploadId: response.UploadId as string,\n    })\n    logConsole(MediaCloudError.S3_STORE_MULTIPART_CREATED)\n\n    return upload\n  }\n\n  /**\n   * Declares the length of the upload\n   * @param file_id - The file ID\n   * @param upload_length - The length of the upload\n   * @returns Promise that resolves when length is declared\n   */\n  public async declareUploadLength(\n    file_id: string,\n    upload_length: number\n  ): Promise<void> {\n    const { file, 'upload-id': uploadId } =\n      await this.metadataManager.getMetadata({ id: file_id })\n    if (!file) {\n      throw ERRORS.FILE_NOT_FOUND\n    }\n\n    file.size = upload_length\n\n    await this.metadataManager.saveMetadata({ upload: file, uploadId })\n  }\n\n  /**\n   * Writes `buffer` to the file specified by the upload's `id` at `offset`\n   * @param readable - The readable stream to write\n   * @param id - The upload ID\n   * @param offset - The byte offset to write at\n   * @returns Promise that resolves to the number of bytes written\n   */\n  public async write(\n    readable: stream.Readable,\n    id: string,\n    offset: number\n  ): Promise<number> {\n    const metadata = await this.metadataManager.getMetadata({ id })\n\n    // TUS sends PATCH requests with an `upload-offset` header.\n    // Offset the write by the offset in the PATCH request.\n    const calculatedOffset = this.fileOperations.calculateOffsetFromParts({\n      parts: await this.partsManager.retrieveParts({ id }),\n    })\n    const offsetDiff = offset - calculatedOffset\n    const requestedOffset = offset\n\n    let finalReadable = readable\n\n    if (offsetDiff < 0) {\n      throw ERRORS.FILE_WRITE_ERROR\n    }\n\n    // If the offset given in the PATCH request is higher than\n    // the expected offset, we need to prepend an incomplete\n    // part to the readable stream, if one exists.\n    if (offsetDiff > 0) {\n      const incompletePart = await this.partsManager.downloadIncompletePart({\n        id,\n      })\n\n      if (!incompletePart) {\n        throw ERRORS.FILE_WRITE_ERROR\n      }\n\n      if (incompletePart.size !== offsetDiff) {\n        throw ERRORS.FILE_WRITE_ERROR\n      }\n\n      // Clear the incomplete part from S3 since it's going to be combined with the current request\n      await this.partsManager.deleteIncompletePart({ id })\n\n      // Adjust offset to account for the incomplete part\n      offset = requestedOffset - incompletePart.size\n\n      finalReadable = stream.Readable.from(\n        (async function* () {\n          yield* incompletePart.createReader({ cleanUpOnEnd: true })\n          yield* readable\n        })()\n      )\n    }\n\n    const partNumber = this.fileOperations.calculatePartNumber({\n      parts: await this.partsManager.retrieveParts({ id }),\n    })\n\n    const bytesUploaded = await this.partsManager.uploadParts({\n      metadata,\n      readStream: finalReadable,\n      currentPartNumber: partNumber,\n      offset,\n    })\n\n    // The size of the incomplete part should not be counted, because the\n    // process of the incomplete part should be fully transparent to the user.\n    const newOffset =\n      requestedOffset + bytesUploaded - (offsetDiff > 0 ? offsetDiff : 0)\n\n    // Check if the upload is complete\n    if (metadata.file.size === newOffset) {\n      try {\n        const parts = await this.partsManager.retrieveParts({ id })\n        await this.partsManager.finishMultipartUpload({ metadata, parts })\n\n        // Update the metadata with completed state\n        const completedUpload = new Upload({\n          ...metadata.file,\n          offset: newOffset,\n          size: metadata.file.size,\n          storage: metadata.file.storage,\n        })\n\n        await this.metadataManager.completeMetadata({ upload: completedUpload })\n        // Don't clear cache immediately - Payload might still need the metadata\n        // await this.metadataManager.clearCache(id)\n      } catch (error) {\n        logConsole(MediaCloudError.S3_STORE_UPLOAD_FAILED)\n        throw error\n      }\n    }\n\n    return newOffset\n  }\n\n  /**\n   * Returns the current state of the upload, i.e how much data has been\n   * uploaded and if the upload is complete.\n   */\n  public async getUpload(id: string): Promise<Upload> {\n    let metadata: TusUploadMetadata\n\n    try {\n      metadata = await this.metadataManager.getMetadata({ id })\n    } catch (error) {\n      if (\n        error instanceof NoSuchKey ||\n        error instanceof NotFound ||\n        (error as AWSError)?.Code === 'NotFound' ||\n        (error as AWSError)?.Code === 'NoSuchKey'\n      ) {\n        throw ERRORS.FILE_NOT_FOUND\n      }\n      throw error\n    }\n\n    let offset: number\n\n    try {\n      const parts = await this.partsManager.retrieveParts({ id })\n      offset = this.fileOperations.calculateOffsetFromParts({ parts })\n    } catch (error) {\n      // Check if the error is caused by the upload not being found. This happens\n      // when the multipart upload has already been completed or aborted.\n      if (\n        (error as AWSError)?.Code === 'NoSuchUpload' ||\n        (error as AWSError)?.Code === 'NoSuchKey'\n      ) {\n        return new Upload({\n          ...metadata.file,\n          metadata: metadata.file.metadata,\n          offset: metadata.file.size as number,\n          size: metadata.file.size,\n          storage: metadata.file.storage,\n        })\n      }\n\n      logConsole(MediaCloudError.S3_STORE_RETRIEVE_PARTS_ERROR)\n      throw error\n    }\n\n    const incompletePartSize = await this.partsManager.getIncompletePartSize({\n      id,\n    })\n\n    return new Upload({\n      ...metadata.file,\n      offset: offset + (incompletePartSize ?? 0),\n      size: metadata.file.size,\n      storage: metadata.file.storage,\n    })\n  }\n\n  /**\n   * Reads the file specified by the upload's `id` and returns a readable stream\n   */\n  async read(id: string): Promise<Readable> {\n    logConsole(MediaCloudError.S3_STORE_READ_ATTEMPT)\n    let retries = 3\n    let lastError: Error | null = null\n\n    while (retries > 0) {\n      try {\n        const data = await this.client.getObject({\n          Bucket: this.bucket,\n          Key: id,\n        })\n        logConsole(MediaCloudError.S3_STORE_READ_SUCCESS)\n        return data.Body as Readable\n      } catch (error) {\n        logConsole(MediaCloudError.S3_STORE_READ_RETRY)\n        lastError = error as Error\n        retries--\n\n        if (retries > 0) {\n          // Wait a bit before retrying, in case S3 needs time for consistency\n          await new Promise((resolve) => setTimeout(resolve, 100))\n        }\n      }\n    }\n\n    logConsole(MediaCloudError.S3_STORE_READ_FAILED)\n    throw lastError || new Error(`Failed to read file ${id} after retries`)\n  }\n\n  /**\n   * Removes the file specified by the upload's `id`\n   */\n  public async remove(id: string): Promise<void> {\n    try {\n      const { 'upload-id': uploadId } = await this.metadataManager.getMetadata({\n        id,\n      })\n      if (uploadId) {\n        await this.client.abortMultipartUpload({\n          Bucket: this.bucket,\n          Key: id,\n          UploadId: uploadId,\n        })\n      }\n    } catch (error) {\n      if (\n        (error as AWSError)?.code &&\n        ['NoSuchKey', 'NoSuchUpload', 'NotFound'].includes(\n          (error as AWSError).Code || ''\n        )\n      ) {\n        logConsole(MediaCloudError.S3_STORE_FILE_NOT_FOUND)\n        throw ERRORS.FILE_NOT_FOUND\n      }\n      throw error\n    }\n\n    await this.client.deleteObjects({\n      Bucket: this.bucket,\n      Delete: {\n        Objects: [\n          { Key: id },\n          { Key: this.metadataManager.generateInfoKey({ id }) },\n          {\n            Key: this.metadataManager.generatePartKey({\n              id,\n              isIncomplete: true,\n            }),\n          },\n        ],\n      },\n    })\n\n    await this.metadataManager.clearCache({ id })\n  }\n\n  /**\n   * Combine all multipart uploads into a single object\n   */\n  public async completeMultipartUpload(id: string): Promise<Upload> {\n    const metadata = await this.metadataManager.getMetadata({ id })\n    const parts = await this.partsManager.retrieveParts({ id })\n\n    const incompletePartInfo = await this.partsManager.downloadIncompletePart({\n      id,\n    })\n\n    if (incompletePartInfo) {\n      // Upload the incomplete part as a regular part\n      await this.partsManager.uploadPart({\n        metadata,\n        readStream: incompletePartInfo.createReader({ cleanUpOnEnd: true }),\n        partNumber: parts.length + 1,\n      })\n\n      // Remove the incomplete part\n      await this.partsManager.deleteIncompletePart({ id })\n\n      // Re-fetch parts to include the newly uploaded part\n      const updatedParts = await this.partsManager.retrieveParts({ id })\n      await this.partsManager.finishMultipartUpload({\n        metadata,\n        parts: updatedParts,\n      })\n    } else {\n      await this.partsManager.finishMultipartUpload({ metadata, parts })\n    }\n\n    const completedUpload = new Upload({\n      ...metadata.file,\n      offset: metadata.file.size ?? 0,\n      size: metadata.file.size ?? 0,\n      storage: metadata.file.storage,\n    })\n\n    await this.metadataManager.completeMetadata({ upload: completedUpload })\n\n    return completedUpload\n  }\n\n  /**\n   * Get the full S3 URL for an uploaded file\n   */\n  public getUrl(id: string): string {\n    // Use the custom endpoint if available\n    if (this.customEndpoint) {\n      return `${this.customEndpoint}/${this.bucket}/${id}`\n    }\n\n    // Fallback to standard AWS S3 URL format\n    const regionConfig = this.client.config.region\n    let region: string\n\n    // If region is a function, we can't resolve it synchronously, so use a fallback\n    if (typeof regionConfig === 'function') {\n      region = 'us-east-1' // fallback for sync calls\n    } else {\n      region = regionConfig || 'us-east-1'\n    }\n\n    // Standard AWS S3 URL format\n    if (region === 'us-east-1') {\n      return `https://${this.bucket}.s3.amazonaws.com/${id}`\n    } else {\n      return `https://${this.bucket}.s3.${region}.amazonaws.com/${id}`\n    }\n  }\n\n  /**\n   * Deletes expired incomplete uploads.\n   * Returns the number of deleted uploads.\n   */\n  async deleteExpired(): Promise<number> {\n    return this.expirationManager.deleteExpired()\n  }\n\n  /**\n   * Returns the expiration period in milliseconds\n   */\n  getExpiration(): number {\n    return this.expirationManager.getExpiration()\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"s3-store.js","names":["options: S3StoreConfig","id: string","isIncompletePart: boolean","value: 'false' | 'true'","upload: Upload","request: AWS.CreateMultipartUploadCommandInput","file_id: string","upload_length: number","readable: stream.Readable","offset: number","metadata: TusUploadMetadata","lastError: Error | null","region: string"],"sources":["../../../../src/tus/stores/s3/s3-store.ts"],"sourcesContent":["import { NoSuchKey, NotFound, S3 } from '@aws-sdk/client-s3'\nimport {\n  DataStore,\n  ERRORS,\n  MemoryKvStore,\n  TUS_RESUMABLE,\n  Upload,\n  type KvStore,\n} from '@tus/utils'\nimport stream, { type Readable } from 'node:stream'\n\nimport { useErrorHandler } from '../../../hooks/useErrorHandler'\nimport { Semaphore } from './semaphore'\nimport { S3ExpirationManager } from './expiration-manager'\nimport { S3FileOperations } from './file-operations'\nimport { S3MetadataManager } from './metadata-manager'\nimport { S3PartsManager } from './parts-manager'\n\nimport type AWS from '@aws-sdk/client-s3'\nimport type { AWSError, S3StoreConfig, TusUploadMetadata } from '../../../types'\nimport { MediaCloudLogs } from '../../../types/errors'\n\nconst { log } = useErrorHandler()\n\nexport class S3Store extends DataStore {\n  public client: S3\n  public bucket: string\n  public partSize = 8 * 1024 * 1024 // 8MB preferred part size\n  public minPartSize = 5 * 1024 * 1024 // 5MB minimum part size\n  public maxMultipartParts = 10_000\n  public maxUploadSize = 5_497_558_138_880 as const // 5TiB\n  public useTags = false\n  public expirationPeriodInMilliseconds = 0\n  protected acl?: string\n\n  protected cache: KvStore<TusUploadMetadata>\n  protected partUploadSemaphore: Semaphore\n  protected metadataManager: S3MetadataManager\n  protected fileOperations: S3FileOperations\n  protected partsManager: S3PartsManager\n  protected expirationManager: S3ExpirationManager\n  protected customEndpoint: string\n\n  constructor(options: S3StoreConfig) {\n    super()\n    const {\n      maxMultipartParts,\n      minPartSize,\n      partSize,\n      s3ClientConfig,\n      maxConcurrentPartUploads,\n      useTags,\n      expirationPeriodInMilliseconds,\n      cache,\n    } = options\n    const { acl, bucket, ...restS3ClientConfig } = s3ClientConfig\n\n    this.extensions = [\n      'creation',\n      'creation-with-upload',\n      'creation-defer-length',\n      'termination',\n      'expiration',\n    ]\n\n    this.bucket = bucket\n    this.acl = acl\n    this.client = new S3(restS3ClientConfig)\n    this.customEndpoint = String(restS3ClientConfig.endpoint)\n\n    this.partSize = partSize ?? this.partSize\n    this.minPartSize = minPartSize ?? this.minPartSize\n    this.maxMultipartParts = maxMultipartParts ?? this.maxMultipartParts\n\n    this.useTags = useTags ?? this.useTags\n    this.expirationPeriodInMilliseconds =\n      expirationPeriodInMilliseconds ?? this.expirationPeriodInMilliseconds\n    this.cache = cache ?? new MemoryKvStore<TusUploadMetadata>()\n    this.partUploadSemaphore = new Semaphore(maxConcurrentPartUploads ?? 60)\n\n    // Initialize component managers\n    this.metadataManager = new S3MetadataManager(\n      this.client,\n      this.bucket,\n      this.cache,\n      this.shouldUseExpirationTags.bind(this),\n      this.generateCompleteTag.bind(this)\n    )\n\n    this.fileOperations = new S3FileOperations(\n      this.maxMultipartParts,\n      this.maxUploadSize,\n      this.minPartSize,\n      this.partSize\n    )\n\n    this.partsManager = new S3PartsManager(\n      this.client,\n      this.bucket,\n      this.minPartSize,\n      this.partUploadSemaphore,\n      this.metadataManager,\n      this.fileOperations,\n      this.generateCompleteTag.bind(this)\n    )\n\n    this.expirationManager = new S3ExpirationManager(\n      this.client,\n      this.bucket,\n      this.expirationPeriodInMilliseconds,\n      this.generateInfoKey.bind(this),\n      this.generatePartKey.bind(this)\n    )\n\n    // Cleanup expired uploads when the store is initialized\n    this.deleteExpired()\n  }\n\n  /**\n   * Generate the key name for the info file\n   * @param id - The upload ID\n   * @returns The info file key\n   */\n  protected generateInfoKey(id: string): string {\n    return `${id}.info`\n  }\n\n  /**\n   * Generate the key name for a part file\n   * @param id - The upload ID\n   * @param isIncompletePart - Whether this is an incomplete part (default: false)\n   * @returns The part file key\n   */\n  protected generatePartKey(\n    id: string,\n    isIncompletePart: boolean = false\n  ): string {\n    return isIncompletePart ? `${id}.part` : id\n  }\n\n  /**\n   * Helper method to check if expiration tags should be used\n   * @returns True if expiration tags should be used\n   */\n  protected shouldUseExpirationTags(): boolean {\n    return this.expirationPeriodInMilliseconds !== 0 && this.useTags\n  }\n\n  /**\n   * Generates a tag for marking complete/incomplete uploads\n   * @param value - Either 'false' or 'true' to mark completion status\n   * @returns The tag string or undefined if tags shouldn't be used\n   */\n  protected generateCompleteTag(value: 'false' | 'true'): string | undefined {\n    if (!this.shouldUseExpirationTags()) {\n      return undefined\n    }\n    return `Tus-Completed=${value}`\n  }\n\n  /**\n   * Creates a multipart upload on S3 attaching any metadata to it.\n   * Also, a `${file_id}.info` file is created which holds some information\n   * about the upload itself like: `upload-id`, `upload-length`, etc.\n   * @param upload - The upload object to create\n   * @returns Promise that resolves to the created upload\n   */\n  public async create(upload: Upload): Promise<Upload> {\n    log(MediaCloudLogs.S3_STORE_MULTIPART_INIT)\n    const request: AWS.CreateMultipartUploadCommandInput = {\n      Bucket: this.bucket,\n      Key: upload.id,\n      Metadata: { 'tus-version': TUS_RESUMABLE },\n    }\n\n    if (upload.metadata?.contentType) {\n      request.ContentType = upload.metadata.contentType as string\n    }\n\n    if (upload.metadata?.cacheControl) {\n      request.CacheControl = upload.metadata.cacheControl as string\n    }\n\n    if (this.acl) {\n      request.ACL = this.acl as AWS.ObjectCannedACL\n    }\n\n    upload.creation_date = new Date().toISOString()\n\n    const response = await this.client.createMultipartUpload(request)\n    upload.storage = {\n      type: 's3',\n      bucket: this.bucket,\n      path: response.Key as string,\n    }\n    await this.metadataManager.saveMetadata({\n      upload,\n      uploadId: response.UploadId as string,\n    })\n    log(MediaCloudLogs.S3_STORE_MULTIPART_CREATED)\n\n    return upload\n  }\n\n  /**\n   * Declares the length of the upload\n   * @param file_id - The file ID\n   * @param upload_length - The length of the upload\n   * @returns Promise that resolves when length is declared\n   */\n  public async declareUploadLength(\n    file_id: string,\n    upload_length: number\n  ): Promise<void> {\n    const { file, 'upload-id': uploadId } =\n      await this.metadataManager.getMetadata({ id: file_id })\n    if (!file) {\n      throw ERRORS.FILE_NOT_FOUND\n    }\n\n    file.size = upload_length\n\n    await this.metadataManager.saveMetadata({ upload: file, uploadId })\n  }\n\n  /**\n   * Writes `buffer` to the file specified by the upload's `id` at `offset`\n   * @param readable - The readable stream to write\n   * @param id - The upload ID\n   * @param offset - The byte offset to write at\n   * @returns Promise that resolves to the number of bytes written\n   */\n  public async write(\n    readable: stream.Readable,\n    id: string,\n    offset: number\n  ): Promise<number> {\n    const metadata = await this.metadataManager.getMetadata({ id })\n\n    // TUS sends PATCH requests with an `upload-offset` header.\n    // Offset the write by the offset in the PATCH request.\n    const calculatedOffset = this.fileOperations.calculateOffsetFromParts({\n      parts: await this.partsManager.retrieveParts({ id }),\n    })\n    const offsetDiff = offset - calculatedOffset\n    const requestedOffset = offset\n\n    let finalReadable = readable\n\n    if (offsetDiff < 0) {\n      throw ERRORS.FILE_WRITE_ERROR\n    }\n\n    // If the offset given in the PATCH request is higher than\n    // the expected offset, we need to prepend an incomplete\n    // part to the readable stream, if one exists.\n    if (offsetDiff > 0) {\n      const incompletePart = await this.partsManager.downloadIncompletePart({\n        id,\n      })\n\n      if (!incompletePart) {\n        throw ERRORS.FILE_WRITE_ERROR\n      }\n\n      if (incompletePart.size !== offsetDiff) {\n        throw ERRORS.FILE_WRITE_ERROR\n      }\n\n      // Clear the incomplete part from S3 since it's going to be combined with the current request\n      await this.partsManager.deleteIncompletePart({ id })\n\n      // Adjust offset to account for the incomplete part\n      offset = requestedOffset - incompletePart.size\n\n      finalReadable = stream.Readable.from(\n        (async function* () {\n          yield* incompletePart.createReader({ cleanUpOnEnd: true })\n          yield* readable\n        })()\n      )\n    }\n\n    const partNumber = this.fileOperations.calculatePartNumber({\n      parts: await this.partsManager.retrieveParts({ id }),\n    })\n\n    const bytesUploaded = await this.partsManager.uploadParts({\n      metadata,\n      readStream: finalReadable,\n      currentPartNumber: partNumber,\n      offset,\n    })\n\n    // The size of the incomplete part should not be counted, because the\n    // process of the incomplete part should be fully transparent to the user.\n    const newOffset =\n      requestedOffset + bytesUploaded - (offsetDiff > 0 ? offsetDiff : 0)\n\n    // Check if the upload is complete\n    if (metadata.file.size === newOffset) {\n      try {\n        const parts = await this.partsManager.retrieveParts({ id })\n        await this.partsManager.finishMultipartUpload({ metadata, parts })\n\n        // Update the metadata with completed state\n        const completedUpload = new Upload({\n          ...metadata.file,\n          offset: newOffset,\n          size: metadata.file.size,\n          storage: metadata.file.storage,\n        })\n\n        await this.metadataManager.completeMetadata({ upload: completedUpload })\n        // Don't clear cache immediately - Payload might still need the metadata\n        // await this.metadataManager.clearCache(id)\n      } catch (error) {\n        log(MediaCloudLogs.S3_STORE_UPLOAD_FAILED)\n        throw error\n      }\n    }\n\n    return newOffset\n  }\n\n  /**\n   * Returns the current state of the upload, i.e how much data has been\n   * uploaded and if the upload is complete.\n   */\n  public async getUpload(id: string): Promise<Upload> {\n    let metadata: TusUploadMetadata\n\n    try {\n      metadata = await this.metadataManager.getMetadata({ id })\n    } catch (error) {\n      if (\n        error instanceof NoSuchKey ||\n        error instanceof NotFound ||\n        (error as AWSError)?.Code === 'NotFound' ||\n        (error as AWSError)?.Code === 'NoSuchKey'\n      ) {\n        throw ERRORS.FILE_NOT_FOUND\n      }\n      throw error\n    }\n\n    let offset: number\n\n    try {\n      const parts = await this.partsManager.retrieveParts({ id })\n      offset = this.fileOperations.calculateOffsetFromParts({ parts })\n    } catch (error) {\n      // Check if the error is caused by the upload not being found. This happens\n      // when the multipart upload has already been completed or aborted.\n      if (\n        (error as AWSError)?.Code === 'NoSuchUpload' ||\n        (error as AWSError)?.Code === 'NoSuchKey'\n      ) {\n        return new Upload({\n          ...metadata.file,\n          metadata: metadata.file.metadata,\n          offset: metadata.file.size as number,\n          size: metadata.file.size,\n          storage: metadata.file.storage,\n        })\n      }\n\n      log(MediaCloudLogs.S3_STORE_RETRIEVE_PARTS_ERROR)\n      throw error\n    }\n\n    const incompletePartSize = await this.partsManager.getIncompletePartSize({\n      id,\n    })\n\n    return new Upload({\n      ...metadata.file,\n      offset: offset + (incompletePartSize ?? 0),\n      size: metadata.file.size,\n      storage: metadata.file.storage,\n    })\n  }\n\n  /**\n   * Reads the file specified by the upload's `id` and returns a readable stream\n   */\n  async read(id: string): Promise<Readable> {\n    log(MediaCloudLogs.S3_STORE_READ_ATTEMPT)\n    let retries = 3\n    let lastError: Error | null = null\n\n    while (retries > 0) {\n      try {\n        const data = await this.client.getObject({\n          Bucket: this.bucket,\n          Key: id,\n        })\n        log(MediaCloudLogs.S3_STORE_READ_SUCCESS)\n        return data.Body as Readable\n      } catch (error) {\n        log(MediaCloudLogs.S3_STORE_READ_RETRY)\n        lastError = error as Error\n        retries--\n\n        if (retries > 0) {\n          // Wait a bit before retrying, in case S3 needs time for consistency\n          await new Promise((resolve) => setTimeout(resolve, 100))\n        }\n      }\n    }\n\n    log(MediaCloudLogs.S3_STORE_READ_FAILED)\n    throw lastError || new Error(`Failed to read file ${id} after retries`)\n  }\n\n  /**\n   * Removes the file specified by the upload's `id`\n   */\n  public async remove(id: string): Promise<void> {\n    try {\n      const { 'upload-id': uploadId } = await this.metadataManager.getMetadata({\n        id,\n      })\n      if (uploadId) {\n        await this.client.abortMultipartUpload({\n          Bucket: this.bucket,\n          Key: id,\n          UploadId: uploadId,\n        })\n      }\n    } catch (error) {\n      if (\n        (error as AWSError)?.code &&\n        ['NoSuchKey', 'NoSuchUpload', 'NotFound'].includes(\n          (error as AWSError).Code || ''\n        )\n      ) {\n        log(MediaCloudLogs.S3_STORE_FILE_NOT_FOUND)\n        throw ERRORS.FILE_NOT_FOUND\n      }\n      throw error\n    }\n\n    await this.client.deleteObjects({\n      Bucket: this.bucket,\n      Delete: {\n        Objects: [\n          { Key: id },\n          { Key: this.metadataManager.generateInfoKey({ id }) },\n          {\n            Key: this.metadataManager.generatePartKey({\n              id,\n              isIncomplete: true,\n            }),\n          },\n        ],\n      },\n    })\n\n    await this.metadataManager.clearCache({ id })\n  }\n\n  /**\n   * Combine all multipart uploads into a single object\n   */\n  public async completeMultipartUpload(id: string): Promise<Upload> {\n    const metadata = await this.metadataManager.getMetadata({ id })\n    const parts = await this.partsManager.retrieveParts({ id })\n\n    const incompletePartInfo = await this.partsManager.downloadIncompletePart({\n      id,\n    })\n\n    if (incompletePartInfo) {\n      // Upload the incomplete part as a regular part\n      await this.partsManager.uploadPart({\n        metadata,\n        readStream: incompletePartInfo.createReader({ cleanUpOnEnd: true }),\n        partNumber: parts.length + 1,\n      })\n\n      // Remove the incomplete part\n      await this.partsManager.deleteIncompletePart({ id })\n\n      // Re-fetch parts to include the newly uploaded part\n      const updatedParts = await this.partsManager.retrieveParts({ id })\n      await this.partsManager.finishMultipartUpload({\n        metadata,\n        parts: updatedParts,\n      })\n    } else {\n      await this.partsManager.finishMultipartUpload({ metadata, parts })\n    }\n\n    const completedUpload = new Upload({\n      ...metadata.file,\n      offset: metadata.file.size ?? 0,\n      size: metadata.file.size ?? 0,\n      storage: metadata.file.storage,\n    })\n\n    await this.metadataManager.completeMetadata({ upload: completedUpload })\n\n    return completedUpload\n  }\n\n  /**\n   * Get the full S3 URL for an uploaded file\n   */\n  public getUrl(id: string): string {\n    // Use the custom endpoint if available\n    if (this.customEndpoint) {\n      return `${this.customEndpoint}/${this.bucket}/${id}`\n    }\n\n    // Fallback to standard AWS S3 URL format\n    const regionConfig = this.client.config.region\n    let region: string\n\n    // If region is a function, we can't resolve it synchronously, so use a fallback\n    if (typeof regionConfig === 'function') {\n      region = 'us-east-1' // fallback for sync calls\n    } else {\n      region = regionConfig || 'us-east-1'\n    }\n\n    // Standard AWS S3 URL format\n    if (region === 'us-east-1') {\n      return `https://${this.bucket}.s3.amazonaws.com/${id}`\n    } else {\n      return `https://${this.bucket}.s3.${region}.amazonaws.com/${id}`\n    }\n  }\n\n  /**\n   * Deletes expired incomplete uploads.\n   * Returns the number of deleted uploads.\n   */\n  async deleteExpired(): Promise<number> {\n    return this.expirationManager.deleteExpired()\n  }\n\n  /**\n   * Returns the expiration period in milliseconds\n   */\n  getExpiration(): number {\n    return this.expirationManager.getExpiration()\n  }\n}\n"],"mappings":"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"}

package/dist/types/errors.d.ts

@@ -1,40 +1,8 @@
+import { ErrorSet, LogSet } from "@maas/error-handler";
+
 //#region src/types/errors.d.ts
-declare enum MediaCloudError {
-  MUX_CONFIG_MISSING = "Mux configuration (tokenId and tokenSecret) must be provided in pluginOptions to use Mux",
-  MUX_CONFIG_INCOMPLETE = "Mux configuration is missing. Mux features will not be available",
-  MUX_UPLOAD_ID_MISSING = "No upload-id found for upload",
-  MUX_ASSET_DELETE_ERROR = "Error deleting Mux asset",
-  MUX_UPLOAD_ERROR = "Mux video upload failed",
-  MUX_DIRECT_UPLOAD_ERROR = "Mux direct upload failed",
-  MUX_CREATE_UPLOAD_ERROR = "Error in Mux create upload handler",
-  MUX_REQUEST_NO_JSON = "Request does not support json() method",
-  S3_CONFIG_MISSING = "S3 configuration (bucket, region, accessKeyId, secretAccessKey) must be provided in pluginOptions",
-  S3_DELETE_ERROR = "Error deleting file from S3",
-  S3_UNIQUE_NAME_ERROR = "Could not find a unique file name after maximum tries",
-  TUS_UPLOAD_ERROR = "TUS file upload error occurred",
-  FILE_TYPE_UNKNOWN = "Unable to determine file type",
-  FILE_TYPE_ERROR = "Error determining file type",
-  FILENAME_SANITIZE_ERROR = "Error sanitizing filename",
-  UPLOAD_NO_URL = "No upload URL provided, cannot parse upload ID",
-  UPLOAD_HANDLER_ERROR = "Upload handler error occurred",
-  UPLOAD_POLLING_ERROR = "Polling error for upload",
-  PLUGIN_NOT_CONFIGURED = "Payload Media Cloud plugin is not configured",
-  NAMING_FUNCTION_ERROR = "Error in namingFunction",
-  S3_STORE_MULTIPART_INIT = "Initializing multipart upload",
-  S3_STORE_MULTIPART_CREATED = "Multipart upload created",
-  S3_STORE_UPLOAD_FAILED = "Failed to finish upload",
-  S3_STORE_READ_ATTEMPT = "Attempting to read file from S3",
-  S3_STORE_READ_SUCCESS = "Successfully read file from S3",
-  S3_STORE_READ_RETRY = "Failed to read file, retries left",
-  S3_STORE_READ_FAILED = "Failed to read file after all retries",
-  S3_STORE_FILE_NOT_FOUND = "No file found",
-  S3_STORE_RETRIEVE_PARTS_ERROR = "Error retrieving parts",
-  S3_STORE_METADATA_SAVING = "Saving metadata",
-  S3_STORE_METADATA_SAVED = "Metadata file saved",
-  S3_STORE_METADATA_CACHE_CLEARED = "Removing cached data",
-  S3_STORE_INCOMPLETE_PART_UPLOADED = "Finished uploading incomplete part",
-  S3_STORE_CHUNK_REMOVAL_FAILED = "Failed to remove chunk",
-}
+declare const MediaCloudErrors: ErrorSet;
+declare const MediaCloudLogs: LogSet;
 //#endregion
-export { MediaCloudError };
+export { MediaCloudErrors, MediaCloudLogs };
 //# sourceMappingURL=errors.d.ts.map