@kumix/storage 0.1.0 → 0.1.2

package/dist/cloudinary.d.ts

@@ -1,4 +1,4 @@
-import { A as DownloadOptions, B as PresignedUrlResult, C as RenameFolderResult, D as CopyResult, E as CopyOptions, F as ListOptions, H as UploadResult, I as ListResult, L as MoveOptions, M as DuplicateOptions, N as DuplicateResult, O as DeleteOptions, P as ExistsResult, R as MoveResult, S as RenameFolderOptions, T as BatchDeleteResult, U as CloudinaryConfig, V as UploadOptions, _ as DeleteFolderOptions, b as ListFoldersOptions, f as StorageInterface, g as CreateFolderResult, h as CreateFolderOptions, j as DownloadResult, k as DeleteResult, m as CopyFolderResult, n as EnvRecord, p as CopyFolderOptions, v as DeleteFolderResult, w as BatchDeleteOptions, x as ListFoldersResult, y as FolderExistsResult, z as PresignedUrlOptions } from "./config-J6AdDh_c.js";
+import { A as DownloadOptions, B as PresignedUrlResult, C as RenameFolderResult, D as CopyResult, E as CopyOptions, F as ListOptions, H as UploadResult, I as ListResult, L as MoveOptions, M as DuplicateOptions, N as DuplicateResult, O as DeleteOptions, P as ExistsResult, R as MoveResult, S as RenameFolderOptions, T as BatchDeleteResult, U as CloudinaryConfig, V as UploadOptions, _ as DeleteFolderOptions, b as ListFoldersOptions, f as StorageInterface, g as CreateFolderResult, h as CreateFolderOptions, j as DownloadResult, k as DeleteResult, m as CopyFolderResult, n as EnvRecord, p as CopyFolderOptions, v as DeleteFolderResult, w as BatchDeleteOptions, x as ListFoldersResult, y as FolderExistsResult, z as PresignedUrlOptions } from "./config-DGzEH-Zd.js";
 
 //#region src/services/cloudinary.d.ts
 /**
@@ -30,16 +30,16 @@ declare class CloudinaryService implements StorageInterface {
   folderExists(path: string): Promise<FolderExistsResult>;
   renameFolder(options: RenameFolderOptions): Promise<RenameFolderResult>;
   copyFolder(options: CopyFolderOptions): Promise<CopyFolderResult>;
-  uploadFile(key: string, file: Buffer | Uint8Array | string, contentType?: string, metadata?: Record<string, string>): Promise<UploadResult>;
+  uploadFile(key: string, file: Buffer | Uint8Array | string, options?: Partial<UploadOptions>): Promise<UploadResult>;
   downloadFile(key: string): Promise<DownloadResult>;
   deleteFile(key: string): Promise<DeleteResult>;
   deleteFiles(keys: string[]): Promise<BatchDeleteResult>;
   listFiles(prefix?: string, maxKeys?: number): Promise<ListResult>;
   fileExists(key: string): Promise<boolean>;
-  copyFile(sourceKey: string, destinationKey: string, metadata?: Record<string, string>): Promise<CopyResult>;
-  moveFile(sourceKey: string, destinationKey: string, metadata?: Record<string, string>): Promise<MoveResult>;
-  duplicateFile(sourceKey: string, destinationKey: string, metadata?: Record<string, string>): Promise<DuplicateResult>;
-  renameFile(sourceKey: string, destinationKey: string, metadata?: Record<string, string>): Promise<MoveResult>;
+  copyFile(sourceKey: string, destinationKey: string, options?: Partial<CopyOptions>): Promise<CopyResult>;
+  moveFile(sourceKey: string, destinationKey: string, options?: Partial<MoveOptions>): Promise<MoveResult>;
+  duplicateFile(sourceKey: string, destinationKey: string, options?: Partial<DuplicateOptions>): Promise<DuplicateResult>;
+  renameFile(sourceKey: string, destinationKey: string, options?: Partial<MoveOptions>): Promise<MoveResult>;
   getDownloadUrl(key: string, expiresIn?: number): Promise<PresignedUrlResult>;
   getUploadUrl(key: string, contentType?: string, expiresIn?: number): Promise<PresignedUrlResult>;
   createFolderPath(path: string): Promise<CreateFolderResult>;
@@ -88,6 +88,7 @@ declare class CloudinaryService implements StorageInterface {
 declare function createCloudinary(): CloudinaryService;
 declare function createCloudinary(config: CloudinaryConfig): CloudinaryService;
 declare function createCloudinary(config: CloudinaryConfig, env: EnvRecord): CloudinaryService;
+declare function createCloudinary(config: undefined, env: EnvRecord): CloudinaryService;
 //#endregion
 export { CloudinaryService, createCloudinary };
 //# sourceMappingURL=cloudinary.d.ts.map

package/dist/cloudinary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloudinary.d.ts","names":[],"sources":["../src/services/cloudinary.ts","../src/cloudinary.ts"],"mappings":"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"}
+{"version":3,"file":"cloudinary.d.ts","names":[],"sources":["../src/services/cloudinary.ts","../src/cloudinary.ts"],"mappings":";;;;;;;;cA+Ca,iBAAA,YAA6B,gBAAA;EAAA,QAChC,QAAA;EAAA,QACA,MAAA;;cAGI,MAAA,EAAQ,gBAAA;EAOpB,SAAA,IAAa,gBAAA;EAIb,WAAA;EAIA,YAAA,CAAa,GAAA;EAKP,MAAA,CAAO,OAAA,EAAS,aAAA,GAAgB,OAAA,CAAQ,YAAA;EAIxC,QAAA,CAAS,OAAA,EAAS,eAAA,GAAkB,OAAA,CAAQ,cAAA;EAI5C,MAAA,CAAO,OAAA,EAAS,aAAA,GAAgB,OAAA,CAAQ,YAAA;EAIxC,WAAA,CAAY,OAAA,EAAS,kBAAA,GAAqB,OAAA,CAAQ,iBAAA;EAIlD,IAAA,CAAK,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,UAAA;EAIrC,MAAA,CAAO,GAAA,WAAc,OAAA,CAAQ,YAAA;EAI7B,IAAA,CAAK,OAAA,EAAS,WAAA,GAAc,OAAA,CAAQ,UAAA;EAIpC,IAAA,CAAK,OAAA,EAAS,WAAA,GAAc,OAAA,CAAQ,UAAA;EAIpC,SAAA,CAAU,OAAA,EAAS,gBAAA,GAAmB,OAAA,CAAQ,eAAA;EAI9C,eAAA,CAAgB,OAAA,EAAS,mBAAA,GAAsB,OAAA,CAAQ,kBAAA;EAKvD,YAAA,CAAa,OAAA,EAAS,mBAAA,GAAsB,OAAA,CAAQ,kBAAA;EAIpD,YAAA,CAAa,OAAA,EAAS,mBAAA,GAAsB,OAAA,CAAQ,kBAAA;EAIpD,WAAA,CAAY,OAAA,GAAU,kBAAA,GAAqB,OAAA,CAAQ,iBAAA;EAInD,YAAA,CAAa,IAAA,WAAe,OAAA,CAAQ,kBAAA;EAIpC,YAAA,CAAa,OAAA,EAAS,mBAAA,GAAsB,OAAA,CAAQ,kBAAA;EAIpD,UAAA,CAAW,OAAA,EAAS,iBAAA,GAAoB,OAAA,CAAQ,gBAAA;EAKhD,UAAA,CACJ,GAAA,UACA,IAAA,EAAM,MAAA,GAAS,UAAA,WACf,OAAA,GAAU,OAAA,CAAQ,aAAA,IACjB,OAAA,CAAQ,YAAA;EAIL,YAAA,CAAa,GAAA,WAAc,OAAA,CAAQ,cAAA;EAInC,UAAA,CAAW,GAAA,WAAc,OAAA,CAAQ,YAAA;EAIjC,WAAA,CAAY,IAAA,aAAiB,OAAA,CAAQ,iBAAA;EAIrC,SAAA,CAAU,MAAA,WAAiB,OAAA,YAAmB,OAAA,CAAQ,UAAA;EAItD,UAAA,CAAW,GAAA,WAAc,OAAA;EAKzB,QAAA,CACJ,SAAA,UACA,cAAA,UACA,OAAA,GAAU,OAAA,CAAQ,WAAA,IACjB,OAAA,CAAQ,UAAA;EAIL,QAAA,CACJ,SAAA,UACA,cAAA,UACA,OAAA,GAAU,OAAA,CAAQ,WAAA,IACjB,OAAA,CAAQ,UAAA;EAIL,aAAA,CACJ,SAAA,UACA,cAAA,UACA,OAAA,GAAU,OAAA,CAAQ,gBAAA,IACjB,OAAA,CAAQ,eAAA;EAIL,UAAA,CACJ,SAAA,UACA,cAAA,UACA,OAAA,GAAU,OAAA,CAAQ,WAAA,IACjB,OAAA,CAAQ,UAAA;EAIL,cAAA,CAAe,GAAA,UAAa,SAAA,YAAqB,OAAA,CAAQ,kBAAA;EAIzD,YAAA,CACJ,GAAA,UACA,WAAA,WACA,SAAA,YACC,OAAA,CAAQ,kBAAA;EAUL,gBAAA,CAAiB,IAAA,WAAe,OAAA,CAAQ,kBAAA;EAIxC,gBAAA,CAAiB,IAAA,UAAc,SAAA,aAAoB,OAAA,CAAQ,kBAAA;EAI3D,gBAAA,CAAiB,IAAA,WAAe,OAAA;EAKhC,gBAAA,CAAiB,OAAA,UAAiB,OAAA,WAAkB,OAAA,CAAQ,kBAAA;EAI5D,cAAA,CACJ,UAAA,UACA,eAAA,UACA,SAAA,aACC,OAAA,CAAQ,gBAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBClMG,gBAAA,IAAoB,iBAAiB;AAAA,iBACrC,gBAAA,CAAiB,MAAA,EAAQ,gBAAA,GAAmB,iBAAiB;AAAA,iBAC7D,gBAAA,CAAiB,MAAA,EAAQ,gBAAA,EAAkB,GAAA,EAAK,SAAA,GAAY,iBAAA;AAAA,iBAC5D,gBAAA,CAAiB,MAAA,aAAmB,GAAA,EAAK,SAAA,GAAY,iBAAiB"}

package/dist/cloudinary.js

@@ -1,28 +1,41 @@
-import { o as loadCloudinaryConfig } from "./config-t-NVJICl.js";
-import { v2 } from "cloudinary";
+import { o as loadCloudinaryConfig } from "./config-By5ib98s.js";
 //#region src/providers/cloudinary.ts
-/**
-* Cloudinary storage provider implementation
-* Provides cloud storage operations using Cloudinary's API for media management
-*/
-/**
-* Cloudinary storage provider
-* Implements StorageInterface for Cloudinary cloud storage
-* @internal
-*/
 var CloudinaryProvider = class {
 	config;
+	_client = null;
 	constructor(config) {
 		this.config = config;
-		v2.config({
-			cloud_name: config.cloudName,
-			api_key: config.apiKey,
-			api_secret: config.apiSecret,
-			secure: config.secure !== false
+	}
+	/**
+	* Lazily load the Cloudinary SDK and re-apply this instance's config to the
+	* module-global v2 client. The SDK is dynamically imported so the optional
+	* `cloudinary` peer dep isn't required at module load time — consumers who
+	* only use the S3 provider can import the package without installing it.
+	*
+	* NOTE: the Cloudinary SDK keeps a single global config, so creating multiple
+	* `CloudinaryProvider` instances with different credentials in the same
+	* process is not supported — the most recently-configured instance wins.
+	* `getClient()` re-applies config before each API call to narrow the race
+	* window when instances are interleaved.
+	*/
+	async getClient() {
+		if (!this._client) try {
+			const mod = await import("cloudinary");
+			this._client = mod.v2 ?? mod.default?.v2;
+		} catch {
+			throw new Error("cloudinary is not available in this runtime. Install the `cloudinary` package to use the Cloudinary storage provider.");
+		}
+		this._client.config({
+			cloud_name: this.config.cloudName,
+			api_key: this.config.apiKey,
+			api_secret: this.config.apiSecret,
+			secure: this.config.secure !== false
 		});
+		return this._client;
 	}
 	async upload(options) {
 		try {
+			const cloudinary = await this.getClient();
 			let fileData;
 			if (typeof options.file === "string") fileData = options.file;
 			else fileData = `data:${options.contentType || "application/octet-stream"};base64,${Buffer.from(options.file).toString("base64")}`;
@@ -33,19 +46,23 @@ var CloudinaryProvider = class {
 			let folder = "";
 			let publicId = keyParts[keyParts.length - 1];
 			if (keyParts.length > 1) folder = keyParts.slice(0, -1).join("/");
-			const dotIndex = publicId.lastIndexOf(".");
-			if (dotIndex > 0) publicId = publicId.slice(0, dotIndex);
+			if (resourceType !== "raw") {
+				const dotIndex = publicId.lastIndexOf(".");
+				if (dotIndex > 0) publicId = publicId.slice(0, dotIndex);
+			}
 			const uploadOptions = {
 				public_id: publicId,
 				resource_type: resourceType,
 				overwrite: true,
 				invalidate: true,
-				...options.metadata
+				...options.metadata ? { context: options.metadata } : {}
 			};
-			if (folder) uploadOptions.folder = folder;
-			if (this.config.folder) uploadOptions.folder = `${this.config.folder}/${folder}`;
-			const result = await v2.uploader.upload(fileData, uploadOptions);
-			const publicUrl = this.getPublicUrl(result.public_id, result.format);
+			const folderParts = [];
+			if (this.config.folder) folderParts.push(this.config.folder);
+			if (folder) folderParts.push(folder);
+			if (folderParts.length > 0) uploadOptions.folder = folderParts.join("/");
+			const result = await cloudinary.uploader.upload(fileData, uploadOptions);
+			const publicUrl = this.getPublicUrl(result.public_id, result.format, resourceType);
 			return {
 				success: true,
 				key: result.public_id,
@@ -63,7 +80,11 @@ var CloudinaryProvider = class {
 	}
 	async download(options) {
 		try {
-			const publicUrl = this.getPublicUrl(options.key);
+			const dotIndex = options.key.lastIndexOf(".");
+			const hasExt = dotIndex > 0 && dotIndex < options.key.length - 1;
+			const baseKey = hasExt ? options.key.slice(0, dotIndex) : options.key;
+			const extension = hasExt ? options.key.slice(dotIndex + 1) : void 0;
+			const publicUrl = this.getPublicUrl(baseKey, extension);
 			const response = await fetch(publicUrl);
 			if (!response.ok) return {
 				success: false,
@@ -88,25 +109,24 @@ var CloudinaryProvider = class {
 	}
 	async delete(options) {
 		try {
-			const keyParts = options.key.split("/");
+			const cloudinary = await this.getClient();
 			let publicId = options.key;
-			if (keyParts.length > 1) publicId = `${keyParts.slice(0, -1).join("/")}/${keyParts[keyParts.length - 1]}`;
 			const dotIndex = publicId.lastIndexOf(".");
 			if (dotIndex > 0) publicId = publicId.slice(0, dotIndex);
 			if (this.config.folder) publicId = `${this.config.folder}/${publicId}`;
 			let resourceType = "raw";
 			try {
-				await v2.api.resource(publicId, { resource_type: "image" });
+				await cloudinary.api.resource(publicId, { resource_type: "image" });
 				resourceType = "image";
 			} catch {
 				try {
-					await v2.api.resource(publicId, { resource_type: "video" });
+					await cloudinary.api.resource(publicId, { resource_type: "video" });
 					resourceType = "video";
 				} catch {
 					resourceType = "raw";
 				}
 			}
-			await v2.uploader.destroy(publicId, {
+			await cloudinary.uploader.destroy(publicId, {
 				resource_type: resourceType,
 				invalidate: true
 			});
@@ -120,12 +140,30 @@ var CloudinaryProvider = class {
 	}
 	async batchDelete(options) {
 		try {
+			const cloudinary = await this.getClient();
+			const publicIds = options.keys.map((key) => {
+				let publicId = key;
+				const dotIndex = publicId.lastIndexOf(".");
+				if (dotIndex > 0) publicId = publicId.slice(0, dotIndex);
+				if (this.config.folder) publicId = `${this.config.folder}/${publicId}`;
+				return publicId;
+			});
+			const result = await cloudinary.api.delete_resources(publicIds);
+			const deleted = [];
+			const errors = [];
+			for (const [publicId, info] of Object.entries(result)) {
+				const originalKey = options.keys[publicIds.indexOf(publicId)] || publicId;
+				const status = info?.status;
+				if (status === "deleted" || status === "not_found") deleted.push(originalKey);
+				else errors.push({
+					key: originalKey,
+					error: `Delete status: ${String(status)}`
+				});
+			}
 			return {
-				success: false,
-				errors: options.keys.map((key) => ({
-					key,
-					error: "Cloudinary batch delete not implemented yet"
-				}))
+				success: errors.length === 0,
+				deleted,
+				errors
 			};
 		} catch (error) {
 			return {
@@ -139,55 +177,61 @@ var CloudinaryProvider = class {
 	}
 	async list(options = {}) {
 		try {
+			const cloudinary = await this.getClient();
 			const prefix = options.prefix || "";
 			const maxResults = options.maxKeys || 50;
-			const [images, videos, rawFiles] = await Promise.all([
-				v2.api.resources({
-					type: "upload",
-					resource_type: "image",
-					prefix,
-					max_results: maxResults,
-					next_cursor: options.continuationToken
-				}).catch(() => ({
-					resources: [],
-					next_cursor: void 0
-				})),
-				v2.api.resources({
-					type: "upload",
-					resource_type: "video",
-					prefix,
-					max_results: maxResults,
-					next_cursor: options.continuationToken
-				}).catch(() => ({
-					resources: [],
-					next_cursor: void 0
-				})),
-				v2.api.resources({
-					type: "upload",
-					resource_type: "raw",
-					prefix,
-					max_results: maxResults,
-					next_cursor: options.continuationToken
-				}).catch(() => ({
-					resources: [],
-					next_cursor: void 0
-				}))
-			]);
+			const TYPES = [
+				"image",
+				"video",
+				"raw"
+			];
+			let type = "image";
+			let cursor;
+			if (options.continuationToken) {
+				const sep = options.continuationToken.indexOf(":");
+				if (sep > 0) {
+					const t = options.continuationToken.slice(0, sep);
+					const c = options.continuationToken.slice(sep + 1);
+					if (TYPES.includes(t)) {
+						type = t;
+						cursor = c || void 0;
+					}
+				}
+			}
+			const fetchPage = (rt, c) => cloudinary.api.resources({
+				type: "upload",
+				resource_type: rt,
+				prefix,
+				max_results: maxResults,
+				...c ? { next_cursor: c } : {}
+			}).catch(() => ({
+				resources: [],
+				next_cursor: void 0
+			}));
+			let page = await fetchPage(type, cursor);
+			let resources = page.resources || [];
+			let nextCursor = page.next_cursor;
+			let typeIdx = TYPES.indexOf(type);
+			while (!nextCursor && resources.length === 0 && typeIdx < TYPES.length - 1) {
+				typeIdx++;
+				type = TYPES[typeIdx];
+				page = await fetchPage(type);
+				resources = page.resources || [];
+				nextCursor = page.next_cursor;
+			}
+			const files = resources.map((resource) => ({
+				key: String(resource.public_id || ""),
+				size: Number(resource.bytes) || 0,
+				lastModified: new Date(String(resource.created_at || /* @__PURE__ */ new Date())),
+				etag: String(resource.etag || ""),
+				contentType: this.formatToMime(String(resource.resource_type || "raw"), resource.format ? String(resource.format) : void 0)
+			}));
+			const nextContinuationToken = nextCursor ? `${type}:${nextCursor}` : void 0;
 			return {
 				success: true,
-				files: [
-					...images.resources || [],
-					...videos.resources || [],
-					...rawFiles.resources || []
-				].map((resource) => ({
-					key: String(resource.public_id || ""),
-					size: Number(resource.bytes) || 0,
-					lastModified: new Date(String(resource.created_at || /* @__PURE__ */ new Date())),
-					etag: String(resource.etag || ""),
-					contentType: resource.format ? `${resource.resource_type}/${resource.format}` : "application/octet-stream"
-				})),
-				isTruncated: !!(images.next_cursor || videos.next_cursor || rawFiles.next_cursor),
-				nextContinuationToken: images.next_cursor || videos.next_cursor || rawFiles.next_cursor
+				files,
+				isTruncated: !!nextContinuationToken,
+				nextContinuationToken
 			};
 		} catch (error) {
 			return {
@@ -196,12 +240,22 @@ var CloudinaryProvider = class {
 			};
 		}
 	}
-	async exists(_key) {
+	async exists(key) {
 		try {
-			return {
-				exists: false,
-				error: "Cloudinary exists check not implemented yet"
-			};
+			const cloudinary = await this.getClient();
+			let publicId = key;
+			const dotIndex = publicId.lastIndexOf(".");
+			if (dotIndex > 0) publicId = publicId.slice(0, dotIndex);
+			if (this.config.folder) publicId = `${this.config.folder}/${publicId}`;
+			for (const resourceType of [
+				"image",
+				"video",
+				"raw"
+			]) try {
+				await cloudinary.api.resource(publicId, { resource_type: resourceType });
+				return { exists: true };
+			} catch {}
+			return { exists: false };
 		} catch (error) {
 			return {
 				exists: false,
@@ -210,68 +264,98 @@ var CloudinaryProvider = class {
 		}
 	}
 	async copy(_options) {
-		try {
-			return {
-				success: false,
-				error: "Cloudinary copy not implemented yet"
-			};
-		} catch (error) {
-			return {
-				success: false,
-				error: error instanceof Error ? error.message : "Copy failed"
-			};
-		}
+		return {
+			success: false,
+			error: "Cloudinary copy not implemented yet"
+		};
 	}
 	async move(_options) {
-		try {
-			return {
-				success: false,
-				error: "Cloudinary move not implemented yet"
-			};
-		} catch (error) {
-			return {
-				success: false,
-				error: error instanceof Error ? error.message : "Move failed"
-			};
-		}
+		return {
+			success: false,
+			error: "Cloudinary move not implemented yet"
+		};
 	}
 	async duplicate(options) {
 		return this.copy(options);
 	}
 	async getPresignedUrl(_options) {
-		try {
-			return {
-				success: false,
-				error: "Cloudinary presigned URL not implemented yet"
-			};
-		} catch (error) {
-			return {
-				success: false,
-				error: error instanceof Error ? error.message : "Presigned URL generation failed"
-			};
-		}
-	}
-	getPublicUrl(key, extension) {
-		return `${`${this.config.secure !== false ? "https" : "http"}://res.cloudinary.com/${this.config.cloudName}`}/image/upload/${key}${extension ? `.${extension}` : ""}`;
+		return {
+			success: false,
+			error: "Cloudinary presigned URL not implemented yet"
+		};
+	}
+	getPublicUrl(key, extension, resourceType) {
+		const baseUrl = `${this.config.secure !== false ? "https" : "http"}://res.cloudinary.com/${this.config.cloudName}`;
+		let publicId = key;
+		if (this.config.folder && !publicId.startsWith(`${this.config.folder}/`)) publicId = `${this.config.folder}/${publicId}`;
+		return `${baseUrl}/${resourceType || this.inferResourceType(extension || key)}/upload/${publicId}${extension ? `.${extension}` : ""}`;
+	}
+	/**
+	* Build a valid MIME type from a Cloudinary `resource_type` + `format`.
+	* Naive `${resource_type}/${format}` produces invalid types like `raw/pdf`
+	* or `image/jpg`, so map known formats to their real MIME types and fall back
+	* to `application/octet-stream` for raw/unknown assets.
+	*/
+	formatToMime(resourceType, format) {
+		if (!format) return "application/octet-stream";
+		const fmt = format.toLowerCase();
+		const overrides = {
+			jpg: "image/jpeg",
+			jpeg: "image/jpeg",
+			svg: "image/svg+xml",
+			pdf: "application/pdf",
+			mov: "video/quicktime",
+			mp3: "audio/mpeg"
+		};
+		if (overrides[fmt]) return overrides[fmt];
+		if (resourceType === "image" || resourceType === "video") return `${resourceType}/${fmt}`;
+		return "application/octet-stream";
+	}
+	/** Infer Cloudinary resource type from a filename or extension */
+	inferResourceType(nameOrExt) {
+		const ext = nameOrExt.includes(".") ? nameOrExt.split(".").pop()?.toLowerCase() || "" : nameOrExt.toLowerCase();
+		const imageExts = [
+			"jpg",
+			"jpeg",
+			"png",
+			"gif",
+			"webp",
+			"svg",
+			"bmp",
+			"ico",
+			"avif",
+			"tiff"
+		];
+		const videoExts = [
+			"mp4",
+			"webm",
+			"mov",
+			"avi",
+			"mkv",
+			"flv",
+			"wmv",
+			"m4v",
+			"ogv"
+		];
+		if (imageExts.includes(ext)) return "image";
+		if (videoExts.includes(ext)) return "video";
+		return "raw";
 	}
 	async createFolder(options) {
-		try {
-			return {
-				success: true,
-				path: options.path
-			};
-		} catch (error) {
-			return {
-				success: false,
-				error: error instanceof Error ? error.message : "Create folder failed"
-			};
-		}
+		return {
+			success: true,
+			path: options.path
+		};
 	}
 	async deleteFolder(options) {
 		try {
-			const folderPath = options.path.endsWith("/") ? options.path.slice(0, -1) : options.path;
-			if (options.recursive) await v2.api.delete_resources_by_prefix(folderPath);
-			await v2.api.delete_folder(folderPath);
+			const cloudinary = await this.getClient();
+			const normalizedPath = options.path.replace(/\/$/, "");
+			const scopedPath = this.config.folder ? `${this.config.folder}/${normalizedPath}` : normalizedPath;
+			const folderPath = `${scopedPath}/`;
+			const folderApiPath = scopedPath;
+			if (options.recursive) await cloudinary.api.delete_resources_by_prefix(folderPath);
+			await cloudinary.api.delete_folder(folderApiPath);
 			return { success: true };
 		} catch (error) {
 			return {
@@ -284,9 +368,9 @@ var CloudinaryProvider = class {
 		try {
 			return {
 				success: true,
-				folders: ((await v2.api.root_folders()).folders || []).map((folder) => ({
-					name: folder.name,
-					path: folder.path
+				folders: ((await (await this.getClient()).api.root_folders()).folders || []).map((folder) => ({
+					name: String(folder.name ?? ""),
+					path: String(folder.path ?? "")
 				})),
 				isTruncated: false,
 				nextContinuationToken: void 0
@@ -299,43 +383,22 @@ var CloudinaryProvider = class {
 		}
 	}
 	async folderExists(_path) {
-		try {
-			return {
-				exists: false,
-				error: "Cloudinary folder exists check not implemented yet"
-			};
-		} catch (error) {
-			return {
-				exists: false,
-				error: error instanceof Error ? error.message : "Check folder existence failed"
-			};
-		}
+		return {
+			exists: false,
+			error: "Cloudinary folder existence is not implemented yet — this result does NOT mean the folder is absent."
+		};
 	}
 	async renameFolder(_options) {
-		try {
-			return {
-				success: false,
-				error: "Cloudinary rename folder not implemented yet"
-			};
-		} catch (error) {
-			return {
-				success: false,
-				error: error instanceof Error ? error.message : "Rename folder failed"
-			};
-		}
+		return {
+			success: false,
+			error: "Cloudinary rename folder not implemented yet"
+		};
 	}
 	async copyFolder(_options) {
-		try {
-			return {
-				success: false,
-				error: "Cloudinary copy folder not implemented yet"
-			};
-		} catch (error) {
-			return {
-				success: false,
-				error: error instanceof Error ? error.message : "Copy folder failed"
-			};
-		}
+		return {
+			success: false,
+			error: "Cloudinary copy folder not implemented yet"
+		};
 	}
 };
 //#endregion
@@ -413,12 +476,11 @@ var CloudinaryService = class {
 	async copyFolder(options) {
 		return this.provider.copyFolder(options);
 	}
-	async uploadFile(key, file, contentType, metadata) {
+	async uploadFile(key, file, options) {
 		return this.upload({
 			key,
 			file,
-			contentType,
-			metadata
+			...options
 		});
 	}
 	async downloadFile(key) {
@@ -439,29 +501,29 @@ var CloudinaryService = class {
 	async fileExists(key) {
 		return (await this.exists(key)).exists;
 	}
-	async copyFile(sourceKey, destinationKey, metadata) {
+	async copyFile(sourceKey, destinationKey, options) {
 		return this.copy({
 			sourceKey,
 			destinationKey,
-			metadata
+			...options
 		});
 	}
-	async moveFile(sourceKey, destinationKey, metadata) {
+	async moveFile(sourceKey, destinationKey, options) {
 		return this.move({
 			sourceKey,
 			destinationKey,
-			metadata
+			...options
 		});
 	}
-	async duplicateFile(sourceKey, destinationKey, metadata) {
+	async duplicateFile(sourceKey, destinationKey, options) {
 		return this.duplicate({
 			sourceKey,
 			destinationKey,
-			metadata
+			...options
 		});
 	}
-	async renameFile(sourceKey, destinationKey, metadata) {
-		return this.moveFile(sourceKey, destinationKey, metadata);
+	async renameFile(sourceKey, destinationKey, options) {
+		return this.moveFile(sourceKey, destinationKey, options);
 	}
 	async getDownloadUrl(key, expiresIn) {
 		return this.getPresignedUrl({