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

package/dist/fields/thumbnail.d.mts

@@ -0,0 +1,7 @@
+import { TextField } from "payload";
+
+//#region src/fields/thumbnail.d.ts
+declare const thumbnailField: TextField;
+//#endregion
+export { thumbnailField };
+//# sourceMappingURL=thumbnail.d.mts.map

package/dist/fields/thumbnail.mjs

@@ -0,0 +1,17 @@
+//#region src/fields/thumbnail.ts
+const thumbnailField = {
+	type: "text",
+	name: "thumbnail",
+	admin: {
+		readOnly: true,
+		hidden: true,
+		disableListColumn: true,
+		disableListFilter: true,
+		disableBulkEdit: true,
+		disableGroupBy: true
+	}
+};
+
+//#endregion
+export { thumbnailField };
+//# sourceMappingURL=thumbnail.mjs.map

package/dist/fields/thumbnail.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"thumbnail.mjs","names":["thumbnailField: TextField"],"sources":["../../src/fields/thumbnail.ts"],"sourcesContent":["import { TextField } from 'payload'\n\nexport const thumbnailField: TextField = {\n  type: 'text',\n  name: 'thumbnail',\n  admin: {\n    readOnly: true,\n    hidden: true,\n    disableListColumn: true,\n    disableListFilter: true,\n    disableBulkEdit: true,\n    disableGroupBy: true,\n  },\n}\n"],"mappings":";AAEA,MAAaA,iBAA4B;CACvC,MAAM;CACN,MAAM;CACN,OAAO;EACL,UAAU;EACV,QAAQ;EACR,mBAAmB;EACnB,mBAAmB;EACnB,iBAAiB;EACjB,gBAAgB;EACjB;CACF"}

package/dist/fields/width.d.mts

@@ -0,0 +1,7 @@
+import { TextField } from "payload";
+
+//#region src/fields/width.d.ts
+declare const widthField: TextField;
+//#endregion
+export { widthField };
+//# sourceMappingURL=width.d.mts.map

package/dist/fields/width.mjs

@@ -0,0 +1,15 @@
+//#region src/fields/width.ts
+const widthField = {
+	name: "width",
+	label: "Width",
+	type: "text",
+	admin: {
+		readOnly: true,
+		hidden: false,
+		width: "50%"
+	}
+};
+
+//#endregion
+export { widthField };
+//# sourceMappingURL=width.mjs.map

package/dist/fields/width.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"width.mjs","names":["widthField: TextField"],"sources":["../../src/fields/width.ts"],"sourcesContent":["import type { TextField } from 'payload'\n\nexport const widthField: TextField = {\n  name: 'width',\n  label: 'Width',\n  type: 'text',\n  admin: {\n    readOnly: true,\n    hidden: false,\n    width: '50%',\n  },\n}\n"],"mappings":";AAEA,MAAaA,aAAwB;CACnC,MAAM;CACN,OAAO;CACP,MAAM;CACN,OAAO;EACL,UAAU;EACV,QAAQ;EACR,OAAO;EACR;CACF"}

package/dist/hooks/useErrorHandler.d.mts

@@ -1,7 +1,7 @@
 import { UseMagicErrorReturn } from "@maas/error-handler";
 
 //#region src/hooks/useErrorHandler.d.ts
-declare function useErrorHandler(): Omit<UseMagicErrorReturn, 'assert' | 'MagicError'>;
+declare function useErrorHandler(): Omit<UseMagicErrorReturn, 'MagicError'>;
 //#endregion
 export { useErrorHandler };
 //# sourceMappingURL=useErrorHandler.d.mts.map

package/dist/hooks/useErrorHandler.mjs

@@ -2,12 +2,14 @@ import { useMagicError } from "../error-handler/dist/index.mjs";
 
 //#region src/hooks/useErrorHandler.ts
 function useErrorHandler() {
-	const { log, logError, throwError, logWarning } = useMagicError({ prefix: "PLUGIN-MEDIA-CLOUD" });
+	const magicError = useMagicError({ prefix: "PLUGIN-MEDIA-CLOUD" });
+	const { log, logError, throwError, logWarning } = magicError;
 	return {
 		log,
 		logError,
 		throwError,
-		logWarning
+		logWarning,
+		assert: magicError.assert
 	};
 }
 

package/dist/hooks/useErrorHandler.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useErrorHandler.mjs","names":[],"sources":["../../src/hooks/useErrorHandler.ts"],"sourcesContent":["import { useMagicError, type UseMagicErrorReturn } from '@maas/error-handler'\n\nexport function useErrorHandler(): Omit<\n  UseMagicErrorReturn,\n  'assert' | 'MagicError'\n> {\n  const { log, logError, throwError, logWarning } = useMagicError({\n    prefix: 'PLUGIN-MEDIA-CLOUD',\n  })\n\n  return {\n    log,\n    logError,\n    throwError,\n    logWarning,\n  }\n}\n"],"mappings":";;;AAEA,SAAgB,kBAGd;CACA,MAAM,EAAE,KAAK,UAAU,YAAY,eAAe,cAAc,EAC9D,QAAQ,sBACT,CAAC;AAEF,QAAO;EACL;EACA;EACA;EACA;EACD"}
+{"version":3,"file":"useErrorHandler.mjs","names":["magicError: UseMagicErrorReturn"],"sources":["../../src/hooks/useErrorHandler.ts"],"sourcesContent":["import { useMagicError, type UseMagicErrorReturn } from '@maas/error-handler'\n\nexport function useErrorHandler(): Omit<UseMagicErrorReturn, 'MagicError'> {\n  const magicError: UseMagicErrorReturn = useMagicError({\n    prefix: 'PLUGIN-MEDIA-CLOUD',\n  })\n\n  const { log, logError, throwError, logWarning } = magicError\n\n  return {\n    log,\n    logError,\n    throwError,\n    logWarning,\n    assert: magicError.assert,\n  }\n}\n"],"mappings":";;;AAEA,SAAgB,kBAA2D;CACzE,MAAMA,aAAkC,cAAc,EACpD,QAAQ,sBACT,CAAC;CAEF,MAAM,EAAE,KAAK,UAAU,YAAY,eAAe;AAElD,QAAO;EACL;EACA;EACA;EACA;EACA,QAAQ,WAAW;EACpB"}

package/dist/plugin.d.mts

@@ -1,14 +1,15 @@
 import { MediaCloudPluginOptions } from "./types/index.mjs";
+import { S3Store } from "./tus/stores/s3/s3Store.mjs";
 import { Config } from "payload";
 
 //#region src/plugin.d.ts
-
+declare let s3Store: S3Store | null;
 /**
  * Media Cloud Plugin for Payload CMS
- * @param pluginOptions Configuration options
+ * @param options Configuration options
  * @returns Payload config function
  */
-declare function mediaCloudPlugin(pluginOptions: MediaCloudPluginOptions): (config: Config) => Config;
+declare function mediaCloudPlugin(options: MediaCloudPluginOptions): (config: Config) => Config;
 //#endregion
-export { mediaCloudPlugin };
+export { mediaCloudPlugin, s3Store };
 //# sourceMappingURL=plugin.d.mts.map

package/dist/plugin.mjs

@@ -3,73 +3,92 @@ import { useErrorHandler } from "./hooks/useErrorHandler.mjs";
 import { getStorageAdapter } from "./adapter/storageAdapter.mjs";
 import { getMediaCollection } from "./collections/mediaCollection.mjs";
 import { createS3Store } from "./tus/stores/s3/index.mjs";
-import { createMuxClient, createMuxEndpoints, validateMuxConfig } from "./utils/mux.mjs";
+import { createMuxClient, createMuxEndpoints } from "./utils/mux.mjs";
+import { createFileEndpoints } from "./utils/file.mjs";
 import { createTusEndpoints, createTusServer } from "./utils/tus.mjs";
+import { defaultOptions } from "./utils/defaultOptions.mjs";
+import { defu } from "defu";
 import { cloudStoragePlugin } from "@payloadcms/plugin-cloud-storage";
 import { initClientUploads } from "@payloadcms/plugin-cloud-storage/utilities";
 
 //#region src/plugin.ts
 const { logError } = useErrorHandler();
 let muxClient = null;
+let s3Store = null;
+let tusServer = null;
 /**
 * Media Cloud Plugin for Payload CMS
-* @param pluginOptions Configuration options
+* @param options Configuration options
 * @returns Payload config function
 */
-function mediaCloudPlugin(pluginOptions) {
+function mediaCloudPlugin(options) {
 	return function(config) {
-		if (!pluginOptions) {
+		if (!options) {
 			logError(MediaCloudErrors.PLUGIN_NOT_CONFIGURED.message);
 			return config;
 		}
+		const pluginOptions = defu(options, defaultOptions);
 		if (pluginOptions.enabled === false) return config;
 		/**
 		* Helper function to get or create Mux client instance
 		* @returns Mux client instance
 		*/
 		function getMuxClient() {
-			if (muxClient) return muxClient;
-			return createMuxClient(pluginOptions.mux);
+			return muxClient ?? createMuxClient(pluginOptions.mux);
 		}
-		if (pluginOptions.mux) {
-			validateMuxConfig(pluginOptions.mux);
-			muxClient = getMuxClient();
-		} else {
-			logError(MediaCloudErrors.MUX_CONFIG_INCOMPLETE.message);
-			muxClient = null;
+		/**
+		* Helper function to get or create S3 store instance
+		* @returns S3 store instance
+		*/
+		function getS3Store() {
+			return s3Store ?? createS3Store(pluginOptions.s3);
+		}
+		/**
+		* Helper function to get or create tus server instance
+		* @returns TUS server instance
+		*/
+		function getTusServer() {
+			return tusServer ?? createTusServer({
+				getS3Store,
+				pluginOptions
+			});
+		}
+		if (pluginOptions.mux) muxClient = getMuxClient();
+		if (pluginOptions.s3) {
+			s3Store = getS3Store();
+			tusServer = getTusServer();
 		}
-		const s3Store = createS3Store(pluginOptions.s3);
-		const tusServer = createTusServer({
-			s3Store,
-			pluginOptions
-		});
 		const baseCollection = config.collections?.find(({ slug }) => slug === pluginOptions.collection);
+		const { view, folders } = pluginOptions;
 		const mediaCollection = getMediaCollection({
-			s3Store,
-			baseCollection
+			baseCollection,
+			view,
+			folders
 		});
 		if (baseCollection) config = {
 			...config,
-			collections: config.collections?.filter(({ slug }) => slug !== baseCollection?.slug) || []
+			collections: config.collections?.filter(({ slug }) => slug !== baseCollection?.slug) ?? []
 		};
 		initClientUploads({
+			config,
+			enabled: true,
 			clientHandler: "@maas/payload-plugin-media-cloud/components#UploadHandler",
-			collections: { media: {
+			collections: { [mediaCollection.slug]: {
 				clientUploads: true,
-				disableLocalStorage: true
+				disableLocalStorage: true,
+				prefix: pluginOptions.s3?.prefix ?? ""
 			} },
-			config,
-			enabled: true,
+			extraClientHandlerProps: () => ({ pluginOptions }),
 			serverHandler: () => {
 				return Response.json({ message: "Server handler is not implemented" }, { status: 501 });
 			},
 			serverHandlerPath: "/media-cloud/upload"
 		});
-		const cloudStorageConfig = { collections: { media: {
+		const cloudStorageConfig = { collections: { [mediaCollection.slug]: {
 			adapter: getStorageAdapter({
 				getMuxClient,
 				pluginOptions,
-				s3Store
+				getS3Store
 			}),
 			clientUploads: true,
 			disableLocalStorage: true
@@ -87,12 +106,17 @@ function mediaCloudPlugin(pluginOptions) {
 			endpoints: [
 				...config.endpoints ?? [],
 				...createTusEndpoints({
-					tusServer,
-					s3Store
+					getTusServer,
+					getS3Store,
+					pluginOptions
 				}),
 				...createMuxEndpoints({
 					getMuxClient,
 					pluginOptions
+				}),
+				...createFileEndpoints({
+					getS3Store,
+					pluginOptions
 				})
 			]
 		};
@@ -101,5 +125,5 @@ function mediaCloudPlugin(pluginOptions) {
 }
 
 //#endregion
-export { mediaCloudPlugin };
+export { mediaCloudPlugin, s3Store };
 //# sourceMappingURL=plugin.mjs.map

package/dist/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":["muxClient: Mux | null","mergedConfig: Config"],"sources":["../src/plugin.ts"],"sourcesContent":["import Mux from '@mux/mux-node'\nimport { cloudStoragePlugin } from '@payloadcms/plugin-cloud-storage'\nimport { initClientUploads } from '@payloadcms/plugin-cloud-storage/utilities'\n\nimport { MediaCloudErrors } from './types/errors'\nimport { getStorageAdapter } from './adapter/storageAdapter'\nimport { getMediaCollection } from './collections/mediaCollection'\nimport { useErrorHandler } from './hooks/useErrorHandler'\nimport { createS3Store } from './tus/stores/s3'\nimport {\n  createMuxClient,\n  createMuxEndpoints,\n  validateMuxConfig,\n} from './utils/mux'\nimport { createTusEndpoints, createTusServer } from './utils/tus'\n\nimport type { Config } from 'payload'\nimport type { MediaCloudPluginOptions } from './types'\n\nconst { logError } = useErrorHandler()\n\nlet muxClient: Mux | null = null\n\n/**\n * Media Cloud Plugin for Payload CMS\n * @param pluginOptions Configuration options\n * @returns Payload config function\n */\nexport function mediaCloudPlugin(pluginOptions: MediaCloudPluginOptions) {\n  return function (config: Config): Config {\n    // Early returns for invalid or disabled plugin configuration\n    if (!pluginOptions) {\n      logError(MediaCloudErrors.PLUGIN_NOT_CONFIGURED.message)\n      return config\n    }\n\n    if (pluginOptions.enabled === false) {\n      return config\n    }\n\n    /**\n     * Helper function to get or create Mux client instance\n     * @returns Mux client instance\n     */\n    function getMuxClient(): Mux {\n      if (muxClient) {\n        return muxClient\n      }\n      return createMuxClient(pluginOptions.mux)\n    }\n\n    // Initialize Mux client if configuration is provided\n    if (pluginOptions.mux) {\n      validateMuxConfig(pluginOptions.mux)\n      muxClient = getMuxClient()\n    } else {\n      logError(MediaCloudErrors.MUX_CONFIG_INCOMPLETE.message)\n      muxClient = null\n    }\n\n    const s3Store = createS3Store(pluginOptions.s3)\n    const tusServer = createTusServer({ s3Store, pluginOptions })\n\n    // Handle collection extension - replace base collection if it exists\n    const baseCollection = config.collections?.find(\n      ({ slug }) => slug === pluginOptions.collection\n    )\n\n    const mediaCollection = getMediaCollection({\n      s3Store,\n      baseCollection,\n    })\n\n    if (baseCollection) {\n      config = {\n        ...config,\n        collections:\n          config.collections?.filter(\n            ({ slug }) => slug !== baseCollection?.slug\n          ) || [],\n      }\n    }\n\n    initClientUploads({\n      clientHandler:\n        '@maas/payload-plugin-media-cloud/components#UploadHandler',\n      collections: {\n        media: {\n          clientUploads: true,\n          disableLocalStorage: true,\n        },\n      },\n      config,\n      enabled: true,\n      serverHandler: () => {\n        return Response.json(\n          { message: 'Server handler is not implemented' },\n          { status: 501 }\n        )\n      },\n      serverHandlerPath: '/media-cloud/upload',\n    })\n\n    const cloudStorageConfig = {\n      collections: {\n        media: {\n          adapter: getStorageAdapter({ getMuxClient, pluginOptions, s3Store }),\n          clientUploads: true,\n          disableLocalStorage: true,\n        },\n      },\n    }\n\n    const mergedConfig: Config = {\n      ...config,\n      admin: {\n        ...config.admin,\n        components: {\n          ...config.admin?.components,\n          providers: [\n            ...(config.admin?.components?.providers ?? []),\n            '@maas/payload-plugin-media-cloud/components#UploadManagerProvider',\n          ],\n        },\n      },\n      collections: [...(config.collections ?? []), mediaCollection],\n      endpoints: [\n        ...(config.endpoints ?? []),\n        ...createTusEndpoints({ tusServer, s3Store }),\n        ...createMuxEndpoints({ getMuxClient, pluginOptions }),\n      ],\n    }\n\n    return cloudStoragePlugin(cloudStorageConfig)(mergedConfig)\n  }\n}\n"],"mappings":";;;;;;;;;;;AAmBA,MAAM,EAAE,aAAa,iBAAiB;AAEtC,IAAIA,YAAwB;;;;;;AAO5B,SAAgB,iBAAiB,eAAwC;AACvE,QAAO,SAAU,QAAwB;AAEvC,MAAI,CAAC,eAAe;AAClB,YAAS,iBAAiB,sBAAsB,QAAQ;AACxD,UAAO;;AAGT,MAAI,cAAc,YAAY,MAC5B,QAAO;;;;;EAOT,SAAS,eAAoB;AAC3B,OAAI,UACF,QAAO;AAET,UAAO,gBAAgB,cAAc,IAAI;;AAI3C,MAAI,cAAc,KAAK;AACrB,qBAAkB,cAAc,IAAI;AACpC,eAAY,cAAc;SACrB;AACL,YAAS,iBAAiB,sBAAsB,QAAQ;AACxD,eAAY;;EAGd,MAAM,UAAU,cAAc,cAAc,GAAG;EAC/C,MAAM,YAAY,gBAAgB;GAAE;GAAS;GAAe,CAAC;EAG7D,MAAM,iBAAiB,OAAO,aAAa,MACxC,EAAE,WAAW,SAAS,cAAc,WACtC;EAED,MAAM,kBAAkB,mBAAmB;GACzC;GACA;GACD,CAAC;AAEF,MAAI,eACF,UAAS;GACP,GAAG;GACH,aACE,OAAO,aAAa,QACjB,EAAE,WAAW,SAAS,gBAAgB,KACxC,IAAI,EAAE;GACV;AAGH,oBAAkB;GAChB,eACE;GACF,aAAa,EACX,OAAO;IACL,eAAe;IACf,qBAAqB;IACtB,EACF;GACD;GACA,SAAS;GACT,qBAAqB;AACnB,WAAO,SAAS,KACd,EAAE,SAAS,qCAAqC,EAChD,EAAE,QAAQ,KAAK,CAChB;;GAEH,mBAAmB;GACpB,CAAC;EAEF,MAAM,qBAAqB,EACzB,aAAa,EACX,OAAO;GACL,SAAS,kBAAkB;IAAE;IAAc;IAAe;IAAS,CAAC;GACpE,eAAe;GACf,qBAAqB;GACtB,EACF,EACF;EAED,MAAMC,eAAuB;GAC3B,GAAG;GACH,OAAO;IACL,GAAG,OAAO;IACV,YAAY;KACV,GAAG,OAAO,OAAO;KACjB,WAAW,CACT,GAAI,OAAO,OAAO,YAAY,aAAa,EAAE,EAC7C,oEACD;KACF;IACF;GACD,aAAa,CAAC,GAAI,OAAO,eAAe,EAAE,EAAG,gBAAgB;GAC7D,WAAW;IACT,GAAI,OAAO,aAAa,EAAE;IAC1B,GAAG,mBAAmB;KAAE;KAAW;KAAS,CAAC;IAC7C,GAAG,mBAAmB;KAAE;KAAc;KAAe,CAAC;IACvD;GACF;AAED,SAAO,mBAAmB,mBAAmB,CAAC,aAAa"}
+{"version":3,"file":"plugin.mjs","names":["muxClient: Mux | null","s3Store: S3Store | null","tusServer: Server | null","mergedConfig: Config"],"sources":["../src/plugin.ts"],"sourcesContent":["import Mux from '@mux/mux-node'\nimport { defu } from 'defu'\nimport { cloudStoragePlugin } from '@payloadcms/plugin-cloud-storage'\nimport { initClientUploads } from '@payloadcms/plugin-cloud-storage/utilities'\n\nimport { MediaCloudErrors } from './types/errors'\nimport { getStorageAdapter } from './adapter/storageAdapter'\nimport { getMediaCollection } from './collections/mediaCollection'\nimport { useErrorHandler } from './hooks/useErrorHandler'\nimport { createS3Store } from './tus/stores/s3'\nimport { createMuxClient, createMuxEndpoints } from './utils/mux'\nimport { createTusEndpoints, createTusServer } from './utils/tus'\nimport { createFileEndpoints } from './utils/file'\nimport { defaultOptions } from './utils/defaultOptions'\n\nimport type { Config } from 'payload'\nimport type { Server } from '@tus/server'\nimport type { MediaCloudPluginOptions } from './types'\nimport type { S3Store } from './tus/stores/s3/s3Store'\n\nconst { logError } = useErrorHandler()\n\nlet muxClient: Mux | null = null\nlet s3Store: S3Store | null = null\nlet tusServer: Server | null = null\n\n/**\n * Media Cloud Plugin for Payload CMS\n * @param options Configuration options\n * @returns Payload config function\n */\nexport function mediaCloudPlugin(options: MediaCloudPluginOptions) {\n  return function (config: Config): Config {\n    // Check if config is invalid or disabled\n    if (!options) {\n      logError(MediaCloudErrors.PLUGIN_NOT_CONFIGURED.message)\n      return config\n    }\n\n    // Merge user options with default options\n    const pluginOptions = defu(options, defaultOptions)\n\n    // Check if the plugin is disabled\n    if (pluginOptions.enabled === false) {\n      return config\n    }\n\n    /**\n     * Helper function to get or create Mux client instance\n     * @returns Mux client instance\n     */\n    function getMuxClient(): Mux {\n      return muxClient ?? createMuxClient(pluginOptions.mux)\n    }\n\n    /**\n     * Helper function to get or create S3 store instance\n     * @returns S3 store instance\n     */\n    function getS3Store(): S3Store {\n      return s3Store ?? createS3Store(pluginOptions.s3)\n    }\n\n    /**\n     * Helper function to get or create tus server instance\n     * @returns TUS server instance\n     */\n    function getTusServer(): Server {\n      return tusServer ?? createTusServer({ getS3Store, pluginOptions })\n    }\n\n    // Initialize Mux client if configuration is provided\n    if (pluginOptions.mux) {\n      muxClient = getMuxClient()\n    }\n\n    // Initialize S3 store and TUS server if configuration is provided\n    if (pluginOptions.s3) {\n      s3Store = getS3Store()\n      tusServer = getTusServer()\n    }\n\n    // Check if base collection exists\n    const baseCollection = config.collections?.find(\n      ({ slug }) => slug === pluginOptions.collection\n    )\n\n    const { view, folders } = pluginOptions\n\n    const mediaCollection = getMediaCollection({\n      baseCollection,\n      view,\n      folders,\n    })\n\n    // Remove base collection\n    // It’ll be replaced with the merged media collection\n    if (baseCollection) {\n      config = {\n        ...config,\n        collections:\n          config.collections?.filter(\n            ({ slug }) => slug !== baseCollection?.slug\n          ) ?? [],\n      }\n    }\n\n    initClientUploads({\n      config,\n      enabled: true,\n      clientHandler:\n        '@maas/payload-plugin-media-cloud/components#UploadHandler',\n      collections: {\n        [mediaCollection.slug]: {\n          clientUploads: true,\n          disableLocalStorage: true,\n          prefix: pluginOptions.s3?.prefix ?? '',\n        },\n      },\n      extraClientHandlerProps: () => ({\n        pluginOptions,\n      }),\n      serverHandler: () => {\n        return Response.json(\n          { message: 'Server handler is not implemented' },\n          { status: 501 }\n        )\n      },\n      serverHandlerPath: '/media-cloud/upload',\n    })\n\n    const cloudStorageConfig = {\n      collections: {\n        [mediaCollection.slug]: {\n          adapter: getStorageAdapter({\n            getMuxClient,\n            pluginOptions,\n            getS3Store,\n          }),\n          clientUploads: true,\n          disableLocalStorage: true,\n        },\n      },\n    }\n\n    const mergedConfig: Config = {\n      ...config,\n      admin: {\n        ...config.admin,\n        components: {\n          ...config.admin?.components,\n          providers: [\n            ...(config.admin?.components?.providers ?? []),\n            '@maas/payload-plugin-media-cloud/components#UploadManagerProvider',\n          ],\n        },\n      },\n      collections: [...(config.collections ?? []), mediaCollection],\n      endpoints: [\n        ...(config.endpoints ?? []),\n        ...createTusEndpoints({ getTusServer, getS3Store, pluginOptions }),\n        ...createMuxEndpoints({ getMuxClient, pluginOptions }),\n        ...createFileEndpoints({ getS3Store, pluginOptions }),\n      ],\n    }\n\n    return cloudStoragePlugin(cloudStorageConfig)(mergedConfig)\n  }\n}\n\nexport { s3Store }\n"],"mappings":";;;;;;;;;;;;;;AAoBA,MAAM,EAAE,aAAa,iBAAiB;AAEtC,IAAIA,YAAwB;AAC5B,IAAIC,UAA0B;AAC9B,IAAIC,YAA2B;;;;;;AAO/B,SAAgB,iBAAiB,SAAkC;AACjE,QAAO,SAAU,QAAwB;AAEvC,MAAI,CAAC,SAAS;AACZ,YAAS,iBAAiB,sBAAsB,QAAQ;AACxD,UAAO;;EAIT,MAAM,gBAAgB,KAAK,SAAS,eAAe;AAGnD,MAAI,cAAc,YAAY,MAC5B,QAAO;;;;;EAOT,SAAS,eAAoB;AAC3B,UAAO,aAAa,gBAAgB,cAAc,IAAI;;;;;;EAOxD,SAAS,aAAsB;AAC7B,UAAO,WAAW,cAAc,cAAc,GAAG;;;;;;EAOnD,SAAS,eAAuB;AAC9B,UAAO,aAAa,gBAAgB;IAAE;IAAY;IAAe,CAAC;;AAIpE,MAAI,cAAc,IAChB,aAAY,cAAc;AAI5B,MAAI,cAAc,IAAI;AACpB,aAAU,YAAY;AACtB,eAAY,cAAc;;EAI5B,MAAM,iBAAiB,OAAO,aAAa,MACxC,EAAE,WAAW,SAAS,cAAc,WACtC;EAED,MAAM,EAAE,MAAM,YAAY;EAE1B,MAAM,kBAAkB,mBAAmB;GACzC;GACA;GACA;GACD,CAAC;AAIF,MAAI,eACF,UAAS;GACP,GAAG;GACH,aACE,OAAO,aAAa,QACjB,EAAE,WAAW,SAAS,gBAAgB,KACxC,IAAI,EAAE;GACV;AAGH,oBAAkB;GAChB;GACA,SAAS;GACT,eACE;GACF,aAAa,GACV,gBAAgB,OAAO;IACtB,eAAe;IACf,qBAAqB;IACrB,QAAQ,cAAc,IAAI,UAAU;IACrC,EACF;GACD,gCAAgC,EAC9B,eACD;GACD,qBAAqB;AACnB,WAAO,SAAS,KACd,EAAE,SAAS,qCAAqC,EAChD,EAAE,QAAQ,KAAK,CAChB;;GAEH,mBAAmB;GACpB,CAAC;EAEF,MAAM,qBAAqB,EACzB,aAAa,GACV,gBAAgB,OAAO;GACtB,SAAS,kBAAkB;IACzB;IACA;IACA;IACD,CAAC;GACF,eAAe;GACf,qBAAqB;GACtB,EACF,EACF;EAED,MAAMC,eAAuB;GAC3B,GAAG;GACH,OAAO;IACL,GAAG,OAAO;IACV,YAAY;KACV,GAAG,OAAO,OAAO;KACjB,WAAW,CACT,GAAI,OAAO,OAAO,YAAY,aAAa,EAAE,EAC7C,oEACD;KACF;IACF;GACD,aAAa,CAAC,GAAI,OAAO,eAAe,EAAE,EAAG,gBAAgB;GAC7D,WAAW;IACT,GAAI,OAAO,aAAa,EAAE;IAC1B,GAAG,mBAAmB;KAAE;KAAc;KAAY;KAAe,CAAC;IAClE,GAAG,mBAAmB;KAAE;KAAc;KAAe,CAAC;IACtD,GAAG,oBAAoB;KAAE;KAAY;KAAe,CAAC;IACtD;GACF;AAED,SAAO,mBAAmB,mBAAmB,CAAC,aAAa"}

package/dist/tus/stores/s3/{expiration-manager.d.mts → expirationManager.d.mts}

@@ -1,6 +1,7 @@
+import { S3MetadataManager } from "./metadataManager.mjs";
 import { S3 } from "@aws-sdk/client-s3";
 
-//#region src/tus/stores/s3/expiration-manager.d.ts
+//#region src/tus/stores/s3/expirationManager.d.ts
 type GetExpirationDateArgs = {
   createdAt: string;
 };
@@ -10,7 +11,7 @@ declare class S3ExpirationManager {
   private expirationPeriodInMilliseconds;
   private generateInfoKey;
   private generatePartKey;
-  constructor(client: S3, bucket: string, expirationPeriodInMilliseconds: number, generateInfoKey: (id: string) => string, generatePartKey: (id: string, isIncompletePart: boolean) => string);
+  constructor(client: S3, bucket: string, expirationPeriodInMilliseconds: number, generateInfoKey: S3MetadataManager['generateInfoKey'], generatePartKey: S3MetadataManager['generatePartKey']);
   /**
    * Calculates the expiration date for a file based on a creation date
    * @param args - The function arguments
@@ -33,4 +34,4 @@ declare class S3ExpirationManager {
 }
 //#endregion
 export { S3ExpirationManager };
-//# sourceMappingURL=expiration-manager.d.mts.map
+//# sourceMappingURL=expirationManager.d.mts.map

package/dist/tus/stores/s3/{expiration-manager.mjs → expirationManager.mjs}

@@ -1,4 +1,4 @@
-//#region src/tus/stores/s3/expiration-manager.ts
+//#region src/tus/stores/s3/expirationManager.ts
 var S3ExpirationManager = class {
 	constructor(client, bucket, expirationPeriodInMilliseconds, generateInfoKey, generatePartKey) {
 		this.client = client;
@@ -48,7 +48,10 @@ var S3ExpirationManager = class {
 				return initiatedDate && (/* @__PURE__ */ new Date()).getTime() > this.getExpirationDate({ createdAt: initiatedDate.toISOString() }).getTime();
 			}) || [];
 			const objectsToDelete = expiredUploads.reduce((all, expiredUpload) => {
-				all.push({ Key: this.generateInfoKey(expiredUpload.Key) }, { Key: this.generatePartKey(expiredUpload.Key, true) });
+				all.push({ Key: this.generateInfoKey({ id: expiredUpload.Key }) }, { Key: this.generatePartKey({
+					id: expiredUpload.Key,
+					isIncomplete: true
+				}) });
 				return all;
 			}, []);
 			const deletions = [];
@@ -73,4 +76,4 @@ var S3ExpirationManager = class {
 
 //#endregion
 export { S3ExpirationManager };
-//# sourceMappingURL=expiration-manager.mjs.map
+//# sourceMappingURL=expirationManager.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expirationManager.mjs","names":["client: S3","bucket: string","expirationPeriodInMilliseconds: number","generateInfoKey: S3MetadataManager['generateInfoKey']","generatePartKey: S3MetadataManager['generatePartKey']","keyMarker: string | undefined","uploadIdMarker: string | undefined","listResponse: AWS.ListMultipartUploadsCommandOutput","deletions: Promise<AWS.DeleteObjectsCommandOutput>[]"],"sources":["../../../../src/tus/stores/s3/expirationManager.ts"],"sourcesContent":["import type AWS from '@aws-sdk/client-s3'\nimport type { S3 } from '@aws-sdk/client-s3'\nimport type { S3MetadataManager } from './metadataManager'\n\ntype GetExpirationDateArgs = {\n  createdAt: string\n}\n\nexport class S3ExpirationManager {\n  constructor(\n    private client: S3,\n    private bucket: string,\n    private expirationPeriodInMilliseconds: number,\n    private generateInfoKey: S3MetadataManager['generateInfoKey'],\n    private generatePartKey: S3MetadataManager['generatePartKey']\n  ) {}\n\n  /**\n   * Calculates the expiration date for a file based on a creation date\n   * @param args - The function arguments\n   * @param args.createdAt - The creation date as a string\n   * @returns The expiration date\n   */\n  getExpirationDate(args: GetExpirationDateArgs): Date {\n    const { createdAt } = args\n    const date = new Date(createdAt)\n    return new Date(date.getTime() + this.expirationPeriodInMilliseconds)\n  }\n\n  /**\n   * Gets the expiration period in milliseconds\n   * @returns The expiration period in milliseconds\n   */\n  getExpiration(): number {\n    return this.expirationPeriodInMilliseconds\n  }\n\n  /**\n   * Deletes expired incomplete uploads based on their initialization date.\n   * Returns the number of deleted uploads.\n   * @param args - The function arguments (empty object)\n   * @returns Promise that resolves to the number of deleted uploads\n   */\n  async deleteExpired(): Promise<number> {\n    // No arguments to destructure\n    if (this.getExpiration() === 0) {\n      return 0\n    }\n\n    let keyMarker: string | undefined = undefined\n    let uploadIdMarker: string | undefined = undefined\n    let isTruncated = true\n    let deleted = 0\n\n    while (isTruncated) {\n      const listResponse: AWS.ListMultipartUploadsCommandOutput =\n        await this.client.listMultipartUploads({\n          Bucket: this.bucket,\n          KeyMarker: keyMarker,\n          UploadIdMarker: uploadIdMarker,\n        })\n\n      const expiredUploads =\n        listResponse.Uploads?.filter((multiPartUpload: AWS.MultipartUpload) => {\n          const initiatedDate = multiPartUpload.Initiated\n          return (\n            initiatedDate &&\n            new Date().getTime() >\n              this.getExpirationDate({\n                createdAt: initiatedDate.toISOString(),\n              }).getTime()\n          )\n        }) || []\n\n      const objectsToDelete = expiredUploads.reduce(\n        (all: { Key: string }[], expiredUpload: AWS.MultipartUpload) => {\n          all.push(\n            {\n              Key: this.generateInfoKey({ id: expiredUpload.Key as string }),\n            },\n            {\n              Key: this.generatePartKey({\n                id: expiredUpload.Key as string,\n                isIncomplete: true,\n              }),\n            }\n          )\n          return all\n        },\n        [] as { Key: string }[]\n      )\n\n      const deletions: Promise<AWS.DeleteObjectsCommandOutput>[] = []\n\n      if (objectsToDelete.length > 0) {\n        deletions.push(\n          this.client.deleteObjects({\n            Bucket: this.bucket,\n            Delete: {\n              Objects: objectsToDelete,\n            },\n          })\n        )\n      }\n\n      const abortions = expiredUploads.map(\n        (expiredUpload: AWS.MultipartUpload) =>\n          this.client.abortMultipartUpload({\n            Bucket: this.bucket,\n            Key: expiredUpload.Key,\n            UploadId: expiredUpload.UploadId,\n          })\n      )\n\n      await Promise.all([...deletions, ...abortions])\n\n      deleted += expiredUploads.length\n\n      isTruncated = listResponse.IsTruncated || false\n      keyMarker = listResponse.NextKeyMarker\n      uploadIdMarker = listResponse.NextUploadIdMarker\n    }\n\n    return deleted\n  }\n}\n"],"mappings":";AAQA,IAAa,sBAAb,MAAiC;CAC/B,YACE,AAAQA,QACR,AAAQC,QACR,AAAQC,gCACR,AAAQC,iBACR,AAAQC,iBACR;EALQ;EACA;EACA;EACA;EACA;;;;;;;;CASV,kBAAkB,MAAmC;EACnD,MAAM,EAAE,cAAc;EACtB,MAAM,OAAO,IAAI,KAAK,UAAU;AAChC,SAAO,IAAI,KAAK,KAAK,SAAS,GAAG,KAAK,+BAA+B;;;;;;CAOvE,gBAAwB;AACtB,SAAO,KAAK;;;;;;;;CASd,MAAM,gBAAiC;AAErC,MAAI,KAAK,eAAe,KAAK,EAC3B,QAAO;EAGT,IAAIC,YAAgC;EACpC,IAAIC,iBAAqC;EACzC,IAAI,cAAc;EAClB,IAAI,UAAU;AAEd,SAAO,aAAa;GAClB,MAAMC,eACJ,MAAM,KAAK,OAAO,qBAAqB;IACrC,QAAQ,KAAK;IACb,WAAW;IACX,gBAAgB;IACjB,CAAC;GAEJ,MAAM,iBACJ,aAAa,SAAS,QAAQ,oBAAyC;IACrE,MAAM,gBAAgB,gBAAgB;AACtC,WACE,kCACA,IAAI,MAAM,EAAC,SAAS,GAClB,KAAK,kBAAkB,EACrB,WAAW,cAAc,aAAa,EACvC,CAAC,CAAC,SAAS;KAEhB,IAAI,EAAE;GAEV,MAAM,kBAAkB,eAAe,QACpC,KAAwB,kBAAuC;AAC9D,QAAI,KACF,EACE,KAAK,KAAK,gBAAgB,EAAE,IAAI,cAAc,KAAe,CAAC,EAC/D,EACD,EACE,KAAK,KAAK,gBAAgB;KACxB,IAAI,cAAc;KAClB,cAAc;KACf,CAAC,EACH,CACF;AACD,WAAO;MAET,EAAE,CACH;GAED,MAAMC,YAAuD,EAAE;AAE/D,OAAI,gBAAgB,SAAS,EAC3B,WAAU,KACR,KAAK,OAAO,cAAc;IACxB,QAAQ,KAAK;IACb,QAAQ,EACN,SAAS,iBACV;IACF,CAAC,CACH;GAGH,MAAM,YAAY,eAAe,KAC9B,kBACC,KAAK,OAAO,qBAAqB;IAC/B,QAAQ,KAAK;IACb,KAAK,cAAc;IACnB,UAAU,cAAc;IACzB,CAAC,CACL;AAED,SAAM,QAAQ,IAAI,CAAC,GAAG,WAAW,GAAG,UAAU,CAAC;AAE/C,cAAW,eAAe;AAE1B,iBAAc,aAAa,eAAe;AAC1C,eAAY,aAAa;AACzB,oBAAiB,aAAa;;AAGhC,SAAO"}

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"fileOperations.mjs","names":["maxMultipartParts: number","maxUploadSize: number","minPartSize: number","preferredPartSize: number","optimalPartSize: number"],"sources":["../../../../src/tus/stores/s3/fileOperations.ts"],"sourcesContent":["import crypto from 'node:crypto'\nimport fs from 'node:fs'\nimport os from 'node:os'\nimport path from 'node:path'\n\nimport { useErrorHandler } from '../../../hooks/useErrorHandler'\nimport { MediaCloudErrors } from '../../../types/errors'\n\nimport type { NodeFSError } from '../../../types'\nimport type AWS from '@aws-sdk/client-s3'\n\ntype CalculateOptimalPartSizeArgs = {\n  size?: number\n}\n\ntype CalculateOffsetFromPartsArgs = {\n  parts?: Array<AWS.Part>\n}\n\ntype CalculatePartNumberArgs = {\n  parts: Array<AWS.Part>\n}\n\ntype GenerateUniqueTmpFileNameArgs = {\n  template: string\n}\n\ntype CalculateOffsetFromPartsExportArgs = {\n  parts?: Array<{ Size?: number }>\n}\n\nconst { throwError } = useErrorHandler()\n\nexport class S3FileOperations {\n  constructor(\n    private maxMultipartParts: number,\n    private maxUploadSize: number,\n    private minPartSize: number,\n    private preferredPartSize: number\n  ) {}\n\n  /**\n   * Calculates the optimal part size for S3 multipart upload\n   * @param args - The function arguments\n   * @param args.size - The upload size in bytes (optional)\n   * @returns The optimal part size in bytes\n   */\n  calculateOptimalPartSize(args: CalculateOptimalPartSizeArgs): number {\n    const { size } = args\n    // When upload size is not known, default to preferredPartSize\n    // Assuming maxUploadSize can lead to extremely large chunks (hundreds of GB),\n    // which breaks streaming/resumable uploads in practice\n    let uploadSize = size\n    if (uploadSize === undefined) {\n      uploadSize = this.preferredPartSize\n    }\n\n    let optimalPartSize: number\n\n    // When upload is smaller or equal to preferredPartSize, upload in just one part\n    if (uploadSize <= this.preferredPartSize) {\n      optimalPartSize = uploadSize\n    }\n    // Does the upload fit in maxMultipartParts parts or less with preferredPartSize\n    else if (uploadSize <= this.preferredPartSize * this.maxMultipartParts) {\n      optimalPartSize = this.preferredPartSize\n      // The upload is too big for the preferred size\n      // We divide the size with the max amount of parts and round it up\n    } else {\n      optimalPartSize = Math.ceil(uploadSize / this.maxMultipartParts)\n    }\n\n    // Always ensure the part size is at least minPartSize\n    return Math.max(optimalPartSize, this.minPartSize)\n  }\n\n  /**\n   * Calculates the offset based on uploaded parts\n   * @param args - The function arguments\n   * @param args.parts - Array of uploaded parts (optional)\n   * @returns The total offset in bytes\n   */\n  calculateOffsetFromParts(args: CalculateOffsetFromPartsArgs): number {\n    const { parts } = args\n    return parts && parts.length > 0\n      ? parts.reduce((a, b) => a + (b.Size ?? 0), 0)\n      : 0\n  }\n\n  /**\n   * Calculates the next part number based on existing parts\n   * @param args - The function arguments\n   * @param args.parts - Array of uploaded parts\n   * @returns The next part number to use\n   */\n  calculatePartNumber(args: CalculatePartNumberArgs): number {\n    const { parts } = args\n    return parts.length > 0 ? parts[parts.length - 1].PartNumber! + 1 : 1\n  }\n\n  /**\n   * Generates a unique temporary file name\n   * @param args - The function arguments\n   * @param args.template - The template string for the file name\n   * @returns Promise that resolves to the unique file path\n   * @throws Error if unable to find unique name after max tries\n   */\n  async generateUniqueTmpFileName(\n    args: GenerateUniqueTmpFileNameArgs\n  ): Promise<string> {\n    const { template } = args\n    const tries = 5\n    for (let i = 0; i < tries; i++) {\n      const randomId = crypto.randomBytes(16).toString('hex')\n      const filePath = path.join(os.tmpdir(), `${template}${randomId}`)\n      try {\n        await fs.promises.access(filePath, fs.constants.F_OK)\n      } catch (error) {\n        const nodeError = error as NodeFSError\n        if (nodeError.code === 'ENOENT') {\n          return filePath\n        }\n      }\n    }\n    throwError(MediaCloudErrors.S3_UNIQUE_NAME_ERROR)\n    throw new Error() // This will never execute but satisfies TypeScript\n  }\n}\n\n/**\n * Calculates the total offset from uploaded parts\n * @param args - The function arguments\n * @param args.parts - Array of parts with size information (optional)\n * @returns The total offset in bytes\n */\nexport function calculateOffsetFromParts(\n  args: CalculateOffsetFromPartsExportArgs\n) {\n  const { parts } = args\n  return parts && parts.length > 0\n    ? parts.reduce((a, b) => a + (b.Size ?? 0), 0)\n    : 0\n}\n"],"mappings":";;;;;;;;AA+BA,MAAM,EAAE,eAAe,iBAAiB;AAExC,IAAa,mBAAb,MAA8B;CAC5B,YACE,AAAQA,mBACR,AAAQC,eACR,AAAQC,aACR,AAAQC,mBACR;EAJQ;EACA;EACA;EACA;;;;;;;;CASV,yBAAyB,MAA4C;EACnE,MAAM,EAAE,SAAS;EAIjB,IAAI,aAAa;AACjB,MAAI,eAAe,OACjB,cAAa,KAAK;EAGpB,IAAIC;AAGJ,MAAI,cAAc,KAAK,kBACrB,mBAAkB;WAGX,cAAc,KAAK,oBAAoB,KAAK,kBACnD,mBAAkB,KAAK;MAIvB,mBAAkB,KAAK,KAAK,aAAa,KAAK,kBAAkB;AAIlE,SAAO,KAAK,IAAI,iBAAiB,KAAK,YAAY;;;;;;;;CASpD,yBAAyB,MAA4C;EACnE,MAAM,EAAE,UAAU;AAClB,SAAO,SAAS,MAAM,SAAS,IAC3B,MAAM,QAAQ,GAAG,MAAM,KAAK,EAAE,QAAQ,IAAI,EAAE,GAC5C;;;;;;;;CASN,oBAAoB,MAAuC;EACzD,MAAM,EAAE,UAAU;AAClB,SAAO,MAAM,SAAS,IAAI,MAAM,MAAM,SAAS,GAAG,aAAc,IAAI;;;;;;;;;CAUtE,MAAM,0BACJ,MACiB;EACjB,MAAM,EAAE,aAAa;EACrB,MAAM,QAAQ;AACd,OAAK,IAAI,IAAI,GAAG,IAAI,OAAO,KAAK;GAC9B,MAAM,WAAW,OAAO,YAAY,GAAG,CAAC,SAAS,MAAM;GACvD,MAAM,WAAW,KAAK,KAAK,GAAG,QAAQ,EAAE,GAAG,WAAW,WAAW;AACjE,OAAI;AACF,UAAM,GAAG,SAAS,OAAO,UAAU,GAAG,UAAU,KAAK;YAC9C,OAAO;AAEd,QADkB,MACJ,SAAS,SACrB,QAAO;;;AAIb,aAAW,iBAAiB,qBAAqB;AACjD,QAAM,IAAI,OAAO;;;;;;;;;AAUrB,SAAgB,yBACd,MACA;CACA,MAAM,EAAE,UAAU;AAClB,QAAO,SAAS,MAAM,SAAS,IAC3B,MAAM,QAAQ,GAAG,MAAM,KAAK,EAAE,QAAQ,IAAI,EAAE,GAC5C"}

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

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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/tus/stores/s3/index.ts"],"sourcesContent":["import { MediaCloudErrors } from '../../../types/errors'\nimport { S3Store } from './s3-store'\nimport { useErrorHandler } from '../../../hooks/useErrorHandler'\n\nimport type { MediaCloudPluginOptions } from '../../../types'\n\nconst { throwError } = useErrorHandler()\n\n/**\n * Creates and configures an S3Store instance\n * @param s3Config - The S3 configuration options\n * @returns A configured S3Store instance\n * @throws {Error} When required S3 configuration is missing\n */\nexport function createS3Store(\n  s3Config: MediaCloudPluginOptions['s3']\n): S3Store {\n  // Validate S3 configuration\n  if (\n    !s3Config?.bucket ||\n    !s3Config?.region ||\n    !s3Config?.accessKeyId ||\n    !s3Config?.secretAccessKey\n  ) {\n    throwError(MediaCloudErrors.S3_CONFIG_MISSING)\n  }\n\n  // Create and return S3Store instance\n  return new S3Store({\n    s3ClientConfig: {\n      acl: 'public-read',\n      bucket: s3Config.bucket,\n      credentials: {\n        accessKeyId: s3Config.accessKeyId,\n        secretAccessKey: s3Config.secretAccessKey,\n      },\n      endpoint: s3Config.endpoint,\n      forcePathStyle: true,\n      region: s3Config.region,\n    },\n  })\n}\n"],"mappings":";;;;;AAMA,MAAM,EAAE,eAAe,iBAAiB;;;;;;;AAQxC,SAAgB,cACd,UACS;AAET,KACE,CAAC,UAAU,UACX,CAAC,UAAU,UACX,CAAC,UAAU,eACX,CAAC,UAAU,gBAEX,YAAW,iBAAiB,kBAAkB;AAIhD,QAAO,IAAI,QAAQ,EACjB,gBAAgB;EACd,KAAK;EACL,QAAQ,SAAS;EACjB,aAAa;GACX,aAAa,SAAS;GACtB,iBAAiB,SAAS;GAC3B;EACD,UAAU,SAAS;EACnB,gBAAgB;EAChB,QAAQ,SAAS;EAClB,EACF,CAAC"}
+{"version":3,"file":"index.mjs","names":["magicError: UseMagicErrorReturn"],"sources":["../../../../src/tus/stores/s3/index.ts"],"sourcesContent":["import { MediaCloudErrors } from '../../../types/errors'\nimport { S3Store } from './s3Store'\nimport { useMagicError } from '@maas/error-handler'\n\nimport type { MediaCloudPluginOptions } from '../../../types'\nimport type { UseMagicErrorReturn } from '@maas/error-handler'\n\nconst magicError: UseMagicErrorReturn = useMagicError({\n  prefix: 'PLUGIN-MEDIA-CLOUD',\n})\n\n/**\n * Validates S3 configuration options\n * @param s3Config - The S3 configuration to validate\n * @throws {Error} When required S3 configuration is missing\n */\nfunction validateS3Config(s3Config: MediaCloudPluginOptions['s3']): void {\n  magicError.assert(s3Config?.bucket, MediaCloudErrors.S3_CONFIG_MISSING)\n  magicError.assert(s3Config?.region, MediaCloudErrors.S3_CONFIG_MISSING)\n  magicError.assert(s3Config?.accessKeyId, MediaCloudErrors.S3_CONFIG_MISSING)\n  magicError.assert(\n    s3Config?.secretAccessKey,\n    MediaCloudErrors.S3_CONFIG_MISSING\n  )\n}\n\n/**\n * Creates and configures an S3Store instance\n * @param s3Config - The S3 configuration options\n * @returns A configured S3Store instance\n * @throws {Error} When required S3 configuration is missing\n */\nexport function createS3Store(\n  s3Config: MediaCloudPluginOptions['s3']\n): S3Store {\n  validateS3Config(s3Config)\n\n  return new S3Store({\n    s3ClientConfig: {\n      acl: 'public-read',\n      bucket: s3Config?.bucket ?? '',\n      credentials: {\n        accessKeyId: s3Config?.accessKeyId ?? '',\n        secretAccessKey: s3Config?.secretAccessKey ?? '',\n      },\n      endpoint: s3Config?.endpoint ?? '',\n      forcePathStyle: true,\n      region: s3Config?.region ?? '',\n    },\n  })\n}\n"],"mappings":";;;;;AAOA,MAAMA,aAAkC,cAAc,EACpD,QAAQ,sBACT,CAAC;;;;;;AAOF,SAAS,iBAAiB,UAA+C;AACvE,YAAW,OAAO,UAAU,QAAQ,iBAAiB,kBAAkB;AACvE,YAAW,OAAO,UAAU,QAAQ,iBAAiB,kBAAkB;AACvE,YAAW,OAAO,UAAU,aAAa,iBAAiB,kBAAkB;AAC5E,YAAW,OACT,UAAU,iBACV,iBAAiB,kBAClB;;;;;;;;AASH,SAAgB,cACd,UACS;AACT,kBAAiB,SAAS;AAE1B,QAAO,IAAI,QAAQ,EACjB,gBAAgB;EACd,KAAK;EACL,QAAQ,UAAU,UAAU;EAC5B,aAAa;GACX,aAAa,UAAU,eAAe;GACtC,iBAAiB,UAAU,mBAAmB;GAC/C;EACD,UAAU,UAAU,YAAY;EAChC,gBAAgB;EAChB,QAAQ,UAAU,UAAU;EAC7B,EACF,CAAC"}

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadataManager.mjs","names":["client: S3","bucket: string","shouldUseExpirationTags: () => boolean","generateCompleteTag: (value: 'false' | 'true') => string | undefined"],"sources":["../../../../src/tus/stores/s3/metadataManager.ts"],"sourcesContent":["import { TUS_RESUMABLE, Upload } from '@tus/utils'\n\nimport { useErrorHandler } from '../../../hooks/useErrorHandler'\nimport { MediaCloudLogs } from '../../../types/errors'\n\nimport type { S3 } from '@aws-sdk/client-s3'\nimport type { TusUploadMetadata } from '../../../types'\n\ntype GenerateInfoKeyArgs = {\n  id: string\n}\n\ntype GeneratePartKeyArgs = {\n  id: string\n  prefix?: string\n  isIncomplete?: boolean\n}\n\ntype GetMetadataArgs = {\n  id: string\n}\n\ntype SaveMetadataArgs = {\n  upload: Upload\n  uploadId: string\n}\n\ntype CompleteMetadataArgs = {\n  upload: Upload\n}\n\nconst { log } = useErrorHandler()\n\nexport class S3MetadataManager {\n  constructor(\n    private client: S3,\n    private bucket: string,\n    private shouldUseExpirationTags: () => boolean,\n    private generateCompleteTag: (value: 'false' | 'true') => string | undefined\n  ) {}\n  /**\n   * Generates the S3 key for metadata info files\n   * @param args - The function arguments\n   * @param args.id - The file ID\n   * @returns The S3 key for the metadata file\n   */\n  generateInfoKey(args: GenerateInfoKeyArgs): string {\n    return `${args.id}.info`\n  }\n\n  /**\n   * Generates the S3 key for part files\n   * @param args - The function arguments\n   * @param args.id - The file ID\n   * @param args.prefix - Path prefix for nested media items\n   * @param args.isIncomplete - Whether this is an incomplete part\n   * @returns The S3 key for the part file\n   */\n  generatePartKey(args: GeneratePartKeyArgs): string {\n    const { id, prefix, isIncomplete = false } = args\n    let key = id\n\n    if (prefix) {\n      key = `${prefix}/${key}`\n    }\n\n    if (isIncomplete) {\n      key += '.part'\n    }\n\n    // TODO: introduce ObjectPrefixing for parts and incomplete parts\n    // ObjectPrefix is prepended to the name of each S3 object that is created\n    // to store uploaded files. It can be used to create a pseudo-directory\n    // structure in the bucket, e.g. \"path/to/my/uploads\".\n    return key\n  }\n\n  /**\n   * Retrieves upload metadata previously saved in `${file_id}.info`.\n   * Always fetches fresh data from S3 to ensure correctness.\n   * @param args - The function arguments\n   * @param args.id - The file ID to retrieve metadata for\n   * @returns Promise that resolves to the upload metadata\n   */\n  async getMetadata(args: GetMetadataArgs): Promise<TusUploadMetadata> {\n    const { id } = args\n\n    const { Body, Metadata } = await this.client.getObject({\n      Bucket: this.bucket,\n      Key: this.generateInfoKey({ id }),\n    })\n\n    const file = JSON.parse((await Body?.transformToString()) as string)\n\n    const parsedSize =\n      file.size === undefined || file.size === null\n        ? undefined\n        : Number(file.size)\n\n    const metadata: TusUploadMetadata = {\n      file: new Upload({\n        id,\n        creation_date: file.creation_date,\n        metadata: file.metadata,\n        offset: Number.parseInt(file.offset, 10),\n        size: Number.isFinite(parsedSize) ? parsedSize : undefined,\n        storage: file.storage,\n      }),\n      'tus-version': Metadata?.['tus-version'] as string,\n      'upload-id': (Metadata?.['upload-id'] || file['upload-id']) as string,\n    }\n\n    return metadata\n  }\n\n  /**\n   * Saves upload metadata to a `${file_id}.info` file on S3.\n   * The upload-id is stored in the S3 object metadata.\n   * @param args - The function arguments\n   * @param args.upload - The upload object containing metadata\n   * @param args.uploadId - The upload ID for the multipart upload\n   * @returns Promise that resolves when metadata is saved\n   */\n  async saveMetadata(args: SaveMetadataArgs): Promise<void> {\n    const { upload, uploadId } = args\n    log(MediaCloudLogs.S3_STORE_METADATA_SAVING)\n\n    await this.client.putObject({\n      Body: JSON.stringify(upload),\n      Bucket: this.bucket,\n      Key: this.generateInfoKey({ id: upload.id }),\n      Metadata: {\n        'tus-version': TUS_RESUMABLE,\n        'upload-id': uploadId,\n      },\n      Tagging: this.generateCompleteTag('false'),\n    })\n    log(MediaCloudLogs.S3_STORE_METADATA_SAVED)\n  }\n\n  /**\n   * Completes metadata by updating it with completion tags\n   * @param args - The function arguments\n   * @param args.upload - The completed upload object\n   * @returns Promise that resolves when metadata is updated\n   */\n  async completeMetadata(args: CompleteMetadataArgs): Promise<void> {\n    const { upload } = args\n\n    if (!this.shouldUseExpirationTags()) {\n      return\n    }\n\n    const metadata = await this.getMetadata({ id: upload.id })\n    const { 'upload-id': uploadId } = metadata\n\n    await this.client.putObject({\n      Body: JSON.stringify(upload),\n      Bucket: this.bucket,\n      Key: this.generateInfoKey({ id: upload.id }),\n      Metadata: {\n        'tus-version': TUS_RESUMABLE,\n        'upload-id': uploadId,\n      },\n      Tagging: this.generateCompleteTag('true'),\n    })\n  }\n}\n"],"mappings":";;;;;AA+BA,MAAM,EAAE,QAAQ,iBAAiB;AAEjC,IAAa,oBAAb,MAA+B;CAC7B,YACE,AAAQA,QACR,AAAQC,QACR,AAAQC,yBACR,AAAQC,qBACR;EAJQ;EACA;EACA;EACA;;;;;;;;CAQV,gBAAgB,MAAmC;AACjD,SAAO,GAAG,KAAK,GAAG;;;;;;;;;;CAWpB,gBAAgB,MAAmC;EACjD,MAAM,EAAE,IAAI,QAAQ,eAAe,UAAU;EAC7C,IAAI,MAAM;AAEV,MAAI,OACF,OAAM,GAAG,OAAO,GAAG;AAGrB,MAAI,aACF,QAAO;AAOT,SAAO;;;;;;;;;CAUT,MAAM,YAAY,MAAmD;EACnE,MAAM,EAAE,OAAO;EAEf,MAAM,EAAE,MAAM,aAAa,MAAM,KAAK,OAAO,UAAU;GACrD,QAAQ,KAAK;GACb,KAAK,KAAK,gBAAgB,EAAE,IAAI,CAAC;GAClC,CAAC;EAEF,MAAM,OAAO,KAAK,MAAO,MAAM,MAAM,mBAAmB,CAAY;EAEpE,MAAM,aACJ,KAAK,SAAS,UAAa,KAAK,SAAS,OACrC,SACA,OAAO,KAAK,KAAK;AAevB,SAboC;GAClC,MAAM,IAAI,OAAO;IACf;IACA,eAAe,KAAK;IACpB,UAAU,KAAK;IACf,QAAQ,OAAO,SAAS,KAAK,QAAQ,GAAG;IACxC,MAAM,OAAO,SAAS,WAAW,GAAG,aAAa;IACjD,SAAS,KAAK;IACf,CAAC;GACF,eAAe,WAAW;GAC1B,aAAc,WAAW,gBAAgB,KAAK;GAC/C;;;;;;;;;;CAaH,MAAM,aAAa,MAAuC;EACxD,MAAM,EAAE,QAAQ,aAAa;AAC7B,MAAI,eAAe,yBAAyB;AAE5C,QAAM,KAAK,OAAO,UAAU;GAC1B,MAAM,KAAK,UAAU,OAAO;GAC5B,QAAQ,KAAK;GACb,KAAK,KAAK,gBAAgB,EAAE,IAAI,OAAO,IAAI,CAAC;GAC5C,UAAU;IACR,eAAe;IACf,aAAa;IACd;GACD,SAAS,KAAK,oBAAoB,QAAQ;GAC3C,CAAC;AACF,MAAI,eAAe,wBAAwB;;;;;;;;CAS7C,MAAM,iBAAiB,MAA2C;EAChE,MAAM,EAAE,WAAW;AAEnB,MAAI,CAAC,KAAK,yBAAyB,CACjC;EAIF,MAAM,EAAE,aAAa,aADJ,MAAM,KAAK,YAAY,EAAE,IAAI,OAAO,IAAI,CAAC;AAG1D,QAAM,KAAK,OAAO,UAAU;GAC1B,MAAM,KAAK,UAAU,OAAO;GAC5B,QAAQ,KAAK;GACb,KAAK,KAAK,gBAAgB,EAAE,IAAI,OAAO,IAAI,CAAC;GAC5C,UAAU;IACR,eAAe;IACf,aAAa;IACd;GACD,SAAS,KAAK,oBAAoB,OAAO;GAC1C,CAAC"}

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

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