@matter/nodejs-ble 0.16.0-alpha.0-20250912-0d12bf718 → 0.16.0-alpha.0-20250916-d577beb1d

package/README.md

@@ -4,9 +4,9 @@
 
 Matter BLE support using bleno for Peripheral/Device side and noble (not implemented yet) for Central/Controller side.
 
-> This package supports all Node.js LTS versions starting with 18.x
+> This package supports all Node.js LTS versions starting with 20.x
 
-This package contains the specific Platform implementations for Bluetooth LE with Node.js. It is designed to be used in addition to the @matter/nodejs package to enable BLE specific functionality.
+This package contains the specific Platform implementations for Bluetooth LE with Node.js. It is designed to be used in addition to the `@matter/nodejs` package to enable BLE specific functionality.
 
 ## Prerequisites and Limitations
 
@@ -25,28 +25,33 @@ The used packages have some limitations and prerequisites. Please check the Read
 > [TIP] For Linux: The :`make` and `g++` packages must be installed.
 
 ## How to use this package
-This package is designed to be used in addition to matter.ja and matter-node.js to enable BLE support. It is not intended to be used standalone.
+This package adds BLE support to matter.js on Node.js. It is not intended to be used standalone.
 
 Add this package to your package dependencies and make sure it is exactly the same version as matter.js and matter-node.js.
 
-In your code you register the BLE instance by using:
-```javascript
-import { BleNode } from "@matter/nodejs-ble";
-import { Ble } from "@matter/main";
-
-Ble.get = singleton(
-    () =>
-        new BleNode({
-          // hciId: 1, // If you need to change it from default 0 on linux systems
-        }),
-);
+In your code you register the BLE instance by importing the package:
+
+```ts
+import "@matter/nodejs-ble";
+```
+
+In addition to importing the module, you also need to explicitly enable BLE:
+
+```ts
+Environment.default.vars.set("ble.enable", true);
+```
+
+If you need to modify the HCI ID you can do so using a configuration variable:
+
+```ts
+Environment.default.vars.set("ble.hci.id", 1);
 ```
 
 The relevant classes in matter.js will detect the registration and use the BLE instance for BLE operations if needed.
 
 ## How to choose the HCI device (Linux)
 
-You can optionally set an options object when instantiating BleNode. this object can have the following properties:
+You can optionally set an options object when instantiating NodejsBle.  This object can have the following properties:
 * hciId: HCI ID (number) of the HCI device to use. If not set, ID 0 is used
 
 ## Building

package/dist/cjs/NodeJsBle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NodeJsBle.d.ts","sourceRoot":"","sources":["../../src/NodeJsBle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAKzE,MAAM,MAAM,UAAU,GAAG;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,WAAW,CAAC;CAC7B,CAAC;AAEF,qBAAa,SAAU,SAAQ,GAAG;;gBAQlB,OAAO,CAAC,EAAE,UAAU;IAmBhC,IAAI,mBAAmB,IAAI,wBAAwB,CAKlD;IAED,IAAI,gBAAgB,IAAI,YAAY,CAKnC;IAED,IAAI,OAAO,IAAI,OAAO,CAKrB;CACJ"}
+{"version":3,"file":"NodeJsBle.d.ts","sourceRoot":"","sources":["../../src/NodeJsBle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAKzE,MAAM,MAAM,UAAU,GAAG;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,WAAW,CAAC;CAC7B,CAAC;AAEF,qBAAa,SAAU,SAAQ,GAAG;;gBAQlB,OAAO,CAAC,EAAE,UAAU;IA4BhC,IAAI,mBAAmB,IAAI,wBAAwB,CAKlD;IAED,IAAI,gBAAgB,IAAI,YAAY,CAKnC;IAED,IAAI,OAAO,IAAI,OAAO,CAKrB;CACJ"}

package/dist/cjs/NodeJsBle.js

@@ -42,6 +42,15 @@ class NodeJsBle extends import_protocol.Ble {
   constructor(options) {
     super();
     this.#options = options;
+    if (options?.environment && options.hciId === void 0) {
+      const hciId = options.environment.vars.number("ble.hci.id");
+      if (hciId !== void 0) {
+        this.#options = {
+          ...options,
+          hciId
+        };
+      }
+    }
   }
   get #blePeripheralServer() {
     if (this.#blePeripheralInstance === void 0) {

package/dist/cjs/NodeJsBle.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/NodeJsBle.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,sBAA6B;AAC7B,4BAA+B;AAC/B,sCAAyC;AACzC,wBAA2B;AAC3B,6BAAyC;AACzC,4BAA+B;AAZ/B;AAAA;AAAA;AAAA;AAAA;AAmBO,MAAM,kBAAkB,oBAAI;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,SAAsB;AAC9B,UAAM;AACN,SAAK,WAAW;AAAA,EACpB;AAAA,EAEA,IAAI,uBAAuB;AACvB,QAAI,KAAK,2BAA2B,QAAW;AAC3C,WAAK,yBAAyB,IAAI,qCAAe,KAAK,QAAQ;AAAA,IAClE;AACA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,oBAAoB;AACpB,QAAI,KAAK,wBAAwB,QAAW;AACxC,WAAK,sBAAsB,IAAI,qCAAe,KAAK,QAAQ;AAAA,IAC/D;AACA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,sBAAgD;AAChD,QAAI,KAAK,4BAA4B,QAAW;AAC5C,WAAK,0BAA0B,IAAI,yDAAyB,KAAK,oBAAoB;AAAA,IACzF;AACA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,mBAAiC;AACjC,QAAI,KAAK,yBAAyB,QAAW;AACzC,WAAK,uBAAuB,IAAI,gDAAyB,KAAK,OAAqB;AAAA,IACvF;AACA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,UAAmB;AACnB,QAAI,KAAK,gBAAgB,QAAW;AAChC,WAAK,cAAc,IAAI,6BAAW,KAAK,iBAAiB;AAAA,IAC5D;AACA,WAAO,KAAK;AAAA,EAChB;AACJ;",
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,sBAA6B;AAC7B,4BAA+B;AAC/B,sCAAyC;AACzC,wBAA2B;AAC3B,6BAAyC;AACzC,4BAA+B;AAZ/B;AAAA;AAAA;AAAA;AAAA;AAmBO,MAAM,kBAAkB,oBAAI;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,SAAsB;AAC9B,UAAM;AACN,SAAK,WAAW;AAChB,QAAI,SAAS,eAAe,QAAQ,UAAU,QAAW;AACrD,YAAM,QAAQ,QAAQ,YAAY,KAAK,OAAO,YAAY;AAC1D,UAAI,UAAU,QAAW;AACrB,aAAK,WAAW;AAAA,UACZ,GAAG;AAAA,UACH;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AAAA,EAEA,IAAI,uBAAuB;AACvB,QAAI,KAAK,2BAA2B,QAAW;AAC3C,WAAK,yBAAyB,IAAI,qCAAe,KAAK,QAAQ;AAAA,IAClE;AACA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,oBAAoB;AACpB,QAAI,KAAK,wBAAwB,QAAW;AACxC,WAAK,sBAAsB,IAAI,qCAAe,KAAK,QAAQ;AAAA,IAC/D;AACA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,sBAAgD;AAChD,QAAI,KAAK,4BAA4B,QAAW;AAC5C,WAAK,0BAA0B,IAAI,yDAAyB,KAAK,oBAAoB;AAAA,IACzF;AACA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,mBAAiC;AACjC,QAAI,KAAK,yBAAyB,QAAW;AACzC,WAAK,uBAAuB,IAAI,gDAAyB,KAAK,OAAqB;AAAA,IACvF;AACA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,UAAmB;AACnB,QAAI,KAAK,gBAAgB,QAAW;AAChC,WAAK,cAAc,IAAI,6BAAW,KAAK,iBAAiB;AAAA,IAC5D;AACA,WAAO,KAAK;AAAA,EAChB;AACJ;",
   "names": []
 }

package/dist/cjs/index.d.ts

@@ -5,4 +5,5 @@
  */
 export * from "./BleScanner.js";
 export * from "./NodeJsBle.js";
+import "./install.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAE/B,OAAO,cAAc,CAAC"}

package/dist/cjs/index.js

@@ -17,6 +17,7 @@ var src_exports = {};
 module.exports = __toCommonJS(src_exports);
 __reExport(src_exports, require("./BleScanner.js"), module.exports);
 __reExport(src_exports, require("./NodeJsBle.js"), module.exports);
+var import_install = require("./install.js");
 /**
  * @license
  * Copyright 2022-2025 Matter.js Authors

package/dist/cjs/index.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/index.ts"],
-  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,wBAAc,4BANd;AAOA,wBAAc,2BAPd;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,wBAAc,4BANd;AAOA,wBAAc,2BAPd;AASA,qBAAO;AATP;AAAA;AAAA;AAAA;AAAA;",
   "names": []
 }

package/dist/cjs/install.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};
+//# sourceMappingURL=install.d.ts.map

package/dist/cjs/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/install.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/cjs/install.js

@@ -0,0 +1,29 @@
+"use strict";
+var import_general = require("#general");
+var import_protocol = require("#protocol");
+var import_NodeJsBle = require("./NodeJsBle.js");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function nodejsBle(env) {
+  let installed = false;
+  let instance = void 0;
+  env.vars.use(() => {
+    const shouldInstall = env.vars.boolean("ble.enable");
+    if (shouldInstall === installed) {
+      return;
+    }
+    if (shouldInstall) {
+      instance = new import_NodeJsBle.NodeJsBle({ environment: env });
+      env.set(import_protocol.Ble, instance);
+    } else {
+      env.delete(import_protocol.Ble, instance);
+      instance = void 0;
+    }
+    installed = shouldInstall;
+  });
+}
+import_general.ServiceBundle.default.add(nodejsBle);
+//# sourceMappingURL=install.js.map

package/dist/cjs/install.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/install.ts"],
+  "mappings": ";AAMA,qBAA2C;AAC3C,sBAAoB;AACpB,uBAA0B;AAR1B;AAAA;AAAA;AAAA;AAAA;AAUA,SAAS,UAAU,KAAkB;AACjC,MAAI,YAAY;AAChB,MAAI,WAAW;AAEf,MAAI,KAAK,IAAI,MAAM;AACf,UAAM,gBAAgB,IAAI,KAAK,QAAQ,YAAY;AACnD,QAAI,kBAAkB,WAAW;AAC7B;AAAA,IACJ;AAEA,QAAI,eAAe;AACf,iBAAW,IAAI,2BAAU,EAAE,aAAa,IAAI,CAAC;AAC7C,UAAI,IAAI,qBAAK,QAAQ;AAAA,IACzB,OAAO;AACH,UAAI,OAAO,qBAAK,QAAQ;AACxB,iBAAW;AAAA,IACf;AAEA,gBAAY;AAAA,EAChB,CAAC;AACL;AAEA,6BAAc,QAAQ,IAAI,SAAS;",
+  "names": []
+}

package/dist/esm/NodeJsBle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NodeJsBle.d.ts","sourceRoot":"","sources":["../../src/NodeJsBle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAKzE,MAAM,MAAM,UAAU,GAAG;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,WAAW,CAAC;CAC7B,CAAC;AAEF,qBAAa,SAAU,SAAQ,GAAG;;gBAQlB,OAAO,CAAC,EAAE,UAAU;IAmBhC,IAAI,mBAAmB,IAAI,wBAAwB,CAKlD;IAED,IAAI,gBAAgB,IAAI,YAAY,CAKnC;IAED,IAAI,OAAO,IAAI,OAAO,CAKrB;CACJ"}
+{"version":3,"file":"NodeJsBle.d.ts","sourceRoot":"","sources":["../../src/NodeJsBle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAKzE,MAAM,MAAM,UAAU,GAAG;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,WAAW,CAAC;CAC7B,CAAC;AAEF,qBAAa,SAAU,SAAQ,GAAG;;gBAQlB,OAAO,CAAC,EAAE,UAAU;IA4BhC,IAAI,mBAAmB,IAAI,wBAAwB,CAKlD;IAED,IAAI,gBAAgB,IAAI,YAAY,CAKnC;IAED,IAAI,OAAO,IAAI,OAAO,CAKrB;CACJ"}

package/dist/esm/NodeJsBle.js

@@ -19,6 +19,15 @@ class NodeJsBle extends Ble {
   constructor(options) {
     super();
     this.#options = options;
+    if (options?.environment && options.hciId === void 0) {
+      const hciId = options.environment.vars.number("ble.hci.id");
+      if (hciId !== void 0) {
+        this.#options = {
+          ...options,
+          hciId
+        };
+      }
+    }
   }
   get #blePeripheralServer() {
     if (this.#blePeripheralInstance === void 0) {

package/dist/esm/NodeJsBle.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/NodeJsBle.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAS,WAAoB;AAC7B,SAAS,sBAAsB;AAC/B,SAAS,gCAAgC;AACzC,SAAS,kBAAkB;AAC3B,SAAS,gCAAgC;AACzC,SAAS,sBAAsB;AAOxB,MAAM,kBAAkB,IAAI;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,SAAsB;AAC9B,UAAM;AACN,SAAK,WAAW;AAAA,EACpB;AAAA,EAEA,IAAI,uBAAuB;AACvB,QAAI,KAAK,2BAA2B,QAAW;AAC3C,WAAK,yBAAyB,IAAI,eAAe,KAAK,QAAQ;AAAA,IAClE;AACA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,oBAAoB;AACpB,QAAI,KAAK,wBAAwB,QAAW;AACxC,WAAK,sBAAsB,IAAI,eAAe,KAAK,QAAQ;AAAA,IAC/D;AACA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,sBAAgD;AAChD,QAAI,KAAK,4BAA4B,QAAW;AAC5C,WAAK,0BAA0B,IAAI,yBAAyB,KAAK,oBAAoB;AAAA,IACzF;AACA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,mBAAiC;AACjC,QAAI,KAAK,yBAAyB,QAAW;AACzC,WAAK,uBAAuB,IAAI,yBAAyB,KAAK,OAAqB;AAAA,IACvF;AACA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,UAAmB;AACnB,QAAI,KAAK,gBAAgB,QAAW;AAChC,WAAK,cAAc,IAAI,WAAW,KAAK,iBAAiB;AAAA,IAC5D;AACA,WAAO,KAAK;AAAA,EAChB;AACJ;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAS,WAAoB;AAC7B,SAAS,sBAAsB;AAC/B,SAAS,gCAAgC;AACzC,SAAS,kBAAkB;AAC3B,SAAS,gCAAgC;AACzC,SAAS,sBAAsB;AAOxB,MAAM,kBAAkB,IAAI;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,SAAsB;AAC9B,UAAM;AACN,SAAK,WAAW;AAChB,QAAI,SAAS,eAAe,QAAQ,UAAU,QAAW;AACrD,YAAM,QAAQ,QAAQ,YAAY,KAAK,OAAO,YAAY;AAC1D,UAAI,UAAU,QAAW;AACrB,aAAK,WAAW;AAAA,UACZ,GAAG;AAAA,UACH;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AAAA,EAEA,IAAI,uBAAuB;AACvB,QAAI,KAAK,2BAA2B,QAAW;AAC3C,WAAK,yBAAyB,IAAI,eAAe,KAAK,QAAQ;AAAA,IAClE;AACA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,oBAAoB;AACpB,QAAI,KAAK,wBAAwB,QAAW;AACxC,WAAK,sBAAsB,IAAI,eAAe,KAAK,QAAQ;AAAA,IAC/D;AACA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,sBAAgD;AAChD,QAAI,KAAK,4BAA4B,QAAW;AAC5C,WAAK,0BAA0B,IAAI,yBAAyB,KAAK,oBAAoB;AAAA,IACzF;AACA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,mBAAiC;AACjC,QAAI,KAAK,yBAAyB,QAAW;AACzC,WAAK,uBAAuB,IAAI,yBAAyB,KAAK,OAAqB;AAAA,IACvF;AACA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,UAAmB;AACnB,QAAI,KAAK,gBAAgB,QAAW;AAChC,WAAK,cAAc,IAAI,WAAW,KAAK,iBAAiB;AAAA,IAC5D;AACA,WAAO,KAAK;AAAA,EAChB;AACJ;",
   "names": []
 }

package/dist/esm/index.d.ts

@@ -5,4 +5,5 @@
  */
 export * from "./BleScanner.js";
 export * from "./NodeJsBle.js";
+import "./install.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAE/B,OAAO,cAAc,CAAC"}

package/dist/esm/index.js

@@ -5,4 +5,5 @@
  */
 export * from "./BleScanner.js";
 export * from "./NodeJsBle.js";
+import "./install.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/index.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;AACd,cAAc;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;AACd,cAAc;AAEd,OAAO;",
   "names": []
 }

package/dist/esm/install.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};
+//# sourceMappingURL=install.d.ts.map

package/dist/esm/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/install.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/esm/install.js

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ServiceBundle } from "#general";
+import { Ble } from "#protocol";
+import { NodeJsBle } from "./NodeJsBle.js";
+function nodejsBle(env) {
+  let installed = false;
+  let instance = void 0;
+  env.vars.use(() => {
+    const shouldInstall = env.vars.boolean("ble.enable");
+    if (shouldInstall === installed) {
+      return;
+    }
+    if (shouldInstall) {
+      instance = new NodeJsBle({ environment: env });
+      env.set(Ble, instance);
+    } else {
+      env.delete(Ble, instance);
+      instance = void 0;
+    }
+    installed = shouldInstall;
+  });
+}
+ServiceBundle.default.add(nodejsBle);
+//# sourceMappingURL=install.js.map

package/dist/esm/install.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/install.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAsB,qBAAqB;AAC3C,SAAS,WAAW;AACpB,SAAS,iBAAiB;AAE1B,SAAS,UAAU,KAAkB;AACjC,MAAI,YAAY;AAChB,MAAI,WAAW;AAEf,MAAI,KAAK,IAAI,MAAM;AACf,UAAM,gBAAgB,IAAI,KAAK,QAAQ,YAAY;AACnD,QAAI,kBAAkB,WAAW;AAC7B;AAAA,IACJ;AAEA,QAAI,eAAe;AACf,iBAAW,IAAI,UAAU,EAAE,aAAa,IAAI,CAAC;AAC7C,UAAI,IAAI,KAAK,QAAQ;AAAA,IACzB,OAAO;AACH,UAAI,OAAO,KAAK,QAAQ;AACxB,iBAAW;AAAA,IACf;AAEA,gBAAY;AAAA,EAChB,CAAC;AACL;AAEA,cAAc,QAAQ,IAAI,SAAS;",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@matter/nodejs-ble",
-    "version": "0.16.0-alpha.0-20250912-0d12bf718",
+    "version": "0.16.0-alpha.0-20250916-d577beb1d",
     "description": "Matter BLE support for node.js",
     "keywords": [
         "iot",
@@ -28,16 +28,16 @@
         "build-clean": "matter-build --clean"
     },
     "dependencies": {
-        "@matter/general": "0.16.0-alpha.0-20250912-0d12bf718",
-        "@matter/protocol": "0.16.0-alpha.0-20250912-0d12bf718",
-        "@matter/types": "0.16.0-alpha.0-20250912-0d12bf718"
+        "@matter/general": "0.16.0-alpha.0-20250916-d577beb1d",
+        "@matter/protocol": "0.16.0-alpha.0-20250916-d577beb1d",
+        "@matter/types": "0.16.0-alpha.0-20250916-d577beb1d"
     },
     "devDependencies": {
-        "@matter/tools": "0.16.0-alpha.0-20250912-0d12bf718"
+        "@matter/tools": "0.16.0-alpha.0-20250916-d577beb1d"
     },
     "optionalDependencies": {
         "@stoprocent/bleno": "^0.11.4",
-        "@stoprocent/noble": "^2.3.5"
+        "@stoprocent/noble": "^2.3.6"
     },
     "engines": {
         "node": ">=20.19.0 <22.0.0 || >=22.13.0"

package/src/NodeJsBle.ts

@@ -28,6 +28,15 @@ export class NodeJsBle extends Ble {
     constructor(options?: BleOptions) {
         super();
         this.#options = options;
+        if (options?.environment && options.hciId === undefined) {
+            const hciId = options.environment.vars.number("ble.hci.id");
+            if (hciId !== undefined) {
+                this.#options = {
+                    ...options,
+                    hciId,
+                };
+            }
+        }
     }
 
     get #blePeripheralServer() {

package/src/index.ts

@@ -6,3 +6,5 @@
 
 export * from "./BleScanner.js";
 export * from "./NodeJsBle.js";
+
+import "./install.js";

package/src/install.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { Environment, ServiceBundle } from "#general";
+import { Ble } from "#protocol";
+import { NodeJsBle } from "./NodeJsBle.js";
+
+function nodejsBle(env: Environment) {
+    let installed = false;
+    let instance = undefined as undefined | Ble;
+
+    env.vars.use(() => {
+        const shouldInstall = env.vars.boolean("ble.enable");
+        if (shouldInstall === installed) {
+            return;
+        }
+
+        if (shouldInstall) {
+            instance = new NodeJsBle({ environment: env });
+            env.set(Ble, instance);
+        } else {
+            env.delete(Ble, instance);
+            instance = undefined;
+        }
+
+        installed = shouldInstall;
+    });
+}
+
+ServiceBundle.default.add(nodejsBle);