@terminal3/t3n-sdk 0.7.0 → 0.10.0

package/dist/src/wasm/loader.d.ts

@@ -1,43 +1,73 @@
 /**
- * WASM Component Loader
+ * WASM Component Loader — async direct-call shape.
  *
- * This module provides utilities for loading and initializing the WASM component.
- * The actual WASM loading implementation will depend on the build system and
- * deployment environment.
+ * Loads the `tee:session@1.0.0` jco-transpiled component. Host
+ * imports (`host:session-interfaces/*`) are supplied at
+ * instantiation; the caller can override any of them via
+ * `WasmLoadConfig.hostImports` to plug a custom KEM public-key
+ * source, ETH signer, etc. Defaults cover the common case for the
+ * browser SDK:
+ *
+ *   - `entropy.random`:        WebCrypto `getRandomValues`
+ *   - `kem.mlKemPublicKey`:    HTTP fetch of /pubkey (caller sets URL)
+ *   - `kem.decapsulate`:       server-only; client-side stub returns error
+ *   - `eth-signer.eth-sign`:   injected wallet (window.ethereum) if present
+ *   - `session-ops.now-ms`:    Date.now()
+ *   - `session-ops.tee-address`, `set-cookie`: caller-supplied or stubs
  */
 import { WasmComponent } from "./interface";
 import { Logger } from "../utils/logger";
+/**
+ * Host imports supplied at WASM instantiation. Any subset may be
+ * overridden by the caller; unset ones fall back to a safe default
+ * (or an error stub for server-only methods like `decapsulate`).
+ */
+export interface SessionHostImports {
+    /** Fetch the server's ML-KEM public key (client-side). */
+    mlKemPublicKey?: () => Uint8Array | Promise<Uint8Array>;
+    /** CSPRNG. Defaults to WebCrypto `getRandomValues`. */
+    random?: (len: number) => Uint8Array;
+    /** EIP-191 / SIWE signer. Defaults to error (caller must supply). */
+    ethSign?: (message: Uint8Array) => Uint8Array | Promise<Uint8Array>;
+    /**
+     * OIDC user-interaction callback. The contract supplies the
+     * server-bound `nonce`; the SDK consumer runs whatever popup /
+     * redirect flow is appropriate for `provider` and returns the
+     * IdP-signed `id_token`. Defaults to error (caller must supply
+     * when using OIDC auth).
+     */
+    getIdToken?: (provider: string, nonce: string) => string | Promise<string>;
+    /** Current time in ms. Defaults to Date.now() (as bigint). */
+    nowMs?: () => bigint;
+    /** TEE address — server-only; client stub returns 20 zero bytes. */
+    teeAddress?: () => Uint8Array;
+    /** Called when the guest emits a refreshed cookie. */
+    setCookie?: (value: string) => void;
+    /**
+     * HTTP transport the contract uses to POST JSON-RPC requests. The
+     * SDK wires this to its `Transport` under the hood — the contract
+     * supplies the method name and params bytes; the SDK layers on the
+     * Session-Id header, JSON-RPC envelope, and returns the raw result
+     * bytes.
+     */
+    postRpc?: (method: string, sessionId: string, params: string) => string | Promise<string>;
+}
 /**
  * Configuration for WASM component loading
  */
 export interface WasmLoadConfig {
     /** Path or URL to the WASM module */
     wasmPath?: string;
-    /** Custom fetch function for loading WASM */
-    fetchFn?: typeof fetch;
-    /** Additional initialization options */
-    initOptions?: Record<string, unknown>;
     /** Optional logger instance - if not provided, uses global default */
     logger?: Logger;
+    /** Overrides for the host-import functions. */
+    hostImports?: SessionHostImports;
 }
 /**
- * Load and initialize the T3n WASM component
+ * Load and initialize the T3n WASM component (async direct-call).
  *
- * @param config - Optional configuration for loading the WASM component
- * @returns Promise that resolves to the initialized WASM component
- *
- * @example
- * ```typescript
- * const wasmComponent = await loadWasmComponent({
- *   wasmPath: '/path/to/t3n.wasm'
- * });
- * ```
+ * The caller normally only needs to override `mlKemPublicKey` (to
+ * point at the node URL) and `ethSign` (to bridge to the browser
+ * wallet). All other imports have sensible defaults.
  */
 export declare function loadWasmComponent(config?: WasmLoadConfig): Promise<WasmComponent>;
-/**
- * Load the real T3n WASM component
- *
- * @param logger - Logger instance for WASM operations
- * @returns Promise that resolves to the initialized WASM component
- */
-export declare function loadRealWasmComponent(logger: Logger): Promise<WasmComponent>;