@geekmidas/storage 2.0.4 → 10.0.0-alpha.0

package/dist/aws.cjs

@@ -1,5 +1,160 @@
-const require_AmazonStorageClient = require('./AmazonStorageClient-BvoZepKJ.cjs');
-require('./StorageClient-BDRVrMJj.cjs');
+const require_s3Url = require('./s3Url-Bo32UTTA.cjs');
+require('./errors-Bce0CJ11.cjs');
+const __aws_sdk_client_s3 = require_s3Url.__toESM(require("@aws-sdk/client-s3"));
+const __aws_sdk_s3_presigned_post = require_s3Url.__toESM(require("@aws-sdk/s3-presigned-post"));
+const __aws_sdk_s3_request_presigner = require_s3Url.__toESM(require("@aws-sdk/s3-request-presigner"));
 
-exports.AmazonCannedAccessControlList = require_AmazonStorageClient.AmazonCannedAccessControlList;
-exports.AmazonStorageClient = require_AmazonStorageClient.AmazonStorageClient;
+//#region src/StorageClient.ts
+let StorageProvider = /* @__PURE__ */ function(StorageProvider$1) {
+	StorageProvider$1["AWSS3"] = "geekimdas.toolbox.storage.aws.s3";
+	StorageProvider$1["GCP"] = "geekimdas.toolbox.storage.gcp";
+	StorageProvider$1["AZURE"] = "geekimdas.toolbox.storage.azure";
+	return StorageProvider$1;
+}({});
+
+//#endregion
+//#region src/AmazonStorageClient.ts
+var AmazonStorageClient = class AmazonStorageClient {
+	provider = StorageProvider.AWSS3;
+	static create(options) {
+		const { bucket, region, accessKeyId, acl, endpoint, secretAccessKey, forcePathStyle = false, cache } = options;
+		const hasCredentials = accessKeyId && secretAccessKey;
+		const credentials = hasCredentials ? {
+			accessKeyId,
+			secretAccessKey
+		} : void 0;
+		const client = new __aws_sdk_client_s3.S3Client({
+			region,
+			credentials,
+			endpoint,
+			forcePathStyle
+		});
+		return new AmazonStorageClient(client, bucket, acl, cache);
+	}
+	constructor(client, bucket, acl = AmazonCannedAccessControlList.AuthenticatedRead, cache) {
+		this.client = client;
+		this.bucket = bucket;
+		this.acl = acl;
+		this.cache = cache;
+	}
+	createGetObjectCommand(file, overrides) {
+		const disposition = file.disposition ?? (file.name ? "attachment" : void 0);
+		const ResponseContentDisposition = disposition ? file.name ? `${disposition}; filename=${encodeURIComponent(file.name)}` : disposition : void 0;
+		return new __aws_sdk_client_s3.GetObjectCommand({
+			Bucket: this.bucket,
+			Key: file.path,
+			ResponseContentDisposition,
+			ResponseContentType: file.responseContentType,
+			...overrides
+		});
+	}
+	getVersionDownloadURL(file, versionId) {
+		const command = this.createGetObjectCommand(file, { VersionId: versionId });
+		return (0, __aws_sdk_s3_request_presigner.getSignedUrl)(this.client, command, { expiresIn: 60 * 60 * 24 });
+	}
+	async getVersions(key) {
+		const command = new __aws_sdk_client_s3.ListObjectVersionsCommand({
+			Bucket: this.bucket,
+			Prefix: key
+		});
+		const { Versions = [] } = await this.client.send(command);
+		return Versions.map((version) => ({
+			id: version.VersionId || "",
+			createdAt: version.LastModified || /* @__PURE__ */ new Date()
+		}));
+	}
+	async getDownloadURL(file, expiresIn = 60 * 60) {
+		const cacheKey = `download-url:${file.path}`;
+		const cachedURL = await this.cache?.get(cacheKey);
+		if (cachedURL) return cachedURL;
+		const command = this.createGetObjectCommand(file);
+		const url = await (0, __aws_sdk_s3_request_presigner.getSignedUrl)(this.client, command, { expiresIn });
+		const cacheExpiration = Math.max(expiresIn - 60, 0);
+		if (cacheExpiration) await this.cache?.set(cacheKey, url, cacheExpiration);
+		return url;
+	}
+	async getUploadURL(params, expiresIn = 60 * 60) {
+		const command = new __aws_sdk_client_s3.PutObjectCommand({
+			Bucket: this.bucket,
+			Key: params.path,
+			ContentType: params.contentType,
+			ContentLength: params.contentLength
+		});
+		return (0, __aws_sdk_s3_request_presigner.getSignedUrl)(this.client, command, { expiresIn });
+	}
+	async getUpload(params, expiresIn = 5) {
+		const { path } = params;
+		const { fields: values, url } = await (0, __aws_sdk_s3_presigned_post.createPresignedPost)(this.client, {
+			Expires: expiresIn * 60,
+			Bucket: this.bucket,
+			Fields: { acl: this.acl },
+			Conditions: [],
+			Key: path
+		});
+		const keys = Object.keys(values);
+		const fields = keys.map((key) => ({
+			key,
+			value: values[key] || ""
+		}));
+		return {
+			url,
+			fields
+		};
+	}
+	async upload(key, data, contentType) {
+		const Body = typeof data === "string" ? Buffer.from(data, "base64") : data;
+		const params = {
+			Bucket: this.bucket,
+			Key: key,
+			Body,
+			ContentType: contentType
+		};
+		const command = new __aws_sdk_client_s3.PutObjectCommand(params);
+		await this.client.send(command);
+	}
+	async delete(key) {
+		const command = new __aws_sdk_client_s3.DeleteObjectCommand({
+			Bucket: this.bucket,
+			Key: key
+		});
+		await this.client.send(command);
+	}
+};
+let AmazonCannedAccessControlList = /* @__PURE__ */ function(AmazonCannedAccessControlList$1) {
+	AmazonCannedAccessControlList$1["AuthenticatedRead"] = "authenticated-read";
+	AmazonCannedAccessControlList$1["Private"] = "private";
+	AmazonCannedAccessControlList$1["PublicRead"] = "public-read";
+	AmazonCannedAccessControlList$1["PublicReadWrite"] = "public-read-write";
+	AmazonCannedAccessControlList$1["AwsExecRead"] = "aws-exec-read";
+	AmazonCannedAccessControlList$1["BucketOwnerRead"] = "bucket-owner-read";
+	AmazonCannedAccessControlList$1["BucketOwnerFullControl"] = "bucket-owner-full-control";
+	AmazonCannedAccessControlList$1["LogDeliveryWrite"] = "log-delivery-write";
+	return AmazonCannedAccessControlList$1;
+}({});
+
+//#endregion
+//#region src/s3Driver.ts
+const s3Driver = {
+	scheme: "s3:",
+	create(url) {
+		const { bucket, region, endpoint, forcePathStyle } = require_s3Url.parse(url);
+		return AmazonStorageClient.create({
+			bucket,
+			region,
+			endpoint,
+			forcePathStyle
+		});
+	}
+};
+
+//#endregion
+exports.AmazonCannedAccessControlList = AmazonCannedAccessControlList;
+exports.AmazonStorageClient = AmazonStorageClient;
+exports.s3Driver = s3Driver;
+Object.defineProperty(exports, 's3Url', {
+  enumerable: true,
+  get: function () {
+    return require_s3Url.s3Url_exports;
+  }
+});
+//# sourceMappingURL=aws.cjs.map

package/dist/aws.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws.cjs","names":["options: AmazonStorageClientCreateOptions","S3Client","client: S3Client","bucket: string","cache?: Cache","file: File","overrides?: { VersionId?: string }","GetObjectCommand","versionId: string","key: string","ListObjectVersionsCommand","params: GetUploadParams","PutObjectCommand","data: string | Buffer","contentType: string","DeleteObjectCommand","s3Driver: StorageDriver"],"sources":["../src/StorageClient.ts","../src/AmazonStorageClient.ts","../src/s3Driver.ts"],"sourcesContent":["import type { Cache } from '@geekmidas/cache';\nexport interface DocumentVersion {\n\tid: string;\n\tcreatedAt: Date;\n}\n\nexport enum StorageProvider {\n\tAWSS3 = 'geekimdas.toolbox.storage.aws.s3',\n\tGCP = 'geekimdas.toolbox.storage.gcp',\n\tAZURE = 'geekimdas.toolbox.storage.azure',\n}\n\nexport interface StorageClient {\n\treadonly provider: StorageProvider;\n\treadonly cache?: Cache;\n\t/**\n\t * Get a URL to upload a file to.\n\t *\n\t * @param params - The parameters to get the upload URL for.\n\t * @param expiresIn - The number of minutes the URL should be valid for.\n\t * Defaults to 60 * 60 (1 hour).\n\t * @returns A promise that resolves to the upload URL.\n\t */\n\tgetUploadURL(params: GetUploadParams, expiresIn?: number): Promise<string>;\n\n\t/**\n\t * Get a URL to download a file from.\n\t *\n\t * @param file - The file to get the download URL for.\n\t * @param expiresIn - The number of seconds the URL should be valid for.\n\t * Defaults to 60 * 60 (1 hour).\n\t * @returns A promise that resolves to the download URL.\n\t */\n\tgetDownloadURL(file: File, expiresIn?: number): Promise<string>;\n\t/**\n\t * Get the versions for a key.\n\t *\n\t * @param key - The key to get the versions for.\n\t */\n\tgetVersions(key: string): Promise<DocumentVersion[]>;\n\n\t/**\n\t * Get a URL to download a version of a file from.\n\t *\n\t * @param file - The file to get the download URL for.\n\t * @param versionId - The version ID to get the download URL for.\n\t */\n\tgetVersionDownloadURL(file: File, versionId: string): Promise<string>;\n\t/**\n\t *\n\t * @param key - The key to upload the file to.\n\t * @param data - The data to upload.\n\t * @param contentType - The content type of the data.\n\t */\n\tupload(\n\t\tkey: string,\n\t\tdata: string | Buffer,\n\t\tcontentType: string,\n\t): Promise<void>;\n\t/**\n\t * Get a URL to upload a file to.\n\t *\n\t * @param params - The parameters to get the upload URL for.\n\t * @param expiresIn - The number of minutes the URL should be valid for.\n\t */\n\tgetUpload(\n\t\tparams: GetUploadParams,\n\t\texpiresIn?: number,\n\t): Promise<GetUploadResponse>;\n\t/**\n\t * Delete a file from storage.\n\t *\n\t * @param key - The key (path) of the file to delete.\n\t */\n\tdelete(key: string): Promise<void>;\n}\n\nexport interface GetUploadParams {\n\tpath: string;\n\tcontentType: string;\n\tcontentLength: number;\n}\n\nexport type UploadField = {\n\tkey: string;\n\tvalue: string;\n};\n\nexport type GetUploadResponse = {\n\turl: string;\n\tfields: UploadField[];\n};\n\nexport interface File {\n\tname?: string;\n\tpath: string;\n\t/**\n\t * Override the Content-Type of the response.\n\t * Useful when the stored object's content type differs from what the browser should receive.\n\t */\n\tresponseContentType?: string;\n\t/**\n\t * Control how the browser handles the file.\n\t * - `'attachment'` — prompts download (default when `name` is set)\n\t * - `'inline'` — displays in the browser\n\t */\n\tdisposition?: 'inline' | 'attachment';\n}\n","import {\n\tDeleteObjectCommand,\n\tGetObjectCommand,\n\tListObjectVersionsCommand,\n\tPutObjectCommand,\n\tS3Client,\n} from '@aws-sdk/client-s3';\nimport { createPresignedPost } from '@aws-sdk/s3-presigned-post';\nimport { getSignedUrl } from '@aws-sdk/s3-request-presigner';\n\nimport type { Cache } from '@geekmidas/cache';\nimport {\n\ttype DocumentVersion,\n\ttype File,\n\ttype GetUploadParams,\n\ttype GetUploadResponse,\n\ttype StorageClient,\n\tStorageProvider,\n} from './StorageClient';\n\nexport class AmazonStorageClient implements StorageClient {\n\treadonly provider = StorageProvider.AWSS3;\n\n\tstatic create(\n\t\toptions: AmazonStorageClientCreateOptions,\n\t): AmazonStorageClient {\n\t\tconst {\n\t\t\tbucket,\n\t\t\tregion,\n\t\t\taccessKeyId,\n\t\t\tacl,\n\t\t\tendpoint,\n\t\t\tsecretAccessKey,\n\t\t\tforcePathStyle = false,\n\t\t\tcache,\n\t\t} = options;\n\t\tconst hasCredentials = accessKeyId && secretAccessKey;\n\t\tconst credentials = hasCredentials\n\t\t\t? { accessKeyId, secretAccessKey }\n\t\t\t: undefined;\n\n\t\tconst client = new S3Client({\n\t\t\tregion,\n\t\t\tcredentials,\n\t\t\tendpoint,\n\t\t\tforcePathStyle,\n\t\t});\n\n\t\treturn new AmazonStorageClient(client, bucket, acl, cache);\n\t}\n\tconstructor(\n\t\tprivate readonly client: S3Client,\n\t\tprivate readonly bucket: string,\n\t\tprivate readonly acl = AmazonCannedAccessControlList.AuthenticatedRead,\n\t\treadonly cache?: Cache,\n\t) {}\n\n\tprivate createGetObjectCommand(\n\t\tfile: File,\n\t\toverrides?: { VersionId?: string },\n\t): GetObjectCommand {\n\t\tconst disposition =\n\t\t\tfile.disposition ?? (file.name ? 'attachment' : undefined);\n\t\tconst ResponseContentDisposition = disposition\n\t\t\t? file.name\n\t\t\t\t? `${disposition}; filename=${encodeURIComponent(file.name)}`\n\t\t\t\t: disposition\n\t\t\t: undefined;\n\n\t\treturn new GetObjectCommand({\n\t\t\tBucket: this.bucket,\n\t\t\tKey: file.path,\n\t\t\tResponseContentDisposition,\n\t\t\tResponseContentType: file.responseContentType,\n\t\t\t...overrides,\n\t\t});\n\t}\n\n\tgetVersionDownloadURL(file: File, versionId: string): Promise<string> {\n\t\tconst command = this.createGetObjectCommand(file, { VersionId: versionId });\n\t\treturn getSignedUrl(this.client, command, { expiresIn: 60 * 60 * 24 });\n\t}\n\n\tasync getVersions(key: string): Promise<DocumentVersion[]> {\n\t\tconst command = new ListObjectVersionsCommand({\n\t\t\tBucket: this.bucket,\n\t\t\tPrefix: key,\n\t\t});\n\n\t\tconst { Versions = [] } = await this.client.send(command);\n\n\t\treturn Versions.map((version) => ({\n\t\t\tid: version.VersionId || '',\n\t\t\tcreatedAt: version.LastModified || new Date(),\n\t\t}));\n\t}\n\n\tasync getDownloadURL(file: File, expiresIn = 60 * 60): Promise<string> {\n\t\tconst cacheKey = `download-url:${file.path}`;\n\t\tconst cachedURL = await this.cache?.get<string>(cacheKey);\n\n\t\tif (cachedURL) {\n\t\t\treturn cachedURL;\n\t\t}\n\n\t\tconst command = this.createGetObjectCommand(file);\n\t\tconst url = await getSignedUrl(this.client, command, { expiresIn });\n\t\tconst cacheExpiration = Math.max(expiresIn - 60, 0);\n\n\t\tif (cacheExpiration) {\n\t\t\tawait this.cache?.set(cacheKey, url, cacheExpiration);\n\t\t}\n\n\t\treturn url;\n\t}\n\n\tasync getUploadURL(\n\t\tparams: GetUploadParams,\n\t\texpiresIn = 60 * 60,\n\t): Promise<string> {\n\t\tconst command = new PutObjectCommand({\n\t\t\tBucket: this.bucket,\n\t\t\tKey: params.path,\n\t\t\tContentType: params.contentType,\n\t\t\tContentLength: params.contentLength,\n\t\t});\n\n\t\treturn getSignedUrl(this.client, command, { expiresIn });\n\t}\n\n\tasync getUpload(\n\t\tparams: GetUploadParams,\n\t\texpiresIn = 5,\n\t): Promise<GetUploadResponse> {\n\t\tconst { path } = params;\n\t\tconst { fields: values, url } = await createPresignedPost(this.client, {\n\t\t\tExpires: expiresIn * 60,\n\t\t\tBucket: this.bucket,\n\t\t\tFields: {\n\t\t\t\tacl: this.acl,\n\t\t\t},\n\t\t\tConditions: [\n\t\t\t\t// content length restrictions: 0-1MB]\n\t\t\t\t// ['content-length-range', 0, contentLength],\n\t\t\t\t// specify content-type to be more generic- images only\n\t\t\t\t// ['starts-with', '$Content-Type', 'image/'],\n\t\t\t\t// ['starts-with', '$Content-Type', contentType],\n\t\t\t],\n\t\t\tKey: path,\n\t\t});\n\n\t\tconst keys = Object.keys(values);\n\t\tconst fields = keys.map((key) => ({ key, value: values[key] || '' }));\n\n\t\treturn { url, fields };\n\t}\n\n\tasync upload(\n\t\tkey: string,\n\t\tdata: string | Buffer,\n\t\tcontentType: string,\n\t): Promise<void> {\n\t\tconst Body = typeof data === 'string' ? Buffer.from(data, 'base64') : data;\n\n\t\tconst params = {\n\t\t\tBucket: this.bucket,\n\t\t\tKey: key,\n\t\t\tBody,\n\t\t\tContentType: contentType,\n\t\t};\n\n\t\tconst command = new PutObjectCommand(params);\n\n\t\tawait this.client.send(command);\n\t}\n\n\tasync delete(key: string): Promise<void> {\n\t\tconst command = new DeleteObjectCommand({\n\t\t\tBucket: this.bucket,\n\t\t\tKey: key,\n\t\t});\n\n\t\tawait this.client.send(command);\n\t}\n}\n\nexport enum AmazonCannedAccessControlList {\n\tAuthenticatedRead = 'authenticated-read',\n\tPrivate = 'private',\n\tPublicRead = 'public-read',\n\tPublicReadWrite = 'public-read-write',\n\tAwsExecRead = 'aws-exec-read',\n\tBucketOwnerRead = 'bucket-owner-read',\n\tBucketOwnerFullControl = 'bucket-owner-full-control',\n\tLogDeliveryWrite = 'log-delivery-write',\n}\n\ninterface AmazonStorageClientCreateOptions {\n\tbucket: string;\n\tregion?: string;\n\tacl?: AmazonCannedAccessControlList;\n\taccessKeyId?: string;\n\tsecretAccessKey?: string;\n\tendpoint?: string;\n\tforcePathStyle?: boolean;\n\tcache?: Cache;\n}\n","/**\n * The S3 driver — `s3://` URLs to an {@link AmazonStorageClient}.\n *\n * Registered by whoever assembles the application, so neutral code can build a\n * client from a URL without importing this file or the AWS SDK behind it.\n */\n\nimport { AmazonStorageClient } from './AmazonStorageClient';\nimport type { StorageDriver } from './registry';\nimport { parse } from './s3Url';\n\nexport const s3Driver: StorageDriver = {\n\tscheme: 's3:',\n\tcreate(url) {\n\t\tconst { bucket, region, endpoint, forcePathStyle } = parse(url);\n\t\treturn AmazonStorageClient.create({\n\t\t\tbucket,\n\t\t\tregion,\n\t\t\tendpoint,\n\t\t\tforcePathStyle,\n\t\t});\n\t},\n};\n"],"mappings":"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"}

package/dist/aws.d.cts

@@ -1,3 +1,51 @@
-import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient } from "./StorageClient-COs9SOsU.cjs";
-import { AmazonCannedAccessControlList, AmazonStorageClient } from "./AmazonStorageClient-BNoY2PL6.cjs";
-export { AmazonCannedAccessControlList, AmazonStorageClient, DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient };
+import { S3Address, s3Url_d_exports } from "./s3Url-BfztIltX.cjs";
+import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageDriver, StorageProvider } from "./registry-DBsAUTT3.cjs";
+import { S3Client } from "@aws-sdk/client-s3";
+import { Cache } from "@geekmidas/cache";
+
+//#region src/AmazonStorageClient.d.ts
+declare class AmazonStorageClient implements StorageClient {
+  private readonly client;
+  private readonly bucket;
+  private readonly acl;
+  readonly cache?: Cache;
+  readonly provider = StorageProvider.AWSS3;
+  static create(options: AmazonStorageClientCreateOptions): AmazonStorageClient;
+  constructor(client: S3Client, bucket: string, acl?: AmazonCannedAccessControlList, cache?: Cache);
+  private createGetObjectCommand;
+  getVersionDownloadURL(file: File, versionId: string): Promise<string>;
+  getVersions(key: string): Promise<DocumentVersion[]>;
+  getDownloadURL(file: File, expiresIn?: number): Promise<string>;
+  getUploadURL(params: GetUploadParams, expiresIn?: number): Promise<string>;
+  getUpload(params: GetUploadParams, expiresIn?: number): Promise<GetUploadResponse>;
+  upload(key: string, data: string | Buffer, contentType: string): Promise<void>;
+  delete(key: string): Promise<void>;
+}
+declare enum AmazonCannedAccessControlList {
+  AuthenticatedRead = "authenticated-read",
+  Private = "private",
+  PublicRead = "public-read",
+  PublicReadWrite = "public-read-write",
+  AwsExecRead = "aws-exec-read",
+  BucketOwnerRead = "bucket-owner-read",
+  BucketOwnerFullControl = "bucket-owner-full-control",
+  LogDeliveryWrite = "log-delivery-write",
+}
+interface AmazonStorageClientCreateOptions {
+  bucket: string;
+  region?: string;
+  acl?: AmazonCannedAccessControlList;
+  accessKeyId?: string;
+  secretAccessKey?: string;
+  endpoint?: string;
+  forcePathStyle?: boolean;
+  cache?: Cache;
+}
+//#endregion
+//#region src/s3Driver.d.ts
+declare const s3Driver: StorageDriver;
+//# sourceMappingURL=s3Driver.d.ts.map
+
+//#endregion
+export { AmazonCannedAccessControlList, AmazonStorageClient, DocumentVersion, File, GetUploadParams, GetUploadResponse, S3Address, StorageClient, s3Driver, s3Url_d_exports as s3Url };
+//# sourceMappingURL=aws.d.cts.map

package/dist/aws.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws.d.cts","names":[],"sources":["../src/AmazonStorageClient.ts","../src/s3Driver.ts"],"sourcesContent":[],"mappings":";;;;;;cAoBa,mBAAA,YAA+B;;;EAA/B,iBAAA,GAAA;EAAoB,SAAA,KAAA,CAAA,EAkCd,KAlCc;EAAA,SAkCd,QAAA,GAjCD,eAAA,CAAA,KAAA;EAiCM,OAjCN,MAAA,CAAA,OAAA,EAGP,gCAHO,CAAA,EAId,mBAJc;EAAA,WAGP,CAAA,MAAA,EA2BgB,QA3BhB,EAAA,MAAA,EAAA,MAAA,EAAA,GAAA,CAAA,EA6BW,6BA7BX,EAAA,KAAA,CAAA,EA8BQ,KA9BR;EAAgC,QACvC,sBAAA;EAAmB,qBA0BI,CAAA,IAAA,EA2BE,IA3BF,EAAA,SAAA,EAAA,MAAA,CAAA,EA2B4B,OA3B5B,CAAA,MAAA,CAAA;EAAQ,WAEb,CAAA,GAAA,EAAA,MAAA,CAAA,EA8BW,OA9BX,CA8BmB,eA9BnB,EAAA,CAAA;EAAkD,cACrD,CAAA,IAAA,EA2CS,IA3CT,EAAA,SAAA,CAAA,EAAA,MAAA,CAAA,EA2CqC,OA3CrC,CAAA,MAAA,CAAA;EAAK,YAwBK,CAAA,MAAA,EAuCnB,eAvCmB,EAAA,SAAA,CAAA,EAAA,MAAA,CAAA,EAyCzB,OAzCyB,CAAA,MAAA,CAAA;EAAI,SAAsB,CAAA,MAAA,EAqD7C,eArD6C,EAAA,SAAA,CAAA,EAAA,MAAA,CAAA,EAuDnD,OAvDmD,CAuD3C,iBAvD2C,CAAA;EAAO,MAKrB,CAAA,GAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,GA4ExB,MA5EwB,EAAA,WAAA,EAAA,MAAA,CAAA,EA8ErC,OA9EqC,CAAA,IAAA,CAAA;EAAe,MAAvB,CAAA,GAAA,EAAA,MAAA,CAAA,EA6FL,OA7FK,CAAA,IAAA,CAAA;;AAcuB,aAyF5C,6BAAA;EAzFmD,iBAoBrD,GAAA,oBAAA;EAAe,OAErB,GAAA,SAAA;EAAO,UAYD,GAAA,aAAA;EAAe,eAEb,GAAA,mBAAA;EAAiB,WAAzB,GAAA,eAAA;EAAO,eA0BM,GAAA,mBAAA;EAAM,sBAEnB,GAAA,2BAAA;EAAO,gBAeiB,GAAA,oBAAA;;AA5J6B,UAiL/C,gCAAA,CAjL+C;EAsK7C,MAAA,EAAA,MAAA;EAWF,MAAA,CAAA,EAAA,MAAA;EAAgC,GAAA,CAAA,EAGnC,6BAHmC;EAAA,WAGnC,CAAA,EAAA,MAAA;EAA6B,eAK3B,CAAA,EAAA,MAAA;EAAK,QAAA,CAAA,EAAA,MAAA;;UAAL;;;;AAzLwB,cCTpB,QDSoB,ECTV,aDSU"}

package/dist/aws.d.mts

@@ -1,3 +1,51 @@
-import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient } from "./StorageClient-DH4tP-Mf.mjs";
-import { AmazonCannedAccessControlList, AmazonStorageClient } from "./AmazonStorageClient-BHpWawGD.mjs";
-export { AmazonCannedAccessControlList, AmazonStorageClient, DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient };
+import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageDriver, StorageProvider } from "./registry-DEqSHjx-.mjs";
+import { S3Address, s3Url_d_exports } from "./s3Url-COpMIgF9.mjs";
+import { S3Client } from "@aws-sdk/client-s3";
+import { Cache } from "@geekmidas/cache";
+
+//#region src/AmazonStorageClient.d.ts
+declare class AmazonStorageClient implements StorageClient {
+  private readonly client;
+  private readonly bucket;
+  private readonly acl;
+  readonly cache?: Cache;
+  readonly provider = StorageProvider.AWSS3;
+  static create(options: AmazonStorageClientCreateOptions): AmazonStorageClient;
+  constructor(client: S3Client, bucket: string, acl?: AmazonCannedAccessControlList, cache?: Cache);
+  private createGetObjectCommand;
+  getVersionDownloadURL(file: File, versionId: string): Promise<string>;
+  getVersions(key: string): Promise<DocumentVersion[]>;
+  getDownloadURL(file: File, expiresIn?: number): Promise<string>;
+  getUploadURL(params: GetUploadParams, expiresIn?: number): Promise<string>;
+  getUpload(params: GetUploadParams, expiresIn?: number): Promise<GetUploadResponse>;
+  upload(key: string, data: string | Buffer, contentType: string): Promise<void>;
+  delete(key: string): Promise<void>;
+}
+declare enum AmazonCannedAccessControlList {
+  AuthenticatedRead = "authenticated-read",
+  Private = "private",
+  PublicRead = "public-read",
+  PublicReadWrite = "public-read-write",
+  AwsExecRead = "aws-exec-read",
+  BucketOwnerRead = "bucket-owner-read",
+  BucketOwnerFullControl = "bucket-owner-full-control",
+  LogDeliveryWrite = "log-delivery-write",
+}
+interface AmazonStorageClientCreateOptions {
+  bucket: string;
+  region?: string;
+  acl?: AmazonCannedAccessControlList;
+  accessKeyId?: string;
+  secretAccessKey?: string;
+  endpoint?: string;
+  forcePathStyle?: boolean;
+  cache?: Cache;
+}
+//#endregion
+//#region src/s3Driver.d.ts
+declare const s3Driver: StorageDriver;
+//# sourceMappingURL=s3Driver.d.ts.map
+
+//#endregion
+export { AmazonCannedAccessControlList, AmazonStorageClient, DocumentVersion, File, GetUploadParams, GetUploadResponse, S3Address, StorageClient, s3Driver, s3Url_d_exports as s3Url };
+//# sourceMappingURL=aws.d.mts.map

package/dist/aws.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws.d.mts","names":[],"sources":["../src/AmazonStorageClient.ts","../src/s3Driver.ts"],"sourcesContent":[],"mappings":";;;;;;cAoBa,mBAAA,YAA+B;;;EAA/B,iBAAA,GAAA;EAAoB,SAAA,KAAA,CAAA,EAkCd,KAlCc;EAAA,SAkCd,QAAA,GAjCD,eAAA,CAAA,KAAA;EAiCM,OAjCN,MAAA,CAAA,OAAA,EAGP,gCAHO,CAAA,EAId,mBAJc;EAAA,WAGP,CAAA,MAAA,EA2BgB,QA3BhB,EAAA,MAAA,EAAA,MAAA,EAAA,GAAA,CAAA,EA6BW,6BA7BX,EAAA,KAAA,CAAA,EA8BQ,KA9BR;EAAgC,QACvC,sBAAA;EAAmB,qBA0BI,CAAA,IAAA,EA2BE,IA3BF,EAAA,SAAA,EAAA,MAAA,CAAA,EA2B4B,OA3B5B,CAAA,MAAA,CAAA;EAAQ,WAEb,CAAA,GAAA,EAAA,MAAA,CAAA,EA8BW,OA9BX,CA8BmB,eA9BnB,EAAA,CAAA;EAAkD,cACrD,CAAA,IAAA,EA2CS,IA3CT,EAAA,SAAA,CAAA,EAAA,MAAA,CAAA,EA2CqC,OA3CrC,CAAA,MAAA,CAAA;EAAK,YAwBK,CAAA,MAAA,EAuCnB,eAvCmB,EAAA,SAAA,CAAA,EAAA,MAAA,CAAA,EAyCzB,OAzCyB,CAAA,MAAA,CAAA;EAAI,SAAsB,CAAA,MAAA,EAqD7C,eArD6C,EAAA,SAAA,CAAA,EAAA,MAAA,CAAA,EAuDnD,OAvDmD,CAuD3C,iBAvD2C,CAAA;EAAO,MAKrB,CAAA,GAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,GA4ExB,MA5EwB,EAAA,WAAA,EAAA,MAAA,CAAA,EA8ErC,OA9EqC,CAAA,IAAA,CAAA;EAAe,MAAvB,CAAA,GAAA,EAAA,MAAA,CAAA,EA6FL,OA7FK,CAAA,IAAA,CAAA;;AAcuB,aAyF5C,6BAAA;EAzFmD,iBAoBrD,GAAA,oBAAA;EAAe,OAErB,GAAA,SAAA;EAAO,UAYD,GAAA,aAAA;EAAe,eAEb,GAAA,mBAAA;EAAiB,WAAzB,GAAA,eAAA;EAAO,eA0BM,GAAA,mBAAA;EAAM,sBAEnB,GAAA,2BAAA;EAAO,gBAeiB,GAAA,oBAAA;;AA5J6B,UAiL/C,gCAAA,CAjL+C;EAsK7C,MAAA,EAAA,MAAA;EAWF,MAAA,CAAA,EAAA,MAAA;EAAgC,GAAA,CAAA,EAGnC,6BAHmC;EAAA,WAGnC,CAAA,EAAA,MAAA;EAA6B,eAK3B,CAAA,EAAA,MAAA;EAAK,QAAA,CAAA,EAAA,MAAA;;UAAL;;;;AAzLwB,cCTpB,QDSoB,ECTV,aDSU"}

package/dist/aws.mjs

@@ -1,4 +1,152 @@
-import "./StorageClient-4ADnTPnJ.mjs";
-import { AmazonCannedAccessControlList, AmazonStorageClient } from "./AmazonStorageClient-Dz-KCJ_4.mjs";
+import "./errors-D5UnAd-X.mjs";
+import { parse, s3Url_exports } from "./s3Url-C8FGPNrG.mjs";
+import { DeleteObjectCommand, GetObjectCommand, ListObjectVersionsCommand, PutObjectCommand, S3Client } from "@aws-sdk/client-s3";
+import { createPresignedPost } from "@aws-sdk/s3-presigned-post";
+import { getSignedUrl } from "@aws-sdk/s3-request-presigner";
 
-export { AmazonCannedAccessControlList, AmazonStorageClient };
+//#region src/StorageClient.ts
+let StorageProvider = /* @__PURE__ */ function(StorageProvider$1) {
+	StorageProvider$1["AWSS3"] = "geekimdas.toolbox.storage.aws.s3";
+	StorageProvider$1["GCP"] = "geekimdas.toolbox.storage.gcp";
+	StorageProvider$1["AZURE"] = "geekimdas.toolbox.storage.azure";
+	return StorageProvider$1;
+}({});
+
+//#endregion
+//#region src/AmazonStorageClient.ts
+var AmazonStorageClient = class AmazonStorageClient {
+	provider = StorageProvider.AWSS3;
+	static create(options) {
+		const { bucket, region, accessKeyId, acl, endpoint, secretAccessKey, forcePathStyle = false, cache } = options;
+		const hasCredentials = accessKeyId && secretAccessKey;
+		const credentials = hasCredentials ? {
+			accessKeyId,
+			secretAccessKey
+		} : void 0;
+		const client = new S3Client({
+			region,
+			credentials,
+			endpoint,
+			forcePathStyle
+		});
+		return new AmazonStorageClient(client, bucket, acl, cache);
+	}
+	constructor(client, bucket, acl = AmazonCannedAccessControlList.AuthenticatedRead, cache) {
+		this.client = client;
+		this.bucket = bucket;
+		this.acl = acl;
+		this.cache = cache;
+	}
+	createGetObjectCommand(file, overrides) {
+		const disposition = file.disposition ?? (file.name ? "attachment" : void 0);
+		const ResponseContentDisposition = disposition ? file.name ? `${disposition}; filename=${encodeURIComponent(file.name)}` : disposition : void 0;
+		return new GetObjectCommand({
+			Bucket: this.bucket,
+			Key: file.path,
+			ResponseContentDisposition,
+			ResponseContentType: file.responseContentType,
+			...overrides
+		});
+	}
+	getVersionDownloadURL(file, versionId) {
+		const command = this.createGetObjectCommand(file, { VersionId: versionId });
+		return getSignedUrl(this.client, command, { expiresIn: 60 * 60 * 24 });
+	}
+	async getVersions(key) {
+		const command = new ListObjectVersionsCommand({
+			Bucket: this.bucket,
+			Prefix: key
+		});
+		const { Versions = [] } = await this.client.send(command);
+		return Versions.map((version) => ({
+			id: version.VersionId || "",
+			createdAt: version.LastModified || /* @__PURE__ */ new Date()
+		}));
+	}
+	async getDownloadURL(file, expiresIn = 60 * 60) {
+		const cacheKey = `download-url:${file.path}`;
+		const cachedURL = await this.cache?.get(cacheKey);
+		if (cachedURL) return cachedURL;
+		const command = this.createGetObjectCommand(file);
+		const url = await getSignedUrl(this.client, command, { expiresIn });
+		const cacheExpiration = Math.max(expiresIn - 60, 0);
+		if (cacheExpiration) await this.cache?.set(cacheKey, url, cacheExpiration);
+		return url;
+	}
+	async getUploadURL(params, expiresIn = 60 * 60) {
+		const command = new PutObjectCommand({
+			Bucket: this.bucket,
+			Key: params.path,
+			ContentType: params.contentType,
+			ContentLength: params.contentLength
+		});
+		return getSignedUrl(this.client, command, { expiresIn });
+	}
+	async getUpload(params, expiresIn = 5) {
+		const { path } = params;
+		const { fields: values, url } = await createPresignedPost(this.client, {
+			Expires: expiresIn * 60,
+			Bucket: this.bucket,
+			Fields: { acl: this.acl },
+			Conditions: [],
+			Key: path
+		});
+		const keys = Object.keys(values);
+		const fields = keys.map((key) => ({
+			key,
+			value: values[key] || ""
+		}));
+		return {
+			url,
+			fields
+		};
+	}
+	async upload(key, data, contentType) {
+		const Body = typeof data === "string" ? Buffer.from(data, "base64") : data;
+		const params = {
+			Bucket: this.bucket,
+			Key: key,
+			Body,
+			ContentType: contentType
+		};
+		const command = new PutObjectCommand(params);
+		await this.client.send(command);
+	}
+	async delete(key) {
+		const command = new DeleteObjectCommand({
+			Bucket: this.bucket,
+			Key: key
+		});
+		await this.client.send(command);
+	}
+};
+let AmazonCannedAccessControlList = /* @__PURE__ */ function(AmazonCannedAccessControlList$1) {
+	AmazonCannedAccessControlList$1["AuthenticatedRead"] = "authenticated-read";
+	AmazonCannedAccessControlList$1["Private"] = "private";
+	AmazonCannedAccessControlList$1["PublicRead"] = "public-read";
+	AmazonCannedAccessControlList$1["PublicReadWrite"] = "public-read-write";
+	AmazonCannedAccessControlList$1["AwsExecRead"] = "aws-exec-read";
+	AmazonCannedAccessControlList$1["BucketOwnerRead"] = "bucket-owner-read";
+	AmazonCannedAccessControlList$1["BucketOwnerFullControl"] = "bucket-owner-full-control";
+	AmazonCannedAccessControlList$1["LogDeliveryWrite"] = "log-delivery-write";
+	return AmazonCannedAccessControlList$1;
+}({});
+
+//#endregion
+//#region src/s3Driver.ts
+const s3Driver = {
+	scheme: "s3:",
+	create(url) {
+		const { bucket, region, endpoint, forcePathStyle } = parse(url);
+		return AmazonStorageClient.create({
+			bucket,
+			region,
+			endpoint,
+			forcePathStyle
+		});
+	}
+};
+
+//#endregion
+export { AmazonCannedAccessControlList, AmazonStorageClient, s3Driver, s3Url_exports as s3Url };
+//# sourceMappingURL=aws.mjs.map

package/dist/aws.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws.mjs","names":["options: AmazonStorageClientCreateOptions","client: S3Client","bucket: string","cache?: Cache","file: File","overrides?: { VersionId?: string }","versionId: string","key: string","params: GetUploadParams","data: string | Buffer","contentType: string","s3Driver: StorageDriver"],"sources":["../src/StorageClient.ts","../src/AmazonStorageClient.ts","../src/s3Driver.ts"],"sourcesContent":["import type { Cache } from '@geekmidas/cache';\nexport interface DocumentVersion {\n\tid: string;\n\tcreatedAt: Date;\n}\n\nexport enum StorageProvider {\n\tAWSS3 = 'geekimdas.toolbox.storage.aws.s3',\n\tGCP = 'geekimdas.toolbox.storage.gcp',\n\tAZURE = 'geekimdas.toolbox.storage.azure',\n}\n\nexport interface StorageClient {\n\treadonly provider: StorageProvider;\n\treadonly cache?: Cache;\n\t/**\n\t * Get a URL to upload a file to.\n\t *\n\t * @param params - The parameters to get the upload URL for.\n\t * @param expiresIn - The number of minutes the URL should be valid for.\n\t * Defaults to 60 * 60 (1 hour).\n\t * @returns A promise that resolves to the upload URL.\n\t */\n\tgetUploadURL(params: GetUploadParams, expiresIn?: number): Promise<string>;\n\n\t/**\n\t * Get a URL to download a file from.\n\t *\n\t * @param file - The file to get the download URL for.\n\t * @param expiresIn - The number of seconds the URL should be valid for.\n\t * Defaults to 60 * 60 (1 hour).\n\t * @returns A promise that resolves to the download URL.\n\t */\n\tgetDownloadURL(file: File, expiresIn?: number): Promise<string>;\n\t/**\n\t * Get the versions for a key.\n\t *\n\t * @param key - The key to get the versions for.\n\t */\n\tgetVersions(key: string): Promise<DocumentVersion[]>;\n\n\t/**\n\t * Get a URL to download a version of a file from.\n\t *\n\t * @param file - The file to get the download URL for.\n\t * @param versionId - The version ID to get the download URL for.\n\t */\n\tgetVersionDownloadURL(file: File, versionId: string): Promise<string>;\n\t/**\n\t *\n\t * @param key - The key to upload the file to.\n\t * @param data - The data to upload.\n\t * @param contentType - The content type of the data.\n\t */\n\tupload(\n\t\tkey: string,\n\t\tdata: string | Buffer,\n\t\tcontentType: string,\n\t): Promise<void>;\n\t/**\n\t * Get a URL to upload a file to.\n\t *\n\t * @param params - The parameters to get the upload URL for.\n\t * @param expiresIn - The number of minutes the URL should be valid for.\n\t */\n\tgetUpload(\n\t\tparams: GetUploadParams,\n\t\texpiresIn?: number,\n\t): Promise<GetUploadResponse>;\n\t/**\n\t * Delete a file from storage.\n\t *\n\t * @param key - The key (path) of the file to delete.\n\t */\n\tdelete(key: string): Promise<void>;\n}\n\nexport interface GetUploadParams {\n\tpath: string;\n\tcontentType: string;\n\tcontentLength: number;\n}\n\nexport type UploadField = {\n\tkey: string;\n\tvalue: string;\n};\n\nexport type GetUploadResponse = {\n\turl: string;\n\tfields: UploadField[];\n};\n\nexport interface File {\n\tname?: string;\n\tpath: string;\n\t/**\n\t * Override the Content-Type of the response.\n\t * Useful when the stored object's content type differs from what the browser should receive.\n\t */\n\tresponseContentType?: string;\n\t/**\n\t * Control how the browser handles the file.\n\t * - `'attachment'` — prompts download (default when `name` is set)\n\t * - `'inline'` — displays in the browser\n\t */\n\tdisposition?: 'inline' | 'attachment';\n}\n","import {\n\tDeleteObjectCommand,\n\tGetObjectCommand,\n\tListObjectVersionsCommand,\n\tPutObjectCommand,\n\tS3Client,\n} from '@aws-sdk/client-s3';\nimport { createPresignedPost } from '@aws-sdk/s3-presigned-post';\nimport { getSignedUrl } from '@aws-sdk/s3-request-presigner';\n\nimport type { Cache } from '@geekmidas/cache';\nimport {\n\ttype DocumentVersion,\n\ttype File,\n\ttype GetUploadParams,\n\ttype GetUploadResponse,\n\ttype StorageClient,\n\tStorageProvider,\n} from './StorageClient';\n\nexport class AmazonStorageClient implements StorageClient {\n\treadonly provider = StorageProvider.AWSS3;\n\n\tstatic create(\n\t\toptions: AmazonStorageClientCreateOptions,\n\t): AmazonStorageClient {\n\t\tconst {\n\t\t\tbucket,\n\t\t\tregion,\n\t\t\taccessKeyId,\n\t\t\tacl,\n\t\t\tendpoint,\n\t\t\tsecretAccessKey,\n\t\t\tforcePathStyle = false,\n\t\t\tcache,\n\t\t} = options;\n\t\tconst hasCredentials = accessKeyId && secretAccessKey;\n\t\tconst credentials = hasCredentials\n\t\t\t? { accessKeyId, secretAccessKey }\n\t\t\t: undefined;\n\n\t\tconst client = new S3Client({\n\t\t\tregion,\n\t\t\tcredentials,\n\t\t\tendpoint,\n\t\t\tforcePathStyle,\n\t\t});\n\n\t\treturn new AmazonStorageClient(client, bucket, acl, cache);\n\t}\n\tconstructor(\n\t\tprivate readonly client: S3Client,\n\t\tprivate readonly bucket: string,\n\t\tprivate readonly acl = AmazonCannedAccessControlList.AuthenticatedRead,\n\t\treadonly cache?: Cache,\n\t) {}\n\n\tprivate createGetObjectCommand(\n\t\tfile: File,\n\t\toverrides?: { VersionId?: string },\n\t): GetObjectCommand {\n\t\tconst disposition =\n\t\t\tfile.disposition ?? (file.name ? 'attachment' : undefined);\n\t\tconst ResponseContentDisposition = disposition\n\t\t\t? file.name\n\t\t\t\t? `${disposition}; filename=${encodeURIComponent(file.name)}`\n\t\t\t\t: disposition\n\t\t\t: undefined;\n\n\t\treturn new GetObjectCommand({\n\t\t\tBucket: this.bucket,\n\t\t\tKey: file.path,\n\t\t\tResponseContentDisposition,\n\t\t\tResponseContentType: file.responseContentType,\n\t\t\t...overrides,\n\t\t});\n\t}\n\n\tgetVersionDownloadURL(file: File, versionId: string): Promise<string> {\n\t\tconst command = this.createGetObjectCommand(file, { VersionId: versionId });\n\t\treturn getSignedUrl(this.client, command, { expiresIn: 60 * 60 * 24 });\n\t}\n\n\tasync getVersions(key: string): Promise<DocumentVersion[]> {\n\t\tconst command = new ListObjectVersionsCommand({\n\t\t\tBucket: this.bucket,\n\t\t\tPrefix: key,\n\t\t});\n\n\t\tconst { Versions = [] } = await this.client.send(command);\n\n\t\treturn Versions.map((version) => ({\n\t\t\tid: version.VersionId || '',\n\t\t\tcreatedAt: version.LastModified || new Date(),\n\t\t}));\n\t}\n\n\tasync getDownloadURL(file: File, expiresIn = 60 * 60): Promise<string> {\n\t\tconst cacheKey = `download-url:${file.path}`;\n\t\tconst cachedURL = await this.cache?.get<string>(cacheKey);\n\n\t\tif (cachedURL) {\n\t\t\treturn cachedURL;\n\t\t}\n\n\t\tconst command = this.createGetObjectCommand(file);\n\t\tconst url = await getSignedUrl(this.client, command, { expiresIn });\n\t\tconst cacheExpiration = Math.max(expiresIn - 60, 0);\n\n\t\tif (cacheExpiration) {\n\t\t\tawait this.cache?.set(cacheKey, url, cacheExpiration);\n\t\t}\n\n\t\treturn url;\n\t}\n\n\tasync getUploadURL(\n\t\tparams: GetUploadParams,\n\t\texpiresIn = 60 * 60,\n\t): Promise<string> {\n\t\tconst command = new PutObjectCommand({\n\t\t\tBucket: this.bucket,\n\t\t\tKey: params.path,\n\t\t\tContentType: params.contentType,\n\t\t\tContentLength: params.contentLength,\n\t\t});\n\n\t\treturn getSignedUrl(this.client, command, { expiresIn });\n\t}\n\n\tasync getUpload(\n\t\tparams: GetUploadParams,\n\t\texpiresIn = 5,\n\t): Promise<GetUploadResponse> {\n\t\tconst { path } = params;\n\t\tconst { fields: values, url } = await createPresignedPost(this.client, {\n\t\t\tExpires: expiresIn * 60,\n\t\t\tBucket: this.bucket,\n\t\t\tFields: {\n\t\t\t\tacl: this.acl,\n\t\t\t},\n\t\t\tConditions: [\n\t\t\t\t// content length restrictions: 0-1MB]\n\t\t\t\t// ['content-length-range', 0, contentLength],\n\t\t\t\t// specify content-type to be more generic- images only\n\t\t\t\t// ['starts-with', '$Content-Type', 'image/'],\n\t\t\t\t// ['starts-with', '$Content-Type', contentType],\n\t\t\t],\n\t\t\tKey: path,\n\t\t});\n\n\t\tconst keys = Object.keys(values);\n\t\tconst fields = keys.map((key) => ({ key, value: values[key] || '' }));\n\n\t\treturn { url, fields };\n\t}\n\n\tasync upload(\n\t\tkey: string,\n\t\tdata: string | Buffer,\n\t\tcontentType: string,\n\t): Promise<void> {\n\t\tconst Body = typeof data === 'string' ? Buffer.from(data, 'base64') : data;\n\n\t\tconst params = {\n\t\t\tBucket: this.bucket,\n\t\t\tKey: key,\n\t\t\tBody,\n\t\t\tContentType: contentType,\n\t\t};\n\n\t\tconst command = new PutObjectCommand(params);\n\n\t\tawait this.client.send(command);\n\t}\n\n\tasync delete(key: string): Promise<void> {\n\t\tconst command = new DeleteObjectCommand({\n\t\t\tBucket: this.bucket,\n\t\t\tKey: key,\n\t\t});\n\n\t\tawait this.client.send(command);\n\t}\n}\n\nexport enum AmazonCannedAccessControlList {\n\tAuthenticatedRead = 'authenticated-read',\n\tPrivate = 'private',\n\tPublicRead = 'public-read',\n\tPublicReadWrite = 'public-read-write',\n\tAwsExecRead = 'aws-exec-read',\n\tBucketOwnerRead = 'bucket-owner-read',\n\tBucketOwnerFullControl = 'bucket-owner-full-control',\n\tLogDeliveryWrite = 'log-delivery-write',\n}\n\ninterface AmazonStorageClientCreateOptions {\n\tbucket: string;\n\tregion?: string;\n\tacl?: AmazonCannedAccessControlList;\n\taccessKeyId?: string;\n\tsecretAccessKey?: string;\n\tendpoint?: string;\n\tforcePathStyle?: boolean;\n\tcache?: Cache;\n}\n","/**\n * The S3 driver — `s3://` URLs to an {@link AmazonStorageClient}.\n *\n * Registered by whoever assembles the application, so neutral code can build a\n * client from a URL without importing this file or the AWS SDK behind it.\n */\n\nimport { AmazonStorageClient } from './AmazonStorageClient';\nimport type { StorageDriver } from './registry';\nimport { parse } from './s3Url';\n\nexport const s3Driver: StorageDriver = {\n\tscheme: 's3:',\n\tcreate(url) {\n\t\tconst { bucket, region, endpoint, forcePathStyle } = parse(url);\n\t\treturn AmazonStorageClient.create({\n\t\t\tbucket,\n\t\t\tregion,\n\t\t\tendpoint,\n\t\t\tforcePathStyle,\n\t\t});\n\t},\n};\n"],"mappings":"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"}

package/dist/chunk-B9dir_RE.mjs

@@ -0,0 +1,11 @@
+//#region rolldown:runtime
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+};
+
+//#endregion
+export { __export };

package/dist/errors-Bce0CJ11.cjs

@@ -0,0 +1,109 @@
+
+//#region src/errors.ts
+/**
+* Storage errors — shared by every implementation, not just S3.
+*
+* A `gs://` or Azure client hits the same three problems as the S3 one: the
+* string is not a URL, it is a URL for a different provider, or it addresses no
+* bucket. Each carries the provider-specific detail as a field, so the type is
+* common while the specifics stay accurate.
+*
+* Messages state the rule, which is constant, and never interpolate the value.
+* An interpolated message cannot be matched on, reads differently every time it
+* is thrown, and carries user input into every log line that touches it.
+*/
+/** Base for anything wrong with a storage URL, so callers may catch broadly. */
+var StorageUrlError = class extends Error {
+	/** The URL that could not be used. */
+	url;
+	constructor(url, message) {
+		super(message);
+		this.url = url;
+		this.name = new.target.name;
+	}
+};
+/** The string is not a URL at all. */
+var MalformedStorageUrl = class extends StorageUrlError {
+	constructor(url) {
+		super(url, "Not a valid URL");
+	}
+};
+/**
+* A URL, but for a different provider — a `gs://` URL reaching the S3 client,
+* or the reverse. The usual cause is a construct resolving against the wrong
+* target, which is worth distinguishing from a malformed string.
+*/
+var UnexpectedStorageScheme = class extends StorageUrlError {
+	/** The scheme this client handles, e.g. `'s3:'`. */
+	expected;
+	/** The scheme the URL actually carried, e.g. `'gs:'`. */
+	actual;
+	constructor(url, expected, actual) {
+		super(url, "Storage URL is for a different provider");
+		this.expected = expected;
+		this.actual = actual;
+	}
+};
+/**
+* A well-formed URL that addresses no bucket.
+*
+* "Bucket" is the term S3 and GCS share; Azure calls the same thing a
+* container. One error covers all three — the word in the message is the
+* common one rather than a new abstraction nobody uses.
+*/
+var MissingStorageBucket = class extends StorageUrlError {
+	constructor(url) {
+		super(url, "Storage URL must address a bucket");
+	}
+};
+/**
+* No driver is registered for the URL's scheme.
+*
+* Usually means the build pinned a driver for a different target, or an entry
+* point registered nothing at all — so the registered schemes are carried
+* alongside, since "what *is* available" is the actionable half.
+*/
+var UnregisteredStorageScheme = class extends StorageUrlError {
+	/** The scheme that had no driver, e.g. `'gs:'`. */
+	scheme;
+	/** What is registered, so the caller can see what was pinned instead. */
+	registered;
+	constructor(url, scheme, registered) {
+		super(url, "No storage driver is registered for this URL scheme");
+		this.scheme = scheme;
+		this.registered = registered;
+	}
+};
+
+//#endregion
+Object.defineProperty(exports, 'MalformedStorageUrl', {
+  enumerable: true,
+  get: function () {
+    return MalformedStorageUrl;
+  }
+});
+Object.defineProperty(exports, 'MissingStorageBucket', {
+  enumerable: true,
+  get: function () {
+    return MissingStorageBucket;
+  }
+});
+Object.defineProperty(exports, 'StorageUrlError', {
+  enumerable: true,
+  get: function () {
+    return StorageUrlError;
+  }
+});
+Object.defineProperty(exports, 'UnexpectedStorageScheme', {
+  enumerable: true,
+  get: function () {
+    return UnexpectedStorageScheme;
+  }
+});
+Object.defineProperty(exports, 'UnregisteredStorageScheme', {
+  enumerable: true,
+  get: function () {
+    return UnregisteredStorageScheme;
+  }
+});
+//# sourceMappingURL=errors-Bce0CJ11.cjs.map

package/dist/errors-Bce0CJ11.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-Bce0CJ11.cjs","names":["url: string","message: string","expected: string","actual: string","scheme: string","registered: readonly string[]"],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * Storage errors — shared by every implementation, not just S3.\n *\n * A `gs://` or Azure client hits the same three problems as the S3 one: the\n * string is not a URL, it is a URL for a different provider, or it addresses no\n * bucket. Each carries the provider-specific detail as a field, so the type is\n * common while the specifics stay accurate.\n *\n * Messages state the rule, which is constant, and never interpolate the value.\n * An interpolated message cannot be matched on, reads differently every time it\n * is thrown, and carries user input into every log line that touches it.\n */\n\n/** Base for anything wrong with a storage URL, so callers may catch broadly. */\nexport abstract class StorageUrlError extends Error {\n\t/** The URL that could not be used. */\n\treadonly url: string;\n\n\tconstructor(url: string, message: string) {\n\t\tsuper(message);\n\t\tthis.url = url;\n\t\tthis.name = new.target.name;\n\t}\n}\n\n/** The string is not a URL at all. */\nexport class MalformedStorageUrl extends StorageUrlError {\n\tconstructor(url: string) {\n\t\tsuper(url, 'Not a valid URL');\n\t}\n}\n\n/**\n * A URL, but for a different provider — a `gs://` URL reaching the S3 client,\n * or the reverse. The usual cause is a construct resolving against the wrong\n * target, which is worth distinguishing from a malformed string.\n */\nexport class UnexpectedStorageScheme extends StorageUrlError {\n\t/** The scheme this client handles, e.g. `'s3:'`. */\n\treadonly expected: string;\n\t/** The scheme the URL actually carried, e.g. `'gs:'`. */\n\treadonly actual: string;\n\n\tconstructor(url: string, expected: string, actual: string) {\n\t\tsuper(url, 'Storage URL is for a different provider');\n\t\tthis.expected = expected;\n\t\tthis.actual = actual;\n\t}\n}\n\n/**\n * A well-formed URL that addresses no bucket.\n *\n * \"Bucket\" is the term S3 and GCS share; Azure calls the same thing a\n * container. One error covers all three — the word in the message is the\n * common one rather than a new abstraction nobody uses.\n */\nexport class MissingStorageBucket extends StorageUrlError {\n\tconstructor(url: string) {\n\t\tsuper(url, 'Storage URL must address a bucket');\n\t}\n}\n\n/**\n * No driver is registered for the URL's scheme.\n *\n * Usually means the build pinned a driver for a different target, or an entry\n * point registered nothing at all — so the registered schemes are carried\n * alongside, since \"what *is* available\" is the actionable half.\n */\nexport class UnregisteredStorageScheme extends StorageUrlError {\n\t/** The scheme that had no driver, e.g. `'gs:'`. */\n\treadonly scheme: string;\n\t/** What is registered, so the caller can see what was pinned instead. */\n\treadonly registered: readonly string[];\n\n\tconstructor(url: string, scheme: string, registered: readonly string[]) {\n\t\tsuper(url, 'No storage driver is registered for this URL scheme');\n\t\tthis.scheme = scheme;\n\t\tthis.registered = registered;\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;AAcA,IAAsB,kBAAtB,cAA8C,MAAM;;CAEnD,AAAS;CAET,YAAYA,KAAaC,SAAiB;AACzC,QAAM,QAAQ;AACd,OAAK,MAAM;AACX,OAAK,OAAO,IAAI,OAAO;CACvB;AACD;;AAGD,IAAa,sBAAb,cAAyC,gBAAgB;CACxD,YAAYD,KAAa;AACxB,QAAM,KAAK,kBAAkB;CAC7B;AACD;;;;;;AAOD,IAAa,0BAAb,cAA6C,gBAAgB;;CAE5D,AAAS;;CAET,AAAS;CAET,YAAYA,KAAaE,UAAkBC,QAAgB;AAC1D,QAAM,KAAK,0CAA0C;AACrD,OAAK,WAAW;AAChB,OAAK,SAAS;CACd;AACD;;;;;;;;AASD,IAAa,uBAAb,cAA0C,gBAAgB;CACzD,YAAYH,KAAa;AACxB,QAAM,KAAK,oCAAoC;CAC/C;AACD;;;;;;;;AASD,IAAa,4BAAb,cAA+C,gBAAgB;;CAE9D,AAAS;;CAET,AAAS;CAET,YAAYA,KAAaI,QAAgBC,YAA+B;AACvE,QAAM,KAAK,sDAAsD;AACjE,OAAK,SAAS;AACd,OAAK,aAAa;CAClB;AACD"}