@powerhousedao/reactor 5.0.0-staging.9 → 5.0.1-staging.1

package/dist/src/cache/lru/lru-tracker.js

@@ -0,0 +1,96 @@
+class LRUNode {
+    key;
+    prev;
+    next;
+    constructor(key) {
+        this.key = key;
+        this.prev = undefined;
+        this.next = undefined;
+    }
+}
+export class LRUTracker {
+    map;
+    head;
+    tail;
+    constructor() {
+        this.map = new Map();
+        this.head = undefined;
+        this.tail = undefined;
+    }
+    get size() {
+        return this.map.size;
+    }
+    touch(key) {
+        const node = this.map.get(key);
+        if (node) {
+            this.moveToFront(node);
+        }
+        else {
+            this.addToFront(key);
+        }
+    }
+    evict() {
+        if (!this.tail) {
+            return undefined;
+        }
+        const key = this.tail.key;
+        this.remove(key);
+        return key;
+    }
+    remove(key) {
+        const node = this.map.get(key);
+        if (!node) {
+            return;
+        }
+        this.removeNode(node);
+        this.map.delete(key);
+    }
+    clear() {
+        this.map.clear();
+        this.head = undefined;
+        this.tail = undefined;
+    }
+    addToFront(key) {
+        const node = new LRUNode(key);
+        this.map.set(key, node);
+        if (!this.head) {
+            this.head = node;
+            this.tail = node;
+        }
+        else {
+            node.next = this.head;
+            this.head.prev = node;
+            this.head = node;
+        }
+    }
+    moveToFront(node) {
+        if (node === this.head) {
+            return;
+        }
+        this.removeNode(node);
+        node.prev = undefined;
+        node.next = this.head;
+        if (this.head) {
+            this.head.prev = node;
+        }
+        this.head = node;
+        if (!this.tail) {
+            this.tail = node;
+        }
+    }
+    removeNode(node) {
+        if (node.prev) {
+            node.prev.next = node.next;
+        }
+        else {
+            this.head = node.next;
+        }
+        if (node.next) {
+            node.next.prev = node.prev;
+        }
+        else {
+            this.tail = node.prev;
+        }
+    }
+}
+//# sourceMappingURL=lru-tracker.js.map

package/dist/src/cache/lru/lru-tracker.js.map

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

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

@@ -0,0 +1,42 @@
+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=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/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/types.js

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

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

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

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

@@ -0,0 +1,83 @@
+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

@@ -0,0 +1 @@
+{"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

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

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

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

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

@@ -0,0 +1,103 @@
+import type { Action, DocumentModelModule, PHDocument } from "document-model";
+import type { IReactor } from "../core/types.js";
+import { type IJobAwaiter } from "../shared/awaiter.js";
+import { type JobInfo, type PagedResults, type PagingOptions, type PropagationMode, type SearchFilter, type ViewFilter } from "../shared/types.js";
+import type { ISigner } from "../signer/types.js";
+import type { IReactorSubscriptionManager } from "../subs/types.js";
+import type { DocumentChangeEvent, 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 reactor;
+    private signer;
+    private subscriptionManager;
+    private jobAwaiter;
+    constructor(reactor: IReactor, signer: ISigner, subscriptionManager: IReactorSubscriptionManager, jobAwaiter: IJobAwaiter);
+    /**
+     * Retrieves a list of document model modules.
+     */
+    getDocumentModels(namespace?: string, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<DocumentModelModule>>;
+    /**
+     * 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(document: PHDocument, parentIdentifier?: string, signal?: AbortSignal): Promise<PHDocument>;
+    /**
+     * Creates an empty document and waits for completion
+     */
+    createEmpty<TDocument extends PHDocument>(documentType: string, parentIdentifier?: string, signal?: AbortSignal): Promise<TDocument>;
+    /**
+     * Applies a list of actions to a document and waits for completion
+     */
+    mutate<TDocument extends PHDocument>(documentIdentifier: string, actions: Action[], view?: ViewFilter, signal?: AbortSignal): Promise<TDocument>;
+    /**
+     * Submits a list of actions to a document
+     */
+    mutateAsync(documentIdentifier: string, actions: Action[], view?: ViewFilter, signal?: AbortSignal): Promise<JobInfo>;
+    /**
+     * Renames a document and waits for completion
+     */
+    rename(documentIdentifier: string, name: string, view?: ViewFilter, signal?: AbortSignal): Promise<PHDocument>;
+    /**
+     * Adds multiple documents as children to another and waits for completion
+     */
+    addChildren(parentIdentifier: string, documentIdentifiers: string[], view?: ViewFilter, signal?: AbortSignal): Promise<PHDocument>;
+    /**
+     * Removes multiple documents as children from another and waits for completion
+     */
+    removeChildren(parentIdentifier: string, documentIdentifiers: string[], view?: ViewFilter, signal?: AbortSignal): Promise<PHDocument>;
+    /**
+     * Moves multiple documents from one parent to another and waits for completion
+     */
+    moveChildren(sourceParentIdentifier: string, targetParentIdentifier: string, documentIdentifiers: string[], view?: ViewFilter, 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

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

package/dist/src/client/reactor-client.js

@@ -0,0 +1,184 @@
+import {} from "../shared/awaiter.js";
+import {} from "../shared/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 class ReactorClient {
+    reactor;
+    signer;
+    subscriptionManager;
+    jobAwaiter;
+    constructor(reactor, signer, subscriptionManager, jobAwaiter) {
+        this.reactor = reactor;
+        this.signer = signer;
+        this.subscriptionManager = subscriptionManager;
+        this.jobAwaiter = jobAwaiter;
+    }
+    /**
+     * Retrieves a list of document model modules.
+     */
+    async getDocumentModels(namespace, paging, signal) {
+        return this.reactor.getDocumentModels(namespace, paging, signal);
+    }
+    /**
+     * Retrieves a specific PHDocument
+     */
+    async get(identifier, view, signal) {
+        // First try to get by ID
+        try {
+            return await this.reactor.get(identifier, view, signal);
+        }
+        catch (error) {
+            // If failed, try to get by slug
+            return await this.reactor.getBySlug(identifier, view, signal);
+        }
+    }
+    /**
+     * Retrieves children of a document
+     */
+    async getChildren(parentIdentifier, view, paging, signal) {
+        throw new Error("Method not implemented.");
+    }
+    /**
+     * Retrieves parents of a document
+     */
+    async getParents(childIdentifier, view, paging, signal) {
+        throw new Error("Method not implemented.");
+    }
+    /**
+     * Filters documents by criteria and returns a list of them
+     */
+    async find(search, view, paging, signal) {
+        return this.reactor.find(search, view, paging, signal);
+    }
+    /**
+     * Creates a document and waits for completion
+     */
+    async create(document, parentIdentifier, signal) {
+        throw new Error("Method not implemented.");
+    }
+    /**
+     * Creates an empty document and waits for completion
+     */
+    async createEmpty(documentType, parentIdentifier, signal) {
+        throw new Error("Method not implemented.");
+    }
+    /**
+     * Applies a list of actions to a document and waits for completion
+     */
+    async mutate(documentIdentifier, actions, view, signal) {
+        const jobInfo = await this.reactor.mutate(documentIdentifier, actions);
+        await this.waitForJob(jobInfo, signal);
+        const document = await this.get(documentIdentifier, view, signal);
+        return document.document;
+    }
+    /**
+     * Submits a list of actions to a document
+     */
+    async mutateAsync(documentIdentifier, actions, view, signal) {
+        // Sign actions with the required signer
+        const signedActions = await Promise.all(actions.map(async (action) => {
+            const signature = await this.signer.sign(action, signal);
+            return {
+                ...action,
+                context: {
+                    ...action.context,
+                    signer: {
+                        user: {
+                            address: signature[0],
+                            networkId: "",
+                            chainId: 0,
+                        },
+                        app: {
+                            name: "",
+                            key: "",
+                        },
+                        signatures: [signature],
+                    },
+                },
+            };
+        }));
+        // Note: reactor.mutate doesn't use view or signal currently
+        return this.reactor.mutate(documentIdentifier, signedActions);
+    }
+    /**
+     * Renames a document and waits for completion
+     */
+    async rename(documentIdentifier, name, view, signal) {
+        throw new Error("Method not implemented.");
+    }
+    /**
+     * Adds multiple documents as children to another and waits for completion
+     */
+    async addChildren(parentIdentifier, documentIdentifiers, view, signal) {
+        // Call reactor.addChildren to get JobInfo
+        const jobInfo = await this.reactor.addChildren(parentIdentifier, documentIdentifiers, view, signal);
+        // Wait for job completion
+        await this.waitForJob(jobInfo, signal);
+        // Fetch and return updated parent document
+        const result = await this.get(parentIdentifier, view, signal);
+        return result.document;
+    }
+    /**
+     * Removes multiple documents as children from another and waits for completion
+     */
+    async removeChildren(parentIdentifier, documentIdentifiers, view, signal) {
+        // Call reactor.removeChildren to get JobInfo
+        const jobInfo = await this.reactor.removeChildren(parentIdentifier, documentIdentifiers, view, signal);
+        // Wait for job completion
+        await this.waitForJob(jobInfo, signal);
+        // Fetch and return updated parent document
+        const result = await this.get(parentIdentifier, view, signal);
+        return result.document;
+    }
+    /**
+     * Moves multiple documents from one parent to another and waits for completion
+     */
+    async moveChildren(sourceParentIdentifier, targetParentIdentifier, documentIdentifiers, view, signal) {
+        throw new Error("Method not implemented.");
+    }
+    /**
+     * Deletes a document and waits for completion
+     */
+    async deleteDocument(identifier, propagate, signal) {
+        // Call reactor.deleteDocument to get JobInfo
+        const jobInfo = await this.reactor.deleteDocument(identifier, propagate, signal);
+        // Wait for job completion
+        await this.waitForJob(jobInfo, signal);
+        // Return void
+        return;
+    }
+    /**
+     * Deletes documents and waits for completion
+     */
+    async deleteDocuments(identifiers, propagate, signal) {
+        throw new Error("Method not implemented.");
+    }
+    /**
+     * Retrieves the status of a job
+     */
+    async getJobStatus(jobId, signal) {
+        return this.reactor.getJobStatus(jobId, signal);
+    }
+    /**
+     * Waits for a job to complete
+     */
+    async waitForJob(jobId, signal) {
+        const id = typeof jobId === "string" ? jobId : jobId.id;
+        return this.jobAwaiter.waitForJob(id, signal);
+    }
+    /**
+     * Subscribes to changes for documents matching specified filters
+     */
+    subscribe(search, callback, view) {
+        throw new Error("Method not implemented.");
+    }
+}
+//# sourceMappingURL=reactor-client.js.map

package/dist/src/client/reactor-client.js.map

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