@basis-theory/web-elements 2.11.2 → 3.0.0-beta.2

package/dist/web-elements/src/types.d.ts

@@ -0,0 +1,537 @@
+/**
+ * Type definitions for @basis-theory/web-elements
+ */
+import type { TokenIntent } from '@basis-theory-elements/api-client';
+import type { ElementType } from './types/events';
+import type { ThemeMode, ThemeTokens } from './types/theme';
+export type { TokenIntent };
+/**
+ * Transform pattern for modifying input before tokenization
+ * [pattern, replacement] - uses String.prototype.replace(pattern, replacement)
+ *
+ * @example
+ * // Remove dashes from SSN: "123-45-6789" → "123456789"
+ * const ssnTransform: Transform = [/-/g, ''];
+ *
+ * @example
+ * // Remove all non-digits from phone: "(555) 123-4567" → "5551234567"
+ * const phoneTransform: Transform = [/\D/g, ''];
+ */
+export type Transform = [RegExp, string];
+export interface SDKOptions {
+    /**
+     * Base URL where element iframes are hosted
+     * FRD-2026-003: Now defaults to production CDN (build-time injected, environment-specific)
+     * @default 'https://js.basistheory.com/{version}/elements' (production)
+     * @example 'http://localhost:4243' (for local development)
+     */
+    elementsBaseUrl?: string;
+    /**
+     * @deprecated Use `elementsBaseUrl` instead
+     * Origin of the iframe host (where element.html is served)
+     */
+    iframeOrigin?: string;
+    /**
+     * API base URL for tokenization and API operations
+     * Auto-detects based on page origin by default:
+     * - localhost/flock-dev.com → https://js.flock-dev.com/api (dev)
+     * - btsandbox.com → https://js.btsandbox.com/api (uat)
+     * - basistheory.com → https://js.basistheory.com/api (prod)
+     * - other origins → https://js.basistheory.com/api (prod default)
+     *
+     * Override for:
+     * - Testing against custom API environments
+     * - Corporate proxies routing API calls
+     * - Regional API endpoints
+     *
+     * @default Auto-detected based on window.location.origin
+     * @example 'https://api-proxy.company.com/basistheory'
+     */
+    apiBaseUrl?: string;
+    /**
+     * Enable debug logging
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Enable performance monitoring (bundle size, load times, compression metrics)
+     * When enabled, automatically measures and logs performance after elements load
+     * @default false
+     */
+    measurePerformance?: boolean;
+    /**
+     * PostMessage timeout (milliseconds)
+     * Increase this for slow network connections (3G, etc.)
+     * @default 30000
+     */
+    timeoutMs?: number;
+    /**
+     * PostMessage retry configuration
+     */
+    retryConfig?: {
+        maxRetries: number;
+        delayMs: number;
+        backoffFactor: number;
+    };
+    /**
+     * Theme mode: 'light', 'dark', or 'auto' (follows prefers-color-scheme)
+     * @default 'auto'
+     */
+    themeMode?: ThemeMode;
+    /**
+     * Theme configuration (design tokens)
+     * CSS variables will be injected into element iframes
+     *
+     * Supports light/dark themes via themeMode or separate theme/darkTheme objects
+     *
+     * @example
+     * ```typescript
+     * theme: {
+     *   colors: {
+     *     primary: '#007bff',
+     *     error: '#EA4B97',
+     *     text: '#1a1a1a',
+     *   },
+     *   typography: {
+     *     fontFamily: 'Inter, sans-serif',
+     *     fontSize: { base: '16px' },
+     *     fontWeight: { normal: '400' },
+     *   },
+     *   spacing: { sm: '8px', md: '12px', lg: '16px' },
+     *   borders: {
+     *     radius: { base: '4px' },
+     *     width: { base: '2px' },
+     *   },
+     * }
+     * ```
+     */
+    theme?: ThemeTokens;
+    /**
+     * Optional dark theme configuration
+     * Used when themeMode is 'dark' or 'auto' in dark mode
+     *
+     * If not provided, will use theme with adjusted colors for dark mode
+     */
+    darkTheme?: ThemeTokens;
+}
+export interface SDKConfig {
+    iframeOrigin: string;
+    elementsBaseUrl: string;
+    apiBaseUrl?: string;
+    debug: boolean;
+    measurePerformance: boolean;
+    timeoutMs: number;
+    themeMode: ThemeMode;
+    theme: ThemeTokens;
+    darkTheme?: ThemeTokens;
+    retryConfig: {
+        maxRetries: number;
+        delayMs: number;
+        backoffFactor: number;
+    };
+}
+export type { ElementType } from './types/events';
+export type EventType = 'change' | 'ready' | 'focus' | 'blur' | 'error';
+export interface ElementOptions {
+    /**
+     * Placeholder text displayed when input is empty.
+     * For card elements, an object with per-field placeholders.
+     */
+    placeholder?: string | {
+        cardNumber?: string;
+        expiryDate?: string;
+        cvc?: string;
+    };
+    /**
+     * ARIA label for accessibility
+     * @default Based on element type (e.g., 'Card Number')
+     */
+    ariaLabel?: string;
+    /**
+     * Disable the input
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Make the input read-only
+     * @default false
+     */
+    readOnly?: boolean;
+    /**
+     * RegExp pattern for validation
+     * Only applicable to text elements
+     * @example /^[a-zA-Z\s]{2,50}$/ for names
+     * @example /^\d{3}-\d{2}-\d{4}$/ for SSN
+     */
+    validation?: RegExp;
+    /**
+     * Whether the field is required
+     * Only applicable to text elements
+     * @default false
+     */
+    required?: boolean;
+    /**
+     * Maximum input length
+     * Only applicable to text elements
+     * @example 50 for name fields
+     */
+    maxLength?: number;
+    /**
+     * Enable password mode (type="password")
+     * Only applicable to text elements
+     * @default false
+     */
+    password?: boolean;
+    /**
+     * Mobile keyboard hint
+     * Only applicable to text elements
+     * @example 'numeric', 'tel', 'email'
+     */
+    inputMode?: string;
+    /**
+     * Input masking pattern (lazy-loaded ~5KB module)
+     * Only applicable to text elements
+     *
+     * @example
+     * // SSN: XXX-XX-XXXX
+     * mask: [/\d/, /\d/, /\d/, '-', /\d/, /\d/, '-', /\d/, /\d/, /\d/, /\d/]
+     *
+     * // Phone: (XXX) XXX-XXXX
+     * mask: ['(', /\d/, /\d/, /\d/, ')', ' ', /\d/, /\d/, /\d/, '-', /\d/, /\d/, /\d/, /\d/]
+     */
+    mask?: (RegExp | string)[];
+    /**
+     * Transform pattern before tokenization
+     * Only applicable to text elements
+     *
+     * @example
+     * // Remove dashes from SSN before tokenization
+     * transform: [/-/g, '']
+     */
+    transform?: Transform;
+    /**
+     * Renders a show/hide toggle button inside the CVV field.
+     * Clicking toggles between `type="password"` and `type="text"`.
+     * CVV element only. Set at creation time only — runtime updates via
+     * `element.update()` are not supported.
+     * @default false
+     */
+    showToggle?: boolean;
+    /**
+     * Card brand (auto-set by SDK when card number element detects brand)
+     * Used internally for CVV element coordination
+     * @internal
+     */
+    cardBrand?: string;
+    /**
+     * CVV lengths array (auto-set by SDK when card number element detects brand)
+     * Used internally for CVV element maxlength coordination
+     * Example: [4] for Amex, [3] for Visa/Mastercard
+     * @internal
+     */
+    cvvLengths?: number[];
+    /**
+     * Layout mode for unified card element
+     * Only applicable to card elements
+     * @default 'auto'
+     */
+    layout?: 'row' | 'column' | 'auto';
+    /**
+     * Stack threshold in pixels (only applies when layout: 'auto')
+     * Only applicable to card elements
+     * @default 400
+     */
+    stackAt?: number;
+    /**
+     * Icon position for card brand icon
+     * Only applicable to card elements
+     * @default 'right'
+     */
+    iconPosition?: 'left' | 'right' | 'none';
+    /**
+     * Restrict accepted card brands
+     * Only applicable to card elements
+     */
+    cardBrands?: string[];
+}
+export interface Element {
+    /**
+     * Unique identifier for the element
+     */
+    readonly id: string;
+    /**
+     * Element type ('cardNumber', 'cvv', 'expiry')
+     */
+    readonly type: ElementType;
+    /**
+     * Whether the element is currently mounted to the DOM
+     */
+    readonly mounted: boolean;
+    /**
+     * Mount the element to a DOM container
+     * @param selector - CSS selector or HTMLElement
+     */
+    mount(selector: string | HTMLElement): Promise<void>;
+    /**
+     * Unmount the element from the DOM
+     */
+    unmount(): void;
+    /**
+     * Update element configuration (placeholder, style, theme mode, etc.)
+     */
+    update(options: Partial<ElementOptions> & {
+        themeMode?: 'light' | 'dark' | 'auto';
+    }): Promise<void>;
+    /**
+     * Focus the input
+     */
+    focus(): void;
+    /**
+     * Blur the input
+     */
+    blur(): void;
+    /**
+     * Clear the input value
+     */
+    clear(): void;
+    /**
+     * Listen for element events
+     * @returns Unsubscribe function
+     */
+    on(eventType: EventType, listener: EventListener): () => void;
+}
+export type EventListener = (event: CustomEvent) => void;
+/**
+ * Re-export unified event types from ./types/events
+ * All events now include BaseEventDetail (elementType, elementId, timestamp)
+ */
+export type { BaseEventDetail, BlurEventDetail, CardElementChangeEventDetail, CardNumberChangeEventDetail, ChangeEventDetail, ElementEventDetailMap, ElementEventListener, ElementEventType, ErrorCode, ErrorEventDetail, FocusEventDetail, ReadyEventDetail, ValidationError, } from './types/events';
+/** Primitive or an Element reference — resolved to a value during tokenization */
+export type ElementLeaf = string | number | boolean | null | undefined | Element;
+/** Freeform object that may contain Element references at any depth */
+export interface ElementInputObject {
+    [key: string]: ElementLeaf | ElementInputObject | ElementInputArray;
+}
+/** Array that may contain Element references at any depth */
+export type ElementInputArray = Array<ElementLeaf | ElementInputObject | ElementInputArray>;
+export interface TokenCreateRequest {
+    type: string;
+    data: ElementInputObject;
+    metadata?: Record<string, string>;
+    containers?: string[];
+    mask?: Record<string, unknown>;
+    aliases?: string[];
+    search_indexes?: string[];
+    fingerprint_expression?: string;
+    expires_at?: string;
+}
+/** Token `type` is immutable after creation */
+export type TokenUpdateRequest = Omit<Partial<TokenCreateRequest>, 'type'>;
+export interface TokenIntentRequest {
+    type: string;
+    data: ElementInputObject;
+}
+export type TokenizeInput = {
+    cardNumber: Element;
+} | {
+    number: Element;
+    cvv: Element;
+    expiry: Element;
+};
+/**
+ * Session response (snake_case to match BasisTheory API)
+ */
+export interface Session {
+    /** Unique session nonce */
+    nonce: string;
+    /** Session expiration timestamp (ISO 8601 format) */
+    expires_at?: string;
+}
+export interface TokenizeResult {
+    id: string;
+    type: 'card' | 'token';
+    mask?: string;
+    brand?: string;
+    expiry?: {
+        month: number;
+        year: number;
+    };
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Token data for encryption
+ */
+export interface EncryptToken {
+    type: string;
+    data: ElementInputObject;
+}
+/**
+ * Encrypted token result
+ */
+export interface EncryptedToken {
+    encrypted: string;
+    type: string;
+}
+/**
+ * Sub-element reference for tokenization (used in CardElement)
+ */
+export interface SubElementRef {
+    id: string;
+    type: string;
+    mounted: boolean;
+    mount: () => never;
+    unmount: () => void;
+    update: () => Promise<void>;
+    focus: () => void;
+    blur: () => void;
+    clear: () => void;
+    on: () => () => void;
+}
+/**
+ * Card element with sub-field refs
+ */
+export interface CardElement extends Element {
+    fields: {
+        number: SubElementRef;
+        expiryDate: SubElementRef;
+        cvc: SubElementRef;
+    };
+}
+export type { CardElementOptions } from './elements/create-card';
+export interface BasisTheorySDK {
+    /**
+     * Create a new element instance
+     * Returns Element instance immediately (synchronous)
+     */
+    createElement(type: 'card', options?: ElementOptions): CardElement;
+    createElement(type: Exclude<ElementType, 'card'>, options?: ElementOptions): Element;
+    createElement(type: ElementType, options?: ElementOptions): Element | CardElement;
+    /**
+     * Tokenize data (creates a token)
+     */
+    tokenize(data: ElementInputObject): Promise<TokenizeResult>;
+    /**
+     * Token CRUD operations
+     * Supports Element references - automatically resolves to secure values
+     *
+     * @example
+     * ```typescript
+     * // Create token with Elements (element references resolved automatically)
+     * const token = await bt.tokens.create({
+     *   type: 'card',
+     *   data: {
+     *     number: cardNumberElement,
+     *     expiration_month: expiryElement,
+     *     cvc: cvvElement
+     *   }
+     * });
+     *
+     * // Retrieve token
+     * const retrieved = await bt.tokens.retrieve(token.id);
+     *
+     * // Update token metadata
+     * await bt.tokens.update(token.id, {
+     *   metadata: { source: 'updated' }
+     * });
+     *
+     * // Encrypt token with client-side JWE
+     * const encrypted = await bt.tokens.encrypt(
+     *   { type: 'card', data: { number: cardNumberElement } },
+     *   publicKeyPEM,
+     *   'key-id-123'
+     * );
+     * ```
+     */
+    tokens: {
+        create(data: TokenCreateRequest): Promise<TokenizeResult>;
+        retrieve(id: string, options?: {
+            apiKey?: string;
+        }): Promise<TokenizeResult>;
+        update(id: string, data: TokenUpdateRequest): Promise<TokenizeResult>;
+        encrypt(tokenData: EncryptToken | Record<string, EncryptToken>, publicKeyPEM: string, keyId: string): Promise<EncryptedToken | Record<string, EncryptedToken>>;
+    };
+    /**
+     * Token Intent operations (short-lived sensitive data validation)
+     * Supports Element references - automatically resolves to secure values
+     *
+     * @example
+     * ```typescript
+     * // Create token intent with Elements
+     * const intent = await bt.tokenIntents.create({
+     *   type: 'card',
+     *   data: {
+     *     number: cardNumberElement,
+     *     expiration_month: 12,
+     *     expiration_year: 2025,
+     *     cvc: cvvElement
+     *   }
+     * });
+     *
+     * // Retrieve token intent
+     * const retrieved = await bt.tokenIntents.get(intent.id);
+     * ```
+     */
+    tokenIntents: {
+        create(data: TokenIntentRequest, options?: {
+            apiKey?: string;
+        }): Promise<TokenIntent>;
+        get(id: string, options?: {
+            apiKey?: string;
+        }): Promise<TokenIntent>;
+    };
+    /**
+     * Session management for temporary elevated access
+     *
+     * Creates a session that provides temporary elevated access to tokenized data.
+     * Sessions MUST be authorized by a Private Application on your backend.
+     *
+     * @example
+     * ```typescript
+     * // Create a session (frontend)
+     * const session = await bt.sessions.create();
+     * console.log('Session nonce:', session.nonce);
+     *
+     * // Session must be authorized on backend before use
+     * // Once authorized, use the session API key with tokens.retrieve()
+     * const token = await bt.tokens.retrieve(tokenId, {
+     *   apiKey: sessionApiKey // From authorized session
+     * });
+     * ```
+     */
+    sessions: {
+        create(): Promise<Session>;
+    };
+    /**
+     * Update the theme mode for all mounted elements
+     *
+     * @param mode - Theme mode to apply ('light', 'dark', or 'auto')
+     * @returns Promise that resolves when all elements have been updated
+     *
+     * @example
+     * ```typescript
+     * await bt.updateThemeMode('dark');
+     * ```
+     */
+    updateThemeMode(mode: ThemeMode): Promise<void>;
+}
+/**
+ * PERFORMANCE OPTIMIZATION (Step 3):
+ * Element factories now receive LAZY coordinator initializer
+ * mount() calls this function to trigger initialization when needed
+ */
+export interface ElementFactory {
+    (apiKey: string, config: SDKConfig, options: ElementOptions | undefined, elementId: string, ensureCoordinatorReady: () => Promise<void>): Element;
+}
+export interface MountConfig {
+    timeoutMs: number;
+}
+export interface ElementMounter {
+    mount(container: HTMLElement, iframe: HTMLIFrameElement, config: MountConfig): Promise<void>;
+    unmount(iframe: HTMLIFrameElement): void;
+}
+export interface IframeConfig {
+    src: string;
+    sandbox: string;
+    title: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/web-elements/src/types.d.ts.map

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

package/dist/web-elements/src/utils/create-event-dispatcher.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Centralized event dispatcher factory
+ * Creates consistent event handlers for all element types
+ *
+ * Benefits:
+ * - Single source of truth for event mapping
+ * - Consistent BaseEventDetail (elementType, elementId, timestamp)
+ * - Type-safe event dispatch
+ * - No code duplication across element factories
+ */
+import type { PostMessageClient } from '@basis-theory-elements/postmessage';
+import type { ElementType } from '../types';
+import type { ErrorCode } from '../types/events';
+/**
+ * Event dispatcher configuration
+ */
+interface EventDispatcherConfig {
+    /** Element type */
+    elementType: ElementType;
+    /** Unique element ID */
+    elementId: string;
+    /** PostMessage client for subscribing to iframe events */
+    client: PostMessageClient;
+    /** EventTarget for dispatching DOM events */
+    eventTarget: EventTarget;
+}
+/**
+ * Create event dispatcher with consistent behavior
+ *
+ * @example
+ * ```typescript
+ * const dispatcher = createEventDispatcher({
+ *   elementType: 'cardNumber',
+ *   elementId: 'card-123',
+ *   client,
+ *   eventTarget,
+ * });
+ *
+ * dispatcher.setupSubscriptions();
+ * ```
+ */
+export declare const createEventDispatcher: (config: EventDispatcherConfig) => {
+    setupSubscriptions: () => void;
+    dispatchError: (code: ErrorCode, message: string, error?: Error) => void;
+};
+export {};
+//# sourceMappingURL=create-event-dispatcher.d.ts.map

package/dist/web-elements/src/utils/create-event-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-event-dispatcher.d.ts","sourceRoot":"","sources":["../../../../src/utils/create-event-dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAKV,SAAS,EACV,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,UAAU,qBAAqB;IAC7B,mBAAmB;IACnB,WAAW,EAAE,WAAW,CAAC;IAEzB,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAElB,0DAA0D;IAC1D,MAAM,EAAE,iBAAiB,CAAC;IAE1B,6CAA6C;IAC7C,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,qBAAqB;;0BA0GzD,SAAS,WACN,MAAM,UACP,KAAK,KACZ,IAAI;CAeR,CAAC"}

package/dist/web-elements/src/utils/create-iframe.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Iframe creation utility
+ */
+import type { IframeConfig } from '../types';
+/**
+ * Create a secure iframe with proper attributes
+ * Pure function, no side effects
+ */
+export declare const createIframe: (config: IframeConfig) => HTMLIFrameElement;
+//# sourceMappingURL=create-iframe.d.ts.map

package/dist/web-elements/src/utils/create-iframe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-iframe.d.ts","sourceRoot":"","sources":["../../../../src/utils/create-iframe.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,YAAY,KAAG,iBAenD,CAAC"}

package/dist/web-elements/src/utils/resolve-element-references.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Element Reference Resolution Utilities (SDK Client-Side)
+ *
+ * Converts Element objects to ID strings before sending to coordinator.
+ * Only the `data` field of tokenization requests may contain Element references.
+ *
+ * @see packages/elements/src/shared/utils/replace-element-references.ts
+ * for Step 2 (Coordinator tokenization - ID strings → raw values)
+ */
+/**
+ * Recursively resolves any value — primitives pass through, Element instances
+ * become their ID string, arrays and objects are traversed.
+ */
+export declare const resolveElementReferences: (value: unknown) => unknown;
+/**
+ * Extracts element ID strings from a resolved payload.
+ * Used to identify which elements are referenced before tokenization.
+ */
+export declare const extractElementIds: (payload: unknown) => string[];
+//# sourceMappingURL=resolve-element-references.d.ts.map

package/dist/web-elements/src/utils/resolve-element-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-element-references.d.ts","sourceRoot":"","sources":["../../../../src/utils/resolve-element-references.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA4BH;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,OAAO,KAAG,OAwBzD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,OAAO,KAAG,MAAM,EAiB1D,CAAC"}

package/dist/web-elements/src/utils/validate-element-options.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Element options validation
+ */
+import type { ElementOptions, ElementType } from '../types';
+/**
+ * Validate element options for a specific element type.
+ * Warns about unknown keys and options not applicable to the element type.
+ * Throws on invalid values for known keys.
+ */
+export declare const validateElementOptions: (type: ElementType, options?: ElementOptions) => void;
+//# sourceMappingURL=validate-element-options.d.ts.map

package/dist/web-elements/src/utils/validate-element-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-element-options.d.ts","sourceRoot":"","sources":["../../../../src/utils/validate-element-options.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAmC5D;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,WAAW,EACjB,UAAS,cAAmB,KAC3B,IAsGF,CAAC"}

package/dist/web-elements/src/utils/validate-sdk-config.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Configuration validation utilities
+ */
+import type { SDKConfig, SDKOptions } from '../types';
+/**
+ * Validate API key format
+ * Throws if API key is invalid
+ */
+export declare const validateAPIKey: (apiKey: string) => void;
+/**
+ * Validate and normalize SDK configuration
+ * Returns complete config with defaults applied
+ */
+export declare const validateSDKConfig: (options?: SDKOptions) => SDKConfig;
+//# sourceMappingURL=validate-sdk-config.d.ts.map

package/dist/web-elements/src/utils/validate-sdk-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-sdk-config.d.ts","sourceRoot":"","sources":["../../../../src/utils/validate-sdk-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAqBtD;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,IAI/C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAS,UAAe,KAAG,SAgH5D,CAAC"}