@powerhousedao/reactor 6.0.0-dev.7 → 6.0.0-dev.77

package/dist/src/shared/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/shared/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEnC,UAAU,EAAE,MAAM,EAAE,eAAe,GAAE,MAAM,GAAG,IAAW;CAYtE;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,KAAK,EAAE,MAAM,CAAC;gBAElB,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAU9C;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEnB,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQ/C;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,SAAS,EAAE,MAAM,CAAC;gBAEtB,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAWzE;AAED;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,SAAgB,YAAY,EAAE,MAAM,CAAC;gBAEzB,YAAY,EAAE,MAAM;CAOjC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/shared/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEnC,UAAU,EAAE,MAAM,EAAE,eAAe,GAAE,MAAM,GAAG,IAAW;IAarE,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB;CAG9D;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,KAAK,EAAE,MAAM,CAAC;gBAElB,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAU9C;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEnB,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQ/C;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,SAAS,EAAE,MAAM,CAAC;gBAEtB,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAWzE;AAED;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,SAAgB,YAAY,EAAE,MAAM,CAAC;gBAEzB,YAAY,EAAE,MAAM;CAOjC;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,UAAU,EAAE,MAAM;IAQ9B,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB;CAG/D"}

package/dist/src/shared/factories.d.ts

@@ -10,7 +10,11 @@ export declare function createShutdownStatus(isShutdown: boolean): ShutdownStatu
  * Factory method to create a ShutdownStatus that can be updated
  *
  * @param initialState - Initial shutdown state (default: false)
- * @returns A tuple of [ShutdownStatus, setter function]
+ * @returns A tuple of [ShutdownStatus, setShutdown function, setCompleted function]
  */
-export declare function createMutableShutdownStatus(initialState?: boolean): [ShutdownStatus, (value: boolean) => void];
+export declare function createMutableShutdownStatus(initialState?: boolean): [
+    ShutdownStatus,
+    (value: boolean) => void,
+    (completed: Promise<void>) => void
+];
 //# sourceMappingURL=factories.d.ts.map

package/dist/src/shared/factories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factories.d.ts","sourceRoot":"","sources":["../../../src/shared/factories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,OAAO,GAAG,cAAc,CAQxE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,UAAQ,GACnB,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,CAc5C"}
+{"version":3,"file":"factories.d.ts","sourceRoot":"","sources":["../../../src/shared/factories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,OAAO,GAAG,cAAc,CASxE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,UAAQ,GACnB;IACD,cAAc;IACd,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI;IACxB,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI;CACnC,CAsBA"}

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

@@ -24,6 +24,13 @@ export type ShutdownStatus = {
      * In the case of a server process, a graceful shutdown period should be allowed for the system to finish its work.
      */
     get isShutdown(): boolean;
+    /**
+     * A promise that resolves when the shutdown process is complete.
+     *
+     * For server environments, await this promise to ensure all active jobs finish
+     * before exiting the process.
+     */
+    completed: Promise<void>;
 };
 /**
  * Enum that determines deletion propagation.
@@ -39,6 +46,20 @@ export declare enum RelationshipChangeType {
     Added = "added",
     Removed = "removed"
 }
+/**
+ * Batch-specific metadata always present on every job.
+ * Single jobs get a unique batchId and batchJobIds of [jobId].
+ */
+export type BatchMeta = {
+    batchId: string;
+    batchJobIds: string[];
+};
+/**
+ * Metadata that flows through the job lifecycle.
+ * Always includes batch fields; callers may add additional properties.
+ */
+export type JobMeta = BatchMeta & Record<string, unknown>;
+import type { Job } from "../queue/types.js";
 /**
  * Describes the current state of a job.
  */
@@ -55,9 +76,13 @@ export type JobInfo = {
      */
     consistencyToken: ConsistencyToken;
     /**
-     * Optional metadata that flows through the job lifecycle.
+     * Metadata that flows through the job lifecycle.
+     */
+    meta: JobMeta;
+    /**
+     * The full job object, populated on failure for debugging purposes.
      */
-    meta?: Record<string, unknown>;
+    job?: Job;
 };
 /**
  * Job execution statuses
@@ -67,10 +92,10 @@ export declare enum JobStatus {
     PENDING = "PENDING",
     /** Job is currently being executed */
     RUNNING = "RUNNING",
-    /** Operations have been written to the operation store (OPERATION_WRITTEN event) */
-    WRITE_COMPLETED = "WRITE_COMPLETED",
-    /** Read models have finished indexing operations (OPERATIONS_READY event) */
-    READ_MODELS_READY = "READ_MODELS_READY",
+    /** Operations have been written to the operation store (JOB_WRITE_READY event) */
+    WRITE_READY = "WRITE_READY",
+    /** Read models have finished indexing operations (JOB_READ_READY event) */
+    READ_READY = "READ_READY",
     /** Job failed (may be retried) */
     FAILED = "FAILED"
 }
@@ -109,6 +134,7 @@ export type PagedResults<T> = {
     options: PagingOptions;
     next?: () => Promise<PagedResults<T>>;
     nextCursor?: string;
+    totalCount?: number;
 };
 /**
  * A string key in the format `documentId:scope:branch` used to identify a consistency checkpoint.

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,kBAAkB,yCAAyC,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;;;;;OAQG;IACH,IAAI,UAAU,IAAI,OAAO,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,oBAAY,eAAe;IACzB,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,sBAAsB;IAChC,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,GAAG,CAAC;IAEb;;OAEG;IACH,gBAAgB,EAAE,gBAAgB,CAAC;IAEnC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF;;GAEG;AACH,oBAAY,SAAS;IACnB,wCAAwC;IACxC,OAAO,YAAY;IACnB,sCAAsC;IACtC,OAAO,YAAY;IACnB,oFAAoF;IACpF,eAAe,oBAAoB;IACnC,6EAA6E;IAC7E,iBAAiB,sBAAsB;IACvC,kCAAkC;IAClC,MAAM,WAAW;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAC5B,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IAEvB,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,CAAC,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,qBAAqB,EAAE,CAAC;CACtC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shared/types.ts"],"names":[],"mappings":"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"}

package/dist/src/signer/passthrough-signer.d.ts

@@ -4,7 +4,7 @@ import type { ISigner, Signature } from "document-model";
  * Used when signing is not required.
  */
 export declare class PassthroughSigner implements ISigner {
-    publicKey(): Promise<JsonWebKey>;
+    publicKey: CryptoKey;
     sign(): Promise<Uint8Array>;
     verify(): Promise<void>;
     signAction(): Promise<Signature>;

package/dist/src/signer/passthrough-signer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"passthrough-signer.d.ts","sourceRoot":"","sources":["../../../src/signer/passthrough-signer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,OAAO;IAC/C,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC;IAIhC,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IAI3B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC;CAGjC"}
+{"version":3,"file":"passthrough-signer.d.ts","sourceRoot":"","sources":["../../../src/signer/passthrough-signer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,OAAO;IAC/C,SAAS,EAAoB,SAAS,CAAC;IAEvC,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IAI3B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC;CAGjC"}

package/dist/src/storage/interfaces.d.ts

@@ -1,39 +1,86 @@
-import type { Operation, PHDocument } from "document-model";
-import type { ConsistencyToken } from "../shared/types.js";
+import type { Operation, OperationWithContext, PHDocument } from "document-model";
+import type { ConsistencyToken, PagedResults, PagingOptions } from "../shared/types.js";
+import type { ChannelErrorSource } from "../sync/types.js";
 import type { RemoteCursor, RemoteRecord } from "../sync/types.js";
-export type OperationContext = {
-    documentId: string;
-    documentType: string;
-    scope: string;
-    branch: string;
-    resultingState?: string;
-    ordinal: number;
-};
-export type OperationWithContext = {
-    operation: Operation;
-    context: OperationContext;
-};
+export type { PagedResults, PagingOptions } from "../shared/types.js";
+/**
+ * Thrown when an operation with the same identity already exists in the store.
+ */
 export declare class DuplicateOperationError extends Error {
     constructor(description: string);
 }
+/**
+ * Thrown when a concurrent write conflict is detected during an atomic apply.
+ */
 export declare class OptimisticLockError extends Error {
     constructor(message: string);
 }
+/**
+ * Thrown when the caller-provided revision does not match the current
+ * stored revision, indicating a stale read.
+ */
 export declare class RevisionMismatchError extends Error {
     constructor(expected: number, actual: number);
 }
+/**
+ * A write transaction passed to {@link IOperationStore.apply}. Accumulates
+ * operations that are committed atomically when the callback returns.
+ */
 export interface AtomicTxn {
+    /** Stages one or more operations to be written as part of this transaction. */
     addOperations(...operations: Operation[]): void;
 }
+/**
+ * Per-scope revision map for a document, used to reconstruct the header
+ * revision field and lastModified timestamp.
+ */
 export type DocumentRevisions = {
     /** Map of scope to operation index for that scope */
     revision: Record<string, number>;
     /** Latest timestamp across revisions */
     latestTimestamp: string;
 };
+/**
+ * Append-only store for document operations. Operations are partitioned by
+ * (documentId, scope, branch) and ordered by a monotonic revision index.
+ */
 export interface IOperationStore {
+    /**
+     * Atomically appends operations for a single document/scope/branch.
+     * The provided revision must match the current head; otherwise a
+     * {@link RevisionMismatchError} is thrown.
+     *
+     * @param documentId - The document id
+     * @param documentType - The document type identifier
+     * @param scope - The operation scope (e.g. "global", "local")
+     * @param branch - The branch name
+     * @param revision - Expected current revision (optimistic lock)
+     * @param fn - Callback that stages operations via {@link AtomicTxn}
+     * @param signal - Optional abort signal to cancel the request
+     */
     apply(documentId: string, documentType: string, scope: string, branch: string, revision: number, fn: (txn: AtomicTxn) => void | Promise<void>, signal?: AbortSignal): Promise<void>;
-    getSince(documentId: string, scope: string, branch: string, revision: number, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<Operation>>;
+    /**
+     * Returns operations for a document/scope/branch whose index is greater
+     * than the given revision.
+     *
+     * @param documentId - The document id
+     * @param scope - The operation scope
+     * @param branch - The branch name
+     * @param revision - Return operations after this revision index
+     * @param filter - Optional filters (action types, timestamp range)
+     * @param paging - Optional paging options for cursor-based pagination
+     * @param signal - Optional abort signal to cancel the request
+     */
+    getSince(documentId: string, scope: string, branch: string, revision: number, filter?: OperationFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<Operation>>;
+    /**
+     * Returns operations across all documents whose auto-increment store id
+     * is greater than the given id. Used by read models and sync to catch up
+     * on operations they may have missed.
+     *
+     * @param id - Return operations with store id greater than this value
+     * @param paging - Optional paging options for cursor-based pagination
+     * @param signal - Optional abort signal to cancel the request
+     */
     getSinceId(id: number, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<OperationWithContext>>;
     /**
      * Gets operations that may conflict with incoming operations during a load.
@@ -59,51 +106,92 @@ export interface IOperationStore {
      */
     getRevisions(documentId: string, branch: string, signal?: AbortSignal): Promise<DocumentRevisions>;
 }
+/**
+ * Stores periodic document snapshots (keyframes) so that document state
+ * can be reconstructed without replaying the full operation history.
+ */
 export interface IKeyframeStore {
+    /**
+     * Stores a document snapshot at a specific revision.
+     *
+     * @param documentId - The document id
+     * @param scope - The operation scope
+     * @param branch - The branch name
+     * @param revision - The operation index this snapshot corresponds to
+     * @param document - The full document state to persist
+     * @param signal - Optional abort signal to cancel the request
+     */
     putKeyframe(documentId: string, scope: string, branch: string, revision: number, document: PHDocument, signal?: AbortSignal): Promise<void>;
+    /**
+     * Finds the keyframe closest to (but not exceeding) the target revision.
+     * Returns undefined if no keyframe exists for this document/scope/branch.
+     *
+     * @param documentId - The document id
+     * @param scope - The operation scope
+     * @param branch - The branch name
+     * @param targetRevision - The desired revision upper bound
+     * @param signal - Optional abort signal to cancel the request
+     */
     findNearestKeyframe(documentId: string, scope: string, branch: string, targetRevision: number, signal?: AbortSignal): Promise<{
         revision: number;
         document: PHDocument;
     } | undefined>;
+    /**
+     * Deletes keyframes for a document. Optionally scoped to a specific
+     * scope and/or branch.
+     *
+     * @param documentId - The document id
+     * @param scope - Optional scope filter; omit to delete across all scopes
+     * @param branch - Optional branch filter; omit to delete across all branches
+     * @param signal - Optional abort signal to cancel the request
+     * @returns The number of keyframes deleted
+     */
     deleteKeyframes(documentId: string, scope?: string, branch?: string, signal?: AbortSignal): Promise<number>;
 }
+/**
+ * Filters applied when reading document state from {@link IDocumentView}.
+ */
 export interface ViewFilter {
+    /** Branch to read from. Defaults to the main branch when omitted. */
     branch?: string;
+    /** Scopes to include. When omitted, all scopes are included. */
     scopes?: string[];
+    /** Exclude operations originating from this remote name. */
+    excludeSourceRemote?: string;
 }
+/**
+ * Criteria for searching documents in storage-backed read models.
+ * All provided fields are combined with AND logic.
+ */
 export interface SearchFilter {
+    /** Filter by document type identifier. */
     documentType?: string;
+    /** Filter by parent document id. */
     parentId?: string;
+    /** Filter by arbitrary key-value identifiers stored on the document. */
     identifiers?: Record<string, any>;
+    /** When true, include soft-deleted documents in results. */
     includeDeleted?: boolean;
 }
-export interface PagingOptions {
-    cursor?: string;
-    limit?: number;
-}
-export interface PagedResults<T> {
-    items: T[];
-    nextCursor?: string;
-    hasMore: boolean;
-}
-export interface DocumentSnapshot {
-    id: string;
-    documentId: string;
-    slug: string | null;
-    name: string | null;
-    scope: string;
-    branch: string;
-    content: string;
-    documentType: string;
-    lastOperationIndex: number;
-    lastOperationHash: string;
-    lastUpdatedAt: Date;
-    snapshotVersion: number;
-    identifiers: string | null;
-    metadata: string | null;
-    isDeleted: boolean;
-    deletedAt: Date | null;
+/**
+ * Filter options for querying operations. When multiple filters are provided,
+ * they are combined with AND logic.
+ */
+export interface OperationFilter {
+    /** Filter by action types (OR logic within array) */
+    actionTypes?: string[];
+    /** Filter operations with timestamp >= this value (ISO string) */
+    timestampFrom?: string;
+    /** Filter operations with timestamp <= this value (ISO string) */
+    timestampTo?: string;
+    /** Filter operations with index >= this value */
+    sinceRevision?: number;
 }
+/**
+ * Materialised read model that maintains document snapshots. Snapshots are
+ * updated by indexing operations (which must include `resultingState`) and
+ * queried with optional consistency tokens for read-after-write guarantees.
+ */
 export interface IDocumentView {
     /**
      * Initializes the view.
@@ -143,6 +231,15 @@ export interface IDocumentView {
      * @param signal - Optional abort signal to cancel the request
      */
     get<TDocument extends PHDocument>(documentId: string, view?: ViewFilter, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<TDocument>;
+    /**
+     * Returns the documents with the given ids.
+     *
+     * @param documentIds - The list of document ids to get.
+     * @param view - Optional filter containing branch and scopes information
+     * @param consistencyToken - Optional token for read-after-write consistency
+     * @param signal - Optional abort signal to cancel the request
+     */
+    getMany<TDocument extends PHDocument>(documentIds: string[], view?: ViewFilter, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<TDocument[]>;
     /**
      * Returns the document with the given identifier (either id or slug).
      * Throws an error if the identifier matches both an id and a slug that refer to different documents.
@@ -174,7 +271,33 @@ export interface IDocumentView {
      * @returns The document ID or undefined if the slug doesn't exist
      */
     resolveSlug(slug: string, view?: ViewFilter, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<string | undefined>;
+    /**
+     * Resolves a list of slugs to document IDs.
+     *
+     * @param slugs - The list of slugs to resolve.
+     * @param view - Optional filter containing branch and scopes information
+     * @param consistencyToken - Optional token for read-after-write consistency
+     * @param signal - Optional abort signal to cancel the request
+     * @returns The list of document IDs
+     */
+    resolveSlugs(slugs: string[], view?: ViewFilter, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<string[]>;
+    /**
+     * Resolves an identifier (either id or slug) to a document ID.
+     * This is a lightweight alternative to getByIdOrSlug that returns just the ID
+     * without fetching the full document.
+     *
+     * @param identifier - The id or slug to resolve
+     * @param view - Optional filter containing branch and scopes information
+     * @param consistencyToken - Optional token for read-after-write consistency
+     * @param signal - Optional abort signal to cancel the request
+     * @returns The document ID
+     * @throws {Error} If document not found or identifier matches both an ID and slug referring to different documents
+     */
+    resolveIdOrSlug(identifier: string, view?: ViewFilter, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<string>;
 }
+/**
+ * A directed relationship between two documents in the document graph.
+ */
 export type DocumentRelationship = {
     sourceId: string;
     targetId: string;
@@ -183,15 +306,27 @@ export type DocumentRelationship = {
     createdAt: Date;
     updatedAt: Date;
 };
+/**
+ * A lightweight directed edge in a {@link IDocumentGraph}.
+ */
 export type DocumentGraphEdge = {
     from: string;
     to: string;
     type: string;
 };
+/**
+ * A subgraph of the document relationship graph, returned by traversal
+ * queries such as {@link IDocumentIndexer.findAncestors}.
+ */
 export interface IDocumentGraph {
     nodes: string[];
     edges: DocumentGraphEdge[];
 }
+/**
+ * Read model that maintains a directed graph of document relationships.
+ * Relationships are created and removed by indexing operations containing
+ * ADD_RELATIONSHIP and REMOVE_RELATIONSHIP actions.
+ */
 export interface IDocumentIndexer {
     /**
      * Initializes the indexer and catches up on any missed operations.
@@ -221,7 +356,7 @@ export interface IDocumentIndexer {
      * @param consistencyToken - Optional token for read-after-write consistency
      * @param signal - Optional abort signal to cancel the request
      */
-    getOutgoing(documentId: string, types?: string[], consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<DocumentRelationship[]>;
+    getOutgoing(documentId: string, types?: string[], paging?: PagingOptions, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<PagedResults<DocumentRelationship>>;
     /**
      * Returns incoming relationships to a document.
      *
@@ -230,7 +365,7 @@ export interface IDocumentIndexer {
      * @param consistencyToken - Optional token for read-after-write consistency
      * @param signal - Optional abort signal to cancel the request
      */
-    getIncoming(documentId: string, types?: string[], consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<DocumentRelationship[]>;
+    getIncoming(documentId: string, types?: string[], paging?: PagingOptions, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<PagedResults<DocumentRelationship>>;
     /**
      * Checks if a relationship exists between two documents.
      *
@@ -250,7 +385,7 @@ export interface IDocumentIndexer {
      * @param consistencyToken - Optional token for read-after-write consistency
      * @param signal - Optional abort signal to cancel the request
      */
-    getUndirectedRelationships(a: string, b: string, types?: string[], consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<DocumentRelationship[]>;
+    getUndirectedRelationships(a: string, b: string, types?: string[], paging?: PagingOptions, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<PagedResults<DocumentRelationship>>;
     /**
      * Returns all directed relationships between two documents.
      *
@@ -260,7 +395,7 @@ export interface IDocumentIndexer {
      * @param consistencyToken - Optional token for read-after-write consistency
      * @param signal - Optional abort signal to cancel the request
      */
-    getDirectedRelationships(sourceId: string, targetId: string, types?: string[], consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<DocumentRelationship[]>;
+    getDirectedRelationships(sourceId: string, targetId: string, types?: string[], paging?: PagingOptions, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<PagedResults<DocumentRelationship>>;
     /**
      * Finds a path from source to target following directed edges.
      *
@@ -290,85 +425,9 @@ export interface IDocumentIndexer {
     getRelationshipTypes(consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<string[]>;
 }
 /**
- * A consistency-aware storage interface used by the Reactor when legacy storage
- * mode is enabled. This interface provides read-after-write consistency by
- * accepting an optional consistency token on read operations.
- *
- * This is a standalone interface (not extending IDocumentStorage) because the
- * method signatures differ - consistency token is added as an optional parameter
- * to read operations.
+ * Persistent storage for sync remote configurations. Each remote represents
+ * a connection to an external system that operations can be synced with.
  */
-export interface IConsistencyAwareStorage {
-    /**
-     * Returns the document with the given id.
-     *
-     * @param id - The id of the document to get
-     * @param consistencyToken - Optional token for read-after-write consistency
-     * @param signal - Optional abort signal to cancel the request
-     */
-    get<TDocument extends PHDocument>(id: string, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<TDocument>;
-    /**
-     * Returns the document with the given slug.
-     *
-     * @param slug - The slug of the document to get
-     * @param consistencyToken - Optional token for read-after-write consistency
-     * @param signal - Optional abort signal to cancel the request
-     */
-    getBySlug<TDocument extends PHDocument>(slug: string, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<TDocument>;
-    /**
-     * Returns true if the document exists.
-     *
-     * @param id - The id of the document to check
-     * @param consistencyToken - Optional token for read-after-write consistency
-     * @param signal - Optional abort signal to cancel the request
-     */
-    exists(id: string, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<boolean>;
-    /**
-     * Finds documents by their document type.
-     *
-     * @param type - The document type to search for
-     * @param limit - Optional limit on the number of results
-     * @param cursor - Optional cursor for pagination
-     * @param consistencyToken - Optional token for read-after-write consistency
-     * @param signal - Optional abort signal to cancel the request
-     */
-    findByType(type: string, limit?: number, cursor?: string, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<{
-        documents: string[];
-        nextCursor: string | undefined;
-    }>;
-    /**
-     * Returns the children of a document.
-     *
-     * @param id - The id of the parent document
-     * @param consistencyToken - Optional token for read-after-write consistency
-     * @param signal - Optional abort signal to cancel the request
-     */
-    getChildren(id: string, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<string[]>;
-    /**
-     * Resolves slugs to document IDs.
-     *
-     * @param slugs - The slugs to resolve
-     * @param consistencyToken - Optional token for read-after-write consistency
-     * @param signal - Optional abort signal to cancel the request
-     */
-    resolveIds(slugs: string[], consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<string[]>;
-    /**
-     * Resolves document IDs to slugs.
-     *
-     * @param ids - The document IDs to resolve
-     * @param consistencyToken - Optional token for read-after-write consistency
-     * @param signal - Optional abort signal to cancel the request
-     */
-    resolveSlugs(ids: string[], consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<string[]>;
-    /**
-     * Returns all parent documents of the child document with the given id.
-     *
-     * @param childId - The id of the child document
-     * @param consistencyToken - Optional token for read-after-write consistency
-     * @param signal - Optional abort signal to cancel the request
-     */
-    getParents(childId: string, consistencyToken?: ConsistencyToken, signal?: AbortSignal): Promise<string[]>;
-}
 export interface ISyncRemoteStorage {
     /**
      * Lists all remotes.
@@ -402,6 +461,10 @@ export interface ISyncRemoteStorage {
      */
     remove(name: string, signal?: AbortSignal): Promise<void>;
 }
+/**
+ * Persistent storage for sync cursors that track inbox/outbox progress
+ * per remote. Cursors allow sync to resume from where it left off.
+ */
 export interface ISyncCursorStorage {
     /**
      * Lists all cursors for a remote.
@@ -415,10 +478,11 @@ export interface ISyncCursorStorage {
      * Gets a cursor for a remote.
      *
      * @param remoteName - The name of the remote
+     * @param cursorType - The type of cursor ("inbox" or "outbox")
      * @param signal - Optional abort signal to cancel the request
      * @returns The cursor
      */
-    get(remoteName: string, signal?: AbortSignal): Promise<RemoteCursor>;
+    get(remoteName: string, cursorType: "inbox" | "outbox", signal?: AbortSignal): Promise<RemoteCursor>;
     /**
      * Upserts a cursor.
      *
@@ -436,4 +500,54 @@ export interface ISyncCursorStorage {
      */
     remove(remoteName: string, signal?: AbortSignal): Promise<void>;
 }
+/**
+ * Serializable snapshot of a permanently failed SyncOperation.
+ */
+export type DeadLetterRecord = {
+    id: string;
+    jobId: string;
+    jobDependencies: string[];
+    remoteName: string;
+    documentId: string;
+    scopes: string[];
+    branch: string;
+    operations: OperationWithContext[];
+    errorSource: ChannelErrorSource;
+    errorMessage: string;
+};
+/**
+ * Persists dead-lettered sync operations so they survive reactor restarts.
+ */
+export interface ISyncDeadLetterStorage {
+    /**
+     * Lists dead letters for a remote, ordered by ordinal DESC (newest first).
+     *
+     * @param remoteName - The name of the remote
+     * @param paging - Optional paging options (cursor + limit)
+     * @param signal - Optional abort signal to cancel the request
+     * @returns Paged dead letter records
+     */
+    list(remoteName: string, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<DeadLetterRecord>>;
+    /**
+     * Adds a dead letter. Duplicate ids are silently ignored.
+     *
+     * @param deadLetter - The dead letter record to persist
+     * @param signal - Optional abort signal to cancel the request
+     */
+    add(deadLetter: DeadLetterRecord, signal?: AbortSignal): Promise<void>;
+    /**
+     * Removes a single dead letter by id.
+     *
+     * @param id - The dead letter id
+     * @param signal - Optional abort signal to cancel the request
+     */
+    remove(id: string, signal?: AbortSignal): Promise<void>;
+    /**
+     * Removes all dead letters for a remote.
+     *
+     * @param remoteName - The name of the remote
+     * @param signal - Optional abort signal to cancel the request
+     */
+    removeByRemote(remoteName: string, signal?: AbortSignal): Promise<void>;
+}
 //# sourceMappingURL=interfaces.d.ts.map