@runanywhere/web 0.1.0-beta.1

package/dist/Foundation/ErrorTypes.d.ts

@@ -0,0 +1,61 @@
+/**
+ * RunAnywhere Web SDK - Error Types
+ *
+ * Structured error handling matching the RACommons error code system.
+ * Error codes map to rac_error.h ranges (-100 to -999).
+ */
+/** RACommons error code ranges */
+export declare enum SDKErrorCode {
+    Success = 0,
+    NotInitialized = -100,
+    AlreadyInitialized = -101,
+    InvalidConfiguration = -102,
+    InitializationFailed = -103,
+    ModelNotFound = -110,
+    ModelLoadFailed = -111,
+    ModelInvalidFormat = -112,
+    ModelNotLoaded = -113,
+    ModelAlreadyLoaded = -114,
+    GenerationFailed = -130,
+    GenerationCancelled = -131,
+    GenerationTimeout = -132,
+    InvalidPrompt = -133,
+    ContextLengthExceeded = -134,
+    NetworkError = -150,
+    NetworkTimeout = -151,
+    AuthenticationFailed = -152,
+    DownloadFailed = -160,
+    DownloadCancelled = -161,
+    StorageError = -180,
+    InsufficientStorage = -181,
+    FileNotFound = -182,
+    FileWriteFailed = -183,
+    InvalidParameter = -220,
+    ComponentNotReady = -230,
+    ComponentBusy = -231,
+    InvalidState = -232,
+    BackendNotAvailable = -600,
+    BackendError = -601,
+    WASMLoadFailed = -900,
+    WASMNotLoaded = -901,
+    WASMCallbackError = -902,
+    WASMMemoryError = -903
+}
+/**
+ * SDK Error class matching the error handling pattern across all SDKs.
+ */
+export declare class SDKError extends Error {
+    readonly code: SDKErrorCode;
+    readonly details?: string;
+    constructor(code: SDKErrorCode, message: string, details?: string);
+    /** Create from a RACommons rac_result_t error code */
+    static fromRACResult(resultCode: number, details?: string): SDKError;
+    /** Check if error code indicates success */
+    static isSuccess(resultCode: number): boolean;
+    /** Convenience constructors */
+    static notInitialized(message?: string): SDKError;
+    static wasmNotLoaded(message?: string): SDKError;
+    static modelNotFound(modelId: string): SDKError;
+    static generationFailed(details?: string): SDKError;
+}
+//# sourceMappingURL=ErrorTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorTypes.d.ts","sourceRoot":"","sources":["../../src/Foundation/ErrorTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kCAAkC;AAClC,oBAAY,YAAY;IAEtB,OAAO,IAAI;IAGX,cAAc,OAAO;IACrB,kBAAkB,OAAO;IACzB,oBAAoB,OAAO;IAC3B,oBAAoB,OAAO;IAG3B,aAAa,OAAO;IACpB,eAAe,OAAO;IACtB,kBAAkB,OAAO;IACzB,cAAc,OAAO;IACrB,kBAAkB,OAAO;IAGzB,gBAAgB,OAAO;IACvB,mBAAmB,OAAO;IAC1B,iBAAiB,OAAO;IACxB,aAAa,OAAO;IACpB,qBAAqB,OAAO;IAG5B,YAAY,OAAO;IACnB,cAAc,OAAO;IACrB,oBAAoB,OAAO;IAC3B,cAAc,OAAO;IACrB,iBAAiB,OAAO;IAGxB,YAAY,OAAO;IACnB,mBAAmB,OAAO;IAC1B,YAAY,OAAO;IACnB,eAAe,OAAO;IAGtB,gBAAgB,OAAO;IAGvB,iBAAiB,OAAO;IACxB,aAAa,OAAO;IACpB,YAAY,OAAO;IAGnB,mBAAmB,OAAO;IAC1B,YAAY,OAAO;IAGnB,cAAc,OAAO;IACrB,aAAa,OAAO;IACpB,iBAAiB,OAAO;IACxB,eAAe,OAAO;CACvB;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEd,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAOjE,sDAAsD;IACtD,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ;IAKpE,4CAA4C;IAC5C,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI7C,+BAA+B;IAC/B,MAAM,CAAC,cAAc,CAAC,OAAO,SAAwB,GAAG,QAAQ;IAIhE,MAAM,CAAC,aAAa,CAAC,OAAO,SAA2B,GAAG,QAAQ;IAIlE,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAO/C,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ;CAOpD"}

package/dist/Foundation/ErrorTypes.js

@@ -0,0 +1,90 @@
+/**
+ * RunAnywhere Web SDK - Error Types
+ *
+ * Structured error handling matching the RACommons error code system.
+ * Error codes map to rac_error.h ranges (-100 to -999).
+ */
+/** RACommons error code ranges */
+export var SDKErrorCode;
+(function (SDKErrorCode) {
+    // Success
+    SDKErrorCode[SDKErrorCode["Success"] = 0] = "Success";
+    // Initialization errors (-100 to -109)
+    SDKErrorCode[SDKErrorCode["NotInitialized"] = -100] = "NotInitialized";
+    SDKErrorCode[SDKErrorCode["AlreadyInitialized"] = -101] = "AlreadyInitialized";
+    SDKErrorCode[SDKErrorCode["InvalidConfiguration"] = -102] = "InvalidConfiguration";
+    SDKErrorCode[SDKErrorCode["InitializationFailed"] = -103] = "InitializationFailed";
+    // Model errors (-110 to -129)
+    SDKErrorCode[SDKErrorCode["ModelNotFound"] = -110] = "ModelNotFound";
+    SDKErrorCode[SDKErrorCode["ModelLoadFailed"] = -111] = "ModelLoadFailed";
+    SDKErrorCode[SDKErrorCode["ModelInvalidFormat"] = -112] = "ModelInvalidFormat";
+    SDKErrorCode[SDKErrorCode["ModelNotLoaded"] = -113] = "ModelNotLoaded";
+    SDKErrorCode[SDKErrorCode["ModelAlreadyLoaded"] = -114] = "ModelAlreadyLoaded";
+    // Generation errors (-130 to -149)
+    SDKErrorCode[SDKErrorCode["GenerationFailed"] = -130] = "GenerationFailed";
+    SDKErrorCode[SDKErrorCode["GenerationCancelled"] = -131] = "GenerationCancelled";
+    SDKErrorCode[SDKErrorCode["GenerationTimeout"] = -132] = "GenerationTimeout";
+    SDKErrorCode[SDKErrorCode["InvalidPrompt"] = -133] = "InvalidPrompt";
+    SDKErrorCode[SDKErrorCode["ContextLengthExceeded"] = -134] = "ContextLengthExceeded";
+    // Network errors (-150 to -179)
+    SDKErrorCode[SDKErrorCode["NetworkError"] = -150] = "NetworkError";
+    SDKErrorCode[SDKErrorCode["NetworkTimeout"] = -151] = "NetworkTimeout";
+    SDKErrorCode[SDKErrorCode["AuthenticationFailed"] = -152] = "AuthenticationFailed";
+    SDKErrorCode[SDKErrorCode["DownloadFailed"] = -160] = "DownloadFailed";
+    SDKErrorCode[SDKErrorCode["DownloadCancelled"] = -161] = "DownloadCancelled";
+    // Storage errors (-180 to -219)
+    SDKErrorCode[SDKErrorCode["StorageError"] = -180] = "StorageError";
+    SDKErrorCode[SDKErrorCode["InsufficientStorage"] = -181] = "InsufficientStorage";
+    SDKErrorCode[SDKErrorCode["FileNotFound"] = -182] = "FileNotFound";
+    SDKErrorCode[SDKErrorCode["FileWriteFailed"] = -183] = "FileWriteFailed";
+    // Parameter errors (-220 to -229)
+    SDKErrorCode[SDKErrorCode["InvalidParameter"] = -220] = "InvalidParameter";
+    // Component errors (-230 to -249)
+    SDKErrorCode[SDKErrorCode["ComponentNotReady"] = -230] = "ComponentNotReady";
+    SDKErrorCode[SDKErrorCode["ComponentBusy"] = -231] = "ComponentBusy";
+    SDKErrorCode[SDKErrorCode["InvalidState"] = -232] = "InvalidState";
+    // Backend errors (-600 to -699)
+    SDKErrorCode[SDKErrorCode["BackendNotAvailable"] = -600] = "BackendNotAvailable";
+    SDKErrorCode[SDKErrorCode["BackendError"] = -601] = "BackendError";
+    // WASM-specific errors (-900 to -999)
+    SDKErrorCode[SDKErrorCode["WASMLoadFailed"] = -900] = "WASMLoadFailed";
+    SDKErrorCode[SDKErrorCode["WASMNotLoaded"] = -901] = "WASMNotLoaded";
+    SDKErrorCode[SDKErrorCode["WASMCallbackError"] = -902] = "WASMCallbackError";
+    SDKErrorCode[SDKErrorCode["WASMMemoryError"] = -903] = "WASMMemoryError";
+})(SDKErrorCode || (SDKErrorCode = {}));
+/**
+ * SDK Error class matching the error handling pattern across all SDKs.
+ */
+export class SDKError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = 'SDKError';
+        this.code = code;
+        this.details = details;
+    }
+    /** Create from a RACommons rac_result_t error code */
+    static fromRACResult(resultCode, details) {
+        const message = `RACommons error: ${resultCode}`;
+        return new SDKError(resultCode, message, details);
+    }
+    /** Check if error code indicates success */
+    static isSuccess(resultCode) {
+        return resultCode === 0;
+    }
+    /** Convenience constructors */
+    static notInitialized(message = 'SDK not initialized') {
+        return new SDKError(SDKErrorCode.NotInitialized, message);
+    }
+    static wasmNotLoaded(message = 'WASM module not loaded') {
+        return new SDKError(SDKErrorCode.WASMNotLoaded, message);
+    }
+    static modelNotFound(modelId) {
+        return new SDKError(SDKErrorCode.ModelNotFound, `Model not found: ${modelId}`);
+    }
+    static generationFailed(details) {
+        return new SDKError(SDKErrorCode.GenerationFailed, 'Generation failed', details);
+    }
+}
+//# sourceMappingURL=ErrorTypes.js.map

package/dist/Foundation/ErrorTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorTypes.js","sourceRoot":"","sources":["../../src/Foundation/ErrorTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kCAAkC;AAClC,MAAM,CAAN,IAAY,YAsDX;AAtDD,WAAY,YAAY;IACtB,UAAU;IACV,qDAAW,CAAA;IAEX,uCAAuC;IACvC,sEAAqB,CAAA;IACrB,8EAAyB,CAAA;IACzB,kFAA2B,CAAA;IAC3B,kFAA2B,CAAA;IAE3B,8BAA8B;IAC9B,oEAAoB,CAAA;IACpB,wEAAsB,CAAA;IACtB,8EAAyB,CAAA;IACzB,sEAAqB,CAAA;IACrB,8EAAyB,CAAA;IAEzB,mCAAmC;IACnC,0EAAuB,CAAA;IACvB,gFAA0B,CAAA;IAC1B,4EAAwB,CAAA;IACxB,oEAAoB,CAAA;IACpB,oFAA4B,CAAA;IAE5B,gCAAgC;IAChC,kEAAmB,CAAA;IACnB,sEAAqB,CAAA;IACrB,kFAA2B,CAAA;IAC3B,sEAAqB,CAAA;IACrB,4EAAwB,CAAA;IAExB,gCAAgC;IAChC,kEAAmB,CAAA;IACnB,gFAA0B,CAAA;IAC1B,kEAAmB,CAAA;IACnB,wEAAsB,CAAA;IAEtB,kCAAkC;IAClC,0EAAuB,CAAA;IAEvB,kCAAkC;IAClC,4EAAwB,CAAA;IACxB,oEAAoB,CAAA;IACpB,kEAAmB,CAAA;IAEnB,gCAAgC;IAChC,gFAA0B,CAAA;IAC1B,kEAAmB,CAAA;IAEnB,sCAAsC;IACtC,sEAAqB,CAAA;IACrB,oEAAoB,CAAA;IACpB,4EAAwB,CAAA;IACxB,wEAAsB,CAAA;AACxB,CAAC,EAtDW,YAAY,KAAZ,YAAY,QAsDvB;AAED;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAe;IACnB,OAAO,CAAU;IAE1B,YAAY,IAAkB,EAAE,OAAe,EAAE,OAAgB;QAC/D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,sDAAsD;IACtD,MAAM,CAAC,aAAa,CAAC,UAAkB,EAAE,OAAgB;QACvD,MAAM,OAAO,GAAG,oBAAoB,UAAU,EAAE,CAAC;QACjD,OAAO,IAAI,QAAQ,CAAC,UAA0B,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAED,4CAA4C;IAC5C,MAAM,CAAC,SAAS,CAAC,UAAkB;QACjC,OAAO,UAAU,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,+BAA+B;IAC/B,MAAM,CAAC,cAAc,CAAC,OAAO,GAAG,qBAAqB;QACnD,OAAO,IAAI,QAAQ,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,CAAC,aAAa,CAAC,OAAO,GAAG,wBAAwB;QACrD,OAAO,IAAI,QAAQ,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,CAAC,aAAa,CAAC,OAAe;QAClC,OAAO,IAAI,QAAQ,CACjB,YAAY,CAAC,aAAa,EAC1B,oBAAoB,OAAO,EAAE,CAC9B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,OAAgB;QACtC,OAAO,IAAI,QAAQ,CACjB,YAAY,CAAC,gBAAgB,EAC7B,mBAAmB,EACnB,OAAO,CACR,CAAC;IACJ,CAAC;CACF"}

package/dist/Foundation/EventBus.d.ts

@@ -0,0 +1,171 @@
+/**
+ * RunAnywhere Web SDK - Event Bus
+ *
+ * Central event system matching the pattern across all SDKs.
+ * Provides typed event subscription and publishing.
+ */
+import type { SDKEventType } from '../types/enums';
+/** Generic event listener */
+export type EventListener<T = unknown> = (event: T) => void;
+/** Unsubscribe function returned by subscribe */
+export type Unsubscribe = () => void;
+/** Event envelope wrapping all emitted events */
+export interface SDKEventEnvelope {
+    type: string;
+    category: SDKEventType;
+    timestamp: number;
+    data: Record<string, unknown>;
+}
+/** Known SDK event types and their payload shapes. */
+export interface SDKEventMap {
+    'sdk.initialized': {
+        environment: string;
+        accelerationMode: string;
+    };
+    'sdk.accelerationMode': {
+        mode: string;
+    };
+    'model.registered': {
+        count: number;
+    };
+    'model.downloadStarted': {
+        modelId: string;
+        url: string;
+    };
+    'model.downloadProgress': {
+        modelId: string;
+        progress: number;
+        bytesDownloaded: number;
+        totalBytes: number;
+        stage?: string;
+    };
+    'model.downloadCompleted': {
+        modelId: string;
+        sizeBytes?: number;
+        localPath?: string;
+    };
+    'model.downloadFailed': {
+        modelId: string;
+        error: string;
+    };
+    'model.loadStarted': {
+        modelId: string;
+        component?: string;
+        category?: string;
+    };
+    'model.loadCompleted': {
+        modelId: string;
+        component?: string;
+        category?: string;
+        loadTimeMs?: number;
+    };
+    'model.loadFailed': {
+        modelId: string;
+        error: string;
+    };
+    'model.unloaded': {
+        modelId: string;
+        category: string;
+    };
+    'model.quotaExceeded': {
+        modelId: string;
+        availableBytes: number;
+        neededBytes: number;
+    };
+    'model.evicted': {
+        modelId: string;
+        modelName: string;
+        freedBytes: number;
+    };
+    'generation.started': {
+        prompt: string;
+    };
+    'generation.completed': {
+        tokensUsed: number;
+        latencyMs: number;
+    };
+    'generation.failed': {
+        error: string;
+    };
+    'stt.transcribed': {
+        text: string;
+        confidence: number;
+    };
+    'tts.synthesized': {
+        durationMs: number;
+        sampleRate: number;
+        textLength: number;
+    };
+    'vad.speechStarted': {
+        activity: string;
+    };
+    'vad.speechEnded': {
+        activity: string;
+    };
+    'voice.turnCompleted': {
+        speechDetected: boolean;
+        transcription: string;
+        response: string;
+    };
+    'embeddings.generated': {
+        numEmbeddings: number;
+        dimension: number;
+        processingTimeMs: number;
+    };
+    'diffusion.generated': {
+        width: number;
+        height: number;
+        generationTimeMs: number;
+    };
+    'vlm.processed': {
+        tokensPerSecond: number;
+        totalTokens: number;
+        hardwareUsed: string;
+    };
+    'playback.started': {
+        durationMs: number;
+        sampleRate: number;
+    };
+    'playback.completed': {
+        durationMs: number;
+    };
+    [key: string]: Record<string, unknown>;
+}
+/**
+ * EventBus - Central event system for the SDK.
+ *
+ * Mirrors the EventBus pattern used in Swift, Kotlin, React Native, and Flutter SDKs.
+ * On web, this is a pure TypeScript implementation (no C++ bridge needed for events
+ * since we subscribe to RACommons events via rac_event_subscribe and re-emit here).
+ */
+export declare class EventBus {
+    private static _instance;
+    private listeners;
+    private wildcardListeners;
+    static get shared(): EventBus;
+    /**
+     * Subscribe to events of a specific type.
+     * @returns Unsubscribe function
+     */
+    on<K extends keyof SDKEventMap>(eventType: K, listener: EventListener<SDKEventMap[K]>): Unsubscribe;
+    /**
+     * Subscribe to ALL events (wildcard).
+     * @returns Unsubscribe function
+     */
+    onAny(listener: EventListener<SDKEventEnvelope>): Unsubscribe;
+    /**
+     * Subscribe to events once (auto-unsubscribe after first event).
+     */
+    once<K extends keyof SDKEventMap>(eventType: K, listener: EventListener<SDKEventMap[K]>): Unsubscribe;
+    /**
+     * Emit an event.
+     */
+    emit<K extends keyof SDKEventMap>(eventType: K, category: SDKEventType, data?: SDKEventMap[K]): void;
+    /**
+     * Remove all listeners.
+     */
+    removeAll(): void;
+    /** Reset singleton (for testing) */
+    static reset(): void;
+}
+//# sourceMappingURL=EventBus.d.ts.map

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

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

package/dist/Foundation/EventBus.js

@@ -0,0 +1,113 @@
+/**
+ * RunAnywhere Web SDK - Event Bus
+ *
+ * Central event system matching the pattern across all SDKs.
+ * Provides typed event subscription and publishing.
+ */
+import { SDKLogger } from './SDKLogger';
+const logger = new SDKLogger('EventBus');
+/**
+ * EventBus - Central event system for the SDK.
+ *
+ * Mirrors the EventBus pattern used in Swift, Kotlin, React Native, and Flutter SDKs.
+ * On web, this is a pure TypeScript implementation (no C++ bridge needed for events
+ * since we subscribe to RACommons events via rac_event_subscribe and re-emit here).
+ */
+export class EventBus {
+    static _instance = null;
+    listeners = new Map();
+    wildcardListeners = new Set();
+    static get shared() {
+        if (!EventBus._instance) {
+            EventBus._instance = new EventBus();
+        }
+        return EventBus._instance;
+    }
+    /**
+     * Subscribe to events of a specific type.
+     * @returns Unsubscribe function
+     */
+    on(eventType, listener) {
+        const key = eventType;
+        if (!this.listeners.has(key)) {
+            this.listeners.set(key, new Set());
+        }
+        const set = this.listeners.get(key);
+        set.add(listener);
+        return () => {
+            set.delete(listener);
+            if (set.size === 0) {
+                this.listeners.delete(key);
+            }
+        };
+    }
+    /**
+     * Subscribe to ALL events (wildcard).
+     * @returns Unsubscribe function
+     */
+    onAny(listener) {
+        this.wildcardListeners.add(listener);
+        return () => {
+            this.wildcardListeners.delete(listener);
+        };
+    }
+    /**
+     * Subscribe to events once (auto-unsubscribe after first event).
+     */
+    once(eventType, listener) {
+        const unsubscribe = this.on(eventType, (event) => {
+            unsubscribe();
+            listener(event);
+        });
+        return unsubscribe;
+    }
+    /**
+     * Emit an event.
+     */
+    emit(eventType, category, data) {
+        const key = eventType;
+        const payload = (data ?? {});
+        const envelope = {
+            type: key,
+            category,
+            timestamp: Date.now(),
+            data: payload,
+        };
+        // Notify specific listeners
+        const specific = this.listeners.get(key);
+        if (specific) {
+            for (const listener of specific) {
+                try {
+                    listener(payload);
+                }
+                catch (error) {
+                    logger.error(`Listener error for ${key}: ${error instanceof Error ? error.message : String(error)}`);
+                }
+            }
+        }
+        // Notify wildcard listeners
+        for (const listener of this.wildcardListeners) {
+            try {
+                listener(envelope);
+            }
+            catch (error) {
+                logger.error(`Wildcard listener error: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+    }
+    /**
+     * Remove all listeners.
+     */
+    removeAll() {
+        this.listeners.clear();
+        this.wildcardListeners.clear();
+    }
+    /** Reset singleton (for testing) */
+    static reset() {
+        if (EventBus._instance) {
+            EventBus._instance.removeAll();
+        }
+        EventBus._instance = null;
+    }
+}
+//# sourceMappingURL=EventBus.js.map

package/dist/Foundation/EventBus.js.map

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

package/dist/Foundation/PlatformAdapter.d.ts

@@ -0,0 +1,101 @@
+/**
+ * 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.
+ */
+/**
+ * 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 declare class PlatformAdapter {
+    private callbacks;
+    private adapterPtr;
+    /**
+     * Create and register the platform adapter with RACommons.
+     * Must be called after WASM module is loaded but before rac_init().
+     */
+    register(): void;
+    /**
+     * Get the WASM pointer to the adapter struct.
+     * Used by RunAnywhere.initialize() to populate rac_config_t.
+     */
+    getAdapterPtr(): number;
+    /**
+     * Clean up allocated callbacks and memory.
+     */
+    cleanup(): void;
+    /** file_exists: rac_bool_t (*)(const char* path, void* user_data) */
+    private registerFileExists;
+    /** file_read: rac_result_t (*)(const char* path, void** out_data, size_t* out_size, void* user_data) */
+    private registerFileRead;
+    /** file_write: rac_result_t (*)(const char* path, const void* data, size_t size, void* user_data) */
+    private registerFileWrite;
+    /** file_delete: rac_result_t (*)(const char* path, void* user_data) */
+    private registerFileDelete;
+    /**
+     * 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).
+     */
+    private registerSecureGet;
+    /**
+     * 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.
+     */
+    private registerSecureSet;
+    /**
+     * secure_delete: rac_result_t (*)(const char* key, void* user_data)
+     *
+     * SECURITY NOTE: See registerSecureGet — localStorage is NOT secure on web.
+     */
+    private registerSecureDelete;
+    /** log: void (*)(rac_log_level_t level, const char* category, const char* message, void* user_data) */
+    private registerLog;
+    /** now_ms: int64_t (*)(void* user_data) */
+    private registerNowMs;
+    /** get_memory_info: rac_result_t (*)(rac_memory_info_t* out_info, void* user_data) */
+    private registerGetMemoryInfo;
+    /**
+     * 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
+     */
+    private registerHttpDownload;
+    /**
+     * 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
+     */
+    private registerExtractArchive;
+    /**
+     * Perform an HTTP download using fetch() and stream to Emscripten FS.
+     */
+    private performDownload;
+}
+declare module './WASMBridge' {
+    interface RACommonsModule {
+        HEAPU8: Uint8Array;
+        dynCall: (sig: string, ptr: number, args: number[]) => unknown;
+    }
+}
+//# sourceMappingURL=PlatformAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PlatformAdapter.d.ts","sourceRoot":"","sources":["../../src/Foundation/PlatformAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA0BH;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,UAAU,CAAK;IAEvB;;;OAGG;IACH,QAAQ,IAAI,IAAI;IAmEhB;;;OAGG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,OAAO,IAAI,IAAI;IAsBf,qEAAqE;IACrE,OAAO,CAAC,kBAAkB;IAY1B,wGAAwG;IACxG,OAAO,CAAC,gBAAgB;IAgBxB,qGAAqG;IACrG,OAAO,CAAC,iBAAiB;IAazB,uEAAuE;IACvE,OAAO,CAAC,kBAAkB;IAY1B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAazB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAY5B,uGAAuG;IACvG,OAAO,CAAC,WAAW;IA2BnB,2CAA2C;IAC3C,OAAO,CAAC,aAAa;IAQrB,sFAAsF;IACtF,OAAO,CAAC,qBAAqB;IA8B7B;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAyB5B;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;OAEG;YACW,eAAe;CAmE9B;AAgBD,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,eAAe;QACvB,MAAM,EAAE,UAAU,CAAC;QACnB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;KAChE;CACF"}