@powerhousedao/reactor 6.0.0-dev.6 → 6.0.0-dev.61

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

@@ -0,0 +1,36 @@
+import { type IMailbox, type MailboxCallback } from "./mailbox.js";
+import type { SyncOperation } from "./sync-operation.js";
+export declare class BufferedMailbox implements IMailbox {
+    private itemsMap;
+    private addedCallbacks;
+    private removedCallbacks;
+    private addedBuffer;
+    private removedBuffer;
+    private addedTimer;
+    private removedTimer;
+    private readonly milliseconds;
+    private readonly maxQueued;
+    private paused;
+    private _ack;
+    private _latestOrdinal;
+    constructor(milliseconds: number, maxQueued: number);
+    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;
+    isPaused(): boolean;
+    flush(): void;
+    private scheduleAddedFlush;
+    private scheduleRemovedFlush;
+    private flushAdded;
+    private flushRemoved;
+    private invokeCallbacks;
+}
+//# sourceMappingURL=buffered-mailbox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buffered-mailbox.d.ts","sourceRoot":"","sources":["../../../src/sync/buffered-mailbox.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EAEb,KAAK,eAAe,EACrB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,gBAAgB,CAAyB;IACjD,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,MAAM,CAAkB;IAEhC,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,cAAc,CAAa;gBAEvB,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAKnD,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;IA+BpC,MAAM,CAAC,GAAG,KAAK,EAAE,aAAa,EAAE,GAAG,IAAI;IAiBvC,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAIxC,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAI1C,KAAK,IAAI,IAAI;IAYb,MAAM,IAAI,IAAI;IAUd,QAAQ,IAAI,OAAO;IAInB,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,eAAe;CAmBxB"}

package/dist/src/sync/buffered-mailbox.js

@@ -0,0 +1,164 @@
+import { MailboxAggregateError, } from "./mailbox.js";
+import { SyncOperationStatus } from "./types.js";
+export class BufferedMailbox {
+    itemsMap = new Map();
+    addedCallbacks = [];
+    removedCallbacks = [];
+    addedBuffer = [];
+    removedBuffer = [];
+    addedTimer = null;
+    removedTimer = null;
+    milliseconds;
+    maxQueued;
+    paused = false;
+    _ack = 0;
+    _latestOrdinal = 0;
+    constructor(milliseconds, maxQueued) {
+        this.milliseconds = milliseconds;
+        this.maxQueued = maxQueued;
+    }
+    init(ackOrdinal) {
+        this._ack = this._latestOrdinal = ackOrdinal;
+    }
+    get items() {
+        return Array.from(this.itemsMap.values());
+    }
+    get ackOrdinal() {
+        return this._ack;
+    }
+    get latestOrdinal() {
+        return this._latestOrdinal;
+    }
+    get(id) {
+        return this.itemsMap.get(id);
+    }
+    add(...items) {
+        for (const item of items) {
+            this.itemsMap.set(item.id, item);
+            // update latest ordinal
+            for (const op of item.operations) {
+                this._latestOrdinal = Math.max(this._latestOrdinal, op.context.ordinal);
+            }
+            // listen for updates to the syncop status
+            item.on((syncOp, _, next) => {
+                if (next === SyncOperationStatus.Applied) {
+                    for (const op of syncOp.operations) {
+                        this._ack = Math.max(this._ack, op.context.ordinal);
+                    }
+                }
+            });
+        }
+        this.addedBuffer.push(...items);
+        if (this.paused) {
+            return;
+        }
+        if (this.addedBuffer.length >= this.maxQueued) {
+            this.flushAdded();
+        }
+        else {
+            this.scheduleAddedFlush();
+        }
+    }
+    remove(...items) {
+        for (const item of items) {
+            this.itemsMap.delete(item.id);
+        }
+        this.removedBuffer.push(...items);
+        if (this.paused) {
+            return;
+        }
+        if (this.removedBuffer.length >= this.maxQueued) {
+            this.flushRemoved();
+        }
+        else {
+            this.scheduleRemovedFlush();
+        }
+    }
+    onAdded(callback) {
+        this.addedCallbacks.push(callback);
+    }
+    onRemoved(callback) {
+        this.removedCallbacks.push(callback);
+    }
+    pause() {
+        this.paused = true;
+        if (this.addedTimer !== null) {
+            clearTimeout(this.addedTimer);
+            this.addedTimer = null;
+        }
+        if (this.removedTimer !== null) {
+            clearTimeout(this.removedTimer);
+            this.removedTimer = null;
+        }
+    }
+    resume() {
+        this.paused = false;
+        if (this.addedBuffer.length > 0) {
+            this.scheduleAddedFlush();
+        }
+        if (this.removedBuffer.length > 0) {
+            this.scheduleRemovedFlush();
+        }
+    }
+    isPaused() {
+        return this.paused;
+    }
+    flush() {
+        this.flushAdded();
+        this.flushRemoved();
+    }
+    scheduleAddedFlush() {
+        if (this.addedTimer !== null) {
+            clearTimeout(this.addedTimer);
+        }
+        this.addedTimer = setTimeout(() => {
+            this.flushAdded();
+        }, this.milliseconds);
+    }
+    scheduleRemovedFlush() {
+        if (this.removedTimer !== null) {
+            clearTimeout(this.removedTimer);
+        }
+        this.removedTimer = setTimeout(() => {
+            this.flushRemoved();
+        }, this.milliseconds);
+    }
+    flushAdded() {
+        if (this.addedTimer !== null) {
+            clearTimeout(this.addedTimer);
+            this.addedTimer = null;
+        }
+        const items = this.addedBuffer;
+        this.addedBuffer = [];
+        if (items.length > 0) {
+            this.invokeCallbacks(this.addedCallbacks, items);
+        }
+    }
+    flushRemoved() {
+        if (this.removedTimer !== null) {
+            clearTimeout(this.removedTimer);
+            this.removedTimer = null;
+        }
+        const items = this.removedBuffer;
+        this.removedBuffer = [];
+        if (items.length > 0) {
+            this.invokeCallbacks(this.removedCallbacks, items);
+        }
+    }
+    invokeCallbacks(callbacks, items) {
+        const callbacksCopy = [...callbacks];
+        const errors = [];
+        for (const callback of callbacksCopy) {
+            try {
+                callback(items);
+            }
+            catch (error) {
+                errors.push(error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+        if (errors.length > 0) {
+            throw new MailboxAggregateError(errors);
+        }
+    }
+}
+//# sourceMappingURL=buffered-mailbox.js.map

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

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

package/dist/src/sync/channels/{gql-channel.d.ts → gql-req-channel.d.ts}

@@ -1,66 +1,71 @@
+import type { IOperationIndex } from "../../cache/operation-index-types.js";
 import type { ILogger } from "../../logging/types.js";
 import type { ISyncCursorStorage } from "../../storage/interfaces.js";
 import type { IChannel } from "../interfaces.js";
-import { Mailbox } from "../mailbox.js";
-import type { SyncOperation } from "../sync-operation.js";
-import type { RemoteFilter } from "../types.js";
+import { type IMailbox } from "../mailbox.js";
+import type { JwtHandler, RemoteFilter } from "../types.js";
+import type { IPollTimer } from "./poll-timer.js";
 /**
  * Configuration parameters for GqlChannel
  */
 export type GqlChannelConfig = {
     /** The GraphQL endpoint URL */
     url: string;
-    /** Authentication token for the remote */
-    authToken?: string;
-    /** Polling interval in milliseconds (default: 5000) */
-    pollIntervalMs?: number;
-    /** Base delay for exponential backoff retries in milliseconds (default: 1000) */
-    retryBaseDelayMs?: number;
-    /** Maximum delay for exponential backoff retries in milliseconds (default: 300000) */
-    retryMaxDelayMs?: number;
-    /** Maximum number of consecutive failures before marking as error (default: 5) */
-    maxFailures?: number;
+    /** Dynamic JWT token handler for generating fresh tokens per-request */
+    jwtHandler?: JwtHandler;
     /** Custom fetch function for testing (default: global fetch) */
     fetchFn?: typeof fetch;
     /** Collection ID to synchronize */
     collectionId: string;
     /** Filter to apply to operations */
     filter: RemoteFilter;
+    /** Base delay in ms for exponential backoff on push retries */
+    retryBaseDelayMs: number;
+    /** Maximum delay in ms for exponential backoff on push retries */
+    retryMaxDelayMs: number;
 };
 /**
  * GraphQL-based synchronization channel for network communication between reactors.
  */
-export declare class GqlChannel implements IChannel {
+export declare class GqlRequestChannel implements IChannel {
     private readonly logger;
-    readonly inbox: Mailbox<SyncOperation>;
-    readonly outbox: Mailbox<SyncOperation>;
-    readonly deadLetter: Mailbox<SyncOperation>;
+    readonly inbox: IMailbox;
+    readonly outbox: IMailbox;
+    readonly deadLetter: IMailbox;
+    readonly config: GqlChannelConfig;
+    private readonly bufferedOutbox;
     private readonly channelId;
     private readonly remoteName;
     private readonly cursorStorage;
-    private readonly config;
+    private readonly operationIndex;
+    private readonly pollTimer;
     private isShutdown;
-    private pollTimer?;
     private failureCount;
     private lastSuccessUtcMs?;
     private lastFailureUtcMs?;
-    constructor(logger: ILogger, channelId: string, remoteName: string, cursorStorage: ISyncCursorStorage, config: GqlChannelConfig);
+    private lastPersistedInboxOrdinal;
+    private lastPersistedOutboxOrdinal;
+    private pushFailureCount;
+    private pushRetryTimer;
+    private pushBlocked;
+    constructor(logger: ILogger, channelId: string, remoteName: string, cursorStorage: ISyncCursorStorage, config: GqlChannelConfig, operationIndex: IOperationIndex, pollTimer: IPollTimer);
     /**
      * Shuts down the channel and prevents further operations.
      */
-    shutdown(): void;
+    shutdown(): Promise<void>;
     /**
      * Initializes the channel by registering it on the remote server and starting polling.
      */
     init(): Promise<void>;
-    /**
-     * Starts the polling loop to fetch operations from the remote.
-     */
-    private startPolling;
     /**
      * Polls the remote for new sync envelopes.
      */
     private poll;
+    /**
+     * Handles dead letters reported by the remote server.
+     * Creates local dead letter SyncOperations so the channel quiesces.
+     */
+    private handleRemoteDeadLetters;
     /**
      * Handles polling errors with exponential backoff.
      */
@@ -78,33 +83,34 @@ export declare class GqlChannel implements IChannel {
      */
     private touchRemoteChannel;
     /**
-     * Handles sync operations added to the outbox by sending them to the remote.
+     * Fire-and-forget push with retry on recoverable errors.
+     * On success, clears push blocked state. On recoverable error, blocks
+     * further pushes and schedules a retry. On unrecoverable error, moves
+     * ops to deadLetter.
      */
-    private handleOutboxAdded;
+    private attemptPush;
     /**
-     * Pushes a sync operation to the remote via GraphQL mutation.
+     * Schedules a retry of all current outbox items using exponential backoff.
      */
-    private pushSyncOperation;
+    private schedulePushRetry;
     /**
-     * Serializes a SyncEnvelope for GraphQL transport.
-     *
-     * Signatures are serialized as comma-separated strings since GraphQL schema
-     * defines them as [String!]!. Extra context fields (resultingState, ordinal)
-     * are stripped since they are not defined in OperationContextInput.
+     * Returns true if the error is recoverable (transient network/HTTP/parse
+     * failure). Returns false for explicit GraphQL server rejections.
      */
-    private serializeEnvelope;
+    private isRecoverablePushError;
     /**
-     * Serializes an action for GraphQL transport, converting signature tuples to strings.
+     * Pushes multiple sync operations to the remote via a single GraphQL mutation.
+     * Creates one SyncEnvelope per SyncOperation with key/dependsOn for batch ordering.
      */
-    private serializeAction;
+    private pushSyncOperations;
     /**
-     * Executes a GraphQL query or mutation against the remote endpoint.
+     * Gets the authorization header value using jwtHandler.
      */
-    private executeGraphQL;
+    private getAuthorizationHeader;
     /**
-     * Updates the synchronization cursor for this channel's remote.
+     * Executes a GraphQL query or mutation against the remote endpoint.
      */
-    updateCursor(cursorOrdinal: number): Promise<void>;
+    private executeGraphQL;
     /**
      * Gets the current health status of the channel.
      */
@@ -114,5 +120,6 @@ export declare class GqlChannel implements IChannel {
         lastFailureUtcMs?: number;
         failureCount: number;
     };
+    get poller(): IPollTimer;
 }
-//# sourceMappingURL=gql-channel.d.ts.map
+//# sourceMappingURL=gql-req-channel.d.ts.map

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

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