@maas/payload-plugin-media-cloud 0.0.0

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

@@ -0,0 +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'\nimport { log } from './log'\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 } = 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    log(`[${id}] finished uploading incomplete part`)\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          log(\n            `[${metadata.file.id}] failed to remove chunk ${String(pendingChunkFilepath)}`\n          )\n        }\n      }\n      const mappedError =\n        error instanceof Error ? error : new Error(String(error))\n      promises.push(Promise.reject(mappedError))\n    } finally {\n      // Wait for all promises\n      await Promise.allSettled(promises)\n      // Reject the promise if any of the promises reject\n      await Promise.all(promises)\n    }\n\n    return bytesUploaded\n  }\n}\n"],"mappings":"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"}

package/dist/tus/stores/s3/s3-store.d.ts

@@ -0,0 +1,110 @@
+import { Semaphore } from "./semaphore.js";
+import { S3ExpirationManager } from "./expiration-manager.js";
+import { S3FileOperations } from "./file-operations.js";
+import { S3StoreConfig, TusUploadMetadata } from "../../../types/index.js";
+import { S3MetadataManager } from "./metadata-manager.js";
+import { S3PartsManager } from "./parts-manager.js";
+import stream, { Readable } from "node:stream";
+import { S3 } from "@aws-sdk/client-s3";
+import { DataStore, KvStore, Upload } from "@tus/utils";
+
+//#region src/tus/stores/s3/s3-store.d.ts
+declare class S3Store extends DataStore {
+  client: S3;
+  bucket: string;
+  partSize: number;
+  minPartSize: number;
+  maxMultipartParts: number;
+  maxUploadSize: 5497558138880;
+  useTags: boolean;
+  expirationPeriodInMilliseconds: number;
+  protected acl?: string;
+  protected cache: KvStore<TusUploadMetadata>;
+  protected partUploadSemaphore: Semaphore;
+  protected metadataManager: S3MetadataManager;
+  protected fileOperations: S3FileOperations;
+  protected partsManager: S3PartsManager;
+  protected expirationManager: S3ExpirationManager;
+  protected customEndpoint: string;
+  constructor(options: S3StoreConfig);
+  /**
+   * Generate the key name for the info file
+   * @param id - The upload ID
+   * @returns The info file key
+   */
+  protected generateInfoKey(id: string): string;
+  /**
+   * Generate the key name for a part file
+   * @param id - The upload ID
+   * @param isIncompletePart - Whether this is an incomplete part (default: false)
+   * @returns The part file key
+   */
+  protected generatePartKey(id: string, isIncompletePart?: boolean): string;
+  /**
+   * Helper method to check if expiration tags should be used
+   * @returns True if expiration tags should be used
+   */
+  protected shouldUseExpirationTags(): boolean;
+  /**
+   * Generates a tag for marking complete/incomplete uploads
+   * @param value - Either 'false' or 'true' to mark completion status
+   * @returns The tag string or undefined if tags shouldn't be used
+   */
+  protected generateCompleteTag(value: 'false' | 'true'): string | undefined;
+  /**
+   * Creates a multipart upload on S3 attaching any metadata to it.
+   * Also, a `${file_id}.info` file is created which holds some information
+   * about the upload itself like: `upload-id`, `upload-length`, etc.
+   * @param upload - The upload object to create
+   * @returns Promise that resolves to the created upload
+   */
+  create(upload: Upload): Promise<Upload>;
+  /**
+   * Declares the length of the upload
+   * @param file_id - The file ID
+   * @param upload_length - The length of the upload
+   * @returns Promise that resolves when length is declared
+   */
+  declareUploadLength(file_id: string, upload_length: number): Promise<void>;
+  /**
+   * Writes `buffer` to the file specified by the upload's `id` at `offset`
+   * @param readable - The readable stream to write
+   * @param id - The upload ID
+   * @param offset - The byte offset to write at
+   * @returns Promise that resolves to the number of bytes written
+   */
+  write(readable: stream.Readable, id: string, offset: number): Promise<number>;
+  /**
+   * Returns the current state of the upload, i.e how much data has been
+   * uploaded and if the upload is complete.
+   */
+  getUpload(id: string): Promise<Upload>;
+  /**
+   * Reads the file specified by the upload's `id` and returns a readable stream
+   */
+  read(id: string): Promise<Readable>;
+  /**
+   * Removes the file specified by the upload's `id`
+   */
+  remove(id: string): Promise<void>;
+  /**
+   * Combine all multipart uploads into a single object
+   */
+  completeMultipartUpload(id: string): Promise<Upload>;
+  /**
+   * Get the full S3 URL for an uploaded file
+   */
+  getUrl(id: string): string;
+  /**
+   * Deletes expired incomplete uploads.
+   * Returns the number of deleted uploads.
+   */
+  deleteExpired(): Promise<number>;
+  /**
+   * Returns the expiration period in milliseconds
+   */
+  getExpiration(): number;
+}
+//#endregion
+export { S3Store };
+//# sourceMappingURL=s3-store.d.ts.map

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

@@ -0,0 +1,342 @@
+import { log } from "./log.js";
+import { Semaphore } from "./semaphore.js";
+import { S3ExpirationManager } from "./expiration-manager.js";
+import { S3FileOperations } from "./file-operations.js";
+import { S3MetadataManager } from "./metadata-manager.js";
+import { S3PartsManager } from "./parts-manager.js";
+import stream from "node:stream";
+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
+var S3Store = class extends DataStore {
+	client;
+	bucket;
+	partSize = 8 * 1024 * 1024;
+	minPartSize = 5 * 1024 * 1024;
+	maxMultipartParts = 1e4;
+	maxUploadSize = 5497558138880;
+	useTags = false;
+	expirationPeriodInMilliseconds = 0;
+	acl;
+	cache;
+	partUploadSemaphore;
+	metadataManager;
+	fileOperations;
+	partsManager;
+	expirationManager;
+	customEndpoint;
+	constructor(options) {
+		super();
+		const { maxMultipartParts, minPartSize, partSize, s3ClientConfig, maxConcurrentPartUploads, useTags, expirationPeriodInMilliseconds, cache } = options;
+		const { acl, bucket,...restS3ClientConfig } = s3ClientConfig;
+		this.extensions = [
+			"creation",
+			"creation-with-upload",
+			"creation-defer-length",
+			"termination",
+			"expiration"
+		];
+		this.bucket = bucket;
+		this.acl = acl;
+		this.client = new S3(restS3ClientConfig);
+		this.customEndpoint = String(restS3ClientConfig.endpoint);
+		this.partSize = partSize ?? this.partSize;
+		this.minPartSize = minPartSize ?? this.minPartSize;
+		this.maxMultipartParts = maxMultipartParts ?? this.maxMultipartParts;
+		this.useTags = useTags ?? this.useTags;
+		this.expirationPeriodInMilliseconds = expirationPeriodInMilliseconds ?? this.expirationPeriodInMilliseconds;
+		this.cache = cache ?? new MemoryKvStore();
+		this.partUploadSemaphore = new Semaphore(maxConcurrentPartUploads ?? 60);
+		this.metadataManager = new S3MetadataManager(this.client, this.bucket, this.cache, this.shouldUseExpirationTags.bind(this), this.generateCompleteTag.bind(this));
+		this.fileOperations = new S3FileOperations(this.maxMultipartParts, this.maxUploadSize, this.minPartSize, this.partSize);
+		this.partsManager = new S3PartsManager(this.client, this.bucket, this.minPartSize, this.partUploadSemaphore, this.metadataManager, this.fileOperations, this.generateCompleteTag.bind(this));
+		this.expirationManager = new S3ExpirationManager(this.client, this.bucket, this.expirationPeriodInMilliseconds, this.generateInfoKey.bind(this), this.generatePartKey.bind(this));
+		this.deleteExpired();
+	}
+	/**
+	* Generate the key name for the info file
+	* @param id - The upload ID
+	* @returns The info file key
+	*/
+	generateInfoKey(id) {
+		return `${id}.info`;
+	}
+	/**
+	* Generate the key name for a part file
+	* @param id - The upload ID
+	* @param isIncompletePart - Whether this is an incomplete part (default: false)
+	* @returns The part file key
+	*/
+	generatePartKey(id, isIncompletePart = false) {
+		return isIncompletePart ? `${id}.part` : id;
+	}
+	/**
+	* Helper method to check if expiration tags should be used
+	* @returns True if expiration tags should be used
+	*/
+	shouldUseExpirationTags() {
+		return this.expirationPeriodInMilliseconds !== 0 && this.useTags;
+	}
+	/**
+	* Generates a tag for marking complete/incomplete uploads
+	* @param value - Either 'false' or 'true' to mark completion status
+	* @returns The tag string or undefined if tags shouldn't be used
+	*/
+	generateCompleteTag(value) {
+		if (!this.shouldUseExpirationTags()) return void 0;
+		return `Tus-Completed=${value}`;
+	}
+	/**
+	* Creates a multipart upload on S3 attaching any metadata to it.
+	* Also, a `${file_id}.info` file is created which holds some information
+	* about the upload itself like: `upload-id`, `upload-length`, etc.
+	* @param upload - The upload object to create
+	* @returns Promise that resolves to the created upload
+	*/
+	async create(upload) {
+		log(`[${upload.id}] initializing multipart upload`);
+		const request = {
+			Bucket: this.bucket,
+			Key: upload.id,
+			Metadata: { "tus-version": TUS_RESUMABLE }
+		};
+		if (upload.metadata?.contentType) request.ContentType = upload.metadata.contentType;
+		if (upload.metadata?.cacheControl) request.CacheControl = upload.metadata.cacheControl;
+		if (this.acl) request.ACL = this.acl;
+		upload.creation_date = (/* @__PURE__ */ new Date()).toISOString();
+		const response = await this.client.createMultipartUpload(request);
+		upload.storage = {
+			type: "s3",
+			bucket: this.bucket,
+			path: response.Key
+		};
+		await this.metadataManager.saveMetadata({
+			upload,
+			uploadId: response.UploadId
+		});
+		log(`[${upload.id}] multipart upload created (${response.UploadId})`);
+		return upload;
+	}
+	/**
+	* Declares the length of the upload
+	* @param file_id - The file ID
+	* @param upload_length - The length of the upload
+	* @returns Promise that resolves when length is declared
+	*/
+	async declareUploadLength(file_id, upload_length) {
+		const { file, "upload-id": uploadId } = await this.metadataManager.getMetadata({ id: file_id });
+		if (!file) throw ERRORS.FILE_NOT_FOUND;
+		file.size = upload_length;
+		await this.metadataManager.saveMetadata({
+			upload: file,
+			uploadId
+		});
+	}
+	/**
+	* Writes `buffer` to the file specified by the upload's `id` at `offset`
+	* @param readable - The readable stream to write
+	* @param id - The upload ID
+	* @param offset - The byte offset to write at
+	* @returns Promise that resolves to the number of bytes written
+	*/
+	async write(readable, id, offset) {
+		const metadata = await this.metadataManager.getMetadata({ id });
+		const calculatedOffset = this.fileOperations.calculateOffsetFromParts({ parts: await this.partsManager.retrieveParts({ id }) });
+		const offsetDiff = offset - calculatedOffset;
+		const requestedOffset = offset;
+		let finalReadable = readable;
+		if (offsetDiff < 0) throw ERRORS.FILE_WRITE_ERROR;
+		if (offsetDiff > 0) {
+			const incompletePart = await this.partsManager.downloadIncompletePart({ id });
+			if (!incompletePart) throw ERRORS.FILE_WRITE_ERROR;
+			if (incompletePart.size !== offsetDiff) throw ERRORS.FILE_WRITE_ERROR;
+			await this.partsManager.deleteIncompletePart({ id });
+			offset = requestedOffset - incompletePart.size;
+			finalReadable = stream.Readable.from((async function* () {
+				yield* incompletePart.createReader({ cleanUpOnEnd: true });
+				yield* readable;
+			})());
+		}
+		const partNumber = this.fileOperations.calculatePartNumber({ parts: await this.partsManager.retrieveParts({ id }) });
+		const bytesUploaded = await this.partsManager.uploadParts({
+			metadata,
+			readStream: finalReadable,
+			currentPartNumber: partNumber,
+			offset
+		});
+		const newOffset = requestedOffset + bytesUploaded - (offsetDiff > 0 ? offsetDiff : 0);
+		if (metadata.file.size === newOffset) try {
+			const parts = await this.partsManager.retrieveParts({ id });
+			await this.partsManager.finishMultipartUpload({
+				metadata,
+				parts
+			});
+			const completedUpload = new Upload({
+				...metadata.file,
+				offset: newOffset,
+				size: metadata.file.size,
+				storage: metadata.file.storage
+			});
+			await this.metadataManager.completeMetadata({ upload: completedUpload });
+		} catch (error) {
+			log(`[${id}] failed to finish upload`, error);
+			throw error;
+		}
+		return newOffset;
+	}
+	/**
+	* Returns the current state of the upload, i.e how much data has been
+	* uploaded and if the upload is complete.
+	*/
+	async getUpload(id) {
+		let metadata;
+		try {
+			metadata = await this.metadataManager.getMetadata({ id });
+		} catch (error) {
+			if (error instanceof NoSuchKey || error instanceof NotFound || error?.Code === "NotFound" || error?.Code === "NoSuchKey") throw ERRORS.FILE_NOT_FOUND;
+			throw error;
+		}
+		let offset;
+		try {
+			const parts = await this.partsManager.retrieveParts({ id });
+			offset = this.fileOperations.calculateOffsetFromParts({ parts });
+		} catch (error) {
+			if (error?.Code === "NoSuchUpload" || error?.Code === "NoSuchKey") return new Upload({
+				...metadata.file,
+				metadata: metadata.file.metadata,
+				offset: metadata.file.size,
+				size: metadata.file.size,
+				storage: metadata.file.storage
+			});
+			log("getUpload: Error retrieving parts.", error);
+			throw error;
+		}
+		const incompletePartSize = await this.partsManager.getIncompletePartSize({ id });
+		return new Upload({
+			...metadata.file,
+			offset: offset + (incompletePartSize ?? 0),
+			size: metadata.file.size,
+			storage: metadata.file.storage
+		});
+	}
+	/**
+	* Reads the file specified by the upload's `id` and returns a readable stream
+	*/
+	async read(id) {
+		log(`[${id}] attempting to read file from S3`);
+		let retries = 3;
+		let lastError = null;
+		while (retries > 0) try {
+			const data = await this.client.getObject({
+				Bucket: this.bucket,
+				Key: id
+			});
+			log(`[${id}] successfully read file from S3`);
+			return data.Body;
+		} catch (error) {
+			log(`[${id}] failed to read file, retries left: ${retries - 1}`, error);
+			lastError = error;
+			retries--;
+			if (retries > 0) await new Promise((resolve) => setTimeout(resolve, 100));
+		}
+		log(`[${id}] failed to read file after all retries`);
+		throw lastError || /* @__PURE__ */ new Error(`Failed to read file ${id} after retries`);
+	}
+	/**
+	* Removes the file specified by the upload's `id`
+	*/
+	async remove(id) {
+		try {
+			const { "upload-id": uploadId } = await this.metadataManager.getMetadata({ id });
+			if (uploadId) await this.client.abortMultipartUpload({
+				Bucket: this.bucket,
+				Key: id,
+				UploadId: uploadId
+			});
+		} catch (error) {
+			if (error?.code && [
+				"NoSuchKey",
+				"NoSuchUpload",
+				"NotFound"
+			].includes(error.Code || "")) {
+				log("remove: No file found.", error);
+				throw ERRORS.FILE_NOT_FOUND;
+			}
+			throw error;
+		}
+		await this.client.deleteObjects({
+			Bucket: this.bucket,
+			Delete: { Objects: [
+				{ Key: id },
+				{ Key: this.metadataManager.generateInfoKey({ id }) },
+				{ Key: this.metadataManager.generatePartKey({
+					id,
+					isIncomplete: true
+				}) }
+			] }
+		});
+		await this.metadataManager.clearCache({ id });
+	}
+	/**
+	* Combine all multipart uploads into a single object
+	*/
+	async completeMultipartUpload(id) {
+		const metadata = await this.metadataManager.getMetadata({ id });
+		const parts = await this.partsManager.retrieveParts({ id });
+		const incompletePartInfo = await this.partsManager.downloadIncompletePart({ id });
+		if (incompletePartInfo) {
+			await this.partsManager.uploadPart({
+				metadata,
+				readStream: incompletePartInfo.createReader({ cleanUpOnEnd: true }),
+				partNumber: parts.length + 1
+			});
+			await this.partsManager.deleteIncompletePart({ id });
+			const updatedParts = await this.partsManager.retrieveParts({ id });
+			await this.partsManager.finishMultipartUpload({
+				metadata,
+				parts: updatedParts
+			});
+		} else await this.partsManager.finishMultipartUpload({
+			metadata,
+			parts
+		});
+		const completedUpload = new Upload({
+			...metadata.file,
+			offset: metadata.file.size ?? 0,
+			size: metadata.file.size ?? 0,
+			storage: metadata.file.storage
+		});
+		await this.metadataManager.completeMetadata({ upload: completedUpload });
+		return completedUpload;
+	}
+	/**
+	* Get the full S3 URL for an uploaded file
+	*/
+	getUrl(id) {
+		if (this.customEndpoint) return `${this.customEndpoint}/${this.bucket}/${id}`;
+		const regionConfig = this.client.config.region;
+		let region;
+		if (typeof regionConfig === "function") region = "us-east-1";
+		else region = regionConfig || "us-east-1";
+		if (region === "us-east-1") return `https://${this.bucket}.s3.amazonaws.com/${id}`;
+		else return `https://${this.bucket}.s3.${region}.amazonaws.com/${id}`;
+	}
+	/**
+	* Deletes expired incomplete uploads.
+	* Returns the number of deleted uploads.
+	*/
+	async deleteExpired() {
+		return this.expirationManager.deleteExpired({});
+	}
+	/**
+	* Returns the expiration period in milliseconds
+	*/
+	getExpiration() {
+		return this.expirationManager.getExpiration();
+	}
+};
+
+//#endregion
+export { S3Store };
+//# sourceMappingURL=s3-store.js.map

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

@@ -0,0 +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 { log } from './log'\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'\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(`[${upload.id}] initializing multipart upload`)\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(`[${upload.id}] multipart upload created (${response.UploadId})`)\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(`[${id}] failed to finish upload`, error)\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('getUpload: Error retrieving 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(`[${id}] attempting to read file from S3`)\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(`[${id}] successfully read file from S3`)\n        return data.Body as Readable\n      } catch (error) {\n        log(`[${id}] failed to read file, retries left: ${retries - 1}`, error)\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(`[${id}] failed to read file after all retries`)\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('remove: No file found.', error)\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/tus/stores/s3/semaphore.d.ts

@@ -0,0 +1,16 @@
+//#region src/tus/stores/s3/semaphore.d.ts
+/**
+ * A semaphore implementation for controlling concurrent operations.
+ * Used to limit the number of simultaneous part uploads to S3.
+ */
+declare class Semaphore {
+  private permits;
+  private queue;
+  constructor(permits: number);
+  private release;
+  acquire(): Promise<() => void>;
+}
+type SemaphorePermit = () => void;
+//#endregion
+export { Semaphore, SemaphorePermit };
+//# sourceMappingURL=semaphore.d.ts.map

package/dist/tus/stores/s3/semaphore.js

@@ -0,0 +1,32 @@
+//#region src/tus/stores/s3/semaphore.ts
+/**
+* A semaphore implementation for controlling concurrent operations.
+* Used to limit the number of simultaneous part uploads to S3.
+*/
+var Semaphore = class {
+	permits;
+	queue = [];
+	constructor(permits) {
+		this.permits = permits;
+	}
+	release() {
+		this.permits++;
+		const next = this.queue.shift();
+		if (next) next();
+	}
+	async acquire() {
+		return new Promise((resolve) => {
+			if (this.permits > 0) {
+				this.permits--;
+				resolve(() => this.release());
+			} else this.queue.push(() => {
+				this.permits--;
+				resolve(() => this.release());
+			});
+		});
+	}
+};
+
+//#endregion
+export { Semaphore };
+//# sourceMappingURL=semaphore.js.map

package/dist/tus/stores/s3/semaphore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semaphore.js","names":["permits: number"],"sources":["../../../../src/tus/stores/s3/semaphore.ts"],"sourcesContent":["/**\n * A semaphore implementation for controlling concurrent operations.\n * Used to limit the number of simultaneous part uploads to S3.\n */\nexport class Semaphore {\n  private permits: number\n  private queue: (() => void)[] = []\n\n  constructor(permits: number) {\n    this.permits = permits\n  }\n\n  private release(): void {\n    this.permits++\n    const next = this.queue.shift()\n    if (next) {\n      next()\n    }\n  }\n\n  async acquire(): Promise<() => void> {\n    return new Promise((resolve) => {\n      if (this.permits > 0) {\n        this.permits--\n        resolve(() => this.release())\n      } else {\n        this.queue.push(() => {\n          this.permits--\n          resolve(() => this.release())\n        })\n      }\n    })\n  }\n}\n\nexport type SemaphorePermit = () => void\n"],"mappings":";;;;;AAIA,IAAa,YAAb,MAAuB;CACrB,AAAQ;CACR,AAAQ,QAAwB,CAAE;CAElC,YAAYA,SAAiB;EAC3B,KAAK,UAAU;CAChB;CAED,AAAQ,UAAgB;EACtB,KAAK;EACL,MAAM,OAAO,KAAK,MAAM,OAAO;AAC/B,MAAI,MACF,MAAM;CAET;CAED,MAAM,UAA+B;AACnC,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,OAAI,KAAK,UAAU,GAAG;IACpB,KAAK;IACL,QAAQ,MAAM,KAAK,SAAS,CAAC;GAC9B,OACC,KAAK,MAAM,KAAK,MAAM;IACpB,KAAK;IACL,QAAQ,MAAM,KAAK,SAAS,CAAC;GAC9B,EAAC;EAEL;CACF;AACF"}

package/dist/types/errors.d.ts

@@ -0,0 +1,26 @@
+//#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",
+}
+//#endregion
+export { MediaCloudError };
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.js

@@ -0,0 +1,28 @@
+//#region src/types/errors.ts
+let MediaCloudError = /* @__PURE__ */ function(MediaCloudError$1) {
+	MediaCloudError$1["MUX_CONFIG_MISSING"] = "Mux configuration (tokenId and tokenSecret) must be provided in pluginOptions to use Mux";
+	MediaCloudError$1["MUX_CONFIG_INCOMPLETE"] = "Mux configuration is missing. Mux features will not be available";
+	MediaCloudError$1["MUX_UPLOAD_ID_MISSING"] = "No upload-id found for upload";
+	MediaCloudError$1["MUX_ASSET_DELETE_ERROR"] = "Error deleting Mux asset";
+	MediaCloudError$1["MUX_UPLOAD_ERROR"] = "Mux video upload failed";
+	MediaCloudError$1["MUX_DIRECT_UPLOAD_ERROR"] = "Mux direct upload failed";
+	MediaCloudError$1["MUX_CREATE_UPLOAD_ERROR"] = "Error in Mux create upload handler";
+	MediaCloudError$1["MUX_REQUEST_NO_JSON"] = "Request does not support json() method";
+	MediaCloudError$1["S3_CONFIG_MISSING"] = "S3 configuration (bucket, region, accessKeyId, secretAccessKey) must be provided in pluginOptions";
+	MediaCloudError$1["S3_DELETE_ERROR"] = "Error deleting file from S3";
+	MediaCloudError$1["S3_UNIQUE_NAME_ERROR"] = "Could not find a unique file name after maximum tries";
+	MediaCloudError$1["TUS_UPLOAD_ERROR"] = "TUS file upload error occurred";
+	MediaCloudError$1["FILE_TYPE_UNKNOWN"] = "Unable to determine file type";
+	MediaCloudError$1["FILE_TYPE_ERROR"] = "Error determining file type";
+	MediaCloudError$1["FILENAME_SANITIZE_ERROR"] = "Error sanitizing filename";
+	MediaCloudError$1["UPLOAD_NO_URL"] = "No upload URL provided, cannot parse upload ID";
+	MediaCloudError$1["UPLOAD_HANDLER_ERROR"] = "Upload handler error occurred";
+	MediaCloudError$1["UPLOAD_POLLING_ERROR"] = "Polling error for upload";
+	MediaCloudError$1["PLUGIN_NOT_CONFIGURED"] = "Payload Media Cloud plugin is not configured";
+	MediaCloudError$1["NAMING_FUNCTION_ERROR"] = "Error in namingFunction";
+	return MediaCloudError$1;
+}({});
+
+//#endregion
+export { MediaCloudError };
+//# sourceMappingURL=errors.js.map