@interop/was-react 0.20.1 → 0.21.0

package/dist/sync/types.js

@@ -1,58 +0,0 @@
-/**
- * The typed port signals, owned by `@interop/was-client` (its sync port raises
- * them) and re-exported here so the names this package's consumers already
- * import stay put -- and so an `instanceof` check anywhere in this package
- * matches the very class the port throws.
- *
- * `WasSyncConflictError` marks a conditional write rejected with `412
- * precondition-failed` (a lost-update conflict, or a create-if-absent whose
- * target already exists); the push handler catches exactly it to trigger the
- * re-read-and-report-conflict path. `WasSyncAuthError` marks a request refused
- * on authorization grounds -- `401`, `403`, or the `404` a WAS server masks a
- * failed capability invocation as, which on the sync paths (where the invoked
- * collection is known to exist) means the invocation was rejected. It keeps the
- * offending HTTP status on `status`, which the `/meta` push path reads to tell
- * a masked denial from an ordinary delete race.
- */
-export { WasSyncAuthError, WasSyncConflictError } from '@interop/was-client/sync';
-/**
- * Structural equality over two opaque bodies, by canonical-free JSON string.
- * Decides whether the content or the metadata half changed -- which endpoint(s)
- * a push writes, and whether two states compare equal for conflict resolution.
- * Content-addressed collections never mutate `data` for a given id, and a real
- * metadata edit re-encrypts to fresh bytes, so this coarse comparison suffices.
- *
- * @param left {Json | undefined}
- * @param right {Json | undefined}
- * @returns {boolean}
- */
-export function bodiesEqual(left, right) {
-    return JSON.stringify(left ?? null) === JSON.stringify(right ?? null);
-}
-/**
- * Copies the {@link OptionalBodyFields} that are present on `source` onto
- * `target`, leaving an absent field absent (never writing an explicit
- * `undefined`, which would surface the key in a serialized body). The single
- * place every wire-to-local, feed-to-master, and master-to-conflict mapping
- * shares, so a new optional wire field is added once.
- *
- * @param options {object}
- * @param options.source {OptionalBodyFields}
- * @param options.target {OptionalBodyFields}   mutated in place
- * @returns {void}
- */
-export function copyOptionalBodyFields({ source, target }) {
-    if (source.data !== undefined) {
-        target.data = source.data;
-    }
-    if (source.metaVersion !== undefined) {
-        target.metaVersion = source.metaVersion;
-    }
-    if (source.custom !== undefined) {
-        target.custom = source.custom;
-    }
-    if (source.epoch !== undefined) {
-        target.epoch = source.epoch;
-    }
-}
-//# sourceMappingURL=types.js.map

package/dist/sync/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sync/types.ts"],"names":[],"mappings":"AAgCA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,0BAA0B,CAAA;AA2BjC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CACzB,IAAsB,EACtB,KAAuB;IAEvB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,IAAI,CAAC,CAAA;AACvE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CAAC,EACrC,MAAM,EACN,MAAM,EAIP;IACC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;IAC3B,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACrC,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAA;IACzC,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;IAC/B,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;IAC7B,CAAC;AACH,CAAC"}

package/dist/sync/wasReplication.d.ts

@@ -1,47 +0,0 @@
-/*!
- * Copyright (c) 2026 Interop Alliance. All rights reserved.
- */
-/**
- * `createWasReplication` -- wires an RxDB collection to a remote WAS Collection
- * through the collection-agnostic pull/push handlers. This is the single public
- * entry point of the sync module; the caller supplies an already-open RxDB
- * collection and a {@link WasSyncPort} (its only WAS dependency), and gets back
- * the live `RxReplicationState` to observe (`error$` / `active$`) and control
- * (`reSync()` / `cancel()`).
- *
- * No React and no `@interop/was-client` imports -- only RxDB (the replication
- * engine being wrapped) and the injected port. This is the seam that keeps the
- * WAS access injectable.
- */
-import { type RxReplicationState } from 'rxdb/plugins/replication';
-import type { RxCollection } from 'rxdb/plugins/core';
-import type { SyncCheckpoint, SyncedDoc, WasSyncPort } from './types.js';
-/**
- * Starts (or configures) replication of one RxDB collection against a remote WAS
- * Collection. Poll-based only -- no `pull.stream$` (live streaming is deferred
- * server-side); RxDB's own `retryTime` backoff and `error$` are the reachability
- * signal (the replication attempt is the probe).
- *
- * @param options {object}
- * @param options.rxCollection {RxCollection<SyncedDoc>}   the local replica
- * @param options.wasPort {WasSyncPort}                    injected WAS access
- * @param options.replicationIdentifier {string}   stable id (include the server
- *   URL + collection) so RxDB can resume across reloads
- * @param [options.batchSize] {number}    pull `limit` / push batch (default 100)
- * @param [options.retryTime] {number}    ms backoff between failed cycles
- * @param [options.live] {boolean}        ongoing (default true) vs one-shot
- * @param [options.autoStart] {boolean}   start immediately (default true)
- * @param [options.deletedField] {string} RxDB deleted flag (default `_deleted`)
- * @returns {RxReplicationState<SyncedDoc, SyncCheckpoint>}
- */
-export declare function createWasReplication({ rxCollection, wasPort, replicationIdentifier, batchSize, retryTime, live, autoStart, deletedField }: {
-    rxCollection: RxCollection<SyncedDoc>;
-    wasPort: WasSyncPort;
-    replicationIdentifier: string;
-    batchSize?: number;
-    retryTime?: number;
-    live?: boolean;
-    autoStart?: boolean;
-    deletedField?: string;
-}): RxReplicationState<SyncedDoc, SyncCheckpoint>;
-//# sourceMappingURL=wasReplication.d.ts.map

package/dist/sync/wasReplication.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wasReplication.d.ts","sourceRoot":"","sources":["../../src/sync/wasReplication.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;GAWG;AACH,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AA2CxE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,YAAY,EACZ,OAAO,EACP,qBAAqB,EACrB,SAAe,EACf,SAAS,EACT,IAAW,EACX,SAAgB,EAChB,YAAyB,EAC1B,EAAE;IACD,YAAY,EAAE,YAAY,CAAC,SAAS,CAAC,CAAA;IACrC,OAAO,EAAE,WAAW,CAAA;IACpB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,GAAG,kBAAkB,CAAC,SAAS,EAAE,cAAc,CAAC,CAiBhD"}

package/dist/sync/wasReplication.js

@@ -1,92 +0,0 @@
-/*!
- * Copyright (c) 2026 Interop Alliance. All rights reserved.
- */
-/**
- * `createWasReplication` -- wires an RxDB collection to a remote WAS Collection
- * through the collection-agnostic pull/push handlers. This is the single public
- * entry point of the sync module; the caller supplies an already-open RxDB
- * collection and a {@link WasSyncPort} (its only WAS dependency), and gets back
- * the live `RxReplicationState` to observe (`error$` / `active$`) and control
- * (`reSync()` / `cancel()`).
- *
- * No React and no `@interop/was-client` imports -- only RxDB (the replication
- * engine being wrapped) and the injected port. This is the seam that keeps the
- * WAS access injectable.
- */
-import { replicateRxCollection } from 'rxdb/plugins/replication';
-import { createPullHandler } from './changesQuery.js';
-import { createPushHandler } from './pushWrites.js';
-/**
- * Builds the push write-back: patches an accepted write's acked server
- * revision(s) (`version` / `metaVersion`) into the local row so the next
- * conditional write's `If-Match` matches the server. Skips rows that are gone
- * or already current (a tombstoned row is invisible to `findOne` and needs no
- * write-back -- nothing further is pushed for a deleted id). Failures are
- * swallowed: the write itself succeeded, and a missed write-back only means
- * the acked revision is adopted from the change feed's echo on a later pull.
- *
- * @param rxCollection {RxCollection<SyncedDoc>}
- * @returns {(ack: PushWriteAck) => Promise<void>}
- */
-function createAckWriteBack(rxCollection) {
-    return async function writeBack(ack) {
-        try {
-            const doc = await rxCollection.findOne(ack.id).exec();
-            if (doc === null) {
-                return;
-            }
-            const patch = {};
-            if (ack.version !== undefined && doc.get('version') !== ack.version) {
-                patch.version = ack.version;
-            }
-            if (ack.metaVersion !== undefined &&
-                doc.get('metaVersion') !== ack.metaVersion) {
-                patch.metaVersion = ack.metaVersion;
-            }
-            if (Object.keys(patch).length > 0) {
-                await doc.incrementalPatch(patch);
-            }
-        }
-        catch {
-            // Best-effort: the server write was accepted; the revision echo on the
-            // next pull corrects the row if this local patch could not be applied.
-        }
-    };
-}
-/**
- * Starts (or configures) replication of one RxDB collection against a remote WAS
- * Collection. Poll-based only -- no `pull.stream$` (live streaming is deferred
- * server-side); RxDB's own `retryTime` backoff and `error$` are the reachability
- * signal (the replication attempt is the probe).
- *
- * @param options {object}
- * @param options.rxCollection {RxCollection<SyncedDoc>}   the local replica
- * @param options.wasPort {WasSyncPort}                    injected WAS access
- * @param options.replicationIdentifier {string}   stable id (include the server
- *   URL + collection) so RxDB can resume across reloads
- * @param [options.batchSize] {number}    pull `limit` / push batch (default 100)
- * @param [options.retryTime] {number}    ms backoff between failed cycles
- * @param [options.live] {boolean}        ongoing (default true) vs one-shot
- * @param [options.autoStart] {boolean}   start immediately (default true)
- * @param [options.deletedField] {string} RxDB deleted flag (default `_deleted`)
- * @returns {RxReplicationState<SyncedDoc, SyncCheckpoint>}
- */
-export function createWasReplication({ rxCollection, wasPort, replicationIdentifier, batchSize = 100, retryTime, live = true, autoStart = true, deletedField = '_deleted' }) {
-    return replicateRxCollection({
-        replicationIdentifier,
-        collection: rxCollection,
-        deletedField,
-        live,
-        autoStart,
-        ...(retryTime !== undefined && { retryTime }),
-        pull: {
-            handler: createPullHandler(wasPort),
-            batchSize
-        },
-        push: {
-            handler: createPushHandler(wasPort, createAckWriteBack(rxCollection)),
-            batchSize
-        }
-    });
-}
-//# sourceMappingURL=wasReplication.js.map

package/dist/sync/wasReplication.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"wasReplication.js","sourceRoot":"","sources":["../../src/sync/wasReplication.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;GAWG;AACH,OAAO,EACL,qBAAqB,EAEtB,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAqB,MAAM,iBAAiB,CAAA;AAEtE;;;;;;;;;;;GAWG;AACH,SAAS,kBAAkB,CAAC,YAAqC;IAC/D,OAAO,KAAK,UAAU,SAAS,CAAC,GAAiB;QAC/C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;YACrD,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBACjB,OAAM;YACR,CAAC;YACD,MAAM,KAAK,GAAuB,EAAE,CAAA;YACpC,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;gBACpE,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAA;YAC7B,CAAC;YACD,IACE,GAAG,CAAC,WAAW,KAAK,SAAS;gBAC7B,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,GAAG,CAAC,WAAW,EAC1C,CAAC;gBACD,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAA;YACrC,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClC,MAAM,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAA;YACnC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uEAAuE;YACvE,uEAAuE;QACzE,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,oBAAoB,CAAC,EACnC,YAAY,EACZ,OAAO,EACP,qBAAqB,EACrB,SAAS,GAAG,GAAG,EACf,SAAS,EACT,IAAI,GAAG,IAAI,EACX,SAAS,GAAG,IAAI,EAChB,YAAY,GAAG,UAAU,EAU1B;IACC,OAAO,qBAAqB,CAA4B;QACtD,qBAAqB;QACrB,UAAU,EAAE,YAAY;QACxB,YAAY;QACZ,IAAI;QACJ,SAAS;QACT,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7C,IAAI,EAAE;YACJ,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC;YACnC,SAAS;SACV;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC;YACrE,SAAS;SACV;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/sync/wasSyncPort.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wasSyncPort.d.ts","sourceRoot":"","sources":["../../src/sync/wasSyncPort.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAEpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAA;AACzD,OAAO,KAAK,EAAkB,eAAe,EAAW,MAAM,YAAY,CAAA;AAE1E;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,GAAG,EACH,OAAO,EACP,YAAY,EACZ,UAAU,EACX,EAAE;IACD,GAAG,EAAE,SAAS,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,KAAK,CAAA;CACnB,GAAG,eAAe,CAqClB"}

package/dist/sync/wasSyncPort.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"wasSyncPort.js","sourceRoot":"","sources":["../../src/sync/wasSyncPort.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,iBAAiB,IAAI,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAIpF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAChC,GAAG,EACH,OAAO,EACP,YAAY,EACZ,UAAU,EAMX;IACC,MAAM,IAAI,GAAG,oBAAoB,CAAC;QAChC,GAAG;QACH,OAAO;QACP,YAAY;QACZ,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,CAAC;QAC/C,aAAa,EAAE,IAAI;KACpB,CAAC,CAAA;IACF,8EAA8E;IAC9E,4EAA4E;IAC5E,4EAA4E;IAC5E,+BAA+B;IAC/B,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IACxB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,6DAA6D;YAC3D,iCAAiC,CACpC,CAAA;IACH,CAAC;IAED,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,OAAO;YACjB,sEAAsE;YACtE,qEAAqE;YACrE,uDAAuD;YACvD,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAGhC,CAAA;QACH,CAAC;QAED,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAE/C,aAAa,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;QAErD,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;KACrC,CAAA;AACH,CAAC"}