@texaryn/core 0.13.0 → 0.15.0

package/dist/runtime/document-update-session.js

@@ -0,0 +1,320 @@
+import { parsePointer } from '../json-pointer.js';
+import { isBatchActive } from '../state/signal.js';
+import { cloneJson } from './document-runtime.js';
+import { getDocumentRuntimeControl } from './document-runtime-control.js';
+import { assertDocumentNodeCount, maxPatchCandidateValuesPerMessage, preflightJson, } from './document-limits.js';
+function isRecord(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function assertExactKeys(value, required, path) {
+    const allowed = new Set(required);
+    for (const key of Object.keys(value)) {
+        if (!allowed.has(key))
+            throw new TypeError(`${path}.${key} is not supported`);
+    }
+    for (const key of required) {
+        if (!Object.prototype.hasOwnProperty.call(value, key))
+            throw new TypeError(`${path}.${key} is required`);
+    }
+}
+function assertRevision(value) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 0) {
+        throw new TypeError('message.revision must be a nonnegative safe integer');
+    }
+}
+function pointerTokens(path, operationIndex) {
+    if (typeof path !== 'string' || !path.startsWith('/') || /~(?![01])/.test(path)) {
+        throw new TypeError(`patch[${operationIndex}].path must be a valid JSON Pointer`);
+    }
+    let tokens;
+    try {
+        tokens = parsePointer(path);
+    }
+    catch {
+        throw new TypeError(`patch[${operationIndex}].path must be a valid JSON Pointer`);
+    }
+    if (tokens.length < 2 || tokens[0] !== 'nodes') {
+        throw new TypeError(`patch[${operationIndex}].path must address a descendant of /nodes`);
+    }
+    return tokens;
+}
+function canonicalArrayIndex(token, length, allowEnd, path) {
+    if (!/^(0|[1-9]\d*)$/.test(token))
+        throw new TypeError(`${path} must use a canonical array index`);
+    const index = Number(token);
+    const maximum = allowEnd ? length : length - 1;
+    if (!Number.isSafeInteger(index) || index < 0 || index > maximum) {
+        throw new TypeError(`${path} is outside the array bounds`);
+    }
+    return index;
+}
+function readChild(parent, key, path) {
+    if (Array.isArray(parent)) {
+        const index = canonicalArrayIndex(key, parent.length, false, path);
+        return parent[index];
+    }
+    if (!Object.prototype.hasOwnProperty.call(parent, key))
+        throw new TypeError(`${path} does not exist`);
+    return parent[key];
+}
+function locateParent(root, tokens, path) {
+    let current = root;
+    for (let index = 0; index < tokens.length - 1; index += 1) {
+        if (!Array.isArray(current) && !isRecord(current))
+            throw new TypeError(`${path} has a missing intermediate parent`);
+        current = readChild(current, tokens[index], path);
+    }
+    if (!Array.isArray(current) && !isRecord(current))
+        throw new TypeError(`${path} has a missing intermediate parent`);
+    return { parent: current, key: tokens[tokens.length - 1] };
+}
+function writeObjectMember(parent, key, value) {
+    Object.defineProperty(parent, key, {
+        configurable: true,
+        enumerable: true,
+        writable: true,
+        value,
+    });
+}
+function applyPatchOperation(candidate, operation, operationIndex) {
+    const tokens = pointerTokens(operation.path, operationIndex);
+    const { parent, key } = locateParent(candidate, tokens, `patch[${operationIndex}].path`);
+    if (Array.isArray(parent)) {
+        if (operation.op === 'add' && key === '-') {
+            parent.push(operation.value);
+            return;
+        }
+        const index = canonicalArrayIndex(key, parent.length, operation.op === 'add', `patch[${operationIndex}].path`);
+        if (operation.op === 'add') {
+            parent.splice(index, 0, operation.value);
+            return;
+        }
+        if (index >= parent.length)
+            throw new TypeError(`patch[${operationIndex}].path target does not exist`);
+        if (operation.op === 'remove')
+            parent.splice(index, 1);
+        else
+            parent[index] = operation.value;
+        return;
+    }
+    const exists = Object.prototype.hasOwnProperty.call(parent, key);
+    if (operation.op !== 'add' && !exists)
+        throw new TypeError(`patch[${operationIndex}].path target does not exist`);
+    if (operation.op === 'remove')
+        delete parent[key];
+    else
+        writeObjectMember(parent, key, operation.value);
+}
+function validateOperation(value, index) {
+    if (!isRecord(value))
+        throw new TypeError(`patch[${index}] must be an object`);
+    const operation = value.op;
+    if (operation !== 'add' && operation !== 'remove' && operation !== 'replace') {
+        throw new TypeError(`patch[${index}].op is not supported`);
+    }
+    const keys = operation === 'remove' ? ['op', 'path'] : ['op', 'path', 'value'];
+    assertExactKeys(value, keys, `patch[${index}]`);
+    if (typeof value.path !== 'string')
+        throw new TypeError(`patch[${index}].path must be a string`);
+    return operation === 'remove'
+        ? { op: operation, path: value.path }
+        : { op: operation, path: value.path, value: value.value };
+}
+function applyPatch(document, patch, limits, work) {
+    let candidate = cloneJson(document, 'document', limits, work);
+    for (const [index, rawOperation] of patch.entries()) {
+        const operation = validateOperation(rawOperation, index);
+        const readyOperation = operation.op === 'remove'
+            ? operation
+            : { ...operation, value: cloneJson(operation.value, `patch[${index}].value`, limits, work) };
+        applyPatchOperation(candidate, readyOperation, index);
+        preflightJson(candidate, `patch[${index}].candidate`, limits, work);
+        if (!isRecord(candidate) || !isRecord(candidate.nodes)) {
+            throw new TypeError(`patch[${index}] leaves document.nodes invalid`);
+        }
+        assertDocumentNodeCount(candidate.nodes, limits);
+    }
+    return candidate;
+}
+function createRateLimiter(maximum, now) {
+    const timestamps = new Array(maximum);
+    let start = 0;
+    let size = 0;
+    let lastNow = Number.NEGATIVE_INFINITY;
+    return () => {
+        const current = now();
+        if (!Number.isFinite(current) || current < lastNow) {
+            throw new TypeError('session clock must return finite, nondecreasing values');
+        }
+        lastNow = current;
+        while (size > 0 && current - timestamps[start] >= 1000) {
+            start = (start + 1) % maximum;
+            size -= 1;
+        }
+        if (size >= maximum)
+            throw new Error('Document update rate limit exceeded');
+        timestamps[(start + size) % maximum] = current;
+        size += 1;
+    };
+}
+function sessionLimits(value, maximum, name) {
+    const resolved = value ?? maximum;
+    if (!Number.isSafeInteger(resolved) || resolved < 1 || resolved > maximum) {
+        throw new RangeError(`${name} must be an integer from 1 to ${maximum}`);
+    }
+    return resolved;
+}
+export function createDocumentUpdateSession(runtime, options) {
+    if (typeof options?.onNotificationError !== 'function') {
+        throw new TypeError('onNotificationError must be a function');
+    }
+    const control = getDocumentRuntimeControl(runtime);
+    const maxMessages = sessionLimits(options.maxMessagesPerSecond, 30, 'maxMessagesPerSecond');
+    const maxPatchOperations = sessionLimits(options.maxPatchOperations, 100, 'maxPatchOperations');
+    const now = options.now ?? (() => globalThis.performance.now());
+    const recordAttempt = createRateLimiter(maxMessages, now);
+    let state;
+    let invalidated = false;
+    let applying = false;
+    let destroyed = false;
+    function baselineMatches() {
+        if (!state)
+            return false;
+        return control.getMutationVersion() === state.mutationVersion &&
+            runtime.document.getSnapshot() === state.document &&
+            runtime.data.getSnapshot() === state.data;
+    }
+    function publish(revision, document, data, preserveUnkeyed, publishDocument, publishData) {
+        let committed = false;
+        try {
+            control.replaceSnapshot(document, data, {
+                preserveUnkeyed,
+                publishDocument,
+                publishData,
+            }, (commit) => {
+                state = {
+                    revision,
+                    document: commit.document,
+                    data: commit.data,
+                    mutationVersion: commit.mutationVersion,
+                };
+                invalidated = false;
+                committed = true;
+            });
+        }
+        catch (error) {
+            if (!committed)
+                throw error;
+            try {
+                options.onNotificationError(error);
+            }
+            catch {
+                // Notification reporting must not change the result of a committed update.
+            }
+        }
+        if (!state || state.revision !== revision)
+            throw new Error('Document update did not commit');
+        if (!baselineMatches())
+            invalidated = true;
+    }
+    function processSnapshot(message, revision) {
+        assertExactKeys(message, ['protocol', 'kind', 'revision', 'document', 'data'], 'message');
+        if (state && revision <= state.revision)
+            throw new Error('snapshot revision must be higher than the current revision');
+        publish(revision, message.document, message.data, false, true, true);
+    }
+    function processUpdate(message, revision, work) {
+        const keys = Object.keys(message);
+        const allowed = new Set(['protocol', 'kind', 'revision', 'patch', 'data']);
+        for (const key of keys)
+            if (!allowed.has(key))
+                throw new TypeError(`message.${key} is not supported`);
+        for (const key of ['protocol', 'kind', 'revision']) {
+            if (!Object.prototype.hasOwnProperty.call(message, key))
+                throw new TypeError(`message.${key} is required`);
+        }
+        if (!state)
+            throw new Error('the first document message must be a snapshot');
+        if (revision !== state.revision + 1 || !Number.isSafeInteger(revision)) {
+            throw new Error('update revision must be exactly one greater than the current revision');
+        }
+        if (invalidated || !baselineMatches()) {
+            invalidated = true;
+            throw new Error('runtime changed outside this session; a higher revision snapshot is required');
+        }
+        const hasPatch = Object.prototype.hasOwnProperty.call(message, 'patch');
+        const hasData = Object.prototype.hasOwnProperty.call(message, 'data');
+        if (!hasPatch && !hasData)
+            throw new TypeError('update must contain patch, data, or both');
+        let patch = [];
+        if (hasPatch) {
+            if (!Array.isArray(message.patch))
+                throw new TypeError('message.patch must be an array');
+            if (message.patch.length > maxPatchOperations) {
+                throw new TypeError(`message.patch exceeds the maximum operation count of ${maxPatchOperations}`);
+            }
+            patch = message.patch;
+        }
+        const currentDocument = runtime.document.getSnapshot();
+        const currentData = runtime.data.getSnapshot();
+        if (patch.length === 0 && !hasData) {
+            state = {
+                ...state,
+                revision,
+                mutationVersion: control.getMutationVersion(),
+            };
+            return;
+        }
+        const nextDocument = patch.length > 0
+            ? applyPatch(currentDocument, patch, control.limits, work)
+            : currentDocument;
+        const nextData = hasData ? message.data : currentData;
+        publish(revision, nextDocument, nextData, patch.length > 0 && !hasData, patch.length > 0, hasData);
+    }
+    return {
+        apply(message) {
+            if (destroyed)
+                throw new Error('DocumentUpdateSession has been destroyed');
+            recordAttempt();
+            if (isBatchActive())
+                throw new Error('document updates cannot be applied inside a signal batch');
+            if (applying)
+                throw new Error('reentrant document update is not allowed');
+            applying = true;
+            try {
+                const work = {
+                    visitedValues: 0,
+                    maxVisitedValues: maxPatchCandidateValuesPerMessage,
+                };
+                preflightJson(message, 'message', control.limits, work);
+                if (!isRecord(message))
+                    throw new TypeError('message must be an object');
+                if (message.protocol !== 1)
+                    throw new TypeError('message.protocol must be 1');
+                assertRevision(message.revision);
+                if (message.kind === 'snapshot') {
+                    processSnapshot(message, message.revision);
+                    return;
+                }
+                if (message.kind === 'update') {
+                    processUpdate(message, message.revision, work);
+                    return;
+                }
+                throw new TypeError('message.kind must be snapshot or update');
+            }
+            finally {
+                applying = false;
+            }
+        },
+        getRevision() {
+            return state?.revision;
+        },
+        destroy() {
+            destroyed = true;
+        },
+    };
+}
+//# sourceMappingURL=document-update-session.js.map

package/dist/runtime/document-update-session.js.map

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

package/dist/runtime/index.d.ts

@@ -1,3 +1,5 @@
-export type { FormRuntime, FormRuntimeOptions, InitializationPolicy, InitializationReport, NodeState, } from './types.js';
-export { createFormRuntime } from './runtime.js';
+export type { UIDocumentRuntime, DocumentRuntime, DocumentRuntimeOptions, DocumentCollectionRow, DocumentActionContext, DocumentActionHandler, DocumentActionArgumentValidator, DocumentActionRegistration, DocumentAction, DocumentRuntimeLimits, DocumentUpdateSession, DocumentUpdateSessionOptions, FormRuntime, FormRuntimeOptions, FormMutation, FormCommandGuard, FormCommandGuardContext, RemoteSnapshotOptions, InitializationPolicy, InitializationReport, NodeState, } from './types.js';
+export { createDocumentRuntime } from './document-runtime.js';
+export { createDocumentUpdateSession } from './document-update-session.js';
+export { createFormRuntime, RemoteSnapshotNotificationError } from './runtime.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,SAAS,GACV,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,+BAA+B,EAC/B,0BAA0B,EAC1B,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,4BAA4B,EAC5B,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,SAAS,GACV,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAA;AAC1E,OAAO,EAAE,iBAAiB,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAA"}

package/dist/runtime/index.js

@@ -1,2 +1,4 @@
-export { createFormRuntime } from './runtime.js';
+export { createDocumentRuntime } from './document-runtime.js';
+export { createDocumentUpdateSession } from './document-update-session.js';
+export { createFormRuntime, RemoteSnapshotNotificationError } from './runtime.js';
 //# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAA;AAC1E,OAAO,EAAE,iBAAiB,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAA"}

package/dist/runtime/runtime.d.ts

@@ -1,4 +1,8 @@
 import type { SchemaEvaluationPort } from '../schema/port.js';
 import type { FormRuntime, FormRuntimeOptions } from './types.js';
+export declare class RemoteSnapshotNotificationError extends Error {
+    readonly notificationError: unknown;
+    constructor(notificationError: unknown);
+}
 export declare function createFormRuntime(port: SchemaEvaluationPort, options?: FormRuntimeOptions): FormRuntime;
 //# sourceMappingURL=runtime.d.ts.map

package/dist/runtime/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAe7D,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAGnB,MAAM,YAAY,CAAA;AAqJnB,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,oBAAoB,EAC1B,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CAufb"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAe7D,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAOnB,MAAM,YAAY,CAAA;AAInB,qBAAa,+BAAgC,SAAQ,KAAK;IAC5C,QAAQ,CAAC,iBAAiB,EAAE,OAAO;gBAA1B,iBAAiB,EAAE,OAAO;CAIhD;AA+SD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,oBAAoB,EAC1B,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CA4uBb"}