@effect-opcua/client 0.1.0-alpha.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.mjs","names":["namespaceArrayCache: readonly string[] | undefined","nodes: MetadataService[\"nodes\"]","node: MetadataService[\"node\"]","builtInDataType: MetadataService[\"builtInDataType\"]","variable: MetadataService[\"variable\"]","method: MetadataService[\"method\"]","results: OpcuaNodeMetadataResult[]","result: A[][]","browse: BrowseDescriptionOptions"],"sources":["../../../src/internal/metadata/service.ts"],"sourcesContent":["import {\n  AccessLevelFlag,\n  AttributeIds,\n  BrowseDirection,\n  DataType,\n  DataTypeIds,\n  NodeClass,\n  NodeId,\n  NodeIdType,\n  ReferenceTypeIds,\n  StatusCodes,\n  coerceNodeId,\n  type BrowseDescriptionOptions,\n  type ClientSession,\n  type DataValue,\n  type ReadValueIdOptions,\n} from \"node-opcua\";\nimport { Effect } from \"effect\";\n\nimport type { NodeIdString } from \"../common/node-id.js\";\nimport { Codec } from \"../values/codec.js\";\nimport type {\n  OpcuaAccessBits,\n  OpcuaMetadataAttribute,\n  OpcuaMetadataReadFailure,\n  OpcuaNodeMetadata,\n  OpcuaNodeMetadataResult,\n} from \"../../OpcuaSession.js\";\nimport {\n  configurationError,\n  isConfigurationError,\n  methodNotExecutableError,\n  serviceError,\n  OpcuaAccessDeniedError,\n  OpcuaConfigurationError,\n  OpcuaMethodNotExecutableError,\n  OpcuaServiceError,\n} from \"../../OpcuaError.js\";\nimport type {\n  AnyMethodDef,\n  MethodArg,\n  MethodMetadata,\n} from \"../../OpcuaMethod.js\";\nimport {\n  methodArgumentMetadataFromRaw,\n  readBooleanAttribute,\n  resolveMethodMapping,\n} from \"../method/arguments.js\";\nimport { isGood } from \"../values/normalize.js\";\nimport {\n  normalizeLocalizedText,\n  normalizeQualifiedName,\n  normalizeStatusCode,\n} from \"../values/normalize.js\";\nimport type { OpcuaStructureRuntime } from \"../structures/runtime.js\";\nimport {\n  accessDeniedError,\n  codecMetadata,\n  variableAccessCapabilities,\n  variableMetadataFromRaw,\n} from \"../variable/operations.js\";\nimport type { AnyVariableDef, VariableMetadata } from \"../../OpcuaVariable.js\";\nexport type {\n  OpcuaAccessBits,\n  OpcuaMetadataAttribute,\n  OpcuaMetadataReadFailure,\n  OpcuaNodeMetadata,\n  OpcuaNodeMetadataResult,\n} from \"../../OpcuaSession.js\";\n\nexport type MetadataService = {\n  readonly namespaceArray: () => Effect.Effect<\n    readonly string[],\n    OpcuaServiceError | OpcuaConfigurationError\n  >;\n  readonly node: (\n    nodeId: NodeIdString,\n  ) => Effect.Effect<\n    OpcuaNodeMetadata,\n    OpcuaServiceError | OpcuaConfigurationError\n  >;\n  readonly nodes: (\n    nodeIds: readonly NodeIdString[],\n  ) => Effect.Effect<\n    readonly OpcuaNodeMetadataResult[],\n    OpcuaServiceError | OpcuaConfigurationError\n  >;\n  readonly variable: (\n    def: AnyVariableDef,\n  ) => Effect.Effect<\n    VariableMetadata,\n    OpcuaServiceError | OpcuaConfigurationError | OpcuaAccessDeniedError\n  >;\n  readonly method: (\n    def: AnyMethodDef,\n  ) => Effect.Effect<\n    MethodMetadata,\n    OpcuaServiceError | OpcuaConfigurationError | OpcuaMethodNotExecutableError\n  >;\n  readonly builtInDataType: (\n    dataTypeNodeId: NodeId,\n  ) => Effect.Effect<DataType, OpcuaServiceError | OpcuaConfigurationError>;\n  readonly invalidate: Effect.Effect<void>;\n};\n\ntype MethodBaseMetadata = {\n  readonly objectId: NodeIdString;\n  readonly methodId: NodeIdString;\n  readonly executable: boolean;\n  readonly userExecutable?: boolean;\n  readonly inputArguments: MethodMetadata[\"inputArguments\"];\n  readonly outputArguments: MethodMetadata[\"outputArguments\"];\n};\n\nexport const makeMetadataService = (\n  session: ClientSession,\n  structureRuntime: OpcuaStructureRuntime,\n): MetadataService => {\n  let namespaceArrayCache: readonly string[] | undefined;\n  const variableCache = new Map<string, VariableMetadata>();\n  const methodCache = new Map<string, MethodBaseMetadata>();\n  const builtInDataTypeCache = new Map<string, DataType>();\n\n  const namespaceArray = () =>\n    Effect.suspend(() => {\n      if (namespaceArrayCache !== undefined) {\n        return Effect.succeed(namespaceArrayCache);\n      }\n      return readNamespaceArray(session).pipe(\n        Effect.tap((value) =>\n          Effect.sync(() => {\n            namespaceArrayCache = value;\n          }),\n        ),\n      );\n    });\n\n  const nodes: MetadataService[\"nodes\"] = (nodeIds) =>\n    readManyNodeMetadata(session, namespaceArray, nodeIds);\n\n  const node: MetadataService[\"node\"] = (nodeId) =>\n    Effect.gen(function* () {\n      const [result] = yield* nodes([nodeId]);\n      if (!result || result._tag === \"Failure\") {\n        return yield* Effect.fail(\n          configurationError({\n            operation: \"metadata.node\",\n            nodeId,\n            cause:\n              result?._tag === \"Failure\"\n                ? result.reason\n                : \"No metadata result was returned\",\n          }),\n        );\n      }\n      return result.metadata;\n    });\n\n  const builtInDataType: MetadataService[\"builtInDataType\"] = (\n    dataTypeNodeId,\n  ) =>\n    Effect.suspend(() => {\n      const key = dataTypeNodeId.toString();\n      const cached = builtInDataTypeCache.get(key);\n      if (cached !== undefined) return Effect.succeed(cached);\n      return resolveBuiltInDataType(session, dataTypeNodeId).pipe(\n        Effect.tap((value) =>\n          Effect.sync(() => {\n            builtInDataTypeCache.set(key, value);\n          }),\n        ),\n      );\n    });\n\n  const rawVariableMetadata = (nodeId: NodeIdString) =>\n    Effect.suspend(() => {\n      const cached = variableCache.get(nodeId);\n      if (cached) return Effect.succeed(cached);\n      return discoverVariableMetadata(session, nodeId, builtInDataType).pipe(\n        Effect.tap((metadata) =>\n          Effect.sync(() => {\n            variableCache.set(nodeId, metadata);\n          }),\n        ),\n      );\n    });\n\n  const variable: MetadataService[\"variable\"] = (def) =>\n    Effect.gen(function* () {\n      const metadata = yield* rawVariableMetadata(def.nodeId);\n      for (const capability of variableAccessCapabilities(def.access)) {\n        const error = accessDeniedError(\n          def.nodeId,\n          capability,\n          metadata.accessLevel,\n          metadata.userAccessLevel,\n        );\n        if (error) return yield* Effect.fail(error);\n      }\n      if (Codec.requiresStructureRuntime(def.codec)) {\n        yield* structureRuntime.ensureInitialized();\n      }\n      yield* Codec.validateMetadata(def.codec, codecMetadata(metadata));\n      return metadata;\n    });\n\n  const rawMethodMetadata = (def: AnyMethodDef) =>\n    Effect.suspend(() => {\n      const key = `${def.objectId}\\u0000${def.methodId}`;\n      const cached = methodCache.get(key);\n      if (cached) return Effect.succeed(cached);\n      return discoverMethodBaseMetadata(session, def, builtInDataType).pipe(\n        Effect.tap((metadata) =>\n          Effect.sync(() => {\n            methodCache.set(key, metadata);\n          }),\n        ),\n      );\n    });\n\n  const method: MetadataService[\"method\"] = (def) =>\n    Effect.gen(function* () {\n      const base = yield* rawMethodMetadata(def);\n      if (!base.executable || base.userExecutable === false) {\n        return yield* Effect.fail(\n          methodNotExecutableError({\n            objectId: def.objectId,\n            methodId: def.methodId,\n            executable: base.executable,\n            userExecutable: base.userExecutable,\n          }),\n        );\n      }\n      if (\n        (\n          Object.values(def.input ?? {}) as ReadonlyArray<MethodArg<unknown>>\n        ).some((arg) => Codec.requiresStructureRuntime(arg.codec)) ||\n        (\n          Object.values(def.output ?? {}) as ReadonlyArray<MethodArg<unknown>>\n        ).some((arg) => Codec.requiresStructureRuntime(arg.codec))\n      ) {\n        yield* structureRuntime.ensureInitialized();\n      }\n      const inputMapping = yield* resolveMethodMapping(\n        \"method.input\",\n        def.methodId,\n        base.inputArguments,\n        def.input,\n      );\n      const outputMapping = yield* resolveMethodMapping(\n        \"method.output\",\n        def.methodId,\n        base.outputArguments,\n        def.output,\n      );\n      return {\n        ...base,\n        inputMapping,\n        outputMapping,\n      };\n    });\n\n  const invalidate = Effect.sync(() => {\n    namespaceArrayCache = undefined;\n    variableCache.clear();\n    methodCache.clear();\n    builtInDataTypeCache.clear();\n  });\n\n  return {\n    namespaceArray,\n    node,\n    nodes,\n    variable,\n    method,\n    builtInDataType,\n    invalidate,\n  };\n};\n\nconst readNamespaceArray = (session: ClientSession) =>\n  Effect.gen(function* () {\n    const dataValue = yield* Effect.tryPromise({\n      try: () =>\n        session.read(\n          { nodeId: coerceNodeId(\"i=2255\"), attributeId: AttributeIds.Value },\n          0,\n        ),\n      catch: (cause) =>\n        serviceError({\n          operation: \"metadata.namespaceArray\",\n          nodeId: \"i=2255\",\n          cause,\n        }),\n    });\n    if (!isGood(dataValue.statusCode)) {\n      return yield* Effect.fail(\n        configurationError({\n          operation: \"metadata.namespaceArray\",\n          nodeId: \"i=2255\",\n          cause: normalizeStatusCode(dataValue.statusCode),\n        }),\n      );\n    }\n    const value = dataValue.value?.value;\n    if (\n      !Array.isArray(value) ||\n      !value.every((item) => typeof item === \"string\")\n    ) {\n      return yield* Effect.fail(\n        configurationError({\n          operation: \"metadata.namespaceArray\",\n          nodeId: \"i=2255\",\n          cause: \"NamespaceArray value is not a string array\",\n        }),\n      );\n    }\n    return [...value];\n  });\n\nconst metadataAttributes = [\n  [\"NodeClass\", AttributeIds.NodeClass],\n  [\"BrowseName\", AttributeIds.BrowseName],\n  [\"DisplayName\", AttributeIds.DisplayName],\n  [\"Description\", AttributeIds.Description],\n  [\"DataType\", AttributeIds.DataType],\n  [\"ValueRank\", AttributeIds.ValueRank],\n  [\"ArrayDimensions\", AttributeIds.ArrayDimensions],\n  [\"AccessLevel\", AttributeIds.AccessLevel],\n  [\"UserAccessLevel\", AttributeIds.UserAccessLevel],\n] as const satisfies ReadonlyArray<\n  readonly [OpcuaMetadataAttribute, AttributeIds]\n>;\n\nconst maxMetadataNodesPerRead = 50;\n\nconst requiredMetadataAttributes = new Set<OpcuaMetadataAttribute>([\n  \"NodeClass\",\n  \"BrowseName\",\n]);\n\nconst readManyNodeMetadata = (\n  session: ClientSession,\n  namespaceArray: MetadataService[\"namespaceArray\"],\n  nodeIds: readonly NodeIdString[],\n) =>\n  Effect.gen(function* () {\n    if (nodeIds.length === 0) return [];\n    const namespaceUris = yield* namespaceArray();\n    const results: OpcuaNodeMetadataResult[] = [];\n    for (const batch of chunks(nodeIds, maxMetadataNodesPerRead)) {\n      const batchResults = yield* readNodeMetadataBatch(\n        session,\n        namespaceUris,\n        batch,\n      );\n      results.push(...batchResults);\n    }\n    return results;\n  });\n\nconst readNodeMetadataBatch = (\n  session: ClientSession,\n  namespaceUris: readonly string[],\n  nodeIds: readonly NodeIdString[],\n) =>\n  Effect.gen(function* () {\n    const readPlan = nodeIds.map((nodeId) => {\n      const parsed = coerceNodeId(nodeId);\n      const nodesToRead = metadataAttributes.map(\n        ([attribute, attributeId]) =>\n          ({\n            nodeId: parsed,\n            attributeId,\n            attribute,\n          }) as ReadValueIdOptions & {\n            readonly attribute: OpcuaMetadataAttribute;\n          },\n      );\n      return { nodeId, parsed, nodesToRead };\n    });\n    const flatNodes = readPlan.flatMap((entry) => entry.nodesToRead);\n    const values = yield* Effect.tryPromise({\n      try: () => session.read(flatNodes, 0),\n      catch: (cause) =>\n        serviceError({\n          operation: \"metadata.nodes\",\n          cause,\n        }),\n    });\n    if (values.length !== flatNodes.length) {\n      return yield* Effect.fail(\n        serviceError({\n          operation: \"metadata.nodes\",\n          cause: `Expected ${flatNodes.length} DataValues, got ${values.length}`,\n        }),\n      );\n    }\n\n    let offset = 0;\n    return readPlan.map((entry): OpcuaNodeMetadataResult => {\n      const valuesByAttribute = new Map<OpcuaMetadataAttribute, DataValue>();\n      for (const [attribute] of metadataAttributes) {\n        valuesByAttribute.set(attribute, values[offset++]!);\n      }\n      const failure = metadataFailure(valuesByAttribute);\n      if (failure) {\n        return {\n          _tag: \"Failure\",\n          nodeId: entry.nodeId,\n          reason: failure,\n        };\n      }\n      return {\n        _tag: \"Success\",\n        nodeId: entry.nodeId,\n        metadata: nodeMetadataFromValues(\n          entry.nodeId,\n          entry.parsed.namespace,\n          namespaceUris[entry.parsed.namespace],\n          valuesByAttribute,\n        ),\n      };\n    });\n  });\n\nconst chunks = <A>(items: readonly A[], size: number): readonly A[][] => {\n  const result: A[][] = [];\n  for (let index = 0; index < items.length; index += size) {\n    result.push([...items.slice(index, index + size)]);\n  }\n  return result;\n};\n\nconst metadataFailure = (\n  values: ReadonlyMap<OpcuaMetadataAttribute, DataValue>,\n): OpcuaMetadataReadFailure | undefined => {\n  for (const attribute of requiredMetadataAttributes) {\n    const value = values.get(attribute);\n    if (!value || !isGood(value.statusCode)) {\n      return {\n        _tag: \"NonGoodStatus\",\n        attribute,\n        status: normalizeStatusCode(\n          value?.statusCode ?? StatusCodes.BadInternalError,\n        ),\n      };\n    }\n  }\n  if (typeof values.get(\"NodeClass\")?.value?.value !== \"number\") {\n    return {\n      _tag: \"InvalidValue\",\n      attribute: \"NodeClass\",\n      message: \"NodeClass value is not numeric\",\n    };\n  }\n  if (!values.get(\"BrowseName\")?.value?.value) {\n    return {\n      _tag: \"InvalidValue\",\n      attribute: \"BrowseName\",\n      message: \"BrowseName value is missing\",\n    };\n  }\n  return undefined;\n};\n\nconst nodeMetadataFromValues = (\n  nodeId: string,\n  namespaceIndex: number,\n  namespaceUri: string | undefined,\n  values: ReadonlyMap<OpcuaMetadataAttribute, DataValue>,\n): OpcuaNodeMetadata => {\n  const browseNameValue = values.get(\"BrowseName\")?.value?.value;\n  const displayNameValue = values.get(\"DisplayName\");\n  const descriptionValue = values.get(\"Description\");\n  const nodeClassNumber = values.get(\"NodeClass\")?.value?.value as number;\n  const browseName = normalizeQualifiedName(\n    browseNameValue as Parameters<typeof normalizeQualifiedName>[0],\n  );\n  return {\n    nodeId,\n    nodeClass: NodeClass[nodeClassNumber] ?? String(nodeClassNumber),\n    browseName: browseName.name,\n    browseNameNamespaceIndex: browseName.namespaceIndex,\n    displayName: localizedText(displayNameValue),\n    description: localizedText(descriptionValue),\n    dataType: nodeIdValue(values.get(\"DataType\")),\n    valueRank: numberValue(values.get(\"ValueRank\")),\n    arrayDimensions: numberArrayValue(values.get(\"ArrayDimensions\")),\n    accessLevel: accessBits(values.get(\"AccessLevel\")),\n    userAccessLevel: accessBits(values.get(\"UserAccessLevel\")),\n    namespaceIndex,\n    namespaceUri,\n  };\n};\n\nconst localizedText = (dataValue: DataValue | undefined) => {\n  if (!dataValue || !isGood(dataValue.statusCode) || !dataValue.value?.value) {\n    return undefined;\n  }\n  return normalizeLocalizedText(\n    dataValue.value.value as Parameters<typeof normalizeLocalizedText>[0],\n  ).text;\n};\n\nconst nodeIdValue = (dataValue: DataValue | undefined) => {\n  if (!dataValue || !isGood(dataValue.statusCode)) return undefined;\n  const value = dataValue.value?.value;\n  return value instanceof NodeId ? value.toString() : undefined;\n};\n\nconst numberValue = (dataValue: DataValue | undefined) => {\n  if (!dataValue || !isGood(dataValue.statusCode)) return undefined;\n  const value = dataValue.value?.value;\n  return typeof value === \"number\" ? value : undefined;\n};\n\nconst numberArrayValue = (dataValue: DataValue | undefined) => {\n  if (!dataValue || !isGood(dataValue.statusCode)) return undefined;\n  const value = dataValue.value?.value;\n  if (\n    !Array.isArray(value) ||\n    !value.every((item) => typeof item === \"number\")\n  ) {\n    return undefined;\n  }\n  return [...value];\n};\n\nconst accessBits = (\n  dataValue: DataValue | undefined,\n): OpcuaAccessBits | undefined => {\n  const value = numberValue(dataValue);\n  if (value === undefined) return undefined;\n  return {\n    readable: (value & AccessLevelFlag.CurrentRead) !== 0,\n    writable: (value & AccessLevelFlag.CurrentWrite) !== 0,\n  };\n};\n\nconst discoverVariableMetadata = (\n  session: ClientSession,\n  nodeId: NodeIdString,\n  builtInDataType: MetadataService[\"builtInDataType\"],\n) =>\n  Effect.gen(function* () {\n    const nodes = [\n      AttributeIds.DataType,\n      AttributeIds.ValueRank,\n      AttributeIds.ArrayDimensions,\n      AttributeIds.AccessLevel,\n      AttributeIds.UserAccessLevel,\n    ].map((attributeId) => ({ nodeId: coerceNodeId(nodeId), attributeId }));\n    const [\n      dataTypeValue,\n      valueRankValue,\n      arrayDimensionsValue,\n      accessLevelValue,\n      userAccessLevelValue,\n    ] = yield* Effect.tryPromise({\n      try: () => session.read(nodes, 0),\n      catch: (cause) =>\n        serviceError({\n          operation: \"metadata.variable\",\n          nodeId,\n          cause,\n        }),\n    });\n    if (\n      !dataTypeValue ||\n      !isGood(dataTypeValue.statusCode) ||\n      !(dataTypeValue.value?.value instanceof NodeId)\n    ) {\n      return yield* Effect.fail(\n        configurationError({\n          operation: \"metadata.variable\",\n          nodeId,\n          cause: \"DataType is unreadable\",\n        }),\n      );\n    }\n    if (\n      !valueRankValue ||\n      !isGood(valueRankValue.statusCode) ||\n      typeof valueRankValue.value?.value !== \"number\"\n    ) {\n      return yield* Effect.fail(\n        configurationError({\n          operation: \"metadata.variable\",\n          nodeId,\n          cause: \"ValueRank is unreadable\",\n        }),\n      );\n    }\n    if (\n      !accessLevelValue ||\n      !isGood(accessLevelValue.statusCode) ||\n      typeof accessLevelValue.value?.value !== \"number\"\n    ) {\n      return yield* Effect.fail(\n        configurationError({\n          operation: \"metadata.variable\",\n          nodeId,\n          cause: \"AccessLevel is unreadable\",\n        }),\n      );\n    }\n    const dataTypeNodeId = dataTypeValue.value.value as NodeId;\n    const builtIn = yield* builtInDataType(dataTypeNodeId);\n    const userAccessLevel =\n      userAccessLevelValue &&\n      isGood(userAccessLevelValue.statusCode) &&\n      typeof userAccessLevelValue.value?.value === \"number\"\n        ? (userAccessLevelValue.value.value as number)\n        : undefined;\n\n    return variableMetadataFromRaw({\n      nodeId,\n      dataTypeNodeId,\n      builtInDataType: builtIn,\n      valueRank: valueRankValue.value.value as number,\n      arrayDimensions:\n        arrayDimensionsValue &&\n        isGood(arrayDimensionsValue.statusCode) &&\n        Array.isArray(arrayDimensionsValue.value?.value)\n          ? arrayDimensionsValue.value.value\n          : undefined,\n      accessLevel: accessLevelValue.value.value as number,\n      userAccessLevel,\n    });\n  });\n\nconst discoverMethodBaseMetadata = (\n  session: ClientSession,\n  def: AnyMethodDef,\n  builtInDataType: MetadataService[\"builtInDataType\"],\n) =>\n  Effect.gen(function* () {\n    const methodId = yield* coerceNodeIdOrFail(\n      \"metadata.method.methodId\",\n      def.methodId,\n    );\n    const argumentDefinition = yield* Effect.tryPromise({\n      try: () => session.getArgumentDefinition(methodId),\n      catch: (cause) =>\n        serviceError({\n          operation: \"metadata.method.getArgumentDefinition\",\n          nodeId: def.methodId,\n          cause,\n        }),\n    });\n    const [executable, userExecutable] = yield* readExecutableAttributes(\n      session,\n      def,\n      methodId,\n    );\n    const inputArguments = yield* normalizeArguments(\n      def.methodId,\n      argumentDefinition.inputArguments ?? [],\n      builtInDataType,\n    );\n    const outputArguments = yield* normalizeArguments(\n      def.methodId,\n      argumentDefinition.outputArguments ?? [],\n      builtInDataType,\n    );\n    return {\n      objectId: def.objectId,\n      methodId: def.methodId,\n      executable,\n      userExecutable,\n      inputArguments,\n      outputArguments,\n    };\n  });\n\nconst readExecutableAttributes = (\n  session: ClientSession,\n  def: AnyMethodDef,\n  methodId: NodeId,\n) =>\n  Effect.gen(function* () {\n    const [executableValue, userExecutableValue] = yield* Effect.tryPromise({\n      try: () =>\n        session.read(\n          [\n            { nodeId: methodId, attributeId: AttributeIds.Executable },\n            { nodeId: methodId, attributeId: AttributeIds.UserExecutable },\n          ],\n          0,\n        ),\n      catch: (cause) =>\n        serviceError({\n          operation: \"metadata.method.executable\",\n          nodeId: def.methodId,\n          cause,\n        }),\n    });\n    const executable = readBooleanAttribute(\n      executableValue,\n      \"metadata.method.executable\",\n      def.methodId,\n      true,\n    );\n    const userExecutable = readBooleanAttribute(\n      userExecutableValue,\n      \"metadata.method.userExecutable\",\n      def.methodId,\n      false,\n    );\n    if (isConfigurationError(executable)) {\n      return yield* Effect.fail(executable);\n    }\n    if (isConfigurationError(userExecutable)) {\n      return yield* Effect.fail(userExecutable);\n    }\n    return [executable as boolean, userExecutable] as const;\n  });\n\nconst normalizeArguments = (\n  methodNodeId: NodeIdString,\n  arguments_: ReadonlyArray<import(\"node-opcua\").Argument>,\n  builtInDataType: MetadataService[\"builtInDataType\"],\n) =>\n  Effect.forEach(arguments_, (argument) =>\n    Effect.gen(function* () {\n      const dataTypeNodeId =\n        argument.dataType instanceof NodeId\n          ? argument.dataType\n          : yield* coerceNodeIdOrFail(\n              \"metadata.method.argument.dataType\",\n              String(argument.dataType),\n            );\n      const builtIn = yield* builtInDataType(dataTypeNodeId);\n      return methodArgumentMetadataFromRaw(argument, dataTypeNodeId, builtIn);\n    }),\n  ).pipe(\n    Effect.mapError((error) =>\n      isConfigurationError(error)\n        ? configurationError({\n            operation: \"metadata.method.argument\",\n            nodeId: methodNodeId,\n            cause: error.reason.cause,\n          })\n        : error,\n    ),\n  );\n\nconst resolveBuiltInDataType = (\n  session: ClientSession,\n  dataTypeNodeId: NodeId,\n): Effect.Effect<DataType, OpcuaConfigurationError | OpcuaServiceError> =>\n  Effect.gen(function* () {\n    let current = dataTypeNodeId;\n    const visited = new Set<string>();\n    while (true) {\n      const builtIn = builtInDataTypeFromNodeId(current);\n      if (builtIn !== undefined) return builtIn;\n\n      const key = current.toString();\n      if (visited.has(key)) {\n        return yield* Effect.fail(\n          configurationError({\n            operation: \"metadata.builtInDataType\",\n            nodeId: dataTypeNodeId.toString(),\n            cause: `DataType hierarchy contains a cycle at ${key}`,\n          }),\n        );\n      }\n      visited.add(key);\n\n      const superType = yield* browseDataTypeSuperType(session, current);\n      if (!superType) {\n        return yield* Effect.fail(\n          configurationError({\n            operation: \"metadata.builtInDataType\",\n            nodeId: dataTypeNodeId.toString(),\n            cause: `Could not resolve built-in DataType for ${dataTypeNodeId.toString()}`,\n          }),\n        );\n      }\n      current = superType;\n    }\n  });\n\nconst builtInDataTypeFromNodeId = (nodeId: NodeId): DataType | undefined => {\n  if (\n    nodeId.identifierType === NodeIdType.NUMERIC &&\n    nodeId.namespace === 0 &&\n    nodeId.value === DataTypeIds.Enumeration\n  ) {\n    return DataType.Int32;\n  }\n  if (\n    nodeId.identifierType === NodeIdType.NUMERIC &&\n    nodeId.namespace === 0 &&\n    typeof nodeId.value === \"number\" &&\n    nodeId.value <= DataType.DiagnosticInfo &&\n    DataType[nodeId.value] !== undefined\n  ) {\n    return nodeId.value as DataType;\n  }\n  return undefined;\n};\n\nconst browseDataTypeSuperType = (\n  session: ClientSession,\n  dataTypeNodeId: NodeId,\n) =>\n  Effect.tryPromise({\n    try: async () => {\n      const browse: BrowseDescriptionOptions = {\n        browseDirection: BrowseDirection.Inverse,\n        includeSubtypes: false,\n        nodeId: dataTypeNodeId,\n        referenceTypeId: coerceNodeId(ReferenceTypeIds.HasSubtype),\n        resultMask: 1,\n      };\n      const result = await session.browse(browse);\n      if (!isGood(result.statusCode)) {\n        throw new Error(result.statusCode.toString());\n      }\n      const nodeId = result.references?.[0]?.nodeId;\n      return nodeId ? coerceNodeId(nodeId) : undefined;\n    },\n    catch: (cause) =>\n      serviceError({\n        operation: \"metadata.browseDataTypeSuperType\",\n        nodeId: dataTypeNodeId.toString(),\n        cause,\n      }),\n  });\n\nconst coerceNodeIdOrFail = (operation: string, nodeId: unknown) =>\n  Effect.try({\n    try: () => coerceNodeId(nodeId),\n    catch: (cause) =>\n      configurationError({ operation, nodeId: String(nodeId), cause }),\n  });\n"],"mappings":"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"}

package/dist/internal/metadata/variables.d.mts

@@ -0,0 +1,3 @@
+import { OpcuaAccessBits, OpcuaMetadataAttribute, OpcuaMetadataReadFailure, OpcuaNodeMetadata, OpcuaNodeMetadataResult } from "../../OpcuaSession.mjs";
+import { MetadataService, makeMetadataService } from "./service.mjs";
+export { type MetadataService, type OpcuaAccessBits, type OpcuaMetadataAttribute, type OpcuaMetadataReadFailure, type OpcuaNodeMetadata, type OpcuaNodeMetadataResult, makeMetadataService };

package/dist/internal/metadata/variables.mjs

@@ -0,0 +1,3 @@
+import { makeMetadataService } from "./service.mjs";
+
+export { makeMetadataService };

package/dist/internal/method/arguments.d.mts

@@ -0,0 +1,48 @@
+import { NodeIdString, OpcuaStatusInfo } from "../../OpcuaVariable.mjs";
+import "../common/node-id.mjs";
+import { OpcuaStructureRuntime } from "../structures/runtime.mjs";
+import { OpcuaConfigurationError, OpcuaMethodInputError, OpcuaServiceError } from "../../OpcuaError.mjs";
+import { AnyMethodDef, InputOfMethodDef, MethodArgRecord, MethodArgumentMapping, MethodArgumentMetadata, MethodCallOptions, MethodMetadata, ResolvedMethod } from "../../OpcuaMethod.mjs";
+import "../batch/operations.mjs";
+import { Argument, CallMethodRequestLike, CallMethodResult, DataType, DataValue, NodeId } from "node-opcua";
+import { Effect } from "effect";
+
+//#region src/internal/method/arguments.d.ts
+type MethodPreflight = {
+  readonly request: CallMethodRequestLike;
+  readonly includeRaw: boolean;
+};
+type MethodInfo = {
+  readonly objectId: NodeIdString;
+  readonly methodId: NodeIdString;
+  readonly metadata: MethodMetadata;
+};
+declare const methodCallOptionsError: (operation: string, objectId: NodeIdString, methodId: NodeIdString, options: MethodCallOptions | undefined) => OpcuaConfigurationError | undefined;
+declare const resolveMethodMapping: (operation: string, nodeId: NodeIdString, arguments_: ReadonlyArray<MethodArgumentMetadata>, fields: MethodArgRecord | undefined) => Effect.Effect<ReadonlyArray<MethodArgumentMapping>, OpcuaConfigurationError>;
+declare const methodArgumentMetadataFromRaw: (argument: Argument, dataTypeNodeId: NodeId, builtInDataType: DataType) => MethodArgumentMetadata;
+declare const readBooleanAttribute: (dataValue: DataValue | undefined, operation: string, nodeId: NodeIdString, required: boolean) => boolean | OpcuaConfigurationError | undefined;
+declare const preflightMethodCall: <const Spec extends AnyMethodDef>(method: ResolvedMethod<Spec>, input: InputOfMethodDef<Spec>, structureRuntime: OpcuaStructureRuntime, options?: MethodCallOptions) => Effect.Effect<MethodPreflight, OpcuaConfigurationError | OpcuaMethodInputError | OpcuaServiceError>;
+declare const outputObjectFromResult: (method: MethodInfo, result: CallMethodResult, structureRuntime: OpcuaStructureRuntime) => Effect.Effect<Record<string, unknown>, {
+  argumentName: string;
+  argumentIndex: number;
+  error: unknown;
+}, never>;
+declare const normalizeInputArgumentResults: (method: MethodInfo, result: CallMethodResult) => {
+  key: string;
+  index: number;
+  argumentName: string;
+  status: OpcuaStatusInfo;
+  diagnosticInfo: unknown;
+}[] | undefined;
+declare const argumentCodecMetadata: (nodeId: NodeIdString, metadata: MethodArgumentMetadata) => {
+  nodeId: string;
+  valueRank: number;
+  arrayDimensions: readonly number[] | undefined;
+  raw: {
+    declaredDataType: NodeId;
+    builtInDataType: DataType;
+  };
+};
+//#endregion
+export { MethodInfo, MethodPreflight, argumentCodecMetadata, methodArgumentMetadataFromRaw, methodCallOptionsError, normalizeInputArgumentResults, outputObjectFromResult, preflightMethodCall, readBooleanAttribute, resolveMethodMapping };
+//# sourceMappingURL=arguments.d.mts.map

package/dist/internal/method/arguments.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arguments.d.mts","names":[],"sources":["../../../src/internal/method/arguments.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;KAyCY,eAAA;oBACQ;;AADpB,CAAA;AAKY,KAAA,UAAA,GAAU;EACD,SAAA,QAAA,EAAA,YAAA;EACA,SAAA,QAAA,EAAA,YAAA;EACA,SAAA,QAAA,EAAA,cAAA;CAAc;AAGtB,cAAA,sBAqCZ,EAAA,CAAA,SAAA,EAAA,MAAA,EAAA,QAAA,EAnCW,YAmCX,EAAA,QAAA,EAlCW,YAkCX,EAAA,OAAA,EAjCU,iBAiCV,GAAA,SAAA,EAAA,GAjCuC,uBAiCvC,GAAA,SAAA;AAnCW,cAqCC,oBArCD,EAAA,CAAA,SAAA,EAAA,MAAA,EAAA,MAAA,EAuCF,YAvCE,EAAA,UAAA,EAwCE,aAxCF,CAwCgB,sBAxChB,CAAA,EAAA,MAAA,EAyCF,eAzCE,GAAA,SAAA,EAAA,GA0CT,MAAA,CAAO,MA1CE,CA2CV,aA3CU,CA2CI,qBA3CJ,CAAA,EA4CV,uBA5CU,CAAA;AACA,cA4EC,6BA5ED,EAAA,CAAA,QAAA,EA6EA,QA7EA,EAAA,cAAA,EA8EM,MA9EN,EAAA,eAAA,EA+EO,QA/EP,EAAA,GAgFT,sBAhFS;AACD,cA+FE,oBA/FF,EAAA,CAAA,SAAA,EAgGE,SAhGF,GAAA,SAAA,EAAA,SAAA,EAAA,MAAA,EAAA,MAAA,EAkGD,YAlGC,EAAA,QAAA,EAAA,OAAA,EAAA,GAAA,OAAA,GAmGQ,uBAnGR,GAAA,SAAA;AAA6B,cAoH3B,mBApH2B,EAAA,CAAA,mBAoHe,YApHf,CAAA,CAAA,MAAA,EAqH9B,cArH8B,CAqHf,IArHe,CAAA,EAAA,KAAA,EAsH/B,gBAtH+B,CAsHd,IAtHc,CAAA,EAAA,gBAAA,EAuHpB,qBAvHoB,EAAA,OAAA,CAAA,EAwH5B,iBAxH4B,EAAA,GAyHrC,MAAA,CAAO,MAzH8B,CA0HtC,eA1HsC,EA2HtC,uBA3HsC,GA2HZ,qBA3HY,GA2HY,iBA3HZ,CAAA;AAAA,cAiM3B,sBAjM2B,EAAA,CAAA,MAAA,EAkM9B,UAlM8B,EAAA,MAAA,EAmM9B,gBAnM8B,EAAA,gBAAA,EAoMpB,qBApMoB,EAAA,GAoMC,MAAA,CAAA,MApMD,CAoMC,MApMD,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA;EAmC3B,YAAA,EAAA,MAAA;EAEH,aAAA,EAAA,MAAA;EACkB,KAAA,EAAA,OAAA;CAAd,EAAA,KAAA,CAAA;AACJ,cAqLG,6BArLH,EAAA,CAAA,MAAA,EAsLA,UAtLA,EAAA,MAAA,EAuLA,gBAvLA,EAAA,GAAA;EAEM,GAAA,EAAA,MAAA;EAAd,KAAA,EAAA,MAAA;EACA,YAAA,EAAA,MAAA;EAFC,MAAO,EAsLgB,eAtLhB;EAAM,cAAA,EAAA,OAAA;AAmChB,CAAA,EAAA,GAAa,SAAA;AACD,cA0KC,qBA1KD,EAAA,CAAA,MAAA,EA2KF,YA3KE,EAAA,QAAA,EA4KA,sBA5KA,EAAA,GAAA;EACM,MAAA,EAAA,MAAA;EACC,SAAA,EAAA,MAAA;EAChB,eAAA,EAAA,SAAA,MAAA,EAAA,GAAA,SAAA;EAcD,GAAA,EAAA;IAEW,gBAAA,QAmBZ;IAlBY,eAAA,UAAA;EAEH,CAAA;CACS"}

package/dist/internal/method/arguments.mjs

@@ -0,0 +1,216 @@
+import { isPlainRecord, isRecord } from "../common/predicates.mjs";
+import { isGood, normalizeLocalizedText, normalizeNodeId, normalizeStatusCode } from "../values/normalize.mjs";
+import { configurationError, isConfigurationError, methodInputError } from "../../OpcuaError.mjs";
+import { Codec } from "../values/codec.mjs";
+import { DataType } from "node-opcua";
+import { Effect } from "effect";
+
+//#region src/internal/method/arguments.ts
+const methodCallOptionsError = (operation, objectId, methodId, options) => {
+	if (options === void 0) return void 0;
+	if (!isPlainRecord(options)) return configurationError({
+		operation,
+		objectId,
+		methodId,
+		cause: "options must be an object"
+	});
+	const unknown = Object.keys(options).filter((key) => key !== "includeRaw");
+	if (unknown.length > 0) return configurationError({
+		operation,
+		objectId,
+		methodId,
+		cause: `unsupported option: ${unknown.join(", ")}`
+	});
+	if ("includeRaw" in options && options.includeRaw !== void 0 && typeof options.includeRaw !== "boolean") return configurationError({
+		operation,
+		objectId,
+		methodId,
+		cause: "includeRaw must be a boolean"
+	});
+};
+const resolveMethodMapping = (operation, nodeId, arguments_, fields) => Effect.gen(function* () {
+	const mapping = fields ? explicitMapping(operation, nodeId, arguments_, fields) : emptyMapping(operation, nodeId, arguments_);
+	if (isConfigurationError(mapping)) return yield* Effect.fail(configurationError({
+		operation,
+		nodeId,
+		cause: mapping.reason.cause
+	}));
+	for (const entry of mapping) {
+		const argument = arguments_[entry.index];
+		yield* Codec.validateMetadata(entry.arg.codec, argumentCodecMetadata(nodeId, argument)).pipe(Effect.mapError((cause) => configurationError({
+			operation,
+			nodeId,
+			cause: {
+				argumentName: argument.name,
+				argumentIndex: entry.index,
+				cause
+			}
+		})));
+	}
+	return mapping;
+});
+const methodArgumentMetadataFromRaw = (argument, dataTypeNodeId, builtInDataType) => ({
+	name: argument.name ?? "",
+	description: argument.description ? normalizeLocalizedText(argument.description) : void 0,
+	declaredDataType: normalizeNodeId(dataTypeNodeId),
+	builtInDataType: DataType[builtInDataType] ?? String(builtInDataType),
+	valueRank: argument.valueRank ?? -1,
+	arrayDimensions: argument.arrayDimensions ?? void 0,
+	unsafeRaw: {
+		argument,
+		declaredDataType: dataTypeNodeId,
+		builtInDataType
+	}
+});
+const readBooleanAttribute = (dataValue, operation, nodeId, required) => {
+	if (dataValue && isGood(dataValue.statusCode) && typeof dataValue.value?.value === "boolean") return dataValue.value.value;
+	if (!required) return void 0;
+	return configurationError({
+		operation,
+		nodeId,
+		cause: "method boolean attribute is unreadable"
+	});
+};
+const preflightMethodCall = (method, input, structureRuntime, options) => Effect.gen(function* () {
+	const optionsError = methodCallOptionsError("method.call.options", method.objectId, method.methodId, options);
+	if (optionsError) return yield* Effect.fail(optionsError);
+	if (method.metadata.inputMapping.some((mapping) => Codec.requiresStructureRuntime(mapping.arg.codec)) || method.metadata.outputMapping.some((mapping) => Codec.requiresStructureRuntime(mapping.arg.codec))) yield* structureRuntime.ensureInitialized();
+	const inputRecord = objectRecord(input);
+	if (!inputRecord) return yield* Effect.fail(methodInputError({
+		objectId: method.objectId,
+		methodId: method.methodId,
+		input,
+		phase: "ArgumentMapping",
+		cause: "input must be an object"
+	}));
+	const keyError = validateInputKeys(method, inputRecord, input);
+	if (keyError) return yield* Effect.fail(keyError);
+	const inputArguments = [];
+	for (const mapping of method.metadata.inputMapping) {
+		const argument = method.metadata.inputArguments[mapping.index];
+		const rawValue = inputRecord[mapping.key];
+		const variant = yield* Codec.encode(mapping.arg.codec, rawValue, argumentCodecMetadata(method.methodId, argument), structureRuntime).pipe(Effect.mapError((error) => methodInputError({
+			objectId: method.objectId,
+			methodId: method.methodId,
+			input,
+			phase: "Encoding",
+			argumentKey: mapping.key,
+			argumentIndex: mapping.index,
+			error
+		})));
+		inputArguments[mapping.index] = variant;
+	}
+	return {
+		request: {
+			objectId: method.unsafeRaw.objectId,
+			methodId: method.unsafeRaw.methodId,
+			inputArguments
+		},
+		includeRaw: options?.includeRaw ?? method.def.includeRaw ?? false
+	};
+});
+const outputObjectFromResult = (method, result, structureRuntime) => Effect.gen(function* () {
+	const output = {};
+	const outputArguments = result.outputArguments ?? [];
+	for (const mapping of method.metadata.outputMapping) {
+		const argument = method.metadata.outputArguments[mapping.index];
+		const variant = outputArguments[mapping.index];
+		output[mapping.key] = yield* Codec.decode(mapping.arg.codec, variant, void 0, structureRuntime).pipe(Effect.mapError((error) => ({
+			argumentName: argument.name,
+			argumentIndex: mapping.index,
+			error
+		})));
+	}
+	return output;
+});
+const normalizeInputArgumentResults = (method, result) => {
+	const statuses = result.inputArgumentResults;
+	if (!statuses || statuses.length === 0) return void 0;
+	const diagnostics = result.inputArgumentDiagnosticInfos;
+	return statuses.map((statusCode, index) => {
+		const mapping = method.metadata.inputMapping.find((candidate) => candidate.index === index);
+		return {
+			key: mapping?.key ?? String(index),
+			index,
+			argumentName: mapping?.argumentName ?? method.metadata.inputArguments[index]?.name ?? "",
+			status: normalizeStatusCode(statusCode),
+			diagnosticInfo: diagnostics?.[index]
+		};
+	});
+};
+const argumentCodecMetadata = (nodeId, metadata) => ({
+	nodeId,
+	valueRank: metadata.valueRank,
+	arrayDimensions: metadata.arrayDimensions,
+	raw: {
+		declaredDataType: metadata.unsafeRaw.declaredDataType,
+		builtInDataType: metadata.unsafeRaw.builtInDataType
+	}
+});
+const emptyMapping = (operation, nodeId, arguments_) => arguments_.length === 0 ? [] : configurationError({
+	operation,
+	nodeId,
+	cause: "Method arguments must be declared explicitly in v1"
+});
+const explicitMapping = (_operation, _nodeId, arguments_, fields) => {
+	const usedIndexes = /* @__PURE__ */ new Set();
+	const mapping = [];
+	for (const [key, arg] of Object.entries(fields)) {
+		const selector = arg.selector ?? {
+			_tag: "Name",
+			name: key
+		};
+		const matches = selector._tag === "Index" ? [selector.index] : arguments_.map((argument, index$1) => argument.name === selector.name ? index$1 : void 0).filter((index$1) => index$1 !== void 0);
+		const index = matches[0] ?? -1;
+		if (!Number.isInteger(index) || index < 0 || index >= arguments_.length) return configurationError({
+			operation: "method.argumentMap",
+			cause: `Argument selector for ${key} did not resolve`
+		});
+		if (matches.length !== 1) return configurationError({
+			operation: "method.argumentMap",
+			cause: `Argument selector for ${key} did not resolve exactly once`
+		});
+		if (usedIndexes.has(index)) return configurationError({
+			operation: "method.argumentMap",
+			cause: "Two public keys target the same argument"
+		});
+		usedIndexes.add(index);
+		mapping.push({
+			key,
+			index,
+			argumentName: arguments_[index].name,
+			arg
+		});
+	}
+	if (usedIndexes.size !== arguments_.length) return configurationError({
+		operation: "method.argumentMap",
+		cause: "Method arguments must cover every OPC UA argument"
+	});
+	return mapping;
+};
+const validateInputKeys = (method, inputRecord, input) => {
+	const expected = new Set(method.metadata.inputMapping.map((mapping) => mapping.key));
+	for (const key of expected) if (!(key in inputRecord)) {
+		const mapping = method.metadata.inputMapping.find((m) => m.key === key);
+		return methodInputError({
+			objectId: method.objectId,
+			methodId: method.methodId,
+			input,
+			phase: "MissingInputKey",
+			argumentKey: key,
+			argumentIndex: mapping?.index
+		});
+	}
+	for (const key of Object.keys(inputRecord)) if (!expected.has(key)) return methodInputError({
+		objectId: method.objectId,
+		methodId: method.methodId,
+		input,
+		phase: "UnknownInputKey",
+		argumentKey: key
+	});
+};
+const objectRecord = (value) => isRecord(value) ? value : void 0;
+
+//#endregion
+export { argumentCodecMetadata, methodArgumentMetadataFromRaw, methodCallOptionsError, normalizeInputArgumentResults, outputObjectFromResult, preflightMethodCall, readBooleanAttribute, resolveMethodMapping };
+//# sourceMappingURL=arguments.mjs.map

package/dist/internal/method/arguments.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"arguments.mjs","names":["inputArguments: Array<Variant>","output: Record<string, unknown>","mapping: Array<MethodArgumentMapping>","index"],"sources":["../../../src/internal/method/arguments.ts"],"sourcesContent":["import {\n  DataType,\n  type Argument,\n  type CallMethodRequestLike,\n  type CallMethodResult,\n  type DataValue,\n  type NodeId,\n  type StatusCode,\n  type Variant,\n} from \"node-opcua\";\nimport { Effect } from \"effect\";\n\nimport {\n  configurationError,\n  isConfigurationError,\n  methodInputError,\n  type OpcuaConfigurationError,\n  type OpcuaMethodInputError,\n  type OpcuaServiceError,\n} from \"../../OpcuaError.js\";\nimport type { NodeIdString } from \"../common/node-id.js\";\nimport { isPlainRecord, isRecord } from \"../common/predicates.js\";\nimport { Codec } from \"../values/codec.js\";\nimport {\n  isGood,\n  normalizeLocalizedText,\n  normalizeNodeId,\n  normalizeStatusCode,\n} from \"../values/normalize.js\";\nimport type { OpcuaStructureRuntime } from \"../structures/runtime.js\";\nimport type { MethodCallOptions } from \"../batch/operations.js\";\nimport type {\n  AnyMethodDef,\n  InputOfMethodDef,\n  MethodArgRecord,\n  MethodArgumentMapping,\n  MethodArgumentMetadata,\n  MethodMetadata,\n  ResolvedMethod,\n} from \"../../OpcuaMethod.js\";\n\nexport type MethodPreflight = {\n  readonly request: CallMethodRequestLike;\n  readonly includeRaw: boolean;\n};\n\nexport type MethodInfo = {\n  readonly objectId: NodeIdString;\n  readonly methodId: NodeIdString;\n  readonly metadata: MethodMetadata;\n};\n\nexport const methodCallOptionsError = (\n  operation: string,\n  objectId: NodeIdString,\n  methodId: NodeIdString,\n  options: MethodCallOptions | undefined,\n) => {\n  if (options === undefined) return undefined;\n  if (!isPlainRecord(options)) {\n    return configurationError({\n      operation,\n      objectId,\n      methodId,\n      cause: \"options must be an object\",\n    });\n  }\n  const unknown = Object.keys(options).filter((key) => key !== \"includeRaw\");\n  if (unknown.length > 0) {\n    return configurationError({\n      operation,\n      objectId,\n      methodId,\n      cause: `unsupported option: ${unknown.join(\", \")}`,\n    });\n  }\n  if (\n    \"includeRaw\" in options &&\n    options.includeRaw !== undefined &&\n    typeof options.includeRaw !== \"boolean\"\n  ) {\n    return configurationError({\n      operation,\n      objectId,\n      methodId,\n      cause: \"includeRaw must be a boolean\",\n    });\n  }\n  return undefined;\n};\n\nexport const resolveMethodMapping = (\n  operation: string,\n  nodeId: NodeIdString,\n  arguments_: ReadonlyArray<MethodArgumentMetadata>,\n  fields: MethodArgRecord | undefined,\n): Effect.Effect<\n  ReadonlyArray<MethodArgumentMapping>,\n  OpcuaConfigurationError\n> =>\n  Effect.gen(function* () {\n    const mapping = fields\n      ? explicitMapping(operation, nodeId, arguments_, fields)\n      : emptyMapping(operation, nodeId, arguments_);\n    if (isConfigurationError(mapping)) {\n      return yield* Effect.fail(\n        configurationError({ operation, nodeId, cause: mapping.reason.cause }),\n      );\n    }\n    for (const entry of mapping) {\n      const argument = arguments_[entry.index]!;\n      yield* Codec.validateMetadata(\n        entry.arg.codec,\n        argumentCodecMetadata(nodeId, argument),\n      ).pipe(\n        Effect.mapError((cause) =>\n          configurationError({\n            operation,\n            nodeId,\n            cause: {\n              argumentName: argument.name,\n              argumentIndex: entry.index,\n              cause,\n            },\n          }),\n        ),\n      );\n    }\n    return mapping;\n  });\n\nexport const methodArgumentMetadataFromRaw = (\n  argument: Argument,\n  dataTypeNodeId: NodeId,\n  builtInDataType: DataType,\n): MethodArgumentMetadata => ({\n  name: argument.name ?? \"\",\n  description: argument.description\n    ? normalizeLocalizedText(argument.description)\n    : undefined,\n  declaredDataType: normalizeNodeId(dataTypeNodeId),\n  builtInDataType: DataType[builtInDataType] ?? String(builtInDataType),\n  valueRank: argument.valueRank ?? -1,\n  arrayDimensions: argument.arrayDimensions ?? undefined,\n  unsafeRaw: {\n    argument,\n    declaredDataType: dataTypeNodeId,\n    builtInDataType,\n  },\n});\n\nexport const readBooleanAttribute = (\n  dataValue: DataValue | undefined,\n  operation: string,\n  nodeId: NodeIdString,\n  required: boolean,\n) => {\n  if (\n    dataValue &&\n    isGood(dataValue.statusCode) &&\n    typeof dataValue.value?.value === \"boolean\"\n  ) {\n    return dataValue.value.value as boolean;\n  }\n  if (!required) return undefined;\n  return configurationError({\n    operation,\n    nodeId,\n    cause: \"method boolean attribute is unreadable\",\n  });\n};\n\nexport const preflightMethodCall = <const Spec extends AnyMethodDef>(\n  method: ResolvedMethod<Spec>,\n  input: InputOfMethodDef<Spec>,\n  structureRuntime: OpcuaStructureRuntime,\n  options?: MethodCallOptions,\n): Effect.Effect<\n  MethodPreflight,\n  OpcuaConfigurationError | OpcuaMethodInputError | OpcuaServiceError\n> =>\n  Effect.gen(function* () {\n    const optionsError = methodCallOptionsError(\n      \"method.call.options\",\n      method.objectId,\n      method.methodId,\n      options,\n    );\n    if (optionsError) return yield* Effect.fail(optionsError);\n    if (\n      method.metadata.inputMapping.some((mapping) =>\n        Codec.requiresStructureRuntime(mapping.arg.codec),\n      ) ||\n      method.metadata.outputMapping.some((mapping) =>\n        Codec.requiresStructureRuntime(mapping.arg.codec),\n      )\n    ) {\n      yield* structureRuntime.ensureInitialized();\n    }\n    const inputRecord = objectRecord(input);\n    if (!inputRecord) {\n      return yield* Effect.fail(\n        methodInputError({\n          objectId: method.objectId,\n          methodId: method.methodId,\n          input,\n          phase: \"ArgumentMapping\",\n          cause: \"input must be an object\",\n        }),\n      );\n    }\n    const keyError = validateInputKeys(method, inputRecord, input);\n    if (keyError) return yield* Effect.fail(keyError);\n\n    const inputArguments: Array<Variant> = [];\n    for (const mapping of method.metadata.inputMapping) {\n      const argument = method.metadata.inputArguments[mapping.index]!;\n      const rawValue = inputRecord[mapping.key];\n      const variant = yield* Codec.encode(\n        mapping.arg.codec,\n        rawValue,\n        argumentCodecMetadata(method.methodId, argument),\n        structureRuntime,\n      ).pipe(\n        Effect.mapError((error) =>\n          methodInputError({\n            objectId: method.objectId,\n            methodId: method.methodId,\n            input,\n            phase: \"Encoding\",\n            argumentKey: mapping.key,\n            argumentIndex: mapping.index,\n            error,\n          }),\n        ),\n      );\n      inputArguments[mapping.index] = variant;\n    }\n\n    return {\n      request: {\n        objectId: method.unsafeRaw.objectId,\n        methodId: method.unsafeRaw.methodId,\n        inputArguments,\n      },\n      includeRaw: options?.includeRaw ?? method.def.includeRaw ?? false,\n    };\n  });\n\nexport const outputObjectFromResult = (\n  method: MethodInfo,\n  result: CallMethodResult,\n  structureRuntime: OpcuaStructureRuntime,\n) =>\n  Effect.gen(function* () {\n    const output: Record<string, unknown> = {};\n    const outputArguments = result.outputArguments ?? [];\n    for (const mapping of method.metadata.outputMapping) {\n      const argument = method.metadata.outputArguments[mapping.index]!;\n      const variant = outputArguments[mapping.index];\n      output[mapping.key] = yield* Codec.decode(\n        mapping.arg.codec,\n        variant,\n        undefined,\n        structureRuntime,\n      ).pipe(\n        Effect.mapError((error) => ({\n          argumentName: argument.name,\n          argumentIndex: mapping.index,\n          error,\n        })),\n      );\n    }\n    return output;\n  });\n\nexport const normalizeInputArgumentResults = (\n  method: MethodInfo,\n  result: CallMethodResult,\n) => {\n  const statuses = result.inputArgumentResults;\n  if (!statuses || statuses.length === 0) return undefined;\n  const diagnostics = (\n    result as { readonly inputArgumentDiagnosticInfos?: ReadonlyArray<unknown> }\n  ).inputArgumentDiagnosticInfos;\n  return statuses.map((statusCode: StatusCode, index: number) => {\n    const mapping = method.metadata.inputMapping.find(\n      (candidate) => candidate.index === index,\n    );\n    return {\n      key: mapping?.key ?? String(index),\n      index,\n      argumentName:\n        mapping?.argumentName ??\n        method.metadata.inputArguments[index]?.name ??\n        \"\",\n      status: normalizeStatusCode(statusCode),\n      diagnosticInfo: diagnostics?.[index],\n    };\n  });\n};\n\nexport const argumentCodecMetadata = (\n  nodeId: NodeIdString,\n  metadata: MethodArgumentMetadata,\n) => ({\n  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 emptyMapping = (\n  operation: string,\n  nodeId: NodeIdString,\n  arguments_: ReadonlyArray<MethodArgumentMetadata>,\n) =>\n  arguments_.length === 0\n    ? []\n    : configurationError({\n        operation,\n        nodeId,\n        cause: \"Method arguments must be declared explicitly in v1\",\n      });\n\nconst explicitMapping = (\n  _operation: string,\n  _nodeId: NodeIdString,\n  arguments_: ReadonlyArray<MethodArgumentMetadata>,\n  fields: MethodArgRecord,\n) => {\n  const usedIndexes = new Set<number>();\n  const mapping: Array<MethodArgumentMapping> = [];\n  for (const [key, arg] of Object.entries(fields)) {\n    const selector = arg.selector ?? { _tag: \"Name\" as const, name: key };\n    const matches =\n      selector._tag === \"Index\"\n        ? [selector.index]\n        : arguments_\n            .map((argument, index) =>\n              argument.name === selector.name ? index : undefined,\n            )\n            .filter((index): index is number => index !== undefined);\n    const index = matches[0] ?? -1;\n    if (!Number.isInteger(index) || index < 0 || index >= arguments_.length) {\n      return configurationError({\n        operation: \"method.argumentMap\",\n        cause: `Argument selector for ${key} did not resolve`,\n      });\n    }\n    if (matches.length !== 1) {\n      return configurationError({\n        operation: \"method.argumentMap\",\n        cause: `Argument selector for ${key} did not resolve exactly once`,\n      });\n    }\n    if (usedIndexes.has(index)) {\n      return configurationError({\n        operation: \"method.argumentMap\",\n        cause: \"Two public keys target the same argument\",\n      });\n    }\n    usedIndexes.add(index);\n    mapping.push({\n      key,\n      index,\n      argumentName: arguments_[index]!.name,\n      arg,\n    });\n  }\n  if (usedIndexes.size !== arguments_.length) {\n    return configurationError({\n      operation: \"method.argumentMap\",\n      cause: \"Method arguments must cover every OPC UA argument\",\n    });\n  }\n  return mapping;\n};\n\nconst validateInputKeys = (\n  method: MethodInfo,\n  inputRecord: Record<string, unknown>,\n  input: unknown,\n) => {\n  const expected = new Set(\n    method.metadata.inputMapping.map((mapping) => mapping.key),\n  );\n  for (const key of expected) {\n    if (!(key in inputRecord)) {\n      const mapping = method.metadata.inputMapping.find((m) => m.key === key);\n      return methodInputError({\n        objectId: method.objectId,\n        methodId: method.methodId,\n        input,\n        phase: \"MissingInputKey\",\n        argumentKey: key,\n        argumentIndex: mapping?.index,\n      });\n    }\n  }\n  for (const key of Object.keys(inputRecord)) {\n    if (!expected.has(key)) {\n      return methodInputError({\n        objectId: method.objectId,\n        methodId: method.methodId,\n        input,\n        phase: \"UnknownInputKey\",\n        argumentKey: key,\n      });\n    }\n  }\n  return undefined;\n};\n\nconst objectRecord = (value: unknown): Record<string, unknown> | undefined =>\n  isRecord(value) ? value : undefined;\n"],"mappings":"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"}

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

@@ -0,0 +1,19 @@
+import { OpcuaStructureRuntime } from "../structures/runtime.mjs";
+import { OpcuaConfigurationError, OpcuaMethodInputError, OpcuaMethodNotExecutableError, OpcuaServiceError } from "../../OpcuaError.mjs";
+import { AnyMethodDef, AnyResolvedMethod, InputOfMethodDef, MethodCallEntry, MethodCallOptions, MethodCallResult, MethodMetadata, OutputOfMethodDef, ResolvedMethod } from "../../OpcuaMethod.mjs";
+import { BatchOptions } from "../batch/chunk.mjs";
+import "../batch/operations.mjs";
+import { MethodPreflight } from "./arguments.mjs";
+import { CallMethodResult, ClientSession } from "node-opcua";
+import { Effect } from "effect";
+
+//#region src/internal/method/operations.d.ts
+declare const resolveMethod: <const Spec extends AnyMethodDef>(spec: Spec, metadata: MethodMetadata) => Effect.Effect<ResolvedMethod<Spec>, OpcuaConfigurationError | OpcuaMethodNotExecutableError, never>;
+declare const callResolvedMethod: <const Spec extends AnyMethodDef>(session: ClientSession, method: ResolvedMethod<Spec>, input: InputOfMethodDef<Spec>, structureRuntime: OpcuaStructureRuntime, options?: MethodCallOptions) => Effect.Effect<MethodCallResult<OutputOfMethodDef<Spec>, Spec["objectId"], Spec["methodId"]>, OpcuaServiceError | OpcuaConfigurationError | OpcuaMethodInputError, never>;
+declare const callMethods: (session: ClientSession, entries: ReadonlyArray<MethodCallEntry<AnyResolvedMethod>>, structureRuntime: OpcuaStructureRuntime, options?: BatchOptions) => Effect.Effect<MethodCallResult<{
+  readonly [x: string]: unknown;
+}, string, string>[], OpcuaServiceError | OpcuaConfigurationError | OpcuaMethodInputError, never>;
+declare const methodResultFromRaw: <const Spec extends AnyMethodDef>(method: ResolvedMethod<Spec>, preflight: MethodPreflight, result: CallMethodResult, structureRuntime: OpcuaStructureRuntime) => Effect.Effect<MethodCallResult<OutputOfMethodDef<Spec>, Spec["objectId"], Spec["methodId"]>>;
+//#endregion
+export { callMethods, callResolvedMethod, methodResultFromRaw, resolveMethod };
+//# sourceMappingURL=operations.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.mts","names":[],"sources":["../../../src/internal/method/operations.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;cAkCa,mCAAoC,oBACzC,gBACI,mBAAc,MAAA,CAAA,OAAA,eAAA,OAAA,uBAAA,GAAA;cAwCb,wCAAyC,uBAC3C,uBACD,eAAe,cAChB,iBAAiB,yBACN,iCACR,sBAAiB,MAAA,CAAA,OAAA,iBAAA,kBAAA,OAAA,kBAAA,mBAAA,iBAAA,GAAA,uBAAA,GAAA;cA0BhB,uBACF,wBACA,cAAc,gBAAgB,uCACrB,iCACR,iBAAY,MAAA,CAAA,OAAA;EA7EX,UAAA,CAAA,EAAA,MAwCT,CAAA,EAAA,OAAA;CAxC6C,EAAA,MAAA,EAAA,MAAA,CAAA,EAAA,EA6EzB,iBAAA,kDA7EyB,EAAA,KAAA,CAAA;AACzC,cAsHK,mBAtHL,EAAA,CAAA,mBAsH+C,YAtH/C,CAAA,CAAA,MAAA,EAuHE,cAvHF,CAuHiB,IAvHjB,CAAA,EAAA,SAAA,EAwHK,eAxHL,EAAA,MAAA,EAyHE,gBAzHF,EAAA,gBAAA,EA0HY,qBA1HZ,EAAA,GAwKA,MAAA,CAAO,MAxKP,CAyKJ,gBAzKI,CA0KF,iBA1KE,CA0KgB,IA1KhB,CAAA,EA2KF,IA3KE,CAAA,UAAA,CAAA,EA4KF,IA5KE,CAAA,UAAA,CAAA,CAAA,CAAA"}

package/dist/internal/method/operations.mjs

@@ -0,0 +1,111 @@
+import { normalizeStatusCode } from "../values/normalize.mjs";
+import { configurationError, methodNotExecutableError, serviceError } from "../../OpcuaError.mjs";
+import { runChunked } from "../batch/chunk.mjs";
+import { resultFromStatusAndDecode } from "../values/result.mjs";
+import { normalizeInputArgumentResults, outputObjectFromResult, preflightMethodCall } from "./arguments.mjs";
+import { coerceNodeId } from "node-opcua";
+import { Effect } from "effect";
+
+//#region src/internal/method/operations.ts
+const resolveMethod = (spec, metadata) => Effect.gen(function* () {
+	const objectId = yield* coerceNodeIdOrFail("method.objectId", spec.objectId);
+	const methodId = yield* coerceNodeIdOrFail("method.methodId", spec.methodId);
+	if (!metadata.executable || metadata.userExecutable === false) return yield* Effect.fail(methodNotExecutableError({
+		objectId: spec.objectId,
+		methodId: spec.methodId,
+		executable: metadata.executable,
+		userExecutable: metadata.userExecutable
+	}));
+	return {
+		_tag: "ResolvedMethod",
+		objectId: spec.objectId,
+		methodId: spec.methodId,
+		def: spec,
+		metadata,
+		unsafeRaw: {
+			objectId,
+			methodId,
+			inputArguments: metadata.inputArguments.map((argument) => argument.unsafeRaw.argument),
+			outputArguments: metadata.outputArguments.map((argument) => argument.unsafeRaw.argument)
+		}
+	};
+});
+const callResolvedMethod = (session, method, input, structureRuntime, options) => Effect.gen(function* () {
+	const preflight = yield* preflightMethodCall(method, input, structureRuntime, options);
+	return yield* methodResultFromRaw(method, preflight, yield* Effect.tryPromise({
+		try: () => session.call(preflight.request),
+		catch: (cause) => serviceError({
+			operation: "call",
+			nodeId: method.methodId,
+			cause
+		})
+	}), structureRuntime);
+});
+const callMethods = (session, entries, structureRuntime, options) => Effect.gen(function* () {
+	const preflights = yield* Effect.forEach(entries, (entry) => preflightMethodCall(entry.method, entry.input, structureRuntime, entry.options));
+	const rawResults = yield* runChunked(preflights, options, (chunk) => Effect.gen(function* () {
+		const results = yield* Effect.tryPromise({
+			try: () => session.call(chunk.map((preflight) => preflight.request)),
+			catch: (cause) => serviceError({
+				operation: "call",
+				cause
+			})
+		});
+		if (results.length !== chunk.length) return yield* Effect.fail(serviceError({
+			operation: "call",
+			cause: `Expected ${chunk.length} CallMethodResults, got ${results.length}`
+		}));
+		return results;
+	}));
+	return yield* Effect.forEach(entries, (entry, index) => methodResultFromRaw(entry.method, preflights[index], rawResults[index], structureRuntime));
+});
+const methodResultFromRaw = (method, preflight, result, structureRuntime) => Effect.gen(function* () {
+	const unsafeRaw = preflight.includeRaw ? {
+		request: preflight.request,
+		result
+	} : void 0;
+	const status = normalizeStatusCode(result.statusCode);
+	const inputArgumentResults = normalizeInputArgumentResults(method, result);
+	return yield* resultFromStatusAndDecode({
+		statusCode: result.statusCode,
+		status,
+		decode: outputObjectFromResult(method, result, structureRuntime),
+		nonGoodStatus: (status$1) => ({
+			_tag: "NonGoodStatus",
+			objectId: method.objectId,
+			methodId: method.methodId,
+			status: status$1,
+			inputArgumentResults,
+			unsafeRaw
+		}),
+		decodeError: (error, status$1) => ({
+			_tag: "DecodeError",
+			objectId: method.objectId,
+			methodId: method.methodId,
+			status: status$1,
+			error,
+			unsafeRaw
+		}),
+		value: (output) => ({
+			_tag: "Called",
+			objectId: method.objectId,
+			methodId: method.methodId,
+			output,
+			status,
+			inputArgumentResults,
+			unsafeRaw
+		})
+	});
+});
+const coerceNodeIdOrFail = (operation, nodeId) => Effect.try({
+	try: () => coerceNodeId(nodeId),
+	catch: (cause) => configurationError({
+		operation,
+		nodeId: String(nodeId),
+		cause
+	})
+});
+
+//#endregion
+export { callMethods, callResolvedMethod, methodResultFromRaw, resolveMethod };
+//# sourceMappingURL=operations.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operations.mjs","names":[],"sources":["../../../src/internal/method/operations.ts"],"sourcesContent":["import {\n  coerceNodeId,\n  type CallMethodResult,\n  type ClientSession,\n} from \"node-opcua\";\nimport { Effect } from \"effect\";\n\nimport {\n  configurationError,\n  methodNotExecutableError,\n  serviceError,\n} from \"../../OpcuaError.js\";\nimport { runChunked, type BatchOptions } from \"../batch/chunk.js\";\nimport { normalizeStatusCode } from \"../values/normalize.js\";\nimport { resultFromStatusAndDecode } from \"../values/result.js\";\nimport type { OpcuaStructureRuntime } from \"../structures/runtime.js\";\nimport type { MethodCallOptions } from \"../batch/operations.js\";\nimport {\n  normalizeInputArgumentResults,\n  outputObjectFromResult,\n  preflightMethodCall,\n  type MethodPreflight,\n} from \"./arguments.js\";\nimport type {\n  AnyMethodDef,\n  AnyResolvedMethod,\n  InputOfMethodDef,\n  MethodCallEntry,\n  MethodCallResult,\n  MethodMetadata,\n  OutputOfMethodDef,\n  ResolvedMethod,\n} from \"../../OpcuaMethod.js\";\n\nexport const resolveMethod = <const Spec extends AnyMethodDef>(\n  spec: Spec,\n  metadata: MethodMetadata,\n) =>\n  Effect.gen(function* () {\n    const objectId = yield* coerceNodeIdOrFail(\n      \"method.objectId\",\n      spec.objectId,\n    );\n    const methodId = yield* coerceNodeIdOrFail(\n      \"method.methodId\",\n      spec.methodId,\n    );\n    if (!metadata.executable || metadata.userExecutable === false) {\n      return yield* Effect.fail(\n        methodNotExecutableError({\n          objectId: spec.objectId,\n          methodId: spec.methodId,\n          executable: metadata.executable,\n          userExecutable: metadata.userExecutable,\n        }),\n      );\n    }\n    return {\n      _tag: \"ResolvedMethod\" as const,\n      objectId: spec.objectId,\n      methodId: spec.methodId,\n      def: spec,\n      metadata,\n      unsafeRaw: {\n        objectId,\n        methodId,\n        inputArguments: metadata.inputArguments.map(\n          (argument) => argument.unsafeRaw.argument,\n        ),\n        outputArguments: metadata.outputArguments.map(\n          (argument) => argument.unsafeRaw.argument,\n        ),\n      },\n    } as ResolvedMethod<Spec>;\n  });\n\nexport const callResolvedMethod = <const Spec extends AnyMethodDef>(\n  session: ClientSession,\n  method: ResolvedMethod<Spec>,\n  input: InputOfMethodDef<Spec>,\n  structureRuntime: OpcuaStructureRuntime,\n  options?: MethodCallOptions,\n) =>\n  Effect.gen(function* () {\n    const preflight = yield* preflightMethodCall(\n      method,\n      input,\n      structureRuntime,\n      options,\n    );\n    const result = yield* Effect.tryPromise({\n      try: () => session.call(preflight.request),\n      catch: (cause) =>\n        serviceError({\n          operation: \"call\",\n          nodeId: method.methodId,\n          cause,\n        }),\n    });\n    return yield* methodResultFromRaw(\n      method,\n      preflight,\n      result,\n      structureRuntime,\n    );\n  });\n\nexport const callMethods = (\n  session: ClientSession,\n  entries: ReadonlyArray<MethodCallEntry<AnyResolvedMethod>>,\n  structureRuntime: OpcuaStructureRuntime,\n  options?: BatchOptions,\n) =>\n  Effect.gen(function* () {\n    const preflights = yield* Effect.forEach(entries, (entry) =>\n      preflightMethodCall(\n        entry.method,\n        entry.input,\n        structureRuntime,\n        entry.options,\n      ),\n    );\n    const rawResults = yield* runChunked(preflights, options, (chunk) =>\n      Effect.gen(function* () {\n        const results = yield* Effect.tryPromise({\n          try: () => session.call(chunk.map((preflight) => preflight.request)),\n          catch: (cause) =>\n            serviceError({\n              operation: \"call\",\n              cause,\n            }),\n        });\n        if (results.length !== chunk.length) {\n          return yield* Effect.fail(\n            serviceError({\n              operation: \"call\",\n              cause: `Expected ${chunk.length} CallMethodResults, got ${results.length}`,\n            }),\n          );\n        }\n        return results;\n      }),\n    );\n    return yield* Effect.forEach(entries, (entry, index) =>\n      methodResultFromRaw(\n        entry.method,\n        preflights[index]!,\n        rawResults[index]!,\n        structureRuntime,\n      ),\n    );\n  });\n\nexport const methodResultFromRaw = <const Spec extends AnyMethodDef>(\n  method: ResolvedMethod<Spec>,\n  preflight: MethodPreflight,\n  result: CallMethodResult,\n  structureRuntime: OpcuaStructureRuntime,\n) =>\n  Effect.gen(function* () {\n    const unsafeRaw = preflight.includeRaw\n      ? { request: preflight.request, result }\n      : undefined;\n    const status = normalizeStatusCode(result.statusCode);\n    const inputArgumentResults = normalizeInputArgumentResults(method, result);\n    return yield* resultFromStatusAndDecode<\n      Record<string, unknown>,\n      typeof status,\n      MethodCallResult<\n        OutputOfMethodDef<Spec>,\n        Spec[\"objectId\"],\n        Spec[\"methodId\"]\n      >\n    >({\n      statusCode: result.statusCode,\n      status,\n      decode: outputObjectFromResult(method, result, structureRuntime),\n      nonGoodStatus: (status) => ({\n        _tag: \"NonGoodStatus\",\n        objectId: method.objectId,\n        methodId: method.methodId,\n        status,\n        inputArgumentResults,\n        unsafeRaw,\n      }),\n      decodeError: (error, status) => ({\n        _tag: \"DecodeError\",\n        objectId: method.objectId,\n        methodId: method.methodId,\n        status,\n        error,\n        unsafeRaw,\n      }),\n      value: (output) => ({\n        _tag: \"Called\",\n        objectId: method.objectId,\n        methodId: method.methodId,\n        output: output as OutputOfMethodDef<Spec>,\n        status,\n        inputArgumentResults,\n        unsafeRaw,\n      }),\n    });\n  }) as Effect.Effect<\n    MethodCallResult<\n      OutputOfMethodDef<Spec>,\n      Spec[\"objectId\"],\n      Spec[\"methodId\"]\n    >\n  >;\n\nconst coerceNodeIdOrFail = (operation: string, nodeId: unknown) =>\n  Effect.try({\n    try: () => coerceNodeId(nodeId),\n    catch: (cause) =>\n      configurationError({ operation, nodeId: String(nodeId), cause }),\n  });\n"],"mappings":";;;;;;;;;AAkCA,MAAa,iBACX,MACA,aAEA,OAAO,IAAI,aAAa;CACtB,MAAM,WAAW,OAAO,mBACtB,mBACA,KAAK,SACN;CACD,MAAM,WAAW,OAAO,mBACtB,mBACA,KAAK,SACN;AACD,KAAI,CAAC,SAAS,cAAc,SAAS,mBAAmB,MACtD,QAAO,OAAO,OAAO,KACnB,yBAAyB;EACvB,UAAU,KAAK;EACf,UAAU,KAAK;EACf,YAAY,SAAS;EACrB,gBAAgB,SAAS;EAC1B,CAAC,CACH;AAEH,QAAO;EACL,MAAM;EACN,UAAU,KAAK;EACf,UAAU,KAAK;EACf,KAAK;EACL;EACA,WAAW;GACT;GACA;GACA,gBAAgB,SAAS,eAAe,KACrC,aAAa,SAAS,UAAU,SAClC;GACD,iBAAiB,SAAS,gBAAgB,KACvC,aAAa,SAAS,UAAU,SAClC;GACF;EACF;EACD;AAEJ,MAAa,sBACX,SACA,QACA,OACA,kBACA,YAEA,OAAO,IAAI,aAAa;CACtB,MAAM,YAAY,OAAO,oBACvB,QACA,OACA,kBACA,QACD;AAUD,QAAO,OAAO,oBACZ,QACA,WAXa,OAAO,OAAO,WAAW;EACtC,WAAW,QAAQ,KAAK,UAAU,QAAQ;EAC1C,QAAQ,UACN,aAAa;GACX,WAAW;GACX,QAAQ,OAAO;GACf;GACD,CAAC;EACL,CAAC,EAKA,iBACD;EACD;AAEJ,MAAa,eACX,SACA,SACA,kBACA,YAEA,OAAO,IAAI,aAAa;CACtB,MAAM,aAAa,OAAO,OAAO,QAAQ,UAAU,UACjD,oBACE,MAAM,QACN,MAAM,OACN,kBACA,MAAM,QACP,CACF;CACD,MAAM,aAAa,OAAO,WAAW,YAAY,UAAU,UACzD,OAAO,IAAI,aAAa;EACtB,MAAM,UAAU,OAAO,OAAO,WAAW;GACvC,WAAW,QAAQ,KAAK,MAAM,KAAK,cAAc,UAAU,QAAQ,CAAC;GACpE,QAAQ,UACN,aAAa;IACX,WAAW;IACX;IACD,CAAC;GACL,CAAC;AACF,MAAI,QAAQ,WAAW,MAAM,OAC3B,QAAO,OAAO,OAAO,KACnB,aAAa;GACX,WAAW;GACX,OAAO,YAAY,MAAM,OAAO,0BAA0B,QAAQ;GACnE,CAAC,CACH;AAEH,SAAO;GACP,CACH;AACD,QAAO,OAAO,OAAO,QAAQ,UAAU,OAAO,UAC5C,oBACE,MAAM,QACN,WAAW,QACX,WAAW,QACX,iBACD,CACF;EACD;AAEJ,MAAa,uBACX,QACA,WACA,QACA,qBAEA,OAAO,IAAI,aAAa;CACtB,MAAM,YAAY,UAAU,aACxB;EAAE,SAAS,UAAU;EAAS;EAAQ,GACtC;CACJ,MAAM,SAAS,oBAAoB,OAAO,WAAW;CACrD,MAAM,uBAAuB,8BAA8B,QAAQ,OAAO;AAC1E,QAAO,OAAO,0BAQZ;EACA,YAAY,OAAO;EACnB;EACA,QAAQ,uBAAuB,QAAQ,QAAQ,iBAAiB;EAChE,gBAAgB,cAAY;GAC1B,MAAM;GACN,UAAU,OAAO;GACjB,UAAU,OAAO;GACjB;GACA;GACA;GACD;EACD,cAAc,OAAO,cAAY;GAC/B,MAAM;GACN,UAAU,OAAO;GACjB,UAAU,OAAO;GACjB;GACA;GACA;GACD;EACD,QAAQ,YAAY;GAClB,MAAM;GACN,UAAU,OAAO;GACjB,UAAU,OAAO;GACT;GACR;GACA;GACA;GACD;EACF,CAAC;EACF;AAQJ,MAAM,sBAAsB,WAAmB,WAC7C,OAAO,IAAI;CACT,WAAW,aAAa,OAAO;CAC/B,QAAQ,UACN,mBAAmB;EAAE;EAAW,QAAQ,OAAO,OAAO;EAAE;EAAO,CAAC;CACnE,CAAC"}

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

@@ -0,0 +1,30 @@
+import { NodeIdString, ReadableVariableDef } from "../../OpcuaVariable.mjs";
+import "../common/node-id.mjs";
+import { EffectiveMonitorItemOptions, MonitorItemDictionary, MonitorOptions } from "../../OpcuaSubscription.mjs";
+import { OpcuaMonitorConfigurationError } from "../../OpcuaError.mjs";
+import { DataChangeFilter, NodeId, TimestampsToReturn } from "node-opcua";
+import { Effect } from "effect";
+
+//#region src/internal/monitoring/options.d.ts
+type NormalizedCreateOptions = {
+  readonly maxItemsPerRequest: number;
+  readonly maxConcurrentRequests: number;
+};
+type NormalizedMonitorItem<Items> = {
+  readonly key: keyof Items & string;
+  readonly def: ReadableVariableDef;
+  readonly nodeId: NodeIdString;
+  readonly rawNodeId: NodeId;
+};
+type EffectiveMonitorItem<Items> = NormalizedMonitorItem<Items> & {
+  readonly requested: EffectiveMonitorItemOptions;
+  readonly nodeOpcuaFilter?: DataChangeFilter;
+  readonly timestampsToReturn: TimestampsToReturn;
+  readonly compatibilityKey: string;
+};
+declare const normalizeMonitorItems: <Items extends MonitorItemDictionary>(items: Items) => Effect.Effect<ReadonlyArray<NormalizedMonitorItem<Items>>, OpcuaMonitorConfigurationError>;
+declare const validateMonitorOptions: <Items>(items: ReadonlyArray<NormalizedMonitorItem<Items>>, options: MonitorOptions<Items>) => Effect.Effect<NormalizedCreateOptions, OpcuaMonitorConfigurationError>;
+declare const applyMonitorOptions: <Items>(items: ReadonlyArray<NormalizedMonitorItem<Items>>, options: MonitorOptions<Items>) => Effect.Effect<ReadonlyArray<EffectiveMonitorItem<Items>>, OpcuaMonitorConfigurationError>;
+//#endregion
+export { EffectiveMonitorItem, NormalizedCreateOptions, NormalizedMonitorItem, applyMonitorOptions, normalizeMonitorItems, validateMonitorOptions };
+//# sourceMappingURL=options.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.mts","names":[],"sources":["../../../src/internal/monitoring/options.ts"],"sourcesContent":[],"mappings":";;;;;;;;KAgCY,uBAAA;;EAAA,SAAA,qBAAuB,EAAA,MAAA;AAKnC,CAAA;AACsB,KADV,qBACU,CAAA,KAAA,CAAA,GAAA;EACN,SAAA,GAAA,EAAA,MADM,KACN,GAAA,MAAA;EACG,SAAA,GAAA,EADH,mBACG;EACG,SAAA,MAAA,EADH,YACG;EAAM,SAAA,SAAA,EAAN,MAAM;AAG5B,CAAA;AAAgE,KAApD,oBAAoD,CAAA,KAAA,CAAA,GAAtB,qBAAsB,CAAA,KAAA,CAAA,GAAA;EAAtB,SAAA,SAAA,EACpB,2BADoB;EACpB,SAAA,eAAA,CAAA,EACO,gBADP;EACO,SAAA,kBAAA,EACE,kBADF;EACE,SAAA,gBAAA,EAAA,MAAA;CAAkB;AAsBpC,cAAA,qBAkET,EAAA,CAAA,cAlEgD,qBAkEhD,CAAA,CAAA,KAAA,EAjEK,KAiEL,EAAA,GAhED,MAAA,CAAO,MAgEN,CA/DF,aA+DE,CA/DY,qBA+DZ,CA/DkC,KA+DlC,CAAA,CAAA,EA9DF,8BA8DE,CAAA;AAlEgD,cAoEvC,sBApEuC,EAAA,CAAA,KAAA,CAAA,CAAA,KAAA,EAqE3C,aArE2C,CAqE7B,qBArE6B,CAqEP,KArEO,CAAA,CAAA,EAAA,OAAA,EAsEzC,cAtEyC,CAsE1B,KAtE0B,CAAA,EAAA,GAuEjD,MAAA,CAAO,MAvE0C,CAuEnC,uBAvEmC,EAuEV,8BAvEU,CAAA;AAC3C,cA6MI,mBA7MJ,EAAA,CAAA,KAAA,CAAA,CAAA,KAAA,EA8MA,aA9MA,CA8Mc,qBA9Md,CA8MoC,KA9MpC,CAAA,CAAA,EAAA,OAAA,EA+ME,cA/MF,CA+MiB,KA/MjB,CAAA,EAAA,GAgNN,MAAA,CAAO,MAhND,CAiNP,aAjNO,CAiNO,oBAjNP,CAiN4B,KAjN5B,CAAA,CAAA,EAkNP,8BAlNO,CAAA"}