@runanywhere/core 0.16.0

package/ios/Binaries/RACommons.xcframework/ios-arm64/RACommons.framework/Headers/rac_events.h

@@ -0,0 +1,177 @@
+/**
+ * @file rac_events.h
+ * @brief RunAnywhere Commons - Event Publishing and Subscription
+ *
+ * C port of Swift's SDKEvent protocol and EventPublisher from:
+ * Sources/RunAnywhere/Infrastructure/Events/SDKEvent.swift
+ * Sources/RunAnywhere/Infrastructure/Events/EventPublisher.swift
+ *
+ * Events are categorized and can be routed to different destinations
+ * (public EventBus or analytics).
+ */
+
+#ifndef RAC_EVENTS_H
+#define RAC_EVENTS_H
+
+#include <RACommons/rac_types.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// EVENT DESTINATION - Mirrors Swift's EventDestination
+// =============================================================================
+
+/**
+ * Where an event should be routed.
+ * Mirrors Swift's EventDestination enum.
+ */
+typedef enum rac_event_destination {
+    /** Only to public EventBus (app developers) */
+    RAC_EVENT_DESTINATION_PUBLIC_ONLY = 0,
+    /** Only to analytics/telemetry (backend) */
+    RAC_EVENT_DESTINATION_ANALYTICS_ONLY = 1,
+    /** Both destinations (default) */
+    RAC_EVENT_DESTINATION_ALL = 2,
+} rac_event_destination_t;
+
+// =============================================================================
+// EVENT CATEGORY - Mirrors Swift's EventCategory
+// =============================================================================
+
+/**
+ * Event categories for filtering/grouping.
+ * Mirrors Swift's EventCategory enum.
+ */
+typedef enum rac_event_category {
+    RAC_EVENT_CATEGORY_SDK = 0,
+    RAC_EVENT_CATEGORY_MODEL = 1,
+    RAC_EVENT_CATEGORY_LLM = 2,
+    RAC_EVENT_CATEGORY_STT = 3,
+    RAC_EVENT_CATEGORY_TTS = 4,
+    RAC_EVENT_CATEGORY_VOICE = 5,
+    RAC_EVENT_CATEGORY_STORAGE = 6,
+    RAC_EVENT_CATEGORY_DEVICE = 7,
+    RAC_EVENT_CATEGORY_NETWORK = 8,
+    RAC_EVENT_CATEGORY_ERROR = 9,
+} rac_event_category_t;
+
+// =============================================================================
+// EVENT STRUCTURE - Mirrors Swift's SDKEvent protocol
+// =============================================================================
+
+/**
+ * Event data structure.
+ * Mirrors Swift's SDKEvent protocol properties.
+ */
+typedef struct rac_event {
+    /** Unique identifier for this event instance */
+    const char* id;
+
+    /** Event type string (used for analytics categorization) */
+    const char* type;
+
+    /** Category for filtering/routing */
+    rac_event_category_t category;
+
+    /** Timestamp in milliseconds since epoch */
+    int64_t timestamp_ms;
+
+    /** Optional session ID for grouping related events (can be NULL) */
+    const char* session_id;
+
+    /** Where to route this event */
+    rac_event_destination_t destination;
+
+    /** Event properties as JSON string (can be NULL) */
+    const char* properties_json;
+} rac_event_t;
+
+// =============================================================================
+// EVENT CALLBACK
+// =============================================================================
+
+/**
+ * Event callback function type.
+ *
+ * @param event The event data (valid only during the callback)
+ * @param user_data User-provided context data
+ */
+typedef void (*rac_event_callback_fn)(const rac_event_t* event, void* user_data);
+
+// =============================================================================
+// EVENT API
+// =============================================================================
+
+/**
+ * Subscribes to events of a specific category.
+ *
+ * @param category The category to subscribe to
+ * @param callback The callback function to invoke
+ * @param user_data User data passed to the callback
+ * @return Subscription ID (0 on failure), use with rac_event_unsubscribe
+ *
+ * @note The callback is invoked on the thread that publishes the event.
+ *       Keep callback execution fast to avoid blocking.
+ */
+RAC_API uint64_t rac_event_subscribe(rac_event_category_t category, rac_event_callback_fn callback,
+                                     void* user_data);
+
+/**
+ * Subscribes to all events regardless of category.
+ *
+ * @param callback The callback function to invoke
+ * @param user_data User data passed to the callback
+ * @return Subscription ID (0 on failure)
+ */
+RAC_API uint64_t rac_event_subscribe_all(rac_event_callback_fn callback, void* user_data);
+
+/**
+ * Unsubscribes from events.
+ *
+ * @param subscription_id The subscription ID returned from subscribe
+ */
+RAC_API void rac_event_unsubscribe(uint64_t subscription_id);
+
+/**
+ * Publishes an event to all subscribers.
+ *
+ * This is called by the commons library to publish events.
+ * Swift's EventBridge subscribes to receive and re-publish to Swift consumers.
+ *
+ * @param event The event to publish
+ * @return RAC_SUCCESS on success, or an error code on failure
+ */
+RAC_API rac_result_t rac_event_publish(const rac_event_t* event);
+
+/**
+ * Track an event (convenience function matching Swift's EventPublisher.track).
+ *
+ * @param type Event type string
+ * @param category Event category
+ * @param destination Where to route this event
+ * @param properties_json Event properties as JSON (can be NULL)
+ * @return RAC_SUCCESS on success, or an error code on failure
+ */
+RAC_API rac_result_t rac_event_track(const char* type, rac_event_category_t category,
+                                     rac_event_destination_t destination,
+                                     const char* properties_json);
+
+// =============================================================================
+// UTILITY FUNCTIONS
+// =============================================================================
+
+/**
+ * Gets a string name for an event category.
+ *
+ * @param category The event category
+ * @return A string name (never NULL)
+ */
+RAC_API const char* rac_event_category_name(rac_event_category_t category);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RAC_EVENTS_H */

package/ios/Binaries/RACommons.xcframework/ios-arm64/RACommons.framework/Headers/rac_http_client.h

@@ -0,0 +1,233 @@
+/**
+ * @file rac_http_client.h
+ * @brief HTTP client abstraction
+ *
+ * Defines a platform-agnostic HTTP interface. Platform SDKs implement
+ * the actual HTTP transport (URLSession, OkHttp, etc.) and register
+ * it via callback.
+ */
+
+#ifndef RAC_HTTP_CLIENT_H
+#define RAC_HTTP_CLIENT_H
+
+#include <stdbool.h>
+#include <stddef.h>
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// HTTP Types
+// =============================================================================
+
+/**
+ * @brief HTTP method enum
+ */
+typedef enum {
+    RAC_HTTP_GET = 0,
+    RAC_HTTP_POST = 1,
+    RAC_HTTP_PUT = 2,
+    RAC_HTTP_DELETE = 3,
+    RAC_HTTP_PATCH = 4
+} rac_http_method_t;
+
+/**
+ * @brief HTTP header key-value pair
+ */
+typedef struct {
+    const char* key;
+    const char* value;
+} rac_http_header_t;
+
+/**
+ * @brief HTTP request structure
+ */
+typedef struct {
+    rac_http_method_t method;
+    const char* url;   // Full URL
+    const char* body;  // JSON body (can be NULL for GET)
+    size_t body_length;
+    rac_http_header_t* headers;
+    size_t header_count;
+    int32_t timeout_ms;  // Request timeout in milliseconds
+} rac_http_request_t;
+
+/**
+ * @brief HTTP response structure
+ */
+typedef struct {
+    int32_t status_code;  // HTTP status code (200, 401, etc.)
+    char* body;           // Response body (caller frees)
+    size_t body_length;
+    rac_http_header_t* headers;
+    size_t header_count;
+    char* error_message;  // Non-HTTP error (network failure, etc.)
+} rac_http_response_t;
+
+// =============================================================================
+// Response Memory Management
+// =============================================================================
+
+/**
+ * @brief Free HTTP response
+ */
+void rac_http_response_free(rac_http_response_t* response);
+
+// =============================================================================
+// Platform Callback Interface
+// =============================================================================
+
+/**
+ * @brief Callback type for receiving HTTP response
+ *
+ * @param response The HTTP response (platform must free after callback returns)
+ * @param user_data Opaque user data passed to request
+ */
+typedef void (*rac_http_callback_t)(const rac_http_response_t* response, void* user_data);
+
+/**
+ * @brief HTTP executor function type
+ *
+ * Platform implements this to perform actual HTTP requests.
+ * Must call callback when request completes (success or failure).
+ *
+ * @param request The HTTP request to execute
+ * @param callback Callback to invoke with response
+ * @param user_data Opaque user data to pass to callback
+ */
+typedef void (*rac_http_executor_t)(const rac_http_request_t* request, rac_http_callback_t callback,
+                                    void* user_data);
+
+/**
+ * @brief Register platform HTTP executor
+ *
+ * Platform SDKs must call this during initialization to provide
+ * their HTTP implementation.
+ *
+ * @param executor The executor function
+ */
+void rac_http_set_executor(rac_http_executor_t executor);
+
+/**
+ * @brief Check if HTTP executor is registered
+ * @return true if executor has been set
+ */
+bool rac_http_has_executor(void);
+
+// =============================================================================
+// Request Building Helpers
+// =============================================================================
+
+/**
+ * @brief Create a new HTTP request
+ * @param method HTTP method
+ * @param url Full URL
+ * @return New request (caller must free with rac_http_request_free)
+ */
+rac_http_request_t* rac_http_request_create(rac_http_method_t method, const char* url);
+
+/**
+ * @brief Set request body
+ * @param request The request
+ * @param body JSON body string
+ */
+void rac_http_request_set_body(rac_http_request_t* request, const char* body);
+
+/**
+ * @brief Add header to request
+ * @param request The request
+ * @param key Header key
+ * @param value Header value
+ */
+void rac_http_request_add_header(rac_http_request_t* request, const char* key, const char* value);
+
+/**
+ * @brief Set request timeout
+ * @param request The request
+ * @param timeout_ms Timeout in milliseconds
+ */
+void rac_http_request_set_timeout(rac_http_request_t* request, int32_t timeout_ms);
+
+/**
+ * @brief Free HTTP request
+ */
+void rac_http_request_free(rac_http_request_t* request);
+
+// =============================================================================
+// Standard Headers
+// =============================================================================
+
+/**
+ * @brief Add standard SDK headers to request
+ *
+ * Adds: Content-Type, X-SDK-Client, X-SDK-Version, X-Platform
+ *
+ * @param request The request
+ * @param sdk_version SDK version string
+ * @param platform Platform string
+ */
+void rac_http_add_sdk_headers(rac_http_request_t* request, const char* sdk_version,
+                              const char* platform);
+
+/**
+ * @brief Add authorization header
+ * @param request The request
+ * @param token Bearer token
+ */
+void rac_http_add_auth_header(rac_http_request_t* request, const char* token);
+
+/**
+ * @brief Add API key header (for Supabase compatibility)
+ * @param request The request
+ * @param api_key API key
+ */
+void rac_http_add_api_key_header(rac_http_request_t* request, const char* api_key);
+
+// =============================================================================
+// High-Level Request Functions
+// =============================================================================
+
+/**
+ * @brief Context for async HTTP operations
+ */
+typedef struct {
+    void* user_data;
+    void (*on_success)(const char* response_body, void* user_data);
+    void (*on_error)(int status_code, const char* error_message, void* user_data);
+} rac_http_context_t;
+
+/**
+ * @brief Execute HTTP request asynchronously
+ *
+ * Uses the registered platform executor.
+ *
+ * @param request The request to execute
+ * @param context Callback context
+ */
+void rac_http_execute(const rac_http_request_t* request, rac_http_context_t* context);
+
+/**
+ * @brief Helper: POST JSON to endpoint
+ * @param url Full URL
+ * @param json_body JSON body
+ * @param auth_token Bearer token (can be NULL)
+ * @param context Callback context
+ */
+void rac_http_post_json(const char* url, const char* json_body, const char* auth_token,
+                        rac_http_context_t* context);
+
+/**
+ * @brief Helper: GET from endpoint
+ * @param url Full URL
+ * @param auth_token Bearer token (can be NULL)
+ * @param context Callback context
+ */
+void rac_http_get(const char* url, const char* auth_token, rac_http_context_t* context);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif  // RAC_HTTP_CLIENT_H

package/ios/Binaries/RACommons.xcframework/ios-arm64/RACommons.framework/Headers/rac_lifecycle.h

@@ -0,0 +1,290 @@
+/**
+ * @file rac_lifecycle.h
+ * @brief RunAnywhere Commons - Lifecycle Management API
+ *
+ * C port of Swift's ManagedLifecycle.swift from:
+ * Sources/RunAnywhere/Core/Capabilities/ManagedLifecycle.swift
+ *
+ * Provides unified lifecycle management with integrated event tracking.
+ * Tracks lifecycle events (load, unload) via EventPublisher.
+ */
+
+#ifndef RAC_LIFECYCLE_H
+#define RAC_LIFECYCLE_H
+
+#include <RACommons/rac_error.h>
+#include <RACommons/rac_types.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// TYPES - Mirrors Swift's CapabilityLoadingState
+// =============================================================================
+
+/**
+ * @brief Capability loading state
+ *
+ * Mirrors Swift's CapabilityLoadingState enum.
+ */
+typedef enum rac_lifecycle_state {
+    RAC_LIFECYCLE_STATE_IDLE = 0,    /**< Not loaded */
+    RAC_LIFECYCLE_STATE_LOADING = 1, /**< Currently loading */
+    RAC_LIFECYCLE_STATE_LOADED = 2,  /**< Successfully loaded */
+    RAC_LIFECYCLE_STATE_FAILED = 3   /**< Load failed */
+} rac_lifecycle_state_t;
+
+/**
+ * @brief Resource type for lifecycle tracking
+ *
+ * Mirrors Swift's CapabilityResourceType enum.
+ */
+typedef enum rac_resource_type {
+    RAC_RESOURCE_TYPE_LLM_MODEL = 0,
+    RAC_RESOURCE_TYPE_STT_MODEL = 1,
+    RAC_RESOURCE_TYPE_TTS_VOICE = 2,
+    RAC_RESOURCE_TYPE_VAD_MODEL = 3,
+    RAC_RESOURCE_TYPE_DIARIZATION_MODEL = 4
+} rac_resource_type_t;
+
+/**
+ * @brief Lifecycle metrics
+ *
+ * Mirrors Swift's ModelLifecycleMetrics struct.
+ */
+typedef struct rac_lifecycle_metrics {
+    /** Total lifecycle events */
+    int32_t total_events;
+
+    /** Start time (ms since epoch) */
+    int64_t start_time_ms;
+
+    /** Last event time (ms since epoch, 0 if none) */
+    int64_t last_event_time_ms;
+
+    /** Total load attempts */
+    int32_t total_loads;
+
+    /** Successful loads */
+    int32_t successful_loads;
+
+    /** Failed loads */
+    int32_t failed_loads;
+
+    /** Average load time in milliseconds */
+    double average_load_time_ms;
+
+    /** Total unloads */
+    int32_t total_unloads;
+} rac_lifecycle_metrics_t;
+
+/**
+ * @brief Lifecycle configuration
+ */
+typedef struct rac_lifecycle_config {
+    /** Resource type for event tracking */
+    rac_resource_type_t resource_type;
+
+    /** Logger category (can be NULL for default) */
+    const char* logger_category;
+
+    /** User data for callbacks */
+    void* user_data;
+} rac_lifecycle_config_t;
+
+/**
+ * @brief Service creation callback
+ *
+ * Called by the lifecycle manager to create a service for a given model ID.
+ *
+ * @param model_id The model ID to load
+ * @param user_data User-provided context
+ * @param out_service Output: Handle to the created service
+ * @return RAC_SUCCESS or error code
+ */
+typedef rac_result_t (*rac_lifecycle_create_service_fn)(const char* model_id, void* user_data,
+                                                        rac_handle_t* out_service);
+
+/**
+ * @brief Service destroy callback
+ *
+ * Called by the lifecycle manager to destroy a service.
+ *
+ * @param service Handle to the service to destroy
+ * @param user_data User-provided context
+ */
+typedef void (*rac_lifecycle_destroy_service_fn)(rac_handle_t service, void* user_data);
+
+// =============================================================================
+// LIFECYCLE API - Mirrors Swift's ManagedLifecycle
+// =============================================================================
+
+/**
+ * @brief Create a lifecycle manager
+ *
+ * @param config Lifecycle configuration
+ * @param create_fn Service creation callback
+ * @param destroy_fn Service destruction callback (can be NULL)
+ * @param out_handle Output: Handle to the lifecycle manager
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_lifecycle_create(const rac_lifecycle_config_t* config,
+                                          rac_lifecycle_create_service_fn create_fn,
+                                          rac_lifecycle_destroy_service_fn destroy_fn,
+                                          rac_handle_t* out_handle);
+
+/**
+ * @brief Load a model with automatic event tracking
+ *
+ * Mirrors Swift's ManagedLifecycle.load(_:)
+ * If already loaded with same ID, skips duplicate load.
+ *
+ * @param handle Lifecycle manager handle
+ * @param model_path File path to the model (used for loading) - REQUIRED
+ * @param model_id Model identifier for telemetry (e.g., "sherpa-onnx-whisper-tiny.en")
+ *                 Optional: if NULL, defaults to model_path
+ * @param model_name Human-readable model name (e.g., "Sherpa Whisper Tiny (ONNX)")
+ *                   Optional: if NULL, defaults to model_id
+ * @param out_service Output: Handle to the loaded service
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_lifecycle_load(rac_handle_t handle, const char* model_path,
+                                        const char* model_id, const char* model_name,
+                                        rac_handle_t* out_service);
+
+/**
+ * @brief Unload the currently loaded model
+ *
+ * Mirrors Swift's ManagedLifecycle.unload()
+ *
+ * @param handle Lifecycle manager handle
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_lifecycle_unload(rac_handle_t handle);
+
+/**
+ * @brief Reset all state
+ *
+ * Mirrors Swift's ManagedLifecycle.reset()
+ *
+ * @param handle Lifecycle manager handle
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_lifecycle_reset(rac_handle_t handle);
+
+/**
+ * @brief Get current lifecycle state
+ *
+ * Mirrors Swift's ManagedLifecycle.state
+ *
+ * @param handle Lifecycle manager handle
+ * @return Current state
+ */
+RAC_API rac_lifecycle_state_t rac_lifecycle_get_state(rac_handle_t handle);
+
+/**
+ * @brief Check if a model is loaded
+ *
+ * Mirrors Swift's ManagedLifecycle.isLoaded
+ *
+ * @param handle Lifecycle manager handle
+ * @return RAC_TRUE if loaded, RAC_FALSE otherwise
+ */
+RAC_API rac_bool_t rac_lifecycle_is_loaded(rac_handle_t handle);
+
+/**
+ * @brief Get current model ID
+ *
+ * Mirrors Swift's ManagedLifecycle.currentModelId
+ *
+ * @param handle Lifecycle manager handle
+ * @return Current model ID (may be NULL if not loaded)
+ */
+RAC_API const char* rac_lifecycle_get_model_id(rac_handle_t handle);
+
+/**
+ * @brief Get current model name (human-readable)
+ *
+ * @param handle Lifecycle manager handle
+ * @return Current model name (may be NULL if not loaded)
+ */
+RAC_API const char* rac_lifecycle_get_model_name(rac_handle_t handle);
+
+/**
+ * @brief Get current service handle
+ *
+ * Mirrors Swift's ManagedLifecycle.currentService
+ *
+ * @param handle Lifecycle manager handle
+ * @return Current service handle (may be NULL if not loaded)
+ */
+RAC_API rac_handle_t rac_lifecycle_get_service(rac_handle_t handle);
+
+/**
+ * @brief Require service or return error
+ *
+ * Mirrors Swift's ManagedLifecycle.requireService()
+ *
+ * @param handle Lifecycle manager handle
+ * @param out_service Output: Service handle
+ * @return RAC_SUCCESS or RAC_ERROR_NOT_INITIALIZED if not loaded
+ */
+RAC_API rac_result_t rac_lifecycle_require_service(rac_handle_t handle, rac_handle_t* out_service);
+
+/**
+ * @brief Track an operation error
+ *
+ * Mirrors Swift's ManagedLifecycle.trackOperationError(_:operation:)
+ *
+ * @param handle Lifecycle manager handle
+ * @param error_code Error code
+ * @param operation Operation name
+ */
+RAC_API void rac_lifecycle_track_error(rac_handle_t handle, rac_result_t error_code,
+                                       const char* operation);
+
+/**
+ * @brief Get lifecycle metrics
+ *
+ * Mirrors Swift's ManagedLifecycle.getLifecycleMetrics()
+ *
+ * @param handle Lifecycle manager handle
+ * @param out_metrics Output: Lifecycle metrics
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_lifecycle_get_metrics(rac_handle_t handle,
+                                               rac_lifecycle_metrics_t* out_metrics);
+
+/**
+ * @brief Destroy a lifecycle manager
+ *
+ * @param handle Lifecycle manager handle
+ */
+RAC_API void rac_lifecycle_destroy(rac_handle_t handle);
+
+// =============================================================================
+// CONVENIENCE STATE HELPERS
+// =============================================================================
+
+/**
+ * @brief Get state name string
+ *
+ * @param state Lifecycle state
+ * @return Human-readable state name
+ */
+RAC_API const char* rac_lifecycle_state_name(rac_lifecycle_state_t state);
+
+/**
+ * @brief Get resource type name string
+ *
+ * @param type Resource type
+ * @return Human-readable resource type name
+ */
+RAC_API const char* rac_resource_type_name(rac_resource_type_t type);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RAC_LIFECYCLE_H */