@effect-opcua/client 0.1.0-alpha.1

package/dist/internal/variable/operations.d.mts

@@ -0,0 +1,50 @@
+import { NodeIdString, ReadResult, ReadableVariableDef, ValueOfVariableDef, VariableAccess, VariableCapability, VariableDef, VariableMetadata, WritableVariableDef, WriteResult } from "../../OpcuaVariable.mjs";
+import "../common/node-id.mjs";
+import { OpcuaStructureRuntime } from "../structures/runtime.mjs";
+import { OpcuaAccessDeniedError, OpcuaEncodeError, OpcuaServiceError } from "../../OpcuaError.mjs";
+import { BatchOptions } from "../batch/chunk.mjs";
+import { ClientSession, DataType, DataValue, NodeId, StatusCode } from "node-opcua";
+import { Effect } from "effect";
+
+//#region src/internal/variable/operations.d.ts
+declare const readDataValue: (session: ClientSession, nodeId: NodeIdString) => Effect.Effect<DataValue, OpcuaServiceError, never>;
+declare const readVariable: <const Id extends string, A>(session: ClientSession, def: VariableDef<Id, A, "read" | "readWrite"> | VariableDef<Id, A, VariableAccess>, structureRuntime: OpcuaStructureRuntime) => Effect.Effect<ReadResult<A, Id>, OpcuaServiceError, never>;
+type PreparedReadVariable<Def extends ReadableVariableDef = ReadableVariableDef> = {
+  readonly def: Def;
+  readonly rawNodeId: NodeId;
+};
+declare const readPreparedVariables: (session: ClientSession, items: ReadonlyArray<PreparedReadVariable>, structureRuntime: OpcuaStructureRuntime, options?: BatchOptions) => Effect.Effect<ReadResult<unknown, string>[], OpcuaServiceError, never>;
+declare const sampleFromDataValue: <const Id extends string, A>(def: VariableDef<Id, A, VariableAccess>, dataValue: DataValue, structureRuntime: OpcuaStructureRuntime) => Effect.Effect<ReadResult<A, Id>, never, never>;
+declare const writeVariable: <const Id extends string, A>(session: ClientSession, def: VariableDef<Id, A, VariableAccess>, metadata: VariableMetadata, value: A, structureRuntime: OpcuaStructureRuntime) => Effect.Effect<WriteResult<Id>, OpcuaEncodeError | OpcuaServiceError, never>;
+type PreparedWriteVariable<Def extends WritableVariableDef = WritableVariableDef> = {
+  readonly def: Def;
+  readonly metadata: VariableMetadata;
+  readonly value: ValueOfVariableDef<Def>;
+  readonly rawNodeId: NodeId;
+};
+declare const writePreparedVariables: (session: ClientSession, entries: ReadonlyArray<PreparedWriteVariable>, structureRuntime: OpcuaStructureRuntime, options?: BatchOptions) => Effect.Effect<WriteResult<string>[], OpcuaEncodeError | OpcuaServiceError, never>;
+declare const writeResult: <Id extends string>(nodeId: Id, statusCode: StatusCode) => WriteResult<Id>;
+declare const accessDeniedError: (nodeId: NodeIdString, requestedCapability: VariableCapability, accessLevel: number, userAccessLevel?: number) => OpcuaAccessDeniedError | undefined;
+declare const variableAccessCapabilities: (access: VariableAccess) => ReadonlyArray<VariableCapability>;
+declare const hasAccess: (accessLevel: number, capability: VariableCapability) => boolean;
+declare const variableMetadataFromRaw: (input: {
+  readonly nodeId: NodeIdString;
+  readonly dataTypeNodeId: NodeId;
+  readonly builtInDataType: DataType;
+  readonly valueRank: number;
+  readonly arrayDimensions?: ReadonlyArray<number>;
+  readonly accessLevel: number;
+  readonly userAccessLevel?: number;
+}) => VariableMetadata;
+declare const codecMetadata: (metadata: VariableMetadata) => {
+  nodeId: string;
+  valueRank: number;
+  arrayDimensions: readonly number[] | undefined;
+  raw: {
+    declaredDataType: NodeId;
+    builtInDataType: DataType;
+  };
+};
+//#endregion
+export { PreparedReadVariable, PreparedWriteVariable, accessDeniedError, codecMetadata, hasAccess, readDataValue, readPreparedVariables, readVariable, sampleFromDataValue, variableAccessCapabilities, variableMetadataFromRaw, writePreparedVariables, writeResult, writeVariable };
+//# sourceMappingURL=operations.d.mts.map

package/dist/internal/variable/operations.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.mts","names":[],"sources":["../../../src/internal/variable/operations.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/internal/variable/operations.mjs

@@ -0,0 +1,192 @@
+import { isGood, normalizeNodeId, normalizeStatusCode, normalizeTimestamp, normalizeVariantInfo } from "../values/normalize.mjs";
+import { accessDeniedError as accessDeniedError$1, serviceError } from "../../OpcuaError.mjs";
+import { Codec } from "../values/codec.mjs";
+import { runChunked } from "../batch/chunk.mjs";
+import { resultFromStatusAndDecode } from "../values/result.mjs";
+import { AccessLevelFlag, AttributeIds, DataType, coerceNodeId } from "node-opcua";
+import { Effect } from "effect";
+
+//#region src/internal/variable/operations.ts
+const readDataValue = (session, nodeId) => Effect.tryPromise({
+	try: () => session.read({
+		nodeId: coerceNodeId(nodeId),
+		attributeId: AttributeIds.Value
+	}, 0),
+	catch: (cause) => serviceError({
+		operation: "read",
+		nodeId,
+		cause
+	})
+});
+const readVariable = (session, def, structureRuntime) => Effect.gen(function* () {
+	if (Codec.requiresStructureRuntime(def.codec)) yield* structureRuntime.ensureInitialized();
+	return yield* sampleFromDataValue(def, yield* readDataValue(session, def.nodeId).pipe(Effect.withSpan("opcua.raw.read", {
+		attributes: { "opcua.node_id": def.nodeId },
+		kind: "client"
+	})), structureRuntime);
+});
+const readPreparedVariables = (session, items, structureRuntime, options) => Effect.gen(function* () {
+	if (items.some((item) => Codec.requiresStructureRuntime(item.def.codec))) yield* structureRuntime.ensureInitialized();
+	const dataValues = yield* runChunked(items, options, (chunk) => Effect.gen(function* () {
+		const readValueIds = chunk.map((item) => ({
+			nodeId: item.rawNodeId,
+			attributeId: AttributeIds.Value
+		}));
+		const dataValues$1 = yield* Effect.tryPromise({
+			try: () => session.read([...readValueIds], 0),
+			catch: (cause) => serviceError({
+				operation: "read",
+				cause
+			})
+		}).pipe(Effect.withSpan("opcua.raw.read.batch", {
+			attributes: { "opcua.node_count": chunk.length },
+			kind: "client"
+		}));
+		if (dataValues$1.length !== chunk.length) return yield* Effect.fail(serviceError({
+			operation: "read",
+			cause: `Expected ${chunk.length} DataValues, got ${dataValues$1.length}`
+		}));
+		return dataValues$1;
+	}));
+	return yield* Effect.forEach(items, (item, index) => sampleFromDataValue(item.def, dataValues[index], structureRuntime));
+});
+const sampleFromDataValue = (def, dataValue, structureRuntime) => Effect.suspend(() => {
+	const base = sampleBase(def.nodeId, dataValue, def.includeRaw ?? false);
+	return resultFromStatusAndDecode({
+		statusCode: dataValue.statusCode,
+		status: base,
+		decode: Codec.decode(def.codec, dataValue.value, dataValue, structureRuntime),
+		nonGoodStatus: (base$1) => ({
+			_tag: "NonGoodStatus",
+			...base$1
+		}),
+		decodeError: (error, base$1) => ({
+			_tag: "DecodeError",
+			...base$1,
+			error
+		}),
+		value: (value) => ({
+			_tag: "Value",
+			...base,
+			value
+		})
+	});
+});
+const writeVariable = (session, def, metadata, value, structureRuntime) => Effect.gen(function* () {
+	if (Codec.requiresStructureRuntime(def.codec)) yield* structureRuntime.ensureInitialized();
+	const variant = yield* Codec.encode(def.codec, value, codecMetadata(metadata), structureRuntime);
+	const statusCode = yield* Effect.tryPromise({
+		try: () => session.write({
+			nodeId: coerceNodeId(def.nodeId),
+			attributeId: AttributeIds.Value,
+			value: { value: variant }
+		}),
+		catch: (cause) => serviceError({
+			operation: "write",
+			nodeId: def.nodeId,
+			cause
+		})
+	}).pipe(Effect.withSpan("opcua.raw.write", {
+		attributes: { "opcua.node_id": def.nodeId },
+		kind: "client"
+	}));
+	return writeResult(def.nodeId, statusCode);
+});
+const writePreparedVariables = (session, entries, structureRuntime, options) => Effect.gen(function* () {
+	if (entries.some((entry) => Codec.requiresStructureRuntime(entry.def.codec))) yield* structureRuntime.ensureInitialized();
+	const statusCodes = yield* runChunked(yield* Effect.forEach(entries, (entry) => encodeWriteValue(entry, structureRuntime)), options, (chunk) => Effect.gen(function* () {
+		const statusCodes$1 = yield* Effect.tryPromise({
+			try: () => session.write([...chunk]),
+			catch: (cause) => serviceError({
+				operation: "write",
+				cause
+			})
+		});
+		if (statusCodes$1.length !== chunk.length) return yield* Effect.fail(serviceError({
+			operation: "write",
+			cause: `Expected ${chunk.length} StatusCodes, got ${statusCodes$1.length}`
+		}));
+		return statusCodes$1;
+	}));
+	return entries.map((entry, index) => writeResult(entry.def.nodeId, statusCodes[index]));
+});
+const writeResult = (nodeId, statusCode) => isGood(statusCode) ? {
+	_tag: "Written",
+	nodeId,
+	status: normalizeStatusCode(statusCode)
+} : {
+	_tag: "NonGoodStatus",
+	nodeId,
+	status: normalizeStatusCode(statusCode)
+};
+const encodeWriteValue = (entry, structureRuntime) => Effect.gen(function* () {
+	const variant = yield* Codec.encode(entry.def.codec, entry.value, codecMetadata(entry.metadata), structureRuntime);
+	return {
+		nodeId: entry.rawNodeId,
+		attributeId: AttributeIds.Value,
+		value: { value: variant }
+	};
+});
+const accessDeniedError = (nodeId, requestedCapability, accessLevel, userAccessLevel) => {
+	const hasNodeAccess = hasAccess(accessLevel, requestedCapability);
+	const hasUserAccess = userAccessLevel === void 0 || hasAccess(userAccessLevel, requestedCapability);
+	if (!hasNodeAccess || !hasUserAccess) return accessDeniedError$1({
+		nodeId,
+		requestedCapability,
+		accessLevel,
+		userAccessLevel
+	});
+};
+const variableAccessCapabilities = (access) => {
+	switch (access) {
+		case "read": return ["read"];
+		case "write": return ["write"];
+		case "readWrite": return ["read", "write"];
+	}
+};
+const hasAccess = (accessLevel, capability) => {
+	return (accessLevel & (capability === "read" ? AccessLevelFlag.CurrentRead : AccessLevelFlag.CurrentWrite)) !== 0;
+};
+const variableMetadataFromRaw = (input) => ({
+	nodeId: input.nodeId,
+	declaredDataType: normalizeNodeId(input.dataTypeNodeId),
+	builtInDataType: DataType[input.builtInDataType] ?? String(input.builtInDataType),
+	valueRank: input.valueRank,
+	arrayDimensions: input.arrayDimensions,
+	accessLevel: input.accessLevel,
+	userAccessLevel: input.userAccessLevel,
+	access: {
+		readable: hasAccess(input.accessLevel, "read"),
+		writable: hasAccess(input.accessLevel, "write"),
+		userReadable: input.userAccessLevel === void 0 || hasAccess(input.userAccessLevel, "read"),
+		userWritable: input.userAccessLevel === void 0 || hasAccess(input.userAccessLevel, "write")
+	},
+	unsafeRaw: {
+		declaredDataType: input.dataTypeNodeId,
+		builtInDataType: input.builtInDataType
+	}
+});
+const codecMetadata = (metadata) => ({
+	nodeId: metadata.nodeId,
+	valueRank: metadata.valueRank,
+	arrayDimensions: metadata.arrayDimensions,
+	raw: {
+		declaredDataType: metadata.unsafeRaw.declaredDataType,
+		builtInDataType: metadata.unsafeRaw.builtInDataType
+	}
+});
+const sampleBase = (nodeId, dataValue, includeRaw) => ({
+	nodeId,
+	status: normalizeStatusCode(dataValue.statusCode),
+	sourceTimestamp: normalizeTimestamp(dataValue.sourceTimestamp),
+	serverTimestamp: normalizeTimestamp(dataValue.serverTimestamp),
+	variant: dataValue.value ? normalizeVariantInfo(dataValue.value) : void 0,
+	unsafeRaw: includeRaw ? {
+		dataValue,
+		variant: dataValue.value
+	} : void 0
+});
+
+//#endregion
+export { accessDeniedError, codecMetadata, hasAccess, readDataValue, readPreparedVariables, readVariable, sampleFromDataValue, variableAccessCapabilities, variableMetadataFromRaw, writePreparedVariables, writeResult, writeVariable };
+//# sourceMappingURL=operations.mjs.map

package/dist/internal/variable/operations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.mjs","names":["readValueIds: ReadonlyArray<ReadValueIdOptions>","dataValues","base","statusCodes","makeAccessDeniedError"],"sources":["../../../src/internal/variable/operations.ts"],"sourcesContent":["import {\n  AccessLevelFlag,\n  AttributeIds,\n  DataType,\n  NodeId,\n  coerceNodeId,\n  type ClientSession,\n  type DataValue,\n  type ReadValueIdOptions,\n  type StatusCode,\n  type WriteValueOptions,\n} from \"node-opcua\";\nimport { Effect } from \"effect\";\n\nimport { runChunked, type BatchOptions } from \"../batch/chunk.js\";\nimport type { NodeIdString, VariableCapability } from \"../common/node-id.js\";\nimport { Codec, type OpcuaCodec } from \"../values/codec.js\";\nimport {\n  accessDeniedError as makeAccessDeniedError,\n  serviceError,\n  type OpcuaEncodeError,\n  type OpcuaServiceError,\n} from \"../../OpcuaError.js\";\nimport {\n  isGood,\n  normalizeNodeId,\n  normalizeStatusCode,\n  normalizeTimestamp,\n  normalizeVariantInfo,\n} from \"../values/normalize.js\";\nimport { resultFromStatusAndDecode } from \"../values/result.js\";\nimport type { OpcuaStructureRuntime } from \"../structures/runtime.js\";\nimport type {\n  ReadResult,\n  ReadableVariableDef,\n  ValueOfVariableDef,\n  VariableAccess,\n  VariableDef,\n  VariableMetadata,\n  WritableVariableDef,\n  WriteResult,\n} from \"../../OpcuaVariable.js\";\n\nexport const readDataValue = (session: ClientSession, nodeId: NodeIdString) =>\n  Effect.tryPromise({\n    try: () =>\n      session.read(\n        {\n          nodeId: coerceNodeId(nodeId),\n          attributeId: AttributeIds.Value,\n        },\n        0,\n      ),\n    catch: (cause) => serviceError({ operation: \"read\", nodeId, cause }),\n  });\n\nexport const readVariable = <const Id extends string, A>(\n  session: ClientSession,\n  def:\n    | VariableDef<Id, A, \"read\" | \"readWrite\">\n    | VariableDef<Id, A, VariableAccess>,\n  structureRuntime: OpcuaStructureRuntime,\n) =>\n  Effect.gen(function* () {\n    if (Codec.requiresStructureRuntime(def.codec)) {\n      yield* structureRuntime.ensureInitialized();\n    }\n    const dataValue = yield* readDataValue(session, def.nodeId).pipe(\n      Effect.withSpan(\"opcua.raw.read\", {\n        attributes: { \"opcua.node_id\": def.nodeId },\n        kind: \"client\",\n      }),\n    );\n    return yield* sampleFromDataValue(def, dataValue, structureRuntime);\n  });\n\nexport type PreparedReadVariable<\n  Def extends ReadableVariableDef = ReadableVariableDef,\n> = {\n  readonly def: Def;\n  readonly rawNodeId: NodeId;\n};\n\nexport const readPreparedVariables = (\n  session: ClientSession,\n  items: ReadonlyArray<PreparedReadVariable>,\n  structureRuntime: OpcuaStructureRuntime,\n  options?: BatchOptions,\n) =>\n  Effect.gen(function* () {\n    if (items.some((item) => Codec.requiresStructureRuntime(item.def.codec))) {\n      yield* structureRuntime.ensureInitialized();\n    }\n    const dataValues = yield* runChunked(items, options, (chunk) =>\n      Effect.gen(function* () {\n        const readValueIds: ReadonlyArray<ReadValueIdOptions> = chunk.map(\n          (item) => ({\n            nodeId: item.rawNodeId,\n            attributeId: AttributeIds.Value,\n          }),\n        );\n        const dataValues = yield* Effect.tryPromise({\n          try: () => session.read([...readValueIds], 0),\n          catch: (cause) =>\n            serviceError({\n              operation: \"read\",\n              cause,\n            }),\n        }).pipe(\n          Effect.withSpan(\"opcua.raw.read.batch\", {\n            attributes: { \"opcua.node_count\": chunk.length },\n            kind: \"client\",\n          }),\n        );\n        if (dataValues.length !== chunk.length) {\n          return yield* Effect.fail(\n            serviceError({\n              operation: \"read\",\n              cause: `Expected ${chunk.length} DataValues, got ${dataValues.length}`,\n            }),\n          );\n        }\n        return dataValues;\n      }),\n    );\n    return yield* Effect.forEach(items, (item, index) =>\n      sampleFromDataValue(item.def, dataValues[index]!, structureRuntime),\n    );\n  });\n\nexport const sampleFromDataValue = <const Id extends string, A>(\n  def: VariableDef<Id, A, VariableAccess>,\n  dataValue: DataValue,\n  structureRuntime: OpcuaStructureRuntime,\n) =>\n  Effect.suspend(() => {\n    const base = sampleBase(def.nodeId, dataValue, def.includeRaw ?? false);\n    return resultFromStatusAndDecode<A, typeof base, ReadResult<A, Id>>({\n      statusCode: dataValue.statusCode,\n      status: base,\n      decode: Codec.decode(\n        def.codec,\n        dataValue.value,\n        dataValue,\n        structureRuntime,\n      ),\n      nonGoodStatus: (base) =>\n        ({ _tag: \"NonGoodStatus\", ...base }) as ReadResult<A, Id>,\n      decodeError: (error, base) =>\n        ({ _tag: \"DecodeError\", ...base, error }) as ReadResult<A, Id>,\n      value: (value) =>\n        ({\n          _tag: \"Value\",\n          ...base,\n          value: value as unknown as A,\n        }) as ReadResult<A, Id>,\n    });\n  });\n\nexport const writeVariable = <const Id extends string, A>(\n  session: ClientSession,\n  def: VariableDef<Id, A, VariableAccess>,\n  metadata: VariableMetadata,\n  value: A,\n  structureRuntime: OpcuaStructureRuntime,\n) =>\n  Effect.gen(function* () {\n    if (Codec.requiresStructureRuntime(def.codec)) {\n      yield* structureRuntime.ensureInitialized();\n    }\n    const variant = yield* Codec.encode(\n      def.codec as OpcuaCodec<unknown>,\n      value as unknown,\n      codecMetadata(metadata),\n      structureRuntime,\n    );\n    const statusCode = yield* Effect.tryPromise({\n      try: () =>\n        session.write({\n          nodeId: coerceNodeId(def.nodeId),\n          attributeId: AttributeIds.Value,\n          value: { value: variant },\n        }),\n      catch: (cause) =>\n        serviceError({\n          operation: \"write\",\n          nodeId: def.nodeId,\n          cause,\n        }),\n    }).pipe(\n      Effect.withSpan(\"opcua.raw.write\", {\n        attributes: { \"opcua.node_id\": def.nodeId },\n        kind: \"client\",\n      }),\n    );\n    return writeResult(def.nodeId, statusCode);\n  });\n\nexport type PreparedWriteVariable<\n  Def extends WritableVariableDef = WritableVariableDef,\n> = {\n  readonly def: Def;\n  readonly metadata: VariableMetadata;\n  readonly value: ValueOfVariableDef<Def>;\n  readonly rawNodeId: NodeId;\n};\n\nexport const writePreparedVariables = (\n  session: ClientSession,\n  entries: ReadonlyArray<PreparedWriteVariable>,\n  structureRuntime: OpcuaStructureRuntime,\n  options?: BatchOptions,\n) =>\n  Effect.gen(function* () {\n    if (\n      entries.some((entry) => Codec.requiresStructureRuntime(entry.def.codec))\n    ) {\n      yield* structureRuntime.ensureInitialized();\n    }\n    const writeValues = yield* Effect.forEach(entries, (entry) =>\n      encodeWriteValue(entry, structureRuntime),\n    );\n    const statusCodes = yield* runChunked(writeValues, options, (chunk) =>\n      Effect.gen(function* () {\n        const statusCodes = yield* Effect.tryPromise({\n          try: () => session.write([...chunk]),\n          catch: (cause) =>\n            serviceError({\n              operation: \"write\",\n              cause,\n            }),\n        });\n        if (statusCodes.length !== chunk.length) {\n          return yield* Effect.fail(\n            serviceError({\n              operation: \"write\",\n              cause: `Expected ${chunk.length} StatusCodes, got ${statusCodes.length}`,\n            }),\n          );\n        }\n        return statusCodes;\n      }),\n    );\n    return entries.map((entry, index) =>\n      writeResult(entry.def.nodeId, statusCodes[index]!),\n    );\n  });\n\nexport const writeResult = <Id extends string>(\n  nodeId: Id,\n  statusCode: StatusCode,\n): WriteResult<Id> =>\n  isGood(statusCode)\n    ? { _tag: \"Written\", nodeId, status: normalizeStatusCode(statusCode) }\n    : {\n        _tag: \"NonGoodStatus\",\n        nodeId,\n        status: normalizeStatusCode(statusCode),\n      };\n\nconst encodeWriteValue = (\n  entry: PreparedWriteVariable,\n  structureRuntime: OpcuaStructureRuntime,\n): Effect.Effect<WriteValueOptions, OpcuaEncodeError | OpcuaServiceError> =>\n  Effect.gen(function* () {\n    const variant = yield* Codec.encode(\n      entry.def.codec as OpcuaCodec<unknown>,\n      entry.value as unknown,\n      codecMetadata(entry.metadata),\n      structureRuntime,\n    );\n    return {\n      nodeId: entry.rawNodeId,\n      attributeId: AttributeIds.Value,\n      value: { value: variant },\n    };\n  });\n\nexport const accessDeniedError = (\n  nodeId: NodeIdString,\n  requestedCapability: VariableCapability,\n  accessLevel: number,\n  userAccessLevel?: number,\n) => {\n  const hasNodeAccess = hasAccess(accessLevel, requestedCapability);\n  const hasUserAccess =\n    userAccessLevel === undefined ||\n    hasAccess(userAccessLevel, requestedCapability);\n  if (!hasNodeAccess || !hasUserAccess) {\n    return makeAccessDeniedError({\n      nodeId,\n      requestedCapability,\n      accessLevel,\n      userAccessLevel,\n    });\n  }\n  return undefined;\n};\n\nexport const variableAccessCapabilities = (\n  access: VariableAccess,\n): ReadonlyArray<VariableCapability> => {\n  switch (access) {\n    case \"read\":\n      return [\"read\"];\n    case \"write\":\n      return [\"write\"];\n    case \"readWrite\":\n      return [\"read\", \"write\"];\n  }\n};\n\nexport const hasAccess = (\n  accessLevel: number,\n  capability: VariableCapability,\n) => {\n  const flag =\n    capability === \"read\"\n      ? AccessLevelFlag.CurrentRead\n      : AccessLevelFlag.CurrentWrite;\n  return (accessLevel & flag) !== 0;\n};\n\nexport const variableMetadataFromRaw = (input: {\n  readonly nodeId: NodeIdString;\n  readonly dataTypeNodeId: NodeId;\n  readonly builtInDataType: DataType;\n  readonly valueRank: number;\n  readonly arrayDimensions?: ReadonlyArray<number>;\n  readonly accessLevel: number;\n  readonly userAccessLevel?: number;\n}): VariableMetadata => ({\n  nodeId: input.nodeId,\n  declaredDataType: normalizeNodeId(input.dataTypeNodeId),\n  builtInDataType:\n    DataType[input.builtInDataType] ?? String(input.builtInDataType),\n  valueRank: input.valueRank,\n  arrayDimensions: input.arrayDimensions,\n  accessLevel: input.accessLevel,\n  userAccessLevel: input.userAccessLevel,\n  access: {\n    readable: hasAccess(input.accessLevel, \"read\"),\n    writable: hasAccess(input.accessLevel, \"write\"),\n    userReadable:\n      input.userAccessLevel === undefined ||\n      hasAccess(input.userAccessLevel, \"read\"),\n    userWritable:\n      input.userAccessLevel === undefined ||\n      hasAccess(input.userAccessLevel, \"write\"),\n  },\n  unsafeRaw: {\n    declaredDataType: input.dataTypeNodeId,\n    builtInDataType: input.builtInDataType,\n  },\n});\n\nexport const codecMetadata = (metadata: VariableMetadata) => ({\n  nodeId: metadata.nodeId,\n  valueRank: metadata.valueRank,\n  arrayDimensions: metadata.arrayDimensions,\n  raw: {\n    declaredDataType: metadata.unsafeRaw.declaredDataType,\n    builtInDataType: metadata.unsafeRaw.builtInDataType,\n  },\n});\n\nconst sampleBase = <Id extends string>(\n  nodeId: Id,\n  dataValue: DataValue,\n  includeRaw: boolean,\n) => ({\n  nodeId,\n  status: normalizeStatusCode(dataValue.statusCode),\n  sourceTimestamp: normalizeTimestamp(dataValue.sourceTimestamp),\n  serverTimestamp: normalizeTimestamp(dataValue.serverTimestamp),\n  variant: dataValue.value ? normalizeVariantInfo(dataValue.value) : undefined,\n  unsafeRaw: includeRaw\n    ? {\n        dataValue,\n        variant: dataValue.value,\n      }\n    : undefined,\n});\n"],"mappings":"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"}

package/dist/node-opcua.d.mts

@@ -0,0 +1,2 @@
+import { AccessLevelFlag, Argument, AttributeIds, BrowseDirection, BrowseResult, ClientMonitoredItemGroup, ClientSession, ClientSubscription, DataType, DataValue, ExpandedNodeId, NodeClass, NodeClassMask, NodeId, OPCUAClient, OPCUAClientOptions, ReadValueIdOptions, ReferenceDescription, ResultMask, StatusCode, StatusCodes, TimestampsToReturn, UserIdentityInfo, UserTokenType, Variant, VariantArrayType, coerceNodeId, makeNodeClassMask, makeResultMask } from "node-opcua";
+export { AccessLevelFlag, type Argument, AttributeIds, BrowseDirection, type BrowseResult, type ClientMonitoredItemGroup, type ClientSession, type ClientSubscription, DataType, type DataValue, type ExpandedNodeId, NodeClass, NodeClassMask, type NodeId, type OPCUAClient, type OPCUAClientOptions, type ReadValueIdOptions, type ReferenceDescription, ResultMask, type StatusCode, StatusCodes, TimestampsToReturn, type UserIdentityInfo, UserTokenType, Variant, VariantArrayType, coerceNodeId, makeNodeClassMask, makeResultMask };

package/dist/node-opcua.mjs

@@ -0,0 +1,3 @@
+import { AccessLevelFlag, AttributeIds, BrowseDirection, DataType, NodeClass, NodeClassMask, ResultMask, StatusCodes, TimestampsToReturn, UserTokenType, Variant, VariantArrayType, coerceNodeId, makeNodeClassMask, makeResultMask } from "node-opcua";
+
+export { AccessLevelFlag, AttributeIds, BrowseDirection, DataType, NodeClass, NodeClassMask, ResultMask, StatusCodes, TimestampsToReturn, UserTokenType, Variant, VariantArrayType, coerceNodeId, makeNodeClassMask, makeResultMask };

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@effect-opcua/client",
+  "version": "0.1.0-alpha.1",
+  "description": "Effect-native OPC-UA client wrapper for node-opcua",
+  "license": "Apache-2.0",
+  "sideEffects": false,
+  "type": "module",
+  "files": [
+    "LICENSE",
+    "README.md",
+    "dist",
+    "package.json"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bastikohn/effect-opcua.git",
+    "directory": "packages/client"
+  },
+  "bugs": {
+    "url": "https://github.com/bastikohn/effect-opcua/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./node-opcua": {
+      "types": "./dist/node-opcua.d.mts",
+      "default": "./dist/node-opcua.mjs"
+    },
+    "./package.json": "./package.json",
+    "./internal/*": null
+  },
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "scripts": {
+    "build": "tsdown --config-loader unrun",
+    "dev": "tsdown --watch --config-loader unrun",
+    "typecheck": "tsc --noEmit --project tsconfig.json",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist coverage node_modules"
+  },
+  "peerDependencies": {
+    "effect": "4.0.0-beta.79"
+  },
+  "dependencies": {
+    "node-opcua": "^2.170.0"
+  },
+  "devDependencies": {}
+}