@bota-dev/react-native-sdk 0.0.2

package/lib/typescript/src/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAUjD;;GAEG;AACH,cAAM,MAAM;IACV,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,MAAM,CAAe;IAE7B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B;;OAEG;IACH,QAAQ,IAAI,QAAQ;IAIpB;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,MAAM;IAUd;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM/D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM9D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM9D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAS9E;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY;CAG/B;AAED;;GAEG;AACH,cAAM,YAAY;IAEd,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,GAAG;gBADH,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM;IAGrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAG/E;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,QAAe,CAAC;AAEnC;;GAEG;AACH,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/lib/typescript/src/utils/retry.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Retry utility with exponential backoff
+ */
+/**
+ * Retry configuration options
+ */
+export interface RetryOptions {
+    /** Maximum number of retry attempts (default: 6) */
+    maxAttempts?: number;
+    /** Base delay in milliseconds (default: 1000) */
+    baseDelayMs?: number;
+    /** Maximum delay in milliseconds (default: 14400000 = 4 hours) */
+    maxDelayMs?: number;
+    /** Backoff multiplier (default: 2) */
+    backoffMultiplier?: number;
+    /** Add jitter to delays (default: true) */
+    jitter?: boolean;
+    /** Callback for each retry attempt */
+    onRetry?: (attempt: number, error: Error, delayMs: number) => void;
+    /** Predicate to determine if error is retryable (default: all errors) */
+    isRetryable?: (error: Error) => boolean;
+}
+/**
+ * Default retry delays based on Bota spec:
+ * Attempt 1: Immediate
+ * Attempt 2: 30 seconds
+ * Attempt 3: 2 minutes
+ * Attempt 4: 10 minutes
+ * Attempt 5: 1 hour
+ * Attempt 6: 4 hours
+ */
+export declare const DEFAULT_RETRY_DELAYS: number[];
+/**
+ * Calculate delay for a retry attempt using exponential backoff
+ */
+export declare function calculateDelay(attempt: number, options?: RetryOptions): number;
+/**
+ * Sleep for a specified duration
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Execute a function with retry logic
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+/**
+ * Create a retryable wrapper for a function
+ */
+export declare function makeRetryable<T extends (...args: unknown[]) => Promise<unknown>>(fn: T, options?: RetryOptions): T;
+/**
+ * Check if we should continue retrying based on total time elapsed
+ */
+export declare function shouldContinueRetrying(startTime: Date, maxDurationMs?: number): boolean;
+//# sourceMappingURL=retry.d.ts.map

package/lib/typescript/src/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnE,yEAAyE;IACzE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;CACzC;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,UAOhC,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACzB,MAAM,CA4BR;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CA0DZ;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,EAC9E,EAAE,EAAE,CAAC,EACL,OAAO,GAAE,YAAiB,GACzB,CAAC,CAIH;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,IAAI,EACf,aAAa,GAAE,MAA4B,GAC1C,OAAO,CAGT"}

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@bota-dev/react-native-sdk",
+  "version": "0.0.2",
+  "description": "Bota React Native SDK for BLE device communication",
+  "main": "lib/commonjs/index.js",
+  "module": "lib/module/index.js",
+  "types": "lib/typescript/src/index.d.ts",
+  "react-native": "src/index.ts",
+  "source": "src/index.ts",
+  "files": [
+    "src",
+    "lib",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__"
+  ],
+  "scripts": {
+    "build": "bob build",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint \"src/**/*.{ts,tsx}\"",
+    "test": "jest --passWithNoTests",
+    "clean": "rm -rf lib"
+  },
+  "keywords": [
+    "react-native",
+    "ble",
+    "bluetooth",
+    "bota",
+    "audio",
+    "recording"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bota-dev/react-native-sdk.git"
+  },
+  "author": "Qi Zhang <qi@bota.dev>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/bota-dev/react-native-sdk/issues"
+  },
+  "homepage": "https://docs.bota.dev",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-native": ">=0.72.0",
+    "react-native-ble-plx": "^3.0.0",
+    "@react-native-async-storage/async-storage": "^1.21.0"
+  },
+  "peerDependenciesMeta": {
+    "react-native-ble-plx": {
+      "optional": false
+    },
+    "@react-native-async-storage/async-storage": {
+      "optional": false
+    }
+  },
+  "dependencies": {
+    "buffer": "^6.0.3",
+    "eventemitter3": "^5.0.1"
+  },
+  "devDependencies": {
+    "@react-native-async-storage/async-storage": "^1.21.0",
+    "@types/jest": "^29.5.12",
+    "@types/react": "^18.2.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.57.0",
+    "jest": "^29.7.0",
+    "react": "18.2.0",
+    "react-native": "0.73.0",
+    "react-native-ble-plx": "^3.1.2",
+    "react-native-builder-bob": "^0.23.2",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  }
+}

package/src/BotaClient.ts

@@ -0,0 +1,238 @@
+/**
+ * Bota Client - Main entry point for the Bota React Native SDK
+ */
+
+import { State } from 'react-native-ble-plx';
+import EventEmitter from 'eventemitter3';
+
+import { getBleManager, resetBleManager, BleManager } from './ble/BleManager';
+import { DeviceManager } from './managers/DeviceManager';
+import { RecordingManager } from './managers/RecordingManager';
+import { OTAManager } from './managers/OTAManager';
+import type {
+  BotaConfig,
+  SdkState,
+  BluetoothState,
+  BotaClientEvents,
+} from './models/Status';
+import { SdkError } from './utils/errors';
+import { logger } from './utils/logger';
+
+const log = logger.tag('BotaClient');
+
+/**
+ * Map react-native-ble-plx State to BluetoothState
+ */
+function mapBluetoothState(state: State): BluetoothState {
+  switch (state) {
+    case State.Unknown:
+      return 'unknown';
+    case State.Resetting:
+      return 'resetting';
+    case State.Unsupported:
+      return 'unsupported';
+    case State.Unauthorized:
+      return 'unauthorized';
+    case State.PoweredOff:
+      return 'poweredOff';
+    case State.PoweredOn:
+      return 'poweredOn';
+    default:
+      return 'unknown';
+  }
+}
+
+/**
+ * Bota Client class - singleton SDK entry point
+ */
+class BotaClientImpl extends EventEmitter<BotaClientEvents> {
+  private _config: BotaConfig | null = null;
+  private _state: SdkState = 'uninitialized';
+  private _bluetoothState: BluetoothState = 'unknown';
+
+  private _bleManager: BleManager | null = null;
+  private _deviceManager: DeviceManager | null = null;
+  private _recordingManager: RecordingManager | null = null;
+  private _otaManager: OTAManager | null = null;
+
+  /**
+   * Get current SDK state
+   */
+  get state(): SdkState {
+    return this._state;
+  }
+
+  /**
+   * Get current Bluetooth state
+   */
+  get bluetoothState(): BluetoothState {
+    return this._bluetoothState;
+  }
+
+  /**
+   * Check if Bluetooth is ready
+   */
+  get isBluetoothReady(): boolean {
+    return this._bluetoothState === 'poweredOn';
+  }
+
+  /**
+   * Check if SDK is initialized
+   */
+  get isInitialized(): boolean {
+    return this._state === 'ready';
+  }
+
+  /**
+   * Get current configuration
+   */
+  get config(): BotaConfig | null {
+    return this._config;
+  }
+
+  /**
+   * Get device manager
+   */
+  get devices(): DeviceManager {
+    if (!this._deviceManager) {
+      throw SdkError.notInitialized();
+    }
+    return this._deviceManager;
+  }
+
+  /**
+   * Get recording manager
+   */
+  get recordings(): RecordingManager {
+    if (!this._recordingManager) {
+      throw SdkError.notInitialized();
+    }
+    return this._recordingManager;
+  }
+
+  /**
+   * Get OTA manager
+   */
+  get ota(): OTAManager {
+    if (!this._otaManager) {
+      throw SdkError.notInitialized();
+    }
+    return this._otaManager;
+  }
+
+  /**
+   * Configure and initialize the SDK
+   */
+  async configure(config: BotaConfig = {}): Promise<void> {
+    if (this._state === 'ready') {
+      log.warn('SDK already configured, reconfiguring');
+      await this.destroy();
+    }
+
+    log.info('Configuring SDK', config as Record<string, unknown>);
+
+    this._config = {
+      environment: config.environment ?? 'production',
+      backgroundSyncEnabled: config.backgroundSyncEnabled ?? true,
+      wifiOnlyUpload: config.wifiOnlyUpload ?? false,
+      logLevel: config.logLevel ?? 'warn',
+      debug: config.debug ?? false,
+    };
+
+    // Set log level
+    logger.setLevel(this._config.logLevel!);
+
+    this.setState('initializing');
+
+    try {
+      // Initialize BLE manager
+      this._bleManager = getBleManager();
+
+      // Set up Bluetooth state listener
+      this._bleManager.on('stateChange', (state) => {
+        const mappedState = mapBluetoothState(state);
+        if (mappedState !== this._bluetoothState) {
+          this._bluetoothState = mappedState;
+          this.emit('bluetoothStateChanged', mappedState);
+        }
+      });
+
+      // Get initial Bluetooth state
+      const initialState = await this._bleManager.getState();
+      this._bluetoothState = mapBluetoothState(initialState);
+
+      // Initialize managers
+      this._deviceManager = new DeviceManager();
+      this._deviceManager.initialize();
+
+      this._recordingManager = new RecordingManager();
+      await this._recordingManager.initialize();
+
+      this._otaManager = new OTAManager();
+
+      this.setState('ready');
+
+      log.info('SDK configured successfully', {
+        environment: this._config.environment,
+        bluetoothState: this._bluetoothState,
+      });
+    } catch (error) {
+      this.setState('error');
+      log.error('Failed to configure SDK', error as Error);
+      throw error;
+    }
+  }
+
+  /**
+   * Wait for Bluetooth to be ready
+   */
+  async waitForBluetooth(timeoutMs: number = 10000): Promise<void> {
+    if (!this._bleManager) {
+      throw SdkError.notInitialized();
+    }
+
+    await this._bleManager.waitForReady(timeoutMs);
+  }
+
+  /**
+   * Destroy the SDK and clean up resources
+   */
+  async destroy(): Promise<void> {
+    log.info('Destroying SDK');
+
+    this._deviceManager?.destroy();
+    this._recordingManager?.destroy();
+    this._otaManager?.destroy();
+
+    resetBleManager();
+
+    this._deviceManager = null;
+    this._recordingManager = null;
+    this._otaManager = null;
+    this._bleManager = null;
+    this._config = null;
+
+    this.setState('uninitialized');
+    this.removeAllListeners();
+  }
+
+  /**
+   * Set SDK state and emit event
+   */
+  private setState(state: SdkState): void {
+    if (state !== this._state) {
+      this._state = state;
+      this.emit('stateChanged', state);
+    }
+  }
+}
+
+/**
+ * Singleton instance
+ */
+export const BotaClient = new BotaClientImpl();
+
+/**
+ * Export types
+ */
+export type { BotaConfig, SdkState, BluetoothState };