@fluidgrids/workflows 0.0.0-stage → 2026.1027.0

package/dist/lower-DcOY8ux0.d.cts

@@ -0,0 +1,49 @@
+import * as esbuild from 'esbuild';
+import { S as SourceFile } from './hash-CZkTXPCX.cjs';
+import { W as WorkflowDefinition } from './types-Dr2Fn1Ax.cjs';
+import { h as ConnectionResolver } from './assemble-BJo9TECS.cjs';
+
+/** The esbuild API surface lower() uses (`esbuild` or `esbuild-wasm`, version 0.28.2). */
+type EsbuildApi = Pick<typeof esbuild, 'build' | 'transform'>;
+/** Runs a bundle and returns the string value of its `__fluidgrids` export. */
+interface Evaluator {
+    /** `esm`: the bundle as built; `iife`: a script assigning the exports to `__fluidgridsBundle`. */
+    readonly format: 'esm' | 'iife';
+    evaluate(code: string): Promise<string>;
+}
+declare const EVALUATION_GLOBAL = "__fluidgridsBundle";
+declare const ESBUILD_VERSION = "0.28.2";
+declare class LowerError extends Error {
+    constructor(message: string);
+}
+interface LowerOptions {
+    /** Modules to evaluate. Default: every `.ts` file outside `.fluidgrids/`, except tests and declarations. */
+    entries?: readonly string[];
+    esbuild?: EsbuildApi;
+    evaluator?: Evaluator;
+    connections?: ConnectionResolver;
+    /** Largest JSON the evaluation may return. Default 16 MiB. */
+    maxOutputBytes?: number;
+}
+interface LoweredWorkflow {
+    key: string;
+    module: string;
+    exportName: string;
+    definition: WorkflowDefinition;
+}
+interface LowerResult {
+    /** `sha256:<hex>` of the bundle. */
+    buildId: string;
+    bundle: string;
+    /** `sha256:<hex>` of the source files. */
+    sourceHash: string;
+    workflows: LoweredWorkflow[];
+}
+/** The default entry modules: workflow sources, not generated clients, tests or declarations. */
+declare function defaultEntries(paths: readonly string[]): string[];
+/** Bundle a project. Exported so services can compute `buildId` without evaluating. */
+declare function bundleProject(files: ReadonlyMap<string, string>, entries: readonly string[], esbuild: EsbuildApi): Promise<string>;
+/** Lower tier-1 sources to IR v2. */
+declare function lower(files: readonly SourceFile[] | Readonly<Record<string, string>>, options?: LowerOptions): Promise<LowerResult>;
+
+export { type Evaluator as E, LowerError as L, type EsbuildApi as a, ESBUILD_VERSION as b, EVALUATION_GLOBAL as c, type LowerOptions as d, type LowerResult as e, type LoweredWorkflow as f, bundleProject as g, defaultEntries as h, lower as l };

package/dist/lower-Dw5grNrI.d.ts

@@ -0,0 +1,49 @@
+import * as esbuild from 'esbuild';
+import { S as SourceFile } from './hash-CZkTXPCX.js';
+import { W as WorkflowDefinition } from './types-Dr2Fn1Ax.js';
+import { h as ConnectionResolver } from './assemble-DMOuaxRI.js';
+
+/** The esbuild API surface lower() uses (`esbuild` or `esbuild-wasm`, version 0.28.2). */
+type EsbuildApi = Pick<typeof esbuild, 'build' | 'transform'>;
+/** Runs a bundle and returns the string value of its `__fluidgrids` export. */
+interface Evaluator {
+    /** `esm`: the bundle as built; `iife`: a script assigning the exports to `__fluidgridsBundle`. */
+    readonly format: 'esm' | 'iife';
+    evaluate(code: string): Promise<string>;
+}
+declare const EVALUATION_GLOBAL = "__fluidgridsBundle";
+declare const ESBUILD_VERSION = "0.28.2";
+declare class LowerError extends Error {
+    constructor(message: string);
+}
+interface LowerOptions {
+    /** Modules to evaluate. Default: every `.ts` file outside `.fluidgrids/`, except tests and declarations. */
+    entries?: readonly string[];
+    esbuild?: EsbuildApi;
+    evaluator?: Evaluator;
+    connections?: ConnectionResolver;
+    /** Largest JSON the evaluation may return. Default 16 MiB. */
+    maxOutputBytes?: number;
+}
+interface LoweredWorkflow {
+    key: string;
+    module: string;
+    exportName: string;
+    definition: WorkflowDefinition;
+}
+interface LowerResult {
+    /** `sha256:<hex>` of the bundle. */
+    buildId: string;
+    bundle: string;
+    /** `sha256:<hex>` of the source files. */
+    sourceHash: string;
+    workflows: LoweredWorkflow[];
+}
+/** The default entry modules: workflow sources, not generated clients, tests or declarations. */
+declare function defaultEntries(paths: readonly string[]): string[];
+/** Bundle a project. Exported so services can compute `buildId` without evaluating. */
+declare function bundleProject(files: ReadonlyMap<string, string>, entries: readonly string[], esbuild: EsbuildApi): Promise<string>;
+/** Lower tier-1 sources to IR v2. */
+declare function lower(files: readonly SourceFile[] | Readonly<Record<string, string>>, options?: LowerOptions): Promise<LowerResult>;
+
+export { type Evaluator as E, LowerError as L, type EsbuildApi as a, ESBUILD_VERSION as b, EVALUATION_GLOBAL as c, type LowerOptions as d, type LowerResult as e, type LoweredWorkflow as f, bundleProject as g, defaultEntries as h, lower as l };

package/dist/manifest-Bp9ZJlav.d.ts

@@ -0,0 +1,60 @@
+import { a as JsonObject } from './types-Dr2Fn1Ax.js';
+
+/** One input or output field. Output fields may also be a bare type name. */
+interface ManifestField {
+    type?: string;
+    required?: boolean;
+    description?: string;
+    default?: unknown;
+    items?: unknown;
+    options?: unknown[];
+    enum?: unknown[];
+    properties?: Record<string, unknown>;
+    format?: string;
+    [key: string]: unknown;
+}
+interface ManifestOperation {
+    name: string;
+    type?: string;
+    role?: string;
+    description?: string;
+    input_fields?: Record<string, ManifestField>;
+    output_fields?: Record<string, ManifestField | string>;
+    [key: string]: unknown;
+}
+/** A handle a node card renders (static list or derived from node state). */
+type ManifestHandles = Array<{
+    id: string;
+    label?: string;
+}> | {
+    fromStateRecord: string;
+    extra?: Array<{
+        id: string;
+    }>;
+};
+interface NodeManifest {
+    nodeType: string;
+    nodeVersion?: string;
+    name?: string;
+    kind?: string[];
+    operations: ManifestOperation[] | {
+        operations: ManifestOperation[];
+        outputHandles?: ManifestHandles;
+        inputHandles?: ManifestHandles;
+    };
+    outputHandles?: ManifestHandles;
+    inputHandles?: ManifestHandles;
+    [key: string]: unknown;
+}
+/** The operations of a manifest, whichever form the registry returned. */
+declare function operationsOf(manifest: NodeManifest): ManifestOperation[];
+/** True when the operation starts a workflow. */
+declare function isTriggerOperation(operation: ManifestOperation): boolean;
+/** A JSON Schema for one manifest field. */
+declare function fieldSchema(value: ManifestField | string | unknown): JsonObject;
+/** A JSON Schema object for a set of fields (`input_fields` / `output_fields`). */
+declare function fieldsSchema(fields: Record<string, ManifestField | string> | undefined): JsonObject;
+/** Find the manifest of a node type (the highest version when several are given). */
+declare function findManifest(manifests: readonly NodeManifest[], nodeType: string): NodeManifest | undefined;
+
+export { type ManifestField as M, type NodeManifest as N, type ManifestHandles as a, type ManifestOperation as b, fieldsSchema as c, findManifest as d, fieldSchema as f, isTriggerOperation as i, operationsOf as o };

package/dist/manifest-Duf-gHdO.d.cts

@@ -0,0 +1,60 @@
+import { a as JsonObject } from './types-Dr2Fn1Ax.cjs';
+
+/** One input or output field. Output fields may also be a bare type name. */
+interface ManifestField {
+    type?: string;
+    required?: boolean;
+    description?: string;
+    default?: unknown;
+    items?: unknown;
+    options?: unknown[];
+    enum?: unknown[];
+    properties?: Record<string, unknown>;
+    format?: string;
+    [key: string]: unknown;
+}
+interface ManifestOperation {
+    name: string;
+    type?: string;
+    role?: string;
+    description?: string;
+    input_fields?: Record<string, ManifestField>;
+    output_fields?: Record<string, ManifestField | string>;
+    [key: string]: unknown;
+}
+/** A handle a node card renders (static list or derived from node state). */
+type ManifestHandles = Array<{
+    id: string;
+    label?: string;
+}> | {
+    fromStateRecord: string;
+    extra?: Array<{
+        id: string;
+    }>;
+};
+interface NodeManifest {
+    nodeType: string;
+    nodeVersion?: string;
+    name?: string;
+    kind?: string[];
+    operations: ManifestOperation[] | {
+        operations: ManifestOperation[];
+        outputHandles?: ManifestHandles;
+        inputHandles?: ManifestHandles;
+    };
+    outputHandles?: ManifestHandles;
+    inputHandles?: ManifestHandles;
+    [key: string]: unknown;
+}
+/** The operations of a manifest, whichever form the registry returned. */
+declare function operationsOf(manifest: NodeManifest): ManifestOperation[];
+/** True when the operation starts a workflow. */
+declare function isTriggerOperation(operation: ManifestOperation): boolean;
+/** A JSON Schema for one manifest field. */
+declare function fieldSchema(value: ManifestField | string | unknown): JsonObject;
+/** A JSON Schema object for a set of fields (`input_fields` / `output_fields`). */
+declare function fieldsSchema(fields: Record<string, ManifestField | string> | undefined): JsonObject;
+/** Find the manifest of a node type (the highest version when several are given). */
+declare function findManifest(manifests: readonly NodeManifest[], nodeType: string): NodeManifest | undefined;
+
+export { type ManifestField as M, type NodeManifest as N, type ManifestHandles as a, type ManifestOperation as b, fieldsSchema as c, findManifest as d, fieldSchema as f, isTriggerOperation as i, operationsOf as o };

package/dist/node-evaluator-2GTUZVPK.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+var chunk265J2FCH_cjs = require('./chunk-265J2FCH.cjs');
+require('./chunk-LUXCXFOE.cjs');
+require('./chunk-KUTMY2IO.cjs');
+require('./chunk-AU3YW7FZ.cjs');
+require('./chunk-G4UEPUGO.cjs');
+require('./chunk-RRQ5HOBF.cjs');
+require('./chunk-27HASETB.cjs');
+require('./chunk-LRM6JXJA.cjs');
+
+
+
+Object.defineProperty(exports, "createNodeVmEvaluator", {
+  enumerable: true,
+  get: function () { return chunk265J2FCH_cjs.createNodeVmEvaluator; }
+});

package/dist/node-evaluator-RMYEWCXZ.js

@@ -0,0 +1,8 @@
+export { createNodeVmEvaluator } from './chunk-SRQRLWOS.js';
+import './chunk-S34NJE3A.js';
+import './chunk-BWSLWF2E.js';
+import './chunk-SS4LT2IP.js';
+import './chunk-5LUIDMF4.js';
+import './chunk-PL73GJR4.js';
+import './chunk-X4HKU3MX.js';
+import './chunk-REV7ZOA4.js';

package/dist/quickjs/index.cjs

@@ -0,0 +1,92 @@
+'use strict';
+
+var chunkLUXCXFOE_cjs = require('../chunk-LUXCXFOE.cjs');
+require('../chunk-KUTMY2IO.cjs');
+require('../chunk-AU3YW7FZ.cjs');
+require('../chunk-G4UEPUGO.cjs');
+require('../chunk-RRQ5HOBF.cjs');
+require('../chunk-27HASETB.cjs');
+require('../chunk-LRM6JXJA.cjs');
+var quickjsEmscripten = require('quickjs-emscripten');
+
+var WASM_PAGE_BYTES = 64 * 1024;
+var ENGINE_HEADROOM_BYTES = 32 * 1024 * 1024;
+var INITIAL_ENGINE_BYTES = 16 * 1024 * 1024;
+function errorMessage(ctx, handle) {
+  const dumped = ctx.dump(handle);
+  if (typeof dumped === "object" && dumped !== null && "message" in dumped)
+    return String(dumped.message);
+  return String(dumped);
+}
+function createQuickJSEvaluator(options = {}) {
+  const timeoutMs = options.timeoutMs ?? 5e3;
+  const memoryLimitBytes = options.memoryLimitBytes ?? 64 * 1024 * 1024;
+  const maxStackSizeBytes = options.maxStackSizeBytes ?? 1024 * 1024;
+  return {
+    format: "esm",
+    async evaluate(code) {
+      const maximum = Math.ceil((memoryLimitBytes + ENGINE_HEADROOM_BYTES) / WASM_PAGE_BYTES);
+      const initial = Math.min(maximum, INITIAL_ENGINE_BYTES / WASM_PAGE_BYTES);
+      const engine = await quickjsEmscripten.newQuickJSWASMModuleFromVariant(
+        quickjsEmscripten.newVariant(quickjsEmscripten.RELEASE_SYNC, { wasmMemory: new WebAssembly.Memory({ initial, maximum }) })
+      );
+      const runtime = engine.newRuntime();
+      const deadline = Date.now() + timeoutMs;
+      runtime.setMemoryLimit(memoryLimitBytes);
+      runtime.setMaxStackSize(maxStackSizeBytes);
+      runtime.setInterruptHandler(quickjsEmscripten.shouldInterruptAfterDeadline(deadline));
+      const ctx = runtime.newContext();
+      const handles = [];
+      try {
+        const result = ctx.evalCode(code, "workflow-bundle.mjs", { type: "module" });
+        if (result.error) {
+          const message = errorMessage(ctx, result.error);
+          result.error.dispose();
+          throw new chunkLUXCXFOE_cjs.LowerError(`Evaluating the workflow code failed: ${message}`);
+        }
+        let namespace = result.value;
+        handles.push(namespace);
+        const state = ctx.getPromiseState(namespace);
+        if (!(state.type === "fulfilled" && state.notAPromise === true)) {
+          if (state.type === "fulfilled") state.value.dispose();
+          else if (state.type === "rejected") state.error.dispose();
+          while (runtime.hasPendingJob()) {
+            if (Date.now() > deadline)
+              throw new chunkLUXCXFOE_cjs.LowerError("Evaluating the workflow code timed out");
+            const jobs = runtime.executePendingJobs();
+            if (jobs.error) {
+              const message = errorMessage(ctx, jobs.error);
+              jobs.error.dispose();
+              throw new chunkLUXCXFOE_cjs.LowerError(`Evaluating the workflow code failed: ${message}`);
+            }
+          }
+          const settled = ctx.getPromiseState(namespace);
+          if (settled.type === "rejected") {
+            const message = errorMessage(ctx, settled.error);
+            settled.error.dispose();
+            throw new chunkLUXCXFOE_cjs.LowerError(`Evaluating the workflow code failed: ${message}`);
+          }
+          if (settled.type === "pending")
+            throw new chunkLUXCXFOE_cjs.LowerError("The workflow module never finished evaluating");
+          namespace = settled.value;
+          handles.push(namespace);
+        }
+        const exported = ctx.getProp(namespace, "__fluidgrids");
+        handles.push(exported);
+        if (ctx.typeof(exported) !== "string")
+          throw new chunkLUXCXFOE_cjs.LowerError("The bundle did not export a workflow collection");
+        return ctx.getString(exported);
+      } catch (error) {
+        if (error instanceof chunkLUXCXFOE_cjs.LowerError) throw error;
+        const message = error instanceof Error ? error.message : String(error);
+        throw new chunkLUXCXFOE_cjs.LowerError(`Evaluating the workflow code failed: ${message}`);
+      } finally {
+        for (const handle of handles.reverse()) if (handle.alive) handle.dispose();
+        ctx.dispose();
+        runtime.dispose();
+      }
+    }
+  };
+}
+
+exports.createQuickJSEvaluator = createQuickJSEvaluator;

package/dist/quickjs/index.d.cts

@@ -0,0 +1,18 @@
+import { E as Evaluator } from '../lower-DcOY8ux0.cjs';
+import 'esbuild';
+import '../hash-CZkTXPCX.cjs';
+import '../types-Dr2Fn1Ax.cjs';
+import '../assemble-BJo9TECS.cjs';
+
+interface QuickJSEvaluatorOptions {
+    /** Wall-clock budget. Default 5000 ms. */
+    timeoutMs?: number;
+    /** Runtime heap cap. Default 64 MiB. */
+    memoryLimitBytes?: number;
+    /** Native stack cap. Default 1 MiB. */
+    maxStackSizeBytes?: number;
+}
+/** An {@link Evaluator} backed by a bounded QuickJS engine. */
+declare function createQuickJSEvaluator(options?: QuickJSEvaluatorOptions): Evaluator;
+
+export { type QuickJSEvaluatorOptions, createQuickJSEvaluator };

package/dist/quickjs/index.d.ts

@@ -0,0 +1,18 @@
+import { E as Evaluator } from '../lower-Dw5grNrI.js';
+import 'esbuild';
+import '../hash-CZkTXPCX.js';
+import '../types-Dr2Fn1Ax.js';
+import '../assemble-DMOuaxRI.js';
+
+interface QuickJSEvaluatorOptions {
+    /** Wall-clock budget. Default 5000 ms. */
+    timeoutMs?: number;
+    /** Runtime heap cap. Default 64 MiB. */
+    memoryLimitBytes?: number;
+    /** Native stack cap. Default 1 MiB. */
+    maxStackSizeBytes?: number;
+}
+/** An {@link Evaluator} backed by a bounded QuickJS engine. */
+declare function createQuickJSEvaluator(options?: QuickJSEvaluatorOptions): Evaluator;
+
+export { type QuickJSEvaluatorOptions, createQuickJSEvaluator };

package/dist/quickjs/index.js

@@ -0,0 +1,90 @@
+import { LowerError } from '../chunk-S34NJE3A.js';
+import '../chunk-BWSLWF2E.js';
+import '../chunk-SS4LT2IP.js';
+import '../chunk-5LUIDMF4.js';
+import '../chunk-PL73GJR4.js';
+import '../chunk-X4HKU3MX.js';
+import '../chunk-REV7ZOA4.js';
+import { newQuickJSWASMModuleFromVariant, newVariant, RELEASE_SYNC, shouldInterruptAfterDeadline } from 'quickjs-emscripten';
+
+var WASM_PAGE_BYTES = 64 * 1024;
+var ENGINE_HEADROOM_BYTES = 32 * 1024 * 1024;
+var INITIAL_ENGINE_BYTES = 16 * 1024 * 1024;
+function errorMessage(ctx, handle) {
+  const dumped = ctx.dump(handle);
+  if (typeof dumped === "object" && dumped !== null && "message" in dumped)
+    return String(dumped.message);
+  return String(dumped);
+}
+function createQuickJSEvaluator(options = {}) {
+  const timeoutMs = options.timeoutMs ?? 5e3;
+  const memoryLimitBytes = options.memoryLimitBytes ?? 64 * 1024 * 1024;
+  const maxStackSizeBytes = options.maxStackSizeBytes ?? 1024 * 1024;
+  return {
+    format: "esm",
+    async evaluate(code) {
+      const maximum = Math.ceil((memoryLimitBytes + ENGINE_HEADROOM_BYTES) / WASM_PAGE_BYTES);
+      const initial = Math.min(maximum, INITIAL_ENGINE_BYTES / WASM_PAGE_BYTES);
+      const engine = await newQuickJSWASMModuleFromVariant(
+        newVariant(RELEASE_SYNC, { wasmMemory: new WebAssembly.Memory({ initial, maximum }) })
+      );
+      const runtime = engine.newRuntime();
+      const deadline = Date.now() + timeoutMs;
+      runtime.setMemoryLimit(memoryLimitBytes);
+      runtime.setMaxStackSize(maxStackSizeBytes);
+      runtime.setInterruptHandler(shouldInterruptAfterDeadline(deadline));
+      const ctx = runtime.newContext();
+      const handles = [];
+      try {
+        const result = ctx.evalCode(code, "workflow-bundle.mjs", { type: "module" });
+        if (result.error) {
+          const message = errorMessage(ctx, result.error);
+          result.error.dispose();
+          throw new LowerError(`Evaluating the workflow code failed: ${message}`);
+        }
+        let namespace = result.value;
+        handles.push(namespace);
+        const state = ctx.getPromiseState(namespace);
+        if (!(state.type === "fulfilled" && state.notAPromise === true)) {
+          if (state.type === "fulfilled") state.value.dispose();
+          else if (state.type === "rejected") state.error.dispose();
+          while (runtime.hasPendingJob()) {
+            if (Date.now() > deadline)
+              throw new LowerError("Evaluating the workflow code timed out");
+            const jobs = runtime.executePendingJobs();
+            if (jobs.error) {
+              const message = errorMessage(ctx, jobs.error);
+              jobs.error.dispose();
+              throw new LowerError(`Evaluating the workflow code failed: ${message}`);
+            }
+          }
+          const settled = ctx.getPromiseState(namespace);
+          if (settled.type === "rejected") {
+            const message = errorMessage(ctx, settled.error);
+            settled.error.dispose();
+            throw new LowerError(`Evaluating the workflow code failed: ${message}`);
+          }
+          if (settled.type === "pending")
+            throw new LowerError("The workflow module never finished evaluating");
+          namespace = settled.value;
+          handles.push(namespace);
+        }
+        const exported = ctx.getProp(namespace, "__fluidgrids");
+        handles.push(exported);
+        if (ctx.typeof(exported) !== "string")
+          throw new LowerError("The bundle did not export a workflow collection");
+        return ctx.getString(exported);
+      } catch (error) {
+        if (error instanceof LowerError) throw error;
+        const message = error instanceof Error ? error.message : String(error);
+        throw new LowerError(`Evaluating the workflow code failed: ${message}`);
+      } finally {
+        for (const handle of handles.reverse()) if (handle.alive) handle.dispose();
+        ctx.dispose();
+        runtime.dispose();
+      }
+    }
+  };
+}
+
+export { createQuickJSEvaluator };