@stigmer/runner 3.0.1

package/dist/workflow-engine/expression.js

@@ -0,0 +1,366 @@
+/**
+ * Expression evaluation engine for CNCF Serverless Workflow runtime
+ * expressions. Runs OUTSIDE the Temporal workflow sandbox (in a local
+ * activity) using jq-wasm for evaluation.
+ *
+ * Supports:
+ * - Strict expression detection: `${ .some.path }`
+ * - Embedded expression interpolation: `"Hello ${ .name }!"`
+ * - Expression sanitization: strips `${` and `}` wrapper
+ * - Single expression evaluation via jq-wasm
+ * - Recursive tree traversal for evaluating expressions in nested objects
+ * - Conditional (if-statement) evaluation
+ * - uuid() preprocessing (jq-wasm has no custom function support)
+ * - Single-quote normalization (YAML ergonomic: `'approve'` → `"approve"`)
+ *
+ * NOTE: This module requires Node.js built-ins (crypto) and jq-wasm.
+ * It must ONLY be imported from activity code running outside the
+ * Temporal sandbox. Workflow-side code should import sandbox-safe
+ * utilities from `./expression-utils.js` instead.
+ */
+import * as jq from "jq-wasm";
+import { randomUUID } from "node:crypto";
+import { extractEmbeddedExpressions, hasEmbeddedExpressions, isStrictExpr, sanitizeExpr, stringifyInterpolatedValue, } from "./expression-utils.js";
+export { extractEmbeddedExpressions, hasEmbeddedExpressions, isStrictExpr, sanitizeExpr, stringifyInterpolatedValue, } from "./expression-utils.js";
+/**
+ * Interpolates all embedded `${ ... }` expressions within a string.
+ * Each expression is evaluated via jq and substituted in place.
+ *
+ * - `null` / `undefined` results become `""` (consistent with
+ *   `resolveRuntimePlaceholders` in resolve.ts).
+ * - Non-string results (objects, arrays, numbers) are JSON-stringified.
+ * - String results are inserted directly.
+ */
+export async function interpolateString(str, input, stateVars) {
+    const expressions = extractEmbeddedExpressions(str);
+    if (expressions.length === 0)
+        return str;
+    let result = "";
+    let lastEnd = 0;
+    for (const embedded of expressions) {
+        result += str.slice(lastEnd, embedded.start);
+        const value = await evaluateExpression(embedded.expr, input, stateVars);
+        result += stringifyInterpolatedValue(value);
+        lastEnd = embedded.end;
+    }
+    result += str.slice(lastEnd);
+    return result;
+}
+// ─────────────────────────────────────────────────────────────────────
+// Single-Quote Normalization
+// ─────────────────────────────────────────────────────────────────────
+/**
+ * Converts single-quoted string literals in a jq expression to
+ * double-quoted literals with proper JSON/jq escaping.
+ *
+ * jq only supports double-quoted strings (JSON-style). Single quotes
+ * have zero valid meaning in jq syntax. However, YAML workflow authors
+ * naturally write `'approve'` inside double-quoted YAML values because
+ * escaping double quotes in YAML is awkward:
+ *
+ *   when: "${ $context.outcome == 'approve' }"   ← natural
+ *   when: "${ $context.outcome == \"approve\" }"  ← ugly
+ *
+ * This function bridges that gap using a jq-aware lexer with four
+ * states (CODE, IN_DOUBLE_QUOTE, IN_SINGLE_QUOTE, COMMENT) to ensure:
+ *
+ * - Single quotes inside double-quoted jq strings are NOT converted
+ *   (e.g., `"it's"` is valid jq and remains unchanged)
+ * - Characters inside single-quoted content are treated as literal
+ *   (shell-style: `\` is a literal backslash, not an escape prefix)
+ * - Double quotes inside single-quoted content are escaped (`\"`)
+ * - Unclosed single quotes pass through unchanged (let jq report the
+ *   actual syntax error rather than masking it)
+ * - jq `#` comments are left alone
+ *
+ * Must run BEFORE preprocessUuid so that `'uuid'` becomes `"uuid"`
+ * (a quoted string literal) and is not matched by the uuid
+ * word-boundary pattern.
+ */
+export function normalizeSingleQuotedStrings(expr) {
+    if (!expr.includes("'"))
+        return expr;
+    const out = [];
+    let i = 0;
+    const len = expr.length;
+    while (i < len) {
+        const ch = expr[i];
+        if (ch === "#") {
+            // COMMENT: copy everything until end of line
+            while (i < len && expr[i] !== "\n") {
+                out.push(expr[i]);
+                i++;
+            }
+            continue;
+        }
+        if (ch === '"') {
+            // IN_DOUBLE_QUOTE: copy verbatim until unescaped closing "
+            out.push(ch);
+            i++;
+            while (i < len) {
+                const dqch = expr[i];
+                if (dqch === "\\") {
+                    out.push(dqch);
+                    i++;
+                    if (i < len) {
+                        out.push(expr[i]);
+                        i++;
+                    }
+                    continue;
+                }
+                out.push(dqch);
+                i++;
+                if (dqch === '"')
+                    break;
+            }
+            continue;
+        }
+        if (ch === "'") {
+            // IN_SINGLE_QUOTE: collect content until closing '
+            i++;
+            let content = "";
+            let closed = false;
+            while (i < len) {
+                if (expr[i] === "'") {
+                    closed = true;
+                    i++;
+                    break;
+                }
+                content += expr[i];
+                i++;
+            }
+            if (!closed) {
+                // Unclosed single quote — pass through unchanged for jq to report
+                out.push("'");
+                out.push(content);
+            }
+            else {
+                out.push(escapeForJqDoubleQuoted(content));
+            }
+            continue;
+        }
+        // CODE: pass through
+        out.push(ch);
+        i++;
+    }
+    return out.join("");
+}
+/**
+ * Encodes a raw string as a jq/JSON double-quoted literal. All
+ * characters are treated as literal (shell-style single-quote
+ * semantics): backslashes, double quotes, and control characters
+ * are escaped for jq compatibility.
+ */
+function escapeForJqDoubleQuoted(content) {
+    let out = '"';
+    for (const ch of content) {
+        switch (ch) {
+            case '"':
+                out += '\\"';
+                break;
+            case "\\":
+                out += "\\\\";
+                break;
+            case "\n":
+                out += "\\n";
+                break;
+            case "\r":
+                out += "\\r";
+                break;
+            case "\t":
+                out += "\\t";
+                break;
+            case "\b":
+                out += "\\b";
+                break;
+            case "\f":
+                out += "\\f";
+                break;
+            default: {
+                const code = ch.charCodeAt(0);
+                if (code < 0x20) {
+                    out += "\\u" + code.toString(16).padStart(4, "0");
+                }
+                else {
+                    out += ch;
+                }
+                break;
+            }
+        }
+    }
+    return out + '"';
+}
+// ─────────────────────────────────────────────────────────────────────
+// UUID Preprocessing
+// ─────────────────────────────────────────────────────────────────────
+const UUID_PATTERN = /\buuid\b/g;
+/**
+ * Replaces all occurrences of `uuid` in a jq expression with a
+ * generated UUID string literal. jq-wasm doesn't support custom
+ * function registration (Go uses `gojq.WithFunction("uuid", ...)`),
+ * so we pre-process before evaluation.
+ */
+export function preprocessUuid(expr) {
+    let hadUuid = false;
+    const processed = expr.replace(UUID_PATTERN, () => {
+        hadUuid = true;
+        return `"${randomUUID()}"`;
+    });
+    return { expr: processed, hadUuid };
+}
+// ─────────────────────────────────────────────────────────────────────
+// Single Expression Evaluation
+// ─────────────────────────────────────────────────────────────────────
+/**
+ * Evaluates a single jq expression against an input value, with
+ * state variables available as jq `$variable` bindings.
+ *
+ * The state variables map provides `$context`, `$data`, `$env`,
+ * `$input`, `$output` — matching the workflow state model.
+ *
+ * @param expr - Raw jq expression (already sanitized, no `${ }` wrapper)
+ * @param input - The jq input value (`.` in jq)
+ * @param stateVars - Map of `$variable` → value for jq variable bindings
+ */
+export async function evaluateExpression(expr, input, stateVars) {
+    const normalized = normalizeSingleQuotedStrings(expr);
+    const { expr: processedExpr } = preprocessUuid(normalized);
+    const wrappedExpr = buildVariableBindingExpr(processedExpr, stateVars);
+    const jqInput = buildJqInput(input, stateVars);
+    const result = await jq.json(jqInput, wrappedExpr);
+    return result;
+}
+/**
+ * Wraps a jq expression with variable bindings by constructing a
+ * combined input object and piping through `.as $var` assignments.
+ *
+ * For state vars `{ $context: {...}, $data: {...} }`, produces:
+ * ```
+ * .__vars__.$context as $context | .__vars__.$data as $data | ... | .__body__ | <expr>
+ * ```
+ *
+ * The actual jq input becomes `{ __body__: <original input>, __vars__: <stateVars> }`.
+ */
+function buildVariableBindingExpr(expr, stateVars) {
+    const varNames = Object.keys(stateVars);
+    if (varNames.length === 0)
+        return expr;
+    const bindings = varNames
+        .map((name) => `.__vars__.["${name}"] as ${name}`)
+        .join(" | ");
+    return `${bindings} | .__body__ | ${expr}`;
+}
+/**
+ * Wraps the input value with state variables for jq evaluation.
+ * The jq expression produced by `buildVariableBindingExpr` expects
+ * this shape.
+ */
+export function buildJqInput(input, stateVars) {
+    if (Object.keys(stateVars).length === 0)
+        return (input ?? {});
+    return {
+        __body__: input ?? {},
+        __vars__: stateVars,
+    };
+}
+// ─────────────────────────────────────────────────────────────────────
+// Batch Expression Evaluation
+// ─────────────────────────────────────────────────────────────────────
+/**
+ * Evaluates multiple expressions in a single call. Each expression
+ * is evaluated independently against the same input and state.
+ *
+ * Used by the local activity to batch-evaluate all expressions
+ * needed by a task in one round-trip.
+ */
+export async function evaluateExpressionBatch(expressions, input, stateVars) {
+    const results = {};
+    const entries = Object.entries(expressions);
+    for (const [key, expr] of entries) {
+        results[key] = await evaluateExpression(expr, input, stateVars);
+    }
+    return results;
+}
+// ─────────────────────────────────────────────────────────────────────
+// String Evaluation (detect + evaluate if expression)
+// ─────────────────────────────────────────────────────────────────────
+/**
+ * Evaluates a string value using a three-step chain:
+ *
+ * 1. **Strict**: If the entire string is `${ expr }`, evaluate via
+ *    jq and return the result (may be any type — object, number, etc.).
+ * 2. **Embedded**: If the string contains `${ expr }` fragments within
+ *    larger text, interpolate each fragment and return a string.
+ * 3. **Passthrough**: Return the string unchanged.
+ *
+ * The CNCF Serverless Workflow 1.0.0 spec demonstrates embedded
+ * expressions in multi-line strings (e.g., HTTP body templates).
+ */
+export async function evaluateString(str, input, stateVars) {
+    if (isStrictExpr(str)) {
+        return evaluateExpression(sanitizeExpr(str), input, stateVars);
+    }
+    if (hasEmbeddedExpressions(str)) {
+        return interpolateString(str, input, stateVars);
+    }
+    return str;
+}
+// ─────────────────────────────────────────────────────────────────────
+// Recursive Tree Traversal
+// ─────────────────────────────────────────────────────────────────────
+/**
+ * Recursively walks a value tree, evaluating any string expression
+ * (`${ ... }`) found at any depth. Maps and arrays are traversed
+ * recursively; strings are checked for expressions; all other types
+ * pass through unchanged.
+ *
+ * Originally ported from Go's `utils.TraverseAndEvaluateObj` (now deleted).
+ *
+ * IMPORTANT: Mutates the input object in place (maps and arrays).
+ * Clone before calling if you need the original preserved.
+ */
+export async function traverseAndEvaluate(node, input, stateVars) {
+    if (node === null || node === undefined)
+        return node;
+    if (typeof node === "string") {
+        return evaluateString(node, input, stateVars);
+    }
+    if (Array.isArray(node)) {
+        for (let i = 0; i < node.length; i++) {
+            node[i] = await traverseAndEvaluate(node[i], input, stateVars);
+        }
+        return node;
+    }
+    if (typeof node === "object") {
+        const obj = node;
+        for (const key of Object.keys(obj)) {
+            obj[key] = await traverseAndEvaluate(obj[key], input, stateVars);
+        }
+        return obj;
+    }
+    return node;
+}
+// ─────────────────────────────────────────────────────────────────────
+// Conditional (If-Statement) Evaluation
+// ─────────────────────────────────────────────────────────────────────
+/**
+ * Evaluates a task's `if` condition. Returns true if:
+ * - No condition is specified (task always runs)
+ * - The expression evaluates to `true` (boolean)
+ * - The expression evaluates to "TRUE" (case-insensitive string)
+ * - The expression evaluates to "1"
+ *
+ * Originally ported from Go's `utils.CheckIfStatement` (now deleted).
+ */
+export async function checkIfStatement(ifExpr, input, stateVars) {
+    if (ifExpr === undefined || ifExpr === null)
+        return true;
+    const result = await evaluateString(ifExpr, input, stateVars);
+    if (typeof result === "boolean")
+        return result;
+    if (typeof result === "string") {
+        return result.toUpperCase() === "TRUE" || result === "1";
+    }
+    return false;
+}
+//# sourceMappingURL=expression.js.map

package/dist/workflow-engine/expression.js.map

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

package/dist/workflow-engine/loader.d.ts

@@ -0,0 +1,23 @@
+/**
+ * YAML workflow loader — parses a CNCF Serverless Workflow DSL 1.0.0
+ * document from YAML into our serializable WorkflowModel.
+ *
+ * Runs outside the Temporal workflow sandbox (activity-side).
+ * The parsed model is passed as input to the workflow function.
+ *
+ * Design decision (DD-W02): We parse YAML directly and build our
+ * own WorkflowModel types rather than using the CNCF SDK classes.
+ * This avoids the SDK's strict Ajv validation issues (rejects
+ * `document.description`) and decouples us from SDK version changes.
+ *
+ * Mirrors Go's `loader.go`: YAML → JSON → model with DSL version check.
+ */
+import type { WorkflowModel } from "./types.js";
+/**
+ * Parses a YAML string into a WorkflowModel. Validates the DSL
+ * version and discriminates task types into our typed union.
+ *
+ * @throws Error if YAML is invalid, DSL version is unsupported,
+ *         or the document structure is malformed.
+ */
+export declare function loadWorkflowFromYaml(yamlContent: string): WorkflowModel;