node-red-contrib-ble-scanner 0.0.1

package/dist/reader.js

@@ -0,0 +1,143 @@
+import { setTimeout as delay } from 'node:timers/promises';
+import { DEFAULTS } from './constants.js';
+import { bluezBackend } from './ble/bluez.js';
+import { nobleBackend } from './ble/noble.js';
+import { displayDevice, normalizeUuid } from './ble/utils.js';
+export async function discoverDevices(options = {}) {
+    const logger = options.logger || (() => { });
+    const bluetooth = options.bluetooth || 'auto';
+    const backend = await selectBluetoothBackend(bluetooth, logger);
+    try {
+        return await backend.discover({
+            namePrefix: options.namePrefix ?? DEFAULTS.namePrefix,
+            deviceName: options.deviceName || null,
+            timeoutMs: options.timeoutMs || DEFAULTS.timeoutMs,
+            scanServiceUuid: options.scanServiceUuid ?? null,
+            matchServiceUuid: options.matchServiceUuid ?? null,
+            logger
+        });
+    }
+    catch (error) {
+        if (bluetooth === 'auto' && isBluetoothUnavailableError(error)) {
+            logger(`No usable Bluetooth backend found: ${error instanceof Error ? error.message : String(error)}.`);
+            return [];
+        }
+        throw error;
+    }
+}
+export async function readDevices(options = {}) {
+    const logger = options.logger || (() => { });
+    const devices = await discoverDevices({ ...options, logger });
+    const readings = [];
+    for (const device of devices) {
+        logger(`Reading raw BLE notifications from ${displayDevice(device)}.`);
+        readings.push(await readDevice(device, { ...options, logger }));
+    }
+    return readings;
+}
+export async function readDevice(device, options = {}) {
+    const reader = await connectDevice(device, options);
+    try {
+        return await reader.read(options);
+    }
+    finally {
+        await reader.disconnect().catch(() => { });
+    }
+}
+export async function connectReaders(options = {}) {
+    const logger = options.logger || (() => { });
+    const devices = await discoverDevices({ ...options, logger });
+    const readers = [];
+    try {
+        for (const device of devices) {
+            logger(`Connecting ${displayDevice(device)}.`);
+            readers.push(await connectDevice(device, { ...options, logger }));
+        }
+        return readers;
+    }
+    catch (error) {
+        await Promise.all(readers.map((reader) => reader.disconnect().catch(() => { })));
+        throw error;
+    }
+}
+export async function connectDevice(device, options = {}) {
+    const logger = options.logger || (() => { });
+    const backend = backendForDevice(device);
+    const notifyUuid = normalizeUuid(options.notifyUuid || DEFAULTS.notifyUuid);
+    const session = await backend.connect({
+        device,
+        timeoutMs: options.timeoutMs || DEFAULTS.timeoutMs,
+        connectTimeoutMs: options.connectTimeoutMs || DEFAULTS.connectTimeoutMs,
+        notifyUuid,
+        logger
+    });
+    let disconnected = false;
+    return {
+        device: session.device,
+        read: (readOptions) => readSession(session, { ...options, ...readOptions, notifyUuid, logger }),
+        disconnect: async () => {
+            if (disconnected)
+                return;
+            disconnected = true;
+            await session.disconnect();
+        }
+    };
+}
+export async function readSession(session, options = {}) {
+    const logger = options.logger || (() => { });
+    const listenMs = options.listenMs ?? DEFAULTS.listenMs;
+    const notifyUuid = normalizeUuid(options.notifyUuid || session.notify.uuid || DEFAULTS.notifyUuid);
+    const messages = [];
+    const onData = (data) => {
+        const raw = Buffer.from(data);
+        const message = {
+            timestamp: new Date().toISOString(),
+            uuid: session.notify.uuid,
+            length: raw.length,
+            data: raw,
+            hex: raw.toString('hex'),
+            base64: raw.toString('base64'),
+            bytes: [...raw]
+        };
+        logger(`BLE notification ${message.hex} (${message.length} byte${message.length === 1 ? '' : 's'}).`);
+        messages.push(message);
+    };
+    session.notify.onData(onData);
+    try {
+        logger(`Listening for ${listenMs}ms on characteristic ${notifyUuid}.`);
+        await delay(listenMs);
+    }
+    finally {
+        session.notify.removeDataListener(onData);
+    }
+    return {
+        device: session.device,
+        timestamp: new Date().toISOString(),
+        notifyUuid,
+        messages
+    };
+}
+export async function shutdownBluetooth() {
+    await Promise.all([nobleBackend.shutdown(), bluezBackend.shutdown()]);
+}
+async function selectBluetoothBackend(bluetooth, logger) {
+    if (bluetooth === 'bluez')
+        return bluezBackend;
+    if (bluetooth === 'noble')
+        return nobleBackend;
+    if (await bluezBackend.isAvailable(logger))
+        return bluezBackend;
+    return nobleBackend;
+}
+function backendForDevice(device) {
+    const backends = {
+        bluez: bluezBackend,
+        noble: nobleBackend
+    };
+    return backends[device.backend];
+}
+function isBluetoothUnavailableError(error) {
+    const message = error instanceof Error ? error.message.toLowerCase() : String(error).toLowerCase();
+    return message.includes('bluetooth adapter state is unsupported') || message.includes('no compatible bluetooth') || message.includes('not available on');
+}
+//# sourceMappingURL=reader.js.map

package/dist/reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../src/reader.ts"],"names":[],"mappings":"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"}

package/nodes/ble-reader-device.html

@@ -0,0 +1,135 @@
+<script type="text/javascript">
+  RED.nodes.registerType('ble-reader-device', {
+    category: 'config',
+    defaults: {
+      name: { value: '' },
+      bluetooth: { value: 'auto' },
+      namePrefix: { value: '' },
+      serviceUuid: { value: '' },
+      notifyUuid: { value: 'fff1', required: true },
+      listenMs: { value: 5000, required: true, validate: RED.validators.number() },
+      targetMode: { value: 'all' },
+      deviceName: { value: '' }
+    },
+    label: function () {
+      return this.name || this.deviceName || 'BLE reader';
+    },
+    oneditprepare: function () {
+      var deviceSelect = $('#node-config-input-deviceNameSelect');
+      var deviceName = $('#node-config-input-deviceName');
+      var targetMode = $('#node-config-input-targetMode');
+      var searchButton = $('#node-config-input-search');
+      var searchStatus = $('#node-config-input-search-status');
+
+      function hasOption(value) {
+        var found = false;
+        deviceSelect.find('option').each(function () {
+          if ($(this).attr('value') === value) found = true;
+        });
+        return found;
+      }
+
+      function setSelected(mode, name) {
+        targetMode.val(mode);
+        deviceName.val(name || '');
+        deviceSelect.val(mode === 'all' ? '' : name);
+      }
+
+      function ensureCurrentOption() {
+        var currentName = deviceName.val();
+        if (currentName && !hasOption(currentName)) {
+          deviceSelect.append($('<option></option>').attr('value', currentName).text(currentName));
+        }
+        setSelected(targetMode.val() || (currentName ? 'name' : 'all'), currentName);
+      }
+
+      deviceSelect.on('change', function () {
+        var selected = deviceSelect.val();
+        setSelected(selected ? 'name' : 'all', selected);
+      });
+
+      searchButton.on('click', function () {
+        searchButton.prop('disabled', true);
+        searchStatus.text('searching...');
+        $.getJSON('ble-reader/devices', {
+          bluetooth: $('#node-config-input-bluetooth').val(),
+          namePrefix: $('#node-config-input-namePrefix').val(),
+          serviceUuid: $('#node-config-input-serviceUuid').val()
+        })
+          .done(function (devices) {
+            var previous = deviceName.val();
+            deviceSelect.empty();
+            deviceSelect.append($('<option></option>').attr('value', '').text('All discovered devices'));
+            devices.forEach(function (device) {
+              if (!device.name) return;
+              var details = device.address ? ' (' + device.address + ')' : '';
+              deviceSelect.append($('<option></option>').attr('value', device.name).text(device.name + details));
+            });
+            if (previous && hasOption(previous)) {
+              setSelected('name', previous);
+            } else {
+              setSelected('all', '');
+            }
+            searchStatus.text(devices.length + ' found');
+          })
+          .fail(function (xhr) {
+            var response = xhr.responseJSON || {};
+            searchStatus.text(response.error || 'search failed');
+          })
+          .always(function () {
+            searchButton.prop('disabled', false);
+          });
+      });
+
+      ensureCurrentOption();
+    }
+  });
+</script>
+
+<script type="text/html" data-template-name="ble-reader-device">
+  <div class="form-row">
+    <label for="node-config-input-name"><i class="fa fa-tag"></i> Name</label>
+    <input type="text" id="node-config-input-name">
+  </div>
+  <div class="form-row">
+    <label for="node-config-input-bluetooth"><i class="fa fa-bluetooth"></i> Bluetooth</label>
+    <select id="node-config-input-bluetooth">
+      <option value="auto">auto</option>
+      <option value="bluez">bluez</option>
+      <option value="noble">noble</option>
+    </select>
+  </div>
+  <div class="form-row">
+    <label for="node-config-input-namePrefix"><i class="fa fa-filter"></i> Name prefix</label>
+    <input type="text" id="node-config-input-namePrefix" placeholder="optional">
+  </div>
+  <div class="form-row">
+    <label for="node-config-input-serviceUuid"><i class="fa fa-filter"></i> Service UUID</label>
+    <input type="text" id="node-config-input-serviceUuid" placeholder="optional">
+  </div>
+  <div class="form-row">
+    <label for="node-config-input-notifyUuid"><i class="fa fa-bell"></i> Notify UUID</label>
+    <input type="text" id="node-config-input-notifyUuid" placeholder="fff1">
+  </div>
+  <div class="form-row">
+    <label for="node-config-input-listenMs"><i class="fa fa-clock-o"></i> Listen ms</label>
+    <input type="number" id="node-config-input-listenMs" min="0" step="100">
+  </div>
+  <div class="form-row">
+    <label for="node-config-input-deviceNameSelect"><i class="fa fa-search"></i> Device</label>
+    <select id="node-config-input-deviceNameSelect" style="width:60%;">
+      <option value="">All discovered devices</option>
+    </select>
+    <button type="button" id="node-config-input-search" class="red-ui-button" style="margin-left:4px;">Search</button>
+    <input type="hidden" id="node-config-input-targetMode">
+    <input type="hidden" id="node-config-input-deviceName">
+  </div>
+  <div class="form-row">
+    <label></label>
+    <span id="node-config-input-search-status" style="color:#666;"></span>
+  </div>
+</script>
+
+<script type="text/html" data-help-name="ble-reader-device">
+  <p>Configures BLE discovery and the notification characteristic used by the raw reader.</p>
+</script>

package/nodes/ble-reader-device.js

@@ -0,0 +1,61 @@
+'use strict';
+
+module.exports = function registerBleReaderDeviceNode(RED) {
+  const loadLibrary = async () => import('../dist/index.js');
+
+  function BleReaderDeviceNode(config) {
+    RED.nodes.createNode(this, config);
+    const node = this;
+
+    node.name = config.name;
+    node.bluetooth = config.bluetooth || 'auto';
+    node.namePrefix = config.namePrefix || '';
+    node.serviceUuid = config.serviceUuid || '';
+    node.notifyUuid = config.notifyUuid || 'fff1';
+    node.listenMs = Number(config.listenMs || 5000);
+    node.targetMode = config.targetMode || 'all';
+    node.deviceName = config.deviceName || '';
+    node.queue = Promise.resolve();
+
+    node.loadLibrary = loadLibrary;
+
+    node.enqueue = async (operation) => {
+      const run = node.queue.then(async () => {
+        const ble = await node.loadLibrary();
+        return operation(ble);
+      });
+      node.queue = run.catch(() => {});
+      return run;
+    };
+
+    node.on('close', (_removed, done) => {
+      node.loadLibrary()
+        .then((ble) => ble.shutdownBluetooth())
+        .catch(() => {})
+        .finally(done);
+    });
+  }
+
+  RED.nodes.registerType('ble-reader-device', BleReaderDeviceNode);
+
+  const permission = RED.auth?.needsPermission ? RED.auth.needsPermission('flows.read') : (_req, _res, next) => next();
+  RED.httpAdmin.get('/ble-reader/devices', permission, async (req, res) => {
+    try {
+      const ble = await loadLibrary();
+      const serviceUuid = typeof req.query.serviceUuid === 'string' && req.query.serviceUuid ? req.query.serviceUuid : null;
+      const devices = await ble.discoverDevices({
+        bluetooth: normalizeBluetooth(req.query.bluetooth),
+        namePrefix: typeof req.query.namePrefix === 'string' ? req.query.namePrefix : '',
+        scanServiceUuid: serviceUuid,
+        matchServiceUuid: serviceUuid
+      });
+      res.json(devices);
+    } catch (error) {
+      res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
+    }
+  });
+};
+
+function normalizeBluetooth(value) {
+  return value === 'bluez' || value === 'noble' || value === 'auto' ? value : 'auto';
+}

package/nodes/ble-reader-read.html

@@ -0,0 +1,38 @@
+<script type="text/javascript">
+  RED.nodes.registerType('ble-reader-read', {
+    category: 'BLE',
+    color: '#d8eef8',
+    defaults: {
+      name: { value: '' },
+      device: { type: 'ble-reader-device', required: true },
+      listenMs: { value: 0, validate: RED.validators.number() }
+    },
+    inputs: 1,
+    outputs: 1,
+    icon: 'font-awesome/fa-bluetooth',
+    label: function () {
+      return this.name || 'BLE read';
+    }
+  });
+</script>
+
+<script type="text/html" data-template-name="ble-reader-read">
+  <div class="form-row">
+    <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+    <input type="text" id="node-input-name">
+  </div>
+  <div class="form-row">
+    <label for="node-input-device"><i class="fa fa-bluetooth"></i> Device</label>
+    <input type="text" id="node-input-device">
+  </div>
+  <div class="form-row">
+    <label for="node-input-listenMs"><i class="fa fa-clock-o"></i> Listen ms</label>
+    <input type="number" id="node-input-listenMs" min="0" step="100" placeholder="use config">
+  </div>
+</script>
+
+<script type="text/html" data-help-name="ble-reader-read">
+  <p>Collects raw BLE notifications. Output <code>msg.payload</code> is an array with one entry per matching device.</p>
+  <p>Each message contains <code>data</code> as a Buffer plus <code>hex</code>, <code>base64</code>, <code>bytes</code>, <code>length</code>, and <code>timestamp</code>.</p>
+  <p>Incoming <code>msg.payload</code> may contain <code>{ deviceName, listenMs, serviceUuid, notifyUuid }</code> to override the configured values.</p>
+</script>

package/nodes/ble-reader-read.js

@@ -0,0 +1,59 @@
+'use strict';
+
+module.exports = function registerBleReaderReadNode(RED) {
+  function BleReaderReadNode(config) {
+    RED.nodes.createNode(this, config);
+    const node = this;
+
+    node.device = RED.nodes.getNode(config.device);
+    node.listenMs = Number(config.listenMs || 0);
+
+    node.on('input', async (msg, send, done) => {
+      const emit = send || ((message) => node.send(message));
+      try {
+        if (!node.device) throw new Error('BLE reader device node is not configured.');
+        const override = normalizePayload(msg.payload);
+        const deviceName = override.deviceName || (node.device.targetMode === 'name' ? node.device.deviceName : undefined);
+        const listenMs = override.listenMs ?? (node.listenMs || node.device.listenMs);
+        const serviceUuid = override.serviceUuid ?? node.device.serviceUuid;
+        const notifyUuid = override.notifyUuid ?? node.device.notifyUuid;
+
+        node.status({ fill: 'yellow', shape: 'ring', text: 'listening' });
+        const result = await node.device.enqueue((ble) =>
+          ble.readDevices({
+            bluetooth: node.device.bluetooth,
+            namePrefix: node.device.namePrefix,
+            deviceName,
+            listenMs,
+            notifyUuid,
+            scanServiceUuid: serviceUuid || null,
+            matchServiceUuid: serviceUuid || null
+          })
+        );
+        const messageCount = result.reduce((count, reading) => count + reading.messages.length, 0);
+        node.status({ fill: 'green', shape: 'dot', text: `${messageCount} message${messageCount === 1 ? '' : 's'}` });
+        msg.payload = result;
+        emit(msg);
+        done?.();
+      } catch (error) {
+        node.status({ fill: 'red', shape: 'ring', text: 'error' });
+        done ? done(error) : node.error(error, msg);
+      }
+    });
+  }
+
+  RED.nodes.registerType('ble-reader-read', BleReaderReadNode);
+};
+
+function normalizePayload(payload) {
+  if (!payload || typeof payload !== 'object' || Array.isArray(payload)) return {};
+  const result = {};
+  if (typeof payload.deviceName === 'string' && payload.deviceName) result.deviceName = payload.deviceName;
+  if (typeof payload.serviceUuid === 'string') result.serviceUuid = payload.serviceUuid;
+  if (typeof payload.notifyUuid === 'string' && payload.notifyUuid) result.notifyUuid = payload.notifyUuid;
+  if (payload.listenMs !== undefined) {
+    const listenMs = Number(payload.listenMs);
+    if (Number.isFinite(listenMs) && listenMs >= 0) result.listenMs = listenMs;
+  }
+  return result;
+}

package/nodes/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "node-red-contrib-ble-scanner",
+  "version": "0.0.1",
+  "description": "Generic Node-RED BLE reader for raw notification messages.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/node-red-contrib/node-red-contrib-ble-scanner.git"
+  },
+  "bugs": {
+    "url": "https://github.com/node-red-contrib/node-red-contrib-ble-scanner/issues"
+  },
+  "homepage": "https://github.com/node-red-contrib/node-red-contrib-ble-scanner#readme",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "bin",
+    "dist",
+    "nodes",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "ble-reader": "bin/ble-reader.js"
+  },
+  "node-red": {
+    "version": ">=4.0.0",
+    "nodes": {
+      "ble-reader-device": "nodes/ble-reader-device.js",
+      "ble-reader-read": "nodes/ble-reader-read.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "tsc -p tsconfig.json --build --clean",
+    "discover": "npm run build --silent && node ./bin/ble-reader.js discover",
+    "read": "npm run build --silent && node ./bin/ble-reader.js read",
+    "lint": "eslint .",
+    "check": "npm run build && npm run lint && npm test",
+    "test": "npm run build --silent && node --test"
+  },
+  "dependencies": {
+    "commander": "^14.0.3",
+    "dbus-next": "^0.10.2"
+  },
+  "optionalDependencies": {
+    "@abandonware/noble": "1.9.2-26"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^25.6.0",
+    "eslint": "^10.3.0",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.59.1"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "node-red",
+    "bluetooth",
+    "ble",
+    "scanner",
+    "notifications"
+  ],
+  "license": "MIT"
+}