@runanywhere/web 0.1.0-beta.6 → 0.1.0-beta.8

package/dist/Foundation/WASMBridge.js

@@ -1,393 +1,12 @@
 /**
- * RunAnywhere Web SDK - WASM Bridge
+ * RunAnywhere Web SDK - WASM Bridge Types
  *
- * Loads the RACommons WASM module and provides typed wrappers
- * around the C API functions. This is the web equivalent of:
- *   - CppBridge.swift (iOS)
- *   - CppBridge.kt (Kotlin/Android)
- *   - dart_bridge.dart (Flutter)
- *   - HybridRunAnywhereCore.cpp (React Native)
- */
-import { SDKError, SDKErrorCode } from './ErrorTypes';
-import { SDKLogger } from './SDKLogger';
-// ---------------------------------------------------------------------------
-// WASM Bridge
-// ---------------------------------------------------------------------------
-const logger = new SDKLogger('WASMBridge');
-/**
- * WASMBridge - Loads and manages the RACommons WASM module.
+ * Core is now pure TypeScript. The actual WASM bridge implementations
+ * live in each backend package:
+ *   - LlamaCppBridge in @runanywhere/web-llamacpp
+ *   - SherpaONNXBridge in @runanywhere/web-onnx
  *
- * Singleton that provides access to all RACommons C API functions
- * compiled to WebAssembly. This is the central point through which
- * all SDK operations flow, identical to CppBridge on mobile platforms.
+ * This file only exports shared types used by the public API.
  */
-export class WASMBridge {
-    static _instance = null;
-    _module = null;
-    _loaded = false;
-    _loading = null;
-    _accelerationMode = 'cpu';
-    /** The URL that was used to load the WASM glue JS (for worker reuse). */
-    _loadedModuleUrl = null;
-    static get shared() {
-        if (!WASMBridge._instance) {
-            WASMBridge._instance = new WASMBridge();
-        }
-        return WASMBridge._instance;
-    }
-    /** Whether the WASM module is loaded */
-    get isLoaded() {
-        return this._loaded && this._module !== null;
-    }
-    /** Get the raw Emscripten module (throws if not loaded) */
-    get module() {
-        if (!this._module) {
-            throw SDKError.wasmNotLoaded();
-        }
-        return this._module;
-    }
-    /** The hardware acceleration mode in use (webgpu or cpu). */
-    get accelerationMode() {
-        return this._accelerationMode;
-    }
-    /**
-     * The URL of the WASM glue JS that was successfully loaded.
-     * Web Workers should use this URL to load the same WASM variant
-     * (WebGPU or CPU) that the main thread is using.
-     *
-     * Returns `null` if `load()` has not been called yet.
-     */
-    get workerWasmUrl() {
-        return this._loadedModuleUrl;
-    }
-    /**
-     * Load the RACommons WASM module.
-     *
-     * Detects WebGPU at init time and loads the appropriate build variant:
-     *   - `racommons-webgpu.js` when WebGPU + JSPI are available
-     *   - `racommons.js` as the CPU-only fallback
-     *
-     * Safe to call concurrently -- only the first caller triggers the actual
-     * load; subsequent callers await the same in-flight promise.
-     *
-     * @param wasmUrl        - URL to the CPU-only racommons.js glue file.
-     * @param webgpuWasmUrl  - URL to the WebGPU racommons-webgpu.js glue file.
-     * @param acceleration   - Force a specific mode ('auto' detects, 'webgpu' forces GPU, 'cpu' forces CPU).
-     */
-    async load(wasmUrl, webgpuWasmUrl, acceleration = 'auto') {
-        if (this._loaded) {
-            logger.debug('WASM module already loaded');
-            return;
-        }
-        // Prevent duplicate loading -- return the in-flight promise
-        if (this._loading) {
-            await this._loading;
-            return;
-        }
-        this._loading = this._doLoad(wasmUrl, webgpuWasmUrl, acceleration);
-        try {
-            await this._loading;
-        }
-        finally {
-            this._loading = null;
-        }
-    }
-    /**
-     * Internal load implementation.
-     * Separated from `load()` so the concurrent-load guard can wrap it.
-     */
-    async _doLoad(wasmUrl, webgpuWasmUrl, acceleration = 'auto') {
-        logger.info('Loading RACommons WASM module...');
-        try {
-            // Determine whether to use the WebGPU variant
-            const useWebGPU = await this.resolveAcceleration(acceleration);
-            this._accelerationMode = useWebGPU ? 'webgpu' : 'cpu';
-            // Select the correct module URL
-            const moduleUrl = useWebGPU
-                ? (webgpuWasmUrl ?? new URL('../../wasm/racommons-webgpu.js', import.meta.url).href)
-                : (wasmUrl ?? new URL('../../wasm/racommons.js', import.meta.url).href);
-            this._loadedModuleUrl = moduleUrl;
-            logger.info(`Acceleration mode: ${this._accelerationMode} (loading ${useWebGPU ? 'racommons-webgpu' : 'racommons'})`);
-            // Safety-net probe: verify the WebGPU glue JS was compiled with
-            // JSPI support.  A JSPI-enabled build contains "WebAssembly.promising"
-            // which wraps exported WASM functions so they can suspend during
-            // async WebGPU operations.  If the marker is absent the build is
-            // either outdated or misconfigured and generation would crash with
-            // "RuntimeError: unreachable".  Fall back to CPU in that case.
-            if (useWebGPU && acceleration === 'auto') {
-                try {
-                    const probeResp = await fetch(moduleUrl);
-                    const probeText = await probeResp.text();
-                    if (!probeText.includes('WebAssembly.promising')) {
-                        logger.warning('WebGPU WASM build lacks JSPI support (WebAssembly.promising not found). Falling back to CPU.');
-                        return this._doLoad(wasmUrl, undefined, 'cpu');
-                    }
-                }
-                catch {
-                    // If the probe fails, proceed with WebGPU and let runtime errors
-                    // surface normally.
-                }
-            }
-            // Dynamic import of the Emscripten glue JS
-            // The glue file exports a factory function: createRACommonsModule()
-            const { default: createModule } = await import(/* @vite-ignore */ moduleUrl);
-            // Instantiate the WASM module
-            this._module = await createModule({
-                // Emscripten module overrides
-                print: (text) => logger.info(text),
-                printErr: (text) => logger.error(text),
-            });
-            // Verify module loaded correctly.
-            // With JSPI builds some exports may return Promises, so await just
-            // in case _rac_wasm_ping was wrapped with WebAssembly.promising.
-            const pingRaw = this._module._rac_wasm_ping();
-            const pingResult = (typeof pingRaw === 'object' && pingRaw !== null && 'then' in pingRaw)
-                ? await pingRaw
-                : pingRaw;
-            if (pingResult !== 42) {
-                throw new Error(`WASM ping failed: expected 42, got ${pingResult}`);
-            }
-            this._loaded = true;
-            logger.info(`RACommons WASM module loaded successfully (${this._accelerationMode})`);
-        }
-        catch (error) {
-            // If WebGPU load failed, fall back to CPU automatically
-            if (this._accelerationMode === 'webgpu' && acceleration === 'auto') {
-                const reason = error instanceof Error ? error.message : String(error);
-                logger.warning(`WebGPU WASM module failed to load (${reason}), falling back to CPU`);
-                this._accelerationMode = 'cpu';
-                this._module = null;
-                this._loaded = false;
-                return this._doLoad(wasmUrl, undefined, 'cpu');
-            }
-            this._module = null;
-            this._loaded = false;
-            const message = error instanceof Error ? error.message : String(error);
-            logger.error(`Failed to load WASM module: ${message}`);
-            throw new SDKError(SDKErrorCode.WASMLoadFailed, `Failed to load WASM module: ${message}`);
-        }
-    }
-    // -----------------------------------------------------------------------
-    // WebGPU Detection
-    // -----------------------------------------------------------------------
-    /**
-     * Determine whether to use WebGPU based on the acceleration preference
-     * and actual browser capability.
-     */
-    async resolveAcceleration(preference) {
-        if (preference === 'cpu')
-            return false;
-        const hasWebGPU = await WASMBridge.detectWebGPU();
-        if (preference === 'webgpu' && !hasWebGPU) {
-            logger.warning('WebGPU requested but not available; falling back to CPU');
-            return false;
-        }
-        if (!hasWebGPU)
-            return false;
-        // The WebGPU WASM module is compiled with JSPI (WebAssembly JavaScript
-        // Promise Integration).  If the browser doesn't expose the JSPI APIs
-        // the module will fail to instantiate.
-        const hasJSPI = WASMBridge.detectJSPI();
-        if (!hasJSPI) {
-            logger.warning('WebGPU available but browser lacks JSPI support (WebAssembly.promising). ' +
-                'Update Chrome to 128+ or enable chrome://flags/#experimental-wasm-jspi. Falling back to CPU.');
-            return false;
-        }
-        return true;
-    }
-    /**
-     * Probe for a functional WebGPU adapter.
-     * Returns true only when the browser exposes navigator.gpu AND
-     * a valid adapter can be obtained.
-     */
-    static async detectWebGPU() {
-        if (typeof navigator === 'undefined' || !('gpu' in navigator))
-            return false;
-        try {
-            const gpu = navigator.gpu;
-            const adapter = await gpu?.requestAdapter();
-            return adapter !== null;
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Detect JSPI (JavaScript Promise Integration) support.
-     * The WebGPU WASM module requires WebAssembly.promising and
-     * WebAssembly.Suspending to suspend during async GPU operations.
-     */
-    static detectJSPI() {
-        try {
-            return (typeof WebAssembly !== 'undefined' &&
-                'promising' in WebAssembly &&
-                'Suspending' in WebAssembly);
-        }
-        catch {
-            return false;
-        }
-    }
-    // -----------------------------------------------------------------------
-    // String Helpers
-    // -----------------------------------------------------------------------
-    /** Allocate a C string in WASM memory. Caller must free. */
-    allocString(str) {
-        const m = this.module;
-        const len = m.lengthBytesUTF8(str) + 1;
-        const ptr = m._malloc(len);
-        m.stringToUTF8(str, ptr, len);
-        return ptr;
-    }
-    /** Read a C string from WASM memory */
-    readString(ptr) {
-        if (ptr === 0)
-            return '';
-        return this.module.UTF8ToString(ptr);
-    }
-    /** Free WASM memory */
-    free(ptr) {
-        if (ptr !== 0) {
-            this.module._free(ptr);
-        }
-    }
-    // -----------------------------------------------------------------------
-    // Binary Data Helpers
-    //
-    // HEAPU8 / HEAPF32 may not be exported by the Emscripten module.
-    // These helpers try the fast HEAPU8/HEAPF32 path first, then fall
-    // back to byte-by-byte setValue/getValue which is always available.
-    // -----------------------------------------------------------------------
-    /**
-     * Write a Uint8Array into WASM linear memory at `destPtr`.
-     *
-     * Fast path uses `HEAPU8.set()` when available (after WASM rebuild).
-     * Fallback uses `setValue` byte-by-byte (works with any build).
-     */
-    writeBytes(src, destPtr) {
-        const m = this.module;
-        if (m.HEAPU8) {
-            m.HEAPU8.set(src, destPtr);
-            return;
-        }
-        for (let i = 0; i < src.length; i++) {
-            m.setValue(destPtr + i, src[i], 'i8');
-        }
-    }
-    /**
-     * Read `length` bytes from WASM linear memory starting at `srcPtr`.
-     *
-     * Fast path uses `HEAPU8.slice()` when available.
-     * Fallback uses `getValue` byte-by-byte.
-     */
-    readBytes(srcPtr, length) {
-        const m = this.module;
-        if (m.HEAPU8) {
-            return m.HEAPU8.slice(srcPtr, srcPtr + length);
-        }
-        const result = new Uint8Array(length);
-        for (let i = 0; i < length; i++) {
-            result[i] = m.getValue(srcPtr + i, 'i8') & 0xFF;
-        }
-        return result;
-    }
-    /**
-     * Read `count` float32 values from WASM linear memory starting at `srcPtr`.
-     *
-     * Fast path uses `HEAPF32` when available.
-     * Fallback reads 4 bytes at a time via getValue('float').
-     */
-    readFloat32Array(srcPtr, count) {
-        const m = this.module;
-        if (m.HEAPF32) {
-            const startIndex = srcPtr >> 2; // byte offset → float32 index
-            return m.HEAPF32.slice(startIndex, startIndex + count);
-        }
-        const result = new Float32Array(count);
-        for (let i = 0; i < count; i++) {
-            result[i] = m.getValue(srcPtr + i * 4, 'float');
-        }
-        return result;
-    }
-    /**
-     * Write a Float32Array into WASM linear memory at `destPtr`.
-     * `destPtr` must be 4-byte aligned.
-     *
-     * Fast path uses `HEAPF32.set()` when available.
-     * Fallback uses `setValue` with 'float'.
-     */
-    writeFloat32Array(src, destPtr) {
-        const m = this.module;
-        if (m.HEAPF32) {
-            m.HEAPF32.set(src, destPtr >> 2);
-            return;
-        }
-        for (let i = 0; i < src.length; i++) {
-            m.setValue(destPtr + i * 4, src[i], 'float');
-        }
-    }
-    /**
-     * Read a single float32 value from WASM linear memory.
-     */
-    readFloat32(ptr) {
-        const m = this.module;
-        if (m.HEAPF32) {
-            return m.HEAPF32[ptr >> 2];
-        }
-        return m.getValue(ptr, 'float');
-    }
-    // -----------------------------------------------------------------------
-    // C API Wrappers
-    // -----------------------------------------------------------------------
-    /** Check a rac_result_t and throw SDKError if not success */
-    checkResult(result, operation) {
-        if (result !== 0) {
-            const errMsgPtr = this.module._rac_error_message(result);
-            const errMsg = this.readString(errMsgPtr);
-            throw SDKError.fromRACResult(result, `${operation}: ${errMsg}`);
-        }
-    }
-    /** Get RACommons error message for a result code */
-    getErrorMessage(resultCode) {
-        const ptr = this.module._rac_error_message(resultCode);
-        return this.readString(ptr);
-    }
-    /**
-     * Type-safe wrapper around Emscripten ccall().
-     * Centralizes all dynamic WASM function calls through the bridge.
-     */
-    callFunction(funcName, returnType, argTypes, args, opts) {
-        if (!this._module)
-            throw SDKError.wasmNotLoaded();
-        return this._module.ccall(funcName, returnType, argTypes, args, opts);
-    }
-    /**
-     * Call a WASM function that returns rac_result_t and throw SDKError if
-     * the result is non-zero.
-     */
-    callWithCheck(funcName, argTypes, args) {
-        const result = this.callFunction(funcName, 'number', argTypes, args);
-        this.checkResult(result, funcName);
-    }
-    // -----------------------------------------------------------------------
-    // Cleanup
-    // -----------------------------------------------------------------------
-    /** Shutdown the WASM module */
-    shutdown() {
-        if (this._module && this._loaded) {
-            try {
-                this._module._rac_shutdown();
-            }
-            catch {
-                // Ignore shutdown errors
-            }
-        }
-        this._module = null;
-        this._loaded = false;
-        this._loading = null;
-        this._accelerationMode = 'cpu';
-        this._loadedModuleUrl = null;
-        WASMBridge._instance = null;
-        logger.info('WASM bridge shut down');
-    }
-}
+export {};
 //# sourceMappingURL=WASMBridge.js.map

package/dist/Foundation/WASMBridge.js.map

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

package/dist/Infrastructure/DeviceCapabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DeviceCapabilities.d.ts","sourceRoot":"","sources":["../../src/Infrastructure/DeviceCapabilities.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAIjE,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,mFAAmF;IACnF,kBAAkB,EAAE,gBAAgB,CAAC;IACrC,2EAA2E;IAC3E,oBAAoB,EAAE,OAAO,CAAC;IAC9B,sEAAsE;IACtE,qBAAqB,EAAE,OAAO,CAAC;IAC/B,iCAAiC;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CA+CnE;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,cAAc,CAAC,CAY7D"}
+{"version":3,"file":"DeviceCapabilities.d.ts","sourceRoot":"","sources":["../../src/Infrastructure/DeviceCapabilities.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAIjE,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,mFAAmF;IACnF,kBAAkB,EAAE,gBAAgB,CAAC;IACrC,2EAA2E;IAC3E,oBAAoB,EAAE,OAAO,CAAC;IAC9B,sEAAsE;IACtE,qBAAqB,EAAE,OAAO,CAAC;IAC/B,iCAAiC;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CA4CnE;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,cAAc,CAAC,CAY7D"}

package/dist/Infrastructure/DeviceCapabilities.js

@@ -10,11 +10,9 @@ const logger = new SDKLogger('DeviceCapabilities');
  * Detect all browser capabilities relevant to AI inference.
  */
 export async function detectCapabilities() {
-    // Import WASMBridge lazily to avoid circular imports at module level
-    const { WASMBridge } = await import('../Foundation/WASMBridge');
     const capabilities = {
         hasWebGPU: false,
-        activeAcceleration: WASMBridge.shared.isLoaded ? WASMBridge.shared.accelerationMode : 'cpu',
+        activeAcceleration: 'cpu',
         hasSharedArrayBuffer: typeof SharedArrayBuffer !== 'undefined',
         isCrossOriginIsolated: typeof crossOriginIsolated !== 'undefined' ? crossOriginIsolated : false,
         hasWASMSIMD: detectWASMSIMD(),

package/dist/Infrastructure/DeviceCapabilities.js.map

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

package/dist/Infrastructure/ExtensionPoint.d.ts

@@ -0,0 +1,114 @@
+/**
+ * ExtensionPoint - Backend registration API
+ *
+ * Follows the React Native SDK's Provider pattern. Backend packages
+ * (e.g. @runanywhere/web-llamacpp, @runanywhere/web-onnx) register
+ * themselves with the core SDK via this API, declaring what capabilities
+ * they provide.
+ *
+ * Usage:
+ *   // In @runanywhere/web-llamacpp:
+ *   import { ExtensionPoint, BackendCapability } from '@runanywhere/web';
+ *
+ *   ExtensionPoint.registerBackend({
+ *     id: 'llamacpp',
+ *     capabilities: [BackendCapability.LLM, BackendCapability.VLM, ...],
+ *     cleanup() { ... },
+ *   });
+ *
+ *   // In core (VoicePipeline, etc.) — runtime lookup:
+ *   const stt = ExtensionPoint.getExtensionForCapability(BackendCapability.STT);
+ */
+/** Capabilities that a backend can provide. */
+export declare enum BackendCapability {
+    LLM = "llm",
+    VLM = "vlm",
+    STT = "stt",
+    TTS = "tts",
+    VAD = "vad",
+    Embeddings = "embeddings",
+    Diffusion = "diffusion",
+    ToolCalling = "toolCalling",
+    StructuredOutput = "structuredOutput"
+}
+/**
+ * Typed service keys for cross-package singleton access.
+ *
+ * Backend packages register service instances (e.g. TextGeneration, STT, TTS)
+ * under these keys during their registration phase. Core code (e.g. VoicePipeline)
+ * retrieves them at runtime via `ExtensionPoint.getService(ServiceKey.XXX)` instead
+ * of relying on untyped globalThis keys.
+ */
+export declare enum ServiceKey {
+    TextGeneration = "textGeneration",
+    STT = "stt",
+    TTS = "tts",
+    VLM = "vlm",
+    Embeddings = "embeddings",
+    Diffusion = "diffusion",
+    ToolCalling = "toolCalling",
+    VAD = "vad"
+}
+/**
+ * Interface that every backend package must implement to register
+ * itself with the core SDK.
+ */
+export interface BackendExtension {
+    /** Unique backend identifier (e.g. 'llamacpp', 'onnx'). */
+    readonly id: string;
+    /** Capabilities this backend provides. */
+    readonly capabilities: BackendCapability[];
+    /**
+     * Release all resources held by this backend.
+     * Called during SDK shutdown in reverse registration order.
+     */
+    cleanup(): void;
+}
+declare class ExtensionPointImpl {
+    private backends;
+    private capabilityMap;
+    private services;
+    /**
+     * Register a backend extension.
+     * Idempotent — re-registering the same id is a no-op.
+     */
+    registerBackend(extension: BackendExtension): void;
+    /** Get a backend by its id. */
+    getBackend(id: string): BackendExtension | undefined;
+    /** Check if a capability is available (i.e. a backend providing it is registered). */
+    hasCapability(capability: BackendCapability): boolean;
+    /** Get the backend extension providing a given capability. */
+    getExtensionForCapability(capability: BackendCapability): BackendExtension | undefined;
+    /**
+     * Require that a capability is available. Throws a clear error if not.
+     * Use in extension methods that depend on a backend being registered.
+     */
+    requireCapability(capability: BackendCapability): void;
+    /**
+     * Register a service singleton under a typed key.
+     * Backend packages call this during their registration phase.
+     */
+    registerService<T>(key: ServiceKey, service: T): void;
+    /**
+     * Retrieve a registered service singleton.
+     * Returns undefined if the service is not registered yet.
+     */
+    getService<T>(key: ServiceKey): T | undefined;
+    /**
+     * Retrieve a registered service or throw a descriptive error.
+     * Use in code that requires a specific backend to be registered.
+     */
+    requireService<T>(key: ServiceKey, packageHint?: string): T;
+    /** Remove a registered service. */
+    removeService(key: ServiceKey): void;
+    /**
+     * Cleanup all registered backends in reverse registration order.
+     * Called during SDK shutdown.
+     */
+    cleanupAll(): void;
+    /** Reset the registry (call after full shutdown). */
+    reset(): void;
+}
+export declare const ExtensionPoint: ExtensionPointImpl;
+export {};
+//# sourceMappingURL=ExtensionPoint.d.ts.map

package/dist/Infrastructure/ExtensionPoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionPoint.d.ts","sourceRoot":"","sources":["../../src/Infrastructure/ExtensionPoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAUH,+CAA+C;AAC/C,oBAAY,iBAAiB;IAC3B,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,gBAAgB,qBAAqB;CACtC;AAED;;;;;;;GAOG;AACH,oBAAY,UAAU;IACpB,cAAc,mBAAmB;IACjC,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,GAAG,QAAQ;CACZ;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,0CAA0C;IAC1C,QAAQ,CAAC,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAE3C;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAMD,cAAM,kBAAkB;IACtB,OAAO,CAAC,QAAQ,CAA4C;IAC5D,OAAO,CAAC,aAAa,CAAuD;IAE5E,OAAO,CAAC,QAAQ,CAAmC;IAEnD;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI;IAqBlD,+BAA+B;IAC/B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIpD,sFAAsF;IACtF,aAAa,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO;IAIrD,8DAA8D;IAC9D,yBAAyB,CAAC,UAAU,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,SAAS;IAItF;;;OAGG;IACH,iBAAiB,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAsBtD;;;OAGG;IACH,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI;IAOrD;;;OAGG;IACH,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,GAAG,CAAC,GAAG,SAAS;IAI7C;;;OAGG;IACH,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,CAAC;IAe3D,mCAAmC;IACnC,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAIpC;;;OAGG;IACH,UAAU,IAAI,IAAI;IAYlB,qDAAqD;IACrD,KAAK,IAAI,IAAI;CAKd;AAED,eAAO,MAAM,cAAc,oBAA2B,CAAC"}