velocious 1.0.721 → 1.0.722

package/build/src/sync/sync-cursor.d.ts

@@ -0,0 +1,30 @@
+export type SyncCursor = import("./sync-api-client-types.js").SyncCursor;
+/**
+ * @module sync-cursor
+ *
+ * Shared cursor helpers for the sync change feed: building a cursor from a
+ * serialized sync entry and ordering two cursors under the feed's stable order
+ * (server sequence when present, else updated-at then id). The server channel
+ * advances its per-subscription replay watermark with these across out-of-order
+ * live broadcasts, and the realtime bridge advances the persisted scope cursor
+ * monotonically on pushed changes.
+ */
+/** @typedef {import("./sync-api-client-types.js").SyncCursor} SyncCursor */
+/**
+ * Builds a cursor from a serialized sync entry, or null when the entry carries
+ * no cursor identity (no updated-at).
+ * @param {Record<string, ReturnType<typeof JSON.parse>>} entry - Serialized sync entry.
+ * @returns {SyncCursor} Cursor for the entry, or null.
+ */
+export declare function cursorFromSyncEntry(entry: Record<string, ReturnType<typeof JSON.parse>>): SyncCursor;
+/**
+ * Whether one cursor is strictly later than another under the change-feed order.
+ * A sequenced cursor is always later than an unsequenced one; both sequenced
+ * cursors order by server sequence; both unsequenced cursors order by updated-at
+ * then id.
+ * @param {SyncCursor} candidate - Candidate cursor.
+ * @param {SyncCursor} current - Current cursor.
+ * @returns {boolean} Whether the candidate is later.
+ */
+export declare function isCursorAfter(candidate: SyncCursor, current: SyncCursor): boolean;
+//# sourceMappingURL=sync-cursor.d.ts.map

package/build/src/sync/sync-cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-cursor.d.ts","sourceRoot":"","sources":["../../../src/sync/sync-cursor.js"],"names":[],"mappings":"AAaI,YAA2D,UAAU,GAA3D,OAAO,4BAA4B,EAAE,UAAU,CAAY;AAXzE;;;;;;;;;GASG;AAEH,4EAA4E;AAE5E;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAH9B,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,CAGd,GAF5B,UAAU,CAYtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAJ5B,UAI4B,EAAE,OAAO,EAHrC,UAGqC,GAFnC,OAAO,CAenB"}

package/build/src/sync/sync-cursor.js

@@ -0,0 +1,54 @@
+// @ts-check
+/**
+ * @module sync-cursor
+ *
+ * Shared cursor helpers for the sync change feed: building a cursor from a
+ * serialized sync entry and ordering two cursors under the feed's stable order
+ * (server sequence when present, else updated-at then id). The server channel
+ * advances its per-subscription replay watermark with these across out-of-order
+ * live broadcasts, and the realtime bridge advances the persisted scope cursor
+ * monotonically on pushed changes.
+ */
+/** @typedef {import("./sync-api-client-types.js").SyncCursor} SyncCursor */
+/**
+ * Builds a cursor from a serialized sync entry, or null when the entry carries
+ * no cursor identity (no updated-at).
+ * @param {Record<string, ReturnType<typeof JSON.parse>>} entry - Serialized sync entry.
+ * @returns {SyncCursor} Cursor for the entry, or null.
+ */
+export function cursorFromSyncEntry(entry) {
+    const updatedAt = entry.updatedAt;
+    if (typeof updatedAt !== "string" || updatedAt === "")
+        return null;
+    return {
+        id: entry.id === null || entry.id === undefined ? null : String(entry.id),
+        serverSequence: typeof entry.serverSequence === "number" ? entry.serverSequence : null,
+        updatedAt
+    };
+}
+/**
+ * Whether one cursor is strictly later than another under the change-feed order.
+ * A sequenced cursor is always later than an unsequenced one; both sequenced
+ * cursors order by server sequence; both unsequenced cursors order by updated-at
+ * then id.
+ * @param {SyncCursor} candidate - Candidate cursor.
+ * @param {SyncCursor} current - Current cursor.
+ * @returns {boolean} Whether the candidate is later.
+ */
+export function isCursorAfter(candidate, current) {
+    if (!candidate)
+        return false;
+    if (!current)
+        return true;
+    if (candidate.serverSequence !== null && current.serverSequence !== null) {
+        return candidate.serverSequence > current.serverSequence;
+    }
+    if (candidate.serverSequence !== null)
+        return true;
+    if (current.serverSequence !== null)
+        return false;
+    if (candidate.updatedAt !== current.updatedAt)
+        return candidate.updatedAt > current.updatedAt;
+    return (candidate.id ?? "") > (current.id ?? "");
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3luYy1jdXJzb3IuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvc3luYy9zeW5jLWN1cnNvci5qcyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxZQUFZO0FBRVo7Ozs7Ozs7OztHQVNHO0FBRUgsNEVBQTRFO0FBRTVFOzs7OztHQUtHO0FBQ0gsTUFBTSxVQUFVLG1CQUFtQixDQUFDLEtBQUs7SUFDdkMsTUFBTSxTQUFTLEdBQUcsS0FBSyxDQUFDLFNBQVMsQ0FBQTtJQUVqQyxJQUFJLE9BQU8sU0FBUyxLQUFLLFFBQVEsSUFBSSxTQUFTLEtBQUssRUFBRTtRQUFFLE9BQU8sSUFBSSxDQUFBO0lBRWxFLE9BQU87UUFDTCxFQUFFLEVBQUUsS0FBSyxDQUFDLEVBQUUsS0FBSyxJQUFJLElBQUksS0FBSyxDQUFDLEVBQUUsS0FBSyxTQUFTLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxFQUFFLENBQUM7UUFDekUsY0FBYyxFQUFFLE9BQU8sS0FBSyxDQUFDLGNBQWMsS0FBSyxRQUFRLENBQUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxjQUFjLENBQUMsQ0FBQyxDQUFDLElBQUk7UUFDdEYsU0FBUztLQUNWLENBQUE7QUFDSCxDQUFDO0FBRUQ7Ozs7Ozs7O0dBUUc7QUFDSCxNQUFNLFVBQVUsYUFBYSxDQUFDLFNBQVMsRUFBRSxPQUFPO0lBQzlDLElBQUksQ0FBQyxTQUFTO1FBQUUsT0FBTyxLQUFLLENBQUE7SUFDNUIsSUFBSSxDQUFDLE9BQU87UUFBRSxPQUFPLElBQUksQ0FBQTtJQUV6QixJQUFJLFNBQVMsQ0FBQyxjQUFjLEtBQUssSUFBSSxJQUFJLE9BQU8sQ0FBQyxjQUFjLEtBQUssSUFBSSxFQUFFLENBQUM7UUFDekUsT0FBTyxTQUFTLENBQUMsY0FBYyxHQUFHLE9BQU8sQ0FBQyxjQUFjLENBQUE7SUFDMUQsQ0FBQztJQUNELElBQUksU0FBUyxDQUFDLGNBQWMsS0FBSyxJQUFJO1FBQUUsT0FBTyxJQUFJLENBQUE7SUFDbEQsSUFBSSxPQUFPLENBQUMsY0FBYyxLQUFLLElBQUk7UUFBRSxPQUFPLEtBQUssQ0FBQTtJQUVqRCxJQUFJLFNBQVMsQ0FBQyxTQUFTLEtBQUssT0FBTyxDQUFDLFNBQVM7UUFBRSxPQUFPLFNBQVMsQ0FBQyxTQUFTLEdBQUcsT0FBTyxDQUFDLFNBQVMsQ0FBQTtJQUU3RixPQUFPLENBQUMsU0FBUyxDQUFDLEVBQUUsSUFBSSxFQUFFLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxFQUFFLElBQUksRUFBRSxDQUFDLENBQUE7QUFDbEQsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8vIEB0cy1jaGVja1xuXG4vKipcbiAqIEBtb2R1bGUgc3luYy1jdXJzb3JcbiAqXG4gKiBTaGFyZWQgY3Vyc29yIGhlbHBlcnMgZm9yIHRoZSBzeW5jIGNoYW5nZSBmZWVkOiBidWlsZGluZyBhIGN1cnNvciBmcm9tIGFcbiAqIHNlcmlhbGl6ZWQgc3luYyBlbnRyeSBhbmQgb3JkZXJpbmcgdHdvIGN1cnNvcnMgdW5kZXIgdGhlIGZlZWQncyBzdGFibGUgb3JkZXJcbiAqIChzZXJ2ZXIgc2VxdWVuY2Ugd2hlbiBwcmVzZW50LCBlbHNlIHVwZGF0ZWQtYXQgdGhlbiBpZCkuIFRoZSBzZXJ2ZXIgY2hhbm5lbFxuICogYWR2YW5jZXMgaXRzIHBlci1zdWJzY3JpcHRpb24gcmVwbGF5IHdhdGVybWFyayB3aXRoIHRoZXNlIGFjcm9zcyBvdXQtb2Ytb3JkZXJcbiAqIGxpdmUgYnJvYWRjYXN0cywgYW5kIHRoZSByZWFsdGltZSBicmlkZ2UgYWR2YW5jZXMgdGhlIHBlcnNpc3RlZCBzY29wZSBjdXJzb3JcbiAqIG1vbm90b25pY2FsbHkgb24gcHVzaGVkIGNoYW5nZXMuXG4gKi9cblxuLyoqIEB0eXBlZGVmIHtpbXBvcnQoXCIuL3N5bmMtYXBpLWNsaWVudC10eXBlcy5qc1wiKS5TeW5jQ3Vyc29yfSBTeW5jQ3Vyc29yICovXG5cbi8qKlxuICogQnVpbGRzIGEgY3Vyc29yIGZyb20gYSBzZXJpYWxpemVkIHN5bmMgZW50cnksIG9yIG51bGwgd2hlbiB0aGUgZW50cnkgY2Fycmllc1xuICogbm8gY3Vyc29yIGlkZW50aXR5IChubyB1cGRhdGVkLWF0KS5cbiAqIEBwYXJhbSB7UmVjb3JkPHN0cmluZywgUmV0dXJuVHlwZTx0eXBlb2YgSlNPTi5wYXJzZT4+fSBlbnRyeSAtIFNlcmlhbGl6ZWQgc3luYyBlbnRyeS5cbiAqIEByZXR1cm5zIHtTeW5jQ3Vyc29yfSBDdXJzb3IgZm9yIHRoZSBlbnRyeSwgb3IgbnVsbC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGN1cnNvckZyb21TeW5jRW50cnkoZW50cnkpIHtcbiAgY29uc3QgdXBkYXRlZEF0ID0gZW50cnkudXBkYXRlZEF0XG5cbiAgaWYgKHR5cGVvZiB1cGRhdGVkQXQgIT09IFwic3RyaW5nXCIgfHwgdXBkYXRlZEF0ID09PSBcIlwiKSByZXR1cm4gbnVsbFxuXG4gIHJldHVybiB7XG4gICAgaWQ6IGVudHJ5LmlkID09PSBudWxsIHx8IGVudHJ5LmlkID09PSB1bmRlZmluZWQgPyBudWxsIDogU3RyaW5nKGVudHJ5LmlkKSxcbiAgICBzZXJ2ZXJTZXF1ZW5jZTogdHlwZW9mIGVudHJ5LnNlcnZlclNlcXVlbmNlID09PSBcIm51bWJlclwiID8gZW50cnkuc2VydmVyU2VxdWVuY2UgOiBudWxsLFxuICAgIHVwZGF0ZWRBdFxuICB9XG59XG5cbi8qKlxuICogV2hldGhlciBvbmUgY3Vyc29yIGlzIHN0cmljdGx5IGxhdGVyIHRoYW4gYW5vdGhlciB1bmRlciB0aGUgY2hhbmdlLWZlZWQgb3JkZXIuXG4gKiBBIHNlcXVlbmNlZCBjdXJzb3IgaXMgYWx3YXlzIGxhdGVyIHRoYW4gYW4gdW5zZXF1ZW5jZWQgb25lOyBib3RoIHNlcXVlbmNlZFxuICogY3Vyc29ycyBvcmRlciBieSBzZXJ2ZXIgc2VxdWVuY2U7IGJvdGggdW5zZXF1ZW5jZWQgY3Vyc29ycyBvcmRlciBieSB1cGRhdGVkLWF0XG4gKiB0aGVuIGlkLlxuICogQHBhcmFtIHtTeW5jQ3Vyc29yfSBjYW5kaWRhdGUgLSBDYW5kaWRhdGUgY3Vyc29yLlxuICogQHBhcmFtIHtTeW5jQ3Vyc29yfSBjdXJyZW50IC0gQ3VycmVudCBjdXJzb3IuXG4gKiBAcmV0dXJucyB7Ym9vbGVhbn0gV2hldGhlciB0aGUgY2FuZGlkYXRlIGlzIGxhdGVyLlxuICovXG5leHBvcnQgZnVuY3Rpb24gaXNDdXJzb3JBZnRlcihjYW5kaWRhdGUsIGN1cnJlbnQpIHtcbiAgaWYgKCFjYW5kaWRhdGUpIHJldHVybiBmYWxzZVxuICBpZiAoIWN1cnJlbnQpIHJldHVybiB0cnVlXG5cbiAgaWYgKGNhbmRpZGF0ZS5zZXJ2ZXJTZXF1ZW5jZSAhPT0gbnVsbCAmJiBjdXJyZW50LnNlcnZlclNlcXVlbmNlICE9PSBudWxsKSB7XG4gICAgcmV0dXJuIGNhbmRpZGF0ZS5zZXJ2ZXJTZXF1ZW5jZSA+IGN1cnJlbnQuc2VydmVyU2VxdWVuY2VcbiAgfVxuICBpZiAoY2FuZGlkYXRlLnNlcnZlclNlcXVlbmNlICE9PSBudWxsKSByZXR1cm4gdHJ1ZVxuICBpZiAoY3VycmVudC5zZXJ2ZXJTZXF1ZW5jZSAhPT0gbnVsbCkgcmV0dXJuIGZhbHNlXG5cbiAgaWYgKGNhbmRpZGF0ZS51cGRhdGVkQXQgIT09IGN1cnJlbnQudXBkYXRlZEF0KSByZXR1cm4gY2FuZGlkYXRlLnVwZGF0ZWRBdCA+IGN1cnJlbnQudXBkYXRlZEF0XG5cbiAgcmV0dXJuIChjYW5kaWRhdGUuaWQgPz8gXCJcIikgPiAoY3VycmVudC5pZCA/PyBcIlwiKVxufVxuIl19

package/build/src/sync/sync-realtime-bridge.d.ts

@@ -1,7 +1,113 @@
 export type VelociousSyncRealtimeChannelDescriptor = import("../configuration-types.js").VelociousSyncRealtimeChannelDescriptor;
 export type VelociousSyncRealtimeWebsocketClient = import("../configuration-types.js").VelociousSyncRealtimeWebsocketClient;
+export type SyncRealtimeScopeRow = {
+    /**
+     * - Scope attribute conditions.
+     */
+    conditions: Record<string, ReturnType<typeof JSON.parse>>;
+    /**
+     * - Persisted cursor JSON payload.
+     */
+    cursorPayload: string | null;
+    /**
+     * - Scope row id.
+     */
+    id: string;
+    /**
+     * - Scope resource type.
+     */
+    resourceType: string | null;
+    /**
+     * - Fixed-size scope digest.
+     */
+    scopeDigest: string;
+    /**
+     * - Scope state.
+     */
+    state: string;
+    /**
+     * - Physical store identity.
+     */
+    storeIdentity: string;
+};
+export type DerivedSyncChannel = {
+    /**
+     * - Channel name.
+     */
+    channel: string;
+    /**
+     * - In-memory cursor watermark.
+     */
+    cursor: import("./sync-api-client-types.js").SyncCursor;
+    /**
+     * - Default resource type for pushed changes.
+     */
+    resourceType: string | null;
+    /**
+     * - Owning scope row, or null for legacy channels.
+     */
+    scopeRow: SyncRealtimeScopeRow | null;
+    /**
+     * - Subscription handle.
+     */
+    subscription: import("../configuration-types.js").VelociousSyncRealtimeSubscription;
+};
+export type DerivedSyncChannelDescriptor = {
+    /**
+     * - Channel name.
+     */
+    channel: string;
+    /**
+     * - In-memory cursor watermark (null for legacy channels).
+     */
+    cursor: import("./sync-api-client-types.js").SyncCursor;
+    /**
+     * - Subscribe params (without the framework-injected auth token).
+     */
+    params: Record<string, ReturnType<typeof JSON.parse>>;
+    /**
+     * - Default resource type for pushed changes.
+     */
+    resourceType: string | null;
+    /**
+     * - Owning scope row, or null for legacy channels.
+     */
+    scopeRow: SyncRealtimeScopeRow | null;
+};
 /** @typedef {import("../configuration-types.js").VelociousSyncRealtimeChannelDescriptor} VelociousSyncRealtimeChannelDescriptor */
 /** @typedef {import("../configuration-types.js").VelociousSyncRealtimeWebsocketClient} VelociousSyncRealtimeWebsocketClient */
+/**
+ * The persisted scope row the bridge carries so it can advance the scope's cursor
+ * on applied pushes. Mirrors the framework-owned scope store row shape.
+ * @typedef {object} SyncRealtimeScopeRow
+ * @property {Record<string, ReturnType<typeof JSON.parse>>} conditions - Scope attribute conditions.
+ * @property {string | null} cursorPayload - Persisted cursor JSON payload.
+ * @property {string} id - Scope row id.
+ * @property {string | null} resourceType - Scope resource type.
+ * @property {string} scopeDigest - Fixed-size scope digest.
+ * @property {string} state - Scope state.
+ * @property {string} storeIdentity - Physical store identity.
+ */
+/**
+ * One derived channel subscription carrying its owning scope row (null for legacy
+ * app channels) and the in-memory cursor watermark advanced by applied pushes.
+ * @typedef {object} DerivedSyncChannel
+ * @property {string} channel - Channel name.
+ * @property {import("./sync-api-client-types.js").SyncCursor} cursor - In-memory cursor watermark.
+ * @property {string | null} resourceType - Default resource type for pushed changes.
+ * @property {SyncRealtimeScopeRow | null} scopeRow - Owning scope row, or null for legacy channels.
+ * @property {import("../configuration-types.js").VelociousSyncRealtimeSubscription} subscription - Subscription handle.
+ */
+/**
+ * One derived channel to subscribe, carrying its owning scope row and cursor for
+ * framework sync channel subscriptions (null scope row for legacy app channels).
+ * @typedef {object} DerivedSyncChannelDescriptor
+ * @property {string} channel - Channel name.
+ * @property {import("./sync-api-client-types.js").SyncCursor} cursor - In-memory cursor watermark (null for legacy channels).
+ * @property {Record<string, ReturnType<typeof JSON.parse>>} params - Subscribe params (without the framework-injected auth token).
+ * @property {string | null} resourceType - Default resource type for pushed changes.
+ * @property {SyncRealtimeScopeRow | null} scopeRow - Owning scope row, or null for legacy channels.
+ */
 /**
  * Derived realtime push bridge for the sync client. Subscribes every declared
  * pull scope to the framework sync channel ({@link VELOCIOUS_SYNC_CHANNEL})
@@ -17,12 +123,8 @@ export type VelociousSyncRealtimeWebsocketClient = import("../configuration-type
  */
 export default class SyncRealtimeBridge {
     syncClient: import("./sync-client.js").default;
-    /** @type {Array<{channel: string, resourceType: string | null, subscription: import("../configuration-types.js").VelociousSyncRealtimeSubscription}>} */
-    _channels: Array<{
-        channel: string;
-        resourceType: string | null;
-        subscription: import("../configuration-types.js").VelociousSyncRealtimeSubscription;
-    }>;
+    /** @type {Array<DerivedSyncChannel>} */
+    _channels: Array<DerivedSyncChannel>;
     /** @type {VelociousSyncRealtimeWebsocketClient | null} */
     _client: VelociousSyncRealtimeWebsocketClient | null;
     /** @type {boolean} Whether the bridge created its own client (deprecated per-cycle path) and must disconnect it on unsubscribe. A shared connection is never owned. */
@@ -32,8 +134,6 @@ export default class SyncRealtimeBridge {
     /** @type {number} Subscription generation - bumped by unsubscribe so in-flight subscribes detect they became stale. */
     _generation: number;
     /** @type {Promise<void> | null} */
-    _scheduledPull: Promise<void> | null;
-    /** @type {Promise<void> | null} */
     _subscribePromise: Promise<void> | null;
     /** @type {"subscribed" | "subscribing" | "unsubscribed"} */
     _state: "subscribed" | "subscribing" | "unsubscribed";
@@ -90,7 +190,7 @@ export default class SyncRealtimeBridge {
         state: "subscribed" | "subscribing" | "unsubscribed";
     };
     /**
-     * Awaits all enqueued message applies and any scheduled pull (tests, shutdown flows).
+     * Awaits all enqueued message applies (tests, shutdown flows).
      * @returns {Promise<void>}
      */
     waitForApplied(): Promise<void>;
@@ -115,9 +215,9 @@ export default class SyncRealtimeBridge {
      * model-level static realtime declarations and the config channels callback.
      * Fails loudly when nothing is subscribable.
      * @param {ReturnType<typeof JSON.parse>} context - App context passed to the deprecated channels callback.
-     * @returns {Promise<Array<VelociousSyncRealtimeChannelDescriptor>>} Channel descriptors.
+     * @returns {Promise<Array<DerivedSyncChannelDescriptor>>} Channel descriptors.
      */
-    channelDescriptors(context: ReturnType<typeof JSON.parse>): Promise<Array<VelociousSyncRealtimeChannelDescriptor>>;
+    channelDescriptors(context: ReturnType<typeof JSON.parse>): Promise<Array<DerivedSyncChannelDescriptor>>;
     /**
      * Translates a persisted scope's condition keys to the model's attribute
      * names so the framework channel subscription matches the publisher's
@@ -141,32 +241,35 @@ export default class SyncRealtimeBridge {
     /**
      * Chains one pushed message onto the serialized apply queue so changes apply
      * in arrival order; failures go to the sync client's error reporting.
-     * @param {{body: ReturnType<typeof JSON.parse>, generation?: number, resourceType: string | null}} args - Message args.
+     * @param {{body: ReturnType<typeof JSON.parse>, channel: DerivedSyncChannel, generation?: number}} args - Message args.
      * @returns {void}
      */
-    enqueueApply({ body, generation, resourceType }: {
+    enqueueApply({ body, channel, generation }: {
         body: ReturnType<typeof JSON.parse>;
+        channel: DerivedSyncChannel;
         generation?: number;
-        resourceType: string | null;
     }): void;
     /**
      * Applies one pushed message through the derived resource applier: drops
      * own-device messages by echo origin, defaults the channel's resourceType onto
-     * envelopes without one, and fails loudly on unknown resource types.
-     * @param {{body: ReturnType<typeof JSON.parse>, resourceType: string | null}} args - Message args.
+     * envelopes without one, fails loudly on unknown resource types, and advances
+     * the owning scope's cursor so a later replay resumes after the applied rows.
+     * @param {{body: ReturnType<typeof JSON.parse>, channel: DerivedSyncChannel}} args - Message args.
      * @returns {Promise<void>}
      */
-    applyMessage({ body, resourceType }: {
+    applyMessage({ body, channel }: {
         body: ReturnType<typeof JSON.parse>;
-        resourceType: string | null;
+        channel: DerivedSyncChannel;
     }): Promise<void>;
     /**
-     * Schedules a coalesced background pull closing offline gaps after
-     * (re)subscription readiness. Resumes arriving while a pull is already
-     * scheduled or in flight coalesce into that pull instead of stacking.
-     * @param {number} [generation] - Subscription generation owning the resume/readiness callback.
-     * @returns {void}
+     * Advances the owning scope's persisted cursor to the newest applied row,
+     * monotonically (never backwards) so an out-of-order or duplicate push cannot
+     * regress the cursor and re-deliver already-applied rows on a later replay.
+     * Legacy channels with no owning scope are skipped.
+     * @param {DerivedSyncChannel} channel - Channel owning the scope.
+     * @param {Array<ReturnType<typeof JSON.parse>>} syncPayloads - Applied sync entries.
+     * @returns {Promise<void>}
      */
-    schedulePull(generation?: number): void;
+    advanceScopeCursor(channel: DerivedSyncChannel, syncPayloads: Array<ReturnType<typeof JSON.parse>>): Promise<void>;
 }
 //# sourceMappingURL=sync-realtime-bridge.d.ts.map

package/build/src/sync/sync-realtime-bridge.d.ts.map

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