@happyvertical/cache 0.74.8

package/dist/chunks/s3-ByokNFv_.js

@@ -0,0 +1,427 @@
+import { promisify } from "node:util";
+import { gunzip, gzip } from "node:zlib";
+import { isValidKey, CacheKeyError, deserialize, isExpired, CacheError, calculateExpiration, calculateSize, serialize, CacheSerializationError, extractKey, matchesPattern, formatKey } from "../index.js";
+const gzipAsync = promisify(gzip);
+const gunzipAsync = promisify(gunzip);
+let S3Client;
+let GetObjectCommand;
+let PutObjectCommand;
+let DeleteObjectCommand;
+let DeleteObjectsCommand;
+let ListObjectsV2Command;
+let HeadObjectCommand;
+async function loadS3SDK() {
+  if (!S3Client) {
+    const sdk = await import("@aws-sdk/client-s3");
+    S3Client = sdk.S3Client;
+    GetObjectCommand = sdk.GetObjectCommand;
+    PutObjectCommand = sdk.PutObjectCommand;
+    DeleteObjectCommand = sdk.DeleteObjectCommand;
+    DeleteObjectsCommand = sdk.DeleteObjectsCommand;
+    ListObjectsV2Command = sdk.ListObjectsV2Command;
+    HeadObjectCommand = sdk.HeadObjectCommand;
+  }
+}
+async function streamToBuffer(stream) {
+  const chunks = [];
+  for await (const chunk of stream) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  }
+  return Buffer.concat(chunks);
+}
+class S3Provider {
+  client;
+  bucket;
+  prefix;
+  namespace;
+  defaultTTL;
+  compression;
+  compressionThreshold;
+  region;
+  initialized = false;
+  stats;
+  constructor(options) {
+    this.bucket = options.bucket;
+    this.prefix = options.prefix || "cache/";
+    this.namespace = options.namespace;
+    this.defaultTTL = options.defaultTTL;
+    this.compression = options.compression ?? true;
+    this.compressionThreshold = options.compressionThreshold ?? 1024;
+    this.region = options.region || process.env.AWS_REGION || "us-east-1";
+    this.stats = {
+      hits: 0,
+      misses: 0,
+      evictions: 0
+    };
+  }
+  /**
+   * Lazily initialize the S3 client
+   */
+  async ensureInitialized() {
+    if (this.initialized) return;
+    await loadS3SDK();
+    const credentials = process.env.AWS_ACCESS_KEY_ID && process.env.AWS_SECRET_ACCESS_KEY ? {
+      accessKeyId: process.env.AWS_ACCESS_KEY_ID,
+      secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY
+    } : void 0;
+    this.client = new S3Client({
+      region: this.region,
+      credentials
+    });
+    this.initialized = true;
+  }
+  async get(key) {
+    if (!isValidKey(key)) {
+      throw new CacheKeyError(key, "s3");
+    }
+    await this.ensureInitialized();
+    const s3Key = this.getS3Key(key);
+    try {
+      const response = await this.client.send(
+        new GetObjectCommand({
+          Bucket: this.bucket,
+          Key: s3Key
+        })
+      );
+      const bodyBuffer = await streamToBuffer(response.Body);
+      const isCompressed = response.Metadata?.["compressed"] === "true";
+      let data;
+      if (isCompressed) {
+        data = await gunzipAsync(bodyBuffer);
+      } else {
+        data = bodyBuffer;
+      }
+      const entry = deserialize(data.toString("utf-8"));
+      if (isExpired(entry.expiresAt)) {
+        this.stats.misses++;
+        this.delete(key).catch(() => {
+        });
+        return void 0;
+      }
+      this.stats.hits++;
+      return entry.value;
+    } catch (error) {
+      if (error.name === "NoSuchKey" || error.$metadata?.httpStatusCode === 404) {
+        this.stats.misses++;
+        return void 0;
+      }
+      throw new CacheError(
+        `Failed to read S3 cache entry: ${error.message}`,
+        "READ_ERROR",
+        "s3"
+      );
+    }
+  }
+  async set(key, value, ttl) {
+    if (!isValidKey(key)) {
+      throw new CacheKeyError(key, "s3");
+    }
+    await this.ensureInitialized();
+    const s3Key = this.getS3Key(key);
+    const expiresAt = calculateExpiration(ttl ?? this.defaultTTL);
+    const entry = {
+      value,
+      createdAt: Date.now(),
+      expiresAt,
+      size: calculateSize(value),
+      hits: 0,
+      metadata: {
+        compressed: false,
+        // Will be set below if compressed
+        namespace: this.namespace
+      }
+    };
+    let data = Buffer.from(serialize(entry), "utf-8");
+    let isCompressed = false;
+    if (this.compression && data.length > this.compressionThreshold) {
+      data = await gzipAsync(data);
+      isCompressed = true;
+    }
+    const metadata = {
+      "created-at": entry.createdAt.toString(),
+      compressed: isCompressed.toString()
+    };
+    if (expiresAt) {
+      metadata["expires-at"] = expiresAt.toString();
+    }
+    if (this.namespace) {
+      metadata["namespace"] = this.namespace;
+    }
+    try {
+      await this.client.send(
+        new PutObjectCommand({
+          Bucket: this.bucket,
+          Key: s3Key,
+          Body: data,
+          Metadata: metadata,
+          ContentType: "application/json"
+        })
+      );
+    } catch (error) {
+      throw new CacheSerializationError(
+        `Failed to write S3 cache entry: ${error.message}`,
+        "s3"
+      );
+    }
+  }
+  async has(key) {
+    if (!isValidKey(key)) {
+      throw new CacheKeyError(key, "s3");
+    }
+    await this.ensureInitialized();
+    const s3Key = this.getS3Key(key);
+    try {
+      const response = await this.client.send(
+        new HeadObjectCommand({
+          Bucket: this.bucket,
+          Key: s3Key
+        })
+      );
+      const expiresAt = response.Metadata?.["expires-at"];
+      if (expiresAt && Date.now() >= parseInt(expiresAt, 10)) {
+        return false;
+      }
+      return true;
+    } catch (error) {
+      if (error.name === "NotFound" || error.$metadata?.httpStatusCode === 404) {
+        return false;
+      }
+      throw new CacheError(
+        `Failed to check S3 cache entry: ${error.message}`,
+        "CHECK_ERROR",
+        "s3"
+      );
+    }
+  }
+  async delete(key) {
+    if (!isValidKey(key)) {
+      throw new CacheKeyError(key, "s3");
+    }
+    await this.ensureInitialized();
+    const s3Key = this.getS3Key(key);
+    try {
+      await this.client.send(
+        new DeleteObjectCommand({
+          Bucket: this.bucket,
+          Key: s3Key
+        })
+      );
+      return true;
+    } catch (error) {
+      return true;
+    }
+  }
+  async clear(namespace) {
+    await this.ensureInitialized();
+    const targetNamespace = namespace || this.namespace;
+    const prefix = targetNamespace ? `${this.prefix}${this.sanitizeKey(`${targetNamespace}:`)}` : this.prefix;
+    try {
+      let continuationToken;
+      do {
+        const listResponse = await this.client.send(
+          new ListObjectsV2Command({
+            Bucket: this.bucket,
+            Prefix: prefix,
+            ContinuationToken: continuationToken
+          })
+        );
+        if (listResponse.Contents && listResponse.Contents.length > 0) {
+          const objects = listResponse.Contents.map((obj) => ({
+            Key: obj.Key
+          }));
+          await this.client.send(
+            new DeleteObjectsCommand({
+              Bucket: this.bucket,
+              Delete: { Objects: objects }
+            })
+          );
+        }
+        continuationToken = listResponse.NextContinuationToken;
+      } while (continuationToken);
+      this.stats.hits = 0;
+      this.stats.misses = 0;
+      this.stats.evictions = 0;
+    } catch (error) {
+      throw new CacheError(
+        `Failed to clear S3 cache: ${error.message}`,
+        "CLEAR_ERROR",
+        "s3"
+      );
+    }
+  }
+  async keys(pattern) {
+    await this.ensureInitialized();
+    const keys = [];
+    let continuationToken;
+    try {
+      do {
+        const listResponse = await this.client.send(
+          new ListObjectsV2Command({
+            Bucket: this.bucket,
+            Prefix: this.prefix,
+            ContinuationToken: continuationToken
+          })
+        );
+        if (listResponse.Contents) {
+          for (const obj of listResponse.Contents) {
+            const s3Key = obj.Key;
+            if (!s3Key.endsWith(".cache")) continue;
+            const rawKey = s3Key.slice(this.prefix.length).replace(/\.cache$/, "");
+            const desanitized = this.desanitizeKey(rawKey);
+            const extractedKey = extractKey(this.namespace, desanitized);
+            keys.push(extractedKey);
+          }
+        }
+        continuationToken = listResponse.NextContinuationToken;
+      } while (continuationToken);
+    } catch (error) {
+      throw new CacheError(
+        `Failed to list S3 cache keys: ${error.message}`,
+        "LIST_ERROR",
+        "s3"
+      );
+    }
+    if (pattern) {
+      return keys.filter((key) => matchesPattern(pattern, key));
+    }
+    return keys;
+  }
+  async getMany(keys) {
+    const result = /* @__PURE__ */ new Map();
+    const results = await Promise.allSettled(
+      keys.map(async (key) => {
+        const value = await this.get(key);
+        return { key, value };
+      })
+    );
+    for (const result2 of results) {
+      if (result2.status === "fulfilled" && result2.value.value !== void 0) {
+        result2.value;
+      }
+    }
+    for (const r of results) {
+      if (r.status === "fulfilled" && r.value.value !== void 0) {
+        result.set(r.value.key, r.value.value);
+      }
+    }
+    return result;
+  }
+  async setMany(entries) {
+    await Promise.all(
+      entries.map((entry) => this.set(entry.key, entry.value, entry.ttl))
+    );
+  }
+  async deleteMany(keys) {
+    await this.ensureInitialized();
+    if (keys.length === 0) return 0;
+    const s3Keys = keys.map((key) => ({
+      Key: this.getS3Key(key)
+    }));
+    try {
+      let deleted = 0;
+      for (let i = 0; i < s3Keys.length; i += 1e3) {
+        const batch = s3Keys.slice(i, i + 1e3);
+        const response = await this.client.send(
+          new DeleteObjectsCommand({
+            Bucket: this.bucket,
+            Delete: { Objects: batch }
+          })
+        );
+        deleted += response.Deleted?.length || 0;
+      }
+      return deleted;
+    } catch (error) {
+      throw new CacheError(
+        `Failed to delete S3 cache entries: ${error.message}`,
+        "DELETE_ERROR",
+        "s3"
+      );
+    }
+  }
+  async getStats() {
+    await this.ensureInitialized();
+    let entries = 0;
+    let totalSize = 0;
+    let continuationToken;
+    try {
+      do {
+        const listResponse = await this.client.send(
+          new ListObjectsV2Command({
+            Bucket: this.bucket,
+            Prefix: this.prefix,
+            ContinuationToken: continuationToken
+          })
+        );
+        if (listResponse.Contents) {
+          for (const obj of listResponse.Contents) {
+            entries++;
+            totalSize += obj.Size || 0;
+          }
+        }
+        continuationToken = listResponse.NextContinuationToken;
+      } while (continuationToken);
+    } catch (error) {
+      entries = 0;
+      totalSize = 0;
+    }
+    const totalAccesses = this.stats.hits + this.stats.misses;
+    const hitRate = totalAccesses > 0 ? this.stats.hits / totalAccesses : 0;
+    return {
+      entries,
+      totalSize,
+      hits: this.stats.hits,
+      misses: this.stats.misses,
+      hitRate,
+      evictions: this.stats.evictions,
+      backend: {
+        type: "s3",
+        bucket: this.bucket,
+        prefix: this.prefix,
+        region: this.region,
+        compression: this.compression
+      }
+    };
+  }
+  async touch(key, ttl) {
+    if (!isValidKey(key)) {
+      throw new CacheKeyError(key, "s3");
+    }
+    const value = await this.get(key);
+    if (value === void 0) {
+      return false;
+    }
+    await this.set(key, value, ttl);
+    return true;
+  }
+  async close() {
+    if (this.client?.destroy) {
+      this.client.destroy();
+    }
+    this.initialized = false;
+  }
+  /**
+   * Gets the S3 key for a cache key
+   */
+  getS3Key(key) {
+    const fullKey = formatKey(this.namespace, key);
+    const sanitized = this.sanitizeKey(fullKey);
+    return `${this.prefix}${sanitized}.cache`;
+  }
+  /**
+   * Sanitizes a key for use as an S3 key
+   * S3 keys can contain most characters, but we sanitize for consistency
+   */
+  sanitizeKey(key) {
+    return key.replace(/[^a-zA-Z0-9_:-]/g, "_");
+  }
+  /**
+   * Desanitizes an S3 key back to the original format
+   */
+  desanitizeKey(sanitized) {
+    return sanitized;
+  }
+}
+export {
+  S3Provider
+};
+//# sourceMappingURL=s3-ByokNFv_.js.map

package/dist/chunks/s3-ByokNFv_.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-ByokNFv_.js","sources":["../../src/providers/s3.ts"],"sourcesContent":["/**\n * S3 cache provider implementation\n * Stores cache entries in S3 for persistence across CI runs\n */\n\nimport { promisify } from 'node:util';\nimport { gunzip, gzip } from 'node:zlib';\nimport type {\n  CacheEntry,\n  CacheProvider,\n  CacheStats,\n  S3Options,\n} from '../shared/types';\nimport {\n  CacheError,\n  CacheKeyError,\n  CacheSerializationError,\n} from '../shared/types';\nimport {\n  calculateExpiration,\n  calculateSize,\n  deserialize,\n  extractKey,\n  formatKey,\n  isExpired,\n  isValidKey,\n  matchesPattern,\n  serialize,\n} from '../shared/utils';\n\nconst gzipAsync = promisify(gzip);\nconst gunzipAsync = promisify(gunzip);\n\n// Dynamic imports for AWS SDK (lazy loaded)\nlet S3Client: any;\nlet GetObjectCommand: any;\nlet PutObjectCommand: any;\nlet DeleteObjectCommand: any;\nlet DeleteObjectsCommand: any;\nlet ListObjectsV2Command: any;\nlet HeadObjectCommand: any;\n\nasync function loadS3SDK() {\n  if (!S3Client) {\n    const sdk = await import('@aws-sdk/client-s3');\n    S3Client = sdk.S3Client;\n    GetObjectCommand = sdk.GetObjectCommand;\n    PutObjectCommand = sdk.PutObjectCommand;\n    DeleteObjectCommand = sdk.DeleteObjectCommand;\n    DeleteObjectsCommand = sdk.DeleteObjectsCommand;\n    ListObjectsV2Command = sdk.ListObjectsV2Command;\n    HeadObjectCommand = sdk.HeadObjectCommand;\n  }\n}\n\n/**\n * Converts a readable stream to a buffer\n */\nasync function streamToBuffer(stream: any): Promise<Buffer> {\n  const chunks: Buffer[] = [];\n  for await (const chunk of stream) {\n    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n  }\n  return Buffer.concat(chunks);\n}\n\n/**\n * S3 cache provider implementation\n * Stores cache entries as S3 objects with optional compression\n */\nexport class S3Provider implements CacheProvider {\n  private client: any;\n  private bucket: string;\n  private prefix: string;\n  private namespace?: string;\n  private defaultTTL?: number;\n  private compression: boolean;\n  private compressionThreshold: number;\n  private region: string;\n  private initialized: boolean = false;\n  private stats: {\n    hits: number;\n    misses: number;\n    evictions: number;\n  };\n\n  constructor(options: S3Options) {\n    this.bucket = options.bucket;\n    this.prefix = options.prefix || 'cache/';\n    this.namespace = options.namespace;\n    this.defaultTTL = options.defaultTTL;\n    this.compression = options.compression ?? true; // Default ON for S3 (reduces egress costs)\n    this.compressionThreshold = options.compressionThreshold ?? 1024; // 1KB\n    this.region = options.region || process.env.AWS_REGION || 'us-east-1';\n    this.stats = {\n      hits: 0,\n      misses: 0,\n      evictions: 0,\n    };\n  }\n\n  /**\n   * Lazily initialize the S3 client\n   */\n  private async ensureInitialized(): Promise<void> {\n    if (this.initialized) return;\n\n    await loadS3SDK();\n\n    // Use explicit credentials from environment if available\n    // This ensures credentials work even when bundled by Vite\n    const credentials =\n      process.env.AWS_ACCESS_KEY_ID && process.env.AWS_SECRET_ACCESS_KEY\n        ? {\n            accessKeyId: process.env.AWS_ACCESS_KEY_ID,\n            secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,\n          }\n        : undefined;\n\n    this.client = new S3Client({\n      region: this.region,\n      credentials,\n    });\n    this.initialized = true;\n  }\n\n  async get<T = any>(key: string): Promise<T | undefined> {\n    if (!isValidKey(key)) {\n      throw new CacheKeyError(key, 's3');\n    }\n\n    await this.ensureInitialized();\n\n    const s3Key = this.getS3Key(key);\n\n    try {\n      const response = await this.client.send(\n        new GetObjectCommand({\n          Bucket: this.bucket,\n          Key: s3Key,\n        }),\n      );\n\n      // Get body as buffer\n      const bodyBuffer = await streamToBuffer(response.Body);\n\n      // Check if compressed from metadata\n      const isCompressed = response.Metadata?.['compressed'] === 'true';\n\n      let data: Buffer;\n      if (isCompressed) {\n        data = await gunzipAsync(bodyBuffer);\n      } else {\n        data = bodyBuffer;\n      }\n\n      const entry: CacheEntry<T> = deserialize(data.toString('utf-8'));\n\n      // Check if expired\n      if (isExpired(entry.expiresAt)) {\n        this.stats.misses++;\n        // Optionally delete expired entry (fire and forget)\n        this.delete(key).catch(() => {});\n        return undefined;\n      }\n\n      this.stats.hits++;\n      return entry.value;\n    } catch (error: any) {\n      if (\n        error.name === 'NoSuchKey' ||\n        error.$metadata?.httpStatusCode === 404\n      ) {\n        this.stats.misses++;\n        return undefined;\n      }\n      throw new CacheError(\n        `Failed to read S3 cache entry: ${error.message}`,\n        'READ_ERROR',\n        's3',\n      );\n    }\n  }\n\n  async set<T = any>(key: string, value: T, ttl?: number): Promise<void> {\n    if (!isValidKey(key)) {\n      throw new CacheKeyError(key, 's3');\n    }\n\n    await this.ensureInitialized();\n\n    const s3Key = this.getS3Key(key);\n    const expiresAt = calculateExpiration(ttl ?? this.defaultTTL);\n\n    const entry: CacheEntry<T> = {\n      value,\n      createdAt: Date.now(),\n      expiresAt,\n      size: calculateSize(value),\n      hits: 0,\n      metadata: {\n        compressed: false, // Will be set below if compressed\n        namespace: this.namespace,\n      },\n    };\n\n    let data: Buffer = Buffer.from(serialize(entry), 'utf-8');\n    let isCompressed = false;\n\n    // Compress if enabled and data exceeds threshold\n    if (this.compression && data.length > this.compressionThreshold) {\n      data = (await gzipAsync(data)) as Buffer;\n      isCompressed = true;\n    }\n\n    const metadata: Record<string, string> = {\n      'created-at': entry.createdAt.toString(),\n      compressed: isCompressed.toString(),\n    };\n\n    if (expiresAt) {\n      metadata['expires-at'] = expiresAt.toString();\n    }\n\n    if (this.namespace) {\n      metadata['namespace'] = this.namespace;\n    }\n\n    try {\n      await this.client.send(\n        new PutObjectCommand({\n          Bucket: this.bucket,\n          Key: s3Key,\n          Body: data,\n          Metadata: metadata,\n          ContentType: 'application/json',\n        }),\n      );\n    } catch (error: any) {\n      throw new CacheSerializationError(\n        `Failed to write S3 cache entry: ${error.message}`,\n        's3',\n      );\n    }\n  }\n\n  async has(key: string): Promise<boolean> {\n    if (!isValidKey(key)) {\n      throw new CacheKeyError(key, 's3');\n    }\n\n    await this.ensureInitialized();\n\n    const s3Key = this.getS3Key(key);\n\n    try {\n      const response = await this.client.send(\n        new HeadObjectCommand({\n          Bucket: this.bucket,\n          Key: s3Key,\n        }),\n      );\n\n      // Check expiration from metadata\n      const expiresAt = response.Metadata?.['expires-at'];\n      if (expiresAt && Date.now() >= parseInt(expiresAt, 10)) {\n        return false;\n      }\n\n      return true;\n    } catch (error: any) {\n      if (\n        error.name === 'NotFound' ||\n        error.$metadata?.httpStatusCode === 404\n      ) {\n        return false;\n      }\n      throw new CacheError(\n        `Failed to check S3 cache entry: ${error.message}`,\n        'CHECK_ERROR',\n        's3',\n      );\n    }\n  }\n\n  async delete(key: string): Promise<boolean> {\n    if (!isValidKey(key)) {\n      throw new CacheKeyError(key, 's3');\n    }\n\n    await this.ensureInitialized();\n\n    const s3Key = this.getS3Key(key);\n\n    try {\n      await this.client.send(\n        new DeleteObjectCommand({\n          Bucket: this.bucket,\n          Key: s3Key,\n        }),\n      );\n      return true;\n    } catch (error: any) {\n      // S3 DeleteObject doesn't error if key doesn't exist\n      // It just succeeds silently\n      return true;\n    }\n  }\n\n  async clear(namespace?: string): Promise<void> {\n    await this.ensureInitialized();\n\n    const targetNamespace = namespace || this.namespace;\n    const prefix = targetNamespace\n      ? `${this.prefix}${this.sanitizeKey(`${targetNamespace}:`)}`\n      : this.prefix;\n\n    try {\n      // List all objects with prefix\n      let continuationToken: string | undefined;\n      do {\n        const listResponse = await this.client.send(\n          new ListObjectsV2Command({\n            Bucket: this.bucket,\n            Prefix: prefix,\n            ContinuationToken: continuationToken,\n          }),\n        );\n\n        if (listResponse.Contents && listResponse.Contents.length > 0) {\n          // Delete in batches of 1000 (S3 limit)\n          const objects = listResponse.Contents.map((obj: any) => ({\n            Key: obj.Key,\n          }));\n\n          await this.client.send(\n            new DeleteObjectsCommand({\n              Bucket: this.bucket,\n              Delete: { Objects: objects },\n            }),\n          );\n        }\n\n        continuationToken = listResponse.NextContinuationToken;\n      } while (continuationToken);\n\n      // Reset stats\n      this.stats.hits = 0;\n      this.stats.misses = 0;\n      this.stats.evictions = 0;\n    } catch (error: any) {\n      throw new CacheError(\n        `Failed to clear S3 cache: ${error.message}`,\n        'CLEAR_ERROR',\n        's3',\n      );\n    }\n  }\n\n  async keys(pattern?: string): Promise<string[]> {\n    await this.ensureInitialized();\n\n    const keys: string[] = [];\n    let continuationToken: string | undefined;\n\n    try {\n      do {\n        const listResponse = await this.client.send(\n          new ListObjectsV2Command({\n            Bucket: this.bucket,\n            Prefix: this.prefix,\n            ContinuationToken: continuationToken,\n          }),\n        );\n\n        if (listResponse.Contents) {\n          for (const obj of listResponse.Contents) {\n            // Extract key from S3 key\n            const s3Key = obj.Key as string;\n            if (!s3Key.endsWith('.cache')) continue;\n\n            // Remove prefix and .cache extension\n            const rawKey = s3Key\n              .slice(this.prefix.length)\n              .replace(/\\.cache$/, '');\n\n            const desanitized = this.desanitizeKey(rawKey);\n            const extractedKey = extractKey(this.namespace, desanitized);\n\n            keys.push(extractedKey);\n          }\n        }\n\n        continuationToken = listResponse.NextContinuationToken;\n      } while (continuationToken);\n    } catch (error: any) {\n      throw new CacheError(\n        `Failed to list S3 cache keys: ${error.message}`,\n        'LIST_ERROR',\n        's3',\n      );\n    }\n\n    // Apply pattern filter if provided\n    if (pattern) {\n      return keys.filter((key) => matchesPattern(pattern, key));\n    }\n\n    return keys;\n  }\n\n  async getMany<T = any>(keys: string[]): Promise<Map<string, T>> {\n    const result = new Map<string, T>();\n\n    // S3 doesn't have batch get, so fetch in parallel\n    const results = await Promise.allSettled(\n      keys.map(async (key) => {\n        const value = await this.get<T>(key);\n        return { key, value };\n      }),\n    );\n\n    for (const result of results) {\n      if (result.status === 'fulfilled' && result.value.value !== undefined) {\n        result.value;\n      }\n    }\n\n    for (const r of results) {\n      if (r.status === 'fulfilled' && r.value.value !== undefined) {\n        result.set(r.value.key, r.value.value);\n      }\n    }\n\n    return result;\n  }\n\n  async setMany<T = any>(\n    entries: Array<{ key: string; value: T; ttl?: number }>,\n  ): Promise<void> {\n    // S3 doesn't have batch put, so write in parallel\n    await Promise.all(\n      entries.map((entry) => this.set(entry.key, entry.value, entry.ttl)),\n    );\n  }\n\n  async deleteMany(keys: string[]): Promise<number> {\n    await this.ensureInitialized();\n\n    if (keys.length === 0) return 0;\n\n    const s3Keys = keys.map((key) => ({\n      Key: this.getS3Key(key),\n    }));\n\n    try {\n      // Delete in batches of 1000\n      let deleted = 0;\n      for (let i = 0; i < s3Keys.length; i += 1000) {\n        const batch = s3Keys.slice(i, i + 1000);\n        const response = await this.client.send(\n          new DeleteObjectsCommand({\n            Bucket: this.bucket,\n            Delete: { Objects: batch },\n          }),\n        );\n        deleted += response.Deleted?.length || 0;\n      }\n      return deleted;\n    } catch (error: any) {\n      throw new CacheError(\n        `Failed to delete S3 cache entries: ${error.message}`,\n        'DELETE_ERROR',\n        's3',\n      );\n    }\n  }\n\n  async getStats(): Promise<CacheStats> {\n    await this.ensureInitialized();\n\n    let entries = 0;\n    let totalSize = 0;\n    let continuationToken: string | undefined;\n\n    try {\n      do {\n        const listResponse = await this.client.send(\n          new ListObjectsV2Command({\n            Bucket: this.bucket,\n            Prefix: this.prefix,\n            ContinuationToken: continuationToken,\n          }),\n        );\n\n        if (listResponse.Contents) {\n          for (const obj of listResponse.Contents) {\n            entries++;\n            totalSize += obj.Size || 0;\n          }\n        }\n\n        continuationToken = listResponse.NextContinuationToken;\n      } while (continuationToken);\n    } catch (error: any) {\n      // If we can't list, return empty stats\n      entries = 0;\n      totalSize = 0;\n    }\n\n    const totalAccesses = this.stats.hits + this.stats.misses;\n    const hitRate = totalAccesses > 0 ? this.stats.hits / totalAccesses : 0;\n\n    return {\n      entries,\n      totalSize,\n      hits: this.stats.hits,\n      misses: this.stats.misses,\n      hitRate,\n      evictions: this.stats.evictions,\n      backend: {\n        type: 's3',\n        bucket: this.bucket,\n        prefix: this.prefix,\n        region: this.region,\n        compression: this.compression,\n      },\n    };\n  }\n\n  async touch(key: string, ttl: number): Promise<boolean> {\n    if (!isValidKey(key)) {\n      throw new CacheKeyError(key, 's3');\n    }\n\n    // For S3, we need to read the object, update TTL, and write it back\n    const value = await this.get(key);\n    if (value === undefined) {\n      return false;\n    }\n\n    await this.set(key, value, ttl);\n    return true;\n  }\n\n  async close(): Promise<void> {\n    // S3 client doesn't need explicit cleanup\n    // Just destroy the client if it exists\n    if (this.client?.destroy) {\n      this.client.destroy();\n    }\n    this.initialized = false;\n  }\n\n  /**\n   * Gets the S3 key for a cache key\n   */\n  private getS3Key(key: string): string {\n    const fullKey = formatKey(this.namespace, key);\n    const sanitized = this.sanitizeKey(fullKey);\n    return `${this.prefix}${sanitized}.cache`;\n  }\n\n  /**\n   * Sanitizes a key for use as an S3 key\n   * S3 keys can contain most characters, but we sanitize for consistency\n   */\n  private sanitizeKey(key: string): string {\n    return key.replace(/[^a-zA-Z0-9_:-]/g, '_');\n  }\n\n  /**\n   * Desanitizes an S3 key back to the original format\n   */\n  private desanitizeKey(sanitized: string): string {\n    // This is a simple implementation\n    // In practice, we might need a more sophisticated mapping\n    return sanitized;\n  }\n}\n"],"names":["result"],"mappings":"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"}

package/dist/cli/claude-context.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=claude-context.d.ts.map

package/dist/cli/claude-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-context.d.ts","sourceRoot":"","sources":["../../src/cli/claude-context.ts"],"names":[],"mappings":""}

package/dist/cli/claude-context.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { existsSync, mkdirSync, copyFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const Dirname = dirname(fileURLToPath(import.meta.url));
+const pkgRoot = join(Dirname, "../..");
+const targetDir = join(process.cwd(), ".claude");
+if (!existsSync(targetDir)) {
+  mkdirSync(targetDir, { recursive: true });
+}
+const pkgName = "cache";
+const agentMdSrc = existsSync(join(pkgRoot, "AGENT.md")) ? join(pkgRoot, "AGENT.md") : join(pkgRoot, "CLAUDE.md");
+const metaSrc = existsSync(join(pkgRoot, "metadata.json")) ? join(pkgRoot, "metadata.json") : join(pkgRoot, ".claude-meta.json");
+if (existsSync(agentMdSrc)) {
+  copyFileSync(agentMdSrc, join(targetDir, `have-${pkgName}.md`));
+}
+if (existsSync(metaSrc)) {
+  copyFileSync(metaSrc, join(targetDir, `have-${pkgName}.meta.json`));
+}
+console.log(`✓ Installed @happyvertical/${pkgName} context to .claude/`);
+//# sourceMappingURL=claude-context.js.map

package/dist/cli/claude-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-context.js","sources":["../../src/cli/claude-context.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * CLI script to install agent context for @happyvertical/cache\n * Run the published context installer binary for this package.\n */\nimport { copyFileSync, existsSync, mkdirSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nconst Dirname = dirname(fileURLToPath(import.meta.url));\nconst pkgRoot = join(Dirname, '../..');\nconst targetDir = join(process.cwd(), '.claude');\n\nif (!existsSync(targetDir)) {\n  mkdirSync(targetDir, { recursive: true });\n}\n\nconst pkgName = 'cache';\nconst agentMdSrc = existsSync(join(pkgRoot, 'AGENT.md'))\n  ? join(pkgRoot, 'AGENT.md')\n  : join(pkgRoot, 'CLAUDE.md');\nconst metaSrc = existsSync(join(pkgRoot, 'metadata.json'))\n  ? join(pkgRoot, 'metadata.json')\n  : join(pkgRoot, '.claude-meta.json');\n\nif (existsSync(agentMdSrc)) {\n  copyFileSync(agentMdSrc, join(targetDir, `have-${pkgName}.md`));\n}\n\nif (existsSync(metaSrc)) {\n  copyFileSync(metaSrc, join(targetDir, `have-${pkgName}.meta.json`));\n}\n\nconsole.log(`✓ Installed @happyvertical/${pkgName} context to .claude/`);\n"],"names":[],"mappings":";;;;AASA,MAAM,UAAU,QAAQ,cAAc,YAAY,GAAG,CAAC;AACtD,MAAM,UAAU,KAAK,SAAS,OAAO;AACrC,MAAM,YAAY,KAAK,QAAQ,IAAA,GAAO,SAAS;AAE/C,IAAI,CAAC,WAAW,SAAS,GAAG;AAC1B,YAAU,WAAW,EAAE,WAAW,KAAA,CAAM;AAC1C;AAEA,MAAM,UAAU;AAChB,MAAM,aAAa,WAAW,KAAK,SAAS,UAAU,CAAC,IACnD,KAAK,SAAS,UAAU,IACxB,KAAK,SAAS,WAAW;AAC7B,MAAM,UAAU,WAAW,KAAK,SAAS,eAAe,CAAC,IACrD,KAAK,SAAS,eAAe,IAC7B,KAAK,SAAS,mBAAmB;AAErC,IAAI,WAAW,UAAU,GAAG;AAC1B,eAAa,YAAY,KAAK,WAAW,QAAQ,OAAO,KAAK,CAAC;AAChE;AAEA,IAAI,WAAW,OAAO,GAAG;AACvB,eAAa,SAAS,KAAK,WAAW,QAAQ,OAAO,YAAY,CAAC;AACpE;AAEA,QAAQ,IAAI,8BAA8B,OAAO,sBAAsB;"}

package/dist/index.d.ts

@@ -0,0 +1,72 @@
+import { CacheAdapter, CacheAdapterOptions } from './shared/types';
+export * from './shared/types';
+export * from './shared/utils';
+/**
+ * Factory function to create a cache adapter instance
+ *
+ * Supports environment variable configuration using the HAVE_CACHE_* pattern:
+ * - HAVE_CACHE_PROVIDER → provider ('memory'|'file'|'redis'|'s3')
+ * - HAVE_CACHE_NAMESPACE → namespace (string)
+ * - HAVE_CACHE_DEFAULT_TTL → defaultTTL (number: seconds)
+ * - HAVE_CACHE_MAX_SIZE → maxSize (number: bytes)
+ * - HAVE_CACHE_MAX_ENTRIES → maxEntries (number, memory only)
+ * - HAVE_CACHE_EVICTION_POLICY → evictionPolicy ('lru'|'lfu'|'fifo', memory only)
+ * - HAVE_CACHE_CACHE_DIR → cacheDir (string, file only)
+ * - HAVE_CACHE_COMPRESSION → compression (boolean, file/s3)
+ * - HAVE_CACHE_HOST → host (string, redis only)
+ * - HAVE_CACHE_PORT → port (number, redis only)
+ * - HAVE_CACHE_BUCKET → bucket (string, s3 only)
+ * - HAVE_CACHE_PREFIX → prefix (string, s3 only)
+ * - HAVE_CACHE_REGION → region (string, s3 only)
+ *
+ * User-provided options always take precedence over environment variables.
+ *
+ * @param options - Configuration options for the cache provider
+ * @returns Promise resolving to a cache adapter that implements CacheAdapter
+ *
+ * @example
+ * ```typescript
+ * // Create memory cache with explicit options
+ * const memoryCache = await getCache({
+ *   provider: 'memory',
+ *   maxSize: 100 * 1024 * 1024,
+ *   evictionPolicy: 'lru'
+ * });
+ *
+ * // Create memory cache with environment variables
+ * // HAVE_CACHE_PROVIDER=memory
+ * // HAVE_CACHE_MAX_SIZE=104857600
+ * // HAVE_CACHE_EVICTION_POLICY=lru
+ * const envCache = await getCache({ provider: 'memory' });
+ *
+ * // Create file cache
+ * const fileCache = await getCache({
+ *   provider: 'file',
+ *   cacheDir: './cache',
+ *   compression: true
+ * });
+ *
+ * // Create Redis cache
+ * const redisCache = await getCache({
+ *   provider: 'redis',
+ *   host: 'localhost',
+ *   port: 6379
+ * });
+ *
+ * // Create S3 cache (for CI persistence)
+ * const s3Cache = await getCache({
+ *   provider: 's3',
+ *   bucket: 'my-cache-bucket',
+ *   prefix: 'cache/',
+ *   region: 'us-east-1'
+ * });
+ *
+ * // Use the cache
+ * await memoryCache.set('user:123', { name: 'John' });
+ * const user = await memoryCache.get('user:123');
+ * ```
+ */
+export declare function getCache(options: CacheAdapterOptions): Promise<CacheAdapter>;
+/** @internal */
+export declare const PACKAGE_VERSION_INITIALIZED = true;
+//# 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;;;GAGG;AAGH,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EAKpB,MAAM,gBAAgB,CAAC;AAGxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAgC/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAwDvB;AAED,gBAAgB;AAChB,eAAO,MAAM,2BAA2B,OAAO,CAAC"}