layercache 1.2.1 → 1.2.3

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { I as InvalidationBus, C as CacheLogger, a as InvalidationMessage, b as CacheTagIndex, c as CacheStack, d as CacheWrapOptions, e as CacheGetOptions, f as CacheLayer, g as CacheSerializer, h as CacheLayerSetManyEntry, i as CacheSingleFlightCoordinator, j as CacheSingleFlightExecutionOptions } from './edge-C1sBhTfv.cjs';
-export { k as CacheAdaptiveTtlOptions, l as CacheCircuitBreakerOptions, m as CacheDegradationOptions, n as CacheHealthCheckResult, o as CacheHitRateSnapshot, p as CacheInspectResult, q as CacheLayerLatency, r as CacheMGetEntry, s as CacheMSetEntry, t as CacheMetricsSnapshot, u as CacheMissError, v as CacheNamespace, w as CacheRateLimitOptions, x as CacheSnapshotEntry, y as CacheStackEvents, z as CacheStackOptions, A as CacheStatsSnapshot, B as CacheTtlPolicy, D as CacheTtlPolicyContext, E as CacheWarmEntry, F as CacheWarmOptions, G as CacheWarmProgress, H as CacheWriteBehindOptions, J as CacheWriteOptions, K as EvictionPolicy, L as LayerTtlMap, M as MemoryLayer, N as MemoryLayerOptions, O as MemoryLayerSnapshotEntry, P as PatternMatcher, T as TagIndex, Q as createHonoCacheMiddleware } from './edge-C1sBhTfv.cjs';
+import { I as InvalidationBus, C as CacheLogger, a as InvalidationMessage, b as CacheTagIndex, c as CacheStack, d as CacheWrapOptions, e as CacheGetOptions, f as CacheLayer, g as CacheSerializer, h as CacheLayerSetManyEntry, i as CacheSingleFlightCoordinator, j as CacheSingleFlightExecutionOptions } from './edge-B_rUqDy6.cjs';
+export { k as CacheAdaptiveTtlOptions, l as CacheCircuitBreakerOptions, m as CacheDegradationOptions, n as CacheHealthCheckResult, o as CacheHitRateSnapshot, p as CacheInspectResult, q as CacheLayerLatency, r as CacheMGetEntry, s as CacheMSetEntry, t as CacheMetricsSnapshot, u as CacheMissError, v as CacheNamespace, w as CacheRateLimitOptions, x as CacheSnapshotEntry, y as CacheStackEvents, z as CacheStackOptions, A as CacheStatsSnapshot, B as CacheTtlPolicy, D as CacheTtlPolicyContext, E as CacheWarmEntry, F as CacheWarmOptions, G as CacheWarmProgress, H as CacheWriteBehindOptions, J as CacheWriteOptions, K as EvictionPolicy, L as LayerTtlMap, M as MemoryLayer, N as MemoryLayerOptions, O as MemoryLayerSnapshotEntry, P as PatternMatcher, T as TagIndex, Q as createHonoCacheMiddleware } from './edge-B_rUqDy6.cjs';
 import Redis from 'ioredis';
 import 'node:events';
 
@@ -35,11 +35,13 @@ interface RedisTagIndexOptions {
     client: Redis;
     prefix?: string;
     scanCount?: number;
+    knownKeysShards?: number;
 }
 declare class RedisTagIndex implements CacheTagIndex {
     private readonly client;
     private readonly prefix;
     private readonly scanCount;
+    private readonly knownKeysShards;
     constructor(options: RedisTagIndexOptions);
     touch(key: string): Promise<void>;
     track(key: string, tags: string[]): Promise<void>;
@@ -50,7 +52,8 @@ declare class RedisTagIndex implements CacheTagIndex {
     matchPattern(pattern: string): Promise<string[]>;
     clear(): Promise<void>;
     private scanIndexKeys;
-    private knownKeysKey;
+    private knownKeysKeyFor;
+    private knownKeysKeys;
     private keyTagsKey;
     private tagKeysKey;
 }
@@ -173,6 +176,11 @@ interface RedisLayerOptions {
     scanCount?: number;
     compression?: CompressionAlgorithm;
     compressionThreshold?: number;
+    /**
+     * Maximum number of bytes allowed after decompression.
+     * Prevents decompression bomb attacks. Defaults to 64 MiB.
+     */
+    decompressionMaxBytes?: number;
     disconnectOnDispose?: boolean;
 }
 declare class RedisLayer implements CacheLayer {
@@ -186,6 +194,7 @@ declare class RedisLayer implements CacheLayer {
     private readonly scanCount;
     private readonly compression?;
     private readonly compressionThreshold;
+    private readonly decompressionMaxBytes;
     private readonly disconnectOnDispose;
     constructor(options: RedisLayerOptions);
     get<T>(key: string): Promise<T | null>;
@@ -219,6 +228,7 @@ declare class RedisLayer implements CacheLayer {
     private encodePayload;
     /**
      * Decompresses the payload asynchronously if a compression header is present.
+     * Enforces a maximum decompressed size to prevent decompression bomb attacks.
      */
     private decodePayload;
 }
@@ -274,6 +284,9 @@ declare class DiskLayer implements CacheLayer {
     ping(): Promise<boolean>;
     dispose(): Promise<void>;
     private keyToPath;
+    private resolveDirectory;
+    private normalizeMaxFiles;
+    private deserializeEntry;
     private safeDelete;
     private enqueueWrite;
     /**
@@ -341,6 +354,7 @@ declare class MemcachedLayer implements CacheLayer {
     deleteMany(keys: string[]): Promise<void>;
     clear(): Promise<void>;
     private withPrefix;
+    private validateKey;
 }
 
 declare class JsonSerializer implements CacheSerializer {
@@ -362,6 +376,7 @@ declare class RedisSingleFlightCoordinator implements CacheSingleFlightCoordinat
     private readonly prefix;
     constructor(options: RedisSingleFlightCoordinatorOptions);
     execute<T>(key: string, options: CacheSingleFlightExecutionOptions, worker: () => Promise<T>, waiter: () => Promise<T>): Promise<T>;
+    private startLeaseRenewal;
 }
 
 declare class StampedeGuard {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { I as InvalidationBus, C as CacheLogger, a as InvalidationMessage, b as CacheTagIndex, c as CacheStack, d as CacheWrapOptions, e as CacheGetOptions, f as CacheLayer, g as CacheSerializer, h as CacheLayerSetManyEntry, i as CacheSingleFlightCoordinator, j as CacheSingleFlightExecutionOptions } from './edge-C1sBhTfv.js';
-export { k as CacheAdaptiveTtlOptions, l as CacheCircuitBreakerOptions, m as CacheDegradationOptions, n as CacheHealthCheckResult, o as CacheHitRateSnapshot, p as CacheInspectResult, q as CacheLayerLatency, r as CacheMGetEntry, s as CacheMSetEntry, t as CacheMetricsSnapshot, u as CacheMissError, v as CacheNamespace, w as CacheRateLimitOptions, x as CacheSnapshotEntry, y as CacheStackEvents, z as CacheStackOptions, A as CacheStatsSnapshot, B as CacheTtlPolicy, D as CacheTtlPolicyContext, E as CacheWarmEntry, F as CacheWarmOptions, G as CacheWarmProgress, H as CacheWriteBehindOptions, J as CacheWriteOptions, K as EvictionPolicy, L as LayerTtlMap, M as MemoryLayer, N as MemoryLayerOptions, O as MemoryLayerSnapshotEntry, P as PatternMatcher, T as TagIndex, Q as createHonoCacheMiddleware } from './edge-C1sBhTfv.js';
+import { I as InvalidationBus, C as CacheLogger, a as InvalidationMessage, b as CacheTagIndex, c as CacheStack, d as CacheWrapOptions, e as CacheGetOptions, f as CacheLayer, g as CacheSerializer, h as CacheLayerSetManyEntry, i as CacheSingleFlightCoordinator, j as CacheSingleFlightExecutionOptions } from './edge-B_rUqDy6.js';
+export { k as CacheAdaptiveTtlOptions, l as CacheCircuitBreakerOptions, m as CacheDegradationOptions, n as CacheHealthCheckResult, o as CacheHitRateSnapshot, p as CacheInspectResult, q as CacheLayerLatency, r as CacheMGetEntry, s as CacheMSetEntry, t as CacheMetricsSnapshot, u as CacheMissError, v as CacheNamespace, w as CacheRateLimitOptions, x as CacheSnapshotEntry, y as CacheStackEvents, z as CacheStackOptions, A as CacheStatsSnapshot, B as CacheTtlPolicy, D as CacheTtlPolicyContext, E as CacheWarmEntry, F as CacheWarmOptions, G as CacheWarmProgress, H as CacheWriteBehindOptions, J as CacheWriteOptions, K as EvictionPolicy, L as LayerTtlMap, M as MemoryLayer, N as MemoryLayerOptions, O as MemoryLayerSnapshotEntry, P as PatternMatcher, T as TagIndex, Q as createHonoCacheMiddleware } from './edge-B_rUqDy6.js';
 import Redis from 'ioredis';
 import 'node:events';
 
@@ -35,11 +35,13 @@ interface RedisTagIndexOptions {
     client: Redis;
     prefix?: string;
     scanCount?: number;
+    knownKeysShards?: number;
 }
 declare class RedisTagIndex implements CacheTagIndex {
     private readonly client;
     private readonly prefix;
     private readonly scanCount;
+    private readonly knownKeysShards;
     constructor(options: RedisTagIndexOptions);
     touch(key: string): Promise<void>;
     track(key: string, tags: string[]): Promise<void>;
@@ -50,7 +52,8 @@ declare class RedisTagIndex implements CacheTagIndex {
     matchPattern(pattern: string): Promise<string[]>;
     clear(): Promise<void>;
     private scanIndexKeys;
-    private knownKeysKey;
+    private knownKeysKeyFor;
+    private knownKeysKeys;
     private keyTagsKey;
     private tagKeysKey;
 }
@@ -173,6 +176,11 @@ interface RedisLayerOptions {
     scanCount?: number;
     compression?: CompressionAlgorithm;
     compressionThreshold?: number;
+    /**
+     * Maximum number of bytes allowed after decompression.
+     * Prevents decompression bomb attacks. Defaults to 64 MiB.
+     */
+    decompressionMaxBytes?: number;
     disconnectOnDispose?: boolean;
 }
 declare class RedisLayer implements CacheLayer {
@@ -186,6 +194,7 @@ declare class RedisLayer implements CacheLayer {
     private readonly scanCount;
     private readonly compression?;
     private readonly compressionThreshold;
+    private readonly decompressionMaxBytes;
     private readonly disconnectOnDispose;
     constructor(options: RedisLayerOptions);
     get<T>(key: string): Promise<T | null>;
@@ -219,6 +228,7 @@ declare class RedisLayer implements CacheLayer {
     private encodePayload;
     /**
      * Decompresses the payload asynchronously if a compression header is present.
+     * Enforces a maximum decompressed size to prevent decompression bomb attacks.
      */
     private decodePayload;
 }
@@ -274,6 +284,9 @@ declare class DiskLayer implements CacheLayer {
     ping(): Promise<boolean>;
     dispose(): Promise<void>;
     private keyToPath;
+    private resolveDirectory;
+    private normalizeMaxFiles;
+    private deserializeEntry;
     private safeDelete;
     private enqueueWrite;
     /**
@@ -341,6 +354,7 @@ declare class MemcachedLayer implements CacheLayer {
     deleteMany(keys: string[]): Promise<void>;
     clear(): Promise<void>;
     private withPrefix;
+    private validateKey;
 }
 
 declare class JsonSerializer implements CacheSerializer {
@@ -362,6 +376,7 @@ declare class RedisSingleFlightCoordinator implements CacheSingleFlightCoordinat
     private readonly prefix;
     constructor(options: RedisSingleFlightCoordinatorOptions);
     execute<T>(key: string, options: CacheSingleFlightExecutionOptions, worker: () => Promise<T>, waiter: () => Promise<T>): Promise<T>;
+    private startLeaseRenewal;
 }
 
 declare class StampedeGuard {