@bota.dev/react-native-app-sdk 2.0.0-beta.1 → 2.0.0-beta.4

package/lib/module/ble/deviceDiagnostics.js

@@ -0,0 +1,234 @@
+"use strict";
+
+import { Buffer } from 'buffer';
+import { DEVICE_DIAGNOSTICS_EVT_END, DEVICE_DIAGNOSTICS_EVT_DETAIL, DEVICE_DIAGNOSTICS_EVT_META, DEVICE_DIAGNOSTICS_EVT_SIGNATURE } from './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.from(bytes).reverse().toString('hex').padStart(16, '0');
+}
+export function diagnosticEventIdCommand(eventId) {
+  if (!/^[0-9a-f]{16}$/.test(eventId)) {
+    throw new Error('Diagnostic event_id must be 16 lowercase hex characters');
+  }
+  return Buffer.concat([Buffer.from([0x11]), 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.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.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
+      } : {})
+    }
+  };
+}
+export class DeviceDiagnosticsDecoder {
+  events = new Map();
+  details = new Map();
+  push(packet) {
+    if (packet.length === 17 && packet[0] === 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] === 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] === 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.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] === 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();
+  }
+}
+//# sourceMappingURL=deviceDiagnostics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["Buffer","DEVICE_DIAGNOSTICS_EVT_END","DEVICE_DIAGNOSTICS_EVT_DETAIL","DEVICE_DIAGNOSTICS_EVT_META","DEVICE_DIAGNOSTICS_EVT_SIGNATURE","EVENT_TYPES","REASONS","SUBSYSTEMS","STATES","BREADCRUMBS","DETAIL_WIRE_SIZE","u64LeHex","bytes","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","type","set","event_id","event_type","reason_code","uptime_ms","event","get","signature","total","reset","detail","buffer","alloc","received","copy","Object","assign","error","expected","batch","schema_version","clear"],"sourceRoot":"../../../src","sources":["ble/deviceDiagnostics.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/client.js

@@ -1,5 +1,6 @@
 "use strict";
 
+import { SDK_PACKAGE, SDK_VERSION } from './sdkIdentity';
 import { reportCompatibilityDisconnection } from './compatibility/runtime';
 export class BotaNativeModuleError extends Error {
   code = 'native_module_unavailable';
@@ -8,12 +9,18 @@ export class BotaNativeModuleError extends Error {
     this.name = '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)
@@ -53,6 +60,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,
@@ -244,6 +286,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
@@ -263,9 +308,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,
@@ -275,6 +323,8 @@ const parseUploadQueue = serialized => {
   });
 };
 export const createBotaDeviceSDK = nativeModule => {
+  let presenceStopped = false;
+  let presenceGeneration = 0;
   const requireNativeModule = () => {
     if (!nativeModule) throw new BotaNativeModuleError();
     return nativeModule;
@@ -494,6 +544,10 @@ export 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 => {
@@ -505,38 +559,83 @@ export 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) {
@@ -560,6 +659,9 @@ export 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());
     },
@@ -642,6 +744,42 @@ export 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 => {
@@ -704,6 +842,19 @@ export 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: SDK_PACKAGE,
+          sdkVersion: SDK_VERSION
+        };
+      }
+    },
     controls,
     devices,
     factoryReset,
@@ -714,6 +865,7 @@ export const createBotaDeviceSDK = nativeModule => {
     streaming,
     wifi,
     async configure(configuration = {}) {
+      const generation = presenceGeneration;
       const nativeConfiguration = {
         logLevel: configuration.logLevel ?? 'warn',
         ...(configuration.applicationSupportDirectory ? {
@@ -721,8 +873,11 @@ export const createBotaDeviceSDK = nativeModule => {
         } : {})
       };
       await requireNativeModule().configure(nativeConfiguration);
+      if (generation === presenceGeneration) presenceStopped = false;
     },
     async destroy() {
+      presenceStopped = true;
+      presenceGeneration++;
       await requireNativeModule().destroy();
     },
     async getCapabilities() {