@glideidentity/web-client-sdk 5.0.1 → 5.1.1-beta.1

package/dist/esm/core/phone-auth/validation-utils.d.ts

@@ -1,22 +1,44 @@
+/**
+ * Validation utilities for phone authentication
+ */
 import { PhoneAuthErrorCode } from './error-utils';
 import type { PLMN, UseCase } from './api-types';
+/**
+ * Validates E.164 phone number format
+ * @param phoneNumber - Phone number to validate
+ * @returns Validation result with error if invalid
+ */
 export declare function validatePhoneNumber(phoneNumber?: string): {
     valid: boolean;
     error?: string;
 };
+/**
+ * Validates PLMN (MCC/MNC) values
+ * @param plmn - PLMN object with MCC and MNC
+ * @returns Validation result
+ */
 export declare function validatePlmn(plmn?: PLMN): {
     valid: boolean;
     error?: string;
 };
+/**
+ * Validates use case and phone number combination
+ * @param useCase - The use case
+ * @param phoneNumber - The phone number (required for VerifyPhoneNumber)
+ * @param hasParentSessionId - Whether parent_session_id is provided (allows skipping normal validation)
+ * @returns Validation result
+ */
 export declare function validateUseCaseRequirements(useCase: UseCase, phoneNumber?: string, hasParentSessionId?: boolean): {
     valid: boolean;
     error?: string;
 };
+/**
+ * Creates a validation error
+ * @param code - Error code
+ * @param message - Error message
+ * @param field - Field that failed validation
+ */
 export declare function createValidationError(code: PhoneAuthErrorCode, message: string, field?: string): Error & {
     code: PhoneAuthErrorCode;
     field?: string;
 };
-export declare function validateNonce(nonce: string): {
-    valid: boolean;
-    error?: string;
-};

package/dist/esm/core/phone-auth/validation-utils.js

@@ -1,8 +1,17 @@
+/**
+ * Validation utilities for phone authentication
+ */
 import { USE_CASE } from './api-types';
+/**
+ * Validates E.164 phone number format
+ * @param phoneNumber - Phone number to validate
+ * @returns Validation result with error if invalid
+ */
 export function validatePhoneNumber(phoneNumber) {
     if (!phoneNumber) {
-        return { valid: true };
+        return { valid: true }; // Phone number is optional for GetPhoneNumber
     }
+    // E.164 format validation - strict, no cleaning
     const e164Regex = /^\+[1-9]\d{1,14}$/;
     if (!phoneNumber.startsWith('+')) {
         return {
@@ -22,6 +31,7 @@ export function validatePhoneNumber(phoneNumber) {
             error: 'Phone number too long for E.164 format (maximum 15 digits after +)'
         };
     }
+    // Check for any invalid characters (spaces, dashes, parentheses, etc.)
     if (!/^\+\d+$/.test(phoneNumber)) {
         return {
             valid: false,
@@ -36,26 +46,42 @@ export function validatePhoneNumber(phoneNumber) {
     }
     return { valid: true };
 }
+/**
+ * Validates PLMN (MCC/MNC) values
+ * @param plmn - PLMN object with MCC and MNC
+ * @returns Validation result
+ */
 export function validatePlmn(plmn) {
     if (!plmn) {
-        return { valid: true };
+        return { valid: true }; // PLMN is optional
     }
     const { mcc, mnc } = plmn;
+    // MCC validation (3 digits) - no range check for telco labs
     if (!mcc || !/^\d{3}$/.test(mcc)) {
         return {
             valid: false,
             error: 'MCC must be exactly 3 digits'
         };
     }
+    // MNC validation (2 or 3 digits)
     if (!mnc || !/^\d{2,3}$/.test(mnc)) {
         return {
             valid: false,
             error: 'MNC must be 2 or 3 digits'
         };
     }
+    // No range validation - allowing unofficial MCCs for telco labs
     return { valid: true };
 }
+/**
+ * Validates use case and phone number combination
+ * @param useCase - The use case
+ * @param phoneNumber - The phone number (required for VerifyPhoneNumber)
+ * @param hasParentSessionId - Whether parent_session_id is provided (allows skipping normal validation)
+ * @returns Validation result
+ */
 export function validateUseCaseRequirements(useCase, phoneNumber, hasParentSessionId) {
+    // VerifyPhoneNumber requires a phone number (unless parent_session_id is provided)
     if (useCase === USE_CASE.VERIFY_PHONE_NUMBER && !phoneNumber && !hasParentSessionId) {
         return {
             valid: false,
@@ -64,6 +90,12 @@ export function validateUseCaseRequirements(useCase, phoneNumber, hasParentSessi
     }
     return { valid: true };
 }
+/**
+ * Creates a validation error
+ * @param code - Error code
+ * @param message - Error message
+ * @param field - Field that failed validation
+ */
 export function createValidationError(code, message, field) {
     const error = new Error(message);
     error.code = code;
@@ -72,25 +104,3 @@ export function createValidationError(code, message, field) {
     }
     return error;
 }
-export function validateNonce(nonce) {
-    const base64urlRegex = /^[A-Za-z0-9_-]+$/;
-    if (!nonce || nonce.length === 0) {
-        return {
-            valid: false,
-            error: 'Nonce is required'
-        };
-    }
-    if (!base64urlRegex.test(nonce)) {
-        return {
-            valid: false,
-            error: 'Nonce must be base64url encoded'
-        };
-    }
-    if (nonce.length < 32 || nonce.length > 128) {
-        return {
-            valid: false,
-            error: 'Nonce must be between 32 and 128 characters'
-        };
-    }
-    return { valid: true };
-}

package/dist/esm/core/types.d.ts

@@ -1,16 +1,51 @@
 import { LogLevel, Logger } from './logger';
 export interface ClientConfig {
+    /**
+     * Base URL for API requests
+     * Required only if using useQuery() or client.get() methods
+     * Not required for phone authentication
+     */
     baseURL?: string;
+    /**
+     * API key for authentication
+     * Currently not used in the SDK but kept for backward compatibility
+     */
     apiKey?: string;
+    /**
+     * Request timeout in milliseconds
+     * @default 10000
+     */
     timeout?: number;
+    /**
+     * Target origin for authentication
+     * Used for cross-origin authentication flows
+     * If not provided, uses baseURL or current origin
+     */
     authTargetOrigin?: string;
+    /**
+     * Phone authentication endpoints
+     * If not provided, uses default endpoints relative to baseURL
+     */
     phoneAuthEndpoints?: {
         prepareRequest: string;
         processResponse: string;
     };
+    /**
+     * Enable debug logging
+     * @default false
+     */
     debug?: boolean;
+    /**
+     * Set specific log level
+     */
     logLevel?: LogLevel;
+    /**
+     * Custom logger implementation
+     */
     logger?: Logger;
+    /**
+     * Remote logging configuration
+     */
     remoteLogging?: {
         endpoint: string;
         apiKey: string;

package/dist/esm/core/version.js

@@ -1 +1,2 @@
-export const SDK_VERSION = '5.0.1';
+// SDK version - injected at build time
+export const SDK_VERSION = '5.1.1-beta.1';

package/dist/esm/index.js

@@ -1,8 +1,16 @@
+// Phone Authentication
 export { PhoneAuthClient } from './core/phone-auth';
+// Phone Auth Error Utilities
 export { PhoneAuthErrorCode, isPhoneAuthError, isUserError, getUserMessage, isErrorCode, getRetryDelay, isRetryableError, serializeError, createErrorBreadcrumb } from './core/phone-auth';
-export { isExtendedResponse, isCredential, isAuthCredential, isLinkStrategy, isTS43Strategy, isDesktopStrategy, getStrategy, hasPollingControls, hasTrigger, isHeadlessResult, requiresPolling, requiresUserAction } from './core/phone-auth';
+// Phone Auth Type Guards and Helpers
+export { isExtendedResponse, isCredential, isAuthCredential, isLinkStrategy, isTS43Strategy, isDesktopStrategy, getStrategy, hasPollingControls, hasTrigger, 
+// Deprecated aliases
+isHeadlessResult, requiresPolling, requiresUserAction } from './core/phone-auth';
+// Export constants for use case and strategy
 export { USE_CASE as UseCase, AUTHENTICATION_STRATEGY as AuthenticationStrategy, BrowserError, BrowserErrorCode, BrowserName } from './core/phone-auth/types';
+// Desktop Strategy Exports
 export { DesktopHandler } from './core/phone-auth/strategies/desktop';
+// Adapters
 export { useClient, usePhoneAuth } from './adapters/react';
 export { useClient as useVueClient, usePhoneAuth as useVuePhoneAuth } from './adapters/vue';
 export { ClientService, PhoneAuthService } from './adapters/angular';

package/dist/index.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PhoneAuthManager = exports.ClientManager = exports.PhoneAuthService = exports.ClientService = exports.useVuePhoneAuth = exports.useVueClient = exports.usePhoneAuth = exports.useClient = exports.DesktopHandler = exports.BrowserName = exports.BrowserErrorCode = exports.BrowserError = exports.AuthenticationStrategy = exports.UseCase = exports.requiresUserAction = exports.requiresPolling = exports.isHeadlessResult = exports.hasTrigger = exports.hasPollingControls = exports.getStrategy = exports.isDesktopStrategy = exports.isTS43Strategy = exports.isLinkStrategy = exports.isAuthCredential = exports.isCredential = exports.isExtendedResponse = exports.createErrorBreadcrumb = exports.serializeError = exports.isRetryableError = exports.getRetryDelay = exports.isErrorCode = exports.getUserMessage = exports.isUserError = exports.isPhoneAuthError = exports.PhoneAuthErrorCode = exports.PhoneAuthClient = void 0;
+// Phone Authentication
 var phone_auth_1 = require("./core/phone-auth");
 Object.defineProperty(exports, "PhoneAuthClient", { enumerable: true, get: function () { return phone_auth_1.PhoneAuthClient; } });
+// Phone Auth Error Utilities
 var phone_auth_2 = require("./core/phone-auth");
 Object.defineProperty(exports, "PhoneAuthErrorCode", { enumerable: true, get: function () { return phone_auth_2.PhoneAuthErrorCode; } });
 Object.defineProperty(exports, "isPhoneAuthError", { enumerable: true, get: function () { return phone_auth_2.isPhoneAuthError; } });
@@ -13,6 +15,7 @@ Object.defineProperty(exports, "getRetryDelay", { enumerable: true, get: functio
 Object.defineProperty(exports, "isRetryableError", { enumerable: true, get: function () { return phone_auth_2.isRetryableError; } });
 Object.defineProperty(exports, "serializeError", { enumerable: true, get: function () { return phone_auth_2.serializeError; } });
 Object.defineProperty(exports, "createErrorBreadcrumb", { enumerable: true, get: function () { return phone_auth_2.createErrorBreadcrumb; } });
+// Phone Auth Type Guards and Helpers
 var phone_auth_3 = require("./core/phone-auth");
 Object.defineProperty(exports, "isExtendedResponse", { enumerable: true, get: function () { return phone_auth_3.isExtendedResponse; } });
 Object.defineProperty(exports, "isCredential", { enumerable: true, get: function () { return phone_auth_3.isCredential; } });
@@ -23,17 +26,21 @@ Object.defineProperty(exports, "isDesktopStrategy", { enumerable: true, get: fun
 Object.defineProperty(exports, "getStrategy", { enumerable: true, get: function () { return phone_auth_3.getStrategy; } });
 Object.defineProperty(exports, "hasPollingControls", { enumerable: true, get: function () { return phone_auth_3.hasPollingControls; } });
 Object.defineProperty(exports, "hasTrigger", { enumerable: true, get: function () { return phone_auth_3.hasTrigger; } });
+// Deprecated aliases
 Object.defineProperty(exports, "isHeadlessResult", { enumerable: true, get: function () { return phone_auth_3.isHeadlessResult; } });
 Object.defineProperty(exports, "requiresPolling", { enumerable: true, get: function () { return phone_auth_3.requiresPolling; } });
 Object.defineProperty(exports, "requiresUserAction", { enumerable: true, get: function () { return phone_auth_3.requiresUserAction; } });
+// Export constants for use case and strategy
 var types_1 = require("./core/phone-auth/types");
 Object.defineProperty(exports, "UseCase", { enumerable: true, get: function () { return types_1.USE_CASE; } });
 Object.defineProperty(exports, "AuthenticationStrategy", { enumerable: true, get: function () { return types_1.AUTHENTICATION_STRATEGY; } });
 Object.defineProperty(exports, "BrowserError", { enumerable: true, get: function () { return types_1.BrowserError; } });
 Object.defineProperty(exports, "BrowserErrorCode", { enumerable: true, get: function () { return types_1.BrowserErrorCode; } });
 Object.defineProperty(exports, "BrowserName", { enumerable: true, get: function () { return types_1.BrowserName; } });
+// Desktop Strategy Exports
 var desktop_1 = require("./core/phone-auth/strategies/desktop");
 Object.defineProperty(exports, "DesktopHandler", { enumerable: true, get: function () { return desktop_1.DesktopHandler; } });
+// Adapters
 var react_1 = require("./adapters/react");
 Object.defineProperty(exports, "useClient", { enumerable: true, get: function () { return react_1.useClient; } });
 Object.defineProperty(exports, "usePhoneAuth", { enumerable: true, get: function () { return react_1.usePhoneAuth; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glideidentity/web-client-sdk",
-  "version": "5.0.1",
+  "version": "5.1.1-beta.1",
   "main": "./dist/index.js",
   "module": "./dist/esm/index.js",
   "types": "./dist/index.d.ts",

package/dist/browser/web-client-sdk.min.js.LICENSE.txt

@@ -1 +0,0 @@
-/*! Axios v1.13.2 Copyright (c) 2025 Matt Zabriskie and contributors */