layercache 1.2.5 → 1.2.6

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

@@ -61,6 +61,7 @@ interface CacheLayer {
     clear(): Promise<void>;
     deleteMany?(keys: string[]): Promise<void>;
     keys?(): Promise<string[]>;
+    forEachKey?(visitor: (key: string) => void | Promise<void>): Promise<void>;
     ping?(): Promise<boolean>;
     dispose?(): Promise<void>;
     /**
@@ -131,10 +132,13 @@ interface CacheTagIndex {
     track(key: string, tags: string[]): Promise<void>;
     remove(key: string): Promise<void>;
     keysForTag(tag: string): Promise<string[]>;
+    forEachKeyForTag?(tag: string, visitor: (key: string) => void | Promise<void>): Promise<void>;
     keysForPrefix?(prefix: string): Promise<string[]>;
+    forEachKeyForPrefix?(prefix: string, visitor: (key: string) => void | Promise<void>): Promise<void>;
     /** Returns the tags associated with a specific key, or an empty array. */
     tagsForKey?(key: string): Promise<string[]>;
     matchPattern(pattern: string): Promise<string[]>;
+    forEachKeyMatchingPattern?(pattern: string, visitor: (key: string) => void | Promise<void>): Promise<void>;
     clear(): Promise<void>;
 }
 interface CacheLayerSetManyEntry {
@@ -194,6 +198,9 @@ interface CacheStackOptions {
     singleFlightPollMs?: number;
     singleFlightRenewIntervalMs?: number;
     snapshotBaseDir?: string | false;
+    snapshotMaxBytes?: number | false;
+    snapshotMaxEntries?: number | false;
+    invalidationMaxKeys?: number | false;
     /**
      * Maximum number of entries in `accessProfiles` and `circuitBreakers` maps
      * before the oldest entries are pruned. Prevents unbounded memory growth.
@@ -386,6 +393,10 @@ declare class CacheNamespace {
      */
     namespace(childPrefix: string): CacheNamespace;
     qualify(key: string): string;
+    private qualifyTag;
+    private qualifyGetOptions;
+    private qualifyWrapOptions;
+    private qualifyWriteOptions;
     private trackMetrics;
     private getMetricsMutex;
 }
@@ -415,6 +426,7 @@ declare class CacheStack extends EventEmitter {
     private readonly snapshotSerializer;
     private readonly backgroundRefreshes;
     private readonly layerDegradedUntil;
+    private readonly keyEpochs;
     private readonly ttlResolver;
     private readonly circuitBreakerManager;
     private currentGeneration?;
@@ -422,6 +434,7 @@ declare class CacheStack extends EventEmitter {
     private writeBehindTimer?;
     private writeBehindFlushPromise?;
     private generationCleanupPromise?;
+    private clearEpoch;
     private isDisconnecting;
     private disconnectPromise?;
     constructor(layers: CacheLayer[], options?: CacheStackOptions);
@@ -539,6 +552,10 @@ declare class CacheStack extends EventEmitter {
     private cleanupGeneration;
     private initializeWriteBehind;
     private shouldWriteBehind;
+    private beginClearEpoch;
+    private currentKeyEpoch;
+    private bumpKeyEpochs;
+    private isWriteOutdated;
     private enqueueWriteBehind;
     private flushWriteBehindQueue;
     private buildLayerSetEntry;
@@ -550,18 +567,8 @@ declare class CacheStack extends EventEmitter {
     private deleteKeysFromLayers;
     private validateConfiguration;
     private validateWriteOptions;
-    private validateLayerNumberOption;
-    private validatePositiveNumber;
-    private validateRateLimitOptions;
-    private validateNonNegativeNumber;
-    private validateCacheKey;
-    private validatePattern;
-    private validateTtlPolicy;
     private assertActive;
     private awaitStartup;
-    private serializeOptions;
-    private validateAdaptiveTtlOptions;
-    private validateCircuitBreakerOptions;
     private applyFreshReadPolicies;
     private shouldSkipLayer;
     private handleLayerFailure;
@@ -570,11 +577,14 @@ declare class CacheStack extends EventEmitter {
     private recordCircuitFailure;
     private isNegativeStoredValue;
     private emitError;
-    private serializeKeyPart;
     private isCacheSnapshotEntries;
     private sanitizeSnapshotValue;
-    private validateSnapshotFilePath;
-    private normalizeForSerialization;
+    private snapshotMaxBytes;
+    private snapshotMaxEntries;
+    private invalidationMaxKeys;
+    private collectKeysForTag;
+    private assertWithinInvalidationKeyLimit;
+    private visitExportEntries;
 }
 
 interface CacheableOptions<TArgs extends unknown[]> extends CacheWrapOptions<TArgs> {

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

@@ -61,6 +61,7 @@ interface CacheLayer {
     clear(): Promise<void>;
     deleteMany?(keys: string[]): Promise<void>;
     keys?(): Promise<string[]>;
+    forEachKey?(visitor: (key: string) => void | Promise<void>): Promise<void>;
     ping?(): Promise<boolean>;
     dispose?(): Promise<void>;
     /**
@@ -131,10 +132,13 @@ interface CacheTagIndex {
     track(key: string, tags: string[]): Promise<void>;
     remove(key: string): Promise<void>;
     keysForTag(tag: string): Promise<string[]>;
+    forEachKeyForTag?(tag: string, visitor: (key: string) => void | Promise<void>): Promise<void>;
     keysForPrefix?(prefix: string): Promise<string[]>;
+    forEachKeyForPrefix?(prefix: string, visitor: (key: string) => void | Promise<void>): Promise<void>;
     /** Returns the tags associated with a specific key, or an empty array. */
     tagsForKey?(key: string): Promise<string[]>;
     matchPattern(pattern: string): Promise<string[]>;
+    forEachKeyMatchingPattern?(pattern: string, visitor: (key: string) => void | Promise<void>): Promise<void>;
     clear(): Promise<void>;
 }
 interface CacheLayerSetManyEntry {
@@ -194,6 +198,9 @@ interface CacheStackOptions {
     singleFlightPollMs?: number;
     singleFlightRenewIntervalMs?: number;
     snapshotBaseDir?: string | false;
+    snapshotMaxBytes?: number | false;
+    snapshotMaxEntries?: number | false;
+    invalidationMaxKeys?: number | false;
     /**
      * Maximum number of entries in `accessProfiles` and `circuitBreakers` maps
      * before the oldest entries are pruned. Prevents unbounded memory growth.
@@ -386,6 +393,10 @@ declare class CacheNamespace {
      */
     namespace(childPrefix: string): CacheNamespace;
     qualify(key: string): string;
+    private qualifyTag;
+    private qualifyGetOptions;
+    private qualifyWrapOptions;
+    private qualifyWriteOptions;
     private trackMetrics;
     private getMetricsMutex;
 }
@@ -415,6 +426,7 @@ declare class CacheStack extends EventEmitter {
     private readonly snapshotSerializer;
     private readonly backgroundRefreshes;
     private readonly layerDegradedUntil;
+    private readonly keyEpochs;
     private readonly ttlResolver;
     private readonly circuitBreakerManager;
     private currentGeneration?;
@@ -422,6 +434,7 @@ declare class CacheStack extends EventEmitter {
     private writeBehindTimer?;
     private writeBehindFlushPromise?;
     private generationCleanupPromise?;
+    private clearEpoch;
     private isDisconnecting;
     private disconnectPromise?;
     constructor(layers: CacheLayer[], options?: CacheStackOptions);
@@ -539,6 +552,10 @@ declare class CacheStack extends EventEmitter {
     private cleanupGeneration;
     private initializeWriteBehind;
     private shouldWriteBehind;
+    private beginClearEpoch;
+    private currentKeyEpoch;
+    private bumpKeyEpochs;
+    private isWriteOutdated;
     private enqueueWriteBehind;
     private flushWriteBehindQueue;
     private buildLayerSetEntry;
@@ -550,18 +567,8 @@ declare class CacheStack extends EventEmitter {
     private deleteKeysFromLayers;
     private validateConfiguration;
     private validateWriteOptions;
-    private validateLayerNumberOption;
-    private validatePositiveNumber;
-    private validateRateLimitOptions;
-    private validateNonNegativeNumber;
-    private validateCacheKey;
-    private validatePattern;
-    private validateTtlPolicy;
     private assertActive;
     private awaitStartup;
-    private serializeOptions;
-    private validateAdaptiveTtlOptions;
-    private validateCircuitBreakerOptions;
     private applyFreshReadPolicies;
     private shouldSkipLayer;
     private handleLayerFailure;
@@ -570,11 +577,14 @@ declare class CacheStack extends EventEmitter {
     private recordCircuitFailure;
     private isNegativeStoredValue;
     private emitError;
-    private serializeKeyPart;
     private isCacheSnapshotEntries;
     private sanitizeSnapshotValue;
-    private validateSnapshotFilePath;
-    private normalizeForSerialization;
+    private snapshotMaxBytes;
+    private snapshotMaxEntries;
+    private invalidationMaxKeys;
+    private collectKeysForTag;
+    private assertWithinInvalidationKeyLimit;
+    private visitExportEntries;
 }
 
 interface CacheableOptions<TArgs extends unknown[]> extends CacheWrapOptions<TArgs> {