layercache 1.2.2 → 1.2.4

package/packages/nestjs/dist/index.d.cts

@@ -168,6 +168,7 @@ interface CacheStackOptions {
     invalidationBus?: InvalidationBus;
     tagIndex?: CacheTagIndex;
     generation?: number;
+    generationCleanup?: boolean | CacheGenerationCleanupOptions;
     broadcastL1Invalidation?: boolean;
     /**
      * @deprecated Use `broadcastL1Invalidation` instead.
@@ -186,11 +187,13 @@ interface CacheStackOptions {
     writeStrategy?: 'write-through' | 'write-behind';
     writeBehind?: CacheWriteBehindOptions;
     fetcherRateLimit?: CacheRateLimitOptions;
+    backgroundRefreshTimeoutMs?: number;
     singleFlightCoordinator?: CacheSingleFlightCoordinator;
     singleFlightLeaseMs?: number;
     singleFlightTimeoutMs?: number;
     singleFlightPollMs?: number;
     singleFlightRenewIntervalMs?: number;
+    snapshotBaseDir?: string | false;
     /**
      * Maximum number of entries in `accessProfiles` and `circuitBreakers` maps
      * before the oldest entries are pruned. Prevents unbounded memory growth.
@@ -203,6 +206,9 @@ interface CacheAdaptiveTtlOptions {
     step?: number | LayerTtlMap;
     maxTtl?: number | LayerTtlMap;
 }
+interface CacheGenerationCleanupOptions {
+    batchSize?: number;
+}
 type CacheTtlPolicy = 'until-midnight' | 'next-hour' | {
     alignTo: number;
 } | ((context: CacheTtlPolicyContext) => number | undefined);
@@ -404,7 +410,9 @@ declare class CacheStack extends EventEmitter {
     private unsubscribeInvalidation?;
     private readonly logger;
     private readonly tagIndex;
+    private readonly keyDiscovery;
     private readonly fetchRateLimiter;
+    private readonly snapshotSerializer;
     private readonly backgroundRefreshes;
     private readonly layerDegradedUntil;
     private readonly ttlResolver;
@@ -413,6 +421,7 @@ declare class CacheStack extends EventEmitter {
     private readonly writeBehindQueue;
     private writeBehindTimer?;
     private writeBehindFlushPromise?;
+    private generationCleanupPromise?;
     private isDisconnecting;
     private disconnectPromise?;
     constructor(layers: CacheLayer[], options?: CacheStackOptions);
@@ -423,6 +432,7 @@ 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.
@@ -481,6 +491,11 @@ declare class CacheStack extends EventEmitter {
      */
     getHitRate(): CacheHitRateSnapshot;
     healthCheck(): Promise<CacheHealthCheckResult[]>;
+    /**
+     * Rotates the active generation prefix used for all future cache keys.
+     * Previous-generation keys remain in the underlying layers until they expire,
+     * unless `generationCleanup` is enabled to prune them in the background.
+     */
     bumpGeneration(nextGeneration?: number): number;
     /**
      * Returns detailed metadata about a single cache key: which layers contain it,
@@ -508,6 +523,7 @@ declare class CacheStack extends EventEmitter {
     private resolveLayerSeconds;
     private shouldNegativeCache;
     private scheduleBackgroundRefresh;
+    private runBackgroundRefresh;
     private resolveSingleFlightOptions;
     private deleteKeys;
     private publishInvalidation;
@@ -515,7 +531,12 @@ declare class CacheStack extends EventEmitter {
     private getTagsForKey;
     private formatError;
     private sleep;
+    private withTimeout;
     private shouldBroadcastL1Invalidation;
+    private shouldCleanupGenerations;
+    private generationCleanupBatchSize;
+    private scheduleGenerationCleanup;
+    private cleanupGeneration;
     private initializeWriteBehind;
     private shouldWriteBehind;
     private enqueueWriteBehind;
@@ -543,12 +564,15 @@ declare class CacheStack extends EventEmitter {
     private applyFreshReadPolicies;
     private shouldSkipLayer;
     private handleLayerFailure;
+    private reportRecoverableLayerFailure;
     private isGracefulDegradationEnabled;
     private recordCircuitFailure;
     private isNegativeStoredValue;
     private emitError;
     private serializeKeyPart;
     private isCacheSnapshotEntries;
+    private sanitizeSnapshotValue;
+    private validateSnapshotFilePath;
     private normalizeForSerialization;
 }
 

package/packages/nestjs/dist/index.d.ts

@@ -168,6 +168,7 @@ interface CacheStackOptions {
     invalidationBus?: InvalidationBus;
     tagIndex?: CacheTagIndex;
     generation?: number;
+    generationCleanup?: boolean | CacheGenerationCleanupOptions;
     broadcastL1Invalidation?: boolean;
     /**
      * @deprecated Use `broadcastL1Invalidation` instead.
@@ -186,11 +187,13 @@ interface CacheStackOptions {
     writeStrategy?: 'write-through' | 'write-behind';
     writeBehind?: CacheWriteBehindOptions;
     fetcherRateLimit?: CacheRateLimitOptions;
+    backgroundRefreshTimeoutMs?: number;
     singleFlightCoordinator?: CacheSingleFlightCoordinator;
     singleFlightLeaseMs?: number;
     singleFlightTimeoutMs?: number;
     singleFlightPollMs?: number;
     singleFlightRenewIntervalMs?: number;
+    snapshotBaseDir?: string | false;
     /**
      * Maximum number of entries in `accessProfiles` and `circuitBreakers` maps
      * before the oldest entries are pruned. Prevents unbounded memory growth.
@@ -203,6 +206,9 @@ interface CacheAdaptiveTtlOptions {
     step?: number | LayerTtlMap;
     maxTtl?: number | LayerTtlMap;
 }
+interface CacheGenerationCleanupOptions {
+    batchSize?: number;
+}
 type CacheTtlPolicy = 'until-midnight' | 'next-hour' | {
     alignTo: number;
 } | ((context: CacheTtlPolicyContext) => number | undefined);
@@ -404,7 +410,9 @@ declare class CacheStack extends EventEmitter {
     private unsubscribeInvalidation?;
     private readonly logger;
     private readonly tagIndex;
+    private readonly keyDiscovery;
     private readonly fetchRateLimiter;
+    private readonly snapshotSerializer;
     private readonly backgroundRefreshes;
     private readonly layerDegradedUntil;
     private readonly ttlResolver;
@@ -413,6 +421,7 @@ declare class CacheStack extends EventEmitter {
     private readonly writeBehindQueue;
     private writeBehindTimer?;
     private writeBehindFlushPromise?;
+    private generationCleanupPromise?;
     private isDisconnecting;
     private disconnectPromise?;
     constructor(layers: CacheLayer[], options?: CacheStackOptions);
@@ -423,6 +432,7 @@ 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.
@@ -481,6 +491,11 @@ declare class CacheStack extends EventEmitter {
      */
     getHitRate(): CacheHitRateSnapshot;
     healthCheck(): Promise<CacheHealthCheckResult[]>;
+    /**
+     * Rotates the active generation prefix used for all future cache keys.
+     * Previous-generation keys remain in the underlying layers until they expire,
+     * unless `generationCleanup` is enabled to prune them in the background.
+     */
     bumpGeneration(nextGeneration?: number): number;
     /**
      * Returns detailed metadata about a single cache key: which layers contain it,
@@ -508,6 +523,7 @@ declare class CacheStack extends EventEmitter {
     private resolveLayerSeconds;
     private shouldNegativeCache;
     private scheduleBackgroundRefresh;
+    private runBackgroundRefresh;
     private resolveSingleFlightOptions;
     private deleteKeys;
     private publishInvalidation;
@@ -515,7 +531,12 @@ declare class CacheStack extends EventEmitter {
     private getTagsForKey;
     private formatError;
     private sleep;
+    private withTimeout;
     private shouldBroadcastL1Invalidation;
+    private shouldCleanupGenerations;
+    private generationCleanupBatchSize;
+    private scheduleGenerationCleanup;
+    private cleanupGeneration;
     private initializeWriteBehind;
     private shouldWriteBehind;
     private enqueueWriteBehind;
@@ -543,12 +564,15 @@ declare class CacheStack extends EventEmitter {
     private applyFreshReadPolicies;
     private shouldSkipLayer;
     private handleLayerFailure;
+    private reportRecoverableLayerFailure;
     private isGracefulDegradationEnabled;
     private recordCircuitFailure;
     private isNegativeStoredValue;
     private emitError;
     private serializeKeyPart;
     private isCacheSnapshotEntries;
+    private sanitizeSnapshotValue;
+    private validateSnapshotFilePath;
     private normalizeForSerialization;
 }