yaml-flow 5.4.2 → 7.0.0

package/dist/card-compute/index.d.cts

@@ -103,11 +103,31 @@ interface ComputeNode {
  *   In browser:  passed in by the caller (e.g. from fetch results).
  */
 declare function run(node: ComputeNode, options?: RunOptions): Promise<ComputeNode>;
+/**
+ * Synchronous version of run() — uses a vendored sync JSONata build
+ * (async/await stripped from jsonata.js since all built-in functions
+ * are CPU-only).
+ *
+ * Same semantics as `run()`: evaluates all compute steps, populates
+ * `node.computed_values`, returns the mutated node.
+ *
+ * @returns `{ ok: true, node }` when all steps evaluated successfully.
+ *          `{ ok: false, node }` is currently never returned but reserved
+ *          for future use if an expression requires true async evaluation.
+ */
+declare function runSync(node: ComputeNode, options?: RunOptions): {
+    ok: boolean;
+    node: ComputeNode;
+    errors?: Array<{
+        bindTo: string;
+        error: string;
+    }>;
+};
 /**
  * Evaluate a single JSONata expression against a node's context.
  * Context is { card_data, requires, fetched_sources, computed_values }.
  */
-declare function evalExpr(expr: string, node: ComputeNode): Promise<unknown>;
+declare function evalExpr(expr: string, node: ComputeNode, vars?: Record<string, unknown>): Promise<unknown>;
 declare function resolve(node: ComputeNode, path: string): unknown;
 /** Result of validateNode — ok: true means valid, ok: false has errors[]. */
 interface ValidationResult {
@@ -130,12 +150,18 @@ declare function enrichSources(source_defs: any[] | undefined, context: {
     sourcesData?: Record<string, any>;
     computed_values?: Record<string, any>;
 }): Promise<any[]>;
+declare function enrichSourcesSync(source_defs: any[] | undefined, context: {
+    card_data?: Record<string, any>;
+    requires?: Record<string, any>;
+}): any[];
 declare const CardCompute: {
     run: typeof run;
+    runSync: typeof runSync;
     eval: typeof evalExpr;
     resolve: typeof resolve;
     validate: typeof validateNode;
     enrichSources: typeof enrichSources;
+    enrichSourcesSync: typeof enrichSourcesSync;
 };
 
 export { CardCompute, type ComputeNode, type ComputeSource, type ComputeStep, type RunOptions, type ValidationResult, CardCompute as default, validateLiveCard, validateLiveCardDefinition, validateLiveCardRuntimeExpressions, validateLiveCardSchema };

package/dist/card-compute/index.d.ts

@@ -103,11 +103,31 @@ interface ComputeNode {
  *   In browser:  passed in by the caller (e.g. from fetch results).
  */
 declare function run(node: ComputeNode, options?: RunOptions): Promise<ComputeNode>;
+/**
+ * Synchronous version of run() — uses a vendored sync JSONata build
+ * (async/await stripped from jsonata.js since all built-in functions
+ * are CPU-only).
+ *
+ * Same semantics as `run()`: evaluates all compute steps, populates
+ * `node.computed_values`, returns the mutated node.
+ *
+ * @returns `{ ok: true, node }` when all steps evaluated successfully.
+ *          `{ ok: false, node }` is currently never returned but reserved
+ *          for future use if an expression requires true async evaluation.
+ */
+declare function runSync(node: ComputeNode, options?: RunOptions): {
+    ok: boolean;
+    node: ComputeNode;
+    errors?: Array<{
+        bindTo: string;
+        error: string;
+    }>;
+};
 /**
  * Evaluate a single JSONata expression against a node's context.
  * Context is { card_data, requires, fetched_sources, computed_values }.
  */
-declare function evalExpr(expr: string, node: ComputeNode): Promise<unknown>;
+declare function evalExpr(expr: string, node: ComputeNode, vars?: Record<string, unknown>): Promise<unknown>;
 declare function resolve(node: ComputeNode, path: string): unknown;
 /** Result of validateNode — ok: true means valid, ok: false has errors[]. */
 interface ValidationResult {
@@ -130,12 +150,18 @@ declare function enrichSources(source_defs: any[] | undefined, context: {
     sourcesData?: Record<string, any>;
     computed_values?: Record<string, any>;
 }): Promise<any[]>;
+declare function enrichSourcesSync(source_defs: any[] | undefined, context: {
+    card_data?: Record<string, any>;
+    requires?: Record<string, any>;
+}): any[];
 declare const CardCompute: {
     run: typeof run;
+    runSync: typeof runSync;
     eval: typeof evalExpr;
     resolve: typeof resolve;
     validate: typeof validateNode;
     enrichSources: typeof enrichSources;
+    enrichSourcesSync: typeof enrichSourcesSync;
 };
 
 export { CardCompute, type ComputeNode, type ComputeSource, type ComputeStep, type RunOptions, type ValidationResult, CardCompute as default, validateLiveCard, validateLiveCardDefinition, validateLiveCardRuntimeExpressions, validateLiveCardSchema };