@effect-opcua/client 0.1.0-alpha.1

package/dist/internal/session/service.mjs

@@ -0,0 +1,232 @@
+import { serviceError } from "../../OpcuaError.mjs";
+import { makeStructureRuntime } from "../structures/runtime.mjs";
+import { readVariable, writeVariable } from "../variable/operations.mjs";
+import { makeVariableDef } from "../../OpcuaVariable.mjs";
+import { DEFAULT_BROWSE_DIRECTION, DEFAULT_BROWSE_INCLUDE_SUBTYPES, DEFAULT_BROWSE_MAX_REFERENCES_PER_NODE, DEFAULT_BROWSE_NODE_CLASS_MASK, DEFAULT_BROWSE_REFERENCE_TYPE_ID, DEFAULT_BROWSE_RESULT_MASK } from "../common/constants.mjs";
+import { callResolvedMethod, resolveMethod } from "../method/operations.mjs";
+import { browseContinuationError, browseOptionsError, browseWithMaxReferences, normalizeBrowseResult } from "../browse/operations.mjs";
+import { makeMetadataService } from "../metadata/service.mjs";
+import { callManyWithState, readManyWithState, writeManyWithState } from "../batch/operations.mjs";
+import { makeSubscriptionRuntime } from "../subscription/runtime.mjs";
+import { readDataTypeDefinition, readManyDataTypeDefinitions } from "../data-types/read.mjs";
+import { OpcuaSession as Session } from "../../OpcuaSession.mjs";
+import { resolveNodeId } from "node-opcua";
+import { Effect, Result, Semaphore, Stream } from "effect";
+
+//#region src/internal/session/service.ts
+const makeSession = Effect.fnUntraced(function* (unsafeRaw, events, options) {
+	const browseSemaphore = Semaphore.makeUnsafe(1);
+	const structureRuntime = makeStructureRuntime(unsafeRaw);
+	const metadata = makeMetadataService(unsafeRaw, structureRuntime);
+	const state = {
+		unsafeRaw,
+		metadata,
+		structureRuntime,
+		batching: options?.batching
+	};
+	yield* Effect.acquireRelease(Effect.sync(() => {
+		const listener = () => {
+			Effect.runSync(metadata.invalidate.pipe(Effect.andThen(structureRuntime.invalidate)));
+		};
+		unsafeRaw.on("session_restored", listener);
+		return listener;
+	}), (listener) => Effect.sync(() => {
+		if ("off" in unsafeRaw && typeof unsafeRaw.off === "function") unsafeRaw.off("session_restored", listener);
+		else unsafeRaw.removeListener("session_restored", listener);
+	}));
+	const read = (def) => Effect.gen(function* () {
+		yield* metadata.variable(def);
+		return yield* readVariable(unsafeRaw, def, structureRuntime);
+	}).pipe(Effect.withSpan("opcua.session.read", {
+		attributes: { "opcua.node_id": def.nodeId },
+		kind: "client"
+	}));
+	const write = (def, value) => Effect.gen(function* () {
+		const variableMetadata = yield* metadata.variable(def);
+		return yield* writeVariable(unsafeRaw, def, variableMetadata, value, structureRuntime);
+	}).pipe(Effect.withSpan("opcua.session.write", {
+		attributes: { "opcua.node_id": def.nodeId },
+		kind: "client"
+	}));
+	const readMany = (items, options$1) => readManyWithState(state, items, options$1).pipe(Effect.withSpan("opcua.session.readMany", {
+		attributes: { "opcua.node_count": Object.keys(items).length },
+		kind: "client"
+	}));
+	const writeMany = (items, options$1) => writeManyWithState(state, items, options$1).pipe(Effect.withSpan("opcua.session.writeMany", {
+		attributes: { "opcua.node_count": Object.keys(items).length },
+		kind: "client"
+	}));
+	const makeSubscription = (options$1) => makeSubscriptionRuntime(unsafeRaw, options$1, structureRuntime, (def) => metadata.variable(def));
+	const call = (def, input, options$1) => Effect.gen(function* () {
+		const methodMetadata = yield* metadata.method(def);
+		const method = yield* resolveMethod(def, methodMetadata);
+		return yield* callResolvedMethod(unsafeRaw, method, input, structureRuntime, options$1);
+	}).pipe(Effect.withSpan("opcua.session.call", {
+		attributes: {
+			"opcua.object_id": def.objectId,
+			"opcua.method_id": def.methodId
+		},
+		kind: "client"
+	}));
+	const callMany = (items, options$1) => callManyWithState(state, items, options$1).pipe(Effect.withSpan("opcua.session.callMany", {
+		attributes: { "opcua.method_count": Object.keys(items).length },
+		kind: "client"
+	}));
+	const browse = (input) => Effect.gen(function* () {
+		const validationError = browseOptionsError(input);
+		if (validationError) return yield* Effect.fail(validationError);
+		const result = yield* Effect.tryPromise({
+			try: () => browseWithMaxReferences(unsafeRaw, {
+				nodeId: resolveNodeId(input.nodeId),
+				referenceTypeId: resolveNodeId(input.referenceTypeId ?? DEFAULT_BROWSE_REFERENCE_TYPE_ID),
+				browseDirection: input.browseDirection ?? DEFAULT_BROWSE_DIRECTION,
+				includeSubtypes: input.includeSubtypes ?? DEFAULT_BROWSE_INCLUDE_SUBTYPES,
+				nodeClassMask: input.nodeClassMask ?? DEFAULT_BROWSE_NODE_CLASS_MASK,
+				resultMask: input.resultMask ?? DEFAULT_BROWSE_RESULT_MASK
+			}, input.maxReferencesPerNode ?? DEFAULT_BROWSE_MAX_REFERENCES_PER_NODE),
+			catch: (cause) => serviceError({
+				operation: "browse",
+				nodeId: input.nodeId,
+				cause
+			})
+		}).pipe(browseSemaphore.withPermits(1));
+		return normalizeBrowseResult(input.nodeId, result, input.includeRaw ?? false);
+	}).pipe(Effect.withSpan("opcua.session.browse", {
+		attributes: {
+			"opcua.node_id": input.nodeId,
+			"opcua.max_references_per_node": input.maxReferencesPerNode ?? DEFAULT_BROWSE_MAX_REFERENCES_PER_NODE
+		},
+		kind: "client"
+	}));
+	const browseNext = (continuation) => Effect.gen(function* () {
+		const validationError = browseContinuationError("browseNext", continuation);
+		if (validationError) return yield* Effect.fail(validationError);
+		const result = yield* Effect.tryPromise({
+			try: () => unsafeRaw.browseNext(continuation.unsafeRaw, false),
+			catch: (cause) => serviceError({
+				operation: "browseNext",
+				nodeId: continuation.nodeId,
+				cause
+			})
+		});
+		return normalizeBrowseResult(continuation.nodeId, result, continuation.includeRaw ?? false);
+	}).pipe(Effect.withSpan("opcua.session.browseNext", {
+		attributes: { "opcua.node_id": continuation.nodeId },
+		kind: "client"
+	}));
+	const releaseBrowseContinuation = (continuation) => Effect.gen(function* () {
+		const validationError = browseContinuationError("releaseBrowseContinuation", continuation);
+		if (validationError) return yield* Effect.fail(validationError);
+		yield* Effect.tryPromise({
+			try: () => unsafeRaw.browseNext(continuation.unsafeRaw, true),
+			catch: (cause) => serviceError({
+				operation: "releaseBrowseContinuation",
+				nodeId: continuation.nodeId,
+				cause
+			})
+		});
+	}).pipe(Effect.withSpan("opcua.session.releaseBrowseContinuation", {
+		attributes: { "opcua.node_id": continuation.nodeId },
+		kind: "client"
+	}));
+	const browseChildren = (nodeId, options$1) => Effect.gen(function* () {
+		const mode = options$1?.mode ?? "all";
+		const first = yield* browse({
+			nodeId,
+			referenceTypeId: options$1?.referenceTypeId ?? DEFAULT_BROWSE_REFERENCE_TYPE_ID,
+			includeSubtypes: options$1?.includeSubtypes ?? DEFAULT_BROWSE_INCLUDE_SUBTYPES,
+			nodeClassMask: options$1?.nodeClassMask ?? DEFAULT_BROWSE_NODE_CLASS_MASK,
+			maxReferencesPerNode: options$1?.maxReferencesPerNode ?? DEFAULT_BROWSE_MAX_REFERENCES_PER_NODE,
+			includeRaw: options$1?.includeRaw
+		});
+		if (first._tag === "NonGoodStatus") return first;
+		if (mode === "page") return {
+			_tag: "Browsed",
+			nodeId,
+			status: first.status,
+			references: first.references,
+			continuation: first.continuation
+		};
+		const references = [...first.references];
+		let continuation = first.continuation;
+		while (continuation) {
+			const next = yield* browseNext({
+				...continuation,
+				includeRaw: options$1?.includeRaw
+			});
+			if (next._tag === "NonGoodStatus") return next;
+			references.push(...next.references);
+			continuation = next.continuation;
+		}
+		return {
+			_tag: "Browsed",
+			nodeId,
+			status: first.status,
+			references
+		};
+	}).pipe(Effect.withSpan("opcua.session.browseChildren", {
+		attributes: {
+			"opcua.node_id": nodeId,
+			"opcua.browse_mode": options$1?.mode ?? "all"
+		},
+		kind: "client"
+	}));
+	const readNamespaceArray = () => metadata.namespaceArray();
+	const readNodeMetadata = (nodeId) => metadata.node(nodeId);
+	const readManyNodeMetadata = (nodeIds) => metadata.nodes(nodeIds);
+	const readDataTypeDefinition$1 = (dataTypeNodeId) => readDataTypeDefinition(unsafeRaw, metadata, dataTypeNodeId);
+	const readManyDataTypeDefinitions$1 = (dataTypeNodeIds) => readManyDataTypeDefinitions(unsafeRaw, metadata, dataTypeNodeIds);
+	const isValueReadable = (nodeMetadata) => nodeMetadata.accessLevel?.readable === true && nodeMetadata.userAccessLevel?.readable !== false;
+	const inspectValue = (nodeId, nodeMetadata) => isValueReadable(nodeMetadata) ? Effect.map(Effect.result(read(makeVariableDef({
+		nodeId,
+		access: "read"
+	}))), (result) => Result.isSuccess(result) ? result.success : {
+		_tag: "ReadFailed",
+		nodeId,
+		error: result.failure
+	}) : Effect.succeed({
+		_tag: "NotReadable",
+		nodeId
+	});
+	const inspectNode = (nodeId, options$1) => Effect.gen(function* () {
+		const nodeMetadata = yield* metadata.node(nodeId);
+		return {
+			nodeId,
+			metadata: nodeMetadata,
+			value: options$1?.value === true ? yield* inspectValue(nodeId, nodeMetadata) : void 0,
+			dataTypeDefinition: options$1?.dataTypeDefinition === true && nodeMetadata.dataType !== void 0 ? yield* readDataTypeDefinition(unsafeRaw, metadata, nodeMetadata.dataType) : void 0
+		};
+	}).pipe(Effect.withSpan("opcua.session.inspectNode", {
+		attributes: {
+			"opcua.node_id": nodeId,
+			"opcua.inspect_value": options$1?.value === true,
+			"opcua.inspect_data_type_definition": options$1?.dataTypeDefinition === true
+		},
+		kind: "client"
+	}));
+	return Session.of({
+		read,
+		write,
+		readMany,
+		writeMany,
+		makeSubscription,
+		call,
+		callMany,
+		browse,
+		browseNext,
+		releaseBrowseContinuation,
+		browseChildren,
+		readNamespaceArray,
+		readNodeMetadata,
+		readManyNodeMetadata,
+		readDataTypeDefinition: readDataTypeDefinition$1,
+		readManyDataTypeDefinitions: readManyDataTypeDefinitions$1,
+		inspectNode,
+		events: Stream.fromPubSub(events),
+		unsafeRaw
+	});
+});
+
+//#endregion
+export { makeSession };
+//# sourceMappingURL=service.mjs.map

package/dist/internal/session/service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.mjs","names":["makeSession: (\n  unsafeRaw: ClientSession,\n  events: PubSub.PubSub<OpcuaSessionEvent>,\n  options?: Pick<OpcuaSession.SessionOptions, \"batching\">,\n) => Effect.Effect<OpcuaSession.SessionService, never, Scope.Scope>","state: SessionOperationsState","read: OpcuaSession.SessionService[\"read\"]","VariableOperations.readVariable","write: OpcuaSession.SessionService[\"write\"]","VariableOperations.writeVariable","readMany: OpcuaSession.SessionService[\"readMany\"]","options","writeMany: OpcuaSession.SessionService[\"writeMany\"]","makeSubscription: OpcuaSession.SessionService[\"makeSubscription\"]","call: OpcuaSession.SessionService[\"call\"]","MethodOperations.resolveMethod","MethodOperations.callResolvedMethod","callMany: OpcuaSession.SessionService[\"callMany\"]","browse: OpcuaSession.SessionService[\"browse\"]","OpcuaError.serviceError","browseNext: OpcuaSession.SessionService[\"browseNext\"]","releaseBrowseContinuation: OpcuaSession.SessionService[\"releaseBrowseContinuation\"]","browseChildren: OpcuaSession.SessionService[\"browseChildren\"]","readNamespaceArray: OpcuaSession.SessionService[\"readNamespaceArray\"]","readNodeMetadata: OpcuaSession.SessionService[\"readNodeMetadata\"]","readManyNodeMetadata: OpcuaSession.SessionService[\"readManyNodeMetadata\"]","readDataTypeDefinition: OpcuaSession.SessionService[\"readDataTypeDefinition\"]","readDataTypeDefinitionImpl","readManyDataTypeDefinitions: OpcuaSession.SessionService[\"readManyDataTypeDefinitions\"]","readManyDataTypeDefinitionsImpl","OpcuaVariable.makeVariableDef","inspectNode: OpcuaSession.SessionService[\"inspectNode\"]"],"sources":["../../../src/internal/session/service.ts"],"sourcesContent":["import { resolveNodeId, type ClientSession } from \"node-opcua\";\nimport { Effect, PubSub, Result, Scope, Semaphore, Stream } from \"effect\";\n\nimport * as OpcuaError from \"../../OpcuaError.js\";\nimport * as OpcuaSession from \"../../OpcuaSession.js\";\nimport * as OpcuaVariable from \"../../OpcuaVariable.js\";\nimport * as MethodOperations from \"../method/operations.js\";\nimport * as VariableOperations from \"../variable/operations.js\";\n\nimport {\n  browseContinuationError,\n  browseOptionsError,\n  browseWithMaxReferences,\n  normalizeBrowseResult,\n} from \"../browse/operations.js\";\nimport { type OpcuaSessionEvent } from \"../events/model.js\";\nimport { makeMetadataService } from \"../metadata/service.js\";\nimport { makeStructureRuntime } from \"../structures/runtime.js\";\nimport {\n  callManyWithState,\n  readManyWithState,\n  writeManyWithState,\n  type SessionOperationsState,\n} from \"../batch/operations.js\";\nimport { makeSubscriptionRuntime } from \"../subscription/runtime.js\";\nimport {\n  readDataTypeDefinition as readDataTypeDefinitionImpl,\n  readManyDataTypeDefinitions as readManyDataTypeDefinitionsImpl,\n} from \"../data-types/read.js\";\n\nimport {\n  DEFAULT_BROWSE_DIRECTION,\n  DEFAULT_BROWSE_INCLUDE_SUBTYPES,\n  DEFAULT_BROWSE_MAX_REFERENCES_PER_NODE,\n  DEFAULT_BROWSE_NODE_CLASS_MASK,\n  DEFAULT_BROWSE_REFERENCE_TYPE_ID,\n  DEFAULT_BROWSE_RESULT_MASK,\n} from \"../common/constants.js\";\n\nexport const makeSession: (\n  unsafeRaw: ClientSession,\n  events: PubSub.PubSub<OpcuaSessionEvent>,\n  options?: Pick<OpcuaSession.SessionOptions, \"batching\">,\n) => Effect.Effect<OpcuaSession.SessionService, never, Scope.Scope> =\n  Effect.fnUntraced(function* (unsafeRaw, events, options) {\n    const browseSemaphore = Semaphore.makeUnsafe(1);\n    const structureRuntime = makeStructureRuntime(unsafeRaw);\n    const metadata = makeMetadataService(unsafeRaw, structureRuntime);\n    const state: SessionOperationsState = {\n      unsafeRaw,\n      metadata,\n      structureRuntime,\n      batching: options?.batching,\n    };\n    yield* Effect.acquireRelease(\n      Effect.sync(() => {\n        const listener = () => {\n          Effect.runSync(\n            metadata.invalidate.pipe(\n              Effect.andThen(structureRuntime.invalidate),\n            ),\n          );\n        };\n        unsafeRaw.on(\"session_restored\", listener);\n        return listener;\n      }),\n      (listener) =>\n        Effect.sync(() => {\n          if (\"off\" in unsafeRaw && typeof unsafeRaw.off === \"function\") {\n            unsafeRaw.off(\"session_restored\", listener);\n          } else {\n            unsafeRaw.removeListener(\"session_restored\", listener);\n          }\n        }),\n    );\n\n    const read: OpcuaSession.SessionService[\"read\"] = (def) =>\n      Effect.gen(function* () {\n        yield* metadata.variable(def);\n        const result = yield* VariableOperations.readVariable(\n          unsafeRaw,\n          def,\n          structureRuntime,\n        );\n        return result as OpcuaVariable.ReadResult<\n          OpcuaVariable.ValueOfVariableDef<typeof def>,\n          OpcuaVariable.NodeIdOfVariableDef<typeof def>\n        >;\n      }).pipe(\n        Effect.withSpan(\"opcua.session.read\", {\n          attributes: { \"opcua.node_id\": def.nodeId },\n          kind: \"client\",\n        }),\n      );\n\n    const write: OpcuaSession.SessionService[\"write\"] = (def, value) =>\n      Effect.gen(function* () {\n        const variableMetadata = yield* metadata.variable(def);\n        const result = yield* VariableOperations.writeVariable(\n          unsafeRaw,\n          def,\n          variableMetadata,\n          value,\n          structureRuntime,\n        );\n        return result as OpcuaVariable.WriteResult<\n          OpcuaVariable.NodeIdOfVariableDef<typeof def>\n        >;\n      }).pipe(\n        Effect.withSpan(\"opcua.session.write\", {\n          attributes: { \"opcua.node_id\": def.nodeId },\n          kind: \"client\",\n        }),\n      );\n\n    const readMany: OpcuaSession.SessionService[\"readMany\"] = (\n      items,\n      options,\n    ) =>\n      readManyWithState(state, items, options).pipe(\n        Effect.withSpan(\"opcua.session.readMany\", {\n          attributes: { \"opcua.node_count\": Object.keys(items).length },\n          kind: \"client\",\n        }),\n      );\n\n    const writeMany: OpcuaSession.SessionService[\"writeMany\"] = (\n      items,\n      options,\n    ) =>\n      writeManyWithState(state, items, options).pipe(\n        Effect.withSpan(\"opcua.session.writeMany\", {\n          attributes: { \"opcua.node_count\": Object.keys(items).length },\n          kind: \"client\",\n        }),\n      );\n\n    const makeSubscription: OpcuaSession.SessionService[\"makeSubscription\"] = (\n      options,\n    ) =>\n      makeSubscriptionRuntime(unsafeRaw, options, structureRuntime, (def) =>\n        metadata.variable(def),\n      );\n\n    const call: OpcuaSession.SessionService[\"call\"] = (def, input, options) =>\n      Effect.gen(function* () {\n        const methodMetadata = yield* metadata.method(def);\n        const method = yield* MethodOperations.resolveMethod(\n          def,\n          methodMetadata,\n        );\n        return yield* MethodOperations.callResolvedMethod(\n          unsafeRaw,\n          method,\n          input,\n          structureRuntime,\n          options,\n        );\n      }).pipe(\n        Effect.withSpan(\"opcua.session.call\", {\n          attributes: {\n            \"opcua.object_id\": def.objectId,\n            \"opcua.method_id\": def.methodId,\n          },\n          kind: \"client\",\n        }),\n      );\n\n    const callMany: OpcuaSession.SessionService[\"callMany\"] = (\n      items,\n      options,\n    ) =>\n      callManyWithState(state, items, options).pipe(\n        Effect.withSpan(\"opcua.session.callMany\", {\n          attributes: { \"opcua.method_count\": Object.keys(items).length },\n          kind: \"client\",\n        }),\n      );\n\n    const browse: OpcuaSession.SessionService[\"browse\"] = (input) =>\n      Effect.gen(function* () {\n        const validationError = browseOptionsError(input);\n        if (validationError) return yield* Effect.fail(validationError);\n\n        const result = yield* Effect.tryPromise({\n          try: () =>\n            browseWithMaxReferences(\n              unsafeRaw,\n              {\n                nodeId: resolveNodeId(input.nodeId),\n                referenceTypeId: resolveNodeId(\n                  input.referenceTypeId ?? DEFAULT_BROWSE_REFERENCE_TYPE_ID,\n                ),\n                browseDirection:\n                  input.browseDirection ?? DEFAULT_BROWSE_DIRECTION,\n                includeSubtypes:\n                  input.includeSubtypes ?? DEFAULT_BROWSE_INCLUDE_SUBTYPES,\n                nodeClassMask:\n                  input.nodeClassMask ?? DEFAULT_BROWSE_NODE_CLASS_MASK,\n                resultMask: input.resultMask ?? DEFAULT_BROWSE_RESULT_MASK,\n              },\n              input.maxReferencesPerNode ??\n                DEFAULT_BROWSE_MAX_REFERENCES_PER_NODE,\n            ),\n          catch: (cause) =>\n            OpcuaError.serviceError({\n              operation: \"browse\",\n              nodeId: input.nodeId,\n              cause,\n            }),\n        }).pipe(browseSemaphore.withPermits(1));\n\n        return normalizeBrowseResult(\n          input.nodeId,\n          result,\n          input.includeRaw ?? false,\n        );\n      }).pipe(\n        Effect.withSpan(\"opcua.session.browse\", {\n          attributes: {\n            \"opcua.node_id\": input.nodeId,\n            \"opcua.max_references_per_node\":\n              input.maxReferencesPerNode ??\n              DEFAULT_BROWSE_MAX_REFERENCES_PER_NODE,\n          },\n          kind: \"client\",\n        }),\n      );\n\n    const browseNext: OpcuaSession.SessionService[\"browseNext\"] = (\n      continuation,\n    ) =>\n      Effect.gen(function* () {\n        const validationError = browseContinuationError(\n          \"browseNext\",\n          continuation,\n        );\n        if (validationError) return yield* Effect.fail(validationError);\n\n        const result = yield* Effect.tryPromise({\n          try: () => unsafeRaw.browseNext(continuation.unsafeRaw, false),\n          catch: (cause) =>\n            OpcuaError.serviceError({\n              operation: \"browseNext\",\n              nodeId: continuation.nodeId,\n              cause,\n            }),\n        });\n\n        return normalizeBrowseResult(\n          continuation.nodeId,\n          result,\n          continuation.includeRaw ?? false,\n        );\n      }).pipe(\n        Effect.withSpan(\"opcua.session.browseNext\", {\n          attributes: { \"opcua.node_id\": continuation.nodeId },\n          kind: \"client\",\n        }),\n      );\n\n    const releaseBrowseContinuation: OpcuaSession.SessionService[\"releaseBrowseContinuation\"] =\n      (continuation) =>\n        Effect.gen(function* () {\n          const validationError = browseContinuationError(\n            \"releaseBrowseContinuation\",\n            continuation,\n          );\n          if (validationError) return yield* Effect.fail(validationError);\n\n          yield* Effect.tryPromise({\n            try: () => unsafeRaw.browseNext(continuation.unsafeRaw, true),\n            catch: (cause) =>\n              OpcuaError.serviceError({\n                operation: \"releaseBrowseContinuation\",\n                nodeId: continuation.nodeId,\n                cause,\n              }),\n          });\n        }).pipe(\n          Effect.withSpan(\"opcua.session.releaseBrowseContinuation\", {\n            attributes: { \"opcua.node_id\": continuation.nodeId },\n            kind: \"client\",\n          }),\n        );\n\n    const browseChildren: OpcuaSession.SessionService[\"browseChildren\"] = (\n      nodeId,\n      options,\n    ) =>\n      Effect.gen(function* () {\n        const mode = options?.mode ?? \"all\";\n        const first = yield* browse({\n          nodeId,\n          referenceTypeId:\n            options?.referenceTypeId ?? DEFAULT_BROWSE_REFERENCE_TYPE_ID,\n          includeSubtypes:\n            options?.includeSubtypes ?? DEFAULT_BROWSE_INCLUDE_SUBTYPES,\n          nodeClassMask:\n            options?.nodeClassMask ?? DEFAULT_BROWSE_NODE_CLASS_MASK,\n          maxReferencesPerNode:\n            options?.maxReferencesPerNode ??\n            DEFAULT_BROWSE_MAX_REFERENCES_PER_NODE,\n          includeRaw: options?.includeRaw,\n        });\n        if (first._tag === \"NonGoodStatus\") return first;\n        if (mode === \"page\") {\n          return {\n            _tag: \"Browsed\" as const,\n            nodeId,\n            status: first.status,\n            references: first.references,\n            continuation: first.continuation,\n          };\n        }\n\n        const references = [...first.references];\n        let continuation = first.continuation;\n        while (continuation) {\n          const next = yield* browseNext({\n            ...continuation,\n            includeRaw: options?.includeRaw,\n          });\n          if (next._tag === \"NonGoodStatus\") return next;\n          references.push(...next.references);\n          continuation = next.continuation;\n        }\n        return {\n          _tag: \"Browsed\" as const,\n          nodeId,\n          status: first.status,\n          references,\n        };\n      }).pipe(\n        Effect.withSpan(\"opcua.session.browseChildren\", {\n          attributes: {\n            \"opcua.node_id\": nodeId,\n            \"opcua.browse_mode\": options?.mode ?? \"all\",\n          },\n          kind: \"client\",\n        }),\n      );\n\n    const readNamespaceArray: OpcuaSession.SessionService[\"readNamespaceArray\"] =\n      () => metadata.namespaceArray();\n\n    const readNodeMetadata: OpcuaSession.SessionService[\"readNodeMetadata\"] = (\n      nodeId,\n    ) => metadata.node(nodeId);\n\n    const readManyNodeMetadata: OpcuaSession.SessionService[\"readManyNodeMetadata\"] =\n      (nodeIds) => metadata.nodes(nodeIds);\n\n    const readDataTypeDefinition: OpcuaSession.SessionService[\"readDataTypeDefinition\"] =\n      (dataTypeNodeId) =>\n        readDataTypeDefinitionImpl(unsafeRaw, metadata, dataTypeNodeId);\n\n    const readManyDataTypeDefinitions: OpcuaSession.SessionService[\"readManyDataTypeDefinitions\"] =\n      (dataTypeNodeIds) =>\n        readManyDataTypeDefinitionsImpl(unsafeRaw, metadata, dataTypeNodeIds);\n\n    const isValueReadable = (nodeMetadata: OpcuaSession.OpcuaNodeMetadata) =>\n      nodeMetadata.accessLevel?.readable === true &&\n      nodeMetadata.userAccessLevel?.readable !== false;\n\n    const inspectValue = (\n      nodeId: string,\n      nodeMetadata: OpcuaSession.OpcuaNodeMetadata,\n    ): Effect.Effect<OpcuaSession.OpcuaInspectValueResult> =>\n      isValueReadable(nodeMetadata)\n        ? Effect.map(\n            Effect.result(\n              read(OpcuaVariable.makeVariableDef({ nodeId, access: \"read\" })),\n            ),\n            (result) =>\n              Result.isSuccess(result)\n                ? result.success\n                : {\n                    _tag: \"ReadFailed\" as const,\n                    nodeId,\n                    error: result.failure,\n                  },\n          )\n        : Effect.succeed({ _tag: \"NotReadable\" as const, nodeId });\n\n    const inspectNode: OpcuaSession.SessionService[\"inspectNode\"] = (\n      nodeId,\n      options,\n    ) =>\n      Effect.gen(function* () {\n        const nodeMetadata = yield* metadata.node(nodeId);\n        const value =\n          options?.value === true\n            ? yield* inspectValue(nodeId, nodeMetadata)\n            : undefined;\n        const dataTypeDefinition =\n          options?.dataTypeDefinition === true &&\n          nodeMetadata.dataType !== undefined\n            ? yield* readDataTypeDefinitionImpl(\n                unsafeRaw,\n                metadata,\n                nodeMetadata.dataType,\n              )\n            : undefined;\n        return { nodeId, metadata: nodeMetadata, value, dataTypeDefinition };\n      }).pipe(\n        Effect.withSpan(\"opcua.session.inspectNode\", {\n          attributes: {\n            \"opcua.node_id\": nodeId,\n            \"opcua.inspect_value\": options?.value === true,\n            \"opcua.inspect_data_type_definition\":\n              options?.dataTypeDefinition === true,\n          },\n          kind: \"client\",\n        }),\n      );\n\n    return OpcuaSession.Session.of({\n      read,\n      write,\n      readMany,\n      writeMany,\n      makeSubscription,\n      call,\n      callMany,\n      browse,\n      browseNext,\n      releaseBrowseContinuation,\n      browseChildren,\n      readNamespaceArray,\n      readNodeMetadata,\n      readManyNodeMetadata,\n      readDataTypeDefinition,\n      readManyDataTypeDefinitions,\n      inspectNode,\n      events: Stream.fromPubSub(events),\n      unsafeRaw,\n    });\n  });\n"],"mappings":"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"}

package/dist/internal/structures/adapter.d.mts

@@ -0,0 +1,11 @@
+import { ExtensionObject } from "node-opcua";
+
+//#region src/internal/structures/adapter.d.ts
+type StructureBody = Readonly<Record<string, unknown>>;
+declare const isNodeOpcuaExtensionObject: (value: unknown) => value is ExtensionObject;
+declare const extensionObjectTypeName: (value: ExtensionObject) => string | undefined;
+declare const structureBodyFromExtensionObject: (value: unknown) => StructureBody;
+declare const extensionObjectBody: (value: ExtensionObject) => StructureBody;
+//#endregion
+export { StructureBody, extensionObjectBody, extensionObjectTypeName, isNodeOpcuaExtensionObject, structureBodyFromExtensionObject };
+//# sourceMappingURL=adapter.d.mts.map

package/dist/internal/structures/adapter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.mts","names":[],"sources":["../../../src/internal/structures/adapter.ts"],"sourcesContent":[],"mappings":";;;KAIY,aAAA,GAAgB,SAAS;cAExB,yDAED;AAJA,cAMC,uBANe,EAAA,CAAA,KAAQ,EAO3B,eAP2B,EAAA,GAAA,MAAA,GAAA,SAAA;AAEvB,cAWA,gCATD,EAAA,CAAA,KAAA,EAAmD,OAAA,EAAA,GAW5D,aAX4D;AAElD,cAgBA,mBAXZ,EAAA,CAJQ,KAAA,EAekC,eAfnB,EAAA,GAeqC,aAfrC"}

package/dist/internal/structures/adapter.mjs

@@ -0,0 +1,37 @@
+import { isPlainRecord } from "../common/predicates.mjs";
+import { ExtensionObject } from "node-opcua";
+
+//#region src/internal/structures/adapter.ts
+const isNodeOpcuaExtensionObject = (value) => value instanceof ExtensionObject;
+const extensionObjectTypeName = (value) => {
+	const name = value.constructor?.name;
+	return name && name !== "ExtensionObject" ? name : void 0;
+};
+const structureBodyFromExtensionObject = (value) => {
+	if (!isNodeOpcuaExtensionObject(value)) throw new TypeError("Expected node-opcua ExtensionObject");
+	return extensionObjectBody(value);
+};
+const extensionObjectBody = (value) => {
+	const json = extensionObjectJson(value);
+	const entries = Object.entries(value).filter(([key]) => isStructureDataKey(key));
+	if (json && (Object.keys(json).length > 0 || entries.length === 0)) return json;
+	if (entries.length > 0) return Object.fromEntries(entries);
+	throw new TypeError(`Could not extract ExtensionObject body${extensionObjectNameSuffix(value)}`);
+};
+const extensionObjectJson = (value) => {
+	const toJSON = value.toJSON;
+	if (typeof toJSON !== "function") return void 0;
+	const json = toJSON.call(value);
+	if (json === void 0 || json === null) return void 0;
+	if (isPlainRecord(json)) return json;
+	throw new TypeError(`ExtensionObject toJSON() must return a plain object${extensionObjectNameSuffix(value)}`);
+};
+const extensionObjectNameSuffix = (value) => {
+	const name = extensionObjectTypeName(value);
+	return name ? ` for ${name}` : "";
+};
+const isStructureDataKey = (key) => !key.startsWith("_") && key !== "schema" && key !== "encode" && key !== "decode" && key !== "binaryStoreSize" && key !== "constructor";
+
+//#endregion
+export { extensionObjectBody, extensionObjectTypeName, isNodeOpcuaExtensionObject, structureBodyFromExtensionObject };
+//# sourceMappingURL=adapter.mjs.map

package/dist/internal/structures/adapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.mjs","names":[],"sources":["../../../src/internal/structures/adapter.ts"],"sourcesContent":["import { ExtensionObject } from \"node-opcua\";\n\nimport { isPlainRecord } from \"../common/predicates.js\";\n\nexport type StructureBody = Readonly<Record<string, unknown>>;\n\nexport const isNodeOpcuaExtensionObject = (\n  value: unknown,\n): value is ExtensionObject => value instanceof ExtensionObject;\n\nexport const extensionObjectTypeName = (\n  value: ExtensionObject,\n): string | undefined => {\n  const name = value.constructor?.name;\n  return name && name !== \"ExtensionObject\" ? name : undefined;\n};\n\nexport const structureBodyFromExtensionObject = (\n  value: unknown,\n): StructureBody => {\n  if (!isNodeOpcuaExtensionObject(value)) {\n    throw new TypeError(\"Expected node-opcua ExtensionObject\");\n  }\n  return extensionObjectBody(value);\n};\n\nexport const extensionObjectBody = (value: ExtensionObject): StructureBody => {\n  const json = extensionObjectJson(value);\n  const entries = Object.entries(\n    value as unknown as Record<string, unknown>,\n  ).filter(([key]) => isStructureDataKey(key));\n\n  if (json && (Object.keys(json).length > 0 || entries.length === 0)) {\n    return json;\n  }\n  if (entries.length > 0) return Object.fromEntries(entries);\n\n  throw new TypeError(\n    `Could not extract ExtensionObject body${extensionObjectNameSuffix(value)}`,\n  );\n};\n\nconst extensionObjectJson = (\n  value: ExtensionObject,\n): StructureBody | undefined => {\n  const toJSON = (value as { readonly toJSON?: unknown }).toJSON;\n  if (typeof toJSON !== \"function\") return undefined;\n\n  const json = toJSON.call(value);\n  if (json === undefined || json === null) return undefined;\n  if (isPlainRecord(json)) return json;\n\n  throw new TypeError(\n    `ExtensionObject toJSON() must return a plain object${extensionObjectNameSuffix(value)}`,\n  );\n};\n\nconst extensionObjectNameSuffix = (value: ExtensionObject) => {\n  const name = extensionObjectTypeName(value);\n  return name ? ` for ${name}` : \"\";\n};\n\nconst isStructureDataKey = (key: string) =>\n  !key.startsWith(\"_\") &&\n  key !== \"schema\" &&\n  key !== \"encode\" &&\n  key !== \"decode\" &&\n  key !== \"binaryStoreSize\" &&\n  key !== \"constructor\";\n"],"mappings":";;;;AAMA,MAAa,8BACX,UAC6B,iBAAiB;AAEhD,MAAa,2BACX,UACuB;CACvB,MAAM,OAAO,MAAM,aAAa;AAChC,QAAO,QAAQ,SAAS,oBAAoB,OAAO;;AAGrD,MAAa,oCACX,UACkB;AAClB,KAAI,CAAC,2BAA2B,MAAM,CACpC,OAAM,IAAI,UAAU,sCAAsC;AAE5D,QAAO,oBAAoB,MAAM;;AAGnC,MAAa,uBAAuB,UAA0C;CAC5E,MAAM,OAAO,oBAAoB,MAAM;CACvC,MAAM,UAAU,OAAO,QACrB,MACD,CAAC,QAAQ,CAAC,SAAS,mBAAmB,IAAI,CAAC;AAE5C,KAAI,SAAS,OAAO,KAAK,KAAK,CAAC,SAAS,KAAK,QAAQ,WAAW,GAC9D,QAAO;AAET,KAAI,QAAQ,SAAS,EAAG,QAAO,OAAO,YAAY,QAAQ;AAE1D,OAAM,IAAI,UACR,yCAAyC,0BAA0B,MAAM,GAC1E;;AAGH,MAAM,uBACJ,UAC8B;CAC9B,MAAM,SAAU,MAAwC;AACxD,KAAI,OAAO,WAAW,WAAY,QAAO;CAEzC,MAAM,OAAO,OAAO,KAAK,MAAM;AAC/B,KAAI,SAAS,UAAa,SAAS,KAAM,QAAO;AAChD,KAAI,cAAc,KAAK,CAAE,QAAO;AAEhC,OAAM,IAAI,UACR,sDAAsD,0BAA0B,MAAM,GACvF;;AAGH,MAAM,6BAA6B,UAA2B;CAC5D,MAAM,OAAO,wBAAwB,MAAM;AAC3C,QAAO,OAAO,QAAQ,SAAS;;AAGjC,MAAM,sBAAsB,QAC1B,CAAC,IAAI,WAAW,IAAI,IACpB,QAAQ,YACR,QAAQ,YACR,QAAQ,YACR,QAAQ,qBACR,QAAQ"}

package/dist/internal/structures/model.d.mts

@@ -0,0 +1,21 @@
+import { NodeIdString } from "../../OpcuaVariable.mjs";
+import "../common/node-id.mjs";
+import { Schema } from "effect";
+
+//#region src/internal/structures/model.d.ts
+type StructureDef<A> = {
+  readonly _tag: "Structure";
+  readonly name: string;
+  readonly dataTypeId: NodeIdString;
+  readonly schema: Schema.Codec<unknown, A, never, never>;
+};
+type StructureArrayDef<A> = {
+  readonly _tag: "StructureArray";
+  readonly item: StructureDef<A>;
+};
+type AnyStructureDef = StructureDef<unknown> | StructureArrayDef<unknown>;
+declare const isStructureDef: (value: unknown) => value is StructureDef<unknown>;
+declare const isStructureArrayDef: (value: unknown) => value is StructureArrayDef<unknown>;
+//#endregion
+export { AnyStructureDef, StructureArrayDef, StructureDef, isStructureArrayDef, isStructureDef };
+//# sourceMappingURL=model.d.mts.map

package/dist/internal/structures/model.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.mts","names":[],"sources":["../../../src/internal/structures/model.ts"],"sourcesContent":[],"mappings":";;;;;KAIY;;;EAAA,SAAA,UAAY,EAGD,YAHC;EAGD,SAAA,MAAA,EACJ,MAAA,CAAO,KADH,CAAA,OAAA,EACkB,CADlB,EAAA,KAAA,EAAA,KAAA,CAAA;CACkB;AAAtB,KAGP,iBAHc,CAAA,CAAA,CAAA,GAAA;EAAK,SAAA,IAAA,EAAA,gBAAA;EAGnB,SAAA,IAAA,EAEK,YAFY,CAEC,CAFD,CAAA;AAK7B,CAAA;AAIa,KAJD,eAAA,GACR,YAKQ,CAAA,OAAY,CAAA,GAJpB,iBAIoB,CAAA,OAAA,CAAA;AAOX,cATA,cAgBV,EAAA,CAAA,KALS,EAAA,OAAA,EAAA,GAAiB,KAAA,IATjB,YASiB,CAAA,OAAA,CAAA;cAFhB,kDAED"}

package/dist/internal/structures/model.mjs

@@ -0,0 +1,7 @@
+//#region src/internal/structures/model.ts
+const isStructureDef = (value) => Boolean(value && typeof value === "object" && value._tag === "Structure");
+const isStructureArrayDef = (value) => Boolean(value && typeof value === "object" && value._tag === "StructureArray");
+
+//#endregion
+export { isStructureArrayDef, isStructureDef };
+//# sourceMappingURL=model.mjs.map

package/dist/internal/structures/model.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.mjs","names":[],"sources":["../../../src/internal/structures/model.ts"],"sourcesContent":["import { Schema } from \"effect\";\n\nimport type { NodeIdString } from \"../common/node-id.js\";\n\nexport type StructureDef<A> = {\n  readonly _tag: \"Structure\";\n  readonly name: string;\n  readonly dataTypeId: NodeIdString;\n  readonly schema: Schema.Codec<unknown, A, never, never>;\n};\n\nexport type StructureArrayDef<A> = {\n  readonly _tag: \"StructureArray\";\n  readonly item: StructureDef<A>;\n};\n\nexport type AnyStructureDef =\n  | StructureDef<unknown>\n  | StructureArrayDef<unknown>;\n\nexport const isStructureDef = (\n  value: unknown,\n): value is StructureDef<unknown> =>\n  Boolean(\n    value &&\n    typeof value === \"object\" &&\n    (value as { readonly _tag?: string })._tag === \"Structure\",\n  );\n\nexport const isStructureArrayDef = (\n  value: unknown,\n): value is StructureArrayDef<unknown> =>\n  Boolean(\n    value &&\n    typeof value === \"object\" &&\n    (value as { readonly _tag?: string })._tag === \"StructureArray\",\n  );\n"],"mappings":";AAoBA,MAAa,kBACX,UAEA,QACE,SACA,OAAO,UAAU,YAChB,MAAqC,SAAS,YAChD;AAEH,MAAa,uBACX,UAEA,QACE,SACA,OAAO,UAAU,YAChB,MAAqC,SAAS,iBAChD"}

package/dist/internal/structures/runtime.d.mts

@@ -0,0 +1,28 @@
+import { NodeIdString } from "../../OpcuaVariable.mjs";
+import "../common/node-id.mjs";
+import { AnyStructureDef, StructureArrayDef, StructureDef } from "./model.mjs";
+import { OpcuaConfigurationError, OpcuaEncodeError, OpcuaServiceError } from "../../OpcuaError.mjs";
+import { ClientSession, DataType, ExtensionObject, NodeId, Variant } from "node-opcua";
+import { Effect } from "effect";
+
+//#region src/internal/structures/runtime.d.ts
+type OpcuaStructureRuntime = {
+  readonly ensureInitialized: () => Effect.Effect<void, OpcuaServiceError>;
+  readonly invalidate: Effect.Effect<void>;
+  readonly encodeStructure: <A>(nodeId: NodeIdString, codec: StructureDef<A>, value: A) => Effect.Effect<ExtensionObject, OpcuaEncodeError | OpcuaServiceError>;
+  readonly encodeStructureArray: <A>(nodeId: NodeIdString, codec: StructureArrayDef<A>, values: ReadonlyArray<A>) => Effect.Effect<ReadonlyArray<ExtensionObject>, OpcuaEncodeError | OpcuaServiceError>;
+  readonly decodeStructure: <A>(codec: StructureDef<A>, rawValue: unknown) => A;
+  readonly decodeStructureArray: <A>(codec: StructureArrayDef<A>, rawValues: unknown) => ReadonlyArray<A>;
+  readonly variantFromStructure: <A>(nodeId: NodeIdString, codec: AnyStructureDef, value: A) => Effect.Effect<Variant, OpcuaEncodeError | OpcuaServiceError>;
+};
+declare const makeStructureRuntime: (session: ClientSession) => OpcuaStructureRuntime;
+declare const validateStructureMetadata: (operation: string, nodeId: NodeIdString, metadata: {
+  readonly valueRank: number;
+  readonly raw: {
+    readonly declaredDataType: NodeId;
+    readonly builtInDataType: DataType;
+  };
+}, structure: AnyStructureDef) => OpcuaConfigurationError | undefined;
+//#endregion
+export { OpcuaStructureRuntime, makeStructureRuntime, validateStructureMetadata };
+//# sourceMappingURL=runtime.d.mts.map

package/dist/internal/structures/runtime.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.mts","names":[],"sources":["../../../src/internal/structures/runtime.ts"],"sourcesContent":[],"mappings":";;;;;;;;KAgCY,qBAAA;oCACwB,MAAA,CAAO,aAAa;uBACjC,MAAA,CAAO;EAFlB,SAAA,eAAqB,EAAA,CAAA,CAAA,CAAA,CAAA,MAAA,EAIrB,YAJqB,EAAA,KAAA,EAKtB,YALsB,CAKT,CALS,CAAA,EAAA,KAAA,EAMtB,CANsB,EAAA,GAO1B,MAAA,CAAO,MAPmB,CAOZ,eAPY,EAOK,gBAPL,GAOwB,iBAPxB,CAAA;EACuB,SAAA,oBAAA,EAAA,CAAA,CAAA,CAAA,CAAA,MAAA,EAQ5C,YAR4C,EAAA,KAAA,EAS7C,iBAT6C,CAS3B,CAT2B,CAAA,EAAA,MAAA,EAU5C,aAV4C,CAU9B,CAV8B,CAAA,EAAA,GAWjD,MAAA,CAAO,MAX0C,CAYpD,aAZoD,CAYtC,eAZsC,CAAA,EAapD,gBAboD,GAajC,iBAbiC,CAAA;EAApB,SAAO,eAAA,EAAA,CAAA,CAAA,CAAA,CAAA,KAAA,EAeJ,YAfI,CAeS,CAfT,CAAA,EAAA,QAAA,EAAA,OAAA,EAAA,GAemC,CAfnC;EACpB,SAAO,oBAAA,EAAA,CAAA,CAAA,CAAA,CAAA,KAAA,EAgBnB,iBAhBmB,CAgBD,CAhBC,CAAA,EAAA,SAAA,EAAA,OAAA,EAAA,GAkBvB,aAlBuB,CAkBT,CAlBS,CAAA;EAElB,SAAA,oBAAA,EAAA,CAAA,CAAA,CAAA,CAAA,MAAA,EAkBA,YAlBA,EAAA,KAAA,EAmBD,eAnBC,EAAA,KAAA,EAoBD,CApBC,EAAA,GAqBL,MAAA,CAAO,MArBF,CAqBS,OArBT,EAqBkB,gBArBlB,GAqBqC,iBArBrC,CAAA;CACY;AAAb,cAuBE,oBAvBF,EAAA,CAAA,OAAA,EAwBA,aAxBA,EAAA,GAyBR,qBAzBQ;AACA,cA8JE,yBA9JF,EAAA,CAAA,SAAA,EAAA,MAAA,EAAA,MAAA,EAgKD,YAhKC,EAAA,QAAA,EAAA;EACU,SAAA,SAAA,EAAA,MAAA;EAAiB,SAAA,GAAA,EAAA;IAAmB,SAAA,gBAAA,EAmKxB,MAnKwB;IAA3C,SAAA,eAAA,EAoKkB,QApKlB;EAEF,CAAA;CACiB,EAAA,SAAA,EAoKhB,eApKgB,EAAA,GAoKD,uBAAA,GApKC,SAAA"}

package/dist/internal/structures/runtime.mjs

@@ -0,0 +1,119 @@
+import { isPlainRecord } from "../common/predicates.mjs";
+import { structureBodyFromExtensionObject } from "./adapter.mjs";
+import { configurationError, encodeError, serviceError } from "../../OpcuaError.mjs";
+import { isStructureArrayDef } from "./model.mjs";
+import { decodeWithSchema, encodeWithSchema } from "../values/codec.mjs";
+import { DataType, DataTypeExtractStrategy, Variant, VariantArrayType, coerceNodeId, getExtraDataTypeManager, sameNodeId } from "node-opcua";
+import { Effect } from "effect";
+
+//#region src/internal/structures/runtime.ts
+const makeStructureRuntime = (session) => {
+	let initializeOnce = makeInitializeOnce(session);
+	const ensureInitialized = () => initializeOnce;
+	const invalidate = Effect.sync(() => {
+		initializeOnce = makeInitializeOnce(session);
+	});
+	const encodeStructure = (nodeId, codec, value) => Effect.gen(function* () {
+		yield* ensureInitialized();
+		const pojo = yield* Effect.try({
+			try: () => encodeWithSchema(codec.schema, value),
+			catch: (error) => encodeError({
+				nodeId,
+				value,
+				error
+			})
+		});
+		return yield* Effect.tryPromise({
+			try: () => session.constructExtensionObject(coerceNodeId(codec.dataTypeId), pojoRecord(pojo)),
+			catch: (cause) => encodeError({
+				nodeId,
+				value,
+				error: cause,
+				cause
+			})
+		});
+	});
+	const encodeStructureArray = (nodeId, codec, values) => Effect.forEach(values, (value) => encodeStructure(nodeId, codec.item, value));
+	const decodeStructure = (codec, rawValue) => decodeWithSchema(codec.schema, structureBodyFromExtensionObject(rawValue));
+	const decodeStructureArray = (codec, rawValues) => {
+		if (!Array.isArray(rawValues)) throw new TypeError(`Expected structure array for ${codec.item.name}`);
+		return rawValues.map((value) => decodeStructure(codec.item, value));
+	};
+	const variantFromStructure = (nodeId, codec, value) => Effect.gen(function* () {
+		if (isStructureArrayDef(codec)) {
+			const extensionObjects = yield* encodeStructureArray(nodeId, codec, yield* arrayValue(nodeId, value));
+			return new Variant({
+				dataType: DataType.ExtensionObject,
+				arrayType: VariantArrayType.Array,
+				value: [...extensionObjects]
+			});
+		}
+		const extensionObject = yield* encodeStructure(nodeId, codec, value);
+		return new Variant({
+			dataType: DataType.ExtensionObject,
+			arrayType: VariantArrayType.Scalar,
+			value: extensionObject
+		});
+	});
+	return {
+		ensureInitialized,
+		invalidate,
+		encodeStructure,
+		encodeStructureArray,
+		decodeStructure,
+		decodeStructureArray,
+		variantFromStructure
+	};
+};
+const makeInitializeOnce = (session) => Effect.runSync(Effect.cached(Effect.tryPromise({
+	try: () => getExtraDataTypeManager(session, DataTypeExtractStrategy.Both),
+	catch: (cause) => serviceError({
+		operation: "structure.extractNamespaceDataType",
+		cause
+	})
+})));
+const pojoRecord = (value) => {
+	if (isPlainRecord(value)) return value;
+	throw new TypeError("Structure schema must encode to a plain object");
+};
+const arrayValue = (nodeId, value) => Array.isArray(value) ? Effect.succeed(value) : Effect.fail(encodeError({
+	nodeId,
+	value,
+	error: "Structure array value must be an array"
+}));
+const validateStructureMetadata = (operation, nodeId, metadata, structure) => {
+	const codec = isStructureArrayDef(structure) ? structure.item : structure;
+	if (metadata.raw.builtInDataType !== DataType.ExtensionObject) return configurationError({
+		operation,
+		nodeId,
+		cause: `Expected built-in DataType.ExtensionObject for ${codec.name}`
+	});
+	const expectedDataType = coerceNodeId(codec.dataTypeId);
+	if (!sameNodeId(metadata.raw.declaredDataType, expectedDataType)) return configurationError({
+		operation,
+		nodeId,
+		cause: `Expected exact declared DataType ${expectedDataType.toString()} for ${codec.name}, got ${metadata.raw.declaredDataType.toString()}`
+	});
+	if (metadata.valueRank > 1) return configurationError({
+		operation,
+		nodeId,
+		cause: "Structure matrices are not supported"
+	});
+	if (isStructureArrayDef(structure)) {
+		if (!isOneDimArrayCompatibleRank(metadata.valueRank)) return configurationError({
+			operation,
+			nodeId,
+			cause: "Expected one-dimensional structure array metadata"
+		});
+	} else if (!isScalarCompatibleRank(metadata.valueRank)) return configurationError({
+		operation,
+		nodeId,
+		cause: "Expected scalar structure metadata"
+	});
+};
+const isScalarCompatibleRank = (rank) => rank === -1 || rank === -2 || rank === -3;
+const isOneDimArrayCompatibleRank = (rank) => rank === 1 || rank === 0 || rank === -2 || rank === -3;
+
+//#endregion
+export { makeStructureRuntime, validateStructureMetadata };
+//# sourceMappingURL=runtime.mjs.map

package/dist/internal/structures/runtime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.mjs","names":[],"sources":["../../../src/internal/structures/runtime.ts"],"sourcesContent":["import {\n  DataType,\n  DataTypeExtractStrategy,\n  Variant,\n  VariantArrayType,\n  coerceNodeId,\n  getExtraDataTypeManager,\n  sameNodeId,\n  type ClientSession,\n  type ExtensionObject,\n  type NodeId,\n} from \"node-opcua\";\nimport { Effect } from \"effect\";\n\nimport type { NodeIdString } from \"../common/node-id.js\";\nimport { encodeWithSchema, decodeWithSchema } from \"../values/codec.js\";\nimport {\n  configurationError,\n  encodeError,\n  serviceError,\n  type OpcuaEncodeError,\n  type OpcuaServiceError,\n} from \"../../OpcuaError.js\";\nimport {\n  isStructureArrayDef,\n  type AnyStructureDef,\n  type StructureArrayDef,\n  type StructureDef,\n} from \"./model.js\";\nimport { isPlainRecord } from \"../common/predicates.js\";\nimport { structureBodyFromExtensionObject } from \"./adapter.js\";\n\nexport type OpcuaStructureRuntime = {\n  readonly ensureInitialized: () => Effect.Effect<void, OpcuaServiceError>;\n  readonly invalidate: Effect.Effect<void>;\n  readonly encodeStructure: <A>(\n    nodeId: NodeIdString,\n    codec: StructureDef<A>,\n    value: A,\n  ) => Effect.Effect<ExtensionObject, OpcuaEncodeError | OpcuaServiceError>;\n  readonly encodeStructureArray: <A>(\n    nodeId: NodeIdString,\n    codec: StructureArrayDef<A>,\n    values: ReadonlyArray<A>,\n  ) => Effect.Effect<\n    ReadonlyArray<ExtensionObject>,\n    OpcuaEncodeError | OpcuaServiceError\n  >;\n  readonly decodeStructure: <A>(codec: StructureDef<A>, rawValue: unknown) => A;\n  readonly decodeStructureArray: <A>(\n    codec: StructureArrayDef<A>,\n    rawValues: unknown,\n  ) => ReadonlyArray<A>;\n  readonly variantFromStructure: <A>(\n    nodeId: NodeIdString,\n    codec: AnyStructureDef,\n    value: A,\n  ) => Effect.Effect<Variant, OpcuaEncodeError | OpcuaServiceError>;\n};\n\nexport const makeStructureRuntime = (\n  session: ClientSession,\n): OpcuaStructureRuntime => {\n  let initializeOnce = makeInitializeOnce(session);\n\n  const ensureInitialized = () => initializeOnce;\n  const invalidate = Effect.sync(() => {\n    initializeOnce = makeInitializeOnce(session);\n  });\n\n  const encodeStructure = <A>(\n    nodeId: NodeIdString,\n    codec: StructureDef<A>,\n    value: A,\n  ) =>\n    Effect.gen(function* () {\n      yield* ensureInitialized();\n      const pojo = yield* Effect.try({\n        try: () => encodeWithSchema(codec.schema, value),\n        catch: (error) => encodeError({ nodeId, value, error }),\n      });\n      return yield* Effect.tryPromise({\n        try: () =>\n          session.constructExtensionObject(\n            coerceNodeId(codec.dataTypeId),\n            pojoRecord(pojo),\n          ),\n        catch: (cause) =>\n          encodeError({\n            nodeId,\n            value,\n            error: cause,\n            cause,\n          }),\n      });\n    });\n\n  const encodeStructureArray = <A>(\n    nodeId: NodeIdString,\n    codec: StructureArrayDef<A>,\n    values: ReadonlyArray<A>,\n  ) =>\n    Effect.forEach(values, (value) =>\n      encodeStructure(nodeId, codec.item, value),\n    );\n\n  const decodeStructure = <A>(codec: StructureDef<A>, rawValue: unknown): A =>\n    decodeWithSchema(\n      codec.schema,\n      structureBodyFromExtensionObject(rawValue),\n    ) as A;\n\n  const decodeStructureArray = <A>(\n    codec: StructureArrayDef<A>,\n    rawValues: unknown,\n  ): ReadonlyArray<A> => {\n    if (!Array.isArray(rawValues)) {\n      throw new TypeError(`Expected structure array for ${codec.item.name}`);\n    }\n    return rawValues.map((value) => decodeStructure(codec.item, value));\n  };\n\n  const variantFromStructure = <A>(\n    nodeId: NodeIdString,\n    codec: AnyStructureDef,\n    value: A,\n  ) =>\n    Effect.gen(function* () {\n      if (isStructureArrayDef(codec)) {\n        const values = yield* arrayValue(nodeId, value);\n        const extensionObjects = yield* encodeStructureArray(\n          nodeId,\n          codec,\n          values,\n        );\n        return new Variant({\n          dataType: DataType.ExtensionObject,\n          arrayType: VariantArrayType.Array,\n          value: [...extensionObjects],\n        });\n      }\n      const extensionObject = yield* encodeStructure(nodeId, codec, value);\n      return new Variant({\n        dataType: DataType.ExtensionObject,\n        arrayType: VariantArrayType.Scalar,\n        value: extensionObject,\n      });\n    });\n\n  return {\n    ensureInitialized,\n    invalidate,\n    encodeStructure,\n    encodeStructureArray,\n    decodeStructure,\n    decodeStructureArray,\n    variantFromStructure,\n  };\n};\n\nconst makeInitializeOnce = (session: ClientSession) =>\n  Effect.runSync(\n    Effect.cached(\n      Effect.tryPromise({\n        try: () =>\n          getExtraDataTypeManager(session, DataTypeExtractStrategy.Both),\n        catch: (cause) =>\n          serviceError({\n            operation: \"structure.extractNamespaceDataType\",\n            cause,\n          }),\n      }),\n    ),\n  );\n\nconst pojoRecord = (value: unknown): Record<string, unknown> => {\n  if (isPlainRecord(value)) {\n    return value as Record<string, unknown>;\n  }\n  throw new TypeError(\"Structure schema must encode to a plain object\");\n};\n\nconst arrayValue = <A>(\n  nodeId: NodeIdString,\n  value: A,\n): Effect.Effect<ReadonlyArray<unknown>, OpcuaEncodeError> =>\n  Array.isArray(value)\n    ? Effect.succeed(value)\n    : Effect.fail(\n        encodeError({\n          nodeId,\n          value,\n          error: \"Structure array value must be an array\",\n        }),\n      );\n\nexport const validateStructureMetadata = (\n  operation: string,\n  nodeId: NodeIdString,\n  metadata: {\n    readonly valueRank: number;\n    readonly raw: {\n      readonly declaredDataType: NodeId;\n      readonly builtInDataType: DataType;\n    };\n  },\n  structure: AnyStructureDef,\n) => {\n  const codec = isStructureArrayDef(structure) ? structure.item : structure;\n  if (metadata.raw.builtInDataType !== DataType.ExtensionObject) {\n    return configurationError({\n      operation,\n      nodeId,\n      cause: `Expected built-in DataType.ExtensionObject for ${codec.name}`,\n    });\n  }\n  const expectedDataType = coerceNodeId(codec.dataTypeId);\n  if (!sameNodeId(metadata.raw.declaredDataType, expectedDataType)) {\n    return configurationError({\n      operation,\n      nodeId,\n      cause: `Expected exact declared DataType ${expectedDataType.toString()} for ${codec.name}, got ${metadata.raw.declaredDataType.toString()}`,\n    });\n  }\n  if (metadata.valueRank > 1) {\n    return configurationError({\n      operation,\n      nodeId,\n      cause: \"Structure matrices are not supported\",\n    });\n  }\n  if (isStructureArrayDef(structure)) {\n    if (!isOneDimArrayCompatibleRank(metadata.valueRank)) {\n      return configurationError({\n        operation,\n        nodeId,\n        cause: \"Expected one-dimensional structure array metadata\",\n      });\n    }\n  } else if (!isScalarCompatibleRank(metadata.valueRank)) {\n    return configurationError({\n      operation,\n      nodeId,\n      cause: \"Expected scalar structure metadata\",\n    });\n  }\n  return undefined;\n};\n\nconst isScalarCompatibleRank = (rank: number) =>\n  rank === -1 || rank === -2 || rank === -3;\n\nconst isOneDimArrayCompatibleRank = (rank: number) =>\n  rank === 1 || rank === 0 || rank === -2 || rank === -3;\n"],"mappings":"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"}

package/dist/internal/subscription/options.d.mts

@@ -0,0 +1,17 @@
+import { OpcuaConfigurationError } from "../../OpcuaError.mjs";
+import { SubscriptionOptions } from "../../OpcuaSession.mjs";
+import { Effect } from "effect";
+
+//#region src/internal/subscription/options.d.ts
+type NormalizedSubscriptionOptions = {
+  readonly publishingInterval: number;
+  readonly lifetimeCount: number;
+  readonly maxKeepAliveCount: number;
+  readonly maxNotificationsPerPublish: number;
+  readonly publishingEnabled: boolean;
+  readonly priority: number;
+};
+declare const validateSubscriptionOptions: (options: SubscriptionOptions) => Effect.Effect<NormalizedSubscriptionOptions, OpcuaConfigurationError>;
+//#endregion
+export { NormalizedSubscriptionOptions, validateSubscriptionOptions };
+//# sourceMappingURL=options.d.mts.map

package/dist/internal/subscription/options.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.mts","names":[],"sources":["../../../src/internal/subscription/options.ts"],"sourcesContent":[],"mappings":";;;;;KAsBY,6BAAA;;EAAA,SAAA,aAAA,EAAA,MAAA;EAkBC,SAAA,iBAAA,EAAA,MA2ET;EA1EO,SAAA,0BAAA,EAAA,MAAA;EACM,SAAA,iBAAA,EAAA,OAAA;EAA+B,SAAA,QAAA,EAAA,MAAA;CAA7C;AAAa,cAFH,2BAEG,EAAA,CAAA,OAAA,EADL,mBACK,EAAA,GAAb,MAAA,CAAO,MAAM,CAAC,6BAAD,EAAgC,uBAAhC,CAAA"}

package/dist/internal/subscription/options.mjs

@@ -0,0 +1,51 @@
+import { isPlainRecord } from "../common/predicates.mjs";
+import { configurationError } from "../../OpcuaError.mjs";
+import { durationToMillis, nonNegativeIntegerOption, positiveIntegerOption, unknownKeys } from "../common/options.mjs";
+import { DEFAULT_LIFETIME_COUNT, DEFAULT_MAX_KEEP_ALIVE_COUNT, DEFAULT_MAX_NOTIFICATIONS_PER_PUBLISH, DEFAULT_PRIORITY, DEFAULT_PUBLISHING_ENABLED } from "../common/constants.mjs";
+import { Effect } from "effect";
+
+//#region src/internal/subscription/options.ts
+const allowedSubscriptionOptionKeys = new Set([
+	"publishingInterval",
+	"lifetimeCount",
+	"maxKeepAliveCount",
+	"maxNotificationsPerPublish",
+	"publishingEnabled",
+	"priority"
+]);
+const validateSubscriptionOptions = (options) => Effect.suspend(() => {
+	if (!isPlainRecord(options)) return Effect.fail(subscriptionOptionsError("options must be an object"));
+	const unknown = unknownKeys(options, allowedSubscriptionOptionKeys);
+	if (unknown.length > 0) return Effect.fail(subscriptionOptionsError(`unsupported option: ${unknown.join(", ")}`));
+	const publishingInterval = durationToMillis(options.publishingInterval, {
+		notDuration: "publishingInterval must be a Duration",
+		invalidDuration: "publishingInterval must be finite and non-negative"
+	});
+	if (typeof publishingInterval === "string") return Effect.fail(subscriptionOptionsError(publishingInterval));
+	const lifetimeCount = options.lifetimeCount ?? DEFAULT_LIFETIME_COUNT;
+	if (!positiveIntegerOption(lifetimeCount)) return Effect.fail(subscriptionOptionsError("lifetimeCount must be a positive integer"));
+	const maxKeepAliveCount = options.maxKeepAliveCount ?? DEFAULT_MAX_KEEP_ALIVE_COUNT;
+	if (!positiveIntegerOption(maxKeepAliveCount)) return Effect.fail(subscriptionOptionsError("maxKeepAliveCount must be a positive integer"));
+	const maxNotificationsPerPublish = options.maxNotificationsPerPublish ?? DEFAULT_MAX_NOTIFICATIONS_PER_PUBLISH;
+	if (!nonNegativeIntegerOption(maxNotificationsPerPublish)) return Effect.fail(subscriptionOptionsError("maxNotificationsPerPublish must be a non-negative integer"));
+	const publishingEnabled = options.publishingEnabled ?? DEFAULT_PUBLISHING_ENABLED;
+	if (typeof publishingEnabled !== "boolean") return Effect.fail(subscriptionOptionsError("publishingEnabled must be a boolean"));
+	const priority = options.priority ?? DEFAULT_PRIORITY;
+	if (!nonNegativeIntegerOption(priority) || priority > 255) return Effect.fail(subscriptionOptionsError("priority must be an integer between 0 and 255"));
+	return Effect.succeed({
+		publishingInterval,
+		lifetimeCount,
+		maxKeepAliveCount,
+		maxNotificationsPerPublish,
+		publishingEnabled,
+		priority
+	});
+});
+const subscriptionOptionsError = (cause) => configurationError({
+	operation: "subscription.options",
+	cause
+});
+
+//#endregion
+export { validateSubscriptionOptions };
+//# sourceMappingURL=options.mjs.map