@honua/app-platform 0.1.2-beta.0 → 0.1.4-beta.0

package/realtime/reconciliation.js

@@ -0,0 +1,377 @@
+/**
+ * Renderer-neutral reconciliation of accepted realtime deltas (issue #559).
+ *
+ * `reducer.ts` already folds `snapshot`/`upsert`/`delete`/`delta` events into
+ * one authoritative `RealtimeFeatureState` (`records`/`tombstones`, keyed by
+ * {@link realtimeFeatureKey}) — that state is the accepted realtime store this
+ * module builds on. This module adds the piece #556/#557 deliberately left
+ * open: turning a `(previous, next, trigger)` state transition into an
+ * explicit, identity-stable **patch** (create/update/delete) or **rebuild**
+ * (replacement snapshot, schema change, or policy-driven queue overflow)
+ * decision, plus the derived-state reconciliation that keeps caches,
+ * selection, filters, and viewport deterministic across it:
+ *
+ * - {@link diffRealtimeFeatureState} — pure REQ-001 identity/patch-rebuild
+ *   classification for one event or explicit reset trigger.
+ * - {@link createRealtimeReconciler} — stateful REQ-004 policy: bounds the
+ *   pending-patch queue and switches `mode` to `"rebuild"` once a single
+ *   event or the accumulated queue crosses an explicit threshold, so a
+ *   renderer never has to apply an unbounded patch backlog.
+ * - {@link realtimeReconciliationVersion} — the resume-position fields a
+ *   derived cache should record so it can state exactly which cursor/sequence
+ *   it reflects (the accepted store in `store.ts`/`reducer.ts` remains the
+ *   sole authority; nothing here re-derives truth from a cache).
+ * - {@link createRealtimeReconciledCache} — a REQ-002 generic, renderer-neutral
+ *   feature cache driven by reconciliation results; adapt its snapshot into a
+ *   `Result<T>`-shaped or `HonuaQueryCache`-backed cache as needed.
+ * - {@link reconcileRealtimeKeyedState} / {@link reconcileRealtimeViewport} —
+ *   REQ-003 deterministic preservation of any identity-keyed UI state
+ *   (selection, an active client-side filter's matched-feature set) and of an
+ *   opaque viewport value, both with a structured invalidation reason instead
+ *   of a silent reset.
+ *
+ * `@honua/sdk-js/map`'s `realtime-reconciliation-adapter.ts` is the only
+ * place a `RealtimeReconciliationResult` is projected onto MapLibre
+ * (`setFeatureState` for `"patch"`, a caller-supplied rebuild callback for
+ * `"rebuild"`) — this module never imports `maplibre-gl` and has no
+ * renderer-specific dependency (REQ-005). deck.gl/Cesium adapters and the
+ * transport implementations that feed `previous`/`next` state are out of
+ * scope for #559.
+ *
+ * @module
+ */
+import { HonuaSdkError, mergeHonuaErrorContext } from "../core/error-envelope.js";
+import { realtimeFeatureKey } from "./reducer.js";
+/** A stable, machine-readable reconciliation failure. @experimental */
+export class HonuaRealtimeReconciliationError extends HonuaSdkError {
+    code;
+    detail;
+    constructor(code, message, detail, options = {}) {
+        super(REALTIME_RECONCILIATION_ERROR_CODES[code], message, {
+            ...options,
+            context: mergeHonuaErrorContext(detail, options.context),
+        });
+        this.code = code;
+        this.detail = detail;
+        this.name = "HonuaRealtimeReconciliationError";
+    }
+}
+const REALTIME_RECONCILIATION_ERROR_CODES = {
+    disposed: "realtime.reconciliation.disposed",
+    "invalid-option": "realtime.reconciliation.invalid-option",
+};
+/**
+ * Classify one `(previous, next)` accepted-store transition into identity-stable
+ * create/update/delete changes, or an explicit reset (replacement snapshot,
+ * schema change, source-version change, authorization-scope change, or a
+ * caller-initiated manual reset). Pure and side-effect free — `next` must
+ * already be the reducer's output for `trigger` (`reduceRealtimeFeatureState`
+ * when `trigger.kind === "event"`); this function never re-derives store state.
+ *
+ * @experimental
+ */
+export function diffRealtimeFeatureState(previous, next, trigger) {
+    if (trigger.kind === "reset") {
+        return Object.freeze({
+            changes: recordsAsCreateChanges(next),
+            reset: true,
+            resetReason: trigger.reason,
+            ...(trigger.detail !== undefined ? { resetDetail: trigger.detail } : {}),
+        });
+    }
+    const event = trigger.event;
+    switch (event.type) {
+        case "snapshot": {
+            if (event.replace ?? true) {
+                return Object.freeze({
+                    changes: recordsAsCreateChanges(next),
+                    reset: true,
+                    resetReason: "replacement-snapshot",
+                });
+            }
+            return Object.freeze({
+                changes: event.features.map((feature) => classifyUpsert(previous, next, feature)),
+                reset: false,
+            });
+        }
+        case "upsert":
+            return Object.freeze({ changes: [classifyUpsert(previous, next, event.feature)], reset: false });
+        case "delete":
+            return Object.freeze({ changes: [classifyDelete(next, event)], reset: false });
+        case "delta":
+            return Object.freeze({
+                changes: [
+                    ...(event.upserts ?? []).map((feature) => classifyUpsert(previous, next, feature)),
+                    ...(event.deletes ?? []).map((tombstone) => classifyDelete(next, tombstone)),
+                ],
+                reset: false,
+            });
+        case "heartbeat":
+        case "status":
+        case "error":
+            return Object.freeze({ changes: [], reset: false });
+    }
+}
+function classifyUpsert(previous, next, patch) {
+    const key = realtimeFeatureKey(patch.sourceId, patch.id);
+    const existed = Boolean(previous.records[key]);
+    const record = next.records[key];
+    return Object.freeze({
+        kind: existed ? "update" : "create",
+        key,
+        id: patch.id,
+        ...(patch.sourceId !== undefined ? { sourceId: patch.sourceId } : {}),
+        ...(record ? { record } : {}),
+    });
+}
+function classifyDelete(next, input) {
+    const key = realtimeFeatureKey(input.sourceId, input.id);
+    const tombstone = next.tombstones[key];
+    return Object.freeze({
+        kind: "delete",
+        key,
+        id: input.id,
+        ...(input.sourceId !== undefined ? { sourceId: input.sourceId } : {}),
+        ...(tombstone ? { tombstone } : {}),
+    });
+}
+function recordsAsCreateChanges(next) {
+    return Object.freeze(Object.values(next.records).map((record) => Object.freeze({
+        kind: "create",
+        key: record.key,
+        id: record.id,
+        ...(record.sourceId !== undefined ? { sourceId: record.sourceId } : {}),
+        record,
+    })));
+}
+/** Project the accepted store's current resume position — what a derived cache built from `state` reflects. @experimental */
+export function realtimeReconciliationVersion(state) {
+    return Object.freeze({
+        ...(state.cursor !== undefined ? { cursor: state.cursor } : {}),
+        ...(state.watermark !== undefined ? { watermark: state.watermark } : {}),
+        ...(state.timestamp !== undefined ? { timestamp: state.timestamp } : {}),
+        ...(state.lastSequence !== undefined ? { sequence: state.lastSequence } : {}),
+        ...(state.deltaToken !== undefined ? { deltaToken: state.deltaToken } : {}),
+    });
+}
+/**
+ * Create a bounded, renderer-neutral reconciliation policy: identity changes
+ * classify through {@link diffRealtimeFeatureState}; a single oversized event,
+ * or an accumulated pending-patch count over `rebuildThreshold`, switches
+ * `mode` to `"rebuild"` by explicit policy rather than growing an unbounded
+ * patch queue.
+ *
+ * @experimental
+ */
+export function createRealtimeReconciler(options = {}) {
+    const maxChangesPerEvent = positiveInteger(options.maxChangesPerEvent, 500, "maxChangesPerEvent");
+    const rebuildThreshold = positiveInteger(options.rebuildThreshold, 2000, "rebuildThreshold");
+    let pending = 0;
+    let disposed = false;
+    return {
+        get disposed() {
+            return disposed;
+        },
+        get pendingPatchCount() {
+            return pending;
+        },
+        reconcile(previous, next, trigger) {
+            if (disposed) {
+                throw new HonuaRealtimeReconciliationError("disposed", "Cannot reconcile with a disposed realtime reconciler.");
+            }
+            const diff = diffRealtimeFeatureState(previous, next, trigger);
+            const version = realtimeReconciliationVersion(next);
+            if (diff.reset) {
+                pending = 0;
+                return freezeResult({
+                    mode: "rebuild",
+                    rebuildReason: "reset",
+                    changes: diff.changes,
+                    version,
+                    reset: true,
+                    ...(diff.resetReason !== undefined ? { resetReason: diff.resetReason } : {}),
+                    pendingPatchCount: 0,
+                });
+            }
+            if (diff.changes.length > maxChangesPerEvent) {
+                pending = 0;
+                return freezeResult({
+                    mode: "rebuild",
+                    rebuildReason: "event-exceeds-patch-bound",
+                    changes: nonResetRebuildChanges(next, diff.changes),
+                    version,
+                    reset: false,
+                    pendingPatchCount: 0,
+                });
+            }
+            pending += diff.changes.length;
+            if (pending > rebuildThreshold) {
+                pending = 0;
+                return freezeResult({
+                    mode: "rebuild",
+                    rebuildReason: "queue-threshold-exceeded",
+                    changes: nonResetRebuildChanges(next, diff.changes),
+                    version,
+                    reset: false,
+                    pendingPatchCount: 0,
+                });
+            }
+            return freezeResult({
+                mode: "patch",
+                changes: diff.changes,
+                version,
+                reset: false,
+                pendingPatchCount: pending,
+            });
+        },
+        dispose() {
+            disposed = true;
+            pending = 0;
+        },
+    };
+}
+// A rebuild consumer (createRealtimeReconciledCache.apply, a mounted source's
+// re-materialization path) treats `changes` as the complete replacement state,
+// so a non-reset rebuild must carry the full accepted store — the triggering
+// event's diff alone would drop every live feature outside that one event. The
+// event's deletes ride along so identity-keyed state (selection, filter
+// membership) can still invalidate exactly what this transition removed.
+function nonResetRebuildChanges(next, eventChanges) {
+    return Object.freeze([...recordsAsCreateChanges(next), ...eventChanges.filter((change) => change.kind === "delete")]);
+}
+function freezeResult(result) {
+    return Object.freeze({ ...result, changes: Object.freeze([...result.changes]) });
+}
+function positiveInteger(value, fallback, name) {
+    if (value === undefined)
+        return fallback;
+    if (!Number.isSafeInteger(value) || value < 1) {
+        throw new HonuaRealtimeReconciliationError("invalid-option", `${name} must be a positive safe integer.`, {
+            [name]: value,
+        });
+    }
+    return value;
+}
+/**
+ * Create a generic, renderer-neutral cache of live features keyed exactly
+ * like the accepted realtime store. Adapt {@link RealtimeReconciledCache.snapshot}
+ * into a `Result<T>`-shaped or `HonuaQueryCache`-backed cache entry as needed —
+ * this module intentionally does not import either.
+ *
+ * @experimental
+ */
+export function createRealtimeReconciledCache() {
+    let order = [];
+    let byKey = new Map();
+    let version = Object.freeze({});
+    let disposed = false;
+    const snapshotOf = () => Object.freeze({
+        features: Object.freeze(order.map((key) => byKey.get(key))),
+        version,
+    });
+    return {
+        get disposed() {
+            return disposed;
+        },
+        snapshot: snapshotOf,
+        apply(result) {
+            if (disposed) {
+                throw new HonuaRealtimeReconciliationError("disposed", "Cannot apply to a disposed realtime reconciled cache.");
+            }
+            if (result.mode === "rebuild") {
+                const nextOrder = [];
+                const nextByKey = new Map();
+                for (const change of result.changes) {
+                    if (change.kind === "delete" || !change.record)
+                        continue;
+                    nextOrder.push(change.key);
+                    nextByKey.set(change.key, change.record.feature);
+                }
+                order = nextOrder;
+                byKey = nextByKey;
+            }
+            else {
+                for (const change of result.changes) {
+                    if (change.kind === "delete") {
+                        if (byKey.delete(change.key))
+                            order = order.filter((key) => key !== change.key);
+                    }
+                    else if (change.record) {
+                        if (!byKey.has(change.key))
+                            order.push(change.key);
+                        byKey.set(change.key, change.record.feature);
+                    }
+                }
+            }
+            version = result.version;
+            return snapshotOf();
+        },
+        dispose() {
+            disposed = true;
+            order = [];
+            byKey = new Map();
+        },
+    };
+}
+/**
+ * Deterministically preserve or invalidate an identity-keyed set of feature
+ * keys (a selection, or the matched-key set of an active client-side filter)
+ * across one reconciliation result:
+ *
+ * - `result.reset` (replacement snapshot, schema/source/scope change, or
+ *   manual reset): every key is invalidated with reason `"reset"` (or
+ *   `"schema-changed"` when that was the reset reason) and `next` is empty —
+ *   a rebuild replaces identity wholesale, so no prior key is safe to assume
+ *   still exists.
+ * - Otherwise: a key backed by a feature the delta deleted is invalidated
+ *   with reason `"feature-deleted"`; every other key is preserved unchanged.
+ *
+ * Reused for both selection and filter membership — both are "a set of
+ * feature keys that must stay valid or be explicitly dropped."
+ *
+ * @experimental
+ */
+export function reconcileRealtimeKeyedState(keys, result) {
+    if (result.reset) {
+        const reason = result.resetReason === "schema-changed" ? "schema-changed" : "reset";
+        return Object.freeze({
+            next: Object.freeze(new Set()),
+            invalidations: Object.freeze([...keys].map((key) => Object.freeze({ key, reason }))),
+        });
+    }
+    const deletedKeys = new Set();
+    for (const change of result.changes) {
+        if (change.kind === "delete")
+            deletedKeys.add(change.key);
+    }
+    if (deletedKeys.size === 0) {
+        return Object.freeze({ next: keys, invalidations: Object.freeze([]) });
+    }
+    const next = new Set();
+    const invalidations = [];
+    for (const key of keys) {
+        if (deletedKeys.has(key))
+            invalidations.push(Object.freeze({ key, reason: "feature-deleted" }));
+        else
+            next.add(key);
+    }
+    return Object.freeze({ next: Object.freeze(next), invalidations: Object.freeze(invalidations) });
+}
+/**
+ * Preserve an opaque viewport value across a reconciliation result. The
+ * viewport itself is always passed through unchanged (this module never
+ * moves a camera); `invalidated` is `true` only on `result.reset`, so a
+ * caller can decide whether to refit bounds — deterministic, and never a
+ * silent no-op on a schema/replacement-snapshot reset.
+ *
+ * @experimental
+ */
+export function reconcileRealtimeViewport(viewport, result) {
+    if (!result.reset)
+        return Object.freeze({ viewport, invalidated: false });
+    return Object.freeze({
+        viewport,
+        invalidated: true,
+        reason: result.resetReason === "schema-changed" ? "schema-changed" : "reset",
+    });
+}

package/realtime/resumable-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resumable-transport.d.ts","sourceRoot":"","sources":["../../../src/realtime/resumable-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAGH,OAAO,KAAK,EAAE,yBAAyB,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAEhC,KAAK,uBAAuB,EAG7B,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,KAAK,EAGV,wBAAwB,EAGzB,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,gBAAgB,CAAC;AAExE,MAAM,WAAW,uBAAuB;IACtC,gHAAgH;IAChH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,kFAAkF;IAClF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,kHAAkH;IAClH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,4BAA4B,CAAC;CACpD;AAED,MAAM,WAAW,iCAAiC,CAAC,QAAQ,GAAG,OAAO;IACnE,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAC1C,QAAQ,CAAC,eAAe,CAAC,EAAE,uBAAuB,CAAC;IACnD;;;;;;;OAOG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,2BAA2B,CAAC;IACzD,yDAAyD;IACzD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,4EAA4E;IAC5E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,uBAAuB,CAAC;IAC7C,wHAAwH;IACxH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,0EAA0E;IAC1E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,mCAAmC,KAAK,IAAI,CAAC;IAChF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAkCD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAK5G;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,QAAQ,GAAG,OAAO,EACjE,SAAS,EAAE,wBAAwB,CAAC,QAAQ,CAAC,EAC7C,OAAO,EAAE,iCAAiC,CAAC,QAAQ,CAAC,GACnD,wBAAwB,CAAC,QAAQ,CAAC,CA+TpC;AAED;;;GAGG;AACH,wBAAgB,wCAAwC,CAAC,QAAQ,GAAG,OAAO,EACzE,UAAU,EAAE,wCAAwC,CAAC,QAAQ,CAAC,EAC9D,gBAAgB,EAAE,iCAAiC,CAAC,QAAQ,CAAC,GAC5D,wBAAwB,CAAC,QAAQ,CAAC,CAKpC;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,QAAQ,GAAG,OAAO,EAClE,gBAAgB,EAAE,iCAAiC,CAAC,QAAQ,CAAC,EAC7D,gBAAgB,EAAE,iCAAiC,CAAC,QAAQ,CAAC,GAC5D,wBAAwB,CAAC,QAAQ,CAAC,CAKpC"}
+{"version":3,"file":"resumable-transport.d.ts","sourceRoot":"","sources":["../../../src/realtime/resumable-transport.ts"],"names":[],"mappings":"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"}

package/realtime/sse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../src/realtime/sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EAEpB,wBAAwB,EAExB,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1D,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACzC,KAAK,IAAI,IAAI,CAAC;IACd,gBAAgB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;IACvF,mBAAmB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;CAC3F;AAED,MAAM,MAAM,oCAAoC,GAAG,CACjD,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,eAAe,KACnB,6BAA6B,CAAC;AAEnC,MAAM,WAAW,wCAAwC,CAAC,QAAQ,GAAG,OAAO;IAC1E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,oCAAoC,CAAC;IACnE,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,2BAA2B,KAAK,IAAI,CAAC;IAClF,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,oBAAoB,CAAC,QAAQ,CAAC,CAAC;CAC7E;AAID,wBAAgB,uCAAuC,CAAC,QAAQ,GAAG,OAAO,EACxE,OAAO,EAAE,wCAAwC,CAAC,QAAQ,CAAC,GAC1D,wBAAwB,CAAC,QAAQ,CAAC,CAgGpC;AAED,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,2BAA2B,GAAG,GAAG,CAsBhG;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAElH"}
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../src/realtime/sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,wBAAwB,EAExB,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1D,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACzC,KAAK,IAAI,IAAI,CAAC;IACd,gBAAgB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;IACvF,mBAAmB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;CAC3F;AAED,MAAM,MAAM,oCAAoC,GAAG,CACjD,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,eAAe,KACnB,6BAA6B,CAAC;AAEnC,MAAM,WAAW,wCAAwC,CAAC,QAAQ,GAAG,OAAO;IAC1E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,oCAAoC,CAAC;IACnE,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,2BAA2B,KAAK,IAAI,CAAC;IAClF,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,oBAAoB,CAAC,QAAQ,CAAC,CAAC;CAC7E;AAID,wBAAgB,uCAAuC,CAAC,QAAQ,GAAG,OAAO,EACxE,OAAO,EAAE,wCAAwC,CAAC,QAAQ,CAAC,GAC1D,wBAAwB,CAAC,QAAQ,CAAC,CAgGpC;AAED,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,2BAA2B,GAAG,GAAG,CAsBhG;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAElH"}

package/realtime/websocket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../../src/realtime/websocket.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EACV,oBAAoB,EAEpB,wBAAwB,EAExB,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAGpB;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1D,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,2BAA2B,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,kGAAkG;AAClG,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,MAAM,wBAAwB,GAAG,CACrC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,KAClD,iBAAiB,CAAC;AAEvB,MAAM,WAAW,iCAAiC,CAAC,QAAQ,GAAG,OAAO;IACnE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACpD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;IACrD,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,2BAA2B,KAAK,IAAI,CAAC;IAClF,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC5E;;;;;OAKG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,2BAA2B,KAAK,OAAO,CAAC;IACpF;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAClD;AAID,wBAAgB,gCAAgC,CAAC,QAAQ,GAAG,OAAO,EACjE,OAAO,EAAE,iCAAiC,CAAC,QAAQ,CAAC,GACnD,wBAAwB,CAAC,QAAQ,CAAC,CAwGpC"}
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../../src/realtime/websocket.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EACV,oBAAoB,EACpB,wBAAwB,EAExB,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAGpB;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1D,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,2BAA2B,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,kGAAkG;AAClG,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,MAAM,wBAAwB,GAAG,CACrC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,KAClD,iBAAiB,CAAC;AAEvB,MAAM,WAAW,iCAAiC,CAAC,QAAQ,GAAG,OAAO;IACnE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACpD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;IACrD,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,2BAA2B,KAAK,IAAI,CAAC;IAClF,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC5E;;;;;OAKG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,2BAA2B,KAAK,OAAO,CAAC;IACpF;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAClD;AAID,wBAAgB,gCAAgC,CAAC,QAAQ,GAAG,OAAO,EACjE,OAAO,EAAE,iCAAiC,CAAC,QAAQ,CAAC,GACnD,wBAAwB,CAAC,QAAQ,CAAC,CAwGpC"}

package/realtime/wire.d.ts

@@ -22,6 +22,7 @@ export declare function decodeDefaultRealtimeEnvelope<TFeature = unknown>(payloa
  */
 export declare function normalizeRealtimeErrorEvent<TFeature>(event: RealtimeFeatureEvent<TFeature>): RealtimeFeatureEvent<TFeature>;
 export type RealtimeTransportFailureCode = "consumer-failed" | "delivery-failed" | "invalid-event" | "transport-gap";
-export declare function realtimeFailure(code: RealtimeTransportFailureCode, message: string, cause: unknown): HonuaRealtimeResumeError;
+export type RealtimeWireFailureCode = RealtimeTransportFailureCode | "cursor-expired" | "resume-unsupported";
+export declare function realtimeFailure(code: RealtimeWireFailureCode, message: string, cause: unknown): HonuaRealtimeResumeError;
 export declare function isRecord(value: unknown): value is Record<string, unknown>;
 //# sourceMappingURL=wire.d.ts.map

package/realtime/wire.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../../src/realtime/wire.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAclH;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAClD,KAAK,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GACpC,oBAAoB,CAAC,QAAQ,CAAC,CAehC;AAED,MAAM,MAAM,4BAA4B,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,eAAe,GAAG,eAAe,CAAC;AAErH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,4BAA4B,EAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACb,wBAAwB,CAI1B;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../../src/realtime/wire.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAclH;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAClD,KAAK,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GACpC,oBAAoB,CAAC,QAAQ,CAAC,CAuBhC;AAED,MAAM,MAAM,4BAA4B,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,eAAe,GAAG,eAAe,CAAC;AACrH,MAAM,MAAM,uBAAuB,GAAG,4BAA4B,GAAG,gBAAgB,GAAG,oBAAoB,CAAC;AAE7G,wBAAgB,eAAe,CAC7B,IAAI,EAAE,uBAAuB,EAC7B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACb,wBAAwB,CAM1B;AAYD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}

package/realtime/wire.js

@@ -37,20 +37,36 @@ export function decodeDefaultRealtimeEnvelope(payload) {
 export function normalizeRealtimeErrorEvent(event) {
     if (event.type !== "error")
         return event;
-    const code = event.terminal ? "invalid-event" : "transport-gap";
-    if (event.error instanceof HonuaRealtimeResumeError && isHonuaSdkError(event.error) && event.error.code === code)
-        return event;
+    const terminal = event.terminal === true;
+    const code = terminal ? "invalid-event" : normalizeReconnectableWireCode(event.code);
+    const error = realtimeFailure(code, terminal
+        ? "Realtime stream reported a terminal protocol failure."
+        : code === "cursor-expired"
+            ? "Realtime stream reported that its resume cursor expired."
+            : code === "resume-unsupported"
+                ? "Realtime stream reported that resume is unsupported."
+                : "Realtime stream reported a reconnectable transport failure.", undefined);
     return {
-        ...event,
-        error: realtimeFailure(code, event.terminal
-            ? "Realtime stream reported a terminal protocol failure."
-            : "Realtime stream reported a reconnectable transport failure.", event.error),
+        type: "error",
+        code,
+        error,
+        ...(typeof event.terminal === "boolean" ? { terminal: event.terminal } : {}),
+        ...(isNonNegativeFiniteNumber(event.retryAfterMs) ? { retryAfterMs: event.retryAfterMs } : {}),
+        ...(isNonNegativeFiniteNumber(event.receivedAt) ? { receivedAt: event.receivedAt } : {}),
     };
 }
 export function realtimeFailure(code, message, cause) {
     return cause instanceof HonuaRealtimeResumeError && isHonuaSdkError(cause) && cause.code === code
         ? cause
-        : new HonuaRealtimeResumeError(code, message, { cause });
+        : cause === undefined
+            ? new HonuaRealtimeResumeError(code, message)
+            : new HonuaRealtimeResumeError(code, message, { cause });
+}
+function normalizeReconnectableWireCode(value) {
+    return value === "cursor-expired" || value === "resume-unsupported" ? value : "transport-gap";
+}
+function isNonNegativeFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0;
 }
 export function isRecord(value) {
     return typeof value === "object" && value !== null;

package/replica-sync/errors.d.ts

@@ -8,7 +8,13 @@
  * @module
  */
 import { HonuaSdkError } from "../core/error-envelope.js";
-export type ReplicaSyncErrorCode = "unsupported-sync" | "unsupported-conflict-review" | "unsupported-conflict-resolution" | "replica-not-found" | "conflict-not-found" | "replica-expired" | "conflict-already-resolved" | "merge-required" | "permission-denied" | "transport-failure";
+export type ReplicaSyncErrorCode = "unsupported-sync" | "unsupported-conflict-review" | "unsupported-conflict-resolution" | "replica-not-found" | "conflict-not-found" | "replica-expired" | "conflict-already-resolved" | "merge-required" | "permission-denied"
+/**
+ * A server response did not match the dialect this build was written against:
+ * an unknown classification code, a missing required member, or a value that
+ * cannot be read losslessly. Raised instead of guessing a mapping.
+ */
+ | "response-drift" | "transport-failure";
 export declare class HonuaReplicaSyncError extends HonuaSdkError {
     readonly code: ReplicaSyncErrorCode;
     readonly details: unknown;
@@ -20,4 +26,16 @@ export declare class HonuaReplicaSyncError extends HonuaSdkError {
 export declare function isHonuaReplicaSyncError(error: unknown): error is HonuaReplicaSyncError;
 /** True for the `unsupported-*` family of codes. */
 export declare function isUnsupportedReplicaSyncError(error: unknown): error is HonuaReplicaSyncError;
+/**
+ * True for every typed refusal that means "this deployment does not offer the
+ * replica-sync capability you asked for".
+ *
+ * Two vocabularies legitimately answer that question: a transport that infers
+ * it from its own state raises the `unsupported-*` family, while a transport
+ * that reads a server's advertised capability surface raises the SDK-wide
+ * {@link HonuaCapabilityNotSupportedError} naming the capability. A caller
+ * deciding whether to hide manual conflict review must accept both, so the
+ * predicate lives here rather than being re-derived per call site.
+ */
+export declare function isReplicaSyncCapabilityRefusal(error: unknown): boolean;
 //# sourceMappingURL=errors.d.ts.map

package/replica-sync/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/replica-sync/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAuB,aAAa,EAAyC,MAAM,2BAA2B,CAAC;AAEtH,MAAM,MAAM,oBAAoB,GAC5B,kBAAkB,GAClB,6BAA6B,GAC7B,iCAAiC,GACjC,mBAAmB,GACnB,oBAAoB,GACpB,iBAAiB,GACjB,2BAA2B,GAC3B,gBAAgB,GAChB,mBAAmB,GACnB,mBAAmB,CAAC;AAExB,qBAAa,qBAAsB,SAAQ,aAAa;IACtD,SAAgB,IAAI,EAAE,oBAAoB,CAAC;IAC3C,SAAgB,OAAO,EAAE,OAAO,CAAC;gBAG/B,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAWzE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAEtF;AAED,oDAAoD;AACpD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAO5F"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/replica-sync/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAuB,aAAa,EAAyC,MAAM,2BAA2B,CAAC;AAGtH,MAAM,MAAM,oBAAoB,GAC5B,kBAAkB,GAClB,6BAA6B,GAC7B,iCAAiC,GACjC,mBAAmB,GACnB,oBAAoB,GACpB,iBAAiB,GACjB,2BAA2B,GAC3B,gBAAgB,GAChB,mBAAmB;AACrB;;;;GAIG;GACD,gBAAgB,GAChB,mBAAmB,CAAC;AAExB,qBAAa,qBAAsB,SAAQ,aAAa;IACtD,SAAgB,IAAI,EAAE,oBAAoB,CAAC;IAC3C,SAAgB,OAAO,EAAE,OAAO,CAAC;gBAG/B,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAWzE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAEtF;AAED,oDAAoD;AACpD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAO5F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEtE"}

package/replica-sync/errors.js

@@ -8,6 +8,7 @@
  * @module
  */
 import { HonuaSdkError, isRetryableNetworkOrTimeoutHonuaError } from "../core/error-envelope.js";
+import { HonuaCapabilityNotSupportedError } from "../core/errors.js";
 export class HonuaReplicaSyncError extends HonuaSdkError {
     code;
     details;
@@ -32,6 +33,20 @@ export function isUnsupportedReplicaSyncError(error) {
             error.code === "unsupported-conflict-review" ||
             error.code === "unsupported-conflict-resolution"));
 }
+/**
+ * True for every typed refusal that means "this deployment does not offer the
+ * replica-sync capability you asked for".
+ *
+ * Two vocabularies legitimately answer that question: a transport that infers
+ * it from its own state raises the `unsupported-*` family, while a transport
+ * that reads a server's advertised capability surface raises the SDK-wide
+ * {@link HonuaCapabilityNotSupportedError} naming the capability. A caller
+ * deciding whether to hide manual conflict review must accept both, so the
+ * predicate lives here rather than being re-derived per call site.
+ */
+export function isReplicaSyncCapabilityRefusal(error) {
+    return isUnsupportedReplicaSyncError(error) || error instanceof HonuaCapabilityNotSupportedError;
+}
 const REPLICA_SYNC_ERROR_CODES = {
     "unsupported-sync": "offline.replica-sync.capability",
     "unsupported-conflict-review": "offline.replica-sync.capability",
@@ -41,6 +56,7 @@ const REPLICA_SYNC_ERROR_CODES = {
     "replica-expired": "offline.replica-sync.validation",
     "conflict-already-resolved": "offline.replica-sync.validation",
     "merge-required": "offline.replica-sync.validation",
+    "response-drift": "offline.replica-sync.validation",
     "permission-denied": "offline.replica-sync.permission-denied",
     "transport-failure": "offline.transport.failure",
 };