@syncular/client-plugin-yjs 0.0.0 → 0.0.6-159

package/README.md

@@ -1,4 +1,4 @@
-# @syncular/client-plugin-crdt-yjs
+# @syncular/client-plugin-yjs
 
 Yjs-first CRDT plugin for Syncular client integration.
 
@@ -45,7 +45,7 @@ The plugin converts this to:
 ## Example
 
 ```ts
-import { createYjsClientPlugin } from '@syncular/client-plugin-crdt-yjs';
+import { createYjsClientPlugin } from '@syncular/client-plugin-yjs';
 
 const yjs = createYjsClientPlugin({
   rules: [

package/dist/index.d.ts

@@ -0,0 +1,88 @@
+import { type SyncClientPlugin } from '@syncular/client';
+export declare const YJS_PAYLOAD_KEY = "__yjs";
+export type YjsFieldKind = 'text' | 'xml-fragment' | 'prosemirror';
+export interface YjsClientFieldRule {
+    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 YjsClientUpdateEnvelope {
+    updateId: string;
+    updateBase64: string;
+}
+export type YjsClientUpdateInput = YjsClientUpdateEnvelope | readonly YjsClientUpdateEnvelope[];
+export interface YjsClientPayloadEnvelope {
+    [field: string]: YjsClientUpdateInput;
+}
+export interface BuildYjsTextUpdateArgs {
+    previousStateBase64?: string | Uint8Array | null;
+    nextText: string;
+    containerKey?: string;
+    updateId?: string;
+}
+export interface BuildYjsTextUpdateResult {
+    update: YjsClientUpdateEnvelope;
+    nextStateBase64: string;
+    nextText: string;
+}
+export interface ApplyYjsTextUpdatesArgs {
+    previousStateBase64?: string | Uint8Array | null;
+    updates: readonly YjsClientUpdateEnvelope[];
+    containerKey?: string;
+}
+export interface ApplyYjsTextUpdatesResult {
+    nextStateBase64: string;
+    text: string;
+}
+export interface CreateYjsClientPluginOptions {
+    name?: string;
+    rules: readonly YjsClientFieldRule[];
+    envelopeKey?: string;
+    priority?: number;
+    /**
+     * Maximum cached row-field Yjs states to keep in memory.
+     * Prevents unbounded growth in long-lived sessions.
+     * @default 10_000
+     */
+    maxTrackedRows?: number;
+    /**
+     * Throw when envelope payload references fields without matching rules.
+     * @default true
+     */
+    strict?: boolean;
+    /**
+     * Remove the Yjs envelope key from outgoing/incoming records.
+     * @default true
+     */
+    stripEnvelope?: boolean;
+    /**
+     * Remove the Yjs envelope key from push payloads.
+     * Default inherits from `stripEnvelope`.
+     */
+    stripEnvelopeBeforePush?: boolean;
+    /**
+     * Remove the Yjs envelope key from local optimistic mutation payloads.
+     * Default inherits from `stripEnvelope`.
+     */
+    stripEnvelopeBeforeApplyLocalMutations?: boolean;
+}
+export declare function applyYjsTextUpdates(args: ApplyYjsTextUpdatesArgs): ApplyYjsTextUpdatesResult;
+export declare function buildYjsTextUpdate(args: BuildYjsTextUpdateArgs): BuildYjsTextUpdateResult;
+export declare function createYjsClientPlugin(options: CreateYjsClientPluginOptions): SyncClientPlugin;
+//# 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,EAIL,KAAK,gBAAgB,EAKtB,MAAM,kBAAkB,CAAC;AAG1B,eAAO,MAAM,eAAe,UAAU,CAAC;AAKvC,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,cAAc,GAAG,aAAa,CAAC;AAEnE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAQD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,oBAAoB,GAC5B,uBAAuB,GACvB,SAAS,uBAAuB,EAAE,CAAC;AAEvC,MAAM,WAAW,wBAAwB;IACvC,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAAC;CACvC;AAED,MAAM,WAAW,sBAAsB;IACrC,mBAAmB,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,uBAAuB,CAAC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,mBAAmB,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACjD,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;;OAGG;IACH,sCAAsC,CAAC,EAAE,OAAO,CAAC;CAClD;AA0SD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,uBAAuB,GAC5B,yBAAyB,CAa3B;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,sBAAsB,GAC3B,wBAAwB,CAqB1B;AAsSD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,gBAAgB,CA0HlB"}

package/dist/index.js

@@ -0,0 +1,592 @@
+import { PluginPriority, } from '@syncular/client';
+import * as Y from 'yjs';
+export const YJS_PAYLOAD_KEY = '__yjs';
+const BASE64_PATTERN = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function readString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : null;
+}
+function bytesToBase64(bytes) {
+    if (typeof Buffer !== 'undefined') {
+        return Buffer.from(bytes).toString('base64');
+    }
+    let binary = '';
+    for (const byte of bytes) {
+        binary += String.fromCharCode(byte);
+    }
+    return btoa(binary);
+}
+function tryReadBase64TextFromBytes(bytes) {
+    if (bytes.length === 0)
+        return null;
+    try {
+        const decoded = new TextDecoder().decode(bytes).trim();
+        if (!decoded || !BASE64_PATTERN.test(decoded))
+            return null;
+        return decoded;
+    }
+    catch {
+        return null;
+    }
+}
+function base64ToBytes(base64) {
+    if (!BASE64_PATTERN.test(base64)) {
+        throw new Error('Invalid base64 string');
+    }
+    if (typeof Buffer !== 'undefined') {
+        return new Uint8Array(Buffer.from(base64, 'base64'));
+    }
+    const binary = atob(base64);
+    const out = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        out[i] = binary.charCodeAt(i);
+    }
+    return out;
+}
+function stateValueToBytes(value) {
+    if (value instanceof Uint8Array) {
+        const encoded = tryReadBase64TextFromBytes(value);
+        if (encoded)
+            return base64ToBytes(encoded);
+        return value;
+    }
+    const str = readString(value);
+    if (!str)
+        return null;
+    return base64ToBytes(str);
+}
+function stateValueToBase64(value) {
+    const str = readString(value);
+    if (str)
+        return str;
+    if (value instanceof Uint8Array) {
+        const encoded = tryReadBase64TextFromBytes(value);
+        if (encoded)
+            return encoded;
+        return bytesToBase64(value);
+    }
+    return null;
+}
+function createDocFromState(stateValue) {
+    const doc = new Y.Doc();
+    const bytes = stateValueToBytes(stateValue);
+    if (bytes && bytes.length > 0) {
+        Y.applyUpdate(doc, bytes);
+    }
+    return doc;
+}
+function exportSnapshotBase64(doc) {
+    return bytesToBase64(Y.encodeStateAsUpdate(doc));
+}
+function replaceText(doc, containerKey, nextText) {
+    const text = doc.getText(containerKey);
+    const currentLength = text.length;
+    doc.transact(() => {
+        if (currentLength > 0) {
+            text.delete(0, currentLength);
+        }
+        if (nextText.length > 0) {
+            text.insert(0, nextText);
+        }
+    });
+}
+function patchText(doc, containerKey, nextText) {
+    const text = doc.getText(containerKey);
+    const currentText = text.toString();
+    if (currentText === nextText)
+        return;
+    const minLength = Math.min(currentText.length, nextText.length);
+    let prefixLength = 0;
+    while (prefixLength < minLength &&
+        currentText.charCodeAt(prefixLength) === nextText.charCodeAt(prefixLength)) {
+        prefixLength += 1;
+    }
+    let currentSuffixStart = currentText.length;
+    let nextSuffixStart = nextText.length;
+    while (currentSuffixStart > prefixLength &&
+        nextSuffixStart > prefixLength &&
+        currentText.charCodeAt(currentSuffixStart - 1) ===
+            nextText.charCodeAt(nextSuffixStart - 1)) {
+        currentSuffixStart -= 1;
+        nextSuffixStart -= 1;
+    }
+    const deleteLength = currentSuffixStart - prefixLength;
+    const insertSegment = nextText.slice(prefixLength, nextSuffixStart);
+    doc.transact(() => {
+        if (deleteLength > 0) {
+            text.delete(prefixLength, deleteLength);
+        }
+        if (insertSegment.length > 0) {
+            text.insert(prefixLength, insertSegment);
+        }
+    });
+}
+function ensureTextContainer(doc, containerKey) {
+    return doc.getText(containerKey).toString();
+}
+function ensureXmlFragmentContainer(doc, containerKey) {
+    return doc.getXmlFragment(containerKey).toString();
+}
+function materializeRuleValue(doc, rule) {
+    if (rule.kind === 'text') {
+        return ensureTextContainer(doc, rule.containerKey);
+    }
+    return ensureXmlFragmentContainer(doc, rule.containerKey);
+}
+function seedRuleValueFromPayload(doc, rule, source) {
+    if (rule.kind !== 'text')
+        return;
+    const initialText = readString(source[rule.field]);
+    if (initialText) {
+        replaceText(doc, rule.containerKey, initialText);
+    }
+}
+function buildRuleIndex(rules) {
+    const index = new Map();
+    const normalizedRules = [];
+    const seen = new Set();
+    for (const rule of rules) {
+        if (!rule.table.trim()) {
+            throw new Error('YjsClientFieldRule.table cannot be empty');
+        }
+        if (!rule.field.trim()) {
+            throw new Error('YjsClientFieldRule.field cannot be empty');
+        }
+        if (!rule.stateColumn.trim()) {
+            throw new Error('YjsClientFieldRule.stateColumn cannot be empty');
+        }
+        const key = `${rule.table}\u001f${rule.field}`;
+        if (seen.has(key)) {
+            throw new Error(`Duplicate Yjs client rule for table "${rule.table}", field "${rule.field}"`);
+        }
+        seen.add(key);
+        const resolved = {
+            ...rule,
+            containerKey: rule.containerKey ?? rule.field,
+            rowIdField: rule.rowIdField ?? 'id',
+            kind: rule.kind ?? 'text',
+        };
+        normalizedRules.push(resolved);
+        const tableRules = index.get(resolved.table) ?? new Map();
+        tableRules.set(resolved.field, resolved);
+        index.set(resolved.table, tableRules);
+    }
+    return { index, normalizedRules };
+}
+function rowFieldCacheKey(table, rowId, field) {
+    return `${table}\u001f${rowId}\u001f${field}`;
+}
+function touchLruState(map, key, value, maxTrackedRows) {
+    map.delete(key);
+    map.set(key, value);
+    if (map.size <= maxTrackedRows)
+        return;
+    const oldest = map.keys().next().value;
+    if (oldest) {
+        map.delete(oldest);
+    }
+}
+function clearRowStateCache(args) {
+    const tableRules = args.index.get(args.table);
+    if (!tableRules)
+        return;
+    for (const rule of tableRules.values()) {
+        args.stateByRowField.delete(rowFieldCacheKey(args.table, args.rowId, rule.field));
+    }
+}
+function resolveSnapshotRowId(row, rule) {
+    const candidate = row[rule.rowIdField];
+    return typeof candidate === 'string' && candidate.length > 0
+        ? candidate
+        : null;
+}
+function normalizeUpdateEnvelope(value, context) {
+    if (!isRecord(value)) {
+        throw new Error(`${context} must be an object`);
+    }
+    const updateId = readString(value.updateId);
+    const updateBase64 = readString(value.updateBase64);
+    if (!updateId) {
+        throw new Error(`${context}.updateId must be a non-empty string`);
+    }
+    if (!updateBase64) {
+        throw new Error(`${context}.updateBase64 must be a non-empty base64 string`);
+    }
+    return { updateId, updateBase64 };
+}
+function normalizeUpdateEnvelopes(value, context) {
+    if (Array.isArray(value)) {
+        return value.map((entry, i) => normalizeUpdateEnvelope(entry, `${context}[${i}]`));
+    }
+    return [normalizeUpdateEnvelope(value, context)];
+}
+function createUpdateId() {
+    const randomUUID = globalThis.crypto?.randomUUID;
+    if (typeof randomUUID === 'function') {
+        return randomUUID.call(globalThis.crypto);
+    }
+    const ts = Date.now().toString(36);
+    const rnd = Math.random().toString(36).slice(2, 12);
+    return `yjs-${ts}-${rnd}`;
+}
+export function applyYjsTextUpdates(args) {
+    const containerKey = args.containerKey ?? 'text';
+    const doc = createDocFromState(args.previousStateBase64);
+    try {
+        for (const update of args.updates) {
+            Y.applyUpdate(doc, base64ToBytes(update.updateBase64));
+        }
+        const text = ensureTextContainer(doc, containerKey);
+        const nextStateBase64 = exportSnapshotBase64(doc);
+        return { nextStateBase64, text };
+    }
+    finally {
+        doc.destroy();
+    }
+}
+export function buildYjsTextUpdate(args) {
+    const containerKey = args.containerKey ?? 'text';
+    const doc = createDocFromState(args.previousStateBase64);
+    try {
+        const from = Y.encodeStateVector(doc);
+        patchText(doc, containerKey, args.nextText);
+        const update = bytesToBase64(Y.encodeStateAsUpdate(doc, from));
+        const nextText = ensureTextContainer(doc, containerKey);
+        const nextStateBase64 = exportSnapshotBase64(doc);
+        return {
+            update: {
+                updateId: args.updateId ?? createUpdateId(),
+                updateBase64: update,
+            },
+            nextStateBase64,
+            nextText,
+        };
+    }
+    finally {
+        doc.destroy();
+    }
+}
+function materializeRowFromState(args) {
+    const tableRules = args.index.get(args.table);
+    if (!tableRules) {
+        if (args.stripEnvelope && args.envelopeKey in args.row) {
+            const next = { ...args.row };
+            delete next[args.envelopeKey];
+            return next;
+        }
+        return args.row;
+    }
+    let nextRow = null;
+    const ensureRow = () => {
+        if (nextRow)
+            return nextRow;
+        nextRow = { ...args.row };
+        return nextRow;
+    };
+    for (const rule of tableRules.values()) {
+        const source = nextRow ?? args.row;
+        const stateBase64 = stateValueToBase64(source[rule.stateColumn]);
+        if (!stateBase64)
+            continue;
+        const doc = createDocFromState(stateBase64);
+        try {
+            const nextValue = materializeRuleValue(doc, rule);
+            if (source[rule.field] !== nextValue) {
+                ensureRow()[rule.field] = nextValue;
+            }
+            if (args.rowId) {
+                touchLruState(args.stateByRowField, rowFieldCacheKey(args.table, args.rowId, rule.field), stateBase64, args.maxTrackedRows);
+            }
+        }
+        finally {
+            doc.destroy();
+        }
+    }
+    if (args.stripEnvelope) {
+        const source = nextRow ?? args.row;
+        if (args.envelopeKey in source) {
+            const target = ensureRow();
+            delete target[args.envelopeKey];
+        }
+    }
+    return nextRow ?? args.row;
+}
+function transformPushPayload(args) {
+    const tableRules = args.index.get(args.table);
+    const rawEnvelope = args.payload[args.envelopeKey];
+    if (!tableRules) {
+        if (rawEnvelope !== undefined && args.strict) {
+            throw new Error(`Yjs envelope provided for table "${args.table}" without matching rules`);
+        }
+        if (args.stripEnvelope && rawEnvelope !== undefined) {
+            const next = { ...args.payload };
+            delete next[args.envelopeKey];
+            return next;
+        }
+        return args.payload;
+    }
+    let nextPayload = null;
+    const ensurePayload = () => {
+        if (nextPayload)
+            return nextPayload;
+        nextPayload = { ...args.payload };
+        return nextPayload;
+    };
+    const sourceEnvelope = rawEnvelope;
+    if (sourceEnvelope !== undefined && !isRecord(sourceEnvelope)) {
+        throw new Error(`Yjs payload key "${args.envelopeKey}" must be an object for table "${args.table}"`);
+    }
+    for (const rule of tableRules.values()) {
+        const source = nextPayload ?? args.payload;
+        const stateBase64 = stateValueToBase64(source[rule.stateColumn]);
+        if (stateBase64) {
+            touchLruState(args.stateByRowField, rowFieldCacheKey(args.table, args.rowId, rule.field), stateBase64, args.maxTrackedRows);
+        }
+    }
+    if (sourceEnvelope) {
+        for (const [field, rawUpdateInput] of Object.entries(sourceEnvelope)) {
+            const rule = tableRules.get(field);
+            if (!rule) {
+                if (args.strict) {
+                    throw new Error(`No Yjs rule found for envelope field "${field}" on table "${args.table}"`);
+                }
+                continue;
+            }
+            const updates = normalizeUpdateEnvelopes(rawUpdateInput, `yjs.${args.table}.${field}`);
+            const cacheKey = rowFieldCacheKey(args.table, args.rowId, rule.field);
+            const source = nextPayload ?? args.payload;
+            const baseState = stateValueToBase64(source[rule.stateColumn]) ??
+                args.stateByRowField.get(cacheKey) ??
+                null;
+            const doc = createDocFromState(baseState);
+            try {
+                if (!baseState) {
+                    seedRuleValueFromPayload(doc, rule, source);
+                }
+                for (const update of updates) {
+                    Y.applyUpdate(doc, base64ToBytes(update.updateBase64));
+                }
+                const nextValue = materializeRuleValue(doc, rule);
+                const nextStateBase64 = exportSnapshotBase64(doc);
+                const target = ensurePayload();
+                target[rule.field] = nextValue;
+                target[rule.stateColumn] = nextStateBase64;
+                touchLruState(args.stateByRowField, cacheKey, nextStateBase64, args.maxTrackedRows);
+            }
+            finally {
+                doc.destroy();
+            }
+        }
+    }
+    if (args.stripEnvelope) {
+        const source = nextPayload ?? args.payload;
+        if (args.envelopeKey in source) {
+            const target = ensurePayload();
+            delete target[args.envelopeKey];
+        }
+    }
+    return nextPayload ?? args.payload;
+}
+function transformPullSubscription(args) {
+    const nextSnapshots = (args.sub.snapshots ?? []).map((snapshot) => ({
+        ...snapshot,
+        rows: (snapshot.rows ?? []).map((row) => {
+            if (!isRecord(row))
+                return row;
+            const tableRules = args.index.get(snapshot.table);
+            if (!tableRules) {
+                return materializeRowFromState({
+                    table: snapshot.table,
+                    rowId: null,
+                    row,
+                    index: args.index,
+                    stateByRowField: args.stateByRowField,
+                    maxTrackedRows: args.maxTrackedRows,
+                    envelopeKey: args.envelopeKey,
+                    stripEnvelope: args.stripEnvelope,
+                });
+            }
+            let rowId = null;
+            for (const rule of tableRules.values()) {
+                rowId = resolveSnapshotRowId(row, rule);
+                if (rowId)
+                    break;
+            }
+            return materializeRowFromState({
+                table: snapshot.table,
+                rowId,
+                row,
+                index: args.index,
+                stateByRowField: args.stateByRowField,
+                maxTrackedRows: args.maxTrackedRows,
+                envelopeKey: args.envelopeKey,
+                stripEnvelope: args.stripEnvelope,
+            });
+        }),
+    }));
+    const nextCommits = (args.sub.commits ?? []).map((commit) => ({
+        ...commit,
+        changes: (commit.changes ?? []).map((change) => {
+            if (change.op === 'delete') {
+                clearRowStateCache({
+                    table: change.table,
+                    rowId: change.row_id,
+                    index: args.index,
+                    stateByRowField: args.stateByRowField,
+                });
+                return change;
+            }
+            if (change.op !== 'upsert' || !isRecord(change.row_json))
+                return change;
+            const nextRow = materializeRowFromState({
+                table: change.table,
+                rowId: change.row_id,
+                row: change.row_json,
+                index: args.index,
+                stateByRowField: args.stateByRowField,
+                maxTrackedRows: args.maxTrackedRows,
+                envelopeKey: args.envelopeKey,
+                stripEnvelope: args.stripEnvelope,
+            });
+            if (nextRow === change.row_json)
+                return change;
+            return { ...change, row_json: nextRow };
+        }),
+    }));
+    return {
+        ...args.sub,
+        snapshots: nextSnapshots,
+        commits: nextCommits,
+    };
+}
+function transformWsChanges(args) {
+    return args.changes.map((change) => {
+        if (change.op === 'delete') {
+            clearRowStateCache({
+                table: change.table,
+                rowId: change.row_id,
+                index: args.index,
+                stateByRowField: args.stateByRowField,
+            });
+            return change;
+        }
+        if (change.op !== 'upsert' || !isRecord(change.row_json))
+            return change;
+        const nextRow = materializeRowFromState({
+            table: change.table,
+            rowId: change.row_id,
+            row: change.row_json,
+            index: args.index,
+            stateByRowField: args.stateByRowField,
+            maxTrackedRows: args.maxTrackedRows,
+            envelopeKey: args.envelopeKey,
+            stripEnvelope: args.stripEnvelope,
+        });
+        if (nextRow === change.row_json)
+            return change;
+        return { ...change, row_json: nextRow };
+    });
+}
+export function createYjsClientPlugin(options) {
+    if (options.rules.length === 0) {
+        throw new Error('createYjsClientPlugin requires at least one table/field rule');
+    }
+    const envelopeKey = options.envelopeKey ?? YJS_PAYLOAD_KEY;
+    const strict = options.strict ?? true;
+    const stripEnvelope = options.stripEnvelope ?? true;
+    const stripEnvelopeBeforePush = options.stripEnvelopeBeforePush ?? stripEnvelope;
+    const stripEnvelopeBeforeApplyLocalMutations = options.stripEnvelopeBeforeApplyLocalMutations ?? stripEnvelope;
+    const maxTrackedRows = Math.max(1, Math.min(1_000_000, options.maxTrackedRows ?? 10_000));
+    const { index } = buildRuleIndex(options.rules);
+    const stateByRowField = new Map();
+    return {
+        name: options.name ?? 'crdt-yjs-client',
+        priority: options.priority ?? PluginPriority.DEFAULT,
+        beforePush(_ctx, request) {
+            const nextOperations = request.operations.map((op) => {
+                if (op.op !== 'upsert')
+                    return op;
+                if (!isRecord(op.payload))
+                    return op;
+                const nextPayload = transformPushPayload({
+                    table: op.table,
+                    rowId: op.row_id,
+                    payload: op.payload,
+                    index,
+                    stateByRowField,
+                    maxTrackedRows,
+                    envelopeKey,
+                    stripEnvelope: stripEnvelopeBeforePush,
+                    strict,
+                });
+                if (nextPayload === op.payload)
+                    return op;
+                return { ...op, payload: nextPayload };
+            });
+            return { ...request, operations: nextOperations };
+        },
+        beforeApplyLocalMutations(_ctx, args) {
+            const nextOperations = args.operations.map((op) => {
+                if (op.op === 'delete') {
+                    clearRowStateCache({
+                        table: op.table,
+                        rowId: op.row_id,
+                        index,
+                        stateByRowField,
+                    });
+                    return op;
+                }
+                if (op.op !== 'upsert')
+                    return op;
+                if (!isRecord(op.payload))
+                    return op;
+                const nextPayload = transformPushPayload({
+                    table: op.table,
+                    rowId: op.row_id,
+                    payload: op.payload,
+                    index,
+                    stateByRowField,
+                    maxTrackedRows,
+                    envelopeKey,
+                    stripEnvelope: stripEnvelopeBeforeApplyLocalMutations,
+                    strict,
+                });
+                if (nextPayload === op.payload)
+                    return op;
+                return { ...op, payload: nextPayload };
+            });
+            return { ...args, operations: nextOperations };
+        },
+        afterPull(_ctx, args) {
+            const nextSubscriptions = args.response.subscriptions.map((sub) => transformPullSubscription({
+                sub,
+                index,
+                stateByRowField,
+                maxTrackedRows,
+                envelopeKey,
+                stripEnvelope,
+            }));
+            return {
+                ...args.response,
+                subscriptions: nextSubscriptions,
+            };
+        },
+        beforeApplyWsChanges(_ctx, args) {
+            const nextChanges = transformWsChanges({
+                changes: args.changes,
+                index,
+                stateByRowField,
+                maxTrackedRows,
+                envelopeKey,
+                stripEnvelope,
+            });
+            return {
+                ...args,
+                changes: nextChanges,
+            };
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/client-plugin-yjs",
-  "version": "0.0.0",
+  "version": "0.0.6-159",
   "description": "Yjs CRDT plugin primitives for Syncular client integration",
   "license": "Apache-2.0",
   "author": "Benjamin Kniffler",
@@ -44,7 +44,7 @@
     "release": "bunx syncular-publish"
   },
   "dependencies": {
-    "@syncular/client": "0.0.0",
+    "@syncular/client": "0.0.6-159",
     "yjs": "^13.6.29"
   },
   "devDependencies": {

package/src/index.test.ts

@@ -317,6 +317,189 @@ describe('@syncular/client-plugin-crdt-yjs', () => {
     expect(typeof payload.content_yjs_state).toBe('string');
   });
 
+  it('invalidates cached row state after pull commit delete before row-id reuse', async () => {
+    const plugin = createYjsClientPlugin({
+      rules: [
+        {
+          table: 'tasks',
+          field: 'content',
+          stateColumn: 'content_yjs_state',
+        },
+      ],
+    });
+
+    const old = createUpdate('old');
+    await callAfterPull(plugin, {
+      ok: true,
+      subscriptions: [
+        {
+          id: 'tasks',
+          status: 'active',
+          scopes: {},
+          bootstrap: true,
+          nextCursor: 1,
+          bootstrapState: null,
+          commits: [],
+          snapshots: [
+            {
+              table: 'tasks',
+              rows: [
+                {
+                  id: 'task-1',
+                  content: 'stale',
+                  content_yjs_state: old.state,
+                },
+              ],
+              isFirstPage: true,
+              isLastPage: true,
+            },
+          ],
+        },
+      ],
+    });
+
+    await callAfterPull(plugin, {
+      ok: true,
+      subscriptions: [
+        {
+          id: 'tasks',
+          status: 'active',
+          scopes: {},
+          bootstrap: false,
+          nextCursor: 2,
+          bootstrapState: null,
+          snapshots: [],
+          commits: [
+            {
+              commitSeq: 2,
+              createdAt: '2026-03-01T00:00:00.000Z',
+              actorId: 'actor-2',
+              changes: [
+                {
+                  table: 'tasks',
+                  row_id: 'task-1',
+                  op: 'delete',
+                  row_json: null,
+                  row_version: null,
+                  scopes: {},
+                },
+              ],
+            },
+          ],
+        },
+      ],
+    });
+
+    const fresh = createUpdate('new');
+    const pushed = await callBeforePush(plugin, {
+      clientId: 'client-1',
+      clientCommitId: 'commit-reuse-after-delete',
+      schemaVersion: 1,
+      operations: [
+        {
+          table: 'tasks',
+          row_id: 'task-1',
+          op: 'upsert',
+          payload: {
+            [YJS_PAYLOAD_KEY]: {
+              content: fresh.update,
+            },
+          },
+          base_version: null,
+        },
+      ],
+    });
+
+    const payload = pushed.operations[0]?.payload as
+      | Record<string, unknown>
+      | undefined;
+    if (!payload) {
+      throw new Error('Expected transformed push payload');
+    }
+
+    expect(payload.content).toBe('new');
+    expect(String(payload.content)).not.toContain('old');
+  });
+
+  it('evicts least-recently-used cached row state when maxTrackedRows is reached', async () => {
+    const plugin = createYjsClientPlugin({
+      rules: [
+        {
+          table: 'tasks',
+          field: 'content',
+          stateColumn: 'content_yjs_state',
+        },
+      ],
+      maxTrackedRows: 1,
+    });
+
+    const rowOne = createUpdate('old');
+    const rowTwo = createUpdate('other');
+
+    await callAfterPull(plugin, {
+      ok: true,
+      subscriptions: [
+        {
+          id: 'tasks',
+          status: 'active',
+          scopes: {},
+          bootstrap: true,
+          nextCursor: 1,
+          bootstrapState: null,
+          commits: [],
+          snapshots: [
+            {
+              table: 'tasks',
+              rows: [
+                {
+                  id: 'task-1',
+                  content: 'stale',
+                  content_yjs_state: rowOne.state,
+                },
+                {
+                  id: 'task-2',
+                  content: 'stale',
+                  content_yjs_state: rowTwo.state,
+                },
+              ],
+              isFirstPage: true,
+              isLastPage: true,
+            },
+          ],
+        },
+      ],
+    });
+
+    const fullFromEmpty = createUpdate('new');
+    const pushed = await callBeforePush(plugin, {
+      clientId: 'client-1',
+      clientCommitId: 'commit-eviction',
+      schemaVersion: 1,
+      operations: [
+        {
+          table: 'tasks',
+          row_id: 'task-1',
+          op: 'upsert',
+          payload: {
+            [YJS_PAYLOAD_KEY]: {
+              content: fullFromEmpty.update,
+            },
+          },
+          base_version: null,
+        },
+      ],
+    });
+
+    const payload = pushed.operations[0]?.payload as
+      | Record<string, unknown>
+      | undefined;
+    if (!payload) {
+      throw new Error('Expected transformed push payload');
+    }
+
+    expect(payload.content).toBe('new');
+  });
+
   it('materializes websocket inline changes through beforeApplyWsChanges', async () => {
     const plugin = createYjsClientPlugin({
       rules: [

package/src/index.ts

@@ -87,6 +87,12 @@ export interface CreateYjsClientPluginOptions {
   rules: readonly YjsClientFieldRule[];
   envelopeKey?: string;
   priority?: number;
+  /**
+   * Maximum cached row-field Yjs states to keep in memory.
+   * Prevents unbounded growth in long-lived sessions.
+   * @default 10_000
+   */
+  maxTrackedRows?: number;
   /**
    * Throw when envelope payload references fields without matching rules.
    * @default true
@@ -323,6 +329,36 @@ function rowFieldCacheKey(table: string, rowId: string, field: string): string {
   return `${table}\u001f${rowId}\u001f${field}`;
 }
 
+function touchLruState(
+  map: Map<string, string>,
+  key: string,
+  value: string,
+  maxTrackedRows: number
+): void {
+  map.delete(key);
+  map.set(key, value);
+  if (map.size <= maxTrackedRows) return;
+  const oldest = map.keys().next().value as string | undefined;
+  if (oldest) {
+    map.delete(oldest);
+  }
+}
+
+function clearRowStateCache(args: {
+  table: string;
+  rowId: string;
+  index: RuleIndex;
+  stateByRowField: Map<string, string>;
+}): void {
+  const tableRules = args.index.get(args.table);
+  if (!tableRules) return;
+  for (const rule of tableRules.values()) {
+    args.stateByRowField.delete(
+      rowFieldCacheKey(args.table, args.rowId, rule.field)
+    );
+  }
+}
+
 function resolveSnapshotRowId(
   row: Record<string, unknown>,
   rule: ResolvedYjsClientFieldRule
@@ -423,6 +459,7 @@ function materializeRowFromState(args: {
   row: Record<string, unknown>;
   index: RuleIndex;
   stateByRowField: Map<string, string>;
+  maxTrackedRows: number;
   envelopeKey: string;
   stripEnvelope: boolean;
 }): Record<string, unknown> {
@@ -455,9 +492,11 @@ function materializeRowFromState(args: {
         ensureRow()[rule.field] = nextValue;
       }
       if (args.rowId) {
-        args.stateByRowField.set(
+        touchLruState(
+          args.stateByRowField,
           rowFieldCacheKey(args.table, args.rowId, rule.field),
-          stateBase64
+          stateBase64,
+          args.maxTrackedRows
         );
       }
     } finally {
@@ -482,6 +521,7 @@ function transformPushPayload(args: {
   payload: Record<string, unknown>;
   index: RuleIndex;
   stateByRowField: Map<string, string>;
+  maxTrackedRows: number;
   envelopeKey: string;
   stripEnvelope: boolean;
   strict: boolean;
@@ -521,9 +561,11 @@ function transformPushPayload(args: {
     const source = nextPayload ?? args.payload;
     const stateBase64 = stateValueToBase64(source[rule.stateColumn]);
     if (stateBase64) {
-      args.stateByRowField.set(
+      touchLruState(
+        args.stateByRowField,
         rowFieldCacheKey(args.table, args.rowId, rule.field),
-        stateBase64
+        stateBase64,
+        args.maxTrackedRows
       );
     }
   }
@@ -566,7 +608,12 @@ function transformPushPayload(args: {
         const target = ensurePayload();
         target[rule.field] = nextValue;
         target[rule.stateColumn] = nextStateBase64;
-        args.stateByRowField.set(cacheKey, nextStateBase64);
+        touchLruState(
+          args.stateByRowField,
+          cacheKey,
+          nextStateBase64,
+          args.maxTrackedRows
+        );
       } finally {
         doc.destroy();
       }
@@ -588,6 +635,7 @@ function transformPullSubscription(args: {
   sub: SyncPullSubscriptionResponse;
   index: RuleIndex;
   stateByRowField: Map<string, string>;
+  maxTrackedRows: number;
   envelopeKey: string;
   stripEnvelope: boolean;
 }): SyncPullSubscriptionResponse {
@@ -603,6 +651,7 @@ function transformPullSubscription(args: {
           row,
           index: args.index,
           stateByRowField: args.stateByRowField,
+          maxTrackedRows: args.maxTrackedRows,
           envelopeKey: args.envelopeKey,
           stripEnvelope: args.stripEnvelope,
         });
@@ -620,6 +669,7 @@ function transformPullSubscription(args: {
         row,
         index: args.index,
         stateByRowField: args.stateByRowField,
+        maxTrackedRows: args.maxTrackedRows,
         envelopeKey: args.envelopeKey,
         stripEnvelope: args.stripEnvelope,
       });
@@ -629,6 +679,15 @@ function transformPullSubscription(args: {
   const nextCommits = (args.sub.commits ?? []).map((commit) => ({
     ...commit,
     changes: (commit.changes ?? []).map((change) => {
+      if (change.op === 'delete') {
+        clearRowStateCache({
+          table: change.table,
+          rowId: change.row_id,
+          index: args.index,
+          stateByRowField: args.stateByRowField,
+        });
+        return change;
+      }
       if (change.op !== 'upsert' || !isRecord(change.row_json)) return change;
       const nextRow = materializeRowFromState({
         table: change.table,
@@ -636,6 +695,7 @@ function transformPullSubscription(args: {
         row: change.row_json,
         index: args.index,
         stateByRowField: args.stateByRowField,
+        maxTrackedRows: args.maxTrackedRows,
         envelopeKey: args.envelopeKey,
         stripEnvelope: args.stripEnvelope,
       });
@@ -655,10 +715,20 @@ function transformWsChanges(args: {
   changes: SyncChange[];
   index: RuleIndex;
   stateByRowField: Map<string, string>;
+  maxTrackedRows: number;
   envelopeKey: string;
   stripEnvelope: boolean;
 }): SyncChange[] {
   return args.changes.map((change) => {
+    if (change.op === 'delete') {
+      clearRowStateCache({
+        table: change.table,
+        rowId: change.row_id,
+        index: args.index,
+        stateByRowField: args.stateByRowField,
+      });
+      return change;
+    }
     if (change.op !== 'upsert' || !isRecord(change.row_json)) return change;
     const nextRow = materializeRowFromState({
       table: change.table,
@@ -666,6 +736,7 @@ function transformWsChanges(args: {
       row: change.row_json,
       index: args.index,
       stateByRowField: args.stateByRowField,
+      maxTrackedRows: args.maxTrackedRows,
       envelopeKey: args.envelopeKey,
       stripEnvelope: args.stripEnvelope,
     });
@@ -690,6 +761,10 @@ export function createYjsClientPlugin(
     options.stripEnvelopeBeforePush ?? stripEnvelope;
   const stripEnvelopeBeforeApplyLocalMutations =
     options.stripEnvelopeBeforeApplyLocalMutations ?? stripEnvelope;
+  const maxTrackedRows = Math.max(
+    1,
+    Math.min(1_000_000, options.maxTrackedRows ?? 10_000)
+  );
   const { index } = buildRuleIndex(options.rules);
   const stateByRowField = new Map<string, string>();
 
@@ -708,6 +783,7 @@ export function createYjsClientPlugin(
           payload: op.payload,
           index,
           stateByRowField,
+          maxTrackedRows,
           envelopeKey,
           stripEnvelope: stripEnvelopeBeforePush,
           strict,
@@ -725,6 +801,15 @@ export function createYjsClientPlugin(
       args: SyncClientLocalMutationArgs
     ): SyncClientLocalMutationArgs {
       const nextOperations = args.operations.map((op) => {
+        if (op.op === 'delete') {
+          clearRowStateCache({
+            table: op.table,
+            rowId: op.row_id,
+            index,
+            stateByRowField,
+          });
+          return op;
+        }
         if (op.op !== 'upsert') return op;
         if (!isRecord(op.payload)) return op;
 
@@ -734,6 +819,7 @@ export function createYjsClientPlugin(
           payload: op.payload,
           index,
           stateByRowField,
+          maxTrackedRows,
           envelopeKey,
           stripEnvelope: stripEnvelopeBeforeApplyLocalMutations,
           strict,
@@ -752,6 +838,7 @@ export function createYjsClientPlugin(
           sub,
           index,
           stateByRowField,
+          maxTrackedRows,
           envelopeKey,
           stripEnvelope,
         })
@@ -771,6 +858,7 @@ export function createYjsClientPlugin(
         changes: args.changes,
         index,
         stateByRowField,
+        maxTrackedRows,
         envelopeKey,
         stripEnvelope,
       });