@maas/payload-plugin-media-cloud 0.0.11 → 0.0.15

package/dist/error-handler/dist/index.mjs

@@ -1,79 +1,99 @@
 //#region ../error-handler/dist/index.mjs
 /**
-* Creates a logger with configurable prefix, levels, and error/log sets
-* @param config - Configuration object containing prefix, level, error set, and log set
-* @returns Object with logError, throwError, and log functions
+* @class MagicError
+* @extends Error
+* @description A custom error class that includes an error code, timestamp, and source.
+*
+* @property {string | number} errorCode - The error code.
+* @property {number} timestamp - The timestamp when the error occurred.
+* @property {string} source - The source of the error.
+*
+* @example
+* ```ts
+* throw new MagicError('An error occurred', 500, 'My-Component')
+* ```
 */
-function createLogger(config) {
-	const { prefix, level, errors = {}, logs = {} } = config;
-	const logEntriesSet = new Set(Object.values(logs));
-	const errorEntryKeyMap = /* @__PURE__ */ new Map();
-	Object.entries(errors).forEach(([key, errorEntry]) => {
-		errorEntryKeyMap.set(errorEntry, key);
-	});
-	class BaseError extends Error {
-		constructor({ message, key, errorCode }) {
-			super(`[${prefix}] ${message}`);
-			this.name = "BaseError";
-			this.key = key;
-			this.errorCode = errorCode;
-		}
+var MagicError = class MagicError$1 extends Error {
+	/**
+	* @constructor
+	* @param {string} message - The error message.
+	* @param {string | number} errorCode - The error code.
+	* @param {string} source - The source of the error.
+	* @param {ErrorOptions} [options] - The error options.
+	*/
+	constructor(message, errorCode, source, options) {
+		super(message, options);
+		this.name = "MagicError";
+		this.errorCode = errorCode;
+		this.timestamp = Date.now();
+		this.source = source;
+		if (Error.captureStackTrace) Error.captureStackTrace(this, MagicError$1);
 	}
-	function formatMessage(message) {
-		return `[${prefix}] ${message}`;
+};
+/**
+* @function useMagicError
+* @description A hook to create a `MagicError` instance and throw it.
+* @param {UseMagicErrorArgs} [args] - The arguments for the hook.
+* @returns {UseMagicErrorReturn} - The return value of the hook.
+*/
+function useMagicError(args = {}) {
+	const { prefix = "MagicError", source = "payload-plugins" } = args;
+	/**
+	* @function log
+	* @description Logs a message to the console.
+	* @param {string} message - The message to log.
+	*/
+	function log(message) {
+		console.log(`[${prefix}]:`, message);
 	}
-	function logError(errorEntry, overrideLevel) {
-		if (!errorEntry) {
-			console.error(`[${prefix}] Invalid error entry provided`);
-			return;
-		}
-		const formattedMessage = formatMessage(errorEntry.message);
-		switch (overrideLevel ?? level) {
-			case "WARNING":
-				console.warn(formattedMessage);
-				break;
-			case "ERROR":
-				console.error(formattedMessage);
-				break;
-			default: console.error(formattedMessage);
-		}
+	/**
+	* @function logError
+	* @description Logs an error message to the console.
+	* @param {string} message - The message to log.
+	*/
+	function logError(message) {
+		console.error(`[${prefix}]:`, message);
 	}
-	function log(logEntry) {
-		if (!logEntry || !logEntriesSet.has(logEntry)) {
-			console.error(`[${prefix}] Invalid log entry provided`);
-			return;
-		}
-		const formattedMessage = formatMessage(logEntry.message);
-		console.log(formattedMessage);
+	/**
+	* @function logWarning
+	* @description Logs a warning message to the console.
+	* @param {string} message - The message to log.
+	*/
+	function logWarning(message) {
+		console.warn(`[${prefix}]:`, message);
 	}
-	function throwError(errorEntry) {
-		if (!errorEntry) throw new BaseError({
-			key: "UNKNOWN_ERROR",
-			message: "Invalid error entry provided",
-			errorCode: 500
-		});
-		const errorCode = errorEntry.errorCode ?? 500;
-		throw new BaseError({
-			key: errorEntryKeyMap.get(errorEntry) || "UNKNOWN_ERROR",
-			message: errorEntry.message,
-			errorCode
-		});
+	/**
+	* @function throwError
+	* @description Throws a `MagicError`.
+	* @param {ThrowErrorArgs} args - The arguments for the error.
+	* @throws {MagicError}
+	*/
+	function throwError(args$1) {
+		const { message, errorCode, cause } = args$1;
+		const error = new MagicError(`[${prefix}]: ${message}`, errorCode, source, { cause });
+		logError(message);
+		throw error;
+	}
+	/**
+	* @function assert
+	* @description Asserts that a value is not null or undefined.
+	* @param {T} value - The value to assert.
+	* @param {ThrowErrorArgs} args - The arguments for the error to throw if the assertion fails.
+	* @throws {MagicError}
+	*/
+	function assert(value, args$1) {
+		if (value === void 0 || value === null) throwError(args$1);
 	}
 	return {
-		logError,
+		assert,
 		throwError,
-		log
+		log,
+		logError,
+		logWarning,
+		MagicError
 	};
 }
-/**
-* Log level enum for categorizing log/error severity
-*/
-let LogLevel = /* @__PURE__ */ function(LogLevel$1) {
-	LogLevel$1["WARNING"] = "WARNING";
-	LogLevel$1["ERROR"] = "ERROR";
-	return LogLevel$1;
-}({});
 
 //#endregion
-export { LogLevel, createLogger };
+export { useMagicError };
 //# sourceMappingURL=index.mjs.map

package/dist/error-handler/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../error-handler/dist/index.mjs"],"sourcesContent":["//#region src/createLogger.ts\n/**\n* Creates a logger with configurable prefix, levels, and error/log sets\n* @param config - Configuration object containing prefix, level, error set, and log set\n* @returns Object with logError, throwError, and log functions\n*/\nfunction createLogger(config) {\n\tconst { prefix, level, errors = {}, logs = {} } = config;\n\tconst logEntriesSet = new Set(Object.values(logs));\n\tconst errorEntryKeyMap = /* @__PURE__ */ new Map();\n\tObject.entries(errors).forEach(([key, errorEntry]) => {\n\t\terrorEntryKeyMap.set(errorEntry, key);\n\t});\n\tclass BaseError extends Error {\n\t\tconstructor({ message, key, errorCode }) {\n\t\t\tsuper(`[${prefix}] ${message}`);\n\t\t\tthis.name = \"BaseError\";\n\t\t\tthis.key = key;\n\t\t\tthis.errorCode = errorCode;\n\t\t}\n\t}\n\tfunction formatMessage(message) {\n\t\treturn `[${prefix}] ${message}`;\n\t}\n\tfunction logError(errorEntry, overrideLevel) {\n\t\tif (!errorEntry) {\n\t\t\tconsole.error(`[${prefix}] Invalid error entry provided`);\n\t\t\treturn;\n\t\t}\n\t\tconst formattedMessage = formatMessage(errorEntry.message);\n\t\tswitch (overrideLevel ?? level) {\n\t\t\tcase \"WARNING\":\n\t\t\t\tconsole.warn(formattedMessage);\n\t\t\t\tbreak;\n\t\t\tcase \"ERROR\":\n\t\t\t\tconsole.error(formattedMessage);\n\t\t\t\tbreak;\n\t\t\tdefault: console.error(formattedMessage);\n\t\t}\n\t}\n\tfunction log(logEntry) {\n\t\tif (!logEntry || !logEntriesSet.has(logEntry)) {\n\t\t\tconsole.error(`[${prefix}] Invalid log entry provided`);\n\t\t\treturn;\n\t\t}\n\t\tconst formattedMessage = formatMessage(logEntry.message);\n\t\tconsole.log(formattedMessage);\n\t}\n\tfunction throwError(errorEntry) {\n\t\tif (!errorEntry) throw new BaseError({\n\t\t\tkey: \"UNKNOWN_ERROR\",\n\t\t\tmessage: \"Invalid error entry provided\",\n\t\t\terrorCode: 500\n\t\t});\n\t\tconst errorCode = errorEntry.errorCode ?? 500;\n\t\tthrow new BaseError({\n\t\t\tkey: errorEntryKeyMap.get(errorEntry) || \"UNKNOWN_ERROR\",\n\t\t\tmessage: errorEntry.message,\n\t\t\terrorCode\n\t\t});\n\t}\n\treturn {\n\t\tlogError,\n\t\tthrowError,\n\t\tlog\n\t};\n}\n\n//#endregion\n//#region src/types.ts\n/**\n* Log level enum for categorizing log/error severity\n*/\nlet LogLevel = /* @__PURE__ */ function(LogLevel$1) {\n\tLogLevel$1[\"WARNING\"] = \"WARNING\";\n\tLogLevel$1[\"ERROR\"] = \"ERROR\";\n\treturn LogLevel$1;\n}({});\n\n//#endregion\nexport { LogLevel, createLogger };\n//# sourceMappingURL=index.mjs.map"],"mappings":";;;;;;AAMA,SAAS,aAAa,QAAQ;CAC7B,MAAM,EAAE,QAAQ,OAAO,SAAS,EAAE,EAAE,OAAO,EAAE,KAAK;CAClD,MAAM,gBAAgB,IAAI,IAAI,OAAO,OAAO,KAAK,CAAC;CAClD,MAAM,mCAAmC,IAAI,KAAK;AAClD,QAAO,QAAQ,OAAO,CAAC,SAAS,CAAC,KAAK,gBAAgB;AACrD,mBAAiB,IAAI,YAAY,IAAI;GACpC;CACF,MAAM,kBAAkB,MAAM;EAC7B,YAAY,EAAE,SAAS,KAAK,aAAa;AACxC,SAAM,IAAI,OAAO,IAAI,UAAU;AAC/B,QAAK,OAAO;AACZ,QAAK,MAAM;AACX,QAAK,YAAY;;;CAGnB,SAAS,cAAc,SAAS;AAC/B,SAAO,IAAI,OAAO,IAAI;;CAEvB,SAAS,SAAS,YAAY,eAAe;AAC5C,MAAI,CAAC,YAAY;AAChB,WAAQ,MAAM,IAAI,OAAO,gCAAgC;AACzD;;EAED,MAAM,mBAAmB,cAAc,WAAW,QAAQ;AAC1D,UAAQ,iBAAiB,OAAzB;GACC,KAAK;AACJ,YAAQ,KAAK,iBAAiB;AAC9B;GACD,KAAK;AACJ,YAAQ,MAAM,iBAAiB;AAC/B;GACD,QAAS,SAAQ,MAAM,iBAAiB;;;CAG1C,SAAS,IAAI,UAAU;AACtB,MAAI,CAAC,YAAY,CAAC,cAAc,IAAI,SAAS,EAAE;AAC9C,WAAQ,MAAM,IAAI,OAAO,8BAA8B;AACvD;;EAED,MAAM,mBAAmB,cAAc,SAAS,QAAQ;AACxD,UAAQ,IAAI,iBAAiB;;CAE9B,SAAS,WAAW,YAAY;AAC/B,MAAI,CAAC,WAAY,OAAM,IAAI,UAAU;GACpC,KAAK;GACL,SAAS;GACT,WAAW;GACX,CAAC;EACF,MAAM,YAAY,WAAW,aAAa;AAC1C,QAAM,IAAI,UAAU;GACnB,KAAK,iBAAiB,IAAI,WAAW,IAAI;GACzC,SAAS,WAAW;GACpB;GACA,CAAC;;AAEH,QAAO;EACN;EACA;EACA;EACA;;;;;AAQF,IAAI,WAA2B,yBAAS,YAAY;AACnD,YAAW,aAAa;AACxB,YAAW,WAAW;AACtB,QAAO;EACN,EAAE,CAAC"}
+{"version":3,"file":"index.mjs","names":["MagicError"],"sources":["../../../../error-handler/dist/index.mjs"],"sourcesContent":["//#region src/class/MagicError.ts\n/**\n* @class MagicError\n* @extends Error\n* @description A custom error class that includes an error code, timestamp, and source.\n*\n* @property {string | number} errorCode - The error code.\n* @property {number} timestamp - The timestamp when the error occurred.\n* @property {string} source - The source of the error.\n*\n* @example\n* ```ts\n* throw new MagicError('An error occurred', 500, 'My-Component')\n* ```\n*/\nvar MagicError = class MagicError extends Error {\n\t/**\n\t* @constructor\n\t* @param {string} message - The error message.\n\t* @param {string | number} errorCode - The error code.\n\t* @param {string} source - The source of the error.\n\t* @param {ErrorOptions} [options] - The error options.\n\t*/\n\tconstructor(message, errorCode, source, options) {\n\t\tsuper(message, options);\n\t\tthis.name = \"MagicError\";\n\t\tthis.errorCode = errorCode;\n\t\tthis.timestamp = Date.now();\n\t\tthis.source = source;\n\t\tif (Error.captureStackTrace) Error.captureStackTrace(this, MagicError);\n\t}\n};\n\n//#endregion\n//#region src/hooks/useMagicError.ts\n/**\n* @function useMagicError\n* @description A hook to create a `MagicError` instance and throw it.\n* @param {UseMagicErrorArgs} [args] - The arguments for the hook.\n* @returns {UseMagicErrorReturn} - The return value of the hook.\n*/\nfunction useMagicError(args = {}) {\n\tconst { prefix = \"MagicError\", source = \"payload-plugins\" } = args;\n\t/**\n\t* @function log\n\t* @description Logs a message to the console.\n\t* @param {string} message - The message to log.\n\t*/\n\tfunction log(message) {\n\t\tconsole.log(`[${prefix}]:`, message);\n\t}\n\t/**\n\t* @function logError\n\t* @description Logs an error message to the console.\n\t* @param {string} message - The message to log.\n\t*/\n\tfunction logError(message) {\n\t\tconsole.error(`[${prefix}]:`, message);\n\t}\n\t/**\n\t* @function logWarning\n\t* @description Logs a warning message to the console.\n\t* @param {string} message - The message to log.\n\t*/\n\tfunction logWarning(message) {\n\t\tconsole.warn(`[${prefix}]:`, message);\n\t}\n\t/**\n\t* @function throwError\n\t* @description Throws a `MagicError`.\n\t* @param {ThrowErrorArgs} args - The arguments for the error.\n\t* @throws {MagicError}\n\t*/\n\tfunction throwError(args$1) {\n\t\tconst { message, errorCode, cause } = args$1;\n\t\tconst error = new MagicError(`[${prefix}]: ${message}`, errorCode, source, { cause });\n\t\tlogError(message);\n\t\tthrow error;\n\t}\n\t/**\n\t* @function assert\n\t* @description Asserts that a value is not null or undefined.\n\t* @param {T} value - The value to assert.\n\t* @param {ThrowErrorArgs} args - The arguments for the error to throw if the assertion fails.\n\t* @throws {MagicError}\n\t*/\n\tfunction assert(value, args$1) {\n\t\tif (value === void 0 || value === null) throwError(args$1);\n\t}\n\treturn {\n\t\tassert,\n\t\tthrowError,\n\t\tlog,\n\t\tlogError,\n\t\tlogWarning,\n\t\tMagicError\n\t};\n}\n\n//#endregion\nexport { MagicError, useMagicError };\n//# sourceMappingURL=index.mjs.map"],"mappings":";;;;;;;;;;;;;;;AAeA,IAAI,aAAa,MAAMA,qBAAmB,MAAM;;;;;;;;CAQ/C,YAAY,SAAS,WAAW,QAAQ,SAAS;AAChD,QAAM,SAAS,QAAQ;AACvB,OAAK,OAAO;AACZ,OAAK,YAAY;AACjB,OAAK,YAAY,KAAK,KAAK;AAC3B,OAAK,SAAS;AACd,MAAI,MAAM,kBAAmB,OAAM,kBAAkB,MAAMA,aAAW;;;;;;;;;AAYxE,SAAS,cAAc,OAAO,EAAE,EAAE;CACjC,MAAM,EAAE,SAAS,cAAc,SAAS,sBAAsB;;;;;;CAM9D,SAAS,IAAI,SAAS;AACrB,UAAQ,IAAI,IAAI,OAAO,KAAK,QAAQ;;;;;;;CAOrC,SAAS,SAAS,SAAS;AAC1B,UAAQ,MAAM,IAAI,OAAO,KAAK,QAAQ;;;;;;;CAOvC,SAAS,WAAW,SAAS;AAC5B,UAAQ,KAAK,IAAI,OAAO,KAAK,QAAQ;;;;;;;;CAQtC,SAAS,WAAW,QAAQ;EAC3B,MAAM,EAAE,SAAS,WAAW,UAAU;EACtC,MAAM,QAAQ,IAAI,WAAW,IAAI,OAAO,KAAK,WAAW,WAAW,QAAQ,EAAE,OAAO,CAAC;AACrF,WAAS,QAAQ;AACjB,QAAM;;;;;;;;;CASP,SAAS,OAAO,OAAO,QAAQ;AAC9B,MAAI,UAAU,KAAK,KAAK,UAAU,KAAM,YAAW,OAAO;;AAE3D,QAAO;EACN;EACA;EACA;EACA;EACA;EACA;EACA"}

package/dist/hooks/useErrorHandler.d.mts

@@ -1,183 +1,7 @@
-import { LogLevel } from "@maas/error-handler";
+import { UseMagicErrorReturn } from "@maas/error-handler";
 
 //#region src/hooks/useErrorHandler.d.ts
-declare function useErrorHandler(): {
-  logError: (errorEntry: {
-    readonly message: "Mux configuration (tokenId and tokenSecret) must be provided in pluginOptions to use Mux";
-    readonly errorCode: 400;
-  } | {
-    readonly message: "Mux configuration is missing. Mux features will not be available";
-    readonly errorCode: 400;
-  } | {
-    readonly message: "No upload-id found for upload";
-    readonly errorCode: 400;
-  } | {
-    readonly message: "Error deleting Mux asset";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Mux video upload failed";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Mux direct upload failed";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Error in Mux create upload handler";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Request does not support json() method";
-    readonly errorCode: 400;
-  } | {
-    readonly message: "S3 configuration (bucket, region, accessKeyId, secretAccessKey) must be provided in pluginOptions";
-    readonly errorCode: 400;
-  } | {
-    readonly message: "Error deleting file from S3";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Could not find a unique file name after maximum tries";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "TUS file upload error occurred";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Unknown storage type for media";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Unable to determine file type";
-    readonly errorCode: 400;
-  } | {
-    readonly message: "Error determining file type";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Error sanitizing filename";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Filename is missing, cannot parse file";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "File not found";
-    readonly errorCode: 404;
-  } | {
-    readonly message: "Error setting media dimensions";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "No upload URL provided, cannot parse upload ID";
-    readonly errorCode: 400;
-  } | {
-    readonly message: "Upload handler error occurred";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Polling error for upload";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Payload Media Cloud plugin is not configured";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Error in namingFunction";
-    readonly errorCode: 500;
-  }, overrideLevel?: LogLevel) => void;
-  throwError: (errorEntry: {
-    readonly message: "Mux configuration (tokenId and tokenSecret) must be provided in pluginOptions to use Mux";
-    readonly errorCode: 400;
-  } | {
-    readonly message: "Mux configuration is missing. Mux features will not be available";
-    readonly errorCode: 400;
-  } | {
-    readonly message: "No upload-id found for upload";
-    readonly errorCode: 400;
-  } | {
-    readonly message: "Error deleting Mux asset";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Mux video upload failed";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Mux direct upload failed";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Error in Mux create upload handler";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Request does not support json() method";
-    readonly errorCode: 400;
-  } | {
-    readonly message: "S3 configuration (bucket, region, accessKeyId, secretAccessKey) must be provided in pluginOptions";
-    readonly errorCode: 400;
-  } | {
-    readonly message: "Error deleting file from S3";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Could not find a unique file name after maximum tries";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "TUS file upload error occurred";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Unknown storage type for media";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Unable to determine file type";
-    readonly errorCode: 400;
-  } | {
-    readonly message: "Error determining file type";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Error sanitizing filename";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Filename is missing, cannot parse file";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "File not found";
-    readonly errorCode: 404;
-  } | {
-    readonly message: "Error setting media dimensions";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "No upload URL provided, cannot parse upload ID";
-    readonly errorCode: 400;
-  } | {
-    readonly message: "Upload handler error occurred";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Polling error for upload";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Payload Media Cloud plugin is not configured";
-    readonly errorCode: 500;
-  } | {
-    readonly message: "Error in namingFunction";
-    readonly errorCode: 500;
-  }) => never;
-  log: (logEntry: {
-    readonly message: "Initializing multipart upload";
-  } | {
-    readonly message: "Multipart upload created";
-  } | {
-    readonly message: "Failed to finish upload";
-  } | {
-    readonly message: "Attempting to read file from S3";
-  } | {
-    readonly message: "Successfully read file from S3";
-  } | {
-    readonly message: "Failed to read file, trying again";
-  } | {
-    readonly message: "Failed to read file";
-  } | {
-    readonly message: "No file found";
-  } | {
-    readonly message: "Error retrieving parts";
-  } | {
-    readonly message: "Saving metadata";
-  } | {
-    readonly message: "Metadata file saved";
-  } | {
-    readonly message: "Removing cached data";
-  } | {
-    readonly message: "Finished uploading incomplete part";
-  } | {
-    readonly message: "Failed to remove chunk";
-  }) => void;
-};
+declare function useErrorHandler(): Omit<UseMagicErrorReturn, 'assert' | 'MagicError'>;
 //#endregion
 export { useErrorHandler };
 //# sourceMappingURL=useErrorHandler.d.mts.map

package/dist/hooks/useErrorHandler.mjs

@@ -1,18 +1,13 @@
-import { MediaCloudErrors, MediaCloudLogs } from "../types/errors.mjs";
-import { LogLevel, createLogger } from "../error-handler/dist/index.mjs";
+import { useMagicError } from "../error-handler/dist/index.mjs";
 
 //#region src/hooks/useErrorHandler.ts
 function useErrorHandler() {
-	const { logError, throwError, log } = createLogger({
-		prefix: "PLUGIN-MEDIA-CLOUD",
-		level: LogLevel.ERROR,
-		errors: MediaCloudErrors,
-		logs: MediaCloudLogs
-	});
+	const { log, logError, throwError, logWarning } = useMagicError({ prefix: "PLUGIN-MEDIA-CLOUD" });
 	return {
+		log,
 		logError,
 		throwError,
-		log
+		logWarning
 	};
 }
 

package/dist/hooks/useErrorHandler.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useErrorHandler.mjs","names":[],"sources":["../../src/hooks/useErrorHandler.ts"],"sourcesContent":["import { createLogger, LogLevel } from '@maas/error-handler'\nimport { MediaCloudErrors, MediaCloudLogs } from '../types/errors'\n\nexport function useErrorHandler() {\n  const { logError, throwError, log } = createLogger({\n    prefix: 'PLUGIN-MEDIA-CLOUD',\n    level: LogLevel.ERROR,\n    errors: MediaCloudErrors,\n    logs: MediaCloudLogs,\n  })\n\n  return {\n    logError,\n    throwError,\n    log,\n  }\n}\n"],"mappings":";;;;AAGA,SAAgB,kBAAkB;CAChC,MAAM,EAAE,UAAU,YAAY,QAAQ,aAAa;EACjD,QAAQ;EACR,OAAO,SAAS;EAChB,QAAQ;EACR,MAAM;EACP,CAAC;AAEF,QAAO;EACL;EACA;EACA;EACD"}
+{"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"}

package/dist/plugin.d.mts

@@ -5,9 +5,8 @@ import { Config } from "payload";
 
 /**
  * Media Cloud Plugin for Payload CMS
- * Provides file upload capabilities using S3 storage and Mux video processing
- * @param pluginOptions - Configuration options for the plugin
- * @returns A function that configures the Payload config
+ * @param pluginOptions Configuration options
+ * @returns Payload config function
  */
 declare function mediaCloudPlugin(pluginOptions: MediaCloudPluginOptions): (config: Config) => Config;
 //#endregion

package/dist/plugin.mjs

@@ -2,32 +2,30 @@ import { MediaCloudErrors } from "./types/errors.mjs";
 import { useErrorHandler } from "./hooks/useErrorHandler.mjs";
 import { getStorageAdapter } from "./adapter/storageAdapter.mjs";
 import { getMediaCollection } from "./collections/mediaCollection.mjs";
-import { createTusEndpoints, createTusServer } from "./utils/tus.mjs";
 import { createS3Store } from "./tus/stores/s3/index.mjs";
 import { createMuxClient, createMuxEndpoints, validateMuxConfig } from "./utils/mux.mjs";
+import { createTusEndpoints, createTusServer } from "./utils/tus.mjs";
 import { cloudStoragePlugin } from "@payloadcms/plugin-cloud-storage";
 import { initClientUploads } from "@payloadcms/plugin-cloud-storage/utilities";
-import deepmerge from "@fastify/deepmerge";
 
 //#region src/plugin.ts
 const { logError } = useErrorHandler();
 let muxClient = null;
 /**
 * Media Cloud Plugin for Payload CMS
-* Provides file upload capabilities using S3 storage and Mux video processing
-* @param pluginOptions - Configuration options for the plugin
-* @returns A function that configures the Payload config
+* @param pluginOptions Configuration options
+* @returns Payload config function
 */
 function mediaCloudPlugin(pluginOptions) {
 	return function(config) {
 		if (!pluginOptions) {
-			logError(MediaCloudErrors.PLUGIN_NOT_CONFIGURED);
+			logError(MediaCloudErrors.PLUGIN_NOT_CONFIGURED.message);
 			return config;
 		}
 		if (pluginOptions.enabled === false) return config;
 		/**
-		* Gets or creates a Mux client instance
-		* @returns The Mux client instance
+		* Helper function to get or create Mux client instance
+		* @returns Mux client instance
 		*/
 		function getMuxClient() {
 			if (muxClient) return muxClient;
@@ -37,7 +35,7 @@ function mediaCloudPlugin(pluginOptions) {
 			validateMuxConfig(pluginOptions.mux);
 			muxClient = getMuxClient();
 		} else {
-			logError(MediaCloudErrors.MUX_CONFIG_INCOMPLETE);
+			logError(MediaCloudErrors.MUX_CONFIG_INCOMPLETE.message);
 			muxClient = null;
 		}
 		const s3Store = createS3Store(pluginOptions.s3);
@@ -77,18 +75,28 @@ function mediaCloudPlugin(pluginOptions) {
 			clientUploads: true,
 			disableLocalStorage: true
 		} } };
-		const customConfig = {
-			admin: { components: { providers: ["@maas/payload-plugin-media-cloud/components#UploadManagerProvider"] } },
-			collections: [mediaCollection],
-			endpoints: [...createTusEndpoints({
-				tusServer,
-				s3Store
-			}), ...createMuxEndpoints({
-				getMuxClient,
-				pluginOptions
-			})]
+		const mergedConfig = {
+			...config,
+			admin: {
+				...config.admin,
+				components: {
+					...config.admin?.components,
+					providers: [...config.admin?.components?.providers ?? [], "@maas/payload-plugin-media-cloud/components#UploadManagerProvider"]
+				}
+			},
+			collections: [...config.collections ?? [], mediaCollection],
+			endpoints: [
+				...config.endpoints ?? [],
+				...createTusEndpoints({
+					tusServer,
+					s3Store
+				}),
+				...createMuxEndpoints({
+					getMuxClient,
+					pluginOptions
+				})
+			]
 		};
-		const mergedConfig = deepmerge({ all: true })(config, customConfig);
 		return cloudStoragePlugin(cloudStorageConfig)(mergedConfig);
 	};
 }

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'\n\nimport { cloudStoragePlugin } from '@payloadcms/plugin-cloud-storage'\nimport { initClientUploads } from '@payloadcms/plugin-cloud-storage/utilities'\n\nimport { MediaCloudErrors } from './types/errors'\nimport { useErrorHandler } from './hooks/useErrorHandler'\nimport { getStorageAdapter } from './adapter/storageAdapter'\nimport { getMediaCollection } from './collections/mediaCollection'\nimport { createTusServer, createTusEndpoints } from './utils/tus'\n\nimport { createS3Store } from './tus/stores/s3'\nimport {\n  createMuxClient,\n  validateMuxConfig,\n  createMuxEndpoints,\n} from './utils/mux'\n\nimport type { Config } from 'payload'\nimport type { MediaCloudPluginOptions } from './types'\nimport deepmerge from '@fastify/deepmerge'\n\nconst { logError } = useErrorHandler()\n\nlet muxClient: Mux | null = null\n\n/**\n * Media Cloud Plugin for Payload CMS\n * Provides file upload capabilities using S3 storage and Mux video processing\n * @param pluginOptions - Configuration options for the plugin\n * @returns A function that configures the Payload config\n */\nexport function mediaCloudPlugin(pluginOptions: MediaCloudPluginOptions) {\n  return function (config: Config): Config {\n    // Check if the plugin is configured\n    if (!pluginOptions) {\n      logError(MediaCloudErrors.PLUGIN_NOT_CONFIGURED)\n      return config\n    }\n\n    // Check if the plugin is disabled\n    if (pluginOptions.enabled === false) {\n      return config\n    }\n\n    /**\n     * Gets or creates a Mux client instance\n     * @returns The Mux client instance\n     */\n    function getMuxClient(): Mux {\n      // Return existing Mux client if already created\n      if (muxClient) {\n        return muxClient\n      }\n      // Create and return a new Mux client\n      return createMuxClient(pluginOptions.mux)\n    }\n\n    // Validate Mux configuration\n    if (pluginOptions.mux) {\n      validateMuxConfig(pluginOptions.mux)\n      muxClient = getMuxClient()\n    } else {\n      logError(MediaCloudErrors.MUX_CONFIG_INCOMPLETE)\n      muxClient = null\n    }\n\n    // Create S3 store and Tus server instances\n    const s3Store = createS3Store(pluginOptions.s3)\n    const tusServer = createTusServer({ config, s3Store, pluginOptions })\n\n    // Extend base collection if specified\n    const baseCollection = config.collections?.find(\n      ({ slug }) => slug === pluginOptions.collection\n    )\n\n    // Create media collection with optional base configuration\n    const mediaCollection = getMediaCollection({\n      s3Store,\n      baseCollection,\n    })\n\n    // Remove base collection if it was extended\n    if (baseCollection) {\n      config = {\n        ...config,\n        collections:\n          config.collections?.filter(\n            ({ slug }) => slug !== baseCollection?.slug\n          ) || [],\n      }\n    }\n\n    // Initialize client uploads\n    initClientUploads({\n      clientHandler:\n        '@maas/payload-plugin-media-cloud/components#UploadHandler',\n      collections: {\n        media: {\n          clientUploads: true,\n          disableLocalStorage: true,\n        },\n      },\n      config,\n      enabled: true,\n      serverHandler: () => {\n        return Response.json(\n          { message: 'Server handler is not implemented' },\n          { status: 501 }\n        )\n      },\n      serverHandlerPath: '/media-cloud/upload',\n    })\n\n    const cloudStorageConfig = {\n      collections: {\n        media: {\n          adapter: getStorageAdapter({ getMuxClient, pluginOptions, s3Store }),\n          clientUploads: true,\n          disableLocalStorage: true,\n        },\n      },\n    }\n\n    const customConfig = {\n      admin: {\n        components: {\n          providers: [\n            '@maas/payload-plugin-media-cloud/components#UploadManagerProvider',\n          ],\n        },\n      },\n      collections: [mediaCollection],\n      endpoints: [\n        ...createTusEndpoints({ tusServer, s3Store }),\n        ...createMuxEndpoints({ getMuxClient, pluginOptions }),\n      ],\n    }\n\n    // Merge custom config with existing config\n    const mergedConfig: Config = deepmerge({ all: true })(config, customConfig)\n\n    return cloudStoragePlugin(cloudStorageConfig)(mergedConfig)\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAsBA,MAAM,EAAE,aAAa,iBAAiB;AAEtC,IAAIA,YAAwB;;;;;;;AAQ5B,SAAgB,iBAAiB,eAAwC;AACvE,QAAO,SAAU,QAAwB;AAEvC,MAAI,CAAC,eAAe;AAClB,YAAS,iBAAiB,sBAAsB;AAChD,UAAO;;AAIT,MAAI,cAAc,YAAY,MAC5B,QAAO;;;;;EAOT,SAAS,eAAoB;AAE3B,OAAI,UACF,QAAO;AAGT,UAAO,gBAAgB,cAAc,IAAI;;AAI3C,MAAI,cAAc,KAAK;AACrB,qBAAkB,cAAc,IAAI;AACpC,eAAY,cAAc;SACrB;AACL,YAAS,iBAAiB,sBAAsB;AAChD,eAAY;;EAId,MAAM,UAAU,cAAc,cAAc,GAAG;EAC/C,MAAM,YAAY,gBAAgB;GAAE;GAAQ;GAAS;GAAe,CAAC;EAGrE,MAAM,iBAAiB,OAAO,aAAa,MACxC,EAAE,WAAW,SAAS,cAAc,WACtC;EAGD,MAAM,kBAAkB,mBAAmB;GACzC;GACA;GACD,CAAC;AAGF,MAAI,eACF,UAAS;GACP,GAAG;GACH,aACE,OAAO,aAAa,QACjB,EAAE,WAAW,SAAS,gBAAgB,KACxC,IAAI,EAAE;GACV;AAIH,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,MAAM,eAAe;GACnB,OAAO,EACL,YAAY,EACV,WAAW,CACT,oEACD,EACF,EACF;GACD,aAAa,CAAC,gBAAgB;GAC9B,WAAW,CACT,GAAG,mBAAmB;IAAE;IAAW;IAAS,CAAC,EAC7C,GAAG,mBAAmB;IAAE;IAAc;IAAe,CAAC,CACvD;GACF;EAGD,MAAMC,eAAuB,UAAU,EAAE,KAAK,MAAM,CAAC,CAAC,QAAQ,aAAa;AAE3E,SAAO,mBAAmB,mBAAmB,CAAC,aAAa"}
+{"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({ config, 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;GAAQ;GAAS;GAAe,CAAC;EAGrE,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"}

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

@@ -7,7 +7,7 @@ import fs from "node:fs";
 import os from "node:os";
 
 //#region src/tus/stores/s3/parts-manager.ts
-const { throwError, log } = useErrorHandler();
+const { log, throwError } = useErrorHandler();
 var S3PartsManager = class {
 	constructor(client, bucket, minPartSize, partUploadSemaphore, metadataManager, fileOperations, generateCompleteTag) {
 		this.client = client;