@terminal3/t3n-sdk 0.7.0 → 0.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@terminal3/t3n-sdk",
-  "version": "0.7.0",
+  "version": "0.10.0",
   "type": "module",
   "description": "T3n TypeScript SDK - A minimal SDK that mirrors the server's RPC handler approach",
   "main": "dist/index.js",

package/dist/demo.d.ts

@@ -1,25 +0,0 @@
-/**
- * T3n SDK Real WASM Demo Script
- *
- * This script demonstrates the T3n SDK using the actual WASM component
- * built from the node session module.
- */
-import { SessionStatus, Did } from "./src/index";
-import { type ChildProcess } from "child_process";
-declare global {
-    var __oidcServerProcess: ChildProcess | undefined;
-}
-interface DemoResult {
-    sessionId: {
-        value: string;
-    };
-    status: SessionStatus;
-    wasmLoaded: boolean;
-    authenticated: boolean;
-    did: Did | null;
-}
-/**
- * Main Demo Function
- */
-declare function runRealWasmDemo(): Promise<DemoResult>;
-export { runRealWasmDemo, type DemoResult };

package/dist/src/client/actions.d.ts

@@ -1,22 +0,0 @@
-/**
- * WASM Action Creators
- *
- * Creates the initial action payloads for WASM state machines.
- * These are JSON-serialized and passed to the WASM component to start flows.
- */
-import { AuthInput } from "../types";
-/**
- * Create the initial handshake request
- * This kicks off the handshake state machine in WASM
- */
-export declare function createHandshakeAction(): Uint8Array;
-/**
- * Create the initial authentication request based on auth method
- * @param authInput - The authentication input (Ethereum or OIDC)
- */
-export declare function createAuthAction(authInput: AuthInput): Uint8Array;
-/**
- * Create the OIDC SubmitToken action for the second step of nonce-bound auth.
- * @param idToken - The id_token JWT obtained from the OIDC provider with the nonce
- */
-export declare function createOidcSubmitTokenAction(idToken: string): Uint8Array;

package/dist/src/client/encryption.d.ts

@@ -1,30 +0,0 @@
-/**
- * Session Encryption Service
- *
- * Handles encryption and decryption of data using the established WASM session.
- * Keeps cryptographic operations isolated and simple.
- */
-import { SessionCrypto } from "../wasm";
-import { Logger } from "../utils/logger";
-/**
- * Encrypts and decrypts data using an established session
- */
-export declare class SessionEncryption {
-    private sessionCrypto;
-    private logger;
-    constructor(sessionCrypto: SessionCrypto, logger: Logger);
-    /**
-     * Encrypt data using the session
-     * @param sessionState - The session state bytes (from handshake)
-     * @param data - The plaintext data to encrypt
-     * @returns Base64-encoded encrypted data
-     */
-    encrypt(sessionState: Uint8Array, data: Uint8Array): Promise<string>;
-    /**
-     * Decrypt data using the session
-     * @param sessionState - The session state bytes (from handshake)
-     * @param encryptedData - Base64-encoded encrypted data
-     * @returns Decrypted plaintext bytes
-     */
-    decrypt(sessionState: Uint8Array, encryptedData: string): Promise<Uint8Array>;
-}

package/dist/src/client/handlers.d.ts

@@ -1,73 +0,0 @@
-/**
- * Guest-to-Host Request Handlers
- *
- * These handle requests from WASM that need the host environment to perform side effects.
- * Examples: signing challenges, providing public keys, generating random bytes.
- */
-import { GuestToHostHandler, GuestToHostHandlers } from "../types";
-import { Logger } from "../utils/logger";
-/**
- * Account — MetaMask handler accepts either a plain address string or an
- * object with an `address` field (for compatibility with various wallet
- * libraries).
- */
-type EthAccount = string | {
-    address: string;
-};
-/**
- * Create an EthSign handler using MetaMask (window.ethereum)
- * @param account - MetaMask account (string address or object with address property)
- * @param logger - Optional logger instance. Defaults to a logger using the global log level (LogLevel.ERROR).
- *   Pass a custom logger to override logging behavior for this handler.
- * @param privateKey - Optional private key for signing (if provided, MetaMask is not used)
- */
-export declare function metamask_sign(account: EthAccount, logger?: Logger, privateKey?: string | undefined): GuestToHostHandler;
-/**
- * Get the current MetaMask address
- * @returns Ethereum address (lowercase, 0x prefixed)
- */
-export declare function metamask_get_address(): Promise<string>;
-/**
- * Get the address for a given private key
- * @param privateKey - Ethereum private key (0x prefixed hex string)
- * @returns Ethereum address (lowercase, 0x prefixed)
- */
-export declare function eth_get_address(privateKey: string): string;
-/**
- * Create an MlKemPublicKey handler that lazily fetches the root public key
- * from `${baseUrl}/status` on first invocation and caches the encoded
- * response for subsequent calls.
- *
- * @param baseUrl - **Required**. The node URL whose `/status` endpoint should
- *                  serve the ML-KEM public key. Must be the same URL the
- *                  T3nClient is constructed with — otherwise the handshake
- *                  encrypts to one node and sends ciphertext to another.
- *
- *                  Was optional in 0.3.x, where omitting it caused the lazy
- *                  fetch to silently fall back to `NODE_URLS[currentEnv]` and
- *                  hit the wrong node. Three downstream consumers (demo.ts,
- *                  t3-apps dev wallet hooks, t3n-mcp session manager) all
- *                  hit this trap before we tightened the type.
- */
-export declare function createMlKemPublicKeyHandler(baseUrl: string): GuestToHostHandler;
-/**
- * Create Random handler backed by crypto.getRandomValues
- * Note: The Rust Vec<u8> type serializes as an array of bytes, not a base64 string
- */
-export declare function createRandomHandler(): GuestToHostHandler;
-/**
- * Create the default handler set required by the T3n handshake.
- *
- * @param baseUrl - **Required**. Forwarded to `createMlKemPublicKeyHandler`
- *                  so the lazy /status fetch hits the right node.
- */
-export declare function createDefaultHandlers(baseUrl: string): GuestToHostHandlers;
-/**
- * Merge consumer-provided handlers with defaults (user handlers take precedence).
- *
- * @param handlers - Optional consumer overrides.
- * @param baseUrl  - **Required**. Forwarded to the default handler set so the
- *                   ML-KEM key fetch hits the right node.
- */
-export declare function mergeWithDefaultHandlers(handlers: GuestToHostHandlers | undefined, baseUrl: string): GuestToHostHandlers;
-export {};

package/dist/src/client/request-parser.d.ts

@@ -1,48 +0,0 @@
-/**
- * WASM Request Parser
- *
- * Parses and categorizes requests from the WASM state machine.
- * The WASM component outputs JSON with a `guest_to_host` tag that determines
- * how the SDK should handle the request.
- *
- * See node/session/src/abi.rs for the GuestToHost enum definition.
- */
-/**
- * Types of requests that can come from WASM
- */
-export declare enum WasmRequestType {
-    /** Send data to remote server (PeerReply with action) */
-    SendRemote = "SendRemote",
-    /** Request to host (SDK) for side effects (MlKemPublicKey, Random, EthSign, etc.) */
-    GuestToHost = "GuestToHost",
-    /** Flow complete (Suspend) */
-    Suspend = "Suspend"
-}
-/**
- * Parsed result from WASM request
- */
-export interface ParsedRequest {
-    type: WasmRequestType;
-    data: Record<string, unknown>;
-    raw: string;
-}
-/**
- * Parses WASM request bytes into a categorized request type
- */
-export declare function parseWasmRequest(requestBytes: Uint8Array): ParsedRequest;
-/**
- * Check if a request should be sent to the remote server
- */
-export declare function isSendRemote(parsed: ParsedRequest): boolean;
-/**
- * Check if a request indicates flow completion
- */
-export declare function isCompletion(parsed: ParsedRequest): boolean;
-/**
- * Check if a request needs a guest-to-host handler
- */
-export declare function isGuestToHost(parsed: ParsedRequest): boolean;
-/**
- * Get the guest-to-host request type name (e.g., "MlKemPublicKey", "Random", "EthSign")
- */
-export declare function getGuestToHostType(parsed: ParsedRequest): string | null;

package/dist/wasm/generated/interfaces/component-session-client-auth.d.ts

@@ -1,12 +0,0 @@
-/** @module Interface component:session/client-auth@0.1.0 **/
-export function next(state: State | undefined, action: HostToGuest): NewState;
-export function finish(state: State): Did;
-export type GuestToHost = Uint8Array;
-export type State = Uint8Array;
-export type HostToGuest = Uint8Array;
-export type Did = Uint8Array;
-export type Error = Uint8Array;
-export interface NewState {
-  state: State,
-  request: GuestToHost,
-}

package/dist/wasm/generated/interfaces/component-session-client-handshake.d.ts

@@ -1,12 +0,0 @@
-/** @module Interface component:session/client-handshake@0.1.0 **/
-export function next(state: State | undefined, action: HostToGuest): NewState;
-export function finish(state: State): SessionState;
-export type GuestToHost = Uint8Array;
-export type State = Uint8Array;
-export type HostToGuest = Uint8Array;
-export type SessionState = Uint8Array;
-export type Error = Uint8Array;
-export interface NewState {
-  state: State,
-  request: GuestToHost,
-}

package/dist/wasm/generated/interfaces/component-session-cookie.d.ts

@@ -1,8 +0,0 @@
-/** @module Interface component:session/cookie@0.1.0 **/
-export function validate(cookieValue: string, teeAddress: Uint8Array, nowSec: bigint): Validation;
-export interface Validation {
-  authenticated: boolean,
-  did?: string,
-  exp: bigint,
-}
-export type Error = Uint8Array;

package/dist/wasm/generated/interfaces/component-session-server-auth.d.ts

@@ -1,13 +0,0 @@
-/** @module Interface component:session/server-auth@0.1.0 **/
-export function next(state: State | undefined, action: HostToGuest, policy: SiwePolicy): NewState;
-export function finish(state: State): Did;
-export type GuestToHost = Uint8Array;
-export type State = Uint8Array;
-export type HostToGuest = Uint8Array;
-export type SiwePolicy = Uint8Array;
-export type Did = Uint8Array;
-export type Error = Uint8Array;
-export interface NewState {
-  state: State,
-  request: GuestToHost,
-}

package/dist/wasm/generated/interfaces/component-session-server-handshake.d.ts

@@ -1,12 +0,0 @@
-/** @module Interface component:session/server-handshake@0.1.0 **/
-export function next(state: State | undefined, action: HostToGuest): NewState;
-export function finish(state: State): SessionState;
-export type GuestToHost = Uint8Array;
-export type State = Uint8Array;
-export type HostToGuest = Uint8Array;
-export type SessionState = Uint8Array;
-export type Error = Uint8Array;
-export interface NewState {
-  state: State,
-  request: GuestToHost,
-}

package/dist/wasm/generated/interfaces/component-session-session.d.ts

@@ -1,7 +0,0 @@
-/** @module Interface component:session/session@0.1.0 **/
-export function encrypt(session: Session, plaintext: Plaintext): Ciphertext;
-export function decrypt(session: Session, ciphertext: Ciphertext): Plaintext;
-export type Error = Uint8Array;
-export type Session = Uint8Array;
-export type Plaintext = Uint8Array;
-export type Ciphertext = Uint8Array;