@decaf-ts/ui-decorators 0.19.0 → 0.20.0

package/lib/esm/graph/document/GraphJsonValue.js

@@ -0,0 +1,73 @@
+export const GRAPH_UNSAFE_OBJECT_KEYS = [
+    "__proto__",
+    "prototype",
+    "constructor",
+];
+export function isGraphUnsafeObjectKey(key) {
+    return GRAPH_UNSAFE_OBJECT_KEYS.includes(key);
+}
+function isPlainJsonObject(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+export function isGraphJsonPrimitive(value) {
+    return (value === null ||
+        typeof value === "string" ||
+        (typeof value === "number" && Number.isFinite(value)) ||
+        typeof value === "boolean");
+}
+export function isGraphJsonValue(value) {
+    if (isGraphJsonPrimitive(value))
+        return true;
+    if (Array.isArray(value)) {
+        return value.every((entry) => isGraphJsonValue(entry));
+    }
+    if (isPlainJsonObject(value)) {
+        return Reflect.ownKeys(value).every((key) => typeof key === "string" &&
+            !isGraphUnsafeObjectKey(key) &&
+            isGraphJsonValue(value[key]));
+    }
+    return false;
+}
+export function isGraphJsonSafeValue(value) {
+    if (value === undefined)
+        return false;
+    if (typeof value === "number")
+        return Number.isFinite(value);
+    if (typeof value === "function")
+        return false;
+    if (isGraphJsonValue(value))
+        return true;
+    if (Array.isArray(value)) {
+        return value.every((entry) => isGraphJsonSafeValue(entry));
+    }
+    if (isPlainJsonObject(value)) {
+        const keys = Reflect.ownKeys(value);
+        for (const key of keys) {
+            if (typeof key !== "string")
+                return false;
+            if (isGraphUnsafeObjectKey(key))
+                return false;
+            if (!isGraphJsonSafeValue(value[key])) {
+                return false;
+            }
+        }
+        return true;
+    }
+    return false;
+}
+export function cloneGraphJsonValue(value) {
+    if (value === null || typeof value !== "object")
+        return value;
+    if (Array.isArray(value)) {
+        return value.map((entry) => cloneGraphJsonValue(entry));
+    }
+    const cloned = {};
+    for (const [key, entry] of Object.entries(value)) {
+        cloned[key] = cloneGraphJsonValue(entry);
+    }
+    return cloned;
+}
+//# sourceMappingURL=GraphJsonValue.js.map

package/lib/esm/graph/document/GraphJsonValue.js.map

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

package/lib/esm/graph/document/GraphLoopConfiguration.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=GraphLoopConfiguration.js.map

package/lib/esm/graph/document/GraphLoopConfiguration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphLoopConfiguration.js","sourceRoot":"","sources":["../../../../src/graph/document/GraphLoopConfiguration.ts"],"names":[],"mappings":""}

package/lib/esm/graph/document/GraphNodeBinding.js

@@ -0,0 +1,22 @@
+import { isGraphJsonValue } from "./GraphJsonValue.js";
+export function isGraphInputBindingMode(value) {
+    return value === "edge" || value === "literal" || value === "expression";
+}
+export function isGraphInputBinding(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const mode = value["mode"];
+    if (mode === "edge")
+        return Reflect.ownKeys(value).length === 1;
+    if (mode === "literal") {
+        const value_ = value["value"];
+        return (Object.keys(value).length === 2 &&
+            isGraphJsonValue(value_));
+    }
+    if (mode === "expression") {
+        return (Object.keys(value).length === 2 &&
+            typeof value["expression"] === "string");
+    }
+    return false;
+}
+//# sourceMappingURL=GraphNodeBinding.js.map

package/lib/esm/graph/document/GraphNodeBinding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphNodeBinding.js","sourceRoot":"","sources":["../../../../src/graph/document/GraphNodeBinding.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,4BAAyB;AA6BpD,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,OAAO,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,YAAY,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,MAAM,IAAI,GAAI,KAAiC,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;IAChE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,MAAM,GAAI,KAAiC,CAAC,OAAO,CAAC,CAAC;QAC3D,OAAO,CACL,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC,MAAM,KAAK,CAAC;YAC1D,gBAAgB,CAAC,MAAM,CAAC,CACzB,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;QAC1B,OAAO,CACL,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC,MAAM,KAAK,CAAC;YAC1D,OAAQ,KAAiC,CAAC,YAAY,CAAC,KAAK,QAAQ,CACrE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/lib/esm/graph/document/GraphNodeInstance.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=GraphNodeInstance.js.map

package/lib/esm/graph/document/GraphNodeInstance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphNodeInstance.js","sourceRoot":"","sources":["../../../../src/graph/document/GraphNodeInstance.ts"],"names":[],"mappings":""}

package/lib/esm/graph/document/GraphWorkflowDocument.js

@@ -0,0 +1,12 @@
+export function isGraphWorkflowDocumentShape(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const record = value;
+    return (typeof record["id"] === "string" &&
+        typeof record["name"] === "string" &&
+        Array.isArray(record["inputs"]) &&
+        Array.isArray(record["outputs"]) &&
+        Array.isArray(record["nodes"]) &&
+        Array.isArray(record["edges"]));
+}
+//# sourceMappingURL=GraphWorkflowDocument.js.map

package/lib/esm/graph/document/GraphWorkflowDocument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphWorkflowDocument.js","sourceRoot":"","sources":["../../../../src/graph/document/GraphWorkflowDocument.ts"],"names":[],"mappings":"AA6BA,MAAM,UAAU,4BAA4B,CAAC,KAAc;IAQzD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,OAAO,CACL,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,QAAQ;QAChC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ;QAClC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/B,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC9B,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAC/B,CAAC;AACJ,CAAC"}

package/lib/esm/graph/document/GraphWorkflowDocumentBuilder.js

@@ -0,0 +1,261 @@
+import { ValidationError } from "@decaf-ts/db-decorators";
+import { isGraphJsonSafeValue, isGraphUnsafeObjectKey, } from "./GraphJsonValue.js";
+import { isGraphEndpoint, isGraphNodeEndpoint, isGraphWorkflowEndpoint } from "./GraphEndpoint.js";
+import { isGraphInputBinding } from "./GraphNodeBinding.js";
+import { isGraphValueSchema } from "./../catalog/GraphValueSchema.js";
+export class GraphWorkflowDocumentBuilder {
+    constructor(id, name) {
+        this.document = {
+            id,
+            name: name ?? "",
+            inputs: [],
+            outputs: [],
+            nodes: [],
+            edges: [],
+        };
+    }
+    addInput(port) {
+        this.document.inputs.push(port);
+        return this;
+    }
+    addOutput(port) {
+        this.document.outputs.push(port);
+        return this;
+    }
+    addNode(node) {
+        this.document.nodes.push({
+            ...node,
+            parameters: node.parameters ?? {},
+        });
+        return this;
+    }
+    addEdge(edge) {
+        this.document.edges.push(edge);
+        return this;
+    }
+    setSettings(settings) {
+        this.document.settings = settings;
+        return this;
+    }
+    setMetadata(metadata) {
+        this.document.metadata = metadata;
+        return this;
+    }
+    setUi(ui) {
+        this.document.ui = ui;
+        return this;
+    }
+    build() {
+        assertGraphWorkflowDocumentValid(this.document);
+        return {
+            id: this.document.id,
+            name: this.document.name,
+            inputs: this.document.inputs.map((port) => ({ ...port })),
+            outputs: this.document.outputs.map((port) => ({ ...port })),
+            nodes: this.document.nodes.map((node) => ({ ...node })),
+            edges: this.document.edges.map((edge) => ({ ...edge })),
+            settings: this.document.settings,
+            metadata: this.document.metadata,
+            ui: this.document.ui,
+        };
+    }
+}
+export function assertGraphWorkflowDocumentValid(document, context = { seen: [] }) {
+    if (context.seen.includes(document)) {
+        throw new ValidationError(`Document '${describeDocument(document)}' contains a loop body that references itself (cyclic document)`);
+    }
+    if (typeof document.id !== "string" || !document.id) {
+        throw new ValidationError("Document 'id' is required and must be a non-empty string");
+    }
+    if (typeof document.name !== "string" || !document.name) {
+        throw new ValidationError("Document 'name' is required and must be a non-empty string");
+    }
+    const workflowPorts = new Set();
+    for (const port of [...document.inputs, ...document.outputs]) {
+        if (typeof port.id !== "string" || !port.id) {
+            throw new ValidationError("Workflow port 'id' is required and must be a non-empty string");
+        }
+        if (workflowPorts.has(port.id)) {
+            throw new ValidationError(`Workflow port '${port.id}' is declared more than once; workflow port ids must be unique`);
+        }
+        if (port.schema !== undefined && !isGraphValueSchema(port.schema)) {
+            throw new ValidationError(`Workflow port '${port.id}' schema must be a valid GraphValueSchema`);
+        }
+        workflowPorts.add(port.id);
+    }
+    const nestedContext = {
+        seen: [...context.seen, document],
+    };
+    const nodeIds = new Set();
+    for (const node of document.nodes) {
+        assertGraphNodeValid(node, nodeIds);
+    }
+    for (const node of document.nodes) {
+        if (node.loop) {
+            assertGraphLoopConfigurationValid(node, node.loop, nestedContext);
+        }
+    }
+    const edgeIds = new Set();
+    for (const edge of document.edges) {
+        assertGraphEdgeValid(edge, edgeIds);
+    }
+    for (const edge of document.edges) {
+        assertEdgeEndpoint(edge.source, document, workflowPorts, nodeIds, `Edge '${edge.id}' source`);
+        assertEdgeEndpoint(edge.target, document, workflowPorts, nodeIds, `Edge '${edge.id}' target`);
+    }
+    if (document.settings !== undefined && !isGraphJsonSafeValue(document.settings)) {
+        throw new ValidationError("Document settings must be JSON-safe (a map of JSON-safe values)");
+    }
+    if (document.metadata !== undefined && !isGraphJsonSafeValue(document.metadata)) {
+        throw new ValidationError("Document metadata must be JSON-safe: functions, class instances, undefined, NaN/Infinity, symbol keys, or unsafe prototype keys are not allowed");
+    }
+    if (document.ui !== undefined && !isGraphJsonSafeValue(document.ui)) {
+        throw new ValidationError("Document ui must be JSON-safe: functions, class instances, undefined, NaN/Infinity, symbol keys, or unsafe prototype keys are not allowed");
+    }
+}
+function describeDocument(document) {
+    const id = document?.["id"];
+    return typeof id === "string" ? id : "<unnamed document>";
+}
+function assertGraphNodeValid(node, nodeIds) {
+    if (typeof node.id !== "string" || !node.id) {
+        throw new ValidationError("Node 'id' is required and must be a non-empty string");
+    }
+    if (nodeIds.has(node.id)) {
+        throw new ValidationError(`Node id '${node.id}' is declared more than once; node ids must be unique`);
+    }
+    if (typeof node.kind !== "string" || !node.kind) {
+        throw new ValidationError(`Node '${node.id}' must declare a non-empty string 'kind'`);
+    }
+    if (node.parameters === undefined || node.parameters === null) {
+        throw new ValidationError(`Node '${node.id}' parameters must be present (an empty object when there are none)`);
+    }
+    nodeIds.add(node.id);
+    if (node.inputBindings) {
+        for (const [key, binding] of Object.entries(node.inputBindings)) {
+            if (isGraphUnsafeObjectKey(key)) {
+                throw new ValidationError(`Node '${node.id}' input binding key '${key}' is not allowed (unsafe prototype-pollutant key)`);
+            }
+            if (!isGraphInputBinding(binding)) {
+                throw new ValidationError(`Node '${node.id}' input binding for '${key}' must be a valid GraphInputBinding (edge, literal, or expression)`);
+            }
+            if (binding.mode === "literal" && !isGraphJsonSafeValue(binding.value)) {
+                throw new ValidationError(`Node '${node.id}' literal binding for '${key}' must contain JSON-safe values`);
+            }
+            if (binding.mode === "expression" && !binding.expression) {
+                throw new ValidationError(`Node '${node.id}' expression binding for '${key}' must contain a non-empty expression`);
+            }
+        }
+    }
+    if (node.outputBindings) {
+        for (const [key, binding] of Object.entries(node.outputBindings)) {
+            if (isGraphUnsafeObjectKey(key)) {
+                throw new ValidationError(`Node '${node.id}' output binding key '${key}' is not allowed (unsafe prototype-pollutant key)`);
+            }
+            if (!binding || typeof binding !== "object" || Array.isArray(binding)) {
+                throw new ValidationError(`Node '${node.id}' output binding for '${key}' must be an object with enabled and alias settings`);
+            }
+        }
+    }
+    if (!isGraphJsonSafeValue(node.parameters)) {
+        throw new ValidationError(`Node '${node.id}' parameters must be JSON-safe: functions, class instances, undefined, NaN/Infinity, symbol keys, or unsafe prototype keys are not allowed`);
+    }
+}
+function assertGraphLoopConfigurationValid(node, config, context) {
+    if (!config.body || typeof config.body !== "object") {
+        throw new ValidationError(`Node '${node.id}' loop configuration requires a body document`);
+    }
+    assertGraphWorkflowDocumentValid(config.body, context);
+    if (config.maxIterations !== undefined &&
+        (!Number.isFinite(config.maxIterations) || config.maxIterations <= 0)) {
+        throw new ValidationError(`Node '${node.id}' loop maxIterations must be a positive number`);
+    }
+    if (config.timeoutMs !== undefined &&
+        (typeof config.timeoutMs !== "number" || config.timeoutMs <= 0)) {
+        throw new ValidationError(`Node '${node.id}' loop timeoutMs must be a positive number in milliseconds`);
+    }
+    if (config.concurrency !== undefined &&
+        (typeof config.concurrency !== "number" || config.concurrency <= 0)) {
+        throw new ValidationError(`Node '${node.id}' loop concurrency must be a positive number`);
+    }
+    for (const mappings of [config.inputMappings, config.outputMappings]) {
+        if (!mappings)
+            continue;
+        for (const [key, reference] of Object.entries(mappings)) {
+            if (isGraphUnsafeObjectKey(key)) {
+                throw new ValidationError(`Node '${node.id}' loop mapping key '${key}' is not allowed (unsafe prototype-pollutant key)`);
+            }
+            assertGraphValueReferenceShape(reference, node.id, key);
+        }
+    }
+}
+function assertGraphValueReferenceShape(reference, nodeId, mappingKey) {
+    if (!reference || typeof reference !== "object") {
+        throw new ValidationError(`Node '${nodeId}' loop mapping '${mappingKey}' must reference a workflow port, node port, literal, or expression`);
+    }
+    switch (reference.source) {
+        case "workflow":
+            if (typeof reference.port !== "string" || !reference.port) {
+                throw new ValidationError(`Node '${nodeId}' loop mapping '${mappingKey}' referencing a workflow must reference a port identifier`);
+            }
+            break;
+        case "node":
+            if (typeof reference.nodeId !== "string" ||
+                !reference.nodeId ||
+                typeof reference.port !== "string" ||
+                !reference.port) {
+                throw new ValidationError(`Node '${nodeId}' loop mapping '${mappingKey}' referencing a node must reference a node id and a port`);
+            }
+            break;
+        case "literal":
+            if (!isGraphJsonSafeValue(reference.value)) {
+                throw new ValidationError(`Node '${nodeId}' loop mapping '${mappingKey}' literal references must be JSON-safe values`);
+            }
+            break;
+        case "expression":
+            if (typeof reference.expression !== "string" || !reference.expression) {
+                throw new ValidationError(`Node '${nodeId}' loop mapping '${mappingKey}' expression references must be non-empty expressions`);
+            }
+            break;
+        default:
+            throw new ValidationError(`Node '${nodeId}' loop mapping '${mappingKey}' must use a workflow, node, literal, or expression reference source`);
+    }
+}
+function assertGraphEdgeValid(edge, edgeIds) {
+    if (typeof edge.id !== "string" || !edge.id) {
+        throw new ValidationError("Edge 'id' is required and must be a non-empty string");
+    }
+    if (edgeIds.has(edge.id)) {
+        throw new ValidationError(`Edge id '${edge.id}' is declared more than once; edge ids must be unique`);
+    }
+    if (!isGraphEndpoint(edge.source)) {
+        throw new ValidationError(`Edge '${edge.id}' source endpoint is not a valid GraphEndpoint`);
+    }
+    if (!isGraphEndpoint(edge.target)) {
+        throw new ValidationError(`Edge '${edge.id}' target endpoint is not a valid GraphEndpoint`);
+    }
+    if (edge.type !== "data" && edge.type !== "connection") {
+        throw new ValidationError(`Edge '${edge.id}' type '${String(edge.type)}' is not a valid edge type (data or connection are allowed)`);
+    }
+    edgeIds.add(edge.id);
+    if (!isGraphJsonSafeValue(edge)) {
+        throw new ValidationError(`Edge '${edge.id}' contains values that are not JSON-safe: functions, class instances, undefined, NaN/Infinity, symbol keys, or unsafe prototype keys are not allowed`);
+    }
+}
+function assertEdgeEndpoint(endpoint, document, workflowPorts, nodeIds, context) {
+    if (isGraphWorkflowEndpoint(endpoint)) {
+        if (!workflowPorts.has(endpoint.port)) {
+            throw new ValidationError(`${context} references workflow port '${endpoint.port}' which is not declared on the document`);
+        }
+        return;
+    }
+    if (isGraphNodeEndpoint(endpoint)) {
+        if (!nodeIds.has(endpoint.nodeId)) {
+            throw new ValidationError(`${context} references node '${endpoint.nodeId}' which is not part of the document`);
+        }
+        if (typeof endpoint.port !== "string" || !endpoint.port) {
+            throw new ValidationError(`${context} node endpoints must reference a non-empty port identifier`);
+        }
+    }
+}
+//# sourceMappingURL=GraphWorkflowDocumentBuilder.js.map

package/lib/esm/graph/document/GraphWorkflowDocumentBuilder.js.map

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

package/lib/esm/graph/document/GraphWorkflowDocumentReader.js

@@ -0,0 +1,62 @@
+import { isGraphUnsafeObjectKey } from "./GraphJsonValue.js";
+import { isGraphWorkflowDocumentShape } from "./GraphWorkflowDocument.js";
+export function graphWorkflowDocumentOf(value) {
+    if (!isGraphWorkflowDocumentShape(value))
+        return undefined;
+    return value;
+}
+export function graphWorkflowNodeOf(document, nodeId) {
+    return document?.nodes.find((node) => node.id === nodeId);
+}
+export function graphWorkflowEdgeOf(document, edgeId) {
+    return document?.edges.find((edge) => edge.id === edgeId);
+}
+export function graphWorkflowPortsOf(document) {
+    const inputs = document?.inputs ?? [];
+    const outputs = document?.outputs ?? [];
+    return { inputs, outputs };
+}
+export function graphWorkflowSettingsOf(document) {
+    return { ...(document?.settings ?? {}) };
+}
+export function graphWorkflowEdgesOf(document) {
+    return document?.edges ?? [];
+}
+export function graphWorkflowNodeEdgesOf(document, nodeId) {
+    return (document?.edges ?? []).filter((edge) => graphNodeEndpointId(edge.source) === nodeId || graphNodeEndpointId(edge.target) === nodeId);
+}
+export function graphNodeEndpointId(endpoint) {
+    if (endpoint && endpoint.scope === "node") {
+        return endpoint.nodeId;
+    }
+    return undefined;
+}
+export function graphWorkflowNodeUiOf(document, nodeId) {
+    return graphWorkflowNodeOf(document, nodeId)?.ui;
+}
+export function graphWorkflowUiOf(document) {
+    return document.ui ?? undefined;
+}
+export function graphWorkflowUiValueOf(document, key) {
+    const ui = graphWorkflowUiOf(document);
+    if (!ui || isGraphUnsafeObjectKey(key))
+        return undefined;
+    return ui[key];
+}
+export function graphWorkflowDocumentSettingOf(document, key) {
+    return hasSetting(document?.settings, key)
+        ? document.settings[key]
+        : undefined;
+}
+export function graphWorkflowDocumentMetadataValueOf(document, key) {
+    if (!document?.metadata ||
+        isGraphUnsafeObjectKey(key) ||
+        !(key in document.metadata)) {
+        return undefined;
+    }
+    return document.metadata[key];
+}
+function hasSetting(settings, key) {
+    return Boolean(settings) && !isGraphUnsafeObjectKey(key) && key in settings;
+}
+//# sourceMappingURL=GraphWorkflowDocumentReader.js.map

package/lib/esm/graph/document/GraphWorkflowDocumentReader.js.map

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

package/lib/esm/graph/document/GraphWorkflowDocumentSerializer.js

@@ -0,0 +1,63 @@
+import { ValidationError } from "@decaf-ts/db-decorators";
+import { isGraphJsonSafeValue } from "./GraphJsonValue.js";
+import { isGraphWorkflowDocumentShape } from "./GraphWorkflowDocument.js";
+import { assertGraphWorkflowDocumentValid } from "./GraphWorkflowDocumentBuilder.js";
+export function graphWorkflowDocumentSerializer(document) {
+    if (!isGraphWorkflowDocumentShape(document)) {
+        throw new ValidationError("Cannot serialize a graph workflow document: the value is not a canonical GraphWorkflowDocument shape");
+    }
+    try {
+        return JSON.stringify(document, null, 2);
+    }
+    catch (e) {
+        throw new ValidationError(`Cannot serialize graph workflow document '${document.id}': ${String(e)}`);
+    }
+}
+export function graphWorkflowDocumentDeserializer(serialised) {
+    let parsed;
+    try {
+        parsed = JSON.parse(serialised);
+    }
+    catch (e) {
+        throw new ValidationError(`Serialized graph workflow document is not valid JSON: ${String(e)}`);
+    }
+    if (!isGraphJsonSafeValue(parsed)) {
+        throw new ValidationError("Serialized graph workflow document contains JSON-unsafe values: functions, non-JSON objects, NaN/Infinity, symbol keys, unsafe prototype keys are rejected");
+    }
+    if (!isGraphWorkflowDocumentShape(parsed)) {
+        throw new ValidationError("Serialized graph workflow document is not shaped as a canonical GraphWorkflowDocument (id, name, inputs, outputs, nodes and edges are required)");
+    }
+    const document = parsed;
+    assertGraphWorkflowDocumentValid(document);
+    return document;
+}
+export function graphJsonSerializer(value, indentation) {
+    if (!isGraphJsonSafeValue(value)) {
+        throw new ValidationError("Cannot serialize a value: functions, class instances, undefined, NaN/Infinity, symbol keys, unsafe prototype keys, or cycles are not allowed");
+    }
+    try {
+        return JSON.stringify(value, null, indentation);
+    }
+    catch (e) {
+        throw new ValidationError(`Cannot serialize JSON-safe value: ${String(e)} (cycles and circular structures are not allowed inside graph JSON)`);
+    }
+}
+export function graphJsonParser(serialised) {
+    if (typeof serialised !== "string") {
+        if (typeof serialised === "object" && serialised !== null)
+            return serialised;
+        throw new ValidationError("Graph JSON parser accepts serialized strings (pass an object only when restoring a known-safe value)");
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(serialised);
+    }
+    catch (e) {
+        throw new ValidationError(`Serialized graph JSON is not valid JSON: ${String(e)}`);
+    }
+    if (!isGraphJsonSafeValue(parsed)) {
+        throw new ValidationError("Serialized graph JSON contains JSON-unsafe values: functions, non-JSON objects, NaN/Infinity, symbol keys, unsafe prototype keys are rejected");
+    }
+    return parsed;
+}
+//# sourceMappingURL=GraphWorkflowDocumentSerializer.js.map

package/lib/esm/graph/document/GraphWorkflowDocumentSerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphWorkflowDocumentSerializer.js","sourceRoot":"","sources":["../../../../src/graph/document/GraphWorkflowDocumentSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,4BAAyB;AAExD,OAAO,EAAE,4BAA4B,EAAE,mCAAgC;AACvE,OAAO,EAAE,gCAAgC,EAAE,0CAAuC;AAElF,MAAM,UAAU,+BAA+B,CAC7C,QAA+B;IAE/B,IAAI,CAAC,4BAA4B,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,eAAe,CACvB,sGAAsG,CACvG,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,eAAe,CACvB,6CAA6C,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC,CAAC,CAAC,EAAE,CAC1E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,UAAkB;IAElB,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,eAAe,CACvB,yDAAyD,MAAM,CAAC,CAAC,CAAC,EAAE,CACrE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,eAAe,CACvB,4JAA4J,CAC7J,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,4BAA4B,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,eAAe,CACvB,iJAAiJ,CAClJ,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,MAA0C,CAAC;IAC5D,gCAAgC,CAAC,QAAQ,CAAC,CAAC;IAC3C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc,EAAE,WAAoB;IACtE,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,eAAe,CACvB,8IAA8I,CAC/I,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,eAAe,CACvB,qCAAqC,MAAM,CAAC,CAAC,CAAC,qEAAqE,CACpH,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,UAA4B;IAC1D,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,IAAI;YAAE,OAAO,UAAU,CAAC;QAC7E,MAAM,IAAI,eAAe,CACvB,sGAAsG,CACvG,CAAC;IACJ,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,eAAe,CACvB,4CAA4C,MAAM,CAAC,CAAC,CAAC,EAAE,CACxD,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,eAAe,CACvB,+IAA+I,CAChJ,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/esm/graph/document/GraphWorkflowUiState.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=GraphWorkflowUiState.js.map

package/lib/esm/graph/document/GraphWorkflowUiState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphWorkflowUiState.js","sourceRoot":"","sources":["../../../../src/graph/document/GraphWorkflowUiState.ts"],"names":[],"mappings":""}

package/lib/esm/graph/document/index.js

@@ -0,0 +1,13 @@
+export * from "./GraphDecoratedWorkflowCompiler.js";
+export * from "./GraphEdgeInstance.js";
+export * from "./GraphEndpoint.js";
+export * from "./GraphJsonValue.js";
+export * from "./GraphLoopConfiguration.js";
+export * from "./GraphNodeBinding.js";
+export * from "./GraphNodeInstance.js";
+export * from "./GraphWorkflowDocument.js";
+export * from "./GraphWorkflowDocumentBuilder.js";
+export * from "./GraphWorkflowDocumentReader.js";
+export * from "./GraphWorkflowDocumentSerializer.js";
+export * from "./GraphWorkflowUiState.js";
+//# sourceMappingURL=index.js.map

package/lib/esm/graph/document/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/graph/document/index.ts"],"names":[],"mappings":"AAAA,oDAAiD;AACjD,uCAAoC;AACpC,mCAAgC;AAChC,oCAAiC;AACjC,4CAAyC;AACzC,sCAAmC;AACnC,uCAAoC;AACpC,2CAAwC;AACxC,kDAA+C;AAC/C,iDAA8C;AAC9C,qDAAkD;AAClD,0CAAuC"}

package/lib/esm/graph/index.js

@@ -6,6 +6,8 @@ export * from "./registry.js";
 export * from "./overrides/index.js";
 export * from "./snapshot.js";
 export * from "./reader.js";
+export * from "./document/index.js";
+export * from "./catalog/index.js";
 export * from "./types.js";
 export * from "./overrides/index.js";
 //# sourceMappingURL=index.js.map

package/lib/esm/graph/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/graph/index.ts"],"names":[],"mappings":"AAAA,iCAAsB;AACtB,8BAAqB;AAErB,+BAA4B;AAC5B,gCAA6B;AAC7B,8BAA2B;AAC3B,qCAA4B;AAC5B,8BAA2B;AAC3B,4BAAyB;AACzB,2BAAwB;AACxB,qCAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/graph/index.ts"],"names":[],"mappings":"AAAA,iCAAsB;AACtB,8BAAqB;AAErB,+BAA4B;AAC5B,gCAA6B;AAC7B,8BAA2B;AAC3B,qCAA4B;AAC5B,8BAA2B;AAC3B,4BAAyB;AACzB,oCAA2B;AAC3B,mCAA0B;AAC1B,2BAAwB;AACxB,qCAA4B"}