@runanywhere/core 0.16.11 → 0.17.1

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

@@ -1,252 +0,0 @@
-/**
- * @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 "rac/infrastructure/network/rac_api_types.h"
-#include "rac/infrastructure/network/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

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

@@ -1,85 +0,0 @@
-/**
- * @file rac_dev_config.h
- * @brief Development mode configuration API
- *
- * Provides access to development mode configuration values.
- * The actual values are defined in development_config.cpp which is git-ignored.
- *
- * This allows:
- * - Cross-platform sharing of dev config (iOS, Android, Flutter)
- * - Git-ignored secrets with template for developers
- * - Consistent development environment across SDKs
- *
- * Security Model:
- * - development_config.cpp is in .gitignore (not committed to main branch)
- * - Real values are ONLY in release tags (for SPM/Maven distribution)
- * - Used ONLY when SDK is in .development mode
- * - Backend validates build token via POST /api/v1/devices/register/dev
- */
-
-#ifndef RAC_DEV_CONFIG_H
-#define RAC_DEV_CONFIG_H
-
-#include <stdbool.h>
-
-#include "rac/core/rac_types.h"
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-// =============================================================================
-// Development Configuration API
-// =============================================================================
-
-/**
- * @brief Check if development config is available
- * @return true if development config is properly configured
- */
-RAC_API bool rac_dev_config_is_available(void);
-
-/**
- * @brief Get Supabase project URL for development mode
- * @return URL string (static, do not free)
- */
-RAC_API const char* rac_dev_config_get_supabase_url(void);
-
-/**
- * @brief Get Supabase anon key for development mode
- * @return API key string (static, do not free)
- */
-RAC_API const char* rac_dev_config_get_supabase_key(void);
-
-/**
- * @brief Get build token for development mode
- * @return Build token string (static, do not free)
- */
-RAC_API const char* rac_dev_config_get_build_token(void);
-
-/**
- * @brief Get Sentry DSN for crash reporting (optional)
- * @return Sentry DSN string, or NULL if not configured
- */
-RAC_API const char* rac_dev_config_get_sentry_dsn(void);
-
-// =============================================================================
-// Convenience Functions
-// =============================================================================
-
-/**
- * @brief Check if Supabase config is valid
- * @return true if URL and key are non-empty
- */
-RAC_API bool rac_dev_config_has_supabase(void);
-
-/**
- * @brief Check if build token is valid
- * @return true if build token is non-empty
- */
-RAC_API bool rac_dev_config_has_build_token(void);
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif  // RAC_DEV_CONFIG_H

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

@@ -1,102 +0,0 @@
-/**
- * @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

@@ -1,220 +0,0 @@
-/**
- * @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