@runanywhere/core 0.16.0

package/android/src/main/include/rac/infrastructure/network/rac_endpoints.h

@@ -0,0 +1,102 @@
+/**
+ * @file rac_endpoints.h
+ * @brief API endpoint definitions
+ *
+ * Defines all API endpoint paths as constants.
+ * This is the canonical source of truth - platform SDKs should not duplicate these.
+ */
+
+#ifndef RAC_ENDPOINTS_H
+#define RAC_ENDPOINTS_H
+
+#include "rac/infrastructure/network/rac_environment.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// Authentication & Health Endpoints
+// =============================================================================
+
+#define RAC_ENDPOINT_AUTHENTICATE "/api/v1/auth/sdk/authenticate"
+#define RAC_ENDPOINT_REFRESH "/api/v1/auth/sdk/refresh"
+#define RAC_ENDPOINT_HEALTH "/v1/health"
+
+// =============================================================================
+// Device Management - Production/Staging
+// =============================================================================
+
+#define RAC_ENDPOINT_DEVICE_REGISTER "/api/v1/devices/register"
+#define RAC_ENDPOINT_TELEMETRY "/api/v1/sdk/telemetry"
+
+// =============================================================================
+// Device Management - Development (Supabase REST API)
+// =============================================================================
+
+#define RAC_ENDPOINT_DEV_DEVICE_REGISTER "/rest/v1/sdk_devices"
+#define RAC_ENDPOINT_DEV_TELEMETRY "/rest/v1/telemetry_events"
+
+// =============================================================================
+// Model Management
+// =============================================================================
+
+#define RAC_ENDPOINT_MODELS_AVAILABLE "/api/v1/models/available"
+
+// =============================================================================
+// Environment-Based Endpoint Selection
+// =============================================================================
+
+/**
+ * @brief Get device registration endpoint for environment
+ * @param env The environment
+ * @return Endpoint path string
+ */
+const char* rac_endpoint_device_registration(rac_environment_t env);
+
+/**
+ * @brief Get telemetry endpoint for environment
+ * @param env The environment
+ * @return Endpoint path string
+ */
+const char* rac_endpoint_telemetry(rac_environment_t env);
+
+/**
+ * @brief Build model assignments endpoint with query params
+ * @param device_type Device type (e.g., "iphone", "android_phone")
+ * @param platform Platform (e.g., "ios", "android")
+ * @param out_buffer Buffer to write endpoint path
+ * @param buffer_size Size of buffer
+ * @return Length of written string, or -1 on error
+ */
+int rac_endpoint_model_assignments(const char* device_type, const char* platform, char* out_buffer,
+                                   size_t buffer_size);
+
+/**
+ * @brief Build model download endpoint
+ * @param model_id The model ID
+ * @param out_buffer Buffer to write endpoint path
+ * @param buffer_size Size of buffer
+ * @return Length of written string, or -1 on error
+ */
+int rac_endpoint_model_download(const char* model_id, char* out_buffer, size_t buffer_size);
+
+// =============================================================================
+// Full URL Building
+// =============================================================================
+
+/**
+ * @brief Build full URL from base URL and endpoint
+ * @param base_url The base URL (e.g., "https://api.runanywhere.ai")
+ * @param endpoint The endpoint path (e.g., "/api/v1/health")
+ * @param out_buffer Buffer to write full URL
+ * @param buffer_size Size of buffer
+ * @return Length of written string, or -1 on error
+ */
+int rac_build_url(const char* base_url, const char* endpoint, char* out_buffer, size_t buffer_size);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif  // RAC_ENDPOINTS_H

package/android/src/main/include/rac/infrastructure/network/rac_environment.h

@@ -0,0 +1,220 @@
+/**
+ * @file rac_environment.h
+ * @brief SDK environment configuration
+ *
+ * Defines environment types (development, staging, production) and their
+ * associated settings like authentication requirements, log levels, etc.
+ * This is the canonical source of truth - platform SDKs create thin wrappers.
+ */
+
+#ifndef RAC_ENVIRONMENT_H
+#define RAC_ENVIRONMENT_H
+
+#include <stdbool.h>
+#include <stdint.h>
+
+#include "rac/core/rac_types.h"  // For rac_log_level_t
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// Environment Types
+// =============================================================================
+
+/**
+ * @brief SDK environment mode
+ *
+ * - DEVELOPMENT: Local/testing mode, no auth required, uses Supabase
+ * - STAGING: Testing with real services, requires API key + URL
+ * - PRODUCTION: Live environment, requires API key + HTTPS URL
+ */
+typedef enum {
+    RAC_ENV_DEVELOPMENT = 0,
+    RAC_ENV_STAGING = 1,
+    RAC_ENV_PRODUCTION = 2
+} rac_environment_t;
+
+// Note: rac_log_level_t is defined in rac_types.h
+// We use the existing definition for consistency
+
+// =============================================================================
+// SDK Configuration
+// =============================================================================
+
+/**
+ * @brief SDK initialization configuration
+ *
+ * Contains all parameters needed to initialize the SDK.
+ * Platform SDKs populate this from their native config types.
+ */
+typedef struct {
+    rac_environment_t environment;
+    const char* api_key;      // Required for staging/production
+    const char* base_url;     // Required for staging/production
+    const char* device_id;    // Set by platform (Keychain UUID, etc.)
+    const char* platform;     // "ios", "android", "flutter", etc.
+    const char* sdk_version;  // SDK version string
+} rac_sdk_config_t;
+
+/**
+ * @brief Development network configuration
+ *
+ * Contains Supabase credentials for development mode.
+ * These are built into the SDK binary.
+ */
+typedef struct {
+    const char* base_url;     // Supabase project URL
+    const char* api_key;      // Supabase anon key
+    const char* build_token;  // SDK build token for validation
+} rac_dev_config_t;
+
+// =============================================================================
+// Environment Query Functions
+// =============================================================================
+
+/**
+ * @brief Check if environment requires API authentication
+ * @param env The environment to check
+ * @return true for staging/production, false for development
+ */
+bool rac_env_requires_auth(rac_environment_t env);
+
+/**
+ * @brief Check if environment requires a backend URL
+ * @param env The environment to check
+ * @return true for staging/production, false for development
+ */
+bool rac_env_requires_backend_url(rac_environment_t env);
+
+/**
+ * @brief Check if environment is production
+ * @param env The environment to check
+ * @return true only for production
+ */
+bool rac_env_is_production(rac_environment_t env);
+
+/**
+ * @brief Check if environment is a testing environment
+ * @param env The environment to check
+ * @return true for development and staging
+ */
+bool rac_env_is_testing(rac_environment_t env);
+
+/**
+ * @brief Get the default log level for an environment
+ * @param env The environment
+ * @return DEBUG for development, INFO for staging, WARNING for production
+ */
+rac_log_level_t rac_env_default_log_level(rac_environment_t env);
+
+/**
+ * @brief Check if telemetry should be sent for this environment
+ * @param env The environment
+ * @return true only for production
+ */
+bool rac_env_should_send_telemetry(rac_environment_t env);
+
+/**
+ * @brief Check if environment should sync with backend
+ * @param env The environment
+ * @return true for staging/production, false for development
+ */
+bool rac_env_should_sync_with_backend(rac_environment_t env);
+
+/**
+ * @brief Get human-readable environment description
+ * @param env The environment
+ * @return String like "Development Environment"
+ */
+const char* rac_env_description(rac_environment_t env);
+
+// =============================================================================
+// Validation Functions
+// =============================================================================
+
+/**
+ * @brief Validation result codes
+ */
+typedef enum {
+    RAC_VALIDATION_OK = 0,
+    RAC_VALIDATION_API_KEY_REQUIRED,
+    RAC_VALIDATION_API_KEY_TOO_SHORT,
+    RAC_VALIDATION_URL_REQUIRED,
+    RAC_VALIDATION_URL_INVALID_SCHEME,
+    RAC_VALIDATION_URL_HTTPS_REQUIRED,
+    RAC_VALIDATION_URL_INVALID_HOST,
+    RAC_VALIDATION_URL_LOCALHOST_NOT_ALLOWED,
+    RAC_VALIDATION_PRODUCTION_DEBUG_BUILD
+} rac_validation_result_t;
+
+/**
+ * @brief Validate API key for the given environment
+ * @param api_key The API key to validate (can be NULL)
+ * @param env The target environment
+ * @return RAC_VALIDATION_OK if valid, error code otherwise
+ */
+rac_validation_result_t rac_validate_api_key(const char* api_key, rac_environment_t env);
+
+/**
+ * @brief Validate base URL for the given environment
+ * @param url The URL to validate (can be NULL)
+ * @param env The target environment
+ * @return RAC_VALIDATION_OK if valid, error code otherwise
+ */
+rac_validation_result_t rac_validate_base_url(const char* url, rac_environment_t env);
+
+/**
+ * @brief Validate complete SDK configuration
+ * @param config The configuration to validate
+ * @return RAC_VALIDATION_OK if valid, first error code otherwise
+ */
+rac_validation_result_t rac_validate_config(const rac_sdk_config_t* config);
+
+/**
+ * @brief Get error message for validation result
+ * @param result The validation result code
+ * @return Human-readable error message
+ */
+const char* rac_validation_error_message(rac_validation_result_t result);
+
+// =============================================================================
+// Global SDK State
+// =============================================================================
+
+/**
+ * @brief Initialize SDK with configuration
+ * @param config The SDK configuration
+ * @return RAC_VALIDATION_OK on success, error code on validation failure
+ */
+RAC_API rac_validation_result_t rac_sdk_init(const rac_sdk_config_t* config);
+
+/**
+ * @brief Get current SDK configuration
+ * @return Pointer to current config, or NULL if not initialized
+ */
+RAC_API const rac_sdk_config_t* rac_sdk_get_config(void);
+
+/**
+ * @brief Get current environment
+ * @return Current environment, or RAC_ENV_DEVELOPMENT if not initialized
+ */
+RAC_API rac_environment_t rac_sdk_get_environment(void);
+
+/**
+ * @brief Check if SDK is initialized
+ * @return true if rac_sdk_init has been called successfully
+ */
+RAC_API bool rac_sdk_is_initialized(void);
+
+/**
+ * @brief Reset SDK state (for testing)
+ */
+RAC_API void rac_sdk_reset(void);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif  // RAC_ENVIRONMENT_H

package/android/src/main/include/rac/infrastructure/network/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