@powerhousedao/reactor 6.0.0-dev.9 → 6.0.0-dev.90

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

@@ -1,5 +1,18 @@
+import type { Action } from "document-model";
 import { SyncOperation } from "../sync-operation.js";
-import type { SyncEnvelope } from "../types.js";
+import { type SyncEnvelope } from "../types.js";
+/**
+ * Serializes an action for GraphQL transport, converting signature tuples to strings.
+ */
+export declare function serializeAction(action: Action): unknown;
+/**
+ * Serializes a SyncEnvelope for GraphQL transport.
+ *
+ * Signatures are serialized as comma-separated strings since GraphQL schema
+ * defines them as [String!]!. The resultingState context field is stripped
+ * since it is not defined in OperationContextInput.
+ */
+export declare function serializeEnvelope(envelope: SyncEnvelope): unknown;
 /**
  * Converts a SyncEnvelope containing operations into a SyncOperation.
  *
@@ -27,4 +40,5 @@ export declare function envelopeToSyncOperation(envelope: SyncEnvelope, remoteNa
  * causality across documents.
  */
 export declare function envelopesToSyncOperations(envelope: SyncEnvelope, remoteName: string): SyncOperation[];
+export declare const getLatestAppliedOrdinal: (syncOps: SyncOperation[]) => number;
 //# sourceMappingURL=utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/sync/channels/utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAsDhD;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,MAAM,GACjB,aAAa,CA2Bf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,MAAM,GACjB,aAAa,EAAE,CAqBjB"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/sync/channels/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAwB,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAKrE;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAkBvD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CA0BjE;AAmDD;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,MAAM,GACjB,aAAa,CA6Bf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,MAAM,GACjB,aAAa,EAAE,CAuBjB;AAED,eAAO,MAAM,uBAAuB,GAAI,SAAS,aAAa,EAAE,KAAG,MAUlE,CAAC"}

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

@@ -1,12 +1,16 @@
-export type { IChannel, IChannelFactory, ISyncManager, Remote, } from "./interfaces.js";
+export type { ConnectionStateChangeCallback, 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 type { ChannelConfig, ChannelHealth, ChannelMeta, ConnectionState, ConnectionStateChangedEvent, ConnectionStateSnapshot, DeadLetterAddedEvent, JwtHandler, RemoteCursor, RemoteFilter, RemoteOptions, RemoteRecord, RemoteStatus, SyncEnvelope, SyncEnvelopeType, SyncFailedEvent, SyncOperationErrorType, SyncPendingEvent, SyncResult, SyncResultError, SyncResultStatus, SyncSucceededEvent, } from "./types.js";
+export { ChannelErrorSource, ChannelScheme, SyncEventTypes, SyncOperationStatus, } from "./types.js";
+export { BufferedMailbox } from "./buffered-mailbox.js";
+export { Mailbox, type IMailbox } from "./mailbox.js";
 export { SyncOperation, SyncOperationAggregateError, } from "./sync-operation.js";
-export { Mailbox, type MailboxItem } from "./mailbox.js";
 export { ChannelError, PollingChannelError } from "./errors.js";
-export { PollingChannel, GqlChannelFactory, CompositeChannelFactory, } from "./channels/index.js";
-export { SyncManager } from "./sync-manager.js";
+export { GqlRequestChannel, GqlRequestChannelFactory, GqlResponseChannel, GqlResponseChannelFactory, IntervalPollTimer, type GqlChannelConfig, type IPollTimer, } from "./channels/index.js";
 export { SyncBuilder } from "./sync-builder.js";
-export { createIdleHealth, filterOperations } from "./utils.js";
+export { SyncManager } from "./sync-manager.js";
+export { SyncStatus, SyncStatusTracker } from "./sync-status-tracker.js";
+export type { ISyncStatusTracker, SyncStatusChangeCallback, } from "./sync-status-tracker.js";
+export { batchOperationsByDocument, consolidateSyncOperations, createIdleHealth, filterOperations, sortEnvelopesByFirstOperationTimestamp, trimMailboxFromAckOrdinal, } from "./utils.js";
+export type { OperationBatch } from "./utils.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sync/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,6BAA6B,EAC7B,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,WAAW,EACX,eAAe,EACf,2BAA2B,EAC3B,uBAAuB,EACvB,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EACL,aAAa,EACb,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACzE,YAAY,EACV,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,gBAAgB,EAChB,sCAAsC,EACtC,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

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

@@ -1,8 +1,9 @@
+import type { IOperationIndex } from "../cache/operation-index-types.js";
 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";
+import type { IMailbox } from "./mailbox.js";
+import type { SyncStatus, SyncStatusChangeCallback } from "./sync-status-tracker.js";
+import type { ChannelConfig, ConnectionStateSnapshot, RemoteFilter, RemoteOptions, SyncResult } from "./types.js";
 /**
  * Represents a bidirectional synchronization channel between two reactor instances.
  *
@@ -10,29 +11,24 @@ import type { ChannelConfig, RemoteFilter, RemoteOptions } from "./types.js";
  * - 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 type ConnectionStateChangeCallback = (snapshot: ConnectionStateSnapshot) => void;
 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>;
+    inbox: IMailbox;
     /**
      * 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>;
+    outbox: IMailbox;
     /**
      * 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>;
+    deadLetter: IMailbox;
     /**
      * Initializes the channel asynchronously.
      * For remote channels, this typically involves registering the channel on the remote server.
@@ -42,14 +38,16 @@ export interface IChannel {
     /**
      * Shuts down the channel and prevents further operations.
      */
-    shutdown(): void;
+    shutdown(): Promise<void>;
     /**
-     * Updates the synchronization cursor for this channel.
-     * For polling channels, this also removes acknowledged operations from the outbox.
-     *
-     * @param cursorOrdinal - The last processed ordinal
+     * Returns the current connection state snapshot.
+     */
+    getConnectionState(): ConnectionStateSnapshot;
+    /**
+     * Registers a callback that fires when the connection state changes.
+     * Returns an unsubscribe function.
      */
-    updateCursor(cursorOrdinal: number): Promise<void>;
+    onConnectionStateChange(callback: ConnectionStateChangeCallback): () => void;
 }
 /**
  * Factory for creating channel instances.
@@ -67,9 +65,10 @@ export interface IChannelFactory {
      * @param cursorStorage - Storage for persisting synchronization cursors
      * @param collectionId - Collection ID to synchronize
      * @param filter - Filter to apply to operations
+     * @param operationIndex - Operation index for querying timestamps
      * @returns A new channel instance
      */
-    instance(remoteId: string, remoteName: string, config: ChannelConfig, cursorStorage: ISyncCursorStorage, collectionId: string, filter: RemoteFilter): IChannel;
+    instance(remoteId: string, remoteName: string, config: ChannelConfig, cursorStorage: ISyncCursorStorage, collectionId: string, filter: RemoteFilter, operationIndex: IOperationIndex): IChannel;
 }
 /**
  * Represents a configured remote with an active channel.
@@ -176,5 +175,29 @@ export interface ISyncManager {
      * @returns Array of all remotes
      */
     list(): Remote[];
+    /**
+     * Waits for sync operations for a job to complete.
+     * Resolves when SYNC_SUCCEEDED is emitted.
+     * Rejects when SYNC_FAILED is emitted.
+     *
+     * @param jobId - The job id to wait for
+     * @param signal - Optional abort signal
+     * @returns The sync result
+     */
+    waitForSync(jobId: string, signal?: AbortSignal): Promise<SyncResult>;
+    /**
+     * Gets the current sync status for a document.
+     *
+     * @param documentId - The document ID to check
+     * @returns The sync status, or undefined if the document has never been tracked
+     */
+    getSyncStatus(documentId: string): SyncStatus | undefined;
+    /**
+     * Registers a callback that fires when a document's sync status changes.
+     *
+     * @param callback - Called with (documentId, newStatus) on each transition
+     * @returns Unsubscribe function
+     */
+    onSyncStatusChange(callback: SyncStatusChangeCallback): () => void;
 }
 //# sourceMappingURL=interfaces.d.ts.map

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

@@ -1 +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;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAC;IAEjB;;;;;OAKG;IACH,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;OAUG;IACH,QAAQ,CACN,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,aAAa,EACrB,aAAa,EAAE,kBAAkB,EACjC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,YAAY,GACnB,QAAQ,CAAC;CACb;AAED;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;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,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAEhC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAE5B;;;;;;;;;;;;;;OAcG;IACH,GAAG,CACD,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,aAAa,EAC5B,MAAM,CAAC,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,aAAa,EACvB,EAAE,CAAC,EAAE,MAAM,GACV,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"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/sync/interfaces.ts"],"names":[],"mappings":"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"}

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

@@ -1,21 +1,60 @@
-export type MailboxItem = {
-    id: string;
-};
-type MailboxCallback<T extends MailboxItem> = (item: T) => void;
+import type { SyncOperation } from "./sync-operation.js";
+export type MailboxCallback = (items: SyncOperation[]) => void;
+/**
+ * The Mailbox interface is not intended to use any persistence. Instead, the
+ * IChannel implementation is responsible for persisting cursors or other data.
+ *
+ * This means that ackOrdinal and latestOrdinal are in memory only.
+ */
+export interface IMailbox {
+    get items(): ReadonlyArray<SyncOperation>;
+    /**
+     * The latest ordinal that has been acknowledged. Because acknowledged items
+     * are removed from the mailbox, this is the last ordinal that has been removed.
+     */
+    get ackOrdinal(): number;
+    /**
+     * The latest ordinal of the items that are or have been added to the mailbox.
+     * This may be greater than the ack ordinal if items have been added but not
+     * yet acknowledged.
+     */
+    get latestOrdinal(): number;
+    init(ackOrdinal: number): void;
+    get(id: string): SyncOperation | undefined;
+    add(...items: SyncOperation[]): void;
+    remove(...items: SyncOperation[]): void;
+    onAdded(callback: MailboxCallback): void;
+    onRemoved(callback: MailboxCallback): void;
+    pause(): void;
+    resume(): void;
+    flush(): void;
+    isPaused(): boolean;
+}
 export declare class MailboxAggregateError extends Error {
     errors: Error[];
     constructor(errors: Error[]);
 }
-export declare class Mailbox<T extends MailboxItem> {
+export declare class Mailbox implements IMailbox {
     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;
+    private paused;
+    private addedBuffer;
+    private removedBuffer;
+    private _ack;
+    private _latestOrdinal;
+    init(ackOrdinal: number): void;
+    get items(): ReadonlyArray<SyncOperation>;
+    get ackOrdinal(): number;
+    get latestOrdinal(): number;
+    get(id: string): SyncOperation | undefined;
+    add(...items: SyncOperation[]): void;
+    remove(...items: SyncOperation[]): void;
+    onAdded(callback: MailboxCallback): void;
+    onRemoved(callback: MailboxCallback): void;
+    pause(): void;
+    resume(): void;
+    flush(): void;
+    isPaused(): boolean;
 }
-export {};
 //# sourceMappingURL=mailbox.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"mailbox.d.ts","sourceRoot":"","sources":["../../../src/sync/mailbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,IAAI,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,KAAK,IAAI,aAAa,CAAC,aAAa,CAAC,CAAC;IAE1C;;;OAGG;IACH,IAAI,UAAU,IAAI,MAAM,CAAC;IAEzB;;;;OAIG;IACH,IAAI,aAAa,IAAI,MAAM,CAAC;IAG5B,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IAC3C,GAAG,CAAC,GAAG,KAAK,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IACrC,MAAM,CAAC,GAAG,KAAK,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAGxC,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IAG3C,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;IACf,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,IAAI,OAAO,CAAC;CACrB;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,MAAM,EAAE,KAAK,EAAE,CAAC;gBAEJ,MAAM,EAAE,KAAK,EAAE;CAQ5B;AAED,qBAAa,OAAQ,YAAW,QAAQ;IACtC,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,gBAAgB,CAAyB;IACjD,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,aAAa,CAAuB;IAE5C,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,cAAc,CAAa;IAEnC,IAAI,CAAC,UAAU,EAAE,MAAM;IAIvB,IAAI,KAAK,IAAI,aAAa,CAAC,aAAa,CAAC,CAExC;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI1C,GAAG,CAAC,GAAG,KAAK,EAAE,aAAa,EAAE,GAAG,IAAI;IAsCpC,MAAM,CAAC,GAAG,KAAK,EAAE,aAAa,EAAE,GAAG,IAAI;IAwBvC,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAIxC,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAI1C,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,IAAI;IAKd,KAAK,IAAI,IAAI;IAsCb,QAAQ,IAAI,OAAO;CAGpB"}

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

@@ -0,0 +1,34 @@
+import type { IEventBus } from "../events/interfaces.js";
+import { type SyncResult } from "./types.js";
+/**
+ * Provides a promise-based interface for waiting on sync completion.
+ * Subscribes to sync events at construction and tracks completed sync results
+ * to provide a fast path for jobs that have already synced.
+ */
+export declare class SyncAwaiter {
+    private readonly eventBus;
+    private readonly completedResults;
+    private readonly pendingWaiters;
+    private readonly unsubscribers;
+    private isShutdown;
+    constructor(eventBus: IEventBus);
+    /**
+     * Waits for sync operations for a job to complete.
+     * Resolves when SYNC_SUCCEEDED is emitted.
+     * Rejects when SYNC_FAILED is emitted.
+     *
+     * @param jobId - The job id to wait for
+     * @param signal - Optional abort signal
+     * @returns The sync result
+     */
+    waitForSync(jobId: string, signal?: AbortSignal): Promise<SyncResult>;
+    /**
+     * Shuts down the sync awaiter. This will synchronously reject all pending waiters.
+     */
+    shutdown(): void;
+    private subscribeToEvents;
+    private handleSyncSucceeded;
+    private handleSyncFailed;
+    private resolveWaiters;
+}
+//# sourceMappingURL=sync-awaiter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync-awaiter.d.ts","sourceRoot":"","sources":["../../../src/sync/sync-awaiter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,YAAY,CAAC;AAQpB;;;;GAIG;AACH,qBAAa,WAAW;IAMV,OAAO,CAAC,QAAQ,CAAC,QAAQ;IALrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAiC;IAClE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmC;IAClE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,UAAU,CAAS;gBAEE,QAAQ,EAAE,SAAS;IAIhD;;;;;;;;OAQG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAyCrE;;OAEG;IACH,QAAQ,IAAI,IAAI;IAgBhB,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,cAAc;CAgBvB"}

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

@@ -3,16 +3,20 @@ import type { IOperationIndex } from "../cache/operation-index-types.js";
 import type { IReactor, SyncModule } from "../core/types.js";
 import type { IEventBus } from "../events/interfaces.js";
 import type { ILogger } from "../logging/types.js";
-import type { ISyncCursorStorage, ISyncRemoteStorage } from "../storage/interfaces.js";
+import type { ISyncCursorStorage, ISyncDeadLetterStorage, 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?;
+    private deadLetterStorage?;
+    private maxDeadLettersPerRemote;
     withChannelFactory(factory: IChannelFactory): this;
     withRemoteStorage(storage: ISyncRemoteStorage): this;
     withCursorStorage(storage: ISyncCursorStorage): this;
+    withDeadLetterStorage(storage: ISyncDeadLetterStorage): this;
+    withMaxDeadLettersPerRemote(limit: number): this;
     build(reactor: IReactor, logger: ILogger, operationIndex: IOperationIndex, eventBus: IEventBus, db: Kysely<Database>): ISyncManager;
     buildModule(reactor: IReactor, logger: ILogger, operationIndex: IOperationIndex, eventBus: IEventBus, db: Kysely<Database>): SyncModule;
 }

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

@@ -1 +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,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,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,MAAM,EAAE,OAAO,EACf,cAAc,EAAE,eAAe,EAC/B,QAAQ,EAAE,SAAS,EACnB,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,GACnB,YAAY;IAWf,WAAW,CACT,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,OAAO,EACf,cAAc,EAAE,eAAe,EAC/B,QAAQ,EAAE,SAAS,EACnB,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,GACnB,UAAU;CAyBd"}
+{"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,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAIlC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,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;IAC3C,OAAO,CAAC,iBAAiB,CAAC,CAAyB;IACnD,OAAO,CAAC,uBAAuB,CAAe;IAE9C,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAKlD,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAKpD,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAKpD,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAK5D,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKhD,KAAK,CACH,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,OAAO,EACf,cAAc,EAAE,eAAe,EAC/B,QAAQ,EAAE,SAAS,EACnB,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,GACnB,YAAY;IAWf,WAAW,CACT,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,OAAO,EACf,cAAc,EAAE,eAAe,EAC/B,QAAQ,EAAE,SAAS,EACnB,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,GACnB,UAAU;CA8Bd"}

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

@@ -3,35 +3,49 @@ import type { IReactor } from "../core/types.js";
 import type { IEventBus } from "../events/interfaces.js";
 import type { ILogger } from "../logging/types.js";
 import { type JobInfo, type ShutdownStatus } from "../shared/types.js";
-import type { ISyncCursorStorage, ISyncRemoteStorage } from "../storage/interfaces.js";
+import type { ISyncCursorStorage, ISyncDeadLetterStorage, ISyncRemoteStorage } from "../storage/interfaces.js";
 import type { IChannelFactory, ISyncManager, Remote } from "./interfaces.js";
-import type { ChannelConfig, RemoteFilter, RemoteOptions } from "./types.js";
+import { type SyncStatus, type SyncStatusChangeCallback } from "./sync-status-tracker.js";
+import type { ChannelConfig, RemoteFilter, RemoteOptions, SyncResult } from "./types.js";
 export declare class SyncManager implements ISyncManager {
     private readonly logger;
     private readonly remoteStorage;
     private readonly cursorStorage;
+    private readonly deadLetterStorage;
     private readonly channelFactory;
-    private readonly _operationIndex;
+    private readonly operationIndex;
     private readonly reactor;
     private readonly eventBus;
     private readonly remotes;
     private readonly awaiter;
+    private readonly syncAwaiter;
     private isShutdown;
     private eventUnsubscribe?;
+    private failedEventUnsubscribe?;
+    private readonly batchAggregator;
+    private readonly syncStatusTracker;
+    private readonly maxDeadLettersPerRemote;
+    private readonly connectionStateUnsubscribes;
     loadJobs: Map<string, JobInfo>;
-    constructor(logger: ILogger, remoteStorage: ISyncRemoteStorage, cursorStorage: ISyncCursorStorage, channelFactory: IChannelFactory, operationIndex: IOperationIndex, reactor: IReactor, eventBus: IEventBus);
+    constructor(logger: ILogger, remoteStorage: ISyncRemoteStorage, cursorStorage: ISyncCursorStorage, deadLetterStorage: ISyncDeadLetterStorage, channelFactory: IChannelFactory, operationIndex: IOperationIndex, reactor: IReactor, eventBus: IEventBus, maxDeadLettersPerRemote?: number);
     startup(): Promise<void>;
     shutdown(): ShutdownStatus;
     getByName(name: string): Remote;
     getById(id: string): Remote;
     add(name: string, collectionId: string, channelConfig: ChannelConfig, filter?: RemoteFilter, options?: RemoteOptions, id?: string): Promise<Remote>;
-    private backfillOutbox;
     remove(name: string): Promise<void>;
     list(): Remote[];
+    waitForSync(jobId: string, signal?: AbortSignal): Promise<SyncResult>;
+    getSyncStatus(documentId: string): SyncStatus | undefined;
+    onSyncStatusChange(callback: SyncStatusChangeCallback): () => void;
     private wireChannelCallbacks;
-    private handleOperationWritten;
-    private handleInboxJob;
-    private handleOutboxJob;
+    private loadDeadLetters;
+    private getRemotesForCollection;
+    private processCompleteBatch;
+    private handleInboxAdded;
     private applyInboxJob;
+    private applyInboxBatch;
+    private updateOutbox;
+    private getOperationsForRemote;
 }
 //# sourceMappingURL=sync-manager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sync-manager.d.ts","sourceRoot":"","sources":["../../../src/sync/sync-manager.ts"],"names":[],"mappings":"AACA,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;AAKzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE7E,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EAGd,MAAM,YAAY,CAAC;AAQpB,qBAAa,WAAY,YAAW,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkB;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAW;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAY;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,gBAAgB,CAAC,CAAa;IAE/B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAa;gBAGhD,MAAM,EAAE,OAAO,EACf,aAAa,EAAE,kBAAkB,EACjC,aAAa,EAAE,kBAAkB,EACjC,cAAc,EAAE,eAAe,EAC/B,cAAc,EAAE,eAAe,EAC/B,OAAO,EAAE,QAAQ,EACjB,QAAQ,EAAE,SAAS;IAgBf,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA6C9B,QAAQ,IAAI,cAAc;IA2B1B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQ/B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IASrB,GAAG,CACP,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,aAAa,EAC5B,MAAM,GAAE,YAAwD,EAChE,OAAO,GAAE,aAAkB,EAC3B,EAAE,CAAC,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC;YAkEJ,cAAc;IAsDtB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzC,IAAI,IAAI,MAAM,EAAE;IAIhB,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,sBAAsB;IAiC9B,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,eAAe;YAUT,aAAa;CAsD5B"}
+{"version":3,"file":"sync-manager.d.ts","sourceRoot":"","sources":["../../../src/sync/sync-manager.ts"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-import type { OperationWithContext } from "../storage/interfaces.js";
+import type { OperationWithContext } from "@powerhousedao/shared/document-model";
 import type { ChannelError } from "./errors.js";
 import { SyncOperationStatus } from "./types.js";
 type SyncOperationStatusCallback = (syncOp: SyncOperation, prev: SyncOperationStatus, next: SyncOperationStatus) => void;
@@ -8,6 +8,8 @@ export declare class SyncOperationAggregateError extends Error {
 }
 export declare class SyncOperation {
     readonly id: string;
+    readonly jobId: string;
+    jobDependencies: string[];
     readonly remoteName: string;
     readonly documentId: string;
     readonly scopes: string[];
@@ -16,7 +18,7 @@ export declare class SyncOperation {
     status: SyncOperationStatus;
     error?: ChannelError;
     private callbacks;
-    constructor(id: string, remoteName: string, documentId: string, scopes: string[], branch: string, operations: OperationWithContext[]);
+    constructor(id: string, jobId: string, jobDependencies: string[], remoteName: string, documentId: string, scopes: string[], branch: string, operations: OperationWithContext[]);
     on(callback: SyncOperationStatusCallback): void;
     started(): void;
     transported(): void;

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

@@ -1 +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"}
+{"version":3,"file":"sync-operation.d.ts","sourceRoot":"","sources":["../../../src/sync/sync-operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,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,KAAK,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,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,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,EAAE,EACzB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,oBAAoB,EAAE;IAapC,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;CAkBnB"}

package/dist/src/sync/sync-status-tracker.d.ts

@@ -0,0 +1,31 @@
+import type { IChannel } from "./interfaces.js";
+export declare enum SyncStatus {
+    Synced = "SYNCED",
+    Outgoing = "OUTGOING",
+    Incoming = "INCOMING",
+    OutgoingAndIncoming = "OUTGOING_AND_INCOMING",
+    Error = "ERROR"
+}
+export type SyncStatusChangeCallback = (documentId: string, status: SyncStatus) => void;
+export interface ISyncStatusTracker {
+    getStatus(documentId: string): SyncStatus | undefined;
+    onChange(callback: SyncStatusChangeCallback): () => void;
+    trackRemote(remoteName: string, channel: IChannel): void;
+    untrackRemote(remoteName: string): void;
+    clear(): void;
+}
+export declare class SyncStatusTracker implements ISyncStatusTracker {
+    private readonly remotes;
+    private readonly seen;
+    private readonly callbacks;
+    getStatus(documentId: string): SyncStatus | undefined;
+    onChange(callback: SyncStatusChangeCallback): () => void;
+    trackRemote(remoteName: string, channel: IChannel): void;
+    untrackRemote(remoteName: string): void;
+    clear(): void;
+    private handleAdded;
+    private handleRemoved;
+    private getOrCreateCounts;
+    private notifyChange;
+}
+//# sourceMappingURL=sync-status-tracker.d.ts.map

package/dist/src/sync/sync-status-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-status-tracker.d.ts","sourceRoot":"","sources":["../../../src/sync/sync-status-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD,oBAAY,UAAU;IACpB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,mBAAmB,0BAA0B;IAC7C,KAAK,UAAU;CAChB;AAED,MAAM,MAAM,wBAAwB,GAAG,CACrC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,UAAU,KACf,IAAI,CAAC;AAEV,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,IAAI,CAAC;IACzD,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAC;IACzD,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,KAAK,IAAI,IAAI,CAAC;CACf;AAUD,qBAAa,iBAAkB,YAAW,kBAAkB;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CACZ;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0B;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4C;IAEtE,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAqBrD,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,IAAI;IAOxD,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI;IAoBxD,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAcvC,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,WAAW;IA+BnB,OAAO,CAAC,aAAa;IAwBrB,OAAO,CAAC,iBAAiB;IAmBzB,OAAO,CAAC,YAAY;CAUrB"}

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

@@ -1,5 +1,17 @@
-import type { OperationWithContext } from "../storage/interfaces.js";
-export type RemoteOptions = {};
+import type { OperationWithContext } from "@powerhousedao/shared/document-model";
+export declare enum ChannelScheme {
+    CONNECT = "connect",
+    SWITCHBOARD = "switchboard"
+}
+/**
+ * Dynamic JWT token handler for generating authentication tokens per-request.
+ * Called with the target URL to enable audience-specific tokens (aud claim).
+ * Returns undefined if no authentication is available (e.g., user not logged in).
+ */
+export type JwtHandler = (url: string) => Promise<string | undefined>;
+export type RemoteOptions = {
+    sinceTimestampUtcMs: string;
+};
 export type RemoteFilter = {
     documentId: string[];
     scope: string[];
@@ -7,6 +19,7 @@ export type RemoteFilter = {
 };
 export type RemoteCursor = {
     remoteName: string;
+    cursorType: string;
     cursorOrdinal: number;
     lastSyncedAtUtcMs?: number;
 };
@@ -19,6 +32,8 @@ export type SyncEnvelope = {
     channelMeta: ChannelMeta;
     operations?: OperationWithContext[];
     cursor?: RemoteCursor;
+    key?: string;
+    dependsOn?: string[];
 };
 export declare enum SyncOperationStatus {
     Unknown = -1,
@@ -40,6 +55,22 @@ export type ChannelHealth = {
     lastFailureUtcMs?: number;
     failureCount: number;
 };
+export type ConnectionState = "connecting" | "connected" | "disconnected" | "reconnecting" | "error";
+export type ConnectionStateSnapshot = {
+    state: ConnectionState;
+    failureCount: number;
+    lastSuccessUtcMs: number;
+    lastFailureUtcMs: number;
+    pushBlocked: boolean;
+    pushFailureCount: number;
+};
+export type ConnectionStateChangedEvent = {
+    remoteName: string;
+    remoteId: string;
+    previous: ConnectionState;
+    current: ConnectionState;
+    snapshot: ConnectionStateSnapshot;
+};
 export type RemoteStatus = {
     push: ChannelHealth;
     pull: ChannelHealth;
@@ -57,4 +88,78 @@ export type RemoteRecord = {
     options: RemoteOptions;
     status: RemoteStatus;
 };
+/**
+ * Event types for sync lifecycle events.
+ * These events track the sync progress of a job's operations to remotes.
+ * Uses a separate namespace (20000 range) from ReactorEventTypes (10000 range).
+ */
+export declare const SyncEventTypes: {
+    readonly SYNC_PENDING: 20001;
+    readonly SYNC_SUCCEEDED: 20002;
+    readonly SYNC_FAILED: 20003;
+    readonly DEAD_LETTER_ADDED: 20004;
+    readonly CONNECTION_STATE_CHANGED: 20005;
+};
+/**
+ * Event emitted when all SyncOperations for a job are queued in outboxes.
+ */
+export type SyncPendingEvent = {
+    jobId: string;
+    syncOperationCount: number;
+    remoteNames: string[];
+};
+/**
+ * Event emitted when all sync operations for a job succeed.
+ */
+export type SyncSucceededEvent = {
+    jobId: string;
+    syncOperationCount: number;
+};
+/**
+ * Event emitted when at least one sync operation for a job fails.
+ */
+export type SyncFailedEvent = {
+    jobId: string;
+    successCount: number;
+    failureCount: number;
+    errors: Array<{
+        remoteName: string;
+        documentId: string;
+        error: string;
+    }>;
+};
+/**
+ * Event emitted when a sync operation is moved to dead letter storage.
+ */
+export type DeadLetterAddedEvent = {
+    id: string;
+    jobId: string;
+    remoteName: string;
+    documentId: string;
+    errorSource: ChannelErrorSource;
+};
+/**
+ * Status of a sync operation result.
+ */
+export type SyncResultStatus = "succeeded" | "failed";
+/**
+ * Error information for a failed sync operation to a specific remote.
+ */
+export type SyncResultError = {
+    remoteName: string;
+    documentId: string;
+    error: string;
+};
+/**
+ * Result of waiting for sync operations to complete for a job.
+ * Returned by ISyncManager.waitForSync().
+ */
+export type SyncResult = {
+    jobId: string;
+    status: SyncResultStatus;
+    syncOperationCount: number;
+    successCount: number;
+    failureCount: number;
+    errors: SyncResultError[];
+};
 //# sourceMappingURL=types.d.ts.map