@kumix/storage 0.1.1 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cloudinary.d.ts +5 -5
- package/dist/cloudinary.d.ts.map +1 -1
- package/dist/cloudinary.js +83 -46
- package/dist/cloudinary.js.map +1 -1
- package/dist/helpers.d.ts.map +1 -1
- package/dist/helpers.js +2 -2
- package/dist/helpers.js.map +1 -1
- package/dist/s3.js +101 -47
- package/dist/s3.js.map +1 -1
- package/package.json +3 -3
package/dist/s3.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"s3.js","names":[],"sources":["../src/operations/file-operations.ts","../src/operations/folder-operations.ts","../src/providers/s3.ts","../src/services/s3.ts","../src/s3.ts"],"sourcesContent":["/**\n * S3 file operations implementation\n * Provides comprehensive file management operations for S3-compatible storage providers\n */\n\nimport {\n CopyObjectCommand,\n DeleteObjectCommand,\n DeleteObjectsCommand,\n GetObjectCommand,\n HeadObjectCommand,\n ListObjectsV2Command,\n PutObjectCommand,\n type S3Client,\n} from \"@aws-sdk/client-s3\";\nimport { getSignedUrl } from \"@aws-sdk/s3-request-presigner\";\n\nimport { buildPublicUrl, getMimeType } from \"../helpers\";\nimport type {\n BatchDeleteOptions,\n BatchDeleteResult,\n CopyOptions,\n CopyResult,\n DeleteOptions,\n DeleteResult,\n DownloadOptions,\n DownloadResult,\n DuplicateOptions,\n DuplicateResult,\n ExistsResult,\n FileInfo,\n ListOptions,\n ListResult,\n MoveOptions,\n MoveResult,\n PresignedUrlOptions,\n PresignedUrlResult,\n S3Config,\n UploadOptions,\n UploadResult,\n} from \"../types\";\n\n/**\n * S3 file operations implementation\n * Handles all file-related operations for S3-compatible storage providers\n * @internal\n */\nexport class FileOperations {\n constructor(\n private client: S3Client,\n private config: S3Config,\n ) {}\n\n async upload(options: UploadOptions): Promise<UploadResult> {\n try {\n const contentType = options.contentType || getMimeType(options.key);\n\n const command = new PutObjectCommand({\n Bucket: this.config.bucket,\n Key: options.key,\n Body: options.file,\n ContentType: contentType,\n Metadata: options.metadata,\n CacheControl: options.cacheControl,\n ContentDisposition: options.contentDisposition,\n // R2, MinIO, and Supabase reject canned ACLs. Only apply an ACL when the\n // caller explicitly set one AND the provider supports it (aws/digitalocean).\n ...(options.acl &&\n (this.config.provider === \"aws\" || this.config.provider === \"digitalocean\")\n ? { ACL: options.acl }\n : {}),\n Expires: options.expires,\n });\n\n const result = await this.client.send(command);\n\n const publicUrl = this.getPublicUrl(options.key);\n\n return {\n success: true,\n key: options.key,\n url: publicUrl,\n publicUrl,\n etag: result.ETag?.replace(/\"/g, \"\"),\n size:\n typeof options.file === \"string\"\n ? Buffer.byteLength(options.file, \"utf8\")\n : options.file.length,\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Upload failed\",\n };\n }\n }\n\n async download(options: DownloadOptions): Promise<DownloadResult> {\n try {\n const command = new GetObjectCommand({\n Bucket: this.config.bucket,\n Key: options.key,\n Range: options.range,\n });\n\n const result = await this.client.send(command);\n\n if (!result.Body) {\n return {\n success: false,\n error: \"No data received\",\n };\n }\n\n // Convert stream to buffer\n const chunks: Uint8Array[] = [];\n const reader = result.Body.transformToWebStream().getReader();\n\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n chunks.push(value);\n }\n\n const data = Buffer.concat(chunks);\n\n return {\n success: true,\n content: data, // Main content field\n data, // Alias for backward compatibility\n contentType: result.ContentType,\n contentLength: result.ContentLength,\n lastModified: result.LastModified,\n etag: result.ETag?.replace(/\"/g, \"\"),\n metadata: result.Metadata,\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Download failed\",\n };\n }\n }\n\n async delete(options: DeleteOptions): Promise<DeleteResult> {\n try {\n const command = new DeleteObjectCommand({\n Bucket: this.config.bucket,\n Key: options.key,\n });\n\n await this.client.send(command);\n\n return {\n success: true,\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Delete failed\",\n };\n }\n }\n\n async batchDelete(options: BatchDeleteOptions): Promise<BatchDeleteResult> {\n try {\n const command = new DeleteObjectsCommand({\n Bucket: this.config.bucket,\n Delete: {\n Objects: options.keys.map((key) => ({ Key: key })),\n Quiet: false,\n },\n });\n\n const result = await this.client.send(command);\n\n const deleted = result.Deleted?.map((obj) => obj.Key).filter(Boolean) as string[];\n const errors =\n result.Errors?.map((err) => ({\n key: err.Key || \"\",\n error: err.Message || \"Unknown error\",\n })) || [];\n\n return {\n // Partial failures: S3 returns `result.Errors` for objects it could not\n // delete. Treat the operation as failed when any per-key error exists\n // so callers using `if (result.success)` don't silently miss that some\n // objects remain. The full per-key breakdown is still on `errors`/`deleted`.\n success: errors.length === 0,\n deleted,\n errors: errors.length > 0 ? errors : undefined,\n };\n } catch (error) {\n return {\n success: false,\n errors: options.keys.map((key) => ({\n key,\n error: error instanceof Error ? error.message : \"Batch delete failed\",\n })),\n };\n }\n }\n\n async list(options: ListOptions = {}): Promise<ListResult> {\n try {\n const command = new ListObjectsV2Command({\n Bucket: this.config.bucket,\n Prefix: options.prefix,\n Delimiter: options.delimiter,\n MaxKeys: options.maxKeys,\n ContinuationToken: options.continuationToken,\n });\n\n const result = await this.client.send(command);\n\n const files: FileInfo[] =\n result.Contents?.map((obj) => ({\n key: obj.Key!,\n size: obj.Size || 0,\n lastModified: obj.LastModified || new Date(),\n etag: obj.ETag?.replace(/\"/g, \"\") || \"\",\n contentType: getMimeType(obj.Key!),\n })) || [];\n\n return {\n success: true,\n files,\n isTruncated: result.IsTruncated,\n nextContinuationToken: result.NextContinuationToken,\n commonPrefixes: result.CommonPrefixes?.map((cp) => cp.Prefix!),\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"List failed\",\n };\n }\n }\n\n async exists(key: string): Promise<ExistsResult> {\n try {\n const command = new HeadObjectCommand({\n Bucket: this.config.bucket,\n Key: key,\n });\n\n const result = await this.client.send(command);\n\n return {\n exists: true,\n fileInfo: {\n key,\n size: result.ContentLength || 0,\n lastModified: result.LastModified || new Date(),\n etag: result.ETag?.replace(/\"/g, \"\") || \"\",\n contentType: result.ContentType,\n metadata: result.Metadata,\n },\n };\n } catch (error) {\n if (error instanceof Error && error.name === \"NotFound\") {\n return { exists: false };\n }\n\n return {\n exists: false,\n error: error instanceof Error ? error.message : \"Check existence failed\",\n };\n }\n }\n\n async copy(options: CopyOptions): Promise<CopyResult> {\n try {\n const command = new CopyObjectCommand({\n Bucket: this.config.bucket,\n // CopySource must be percent-encoded; keys containing `?`, `&`, `=`,\n // `+`, spaces, or non-ASCII would otherwise break the copy request.\n // Encode each path segment so `/` separators survive while reserved\n // chars within a segment are escaped.\n CopySource: `${this.config.bucket}/${options.sourceKey.split(\"/\").map(encodeURIComponent).join(\"/\")}`,\n Key: options.destinationKey,\n Metadata: options.metadata,\n MetadataDirective: options.metadataDirective || \"COPY\",\n });\n\n const result = await this.client.send(command);\n\n return {\n success: true,\n etag: result.CopyObjectResult?.ETag?.replace(/\"/g, \"\"),\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Copy failed\",\n };\n }\n }\n\n async move(options: MoveOptions): Promise<MoveResult> {\n try {\n // First copy the object\n const copyResult = await this.copy({\n sourceKey: options.sourceKey,\n destinationKey: options.destinationKey,\n metadata: options.metadata,\n metadataDirective: options.metadataDirective,\n });\n\n if (!copyResult.success) {\n return {\n success: false,\n error: copyResult.error || \"Move failed during copy operation\",\n };\n }\n\n // Then delete the source object\n const deleteResult = await this.delete({ key: options.sourceKey });\n\n if (!deleteResult.success) {\n return {\n success: false,\n error: deleteResult.error || \"Move failed during delete operation\",\n };\n }\n\n return {\n success: true,\n etag: copyResult.etag,\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Move failed\",\n };\n }\n }\n\n async duplicate(options: DuplicateOptions): Promise<DuplicateResult> {\n // Duplicate is just an alias for copy\n return this.copy(options);\n }\n\n async getPresignedUrl(options: PresignedUrlOptions): Promise<PresignedUrlResult> {\n try {\n const expiresIn = options.expiresIn || 3600; // 1 hour default\n\n let command: GetObjectCommand | PutObjectCommand;\n if (options.operation === \"get\") {\n command = new GetObjectCommand({\n Bucket: this.config.bucket,\n Key: options.key,\n });\n } else {\n command = new PutObjectCommand({\n Bucket: this.config.bucket,\n Key: options.key,\n ContentType: options.contentType,\n });\n }\n\n const url = await getSignedUrl(this.client, command, {\n expiresIn,\n });\n\n return {\n success: true,\n url,\n expiresAt: new Date(Date.now() + expiresIn * 1000),\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Presigned URL generation failed\",\n };\n }\n }\n\n getPublicUrl(key: string): string {\n const isCloudflare = this.config.provider === \"cloudflare-r2\";\n const isSupabase = this.config.provider === \"supabase\";\n\n if (this.config.publicUrl) {\n return buildPublicUrl(\n this.config.publicUrl,\n isCloudflare ? \"\" : this.config.bucket,\n key,\n isSupabase,\n );\n }\n\n if (this.config.endpoint) {\n return buildPublicUrl(this.config.endpoint, this.config.bucket, key, isSupabase);\n }\n\n // MinIO is self-hosted and does not expose objects at the AWS URL format —\n // synthesizing one would just produce a 404 the caller can't distinguish\n // from a real miss. Surface the misconfiguration explicitly instead.\n if (this.config.provider === \"minio\") {\n throw new Error(\n \"MinIO public URL could not be built: set `publicUrl` (or `endpoint`) on the S3 config \" +\n \"to a publicly reachable base, since MinIO has no default public host.\",\n );\n }\n\n // Default AWS / DigitalOcean Spaces URL format\n return `https://${this.config.bucket}.s3.${this.config.region}.amazonaws.com/${key}`;\n }\n}\n","/**\n * S3 folder operations implementation\n * Provides comprehensive folder management operations for S3-compatible storage providers\n */\n\nimport {\n type _Object,\n CopyObjectCommand,\n DeleteObjectsCommand,\n ListObjectsV2Command,\n PutObjectCommand,\n type S3Client,\n} from \"@aws-sdk/client-s3\";\n\nimport { getMimeType } from \"../helpers\";\nimport type {\n CopyFolderOptions,\n CopyFolderResult,\n CreateFolderOptions,\n CreateFolderResult,\n DeleteFolderOptions,\n DeleteFolderResult,\n FileInfo,\n FolderExistsResult,\n FolderInfo,\n ListFoldersOptions,\n ListFoldersResult,\n RenameFolderOptions,\n RenameFolderResult,\n S3Config,\n} from \"../types\";\n\n/** S3 DeleteObjectsCommand allows at most 1000 keys per request */\nconst S3_DELETE_MAX_KEYS = 1000;\n\n/**\n * List ALL objects under a prefix, following pagination (handles >1000 keys)\n */\nasync function listAllObjects(\n client: S3Client,\n bucket: string,\n prefix: string,\n): Promise<_Object[]> {\n const objects: _Object[] = [];\n let continuationToken: string | undefined;\n do {\n const command = new ListObjectsV2Command({\n Bucket: bucket,\n Prefix: prefix,\n ContinuationToken: continuationToken,\n });\n const result = await client.send(command);\n if (result.Contents) {\n objects.push(...result.Contents);\n }\n continuationToken = result.IsTruncated ? result.NextContinuationToken : undefined;\n } while (continuationToken);\n return objects;\n}\n\n/** Delete objects in batches of 1000 (S3 hard limit per DeleteObjectsCommand) */\nasync function deleteObjectsBatched(\n client: S3Client,\n bucket: string,\n keys: string[],\n): Promise<string[]> {\n const deleted: string[] = [];\n for (let i = 0; i < keys.length; i += S3_DELETE_MAX_KEYS) {\n const batch = keys.slice(i, i + S3_DELETE_MAX_KEYS);\n const command = new DeleteObjectsCommand({\n Bucket: bucket,\n Delete: {\n Objects: batch.map((key) => ({ Key: key })),\n Quiet: true,\n },\n });\n const result = await client.send(command);\n if (result.Deleted) {\n for (const obj of result.Deleted) {\n if (obj.Key) deleted.push(obj.Key);\n }\n }\n }\n return deleted;\n}\n\n/**\n * S3 folder operations implementation\n * Handles all folder-related operations for S3-compatible storage providers\n * @internal\n */\nexport class FolderOperations {\n constructor(\n private client: S3Client,\n private config: S3Config,\n ) {}\n\n async createFolder(options: CreateFolderOptions): Promise<CreateFolderResult> {\n try {\n // Ensure path ends with /\n const folderPath = options.path.endsWith(\"/\") ? options.path : `${options.path}/`;\n\n // Create a placeholder object to represent the folder\n const command = new PutObjectCommand({\n Bucket: this.config.bucket,\n Key: folderPath,\n Body: \"\",\n ContentType: \"application/x-directory\",\n });\n\n await this.client.send(command);\n\n return {\n success: true,\n path: folderPath,\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Create folder failed\",\n };\n }\n }\n\n async deleteFolder(options: DeleteFolderOptions): Promise<DeleteFolderResult> {\n try {\n // Ensure path ends with /\n const folderPath = options.path.endsWith(\"/\") ? options.path : `${options.path}/`;\n\n if (options.recursive) {\n // List all objects with the folder prefix (handles >1000 keys)\n const allObjects = await listAllObjects(this.client, this.config.bucket, folderPath);\n\n if (allObjects.length === 0) {\n return {\n success: true,\n deletedFiles: [],\n };\n }\n\n // Delete all objects in batches of 1000\n const keys = allObjects.map((obj) => obj.Key!).filter(Boolean);\n const deletedFiles = await deleteObjectsBatched(this.client, this.config.bucket, keys);\n\n return {\n success: true,\n deletedFiles,\n };\n } else {\n // Just delete the folder placeholder\n const deleteCommand = new DeleteObjectsCommand({\n Bucket: this.config.bucket,\n Delete: {\n Objects: [{ Key: folderPath }],\n Quiet: false,\n },\n });\n\n await this.client.send(deleteCommand);\n\n return {\n success: true,\n deletedFiles: [folderPath],\n };\n }\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Delete folder failed\",\n };\n }\n }\n\n async listFolders(options: ListFoldersOptions = {}): Promise<ListFoldersResult> {\n try {\n const command = new ListObjectsV2Command({\n Bucket: this.config.bucket,\n Prefix: options.prefix,\n Delimiter: options.delimiter || \"/\",\n MaxKeys: options.maxKeys,\n ContinuationToken: options.continuationToken,\n });\n\n const result = await this.client.send(command);\n\n // Parse folders from common prefixes\n const folders: FolderInfo[] =\n result.CommonPrefixes?.map((cp) => {\n const path = cp.Prefix!;\n const name = path.split(\"/\").filter(Boolean).pop() || \"\";\n\n return {\n name,\n path,\n };\n }) || [];\n\n // Parse files from contents\n const files: FileInfo[] =\n result.Contents?.map((obj) => ({\n key: obj.Key!,\n size: obj.Size || 0,\n lastModified: obj.LastModified || new Date(),\n etag: obj.ETag?.replace(/\"/g, \"\") || \"\",\n contentType: getMimeType(obj.Key!),\n })) || [];\n\n return {\n success: true,\n folders,\n files,\n isTruncated: result.IsTruncated,\n nextContinuationToken: result.NextContinuationToken,\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"List folders failed\",\n };\n }\n }\n\n async folderExists(path: string): Promise<FolderExistsResult> {\n try {\n // Ensure path ends with /\n const folderPath = path.endsWith(\"/\") ? path : `${path}/`;\n\n const command = new ListObjectsV2Command({\n Bucket: this.config.bucket,\n Prefix: folderPath,\n MaxKeys: 1,\n });\n\n const result = await this.client.send(command);\n\n const exists =\n (result.Contents && result.Contents.length > 0) ||\n (result.CommonPrefixes && result.CommonPrefixes.length > 0);\n\n if (exists) {\n const name = folderPath.split(\"/\").filter(Boolean).pop() || \"\";\n\n return {\n exists: true,\n folderInfo: {\n name,\n path: folderPath,\n },\n };\n }\n\n return { exists: false };\n } catch (error) {\n return {\n exists: false,\n error: error instanceof Error ? error.message : \"Check folder existence failed\",\n };\n }\n }\n\n async renameFolder(options: RenameFolderOptions): Promise<RenameFolderResult> {\n try {\n // This is essentially a copy + delete operation for all files in the folder\n const oldPath = options.oldPath.endsWith(\"/\") ? options.oldPath : `${options.oldPath}/`;\n const newPath = options.newPath.endsWith(\"/\") ? options.newPath : `${options.newPath}/`;\n\n // List all objects in the old folder (handles >1000 keys)\n const allObjects = await listAllObjects(this.client, this.config.bucket, oldPath);\n\n if (allObjects.length === 0) {\n return {\n success: true,\n movedFiles: [],\n };\n }\n\n const movedFiles: string[] = [];\n\n // Copy each file to new location\n for (const obj of allObjects) {\n const oldKey = obj.Key!;\n // Anchor the prefix substitution to the start of the key. `String.replace`\n // replaces the first occurrence *anywhere*, which over-replaces when the\n // path segment also appears mid-key.\n const newKey = newPath + oldKey.slice(oldPath.length);\n\n // Copy object using CopyObjectCommand\n const copyCommand = new CopyObjectCommand({\n Bucket: this.config.bucket,\n Key: newKey,\n // CopySource must be percent-encoded; keys with special chars break the\n // copy request otherwise.\n CopySource: `${this.config.bucket}/${oldKey.split(\"/\").map(encodeURIComponent).join(\"/\")}`,\n });\n\n await this.client.send(copyCommand);\n movedFiles.push(newKey);\n }\n\n // Delete old folder contents in batches\n const oldKeys = allObjects.map((obj) => obj.Key!).filter(Boolean);\n await deleteObjectsBatched(this.client, this.config.bucket, oldKeys);\n\n return {\n success: true,\n movedFiles,\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Rename folder failed\",\n };\n }\n }\n\n async copyFolder(options: CopyFolderOptions): Promise<CopyFolderResult> {\n try {\n const sourcePath = options.sourcePath.endsWith(\"/\")\n ? options.sourcePath\n : `${options.sourcePath}/`;\n const destPath = options.destinationPath.endsWith(\"/\")\n ? options.destinationPath\n : `${options.destinationPath}/`;\n\n // List all objects in the source folder (handles >1000 keys).\n // Non-recursive filtering is applied per-object below (the list call is\n // identical either way — the previous ternary was dead code).\n const allObjects = await listAllObjects(this.client, this.config.bucket, sourcePath);\n\n if (allObjects.length === 0) {\n return {\n success: true,\n copiedFiles: [],\n };\n }\n\n const copiedFiles: string[] = [];\n\n // Copy each file to new location\n for (const obj of allObjects) {\n const sourceKey = obj.Key!;\n // When not recursive, skip nested objects (files in subfolders)\n if (!options.recursive) {\n const relativeKey = sourceKey.slice(sourcePath.length);\n if (relativeKey.includes(\"/\")) continue;\n }\n // Anchor the prefix substitution to the start of the key.\n const destKey = destPath + sourceKey.slice(sourcePath.length);\n\n // Copy object using CopyObjectCommand\n const copyCommand = new CopyObjectCommand({\n Bucket: this.config.bucket,\n Key: destKey,\n // CopySource must be percent-encoded.\n CopySource: `${this.config.bucket}/${sourceKey.split(\"/\").map(encodeURIComponent).join(\"/\")}`,\n });\n\n await this.client.send(copyCommand);\n copiedFiles.push(destKey);\n }\n\n return {\n success: true,\n copiedFiles,\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Copy folder failed\",\n };\n }\n }\n}\n","/**\n * S3-compatible storage provider implementation\n * Provides cloud storage operations using AWS S3 SDK for S3-compatible services\n */\n\nimport { S3Client } from \"@aws-sdk/client-s3\";\n\nimport { FileOperations } from \"../operations/file-operations\";\nimport { FolderOperations } from \"../operations/folder-operations\";\nimport type {\n BatchDeleteOptions,\n BatchDeleteResult,\n CopyFolderOptions,\n CopyFolderResult,\n CopyOptions,\n CopyResult,\n CreateFolderOptions,\n CreateFolderResult,\n DeleteFolderOptions,\n DeleteFolderResult,\n DeleteOptions,\n DeleteResult,\n DownloadOptions,\n DownloadResult,\n DuplicateOptions,\n DuplicateResult,\n ExistsResult,\n FolderExistsResult,\n ListFoldersOptions,\n ListFoldersResult,\n ListOptions,\n ListResult,\n MoveOptions,\n MoveResult,\n PresignedUrlOptions,\n PresignedUrlResult,\n RenameFolderOptions,\n RenameFolderResult,\n S3Config,\n StorageInterface,\n UploadOptions,\n UploadResult,\n} from \"../types\";\n\n/**\n * S3-compatible storage provider\n * Implements StorageInterface for AWS S3 and S3-compatible services\n * @internal\n */\nexport class S3Provider implements StorageInterface {\n private client: S3Client;\n private config: S3Config;\n private fileOps: FileOperations;\n private folderOps: FolderOperations;\n\n constructor(config: S3Config) {\n this.config = config;\n\n this.client = new S3Client({\n region: config.region,\n credentials: {\n accessKeyId: config.accessKeyId,\n secretAccessKey: config.secretAccessKey,\n // Surface STS / temporary credentials when provided. Previously the\n // session token was dropped, breaking AWS STS / SSO / role-chain auth.\n ...(config.sessionToken ? { sessionToken: config.sessionToken } : {}),\n },\n endpoint: config.endpoint,\n forcePathStyle: config.forcePathStyle ?? false,\n });\n\n this.fileOps = new FileOperations(this.client, this.config);\n this.folderOps = new FolderOperations(this.client, this.config);\n }\n\n // File operations\n async upload(options: UploadOptions): Promise<UploadResult> {\n return this.fileOps.upload(options);\n }\n\n async download(options: DownloadOptions): Promise<DownloadResult> {\n return this.fileOps.download(options);\n }\n\n async delete(options: DeleteOptions): Promise<DeleteResult> {\n return this.fileOps.delete(options);\n }\n\n async batchDelete(options: BatchDeleteOptions): Promise<BatchDeleteResult> {\n return this.fileOps.batchDelete(options);\n }\n\n async list(options?: ListOptions): Promise<ListResult> {\n return this.fileOps.list(options);\n }\n\n async exists(key: string): Promise<ExistsResult> {\n return this.fileOps.exists(key);\n }\n\n async copy(options: CopyOptions): Promise<CopyResult> {\n return this.fileOps.copy(options);\n }\n\n async move(options: MoveOptions): Promise<MoveResult> {\n return this.fileOps.move(options);\n }\n\n async duplicate(options: DuplicateOptions): Promise<DuplicateResult> {\n return this.fileOps.duplicate(options);\n }\n\n async getPresignedUrl(options: PresignedUrlOptions): Promise<PresignedUrlResult> {\n return this.fileOps.getPresignedUrl(options);\n }\n\n getPublicUrl(key: string): string {\n return this.fileOps.getPublicUrl(key);\n }\n\n // Folder operations\n async createFolder(options: CreateFolderOptions): Promise<CreateFolderResult> {\n return this.folderOps.createFolder(options);\n }\n\n async deleteFolder(options: DeleteFolderOptions): Promise<DeleteFolderResult> {\n return this.folderOps.deleteFolder(options);\n }\n\n async listFolders(options?: ListFoldersOptions): Promise<ListFoldersResult> {\n return this.folderOps.listFolders(options);\n }\n\n async folderExists(path: string): Promise<FolderExistsResult> {\n return this.folderOps.folderExists(path);\n }\n\n async renameFolder(options: RenameFolderOptions): Promise<RenameFolderResult> {\n return this.folderOps.renameFolder(options);\n }\n\n async copyFolder(options: CopyFolderOptions): Promise<CopyFolderResult> {\n return this.folderOps.copyFolder(options);\n }\n}\n","/**\n * S3 storage service implementation\n * High-level service wrapper for S3-compatible storage operations with convenience methods\n */\n\nimport { loadS3Config } from \"../config\";\nimport { S3Provider } from \"../providers/s3\";\nimport type {\n BatchDeleteOptions,\n BatchDeleteResult,\n CopyFolderOptions,\n CopyFolderResult,\n CopyOptions,\n CopyResult,\n CreateFolderOptions,\n CreateFolderResult,\n DeleteFolderOptions,\n DeleteFolderResult,\n DeleteOptions,\n DeleteResult,\n DownloadOptions,\n DownloadResult,\n DuplicateOptions,\n DuplicateResult,\n ExistsResult,\n FolderExistsResult,\n ListFoldersOptions,\n ListFoldersResult,\n ListOptions,\n ListResult,\n MoveOptions,\n MoveResult,\n PresignedUrlOptions,\n PresignedUrlResult,\n RenameFolderOptions,\n RenameFolderResult,\n S3Config,\n StorageInterface,\n UploadOptions,\n UploadResult,\n} from \"../types\";\n\n/**\n * S3 storage service\n * High-level service for S3-compatible storage operations with convenience methods\n * @public\n */\nexport class S3Service implements StorageInterface {\n private provider: S3Provider;\n private config: S3Config;\n\n constructor();\n constructor(config: S3Config);\n constructor(config?: S3Config) {\n this.config = config || loadS3Config();\n this.provider = this.createProvider(this.config);\n }\n\n private createProvider(config: S3Config): S3Provider {\n switch (config.provider) {\n case \"aws\":\n case \"cloudflare-r2\":\n case \"minio\":\n case \"digitalocean\":\n case \"supabase\":\n case \"custom\":\n return new S3Provider(config);\n default:\n throw new Error(`Unsupported S3 provider: ${config.provider}`);\n }\n }\n\n // Utility methods\n getConfig(): S3Config {\n return { ...this.config };\n }\n\n getBucket(): string {\n return this.config.bucket;\n }\n\n getRegion(): string {\n return this.config.region;\n }\n\n getProvider(): string {\n return this.config.provider;\n }\n\n getPublicUrl(key: string): string {\n return this.provider.getPublicUrl(key);\n }\n\n // File operations\n async upload(options: UploadOptions): Promise<UploadResult> {\n return this.provider.upload(options);\n }\n\n async download(options: DownloadOptions): Promise<DownloadResult> {\n return this.provider.download(options);\n }\n\n async delete(options: DeleteOptions): Promise<DeleteResult> {\n return this.provider.delete(options);\n }\n\n async batchDelete(options: BatchDeleteOptions): Promise<BatchDeleteResult> {\n return this.provider.batchDelete(options);\n }\n\n async list(options?: ListOptions): Promise<ListResult> {\n return this.provider.list(options);\n }\n\n async exists(key: string): Promise<ExistsResult> {\n return this.provider.exists(key);\n }\n\n async copy(options: CopyOptions): Promise<CopyResult> {\n return this.provider.copy(options);\n }\n\n async move(options: MoveOptions): Promise<MoveResult> {\n return this.provider.move(options);\n }\n\n async duplicate(options: DuplicateOptions): Promise<DuplicateResult> {\n return this.provider.duplicate(options);\n }\n\n async getPresignedUrl(options: PresignedUrlOptions): Promise<PresignedUrlResult> {\n return this.provider.getPresignedUrl(options);\n }\n\n // Folder operations\n async createFolder(options: CreateFolderOptions): Promise<CreateFolderResult> {\n return this.provider.createFolder(options);\n }\n\n async deleteFolder(options: DeleteFolderOptions): Promise<DeleteFolderResult> {\n return this.provider.deleteFolder(options);\n }\n\n async listFolders(options?: ListFoldersOptions): Promise<ListFoldersResult> {\n return this.provider.listFolders(options);\n }\n\n async folderExists(path: string): Promise<FolderExistsResult> {\n return this.provider.folderExists(path);\n }\n\n async renameFolder(options: RenameFolderOptions): Promise<RenameFolderResult> {\n return this.provider.renameFolder(options);\n }\n\n async copyFolder(options: CopyFolderOptions): Promise<CopyFolderResult> {\n return this.provider.copyFolder(options);\n }\n\n // Convenience methods\n async uploadFile(\n key: string,\n file: Buffer | Uint8Array | string,\n options?: Partial<UploadOptions>,\n ): Promise<UploadResult> {\n return this.upload({\n key,\n file,\n ...options,\n });\n }\n\n async downloadFile(key: string): Promise<DownloadResult> {\n return this.download({ key });\n }\n\n async deleteFile(key: string): Promise<DeleteResult> {\n return this.delete({ key });\n }\n\n async deleteFiles(keys: string[]): Promise<BatchDeleteResult> {\n return this.batchDelete({ keys });\n }\n\n async listFiles(prefix?: string, maxKeys?: number): Promise<ListResult> {\n return this.list({ prefix, maxKeys });\n }\n\n async fileExists(key: string): Promise<boolean> {\n const result = await this.exists(key);\n return result.exists;\n }\n\n async copyFile(\n sourceKey: string,\n destinationKey: string,\n options?: Partial<CopyOptions>,\n ): Promise<CopyResult> {\n return this.copy({\n sourceKey,\n destinationKey,\n ...options,\n });\n }\n\n async moveFile(\n sourceKey: string,\n destinationKey: string,\n options?: Partial<MoveOptions>,\n ): Promise<MoveResult> {\n return this.move({\n sourceKey,\n destinationKey,\n ...options,\n });\n }\n\n async duplicateFile(\n sourceKey: string,\n destinationKey: string,\n options?: Partial<DuplicateOptions>,\n ): Promise<DuplicateResult> {\n return this.duplicate({\n sourceKey,\n destinationKey,\n ...options,\n });\n }\n\n async renameFile(\n sourceKey: string,\n newKey: string,\n options?: Partial<MoveOptions>,\n ): Promise<MoveResult> {\n return this.moveFile(sourceKey, newKey, options);\n }\n\n async getDownloadUrl(key: string, expiresIn?: number): Promise<PresignedUrlResult> {\n return this.getPresignedUrl({\n key,\n operation: \"get\",\n expiresIn,\n });\n }\n\n async getUploadUrl(\n key: string,\n contentType?: string,\n expiresIn?: number,\n ): Promise<PresignedUrlResult> {\n return this.getPresignedUrl({\n key,\n operation: \"put\",\n contentType,\n expiresIn,\n });\n }\n\n // Folder convenience methods\n async createFolderPath(path: string): Promise<CreateFolderResult> {\n return this.createFolder({ path });\n }\n\n async deleteFolderPath(path: string, recursive = false): Promise<DeleteFolderResult> {\n return this.deleteFolder({ path, recursive });\n }\n\n async folderPathExists(path: string): Promise<boolean> {\n const result = await this.folderExists(path);\n return result.exists;\n }\n\n async renameFolderPath(oldPath: string, newPath: string): Promise<RenameFolderResult> {\n return this.renameFolder({ oldPath, newPath });\n }\n\n async copyFolderPath(\n sourcePath: string,\n destinationPath: string,\n recursive = true,\n ): Promise<CopyFolderResult> {\n return this.copyFolder({ sourcePath, destinationPath, recursive });\n }\n}\n","import type { EnvRecord } from \"./config\";\nimport { loadS3Config } from \"./config\";\nimport { S3Service } from \"./services/s3\";\nimport type { S3Config } from \"./types\";\n\nexport type { EnvRecord } from \"./config\";\n// === SERVICE CLASSES ===\nexport { S3Service } from \"./services/s3\";\n\n// === MAIN FACTORY FUNCTIONS (Primary API) ===\n/**\n * Create S3 service using environment variables or manual configuration\n * @param config Optional S3 configuration. If not provided, loads from environment variables\n * @param env - Optional environment record\n * @returns S3Service instance\n * @throws Error if configuration is invalid or environment variables are missing\n * @public\n *\n * @example\n * ```typescript\n * import { createS3 } from '@kumix/storage/s3';\n *\n * // Using environment variables\n * // Set: KUMIX_S3_PROVIDER=aws, KUMIX_S3_REGION=us-east-1, etc.\n * const s3FromEnv = createS3();\n * await s3FromEnv.uploadFile('test.txt', 'Hello World');\n *\n * // Using manual configuration\n * const s3Manual = createS3({\n * provider: 'aws',\n * region: 'us-east-1',\n * bucket: 'my-bucket',\n * accessKeyId: 'AKIA...',\n * secretAccessKey: 'secret...'\n * });\n *\n * // Cloudflare R2\n * const r2 = createS3({\n * provider: 'cloudflare-r2',\n * region: 'auto',\n * bucket: 'my-r2-bucket',\n * accessKeyId: 'your-r2-key',\n * secretAccessKey: 'your-r2-secret',\n * endpoint: 'https://account-id.r2.cloudflarestorage.com'\n * });\n *\n * // MinIO\n * const minio = createS3({\n * provider: 'minio',\n * region: 'us-east-1',\n * bucket: 'my-minio-bucket',\n * accessKeyId: 'minioadmin',\n * secretAccessKey: 'minioadmin',\n * endpoint: 'http://localhost:9000',\n * forcePathStyle: true\n * });\n * ```\n */\nexport function createS3(): S3Service;\nexport function createS3(config: S3Config): S3Service;\nexport function createS3(config: S3Config, env: EnvRecord): S3Service;\nexport function createS3(config: undefined, env: EnvRecord): S3Service;\nexport function createS3(config?: S3Config, env?: EnvRecord): S3Service {\n if (config) {\n return new S3Service(config);\n }\n // When `config` is omitted, build the config from env. This overload also\n // covers `createS3(undefined, env)` which was previously rejected by the\n // published signatures despite being a valid call.\n const envConfig = loadS3Config(env);\n return new S3Service(envConfig);\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"s3.js","names":[],"sources":["../src/operations/s3-sdk.ts","../src/operations/file-operations.ts","../src/operations/folder-operations.ts","../src/providers/s3.ts","../src/services/s3.ts","../src/s3.ts"],"sourcesContent":["/**\n * Lazy loaders for the optional AWS SDK peer dependencies.\n *\n * `@aws-sdk/client-s3` and `@aws-sdk/s3-request-presigner` are optional peers.\n * Importing them statically would crash module load for consumers who only use\n * the Cloudinary provider (or who import the package's cross-runtime entry).\n * These loaders defer the import until an S3 operation actually runs and cache\n * the resolved modules.\n */\n\ntype S3ClientSdk = typeof import(\"@aws-sdk/client-s3\");\ntype PresignerSdk = typeof import(\"@aws-sdk/s3-request-presigner\");\n\nlet s3SdkPromise: Promise<S3ClientSdk> | undefined;\nlet presignerPromise: Promise<PresignerSdk> | undefined;\n\n/**\n * Dynamically import `@aws-sdk/client-s3`, throwing a clear error when the\n * optional peer dependency is not installed.\n */\nexport async function loadS3Sdk(): Promise<S3ClientSdk> {\n if (!s3SdkPromise) {\n s3SdkPromise = import(\"@aws-sdk/client-s3\").catch(() => {\n throw new Error(\n \"@aws-sdk/client-s3 is not available. Install it to use the S3 storage provider.\",\n );\n });\n }\n return s3SdkPromise;\n}\n\n/**\n * Dynamically import `@aws-sdk/s3-request-presigner`, throwing a clear error\n * when the optional peer dependency is not installed.\n */\nexport async function loadPresigner(): Promise<PresignerSdk> {\n if (!presignerPromise) {\n presignerPromise = import(\"@aws-sdk/s3-request-presigner\").catch(() => {\n throw new Error(\n \"@aws-sdk/s3-request-presigner is not available. Install it to generate presigned URLs.\",\n );\n });\n }\n return presignerPromise;\n}\n","/**\n * S3 file operations implementation\n * Provides comprehensive file management operations for S3-compatible storage providers\n */\n\nimport type { GetObjectCommand, PutObjectCommand, S3Client } from \"@aws-sdk/client-s3\";\n\nimport { buildPublicUrl, getMimeType } from \"../helpers\";\nimport type {\n BatchDeleteOptions,\n BatchDeleteResult,\n CopyOptions,\n CopyResult,\n DeleteOptions,\n DeleteResult,\n DownloadOptions,\n DownloadResult,\n DuplicateOptions,\n DuplicateResult,\n ExistsResult,\n FileInfo,\n ListOptions,\n ListResult,\n MoveOptions,\n MoveResult,\n PresignedUrlOptions,\n PresignedUrlResult,\n S3Config,\n UploadOptions,\n UploadResult,\n} from \"../types\";\nimport { loadPresigner, loadS3Sdk } from \"./s3-sdk\";\n\n/**\n * S3 file operations implementation\n * Handles all file-related operations for S3-compatible storage providers\n * @internal\n */\nexport class FileOperations {\n constructor(\n private client: S3Client,\n private config: S3Config,\n ) {}\n\n async upload(options: UploadOptions): Promise<UploadResult> {\n try {\n const { PutObjectCommand } = await loadS3Sdk();\n const contentType = options.contentType || getMimeType(options.key);\n\n const command = new PutObjectCommand({\n Bucket: this.config.bucket,\n Key: options.key,\n Body: options.file,\n ContentType: contentType,\n Metadata: options.metadata,\n CacheControl: options.cacheControl,\n ContentDisposition: options.contentDisposition,\n // R2, MinIO, and Supabase reject canned ACLs. Only apply an ACL when the\n // caller explicitly set one AND the provider supports it (aws/digitalocean).\n ...(options.acl &&\n (this.config.provider === \"aws\" || this.config.provider === \"digitalocean\")\n ? { ACL: options.acl }\n : {}),\n Expires: options.expires,\n });\n\n const result = await this.client.send(command);\n\n const publicUrl = this.getPublicUrl(options.key);\n\n return {\n success: true,\n key: options.key,\n url: publicUrl,\n publicUrl,\n etag: result.ETag?.replace(/\"/g, \"\"),\n size:\n typeof options.file === \"string\"\n ? Buffer.byteLength(options.file, \"utf8\")\n : options.file.length,\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Upload failed\",\n };\n }\n }\n\n async download(options: DownloadOptions): Promise<DownloadResult> {\n try {\n const { GetObjectCommand } = await loadS3Sdk();\n const command = new GetObjectCommand({\n Bucket: this.config.bucket,\n Key: options.key,\n Range: options.range,\n });\n\n const result = await this.client.send(command);\n\n if (!result.Body) {\n return {\n success: false,\n error: \"No data received\",\n };\n }\n\n // Convert stream to buffer\n const chunks: Uint8Array[] = [];\n const reader = result.Body.transformToWebStream().getReader();\n\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n chunks.push(value);\n }\n\n const data = Buffer.concat(chunks);\n\n return {\n success: true,\n content: data, // Main content field\n data, // Alias for backward compatibility\n contentType: result.ContentType,\n contentLength: result.ContentLength,\n lastModified: result.LastModified,\n etag: result.ETag?.replace(/\"/g, \"\"),\n metadata: result.Metadata,\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Download failed\",\n };\n }\n }\n\n async delete(options: DeleteOptions): Promise<DeleteResult> {\n try {\n const { DeleteObjectCommand } = await loadS3Sdk();\n const command = new DeleteObjectCommand({\n Bucket: this.config.bucket,\n Key: options.key,\n });\n\n await this.client.send(command);\n\n return {\n success: true,\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Delete failed\",\n };\n }\n }\n\n async batchDelete(options: BatchDeleteOptions): Promise<BatchDeleteResult> {\n try {\n const { DeleteObjectsCommand } = await loadS3Sdk();\n const command = new DeleteObjectsCommand({\n Bucket: this.config.bucket,\n Delete: {\n Objects: options.keys.map((key) => ({ Key: key })),\n Quiet: false,\n },\n });\n\n const result = await this.client.send(command);\n\n const deleted = result.Deleted?.map((obj) => obj.Key).filter(Boolean) as string[];\n const errors =\n result.Errors?.map((err) => ({\n key: err.Key || \"\",\n error: err.Message || \"Unknown error\",\n })) || [];\n\n return {\n // Partial failures: S3 returns `result.Errors` for objects it could not\n // delete. Treat the operation as failed when any per-key error exists\n // so callers using `if (result.success)` don't silently miss that some\n // objects remain. The full per-key breakdown is still on `errors`/`deleted`.\n success: errors.length === 0,\n deleted,\n errors: errors.length > 0 ? errors : undefined,\n };\n } catch (error) {\n return {\n success: false,\n errors: options.keys.map((key) => ({\n key,\n error: error instanceof Error ? error.message : \"Batch delete failed\",\n })),\n };\n }\n }\n\n async list(options: ListOptions = {}): Promise<ListResult> {\n try {\n const { ListObjectsV2Command } = await loadS3Sdk();\n const command = new ListObjectsV2Command({\n Bucket: this.config.bucket,\n Prefix: options.prefix,\n Delimiter: options.delimiter,\n MaxKeys: options.maxKeys,\n ContinuationToken: options.continuationToken,\n });\n\n const result = await this.client.send(command);\n\n const files: FileInfo[] =\n result.Contents?.map((obj) => ({\n key: obj.Key!,\n size: obj.Size || 0,\n lastModified: obj.LastModified || new Date(),\n etag: obj.ETag?.replace(/\"/g, \"\") || \"\",\n contentType: getMimeType(obj.Key!),\n })) || [];\n\n return {\n success: true,\n files,\n isTruncated: result.IsTruncated,\n nextContinuationToken: result.NextContinuationToken,\n commonPrefixes: result.CommonPrefixes?.map((cp) => cp.Prefix!),\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"List failed\",\n };\n }\n }\n\n async exists(key: string): Promise<ExistsResult> {\n try {\n const { HeadObjectCommand } = await loadS3Sdk();\n const command = new HeadObjectCommand({\n Bucket: this.config.bucket,\n Key: key,\n });\n\n const result = await this.client.send(command);\n\n return {\n exists: true,\n fileInfo: {\n key,\n size: result.ContentLength || 0,\n lastModified: result.LastModified || new Date(),\n etag: result.ETag?.replace(/\"/g, \"\") || \"\",\n contentType: result.ContentType,\n metadata: result.Metadata,\n },\n };\n } catch (error) {\n if (error instanceof Error && error.name === \"NotFound\") {\n return { exists: false };\n }\n\n return {\n exists: false,\n error: error instanceof Error ? error.message : \"Check existence failed\",\n };\n }\n }\n\n async copy(options: CopyOptions): Promise<CopyResult> {\n try {\n const { CopyObjectCommand } = await loadS3Sdk();\n const command = new CopyObjectCommand({\n Bucket: this.config.bucket,\n // CopySource must be percent-encoded; keys containing `?`, `&`, `=`,\n // `+`, spaces, or non-ASCII would otherwise break the copy request.\n // Encode each path segment so `/` separators survive while reserved\n // chars within a segment are escaped.\n CopySource: `${this.config.bucket}/${options.sourceKey.split(\"/\").map(encodeURIComponent).join(\"/\")}`,\n Key: options.destinationKey,\n Metadata: options.metadata,\n MetadataDirective: options.metadataDirective || \"COPY\",\n });\n\n const result = await this.client.send(command);\n\n return {\n success: true,\n etag: result.CopyObjectResult?.ETag?.replace(/\"/g, \"\"),\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Copy failed\",\n };\n }\n }\n\n async move(options: MoveOptions): Promise<MoveResult> {\n try {\n // First copy the object\n const copyResult = await this.copy({\n sourceKey: options.sourceKey,\n destinationKey: options.destinationKey,\n metadata: options.metadata,\n metadataDirective: options.metadataDirective,\n });\n\n if (!copyResult.success) {\n return {\n success: false,\n error: copyResult.error || \"Move failed during copy operation\",\n };\n }\n\n // Then delete the source object\n const deleteResult = await this.delete({ key: options.sourceKey });\n\n if (!deleteResult.success) {\n return {\n success: false,\n error: deleteResult.error || \"Move failed during delete operation\",\n };\n }\n\n return {\n success: true,\n etag: copyResult.etag,\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Move failed\",\n };\n }\n }\n\n async duplicate(options: DuplicateOptions): Promise<DuplicateResult> {\n // Duplicate is just an alias for copy\n return this.copy(options);\n }\n\n async getPresignedUrl(options: PresignedUrlOptions): Promise<PresignedUrlResult> {\n try {\n const { GetObjectCommand, PutObjectCommand } = await loadS3Sdk();\n const { getSignedUrl } = await loadPresigner();\n const expiresIn = options.expiresIn || 3600; // 1 hour default\n\n let command: GetObjectCommand | PutObjectCommand;\n if (options.operation === \"get\") {\n command = new GetObjectCommand({\n Bucket: this.config.bucket,\n Key: options.key,\n });\n } else {\n command = new PutObjectCommand({\n Bucket: this.config.bucket,\n Key: options.key,\n ContentType: options.contentType,\n });\n }\n\n const url = await getSignedUrl(this.client, command, {\n expiresIn,\n });\n\n return {\n success: true,\n url,\n expiresAt: new Date(Date.now() + expiresIn * 1000),\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Presigned URL generation failed\",\n };\n }\n }\n\n getPublicUrl(key: string): string {\n const isCloudflare = this.config.provider === \"cloudflare-r2\";\n const isSupabase = this.config.provider === \"supabase\";\n\n if (this.config.publicUrl) {\n return buildPublicUrl(\n this.config.publicUrl,\n isCloudflare ? \"\" : this.config.bucket,\n key,\n isSupabase,\n );\n }\n\n if (this.config.endpoint) {\n return buildPublicUrl(this.config.endpoint, this.config.bucket, key, isSupabase);\n }\n\n // MinIO is self-hosted and does not expose objects at the AWS URL format —\n // synthesizing one would just produce a 404 the caller can't distinguish\n // from a real miss. Surface the misconfiguration explicitly instead.\n if (this.config.provider === \"minio\") {\n throw new Error(\n \"MinIO public URL could not be built: set `publicUrl` (or `endpoint`) on the S3 config \" +\n \"to a publicly reachable base, since MinIO has no default public host.\",\n );\n }\n\n // Default AWS / DigitalOcean Spaces URL format. Encode each key segment so\n // keys containing spaces/special chars yield valid URLs (matching the\n // percent-encoding used by `copy`/`renameFolder`), while `/` separators are\n // preserved.\n const encodedKey = key.split(\"/\").map(encodeURIComponent).join(\"/\");\n return `https://${this.config.bucket}.s3.${this.config.region}.amazonaws.com/${encodedKey}`;\n }\n}\n","/**\n * S3 folder operations implementation\n * Provides comprehensive folder management operations for S3-compatible storage providers\n */\n\nimport type { _Object, S3Client } from \"@aws-sdk/client-s3\";\n\nimport { getMimeType } from \"../helpers\";\nimport type {\n CopyFolderOptions,\n CopyFolderResult,\n CreateFolderOptions,\n CreateFolderResult,\n DeleteFolderOptions,\n DeleteFolderResult,\n FileInfo,\n FolderExistsResult,\n FolderInfo,\n ListFoldersOptions,\n ListFoldersResult,\n RenameFolderOptions,\n RenameFolderResult,\n S3Config,\n} from \"../types\";\nimport { loadS3Sdk } from \"./s3-sdk\";\n\n/** S3 DeleteObjectsCommand allows at most 1000 keys per request */\nconst S3_DELETE_MAX_KEYS = 1000;\n\n/**\n * List ALL objects under a prefix, following pagination (handles >1000 keys)\n */\nasync function listAllObjects(\n client: S3Client,\n bucket: string,\n prefix: string,\n): Promise<_Object[]> {\n const { ListObjectsV2Command } = await loadS3Sdk();\n const objects: _Object[] = [];\n let continuationToken: string | undefined;\n do {\n const command = new ListObjectsV2Command({\n Bucket: bucket,\n Prefix: prefix,\n ContinuationToken: continuationToken,\n });\n const result = await client.send(command);\n if (result.Contents) {\n objects.push(...result.Contents);\n }\n continuationToken = result.IsTruncated ? result.NextContinuationToken : undefined;\n } while (continuationToken);\n return objects;\n}\n\n/** Delete objects in batches of 1000 (S3 hard limit per DeleteObjectsCommand) */\nasync function deleteObjectsBatched(\n client: S3Client,\n bucket: string,\n keys: string[],\n): Promise<string[]> {\n const { DeleteObjectsCommand } = await loadS3Sdk();\n const deleted: string[] = [];\n for (let i = 0; i < keys.length; i += S3_DELETE_MAX_KEYS) {\n const batch = keys.slice(i, i + S3_DELETE_MAX_KEYS);\n const command = new DeleteObjectsCommand({\n Bucket: bucket,\n Delete: {\n Objects: batch.map((key) => ({ Key: key })),\n Quiet: true,\n },\n });\n const result = await client.send(command);\n if (result.Deleted) {\n for (const obj of result.Deleted) {\n if (obj.Key) deleted.push(obj.Key);\n }\n }\n }\n return deleted;\n}\n\n/**\n * S3 folder operations implementation\n * Handles all folder-related operations for S3-compatible storage providers\n * @internal\n */\nexport class FolderOperations {\n constructor(\n private client: S3Client,\n private config: S3Config,\n ) {}\n\n async createFolder(options: CreateFolderOptions): Promise<CreateFolderResult> {\n try {\n const { PutObjectCommand } = await loadS3Sdk();\n // Ensure path ends with /\n const folderPath = options.path.endsWith(\"/\") ? options.path : `${options.path}/`;\n\n // Create a placeholder object to represent the folder\n const command = new PutObjectCommand({\n Bucket: this.config.bucket,\n Key: folderPath,\n Body: \"\",\n ContentType: \"application/x-directory\",\n });\n\n await this.client.send(command);\n\n return {\n success: true,\n path: folderPath,\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Create folder failed\",\n };\n }\n }\n\n async deleteFolder(options: DeleteFolderOptions): Promise<DeleteFolderResult> {\n try {\n const { DeleteObjectsCommand } = await loadS3Sdk();\n // Ensure path ends with /\n const folderPath = options.path.endsWith(\"/\") ? options.path : `${options.path}/`;\n\n if (options.recursive) {\n // List all objects with the folder prefix (handles >1000 keys)\n const allObjects = await listAllObjects(this.client, this.config.bucket, folderPath);\n\n if (allObjects.length === 0) {\n return {\n success: true,\n deletedFiles: [],\n };\n }\n\n // Delete all objects in batches of 1000\n const keys = allObjects.map((obj) => obj.Key!).filter(Boolean);\n const deletedFiles = await deleteObjectsBatched(this.client, this.config.bucket, keys);\n\n return {\n success: true,\n deletedFiles,\n };\n } else {\n // Just delete the folder placeholder\n const deleteCommand = new DeleteObjectsCommand({\n Bucket: this.config.bucket,\n Delete: {\n Objects: [{ Key: folderPath }],\n Quiet: false,\n },\n });\n\n await this.client.send(deleteCommand);\n\n return {\n success: true,\n deletedFiles: [folderPath],\n };\n }\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Delete folder failed\",\n };\n }\n }\n\n async listFolders(options: ListFoldersOptions = {}): Promise<ListFoldersResult> {\n try {\n const { ListObjectsV2Command } = await loadS3Sdk();\n const command = new ListObjectsV2Command({\n Bucket: this.config.bucket,\n Prefix: options.prefix,\n Delimiter: options.delimiter || \"/\",\n MaxKeys: options.maxKeys,\n ContinuationToken: options.continuationToken,\n });\n\n const result = await this.client.send(command);\n\n // Parse folders from common prefixes\n const folders: FolderInfo[] =\n result.CommonPrefixes?.map((cp) => {\n const path = cp.Prefix!;\n const name = path.split(\"/\").filter(Boolean).pop() || \"\";\n\n return {\n name,\n path,\n };\n }) || [];\n\n // Parse files from contents\n const files: FileInfo[] =\n result.Contents?.map((obj) => ({\n key: obj.Key!,\n size: obj.Size || 0,\n lastModified: obj.LastModified || new Date(),\n etag: obj.ETag?.replace(/\"/g, \"\") || \"\",\n contentType: getMimeType(obj.Key!),\n })) || [];\n\n return {\n success: true,\n folders,\n files,\n isTruncated: result.IsTruncated,\n nextContinuationToken: result.NextContinuationToken,\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"List folders failed\",\n };\n }\n }\n\n async folderExists(path: string): Promise<FolderExistsResult> {\n try {\n const { ListObjectsV2Command } = await loadS3Sdk();\n // Ensure path ends with /\n const folderPath = path.endsWith(\"/\") ? path : `${path}/`;\n\n const command = new ListObjectsV2Command({\n Bucket: this.config.bucket,\n Prefix: folderPath,\n MaxKeys: 1,\n });\n\n const result = await this.client.send(command);\n\n const exists =\n (result.Contents && result.Contents.length > 0) ||\n (result.CommonPrefixes && result.CommonPrefixes.length > 0);\n\n if (exists) {\n const name = folderPath.split(\"/\").filter(Boolean).pop() || \"\";\n\n return {\n exists: true,\n folderInfo: {\n name,\n path: folderPath,\n },\n };\n }\n\n return { exists: false };\n } catch (error) {\n return {\n exists: false,\n error: error instanceof Error ? error.message : \"Check folder existence failed\",\n };\n }\n }\n\n async renameFolder(options: RenameFolderOptions): Promise<RenameFolderResult> {\n try {\n const { CopyObjectCommand } = await loadS3Sdk();\n // This is essentially a copy + delete operation for all files in the folder\n const oldPath = options.oldPath.endsWith(\"/\") ? options.oldPath : `${options.oldPath}/`;\n const newPath = options.newPath.endsWith(\"/\") ? options.newPath : `${options.newPath}/`;\n\n // List all objects in the old folder (handles >1000 keys)\n const allObjects = await listAllObjects(this.client, this.config.bucket, oldPath);\n\n if (allObjects.length === 0) {\n return {\n success: true,\n movedFiles: [],\n };\n }\n\n const movedFiles: string[] = [];\n\n // Copy each file to new location\n for (const obj of allObjects) {\n const oldKey = obj.Key!;\n // Anchor the prefix substitution to the start of the key. `String.replace`\n // replaces the first occurrence *anywhere*, which over-replaces when the\n // path segment also appears mid-key.\n const newKey = newPath + oldKey.slice(oldPath.length);\n\n // Copy object using CopyObjectCommand\n const copyCommand = new CopyObjectCommand({\n Bucket: this.config.bucket,\n Key: newKey,\n // CopySource must be percent-encoded; keys with special chars break the\n // copy request otherwise.\n CopySource: `${this.config.bucket}/${oldKey.split(\"/\").map(encodeURIComponent).join(\"/\")}`,\n });\n\n await this.client.send(copyCommand);\n movedFiles.push(newKey);\n }\n\n // Delete old folder contents in batches\n const oldKeys = allObjects.map((obj) => obj.Key!).filter(Boolean);\n await deleteObjectsBatched(this.client, this.config.bucket, oldKeys);\n\n return {\n success: true,\n movedFiles,\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Rename folder failed\",\n };\n }\n }\n\n async copyFolder(options: CopyFolderOptions): Promise<CopyFolderResult> {\n try {\n const { CopyObjectCommand } = await loadS3Sdk();\n // Default to recursive when unspecified, matching `S3Service.copyFolderPath`\n // (which defaults `recursive = true`). Previously an omitted `recursive`\n // silently dropped nested subfolders when calling `copyFolder` directly.\n const recursive = options.recursive ?? true;\n const sourcePath = options.sourcePath.endsWith(\"/\")\n ? options.sourcePath\n : `${options.sourcePath}/`;\n const destPath = options.destinationPath.endsWith(\"/\")\n ? options.destinationPath\n : `${options.destinationPath}/`;\n\n // List all objects in the source folder (handles >1000 keys).\n // Non-recursive filtering is applied per-object below (the list call is\n // identical either way — the previous ternary was dead code).\n const allObjects = await listAllObjects(this.client, this.config.bucket, sourcePath);\n\n if (allObjects.length === 0) {\n return {\n success: true,\n copiedFiles: [],\n };\n }\n\n const copiedFiles: string[] = [];\n\n // Copy each file to new location\n for (const obj of allObjects) {\n const sourceKey = obj.Key!;\n // When not recursive, skip nested objects (files in subfolders)\n if (!recursive) {\n const relativeKey = sourceKey.slice(sourcePath.length);\n if (relativeKey.includes(\"/\")) continue;\n }\n // Anchor the prefix substitution to the start of the key.\n const destKey = destPath + sourceKey.slice(sourcePath.length);\n\n // Copy object using CopyObjectCommand\n const copyCommand = new CopyObjectCommand({\n Bucket: this.config.bucket,\n Key: destKey,\n // CopySource must be percent-encoded.\n CopySource: `${this.config.bucket}/${sourceKey.split(\"/\").map(encodeURIComponent).join(\"/\")}`,\n });\n\n await this.client.send(copyCommand);\n copiedFiles.push(destKey);\n }\n\n return {\n success: true,\n copiedFiles,\n };\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Copy folder failed\",\n };\n }\n }\n}\n","/**\n * S3-compatible storage provider implementation\n * Provides cloud storage operations using AWS S3 SDK for S3-compatible services\n */\n\nimport type { S3Client } from \"@aws-sdk/client-s3\";\n\nimport { FileOperations } from \"../operations/file-operations\";\nimport { FolderOperations } from \"../operations/folder-operations\";\nimport { loadS3Sdk } from \"../operations/s3-sdk\";\nimport type {\n BatchDeleteOptions,\n BatchDeleteResult,\n CopyFolderOptions,\n CopyFolderResult,\n CopyOptions,\n CopyResult,\n CreateFolderOptions,\n CreateFolderResult,\n DeleteFolderOptions,\n DeleteFolderResult,\n DeleteOptions,\n DeleteResult,\n DownloadOptions,\n DownloadResult,\n DuplicateOptions,\n DuplicateResult,\n ExistsResult,\n FolderExistsResult,\n ListFoldersOptions,\n ListFoldersResult,\n ListOptions,\n ListResult,\n MoveOptions,\n MoveResult,\n PresignedUrlOptions,\n PresignedUrlResult,\n RenameFolderOptions,\n RenameFolderResult,\n S3Config,\n StorageInterface,\n UploadOptions,\n UploadResult,\n} from \"../types\";\n\n/**\n * S3-compatible storage provider\n * Implements StorageInterface for AWS S3 and S3-compatible services\n * @internal\n */\nexport class S3Provider implements StorageInterface {\n private config: S3Config;\n private _client: S3Client | null = null;\n private _fileOps: FileOperations | null = null;\n private _folderOps: FolderOperations | null = null;\n\n constructor(config: S3Config) {\n this.config = config;\n }\n\n /**\n * Lazily construct the S3 client and operation helpers. The `@aws-sdk/client-s3`\n * dependency is imported dynamically so the optional peer isn't required at\n * module load — consumers using only Cloudinary can import the package without\n * installing it.\n */\n private async getFileOps(): Promise<FileOperations> {\n if (!this._fileOps) {\n const client = await this.getClient();\n this._fileOps = new FileOperations(client, this.config);\n }\n return this._fileOps;\n }\n\n private async getFolderOps(): Promise<FolderOperations> {\n if (!this._folderOps) {\n const client = await this.getClient();\n this._folderOps = new FolderOperations(client, this.config);\n }\n return this._folderOps;\n }\n\n private async getClient(): Promise<S3Client> {\n if (!this._client) {\n const { S3Client } = await loadS3Sdk();\n this._client = new S3Client({\n region: this.config.region,\n credentials: {\n accessKeyId: this.config.accessKeyId,\n secretAccessKey: this.config.secretAccessKey,\n // Surface STS / temporary credentials when provided. Previously the\n // session token was dropped, breaking AWS STS / SSO / role-chain auth.\n ...(this.config.sessionToken ? { sessionToken: this.config.sessionToken } : {}),\n },\n endpoint: this.config.endpoint,\n forcePathStyle: this.config.forcePathStyle ?? false,\n });\n }\n return this._client;\n }\n\n // File operations\n async upload(options: UploadOptions): Promise<UploadResult> {\n return (await this.getFileOps()).upload(options);\n }\n\n async download(options: DownloadOptions): Promise<DownloadResult> {\n return (await this.getFileOps()).download(options);\n }\n\n async delete(options: DeleteOptions): Promise<DeleteResult> {\n return (await this.getFileOps()).delete(options);\n }\n\n async batchDelete(options: BatchDeleteOptions): Promise<BatchDeleteResult> {\n return (await this.getFileOps()).batchDelete(options);\n }\n\n async list(options?: ListOptions): Promise<ListResult> {\n return (await this.getFileOps()).list(options);\n }\n\n async exists(key: string): Promise<ExistsResult> {\n return (await this.getFileOps()).exists(key);\n }\n\n async copy(options: CopyOptions): Promise<CopyResult> {\n return (await this.getFileOps()).copy(options);\n }\n\n async move(options: MoveOptions): Promise<MoveResult> {\n return (await this.getFileOps()).move(options);\n }\n\n async duplicate(options: DuplicateOptions): Promise<DuplicateResult> {\n return (await this.getFileOps()).duplicate(options);\n }\n\n async getPresignedUrl(options: PresignedUrlOptions): Promise<PresignedUrlResult> {\n return (await this.getFileOps()).getPresignedUrl(options);\n }\n\n getPublicUrl(key: string): string {\n // `getPublicUrl` is synchronous and does not touch the S3 client, so it must\n // not force-load the SDK. Reuse an already-initialized `_fileOps` when\n // present; otherwise build a throwaway (NOT cached, so it can't poison the\n // lazy client init that a later async operation performs).\n if (this._fileOps) {\n return this._fileOps.getPublicUrl(key);\n }\n return new FileOperations(null as unknown as S3Client, this.config).getPublicUrl(key);\n }\n\n // Folder operations\n async createFolder(options: CreateFolderOptions): Promise<CreateFolderResult> {\n return (await this.getFolderOps()).createFolder(options);\n }\n\n async deleteFolder(options: DeleteFolderOptions): Promise<DeleteFolderResult> {\n return (await this.getFolderOps()).deleteFolder(options);\n }\n\n async listFolders(options?: ListFoldersOptions): Promise<ListFoldersResult> {\n return (await this.getFolderOps()).listFolders(options);\n }\n\n async folderExists(path: string): Promise<FolderExistsResult> {\n return (await this.getFolderOps()).folderExists(path);\n }\n\n async renameFolder(options: RenameFolderOptions): Promise<RenameFolderResult> {\n return (await this.getFolderOps()).renameFolder(options);\n }\n\n async copyFolder(options: CopyFolderOptions): Promise<CopyFolderResult> {\n return (await this.getFolderOps()).copyFolder(options);\n }\n}\n","/**\n * S3 storage service implementation\n * High-level service wrapper for S3-compatible storage operations with convenience methods\n */\n\nimport { loadS3Config } from \"../config\";\nimport { S3Provider } from \"../providers/s3\";\nimport type {\n BatchDeleteOptions,\n BatchDeleteResult,\n CopyFolderOptions,\n CopyFolderResult,\n CopyOptions,\n CopyResult,\n CreateFolderOptions,\n CreateFolderResult,\n DeleteFolderOptions,\n DeleteFolderResult,\n DeleteOptions,\n DeleteResult,\n DownloadOptions,\n DownloadResult,\n DuplicateOptions,\n DuplicateResult,\n ExistsResult,\n FolderExistsResult,\n ListFoldersOptions,\n ListFoldersResult,\n ListOptions,\n ListResult,\n MoveOptions,\n MoveResult,\n PresignedUrlOptions,\n PresignedUrlResult,\n RenameFolderOptions,\n RenameFolderResult,\n S3Config,\n StorageInterface,\n UploadOptions,\n UploadResult,\n} from \"../types\";\n\n/**\n * S3 storage service\n * High-level service for S3-compatible storage operations with convenience methods\n * @public\n */\nexport class S3Service implements StorageInterface {\n private provider: S3Provider;\n private config: S3Config;\n\n constructor();\n constructor(config: S3Config);\n constructor(config?: S3Config) {\n this.config = config || loadS3Config();\n this.provider = this.createProvider(this.config);\n }\n\n private createProvider(config: S3Config): S3Provider {\n switch (config.provider) {\n case \"aws\":\n case \"cloudflare-r2\":\n case \"minio\":\n case \"digitalocean\":\n case \"supabase\":\n case \"custom\":\n return new S3Provider(config);\n default:\n throw new Error(`Unsupported S3 provider: ${config.provider}`);\n }\n }\n\n // Utility methods\n getConfig(): S3Config {\n return { ...this.config };\n }\n\n getBucket(): string {\n return this.config.bucket;\n }\n\n getRegion(): string {\n return this.config.region;\n }\n\n getProvider(): string {\n return this.config.provider;\n }\n\n getPublicUrl(key: string): string {\n return this.provider.getPublicUrl(key);\n }\n\n // File operations\n async upload(options: UploadOptions): Promise<UploadResult> {\n return this.provider.upload(options);\n }\n\n async download(options: DownloadOptions): Promise<DownloadResult> {\n return this.provider.download(options);\n }\n\n async delete(options: DeleteOptions): Promise<DeleteResult> {\n return this.provider.delete(options);\n }\n\n async batchDelete(options: BatchDeleteOptions): Promise<BatchDeleteResult> {\n return this.provider.batchDelete(options);\n }\n\n async list(options?: ListOptions): Promise<ListResult> {\n return this.provider.list(options);\n }\n\n async exists(key: string): Promise<ExistsResult> {\n return this.provider.exists(key);\n }\n\n async copy(options: CopyOptions): Promise<CopyResult> {\n return this.provider.copy(options);\n }\n\n async move(options: MoveOptions): Promise<MoveResult> {\n return this.provider.move(options);\n }\n\n async duplicate(options: DuplicateOptions): Promise<DuplicateResult> {\n return this.provider.duplicate(options);\n }\n\n async getPresignedUrl(options: PresignedUrlOptions): Promise<PresignedUrlResult> {\n return this.provider.getPresignedUrl(options);\n }\n\n // Folder operations\n async createFolder(options: CreateFolderOptions): Promise<CreateFolderResult> {\n return this.provider.createFolder(options);\n }\n\n async deleteFolder(options: DeleteFolderOptions): Promise<DeleteFolderResult> {\n return this.provider.deleteFolder(options);\n }\n\n async listFolders(options?: ListFoldersOptions): Promise<ListFoldersResult> {\n return this.provider.listFolders(options);\n }\n\n async folderExists(path: string): Promise<FolderExistsResult> {\n return this.provider.folderExists(path);\n }\n\n async renameFolder(options: RenameFolderOptions): Promise<RenameFolderResult> {\n return this.provider.renameFolder(options);\n }\n\n async copyFolder(options: CopyFolderOptions): Promise<CopyFolderResult> {\n return this.provider.copyFolder(options);\n }\n\n // Convenience methods\n async uploadFile(\n key: string,\n file: Buffer | Uint8Array | string,\n options?: Partial<UploadOptions>,\n ): Promise<UploadResult> {\n return this.upload({\n key,\n file,\n ...options,\n });\n }\n\n async downloadFile(key: string): Promise<DownloadResult> {\n return this.download({ key });\n }\n\n async deleteFile(key: string): Promise<DeleteResult> {\n return this.delete({ key });\n }\n\n async deleteFiles(keys: string[]): Promise<BatchDeleteResult> {\n return this.batchDelete({ keys });\n }\n\n async listFiles(prefix?: string, maxKeys?: number): Promise<ListResult> {\n return this.list({ prefix, maxKeys });\n }\n\n async fileExists(key: string): Promise<boolean> {\n const result = await this.exists(key);\n return result.exists;\n }\n\n async copyFile(\n sourceKey: string,\n destinationKey: string,\n options?: Partial<CopyOptions>,\n ): Promise<CopyResult> {\n return this.copy({\n sourceKey,\n destinationKey,\n ...options,\n });\n }\n\n async moveFile(\n sourceKey: string,\n destinationKey: string,\n options?: Partial<MoveOptions>,\n ): Promise<MoveResult> {\n return this.move({\n sourceKey,\n destinationKey,\n ...options,\n });\n }\n\n async duplicateFile(\n sourceKey: string,\n destinationKey: string,\n options?: Partial<DuplicateOptions>,\n ): Promise<DuplicateResult> {\n return this.duplicate({\n sourceKey,\n destinationKey,\n ...options,\n });\n }\n\n async renameFile(\n sourceKey: string,\n newKey: string,\n options?: Partial<MoveOptions>,\n ): Promise<MoveResult> {\n return this.moveFile(sourceKey, newKey, options);\n }\n\n async getDownloadUrl(key: string, expiresIn?: number): Promise<PresignedUrlResult> {\n return this.getPresignedUrl({\n key,\n operation: \"get\",\n expiresIn,\n });\n }\n\n async getUploadUrl(\n key: string,\n contentType?: string,\n expiresIn?: number,\n ): Promise<PresignedUrlResult> {\n return this.getPresignedUrl({\n key,\n operation: \"put\",\n contentType,\n expiresIn,\n });\n }\n\n // Folder convenience methods\n async createFolderPath(path: string): Promise<CreateFolderResult> {\n return this.createFolder({ path });\n }\n\n async deleteFolderPath(path: string, recursive = false): Promise<DeleteFolderResult> {\n return this.deleteFolder({ path, recursive });\n }\n\n async folderPathExists(path: string): Promise<boolean> {\n const result = await this.folderExists(path);\n return result.exists;\n }\n\n async renameFolderPath(oldPath: string, newPath: string): Promise<RenameFolderResult> {\n return this.renameFolder({ oldPath, newPath });\n }\n\n async copyFolderPath(\n sourcePath: string,\n destinationPath: string,\n recursive = true,\n ): Promise<CopyFolderResult> {\n return this.copyFolder({ sourcePath, destinationPath, recursive });\n }\n}\n","import type { EnvRecord } from \"./config\";\nimport { loadS3Config } from \"./config\";\nimport { S3Service } from \"./services/s3\";\nimport type { S3Config } from \"./types\";\n\nexport type { EnvRecord } from \"./config\";\n// === SERVICE CLASSES ===\nexport { S3Service } from \"./services/s3\";\n\n// === MAIN FACTORY FUNCTIONS (Primary API) ===\n/**\n * Create S3 service using environment variables or manual configuration\n * @param config Optional S3 configuration. If not provided, loads from environment variables\n * @param env - Optional environment record\n * @returns S3Service instance\n * @throws Error if configuration is invalid or environment variables are missing\n * @public\n *\n * @example\n * ```typescript\n * import { createS3 } from '@kumix/storage/s3';\n *\n * // Using environment variables\n * // Set: KUMIX_S3_PROVIDER=aws, KUMIX_S3_REGION=us-east-1, etc.\n * const s3FromEnv = createS3();\n * await s3FromEnv.uploadFile('test.txt', 'Hello World');\n *\n * // Using manual configuration\n * const s3Manual = createS3({\n * provider: 'aws',\n * region: 'us-east-1',\n * bucket: 'my-bucket',\n * accessKeyId: 'AKIA...',\n * secretAccessKey: 'secret...'\n * });\n *\n * // Cloudflare R2\n * const r2 = createS3({\n * provider: 'cloudflare-r2',\n * region: 'auto',\n * bucket: 'my-r2-bucket',\n * accessKeyId: 'your-r2-key',\n * secretAccessKey: 'your-r2-secret',\n * endpoint: 'https://account-id.r2.cloudflarestorage.com'\n * });\n *\n * // MinIO\n * const minio = createS3({\n * provider: 'minio',\n * region: 'us-east-1',\n * bucket: 'my-minio-bucket',\n * accessKeyId: 'minioadmin',\n * secretAccessKey: 'minioadmin',\n * endpoint: 'http://localhost:9000',\n * forcePathStyle: true\n * });\n * ```\n */\nexport function createS3(): S3Service;\nexport function createS3(config: S3Config): S3Service;\nexport function createS3(config: S3Config, env: EnvRecord): S3Service;\nexport function createS3(config: undefined, env: EnvRecord): S3Service;\nexport function createS3(config?: S3Config, env?: EnvRecord): S3Service {\n if (config) {\n return new S3Service(config);\n }\n // When `config` is omitted, build the config from env. This overload also\n // covers `createS3(undefined, env)` which was previously rejected by the\n // published signatures despite being a valid call.\n const envConfig = loadS3Config(env);\n return new S3Service(envConfig);\n}\n"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@kumix/storage",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"description": "Storage utilities for SaaS applications.",
|
|
5
5
|
"author": "Kumix Labs <hai@kumix.io>",
|
|
6
6
|
"license": "MIT",
|
|
@@ -58,8 +58,8 @@
|
|
|
58
58
|
"supabase"
|
|
59
59
|
],
|
|
60
60
|
"devDependencies": {
|
|
61
|
-
"@aws-sdk/client-s3": "^3.
|
|
62
|
-
"@aws-sdk/s3-request-presigner": "^3.
|
|
61
|
+
"@aws-sdk/client-s3": "^3.1080.0",
|
|
62
|
+
"@aws-sdk/s3-request-presigner": "^3.1080.0",
|
|
63
63
|
"@kumix/tsconfig": "^0.1.0",
|
|
64
64
|
"@types/node": "^26.1.0",
|
|
65
65
|
"cloudinary": "^2.10.0",
|