@bota-dev/react-native-sdk 0.0.2

package/lib/module/protocol/ProtocolHandler.js

@@ -0,0 +1,336 @@
+/**
+ * Protocol Handler - Implements Device-App Protocol for recording transfer
+ */
+
+import { Buffer } from 'buffer';
+import { getBleManager } from '../ble/BleManager';
+import { SERVICE_BOTA_STORAGE, CHAR_STORAGE_INFO, CHAR_RECORDING_LIST, CHAR_RECORDING_TRANSFER, CHAR_TRANSFER_CONTROL, TRANSFER_PACKET_TIMEOUT } from '../ble/constants';
+import { parseStorageInfo, parseRecordingList, parseTransferPacket, createAckPacket, createTransferCommand } from '../ble/parsers';
+import { TransferError, DeviceError } from '../utils/errors';
+import { logger } from '../utils/logger';
+const log = logger.tag('ProtocolHandler');
+
+/**
+ * Transfer state for tracking ongoing transfers
+ */
+
+/**
+ * Transfer progress callback
+ */
+
+/**
+ * Protocol Handler class
+ */
+export class ProtocolHandler {
+  activeTransfers = new Map();
+  constructor() {
+    this.bleManager = getBleManager();
+  }
+
+  /**
+   * Get storage info from device
+   */
+  async getStorageInfo(deviceId) {
+    if (!this.bleManager.isConnected(deviceId)) {
+      throw DeviceError.notConnected(deviceId);
+    }
+    const data = await this.bleManager.readCharacteristic(deviceId, SERVICE_BOTA_STORAGE, CHAR_STORAGE_INFO);
+    return parseStorageInfo(data);
+  }
+
+  /**
+   * List recordings on device
+   */
+  async listRecordings(deviceId) {
+    if (!this.bleManager.isConnected(deviceId)) {
+      throw DeviceError.notConnected(deviceId);
+    }
+    log.debug('Listing recordings', {
+      deviceId
+    });
+    return new Promise((resolve, reject) => {
+      let recordings = [];
+      let subscription;
+      let timeoutId;
+      const cleanup = () => {
+        if (timeoutId) clearTimeout(timeoutId);
+        subscription?.remove();
+      };
+
+      // Set up timeout
+      timeoutId = setTimeout(() => {
+        cleanup();
+        // If we received some data, return it; otherwise error
+        if (recordings.length > 0) {
+          resolve(recordings);
+        } else {
+          reject(new TransferError('Timeout waiting for recording list', 'LIST_TIMEOUT'));
+        }
+      }, 5000);
+
+      // Subscribe to recording list notifications
+      subscription = this.bleManager.subscribeToCharacteristic(deviceId, SERVICE_BOTA_STORAGE, CHAR_RECORDING_LIST, data => {
+        try {
+          const parsed = parseRecordingList(data);
+          recordings = recordings.concat(parsed);
+
+          // Check if this is the last packet (could check for end marker)
+          // For now, wait for timeout or explicit end
+        } catch (error) {
+          log.error('Failed to parse recording list', error);
+        }
+      }, error => {
+        cleanup();
+        reject(error);
+      });
+
+      // Send list command
+      const command = createTransferCommand('list');
+      this.bleManager.writeCharacteristic(deviceId, SERVICE_BOTA_STORAGE, CHAR_TRANSFER_CONTROL, command).catch(error => {
+        cleanup();
+        reject(error);
+      });
+    });
+  }
+
+  /**
+   * Transfer a recording from device
+   * Returns the audio data as a Buffer
+   */
+  async transferRecording(deviceId, recordingUuid, onProgress) {
+    if (!this.bleManager.isConnected(deviceId)) {
+      throw DeviceError.notConnected(deviceId);
+    }
+
+    // Check if transfer already in progress
+    if (this.activeTransfers.has(recordingUuid)) {
+      throw new TransferError('Transfer already in progress for this recording', 'TRANSFER_IN_PROGRESS', recordingUuid);
+    }
+    log.info('Starting recording transfer', {
+      deviceId,
+      recordingUuid
+    });
+    return new Promise((resolve, reject) => {
+      const state = {
+        recordingUuid,
+        expectedSequence: 0,
+        receivedPackets: new Map(),
+        totalBytes: 0,
+        isComplete: false
+      };
+      this.activeTransfers.set(recordingUuid, state);
+      const cleanup = () => {
+        if (state.timeoutId) clearTimeout(state.timeoutId);
+        state.subscription?.remove();
+        this.activeTransfers.delete(recordingUuid);
+      };
+      const resetTimeout = () => {
+        if (state.timeoutId) clearTimeout(state.timeoutId);
+        state.timeoutId = setTimeout(() => {
+          cleanup();
+          reject(TransferError.timeout(recordingUuid));
+        }, TRANSFER_PACKET_TIMEOUT);
+      };
+
+      // Subscribe to transfer data notifications
+      state.subscription = this.bleManager.subscribeToCharacteristic(deviceId, SERVICE_BOTA_STORAGE, CHAR_RECORDING_TRANSFER, async data => {
+        try {
+          resetTimeout();
+          const packet = parseTransferPacket(data);
+          await this.handleTransferPacket(deviceId, state, packet, onProgress);
+          if (state.isComplete) {
+            cleanup();
+
+            // Assemble the audio data
+            const audioData = this.assembleAudioData(state);
+
+            // Verify checksum if available
+            if (state.checksum !== undefined) {
+              const calculatedChecksum = this.calculateCrc32(audioData);
+              if (calculatedChecksum !== state.checksum) {
+                reject(TransferError.checksumMismatch(recordingUuid));
+                return;
+              }
+            }
+            log.info('Transfer completed', {
+              recordingUuid,
+              size: audioData.length
+            });
+            resolve(audioData);
+          }
+        } catch (error) {
+          cleanup();
+          reject(error);
+        }
+      }, error => {
+        cleanup();
+        reject(TransferError.interrupted(recordingUuid, error));
+      });
+
+      // Send start transfer command
+      const command = createTransferCommand('start', recordingUuid);
+      this.bleManager.writeCharacteristic(deviceId, SERVICE_BOTA_STORAGE, CHAR_TRANSFER_CONTROL, command).then(() => {
+        resetTimeout();
+      }).catch(error => {
+        cleanup();
+        reject(error);
+      });
+    });
+  }
+
+  /**
+   * Handle a transfer packet from device
+   */
+  async handleTransferPacket(deviceId, state, packet, onProgress) {
+    switch (packet.type) {
+      case 'data':
+        if (packet.data) {
+          // Store packet data
+          state.receivedPackets.set(packet.sequenceNumber, Buffer.from(packet.data));
+          state.totalBytes += packet.data.length;
+
+          // Send ACK
+          await this.sendAck(deviceId, 'ack', packet.sequenceNumber);
+
+          // Report progress
+          onProgress?.(state.totalBytes);
+          log.debug('Received data packet', {
+            seq: packet.sequenceNumber,
+            size: packet.data.length,
+            total: state.totalBytes
+          });
+        }
+        break;
+      case 'eof':
+        state.checksum = packet.checksum;
+        state.isComplete = true;
+
+        // Send final ACK
+        await this.sendAck(deviceId, 'ack', packet.sequenceNumber);
+        log.debug('Received EOF packet', {
+          seq: packet.sequenceNumber,
+          checksum: packet.checksum
+        });
+        break;
+      case 'error':
+        throw TransferError.deviceError(state.recordingUuid, packet.errorCode ?? 0xff);
+    }
+  }
+
+  /**
+   * Send an ACK packet to device
+   */
+  async sendAck(deviceId, type, sequenceNumber) {
+    const ackPacket = createAckPacket(type, sequenceNumber);
+    await this.bleManager.writeCharacteristic(deviceId, SERVICE_BOTA_STORAGE, CHAR_RECORDING_TRANSFER, ackPacket, false // Write without response for speed
+    );
+  }
+
+  /**
+   * Assemble audio data from received packets
+   */
+  assembleAudioData(state) {
+    // Sort packets by sequence number and concatenate
+    const sortedSequences = Array.from(state.receivedPackets.keys()).sort((a, b) => a - b);
+    const chunks = [];
+    for (const seq of sortedSequences) {
+      const data = state.receivedPackets.get(seq);
+      if (data) {
+        chunks.push(data);
+      }
+    }
+    return Buffer.concat(chunks);
+  }
+
+  /**
+   * Calculate CRC32 checksum
+   */
+  calculateCrc32(data) {
+    let crc = 0xffffffff;
+    const table = this.getCrc32Table();
+    for (let i = 0; i < data.length; i++) {
+      crc = crc >>> 8 ^ table[(crc ^ data[i]) & 0xff];
+    }
+    return (crc ^ 0xffffffff) >>> 0;
+  }
+
+  /**
+   * Get CRC32 lookup table (lazy initialized)
+   */
+  crc32Table = null;
+  getCrc32Table() {
+    if (this.crc32Table) {
+      return this.crc32Table;
+    }
+    const table = [];
+    for (let i = 0; i < 256; i++) {
+      let crc = i;
+      for (let j = 0; j < 8; j++) {
+        crc = crc & 1 ? crc >>> 1 ^ 0xedb88320 : crc >>> 1;
+      }
+      table.push(crc >>> 0);
+    }
+    this.crc32Table = table;
+    return table;
+  }
+
+  /**
+   * Confirm sync to device (allows device to delete local copy)
+   */
+  async confirmSync(deviceId, recordingUuid) {
+    if (!this.bleManager.isConnected(deviceId)) {
+      throw DeviceError.notConnected(deviceId);
+    }
+    log.debug('Confirming sync', {
+      deviceId,
+      recordingUuid
+    });
+    const command = createTransferCommand('confirm', recordingUuid);
+    await this.bleManager.writeCharacteristic(deviceId, SERVICE_BOTA_STORAGE, CHAR_TRANSFER_CONTROL, command);
+  }
+
+  /**
+   * Cancel an ongoing transfer
+   */
+  async cancelTransfer(deviceId, recordingUuid) {
+    const state = this.activeTransfers.get(recordingUuid);
+    if (!state) {
+      return;
+    }
+    log.info('Cancelling transfer', {
+      recordingUuid
+    });
+
+    // Send abort
+    try {
+      await this.sendAck(deviceId, 'abort', state.expectedSequence);
+    } catch {
+      // Ignore errors during cancellation
+    }
+
+    // Clean up
+    if (state.timeoutId) clearTimeout(state.timeoutId);
+    state.subscription?.remove();
+    this.activeTransfers.delete(recordingUuid);
+  }
+
+  /**
+   * Check if a transfer is in progress
+   */
+  isTransferInProgress(recordingUuid) {
+    return this.activeTransfers.has(recordingUuid);
+  }
+
+  /**
+   * Clean up resources
+   */
+  destroy() {
+    // Cancel all active transfers
+    for (const [, state] of this.activeTransfers) {
+      if (state.timeoutId) clearTimeout(state.timeoutId);
+      state.subscription?.remove();
+    }
+    this.activeTransfers.clear();
+  }
+}
+//# sourceMappingURL=ProtocolHandler.js.map

package/lib/module/protocol/ProtocolHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Buffer","getBleManager","SERVICE_BOTA_STORAGE","CHAR_STORAGE_INFO","CHAR_RECORDING_LIST","CHAR_RECORDING_TRANSFER","CHAR_TRANSFER_CONTROL","TRANSFER_PACKET_TIMEOUT","parseStorageInfo","parseRecordingList","parseTransferPacket","createAckPacket","createTransferCommand","TransferError","DeviceError","logger","log","tag","ProtocolHandler","activeTransfers","Map","constructor","bleManager","getStorageInfo","deviceId","isConnected","notConnected","data","readCharacteristic","listRecordings","debug","Promise","resolve","reject","recordings","subscription","timeoutId","cleanup","clearTimeout","remove","setTimeout","length","subscribeToCharacteristic","parsed","concat","error","command","writeCharacteristic","catch","transferRecording","recordingUuid","onProgress","has","info","state","expectedSequence","receivedPackets","totalBytes","isComplete","set","delete","resetTimeout","timeout","packet","handleTransferPacket","audioData","assembleAudioData","checksum","undefined","calculatedChecksum","calculateCrc32","checksumMismatch","size","interrupted","then","type","sequenceNumber","from","sendAck","seq","total","deviceError","errorCode","ackPacket","sortedSequences","Array","keys","sort","a","b","chunks","get","push","crc","table","getCrc32Table","i","crc32Table","j","confirmSync","cancelTransfer","isTransferInProgress","destroy","clear"],"sourceRoot":"../../../src","sources":["protocol/ProtocolHandler.ts"],"mappings":"AAAA;AACA;AACA;;AAEA,SAASA,MAAM,QAAQ,QAAQ;AAG/B,SAASC,aAAa,QAAoB,mBAAmB;AAC7D,SACEC,oBAAoB,EACpBC,iBAAiB,EACjBC,mBAAmB,EACnBC,uBAAuB,EACvBC,qBAAqB,EACrBC,uBAAuB,QAClB,kBAAkB;AACzB,SACEC,gBAAgB,EAChBC,kBAAkB,EAClBC,mBAAmB,EACnBC,eAAe,EACfC,qBAAqB,QAChB,gBAAgB;AAGvB,SAASC,aAAa,EAAEC,WAAW,QAAQ,iBAAiB;AAC5D,SAASC,MAAM,QAAQ,iBAAiB;AAExC,MAAMC,GAAG,GAAGD,MAAM,CAACE,GAAG,CAAC,iBAAiB,CAAC;;AAEzC;AACA;AACA;;AAYA;AACA;AACA;;AAMA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,CAAC;EAEnBC,eAAe,GAA+B,IAAIC,GAAG,CAAC,CAAC;EAE/DC,WAAWA,CAAA,EAAG;IACZ,IAAI,CAACC,UAAU,GAAGrB,aAAa,CAAC,CAAC;EACnC;;EAEA;AACF;AACA;EACE,MAAMsB,cAAcA,CAACC,QAAgB,EAAwB;IAC3D,IAAI,CAAC,IAAI,CAACF,UAAU,CAACG,WAAW,CAACD,QAAQ,CAAC,EAAE;MAC1C,MAAMV,WAAW,CAACY,YAAY,CAACF,QAAQ,CAAC;IAC1C;IAEA,MAAMG,IAAI,GAAG,MAAM,IAAI,CAACL,UAAU,CAACM,kBAAkB,CACnDJ,QAAQ,EACRtB,oBAAoB,EACpBC,iBACF,CAAC;IAED,OAAOK,gBAAgB,CAACmB,IAAI,CAAC;EAC/B;;EAEA;AACF;AACA;EACE,MAAME,cAAcA,CAACL,QAAgB,EAA8B;IACjE,IAAI,CAAC,IAAI,CAACF,UAAU,CAACG,WAAW,CAACD,QAAQ,CAAC,EAAE;MAC1C,MAAMV,WAAW,CAACY,YAAY,CAACF,QAAQ,CAAC;IAC1C;IAEAR,GAAG,CAACc,KAAK,CAAC,oBAAoB,EAAE;MAAEN;IAAS,CAAC,CAAC;IAE7C,OAAO,IAAIO,OAAO,CAAC,CAACC,OAAO,EAAEC,MAAM,KAAK;MACtC,IAAIC,UAA6B,GAAG,EAAE;MACtC,IAAIC,YAAsC;MAC1C,IAAIC,SAAqC;MAEzC,MAAMC,OAAO,GAAGA,CAAA,KAAM;QACpB,IAAID,SAAS,EAAEE,YAAY,CAACF,SAAS,CAAC;QACtCD,YAAY,EAAEI,MAAM,CAAC,CAAC;MACxB,CAAC;;MAED;MACAH,SAAS,GAAGI,UAAU,CAAC,MAAM;QAC3BH,OAAO,CAAC,CAAC;QACT;QACA,IAAIH,UAAU,CAACO,MAAM,GAAG,CAAC,EAAE;UACzBT,OAAO,CAACE,UAAU,CAAC;QACrB,CAAC,MAAM;UACLD,MAAM,CAAC,IAAIpB,aAAa,CACtB,oCAAoC,EACpC,cACF,CAAC,CAAC;QACJ;MACF,CAAC,EAAE,IAAI,CAAC;;MAER;MACAsB,YAAY,GAAG,IAAI,CAACb,UAAU,CAACoB,yBAAyB,CACtDlB,QAAQ,EACRtB,oBAAoB,EACpBE,mBAAmB,EAClBuB,IAAI,IAAK;QACR,IAAI;UACF,MAAMgB,MAAM,GAAGlC,kBAAkB,CAACkB,IAAI,CAAC;UACvCO,UAAU,GAAGA,UAAU,CAACU,MAAM,CAACD,MAAM,CAAC;;UAEtC;UACA;QACF,CAAC,CAAC,OAAOE,KAAK,EAAE;UACd7B,GAAG,CAAC6B,KAAK,CAAC,gCAAgC,EAAEA,KAAc,CAAC;QAC7D;MACF,CAAC,EACAA,KAAK,IAAK;QACTR,OAAO,CAAC,CAAC;QACTJ,MAAM,CAACY,KAAK,CAAC;MACf,CACF,CAAC;;MAED;MACA,MAAMC,OAAO,GAAGlC,qBAAqB,CAAC,MAAM,CAAC;MAC7C,IAAI,CAACU,UAAU,CACZyB,mBAAmB,CAClBvB,QAAQ,EACRtB,oBAAoB,EACpBI,qBAAqB,EACrBwC,OACF,CAAC,CACAE,KAAK,CAAEH,KAAK,IAAK;QAChBR,OAAO,CAAC,CAAC;QACTJ,MAAM,CAACY,KAAK,CAAC;MACf,CAAC,CAAC;IACN,CAAC,CAAC;EACJ;;EAEA;AACF;AACA;AACA;EACE,MAAMI,iBAAiBA,CACrBzB,QAAgB,EAChB0B,aAAqB,EACrBC,UAAqC,EACpB;IACjB,IAAI,CAAC,IAAI,CAAC7B,UAAU,CAACG,WAAW,CAACD,QAAQ,CAAC,EAAE;MAC1C,MAAMV,WAAW,CAACY,YAAY,CAACF,QAAQ,CAAC;IAC1C;;IAEA;IACA,IAAI,IAAI,CAACL,eAAe,CAACiC,GAAG,CAACF,aAAa,CAAC,EAAE;MAC3C,MAAM,IAAIrC,aAAa,CACrB,iDAAiD,EACjD,sBAAsB,EACtBqC,aACF,CAAC;IACH;IAEAlC,GAAG,CAACqC,IAAI,CAAC,6BAA6B,EAAE;MAAE7B,QAAQ;MAAE0B;IAAc,CAAC,CAAC;IAEpE,OAAO,IAAInB,OAAO,CAAC,CAACC,OAAO,EAAEC,MAAM,KAAK;MACtC,MAAMqB,KAAoB,GAAG;QAC3BJ,aAAa;QACbK,gBAAgB,EAAE,CAAC;QACnBC,eAAe,EAAE,IAAIpC,GAAG,CAAC,CAAC;QAC1BqC,UAAU,EAAE,CAAC;QACbC,UAAU,EAAE;MACd,CAAC;MAED,IAAI,CAACvC,eAAe,CAACwC,GAAG,CAACT,aAAa,EAAEI,KAAK,CAAC;MAE9C,MAAMjB,OAAO,GAAGA,CAAA,KAAM;QACpB,IAAIiB,KAAK,CAAClB,SAAS,EAAEE,YAAY,CAACgB,KAAK,CAAClB,SAAS,CAAC;QAClDkB,KAAK,CAACnB,YAAY,EAAEI,MAAM,CAAC,CAAC;QAC5B,IAAI,CAACpB,eAAe,CAACyC,MAAM,CAACV,aAAa,CAAC;MAC5C,CAAC;MAED,MAAMW,YAAY,GAAGA,CAAA,KAAM;QACzB,IAAIP,KAAK,CAAClB,SAAS,EAAEE,YAAY,CAACgB,KAAK,CAAClB,SAAS,CAAC;QAClDkB,KAAK,CAAClB,SAAS,GAAGI,UAAU,CAAC,MAAM;UACjCH,OAAO,CAAC,CAAC;UACTJ,MAAM,CAACpB,aAAa,CAACiD,OAAO,CAACZ,aAAa,CAAC,CAAC;QAC9C,CAAC,EAAE3C,uBAAuB,CAAC;MAC7B,CAAC;;MAED;MACA+C,KAAK,CAACnB,YAAY,GAAG,IAAI,CAACb,UAAU,CAACoB,yBAAyB,CAC5DlB,QAAQ,EACRtB,oBAAoB,EACpBG,uBAAuB,EACvB,MAAOsB,IAAI,IAAK;QACd,IAAI;UACFkC,YAAY,CAAC,CAAC;UAEd,MAAME,MAAM,GAAGrD,mBAAmB,CAACiB,IAAI,CAAC;UACxC,MAAM,IAAI,CAACqC,oBAAoB,CAC7BxC,QAAQ,EACR8B,KAAK,EACLS,MAAM,EACNZ,UACF,CAAC;UAED,IAAIG,KAAK,CAACI,UAAU,EAAE;YACpBrB,OAAO,CAAC,CAAC;;YAET;YACA,MAAM4B,SAAS,GAAG,IAAI,CAACC,iBAAiB,CAACZ,KAAK,CAAC;;YAE/C;YACA,IAAIA,KAAK,CAACa,QAAQ,KAAKC,SAAS,EAAE;cAChC,MAAMC,kBAAkB,GAAG,IAAI,CAACC,cAAc,CAACL,SAAS,CAAC;cACzD,IAAII,kBAAkB,KAAKf,KAAK,CAACa,QAAQ,EAAE;gBACzClC,MAAM,CAACpB,aAAa,CAAC0D,gBAAgB,CAACrB,aAAa,CAAC,CAAC;gBACrD;cACF;YACF;YAEAlC,GAAG,CAACqC,IAAI,CAAC,oBAAoB,EAAE;cAC7BH,aAAa;cACbsB,IAAI,EAAEP,SAAS,CAACxB;YAClB,CAAC,CAAC;YAEFT,OAAO,CAACiC,SAAS,CAAC;UACpB;QACF,CAAC,CAAC,OAAOpB,KAAK,EAAE;UACdR,OAAO,CAAC,CAAC;UACTJ,MAAM,CAACY,KAAK,CAAC;QACf;MACF,CAAC,EACAA,KAAK,IAAK;QACTR,OAAO,CAAC,CAAC;QACTJ,MAAM,CAACpB,aAAa,CAAC4D,WAAW,CAACvB,aAAa,EAAEL,KAAK,CAAC,CAAC;MACzD,CACF,CAAC;;MAED;MACA,MAAMC,OAAO,GAAGlC,qBAAqB,CAAC,OAAO,EAAEsC,aAAa,CAAC;MAC7D,IAAI,CAAC5B,UAAU,CACZyB,mBAAmB,CAClBvB,QAAQ,EACRtB,oBAAoB,EACpBI,qBAAqB,EACrBwC,OACF,CAAC,CACA4B,IAAI,CAAC,MAAM;QACVb,YAAY,CAAC,CAAC;MAChB,CAAC,CAAC,CACDb,KAAK,CAAEH,KAAK,IAAK;QAChBR,OAAO,CAAC,CAAC;QACTJ,MAAM,CAACY,KAAK,CAAC;MACf,CAAC,CAAC;IACN,CAAC,CAAC;EACJ;;EAEA;AACF;AACA;EACE,MAAcmB,oBAAoBA,CAChCxC,QAAgB,EAChB8B,KAAoB,EACpBS,MAAsB,EACtBZ,UAAqC,EACtB;IACf,QAAQY,MAAM,CAACY,IAAI;MACjB,KAAK,MAAM;QACT,IAAIZ,MAAM,CAACpC,IAAI,EAAE;UACf;UACA2B,KAAK,CAACE,eAAe,CAACG,GAAG,CAACI,MAAM,CAACa,cAAc,EAAE5E,MAAM,CAAC6E,IAAI,CAACd,MAAM,CAACpC,IAAI,CAAC,CAAC;UAC1E2B,KAAK,CAACG,UAAU,IAAIM,MAAM,CAACpC,IAAI,CAACc,MAAM;;UAEtC;UACA,MAAM,IAAI,CAACqC,OAAO,CAACtD,QAAQ,EAAE,KAAK,EAAEuC,MAAM,CAACa,cAAc,CAAC;;UAE1D;UACAzB,UAAU,GAAGG,KAAK,CAACG,UAAU,CAAC;UAE9BzC,GAAG,CAACc,KAAK,CAAC,sBAAsB,EAAE;YAChCiD,GAAG,EAAEhB,MAAM,CAACa,cAAc;YAC1BJ,IAAI,EAAET,MAAM,CAACpC,IAAI,CAACc,MAAM;YACxBuC,KAAK,EAAE1B,KAAK,CAACG;UACf,CAAC,CAAC;QACJ;QACA;MAEF,KAAK,KAAK;QACRH,KAAK,CAACa,QAAQ,GAAGJ,MAAM,CAACI,QAAQ;QAChCb,KAAK,CAACI,UAAU,GAAG,IAAI;;QAEvB;QACA,MAAM,IAAI,CAACoB,OAAO,CAACtD,QAAQ,EAAE,KAAK,EAAEuC,MAAM,CAACa,cAAc,CAAC;QAE1D5D,GAAG,CAACc,KAAK,CAAC,qBAAqB,EAAE;UAC/BiD,GAAG,EAAEhB,MAAM,CAACa,cAAc;UAC1BT,QAAQ,EAAEJ,MAAM,CAACI;QACnB,CAAC,CAAC;QACF;MAEF,KAAK,OAAO;QACV,MAAMtD,aAAa,CAACoE,WAAW,CAC7B3B,KAAK,CAACJ,aAAa,EACnBa,MAAM,CAACmB,SAAS,IAAI,IACtB,CAAC;IACL;EACF;;EAEA;AACF;AACA;EACE,MAAcJ,OAAOA,CACnBtD,QAAgB,EAChBmD,IAA8B,EAC9BC,cAAsB,EACP;IACf,MAAMO,SAAS,GAAGxE,eAAe,CAACgE,IAAI,EAAEC,cAAc,CAAC;IAEvD,MAAM,IAAI,CAACtD,UAAU,CAACyB,mBAAmB,CACvCvB,QAAQ,EACRtB,oBAAoB,EACpBG,uBAAuB,EACvB8E,SAAS,EACT,KAAK,CAAC;IACR,CAAC;EACH;;EAEA;AACF;AACA;EACUjB,iBAAiBA,CAACZ,KAAoB,EAAU;IACtD;IACA,MAAM8B,eAAe,GAAGC,KAAK,CAACR,IAAI,CAACvB,KAAK,CAACE,eAAe,CAAC8B,IAAI,CAAC,CAAC,CAAC,CAACC,IAAI,CACnE,CAACC,CAAC,EAAEC,CAAC,KAAKD,CAAC,GAAGC,CAChB,CAAC;IAED,MAAMC,MAAgB,GAAG,EAAE;IAC3B,KAAK,MAAMX,GAAG,IAAIK,eAAe,EAAE;MACjC,MAAMzD,IAAI,GAAG2B,KAAK,CAACE,eAAe,CAACmC,GAAG,CAACZ,GAAG,CAAC;MAC3C,IAAIpD,IAAI,EAAE;QACR+D,MAAM,CAACE,IAAI,CAACjE,IAAI,CAAC;MACnB;IACF;IAEA,OAAO3B,MAAM,CAAC4C,MAAM,CAAC8C,MAAM,CAAC;EAC9B;;EAEA;AACF;AACA;EACUpB,cAAcA,CAAC3C,IAAY,EAAU;IAC3C,IAAIkE,GAAG,GAAG,UAAU;IACpB,MAAMC,KAAK,GAAG,IAAI,CAACC,aAAa,CAAC,CAAC;IAElC,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGrE,IAAI,CAACc,MAAM,EAAEuD,CAAC,EAAE,EAAE;MACpCH,GAAG,GAAIA,GAAG,KAAK,CAAC,GAAIC,KAAK,CAAC,CAACD,GAAG,GAAGlE,IAAI,CAACqE,CAAC,CAAC,IAAI,IAAI,CAAC;IACnD;IAEA,OAAO,CAACH,GAAG,GAAG,UAAU,MAAM,CAAC;EACjC;;EAEA;AACF;AACA;EACUI,UAAU,GAAoB,IAAI;EAClCF,aAAaA,CAAA,EAAa;IAChC,IAAI,IAAI,CAACE,UAAU,EAAE;MACnB,OAAO,IAAI,CAACA,UAAU;IACxB;IAEA,MAAMH,KAAe,GAAG,EAAE;IAC1B,KAAK,IAAIE,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAG,GAAG,EAAEA,CAAC,EAAE,EAAE;MAC5B,IAAIH,GAAG,GAAGG,CAAC;MACX,KAAK,IAAIE,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAG,CAAC,EAAEA,CAAC,EAAE,EAAE;QAC1BL,GAAG,GAAGA,GAAG,GAAG,CAAC,GAAIA,GAAG,KAAK,CAAC,GAAI,UAAU,GAAGA,GAAG,KAAK,CAAC;MACtD;MACAC,KAAK,CAACF,IAAI,CAACC,GAAG,KAAK,CAAC,CAAC;IACvB;IAEA,IAAI,CAACI,UAAU,GAAGH,KAAK;IACvB,OAAOA,KAAK;EACd;;EAEA;AACF;AACA;EACE,MAAMK,WAAWA,CAAC3E,QAAgB,EAAE0B,aAAqB,EAAiB;IACxE,IAAI,CAAC,IAAI,CAAC5B,UAAU,CAACG,WAAW,CAACD,QAAQ,CAAC,EAAE;MAC1C,MAAMV,WAAW,CAACY,YAAY,CAACF,QAAQ,CAAC;IAC1C;IAEAR,GAAG,CAACc,KAAK,CAAC,iBAAiB,EAAE;MAAEN,QAAQ;MAAE0B;IAAc,CAAC,CAAC;IAEzD,MAAMJ,OAAO,GAAGlC,qBAAqB,CAAC,SAAS,EAAEsC,aAAa,CAAC;IAE/D,MAAM,IAAI,CAAC5B,UAAU,CAACyB,mBAAmB,CACvCvB,QAAQ,EACRtB,oBAAoB,EACpBI,qBAAqB,EACrBwC,OACF,CAAC;EACH;;EAEA;AACF;AACA;EACE,MAAMsD,cAAcA,CAAC5E,QAAgB,EAAE0B,aAAqB,EAAiB;IAC3E,MAAMI,KAAK,GAAG,IAAI,CAACnC,eAAe,CAACwE,GAAG,CAACzC,aAAa,CAAC;IACrD,IAAI,CAACI,KAAK,EAAE;MACV;IACF;IAEAtC,GAAG,CAACqC,IAAI,CAAC,qBAAqB,EAAE;MAAEH;IAAc,CAAC,CAAC;;IAElD;IACA,IAAI;MACF,MAAM,IAAI,CAAC4B,OAAO,CAACtD,QAAQ,EAAE,OAAO,EAAE8B,KAAK,CAACC,gBAAgB,CAAC;IAC/D,CAAC,CAAC,MAAM;MACN;IAAA;;IAGF;IACA,IAAID,KAAK,CAAClB,SAAS,EAAEE,YAAY,CAACgB,KAAK,CAAClB,SAAS,CAAC;IAClDkB,KAAK,CAACnB,YAAY,EAAEI,MAAM,CAAC,CAAC;IAC5B,IAAI,CAACpB,eAAe,CAACyC,MAAM,CAACV,aAAa,CAAC;EAC5C;;EAEA;AACF;AACA;EACEmD,oBAAoBA,CAACnD,aAAqB,EAAW;IACnD,OAAO,IAAI,CAAC/B,eAAe,CAACiC,GAAG,CAACF,aAAa,CAAC;EAChD;;EAEA;AACF;AACA;EACEoD,OAAOA,CAAA,EAAS;IACd;IACA,KAAK,MAAM,GAAGhD,KAAK,CAAC,IAAI,IAAI,CAACnC,eAAe,EAAE;MAC5C,IAAImC,KAAK,CAAClB,SAAS,EAAEE,YAAY,CAACgB,KAAK,CAAClB,SAAS,CAAC;MAClDkB,KAAK,CAACnB,YAAY,EAAEI,MAAM,CAAC,CAAC;IAC9B;IACA,IAAI,CAACpB,eAAe,CAACoF,KAAK,CAAC,CAAC;EAC9B;AACF","ignoreList":[]}

package/lib/module/protocol/index.js

@@ -0,0 +1,6 @@
+/**
+ * Protocol module exports
+ */
+
+export { ProtocolHandler } from './ProtocolHandler';
+//# sourceMappingURL=index.js.map

package/lib/module/protocol/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ProtocolHandler"],"sourceRoot":"../../../src","sources":["protocol/index.ts"],"mappings":"AAAA;AACA;AACA;;AAEA,SAASA,eAAe,QAAuC,mBAAmB","ignoreList":[]}

package/lib/module/storage/StorageManager.js

@@ -0,0 +1,324 @@
+/**
+ * Storage Manager - Local persistence for recordings and upload queue
+ */
+
+import AsyncStorage from '@react-native-async-storage/async-storage';
+import { Buffer } from 'buffer';
+import { logger } from '../utils/logger';
+const log = logger.tag('StorageManager');
+
+// Storage keys
+const STORAGE_PREFIX = '@bota_sdk:';
+const UPLOAD_QUEUE_KEY = `${STORAGE_PREFIX}upload_queue`;
+const SDK_STATE_KEY = `${STORAGE_PREFIX}sdk_state`;
+
+/**
+ * SDK persistent state
+ */
+
+/**
+ * Storage Manager class
+ */
+export class StorageManager {
+  uploadQueue = [];
+  sdkState = {
+    lastSyncTimes: {},
+    deviceInfo: {}
+  };
+  isInitialized = false;
+
+  /**
+   * Initialize storage manager
+   */
+  async initialize() {
+    if (this.isInitialized) {
+      return;
+    }
+    log.debug('Initializing StorageManager');
+    try {
+      // Load upload queue
+      const queueData = await AsyncStorage.getItem(UPLOAD_QUEUE_KEY);
+      if (queueData) {
+        this.uploadQueue = JSON.parse(queueData);
+        // Restore dates
+        this.uploadQueue = this.uploadQueue.map(task => ({
+          ...task,
+          createdAt: new Date(task.createdAt),
+          updatedAt: new Date(task.updatedAt)
+        }));
+      }
+
+      // Load SDK state
+      const stateData = await AsyncStorage.getItem(SDK_STATE_KEY);
+      if (stateData) {
+        this.sdkState = JSON.parse(stateData);
+      }
+      this.isInitialized = true;
+      log.info('StorageManager initialized', {
+        pendingUploads: this.uploadQueue.length
+      });
+    } catch (error) {
+      log.error('Failed to initialize storage', error);
+      // Continue with empty state
+      this.isInitialized = true;
+    }
+  }
+
+  // Upload Queue Methods
+
+  /**
+   * Get all upload tasks
+   */
+  getUploadQueue() {
+    return [...this.uploadQueue];
+  }
+
+  /**
+   * Get pending upload tasks
+   */
+  getPendingUploads() {
+    return this.uploadQueue.filter(task => task.status === 'pending' || task.status === 'uploading');
+  }
+
+  /**
+   * Get failed upload tasks
+   */
+  getFailedUploads() {
+    return this.uploadQueue.filter(task => task.status === 'failed');
+  }
+
+  /**
+   * Add a task to the upload queue
+   */
+  async addUploadTask(task) {
+    log.debug('Adding upload task', {
+      taskId: task.id,
+      recordingId: task.recordingId
+    });
+    this.uploadQueue.push(task);
+    await this.saveUploadQueue();
+  }
+
+  /**
+   * Update an upload task
+   */
+  async updateUploadTask(taskId, updates) {
+    const index = this.uploadQueue.findIndex(t => t.id === taskId);
+    if (index === -1) {
+      log.warn('Upload task not found', {
+        taskId
+      });
+      return;
+    }
+    this.uploadQueue[index] = {
+      ...this.uploadQueue[index],
+      ...updates,
+      updatedAt: new Date()
+    };
+    await this.saveUploadQueue();
+  }
+
+  /**
+   * Update task status
+   */
+  async updateTaskStatus(taskId, status, errorMessage) {
+    await this.updateUploadTask(taskId, {
+      status,
+      errorMessage
+    });
+  }
+
+  /**
+   * Increment retry count for a task
+   */
+  async incrementRetryCount(taskId) {
+    const task = this.uploadQueue.find(t => t.id === taskId);
+    if (task) {
+      await this.updateUploadTask(taskId, {
+        retryCount: task.retryCount + 1
+      });
+    }
+  }
+
+  /**
+   * Remove a task from the queue
+   */
+  async removeUploadTask(taskId) {
+    log.debug('Removing upload task', {
+      taskId
+    });
+    this.uploadQueue = this.uploadQueue.filter(t => t.id !== taskId);
+    await this.saveUploadQueue();
+  }
+
+  /**
+   * Clear all completed tasks
+   */
+  async clearCompletedTasks() {
+    this.uploadQueue = this.uploadQueue.filter(t => t.status !== 'completed');
+    await this.saveUploadQueue();
+  }
+
+  /**
+   * Clear all tasks
+   */
+  async clearAllTasks() {
+    this.uploadQueue = [];
+    await this.saveUploadQueue();
+  }
+
+  /**
+   * Get a specific upload task
+   */
+  getUploadTask(taskId) {
+    return this.uploadQueue.find(t => t.id === taskId);
+  }
+
+  /**
+   * Save upload queue to storage
+   */
+  async saveUploadQueue() {
+    try {
+      await AsyncStorage.setItem(UPLOAD_QUEUE_KEY, JSON.stringify(this.uploadQueue));
+    } catch (error) {
+      log.error('Failed to save upload queue', error);
+    }
+  }
+
+  // SDK State Methods
+
+  /**
+   * Get last sync time for a device
+   */
+  getLastSyncTime(deviceId) {
+    const timestamp = this.sdkState.lastSyncTimes[deviceId];
+    return timestamp ? new Date(timestamp) : null;
+  }
+
+  /**
+   * Set last sync time for a device
+   */
+  async setLastSyncTime(deviceId, time = new Date()) {
+    this.sdkState.lastSyncTimes[deviceId] = time.getTime();
+    await this.saveSdkState();
+  }
+
+  /**
+   * Get cached device info
+   */
+  getDeviceInfo(deviceId) {
+    return this.sdkState.deviceInfo[deviceId];
+  }
+
+  /**
+   * Cache device info
+   */
+  async setDeviceInfo(deviceId, info) {
+    this.sdkState.deviceInfo[deviceId] = info;
+    await this.saveSdkState();
+  }
+
+  /**
+   * Save SDK state to storage
+   */
+  async saveSdkState() {
+    try {
+      await AsyncStorage.setItem(SDK_STATE_KEY, JSON.stringify(this.sdkState));
+    } catch (error) {
+      log.error('Failed to save SDK state', error);
+    }
+  }
+
+  // Recording File Methods
+  // Note: For actual file storage, we'd need react-native-fs or similar
+  // For now, we'll store base64 encoded audio in AsyncStorage for small files
+
+  /**
+   * Save recording data locally
+   */
+  async saveRecordingData(deviceId, recordingUuid, data) {
+    const key = `${STORAGE_PREFIX}recording:${deviceId}:${recordingUuid}`;
+    try {
+      // Store as base64 (not ideal for large files, but works for demo)
+      await AsyncStorage.setItem(key, data.toString('base64'));
+      log.debug('Saved recording data', {
+        deviceId,
+        recordingUuid,
+        size: data.length
+      });
+      return key;
+    } catch (error) {
+      log.error('Failed to save recording data', error);
+      throw error;
+    }
+  }
+
+  /**
+   * Load recording data
+   */
+  async loadRecordingData(localPath) {
+    try {
+      const data = await AsyncStorage.getItem(localPath);
+      if (!data) {
+        throw new Error(`Recording not found: ${localPath}`);
+      }
+      return Buffer.from(data, 'base64');
+    } catch (error) {
+      log.error('Failed to load recording data', error);
+      throw error;
+    }
+  }
+
+  /**
+   * Delete recording data
+   */
+  async deleteRecordingData(localPath) {
+    try {
+      await AsyncStorage.removeItem(localPath);
+      log.debug('Deleted recording data', {
+        localPath
+      });
+    } catch (error) {
+      log.error('Failed to delete recording data', error);
+    }
+  }
+
+  /**
+   * Clear all SDK storage
+   */
+  async clearAll() {
+    log.info('Clearing all SDK storage');
+    try {
+      const keys = await AsyncStorage.getAllKeys();
+      const botaKeys = keys.filter(k => k.startsWith(STORAGE_PREFIX));
+      await AsyncStorage.multiRemove(botaKeys);
+      this.uploadQueue = [];
+      this.sdkState = {
+        lastSyncTimes: {},
+        deviceInfo: {}
+      };
+    } catch (error) {
+      log.error('Failed to clear storage', error);
+    }
+  }
+
+  /**
+   * Clean up resources
+   */
+  destroy() {
+    this.uploadQueue = [];
+    this.sdkState = {
+      lastSyncTimes: {},
+      deviceInfo: {}
+    };
+    this.isInitialized = false;
+  }
+}
+
+/**
+ * Generate a unique task ID
+ */
+export function generateTaskId() {
+  return `task_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+}
+//# sourceMappingURL=StorageManager.js.map