layercache 1.2.8 → 1.3.0

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-DBs8Ko5W.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-DBs8Ko5W.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-BXWTKlI1.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-BXWTKlI1.cjs';
 import Redis from 'ioredis';
 import 'node:events';
 
@@ -23,6 +23,7 @@ declare class RedisInvalidationBus implements InvalidationBus {
     private readonly logger?;
     private readonly handlers;
     private sharedListener?;
+    private subscribePromise;
     constructor(options: RedisInvalidationBusOptions);
     subscribe(handler: (message: InvalidationMessage) => Promise<void> | void): Promise<() => Promise<void>>;
     publish(message: InvalidationMessage): Promise<void>;
@@ -202,6 +203,11 @@ interface RedisLayerOptions {
      * Prevents decompression bomb attacks. Defaults to 64 MiB.
      */
     decompressionMaxBytes?: number;
+    /**
+     * Per-command timeout in milliseconds for Redis round-trips.
+     * Slow commands reject so CacheStack can treat the layer as degraded.
+     */
+    commandTimeoutMs?: number;
     disconnectOnDispose?: boolean;
 }
 declare class RedisLayer implements CacheLayer {
@@ -216,6 +222,7 @@ declare class RedisLayer implements CacheLayer {
     private readonly compression?;
     private readonly compressionThreshold;
     private readonly decompressionMaxBytes;
+    private readonly commandTimeoutMs;
     private readonly disconnectOnDispose;
     constructor(options: RedisLayerOptions);
     get<T>(key: string): Promise<T | null>;
@@ -255,6 +262,8 @@ declare class RedisLayer implements CacheLayer {
      */
     private decodePayload;
     private decompressWithLimit;
+    private normalizeCommandTimeoutMs;
+    private runCommand;
 }
 
 interface DiskLayerOptions {
@@ -407,19 +416,23 @@ declare class MsgpackSerializer implements CacheSerializer {
 interface RedisSingleFlightCoordinatorOptions {
     client: Redis;
     prefix?: string;
+    commandTimeoutMs?: number;
 }
 declare class RedisSingleFlightCoordinator implements CacheSingleFlightCoordinator {
     private readonly client;
     private readonly prefix;
+    private readonly commandTimeoutMs;
     constructor(options: RedisSingleFlightCoordinatorOptions);
     execute<T>(key: string, options: CacheSingleFlightExecutionOptions, worker: () => Promise<T>, waiter: () => Promise<T>): Promise<T>;
     private startLeaseRenewal;
+    private normalizeCommandTimeoutMs;
+    private runCommand;
 }
 
 declare class StampedeGuard {
-    private readonly mutexes;
+    private readonly inFlight;
     execute<T>(key: string, task: () => Promise<T>): Promise<T>;
-    private getMutexEntry;
+    private releaseEntry;
 }
 
 /**

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-DBs8Ko5W.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-DBs8Ko5W.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-BXWTKlI1.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-BXWTKlI1.js';
 import Redis from 'ioredis';
 import 'node:events';
 
@@ -23,6 +23,7 @@ declare class RedisInvalidationBus implements InvalidationBus {
     private readonly logger?;
     private readonly handlers;
     private sharedListener?;
+    private subscribePromise;
     constructor(options: RedisInvalidationBusOptions);
     subscribe(handler: (message: InvalidationMessage) => Promise<void> | void): Promise<() => Promise<void>>;
     publish(message: InvalidationMessage): Promise<void>;
@@ -202,6 +203,11 @@ interface RedisLayerOptions {
      * Prevents decompression bomb attacks. Defaults to 64 MiB.
      */
     decompressionMaxBytes?: number;
+    /**
+     * Per-command timeout in milliseconds for Redis round-trips.
+     * Slow commands reject so CacheStack can treat the layer as degraded.
+     */
+    commandTimeoutMs?: number;
     disconnectOnDispose?: boolean;
 }
 declare class RedisLayer implements CacheLayer {
@@ -216,6 +222,7 @@ declare class RedisLayer implements CacheLayer {
     private readonly compression?;
     private readonly compressionThreshold;
     private readonly decompressionMaxBytes;
+    private readonly commandTimeoutMs;
     private readonly disconnectOnDispose;
     constructor(options: RedisLayerOptions);
     get<T>(key: string): Promise<T | null>;
@@ -255,6 +262,8 @@ declare class RedisLayer implements CacheLayer {
      */
     private decodePayload;
     private decompressWithLimit;
+    private normalizeCommandTimeoutMs;
+    private runCommand;
 }
 
 interface DiskLayerOptions {
@@ -407,19 +416,23 @@ declare class MsgpackSerializer implements CacheSerializer {
 interface RedisSingleFlightCoordinatorOptions {
     client: Redis;
     prefix?: string;
+    commandTimeoutMs?: number;
 }
 declare class RedisSingleFlightCoordinator implements CacheSingleFlightCoordinator {
     private readonly client;
     private readonly prefix;
+    private readonly commandTimeoutMs;
     constructor(options: RedisSingleFlightCoordinatorOptions);
     execute<T>(key: string, options: CacheSingleFlightExecutionOptions, worker: () => Promise<T>, waiter: () => Promise<T>): Promise<T>;
     private startLeaseRenewal;
+    private normalizeCommandTimeoutMs;
+    private runCommand;
 }
 
 declare class StampedeGuard {
-    private readonly mutexes;
+    private readonly inFlight;
     execute<T>(key: string, task: () => Promise<T>): Promise<T>;
-    private getMutexEntry;
+    private releaseEntry;
 }
 
 /**