@maas/payload-plugin-media-cloud 0.0.30 → 0.0.32

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

@@ -0,0 +1 @@
+{"version":3,"file":"s3Store.mjs","names":["request: AWS.CreateMultipartUploadCommandInput","metadata: TusUploadMetadata","offset: number","lastError: Error | null","region: string"],"sources":["../../../../src/tus/stores/s3/s3Store.ts"],"sourcesContent":["import { NoSuchKey, NotFound, S3 } from '@aws-sdk/client-s3'\nimport { DataStore, ERRORS, TUS_RESUMABLE, Upload } from '@tus/utils'\nimport stream, { type Readable } from 'node:stream'\n\nimport { useErrorHandler } from '../../../hooks/useErrorHandler'\nimport { Semaphore } from './semaphore'\nimport { S3ExpirationManager } from './expirationManager'\nimport { S3FileOperations } from './fileOperations'\nimport { S3MetadataManager } from './metadataManager'\nimport { S3PartsManager } from './partsManager'\n\nimport { MediaCloudLogs } from '../../../types/errors'\n\nimport type AWS from '@aws-sdk/client-s3'\nimport type { AWSError, S3StoreConfig, TusUploadMetadata } from '../../../types'\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 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    } = 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.partUploadSemaphore = new Semaphore(maxConcurrentPartUploads ?? 60)\n\n    // Initialize component managers\n    this.metadataManager = new S3MetadataManager(\n      this.client,\n      this.bucket,\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.metadataManager.generateInfoKey.bind(this.metadataManager),\n      this.metadataManager.generatePartKey.bind(this.metadataManager)\n    )\n\n    // Cleanup expired uploads when the store is initialized\n    this.deleteExpired()\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   * @return Promise that resolves to the created upload object with storage information\n   */\n  public async create(upload: Upload): Promise<Upload> {\n    log(MediaCloudLogs.S3_STORE_MULTIPART_INIT)\n\n    const request: AWS.CreateMultipartUploadCommandInput = {\n      Bucket: this.bucket,\n      Key: this.metadataManager.generatePartKey({\n        id: upload.id,\n        prefix: upload.metadata?.prefix ?? undefined,\n      }),\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\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   * 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   * @return Promise that resolves to the new offset after writing the data\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      } 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   * @param id - The upload ID to retrieve\n   * @returns Promise that resolves to the upload object with current offset and storage information\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   * @param id - The upload ID to read\n   * @returns Promise that resolves to a readable stream of the file's contents\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}`)\n  }\n\n  /**\n   *\n   * Moves the file specified by its `oldKey` to `newKey`.\n   * @param oldKey - The current S3 key of the file to be moved\n   * @param newKey - The new S3 key to move the file to\n   * @return Promise that resolves when the file has been successfully moved, or rejects with an error if the move operation fails\n   */\n  public async copy(oldKey: string, newKey: string): Promise<void> {\n    try {\n      await this.client.copyObject({\n        Bucket: this.bucket,\n        CopySource: encodeURI(`${this.bucket}/${oldKey}`),\n        Key: newKey,\n      })\n\n      await this.client.deleteObject({\n        Bucket: this.bucket,\n        Key: oldKey,\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 as Error\n    }\n  }\n\n  /**\n   * Removes files specified by the upload’s `id`\n   * @param id - The upload ID to remove\n   * @returns Promise that resolves when the file and its metadata have been removed\n   */\n  public async remove(id: string): Promise<void> {\n    try {\n      const { 'upload-id': uploadId, file } =\n        await this.metadataManager.getMetadata({ id })\n      if (uploadId) {\n        await this.client.abortMultipartUpload({\n          Bucket: this.bucket,\n          Key: id,\n          UploadId: uploadId,\n        })\n      }\n\n      await this.client.deleteObjects({\n        Bucket: this.bucket,\n        Delete: {\n          Objects: [\n            {\n              Key: this.metadataManager.generatePartKey({\n                id,\n                prefix: file?.metadata?.prefix ?? undefined,\n              }),\n            },\n            {\n              Key: this.metadataManager.generatePartKey({\n                id,\n                prefix: file?.metadata?.prefix ?? undefined,\n                isIncomplete: true,\n              }),\n            },\n            {\n              Key: this.metadataManager.generateInfoKey({ id }),\n            },\n          ],\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\n  /**\n   * Removes the .info file specified by the upload’s `id`\n   * @param id - The upload ID to clean up\n   * @returns Promise that resolves when the metadata file has been removed\n   */\n  public async cleanup(id: string): Promise<void> {\n    try {\n      const { file } = await this.metadataManager.getMetadata({ id })\n\n      await this.client.deleteObjects({\n        Bucket: this.bucket,\n        Delete: {\n          Objects: [\n            {\n              Key: this.metadataManager.generatePartKey({\n                id,\n                prefix: file?.metadata?.prefix ?? undefined,\n                isIncomplete: true,\n              }),\n            },\n            {\n              Key: this.metadataManager.generateInfoKey({ id }),\n            },\n          ],\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\n  /**\n   * Combine all multipart uploads into a single object\n   * @param id - The upload ID to complete\n   * @returns Promise that resolves to the completed upload object with storage information\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   * @param id - The upload ID to get the URL for\n   * @returns The full URL to access the uploaded file on S3\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   * @returns Promise that resolves to 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   * @return 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.mts

@@ -44,6 +44,18 @@ declare const MediaCloudErrors: {
     readonly message: "Error deleting file from S3";
     readonly errorCode: 500;
   };
+  readonly S3_RENAME_ERROR: {
+    readonly message: "Error renaming file in S3";
+    readonly errorCode: 500;
+  };
+  readonly S3_MOVE_ERROR: {
+    readonly message: "Error moving file in S3";
+    readonly errorCode: 500;
+  };
+  readonly S3_PREFIX_ERROR: {
+    readonly message: "Error updating S3 prefix";
+    readonly errorCode: 500;
+  };
   readonly S3_GET_OBJECT_ERROR: {
     readonly message: "Error getting object from S3";
     readonly errorCode: 500;
@@ -64,6 +76,10 @@ declare const MediaCloudErrors: {
     readonly message: "Unknown storage type for media";
     readonly errorCode: 500;
   };
+  readonly COLLECTION_REQUIRED: {
+    readonly message: "A collection must be specified in the plugin options";
+    readonly errorCode: 400;
+  };
   readonly FILE_TYPE_UNKNOWN: {
     readonly message: "Unable to determine file type";
     readonly errorCode: 400;
@@ -72,6 +88,18 @@ declare const MediaCloudErrors: {
     readonly message: "Error determining file type";
     readonly errorCode: 500;
   };
+  readonly FILE_TYPE_UNSUPPORTED_ERROR: {
+    readonly message: "Unsupported file type";
+    readonly errorCode: 400;
+  };
+  readonly FILE_TYPE_NOT_ALLOWED: {
+    readonly message: "File type not allowed";
+    readonly errorCode: 400;
+  };
+  readonly FILE_SIZE_EXCEEDED: {
+    readonly message: "File size exceeds the maximum allowed limit";
+    readonly errorCode: 400;
+  };
   readonly FILENAME_SANITIZE_ERROR: {
     readonly message: "Error sanitizing filename";
     readonly errorCode: 500;
@@ -108,6 +136,10 @@ declare const MediaCloudErrors: {
     readonly message: "Error in namingFunction";
     readonly errorCode: 500;
   };
+  readonly FOLDER_FETCH_ERROR: {
+    readonly message: "Error fetching folder data";
+    readonly errorCode: 500;
+  };
 };
 declare enum MediaCloudLogs {
   S3_STORE_MULTIPART_INIT = "Initializing multipart upload",

package/dist/types/errors.mjs

@@ -44,6 +44,18 @@ const MediaCloudErrors = {
 		message: "Error deleting file from S3",
 		errorCode: 500
 	},
+	S3_RENAME_ERROR: {
+		message: "Error renaming file in S3",
+		errorCode: 500
+	},
+	S3_MOVE_ERROR: {
+		message: "Error moving file in S3",
+		errorCode: 500
+	},
+	S3_PREFIX_ERROR: {
+		message: "Error updating S3 prefix",
+		errorCode: 500
+	},
 	S3_GET_OBJECT_ERROR: {
 		message: "Error getting object from S3",
 		errorCode: 500
@@ -64,6 +76,10 @@ const MediaCloudErrors = {
 		message: "Unknown storage type for media",
 		errorCode: 500
 	},
+	COLLECTION_REQUIRED: {
+		message: "A collection must be specified in the plugin options",
+		errorCode: 400
+	},
 	FILE_TYPE_UNKNOWN: {
 		message: "Unable to determine file type",
 		errorCode: 400
@@ -72,6 +88,18 @@ const MediaCloudErrors = {
 		message: "Error determining file type",
 		errorCode: 500
 	},
+	FILE_TYPE_UNSUPPORTED_ERROR: {
+		message: "Unsupported file type",
+		errorCode: 400
+	},
+	FILE_TYPE_NOT_ALLOWED: {
+		message: "File type not allowed",
+		errorCode: 400
+	},
+	FILE_SIZE_EXCEEDED: {
+		message: "File size exceeds the maximum allowed limit",
+		errorCode: 400
+	},
 	FILENAME_SANITIZE_ERROR: {
 		message: "Error sanitizing filename",
 		errorCode: 500
@@ -107,6 +135,10 @@ const MediaCloudErrors = {
 	NAMING_FUNCTION_ERROR: {
 		message: "Error in namingFunction",
 		errorCode: 500
+	},
+	FOLDER_FETCH_ERROR: {
+		message: "Error fetching folder data",
+		errorCode: 500
 	}
 };
 let MediaCloudLogs = /* @__PURE__ */ function(MediaCloudLogs$1) {

package/dist/types/errors.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.mjs","names":[],"sources":["../../src/types/errors.ts"],"sourcesContent":["export const MediaCloudErrors = {\n  // Mux Errors\n  MUX_CONFIG_MISSING: {\n    message:\n      'Mux configuration (tokenId and tokenSecret) must be provided in pluginOptions to use Mux',\n    errorCode: 400,\n  },\n  MUX_CONFIG_INCOMPLETE: {\n    message: 'Mux configuration is missing. Mux features will not be available',\n    errorCode: 400,\n  },\n  MUX_UPLOAD_ID_MISSING: {\n    message: 'No upload-id found for upload',\n    errorCode: 400,\n  },\n  MUX_ASSET_DELETE_ERROR: {\n    message: 'Error deleting Mux asset',\n    errorCode: 500,\n  },\n  MUX_UPLOAD_ERROR: {\n    message: 'Mux video upload failed',\n    errorCode: 500,\n  },\n  MUX_DIRECT_UPLOAD_ERROR: {\n    message: 'Mux direct upload failed',\n    errorCode: 500,\n  },\n  MUX_CREATE_UPLOAD_ERROR: {\n    message: 'Error in Mux create upload handler',\n    errorCode: 500,\n  },\n  MUX_REQUEST_NO_JSON: {\n    message: 'Request does not support json() method',\n    errorCode: 400,\n  },\n  MUX_WEBHOOK_BODY_INVALID: {\n    message: 'Invalid Mux webhook body',\n    errorCode: 400,\n  },\n\n  // S3 Errors\n  S3_CONFIG_MISSING: {\n    message:\n      'S3 configuration (bucket, region, accessKeyId, secretAccessKey) must be provided in pluginOptions',\n    errorCode: 400,\n  },\n  S3_DELETE_ERROR: {\n    message: 'Error deleting file from S3',\n    errorCode: 500,\n  },\n  S3_GET_OBJECT_ERROR: {\n    message: 'Error getting object from S3',\n    errorCode: 500,\n  },\n  S3_UNIQUE_NAME_ERROR: {\n    message: 'Could not find a unique file name after maximum tries',\n    errorCode: 500,\n  },\n\n  // TUS Errors\n  TUS_UPLOAD_ERROR: {\n    message: 'TUS file upload error occurred',\n    errorCode: 500,\n  },\n  TUS_CLEANUP_ERROR: {\n    message: 'Error during cleanup',\n    errorCode: 500,\n  },\n\n  // General Errors\n  UNKNOWN_STORAGE_TYPE: {\n    message: 'Unknown storage type for media',\n    errorCode: 500,\n  },\n\n  // File Errors\n  FILE_TYPE_UNKNOWN: {\n    message: 'Unable to determine file type',\n    errorCode: 400,\n  },\n  FILE_TYPE_ERROR: {\n    message: 'Error determining file type',\n    errorCode: 500,\n  },\n  FILENAME_SANITIZE_ERROR: {\n    message: 'Error sanitizing filename',\n    errorCode: 500,\n  },\n  FILE_MISSING_NAME: {\n    message: 'Filename is missing, cannot parse file',\n    errorCode: 500,\n  },\n  FILE_NOT_FOUND: {\n    message: 'File not found',\n    errorCode: 404,\n  },\n  FILE_DIMENSIONS_ERROR: {\n    message: 'Error setting media dimensions',\n    errorCode: 500,\n  },\n\n  // Upload Errors\n  UPLOAD_NO_URL: {\n    message: 'No upload URL provided, cannot parse upload ID',\n    errorCode: 400,\n  },\n  UPLOAD_HANDLER_ERROR: {\n    message: 'Upload handler error occurred',\n    errorCode: 500,\n  },\n  UPLOAD_POLLING_ERROR: {\n    message: 'Polling error for upload',\n    errorCode: 500,\n  },\n\n  // Plugin Errors\n  PLUGIN_NOT_CONFIGURED: {\n    message: 'Payload Media Cloud plugin is not configured',\n    errorCode: 500,\n  },\n  NAMING_FUNCTION_ERROR: {\n    message: 'Error in namingFunction',\n    errorCode: 500,\n  },\n} as const\n\nexport enum MediaCloudLogs {\n  S3_STORE_MULTIPART_INIT = 'Initializing multipart upload',\n  S3_STORE_MULTIPART_CREATED = 'Multipart upload created',\n  S3_STORE_UPLOAD_FAILED = 'Failed to finish upload',\n  S3_STORE_READ_ATTEMPT = 'Attempting to read file from S3',\n  S3_STORE_READ_SUCCESS = 'Successfully read file from S3',\n  S3_STORE_READ_RETRY = 'Failed to read file, trying again',\n  S3_STORE_READ_FAILED = 'Failed to read file',\n  S3_STORE_FILE_NOT_FOUND = 'No file found',\n  S3_STORE_FILE_FOUND = 'File found',\n  S3_STORE_RETRIEVE_PARTS_ERROR = 'Error retrieving parts',\n  S3_STORE_METADATA_SAVING = 'Saving metadata',\n  S3_STORE_METADATA_SAVED = 'Metadata file saved',\n  S3_STORE_INCOMPLETE_PART_UPLOADED = 'Finished uploading incomplete part',\n  S3_STORE_CHUNK_REMOVAL_FAILED = 'Failed to remove chunk',\n}\n"],"mappings":";AAAA,MAAa,mBAAmB;CAE9B,oBAAoB;EAClB,SACE;EACF,WAAW;EACZ;CACD,uBAAuB;EACrB,SAAS;EACT,WAAW;EACZ;CACD,uBAAuB;EACrB,SAAS;EACT,WAAW;EACZ;CACD,wBAAwB;EACtB,SAAS;EACT,WAAW;EACZ;CACD,kBAAkB;EAChB,SAAS;EACT,WAAW;EACZ;CACD,yBAAyB;EACvB,SAAS;EACT,WAAW;EACZ;CACD,yBAAyB;EACvB,SAAS;EACT,WAAW;EACZ;CACD,qBAAqB;EACnB,SAAS;EACT,WAAW;EACZ;CACD,0BAA0B;EACxB,SAAS;EACT,WAAW;EACZ;CAGD,mBAAmB;EACjB,SACE;EACF,WAAW;EACZ;CACD,iBAAiB;EACf,SAAS;EACT,WAAW;EACZ;CACD,qBAAqB;EACnB,SAAS;EACT,WAAW;EACZ;CACD,sBAAsB;EACpB,SAAS;EACT,WAAW;EACZ;CAGD,kBAAkB;EAChB,SAAS;EACT,WAAW;EACZ;CACD,mBAAmB;EACjB,SAAS;EACT,WAAW;EACZ;CAGD,sBAAsB;EACpB,SAAS;EACT,WAAW;EACZ;CAGD,mBAAmB;EACjB,SAAS;EACT,WAAW;EACZ;CACD,iBAAiB;EACf,SAAS;EACT,WAAW;EACZ;CACD,yBAAyB;EACvB,SAAS;EACT,WAAW;EACZ;CACD,mBAAmB;EACjB,SAAS;EACT,WAAW;EACZ;CACD,gBAAgB;EACd,SAAS;EACT,WAAW;EACZ;CACD,uBAAuB;EACrB,SAAS;EACT,WAAW;EACZ;CAGD,eAAe;EACb,SAAS;EACT,WAAW;EACZ;CACD,sBAAsB;EACpB,SAAS;EACT,WAAW;EACZ;CACD,sBAAsB;EACpB,SAAS;EACT,WAAW;EACZ;CAGD,uBAAuB;EACrB,SAAS;EACT,WAAW;EACZ;CACD,uBAAuB;EACrB,SAAS;EACT,WAAW;EACZ;CACF;AAED,IAAY,4DAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA"}
+{"version":3,"file":"errors.mjs","names":[],"sources":["../../src/types/errors.ts"],"sourcesContent":["export const MediaCloudErrors = {\n  // Mux Errors\n  MUX_CONFIG_MISSING: {\n    message:\n      'Mux configuration (tokenId and tokenSecret) must be provided in pluginOptions to use Mux',\n    errorCode: 400,\n  },\n  MUX_CONFIG_INCOMPLETE: {\n    message: 'Mux configuration is missing. Mux features will not be available',\n    errorCode: 400,\n  },\n  MUX_UPLOAD_ID_MISSING: {\n    message: 'No upload-id found for upload',\n    errorCode: 400,\n  },\n  MUX_ASSET_DELETE_ERROR: {\n    message: 'Error deleting Mux asset',\n    errorCode: 500,\n  },\n  MUX_UPLOAD_ERROR: {\n    message: 'Mux video upload failed',\n    errorCode: 500,\n  },\n  MUX_DIRECT_UPLOAD_ERROR: {\n    message: 'Mux direct upload failed',\n    errorCode: 500,\n  },\n  MUX_CREATE_UPLOAD_ERROR: {\n    message: 'Error in Mux create upload handler',\n    errorCode: 500,\n  },\n  MUX_REQUEST_NO_JSON: {\n    message: 'Request does not support json() method',\n    errorCode: 400,\n  },\n  MUX_WEBHOOK_BODY_INVALID: {\n    message: 'Invalid Mux webhook body',\n    errorCode: 400,\n  },\n\n  // S3 Errors\n  S3_CONFIG_MISSING: {\n    message:\n      'S3 configuration (bucket, region, accessKeyId, secretAccessKey) must be provided in pluginOptions',\n    errorCode: 400,\n  },\n  S3_DELETE_ERROR: {\n    message: 'Error deleting file from S3',\n    errorCode: 500,\n  },\n  S3_RENAME_ERROR: {\n    message: 'Error renaming file in S3',\n    errorCode: 500,\n  },\n  S3_MOVE_ERROR: {\n    message: 'Error moving file in S3',\n    errorCode: 500,\n  },\n  S3_PREFIX_ERROR: {\n    message: 'Error updating S3 prefix',\n    errorCode: 500,\n  },\n  S3_GET_OBJECT_ERROR: {\n    message: 'Error getting object from S3',\n    errorCode: 500,\n  },\n  S3_UNIQUE_NAME_ERROR: {\n    message: 'Could not find a unique file name after maximum tries',\n    errorCode: 500,\n  },\n\n  // TUS Errors\n  TUS_UPLOAD_ERROR: {\n    message: 'TUS file upload error occurred',\n    errorCode: 500,\n  },\n  TUS_CLEANUP_ERROR: {\n    message: 'Error during cleanup',\n    errorCode: 500,\n  },\n\n  // General Errors\n  UNKNOWN_STORAGE_TYPE: {\n    message: 'Unknown storage type for media',\n    errorCode: 500,\n  },\n  COLLECTION_REQUIRED: {\n    message: 'A collection must be specified in the plugin options',\n    errorCode: 400,\n  },\n\n  // File Errors\n  FILE_TYPE_UNKNOWN: {\n    message: 'Unable to determine file type',\n    errorCode: 400,\n  },\n  FILE_TYPE_ERROR: {\n    message: 'Error determining file type',\n    errorCode: 500,\n  },\n  FILE_TYPE_UNSUPPORTED_ERROR: {\n    message: 'Unsupported file type',\n    errorCode: 400,\n  },\n  FILE_TYPE_NOT_ALLOWED: {\n    message: 'File type not allowed',\n    errorCode: 400,\n  },\n  FILE_SIZE_EXCEEDED: {\n    message: 'File size exceeds the maximum allowed limit',\n    errorCode: 400,\n  },\n  FILENAME_SANITIZE_ERROR: {\n    message: 'Error sanitizing filename',\n    errorCode: 500,\n  },\n  FILE_MISSING_NAME: {\n    message: 'Filename is missing, cannot parse file',\n    errorCode: 500,\n  },\n  FILE_NOT_FOUND: {\n    message: 'File not found',\n    errorCode: 404,\n  },\n  FILE_DIMENSIONS_ERROR: {\n    message: 'Error setting media dimensions',\n    errorCode: 500,\n  },\n\n  // Upload Errors\n  UPLOAD_NO_URL: {\n    message: 'No upload URL provided, cannot parse upload ID',\n    errorCode: 400,\n  },\n  UPLOAD_HANDLER_ERROR: {\n    message: 'Upload handler error occurred',\n    errorCode: 500,\n  },\n  UPLOAD_POLLING_ERROR: {\n    message: 'Polling error for upload',\n    errorCode: 500,\n  },\n\n  // Plugin Errors\n  PLUGIN_NOT_CONFIGURED: {\n    message: 'Payload Media Cloud plugin is not configured',\n    errorCode: 500,\n  },\n  NAMING_FUNCTION_ERROR: {\n    message: 'Error in namingFunction',\n    errorCode: 500,\n  },\n\n  // HOOK Errors\n  FOLDER_FETCH_ERROR: {\n    message: 'Error fetching folder data',\n    errorCode: 500,\n  },\n} as const\n\nexport enum MediaCloudLogs {\n  S3_STORE_MULTIPART_INIT = 'Initializing multipart upload',\n  S3_STORE_MULTIPART_CREATED = 'Multipart upload created',\n  S3_STORE_UPLOAD_FAILED = 'Failed to finish upload',\n  S3_STORE_READ_ATTEMPT = 'Attempting to read file from S3',\n  S3_STORE_READ_SUCCESS = 'Successfully read file from S3',\n  S3_STORE_READ_RETRY = 'Failed to read file, trying again',\n  S3_STORE_READ_FAILED = 'Failed to read file',\n  S3_STORE_FILE_NOT_FOUND = 'No file found',\n  S3_STORE_FILE_FOUND = 'File found',\n  S3_STORE_RETRIEVE_PARTS_ERROR = 'Error retrieving parts',\n  S3_STORE_METADATA_SAVING = 'Saving metadata',\n  S3_STORE_METADATA_SAVED = 'Metadata file saved',\n  S3_STORE_INCOMPLETE_PART_UPLOADED = 'Finished uploading incomplete part',\n  S3_STORE_CHUNK_REMOVAL_FAILED = 'Failed to remove chunk',\n}\n"],"mappings":";AAAA,MAAa,mBAAmB;CAE9B,oBAAoB;EAClB,SACE;EACF,WAAW;EACZ;CACD,uBAAuB;EACrB,SAAS;EACT,WAAW;EACZ;CACD,uBAAuB;EACrB,SAAS;EACT,WAAW;EACZ;CACD,wBAAwB;EACtB,SAAS;EACT,WAAW;EACZ;CACD,kBAAkB;EAChB,SAAS;EACT,WAAW;EACZ;CACD,yBAAyB;EACvB,SAAS;EACT,WAAW;EACZ;CACD,yBAAyB;EACvB,SAAS;EACT,WAAW;EACZ;CACD,qBAAqB;EACnB,SAAS;EACT,WAAW;EACZ;CACD,0BAA0B;EACxB,SAAS;EACT,WAAW;EACZ;CAGD,mBAAmB;EACjB,SACE;EACF,WAAW;EACZ;CACD,iBAAiB;EACf,SAAS;EACT,WAAW;EACZ;CACD,iBAAiB;EACf,SAAS;EACT,WAAW;EACZ;CACD,eAAe;EACb,SAAS;EACT,WAAW;EACZ;CACD,iBAAiB;EACf,SAAS;EACT,WAAW;EACZ;CACD,qBAAqB;EACnB,SAAS;EACT,WAAW;EACZ;CACD,sBAAsB;EACpB,SAAS;EACT,WAAW;EACZ;CAGD,kBAAkB;EAChB,SAAS;EACT,WAAW;EACZ;CACD,mBAAmB;EACjB,SAAS;EACT,WAAW;EACZ;CAGD,sBAAsB;EACpB,SAAS;EACT,WAAW;EACZ;CACD,qBAAqB;EACnB,SAAS;EACT,WAAW;EACZ;CAGD,mBAAmB;EACjB,SAAS;EACT,WAAW;EACZ;CACD,iBAAiB;EACf,SAAS;EACT,WAAW;EACZ;CACD,6BAA6B;EAC3B,SAAS;EACT,WAAW;EACZ;CACD,uBAAuB;EACrB,SAAS;EACT,WAAW;EACZ;CACD,oBAAoB;EAClB,SAAS;EACT,WAAW;EACZ;CACD,yBAAyB;EACvB,SAAS;EACT,WAAW;EACZ;CACD,mBAAmB;EACjB,SAAS;EACT,WAAW;EACZ;CACD,gBAAgB;EACd,SAAS;EACT,WAAW;EACZ;CACD,uBAAuB;EACrB,SAAS;EACT,WAAW;EACZ;CAGD,eAAe;EACb,SAAS;EACT,WAAW;EACZ;CACD,sBAAsB;EACpB,SAAS;EACT,WAAW;EACZ;CACD,sBAAsB;EACpB,SAAS;EACT,WAAW;EACZ;CAGD,uBAAuB;EACrB,SAAS;EACT,WAAW;EACZ;CACD,uBAAuB;EACrB,SAAS;EACT,WAAW;EACZ;CAGD,oBAAoB;EAClB,SAAS;EACT,WAAW;EACZ;CACF;AAED,IAAY,4DAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA"}

package/dist/types/index.d.mts

@@ -5,26 +5,64 @@ import Mux from "@mux/mux-node";
 import { EventType } from "mitt";
 
 //#region src/types/index.d.ts
+type ImageMimeType = 'image/apng' | 'image/avif' | 'image/gif' | 'image/jpeg' | 'image/png' | 'image/svg+xml' | 'image/webp';
+type VideoMimeType = 'application/mxf' | 'video/3gpp' | 'video/3gpp2' | 'video/mp2t' | 'video/mp4' | 'video/mpeg' | 'video/quicktime' | 'video/webm' | 'video/x-f4v' | 'video/x-flv' | 'video/x-matroska' | 'video/x-ms-asf' | 'video/x-ms-wmv' | 'video/x-msvideo' | 'video/x-mxf';
+type MimeType = ImageMimeType | VideoMimeType;
 interface MediaCloudPluginOptions {
   enabled?: boolean;
   collection?: string;
-  mux: {
+  view?: 'grid' | 'list';
+  storage?: {
+    'video/*': 'mux' | 's3';
+    'application/mxf'?: 'mux' | 's3';
+    'video/3gpp'?: 'mux' | 's3';
+    'video/3gpp2'?: 'mux' | 's3';
+    'video/mp2t'?: 'mux' | 's3';
+    'video/mp4'?: 'mux' | 's3';
+    'video/mpeg'?: 'mux' | 's3';
+    'video/quicktime'?: 'mux' | 's3';
+    'video/webm'?: 'mux' | 's3';
+    'video/x-f4v'?: 'mux' | 's3';
+    'video/x-flv'?: 'mux' | 's3';
+    'video/x-matroska'?: 'mux' | 's3';
+    'video/x-ms-asf'?: 'mux' | 's3';
+    'video/x-ms-wmv'?: 'mux' | 's3';
+    'video/x-msvideo'?: 'mux' | 's3';
+    'video/x-mxf'?: 'mux' | 's3';
+  };
+  limits?: {
+    mimeTypes?: (MimeType | 'image/*' | 'video/*')[];
+    fileSize?: number;
+  };
+  folders?: boolean;
+  mux?: {
     assetOptions: Partial<Mux.Video.Assets.AssetOptions>;
     tokenId: string;
     tokenSecret: string;
     webhookSecret: string;
     testMode?: boolean;
   };
-  s3: {
+  s3?: {
     accessKeyId: string;
     bucket: string;
     region: string;
     secretAccessKey: string;
-    acl?: string;
+    prefix?: string;
+    acl?: ObjectCannedACL;
     endpoint?: string;
     respectForwardedHeaders?: boolean;
   };
 }
+interface MediaCloudDefaultPluginOptions {
+  enabled: boolean;
+  collection: string;
+  view: 'grid';
+  folders: boolean;
+  storage: {
+    'video/*': 'mux';
+  };
+}
+type Storage = 'mux' | 's3';
 interface MediaCloudEmitterEvents {
   [key: EventType]: Record<string, unknown>;
   addUpload: {
@@ -97,5 +135,5 @@ interface NodeFSError extends Error {
 }
 type StaticRenditions = Record<string, unknown> | null | undefined;
 //#endregion
-export { AWSError, IncompletePartInfo, MediaCloudEmitterEvents, MediaCloudPluginOptions, NodeFSError, S3StoreConfig, StaticRenditions, TusUploadMetadata };
+export { AWSError, ImageMimeType, IncompletePartInfo, MediaCloudDefaultPluginOptions, MediaCloudEmitterEvents, MediaCloudPluginOptions, MimeType, NodeFSError, S3StoreConfig, StaticRenditions, Storage, TusUploadMetadata, VideoMimeType };
 //# sourceMappingURL=index.d.mts.map

package/dist/utils/buildS3Path.d.mts

@@ -0,0 +1,10 @@
+//#region src/utils/buildS3Path.d.ts
+interface BuildS3PathData {
+  id: string | number;
+  name: unknown;
+  folder?: unknown;
+}
+declare function buildS3Path(data: BuildS3PathData): string;
+//#endregion
+export { buildS3Path };
+//# sourceMappingURL=buildS3Path.d.mts.map

package/dist/utils/buildS3Path.mjs

@@ -0,0 +1,16 @@
+//#region src/utils/buildS3Path.ts
+function buildS3Path(data) {
+	const parts = [];
+	function traverseFolder(current) {
+		if (!current || typeof current !== "object") return;
+		if (current.folder) traverseFolder(current.folder);
+		if (current.name && typeof current.name === "string") parts.push(current.name);
+	}
+	traverseFolder(data.folder);
+	if (data.name && typeof data.name === "string") parts.push(data.name);
+	return parts.join("/");
+}
+
+//#endregion
+export { buildS3Path };
+//# sourceMappingURL=buildS3Path.mjs.map

package/dist/utils/buildS3Path.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildS3Path.mjs","names":["parts: Array<string>"],"sources":["../../src/utils/buildS3Path.ts"],"sourcesContent":["interface Folder {\n  id: string | number\n  name: unknown\n  folder?: unknown\n}\n\ninterface BuildS3PathData {\n  id: string | number\n  name: unknown\n  folder?: unknown\n}\n\nexport function buildS3Path(data: BuildS3PathData): string {\n  const parts: Array<string> = []\n\n  function traverseFolder(current: Folder): void {\n    if (!current || typeof current !== 'object') {\n      return\n    }\n\n    if (current.folder) {\n      traverseFolder(current.folder as Folder)\n    }\n\n    if (current.name && typeof current.name === 'string') {\n      parts.push(current.name)\n    }\n  }\n\n  traverseFolder(data.folder as Folder)\n\n  if (data.name && typeof data.name === 'string') {\n    parts.push(data.name)\n  }\n\n  return parts.join('/')\n}\n"],"mappings":";AAYA,SAAgB,YAAY,MAA+B;CACzD,MAAMA,QAAuB,EAAE;CAE/B,SAAS,eAAe,SAAuB;AAC7C,MAAI,CAAC,WAAW,OAAO,YAAY,SACjC;AAGF,MAAI,QAAQ,OACV,gBAAe,QAAQ,OAAiB;AAG1C,MAAI,QAAQ,QAAQ,OAAO,QAAQ,SAAS,SAC1C,OAAM,KAAK,QAAQ,KAAK;;AAI5B,gBAAe,KAAK,OAAiB;AAErC,KAAI,KAAK,QAAQ,OAAO,KAAK,SAAS,SACpC,OAAM,KAAK,KAAK,KAAK;AAGvB,QAAO,MAAM,KAAK,IAAI"}

package/dist/utils/buildThumbnailURL.d.mts

@@ -0,0 +1,14 @@
+import { Storage } from "../types/index.mjs";
+import { S3Store } from "../tus/stores/s3/s3Store.mjs";
+
+//#region src/utils/buildThumbnailURL.d.ts
+interface BuildThumbnailURLArgs {
+  storage: Storage;
+  playbackId?: string;
+  s3Key?: string;
+  s3Store?: S3Store | null;
+}
+declare function buildThumbnailURL(args: BuildThumbnailURLArgs): string | undefined;
+//#endregion
+export { buildThumbnailURL };
+//# sourceMappingURL=buildThumbnailURL.d.mts.map

package/dist/utils/buildThumbnailURL.mjs

@@ -0,0 +1,10 @@
+//#region src/utils/buildThumbnailURL.ts
+function buildThumbnailURL(args) {
+	const { storage, s3Store, playbackId, s3Key } = args;
+	if (storage === "mux" && playbackId) return `https://image.mux.com/${playbackId}/thumbnail.jpg?width=200&height=200&fit_mode=pad`;
+	if (storage === "s3" && s3Key) return `https://wsrv.nl/?url=${s3Store?.getUrl(s3Key)}?width=512&height=512&default=1&q=80`;
+}
+
+//#endregion
+export { buildThumbnailURL };
+//# sourceMappingURL=buildThumbnailURL.mjs.map

package/dist/utils/buildThumbnailURL.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildThumbnailURL.mjs","names":[],"sources":["../../src/utils/buildThumbnailURL.ts"],"sourcesContent":["import type { S3Store } from '../tus/stores/s3/s3Store'\nimport type { Storage } from '../types'\n\ninterface BuildThumbnailURLArgs {\n  storage: Storage\n  playbackId?: string\n  s3Key?: string\n  s3Store?: S3Store | null\n}\n\nexport function buildThumbnailURL(args: BuildThumbnailURLArgs) {\n  const { storage, s3Store, playbackId, s3Key } = args\n\n  if (storage === 'mux' && playbackId) {\n    return `https://image.mux.com/${playbackId}/thumbnail.jpg?width=200&height=200&fit_mode=pad`\n  }\n\n  if (storage === 's3' && s3Key) {\n    const url = s3Store?.getUrl(s3Key)\n    return `https://wsrv.nl/?url=${url}?width=512&height=512&default=1&q=80`\n  }\n}\n"],"mappings":";AAUA,SAAgB,kBAAkB,MAA6B;CAC7D,MAAM,EAAE,SAAS,SAAS,YAAY,UAAU;AAEhD,KAAI,YAAY,SAAS,WACvB,QAAO,yBAAyB,WAAW;AAG7C,KAAI,YAAY,QAAQ,MAEtB,QAAO,wBADK,SAAS,OAAO,MAAM,CACC"}

package/dist/utils/defaultOptions.d.mts

@@ -0,0 +1,7 @@
+import { MediaCloudDefaultPluginOptions } from "../types/index.mjs";
+
+//#region src/utils/defaultOptions.d.ts
+declare const defaultOptions: MediaCloudDefaultPluginOptions;
+//#endregion
+export { defaultOptions };
+//# sourceMappingURL=defaultOptions.d.mts.map

package/dist/utils/defaultOptions.mjs

@@ -0,0 +1,12 @@
+//#region src/utils/defaultOptions.ts
+const defaultOptions = {
+	enabled: true,
+	collection: "media",
+	view: "grid",
+	folders: true,
+	storage: { "video/*": "mux" }
+};
+
+//#endregion
+export { defaultOptions };
+//# sourceMappingURL=defaultOptions.mjs.map

package/dist/utils/defaultOptions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultOptions.mjs","names":["defaultOptions: MediaCloudDefaultPluginOptions"],"sources":["../../src/utils/defaultOptions.ts"],"sourcesContent":["import { MediaCloudDefaultPluginOptions } from '../types'\n\nexport const defaultOptions: MediaCloudDefaultPluginOptions = {\n  enabled: true,\n  collection: 'media',\n  view: 'grid',\n  folders: true,\n  storage: {\n    'video/*': 'mux',\n  },\n}\n"],"mappings":";AAEA,MAAaA,iBAAiD;CAC5D,SAAS;CACT,YAAY;CACZ,MAAM;CACN,SAAS;CACT,SAAS,EACP,WAAW,OACZ;CACF"}

package/dist/utils/file.d.mts

@@ -1,4 +1,9 @@
+import { MediaCloudPluginOptions, MimeType } from "../types/index.mjs";
+import { S3Store } from "../tus/stores/s3/s3Store.mjs";
+import * as payload0 from "payload";
+
 //#region src/utils/file.d.ts
+
 /**
  * Checks if a file is a video file supported by Mux
  * @param file - The file to check
@@ -10,7 +15,7 @@ declare function isVideo(file: File): Promise<boolean>;
  * @param file - The file to check
  * @returns Promise that resolves to the MIME type of the file or undefined if it cannot be determined
  */
-declare function getFileType(file: File): Promise<string | undefined>;
+declare function getMimeType(file: File): Promise<MimeType | undefined>;
 /**
  * Generates a unique filename by appending a random suffix if needed
  * @param originalFilename - The original filename
@@ -25,6 +30,15 @@ declare function generateUniqueFilename(originalFilename: string): string;
  * @throws {TypeError} When filename is not a string
  */
 declare function sanitizeFilename(filename: string): string;
+interface CreateFileEndpointsArgs {
+  getS3Store: () => S3Store;
+  pluginOptions: MediaCloudPluginOptions;
+}
+declare function createFileEndpoints(args: CreateFileEndpointsArgs): {
+  handler: payload0.PayloadHandler;
+  method: "get";
+  path: string;
+}[];
 //#endregion
-export { generateUniqueFilename, getFileType, isVideo, sanitizeFilename };
+export { createFileEndpoints, generateUniqueFilename, getMimeType, isVideo, sanitizeFilename };
 //# sourceMappingURL=file.d.mts.map

package/dist/utils/file.mjs

@@ -1,10 +1,12 @@
 import { MediaCloudErrors } from "../types/errors.mjs";
-import { useErrorHandler } from "../hooks/useErrorHandler.mjs";
+import { useMagicError } from "../error-handler/dist/index.mjs";
+import { getFileExistsHandler } from "../endpoints/fileExistsHandler.mjs";
 import { fileTypeFromBuffer } from "file-type";
 import { parse } from "pathe";
 
 //#region src/utils/file.ts
-const { logError } = useErrorHandler();
+const magicError = useMagicError({ prefix: "PLUGIN-MEDIA-CLOUD" });
+const { logError, throwError } = magicError;
 const MUX_SUPPORTED_VIDEO_FORMATS = new Set([
 	"application/mxf",
 	"video/3gpp",
@@ -35,14 +37,51 @@ async function isVideo(file) {
 		return false;
 	}
 }
+const allowedMimeTypes = new Set([
+	"application/mxf",
+	"video/3gpp",
+	"video/3gpp2",
+	"video/mp2t",
+	"video/mp4",
+	"video/mpeg",
+	"video/quicktime",
+	"video/webm",
+	"video/x-f4v",
+	"video/x-flv",
+	"video/x-matroska",
+	"video/x-ms-asf",
+	"video/x-ms-wmv",
+	"video/x-msvideo",
+	"video/x-mxf",
+	"image/apng",
+	"image/avif",
+	"image/gif",
+	"image/jpeg",
+	"image/png",
+	"image/svg+xml",
+	"image/webp"
+]);
+/**
+* Check the mime type against allowed mime types
+* @param mimeType - The file to check
+*/
+function validateMimeType(mimeType) {
+	if (!allowedMimeTypes.has(mimeType)) throwError(MediaCloudErrors.FILE_TYPE_UNSUPPORTED_ERROR);
+}
 /**
 * Gets the MIME type of a file using file-type library
 * @param file - The file to check
 * @returns Promise that resolves to the MIME type of the file or undefined if it cannot be determined
 */
-async function getFileType(file) {
+async function getMimeType(file) {
 	try {
-		return (await fileTypeFromBuffer(new Uint8Array(await file.arrayBuffer())))?.mime;
+		const fileType = await fileTypeFromBuffer(new Uint8Array(await file.arrayBuffer()));
+		if (!fileType?.mime) {
+			logError(MediaCloudErrors.FILE_TYPE_ERROR.message);
+			return;
+		}
+		validateMimeType(fileType.mime);
+		return fileType.mime;
 	} catch (_error) {
 		logError(MediaCloudErrors.FILE_TYPE_ERROR.message);
 		return;
@@ -56,7 +95,7 @@ async function getFileType(file) {
 function generateUniqueFilename(originalFilename) {
 	const timestamp = Date.now().toString(36);
 	const { name, ext } = parse(originalFilename);
-	return `${name}-${timestamp}${ext}`;
+	return `${sanitizeFilename(name)}-${timestamp}${ext}`;
 }
 /**
 * Sanitizes a filename by removing/replacing invalid characters and handling edge cases
@@ -74,7 +113,20 @@ function sanitizeFilename(filename) {
 		return filename;
 	}
 }
+function createFileEndpoints(args) {
+	const { getS3Store, pluginOptions } = args;
+	const collection = pluginOptions.collection;
+	magicError.assert(collection, MediaCloudErrors.COLLECTION_REQUIRED);
+	return [{
+		handler: getFileExistsHandler({
+			getS3Store,
+			collection
+		}),
+		method: "get",
+		path: "/uploads/:filename/exists"
+	}];
+}
 
 //#endregion
-export { generateUniqueFilename, getFileType, isVideo, sanitizeFilename };
+export { createFileEndpoints, generateUniqueFilename, getMimeType, isVideo, sanitizeFilename };
 //# sourceMappingURL=file.mjs.map

package/dist/utils/file.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"file.mjs","names":[],"sources":["../../src/utils/file.ts"],"sourcesContent":["import { fileTypeFromBuffer } from 'file-type'\nimport { parse } from 'pathe'\n\nimport { useErrorHandler } from '../hooks/useErrorHandler'\nimport { MediaCloudErrors } from '../types/errors'\n\nconst { logError } = useErrorHandler()\n\nconst MUX_SUPPORTED_VIDEO_FORMATS = new Set([\n  'application/mxf',\n  'video/3gpp',\n  'video/3gpp2',\n  'video/mp2t',\n  'video/mp4',\n  'video/mpeg',\n  'video/quicktime',\n  'video/webm',\n  'video/x-f4v',\n  'video/x-flv',\n  'video/x-matroska',\n  'video/x-ms-asf',\n  'video/x-ms-wmv',\n  'video/x-msvideo',\n  'video/x-mxf',\n])\n\n/**\n * Checks if a file is a video file supported by Mux\n * @param file - The file to check\n * @returns Promise that resolves to true if the file is a supported video format, false otherwise\n */\nexport async function isVideo(file: File): Promise<boolean> {\n  try {\n    const buffer = new Uint8Array(await file.arrayBuffer())\n    const fileType = await fileTypeFromBuffer(buffer)\n\n    return fileType?.mime\n      ? MUX_SUPPORTED_VIDEO_FORMATS.has(fileType.mime)\n      : false\n  } catch {\n    return false\n  }\n}\n\n/**\n * Gets the MIME type of a file using file-type library\n * @param file - The file to check\n * @returns Promise that resolves to the MIME type of the file or undefined if it cannot be determined\n */\nexport async function getFileType(file: File): Promise<string | undefined> {\n  try {\n    const buffer = new Uint8Array(await file.arrayBuffer())\n    const fileType = await fileTypeFromBuffer(buffer)\n    return fileType?.mime\n  } catch (_error) {\n    logError(MediaCloudErrors.FILE_TYPE_ERROR.message)\n    return undefined\n  }\n}\n\n/**\n * Generates a unique filename by appending a random suffix if needed\n * @param originalFilename - The original filename\n * @returns A unique filename with a random suffix appended before the extension\n */\nexport function generateUniqueFilename(originalFilename: string): string {\n  const timestamp = Date.now().toString(36)\n  const { name, ext } = parse(originalFilename)\n  return `${name}-${timestamp}${ext}`\n}\n\n/**\n * Sanitizes a filename by removing/replacing invalid characters and handling edge cases\n * Converts all non-alphanumeric characters (except dots for extensions) to underscores\n * @param filename - The filename to sanitize\n * @returns A sanitized filename safe for all operating systems\n * @throws {TypeError} When filename is not a string\n */\nexport function sanitizeFilename(filename: string): string {\n  try {\n    const parsed = parse(filename)\n    const sanitized = parsed.name\n      .replace(/[^a-zA-Z0-9_.-]/g, '_')\n      .replace(/_{2,}/g, '_')\n      .replace(/^_|_$/g, '')\n    return `${sanitized}${parsed.ext}`\n  } catch (_error) {\n    logError(MediaCloudErrors.FILENAME_SANITIZE_ERROR.message)\n    return filename\n  }\n}\n"],"mappings":";;;;;;AAMA,MAAM,EAAE,aAAa,iBAAiB;AAEtC,MAAM,8BAA8B,IAAI,IAAI;CAC1C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;AAOF,eAAsB,QAAQ,MAA8B;AAC1D,KAAI;EAEF,MAAM,WAAW,MAAM,mBADR,IAAI,WAAW,MAAM,KAAK,aAAa,CAAC,CACN;AAEjD,SAAO,UAAU,OACb,4BAA4B,IAAI,SAAS,KAAK,GAC9C;SACE;AACN,SAAO;;;;;;;;AASX,eAAsB,YAAY,MAAyC;AACzE,KAAI;AAGF,UADiB,MAAM,mBADR,IAAI,WAAW,MAAM,KAAK,aAAa,CAAC,CACN,GAChC;UACV,QAAQ;AACf,WAAS,iBAAiB,gBAAgB,QAAQ;AAClD;;;;;;;;AASJ,SAAgB,uBAAuB,kBAAkC;CACvE,MAAM,YAAY,KAAK,KAAK,CAAC,SAAS,GAAG;CACzC,MAAM,EAAE,MAAM,QAAQ,MAAM,iBAAiB;AAC7C,QAAO,GAAG,KAAK,GAAG,YAAY;;;;;;;;;AAUhC,SAAgB,iBAAiB,UAA0B;AACzD,KAAI;EACF,MAAM,SAAS,MAAM,SAAS;AAK9B,SAAO,GAJW,OAAO,KACtB,QAAQ,oBAAoB,IAAI,CAChC,QAAQ,UAAU,IAAI,CACtB,QAAQ,UAAU,GAAG,GACF,OAAO;UACtB,QAAQ;AACf,WAAS,iBAAiB,wBAAwB,QAAQ;AAC1D,SAAO"}
+{"version":3,"file":"file.mjs","names":["magicError: UseMagicErrorReturn"],"sources":["../../src/utils/file.ts"],"sourcesContent":["import { fileTypeFromBuffer } from 'file-type'\nimport { parse } from 'pathe'\n\nimport { getFileExistsHandler } from '../endpoints/fileExistsHandler'\nimport { MediaCloudErrors } from '../types/errors'\n\nimport { MediaCloudPluginOptions, MimeType } from '../types'\nimport { useMagicError, type UseMagicErrorReturn } from '@maas/error-handler'\n\nimport type { S3Store } from '../tus/stores/s3/s3Store'\n\nconst magicError: UseMagicErrorReturn = useMagicError({\n  prefix: 'PLUGIN-MEDIA-CLOUD',\n})\n\nconst { logError, throwError } = magicError\n\nconst MUX_SUPPORTED_VIDEO_FORMATS = new Set([\n  'application/mxf',\n  'video/3gpp',\n  'video/3gpp2',\n  'video/mp2t',\n  'video/mp4',\n  'video/mpeg',\n  'video/quicktime',\n  'video/webm',\n  'video/x-f4v',\n  'video/x-flv',\n  'video/x-matroska',\n  'video/x-ms-asf',\n  'video/x-ms-wmv',\n  'video/x-msvideo',\n  'video/x-mxf',\n])\n\n/**\n * Checks if a file is a video file supported by Mux\n * @param file - The file to check\n * @returns Promise that resolves to true if the file is a supported video format, false otherwise\n */\nexport async function isVideo(file: File): Promise<boolean> {\n  try {\n    const buffer = new Uint8Array(await file.arrayBuffer())\n    const fileType = await fileTypeFromBuffer(buffer)\n\n    return fileType?.mime\n      ? MUX_SUPPORTED_VIDEO_FORMATS.has(fileType.mime)\n      : false\n  } catch {\n    return false\n  }\n}\n\nconst allowedMimeTypes = new Set<MimeType>([\n  'application/mxf',\n  'video/3gpp',\n  'video/3gpp2',\n  'video/mp2t',\n  'video/mp4',\n  'video/mpeg',\n  'video/quicktime',\n  'video/webm',\n  'video/x-f4v',\n  'video/x-flv',\n  'video/x-matroska',\n  'video/x-ms-asf',\n  'video/x-ms-wmv',\n  'video/x-msvideo',\n  'video/x-mxf',\n  'image/apng',\n  'image/avif',\n  'image/gif',\n  'image/jpeg',\n  'image/png',\n  'image/svg+xml',\n  'image/webp',\n])\n\n/**\n * Check the mime type against allowed mime types\n * @param mimeType - The file to check\n */\nfunction validateMimeType(mimeType: string) {\n  if (!allowedMimeTypes.has(mimeType as MimeType)) {\n    throwError(MediaCloudErrors.FILE_TYPE_UNSUPPORTED_ERROR)\n  }\n}\n\n/**\n * Gets the MIME type of a file using file-type library\n * @param file - The file to check\n * @returns Promise that resolves to the MIME type of the file or undefined if it cannot be determined\n */\nexport async function getMimeType(file: File): Promise<MimeType | undefined> {\n  try {\n    const buffer = new Uint8Array(await file.arrayBuffer())\n    const fileType = await fileTypeFromBuffer(buffer)\n\n    if (!fileType?.mime) {\n      logError(MediaCloudErrors.FILE_TYPE_ERROR.message)\n      return undefined\n    }\n\n    validateMimeType(fileType.mime)\n    return fileType.mime as MimeType\n  } catch (_error) {\n    logError(MediaCloudErrors.FILE_TYPE_ERROR.message)\n    return undefined\n  }\n}\n\n/**\n * Generates a unique filename by appending a random suffix if needed\n * @param originalFilename - The original filename\n * @returns A unique filename with a random suffix appended before the extension\n */\nexport function generateUniqueFilename(originalFilename: string): string {\n  const timestamp = Date.now().toString(36)\n  // Parse name and extension\n  const { name, ext } = parse(originalFilename)\n\n  // Sanitize name\n  const sanitizedName = sanitizeFilename(name)\n\n  return `${sanitizedName}-${timestamp}${ext}`\n}\n\n/**\n * Sanitizes a filename by removing/replacing invalid characters and handling edge cases\n * Converts all non-alphanumeric characters (except dots for extensions) to underscores\n * @param filename - The filename to sanitize\n * @returns A sanitized filename safe for all operating systems\n * @throws {TypeError} When filename is not a string\n */\nexport function sanitizeFilename(filename: string): string {\n  try {\n    const parsed = parse(filename)\n    const sanitized = parsed.name\n      .replace(/[^a-zA-Z0-9_.-]/g, '_')\n      .replace(/_{2,}/g, '_')\n      .replace(/^_|_$/g, '')\n    return `${sanitized}${parsed.ext}`\n  } catch (_error) {\n    logError(MediaCloudErrors.FILENAME_SANITIZE_ERROR.message)\n    return filename\n  }\n}\n\ninterface CreateFileEndpointsArgs {\n  getS3Store: () => S3Store\n  pluginOptions: MediaCloudPluginOptions\n}\n\nexport function createFileEndpoints(args: CreateFileEndpointsArgs) {\n  const { getS3Store, pluginOptions } = args\n  const collection = pluginOptions.collection\n\n  magicError.assert(collection, MediaCloudErrors.COLLECTION_REQUIRED)\n\n  return [\n    {\n      handler: getFileExistsHandler({ getS3Store, collection }),\n      method: 'get' as const,\n      path: '/uploads/:filename/exists',\n    },\n  ]\n}\n"],"mappings":";;;;;;;AAWA,MAAMA,aAAkC,cAAc,EACpD,QAAQ,sBACT,CAAC;AAEF,MAAM,EAAE,UAAU,eAAe;AAEjC,MAAM,8BAA8B,IAAI,IAAI;CAC1C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;AAOF,eAAsB,QAAQ,MAA8B;AAC1D,KAAI;EAEF,MAAM,WAAW,MAAM,mBADR,IAAI,WAAW,MAAM,KAAK,aAAa,CAAC,CACN;AAEjD,SAAO,UAAU,OACb,4BAA4B,IAAI,SAAS,KAAK,GAC9C;SACE;AACN,SAAO;;;AAIX,MAAM,mBAAmB,IAAI,IAAc;CACzC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;AAMF,SAAS,iBAAiB,UAAkB;AAC1C,KAAI,CAAC,iBAAiB,IAAI,SAAqB,CAC7C,YAAW,iBAAiB,4BAA4B;;;;;;;AAS5D,eAAsB,YAAY,MAA2C;AAC3E,KAAI;EAEF,MAAM,WAAW,MAAM,mBADR,IAAI,WAAW,MAAM,KAAK,aAAa,CAAC,CACN;AAEjD,MAAI,CAAC,UAAU,MAAM;AACnB,YAAS,iBAAiB,gBAAgB,QAAQ;AAClD;;AAGF,mBAAiB,SAAS,KAAK;AAC/B,SAAO,SAAS;UACT,QAAQ;AACf,WAAS,iBAAiB,gBAAgB,QAAQ;AAClD;;;;;;;;AASJ,SAAgB,uBAAuB,kBAAkC;CACvE,MAAM,YAAY,KAAK,KAAK,CAAC,SAAS,GAAG;CAEzC,MAAM,EAAE,MAAM,QAAQ,MAAM,iBAAiB;AAK7C,QAAO,GAFe,iBAAiB,KAAK,CAEpB,GAAG,YAAY;;;;;;;;;AAUzC,SAAgB,iBAAiB,UAA0B;AACzD,KAAI;EACF,MAAM,SAAS,MAAM,SAAS;AAK9B,SAAO,GAJW,OAAO,KACtB,QAAQ,oBAAoB,IAAI,CAChC,QAAQ,UAAU,IAAI,CACtB,QAAQ,UAAU,GAAG,GACF,OAAO;UACtB,QAAQ;AACf,WAAS,iBAAiB,wBAAwB,QAAQ;AAC1D,SAAO;;;AASX,SAAgB,oBAAoB,MAA+B;CACjE,MAAM,EAAE,YAAY,kBAAkB;CACtC,MAAM,aAAa,cAAc;AAEjC,YAAW,OAAO,YAAY,iBAAiB,oBAAoB;AAEnE,QAAO,CACL;EACE,SAAS,qBAAqB;GAAE;GAAY;GAAY,CAAC;EACzD,QAAQ;EACR,MAAM;EACP,CACF"}

package/dist/utils/mux.mjs

@@ -1,17 +1,22 @@
 import { MediaCloudErrors } from "../types/errors.mjs";
-import { useErrorHandler } from "../hooks/useErrorHandler.mjs";
+import { useMagicError } from "../error-handler/dist/index.mjs";
 import { getMuxAssetHandler } from "../endpoints/muxAssetHandler.mjs";
 import { getMuxCreateUploadHandler } from "../endpoints/muxCreateUploadHandler.mjs";
 import { getMuxWebhookHandler } from "../endpoints/muxWebhookHandler.mjs";
 import Mux from "@mux/mux-node";
 
 //#region src/utils/mux.ts
-const { throwError } = useErrorHandler();
+const magicError = useMagicError({ prefix: "PLUGIN-MEDIA-CLOUD" });
 function createMuxEndpoints(args) {
 	const { getMuxClient, pluginOptions } = args;
+	const collection = pluginOptions.collection;
+	magicError.assert(collection, MediaCloudErrors.COLLECTION_REQUIRED);
 	return [
 		{
-			handler: getMuxWebhookHandler({ getMuxClient }),
+			handler: getMuxWebhookHandler({
+				getMuxClient,
+				collection
+			}),
 			method: "post",
 			path: "/mux/webhook"
 		},
@@ -24,7 +29,10 @@ function createMuxEndpoints(args) {
 			path: "/mux/upload"
 		},
 		{
-			handler: getMuxAssetHandler({ getMuxClient }),
+			handler: getMuxAssetHandler({
+				getMuxClient,
+				collection
+			}),
 			method: "get",
 			path: "/mux/asset"
 		}
@@ -36,7 +44,9 @@ function createMuxEndpoints(args) {
 * @throws {Error} When required Mux configuration is missing
 */
 function validateMuxConfig(muxConfig) {
-	if (!muxConfig?.tokenId || !muxConfig?.tokenSecret) throwError(MediaCloudErrors.MUX_CONFIG_MISSING);
+	magicError.assert(muxConfig, MediaCloudErrors.MUX_CONFIG_INCOMPLETE);
+	magicError.assert(muxConfig?.tokenId, MediaCloudErrors.MUX_CONFIG_MISSING);
+	magicError.assert(muxConfig?.tokenSecret, MediaCloudErrors.MUX_CONFIG_MISSING);
 }
 /**
 * Creates a new Mux client instance
@@ -44,10 +54,11 @@ function validateMuxConfig(muxConfig) {
 * @returns A configured Mux client
 */
 function createMuxClient(muxConfig) {
+	validateMuxConfig(muxConfig);
 	return new Mux({
-		tokenId: muxConfig.tokenId,
-		tokenSecret: muxConfig.tokenSecret,
-		webhookSecret: muxConfig.webhookSecret
+		tokenId: muxConfig?.tokenId,
+		tokenSecret: muxConfig?.tokenSecret,
+		webhookSecret: muxConfig?.webhookSecret
 	});
 }
 

package/dist/utils/mux.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mux.mjs","names":[],"sources":["../../src/utils/mux.ts"],"sourcesContent":["import Mux from '@mux/mux-node'\n\nimport { MediaCloudErrors } from '../types/errors'\nimport { useErrorHandler } from '../hooks/useErrorHandler'\nimport { getMuxAssetHandler } from '../endpoints/muxAssetHandler'\nimport { getMuxCreateUploadHandler } from '../endpoints/muxCreateUploadHandler'\nimport { getMuxWebhookHandler } from '../endpoints/muxWebhookHandler'\n\nimport type { MediaCloudPluginOptions } from '../types'\n\nconst { throwError } = useErrorHandler()\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 */\ninterface CreateMuxEndpointsArgs {\n  getMuxClient: () => Mux\n  pluginOptions: MediaCloudPluginOptions\n}\n\nexport function createMuxEndpoints(args: CreateMuxEndpointsArgs) {\n  const { getMuxClient, pluginOptions } = args\n  return [\n    {\n      handler: getMuxWebhookHandler({ getMuxClient }),\n      method: 'post' 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 * Validates Mux configuration options\n * @param muxConfig - The Mux configuration to validate\n * @throws {Error} When required Mux configuration is missing\n */\nexport function validateMuxConfig(\n  muxConfig: MediaCloudPluginOptions['mux']\n): 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 */\nexport function createMuxClient(\n  muxConfig: MediaCloudPluginOptions['mux']\n): 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"],"mappings":";;;;;;;;AAUA,MAAM,EAAE,eAAe,iBAAiB;AAYxC,SAAgB,mBAAmB,MAA8B;CAC/D,MAAM,EAAE,cAAc,kBAAkB;AACxC,QAAO;EACL;GACE,SAAS,qBAAqB,EAAE,cAAc,CAAC;GAC/C,QAAQ;GACR,MAAM;GACP;EACD;GACE,SAAS,0BAA0B;IAAE;IAAc;IAAe,CAAC;GACnE,QAAQ;GACR,MAAM;GACP;EACD;GACE,SAAS,mBAAmB,EAAE,cAAc,CAAC;GAC7C,QAAQ;GACR,MAAM;GACP;EACF;;;;;;;AAQH,SAAgB,kBACd,WACM;AACN,KAAI,CAAC,WAAW,WAAW,CAAC,WAAW,YACrC,YAAW,iBAAiB,mBAAmB;;;;;;;AASnD,SAAgB,gBACd,WACK;AAEL,QAAO,IAAI,IAAI;EACb,SAAS,UAAU;EACnB,aAAa,UAAU;EACvB,eAAe,UAAU;EAC1B,CAAC"}
+{"version":3,"file":"mux.mjs","names":["magicError: UseMagicErrorReturn"],"sources":["../../src/utils/mux.ts"],"sourcesContent":["import Mux from '@mux/mux-node'\n\nimport { MediaCloudErrors } from '../types/errors'\nimport { getMuxAssetHandler } from '../endpoints/muxAssetHandler'\nimport { getMuxCreateUploadHandler } from '../endpoints/muxCreateUploadHandler'\nimport { getMuxWebhookHandler } from '../endpoints/muxWebhookHandler'\nimport { useMagicError } from '@maas/error-handler'\n\nimport type { MediaCloudPluginOptions } from '../types'\nimport type { UseMagicErrorReturn } from '@maas/error-handler'\n\nconst magicError: UseMagicErrorReturn = useMagicError({\n  prefix: 'PLUGIN-MEDIA-CLOUD',\n})\n\n/**\n * 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 */\ninterface CreateMuxEndpointsArgs {\n  getMuxClient: () => Mux\n  pluginOptions: MediaCloudPluginOptions\n}\n\nexport function createMuxEndpoints(args: CreateMuxEndpointsArgs) {\n  const { getMuxClient, pluginOptions } = args\n\n  const collection = pluginOptions.collection\n\n  magicError.assert(collection, MediaCloudErrors.COLLECTION_REQUIRED)\n\n  return [\n    {\n      handler: getMuxWebhookHandler({ getMuxClient, collection }),\n      method: 'post' 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, collection }),\n      method: 'get' as const,\n      path: '/mux/asset',\n    },\n  ]\n}\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 */\nexport function validateMuxConfig(\n  muxConfig: MediaCloudPluginOptions['mux']\n): void {\n  magicError.assert(muxConfig, MediaCloudErrors.MUX_CONFIG_INCOMPLETE)\n  magicError.assert(muxConfig?.tokenId, MediaCloudErrors.MUX_CONFIG_MISSING)\n  magicError.assert(muxConfig?.tokenSecret, MediaCloudErrors.MUX_CONFIG_MISSING)\n}\n\n/**\n * Creates a new Mux client instance\n * @param muxConfig - The Mux configuration options\n * @returns A configured Mux client\n */\nexport function createMuxClient(\n  muxConfig: MediaCloudPluginOptions['mux']\n): Mux {\n  validateMuxConfig(muxConfig)\n\n  return new Mux({\n    tokenId: muxConfig?.tokenId,\n    tokenSecret: muxConfig?.tokenSecret,\n    webhookSecret: muxConfig?.webhookSecret,\n  })\n}\n"],"mappings":";;;;;;;;AAWA,MAAMA,aAAkC,cAAc,EACpD,QAAQ,sBACT,CAAC;AAYF,SAAgB,mBAAmB,MAA8B;CAC/D,MAAM,EAAE,cAAc,kBAAkB;CAExC,MAAM,aAAa,cAAc;AAEjC,YAAW,OAAO,YAAY,iBAAiB,oBAAoB;AAEnE,QAAO;EACL;GACE,SAAS,qBAAqB;IAAE;IAAc;IAAY,CAAC;GAC3D,QAAQ;GACR,MAAM;GACP;EACD;GACE,SAAS,0BAA0B;IAAE;IAAc;IAAe,CAAC;GACnE,QAAQ;GACR,MAAM;GACP;EACD;GACE,SAAS,mBAAmB;IAAE;IAAc;IAAY,CAAC;GACzD,QAAQ;GACR,MAAM;GACP;EACF;;;;;;;AAQH,SAAgB,kBACd,WACM;AACN,YAAW,OAAO,WAAW,iBAAiB,sBAAsB;AACpE,YAAW,OAAO,WAAW,SAAS,iBAAiB,mBAAmB;AAC1E,YAAW,OAAO,WAAW,aAAa,iBAAiB,mBAAmB;;;;;;;AAQhF,SAAgB,gBACd,WACK;AACL,mBAAkB,UAAU;AAE5B,QAAO,IAAI,IAAI;EACb,SAAS,WAAW;EACpB,aAAa,WAAW;EACxB,eAAe,WAAW;EAC3B,CAAC"}