@sparkvault/sdk 1.0.0

package/dist/identity/views/icons.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SVG Icon Factory
+ *
+ * Enterprise-grade icons with clean, minimal design.
+ * Uses proper DOM element creation for security.
+ */
+/**
+ * Checkmark icon for benefit lists
+ */
+export declare function createCheckmarkIcon(): SVGSVGElement;
+/**
+ * Back arrow (chevron left)
+ */
+export declare function createBackArrowIcon(): SVGSVGElement;
+/**
+ * Close (X) icon
+ */
+export declare function createCloseIcon(): SVGSVGElement;
+/**
+ * Auth shield icon - clean, minimal design
+ */
+export declare function createAuthShieldIcon(): SVGSVGElement;
+/**
+ * Passkey icon
+ */
+export declare function createPasskeyIcon(): SVGSVGElement;
+/**
+ * Error icon - clean triangle alert
+ */
+export declare function createErrorIcon(): SVGSVGElement;
+/**
+ * Method icons
+ */
+export declare function createMethodIcon(iconName: string): SVGSVGElement;

package/dist/identity/views/identity-input.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Identity Input View
+ *
+ * Collects and validates the user's email or phone number.
+ * Auto-detects input type and formats accordingly.
+ */
+import type { View } from './base';
+export type IdentityType = 'email' | 'phone';
+export interface IdentityInputResult {
+    value: string;
+    type: IdentityType;
+}
+export interface IdentityInputViewProps {
+    /** Which identity types are allowed */
+    allowedTypes: IdentityType[];
+    /** Pre-filled value */
+    initialValue?: string;
+    /** Error message to display */
+    error?: string;
+    /** Called with validated identity */
+    onSubmit: (result: IdentityInputResult) => void;
+}
+export declare class IdentityInputView implements View {
+    private readonly props;
+    private inputElement;
+    private labelElement;
+    private submitButton;
+    private errorContainer;
+    private focusTimeoutId;
+    private detectedType;
+    private readonly boundHandleInput;
+    private readonly boundHandleKeyDown;
+    private readonly boundHandleSubmit;
+    constructor(props: IdentityInputViewProps);
+    private get allowsBoth();
+    private get allowsEmail();
+    private get allowsPhone();
+    render(): HTMLElement;
+    private getSubtitleText;
+    private getLabelText;
+    private getPlaceholderText;
+    private handleInput;
+    private detectAndUpdateType;
+    private clearError;
+    private showError;
+    private handleSubmit;
+    destroy(): void;
+}

package/dist/identity/views/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * View Components Index
+ *
+ * Re-exports all view components for the identity modal.
+ */
+export * from './base';
+export * from './loading';
+export * from './identity-input';
+export * from './method-select';
+export * from './totp-verify';
+export * from './passkey';
+export * from './passkey-prompt';
+export * from './sparklink-waiting';
+export * from './error';

package/dist/identity/views/loading.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Loading View
+ *
+ * Displays a loading spinner with optional message.
+ */
+import type { View } from './base';
+export interface LoadingViewProps {
+    message?: string;
+}
+export declare class LoadingView implements View {
+    private readonly message;
+    constructor(props?: LoadingViewProps);
+    render(): HTMLElement;
+    destroy(): void;
+}

package/dist/identity/views/method-select.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Method Select View
+ *
+ * Displays available authentication methods for the user to choose from.
+ */
+import type { View } from './base';
+import type { MethodMetadata } from '../types';
+export interface MethodSelectViewProps {
+    email: string;
+    methods: MethodMetadata[];
+    onSelectMethod: (method: MethodMetadata) => void;
+    onBack: () => void;
+}
+export declare class MethodSelectView implements View {
+    private readonly props;
+    private backLink;
+    private methodButtons;
+    private readonly boundHandleBack;
+    private readonly methodClickHandlers;
+    constructor(props: MethodSelectViewProps);
+    render(): HTMLElement;
+    private createBackLink;
+    private createMethodButton;
+    private getMethodIcon;
+    /**
+     * Clean up event listeners to prevent memory leaks.
+     */
+    destroy(): void;
+}

package/dist/identity/views/passkey-prompt.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Passkey Registration Prompt View
+ *
+ * Shown after successful PIN verification to encourage users to add a passkey.
+ * Includes benefits list and skip option with 30-day cookie suppression.
+ */
+import type { View } from './base';
+export interface PasskeyPromptViewProps {
+    email: string;
+    onAddPasskey: () => void;
+    onSkip: () => void;
+}
+export declare class PasskeyPromptView implements View {
+    private readonly props;
+    private addButton;
+    private skipLink;
+    private readonly boundHandleAdd;
+    private readonly boundHandleSkip;
+    constructor(props: PasskeyPromptViewProps);
+    render(): HTMLElement;
+    destroy(): void;
+}

package/dist/identity/views/passkey.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Passkey View
+ *
+ * Handles WebAuthn passkey registration and verification.
+ */
+import type { View } from './base';
+export interface PasskeyViewProps {
+    email: string;
+    mode: 'register' | 'verify';
+    error?: string;
+    onStart: () => void;
+    onBack: () => void;
+    /** Optional fallback to email/SMS code if passkey fails */
+    onFallback?: () => void;
+}
+export declare class PasskeyView implements View {
+    private readonly props;
+    private actionButton;
+    private errorContainer;
+    private backLink;
+    private fallbackLink;
+    private readonly boundHandleBack;
+    private readonly boundHandleStart;
+    private readonly boundHandleFallback;
+    constructor(props: PasskeyViewProps);
+    render(): HTMLElement;
+    private createFallbackLink;
+    private createBackLink;
+    private handleStart;
+    /**
+     * Re-enable the button and show error after a failed attempt.
+     */
+    showError(message: string): void;
+    /**
+     * Clean up event listeners to prevent memory leaks.
+     */
+    destroy(): void;
+}

package/dist/identity/views/sparklink-waiting.d.ts

@@ -0,0 +1,33 @@
+/**
+ * SparkLink Waiting View
+ *
+ * Displays a waiting state while user checks their email for the SparkLink.
+ * Shows countdown timer and provides fallback to verification code.
+ */
+import type { View } from './base';
+export interface SparkLinkWaitingViewProps {
+    email: string;
+    expiresAt: number;
+    onResend: () => void;
+    onFallback: () => void;
+    onBack: () => void;
+}
+export declare class SparkLinkWaitingView implements View {
+    private readonly props;
+    private expirationTimer;
+    private resendTimer;
+    private countdownElement;
+    private resendButton;
+    private backLink;
+    private fallbackButton;
+    private readonly boundHandleBack;
+    private readonly boundHandleResend;
+    private readonly boundHandleFallback;
+    constructor(props: SparkLinkWaitingViewProps);
+    render(): HTMLElement;
+    private createBackLink;
+    private formatTime;
+    private startExpirationTimer;
+    private handleResend;
+    destroy(): void;
+}

package/dist/identity/views/totp-verify.d.ts

@@ -0,0 +1,58 @@
+/**
+ * TOTP Verification View
+ *
+ * Collects and validates the 6-digit TOTP code sent via email or SMS.
+ */
+import type { View } from './base';
+export interface TotpVerifyViewProps {
+    email: string;
+    method: 'email' | 'sms';
+    error?: string;
+    /** UTC timestamp (Unix seconds) when backoff expires and next attempt is allowed */
+    backoffExpires?: number;
+    onSubmit: (code: string) => void;
+    onResend: () => void;
+    onBack: () => void;
+}
+export declare class TotpVerifyView implements View {
+    private readonly props;
+    private inputElements;
+    private submitButton;
+    private resendButton;
+    private backLink;
+    private errorContainer;
+    private resendTimer;
+    private backoffTimer;
+    private backoffSeconds;
+    private focusTimeoutId;
+    private autoSubmitTimeoutId;
+    private isSubmitting;
+    private readonly boundHandleBack;
+    private readonly boundHandleResend;
+    private readonly boundHandleSubmit;
+    private readonly inputHandlers;
+    constructor(props: TotpVerifyViewProps);
+    render(): HTMLElement;
+    private createBackLink;
+    private createInputGroup;
+    private handleInput;
+    private handleKeyDown;
+    private handlePaste;
+    private checkAutoSubmit;
+    private getCode;
+    private clearError;
+    private showError;
+    private handleSubmit;
+    /**
+     * Start backoff countdown using UTC timestamp.
+     * Derives remaining seconds client-side for accuracy.
+     */
+    private startBackoff;
+    private updateSubmitButton;
+    private disableInputs;
+    private handleResend;
+    /**
+     * Clean up event listeners, timers, and intervals to prevent memory leaks.
+     */
+    destroy(): void;
+}