@open-mercato/cache 0.6.7 → 0.6.8-canary.319.1.5b4be4bc52

package/AGENTS.md

@@ -21,7 +21,7 @@ The memory strategy is bounded so a process-shared instance (`OM_BOOTSTRAP_CACHE
 
 ## Always
 
-1. **MUST resolve via DI** — always use `container.resolve('cacheService')`, never instantiate cache directly
+1. **MUST resolve via DI** — always use `container.resolve('cache')`, never instantiate cache directly. The DI token is `cache` (registered in `packages/core/src/bootstrap.ts`); there is no `cacheService` registration.
 2. **MUST scope to tenant** — include `tenantId` in cache keys or use `runWithCacheTenant()` for automatic scoping
 3. **MUST use tag-based invalidation** for CRUD side effects — tag entries so related data can be invalidated together
 
@@ -48,22 +48,27 @@ yarn workspace @open-mercato/cache build
 Use tags when cached data relates to a specific entity or scope. Invalidating a tag clears all entries with that tag.
 
 ```typescript
+const cache = container.resolve('cache')
+
 // When caching, attach tags
-await cacheService.set('key', value, { tags: ['tenant:123', 'customers'] })
+await cache.set('key', value, { tags: ['tenant:123', 'customers'] })
 
-// When data changes, invalidate by tag
-await cacheService.invalidateTag('customers')  // Clears all customer-related cache
+// When data changes, invalidate by tag — `deleteByTags` takes an ARRAY of tags
+// (any entry carrying ANY of them is dropped) and returns the number of deleted keys.
+await cache.deleteByTags(['customers'])  // Clears all customer-related cache
 ```
 
+`CacheStrategy` is the only cache surface: `get`, `set`, `has`, `delete`, `deleteByTags`, `clear`, `keys`, `stats`, plus optional `healthcheck`, `cleanup`, `close`. There is no `invalidateTag` — MUST NOT invent per-tag helpers in module code.
+
 ## Consistency vs commit timing
 
 Cache invalidation and query-index side effects (`emitCrudSideEffects`) MUST fire **after** the originating domain write commits — the same rule that keeps them OUTSIDE the `withAtomicFlush` block (see `packages/core/AGENTS.md` → "Entity Update Safety — `withAtomicFlush`"). Because invalidation runs post-commit and the query-index read-projection tail (search tokens, vectors, fulltext, coverage) converges asynchronously, reads can briefly see a short convergence window after a write.
 
-An opt-in env flag, `OM_CACHE_SAFETY_ALWAYS_CONSISTENT` (default **OFF**, 100% backward compatible), is planned to make that read-projection tail converge synchronously on write so reads never observe the window — at the cost of added write latency. Frame it as opt-in/forthcoming; do not assume it is on. See `.ai/specs/2026-06-05-cache-safety-always-consistent.md`.
+The opt-in env flag `OM_CACHE_SAFETY_ALWAYS_CONSISTENT` (default **OFF**, 100% backward compatible) makes that read-projection tail converge synchronously on write and propagates index-write failures instead of swallowing them — at the cost of added write latency. It does not move query-index side effects into the domain-write transaction. See `.ai/specs/2026-06-05-cache-safety-always-consistent.md`.
 
 ## Adding Caching to a Module
 
-1. Resolve `cacheService` from DI in your service or route handler
+1. Resolve the `cache` service from DI (`container.resolve('cache')`) in your service or route handler
 2. Define cache keys with tenant scoping: `${tenantId}:${module}:${identifier}`
 3. Tag entries with entity type and tenant for targeted invalidation
 4. Add cache invalidation to CRUD side effects (`emitCrudSideEffects` with `cacheAliases`)
@@ -82,3 +87,4 @@ packages/cache/src/
 - Follow the strategy pattern — add new strategies in `strategies/` with the same interface
 - Run `yarn test` in `packages/cache` after changes
 - Verify tag invalidation works across all strategies when modifying invalidation logic
+- The DI token and method names quoted in this file and in `.ai/review-checklist.md` are pinned to the real sources by `src/__tests__/cache-di-contract-docs.test.ts` (it re-derives the token from `packages/core/src/bootstrap.ts` and the members from `CacheStrategy`). Renaming the token or a method MUST update both docs in the same change.

package/dist/service.js

@@ -41,7 +41,7 @@ function resolveTenantPrefixes() {
   };
 }
 function hashIdentifier(input) {
-  return createHash("sha1").update(input).digest("hex");
+  return createHash("sha256").update(input).digest("hex");
 }
 function storageKey(originalKey, prefixes) {
   return `${prefixes.keyPrefix}k:${hashIdentifier(originalKey)}`;

package/dist/service.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/service.ts"],
-  "sourcesContent": ["import type { CacheStrategy, CacheServiceOptions, CacheGetOptions, CacheSetOptions, CacheValue } from './types'\nimport { createMemoryStrategy } from './strategies/memory'\nimport { createRedisStrategy } from './strategies/redis'\nimport { createSqliteStrategy } from './strategies/sqlite'\nimport { createJsonFileStrategy } from './strategies/jsonfile'\nimport { getCurrentCacheTenant } from './tenantContext'\nimport { createHash } from 'node:crypto'\nimport { CacheDependencyUnavailableError } from './errors'\nimport { matchCacheKeyPattern } from './patterns'\n\nfunction normalizeTenantKey(raw: string | null | undefined): string {\n  const value = typeof raw === 'string' ? raw.trim() : ''\n  if (!value) return 'global'\n  return value.replace(/[^a-zA-Z0-9._-]/g, '_')\n}\n\ntype TenantPrefixes = {\n  keyPrefix: string\n  tagPrefix: string\n  scopeTag: string\n}\n\ntype CacheMetadata = {\n  key: string\n  expiresAt: number | null\n}\n\nfunction isCacheMetadata(value: CacheValue | null): value is CacheMetadata {\n  if (typeof value !== 'object' || value === null) {\n    return false\n  }\n  const record = value as Record<string, unknown>\n  const hasValidKey = typeof record.key === 'string'\n  const hasValidExpiresAt =\n    !('expiresAt' in record)\n    || record.expiresAt === null\n    || typeof record.expiresAt === 'number'\n\n  return hasValidKey && hasValidExpiresAt\n}\n\ntype CacheStrategyName = NonNullable<CacheServiceOptions['strategy']>\nconst KNOWN_STRATEGIES: CacheStrategyName[] = ['memory', 'redis', 'sqlite', 'jsonfile']\nconst TENANT_META_KEY_PATTERN = 'tenant:*:key:meta:*'\nconst TENANT_META_KEY_MARKER = ':key:meta:'\n\ntype TenantAwareCacheStrategy = CacheStrategy & {\n  deleteByPatternsAcrossScopes(patterns: string[]): Promise<number>\n}\n\nfunction isCacheStrategyName(value: string | undefined): value is CacheStrategyName {\n  if (!value) return false\n  return KNOWN_STRATEGIES.includes(value as CacheStrategyName)\n}\n\nfunction resolveConfiguredStrategyType(options?: CacheServiceOptions): CacheStrategyName {\n  const envStrategy = isCacheStrategyName(process.env.CACHE_STRATEGY)\n    ? process.env.CACHE_STRATEGY\n    : undefined\n  return options?.strategy ?? envStrategy ?? 'memory'\n}\n\nfunction resolveTenantPrefixes(): TenantPrefixes {\n  const tenant = normalizeTenantKey(getCurrentCacheTenant())\n  const base = `tenant:${tenant}:`\n  return {\n    keyPrefix: `${base}key:`,\n    tagPrefix: `${base}tag:`,\n    scopeTag: `${base}tag:__scope__`,\n  }\n}\n\nfunction hashIdentifier(input: string): string {\n  return createHash('sha1').update(input).digest('hex')\n}\n\nfunction storageKey(originalKey: string, prefixes: TenantPrefixes): string {\n  return `${prefixes.keyPrefix}k:${hashIdentifier(originalKey)}`\n}\n\nfunction metaKey(originalKey: string, prefixes: TenantPrefixes): string {\n  return `${prefixes.keyPrefix}meta:${hashIdentifier(originalKey)}`\n}\n\nfunction hashedTag(tag: string, prefixes: TenantPrefixes): string {\n  return `${prefixes.tagPrefix}t:${hashIdentifier(tag)}`\n}\n\nfunction buildTagSet(tags: string[] | undefined, prefixes: TenantPrefixes, includeScope: boolean): string[] {\n  const scoped = new Set<string>()\n  if (includeScope) scoped.add(prefixes.scopeTag)\n  if (Array.isArray(tags)) {\n    for (const tag of tags) {\n      if (typeof tag === 'string' && tag.length > 0) scoped.add(hashedTag(tag, prefixes))\n    }\n  }\n  return Array.from(scoped)\n}\n\nfunction createTenantAwareWrapper(base: CacheStrategy, reportsBoundedCounters: boolean): TenantAwareCacheStrategy {\n  function normalizeDeletionCount(raw: number): number {\n    if (!raw) return raw\n    if (!Number.isFinite(raw)) return raw\n    return Math.ceil(raw / 2)\n  }\n\n  const get = async (key: string, options?: CacheGetOptions) => {\n    const prefixes = resolveTenantPrefixes()\n    return base.get(storageKey(key, prefixes), options)\n  }\n\n  const set = async (key: string, value: CacheValue, options?: CacheSetOptions) => {\n    const prefixes = resolveTenantPrefixes()\n    const hashedTags = buildTagSet(options?.tags, prefixes, true)\n    const ttl = options?.ttl ?? undefined\n    const nextOptions: CacheSetOptions | undefined = options\n      ? { ...options, tags: hashedTags }\n      : { tags: hashedTags }\n    await base.set(storageKey(key, prefixes), value, nextOptions)\n    const metaPayload: CacheMetadata = { key, expiresAt: ttl ? Date.now() + ttl : null }\n    await base.set(metaKey(key, prefixes), metaPayload, {\n      ttl,\n      tags: hashedTags,\n    })\n  }\n\n  const has = async (key: string) => {\n    const prefixes = resolveTenantPrefixes()\n    return base.has(storageKey(key, prefixes))\n  }\n\n  const del = async (key: string) => {\n    const prefixes = resolveTenantPrefixes()\n    const primary = await base.delete(storageKey(key, prefixes))\n    await base.delete(metaKey(key, prefixes))\n    return primary\n  }\n\n  const deleteByTags = async (tags: string[]) => {\n    const prefixes = resolveTenantPrefixes()\n    const scopedTags = buildTagSet(tags, prefixes, false)\n    if (!scopedTags.length) return 0\n    const removed = await base.deleteByTags(scopedTags)\n    return normalizeDeletionCount(removed)\n  }\n\n  const clear = async () => {\n    const prefixes = resolveTenantPrefixes()\n    const removed = await base.deleteByTags([prefixes.scopeTag])\n    return normalizeDeletionCount(removed)\n  }\n\n  const keys = async (pattern?: string) => {\n    const prefixes = resolveTenantPrefixes()\n    const metaPattern = `${prefixes.keyPrefix}meta:*`\n    const metaKeys = await base.keys(metaPattern)\n    const originals: string[] = []\n    for (const metaKey of metaKeys) {\n      const metaValue = await base.get(metaKey, { returnExpired: true })\n      if (!metaValue) continue\n      const metadata = typeof metaValue === 'string' ? null : (isCacheMetadata(metaValue) ? metaValue : null)\n      const original = typeof metaValue === 'string' ? metaValue : metadata?.key\n      if (!original) continue\n      if (pattern && !matchCacheKeyPattern(original, pattern)) continue\n      originals.push(original)\n    }\n    return originals\n  }\n\n  const deleteByPatternsAcrossScopes = async (patterns: string[]) => {\n    const normalizedPatterns = Array.from(new Set(patterns.map((pattern) => pattern.trim()).filter(Boolean)))\n    if (normalizedPatterns.length === 0) return 0\n\n    const metaKeys = await base.keys(TENANT_META_KEY_PATTERN)\n    let deleted = 0\n    for (const metadataKey of metaKeys) {\n      const metadataValue = await base.get(metadataKey, { returnExpired: true })\n      if (!metadataValue) continue\n      const metadata = typeof metadataValue === 'string'\n        ? null\n        : (isCacheMetadata(metadataValue) ? metadataValue : null)\n      const originalKey = typeof metadataValue === 'string' ? metadataValue : metadata?.key\n      if (!originalKey || !normalizedPatterns.some((pattern) => matchCacheKeyPattern(originalKey, pattern))) {\n        continue\n      }\n\n      const markerIndex = metadataKey.lastIndexOf(TENANT_META_KEY_MARKER)\n      if (markerIndex < 0) continue\n      const primaryKey = `${metadataKey.slice(0, markerIndex)}:key:k:${metadataKey.slice(markerIndex + TENANT_META_KEY_MARKER.length)}`\n      if (await base.delete(primaryKey)) deleted += 1\n      await base.delete(metadataKey)\n    }\n    return deleted\n  }\n\n  const stats = async () => {\n    const prefixes = resolveTenantPrefixes()\n    const metaKeys = await base.keys(`${prefixes.keyPrefix}meta:*`)\n    let size = 0\n    let expired = 0\n    const now = Date.now()\n    for (const metaKey of metaKeys) {\n      const metaValue = await base.get(metaKey, { returnExpired: true })\n      if (!metaValue) continue\n      const metadata = typeof metaValue === 'string' ? null : (isCacheMetadata(metaValue) ? metaValue : null)\n      const original = typeof metaValue === 'string' ? metaValue : metadata?.key\n      if (!original) continue\n      size++\n      const expiresAt = metadata?.expiresAt ?? null\n      if (expiresAt !== null && expiresAt <= now) expired++\n    }\n    // size/expired stay tenant-scoped (derived from this tenant's meta keys).\n    // Only memory-backed strategies track the process-global bound counters, so\n    // skip the extra base.stats() round-trip for redis/sqlite/jsonfile and omit\n    // the optional fields (the stats() contract marks them optional). Keyed off\n    // the configured strategy: a backend degraded to the memory fallback\n    // intentionally does not surface these diagnostics.\n    if (!reportsBoundedCounters) {\n      return { size, expired }\n    }\n    const { evictions, sweeps, lastSweepReclaimed } = await base.stats()\n    return { size, expired, evictions, sweeps, lastSweepReclaimed }\n  }\n\n  const cleanup = base.cleanup\n    ? async () => normalizeDeletionCount(await base.cleanup!())\n    : undefined\n\n  const close = base.close\n    ? async () => base.close!()\n    : undefined\n  const healthcheck = base.healthcheck\n    ? async () => base.healthcheck!()\n    : undefined\n\n  return {\n    get,\n    set,\n    has,\n    delete: del,\n    deleteByTags,\n    clear,\n    keys,\n    stats,\n    healthcheck,\n    cleanup,\n    close,\n    deleteByPatternsAcrossScopes,\n  }\n}\n\nfunction createConfiguredTenantAwareStrategy(options?: CacheServiceOptions): TenantAwareCacheStrategy {\n  const strategyType = resolveConfiguredStrategyType(options)\n\n  const envTtl = process.env.CACHE_TTL\n  const parsedEnvTtl = envTtl ? Number.parseInt(envTtl, 10) : undefined\n  const defaultTtl = options?.defaultTtl ?? (typeof parsedEnvTtl === 'number' && Number.isFinite(parsedEnvTtl) ? parsedEnvTtl : undefined)\n\n  const envMaxEntries = process.env.CACHE_MEMORY_MAX_ENTRIES\n  const parsedEnvMaxEntries = envMaxEntries ? Number.parseInt(envMaxEntries, 10) : undefined\n  const maxEntries = options?.maxEntries ?? (typeof parsedEnvMaxEntries === 'number' && Number.isFinite(parsedEnvMaxEntries) ? parsedEnvMaxEntries : undefined)\n\n  const baseStrategy = createStrategyForType(strategyType, options, defaultTtl, maxEntries)\n  const resilientStrategy = withDependencyFallback(baseStrategy, strategyType, defaultTtl, maxEntries)\n  const reportsBoundedCounters = strategyType === 'memory'\n\n  return createTenantAwareWrapper(resilientStrategy, reportsBoundedCounters)\n}\n\n/**\n * Cache service that provides a unified interface to different cache strategies\n *\n * Configuration via environment variables:\n * - CACHE_STRATEGY: 'memory' | 'redis' | 'sqlite' | 'jsonfile' (default: 'memory')\n * - CACHE_TTL: Default TTL in milliseconds (optional)\n * - CACHE_REDIS_URL: Redis connection URL (for redis strategy)\n * - CACHE_SQLITE_PATH: SQLite database file path (for sqlite strategy)\n * - CACHE_JSON_FILE_PATH: JSON file path (for jsonfile strategy)\n *\n * @example\n * const cache = createCacheService({ strategy: 'memory', defaultTtl: 60000 })\n * await cache.set('user:123', { name: 'John' }, { tags: ['users', 'user:123'] })\n * const user = await cache.get('user:123')\n * await cache.deleteByTags(['users']) // Invalidate all user-related cache\n */\nexport function createCacheService(options?: CacheServiceOptions): CacheStrategy {\n  return createConfiguredTenantAwareStrategy(options)\n}\n\n/**\n * Delete matching logical keys across every tenant scope in the configured\n * stock cache backend without bootstrapping application DI or querying the\n * tenant database. Intended for maintenance tasks that already operate on all\n * scopes, such as post-generation structural invalidation.\n */\nexport async function purgeConfiguredCachePatternsAcrossTenantScopes(\n  patterns: string[],\n  options?: CacheServiceOptions,\n): Promise<number> {\n  // A newly-created memory strategy cannot reach the running app's process-local\n  // cache, so constructing one here would only allocate and immediately discard\n  // an empty store. Persistent stock backends remain cross-process maintainable.\n  if (resolveConfiguredStrategyType(options) === 'memory') return 0\n\n  const cache = createConfiguredTenantAwareStrategy(options)\n  try {\n    return await cache.deleteByPatternsAcrossScopes(patterns)\n  } finally {\n    await cache.close?.()\n  }\n}\n\n/**\n * CacheService class wrapper for DI integration\n * Provides the same interface as the functional API but as a class\n */\nexport class CacheService implements CacheStrategy {\n  private strategy: CacheStrategy\n\n  constructor(options?: CacheServiceOptions) {\n    this.strategy = createCacheService(options)\n  }\n\n  async get(key: string, options?: CacheGetOptions): Promise<CacheValue | null> {\n    return this.strategy.get(key, options)\n  }\n\n  async set(key: string, value: CacheValue, options?: CacheSetOptions): Promise<void> {\n    return this.strategy.set(key, value, options)\n  }\n\n  async has(key: string): Promise<boolean> {\n    return this.strategy.has(key)\n  }\n\n  async delete(key: string): Promise<boolean> {\n    return this.strategy.delete(key)\n  }\n\n  async deleteByTags(tags: string[]): Promise<number> {\n    return this.strategy.deleteByTags(tags)\n  }\n\n  async clear(): Promise<number> {\n    return this.strategy.clear()\n  }\n\n  async keys(pattern?: string): Promise<string[]> {\n    return this.strategy.keys(pattern)\n  }\n\n  async stats(): Promise<{\n    size: number\n    expired: number\n    evictions?: number\n    sweeps?: number\n    lastSweepReclaimed?: number\n  }> {\n    return this.strategy.stats()\n  }\n\n  async cleanup(): Promise<number> {\n    if (this.strategy.cleanup) {\n      return this.strategy.cleanup()\n    }\n    return 0\n  }\n\n  async close(): Promise<void> {\n    if (this.strategy.close) {\n      return this.strategy.close()\n    }\n  }\n}\n\nfunction createStrategyForType(strategyType: CacheStrategyName, options?: CacheServiceOptions, defaultTtl?: number, maxEntries?: number): CacheStrategy {\n  switch (strategyType) {\n    case 'redis':\n      return createRedisStrategy(options?.redisUrl, { defaultTtl })\n    case 'sqlite':\n      return createSqliteStrategy(options?.sqlitePath, { defaultTtl })\n    case 'jsonfile':\n      return createJsonFileStrategy(options?.jsonFilePath, { defaultTtl })\n    case 'memory':\n    default:\n      return createMemoryStrategy({ defaultTtl, maxEntries })\n  }\n}\n\nfunction describeDependencyFailure(error: CacheDependencyUnavailableError): string {\n  const originalError = error.originalError\n  if (!(originalError instanceof Error)) {\n    return `missing dependency: ${error.dependency}`\n  }\n\n  const message = originalError.message.trim()\n  if (message.length === 0) {\n    return `missing dependency: ${error.dependency}`\n  }\n\n  if (message.includes('compiled against a different Node.js version') || message.includes('NODE_MODULE_VERSION')) {\n    return `${error.dependency} native module needs rebuild for the current Node.js version`\n  }\n\n  if (message.includes('Cannot find module')) {\n    return `missing dependency: ${error.dependency}`\n  }\n\n  return `${error.dependency} failed to load`\n}\n\nfunction withDependencyFallback(strategy: CacheStrategy, strategyType: CacheStrategyName, defaultTtl?: number, maxEntries?: number): CacheStrategy {\n  if (strategyType === 'memory') return strategy\n\n  let activeStrategy = strategy\n  let fallbackStrategy: CacheStrategy | null = null\n  let warned = false\n\n  const ensureFallback = (error: CacheDependencyUnavailableError) => {\n    if (!fallbackStrategy) {\n      fallbackStrategy = createMemoryStrategy({ defaultTtl, maxEntries })\n    }\n    if (!warned) {\n      const dependencyMessage = error.dependency\n        ? ` (${describeDependencyFailure(error)})`\n        : ''\n      console.warn(`[cache] ${error.strategy} strategy unavailable${dependencyMessage}. Falling back to memory strategy.`)\n      warned = true\n    }\n    activeStrategy = fallbackStrategy\n  }\n\n  const wrapMethod = <K extends keyof CacheStrategy>(method: K): CacheStrategy[K] => {\n    const handler = async (...args: Parameters<NonNullable<CacheStrategy[K]>>) => {\n      const fn = activeStrategy[method] as ((...methodArgs: Parameters<NonNullable<CacheStrategy[K]>>) => ReturnType<NonNullable<CacheStrategy[K]>>) | undefined\n      if (!fn) {\n        return undefined as Awaited<ReturnType<NonNullable<CacheStrategy[K]>>>\n      }\n\n      try {\n        return await fn(...args)\n      } catch (error) {\n        if (error instanceof CacheDependencyUnavailableError) {\n          ensureFallback(error)\n          const fallbackFn = activeStrategy[method] as ((...methodArgs: Parameters<NonNullable<CacheStrategy[K]>>) => ReturnType<NonNullable<CacheStrategy[K]>>) | undefined\n          if (!fallbackFn) {\n            return undefined as Awaited<ReturnType<NonNullable<CacheStrategy[K]>>>\n          }\n          return fallbackFn(...args)\n        }\n        throw error\n      }\n    }\n\n    return handler as CacheStrategy[K]\n  }\n\n  return {\n    get: wrapMethod('get'),\n    set: wrapMethod('set'),\n    has: wrapMethod('has'),\n    delete: wrapMethod('delete'),\n    deleteByTags: wrapMethod('deleteByTags'),\n    clear: wrapMethod('clear'),\n    keys: wrapMethod('keys'),\n    stats: wrapMethod('stats'),\n    healthcheck: typeof strategy.healthcheck === 'function'\n      ? async () => strategy.healthcheck!()\n      : undefined,\n    cleanup: typeof strategy.cleanup === 'function' ? wrapMethod('cleanup') : undefined,\n    close: typeof strategy.close === 'function' ? wrapMethod('close') : undefined,\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { CacheStrategy, CacheServiceOptions, CacheGetOptions, CacheSetOptions, CacheValue } from './types'\nimport { createMemoryStrategy } from './strategies/memory'\nimport { createRedisStrategy } from './strategies/redis'\nimport { createSqliteStrategy } from './strategies/sqlite'\nimport { createJsonFileStrategy } from './strategies/jsonfile'\nimport { getCurrentCacheTenant } from './tenantContext'\nimport { createHash } from 'node:crypto'\nimport { CacheDependencyUnavailableError } from './errors'\nimport { matchCacheKeyPattern } from './patterns'\n\nfunction normalizeTenantKey(raw: string | null | undefined): string {\n  const value = typeof raw === 'string' ? raw.trim() : ''\n  if (!value) return 'global'\n  return value.replace(/[^a-zA-Z0-9._-]/g, '_')\n}\n\ntype TenantPrefixes = {\n  keyPrefix: string\n  tagPrefix: string\n  scopeTag: string\n}\n\ntype CacheMetadata = {\n  key: string\n  expiresAt: number | null\n}\n\nfunction isCacheMetadata(value: CacheValue | null): value is CacheMetadata {\n  if (typeof value !== 'object' || value === null) {\n    return false\n  }\n  const record = value as Record<string, unknown>\n  const hasValidKey = typeof record.key === 'string'\n  const hasValidExpiresAt =\n    !('expiresAt' in record)\n    || record.expiresAt === null\n    || typeof record.expiresAt === 'number'\n\n  return hasValidKey && hasValidExpiresAt\n}\n\ntype CacheStrategyName = NonNullable<CacheServiceOptions['strategy']>\nconst KNOWN_STRATEGIES: CacheStrategyName[] = ['memory', 'redis', 'sqlite', 'jsonfile']\nconst TENANT_META_KEY_PATTERN = 'tenant:*:key:meta:*'\nconst TENANT_META_KEY_MARKER = ':key:meta:'\n\ntype TenantAwareCacheStrategy = CacheStrategy & {\n  deleteByPatternsAcrossScopes(patterns: string[]): Promise<number>\n}\n\nfunction isCacheStrategyName(value: string | undefined): value is CacheStrategyName {\n  if (!value) return false\n  return KNOWN_STRATEGIES.includes(value as CacheStrategyName)\n}\n\nfunction resolveConfiguredStrategyType(options?: CacheServiceOptions): CacheStrategyName {\n  const envStrategy = isCacheStrategyName(process.env.CACHE_STRATEGY)\n    ? process.env.CACHE_STRATEGY\n    : undefined\n  return options?.strategy ?? envStrategy ?? 'memory'\n}\n\nfunction resolveTenantPrefixes(): TenantPrefixes {\n  const tenant = normalizeTenantKey(getCurrentCacheTenant())\n  const base = `tenant:${tenant}:`\n  return {\n    keyPrefix: `${base}key:`,\n    tagPrefix: `${base}tag:`,\n    scopeTag: `${base}tag:__scope__`,\n  }\n}\n\nfunction hashIdentifier(input: string): string {\n  return createHash('sha256').update(input).digest('hex')\n}\n\nfunction storageKey(originalKey: string, prefixes: TenantPrefixes): string {\n  return `${prefixes.keyPrefix}k:${hashIdentifier(originalKey)}`\n}\n\nfunction metaKey(originalKey: string, prefixes: TenantPrefixes): string {\n  return `${prefixes.keyPrefix}meta:${hashIdentifier(originalKey)}`\n}\n\nfunction hashedTag(tag: string, prefixes: TenantPrefixes): string {\n  return `${prefixes.tagPrefix}t:${hashIdentifier(tag)}`\n}\n\nfunction buildTagSet(tags: string[] | undefined, prefixes: TenantPrefixes, includeScope: boolean): string[] {\n  const scoped = new Set<string>()\n  if (includeScope) scoped.add(prefixes.scopeTag)\n  if (Array.isArray(tags)) {\n    for (const tag of tags) {\n      if (typeof tag === 'string' && tag.length > 0) scoped.add(hashedTag(tag, prefixes))\n    }\n  }\n  return Array.from(scoped)\n}\n\nfunction createTenantAwareWrapper(base: CacheStrategy, reportsBoundedCounters: boolean): TenantAwareCacheStrategy {\n  function normalizeDeletionCount(raw: number): number {\n    if (!raw) return raw\n    if (!Number.isFinite(raw)) return raw\n    return Math.ceil(raw / 2)\n  }\n\n  const get = async (key: string, options?: CacheGetOptions) => {\n    const prefixes = resolveTenantPrefixes()\n    return base.get(storageKey(key, prefixes), options)\n  }\n\n  const set = async (key: string, value: CacheValue, options?: CacheSetOptions) => {\n    const prefixes = resolveTenantPrefixes()\n    const hashedTags = buildTagSet(options?.tags, prefixes, true)\n    const ttl = options?.ttl ?? undefined\n    const nextOptions: CacheSetOptions | undefined = options\n      ? { ...options, tags: hashedTags }\n      : { tags: hashedTags }\n    await base.set(storageKey(key, prefixes), value, nextOptions)\n    const metaPayload: CacheMetadata = { key, expiresAt: ttl ? Date.now() + ttl : null }\n    await base.set(metaKey(key, prefixes), metaPayload, {\n      ttl,\n      tags: hashedTags,\n    })\n  }\n\n  const has = async (key: string) => {\n    const prefixes = resolveTenantPrefixes()\n    return base.has(storageKey(key, prefixes))\n  }\n\n  const del = async (key: string) => {\n    const prefixes = resolveTenantPrefixes()\n    const primary = await base.delete(storageKey(key, prefixes))\n    await base.delete(metaKey(key, prefixes))\n    return primary\n  }\n\n  const deleteByTags = async (tags: string[]) => {\n    const prefixes = resolveTenantPrefixes()\n    const scopedTags = buildTagSet(tags, prefixes, false)\n    if (!scopedTags.length) return 0\n    const removed = await base.deleteByTags(scopedTags)\n    return normalizeDeletionCount(removed)\n  }\n\n  const clear = async () => {\n    const prefixes = resolveTenantPrefixes()\n    const removed = await base.deleteByTags([prefixes.scopeTag])\n    return normalizeDeletionCount(removed)\n  }\n\n  const keys = async (pattern?: string) => {\n    const prefixes = resolveTenantPrefixes()\n    const metaPattern = `${prefixes.keyPrefix}meta:*`\n    const metaKeys = await base.keys(metaPattern)\n    const originals: string[] = []\n    for (const metaKey of metaKeys) {\n      const metaValue = await base.get(metaKey, { returnExpired: true })\n      if (!metaValue) continue\n      const metadata = typeof metaValue === 'string' ? null : (isCacheMetadata(metaValue) ? metaValue : null)\n      const original = typeof metaValue === 'string' ? metaValue : metadata?.key\n      if (!original) continue\n      if (pattern && !matchCacheKeyPattern(original, pattern)) continue\n      originals.push(original)\n    }\n    return originals\n  }\n\n  const deleteByPatternsAcrossScopes = async (patterns: string[]) => {\n    const normalizedPatterns = Array.from(new Set(patterns.map((pattern) => pattern.trim()).filter(Boolean)))\n    if (normalizedPatterns.length === 0) return 0\n\n    const metaKeys = await base.keys(TENANT_META_KEY_PATTERN)\n    let deleted = 0\n    for (const metadataKey of metaKeys) {\n      const metadataValue = await base.get(metadataKey, { returnExpired: true })\n      if (!metadataValue) continue\n      const metadata = typeof metadataValue === 'string'\n        ? null\n        : (isCacheMetadata(metadataValue) ? metadataValue : null)\n      const originalKey = typeof metadataValue === 'string' ? metadataValue : metadata?.key\n      if (!originalKey || !normalizedPatterns.some((pattern) => matchCacheKeyPattern(originalKey, pattern))) {\n        continue\n      }\n\n      const markerIndex = metadataKey.lastIndexOf(TENANT_META_KEY_MARKER)\n      if (markerIndex < 0) continue\n      const primaryKey = `${metadataKey.slice(0, markerIndex)}:key:k:${metadataKey.slice(markerIndex + TENANT_META_KEY_MARKER.length)}`\n      if (await base.delete(primaryKey)) deleted += 1\n      await base.delete(metadataKey)\n    }\n    return deleted\n  }\n\n  const stats = async () => {\n    const prefixes = resolveTenantPrefixes()\n    const metaKeys = await base.keys(`${prefixes.keyPrefix}meta:*`)\n    let size = 0\n    let expired = 0\n    const now = Date.now()\n    for (const metaKey of metaKeys) {\n      const metaValue = await base.get(metaKey, { returnExpired: true })\n      if (!metaValue) continue\n      const metadata = typeof metaValue === 'string' ? null : (isCacheMetadata(metaValue) ? metaValue : null)\n      const original = typeof metaValue === 'string' ? metaValue : metadata?.key\n      if (!original) continue\n      size++\n      const expiresAt = metadata?.expiresAt ?? null\n      if (expiresAt !== null && expiresAt <= now) expired++\n    }\n    // size/expired stay tenant-scoped (derived from this tenant's meta keys).\n    // Only memory-backed strategies track the process-global bound counters, so\n    // skip the extra base.stats() round-trip for redis/sqlite/jsonfile and omit\n    // the optional fields (the stats() contract marks them optional). Keyed off\n    // the configured strategy: a backend degraded to the memory fallback\n    // intentionally does not surface these diagnostics.\n    if (!reportsBoundedCounters) {\n      return { size, expired }\n    }\n    const { evictions, sweeps, lastSweepReclaimed } = await base.stats()\n    return { size, expired, evictions, sweeps, lastSweepReclaimed }\n  }\n\n  const cleanup = base.cleanup\n    ? async () => normalizeDeletionCount(await base.cleanup!())\n    : undefined\n\n  const close = base.close\n    ? async () => base.close!()\n    : undefined\n  const healthcheck = base.healthcheck\n    ? async () => base.healthcheck!()\n    : undefined\n\n  return {\n    get,\n    set,\n    has,\n    delete: del,\n    deleteByTags,\n    clear,\n    keys,\n    stats,\n    healthcheck,\n    cleanup,\n    close,\n    deleteByPatternsAcrossScopes,\n  }\n}\n\nfunction createConfiguredTenantAwareStrategy(options?: CacheServiceOptions): TenantAwareCacheStrategy {\n  const strategyType = resolveConfiguredStrategyType(options)\n\n  const envTtl = process.env.CACHE_TTL\n  const parsedEnvTtl = envTtl ? Number.parseInt(envTtl, 10) : undefined\n  const defaultTtl = options?.defaultTtl ?? (typeof parsedEnvTtl === 'number' && Number.isFinite(parsedEnvTtl) ? parsedEnvTtl : undefined)\n\n  const envMaxEntries = process.env.CACHE_MEMORY_MAX_ENTRIES\n  const parsedEnvMaxEntries = envMaxEntries ? Number.parseInt(envMaxEntries, 10) : undefined\n  const maxEntries = options?.maxEntries ?? (typeof parsedEnvMaxEntries === 'number' && Number.isFinite(parsedEnvMaxEntries) ? parsedEnvMaxEntries : undefined)\n\n  const baseStrategy = createStrategyForType(strategyType, options, defaultTtl, maxEntries)\n  const resilientStrategy = withDependencyFallback(baseStrategy, strategyType, defaultTtl, maxEntries)\n  const reportsBoundedCounters = strategyType === 'memory'\n\n  return createTenantAwareWrapper(resilientStrategy, reportsBoundedCounters)\n}\n\n/**\n * Cache service that provides a unified interface to different cache strategies\n *\n * Configuration via environment variables:\n * - CACHE_STRATEGY: 'memory' | 'redis' | 'sqlite' | 'jsonfile' (default: 'memory')\n * - CACHE_TTL: Default TTL in milliseconds (optional)\n * - CACHE_REDIS_URL: Redis connection URL (for redis strategy)\n * - CACHE_SQLITE_PATH: SQLite database file path (for sqlite strategy)\n * - CACHE_JSON_FILE_PATH: JSON file path (for jsonfile strategy)\n *\n * @example\n * const cache = createCacheService({ strategy: 'memory', defaultTtl: 60000 })\n * await cache.set('user:123', { name: 'John' }, { tags: ['users', 'user:123'] })\n * const user = await cache.get('user:123')\n * await cache.deleteByTags(['users']) // Invalidate all user-related cache\n */\nexport function createCacheService(options?: CacheServiceOptions): CacheStrategy {\n  return createConfiguredTenantAwareStrategy(options)\n}\n\n/**\n * Delete matching logical keys across every tenant scope in the configured\n * stock cache backend without bootstrapping application DI or querying the\n * tenant database. Intended for maintenance tasks that already operate on all\n * scopes, such as post-generation structural invalidation.\n */\nexport async function purgeConfiguredCachePatternsAcrossTenantScopes(\n  patterns: string[],\n  options?: CacheServiceOptions,\n): Promise<number> {\n  // A newly-created memory strategy cannot reach the running app's process-local\n  // cache, so constructing one here would only allocate and immediately discard\n  // an empty store. Persistent stock backends remain cross-process maintainable.\n  if (resolveConfiguredStrategyType(options) === 'memory') return 0\n\n  const cache = createConfiguredTenantAwareStrategy(options)\n  try {\n    return await cache.deleteByPatternsAcrossScopes(patterns)\n  } finally {\n    await cache.close?.()\n  }\n}\n\n/**\n * CacheService class wrapper for DI integration\n * Provides the same interface as the functional API but as a class\n */\nexport class CacheService implements CacheStrategy {\n  private strategy: CacheStrategy\n\n  constructor(options?: CacheServiceOptions) {\n    this.strategy = createCacheService(options)\n  }\n\n  async get(key: string, options?: CacheGetOptions): Promise<CacheValue | null> {\n    return this.strategy.get(key, options)\n  }\n\n  async set(key: string, value: CacheValue, options?: CacheSetOptions): Promise<void> {\n    return this.strategy.set(key, value, options)\n  }\n\n  async has(key: string): Promise<boolean> {\n    return this.strategy.has(key)\n  }\n\n  async delete(key: string): Promise<boolean> {\n    return this.strategy.delete(key)\n  }\n\n  async deleteByTags(tags: string[]): Promise<number> {\n    return this.strategy.deleteByTags(tags)\n  }\n\n  async clear(): Promise<number> {\n    return this.strategy.clear()\n  }\n\n  async keys(pattern?: string): Promise<string[]> {\n    return this.strategy.keys(pattern)\n  }\n\n  async stats(): Promise<{\n    size: number\n    expired: number\n    evictions?: number\n    sweeps?: number\n    lastSweepReclaimed?: number\n  }> {\n    return this.strategy.stats()\n  }\n\n  async cleanup(): Promise<number> {\n    if (this.strategy.cleanup) {\n      return this.strategy.cleanup()\n    }\n    return 0\n  }\n\n  async close(): Promise<void> {\n    if (this.strategy.close) {\n      return this.strategy.close()\n    }\n  }\n}\n\nfunction createStrategyForType(strategyType: CacheStrategyName, options?: CacheServiceOptions, defaultTtl?: number, maxEntries?: number): CacheStrategy {\n  switch (strategyType) {\n    case 'redis':\n      return createRedisStrategy(options?.redisUrl, { defaultTtl })\n    case 'sqlite':\n      return createSqliteStrategy(options?.sqlitePath, { defaultTtl })\n    case 'jsonfile':\n      return createJsonFileStrategy(options?.jsonFilePath, { defaultTtl })\n    case 'memory':\n    default:\n      return createMemoryStrategy({ defaultTtl, maxEntries })\n  }\n}\n\nfunction describeDependencyFailure(error: CacheDependencyUnavailableError): string {\n  const originalError = error.originalError\n  if (!(originalError instanceof Error)) {\n    return `missing dependency: ${error.dependency}`\n  }\n\n  const message = originalError.message.trim()\n  if (message.length === 0) {\n    return `missing dependency: ${error.dependency}`\n  }\n\n  if (message.includes('compiled against a different Node.js version') || message.includes('NODE_MODULE_VERSION')) {\n    return `${error.dependency} native module needs rebuild for the current Node.js version`\n  }\n\n  if (message.includes('Cannot find module')) {\n    return `missing dependency: ${error.dependency}`\n  }\n\n  return `${error.dependency} failed to load`\n}\n\nfunction withDependencyFallback(strategy: CacheStrategy, strategyType: CacheStrategyName, defaultTtl?: number, maxEntries?: number): CacheStrategy {\n  if (strategyType === 'memory') return strategy\n\n  let activeStrategy = strategy\n  let fallbackStrategy: CacheStrategy | null = null\n  let warned = false\n\n  const ensureFallback = (error: CacheDependencyUnavailableError) => {\n    if (!fallbackStrategy) {\n      fallbackStrategy = createMemoryStrategy({ defaultTtl, maxEntries })\n    }\n    if (!warned) {\n      const dependencyMessage = error.dependency\n        ? ` (${describeDependencyFailure(error)})`\n        : ''\n      console.warn(`[cache] ${error.strategy} strategy unavailable${dependencyMessage}. Falling back to memory strategy.`)\n      warned = true\n    }\n    activeStrategy = fallbackStrategy\n  }\n\n  const wrapMethod = <K extends keyof CacheStrategy>(method: K): CacheStrategy[K] => {\n    const handler = async (...args: Parameters<NonNullable<CacheStrategy[K]>>) => {\n      const fn = activeStrategy[method] as ((...methodArgs: Parameters<NonNullable<CacheStrategy[K]>>) => ReturnType<NonNullable<CacheStrategy[K]>>) | undefined\n      if (!fn) {\n        return undefined as Awaited<ReturnType<NonNullable<CacheStrategy[K]>>>\n      }\n\n      try {\n        return await fn(...args)\n      } catch (error) {\n        if (error instanceof CacheDependencyUnavailableError) {\n          ensureFallback(error)\n          const fallbackFn = activeStrategy[method] as ((...methodArgs: Parameters<NonNullable<CacheStrategy[K]>>) => ReturnType<NonNullable<CacheStrategy[K]>>) | undefined\n          if (!fallbackFn) {\n            return undefined as Awaited<ReturnType<NonNullable<CacheStrategy[K]>>>\n          }\n          return fallbackFn(...args)\n        }\n        throw error\n      }\n    }\n\n    return handler as CacheStrategy[K]\n  }\n\n  return {\n    get: wrapMethod('get'),\n    set: wrapMethod('set'),\n    has: wrapMethod('has'),\n    delete: wrapMethod('delete'),\n    deleteByTags: wrapMethod('deleteByTags'),\n    clear: wrapMethod('clear'),\n    keys: wrapMethod('keys'),\n    stats: wrapMethod('stats'),\n    healthcheck: typeof strategy.healthcheck === 'function'\n      ? async () => strategy.healthcheck!()\n      : undefined,\n    cleanup: typeof strategy.cleanup === 'function' ? wrapMethod('cleanup') : undefined,\n    close: typeof strategy.close === 'function' ? wrapMethod('close') : undefined,\n  }\n}\n"],
+  "mappings": "AACA,SAAS,4BAA4B;AACrC,SAAS,2BAA2B;AACpC,SAAS,4BAA4B;AACrC,SAAS,8BAA8B;AACvC,SAAS,6BAA6B;AACtC,SAAS,kBAAkB;AAC3B,SAAS,uCAAuC;AAChD,SAAS,4BAA4B;AAErC,SAAS,mBAAmB,KAAwC;AAClE,QAAM,QAAQ,OAAO,QAAQ,WAAW,IAAI,KAAK,IAAI;AACrD,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,MAAM,QAAQ,oBAAoB,GAAG;AAC9C;AAaA,SAAS,gBAAgB,OAAkD;AACzE,MAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,WAAO;AAAA,EACT;AACA,QAAM,SAAS;AACf,QAAM,cAAc,OAAO,OAAO,QAAQ;AAC1C,QAAM,oBACJ,EAAE,eAAe,WACd,OAAO,cAAc,QACrB,OAAO,OAAO,cAAc;AAEjC,SAAO,eAAe;AACxB;AAGA,MAAM,mBAAwC,CAAC,UAAU,SAAS,UAAU,UAAU;AACtF,MAAM,0BAA0B;AAChC,MAAM,yBAAyB;AAM/B,SAAS,oBAAoB,OAAuD;AAClF,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,iBAAiB,SAAS,KAA0B;AAC7D;AAEA,SAAS,8BAA8B,SAAkD;AACvF,QAAM,cAAc,oBAAoB,QAAQ,IAAI,cAAc,IAC9D,QAAQ,IAAI,iBACZ;AACJ,SAAO,SAAS,YAAY,eAAe;AAC7C;AAEA,SAAS,wBAAwC;AAC/C,QAAM,SAAS,mBAAmB,sBAAsB,CAAC;AACzD,QAAM,OAAO,UAAU,MAAM;AAC7B,SAAO;AAAA,IACL,WAAW,GAAG,IAAI;AAAA,IAClB,WAAW,GAAG,IAAI;AAAA,IAClB,UAAU,GAAG,IAAI;AAAA,EACnB;AACF;AAEA,SAAS,eAAe,OAAuB;AAC7C,SAAO,WAAW,QAAQ,EAAE,OAAO,KAAK,EAAE,OAAO,KAAK;AACxD;AAEA,SAAS,WAAW,aAAqB,UAAkC;AACzE,SAAO,GAAG,SAAS,SAAS,KAAK,eAAe,WAAW,CAAC;AAC9D;AAEA,SAAS,QAAQ,aAAqB,UAAkC;AACtE,SAAO,GAAG,SAAS,SAAS,QAAQ,eAAe,WAAW,CAAC;AACjE;AAEA,SAAS,UAAU,KAAa,UAAkC;AAChE,SAAO,GAAG,SAAS,SAAS,KAAK,eAAe,GAAG,CAAC;AACtD;AAEA,SAAS,YAAY,MAA4B,UAA0B,cAAiC;AAC1G,QAAM,SAAS,oBAAI,IAAY;AAC/B,MAAI,aAAc,QAAO,IAAI,SAAS,QAAQ;AAC9C,MAAI,MAAM,QAAQ,IAAI,GAAG;AACvB,eAAW,OAAO,MAAM;AACtB,UAAI,OAAO,QAAQ,YAAY,IAAI,SAAS,EAAG,QAAO,IAAI,UAAU,KAAK,QAAQ,CAAC;AAAA,IACpF;AAAA,EACF;AACA,SAAO,MAAM,KAAK,MAAM;AAC1B;AAEA,SAAS,yBAAyB,MAAqB,wBAA2D;AAChH,WAAS,uBAAuB,KAAqB;AACnD,QAAI,CAAC,IAAK,QAAO;AACjB,QAAI,CAAC,OAAO,SAAS,GAAG,EAAG,QAAO;AAClC,WAAO,KAAK,KAAK,MAAM,CAAC;AAAA,EAC1B;AAEA,QAAM,MAAM,OAAO,KAAa,YAA8B;AAC5D,UAAM,WAAW,sBAAsB;AACvC,WAAO,KAAK,IAAI,WAAW,KAAK,QAAQ,GAAG,OAAO;AAAA,EACpD;AAEA,QAAM,MAAM,OAAO,KAAa,OAAmB,YAA8B;AAC/E,UAAM,WAAW,sBAAsB;AACvC,UAAM,aAAa,YAAY,SAAS,MAAM,UAAU,IAAI;AAC5D,UAAM,MAAM,SAAS,OAAO;AAC5B,UAAM,cAA2C,UAC7C,EAAE,GAAG,SAAS,MAAM,WAAW,IAC/B,EAAE,MAAM,WAAW;AACvB,UAAM,KAAK,IAAI,WAAW,KAAK,QAAQ,GAAG,OAAO,WAAW;AAC5D,UAAM,cAA6B,EAAE,KAAK,WAAW,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK;AACnF,UAAM,KAAK,IAAI,QAAQ,KAAK,QAAQ,GAAG,aAAa;AAAA,MAClD;AAAA,MACA,MAAM;AAAA,IACR,CAAC;AAAA,EACH;AAEA,QAAM,MAAM,OAAO,QAAgB;AACjC,UAAM,WAAW,sBAAsB;AACvC,WAAO,KAAK,IAAI,WAAW,KAAK,QAAQ,CAAC;AAAA,EAC3C;AAEA,QAAM,MAAM,OAAO,QAAgB;AACjC,UAAM,WAAW,sBAAsB;AACvC,UAAM,UAAU,MAAM,KAAK,OAAO,WAAW,KAAK,QAAQ,CAAC;AAC3D,UAAM,KAAK,OAAO,QAAQ,KAAK,QAAQ,CAAC;AACxC,WAAO;AAAA,EACT;AAEA,QAAM,eAAe,OAAO,SAAmB;AAC7C,UAAM,WAAW,sBAAsB;AACvC,UAAM,aAAa,YAAY,MAAM,UAAU,KAAK;AACpD,QAAI,CAAC,WAAW,OAAQ,QAAO;AAC/B,UAAM,UAAU,MAAM,KAAK,aAAa,UAAU;AAClD,WAAO,uBAAuB,OAAO;AAAA,EACvC;AAEA,QAAM,QAAQ,YAAY;AACxB,UAAM,WAAW,sBAAsB;AACvC,UAAM,UAAU,MAAM,KAAK,aAAa,CAAC,SAAS,QAAQ,CAAC;AAC3D,WAAO,uBAAuB,OAAO;AAAA,EACvC;AAEA,QAAM,OAAO,OAAO,YAAqB;AACvC,UAAM,WAAW,sBAAsB;AACvC,UAAM,cAAc,GAAG,SAAS,SAAS;AACzC,UAAM,WAAW,MAAM,KAAK,KAAK,WAAW;AAC5C,UAAM,YAAsB,CAAC;AAC7B,eAAWA,YAAW,UAAU;AAC9B,YAAM,YAAY,MAAM,KAAK,IAAIA,UAAS,EAAE,eAAe,KAAK,CAAC;AACjE,UAAI,CAAC,UAAW;AAChB,YAAM,WAAW,OAAO,cAAc,WAAW,OAAQ,gBAAgB,SAAS,IAAI,YAAY;AAClG,YAAM,WAAW,OAAO,cAAc,WAAW,YAAY,UAAU;AACvE,UAAI,CAAC,SAAU;AACf,UAAI,WAAW,CAAC,qBAAqB,UAAU,OAAO,EAAG;AACzD,gBAAU,KAAK,QAAQ;AAAA,IACzB;AACA,WAAO;AAAA,EACT;AAEA,QAAM,+BAA+B,OAAO,aAAuB;AACjE,UAAM,qBAAqB,MAAM,KAAK,IAAI,IAAI,SAAS,IAAI,CAAC,YAAY,QAAQ,KAAK,CAAC,EAAE,OAAO,OAAO,CAAC,CAAC;AACxG,QAAI,mBAAmB,WAAW,EAAG,QAAO;AAE5C,UAAM,WAAW,MAAM,KAAK,KAAK,uBAAuB;AACxD,QAAI,UAAU;AACd,eAAW,eAAe,UAAU;AAClC,YAAM,gBAAgB,MAAM,KAAK,IAAI,aAAa,EAAE,eAAe,KAAK,CAAC;AACzE,UAAI,CAAC,cAAe;AACpB,YAAM,WAAW,OAAO,kBAAkB,WACtC,OACC,gBAAgB,aAAa,IAAI,gBAAgB;AACtD,YAAM,cAAc,OAAO,kBAAkB,WAAW,gBAAgB,UAAU;AAClF,UAAI,CAAC,eAAe,CAAC,mBAAmB,KAAK,CAAC,YAAY,qBAAqB,aAAa,OAAO,CAAC,GAAG;AACrG;AAAA,MACF;AAEA,YAAM,cAAc,YAAY,YAAY,sBAAsB;AAClE,UAAI,cAAc,EAAG;AACrB,YAAM,aAAa,GAAG,YAAY,MAAM,GAAG,WAAW,CAAC,UAAU,YAAY,MAAM,cAAc,uBAAuB,MAAM,CAAC;AAC/H,UAAI,MAAM,KAAK,OAAO,UAAU,EAAG,YAAW;AAC9C,YAAM,KAAK,OAAO,WAAW;AAAA,IAC/B;AACA,WAAO;AAAA,EACT;AAEA,QAAM,QAAQ,YAAY;AACxB,UAAM,WAAW,sBAAsB;AACvC,UAAM,WAAW,MAAM,KAAK,KAAK,GAAG,SAAS,SAAS,QAAQ;AAC9D,QAAI,OAAO;AACX,QAAI,UAAU;AACd,UAAM,MAAM,KAAK,IAAI;AACrB,eAAWA,YAAW,UAAU;AAC9B,YAAM,YAAY,MAAM,KAAK,IAAIA,UAAS,EAAE,eAAe,KAAK,CAAC;AACjE,UAAI,CAAC,UAAW;AAChB,YAAM,WAAW,OAAO,cAAc,WAAW,OAAQ,gBAAgB,SAAS,IAAI,YAAY;AAClG,YAAM,WAAW,OAAO,cAAc,WAAW,YAAY,UAAU;AACvE,UAAI,CAAC,SAAU;AACf;AACA,YAAM,YAAY,UAAU,aAAa;AACzC,UAAI,cAAc,QAAQ,aAAa,IAAK;AAAA,IAC9C;AAOA,QAAI,CAAC,wBAAwB;AAC3B,aAAO,EAAE,MAAM,QAAQ;AAAA,IACzB;AACA,UAAM,EAAE,WAAW,QAAQ,mBAAmB,IAAI,MAAM,KAAK,MAAM;AACnE,WAAO,EAAE,MAAM,SAAS,WAAW,QAAQ,mBAAmB;AAAA,EAChE;AAEA,QAAM,UAAU,KAAK,UACjB,YAAY,uBAAuB,MAAM,KAAK,QAAS,CAAC,IACxD;AAEJ,QAAM,QAAQ,KAAK,QACf,YAAY,KAAK,MAAO,IACxB;AACJ,QAAM,cAAc,KAAK,cACrB,YAAY,KAAK,YAAa,IAC9B;AAEJ,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAEA,SAAS,oCAAoC,SAAyD;AACpG,QAAM,eAAe,8BAA8B,OAAO;AAE1D,QAAM,SAAS,QAAQ,IAAI;AAC3B,QAAM,eAAe,SAAS,OAAO,SAAS,QAAQ,EAAE,IAAI;AAC5D,QAAM,aAAa,SAAS,eAAe,OAAO,iBAAiB,YAAY,OAAO,SAAS,YAAY,IAAI,eAAe;AAE9H,QAAM,gBAAgB,QAAQ,IAAI;AAClC,QAAM,sBAAsB,gBAAgB,OAAO,SAAS,eAAe,EAAE,IAAI;AACjF,QAAM,aAAa,SAAS,eAAe,OAAO,wBAAwB,YAAY,OAAO,SAAS,mBAAmB,IAAI,sBAAsB;AAEnJ,QAAM,eAAe,sBAAsB,cAAc,SAAS,YAAY,UAAU;AACxF,QAAM,oBAAoB,uBAAuB,cAAc,cAAc,YAAY,UAAU;AACnG,QAAM,yBAAyB,iBAAiB;AAEhD,SAAO,yBAAyB,mBAAmB,sBAAsB;AAC3E;AAkBO,SAAS,mBAAmB,SAA8C;AAC/E,SAAO,oCAAoC,OAAO;AACpD;AAQA,eAAsB,+CACpB,UACA,SACiB;AAIjB,MAAI,8BAA8B,OAAO,MAAM,SAAU,QAAO;AAEhE,QAAM,QAAQ,oCAAoC,OAAO;AACzD,MAAI;AACF,WAAO,MAAM,MAAM,6BAA6B,QAAQ;AAAA,EAC1D,UAAE;AACA,UAAM,MAAM,QAAQ;AAAA,EACtB;AACF;AAMO,MAAM,aAAsC;AAAA,EAGjD,YAAY,SAA+B;AACzC,SAAK,WAAW,mBAAmB,OAAO;AAAA,EAC5C;AAAA,EAEA,MAAM,IAAI,KAAa,SAAuD;AAC5E,WAAO,KAAK,SAAS,IAAI,KAAK,OAAO;AAAA,EACvC;AAAA,EAEA,MAAM,IAAI,KAAa,OAAmB,SAA0C;AAClF,WAAO,KAAK,SAAS,IAAI,KAAK,OAAO,OAAO;AAAA,EAC9C;AAAA,EAEA,MAAM,IAAI,KAA+B;AACvC,WAAO,KAAK,SAAS,IAAI,GAAG;AAAA,EAC9B;AAAA,EAEA,MAAM,OAAO,KAA+B;AAC1C,WAAO,KAAK,SAAS,OAAO,GAAG;AAAA,EACjC;AAAA,EAEA,MAAM,aAAa,MAAiC;AAClD,WAAO,KAAK,SAAS,aAAa,IAAI;AAAA,EACxC;AAAA,EAEA,MAAM,QAAyB;AAC7B,WAAO,KAAK,SAAS,MAAM;AAAA,EAC7B;AAAA,EAEA,MAAM,KAAK,SAAqC;AAC9C,WAAO,KAAK,SAAS,KAAK,OAAO;AAAA,EACnC;AAAA,EAEA,MAAM,QAMH;AACD,WAAO,KAAK,SAAS,MAAM;AAAA,EAC7B;AAAA,EAEA,MAAM,UAA2B;AAC/B,QAAI,KAAK,SAAS,SAAS;AACzB,aAAO,KAAK,SAAS,QAAQ;AAAA,IAC/B;AACA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,QAAuB;AAC3B,QAAI,KAAK,SAAS,OAAO;AACvB,aAAO,KAAK,SAAS,MAAM;AAAA,IAC7B;AAAA,EACF;AACF;AAEA,SAAS,sBAAsB,cAAiC,SAA+B,YAAqB,YAAoC;AACtJ,UAAQ,cAAc;AAAA,IACpB,KAAK;AACH,aAAO,oBAAoB,SAAS,UAAU,EAAE,WAAW,CAAC;AAAA,IAC9D,KAAK;AACH,aAAO,qBAAqB,SAAS,YAAY,EAAE,WAAW,CAAC;AAAA,IACjE,KAAK;AACH,aAAO,uBAAuB,SAAS,cAAc,EAAE,WAAW,CAAC;AAAA,IACrE,KAAK;AAAA,IACL;AACE,aAAO,qBAAqB,EAAE,YAAY,WAAW,CAAC;AAAA,EAC1D;AACF;AAEA,SAAS,0BAA0B,OAAgD;AACjF,QAAM,gBAAgB,MAAM;AAC5B,MAAI,EAAE,yBAAyB,QAAQ;AACrC,WAAO,uBAAuB,MAAM,UAAU;AAAA,EAChD;AAEA,QAAM,UAAU,cAAc,QAAQ,KAAK;AAC3C,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO,uBAAuB,MAAM,UAAU;AAAA,EAChD;AAEA,MAAI,QAAQ,SAAS,8CAA8C,KAAK,QAAQ,SAAS,qBAAqB,GAAG;AAC/G,WAAO,GAAG,MAAM,UAAU;AAAA,EAC5B;AAEA,MAAI,QAAQ,SAAS,oBAAoB,GAAG;AAC1C,WAAO,uBAAuB,MAAM,UAAU;AAAA,EAChD;AAEA,SAAO,GAAG,MAAM,UAAU;AAC5B;AAEA,SAAS,uBAAuB,UAAyB,cAAiC,YAAqB,YAAoC;AACjJ,MAAI,iBAAiB,SAAU,QAAO;AAEtC,MAAI,iBAAiB;AACrB,MAAI,mBAAyC;AAC7C,MAAI,SAAS;AAEb,QAAM,iBAAiB,CAAC,UAA2C;AACjE,QAAI,CAAC,kBAAkB;AACrB,yBAAmB,qBAAqB,EAAE,YAAY,WAAW,CAAC;AAAA,IACpE;AACA,QAAI,CAAC,QAAQ;AACX,YAAM,oBAAoB,MAAM,aAC5B,KAAK,0BAA0B,KAAK,CAAC,MACrC;AACJ,cAAQ,KAAK,WAAW,MAAM,QAAQ,wBAAwB,iBAAiB,oCAAoC;AACnH,eAAS;AAAA,IACX;AACA,qBAAiB;AAAA,EACnB;AAEA,QAAM,aAAa,CAAgC,WAAgC;AACjF,UAAM,UAAU,UAAU,SAAoD;AAC5E,YAAM,KAAK,eAAe,MAAM;AAChC,UAAI,CAAC,IAAI;AACP,eAAO;AAAA,MACT;AAEA,UAAI;AACF,eAAO,MAAM,GAAG,GAAG,IAAI;AAAA,MACzB,SAAS,OAAO;AACd,YAAI,iBAAiB,iCAAiC;AACpD,yBAAe,KAAK;AACpB,gBAAM,aAAa,eAAe,MAAM;AACxC,cAAI,CAAC,YAAY;AACf,mBAAO;AAAA,UACT;AACA,iBAAO,WAAW,GAAG,IAAI;AAAA,QAC3B;AACA,cAAM;AAAA,MACR;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,KAAK,WAAW,KAAK;AAAA,IACrB,KAAK,WAAW,KAAK;AAAA,IACrB,KAAK,WAAW,KAAK;AAAA,IACrB,QAAQ,WAAW,QAAQ;AAAA,IAC3B,cAAc,WAAW,cAAc;AAAA,IACvC,OAAO,WAAW,OAAO;AAAA,IACzB,MAAM,WAAW,MAAM;AAAA,IACvB,OAAO,WAAW,OAAO;AAAA,IACzB,aAAa,OAAO,SAAS,gBAAgB,aACzC,YAAY,SAAS,YAAa,IAClC;AAAA,IACJ,SAAS,OAAO,SAAS,YAAY,aAAa,WAAW,SAAS,IAAI;AAAA,IAC1E,OAAO,OAAO,SAAS,UAAU,aAAa,WAAW,OAAO,IAAI;AAAA,EACtE;AACF;",
   "names": ["metaKey"]
 }

package/dist/strategies/redis.js

@@ -1,6 +1,16 @@
 import { CacheDependencyUnavailableError } from "../errors.js";
 import { getRedisUrlOrThrow } from "@open-mercato/shared/lib/redis/connection";
 import { matchCacheKeyPattern } from "../patterns.js";
+const REAP_ORPHANED_TAG_MEMBERS = `
+local removed = 0
+for i = 2, #KEYS do
+  if redis.call('EXISTS', KEYS[i]) == 0 then
+    removed = removed + redis.call('SREM', KEYS[1], ARGV[i - 1])
+  end
+end
+return removed
+`;
+const REAP_CHUNK_SIZE = 256;
 let redisModulePromise = null;
 const redisRegistry = /* @__PURE__ */ new Map();
 function resolveRequire() {
@@ -221,17 +231,35 @@ function createRedisStrategy(redisUrl, options) {
   const deleteByTags = async (tags) => {
     const client = await getRedisClient();
     const keysToDelete = /* @__PURE__ */ new Set();
+    const membersByTagKey = /* @__PURE__ */ new Map();
     for (const tag of tags) {
       const tagKey = getTagKey(tag);
       const keys2 = await client.smembers(tagKey);
+      membersByTagKey.set(tagKey, keys2);
       for (const key of keys2) {
         keysToDelete.add(key);
       }
     }
     let deleted = 0;
+    const orphans = /* @__PURE__ */ new Set();
     for (const key of keysToDelete) {
       const success = await deleteKey(key);
       if (success) deleted++;
+      else orphans.add(key);
+    }
+    if (orphans.size > 0) {
+      const pipeline = client.pipeline();
+      let queued = 0;
+      for (const [tagKey, members] of membersByTagKey) {
+        const tagOrphans = members.filter((member) => orphans.has(member));
+        for (let offset = 0; offset < tagOrphans.length; offset += REAP_CHUNK_SIZE) {
+          const chunk = tagOrphans.slice(offset, offset + REAP_CHUNK_SIZE);
+          const keys2 = [tagKey, ...chunk.map(getCacheKey)];
+          pipeline.eval(REAP_ORPHANED_TAG_MEMBERS, keys2.length, ...keys2, ...chunk);
+          queued++;
+        }
+      }
+      if (queued > 0) await pipeline.exec();
     }
     return deleted;
   };

package/dist/strategies/redis.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/strategies/redis.ts"],
-  "sourcesContent": ["import type { CacheStrategy, CacheEntry, CacheGetOptions, CacheSetOptions, CacheValue } from '../types'\nimport { CacheDependencyUnavailableError } from '../errors'\nimport { getRedisUrlOrThrow } from '@open-mercato/shared/lib/redis/connection'\nimport { matchCacheKeyPattern } from '../patterns'\n\ntype RedisPipeline = {\n  set(key: string, value: string): RedisPipeline\n  setex(key: string, ttlSeconds: number, value: string): RedisPipeline\n  sadd(key: string, value: string): RedisPipeline\n  srem(key: string, member: string): RedisPipeline\n  del(key: string): RedisPipeline\n  exec(): Promise<unknown>\n}\n\ntype RedisClient = {\n  ping(): Promise<string>\n  get(key: string): Promise<string | null>\n  set(key: string, value: string): Promise<unknown>\n  setex(key: string, ttlSeconds: number, value: string): Promise<unknown>\n  del(key: string): Promise<unknown>\n  exists(key: string): Promise<number>\n  keys(pattern: string): Promise<string[]>\n  smembers(key: string): Promise<string[]>\n  pipeline(): RedisPipeline\n  quit(): Promise<void>\n  once?(event: 'end', listener: () => void): void\n}\n\ntype RedisConstructor = new (url?: string) => RedisClient\ntype PossibleRedisModule = unknown\n\ntype RequireFn = (id: string) => unknown\n\n/**\n * Redis cache strategy with tag support\n * Persistent across process restarts, can be shared across multiple instances\n * \n * Uses Redis data structures:\n * - Hash for storing cache entries: cache:{key} -> {value, tags, expiresAt, createdAt}\n * - Sets for tag index: tag:{tag} -> Set of keys\n */\nlet redisModulePromise: Promise<PossibleRedisModule> | null = null\ntype RedisRegistryEntry = { client?: RedisClient; creating?: Promise<RedisClient>; refs: number }\nconst redisRegistry = new Map<string, RedisRegistryEntry>()\n\nfunction resolveRequire(): RequireFn | null {\n  const nonWebpack = (globalThis as { __non_webpack_require__?: unknown }).__non_webpack_require__\n  if (typeof nonWebpack === 'function') return nonWebpack as RequireFn\n  if (typeof require === 'function') return require as RequireFn\n  if (typeof module !== 'undefined' && typeof module.require === 'function') {\n    return module.require.bind(module)\n  }\n  try {\n    const maybeRequire = Function('return typeof require !== \"undefined\" ? require : undefined')()\n    if (typeof maybeRequire === 'function') return maybeRequire as RequireFn\n  } catch {\n    // ignore\n  }\n  return null\n}\n\nfunction loadRedisModuleViaRequire(): PossibleRedisModule | null {\n  const resolver = resolveRequire()\n  if (!resolver) return null\n  try {\n    return resolver('ioredis') as PossibleRedisModule\n  } catch {\n    return null\n  }\n}\n\nfunction pickRedisConstructor(mod: PossibleRedisModule): RedisConstructor | null {\n  const queue: unknown[] = [mod]\n  const seen = new Set<unknown>()\n  while (queue.length) {\n    const current = queue.shift()\n    if (!current || seen.has(current)) continue\n    seen.add(current)\n    if (typeof current === 'function') return current as RedisConstructor\n    if (typeof current === 'object') {\n      queue.push((current as { default?: unknown }).default)\n      queue.push((current as { Redis?: unknown }).Redis)\n      queue.push((current as { module?: { exports?: unknown } }).module?.exports)\n      queue.push((current as { exports?: unknown }).exports)\n    }\n  }\n  return null\n}\n\nasync function loadRedisModule(): Promise<PossibleRedisModule> {\n  if (!redisModulePromise) {\n    redisModulePromise = (async () => {\n      const required = loadRedisModuleViaRequire() ?? (await import('ioredis'))\n      return required as PossibleRedisModule\n    })().catch((error) => {\n      redisModulePromise = null\n      throw new CacheDependencyUnavailableError('redis', 'ioredis', error)\n    })\n  }\n  return redisModulePromise\n}\n\nfunction retainRedisEntry(key: string): RedisRegistryEntry {\n  let entry = redisRegistry.get(key)\n  if (!entry) {\n    entry = { refs: 0 }\n    redisRegistry.set(key, entry)\n  }\n  entry.refs += 1\n  return entry\n}\n\nasync function acquireRedisClient(key: string, entry: RedisRegistryEntry): Promise<RedisClient> {\n  if (entry.client) return entry.client\n  if (entry.creating) return entry.creating\n  entry.creating = loadRedisModule()\n    .then((mod) => {\n      const ctor = pickRedisConstructor(mod)\n      if (!ctor) {\n        throw new CacheDependencyUnavailableError('redis', 'ioredis', new Error('No usable Redis constructor'))\n      }\n      const client = new ctor(key)\n      entry.client = client\n      entry.creating = undefined\n      client.once?.('end', () => {\n        if (redisRegistry.get(key) === entry && entry.refs === 0) {\n          redisRegistry.delete(key)\n        } else if (redisRegistry.get(key) === entry) {\n          entry.client = undefined\n        }\n      })\n      return client\n    })\n    .catch((error) => {\n      entry.creating = undefined\n      throw error\n    })\n  return entry.creating\n}\n\nasync function releaseRedisEntry(key: string, entry: RedisRegistryEntry): Promise<void> {\n  entry.refs = Math.max(0, entry.refs - 1)\n  if (entry.refs > 0) return\n  redisRegistry.delete(key)\n  if (entry.client) {\n    try {\n      await entry.client.quit()\n    } catch {\n      // ignore shutdown errors\n    } finally {\n      entry.client = undefined\n    }\n  }\n}\n\nexport function createRedisStrategy(redisUrl?: string, options?: { defaultTtl?: number }): CacheStrategy {\n  const defaultTtl = options?.defaultTtl\n  const keyPrefix = 'cache:'\n  const tagPrefix = 'tag:'\n  const connectionUrl = redisUrl || getRedisUrlOrThrow('CACHE')\n  const registryEntry = retainRedisEntry(connectionUrl)\n  let redis: RedisClient | null = registryEntry.client ?? null\n\n  async function getRedisClient(): Promise<RedisClient> {\n    if (redis) return redis\n\n    redis = await acquireRedisClient(connectionUrl, registryEntry)\n    return redis\n  }\n\n  function getCacheKey(key: string): string {\n    return `${keyPrefix}${key}`\n  }\n\n  function getTagKey(tag: string): string {\n    return `${tagPrefix}${tag}`\n  }\n\n  function isExpired(entry: CacheEntry): boolean {\n    if (entry.expiresAt === null) return false\n    return Date.now() > entry.expiresAt\n  }\n\n  const get = async (key: string, options?: CacheGetOptions): Promise<CacheValue | null> => {\n    const client = await getRedisClient()\n    const cacheKey = getCacheKey(key)\n    const data = await client.get(cacheKey)\n\n    if (!data) return null\n\n    try {\n      const entry: CacheEntry = JSON.parse(data)\n\n      if (isExpired(entry)) {\n        if (options?.returnExpired) {\n          return entry.value\n        }\n        // Clean up expired entry\n        await deleteKey(key)\n        return null\n      }\n\n      return entry.value\n    } catch {\n      // Invalid JSON, remove it\n      await client.del(cacheKey)\n      return null\n    }\n  }\n\n  const set = async (key: string, value: CacheValue, options?: CacheSetOptions): Promise<void> => {\n    const client = await getRedisClient()\n    const cacheKey = getCacheKey(key)\n\n    // Remove old entry from tag index if it exists\n    const oldData = await client.get(cacheKey)\n    if (oldData) {\n      try {\n        const oldEntry: CacheEntry = JSON.parse(oldData)\n        // Remove from old tags\n        const pipeline = client.pipeline()\n        for (const tag of oldEntry.tags) {\n          pipeline.srem(getTagKey(tag), key)\n        }\n        await pipeline.exec()\n      } catch {\n        // Ignore parse errors\n      }\n    }\n\n    const ttl = options?.ttl ?? defaultTtl\n    const tags = options?.tags || []\n    const expiresAt = ttl ? Date.now() + ttl : null\n\n    const entry: CacheEntry = {\n      key,\n      value,\n      tags,\n      expiresAt,\n      createdAt: Date.now(),\n    }\n\n    const pipeline = client.pipeline()\n\n    // Store the entry\n    const serialized = JSON.stringify(entry)\n    if (ttl) {\n      pipeline.setex(cacheKey, Math.ceil(ttl / 1000), serialized)\n    } else {\n      pipeline.set(cacheKey, serialized)\n    }\n\n    // Add to tag index\n    for (const tag of tags) {\n      pipeline.sadd(getTagKey(tag), key)\n    }\n\n    await pipeline.exec()\n  }\n\n  const has = async (key: string): Promise<boolean> => {\n    const client = await getRedisClient()\n    const cacheKey = getCacheKey(key)\n    const exists = await client.exists(cacheKey)\n\n    if (!exists) return false\n\n    // Check if expired\n    const data = await client.get(cacheKey)\n    if (!data) return false\n\n    try {\n      const entry: CacheEntry = JSON.parse(data)\n      if (isExpired(entry)) {\n        await deleteKey(key)\n        return false\n      }\n      return true\n    } catch {\n      return false\n    }\n  }\n\n  const deleteKey = async (key: string): Promise<boolean> => {\n    const client = await getRedisClient()\n    const cacheKey = getCacheKey(key)\n\n    // Get entry to remove from tag index\n    const data = await client.get(cacheKey)\n    if (!data) return false\n\n    try {\n      const entry: CacheEntry = JSON.parse(data)\n      const pipeline = client.pipeline()\n\n      // Remove from tag index\n      for (const tag of entry.tags) {\n        pipeline.srem(getTagKey(tag), key)\n      }\n\n      // Delete the cache entry\n      pipeline.del(cacheKey)\n\n      await pipeline.exec()\n      return true\n    } catch {\n      // Just delete the key if we can't parse it\n      await client.del(cacheKey)\n      return true\n    }\n  }\n\n  const deleteByTags = async (tags: string[]): Promise<number> => {\n    const client = await getRedisClient()\n    const keysToDelete = new Set<string>()\n\n    // Collect all keys that have any of the specified tags\n    for (const tag of tags) {\n      const tagKey = getTagKey(tag)\n      const keys = await client.smembers(tagKey)\n      for (const key of keys) {\n        keysToDelete.add(key)\n      }\n    }\n\n    // Delete all collected keys\n    let deleted = 0\n    for (const key of keysToDelete) {\n      const success = await deleteKey(key)\n      if (success) deleted++\n    }\n\n    return deleted\n  }\n\n  const clear = async (): Promise<number> => {\n    const client = await getRedisClient()\n    \n    // Get all cache keys\n    const cacheKeys = await client.keys(`${keyPrefix}*`)\n    const tagKeys = await client.keys(`${tagPrefix}*`)\n\n    if (cacheKeys.length === 0 && tagKeys.length === 0) return 0\n\n    const pipeline = client.pipeline()\n    for (const key of [...cacheKeys, ...tagKeys]) {\n      pipeline.del(key)\n    }\n\n    await pipeline.exec()\n    return cacheKeys.length\n  }\n\n  const keys = async (pattern?: string): Promise<string[]> => {\n    const client = await getRedisClient()\n    const searchPattern = pattern \n      ? `${keyPrefix}${pattern}` \n      : `${keyPrefix}*`\n    \n    const cacheKeys = await client.keys(searchPattern)\n    \n    // Remove prefix from keys\n    const result = cacheKeys.map((key: string) => key.substring(keyPrefix.length))\n    \n    if (!pattern) return result\n    \n    // Apply pattern matching (Redis KEYS command uses glob pattern, but we want our pattern)\n    return result.filter((key: string) => matchCacheKeyPattern(key, pattern))\n  }\n\n  const stats = async (): Promise<{ size: number; expired: number }> => {\n    const client = await getRedisClient()\n    const cacheKeys = await client.keys(`${keyPrefix}*`)\n    \n    let expired = 0\n    for (const cacheKey of cacheKeys) {\n      const data = await client.get(cacheKey)\n      if (data) {\n        try {\n          const entry: CacheEntry = JSON.parse(data)\n          if (isExpired(entry)) {\n            expired++\n          }\n        } catch {\n          // Ignore parse errors\n        }\n      }\n    }\n\n    return { size: cacheKeys.length, expired }\n  }\n\n  const cleanup = async (): Promise<number> => {\n    const client = await getRedisClient()\n    const cacheKeys = await client.keys(`${keyPrefix}*`)\n    \n    let removed = 0\n    for (const cacheKey of cacheKeys) {\n      const data = await client.get(cacheKey)\n      if (data) {\n        try {\n          const entry: CacheEntry = JSON.parse(data)\n          if (isExpired(entry)) {\n            const key = cacheKey.substring(keyPrefix.length)\n            await deleteKey(key)\n            removed++\n          }\n        } catch {\n          // Remove invalid entries\n          await client.del(cacheKey)\n          removed++\n        }\n      }\n    }\n\n    return removed\n  }\n\n  const close = async (): Promise<void> => {\n    await releaseRedisEntry(connectionUrl, registryEntry)\n    redis = null\n  }\n\n  const healthcheck = async (): Promise<void> => {\n    const client = await getRedisClient()\n    await client.ping()\n  }\n\n  return {\n    get,\n    set,\n    has,\n    delete: deleteKey,\n    deleteByTags,\n    clear,\n    keys,\n    stats,\n    healthcheck,\n    cleanup,\n    close,\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { CacheStrategy, CacheEntry, CacheGetOptions, CacheSetOptions, CacheValue } from '../types'\nimport { CacheDependencyUnavailableError } from '../errors'\nimport { getRedisUrlOrThrow } from '@open-mercato/shared/lib/redis/connection'\nimport { matchCacheKeyPattern } from '../patterns'\n\ntype RedisPipeline = {\n  set(key: string, value: string): RedisPipeline\n  setex(key: string, ttlSeconds: number, value: string): RedisPipeline\n  sadd(key: string, value: string): RedisPipeline\n  srem(key: string, member: string): RedisPipeline\n  del(key: string): RedisPipeline\n  eval(script: string, numKeys: number, ...args: (string | number)[]): RedisPipeline\n  exec(): Promise<unknown>\n}\n\ntype RedisClient = {\n  ping(): Promise<string>\n  get(key: string): Promise<string | null>\n  set(key: string, value: string): Promise<unknown>\n  setex(key: string, ttlSeconds: number, value: string): Promise<unknown>\n  del(key: string): Promise<unknown>\n  exists(key: string): Promise<number>\n  keys(pattern: string): Promise<string[]>\n  smembers(key: string): Promise<string[]>\n  pipeline(): RedisPipeline\n  quit(): Promise<void>\n  once?(event: 'end', listener: () => void): void\n}\n\ntype RedisConstructor = new (url?: string) => RedisClient\ntype PossibleRedisModule = unknown\n\ntype RequireFn = (id: string) => unknown\n\n/**\n * Reaps orphaned members from ONE tag set atomically.\n *\n * `KEYS[1]` is the tag key and `KEYS[2..]` are the candidate value keys, with\n * `ARGV[1..]` the member names aligned to them. Every key the script touches is\n * declared in `KEYS` so it stays valid against a slot-aware deployment.\n *\n * The `EXISTS` check and the `SREM` run in one atomic step, which is the whole\n * point: a member may only be dropped while its value key is genuinely absent.\n * A concurrent `set()` either lands first (`EXISTS` is 1, so the member is left\n * alone) or lands after (its own `sadd` re-adds the member). Either ordering\n * leaves a live key indexed.\n *\n * Deliberately single-tag. Pairing every orphan with every requested tag would\n * make the work quadratic in the tag count \u2014 and because a script blocks the\n * server for its whole run, that lands as a stall rather than as throughput.\n * Callers reap per tag using the membership each `smembers` actually returned.\n */\nconst REAP_ORPHANED_TAG_MEMBERS = `\nlocal removed = 0\nfor i = 2, #KEYS do\n  if redis.call('EXISTS', KEYS[i]) == 0 then\n    removed = removed + redis.call('SREM', KEYS[1], ARGV[i - 1])\n  end\nend\nreturn removed\n`\n\n/** Bounds a single script's blocking time on the server, and the request size. */\nconst REAP_CHUNK_SIZE = 256\n\n/**\n * Redis cache strategy with tag support\n * Persistent across process restarts, can be shared across multiple instances\n * \n * Uses Redis data structures:\n * - Hash for storing cache entries: cache:{key} -> {value, tags, expiresAt, createdAt}\n * - Sets for tag index: tag:{tag} -> Set of keys\n */\nlet redisModulePromise: Promise<PossibleRedisModule> | null = null\ntype RedisRegistryEntry = { client?: RedisClient; creating?: Promise<RedisClient>; refs: number }\nconst redisRegistry = new Map<string, RedisRegistryEntry>()\n\nfunction resolveRequire(): RequireFn | null {\n  const nonWebpack = (globalThis as { __non_webpack_require__?: unknown }).__non_webpack_require__\n  if (typeof nonWebpack === 'function') return nonWebpack as RequireFn\n  if (typeof require === 'function') return require as RequireFn\n  if (typeof module !== 'undefined' && typeof module.require === 'function') {\n    return module.require.bind(module)\n  }\n  try {\n    const maybeRequire = Function('return typeof require !== \"undefined\" ? require : undefined')()\n    if (typeof maybeRequire === 'function') return maybeRequire as RequireFn\n  } catch {\n    // ignore\n  }\n  return null\n}\n\nfunction loadRedisModuleViaRequire(): PossibleRedisModule | null {\n  const resolver = resolveRequire()\n  if (!resolver) return null\n  try {\n    return resolver('ioredis') as PossibleRedisModule\n  } catch {\n    return null\n  }\n}\n\nfunction pickRedisConstructor(mod: PossibleRedisModule): RedisConstructor | null {\n  const queue: unknown[] = [mod]\n  const seen = new Set<unknown>()\n  while (queue.length) {\n    const current = queue.shift()\n    if (!current || seen.has(current)) continue\n    seen.add(current)\n    if (typeof current === 'function') return current as RedisConstructor\n    if (typeof current === 'object') {\n      queue.push((current as { default?: unknown }).default)\n      queue.push((current as { Redis?: unknown }).Redis)\n      queue.push((current as { module?: { exports?: unknown } }).module?.exports)\n      queue.push((current as { exports?: unknown }).exports)\n    }\n  }\n  return null\n}\n\nasync function loadRedisModule(): Promise<PossibleRedisModule> {\n  if (!redisModulePromise) {\n    redisModulePromise = (async () => {\n      const required = loadRedisModuleViaRequire() ?? (await import('ioredis'))\n      return required as PossibleRedisModule\n    })().catch((error) => {\n      redisModulePromise = null\n      throw new CacheDependencyUnavailableError('redis', 'ioredis', error)\n    })\n  }\n  return redisModulePromise\n}\n\nfunction retainRedisEntry(key: string): RedisRegistryEntry {\n  let entry = redisRegistry.get(key)\n  if (!entry) {\n    entry = { refs: 0 }\n    redisRegistry.set(key, entry)\n  }\n  entry.refs += 1\n  return entry\n}\n\nasync function acquireRedisClient(key: string, entry: RedisRegistryEntry): Promise<RedisClient> {\n  if (entry.client) return entry.client\n  if (entry.creating) return entry.creating\n  entry.creating = loadRedisModule()\n    .then((mod) => {\n      const ctor = pickRedisConstructor(mod)\n      if (!ctor) {\n        throw new CacheDependencyUnavailableError('redis', 'ioredis', new Error('No usable Redis constructor'))\n      }\n      const client = new ctor(key)\n      entry.client = client\n      entry.creating = undefined\n      client.once?.('end', () => {\n        if (redisRegistry.get(key) === entry && entry.refs === 0) {\n          redisRegistry.delete(key)\n        } else if (redisRegistry.get(key) === entry) {\n          entry.client = undefined\n        }\n      })\n      return client\n    })\n    .catch((error) => {\n      entry.creating = undefined\n      throw error\n    })\n  return entry.creating\n}\n\nasync function releaseRedisEntry(key: string, entry: RedisRegistryEntry): Promise<void> {\n  entry.refs = Math.max(0, entry.refs - 1)\n  if (entry.refs > 0) return\n  redisRegistry.delete(key)\n  if (entry.client) {\n    try {\n      await entry.client.quit()\n    } catch {\n      // ignore shutdown errors\n    } finally {\n      entry.client = undefined\n    }\n  }\n}\n\nexport function createRedisStrategy(redisUrl?: string, options?: { defaultTtl?: number }): CacheStrategy {\n  const defaultTtl = options?.defaultTtl\n  const keyPrefix = 'cache:'\n  const tagPrefix = 'tag:'\n  const connectionUrl = redisUrl || getRedisUrlOrThrow('CACHE')\n  const registryEntry = retainRedisEntry(connectionUrl)\n  let redis: RedisClient | null = registryEntry.client ?? null\n\n  async function getRedisClient(): Promise<RedisClient> {\n    if (redis) return redis\n\n    redis = await acquireRedisClient(connectionUrl, registryEntry)\n    return redis\n  }\n\n  function getCacheKey(key: string): string {\n    return `${keyPrefix}${key}`\n  }\n\n  function getTagKey(tag: string): string {\n    return `${tagPrefix}${tag}`\n  }\n\n  function isExpired(entry: CacheEntry): boolean {\n    if (entry.expiresAt === null) return false\n    return Date.now() > entry.expiresAt\n  }\n\n  const get = async (key: string, options?: CacheGetOptions): Promise<CacheValue | null> => {\n    const client = await getRedisClient()\n    const cacheKey = getCacheKey(key)\n    const data = await client.get(cacheKey)\n\n    if (!data) return null\n\n    try {\n      const entry: CacheEntry = JSON.parse(data)\n\n      if (isExpired(entry)) {\n        if (options?.returnExpired) {\n          return entry.value\n        }\n        // Clean up expired entry\n        await deleteKey(key)\n        return null\n      }\n\n      return entry.value\n    } catch {\n      // Invalid JSON, remove it\n      await client.del(cacheKey)\n      return null\n    }\n  }\n\n  const set = async (key: string, value: CacheValue, options?: CacheSetOptions): Promise<void> => {\n    const client = await getRedisClient()\n    const cacheKey = getCacheKey(key)\n\n    // Remove old entry from tag index if it exists\n    const oldData = await client.get(cacheKey)\n    if (oldData) {\n      try {\n        const oldEntry: CacheEntry = JSON.parse(oldData)\n        // Remove from old tags\n        const pipeline = client.pipeline()\n        for (const tag of oldEntry.tags) {\n          pipeline.srem(getTagKey(tag), key)\n        }\n        await pipeline.exec()\n      } catch {\n        // Ignore parse errors\n      }\n    }\n\n    const ttl = options?.ttl ?? defaultTtl\n    const tags = options?.tags || []\n    const expiresAt = ttl ? Date.now() + ttl : null\n\n    const entry: CacheEntry = {\n      key,\n      value,\n      tags,\n      expiresAt,\n      createdAt: Date.now(),\n    }\n\n    const pipeline = client.pipeline()\n\n    // Store the entry\n    const serialized = JSON.stringify(entry)\n    if (ttl) {\n      pipeline.setex(cacheKey, Math.ceil(ttl / 1000), serialized)\n    } else {\n      pipeline.set(cacheKey, serialized)\n    }\n\n    // Add to tag index\n    for (const tag of tags) {\n      pipeline.sadd(getTagKey(tag), key)\n    }\n\n    await pipeline.exec()\n  }\n\n  const has = async (key: string): Promise<boolean> => {\n    const client = await getRedisClient()\n    const cacheKey = getCacheKey(key)\n    const exists = await client.exists(cacheKey)\n\n    if (!exists) return false\n\n    // Check if expired\n    const data = await client.get(cacheKey)\n    if (!data) return false\n\n    try {\n      const entry: CacheEntry = JSON.parse(data)\n      if (isExpired(entry)) {\n        await deleteKey(key)\n        return false\n      }\n      return true\n    } catch {\n      return false\n    }\n  }\n\n  const deleteKey = async (key: string): Promise<boolean> => {\n    const client = await getRedisClient()\n    const cacheKey = getCacheKey(key)\n\n    // Get entry to remove from tag index\n    const data = await client.get(cacheKey)\n    if (!data) return false\n\n    try {\n      const entry: CacheEntry = JSON.parse(data)\n      const pipeline = client.pipeline()\n\n      // Remove from tag index\n      for (const tag of entry.tags) {\n        pipeline.srem(getTagKey(tag), key)\n      }\n\n      // Delete the cache entry\n      pipeline.del(cacheKey)\n\n      await pipeline.exec()\n      return true\n    } catch {\n      // Just delete the key if we can't parse it\n      await client.del(cacheKey)\n      return true\n    }\n  }\n\n  const deleteByTags = async (tags: string[]): Promise<number> => {\n    const client = await getRedisClient()\n    const keysToDelete = new Set<string>()\n    // Keep which tag each key came from. Reaping needs it to stay linear in the\n    // memberships that actually exist rather than in tags x keys.\n    const membersByTagKey = new Map<string, string[]>()\n\n    // Collect all keys that have any of the specified tags\n    for (const tag of tags) {\n      const tagKey = getTagKey(tag)\n      const keys = await client.smembers(tagKey)\n      membersByTagKey.set(tagKey, keys)\n      for (const key of keys) {\n        keysToDelete.add(key)\n      }\n    }\n\n    // Delete all collected keys\n    let deleted = 0\n    const orphans = new Set<string>()\n    for (const key of keysToDelete) {\n      const success = await deleteKey(key)\n      if (success) deleted++\n      else orphans.add(key)\n    }\n\n    // A key whose value has already expired leaves its name behind in every tag\n    // set it was added to: `set()` only prunes tags when it overwrites a live\n    // key, `deleteKey` only prunes when it finds one, and `cleanup()` scans\n    // value keys rather than tag sets. Nothing else reaps them, so the sets grow\n    // without bound whenever TTL'd entries also rotate their key names \u2014 and\n    // every later invalidation pays a GET per orphan. Reap what we just walked.\n    //\n    // `deleteKey` reported these missing some time ago \u2014 the walk above is one\n    // round trip per member \u2014 so a concurrent request may have rebuilt any of\n    // them since. Re-check each value key atomically with the removal rather\n    // than trusting that stale read: dropping a live key from the index would\n    // silently exempt it from every future invalidation of this tag.\n    //\n    // Reap per tag, over that tag's own members, so the work stays linear in the\n    // memberships `smembers` actually returned. Each script is capped at\n    // REAP_CHUNK_SIZE members, so no single atomic call can stall the server for\n    // longer than a fixed bound however many tags were requested. The calls are\n    // pipelined into one round trip, but stay separate scripts so Redis can\n    // serve other clients between them.\n    if (orphans.size > 0) {\n      const pipeline = client.pipeline()\n      let queued = 0\n      for (const [tagKey, members] of membersByTagKey) {\n        const tagOrphans = members.filter((member) => orphans.has(member))\n        for (let offset = 0; offset < tagOrphans.length; offset += REAP_CHUNK_SIZE) {\n          const chunk = tagOrphans.slice(offset, offset + REAP_CHUNK_SIZE)\n          const keys = [tagKey, ...chunk.map(getCacheKey)]\n          pipeline.eval(REAP_ORPHANED_TAG_MEMBERS, keys.length, ...keys, ...chunk)\n          queued++\n        }\n      }\n      if (queued > 0) await pipeline.exec()\n    }\n\n    return deleted\n  }\n\n  const clear = async (): Promise<number> => {\n    const client = await getRedisClient()\n    \n    // Get all cache keys\n    const cacheKeys = await client.keys(`${keyPrefix}*`)\n    const tagKeys = await client.keys(`${tagPrefix}*`)\n\n    if (cacheKeys.length === 0 && tagKeys.length === 0) return 0\n\n    const pipeline = client.pipeline()\n    for (const key of [...cacheKeys, ...tagKeys]) {\n      pipeline.del(key)\n    }\n\n    await pipeline.exec()\n    return cacheKeys.length\n  }\n\n  const keys = async (pattern?: string): Promise<string[]> => {\n    const client = await getRedisClient()\n    const searchPattern = pattern \n      ? `${keyPrefix}${pattern}` \n      : `${keyPrefix}*`\n    \n    const cacheKeys = await client.keys(searchPattern)\n    \n    // Remove prefix from keys\n    const result = cacheKeys.map((key: string) => key.substring(keyPrefix.length))\n    \n    if (!pattern) return result\n    \n    // Apply pattern matching (Redis KEYS command uses glob pattern, but we want our pattern)\n    return result.filter((key: string) => matchCacheKeyPattern(key, pattern))\n  }\n\n  const stats = async (): Promise<{ size: number; expired: number }> => {\n    const client = await getRedisClient()\n    const cacheKeys = await client.keys(`${keyPrefix}*`)\n    \n    let expired = 0\n    for (const cacheKey of cacheKeys) {\n      const data = await client.get(cacheKey)\n      if (data) {\n        try {\n          const entry: CacheEntry = JSON.parse(data)\n          if (isExpired(entry)) {\n            expired++\n          }\n        } catch {\n          // Ignore parse errors\n        }\n      }\n    }\n\n    return { size: cacheKeys.length, expired }\n  }\n\n  const cleanup = async (): Promise<number> => {\n    const client = await getRedisClient()\n    const cacheKeys = await client.keys(`${keyPrefix}*`)\n    \n    let removed = 0\n    for (const cacheKey of cacheKeys) {\n      const data = await client.get(cacheKey)\n      if (data) {\n        try {\n          const entry: CacheEntry = JSON.parse(data)\n          if (isExpired(entry)) {\n            const key = cacheKey.substring(keyPrefix.length)\n            await deleteKey(key)\n            removed++\n          }\n        } catch {\n          // Remove invalid entries\n          await client.del(cacheKey)\n          removed++\n        }\n      }\n    }\n\n    return removed\n  }\n\n  const close = async (): Promise<void> => {\n    await releaseRedisEntry(connectionUrl, registryEntry)\n    redis = null\n  }\n\n  const healthcheck = async (): Promise<void> => {\n    const client = await getRedisClient()\n    await client.ping()\n  }\n\n  return {\n    get,\n    set,\n    has,\n    delete: deleteKey,\n    deleteByTags,\n    clear,\n    keys,\n    stats,\n    healthcheck,\n    cleanup,\n    close,\n  }\n}\n"],
+  "mappings": "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",
   "names": ["options", "pipeline", "keys"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/cache",
-  "version": "0.6.7",
+  "version": "0.6.8-canary.319.1.5b4be4bc52",
   "license": "MIT",
   "description": "Multi-strategy cache service with tag-based invalidation support",
   "type": "module",
@@ -59,9 +59,9 @@
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",
-    "@types/node": "^26.0.1",
+    "@types/node": "^26.1.2",
     "jest": "^30.4.2",
-    "ts-jest": "^29.4.11",
+    "ts-jest": "^29.4.12",
     "typescript": "7.0.2"
   },
   "publishConfig": {
@@ -71,5 +71,6 @@
     "type": "git",
     "url": "https://github.com/open-mercato/open-mercato",
     "directory": "packages/cache"
-  }
+  },
+  "stableVersion": "0.6.7"
 }

package/src/__tests__/cache-di-contract-docs.test.ts

@@ -0,0 +1,160 @@
+import { readFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+/**
+ * Cache DI-contract documentation audit.
+ *
+ * `packages/cache/AGENTS.md` and `.ai/review-checklist.md` are the two places an agent
+ * looks up how to reach the cache. Both had drifted away from the runtime: they told
+ * readers to resolve a `cacheService` DI token (nothing registers that name — the real
+ * token is `cache`, registered in `packages/core/src/bootstrap.ts`) and to invalidate a
+ * tag with `invalidateTag('customers')` (no such member exists — `CacheStrategy` exposes
+ * `deleteByTags(tags: string[])`). Both snippets throw at runtime, so the docs were
+ * actively producing broken module code.
+ *
+ * This audit re-derives the ground truth from the sources on every run — the registered
+ * token from the bootstrap registration, the callable members from the `CacheStrategy`
+ * type — and fails when either document quotes a token or a method that no longer exists.
+ * Renaming the token or a strategy method therefore breaks this test until the docs are
+ * updated in the same change.
+ */
+
+const repoRoot = join(__dirname, '..', '..', '..', '..')
+const bootstrapPath = join(repoRoot, 'packages', 'core', 'src', 'bootstrap.ts')
+const cacheTypesPath = join(repoRoot, 'packages', 'cache', 'src', 'types.ts')
+const cacheAgentsPath = join(repoRoot, 'packages', 'cache', 'AGENTS.md')
+const reviewChecklistPath = join(repoRoot, '.ai', 'review-checklist.md')
+
+function readSource(path: string): string {
+  return readFileSync(path, 'utf8')
+}
+
+/** The DI token `bootstrap()` registers the cache service under. */
+function registeredCacheToken(): string {
+  const source = readSource(bootstrapPath)
+  const match = source.match(/container\.register\(\{\s*([A-Za-z_$][\w$]*)\s*:\s*asValue\(cache\)\s*\}\)/)
+  if (!match) {
+    throw new Error(
+      '[internal] Could not locate the cache registration in packages/core/src/bootstrap.ts. ' +
+        'Update this audit if the registration shape changed.',
+    )
+  }
+  return match[1]
+}
+
+/** The body of the `CacheStrategy` type declaration. */
+function cacheStrategyBody(): string {
+  const source = readSource(cacheTypesPath)
+  const start = source.indexOf('export type CacheStrategy = {')
+  if (start === -1) throw new Error('[internal] CacheStrategy type not found in packages/cache/src/types.ts')
+  const rest = source.slice(start)
+  const endOffset = rest.search(/^\}/m)
+  if (endOffset === -1) throw new Error('[internal] CacheStrategy type body is not terminated')
+  return rest.slice(0, endOffset)
+}
+
+/** Every callable member of the `CacheStrategy` contract, optional ones included. */
+function cacheStrategyMembers(body: string): Set<string> {
+  const members = new Set<string>()
+  const memberPattern = /^ {2}([A-Za-z_$][\w$]*)\??\(/gm
+  let match = memberPattern.exec(body)
+  while (match) {
+    members.add(match[1])
+    match = memberPattern.exec(body)
+  }
+  return members
+}
+
+/** The member that performs tag-based invalidation — the one taking a `string[]` of tags. */
+function tagInvalidationMember(body: string): string {
+  const match = body.match(/^ {2}([A-Za-z_$][\w$]*)\??\(tags: string\[\]\)/m)
+  if (!match) throw new Error('[internal] CacheStrategy no longer declares a tags: string[] member')
+  return match[1]
+}
+
+/** Every `container.resolve('x')` / `resolve('x')` token quoted by a document. */
+function documentedResolveTokens(markdown: string): string[] {
+  const tokens: string[] = []
+  const pattern = /\bresolve\(\s*['"`]([^'"`]+)['"`]\s*\)/g
+  let match = pattern.exec(markdown)
+  while (match) {
+    tokens.push(match[1])
+    match = pattern.exec(markdown)
+  }
+  return tokens
+}
+
+/** Every method invoked on a cache-shaped identifier inside a document. */
+function documentedCacheMethodCalls(markdown: string): string[] {
+  const calls: string[] = []
+  const pattern = /\b([A-Za-z_$][\w$]*)\.([A-Za-z_$][\w$]*)\(/g
+  let match = pattern.exec(markdown)
+  while (match) {
+    if (/cache/i.test(match[1])) calls.push(match[2])
+    match = pattern.exec(markdown)
+  }
+  return calls
+}
+
+/**
+ * The review checklist documents every subsystem, so only its Cache section is in scope —
+ * other sections legitimately quote other DI tokens.
+ */
+function cacheSectionOf(markdown: string): string {
+  const heading = markdown.match(/^## \d+\. Cache$/m)
+  if (!heading || heading.index === undefined) {
+    throw new Error('[internal] .ai/review-checklist.md no longer has a "## <n>. Cache" section')
+  }
+  const rest = markdown.slice(heading.index + heading[0].length)
+  const nextHeading = rest.search(/^## /m)
+  return nextHeading === -1 ? rest : rest.slice(0, nextHeading)
+}
+
+type AuditedDocument = { file: string; text: string }
+
+function auditedDocuments(): AuditedDocument[] {
+  return [
+    { file: 'packages/cache/AGENTS.md', text: readSource(cacheAgentsPath) },
+    { file: '.ai/review-checklist.md', text: cacheSectionOf(readSource(reviewChecklistPath)) },
+  ]
+}
+
+describe('cache DI contract documentation', () => {
+  const token = registeredCacheToken()
+  const strategyBody = cacheStrategyBody()
+  const members = cacheStrategyMembers(strategyBody)
+  const tagMember = tagInvalidationMember(strategyBody)
+  const documents = auditedDocuments()
+
+  it('derives the ground truth it audits against', () => {
+    expect(token).toBe('cache')
+    const required = ['get', 'set', 'has', 'delete', 'deleteByTags', 'clear', 'keys', 'stats']
+    expect(required.filter((member) => !members.has(member))).toEqual([])
+    expect(members.has('invalidateTag')).toBe(false)
+    expect(tagMember).toBe('deleteByTags')
+  })
+
+  it('every audited document resolves only the registered DI token', () => {
+    for (const { file, text } of documents) {
+      const quoted = documentedResolveTokens(text)
+      expect({ file, quotedCount: quoted.length > 0 }).toEqual({ file, quotedCount: true })
+      for (const quotedToken of quoted) {
+        expect({ file, quotedToken }).toEqual({ file, quotedToken: token })
+      }
+    }
+  })
+
+  it('every audited document only calls methods that exist on CacheStrategy', () => {
+    for (const { file, text } of documents) {
+      for (const method of documentedCacheMethodCalls(text)) {
+        expect({ file, method, exists: members.has(method) }).toEqual({ file, method, exists: true })
+      }
+    }
+  })
+
+  it('every audited document names tag invalidation by its real member', () => {
+    for (const { file, text } of documents) {
+      expect({ file, documented: text.includes(`${tagMember}(`) }).toEqual({ file, documented: true })
+    }
+  })
+})

package/src/__tests__/redis.strategy.test.ts

@@ -0,0 +1,271 @@
+/** @jest-environment node */
+import type { CacheStrategy } from '../types'
+import { createRedisStrategy } from '../strategies/redis'
+
+type PipelineOp = () => void
+
+class FakeRedis {
+  values = new Map<string, string>()
+  sets = new Map<string, Set<string>>()
+  /** Records the shape of each reap script call so tests can assert its cost. */
+  evalCalls: { numKeys: number; memberCount: number }[] = []
+
+  async ping(): Promise<string> {
+    return 'PONG'
+  }
+
+  async get(key: string): Promise<string | null> {
+    return this.values.get(key) ?? null
+  }
+
+  async set(key: string, value: string): Promise<unknown> {
+    this.values.set(key, value)
+    return 'OK'
+  }
+
+  async setex(key: string, _ttlSeconds: number, value: string): Promise<unknown> {
+    this.values.set(key, value)
+    return 'OK'
+  }
+
+  async del(key: string): Promise<unknown> {
+    return this.values.delete(key) ? 1 : 0
+  }
+
+  async exists(key: string): Promise<number> {
+    return this.values.has(key) ? 1 : 0
+  }
+
+  async keys(pattern: string): Promise<string[]> {
+    const prefix = pattern.endsWith('*') ? pattern.slice(0, -1) : pattern
+    return [...this.values.keys()].filter((key) => key.startsWith(prefix))
+  }
+
+  async smembers(key: string): Promise<string[]> {
+    return [...(this.sets.get(key) ?? [])]
+  }
+
+  /**
+   * Mirrors the reap script's KEYS/ARGV contract rather than interpreting Lua —
+   * there is no Lua runtime here, and pulling one in for a single script is not
+   * worth the dependency. What this pins down is the strategy's side of the
+   * contract (key ordering, member alignment, chunking) and the exists-guarded
+   * semantics. The script *body* is not covered; verify it against a real Redis
+   * when changing it.
+   */
+  runEval(_script: string, numKeys: number, ...args: (string | number)[]): number {
+    const [tagKey, ...valueKeys] = args.slice(0, numKeys) as string[]
+    const members = args.slice(numKeys).map(String)
+
+    if (valueKeys.length !== members.length) {
+      throw new Error(`[internal] eval contract: ${valueKeys.length} value keys vs ${members.length} members`)
+    }
+
+    let removed = 0
+    for (const [index, valueKey] of valueKeys.entries()) {
+      if (this.values.has(valueKey)) continue
+      const set = this.sets.get(tagKey)
+      if (!set?.delete(members[index])) continue
+      removed++
+      if (set.size === 0) this.sets.delete(tagKey)
+    }
+    return removed
+  }
+
+  pipeline() {
+    const ops: PipelineOp[] = []
+    const chain = {
+      set: (key: string, value: string) => {
+        ops.push(() => void this.values.set(key, value))
+        return chain
+      },
+      setex: (key: string, _ttlSeconds: number, value: string) => {
+        ops.push(() => void this.values.set(key, value))
+        return chain
+      },
+      sadd: (key: string, member: string) => {
+        ops.push(() => {
+          const members = this.sets.get(key) ?? new Set<string>()
+          members.add(member)
+          this.sets.set(key, members)
+        })
+        return chain
+      },
+      srem: (key: string, member: string) => {
+        ops.push(() => {
+          const members = this.sets.get(key)
+          if (!members) return
+          members.delete(member)
+          // Redis drops a set once its last member is removed.
+          if (members.size === 0) this.sets.delete(key)
+        })
+        return chain
+      },
+      del: (key: string) => {
+        ops.push(() => void this.values.delete(key))
+        return chain
+      },
+      eval: (script: string, numKeys: number, ...args: (string | number)[]) => {
+        this.evalCalls.push({ numKeys, memberCount: args.length - numKeys })
+        ops.push(() => void this.runEval(script, numKeys, ...args))
+        return chain
+      },
+      exec: async () => {
+        for (const op of ops) op()
+        ops.length = 0
+        return []
+      },
+    }
+    return chain
+  }
+
+  async quit(): Promise<void> {}
+
+  /** Simulate a TTL firing: Redis expiry deletes the value key and nothing else. */
+  expire(cacheKey: string): void {
+    this.values.delete(cacheKey)
+  }
+}
+
+let currentRedis: FakeRedis
+
+jest.mock('ioredis', () => ({
+  __esModule: true,
+  default: class {
+    constructor() {
+      return currentRedis as unknown as object
+    }
+  },
+}))
+
+describe('redis strategy tag index', () => {
+  let strategy: CacheStrategy
+  let urlCounter = 0
+
+  beforeEach(() => {
+    currentRedis = new FakeRedis()
+    urlCounter += 1
+    // The client registry is module-global and keyed by URL; keep runs isolated.
+    strategy = createRedisStrategy(`redis://cache-test-${urlCounter}`)
+  })
+
+  afterEach(async () => {
+    await strategy.close?.()
+  })
+
+  it('reaps tag members whose value key already expired', async () => {
+    await strategy.set('nav:sidebar:abc123:pl:user-1', { groups: [] }, { ttl: 60_000, tags: ['rbac:tenant:t1'] })
+    expect(await currentRedis.smembers('tag:rbac:tenant:t1')).toEqual(['nav:sidebar:abc123:pl:user-1'])
+
+    currentRedis.expire('cache:nav:sidebar:abc123:pl:user-1')
+
+    const deleted = await strategy.deleteByTags(['rbac:tenant:t1'])
+
+    expect(deleted).toBe(0)
+    expect(await currentRedis.smembers('tag:rbac:tenant:t1')).toEqual([])
+  })
+
+  it('does not accumulate members when TTL entries rotate their key names', async () => {
+    for (const fingerprint of ['abc123', 'def456', 'ghi789']) {
+      const key = `nav:sidebar:${fingerprint}:pl:user-1`
+      await strategy.set(key, { groups: [] }, { ttl: 60_000, tags: ['rbac:tenant:t1'] })
+      currentRedis.expire(`cache:${key}`)
+      await strategy.deleteByTags(['rbac:tenant:t1'])
+    }
+
+    expect(await currentRedis.smembers('tag:rbac:tenant:t1')).toEqual([])
+  })
+
+  it('leaves live keys in the tag index alone and still reports them deleted', async () => {
+    await strategy.set('live', { value: 1 }, { ttl: 60_000, tags: ['rbac:tenant:t1'] })
+    await strategy.set('expired', { value: 2 }, { ttl: 60_000, tags: ['rbac:tenant:t1'] })
+    currentRedis.expire('cache:expired')
+
+    const deleted = await strategy.deleteByTags(['rbac:tenant:t1'])
+
+    expect(deleted).toBe(1)
+    expect(await currentRedis.smembers('tag:rbac:tenant:t1')).toEqual([])
+    expect(await strategy.get('live')).toBeNull()
+  })
+
+  it('keeps a key indexed when a concurrent write rebuilds it mid-walk', async () => {
+    await strategy.set('nav:user-1', { v: 'old' }, { ttl: 60_000, tags: ['rbac:tenant:t1'] })
+    currentRedis.expire('cache:nav:user-1')
+
+    // deleteByTags walks members one round trip at a time, so an entry it read
+    // as missing can be rebuilt before the reap runs. Land that write in the
+    // window by hooking the GET that reports the key absent.
+    const readValue = currentRedis.get.bind(currentRedis)
+    let rebuilt = false
+    currentRedis.get = async (key: string) => {
+      const result = await readValue(key)
+      if (!rebuilt && key === 'cache:nav:user-1' && result === null) {
+        rebuilt = true
+        await strategy.set('nav:user-1', { v: 'fresh' }, { ttl: 60_000, tags: ['rbac:tenant:t1'] })
+      }
+      return result
+    }
+
+    await strategy.deleteByTags(['rbac:tenant:t1'])
+    currentRedis.get = readValue
+
+    // The rebuilt entry must stay in the index, or it silently outlives every
+    // future invalidation of this tag and serves stale data until its TTL.
+    expect(await currentRedis.smembers('tag:rbac:tenant:t1')).toEqual(['nav:user-1'])
+    expect(await strategy.deleteByTags(['rbac:tenant:t1'])).toBe(1)
+    expect(await strategy.get('nav:user-1')).toBeNull()
+  })
+
+  it('reaps orphans spanning multiple chunks', async () => {
+    const keyCount = 600 // REAP_CHUNK_SIZE is 256, so this spans three chunks.
+    for (let index = 0; index < keyCount; index++) {
+      const key = `bulk-${index}`
+      await strategy.set(key, { index }, { ttl: 60_000, tags: ['rbac:tenant:t1'] })
+      currentRedis.expire(`cache:${key}`)
+    }
+    expect((await currentRedis.smembers('tag:rbac:tenant:t1')).length).toBe(keyCount)
+
+    expect(await strategy.deleteByTags(['rbac:tenant:t1'])).toBe(0)
+    expect(await currentRedis.smembers('tag:rbac:tenant:t1')).toEqual([])
+  })
+
+  it('keeps reap work linear in real memberships across disjoint tags', async () => {
+    const tagCount = 10
+    const perTag = 10
+    for (let tag = 0; tag < tagCount; tag++) {
+      for (let index = 0; index < perTag; index++) {
+        const key = `t${tag}-k${index}`
+        await strategy.set(key, { index }, { ttl: 60_000, tags: [`tag-${tag}`] })
+        currentRedis.expire(`cache:${key}`)
+      }
+    }
+
+    currentRedis.evalCalls = []
+    await strategy.deleteByTags(Array.from({ length: tagCount }, (_, tag) => `tag-${tag}`))
+
+    // Pairing every orphan with every requested tag would make this tagCount
+    // times larger — 1000 removals to clear 100 real memberships.
+    const removals = currentRedis.evalCalls.reduce((total, call) => total + call.memberCount, 0)
+    expect(removals).toBe(tagCount * perTag)
+
+    // No single atomic call may exceed the chunk bound, whatever the tag count.
+    for (const call of currentRedis.evalCalls) {
+      expect(call.memberCount).toBeLessThanOrEqual(256)
+      expect(call.numKeys).toBeLessThanOrEqual(256 + 1)
+    }
+
+    for (let tag = 0; tag < tagCount; tag++) {
+      expect(await currentRedis.smembers(`tag:tag-${tag}`)).toEqual([])
+    }
+  })
+
+  it('only reaps orphans from the tags it was asked to invalidate', async () => {
+    await strategy.set('key-1', { value: 1 }, { ttl: 60_000, tags: ['tag-a', 'tag-b'] })
+    currentRedis.expire('cache:key-1')
+
+    await strategy.deleteByTags(['tag-a'])
+
+    expect(await currentRedis.smembers('tag:tag-a')).toEqual([])
+    expect(await currentRedis.smembers('tag:tag-b')).toEqual(['key-1'])
+  })
+})

package/src/__tests__/service.test.ts

@@ -181,6 +181,33 @@ describe('Cache Service', () => {
       }
     })
 
+    it('uses SHA-256 identifiers for scoped storage keys and tags', async () => {
+      const root = fs.mkdtempSync(path.join(process.cwd(), '.cache-hash-'))
+      const jsonFilePath = path.join(root, 'cache.json')
+      try {
+        const cache = createCacheService({ strategy: 'jsonfile', jsonFilePath })
+        await runWithCacheTenant('tenant-a', async () => {
+          await cache.set('customer:user-123', 'value', { tags: ['customer:user-123'] })
+        })
+        await cache.close?.()
+
+        const storage = JSON.parse(fs.readFileSync(jsonFilePath, 'utf8')) as {
+          entries: Record<string, unknown>
+          tagIndex: Record<string, string[]>
+        }
+        expect(Object.keys(storage.entries)).toHaveLength(2)
+        expect(Object.keys(storage.entries)).toEqual(expect.arrayContaining([
+          expect.stringMatching(/^tenant:tenant-a:key:k:[0-9a-f]{64}$/),
+          expect.stringMatching(/^tenant:tenant-a:key:meta:[0-9a-f]{64}$/),
+        ]))
+        expect(Object.keys(storage.tagIndex)).toEqual(expect.arrayContaining([
+          expect.stringMatching(/^tenant:tenant-a:tag:t:[0-9a-f]{64}$/),
+        ]))
+      } finally {
+        fs.rmSync(root, { recursive: true, force: true })
+      }
+    })
+
     it('should handle concurrent operations', async () => {
       const cache = createCacheService()
       

package/src/service.ts

@@ -71,7 +71,7 @@ function resolveTenantPrefixes(): TenantPrefixes {
 }
 
 function hashIdentifier(input: string): string {
-  return createHash('sha1').update(input).digest('hex')
+  return createHash('sha256').update(input).digest('hex')
 }
 
 function storageKey(originalKey: string, prefixes: TenantPrefixes): string {

package/src/strategies/redis.ts

@@ -9,6 +9,7 @@ type RedisPipeline = {
   sadd(key: string, value: string): RedisPipeline
   srem(key: string, member: string): RedisPipeline
   del(key: string): RedisPipeline
+  eval(script: string, numKeys: number, ...args: (string | number)[]): RedisPipeline
   exec(): Promise<unknown>
 }
 
@@ -31,6 +32,37 @@ type PossibleRedisModule = unknown
 
 type RequireFn = (id: string) => unknown
 
+/**
+ * Reaps orphaned members from ONE tag set atomically.
+ *
+ * `KEYS[1]` is the tag key and `KEYS[2..]` are the candidate value keys, with
+ * `ARGV[1..]` the member names aligned to them. Every key the script touches is
+ * declared in `KEYS` so it stays valid against a slot-aware deployment.
+ *
+ * The `EXISTS` check and the `SREM` run in one atomic step, which is the whole
+ * point: a member may only be dropped while its value key is genuinely absent.
+ * A concurrent `set()` either lands first (`EXISTS` is 1, so the member is left
+ * alone) or lands after (its own `sadd` re-adds the member). Either ordering
+ * leaves a live key indexed.
+ *
+ * Deliberately single-tag. Pairing every orphan with every requested tag would
+ * make the work quadratic in the tag count — and because a script blocks the
+ * server for its whole run, that lands as a stall rather than as throughput.
+ * Callers reap per tag using the membership each `smembers` actually returned.
+ */
+const REAP_ORPHANED_TAG_MEMBERS = `
+local removed = 0
+for i = 2, #KEYS do
+  if redis.call('EXISTS', KEYS[i]) == 0 then
+    removed = removed + redis.call('SREM', KEYS[1], ARGV[i - 1])
+  end
+end
+return removed
+`
+
+/** Bounds a single script's blocking time on the server, and the request size. */
+const REAP_CHUNK_SIZE = 256
+
 /**
  * Redis cache strategy with tag support
  * Persistent across process restarts, can be shared across multiple instances
@@ -313,11 +345,15 @@ export function createRedisStrategy(redisUrl?: string, options?: { defaultTtl?:
   const deleteByTags = async (tags: string[]): Promise<number> => {
     const client = await getRedisClient()
     const keysToDelete = new Set<string>()
+    // Keep which tag each key came from. Reaping needs it to stay linear in the
+    // memberships that actually exist rather than in tags x keys.
+    const membersByTagKey = new Map<string, string[]>()
 
     // Collect all keys that have any of the specified tags
     for (const tag of tags) {
       const tagKey = getTagKey(tag)
       const keys = await client.smembers(tagKey)
+      membersByTagKey.set(tagKey, keys)
       for (const key of keys) {
         keysToDelete.add(key)
       }
@@ -325,9 +361,45 @@ export function createRedisStrategy(redisUrl?: string, options?: { defaultTtl?:
 
     // Delete all collected keys
     let deleted = 0
+    const orphans = new Set<string>()
     for (const key of keysToDelete) {
       const success = await deleteKey(key)
       if (success) deleted++
+      else orphans.add(key)
+    }
+
+    // A key whose value has already expired leaves its name behind in every tag
+    // set it was added to: `set()` only prunes tags when it overwrites a live
+    // key, `deleteKey` only prunes when it finds one, and `cleanup()` scans
+    // value keys rather than tag sets. Nothing else reaps them, so the sets grow
+    // without bound whenever TTL'd entries also rotate their key names — and
+    // every later invalidation pays a GET per orphan. Reap what we just walked.
+    //
+    // `deleteKey` reported these missing some time ago — the walk above is one
+    // round trip per member — so a concurrent request may have rebuilt any of
+    // them since. Re-check each value key atomically with the removal rather
+    // than trusting that stale read: dropping a live key from the index would
+    // silently exempt it from every future invalidation of this tag.
+    //
+    // Reap per tag, over that tag's own members, so the work stays linear in the
+    // memberships `smembers` actually returned. Each script is capped at
+    // REAP_CHUNK_SIZE members, so no single atomic call can stall the server for
+    // longer than a fixed bound however many tags were requested. The calls are
+    // pipelined into one round trip, but stay separate scripts so Redis can
+    // serve other clients between them.
+    if (orphans.size > 0) {
+      const pipeline = client.pipeline()
+      let queued = 0
+      for (const [tagKey, members] of membersByTagKey) {
+        const tagOrphans = members.filter((member) => orphans.has(member))
+        for (let offset = 0; offset < tagOrphans.length; offset += REAP_CHUNK_SIZE) {
+          const chunk = tagOrphans.slice(offset, offset + REAP_CHUNK_SIZE)
+          const keys = [tagKey, ...chunk.map(getCacheKey)]
+          pipeline.eval(REAP_ORPHANED_TAG_MEMBERS, keys.length, ...keys, ...chunk)
+          queued++
+        }
+      }
+      if (queued > 0) await pipeline.exec()
     }
 
     return deleted