@bsv/wallet-toolbox-mobile 2.4.3 → 2.4.4

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

@@ -0,0 +1,300 @@
+"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';
+    }
+}
+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);
+    }
+    parsed.pathname = parsed.pathname.replace(/\/+$/, '');
+    return parsed;
+}
+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;
+}
+/**
+ * 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 parsed = normalizeServerUrl(serverUrl);
+        this.serverUrl = `${parsed.origin}${parsed.pathname}`;
+        this.serverOrigin = parsed.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() {
+        return this.telemetry.enabled ? this.telemetry.createCorrelationId() : undefined;
+    }
+    async request(path, options) {
+        assertSafePath(path);
+        const method = options.method ?? 'POST';
+        const correlationId = options.correlationId ?? this.createCorrelationId();
+        const startedAt = Date.now();
+        const controller = new AbortController();
+        let timer;
+        let timedOut = false;
+        this.telemetry.capture({
+            name: 'wallet-toolbox.wab.request.started',
+            component: 'wallet-toolbox.wab-transport',
+            severity: 'debug',
+            correlationId,
+            attributes: {
+                operation: options.operation,
+                method,
+                route: path,
+                serverOrigin: this.serverOrigin
+            }
+        });
+        let body;
+        try {
+            body = options.body === undefined ? undefined : JSON.stringify(options.body);
+        }
+        catch (error) {
+            const normalized = new WABClientError('WAB_INVALID_REQUEST', 'WAB request payload could not be encoded.', false, undefined, { cause: error });
+            this.captureFailure(options.operation, method, path, correlationId, startedAt, normalized);
+            throw normalized;
+        }
+        if (options.body !== undefined && body === undefined) {
+            const error = new WABClientError('WAB_INVALID_REQUEST', 'WAB request payload must be JSON-serializable.', false);
+            this.captureFailure(options.operation, method, path, correlationId, startedAt, error);
+            throw error;
+        }
+        if (body !== undefined && new TextEncoder().encode(body).byteLength > this.maxRequestBytes) {
+            const error = new WABClientError('WAB_REQUEST_TOO_LARGE', 'WAB request exceeded the configured size limit.', false);
+            this.captureFailure(options.operation, method, path, correlationId, startedAt, error);
+            throw error;
+        }
+        const requestPromise = new Promise((resolve) => {
+            resolve(this.fetchClient(`${this.serverUrl}${path}`, {
+                method,
+                headers: {
+                    Accept: 'application/json',
+                    ...(body !== undefined ? { 'Content-Type': 'application/json' } : {}),
+                    ...(correlationId !== undefined ? { 'X-Correlation-ID': correlationId } : {})
+                },
+                ...(body !== undefined ? { body } : {}),
+                signal: controller.signal,
+                credentials: 'omit',
+                redirect: 'error',
+                referrerPolicy: 'no-referrer'
+            }));
+        });
+        requestPromise.catch(() => { });
+        const timeoutPromise = new Promise((_resolve, reject) => {
+            timer = setTimeout(() => {
+                timedOut = true;
+                controller.abort();
+                reject(new WABClientError('WAB_TIMEOUT', 'WAB request timed out.', true));
+            }, this.timeoutMs);
+        });
+        let response;
+        try {
+            response = await Promise.race([requestPromise, timeoutPromise]);
+        }
+        catch (error) {
+            if (timer !== undefined)
+                clearTimeout(timer);
+            const normalized = error instanceof WABClientError
+                ? error
+                : new WABClientError(timedOut ? 'WAB_TIMEOUT' : 'WAB_NETWORK_ERROR', timedOut ? 'WAB request timed out.' : 'WAB request failed before receiving a response.', true, undefined, { cause: error });
+            this.captureFailure(options.operation, method, path, correlationId, startedAt, normalized);
+            throw normalized;
+        }
+        if (!response.ok) {
+            if (timer !== undefined)
+                clearTimeout(timer);
+            const error = new WABClientError('WAB_HTTP_ERROR', `WAB request failed with HTTP status ${response.status}.`, isRetryableStatus(response.status), response.status);
+            this.captureFailure(options.operation, method, path, correlationId, startedAt, error);
+            void response.body?.cancel().catch(() => { });
+            throw error;
+        }
+        let responseText;
+        try {
+            responseText = await Promise.race([
+                this.readBoundedResponse(response),
+                timeoutPromise
+            ]);
+        }
+        catch (error) {
+            const normalized = error instanceof WABClientError
+                ? error
+                : new WABClientError(timedOut ? 'WAB_TIMEOUT' : 'WAB_INVALID_RESPONSE', timedOut ? 'WAB request timed out.' : 'WAB response could not be read.', true, response.status, { cause: error });
+            this.captureFailure(options.operation, method, path, correlationId, startedAt, normalized);
+            throw normalized;
+        }
+        finally {
+            if (timer !== undefined)
+                clearTimeout(timer);
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(responseText);
+        }
+        catch (error) {
+            const normalized = new WABClientError('WAB_INVALID_RESPONSE', 'WAB response was not valid JSON.', true, response.status, { cause: error });
+            this.captureFailure(options.operation, method, path, correlationId, startedAt, normalized);
+            throw normalized;
+        }
+        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);
+            this.captureFailure(options.operation, method, path, correlationId, startedAt, error);
+            throw error;
+        }
+        this.telemetry.capture({
+            name: 'wallet-toolbox.wab.request.completed',
+            component: 'wallet-toolbox.wab-transport',
+            severity: 'info',
+            correlationId,
+            attributes: {
+                operation: options.operation,
+                method,
+                route: path,
+                serverOrigin: this.serverOrigin,
+                status: response.status,
+                responseBytes: new TextEncoder().encode(responseText).byteLength,
+                durationMs: Date.now() - startedAt
+            }
+        });
+        return parsed;
+    }
+    async readBoundedResponse(response) {
+        const contentLength = Number(response.headers.get('content-length'));
+        if (Number.isFinite(contentLength) && contentLength > this.maxResponseBytes) {
+            try {
+                await response.body?.cancel();
+            }
+            catch {
+                // Best effort only.
+            }
+            throw new WABClientError('WAB_RESPONSE_TOO_LARGE', 'WAB response exceeded the configured size limit.', false, response.status);
+        }
+        const reader = response.body?.getReader();
+        if (reader == null) {
+            const bytes = new Uint8Array(await response.arrayBuffer());
+            if (bytes.byteLength > this.maxResponseBytes) {
+                throw new WABClientError('WAB_RESPONSE_TOO_LARGE', 'WAB response exceeded the configured size limit.', false, response.status);
+            }
+            return new TextDecoder().decode(bytes);
+        }
+        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) {
+                try {
+                    await reader.cancel();
+                }
+                catch {
+                    // Best effort only.
+                }
+                throw new WABClientError('WAB_RESPONSE_TOO_LARGE', 'WAB response exceeded the configured size limit.', false, response.status);
+            }
+            chunks.push(value);
+        }
+        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);
+    }
+    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 } : {}),
+                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;IAI5D;;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;IAW7B;;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;CAUjC"}

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,MAAsB,oBAAoB;IAG9B,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;AArED,oDAqEC"}

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;cAEd,cAAc,CAAE,OAAO,EAAE,WAAW,GAAG,WAAW;CActE"}

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][0-9]{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,MAAa,qBAAsB,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,sBAAsB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAA;QACrE,CAAC;QACD,OAAO;YACL,GAAG,OAAO;YACV,WAAW,EAAE,UAAU;SACxB,CAAA;IACH,CAAC;CACF;AAjBD,sDAiBC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bsv/wallet-toolbox-mobile",
-  "version": "2.4.3",
+  "version": "2.4.4",
   "description": "Client only Wallet Storage",
   "main": "./out/src/index.mobile.js",
   "types": "./out/src/index.mobile.d.ts",
@@ -22,7 +22,7 @@
   "homepage": "https://github.com/bsv-blockchain/ts-stack/tree/main/packages/wallet/wallet-toolbox/mobile#readme",
   "dependencies": {
     "hash-wasm": "^4.12.0",
-    "idb": "^8.0.2"
+    "idb": "^8.0.3"
   },
   "peerDependencies": {
     "@bsv/sdk": "^2.1.8"
@@ -33,6 +33,11 @@
     }
   },
   "devDependencies": {
-    "@bsv/sdk": "^2.1.3"
+    "@types/node": "^26.1.1",
+    "typescript": "^6.0.3",
+    "@bsv/sdk": "^2.2.0"
+  },
+  "scripts": {
+    "build": "tsc --build ../tsconfig.mobile.json"
   }
 }