@runanywhere/core 0.16.0

package/ios/Binaries/RACommons.xcframework/ios-arm64_x86_64-simulator/RACommons.framework/Headers/rac_api_types.h

@@ -0,0 +1,335 @@
+/**
+ * @file rac_api_types.h
+ * @brief API request and response data types
+ *
+ * Defines all data structures for API communication.
+ * This is the canonical source of truth - platform SDKs create thin wrappers.
+ */
+
+#ifndef RAC_API_TYPES_H
+#define RAC_API_TYPES_H
+
+#include <stdbool.h>
+#include <stddef.h>
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// Authentication Types
+// =============================================================================
+
+/**
+ * @brief Authentication request payload
+ * Sent to POST /api/v1/auth/sdk/authenticate
+ */
+typedef struct {
+    const char* api_key;
+    const char* device_id;
+    const char* platform;  // "ios", "android", etc.
+    const char* sdk_version;
+} rac_auth_request_t;
+
+/**
+ * @brief Authentication response payload
+ * Received from authentication and refresh endpoints
+ */
+typedef struct {
+    char* access_token;
+    char* refresh_token;
+    char* device_id;
+    char* user_id;  // Can be NULL (org-level auth)
+    char* organization_id;
+    char* token_type;    // Usually "bearer"
+    int32_t expires_in;  // Seconds until expiry
+} rac_auth_response_t;
+
+/**
+ * @brief Refresh token request payload
+ * Sent to POST /api/v1/auth/sdk/refresh
+ */
+typedef struct {
+    const char* device_id;
+    const char* refresh_token;
+} rac_refresh_request_t;
+
+// =============================================================================
+// Health Check Types
+// =============================================================================
+
+/**
+ * @brief Health status enum
+ */
+typedef enum {
+    RAC_HEALTH_HEALTHY = 0,
+    RAC_HEALTH_DEGRADED = 1,
+    RAC_HEALTH_UNHEALTHY = 2
+} rac_health_status_t;
+
+/**
+ * @brief Health check response
+ * Received from GET /v1/health
+ */
+typedef struct {
+    rac_health_status_t status;
+    char* version;
+    int64_t timestamp;  // Unix timestamp
+} rac_health_response_t;
+
+// =============================================================================
+// Device Registration Types
+// =============================================================================
+
+/**
+ * @brief Device hardware information
+ */
+typedef struct {
+    const char* device_fingerprint;
+    const char* device_model;  // e.g., "iPhone15,2"
+    const char* os_version;    // e.g., "17.0"
+    const char* platform;      // "ios", "android", etc.
+    const char* architecture;  // "arm64", "x86_64", etc.
+    int64_t total_memory;      // Bytes
+    int32_t cpu_cores;
+    bool has_neural_engine;
+    bool has_gpu;
+} rac_device_info_t;
+
+/**
+ * @brief Device registration request
+ * Sent to POST /api/v1/devices/register
+ */
+typedef struct {
+    rac_device_info_t device_info;
+    const char* sdk_version;
+    const char* build_token;
+    int64_t last_seen_at;  // Unix timestamp
+} rac_device_reg_request_t;
+
+/**
+ * @brief Device registration response
+ */
+typedef struct {
+    char* device_id;
+    char* status;       // "registered" or "updated"
+    char* sync_status;  // "synced" or "pending"
+} rac_device_reg_response_t;
+
+// =============================================================================
+// Telemetry Types
+// =============================================================================
+
+/**
+ * @brief Telemetry event payload
+ * Contains all possible fields for LLM, STT, TTS, VAD events
+ */
+typedef struct {
+    // Required fields
+    const char* id;
+    const char* event_type;
+    int64_t timestamp;   // Unix timestamp ms
+    int64_t created_at;  // Unix timestamp ms
+
+    // Event classification
+    const char* modality;  // "llm", "stt", "tts", "model", "system"
+
+    // Device identification
+    const char* device_id;
+    const char* session_id;
+
+    // Model info
+    const char* model_id;
+    const char* model_name;
+    const char* framework;
+
+    // Device info
+    const char* device;
+    const char* os_version;
+    const char* platform;
+    const char* sdk_version;
+
+    // Common metrics
+    double processing_time_ms;
+    bool success;
+    bool has_success;  // Whether success field is set
+    const char* error_message;
+    const char* error_code;
+
+    // LLM-specific
+    int32_t input_tokens;
+    int32_t output_tokens;
+    int32_t total_tokens;
+    double tokens_per_second;
+    double time_to_first_token_ms;
+    double prompt_eval_time_ms;
+    double generation_time_ms;
+    int32_t context_length;
+    double temperature;
+    int32_t max_tokens;
+
+    // STT-specific
+    double audio_duration_ms;
+    double real_time_factor;
+    int32_t word_count;
+    double confidence;
+    const char* language;
+    bool is_streaming;
+    int32_t segment_index;
+
+    // TTS-specific
+    int32_t character_count;
+    double characters_per_second;
+    int32_t audio_size_bytes;
+    int32_t sample_rate;
+    const char* voice;
+    double output_duration_ms;
+
+    // Model lifecycle
+    int64_t model_size_bytes;
+    const char* archive_type;
+
+    // VAD-specific
+    double speech_duration_ms;
+
+    // SDK lifecycle
+    int32_t count;
+
+    // Storage
+    int64_t freed_bytes;
+
+    // Network
+    bool is_online;
+    bool has_is_online;
+} rac_telemetry_event_t;
+
+/**
+ * @brief Telemetry batch request
+ * Sent to POST /api/v1/sdk/telemetry
+ */
+typedef struct {
+    rac_telemetry_event_t* events;
+    size_t event_count;
+    const char* device_id;
+    int64_t timestamp;
+    const char* modality;  // Can be NULL for V1 path
+} rac_telemetry_batch_t;
+
+/**
+ * @brief Telemetry batch response
+ */
+typedef struct {
+    bool success;
+    int32_t events_received;
+    int32_t events_stored;
+    int32_t events_skipped;
+    char** errors;
+    size_t error_count;
+    char* storage_version;  // "V1" or "V2"
+} rac_telemetry_response_t;
+
+// =============================================================================
+// API Error Types
+// =============================================================================
+
+/**
+ * @brief API error information
+ */
+typedef struct {
+    int32_t status_code;
+    char* message;
+    char* code;
+    char* raw_body;
+    char* request_url;
+} rac_api_error_t;
+
+// =============================================================================
+// Memory Management
+// =============================================================================
+
+/**
+ * @brief Free authentication response
+ */
+void rac_auth_response_free(rac_auth_response_t* response);
+
+/**
+ * @brief Free health response
+ */
+void rac_health_response_free(rac_health_response_t* response);
+
+/**
+ * @brief Free device registration response
+ */
+void rac_device_reg_response_free(rac_device_reg_response_t* response);
+
+/**
+ * @brief Free telemetry response
+ */
+void rac_telemetry_response_free(rac_telemetry_response_t* response);
+
+/**
+ * @brief Free API error
+ */
+void rac_api_error_free(rac_api_error_t* error);
+
+// =============================================================================
+// JSON Serialization
+// =============================================================================
+
+/**
+ * @brief Serialize auth request to JSON
+ * @param request The request to serialize
+ * @return JSON string (caller must free), or NULL on error
+ */
+char* rac_auth_request_to_json(const rac_auth_request_t* request);
+
+/**
+ * @brief Parse auth response from JSON
+ * @param json The JSON string
+ * @param out_response Output response (caller must free with rac_auth_response_free)
+ * @return 0 on success, -1 on error
+ */
+int rac_auth_response_from_json(const char* json, rac_auth_response_t* out_response);
+
+/**
+ * @brief Serialize refresh request to JSON
+ */
+char* rac_refresh_request_to_json(const rac_refresh_request_t* request);
+
+/**
+ * @brief Serialize device registration request to JSON
+ */
+char* rac_device_reg_request_to_json(const rac_device_reg_request_t* request);
+
+/**
+ * @brief Parse device registration response from JSON
+ */
+int rac_device_reg_response_from_json(const char* json, rac_device_reg_response_t* out_response);
+
+/**
+ * @brief Serialize telemetry event to JSON
+ */
+char* rac_telemetry_event_to_json(const rac_telemetry_event_t* event);
+
+/**
+ * @brief Serialize telemetry batch to JSON
+ */
+char* rac_telemetry_batch_to_json(const rac_telemetry_batch_t* batch);
+
+/**
+ * @brief Parse telemetry response from JSON
+ */
+int rac_telemetry_response_from_json(const char* json, rac_telemetry_response_t* out_response);
+
+/**
+ * @brief Parse API error from HTTP response
+ */
+int rac_api_error_from_response(int status_code, const char* body, const char* url,
+                                rac_api_error_t* out_error);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif  // RAC_API_TYPES_H

package/ios/Binaries/RACommons.xcframework/ios-arm64_x86_64-simulator/RACommons.framework/Headers/rac_audio_utils.h

@@ -0,0 +1,88 @@
+/**
+ * @file rac_audio_utils.h
+ * @brief RunAnywhere Commons - Audio Utility Functions
+ *
+ * Provides audio format conversion utilities used across the SDK.
+ * This centralizes audio processing logic that was previously duplicated
+ * in Swift/Kotlin SDKs.
+ */
+
+#ifndef RAC_AUDIO_UTILS_H
+#define RAC_AUDIO_UTILS_H
+
+#include <RACommons/rac_types.h>
+#include <RACommons/rac_tts_types.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// AUDIO CONVERSION API
+// =============================================================================
+
+/**
+ * @brief Convert Float32 PCM samples to WAV format (Int16 PCM with header)
+ *
+ * TTS backends typically output raw Float32 PCM samples in range [-1.0, 1.0].
+ * This function converts them to a complete WAV file that can be played by
+ * standard audio players (AVAudioPlayer on iOS, MediaPlayer on Android, etc.).
+ *
+ * WAV format details:
+ * - RIFF header with WAVE format
+ * - fmt chunk: PCM format (1), mono (1 channel), Int16 samples
+ * - data chunk: Int16 samples (scaled from Float32)
+ *
+ * @param pcm_data Input Float32 PCM samples
+ * @param pcm_size Size of pcm_data in bytes (must be multiple of 4)
+ * @param sample_rate Sample rate in Hz (e.g., 22050 for Piper TTS)
+ * @param out_wav_data Output: WAV file data (owned, must be freed with rac_free)
+ * @param out_wav_size Output: Size of WAV data in bytes
+ * @return RAC_SUCCESS or error code
+ *
+ * @note The caller owns the returned wav_data and must free it with rac_free()
+ *
+ * Example usage:
+ * @code
+ * void* wav_data = NULL;
+ * size_t wav_size = 0;
+ * rac_result_t result = rac_audio_float32_to_wav(
+ *     pcm_samples, pcm_size, RAC_TTS_DEFAULT_SAMPLE_RATE, &wav_data, &wav_size);
+ * if (result == RAC_SUCCESS) {
+ *     // Use wav_data...
+ *     rac_free(wav_data);
+ * }
+ * @endcode
+ */
+RAC_API rac_result_t rac_audio_float32_to_wav(const void* pcm_data, size_t pcm_size,
+                                              int32_t sample_rate, void** out_wav_data,
+                                              size_t* out_wav_size);
+
+/**
+ * @brief Convert Int16 PCM samples to WAV format
+ *
+ * Similar to rac_audio_float32_to_wav but for Int16 input samples.
+ *
+ * @param pcm_data Input Int16 PCM samples
+ * @param pcm_size Size of pcm_data in bytes (must be multiple of 2)
+ * @param sample_rate Sample rate in Hz
+ * @param out_wav_data Output: WAV file data (owned, must be freed with rac_free)
+ * @param out_wav_size Output: Size of WAV data in bytes
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_audio_int16_to_wav(const void* pcm_data, size_t pcm_size,
+                                            int32_t sample_rate, void** out_wav_data,
+                                            size_t* out_wav_size);
+
+/**
+ * @brief Get WAV header size in bytes
+ *
+ * @return WAV header size (always 44 bytes for standard PCM WAV)
+ */
+RAC_API size_t rac_audio_wav_header_size(void);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RAC_AUDIO_UTILS_H */

package/ios/Binaries/RACommons.xcframework/ios-arm64_x86_64-simulator/RACommons.framework/Headers/rac_auth_manager.h

@@ -0,0 +1,252 @@
+/**
+ * @file rac_auth_manager.h
+ * @brief Authentication state management
+ *
+ * Manages authentication state including tokens, expiry, and refresh logic.
+ * Platform SDKs provide HTTP transport and secure storage callbacks.
+ */
+
+#ifndef RAC_AUTH_MANAGER_H
+#define RAC_AUTH_MANAGER_H
+
+#include <stdbool.h>
+#include <stdint.h>
+
+#include <RACommons/rac_api_types.h>
+#include <RACommons/rac_environment.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// Auth State
+// =============================================================================
+
+/**
+ * @brief Authentication state structure
+ *
+ * Managed internally - use accessor functions.
+ */
+typedef struct {
+    char* access_token;
+    char* refresh_token;
+    char* device_id;
+    char* user_id;  // Can be NULL
+    char* organization_id;
+    int64_t token_expires_at;  // Unix timestamp (seconds)
+    bool is_authenticated;
+} rac_auth_state_t;
+
+// =============================================================================
+// Platform Callbacks
+// =============================================================================
+
+/**
+ * @brief Callback for secure storage operations
+ *
+ * Platform implements to store tokens in Keychain/KeyStore.
+ */
+typedef struct {
+    /**
+     * @brief Store string value securely
+     * @param key Storage key
+     * @param value Value to store
+     * @return 0 on success, -1 on error
+     */
+    int (*store)(const char* key, const char* value, void* context);
+
+    /**
+     * @brief Retrieve string value
+     * @param key Storage key
+     * @param out_value Output buffer (caller provides)
+     * @param buffer_size Size of output buffer
+     * @return Length of value, or -1 on error/not found
+     */
+    int (*retrieve)(const char* key, char* out_value, size_t buffer_size, void* context);
+
+    /**
+     * @brief Delete stored value
+     * @param key Storage key
+     * @return 0 on success, -1 on error
+     */
+    int (*delete_key)(const char* key, void* context);
+
+    /**
+     * @brief Context pointer passed to all callbacks
+     */
+    void* context;
+} rac_secure_storage_t;
+
+// =============================================================================
+// Keychain Keys (for platform implementations)
+// =============================================================================
+
+#define RAC_KEY_ACCESS_TOKEN "com.runanywhere.sdk.accessToken"
+#define RAC_KEY_REFRESH_TOKEN "com.runanywhere.sdk.refreshToken"
+#define RAC_KEY_DEVICE_ID "com.runanywhere.sdk.deviceId"
+#define RAC_KEY_USER_ID "com.runanywhere.sdk.userId"
+#define RAC_KEY_ORGANIZATION_ID "com.runanywhere.sdk.organizationId"
+
+// =============================================================================
+// Initialization
+// =============================================================================
+
+/**
+ * @brief Initialize auth manager
+ * @param storage Secure storage callbacks (can be NULL for in-memory only)
+ */
+void rac_auth_init(const rac_secure_storage_t* storage);
+
+/**
+ * @brief Reset auth manager state
+ */
+void rac_auth_reset(void);
+
+// =============================================================================
+// Token State
+// =============================================================================
+
+/**
+ * @brief Check if currently authenticated
+ * @return true if valid access token exists
+ */
+bool rac_auth_is_authenticated(void);
+
+/**
+ * @brief Check if token needs refresh
+ *
+ * Returns true if token expires within 60 seconds.
+ *
+ * @return true if token should be refreshed
+ */
+bool rac_auth_needs_refresh(void);
+
+/**
+ * @brief Get current access token
+ * @return Access token string, or NULL if not authenticated
+ */
+const char* rac_auth_get_access_token(void);
+
+/**
+ * @brief Get current device ID
+ * @return Device ID string, or NULL if not set
+ */
+const char* rac_auth_get_device_id(void);
+
+/**
+ * @brief Get current user ID
+ * @return User ID string, or NULL if not set
+ */
+const char* rac_auth_get_user_id(void);
+
+/**
+ * @brief Get current organization ID
+ * @return Organization ID string, or NULL if not set
+ */
+const char* rac_auth_get_organization_id(void);
+
+// =============================================================================
+// Request Building
+// =============================================================================
+
+/**
+ * @brief Build authentication request JSON
+ *
+ * Creates JSON payload for POST /api/v1/auth/sdk/authenticate
+ *
+ * @param config SDK configuration with credentials
+ * @return JSON string (caller must free), or NULL on error
+ */
+char* rac_auth_build_authenticate_request(const rac_sdk_config_t* config);
+
+/**
+ * @brief Build token refresh request JSON
+ *
+ * Creates JSON payload for POST /api/v1/auth/sdk/refresh
+ *
+ * @return JSON string (caller must free), or NULL if no refresh token
+ */
+char* rac_auth_build_refresh_request(void);
+
+// =============================================================================
+// Response Handling
+// =============================================================================
+
+/**
+ * @brief Parse and store authentication response
+ *
+ * Updates internal auth state and optionally persists to secure storage.
+ *
+ * @param json JSON response body
+ * @return 0 on success, -1 on parse error
+ */
+int rac_auth_handle_authenticate_response(const char* json);
+
+/**
+ * @brief Parse and store refresh response
+ *
+ * Updates internal auth state and optionally persists to secure storage.
+ *
+ * @param json JSON response body
+ * @return 0 on success, -1 on parse error
+ */
+int rac_auth_handle_refresh_response(const char* json);
+
+// =============================================================================
+// Token Management
+// =============================================================================
+
+/**
+ * @brief Get valid access token, triggering refresh if needed
+ *
+ * This is the main entry point for getting a token. If the current token
+ * is expired or about to expire, it will:
+ * 1. Build a refresh request
+ * 2. Return a pending state indicating refresh is needed
+ *
+ * Platform must then:
+ * 1. Execute the HTTP request
+ * 2. Call rac_auth_handle_refresh_response with result
+ * 3. Call this function again to get the new token
+ *
+ * @param out_token Output pointer for token string
+ * @param out_needs_refresh Set to true if refresh HTTP call is needed
+ * @return 0 on success (token valid), 1 if refresh needed, -1 on error
+ */
+int rac_auth_get_valid_token(const char** out_token, bool* out_needs_refresh);
+
+/**
+ * @brief Clear all authentication state
+ *
+ * Clears in-memory state and secure storage.
+ */
+void rac_auth_clear(void);
+
+// =============================================================================
+// Persistence
+// =============================================================================
+
+/**
+ * @brief Load tokens from secure storage
+ *
+ * Call during initialization to restore saved auth state.
+ *
+ * @return 0 on success (tokens loaded), -1 if not found or error
+ */
+int rac_auth_load_stored_tokens(void);
+
+/**
+ * @brief Save current tokens to secure storage
+ *
+ * Called automatically by response handlers, but can be called manually.
+ *
+ * @return 0 on success, -1 on error
+ */
+int rac_auth_save_tokens(void);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif  // RAC_AUTH_MANAGER_H