@runanywhere/core 0.16.0

package/android/src/main/include/rac/infrastructure/storage/rac_storage_analyzer.h

@@ -0,0 +1,286 @@
+/**
+ * @file rac_storage_analyzer.h
+ * @brief Storage Analyzer - Centralized Storage Analysis Logic
+ *
+ * Business logic for storage analysis lives here in C++.
+ * Platform-specific file operations are provided via callbacks.
+ *
+ * Storage structure: `{base_dir}/RunAnywhere/Models/{framework}/{modelId}/`
+ */
+
+#ifndef RAC_STORAGE_ANALYZER_H
+#define RAC_STORAGE_ANALYZER_H
+
+#include <stddef.h>
+#include <stdint.h>
+
+#include "rac/core/rac_error.h"
+#include "rac/core/rac_types.h"
+#include "rac/infrastructure/model_management/rac_model_registry.h"
+#include "rac/infrastructure/model_management/rac_model_types.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// DATA STRUCTURES
+// =============================================================================
+
+/**
+ * @brief Storage metrics for a single model
+ */
+typedef struct {
+    /** Model ID */
+    const char* model_id;
+
+    /** Model name */
+    const char* model_name;
+
+    /** Inference framework */
+    rac_inference_framework_t framework;
+
+    /** Local path to model */
+    const char* local_path;
+
+    /** Actual size on disk in bytes */
+    int64_t size_on_disk;
+
+    /** Model format */
+    rac_model_format_t format;
+
+    /** Artifact type info */
+    rac_model_artifact_info_t artifact_info;
+} rac_model_storage_metrics_t;
+
+/**
+ * @brief Device storage information
+ */
+typedef struct {
+    /** Total device storage in bytes */
+    int64_t total_space;
+
+    /** Free space in bytes */
+    int64_t free_space;
+
+    /** Used space in bytes */
+    int64_t used_space;
+} rac_device_storage_t;
+
+/**
+ * @brief App storage information
+ */
+typedef struct {
+    /** Documents directory size in bytes */
+    int64_t documents_size;
+
+    /** Cache directory size in bytes */
+    int64_t cache_size;
+
+    /** App support directory size in bytes */
+    int64_t app_support_size;
+
+    /** Total app storage */
+    int64_t total_size;
+} rac_app_storage_t;
+
+/**
+ * @brief Storage availability result
+ */
+typedef struct {
+    /** Whether storage is available */
+    rac_bool_t is_available;
+
+    /** Required space in bytes */
+    int64_t required_space;
+
+    /** Available space in bytes */
+    int64_t available_space;
+
+    /** Whether there's a warning (low space) */
+    rac_bool_t has_warning;
+
+    /** Recommendation message (may be NULL) */
+    const char* recommendation;
+} rac_storage_availability_t;
+
+/**
+ * @brief Overall storage info
+ */
+typedef struct {
+    /** App storage */
+    rac_app_storage_t app_storage;
+
+    /** Device storage */
+    rac_device_storage_t device_storage;
+
+    /** Array of model storage metrics */
+    rac_model_storage_metrics_t* models;
+
+    /** Number of models */
+    size_t model_count;
+
+    /** Total size of all models */
+    int64_t total_models_size;
+} rac_storage_info_t;
+
+// =============================================================================
+// PLATFORM CALLBACKS - Swift/Kotlin implements these
+// =============================================================================
+
+/**
+ * @brief Callback to calculate directory size
+ * @param path Directory path
+ * @param user_data User context
+ * @return Size in bytes
+ */
+typedef int64_t (*rac_calculate_dir_size_fn)(const char* path, void* user_data);
+
+/**
+ * @brief Callback to get file size
+ * @param path File path
+ * @param user_data User context
+ * @return Size in bytes, or -1 if not found
+ */
+typedef int64_t (*rac_get_file_size_fn)(const char* path, void* user_data);
+
+/**
+ * @brief Callback to check if path exists
+ * @param path Path to check
+ * @param is_directory Output: true if directory
+ * @param user_data User context
+ * @return true if exists
+ */
+typedef rac_bool_t (*rac_path_exists_fn)(const char* path, rac_bool_t* is_directory,
+                                         void* user_data);
+
+/**
+ * @brief Callback to get available disk space
+ * @param user_data User context
+ * @return Available space in bytes
+ */
+typedef int64_t (*rac_get_available_space_fn)(void* user_data);
+
+/**
+ * @brief Callback to get total disk space
+ * @param user_data User context
+ * @return Total space in bytes
+ */
+typedef int64_t (*rac_get_total_space_fn)(void* user_data);
+
+/**
+ * @brief Platform callbacks for file operations
+ */
+typedef struct {
+    rac_calculate_dir_size_fn calculate_dir_size;
+    rac_get_file_size_fn get_file_size;
+    rac_path_exists_fn path_exists;
+    rac_get_available_space_fn get_available_space;
+    rac_get_total_space_fn get_total_space;
+    void* user_data;
+} rac_storage_callbacks_t;
+
+// =============================================================================
+// STORAGE ANALYZER API
+// =============================================================================
+
+/** Opaque handle to storage analyzer */
+typedef struct rac_storage_analyzer* rac_storage_analyzer_handle_t;
+
+/**
+ * @brief Create a storage analyzer with platform callbacks
+ *
+ * @param callbacks Platform-specific file operation callbacks
+ * @param out_handle Output: Created analyzer handle
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_storage_analyzer_create(const rac_storage_callbacks_t* callbacks,
+                                                 rac_storage_analyzer_handle_t* out_handle);
+
+/**
+ * @brief Destroy a storage analyzer
+ *
+ * @param handle Analyzer handle to destroy
+ */
+RAC_API void rac_storage_analyzer_destroy(rac_storage_analyzer_handle_t handle);
+
+/**
+ * @brief Analyze overall storage
+ *
+ * Business logic in C++:
+ * - Gets models from rac_model_registry
+ * - Calculates paths via rac_model_paths
+ * - Calls platform callbacks for sizes
+ * - Aggregates results
+ *
+ * @param handle Analyzer handle
+ * @param registry_handle Model registry handle
+ * @param out_info Output: Storage info (caller must call rac_storage_info_free)
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_storage_analyzer_analyze(rac_storage_analyzer_handle_t handle,
+                                                  rac_model_registry_handle_t registry_handle,
+                                                  rac_storage_info_t* out_info);
+
+/**
+ * @brief Get storage metrics for a specific model
+ *
+ * @param handle Analyzer handle
+ * @param registry_handle Model registry handle
+ * @param model_id Model identifier
+ * @param framework Inference framework
+ * @param out_metrics Output: Model metrics
+ * @return RAC_SUCCESS or RAC_ERROR_NOT_FOUND
+ */
+RAC_API rac_result_t rac_storage_analyzer_get_model_metrics(
+    rac_storage_analyzer_handle_t handle, rac_model_registry_handle_t registry_handle,
+    const char* model_id, rac_inference_framework_t framework,
+    rac_model_storage_metrics_t* out_metrics);
+
+/**
+ * @brief Check if storage is available for a download
+ *
+ * @param handle Analyzer handle
+ * @param model_size Size of model to download
+ * @param safety_margin Safety margin (e.g., 0.1 for 10% extra)
+ * @param out_availability Output: Availability result
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_storage_analyzer_check_available(
+    rac_storage_analyzer_handle_t handle, int64_t model_size, double safety_margin,
+    rac_storage_availability_t* out_availability);
+
+/**
+ * @brief Calculate size at a path (file or directory)
+ *
+ * @param handle Analyzer handle
+ * @param path Path to calculate size for
+ * @param out_size Output: Size in bytes
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_storage_analyzer_calculate_size(rac_storage_analyzer_handle_t handle,
+                                                         const char* path, int64_t* out_size);
+
+// =============================================================================
+// CLEANUP
+// =============================================================================
+
+/**
+ * @brief Free storage info returned by rac_storage_analyzer_analyze
+ *
+ * @param info Storage info to free
+ */
+RAC_API void rac_storage_info_free(rac_storage_info_t* info);
+
+/**
+ * @brief Free storage availability result
+ *
+ * @param availability Availability result to free
+ */
+RAC_API void rac_storage_availability_free(rac_storage_availability_t* availability);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RAC_STORAGE_ANALYZER_H */

package/android/src/main/include/rac/infrastructure/telemetry/rac_telemetry_manager.h

@@ -0,0 +1,206 @@
+/**
+ * @file rac_telemetry_manager.h
+ * @brief Telemetry manager - handles event queuing, batching, and serialization
+ *
+ * C++ handles all telemetry logic:
+ * - Convert analytics events to telemetry payloads
+ * - Queue and batch events
+ * - Group by modality for production
+ * - Serialize to JSON (environment-aware)
+ * - Callback to platform SDK for HTTP calls
+ *
+ * Platform SDKs only need to:
+ * - Provide device info
+ * - Make HTTP calls when callback is invoked
+ */
+
+#ifndef RAC_TELEMETRY_MANAGER_H
+#define RAC_TELEMETRY_MANAGER_H
+
+#include "rac/core/rac_analytics_events.h"
+#include "rac/core/rac_types.h"
+#include "rac/infrastructure/network/rac_environment.h"
+#include "rac/infrastructure/telemetry/rac_telemetry_types.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// TELEMETRY MANAGER
+// =============================================================================
+
+/**
+ * @brief Opaque telemetry manager handle
+ */
+typedef struct rac_telemetry_manager rac_telemetry_manager_t;
+
+/**
+ * @brief HTTP request callback from C++ to platform SDK
+ *
+ * C++ builds the JSON and determines the endpoint.
+ * Platform SDK just makes the HTTP call.
+ *
+ * @param user_data User data provided at registration
+ * @param endpoint The API endpoint path (e.g., "/api/v1/sdk/telemetry")
+ * @param json_body The JSON request body (null-terminated string)
+ * @param json_length Length of JSON body
+ * @param requires_auth Whether request needs authentication
+ */
+typedef void (*rac_telemetry_http_callback_t)(void* user_data, const char* endpoint,
+                                              const char* json_body, size_t json_length,
+                                              rac_bool_t requires_auth);
+
+/**
+ * @brief HTTP response callback from platform SDK to C++
+ *
+ * Platform SDK calls this after HTTP completes.
+ *
+ * @param manager The telemetry manager
+ * @param success Whether HTTP call succeeded
+ * @param response_json Response JSON (can be NULL on failure)
+ * @param error_message Error message if failed (can be NULL)
+ */
+RAC_API void rac_telemetry_manager_http_complete(rac_telemetry_manager_t* manager,
+                                                 rac_bool_t success, const char* response_json,
+                                                 const char* error_message);
+
+// =============================================================================
+// LIFECYCLE
+// =============================================================================
+
+/**
+ * @brief Create telemetry manager
+ *
+ * @param env SDK environment (determines endpoint and encoding)
+ * @param device_id Persistent device UUID (from Keychain)
+ * @param platform Platform string ("ios", "android", etc.)
+ * @param sdk_version SDK version string
+ * @return Manager handle or NULL on failure
+ */
+RAC_API rac_telemetry_manager_t* rac_telemetry_manager_create(rac_environment_t env,
+                                                              const char* device_id,
+                                                              const char* platform,
+                                                              const char* sdk_version);
+
+/**
+ * @brief Destroy telemetry manager
+ */
+RAC_API void rac_telemetry_manager_destroy(rac_telemetry_manager_t* manager);
+
+/**
+ * @brief Set device info for telemetry payloads
+ *
+ * Call this after creating the manager to set device details.
+ */
+RAC_API void rac_telemetry_manager_set_device_info(rac_telemetry_manager_t* manager,
+                                                   const char* device_model,
+                                                   const char* os_version);
+
+/**
+ * @brief Register HTTP callback
+ *
+ * Platform SDK must register this to receive HTTP requests.
+ */
+RAC_API void rac_telemetry_manager_set_http_callback(rac_telemetry_manager_t* manager,
+                                                     rac_telemetry_http_callback_t callback,
+                                                     void* user_data);
+
+// =============================================================================
+// EVENT TRACKING
+// =============================================================================
+
+/**
+ * @brief Track a telemetry payload directly
+ *
+ * Queues the payload for batching and sending.
+ */
+RAC_API rac_result_t rac_telemetry_manager_track(rac_telemetry_manager_t* manager,
+                                                 const rac_telemetry_payload_t* payload);
+
+/**
+ * @brief Track from analytics event data
+ *
+ * Converts analytics event to telemetry payload and queues it.
+ */
+RAC_API rac_result_t rac_telemetry_manager_track_analytics(rac_telemetry_manager_t* manager,
+                                                           rac_event_type_t event_type,
+                                                           const rac_analytics_event_data_t* data);
+
+/**
+ * @brief Flush queued events immediately
+ *
+ * Sends all queued events to the backend.
+ */
+RAC_API rac_result_t rac_telemetry_manager_flush(rac_telemetry_manager_t* manager);
+
+// =============================================================================
+// JSON SERIALIZATION
+// =============================================================================
+
+/**
+ * @brief Serialize telemetry payload to JSON
+ *
+ * @param payload The payload to serialize
+ * @param env Environment (affects field names and which fields to include)
+ * @param out_json Output: JSON string (caller must free with rac_free)
+ * @param out_length Output: Length of JSON string
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_telemetry_manager_payload_to_json(const rac_telemetry_payload_t* payload,
+                                                           rac_environment_t env, char** out_json,
+                                                           size_t* out_length);
+
+/**
+ * @brief Serialize batch request to JSON
+ *
+ * @param request The batch request
+ * @param env Environment
+ * @param out_json Output: JSON string (caller must free with rac_free)
+ * @param out_length Output: Length of JSON string
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t
+rac_telemetry_manager_batch_to_json(const rac_telemetry_batch_request_t* request,
+                                    rac_environment_t env, char** out_json, size_t* out_length);
+
+/**
+ * @brief Parse batch response from JSON
+ *
+ * @param json JSON response string
+ * @param out_response Output: Parsed response (caller must free)
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_telemetry_manager_parse_response(
+    const char* json, rac_telemetry_batch_response_t* out_response);
+
+// =============================================================================
+// DEVICE REGISTRATION
+// =============================================================================
+
+/**
+ * @brief Serialize device registration request to JSON
+ *
+ * @param request The registration request
+ * @param env Environment
+ * @param out_json Output: JSON string (caller must free with rac_free)
+ * @param out_length Output: Length of JSON string
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t
+rac_device_registration_to_json(const rac_device_registration_request_t* request,
+                                rac_environment_t env, char** out_json, size_t* out_length);
+
+/**
+ * @brief Get device registration endpoint for environment
+ *
+ * @param env Environment
+ * @return Endpoint path string (static, do not free)
+ */
+RAC_API const char* rac_device_registration_endpoint(rac_environment_t env);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif  // RAC_TELEMETRY_MANAGER_H