opcjs-base 0.1.20-alpha → 0.1.26-alpha

package/dist/index.cjs

@@ -1394,6 +1394,9 @@ function StatusCodeGetFlagBits(statusCode) {
     LimitConstant: limitBits === 3
   };
 }
+function StatusCodeIs(statusCode, expected) {
+  return (statusCode & 4294901760) === expected;
+}
 
 // src/types/dataValue.ts
 var DataValue = class _DataValue {
@@ -1624,6 +1627,249 @@ function encodeDataValue(writer, value, encoder) {
   }
 }
 
+// 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/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/types/variant.ts
 var Variant = class _Variant {
   /**
@@ -1717,13 +1963,12 @@ var Variant = class _Variant {
     return `Variant(${typeName}: ${String(this.value)})`;
   }
   /**
-   * Creates a Variant from a typed OPC UA primitive value.
+   * Union of all OPC UA built-in types accepted by {@link Variant.newFrom}.
    *
-   * 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.
+   * 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) {
@@ -1741,12 +1986,39 @@ var Variant = class _Variant {
     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 UaPrimitive value: ${JSON.stringify(value)}`
+      `newFrom: unhandled value: ${JSON.stringify(value)}`
     );
   }
   /**
@@ -1985,149 +2257,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 +2951,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 +18240,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;