@powerhousedao/reactor 4.1.0-dev.12 → 4.1.0-dev.121

package/dist/src/sync/sync-manager.js

@@ -0,0 +1,196 @@
+import { OperationEventTypes, } from "../events/types.js";
+import { JobStatus, } from "../shared/types.js";
+import { JobAwaiter } from "../shared/awaiter.js";
+import { ChannelError } from "./errors.js";
+import { SyncOperation } from "./sync-operation.js";
+import { ChannelErrorSource, SyncOperationStatus } from "./types.js";
+import { createIdleHealth, filterOperations } from "./utils.js";
+export class SyncManager {
+    remoteStorage;
+    cursorStorage;
+    channelFactory;
+    _operationIndex;
+    reactor;
+    eventBus;
+    remotes;
+    awaiter;
+    isShutdown;
+    eventUnsubscribe;
+    loadJobs = new Map();
+    constructor(remoteStorage, cursorStorage, channelFactory, operationIndex, reactor, eventBus) {
+        this.remoteStorage = remoteStorage;
+        this.cursorStorage = cursorStorage;
+        this.channelFactory = channelFactory;
+        this._operationIndex = operationIndex;
+        this.reactor = reactor;
+        this.eventBus = eventBus;
+        this.remotes = new Map();
+        this.awaiter = new JobAwaiter((jobId, signal) => reactor.getJobStatus(jobId, signal));
+        this.isShutdown = false;
+    }
+    async startup() {
+        if (this.isShutdown) {
+            throw new Error("SyncManager is already shutdown and cannot be started");
+        }
+        const remoteRecords = await this.remoteStorage.list();
+        for (const record of remoteRecords) {
+            const channel = this.channelFactory.instance(record.channelConfig, this.cursorStorage);
+            const remote = {
+                name: record.name,
+                collectionId: record.collectionId,
+                filter: record.filter,
+                options: record.options,
+                channel,
+            };
+            this.remotes.set(record.name, remote);
+            this.wireChannelCallbacks(remote);
+        }
+        this.eventUnsubscribe = this.eventBus.subscribe(OperationEventTypes.OPERATION_WRITTEN, (_type, event) => this.handleOperationWritten(event));
+    }
+    shutdown() {
+        this.isShutdown = true;
+        if (this.eventUnsubscribe) {
+            this.eventUnsubscribe();
+            this.eventUnsubscribe = undefined;
+        }
+        for (const remote of this.remotes.values()) {
+            try {
+                remote.channel.shutdown();
+            }
+            catch (error) {
+                console.error(`Error shutting down channel for remote ${remote.name}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        this.remotes.clear();
+        return {
+            isShutdown: true,
+        };
+    }
+    get(name) {
+        const remote = this.remotes.get(name);
+        if (!remote) {
+            throw new Error(`Remote with name '${name}' does not exist`);
+        }
+        return remote;
+    }
+    async add(name, collectionId, channelConfig, filter = { documentId: [], scope: [], branch: "" }, options = {}) {
+        if (this.isShutdown) {
+            throw new Error("SyncManager is shutdown and cannot add remotes");
+        }
+        if (this.remotes.has(name)) {
+            throw new Error(`Remote with name '${name}' already exists`);
+        }
+        const status = {
+            push: createIdleHealth(),
+            pull: createIdleHealth(),
+        };
+        const remoteRecord = {
+            name,
+            collectionId,
+            channelConfig,
+            filter,
+            options,
+            status,
+        };
+        await this.remoteStorage.upsert(remoteRecord);
+        const channel = this.channelFactory.instance(channelConfig, this.cursorStorage);
+        const remote = {
+            name,
+            collectionId,
+            filter,
+            options,
+            channel,
+        };
+        this.remotes.set(name, remote);
+        this.wireChannelCallbacks(remote);
+        return remote;
+    }
+    async remove(name) {
+        const remote = this.remotes.get(name);
+        if (!remote) {
+            throw new Error(`Remote with name '${name}' does not exist`);
+        }
+        await this.remoteStorage.remove(name);
+        remote.channel.shutdown();
+        this.remotes.delete(name);
+    }
+    list() {
+        return Array.from(this.remotes.values());
+    }
+    wireChannelCallbacks(remote) {
+        remote.channel.inbox.onAdded((syncOp) => {
+            this.handleInboxJob(remote, syncOp);
+        });
+        remote.channel.outbox.onAdded((syncOp) => {
+            this.handleOutboxJob(remote, syncOp);
+        });
+    }
+    handleOperationWritten(event) {
+        if (this.isShutdown) {
+            return;
+        }
+        for (const remote of this.remotes.values()) {
+            const filteredOps = filterOperations(event.operations, remote.filter);
+            if (filteredOps.length === 0) {
+                continue;
+            }
+            const syncOp = new SyncOperation(crypto.randomUUID(), remote.name, filteredOps[0].context.documentId, [...new Set(filteredOps.map((op) => op.context.scope))], filteredOps[0].context.branch, filteredOps);
+            remote.channel.outbox.add(syncOp);
+        }
+    }
+    handleInboxJob(remote, syncOp) {
+        if (this.isShutdown) {
+            return;
+        }
+        void this.applyInboxJob(remote, syncOp);
+    }
+    handleOutboxJob(remote, syncOp) {
+        syncOp.on((syncOp, _prev, next) => {
+            if (next === SyncOperationStatus.Applied) {
+                remote.channel.outbox.remove(syncOp);
+            }
+            else if (next === SyncOperationStatus.Error) {
+                remote.channel.outbox.remove(syncOp);
+            }
+        });
+    }
+    async applyInboxJob(remote, syncOp) {
+        const operations = syncOp.operations.map((op) => op.operation);
+        let jobInfo;
+        try {
+            jobInfo = await this.reactor.load(syncOp.documentId, syncOp.branch, operations);
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            const channelError = new ChannelError(ChannelErrorSource.Inbox, err);
+            syncOp.failed(channelError);
+            remote.channel.deadLetter.add(syncOp);
+            remote.channel.inbox.remove(syncOp);
+            return;
+        }
+        let completedJobInfo;
+        try {
+            completedJobInfo = await this.awaiter.waitForJob(jobInfo.id);
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            const channelError = new ChannelError(ChannelErrorSource.Inbox, err);
+            syncOp.failed(channelError);
+            remote.channel.deadLetter.add(syncOp);
+            remote.channel.inbox.remove(syncOp);
+            return;
+        }
+        const jobKey = `${syncOp.documentId}:${syncOp.branch}`;
+        this.loadJobs.set(jobKey, completedJobInfo);
+        if (completedJobInfo.status === JobStatus.FAILED) {
+            const error = new ChannelError(ChannelErrorSource.Inbox, new Error(`Failed to apply operations: ${completedJobInfo.error?.message || "Unknown error"}`));
+            syncOp.failed(error);
+            remote.channel.deadLetter.add(syncOp);
+        }
+        else {
+            syncOp.executed();
+        }
+        remote.channel.inbox.remove(syncOp);
+    }
+}
+//# sourceMappingURL=sync-manager.js.map

package/dist/src/sync/sync-manager.js.map

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

package/dist/src/sync/sync-operation.d.ts

@@ -0,0 +1,28 @@
+import type { OperationWithContext } from "../storage/interfaces.js";
+import type { ChannelError } from "./errors.js";
+import { SyncOperationStatus } from "./types.js";
+type SyncOperationStatusCallback = (syncOp: SyncOperation, prev: SyncOperationStatus, next: SyncOperationStatus) => void;
+export declare class SyncOperationAggregateError extends Error {
+    errors: Error[];
+    constructor(errors: Error[]);
+}
+export declare class SyncOperation {
+    readonly id: string;
+    readonly remoteName: string;
+    readonly documentId: string;
+    readonly scopes: string[];
+    readonly branch: string;
+    readonly operations: OperationWithContext[];
+    status: SyncOperationStatus;
+    error?: ChannelError;
+    private callbacks;
+    constructor(id: string, remoteName: string, documentId: string, scopes: string[], branch: string, operations: OperationWithContext[]);
+    on(callback: SyncOperationStatusCallback): void;
+    started(): void;
+    transported(): void;
+    executed(): void;
+    failed(error: ChannelError): void;
+    private transition;
+}
+export {};
+//# sourceMappingURL=sync-operation.d.ts.map

package/dist/src/sync/sync-operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-operation.d.ts","sourceRoot":"","sources":["../../../src/sync/sync-operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,KAAK,2BAA2B,GAAG,CACjC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,mBAAmB,EACzB,IAAI,EAAE,mBAAmB,KACtB,IAAI,CAAC;AAEV,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,MAAM,EAAE,KAAK,EAAE,CAAC;gBAEJ,MAAM,EAAE,KAAK,EAAE;CAQ5B;AAED,qBAAa,aAAa;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,oBAAoB,EAAE,CAAC;IAC5C,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,CAAC,EAAE,YAAY,CAAC;IAErB,OAAO,CAAC,SAAS,CAAqC;gBAGpD,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,oBAAoB,EAAE;IAWpC,EAAE,CAAC,QAAQ,EAAE,2BAA2B,GAAG,IAAI;IAI/C,OAAO,IAAI,IAAI;IAIf,WAAW,IAAI,IAAI;IAInB,QAAQ,IAAI,IAAI;IAIhB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAKjC,OAAO,CAAC,UAAU;CAenB"}

package/dist/src/sync/sync-operation.js

@@ -0,0 +1,63 @@
+import { SyncOperationStatus } from "./types.js";
+export class SyncOperationAggregateError extends Error {
+    errors;
+    constructor(errors) {
+        const messages = errors.map((e) => e.message).join("; ");
+        super(`SyncOperation callback failed with ${errors.length} error(s): ${messages}`);
+        this.name = "SyncOperationAggregateError";
+        this.errors = errors;
+    }
+}
+export class SyncOperation {
+    id;
+    remoteName;
+    documentId;
+    scopes;
+    branch;
+    operations;
+    status;
+    error;
+    callbacks = [];
+    constructor(id, remoteName, documentId, scopes, branch, operations) {
+        this.id = id;
+        this.remoteName = remoteName;
+        this.documentId = documentId;
+        this.scopes = scopes;
+        this.branch = branch;
+        this.operations = operations;
+        this.status = SyncOperationStatus.Unknown;
+    }
+    on(callback) {
+        this.callbacks.push(callback);
+    }
+    started() {
+        this.transition(SyncOperationStatus.TransportPending);
+    }
+    transported() {
+        this.transition(SyncOperationStatus.ExecutionPending);
+    }
+    executed() {
+        this.transition(SyncOperationStatus.Applied);
+    }
+    failed(error) {
+        this.error = error;
+        this.transition(SyncOperationStatus.Error);
+    }
+    transition(next) {
+        const prev = this.status;
+        this.status = next;
+        const errors = [];
+        for (const callback of this.callbacks) {
+            try {
+                callback(this, prev, next);
+            }
+            catch (error) {
+                errors.push(error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+        if (errors.length > 0) {
+            throw new SyncOperationAggregateError(errors);
+        }
+    }
+}
+//# sourceMappingURL=sync-operation.js.map

package/dist/src/sync/sync-operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-operation.js","sourceRoot":"","sources":["../../../src/sync/sync-operation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAQjD,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IACpD,MAAM,CAAU;IAEhB,YAAY,MAAe;QACzB,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,KAAK,CACH,sCAAsC,MAAM,CAAC,MAAM,cAAc,QAAQ,EAAE,CAC5E,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,aAAa;IACf,EAAE,CAAS;IACX,UAAU,CAAS;IACnB,UAAU,CAAS;IACnB,MAAM,CAAW;IACjB,MAAM,CAAS;IACf,UAAU,CAAyB;IAC5C,MAAM,CAAsB;IAC5B,KAAK,CAAgB;IAEb,SAAS,GAAkC,EAAE,CAAC;IAEtD,YACE,EAAU,EACV,UAAkB,EAClB,UAAkB,EAClB,MAAgB,EAChB,MAAc,EACd,UAAkC;QAElC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC;IAC5C,CAAC;IAED,EAAE,CAAC,QAAqC;QACtC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,OAAO;QACL,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IACxD,CAAC;IAED,WAAW;QACT,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IACxD,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,KAAmB;QACxB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAEO,UAAU,CAAC,IAAyB;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,MAAM,GAAY,EAAE,CAAC;QAC3B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAC7B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,2BAA2B,CAAC,MAAM,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,61 @@
+import type { OperationWithContext } from "../storage/interfaces.js";
+export type RemoteOptions = {};
+export type RemoteFilter = {
+    documentId: string[];
+    scope: string[];
+    branch: string;
+};
+export type RemoteCursor = {
+    remoteName: string;
+    cursorOrdinal: number;
+    lastSyncedAtUtcMs?: number;
+};
+export type ChannelMeta = {
+    id: string;
+};
+export type SyncEnvelopeType = "operations" | "ack";
+export type SyncEnvelope = {
+    type: SyncEnvelopeType;
+    channelMeta: ChannelMeta;
+    operations?: OperationWithContext[];
+    cursor?: RemoteCursor;
+};
+export declare enum SyncOperationStatus {
+    Unknown = -1,
+    TransportPending = 0,
+    ExecutionPending = 1,
+    Applied = 2,
+    Error = 3
+}
+export declare enum ChannelErrorSource {
+    None = "none",
+    Channel = "channel",
+    Inbox = "inbox",
+    Outbox = "outbox"
+}
+export type SyncOperationErrorType = "SIGNATURE_INVALID" | "HASH_MISMATCH" | "LIBRARY_ERROR" | "MISSING_OPERATIONS" | "EXCESSIVE_SHUFFLE" | "GRACEFUL_ABORT";
+export type ChannelHealth = {
+    state: "idle" | "running" | "error";
+    lastSuccessUtcMs?: number;
+    lastFailureUtcMs?: number;
+    failureCount: number;
+};
+export type RemoteStatus = {
+    push: ChannelHealth;
+    pull: ChannelHealth;
+};
+export type ChannelConfig = {
+    type: string;
+    channelId: string;
+    remoteName: string;
+    parameters: Record<string, unknown>;
+};
+export type RemoteRecord = {
+    name: string;
+    collectionId: string;
+    channelConfig: ChannelConfig;
+    filter: RemoteFilter;
+    options: RemoteOptions;
+    status: RemoteStatus;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/sync/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGrE,MAAM,MAAM,aAAa,GAAG,EAE3B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,KAAK,CAAC;AAEpD,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,gBAAgB,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACpC,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,CAAC;AAEF,oBAAY,mBAAmB;IAC7B,OAAO,KAAK;IACZ,gBAAgB,IAAI;IACpB,gBAAgB,IAAI;IACpB,OAAO,IAAI;IACX,KAAK,IAAI;CACV;AAED,oBAAY,kBAAkB;IAC5B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,MAAM,WAAW;CAClB;AAED,MAAM,MAAM,sBAAsB,GAC9B,mBAAmB,GACnB,eAAe,GACf,eAAe,GACf,oBAAoB,GACpB,mBAAmB,GACnB,gBAAgB,CAAC;AAErB,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,aAAa,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC"}

package/dist/src/sync/types.js

@@ -0,0 +1,16 @@
+export var SyncOperationStatus;
+(function (SyncOperationStatus) {
+    SyncOperationStatus[SyncOperationStatus["Unknown"] = -1] = "Unknown";
+    SyncOperationStatus[SyncOperationStatus["TransportPending"] = 0] = "TransportPending";
+    SyncOperationStatus[SyncOperationStatus["ExecutionPending"] = 1] = "ExecutionPending";
+    SyncOperationStatus[SyncOperationStatus["Applied"] = 2] = "Applied";
+    SyncOperationStatus[SyncOperationStatus["Error"] = 3] = "Error";
+})(SyncOperationStatus || (SyncOperationStatus = {}));
+export var ChannelErrorSource;
+(function (ChannelErrorSource) {
+    ChannelErrorSource["None"] = "none";
+    ChannelErrorSource["Channel"] = "channel";
+    ChannelErrorSource["Inbox"] = "inbox";
+    ChannelErrorSource["Outbox"] = "outbox";
+})(ChannelErrorSource || (ChannelErrorSource = {}));
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/sync/types.ts"],"names":[],"mappings":"AAgCA,MAAM,CAAN,IAAY,mBAMX;AAND,WAAY,mBAAmB;IAC7B,oEAAY,CAAA;IACZ,qFAAoB,CAAA;IACpB,qFAAoB,CAAA;IACpB,mEAAW,CAAA;IACX,+DAAS,CAAA;AACX,CAAC,EANW,mBAAmB,KAAnB,mBAAmB,QAM9B;AAED,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,mCAAa,CAAA;IACb,yCAAmB,CAAA;IACnB,qCAAe,CAAA;IACf,uCAAiB,CAAA;AACnB,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B"}

package/dist/src/sync/utils.d.ts

@@ -0,0 +1,17 @@
+import type { OperationWithContext } from "../storage/interfaces.js";
+import type { ChannelHealth, RemoteFilter } from "./types.js";
+/**
+ * Filters operations based on a remote's filter criteria.
+ *
+ * @param operations - The operations to filter
+ * @param filter - The filter criteria to apply
+ * @returns The filtered operations that match the criteria
+ */
+export declare function filterOperations(operations: OperationWithContext[], filter: RemoteFilter): OperationWithContext[];
+/**
+ * Creates an idle channel health status.
+ *
+ * @returns A new idle channel health object
+ */
+export declare function createIdleHealth(): ChannelHealth;
+//# sourceMappingURL=utils.d.ts.map

package/dist/src/sync/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/sync/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9D;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,oBAAoB,EAAE,EAClC,MAAM,EAAE,YAAY,GACnB,oBAAoB,EAAE,CAmBxB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD"}

package/dist/src/sync/utils.js

@@ -0,0 +1,34 @@
+/**
+ * Filters operations based on a remote's filter criteria.
+ *
+ * @param operations - The operations to filter
+ * @param filter - The filter criteria to apply
+ * @returns The filtered operations that match the criteria
+ */
+export function filterOperations(operations, filter) {
+    return operations.filter((op) => {
+        if (filter.branch && op.context.branch !== filter.branch) {
+            return false;
+        }
+        if (filter.documentId.length > 0 &&
+            !filter.documentId.includes(op.context.documentId)) {
+            return false;
+        }
+        if (filter.scope.length > 0 && !filter.scope.includes(op.context.scope)) {
+            return false;
+        }
+        return true;
+    });
+}
+/**
+ * Creates an idle channel health status.
+ *
+ * @returns A new idle channel health object
+ */
+export function createIdleHealth() {
+    return {
+        state: "idle",
+        failureCount: 0,
+    };
+}
+//# sourceMappingURL=utils.js.map

package/dist/src/sync/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/sync/utils.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAkC,EAClC,MAAoB;IAEpB,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE;QAC9B,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;YACzD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IACE,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;YAC5B,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,EAClD,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACxE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,KAAK,EAAE,MAAM;QACb,YAAY,EAAE,CAAC;KAChB,CAAC;AACJ,CAAC"}

package/dist/src/utils/reshuffle.d.ts

@@ -0,0 +1,30 @@
+type OperationIndex = {
+    index: number;
+    skip: number;
+    id?: string;
+    timestampUtcMs?: string;
+};
+/**
+ * Sorts operations by index and skip number.
+ * [0:0 2:0 1:0 3:3 3:1] => [0:0 1:0 2:0 3:1 3:3]
+ */
+export declare function sortOperations<TOpIndex extends OperationIndex>(operations: TOpIndex[]): TOpIndex[];
+/**
+ * Reshuffles operations by timestamp only, ignoring their original index values.
+ * Used for merging concurrent operations from different branches.
+ *
+ * Example:
+ * [0:0, 1:0, 2:0, A3:0, A4:0, A5:0] + [0:0, 1:0, 2:0, B3:0, B4:2, B5:0]
+ * GC               => [0:0, 1:0, 2:0, A3:0, A4:0, A5:0] + [0:0, 1:0, B4:2, B5:0]
+ * Split            => [0:0, 1:0] + [2:0, A3:0, A4:0, A5:0] + [B4:2, B5:0]
+ * Reshuffle(6:4)   => [6:4, 7:0, 8:0, 9:0, 10:0, 11:0]
+ * merge            => [0:0, 1:0, 6:4, 7:0, 8:0, 9:0, 10:0, 11:0]
+ */
+export declare function reshuffleByTimestamp<TOp extends OperationIndex>(startIndex: OperationIndex, opsA: TOp[], opsB: TOp[]): TOp[];
+/**
+ * Reshuffles operations by timestamp first, then by original index value.
+ * Used for merging concurrent operations while preserving index ordering for operations with same timestamp.
+ */
+export declare function reshuffleByTimestampAndIndex<TOp extends OperationIndex>(startIndex: OperationIndex, opsA: TOp[], opsB: TOp[]): TOp[];
+export {};
+//# sourceMappingURL=reshuffle.d.ts.map

package/dist/src/utils/reshuffle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reshuffle.d.ts","sourceRoot":"","sources":["../../../src/utils/reshuffle.ts"],"names":[],"mappings":"AAAA,KAAK,cAAc,GAAG;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,SAAS,cAAc,EAC5D,UAAU,EAAE,QAAQ,EAAE,GACrB,QAAQ,EAAE,CAKZ;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,SAAS,cAAc,EAC7D,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,GAAG,EAAE,EACX,IAAI,EAAE,GAAG,EAAE,GACV,GAAG,EAAE,CAYP;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,SAAS,cAAc,EACrE,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,GAAG,EAAE,EACX,IAAI,EAAE,GAAG,EAAE,GACV,GAAG,EAAE,CAaP"}

package/dist/src/utils/reshuffle.js

@@ -0,0 +1,47 @@
+/**
+ * Sorts operations by index and skip number.
+ * [0:0 2:0 1:0 3:3 3:1] => [0:0 1:0 2:0 3:1 3:3]
+ */
+export function sortOperations(operations) {
+    return operations
+        .slice()
+        .sort((a, b) => a.skip - b.skip)
+        .sort((a, b) => a.index - b.index);
+}
+/**
+ * Reshuffles operations by timestamp only, ignoring their original index values.
+ * Used for merging concurrent operations from different branches.
+ *
+ * Example:
+ * [0:0, 1:0, 2:0, A3:0, A4:0, A5:0] + [0:0, 1:0, 2:0, B3:0, B4:2, B5:0]
+ * GC               => [0:0, 1:0, 2:0, A3:0, A4:0, A5:0] + [0:0, 1:0, B4:2, B5:0]
+ * Split            => [0:0, 1:0] + [2:0, A3:0, A4:0, A5:0] + [B4:2, B5:0]
+ * Reshuffle(6:4)   => [6:4, 7:0, 8:0, 9:0, 10:0, 11:0]
+ * merge            => [0:0, 1:0, 6:4, 7:0, 8:0, 9:0, 10:0, 11:0]
+ */
+export function reshuffleByTimestamp(startIndex, opsA, opsB) {
+    return [...opsA, ...opsB]
+        .sort((a, b) => new Date(a.timestampUtcMs || "").getTime() -
+        new Date(b.timestampUtcMs || "").getTime())
+        .map((op, i) => ({
+        ...op,
+        index: startIndex.index + i,
+        skip: i === 0 ? startIndex.skip : 0,
+    }));
+}
+/**
+ * Reshuffles operations by timestamp first, then by original index value.
+ * Used for merging concurrent operations while preserving index ordering for operations with same timestamp.
+ */
+export function reshuffleByTimestampAndIndex(startIndex, opsA, opsB) {
+    return [...opsA, ...opsB]
+        .sort((a, b) => new Date(a.timestampUtcMs || "").getTime() -
+        new Date(b.timestampUtcMs || "").getTime())
+        .sort((a, b) => a.index - b.index)
+        .map((op, i) => ({
+        ...op,
+        index: startIndex.index + i,
+        skip: i === 0 ? startIndex.skip : 0,
+    }));
+}
+//# sourceMappingURL=reshuffle.js.map

package/dist/src/utils/reshuffle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reshuffle.js","sourceRoot":"","sources":["../../../src/utils/reshuffle.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,UAAsB;IAEtB,OAAO,UAAU;SACd,KAAK,EAAE;SACP,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;SAC/B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAA0B,EAC1B,IAAW,EACX,IAAW;IAEX,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;SACtB,IAAI,CACH,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,IAAI,IAAI,CAAC,CAAC,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;QAC1C,IAAI,IAAI,CAAC,CAAC,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAC7C;SACA,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACf,GAAG,EAAE;QACL,KAAK,EAAE,UAAU,CAAC,KAAK,GAAG,CAAC;QAC3B,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KACpC,CAAC,CAAC,CAAC;AACR,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAC1C,UAA0B,EAC1B,IAAW,EACX,IAAW;IAEX,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;SACtB,IAAI,CACH,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,IAAI,IAAI,CAAC,CAAC,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;QAC1C,IAAI,IAAI,CAAC,CAAC,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAC7C;SACA,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SACjC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACf,GAAG,EAAE;QACL,KAAK,EAAE,UAAU,CAAC,KAAK,GAAG,CAAC;QAC3B,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KACpC,CAAC,CAAC,CAAC;AACR,CAAC"}

package/package.json

@@ -1,21 +1,21 @@
 {
   "name": "@powerhousedao/reactor",
-  "version": "4.1.0-dev.12",
+  "version": "4.1.0-dev.121",
   "description": "",
   "repository": {
     "url": "https://github.com/powerhouse-inc/powerhouse",
     "directory": "packages/reactor"
   },
   "type": "module",
-  "types": "./dist/index.d.ts",
+  "types": "./dist/src/index.d.ts",
   "exports": {
-    ".": "./dist/index.js"
+    ".": "./dist/src/index.js"
   },
   "imports": {
     "#*": "./dist/src/*"
   },
   "files": [
-    "./dist"
+    "./dist/src"
   ],
   "publishConfig": {
     "access": "public"
@@ -23,18 +23,34 @@
   "keywords": [],
   "author": "",
   "license": "AGPL-3.0-only",
+  "dependencies": {
+    "@electric-sql/pglite": "0.2.17",
+    "kysely": "^0.28.2",
+    "kysely-pglite": "^0.6.1",
+    "uuid": "^11.0.5",
+    "document-drive": "4.1.0-dev.121",
+    "document-model": "4.1.0-dev.121"
+  },
   "devDependencies": {
+    "@vitest/coverage-v8": "^3.2.4",
+    "tinybench": "^2.9.0",
+    "tsx": "^4.19.2",
     "typescript": "^5.7.3",
-    "vitest": "^3.1.2"
+    "vitest": "^3.2.4"
   },
   "scripts": {
     "build": "pnpm run build:tsc",
     "build:tsc": "tsc --build",
     "prebuild": "pnpm run clean",
-    "test": "vitest run",
+    "test": "vitest run --coverage --printConsoleTrace=true --silent=false",
+    "test:watch": "vitest --coverage",
     "lint": "eslint",
     "bench": "vitest bench --run",
+    "bench:sync": "node --import tsx bench/two-reactor-sync.bench.ts",
     "clean": "rimraf dist",
-    "clean:node_modules": "rimraf node_modules"
+    "clean:node_modules": "rimraf node_modules",
+    "claude": "pnpm build && pnpm test && npx prettier --write \"**/*.ts\" && pnpm lint",
+    "migrate": "tsx src/storage/migrations/run-migrations.ts",
+    "migrate:status": "tsx src/storage/migrations/run-migrations.ts status"
   }
 }

package/dist/bench/end-to-end-flow.bench.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=end-to-end-flow.bench.d.ts.map

package/dist/bench/end-to-end-flow.bench.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"end-to-end-flow.bench.d.ts","sourceRoot":"","sources":["../../bench/end-to-end-flow.bench.ts"],"names":[],"mappings":""}