node-red-contrib-ble-scanner 0.0.1

package/dist/ble/noble.js

@@ -0,0 +1,327 @@
+import { createRequire } from 'node:module';
+import { asError, matchesBleDevice, normalizeUuid, uniqueDevices } from './utils.js';
+const DISCONNECT_TIMEOUT_MS = 3000;
+const STOP_SCAN_TIMEOUT_MS = 250;
+const requireOptional = createRequire(import.meta.url);
+let nobleModule = null;
+let activePeripheral = null;
+const discoveredPeripherals = new Map();
+export const nobleBackend = {
+    name: 'noble',
+    isAvailable: async () => true,
+    discover: discoverNobleDevices,
+    connect: connectNobleDevice,
+    shutdown: shutdownNoble
+};
+async function discoverNobleDevices(options) {
+    const noble = loadNoble();
+    await waitForPoweredOn(noble);
+    options.logger('Bluetooth adapter powered on.');
+    return new Promise((resolve, reject) => {
+        const devices = [];
+        let settled = false;
+        const finish = async (error) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeout);
+            noble.removeListener('discover', onDiscover);
+            await stopScanningAndWait(noble);
+            if (error)
+                reject(error);
+            else
+                resolve(uniqueDevices(devices));
+        };
+        const timeout = setTimeout(() => {
+            finish().catch(reject);
+        }, options.timeoutMs);
+        const onDiscover = (peripheral) => {
+            const name = peripheral.advertisement?.localName || null;
+            const serviceUuids = peripheral.advertisement?.serviceUuids || [];
+            if (!matchesBleDevice({ name, address: peripheral.address || null, serviceUuids }, { namePrefix: options.namePrefix, deviceName: options.deviceName, serviceUuid: options.matchServiceUuid })) {
+                return;
+            }
+            const device = toDiscoveredDevice(peripheral);
+            cachePeripheral(peripheral);
+            options.logger(`Discovered ${device.name || '<unnamed>'} (${device.address || device.id}, rssi=${device.rssi ?? 'unknown'}).`);
+            devices.push(device);
+            if (options.deviceName)
+                finish().catch(reject);
+        };
+        noble.on('discover', onDiscover);
+        noble.startScanning(options.scanServiceUuid ? [options.scanServiceUuid] : [], true, (error) => {
+            if (error)
+                finish(error).catch(reject);
+        });
+    });
+}
+async function connectNobleDevice({ device, timeoutMs, connectTimeoutMs, notifyUuid, logger }) {
+    const noble = loadNoble();
+    await waitForPoweredOn(noble);
+    const peripheral = await connectCachedOrScan({ noble, device, scanTimeoutMs: timeoutMs, connectTimeoutMs, logger });
+    activePeripheral = peripheral;
+    logger('Discovering BLE services and characteristics.');
+    const characteristics = await discoverCharacteristics(peripheral, timeoutMs);
+    const byUuid = new Map(characteristics.map((characteristic) => [normalizeUuid(characteristic.uuid), characteristic]));
+    logger(`Discovered characteristic UUIDs: ${[...byUuid.keys()].sort().join(', ')}.`);
+    const notify = byUuid.get(normalizeUuid(notifyUuid));
+    if (!notify) {
+        throw new Error(`Missing BLE notify characteristic ${notifyUuid}. Found: ${[...byUuid.keys()].sort().join(', ')}`);
+    }
+    const wrappedNotify = wrapCharacteristic(notify);
+    await wrappedNotify.subscribe();
+    logger(`Subscribed to BLE notification characteristic ${wrappedNotify.uuid}.`);
+    return {
+        device: toDiscoveredDevice(peripheral),
+        notify: wrappedNotify,
+        disconnect: async () => {
+            await disconnectQuietly(peripheral);
+            if (activePeripheral === peripheral)
+                activePeripheral = null;
+        }
+    };
+}
+async function connectCachedOrScan({ noble, device, scanTimeoutMs, connectTimeoutMs, logger }) {
+    const cached = findCachedPeripheral(device);
+    if (cached) {
+        logger(`Using recently discovered ${displayPeripheral(cached)}.`);
+        try {
+            await connectAsync(cached, connectTimeoutMs, logger);
+            return cached;
+        }
+        catch (error) {
+            logger(`Could not connect to cached peripheral: ${error instanceof Error ? error.message : String(error)}. Scanning again.`);
+        }
+    }
+    return scanAndConnect({ noble, device, scanTimeoutMs, connectTimeoutMs, logger });
+}
+function scanAndConnect({ noble, device, scanTimeoutMs, connectTimeoutMs, logger }) {
+    return new Promise((resolve, reject) => {
+        let connecting = false;
+        let settled = false;
+        const finish = async (error, peripheral) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeout);
+            noble.removeListener('discover', onDiscover);
+            await stopScanningAndWait(noble);
+            if (error)
+                reject(error);
+            else if (peripheral)
+                resolve(peripheral);
+            else
+                reject(new Error('Connect completed without a peripheral.'));
+        };
+        const timeout = setTimeout(() => {
+            finish(new Error(`Timed out after ${scanTimeoutMs}ms scanning for ${device.name || device.address || device.id}.`)).catch(reject);
+        }, scanTimeoutMs);
+        const onDiscover = (peripheral) => {
+            if (connecting || !matchesKnownDevice(peripheral, device))
+                return;
+            connecting = true;
+            cachePeripheral(peripheral);
+            logger(`Found ${displayPeripheral(peripheral)}.`);
+            connectAsync(peripheral, connectTimeoutMs, logger)
+                .then(() => finish(null, peripheral))
+                .catch((error) => finish(asError(error)).catch(reject));
+        };
+        noble.on('discover', onDiscover);
+        noble.startScanning([], true, (error) => {
+            if (error)
+                finish(error).catch(reject);
+        });
+    });
+}
+function cachePeripheral(peripheral) {
+    const keys = [peripheral.id, peripheral.address, peripheral.advertisement?.localName].filter((key) => !!key);
+    for (const key of keys)
+        discoveredPeripherals.set(key.toLowerCase(), peripheral);
+}
+function findCachedPeripheral(device) {
+    const keys = [device.id, device.address, device.name].filter((key) => !!key);
+    for (const key of keys) {
+        const peripheral = discoveredPeripherals.get(key.toLowerCase());
+        if (peripheral)
+            return peripheral;
+    }
+    return null;
+}
+function matchesKnownDevice(peripheral, device) {
+    const name = peripheral.advertisement?.localName || null;
+    const address = peripheral.address || null;
+    return (!!device.name && name === device.name) || (!!device.address && address?.toLowerCase() === device.address.toLowerCase()) || peripheral.id === device.id;
+}
+function waitForPoweredOn(noble) {
+    if (noble.state === 'poweredOn')
+        return Promise.resolve();
+    if (noble.state === 'unsupported' || noble.state === 'unauthorized') {
+        return Promise.reject(new Error(`Bluetooth adapter state is ${noble.state}.`));
+    }
+    return new Promise((resolve, reject) => {
+        const onStateChange = (state) => {
+            if (state === 'poweredOn') {
+                noble.removeListener('stateChange', onStateChange);
+                resolve();
+            }
+            else if (state === 'unsupported' || state === 'unauthorized') {
+                noble.removeListener('stateChange', onStateChange);
+                reject(new Error(`Bluetooth adapter state is ${state}.`));
+            }
+        };
+        noble.on('stateChange', onStateChange);
+    });
+}
+function connectAsync(peripheral, timeoutMs, logger) {
+    if (peripheral.state === 'connected')
+        return Promise.resolve();
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const startedAt = Date.now();
+        const finish = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            const normalized = normalizeConnectError(error);
+            logger(`Connect finished after ${Date.now() - startedAt}ms with ${normalized ? `error: ${normalized.message}` : 'success'}.`);
+            if (normalized)
+                reject(normalized);
+            else
+                resolve();
+        };
+        const timeout = setTimeout(() => {
+            cancelPendingConnect(peripheral, logger);
+            finish(new Error(`Timed out after ${timeoutMs}ms while connecting.`));
+        }, timeoutMs);
+        const cleanup = () => {
+            clearTimeout(timeout);
+            peripheral.removeListener('connect', onConnect);
+            peripheral.removeListener('disconnect', onDisconnect);
+        };
+        const onConnect = (error) => finish(error);
+        const onDisconnect = () => finish(new Error('Peripheral disconnected before connect completed.'));
+        peripheral.once('connect', onConnect);
+        peripheral.once('disconnect', onDisconnect);
+        peripheral.connect((error) => finish(error));
+    });
+}
+function cancelPendingConnect(peripheral, logger) {
+    if (peripheral.state !== 'connecting')
+        return;
+    try {
+        if (typeof peripheral.cancelConnect === 'function') {
+            peripheral.cancelConnect();
+            return;
+        }
+        const noble = loadNoble();
+        if (typeof noble._bindings?.disconnect === 'function')
+            noble._bindings.disconnect(peripheral.id);
+    }
+    catch (error) {
+        logger(`Could not cancel pending connection: ${error instanceof Error ? error.message : String(error)}.`);
+    }
+}
+function discoverCharacteristics(peripheral, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => reject(new Error(`Timed out after ${timeoutMs}ms discovering BLE GATT services.`)), timeoutMs);
+        peripheral.discoverAllServicesAndCharacteristics((error, _services, characteristics) => {
+            clearTimeout(timeout);
+            if (error)
+                reject(error);
+            else
+                resolve(characteristics);
+        });
+    });
+}
+function wrapCharacteristic(characteristic) {
+    return {
+        uuid: normalizeUuid(characteristic.uuid),
+        properties: characteristic.properties || [],
+        write(data, withoutResponse = false) {
+            return new Promise((resolve, reject) => {
+                characteristic.write(data, withoutResponse, (error) => (error ? reject(error) : resolve()));
+            });
+        },
+        subscribe() {
+            return new Promise((resolve, reject) => {
+                characteristic.subscribe((error) => (error ? reject(error) : resolve()));
+            });
+        },
+        onData(listener) {
+            characteristic.on('data', listener);
+        },
+        removeDataListener(listener) {
+            characteristic.removeListener('data', listener);
+        }
+    };
+}
+function stopScanningAndWait(noble) {
+    return new Promise((resolve) => {
+        let settled = false;
+        const finish = () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeout);
+            noble.removeListener('scanStop', finish);
+            resolve();
+        };
+        const timeout = setTimeout(finish, STOP_SCAN_TIMEOUT_MS);
+        noble.once('scanStop', finish);
+        noble.stopScanning();
+    });
+}
+async function disconnectQuietly(peripheral) {
+    if (!peripheral || peripheral.state === 'disconnected')
+        return;
+    await new Promise((resolve) => {
+        let settled = false;
+        const finish = () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeout);
+            peripheral.removeListener('disconnect', finish);
+            resolve();
+        };
+        const timeout = setTimeout(finish, DISCONNECT_TIMEOUT_MS);
+        peripheral.once('disconnect', finish);
+        peripheral.disconnect(() => finish());
+    });
+}
+async function shutdownNoble() {
+    const noble = nobleModule;
+    if (!noble)
+        return;
+    noble.removeAllListeners('discover');
+    await stopScanningAndWait(noble);
+    await disconnectQuietly(activePeripheral);
+    activePeripheral = null;
+    discoveredPeripherals.clear();
+}
+function toDiscoveredDevice(peripheral) {
+    return {
+        id: peripheral.id,
+        address: peripheral.address || null,
+        addressType: peripheral.addressType || null,
+        name: peripheral.advertisement?.localName || null,
+        rssi: typeof peripheral.rssi === 'number' ? peripheral.rssi : null,
+        backend: 'noble'
+    };
+}
+function displayPeripheral(peripheral) {
+    const name = peripheral.advertisement?.localName || '<unnamed>';
+    return `${name} (${peripheral.address || peripheral.id}, ${peripheral.addressType || 'unknown'}, rssi=${peripheral.rssi ?? 'unknown'})`;
+}
+function normalizeConnectError(error) {
+    if (!error)
+        return null;
+    return error instanceof Error ? error : new Error(String(error));
+}
+function loadNoble() {
+    if (!nobleModule)
+        nobleModule = requireOptional('@abandonware/noble');
+    return nobleModule;
+}
+//# sourceMappingURL=noble.js.map

package/dist/ble/noble.js.map

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

package/dist/ble/utils.d.ts

@@ -0,0 +1,19 @@
+import type { BleDiscoveredDevice } from './backend.js';
+export declare function normalizeUuid(uuid: string | null | undefined): string;
+export declare function formatCanonicalUuid(uuid: string): string;
+export declare function matchesBleDevice(candidate: {
+    name?: string | null;
+    address?: string | null;
+    serviceUuids?: string[] | null;
+}, { namePrefix, deviceName, serviceUuid }?: {
+    namePrefix?: string;
+    deviceName?: string | null;
+    serviceUuid?: string | null;
+}): boolean;
+export declare function uniqueDevices(devices: BleDiscoveredDevice[]): BleDiscoveredDevice[];
+export declare function displayDevice(device: BleDiscoveredDevice): string;
+export declare function nullableString(value: unknown): string | null;
+export declare function nullableNumber(value: unknown): number | null;
+export declare function unboxBluezValue(value: unknown): unknown;
+export declare function errorMessage(error: unknown): string;
+export declare function asError(error: unknown): Error;

package/dist/ble/utils.js

@@ -0,0 +1,57 @@
+import { DEFAULTS } from '../constants.js';
+export function normalizeUuid(uuid) {
+    const compact = String(uuid || '').toLowerCase().replaceAll('-', '');
+    if (compact.length === 32 && compact.startsWith('0000') && compact.endsWith('00001000800000805f9b34fb'))
+        return compact.slice(4, 8);
+    return compact;
+}
+export function formatCanonicalUuid(uuid) {
+    const compact = normalizeUuid(uuid);
+    if (compact.length === 4)
+        return `0000${compact}-0000-1000-8000-00805f9b34fb`;
+    if (compact.length !== 32)
+        return uuid.toLowerCase();
+    return `${compact.slice(0, 8)}-${compact.slice(8, 12)}-${compact.slice(12, 16)}-${compact.slice(16, 20)}-${compact.slice(20)}`;
+}
+export function matchesBleDevice(candidate, { namePrefix = DEFAULTS.namePrefix, deviceName = null, serviceUuid = null } = {}) {
+    const name = candidate.name || '';
+    if (deviceName)
+        return name === deviceName;
+    if (namePrefix && name.startsWith(namePrefix))
+        return true;
+    if (!serviceUuid)
+        return !namePrefix;
+    const expectedServiceUuid = normalizeUuid(serviceUuid);
+    return (candidate.serviceUuids || []).some((uuid) => normalizeUuid(uuid) === expectedServiceUuid);
+}
+export function uniqueDevices(devices) {
+    const byKey = new Map();
+    for (const device of devices) {
+        const key = device.name || device.address || `${device.backend}:${device.id}`;
+        const existing = byKey.get(key);
+        if (!existing || (device.rssi ?? -999) > (existing.rssi ?? -999))
+            byKey.set(key, device);
+    }
+    return [...byKey.values()].sort((left, right) => displayDevice(left).localeCompare(displayDevice(right)));
+}
+export function displayDevice(device) {
+    return device.name || device.address || device.id;
+}
+export function nullableString(value) {
+    return typeof value === 'string' && value ? value : null;
+}
+export function nullableNumber(value) {
+    return typeof value === 'number' ? value : null;
+}
+export function unboxBluezValue(value) {
+    if (value && typeof value === 'object' && 'value' in value)
+        return value.value;
+    return value;
+}
+export function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export function asError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+//# sourceMappingURL=utils.js.map

package/dist/ble/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/ble/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG3C,MAAM,UAAU,aAAa,CAAC,IAA+B;IAC3D,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACrE,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAC;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpI,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,OAAO,8BAA8B,CAAC;IAC9E,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;IACrD,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AACjI,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,SAA4F,EAC5F,EACE,UAAU,GAAG,QAAQ,CAAC,UAAU,EAChC,UAAU,GAAG,IAAI,EACjB,WAAW,GAAG,IAAI,KAKhB,EAAE;IAEN,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC;IAClC,IAAI,UAAU;QAAE,OAAO,IAAI,KAAK,UAAU,CAAC;IAC3C,IAAI,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3D,IAAI,CAAC,WAAW;QAAE,OAAO,CAAC,UAAU,CAAC;IACrC,MAAM,mBAAmB,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IACvD,OAAO,CAAC,SAAS,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,mBAAmB,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAA8B;IAC1D,MAAM,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;IACrD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,IAAI,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QAC9E,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC5G,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAA2B;IACvD,OAAO,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK;QAAE,OAAQ,KAA4B,CAAC,KAAK,CAAC;IACvG,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,14 @@
+import { type BluetoothBackendName, type ReadOptions } from './index.js';
+interface GlobalCliOptions {
+    bluetooth: BluetoothBackendName;
+    namePrefix: string;
+    notifyUuid: string;
+    serviceUuid?: string;
+    listenMs: string;
+    debug?: boolean;
+}
+export declare function main(argv?: string[]): Promise<void>;
+export declare function parseIntervalMs(value: string | undefined): number | null;
+export declare function parseListenMs(value: string | undefined): number;
+export declare function toReadOptions(globals: GlobalCliOptions, deviceName?: string): ReadOptions;
+export {};

package/dist/cli.js

@@ -0,0 +1,140 @@
+import { Command, Option } from 'commander';
+import { setTimeout as delay } from 'node:timers/promises';
+import { DEFAULTS, connectReaders, discoverDevices, readDevices, shutdownBluetooth } from './index.js';
+export async function main(argv = process.argv.slice(2)) {
+    installSignalCleanup();
+    const program = new Command();
+    program
+        .name('ble-reader')
+        .description('Discover BLE devices and read raw notification messages.')
+        .showHelpAfterError();
+    addSharedOptions(program);
+    addSharedOptions(program
+        .command('discover')
+        .description('Discover BLE devices.')).action(async (options, command) => {
+        const globals = globalOptions(command, options);
+        const result = await discoverDevices({
+            bluetooth: globals.bluetooth,
+            namePrefix: globals.namePrefix,
+            scanServiceUuid: globals.serviceUuid || null,
+            matchServiceUuid: globals.serviceUuid || null,
+            logger: loggerFor(globals)
+        });
+        await writeJson(result);
+    });
+    addSharedOptions(program
+        .command('read')
+        .description('Read raw notifications from one exact advertised device name, or all discovered matching devices.')
+        .argument('[deviceName]', 'exact advertised BLE device name')
+        .option('--interval <seconds>', 'read repeatedly every N seconds using persistent BLE sessions')).action(async (deviceName, options, command) => {
+        const globals = globalOptions(command, options);
+        const intervalMs = parseIntervalMs(options.interval);
+        if (intervalMs === null) {
+            const result = await readDevices(toReadOptions(globals, deviceName));
+            await writeJson(result);
+            return;
+        }
+        await readAtInterval(globals, deviceName, intervalMs);
+    });
+    try {
+        await program.parseAsync(argv, { from: 'user' });
+    }
+    finally {
+        await shutdownBluetooth();
+    }
+}
+export function parseIntervalMs(value) {
+    if (value === undefined)
+        return null;
+    const seconds = Number(value);
+    if (!Number.isFinite(seconds) || seconds <= 0)
+        throw new Error('--interval must be a number greater than 0 seconds.');
+    return seconds * 1000;
+}
+export function parseListenMs(value) {
+    const ms = Number(value ?? DEFAULTS.listenMs);
+    if (!Number.isFinite(ms) || ms < 0)
+        throw new Error('--listen-ms must be a number greater than or equal to 0.');
+    return ms;
+}
+export function toReadOptions(globals, deviceName) {
+    return {
+        bluetooth: globals.bluetooth,
+        namePrefix: globals.namePrefix,
+        deviceName: deviceName || undefined,
+        notifyUuid: globals.notifyUuid,
+        listenMs: parseListenMs(globals.listenMs),
+        scanServiceUuid: globals.serviceUuid || null,
+        matchServiceUuid: globals.serviceUuid || null,
+        logger: loggerFor(globals)
+    };
+}
+function addSharedOptions(command) {
+    return command
+        .addOption(new Option('--bluetooth <backend>', 'Bluetooth backend').choices(['auto', 'bluez', 'noble']).default('auto'))
+        .option('--name-prefix <prefix>', 'BLE advertised name prefix; empty matches all devices', DEFAULTS.namePrefix)
+        .option('--service-uuid <uuid>', 'optional BLE service UUID used for discovery filtering')
+        .option('--notify-uuid <uuid>', 'notification characteristic UUID to subscribe to', DEFAULTS.notifyUuid)
+        .option('--listen-ms <ms>', 'milliseconds to collect notifications per read', String(DEFAULTS.listenMs))
+        .option('--debug', 'print Bluetooth diagnostics to stderr');
+}
+function globalOptions(command, options) {
+    return {
+        bluetooth: optionValue(command, options, 'bluetooth', 'auto'),
+        namePrefix: optionValue(command, options, 'namePrefix', DEFAULTS.namePrefix),
+        serviceUuid: optionValue(command, options, 'serviceUuid', ''),
+        notifyUuid: optionValue(command, options, 'notifyUuid', DEFAULTS.notifyUuid),
+        listenMs: optionValue(command, options, 'listenMs', String(DEFAULTS.listenMs)),
+        debug: optionValue(command, options, 'debug', false)
+    };
+}
+function optionValue(command, options, name, fallback) {
+    const parentOptions = command.parent?.opts() || {};
+    const localSource = command.getOptionValueSource(name);
+    if (localSource === 'default' && parentOptions[name] !== undefined)
+        return parentOptions[name];
+    return (options[name] ?? fallback);
+}
+function loggerFor({ debug }) {
+    return debug ? (message) => process.stderr.write(`[ble-reader-debug] ${message}\n`) : () => { };
+}
+async function writeJson(value) {
+    await new Promise((resolve, reject) => {
+        process.stdout.write(`${JSON.stringify(value, null, 2)}\n`, (error) => (error ? reject(error) : resolve()));
+    });
+}
+async function readAtInterval(globals, deviceName, intervalMs) {
+    const readers = await connectReaders(toReadOptions(globals, deviceName));
+    if (readers.length === 0) {
+        await writeJson([]);
+        return;
+    }
+    try {
+        while (true) {
+            await writeJson(await readPersistentReaders(readers, globals));
+            await delay(intervalMs);
+        }
+    }
+    finally {
+        await Promise.all(readers.map((reader) => reader.disconnect().catch(() => { })));
+    }
+}
+async function readPersistentReaders(readers, globals) {
+    const readings = [];
+    for (const reader of readers)
+        readings.push(await reader.read(toReadOptions(globals)));
+    return readings;
+}
+function installSignalCleanup() {
+    let shuttingDown = false;
+    const handler = async () => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        await shutdownBluetooth();
+        process.exit(130);
+    };
+    process.once('SIGINT', handler);
+    process.once('SIGTERM', handler);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,7 @@
+export declare const DEFAULTS: {
+    readonly listenMs: 5000;
+    readonly timeoutMs: 30000;
+    readonly connectTimeoutMs: 15000;
+    readonly notifyUuid: "fff1";
+    readonly namePrefix: "";
+};

package/dist/constants.js

@@ -0,0 +1,8 @@
+export const DEFAULTS = {
+    listenMs: 5000,
+    timeoutMs: 30000,
+    connectTimeoutMs: 15000,
+    notifyUuid: 'fff1',
+    namePrefix: ''
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,QAAQ,EAAE,IAAI;IACd,SAAS,EAAE,KAAK;IAChB,gBAAgB,EAAE,KAAK;IACvB,UAAU,EAAE,MAAM;IAClB,UAAU,EAAE,EAAE;CACN,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { DEFAULTS } from './constants.js';
+export { connectDevice, connectReaders, discoverDevices, readDevice, readDevices, readSession, shutdownBluetooth, type BleReader } from './reader.js';
+export { matchesBleDevice } from './ble/utils.js';
+export type { BleDiscoveredDevice, BleReading, BleSession, BluetoothBackendName, DiscoverOptions, RawBleMessage, ReadOptions } from './ble/backend.js';

package/dist/index.js

@@ -0,0 +1,4 @@
+export { DEFAULTS } from './constants.js';
+export { connectDevice, connectReaders, discoverDevices, readDevice, readDevices, readSession, shutdownBluetooth } from './reader.js';
+export { matchesBleDevice } from './ble/utils.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAkB,MAAM,aAAa,CAAC;AACtJ,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/reader.d.ts

@@ -0,0 +1,13 @@
+import type { BleDiscoveredDevice, BleReading, BleSession, DiscoverOptions, ReadOptions } from './ble/backend.js';
+export interface BleReader {
+    device: BleDiscoveredDevice;
+    read(options?: ReadOptions): Promise<BleReading>;
+    disconnect(): Promise<void>;
+}
+export declare function discoverDevices(options?: DiscoverOptions): Promise<BleDiscoveredDevice[]>;
+export declare function readDevices(options?: ReadOptions): Promise<BleReading[]>;
+export declare function readDevice(device: BleDiscoveredDevice, options?: ReadOptions): Promise<BleReading>;
+export declare function connectReaders(options?: ReadOptions): Promise<BleReader[]>;
+export declare function connectDevice(device: BleDiscoveredDevice, options?: ReadOptions): Promise<BleReader>;
+export declare function readSession(session: BleSession, options?: ReadOptions): Promise<BleReading>;
+export declare function shutdownBluetooth(): Promise<void>;