@casfa/storage-s3 0.1.0 → 0.3.0

package/README.md

@@ -30,28 +30,6 @@ await storage.put('node:abcd1234...', data);
 
 // Retrieve data
 const data = await storage.get('node:abcd1234...');
-
-// Check existence
-const exists = await storage.has('node:abcd1234...');
-
-// Delete
-const deleted = await storage.delete('node:abcd1234...');
-```
-
-### With LRU Cache
-
-```typescript
-import { createS3StorageWithCache } from '@casfa/storage-s3';
-
-const storage = createS3StorageWithCache({
-  bucket: 'my-cas-bucket',
-  region: 'us-east-1',
-  cacheSize: 1000,      // Max items in cache
-  cacheMaxAge: 300000,  // 5 minutes TTL
-});
-
-// Cache reduces S3 API calls for repeated reads
-const data = await storage.get('node:abcd1234...');
 ```
 
 ### With Custom S3 Client
@@ -95,18 +73,6 @@ interface S3StorageConfig {
 }
 ```
 
-### Cache Options
-
-```typescript
-interface S3StorageWithCacheConfig extends S3StorageConfig {
-  // Max items in LRU cache (default: 1000)
-  cacheSize?: number;
-  
-  // Cache TTL in milliseconds (default: 60000)
-  cacheMaxAge?: number;
-}
-```
-
 ## S3 Key Structure
 
 Objects are stored with sharded prefixes for better S3 performance:
@@ -121,8 +87,7 @@ Where `ab` and `cd` are the first 4 characters of the hash, providing good distr
 
 ### Functions
 
-- `createS3Storage(config)` - Create S3 storage without cache
-- `createS3StorageWithCache(config)` - Create S3 storage with LRU cache
+- `createS3Storage(config)` - Create S3 storage
 
 ### StorageProvider Interface
 
@@ -130,8 +95,6 @@ Where `ab` and `cd` are the first 4 characters of the hash, providing good distr
 interface StorageProvider {
   get(key: string): Promise<Uint8Array | null>;
   put(key: string, data: Uint8Array): Promise<void>;
-  has(key: string): Promise<boolean>;
-  delete(key: string): Promise<boolean>;
 }
 ```
 

package/README.zh-CN.md

@@ -30,28 +30,6 @@ await storage.put('node:abcd1234...', data);
 
 // 检索数据
 const data = await storage.get('node:abcd1234...');
-
-// 检查是否存在
-const exists = await storage.has('node:abcd1234...');
-
-// 删除
-const deleted = await storage.delete('node:abcd1234...');
-```
-
-### 带 LRU 缓存
-
-```typescript
-import { createS3StorageWithCache } from '@casfa/storage-s3';
-
-const storage = createS3StorageWithCache({
-  bucket: 'my-cas-bucket',
-  region: 'us-east-1',
-  cacheSize: 1000,      // 缓存最大条目数
-  cacheMaxAge: 300000,  // 5 分钟 TTL
-});
-
-// 缓存减少 S3 API 调用，降低重复读取延迟
-const data = await storage.get('node:abcd1234...');
 ```
 
 ### 使用自定义 S3 客户端
@@ -121,8 +99,7 @@ interface S3StorageWithCacheConfig extends S3StorageConfig {
 
 ### 函数
 
-- `createS3Storage(config)` - 创建不带缓存的 S3 存储
-- `createS3StorageWithCache(config)` - 创建带 LRU 缓存的 S3 存储
+- `createS3Storage(config)` - 创建 S3 存储
 
 ### StorageProvider 接口
 
@@ -130,8 +107,6 @@ interface S3StorageWithCacheConfig extends S3StorageConfig {
 interface StorageProvider {
   get(key: string): Promise<Uint8Array | null>;
   put(key: string, data: Uint8Array): Promise<void>;
-  has(key: string): Promise<boolean>;
-  delete(key: string): Promise<boolean>;
 }
 ```
 

package/dist/index.d.ts

@@ -1,42 +1,7 @@
-import { S3Client } from '@aws-sdk/client-s3';
-import { StorageProvider } from '@casfa/storage-core';
-
 /**
- * S3 Storage Provider for CAS
+ * CAS Storage S3
  *
- * Implements StorageProvider with:
- * - LRU cache for key existence checks
- * - S3 backend storage
+ * S3 storage provider for CAS.
  */
-
-/**
- * S3 Storage configuration
- */
-type S3StorageConfig = {
-    /** S3 bucket name */
-    bucket: string;
-    /** Optional S3 client (for testing or custom config) */
-    client?: S3Client;
-    /** LRU cache size for key existence (default: 10000) */
-    cacheSize?: number;
-    /** Key prefix in S3 (default: "cas/sha256/") */
-    prefix?: string;
-};
-/**
- * Create an S3-backed storage provider
- */
-declare const createS3Storage: (config: S3StorageConfig) => StorageProvider;
-/**
- * Create S3 storage with cache control methods (for testing)
- */
-declare const createS3StorageWithCache: (config: S3StorageConfig) => {
-    clearCache: () => void;
-    getCacheStats: () => {
-        size: number;
-    };
-    has: (key: string) => Promise<boolean>;
-    get: (key: string) => Promise<Uint8Array | null>;
-    put: (key: string, value: Uint8Array) => Promise<void>;
-};
-
-export { type S3StorageConfig, createS3Storage, createS3StorageWithCache };
+export { createS3Storage, type S3StorageConfig } from "./s3-storage.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -5,49 +5,22 @@ import {
   PutObjectCommand,
   S3Client
 } from "@aws-sdk/client-s3";
-import {
-  createLRUCache,
-  DEFAULT_CACHE_SIZE,
-  toStoragePath
-} from "@casfa/storage-core";
+var toStoragePath = (key, prefix) => {
+  const subdir = key.slice(0, 2);
+  return `${prefix}${subdir}/${key}`;
+};
 var createS3Storage = (config) => {
-  const client = config.client ?? new S3Client({});
+  const client = config.client ?? new S3Client(config.region ? { region: config.region } : {});
   const bucket = config.bucket;
-  const prefix = config.prefix ?? "cas/sha256/";
-  const existsCache = createLRUCache(config.cacheSize ?? DEFAULT_CACHE_SIZE);
+  const prefix = config.prefix ?? "cas/v1/";
   const toS3Key = (casKey) => toStoragePath(casKey, prefix);
-  const has = async (key) => {
-    const cached = existsCache.get(key);
-    if (cached !== void 0) {
-      return cached;
-    }
-    try {
-      await client.send(
-        new HeadObjectCommand({
-          Bucket: bucket,
-          Key: toS3Key(key)
-        })
-      );
-      existsCache.set(key, true);
-      return true;
-    } catch (error) {
-      const err = error;
-      if (err.name === "NotFound" || err.$metadata?.httpStatusCode === 404) {
-        return false;
-      }
-      throw error;
-    }
-  };
   const get = async (key) => {
     try {
-      const result = await client.send(
-        new GetObjectCommand({
-          Bucket: bucket,
-          Key: toS3Key(key)
-        })
-      );
+      const result = await client.send(new GetObjectCommand({
+        Bucket: bucket,
+        Key: toS3Key(key)
+      }));
       const bytes = await result.Body.transformToByteArray();
-      existsCache.set(key, true);
       return new Uint8Array(bytes);
     } catch (error) {
       const err = error;
@@ -58,40 +31,30 @@ var createS3Storage = (config) => {
     }
   };
   const put = async (key, value) => {
-    if (existsCache.get(key)) {
-      return;
-    }
-    const exists = await has(key);
-    if (exists) {
+    const s3Key = toS3Key(key);
+    try {
+      await client.send(new HeadObjectCommand({
+        Bucket: bucket,
+        Key: s3Key
+      }));
       return;
+    } catch (error) {
+      const err = error;
+      if (err.name !== "NotFound" && err.$metadata?.httpStatusCode !== 404) {
+        throw error;
+      }
     }
-    await client.send(
-      new PutObjectCommand({
-        Bucket: bucket,
-        Key: toS3Key(key),
-        Body: value,
-        ContentType: "application/octet-stream"
-      })
-    );
-    existsCache.set(key, true);
-  };
-  return { has, get, put };
-};
-var createS3StorageWithCache = (config) => {
-  const client = config.client ?? new S3Client({});
-  const _bucket = config.bucket;
-  const prefix = config.prefix ?? "cas/sha256/";
-  const existsCache = createLRUCache(config.cacheSize ?? DEFAULT_CACHE_SIZE);
-  const _toS3Key = (casKey) => toStoragePath(casKey, prefix);
-  const storage = createS3Storage({ ...config, client });
-  return {
-    ...storage,
-    clearCache: () => existsCache.clear(),
-    getCacheStats: () => ({ size: existsCache.size() })
+    await client.send(new PutObjectCommand({
+      Bucket: bucket,
+      Key: s3Key,
+      Body: value,
+      ContentType: "application/octet-stream"
+    }));
   };
+  return { get, put };
 };
 export {
-  createS3Storage,
-  createS3StorageWithCache
+  createS3Storage
 };
-//# sourceMappingURL=index.js.map
+
+//# debugId=FBB9BF9E1762965D64756E2164756E21

package/dist/index.js.map

@@ -1 +1,10 @@
-{"version":3,"sources":["../src/s3-storage.ts"],"sourcesContent":["/**\n * S3 Storage Provider for CAS\n *\n * Implements StorageProvider with:\n * - LRU cache for key existence checks\n * - S3 backend storage\n */\n\nimport {\n  GetObjectCommand,\n  HeadObjectCommand,\n  PutObjectCommand,\n  S3Client,\n} from \"@aws-sdk/client-s3\";\nimport {\n  createLRUCache,\n  DEFAULT_CACHE_SIZE,\n  type StorageProvider,\n  toStoragePath,\n} from \"@casfa/storage-core\";\n\n/**\n * S3 Storage configuration\n */\nexport type S3StorageConfig = {\n  /** S3 bucket name */\n  bucket: string;\n  /** Optional S3 client (for testing or custom config) */\n  client?: S3Client;\n  /** LRU cache size for key existence (default: 10000) */\n  cacheSize?: number;\n  /** Key prefix in S3 (default: \"cas/sha256/\") */\n  prefix?: string;\n};\n\n/**\n * Create an S3-backed storage provider\n */\nexport const createS3Storage = (config: S3StorageConfig): StorageProvider => {\n  const client = config.client ?? new S3Client({});\n  const bucket = config.bucket;\n  const prefix = config.prefix ?? \"cas/sha256/\";\n  const existsCache = createLRUCache<string, boolean>(config.cacheSize ?? DEFAULT_CACHE_SIZE);\n\n  const toS3Key = (casKey: string): string => toStoragePath(casKey, prefix);\n\n  const has = async (key: string): Promise<boolean> => {\n    // Check cache first\n    const cached = existsCache.get(key);\n    if (cached !== undefined) {\n      return cached;\n    }\n\n    // Check S3\n    try {\n      await client.send(\n        new HeadObjectCommand({\n          Bucket: bucket,\n          Key: toS3Key(key),\n        })\n      );\n      existsCache.set(key, true);\n      return true;\n    } catch (error: unknown) {\n      const err = error as { name?: string; $metadata?: { httpStatusCode?: number } };\n      if (err.name === \"NotFound\" || err.$metadata?.httpStatusCode === 404) {\n        // Don't cache non-existence (it might be uploaded later)\n        return false;\n      }\n      throw error;\n    }\n  };\n\n  const get = async (key: string): Promise<Uint8Array | null> => {\n    try {\n      const result = await client.send(\n        new GetObjectCommand({\n          Bucket: bucket,\n          Key: toS3Key(key),\n        })\n      );\n\n      const bytes = await result.Body!.transformToByteArray();\n\n      // Mark as existing in cache\n      existsCache.set(key, true);\n\n      return new Uint8Array(bytes);\n    } catch (error: unknown) {\n      const err = error as { name?: string; $metadata?: { httpStatusCode?: number } };\n      if (err.name === \"NoSuchKey\" || err.$metadata?.httpStatusCode === 404) {\n        return null;\n      }\n      throw error;\n    }\n  };\n\n  const put = async (key: string, value: Uint8Array): Promise<void> => {\n    // Check cache first (avoid redundant writes)\n    if (existsCache.get(key)) {\n      return;\n    }\n\n    // Check if already exists in S3\n    const exists = await has(key);\n    if (exists) {\n      return;\n    }\n\n    // Upload to S3\n    await client.send(\n      new PutObjectCommand({\n        Bucket: bucket,\n        Key: toS3Key(key),\n        Body: value,\n        ContentType: \"application/octet-stream\",\n      })\n    );\n\n    // Mark as existing\n    existsCache.set(key, true);\n  };\n\n  return { has, get, put };\n};\n\n/**\n * Create S3 storage with cache control methods (for testing)\n */\nexport const createS3StorageWithCache = (config: S3StorageConfig) => {\n  const client = config.client ?? new S3Client({});\n  const _bucket = config.bucket;\n  const prefix = config.prefix ?? \"cas/sha256/\";\n  const existsCache = createLRUCache<string, boolean>(config.cacheSize ?? DEFAULT_CACHE_SIZE);\n\n  const _toS3Key = (casKey: string): string => toStoragePath(casKey, prefix);\n\n  const storage = createS3Storage({ ...config, client });\n\n  return {\n    ...storage,\n    clearCache: () => existsCache.clear(),\n    getCacheStats: () => ({ size: existsCache.size() }),\n  };\n};\n"],"mappings":";AAQA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EAEA;AAAA,OACK;AAmBA,IAAM,kBAAkB,CAAC,WAA6C;AAC3E,QAAM,SAAS,OAAO,UAAU,IAAI,SAAS,CAAC,CAAC;AAC/C,QAAM,SAAS,OAAO;AACtB,QAAM,SAAS,OAAO,UAAU;AAChC,QAAM,cAAc,eAAgC,OAAO,aAAa,kBAAkB;AAE1F,QAAM,UAAU,CAAC,WAA2B,cAAc,QAAQ,MAAM;AAExE,QAAM,MAAM,OAAO,QAAkC;AAEnD,UAAM,SAAS,YAAY,IAAI,GAAG;AAClC,QAAI,WAAW,QAAW;AACxB,aAAO;AAAA,IACT;AAGA,QAAI;AACF,YAAM,OAAO;AAAA,QACX,IAAI,kBAAkB;AAAA,UACpB,QAAQ;AAAA,UACR,KAAK,QAAQ,GAAG;AAAA,QAClB,CAAC;AAAA,MACH;AACA,kBAAY,IAAI,KAAK,IAAI;AACzB,aAAO;AAAA,IACT,SAAS,OAAgB;AACvB,YAAM,MAAM;AACZ,UAAI,IAAI,SAAS,cAAc,IAAI,WAAW,mBAAmB,KAAK;AAEpE,eAAO;AAAA,MACT;AACA,YAAM;AAAA,IACR;AAAA,EACF;AAEA,QAAM,MAAM,OAAO,QAA4C;AAC7D,QAAI;AACF,YAAM,SAAS,MAAM,OAAO;AAAA,QAC1B,IAAI,iBAAiB;AAAA,UACnB,QAAQ;AAAA,UACR,KAAK,QAAQ,GAAG;AAAA,QAClB,CAAC;AAAA,MACH;AAEA,YAAM,QAAQ,MAAM,OAAO,KAAM,qBAAqB;AAGtD,kBAAY,IAAI,KAAK,IAAI;AAEzB,aAAO,IAAI,WAAW,KAAK;AAAA,IAC7B,SAAS,OAAgB;AACvB,YAAM,MAAM;AACZ,UAAI,IAAI,SAAS,eAAe,IAAI,WAAW,mBAAmB,KAAK;AACrE,eAAO;AAAA,MACT;AACA,YAAM;AAAA,IACR;AAAA,EACF;AAEA,QAAM,MAAM,OAAO,KAAa,UAAqC;AAEnE,QAAI,YAAY,IAAI,GAAG,GAAG;AACxB;AAAA,IACF;AAGA,UAAM,SAAS,MAAM,IAAI,GAAG;AAC5B,QAAI,QAAQ;AACV;AAAA,IACF;AAGA,UAAM,OAAO;AAAA,MACX,IAAI,iBAAiB;AAAA,QACnB,QAAQ;AAAA,QACR,KAAK,QAAQ,GAAG;AAAA,QAChB,MAAM;AAAA,QACN,aAAa;AAAA,MACf,CAAC;AAAA,IACH;AAGA,gBAAY,IAAI,KAAK,IAAI;AAAA,EAC3B;AAEA,SAAO,EAAE,KAAK,KAAK,IAAI;AACzB;AAKO,IAAM,2BAA2B,CAAC,WAA4B;AACnE,QAAM,SAAS,OAAO,UAAU,IAAI,SAAS,CAAC,CAAC;AAC/C,QAAM,UAAU,OAAO;AACvB,QAAM,SAAS,OAAO,UAAU;AAChC,QAAM,cAAc,eAAgC,OAAO,aAAa,kBAAkB;AAE1F,QAAM,WAAW,CAAC,WAA2B,cAAc,QAAQ,MAAM;AAEzE,QAAM,UAAU,gBAAgB,EAAE,GAAG,QAAQ,OAAO,CAAC;AAErD,SAAO;AAAA,IACL,GAAG;AAAA,IACH,YAAY,MAAM,YAAY,MAAM;AAAA,IACpC,eAAe,OAAO,EAAE,MAAM,YAAY,KAAK,EAAE;AAAA,EACnD;AACF;","names":[]}
+{
+  "version": 3,
+  "sources": ["../src/s3-storage.ts"],
+  "sourcesContent": [
+    "/**\n * S3 Storage Provider for CAS\n *\n * Implements StorageProvider with:\n * - S3 backend storage\n * - Internal HeadObject check in put() to avoid redundant uploads\n */\n\nimport {\n  GetObjectCommand,\n  HeadObjectCommand,\n  PutObjectCommand,\n  S3Client,\n} from \"@aws-sdk/client-s3\";\nimport type { StorageProvider } from \"@casfa/storage-core\";\n\n/**\n * Create storage path from a CB32 storage key.\n * Uses first 2 chars as subdirectory for better distribution.\n *\n * Example: 240B5PHBGEC2A705WTKKMVRS30 -> cas/v1/24/240B5PHBGEC2A705WTKKMVRS30\n */\nconst toStoragePath = (key: string, prefix: string): string => {\n  const subdir = key.slice(0, 2);\n  return `${prefix}${subdir}/${key}`;\n};\n\n/**\n * S3 Storage configuration\n */\nexport type S3StorageConfig = {\n  /** S3 bucket name */\n  bucket: string;\n  /** AWS region for the S3 bucket (e.g. \"us-west-2\") */\n  region?: string;\n  /** Optional S3 client (for testing or custom config) */\n  client?: S3Client;\n  /** Key prefix in S3 (default: \"cas/v1/\") */\n  prefix?: string;\n};\n\n/**\n * Create an S3-backed storage provider\n */\nexport const createS3Storage = (config: S3StorageConfig): StorageProvider => {\n  const client = config.client ?? new S3Client(config.region ? { region: config.region } : {});\n  const bucket = config.bucket;\n  const prefix = config.prefix ?? \"cas/v1/\";\n\n  const toS3Key = (casKey: string): string => toStoragePath(casKey, prefix);\n\n  const get = async (key: string): Promise<Uint8Array | null> => {\n    try {\n      const result = await client.send(\n        new GetObjectCommand({\n          Bucket: bucket,\n          Key: toS3Key(key),\n        })\n      );\n\n      const bytes = await result.Body!.transformToByteArray();\n      return new Uint8Array(bytes);\n    } catch (error: unknown) {\n      const err = error as { name?: string; $metadata?: { httpStatusCode?: number } };\n      if (err.name === \"NoSuchKey\" || err.$metadata?.httpStatusCode === 404) {\n        return null;\n      }\n      throw error;\n    }\n  };\n\n  const put = async (key: string, value: Uint8Array): Promise<void> => {\n    const s3Key = toS3Key(key);\n\n    // Internal optimization: HeadObject is cheaper than PutObject\n    try {\n      await client.send(\n        new HeadObjectCommand({\n          Bucket: bucket,\n          Key: s3Key,\n        })\n      );\n      return; // already exists\n    } catch (error: unknown) {\n      const err = error as { name?: string; $metadata?: { httpStatusCode?: number } };\n      if (err.name !== \"NotFound\" && err.$metadata?.httpStatusCode !== 404) {\n        throw error; // unexpected error\n      }\n      // not found — proceed to upload\n    }\n\n    // Upload to S3\n    await client.send(\n      new PutObjectCommand({\n        Bucket: bucket,\n        Key: s3Key,\n        Body: value,\n        ContentType: \"application/octet-stream\",\n      })\n    );\n  };\n\n  return { get, put };\n};\n"
+  ],
+  "mappings": ";AAQA;AAAA;AAAA;AAAA;AAAA;AAAA;AAcA,IAAM,gBAAgB,CAAC,KAAa,WAA2B;AAAA,EAC7D,MAAM,SAAS,IAAI,MAAM,GAAG,CAAC;AAAA,EAC7B,OAAO,GAAG,SAAS,UAAU;AAAA;AAoBxB,IAAM,kBAAkB,CAAC,WAA6C;AAAA,EAC3E,MAAM,SAAS,OAAO,UAAU,IAAI,SAAS,OAAO,SAAS,EAAE,QAAQ,OAAO,OAAO,IAAI,CAAC,CAAC;AAAA,EAC3F,MAAM,SAAS,OAAO;AAAA,EACtB,MAAM,SAAS,OAAO,UAAU;AAAA,EAEhC,MAAM,UAAU,CAAC,WAA2B,cAAc,QAAQ,MAAM;AAAA,EAExE,MAAM,MAAM,OAAO,QAA4C;AAAA,IAC7D,IAAI;AAAA,MACF,MAAM,SAAS,MAAM,OAAO,KAC1B,IAAI,iBAAiB;AAAA,QACnB,QAAQ;AAAA,QACR,KAAK,QAAQ,GAAG;AAAA,MAClB,CAAC,CACH;AAAA,MAEA,MAAM,QAAQ,MAAM,OAAO,KAAM,qBAAqB;AAAA,MACtD,OAAO,IAAI,WAAW,KAAK;AAAA,MAC3B,OAAO,OAAgB;AAAA,MACvB,MAAM,MAAM;AAAA,MACZ,IAAI,IAAI,SAAS,eAAe,IAAI,WAAW,mBAAmB,KAAK;AAAA,QACrE,OAAO;AAAA,MACT;AAAA,MACA,MAAM;AAAA;AAAA;AAAA,EAIV,MAAM,MAAM,OAAO,KAAa,UAAqC;AAAA,IACnE,MAAM,QAAQ,QAAQ,GAAG;AAAA,IAGzB,IAAI;AAAA,MACF,MAAM,OAAO,KACX,IAAI,kBAAkB;AAAA,QACpB,QAAQ;AAAA,QACR,KAAK;AAAA,MACP,CAAC,CACH;AAAA,MACA;AAAA,MACA,OAAO,OAAgB;AAAA,MACvB,MAAM,MAAM;AAAA,MACZ,IAAI,IAAI,SAAS,cAAc,IAAI,WAAW,mBAAmB,KAAK;AAAA,QACpE,MAAM;AAAA,MACR;AAAA;AAAA,IAKF,MAAM,OAAO,KACX,IAAI,iBAAiB;AAAA,MACnB,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,MAAM;AAAA,MACN,aAAa;AAAA,IACf,CAAC,CACH;AAAA;AAAA,EAGF,OAAO,EAAE,KAAK,IAAI;AAAA;",
+  "debugId": "FBB9BF9E1762965D64756E2164756E21",
+  "names": []
+}

package/dist/s3-storage.d.ts

@@ -0,0 +1,27 @@
+/**
+ * S3 Storage Provider for CAS
+ *
+ * Implements StorageProvider with:
+ * - S3 backend storage
+ * - Internal HeadObject check in put() to avoid redundant uploads
+ */
+import { S3Client } from "@aws-sdk/client-s3";
+import type { StorageProvider } from "@casfa/storage-core";
+/**
+ * S3 Storage configuration
+ */
+export type S3StorageConfig = {
+    /** S3 bucket name */
+    bucket: string;
+    /** AWS region for the S3 bucket (e.g. "us-west-2") */
+    region?: string;
+    /** Optional S3 client (for testing or custom config) */
+    client?: S3Client;
+    /** Key prefix in S3 (default: "cas/v1/") */
+    prefix?: string;
+};
+/**
+ * Create an S3-backed storage provider
+ */
+export declare const createS3Storage: (config: S3StorageConfig) => StorageProvider;
+//# sourceMappingURL=s3-storage.d.ts.map

package/dist/s3-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-storage.d.ts","sourceRoot":"","sources":["../src/s3-storage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAIL,QAAQ,EACT,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAa3D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,eAAe,KAAG,eA2DzD,CAAC"}

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@casfa/storage-s3",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "S3 storage provider for CAS",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "bun": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     }
   },
   "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
+    "build": "bun ../../scripts/build-pkg.ts",
     "typecheck": "tsc --noEmit",
     "lint": "biome check .",
     "lint:fix": "biome check --write .",