@powerhousedao/reactor 6.0.0-dev.13 → 6.0.0-dev.130

package/dist/src/cache/write/interfaces.d.ts

@@ -1,83 +0,0 @@
-import type { PHDocument } from "document-model";
-/**
- * IWriteCache is a write-side projection that optimizes document state retrieval
- * for the job executor. This is separate from IDocumentView (read-side projection) which optimizes
- * queries and searches.
- */
-export interface IWriteCache {
-    /**
-     * Retrieves or builds the document at the specified revision.
-     * If targetRevision is not provided, retrieves the latest state.
-     *
-     * @param documentId - The document identifier
-     * @param scope - Operation scope
-     * @param branch - Branch name
-     * @param targetRevision - The exact revision to retrieve (optional, defaults to latest)
-     * @param signal - Optional abort signal to cancel the operation
-     * @returns The complete document at the specified revision
-     *
-     * @example
-     * ```typescript
-     * // Get latest document state
-     * const doc = await cache.getState(docId, 'global', 'main');
-     *
-     * // Get document at specific revision
-     * const doc = await cache.getState(docId, 'global', 'main', 42);
-     * ```
-     */
-    getState(documentId: string, scope: string, branch: string, targetRevision?: number, signal?: AbortSignal): Promise<PHDocument>;
-    /**
-     * Stores a document snapshot in the cache at the specified revision.
-     * The document will be deep copied to prevent external mutations.
-     *
-     * @param documentId - The document identifier
-     * @param scope - Operation scope
-     * @param branch - Branch name
-     * @param revision - The revision this document represents
-     * @param document - The complete document to cache
-     *
-     * @example
-     * ```typescript
-     * cache.putState(docId, 'global', 'main', 42, document);
-     * ```
-     */
-    putState(documentId: string, scope: string, branch: string, revision: number, document: PHDocument): void;
-    /**
-     * Invalidates (removes) cached entries for a document stream.
-     *
-     * - If only documentId is provided: invalidates all scopes and branches for that document
-     * - If documentId + scope provided: invalidates all branches for that document and scope
-     * - If all parameters provided: invalidates the specific stream
-     *
-     * @param documentId - The document identifier
-     * @param scope - Optional scope to narrow invalidation
-     * @param branch - Optional branch to narrow invalidation
-     * @returns Number of ring buffers evicted
-     *
-     * @example
-     * ```typescript
-     * // Invalidate all streams for a document
-     * cache.invalidate(docId);
-     *
-     * // Invalidate all branches for a specific scope
-     * cache.invalidate(docId, 'global');
-     *
-     * // Invalidate specific stream
-     * cache.invalidate(docId, 'global', 'main');
-     * ```
-     */
-    invalidate(documentId: string, scope?: string, branch?: string): number;
-    /**
-     * Clears all cached data from the in-memory cache.
-     */
-    clear(): void;
-    /**
-     * Performs startup initialization.
-     */
-    startup(): Promise<void>;
-    /**
-     * Performs graceful shutdown.
-     */
-    shutdown(): Promise<void>;
-}
-//# sourceMappingURL=interfaces.d.ts.map

package/dist/src/cache/write/interfaces.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../../src/cache/write/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CACN,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,CAAC;IAEvB;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CACN,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,UAAU,GACnB,IAAI,CAAC;IAER;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAExE;;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/write/interfaces.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=interfaces.js.map

package/dist/src/cache/write/interfaces.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../src/cache/write/interfaces.ts"],"names":[],"mappings":""}

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

@@ -1,42 +0,0 @@
-import type { PHDocument } from "document-model";
-/**
- * Configuration options for the write cache
- */
-export type WriteCacheConfig = {
-    /** Maximum number of document streams to cache (LRU eviction). Default: 1000 */
-    maxDocuments: number;
-    /** Number of snapshots to keep in each document's ring buffer. Default: 10 */
-    ringBufferSize: number;
-    /** Persist a keyframe snapshot every N revisions. Default: 10 */
-    keyframeInterval: number;
-};
-/**
- * Unique identifier for a document stream
- */
-export type DocumentStreamKey = {
-    /** Document identifier */
-    documentId: string;
-    /** Operation scope */
-    scope: string;
-    /** Branch name */
-    branch: string;
-};
-/**
- * A cached document snapshot at a specific revision
- */
-export type CachedSnapshot = {
-    /** The revision number of this snapshot */
-    revision: number;
-    /** The document state at this revision */
-    document: PHDocument;
-};
-/**
- * Serialized keyframe snapshot for K/V store persistence
- */
-export type KeyframeSnapshot = {
-    /** The revision number of this keyframe */
-    revision: number;
-    /** Serialized document state */
-    document: string;
-};
-//# sourceMappingURL=write-cache-types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"write-cache-types.d.ts","sourceRoot":"","sources":["../../../src/cache/write-cache-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gFAAgF;IAChF,YAAY,EAAE,MAAM,CAAC;IAErB,8EAA8E;IAC9E,cAAc,EAAE,MAAM,CAAC;IAEvB,iEAAiE;IACjE,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IAEnB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IAEd,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IAEjB,0CAA0C;IAC1C,QAAQ,EAAE,UAAU,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IAEjB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/dist/src/cache/write-cache-types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=write-cache-types.js.map

package/dist/src/cache/write-cache-types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"write-cache-types.js","sourceRoot":"","sources":["../../../src/cache/write-cache-types.ts"],"names":[],"mappings":""}

package/dist/src/client/reactor-client.d.ts

@@ -1,117 +0,0 @@
-import type { Action, DocumentModelModule, ISigner, PHDocument } from "document-model";
-import type { ILogger } from "#logging/types.js";
-import type { IReactor } from "../core/types.js";
-import { type IJobAwaiter } from "../shared/awaiter.js";
-import { PropagationMode, type JobInfo, type PagedResults, type PagingOptions, type SearchFilter, type ViewFilter } from "../shared/types.js";
-import type { IDocumentIndexer } from "../storage/interfaces.js";
-import type { IReactorSubscriptionManager } from "../subs/types.js";
-import { type CreateDocumentOptions, type DocumentChangeEvent, type IReactorClient } from "./types.js";
-/**
- * ReactorClient implementation that wraps lower-level APIs to provide
- * a simpler interface for document operations.
- *
- * Features:
- * - Wraps Jobs with Promises for easier async handling
- * - Manages signing of submitted Action objects
- * - Provides quality-of-life functions for common tasks
- * - Wraps subscription interface with ViewFilters
- */
-export declare class ReactorClient implements IReactorClient {
-    private logger;
-    private reactor;
-    private signer;
-    private subscriptionManager;
-    private jobAwaiter;
-    private documentIndexer;
-    constructor(logger: ILogger, reactor: IReactor, signer: ISigner, subscriptionManager: IReactorSubscriptionManager, jobAwaiter: IJobAwaiter, documentIndexer: IDocumentIndexer);
-    /**
-     * Retrieves a list of document model modules.
-     */
-    getDocumentModelModules(namespace?: string, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<DocumentModelModule>>;
-    /**
-     * Retrieves a specific document model module by document type.
-     *
-     * @param documentType - The document type identifier
-     * @returns The document model module
-     */
-    getDocumentModelModule(documentType: string): Promise<DocumentModelModule<any>>;
-    /**
-     * Retrieves a specific PHDocument
-     */
-    get<TDocument extends PHDocument>(identifier: string, view?: ViewFilter, signal?: AbortSignal): Promise<{
-        document: TDocument;
-        childIds: string[];
-    }>;
-    /**
-     * Retrieves children of a document
-     */
-    getChildren(parentIdentifier: string, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<PHDocument>>;
-    /**
-     * Retrieves parents of a document
-     */
-    getParents(childIdentifier: string, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<PHDocument>>;
-    /**
-     * Filters documents by criteria and returns a list of them
-     */
-    find(search: SearchFilter, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<PHDocument>>;
-    /**
-     * Creates a document and waits for completion
-     */
-    create<TDocument extends PHDocument = PHDocument>(document: PHDocument, parentIdentifier?: string, signal?: AbortSignal): Promise<TDocument>;
-    /**
-     * Creates an empty document and waits for completion
-     */
-    createEmpty<TDocument extends PHDocument>(documentModelType: string, options?: CreateDocumentOptions, signal?: AbortSignal): Promise<TDocument>;
-    /**
-     * Creates an empty document in a drive as a single batched operation.
-     */
-    createDocumentInDrive<TDocument extends PHDocument>(driveId: string, document: PHDocument, parentFolder?: string, signal?: AbortSignal): Promise<TDocument>;
-    /**
-     * Applies a list of actions to a document and waits for completion
-     */
-    execute<TDocument extends PHDocument>(documentIdentifier: string, branch: string, actions: Action[], signal?: AbortSignal): Promise<TDocument>;
-    /**
-     * Submits a list of actions to a document
-     */
-    executeAsync(documentIdentifier: string, branch: string, actions: Action[], signal?: AbortSignal): Promise<JobInfo>;
-    /**
-     * Renames a document and waits for completion
-     */
-    rename(documentIdentifier: string, name: string, branch?: string, signal?: AbortSignal): Promise<PHDocument>;
-    /**
-     * Adds multiple documents as children to another and waits for completion
-     */
-    addChildren(parentIdentifier: string, documentIdentifiers: string[], branch?: string, signal?: AbortSignal): Promise<PHDocument>;
-    /**
-     * Removes multiple documents as children from another and waits for completion
-     */
-    removeChildren(parentIdentifier: string, documentIdentifiers: string[], branch?: string, signal?: AbortSignal): Promise<PHDocument>;
-    /**
-     * Moves multiple documents from one parent to another and waits for completion
-     */
-    moveChildren(sourceParentIdentifier: string, targetParentIdentifier: string, documentIdentifiers: string[], branch?: string, signal?: AbortSignal): Promise<{
-        source: PHDocument;
-        target: PHDocument;
-    }>;
-    /**
-     * Deletes a document and waits for completion
-     */
-    deleteDocument(identifier: string, propagate?: PropagationMode, signal?: AbortSignal): Promise<void>;
-    /**
-     * Deletes documents and waits for completion
-     */
-    deleteDocuments(identifiers: string[], propagate?: PropagationMode, signal?: AbortSignal): Promise<void>;
-    /**
-     * Retrieves the status of a job
-     */
-    getJobStatus(jobId: string, signal?: AbortSignal): Promise<JobInfo>;
-    /**
-     * Waits for a job to complete
-     */
-    waitForJob(jobId: string | JobInfo, signal?: AbortSignal): Promise<JobInfo>;
-    /**
-     * Subscribes to changes for documents matching specified filters
-     */
-    subscribe(search: SearchFilter, callback: (event: DocumentChangeEvent) => void, view?: ViewFilter): () => void;
-}
-//# sourceMappingURL=reactor-client.d.ts.map

package/dist/src/client/reactor-client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"reactor-client.d.ts","sourceRoot":"","sources":["../../../src/client/reactor-client.ts"],"names":[],"mappings":"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"}