@neurosity/sdk 6.4.0 → 6.5.0

package/dist/cjs/api/bluetooth/BluetoothClient.d.ts

@@ -50,7 +50,7 @@ export declare class BluetoothClient {
     logs(): Observable<string>;
     getDeviceId(): Promise<string>;
     _withAuthentication<T>(getter: () => Promise<T>): Promise<T>;
-    _subscribeWhileAuthenticated(characteristicName: string): Observable<any>;
+    _subscribeWhileAuthenticated(characteristicName: string, skipJSONDecoding?: boolean): Observable<any>;
     focus(): Observable<any>;
     calm(): Observable<any>;
     accelerometer(): Observable<any>;

package/dist/cjs/api/bluetooth/BluetoothClient.js

@@ -15,7 +15,7 @@ const rxjs_2 = require("rxjs");
 const operators_1 = require("rxjs/operators");
 const WebBluetoothTransport_1 = require("./web/WebBluetoothTransport");
 const ReactNativeTransport_1 = require("./react-native/ReactNativeTransport");
-const csvBufferToEpoch_1 = require("./utils/csvBufferToEpoch");
+const binaryBufferToEpoch_1 = require("./utils/binaryBufferToEpoch");
 const types_1 = require("./types");
 class BluetoothClient {
     constructor(options) {
@@ -63,9 +63,10 @@ class BluetoothClient {
         this._focus$ = this._subscribeWhileAuthenticated("focus");
         this._calm$ = this._subscribeWhileAuthenticated("calm");
         this._accelerometer$ = this._subscribeWhileAuthenticated("accelerometer");
-        this._brainwavesRaw$ = this._subscribeWhileAuthenticated("raw");
-        this._brainwavesRawUnfiltered$ =
-            this._subscribeWhileAuthenticated("rawUnfiltered");
+        this._brainwavesRaw$ = this._subscribeWhileAuthenticated("raw", true // skipJSONDecoding
+        );
+        this._brainwavesRawUnfiltered$ = this._subscribeWhileAuthenticated("rawUnfiltered", true // skipJSONDecoding
+        );
         this._brainwavesPSD$ = this._subscribeWhileAuthenticated("psd");
         this._brainwavesPowerByBand$ =
             this._subscribeWhileAuthenticated("powerByBand");
@@ -120,9 +121,17 @@ class BluetoothClient {
     }
     isAuthenticated() {
         return __awaiter(this, void 0, void 0, function* () {
-            const [isAuthenticated, expiresIn] = yield this.transport.readCharacteristic("auth", true);
-            this.isAuthenticated$.next(isAuthenticated);
-            return [isAuthenticated, expiresIn];
+            try {
+                const [isAuthenticated, expiresIn] = yield this.transport.readCharacteristic("auth", true);
+                this.isAuthenticated$.next(isAuthenticated);
+                return [isAuthenticated, expiresIn];
+            }
+            catch (error) {
+                const failedResponse = [false, null];
+                this.transport.addLog(`Authentication error -> ${error}`);
+                this.isAuthenticated$.next(false);
+                return failedResponse;
+            }
         });
     }
     // Method for React Native only
@@ -179,10 +188,11 @@ class BluetoothClient {
             return yield getter();
         });
     }
-    _subscribeWhileAuthenticated(characteristicName) {
+    _subscribeWhileAuthenticated(characteristicName, skipJSONDecoding = false) {
         return this.osHasBluetoothSupport$.pipe((0, operators_1.switchMap)((osHasBluetoothSupport) => osHasBluetoothSupport ? this.isAuthenticated$ : rxjs_2.EMPTY), (0, operators_1.distinctUntilChanged)(), (0, operators_1.switchMap)((isAuthenticated) => isAuthenticated
             ? this.transport.subscribeToCharacteristic({
-                characteristicName
+                characteristicName,
+                skipJSONDecoding
             })
             : rxjs_2.EMPTY), (0, operators_1.share)());
     }
@@ -199,9 +209,9 @@ class BluetoothClient {
         switch (label) {
             default:
             case "raw":
-                return (0, rxjs_1.defer)(() => this.getInfo()).pipe((0, operators_1.switchMap)((deviceInfo) => this._brainwavesRaw$.pipe((0, csvBufferToEpoch_1.csvBufferToEpoch)(deviceInfo))));
+                return (0, rxjs_1.defer)(() => this.getInfo()).pipe((0, operators_1.switchMap)((deviceInfo) => this._brainwavesRaw$.pipe((0, binaryBufferToEpoch_1.binaryBufferToEpoch)(deviceInfo))));
             case "rawUnfiltered":
-                return (0, rxjs_1.defer)(() => this.getInfo()).pipe((0, operators_1.switchMap)((deviceInfo) => this._brainwavesRawUnfiltered$.pipe((0, csvBufferToEpoch_1.csvBufferToEpoch)(deviceInfo))));
+                return (0, rxjs_1.defer)(() => this.getInfo()).pipe((0, operators_1.switchMap)((deviceInfo) => this._brainwavesRawUnfiltered$.pipe((0, binaryBufferToEpoch_1.binaryBufferToEpoch)(deviceInfo))));
             case "psd":
                 return this._brainwavesPSD$;
             case "powerByBand":

package/dist/cjs/api/bluetooth/react-native/ReactNativeTransport.d.ts

@@ -1,5 +1,6 @@
 import { Observable, BehaviorSubject, ReplaySubject } from "rxjs";
 import { BluetoothTransport } from "../BluetoothTransport";
+import { TextCodec } from "../utils/textCodec";
 import { ActionOptions, SubscribeOptions } from "../types";
 import { TRANSPORT_TYPE, BLUETOOTH_CONNECTION } from "../types";
 import { BleManager } from "./types/BleManagerTypes";
@@ -31,6 +32,7 @@ declare type BleManagerEvents = {
 };
 export declare class ReactNativeTransport implements BluetoothTransport {
     type: TRANSPORT_TYPE;
+    textCodec: TextCodec;
     options: Options;
     BleManager: BleManager;
     bleManagerEmitter: NativeEventEmitter;
@@ -59,7 +61,7 @@ export declare class ReactNativeTransport implements BluetoothTransport {
     connect(peripheral: Peripheral): Promise<void>;
     disconnect(): Promise<void>;
     getCharacteristicByName(characteristicName: string): Characteristic;
-    subscribeToCharacteristic({ characteristicName, manageNotifications }: SubscribeOptions): Observable<any>;
+    subscribeToCharacteristic({ characteristicName, manageNotifications, skipJSONDecoding }: SubscribeOptions): Observable<any>;
     readCharacteristic(characteristicName: string, parse?: boolean): Promise<any>;
     writeCharacteristic(characteristicName: string, data: string): Promise<void>;
     _addPendingAction(actionId: number): void;

package/dist/cjs/api/bluetooth/react-native/ReactNativeTransport.js

@@ -19,19 +19,20 @@ const operators_1 = require("rxjs/operators");
 const operators_2 = require("rxjs/operators");
 const operators_3 = require("rxjs/operators");
 const create6DigitPin_1 = require("../utils/create6DigitPin");
-const stitch_1 = require("../utils/stitch");
-const encoding_1 = require("../utils/encoding");
+const textCodec_1 = require("../utils/textCodec");
 const types_1 = require("../types");
 const constants_1 = require("../constants");
 const constants_2 = require("../constants");
 const constants_3 = require("../constants");
 const constants_4 = require("../constants");
+const decodeJSONChunks_1 = require("../utils/decodeJSONChunks");
 const defaultOptions = {
     autoConnect: true
 };
 class ReactNativeTransport {
     constructor(options) {
         this.type = types_1.TRANSPORT_TYPE.REACT_NATIVE;
+        this.textCodec = new textCodec_1.TextCodec(this.type);
         this.characteristicsByName = {};
         this.connection$ = new rxjs_1.BehaviorSubject(types_1.BLUETOOTH_CONNECTION.DISCONNECTED);
         this.pendingActions$ = new rxjs_1.BehaviorSubject([]);
@@ -182,7 +183,8 @@ class ReactNativeTransport {
             // it only has peripheral.advertising.localName as deviceNickname
             // and OS v16 has both as deviceNickname
             const peripheralName = (_c = (_b = (_a = peripheral === null || peripheral === void 0 ? void 0 : peripheral.advertising) === null || _a === void 0 ? void 0 : _a.localName) !== null && _b !== void 0 ? _b : peripheral.name) !== null && _c !== void 0 ? _c : "";
-            const manufactureDataString = (_h = (_g = (0, encoding_1.decode)(this.type, (_f = (_e = (_d = peripheral === null || peripheral === void 0 ? void 0 : peripheral.advertising) === null || _d === void 0 ? void 0 : _d.manufacturerData) === null || _e === void 0 ? void 0 : _e.bytes) !== null && _f !== void 0 ? _f : [])) === null || _g === void 0 ? void 0 : _g.slice) === null || _h === void 0 ? void 0 : _h.call(_g, 2); // First 2 bytes are reserved for the Neurosity company code
+            const manufactureDataString = (_h = (_g = this.textCodec
+                .decode((_f = (_e = (_d = peripheral === null || peripheral === void 0 ? void 0 : peripheral.advertising) === null || _d === void 0 ? void 0 : _d.manufacturerData) === null || _e === void 0 ? void 0 : _e.bytes) !== null && _f !== void 0 ? _f : [])) === null || _g === void 0 ? void 0 : _g.slice) === null || _h === void 0 ? void 0 : _h.call(_g, 2); // First 2 bytes are reserved for the Neurosity company code
             return Object.assign(Object.assign({}, acc), { [peripheral.id]: Object.assign(Object.assign({}, peripheral), { name: peripheralName, manufactureDataString }) });
         }, {}), (0, operators_2.distinctUntilChanged)((a, b) => JSON.stringify(a) === JSON.stringify(b)), (0, operators_1.map)((peripheralMap) => Object.values(peripheralMap)), (0, operators_3.share)());
         return peripherals$;
@@ -257,7 +259,7 @@ class ReactNativeTransport {
         }
         return (_a = this.characteristicsByName) === null || _a === void 0 ? void 0 : _a[characteristicName];
     }
-    subscribeToCharacteristic({ characteristicName, manageNotifications = true }) {
+    subscribeToCharacteristic({ characteristicName, manageNotifications = true, skipJSONDecoding = false }) {
         const getData = ({ peripheralId, serviceUUID, characteristicUUID }) => (0, rxjs_2.defer)(() => __awaiter(this, void 0, void 0, function* () {
             var _a;
             if (manageNotifications) {
@@ -280,18 +282,16 @@ class ReactNativeTransport {
                     this.addLog(`Attemped to stop notifications for ${characteristicName} characteristic: ${(_b = error === null || error === void 0 ? void 0 : error.message) !== null && _b !== void 0 ? _b : error}`);
                 }
             }
-        })), (0, operators_1.filter)(({ characteristic }) => characteristic === characteristicUUID), (0, operators_1.map)(({ value }) => (0, encoding_1.decode)(this.type, value)), (0, stitch_1.stitchChunks)({ delimiter: ipk_2.BLUETOOTH_CHUNK_DELIMITER }), (0, operators_1.map)((payload) => {
-            var _a;
-            try {
-                return JSON.parse(payload);
-            }
-            catch (error) {
-                this.addLog(`Failed to parse JSON for ${characteristicName} characteristic. Falling back to unparsed string. ${(_a = error === null || error === void 0 ? void 0 : error.message) !== null && _a !== void 0 ? _a : error}`);
-                return payload;
-            }
-        }));
+        })), (0, operators_1.filter)(({ characteristic }) => characteristic === characteristicUUID), (0, operators_1.map)(({ value }) => new Uint8Array(value)));
         return this.connection$.pipe((0, operators_1.switchMap)((connection) => connection === types_1.BLUETOOTH_CONNECTION.CONNECTED
-            ? getData(this.getCharacteristicByName(characteristicName))
+            ? getData(this.getCharacteristicByName(characteristicName)).pipe(skipJSONDecoding
+                ? rxjs_2.identity // noop
+                : (0, decodeJSONChunks_1.decodeJSONChunks)({
+                    textCodec: this.textCodec,
+                    characteristicName,
+                    delimiter: ipk_2.BLUETOOTH_CHUNK_DELIMITER,
+                    addLog: (message) => this.addLog(message)
+                }))
             : rxjs_1.NEVER));
     }
     readCharacteristic(characteristicName, parse = false) {
@@ -304,7 +304,7 @@ class ReactNativeTransport {
             }
             try {
                 const value = yield this.BleManager.read(peripheralId, serviceUUID, characteristicUUID);
-                const decodedValue = (0, encoding_1.decode)(this.type, value);
+                const decodedValue = this.textCodec.decode(new Uint8Array(value));
                 const data = parse ? JSON.parse(decodedValue) : decodedValue;
                 this.addLog(`Received read data from ${characteristicName} characteristic: \n${data}`);
                 return data;
@@ -321,7 +321,7 @@ class ReactNativeTransport {
             if (!characteristicUUID) {
                 return Promise.reject(new Error(`Did not find characteristic matching ${characteristicName}`));
             }
-            const encoded = (0, encoding_1.encode)(this.type, data);
+            const encoded = this.textCodec.encode(data);
             yield this.BleManager.write(peripheralId, serviceUUID, characteristicUUID, encoded, constants_4.REACT_NATIVE_MAX_BYTE_SIZE);
         });
     }

package/dist/cjs/api/bluetooth/types/index.d.ts

@@ -11,6 +11,7 @@ export declare type ActionOptions = {
 export declare type SubscribeOptions = {
     characteristicName: string;
     manageNotifications?: boolean;
+    skipJSONDecoding?: boolean;
 };
 /**
  * @hidden

package/dist/cjs/api/bluetooth/utils/binaryBufferToEpoch.d.ts

@@ -0,0 +1,51 @@
+import { Observable, UnaryFunction } from "rxjs";
+import { Buffer } from "buffer/index.js";
+import { Sample } from "../../../types/sample";
+import { Epoch } from "../../../types/epoch";
+import { DeviceInfo } from "../../../types/deviceInfo";
+/**
+ * @hidden
+ */
+export declare function binaryBufferToEpoch(deviceInfo: DeviceInfo): UnaryFunction<Observable<Epoch>, any>;
+/**
+ * @hidden
+ */
+export declare function binaryBufferToSamples(channelCount: number): UnaryFunction<any, any>;
+/**
+ * @hidden
+ *
+ * Decode the supplied Buffer as a list of Sample.
+ *
+ * Supplied buffer's length must be multiple of
+ * `encodedSampleSize(channelCount)`.
+ *
+ * NB: This method does not guarantee validity of decoded samples. When
+ * supplied with a buffer of appropriate length, it will always return a
+ * matching number of Sample8. Since the encoding protocol defines no
+ * metadata/checksum, correctness must be guaranteed via test coverage.
+ *
+ * @param buffer Buffer with binary payload to decode.
+ * @param channelCount Number of expected channels in each sample.
+ *
+ * @returns List of decoded Samples present in buffer.
+ */
+export declare function decode(buffer: Buffer, channelCount: number): Array<Sample>;
+/**
+ * @hidden
+ *
+ * Calculate the size of each sample based on the number of channels.
+ *
+ * Each sample has the following 3 segments:
+ * - Timestamp: 8 bytes (UInt64); contains current time in millis since epoch)
+ * - Marker: 2 bytes (UInt16); for classifier data
+ * - Data: N * 8 bytes (Double), each entry representing data from a different
+ *   electrode.
+ *
+ *  +-----------+--------+------------------+
+ *  | timestamp | marker | data (e1 ... eN) |
+ *  +-----------+--------+------------------+
+ *
+ * The number of entries for Data varies per hardware model. It can be assumed
+ * to remain constant for the lifetime of the program.
+ */
+export declare function encodedSampleSize(channelCount: number): number;

package/dist/cjs/api/bluetooth/utils/binaryBufferToEpoch.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodedSampleSize = exports.decode = exports.binaryBufferToSamples = exports.binaryBufferToEpoch = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const index_js_1 = require("buffer/index.js"); // not including /index.js causes typescript to uses Node's native Buffer built-in and we want to use this npm package for both node and the browser
+const pipes_1 = require("../../../utils/pipes");
+const EPOCH_BUFFER_SIZE = 16;
+const SAMPLING_RATE_FALLBACK = 256; // Crown's sampling rate
+/** Size in bytes for each channel's payload. */
+const TimestampSize = 8; // UInt64
+const MarkerSize = 2; // UInt16
+const ChannelDataSize = 8; // Double
+/** Size in bytes for the static payload of every sample (Timestamp + Marker) */
+const SampleFixedSize = TimestampSize + MarkerSize;
+/**
+ * @hidden
+ */
+function binaryBufferToEpoch(deviceInfo) {
+    var _a;
+    if (!(deviceInfo === null || deviceInfo === void 0 ? void 0 : deviceInfo.samplingRate)) {
+        console.warn(`Didn't receive a sampling rate, defaulting to ${SAMPLING_RATE_FALLBACK}`);
+    }
+    return (0, rxjs_1.pipe)(binaryBufferToSamples(deviceInfo.channels), (0, pipes_1.epoch)({
+        duration: EPOCH_BUFFER_SIZE,
+        interval: EPOCH_BUFFER_SIZE,
+        samplingRate: (_a = deviceInfo === null || deviceInfo === void 0 ? void 0 : deviceInfo.samplingRate) !== null && _a !== void 0 ? _a : SAMPLING_RATE_FALLBACK
+    }), (0, pipes_1.addInfo)({
+        channelNames: deviceInfo.channelNames,
+        samplingRate: deviceInfo.samplingRate
+    }));
+}
+exports.binaryBufferToEpoch = binaryBufferToEpoch;
+/**
+ * @hidden
+ */
+function binaryBufferToSamples(channelCount) {
+    return (0, rxjs_1.pipe)((0, operators_1.mergeMap)((arrayBuffer) => {
+        const buffer = index_js_1.Buffer.from(arrayBuffer);
+        const decoded = decode(buffer, channelCount);
+        return (0, rxjs_1.from)(decoded); // `from` creates an Observable emission from each item (Sample) in the array
+    }));
+}
+exports.binaryBufferToSamples = binaryBufferToSamples;
+/**
+ * @hidden
+ *
+ * Decode the supplied Buffer as a list of Sample.
+ *
+ * Supplied buffer's length must be multiple of
+ * `encodedSampleSize(channelCount)`.
+ *
+ * NB: This method does not guarantee validity of decoded samples. When
+ * supplied with a buffer of appropriate length, it will always return a
+ * matching number of Sample8. Since the encoding protocol defines no
+ * metadata/checksum, correctness must be guaranteed via test coverage.
+ *
+ * @param buffer Buffer with binary payload to decode.
+ * @param channelCount Number of expected channels in each sample.
+ *
+ * @returns List of decoded Samples present in buffer.
+ */
+function decode(buffer, channelCount) {
+    let sampleLen = encodedSampleSize(channelCount);
+    // Alternative: relax this check, process sampleLen at a time, discard remainder?
+    if (buffer.length % sampleLen != 0) {
+        throw new Error(`buffer.length (${buffer.length}) for ${channelCount} channels must be multiple of ${sampleLen}B)`);
+    }
+    let sampleCount = buffer.length / sampleLen;
+    let samples = new Array(sampleCount);
+    for (let i = 0; i < sampleCount; i++) {
+        let offset = i * sampleLen;
+        let channelData = new Array(channelCount);
+        // Read 8 bytes for timestamp & advance offset
+        let ts = buffer.readBigUInt64BE(offset);
+        offset += TimestampSize;
+        // Read 1 byte for marker & advance offset
+        let marker = buffer.readUInt16BE(offset);
+        offset += MarkerSize;
+        // Read 8 bytes for each channel & advance offset
+        for (let i = 0; i < channelCount; i++) {
+            channelData[i] = buffer.readDoubleBE(offset);
+            offset += ChannelDataSize;
+        }
+        samples[i] = {
+            timestamp: Number(ts),
+            // TODO: uncomment when ready
+            // marker: marker,
+            data: channelData
+        };
+    }
+    return samples;
+}
+exports.decode = decode;
+/**
+ * @hidden
+ *
+ * Calculate the size of each sample based on the number of channels.
+ *
+ * Each sample has the following 3 segments:
+ * - Timestamp: 8 bytes (UInt64); contains current time in millis since epoch)
+ * - Marker: 2 bytes (UInt16); for classifier data
+ * - Data: N * 8 bytes (Double), each entry representing data from a different
+ *   electrode.
+ *
+ *  +-----------+--------+------------------+
+ *  | timestamp | marker | data (e1 ... eN) |
+ *  +-----------+--------+------------------+
+ *
+ * The number of entries for Data varies per hardware model. It can be assumed
+ * to remain constant for the lifetime of the program.
+ */
+function encodedSampleSize(channelCount) {
+    return SampleFixedSize + channelCount * ChannelDataSize;
+}
+exports.encodedSampleSize = encodedSampleSize;

package/dist/cjs/api/bluetooth/utils/decodeJSONChunks.d.ts

@@ -0,0 +1,15 @@
+import { TextCodec } from "./textCodec";
+/**
+ * @hidden
+ */
+declare type Options = {
+    textCodec: TextCodec;
+    characteristicName: string;
+    delimiter: string;
+    addLog: (message: string) => void;
+};
+/**
+ * @hidden
+ */
+export declare function decodeJSONChunks({ textCodec, characteristicName, delimiter, addLog }: Options): import("rxjs").UnaryFunction<import("rxjs").Observable<Uint8Array>, import("rxjs").Observable<any>>;
+export {};

package/dist/cjs/api/bluetooth/utils/decodeJSONChunks.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeJSONChunks = void 0;
+const rxjs_1 = require("rxjs");
+const stitch_1 = require("./stitch");
+/**
+ * @hidden
+ */
+function decodeJSONChunks({ textCodec, characteristicName, delimiter, addLog }) {
+    return (0, rxjs_1.pipe)((0, rxjs_1.map)((arrayBuffer) => {
+        const decoded = textCodec.decode(arrayBuffer);
+        addLog(`Received chunk with buffer size of ${arrayBuffer.byteLength} and decoded size ${decoded.length} for ${characteristicName} characteristic: \n${decoded}`);
+        return decoded;
+    }), (0, stitch_1.stitchChunks)({ delimiter }), (0, rxjs_1.map)((payload) => {
+        var _a;
+        try {
+            return JSON.parse(payload);
+        }
+        catch (error) {
+            addLog(`Failed to parse JSON for ${characteristicName} characteristic. Falling back to unparsed string. ${(_a = error === null || error === void 0 ? void 0 : error.message) !== null && _a !== void 0 ? _a : error}`);
+            return payload;
+        }
+    }));
+}
+exports.decodeJSONChunks = decodeJSONChunks;

package/dist/cjs/api/bluetooth/utils/textCodec.d.ts

@@ -0,0 +1,17 @@
+import { TRANSPORT_TYPE } from "../types";
+/**
+ * @hidden
+ * Uint8Array in Web | number[] in React Native
+ */
+export declare type BufferLike = Uint8Array | number[];
+/**
+ * @hidden
+ */
+export declare class TextCodec {
+    transportType: TRANSPORT_TYPE;
+    webEncoder: TextEncoder;
+    webDecoder: TextDecoder;
+    constructor(transportType: TRANSPORT_TYPE);
+    encode(data: string): BufferLike;
+    decode(arrayBuffer: Uint8Array): string;
+}

package/dist/cjs/api/bluetooth/utils/textCodec.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextCodec = void 0;
+const index_js_1 = require("buffer/index.js"); // not including /index.js causes typescript to uses Node's native Buffer built-in and we want to use this npm package for both node and the browser
+const types_1 = require("../types");
+/**
+ * @hidden
+ */
+class TextCodec {
+    constructor(transportType) {
+        this.transportType = transportType;
+        if (transportType === types_1.TRANSPORT_TYPE.WEB) {
+            this.webEncoder = new TextEncoder();
+            this.webDecoder = new TextDecoder("utf-8");
+        }
+    }
+    encode(data) {
+        if (this.transportType === types_1.TRANSPORT_TYPE.WEB) {
+            const encoded = this.webEncoder.encode(data);
+            return encoded;
+        }
+        if (this.transportType === types_1.TRANSPORT_TYPE.REACT_NATIVE) {
+            // React Native BLE Manager expects a number[] instead of a Uint8Array
+            const encoded = [...index_js_1.Buffer.from(data)];
+            return encoded;
+        }
+        const encoded = index_js_1.Buffer.from(data);
+        return encoded;
+    }
+    decode(arrayBuffer) {
+        if (this.transportType === types_1.TRANSPORT_TYPE.WEB) {
+            const decoded = this.webDecoder.decode(arrayBuffer);
+            return decoded;
+        }
+        // For React Native, and as a default
+        const decoded = index_js_1.Buffer.from(arrayBuffer).toString("utf-8");
+        return decoded;
+    }
+}
+exports.TextCodec = TextCodec;

package/dist/cjs/api/bluetooth/web/WebBluetoothTransport.d.ts

@@ -1,6 +1,7 @@
 /// <reference types="web-bluetooth" />
 import { Observable, BehaviorSubject, ReplaySubject } from "rxjs";
 import { BluetoothTransport } from "../BluetoothTransport";
+import { TextCodec } from "../utils/textCodec";
 import { ActionOptions, SubscribeOptions } from "../types";
 import { TRANSPORT_TYPE, BLUETOOTH_CONNECTION } from "../types";
 import { DeviceInfo } from "../../../types/deviceInfo";
@@ -9,6 +10,7 @@ declare type Options = {
 };
 export declare class WebBluetoothTransport implements BluetoothTransport {
     type: TRANSPORT_TYPE;
+    textCodec: TextCodec;
     options: Options;
     device: BluetoothDevice;
     server: BluetoothRemoteGATTServer;
@@ -42,7 +44,7 @@ export declare class WebBluetoothTransport implements BluetoothTransport {
      * after reconnecting.
      */
     getCharacteristicByName(characteristicName: string): Promise<BluetoothRemoteGATTCharacteristic>;
-    subscribeToCharacteristic({ characteristicName, manageNotifications }: SubscribeOptions): Observable<any>;
+    subscribeToCharacteristic({ characteristicName, manageNotifications, skipJSONDecoding }: SubscribeOptions): Observable<any>;
     readCharacteristic(characteristicName: string, parse?: boolean): Promise<any>;
     writeCharacteristic(characteristicName: string, data: string): Promise<void>;
     _addPendingAction(actionId: number): void;

package/dist/cjs/api/bluetooth/web/WebBluetoothTransport.js

@@ -21,17 +21,18 @@ const operators_2 = require("rxjs/operators");
 const operators_3 = require("rxjs/operators");
 const isWebBluetoothSupported_1 = require("./isWebBluetoothSupported");
 const create6DigitPin_1 = require("../utils/create6DigitPin");
-const stitch_1 = require("../utils/stitch");
-const encoding_1 = require("../utils/encoding");
+const textCodec_1 = require("../utils/textCodec");
 const types_1 = require("../types");
 const constants_1 = require("../constants");
 const constants_2 = require("../constants");
+const decodeJSONChunks_1 = require("../utils/decodeJSONChunks");
 const defaultOptions = {
     autoConnect: true
 };
 class WebBluetoothTransport {
     constructor(options = {}) {
         this.type = types_1.TRANSPORT_TYPE.WEB;
+        this.textCodec = new textCodec_1.TextCodec(this.type);
         this.characteristicsByName = {};
         this.connection$ = new rxjs_1.BehaviorSubject(types_1.BLUETOOTH_CONNECTION.DISCONNECTED);
         this.pendingActions$ = new rxjs_1.BehaviorSubject([]);
@@ -211,7 +212,7 @@ class WebBluetoothTransport {
             return (_a = this.characteristicsByName) === null || _a === void 0 ? void 0 : _a[characteristicName];
         });
     }
-    subscribeToCharacteristic({ characteristicName, manageNotifications = true }) {
+    subscribeToCharacteristic({ characteristicName, manageNotifications = true, skipJSONDecoding = false }) {
         const data$ = (0, rxjs_2.defer)(() => this.getCharacteristicByName(characteristicName)).pipe((0, operators_1.switchMap)((characteristic) => __awaiter(this, void 0, void 0, function* () {
             var _a;
             if (this.isConnected() && manageNotifications) {
@@ -237,33 +238,17 @@ class WebBluetoothTransport {
                     }
                 }
             }));
-        }), (0, operators_1.map)((event) => {
-            const buffer = event.target.value;
-            const decoded = (0, encoding_1.decode)(this.type, buffer);
-            this.addLog(`Received chunk with buffer size of ${buffer.byteLength} and decoded size ${decoded.length} for ${characteristicName} characteristic: \n${decoded}`);
-            return decoded;
-        }), (0, stitch_1.stitchChunks)({ delimiter: ipk_2.BLUETOOTH_CHUNK_DELIMITER }), (0, operators_1.map)((payload) => {
-            var _a;
-            try {
-                return JSON.parse(payload);
-            }
-            catch (error) {
-                this.addLog(`Failed to parse JSON for ${characteristicName} characteristic. Falling back to unparsed string. ${(_a = error === null || error === void 0 ? void 0 : error.message) !== null && _a !== void 0 ? _a : error}`);
-                return payload;
-            }
-        })
-        // when streaming at ultra-low latency, the logs will slow down rendering
-        // tap((data) => {
-        //   this.addLog(
-        //     `Received data for ${characteristicName} characteristic: \n${JSON.stringify(
-        //       data,
-        //       null,
-        //       2
-        //     )}`
-        //   );
-        // })
-        );
-        return this.connection$.pipe((0, operators_1.switchMap)((connection) => connection === types_1.BLUETOOTH_CONNECTION.CONNECTED ? data$ : rxjs_2.NEVER));
+        }), (0, operators_1.map)((event) => event.target.value.buffer));
+        return this.connection$.pipe((0, operators_1.switchMap)((connection) => connection === types_1.BLUETOOTH_CONNECTION.CONNECTED
+            ? data$.pipe(skipJSONDecoding
+                ? rxjs_1.identity // noop
+                : (0, decodeJSONChunks_1.decodeJSONChunks)({
+                    textCodec: this.textCodec,
+                    characteristicName,
+                    delimiter: ipk_2.BLUETOOTH_CHUNK_DELIMITER,
+                    addLog: (message) => this.addLog(message)
+                }))
+            : rxjs_2.NEVER));
     }
     readCharacteristic(characteristicName, parse = false) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -274,9 +259,9 @@ class WebBluetoothTransport {
                     this.addLog(`Did not fund ${characteristicName} characteristic`);
                     return Promise.reject(`Did not find characteristic by the name: ${characteristicName}`);
                 }
-                const value = yield characteristic.readValue();
-                const uint8Array = value;
-                const decodedValue = (0, encoding_1.decode)(this.type, uint8Array);
+                const dataview = yield characteristic.readValue();
+                const arrayBuffer = dataview.buffer;
+                const decodedValue = this.textCodec.decode(arrayBuffer);
                 const data = parse ? JSON.parse(decodedValue) : decodedValue;
                 this.addLog(`Received read data from ${characteristicName} characteristic: \n${data}`);
                 return data;
@@ -294,7 +279,7 @@ class WebBluetoothTransport {
                 this.addLog(`Did not fund ${characteristicName} characteristic`);
                 return Promise.reject(`Did not find characteristic by the name: ${characteristicName}`);
             }
-            const encoded = (0, encoding_1.encode)(this.type, data);
+            const encoded = this.textCodec.encode(data);
             yield characteristic.writeValueWithResponse(encoded);
         });
     }