@fluidgrids/workflows 0.0.0-stage → 2026.1027.1

package/dist/lower-CXggJTIo.d.ts

@@ -0,0 +1,67 @@
+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-CrpUyd_3.js';
+
+/** Why an evaluation produced no collection. */
+type IsolateFailure = 'error' | 'timeout' | 'determinism' | 'no-collection' | 'out-of-memory' | 'crashed';
+
+/** 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";
+/** Why lowering failed, when the cause is one a caller may want to tell apart. */
+type LowerFailureReason = IsolateFailure | 'too-large';
+declare class LowerError extends Error {
+    readonly reason?: LowerFailureReason | undefined;
+    constructor(message: string, reason?: LowerFailureReason | undefined);
+}
+/**
+ * The workflow code read the clock or a random source while it was defined
+ * (`Date.now()`, `new Date()`, `Math.random()`, …), which would make two builds
+ * of the same source differ.
+ */
+declare class DeterminismViolationError extends LowerError {
+    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;
+    /** Largest total size of the source files, in UTF-8 bytes, checked before esbuild. Default 1 MiB. */
+    maxSourceBytes?: number;
+    /** Largest bundle, in UTF-8 bytes, checked before evaluation. Default 1.5 MiB. */
+    maxBundleBytes?: 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 { DeterminismViolationError as D, type Evaluator as E, LowerError as L, type EsbuildApi as a, ESBUILD_VERSION as b, EVALUATION_GLOBAL as c, type LowerFailureReason as d, type LowerOptions as e, type LowerResult as f, type LoweredWorkflow as g, bundleProject as h, defaultEntries as i, lower as l };

package/dist/lower-DAzvsJCo.d.cts

@@ -0,0 +1,67 @@
+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-DEf3znGD.cjs';
+
+/** Why an evaluation produced no collection. */
+type IsolateFailure = 'error' | 'timeout' | 'determinism' | 'no-collection' | 'out-of-memory' | 'crashed';
+
+/** 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";
+/** Why lowering failed, when the cause is one a caller may want to tell apart. */
+type LowerFailureReason = IsolateFailure | 'too-large';
+declare class LowerError extends Error {
+    readonly reason?: LowerFailureReason | undefined;
+    constructor(message: string, reason?: LowerFailureReason | undefined);
+}
+/**
+ * The workflow code read the clock or a random source while it was defined
+ * (`Date.now()`, `new Date()`, `Math.random()`, …), which would make two builds
+ * of the same source differ.
+ */
+declare class DeterminismViolationError extends LowerError {
+    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;
+    /** Largest total size of the source files, in UTF-8 bytes, checked before esbuild. Default 1 MiB. */
+    maxSourceBytes?: number;
+    /** Largest bundle, in UTF-8 bytes, checked before evaluation. Default 1.5 MiB. */
+    maxBundleBytes?: 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 { DeterminismViolationError as D, type Evaluator as E, LowerError as L, type EsbuildApi as a, ESBUILD_VERSION as b, EVALUATION_GLOBAL as c, type LowerFailureReason as d, type LowerOptions as e, type LowerResult as f, type LoweredWorkflow as g, bundleProject as h, defaultEntries as i, 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-CH3XCJND.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+var chunk3M34AUIY_cjs = require('./chunk-3M34AUIY.cjs');
+require('./chunk-Y7NWR3WH.cjs');
+require('./chunk-TQF7MYEN.cjs');
+require('./chunk-7YR7DI7B.cjs');
+require('./chunk-G4UEPUGO.cjs');
+require('./chunk-6AIAC2FP.cjs');
+require('./chunk-CSYBNN3V.cjs');
+require('./chunk-E3APHA6O.cjs');
+
+
+
+Object.defineProperty(exports, "createNodeVmEvaluator", {
+  enumerable: true,
+  get: function () { return chunk3M34AUIY_cjs.createNodeVmEvaluator; }
+});

package/dist/node-evaluator-TULXA3WE.js

@@ -0,0 +1,8 @@
+export { createNodeVmEvaluator } from './chunk-5AW745OG.js';
+import './chunk-MBBKGD7K.js';
+import './chunk-EEAIM35V.js';
+import './chunk-6U446SKY.js';
+import './chunk-5LUIDMF4.js';
+import './chunk-UB2BHU2M.js';
+import './chunk-IHKXLG6I.js';
+import './chunk-UJNHTS6D.js';

package/dist/quickjs/index.cjs

@@ -0,0 +1,46 @@
+'use strict';
+
+var chunkY7NWR3WH_cjs = require('../chunk-Y7NWR3WH.cjs');
+require('../chunk-TQF7MYEN.cjs');
+require('../chunk-7YR7DI7B.cjs');
+require('../chunk-G4UEPUGO.cjs');
+require('../chunk-6AIAC2FP.cjs');
+require('../chunk-CSYBNN3V.cjs');
+var chunkE3APHA6O_cjs = require('../chunk-E3APHA6O.cjs');
+var module$1 = require('module');
+var url = require('url');
+
+// src/generated/quickjs-worker-source.ts
+var QUICKJS_WORKER_SOURCE = '"use strict";\n\nvar import_node_worker_threads = require("node:worker_threads");\n\nfunction isRecord(value) {\n  return typeof value === "object" && value !== null && !Array.isArray(value);\n}\n\nvar DETERMINISM_VIOLATION = "DeterminismViolation";\nvar DETERMINISM_PRELUDE = `(() => {\n  const NAME = ${JSON.stringify(DETERMINISM_VIOLATION)};\n  const fail = (what) => {\n    const error = new Error(\n      what + " is not allowed in workflow code: lowering must give the same IR on every build. Read times and random values at run time instead (for example wf.now)."\n    );\n    error.name = NAME;\n    throw error;\n  };\n  const lock = (target, key, value) =>\n    Object.defineProperty(target, key, { value, writable: false, enumerable: false, configurable: false });\n  const RealDate = Date;\n  const LockedDate = function Date(...args) {\n    if (new.target === undefined) return fail("Date()");\n    if (args.length === 0) return fail("new Date()");\n    return Reflect.construct(RealDate, args, new.target);\n  };\n  lock(LockedDate, "prototype", RealDate.prototype);\n  lock(RealDate.prototype, "constructor", LockedDate);\n  lock(LockedDate, "now", function now() { return fail("Date.now()"); });\n  lock(LockedDate, "parse", RealDate.parse);\n  lock(LockedDate, "UTC", RealDate.UTC);\n  lock(globalThis, "Date", LockedDate);\n  lock(Math, "random", function random() { return fail("Math.random()"); });\n  const crypto = globalThis.crypto;\n  if (crypto !== null && typeof crypto === "object") {\n    for (const name of ["getRandomValues", "randomUUID"]) {\n      if (typeof crypto[name] === "function") lock(crypto, name, function () { return fail("crypto." + name + "()"); });\n    }\n  }\n  const DateTimeFormat = typeof Intl === "object" && Intl !== null ? Intl.DateTimeFormat : undefined;\n  if (typeof DateTimeFormat === "function") {\n    const proto = DateTimeFormat.prototype;\n    const format = Object.getOwnPropertyDescriptor(proto, "format");\n    if (format && typeof format.get === "function") {\n      const get = format.get;\n      Object.defineProperty(proto, "format", {\n        get() {\n          const bound = get.call(this);\n          return (date) => (date === undefined ? fail("Intl.DateTimeFormat format()") : bound(date));\n        },\n        enumerable: false,\n        configurable: false,\n      });\n    }\n    const formatToParts = proto.formatToParts;\n    if (typeof formatToParts === "function") {\n      lock(proto, "formatToParts", function (date) {\n        return date === undefined ? fail("Intl.DateTimeFormat formatToParts()") : formatToParts.call(this, date);\n      });\n    }\n  }\n})();\n`;\nfunction failure(kind, message) {\n  return { ok: false, failure: kind, message };\n}\nfunction failureForErrorName(name) {\n  return name === DETERMINISM_VIOLATION ? "determinism" : "error";\n}\n\nfunction isQuickJSApi(value) {\n  return isRecord(value) && typeof value["newQuickJSWASMModuleFromVariant"] === "function" && typeof value["newVariant"] === "function" && typeof value["shouldInterruptAfterDeadline"] === "function" && value["RELEASE_SYNC"] !== void 0;\n}\nvar WASM_PAGE_BYTES = 64 * 1024;\nvar ENGINE_HEADROOM_BYTES = 32 * 1024 * 1024;\nvar INITIAL_ENGINE_BYTES = 16 * 1024 * 1024;\nfunction describe(ctx, handle) {\n  const dumped = ctx.dump(handle);\n  if (isRecord(dumped)) {\n    const name = typeof dumped["name"] === "string" ? dumped["name"] : "Error";\n    const message = dumped["message"];\n    return {\n      name,\n      message: typeof message === "string" ? message : message === void 0 ? JSON.stringify(dumped) : String(message)\n    };\n  }\n  return { name: "Error", message: String(dumped) };\n}\nasync function evaluateInQuickJS(api, code, limits) {\n  const maximum = Math.ceil((limits.memoryLimitBytes + ENGINE_HEADROOM_BYTES) / WASM_PAGE_BYTES);\n  const initial = Math.min(maximum, INITIAL_ENGINE_BYTES / WASM_PAGE_BYTES);\n  const engine = await api.newQuickJSWASMModuleFromVariant(\n    api.newVariant(api.RELEASE_SYNC, { wasmMemory: new WebAssembly.Memory({ initial, maximum }) })\n  );\n  const runtime = engine.newRuntime();\n  const deadline = Date.now() + limits.timeoutMs;\n  runtime.setMemoryLimit(limits.memoryLimitBytes);\n  runtime.setMaxStackSize(limits.maxStackSizeBytes);\n  runtime.setInterruptHandler(api.shouldInterruptAfterDeadline(deadline));\n  const ctx = runtime.newContext();\n  const handles = [];\n  const timedOut = () => failure("timeout", `Evaluating the workflow code timed out after ${limits.timeoutMs} ms`);\n  const thrown = (handle) => {\n    const { name, message } = describe(ctx, handle);\n    handle.dispose();\n    if (Date.now() > deadline && /interrupted/.test(message)) return timedOut();\n    return failure(failureForErrorName(name), message);\n  };\n  try {\n    const prelude = ctx.evalCode(DETERMINISM_PRELUDE, "determinism-prelude.js", { type: "global" });\n    if (prelude.error) return thrown(prelude.error);\n    prelude.value.dispose();\n    const result = ctx.evalCode(code, "workflow-bundle.mjs", { type: "module" });\n    if (result.error) return thrown(result.error);\n    let namespace = result.value;\n    handles.push(namespace);\n    const state = ctx.getPromiseState(namespace);\n    if (!(state.type === "fulfilled" && state.notAPromise === true)) {\n      if (state.type === "fulfilled") state.value.dispose();\n      else if (state.type === "rejected") state.error.dispose();\n      while (runtime.hasPendingJob()) {\n        if (Date.now() > deadline) return timedOut();\n        const jobs = runtime.executePendingJobs();\n        if (jobs.error) return thrown(jobs.error);\n      }\n      const settled = ctx.getPromiseState(namespace);\n      if (settled.type === "rejected") return thrown(settled.error);\n      if (settled.type === "pending")\n        return failure("error", "The workflow module never finished evaluating");\n      namespace = settled.value;\n      handles.push(namespace);\n    }\n    const exported = ctx.getProp(namespace, "__fluidgrids");\n    handles.push(exported);\n    if (ctx.typeof(exported) !== "string")\n      return failure("no-collection", "The bundle did not export a workflow collection");\n    return { ok: true, value: ctx.getString(exported) };\n  } catch (error) {\n    return failure("error", error instanceof Error ? error.message : String(error));\n  } finally {\n    for (const handle of handles.reverse()) if (handle.alive) handle.dispose();\n    ctx.dispose();\n    runtime.dispose();\n  }\n}\n\nprocess.on("unhandledRejection", () => void 0);\nasync function main(input) {\n  if (!isRecord(input) || typeof input["code"] !== "string" || typeof input["moduleUrl"] !== "string" || !isRecord(input["limits"]))\n    return failure("crashed", "The evaluation worker received no bundle");\n  const { timeoutMs, memoryLimitBytes, maxStackSizeBytes } = input["limits"];\n  if (typeof timeoutMs !== "number" || typeof memoryLimitBytes !== "number" || typeof maxStackSizeBytes !== "number")\n    return failure("crashed", "The evaluation worker received no limits");\n  const loaded = await import(input["moduleUrl"]);\n  const api = isQuickJSApi(loaded) ? loaded : isRecord(loaded) && isQuickJSApi(loaded["default"]) ? loaded["default"] : void 0;\n  if (!api) return failure("crashed", "quickjs-emscripten could not be loaded");\n  return evaluateInQuickJS(api, input["code"], {\n    timeoutMs,\n    memoryLimitBytes,\n    maxStackSizeBytes\n  });\n}\nmain(import_node_worker_threads.workerData).then(\n  (outcome) => import_node_worker_threads.parentPort?.postMessage(outcome),\n  (error) => import_node_worker_threads.parentPort?.postMessage(\n    failure("crashed", error instanceof Error ? error.message : String(error))\n  )\n);\n';
+
+// src/quickjs/index.ts
+function quickjsModuleUrl() {
+  try {
+    return url.pathToFileURL(module$1.createRequire(chunkE3APHA6O_cjs.importMetaUrl).resolve("quickjs-emscripten")).href;
+  } catch (error) {
+    throw new chunkY7NWR3WH_cjs.LowerError(
+      `quickjs-emscripten cannot be resolved: ${error instanceof Error ? error.message : String(error)}`,
+      "crashed"
+    );
+  }
+}
+function createQuickJSEvaluator(options = {}) {
+  const limits = {
+    timeoutMs: options.timeoutMs ?? 5e3,
+    memoryLimitBytes: options.memoryLimitBytes ?? 64 * 1024 * 1024,
+    maxStackSizeBytes: options.maxStackSizeBytes ?? 1024 * 1024
+  };
+  return {
+    format: "esm",
+    async evaluate(code) {
+      const outcome = await chunkY7NWR3WH_cjs.runIsolateWorker({
+        source: QUICKJS_WORKER_SOURCE,
+        workerData: { code, limits, moduleUrl: quickjsModuleUrl() },
+        timeoutMs: limits.timeoutMs
+      });
+      return chunkY7NWR3WH_cjs.outcomeToCollection(outcome);
+    }
+  };
+}
+
+exports.createQuickJSEvaluator = createQuickJSEvaluator;

package/dist/quickjs/index.d.cts

@@ -0,0 +1,18 @@
+import { E as Evaluator } from '../lower-DAzvsJCo.cjs';
+import 'esbuild';
+import '../hash-CZkTXPCX.cjs';
+import '../types-Dr2Fn1Ax.cjs';
+import '../assemble-DEf3znGD.cjs';
+
+interface QuickJSEvaluatorOptions {
+    /** Wall-clock budget, including parsing and compiling the bundle. 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 in a worker thread. */
+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-CXggJTIo.js';
+import 'esbuild';
+import '../hash-CZkTXPCX.js';
+import '../types-Dr2Fn1Ax.js';
+import '../assemble-CrpUyd_3.js';
+
+interface QuickJSEvaluatorOptions {
+    /** Wall-clock budget, including parsing and compiling the bundle. 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 in a worker thread. */
+declare function createQuickJSEvaluator(options?: QuickJSEvaluatorOptions): Evaluator;
+
+export { type QuickJSEvaluatorOptions, createQuickJSEvaluator };

package/dist/quickjs/index.js

@@ -0,0 +1,44 @@
+import { runIsolateWorker, outcomeToCollection, LowerError } from '../chunk-MBBKGD7K.js';
+import '../chunk-EEAIM35V.js';
+import '../chunk-6U446SKY.js';
+import '../chunk-5LUIDMF4.js';
+import '../chunk-UB2BHU2M.js';
+import '../chunk-IHKXLG6I.js';
+import '../chunk-UJNHTS6D.js';
+import { createRequire } from 'module';
+import { pathToFileURL } from 'url';
+
+// src/generated/quickjs-worker-source.ts
+var QUICKJS_WORKER_SOURCE = '"use strict";\n\nvar import_node_worker_threads = require("node:worker_threads");\n\nfunction isRecord(value) {\n  return typeof value === "object" && value !== null && !Array.isArray(value);\n}\n\nvar DETERMINISM_VIOLATION = "DeterminismViolation";\nvar DETERMINISM_PRELUDE = `(() => {\n  const NAME = ${JSON.stringify(DETERMINISM_VIOLATION)};\n  const fail = (what) => {\n    const error = new Error(\n      what + " is not allowed in workflow code: lowering must give the same IR on every build. Read times and random values at run time instead (for example wf.now)."\n    );\n    error.name = NAME;\n    throw error;\n  };\n  const lock = (target, key, value) =>\n    Object.defineProperty(target, key, { value, writable: false, enumerable: false, configurable: false });\n  const RealDate = Date;\n  const LockedDate = function Date(...args) {\n    if (new.target === undefined) return fail("Date()");\n    if (args.length === 0) return fail("new Date()");\n    return Reflect.construct(RealDate, args, new.target);\n  };\n  lock(LockedDate, "prototype", RealDate.prototype);\n  lock(RealDate.prototype, "constructor", LockedDate);\n  lock(LockedDate, "now", function now() { return fail("Date.now()"); });\n  lock(LockedDate, "parse", RealDate.parse);\n  lock(LockedDate, "UTC", RealDate.UTC);\n  lock(globalThis, "Date", LockedDate);\n  lock(Math, "random", function random() { return fail("Math.random()"); });\n  const crypto = globalThis.crypto;\n  if (crypto !== null && typeof crypto === "object") {\n    for (const name of ["getRandomValues", "randomUUID"]) {\n      if (typeof crypto[name] === "function") lock(crypto, name, function () { return fail("crypto." + name + "()"); });\n    }\n  }\n  const DateTimeFormat = typeof Intl === "object" && Intl !== null ? Intl.DateTimeFormat : undefined;\n  if (typeof DateTimeFormat === "function") {\n    const proto = DateTimeFormat.prototype;\n    const format = Object.getOwnPropertyDescriptor(proto, "format");\n    if (format && typeof format.get === "function") {\n      const get = format.get;\n      Object.defineProperty(proto, "format", {\n        get() {\n          const bound = get.call(this);\n          return (date) => (date === undefined ? fail("Intl.DateTimeFormat format()") : bound(date));\n        },\n        enumerable: false,\n        configurable: false,\n      });\n    }\n    const formatToParts = proto.formatToParts;\n    if (typeof formatToParts === "function") {\n      lock(proto, "formatToParts", function (date) {\n        return date === undefined ? fail("Intl.DateTimeFormat formatToParts()") : formatToParts.call(this, date);\n      });\n    }\n  }\n})();\n`;\nfunction failure(kind, message) {\n  return { ok: false, failure: kind, message };\n}\nfunction failureForErrorName(name) {\n  return name === DETERMINISM_VIOLATION ? "determinism" : "error";\n}\n\nfunction isQuickJSApi(value) {\n  return isRecord(value) && typeof value["newQuickJSWASMModuleFromVariant"] === "function" && typeof value["newVariant"] === "function" && typeof value["shouldInterruptAfterDeadline"] === "function" && value["RELEASE_SYNC"] !== void 0;\n}\nvar WASM_PAGE_BYTES = 64 * 1024;\nvar ENGINE_HEADROOM_BYTES = 32 * 1024 * 1024;\nvar INITIAL_ENGINE_BYTES = 16 * 1024 * 1024;\nfunction describe(ctx, handle) {\n  const dumped = ctx.dump(handle);\n  if (isRecord(dumped)) {\n    const name = typeof dumped["name"] === "string" ? dumped["name"] : "Error";\n    const message = dumped["message"];\n    return {\n      name,\n      message: typeof message === "string" ? message : message === void 0 ? JSON.stringify(dumped) : String(message)\n    };\n  }\n  return { name: "Error", message: String(dumped) };\n}\nasync function evaluateInQuickJS(api, code, limits) {\n  const maximum = Math.ceil((limits.memoryLimitBytes + ENGINE_HEADROOM_BYTES) / WASM_PAGE_BYTES);\n  const initial = Math.min(maximum, INITIAL_ENGINE_BYTES / WASM_PAGE_BYTES);\n  const engine = await api.newQuickJSWASMModuleFromVariant(\n    api.newVariant(api.RELEASE_SYNC, { wasmMemory: new WebAssembly.Memory({ initial, maximum }) })\n  );\n  const runtime = engine.newRuntime();\n  const deadline = Date.now() + limits.timeoutMs;\n  runtime.setMemoryLimit(limits.memoryLimitBytes);\n  runtime.setMaxStackSize(limits.maxStackSizeBytes);\n  runtime.setInterruptHandler(api.shouldInterruptAfterDeadline(deadline));\n  const ctx = runtime.newContext();\n  const handles = [];\n  const timedOut = () => failure("timeout", `Evaluating the workflow code timed out after ${limits.timeoutMs} ms`);\n  const thrown = (handle) => {\n    const { name, message } = describe(ctx, handle);\n    handle.dispose();\n    if (Date.now() > deadline && /interrupted/.test(message)) return timedOut();\n    return failure(failureForErrorName(name), message);\n  };\n  try {\n    const prelude = ctx.evalCode(DETERMINISM_PRELUDE, "determinism-prelude.js", { type: "global" });\n    if (prelude.error) return thrown(prelude.error);\n    prelude.value.dispose();\n    const result = ctx.evalCode(code, "workflow-bundle.mjs", { type: "module" });\n    if (result.error) return thrown(result.error);\n    let namespace = result.value;\n    handles.push(namespace);\n    const state = ctx.getPromiseState(namespace);\n    if (!(state.type === "fulfilled" && state.notAPromise === true)) {\n      if (state.type === "fulfilled") state.value.dispose();\n      else if (state.type === "rejected") state.error.dispose();\n      while (runtime.hasPendingJob()) {\n        if (Date.now() > deadline) return timedOut();\n        const jobs = runtime.executePendingJobs();\n        if (jobs.error) return thrown(jobs.error);\n      }\n      const settled = ctx.getPromiseState(namespace);\n      if (settled.type === "rejected") return thrown(settled.error);\n      if (settled.type === "pending")\n        return failure("error", "The workflow module never finished evaluating");\n      namespace = settled.value;\n      handles.push(namespace);\n    }\n    const exported = ctx.getProp(namespace, "__fluidgrids");\n    handles.push(exported);\n    if (ctx.typeof(exported) !== "string")\n      return failure("no-collection", "The bundle did not export a workflow collection");\n    return { ok: true, value: ctx.getString(exported) };\n  } catch (error) {\n    return failure("error", error instanceof Error ? error.message : String(error));\n  } finally {\n    for (const handle of handles.reverse()) if (handle.alive) handle.dispose();\n    ctx.dispose();\n    runtime.dispose();\n  }\n}\n\nprocess.on("unhandledRejection", () => void 0);\nasync function main(input) {\n  if (!isRecord(input) || typeof input["code"] !== "string" || typeof input["moduleUrl"] !== "string" || !isRecord(input["limits"]))\n    return failure("crashed", "The evaluation worker received no bundle");\n  const { timeoutMs, memoryLimitBytes, maxStackSizeBytes } = input["limits"];\n  if (typeof timeoutMs !== "number" || typeof memoryLimitBytes !== "number" || typeof maxStackSizeBytes !== "number")\n    return failure("crashed", "The evaluation worker received no limits");\n  const loaded = await import(input["moduleUrl"]);\n  const api = isQuickJSApi(loaded) ? loaded : isRecord(loaded) && isQuickJSApi(loaded["default"]) ? loaded["default"] : void 0;\n  if (!api) return failure("crashed", "quickjs-emscripten could not be loaded");\n  return evaluateInQuickJS(api, input["code"], {\n    timeoutMs,\n    memoryLimitBytes,\n    maxStackSizeBytes\n  });\n}\nmain(import_node_worker_threads.workerData).then(\n  (outcome) => import_node_worker_threads.parentPort?.postMessage(outcome),\n  (error) => import_node_worker_threads.parentPort?.postMessage(\n    failure("crashed", error instanceof Error ? error.message : String(error))\n  )\n);\n';
+
+// src/quickjs/index.ts
+function quickjsModuleUrl() {
+  try {
+    return pathToFileURL(createRequire(import.meta.url).resolve("quickjs-emscripten")).href;
+  } catch (error) {
+    throw new LowerError(
+      `quickjs-emscripten cannot be resolved: ${error instanceof Error ? error.message : String(error)}`,
+      "crashed"
+    );
+  }
+}
+function createQuickJSEvaluator(options = {}) {
+  const limits = {
+    timeoutMs: options.timeoutMs ?? 5e3,
+    memoryLimitBytes: options.memoryLimitBytes ?? 64 * 1024 * 1024,
+    maxStackSizeBytes: options.maxStackSizeBytes ?? 1024 * 1024
+  };
+  return {
+    format: "esm",
+    async evaluate(code) {
+      const outcome = await runIsolateWorker({
+        source: QUICKJS_WORKER_SOURCE,
+        workerData: { code, limits, moduleUrl: quickjsModuleUrl() },
+        timeoutMs: limits.timeoutMs
+      });
+      return outcomeToCollection(outcome);
+    }
+  };
+}
+
+export { createQuickJSEvaluator };