@warlock.js/core 4.0.174 → 4.1.2

package/esm/storage/drivers/cloud-driver.mjs

@@ -0,0 +1,593 @@
+import { storageDriverContext } from "../context/storage-driver-context.mjs";
+import { getMimeType } from "../utils/mime.mjs";
+import crypto from "crypto";
+
+//#region ../../@warlock.js/core/src/storage/drivers/cloud-driver.ts
+/**
+* Cached S3 SDK modules (loaded once, reused)
+*/
+let S3Client;
+let S3Storage;
+let S3Presigner;
+let isModuleExists = null;
+/**
+* Installation instructions for S3 SDK packages
+*/
+const S3_INSTALL_INSTRUCTIONS = `
+Cloud storage requires the AWS S3 SDK packages.
+Install them with:
+
+  npm install @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner
+
+Or with your preferred package manager:
+
+  pnpm add @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner
+  yarn add @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner
+`.trim();
+/**
+* Atomic initialization promise to handle concurrent calls to loadS3
+*/
+let initializationPromise = null;
+/**
+* Load S3 modules lazily
+*
+* @example
+* await loadS3();
+* if (isModuleExists) {
+*   // Safe to use S3Client, S3Storage, S3Presigner
+* }
+*/
+async function loadS3() {
+	if (isModuleExists === true) return;
+	if (initializationPromise) return initializationPromise;
+	initializationPromise = (async () => {
+		try {
+			const [client, storage, presigner] = await Promise.all([
+				import("@aws-sdk/client-s3"),
+				import("@aws-sdk/lib-storage"),
+				import("@aws-sdk/s3-request-presigner")
+			]);
+			S3Client = client;
+			S3Storage = storage;
+			S3Presigner = presigner;
+			isModuleExists = true;
+		} catch {
+			isModuleExists = false;
+		}
+	})();
+	return initializationPromise;
+}
+loadS3();
+/**
+* Base abstract class for all S3-compatible cloud storage drivers
+*
+* This class contains all shared logic for S3-compatible storage services
+* including AWS S3, Cloudflare R2, DigitalOcean Spaces, and others.
+*
+* **Important:** S3 SDK packages are lazy-loaded on first use.
+* Users must install them separately:
+* ```
+* npm install @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner
+* ```
+*
+* Subclasses must implement:
+* - `name`: Driver identifier (e.g., "s3", "r2", "spaces")
+* - `url()`: Returns the public URL for a file (provider-specific format)
+*/
+var CloudDriver = class {
+	constructor(options) {
+		this.options = options;
+		if (!isModuleExists) throw new Error(S3_INSTALL_INSTRUCTIONS);
+		this.client = new S3Client.S3Client({
+			region: this.options.region,
+			credentials: {
+				accessKeyId: this.options.accessKeyId,
+				secretAccessKey: this.options.secretAccessKey
+			},
+			...this.getEndpoint() && { endpoint: this.getEndpoint() }
+		});
+		this.retryConfig = {
+			maxRetries: this.options.retry?.maxRetries ?? 3,
+			initialDelayMs: this.options.retry?.initialDelayMs ?? 1e3,
+			maxDelayMs: this.options.retry?.maxDelayMs ?? 1e4,
+			backoffMultiplier: this.options.retry?.backoffMultiplier ?? 2
+		};
+	}
+	/**
+	* Get endpoint URL
+	* Can be overridden by subclasses for provider-specific endpoints
+	*/
+	getEndpoint() {
+		return this.options.endpoint;
+	}
+	/**
+	* Apply prefix to location path
+	*
+	* Priority: context prefix > driver options prefix > no prefix
+	* This allows multi-tenant scenarios where context overrides driver config.
+	*
+	* @param location - Original location path
+	* @returns Location with prefix applied if one exists
+	*/
+	applyPrefix(location) {
+		const prefix = storageDriverContext.getPrefix() || this.options.prefix;
+		if (!prefix) return location;
+		const cleanPrefix = prefix.replace(/\/+$/, "");
+		const cleanLocation = location.replace(/^\/+/, "");
+		if (cleanLocation.startsWith(cleanPrefix + "/") || cleanLocation === cleanPrefix) return cleanLocation;
+		return `${cleanPrefix}/${cleanLocation}`;
+	}
+	/**
+	* Normalize storage path (remove double slashes, sanitize)
+	* @internal
+	*/
+	normalizePath(path) {
+		return path.replace(/\/+/g, "/").replace(/^\//, "").trim();
+	}
+	/**
+	* Execute an operation with retry logic
+	*
+	* Retries on transient errors with exponential backoff.
+	*
+	* @param operation - Async operation to execute
+	* @param operationName - Name for logging
+	* @returns Result of the operation
+	* @internal
+	*/
+	async withRetry(operation, operationName = "operation") {
+		const { maxRetries, initialDelayMs, backoffMultiplier, maxDelayMs } = this.retryConfig;
+		let lastError;
+		for (let attempt = 0; attempt < maxRetries; attempt++) try {
+			return await operation();
+		} catch (error) {
+			lastError = error;
+			if (attempt === maxRetries - 1) break;
+			if (!this.isRetryableError(error)) throw error;
+			const delayMs = Math.min(initialDelayMs * Math.pow(backoffMultiplier, attempt), maxDelayMs);
+			await new Promise((resolve) => setTimeout(resolve, delayMs));
+		}
+		throw new Error(`${operationName} failed after ${maxRetries} attempts: ${lastError?.message}`);
+	}
+	/**
+	* Check if an error is retryable
+	*
+	* Retries on:
+	* - Network errors
+	* - 5xx server errors
+	* - Rate limiting (429)
+	* - Timeout errors
+	*
+	* Does NOT retry on:
+	* - 4xx client errors (except 429)
+	* - Authentication errors
+	* - Not found errors
+	*
+	* @param error - Error to check
+	* @returns true if error is retryable
+	* @internal
+	*/
+	isRetryableError(error) {
+		if (error.code === "ECONNRESET" || error.code === "ETIMEDOUT" || error.code === "ENOTFOUND") return true;
+		if (error.name === "NetworkingError" || error.name === "TimeoutError") return true;
+		const statusCode = error.$metadata?.httpStatusCode || error.statusCode;
+		if (statusCode) {
+			if (statusCode >= 500 && statusCode < 600) return true;
+			if (statusCode === 429) return true;
+		}
+		return false;
+	}
+	/**
+	* Put file to cloud storage
+	*/
+	async put(file, location, options) {
+		return this.withRetry(async () => {
+			const { PutObjectCommand } = S3Client;
+			location = this.applyPrefix(location);
+			const hash = this.calculateHash(file);
+			const mimeType = options?.mimeType || this.guessMimeType(location);
+			const command = new PutObjectCommand({
+				Bucket: this.options.bucket,
+				Key: location,
+				Body: file,
+				ContentType: mimeType,
+				CacheControl: options?.cacheControl,
+				ContentDisposition: options?.contentDisposition,
+				Metadata: options?.metadata,
+				ACL: options?.visibility === "public" ? "public-read" : void 0
+			});
+			const result = await this.client.send(command);
+			return {
+				path: location,
+				url: this.url(location),
+				size: file.length,
+				hash,
+				mimeType,
+				driver: this.name,
+				bucket: this.options.bucket,
+				region: this.options.region,
+				etag: result.ETag,
+				versionId: result.VersionId
+			};
+		}, "put");
+	}
+	/**
+	* Put file from a readable stream (for large files)
+	* Uses S3 multipart upload for efficient streaming
+	*/
+	async putStream(stream, location, options) {
+		return this.withRetry(async () => {
+			const { Upload } = S3Storage;
+			location = this.applyPrefix(location);
+			const mimeType = options?.mimeType || this.guessMimeType(location);
+			const result = await new Upload({
+				client: this.client,
+				params: {
+					Bucket: this.options.bucket,
+					Key: location,
+					Body: stream,
+					ContentType: mimeType,
+					CacheControl: options?.cacheControl,
+					ContentDisposition: options?.contentDisposition,
+					Metadata: options?.metadata,
+					ACL: options?.visibility === "public" ? "public-read" : void 0
+				}
+			}).done();
+			const info = await this.metadata(location);
+			return {
+				path: location,
+				url: this.url(location),
+				size: info.size,
+				hash: info.etag?.replace(/"/g, "") || "",
+				mimeType,
+				driver: this.name,
+				bucket: this.options.bucket,
+				region: this.options.region,
+				etag: result.ETag,
+				versionId: result.VersionId
+			};
+		}, "putStream");
+	}
+	/**
+	* Get file contents as Buffer
+	*/
+	async get(location) {
+		return this.withRetry(async () => {
+			const { GetObjectCommand } = S3Client;
+			location = this.applyPrefix(location);
+			const command = new GetObjectCommand({
+				Bucket: this.options.bucket,
+				Key: location
+			});
+			const result = await this.client.send(command);
+			if (!result.Body) throw new Error(`File not found: ${location}`);
+			return Buffer.from(await result.Body.transformToByteArray());
+		}, "get");
+	}
+	/**
+	* Get file as a readable stream (for large files)
+	*/
+	async getStream(location) {
+		return this.withRetry(async () => {
+			const { GetObjectCommand } = S3Client;
+			location = this.applyPrefix(location);
+			const command = new GetObjectCommand({
+				Bucket: this.options.bucket,
+				Key: location
+			});
+			const result = await this.client.send(command);
+			if (!result.Body) throw new Error(`File not found: ${location}`);
+			return result.Body;
+		}, "getStream");
+	}
+	/**
+	* Delete a file
+	*/
+	async delete(location) {
+		return this.withRetry(async () => {
+			const { DeleteObjectCommand } = S3Client;
+			location = this.applyPrefix(location);
+			const command = new DeleteObjectCommand({
+				Bucket: this.options.bucket,
+				Key: location
+			});
+			await this.client.send(command);
+			return true;
+		}, "delete");
+	}
+	/**
+	* Delete multiple files at once (uses batch delete for efficiency)
+	*/
+	async deleteMany(locations) {
+		if (locations.length === 0) return [];
+		return this.withRetry(async () => {
+			const { DeleteObjectsCommand } = S3Client;
+			const prefixedLocations = locations.map((loc) => this.applyPrefix(loc));
+			const command = new DeleteObjectsCommand({
+				Bucket: this.options.bucket,
+				Delete: {
+					Objects: prefixedLocations.map((Key) => ({ Key })),
+					Quiet: false
+				}
+			});
+			const result = await this.client.send(command);
+			const results = [];
+			for (const deleted of result.Deleted || []) if (deleted.Key) results.push({
+				location: deleted.Key,
+				deleted: true
+			});
+			for (const error of result.Errors || []) if (error.Key) results.push({
+				location: error.Key,
+				deleted: false,
+				error: error.Message || "Unknown error"
+			});
+			return results;
+		}, "deleteMany");
+	}
+	/**
+	* Delete directory (recursively deletes all objects with matching prefix)
+	*
+	* S3/R2 doesn't have true directories - only key prefixes.
+	* This method lists all objects with the prefix and deletes them in batches.
+	*
+	* @param directoryPath - Directory prefix to delete
+	* @returns true when all objects are deleted
+	*/
+	async deleteDirectory(directoryPath) {
+		directoryPath = this.applyPrefix(directoryPath);
+		const prefix = directoryPath.endsWith("/") ? directoryPath : `${directoryPath}/`;
+		let hasMore = true;
+		while (hasMore) {
+			const objects = await this.list(prefix, {
+				limit: 1e3,
+				recursive: true
+			});
+			if (objects.length === 0) break;
+			const filePaths = objects.filter((obj) => !obj.isDirectory).map((obj) => obj.path);
+			if (filePaths.length === 0) break;
+			await this.deleteMany(filePaths);
+			hasMore = objects.length >= 1e3;
+		}
+		return true;
+	}
+	/**
+	* Check if file exists
+	*/
+	async exists(location) {
+		try {
+			const { HeadObjectCommand } = S3Client;
+			location = this.applyPrefix(location);
+			const command = new HeadObjectCommand({
+				Bucket: this.options.bucket,
+				Key: location
+			});
+			await this.client.send(command);
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	/**
+	* Get a temporary presigned URL (alias for getPresignedUrl)
+	*/
+	async temporaryUrl(location, expiresIn = 3600) {
+		return this.getPresignedUrl(location, { expiresIn });
+	}
+	/**
+	* Get presigned URL for downloading
+	*/
+	async getPresignedUrl(location, options) {
+		return this.withRetry(async () => {
+			const { GetObjectCommand } = S3Client;
+			const { getSignedUrl } = S3Presigner;
+			location = this.applyPrefix(location);
+			const command = new GetObjectCommand({
+				Bucket: this.options.bucket,
+				Key: location
+			});
+			return getSignedUrl(this.client, command, { expiresIn: options?.expiresIn || 3600 });
+		}, "getPresignedUrl");
+	}
+	/**
+	* Get presigned URL for uploading
+	*/
+	async getPresignedUploadUrl(location, options) {
+		return this.withRetry(async () => {
+			const { PutObjectCommand } = S3Client;
+			const { getSignedUrl } = S3Presigner;
+			location = this.applyPrefix(location);
+			const command = new PutObjectCommand({
+				Bucket: this.options.bucket,
+				Key: location,
+				ContentType: options?.contentType,
+				Metadata: options?.metadata
+			});
+			return getSignedUrl(this.client, command, { expiresIn: options?.expiresIn || 3600 });
+		}, "getPresignedUploadUrl");
+	}
+	/**
+	* Get file info/metadata without downloading
+	*/
+	async metadata(location) {
+		return this.withRetry(async () => {
+			const { HeadObjectCommand } = S3Client;
+			location = this.applyPrefix(location);
+			const command = new HeadObjectCommand({
+				Bucket: this.options.bucket,
+				Key: location
+			});
+			const result = await this.client.send(command);
+			const name = location.split("/").pop() || "";
+			return {
+				path: location,
+				name,
+				size: result.ContentLength || 0,
+				isDirectory: false,
+				lastModified: result.LastModified,
+				mimeType: result.ContentType || this.guessMimeType(location),
+				etag: result.ETag,
+				storageClass: result.StorageClass
+			};
+		}, "metadata");
+	}
+	/**
+	* Get file size in bytes (shortcut for metadata().size)
+	*/
+	async size(location) {
+		return (await this.metadata(location)).size;
+	}
+	/**
+	* Copy file to a new location
+	*/
+	async copy(from, to) {
+		return this.withRetry(async () => {
+			const { CopyObjectCommand, HeadObjectCommand } = S3Client;
+			from = this.applyPrefix(from);
+			to = this.applyPrefix(to);
+			const command = new CopyObjectCommand({
+				Bucket: this.options.bucket,
+				CopySource: `${this.options.bucket}/${from}`,
+				Key: to
+			});
+			const result = await this.client.send(command);
+			const headCommand = new HeadObjectCommand({
+				Bucket: this.options.bucket,
+				Key: to
+			});
+			const headResult = await this.client.send(headCommand);
+			return {
+				path: to,
+				url: this.url(to),
+				size: headResult.ContentLength || 0,
+				hash: headResult.ETag?.replace(/"/g, "") || "",
+				mimeType: headResult.ContentType || this.guessMimeType(to),
+				driver: this.name,
+				bucket: this.options.bucket,
+				region: this.options.region,
+				etag: result.CopyObjectResult?.ETag,
+				versionId: result.VersionId
+			};
+		}, "copy");
+	}
+	/**
+	* Move file to a new location
+	*/
+	async move(from, to) {
+		const file = await this.copy(from, to);
+		await this.delete(from);
+		return file;
+	}
+	/**
+	* List files in a directory
+	*/
+	async list(directory, options) {
+		return this.withRetry(async () => {
+			const { ListObjectsV2Command } = S3Client;
+			directory = this.applyPrefix(directory);
+			const command = new ListObjectsV2Command({
+				Bucket: this.options.bucket,
+				Prefix: directory,
+				MaxKeys: options?.limit,
+				ContinuationToken: options?.cursor,
+				Delimiter: options?.recursive ? void 0 : "/"
+			});
+			const result = await this.client.send(command);
+			const files = [];
+			for (const object of result.Contents || []) {
+				if (!object.Key) continue;
+				files.push({
+					path: object.Key,
+					name: object.Key.split("/").pop() || "",
+					size: object.Size || 0,
+					isDirectory: false,
+					lastModified: object.LastModified,
+					etag: object.ETag,
+					storageClass: object.StorageClass
+				});
+			}
+			for (const prefix of result.CommonPrefixes || []) {
+				if (!prefix.Prefix) continue;
+				files.push({
+					path: prefix.Prefix,
+					name: prefix.Prefix.split("/").filter(Boolean).pop() || "",
+					size: 0,
+					isDirectory: true
+				});
+			}
+			return files;
+		}, "list");
+	}
+	/**
+	* Get bucket name
+	*/
+	getBucket() {
+		return this.options.bucket;
+	}
+	/**
+	* Get region
+	*/
+	getRegion() {
+		return this.options.region;
+	}
+	/**
+	* Set storage class (e.g., STANDARD, GLACIER, etc.)
+	*/
+	async setStorageClass(location, storageClass) {
+		return this.withRetry(async () => {
+			const { CopyObjectCommand } = S3Client;
+			location = this.applyPrefix(location);
+			const command = new CopyObjectCommand({
+				Bucket: this.options.bucket,
+				CopySource: `${this.options.bucket}/${location}`,
+				Key: location,
+				StorageClass: storageClass,
+				MetadataDirective: "COPY"
+			});
+			await this.client.send(command);
+		}, "setStorageClass");
+	}
+	/**
+	* Set file visibility (public or private)
+	*/
+	async setVisibility(location, visibility) {
+		return this.withRetry(async () => {
+			const { PutObjectAclCommand } = S3Client;
+			location = this.applyPrefix(location);
+			const command = new PutObjectAclCommand({
+				Bucket: this.options.bucket,
+				Key: location,
+				ACL: visibility === "public" ? "public-read" : "private"
+			});
+			await this.client.send(command);
+		}, "setVisibility");
+	}
+	/**
+	* Get file visibility
+	*/
+	async getVisibility(location) {
+		return this.withRetry(async () => {
+			const { GetObjectAclCommand } = S3Client;
+			location = this.applyPrefix(location);
+			const command = new GetObjectAclCommand({
+				Bucket: this.options.bucket,
+				Key: location
+			});
+			return (await this.client.send(command)).Grants?.some((grant) => grant.Grantee?.URI === "http://acs.amazonaws.com/groups/global/AllUsers" && grant.Permission === "READ") ? "public" : "private";
+		}, "getVisibility");
+	}
+	/**
+	* Calculate SHA-256 hash
+	*/
+	calculateHash(buffer) {
+		return crypto.createHash("sha256").update(new Uint8Array(buffer)).digest("hex");
+	}
+	/**
+	* Guess MIME type from file extension
+	*/
+	guessMimeType(location) {
+		return getMimeType(location);
+	}
+};
+
+//#endregion
+export { CloudDriver, loadS3 };
+//# sourceMappingURL=cloud-driver.mjs.map

package/esm/storage/drivers/cloud-driver.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-driver.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/storage/drivers/cloud-driver.ts"],"sourcesContent":["import crypto from \"crypto\";\nimport type { Readable } from \"stream\";\nimport { storageDriverContext } from \"../context/storage-driver-context\";\nimport type {\n  CloudStorageDriverContract,\n  CloudStorageDriverOptions,\n  CloudStorageFileData,\n  DeleteManyResult,\n  FileVisibility,\n  ListOptions,\n  PresignedOptions,\n  PresignedUploadOptions,\n  PutOptions,\n  StorageDriverType,\n  StorageFileInfo,\n} from \"../types\";\nimport { getMimeType } from \"../utils/mime\";\n\n// ============================================================\n// Lazy-loaded S3 SDK Types\n// ============================================================\n\n/**\n * Cached S3 SDK modules (loaded once, reused)\n */\nlet S3Client: typeof import(\"@aws-sdk/client-s3\");\nlet S3Storage: typeof import(\"@aws-sdk/lib-storage\");\nlet S3Presigner: typeof import(\"@aws-sdk/s3-request-presigner\");\n\nlet isModuleExists: boolean | null = null;\n\n/**\n * Installation instructions for S3 SDK packages\n */\nconst S3_INSTALL_INSTRUCTIONS = `\nCloud storage requires the AWS S3 SDK packages.\nInstall them with:\n\n  npm install @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner\n\nOr with your preferred package manager:\n\n  pnpm add @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner\n  yarn add @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner\n`.trim();\n\n/**\n * Atomic initialization promise to handle concurrent calls to loadS3\n */\nlet initializationPromise: Promise<void> | null = null;\n\n/**\n * Load S3 modules lazily\n *\n * @example\n * await loadS3();\n * if (isModuleExists) {\n *   // Safe to use S3Client, S3Storage, S3Presigner\n * }\n */\nexport async function loadS3(): Promise<void> {\n  // If already successfully loaded, no need to do anything\n  if (isModuleExists === true) return;\n\n  // If currently loading, return the existing promise so the caller waits\n  if (initializationPromise) return initializationPromise;\n\n  initializationPromise = (async () => {\n    try {\n      // Use Promise.all to load modules in parallel for efficiency\n      const [client, storage, presigner] = await Promise.all([\n        import(\"@aws-sdk/client-s3\"),\n        import(\"@aws-sdk/lib-storage\"),\n        import(\"@aws-sdk/s3-request-presigner\"),\n      ]);\n\n      S3Client = client;\n      S3Storage = storage;\n      S3Presigner = presigner;\n\n      isModuleExists = true;\n    } catch {\n      // Mark as failed if any import fails (usually means packages aren't installed)\n      isModuleExists = false;\n    }\n  })();\n\n  return initializationPromise;\n}\n\nloadS3();\n\n// ============================================================\n// CloudDriver Base Class\n// ============================================================\n\n/**\n * Base abstract class for all S3-compatible cloud storage drivers\n *\n * This class contains all shared logic for S3-compatible storage services\n * including AWS S3, Cloudflare R2, DigitalOcean Spaces, and others.\n *\n * **Important:** S3 SDK packages are lazy-loaded on first use.\n * Users must install them separately:\n * ```\n * npm install @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner\n * ```\n *\n * Subclasses must implement:\n * - `name`: Driver identifier (e.g., \"s3\", \"r2\", \"spaces\")\n * - `url()`: Returns the public URL for a file (provider-specific format)\n */\nexport abstract class CloudDriver<\n  TOptions extends Partial<CloudStorageDriverOptions> = CloudStorageDriverOptions,\n> implements CloudStorageDriverContract {\n  /**\n   * S3-compatible client (lazy-loaded)\n   */\n  protected client!: InstanceType<typeof import(\"@aws-sdk/client-s3\").S3Client>;\n\n  /**\n   * Retry configuration\n   */\n  protected retryConfig: {\n    maxRetries: number;\n    initialDelayMs: number;\n    maxDelayMs: number;\n    backoffMultiplier: number;\n  };\n\n  public constructor(public options: TOptions) {\n    if (!isModuleExists) {\n      throw new Error(S3_INSTALL_INSTRUCTIONS);\n    }\n\n    this.client = new S3Client.S3Client({\n      region: this.options.region!,\n      credentials: {\n        accessKeyId: this.options.accessKeyId!,\n        secretAccessKey: this.options.secretAccessKey!,\n      },\n      ...(this.getEndpoint() && { endpoint: this.getEndpoint() }),\n    });\n\n    // Initialize retry configuration\n    this.retryConfig = {\n      maxRetries: this.options.retry?.maxRetries ?? 3,\n      initialDelayMs: this.options.retry?.initialDelayMs ?? 1000,\n      maxDelayMs: this.options.retry?.maxDelayMs ?? 10000,\n      backoffMultiplier: this.options.retry?.backoffMultiplier ?? 2,\n    };\n  }\n\n  /**\n   * Driver name identifier\n   */\n  public abstract readonly name: StorageDriverType;\n\n  /**\n   * Get public URL for file\n   * Must be implemented by subclasses with provider-specific format\n   */\n  public abstract url(location: string): string;\n\n  /**\n   * Get endpoint URL\n   * Can be overridden by subclasses for provider-specific endpoints\n   */\n  protected getEndpoint(): string | undefined {\n    return this.options.endpoint;\n  }\n\n  // ============================================================\n  // Helper Methods\n  // ============================================================\n\n  /**\n   * Apply prefix to location path\n   *\n   * Priority: context prefix > driver options prefix > no prefix\n   * This allows multi-tenant scenarios where context overrides driver config.\n   *\n   * @param location - Original location path\n   * @returns Location with prefix applied if one exists\n   */\n  public applyPrefix(location: string): string {\n    // Check context prefix first (highest priority)\n    const contextPrefix = storageDriverContext.getPrefix();\n    const prefix = contextPrefix || this.options.prefix;\n\n    if (!prefix) {\n      return location;\n    }\n\n    const cleanPrefix = prefix.replace(/\\/+$/, \"\");\n    const cleanLocation = location.replace(/^\\/+/, \"\");\n\n    // Avoid double-prefixing\n    if (cleanLocation.startsWith(cleanPrefix + \"/\") || cleanLocation === cleanPrefix) {\n      return cleanLocation;\n    }\n\n    return `${cleanPrefix}/${cleanLocation}`;\n  }\n\n  /**\n   * Normalize storage path (remove double slashes, sanitize)\n   * @internal\n   */\n  protected normalizePath(path: string): string {\n    return path\n      .replace(/\\/+/g, \"/\") // Remove multiple slashes\n      .replace(/^\\//, \"\") // Remove leading slash\n      .trim();\n  }\n\n  /**\n   * Execute an operation with retry logic\n   *\n   * Retries on transient errors with exponential backoff.\n   *\n   * @param operation - Async operation to execute\n   * @param operationName - Name for logging\n   * @returns Result of the operation\n   * @internal\n   */\n  protected async withRetry<T>(\n    operation: () => Promise<T>,\n    operationName: string = \"operation\",\n  ): Promise<T> {\n    const { maxRetries, initialDelayMs, backoffMultiplier, maxDelayMs } = this.retryConfig;\n\n    let lastError: Error | undefined;\n\n    for (let attempt = 0; attempt < maxRetries; attempt++) {\n      try {\n        return await operation();\n      } catch (error) {\n        lastError = error as Error;\n\n        // Don't retry on the last attempt\n        if (attempt === maxRetries - 1) {\n          break;\n        }\n\n        // Check if error is retryable\n        if (!this.isRetryableError(error)) {\n          throw error; // Non-retryable error, fail immediately\n        }\n\n        // Calculate delay with exponential backoff\n        const delayMs = Math.min(initialDelayMs * Math.pow(backoffMultiplier, attempt), maxDelayMs);\n\n        // Wait before retrying\n        await new Promise((resolve) => setTimeout(resolve, delayMs));\n      }\n    }\n\n    throw new Error(`${operationName} failed after ${maxRetries} attempts: ${lastError?.message}`);\n  }\n\n  /**\n   * Check if an error is retryable\n   *\n   * Retries on:\n   * - Network errors\n   * - 5xx server errors\n   * - Rate limiting (429)\n   * - Timeout errors\n   *\n   * Does NOT retry on:\n   * - 4xx client errors (except 429)\n   * - Authentication errors\n   * - Not found errors\n   *\n   * @param error - Error to check\n   * @returns true if error is retryable\n   * @internal\n   */\n  protected isRetryableError(error: any): boolean {\n    // Network errors\n    if (error.code === \"ECONNRESET\" || error.code === \"ETIMEDOUT\" || error.code === \"ENOTFOUND\") {\n      return true;\n    }\n\n    // S3 SDK errors\n    if (error.name === \"NetworkingError\" || error.name === \"TimeoutError\") {\n      return true;\n    }\n\n    // HTTP status codes\n    const statusCode = error.$metadata?.httpStatusCode || error.statusCode;\n    if (statusCode) {\n      // 5xx server errors are retryable\n      if (statusCode >= 500 && statusCode < 600) {\n        return true;\n      }\n\n      // 429 Too Many Requests is retryable\n      if (statusCode === 429) {\n        return true;\n      }\n    }\n\n    return false;\n  }\n\n  // ============================================================\n  // Core File Operations\n  // ============================================================\n\n  /**\n   * Put file to cloud storage\n   */\n  public async put(\n    file: Buffer,\n    location: string,\n    options?: PutOptions,\n  ): Promise<CloudStorageFileData> {\n    return this.withRetry(async () => {\n      const { PutObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const hash = this.calculateHash(file);\n      const mimeType = options?.mimeType || this.guessMimeType(location);\n\n      const command = new PutObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n        Body: file,\n        ContentType: mimeType,\n        CacheControl: options?.cacheControl,\n        ContentDisposition: options?.contentDisposition,\n        Metadata: options?.metadata,\n        ACL: options?.visibility === \"public\" ? \"public-read\" : undefined,\n      });\n\n      const result = await this.client.send(command);\n\n      return {\n        path: location,\n        url: this.url(location),\n        size: file.length,\n        hash,\n        mimeType,\n        driver: this.name,\n        bucket: this.options.bucket!,\n        region: this.options.region!,\n        etag: result.ETag,\n        versionId: result.VersionId,\n      };\n    }, \"put\");\n  }\n\n  /**\n   * Put file from a readable stream (for large files)\n   * Uses S3 multipart upload for efficient streaming\n   */\n  public async putStream(\n    stream: Readable,\n    location: string,\n    options?: PutOptions,\n  ): Promise<CloudStorageFileData> {\n    return this.withRetry(async () => {\n      const { Upload } = S3Storage;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const mimeType = options?.mimeType || this.guessMimeType(location);\n\n      const upload = new Upload({\n        client: this.client,\n        params: {\n          Bucket: this.options.bucket,\n          Key: location,\n          Body: stream,\n          ContentType: mimeType,\n          CacheControl: options?.cacheControl,\n          ContentDisposition: options?.contentDisposition,\n          Metadata: options?.metadata,\n          ACL: options?.visibility === \"public\" ? \"public-read\" : undefined,\n        },\n      });\n\n      const result = await upload.done();\n\n      // Get file info for size and hash\n      const info = await this.metadata(location);\n\n      return {\n        path: location,\n        url: this.url(location),\n        size: info.size,\n        hash: info.etag?.replace(/\"/g, \"\") || \"\",\n        mimeType,\n        driver: this.name,\n        bucket: this.options.bucket!,\n        region: this.options.region!,\n        etag: result.ETag,\n        versionId: result.VersionId,\n      };\n    }, \"putStream\");\n  }\n\n  /**\n   * Get file contents as Buffer\n   */\n  public async get(location: string): Promise<Buffer> {\n    return this.withRetry(async () => {\n      const { GetObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new GetObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      const result = await this.client.send(command);\n\n      if (!result.Body) {\n        throw new Error(`File not found: ${location}`);\n      }\n\n      return Buffer.from(await result.Body.transformToByteArray());\n    }, \"get\");\n  }\n\n  /**\n   * Get file as a readable stream (for large files)\n   */\n  public async getStream(location: string): Promise<Readable> {\n    return this.withRetry(async () => {\n      const { GetObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new GetObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      const result = await this.client.send(command);\n\n      if (!result.Body) {\n        throw new Error(`File not found: ${location}`);\n      }\n\n      return result.Body as Readable;\n    }, \"getStream\");\n  }\n\n  /**\n   * Delete a file\n   */\n  public async delete(location: string): Promise<boolean> {\n    return this.withRetry(async () => {\n      const { DeleteObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new DeleteObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      await this.client.send(command);\n\n      return true;\n    }, \"delete\");\n  }\n\n  /**\n   * Delete multiple files at once (uses batch delete for efficiency)\n   */\n  public async deleteMany(locations: string[]): Promise<DeleteManyResult[]> {\n    if (locations.length === 0) {\n      return [];\n    }\n\n    return this.withRetry(async () => {\n      const { DeleteObjectsCommand } = S3Client;\n\n      // Apply storage prefix to all locations\n      const prefixedLocations = locations.map((loc) => this.applyPrefix(loc));\n\n      const command = new DeleteObjectsCommand({\n        Bucket: this.options.bucket,\n        Delete: {\n          Objects: prefixedLocations.map((Key) => ({ Key })),\n          Quiet: false,\n        },\n      });\n\n      const result = await this.client.send(command);\n      const results: DeleteManyResult[] = [];\n\n      // Process successful deletes\n      for (const deleted of result.Deleted || []) {\n        if (deleted.Key) {\n          results.push({ location: deleted.Key, deleted: true });\n        }\n      }\n\n      // Process errors\n      for (const error of result.Errors || []) {\n        if (error.Key) {\n          results.push({\n            location: error.Key,\n            deleted: false,\n            error: error.Message || \"Unknown error\",\n          });\n        }\n      }\n\n      return results;\n    }, \"deleteMany\");\n  }\n\n  /**\n   * Delete directory (recursively deletes all objects with matching prefix)\n   *\n   * S3/R2 doesn't have true directories - only key prefixes.\n   * This method lists all objects with the prefix and deletes them in batches.\n   *\n   * @param directoryPath - Directory prefix to delete\n   * @returns true when all objects are deleted\n   */\n  public async deleteDirectory(directoryPath: string): Promise<boolean> {\n    // Apply storage prefix\n    directoryPath = this.applyPrefix(directoryPath);\n\n    // Ensure directory path ends with / for proper prefix matching\n    const prefix = directoryPath.endsWith(\"/\") ? directoryPath : `${directoryPath}/`;\n\n    let hasMore = true;\n\n    while (hasMore) {\n      // List up to 1000 objects (S3/R2 max per request)\n      const objects = await this.list(prefix, {\n        limit: 1000,\n        recursive: true,\n      });\n\n      if (objects.length === 0) {\n        break;\n      }\n\n      // Filter out directories (we only delete files)\n      const filePaths = objects.filter((obj) => !obj.isDirectory).map((obj) => obj.path);\n\n      if (filePaths.length === 0) {\n        break;\n      }\n\n      // Delete batch (deleteMany already has prefix applied, so paths already have it)\n      // Note: We pass the paths as-is since they already include the prefix from list()\n      const results = await this.deleteMany(filePaths);\n\n      // Continue if we got full batch (might be more)\n      hasMore = objects.length >= 1000;\n    }\n\n    return true;\n  }\n\n  /**\n   * Check if file exists\n   */\n  public async exists(location: string): Promise<boolean> {\n    // No retry for exists - it should be fast and failure means non-existent\n    try {\n      const { HeadObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new HeadObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      await this.client.send(command);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  // ============================================================\n  // URL Operations\n  // ============================================================\n\n  /**\n   * Get a temporary presigned URL (alias for getPresignedUrl)\n   */\n  public async temporaryUrl(location: string, expiresIn = 3600): Promise<string> {\n    return this.getPresignedUrl(location, { expiresIn });\n  }\n\n  /**\n   * Get presigned URL for downloading\n   */\n  public async getPresignedUrl(location: string, options?: PresignedOptions): Promise<string> {\n    return this.withRetry(async () => {\n      const { GetObjectCommand } = S3Client;\n      const { getSignedUrl } = S3Presigner;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new GetObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      return getSignedUrl(this.client, command, {\n        expiresIn: options?.expiresIn || 3600,\n      });\n    }, \"getPresignedUrl\");\n  }\n\n  /**\n   * Get presigned URL for uploading\n   */\n  public async getPresignedUploadUrl(\n    location: string,\n    options?: PresignedUploadOptions,\n  ): Promise<string> {\n    return this.withRetry(async () => {\n      const { PutObjectCommand } = S3Client;\n      const { getSignedUrl } = S3Presigner;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new PutObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n        ContentType: options?.contentType,\n        Metadata: options?.metadata,\n      });\n\n      return getSignedUrl(this.client, command, {\n        expiresIn: options?.expiresIn || 3600,\n      });\n    }, \"getPresignedUploadUrl\");\n  }\n\n  // ============================================================\n  // Metadata Operations\n  // ============================================================\n\n  /**\n   * Get file info/metadata without downloading\n   */\n  public async metadata(location: string): Promise<StorageFileInfo> {\n    return this.withRetry(async () => {\n      const { HeadObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new HeadObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      const result = await this.client.send(command);\n      const name = location.split(\"/\").pop() || \"\";\n\n      return {\n        path: location,\n        name,\n        size: result.ContentLength || 0,\n        isDirectory: false,\n        lastModified: result.LastModified,\n        mimeType: result.ContentType || this.guessMimeType(location),\n        etag: result.ETag,\n        storageClass: result.StorageClass,\n      };\n    }, \"metadata\");\n  }\n\n  /**\n   * Get file size in bytes (shortcut for metadata().size)\n   */\n  public async size(location: string): Promise<number> {\n    const info = await this.metadata(location);\n    return info.size;\n  }\n\n  // ============================================================\n  // File Operations\n  // ============================================================\n\n  /**\n   * Copy file to a new location\n   */\n  public async copy(from: string, to: string): Promise<CloudStorageFileData> {\n    return this.withRetry(async () => {\n      const { CopyObjectCommand, HeadObjectCommand } = S3Client;\n\n      // Apply storage prefix to both paths\n      from = this.applyPrefix(from);\n      to = this.applyPrefix(to);\n\n      const command = new CopyObjectCommand({\n        Bucket: this.options.bucket,\n        CopySource: `${this.options.bucket}/${from}`,\n        Key: to,\n      });\n\n      const result = await this.client.send(command);\n\n      // Get file metadata\n      const headCommand = new HeadObjectCommand({\n        Bucket: this.options.bucket,\n        Key: to,\n      });\n      const headResult = await this.client.send(headCommand);\n\n      return {\n        path: to,\n        url: this.url(to),\n        size: headResult.ContentLength || 0,\n        hash: headResult.ETag?.replace(/\"/g, \"\") || \"\",\n        mimeType: headResult.ContentType || this.guessMimeType(to),\n        driver: this.name,\n        bucket: this.options.bucket!,\n        region: this.options.region!,\n        etag: result.CopyObjectResult?.ETag,\n        versionId: result.VersionId,\n      };\n    }, \"copy\");\n  }\n\n  /**\n   * Move file to a new location\n   */\n  public async move(from: string, to: string): Promise<CloudStorageFileData> {\n    const file = await this.copy(from, to);\n    await this.delete(from);\n    return file;\n  }\n\n  /**\n   * List files in a directory\n   */\n  public async list(directory: string, options?: ListOptions): Promise<StorageFileInfo[]> {\n    return this.withRetry(async () => {\n      const { ListObjectsV2Command } = S3Client;\n\n      // Apply storage prefix\n      directory = this.applyPrefix(directory);\n\n      const command = new ListObjectsV2Command({\n        Bucket: this.options.bucket,\n        Prefix: directory,\n        MaxKeys: options?.limit,\n        ContinuationToken: options?.cursor,\n        Delimiter: options?.recursive ? undefined : \"/\",\n      });\n\n      const result = await this.client.send(command);\n      const files: StorageFileInfo[] = [];\n\n      // Add files\n      for (const object of result.Contents || []) {\n        if (!object.Key) continue;\n\n        files.push({\n          path: object.Key,\n          name: object.Key.split(\"/\").pop() || \"\",\n          size: object.Size || 0,\n          isDirectory: false,\n          lastModified: object.LastModified,\n          etag: object.ETag,\n          storageClass: object.StorageClass,\n        });\n      }\n\n      // Add directories\n      for (const prefix of result.CommonPrefixes || []) {\n        if (!prefix.Prefix) continue;\n\n        files.push({\n          path: prefix.Prefix,\n          name: prefix.Prefix.split(\"/\").filter(Boolean).pop() || \"\",\n          size: 0,\n          isDirectory: true,\n        });\n      }\n\n      return files;\n    }, \"list\");\n  }\n\n  // ============================================================\n  // Cloud-Specific Operations\n  // ============================================================\n\n  /**\n   * Get bucket name\n   */\n  public getBucket(): string {\n    return this.options.bucket!;\n  }\n\n  /**\n   * Get region\n   */\n  public getRegion(): string {\n    return this.options.region!;\n  }\n\n  /**\n   * Set storage class (e.g., STANDARD, GLACIER, etc.)\n   */\n  public async setStorageClass(location: string, storageClass: string): Promise<void> {\n    return this.withRetry(async () => {\n      const { CopyObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new CopyObjectCommand({\n        Bucket: this.options.bucket,\n        CopySource: `${this.options.bucket}/${location}`,\n        Key: location,\n        StorageClass: storageClass as any,\n        MetadataDirective: \"COPY\",\n      });\n\n      await this.client.send(command);\n    }, \"setStorageClass\");\n  }\n\n  /**\n   * Set file visibility (public or private)\n   */\n  public async setVisibility(location: string, visibility: FileVisibility): Promise<void> {\n    return this.withRetry(async () => {\n      const { PutObjectAclCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new PutObjectAclCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n        ACL: visibility === \"public\" ? \"public-read\" : \"private\",\n      });\n\n      await this.client.send(command);\n    }, \"setVisibility\");\n  }\n\n  /**\n   * Get file visibility\n   */\n  public async getVisibility(location: string): Promise<FileVisibility> {\n    return this.withRetry(async () => {\n      const { GetObjectAclCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new GetObjectAclCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      const result = await this.client.send(command);\n\n      // Check if any grant allows public read\n      const hasPublicRead = result.Grants?.some(\n        (grant) =>\n          grant.Grantee?.URI === \"http://acs.amazonaws.com/groups/global/AllUsers\" &&\n          grant.Permission === \"READ\",\n      );\n\n      return hasPublicRead ? \"public\" : \"private\";\n    }, \"getVisibility\");\n  }\n\n  // ============================================================\n  // Utilities\n  // ============================================================\n\n  /**\n   * Calculate SHA-256 hash\n   */\n  protected calculateHash(buffer: Buffer): string {\n    return crypto.createHash(\"sha256\").update(new Uint8Array(buffer)).digest(\"hex\");\n  }\n\n  /**\n   * Guess MIME type from file extension\n   */\n  protected guessMimeType(location: string): string {\n    return getMimeType(location);\n  }\n}\n"],"mappings":"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"}