@hops-ops/distributed 0.0.0

package/dist/internal/cache-engine/engine.d.ts

@@ -0,0 +1,32 @@
+import type { BaseCacheWriter, CacheEngine, CacheEngineOptions, CacheEngineSnapshot, CacheListener, CacheSelector, DerivedIndexReconciler, IndexKey, OptimisticCacheWriter, OptimisticLayerContext, OptimisticLayerState, RecordKey, WatchOptions } from './types.js';
+/**
+ * Minimum purpose-built implementation selected by the executable spike.
+ *
+ * It stores authoritative sparse records and exact indexes, then materializes
+ * named optimistic operation layers above them. Confirmation advances a
+ * per-dependency causal floor before removing the layer, so an older pending
+ * layer cannot become visible again after a newer command confirms.
+ */
+export declare class PurposeBuiltCacheEngine implements CacheEngine {
+    #private;
+    constructor(options?: CacheEngineOptions);
+    read<T>(selector: CacheSelector<T>): T;
+    readConfirmed<T>(selector: CacheSelector<T>): T;
+    confirmedIndexFences(keys: readonly IndexKey[]): ReadonlyMap<IndexKey, string>;
+    watch<T>(selector: CacheSelector<T>, listener: CacheListener<T>, options?: WatchOptions): () => void;
+    batch<T>(update: (writer: BaseCacheWriter) => T): T;
+    createOptimisticLayer(id: string, update: (writer: OptimisticCacheWriter) => void, context?: OptimisticLayerContext): void;
+    setDerivedIndexReconciler(reconciler: DerivedIndexReconciler | undefined): void;
+    markOptimisticLayerAccepted(id: string): boolean;
+    confirmOptimisticLayer<T>(id: string, update: (writer: BaseCacheWriter) => T): T;
+    confirmOptimisticLayers<T>(ids: readonly string[], update: (writer: BaseCacheWriter) => T): T;
+    rejectOptimisticLayer(id: string): boolean;
+    optimisticLayerState(id: string): OptimisticLayerState | undefined;
+    extract(): CacheEngineSnapshot;
+    restore(snapshot: CacheEngineSnapshot): void;
+    restoreConfirmed(snapshot: CacheEngineSnapshot): void;
+    discardIndexes(keys: readonly IndexKey[]): void;
+    retain(key: RecordKey): void;
+    release(key: RecordKey): void;
+    gc(): readonly RecordKey[];
+}