@syncular/server 0.0.6-96 → 0.1.1

package/dist/commit-integrity.js

@@ -0,0 +1,260 @@
+import { sha256Hex, } from '@syncular/core';
+import { sql } from 'kysely';
+import { coerceIsoString, coerceNumber, parseJsonValue, } from './dialect/helpers.js';
+export const SYNCULAR_COMMIT_DIGEST_VERSION = 'syncular-commit-digest-v1';
+export const SYNCULAR_COMMIT_CHAIN_ROOT_VERSION = 'syncular-commit-chain-root-v1';
+export const SYNCULAR_WIRE_COMMIT_DIGEST_VERSION = 'syncular-wire-commit-digest-v1';
+export const SYNCULAR_WIRE_COMMIT_CHAIN_ROOT_VERSION = 'syncular-wire-commit-chain-root-v1';
+export const SYNCULAR_COMMIT_GENESIS_ROOT = '0'.repeat(64);
+export async function finalizeCommitIntegrity(args) {
+    const commit = await readPersistedCommit(args);
+    const changes = await readPersistedChanges(args);
+    const commitDigest = await sha256Hex(canonicalStringify({
+        version: SYNCULAR_COMMIT_DIGEST_VERSION,
+        partitionId: commit.partition_id,
+        commitSeq: coerceNumber(commit.commit_seq) ?? args.commitSeq,
+        actorId: commit.actor_id,
+        clientId: commit.client_id,
+        clientCommitId: commit.client_commit_id,
+        createdAt: coerceIsoString(commit.created_at),
+        meta: parseJsonValue(commit.meta),
+        result: parseJsonValue(commit.result_json),
+        changeCount: coerceNumber(commit.change_count) ?? changes.length,
+        affectedTables: args.dialect.dbToArray(commit.affected_tables).sort(),
+        changes: changes.map((change) => ({
+            table: change.table,
+            rowId: change.row_id,
+            op: change.op,
+            row: parseJsonValue(change.row_json),
+            rowVersion: coerceNumber(change.row_version),
+            scopes: parseJsonValue(change.scopes),
+        })),
+    }));
+    const previousChainRoot = await readPreviousChainRoot(args);
+    const commitChainRoot = await sha256Hex(canonicalStringify({
+        version: SYNCULAR_COMMIT_CHAIN_ROOT_VERSION,
+        partitionId: commit.partition_id,
+        commitSeq: coerceNumber(commit.commit_seq) ?? args.commitSeq,
+        previousChainRoot,
+        commitDigest,
+    }));
+    await sql `
+    UPDATE sync_commits
+    SET
+      commit_digest = ${commitDigest},
+      commit_chain_root = ${commitChainRoot}
+    WHERE partition_id = ${args.partitionId}
+      AND commit_seq = ${args.commitSeq}
+  `.execute(args.db);
+    return {
+        commitDigest,
+        commitChainRoot,
+        previousChainRoot,
+    };
+}
+export async function createWireSubscriptionIntegrity(args) {
+    if (args.commits.length === 0) {
+        return undefined;
+    }
+    const firstPreviousChainRoot = args.previousRoot || SYNCULAR_COMMIT_GENESIS_ROOT;
+    let previousChainRoot = args.previousRoot || SYNCULAR_COMMIT_GENESIS_ROOT;
+    for (const commit of args.commits) {
+        const commitDigest = await wireCommitDigest({
+            partitionId: args.partitionId,
+            subscriptionId: args.subscriptionId,
+            commit,
+        });
+        const commitChainRoot = await wireCommitChainRootFromDigest({
+            partitionId: args.partitionId,
+            subscriptionId: args.subscriptionId,
+            commitSeq: commit.commitSeq,
+            previousChainRoot,
+            commitDigest,
+        });
+        previousChainRoot = commitChainRoot;
+    }
+    const lastCommit = args.commits[args.commits.length - 1];
+    return {
+        partitionId: args.partitionId,
+        previousChainRoot: firstPreviousChainRoot,
+        commitChainRoot: previousChainRoot,
+        commitSeq: lastCommit.commitSeq,
+    };
+}
+export async function wireCommitDigest(args) {
+    return sha256Hex(wireCommitDigestPayload(args));
+}
+export async function wireCommitChainRootFromDigest(args) {
+    return sha256Hex(wireCommitChainRootPayload(args));
+}
+async function readPersistedCommit(args) {
+    const result = await sql `
+    SELECT
+      commit_seq,
+      partition_id,
+      actor_id,
+      client_id,
+      client_commit_id,
+      created_at,
+      meta,
+      result_json,
+      change_count,
+      affected_tables
+    FROM sync_commits
+    WHERE partition_id = ${args.partitionId}
+      AND commit_seq = ${args.commitSeq}
+    LIMIT 1
+  `.execute(args.db);
+    const row = result.rows[0];
+    if (!row) {
+        throw new Error(`Cannot finalize missing sync commit ${args.partitionId}:${args.commitSeq}`);
+    }
+    return row;
+}
+async function readPersistedChanges(args) {
+    const result = await sql `
+    SELECT
+      "table",
+      row_id,
+      op,
+      row_json,
+      row_version,
+      scopes
+    FROM sync_changes
+    WHERE partition_id = ${args.partitionId}
+      AND commit_seq = ${args.commitSeq}
+    ORDER BY change_id ASC
+  `.execute(args.db);
+    return result.rows;
+}
+async function readPreviousChainRoot(args) {
+    const result = await sql `
+    SELECT commit_chain_root
+    FROM sync_commits
+    WHERE partition_id = ${args.partitionId}
+      AND commit_seq < ${args.commitSeq}
+      AND commit_chain_root IS NOT NULL
+    ORDER BY commit_seq DESC
+    LIMIT 1
+  `.execute(args.db);
+    return result.rows[0]?.commit_chain_root ?? SYNCULAR_COMMIT_GENESIS_ROOT;
+}
+function canonicalStringify(value) {
+    const out = [];
+    appendCanonicalJson(out, value);
+    return out.join('');
+}
+function wireCommitDigestPayload(args) {
+    const out = [];
+    out.push('{"actorId":');
+    appendCanonicalJson(out, args.commit.actorId);
+    out.push(',"changes":[');
+    args.commit.changes.forEach((change, index) => {
+        if (index > 0)
+            out.push(',');
+        out.push('{"op":');
+        appendCanonicalJson(out, change.op);
+        out.push(',"row":');
+        appendCanonicalJson(out, parseJsonValue(change.row_json));
+        out.push(',"rowId":');
+        appendCanonicalJson(out, change.row_id);
+        out.push(',"rowVersion":');
+        appendCanonicalJson(out, change.row_version === null || change.row_version === undefined
+            ? null
+            : coerceNumber(change.row_version));
+        out.push(',"scopes":');
+        appendCanonicalJson(out, parseJsonValue(change.scopes));
+        out.push(',"table":');
+        appendCanonicalJson(out, change.table);
+        out.push('}');
+    });
+    out.push('],"commitSeq":');
+    appendCanonicalJson(out, args.commit.commitSeq);
+    out.push(',"createdAt":');
+    appendCanonicalJson(out, args.commit.createdAt);
+    out.push(',"partitionId":');
+    appendCanonicalJson(out, args.partitionId);
+    out.push(',"subscriptionId":');
+    appendCanonicalJson(out, args.subscriptionId);
+    out.push(',"version":');
+    appendCanonicalJson(out, SYNCULAR_WIRE_COMMIT_DIGEST_VERSION);
+    out.push('}');
+    return out.join('');
+}
+function wireCommitChainRootPayload(args) {
+    const out = [];
+    out.push('{"commitDigest":');
+    appendCanonicalJson(out, args.commitDigest);
+    out.push(',"commitSeq":');
+    appendCanonicalJson(out, args.commitSeq);
+    out.push(',"partitionId":');
+    appendCanonicalJson(out, args.partitionId);
+    out.push(',"previousChainRoot":');
+    appendCanonicalJson(out, args.previousChainRoot);
+    out.push(',"subscriptionId":');
+    appendCanonicalJson(out, args.subscriptionId);
+    out.push(',"version":');
+    appendCanonicalJson(out, SYNCULAR_WIRE_COMMIT_CHAIN_ROOT_VERSION);
+    out.push('}');
+    return out.join('');
+}
+function appendCanonicalJson(out, value) {
+    if (value === null || value === undefined) {
+        out.push('null');
+        return;
+    }
+    if (typeof value === 'string' || typeof value === 'boolean') {
+        out.push(JSON.stringify(value));
+        return;
+    }
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value)) {
+            throw new Error('Cannot canonicalize non-finite number');
+        }
+        out.push(JSON.stringify(value));
+        return;
+    }
+    if (typeof value === 'bigint') {
+        out.push(JSON.stringify(value.toString()));
+        return;
+    }
+    if (value instanceof Date) {
+        out.push(JSON.stringify(value.toISOString()));
+        return;
+    }
+    if (value instanceof Uint8Array) {
+        out.push('{"bytesHex":');
+        out.push(JSON.stringify(Array.from(value)
+            .map((byte) => byte.toString(16).padStart(2, '0'))
+            .join('')));
+        out.push('}');
+        return;
+    }
+    if (Array.isArray(value)) {
+        out.push('[');
+        for (let index = 0; index < value.length; index += 1) {
+            if (index > 0)
+                out.push(',');
+            appendCanonicalJson(out, value[index]);
+        }
+        out.push(']');
+        return;
+    }
+    if (typeof value === 'object') {
+        const object = value;
+        out.push('{');
+        Object.keys(object)
+            .sort()
+            .forEach((key, index) => {
+            if (index > 0)
+                out.push(',');
+            out.push(JSON.stringify(key));
+            out.push(':');
+            appendCanonicalJson(out, object[key]);
+        });
+        out.push('}');
+        return;
+    }
+    out.push(JSON.stringify(String(value)));
+}
+//# sourceMappingURL=commit-integrity.js.map

package/dist/commit-integrity.js.map

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

package/dist/compaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"compaction.js","sourceRoot":"","sources":["../src/compaction.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,EAAkB,EAClB,IAA6D,EAC5C;IACjB,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACpE,IAAI,gBAAgB,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACpC,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAAA,CAC9D;AAOD,MAAM,gBAAgB,GAAG,IAAI,OAAO,EAAwB,CAAC;AAE7D,SAAS,eAAe,CAAC,EAAU,EAAgB;IACjD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC1C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,MAAM,OAAO,GAAiB;QAC5B,eAAe,EAAE,CAAC;QAClB,eAAe,EAAE,IAAI;KACtB,CAAC;IACF,gBAAgB,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,OAAO,CAAC;AAAA,CAChB;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,EAAkB,EAClB,IAIC,EACgB;IACjB,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,GAAG,GAAG,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,aAAa;QAAE,OAAO,CAAC,CAAC;IAE/D,IAAI,KAAK,CAAC,eAAe;QAAE,OAAO,KAAK,CAAC,eAAe,CAAC;IAExD,KAAK,CAAC,eAAe,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE;gBACvC,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAC;YACH,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACnC,OAAO,OAAO,CAAC;QACjB,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC;QAC/B,CAAC;IAAA,CACF,CAAC,EAAE,CAAC;IAEL,OAAO,KAAK,CAAC,eAAe,CAAC;AAAA,CAC9B"}
+{"version":3,"file":"compaction.js","sourceRoot":"","sources":["../src/compaction.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,EAAkB,EAClB,IAA6D;IAE7D,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACpE,IAAI,gBAAgB,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACpC,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAC/D,CAAC;AAOD,MAAM,gBAAgB,GAAG,IAAI,OAAO,EAAwB,CAAC;AAE7D,SAAS,eAAe,CAAC,EAAU;IACjC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC1C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,MAAM,OAAO,GAAiB;QAC5B,eAAe,EAAE,CAAC;QAClB,eAAe,EAAE,IAAI;KACtB,CAAC;IACF,gBAAgB,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,EAAkB,EAClB,IAIC;IAED,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,GAAG,GAAG,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,aAAa;QAAE,OAAO,CAAC,CAAC;IAE/D,IAAI,KAAK,CAAC,eAAe;QAAE,OAAO,KAAK,CAAC,eAAe,CAAC;IAExD,KAAK,CAAC,eAAe,GAAG,CAAC,KAAK,IAAI,EAAE;QAClC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE;gBACvC,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAC;YACH,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACnC,OAAO,OAAO,CAAC;QACjB,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC;QAC/B,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,OAAO,KAAK,CAAC,eAAe,CAAC;AAC/B,CAAC"}

package/dist/crdt-yjs/index.d.ts

@@ -0,0 +1,99 @@
+import { type SyncChange, type SyncCrdtStateVectorHint, type SyncServerPlugin } from '@syncular/server';
+export declare const YJS_PAYLOAD_KEY = "__yjs";
+export type YjsFieldKind = 'text' | 'xml-fragment' | 'prosemirror';
+export interface YjsServerFieldRule {
+    table: string;
+    field: string;
+    /**
+     * Column that stores canonical serialized Yjs state.
+     * Example: "content_yjs_state"
+     */
+    stateColumn: string;
+    /**
+     * Container key inside the Yjs document. Defaults to `field`.
+     */
+    containerKey?: string;
+    /**
+     * Snapshot row id column. Defaults to `id`.
+     */
+    rowIdField?: string;
+    /**
+     * CRDT container type.
+     */
+    kind?: YjsFieldKind;
+}
+export interface YjsServerUpdateEnvelope {
+    updateId: string;
+    updateBase64: string;
+    requiresStateVectorBase64?: string;
+}
+export type YjsServerUpdateInput = YjsServerUpdateEnvelope | readonly YjsServerUpdateEnvelope[];
+export interface YjsServerPayloadEnvelope {
+    [field: string]: YjsServerUpdateInput;
+}
+export interface BuildYjsTextUpdateArgs {
+    previousStateBase64?: string | Uint8Array | null;
+    nextText: string;
+    containerKey?: string;
+    updateId?: string;
+}
+export interface BuildYjsTextUpdateResult {
+    update: YjsServerUpdateEnvelope;
+    nextStateBase64: string;
+    nextText: string;
+}
+export interface ApplyYjsTextUpdatesArgs {
+    previousStateBase64?: string | Uint8Array | null;
+    updates: readonly YjsServerUpdateEnvelope[];
+    containerKey?: string;
+}
+export interface ApplyYjsTextUpdatesResult {
+    nextStateBase64: string;
+    text: string;
+}
+export interface CreateYjsServerModuleOptions {
+    name?: string;
+    rules: readonly YjsServerFieldRule[];
+    envelopeKey?: string;
+    /**
+     * Throw when envelope payload references fields without matching rules.
+     * @default true
+     */
+    strict?: boolean;
+    /**
+     * Remove the Yjs envelope key from processed payload/rows.
+     * @default true
+     */
+    stripEnvelope?: boolean;
+}
+export interface CreateYjsServerPushPluginOptions extends CreateYjsServerModuleOptions {
+    priority?: number;
+}
+export interface YjsServerApplyPayloadArgs {
+    table: string;
+    rowId: string;
+    payload: Record<string, unknown>;
+    existingRow?: Record<string, unknown> | null;
+}
+export interface YjsServerMaterializeRowArgs {
+    table: string;
+    row: Record<string, unknown>;
+}
+export type YjsServerStateVectorHint = SyncCrdtStateVectorHint;
+export interface YjsServerTransformPullChangesArgs {
+    table: string;
+    changes: readonly SyncChange[];
+    crdtStateVectors: readonly YjsServerStateVectorHint[];
+}
+export interface YjsServerModule {
+    name: string;
+    rules: readonly YjsServerFieldRule[];
+    envelopeKey: string;
+    applyPayload(args: YjsServerApplyPayloadArgs): Promise<Record<string, unknown>>;
+    materializeRow(args: YjsServerMaterializeRowArgs): Promise<Record<string, unknown>>;
+    transformPullChanges(args: YjsServerTransformPullChangesArgs): Promise<readonly SyncChange[]>;
+}
+export declare function buildYjsTextUpdate(args: BuildYjsTextUpdateArgs): Promise<BuildYjsTextUpdateResult>;
+export declare function createYjsServerModule(options: CreateYjsServerModuleOptions): YjsServerModule;
+export declare function createYjsServerPushPlugin(options: CreateYjsServerPushPluginOptions): SyncServerPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/crdt-yjs/index.d.ts.map

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