@voltras/node-sdk 0.1.0

package/dist/cjs/bluetooth/adapters/node.js

@@ -0,0 +1,228 @@
+"use strict";
+/**
+ * NodeBLEAdapter
+ *
+ * BLE adapter for Node.js using the webbluetooth npm package.
+ * Implements the same W3C Web Bluetooth API for server-side BLE.
+ *
+ * Requirements:
+ * - Node.js environment
+ * - webbluetooth npm package
+ * - Platform-specific Bluetooth support (macOS, Linux, Windows)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeBLEAdapter = void 0;
+const web_bluetooth_base_1 = require("./web-bluetooth-base");
+// Dynamic import for webbluetooth to avoid bundling issues in non-Node environments
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let BluetoothClass = null;
+/**
+ * BLE adapter for Node.js environments using webbluetooth package.
+ *
+ * Device selection flow:
+ * 1. Call scan() - starts BLE scan
+ * 2. Devices are discovered via deviceFound callback
+ * 3. deviceChooser function selects a device (or first match by default)
+ * 4. Call connect() to establish GATT connection
+ */
+class NodeBLEAdapter extends web_bluetooth_base_1.WebBluetoothBase {
+    constructor(config) {
+        super(config);
+        /** Device selected during scan, stored for connect() */
+        this.selectedDevice = null;
+        /** List of discovered devices during current scan */
+        this.discoveredDevices = [];
+        this.deviceChooser = config.deviceChooser ?? null;
+    }
+    /**
+     * Set the device chooser function.
+     * Called during scan to programmatically select a device.
+     *
+     * @param chooser Function that receives discovered devices and returns the chosen one
+     */
+    setDeviceChooser(chooser) {
+        this.deviceChooser = chooser;
+    }
+    /**
+     * Ensure webbluetooth is loaded (lazy load to avoid bundler issues).
+     */
+    async ensureBluetoothLoaded() {
+        if (!BluetoothClass) {
+            try {
+                // Dynamic import for Node.js - get the Bluetooth class constructor
+                const webbluetooth = await Promise.resolve().then(() => __importStar(require('webbluetooth')));
+                BluetoothClass = webbluetooth.Bluetooth;
+            }
+            catch {
+                throw new Error('webbluetooth package not found. Install with: npm install webbluetooth');
+            }
+        }
+    }
+    /**
+     * Scan for devices programmatically.
+     *
+     * In Node.js, there's no browser picker. Devices are discovered via
+     * the deviceFound callback, and the deviceChooser function selects one.
+     *
+     * IMPORTANT: The webbluetooth package requires creating a new Bluetooth
+     * instance with deviceFound in the constructor for the callback to work
+     * reliably. Using the default singleton doesn't call the callback consistently.
+     *
+     * @param timeout Scan timeout in seconds
+     * @returns Array of discovered devices (selection happens via deviceChooser)
+     */
+    async scan(timeout) {
+        await this.ensureBluetoothLoaded();
+        this.discoveredDevices = [];
+        this.selectedDevice = null;
+        return new Promise((resolve, reject) => {
+            const timeoutId = setTimeout(() => {
+                // Timeout - return discovered devices
+                console.log(`[NodeBLE] Scan timeout. Found ${this.discoveredDevices.length} device(s)`);
+                resolve(this.discoveredDevices);
+            }, timeout * 1000);
+            // Create a new Bluetooth instance with deviceFound in constructor
+            // This is required for the callback to fire reliably in webbluetooth
+            const bluetooth = new BluetoothClass({
+                deviceFound: (device, selectFn) => {
+                    // Apply name prefix filter manually (more reliable than built-in filter)
+                    if (this.config.deviceNamePrefix &&
+                        !device.name?.startsWith(this.config.deviceNamePrefix)) {
+                        // Device doesn't match prefix, skip it
+                        return false;
+                    }
+                    const discoveredDevice = {
+                        id: device.id,
+                        name: device.name ?? 'Unknown Device',
+                        rssi: null,
+                    };
+                    // Add to discovered list
+                    if (!this.discoveredDevices.find((d) => d.id === device.id)) {
+                        this.discoveredDevices.push(discoveredDevice);
+                        console.log(`[NodeBLE] Found device: ${device.name}`);
+                    }
+                    // Check if we should select this device
+                    let shouldSelect = false;
+                    if (this.deviceChooser) {
+                        // Use custom chooser
+                        const chosen = this.deviceChooser(this.discoveredDevices);
+                        shouldSelect = chosen?.id === device.id;
+                    }
+                    else {
+                        // Default: select first matching device
+                        shouldSelect = true;
+                    }
+                    if (shouldSelect) {
+                        console.log(`[NodeBLE] Selected device: ${device.name}`);
+                        this.selectedDevice = device;
+                        clearTimeout(timeoutId);
+                        selectFn();
+                        return true;
+                    }
+                    return false;
+                },
+            });
+            bluetooth
+                .requestDevice({
+                // Always use acceptAllDevices - we filter manually in deviceFound
+                // The built-in namePrefix filter doesn't work reliably
+                acceptAllDevices: true,
+                optionalServices: [this.config.serviceUUID],
+            })
+                .then((device) => {
+                // Device was selected
+                this.selectedDevice = device;
+                resolve(this.discoveredDevices);
+            })
+                .catch((error) => {
+                clearTimeout(timeoutId);
+                if (error.name === 'NotFoundError') {
+                    // No device selected
+                    console.log('[NodeBLE] No device selected');
+                    resolve(this.discoveredDevices);
+                }
+                else {
+                    reject(error);
+                }
+            });
+        });
+    }
+    /**
+     * Connect to the selected device.
+     *
+     * @param deviceId Device ID (should match the selected device)
+     * @param options Connection options
+     */
+    async connect(deviceId, options) {
+        // Verify we have the device from scan()
+        if (!this.selectedDevice) {
+            throw new Error('No device selected. Call scan() first.');
+        }
+        if (this.selectedDevice.id !== deviceId) {
+            console.warn(`[NodeBLE] Device ID mismatch: expected ${this.selectedDevice.id}, got ${deviceId}`);
+        }
+        // Connect to GATT server
+        await this.connectToDevice(this.selectedDevice);
+        // Handle immediate write if provided (for authentication)
+        if (options?.immediateWrite) {
+            console.log('[NodeBLE] Sending immediate auth write...');
+            await this.write(options.immediateWrite);
+            console.log('[NodeBLE] Immediate auth write sent');
+        }
+    }
+    /**
+     * Override disconnect to also clear selected device.
+     */
+    async disconnect() {
+        await super.disconnect();
+        this.selectedDevice = null;
+        this.discoveredDevices = [];
+    }
+    /**
+     * Get the list of devices discovered during the last scan.
+     */
+    getDiscoveredDevices() {
+        return [...this.discoveredDevices];
+    }
+    /**
+     * Check if running in a Node.js environment.
+     */
+    static isNodeEnvironment() {
+        return (typeof process !== 'undefined' && process.versions != null && process.versions.node != null);
+    }
+}
+exports.NodeBLEAdapter = NodeBLEAdapter;
+//# sourceMappingURL=node.js.map

package/dist/cjs/bluetooth/adapters/node.js.map

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

package/dist/cjs/bluetooth/adapters/types.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * BLE Abstraction Layer Types
+ *
+ * Defines interfaces for BLE operations implemented by platform-specific adapters:
+ * - Native (iOS/Android): react-native-ble-plx
+ * - Browser: Web Bluetooth API
+ * - Node.js: webbluetooth npm package
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/bluetooth/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/bluetooth/adapters/types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}

package/dist/cjs/bluetooth/adapters/web-bluetooth-base.js

@@ -0,0 +1,187 @@
+"use strict";
+/**
+ * WebBluetoothBase
+ *
+ * Abstract base class for W3C Web Bluetooth API adapters.
+ * Provides shared GATT operations for both browser and Node.js environments.
+ *
+ * Subclasses:
+ * - WebBLEAdapter: Browser using navigator.bluetooth
+ * - NodeBLEAdapter: Node.js using webbluetooth npm package
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebBluetoothBase = void 0;
+const base_1 = require("./base");
+/**
+ * Abstract base class for Web Bluetooth adapters.
+ *
+ * Implements shared GATT operations:
+ * - Service/characteristic discovery
+ * - Write operations
+ * - Notification subscription
+ * - Disconnect cleanup
+ *
+ * Subclasses implement platform-specific device selection (scan/connect).
+ */
+class WebBluetoothBase extends base_1.BaseBLEAdapter {
+    constructor(config) {
+        super();
+        /** Connected Bluetooth device */
+        this.device = null;
+        /** GATT server connection */
+        this.server = null;
+        /** Write characteristic */
+        this.writeChar = null;
+        /** Notify characteristic */
+        this.notifyChar = null;
+        /** Bound notification handler for cleanup */
+        this.boundNotificationHandler = null;
+        // Web Bluetooth API requires lowercase UUIDs
+        this.config = {
+            ...config.ble,
+            serviceUUID: config.ble.serviceUUID.toLowerCase(),
+            writeCharUUID: config.ble.writeCharUUID.toLowerCase(),
+            notifyCharUUID: config.ble.notifyCharUUID.toLowerCase(),
+        };
+    }
+    // ===========================================================================
+    // Shared GATT operations
+    // ===========================================================================
+    /**
+     * Connect to a Bluetooth device's GATT server and set up characteristics.
+     * Called by subclasses after device selection.
+     */
+    async connectToDevice(device) {
+        this.device = device;
+        // Set up disconnect listener
+        device.addEventListener('gattserverdisconnected', () => {
+            console.log('[WebBluetooth] Device disconnected');
+            this.handleDisconnect();
+        });
+        // Connect to GATT server
+        if (!device.gatt) {
+            throw new Error('Device does not support GATT');
+        }
+        this.setConnectionState('connecting');
+        try {
+            this.server = await device.gatt.connect();
+            await this.setupCharacteristics();
+            this.setConnectionState('connected');
+        }
+        catch (error) {
+            console.error('[WebBluetooth] Connect error:', error);
+            this.setConnectionState('disconnected');
+            throw error;
+        }
+    }
+    /**
+     * Discover service and characteristics, set up notifications.
+     */
+    async setupCharacteristics() {
+        if (!this.server) {
+            throw new Error('Not connected to GATT server');
+        }
+        // Get the primary service
+        const service = await this.server.getPrimaryService(this.config.serviceUUID);
+        // Get write characteristic
+        this.writeChar = await service.getCharacteristic(this.config.writeCharUUID);
+        // Get notify characteristic and start notifications
+        this.notifyChar = await service.getCharacteristic(this.config.notifyCharUUID);
+        // Set up notification handler
+        this.boundNotificationHandler = this.handleNotification.bind(this);
+        this.notifyChar.addEventListener('characteristicvaluechanged', this.boundNotificationHandler);
+        await this.notifyChar.startNotifications();
+        // Also listen for notifications on write characteristic if it supports it
+        if (this.writeChar.properties.notify) {
+            this.writeChar.addEventListener('characteristicvaluechanged', this.boundNotificationHandler);
+            await this.writeChar.startNotifications();
+        }
+        console.log('[WebBluetooth] Characteristics set up');
+    }
+    /**
+     * Handle incoming notification data.
+     */
+    handleNotification(event) {
+        const characteristic = event.target;
+        if (characteristic.value) {
+            const data = new Uint8Array(characteristic.value.buffer);
+            this.emitNotification(data);
+        }
+    }
+    /**
+     * Handle device disconnection.
+     */
+    handleDisconnect() {
+        this.cleanup();
+        this.setConnectionState('disconnected');
+    }
+    /**
+     * Clean up resources.
+     */
+    cleanup() {
+        // Remove notification listeners
+        if (this.notifyChar && this.boundNotificationHandler) {
+            try {
+                this.notifyChar.removeEventListener('characteristicvaluechanged', this.boundNotificationHandler);
+            }
+            catch {
+                // Ignore errors during cleanup
+            }
+        }
+        if (this.writeChar && this.boundNotificationHandler) {
+            try {
+                this.writeChar.removeEventListener('characteristicvaluechanged', this.boundNotificationHandler);
+            }
+            catch {
+                // Ignore errors during cleanup
+            }
+        }
+        this.boundNotificationHandler = null;
+        this.writeChar = null;
+        this.notifyChar = null;
+        this.server = null;
+        this.device = null;
+    }
+    // ===========================================================================
+    // BLEAdapter interface - implemented
+    // ===========================================================================
+    /**
+     * Disconnect from the device.
+     */
+    async disconnect() {
+        this.setConnectionState('disconnecting');
+        if (this.device?.gatt?.connected) {
+            this.device.gatt.disconnect();
+        }
+        this.cleanup();
+        this.setConnectionState('disconnected');
+    }
+    /**
+     * Write data to the device.
+     */
+    async write(data) {
+        if (!this.writeChar) {
+            throw new Error('Not connected to device');
+        }
+        // Use ArrayBuffer.slice to ensure we have a proper ArrayBuffer
+        const buffer = data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
+        await this.writeChar.writeValueWithResponse(buffer);
+    }
+    // ===========================================================================
+    // Extended methods
+    // ===========================================================================
+    /**
+     * Get info about the currently connected device.
+     */
+    getConnectedDevice() {
+        if (!this.device)
+            return null;
+        return {
+            id: this.device.id,
+            name: this.device.name ?? 'Unknown',
+            rssi: null, // Not available via Web Bluetooth after connection
+        };
+    }
+}
+exports.WebBluetoothBase = WebBluetoothBase;
+//# sourceMappingURL=web-bluetooth-base.js.map

package/dist/cjs/bluetooth/adapters/web-bluetooth-base.js.map

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

package/dist/cjs/bluetooth/adapters/web.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * WebBLEAdapter
+ *
+ * BLE adapter for web browsers using the native Web Bluetooth API.
+ * Uses the browser's built-in device picker for device selection.
+ *
+ * Requirements:
+ * - Chrome, Edge, or Opera browser (Safari/Firefox don't support Web Bluetooth)
+ * - HTTPS or localhost
+ * - User gesture required to trigger device picker
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebBLEAdapter = void 0;
+const web_bluetooth_base_1 = require("./web-bluetooth-base");
+/**
+ * BLE adapter using the browser's native Web Bluetooth API.
+ *
+ * Device selection flow:
+ * 1. Call scan() - triggers browser's device picker
+ * 2. User selects device from browser UI
+ * 3. scan() returns with the selected device
+ * 4. Call connect() to establish GATT connection
+ */
+class WebBLEAdapter extends web_bluetooth_base_1.WebBluetoothBase {
+    constructor(config) {
+        super(config);
+        /** Device selected from browser picker, stored for connect() */
+        this.selectedDevice = null;
+    }
+    /**
+     * Scan for devices using the browser's device picker.
+     *
+     * Note: This triggers the browser's native Bluetooth device picker UI.
+     * The user must select a device from the picker. Returns when user
+     * selects a device or cancels.
+     *
+     * @param _timeout Ignored - browser controls the picker timeout
+     * @returns Array with single selected device, or empty if cancelled
+     */
+    async scan(_timeout) {
+        try {
+            // Request device from browser - this shows the native picker
+            const device = await navigator.bluetooth.requestDevice({
+                filters: this.config.deviceNamePrefix
+                    ? [{ namePrefix: this.config.deviceNamePrefix }]
+                    : undefined,
+                acceptAllDevices: !this.config.deviceNamePrefix,
+                optionalServices: [this.config.serviceUUID],
+            });
+            // Store for connect()
+            this.selectedDevice = device;
+            console.log(`[WebBLE] Device selected: ${device.name}`);
+            return [
+                {
+                    id: device.id,
+                    name: device.name ?? 'Unknown Device',
+                    rssi: null, // Not available from requestDevice
+                },
+            ];
+        }
+        catch (error) {
+            // User cancelled or error occurred
+            if (error.name === 'NotFoundError') {
+                console.log('[WebBLE] User cancelled device selection');
+                return [];
+            }
+            throw error;
+        }
+    }
+    /**
+     * Connect to the selected device.
+     *
+     * Note: In Web Bluetooth, the device is already "selected" during scan().
+     * This method establishes the GATT connection.
+     *
+     * @param deviceId Device ID (should match the selected device)
+     * @param options Connection options
+     */
+    async connect(deviceId, options) {
+        // Verify we have the device from scan()
+        if (!this.selectedDevice) {
+            throw new Error('No device selected. Call scan() first.');
+        }
+        if (this.selectedDevice.id !== deviceId) {
+            console.warn(`[WebBLE] Device ID mismatch: expected ${this.selectedDevice.id}, got ${deviceId}`);
+        }
+        // Connect to GATT server
+        await this.connectToDevice(this.selectedDevice);
+        // Handle immediate write if provided (for authentication)
+        if (options?.immediateWrite) {
+            console.log('[WebBLE] Sending immediate auth write...');
+            await this.write(options.immediateWrite);
+            console.log('[WebBLE] Immediate auth write sent');
+        }
+    }
+    /**
+     * Override disconnect to also clear selected device.
+     */
+    async disconnect() {
+        await super.disconnect();
+        this.selectedDevice = null;
+    }
+    /**
+     * Check if Web Bluetooth is supported in this browser.
+     */
+    static isSupported() {
+        return typeof navigator !== 'undefined' && 'bluetooth' in navigator;
+    }
+}
+exports.WebBLEAdapter = WebBLEAdapter;
+//# sourceMappingURL=web.js.map

package/dist/cjs/bluetooth/adapters/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../../../src/bluetooth/adapters/web.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,6DAAiF;AAGjF;;;;;;;;GAQG;AACH,MAAa,aAAc,SAAQ,qCAAgB;IAIjD,YAAY,MAA0B;QACpC,KAAK,CAAC,MAAM,CAAC,CAAC;QAJhB,gEAAgE;QACxD,mBAAc,GAA2B,IAAI,CAAC;IAItD,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,CAAC,QAAgB;QACzB,IAAI,CAAC;YACH,6DAA6D;YAC7D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,aAAa,CAAC;gBACrD,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,gBAAgB;oBACnC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;oBAChD,CAAC,CAAC,SAAS;gBACb,gBAAgB,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB;gBAC/C,gBAAgB,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;aAC5C,CAAC,CAAC;YAEH,sBAAsB;YACtB,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC;YAE7B,OAAO,CAAC,GAAG,CAAC,6BAA6B,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAExD,OAAO;gBACL;oBACE,EAAE,EAAE,MAAM,CAAC,EAAE;oBACb,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,gBAAgB;oBACrC,IAAI,EAAE,IAAI,EAAE,mCAAmC;iBAChD;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,mCAAmC;YACnC,IAAK,KAAe,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBAC9C,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;gBACxD,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,OAAwB;QACtD,wCAAwC;QACxC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,IAAI,CAAC,cAAc,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YACxC,OAAO,CAAC,IAAI,CACV,yCAAyC,IAAI,CAAC,cAAc,CAAC,EAAE,SAAS,QAAQ,EAAE,CACnF,CAAC;QACJ,CAAC;QAED,yBAAyB;QACzB,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAEhD,0DAA0D;QAC1D,IAAI,OAAO,EAAE,cAAc,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;YACxD,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED;;OAEG;IACM,KAAK,CAAC,UAAU;QACvB,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW;QAChB,OAAO,OAAO,SAAS,KAAK,WAAW,IAAI,WAAW,IAAI,SAAS,CAAC;IACtE,CAAC;CACF;AAjGD,sCAiGC"}