@syncular/relay 0.0.1-60

package/dist/server-role/index.js

@@ -0,0 +1,198 @@
+/**
+ * @syncular/relay - Server Role
+ *
+ * Hono routes for serving local clients.
+ */
+import { createSyncTimer, logSyncEvent, ScopeValuesSchema, SyncBootstrapStateSchema, SyncPullRequestSchema, SyncPushRequestSchema, } from '@syncular/core';
+import { recordClientCursor } from '@syncular/server';
+import { Hono } from 'hono';
+import { relayPull } from './pull';
+import { relayPushCommit } from './push';
+function clampInt(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Create Hono routes for relay server-role endpoints.
+ *
+ * Provides:
+ * - POST /pull (commit stream + optional bootstrap snapshots)
+ * - POST /push (commit ingestion)
+ * - GET /realtime (WebSocket wake-up notifications)
+ */
+export function createRelayRoutes(options) {
+    const routes = new Hono();
+    const maxOperationsPerPush = options.maxOperationsPerPush ?? 200;
+    const maxSubscriptionsPerPull = options.maxSubscriptionsPerPull ?? 200;
+    const maxPullLimitCommits = options.maxPullLimitCommits ?? 100;
+    const authenticate = options.authenticate ?? (async () => ({ actorId: 'anonymous' }));
+    // POST /pull
+    routes.post('/pull', async (c) => {
+        const auth = await authenticate(c);
+        if (!auth)
+            return c.json({ error: 'UNAUTHENTICATED' }, 401);
+        const rawBody = await c.req.json();
+        const timer = createSyncTimer();
+        if (!isRecord(rawBody)) {
+            return c.json({ error: 'INVALID_REQUEST', message: 'Invalid JSON body' }, 400);
+        }
+        if (!rawBody.clientId || typeof rawBody.clientId !== 'string') {
+            return c.json({ error: 'INVALID_REQUEST', message: 'clientId is required' }, 400);
+        }
+        if (!Array.isArray(rawBody.subscriptions)) {
+            return c.json({
+                error: 'INVALID_REQUEST',
+                message: 'subscriptions array is required',
+            }, 400);
+        }
+        if (rawBody.subscriptions.length > maxSubscriptionsPerPull) {
+            return c.json({
+                error: 'INVALID_REQUEST',
+                message: `Too many subscriptions (max ${maxSubscriptionsPerPull})`,
+            }, 400);
+        }
+        const subscriptions = [];
+        for (const subValue of rawBody.subscriptions) {
+            if (!isRecord(subValue)) {
+                return c.json({ error: 'INVALID_REQUEST', message: 'Invalid subscription entry' }, 400);
+            }
+            const id = typeof subValue.id === 'string' ? subValue.id : null;
+            const shape = typeof subValue.shape === 'string' ? subValue.shape : null;
+            if (!id || !shape) {
+                return c.json({
+                    error: 'INVALID_REQUEST',
+                    message: 'Subscription id/shape required',
+                }, 400);
+            }
+            const scopesParsed = ScopeValuesSchema.safeParse(subValue.scopes);
+            if (!scopesParsed.success) {
+                return c.json({ error: 'INVALID_REQUEST', message: 'Invalid subscription scopes' }, 400);
+            }
+            const rawParams = subValue.params;
+            if (rawParams !== undefined && !isRecord(rawParams)) {
+                return c.json({ error: 'INVALID_REQUEST', message: 'Invalid subscription params' }, 400);
+            }
+            const cursor = typeof subValue.cursor === 'number' && Number.isInteger(subValue.cursor)
+                ? Math.max(-1, subValue.cursor)
+                : -1;
+            const rawBootstrapState = subValue.bootstrapState;
+            const bootstrapState = rawBootstrapState === undefined || rawBootstrapState === null
+                ? null
+                : (() => {
+                    const parsed = SyncBootstrapStateSchema.safeParse(rawBootstrapState);
+                    if (!parsed.success)
+                        return null;
+                    return parsed.data;
+                })();
+            if (rawBootstrapState !== undefined &&
+                rawBootstrapState !== null &&
+                bootstrapState === null) {
+                return c.json({
+                    error: 'INVALID_REQUEST',
+                    message: 'Invalid subscription bootstrapState',
+                }, 400);
+            }
+            subscriptions.push({
+                id,
+                shape,
+                scopes: scopesParsed.data,
+                params: rawParams,
+                cursor,
+                bootstrapState,
+            });
+        }
+        const request = {
+            clientId: rawBody.clientId,
+            limitCommits: clampInt(typeof rawBody.limitCommits === 'number' &&
+                Number.isInteger(rawBody.limitCommits)
+                ? rawBody.limitCommits
+                : 50, 1, maxPullLimitCommits),
+            limitSnapshotRows: clampInt(typeof rawBody.limitSnapshotRows === 'number' &&
+                Number.isInteger(rawBody.limitSnapshotRows)
+                ? rawBody.limitSnapshotRows
+                : 1000, 1, 5000),
+            maxSnapshotPages: clampInt(typeof rawBody.maxSnapshotPages === 'number' &&
+                Number.isInteger(rawBody.maxSnapshotPages)
+                ? rawBody.maxSnapshotPages
+                : 1, 1, 10),
+            dedupeRows: typeof rawBody.dedupeRows === 'boolean'
+                ? rawBody.dedupeRows
+                : undefined,
+            subscriptions,
+        };
+        const validatedRequest = SyncPullRequestSchema.safeParse(request);
+        if (!validatedRequest.success) {
+            return c.json({ error: 'INVALID_REQUEST', message: 'Invalid pull request' }, 400);
+        }
+        const pullResult = await relayPull({
+            db: options.db,
+            dialect: options.dialect,
+            shapes: options.shapes,
+            actorId: auth.actorId,
+            request: validatedRequest.data,
+        });
+        await recordClientCursor(options.db, options.dialect, {
+            clientId: validatedRequest.data.clientId,
+            actorId: auth.actorId,
+            cursor: pullResult.clientCursor,
+            effectiveScopes: pullResult.effectiveScopes,
+        });
+        // Notify realtime about updated scope values
+        const tables = Object.keys(pullResult.effectiveScopes);
+        options.realtime.updateClientTables(request.clientId, tables);
+        logSyncEvent({
+            event: 'relay.pull',
+            userId: auth.actorId,
+            durationMs: timer(),
+            subscriptionCount: pullResult.response.subscriptions.length,
+            clientCursor: pullResult.clientCursor,
+        });
+        return c.json(pullResult.response);
+    });
+    // POST /push
+    routes.post('/push', async (c) => {
+        const auth = await authenticate(c);
+        if (!auth)
+            return c.json({ error: 'UNAUTHENTICATED' }, 401);
+        const rawBody = await c.req.json();
+        const parsed = SyncPushRequestSchema.safeParse(rawBody);
+        if (!parsed.success) {
+            return c.json({ error: 'INVALID_REQUEST', message: 'Invalid push request' }, 400);
+        }
+        const body = parsed.data;
+        if (body.operations.length > maxOperationsPerPush) {
+            return c.json({
+                error: 'TOO_MANY_OPERATIONS',
+                message: `Maximum ${maxOperationsPerPush} operations per push`,
+            }, 400);
+        }
+        const timer = createSyncTimer();
+        const pushed = await relayPushCommit({
+            db: options.db,
+            dialect: options.dialect,
+            shapes: options.shapes,
+            actorId: auth.actorId,
+            request: body,
+        });
+        logSyncEvent({
+            event: 'relay.push',
+            userId: auth.actorId,
+            durationMs: timer(),
+            operationCount: body.operations.length,
+            status: pushed.response.status,
+            commitSeq: pushed.response.commitSeq,
+        });
+        // Notify about the commit
+        if (pushed.response.ok === true &&
+            pushed.response.status === 'applied' &&
+            typeof pushed.response.commitSeq === 'number' &&
+            pushed.affectedTables.length > 0) {
+            await options.onCommit?.(pushed.response.commitSeq, pushed.affectedTables);
+        }
+        return c.json(pushed.response);
+    });
+    return routes;
+}
+//# sourceMappingURL=index.js.map

package/dist/server-role/index.js.map

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

package/dist/server-role/pull.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @syncular/relay - Server Role Pull Handler
+ *
+ * Handles pulls from local clients, serving changes stored locally
+ * on the relay.
+ */
+import type { SyncPullRequest } from '@syncular/core';
+import type { ServerSyncDialect, TableRegistry } from '@syncular/server';
+import { type PullResult } from '@syncular/server';
+import type { Kysely } from 'kysely';
+import type { RelayDatabase } from '../schema';
+/**
+ * Pull commits for a local client from the relay.
+ *
+ * This wraps the standard server pull with relay-specific logic:
+ * - Restricts scopes to those the relay subscribes to
+ */
+export declare function relayPull<DB extends RelayDatabase = RelayDatabase>(args: {
+    db: Kysely<DB>;
+    dialect: ServerSyncDialect;
+    shapes: TableRegistry<DB>;
+    actorId: string;
+    request: SyncPullRequest;
+}): Promise<PullResult>;
+//# sourceMappingURL=pull.d.ts.map

package/dist/server-role/pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../src/server-role/pull.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,EAAE,SAAS,aAAa,GAAG,aAAa,EACxC,IAAI,EAAE;IACN,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,eAAe,CAAC;CAC1B,GAAG,OAAO,CAAC,UAAU,CAAC,CAStB"}

package/dist/server-role/pull.js

@@ -0,0 +1,24 @@
+/**
+ * @syncular/relay - Server Role Pull Handler
+ *
+ * Handles pulls from local clients, serving changes stored locally
+ * on the relay.
+ */
+import { pull } from '@syncular/server';
+/**
+ * Pull commits for a local client from the relay.
+ *
+ * This wraps the standard server pull with relay-specific logic:
+ * - Restricts scopes to those the relay subscribes to
+ */
+export async function relayPull(args) {
+    // Use the standard pull - scope authorization is handled by shapes
+    return pull({
+        db: args.db,
+        dialect: args.dialect,
+        shapes: args.shapes,
+        actorId: args.actorId,
+        request: args.request,
+    });
+}
+//# sourceMappingURL=pull.js.map

package/dist/server-role/pull.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.js","sourceRoot":"","sources":["../../src/server-role/pull.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAmB,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAIzD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAE7B,IAMD,EAAuB;IACtB,mEAAmE;IACnE,OAAO,IAAI,CAAC;QACV,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAC;AAAA,CACJ"}

package/dist/server-role/push.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @syncular/relay - Server Role Push Handler
+ *
+ * Handles pushes from local clients, storing them locally and
+ * queueing them for forwarding to the main server.
+ */
+import type { SyncPushRequest } from '@syncular/core';
+import type { ServerSyncDialect, TableRegistry } from '@syncular/server';
+import { type PushCommitResult } from '@syncular/server';
+import { type Kysely } from 'kysely';
+import type { RelayDatabase } from '../schema';
+/**
+ * Push a commit from a local client to the relay.
+ *
+ * This wraps the standard server pushCommit with relay-specific logic:
+ * 1. Validates that operations are within the relay's scope
+ * 2. Stores the commit locally
+ * 3. Enqueues the commit for forwarding to the main server
+ */
+export declare function relayPushCommit<DB extends RelayDatabase = RelayDatabase>(args: {
+    db: Kysely<DB>;
+    dialect: ServerSyncDialect;
+    shapes: TableRegistry<DB>;
+    actorId: string;
+    request: SyncPushRequest;
+}): Promise<PushCommitResult>;
+//# sourceMappingURL=push.d.ts.map

package/dist/server-role/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../src/server-role/push.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,KAAK,gBAAgB,EAAc,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,KAAK,MAAM,EAAO,MAAM,QAAQ,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAY/C;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,EAAE,SAAS,aAAa,GAAG,aAAa,EACxC,IAAI,EAAE;IACN,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,eAAe,CAAC;CAC1B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4B5B"}

package/dist/server-role/push.js

@@ -0,0 +1,98 @@
+/**
+ * @syncular/relay - Server Role Push Handler
+ *
+ * Handles pushes from local clients, storing them locally and
+ * queueing them for forwarding to the main server.
+ */
+import { pushCommit } from '@syncular/server';
+import { sql } from 'kysely';
+function randomId() {
+    if (typeof crypto !== 'undefined' &&
+        typeof crypto.randomUUID === 'function') {
+        return crypto.randomUUID();
+    }
+    return `${Date.now()}-${Math.random().toString(16).slice(2)}`;
+}
+/**
+ * Push a commit from a local client to the relay.
+ *
+ * This wraps the standard server pushCommit with relay-specific logic:
+ * 1. Validates that operations are within the relay's scope
+ * 2. Stores the commit locally
+ * 3. Enqueues the commit for forwarding to the main server
+ */
+export async function relayPushCommit(args) {
+    const { request } = args;
+    // Use the standard pushCommit - scope authorization is handled by shapes
+    const result = await pushCommit({
+        db: args.db,
+        dialect: args.dialect,
+        shapes: args.shapes,
+        actorId: args.actorId,
+        request,
+    });
+    // If the commit was applied, enqueue it for forwarding to main server
+    if (result.response.ok === true &&
+        result.response.status === 'applied' &&
+        typeof result.response.commitSeq === 'number') {
+        await enqueueForForwarding(args.db, {
+            localCommitSeq: result.response.commitSeq,
+            clientId: request.clientId,
+            clientCommitId: request.clientCommitId,
+            operations: request.operations,
+            schemaVersion: request.schemaVersion,
+        });
+    }
+    return result;
+}
+/**
+ * Enqueue a locally-committed change for forwarding to the main server.
+ */
+async function enqueueForForwarding(db, args) {
+    const now = Date.now();
+    await sql `
+    insert into ${sql.table('relay_forward_outbox')} (
+      id,
+      local_commit_seq,
+      client_id,
+      client_commit_id,
+      operations_json,
+      schema_version,
+      status,
+      main_commit_seq,
+      error,
+      last_response_json,
+      created_at,
+      updated_at,
+      attempt_count
+    )
+    values (
+      ${randomId()},
+      ${args.localCommitSeq},
+      ${args.clientId},
+      ${args.clientCommitId},
+      ${JSON.stringify(args.operations)},
+      ${args.schemaVersion},
+      'pending',
+      ${null},
+      ${null},
+      ${null},
+      ${now},
+      ${now},
+      ${0}
+    )
+  `.execute(db);
+    // Also create a sequence map entry for this commit
+    await sql `
+    insert into ${sql.table('relay_sequence_map')} (
+      local_commit_seq,
+      main_commit_seq,
+      status,
+      created_at,
+      updated_at
+    )
+    values (${args.localCommitSeq}, ${null}, 'pending', ${now}, ${now})
+    on conflict (local_commit_seq) do nothing
+  `.execute(db);
+}
+//# sourceMappingURL=push.js.map

package/dist/server-role/push.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.js","sourceRoot":"","sources":["../../src/server-role/push.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAyB,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAe,GAAG,EAAE,MAAM,QAAQ,CAAC;AAG1C,SAAS,QAAQ,GAAW;IAC1B,IACE,OAAO,MAAM,KAAK,WAAW;QAC7B,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,EACvC,CAAC;QACD,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAAA,CAC/D;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAEnC,IAMD,EAA6B;IAC5B,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEzB,yEAAyE;IACzE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;QAC9B,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO;KACR,CAAC,CAAC;IAEH,sEAAsE;IACtE,IACE,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,IAAI;QAC3B,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS;QACpC,OAAO,MAAM,CAAC,QAAQ,CAAC,SAAS,KAAK,QAAQ,EAC7C,CAAC;QACD,MAAM,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE;YAClC,cAAc,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS;YACzC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;SACrC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAAA,CACf;AAED;;GAEG;AACH,KAAK,UAAU,oBAAoB,CACjC,EAAc,EACd,IAMC,EACc;IACf,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,MAAM,GAAG,CAAA;kBACO,GAAG,CAAC,KAAK,CAAC,sBAAsB,CAAC;;;;;;;;;;;;;;;;QAgB3C,QAAQ,EAAE;QACV,IAAI,CAAC,cAAc;QACnB,IAAI,CAAC,QAAQ;QACb,IAAI,CAAC,cAAc;QACnB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC;QAC/B,IAAI,CAAC,aAAa;;QAElB,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,GAAG;QACH,GAAG;QACH,CAAC;;GAEN,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAEd,mDAAmD;IACnD,MAAM,GAAG,CAAA;kBACO,GAAG,CAAC,KAAK,CAAC,oBAAoB,CAAC;;;;;;;cAOnC,IAAI,CAAC,cAAc,KAAK,IAAI,gBAAgB,GAAG,KAAK,GAAG;;GAElE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAAA,CACf"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@syncular/relay",
+  "version": "0.0.1-60",
+  "description": "Edge relay for Syncular distributed sync",
+  "license": "MIT",
+  "author": "Benjamin Kniffler",
+  "homepage": "https://syncular.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/syncular/syncular.git",
+    "directory": "packages/relay"
+  },
+  "bugs": {
+    "url": "https://github.com/syncular/syncular/issues"
+  },
+  "keywords": [
+    "sync",
+    "offline-first",
+    "realtime",
+    "database",
+    "typescript",
+    "relay",
+    "edge"
+  ],
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "scripts": {
+    "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/server": "0.0.1"
+  },
+  "peerDependencies": {
+    "hono": "^4.0.0",
+    "kysely": "^0.28.0"
+  },
+  "devDependencies": {
+    "@syncular/config": "0.0.0",
+    "@syncular/server-dialect-sqlite": "0.0.1",
+    "kysely": "*"
+  },
+  "files": [
+    "dist",
+    "src"
+  ]
+}