@glideidentity/web-client-sdk 4.4.8-beta.1

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

@@ -0,0 +1,174 @@
+/**
+ * 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 }; // Phone number is optional for GetPhoneNumber
+    }
+    // E.164 format validation - strict, no cleaning
+    const e164Regex = /^\+[1-9]\d{1,14}$/;
+    if (!phoneNumber.startsWith('+')) {
+        return {
+            valid: false,
+            error: 'Phone number must be in E.164 format (start with +)'
+        };
+    }
+    if (phoneNumber.length < 8) {
+        return {
+            valid: false,
+            error: 'Phone number too short for E.164 format (minimum 8 characters including +)'
+        };
+    }
+    if (phoneNumber.length > 16) {
+        return {
+            valid: false,
+            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,
+            error: 'Phone number contains invalid characters. E.164 format only allows + followed by digits'
+        };
+    }
+    if (!e164Regex.test(phoneNumber)) {
+        return {
+            valid: false,
+            error: 'Invalid E.164 phone number format'
+        };
+    }
+    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 }; // 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,
+            error: 'Phone number is required for VerifyPhoneNumber use case'
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Validates consent data
+ * @param consentData - Consent data object
+ * @returns Validation result
+ */
+export function validateConsentData(consentData) {
+    if (!consentData) {
+        return { valid: true }; // Consent data is optional
+    }
+    const { consent_text: consentText, policy_link: policyLink, policy_text: policyText } = consentData;
+    if (!consentText || consentText.trim().length === 0) {
+        return {
+            valid: false,
+            error: 'Consent text is required when consent data is provided'
+        };
+    }
+    if (!policyLink || policyLink.trim().length === 0) {
+        return {
+            valid: false,
+            error: 'Policy link is required when consent data is provided'
+        };
+    }
+    // Validate URL format for policy link
+    try {
+        new URL(policyLink);
+    }
+    catch (_a) {
+        return {
+            valid: false,
+            error: 'Policy link must be a valid URL'
+        };
+    }
+    if (!policyText || policyText.trim().length === 0) {
+        return {
+            valid: false,
+            error: 'Policy text is required when consent data is provided'
+        };
+    }
+    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;
+    if (field) {
+        error.field = field;
+    }
+    return error;
+}
+/**
+ * Validates nonce format
+ * @param nonce - Nonce string to validate
+ * @returns Validation result
+ */
+export function validateNonce(nonce) {
+    // Nonce should be base64url encoded and have reasonable length
+    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

@@ -0,0 +1,62 @@
+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;
+    };
+}
+export interface RequestOptions {
+    headers?: Record<string, string>;
+    params?: Record<string, any>;
+}
+export interface ClientResponse<T = any> {
+    data: T;
+    status: number;
+    headers: Record<string, string>;
+}

package/dist/esm/core/types.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1 @@
+export declare const SDK_VERSION = "__SDK_VERSION__";

package/dist/esm/core/version.js

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

package/dist/esm/index.d.ts

@@ -0,0 +1,12 @@
+export { PhoneAuthClient } from './core/phone-auth';
+export type { AuthConfig as PhoneAuthConfig, PhoneAuthOptions, PhoneAuthResult, AuthError as PhoneAuthError, AuthStep as PhoneAuthStep } from './core/phone-auth';
+export { PhoneAuthErrorCode, isPhoneAuthError, isUserError, getUserMessage, isErrorCode, getRetryDelay, isRetryableError, serializeError, createErrorBreadcrumb } from './core/phone-auth';
+export { isHeadlessResult, isCredential, isLinkStrategy, isTS43Strategy, isDesktopStrategy, getStrategy, requiresPolling, requiresUserAction } from './core/phone-auth';
+export type { PhoneAuthCallbacks, PLMN, SessionInfo, HeadlessResult, InvokeOptions, PrepareRequest, PrepareResponse, GetPhoneNumberRequest, GetPhoneNumberResponse, VerifyPhoneNumberRequest, VerifyPhoneNumberResponse, SecureCredentialRequest, SecureCredentialResponse, DigitalCredential, TS43Data, LinkData, DesktopData, ClientInfo, ConsentData, BrowserErrorType, BrowserErrorCodeType, BrowserNameType } from './core/phone-auth/types';
+export { USE_CASE as UseCase, AUTHENTICATION_STRATEGY as AuthenticationStrategy, BrowserError, BrowserErrorCode, BrowserName } from './core/phone-auth/types';
+export { DesktopHandler, showQRCodeModal, createQRCodeDisplay } from './core/phone-auth/strategies/desktop';
+export type { DesktopAuthOptions, DesktopAuthResult, PollingStatus, QRCodeData } from './core/phone-auth/strategies/desktop';
+export { useClient, usePhoneAuth } from './adapters/react';
+export { useClient as useVueClient, usePhoneAuth as useVuePhoneAuth } from './adapters/vue';
+export { ClientService, PhoneAuthService } from './adapters/angular';
+export { ClientManager, PhoneAuthManager } from './adapters/vanilla';

package/dist/esm/index.js

@@ -0,0 +1,15 @@
+// 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';
+// Phone Auth Type Guards and Helpers
+export { isHeadlessResult, isCredential, isLinkStrategy, isTS43Strategy, isDesktopStrategy, getStrategy, 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, showQRCodeModal, createQRCodeDisplay } 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';
+export { ClientManager, PhoneAuthManager } from './adapters/vanilla';

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { PhoneAuthClient } from './core/phone-auth';
+export type { AuthConfig as PhoneAuthConfig, PhoneAuthOptions, PhoneAuthResult, AuthError as PhoneAuthError, AuthStep as PhoneAuthStep } from './core/phone-auth';
+export { PhoneAuthErrorCode, isPhoneAuthError, isUserError, getUserMessage, isErrorCode, getRetryDelay, isRetryableError, serializeError, createErrorBreadcrumb } from './core/phone-auth';
+export { isHeadlessResult, isCredential, isLinkStrategy, isTS43Strategy, isDesktopStrategy, getStrategy, requiresPolling, requiresUserAction } from './core/phone-auth';
+export type { PhoneAuthCallbacks, PLMN, SessionInfo, HeadlessResult, InvokeOptions, PrepareRequest, PrepareResponse, GetPhoneNumberRequest, GetPhoneNumberResponse, VerifyPhoneNumberRequest, VerifyPhoneNumberResponse, SecureCredentialRequest, SecureCredentialResponse, DigitalCredential, TS43Data, LinkData, DesktopData, ClientInfo, ConsentData, BrowserErrorType, BrowserErrorCodeType, BrowserNameType } from './core/phone-auth/types';
+export { USE_CASE as UseCase, AUTHENTICATION_STRATEGY as AuthenticationStrategy, BrowserError, BrowserErrorCode, BrowserName } from './core/phone-auth/types';
+export { DesktopHandler, showQRCodeModal, createQRCodeDisplay } from './core/phone-auth/strategies/desktop';
+export type { DesktopAuthOptions, DesktopAuthResult, PollingStatus, QRCodeData } from './core/phone-auth/strategies/desktop';
+export { useClient, usePhoneAuth } from './adapters/react';
+export { useClient as useVueClient, usePhoneAuth as useVuePhoneAuth } from './adapters/vue';
+export { ClientService, PhoneAuthService } from './adapters/angular';
+export { ClientManager, PhoneAuthManager } from './adapters/vanilla';

package/dist/index.js

@@ -0,0 +1,52 @@
+"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.createQRCodeDisplay = exports.showQRCodeModal = exports.DesktopHandler = exports.BrowserName = exports.BrowserErrorCode = exports.BrowserError = exports.AuthenticationStrategy = exports.UseCase = exports.requiresUserAction = exports.requiresPolling = exports.getStrategy = exports.isDesktopStrategy = exports.isTS43Strategy = exports.isLinkStrategy = exports.isCredential = exports.isHeadlessResult = 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; } });
+Object.defineProperty(exports, "isUserError", { enumerable: true, get: function () { return phone_auth_2.isUserError; } });
+Object.defineProperty(exports, "getUserMessage", { enumerable: true, get: function () { return phone_auth_2.getUserMessage; } });
+Object.defineProperty(exports, "isErrorCode", { enumerable: true, get: function () { return phone_auth_2.isErrorCode; } });
+Object.defineProperty(exports, "getRetryDelay", { enumerable: true, get: function () { return phone_auth_2.getRetryDelay; } });
+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, "isHeadlessResult", { enumerable: true, get: function () { return phone_auth_3.isHeadlessResult; } });
+Object.defineProperty(exports, "isCredential", { enumerable: true, get: function () { return phone_auth_3.isCredential; } });
+Object.defineProperty(exports, "isLinkStrategy", { enumerable: true, get: function () { return phone_auth_3.isLinkStrategy; } });
+Object.defineProperty(exports, "isTS43Strategy", { enumerable: true, get: function () { return phone_auth_3.isTS43Strategy; } });
+Object.defineProperty(exports, "isDesktopStrategy", { enumerable: true, get: function () { return phone_auth_3.isDesktopStrategy; } });
+Object.defineProperty(exports, "getStrategy", { enumerable: true, get: function () { return phone_auth_3.getStrategy; } });
+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; } });
+Object.defineProperty(exports, "showQRCodeModal", { enumerable: true, get: function () { return desktop_1.showQRCodeModal; } });
+Object.defineProperty(exports, "createQRCodeDisplay", { enumerable: true, get: function () { return desktop_1.createQRCodeDisplay; } });
+// 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; } });
+var vue_1 = require("./adapters/vue");
+Object.defineProperty(exports, "useVueClient", { enumerable: true, get: function () { return vue_1.useClient; } });
+Object.defineProperty(exports, "useVuePhoneAuth", { enumerable: true, get: function () { return vue_1.usePhoneAuth; } });
+var angular_1 = require("./adapters/angular");
+Object.defineProperty(exports, "ClientService", { enumerable: true, get: function () { return angular_1.ClientService; } });
+Object.defineProperty(exports, "PhoneAuthService", { enumerable: true, get: function () { return angular_1.PhoneAuthService; } });
+var vanilla_1 = require("./adapters/vanilla");
+Object.defineProperty(exports, "ClientManager", { enumerable: true, get: function () { return vanilla_1.ClientManager; } });
+Object.defineProperty(exports, "PhoneAuthManager", { enumerable: true, get: function () { return vanilla_1.PhoneAuthManager; } });

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "@glideidentity/web-client-sdk",
+  "version": "4.4.8-beta.1",
+  "main": "./dist/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/index.d.ts",
+  "browser": "./dist/browser/web-client-sdk.min.js",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/index.js",
+      "browser": "./dist/browser/web-client-sdk.min.js",
+      "default": "./dist/index.js"
+    },
+    "./vue": {
+      "types": "./dist/adapters/vue/index.d.ts",
+      "import": "./dist/esm/adapters/vue/index.js",
+      "require": "./dist/adapters/vue/index.js",
+      "default": "./dist/adapters/vue/index.js"
+    },
+    "./react": {
+      "types": "./dist/adapters/react/index.d.ts",
+      "import": "./dist/esm/adapters/react/index.js",
+      "require": "./dist/adapters/react/index.js",
+      "default": "./dist/adapters/react/index.js"
+    },
+    "./angular": {
+      "types": "./dist/adapters/angular/index.d.ts",
+      "import": "./dist/esm/adapters/angular/index.js",
+      "require": "./dist/adapters/angular/index.js",
+      "default": "./dist/adapters/angular/index.js"
+    }
+  },
+  "scripts": {
+    "build": "npm run clean && npm run build:cjs && npm run build:esm && npm run build:browser && npm run inject-version",
+    "build:cjs": "tsc -p tsconfig.build.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:browser": "webpack",
+    "clean": "rm -rf dist",
+    "inject-version": "node scripts/inject-version.js",
+    "prepublishOnly": "npm run build",
+    "test": "jest"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "sdk",
+    "authentication",
+    "api",
+    "react",
+    "vue",
+    "angular"
+  ],
+  "peerDependencies": {
+    "@angular/core": "^15.0.0",
+    "react": "^18.0.0",
+    "vue": "^3.0.0"
+  },
+  "dependencies": {
+    "axios": "^1.7.9"
+  },
+  "devDependencies": {
+    "@angular/core": "^19.0.6",
+    "@testing-library/jest-dom": "^6.0.0",
+    "@testing-library/react": "^14.0.0",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^18.19.70",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "@vue/compiler-dom": "^3.5.13",
+    "@vue/runtime-dom": "^3.3.0",
+    "@vue/server-renderer": "^3.5.13",
+    "@vue/test-utils": "^2.4.0-alpha.2",
+    "@vue/vue3-jest": "^29.2.6",
+    "jest": "^29.0.0",
+    "jest-environment-jsdom": "^29.0.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "rxjs": "^7.8.1",
+    "ts-jest": "^29.2.5",
+    "ts-loader": "^9.5.1",
+    "typescript": "^5.9.2",
+    "vue": "^3.3.0",
+    "webpack": "^5.89.0",
+    "webpack-cli": "^5.1.4"
+  }
+}