@syncular/client 0.0.1-60

package/dist/sync-loop.js

@@ -0,0 +1,249 @@
+/**
+ * @syncular/client - High-level sync loops
+ *
+ * Helpers that run push/pull repeatedly until the client is caught up.
+ */
+import { upsertConflictsForRejectedCommit } from './conflicts';
+import { getNextSendableOutboxCommit, markOutboxCommitAcked, markOutboxCommitFailed, markOutboxCommitPending, } from './outbox';
+import { applyPullResponse, buildPullRequest, syncPullOnce, } from './pull-engine';
+import { syncPushOnce } from './push-engine';
+async function syncPushUntilSettled(db, transport, options) {
+    const maxCommits = Math.max(1, Math.min(1000, options.maxCommits ?? 20));
+    let pushedCount = 0;
+    for (let i = 0; i < maxCommits; i++) {
+        const res = await syncPushOnce(db, transport, {
+            clientId: options.clientId,
+            actorId: options.actorId,
+            plugins: options.plugins,
+        });
+        if (!res.pushed)
+            break;
+        pushedCount += 1;
+    }
+    return { pushedCount };
+}
+function hasPushViaWs(transport) {
+    return 'pushViaWs' in transport && typeof transport.pushViaWs === 'function';
+}
+function needsAnotherPull(res) {
+    for (const sub of res.subscriptions ?? []) {
+        if (sub.status !== 'active')
+            continue;
+        if (sub.bootstrap)
+            return true;
+        if ((sub.commits?.length ?? 0) > 0)
+            return true;
+    }
+    return false;
+}
+function mergePullResponse(targetBySubId, res) {
+    for (const sub of res.subscriptions ?? []) {
+        const prev = targetBySubId.get(sub.id);
+        if (!prev) {
+            const merged = {
+                ...sub,
+                commits: [...(sub.commits ?? [])],
+                snapshots: [...(sub.snapshots ?? [])],
+            };
+            targetBySubId.set(sub.id, merged);
+            continue;
+        }
+        const merged = {
+            ...prev,
+            ...sub,
+            commits: [...(prev.commits ?? []), ...(sub.commits ?? [])],
+            snapshots: [...(prev.snapshots ?? []), ...(sub.snapshots ?? [])],
+        };
+        targetBySubId.set(sub.id, merged);
+    }
+}
+async function syncPullUntilSettled(db, transport, shapes, options) {
+    const maxRounds = Math.max(1, Math.min(1000, options.maxRounds ?? 20));
+    const aggregatedBySubId = new Map();
+    let rounds = 0;
+    for (let i = 0; i < maxRounds; i++) {
+        rounds += 1;
+        const res = await syncPullOnce(db, transport, shapes, options);
+        mergePullResponse(aggregatedBySubId, res);
+        if (!needsAnotherPull(res))
+            break;
+    }
+    return {
+        // Return an aggregate response so callers can see what was applied across
+        // all pull rounds (the last round is often empty by design).
+        response: {
+            ok: true,
+            subscriptions: Array.from(aggregatedBySubId.values()),
+        },
+        rounds,
+    };
+}
+/**
+ * Sync once using a WS-first push strategy for the first outbox commit.
+ *
+ * - If transport supports `pushViaWs` and the commit succeeds over WS, this call
+ *   sends only an HTTP pull request.
+ * - Otherwise it falls back to combined HTTP push+pull.
+ *
+ * Remaining outbox commits are then settled via `syncPushUntilSettled`.
+ */
+async function syncOnceCombined(db, transport, shapes, options) {
+    const pullOpts = {
+        clientId: options.clientId,
+        actorId: options.actorId,
+        plugins: options.plugins,
+        subscriptions: options.subscriptions,
+        limitCommits: options.limitCommits,
+        limitSnapshotRows: options.limitSnapshotRows,
+        maxSnapshotPages: options.maxSnapshotPages,
+        dedupeRows: options.dedupeRows,
+        stateId: options.stateId,
+    };
+    // Build pull request (reads subscription state)
+    const pullState = await buildPullRequest(db, pullOpts);
+    const { clientId } = pullState.request;
+    // Grab at most one outbox commit
+    const outbox = await getNextSendableOutboxCommit(db);
+    const plugins = options.plugins ?? [];
+    const ctx = {
+        actorId: options.actorId ?? 'unknown',
+        clientId,
+    };
+    // Build push request, running beforePush plugins
+    let pushRequest;
+    if (outbox) {
+        pushRequest = {
+            clientId,
+            clientCommitId: outbox.client_commit_id,
+            operations: outbox.operations,
+            schemaVersion: outbox.schema_version,
+        };
+        for (const plugin of plugins) {
+            if (!plugin.beforePush)
+                continue;
+            pushRequest = await plugin.beforePush(ctx, pushRequest);
+        }
+    }
+    // Try WS push first for the first outbox commit (if realtime transport supports it).
+    // Fall back to HTTP push in the combined request when WS is unavailable or fails.
+    let wsPushResponse = null;
+    if (pushRequest && hasPushViaWs(transport)) {
+        try {
+            wsPushResponse = await transport.pushViaWs(pushRequest);
+        }
+        catch {
+            wsPushResponse = null;
+        }
+    }
+    const combined = await transport.sync({
+        clientId,
+        ...(pushRequest && !wsPushResponse
+            ? {
+                push: {
+                    clientCommitId: pushRequest.clientCommitId,
+                    operations: pushRequest.operations,
+                    schemaVersion: pushRequest.schemaVersion,
+                },
+            }
+            : {}),
+        pull: {
+            limitCommits: pullState.request.limitCommits,
+            limitSnapshotRows: pullState.request.limitSnapshotRows,
+            maxSnapshotPages: pullState.request.maxSnapshotPages,
+            dedupeRows: pullState.request.dedupeRows,
+            subscriptions: pullState.request.subscriptions,
+        },
+    });
+    // Process push response
+    let pushedCommits = 0;
+    if (outbox && pushRequest) {
+        let pushRes = wsPushResponse ?? combined.push;
+        if (!pushRes) {
+            await markOutboxCommitPending(db, {
+                id: outbox.id,
+                error: 'MISSING_PUSH_RESPONSE',
+            });
+            throw new Error('Server returned no push response');
+        }
+        // Run afterPush plugins
+        for (const plugin of plugins) {
+            if (!plugin.afterPush)
+                continue;
+            pushRes = await plugin.afterPush(ctx, {
+                request: pushRequest,
+                response: pushRes,
+            });
+        }
+        const responseJson = JSON.stringify(pushRes);
+        if (pushRes.status === 'applied' || pushRes.status === 'cached') {
+            await markOutboxCommitAcked(db, {
+                id: outbox.id,
+                commitSeq: pushRes.commitSeq ?? null,
+                responseJson,
+            });
+            pushedCommits = 1;
+        }
+        else {
+            // Check if all errors are retriable
+            const errorResults = pushRes.results.filter((r) => r.status === 'error');
+            const allRetriable = errorResults.length > 0 &&
+                errorResults.every((r) => r.retriable === true);
+            if (allRetriable) {
+                await markOutboxCommitPending(db, {
+                    id: outbox.id,
+                    error: 'Retriable',
+                    responseJson,
+                });
+                pushedCommits = 1;
+            }
+            else {
+                await upsertConflictsForRejectedCommit(db, {
+                    outboxCommitId: outbox.id,
+                    clientCommitId: outbox.client_commit_id,
+                    response: pushRes,
+                });
+                await markOutboxCommitFailed(db, {
+                    id: outbox.id,
+                    error: 'REJECTED',
+                    responseJson,
+                });
+                pushedCommits = 1;
+            }
+        }
+        // Settle remaining outbox commits
+        const remaining = await syncPushUntilSettled(db, transport, {
+            clientId: options.clientId,
+            actorId: options.actorId,
+            plugins: options.plugins,
+            maxCommits: (options.maxPushCommits ?? 20) - 1,
+        });
+        pushedCommits += remaining.pushedCount;
+    }
+    // Process pull response
+    let pullResponse = { ok: true, subscriptions: [] };
+    let pullRounds = 0;
+    if (combined.pull) {
+        pullResponse = await applyPullResponse(db, transport, shapes, pullOpts, pullState, combined.pull);
+        pullRounds = 1;
+        // Continue pulling if more data
+        if (needsAnotherPull(pullResponse)) {
+            const aggregatedBySubId = new Map();
+            mergePullResponse(aggregatedBySubId, pullResponse);
+            const more = await syncPullUntilSettled(db, transport, shapes, {
+                ...pullOpts,
+                maxRounds: (options.maxPullRounds ?? 20) - 1,
+            });
+            pullRounds += more.rounds;
+            mergePullResponse(aggregatedBySubId, more.response);
+            pullResponse = {
+                ok: true,
+                subscriptions: Array.from(aggregatedBySubId.values()),
+            };
+        }
+    }
+    return { pushedCommits, pullRounds, pullResponse };
+}
+export async function syncOnce(db, transport, shapes, options) {
+    return syncOnceCombined(db, transport, shapes, options);
+}
+//# sourceMappingURL=sync-loop.js.map

package/dist/sync-loop.js.map

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

package/dist/utils/id.d.ts

@@ -0,0 +1,8 @@
+/**
+ * ID generation utilities
+ */
+/**
+ * Generate a random UUID v4
+ */
+export declare function randomUUID(): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/utils/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAYnC"}

package/dist/utils/id.js

@@ -0,0 +1,19 @@
+/**
+ * ID generation utilities
+ */
+/**
+ * Generate a random UUID v4
+ */
+export function randomUUID() {
+    // Use crypto.randomUUID if available (modern browsers, Node, Bun)
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    // Fallback implementation
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+//# sourceMappingURL=id.js.map

package/dist/utils/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,UAAU,GAAW;IACnC,kEAAkE;IAClE,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACvD,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;IAED,0BAA0B;IAC1B,OAAO,sCAAsC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;QACpE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAC1C,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAAA,CACvB,CAAC,CAAC;AAAA,CACJ"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@syncular/client",
+  "version": "0.0.1-60",
+  "description": "Client-side sync engine with offline-first support, outbox, and conflict resolution",
+  "license": "MIT",
+  "author": "Benjamin Kniffler",
+  "homepage": "https://syncular.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/syncular/syncular.git",
+    "directory": "packages/client"
+  },
+  "bugs": {
+    "url": "https://github.com/syncular/syncular/issues"
+  },
+  "keywords": [
+    "sync",
+    "offline-first",
+    "realtime",
+    "database",
+    "typescript"
+  ],
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "scripts": {
+    "test": "bun test --pass-with-no-tests",
+    "tsgo": "tsgo --noEmit",
+    "build": "rm -rf dist && tsgo",
+    "release": "bun pm pack --destination . && npm publish ./*.tgz --tag latest && rm -f ./*.tgz"
+  },
+  "dependencies": {
+    "@syncular/core": "0.0.1",
+    "@syncular/transport-http": "0.0.1"
+  },
+  "peerDependencies": {
+    "kysely": "*"
+  },
+  "devDependencies": {
+    "@syncular/config": "0.0.0",
+    "kysely": "*"
+  }
+}

package/src/blobs/index.ts

@@ -0,0 +1,7 @@
+/**
+ * @syncular/client - Blob storage exports
+ */
+
+export * from './manager';
+export * from './migrate';
+export * from './types';