@powerhousedao/reactor 5.0.1-staging.15 → 5.0.1-staging.17

package/dist/src/sync/channels/internal-channel.d.ts

@@ -0,0 +1,57 @@
+import type { ISyncCursorStorage } from "../../storage/interfaces.js";
+import type { IChannel } from "../interfaces.js";
+import type { SyncOperation } from "../sync-operation.js";
+import { Mailbox } from "../mailbox.js";
+import type { SyncEnvelope } from "../types.js";
+/**
+ * In-memory synchronization channel for testing purposes only.
+ *
+ * InternalChannel enables direct bidirectional communication between two reactor
+ * instances without network transport. Channels are wired together by passing
+ * a send function that delivers envelopes to the peer's inbox.
+ */
+export declare class InternalChannel implements IChannel {
+    readonly inbox: Mailbox<SyncOperation>;
+    readonly outbox: Mailbox<SyncOperation>;
+    readonly deadLetter: Mailbox<SyncOperation>;
+    private readonly channelId;
+    private readonly remoteName;
+    private readonly cursorStorage;
+    private readonly send;
+    private isShutdown;
+    constructor(channelId: string, remoteName: string, cursorStorage: ISyncCursorStorage, send: (envelope: SyncEnvelope) => void);
+    /**
+     * Shuts down the channel and prevents further operations.
+     */
+    shutdown(): void;
+    /**
+     * Receives a sync envelope from a peer channel.
+     *
+     * This method is called by the peer's send function to deliver an envelope
+     * to this channel's inbox.
+     *
+     * @param envelope - The sync envelope to receive
+     * @throws {InternalChannelError} If channel is shutdown
+     */
+    receive(envelope: SyncEnvelope): void;
+    /**
+     * Updates the synchronization cursor for this channel's remote.
+     *
+     * Cursors track progress through the operation stream and enable resuming
+     * synchronization after restarts. The cursor is exclusive - the next sync
+     * will start at cursorOrdinal + 1.
+     *
+     * @param cursorOrdinal - The last processed ordinal (exclusive)
+     */
+    updateCursor(cursorOrdinal: number): Promise<void>;
+    /**
+     * Handles sync operations added to the outbox by sending them to the peer.
+     *
+     * This method is called automatically via the outbox.onAdded callback.
+     * It converts the sync operation to a SyncEnvelope and sends it via the send function.
+     *
+     * @param syncOp - The sync operation to transport
+     */
+    private handleOutboxAdded;
+}
+//# sourceMappingURL=internal-channel.d.ts.map

package/dist/src/sync/channels/internal-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-channel.d.ts","sourceRoot":"","sources":["../../../../src/sync/channels/internal-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAgB,YAAY,EAAE,MAAM,aAAa,CAAC;AAI9D;;;;;;GAMG;AACH,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAE5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmC;IACxD,OAAO,CAAC,UAAU,CAAU;gBAG1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,kBAAkB,EACjC,IAAI,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI;IAiBxC;;OAEG;IACH,QAAQ,IAAI,IAAI;IAIhB;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAcrC;;;;;;;;OAQG;IACG,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxD;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;CAuB1B"}

package/dist/src/sync/channels/internal-channel.js

@@ -0,0 +1,106 @@
+import { ChannelError, InternalChannelError } from "../errors.js";
+import { Mailbox } from "../mailbox.js";
+import { ChannelErrorSource } from "../types.js";
+import { envelopeToSyncOperation } from "./utils.js";
+/**
+ * In-memory synchronization channel for testing purposes only.
+ *
+ * InternalChannel enables direct bidirectional communication between two reactor
+ * instances without network transport. Channels are wired together by passing
+ * a send function that delivers envelopes to the peer's inbox.
+ */
+export class InternalChannel {
+    inbox;
+    outbox;
+    deadLetter;
+    channelId;
+    remoteName;
+    cursorStorage;
+    send;
+    isShutdown;
+    constructor(channelId, remoteName, cursorStorage, send) {
+        this.channelId = channelId;
+        this.remoteName = remoteName;
+        this.cursorStorage = cursorStorage;
+        this.send = send;
+        this.isShutdown = false;
+        this.inbox = new Mailbox();
+        this.outbox = new Mailbox();
+        this.deadLetter = new Mailbox();
+        this.outbox.onAdded((syncOp) => {
+            this.handleOutboxAdded(syncOp);
+        });
+    }
+    /**
+     * Shuts down the channel and prevents further operations.
+     */
+    shutdown() {
+        this.isShutdown = true;
+    }
+    /**
+     * Receives a sync envelope from a peer channel.
+     *
+     * This method is called by the peer's send function to deliver an envelope
+     * to this channel's inbox.
+     *
+     * @param envelope - The sync envelope to receive
+     * @throws {InternalChannelError} If channel is shutdown
+     */
+    receive(envelope) {
+        if (this.isShutdown) {
+            throw new InternalChannelError(`Channel ${this.channelId} is shutdown and cannot receive envelopes`);
+        }
+        if (envelope.type === "operations" && envelope.operations) {
+            const syncOp = envelopeToSyncOperation(envelope, this.remoteName);
+            syncOp.transported();
+            this.inbox.add(syncOp);
+        }
+    }
+    /**
+     * Updates the synchronization cursor for this channel's remote.
+     *
+     * Cursors track progress through the operation stream and enable resuming
+     * synchronization after restarts. The cursor is exclusive - the next sync
+     * will start at cursorOrdinal + 1.
+     *
+     * @param cursorOrdinal - The last processed ordinal (exclusive)
+     */
+    async updateCursor(cursorOrdinal) {
+        const cursor = {
+            remoteName: this.remoteName,
+            cursorOrdinal,
+            lastSyncedAtUtcMs: Date.now(),
+        };
+        await this.cursorStorage.upsert(cursor);
+    }
+    /**
+     * Handles sync operations added to the outbox by sending them to the peer.
+     *
+     * This method is called automatically via the outbox.onAdded callback.
+     * It converts the sync operation to a SyncEnvelope and sends it via the send function.
+     *
+     * @param syncOp - The sync operation to transport
+     */
+    handleOutboxAdded(syncOp) {
+        if (this.isShutdown) {
+            return;
+        }
+        try {
+            syncOp.started();
+            const envelope = {
+                type: "operations",
+                channelMeta: { id: this.channelId },
+                operations: syncOp.operations,
+            };
+            this.send(envelope);
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            const channelError = new ChannelError(ChannelErrorSource.Outbox, err);
+            syncOp.failed(channelError);
+            this.deadLetter.add(syncOp);
+            this.outbox.remove(syncOp);
+        }
+    }
+}
+//# sourceMappingURL=internal-channel.js.map

package/dist/src/sync/channels/internal-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-channel.js","sourceRoot":"","sources":["../../../../src/sync/channels/internal-channel.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGlE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IACjB,KAAK,CAAyB;IAC9B,MAAM,CAAyB;IAC/B,UAAU,CAAyB;IAE3B,SAAS,CAAS;IAClB,UAAU,CAAS;IACnB,aAAa,CAAqB;IAClC,IAAI,CAAmC;IAChD,UAAU,CAAU;IAE5B,YACE,SAAiB,EACjB,UAAkB,EAClB,aAAiC,EACjC,IAAsC;QAEtC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QAExB,IAAI,CAAC,KAAK,GAAG,IAAI,OAAO,EAAiB,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,IAAI,OAAO,EAAiB,CAAC;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,OAAO,EAAiB,CAAC;QAE/C,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;YAC7B,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAsB;QAC5B,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,IAAI,oBAAoB,CAC5B,WAAW,IAAI,CAAC,SAAS,2CAA2C,CACrE,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC1D,MAAM,MAAM,GAAG,uBAAuB,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YAClE,MAAM,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,YAAY,CAAC,aAAqB;QACtC,MAAM,MAAM,GAAiB;YAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,aAAa;YACb,iBAAiB,EAAE,IAAI,CAAC,GAAG,EAAE;SAC9B,CAAC;QAEF,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;OAOG;IACK,iBAAiB,CAAC,MAAqB;QAC7C,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,CAAC,OAAO,EAAE,CAAC;YAEjB,MAAM,QAAQ,GAAiB;gBAC7B,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE;gBACnC,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC;YAEF,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACtE,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YACtE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAC5B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,15 @@
+import { SyncOperation } from "../sync-operation.js";
+import type { SyncEnvelope } from "../types.js";
+/**
+ * Converts a SyncEnvelope containing operations into a SyncOperation.
+ *
+ * Extracts the necessary metadata from the envelope's operations to create
+ * a sync operation that can be processed by the receiving channel.
+ *
+ * @param envelope - The sync envelope containing operations
+ * @param remoteName - The name of the remote this sync operation is associated with
+ * @returns A new SyncOperation containing the envelope's operations
+ * @throws Error if envelope has no operations or operations array is empty
+ */
+export declare function envelopeToSyncOperation(envelope: SyncEnvelope, remoteName: string): SyncOperation;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/sync/channels/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,MAAM,GACjB,aAAa,CAuBf"}

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

@@ -0,0 +1,26 @@
+import { SyncOperation } from "../sync-operation.js";
+let syncOpCounter = 0;
+/**
+ * Converts a SyncEnvelope containing operations into a SyncOperation.
+ *
+ * Extracts the necessary metadata from the envelope's operations to create
+ * a sync operation that can be processed by the receiving channel.
+ *
+ * @param envelope - The sync envelope containing operations
+ * @param remoteName - The name of the remote this sync operation is associated with
+ * @returns A new SyncOperation containing the envelope's operations
+ * @throws Error if envelope has no operations or operations array is empty
+ */
+export function envelopeToSyncOperation(envelope, remoteName) {
+    if (!envelope.operations || envelope.operations.length === 0) {
+        throw new Error("Cannot create SyncOperation from envelope without operations");
+    }
+    const operations = envelope.operations;
+    const firstOp = operations[0];
+    const documentId = firstOp.context.documentId;
+    const branch = firstOp.context.branch;
+    const scopes = [...new Set(operations.map((op) => op.context.scope))];
+    const syncOpId = `syncop-${envelope.channelMeta.id}-${Date.now()}-${syncOpCounter++}`;
+    return new SyncOperation(syncOpId, remoteName, documentId, scopes, branch, operations);
+}
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/sync/channels/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,IAAI,aAAa,GAAG,CAAC,CAAC;AAEtB;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAsB,EACtB,UAAkB;IAElB,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;IACvC,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;IAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;IACtC,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEtE,MAAM,QAAQ,GAAG,UAAU,QAAQ,CAAC,WAAW,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,aAAa,EAAE,EAAE,CAAC;IAEtF,OAAO,IAAI,aAAa,CACtB,QAAQ,EACR,UAAU,EACV,UAAU,EACV,MAAM,EACN,MAAM,EACN,UAAU,CACX,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,10 @@
+import type { ChannelErrorSource } from "./types.js";
+export declare class InternalChannelError extends Error {
+    constructor(message: string);
+}
+export declare class ChannelError extends Error {
+    source: ChannelErrorSource;
+    error: Error;
+    constructor(source: ChannelErrorSource, error: Error);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/sync/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,KAAK,CAAC;gBAED,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,KAAK;CAMrD"}

package/dist/src/sync/errors.js

@@ -0,0 +1,17 @@
+export class InternalChannelError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InternalChannelError";
+    }
+}
+export class ChannelError extends Error {
+    source;
+    error;
+    constructor(source, error) {
+        super(`ChannelError[${source}]: ${error.message}`);
+        this.name = "ChannelError";
+        this.source = source;
+        this.error = error;
+    }
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/sync/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,MAAM,CAAqB;IAC3B,KAAK,CAAQ;IAEb,YAAY,MAA0B,EAAE,KAAY;QAClD,KAAK,CAAC,gBAAgB,MAAM,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}

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

@@ -0,0 +1,12 @@
+export type { IChannel, IChannelFactory, ISyncManager, Remote, } from "./interfaces.js";
+export type { ShutdownStatus } from "../shared/types.js";
+export type { ChannelConfig, ChannelHealth, SyncOperationErrorType, RemoteFilter, RemoteOptions, RemoteRecord, RemoteCursor, RemoteStatus, SyncEnvelope, SyncEnvelopeType, ChannelMeta, } from "./types.js";
+export { ChannelErrorSource, SyncOperationStatus } from "./types.js";
+export { SyncOperation, SyncOperationAggregateError, } from "./sync-operation.js";
+export { Mailbox, type MailboxItem } from "./mailbox.js";
+export { ChannelError, InternalChannelError } from "./errors.js";
+export { InternalChannel } from "./channels/index.js";
+export { SyncManager } from "./sync-manager.js";
+export { SyncBuilder } from "./sync-builder.js";
+export { createIdleHealth, filterOperations } from "./utils.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sync/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,MAAM,GACP,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,YAAY,EACV,aAAa,EACb,aAAa,EACb,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAErE,OAAO,EACL,aAAa,EACb,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/sync/index.js

@@ -0,0 +1,9 @@
+export { ChannelErrorSource, SyncOperationStatus } from "./types.js";
+export { SyncOperation, SyncOperationAggregateError, } from "./sync-operation.js";
+export { Mailbox } from "./mailbox.js";
+export { ChannelError, InternalChannelError } from "./errors.js";
+export { InternalChannel } from "./channels/index.js";
+export { SyncManager } from "./sync-manager.js";
+export { SyncBuilder } from "./sync-builder.js";
+export { createIdleHealth, filterOperations } from "./utils.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sync/index.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAErE,OAAO,EACL,aAAa,EACb,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAoB,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,150 @@
+import type { ShutdownStatus } from "../shared/types.js";
+import type { ISyncCursorStorage } from "../storage/interfaces.js";
+import type { SyncOperation } from "./sync-operation.js";
+import type { Mailbox } from "./mailbox.js";
+import type { ChannelConfig, RemoteFilter, RemoteOptions } from "./types.js";
+/**
+ * Represents a bidirectional synchronization channel between two reactor instances.
+ *
+ * A channel manages three mailboxes:
+ * - inbox: Sync operations received from the remote that need to be applied locally
+ * - outbox: Sync operations to be sent to the remote
+ * - deadLetter: Sync operations that failed and cannot be retried
+ *
+ * Channels are responsible for:
+ * - Transporting sync envelopes between reactor instances
+ * - Managing sync operation lifecycle through status transitions
+ * - Handling errors and moving failed sync operations to dead letter queue
+ * - Updating cursors as operations are applied
+ */
+export interface IChannel {
+    /**
+     * Mailbox containing sync operations received from the remote that need to be applied locally.
+     * Consumers should register callbacks via onAdded to process incoming sync operations.
+     */
+    inbox: Mailbox<SyncOperation>;
+    /**
+     * Mailbox containing sync operations that need to be sent to the remote.
+     * The channel is responsible for transporting these sync operations and handling ACKs.
+     */
+    outbox: Mailbox<SyncOperation>;
+    /**
+     * Mailbox containing sync operations that failed and cannot be retried.
+     * These sync operations require manual intervention or should be logged for debugging.
+     */
+    deadLetter: Mailbox<SyncOperation>;
+    /**
+     * Shuts down the channel and prevents further operations.
+     */
+    shutdown(): void;
+}
+/**
+ * Factory for creating channel instances.
+ *
+ * Different channel implementations (InternalChannel, GqlChannel, etc.) will have
+ * their own factories that implement this interface.
+ */
+export interface IChannelFactory {
+    /**
+     * Creates a new channel instance with the given configuration.
+     *
+     * @param config - Channel configuration including type and parameters
+     * @param cursorStorage - Storage for persisting synchronization cursors
+     * @returns A new channel instance
+     */
+    instance(config: ChannelConfig, cursorStorage: ISyncCursorStorage): IChannel;
+}
+/**
+ * Represents a configured remote with an active channel.
+ *
+ * A remote defines what to synchronize (collectionId, filter) and how to synchronize it (channel).
+ * The remote name is used as a unique identifier across the system.
+ */
+export type Remote = {
+    /**
+     * Unique name for this remote.
+     */
+    name: string;
+    /**
+     * Collection ID to synchronize.
+     * Typically created via driveCollectionId(branch, documentId) for drive-level sync.
+     */
+    collectionId: string;
+    /**
+     * Filter to apply to operations.
+     * Can filter by documentId, scope, and branch.
+     */
+    filter: RemoteFilter;
+    /**
+     * Additional configuration options for the remote.
+     */
+    options: RemoteOptions;
+    /**
+     * Active channel for bidirectional communication with the remote.
+     */
+    channel: IChannel;
+};
+/**
+ * Orchestrates all synchronization activity for a reactor instance.
+ */
+export interface ISyncManager {
+    /**
+     * Starts the synchronization manager.
+     *
+     * This recreates all remotes from storage and prepares channels for synchronization.
+     * Each remote's channel will begin processing its inbox/outbox mailboxes.
+     *
+     * @returns Promise that resolves when the manager is started
+     */
+    startup(): Promise<void>;
+    /**
+     * Shuts down the synchronization manager.
+     *
+     * This stops all channels, flushes pending operations, and releases resources.
+     * The shutdown status indicates whether the system was cleanly shut down.
+     *
+     * @returns Status object with shutdown information
+     */
+    shutdown(): ShutdownStatus;
+    /**
+     * Gets a remote by name.
+     *
+     * @param name - The name of the remote
+     * @returns The remote
+     * @throws Error if the remote does not exist
+     */
+    get(name: string): Remote;
+    /**
+     * Adds a new remote and starts its channel.
+     *
+     * The remote configuration is persisted to storage and a channel is created
+     * using the appropriate factory. The channel begins processing immediately.
+     *
+     * @param name - Unique name for the remote
+     * @param collectionId - Collection ID to synchronize
+     * @param channelConfig - Configuration for the channel type and parameters
+     * @param filter - Optional filter for operations (defaults to no filtering)
+     * @param options - Optional remote configuration options
+     * @returns Promise that resolves with the created remote
+     * @throws Error if a remote with this name already exists
+     */
+    add(name: string, collectionId: string, channelConfig: ChannelConfig, filter?: RemoteFilter, options?: RemoteOptions): Promise<Remote>;
+    /**
+     * Removes a remote and stops its channel.
+     *
+     * The remote configuration is removed from storage and the channel is shut down.
+     * Any pending sync operations in the channel's mailboxes will be processed before shutdown.
+     *
+     * @param name - The name of the remote to remove
+     * @returns Promise that resolves when the remote is removed
+     * @throws Error if the remote does not exist
+     */
+    remove(name: string): Promise<void>;
+    /**
+     * Lists all configured remotes.
+     *
+     * @returns Array of all remotes
+     */
+    list(): Remote[];
+}
+//# sourceMappingURL=interfaces.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/sync/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7E;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,QAAQ;IACvB;;;OAGG;IACH,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAE9B;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAE/B;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAEnC;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,GAAG,QAAQ,CAAC;CAC9E;AAED;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,MAAM,EAAE,YAAY,CAAC;IAErB;;OAEG;IACH,OAAO,EAAE,aAAa,CAAC;IAEvB;;OAEG;IACH,OAAO,EAAE,QAAQ,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;OAOG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;;;;;OAOG;IACH,QAAQ,IAAI,cAAc,CAAC;IAE3B;;;;;;OAMG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1B;;;;;;;;;;;;;OAaG;IACH,GAAG,CACD,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,aAAa,EAC5B,MAAM,CAAC,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB;;;;;;;;;OASG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC;;;;OAIG;IACH,IAAI,IAAI,MAAM,EAAE,CAAC;CAClB"}

package/dist/src/sync/interfaces.js

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

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

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

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

@@ -0,0 +1,21 @@
+export type MailboxItem = {
+    id: string;
+};
+type MailboxCallback<T extends MailboxItem> = (item: T) => void;
+export declare class MailboxAggregateError extends Error {
+    errors: Error[];
+    constructor(errors: Error[]);
+}
+export declare class Mailbox<T extends MailboxItem> {
+    private itemsMap;
+    private addedCallbacks;
+    private removedCallbacks;
+    get items(): ReadonlyArray<T>;
+    get(id: string): T | undefined;
+    add(item: T): void;
+    remove(item: T): void;
+    onAdded(callback: MailboxCallback<T>): void;
+    onRemoved(callback: MailboxCallback<T>): void;
+}
+export {};
+//# sourceMappingURL=mailbox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox.d.ts","sourceRoot":"","sources":["../../../src/sync/mailbox.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,KAAK,eAAe,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAEhE,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,MAAM,EAAE,KAAK,EAAE,CAAC;gBAEJ,MAAM,EAAE,KAAK,EAAE;CAQ5B;AAED,qBAAa,OAAO,CAAC,CAAC,SAAS,WAAW;IACxC,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,gBAAgB,CAA4B;IAEpD,IAAI,KAAK,IAAI,aAAa,CAAC,CAAC,CAAC,CAE5B;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAI9B,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAgBlB,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAgBrB,OAAO,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IAI3C,SAAS,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;CAG9C"}

package/dist/src/sync/mailbox.js

@@ -0,0 +1,59 @@
+export class MailboxAggregateError extends Error {
+    errors;
+    constructor(errors) {
+        const messages = errors.map((e) => e.message).join("; ");
+        super(`Mailbox callback failed with ${errors.length} error(s): ${messages}`);
+        this.name = "MailboxAggregateError";
+        this.errors = errors;
+    }
+}
+export class Mailbox {
+    itemsMap = new Map();
+    addedCallbacks = [];
+    removedCallbacks = [];
+    get items() {
+        return Array.from(this.itemsMap.values());
+    }
+    get(id) {
+        return this.itemsMap.get(id);
+    }
+    add(item) {
+        this.itemsMap.set(item.id, item);
+        const callbacks = [...this.addedCallbacks];
+        const errors = [];
+        for (const callback of callbacks) {
+            try {
+                callback(item);
+            }
+            catch (error) {
+                errors.push(error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+        if (errors.length > 0) {
+            throw new MailboxAggregateError(errors);
+        }
+    }
+    remove(item) {
+        this.itemsMap.delete(item.id);
+        const callbacks = [...this.removedCallbacks];
+        const errors = [];
+        for (const callback of callbacks) {
+            try {
+                callback(item);
+            }
+            catch (error) {
+                errors.push(error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+        if (errors.length > 0) {
+            throw new MailboxAggregateError(errors);
+        }
+    }
+    onAdded(callback) {
+        this.addedCallbacks.push(callback);
+    }
+    onRemoved(callback) {
+        this.removedCallbacks.push(callback);
+    }
+}
+//# sourceMappingURL=mailbox.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox.js","sourceRoot":"","sources":["../../../src/sync/mailbox.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,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,gCAAgC,MAAM,CAAC,MAAM,cAAc,QAAQ,EAAE,CACtE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,OAAO;IACV,QAAQ,GAAmB,IAAI,GAAG,EAAE,CAAC;IACrC,cAAc,GAAyB,EAAE,CAAC;IAC1C,gBAAgB,GAAyB,EAAE,CAAC;IAEpD,IAAI,KAAK;QACP,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,IAAO;QACT,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACjC,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAY,EAAE,CAAC;QAC3B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,QAAQ,CAAC,IAAI,CAAC,CAAC;YACjB,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,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAO;QACZ,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAY,EAAE,CAAC;QAC3B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,QAAQ,CAAC,IAAI,CAAC,CAAC;YACjB,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,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,OAAO,CAAC,QAA4B;QAClC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,SAAS,CAAC,QAA4B;QACpC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;CACF"}

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

@@ -0,0 +1,17 @@
+import type { Kysely } from "kysely";
+import type { IOperationIndex } from "../cache/operation-index-types.js";
+import type { IReactor } from "../core/types.js";
+import type { IEventBus } from "../events/interfaces.js";
+import type { ISyncCursorStorage, ISyncRemoteStorage } from "../storage/interfaces.js";
+import type { Database } from "../storage/kysely/types.js";
+import type { IChannelFactory, ISyncManager } from "./interfaces.js";
+export declare class SyncBuilder {
+    private channelFactory?;
+    private remoteStorage?;
+    private cursorStorage?;
+    withChannelFactory(factory: IChannelFactory): this;
+    withRemoteStorage(storage: ISyncRemoteStorage): this;
+    withCursorStorage(storage: ISyncCursorStorage): this;
+    build(reactor: IReactor, operationIndex: IOperationIndex, eventBus: IEventBus, db: Kysely<Database>): ISyncManager;
+}
+//# sourceMappingURL=sync-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync-builder.d.ts","sourceRoot":"","sources":["../../../src/sync/sync-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAG3D,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGrE,qBAAa,WAAW;IACtB,OAAO,CAAC,cAAc,CAAC,CAAkB;IACzC,OAAO,CAAC,aAAa,CAAC,CAAqB;IAC3C,OAAO,CAAC,aAAa,CAAC,CAAqB;IAE3C,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAKlD,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAKpD,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAKpD,KAAK,CACH,OAAO,EAAE,QAAQ,EACjB,cAAc,EAAE,eAAe,EAC/B,QAAQ,EAAE,SAAS,EACnB,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,GACnB,YAAY;CAiBhB"}

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

@@ -0,0 +1,29 @@
+import { KyselySyncCursorStorage } from "../storage/kysely/sync-cursor-storage.js";
+import { KyselySyncRemoteStorage } from "../storage/kysely/sync-remote-storage.js";
+import { SyncManager } from "./sync-manager.js";
+export class SyncBuilder {
+    channelFactory;
+    remoteStorage;
+    cursorStorage;
+    withChannelFactory(factory) {
+        this.channelFactory = factory;
+        return this;
+    }
+    withRemoteStorage(storage) {
+        this.remoteStorage = storage;
+        return this;
+    }
+    withCursorStorage(storage) {
+        this.cursorStorage = storage;
+        return this;
+    }
+    build(reactor, operationIndex, eventBus, db) {
+        if (!this.channelFactory) {
+            throw new Error("Channel factory is required");
+        }
+        const remoteStorage = this.remoteStorage ?? new KyselySyncRemoteStorage(db);
+        const cursorStorage = this.cursorStorage ?? new KyselySyncCursorStorage(db);
+        return new SyncManager(remoteStorage, cursorStorage, this.channelFactory, operationIndex, reactor, eventBus);
+    }
+}
+//# sourceMappingURL=sync-builder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync-builder.js","sourceRoot":"","sources":["../../../src/sync/sync-builder.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAEnF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,OAAO,WAAW;IACd,cAAc,CAAmB;IACjC,aAAa,CAAsB;IACnC,aAAa,CAAsB;IAE3C,kBAAkB,CAAC,OAAwB;QACzC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iBAAiB,CAAC,OAA2B;QAC3C,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iBAAiB,CAAC,OAA2B;QAC3C,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CACH,OAAiB,EACjB,cAA+B,EAC/B,QAAmB,EACnB,EAAoB;QAEpB,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,uBAAuB,CAAC,EAAE,CAAC,CAAC;QAC5E,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,uBAAuB,CAAC,EAAE,CAAC,CAAC;QAE5E,OAAO,IAAI,WAAW,CACpB,aAAa,EACb,aAAa,EACb,IAAI,CAAC,cAAc,EACnB,cAAc,EACd,OAAO,EACP,QAAQ,CACT,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,33 @@
+import type { IOperationIndex } from "../cache/operation-index-types.js";
+import type { IReactor } from "../core/types.js";
+import type { IEventBus } from "../events/interfaces.js";
+import { type JobInfo, type ShutdownStatus } from "../shared/types.js";
+import type { ISyncCursorStorage, ISyncRemoteStorage } from "../storage/interfaces.js";
+import type { IChannelFactory, ISyncManager, Remote } from "./interfaces.js";
+import type { ChannelConfig, RemoteFilter, RemoteOptions } from "./types.js";
+export declare class SyncManager implements ISyncManager {
+    private readonly remoteStorage;
+    private readonly cursorStorage;
+    private readonly channelFactory;
+    private readonly _operationIndex;
+    private readonly reactor;
+    private readonly eventBus;
+    private readonly remotes;
+    private readonly awaiter;
+    private isShutdown;
+    private eventUnsubscribe?;
+    loadJobs: Map<string, JobInfo>;
+    constructor(remoteStorage: ISyncRemoteStorage, cursorStorage: ISyncCursorStorage, channelFactory: IChannelFactory, operationIndex: IOperationIndex, reactor: IReactor, eventBus: IEventBus);
+    startup(): Promise<void>;
+    shutdown(): ShutdownStatus;
+    get(name: string): Remote;
+    add(name: string, collectionId: string, channelConfig: ChannelConfig, filter?: RemoteFilter, options?: RemoteOptions): Promise<Remote>;
+    remove(name: string): Promise<void>;
+    list(): Remote[];
+    private wireChannelCallbacks;
+    private handleOperationWritten;
+    private handleInboxJob;
+    private handleOutboxJob;
+    private applyInboxJob;
+}
+//# sourceMappingURL=sync-manager.d.ts.map