@powerhousedao/reactor 6.0.0-dev.42 → 6.0.0-dev.44

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

@@ -2,12 +2,12 @@ import { BufferedMailbox } from "../buffered-mailbox.js";
 import { ChannelError } from "../errors.js";
 import { Mailbox } from "../mailbox.js";
 import { ChannelErrorSource } from "../types.js";
-import { sortEnvelopesByFirstOperationTimestamp } from "../utils.js";
-import { envelopesToSyncOperations } from "./utils.js";
+import { sortEnvelopesByFirstOperationTimestamp, trimMailboxFromAckOrdinal, } from "../utils.js";
+import { envelopesToSyncOperations, getLatestAppliedOrdinal, serializeEnvelope, } from "./utils.js";
 /**
  * GraphQL-based synchronization channel for network communication between reactors.
  */
-export class GqlChannel {
+export class GqlRequestChannel {
     logger;
     inbox;
     outbox;
@@ -23,6 +23,8 @@ export class GqlChannel {
     failureCount;
     lastSuccessUtcMs;
     lastFailureUtcMs;
+    lastPersistedInboxOrdinal = 0;
+    lastPersistedOutboxOrdinal = 0;
     constructor(logger, channelId, remoteName, cursorStorage, config, operationIndex, pollTimer) {
         this.logger = logger;
         this.channelId = channelId;
@@ -46,8 +48,56 @@ export class GqlChannel {
         this.bufferedOutbox = new BufferedMailbox(500, 25);
         this.outbox = this.bufferedOutbox;
         this.deadLetter = new Mailbox();
+        // when sync ops are added to the outbox, push them to the remote
         this.outbox.onAdded((syncOps) => {
-            this.handleOutboxAdded(syncOps);
+            if (this.isShutdown) {
+                return;
+            }
+            this.pushSyncOperations(syncOps).catch((error) => {
+                const err = error instanceof Error ? error : new Error(String(error));
+                const channelError = new ChannelError(ChannelErrorSource.Outbox, err);
+                for (const syncOp of syncOps) {
+                    syncOp.failed(channelError);
+                }
+                // move to dead letters
+                this.deadLetter.add(...syncOps);
+                this.outbox.remove(...syncOps);
+            });
+        });
+        // Instead of listening to syncops directly for cursor updates, we listen
+        // to the mailbox. This is for efficiency: many syncops may fire on a trim,
+        // but only one onRemoved callback will be fired for the batch.
+        this.outbox.onRemoved((syncOps) => {
+            const maxOrdinal = getLatestAppliedOrdinal(syncOps);
+            if (maxOrdinal > this.lastPersistedOutboxOrdinal) {
+                this.lastPersistedOutboxOrdinal = maxOrdinal;
+                this.cursorStorage
+                    .upsert({
+                    remoteName: this.remoteName,
+                    cursorType: "outbox",
+                    cursorOrdinal: maxOrdinal,
+                    lastSyncedAtUtcMs: Date.now(),
+                })
+                    .catch((error) => {
+                    this.logger.error("Failed to update outbox cursor for @ChannelId! This means that future application runs may resend duplicate operations. This is recoverable (with deduplication protection), but not-optimal: @Error", this.channelId, error);
+                });
+            }
+        });
+        this.inbox.onRemoved((syncOps) => {
+            const maxOrdinal = getLatestAppliedOrdinal(syncOps);
+            if (maxOrdinal > this.lastPersistedInboxOrdinal) {
+                this.lastPersistedInboxOrdinal = maxOrdinal;
+                this.cursorStorage
+                    .upsert({
+                    remoteName: this.remoteName,
+                    cursorType: "inbox",
+                    cursorOrdinal: maxOrdinal,
+                    lastSyncedAtUtcMs: Date.now(),
+                })
+                    .catch((error) => {
+                    this.logger.error("Failed to update inbox cursor for @ChannelId! This is unlikely to cause a problem, but not-optimal: @Error", this.channelId, error);
+                });
+            }
         });
     }
     /**
@@ -57,12 +107,21 @@ export class GqlChannel {
         this.bufferedOutbox.flush();
         this.isShutdown = true;
         this.pollTimer.stop();
+        return Promise.resolve();
     }
     /**
      * Initializes the channel by registering it on the remote server and starting polling.
      */
     async init() {
         await this.touchRemoteChannel();
+        // get cursors -- these are the last acknowledged ordinals for the inbox and outbox
+        const cursors = await this.cursorStorage.list(this.remoteName);
+        const inboxOrdinal = cursors.find((c) => c.cursorType === "inbox")?.cursorOrdinal ?? 0;
+        const outboxOrdinal = cursors.find((c) => c.cursorType === "outbox")?.cursorOrdinal ?? 0;
+        this.inbox.init(inboxOrdinal);
+        this.outbox.init(outboxOrdinal);
+        this.lastPersistedInboxOrdinal = inboxOrdinal;
+        this.lastPersistedOutboxOrdinal = outboxOrdinal;
         this.pollTimer.setDelegate(() => this.poll());
         this.pollTimer.start();
     }
@@ -76,58 +135,35 @@ export class GqlChannel {
         if (this.failureCount >= this.config.maxFailures) {
             return;
         }
-        let cursor;
+        let response;
         try {
-            cursor = await this.cursorStorage.get(this.remoteName);
+            response = await this.pollSyncEnvelopes(this.inbox.ackOrdinal, this.inbox.latestOrdinal);
         }
         catch (error) {
             this.handlePollError(error);
             return;
         }
-        const cursorOrdinal = cursor.cursorOrdinal;
-        let envelopes;
-        try {
-            envelopes = await this.pollSyncEnvelopes(cursorOrdinal);
-        }
-        catch (error) {
-            this.handlePollError(error);
-            return;
+        const { envelopes, ackOrdinal } = response;
+        // first: trim outbox
+        if (ackOrdinal > 0) {
+            trimMailboxFromAckOrdinal(this.outbox, ackOrdinal);
         }
-        let maxCursorOrdinal = cursorOrdinal;
+        // todo: Is this necessary? Outbox items should have been sorted when returned.
         const sortedEnvelopes = sortEnvelopesByFirstOperationTimestamp(envelopes);
-        const hasKeyedEnvelopes = sortedEnvelopes.some((e) => e.key || (e.dependsOn && e.dependsOn.length > 0));
-        if (hasKeyedEnvelopes) {
-            this.inbox.pause();
-        }
-        try {
-            for (const envelope of sortedEnvelopes) {
-                if (envelope.type.toLowerCase() === "operations" &&
-                    envelope.operations) {
-                    const syncOps = envelopesToSyncOperations(envelope, this.remoteName);
-                    for (const syncOp of syncOps) {
-                        syncOp.transported();
-                        this.inbox.add(syncOp);
-                    }
+        // convert the envelopes to sync operations
+        const allSyncOps = [];
+        for (const envelope of sortedEnvelopes) {
+            if (envelope.type.toLowerCase() === "operations" && envelope.operations) {
+                const syncOps = envelopesToSyncOperations(envelope, this.remoteName);
+                for (const syncOp of syncOps) {
+                    syncOp.transported();
                 }
-                if (envelope.cursor &&
-                    envelope.cursor.cursorOrdinal > maxCursorOrdinal) {
-                    maxCursorOrdinal = envelope.cursor.cursorOrdinal;
-                }
-            }
-        }
-        finally {
-            if (hasKeyedEnvelopes) {
-                this.inbox.resume();
+                allSyncOps.push(...syncOps);
             }
         }
-        if (maxCursorOrdinal > cursorOrdinal) {
-            try {
-                await this.updateCursor(maxCursorOrdinal);
-            }
-            catch (error) {
-                this.handlePollError(error);
-                return;
-            }
+        // add all of them to the inbox
+        if (allSyncOps.length > 0) {
+            this.inbox.add(...allSyncOps);
         }
         this.lastSuccessUtcMs = Date.now();
         this.failureCount = 0;
@@ -171,74 +207,82 @@ export class GqlChannel {
     /**
      * Queries the remote GraphQL endpoint for sync envelopes.
      */
-    async pollSyncEnvelopes(cursorOrdinal) {
+    async pollSyncEnvelopes(ackOrdinal, latestOrdinal) {
         const query = `
-      query PollSyncEnvelopes($channelId: String!, $cursorOrdinal: Int!) {
-        pollSyncEnvelopes(channelId: $channelId, cursorOrdinal: $cursorOrdinal) {
-          type
-          channelMeta {
-            id
-          }
-          operations {
-            operation {
-              index
-              timestampUtcMs
-              hash
-              skip
-              error
+      query PollSyncEnvelopes($channelId: String!, $outboxAck: Int!, $outboxLatest: Int!) {
+        pollSyncEnvelopes(channelId: $channelId, outboxAck: $outboxAck, outboxLatest: $outboxLatest) {
+          envelopes {
+            type
+            channelMeta {
               id
-              action {
-                id
-                type
+            }
+            operations {
+              operation {
+                index
                 timestampUtcMs
-                input
-                scope
-                attachments {
-                  data
-                  mimeType
-                  hash
-                  extension
-                  fileName
-                }
-                context {
-                  signer {
-                    user {
-                      address
-                      networkId
-                      chainId
-                    }
-                    app {
-                      name
-                      key
+                hash
+                skip
+                error
+                id
+                action {
+                  id
+                  type
+                  timestampUtcMs
+                  input
+                  scope
+                  attachments {
+                    data
+                    mimeType
+                    hash
+                    extension
+                    fileName
+                  }
+                  context {
+                    signer {
+                      user {
+                        address
+                        networkId
+                        chainId
+                      }
+                      app {
+                        name
+                        key
+                      }
+                      signatures
                     }
-                    signatures
                   }
                 }
               }
+              context {
+                documentId
+                documentType
+                scope
+                branch
+                ordinal
+              }
             }
-            context {
-              documentId
-              documentType
-              scope
-              branch
+            cursor {
+              remoteName
+              cursorOrdinal
+              lastSyncedAtUtcMs
             }
+            key
+            dependsOn
           }
-          cursor {
-            remoteName
-            cursorOrdinal
-            lastSyncedAtUtcMs
-          }
-          key
-          dependsOn
+          ackOrdinal
         }
       }
     `;
         const variables = {
             channelId: this.channelId,
-            cursorOrdinal,
+            outboxAck: ackOrdinal,
+            outboxLatest: latestOrdinal,
         };
         const response = await this.executeGraphQL(query, variables);
-        return response.pollSyncEnvelopes;
+        return {
+            envelopes: response.pollSyncEnvelopes.envelopes,
+            ackOrdinal: response.pollSyncEnvelopes.ackOrdinal,
+        };
     }
     /**
      * Registers or updates this channel on the remote server via GraphQL mutation.
@@ -274,24 +318,6 @@ export class GqlChannel {
         };
         await this.executeGraphQL(mutation, variables);
     }
-    /**
-     * Handles sync operations added to the outbox by sending them to the remote.
-     */
-    handleOutboxAdded(syncOps) {
-        if (this.isShutdown) {
-            return;
-        }
-        // Execute async but don't await (fire and forget with error handling)
-        this.pushSyncOperations(syncOps).catch((error) => {
-            const err = error instanceof Error ? error : new Error(String(error));
-            const channelError = new ChannelError(ChannelErrorSource.Outbox, err);
-            for (const syncOp of syncOps) {
-                syncOp.failed(channelError);
-                this.deadLetter.add(syncOp);
-                this.outbox.remove(syncOp);
-            }
-        });
-    }
     /**
      * Pushes multiple sync operations to the remote via a single GraphQL mutation.
      * Creates one SyncEnvelope per SyncOperation with key/dependsOn for batch ordering.
@@ -333,64 +359,9 @@ export class GqlChannel {
       }
     `;
         const variables = {
-            envelopes: envelopes.map((e) => this.serializeEnvelope(e)),
+            envelopes: envelopes.map((e) => serializeEnvelope(e)),
         };
         await this.executeGraphQL(mutation, variables);
-        for (const syncOp of syncOps) {
-            this.outbox.remove(syncOp);
-        }
-    }
-    /**
-     * 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.
-     */
-    serializeEnvelope(envelope) {
-        return {
-            type: envelope.type.toUpperCase(),
-            channelMeta: envelope.channelMeta,
-            operations: envelope.operations?.map((opWithContext) => ({
-                operation: {
-                    index: opWithContext.operation.index,
-                    timestampUtcMs: opWithContext.operation.timestampUtcMs,
-                    hash: opWithContext.operation.hash,
-                    skip: opWithContext.operation.skip,
-                    error: opWithContext.operation.error,
-                    id: opWithContext.operation.id,
-                    action: this.serializeAction(opWithContext.operation.action),
-                },
-                context: {
-                    documentId: opWithContext.context.documentId,
-                    documentType: opWithContext.context.documentType,
-                    scope: opWithContext.context.scope,
-                    branch: opWithContext.context.branch,
-                },
-            })),
-            cursor: envelope.cursor,
-            key: envelope.key,
-            dependsOn: envelope.dependsOn,
-        };
-    }
-    /**
-     * Serializes an action for GraphQL transport, converting signature tuples to strings.
-     */
-    serializeAction(action) {
-        const signer = action.context?.signer;
-        if (!signer?.signatures) {
-            return action;
-        }
-        return {
-            ...action,
-            context: {
-                ...action.context,
-                signer: {
-                    ...signer,
-                    signatures: signer.signatures.map((sig) => Array.isArray(sig) ? sig.join(", ") : sig),
-                },
-            },
-        };
     }
     /**
      * Gets the authorization header value using jwtHandler.
@@ -454,17 +425,6 @@ export class GqlChannel {
         }
         return result.data;
     }
-    /**
-     * Updates the synchronization cursor for this channel's remote.
-     */
-    async updateCursor(cursorOrdinal) {
-        const cursor = {
-            remoteName: this.remoteName,
-            cursorOrdinal,
-            lastSyncedAtUtcMs: Date.now(),
-        };
-        await this.cursorStorage.upsert(cursor);
-    }
     /**
      * Gets the current health status of the channel.
      */
@@ -484,4 +444,4 @@ export class GqlChannel {
         return this.pollTimer;
     }
 }
-//# sourceMappingURL=gql-channel.js.map
+//# sourceMappingURL=gql-req-channel.js.map

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

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

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

@@ -0,0 +1,25 @@
+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";
+/**
+ * This class is used server-side to accumulate inbox + outbox operations.
+ *
+ * In general, the resolvers are responsible for updating mailboxes.
+ */
+export declare class GqlResponseChannel implements IChannel {
+    private readonly logger;
+    readonly inbox: Mailbox;
+    readonly outbox: Mailbox;
+    readonly deadLetter: Mailbox;
+    private readonly channelId;
+    private readonly remoteName;
+    private readonly cursorStorage;
+    private isShutdown;
+    private lastPersistedInboxOrdinal;
+    private lastPersistedOutboxOrdinal;
+    constructor(logger: ILogger, channelId: string, remoteName: string, cursorStorage: ISyncCursorStorage);
+    shutdown(): Promise<void>;
+    init(): Promise<void>;
+}
+//# sourceMappingURL=gql-res-channel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gql-res-channel.d.ts","sourceRoot":"","sources":["../../../../src/sync/channels/gql-res-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxC;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,QAAQ;IAa/C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAZzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAE7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,yBAAyB,CAAa;IAC9C,OAAO,CAAC,0BAA0B,CAAa;gBAG5B,MAAM,EAAE,OAAO,EAChC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,kBAAkB;IAyDnC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAKnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAY5B"}

package/dist/src/sync/channels/gql-res-channel.js

@@ -0,0 +1,79 @@
+import { Mailbox } from "../mailbox.js";
+import { getLatestAppliedOrdinal } from "./utils.js";
+/**
+ * This class is used server-side to accumulate inbox + outbox operations.
+ *
+ * In general, the resolvers are responsible for updating mailboxes.
+ */
+export class GqlResponseChannel {
+    logger;
+    inbox;
+    outbox;
+    deadLetter;
+    channelId;
+    remoteName;
+    cursorStorage;
+    isShutdown;
+    lastPersistedInboxOrdinal = 0;
+    lastPersistedOutboxOrdinal = 0;
+    constructor(logger, channelId, remoteName, cursorStorage) {
+        this.logger = logger;
+        this.channelId = channelId;
+        this.remoteName = remoteName;
+        this.cursorStorage = cursorStorage;
+        this.isShutdown = false;
+        this.inbox = new Mailbox();
+        this.outbox = new Mailbox();
+        this.deadLetter = new Mailbox();
+        // Instead of listening to syncops directly for cursor updates, we listen
+        // to the mailbox. This is for efficiency: many syncops may fire on a trim,
+        // but only one onRemoved callback will be fired for the batch.
+        this.outbox.onRemoved((syncOps) => {
+            const maxOrdinal = getLatestAppliedOrdinal(syncOps);
+            if (maxOrdinal > this.lastPersistedOutboxOrdinal) {
+                this.lastPersistedOutboxOrdinal = maxOrdinal;
+                this.cursorStorage
+                    .upsert({
+                    remoteName: this.remoteName,
+                    cursorType: "outbox",
+                    cursorOrdinal: maxOrdinal,
+                    lastSyncedAtUtcMs: Date.now(),
+                })
+                    .catch((error) => {
+                    this.logger.error("Failed to update outbox cursor for @ChannelId! This means that future application runs may resend duplicate operations. This is recoverable (with deduplication protection), but not-optimal: @Error", this.channelId, error);
+                });
+            }
+        });
+        this.inbox.onRemoved((syncOps) => {
+            const maxOrdinal = getLatestAppliedOrdinal(syncOps);
+            if (maxOrdinal > this.lastPersistedInboxOrdinal) {
+                this.lastPersistedInboxOrdinal = maxOrdinal;
+                this.cursorStorage
+                    .upsert({
+                    remoteName: this.remoteName,
+                    cursorType: "inbox",
+                    cursorOrdinal: maxOrdinal,
+                    lastSyncedAtUtcMs: Date.now(),
+                })
+                    .catch((error) => {
+                    this.logger.error("Failed to update inbox cursor for @ChannelId! This is unlikely to cause a problem, but not-optimal: @Error", this.channelId, error);
+                });
+            }
+        });
+    }
+    shutdown() {
+        this.isShutdown = true;
+        return Promise.resolve();
+    }
+    async init() {
+        // get cursors -- these are the last acknowledged ordinals for the inbox and outbox
+        const cursors = await this.cursorStorage.list(this.remoteName);
+        const inboxOrdinal = cursors.find((c) => c.cursorType === "inbox")?.cursorOrdinal ?? 0;
+        const outboxOrdinal = cursors.find((c) => c.cursorType === "outbox")?.cursorOrdinal ?? 0;
+        this.inbox.init(inboxOrdinal);
+        this.outbox.init(outboxOrdinal);
+        this.lastPersistedInboxOrdinal = inboxOrdinal;
+        this.lastPersistedOutboxOrdinal = outboxOrdinal;
+    }
+}
+//# sourceMappingURL=gql-res-channel.js.map

package/dist/src/sync/channels/gql-res-channel.js.map

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

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

@@ -1,8 +1,8 @@
-export { PollingChannel } from "./polling-channel.js";
-export { GqlChannel, type GqlChannelConfig } from "./gql-channel.js";
-export { GqlChannelFactory } from "./gql-channel-factory.js";
 export { CompositeChannelFactory } from "./composite-channel-factory.js";
-export { envelopeToSyncOperation } from "./utils.js";
-export { type IPollTimer } from "./poll-timer.js";
+export { GqlChannelFactory } from "./gql-channel-factory.js";
+export { GqlRequestChannel as GqlChannel, type GqlChannelConfig, } from "./gql-req-channel.js";
+export { GqlResponseChannel as PollingChannel } from "./gql-res-channel.js";
 export { IntervalPollTimer } from "./interval-poll-timer.js";
+export { type IPollTimer } from "./poll-timer.js";
+export { envelopeToSyncOperation } from "./utils.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/sync/channels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/sync/channels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EACL,iBAAiB,IAAI,UAAU,EAC/B,KAAK,gBAAgB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC"}

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

@@ -1,8 +1,8 @@
-export { PollingChannel } from "./polling-channel.js";
-export { GqlChannel } from "./gql-channel.js";
-export { GqlChannelFactory } from "./gql-channel-factory.js";
 export { CompositeChannelFactory } from "./composite-channel-factory.js";
-export { envelopeToSyncOperation } from "./utils.js";
-export {} from "./poll-timer.js";
+export { GqlChannelFactory } from "./gql-channel-factory.js";
+export { GqlRequestChannel as GqlChannel, } from "./gql-req-channel.js";
+export { GqlResponseChannel as PollingChannel } from "./gql-res-channel.js";
 export { IntervalPollTimer } from "./interval-poll-timer.js";
+export {} from "./poll-timer.js";
+export { envelopeToSyncOperation } from "./utils.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/sync/channels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAyB,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAmB,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/sync/channels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EACL,iBAAiB,IAAI,UAAU,GAEhC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAmB,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC"}

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!]!. Extra context fields (resultingState, ordinal)
+ * are stripped since they are 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,CA6Bf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,MAAM,GACjB,aAAa,EAAE,CAuBjB"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/sync/channels/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAwB,MAAM,gBAAgB,CAAC;AAEnE,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,CAyBjE;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"}