opcjs-base 0.1.20-alpha → 0.1.29-alpha

package/dist/index.cjs

@@ -2,6 +2,40 @@
 
 var fastXmlParser = require('fast-xml-parser');
 
+// src/types/expandedNodeId.ts
+var ExpandedNodeId = class {
+  /** The wrapped NodeId. */
+  nodeId;
+  /** The server index (optional, for cross-server references). */
+  serverIndex;
+  /** The namespace URI (optional, alternative to the namespace index on nodeId). */
+  namespaceUri;
+  /**
+   * Create a new ExpandedNodeId.
+   *
+   * @param nodeId - The wrapped NodeId
+   * @param namespaceUri - Optional namespace URI
+   * @param serverIndex - Optional server index
+   */
+  constructor(nodeId, namespaceUri, serverIndex) {
+    this.nodeId = nodeId;
+    this.namespaceUri = namespaceUri;
+    this.serverIndex = serverIndex;
+  }
+  /** Convert ExpandedNodeId to string representation. */
+  toString() {
+    let result = "";
+    if (this.serverIndex !== void 0) {
+      result += `svr=${this.serverIndex};`;
+    }
+    if (this.namespaceUri !== void 0) {
+      result += `nsu=${this.namespaceUri};`;
+    }
+    result += this.nodeId.toString();
+    return result;
+  }
+};
+
 // src/types/nodeId.ts
 var NodeIdType = /* @__PURE__ */ ((NodeIdType2) => {
   NodeIdType2[NodeIdType2["Numeric"] = 0] = "Numeric";
@@ -172,47 +206,6 @@ var NodeId = class _NodeId {
   }
 };
 
-// src/types/expandedNodeId.ts
-var ExpandedNodeId = class extends NodeId {
-  /**
-   * The server index (optional, for cross-server references)
-   */
-  serverIndex;
-  /**
-   * The namespace URI (optional, alternative to namespace index)
-   */
-  namespaceUri;
-  /**
-   * Create a new ExpandedNodeId
-   * 
-   * @param namespace - The namespace index
-   * @param identifier - The identifier
-   * @param namespaceUri - Optional namespace URI
-   * @param serverIndex - Optional server index
-   */
-  constructor(namespace = 0, identifier = 0, namespaceUri, serverIndex) {
-    super(namespace, identifier);
-    this.namespaceUri = namespaceUri;
-    this.serverIndex = serverIndex;
-  }
-  /**
-   * Convert ExpandedNodeId to string representation
-   * 
-   * @returns String representation of the ExpandedNodeId
-   */
-  toString() {
-    let result = "";
-    if (this.serverIndex !== void 0) {
-      result += `svr=${this.serverIndex};`;
-    }
-    if (this.namespaceUri !== void 0) {
-      result += `nsu=${this.namespaceUri};`;
-    }
-    result += super.toString();
-    return result;
-  }
-};
-
 // src/codecs/encoder.ts
 var Encoder = class {
   encoders = /* @__PURE__ */ new Map();
@@ -230,7 +223,7 @@ var Encoder = class {
     }
     const writer = writerFactory();
     const encodingId = value.getBinaryEncodingId();
-    const eid = new ExpandedNodeId(0, encodingId);
+    const eid = new ExpandedNodeId(new NodeId(0, encodingId));
     writer.writeExpandedNodeId(eid);
     const typeId = value.getTypeId();
     const encodingFunction = this.encoders.get(typeId);
@@ -277,7 +270,7 @@ var Decoder = class {
     }
     const reader = readerFactory(data);
     const eid = reader.readExpandedNodeId();
-    return this.decodeWithEncodingId(eid.identifier, reader);
+    return this.decodeWithEncodingId(eid.nodeId.identifier, reader);
   }
   decodeWithEncodingId(encodingId, reader) {
     const decodingInfo = this.encodingIdMap.get(encodingId);
@@ -493,7 +486,7 @@ function decodeExpandedNodeId(reader) {
   if (hasServerIndex) {
     serverIndex = reader.readUInt32();
   }
-  return new ExpandedNodeId(nodeId.namespace, nodeId.identifier, namespaceUri, serverIndex);
+  return new ExpandedNodeId(nodeId, namespaceUri, serverIndex);
 }
 function encodeExpandedNodeId(writer, value) {
   let extraFlags = 0;
@@ -504,9 +497,9 @@ function encodeExpandedNodeId(writer, value) {
     extraFlags |= ExpandedNodeIdMask.ServerIndexFlag;
   }
   if (extraFlags === 0) {
-    encodeNodeId(writer, value);
+    encodeNodeId(writer, value.nodeId);
   } else {
-    encodeNodeIdWithExtraFlags(writer, value, extraFlags);
+    encodeNodeIdWithExtraFlags(writer, value.nodeId, extraFlags);
   }
   if (value.namespaceUri !== void 0) {
     writer.writeString(value.namespaceUri);
@@ -727,7 +720,7 @@ function encodeLocalizedText(writer, value) {
 // src/types/extensionObject.ts
 var ExtensionObject = class _ExtensionObject {
   /**
-   * The NodeId that identifies the type of structure encoded in the body.
+   * The NodeId (or ExpandedNodeId) that identifies the type of structure encoded in the body.
    */
   typeId;
   /**
@@ -1056,7 +1049,7 @@ function decodeExtensionObject(reader, decoder) {
 }
 function encodeExtensionObject(writer, value, encoder) {
   const typeId = value.typeId;
-  if ("namespaceUri" in typeId || "serverIndex" in typeId) {
+  if (typeId instanceof ExpandedNodeId) {
     encodeExpandedNodeId(writer, typeId);
   } else {
     encodeNodeId(writer, typeId);
@@ -1372,7 +1365,7 @@ function StatusCodeToString(statusCode) {
   if (statusCode === void 0) {
     return "Unknown";
   }
-  const baseCode = statusCode & 4294901760;
+  const baseCode = (statusCode & 4294901760) >>> 0;
   const name = Object.entries(StatusCode).find(([, v]) => v === baseCode)?.[0];
   return name ?? `0x${baseCode.toString(16).toUpperCase().padStart(8, "0")}`;
 }
@@ -1394,6 +1387,9 @@ function StatusCodeGetFlagBits(statusCode) {
     LimitConstant: limitBits === 3
   };
 }
+function StatusCodeIs(statusCode, expected) {
+  return (statusCode & 4294901760) >>> 0 === expected;
+}
 
 // src/types/dataValue.ts
 var DataValue = class _DataValue {
@@ -1624,147 +1620,416 @@ function encodeDataValue(writer, value, encoder) {
   }
 }
 
-// src/types/variant.ts
-var Variant = class _Variant {
+// src/types/xmlElement.ts
+var XmlElement = class _XmlElement {
   /**
-   * The variant type identifier.
+   * The XML string content
    */
-  type;
+  content;
   /**
-   * The variant value (scalar or array).
+   * Create a new XmlElement
+   * 
+   * @param content - The XML string content
    */
-  value;
+  constructor(content = "") {
+    this.content = content;
+  }
   /**
-   * Optional array dimensions for multi-dimensional arrays.
-   * For 1D arrays, this is [length].
-   * For 2D arrays, this is [rows, cols], etc.
+   * Get the XML string content
+   * 
+   * @returns The XML string
    */
-  arrayDimensions;
+  toString() {
+    return this.content;
+  }
   /**
-   * Checks if this variant is null.
+   * Get the length of the XML string
    * 
-   * @returns True if the variant type is Null
+   * @returns The number of characters
    */
-  isNull() {
-    return this.type === 0 /* Null */;
+  get length() {
+    return this.content.length;
   }
   /**
-   * Checks if this variant contains an array.
+   * Escape special XML characters in text content
    * 
-   * @returns True if the value is an array
+   * @param text - Text to escape
+   * @returns Escaped text safe for use in XML
+   * 
+   * @example
+   * ```typescript
+   * XmlElement.escape("Hello & <World>"); // "Hello &amp; &lt;World&gt;"
+   * ```
    */
-  isArray() {
-    return Array.isArray(this.value);
+  static escape(text) {
+    return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
   }
   /**
-   * Checks if this variant contains a scalar value.
+   * Unescape XML entities to plain text
    * 
-   * @returns True if the value is not an array
+   * @param xml - XML text with entities
+   * @returns Unescaped text
+   * 
+   * @example
+   * ```typescript
+   * XmlElement.unescape("Hello &amp; &lt;World&gt;"); // "Hello & <World>"
+   * ```
    */
-  isScalar() {
-    return !this.isArray();
+  static unescape(xml) {
+    return xml.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&amp;/g, "&");
   }
   /**
-   * Gets the array length for 1D arrays.
+   * Create a simple XML element
    * 
-   * @returns The array length, or 0 if not an array
+   * @param tagName - The XML tag name
+   * @param content - The text content (will be escaped)
+   * @param attributes - Optional attributes object
+   * @returns XmlElement
+   * 
+   * @example
+   * ```typescript
+   * const xml = XmlElement.create("Temperature", "25.5", { unit: "C" });
+   * // "<Temperature unit=\"C\">25.5</Temperature>"
+   * ```
    */
-  getArrayLength() {
-    if (this.isArray() && Array.isArray(this.value)) {
-      return this.value.length;
+  static create(tagName, content = "", attributes) {
+    let attrStr = "";
+    if (attributes) {
+      attrStr = Object.entries(attributes).map(([key, value]) => ` ${key}="${_XmlElement.escape(value)}"`).join("");
     }
-    return 0;
+    const escapedContent = _XmlElement.escape(content);
+    const xmlString = `<${tagName}${attrStr}>${escapedContent}</${tagName}>`;
+    return new _XmlElement(xmlString);
   }
   /**
-   * Checks equality with another Variant.
+   * Create an empty XmlElement
    * 
-   * @param other - The variant to compare with
-   * @returns True if variants are equal
+   * @returns Empty XmlElement
    */
-  equals(other) {
-    if (this.type !== other.type) {
-      return false;
-    }
-    if (this.arrayDimensions !== void 0 || other.arrayDimensions !== void 0) {
-      if (this.arrayDimensions === void 0 || other.arrayDimensions === void 0) {
-        return false;
-      }
-      if (this.arrayDimensions.length !== other.arrayDimensions.length) {
-        return false;
-      }
-      for (let i = 0; i < this.arrayDimensions.length; i++) {
-        if (this.arrayDimensions[i] !== other.arrayDimensions[i]) {
-          return false;
-        }
-      }
-    }
-    return JSON.stringify(this.value) === JSON.stringify(other.value);
+  static empty() {
+    return new _XmlElement("");
   }
   /**
-   * Converts the variant to a string representation.
+   * Check equality with another XmlElement
    * 
-   * @returns A string representation of the variant
+   * @param other - The other XmlElement
+   * @returns true if both contain the same XML string
    */
-  toString() {
-    const typeName = BuiltInType[this.type];
-    if (this.isNull()) {
-      return "Variant(Null)";
-    }
-    if (this.isArray()) {
-      const dimStr = this.arrayDimensions ? `[${this.arrayDimensions.join(",")}]` : "[?]";
-      return `Variant(${typeName}${dimStr})`;
-    }
-    return `Variant(${typeName}: ${String(this.value)})`;
+  equals(other) {
+    return this.content === other.content;
   }
+};
+
+// src/types/diagnosticInfo.ts
+var DiagnosticInfo = class _DiagnosticInfo {
   /**
-   * Creates a Variant from a typed OPC UA primitive value.
-   *
-   * Uses the `.type` discriminant on tagged primitives to determine the
-   * VariantType exactly — no heuristic inference based on value ranges.
-   *
-   * @param value - A typed OPC UA primitive value.
-   * @returns A new Variant wrapping the inner value with the correct VariantType.
+   * Index into a string table for the symbolic identifier.
+   * The symbolic id is used to identify an error condition in a vendor-specific way.
    */
-  static newFrom(value) {
-    if (value === null || value === void 0) {
-      return _Variant.newNull();
-    }
-    if (typeof value === "boolean") {
-      return new _Variant(1 /* Boolean */, value);
-    }
-    if (typeof value === "string") {
-      return new _Variant(12 /* String */, value);
-    }
-    if (value instanceof Uint8Array) {
-      return new _Variant(15 /* ByteString */, value);
-    }
-    if (value instanceof Date) {
-      return new _Variant(13 /* DateTime */, value);
-    }
-    if (typeof value === "object" && "type" in value) {
-      const tagged = value;
-      return new _Variant(tagged.type, tagged.value);
-    }
-    throw new Error(
-      `newFrom: unhandled UaPrimitive value: ${JSON.stringify(value)}`
-    );
-  }
+  symbolicId;
   /**
-   * Creates a undefined variant.
-   * 
-   * @returns A new Variant with undefined value
+   * Index into a string table for the namespace URI.
+   * Identifies the namespace that defines the symbolicId.
    */
-  static newNull() {
-    return new _Variant(0 /* Null */);
-  }
+  namespaceUri;
   /**
-   * Creates a new Variant.
+   * Index into a string table for the localized text.
+   * Contains a human-readable description of the error.
+   */
+  localizedText;
+  /**
+   * Index into a string table for the locale.
+   * Identifies the locale used for the localizedText.
+   */
+  locale;
+  /**
+   * Additional debugging/diagnostic information.
+   * Not intended for display to end users.
+   */
+  additionalInfo;
+  /**
+   * StatusCode from a nested operation.
+   * Used when the diagnostic info relates to a nested operation result.
+   */
+  innerStatusCode;
+  /**
+   * Nested DiagnosticInfo.
+   * Allows for recursive diagnostic information structures.
+   */
+  innerDiagnosticInfo;
+  /**
+   * Creates a new DiagnosticInfo.
    * 
-   * @param variantType - The type of value stored in the variant
-   * @param value - The scalar or array value
-   * @param arrayDimensions - Optional array dimensions for structured arrays
+   * @param options - Optional diagnostic information fields
    */
-  constructor(variantType = 0 /* Null */, value = void 0, arrayDimensions = void 0) {
+  constructor(options = {}) {
+    this.symbolicId = options.symbolicId;
+    this.namespaceUri = options.namespaceUri;
+    this.localizedText = options.localizedText;
+    this.locale = options.locale;
+    this.additionalInfo = options.additionalInfo;
+    this.innerStatusCode = options.innerStatusCode;
+    this.innerDiagnosticInfo = options.innerDiagnosticInfo;
+  }
+  /**
+   * Creates an empty DiagnosticInfo with no fields set.
+   * 
+   * @returns A new DiagnosticInfo with all fields undefined
+   */
+  static createEmpty() {
+    return new _DiagnosticInfo({});
+  }
+  /**
+   * Creates a DiagnosticInfo with just additional info text.
+   * 
+   * @param additionalInfo - The diagnostic information text
+   * @returns A new DiagnosticInfo with only additionalInfo set
+   */
+  static fromText(additionalInfo) {
+    return new _DiagnosticInfo({ additionalInfo });
+  }
+  /**
+   * Checks if this DiagnosticInfo is empty (all fields undefined).
+   * 
+   * @returns True if all fields are undefined
+   */
+  isEmpty() {
+    return this.symbolicId === void 0 && this.namespaceUri === void 0 && this.localizedText === void 0 && this.locale === void 0 && this.additionalInfo === void 0 && this.innerStatusCode === void 0 && this.innerDiagnosticInfo === void 0;
+  }
+  /**
+   * Checks if this DiagnosticInfo has nested diagnostic information.
+   * 
+   * @returns True if innerDiagnosticInfo is not undefined
+   */
+  hasInnerDiagnostics() {
+    return this.innerDiagnosticInfo !== void 0;
+  }
+  /**
+   * Gets the depth of nested diagnostic information.
+   * 
+   * @returns The nesting depth (0 if no inner diagnostics)
+   */
+  getDepth() {
+    if (this.innerDiagnosticInfo === void 0) {
+      return 0;
+    }
+    return 1 + this.innerDiagnosticInfo.getDepth();
+  }
+  /**
+   * Flattens the nested diagnostic information into an array.
+   * 
+   * @returns An array of all DiagnosticInfo objects in the chain
+   */
+  flatten() {
+    const result = [this];
+    if (this.innerDiagnosticInfo !== void 0) {
+      result.push(...this.innerDiagnosticInfo.flatten());
+    }
+    return result;
+  }
+  /**
+   * Converts the DiagnosticInfo to a string representation.
+   * 
+   * @param includeInner - Whether to include inner diagnostic info (default: true)
+   * @returns A string representation
+   */
+  toString(includeInner = true) {
+    if (this.isEmpty()) {
+      return "DiagnosticInfo(empty)";
+    }
+    const parts = [];
+    if (this.symbolicId !== void 0) {
+      parts.push(`symbolicId: ${this.symbolicId}`);
+    }
+    if (this.namespaceUri !== void 0) {
+      parts.push(`namespaceUri: ${this.namespaceUri}`);
+    }
+    if (this.localizedText !== void 0) {
+      parts.push(`localizedText: ${this.localizedText}`);
+    }
+    if (this.locale !== void 0) {
+      parts.push(`locale: ${this.locale}`);
+    }
+    if (this.additionalInfo !== void 0) {
+      parts.push(`additionalInfo: "${this.additionalInfo}"`);
+    }
+    if (this.innerStatusCode !== void 0) {
+      parts.push(`innerStatusCode: ${this.innerStatusCode.toString()}`);
+    }
+    if (includeInner && this.innerDiagnosticInfo !== void 0) {
+      parts.push(`innerDiagnosticInfo: ${this.innerDiagnosticInfo.toString(true)}`);
+    }
+    return `DiagnosticInfo(${parts.join(", ")})`;
+  }
+};
+
+// src/types/variant.ts
+var Variant = class _Variant {
+  /**
+   * The variant type identifier.
+   */
+  type;
+  /**
+   * The variant value (scalar or array).
+   */
+  value;
+  /**
+   * Optional array dimensions for multi-dimensional arrays.
+   * For 1D arrays, this is [length].
+   * For 2D arrays, this is [rows, cols], etc.
+   */
+  arrayDimensions;
+  /**
+   * Checks if this variant is null.
+   * 
+   * @returns True if the variant type is Null
+   */
+  isNull() {
+    return this.type === 0 /* Null */;
+  }
+  /**
+   * Checks if this variant contains an array.
+   * 
+   * @returns True if the value is an array
+   */
+  isArray() {
+    return Array.isArray(this.value);
+  }
+  /**
+   * Checks if this variant contains a scalar value.
+   * 
+   * @returns True if the value is not an array
+   */
+  isScalar() {
+    return !this.isArray();
+  }
+  /**
+   * Gets the array length for 1D arrays.
+   * 
+   * @returns The array length, or 0 if not an array
+   */
+  getArrayLength() {
+    if (this.isArray() && Array.isArray(this.value)) {
+      return this.value.length;
+    }
+    return 0;
+  }
+  /**
+   * Checks equality with another Variant.
+   * 
+   * @param other - The variant to compare with
+   * @returns True if variants are equal
+   */
+  equals(other) {
+    if (this.type !== other.type) {
+      return false;
+    }
+    if (this.arrayDimensions !== void 0 || other.arrayDimensions !== void 0) {
+      if (this.arrayDimensions === void 0 || other.arrayDimensions === void 0) {
+        return false;
+      }
+      if (this.arrayDimensions.length !== other.arrayDimensions.length) {
+        return false;
+      }
+      for (let i = 0; i < this.arrayDimensions.length; i++) {
+        if (this.arrayDimensions[i] !== other.arrayDimensions[i]) {
+          return false;
+        }
+      }
+    }
+    return JSON.stringify(this.value) === JSON.stringify(other.value);
+  }
+  /**
+   * Converts the variant to a string representation.
+   * 
+   * @returns A string representation of the variant
+   */
+  toString() {
+    const typeName = BuiltInType[this.type];
+    if (this.isNull()) {
+      return "Variant(Null)";
+    }
+    if (this.isArray()) {
+      const dimStr = this.arrayDimensions ? `[${this.arrayDimensions.join(",")}]` : "[?]";
+      return `Variant(${typeName}${dimStr})`;
+    }
+    return `Variant(${typeName}: ${String(this.value)})`;
+  }
+  /**
+   * Union of all OPC UA built-in types accepted by {@link Variant.newFrom}.
+   *
+   * Includes both the tagged numeric primitives from `UaPrimitive` (which carry
+   * a `BuiltInType` discriminant so the exact numeric encoding is known) and the
+   * class-based built-in types that are identified unambiguously at runtime via
+   * `instanceof`.
+   */
+  static newFrom(value) {
+    if (value === null || value === void 0) {
+      return _Variant.newNull();
+    }
+    if (typeof value === "boolean") {
+      return new _Variant(1 /* Boolean */, value);
+    }
+    if (typeof value === "string") {
+      return new _Variant(12 /* String */, value);
+    }
+    if (value instanceof Uint8Array) {
+      return new _Variant(15 /* ByteString */, value);
+    }
+    if (value instanceof Date) {
+      return new _Variant(13 /* DateTime */, value);
+    }
+    if (value instanceof ExpandedNodeId) {
+      return new _Variant(18 /* ExpandedNodeId */, value);
+    }
+    if (value instanceof NodeId) {
+      return new _Variant(17 /* NodeId */, value);
+    }
+    if (value instanceof QualifiedName) {
+      return new _Variant(20 /* QualifiedName */, value);
+    }
+    if (value instanceof LocalizedText) {
+      return new _Variant(21 /* LocalizedText */, value);
+    }
+    if (value instanceof XmlElement) {
+      return new _Variant(16 /* XmlElement */, value);
+    }
+    if (value instanceof ExtensionObject) {
+      return new _Variant(22 /* ExtensionObject */, value);
+    }
+    if (value instanceof DataValue) {
+      return new _Variant(23 /* DataValue */, value);
+    }
+    if (value instanceof DiagnosticInfo) {
+      return new _Variant(25 /* DiagnosticInfo */, value);
+    }
+    if (value instanceof _Variant) {
+      return new _Variant(24 /* Variant */, value);
+    }
+    if (typeof value === "object" && "type" in value) {
+      const tagged = value;
+      return new _Variant(tagged.type, tagged.value);
+    }
+    throw new Error(
+      `newFrom: unhandled value: ${JSON.stringify(value)}`
+    );
+  }
+  /**
+   * Creates a undefined variant.
+   * 
+   * @returns A new Variant with undefined value
+   */
+  static newNull() {
+    return new _Variant(0 /* Null */);
+  }
+  /**
+   * Creates a new Variant.
+   * 
+   * @param variantType - The type of value stored in the variant
+   * @param value - The scalar or array value
+   * @param arrayDimensions - Optional array dimensions for structured arrays
+   */
+  constructor(variantType = 0 /* Null */, value = void 0, arrayDimensions = void 0) {
     this.type = variantType;
     this.value = value;
     this.arrayDimensions = arrayDimensions;
@@ -1985,149 +2250,6 @@ function encodeVariant(writer, value, encoder) {
   }
 }
 
-// src/types/diagnosticInfo.ts
-var DiagnosticInfo = class _DiagnosticInfo {
-  /**
-   * Index into a string table for the symbolic identifier.
-   * The symbolic id is used to identify an error condition in a vendor-specific way.
-   */
-  symbolicId;
-  /**
-   * Index into a string table for the namespace URI.
-   * Identifies the namespace that defines the symbolicId.
-   */
-  namespaceUri;
-  /**
-   * Index into a string table for the localized text.
-   * Contains a human-readable description of the error.
-   */
-  localizedText;
-  /**
-   * Index into a string table for the locale.
-   * Identifies the locale used for the localizedText.
-   */
-  locale;
-  /**
-   * Additional debugging/diagnostic information.
-   * Not intended for display to end users.
-   */
-  additionalInfo;
-  /**
-   * StatusCode from a nested operation.
-   * Used when the diagnostic info relates to a nested operation result.
-   */
-  innerStatusCode;
-  /**
-   * Nested DiagnosticInfo.
-   * Allows for recursive diagnostic information structures.
-   */
-  innerDiagnosticInfo;
-  /**
-   * Creates a new DiagnosticInfo.
-   * 
-   * @param options - Optional diagnostic information fields
-   */
-  constructor(options = {}) {
-    this.symbolicId = options.symbolicId;
-    this.namespaceUri = options.namespaceUri;
-    this.localizedText = options.localizedText;
-    this.locale = options.locale;
-    this.additionalInfo = options.additionalInfo;
-    this.innerStatusCode = options.innerStatusCode;
-    this.innerDiagnosticInfo = options.innerDiagnosticInfo;
-  }
-  /**
-   * Creates an empty DiagnosticInfo with no fields set.
-   * 
-   * @returns A new DiagnosticInfo with all fields undefined
-   */
-  static createEmpty() {
-    return new _DiagnosticInfo({});
-  }
-  /**
-   * Creates a DiagnosticInfo with just additional info text.
-   * 
-   * @param additionalInfo - The diagnostic information text
-   * @returns A new DiagnosticInfo with only additionalInfo set
-   */
-  static fromText(additionalInfo) {
-    return new _DiagnosticInfo({ additionalInfo });
-  }
-  /**
-   * Checks if this DiagnosticInfo is empty (all fields undefined).
-   * 
-   * @returns True if all fields are undefined
-   */
-  isEmpty() {
-    return this.symbolicId === void 0 && this.namespaceUri === void 0 && this.localizedText === void 0 && this.locale === void 0 && this.additionalInfo === void 0 && this.innerStatusCode === void 0 && this.innerDiagnosticInfo === void 0;
-  }
-  /**
-   * Checks if this DiagnosticInfo has nested diagnostic information.
-   * 
-   * @returns True if innerDiagnosticInfo is not undefined
-   */
-  hasInnerDiagnostics() {
-    return this.innerDiagnosticInfo !== void 0;
-  }
-  /**
-   * Gets the depth of nested diagnostic information.
-   * 
-   * @returns The nesting depth (0 if no inner diagnostics)
-   */
-  getDepth() {
-    if (this.innerDiagnosticInfo === void 0) {
-      return 0;
-    }
-    return 1 + this.innerDiagnosticInfo.getDepth();
-  }
-  /**
-   * Flattens the nested diagnostic information into an array.
-   * 
-   * @returns An array of all DiagnosticInfo objects in the chain
-   */
-  flatten() {
-    const result = [this];
-    if (this.innerDiagnosticInfo !== void 0) {
-      result.push(...this.innerDiagnosticInfo.flatten());
-    }
-    return result;
-  }
-  /**
-   * Converts the DiagnosticInfo to a string representation.
-   * 
-   * @param includeInner - Whether to include inner diagnostic info (default: true)
-   * @returns A string representation
-   */
-  toString(includeInner = true) {
-    if (this.isEmpty()) {
-      return "DiagnosticInfo(empty)";
-    }
-    const parts = [];
-    if (this.symbolicId !== void 0) {
-      parts.push(`symbolicId: ${this.symbolicId}`);
-    }
-    if (this.namespaceUri !== void 0) {
-      parts.push(`namespaceUri: ${this.namespaceUri}`);
-    }
-    if (this.localizedText !== void 0) {
-      parts.push(`localizedText: ${this.localizedText}`);
-    }
-    if (this.locale !== void 0) {
-      parts.push(`locale: ${this.locale}`);
-    }
-    if (this.additionalInfo !== void 0) {
-      parts.push(`additionalInfo: "${this.additionalInfo}"`);
-    }
-    if (this.innerStatusCode !== void 0) {
-      parts.push(`innerStatusCode: ${this.innerStatusCode.toString()}`);
-    }
-    if (includeInner && this.innerDiagnosticInfo !== void 0) {
-      parts.push(`innerDiagnosticInfo: ${this.innerDiagnosticInfo.toString(true)}`);
-    }
-    return `DiagnosticInfo(${parts.join(", ")})`;
-  }
-};
-
 // src/codecs/binary/typesComplex/diagnosticInfo.ts
 var DiagnosticInfoMaskBits = {
   SymbolicId: 1,
@@ -2822,106 +2944,6 @@ var SecureChannelTypeDecoder = class extends TransformStream {
   }
 };
 
-// src/types/xmlElement.ts
-var XmlElement = class _XmlElement {
-  /**
-   * The XML string content
-   */
-  content;
-  /**
-   * Create a new XmlElement
-   * 
-   * @param content - The XML string content
-   */
-  constructor(content = "") {
-    this.content = content;
-  }
-  /**
-   * Get the XML string content
-   * 
-   * @returns The XML string
-   */
-  toString() {
-    return this.content;
-  }
-  /**
-   * Get the length of the XML string
-   * 
-   * @returns The number of characters
-   */
-  get length() {
-    return this.content.length;
-  }
-  /**
-   * Escape special XML characters in text content
-   * 
-   * @param text - Text to escape
-   * @returns Escaped text safe for use in XML
-   * 
-   * @example
-   * ```typescript
-   * XmlElement.escape("Hello & <World>"); // "Hello &amp; &lt;World&gt;"
-   * ```
-   */
-  static escape(text) {
-    return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
-  }
-  /**
-   * Unescape XML entities to plain text
-   * 
-   * @param xml - XML text with entities
-   * @returns Unescaped text
-   * 
-   * @example
-   * ```typescript
-   * XmlElement.unescape("Hello &amp; &lt;World&gt;"); // "Hello & <World>"
-   * ```
-   */
-  static unescape(xml) {
-    return xml.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&amp;/g, "&");
-  }
-  /**
-   * Create a simple XML element
-   * 
-   * @param tagName - The XML tag name
-   * @param content - The text content (will be escaped)
-   * @param attributes - Optional attributes object
-   * @returns XmlElement
-   * 
-   * @example
-   * ```typescript
-   * const xml = XmlElement.create("Temperature", "25.5", { unit: "C" });
-   * // "<Temperature unit=\"C\">25.5</Temperature>"
-   * ```
-   */
-  static create(tagName, content = "", attributes) {
-    let attrStr = "";
-    if (attributes) {
-      attrStr = Object.entries(attributes).map(([key, value]) => ` ${key}="${_XmlElement.escape(value)}"`).join("");
-    }
-    const escapedContent = _XmlElement.escape(content);
-    const xmlString = `<${tagName}${attrStr}>${escapedContent}</${tagName}>`;
-    return new _XmlElement(xmlString);
-  }
-  /**
-   * Create an empty XmlElement
-   * 
-   * @returns Empty XmlElement
-   */
-  static empty() {
-    return new _XmlElement("");
-  }
-  /**
-   * Check equality with another XmlElement
-   * 
-   * @param other - The other XmlElement
-   * @returns true if both contain the same XML string
-   */
-  equals(other) {
-    return this.content === other.content;
-  }
-};
-
 // src/types/primitives.ts
 var uaSbyte = (value) => ({ value, type: 2 /* SByte */ });
 var uaByte = (value) => ({ value, type: 3 /* Byte */ });
@@ -18211,6 +18233,7 @@ exports.StandaloneSubscribedDataSetRefDataType = StandaloneSubscribedDataSetRefD
 exports.StatusChangeNotification = StatusChangeNotification;
 exports.StatusCode = StatusCode;
 exports.StatusCodeGetFlagBits = StatusCodeGetFlagBits;
+exports.StatusCodeIs = StatusCodeIs;
 exports.StatusCodeToString = StatusCodeToString;
 exports.StatusCodeToStringNumber = StatusCodeToStringNumber;
 exports.StatusResult = StatusResult;