@geekmidas/storage 0.0.4 → 0.1.0

package/README.md

@@ -11,6 +11,7 @@ A comprehensive, type-safe storage client for cloud storage services with suppor
 - **Direct uploads**: Upload files directly to storage without intermediate servers
 - **Flexible configuration**: Support for custom endpoints (useful for MinIO, LocalStack, etc.)
 - **Modern async/await API**: Promise-based interface throughout
+- **URL caching**: Built-in support for caching presigned URLs to reduce API calls and improve performance
 
 ## Installation
 
@@ -32,6 +33,7 @@ npm install @aws-sdk/client-s3 @aws-sdk/s3-presigned-post @aws-sdk/s3-request-pr
 
 ```typescript
 import { AmazonStorageClient } from '@geekmidas/storage/aws';
+import { InMemoryCache } from '@geekmidas/cache/memory';
 
 // Create client with credentials
 const storage = AmazonStorageClient.create({
@@ -41,6 +43,16 @@ const storage = AmazonStorageClient.create({
   secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
 });
 
+// Create client with caching enabled
+const cache = new InMemoryCache<string>();
+const storageWithCache = AmazonStorageClient.create({
+  bucket: 'my-bucket',
+  region: 'us-east-1',
+  accessKeyId: process.env.AWS_ACCESS_KEY_ID,
+  secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
+  cache,
+});
+
 // Upload a file directly
 await storage.upload('documents/readme.txt', 'Hello, World!', 'text/plain');
 
@@ -82,6 +94,7 @@ The core interface that all storage providers implement:
 ```typescript
 interface StorageClient {
   readonly provider: StorageProvider;
+  readonly cache?: Cache<string>;
   
   // Direct upload
   upload(key: string, data: string | Buffer, contentType: string): Promise<void>;
@@ -114,6 +127,8 @@ AmazonStorageClient.create(options: AmazonStorageClientCreateOptions)
 - `secretAccessKey`: AWS secret access key
 - `endpoint`: Custom S3 endpoint (useful for MinIO, LocalStack)
 - `acl`: Canned ACL for uploads (default: `authenticated-read`)
+- `cache`: Optional cache implementation for storing presigned URLs
+- `forcePathStyle`: Force path-style URLs (useful for MinIO)
 
 #### Methods
 
@@ -132,7 +147,7 @@ await storage.upload('files/binary.dat', buffer, 'application/octet-stream');
 
 ##### `getDownloadURL(file: File, expiresIn?: number): Promise<string>`
 
-Generate a presigned download URL.
+Generate a presigned download URL. When a cache is configured, URLs will be cached based on the file path.
 
 ```typescript
 // Simple download URL
@@ -148,6 +163,12 @@ const url = await storage.getDownloadURL({
 const url = await storage.getDownloadURL({ path: 'documents/file.pdf' }, 3600);
 ```
 
+**Caching behavior:**
+- URLs are cached with key format: `download-url:{file.path}`
+- Cache TTL is set to `expiresIn - 60` seconds (with 1 minute buffer)
+- URLs with expiration < 60 seconds are not cached
+- Cached URLs are returned immediately without generating new presigned URLs
+
 ##### `getUploadURL(params: GetUploadParams, expiresIn?: number): Promise<string>`
 
 Generate a presigned PUT upload URL.
@@ -257,6 +278,7 @@ enum StorageProvider {
 ```typescript
 import { S3Client } from '@aws-sdk/client-s3';
 import { AmazonStorageClient, AmazonCannedAccessControlList } from '@geekmidas/storage/aws';
+import { InMemoryCache } from '@geekmidas/cache/memory';
 
 const s3Client = new S3Client({
   region: 'us-east-1',
@@ -266,11 +288,21 @@ const s3Client = new S3Client({
   },
 });
 
+// Without cache
 const storage = new AmazonStorageClient(
   s3Client,
   'my-bucket',
   AmazonCannedAccessControlList.PublicRead
 );
+
+// With cache
+const cache = new InMemoryCache<string>();
+const storageWithCache = new AmazonStorageClient(
+  s3Client,
+  'my-bucket',
+  AmazonCannedAccessControlList.PublicRead,
+  cache
+);
 ```
 
 ### Access Control Lists (ACLs)
@@ -294,6 +326,44 @@ Available ACLs:
 - `LogDeliveryWrite` - Log delivery service gets write access
 - `AwsExecRead` - Amazon EC2 gets read access for AMI bundles
 
+### Caching
+
+Caching presigned URLs can significantly reduce the number of API calls to AWS S3 and improve performance.
+
+```typescript
+import { AmazonStorageClient } from '@geekmidas/storage/aws';
+import { InMemoryCache } from '@geekmidas/cache/memory';
+import { UpstashCache } from '@geekmidas/cache/upstash';
+
+// In-memory cache for development/testing
+const memoryCache = new InMemoryCache<string>();
+const storage = AmazonStorageClient.create({
+  bucket: 'my-bucket',
+  cache: memoryCache,
+});
+
+// Redis cache for production
+const redisCache = new UpstashCache<string>({
+  url: process.env.UPSTASH_REDIS_URL,
+  token: process.env.UPSTASH_REDIS_TOKEN,
+});
+const productionStorage = AmazonStorageClient.create({
+  bucket: 'my-bucket',
+  cache: redisCache,
+});
+
+// Cache behavior example
+const url1 = await storage.getDownloadURL({ path: 'file.pdf' }); // Generates new URL
+const url2 = await storage.getDownloadURL({ path: 'file.pdf' }); // Returns cached URL
+console.log(url1 === url2); // true
+```
+
+**Cache keys and TTL:**
+- Download URLs are cached with key: `download-url:{path}`
+- Cache TTL is automatically calculated as `expiresIn - 60` seconds
+- URLs expiring in less than 60 seconds are not cached
+- Upload URLs are not cached (they are typically single-use)
+
 ### Error Handling
 
 ```typescript

package/dist/{AmazonStorageClient-DT9DeKVz.cjs → AmazonStorageClient-BKzXhCX0.cjs}

@@ -1,14 +1,36 @@
-const require_chunk = require('./chunk-DWy1uDak.cjs');
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
 const require_StorageClient = require('./StorageClient-BDRVrMJj.cjs');
-const __aws_sdk_client_s3 = require_chunk.__toESM(require("@aws-sdk/client-s3"));
-const __aws_sdk_s3_presigned_post = require_chunk.__toESM(require("@aws-sdk/s3-presigned-post"));
-const __aws_sdk_s3_request_presigner = require_chunk.__toESM(require("@aws-sdk/s3-request-presigner"));
+const __aws_sdk_client_s3 = __toESM(require("@aws-sdk/client-s3"));
+const __aws_sdk_s3_presigned_post = __toESM(require("@aws-sdk/s3-presigned-post"));
+const __aws_sdk_s3_request_presigner = __toESM(require("@aws-sdk/s3-request-presigner"));
 
 //#region src/AmazonStorageClient.ts
 var AmazonStorageClient = class AmazonStorageClient {
 	provider = require_StorageClient.StorageProvider.AWSS3;
 	static create(options) {
-		const { bucket, region, accessKeyId, acl, endpoint, secretAccessKey, forcePathStyle = false } = options;
+		const { bucket, region, accessKeyId, acl, endpoint, secretAccessKey, forcePathStyle = false, cache } = options;
 		const hasCredentials = accessKeyId && secretAccessKey;
 		const credentials = hasCredentials ? {
 			accessKeyId,
@@ -20,12 +42,13 @@ var AmazonStorageClient = class AmazonStorageClient {
 			endpoint,
 			forcePathStyle
 		});
-		return new AmazonStorageClient(client, bucket, acl);
+		return new AmazonStorageClient(client, bucket, acl, cache);
 	}
-	constructor(client, bucket, acl = AmazonCannedAccessControlList.AuthenticatedRead) {
+	constructor(client, bucket, acl = AmazonCannedAccessControlList.AuthenticatedRead, cache) {
 		this.client = client;
 		this.bucket = bucket;
 		this.acl = acl;
+		this.cache = cache;
 	}
 	getVersionDownloadURL(file, versionId) {
 		const ResponseContentDisposition = file.name ? `attachment; filename=${encodeURIComponent(file.name)}` : void 0;
@@ -48,14 +71,20 @@ var AmazonStorageClient = class AmazonStorageClient {
 			createdAt: version.LastModified || /* @__PURE__ */ new Date()
 		}));
 	}
-	getDownloadURL(file, expiresIn = 60 * 60) {
+	async getDownloadURL(file, expiresIn = 60 * 60) {
+		const cacheKey = `download-url:${file.path}`;
+		const cachedURL = await this.cache?.get(cacheKey);
+		if (cachedURL) return cachedURL;
 		const ResponseContentDisposition = file.name ? `attachment; filename=${encodeURIComponent(file.name)}` : void 0;
 		const command = new __aws_sdk_client_s3.GetObjectCommand({
 			Bucket: this.bucket,
 			Key: file.path,
 			ResponseContentDisposition
 		});
-		return (0, __aws_sdk_s3_request_presigner.getSignedUrl)(this.client, command, { expiresIn });
+		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({
@@ -121,4 +150,5 @@ Object.defineProperty(exports, 'AmazonStorageClient', {
   get: function () {
     return AmazonStorageClient;
   }
-});
+});
+//# sourceMappingURL=AmazonStorageClient-BKzXhCX0.cjs.map

package/dist/AmazonStorageClient-BKzXhCX0.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AmazonStorageClient-BKzXhCX0.cjs","names":["StorageProvider","options: AmazonStorageClientCreateOptions","S3Client","client: S3Client","bucket: string","cache?: Cache<string>","file: File","versionId: string","GetObjectCommand","key: string","ListObjectVersionsCommand","params: GetUploadParams","PutObjectCommand","data: string | Buffer","contentType: string"],"sources":["../src/AmazonStorageClient.ts"],"sourcesContent":["import {\n  GetObjectCommand,\n  ListObjectVersionsCommand,\n  PutObjectCommand,\n  S3Client,\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  type DocumentVersion,\n  type File,\n  type GetUploadParams,\n  type GetUploadResponse,\n  type StorageClient,\n  StorageProvider,\n} from './StorageClient';\n\nexport class AmazonStorageClient implements StorageClient {\n  readonly provider = StorageProvider.AWSS3;\n\n  static create(\n    options: AmazonStorageClientCreateOptions,\n  ): AmazonStorageClient {\n    const {\n      bucket,\n      region,\n      accessKeyId,\n      acl,\n      endpoint,\n      secretAccessKey,\n      forcePathStyle = false,\n      cache,\n    } = options;\n    const hasCredentials = accessKeyId && secretAccessKey;\n    const credentials = hasCredentials\n      ? { accessKeyId, secretAccessKey }\n      : undefined;\n\n    const client = new S3Client({\n      region,\n      credentials,\n      endpoint,\n      forcePathStyle,\n    });\n\n    return new AmazonStorageClient(client, bucket, acl, cache);\n  }\n  constructor(\n    private readonly client: S3Client,\n    private readonly bucket: string,\n    private readonly acl = AmazonCannedAccessControlList.AuthenticatedRead,\n    readonly cache?: Cache<string>,\n  ) {}\n\n  getVersionDownloadURL(file: File, versionId: string): Promise<string> {\n    const ResponseContentDisposition = file.name\n      ? `attachment; filename=${encodeURIComponent(file.name)}`\n      : undefined;\n\n    const command = new GetObjectCommand({\n      Bucket: this.bucket,\n      Key: file.path,\n      ResponseContentDisposition,\n      VersionId: versionId,\n    });\n\n    return getSignedUrl(this.client, command, { expiresIn: 60 * 60 * 24 });\n  }\n\n  async getVersions(key: string): Promise<DocumentVersion[]> {\n    const command = new ListObjectVersionsCommand({\n      Bucket: this.bucket,\n      Prefix: key,\n    });\n\n    const { Versions = [] } = await this.client.send(command);\n\n    return Versions.map((version) => ({\n      id: version.VersionId || '',\n      createdAt: version.LastModified || new Date(),\n    }));\n  }\n\n  async getDownloadURL(file: File, expiresIn = 60 * 60): Promise<string> {\n    const cacheKey = `download-url:${file.path}`;\n    const cachedURL = await this.cache?.get(cacheKey);\n\n    if (cachedURL) {\n      return cachedURL;\n    }\n\n    const ResponseContentDisposition = file.name\n      ? `attachment; filename=${encodeURIComponent(file.name)}`\n      : undefined;\n\n    const command = new GetObjectCommand({\n      Bucket: this.bucket,\n      Key: file.path,\n      ResponseContentDisposition,\n    });\n\n    const url = await getSignedUrl(this.client, command, { expiresIn });\n    const cacheExpiration = Math.max(expiresIn - 60, 0);\n\n    if (cacheExpiration) {\n      await this.cache?.set(cacheKey, url, cacheExpiration);\n    }\n\n    return url;\n  }\n\n  async getUploadURL(\n    params: GetUploadParams,\n    expiresIn = 60 * 60,\n  ): Promise<string> {\n    const command = new PutObjectCommand({\n      Bucket: this.bucket,\n      Key: params.path,\n      ContentType: params.contentType,\n      ContentLength: params.contentLength,\n    });\n\n    return getSignedUrl(this.client, command, { expiresIn });\n  }\n\n  async getUpload(\n    params: GetUploadParams,\n    expiresIn = 5,\n  ): Promise<GetUploadResponse> {\n    const { path } = params;\n    const { fields: values, url } = await createPresignedPost(this.client, {\n      Expires: expiresIn * 60,\n      Bucket: this.bucket,\n      Fields: {\n        acl: this.acl,\n      },\n      Conditions: [\n        // content length restrictions: 0-1MB]\n        // ['content-length-range', 0, contentLength],\n        // specify content-type to be more generic- images only\n        // ['starts-with', '$Content-Type', 'image/'],\n        // ['starts-with', '$Content-Type', contentType],\n      ],\n      Key: path,\n    });\n\n    const keys = Object.keys(values);\n    const fields = keys.map((key) => ({ key, value: values[key] || '' }));\n\n    return { url, fields };\n  }\n\n  async upload(\n    key: string,\n    data: string | Buffer,\n    contentType: string,\n  ): Promise<void> {\n    const Body = typeof data === 'string' ? Buffer.from(data, 'base64') : data;\n\n    const params = {\n      Bucket: this.bucket,\n      Key: key,\n      Body,\n      ContentType: contentType,\n    };\n\n    const command = new PutObjectCommand(params);\n\n    await this.client.send(command);\n  }\n}\n\nexport enum AmazonCannedAccessControlList {\n  AuthenticatedRead = 'authenticated-read',\n  Private = 'private',\n  PublicRead = 'public-read',\n  PublicReadWrite = 'public-read-write',\n  AwsExecRead = 'aws-exec-read',\n  BucketOwnerRead = 'bucket-owner-read',\n  BucketOwnerFullControl = 'bucket-owner-full-control',\n  LogDeliveryWrite = 'log-delivery-write',\n}\n\ninterface AmazonStorageClientCreateOptions {\n  bucket: string;\n  region?: string;\n  acl?: AmazonCannedAccessControlList;\n  accessKeyId?: string;\n  secretAccessKey?: string;\n  endpoint?: string;\n  forcePathStyle?: boolean;\n  cache?: Cache<string>;\n}\n"],"mappings":"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"}

package/dist/{AmazonStorageClient-DJMWn8vO.mjs → AmazonStorageClient-CwUey48q.mjs}

@@ -1,4 +1,4 @@
-import { StorageProvider } from "./StorageClient-CZGIC_fz.mjs";
+import { StorageProvider } from "./StorageClient-4ADnTPnJ.mjs";
 import { 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";
@@ -7,7 +7,7 @@ import { getSignedUrl } from "@aws-sdk/s3-request-presigner";
 var AmazonStorageClient = class AmazonStorageClient {
 	provider = StorageProvider.AWSS3;
 	static create(options) {
-		const { bucket, region, accessKeyId, acl, endpoint, secretAccessKey, forcePathStyle = false } = options;
+		const { bucket, region, accessKeyId, acl, endpoint, secretAccessKey, forcePathStyle = false, cache } = options;
 		const hasCredentials = accessKeyId && secretAccessKey;
 		const credentials = hasCredentials ? {
 			accessKeyId,
@@ -19,12 +19,13 @@ var AmazonStorageClient = class AmazonStorageClient {
 			endpoint,
 			forcePathStyle
 		});
-		return new AmazonStorageClient(client, bucket, acl);
+		return new AmazonStorageClient(client, bucket, acl, cache);
 	}
-	constructor(client, bucket, acl = AmazonCannedAccessControlList.AuthenticatedRead) {
+	constructor(client, bucket, acl = AmazonCannedAccessControlList.AuthenticatedRead, cache) {
 		this.client = client;
 		this.bucket = bucket;
 		this.acl = acl;
+		this.cache = cache;
 	}
 	getVersionDownloadURL(file, versionId) {
 		const ResponseContentDisposition = file.name ? `attachment; filename=${encodeURIComponent(file.name)}` : void 0;
@@ -47,14 +48,20 @@ var AmazonStorageClient = class AmazonStorageClient {
 			createdAt: version.LastModified || /* @__PURE__ */ new Date()
 		}));
 	}
-	getDownloadURL(file, expiresIn = 60 * 60) {
+	async getDownloadURL(file, expiresIn = 60 * 60) {
+		const cacheKey = `download-url:${file.path}`;
+		const cachedURL = await this.cache?.get(cacheKey);
+		if (cachedURL) return cachedURL;
 		const ResponseContentDisposition = file.name ? `attachment; filename=${encodeURIComponent(file.name)}` : void 0;
 		const command = new GetObjectCommand({
 			Bucket: this.bucket,
 			Key: file.path,
 			ResponseContentDisposition
 		});
-		return getSignedUrl(this.client, command, { expiresIn });
+		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({
@@ -109,4 +116,5 @@ let AmazonCannedAccessControlList = /* @__PURE__ */ function(AmazonCannedAccessC
 }({});
 
 //#endregion
-export { AmazonCannedAccessControlList, AmazonStorageClient };
+export { AmazonCannedAccessControlList, AmazonStorageClient };
+//# sourceMappingURL=AmazonStorageClient-CwUey48q.mjs.map

package/dist/AmazonStorageClient-CwUey48q.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AmazonStorageClient-CwUey48q.mjs","names":["options: AmazonStorageClientCreateOptions","client: S3Client","bucket: string","cache?: Cache<string>","file: File","versionId: string","key: string","params: GetUploadParams","data: string | Buffer","contentType: string"],"sources":["../src/AmazonStorageClient.ts"],"sourcesContent":["import {\n  GetObjectCommand,\n  ListObjectVersionsCommand,\n  PutObjectCommand,\n  S3Client,\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  type DocumentVersion,\n  type File,\n  type GetUploadParams,\n  type GetUploadResponse,\n  type StorageClient,\n  StorageProvider,\n} from './StorageClient';\n\nexport class AmazonStorageClient implements StorageClient {\n  readonly provider = StorageProvider.AWSS3;\n\n  static create(\n    options: AmazonStorageClientCreateOptions,\n  ): AmazonStorageClient {\n    const {\n      bucket,\n      region,\n      accessKeyId,\n      acl,\n      endpoint,\n      secretAccessKey,\n      forcePathStyle = false,\n      cache,\n    } = options;\n    const hasCredentials = accessKeyId && secretAccessKey;\n    const credentials = hasCredentials\n      ? { accessKeyId, secretAccessKey }\n      : undefined;\n\n    const client = new S3Client({\n      region,\n      credentials,\n      endpoint,\n      forcePathStyle,\n    });\n\n    return new AmazonStorageClient(client, bucket, acl, cache);\n  }\n  constructor(\n    private readonly client: S3Client,\n    private readonly bucket: string,\n    private readonly acl = AmazonCannedAccessControlList.AuthenticatedRead,\n    readonly cache?: Cache<string>,\n  ) {}\n\n  getVersionDownloadURL(file: File, versionId: string): Promise<string> {\n    const ResponseContentDisposition = file.name\n      ? `attachment; filename=${encodeURIComponent(file.name)}`\n      : undefined;\n\n    const command = new GetObjectCommand({\n      Bucket: this.bucket,\n      Key: file.path,\n      ResponseContentDisposition,\n      VersionId: versionId,\n    });\n\n    return getSignedUrl(this.client, command, { expiresIn: 60 * 60 * 24 });\n  }\n\n  async getVersions(key: string): Promise<DocumentVersion[]> {\n    const command = new ListObjectVersionsCommand({\n      Bucket: this.bucket,\n      Prefix: key,\n    });\n\n    const { Versions = [] } = await this.client.send(command);\n\n    return Versions.map((version) => ({\n      id: version.VersionId || '',\n      createdAt: version.LastModified || new Date(),\n    }));\n  }\n\n  async getDownloadURL(file: File, expiresIn = 60 * 60): Promise<string> {\n    const cacheKey = `download-url:${file.path}`;\n    const cachedURL = await this.cache?.get(cacheKey);\n\n    if (cachedURL) {\n      return cachedURL;\n    }\n\n    const ResponseContentDisposition = file.name\n      ? `attachment; filename=${encodeURIComponent(file.name)}`\n      : undefined;\n\n    const command = new GetObjectCommand({\n      Bucket: this.bucket,\n      Key: file.path,\n      ResponseContentDisposition,\n    });\n\n    const url = await getSignedUrl(this.client, command, { expiresIn });\n    const cacheExpiration = Math.max(expiresIn - 60, 0);\n\n    if (cacheExpiration) {\n      await this.cache?.set(cacheKey, url, cacheExpiration);\n    }\n\n    return url;\n  }\n\n  async getUploadURL(\n    params: GetUploadParams,\n    expiresIn = 60 * 60,\n  ): Promise<string> {\n    const command = new PutObjectCommand({\n      Bucket: this.bucket,\n      Key: params.path,\n      ContentType: params.contentType,\n      ContentLength: params.contentLength,\n    });\n\n    return getSignedUrl(this.client, command, { expiresIn });\n  }\n\n  async getUpload(\n    params: GetUploadParams,\n    expiresIn = 5,\n  ): Promise<GetUploadResponse> {\n    const { path } = params;\n    const { fields: values, url } = await createPresignedPost(this.client, {\n      Expires: expiresIn * 60,\n      Bucket: this.bucket,\n      Fields: {\n        acl: this.acl,\n      },\n      Conditions: [\n        // content length restrictions: 0-1MB]\n        // ['content-length-range', 0, contentLength],\n        // specify content-type to be more generic- images only\n        // ['starts-with', '$Content-Type', 'image/'],\n        // ['starts-with', '$Content-Type', contentType],\n      ],\n      Key: path,\n    });\n\n    const keys = Object.keys(values);\n    const fields = keys.map((key) => ({ key, value: values[key] || '' }));\n\n    return { url, fields };\n  }\n\n  async upload(\n    key: string,\n    data: string | Buffer,\n    contentType: string,\n  ): Promise<void> {\n    const Body = typeof data === 'string' ? Buffer.from(data, 'base64') : data;\n\n    const params = {\n      Bucket: this.bucket,\n      Key: key,\n      Body,\n      ContentType: contentType,\n    };\n\n    const command = new PutObjectCommand(params);\n\n    await this.client.send(command);\n  }\n}\n\nexport enum AmazonCannedAccessControlList {\n  AuthenticatedRead = 'authenticated-read',\n  Private = 'private',\n  PublicRead = 'public-read',\n  PublicReadWrite = 'public-read-write',\n  AwsExecRead = 'aws-exec-read',\n  BucketOwnerRead = 'bucket-owner-read',\n  BucketOwnerFullControl = 'bucket-owner-full-control',\n  LogDeliveryWrite = 'log-delivery-write',\n}\n\ninterface AmazonStorageClientCreateOptions {\n  bucket: string;\n  region?: string;\n  acl?: AmazonCannedAccessControlList;\n  accessKeyId?: string;\n  secretAccessKey?: string;\n  endpoint?: string;\n  forcePathStyle?: boolean;\n  cache?: Cache<string>;\n}\n"],"mappings":"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"}

package/dist/{AmazonStorageClient-C16fG3G4.d.cts → AmazonStorageClient-Gz0Fh1sy.d.mts}

@@ -1,14 +1,16 @@
-import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider } from "./StorageClient-D-y4QLDq.cjs";
+import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider } from "./StorageClient-XgMsiUrd.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<string>;
   readonly provider = StorageProvider.AWSS3;
   static create(options: AmazonStorageClientCreateOptions): AmazonStorageClient;
-  constructor(client: S3Client, bucket: string, acl?: AmazonCannedAccessControlList);
+  constructor(client: S3Client, bucket: string, acl?: AmazonCannedAccessControlList, cache?: Cache<string>);
   getVersionDownloadURL(file: File, versionId: string): Promise<string>;
   getVersions(key: string): Promise<DocumentVersion[]>;
   getDownloadURL(file: File, expiresIn?: number): Promise<string>;
@@ -34,6 +36,8 @@ interface AmazonStorageClientCreateOptions {
   secretAccessKey?: string;
   endpoint?: string;
   forcePathStyle?: boolean;
+  cache?: Cache<string>;
 }
 //#endregion
-export { AmazonCannedAccessControlList, AmazonStorageClient };
+export { AmazonCannedAccessControlList, AmazonStorageClient };
+//# sourceMappingURL=AmazonStorageClient-Gz0Fh1sy.d.mts.map

package/dist/{AmazonStorageClient-CP8Tx5oE.d.mts → AmazonStorageClient-aduVU3_p.d.cts}

@@ -1,14 +1,16 @@
-import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider } from "./StorageClient-CJbHRTVV.mjs";
+import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider } from "./StorageClient-CcOAW3YV.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<string>;
   readonly provider = StorageProvider.AWSS3;
   static create(options: AmazonStorageClientCreateOptions): AmazonStorageClient;
-  constructor(client: S3Client, bucket: string, acl?: AmazonCannedAccessControlList);
+  constructor(client: S3Client, bucket: string, acl?: AmazonCannedAccessControlList, cache?: Cache<string>);
   getVersionDownloadURL(file: File, versionId: string): Promise<string>;
   getVersions(key: string): Promise<DocumentVersion[]>;
   getDownloadURL(file: File, expiresIn?: number): Promise<string>;
@@ -34,6 +36,8 @@ interface AmazonStorageClientCreateOptions {
   secretAccessKey?: string;
   endpoint?: string;
   forcePathStyle?: boolean;
+  cache?: Cache<string>;
 }
 //#endregion
-export { AmazonCannedAccessControlList, AmazonStorageClient };
+export { AmazonCannedAccessControlList, AmazonStorageClient };
+//# sourceMappingURL=AmazonStorageClient-aduVU3_p.d.cts.map

package/dist/AmazonStorageClient.cjs

@@ -1,5 +1,5 @@
+const require_AmazonStorageClient = require('./AmazonStorageClient-BKzXhCX0.cjs');
 require('./StorageClient-BDRVrMJj.cjs');
-const require_AmazonStorageClient = require('./AmazonStorageClient-DT9DeKVz.cjs');
 
 exports.AmazonCannedAccessControlList = require_AmazonStorageClient.AmazonCannedAccessControlList;
 exports.AmazonStorageClient = require_AmazonStorageClient.AmazonStorageClient;

package/dist/AmazonStorageClient.d.cts

@@ -1,3 +1,3 @@
-import "./StorageClient-D-y4QLDq.cjs";
-import { AmazonCannedAccessControlList, AmazonStorageClient } from "./AmazonStorageClient-C16fG3G4.cjs";
+import "./StorageClient-CcOAW3YV.cjs";
+import { AmazonCannedAccessControlList, AmazonStorageClient } from "./AmazonStorageClient-aduVU3_p.cjs";
 export { AmazonCannedAccessControlList, AmazonStorageClient };

package/dist/AmazonStorageClient.d.mts

@@ -1,3 +1,3 @@
-import "./StorageClient-CJbHRTVV.mjs";
-import { AmazonCannedAccessControlList, AmazonStorageClient } from "./AmazonStorageClient-CP8Tx5oE.mjs";
+import "./StorageClient-XgMsiUrd.mjs";
+import { AmazonCannedAccessControlList, AmazonStorageClient } from "./AmazonStorageClient-Gz0Fh1sy.mjs";
 export { AmazonCannedAccessControlList, AmazonStorageClient };

package/dist/AmazonStorageClient.mjs

@@ -1,4 +1,4 @@
-import "./StorageClient-CZGIC_fz.mjs";
-import { AmazonCannedAccessControlList, AmazonStorageClient } from "./AmazonStorageClient-DJMWn8vO.mjs";
+import "./StorageClient-4ADnTPnJ.mjs";
+import { AmazonCannedAccessControlList, AmazonStorageClient } from "./AmazonStorageClient-CwUey48q.mjs";
 
 export { AmazonCannedAccessControlList, AmazonStorageClient };

package/dist/{StorageClient-CZGIC_fz.mjs → StorageClient-4ADnTPnJ.mjs}

@@ -7,4 +7,5 @@ let StorageProvider = /* @__PURE__ */ function(StorageProvider$1) {
 }({});
 
 //#endregion
-export { StorageProvider };
+export { StorageProvider };
+//# sourceMappingURL=StorageClient-4ADnTPnJ.mjs.map

package/dist/StorageClient-4ADnTPnJ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageClient-4ADnTPnJ.mjs","names":[],"sources":["../src/StorageClient.ts"],"sourcesContent":["import type { Cache } from '@geekmidas/cache';\nexport interface DocumentVersion {\n  id: string;\n  createdAt: Date;\n}\n\nexport enum StorageProvider {\n  AWSS3 = 'geekimdas.toolbox.storage.aws.s3',\n  GCP = 'geekimdas.toolbox.storage.gcp',\n  AZURE = 'geekimdas.toolbox.storage.azure',\n}\n\nexport interface StorageClient {\n  readonly provider: StorageProvider;\n  readonly cache?: Cache<string>;\n  /**\n   * Get a URL to upload a file to.\n   *\n   * @param params - The parameters to get the upload URL for.\n   * @param expiresIn - The number of minutes the URL should be valid for.\n   * Defaults to 60 * 60 (1 hour).\n   * @returns A promise that resolves to the upload URL.\n   */\n  getUploadURL(params: GetUploadParams, expiresIn?: number): Promise<string>;\n\n  /**\n   * Get a URL to download a file from.\n   *\n   * @param file - The file to get the download URL for.\n   * @param expiresIn - The number of seconds the URL should be valid for.\n   * Defaults to 60 * 60 (1 hour).\n   * @returns A promise that resolves to the download URL.\n   */\n  getDownloadURL(file: File, expiresIn?: number): Promise<string>;\n  /**\n   * Get the versions for a key.\n   *\n   * @param key - The key to get the versions for.\n   */\n  getVersions(key: string): Promise<DocumentVersion[]>;\n\n  /**\n   * Get a URL to download a version of a file from.\n   *\n   * @param file - The file to get the download URL for.\n   * @param versionId - The version ID to get the download URL for.\n   */\n  getVersionDownloadURL(file: File, versionId: string): Promise<string>;\n  /**\n   *\n   * @param key - The key to upload the file to.\n   * @param data - The data to upload.\n   * @param contentType - The content type of the data.\n   */\n  upload(\n    key: string,\n    data: string | Buffer,\n    contentType: string,\n  ): Promise<void>;\n  /**\n   * Get a URL to upload a file to.\n   *\n   * @param params - The parameters to get the upload URL for.\n   * @param expiresIn - The number of minutes the URL should be valid for.\n   */\n  getUpload(\n    params: GetUploadParams,\n    expiresIn?: number,\n  ): Promise<GetUploadResponse>;\n}\n\nexport interface GetUploadParams {\n  path: string;\n  contentType: string;\n  contentLength: number;\n}\n\nexport type UploadField = {\n  key: string;\n  value: string;\n};\n\nexport type GetUploadResponse = {\n  url: string;\n  fields: UploadField[];\n};\n\nexport interface File {\n  name?: string;\n  path: string;\n}\n"],"mappings":";AAMA,IAAY,8DAAL;AACL;AACA;AACA;;AACD"}

package/dist/StorageClient-BDRVrMJj.cjs

@@ -13,4 +13,5 @@ Object.defineProperty(exports, 'StorageProvider', {
   get: function () {
     return StorageProvider;
   }
-});
+});
+//# sourceMappingURL=StorageClient-BDRVrMJj.cjs.map

package/dist/StorageClient-BDRVrMJj.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageClient-BDRVrMJj.cjs","names":[],"sources":["../src/StorageClient.ts"],"sourcesContent":["import type { Cache } from '@geekmidas/cache';\nexport interface DocumentVersion {\n  id: string;\n  createdAt: Date;\n}\n\nexport enum StorageProvider {\n  AWSS3 = 'geekimdas.toolbox.storage.aws.s3',\n  GCP = 'geekimdas.toolbox.storage.gcp',\n  AZURE = 'geekimdas.toolbox.storage.azure',\n}\n\nexport interface StorageClient {\n  readonly provider: StorageProvider;\n  readonly cache?: Cache<string>;\n  /**\n   * Get a URL to upload a file to.\n   *\n   * @param params - The parameters to get the upload URL for.\n   * @param expiresIn - The number of minutes the URL should be valid for.\n   * Defaults to 60 * 60 (1 hour).\n   * @returns A promise that resolves to the upload URL.\n   */\n  getUploadURL(params: GetUploadParams, expiresIn?: number): Promise<string>;\n\n  /**\n   * Get a URL to download a file from.\n   *\n   * @param file - The file to get the download URL for.\n   * @param expiresIn - The number of seconds the URL should be valid for.\n   * Defaults to 60 * 60 (1 hour).\n   * @returns A promise that resolves to the download URL.\n   */\n  getDownloadURL(file: File, expiresIn?: number): Promise<string>;\n  /**\n   * Get the versions for a key.\n   *\n   * @param key - The key to get the versions for.\n   */\n  getVersions(key: string): Promise<DocumentVersion[]>;\n\n  /**\n   * Get a URL to download a version of a file from.\n   *\n   * @param file - The file to get the download URL for.\n   * @param versionId - The version ID to get the download URL for.\n   */\n  getVersionDownloadURL(file: File, versionId: string): Promise<string>;\n  /**\n   *\n   * @param key - The key to upload the file to.\n   * @param data - The data to upload.\n   * @param contentType - The content type of the data.\n   */\n  upload(\n    key: string,\n    data: string | Buffer,\n    contentType: string,\n  ): Promise<void>;\n  /**\n   * Get a URL to upload a file to.\n   *\n   * @param params - The parameters to get the upload URL for.\n   * @param expiresIn - The number of minutes the URL should be valid for.\n   */\n  getUpload(\n    params: GetUploadParams,\n    expiresIn?: number,\n  ): Promise<GetUploadResponse>;\n}\n\nexport interface GetUploadParams {\n  path: string;\n  contentType: string;\n  contentLength: number;\n}\n\nexport type UploadField = {\n  key: string;\n  value: string;\n};\n\nexport type GetUploadResponse = {\n  url: string;\n  fields: UploadField[];\n};\n\nexport interface File {\n  name?: string;\n  path: string;\n}\n"],"mappings":";;AAMA,IAAY,8DAAL;AACL;AACA;AACA;;AACD"}

package/dist/{StorageClient-D-y4QLDq.d.cts → StorageClient-CcOAW3YV.d.cts}

@@ -1,3 +1,5 @@
+import { Cache } from "@geekmidas/cache";
+
 //#region src/StorageClient.d.ts
 interface DocumentVersion {
   id: string;
@@ -10,6 +12,7 @@ declare enum StorageProvider {
 }
 interface StorageClient {
   readonly provider: StorageProvider;
+  readonly cache?: Cache<string>;
   /**
    * Get a URL to upload a file to.
    *
@@ -74,4 +77,5 @@ interface File {
   path: string;
 }
 //#endregion
-export { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider, UploadField };
+export { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider, UploadField };
+//# sourceMappingURL=StorageClient-CcOAW3YV.d.cts.map

package/dist/{StorageClient-CJbHRTVV.d.mts → StorageClient-XgMsiUrd.d.mts}

@@ -1,3 +1,5 @@
+import { Cache } from "@geekmidas/cache";
+
 //#region src/StorageClient.d.ts
 interface DocumentVersion {
   id: string;
@@ -10,6 +12,7 @@ declare enum StorageProvider {
 }
 interface StorageClient {
   readonly provider: StorageProvider;
+  readonly cache?: Cache<string>;
   /**
    * Get a URL to upload a file to.
    *
@@ -74,4 +77,5 @@ interface File {
   path: string;
 }
 //#endregion
-export { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider, UploadField };
+export { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider, UploadField };
+//# sourceMappingURL=StorageClient-XgMsiUrd.d.mts.map

package/dist/StorageClient.d.cts

@@ -1,2 +1,2 @@
-import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider, UploadField } from "./StorageClient-D-y4QLDq.cjs";
+import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider, UploadField } from "./StorageClient-CcOAW3YV.cjs";
 export { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider, UploadField };

package/dist/StorageClient.d.mts

@@ -1,2 +1,2 @@
-import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider, UploadField } from "./StorageClient-CJbHRTVV.mjs";
+import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider, UploadField } from "./StorageClient-XgMsiUrd.mjs";
 export { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient, StorageProvider, UploadField };

package/dist/StorageClient.mjs

@@ -1,3 +1,3 @@
-import { StorageProvider } from "./StorageClient-CZGIC_fz.mjs";
+import { StorageProvider } from "./StorageClient-4ADnTPnJ.mjs";
 
 export { StorageProvider };

package/dist/aws.cjs

@@ -1,5 +1,5 @@
+const require_AmazonStorageClient = require('./AmazonStorageClient-BKzXhCX0.cjs');
 require('./StorageClient-BDRVrMJj.cjs');
-const require_AmazonStorageClient = require('./AmazonStorageClient-DT9DeKVz.cjs');
 
 exports.AmazonCannedAccessControlList = require_AmazonStorageClient.AmazonCannedAccessControlList;
 exports.AmazonStorageClient = require_AmazonStorageClient.AmazonStorageClient;

package/dist/aws.d.cts

@@ -1,3 +1,3 @@
-import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient } from "./StorageClient-D-y4QLDq.cjs";
-import { AmazonCannedAccessControlList, AmazonStorageClient } from "./AmazonStorageClient-C16fG3G4.cjs";
+import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient } from "./StorageClient-CcOAW3YV.cjs";
+import { AmazonCannedAccessControlList, AmazonStorageClient } from "./AmazonStorageClient-aduVU3_p.cjs";
 export { AmazonCannedAccessControlList, AmazonStorageClient, DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient };

package/dist/aws.d.mts

@@ -1,3 +1,3 @@
-import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient } from "./StorageClient-CJbHRTVV.mjs";
-import { AmazonCannedAccessControlList, AmazonStorageClient } from "./AmazonStorageClient-CP8Tx5oE.mjs";
+import { DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient } from "./StorageClient-XgMsiUrd.mjs";
+import { AmazonCannedAccessControlList, AmazonStorageClient } from "./AmazonStorageClient-Gz0Fh1sy.mjs";
 export { AmazonCannedAccessControlList, AmazonStorageClient, DocumentVersion, File, GetUploadParams, GetUploadResponse, StorageClient };

package/dist/aws.mjs

@@ -1,4 +1,4 @@
-import "./StorageClient-CZGIC_fz.mjs";
-import { AmazonCannedAccessControlList, AmazonStorageClient } from "./AmazonStorageClient-DJMWn8vO.mjs";
+import "./StorageClient-4ADnTPnJ.mjs";
+import { AmazonCannedAccessControlList, AmazonStorageClient } from "./AmazonStorageClient-CwUey48q.mjs";
 
 export { AmazonCannedAccessControlList, AmazonStorageClient };

package/dist/index.d.cts

@@ -1,2 +1,2 @@
-import { StorageClient } from "./StorageClient-D-y4QLDq.cjs";
+import { StorageClient } from "./StorageClient-CcOAW3YV.cjs";
 export { StorageClient };

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { StorageClient } from "./StorageClient-CJbHRTVV.mjs";
+import { StorageClient } from "./StorageClient-XgMsiUrd.mjs";
 export { StorageClient };

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "@geekmidas/storage",
-  "version": "0.0.4",
+  "version": "0.1.0",
   "private": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/geekmidas/toolbox"
+  },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -21,10 +25,31 @@
   },
   "dependencies": {},
   "peerDependencies": {
-    "zod": "~3.25.67",
+    "zod": "~4.1.13",
     "@aws-sdk/client-s3": "~3.844.0",
     "@aws-sdk/s3-presigned-post": "^3.844.0",
-    "@aws-sdk/s3-request-presigner": "~3.844.0"
+    "@aws-sdk/s3-request-presigner": "~3.844.0",
+    "@geekmidas/cache": "^0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@geekmidas/cache": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    },
+    "@aws-sdk/client-s3": {
+      "optional": true
+    },
+    "@aws-sdk/s3-presigned-post": {
+      "optional": true
+    },
+    "@aws-sdk/s3-request-presigner": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@geekmidas/cache": "^0.1.0"
   },
   "scripts": {}
 }