@bota.dev/react-native-app-sdk 2.0.0-beta.0 → 2.0.0-beta.10

package/lib/commonjs/ble/constants.js

@@ -3,8 +3,12 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.DEVICE_LOG_FLAG_DROPPED = exports.DEVICE_LOG_FLAG_BACKLOG = exports.BLE_ERROR_STORAGE_KEY_UNAVAILABLE = void 0;
+exports.DEVICE_LOG_FLAG_DROPPED = exports.DEVICE_LOG_FLAG_BACKLOG = exports.DEVICE_DIAGNOSTICS_EVT_SIGNATURE = exports.DEVICE_DIAGNOSTICS_EVT_META = exports.DEVICE_DIAGNOSTICS_EVT_END = exports.DEVICE_DIAGNOSTICS_EVT_DETAIL = exports.BLE_ERROR_STORAGE_KEY_UNAVAILABLE = void 0;
 const DEVICE_LOG_FLAG_BACKLOG = exports.DEVICE_LOG_FLAG_BACKLOG = 0x01;
 const DEVICE_LOG_FLAG_DROPPED = exports.DEVICE_LOG_FLAG_DROPPED = 0x02;
 const BLE_ERROR_STORAGE_KEY_UNAVAILABLE = exports.BLE_ERROR_STORAGE_KEY_UNAVAILABLE = 0x14;
+const DEVICE_DIAGNOSTICS_EVT_META = exports.DEVICE_DIAGNOSTICS_EVT_META = 0x90;
+const DEVICE_DIAGNOSTICS_EVT_SIGNATURE = exports.DEVICE_DIAGNOSTICS_EVT_SIGNATURE = 0x91;
+const DEVICE_DIAGNOSTICS_EVT_END = exports.DEVICE_DIAGNOSTICS_EVT_END = 0x92;
+const DEVICE_DIAGNOSTICS_EVT_DETAIL = exports.DEVICE_DIAGNOSTICS_EVT_DETAIL = 0x95;
 //# sourceMappingURL=constants.js.map

package/lib/commonjs/ble/constants.js.map

@@ -1 +1 @@
-{"version":3,"names":["DEVICE_LOG_FLAG_BACKLOG","exports","DEVICE_LOG_FLAG_DROPPED","BLE_ERROR_STORAGE_KEY_UNAVAILABLE"],"sourceRoot":"../../../src","sources":["ble/constants.ts"],"mappings":";;;;;;AAAO,MAAMA,uBAAuB,GAAAC,OAAA,CAAAD,uBAAA,GAAG,IAAI;AACpC,MAAME,uBAAuB,GAAAD,OAAA,CAAAC,uBAAA,GAAG,IAAI;AACpC,MAAMC,iCAAiC,GAAAF,OAAA,CAAAE,iCAAA,GAAG,IAAI","ignoreList":[]}
+{"version":3,"names":["DEVICE_LOG_FLAG_BACKLOG","exports","DEVICE_LOG_FLAG_DROPPED","BLE_ERROR_STORAGE_KEY_UNAVAILABLE","DEVICE_DIAGNOSTICS_EVT_META","DEVICE_DIAGNOSTICS_EVT_SIGNATURE","DEVICE_DIAGNOSTICS_EVT_END","DEVICE_DIAGNOSTICS_EVT_DETAIL"],"sourceRoot":"../../../src","sources":["ble/constants.ts"],"mappings":";;;;;;AAAO,MAAMA,uBAAuB,GAAAC,OAAA,CAAAD,uBAAA,GAAG,IAAI;AACpC,MAAME,uBAAuB,GAAAD,OAAA,CAAAC,uBAAA,GAAG,IAAI;AACpC,MAAMC,iCAAiC,GAAAF,OAAA,CAAAE,iCAAA,GAAG,IAAI;AAE9C,MAAMC,2BAA2B,GAAAH,OAAA,CAAAG,2BAAA,GAAG,IAAI;AACxC,MAAMC,gCAAgC,GAAAJ,OAAA,CAAAI,gCAAA,GAAG,IAAI;AAC7C,MAAMC,0BAA0B,GAAAL,OAAA,CAAAK,0BAAA,GAAG,IAAI;AACvC,MAAMC,6BAA6B,GAAAN,OAAA,CAAAM,6BAAA,GAAG,IAAI","ignoreList":[]}

package/lib/commonjs/ble/deviceDiagnostics.js

@@ -0,0 +1,240 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DeviceDiagnosticsDecoder = void 0;
+exports.diagnosticEventIdCommand = diagnosticEventIdCommand;
+var _buffer = require("buffer");
+var _constants = require("./constants");
+const EVENT_TYPES = {
+  1: 'reset',
+  2: 'watchdog',
+  3: 'hard_fault',
+  4: 'storage',
+  5: 'power',
+  6: 'radio',
+  7: 'security'
+};
+const REASONS = {
+  1: 'watchdog_timeout',
+  2: 'cpu_illegal_instruction',
+  3: 'cpu_misaligned_access',
+  4: 'cpu_stack_overflow',
+  5: 'cpu_usage_fault',
+  6: 'memory_protection_fault',
+  7: 'invalid_register_read',
+  8: 'invalid_register_write',
+  9: 'audio_subsystem_fault',
+  10: 'wireless_subsystem_fault',
+  11: 'flash_mmu_fault',
+  12: 'low_voltage_reset',
+  255: 'unknown_cpu_exception'
+};
+const SUBSYSTEMS = {
+  0: 'system',
+  1: 'audio',
+  2: 'wireless',
+  3: 'storage',
+  4: 'power',
+  5: 'security'
+};
+const STATES = {
+  0: 'boot',
+  1: 'deep_standby',
+  2: 'recording',
+  3: 'upload_preparing',
+  4: 'uploading',
+  5: 'error_recovery',
+  6: 'full_sleep'
+};
+const BREADCRUMBS = {
+  1: 'boot',
+  2: 'standby_entered',
+  3: 'recording_started',
+  4: 'upload_preparing',
+  5: 'upload_started',
+  6: 'error_recovery',
+  7: 'full_sleep'
+};
+const DETAIL_WIRE_SIZE = 176;
+function u64LeHex(bytes) {
+  return _buffer.Buffer.from(bytes).reverse().toString('hex').padStart(16, '0');
+}
+function diagnosticEventIdCommand(eventId) {
+  if (!/^[0-9a-f]{16}$/.test(eventId)) {
+    throw new Error('Diagnostic event_id must be 16 lowercase hex characters');
+  }
+  return _buffer.Buffer.concat([_buffer.Buffer.from([0x11]), _buffer.Buffer.from(eventId, 'hex').reverse()]);
+}
+function normalizedAddress(value) {
+  if (value === 0) return undefined;
+  const region = (value & 0x80000000) !== 0 ? 'sdram' : (value & 0x40000000) !== 0 ? 'ram' : 'rom';
+  const offset = (value & 0x3fffffff).toString(16).padStart(8, '0');
+  return `${region}:${offset}`;
+}
+function fixedHex32(value) {
+  return value.toString(16).padStart(8, '0');
+}
+function decodeDetail(bytes) {
+  if (bytes.length !== DETAIL_WIRE_SIZE || bytes[0] !== 1) {
+    throw new Error('Unsupported diagnostic detail payload');
+  }
+  const hasReport = (bytes[1] & 1) !== 0;
+  const firmwareBuildId = _buffer.Buffer.from(bytes.subarray(2, 14)).toString('ascii');
+  if (!/^[0-9a-f]{12}$/.test(firmwareBuildId)) {
+    throw new Error('Invalid diagnostic firmware build id');
+  }
+  const common = {
+    firmware_build_id: firmwareBuildId,
+    subsystem: SUBSYSTEMS[bytes[14]] ?? 'system',
+    state_before_event: STATES[bytes[15]] ?? 'unknown'
+  };
+  if (!hasReport) return common;
+  const pcCount = Math.min(bytes[17], 6);
+  const breadcrumbCount = Math.min(bytes[18], 8);
+  const runtimeMask = bytes[19];
+  const pcTrace = [];
+  for (let index = 0; index < pcCount; index++) {
+    const address = normalizedAddress(bytes.readUInt32LE(48 + index * 4));
+    if (address) pcTrace.push(address);
+  }
+  const task = _buffer.Buffer.from(bytes.subarray(80, 96)).toString('ascii').replace(/\0.*$/, '');
+  const breadcrumbs = [];
+  for (let index = 0; index < breadcrumbCount; index++) {
+    const offset = 96 + index * 10;
+    breadcrumbs.push({
+      delta_ms: bytes.readInt32LE(offset),
+      code: BREADCRUMBS[bytes.readUInt16LE(offset + 4)] ?? 'state_changed',
+      arg0: bytes.readInt32LE(offset + 6)
+    });
+  }
+  const reti = normalizedAddress(bytes.readUInt32LE(40));
+  const rets = normalizedAddress(bytes.readUInt32LE(44));
+  return {
+    ...common,
+    report: {
+      fault: {
+        cpu_id: bytes[16],
+        cpu_emu: fixedHex32(bytes.readUInt32LE(20)),
+        core_emu: fixedHex32(bytes.readUInt32LE(24)),
+        hsb_emu: fixedHex32(bytes.readUInt32LE(28)),
+        audio_emu: fixedHex32(bytes.readUInt32LE(32)),
+        wireless_emu: fixedHex32(bytes.readUInt32LE(36))
+      },
+      execution: {
+        ...(task ? {
+          task
+        } : {}),
+        ...(reti ? {
+          reti
+        } : {}),
+        ...(rets ? {
+          rets
+        } : {}),
+        pc_trace: pcTrace
+      },
+      ...((runtimeMask & 3) !== 0 ? {
+        runtime: {
+          ...((runtimeMask & 1) !== 0 ? {
+            heap_free_bytes: bytes.readUInt32LE(72)
+          } : {}),
+          ...((runtimeMask & 2) !== 0 ? {
+            task_stack_remaining_bytes: bytes.readUInt32LE(76)
+          } : {})
+        }
+      } : {}),
+      ...(breadcrumbs.length ? {
+        breadcrumbs
+      } : {})
+    }
+  };
+}
+class DeviceDiagnosticsDecoder {
+  events = new Map();
+  details = new Map();
+  push(packet) {
+    if (packet.length === 17 && packet[0] === _constants.DEVICE_DIAGNOSTICS_EVT_META) {
+      const type = EVENT_TYPES[packet[2]];
+      if (!type) return null;
+      this.events.set(packet[1], {
+        event_id: u64LeHex(packet.subarray(9, 17)),
+        event_type: type,
+        reason_code: REASONS[packet.readUInt16LE(3)] ?? 'unknown_cpu_exception',
+        uptime_ms: packet.readUInt32LE(5)
+      });
+      return null;
+    }
+    if (packet.length === 10 && packet[0] === _constants.DEVICE_DIAGNOSTICS_EVT_SIGNATURE) {
+      const event = this.events.get(packet[1]);
+      if (event) event.signature = u64LeHex(packet.subarray(2, 10));
+      return null;
+    }
+    if (packet.length >= 6 && packet.length <= 20 && packet[0] === _constants.DEVICE_DIAGNOSTICS_EVT_DETAIL) {
+      const index = packet[1];
+      const offset = packet.readUInt16LE(2);
+      const total = packet.readUInt16LE(4);
+      if (total !== DETAIL_WIRE_SIZE || offset + packet.length - 6 > total) {
+        this.reset();
+        throw new Error('Invalid diagnostic detail chunk');
+      }
+      let detail = this.details.get(index);
+      if (offset === 0) {
+        if (detail) {
+          this.reset();
+          throw new Error(`Duplicate diagnostic detail at index ${index}`);
+        }
+        detail = {
+          buffer: _buffer.Buffer.alloc(total),
+          received: 0
+        };
+        this.details.set(index, detail);
+      }
+      if (!detail || detail.received !== offset) {
+        this.reset();
+        throw new Error(`Out-of-order diagnostic detail at index ${index}`);
+      }
+      packet.copy(detail.buffer, offset, 6);
+      detail.received += packet.length - 6;
+      if (detail.received === total) {
+        const event = this.events.get(index);
+        if (!event) {
+          this.reset();
+          throw new Error(`Diagnostic detail without metadata at index ${index}`);
+        }
+        try {
+          Object.assign(event, decodeDetail(detail.buffer));
+        } catch (error) {
+          this.reset();
+          throw error;
+        }
+      }
+      return null;
+    }
+    if (packet.length === 2 && packet[0] === _constants.DEVICE_DIAGNOSTICS_EVT_END) {
+      const expected = packet[1];
+      const events = [];
+      for (let index = 0; index < expected; index++) {
+        const event = this.events.get(index);
+        if (!event?.signature || !event.firmware_build_id || !event.subsystem || !event.state_before_event || this.details.get(index)?.received !== DETAIL_WIRE_SIZE) {
+          this.reset();
+          throw new Error(`Incomplete diagnostic event at index ${index}`);
+        }
+        events.push(event);
+      }
+      const batch = {
+        schema_version: 1,
+        events
+      };
+      this.reset();
+      return batch;
+    }
+    return null;
+  }
+  reset() {
+    this.events.clear();
+    this.details.clear();
+  }
+}
+exports.DeviceDiagnosticsDecoder = DeviceDiagnosticsDecoder;
+//# sourceMappingURL=deviceDiagnostics.js.map

package/lib/commonjs/ble/deviceDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_buffer","require","_constants","EVENT_TYPES","REASONS","SUBSYSTEMS","STATES","BREADCRUMBS","DETAIL_WIRE_SIZE","u64LeHex","bytes","Buffer","from","reverse","toString","padStart","diagnosticEventIdCommand","eventId","test","Error","concat","normalizedAddress","value","undefined","region","offset","fixedHex32","decodeDetail","length","hasReport","firmwareBuildId","subarray","common","firmware_build_id","subsystem","state_before_event","pcCount","Math","min","breadcrumbCount","runtimeMask","pcTrace","index","address","readUInt32LE","push","task","replace","breadcrumbs","delta_ms","readInt32LE","code","readUInt16LE","arg0","reti","rets","report","fault","cpu_id","cpu_emu","core_emu","hsb_emu","audio_emu","wireless_emu","execution","pc_trace","runtime","heap_free_bytes","task_stack_remaining_bytes","DeviceDiagnosticsDecoder","events","Map","details","packet","DEVICE_DIAGNOSTICS_EVT_META","type","set","event_id","event_type","reason_code","uptime_ms","DEVICE_DIAGNOSTICS_EVT_SIGNATURE","event","get","signature","DEVICE_DIAGNOSTICS_EVT_DETAIL","total","reset","detail","buffer","alloc","received","copy","Object","assign","error","DEVICE_DIAGNOSTICS_EVT_END","expected","batch","schema_version","clear","exports"],"sourceRoot":"../../../src","sources":["ble/deviceDiagnostics.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/client.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.createBotaDeviceSDK = exports.BotaNativeModuleError = void 0;
+var _sdkIdentity = require("./sdkIdentity");
 var _runtime = require("./compatibility/runtime");
 class BotaNativeModuleError extends Error {
   code = 'native_module_unavailable';
@@ -13,12 +14,18 @@ class BotaNativeModuleError extends Error {
   }
 }
 exports.BotaNativeModuleError = BotaNativeModuleError;
+const formatAdvertisedMac = value => {
+  if (!value || !/^(?:[0-9a-f]{12}|(?:[0-9a-f]{2}:){5}[0-9a-f]{2})$/i.test(value)) {
+    return null;
+  }
+  return value.replace(/:/g, '').toUpperCase().match(/.{2}/g).join(':');
+};
 const mapDiscoveredDevice = device => ({
   id: device.id,
   name: device.name ?? '',
   deviceType: device.deviceType ?? 'bota_pin',
   firmwareVersion: device.firmwareVersion ?? '',
-  macAddress: device.macAddress ?? null,
+  macAddress: formatAdvertisedMac(device.macAddress),
   pairingState: device.pairingState ?? 'unpaired',
   rssi: device.rssi,
   discoveredAt: new Date(device.discoveredAtMs)
@@ -58,6 +65,41 @@ const createOpaqueId = () => 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy
   const nibble = value === 'x' ? random : random & 0x3 | 0x8;
   return nibble.toString(16);
 });
+const catalogInteger = (value, maximum = BigInt(Number.MAX_SAFE_INTEGER)) => {
+  if (typeof value !== 'string' || !/^(0|[1-9][0-9]{0,19})$/.test(value) || BigInt(value) > maximum) {
+    throw new Error('invalid native recording catalog metadata');
+  }
+  return Number(value);
+};
+const mapPendingRecording = value => {
+  const uuidPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
+  if (value.profile === 'legacy' && value.legacy && !value.encrypted) {
+    const recording = value.legacy;
+    if (typeof recording.uuid !== 'string' || !uuidPattern.test(recording.uuid) || !Number.isSafeInteger(recording.startedAtMs) || recording.startedAtMs < 0 || recording.startedAtMs > 8640000000000000 || !Number.isSafeInteger(recording.durationMs) || recording.durationMs < 0 || !Number.isSafeInteger(recording.fileSize) || recording.fileSize < 0 || typeof recording.codec !== 'string' || typeof recording.isEncrypted !== 'boolean') {
+      throw new Error('invalid native recording catalog metadata');
+    }
+    return mapRecording(recording);
+  }
+  if (value.profile !== 'encrypted_upload_v2' || !value.encrypted || value.legacy) {
+    throw new Error('invalid native recording catalog profile');
+  }
+  const recording = value.encrypted;
+  const plaintextLength = recording.plaintextLength;
+  if (typeof recording.uuid !== 'string' || !uuidPattern.test(recording.uuid) || recording.storageFormat !== 3 || typeof plaintextLength !== 'string' || !/^(0|[1-9][0-9]{0,19})$/.test(plaintextLength) || BigInt(plaintextLength) > 0xffffffffffffffffn || typeof recording.ciphertextLength !== 'string' || !/^[1-9][0-9]{0,19}$/.test(recording.ciphertextLength) || BigInt(recording.ciphertextLength) > 0xffffffffffffffffn || typeof recording.ciphertextSha256 !== 'string' || !/^[0-9a-f]{64}$/.test(recording.ciphertextSha256) || !Number.isInteger(recording.generation) || recording.generation < 0 || recording.generation > 0xffffffff) {
+    throw new Error('invalid native recording catalog identity');
+  }
+  return {
+    uuid: recording.uuid,
+    generation: recording.generation,
+    ciphertextLength: recording.ciphertextLength,
+    ciphertextSha256: recording.ciphertextSha256,
+    storageFormat: 3,
+    plaintextLength,
+    startedAtMs: recording.startedAtMs,
+    startedAt: new Date(catalogInteger(recording.startedAtMs, 8640000000000000n)),
+    durationMs: catalogInteger(recording.durationMs)
+  };
+};
 const bytesToHex = value => Array.from(value, byte => byte.toString(16).padStart(2, '0')).join('');
 const toNativeConnectionSettings = settings => ({
   enabledConnections: settings.enabled_connections,
@@ -249,6 +291,9 @@ const toNativeRecordingUploadRequest = task => ({
   recordingId: task.recordingId,
   deviceId: task.deviceId,
   localPath: task.localPath,
+  ...(task.fileSizeBytes === undefined ? {} : {
+    fileSizeBytes: task.fileSizeBytes
+  }),
   uploadUrl: task.uploadUrl,
   ...(task.uploadToken ? {
     uploadToken: task.uploadToken
@@ -268,9 +313,12 @@ const toNativeRecordingUploadRequest = task => ({
   } : {})
 });
 const parseUploadQueue = serialized => {
-  const value = JSON.parse(serialized || '[]');
-  if (!Array.isArray(value)) return [];
+  const value = JSON.parse(serialized);
+  if (!Array.isArray(value)) throw new Error('Invalid upload recovery journal');
   return value.map(task => {
+    if (!task || typeof task !== 'object' || Array.isArray(task) || typeof task.createdAt !== 'string' || typeof task.updatedAt !== 'string') {
+      throw new Error('Invalid upload recovery journal');
+    }
     const candidate = task;
     return {
       ...candidate,
@@ -280,6 +328,8 @@ const parseUploadQueue = serialized => {
   });
 };
 const createBotaDeviceSDK = nativeModule => {
+  let presenceStopped = false;
+  let presenceGeneration = 0;
   const requireNativeModule = () => {
     if (!nativeModule) throw new BotaNativeModuleError();
     return nativeModule;
@@ -499,6 +549,10 @@ const createBotaDeviceSDK = nativeModule => {
       const values = await requireNativeModule().listRecordings(toNativeConnectedDevice(device));
       return values.map(mapRecording);
     },
+    async listPendingRecordings(device) {
+      const values = await requireNativeModule().listPendingRecordings(toNativeConnectedDevice(device));
+      return values.map(mapPendingRecording);
+    },
     async syncRecording(device, recording, onProgress, sinkId) {
       const module = requireNativeModule();
       const subscription = module.onRecordingTransferProgress(progress => {
@@ -510,38 +564,83 @@ const createBotaDeviceSDK = nativeModule => {
         subscription.remove();
       }
     },
-    async syncEncryptedRecordingV2(device, recording, provider, onProgress) {
+    async syncEncryptedRecordingV2(device, recording, provider, onProgress, options = {}) {
+      if (options.signal?.aborted) throw new Error('encrypted upload v2 cancelled');
       const module = requireNativeModule();
-      const operationId = createOpaqueId();
-      const profileSubscription = module.onEncryptedUploadV2ProfileRequested(request => {
-        if (request.operationId !== operationId) return;
-        void (async () => {
+      const operationId = options.operationId ?? createOpaqueId();
+      if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(operationId)) {
+        throw new Error('invalid encrypted upload v2 operation ID');
+      }
+      let active = true;
+      let nativeStarted = false;
+      let cancellation;
+      let cancellationFailed = false;
+      const cancel = () => {
+        if (nativeStarted && !cancellation) {
           try {
-            const decision = await provider({
-              recording: request.recording,
-              capability: request.capability,
-              ...(request.checkpoint === undefined ? {} : {
-                checkpoint: request.checkpoint
-              })
+            cancellation = module.cancelEncryptedRecordingV2(operationId).catch(() => {
+              cancellationFailed = true;
             });
-            if (decision.profile !== 'encrypted_upload_v2') {
-              throw new Error('encrypted upload v2 requires an explicit v2 profile');
-            }
-            await module.resolveEncryptedUploadV2Profile(request.requestId, decision);
-          } catch (error) {
-            await module.rejectEncryptedUploadV2Profile(request.requestId, 'application_material_rejected');
+          } catch {
+            cancellationFailed = true;
           }
-        })().catch(() => {});
-      });
-      const progressSubscription = module.onEncryptedUploadV2Progress(progress => {
-        if (progress.operationId !== operationId) return;
-        onProgress?.(mapEncryptedUploadV2Progress(progress));
-      });
+        }
+      };
+      let profileSubscription;
+      let progressSubscription;
       try {
+        options.signal?.addEventListener('abort', cancel, {
+          once: true
+        });
+        profileSubscription = module.onEncryptedUploadV2ProfileRequested(request => {
+          if (!active || options.signal?.aborted || request.operationId !== operationId) return;
+          void (async () => {
+            let decision;
+            try {
+              decision = await provider({
+                operationId,
+                recording: request.recording,
+                capability: request.capability,
+                ...(request.checkpoint === undefined ? {} : {
+                  checkpoint: request.checkpoint
+                })
+              });
+              if (!active || options.signal?.aborted) {
+                await module.releaseEncryptedUploadV2Material(decision.materialRegistrationId);
+                return;
+              }
+              if (decision.profile !== 'encrypted_upload_v2') {
+                throw new Error('encrypted upload v2 requires an explicit v2 profile');
+              }
+              await module.resolveEncryptedUploadV2Profile(request.requestId, decision);
+            } catch (error) {
+              if (decision) await module.releaseEncryptedUploadV2Material(decision.materialRegistrationId).catch(() => {});
+              if (active && !options.signal?.aborted) {
+                await module.rejectEncryptedUploadV2Profile(request.requestId, 'application_material_rejected');
+              }
+            }
+          })().catch(() => {});
+        });
+        progressSubscription = module.onEncryptedUploadV2Progress(progress => {
+          if (!active || options.signal?.aborted || progress.operationId !== operationId) return;
+          onProgress?.(mapEncryptedUploadV2Progress(progress));
+        });
+        if (options.signal?.aborted) throw new Error('encrypted upload v2 cancelled');
+        nativeStarted = true;
         await module.syncEncryptedRecordingV2(toNativeConnectedDevice(device), recording, operationId);
       } finally {
-        profileSubscription.remove();
-        progressSubscription.remove();
+        active = false;
+        let cleanupFailed = false;
+        for (const remove of [() => options.signal?.removeEventListener('abort', cancel), () => profileSubscription?.remove(), () => progressSubscription?.remove()]) {
+          try {
+            remove();
+          } catch {
+            cleanupFailed = true;
+          }
+        }
+        await cancellation;
+        if (cancellationFailed) throw new Error('encrypted upload v2 cancellation failed');
+        if (cleanupFailed) throw new Error('encrypted upload v2 listener cleanup failed');
       }
     },
     async uploadRecordingFile(task, onProgress) {
@@ -565,6 +664,9 @@ const createBotaDeviceSDK = nativeModule => {
     async cancelRecordingUpload(taskId) {
       await requireNativeModule().cancelRecordingUpload(taskId);
     },
+    async releaseRecordingFile(taskId, localPath) {
+      await requireNativeModule().releaseRecordingFile(taskId, localPath);
+    },
     async loadUploadQueue() {
       return parseUploadQueue(await requireNativeModule().loadCompatibilityUploadQueue());
     },
@@ -647,6 +749,42 @@ const createBotaDeviceSDK = nativeModule => {
     }
   };
   const logs = {
+    async readDiagnosticEvents(device) {
+      const batch = await requireNativeModule().readDiagnosticEvents(toNativeConnectedDevice(device));
+      if (batch.schema_version !== 1) throw new Error('Unsupported diagnostic batch schema');
+      return {
+        schema_version: 1,
+        events: batch.events.map(({
+          report,
+          ...event
+        }) => ({
+          ...event,
+          event_type: event.event_type,
+          reason_code: event.reason_code,
+          ...(report ? {
+            report: {
+              fault: report.fault,
+              execution: {
+                ...report.execution,
+                pc_trace: [...report.execution.pc_trace]
+              },
+              ...(report.runtime ? {
+                runtime: report.runtime
+              } : {}),
+              ...(report.breadcrumbs ? {
+                breadcrumbs: [...report.breadcrumbs]
+              } : {})
+            }
+          } : {})
+        }))
+      };
+    },
+    async acknowledgeDiagnosticEvents(device, acceptedEventIds) {
+      if (acceptedEventIds.some(id => !/^[0-9a-f]{16}$/.test(id))) {
+        throw new Error('Diagnostic event_id must be 16 lowercase hex characters');
+      }
+      await requireNativeModule().acknowledgeDiagnosticEvents(toNativeConnectedDevice(device), [...acceptedEventIds]);
+    },
     async subscribe(device, onLine) {
       const module = requireNativeModule();
       const eventSubscription = module.onDeviceLog(line => {
@@ -709,6 +847,19 @@ const createBotaDeviceSDK = nativeModule => {
     }
   };
   const client = {
+    clientPresence: {
+      async nextReport(deviceId) {
+        if (presenceStopped) return null;
+        const generation = presenceGeneration;
+        const report = await requireNativeModule().nextClientPresence(deviceId);
+        if (presenceStopped || generation !== presenceGeneration) return null;
+        return report === null ? null : {
+          ...report,
+          sdkPackage: _sdkIdentity.SDK_PACKAGE,
+          sdkVersion: _sdkIdentity.SDK_VERSION
+        };
+      }
+    },
     controls,
     devices,
     factoryReset,
@@ -719,6 +870,7 @@ const createBotaDeviceSDK = nativeModule => {
     streaming,
     wifi,
     async configure(configuration = {}) {
+      const generation = presenceGeneration;
       const nativeConfiguration = {
         logLevel: configuration.logLevel ?? 'warn',
         ...(configuration.applicationSupportDirectory ? {
@@ -726,8 +878,11 @@ const createBotaDeviceSDK = nativeModule => {
         } : {})
       };
       await requireNativeModule().configure(nativeConfiguration);
+      if (generation === presenceGeneration) presenceStopped = false;
     },
     async destroy() {
+      presenceStopped = true;
+      presenceGeneration++;
       await requireNativeModule().destroy();
     },
     async getCapabilities() {