@parsrun/cache 0.1.0

package/dist/adapters/redis.js

@@ -0,0 +1,242 @@
+// 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/redis.ts
+var RedisCacheAdapter = class {
+  type = "redis";
+  client;
+  keyPrefix;
+  isExternalClient;
+  constructor(config) {
+    this.client = config.client;
+    this.keyPrefix = config.keyPrefix ?? "";
+    this.isExternalClient = true;
+  }
+  prefixKey(key) {
+    return this.keyPrefix ? `${this.keyPrefix}:${key}` : key;
+  }
+  async get(key, _options) {
+    try {
+      const data = await this.client.get(this.prefixKey(key));
+      if (!data) {
+        return null;
+      }
+      const parsed = JSON.parse(data);
+      return parsed.value;
+    } catch (err) {
+      throw new CacheError(
+        `Redis get failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        CacheErrorCodes.OPERATION_FAILED,
+        err
+      );
+    }
+  }
+  async set(key, value, options) {
+    try {
+      const data = JSON.stringify({
+        value,
+        tags: options?.tags,
+        metadata: options?.metadata
+      });
+      const prefixedKey = this.prefixKey(key);
+      if (options?.ttl) {
+        await this.client.set(prefixedKey, data, "EX", options.ttl);
+      } else {
+        await this.client.set(prefixedKey, data);
+      }
+      if (options?.tags && options.tags.length > 0) {
+        const pipeline = this.client.pipeline();
+        for (const tag of options.tags) {
+          const tagKey = this.prefixKey(`__tag:${tag}`);
+          pipeline.set(tagKey, JSON.stringify([...await this.getTagKeys(tag), key]));
+        }
+        await pipeline.exec();
+      }
+    } catch (err) {
+      throw new CacheError(
+        `Redis set failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        CacheErrorCodes.OPERATION_FAILED,
+        err
+      );
+    }
+  }
+  async delete(key) {
+    try {
+      await this.client.del(this.prefixKey(key));
+    } catch (err) {
+      throw new CacheError(
+        `Redis delete failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        CacheErrorCodes.OPERATION_FAILED,
+        err
+      );
+    }
+  }
+  async has(key) {
+    try {
+      const exists = await this.client.exists(this.prefixKey(key));
+      return exists > 0;
+    } catch (err) {
+      throw new CacheError(
+        `Redis exists failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        CacheErrorCodes.OPERATION_FAILED,
+        err
+      );
+    }
+  }
+  async clear() {
+    try {
+      if (this.keyPrefix) {
+        const keys = await this.client.keys(`${this.keyPrefix}:*`);
+        if (keys.length > 0) {
+          await this.client.del(...keys);
+        }
+      } else {
+        await this.client.flushdb();
+      }
+    } catch (err) {
+      throw new CacheError(
+        `Redis clear failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        CacheErrorCodes.OPERATION_FAILED,
+        err
+      );
+    }
+  }
+  async getMany(keys) {
+    try {
+      const prefixedKeys = keys.map((k) => this.prefixKey(k));
+      const results = await this.client.mget(...prefixedKeys);
+      const map = /* @__PURE__ */ new Map();
+      for (let i = 0; i < keys.length; i++) {
+        const data = results[i];
+        if (data) {
+          const parsed = JSON.parse(data);
+          map.set(keys[i] ?? "", parsed.value);
+        } else {
+          map.set(keys[i] ?? "", null);
+        }
+      }
+      return map;
+    } catch (err) {
+      throw new CacheError(
+        `Redis mget failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        CacheErrorCodes.OPERATION_FAILED,
+        err
+      );
+    }
+  }
+  async setMany(entries, options) {
+    try {
+      const pipeline = this.client.pipeline();
+      for (const [key, value] of entries) {
+        const data = JSON.stringify({
+          value,
+          tags: options?.tags,
+          metadata: options?.metadata
+        });
+        const prefixedKey = this.prefixKey(key);
+        if (options?.ttl) {
+          pipeline.set(prefixedKey, data, "EX", options.ttl);
+        } else {
+          pipeline.set(prefixedKey, data);
+        }
+      }
+      await pipeline.exec();
+    } catch (err) {
+      throw new CacheError(
+        `Redis mset failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        CacheErrorCodes.OPERATION_FAILED,
+        err
+      );
+    }
+  }
+  async deleteMany(keys) {
+    try {
+      const prefixedKeys = keys.map((k) => this.prefixKey(k));
+      await this.client.del(...prefixedKeys);
+    } catch (err) {
+      throw new CacheError(
+        `Redis mdel failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        CacheErrorCodes.OPERATION_FAILED,
+        err
+      );
+    }
+  }
+  async invalidateByTags(tags) {
+    try {
+      const keysToDelete = [];
+      for (const tag of tags) {
+        const keys = await this.getTagKeys(tag);
+        keysToDelete.push(...keys);
+      }
+      if (keysToDelete.length > 0) {
+        await this.deleteMany(keysToDelete);
+      }
+      const tagKeys = tags.map((tag) => this.prefixKey(`__tag:${tag}`));
+      await this.client.del(...tagKeys);
+    } catch (err) {
+      throw new CacheError(
+        `Redis invalidate by tags failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        CacheErrorCodes.OPERATION_FAILED,
+        err
+      );
+    }
+  }
+  async ttl(key) {
+    try {
+      return await this.client.ttl(this.prefixKey(key));
+    } catch (err) {
+      throw new CacheError(
+        `Redis ttl failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        CacheErrorCodes.OPERATION_FAILED,
+        err
+      );
+    }
+  }
+  async close() {
+    if (!this.isExternalClient) {
+      await this.client.quit();
+    }
+  }
+  async getTagKeys(tag) {
+    const tagKey = this.prefixKey(`__tag:${tag}`);
+    const data = await this.client.get(tagKey);
+    if (data) {
+      return JSON.parse(data);
+    }
+    return [];
+  }
+};
+function createRedisCacheAdapter(config) {
+  return new RedisCacheAdapter(config);
+}
+export {
+  RedisCacheAdapter,
+  createRedisCacheAdapter
+};
+//# sourceMappingURL=redis.js.map

package/dist/adapters/redis.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types.ts","../../src/adapters/redis.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 - Redis Adapter\n * Redis cache adapter using ioredis (Node.js)\n */\n\nimport type {\n  CacheAdapter,\n  CacheGetOptions,\n  CacheSetOptions,\n  RedisCacheConfig,\n} from \"../types.js\";\nimport { CacheError, CacheErrorCodes } from \"../types.js\";\n\n/**\n * Redis client interface (ioredis compatible)\n */\ninterface RedisClient {\n  get(key: string): Promise<string | null>;\n  set(key: string, value: string, ...args: (string | number)[]): Promise<\"OK\" | null>;\n  del(...keys: string[]): Promise<number>;\n  exists(...keys: string[]): Promise<number>;\n  ttl(key: string): Promise<number>;\n  mget(...keys: string[]): Promise<(string | null)[]>;\n  keys(pattern: string): Promise<string[]>;\n  flushdb(): Promise<\"OK\">;\n  quit(): Promise<\"OK\">;\n  pipeline(): RedisPipeline;\n}\n\ninterface RedisPipeline {\n  set(key: string, value: string, ...args: (string | number)[]): this;\n  exec(): Promise<Array<[Error | null, unknown]>>;\n}\n\n/**\n * Redis Cache Adapter\n * Uses ioredis for Node.js environments\n *\n * @example\n * ```typescript\n * import Redis from 'ioredis';\n *\n * const redis = new Redis(process.env.REDIS_URL);\n * const cache = new RedisCacheAdapter({ client: redis });\n *\n * await cache.set('user:123', { name: 'John' }, { ttl: 3600 });\n * const user = await cache.get('user:123');\n * ```\n */\nexport class RedisCacheAdapter implements CacheAdapter {\n  readonly type = \"redis\" as const;\n\n  private client: RedisClient;\n  private keyPrefix: string;\n  private isExternalClient: boolean;\n\n  constructor(config: RedisCacheConfig & { client: RedisClient }) {\n    this.client = config.client;\n    this.keyPrefix = config.keyPrefix ?? \"\";\n    this.isExternalClient = true;\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.client.get(this.prefixKey(key));\n\n      if (!data) {\n        return null;\n      }\n\n      const parsed = JSON.parse(data) as { value: T; tags?: string[] };\n      return parsed.value;\n    } catch (err) {\n      throw new CacheError(\n        `Redis 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 = JSON.stringify({\n        value,\n        tags: options?.tags,\n        metadata: options?.metadata,\n      });\n\n      const prefixedKey = this.prefixKey(key);\n\n      if (options?.ttl) {\n        await this.client.set(prefixedKey, data, \"EX\", options.ttl);\n      } else {\n        await this.client.set(prefixedKey, data);\n      }\n\n      // Store tag-to-key mappings\n      if (options?.tags && options.tags.length > 0) {\n        const pipeline = this.client.pipeline();\n        for (const tag of options.tags) {\n          const tagKey = this.prefixKey(`__tag:${tag}`);\n          pipeline.set(tagKey, JSON.stringify([...(await this.getTagKeys(tag)), key]));\n        }\n        await pipeline.exec();\n      }\n    } catch (err) {\n      throw new CacheError(\n        `Redis 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.client.del(this.prefixKey(key));\n    } catch (err) {\n      throw new CacheError(\n        `Redis 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 exists = await this.client.exists(this.prefixKey(key));\n      return exists > 0;\n    } catch (err) {\n      throw new CacheError(\n        `Redis exists 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      if (this.keyPrefix) {\n        // Only delete keys with our prefix\n        const keys = await this.client.keys(`${this.keyPrefix}:*`);\n        if (keys.length > 0) {\n          await this.client.del(...keys);\n        }\n      } else {\n        await this.client.flushdb();\n      }\n    } catch (err) {\n      throw new CacheError(\n        `Redis 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    try {\n      const prefixedKeys = keys.map((k) => this.prefixKey(k));\n      const results = await this.client.mget(...prefixedKeys);\n\n      const map = new Map<string, T | null>();\n      for (let i = 0; i < keys.length; i++) {\n        const data = results[i];\n        if (data) {\n          const parsed = JSON.parse(data) as { value: T };\n          map.set(keys[i] ?? \"\", parsed.value);\n        } else {\n          map.set(keys[i] ?? \"\", null);\n        }\n      }\n\n      return map;\n    } catch (err) {\n      throw new CacheError(\n        `Redis mget failed: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n        CacheErrorCodes.OPERATION_FAILED,\n        err\n      );\n    }\n  }\n\n  async setMany<T = unknown>(entries: Map<string, T>, options?: CacheSetOptions): Promise<void> {\n    try {\n      const pipeline = this.client.pipeline();\n\n      for (const [key, value] of entries) {\n        const data = JSON.stringify({\n          value,\n          tags: options?.tags,\n          metadata: options?.metadata,\n        });\n\n        const prefixedKey = this.prefixKey(key);\n\n        if (options?.ttl) {\n          pipeline.set(prefixedKey, data, \"EX\", options.ttl);\n        } else {\n          pipeline.set(prefixedKey, data);\n        }\n      }\n\n      await pipeline.exec();\n    } catch (err) {\n      throw new CacheError(\n        `Redis mset failed: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n        CacheErrorCodes.OPERATION_FAILED,\n        err\n      );\n    }\n  }\n\n  async deleteMany(keys: string[]): Promise<void> {\n    try {\n      const prefixedKeys = keys.map((k) => this.prefixKey(k));\n      await this.client.del(...prefixedKeys);\n    } catch (err) {\n      throw new CacheError(\n        `Redis mdel failed: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n        CacheErrorCodes.OPERATION_FAILED,\n        err\n      );\n    }\n  }\n\n  async invalidateByTags(tags: string[]): Promise<void> {\n    try {\n      const keysToDelete: string[] = [];\n\n      for (const tag of tags) {\n        const keys = await this.getTagKeys(tag);\n        keysToDelete.push(...keys);\n      }\n\n      if (keysToDelete.length > 0) {\n        await this.deleteMany(keysToDelete);\n      }\n\n      // Clean up tag mappings\n      const tagKeys = tags.map((tag) => this.prefixKey(`__tag:${tag}`));\n      await this.client.del(...tagKeys);\n    } catch (err) {\n      throw new CacheError(\n        `Redis 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    try {\n      return await this.client.ttl(this.prefixKey(key));\n    } catch (err) {\n      throw new CacheError(\n        `Redis ttl failed: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n        CacheErrorCodes.OPERATION_FAILED,\n        err\n      );\n    }\n  }\n\n  async close(): Promise<void> {\n    if (!this.isExternalClient) {\n      await this.client.quit();\n    }\n  }\n\n  private async getTagKeys(tag: string): Promise<string[]> {\n    const tagKey = this.prefixKey(`__tag:${tag}`);\n    const data = await this.client.get(tagKey);\n    if (data) {\n      return JSON.parse(data) as string[];\n    }\n    return [];\n  }\n}\n\n/**\n * Create a Redis cache adapter\n */\nexport function createRedisCacheAdapter(\n  config: RedisCacheConfig & { client: RedisClient }\n): RedisCacheAdapter {\n  return new RedisCacheAdapter(config);\n}\n"],"mappings":"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","names":[]}

package/dist/adapters/upstash.d.ts

@@ -0,0 +1,50 @@
+import { CacheAdapter, UpstashCacheConfig, CacheGetOptions, CacheSetOptions } from '../types.js';
+import '@parsrun/types';
+
+/**
+ * @parsrun/cache - Upstash Adapter
+ * Edge-compatible Upstash Redis adapter using fetch API
+ */
+
+/**
+ * Upstash Cache Adapter
+ * Edge-compatible using HTTP API
+ *
+ * @example
+ * ```typescript
+ * const cache = new UpstashCacheAdapter({
+ *   url: process.env.UPSTASH_REDIS_REST_URL,
+ *   token: process.env.UPSTASH_REDIS_REST_TOKEN,
+ * });
+ *
+ * await cache.set('user:123', { name: 'John' }, { ttl: 3600 });
+ * const user = await cache.get('user:123');
+ * ```
+ */
+declare class UpstashCacheAdapter implements CacheAdapter {
+    readonly type: "upstash";
+    private url;
+    private token;
+    private keyPrefix;
+    constructor(config: UpstashCacheConfig);
+    private prefixKey;
+    private command;
+    private pipeline;
+    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 an Upstash cache adapter
+ */
+declare function createUpstashCacheAdapter(config: UpstashCacheConfig): UpstashCacheAdapter;
+
+export { UpstashCacheAdapter, createUpstashCacheAdapter };

package/dist/adapters/upstash.js

@@ -0,0 +1,229 @@
+// 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/upstash.ts
+var UpstashCacheAdapter = class {
+  type = "upstash";
+  url;
+  token;
+  keyPrefix;
+  constructor(config) {
+    this.url = config.url.replace(/\/$/, "");
+    this.token = config.token;
+    this.keyPrefix = config.keyPrefix ?? "";
+  }
+  prefixKey(key) {
+    return this.keyPrefix ? `${this.keyPrefix}:${key}` : key;
+  }
+  async command(...args) {
+    try {
+      const response = await fetch(this.url, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${this.token}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify(args)
+      });
+      if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`Upstash API error: ${error}`);
+      }
+      const data = await response.json();
+      if (data.error) {
+        throw new Error(data.error);
+      }
+      return data.result;
+    } catch (err) {
+      throw new CacheError(
+        `Upstash command failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        CacheErrorCodes.OPERATION_FAILED,
+        err
+      );
+    }
+  }
+  async pipeline(commands) {
+    try {
+      const response = await fetch(`${this.url}/pipeline`, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${this.token}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify(commands)
+      });
+      if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`Upstash API error: ${error}`);
+      }
+      const data = await response.json();
+      return data.map((item) => {
+        if (item.error) {
+          throw new Error(item.error);
+        }
+        return item.result;
+      });
+    } catch (err) {
+      throw new CacheError(
+        `Upstash pipeline failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        CacheErrorCodes.OPERATION_FAILED,
+        err
+      );
+    }
+  }
+  async get(key, _options) {
+    const data = await this.command("GET", this.prefixKey(key));
+    if (!data) {
+      return null;
+    }
+    try {
+      const parsed = JSON.parse(data);
+      return parsed.value;
+    } catch {
+      return data;
+    }
+  }
+  async set(key, value, options) {
+    const data = JSON.stringify({
+      value,
+      tags: options?.tags,
+      metadata: options?.metadata
+    });
+    const prefixedKey = this.prefixKey(key);
+    if (options?.ttl) {
+      await this.command("SET", prefixedKey, data, "EX", options.ttl);
+    } else {
+      await this.command("SET", prefixedKey, data);
+    }
+    if (options?.tags && options.tags.length > 0) {
+      const commands = [];
+      for (const tag of options.tags) {
+        commands.push(["SADD", this.prefixKey(`__tag:${tag}`), key]);
+      }
+      await this.pipeline(commands);
+    }
+  }
+  async delete(key) {
+    await this.command("DEL", this.prefixKey(key));
+  }
+  async has(key) {
+    const exists = await this.command("EXISTS", this.prefixKey(key));
+    return exists > 0;
+  }
+  async clear() {
+    if (this.keyPrefix) {
+      let cursor = "0";
+      do {
+        const result = await this.command(
+          "SCAN",
+          cursor,
+          "MATCH",
+          `${this.keyPrefix}:*`,
+          "COUNT",
+          100
+        );
+        cursor = result[0];
+        const keys = result[1];
+        if (keys.length > 0) {
+          await this.command("DEL", ...keys);
+        }
+      } while (cursor !== "0");
+    } else {
+      await this.command("FLUSHDB");
+    }
+  }
+  async getMany(keys) {
+    const prefixedKeys = keys.map((k) => this.prefixKey(k));
+    const results = await this.command("MGET", ...prefixedKeys);
+    const map = /* @__PURE__ */ new Map();
+    for (let i = 0; i < keys.length; i++) {
+      const data = results[i];
+      const key = keys[i];
+      if (key !== void 0) {
+        if (data) {
+          try {
+            const parsed = JSON.parse(data);
+            map.set(key, parsed.value);
+          } catch {
+            map.set(key, data);
+          }
+        } else {
+          map.set(key, null);
+        }
+      }
+    }
+    return map;
+  }
+  async setMany(entries, options) {
+    const commands = [];
+    for (const [key, value] of entries) {
+      const data = JSON.stringify({
+        value,
+        tags: options?.tags,
+        metadata: options?.metadata
+      });
+      const prefixedKey = this.prefixKey(key);
+      if (options?.ttl) {
+        commands.push(["SET", prefixedKey, data, "EX", options.ttl]);
+      } else {
+        commands.push(["SET", prefixedKey, data]);
+      }
+    }
+    await this.pipeline(commands);
+  }
+  async deleteMany(keys) {
+    const prefixedKeys = keys.map((k) => this.prefixKey(k));
+    await this.command("DEL", ...prefixedKeys);
+  }
+  async invalidateByTags(tags) {
+    const keysToDelete = [];
+    for (const tag of tags) {
+      const keys = await this.command("SMEMBERS", this.prefixKey(`__tag:${tag}`));
+      keysToDelete.push(...keys);
+    }
+    if (keysToDelete.length > 0) {
+      await this.deleteMany(keysToDelete);
+    }
+    const tagKeys = tags.map((tag) => this.prefixKey(`__tag:${tag}`));
+    await this.command("DEL", ...tagKeys);
+  }
+  async ttl(key) {
+    return await this.command("TTL", this.prefixKey(key));
+  }
+  async close() {
+  }
+};
+function createUpstashCacheAdapter(config) {
+  return new UpstashCacheAdapter(config);
+}
+export {
+  UpstashCacheAdapter,
+  createUpstashCacheAdapter
+};
+//# sourceMappingURL=upstash.js.map

package/dist/adapters/upstash.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types.ts","../../src/adapters/upstash.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 - Upstash Adapter\n * Edge-compatible Upstash Redis adapter using fetch API\n */\n\nimport type {\n  CacheAdapter,\n  CacheGetOptions,\n  CacheSetOptions,\n  UpstashCacheConfig,\n} from \"../types.js\";\nimport { CacheError, CacheErrorCodes } from \"../types.js\";\n\n/**\n * Upstash Cache Adapter\n * Edge-compatible using HTTP API\n *\n * @example\n * ```typescript\n * const cache = new UpstashCacheAdapter({\n *   url: process.env.UPSTASH_REDIS_REST_URL,\n *   token: process.env.UPSTASH_REDIS_REST_TOKEN,\n * });\n *\n * await cache.set('user:123', { name: 'John' }, { ttl: 3600 });\n * const user = await cache.get('user:123');\n * ```\n */\nexport class UpstashCacheAdapter implements CacheAdapter {\n  readonly type = \"upstash\" as const;\n\n  private url: string;\n  private token: string;\n  private keyPrefix: string;\n\n  constructor(config: UpstashCacheConfig) {\n    this.url = config.url.replace(/\\/$/, \"\"); // Remove trailing slash\n    this.token = config.token;\n    this.keyPrefix = config.keyPrefix ?? \"\";\n  }\n\n  private prefixKey(key: string): string {\n    return this.keyPrefix ? `${this.keyPrefix}:${key}` : key;\n  }\n\n  private async command<T = unknown>(...args: (string | number)[]): Promise<T> {\n    try {\n      const response = await fetch(this.url, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.token}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify(args),\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new Error(`Upstash API error: ${error}`);\n      }\n\n      const data = await response.json() as { result: T; error?: string };\n\n      if (data.error) {\n        throw new Error(data.error);\n      }\n\n      return data.result;\n    } catch (err) {\n      throw new CacheError(\n        `Upstash command failed: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n        CacheErrorCodes.OPERATION_FAILED,\n        err\n      );\n    }\n  }\n\n  private async pipeline<T = unknown>(commands: (string | number)[][]): Promise<T[]> {\n    try {\n      const response = await fetch(`${this.url}/pipeline`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.token}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify(commands),\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new Error(`Upstash API error: ${error}`);\n      }\n\n      const data = await response.json() as Array<{ result: T; error?: string }>;\n      return data.map((item) => {\n        if (item.error) {\n          throw new Error(item.error);\n        }\n        return item.result;\n      });\n    } catch (err) {\n      throw new CacheError(\n        `Upstash pipeline failed: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n        CacheErrorCodes.OPERATION_FAILED,\n        err\n      );\n    }\n  }\n\n  async get<T = unknown>(key: string, _options?: CacheGetOptions): Promise<T | null> {\n    const data = await this.command<string | null>(\"GET\", this.prefixKey(key));\n\n    if (!data) {\n      return null;\n    }\n\n    try {\n      const parsed = JSON.parse(data) as { value: T };\n      return parsed.value;\n    } catch {\n      // Return raw string if not JSON\n      return data as T;\n    }\n  }\n\n  async set<T = unknown>(key: string, value: T, options?: CacheSetOptions): Promise<void> {\n    const data = JSON.stringify({\n      value,\n      tags: options?.tags,\n      metadata: options?.metadata,\n    });\n\n    const prefixedKey = this.prefixKey(key);\n\n    if (options?.ttl) {\n      await this.command(\"SET\", prefixedKey, data, \"EX\", options.ttl);\n    } else {\n      await this.command(\"SET\", prefixedKey, data);\n    }\n\n    // Store tag-to-key mappings\n    if (options?.tags && options.tags.length > 0) {\n      const commands: (string | number)[][] = [];\n      for (const tag of options.tags) {\n        commands.push([\"SADD\", this.prefixKey(`__tag:${tag}`), key]);\n      }\n      await this.pipeline(commands);\n    }\n  }\n\n  async delete(key: string): Promise<void> {\n    await this.command(\"DEL\", this.prefixKey(key));\n  }\n\n  async has(key: string): Promise<boolean> {\n    const exists = await this.command<number>(\"EXISTS\", this.prefixKey(key));\n    return exists > 0;\n  }\n\n  async clear(): Promise<void> {\n    if (this.keyPrefix) {\n      // Scan and delete keys with our prefix\n      let cursor = \"0\";\n      do {\n        const result = await this.command<[string, string[]]>(\n          \"SCAN\",\n          cursor,\n          \"MATCH\",\n          `${this.keyPrefix}:*`,\n          \"COUNT\",\n          100\n        );\n        cursor = result[0];\n        const keys = result[1];\n\n        if (keys.length > 0) {\n          await this.command(\"DEL\", ...keys);\n        }\n      } while (cursor !== \"0\");\n    } else {\n      await this.command(\"FLUSHDB\");\n    }\n  }\n\n  async getMany<T = unknown>(keys: string[]): Promise<Map<string, T | null>> {\n    const prefixedKeys = keys.map((k) => this.prefixKey(k));\n    const results = await this.command<(string | null)[]>(\"MGET\", ...prefixedKeys);\n\n    const map = new Map<string, T | null>();\n    for (let i = 0; i < keys.length; i++) {\n      const data = results[i];\n      const key = keys[i];\n      if (key !== undefined) {\n        if (data) {\n          try {\n            const parsed = JSON.parse(data) as { value: T };\n            map.set(key, parsed.value);\n          } catch {\n            map.set(key, data as T);\n          }\n        } else {\n          map.set(key, null);\n        }\n      }\n    }\n\n    return map;\n  }\n\n  async setMany<T = unknown>(entries: Map<string, T>, options?: CacheSetOptions): Promise<void> {\n    const commands: (string | number)[][] = [];\n\n    for (const [key, value] of entries) {\n      const data = JSON.stringify({\n        value,\n        tags: options?.tags,\n        metadata: options?.metadata,\n      });\n\n      const prefixedKey = this.prefixKey(key);\n\n      if (options?.ttl) {\n        commands.push([\"SET\", prefixedKey, data, \"EX\", options.ttl]);\n      } else {\n        commands.push([\"SET\", prefixedKey, data]);\n      }\n    }\n\n    await this.pipeline(commands);\n  }\n\n  async deleteMany(keys: string[]): Promise<void> {\n    const prefixedKeys = keys.map((k) => this.prefixKey(k));\n    await this.command(\"DEL\", ...prefixedKeys);\n  }\n\n  async invalidateByTags(tags: string[]): Promise<void> {\n    const keysToDelete: string[] = [];\n\n    // Get all keys for each tag\n    for (const tag of tags) {\n      const keys = await this.command<string[]>(\"SMEMBERS\", this.prefixKey(`__tag:${tag}`));\n      keysToDelete.push(...keys);\n    }\n\n    if (keysToDelete.length > 0) {\n      await this.deleteMany(keysToDelete);\n    }\n\n    // Clean up tag sets\n    const tagKeys = tags.map((tag) => this.prefixKey(`__tag:${tag}`));\n    await this.command(\"DEL\", ...tagKeys);\n  }\n\n  async ttl(key: string): Promise<number> {\n    return await this.command<number>(\"TTL\", this.prefixKey(key));\n  }\n\n  async close(): Promise<void> {\n    // No-op for HTTP client\n  }\n}\n\n/**\n * Create an Upstash cache adapter\n */\nexport function createUpstashCacheAdapter(config: UpstashCacheConfig): UpstashCacheAdapter {\n  return new UpstashCacheAdapter(config);\n}\n"],"mappings":"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","names":[]}