@oomol-lab/open-flow 0.1.0-beta.16 → 0.1.0-beta.17

package/dist/common/runtime-contract.d.ts

@@ -1,6 +1,7 @@
 import type { CodeModule, ConnectorCapability, JsonValue } from '../browser/flow-change.js';
-export { currentEngineContract, findEngineContract, type EngineContract } from './engine-contract.js';
+export { currentEngineContract, nodejsEngineContract, findEngineContract, type EngineContract } from './engine-contract.js';
 export type RuntimeModule = Pick<CodeModule, 'imports' | 'source'>;
+export declare const nodejsRuntimeConformanceCases: readonly RuntimeConformanceCase[];
 export interface RuntimeProgram {
     readonly engineContract: string;
     readonly engineDigest: string;

package/dist/common/runtime-contract.js

@@ -19,19 +19,90 @@ function t(n, r) {
 }
 //#endregion
 //#region src/execution/common/engineContract.ts
-var n = "open-flow-engine/v2", r = {
+var n = "open-flow-engine/v2", r = "open-flow-engine/v2/nodejs-compat-v1", i = {
 	platformExports: /* @__PURE__ */ new Set(["engineContract", "identity"]),
 	platformModule: "open-flow:platform",
 	platformSource: `export const engineContract = ${JSON.stringify(n)}
 export function identity(value) { return value }
 `
+}, a = {
+	...i,
+	builtinModules: new Set([
+		"assert",
+		"assert/strict",
+		"buffer",
+		"console",
+		"constants",
+		"crypto",
+		"events",
+		"fs",
+		"fs/promises",
+		"os",
+		"path",
+		"path/posix",
+		"process",
+		"punycode",
+		"querystring",
+		"stream",
+		"stream/promises",
+		"stream/web",
+		"string_decoder",
+		"timers",
+		"timers/promises",
+		"url",
+		"util",
+		"zlib"
+	].flatMap((e) => [e, `node:${e}`])),
+	platformSource: `export const engineContract = ${JSON.stringify(r)}
+export function identity(value) { return value }
+`
 };
-function i(e) {
-	return e == "open-flow-engine/v2" ? r : void 0;
+function o(e) {
+	if (e == "open-flow-engine/v2") return i;
+	if (e == "open-flow-engine/v2/nodejs-compat-v1") return a;
 }
 //#endregion
 //#region src/execution/common/runtime.ts
-function a(e, t, r = {}) {
+var s = [{
+	name: "supports Node builtin imports and asynchronous virtual file operations",
+	async verify(e) {
+		l(await e.invoke({
+			capability: async () => ({
+				body: null,
+				status: 403
+			}),
+			input: null,
+			invocationId: "nodejs-files",
+			program: {
+				...c(e, "import assert from 'node:assert/strict';\nimport { Buffer } from 'node:buffer'; import path from 'node:path'; import fs from 'node:fs/promises';\nexport default async () => {\n  const file = path.join('/tmp', 'conformance.txt');\n  await fs.writeFile(file, Buffer.from('你好'));\n  const text = await fs.readFile(file, 'utf8');\n  assert.equal(text, '你好');\n  await fs.unlink(file);\n  return { text, bytes: Buffer.byteLength(text) };\n}"),
+				engineContract: r
+			}
+		}), {
+			text: "你好",
+			bytes: 6
+		}, "Node virtual files");
+	}
+}, {
+	name: "preserves abort reasons and cancels Promise timers",
+	async verify(e) {
+		l(await e.invoke({
+			capability: async () => ({
+				body: null,
+				status: 403
+			}),
+			input: null,
+			invocationId: "nodejs-abort",
+			program: {
+				...c(e, "import { setTimeout } from 'node:timers/promises';\nexport default async () => {\n  const controller = new AbortController(); const reason = { message: 'stop' };\n  const combined = AbortSignal.any([controller.signal]);\n  const pending = setTimeout(60000, 'late', { signal: combined });\n  controller.abort(reason); controller.abort('ignored');\n  let thrown; try { combined.throwIfAborted(); } catch (error) { thrown = error; }\n  try { await pending; return false; } catch (error) {\n    return { sameReason: combined.reason === reason && thrown === reason, name: error.name };\n  }\n}"),
+				engineContract: r
+			}
+		}), {
+			sameReason: !0,
+			name: "AbortError"
+		}, "Node cancellation");
+	}
+}];
+function c(e, t, r = {}) {
 	return {
 		engineContract: n,
 		engineDigest: e.engineDigest,
@@ -45,10 +116,10 @@ function a(e, t, r = {}) {
 		}
 	};
 }
-function o(e, n, r) {
+function l(e, n, r) {
 	if (!t(e, n)) throw Error(`${r}: expected ${JSON.stringify(n)}, received ${JSON.stringify(e)}.`);
 }
-async function s(e, t, n) {
+async function u(e, t, n) {
 	try {
 		await e;
 	} catch (e) {
@@ -57,7 +128,7 @@ async function s(e, t, n) {
 	}
 	throw Error(`${n}: operation unexpectedly succeeded.`);
 }
-var c = [
+var d = [
 	{
 		name: "preserves Action error codes and fixed per-call Connection selection",
 		async verify(e) {
@@ -69,10 +140,10 @@ var c = [
 					alias: "office"
 				}, { connectionId: "home" }]
 			}];
-			o(await e.invoke({
+			l(await e.invoke({
 				capabilities: t,
 				capability: async ({ payload: e }) => {
-					let n = u(t, e);
+					let n = p(t, e);
 					if (n.input.fail) throw Object.assign(/* @__PURE__ */ Error("Provider unavailable."), { code: "connector.unavailable" });
 					return {
 						body: n.connectionId ?? null,
@@ -81,7 +152,7 @@ var c = [
 				},
 				input: null,
 				invocationId: "action-accounts",
-				program: a(e, "export default async (_, context) => {\n          const values = await Promise.all([\n            context.actions.example.echo({}, { connectionAlias: 'office' }),\n            context.actions['example.echo']({}, { connectionId: 'home' }),\n          ])\n          try { await context.actions.example.echo({ fail: true }, { connectionId: 'work' }) }\n          catch (error) { values.push(error.code) }\n          return values\n        }")
+				program: c(e, "export default async (_, context) => {\n          const values = await Promise.all([\n            context.actions.example.echo({}, { connectionAlias: 'office' }),\n            context.actions['example.echo']({}, { connectionId: 'home' }),\n          ])\n          try { await context.actions.example.echo({ fail: true }, { connectionId: 'work' }) }\n          catch (error) { values.push(error.code) }\n          return values\n        }")
 			}), [
 				"work",
 				"home",
@@ -93,7 +164,7 @@ var c = [
 		name: "shares Action entries and assigns independent concurrent call identities",
 		async verify(e) {
 			let t = [];
-			o(await e.invoke({
+			l(await e.invoke({
 				capabilities: [{
 					kind: "connector",
 					action: "example.echo",
@@ -105,7 +176,7 @@ var c = [
 				}),
 				input: null,
 				invocationId: "action-calls",
-				program: a(e, "export default async (_input, context) => {\n          const call = context.actions.example.echo\n          return { same: call === context.actions['example.echo'], values: await Promise.all([call({ value: 1 }), call({ value: 2 }), call({ value: 3 })]) }\n        }")
+				program: c(e, "export default async (_input, context) => {\n          const call = context.actions.example.echo\n          return { same: call === context.actions['example.echo'], values: await Promise.all([call({ value: 1 }), call({ value: 2 }), call({ value: 3 })]) }\n        }")
 			}), {
 				same: !0,
 				values: [
@@ -116,7 +187,7 @@ var c = [
 					action: "example.echo",
 					input: { value: e }
 				}))
-			}, "Action results"), o(new Set(t.map((e) => e.callId)).size, 3, "Independent Action identities"), o(t.map((e) => e.invocationId), [
+			}, "Action results"), l(new Set(t.map((e) => e.callId)).size, 3, "Independent Action identities"), l(t.map((e) => e.invocationId), [
 				"action-calls",
 				"action-calls",
 				"action-calls"
@@ -126,13 +197,13 @@ var c = [
 	{
 		name: "loads the fixed ESM closure and platform module",
 		async verify(e) {
-			o(await e.invoke({
+			l(await e.invoke({
 				capability: async () => {
 					throw Error("Capability must not be called.");
 				},
 				input: { value: 6 },
 				invocationId: "module-closure",
-				program: a(e, "import { double } from './helper.mjs'\nimport { engineContract, identity } from 'open-flow:platform'\nexport default (input) => ({ engineContract, value: identity(double(input.value)) })", { helper: {
+				program: c(e, "import { double } from './helper.mjs'\nimport { engineContract, identity } from 'open-flow:platform'\nexport default (input) => ({ engineContract, value: identity(double(input.value)) })", { helper: {
 					imports: [],
 					source: "export const double = (value) => value * 2"
 				} })
@@ -145,14 +216,14 @@ var c = [
 	{
 		name: "rejects modules outside the fixed closure",
 		async verify(e) {
-			await s(e.invoke({
+			await u(e.invoke({
 				capability: async () => ({
 					body: null,
 					status: 200
 				}),
 				input: null,
 				invocationId: "closed-linker",
-				program: a(e, "import fs from 'node:fs'\nexport default () => fs.readFileSync('/etc/passwd', 'utf8')")
+				program: c(e, "import fs from 'node:fs'\nexport default () => fs.readFileSync('/etc/passwd', 'utf8')")
 			}), /invalid|unsupported|cannot import|not part of/i, "Closed linker");
 		}
 	},
@@ -160,7 +231,7 @@ var c = [
 		name: "copies asynchronous Capability requests and responses",
 		async verify(e) {
 			let t = [];
-			o(await e.invoke({
+			l(await e.invoke({
 				capability: async (e) => (t.push(e), {
 					body: {
 						accepted: !0,
@@ -170,7 +241,7 @@ var c = [
 				}),
 				input: { issue: 42 },
 				invocationId: "async-capability",
-				program: a(e, "export default async (input, capability) => capability.artifact.put({ action: 'read', input })")
+				program: c(e, "export default async (input, capability) => capability.artifact.put({ action: 'read', input })")
 			}), {
 				body: {
 					accepted: !0,
@@ -180,7 +251,7 @@ var c = [
 					}
 				},
 				status: 200
-			}, "Capability result"), o(t.map(({ invocationId: e, kind: t, payload: n }) => ({
+			}, "Capability result"), l(t.map(({ invocationId: e, kind: t, payload: n }) => ({
 				invocationId: e,
 				kind: t,
 				payload: n
@@ -197,13 +268,13 @@ var c = [
 	{
 		name: "returns final outputs without exposing intermediate output capability",
 		async verify(e) {
-			o(await e.invoke({
+			l(await e.invoke({
 				capability: async () => {
 					throw Error("Capability must not be called.");
 				},
 				input: null,
 				invocationId: "final-outputs",
-				program: a(e, "export default (_input, context) => ({ available: typeof context.outputs, value: 1 })")
+				program: c(e, "export default (_input, context) => ({ available: typeof context.outputs, value: 1 })")
 			}), {
 				available: "undefined",
 				value: 1
@@ -215,7 +286,7 @@ var c = [
 		async verify(e) {
 			let t = new AbortController(), n = !1, r, i = new Promise((e) => {
 				r = e;
-			}), c = e.invoke({
+			}), a = e.invoke({
 				capabilities: [{
 					kind: "connector",
 					action: "example.wait",
@@ -226,14 +297,14 @@ var c = [
 				}, { once: !0 }))),
 				input: null,
 				invocationId: "canceled-capability",
-				program: a(e, "export default async (_input, context) => context.actions.example.wait({})"),
+				program: c(e, "export default async (_input, context) => context.actions.example.wait({})"),
 				signal: t.signal
 			});
-			await i, t.abort(/* @__PURE__ */ Error("Invocation canceled.")), await s(c, /cancel|abort|disposed/i, "Canceled invocation"), o(n, !0, "Capability cancellation");
+			await i, t.abort(/* @__PURE__ */ Error("Invocation canceled.")), await u(a, /cancel|abort|disposed/i, "Canceled invocation"), l(n, !0, "Capability cancellation");
 		}
 	}
 ];
-function l(e, t) {
+function f(e, t) {
 	let n = (e, t) => {
 		if (!(e === null || typeof e == "string" || typeof e == "boolean" || typeof e == "number" && Number.isFinite(e))) {
 			if (typeof e != "object" || t.has(e) || !Array.isArray(e) && Object.getPrototypeOf(e) !== Object.prototype && Object.getPrototypeOf(e) !== null || Object.getOwnPropertySymbols(e).length > 0) throw Object.assign(/* @__PURE__ */ Error("Action parameters must contain only JSON values."), { code: "capability.invalid" });
@@ -255,7 +326,7 @@ function l(e, t) {
 	for (let e of i.values()) Object.freeze(e);
 	return Object.freeze(r);
 }
-function u(e, t) {
+function p(e, t) {
 	let n = Object.assign(/* @__PURE__ */ Error("The Action request is invalid."), { code: "capability.invalid" }), r = Object.assign(/* @__PURE__ */ Error("The Action or Connection is not declared for this Task."), { code: "capability.denied" });
 	if (typeof t != "object" || !t || Array.isArray(t)) throw n;
 	let i = t;
@@ -285,4 +356,4 @@ function u(e, t) {
 	};
 }
 //#endregion
-export { l as createActions, n as currentEngineContract, i as findEngineContract, u as resolveAction, c as runtimeConformanceCases };
+export { f as createActions, n as currentEngineContract, o as findEngineContract, r as nodejsEngineContract, s as nodejsRuntimeConformanceCases, p as resolveAction, d as runtimeConformanceCases };