@bota-dev/react-native-sdk 0.0.2

package/lib/typescript/src/ble/parsers.d.ts

@@ -0,0 +1,100 @@
+/**
+ * BLE data parsers for Bota device protocol
+ */
+import { Buffer } from 'buffer';
+import type { DeviceType, PairingState, DeviceState, DeviceStatus, DeviceFlags, StorageInfo } from '../models/Device';
+import type { DeviceRecording, AudioCodec, TransferPacket } from '../models/Recording';
+/**
+ * Parse device type from manufacturer data byte
+ */
+export declare function parseDeviceType(byte: number): DeviceType;
+/**
+ * Parse pairing state from manufacturer data byte
+ */
+export declare function parsePairingState(byte: number): PairingState;
+/**
+ * Parse firmware version from major/minor bytes
+ */
+export declare function parseFirmwareVersion(major: number, minor: number): string;
+/**
+ * Parse device state from status byte
+ */
+export declare function parseDeviceState(byte: number): DeviceState;
+/**
+ * Parse device flags from 16-bit value
+ */
+export declare function parseDeviceFlags(value: number): DeviceFlags;
+/**
+ * Parse device status from 16-byte characteristic value
+ *
+ * Format:
+ * Bytes 0-3:   Timestamp (Unix seconds)
+ * Byte 4:     Battery % (0-100)
+ * Byte 5:     State
+ * Byte 6:     Storage % (0-100)
+ * Byte 7:     Signal (0-5)
+ * Bytes 8-9:  Pending recordings count
+ * Bytes 10-13: Last sync time (Unix seconds)
+ * Bytes 14-15: Flags
+ */
+export declare function parseDeviceStatus(data: Buffer): DeviceStatus;
+/**
+ * Parse storage info from 16-byte characteristic value
+ *
+ * Format:
+ * Bytes 0-3:   Total storage (KB)
+ * Bytes 4-7:   Used storage (KB)
+ * Bytes 8-9:   Total recording count
+ * Bytes 10-11: Pending sync count
+ * Bytes 12-15: Reserved
+ */
+export declare function parseStorageInfo(data: Buffer): StorageInfo;
+/**
+ * Parse audio codec from byte value
+ */
+export declare function parseAudioCodec(byte: number): AudioCodec;
+/**
+ * Parse recording list from notification data
+ * Each recording entry is typically 24 bytes:
+ * - UUID: 16 bytes
+ * - Timestamp: 4 bytes (Unix seconds)
+ * - Duration: 2 bytes (seconds)
+ * - Size: 2 bytes (KB, or needs scaling)
+ */
+export declare function parseRecordingList(data: Buffer): DeviceRecording[];
+/**
+ * Parse transfer packet from device
+ *
+ * Format:
+ * Byte 0:     Packet type (0x01=data, 0x02=EOF, 0xFF=error)
+ * Bytes 1-2:  Sequence number
+ * Bytes 3-4:  Chunk size (data) or CRC32 start (EOF)
+ * Bytes 5+:   Audio data (data) or CRC32 remainder (EOF)
+ */
+export declare function parseTransferPacket(data: Buffer): TransferPacket;
+/**
+ * Create time sync data buffer
+ *
+ * Format:
+ * Bytes 0-3:  Unix timestamp (seconds)
+ * Bytes 4-5:  Milliseconds (0-999)
+ * Bytes 6-7:  Timezone offset (signed, minutes from UTC)
+ */
+export declare function createTimeSyncData(date?: Date): Buffer;
+/**
+ * Create ACK packet for transfer
+ *
+ * Format:
+ * Byte 0:    ACK type (0x10=ACK, 0x11=NACK, 0x12=Abort)
+ * Bytes 1-2: Sequence number
+ */
+export declare function createAckPacket(ackType: 'ack' | 'nack' | 'abort', sequenceNumber: number): Buffer;
+/**
+ * Create transfer control command
+ *
+ * Format:
+ * Byte 0: Command (0x01=list, 0x02=start, 0x07=confirm)
+ * Bytes 1+: Recording UUID (for start/confirm)
+ */
+export declare function createTransferCommand(command: 'list' | 'start' | 'confirm', recordingUuid?: string): Buffer;
+//# sourceMappingURL=parsers.d.ts.map

package/lib/typescript/src/ble/parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../../../../src/ble/parsers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,WAAW,EACX,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAsCvF;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAWxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAa5D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAqB1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAe3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAyB5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAW1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAaxD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CA6BlE;AAUD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAiChE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAWlE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,EACjC,cAAc,EAAE,MAAM,GACrB,MAAM,CAiBR;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,EACrC,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CAuBR"}

package/lib/typescript/src/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Bota React Native SDK
+ *
+ * SDK for communicating with Bota wearable devices via BLE.
+ *
+ * @packageDocumentation
+ */
+export { BotaClient } from './BotaClient';
+export type { BotaConfig, SdkState, BluetoothState } from './BotaClient';
+export { DeviceManager, RecordingManager, OTAManager } from './managers';
+export type { UploadInfoProvider, FirmwareInfo, OtaStage, OtaProgress } from './managers';
+export type { DeviceType, PairingState, ConnectionState, DeviceState, DeviceFlags, DiscoveredDevice, ConnectedDevice, DeviceStatus, StorageInfo, ScanOptions, Environment, ProvisioningResult, } from './models/Device';
+export type { AudioCodec, DeviceRecording, UploadInfo, SyncStage, SyncProgress, UploadTaskStatus, UploadTask, TransferPacket, } from './models/Recording';
+export type { LogLevel, SdkStatus, DeviceManagerEvents, RecordingManagerEvents, BotaClientEvents, } from './models/Status';
+export { BotaError, BluetoothError, DeviceError, ProvisioningError, TransferError, UploadError, SdkError, isBotaError, } from './utils/errors';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGzE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACzE,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG1F,YAAY,EACV,UAAU,EACV,YAAY,EACZ,eAAe,EACf,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,EACX,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,UAAU,EACV,eAAe,EACf,UAAU,EACV,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,QAAQ,EACR,SAAS,EACT,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,SAAS,EACT,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,QAAQ,EACR,WAAW,GACZ,MAAM,gBAAgB,CAAC"}

package/lib/typescript/src/managers/DeviceManager.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Device Manager - Handles device discovery, connection, and provisioning
+ */
+import EventEmitter from 'eventemitter3';
+import type { DiscoveredDevice, ConnectedDevice, DeviceStatus, ScanOptions, Environment } from '../models/Device';
+import type { DeviceManagerEvents } from '../models/Status';
+/**
+ * Device Manager class
+ */
+export declare class DeviceManager extends EventEmitter<DeviceManagerEvents> {
+    private bleManager;
+    private connectedDevices;
+    private statusSubscriptions;
+    private isInitialized;
+    constructor();
+    /**
+     * Initialize the device manager
+     */
+    initialize(): void;
+    /**
+     * Set up BLE event listeners
+     */
+    private setupBleListeners;
+    /**
+     * Start scanning for Bota devices
+     */
+    startScan(options?: ScanOptions): Promise<void>;
+    /**
+     * Stop scanning for devices
+     */
+    stopScan(): void;
+    /**
+     * Get list of discovered devices
+     */
+    getDiscoveredDevices(): DiscoveredDevice[];
+    /**
+     * Get list of connected devices
+     */
+    getConnectedDevices(): ConnectedDevice[];
+    /**
+     * Connect to a discovered device
+     */
+    connect(device: DiscoveredDevice): Promise<ConnectedDevice>;
+    /**
+     * Disconnect from a device
+     */
+    disconnect(device: ConnectedDevice): Promise<void>;
+    /**
+     * Check if a device is connected
+     */
+    isConnected(deviceId: string): boolean;
+    /**
+     * Provision a device with a token
+     */
+    provision(device: ConnectedDevice, deviceToken: string, environment?: Environment): Promise<void>;
+    /**
+     * Check if a device is provisioned
+     */
+    isProvisioned(device: ConnectedDevice): Promise<boolean>;
+    /**
+     * Get device status
+     */
+    getStatus(device: ConnectedDevice): Promise<DeviceStatus>;
+    /**
+     * Subscribe to device status updates
+     */
+    subscribeToStatus(device: ConnectedDevice, callback: (status: DeviceStatus) => void): () => void;
+    /**
+     * Sync time to device
+     */
+    syncTime(deviceId: string): Promise<void>;
+    private readSerialNumber;
+    private readFirmwareVersion;
+    private readHardwareRevision;
+    private readPairingState;
+    private writeApiEndpoint;
+    private writeDeviceToken;
+    private waitForProvisioningResult;
+    /**
+     * Clean up resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=DeviceManager.d.ts.map

package/lib/typescript/src/managers/DeviceManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceManager.d.ts","sourceRoot":"","sources":["../../../../src/managers/DeviceManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,YAAY,MAAM,eAAe,CAAC;AA6BzC,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,WAAW,EAEZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAS5D;;GAEG;AACH,qBAAa,aAAc,SAAQ,YAAY,CAAC,mBAAmB,CAAC;IAClE,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,gBAAgB,CAA2C;IACnE,OAAO,CAAC,mBAAmB,CAAwC;IACnE,OAAO,CAAC,aAAa,CAAS;;IAQ9B;;OAEG;IACH,UAAU,IAAI,IAAI;IAQlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4BzB;;OAEG;IACG,SAAS,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzD;;OAEG;IACH,QAAQ,IAAI,IAAI;IAMhB;;OAEG;IACH,oBAAoB,IAAI,gBAAgB,EAAE;IAI1C;;OAEG;IACH,mBAAmB,IAAI,eAAe,EAAE;IAIxC;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAoDjE;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAexD;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACG,SAAS,CACb,MAAM,EAAE,eAAe,EACvB,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,WAA0B,GACtC,OAAO,CAAC,IAAI,CAAC;IA4DhB;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAK9D;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC;IAc/D;;OAEG;IACH,iBAAiB,CACf,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GACvC,MAAM,IAAI;IAkCb;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAejC,gBAAgB;YAShB,mBAAmB;YASnB,oBAAoB;YAapB,gBAAgB;YAchB,gBAAgB;YAehB,gBAAgB;IAuC9B,OAAO,CAAC,yBAAyB;IAoDjC;;OAEG;IACH,OAAO,IAAI,IAAI;CAahB"}

package/lib/typescript/src/managers/OTAManager.d.ts

@@ -0,0 +1,78 @@
+/**
+ * OTA Manager - Handles firmware over-the-air updates
+ *
+ * Note: Full Nordic DFU implementation requires native modules.
+ * This is a placeholder that handles version checking and update preparation.
+ * Actual DFU transfer would need react-native-nordic-dfu or similar.
+ */
+import EventEmitter from 'eventemitter3';
+import type { ConnectedDevice } from '../models/Device';
+/**
+ * Firmware info
+ */
+export interface FirmwareInfo {
+    version: string;
+    url: string;
+    checksum: string;
+    releaseNotes?: string;
+    size: number;
+}
+/**
+ * OTA progress stages
+ */
+export type OtaStage = 'checking' | 'downloading' | 'preparing' | 'updating' | 'verifying' | 'completed' | 'failed';
+/**
+ * OTA progress
+ */
+export interface OtaProgress {
+    stage: OtaStage;
+    progress: number;
+    error?: string;
+}
+/**
+ * Events emitted by OTAManager
+ */
+interface OTAManagerEvents {
+    updateAvailable: (firmware: FirmwareInfo) => void;
+    progress: (deviceId: string, progress: OtaProgress) => void;
+    completed: (deviceId: string, version: string) => void;
+    failed: (deviceId: string, error: Error) => void;
+}
+/**
+ * OTA Manager class
+ */
+export declare class OTAManager extends EventEmitter<OTAManagerEvents> {
+    private firmwareCdnUrl;
+    constructor(firmwareCdnUrl?: string);
+    /**
+     * Check for available firmware updates
+     */
+    checkForUpdate(device: ConnectedDevice): Promise<FirmwareInfo | null>;
+    /**
+     * Download firmware package
+     */
+    downloadFirmware(firmware: FirmwareInfo): Promise<ArrayBuffer>;
+    /**
+     * Prepare device for DFU mode
+     */
+    enterDfuMode(device: ConnectedDevice): Promise<void>;
+    /**
+     * Perform firmware update
+     *
+     * Note: This is a placeholder. Full implementation requires:
+     * 1. react-native-nordic-dfu for actual DFU transfer
+     * 2. Native module integration
+     * 3. DFU package preparation
+     */
+    performUpdate(device: ConnectedDevice, firmware: FirmwareInfo): Promise<void>;
+    /**
+     * Compare semantic versions
+     */
+    private isNewerVersion;
+    /**
+     * Clean up resources
+     */
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=OTAManager.d.ts.map

package/lib/typescript/src/managers/OTAManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OTAManager.d.ts","sourceRoot":"","sources":["../../../../src/managers/OTAManager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,YAAY,MAAM,eAAe,CAAC;AAQzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAOxD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,UAAU,GACV,aAAa,GACb,WAAW,GACX,UAAU,GACV,WAAW,GACX,WAAW,GACX,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,UAAU,gBAAgB;IACxB,eAAe,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IAClD,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,KAAK,IAAI,CAAC;IAC5D,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClD;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,YAAY,CAAC,gBAAgB,CAAC;IAC5D,OAAO,CAAC,cAAc,CAAS;gBAEnB,cAAc,GAAE,MAAwC;IAKpE;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAmD3E;;OAEG;IACG,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAqBpE;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB1D;;;;;;;OAOG;IACG,aAAa,CACjB,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,IAAI,CAAC;IA+ChB;;OAEG;IACH,OAAO,CAAC,cAAc;IAmBtB;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/lib/typescript/src/managers/RecordingManager.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Recording Manager - Handles recording sync and upload operations
+ */
+import EventEmitter from 'eventemitter3';
+import type { ConnectedDevice, StorageInfo } from '../models/Device';
+import type { DeviceRecording, UploadInfo, SyncProgress, UploadTask } from '../models/Recording';
+import type { RecordingManagerEvents } from '../models/Status';
+/**
+ * Upload info provider callback type
+ */
+export type UploadInfoProvider = (recording: DeviceRecording) => Promise<UploadInfo>;
+/**
+ * Recording Manager class
+ */
+export declare class RecordingManager extends EventEmitter<RecordingManagerEvents> {
+    private protocolHandler;
+    private storage;
+    private uploadQueue;
+    private isInitialized;
+    constructor();
+    /**
+     * Initialize the recording manager
+     */
+    initialize(): Promise<void>;
+    /**
+     * Set up upload queue event listeners
+     */
+    private setupUploadQueueListeners;
+    /**
+     * Get storage info from device
+     */
+    getStorageInfo(device: ConnectedDevice): Promise<StorageInfo>;
+    /**
+     * List recordings on a device
+     */
+    listRecordings(device: ConnectedDevice): Promise<DeviceRecording[]>;
+    /**
+     * Sync a single recording from device
+     * Transfers from device, saves locally, and queues for upload
+     */
+    syncRecording(device: ConnectedDevice, recording: DeviceRecording, uploadInfo: UploadInfo): AsyncGenerator<SyncProgress>;
+    /**
+     * Wait for an upload task to complete
+     */
+    private waitForUpload;
+    /**
+     * Sync all recordings from a device
+     */
+    syncAllRecordings(device: ConnectedDevice, uploadInfoProvider: UploadInfoProvider): AsyncGenerator<SyncProgress & {
+        recordingIndex?: number;
+        totalRecordings?: number;
+    }>;
+    /**
+     * Get pending uploads
+     */
+    getPendingUploads(): UploadTask[];
+    /**
+     * Get all uploads
+     */
+    getAllUploads(): UploadTask[];
+    /**
+     * Cancel a pending upload
+     */
+    cancelUpload(taskId: string): Promise<void>;
+    /**
+     * Retry failed uploads
+     */
+    retryFailedUploads(): Promise<void>;
+    /**
+     * Clear completed uploads from queue
+     */
+    clearCompletedUploads(): Promise<void>;
+    /**
+     * Clear all uploads
+     */
+    clearAllUploads(): Promise<void>;
+    /**
+     * Pause upload processing
+     */
+    pauseUploads(): void;
+    /**
+     * Resume upload processing
+     */
+    resumeUploads(): void;
+    /**
+     * Clean up resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=RecordingManager.d.ts.map

package/lib/typescript/src/managers/RecordingManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecordingManager.d.ts","sourceRoot":"","sources":["../../../../src/managers/RecordingManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,YAAY,MAAM,eAAe,CAAC;AAKzC,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,YAAY,EACZ,UAAU,EACX,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAO/D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,SAAS,EAAE,eAAe,KACvB,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzB;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,YAAY,CAAC,sBAAsB,CAAC;IACxE,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAAS;;IAW9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAcjC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAwBjC;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAQnE;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAiBzE;;;OAGG;IACI,aAAa,CAClB,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,eAAe,EAC1B,UAAU,EAAE,UAAU,GACrB,cAAc,CAAC,YAAY,CAAC;IA2G/B;;OAEG;YACW,aAAa;IAwD3B;;OAEG;IACI,iBAAiB,CACtB,MAAM,EAAE,eAAe,EACvB,kBAAkB,EAAE,kBAAkB,GACrC,cAAc,CAAC,YAAY,GAAG;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IA6DvF;;OAEG;IACH,iBAAiB,IAAI,UAAU,EAAE;IAIjC;;OAEG;IACH,aAAa,IAAI,UAAU,EAAE;IAI7B;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzC;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5C;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtC;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,aAAa,IAAI,IAAI;IAIrB;;OAEG;IACH,OAAO,IAAI,IAAI;CAQhB"}

package/lib/typescript/src/managers/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Managers module exports
+ */
+export { DeviceManager } from './DeviceManager';
+export { RecordingManager, type UploadInfoProvider } from './RecordingManager';
+export { OTAManager, type FirmwareInfo, type OtaStage, type OtaProgress, } from './OTAManager';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/managers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/managers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EACL,UAAU,EACV,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC"}

package/lib/typescript/src/models/Device.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Device-related type definitions
+ */
+/**
+ * Device type identifier
+ */
+export type DeviceType = 'bota_pin' | 'bota_pin_4g' | 'bota_note';
+/**
+ * Pairing state of a device
+ */
+export type PairingState = 'unpaired' | 'pairing' | 'paired' | 'error';
+/**
+ * Connection state of a device
+ */
+export type ConnectionState = 'disconnected' | 'connecting' | 'bonding' | 'discovering' | 'connected' | 'disconnecting';
+/**
+ * Device operational state
+ */
+export type DeviceState = 'idle' | 'recording' | 'syncing' | 'uploading' | 'charging' | 'lowBattery' | 'storageFull' | 'error';
+/**
+ * Device status flags
+ */
+export interface DeviceFlags {
+    charging: boolean;
+    usbConnected: boolean;
+    lowBattery: boolean;
+    criticalBattery: boolean;
+    storageWarning: boolean;
+    storageFull: boolean;
+    cellularAvailable: boolean;
+    cellularRoaming: boolean;
+    wifiConnected: boolean;
+    recordingActive: boolean;
+    syncRequired: boolean;
+    updateAvailable: boolean;
+}
+/**
+ * Device discovered during BLE scan (not yet connected)
+ */
+export interface DiscoveredDevice {
+    /** BLE device identifier (platform-specific UUID) */
+    id: string;
+    /** Device name from advertisement (e.g., "Bota-Pin-A1B2C3") */
+    name: string;
+    /** Device type parsed from advertisement */
+    deviceType: DeviceType;
+    /** Firmware version from manufacturer data */
+    firmwareVersion: string;
+    /** Pairing state from manufacturer data */
+    pairingState: PairingState;
+    /** Signal strength (RSSI) */
+    rssi: number;
+    /** Raw manufacturer data bytes */
+    manufacturerData?: Uint8Array;
+    /** Timestamp when discovered */
+    discoveredAt: Date;
+}
+/**
+ * Device after successful BLE connection
+ */
+export interface ConnectedDevice {
+    /** BLE device identifier */
+    id: string;
+    /** Device serial number (read from Device Info service) */
+    serialNumber: string;
+    /** Device type */
+    deviceType: DeviceType;
+    /** Firmware version */
+    firmwareVersion: string;
+    /** Hardware revision (if available) */
+    hardwareRevision?: string;
+    /** Whether device has been provisioned with a token */
+    isProvisioned: boolean;
+    /** Current connection state */
+    connectionState: ConnectionState;
+    /** Negotiated MTU size */
+    mtu: number;
+}
+/**
+ * Device status information
+ */
+export interface DeviceStatus {
+    /** Battery level (0-100) */
+    batteryLevel: number;
+    /** Storage used percentage (0-100) */
+    storageUsedPercent: number;
+    /** Current operational state */
+    state: DeviceState;
+    /** Number of pending recordings to sync */
+    pendingRecordings: number;
+    /** Last sync timestamp */
+    lastSyncAt: Date | null;
+    /** Signal strength (for 4G devices, 0-5) */
+    signalStrength?: number;
+    /** Status flags */
+    flags: DeviceFlags;
+    /** Raw timestamp from device */
+    timestamp: number;
+}
+/**
+ * Storage information from device
+ */
+export interface StorageInfo {
+    /** Total storage in KB */
+    totalKb: number;
+    /** Used storage in KB */
+    usedKb: number;
+    /** Total recording count */
+    totalRecordings: number;
+    /** Pending sync count */
+    pendingSyncCount: number;
+}
+/**
+ * Configuration for device scanning
+ */
+export interface ScanOptions {
+    /** Timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Filter by device types */
+    deviceTypes?: DeviceType[];
+    /** Filter by pairing state */
+    pairingState?: PairingState;
+    /** Minimum RSSI to include */
+    minRssi?: number;
+    /** Allow duplicates (same device reported multiple times) */
+    allowDuplicates?: boolean;
+}
+/**
+ * Environment for API endpoint configuration
+ */
+export type Environment = 'production' | 'sandbox';
+/**
+ * Provisioning result
+ */
+export interface ProvisioningResult {
+    success: boolean;
+    error?: 'invalid_token' | 'storage_error' | 'chunk_error' | 'unknown';
+}
+//# sourceMappingURL=Device.d.ts.map

package/lib/typescript/src/models/Device.d.ts.map

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

package/lib/typescript/src/models/Recording.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Recording-related type definitions
+ */
+/**
+ * Audio codec type
+ */
+export type AudioCodec = 'pcm_16k' | 'pcm_8k' | 'opus_16k' | 'opus_8k';
+/**
+ * Recording metadata from device
+ */
+export interface DeviceRecording {
+    /** Unique identifier on device (UUID) */
+    uuid: string;
+    /** Recording start timestamp */
+    startedAt: Date;
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** File size in bytes */
+    fileSizeBytes: number;
+    /** Audio codec used */
+    codec: AudioCodec;
+}
+/**
+ * Upload information provided by customer backend
+ * (obtained by calling customer's API, not Bota API directly)
+ */
+export interface UploadInfo {
+    /** Pre-signed S3 URL for upload */
+    uploadUrl: string;
+    /** Upload token (up_*) for verification */
+    uploadToken: string;
+    /** Recording ID assigned by Bota API (rec_*) */
+    recordingId: string;
+    /** URL to call when upload is complete */
+    completeUrl: string;
+    /** Expiration time of the upload URL */
+    expiresAt: Date;
+}
+/**
+ * Sync progress stages
+ */
+export type SyncStage = 'preparing' | 'transferring' | 'uploading' | 'completing' | 'completed' | 'failed';
+/**
+ * Sync progress information
+ */
+export interface SyncProgress {
+    /** Current stage */
+    stage: SyncStage;
+    /** Progress within current stage (0.0 - 1.0) */
+    progress: number;
+    /** Bytes transferred so far (for transferring stage) */
+    bytesTransferred?: number;
+    /** Total bytes to transfer */
+    totalBytes?: number;
+    /** Bytes uploaded so far (for uploading stage) */
+    bytesUploaded?: number;
+    /** Recording ID (set when completed) */
+    recordingId?: string;
+    /** Error message (set when failed) */
+    error?: string;
+}
+/**
+ * Upload task status
+ */
+export type UploadTaskStatus = 'pending' | 'uploading' | 'completed' | 'failed';
+/**
+ * Upload task in the queue
+ */
+export interface UploadTask {
+    /** Unique task identifier */
+    id: string;
+    /** Recording ID from Bota API */
+    recordingId: string;
+    /** Device ID the recording came from */
+    deviceId: string;
+    /** Local file path */
+    localPath: string;
+    /** Pre-signed S3 upload URL */
+    uploadUrl: string;
+    /** Upload token */
+    uploadToken: string;
+    /** Complete URL to call after upload */
+    completeUrl: string;
+    /** Current status */
+    status: UploadTaskStatus;
+    /** Number of retry attempts */
+    retryCount: number;
+    /** Error message if failed */
+    errorMessage?: string;
+    /** Task creation time */
+    createdAt: Date;
+    /** Last update time */
+    updatedAt: Date;
+}
+/**
+ * Transfer packet from device
+ */
+export interface TransferPacket {
+    /** Packet type: data, eof, or error */
+    type: 'data' | 'eof' | 'error';
+    /** Sequence number */
+    sequenceNumber: number;
+    /** Audio data (for data packets) */
+    data?: Uint8Array;
+    /** CRC32 checksum (for EOF packets) */
+    checksum?: number;
+    /** Error code (for error packets) */
+    errorCode?: number;
+}
+//# sourceMappingURL=Recording.d.ts.map

package/lib/typescript/src/models/Recording.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Recording.d.ts","sourceRoot":"","sources":["../../../../src/models/Recording.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,SAAS,EAAE,IAAI,CAAC;IAChB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,WAAW,GACX,cAAc,GACd,WAAW,GACX,YAAY,GACZ,WAAW,GACX,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oBAAoB;IACpB,KAAK,EAAE,SAAS,CAAC;IACjB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,SAAS,EAAE,IAAI,CAAC;IAChB,uBAAuB;IACvB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;IAC/B,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}