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

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

@@ -0,0 +1,54 @@
+import EventEmitter from 'eventemitter3';
+import type { ConnectedDevice, StorageInfo } from '../models/Device';
+import type { DeviceRecording, SyncProgress, StreamingSyncOptions, StreamingUploadProvider, UploadInfo, UploadTask } from '../models/Recording';
+import type { RecordingManagerEvents } from '../models/Status';
+import type { UploadInfoProvider } from './types';
+import { StreamingSession } from './StreamingSession';
+type DeviceUploadMonitorOutcome = 'completed' | 'failed' | 'detached';
+interface TriggerDeviceUploadResponse {
+    accepted: boolean;
+    errorCode?: number;
+}
+export declare class RecordingManager extends EventEmitter<RecordingManagerEvents> {
+    private readonly client;
+    private tasks;
+    private initialized;
+    private paused;
+    private destroyed;
+    private activeStreamingSession;
+    constructor();
+    initialize(): Promise<void>;
+    getStorageInfo(device: ConnectedDevice): Promise<StorageInfo>;
+    listRecordings(device: ConnectedDevice): Promise<DeviceRecording[]>;
+    syncRecording(device: ConnectedDevice, recording: DeviceRecording, uploadInfo: UploadInfo): AsyncGenerator<SyncProgress>;
+    triggerDeviceUpload(device: ConnectedDevice): Promise<TriggerDeviceUploadResponse | null>;
+    monitorDeviceUpload(device: ConnectedDevice, initialPendingCount: number): AsyncGenerator<SyncProgress & {
+        recordingIndex?: number;
+        totalRecordings?: number;
+    }, DeviceUploadMonitorOutcome>;
+    syncAllRecordings(device: ConnectedDevice, uploadInfoProvider: UploadInfoProvider): AsyncGenerator<SyncProgress & {
+        recordingIndex?: number;
+        totalRecordings?: number;
+    }>;
+    getPendingUploads(): UploadTask[];
+    getAllUploads(): UploadTask[];
+    startStreamingSync(device: ConnectedDevice, recordingUuid: string, uploadInfoProvider: StreamingUploadProvider, options?: StreamingSyncOptions): StreamingSession;
+    getActiveStreamingSession(): StreamingSession | null;
+    cancelUpload(taskId: string): Promise<void>;
+    retryFailedUploads(): Promise<void>;
+    clearCompletedUploads(): Promise<void>;
+    clearAllUploads(): Promise<void>;
+    pauseUploads(): void;
+    resumeUploads(): void;
+    destroy(): void;
+    private runUpload;
+    private emitSyncProgress;
+    private requireTask;
+    private updateTask;
+    private persistTasks;
+    private emitQueueUpdated;
+    private assertReady;
+    private assertAlive;
+}
+export {};
+//# sourceMappingURL=RecordingManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RecordingManager.d.ts","sourceRoot":"","sources":["../../../src/managers/RecordingManager.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,eAAe,CAAC;AAQzC,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,uBAAuB,EACvB,UAAU,EACV,UAAU,EACX,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EACL,gBAAgB,EAEjB,MAAM,oBAAoB,CAAC;AAE5B,KAAK,0BAA0B,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEtE,UAAU,2BAA2B;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAwDD,qBAAa,gBAAiB,SAAQ,YAAY,CAAC,sBAAsB,CAAC;IACxE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,sBAAsB,CAAiC;;IAOzD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAc7D,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAKlE,aAAa,CAClB,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,eAAe,EAC1B,UAAU,EAAE,UAAU,GACrB,cAAc,CAAC,YAAY,CAAC;IA4HzB,mBAAmB,CACvB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC;IAYvC,mBAAmB,CACxB,MAAM,EAAE,eAAe,EACvB,mBAAmB,EAAE,MAAM,GAC1B,cAAc,CACf,YAAY,GAAG;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,EACpE,0BAA0B,CAC3B;IA6BM,iBAAiB,CACtB,MAAM,EAAE,eAAe,EACvB,kBAAkB,EAAE,kBAAkB,GACrC,cAAc,CACf,YAAY,GAAG;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CACrE;IAkFD,iBAAiB,IAAI,UAAU,EAAE;IAMjC,aAAa,IAAI,UAAU,EAAE;IAI7B,kBAAkB,CAChB,MAAM,EAAE,eAAe,EACvB,aAAa,EAAE,MAAM,EACrB,kBAAkB,EAAE,uBAAuB,EAC3C,OAAO,GAAE,oBAAyB,GACjC,gBAAgB;IAwBnB,yBAAyB,IAAI,gBAAgB,GAAG,IAAI;IAI9C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3C,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBnC,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtC,YAAY,IAAI,IAAI;IAIpB,aAAa,IAAI,IAAI;IAKrB,OAAO,IAAI,IAAI;YAUD,SAAS;IAiCvB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,WAAW;YAML,UAAU;YAeV,YAAY;IAI1B,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,WAAW;CAGpB"}

package/lib/typescript/managers/StreamingSession.d.ts

@@ -0,0 +1,35 @@
+import EventEmitter from 'eventemitter3';
+import type { ConnectedDevice } from '../models/Device';
+import type { StreamingSessionEvents, StreamingState, StreamingUploadProvider } from '../models/Recording';
+type ProtocolHandler = unknown;
+type StorageManager = unknown;
+export declare const setStreamingSessionTerminalHandler: (session: StreamingSession, handler: () => void) => void;
+export declare class StreamingSession extends EventEmitter<StreamingSessionEvents> {
+    private readonly device;
+    private readonly recordingUuid;
+    private readonly uploadProvider;
+    private readonly chunkSizeKb;
+    private readonly flushIntervalMs;
+    private readonly client;
+    private readonly sessionId;
+    private currentState;
+    private receivedBytes;
+    private uploadedChunks;
+    private backendRecordingId?;
+    private relay?;
+    private started;
+    private terminal;
+    constructor(protocolHandler: ProtocolHandler, _storageManager: StorageManager, device: ConnectedDevice, recordingUuid: string, uploadProvider: StreamingUploadProvider, chunkSizeKb?: number, flushIntervalMs?: number);
+    get state(): StreamingState;
+    get bytesReceived(): number;
+    get chunksUploaded(): number;
+    get recordingId(): string | undefined;
+    get isActive(): boolean;
+    start(): Promise<void>;
+    abort(): void;
+    private handleProgress;
+    private finalize;
+    private releaseTerminal;
+}
+export {};
+//# sourceMappingURL=StreamingSession.d.ts.map

package/lib/typescript/managers/StreamingSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamingSession.d.ts","sourceRoot":"","sources":["../../../src/managers/StreamingSession.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,eAAe,CAAC;AAOzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EACV,sBAAsB,EACtB,cAAc,EACd,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAE7B,KAAK,eAAe,GAAG,OAAO,CAAC;AAC/B,KAAK,cAAc,GAAG,OAAO,CAAC;AAI9B,eAAO,MAAM,kCAAkC,GAC7C,SAAS,gBAAgB,EACzB,SAAS,MAAM,IAAI,KAClB,IAEF,CAAC;AASF,qBAAa,gBAAiB,SAAQ,YAAY,CAAC,sBAAsB,CAAC;IAgBtE,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAnBlC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,kBAAkB,CAAC,CAAS;IACpC,OAAO,CAAC,KAAK,CAAC,CAEH;IACX,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;gBAGvB,eAAe,EAAE,eAAe,EAChC,eAAe,EAAE,cAAc,EACd,MAAM,EAAE,eAAe,EACvB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,uBAAuB,EACvC,WAAW,SAAM,EACjB,eAAe,SAAS;IAM3C,IAAI,KAAK,IAAI,cAAc,CAE1B;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsE5B,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,cAAc;YAmBR,QAAQ;IA8BtB,OAAO,CAAC,eAAe;CAKxB"}

package/lib/typescript/managers/types.d.ts

@@ -0,0 +1,19 @@
+import type { DeviceRecording, UploadInfo } from '../models/Recording';
+export type UploadInfoProvider = (recording: DeviceRecording) => Promise<UploadInfo>;
+export interface FirmwareInfo {
+    version: string;
+    url: string;
+    checksum: string;
+    releaseNotes?: string;
+    size: number;
+}
+export type OtaStage = 'checking' | 'downloading' | 'preparing' | 'updating' | 'verifying' | 'restarting' | 'completed' | 'failed';
+export interface OtaProgress {
+    stage: OtaStage;
+    progress: number;
+    bytesTransferred?: number;
+    totalBytes?: number;
+    error?: string;
+}
+export type FirmwareDownloadProgressCallback = (bytesDownloaded: number, totalBytes: number) => void;
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/managers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/managers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEvE,MAAM,MAAM,kBAAkB,GAAG,CAC/B,SAAS,EAAE,eAAe,KACvB,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzB,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,MAAM,MAAM,QAAQ,GAChB,UAAU,GACV,aAAa,GACb,WAAW,GACX,UAAU,GACV,WAAW,GACX,YAAY,GACZ,WAAW,GACX,QAAQ,CAAC;AAEb,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,gCAAgC,GAAG,CAC7C,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,KACf,IAAI,CAAC"}

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

@@ -0,0 +1,392 @@
+/**
+ * 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 (1-byte bitmask)
+ * See: FIRMWARE_INTEGRATION_GUIDE_ZH.md section 3.1 — DeviceFlags enum
+ */
+export interface DeviceFlags {
+    charging: boolean;
+    lowBattery: boolean;
+    storageFull: boolean;
+    wifiConnected: boolean;
+    lteConnected: boolean;
+    syncActive: boolean;
+}
+/**
+ * LTE/4G modem status
+ */
+export type LteStatus = 'off' | 'searching' | 'registered' | 'connected' | 'denied' | 'noSim' | 'error' | 'lowVoltage' | 'disabled';
+/**
+ * WiFi radio status
+ */
+export type WifiStatus = 'off' | 'scanning' | 'connecting' | 'connected' | 'connectFailed' | 'noCredentials' | 'disabled' | 'error';
+/**
+ * Device discovered during Bluetooth scan (not yet connected)
+ */
+export interface DiscoveredDevice {
+    /** Bluetooth 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;
+    /** MAC address parsed from manufacturer data (null if firmware doesn't include it) */
+    macAddress: string | null;
+    /** Pairing state from manufacturer data */
+    pairingState: PairingState;
+    /** Signal strength (RSSI) */
+    rssi: number;
+    /** Raw manufacturer data bytes */
+    manufacturerData?: Uint8Array;
+    /** Timestamp when discovered */
+    discoveredAt: Date;
+}
+/**
+ * Device capabilities (bitmask)
+ */
+export interface DeviceCapabilities {
+    /** Supports Bluetooth Sync (BLE transfer) */
+    bleSync: boolean;
+    /** Supports WiFi Upload */
+    wifiUpload: boolean;
+    /** Supports Cellular Upload (4G/LTE) */
+    lteUpload: boolean;
+    /** Supports Remote Recording Control */
+    remoteRecord: boolean;
+}
+/**
+ * Device after successful Bluetooth connection
+ */
+export interface ConnectedDevice {
+    /** Bluetooth 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 capabilities */
+    capabilities?: DeviceCapabilities;
+}
+/**
+ * 4G modem debug information (parsed from extended device status)
+ */
+export interface ModemInfo {
+    imei?: string;
+    iccid?: string;
+    operator?: string;
+    rat?: string;
+    band?: string;
+    apn?: string;
+    simStatus?: string;
+    csq?: number;
+    ipAddress?: string;
+    modemVoltage?: number;
+    modemFirmware?: string;
+    roaming?: boolean;
+}
+/**
+ * Device status information
+ */
+export interface DeviceStatus {
+    /** Battery level (0-100) */
+    batteryLevel: number;
+    /** Battery voltage in millivolts (e.g., 3700 = 3.7V) */
+    batteryMv?: number;
+    /** Total storage capacity in MB (uint16LE, max 65535) */
+    storageTotalMb: number;
+    /** Storage used in MB (uint16LE, max 65535) */
+    storageUsedMb: number;
+    /** Current operational state */
+    state: DeviceState;
+    /** Number of pending recordings to sync */
+    pendingRecordings: number;
+    /** Last clock-sync timestamp (when the device's RTC was last set
+     *  from a time source — NTP, 4G QLTS/CCLK, or app Bluetooth time-sync).
+     *  This is NOT the last recording-upload timestamp. */
+    lastTimeSyncAt: Date | null;
+    /** Signal strength (for 4G devices, 0-5) */
+    signalStrength?: number;
+    /** Status flags */
+    flags: DeviceFlags;
+    /** Raw timestamp from device */
+    timestamp: number;
+    /** LTE/4G modem status (for 4G devices) */
+    lteStatus?: LteStatus;
+    /** LTE signal quality — raw CSQ value 0-31 (99 = unknown) */
+    lteSignalQuality?: number;
+    /** WiFi radio status (for WiFi devices) */
+    wifiStatus?: WifiStatus;
+    /** 4G modem debug info (from extended device status read) */
+    modemInfo?: ModemInfo;
+}
+/** A decoded line from the device's debug BLE log stream. */
+export interface DeviceLogEvent {
+    level: 'debug' | 'warn';
+    message: string;
+    isBacklog: boolean;
+}
+/**
+ * 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;
+}
+/**
+ * Options for reconnecting to a previously paired device by serial number
+ */
+export interface ReconnectOptions {
+    /** Scan timeout in milliseconds (default: 10000) */
+    scanTimeout?: 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 = 'development' | 'gamma' | 'production';
+/**
+ * Provisioning result
+ */
+export interface ProvisioningResult {
+    success: boolean;
+    error?: 'invalid_token' | 'storage_error' | 'chunk_error' | 'already_paired' | 'unknown';
+    /** Present on the three-byte authenticated factory-reset success result. */
+    localRecordingsDeleted?: number;
+}
+/** Result returned by the authenticated BLE factory-reset close-loop. */
+export type BleFactoryResetResult = {
+    success: true;
+    localRecordingsDeleted: number;
+} | {
+    success: false;
+    error: NonNullable<ProvisioningResult['error']>;
+};
+/**
+ * Called after firmware reports a successful wipe and before the SDK sends
+ * the explicit result receipt. Reject to leave firmware in its replayable
+ * WIPED phase.
+ */
+export type BleFactoryResetResultPersister = (result: Extract<BleFactoryResetResult, {
+    success: true;
+}>) => Promise<void>;
+/**
+ * Recording command type
+ */
+export type RecordingCommandType = 'start_recording' | 'stop_recording';
+/**
+ * Recording command status
+ */
+export type RecordingCommandStatus = 'pending' | 'delivered' | 'executed' | 'failed' | 'expired' | 'cancelled';
+/**
+ * Options for starting recording remotely
+ */
+export interface StartRecordingOptions {
+    /** Maximum recording duration in seconds (auto-stop) */
+    maxDurationSec?: number;
+    /** Metadata to attach to the recording */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for stopping recording remotely
+ */
+export interface StopRecordingOptions {
+    /** Whether to trigger immediate upload after stopping */
+    uploadImmediately?: boolean;
+}
+/**
+ * Recording command result
+ */
+export interface RecordingCommandResult {
+    /** Command ID from backend */
+    commandId: string;
+    /** Recording ID (for start_recording) */
+    recordingId?: string;
+    /** When recording started */
+    startedAt?: Date;
+    /** When recording stopped */
+    stoppedAt?: Date;
+    /** Recording duration in seconds */
+    durationSeconds?: number;
+}
+/**
+ * Recording command error
+ */
+export interface RecordingCommandError {
+    code: string;
+    message: string;
+}
+/**
+ * Full recording command response
+ */
+export interface RecordingCommand {
+    id: string;
+    deviceId: string;
+    type: RecordingCommandType;
+    status: RecordingCommandStatus;
+    grantToken: string;
+    result?: RecordingCommandResult;
+    error?: RecordingCommandError;
+    expiresAt?: Date;
+    createdAt: Date;
+}
+/**
+ * Current recording state of the device
+ */
+export interface RecordingState {
+    /** Whether device is currently recording */
+    active: boolean;
+    /** Current recording ID (if recording) */
+    recordingId?: string;
+    /** When recording started */
+    startedAt?: Date;
+    /** Duration in seconds (updated periodically) */
+    durationSeconds?: number;
+    /** Who initiated the recording */
+    initiatedBy?: 'local' | 'remote';
+}
+/**
+ * Connection type for network preference ordering
+ */
+export type ConnectionType = 'wifi' | 'ble' | 'cellular';
+/**
+ * Per-device connection settings read/written via Bluetooth DEVICE_SETTINGS characteristic
+ */
+export interface DeviceConnectionSettings {
+    enabled_connections: {
+        wifi: boolean;
+        cellular: boolean;
+    };
+    heartbeat_enabled_connections?: {
+        wifi: boolean;
+        cellular: boolean;
+    };
+    upload_network_preference: ConnectionType[];
+    power_management?: {
+        wifi_idle_timeout_seconds?: number | null;
+        cellular_idle_timeout_seconds?: number | null;
+    };
+    streaming_enabled?: boolean;
+    streaming_flush_interval_seconds?: number;
+}
+/**
+ * WiFi security type
+ */
+export type WiFiSecurityType = 'WPA2' | 'WPA3' | 'WEP' | 'OPEN';
+/**
+ * WiFi connection status
+ */
+export type WiFiStatus = 'idle' | 'connecting' | 'connected' | 'failed' | 'disconnected';
+/**
+ * WiFi configuration grant from backend
+ */
+export interface WiFiConfigGrant {
+    /** Grant blob (JWT token) */
+    grantBlob: string;
+    /** Expiration timestamp */
+    expiresAt: Date;
+}
+/**
+ * WiFi credentials to configure
+ */
+export interface WiFiCredentials {
+    /** WiFi network SSID */
+    ssid: string;
+    /** WiFi password */
+    password: string;
+    /** Security type (default: WPA2) */
+    securityType?: WiFiSecurityType;
+}
+/**
+ * WiFi configuration result from device
+ */
+export interface WiFiConfigResult {
+    /** Whether configuration was successful */
+    success: boolean;
+    /** Error code if failed */
+    error?: 'invalid_grant' | 'grant_expired' | 'decryption_error' | 'storage_error' | 'unknown';
+}
+/**
+ * WiFi status information from device
+ */
+export interface WiFiStatusInfo {
+    /** Current WiFi connection status */
+    status: WiFiStatus;
+    /** Connected SSID (if connected) */
+    ssid?: string;
+    /** Signal strength (0-100) */
+    signalStrength?: number;
+    /** Last connection error (if failed) */
+    lastError?: string;
+}
+/**
+ * A WiFi network discovered by the device's WiFi radio
+ */
+export interface WiFiScanNetwork {
+    /** Network SSID */
+    ssid: string;
+    /** Signal quality 0-100 */
+    quality: number;
+    /** Whether this is the currently connected network */
+    isCurrent: boolean;
+    /** Open network (no password required) */
+    isOpen?: boolean;
+}
+/**
+ * Result of a device-side WiFi scan
+ */
+export interface DeviceWiFiScanResult {
+    /** Discovered networks sorted by signal quality */
+    networks: WiFiScanNetwork[];
+    /** SSID of the currently connected network, if any */
+    currentSsid: string | null;
+}
+//# sourceMappingURL=Device.d.ts.map

package/lib/typescript/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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"}