chore: release v0.9.7

erossignon · erossignon · commit 712aab0a9a7a · 2026-07-13T16:51:35.000+02:00
diff --git a/doc/mapping-datatype-valuerank-to-json-schema.md b/doc/mapping-datatype-valuerank-to-json-schema.md
diff --git a/packages/app/CHANGELOG.md b/packages/app/CHANGELOG.md
@@ -1,5 +1,9 @@
 # @node-i3x/app
 
+## 0.9.7 (2026-07-13)
+
+- docs(github): modernize issue templates and support files
+
 ## 0.9.6 (2026-06-30)
 
 - docs: add live testing info and dashboard image to README
diff --git a/packages/app/package.json b/packages/app/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@node-i3x/app",
-  "version": "0.9.6",
+  "version": "0.9.7",
   "description": "i3X CLI -- expose OPC UA servers as i3X REST APIs",
   "license": "AGPL-3.0-or-later OR LicenseRef-Sterfive-Commercial",
   "author": "Sterfive SAS <contact@sterfive.com> (https://sterfive.com)",
@@ -40,9 +40,9 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@node-i3x/core": "0.9.6",
-    "@node-i3x/opcua-connector": "0.9.6",
-    "@node-i3x/rest-server": "0.9.6",
+    "@node-i3x/core": "0.9.7",
+    "@node-i3x/opcua-connector": "0.9.7",
+    "@node-i3x/rest-server": "0.9.7",
     "commander": "^15.0.0",
     "cosmiconfig": "^9.0.2",
     "fastify": "^5.8.5",
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
@@ -1,5 +1,9 @@
 # @node-i3x/core
 
+## 0.9.7 (2026-07-13)
+
+- docs(github): modernize issue templates and support files
+
 ## 0.9.6 (2026-06-30)
 
 - docs: add live testing info and dashboard image to README
diff --git a/packages/core/package.json b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@node-i3x/core",
-  "version": "0.9.6",
+  "version": "0.9.7",
   "description": "i3X domain core — models, ports, and services (zero dependencies)",
   "license": "AGPL-3.0-or-later OR LicenseRef-Sterfive-Commercial",
   "author": "Sterfive SAS <contact@sterfive.com> (https://sterfive.com)",
diff --git a/packages/demo-embedded/CHANGELOG.md b/packages/demo-embedded/CHANGELOG.md
@@ -1,5 +1,9 @@
 # @node-i3x/demo-embedded
 
+## 0.9.7 (2026-07-13)
+
+- docs(github): modernize issue templates and support files
+
 ## 0.9.6 (2026-06-30)
 
 - docs: add live testing info and dashboard image to README
diff --git a/packages/demo-embedded/package.json b/packages/demo-embedded/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@node-i3x/demo-embedded",
-  "version": "0.9.6",
+  "version": "0.9.7",
   "license": "AGPL-3.0-or-later OR LicenseRef-Sterfive-Commercial",
   "author": "Sterfive SAS <contact@sterfive.com> (https://sterfive.com)",
   "homepage": "https://sterfive.com",
@@ -41,10 +41,10 @@
     "client": "npx tsx src/client.ts"
   },
   "dependencies": {
-    "@node-i3x/core": "0.9.6",
-    "@node-i3x/opcua-connector": "0.9.6",
-    "@node-i3x/pseudo-session-connector": "0.9.6",
-    "@node-i3x/rest-server": "0.9.6",
+    "@node-i3x/core": "0.9.7",
+    "@node-i3x/opcua-connector": "0.9.7",
+    "@node-i3x/pseudo-session-connector": "0.9.7",
+    "@node-i3x/rest-server": "0.9.7",
     "fastify": "^5.8.5",
     "@fastify/cors": "^11.2.0",
     "fastify-plugin": "^6.0.0",
diff --git a/packages/opcua-connector/CHANGELOG.md b/packages/opcua-connector/CHANGELOG.md
@@ -1,5 +1,9 @@
 # @node-i3x/opcua-connector
 
+## 0.9.7 (2026-07-13)
+
+- docs(github): modernize issue templates and support files
+
 ## 0.9.6 (2026-06-30)
 
 - docs: add live testing info and dashboard image to README
diff --git a/packages/opcua-connector/package.json b/packages/opcua-connector/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@node-i3x/opcua-connector",
-  "version": "0.9.6",
+  "version": "0.9.7",
   "description": "i3X OPC UA adapter — implements IDataSourcePort using node-opcua",
   "license": "AGPL-3.0-or-later OR LicenseRef-Sterfive-Commercial",
   "author": "Sterfive SAS <contact@sterfive.com> (https://sterfive.com)",
@@ -58,7 +58,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@node-i3x/core": "0.9.6",
+    "@node-i3x/core": "0.9.7",
     "node-opcua": "^2.173.1",
     "node-opcua-certificate-manager": "^2.173.0",
     "node-opcua-client": "^2.173.1",
diff --git a/packages/opcua-connector/src/opcua-client.ts b/packages/opcua-connector/src/opcua-client.ts
@@ -141,6 +141,14 @@ function validateOpcUaClientOptions(opts: OpcUaClientOptions): void {
       throw new Error('OPC UA browseFilter array must contain only strings');
     }
   }
+  if (opts.browseMaxDepth !== undefined) {
+    if (
+      typeof opts.browseMaxDepth !== 'number' ||
+      !Number.isInteger(opts.browseMaxDepth)
+    ) {
+      throw new Error('OPC UA browseMaxDepth must be an integer');
+    }
+  }
   const stringFields: (keyof OpcUaClientOptions)[] = [
     'username',
     'password',
@@ -185,7 +193,12 @@ export class OpcUaClient {
   > &
     Pick<
       OpcUaClientOptions,
-      'username' | 'password' | 'applicationUri' | 'pkiFolder' | 'certificateSubject'
+      | 'username'
+      | 'password'
+      | 'applicationUri'
+      | 'pkiFolder'
+      | 'certificateSubject'
+      | 'browseMaxDepth'
     >;
 
   constructor(
@@ -206,6 +219,7 @@ export class OpcUaClient {
       applicationUri: opts.applicationUri,
       pkiFolder: opts.pkiFolder,
       certificateSubject: opts.certificateSubject,
+      browseMaxDepth: opts.browseMaxDepth ?? 25,
     };
   }
 
@@ -504,8 +518,8 @@ export class OpcUaClient {
     const visited = new Set<string>();
     let totalTx = 0;
 
-    let frontier: Array<{ nodeId: string; parentId: string | null }> = [
-      { nodeId: seedNodeId, parentId: null },
+    let frontier: Array<{ nodeId: string; parentId: string | null; depth: number }> = [
+      { nodeId: seedNodeId, parentId: null, depth: 0 },
     ];
 
     const useParallel = this._opts.browseStrategy !== 'browseAll';
@@ -555,10 +569,19 @@ export class OpcUaClient {
             if (m !== null) output.push(m);
           }
 
-          if (!shouldRecurse || shouldRecurse(ref, item.nodeId)) {
+          const maxDepth = this._opts.browseMaxDepth;
+          const nextDepth = item.depth + 1;
+          const canRecurse =
+            maxDepth === undefined || maxDepth < 0 || nextDepth <= maxDepth;
+
+          if (canRecurse && (!shouldRecurse || shouldRecurse(ref, item.nodeId))) {
             if (!queued.has(childId)) {
               queued.add(childId);
-              nextFrontier.push({ nodeId: childId, parentId: item.nodeId });
+              nextFrontier.push({
+                nodeId: childId,
+                parentId: item.nodeId,
+                depth: nextDepth,
+              });
             }
           }
         }
diff --git a/packages/opcua-connector/src/opcua-types.ts b/packages/opcua-connector/src/opcua-types.ts
@@ -65,6 +65,12 @@ export interface OpcUaClientOptions {
    *   to include (e.g. `['ns=1;s=SmartFactory']`).
    */
   browseFilter?: BrowseFilter;
+  /**
+   * Maximum depth to crawl during BFS browsing.
+   * A negative value (e.g. -1) means unlimited.
+   * @default 25
+   */
+  browseMaxDepth?: number;
   /** OPC UA username for UserName identity token. */
   username?: string;
   /** OPC UA password for UserName identity token. */
diff --git a/packages/pseudo-session-connector/CHANGELOG.md b/packages/pseudo-session-connector/CHANGELOG.md
@@ -1,5 +1,9 @@
 # @node-i3x/pseudo-session-connector
 
+## 0.9.7 (2026-07-13)
+
+- docs(github): modernize issue templates and support files
+
 ## 0.9.6 (2026-06-30)
 
 - docs: add live testing info and dashboard image to README
diff --git a/packages/pseudo-session-connector/package.json b/packages/pseudo-session-connector/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@node-i3x/pseudo-session-connector",
-  "version": "0.9.6",
+  "version": "0.9.7",
   "description": "i3X data-source adapter using node-opcua PseudoSession — connects directly to an AddressSpace without binary OPC UA transport",
   "license": "AGPL-3.0-or-later OR LicenseRef-Sterfive-Commercial",
   "author": "Sterfive SAS <contact@sterfive.com> (https://sterfive.com)",
@@ -57,7 +57,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@node-i3x/core": "0.9.6",
+    "@node-i3x/core": "0.9.7",
     "node-opcua-address-space": "^2.173.1",
     "node-opcua-address-space-base": "^2.173.0",
     "node-opcua-data-model": "^2.173.0",
diff --git a/packages/rest-server/CHANGELOG.md b/packages/rest-server/CHANGELOG.md
@@ -1,5 +1,9 @@
 # @node-i3x/rest-server
 
+## 0.9.7 (2026-07-13)
+
+- docs(github): modernize issue templates and support files
+
 ## 0.9.6 (2026-06-30)
 
 - docs: add live testing info and dashboard image to README
diff --git a/packages/rest-server/package.json b/packages/rest-server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@node-i3x/rest-server",
-  "version": "0.9.6",
+  "version": "0.9.7",
   "description": "i3X REST inbound adapter — Fastify routes for the i3X Beta API",
   "license": "AGPL-3.0-or-later OR LicenseRef-Sterfive-Commercial",
   "author": "Sterfive SAS <contact@sterfive.com> (https://sterfive.com)",
@@ -61,7 +61,7 @@
     "@fastify/cors": "^11.2.0",
     "@fastify/swagger": "^9.7.0",
     "@fastify/swagger-ui": "^6.0.0",
-    "@node-i3x/core": "0.9.6",
+    "@node-i3x/core": "0.9.7",
     "fastify": "^5.8.5",
     "fastify-plugin": "^6.0.0"
   }
diff --git a/scripts/milo-testbed.ts b/scripts/milo-testbed.ts
@@ -0,0 +1,65 @@
+/**
+ * Milo test bed with depth limit to prove limited crawling time.
+ * Run with:
+ *   npx tsx scripts/milo-testbed.ts
+ */
+process.env.NODEOPCUADEBUG = 'CLIENT{TRACE}';
+
+import { performance } from 'node:perf_hooks';
+import { consoleLogger, ModelService } from '@node-i3x/core';
+import { OpcUaClient, OpcUaDataSourceAdapter } from '@node-i3x/opcua-connector';
+
+const endpoint = 'opc.tcp://milo.digitalpetri.com:62541/milo';
+const logger = consoleLogger;
+
+function elapsed(start: number): string {
+  return `${(performance.now() - start).toFixed(0)}ms`;
+}
+
+async function main() {
+  console.log('═══════════════════════════════════════════');
+  console.log('  Milo Limited Crawl Test Bed');
+  console.log(`  Endpoint: ${endpoint}`);
+  console.log('  Max Depth: 50');
+  console.log('═══════════════════════════════════════════\n');
+
+  let t = performance.now();
+  console.log('⏳ Connecting to Milo OPC UA server...');
+
+  const opcuaClient = new OpcUaClient(
+    {
+      endpointUrl: endpoint,
+      securityMode: 'None',
+      optimizedClient: 'auto',
+      browseMaxDepth: 50, // limit depth to 50
+    },
+    logger,
+  );
+  const dataSource = new OpcUaDataSourceAdapter(opcuaClient, logger);
+  await dataSource.connect();
+  console.log(`✅ Connected in ${elapsed(t)}\n`);
+
+  const modelService = new ModelService(dataSource, logger);
+
+  t = performance.now();
+  console.log('⏳ Preloading model (browseTree) with Depth Limit = 50...');
+  const model = await modelService.preloadModel();
+  const modelMs = elapsed(t);
+  console.log(
+    `✅ Model loaded successfully: ${model.nodesById.size} nodes, ` +
+      `${model.rootIds.length} roots in ${modelMs}\n`,
+  );
+
+  console.log('═══════════════════════════════════════════');
+  console.log(`  Crawl finished in ${modelMs}`);
+  console.log(`  Discovered ${model.nodesById.size} nodes within depth 50.`);
+  console.log('═══════════════════════════════════════════\n');
+
+  await dataSource.disconnect();
+  process.exit(0);
+}
+
+main().catch((err) => {
+  console.error('❌ Fatal error:', err);
+  process.exit(1);
+});

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@node-i3x/core",`
`3`		`- "version": "0.9.6",`
	`3`	`+ "version": "0.9.7",`
`4`	`4`	`"description": "i3X domain core — models, ports, and services (zero dependencies)",`
`5`	`5`	`"license": "AGPL-3.0-or-later OR LicenseRef-Sterfive-Commercial",`
`6`	`6`	`"author": "Sterfive SAS <contact@sterfive.com> (https://sterfive.com)",`