layercache 1.3.2 → 1.3.4

package/dist/cli.js

@@ -1,7 +1,10 @@
 #!/usr/bin/env node
 import {
-  RedisTagIndex
-} from "./chunk-BQLL6IM5.js";
+  RedisTagIndex,
+  validateCacheKey,
+  validatePattern,
+  validateTag
+} from "./chunk-BORDQ3LA.js";
 import {
   isStoredValueEnvelope,
   resolveStoredValue
@@ -46,13 +49,17 @@ async function main(argv = process.argv.slice(2)) {
       throw new Error(`Failed to connect to Redis at ${maskRedisUrl(redisUrl)}: ${message}`);
     });
     if (args.command === "stats") {
-      const keys = await scanKeys(redis, args.pattern ?? "*");
-      process.stdout.write(`${JSON.stringify({ totalKeys: keys.length, pattern: args.pattern ?? "*" }, null, 2)}
+      const pattern = args.pattern ?? "*";
+      if (args.pattern && !validateCliInput(args.pattern, validatePattern)) return;
+      const keys = await scanKeys(redis, pattern);
+      process.stdout.write(`${JSON.stringify({ totalKeys: keys.length, pattern }, null, 2)}
 `);
       return;
     }
     if (args.command === "keys") {
-      const keys = await scanKeys(redis, args.pattern ?? "*");
+      const pattern = args.pattern ?? "*";
+      if (args.pattern && !validateCliInput(args.pattern, validatePattern)) return;
+      const keys = await scanKeys(redis, pattern);
       if (keys.length > 0) {
         process.stdout.write(`${keys.join("\n")}
 `);
@@ -61,6 +68,7 @@ async function main(argv = process.argv.slice(2)) {
     }
     if (args.command === "invalidate") {
       if (args.tag) {
+        if (!validateCliInput(args.tag, validateTag)) return;
         const tagIndex = new RedisTagIndex({ client: redis, prefix: args.tagIndexPrefix ?? "layercache:tag-index" });
         const keys2 = await tagIndex.keysForTag(args.tag);
         if (keys2.length > 0) {
@@ -70,11 +78,18 @@ async function main(argv = process.argv.slice(2)) {
 `);
         return;
       }
-      const keys = await scanKeys(redis, args.pattern ?? "*");
+      const effectivePattern = args.pattern ?? "*";
+      if (args.pattern && !validateCliInput(args.pattern, validatePattern)) return;
+      const keys = await scanKeys(redis, effectivePattern);
+      if (!args.pattern && !args.force && keys.length > 0) {
+        process.stderr.write(`Warning: this operation will invalidate ${keys.length} keys. Use --force to confirm.
+`);
+        return;
+      }
       if (keys.length > 0) {
         await batchDelete(redis, keys);
       }
-      process.stdout.write(`${JSON.stringify({ deletedKeys: keys.length, pattern: args.pattern ?? "*" }, null, 2)}
+      process.stdout.write(`${JSON.stringify({ deletedKeys: keys.length, pattern: effectivePattern }, null, 2)}
 `);
       return;
     }
@@ -82,6 +97,7 @@ async function main(argv = process.argv.slice(2)) {
       if (!args.key) {
         throw new Error("inspect requires --key <key>.");
       }
+      if (!validateCliInput(args.key, validateCacheKey)) return;
       const payload = await redis.getBuffer(args.key);
       const ttl = await redis.ttl(args.key);
       const decoded = decodeInspectablePayload(payload);
@@ -156,6 +172,8 @@ function parseArgs(argv) {
       index += 1;
     } else if (token === "--require-tls") {
       parsed.requireTls = true;
+    } else if (token === "--force") {
+      parsed.force = true;
     }
   }
   return parsed;
@@ -232,6 +250,18 @@ function maskRedisUrl(url) {
     return url.replace(/:([^@/]+)@/, ":***@");
   }
 }
+function validateCliInput(value, validator) {
+  try {
+    validator(value);
+    return true;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`Error: ${message}
+`);
+    process.exitCode = 1;
+    return false;
+  }
+}
 if (process.argv[1]?.endsWith("cli.cjs") || process.argv[1]?.endsWith("cli.js")) {
   void main();
 }

package/dist/{edge-CUHTP9Bc.d.cts → edge-DKkrQ_Ky.d.cts}

@@ -557,8 +557,6 @@ declare class CacheStack extends EventEmitter {
     private readonly invalidation;
     private readonly layerWriter;
     private readonly snapshots;
-    private readonly backgroundRefreshes;
-    private readonly backgroundRefreshAbort;
     private readonly layerDegradedUntil;
     private readonly maintenance;
     private readonly ttlResolver;
@@ -566,6 +564,7 @@ declare class CacheStack extends EventEmitter {
     private nextOperationId;
     private currentGeneration?;
     private isDisconnecting;
+    private readonly reader;
     private disconnectPromise?;
     constructor(layers: CacheLayer[], options?: CacheStackOptions);
     /**
@@ -575,7 +574,6 @@ declare class CacheStack extends EventEmitter {
      * and no `fetcher` is provided.
      */
     get<T>(key: string, fetcher?: () => Promise<T>, options?: CacheGetOptions): Promise<T | null>;
-    private getPrepared;
     /**
      * Alias for `get(key, fetcher, options)` — explicit get-or-set pattern.
      * Fetches and caches the value if not already present.
@@ -652,20 +650,10 @@ declare class CacheStack extends EventEmitter {
     restoreFromFile(filePath: string): Promise<void>;
     disconnect(): Promise<void>;
     private initialize;
-    private fetchWithGuards;
-    private waitForFreshValue;
-    private fetchAndPopulate;
     private storeEntry;
     private writeBatch;
-    private readFromLayers;
-    private readLayerEntry;
-    private backfill;
     private resolveFreshTtl;
     private resolveLayerSeconds;
-    private shouldNegativeCache;
-    private scheduleBackgroundRefresh;
-    private runBackgroundRefresh;
-    private resolveSingleFlightOptions;
     private deleteKeys;
     private publishInvalidation;
     private handleInvalidationMessage;
@@ -689,13 +677,14 @@ declare class CacheStack extends EventEmitter {
     private validateWriteOptions;
     private assertActive;
     private awaitStartup;
+    private readLayerEntry;
+    private scheduleBackgroundRefresh;
     private applyFreshReadPolicies;
     private shouldSkipLayer;
     private handleLayerFailure;
     private reportRecoverableLayerFailure;
     private isGracefulDegradationEnabled;
     private recordCircuitFailure;
-    private isNegativeStoredValue;
     private emitError;
     private snapshotMaxBytes;
     private snapshotMaxEntries;

package/dist/{edge-CUHTP9Bc.d.ts → edge-DKkrQ_Ky.d.ts}

@@ -557,8 +557,6 @@ declare class CacheStack extends EventEmitter {
     private readonly invalidation;
     private readonly layerWriter;
     private readonly snapshots;
-    private readonly backgroundRefreshes;
-    private readonly backgroundRefreshAbort;
     private readonly layerDegradedUntil;
     private readonly maintenance;
     private readonly ttlResolver;
@@ -566,6 +564,7 @@ declare class CacheStack extends EventEmitter {
     private nextOperationId;
     private currentGeneration?;
     private isDisconnecting;
+    private readonly reader;
     private disconnectPromise?;
     constructor(layers: CacheLayer[], options?: CacheStackOptions);
     /**
@@ -575,7 +574,6 @@ declare class CacheStack extends EventEmitter {
      * and no `fetcher` is provided.
      */
     get<T>(key: string, fetcher?: () => Promise<T>, options?: CacheGetOptions): Promise<T | null>;
-    private getPrepared;
     /**
      * Alias for `get(key, fetcher, options)` — explicit get-or-set pattern.
      * Fetches and caches the value if not already present.
@@ -652,20 +650,10 @@ declare class CacheStack extends EventEmitter {
     restoreFromFile(filePath: string): Promise<void>;
     disconnect(): Promise<void>;
     private initialize;
-    private fetchWithGuards;
-    private waitForFreshValue;
-    private fetchAndPopulate;
     private storeEntry;
     private writeBatch;
-    private readFromLayers;
-    private readLayerEntry;
-    private backfill;
     private resolveFreshTtl;
     private resolveLayerSeconds;
-    private shouldNegativeCache;
-    private scheduleBackgroundRefresh;
-    private runBackgroundRefresh;
-    private resolveSingleFlightOptions;
     private deleteKeys;
     private publishInvalidation;
     private handleInvalidationMessage;
@@ -689,13 +677,14 @@ declare class CacheStack extends EventEmitter {
     private validateWriteOptions;
     private assertActive;
     private awaitStartup;
+    private readLayerEntry;
+    private scheduleBackgroundRefresh;
     private applyFreshReadPolicies;
     private shouldSkipLayer;
     private handleLayerFailure;
     private reportRecoverableLayerFailure;
     private isGracefulDegradationEnabled;
     private recordCircuitFailure;
-    private isNegativeStoredValue;
     private emitError;
     private snapshotMaxBytes;
     private snapshotMaxEntries;

package/dist/edge.cjs

@@ -339,7 +339,7 @@ var MAX_PATTERN_RECURSION_DEPTH = 500;
 var TagIndex = class {
   tagToKeys = /* @__PURE__ */ new Map();
   keyToTags = /* @__PURE__ */ new Map();
-  knownKeys = /* @__PURE__ */ new Set();
+  knownKeys = /* @__PURE__ */ new Map();
   maxKnownKeys;
   nextNodeId = 1;
   root = this.createTrieNode();
@@ -427,10 +427,11 @@ var TagIndex = class {
     };
   }
   insertKnownKey(key) {
-    if (this.knownKeys.has(key)) {
+    const isNew = !this.knownKeys.has(key);
+    this.knownKeys.set(key, Date.now());
+    if (!isNew) {
       return;
     }
-    this.knownKeys.add(key);
     let node = this.root;
     for (const character of key) {
       let child = node.children.get(character);
@@ -525,14 +526,13 @@ var TagIndex = class {
     if (this.maxKnownKeys === void 0 || this.knownKeys.size <= this.maxKnownKeys) {
       return;
     }
+    const sorted = [...this.knownKeys.entries()].sort((a, b) => a[1] - b[1]);
     const toRemove = Math.ceil(this.maxKnownKeys * 0.1);
-    let removed = 0;
-    for (const key of this.knownKeys) {
-      if (removed >= toRemove) {
-        break;
+    for (let i = 0; i < toRemove && i < sorted.length; i += 1) {
+      const entry = sorted[i];
+      if (entry) {
+        this.removeKey(entry[0]);
       }
-      this.removeKey(key);
-      removed += 1;
     }
   }
   removeKey(key) {

package/dist/edge.d.cts

@@ -1,2 +1,2 @@
-export { e as CacheGetOptions, f as CacheLayer, h as CacheLayerSetManyEntry, t as CacheMetricsSnapshot, w as CacheRateLimitOptions, B as CacheTtlPolicy, D as CacheTtlPolicyContext, J as CacheWriteOptions, K as EvictionPolicy, M as MemoryLayer, N as MemoryLayerOptions, O as MemoryLayerSnapshotEntry, P as PatternMatcher, T as TagIndex, Q as createHonoCacheMiddleware } from './edge-CUHTP9Bc.cjs';
+export { e as CacheGetOptions, f as CacheLayer, h as CacheLayerSetManyEntry, t as CacheMetricsSnapshot, w as CacheRateLimitOptions, B as CacheTtlPolicy, D as CacheTtlPolicyContext, J as CacheWriteOptions, K as EvictionPolicy, M as MemoryLayer, N as MemoryLayerOptions, O as MemoryLayerSnapshotEntry, P as PatternMatcher, T as TagIndex, Q as createHonoCacheMiddleware } from './edge-DKkrQ_Ky.cjs';
 import 'node:events';

package/dist/edge.d.ts

@@ -1,2 +1,2 @@
-export { e as CacheGetOptions, f as CacheLayer, h as CacheLayerSetManyEntry, t as CacheMetricsSnapshot, w as CacheRateLimitOptions, B as CacheTtlPolicy, D as CacheTtlPolicyContext, J as CacheWriteOptions, K as EvictionPolicy, M as MemoryLayer, N as MemoryLayerOptions, O as MemoryLayerSnapshotEntry, P as PatternMatcher, T as TagIndex, Q as createHonoCacheMiddleware } from './edge-CUHTP9Bc.js';
+export { e as CacheGetOptions, f as CacheLayer, h as CacheLayerSetManyEntry, t as CacheMetricsSnapshot, w as CacheRateLimitOptions, B as CacheTtlPolicy, D as CacheTtlPolicyContext, J as CacheWriteOptions, K as EvictionPolicy, M as MemoryLayer, N as MemoryLayerOptions, O as MemoryLayerSnapshotEntry, P as PatternMatcher, T as TagIndex, Q as createHonoCacheMiddleware } from './edge-DKkrQ_Ky.js';
 import 'node:events';

package/dist/edge.js

@@ -2,7 +2,7 @@ import {
   MemoryLayer,
   TagIndex,
   createHonoCacheMiddleware
-} from "./chunk-GJBKCFE6.js";
+} from "./chunk-5RCAX2BQ.js";
 import {
   PatternMatcher
 } from "./chunk-4PPBOOXT.js";