@runanywhere/core 0.16.0

package/src/index.ts

@@ -0,0 +1,238 @@
+/**
+ * @runanywhere/core - Core SDK for RunAnywhere React Native
+ *
+ * Core SDK that includes:
+ * - RACommons bindings via Nitrogen HybridObject
+ * - Authentication, Device Registration
+ * - Model Registry, Download Service
+ * - Storage, Events, HTTP Client
+ *
+ * NO LLM/STT/TTS/VAD functionality - use:
+ * - @runanywhere/llamacpp for text generation
+ * - @runanywhere/onnx for speech processing
+ *
+ * @packageDocumentation
+ */
+
+// =============================================================================
+// Main SDK
+// =============================================================================
+
+export { RunAnywhere } from './Public/RunAnywhere';
+
+// =============================================================================
+// Types
+// =============================================================================
+
+export * from './types';
+
+// =============================================================================
+// Foundation - Error Types
+// =============================================================================
+
+export {
+  // Error Codes
+  ErrorCode,
+  getErrorCodeMessage,
+  // Error Category
+  ErrorCategory,
+  allErrorCategories,
+  getCategoryFromCode,
+  inferCategoryFromError,
+  // Error Context
+  type ErrorContext,
+  createErrorContext,
+  formatStackTrace,
+  formatLocation,
+  formatContext,
+  ContextualError,
+  withContext,
+  getErrorContext,
+  getUnderlyingError,
+  // SDKError
+  SDKErrorCode,
+  type SDKErrorProtocol,
+  SDKError,
+  asSDKError,
+  isSDKError,
+  captureAndThrow,
+  notInitializedError,
+  alreadyInitializedError,
+  invalidInputError,
+  modelNotFoundError,
+  modelLoadError,
+  networkError,
+  authenticationError,
+  generationError,
+  storageError,
+} from './Foundation/ErrorTypes';
+
+// =============================================================================
+// Foundation - Initialization
+// =============================================================================
+
+export {
+  InitializationPhase,
+  type SDKInitParams,
+  type InitializationState,
+  isSDKUsable,
+  areServicesReady,
+  isInitializing,
+  createInitialState,
+  markCoreInitialized,
+  markServicesInitializing,
+  markServicesInitialized,
+  markInitializationFailed,
+  resetState,
+} from './Foundation/Initialization';
+
+// =============================================================================
+// Foundation - Security
+// =============================================================================
+
+export {
+  SecureStorageKeys,
+  SecureStorageService,
+  type SecureStorageErrorCode,
+  SecureStorageError,
+  isSecureStorageError,
+  isItemNotFoundError,
+  DeviceIdentity,
+} from './Foundation/Security';
+
+// =============================================================================
+// Foundation - Constants
+// =============================================================================
+
+export { SDKConstants } from './Foundation/Constants';
+
+// =============================================================================
+// Foundation - Logging
+// =============================================================================
+
+export { SDKLogger } from './Foundation/Logging/Logger/SDKLogger';
+export { LogLevel } from './Foundation/Logging/Models/LogLevel';
+export { LoggingManager } from './Foundation/Logging/Services/LoggingManager';
+
+// =============================================================================
+// Foundation - DI
+// =============================================================================
+
+export { ServiceRegistry } from './Foundation/DependencyInjection/ServiceRegistry';
+export { ServiceContainer } from './Foundation/DependencyInjection/ServiceContainer';
+
+// =============================================================================
+// Events
+// =============================================================================
+
+export { EventBus, NativeEventNames } from './Public/Events';
+export {
+  type SDKEvent,
+  EventDestination,
+  EventCategory,
+  createSDKEvent,
+  isSDKEvent,
+  EventPublisher,
+} from './Infrastructure/Events';
+
+// =============================================================================
+// Services (thin wrappers over native)
+// =============================================================================
+
+export {
+  ModelRegistry,
+  FileSystem,
+  DownloadService,
+  DownloadState,
+  SystemTTSService,
+  getVoicesByLanguage,
+  getDefaultVoice,
+  getPlatformDefaultVoice,
+  PlatformVoices,
+  type ModelCriteria,
+  type AddModelFromURLOptions,
+  type DownloadProgress,
+  type DownloadTask,
+  type DownloadConfiguration,
+  type ProgressCallback,
+} from './services';
+
+// =============================================================================
+// Network Layer - Using axios (industry standard HTTP library)
+// =============================================================================
+
+export {
+  // HTTP Service
+  HTTPService,
+  // Configuration
+  SDKEnvironment,
+  createNetworkConfig,
+  getEnvironmentName,
+  isDevelopment,
+  isProduction,
+  DEFAULT_BASE_URL,
+  DEFAULT_TIMEOUT_MS,
+  // Telemetry
+  TelemetryService,
+  TelemetryCategory,
+  // Endpoints
+  APIEndpoints,
+} from './services';
+
+export type {
+  HTTPServiceConfig,
+  DevModeConfig,
+  NetworkConfig,
+  TelemetryEvent,
+  APIEndpointKey,
+  APIEndpointValue,
+} from './services';
+
+// =============================================================================
+// Features
+// =============================================================================
+
+export {
+  AudioCaptureManager,
+  AudioPlaybackManager,
+  VoiceSessionHandle,
+  DEFAULT_VOICE_SESSION_CONFIG,
+} from './Features';
+export type {
+  AudioDataCallback,
+  AudioLevelCallback,
+  AudioCaptureConfig,
+  AudioCaptureState,
+  PlaybackState,
+  PlaybackCompletionCallback,
+  PlaybackErrorCallback,
+  PlaybackConfig,
+  VoiceSessionConfig,
+  VoiceSessionEvent,
+  VoiceSessionEventType,
+  VoiceSessionEventCallback,
+  VoiceSessionState,
+} from './Features';
+
+// =============================================================================
+// Native Module (now part of core)
+// =============================================================================
+
+export {
+  NativeRunAnywhereCore,
+  getNativeCoreModule,
+  requireNativeCoreModule,
+  isNativeCoreModuleAvailable,
+  // Backwards compatibility exports (match old @runanywhere/native)
+  requireNativeModule,
+  isNativeModuleAvailable,
+  requireDeviceInfoModule,
+  requireFileSystemModule,
+} from './native/NativeRunAnywhereCore';
+export type { NativeRunAnywhereCoreModule, FileSystemModule } from './native/NativeRunAnywhereCore';
+
+// =============================================================================
+// Nitrogen Spec Types
+// =============================================================================
+
+export type { RunAnywhereCore } from './specs/RunAnywhereCore.nitro';

package/src/native/NativeRunAnywhereCore.ts

@@ -0,0 +1,291 @@
+/**
+ * NativeRunAnywhereCore.ts
+ *
+ * Exports the native RunAnywhereCore Hybrid Object from Nitro Modules.
+ * This module provides core SDK functionality without any inference backends.
+ *
+ * For LLM, STT, TTS, VAD capabilities, use the separate packages:
+ * - @runanywhere/llamacpp for text generation
+ * - @runanywhere/onnx for speech processing
+ */
+
+import { NitroModules } from 'react-native-nitro-modules';
+import type { RunAnywhereCore } from '../specs/RunAnywhereCore.nitro';
+import type { RunAnywhereDeviceInfo } from '../specs/RunAnywhereDeviceInfo.nitro';
+import type { NativeRunAnywhereModule } from './NativeRunAnywhereModule';
+import { SDKLogger } from '../Foundation/Logging';
+
+export type { NativeRunAnywhereModule } from './NativeRunAnywhereModule';
+export { hasNativeMethod } from './NativeRunAnywhereModule';
+
+/**
+ * The native RunAnywhereCore module type
+ */
+export type NativeRunAnywhereCoreModule = RunAnywhereCore;
+
+/**
+ * Get the native RunAnywhereCore Hybrid Object
+ *
+ * This provides direct access to the native module.
+ * Most users should use the RunAnywhere facade class instead.
+ */
+export function requireNativeCoreModule(): NativeRunAnywhereCoreModule {
+  return NitroModules.createHybridObject<RunAnywhereCore>('RunAnywhereCore');
+}
+
+/**
+ * Check if the native core module is available
+ */
+export function isNativeCoreModuleAvailable(): boolean {
+  try {
+    requireNativeCoreModule();
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Singleton instance of the native module (lazy initialized)
+ */
+let _nativeModule: NativeRunAnywhereModule | undefined;
+
+/**
+ * Get the singleton native module instance
+ * Returns the full module type for backwards compatibility
+ */
+export function getNativeCoreModule(): NativeRunAnywhereModule {
+  if (!_nativeModule) {
+    // Cast to full module type - optional methods may not be available
+    _nativeModule = requireNativeCoreModule() as unknown as NativeRunAnywhereModule;
+  }
+  return _nativeModule;
+}
+
+// =============================================================================
+// Backwards compatibility exports
+// These match the old @runanywhere/native exports
+// =============================================================================
+
+/**
+ * Get the native module with full API type
+ * Some methods may not be available unless backend packages are installed
+ */
+export function requireNativeModule(): NativeRunAnywhereModule {
+  return getNativeCoreModule();
+}
+
+/**
+ * Check if native module is available
+ */
+export function isNativeModuleAvailable(): boolean {
+  return isNativeCoreModuleAvailable();
+}
+
+/**
+ * Device info module interface
+ */
+export interface DeviceInfoModule {
+  deviceId: string;
+  getDeviceIdSync: () => string;
+  uniqueId: string;
+  getDeviceModel: () => Promise<string>;
+  getChipName: () => Promise<string>;
+  getTotalRAM: () => Promise<number>;
+  getAvailableRAM: () => Promise<number>;
+  hasNPU: () => Promise<boolean>;
+  getOSVersion: () => Promise<string>;
+  hasGPU: () => Promise<boolean>;
+  getCPUCores: () => Promise<number>;
+}
+
+/**
+ * Singleton for device info hybrid object
+ */
+let _deviceInfoModule: RunAnywhereDeviceInfo | null = null;
+
+/**
+ * Get the RunAnywhereDeviceInfo hybrid object
+ * This provides real device info from native iOS/Android code
+ */
+function getDeviceInfoHybridObject(): RunAnywhereDeviceInfo | null {
+  if (_deviceInfoModule) {
+    return _deviceInfoModule;
+  }
+  try {
+    _deviceInfoModule = NitroModules.createHybridObject<RunAnywhereDeviceInfo>('RunAnywhereDeviceInfo');
+    return _deviceInfoModule;
+  } catch (error) {
+    console.warn('[NativeRunAnywhereCore] Failed to create RunAnywhereDeviceInfo:', error);
+    return null;
+  }
+}
+
+/**
+ * Device info module - provides device information
+ *
+ * Uses the RunAnywhereDeviceInfo NitroModule for real device info
+ * from native iOS (Swift) and Android (Kotlin) implementations.
+ */
+export function requireDeviceInfoModule(): DeviceInfoModule {
+  const deviceInfo = getDeviceInfoHybridObject();
+
+  return {
+    deviceId: '',
+    getDeviceIdSync: () => '',
+    uniqueId: '',
+
+    getDeviceModel: async () => {
+      if (deviceInfo) {
+        try {
+          return await deviceInfo.getDeviceModel();
+        } catch (error) {
+          console.warn('[DeviceInfo] getDeviceModel failed:', error);
+        }
+      }
+      return 'Unknown Device';
+    },
+
+    getChipName: async () => {
+      if (deviceInfo) {
+        try {
+          return await deviceInfo.getChipName();
+        } catch (error) {
+          console.warn('[DeviceInfo] getChipName failed:', error);
+        }
+      }
+      return 'Unknown';
+    },
+
+    getTotalRAM: async () => {
+      if (deviceInfo) {
+        try {
+          return await deviceInfo.getTotalRAM();
+        } catch (error) {
+          console.warn('[DeviceInfo] getTotalRAM failed:', error);
+        }
+      }
+      return 0;
+    },
+
+    getAvailableRAM: async () => {
+      if (deviceInfo) {
+        try {
+          return await deviceInfo.getAvailableRAM();
+        } catch (error) {
+          console.warn('[DeviceInfo] getAvailableRAM failed:', error);
+        }
+      }
+      return 0;
+    },
+
+    hasNPU: async () => {
+      if (deviceInfo) {
+        try {
+          return await deviceInfo.hasNPU();
+        } catch (error) {
+          console.warn('[DeviceInfo] hasNPU failed:', error);
+        }
+      }
+      return false;
+    },
+
+    getOSVersion: async () => {
+      if (deviceInfo) {
+        try {
+          return await deviceInfo.getOSVersion();
+        } catch (error) {
+          console.warn('[DeviceInfo] getOSVersion failed:', error);
+        }
+      }
+      return 'Unknown';
+    },
+
+    hasGPU: async () => {
+      if (deviceInfo) {
+        try {
+          return await deviceInfo.hasGPU();
+        } catch (error) {
+          console.warn('[DeviceInfo] hasGPU failed:', error);
+        }
+      }
+      return false;
+    },
+
+    getCPUCores: async () => {
+      if (deviceInfo) {
+        try {
+          return await deviceInfo.getCPUCores();
+        } catch (error) {
+          console.warn('[DeviceInfo] getCPUCores failed:', error);
+        }
+      }
+      return 0;
+    },
+  };
+}
+
+/**
+ * File system module interface
+ */
+export interface FileSystemModule {
+  getAvailableDiskSpace(): Promise<number>;
+  getTotalDiskSpace(): Promise<number>;
+  downloadModel(
+    fileName: string,
+    url: string,
+    onProgress?: (progress: number) => void
+  ): Promise<boolean>;
+  getModelPath(fileName: string): Promise<string>;
+  modelExists(fileName: string): Promise<boolean>;
+  deleteModel(fileName: string): Promise<boolean>;
+  getDataDirectory(): Promise<string>;
+  getModelsDirectory(): Promise<string>;
+}
+
+/**
+ * Get the file system module for model downloads and file operations
+ * Uses react-native-fs for cross-platform file operations
+ */
+export function requireFileSystemModule(): FileSystemModule {
+  // Import the FileSystem service
+  // eslint-disable-next-line @typescript-eslint/no-require-imports
+  const { FileSystem } = require('../services/FileSystem');
+
+  return {
+    getAvailableDiskSpace: () => FileSystem.getAvailableDiskSpace(),
+    getTotalDiskSpace: () => FileSystem.getTotalDiskSpace(),
+    downloadModel: async (
+      fileName: string,
+      url: string,
+      onProgress?: (progress: number) => void
+    ): Promise<boolean> => {
+      try {
+        await FileSystem.downloadModel(fileName, url, (progress: { progress: number }) => {
+          if (onProgress) {
+            onProgress(progress.progress);
+          }
+        });
+        return true;
+      } catch (error) {
+        SDKLogger.download.logError(error as Error, 'Download failed');
+        return false;
+      }
+    },
+    getModelPath: (fileName: string) => FileSystem.getModelPath(fileName),
+    modelExists: (fileName: string) => FileSystem.modelExists(fileName),
+    deleteModel: (fileName: string) => FileSystem.deleteModel(fileName),
+    getDataDirectory: () => Promise.resolve(FileSystem.getRunAnywhereDirectory()),
+    getModelsDirectory: () => Promise.resolve(FileSystem.getModelsDirectory()),
+  };
+}
+
+/**
+ * Default export - the native module getter
+ */
+export const NativeRunAnywhereCore = {
+  get: getNativeCoreModule,
+  isAvailable: isNativeCoreModuleAvailable,
+};
+
+export default NativeRunAnywhereCore;

package/src/native/NativeRunAnywhereModule.ts

@@ -0,0 +1,32 @@
+/**
+ * NativeRunAnywhereModule.ts
+ *
+ * Full native module type that includes all methods from core.
+ * All methods call backend-agnostic C++ APIs (rac_*_component_*).
+ *
+ * LLM, STT, TTS, VAD methods are backend-agnostic:
+ * - They call the C++ rac_*_component_* APIs
+ * - The actual backend is registered by importing backend packages:
+ *   - @runanywhere/llamacpp registers the LLM backend
+ *   - @runanywhere/onnx registers the STT/TTS/VAD backends
+ */
+
+import type { RunAnywhereCore } from '../specs/RunAnywhereCore.nitro';
+
+/**
+ * Native module type - directly matches RunAnywhereCore spec
+ *
+ * All methods are backend-agnostic. If no backend is registered for a
+ * capability, the methods will throw appropriate errors.
+ */
+export type NativeRunAnywhereModule = RunAnywhereCore;
+
+/**
+ * Type guard to check if a method is available on the native module
+ */
+export function hasNativeMethod<K extends keyof NativeRunAnywhereModule>(
+  native: NativeRunAnywhereModule,
+  method: K
+): boolean {
+  return typeof native[method] === 'function';
+}

package/src/native/index.ts

@@ -0,0 +1,21 @@
+/**
+ * Native module exports for @runanywhere/core
+ */
+
+export {
+  NativeRunAnywhereCore,
+  getNativeCoreModule,
+  requireNativeCoreModule,
+  isNativeCoreModuleAvailable,
+  // Backwards compatibility
+  requireNativeModule,
+  isNativeModuleAvailable,
+  requireDeviceInfoModule,
+  requireFileSystemModule,
+  hasNativeMethod,
+} from './NativeRunAnywhereCore';
+export type {
+  NativeRunAnywhereCoreModule,
+  NativeRunAnywhereModule,
+  FileSystemModule,
+} from './NativeRunAnywhereCore';