@parsrun/cache 0.1.0

package/README.md

@@ -0,0 +1,135 @@
+# @parsrun/cache
+
+Edge-compatible caching for Pars with multiple adapter support.
+
+## Features
+
+- **Multi-Adapter**: Memory, Redis, Upstash, Cloudflare KV
+- **Edge-Compatible**: Works on all runtimes
+- **TTL Support**: Automatic expiration
+- **Namespace**: Isolated cache spaces
+- **Tags**: Cache invalidation by tags
+
+## Installation
+
+```bash
+pnpm add @parsrun/cache
+```
+
+## Quick Start
+
+```typescript
+import { createCache } from '@parsrun/cache';
+
+const cache = createCache({
+  adapter: 'memory', // or 'redis', 'upstash', 'cloudflare-kv'
+});
+
+// Set value
+await cache.set('key', { data: 'value' }, { ttl: 3600 });
+
+// Get value
+const value = await cache.get('key');
+
+// Delete
+await cache.delete('key');
+```
+
+## API Overview
+
+### Adapters
+
+#### Memory (Development)
+
+```typescript
+import { createMemoryCache } from '@parsrun/cache/adapters/memory';
+
+const cache = createMemoryCache({
+  maxSize: 1000,
+  defaultTTL: 3600,
+});
+```
+
+#### Redis
+
+```typescript
+import { createRedisCache } from '@parsrun/cache/adapters/redis';
+
+const cache = createRedisCache({
+  url: 'redis://localhost:6379',
+  prefix: 'myapp:',
+});
+```
+
+#### Upstash (Serverless Redis)
+
+```typescript
+import { createUpstashCache } from '@parsrun/cache/adapters/upstash';
+
+const cache = createUpstashCache({
+  url: process.env.UPSTASH_REDIS_URL,
+  token: process.env.UPSTASH_REDIS_TOKEN,
+});
+```
+
+#### Cloudflare KV
+
+```typescript
+import { createCloudflareKVCache } from '@parsrun/cache/adapters/cloudflare-kv';
+
+// In Cloudflare Worker
+const cache = createCloudflareKVCache({
+  namespace: env.CACHE_KV,
+});
+```
+
+### Cache Operations
+
+```typescript
+// Set with TTL (seconds)
+await cache.set('user:1', userData, { ttl: 3600 });
+
+// Set with tags
+await cache.set('user:1', userData, {
+  ttl: 3600,
+  tags: ['users', 'user:1'],
+});
+
+// Get
+const user = await cache.get<User>('user:1');
+
+// Get or set
+const user = await cache.getOrSet('user:1', async () => {
+  return await fetchUser(1);
+}, { ttl: 3600 });
+
+// Delete
+await cache.delete('user:1');
+
+// Delete by tag
+await cache.deleteByTag('users');
+
+// Clear all
+await cache.clear();
+```
+
+### With Namespace
+
+```typescript
+const userCache = cache.namespace('users');
+await userCache.set('1', userData); // Key: users:1
+```
+
+## Exports
+
+```typescript
+import { ... } from '@parsrun/cache';                     // Main exports
+import { ... } from '@parsrun/cache/adapters/memory';     // Memory adapter
+import { ... } from '@parsrun/cache/adapters/redis';      // Redis adapter
+import { ... } from '@parsrun/cache/adapters/upstash';    // Upstash adapter
+import { ... } from '@parsrun/cache/adapters/cloudflare-kv'; // Cloudflare KV
+```
+
+## License
+
+MIT

package/dist/adapters/cloudflare-kv.d.ts

@@ -0,0 +1,51 @@
+import { CacheAdapter, CloudflareKVCacheConfig, CacheGetOptions, CacheSetOptions } from '../types.js';
+import '@parsrun/types';
+
+/**
+ * @parsrun/cache - Cloudflare KV Adapter
+ * Cache adapter for Cloudflare Workers KV
+ */
+
+/**
+ * Cloudflare KV Cache Adapter
+ * Uses Cloudflare Workers KV for edge caching
+ *
+ * @example
+ * ```typescript
+ * // In Cloudflare Workers
+ * export default {
+ *   async fetch(request, env) {
+ *     const cache = new CloudflareKVCacheAdapter({
+ *       namespace: env.CACHE_KV,
+ *     });
+ *
+ *     await cache.set('user:123', { name: 'John' }, { ttl: 3600 });
+ *     const user = await cache.get('user:123');
+ *   }
+ * }
+ * ```
+ */
+declare class CloudflareKVCacheAdapter implements CacheAdapter {
+    readonly type: "cloudflare-kv";
+    private kv;
+    private keyPrefix;
+    constructor(config: CloudflareKVCacheConfig);
+    private prefixKey;
+    get<T = unknown>(key: string, _options?: CacheGetOptions): Promise<T | null>;
+    set<T = unknown>(key: string, value: T, options?: CacheSetOptions): Promise<void>;
+    delete(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    getMany<T = unknown>(keys: string[]): Promise<Map<string, T | null>>;
+    setMany<T = unknown>(entries: Map<string, T>, options?: CacheSetOptions): Promise<void>;
+    deleteMany(keys: string[]): Promise<void>;
+    invalidateByTags(tags: string[]): Promise<void>;
+    ttl(_key: string): Promise<number>;
+    close(): Promise<void>;
+}
+/**
+ * Create a Cloudflare KV cache adapter
+ */
+declare function createCloudflareKVCacheAdapter(config: CloudflareKVCacheConfig): CloudflareKVCacheAdapter;
+
+export { CloudflareKVCacheAdapter, createCloudflareKVCacheAdapter };

package/dist/adapters/cloudflare-kv.js

@@ -0,0 +1,197 @@
+// src/types.ts
+import {
+  type,
+  cacheSetOptions,
+  cacheGetResult,
+  cacheStats,
+  memoryCacheConfig,
+  redisCacheConfig,
+  upstashCacheConfig,
+  cloudflareKvConfig,
+  multiTierCacheConfig,
+  cacheConfig
+} from "@parsrun/types";
+var CacheError = class extends Error {
+  constructor(message, code, cause) {
+    super(message);
+    this.code = code;
+    this.cause = cause;
+    this.name = "CacheError";
+  }
+};
+var CacheErrorCodes = {
+  CONNECTION_FAILED: "CONNECTION_FAILED",
+  OPERATION_FAILED: "OPERATION_FAILED",
+  SERIALIZATION_ERROR: "SERIALIZATION_ERROR",
+  INVALID_CONFIG: "INVALID_CONFIG",
+  NOT_IMPLEMENTED: "NOT_IMPLEMENTED"
+};
+
+// src/adapters/cloudflare-kv.ts
+var CloudflareKVCacheAdapter = class {
+  type = "cloudflare-kv";
+  kv;
+  keyPrefix;
+  constructor(config) {
+    this.kv = config.namespace;
+    this.keyPrefix = config.keyPrefix ?? "";
+  }
+  prefixKey(key) {
+    return this.keyPrefix ? `${this.keyPrefix}:${key}` : key;
+  }
+  async get(key, _options) {
+    try {
+      const data = await this.kv.get(this.prefixKey(key), { type: "json" });
+      if (!data) {
+        return null;
+      }
+      return data.value;
+    } catch (err) {
+      throw new CacheError(
+        `Cloudflare KV get failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        CacheErrorCodes.OPERATION_FAILED,
+        err
+      );
+    }
+  }
+  async set(key, value, options) {
+    try {
+      const data = {
+        value,
+        tags: options?.tags,
+        metadata: options?.metadata
+      };
+      const putOptions = {};
+      if (options?.ttl) {
+        putOptions.expirationTtl = options.ttl;
+      }
+      if (options?.tags || options?.metadata) {
+        putOptions.metadata = {
+          tags: options.tags,
+          ...options.metadata
+        };
+      }
+      await this.kv.put(this.prefixKey(key), JSON.stringify(data), putOptions);
+      if (options?.tags && options.tags.length > 0) {
+        for (const tag of options.tags) {
+          const tagKey = this.prefixKey(`__tag:${tag}`);
+          const existing = await this.kv.get(tagKey, { type: "json" });
+          const keys = existing ? [.../* @__PURE__ */ new Set([...existing, key])] : [key];
+          await this.kv.put(tagKey, JSON.stringify(keys));
+        }
+      }
+    } catch (err) {
+      throw new CacheError(
+        `Cloudflare KV set failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        CacheErrorCodes.OPERATION_FAILED,
+        err
+      );
+    }
+  }
+  async delete(key) {
+    try {
+      await this.kv.delete(this.prefixKey(key));
+    } catch (err) {
+      throw new CacheError(
+        `Cloudflare KV delete failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        CacheErrorCodes.OPERATION_FAILED,
+        err
+      );
+    }
+  }
+  async has(key) {
+    try {
+      const value = await this.kv.get(this.prefixKey(key));
+      return value !== null;
+    } catch (err) {
+      throw new CacheError(
+        `Cloudflare KV has failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        CacheErrorCodes.OPERATION_FAILED,
+        err
+      );
+    }
+  }
+  async clear() {
+    try {
+      const prefix = this.keyPrefix ? `${this.keyPrefix}:` : "";
+      let cursor;
+      do {
+        const result = await this.kv.list({
+          prefix,
+          limit: 1e3,
+          cursor
+        });
+        for (const key of result.keys) {
+          await this.kv.delete(key.name);
+        }
+        cursor = result.list_complete ? void 0 : result.cursor;
+      } while (cursor);
+    } catch (err) {
+      throw new CacheError(
+        `Cloudflare KV clear failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        CacheErrorCodes.OPERATION_FAILED,
+        err
+      );
+    }
+  }
+  async getMany(keys) {
+    const map = /* @__PURE__ */ new Map();
+    const promises = keys.map(async (key) => {
+      const value = await this.get(key);
+      return { key, value };
+    });
+    const results = await Promise.all(promises);
+    for (const { key, value } of results) {
+      map.set(key, value);
+    }
+    return map;
+  }
+  async setMany(entries, options) {
+    const promises = [];
+    for (const [key, value] of entries) {
+      promises.push(this.set(key, value, options));
+    }
+    await Promise.all(promises);
+  }
+  async deleteMany(keys) {
+    const promises = keys.map((key) => this.delete(key));
+    await Promise.all(promises);
+  }
+  async invalidateByTags(tags) {
+    try {
+      const keysToDelete = /* @__PURE__ */ new Set();
+      for (const tag of tags) {
+        const tagKey = this.prefixKey(`__tag:${tag}`);
+        const keys = await this.kv.get(tagKey, { type: "json" });
+        if (keys) {
+          for (const key of keys) {
+            keysToDelete.add(key);
+          }
+          await this.kv.delete(tagKey);
+        }
+      }
+      if (keysToDelete.size > 0) {
+        await this.deleteMany([...keysToDelete]);
+      }
+    } catch (err) {
+      throw new CacheError(
+        `Cloudflare KV invalidate by tags failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        CacheErrorCodes.OPERATION_FAILED,
+        err
+      );
+    }
+  }
+  async ttl(_key) {
+    return -1;
+  }
+  async close() {
+  }
+};
+function createCloudflareKVCacheAdapter(config) {
+  return new CloudflareKVCacheAdapter(config);
+}
+export {
+  CloudflareKVCacheAdapter,
+  createCloudflareKVCacheAdapter
+};
+//# sourceMappingURL=cloudflare-kv.js.map

package/dist/adapters/cloudflare-kv.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types.ts","../../src/adapters/cloudflare-kv.ts"],"sourcesContent":["/**\n * @parsrun/cache - Type Definitions\n * Cache types and interfaces\n */\n\n// Re-export types from @parsrun/types for convenience\nexport {\n  type,\n  cacheSetOptions as parsCacheSetOptions,\n  cacheGetResult,\n  cacheStats,\n  memoryCacheConfig,\n  redisCacheConfig,\n  upstashCacheConfig,\n  cloudflareKvConfig,\n  multiTierCacheConfig,\n  cacheConfig,\n  type CacheSetOptions as ParsCacheSetOptions,\n  type CacheGetResult,\n  type CacheStats,\n  type MemoryCacheConfig as ParsMemoryCacheConfig,\n  type RedisCacheConfig as ParsRedisCacheConfig,\n  type UpstashCacheConfig as ParsUpstashCacheConfig,\n  type CloudflareKvConfig as ParsCloudflareKvConfig,\n  type MultiTierCacheConfig,\n  type CacheConfig,\n} from \"@parsrun/types\";\n\n/**\n * Cache adapter type\n */\nexport type CacheAdapterType = \"memory\" | \"redis\" | \"upstash\" | \"cloudflare-kv\";\n\n/**\n * Cache entry with metadata\n */\nexport interface CacheEntry<T = unknown> {\n  /** Cached value */\n  value: T;\n  /** Expiration timestamp (ms) */\n  expiresAt?: number | undefined;\n  /** Original TTL in seconds (for refresh/sliding expiration) */\n  ttlSeconds?: number | undefined;\n  /** Cache entry tags for invalidation */\n  tags?: string[] | undefined;\n  /** Cache entry metadata */\n  metadata?: Record<string, unknown> | undefined;\n}\n\n/**\n * Cache get options\n */\nexport interface CacheGetOptions {\n  /** Whether to update TTL on access (sliding expiration) */\n  refresh?: boolean | undefined;\n}\n\n/**\n * Cache set options\n */\nexport interface CacheSetOptions {\n  /** Time to live in seconds */\n  ttl?: number | undefined;\n  /** Tags for cache invalidation */\n  tags?: string[] | undefined;\n  /** Additional metadata */\n  metadata?: Record<string, unknown> | undefined;\n}\n\n/**\n * Cache delete options\n */\nexport interface CacheDeleteOptions {\n  /** Delete all entries with matching tags */\n  tags?: string[] | undefined;\n}\n\n/**\n * Cache adapter interface\n */\nexport interface CacheAdapter {\n  /** Adapter type */\n  readonly type: CacheAdapterType;\n\n  /**\n   * Get a value from cache\n   * @param key Cache key\n   * @param options Get options\n   * @returns Cached value or null if not found/expired\n   */\n  get<T = unknown>(key: string, options?: CacheGetOptions): Promise<T | null>;\n\n  /**\n   * Set a value in cache\n   * @param key Cache key\n   * @param value Value to cache\n   * @param options Set options\n   */\n  set<T = unknown>(key: string, value: T, options?: CacheSetOptions): Promise<void>;\n\n  /**\n   * Delete a value from cache\n   * @param key Cache key\n   */\n  delete(key: string): Promise<void>;\n\n  /**\n   * Check if a key exists in cache\n   * @param key Cache key\n   */\n  has(key: string): Promise<boolean>;\n\n  /**\n   * Clear all entries from cache\n   */\n  clear?(): Promise<void>;\n\n  /**\n   * Get multiple values at once\n   * @param keys Cache keys\n   */\n  getMany?<T = unknown>(keys: string[]): Promise<Map<string, T | null>>;\n\n  /**\n   * Set multiple values at once\n   * @param entries Key-value pairs\n   * @param options Set options (applied to all)\n   */\n  setMany?<T = unknown>(entries: Map<string, T>, options?: CacheSetOptions): Promise<void>;\n\n  /**\n   * Delete multiple keys\n   * @param keys Cache keys\n   */\n  deleteMany?(keys: string[]): Promise<void>;\n\n  /**\n   * Invalidate entries by tags\n   * @param tags Tags to invalidate\n   */\n  invalidateByTags?(tags: string[]): Promise<void>;\n\n  /**\n   * Get TTL for a key (in seconds)\n   * @param key Cache key\n   * @returns TTL in seconds, -1 if no expiry, -2 if key doesn't exist\n   */\n  ttl?(key: string): Promise<number>;\n\n  /**\n   * Close/cleanup adapter resources\n   */\n  close?(): Promise<void>;\n}\n\n/**\n * Cache service configuration\n */\nexport interface CacheServiceConfig {\n  /** Cache adapter to use */\n  adapter: CacheAdapter;\n  /** Default TTL in seconds */\n  defaultTtl?: number | undefined;\n  /** Key prefix for namespacing */\n  keyPrefix?: string | undefined;\n  /** Enable debug logging */\n  debug?: boolean | undefined;\n}\n\n/**\n * Memory adapter configuration\n */\nexport interface MemoryCacheConfig {\n  /** Maximum number of entries */\n  maxEntries?: number | undefined;\n  /** Cleanup interval in ms (default: 60000) */\n  cleanupInterval?: number | undefined;\n}\n\n/**\n * Redis adapter configuration\n */\nexport interface RedisCacheConfig {\n  /** Redis connection URL */\n  url?: string | undefined;\n  /** Redis host */\n  host?: string | undefined;\n  /** Redis port */\n  port?: number | undefined;\n  /** Redis password */\n  password?: string | undefined;\n  /** Redis database number */\n  db?: number | undefined;\n  /** Key prefix */\n  keyPrefix?: string | undefined;\n  /** Use TLS */\n  tls?: boolean | undefined;\n}\n\n/**\n * Upstash adapter configuration\n */\nexport interface UpstashCacheConfig {\n  /** Upstash Redis URL */\n  url: string;\n  /** Upstash Redis token */\n  token: string;\n  /** Key prefix */\n  keyPrefix?: string | undefined;\n}\n\n/**\n * Cloudflare KV adapter configuration\n */\nexport interface CloudflareKVCacheConfig {\n  /** KV namespace binding */\n  namespace: KVNamespace;\n  /** Key prefix */\n  keyPrefix?: string | undefined;\n}\n\n/**\n * KVNamespace interface (Cloudflare Workers)\n */\nexport interface KVNamespace {\n  get(key: string, options?: { type?: \"text\" | \"json\" | \"arrayBuffer\" | \"stream\" }): Promise<string | null>;\n  get(key: string, options: { type: \"json\" }): Promise<unknown>;\n  put(key: string, value: string | ArrayBuffer | ReadableStream, options?: { expiration?: number; expirationTtl?: number; metadata?: unknown }): Promise<void>;\n  delete(key: string): Promise<void>;\n  list(options?: { prefix?: string | undefined; limit?: number | undefined; cursor?: string | undefined }): Promise<{ keys: Array<{ name: string; expiration?: number; metadata?: unknown }>; list_complete: boolean; cursor?: string }>;\n  getWithMetadata<T = unknown>(key: string, options?: { type?: \"text\" | \"json\" | \"arrayBuffer\" | \"stream\" }): Promise<{ value: string | null; metadata: T | null }>;\n}\n\n/**\n * Cache error\n */\nexport class CacheError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly cause?: unknown\n  ) {\n    super(message);\n    this.name = \"CacheError\";\n  }\n}\n\n/**\n * Common cache error codes\n */\nexport const CacheErrorCodes = {\n  CONNECTION_FAILED: \"CONNECTION_FAILED\",\n  OPERATION_FAILED: \"OPERATION_FAILED\",\n  SERIALIZATION_ERROR: \"SERIALIZATION_ERROR\",\n  INVALID_CONFIG: \"INVALID_CONFIG\",\n  NOT_IMPLEMENTED: \"NOT_IMPLEMENTED\",\n} as const;\n","/**\n * @parsrun/cache - Cloudflare KV Adapter\n * Cache adapter for Cloudflare Workers KV\n */\n\nimport type {\n  CacheAdapter,\n  CacheGetOptions,\n  CacheSetOptions,\n  CloudflareKVCacheConfig,\n  KVNamespace,\n} from \"../types.js\";\nimport { CacheError, CacheErrorCodes } from \"../types.js\";\n\n/**\n * Cloudflare KV Cache Adapter\n * Uses Cloudflare Workers KV for edge caching\n *\n * @example\n * ```typescript\n * // In Cloudflare Workers\n * export default {\n *   async fetch(request, env) {\n *     const cache = new CloudflareKVCacheAdapter({\n *       namespace: env.CACHE_KV,\n *     });\n *\n *     await cache.set('user:123', { name: 'John' }, { ttl: 3600 });\n *     const user = await cache.get('user:123');\n *   }\n * }\n * ```\n */\nexport class CloudflareKVCacheAdapter implements CacheAdapter {\n  readonly type = \"cloudflare-kv\" as const;\n\n  private kv: KVNamespace;\n  private keyPrefix: string;\n\n  constructor(config: CloudflareKVCacheConfig) {\n    this.kv = config.namespace;\n    this.keyPrefix = config.keyPrefix ?? \"\";\n  }\n\n  private prefixKey(key: string): string {\n    return this.keyPrefix ? `${this.keyPrefix}:${key}` : key;\n  }\n\n  async get<T = unknown>(key: string, _options?: CacheGetOptions): Promise<T | null> {\n    try {\n      const data = await this.kv.get(this.prefixKey(key), { type: \"json\" }) as { value: T; tags?: string[] } | null;\n\n      if (!data) {\n        return null;\n      }\n\n      return data.value;\n    } catch (err) {\n      throw new CacheError(\n        `Cloudflare KV get failed: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n        CacheErrorCodes.OPERATION_FAILED,\n        err\n      );\n    }\n  }\n\n  async set<T = unknown>(key: string, value: T, options?: CacheSetOptions): Promise<void> {\n    try {\n      const data = {\n        value,\n        tags: options?.tags,\n        metadata: options?.metadata,\n      };\n\n      const putOptions: { expirationTtl?: number; metadata?: unknown } = {};\n\n      if (options?.ttl) {\n        putOptions.expirationTtl = options.ttl;\n      }\n\n      // Store metadata in KV metadata field\n      if (options?.tags || options?.metadata) {\n        putOptions.metadata = {\n          tags: options.tags,\n          ...options.metadata,\n        };\n      }\n\n      await this.kv.put(this.prefixKey(key), JSON.stringify(data), putOptions);\n\n      // Store tag-to-key mappings\n      if (options?.tags && options.tags.length > 0) {\n        for (const tag of options.tags) {\n          const tagKey = this.prefixKey(`__tag:${tag}`);\n          const existing = await this.kv.get(tagKey, { type: \"json\" }) as string[] | null;\n          const keys = existing ? [...new Set([...existing, key])] : [key];\n          await this.kv.put(tagKey, JSON.stringify(keys));\n        }\n      }\n    } catch (err) {\n      throw new CacheError(\n        `Cloudflare KV set failed: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n        CacheErrorCodes.OPERATION_FAILED,\n        err\n      );\n    }\n  }\n\n  async delete(key: string): Promise<void> {\n    try {\n      await this.kv.delete(this.prefixKey(key));\n    } catch (err) {\n      throw new CacheError(\n        `Cloudflare KV delete failed: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n        CacheErrorCodes.OPERATION_FAILED,\n        err\n      );\n    }\n  }\n\n  async has(key: string): Promise<boolean> {\n    try {\n      const value = await this.kv.get(this.prefixKey(key));\n      return value !== null;\n    } catch (err) {\n      throw new CacheError(\n        `Cloudflare KV has failed: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n        CacheErrorCodes.OPERATION_FAILED,\n        err\n      );\n    }\n  }\n\n  async clear(): Promise<void> {\n    try {\n      const prefix = this.keyPrefix ? `${this.keyPrefix}:` : \"\";\n      let cursor: string | undefined;\n\n      do {\n        const result = await this.kv.list({\n          prefix,\n          limit: 1000,\n          cursor,\n        });\n\n        for (const key of result.keys) {\n          await this.kv.delete(key.name);\n        }\n\n        cursor = result.list_complete ? undefined : result.cursor;\n      } while (cursor);\n    } catch (err) {\n      throw new CacheError(\n        `Cloudflare KV clear failed: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n        CacheErrorCodes.OPERATION_FAILED,\n        err\n      );\n    }\n  }\n\n  async getMany<T = unknown>(keys: string[]): Promise<Map<string, T | null>> {\n    const map = new Map<string, T | null>();\n\n    // KV doesn't support batch get, so we do parallel fetches\n    const promises = keys.map(async (key) => {\n      const value = await this.get<T>(key);\n      return { key, value };\n    });\n\n    const results = await Promise.all(promises);\n\n    for (const { key, value } of results) {\n      map.set(key, value);\n    }\n\n    return map;\n  }\n\n  async setMany<T = unknown>(entries: Map<string, T>, options?: CacheSetOptions): Promise<void> {\n    // KV doesn't support batch write, so we do parallel writes\n    const promises: Promise<void>[] = [];\n\n    for (const [key, value] of entries) {\n      promises.push(this.set(key, value, options));\n    }\n\n    await Promise.all(promises);\n  }\n\n  async deleteMany(keys: string[]): Promise<void> {\n    // KV doesn't support batch delete, so we do parallel deletes\n    const promises = keys.map((key) => this.delete(key));\n    await Promise.all(promises);\n  }\n\n  async invalidateByTags(tags: string[]): Promise<void> {\n    try {\n      const keysToDelete = new Set<string>();\n\n      for (const tag of tags) {\n        const tagKey = this.prefixKey(`__tag:${tag}`);\n        const keys = await this.kv.get(tagKey, { type: \"json\" }) as string[] | null;\n\n        if (keys) {\n          for (const key of keys) {\n            keysToDelete.add(key);\n          }\n          // Delete tag mapping\n          await this.kv.delete(tagKey);\n        }\n      }\n\n      if (keysToDelete.size > 0) {\n        await this.deleteMany([...keysToDelete]);\n      }\n    } catch (err) {\n      throw new CacheError(\n        `Cloudflare KV invalidate by tags failed: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n        CacheErrorCodes.OPERATION_FAILED,\n        err\n      );\n    }\n  }\n\n  async ttl(_key: string): Promise<number> {\n    // Cloudflare KV doesn't expose TTL, return -1 (unknown)\n    return -1;\n  }\n\n  async close(): Promise<void> {\n    // No-op for KV\n  }\n}\n\n/**\n * Create a Cloudflare KV cache adapter\n */\nexport function createCloudflareKVCacheAdapter(config: CloudflareKVCacheConfig): CloudflareKVCacheAdapter {\n  return new CloudflareKVCacheAdapter(config);\n}\n"],"mappings":"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","names":[]}

package/dist/adapters/index.d.ts

@@ -0,0 +1,6 @@
+export { MemoryCacheAdapter, createMemoryCacheAdapter } from './memory.js';
+export { RedisCacheAdapter, createRedisCacheAdapter } from './redis.js';
+export { UpstashCacheAdapter, createUpstashCacheAdapter } from './upstash.js';
+export { CloudflareKVCacheAdapter, createCloudflareKVCacheAdapter } from './cloudflare-kv.js';
+import '../types.js';
+import '@parsrun/types';