@baukit/sync-client 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Patrick Koss
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,165 @@
+# @baukit/sync-client
+
+`@baukit/sync-client` holds the four client-side pieces every offline-capable product rebuilds
+around a sync loop: when to run, how to send a request, how to report status, and what order to
+push a batch in. It does not define a sync protocol. Endpoint paths, payloads, conflict rules, and
+the sync engine itself stay product-owned, as
+[the offline readiness contract](../../../docs/platform/offline-readiness-contract.md) says they
+must.
+
+The root entry has no runtime dependencies and no React. Timers, foreground state, connectivity,
+and `fetch` all arrive by injection, so the same code runs under Node, a browser, and React Native.
+The optional `@baukit/sync-client/expo` entry imports `react-native` and `expo-network`; neither is
+loaded by the root entry.
+
+## Scheduler
+
+`SyncScheduler` takes one opaque `run()` callback and a `SyncSchedulerEnvironment`. It guarantees
+a single active run: a trigger arriving mid-run joins that run instead of starting a second one.
+
+```ts
+const scheduler = new SyncScheduler(() => engine.run(), environment, { intervalMs: 60_000 });
+scheduler.start();
+```
+
+`trigger()` starts a run or joins the active one. `requestFollowUp()` is what a local write calls:
+if a run is already active it queues exactly one replay after that run settles, so a write made
+while the engine was mid-push is never left unsent. Repeated follow-up requests still collapse
+into one replay. `stop()` drops the queued replay along with the interval and subscriptions.
+
+The environment reports foreground state and connectivity. The scheduler runs on start, when the
+app returns to the foreground, when connectivity returns, and on the interval. It installs no
+interval while backgrounded and ignores connectivity events there.
+
+A failing run reaches `onError` and does not stop scheduling. Backoff between attempts belongs to
+the product's engine, inside `run()`, where it can see which failures are retryable.
+
+### Expo environment
+
+Expo products can use the supplied environment instead of repeating AppState and network wiring:
+
+```ts
+import { SyncScheduler } from '@baukit/sync-client';
+import { createExpoSyncEnvironment } from '@baukit/sync-client/expo';
+
+const scheduler = new SyncScheduler(() => engine.run(), createExpoSyncEnvironment());
+```
+
+The environment treats only AppState `active` as foreground. On native platforms it reads the
+initial state from `expo-network` and triggers only when connectivity changes from unusable to
+usable. Expo web uses the browser `online` event. Tests can pass `{ timers }` to replace
+`setInterval` and `clearInterval`. `react-native` and `expo-network` are optional peers because
+non-Expo consumers never import this subpath.
+
+## Transport
+
+The original `SyncTransport` constructor wraps an injected `fetch` and auth header provider, and
+turns every failure into a typed error:
+
+- `SyncAuthError` for 401, never retryable;
+- `SyncPartitionMismatchError` when the body carries the configured partition-mismatch code,
+  meaning the local database belongs to an erased or replaced owner;
+- `SyncTransportError` otherwise, with `retryable` true for 408, 429, and 5xx, plus network and
+  body-read failures.
+
+Auth headers resolve per attempt, so a token refreshed between retries is picked up. The
+partition header is sent only when the caller passes a `partitionId`, and both its name and the
+mismatch code are configurable. The transport never names an endpoint: callers pass the path and
+the response type.
+
+A product API client often already owns the base URL, token refresh, authentication recovery,
+response decoding, and its error policy. Pass its decoded request function instead of duplicating
+that work in the transport:
+
+```ts
+const transport = new SyncTransport({
+  request: apiClient.request.bind(apiClient),
+  partitionHeader: 'X-Product-Profile-Id',
+});
+
+await transport.request('/api/v1/sync/push', {
+  method: 'POST',
+  body: { changes },
+  partitionId: profileId,
+});
+```
+
+This mode builds the relative path, query string, JSON body, and partition header, then delegates.
+The request function owns decoding and errors, which keeps the product API client's existing auth
+recovery intact. The fetch-backed constructor remains unchanged for products that want
+`SyncTransportError` classification from response status and body.
+
+## Status store
+
+`SyncStatusStore` is the observable sync status, with `subscribe`/`getSnapshot` and no state
+library. It encodes rules the offline readiness contract requires and products keep getting
+wrong:
+
+- an actionable rejection outranks a transport failure, so a failed run over existing conflicts
+  still reads `attention`;
+- unsent work outranks a bare error, so a failed run with pending changes reads `pending`,
+  not `error`;
+- the first run is the initial pull; later runs are settled activity.
+
+`refreshRevision` increments whenever a run delivers a new authoritative snapshot.
+`deriveLocalStoreReadiness` compares it against what a consumer has actually rendered, which is
+how a cold start avoids flashing an empty state over data that is still arriving.
+`deriveInitialSyncState` maps a snapshot onto the contract's `unknown` / `syncing` /
+`offline-cached` / `settled` vocabulary.
+
+The store is generic over its attention item and defaults to the existing
+`{ entityType, entityId }` shape. This keeps one store API while allowing a product to retain the
+rejection details its UI needs:
+
+```ts
+interface ProductAttention {
+  object_entity_type: string;
+  object_entity_id: string;
+  rejections: readonly Rejection[];
+}
+
+const status = new SyncStatusStore<ProductAttention>();
+status.setAttention(items, pendingCount);
+```
+
+For stores and screens that use API-style names, `toSnakeCaseSnapshot` returns a typed projection:
+
+```ts
+const snapshot = toSnakeCaseSnapshot(status.getSnapshot());
+
+snapshot.last_sync_at;
+snapshot.pending_count;
+snapshot.initial_pull_status;
+snapshot.refresh_revision;
+snapshot.security_block;
+```
+
+`status`, `error`, and `attention` keep their names. Attention items also keep their original
+shape.
+
+## Push batch ranking
+
+`rankPushBatch` orders one push batch so a parent is never sent after its children.
+
+```ts
+const rank = dependencyRankByOrder(['container', 'group', 'leaf']);
+const batch = rankPushBatch(pending, {
+  rank,
+  batchSize: 200,
+  isHeldBack: (change) => hasUnsentChildren(change),
+});
+```
+
+Changes are grouped by `entityType:entityId`. Each group keeps the position of its first
+occurrence, so foreign-key order survives coalescing, and carries the newest change so the
+request sends current data. `coveredChangeIds` lists every queued change the group settles,
+because server outcomes are keyed by entity rather than by outbox row: one outcome clears all of
+them.
+
+`isHeldBack` is the other half of the rule. A parent whose required children are still unsent is
+dropped from the batch rather than reordered, and retried on a later run once those children have
+been accepted. Sending it now would show the server a complete parent while a required child is
+missing. Held-back entities do not consume batch-size slots.
+
+Entity names, the dependency order, and the hold-back predicate are all product inputs. Baukit
+knows only that a rank exists.

package/dist/error.d.ts

@@ -0,0 +1,20 @@
+/** A sync request failed. `retryable` decides whether a later attempt may win. */
+export declare class SyncTransportError extends Error {
+    readonly retryable: boolean;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, retryable: boolean, cause?: unknown | undefined);
+}
+/** Credentials were rejected. Never retryable without re-authentication. */
+export declare class SyncAuthError extends SyncTransportError {
+    readonly kind = "auth";
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * The server rejected the caller's local-data partition, so the local database
+ * belongs to an erased or replaced owner and must not be reused.
+ */
+export declare class SyncPartitionMismatchError extends SyncTransportError {
+    readonly kind = "partition-mismatch";
+    constructor(message: string, cause?: unknown);
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,qBAAa,kBAAmB,SAAQ,KAAK;IAGzC,QAAQ,CAAC,SAAS,EAAE,OAAO;aACT,KAAK,CAAC,EAAE,OAAO;gBAFjC,OAAO,EAAE,MAAM,EACN,SAAS,EAAE,OAAO,EACT,KAAK,CAAC,EAAE,OAAO,YAAA;CAKpC;AAED,4EAA4E;AAC5E,qBAAa,aAAc,SAAQ,kBAAkB;IACnD,QAAQ,CAAC,IAAI,UAAU;gBAEX,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAED;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,kBAAkB;IAChE,QAAQ,CAAC,IAAI,wBAAwB;gBAEzB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C"}

package/dist/error.js

@@ -0,0 +1,31 @@
+/** A sync request failed. `retryable` decides whether a later attempt may win. */
+export class SyncTransportError extends Error {
+    retryable;
+    cause;
+    constructor(message, retryable, cause) {
+        super(message);
+        this.retryable = retryable;
+        this.cause = cause;
+        this.name = 'SyncTransportError';
+    }
+}
+/** Credentials were rejected. Never retryable without re-authentication. */
+export class SyncAuthError extends SyncTransportError {
+    kind = 'auth';
+    constructor(message, cause) {
+        super(message, false, cause);
+        this.name = 'SyncAuthError';
+    }
+}
+/**
+ * The server rejected the caller's local-data partition, so the local database
+ * belongs to an erased or replaced owner and must not be reused.
+ */
+export class SyncPartitionMismatchError extends SyncTransportError {
+    kind = 'partition-mismatch';
+    constructor(message, cause) {
+        super(message, false, cause);
+        this.name = 'SyncPartitionMismatchError';
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAGhC;IACS;IAHpB,YACE,OAAe,EACN,SAAkB,EACT,KAAe;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,cAAS,GAAT,SAAS,CAAS;QACT,UAAK,GAAL,KAAK,CAAU;QAGjC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,4EAA4E;AAC5E,MAAM,OAAO,aAAc,SAAQ,kBAAkB;IAC1C,IAAI,GAAG,MAAM,CAAC;IAEvB,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,0BAA2B,SAAQ,kBAAkB;IACvD,IAAI,GAAG,oBAAoB,CAAC;IAErC,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF"}

package/dist/expo.d.ts

@@ -0,0 +1,12 @@
+import type { SyncSchedulerEnvironment, SyncSchedulerTimer } from './scheduler.js';
+export interface ExpoSyncTimers {
+    setInterval(callback: () => void, milliseconds: number): SyncSchedulerTimer;
+    clearInterval(handle: SyncSchedulerTimer): void;
+}
+export interface ExpoSyncEnvironmentOptions {
+    /** Overrides global timers, primarily for deterministic scheduler tests. */
+    timers?: ExpoSyncTimers;
+}
+/** Creates the Expo runtime environment consumed by {@link SyncScheduler}. */
+export declare function createExpoSyncEnvironment(options?: ExpoSyncEnvironmentOptions): SyncSchedulerEnvironment;
+//# sourceMappingURL=expo.d.ts.map

package/dist/expo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expo.d.ts","sourceRoot":"","sources":["../src/expo.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEnF,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,YAAY,EAAE,MAAM,GAAG,kBAAkB,CAAC;IAC5E,aAAa,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,0BAA0B;IACzC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AA4DD,8EAA8E;AAC9E,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,0BAA+B,GACvC,wBAAwB,CAwB1B"}

package/dist/expo.js

@@ -0,0 +1,75 @@
+import * as Network from 'expo-network';
+import { AppState, Platform } from 'react-native';
+const defaultTimers = {
+    setInterval: (callback, milliseconds) => globalThis.setInterval(callback, milliseconds),
+    clearInterval: (handle) => {
+        globalThis.clearInterval(handle);
+    },
+};
+function isUsableNetwork(state) {
+    return state.isConnected === true && state.isInternetReachable !== false;
+}
+function subscribeBrowserOnline(listener) {
+    if (typeof window === 'undefined') {
+        return () => undefined;
+    }
+    window.addEventListener('online', listener);
+    return () => {
+        window.removeEventListener('online', listener);
+    };
+}
+function subscribeNativeOnline(listener) {
+    const network = Network;
+    let subscribed = true;
+    let receivedEvent = false;
+    let wasUsable = null;
+    void network
+        .getNetworkStateAsync()
+        .then((state) => {
+        if (subscribed && !receivedEvent) {
+            wasUsable = isUsableNetwork(state);
+        }
+    })
+        .catch(() => undefined);
+    const subscription = network.addNetworkStateListener?.((state) => {
+        if (!subscribed)
+            return;
+        receivedEvent = true;
+        const usable = isUsableNetwork(state);
+        if (wasUsable === false && usable) {
+            listener();
+        }
+        wasUsable = usable;
+    });
+    return () => {
+        subscribed = false;
+        subscription?.remove();
+    };
+}
+/** Creates the Expo runtime environment consumed by {@link SyncScheduler}. */
+export function createExpoSyncEnvironment(options = {}) {
+    const timers = options.timers ?? defaultTimers;
+    return {
+        isActive: () => AppState.currentState === 'active',
+        subscribeActive(listener) {
+            const subscription = AppState.addEventListener('change', (state) => {
+                listener(state === 'active');
+            });
+            return () => {
+                subscription.remove();
+            };
+        },
+        subscribeOnline(listener) {
+            return Platform.OS === 'web'
+                ? subscribeBrowserOnline(listener)
+                : subscribeNativeOnline(listener);
+        },
+        setInterval(callback, milliseconds) {
+            return timers.setInterval(callback, milliseconds);
+        },
+        clearInterval(handle) {
+            timers.clearInterval(handle);
+        },
+    };
+}
+//# sourceMappingURL=expo.js.map

package/dist/expo.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { SyncAuthError, SyncPartitionMismatchError, SyncTransportError } from './error.js';
+export { dependencyRankByOrder, rankPushBatch } from './push-batch.js';
+export type { PushCandidate, RankedPushItem, RankPushBatchOptions } from './push-batch.js';
+export { SyncScheduler } from './scheduler.js';
+export type { SyncSchedulerEnvironment, SyncSchedulerOptions, SyncSchedulerTimer, } from './scheduler.js';
+export { deriveInitialSyncState, deriveLocalStoreReadiness, SyncStatusStore, toSnakeCaseSnapshot, } from './store.js';
+export type { InitialPullStatus, InitialSyncState, LocalStoreReadiness, LocalStoreReadinessInput, SnakeCaseSyncStatusSnapshot, SyncAttentionItem, SyncStatus, SyncStatusSink, SyncStatusSnapshot, } from './store.js';
+export { SyncTransport } from './transport.js';
+export type { SyncFetch, SyncFetchResponse, SyncPrebuiltRequest, SyncPrebuiltRequestTransportOptions, SyncRequestOptions, SyncRequestInit, SyncFetchTransportOptions, SyncTransportOptions, } from './transport.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACvE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,eAAe,EACf,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,2BAA2B,EAC3B,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,mBAAmB,EACnB,mCAAmC,EACnC,kBAAkB,EAClB,eAAe,EACf,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { SyncAuthError, SyncPartitionMismatchError, SyncTransportError } from './error.js';
+export { dependencyRankByOrder, rankPushBatch } from './push-batch.js';
+export { SyncScheduler } from './scheduler.js';
+export { deriveInitialSyncState, deriveLocalStoreReadiness, SyncStatusStore, toSnakeCaseSnapshot, } from './store.js';
+export { SyncTransport } from './transport.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEvE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAM/C,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,eAAe,EACf,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAYpB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/push-batch.d.ts

@@ -0,0 +1,57 @@
+/**
+ * One unsent local change, as baukit sees it.
+ *
+ * `entityType` and `entityId` identify the row the change targets. Baukit never
+ * interprets either: entity names, payloads, and operations stay product-owned.
+ */
+export interface PushCandidate {
+    /** Stable identity of this queued change, unique across the outbox. */
+    changeId: string;
+    entityType: string;
+    entityId: string;
+}
+/** One entity's place in the batch, after coalescing and ordering. */
+export interface RankedPushItem<T extends PushCandidate> {
+    /** The newest queued change for this entity; its payload is the one to send. */
+    change: T;
+    /**
+     * Every queued change this item settles, oldest first. One server outcome
+     * clears all of them, because outcomes are keyed by entity, not by change.
+     */
+    coveredChangeIds: string[];
+}
+export interface RankPushBatchOptions<T extends PushCandidate> {
+    /**
+     * Dependency rank of an entity type. Lower ranks are sent first, so a parent
+     * type must rank below every type that references it. Unknown types sort last.
+     */
+    rank: (entityType: string) => number;
+    /** Largest number of entities one request may carry. */
+    batchSize: number;
+    /**
+     * Entities whose required children are still unsent, or otherwise not yet
+     * safe to send. Held-back entities are dropped from the batch and retried on
+     * a later run, once their children have been accepted.
+     */
+    isHeldBack?: (change: T) => boolean;
+}
+/**
+ * Orders a push batch parent-before-child and coalesces per entity.
+ *
+ * Queued changes are grouped by `entityType:entityId`. Each group keeps the
+ * position of its first occurrence, so foreign-key order survives coalescing,
+ * and carries the newest change so the request sends current data. Groups are
+ * then sorted by dependency rank, ties broken by that first position, and the
+ * batch is truncated to `batchSize`.
+ *
+ * A parent whose children are unsent is held back rather than reordered: the
+ * server would otherwise see a complete parent while a required child is still
+ * missing.
+ */
+export declare function rankPushBatch<T extends PushCandidate>(pending: readonly T[], { rank, batchSize, isHeldBack }: RankPushBatchOptions<T>): RankedPushItem<T>[];
+/**
+ * Builds a {@link RankPushBatchOptions.rank} function from an ordered list of
+ * entity types. Types absent from the list sort after every listed type.
+ */
+export declare function dependencyRankByOrder(order: readonly string[]): (entityType: string) => number;
+//# sourceMappingURL=push-batch.d.ts.map

package/dist/push-batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-batch.d.ts","sourceRoot":"","sources":["../src/push-batch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,aAAa;IACrD,gFAAgF;IAChF,MAAM,EAAE,CAAC,CAAC;IACV;;;OAGG;IACH,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,aAAa;IAC3D;;;OAGG;IACH,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IACrC,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC;CACrC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,aAAa,EACnD,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC,GACvD,cAAc,CAAC,CAAC,CAAC,EAAE,CAqBrB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAG9F"}

package/dist/push-batch.js

@@ -0,0 +1,39 @@
+/**
+ * Orders a push batch parent-before-child and coalesces per entity.
+ *
+ * Queued changes are grouped by `entityType:entityId`. Each group keeps the
+ * position of its first occurrence, so foreign-key order survives coalescing,
+ * and carries the newest change so the request sends current data. Groups are
+ * then sorted by dependency rank, ties broken by that first position, and the
+ * batch is truncated to `batchSize`.
+ *
+ * A parent whose children are unsent is held back rather than reordered: the
+ * server would otherwise see a complete parent while a required child is still
+ * missing.
+ */
+export function rankPushBatch(pending, { rank, batchSize, isHeldBack }) {
+    const grouped = new Map();
+    pending.forEach((change, order) => {
+        const key = `${change.entityType}:${change.entityId}`;
+        const existing = grouped.get(key);
+        grouped.set(key, {
+            change,
+            coveredChangeIds: [...(existing?.coveredChangeIds ?? []), change.changeId],
+            order: existing?.order ?? order,
+        });
+    });
+    return [...grouped.values()]
+        .filter(({ change }) => !isHeldBack?.(change))
+        .sort((left, right) => rank(left.change.entityType) - rank(right.change.entityType) || left.order - right.order)
+        .slice(0, batchSize)
+        .map(({ change, coveredChangeIds }) => ({ change, coveredChangeIds }));
+}
+/**
+ * Builds a {@link RankPushBatchOptions.rank} function from an ordered list of
+ * entity types. Types absent from the list sort after every listed type.
+ */
+export function dependencyRankByOrder(order) {
+    const ranks = new Map(order.map((entityType, index) => [entityType, index]));
+    return (entityType) => ranks.get(entityType) ?? order.length;
+}
+//# sourceMappingURL=push-batch.js.map

package/dist/push-batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-batch.js","sourceRoot":"","sources":["../src/push-batch.ts"],"names":[],"mappings":"AAwCA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAqB,EACrB,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAA2B;IAExD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoE,CAAC;IAE5F,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAChC,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE;YACf,MAAM;YACN,gBAAgB,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,gBAAgB,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;YAC1E,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,KAAK;SAChC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;SACzB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC;SAC7C,IAAI,CACH,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAC3F;SACA,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;SACnB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAwB;IAC5D,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7E,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC;AAC/D,CAAC"}

package/dist/scheduler.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Host capabilities the scheduler needs. Products supply timers, foreground
+ * state, and connectivity; baukit never reaches for a global.
+ */
+export interface SyncSchedulerEnvironment {
+    isActive(): boolean;
+    subscribeActive(listener: (active: boolean) => void): () => void;
+    subscribeOnline(listener: () => void): () => void;
+    setInterval(callback: () => void, milliseconds: number): SyncSchedulerTimer;
+    clearInterval(handle: SyncSchedulerTimer): void;
+}
+/**
+ * Opaque timer handle returned by the host's `setInterval`. Baukit only stores
+ * it and hands it back to `clearInterval`; its runtime shape is host-defined.
+ */
+export type SyncSchedulerTimer = {
+    readonly __syncSchedulerTimer?: never;
+} & object;
+export interface SyncSchedulerOptions {
+    intervalMs?: number;
+    onError?: (error: unknown) => void;
+}
+/**
+ * Runs one opaque sync callback at most once at a time.
+ *
+ * A trigger that arrives while a run is active joins that run. A follow-up
+ * requested during a run replays the callback once after it settles, so writes
+ * made mid-run are never left unsent without starting a parallel run.
+ */
+export declare class SyncScheduler {
+    private readonly run;
+    private readonly environment;
+    private readonly intervalMs;
+    private readonly onError;
+    private active;
+    private started;
+    private inFlight;
+    private rerunRequested;
+    private interval;
+    private subscriptions;
+    constructor(run: () => Promise<unknown>, environment: SyncSchedulerEnvironment, options?: SyncSchedulerOptions);
+    start(): void;
+    stop(): void;
+    /** Starts a run, or joins the active one. */
+    trigger(): Promise<void>;
+    /** Queues exactly one more run when a run is already active. */
+    requestFollowUp(): Promise<void>;
+    private runUntilSettled;
+    private refreshInterval;
+    private stopInterval;
+}
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,IAAI,OAAO,CAAC;IACpB,eAAe,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACjE,eAAe,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAClD,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,YAAY,EAAE,MAAM,GAAG,kBAAkB,CAAC;IAC5E,aAAa,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACjD;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAAE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG,MAAM,CAAC;AAEpF,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAQD;;;;;;GAMG;AACH,qBAAa,aAAa;IAWtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAX9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,aAAa,CAAsB;gBAGxB,GAAG,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC3B,WAAW,EAAE,wBAAwB,EACtD,OAAO,GAAE,oBAAyB;IAMpC,KAAK,IAAI,IAAI;IA0Bb,IAAI,IAAI,IAAI;IAUZ,6CAA6C;IAC7C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAexB,gEAAgE;IAChE,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;YAQlB,eAAe;IAa7B,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,YAAY;CAOrB"}

package/dist/scheduler.js

@@ -0,0 +1,116 @@
+const DEFAULT_INTERVAL_MS = 5 * 60 * 1000;
+function noop() {
+    return;
+}
+/**
+ * Runs one opaque sync callback at most once at a time.
+ *
+ * A trigger that arrives while a run is active joins that run. A follow-up
+ * requested during a run replays the callback once after it settles, so writes
+ * made mid-run are never left unsent without starting a parallel run.
+ */
+export class SyncScheduler {
+    run;
+    environment;
+    intervalMs;
+    onError;
+    active = false;
+    started = false;
+    inFlight = null;
+    rerunRequested = false;
+    interval = null;
+    subscriptions = [];
+    constructor(run, environment, options = {}) {
+        this.run = run;
+        this.environment = environment;
+        this.intervalMs = options.intervalMs ?? DEFAULT_INTERVAL_MS;
+        this.onError = options.onError ?? noop;
+    }
+    start() {
+        if (this.started) {
+            return;
+        }
+        this.started = true;
+        this.active = this.environment.isActive();
+        this.subscriptions = [
+            this.environment.subscribeActive((active) => {
+                this.active = active;
+                this.refreshInterval();
+                if (active) {
+                    void this.trigger();
+                }
+            }),
+            this.environment.subscribeOnline(() => {
+                if (this.active) {
+                    void this.trigger();
+                }
+            }),
+        ];
+        this.refreshInterval();
+        if (this.active) {
+            void this.trigger();
+        }
+    }
+    stop() {
+        this.started = false;
+        this.rerunRequested = false;
+        this.stopInterval();
+        this.subscriptions.forEach((unsubscribe) => {
+            unsubscribe();
+        });
+        this.subscriptions = [];
+    }
+    /** Starts a run, or joins the active one. */
+    trigger() {
+        if (this.inFlight) {
+            return this.inFlight;
+        }
+        const task = Promise.resolve()
+            .then(() => this.runUntilSettled())
+            .finally(() => {
+            if (this.inFlight === task) {
+                this.inFlight = null;
+            }
+        });
+        this.inFlight = task;
+        return task;
+    }
+    /** Queues exactly one more run when a run is already active. */
+    requestFollowUp() {
+        if (this.inFlight) {
+            this.rerunRequested = true;
+            return this.inFlight;
+        }
+        return this.trigger();
+    }
+    async runUntilSettled() {
+        let rerun = true;
+        while (rerun) {
+            this.rerunRequested = false;
+            try {
+                await this.run();
+            }
+            catch (error) {
+                this.onError(error);
+            }
+            rerun = this.rerunRequested;
+        }
+    }
+    refreshInterval() {
+        this.stopInterval();
+        if (!this.started || !this.active) {
+            return;
+        }
+        this.interval = this.environment.setInterval(() => {
+            void this.trigger();
+        }, this.intervalMs);
+    }
+    stopInterval() {
+        if (this.interval === null) {
+            return;
+        }
+        this.environment.clearInterval(this.interval);
+        this.interval = null;
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,87 @@
+/** Sync activity, as named by the offline-readiness contract. */
+export type SyncStatus = 'idle' | 'syncing' | 'pending' | 'attention' | 'auth' | 'error';
+/** Progress of the initial pull that a cold start must complete. */
+export type InitialPullStatus = 'uninitialized' | 'pulling' | 'settled';
+/** Readiness of the local store, derived from pull progress and delivery. */
+export type LocalStoreReadiness = 'uninitialized' | 'pulling' | 'hydrated-empty' | 'hydrated-populated';
+/** Initial readiness as the offline-readiness contract names it. */
+export type InitialSyncState = 'unknown' | 'syncing' | 'offline-cached' | 'settled';
+/**
+ * One rejection that needs product or user action. `entityType` and `entityId`
+ * are opaque to baukit; products name their own entities.
+ */
+export type SyncAttentionItem<T = {
+    entityType: string;
+    entityId: string;
+}> = T;
+export interface SyncStatusSnapshot<TAttention = SyncAttentionItem> {
+    status: SyncStatus;
+    lastSyncAt: string | null;
+    error: string | null;
+    attention: readonly TAttention[];
+    pendingCount: number;
+    initialPullStatus: InitialPullStatus;
+    /** Increments whenever a run delivers a new authoritative snapshot. */
+    refreshRevision: number;
+    /** Set when identity or corruption makes the local store unusable. */
+    securityBlock: string | null;
+}
+export interface LocalStoreReadinessInput {
+    initialPullStatus: InitialPullStatus;
+    refreshRevision: number;
+    deliveredRevision: number | null;
+    hasData: boolean;
+}
+export interface SnakeCaseSyncStatusSnapshot<TAttention = SyncAttentionItem> {
+    status: SyncStatus;
+    last_sync_at: string | null;
+    error: string | null;
+    attention: readonly TAttention[];
+    pending_count: number;
+    initial_pull_status: InitialPullStatus;
+    refresh_revision: number;
+    security_block: string | null;
+}
+/** Projects a status snapshot onto API-style snake_case field names. */
+export declare function toSnakeCaseSnapshot<TAttention>(snapshot: SyncStatusSnapshot<TAttention>): SnakeCaseSyncStatusSnapshot<TAttention>;
+/**
+ * Maps pull progress and snapshot delivery onto local-store readiness.
+ *
+ * A consumer that has not yet received the newest `refreshRevision` still reads
+ * stale data, so it stays `pulling` rather than claiming a settled empty state.
+ */
+export declare function deriveLocalStoreReadiness({ initialPullStatus, refreshRevision, deliveredRevision, hasData, }: LocalStoreReadinessInput): LocalStoreReadiness;
+/** Maps a snapshot onto the contract's initial-readiness vocabulary. */
+export declare function deriveInitialSyncState({ initialPullStatus, lastSyncAt, status, }: Pick<SyncStatusSnapshot, 'initialPullStatus' | 'lastSyncAt' | 'status'>): InitialSyncState;
+/**
+ * Observable sync status, with no React and no state library.
+ *
+ * Products subscribe directly, or adapt {@link SyncStatusStore.subscribe} and
+ * {@link SyncStatusStore.getSnapshot} to whatever their UI layer expects.
+ */
+export declare class SyncStatusStore<TAttention = SyncAttentionItem> {
+    private snapshot;
+    private readonly listeners;
+    getSnapshot(): SyncStatusSnapshot<TAttention>;
+    subscribe(listener: (snapshot: SyncStatusSnapshot<TAttention>) => void): () => void;
+    setSyncing(): void;
+    setIdle(lastSyncAt: string): void;
+    setAttention(items: readonly TAttention[], pendingCount: number): void;
+    setAuth(message: string): void;
+    setError(message: string, pendingCount?: number): void;
+    /** Restores persisted status on a cold start, before the first run. */
+    hydrate(lastSyncAt: string | null, items?: readonly TAttention[], pendingCount?: number): void;
+    reset(): void;
+    setSecurityBlock(message: string): void;
+    resumeAfterAuth(): void;
+    private set;
+}
+/** Write-only view a sync run uses to report progress. */
+export interface SyncStatusSink<TAttention = SyncAttentionItem> {
+    setSyncing(): void;
+    setIdle(lastSyncAt: string): void;
+    setAttention(items: readonly TAttention[], pendingCount: number): void;
+    setAuth(message: string): void;
+    setError(message: string, pendingCount?: number): void;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

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

package/dist/store.js

@@ -0,0 +1,156 @@
+function initialSnapshot() {
+    return {
+        status: 'idle',
+        lastSyncAt: null,
+        error: null,
+        attention: [],
+        pendingCount: 0,
+        initialPullStatus: 'uninitialized',
+        refreshRevision: 0,
+        securityBlock: null,
+    };
+}
+/** Projects a status snapshot onto API-style snake_case field names. */
+export function toSnakeCaseSnapshot(snapshot) {
+    return {
+        status: snapshot.status,
+        last_sync_at: snapshot.lastSyncAt,
+        error: snapshot.error,
+        attention: snapshot.attention,
+        pending_count: snapshot.pendingCount,
+        initial_pull_status: snapshot.initialPullStatus,
+        refresh_revision: snapshot.refreshRevision,
+        security_block: snapshot.securityBlock,
+    };
+}
+/**
+ * Maps pull progress and snapshot delivery onto local-store readiness.
+ *
+ * A consumer that has not yet received the newest `refreshRevision` still reads
+ * stale data, so it stays `pulling` rather than claiming a settled empty state.
+ */
+export function deriveLocalStoreReadiness({ initialPullStatus, refreshRevision, deliveredRevision, hasData, }) {
+    if (initialPullStatus === 'uninitialized')
+        return 'uninitialized';
+    if (initialPullStatus === 'pulling' || deliveredRevision !== refreshRevision)
+        return 'pulling';
+    return hasData ? 'hydrated-populated' : 'hydrated-empty';
+}
+/** Maps a snapshot onto the contract's initial-readiness vocabulary. */
+export function deriveInitialSyncState({ initialPullStatus, lastSyncAt, status, }) {
+    if (initialPullStatus === 'uninitialized')
+        return 'unknown';
+    if (initialPullStatus === 'pulling')
+        return 'syncing';
+    if (status === 'error' && lastSyncAt === null)
+        return 'offline-cached';
+    return 'settled';
+}
+function settledStatus(attentionCount, pendingCount) {
+    if (attentionCount > 0)
+        return 'attention';
+    return pendingCount > 0 ? 'pending' : 'idle';
+}
+/**
+ * Observable sync status, with no React and no state library.
+ *
+ * Products subscribe directly, or adapt {@link SyncStatusStore.subscribe} and
+ * {@link SyncStatusStore.getSnapshot} to whatever their UI layer expects.
+ */
+export class SyncStatusStore {
+    snapshot = initialSnapshot();
+    listeners = new Set();
+    getSnapshot() {
+        return this.snapshot;
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    setSyncing() {
+        this.set((state) => ({
+            status: 'syncing',
+            error: null,
+            initialPullStatus: state.lastSyncAt === null ? 'pulling' : 'settled',
+        }));
+    }
+    setIdle(lastSyncAt) {
+        this.set((state) => ({
+            status: 'idle',
+            lastSyncAt,
+            error: null,
+            attention: [],
+            pendingCount: 0,
+            initialPullStatus: 'settled',
+            refreshRevision: state.refreshRevision + 1,
+        }));
+    }
+    setAttention(items, pendingCount) {
+        this.set((state) => ({
+            status: items.length > 0 ? 'attention' : 'pending',
+            error: null,
+            attention: [...items],
+            pendingCount,
+            initialPullStatus: 'settled',
+            refreshRevision: state.refreshRevision + 1,
+        }));
+    }
+    setAuth(message) {
+        this.set((state) => ({
+            status: 'auth',
+            error: message,
+            initialPullStatus: 'settled',
+            refreshRevision: state.refreshRevision + 1,
+        }));
+    }
+    setError(message, pendingCount) {
+        this.set((state) => {
+            const nextPendingCount = pendingCount ?? state.pendingCount;
+            return {
+                status: state.attention.length > 0 ? 'attention' : nextPendingCount > 0 ? 'pending' : 'error',
+                error: message,
+                pendingCount: nextPendingCount,
+                initialPullStatus: 'settled',
+                refreshRevision: state.refreshRevision + 1,
+            };
+        });
+    }
+    /** Restores persisted status on a cold start, before the first run. */
+    hydrate(lastSyncAt, items = [], pendingCount = 0) {
+        this.set((state) => ({
+            status: settledStatus(items.length, pendingCount),
+            lastSyncAt,
+            error: null,
+            attention: [...items],
+            pendingCount,
+            initialPullStatus: lastSyncAt === null ? 'uninitialized' : 'settled',
+            refreshRevision: state.refreshRevision + 1,
+        }));
+    }
+    reset() {
+        this.set(() => initialSnapshot());
+    }
+    setSecurityBlock(message) {
+        this.set(() => ({
+            status: 'error',
+            error: message,
+            initialPullStatus: 'settled',
+            securityBlock: message,
+        }));
+    }
+    resumeAfterAuth() {
+        this.set((state) => ({
+            status: settledStatus(state.attention.length, state.pendingCount),
+            error: null,
+        }));
+    }
+    set(update) {
+        this.snapshot = { ...this.snapshot, ...update(this.snapshot) };
+        this.listeners.forEach((listener) => {
+            listener(this.snapshot);
+        });
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,80 @@
+/** Minimal `fetch` shape the transport depends on. */
+export interface SyncRequestInit {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+    signal?: AbortSignal;
+}
+export type SyncFetch = (input: string, init?: SyncRequestInit) => Promise<SyncFetchResponse>;
+/** A product API client's decoded request function. */
+export type SyncPrebuiltRequest = <T>(input: string, init?: SyncRequestInit) => Promise<T>;
+/** Minimal `Response` shape the transport depends on. */
+export interface SyncFetchResponse {
+    readonly ok: boolean;
+    readonly status: number;
+    text(): Promise<string>;
+}
+export interface SyncFetchTransportOptions {
+    /** Absolute base URL of the sync API, without a trailing slash. */
+    baseUrl: string;
+    fetch: SyncFetch;
+    /** Resolves the headers that authenticate a request, per attempt. */
+    authHeaders: () => Promise<Record<string, string>> | Record<string, string>;
+    /**
+     * Header carrying the local-data partition the caller expects to talk to.
+     * Defaults to `X-Partition-Id`.
+     */
+    partitionHeader?: string;
+    /**
+     * Error code the server returns when the caller's partition no longer
+     * exists. Defaults to `partition_identity_mismatch`.
+     */
+    partitionMismatchCode?: string;
+}
+export interface SyncPrebuiltRequestTransportOptions {
+    /**
+     * Sends and decodes a request through a product API client. The function owns
+     * base-URL resolution, authentication recovery, and failure classification.
+     */
+    request: SyncPrebuiltRequest;
+    /** Defaults to `X-Partition-Id`. */
+    partitionHeader?: string;
+}
+export type SyncTransportOptions = SyncFetchTransportOptions | SyncPrebuiltRequestTransportOptions;
+export interface SyncRequestOptions {
+    method?: string;
+    query?: Record<string, string>;
+    body?: unknown;
+    /** Partition the caller expects; sent as the partition header when present. */
+    partitionId?: string | null;
+    signal?: AbortSignal;
+}
+/**
+ * Sync request plumbing for either a raw fetch or a product API client.
+ *
+ * Endpoint paths, request bodies, and response shapes stay product-defined:
+ * callers name the path and the response type on every call.
+ */
+export declare class SyncTransport {
+    private readonly options;
+    private readonly baseUrl;
+    private readonly partitionHeader;
+    private readonly partitionMismatchCode;
+    constructor(options: SyncTransportOptions);
+    /**
+     * Sends one sync request and decodes its JSON response.
+     *
+     * The fetch-backed variant decodes JSON and maps failures to
+     * {@link SyncTransportError}. The prebuilt-request variant delegates response
+     * decoding and failure policy to that request function.
+     */
+    request<T>(path: string, options?: SyncRequestOptions): Promise<T>;
+    private send;
+    private init;
+    private readBody;
+    private decode;
+    private url;
+    private path;
+    private asTransportError;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAEA,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE9F,uDAAuD;AACvD,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAE3F,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACxC,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,qEAAqE;IACrE,WAAW,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5E;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,mCAAmC;IAClD;;;OAGG;IACH,OAAO,EAAE,mBAAmB,CAAC;IAC7B,oCAAoC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,oBAAoB,GAAG,yBAAyB,GAAG,mCAAmC,CAAC;AAEnG,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAwBD;;;;;GAKG;AACH,qBAAa,aAAa;IAKZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAgB;gBAEzB,OAAO,EAAE,oBAAoB;IAS1D;;;;;;OAMG;IACG,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,CAAC,CAAC;YAY9D,IAAI;IAalB,OAAO,CAAC,IAAI;YAwBE,QAAQ;IAQtB,OAAO,CAAC,MAAM;IAWd,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,gBAAgB;CAczB"}

package/dist/transport.js

@@ -0,0 +1,131 @@
+import { SyncAuthError, SyncPartitionMismatchError, SyncTransportError } from './error.js';
+const DEFAULT_PARTITION_HEADER = 'X-Partition-Id';
+const DEFAULT_PARTITION_MISMATCH_CODE = 'partition_identity_mismatch';
+const RETRYABLE_STATUSES = new Set([408, 429]);
+function isRetryableStatus(status) {
+    return RETRYABLE_STATUSES.has(status) || status >= 500;
+}
+function parseErrorBody(body) {
+    try {
+        const decoded = JSON.parse(body);
+        return typeof decoded === 'object' && decoded !== null ? decoded : {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Sync request plumbing for either a raw fetch or a product API client.
+ *
+ * Endpoint paths, request bodies, and response shapes stay product-defined:
+ * callers name the path and the response type on every call.
+ */
+export class SyncTransport {
+    options;
+    baseUrl;
+    partitionHeader;
+    partitionMismatchCode;
+    constructor(options) {
+        this.options = options;
+        this.baseUrl = 'fetch' in options ? options.baseUrl.replace(/\/+$/, '') : null;
+        this.partitionHeader = options.partitionHeader ?? DEFAULT_PARTITION_HEADER;
+        this.partitionMismatchCode =
+            'fetch' in options
+                ? (options.partitionMismatchCode ?? DEFAULT_PARTITION_MISMATCH_CODE)
+                : null;
+    }
+    /**
+     * Sends one sync request and decodes its JSON response.
+     *
+     * The fetch-backed variant decodes JSON and maps failures to
+     * {@link SyncTransportError}. The prebuilt-request variant delegates response
+     * decoding and failure policy to that request function.
+     */
+    async request(path, options = {}) {
+        if ('request' in this.options) {
+            return this.options.request(this.path(path, options.query), this.init(options, {}));
+        }
+        const response = await this.send(path, options);
+        const body = await this.readBody(response);
+        if (!response.ok) {
+            throw this.asTransportError(response.status, body);
+        }
+        return this.decode(body);
+    }
+    async send(path, options) {
+        if (!('fetch' in this.options)) {
+            throw new Error('unreachable request-backed transport');
+        }
+        const headers = { ...(await this.options.authHeaders()) };
+        const init = this.init(options, headers);
+        try {
+            return await this.options.fetch(this.url(path, options.query), init);
+        }
+        catch (error) {
+            throw new SyncTransportError(errorMessage(error), true, error);
+        }
+    }
+    init(options, initialHeaders) {
+        const headers = { ...initialHeaders };
+        if (options.body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+        }
+        if (options.partitionId != null) {
+            headers[this.partitionHeader] = options.partitionId;
+        }
+        const init = { headers };
+        if (options.method !== undefined) {
+            init.method = options.method;
+        }
+        if (options.body !== undefined) {
+            init.body = JSON.stringify(options.body);
+        }
+        if (options.signal !== undefined) {
+            init.signal = options.signal;
+        }
+        return init;
+    }
+    async readBody(response) {
+        try {
+            return await response.text();
+        }
+        catch (error) {
+            throw new SyncTransportError(errorMessage(error), true, error);
+        }
+    }
+    decode(body) {
+        if (body.length === 0) {
+            return undefined;
+        }
+        try {
+            return JSON.parse(body);
+        }
+        catch (error) {
+            throw new SyncTransportError('sync response was not valid JSON', false, error);
+        }
+    }
+    url(path, query) {
+        return `${this.baseUrl ?? ''}${this.path(path, query)}`;
+    }
+    path(path, query) {
+        const suffix = query ? `?${new URLSearchParams(query).toString()}` : '';
+        return `${path}${suffix}`;
+    }
+    asTransportError(status, body) {
+        const decoded = parseErrorBody(body);
+        const message = typeof decoded.message === 'string' && decoded.message.length > 0
+            ? decoded.message
+            : `sync request failed with status ${String(status)}`;
+        if (this.partitionMismatchCode !== null && decoded.code === this.partitionMismatchCode) {
+            return new SyncPartitionMismatchError(message);
+        }
+        if (status === 401) {
+            return new SyncAuthError(message);
+        }
+        return new SyncTransportError(message, isRetryableStatus(status));
+    }
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA6D3F,MAAM,wBAAwB,GAAG,gBAAgB,CAAC;AAClD,MAAM,+BAA+B,GAAG,6BAA6B,CAAC;AACtE,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAO/C,SAAS,iBAAiB,CAAC,MAAc;IACvC,OAAO,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,GAAG,CAAC;AACzD,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,CAAC;QACH,MAAM,OAAO,GAA2B,IAAI,CAAC,KAAK,CAAC,IAAI,CAA2B,CAAC;QACnF,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IAKK;IAJZ,OAAO,CAAgB;IACvB,eAAe,CAAS;IACxB,qBAAqB,CAAgB;IAEtD,YAA6B,OAA6B;QAA7B,YAAO,GAAP,OAAO,CAAsB;QACxD,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/E,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,wBAAwB,CAAC;QAC3E,IAAI,CAAC,qBAAqB;YACxB,OAAO,IAAI,OAAO;gBAChB,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,IAAI,+BAA+B,CAAC;gBACpE,CAAC,CAAC,IAAI,CAAC;IACb,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAI,IAAY,EAAE,UAA8B,EAAE;QAC7D,IAAI,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QACzF,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAM,CAAC;IAChC,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,OAA2B;QAC1D,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,OAAO,GAA2B,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QAClF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;QACvE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAEO,IAAI,CACV,OAA2B,EAC3B,cAAsC;QAEtC,MAAM,OAAO,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC;QACtC,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;QAC/C,CAAC;QACD,IAAI,OAAO,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;QACtD,CAAC;QACD,MAAM,IAAI,GAAoB,EAAE,OAAO,EAAE,CAAC;QAC1C,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/B,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,QAA2B;QAChD,IAAI,CAAC;YACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,IAAY;QACzB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAAC,kCAAkC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAEO,GAAG,CAAC,IAAY,EAAE,KAAyC;QACjE,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;IAC1D,CAAC;IAEO,IAAI,CAAC,IAAY,EAAE,KAAyC;QAClE,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,OAAO,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC;IAC5B,CAAC;IAEO,gBAAgB,CAAC,MAAc,EAAE,IAAY;QACnD,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,OAAO,GACX,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YAC/D,CAAC,CAAC,OAAO,CAAC,OAAO;YACjB,CAAC,CAAC,mCAAmC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1D,IAAI,IAAI,CAAC,qBAAqB,KAAK,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,qBAAqB,EAAE,CAAC;YACvF,OAAO,IAAI,0BAA0B,CAAC,OAAO,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,IAAI,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;IACpE,CAAC;CACF;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@baukit/sync-client",
+  "version": "0.1.0",
+  "description": "Client-side scheduling, transport, status reporting, and ordering for offline-capable sync loops.",
+  "license": "MIT",
+  "author": "Patrick Koss",
+  "homepage": "https://github.com/PatrickKoss/baukit#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PatrickKoss/baukit.git",
+    "directory": "typescript/packages/sync-client"
+  },
+  "bugs": {
+    "url": "https://github.com/PatrickKoss/baukit/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./expo": {
+      "types": "./dist/expo.d.ts",
+      "import": "./dist/expo.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "expo-network": "57.0.1",
+    "react-native": "0.86.2",
+    "typescript": "6.0.3",
+    "vitest": "4.1.10"
+  },
+  "peerDependencies": {
+    "expo-network": "^57.0.1",
+    "react-native": "^0.86.2"
+  },
+  "peerDependenciesMeta": {
+    "expo-network": {
+      "optional": true
+    },
+    "react-native": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "tsc -p tsconfig.exports.json && vitest run --config ../../vitest.config.ts",
+    "lint": "eslint src --max-warnings=0",
+    "format:check": "prettier --check src type-tests package.json tsconfig*.json"
+  }
+}