@powerhousedao/reactor 6.0.0-dev.105 → 6.0.0-dev.106

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerhousedao/reactor",
-  "version": "6.0.0-dev.105",
+  "version": "6.0.0-dev.106",
   "description": "",
   "repository": {
     "url": "https://github.com/powerhouse-inc/powerhouse",
@@ -9,12 +9,12 @@
   "type": "module",
   "exports": {
     ".": {
-      "types": "./dist/src/index.d.ts",
-      "import": "./dist/src/index.js"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     }
   },
   "files": [
-    "./dist/src"
+    "dist"
   ],
   "publishConfig": {
     "access": "public"
@@ -22,30 +22,28 @@
   "keywords": [],
   "author": "",
   "license": "AGPL-3.0-only",
-  "devDependencies": {
-    "@electric-sql/pglite": "0.3.15",
+  "dependencies": {
+    "uuid": "^11.0.5",
     "kysely": "0.28.11",
     "kysely-pglite-dialect": "1.2.0",
-    "uuid": "^11.0.5",
+    "@electric-sql/pglite": "0.3.15",
+    "@sindresorhus/fnv1a": "3.1.0",
+    "@powerhousedao/shared": "6.0.0-dev.106",
+    "document-drive": "6.0.0-dev.106",
+    "document-model": "6.0.0-dev.106"
+  },
+  "devDependencies": {
     "@vitest/coverage-v8": "^3.2.4",
     "prettier": "3.8.1",
     "tinybench": "^2.9.0",
     "tsx": "4.21.0",
     "vitest": "3.2.4",
     "@types/bun": "1.3.8",
-    "@powerhousedao/shared": "6.0.0-dev.105",
-    "document-model": "6.0.0-dev.105",
-    "document-drive": "6.0.0-dev.105"
-  },
-  "peerDependencies": {
-    "@electric-sql/pglite": ">=0.3.15",
-    "document-drive": "6.0.0-dev.105",
-    "document-model": "6.0.0-dev.105"
+    "tsdown": "0.21.0",
+    "vite-tsconfig-paths": "6.1.1"
   },
   "scripts": {
-    "prebuild": "pnpm run clean",
-    "build": "tsc",
-    "build:bundle": "bun run ./bundle.ts",
+    "build:bundle": "tsdown",
     "test": "vitest run --coverage --printConsoleTrace=true --silent=false",
     "test:watch": "vitest --coverage",
     "lint": "eslint",

package/dist/src/actions/index.d.ts

@@ -1,24 +0,0 @@
-import type { Action, CreateDocumentActionInput, UpgradeDocumentActionInput } from "document-model";
-import { actions as documentActions } from "document-model";
-export { documentActions };
-/**
- * Creates a CREATE_DOCUMENT action for document creation.
- */
-export declare function createDocumentAction(input: CreateDocumentActionInput): Action;
-/**
- * Creates an UPGRADE_DOCUMENT action to set initial document state.
- */
-export declare function upgradeDocumentAction(input: UpgradeDocumentActionInput): Action;
-/**
- * Creates a DELETE_DOCUMENT action for document deletion.
- */
-export declare function deleteDocumentAction(documentId: string): Action;
-/**
- * Creates an ADD_RELATIONSHIP action to establish a parent-child relationship.
- */
-export declare function addRelationshipAction(sourceId: string, targetId: string, relationshipType?: string): Action;
-/**
- * Creates a REMOVE_RELATIONSHIP action to remove a parent-child relationship.
- */
-export declare function removeRelationshipAction(sourceId: string, targetId: string, relationshipType?: string): Action;
-//# sourceMappingURL=index.d.ts.map

package/dist/src/actions/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/actions/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EAEN,yBAAyB,EAGzB,0BAA0B,EAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,OAAO,IAAI,eAAe,EAAc,MAAM,gBAAgB,CAAC;AAExE,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,CAQ7E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,0BAA0B,GAChC,MAAM,CAQR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAY/D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,gBAAgB,GAAE,MAAgB,GACjC,MAAM,CAcR;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,gBAAgB,GAAE,MAAgB,GACjC,MAAM,CAcR"}

package/dist/src/admin/document-integrity-service.d.ts

@@ -1,17 +0,0 @@
-import type { IWriteCache } from "../cache/write/interfaces.js";
-import type { IDocumentModelRegistry } from "../registry/interfaces.js";
-import type { IDocumentView, IKeyframeStore, IOperationStore } from "../storage/interfaces.js";
-import type { IDocumentIntegrityService, RebuildResult, ValidationResult } from "./types.js";
-export declare class DocumentIntegrityService implements IDocumentIntegrityService {
-    private readonly keyframeStore;
-    private readonly operationStore;
-    private readonly writeCache;
-    private readonly documentView;
-    private readonly documentModelRegistry;
-    constructor(keyframeStore: IKeyframeStore, operationStore: IOperationStore, writeCache: IWriteCache, documentView: IDocumentView, documentModelRegistry: IDocumentModelRegistry);
-    validateDocument(documentId: string, branch?: string, signal?: AbortSignal): Promise<ValidationResult>;
-    rebuildKeyframes(documentId: string, branch?: string, signal?: AbortSignal): Promise<RebuildResult>;
-    rebuildSnapshots(documentId: string, branch?: string, signal?: AbortSignal): Promise<RebuildResult>;
-    private discoverScopes;
-}
-//# sourceMappingURL=document-integrity-service.d.ts.map

package/dist/src/admin/document-integrity-service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"document-integrity-service.d.ts","sourceRoot":"","sources":["../../../src/admin/document-integrity-service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACV,yBAAyB,EAEzB,aAAa,EAEb,gBAAgB,EACjB,MAAM,YAAY,CAAC;AASpB,qBAAa,wBAAyB,YAAW,yBAAyB;IACxE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkB;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;IAC7C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAyB;gBAG7D,aAAa,EAAE,cAAc,EAC7B,cAAc,EAAE,eAAe,EAC/B,UAAU,EAAE,WAAW,EACvB,YAAY,EAAE,aAAa,EAC3B,qBAAqB,EAAE,sBAAsB;IASzC,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,MAAM,SAAS,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,gBAAgB,CAAC;IAiHtB,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,MAAM,SAAS,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC;IAenB,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,MAAM,SAAS,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC;YAiBX,cAAc;CAY7B"}

package/dist/src/admin/types.d.ts

@@ -1,30 +0,0 @@
-export type KeyframeValidationIssue = {
-    scope: string;
-    branch: string;
-    revision: number;
-    keyframeHash: string;
-    replayedHash: string;
-};
-export type SnapshotValidationIssue = {
-    scope: string;
-    branch: string;
-    snapshotHash: string;
-    replayedHash: string;
-};
-export type ValidationResult = {
-    documentId: string;
-    isConsistent: boolean;
-    keyframeIssues: KeyframeValidationIssue[];
-    snapshotIssues: SnapshotValidationIssue[];
-};
-export type RebuildResult = {
-    documentId: string;
-    keyframesDeleted: number;
-    scopesInvalidated: number;
-};
-export interface IDocumentIntegrityService {
-    validateDocument(documentId: string, branch?: string, signal?: AbortSignal): Promise<ValidationResult>;
-    rebuildKeyframes(documentId: string, branch?: string, signal?: AbortSignal): Promise<RebuildResult>;
-    rebuildSnapshots(documentId: string, branch?: string, signal?: AbortSignal): Promise<RebuildResult>;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/src/admin/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/admin/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,uBAAuB,EAAE,CAAC;IAC1C,cAAc,EAAE,uBAAuB,EAAE,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,WAAW,yBAAyB;IACxC,gBAAgB,CACd,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE7B,gBAAgB,CACd,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1B,gBAAgB,CACd,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3B"}

package/dist/src/cache/buffer/ring-buffer.d.ts

@@ -1,37 +0,0 @@
-/**
- * RingBuffer is a generic circular buffer implementation that stores a fixed number
- * of items. When the buffer is full, new items overwrite the oldest items.
- *
- * This implementation maintains O(1) time complexity for push operations and provides
- * items in chronological order (oldest to newest) via getAll().
- *
- * @template T - The type of items stored in the buffer
- */
-export declare class RingBuffer<T> {
-    private buffer;
-    private head;
-    private size;
-    private capacity;
-    constructor(capacity: number);
-    /**
-     * Adds an item to the buffer. If the buffer is full, overwrites the oldest item.
-     *
-     * @param item - The item to add
-     */
-    push(item: T): void;
-    /**
-     * Returns all items in the buffer in chronological order (oldest to newest).
-     *
-     * @returns Array of items in insertion order
-     */
-    getAll(): T[];
-    /**
-     * Clears all items from the buffer.
-     */
-    clear(): void;
-    /**
-     * Gets the current number of items in the buffer.
-     */
-    get length(): number;
-}
-//# sourceMappingURL=ring-buffer.d.ts.map

package/dist/src/cache/buffer/ring-buffer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ring-buffer.d.ts","sourceRoot":"","sources":["../../../../src/cache/buffer/ring-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qBAAa,UAAU,CAAC,CAAC;IACvB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAQ5B;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAYnB;;;;OAIG;IACH,MAAM,IAAI,CAAC,EAAE;IAab;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}

package/dist/src/cache/collection-membership-cache.d.ts

@@ -1,14 +0,0 @@
-import type { IOperationIndex } from "./operation-index-types.js";
-export interface ICollectionMembershipCache {
-    getCollectionsForDocuments(documentIds: string[]): Promise<Record<string, string[]>>;
-    invalidate(documentId: string): void;
-}
-export declare class CollectionMembershipCache implements ICollectionMembershipCache {
-    private operationIndex;
-    private cache;
-    constructor(operationIndex: IOperationIndex);
-    withScopedIndex(operationIndex: IOperationIndex): CollectionMembershipCache;
-    getCollectionsForDocuments(documentIds: string[]): Promise<Record<string, string[]>>;
-    invalidate(documentId: string): void;
-}
-//# sourceMappingURL=collection-membership-cache.d.ts.map

package/dist/src/cache/collection-membership-cache.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"collection-membership-cache.d.ts","sourceRoot":"","sources":["../../../src/cache/collection-membership-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,MAAM,WAAW,0BAA0B;IAEzC,0BAA0B,CACxB,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAGrC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,qBAAa,yBAA0B,YAAW,0BAA0B;IAG9D,OAAO,CAAC,cAAc;IAFlC,OAAO,CAAC,KAAK,CAAoC;gBAE7B,cAAc,EAAE,eAAe;IAEnD,eAAe,CAAC,cAAc,EAAE,eAAe,GAAG,yBAAyB;IAMrE,0BAA0B,CAC9B,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IA0BpC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAGrC"}

package/dist/src/cache/document-meta-cache-types.d.ts

@@ -1,114 +0,0 @@
-import type { PHDocumentState } from "document-model";
-/**
- * Configuration options for the document metadata cache.
- */
-export type DocumentMetaCacheConfig = {
-    /**
-     * Maximum number of document metadata entries to cache (LRU eviction).
-     * Default: 1000
-     */
-    maxDocuments: number;
-};
-/**
- * Cached document metadata from the "document" scope.
- *
- * This lightweight structure holds essential document information needed by
- * the job executor without fetching full scope state. It provides an explicit
- * cross-scope contract for accessing document scope metadata.
- */
-export type CachedDocumentMeta = {
-    /**
-     * The full PHDocumentState from document.state.document.
-     * Contains version, hash, isDeleted, deletedAtUtcIso, etc.
-     */
-    state: PHDocumentState;
-    /**
-     * The document type (from header), cached for convenience.
-     */
-    documentType: string;
-    /**
-     * The revision of the document scope when this metadata was captured.
-     * Used for cache invalidation and consistency checks.
-     */
-    documentScopeRevision: number;
-};
-/**
- * Interface for the document metadata cache.
- *
- * This cache provides an explicit cross-scope contract for accessing document
- * scope metadata. It solves the problem where job execution in one scope (e.g.,
- * "global") needs access to document scope state (version, isDeleted, etc.)
- * which may be stale in scope-specific caches or keyframes.
- *
- * The cache supports:
- * - Latest metadata retrieval with LRU caching
- * - Historical metadata reconstruction for reshuffling scenarios
- * - Eager updates after document scope operations
- */
-export interface IDocumentMetaCache {
-    /**
-     * Retrieves the LATEST document metadata from cache or rebuilds from operations.
-     *
-     * On cache miss, fetches all document scope operations and reconstructs the
-     * current PHDocumentState by applying UPGRADE_DOCUMENT and DELETE_DOCUMENT
-     * operations.
-     *
-     * @param documentId - The document identifier
-     * @param branch - Branch name
-     * @param signal - Optional abort signal to cancel the operation
-     * @returns The cached or rebuilt document metadata
-     * @throws {Error} "Operation aborted" if signal is aborted
-     * @throws {Error} If document not found (no CREATE_DOCUMENT operation)
-     */
-    getDocumentMeta(documentId: string, branch: string, signal?: AbortSignal): Promise<CachedDocumentMeta>;
-    /**
-     * Rebuilds document metadata at a SPECIFIC revision (always rebuilds, no caching).
-     *
-     * Used during reshuffling when operations need to be inserted at a previous
-     * revision and we need the document scope state as of that point in time.
-     *
-     * @param documentId - The document identifier
-     * @param branch - Branch name
-     * @param targetRevision - The document scope revision to reconstruct up to
-     * @param signal - Optional abort signal to cancel the operation
-     * @returns Document metadata as of the target revision
-     * @throws {Error} "Operation aborted" if signal is aborted
-     * @throws {Error} If document not found
-     */
-    rebuildAtRevision(documentId: string, branch: string, targetRevision: number, signal?: AbortSignal): Promise<CachedDocumentMeta>;
-    /**
-     * Eagerly updates cached metadata after document scope operations.
-     *
-     * Called by the job executor after CREATE_DOCUMENT, UPGRADE_DOCUMENT, or
-     * DELETE_DOCUMENT operations to keep the cache current.
-     *
-     * @param documentId - The document identifier
-     * @param branch - Branch name
-     * @param meta - The new metadata to cache
-     */
-    putDocumentMeta(documentId: string, branch: string, meta: CachedDocumentMeta): void;
-    /**
-     * Invalidates cached document metadata.
-     *
-     * Call before reshuffling operations that modify the document scope, or
-     * when document state may have changed externally.
-     *
-     * @param documentId - The document identifier
-     * @param branch - Optional branch to narrow invalidation (if omitted, all branches)
-     * @returns Number of entries invalidated
-     */
-    invalidate(documentId: string, branch?: string): number;
-    /**
-     * Clears all cached document metadata.
-     */
-    clear(): void;
-    /**
-     * Performs startup initialization.
-     */
-    startup(): Promise<void>;
-    /**
-     * Performs graceful shutdown.
-     */
-    shutdown(): Promise<void>;
-}
-//# sourceMappingURL=document-meta-cache-types.d.ts.map

package/dist/src/cache/document-meta-cache-types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"document-meta-cache-types.d.ts","sourceRoot":"","sources":["../../../src/cache/document-meta-cache-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;OAGG;IACH,KAAK,EAAE,eAAe,CAAC;IAEvB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;;OAaG;IACH,eAAe,CACb,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE/B;;;;;;;;;;;;;OAaG;IACH,iBAAiB,CACf,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE/B;;;;;;;;;OASG;IACH,eAAe,CACb,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,kBAAkB,GACvB,IAAI,CAAC;IAER;;;;;;;;;OASG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAExD;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}

package/dist/src/cache/document-meta-cache.d.ts

@@ -1,31 +0,0 @@
-import type { IOperationStore } from "../storage/interfaces.js";
-import type { CachedDocumentMeta, DocumentMetaCacheConfig, IDocumentMetaCache } from "./document-meta-cache-types.js";
-/**
- * In-memory document metadata cache with LRU eviction.
- *
- * Caches PHDocumentState per (documentId, branch) key. On cache miss,
- * rebuilds from document scope operations. Provides an explicit cross-scope
- * contract for accessing document scope metadata.
- *
- * **Thread Safety:**
- * Not thread-safe. Designed for single-threaded job executor environment.
- */
-export declare class DocumentMetaCache implements IDocumentMetaCache {
-    private cache;
-    private lruTracker;
-    private operationStore;
-    private config;
-    constructor(operationStore: IOperationStore, config: DocumentMetaCacheConfig);
-    withScopedStore(operationStore: IOperationStore): DocumentMetaCache;
-    startup(): Promise<void>;
-    shutdown(): Promise<void>;
-    getDocumentMeta(documentId: string, branch: string, signal?: AbortSignal): Promise<CachedDocumentMeta>;
-    rebuildAtRevision(documentId: string, branch: string, targetRevision: number, signal?: AbortSignal): Promise<CachedDocumentMeta>;
-    putDocumentMeta(documentId: string, branch: string, meta: CachedDocumentMeta): void;
-    invalidate(documentId: string, branch?: string): number;
-    clear(): void;
-    private makeKey;
-    private rebuildLatest;
-    private rebuildFromOperations;
-}
-//# sourceMappingURL=document-meta-cache.d.ts.map

package/dist/src/cache/document-meta-cache.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"document-meta-cache.d.ts","sourceRoot":"","sources":["../../../src/cache/document-meta-cache.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AAGxC;;;;;;;;;GASG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB;IAC1D,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,MAAM,CAA0B;gBAGtC,cAAc,EAAE,eAAe,EAC/B,MAAM,EAAE,uBAAuB;IAUjC,eAAe,CAAC,cAAc,EAAE,eAAe,GAAG,iBAAiB;IAO7D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC;IAkBxB,iBAAiB,CACrB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC;IAa9B,eAAe,CACb,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,kBAAkB,GACvB,IAAI;IAcP,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAuBvD,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,OAAO;YAID,aAAa;YAQb,qBAAqB;CA2DpC"}

package/dist/src/cache/index.d.ts

@@ -1,3 +0,0 @@
-export type { IOperationIndex, IOperationIndexTxn, OperationIndexEntry, } from "./operation-index-types.js";
-export { KyselyOperationIndex } from "./kysely-operation-index.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/cache/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cache/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/src/cache/kysely-operation-index.d.ts

@@ -1,24 +0,0 @@
-import type { OperationWithContext } from "document-model";
-import type { Kysely, Transaction } from "kysely";
-import type { PagedResults, PagingOptions } from "../shared/types.js";
-import type { ViewFilter } from "../storage/interfaces.js";
-import type { Database } from "../storage/kysely/types.js";
-import type { IOperationIndex, IOperationIndexTxn, OperationIndexEntry } from "./operation-index-types.js";
-export declare class KyselyOperationIndex implements IOperationIndex {
-    private db;
-    private trx?;
-    constructor(db: Kysely<Database>);
-    private get queryExecutor();
-    withTransaction(trx: Transaction<Database>): KyselyOperationIndex;
-    start(): IOperationIndexTxn;
-    commit(txn: IOperationIndexTxn, signal?: AbortSignal): Promise<number[]>;
-    private executeCommit;
-    find(collectionId: string, cursor?: number, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<OperationIndexEntry>>;
-    get(documentId: string, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<OperationIndexEntry>>;
-    getSinceOrdinal(ordinal: number, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<OperationWithContext>>;
-    private rowToOperationWithContext;
-    private rowToOperationIndexEntry;
-    getLatestTimestampForCollection(collectionId: string, signal?: AbortSignal): Promise<string | null>;
-    getCollectionsForDocuments(documentIds: string[]): Promise<Record<string, string[]>>;
-}
-//# sourceMappingURL=kysely-operation-index.d.ts.map

package/dist/src/cache/kysely-operation-index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"kysely-operation-index.d.ts","sourceRoot":"","sources":["../../../src/cache/kysely-operation-index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAGV,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EAEpB,MAAM,4BAA4B,CAAC;AAsEpC,qBAAa,oBAAqB,YAAW,eAAe;IAG9C,OAAO,CAAC,EAAE;IAFtB,OAAO,CAAC,GAAG,CAAC,CAAwB;gBAEhB,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC;IAExC,OAAO,KAAK,aAAa,GAExB;IAED,eAAe,CAAC,GAAG,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,oBAAoB;IAMjE,KAAK,IAAI,kBAAkB;IAIrB,MAAM,CACV,GAAG,EAAE,kBAAkB,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC;YAkBN,aAAa;IA8FrB,IAAI,CACR,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,UAAU,EACjB,MAAM,CAAC,EAAE,aAAa,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;IA6EvC,GAAG,CACP,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,UAAU,EACjB,MAAM,CAAC,EAAE,aAAa,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;IA0DvC,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,aAAa,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC;IAsD9C,OAAO,CAAC,yBAAyB;IAsBjC,OAAO,CAAC,wBAAwB;IAmB1B,+BAA+B,CACnC,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAoBnB,0BAA0B,CAC9B,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAqBrC"}

package/dist/src/cache/kysely-write-cache.d.ts

@@ -1,142 +0,0 @@
-import type { PHDocument } from "document-model";
-import type { IDocumentModelRegistry } from "../registry/interfaces.js";
-import type { IKeyframeStore, IOperationStore } from "../storage/interfaces.js";
-import { RingBuffer } from "./buffer/ring-buffer.js";
-import type { CachedSnapshot, WriteCacheConfig } from "./write-cache-types.js";
-import type { IWriteCache } from "./write/interfaces.js";
-type DocumentStream = {
-    key: string;
-    ringBuffer: RingBuffer<CachedSnapshot>;
-};
-/**
- * In-memory write cache with keyframe persistence for PHDocuments.
- *
- * Caches document snapshots in ring buffers with LRU eviction. On cache miss,
- * rebuilds documents from nearest keyframe or full operation history.
- *
- * **Performance Characteristics:**
- * - Cache hit: O(1) lookup in ring buffer
- * - Cold miss: O(n) where n is total operation count, or O(k) where k is operations since keyframe
- * - Warm miss: O(m) where m is operations since cached revision
- * - Eviction: O(1) for LRU tracking and removal
- *
- * **Thread Safety:**
- * Not thread-safe. Designed for single-threaded job executor environment.
- * External synchronization required for concurrent access across multiple executors.
- *
- * **Example:**
- * ```typescript
- * const cache = new KyselyWriteCache(
- *   keyframeStore,
- *   operationStore,
- *   registry,
- *   { maxDocuments: 1000, ringBufferSize: 10, keyframeInterval: 10 }
- * );
- *
- * await cache.startup();
- *
- * // Retrieve or rebuild document
- * const doc = await cache.getState(docId, docType, scope, branch, revision);
- *
- * // Cache result after job execution
- * cache.putState(docId, docType, scope, branch, newRevision, updatedDoc);
- *
- * await cache.shutdown();
- * ```
- */
-export declare class KyselyWriteCache implements IWriteCache {
-    private streams;
-    private lruTracker;
-    private keyframeStore;
-    private operationStore;
-    private registry;
-    private config;
-    constructor(keyframeStore: IKeyframeStore, operationStore: IOperationStore, registry: IDocumentModelRegistry, config: WriteCacheConfig);
-    withScopedStores(operationStore: IOperationStore, keyframeStore: IKeyframeStore): KyselyWriteCache;
-    /**
-     * Initializes the write cache.
-     * Currently a no-op as keyframe store lifecycle is managed externally.
-     */
-    startup(): Promise<void>;
-    /**
-     * Shuts down the write cache.
-     * Currently a no-op as keyframe store lifecycle is managed externally.
-     */
-    shutdown(): Promise<void>;
-    /**
-     * Retrieves document state at a specific revision from cache or rebuilds it.
-     *
-     * Cache hit path: Returns cached snapshot if available (O(1))
-     * Warm miss path: Rebuilds from cached base revision + incremental ops
-     * Cold miss path: Rebuilds from keyframe or from scratch using all operations
-     *
-     * @param documentId - The document identifier
-     * @param scope - The operation scope
-     * @param branch - The operation branch
-     * @param targetRevision - The target revision, or undefined for newest
-     * @param signal - Optional abort signal to cancel the operation
-     * @returns The document at the target revision
-     * @throws {Error} "Operation aborted" if signal is aborted
-     * @throws {ModuleNotFoundError} If document type not registered in registry
-     * @throws {Error} "Failed to rebuild document" if operation store fails
-     * @throws {Error} If reducer throws during operation application
-     * @throws {Error} If document serialization fails
-     */
-    getState(documentId: string, scope: string, branch: string, targetRevision?: number, signal?: AbortSignal): Promise<PHDocument>;
-    /**
-     * Stores a document snapshot in the cache at a specific revision.
-     *
-     * The cached document is a shallow copy of the input with its operation history
-     * truncated to the last operation per scope and its clipboard cleared. This keeps
-     * memory use and copy costs constant regardless of operation count. Consumers of
-     * getState() must not rely on the full operation history being present; the only
-     * guaranteed invariant is that operations[scope].at(-1) reflects the latest
-     * operation index for each scope.
-     *
-     * Updates LRU tracker and may evict least recently used stream if at capacity.
-     * Asynchronously persists keyframes at configured intervals (fire-and-forget).
-     *
-     * @param documentId - The document identifier
-     * @param scope - The operation scope
-     * @param branch - The operation branch
-     * @param revision - The revision number
-     * @param document - The document to cache
-     * @throws {Error} If document serialization fails
-     */
-    putState(documentId: string, scope: string, branch: string, revision: number, document: PHDocument): void;
-    /**
-     * Invalidates cached document streams.
-     *
-     * Supports three invalidation scopes:
-     * - Document-level: invalidate(documentId) - removes all streams for document
-     * - Scope-level: invalidate(documentId, scope) - removes all branches for scope
-     * - Stream-level: invalidate(documentId, scope, branch) - removes specific stream
-     *
-     * @param documentId - The document identifier
-     * @param scope - Optional scope to narrow invalidation
-     * @param branch - Optional branch to narrow invalidation (requires scope)
-     * @returns The number of streams evicted
-     */
-    invalidate(documentId: string, scope?: string, branch?: string): number;
-    /**
-     * Clears the entire cache, removing all cached document streams.
-     * Resets LRU tracking state. This operation always succeeds.
-     */
-    clear(): void;
-    /**
-     * Retrieves a specific stream for a document. Exposed on the implementation
-     * for testing, but not on the interface.
-     *
-     * @internal
-     */
-    getStream(documentId: string, scope: string, branch: string): DocumentStream | undefined;
-    private findNearestKeyframe;
-    private coldMissRebuild;
-    private warmMissRebuild;
-    private findNearestOlderSnapshot;
-    private makeStreamKey;
-    private getOrCreateStream;
-    private isKeyframeRevision;
-}
-export {};
-//# sourceMappingURL=kysely-write-cache.d.ts.map

package/dist/src/cache/kysely-write-cache.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"kysely-write-cache.d.ts","sourceRoot":"","sources":["../../../src/cache/kysely-write-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,UAAU,EAEX,MAAM,gBAAgB,CAAC;AAMxB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,KAAK,cAAc,GAAG;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;CACxC,CAAC;AAQF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAClD,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,MAAM,CAA6B;gBAGzC,aAAa,EAAE,cAAc,EAC7B,cAAc,EAAE,eAAe,EAC/B,QAAQ,EAAE,sBAAsB,EAChC,MAAM,EAAE,gBAAgB;IAc1B,gBAAgB,CACd,cAAc,EAAE,eAAe,EAC/B,aAAa,EAAE,cAAc,GAC5B,gBAAgB;IAYnB;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B;;;;;;;;;;;;;;;;;;OAkBG;IACG,QAAQ,CACZ,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,MAAM,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC;IAiEtB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CACN,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,UAAU,GACnB,IAAI;IA0CP;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IA+BvE;;;OAGG;IACH,KAAK,IAAI,IAAI;IAKb;;;;;OAKG;IACH,SAAS,CACP,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,cAAc,GAAG,SAAS;YAKf,mBAAmB;YAoBnB,eAAe;YA2Kf,eAAe;IAmE7B,OAAO,CAAC,wBAAwB;IAiBhC,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,kBAAkB;CAG3B"}

package/dist/src/cache/lru/lru-tracker.d.ts

@@ -1,15 +0,0 @@
-export declare class LRUTracker<K> {
-    private map;
-    private head;
-    private tail;
-    constructor();
-    get size(): number;
-    touch(key: K): void;
-    evict(): K | undefined;
-    remove(key: K): void;
-    clear(): void;
-    private addToFront;
-    private moveToFront;
-    private removeNode;
-}
-//# sourceMappingURL=lru-tracker.d.ts.map

package/dist/src/cache/lru/lru-tracker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lru-tracker.d.ts","sourceRoot":"","sources":["../../../../src/cache/lru/lru-tracker.ts"],"names":[],"mappings":"AAYA,qBAAa,UAAU,CAAC,CAAC;IACvB,OAAO,CAAC,GAAG,CAAqB;IAChC,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,IAAI,CAAyB;;IAQrC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI;IAUnB,KAAK,IAAI,CAAC,GAAG,SAAS;IAUtB,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI;IAUpB,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,UAAU;CAanB"}

package/dist/src/cache/operation-index-types.d.ts

@@ -1,64 +0,0 @@
-import type { Operation, OperationWithContext } from "document-model";
-import type { Generated, Insertable, Selectable, Updateable } from "kysely";
-import type { PagedResults, PagingOptions } from "../shared/types.js";
-import type { ViewFilter } from "../storage/interfaces.js";
-export type OperationIndexEntry = Operation & {
-    ordinal?: number;
-    documentId: string;
-    documentType: string;
-    branch: string;
-    scope: string;
-    sourceRemote: string;
-};
-export interface IOperationIndexTxn {
-    createCollection(collectionId: string): void;
-    addToCollection(collectionId: string, documentId: string): void;
-    removeFromCollection(collectionId: string, documentId: string): void;
-    write(operations: OperationIndexEntry[]): void;
-}
-export interface IOperationIndex {
-    start(): IOperationIndexTxn;
-    commit(txn: IOperationIndexTxn, signal?: AbortSignal): Promise<number[]>;
-    find(collectionId: string, cursor?: number, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<OperationIndexEntry>>;
-    /**
-     * Get all operations for a specific document, ordered by ordinal.
-     * Used for retroactive sync when a document is added to a collection.
-     */
-    get(documentId: string, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<OperationIndexEntry>>;
-    getSinceOrdinal(ordinal: number, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<OperationWithContext>>;
-    getLatestTimestampForCollection(collectionId: string, signal?: AbortSignal): Promise<string | null>;
-    /**
-     * Get all collection memberships for the given document IDs.
-     * Returns a map of documentId to array of collection IDs.
-     */
-    getCollectionsForDocuments(documentIds: string[]): Promise<Record<string, string[]>>;
-}
-export interface DocumentCollectionTable {
-    documentId: string;
-    collectionId: string;
-    joinedOrdinal: bigint;
-    leftOrdinal: bigint | null;
-}
-export interface OperationIndexOperationTable {
-    ordinal: Generated<number>;
-    opId: string;
-    documentId: string;
-    documentType: string;
-    scope: string;
-    branch: string;
-    timestampUtcMs: string;
-    writeTimestampUtcMs: Generated<Date>;
-    index: number;
-    skip: number;
-    hash: string;
-    action: unknown;
-    sourceRemote: Generated<string>;
-}
-export type DocumentCollectionRow = Selectable<DocumentCollectionTable>;
-export type InsertableDocumentCollection = Insertable<DocumentCollectionTable>;
-export type UpdateableDocumentCollection = Updateable<DocumentCollectionTable>;
-export type OperationIndexOperationRow = Selectable<OperationIndexOperationTable>;
-export type InsertableOperationIndexOperation = Insertable<OperationIndexOperationTable>;
-export type UpdateableOperationIndexOperation = Updateable<OperationIndexOperationTable>;
-export declare function driveCollectionId(branch: string, driveId: string): string;
-//# sourceMappingURL=operation-index-types.d.ts.map