@softwareseva/sync 0.1.0 → 0.2.0

package/dist/client/index.d.ts

@@ -0,0 +1,82 @@
+/** @softwareseva/sync/client — offline-first push/pull against a syncRouter, backed by RxDB for local durability. Mirrors kashi_sync's Dart engine: an outbox of ops and a pull cursor, both owned by the engine inside the app's RxDB database. */
+import type { RxDatabase } from "rxdb";
+import type { ApiClient } from "@softwareseva/core/client";
+export type LocalSyncEntity = {
+    /** Server rows -> local rows. Server wins; the engine skips rows whose id has a pending outbox op. */
+    upsert: (rows: Array<Record<string, unknown>>) => Promise<void>;
+    delete: (ids: string[]) => Promise<void>;
+    clear: () => Promise<void>;
+};
+export type SyncPhase = "idle" | "syncing" | "offline" | "failed";
+export type SyncStatus = {
+    phase: SyncPhase;
+    pending: number;
+    needsAttention: number;
+    lastSyncAt: string | null;
+    message?: string;
+};
+export type SyncEngineOptions = {
+    /** The app's own RxDB database; the engine adds its `kashi_outbox` and `kashi_sync_state` collections to it. */
+    db: RxDatabase;
+    /** The same client used for the rest of the app; `/sync/push` and `/sync/pull` are appended to its base path. */
+    api: ApiClient;
+    entities: Record<string, LocalSyncEntity>;
+    /** How often to sync while started (default 5 minutes). */
+    intervalMs?: number;
+    /** Debounce after `enqueue()` before syncing (default 400ms). */
+    debounceMs?: number;
+    maxAttempts?: number;
+    pageSize?: number;
+};
+/** `sync()`: push due ops in batches of 50, then pull pages until `hasMore` is false. Concurrent calls share one run. */
+export declare class SyncEngine {
+    private readonly db;
+    private readonly api;
+    private readonly entities;
+    private readonly intervalMs;
+    private readonly debounceMs;
+    private readonly maxAttempts;
+    private readonly pageSize;
+    private outbox;
+    private cursor;
+    private readonly ready;
+    private timer;
+    private debounceTimer;
+    private inFlight;
+    private readonly listeners;
+    private status;
+    constructor(options: SyncEngineOptions);
+    private init;
+    /** `{subscribe}` shape so it plugs straight into `useSyncExternalStore`. */
+    get statusStream(): {
+        subscribe: (fn: () => void) => () => void;
+    };
+    getStatus: () => SyncStatus;
+    private setStatus;
+    private refreshStatus;
+    /** Write the local row first, then enqueue the op — in the same transaction where your storage supports one. */
+    enqueue(type: string, payload: unknown, target: {
+        entity: string;
+        entityId: string;
+    }): Promise<void>;
+    /** Sync now, every `intervalMs`, and whenever the browser comes back online. */
+    start(): void;
+    stop(): void;
+    private onOnline;
+    sync(): Promise<void>;
+    private run;
+    private push;
+    private pull;
+    needsAttention(): Promise<Array<{
+        opId: string;
+        type: string;
+        entity: string;
+        entityId: string;
+        attempts: number;
+    }>>;
+    retry(opId: string): Promise<void>;
+    discard(opId: string): Promise<void>;
+    /** Wipe local synced data and the outbox/cursor. Call on sign-out before another user signs in on this device. */
+    clearAll(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

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

package/dist/client/index.js

@@ -0,0 +1,230 @@
+const outboxSchema = {
+    version: 0,
+    primaryKey: "opId",
+    type: "object",
+    properties: {
+        opId: { type: "string", maxLength: 64 },
+        type: { type: "string" },
+        payload: {},
+        entity: { type: "string" },
+        entityId: { type: "string" },
+        status: { type: "string" },
+        attempts: { type: "number" },
+        nextAttemptAt: { type: "string" },
+        createdAt: { type: "string" },
+    },
+    required: ["opId", "type", "payload", "entity", "entityId", "status", "attempts", "nextAttemptAt", "createdAt"],
+};
+const cursorSchema = {
+    version: 0,
+    primaryKey: "id",
+    type: "object",
+    properties: { id: { type: "string", maxLength: 16 }, since: { type: "number" } },
+    required: ["id", "since"],
+};
+const CURSOR_ID = "cursor";
+/** `sync()`: push due ops in batches of 50, then pull pages until `hasMore` is false. Concurrent calls share one run. */
+export class SyncEngine {
+    db;
+    api;
+    entities;
+    intervalMs;
+    debounceMs;
+    maxAttempts;
+    pageSize;
+    outbox = null;
+    cursor = null;
+    ready;
+    timer = null;
+    debounceTimer = null;
+    inFlight = null;
+    listeners = new Set();
+    status = { phase: "idle", pending: 0, needsAttention: 0, lastSyncAt: null };
+    constructor(options) {
+        this.db = options.db;
+        this.api = options.api;
+        this.entities = options.entities;
+        this.intervalMs = options.intervalMs ?? 5 * 60_000;
+        this.debounceMs = options.debounceMs ?? 400;
+        this.maxAttempts = options.maxAttempts ?? 8;
+        this.pageSize = options.pageSize ?? 500;
+        this.ready = this.init();
+    }
+    async init() {
+        const existing = this.db.collections;
+        const toAdd = {};
+        if (!existing.kashi_outbox)
+            toAdd.kashi_outbox = { schema: outboxSchema };
+        if (!existing.kashi_sync_state)
+            toAdd.kashi_sync_state = { schema: cursorSchema };
+        if (Object.keys(toAdd).length)
+            await this.db.addCollections(toAdd);
+        this.outbox = this.db.collections.kashi_outbox;
+        this.cursor = this.db.collections.kashi_sync_state;
+        await this.refreshStatus();
+    }
+    /** `{subscribe}` shape so it plugs straight into `useSyncExternalStore`. */
+    get statusStream() {
+        return { subscribe: (fn) => { this.listeners.add(fn); return () => this.listeners.delete(fn); } };
+    }
+    getStatus = () => this.status;
+    setStatus(patch) {
+        this.status = { ...this.status, ...patch };
+        for (const listener of this.listeners)
+            listener();
+    }
+    async refreshStatus() {
+        const pending = await this.outbox.count({ selector: { status: "pending" } }).exec();
+        const needsAttention = await this.outbox.count({ selector: { status: "needs-attention" } }).exec();
+        this.setStatus({ pending, needsAttention });
+    }
+    /** Write the local row first, then enqueue the op — in the same transaction where your storage supports one. */
+    async enqueue(type, payload, target) {
+        await this.ready;
+        await this.outbox.insert({
+            opId: newOpId(),
+            type,
+            payload,
+            entity: target.entity,
+            entityId: target.entityId,
+            status: "pending",
+            attempts: 0,
+            nextAttemptAt: new Date(0).toISOString(),
+            createdAt: new Date().toISOString(),
+        });
+        await this.refreshStatus();
+        if (this.debounceTimer)
+            clearTimeout(this.debounceTimer);
+        this.debounceTimer = setTimeout(() => void this.sync(), this.debounceMs);
+    }
+    /** Sync now, every `intervalMs`, and whenever the browser comes back online. */
+    start() {
+        void this.sync();
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = setInterval(() => void this.sync(), this.intervalMs);
+        if (typeof window !== "undefined")
+            window.addEventListener("online", this.onOnline);
+    }
+    stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = null;
+        if (typeof window !== "undefined")
+            window.removeEventListener("online", this.onOnline);
+    }
+    onOnline = () => void this.sync();
+    sync() {
+        this.inFlight ??= this.run().finally(() => { this.inFlight = null; });
+        return this.inFlight;
+    }
+    async run() {
+        await this.ready;
+        if (typeof navigator !== "undefined" && navigator.onLine === false) {
+            this.setStatus({ phase: "offline" });
+            return;
+        }
+        this.setStatus({ phase: "syncing" });
+        try {
+            await this.push();
+            await this.pull();
+            this.setStatus({ phase: "idle", lastSyncAt: new Date().toISOString() });
+        }
+        catch (error) {
+            this.setStatus({ phase: "failed", message: error instanceof Error ? error.message : "Sync failed." });
+        }
+        await this.refreshStatus();
+    }
+    async push() {
+        for (;;) {
+            const now = new Date().toISOString();
+            const due = await this.outbox.find({ selector: { status: "pending", nextAttemptAt: { $lte: now } }, limit: 50 }).exec();
+            if (!due.length)
+                return;
+            const ops = due.map((d) => ({ opId: d.opId, type: d.type, payload: d.payload }));
+            const { results } = await this.api.post("/sync/push", { ops });
+            for (const result of results) {
+                const doc = due.find((d) => d.opId === result.opId);
+                if (!doc)
+                    continue;
+                if (result.status === "applied" || result.status === "replayed") {
+                    await doc.remove();
+                    continue;
+                }
+                const attempts = doc.attempts + 1;
+                if (result.error?.retryable && attempts < this.maxAttempts) {
+                    const delay = Math.min(5_000 * 2 ** attempts, 5 * 60_000);
+                    await doc.incrementalPatch({ attempts, nextAttemptAt: new Date(Date.now() + delay).toISOString() });
+                }
+                else {
+                    await doc.incrementalPatch({ attempts, status: "needs-attention" });
+                }
+            }
+            if (due.length < 50)
+                return;
+        }
+    }
+    async pull() {
+        for (;;) {
+            const cursorDoc = await this.cursor.findOne(CURSOR_ID).exec();
+            const since = cursorDoc?.since ?? 0;
+            const page = await this.api.get(`/sync/pull?since=${since}&limit=${this.pageSize}`);
+            if (page.reset) {
+                for (const entity of Object.values(this.entities))
+                    await entity.clear();
+                await this.cursor.upsert({ id: CURSOR_ID, since: 0 });
+                continue;
+            }
+            const pendingOps = await this.outbox.find({ selector: { status: "pending" } }).exec();
+            const pendingKeys = new Set(pendingOps.map((d) => `${d.entity}:${d.entityId}`));
+            for (const [entityName, change] of Object.entries(page.changes)) {
+                const entity = this.entities[entityName];
+                if (!entity)
+                    continue;
+                const upserts = change.upserts.filter((row) => !pendingKeys.has(`${entityName}:${row.id}`));
+                const deletes = change.deletes.filter((id) => !pendingKeys.has(`${entityName}:${id}`));
+                if (upserts.length)
+                    await entity.upsert(upserts);
+                if (deletes.length)
+                    await entity.delete(deletes);
+            }
+            await this.cursor.upsert({ id: CURSOR_ID, since: page.next });
+            if (!page.hasMore)
+                return;
+        }
+    }
+    async needsAttention() {
+        await this.ready;
+        const docs = await this.outbox.find({ selector: { status: "needs-attention" } }).exec();
+        return docs.map((d) => ({ opId: d.opId, type: d.type, entity: d.entity, entityId: d.entityId, attempts: d.attempts }));
+    }
+    async retry(opId) {
+        await this.ready;
+        const doc = await this.outbox.findOne(opId).exec();
+        if (doc)
+            await doc.incrementalPatch({ status: "pending", attempts: 0, nextAttemptAt: new Date(0).toISOString() });
+        await this.refreshStatus();
+        void this.sync();
+    }
+    async discard(opId) {
+        await this.ready;
+        const doc = await this.outbox.findOne(opId).exec();
+        if (doc)
+            await doc.remove();
+        await this.refreshStatus();
+    }
+    /** Wipe local synced data and the outbox/cursor. Call on sign-out before another user signs in on this device. */
+    async clearAll() {
+        await this.ready;
+        this.stop();
+        for (const entity of Object.values(this.entities))
+            await entity.clear();
+        await this.outbox.find().remove();
+        await this.cursor.find().remove();
+        this.setStatus({ phase: "idle", pending: 0, needsAttention: 0, lastSyncAt: null });
+    }
+}
+function newOpId() {
+    return typeof crypto !== "undefined" && crypto.randomUUID ? crypto.randomUUID() : `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+}
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

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

package/dist/react/index.d.ts

@@ -0,0 +1,21 @@
+import type { RxCollection } from "rxdb";
+import type { SyncEngine, SyncStatus } from "../client/index";
+export type SyncedCollectionOptions<T extends {
+    id: string;
+}> = {
+    /** Unique id for this collection within the app, e.g. "notes". */
+    id: string;
+    /** Op type prefix; upserts send `${entity}.upsert`, deletes send `${entity}.delete`. */
+    entity: string;
+    rxCollection: RxCollection<T>;
+    engine: SyncEngine;
+    /** Build the op payload sent to the server for an insert/update (default: the row itself). */
+    toUpsertPayload?: (row: T) => unknown;
+};
+/** Local-first: `collection.insert/update/delete` write to RxDB immediately (optimistic, durable) and enqueue the matching sync op; the live RxDB query keeps every other read of the collection current, including rows pulled in from the server. */
+export declare function createSyncedCollection<T extends {
+    id: string;
+}>(options: SyncedCollectionOptions<T>): import("@tanstack/db").Collection<T, string | number, import("@tanstack/db").UtilsRecord, never, T> & import("@tanstack/db").NonSingleResult;
+/** Re-render whenever the engine's phase, pending count or needs-attention count changes. Feed to a status badge. */
+export declare function useSyncStatus(engine: SyncEngine): SyncStatus;
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE9D,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,IAAI;IAC9D,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,wFAAwF;IACxF,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,EAAE,UAAU,CAAC;IACnB,8FAA8F;IAC9F,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC;CACvC,CAAC;AAEF,uPAAuP;AACvP,wBAAgB,sBAAsB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,gJA2CnG;AAED,qHAAqH;AACrH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAE5D"}

package/dist/react/index.js

@@ -0,0 +1,56 @@
+/** @softwareseva/sync/react — a TanStack DB collection whose durable source is an RxDB collection, and a status hook for SyncEngine. Reads are live (RxDB's own reactive query drives the collection); writes go through RxDB and enqueue an op on the SyncEngine in the same call. */
+import { useSyncExternalStore } from "react";
+import { createCollection } from "@tanstack/db";
+/** Local-first: `collection.insert/update/delete` write to RxDB immediately (optimistic, durable) and enqueue the matching sync op; the live RxDB query keeps every other read of the collection current, including rows pulled in from the server. */
+export function createSyncedCollection(options) {
+    const { id, entity, rxCollection, engine, toUpsertPayload = (row) => row } = options;
+    return createCollection({
+        id,
+        getKey: (row) => row.id,
+        sync: {
+            sync: ({ begin, write, commit, markReady, truncate }) => {
+                let ready = false;
+                // Full-refresh on every RxDB emission: truncate then re-insert, so this never has to reconcile against what the collection already holds.
+                const subscription = rxCollection.find().$.subscribe((docs) => {
+                    begin();
+                    truncate();
+                    for (const doc of docs)
+                        write({ type: "insert", value: doc.toJSON() });
+                    commit();
+                    if (!ready) {
+                        markReady();
+                        ready = true;
+                    }
+                });
+                return () => subscription.unsubscribe();
+            },
+        },
+        onInsert: async ({ transaction }) => {
+            for (const mutation of transaction.mutations) {
+                const row = mutation.modified;
+                await rxCollection.upsert(row);
+                await engine.enqueue(`${entity}.upsert`, toUpsertPayload(row), { entity, entityId: row.id });
+            }
+        },
+        onUpdate: async ({ transaction }) => {
+            for (const mutation of transaction.mutations) {
+                const row = mutation.modified;
+                await rxCollection.upsert(row);
+                await engine.enqueue(`${entity}.upsert`, toUpsertPayload(row), { entity, entityId: row.id });
+            }
+        },
+        onDelete: async ({ transaction }) => {
+            for (const mutation of transaction.mutations) {
+                const row = mutation.original;
+                const doc = await rxCollection.findOne(row.id).exec();
+                await doc?.remove();
+                await engine.enqueue(`${entity}.delete`, { id: row.id }, { entity, entityId: row.id });
+            }
+        },
+    });
+}
+/** Re-render whenever the engine's phase, pending count or needs-attention count changes. Feed to a status badge. */
+export function useSyncStatus(engine) {
+    return useSyncExternalStore(engine.statusStream.subscribe, engine.getStatus, engine.getStatus);
+}
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softwareseva/sync",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Offline-first sync for Hono on Cloudflare Workers + D1: idempotent batched push of client operations with replay, and a change log with a monotonic cursor for pulling upserts and deletes per scope. Pairs with the kashi_sync Flutter package.",
   "license": "MIT",
   "repository": {
@@ -21,18 +21,54 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    },
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@softwareseva/core": "^0.1.0"
+    "@softwareseva/core": "^1.0.0"
   },
   "peerDependencies": {
     "hono": "^4.13.0",
-    "zod": "^4.0.0"
+    "zod": "^4.0.0",
+    "rxdb": "^17.0.0",
+    "rxjs": "^7.8.0",
+    "@tanstack/db": "^0.9.0",
+    "@tanstack/react-db": "^0.4.0",
+    "react": "^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "rxdb": {
+      "optional": true
+    },
+    "rxjs": {
+      "optional": true
+    },
+    "@tanstack/db": {
+      "optional": true
+    },
+    "@tanstack/react-db": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@cloudflare/workers-types": "^5.0.0",
     "hono": "^4.13.9",
+    "rxdb": "^17.0.0",
+    "rxjs": "^7.8.0",
+    "@tanstack/db": "^0.9.0",
+    "@tanstack/react-db": "^0.4.0",
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
     "typescript": "^5.9.0",
     "vitest": "^4.1.0",
     "zod": "^4.6.0"