@bsv/wallet-toolbox 2.4.3 → 2.4.20

package/out/src/wab-client/WABTransport.js

@@ -0,0 +1,420 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WABTransport = exports.WABClientError = void 0;
+const sdk_1 = require("@bsv/sdk");
+const DEFAULT_TIMEOUT_MS = 10_000;
+const DEFAULT_MAX_REQUEST_BYTES = 1024 * 1024;
+const DEFAULT_MAX_RESPONSE_BYTES = 1024 * 1024;
+const MAX_CONFIGURED_TIMEOUT_MS = 120_000;
+const MAX_CONFIGURED_REQUEST_BYTES = 10 * 1024 * 1024;
+const MAX_CONFIGURED_RESPONSE_BYTES = 10 * 1024 * 1024;
+const defaultFetch = typeof globalThis !== 'undefined' && typeof globalThis.fetch === 'function'
+    ? globalThis.fetch.bind(globalThis)
+    : undefined;
+/**
+ * A privacy-safe WAB transport failure. Response bodies and request payloads
+ * are deliberately excluded from the error.
+ */
+class WABClientError extends Error {
+    code;
+    retryable;
+    status;
+    constructor(code, message, retryable, status, options = {}) {
+        super(message, options);
+        this.code = code;
+        this.retryable = retryable;
+        this.status = status;
+        this.name = 'WABClientError';
+        this.correlationId = options.correlationId;
+        this.operation = options.operation;
+        this.route = options.route;
+        this.endpointMarkerPresent = options.endpointMarkerPresent;
+        this.responseCorrelationMatched = options.responseCorrelationMatched;
+    }
+    correlationId;
+    operation;
+    route;
+    endpointMarkerPresent;
+    responseCorrelationMatched;
+}
+exports.WABClientError = WABClientError;
+function isLocalHostname(hostname) {
+    const normalized = hostname.toLowerCase();
+    return normalized === 'localhost' ||
+        normalized === '127.0.0.1' ||
+        normalized === '[::1]' ||
+        normalized.endsWith('.localhost');
+}
+function normalizeServerUrl(serverUrl) {
+    let parsed;
+    try {
+        parsed = new URL(serverUrl);
+    }
+    catch {
+        throw new WABClientError('WAB_INVALID_CONFIGURATION', 'WAB server URL must be an absolute URL.', false);
+    }
+    if (parsed.username !== '' || parsed.password !== '' || parsed.search !== '' || parsed.hash !== '') {
+        throw new WABClientError('WAB_INVALID_CONFIGURATION', 'WAB server URL must not contain credentials, a query, or a fragment.', false);
+    }
+    if (parsed.protocol !== 'https:' && !(parsed.protocol === 'http:' && isLocalHostname(parsed.hostname))) {
+        throw new WABClientError('WAB_INVALID_CONFIGURATION', 'WAB server URL must use HTTPS. Plain HTTP is allowed only for localhost development.', false);
+    }
+    let pathname = parsed.pathname;
+    while (pathname.endsWith('/')) {
+        pathname = pathname.slice(0, -1);
+    }
+    return {
+        baseUrl: `${parsed.origin}${pathname}`,
+        origin: parsed.origin
+    };
+}
+function normalizePositiveInteger(value, fallback, maximum, name) {
+    const resolved = value ?? fallback;
+    if (!Number.isInteger(resolved) || resolved <= 0 || resolved > maximum) {
+        throw new WABClientError('WAB_INVALID_CONFIGURATION', `${name} must be a positive integer no greater than ${maximum}.`, false);
+    }
+    return resolved;
+}
+function assertSafePath(path) {
+    if (!/^\/[a-zA-Z0-9/_-]*$/.test(path) || path.includes('..')) {
+        throw new WABClientError('WAB_INVALID_REQUEST', 'Invalid WAB endpoint path.', false);
+    }
+}
+function isRetryableStatus(status) {
+    return status === 408 || status === 425 || status === 429 || status >= 500;
+}
+function isSafeCorrelationId(value) {
+    return /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/.test(value);
+}
+function isWabResponse(response) {
+    return response.headers.get('X-WAB-Service')?.toLowerCase() === 'wab-server';
+}
+/**
+ * Centralized, bounded transport used by every WAB client operation.
+ *
+ * Only fixed endpoint metadata is reported. Request bodies and response bodies
+ * never cross the telemetry boundary.
+ */
+class WABTransport {
+    serverUrl;
+    serverOrigin;
+    telemetry;
+    fetchClient;
+    timeoutMs;
+    maxRequestBytes;
+    maxResponseBytes;
+    constructor(serverUrl, options = {}) {
+        const normalized = normalizeServerUrl(serverUrl);
+        this.serverUrl = normalized.baseUrl;
+        this.serverOrigin = normalized.origin;
+        const fetchClient = options.fetch ?? defaultFetch;
+        if (typeof fetchClient !== 'function') {
+            throw new WABClientError('WAB_INVALID_CONFIGURATION', 'WABClient requires a fetch implementation.', false);
+        }
+        this.fetchClient = fetchClient;
+        this.timeoutMs = normalizePositiveInteger(options.timeoutMs, DEFAULT_TIMEOUT_MS, MAX_CONFIGURED_TIMEOUT_MS, 'timeoutMs');
+        this.maxRequestBytes = normalizePositiveInteger(options.maxRequestBytes, DEFAULT_MAX_REQUEST_BYTES, MAX_CONFIGURED_REQUEST_BYTES, 'maxRequestBytes');
+        this.maxResponseBytes = normalizePositiveInteger(options.maxResponseBytes, DEFAULT_MAX_RESPONSE_BYTES, MAX_CONFIGURED_RESPONSE_BYTES, 'maxResponseBytes');
+        this.telemetry = new sdk_1.Telemetry(options.telemetry);
+    }
+    createCorrelationId() {
+        const correlationId = this.telemetry.createCorrelationId();
+        return isSafeCorrelationId(correlationId)
+            ? correlationId
+            : new sdk_1.Telemetry().createCorrelationId();
+    }
+    async request(path, options) {
+        const metadata = this.createRequestMetadata(path, options);
+        this.captureRequestStarted(metadata);
+        const body = this.encodeRequestBody(options, metadata);
+        const timeout = this.startRequestTimeout(metadata.errorContext);
+        const response = await this.fetchResponse(metadata, body, timeout);
+        const responseContext = this.createResponseContext(response, metadata);
+        this.assertSuccessfulResponse(response, responseContext, metadata, timeout);
+        const responseText = await this.readResponseText(response, responseContext, metadata, timeout);
+        const parsed = this.parseResponseObject(responseText, response, responseContext, metadata);
+        this.telemetry.capture({
+            name: 'wallet-toolbox.wab.request.completed',
+            component: 'wallet-toolbox.wab-transport',
+            severity: 'info',
+            correlationId: metadata.correlationId,
+            attributes: {
+                operation: metadata.operation,
+                method: metadata.method,
+                route: metadata.path,
+                serverOrigin: this.serverOrigin,
+                status: response.status,
+                endpointMarkerPresent: responseContext.endpointMarkerPresent,
+                responseCorrelationMatched: responseContext.responseCorrelationMatched,
+                responseBytes: new TextEncoder().encode(responseText).byteLength,
+                durationMs: Date.now() - metadata.startedAt
+            }
+        });
+        return parsed;
+    }
+    createRequestMetadata(path, options) {
+        assertSafePath(path);
+        const correlationId = options.correlationId != null &&
+            isSafeCorrelationId(options.correlationId)
+            ? options.correlationId
+            : this.createCorrelationId();
+        return {
+            method: options.method ?? 'POST',
+            path,
+            operation: options.operation,
+            correlationId,
+            startedAt: Date.now(),
+            errorContext: {
+                correlationId,
+                operation: options.operation,
+                route: path
+            }
+        };
+    }
+    captureRequestStarted(metadata) {
+        this.telemetry.capture({
+            name: 'wallet-toolbox.wab.request.started',
+            component: 'wallet-toolbox.wab-transport',
+            severity: 'debug',
+            correlationId: metadata.correlationId,
+            attributes: {
+                operation: metadata.operation,
+                method: metadata.method,
+                route: metadata.path,
+                serverOrigin: this.serverOrigin
+            }
+        });
+    }
+    encodeRequestBody(options, metadata) {
+        let body;
+        try {
+            body = options.body === undefined ? undefined : JSON.stringify(options.body);
+        }
+        catch (cause) {
+            const error = new WABClientError('WAB_INVALID_REQUEST', 'WAB request payload could not be encoded.', false, undefined, { ...metadata.errorContext, cause });
+            this.captureRequestFailure(metadata, error);
+            throw error;
+        }
+        if (options.body !== undefined && body === undefined) {
+            const error = new WABClientError('WAB_INVALID_REQUEST', 'WAB request payload must be JSON-serializable.', false, undefined, metadata.errorContext);
+            this.captureRequestFailure(metadata, error);
+            throw error;
+        }
+        if (body != null && new TextEncoder().encode(body).byteLength > this.maxRequestBytes) {
+            const error = new WABClientError('WAB_REQUEST_TOO_LARGE', 'WAB request exceeded the configured size limit.', false, undefined, metadata.errorContext);
+            this.captureRequestFailure(metadata, error);
+            throw error;
+        }
+        return body;
+    }
+    startRequestTimeout(errorContext) {
+        const timeout = {
+            controller: new AbortController(),
+            timedOut: false
+        };
+        timeout.promise = new Promise((_resolve, reject) => {
+            timeout.timer = setTimeout(() => {
+                timeout.timedOut = true;
+                timeout.controller.abort();
+                reject(new WABClientError('WAB_TIMEOUT', 'WAB request timed out.', true, undefined, errorContext));
+            }, this.timeoutMs);
+        });
+        return timeout;
+    }
+    async fetchResponse(metadata, body, timeout) {
+        const requestPromise = Promise.resolve().then(() => this.fetchClient(`${this.serverUrl}${metadata.path}`, {
+            method: metadata.method,
+            headers: {
+                Accept: 'application/json',
+                ...(body !== undefined ? { 'Content-Type': 'application/json' } : {}),
+                'X-Correlation-ID': metadata.correlationId
+            },
+            ...(body !== undefined ? { body } : {}),
+            signal: timeout.controller.signal,
+            credentials: 'omit',
+            redirect: 'error',
+            referrerPolicy: 'no-referrer'
+        }));
+        requestPromise.catch(() => { });
+        try {
+            return await Promise.race([requestPromise, timeout.promise]);
+        }
+        catch (cause) {
+            if (timeout.timer !== undefined)
+                clearTimeout(timeout.timer);
+            let error;
+            if (cause instanceof WABClientError) {
+                error = cause;
+            }
+            else if (timeout.timedOut) {
+                error = new WABClientError('WAB_TIMEOUT', 'WAB request timed out.', true, undefined, { ...metadata.errorContext, cause });
+            }
+            else {
+                error = new WABClientError('WAB_NETWORK_ERROR', 'WAB request failed before receiving a response.', true, undefined, { ...metadata.errorContext, cause });
+            }
+            this.captureRequestFailure(metadata, error);
+            throw error;
+        }
+    }
+    createResponseContext(response, metadata) {
+        return {
+            ...metadata.errorContext,
+            endpointMarkerPresent: isWabResponse(response),
+            responseCorrelationMatched: response.headers.get('X-Correlation-ID') === metadata.correlationId
+        };
+    }
+    assertSuccessfulResponse(response, responseContext, metadata, timeout) {
+        if (response.ok)
+            return;
+        if (timeout.timer !== undefined)
+            clearTimeout(timeout.timer);
+        const endpointMismatch = response.status === 404 &&
+            responseContext.endpointMarkerPresent !== true;
+        const error = new WABClientError(endpointMismatch ? 'WAB_ENDPOINT_MISMATCH' : 'WAB_HTTP_ERROR', endpointMismatch
+            ? 'Configured WAB endpoint did not return a compatible WAB response.'
+            : `WAB request failed with HTTP status ${response.status}.`, isRetryableStatus(response.status), response.status, responseContext);
+        this.captureRequestFailure(metadata, error);
+        void response.body?.cancel().catch(() => { });
+        throw error;
+    }
+    async readResponseText(response, responseContext, metadata, timeout) {
+        try {
+            return await Promise.race([
+                this.readBoundedResponse(response, responseContext),
+                timeout.promise
+            ]);
+        }
+        catch (cause) {
+            let error;
+            if (cause instanceof WABClientError) {
+                error = cause;
+            }
+            else if (timeout.timedOut) {
+                error = new WABClientError('WAB_TIMEOUT', 'WAB request timed out.', true, response.status, { ...responseContext, cause });
+            }
+            else {
+                error = new WABClientError('WAB_INVALID_RESPONSE', 'WAB response could not be read.', true, response.status, { ...responseContext, cause });
+            }
+            this.captureRequestFailure(metadata, error);
+            throw error;
+        }
+        finally {
+            if (timeout.timer !== undefined)
+                clearTimeout(timeout.timer);
+        }
+    }
+    parseResponseObject(responseText, response, responseContext, metadata) {
+        let parsed;
+        try {
+            parsed = JSON.parse(responseText);
+        }
+        catch (cause) {
+            const error = new WABClientError('WAB_INVALID_RESPONSE', 'WAB response was not valid JSON.', true, response.status, { ...responseContext, cause });
+            this.captureRequestFailure(metadata, error);
+            throw error;
+        }
+        if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            const error = new WABClientError('WAB_INVALID_RESPONSE', 'WAB response must be a JSON object.', true, response.status, responseContext);
+            this.captureRequestFailure(metadata, error);
+            throw error;
+        }
+        return parsed;
+    }
+    captureRequestFailure(metadata, error) {
+        this.captureFailure(metadata.operation, metadata.method, metadata.path, metadata.correlationId, metadata.startedAt, error);
+    }
+    async readBoundedResponse(response, responseContext) {
+        await this.rejectOversizedDeclaredResponse(response, responseContext);
+        const reader = response.body?.getReader();
+        if (reader == null) {
+            return await this.readBoundedArrayBuffer(response, responseContext);
+        }
+        return await this.readBoundedStream(reader, response, responseContext);
+    }
+    async rejectOversizedDeclaredResponse(response, responseContext) {
+        const contentLength = Number(response.headers.get('content-length'));
+        if (!Number.isFinite(contentLength) || contentLength <= this.maxResponseBytes)
+            return;
+        await this.cancelResponseBody(response);
+        throw this.responseTooLargeError(response, responseContext);
+    }
+    async readBoundedArrayBuffer(response, responseContext) {
+        const bytes = new Uint8Array(await response.arrayBuffer());
+        if (bytes.byteLength > this.maxResponseBytes) {
+            throw this.responseTooLargeError(response, responseContext);
+        }
+        return new TextDecoder().decode(bytes);
+    }
+    async readBoundedStream(reader, response, responseContext) {
+        const chunks = [];
+        let total = 0;
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            if (value == null)
+                continue;
+            total += value.byteLength;
+            if (total > this.maxResponseBytes) {
+                await this.cancelResponseReader(reader);
+                throw this.responseTooLargeError(response, responseContext);
+            }
+            chunks.push(value);
+        }
+        return this.decodeChunks(chunks, total);
+    }
+    decodeChunks(chunks, total) {
+        const bytes = new Uint8Array(total);
+        let offset = 0;
+        for (const chunk of chunks) {
+            bytes.set(chunk, offset);
+            offset += chunk.byteLength;
+        }
+        return new TextDecoder().decode(bytes);
+    }
+    responseTooLargeError(response, responseContext) {
+        return new WABClientError('WAB_RESPONSE_TOO_LARGE', 'WAB response exceeded the configured size limit.', false, response.status, responseContext);
+    }
+    async cancelResponseBody(response) {
+        try {
+            await response.body?.cancel();
+        }
+        catch {
+            // Best effort only.
+        }
+    }
+    async cancelResponseReader(reader) {
+        try {
+            await reader.cancel();
+        }
+        catch {
+            // Best effort only.
+        }
+    }
+    captureFailure(operation, method, path, correlationId, startedAt, error) {
+        this.telemetry.capture({
+            name: 'wallet-toolbox.wab.request.failed',
+            component: 'wallet-toolbox.wab-transport',
+            severity: error.retryable ? 'warn' : 'error',
+            correlationId,
+            attributes: {
+                operation,
+                method,
+                route: path,
+                serverOrigin: this.serverOrigin,
+                retryable: error.retryable,
+                ...(error.status !== undefined ? { status: error.status } : {}),
+                ...(error.endpointMarkerPresent !== undefined
+                    ? { endpointMarkerPresent: error.endpointMarkerPresent }
+                    : {}),
+                ...(error.responseCorrelationMatched !== undefined
+                    ? { responseCorrelationMatched: error.responseCorrelationMatched }
+                    : {}),
+                durationMs: Date.now() - startedAt
+            },
+            error
+        });
+    }
+}
+exports.WABTransport = WABTransport;
+//# sourceMappingURL=WABTransport.js.map

package/out/src/wab-client/WABTransport.js.map

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

package/out/src/wab-client/auth-method-interactors/AuthMethodInteractor.d.ts

@@ -1,21 +1,20 @@
-/**
- * AuthMethodInteractor
- *
- * A base interface/class for client-side logic to interact with a server
- * for a specific Auth Method's flow (start, complete).
- */
+import { WABTransport } from '../WABTransport';
 export interface AuthPayload {
-    [key: string]: any;
+    [key: string]: unknown;
 }
 export interface StartAuthResponse {
     success: boolean;
     message?: string;
-    data?: any;
+    data?: unknown;
 }
 export interface CompleteAuthResponse {
     success: boolean;
     message?: string;
     presentationKey?: string;
+    /** Preferred explicit continuity signal for newer WAB servers. */
+    accountStatus?: 'new-user' | 'existing-user';
+    /** Compatibility signal accepted from WAB deployments using a boolean. */
+    existingUser?: boolean;
 }
 /**
  * Abstract client-side interactor for an Auth Method.
@@ -25,6 +24,7 @@ export interface CompleteAuthResponse {
  */
 export declare abstract class AuthMethodInteractor {
     abstract methodType: string;
+    protected preparePayload(payload: AuthPayload): AuthPayload;
     /**
      * Shared POST helper for auth endpoints.
      */
@@ -32,10 +32,10 @@ export declare abstract class AuthMethodInteractor {
     /**
      * Start the flow (e.g. request an OTP or create a session).
      */
-    startAuth(serverUrl: string, presentationKey: string, payload: AuthPayload): Promise<StartAuthResponse>;
+    startAuth(serverUrl: string, presentationKey: string, payload: AuthPayload, transport?: WABTransport, correlationId?: string): Promise<StartAuthResponse>;
     /**
      * Complete the flow (e.g. confirm OTP).
      */
-    completeAuth(serverUrl: string, presentationKey: string, payload: AuthPayload): Promise<CompleteAuthResponse>;
+    completeAuth(serverUrl: string, presentationKey: string, payload: AuthPayload, transport?: WABTransport, correlationId?: string): Promise<CompleteAuthResponse>;
 }
 //# sourceMappingURL=AuthMethodInteractor.d.ts.map

package/out/src/wab-client/auth-method-interactors/AuthMethodInteractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AuthMethodInteractor.d.ts","sourceRoot":"","sources":["../../../../src/wab-client/auth-method-interactors/AuthMethodInteractor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,GAAG,CAAA;CACX;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;;;;GAKG;AACH,8BAAsB,oBAAoB;IACxC,SAAgB,UAAU,EAAE,MAAM,CAAA;IAElC;;OAEG;YACW,QAAQ;IAuBtB;;OAEG;IACU,SAAS,CAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIrH;;OAEG;IACU,YAAY,CACvB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,oBAAoB,CAAC;CAGjC"}
+{"version":3,"file":"AuthMethodInteractor.d.ts","sourceRoot":"","sources":["../../../../src/wab-client/auth-method-interactors/AuthMethodInteractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,kEAAkE;IAClE,aAAa,CAAC,EAAE,UAAU,GAAG,eAAe,CAAA;IAC5C,0EAA0E;IAC1E,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED;;;;;GAKG;AACH,8BAAsB,oBAAoB;IACxC,SAAgB,UAAU,EAAE,MAAM,CAAA;IAElC,SAAS,CAAC,cAAc,CAAE,OAAO,EAAE,WAAW,GAAG,WAAW,CAE3D;IAED;;OAEG;YACW,QAAQ;IAoBtB;;OAEG;IACU,SAAS,CACpB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,WAAW,EACpB,SAAS,CAAC,EAAE,YAAY,EACxB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAS5B;IAED;;OAEG;IACU,YAAY,CACvB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,WAAW,EACpB,SAAS,CAAC,EAAE,YAAY,EACxB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,oBAAoB,CAAC,CAS/B;CACF"}

package/out/src/wab-client/auth-method-interactors/AuthMethodInteractor.js

@@ -1,12 +1,7 @@
 "use strict";
-/**
- * AuthMethodInteractor
- *
- * A base interface/class for client-side logic to interact with a server
- * for a specific Auth Method's flow (start, complete).
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AuthMethodInteractor = void 0;
+const WABTransport_1 = require("../WABTransport");
 /**
  * Abstract client-side interactor for an Auth Method.
  *
@@ -14,35 +9,35 @@ exports.AuthMethodInteractor = void 0;
  * `/auth/start` and `/auth/complete` are handled here.
  */
 class AuthMethodInteractor {
+    preparePayload(payload) {
+        return payload;
+    }
     /**
      * Shared POST helper for auth endpoints.
      */
-    async postAuth(serverUrl, endpoint, presentationKey, payload) {
-        const res = await fetch(`${serverUrl}/auth/${endpoint}`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({
+    async postAuth(serverUrl, endpoint, presentationKey, payload, transport, correlationId) {
+        const client = transport ?? new WABTransport_1.WABTransport(serverUrl);
+        return await client.request(`/auth/${endpoint}`, {
+            operation: `auth-${endpoint}`,
+            correlationId,
+            body: {
                 methodType: this.methodType,
                 presentationKey,
-                payload
-            })
+                payload: this.preparePayload(payload)
+            }
         });
-        if (!res.ok) {
-            return { success: false, message: `HTTP error ${res.status}` };
-        }
-        return await res.json();
     }
     /**
      * Start the flow (e.g. request an OTP or create a session).
      */
-    async startAuth(serverUrl, presentationKey, payload) {
-        return await this.postAuth(serverUrl, 'start', presentationKey, payload);
+    async startAuth(serverUrl, presentationKey, payload, transport, correlationId) {
+        return await this.postAuth(serverUrl, 'start', presentationKey, payload, transport, correlationId);
     }
     /**
      * Complete the flow (e.g. confirm OTP).
      */
-    async completeAuth(serverUrl, presentationKey, payload) {
-        return await this.postAuth(serverUrl, 'complete', presentationKey, payload);
+    async completeAuth(serverUrl, presentationKey, payload, transport, correlationId) {
+        return await this.postAuth(serverUrl, 'complete', presentationKey, payload, transport, correlationId);
     }
 }
 exports.AuthMethodInteractor = AuthMethodInteractor;

package/out/src/wab-client/auth-method-interactors/AuthMethodInteractor.js.map

@@ -1 +1 @@
-{"version":3,"file":"AuthMethodInteractor.js","sourceRoot":"","sources":["../../../../src/wab-client/auth-method-interactors/AuthMethodInteractor.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAkBH;;;;;GAKG;AACH,MAAsB,oBAAoB;IAGxC;;OAEG;IACK,KAAK,CAAC,QAAQ,CACpB,SAAiB,EACjB,QAAgB,EAChB,eAAuB,EACvB,OAAoB;QAEpB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,SAAS,SAAS,QAAQ,EAAE,EAAE;YACvD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,eAAe;gBACf,OAAO;aACR,CAAC;SACH,CAAC,CAAA;QAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,GAAG,CAAC,MAAM,EAAE,EAAO,CAAA;QACrE,CAAC;QAED,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;IACzB,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,SAAS,CAAE,SAAiB,EAAE,eAAuB,EAAE,OAAoB;QACtF,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAoB,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,CAAA;IAC7F,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,YAAY,CACvB,SAAiB,EACjB,eAAuB,EACvB,OAAoB;QAEpB,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAuB,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,CAAC,CAAA;IACnG,CAAC;CACF;AA9CD,oDA8CC"}
+{"version":3,"file":"AuthMethodInteractor.js","sourceRoot":"","sources":["../../../../src/wab-client/auth-method-interactors/AuthMethodInteractor.ts"],"names":[],"mappings":";;;AAAA,kDAA8C;AAsB9C;;;;;GAKG;AACH;IAGY,cAAc,CAAE,OAAoB;QAC5C,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,QAAQ,CACpB,SAAiB,EACjB,QAAgB,EAChB,eAAuB,EACvB,OAAoB,EACpB,SAAwB,EACxB,aAAsB;QAEtB,MAAM,MAAM,GAAG,SAAS,IAAI,IAAI,2BAAY,CAAC,SAAS,CAAC,CAAA;QACvD,OAAO,MAAM,MAAM,CAAC,OAAO,CAAI,SAAS,QAAQ,EAAE,EAAE;YAClD,SAAS,EAAE,QAAQ,QAAQ,EAAE;YAC7B,aAAa;YACb,IAAI,EAAE;gBACJ,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,eAAe;gBACf,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC;aACtC;SACF,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,SAAS,CACpB,SAAiB,EACjB,eAAuB,EACvB,OAAoB,EACpB,SAAwB,EACxB,aAAsB;QAEtB,OAAO,MAAM,IAAI,CAAC,QAAQ,CACxB,SAAS,EACT,OAAO,EACP,eAAe,EACf,OAAO,EACP,SAAS,EACT,aAAa,CACd,CAAA;IACH,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,YAAY,CACvB,SAAiB,EACjB,eAAuB,EACvB,OAAoB,EACpB,SAAwB,EACxB,aAAsB;QAEtB,OAAO,MAAM,IAAI,CAAC,QAAQ,CACxB,SAAS,EACT,UAAU,EACV,eAAe,EACf,OAAO,EACP,SAAS,EACT,aAAa,CACd,CAAA;IACH,CAAC;CACF"}

package/out/src/wab-client/auth-method-interactors/DevConsoleInteractor.js.map

@@ -1 +1 @@
-{"version":3,"file":"DevConsoleInteractor.js","sourceRoot":"","sources":["../../../../src/wab-client/auth-method-interactors/DevConsoleInteractor.ts"],"names":[],"mappings":";;;AAAA,iEAA6D;AAE7D;;;;;GAKG;AACH,MAAa,oBAAqB,SAAQ,2CAAoB;IACrD,UAAU,GAAG,YAAY,CAAA;CACjC;AAFD,oDAEC"}
+{"version":3,"file":"DevConsoleInteractor.js","sourceRoot":"","sources":["../../../../src/wab-client/auth-method-interactors/DevConsoleInteractor.ts"],"names":[],"mappings":";;;AAAA,iEAA6D;AAE7D;;;;;GAKG;AACH,0BAAkC,SAAQ,2CAAoB;IACrD,UAAU,GAAG,YAAY,CAAA;CACjC"}

package/out/src/wab-client/auth-method-interactors/PersonaIDInteractor.js.map

@@ -1 +1 @@
-{"version":3,"file":"PersonaIDInteractor.js","sourceRoot":"","sources":["../../../../src/wab-client/auth-method-interactors/PersonaIDInteractor.ts"],"names":[],"mappings":";;;AAAA,iEAA6D;AAE7D,MAAa,mBAAoB,SAAQ,2CAAoB;IACpD,UAAU,GAAG,WAAW,CAAA;CAChC;AAFD,kDAEC"}
+{"version":3,"file":"PersonaIDInteractor.js","sourceRoot":"","sources":["../../../../src/wab-client/auth-method-interactors/PersonaIDInteractor.ts"],"names":[],"mappings":";;;AAAA,iEAA6D;AAE7D,yBAAiC,SAAQ,2CAAoB;IACpD,UAAU,GAAG,WAAW,CAAA;CAChC"}

package/out/src/wab-client/auth-method-interactors/TwilioPhoneInteractor.d.ts

@@ -1,4 +1,4 @@
-import { AuthMethodInteractor } from './AuthMethodInteractor';
+import { AuthMethodInteractor, AuthPayload } from './AuthMethodInteractor';
 /**
  * TwilioPhoneInteractor
  *
@@ -6,5 +6,6 @@ import { AuthMethodInteractor } from './AuthMethodInteractor';
  */
 export declare class TwilioPhoneInteractor extends AuthMethodInteractor {
     methodType: string;
+    protected preparePayload(payload: AuthPayload): AuthPayload;
 }
 //# sourceMappingURL=TwilioPhoneInteractor.d.ts.map

package/out/src/wab-client/auth-method-interactors/TwilioPhoneInteractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TwilioPhoneInteractor.d.ts","sourceRoot":"","sources":["../../../../src/wab-client/auth-method-interactors/TwilioPhoneInteractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAE7D;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,oBAAoB;IACtD,UAAU,SAAgB;CAClC"}
+{"version":3,"file":"TwilioPhoneInteractor.d.ts","sourceRoot":"","sources":["../../../../src/wab-client/auth-method-interactors/TwilioPhoneInteractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAE1E;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,oBAAoB;IACtD,UAAU,SAAgB;IAEjC,UAAmB,cAAc,CAAE,OAAO,EAAE,WAAW,GAAG,WAAW,CAapE;CACF"}

package/out/src/wab-client/auth-method-interactors/TwilioPhoneInteractor.js

@@ -9,6 +9,20 @@ const AuthMethodInteractor_1 = require("./AuthMethodInteractor");
  */
 class TwilioPhoneInteractor extends AuthMethodInteractor_1.AuthMethodInteractor {
     methodType = 'TwilioPhone';
+    preparePayload(payload) {
+        const phoneNumber = payload.phoneNumber;
+        if (typeof phoneNumber !== 'string') {
+            throw new TypeError('TwilioPhone authentication requires phoneNumber.');
+        }
+        const normalized = phoneNumber.trim();
+        if (!/^\+[1-9]\d{7,14}$/.test(normalized)) {
+            throw new TypeError('phoneNumber must use canonical E.164 format.');
+        }
+        return {
+            ...payload,
+            phoneNumber: normalized
+        };
+    }
 }
 exports.TwilioPhoneInteractor = TwilioPhoneInteractor;
 //# sourceMappingURL=TwilioPhoneInteractor.js.map

package/out/src/wab-client/auth-method-interactors/TwilioPhoneInteractor.js.map

@@ -1 +1 @@
-{"version":3,"file":"TwilioPhoneInteractor.js","sourceRoot":"","sources":["../../../../src/wab-client/auth-method-interactors/TwilioPhoneInteractor.ts"],"names":[],"mappings":";;;AAAA,iEAA6D;AAE7D;;;;GAIG;AACH,MAAa,qBAAsB,SAAQ,2CAAoB;IACtD,UAAU,GAAG,aAAa,CAAA;CAClC;AAFD,sDAEC"}
+{"version":3,"file":"TwilioPhoneInteractor.js","sourceRoot":"","sources":["../../../../src/wab-client/auth-method-interactors/TwilioPhoneInteractor.ts"],"names":[],"mappings":";;;AAAA,iEAA0E;AAE1E;;;;GAIG;AACH,2BAAmC,SAAQ,2CAAoB;IACtD,UAAU,GAAG,aAAa,CAAA;IAEd,cAAc,CAAE,OAAoB;QACrD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAA;QACvC,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,SAAS,CAAC,kDAAkD,CAAC,CAAA;QACzE,CAAC;QACD,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,EAAE,CAAA;QACrC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAA;QACrE,CAAC;QACD,OAAO;YACL,GAAG,OAAO;YACV,WAAW,EAAE,UAAU;SACxB,CAAA;IACH,CAAC;CACF"}