Releases: node-opcua/node-i3x
Releases · node-opcua/node-i3x
Release list
v0.10.0
node-i3x v0.10.0 — The Instance Terminology and Smart Suppression Release
This release introduces major semantic alignments with the i3X specification and working group directions. We have transitioned from the legacy Asset terminology to the standard Instance terminology, introduced Smart Folder Suppression to reduce structural noise, and automated Composition vs. Hierarchy detection based on reference types.
Key Enhancements
🚀 Renaming Asset to Instance
- Vocabulary Transition: Changed all instances of
'asset'kind to'instance'across the core domain, mapping logic, routing tables, and API responses. - Deterministic ID Generation: Mapped Element IDs are now deterministically prefixed with
instance-instead ofasset-. - API Adjustments: API queries, root node filters, and REST payloads now leverage the updated terminology for consistency.
📁 Smart Folder Suppression & Hierarchy Flattening
- Structure Suppression: Pure organizational folder types (e.g.,
FolderType,DeviceSet,Objects, andObjectsFolder) are suppressed at the bridge level. - Flat UNS Representation: Child nodes nested inside suppressed structural folders are promoted recursively up the parent chain, producing a cleaner, flatter UNS representation.
- Selective Retention: Active operational object instances (like the OPC UA
Servernode status) remain fully functional as standalone Instances.
🔌 Automatic Composition and Graph Detection
- Refined Heuristics: Automatically detects whether nested nodes represent encapsulated Compositions (
isComposition: truevia standard references likeHasComponent) or independent Hierarchies (isComposition: falsevia references likeOrganizes).
Internal & Tooling Updates
- Fully updated and verified unit and integration test coverage (446 tests passing).
- Added comprehensive conceptual guide for working group discussion:
doc/understanding_assets_vs_instances.md.
