layercache 1.2.6 → 1.2.8

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

@@ -343,6 +343,21 @@ interface CacheStackEvents {
     warm: {
         key: string;
     };
+    /** Fired immediately before a high-level cache operation begins. */
+    'operation-start': {
+        id: number;
+        name: string;
+        attributes?: Record<string, unknown>;
+    };
+    /** Fired after a high-level cache operation finishes. */
+    'operation-end': {
+        id: number;
+        name: string;
+        attributes?: Record<string, unknown>;
+        success: boolean;
+        result?: 'null';
+        error?: unknown;
+    };
     /** Fired when an error occurs (layer failure, circuit breaker, etc.). */
     error: {
         operation: string;
@@ -424,17 +439,16 @@ declare class CacheStack extends EventEmitter {
     private readonly keyDiscovery;
     private readonly fetchRateLimiter;
     private readonly snapshotSerializer;
+    private readonly invalidation;
+    private readonly layerWriter;
+    private readonly snapshots;
     private readonly backgroundRefreshes;
     private readonly layerDegradedUntil;
-    private readonly keyEpochs;
+    private readonly maintenance;
     private readonly ttlResolver;
     private readonly circuitBreakerManager;
+    private nextOperationId;
     private currentGeneration?;
-    private readonly writeBehindQueue;
-    private writeBehindTimer?;
-    private writeBehindFlushPromise?;
-    private generationCleanupPromise?;
-    private clearEpoch;
     private isDisconnecting;
     private disconnectPromise?;
     constructor(layers: CacheLayer[], options?: CacheStackOptions);
@@ -530,8 +544,6 @@ declare class CacheStack extends EventEmitter {
     private readFromLayers;
     private readLayerEntry;
     private backfill;
-    private writeAcrossLayers;
-    private executeLayerOperations;
     private resolveFreshTtl;
     private resolveLayerSeconds;
     private shouldNegativeCache;
@@ -546,25 +558,17 @@ declare class CacheStack extends EventEmitter {
     private sleep;
     private withTimeout;
     private shouldBroadcastL1Invalidation;
-    private shouldCleanupGenerations;
-    private generationCleanupBatchSize;
+    private observeOperation;
     private scheduleGenerationCleanup;
     private cleanupGeneration;
     private initializeWriteBehind;
     private shouldWriteBehind;
-    private beginClearEpoch;
-    private currentKeyEpoch;
-    private bumpKeyEpochs;
-    private isWriteOutdated;
     private enqueueWriteBehind;
     private flushWriteBehindQueue;
-    private buildLayerSetEntry;
-    private intersectKeys;
+    private runWriteBehindBatch;
     private qualifyKey;
     private qualifyPattern;
     private stripQualifiedKey;
-    private generationPrefix;
-    private deleteKeysFromLayers;
     private validateConfiguration;
     private validateWriteOptions;
     private assertActive;
@@ -577,14 +581,9 @@ declare class CacheStack extends EventEmitter {
     private recordCircuitFailure;
     private isNegativeStoredValue;
     private emitError;
-    private isCacheSnapshotEntries;
-    private sanitizeSnapshotValue;
     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

@@ -343,6 +343,21 @@ interface CacheStackEvents {
     warm: {
         key: string;
     };
+    /** Fired immediately before a high-level cache operation begins. */
+    'operation-start': {
+        id: number;
+        name: string;
+        attributes?: Record<string, unknown>;
+    };
+    /** Fired after a high-level cache operation finishes. */
+    'operation-end': {
+        id: number;
+        name: string;
+        attributes?: Record<string, unknown>;
+        success: boolean;
+        result?: 'null';
+        error?: unknown;
+    };
     /** Fired when an error occurs (layer failure, circuit breaker, etc.). */
     error: {
         operation: string;
@@ -424,17 +439,16 @@ declare class CacheStack extends EventEmitter {
     private readonly keyDiscovery;
     private readonly fetchRateLimiter;
     private readonly snapshotSerializer;
+    private readonly invalidation;
+    private readonly layerWriter;
+    private readonly snapshots;
     private readonly backgroundRefreshes;
     private readonly layerDegradedUntil;
-    private readonly keyEpochs;
+    private readonly maintenance;
     private readonly ttlResolver;
     private readonly circuitBreakerManager;
+    private nextOperationId;
     private currentGeneration?;
-    private readonly writeBehindQueue;
-    private writeBehindTimer?;
-    private writeBehindFlushPromise?;
-    private generationCleanupPromise?;
-    private clearEpoch;
     private isDisconnecting;
     private disconnectPromise?;
     constructor(layers: CacheLayer[], options?: CacheStackOptions);
@@ -530,8 +544,6 @@ declare class CacheStack extends EventEmitter {
     private readFromLayers;
     private readLayerEntry;
     private backfill;
-    private writeAcrossLayers;
-    private executeLayerOperations;
     private resolveFreshTtl;
     private resolveLayerSeconds;
     private shouldNegativeCache;
@@ -546,25 +558,17 @@ declare class CacheStack extends EventEmitter {
     private sleep;
     private withTimeout;
     private shouldBroadcastL1Invalidation;
-    private shouldCleanupGenerations;
-    private generationCleanupBatchSize;
+    private observeOperation;
     private scheduleGenerationCleanup;
     private cleanupGeneration;
     private initializeWriteBehind;
     private shouldWriteBehind;
-    private beginClearEpoch;
-    private currentKeyEpoch;
-    private bumpKeyEpochs;
-    private isWriteOutdated;
     private enqueueWriteBehind;
     private flushWriteBehindQueue;
-    private buildLayerSetEntry;
-    private intersectKeys;
+    private runWriteBehindBatch;
     private qualifyKey;
     private qualifyPattern;
     private stripQualifiedKey;
-    private generationPrefix;
-    private deleteKeysFromLayers;
     private validateConfiguration;
     private validateWriteOptions;
     private assertActive;
@@ -577,14 +581,9 @@ declare class CacheStack extends EventEmitter {
     private recordCircuitFailure;
     private isNegativeStoredValue;
     private emitError;
-    private isCacheSnapshotEntries;
-    private sanitizeSnapshotValue;
     private snapshotMaxBytes;
     private snapshotMaxEntries;
     private invalidationMaxKeys;
-    private collectKeysForTag;
-    private assertWithinInvalidationKeyLimit;
-    private visitExportEntries;
 }
 
 interface CacheableOptions<TArgs extends unknown[]> extends CacheWrapOptions<TArgs> {