@oomol-lab/open-flow 0.1.0-beta.50 → 0.1.0-beta.51

package/dist/common/control-api-conformance.js

@@ -6045,6 +6045,7 @@ var endpoint = object({
 	])),
 	successStatus: number()
 });
+var sourceFlowIds = array(text.min(1)).refine((ids) => new Set(ids).size === ids.length, "Duplicate source Flow ID.");
 var trigger = {
 	name: text,
 	description: text.optional(),
@@ -6102,6 +6103,11 @@ var node = union([
 		...trigger,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger,
+		kind: literal("error"),
+		sourceFlowIds: sourceFlowIds.optional()
+	}),
 	object({
 		...trigger,
 		kind: literal("webhook"),
@@ -6173,7 +6179,11 @@ var document = object({
 	tasks: record$1(text, managed)
 });
 var revision = object({
-	modelVersion: union([literal(2), literal(4)]),
+	modelVersion: union([
+		literal(2),
+		literal(4),
+		literal(5)
+	]),
 	document,
 	modules: record$1(text, module)
 });
@@ -6183,9 +6193,16 @@ revision.extend({
 });
 function decodeRevisionContent(value) {
 	checkJsonDepth(value);
-	return revision.parse(value);
+	const content = revision.parse(value);
+	checkErrorModelVersion(content);
+	return content;
 }
 var shapes = {
+	"graph.trigger.sources.set": {
+		nodeId: text,
+		before: sourceFlowIds.optional(),
+		value: sourceFlowIds.optional()
+	},
 	"binding.create": {
 		bindingId: text,
 		binding
@@ -6359,6 +6376,9 @@ array(union([...new Map(Object.entries(shapes).map(([kind, shape]) => [kind, sha
 	kind: literal(kind),
 	...shape
 })])).values()])).min(1);
+function checkErrorModelVersion(content) {
+	if (content.modelVersion < 5 && [content.document.graph, ...Object.values(content.document.subflows).map((item) => item.graph)].some((item) => Object.values(item.nodes).some((itemNode) => itemNode.kind == "error"))) throw new TypeError("Error workflows require Flow model version 5.");
+}
 //#endregion
 //#region src/flow/common/change.ts
 var schemaKeywords = /* @__PURE__ */ new Set([
@@ -9621,6 +9641,7 @@ function triggerKey(value) {
 	};
 }
 var triggerKinds = /* @__PURE__ */ new Set([
+	"error",
 	"cron",
 	"integration",
 	"poll",
@@ -10003,6 +10024,17 @@ function variable(value) {
 		version: 1
 	};
 }
+function errorListener(value) {
+	const source = record$2(value);
+	if (typeof source.enabled != "boolean") return invalidResponse();
+	return {
+		flowId: string$1(source.flowId),
+		flowName: string$1(source.flowName),
+		nodeId: string$1(source.nodeId),
+		nodeName: string$1(source.nodeName),
+		enabled: source.enabled
+	};
+}
 //#endregion
 //#region src/control/common/publicationDecoders.ts
 function publication(value) {
@@ -10272,6 +10304,7 @@ function runDetails(value) {
 	};
 	const details = {
 		...summary,
+		...errorHandling(source),
 		closureDigest: string$1(source.closureDigest),
 		engineContract: string$1(source.engineContract),
 		engineDigest: string$1(source.engineDigest),
@@ -10371,10 +10404,7 @@ function runResult(value) {
 		const error = record$2(source.error);
 		return {
 			...base,
-			error: {
-				code: string$1(error.code),
-				message: string$1(error.message)
-			},
+			error: runFailure(error),
 			status: "failed"
 		};
 	}
@@ -10382,15 +10412,52 @@ function runResult(value) {
 		const error = record$2(source.error);
 		return {
 			...base,
-			error: {
-				code: string$1(error.code),
-				message: string$1(error.message)
-			},
+			error: runFailure(error),
 			status: "indeterminate"
 		};
 	}
 	return invalidResponse();
 }
+function errorHandling(source) {
+	const errorSource = source.errorSource == null ? void 0 : record$2(source.errorSource);
+	if (source.errorDispatches != null && !Array.isArray(source.errorDispatches)) return invalidResponse();
+	return {
+		...errorSource == null ? {} : { errorSource: {
+			flowId: string$1(errorSource.flowId),
+			runId: string$1(errorSource.runId)
+		} },
+		...source.errorDispatches == null ? {} : { errorDispatches: source.errorDispatches.map((value) => {
+			const dispatch = record$2(value);
+			const flowId = string$1(dispatch.flowId);
+			switch (dispatch.status) {
+				case "pending": return {
+					status: "pending",
+					flowId
+				};
+				case "dispatched": return {
+					status: "dispatched",
+					flowId,
+					runId: string$1(dispatch.runId)
+				};
+				case "failed": return {
+					status: "failed",
+					flowId,
+					message: string$1(dispatch.message)
+				};
+				default: return invalidResponse();
+			}
+		}) }
+	};
+}
+function runFailure(error) {
+	return {
+		code: string$1(error.code),
+		message: string$1(error.message),
+		...error.nodeId === void 0 ? {} : { nodeId: string$1(error.nodeId) },
+		...error.jobId === void 0 ? {} : { jobId: string$1(error.jobId) },
+		...error.path === void 0 ? {} : { path: (Array.isArray(error.path) ? error.path : invalidResponse()).map(string$1) }
+	};
+}
 //#endregion
 //#region src/control/common/random.ts
 function randomId() {
@@ -10689,6 +10756,11 @@ var ControlClient = class {
 	async getFlow(flowId) {
 		return flow(await this.request(`/v1/flows/${segment(flowId)}`));
 	}
+	async getErrorListeners(flowId, signal) {
+		const source = record$2(await this.request(`/v1/flows/${segment(flowId)}/error-listeners`, { signal }));
+		if (source.version != 1 || !Array.isArray(source.listeners)) return invalidResponse();
+		return source.listeners.map(errorListener);
+	}
 	async renameFlow(flowId, name) {
 		return flow(await this.request(`/v1/flows/${segment(flowId)}`, {
 			body: JSON.stringify({

package/dist/common/control-api.d.ts

@@ -24,6 +24,13 @@ export type { RunStatus } from './run-lifecycle.js';
 export { ApiError, controlErrorCode, controlErrorMetadata, type ControlErrorCode } from './control-api-errors.js';
 export type { FlowCatalogEvent, FlowChangeEvent } from './flow-notifications.js';
 export type ControlRequest = (path: string, init?: RequestInit) => Promise<Response>;
+export interface ErrorListener {
+    readonly flowId: string;
+    readonly flowName: string;
+    readonly nodeId: string;
+    readonly nodeName: string;
+    readonly enabled: boolean;
+}
 export interface Flow {
     readonly live?: {
         readonly enabled: boolean;
@@ -78,7 +85,7 @@ export interface TriggerBinding {
     readonly endpointUrl?: string;
     readonly flowId: string;
     readonly health: 'failed' | 'healthy' | 'initializing' | 'needs_reauth' | 'suspended';
-    readonly kind: 'cron' | 'integration' | 'poll' | 'webhook';
+    readonly kind: 'error' | 'cron' | 'integration' | 'poll' | 'webhook';
     readonly lastErrorCode?: string;
     readonly operatorState: 'active' | 'paused';
     readonly runtimeVersion: number;
@@ -336,7 +343,24 @@ export interface RunWait {
     readonly waitId: string;
     readonly waitingSince: string;
 }
+export type ErrorDispatch = {
+    readonly status: 'pending';
+    readonly flowId: string;
+} | {
+    readonly status: 'dispatched';
+    readonly flowId: string;
+    readonly runId: string;
+} | {
+    readonly status: 'failed';
+    readonly flowId: string;
+    readonly message: string;
+};
 type RunDetailsBase = Run & {
+    readonly errorDispatches?: readonly ErrorDispatch[];
+    readonly errorSource?: {
+        readonly flowId: string;
+        readonly runId: string;
+    };
     readonly closureDigest: string;
     readonly engineContract: string;
     readonly engineDigest: string;
@@ -379,6 +403,13 @@ export interface RunCancellation {
     readonly status: Extract<RunStatus, 'canceled' | 'completed' | 'failed' | 'indeterminate'>;
     readonly version: 1;
 }
+export interface RunFailure {
+    readonly code: string;
+    readonly message: string;
+    readonly nodeId?: string;
+    readonly jobId?: string;
+    readonly path?: readonly string[];
+}
 export type RunResult = {
     readonly finishedAt: string;
     readonly result: JsonValue;
@@ -386,10 +417,7 @@ export type RunResult = {
     readonly status: 'completed';
     readonly version: 1;
 } | {
-    readonly error: {
-        readonly code: string;
-        readonly message: string;
-    };
+    readonly error: RunFailure;
     readonly finishedAt: string;
     readonly runId: string;
     readonly status: 'failed' | 'indeterminate';
@@ -714,6 +742,7 @@ export declare class ControlClient {
     deleteVariable(name: string): Promise<void>;
     createFlow(name: string, idempotencyKey?: string, teamId?: string): Promise<Flow>;
     getFlow(flowId: string): Promise<Flow>;
+    getErrorListeners(flowId: string, signal?: AbortSignal): Promise<readonly ErrorListener[]>;
     renameFlow(flowId: string, name: string): Promise<Flow>;
     deleteFlow(flowId: string): Promise<Flow>;
     listTriggerKeys(signal?: AbortSignal, locale?: string): Promise<readonly TriggerKeySummary[]>;

package/dist/common/control-api.js

@@ -6071,6 +6071,7 @@ var endpoint = object({
 	])),
 	successStatus: number()
 });
+var sourceFlowIds = array(text.min(1)).refine((ids) => new Set(ids).size === ids.length, "Duplicate source Flow ID.");
 var trigger = {
 	name: text,
 	description: text.optional(),
@@ -6128,6 +6129,11 @@ var node = union([
 		...trigger,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger,
+		kind: literal("error"),
+		sourceFlowIds: sourceFlowIds.optional()
+	}),
 	object({
 		...trigger,
 		kind: literal("webhook"),
@@ -6199,7 +6205,11 @@ var document = object({
 	tasks: record(text, managed)
 });
 var revision = object({
-	modelVersion: union([literal(2), literal(4)]),
+	modelVersion: union([
+		literal(2),
+		literal(4),
+		literal(5)
+	]),
 	document,
 	modules: record(text, module)
 });
@@ -6209,9 +6219,16 @@ revision.extend({
 });
 function decodeRevisionContent(value) {
 	checkJsonDepth(value);
-	return revision.parse(value);
+	const content = revision.parse(value);
+	checkErrorModelVersion(content);
+	return content;
 }
 var shapes = {
+	"graph.trigger.sources.set": {
+		nodeId: text,
+		before: sourceFlowIds.optional(),
+		value: sourceFlowIds.optional()
+	},
 	"binding.create": {
 		bindingId: text,
 		binding
@@ -6385,6 +6402,9 @@ array(union([...new Map(Object.entries(shapes).map(([kind, shape]) => [kind, sha
 	kind: literal(kind),
 	...shape
 })])).values()])).min(1);
+function checkErrorModelVersion(content) {
+	if (content.modelVersion < 5 && [content.document.graph, ...Object.values(content.document.subflows).map((item) => item.graph)].some((item) => Object.values(item.nodes).some((itemNode) => itemNode.kind == "error"))) throw new TypeError("Error workflows require Flow model version 5.");
+}
 //#endregion
 //#region src/flow/common/condition.ts
 var unaryOperator = (operator) => operator.startsWith("is");
@@ -9566,6 +9586,67 @@ function createSchemaComparer() {
 createSchemaComparer();
 //#endregion
 //#region src/trigger/common/contract.ts
+var errorOutputs = [
+	{
+		handle: "workflow",
+		nullable: false,
+		jsonSchema: {
+			type: "object",
+			additionalProperties: false,
+			required: [
+				"flowId",
+				"name",
+				"revisionId",
+				"publicationId"
+			],
+			properties: {
+				flowId: { type: "string" },
+				name: { type: "string" },
+				revisionId: { type: "string" },
+				publicationId: { type: ["string", "null"] }
+			}
+		}
+	},
+	{
+		handle: "execution",
+		nullable: false,
+		jsonSchema: {
+			type: "object",
+			additionalProperties: false,
+			required: [
+				"runId",
+				"status",
+				"startedAt",
+				"finishedAt"
+			],
+			properties: {
+				runId: { type: "string" },
+				status: { enum: ["failed", "indeterminate"] },
+				startedAt: { type: ["string", "null"] },
+				finishedAt: { type: "string" }
+			}
+		}
+	},
+	{
+		handle: "error",
+		nullable: false,
+		jsonSchema: {
+			type: "object",
+			additionalProperties: false,
+			required: ["code", "message"],
+			properties: {
+				code: { type: "string" },
+				message: { type: "string" },
+				nodeId: { type: "string" },
+				jobId: { type: "string" },
+				path: {
+					type: "array",
+					items: { type: "string" }
+				}
+			}
+		}
+	}
+];
 var webhookOutputs = [
 	{
 		handle: "headers",
@@ -9610,6 +9691,7 @@ var cronOutputs = [{
 }];
 function triggerOutputDefinitions(trigger) {
 	switch (trigger.kind) {
+		case "error": return errorOutputs;
 		case "manual": return [];
 		case "cron": return cronOutputs;
 		case "poll":
@@ -9638,6 +9720,7 @@ function nodeInputPorts(document, node) {
 		case "cron":
 		case "integration":
 		case "poll":
+		case "error":
 		case "manual":
 		case "webhook": return {};
 	}
@@ -9688,6 +9771,7 @@ function nodeOutputPorts(document, node) {
 		case "cron":
 		case "integration":
 		case "poll":
+		case "error":
 		case "manual":
 		case "webhook": return triggerOutputPorts(node);
 	}
@@ -9839,6 +9923,7 @@ function inspectNode(document, node) {
 				})) }))
 			}))
 		};
+		case "error":
 		case "manual":
 		case "cron":
 		case "subflow": return {
@@ -10023,6 +10108,7 @@ function triggerKey(value) {
 	};
 }
 var triggerKinds = /* @__PURE__ */ new Set([
+	"error",
 	"cron",
 	"integration",
 	"poll",
@@ -10528,6 +10614,17 @@ function variable(value) {
 		version: 1
 	};
 }
+function errorListener(value) {
+	const source = record$1(value);
+	if (typeof source.enabled != "boolean") return invalidResponse();
+	return {
+		flowId: string$1(source.flowId),
+		flowName: string$1(source.flowName),
+		nodeId: string$1(source.nodeId),
+		nodeName: string$1(source.nodeName),
+		enabled: source.enabled
+	};
+}
 //#endregion
 //#region src/control/common/publicationDecoders.ts
 function publication(value) {
@@ -10797,6 +10894,7 @@ function runDetails(value) {
 	};
 	const details = {
 		...summary,
+		...errorHandling(source),
 		closureDigest: string$1(source.closureDigest),
 		engineContract: string$1(source.engineContract),
 		engineDigest: string$1(source.engineDigest),
@@ -10896,10 +10994,7 @@ function runResult(value) {
 		const error = record$1(source.error);
 		return {
 			...base,
-			error: {
-				code: string$1(error.code),
-				message: string$1(error.message)
-			},
+			error: runFailure(error),
 			status: "failed"
 		};
 	}
@@ -10907,15 +11002,52 @@ function runResult(value) {
 		const error = record$1(source.error);
 		return {
 			...base,
-			error: {
-				code: string$1(error.code),
-				message: string$1(error.message)
-			},
+			error: runFailure(error),
 			status: "indeterminate"
 		};
 	}
 	return invalidResponse();
 }
+function errorHandling(source) {
+	const errorSource = source.errorSource == null ? void 0 : record$1(source.errorSource);
+	if (source.errorDispatches != null && !Array.isArray(source.errorDispatches)) return invalidResponse();
+	return {
+		...errorSource == null ? {} : { errorSource: {
+			flowId: string$1(errorSource.flowId),
+			runId: string$1(errorSource.runId)
+		} },
+		...source.errorDispatches == null ? {} : { errorDispatches: source.errorDispatches.map((value) => {
+			const dispatch = record$1(value);
+			const flowId = string$1(dispatch.flowId);
+			switch (dispatch.status) {
+				case "pending": return {
+					status: "pending",
+					flowId
+				};
+				case "dispatched": return {
+					status: "dispatched",
+					flowId,
+					runId: string$1(dispatch.runId)
+				};
+				case "failed": return {
+					status: "failed",
+					flowId,
+					message: string$1(dispatch.message)
+				};
+				default: return invalidResponse();
+			}
+		}) }
+	};
+}
+function runFailure(error) {
+	return {
+		code: string$1(error.code),
+		message: string$1(error.message),
+		...error.nodeId === void 0 ? {} : { nodeId: string$1(error.nodeId) },
+		...error.jobId === void 0 ? {} : { jobId: string$1(error.jobId) },
+		...error.path === void 0 ? {} : { path: (Array.isArray(error.path) ? error.path : invalidResponse()).map(string$1) }
+	};
+}
 //#endregion
 //#region src/control/common/random.ts
 function randomId() {
@@ -11214,6 +11346,11 @@ var ControlClient = class {
 	async getFlow(flowId) {
 		return flow(await this.request(`/v1/flows/${segment(flowId)}`));
 	}
+	async getErrorListeners(flowId, signal) {
+		const source = record$1(await this.request(`/v1/flows/${segment(flowId)}/error-listeners`, { signal }));
+		if (source.version != 1 || !Array.isArray(source.listeners)) return invalidResponse();
+		return source.listeners.map(errorListener);
+	}
 	async renameFlow(flowId, name) {
 		return flow(await this.request(`/v1/flows/${segment(flowId)}`, {
 			body: JSON.stringify({

package/dist/common/control-requests.js

@@ -6021,6 +6021,7 @@ var endpoint = object({
 	])),
 	successStatus: number()
 });
+var sourceFlowIds = array(text$1.min(1)).refine((ids) => new Set(ids).size === ids.length, "Duplicate source Flow ID.");
 var trigger$1 = {
 	name: text$1,
 	description: text$1.optional(),
@@ -6078,6 +6079,11 @@ var node = union([
 		...trigger$1,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger$1,
+		kind: literal("error"),
+		sourceFlowIds: sourceFlowIds.optional()
+	}),
 	object({
 		...trigger$1,
 		kind: literal("webhook"),
@@ -6149,7 +6155,11 @@ var document = object({
 	tasks: record(text$1, managed)
 });
 object({
-	modelVersion: union([literal(2), literal(4)]),
+	modelVersion: union([
+		literal(2),
+		literal(4),
+		literal(5)
+	]),
 	document,
 	modules: record(text$1, module)
 }).extend({
@@ -6157,6 +6167,11 @@ object({
 	version: literal(1)
 });
 var shapes = {
+	"graph.trigger.sources.set": {
+		nodeId: text$1,
+		before: sourceFlowIds.optional(),
+		value: sourceFlowIds.optional()
+	},
 	"binding.create": {
 		bindingId: text$1,
 		binding
@@ -10449,6 +10464,7 @@ var eventSourceRevisionSchema = strictObject({
 var target = { kind: "flow" };
 var descriptions = {
 	"manual": "A Manual start node.",
+	"error": "An Error Trigger. Publish and enable this Flow before selecting it as another Flow’s error workflow.",
 	"webhook": "A Webhook start node.",
 	"cron": "An hourly scheduled start node.",
 	"poll": "Gmail polling by key; replace CONNECTION_ID with an active Gmail connection.",
@@ -10471,6 +10487,12 @@ var authoringExamples = Object.keys(descriptions).map((name) => ({
 function authoringExample(name) {
 	let operations;
 	switch (name) {
+		case "error":
+			operations = createBuiltinTrigger(target, "error", {
+				kind: "error",
+				name: "Error Trigger"
+			});
+			break;
 		case "manual":
 			operations = createBuiltinTrigger(target, "start", {
 				kind: "manual",

package/dist/common/flow-encoding.js

@@ -5825,6 +5825,7 @@ var endpoint = object({
 	])),
 	successStatus: number()
 });
+var sourceFlowIds = array(text.min(1)).refine((ids) => new Set(ids).size === ids.length, "Duplicate source Flow ID.");
 var trigger = {
 	name: text,
 	description: text.optional(),
@@ -5882,6 +5883,11 @@ var node = union([
 		...trigger,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger,
+		kind: literal("error"),
+		sourceFlowIds: sourceFlowIds.optional()
+	}),
 	object({
 		...trigger,
 		kind: literal("webhook"),
@@ -5953,7 +5959,11 @@ var document = object({
 	tasks: record$1(text, managed)
 });
 var revision = object({
-	modelVersion: union([literal(2), literal(4)]),
+	modelVersion: union([
+		literal(2),
+		literal(4),
+		literal(5)
+	]),
 	document,
 	modules: record$1(text, module)
 });
@@ -6113,7 +6123,7 @@ function repairRevisionEnvelope(value) {
 	checkJsonDepth(value);
 	const envelopeSource = record(value);
 	if (envelopeSource.kind != "open-flow-flow-revision" || envelopeSource.version != 1) throw new TypeError("The value is not an Open Flow Revision envelope.");
-	if (typeof envelopeSource.modelVersion == "number" && envelopeSource.modelVersion > 4) throw new TypeError("The Flow model is newer than this package.");
+	if (typeof envelopeSource.modelVersion == "number" && envelopeSource.modelVersion > 5) throw new TypeError("The Flow model is newer than this package.");
 	const sourceDocument = record(envelopeSource.modelVersion == 1 || envelopeSource.modelVersion == 2 ? upgradeLegacyDocument(envelopeSource.document) : envelopeSource.document);
 	const bindings = record(sourceDocument.bindings);
 	const sourceGraph = repairGraph(sourceDocument.graph, bindings);
@@ -6126,7 +6136,7 @@ function repairRevisionEnvelope(value) {
 		return result.success ? [[id, result.data]] : [];
 	}));
 	return decodeRevisionContent({
-		modelVersion: 4,
+		modelVersion: 5,
 		document: {
 			bindings: repairedEntries(sourceDocument.bindings, binding),
 			graph: sourceGraph,
@@ -6142,7 +6152,9 @@ function decodeFlowDocument(value) {
 }
 function decodeRevisionContent(value) {
 	checkJsonDepth(value);
-	return revision.parse(value);
+	const content = revision.parse(value);
+	checkErrorModelVersion(content);
+	return content;
 }
 function decodeRevisionEnvelope(value) {
 	checkJsonDepth(value);
@@ -6152,6 +6164,7 @@ function decodeRevisionEnvelope(value) {
 		document: upgradeLegacyDocument(revisionSource.document)
 	} : value;
 	const content = envelope.parse(candidate);
+	checkErrorModelVersion(content);
 	return {
 		modelVersion: content.modelVersion,
 		document: content.document,
@@ -6159,6 +6172,11 @@ function decodeRevisionEnvelope(value) {
 	};
 }
 var shapes = {
+	"graph.trigger.sources.set": {
+		nodeId: text,
+		before: sourceFlowIds.optional(),
+		value: sourceFlowIds.optional()
+	},
 	"binding.create": {
 		bindingId: text,
 		binding
@@ -6332,6 +6350,9 @@ array(union([...new Map(Object.entries(shapes).map(([kind, shape]) => [kind, sha
 	kind: literal(kind),
 	...shape
 })])).values()])).min(1);
+function checkErrorModelVersion(content) {
+	if (content.modelVersion < 5 && [content.document.graph, ...Object.values(content.document.subflows).map((item) => item.graph)].some((item) => Object.values(item.nodes).some((itemNode) => itemNode.kind == "error"))) throw new TypeError("Error workflows require Flow model version 5.");
+}
 //#endregion
 //#region src/flow/common/encoding.ts
 var encoder = new TextEncoder();
@@ -6606,6 +6627,10 @@ function canonicalTriggerNode(trigger) {
 		name: trigger.name
 	});
 	switch (trigger.kind) {
+		case "error": return {
+			...common(trigger.kind),
+			...trigger.sourceFlowIds == null ? {} : { sourceFlowIds: [...trigger.sourceFlowIds] }
+		};
 		case "manual": return common(trigger.kind);
 		case "webhook": return {
 			...common(trigger.kind),
@@ -6705,7 +6730,7 @@ function revisionRepairKind(bytes) {
 		return;
 	}
 	const source = value;
-	return typeof source.modelVersion == "number" && source.modelVersion < 4 ? "upgrade" : "repair";
+	return typeof source.modelVersion == "number" && source.modelVersion < 5 ? "upgrade" : "repair";
 }
 function repairRevision(bytes) {
 	return repairRevisionEnvelope(revisionValue(bytes));