@runanywhere/web-llamacpp 0.1.0-beta.10

package/dist/Foundation/PlatformAdapter.js

@@ -0,0 +1,417 @@
+/**
+ * RunAnywhere Web SDK - Platform Adapter
+ *
+ * Implements rac_platform_adapter_t callbacks using browser Web APIs.
+ * This is the web equivalent of:
+ *   - SwiftPlatformAdapter (iOS)
+ *   - KotlinPlatformAdapter (Android/JVM)
+ *   - DartPlatformAdapter (Flutter)
+ *
+ * Each callback is registered as a C function pointer via Emscripten's
+ * Module.addFunction(), then written into the rac_platform_adapter_t
+ * struct in WASM memory.
+ */
+import { LlamaCppBridge } from './LlamaCppBridge';
+import { SDKLogger } from '@runanywhere/web';
+const logger = new SDKLogger('PlatformAdapter');
+/**
+ * PlatformAdapter - Bridges browser Web APIs to RACommons C callbacks.
+ *
+ * The rac_platform_adapter_t struct is a collection of C function pointers.
+ * JavaScript provides implementations via Emscripten's addFunction(),
+ * which creates callable C function pointers from JS closures.
+ */
+export class PlatformAdapter {
+    callbacks = null;
+    adapterPtr = 0;
+    /**
+     * Create and register the platform adapter with RACommons.
+     * Must be called after WASM module is loaded but before rac_init().
+     */
+    register() {
+        const bridge = LlamaCppBridge.shared;
+        const m = bridge.module;
+        logger.info('Registering platform adapter callbacks...');
+        // Allocate the rac_platform_adapter_t struct
+        const adapterSize = m._rac_wasm_sizeof_platform_adapter();
+        this.adapterPtr = m._malloc(adapterSize);
+        // Zero-initialize
+        for (let i = 0; i < adapterSize; i++) {
+            m.setValue(this.adapterPtr + i, 0, 'i8');
+        }
+        // Register each callback as a C function pointer
+        this.callbacks = {
+            fileExists: this.registerFileExists(m),
+            fileRead: this.registerFileRead(m),
+            fileWrite: this.registerFileWrite(m),
+            fileDelete: this.registerFileDelete(m),
+            secureGet: this.registerSecureGet(m),
+            secureSet: this.registerSecureSet(m),
+            secureDelete: this.registerSecureDelete(m),
+            log: this.registerLog(m),
+            nowMs: this.registerNowMs(m),
+            getMemoryInfo: this.registerGetMemoryInfo(m),
+            httpDownload: this.registerHttpDownload(m),
+            extractArchive: this.registerExtractArchive(m),
+        };
+        // Write function pointers into the struct.
+        // The struct layout matches rac_platform_adapter.h field order.
+        // Each field is a function pointer (4 bytes on wasm32).
+        const PTR_SIZE = 4;
+        let offset = 0;
+        m.setValue(this.adapterPtr + offset, this.callbacks.fileExists, '*');
+        offset += PTR_SIZE;
+        m.setValue(this.adapterPtr + offset, this.callbacks.fileRead, '*');
+        offset += PTR_SIZE;
+        m.setValue(this.adapterPtr + offset, this.callbacks.fileWrite, '*');
+        offset += PTR_SIZE;
+        m.setValue(this.adapterPtr + offset, this.callbacks.fileDelete, '*');
+        offset += PTR_SIZE;
+        m.setValue(this.adapterPtr + offset, this.callbacks.secureGet, '*');
+        offset += PTR_SIZE;
+        m.setValue(this.adapterPtr + offset, this.callbacks.secureSet, '*');
+        offset += PTR_SIZE;
+        m.setValue(this.adapterPtr + offset, this.callbacks.secureDelete, '*');
+        offset += PTR_SIZE;
+        m.setValue(this.adapterPtr + offset, this.callbacks.log, '*');
+        offset += PTR_SIZE;
+        // track_error: optional, set to 0 (null)
+        m.setValue(this.adapterPtr + offset, 0, '*');
+        offset += PTR_SIZE;
+        m.setValue(this.adapterPtr + offset, this.callbacks.nowMs, '*');
+        offset += PTR_SIZE;
+        m.setValue(this.adapterPtr + offset, this.callbacks.getMemoryInfo, '*');
+        offset += PTR_SIZE;
+        m.setValue(this.adapterPtr + offset, this.callbacks.httpDownload, '*');
+        offset += PTR_SIZE;
+        // http_download_cancel: optional, set to 0 (null)
+        m.setValue(this.adapterPtr + offset, 0, '*');
+        offset += PTR_SIZE;
+        m.setValue(this.adapterPtr + offset, this.callbacks.extractArchive, '*');
+        offset += PTR_SIZE;
+        // user_data: set to 0 (null)
+        m.setValue(this.adapterPtr + offset, 0, '*');
+        // Register with RACommons
+        const result = m._rac_set_platform_adapter(this.adapterPtr);
+        if (result !== 0) {
+            logger.error(`Failed to set platform adapter: ${result}`);
+            this.cleanup();
+            return;
+        }
+        logger.info('Platform adapter registered successfully');
+    }
+    /**
+     * Get the WASM pointer to the adapter struct.
+     * Used by RunAnywhere.initialize() to populate rac_config_t.
+     */
+    getAdapterPtr() {
+        return this.adapterPtr;
+    }
+    /**
+     * Clean up allocated callbacks and memory.
+     */
+    cleanup() {
+        const m = LlamaCppBridge.shared.module;
+        if (this.callbacks) {
+            for (const ptr of Object.values(this.callbacks)) {
+                if (ptr !== 0) {
+                    try {
+                        m.removeFunction(ptr);
+                    }
+                    catch { /* ignore */ }
+                }
+            }
+            this.callbacks = null;
+        }
+        if (this.adapterPtr !== 0) {
+            m._free(this.adapterPtr);
+            this.adapterPtr = 0;
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Callback Implementations
+    // -----------------------------------------------------------------------
+    /** file_exists: rac_bool_t (*)(const char* path, void* user_data) */
+    registerFileExists(m) {
+        return m.addFunction((pathPtr, _userData) => {
+            try {
+                const path = m.UTF8ToString(pathPtr);
+                const result = m.FS.analyzePath(path);
+                return result.exists ? 1 : 0;
+            }
+            catch {
+                return 0;
+            }
+        }, 'iii');
+    }
+    /** file_read: rac_result_t (*)(const char* path, void** out_data, size_t* out_size, void* user_data) */
+    registerFileRead(m) {
+        return m.addFunction((pathPtr, outDataPtr, outSizePtr, _userData) => {
+            try {
+                const path = m.UTF8ToString(pathPtr);
+                const data = m.FS.readFile(path);
+                const wasmPtr = m._malloc(data.length);
+                LlamaCppBridge.shared.writeBytes(data, wasmPtr);
+                m.setValue(outDataPtr, wasmPtr, '*');
+                m.setValue(outSizePtr, data.length, 'i32');
+                return 0; // RAC_OK
+            }
+            catch {
+                return -182; // RAC_ERROR_FILE_NOT_FOUND
+            }
+        }, 'iiiii');
+    }
+    /** file_write: rac_result_t (*)(const char* path, const void* data, size_t size, void* user_data) */
+    registerFileWrite(m) {
+        return m.addFunction((pathPtr, dataPtr, size, _userData) => {
+            try {
+                const path = m.UTF8ToString(pathPtr);
+                const data = LlamaCppBridge.shared.readBytes(dataPtr, size);
+                m.FS.writeFile(path, data);
+                return 0;
+            }
+            catch {
+                return -183; // RAC_ERROR_FILE_WRITE_FAILED
+            }
+        }, 'iiiii');
+    }
+    /** file_delete: rac_result_t (*)(const char* path, void* user_data) */
+    registerFileDelete(m) {
+        return m.addFunction((pathPtr, _userData) => {
+            try {
+                const path = m.UTF8ToString(pathPtr);
+                m.FS.unlink(path);
+                return 0;
+            }
+            catch {
+                return -182;
+            }
+        }, 'iii');
+    }
+    /**
+     * secure_get: rac_result_t (*)(const char* key, char** out_value, void* user_data)
+     *
+     * SECURITY NOTE: On web, "secure" storage uses localStorage which is NOT
+     * truly secure. Data is accessible to any script running on the same origin
+     * (including XSS attacks). Do NOT store sensitive secrets (API keys, tokens,
+     * PII) here. On native platforms (iOS/Android) the equivalent callback uses
+     * Keychain / KeyStore which are hardware-backed and encrypted.
+     *
+     * For the web platform this is intentionally best-effort: the RACommons C
+     * layer only uses it for non-sensitive SDK state (e.g. cached environment).
+     */
+    registerSecureGet(m) {
+        return m.addFunction((keyPtr, outValuePtr, _userData) => {
+            try {
+                const key = m.UTF8ToString(keyPtr);
+                const value = localStorage.getItem(`rac_sdk_${key}`);
+                if (value === null) {
+                    m.setValue(outValuePtr, 0, '*');
+                    return -182;
+                }
+                const strPtr = LlamaCppBridge.shared.allocString(value);
+                m.setValue(outValuePtr, strPtr, '*');
+                return 0;
+            }
+            catch {
+                return -180;
+            }
+        }, 'iiii');
+    }
+    /**
+     * secure_set: rac_result_t (*)(const char* key, const char* value, void* user_data)
+     *
+     * SECURITY NOTE: See registerSecureGet — localStorage is NOT secure on web.
+     * Do not use for sensitive data.
+     */
+    registerSecureSet(m) {
+        return m.addFunction((keyPtr, valuePtr, _userData) => {
+            try {
+                const key = m.UTF8ToString(keyPtr);
+                const value = m.UTF8ToString(valuePtr);
+                localStorage.setItem(`rac_sdk_${key}`, value);
+                return 0;
+            }
+            catch {
+                return -180;
+            }
+        }, 'iiii');
+    }
+    /**
+     * secure_delete: rac_result_t (*)(const char* key, void* user_data)
+     *
+     * SECURITY NOTE: See registerSecureGet — localStorage is NOT secure on web.
+     */
+    registerSecureDelete(m) {
+        return m.addFunction((keyPtr, _userData) => {
+            try {
+                const key = m.UTF8ToString(keyPtr);
+                localStorage.removeItem(`rac_sdk_${key}`);
+                return 0;
+            }
+            catch {
+                return -180;
+            }
+        }, 'iii');
+    }
+    /** log: void (*)(rac_log_level_t level, const char* category, const char* message, void* user_data) */
+    registerLog(m) {
+        return m.addFunction((level, categoryPtr, messagePtr, _userData) => {
+            const category = m.UTF8ToString(categoryPtr);
+            const message = m.UTF8ToString(messagePtr);
+            const prefix = `[RAC:${category}]`;
+            switch (level) {
+                case 0: // TRACE
+                case 1: // DEBUG
+                    console.debug(prefix, message);
+                    break;
+                case 2: // INFO
+                    console.info(prefix, message);
+                    break;
+                case 3: // WARNING
+                    console.warn(prefix, message);
+                    break;
+                case 4: // ERROR
+                case 5: // FATAL
+                    console.error(prefix, message);
+                    break;
+                default:
+                    console.log(prefix, message);
+            }
+        }, 'viiii');
+    }
+    /** now_ms: int64_t (*)(void* user_data) */
+    registerNowMs(m) {
+        // Note: Emscripten represents int64_t as two i32 values (lo, hi) in some cases.
+        // For simplicity, we use 'ii' return (returns i32 which truncates but is fine for ms).
+        return m.addFunction((_userData) => {
+            return Date.now();
+        }, 'ii');
+    }
+    /** get_memory_info: rac_result_t (*)(rac_memory_info_t* out_info, void* user_data) */
+    registerGetMemoryInfo(m) {
+        return m.addFunction((outInfoPtr, _userData) => {
+            try {
+                // rac_memory_info_t: { uint64_t total, available, used }
+                // Estimate browser memory
+                const nav = navigator;
+                const totalMB = nav.deviceMemory ?? 4; // deviceMemory API (GB)
+                const totalBytes = totalMB * 1024 * 1024 * 1024;
+                // performance.memory is Chrome-only (non-standard)
+                const perf = performance;
+                const jsHeapUsed = perf.memory?.usedJSHeapSize ?? 0;
+                const jsHeapTotal = perf.memory?.jsHeapSizeLimit ?? totalBytes;
+                // Write as uint64 (two i32 values each for wasm32)
+                // Simplified: write lower 32 bits only
+                m.setValue(outInfoPtr, jsHeapTotal & 0xFFFFFFFF, 'i32'); // total low
+                m.setValue(outInfoPtr + 4, 0, 'i32'); // total high
+                m.setValue(outInfoPtr + 8, (jsHeapTotal - jsHeapUsed) & 0xFFFFFFFF, 'i32'); // available low
+                m.setValue(outInfoPtr + 12, 0, 'i32'); // available high
+                m.setValue(outInfoPtr + 16, jsHeapUsed & 0xFFFFFFFF, 'i32'); // used low
+                m.setValue(outInfoPtr + 20, 0, 'i32'); // used high
+                return 0;
+            }
+            catch {
+                return -180;
+            }
+        }, 'iii');
+    }
+    /**
+     * http_download: rac_result_t (*)(const char* url, const char* dest_path,
+     *   progress_cb, complete_cb, void* cb_user_data, char** out_task_id, void* user_data)
+     * Note: 7 params in C
+     */
+    registerHttpDownload(m) {
+        return m.addFunction((urlPtr, destPathPtr, progressCbPtr, completeCbPtr, cbUserData, outTaskIdPtr, _userData) => {
+            const url = m.UTF8ToString(urlPtr);
+            const destPath = m.UTF8ToString(destPathPtr);
+            // Generate task ID string
+            const taskId = `dl_${Date.now()}`;
+            if (outTaskIdPtr !== 0) {
+                const strPtr = LlamaCppBridge.shared.allocString(taskId);
+                m.setValue(outTaskIdPtr, strPtr, '*');
+            }
+            // Async download via fetch
+            this.performDownload(m, url, destPath, progressCbPtr, completeCbPtr, cbUserData)
+                .catch((err) => {
+                logger.error(`Download failed: ${err}`);
+            });
+            return 0;
+        }, 'iiiiiiii');
+    }
+    /**
+     * extract_archive: rac_result_t (*)(const char* archive_path, const char* dest_dir,
+     *   progress_cb, void* cb_user_data, void* user_data)
+     * Note: 5 params in C
+     */
+    registerExtractArchive(m) {
+        return m.addFunction((_archivePtr, _destPtr, _progressCb, _cbUserData, _userData) => {
+            // Archive extraction not yet implemented for WASM
+            logger.warning('Archive extraction not yet implemented for WASM');
+            return -180;
+        }, 'iiiiii');
+    }
+    // -----------------------------------------------------------------------
+    // Helpers
+    // -----------------------------------------------------------------------
+    /**
+     * Perform an HTTP download using fetch() and stream to Emscripten FS.
+     */
+    async performDownload(m, url, destPath, progressCbPtr, completeCbPtr, cbUserData) {
+        try {
+            const response = await fetch(url);
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            const contentLength = parseInt(response.headers.get('content-length') ?? '0', 10);
+            const reader = response.body?.getReader();
+            if (!reader) {
+                throw new Error('ReadableStream not supported');
+            }
+            const chunks = [];
+            let downloaded = 0;
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                chunks.push(value);
+                downloaded += value.length;
+                // Report progress via C callback
+                if (progressCbPtr !== 0) {
+                    m.dynCall('viii', progressCbPtr, [downloaded, contentLength, cbUserData]);
+                }
+            }
+            // Combine chunks and write to Emscripten FS
+            const totalData = new Uint8Array(downloaded);
+            let offset = 0;
+            for (const chunk of chunks) {
+                totalData.set(chunk, offset);
+                offset += chunk.length;
+            }
+            // Ensure parent directory exists
+            const parentDir = destPath.substring(0, destPath.lastIndexOf('/'));
+            if (parentDir) {
+                try {
+                    m.FS.mkdir(parentDir);
+                }
+                catch { /* exists */ }
+            }
+            m.FS.writeFile(destPath, totalData);
+            // Report completion via C callback
+            if (completeCbPtr !== 0) {
+                const pathPtr = LlamaCppBridge.shared.allocString(destPath);
+                m.dynCall('viii', completeCbPtr, [0, pathPtr, cbUserData]); // 0 = RAC_OK
+                m._free(pathPtr);
+            }
+        }
+        catch (error) {
+            logger.error(`Download failed for ${url}: ${error}`);
+            if (completeCbPtr !== 0) {
+                const pathPtr = LlamaCppBridge.shared.allocString('');
+                m.dynCall('viii', completeCbPtr, [-160, pathPtr, cbUserData]); // RAC_ERROR_DOWNLOAD_FAILED
+                m._free(pathPtr);
+            }
+        }
+    }
+}
+//# sourceMappingURL=PlatformAdapter.js.map

package/dist/Foundation/PlatformAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlatformAdapter.js","sourceRoot":"","sources":["../../src/Foundation/PlatformAdapter.ts"],"names":[],"mappings":"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"}

package/dist/Foundation/TelemetryService.d.ts

@@ -0,0 +1,96 @@
+/**
+ * TelemetryService.ts
+ *
+ * Web SDK bridge to the C++ telemetry manager (rac_telemetry_manager_*).
+ * Mirrors the role of TelemetryBridge.cpp in React Native.
+ *
+ * Architecture:
+ * - Creates rac_telemetry_manager_t via WASM
+ * - Registers an HTTP callback that C++ calls when events need sending
+ * - The HTTP callback uses HTTPService (browser fetch) to POST to the endpoint
+ * - Calls rac_telemetry_manager_http_complete() with the result
+ * - Also provides AnalyticsEventCallback for forwarding events from AnalyticsEventsBridge
+ *
+ * Device UUID:
+ * - Persisted in localStorage under 'rac_device_id'
+ * - Generated with crypto.randomUUID() on first run
+ */
+import { SDKEnvironment } from '@runanywhere/web';
+import type { DeviceInfoData } from '@runanywhere/web';
+import type { LlamaCppModule } from './LlamaCppBridge';
+/**
+ * Returns the persistent device UUID, creating one if it doesn't exist.
+ * Uses localStorage for persistence across page loads.
+ */
+export declare function getOrCreateDeviceId(): string;
+/**
+ * Manages the lifecycle of the C++ telemetry manager and bridges HTTP calls
+ * to browser fetch for telemetry event batching and delivery.
+ */
+export declare class TelemetryService {
+    private static _instance;
+    static get shared(): TelemetryService;
+    private _module;
+    private _handle;
+    private _httpCallbackPtr;
+    private _initialized;
+    private _initPromise;
+    private constructor();
+    /**
+     * Initialize the telemetry manager.
+     * Called from LlamaCppBridge._doLoad() after WASM is loaded.
+     *
+     * Concurrent calls are safe: a second caller awaits the in-flight promise
+     * rather than starting a duplicate initialization, preventing duplicate
+     * WASM handles and leaked function-table entries.
+     */
+    initialize(module: LlamaCppModule, environment: SDKEnvironment, deviceInfo: DeviceInfoData): Promise<void>;
+    /**
+     * Callback for AnalyticsEventsBridge — forwards raw C++ event to telemetry manager.
+     */
+    trackAnalyticsEvent(eventType: number, dataPtr: number): void;
+    /**
+     * Flush all queued telemetry events immediately.
+     */
+    flush(): void;
+    /**
+     * Flush and tear down the telemetry manager.
+     */
+    shutdown(): void;
+    /**
+     * Core initialization logic — only called once, guarded by initialize().
+     */
+    private _doInitialize;
+    /**
+     * Registers the HTTP callback with the WASM telemetry manager.
+     * C++ will call this when it wants to POST a telemetry batch.
+     *
+     * C signature: void(void* user_data, const char* endpoint, const char* json_body,
+     *                   size_t json_length, rac_bool_t requires_auth)
+     * Emscripten signature: 'viiiii'
+     *
+     * IMPORTANT: We call http_complete SYNCHRONOUSLY (before the async fetch) to
+     * prevent C++ from re-flushing the same event while awaiting the HTTP response,
+     * which caused duplicate POSTs. The actual fetch continues in the background.
+     */
+    private registerHttpCallback;
+    /**
+     * Perform the actual HTTP POST for a telemetry batch.
+     * Returns the response JSON string on success.
+     */
+    private performHttpPost;
+    /**
+     * Strip keys that don't exist in the V2 `telemetry_events` table.
+     * Handles both array format (dev flat batch) and single-object format.
+     */
+    private filterForDevTable;
+    private filterObject;
+    /**
+     * If the WASM module has dev config compiled in, use it to configure HTTPService.
+     */
+    private configureDevHTTP;
+    private mapEnvironment;
+    private allocString;
+    private freeAll;
+}
+//# sourceMappingURL=TelemetryService.d.ts.map

package/dist/Foundation/TelemetryService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelemetryService.d.ts","sourceRoot":"","sources":["../../src/Foundation/TelemetryService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAa,cAAc,EAAe,MAAM,kBAAkB,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAkCvD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAY5C;AAMD;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAiC;IAEzD,MAAM,KAAK,MAAM,IAAI,gBAAgB,CAKpC;IAED,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAA8B;IAElD,OAAO;IAMP;;;;;;;OAOG;IACG,UAAU,CACd,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,cAAc,EAC3B,UAAU,EAAE,cAAc,GACzB,OAAO,CAAC,IAAI,CAAC;IAmBhB;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAY7D;;OAEG;IACH,KAAK,IAAI,IAAI;IAYb;;OAEG;IACH,QAAQ,IAAI,IAAI;IAoChB;;OAEG;YACW,aAAa;IAsD3B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,oBAAoB;IA0B5B;;;OAGG;YACW,eAAe;IAmC7B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,OAAO;CAMhB"}