@passkeyme/react-auth 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,249 @@
+/**
+ * React-specific types for PasskeyMe Auth SDK
+ * Enhanced with comprehensive TypeScript support and accessibility features
+ */
+import { ReactNode } from "react";
+import type { PasskeymeConfig, User, LoginOptions, PasskeymeAuthInstance, AppConfiguration, PasskeymeError } from "@passkeyme/auth";
+/**
+ * Props for the PasskeymeProvider component
+ * @public
+ */
+export interface PasskeymeProviderProps {
+    /** Configuration for PasskeyMe Auth */
+    config: PasskeymeConfig;
+    /** Children components */
+    children: ReactNode;
+    /** Custom loading component */
+    loadingComponent?: ReactNode;
+    /** Custom error component */
+    errorComponent?: (error: string) => ReactNode;
+    /** Callback when authentication state changes */
+    onAuthChange?: (user: User | null) => void;
+    /** Callback when errors occur */
+    onError?: (error: string | PasskeymeError) => void;
+    /** Whether to enable the built-in notification system (default: true) */
+    enableNotifications?: boolean;
+}
+/**
+ * Return type for the usePasskeyme hook
+ * @public
+ */
+export interface UsePasskeymeReturn {
+    /** Current authenticated user */
+    user: User | null;
+    /** Authentication loading state */
+    loading: boolean;
+    /** Authentication error */
+    error: string | null;
+    /** Whether user is authenticated */
+    isAuthenticated: boolean;
+    /** PasskeyMe configuration */
+    config: PasskeymeConfig;
+    /** Redirect to hosted auth page */
+    redirectToLogin: (options?: LoginOptions) => void;
+    /** Redirect to hosted auth page with specific OAuth provider */
+    redirectToOAuth: (provider: SupportedOAuthProvider, redirectUri?: string) => void;
+    /** Handle authentication callback from hosted auth page */
+    handleAuthCallback: () => Promise<User>;
+    /** Legacy method name for handleAuthCallback */
+    handleCallback: () => Promise<User>;
+    /** Handle direct token authentication callback */
+    handleTokenCallback: (token: string) => Promise<User>;
+    /** Logout current user */
+    logout: () => Promise<void>;
+    /** Get current access token */
+    getAccessToken: () => Promise<string | null>;
+    /** Refresh access token */
+    refreshToken: () => Promise<string>;
+    /** Get base URL configured for auth instance */
+    getBaseUrl: () => string;
+    /** Get app ID configured for auth instance */
+    getAppId: () => string;
+    /** Check if passkeys are supported on this device */
+    isPasskeySupported: () => boolean;
+    /** Check if user has registered passkeys */
+    hasStoredPasskeys: (username?: string) => Promise<boolean>;
+    /** Authenticate with passkey */
+    passkeyLogin: (username: string, apiKey: string) => Promise<User>;
+    /** Smart login: try passkey first, fallback to hosted auth */
+    smartLogin: (username?: string, apiKey?: string) => Promise<{
+        method: "passkey" | "redirect";
+        user?: User;
+    }>;
+    /** Get app configuration including OAuth providers */
+    getAppConfig: () => Promise<AppConfiguration>;
+    /** High-level programmatic authentication trigger with smart fallback */
+    triggerPasskeymeAuth: (options?: TriggerPasskeymeAuthOptions) => Promise<void>;
+    /** Loading state for programmatic authentication */
+    authLoading: boolean;
+    /** Direct access to auth instance */
+    auth: PasskeymeAuthInstance;
+}
+/**
+ * Supported OAuth providers
+ * @public
+ */
+export type SupportedOAuthProvider = "google" | "github" | "facebook";
+/**
+ * Button size options
+ * @public
+ */
+export type ButtonSize = "small" | "medium" | "large";
+/**
+ * Button variant options for OAuth buttons
+ * @public
+ */
+export type OAuthButtonVariant = "default" | "outlined" | "text";
+/**
+ * Button variant options for main buttons
+ * @public
+ */
+export type ButtonVariant = "primary" | "secondary" | "outline";
+/**
+ * Props for OAuth authentication buttons
+ * @public
+ */
+export interface PasskeymeOAuthButtonProps {
+    /** OAuth provider */
+    provider: SupportedOAuthProvider;
+    /** Button variant */
+    variant?: OAuthButtonVariant;
+    /** Button size */
+    size?: ButtonSize;
+    /** Custom redirect URI */
+    redirectUri?: string;
+    /** Custom button text */
+    children?: ReactNode;
+    /** Custom CSS classes */
+    className?: string;
+    /** Custom styles */
+    style?: React.CSSProperties;
+    /** Button disabled state */
+    disabled?: boolean;
+    /** Click handler */
+    onClick?: () => void;
+    /** Loading state */
+    loading?: boolean;
+    /** Accessible label for the button (for screen readers) */
+    "aria-label"?: string;
+    /** ID of element that describes the button */
+    "aria-describedby"?: string;
+    /** ID of element that labels the button */
+    "aria-labelledby"?: string;
+    /** HTML id attribute for the button */
+    id?: string;
+    /** Tab index for keyboard navigation */
+    tabIndex?: number;
+    /** Callback for keyboard events */
+    onKeyDown?: (event: React.KeyboardEvent<HTMLButtonElement>) => void;
+    /** Callback for focus events */
+    onFocus?: (event: React.FocusEvent<HTMLButtonElement>) => void;
+    /** Callback for blur events */
+    onBlur?: (event: React.FocusEvent<HTMLButtonElement>) => void;
+    /** Autofocus the button on mount */
+    autoFocus?: boolean;
+}
+export interface PasskeymeButtonProps {
+    /** Username hint for passkey */
+    username?: string;
+    /** Button variant */
+    variant?: "default" | "outlined" | "text";
+    /** Button size */
+    size?: "small" | "medium" | "large";
+    /** Custom button text */
+    children?: ReactNode;
+    /** Custom CSS classes */
+    className?: string;
+    /** Button disabled state */
+    disabled?: boolean;
+    /** Click handler */
+    onClick?: () => void;
+    /** Loading state */
+    loading?: boolean;
+    /** Success callback */
+    onSuccess?: (user: User) => void;
+    /** Error callback */
+    onError?: (error: string) => void;
+}
+export interface PasskeymeUserProfileProps {
+    /** Show user avatar */
+    showAvatar?: boolean;
+    /** Show user name */
+    showName?: boolean;
+    /** Show user email */
+    showEmail?: boolean;
+    /** Show logout button */
+    showLogout?: boolean;
+    /** Custom CSS classes */
+    className?: string;
+    /** Avatar size */
+    avatarSize?: number;
+    /** Custom logout text */
+    logoutText?: string;
+    /** Logout callback */
+    onLogout?: () => void;
+}
+export interface PasskeymeProtectedRouteProps {
+    /** Children to render when authenticated */
+    children: ReactNode;
+    /** Fallback component when not authenticated */
+    fallback?: ReactNode;
+    /** Redirect URL when not authenticated */
+    redirectTo?: string;
+    /** Required roles for access */
+    requiredRoles?: string[];
+    /** Custom access check function */
+    hasAccess?: (user: User) => boolean;
+}
+export interface PasskeymeCallbackHandlerProps {
+    /** Custom loading component to show during token processing */
+    loadingComponent?: React.ComponentType;
+    /** Custom error component to show if callback fails */
+    errorComponent?: React.ComponentType<{
+        error: string;
+        onRetry: () => void;
+    }>;
+    /** Redirect path after successful authentication */
+    successRedirect?: string;
+    /** Redirect path after authentication error */
+    errorRedirect?: string;
+    /** Custom callback for successful authentication */
+    onSuccess?: (user: any, token: string) => void;
+    /** Custom callback for authentication errors */
+    onError?: (error: string) => void;
+    /** Passkey registration options */
+    passkey?: {
+        /** Whether to prompt for passkey registration after successful auth (overrides global config) */
+        promptRegistration?: boolean;
+        /** Your PasskeyMe API key for WebAuthn operations */
+        apiKey?: string;
+        /** Custom passkey registration prompt component */
+        registrationPrompt?: React.ComponentType<{
+            user: any;
+            onRegister: () => Promise<void>;
+            onSkip: () => void;
+            loading: boolean;
+        }>;
+        /** Callback when passkey registration completes */
+        onRegistrationComplete?: (success: boolean, error?: string) => void;
+    };
+}
+export interface TriggerPasskeymeAuthOptions {
+    /** Username for passkey authentication (optional - will attempt discoverable credential first) */
+    username?: string;
+    /** API key for passkey operations (optional - will use from config) */
+    apiKey?: string;
+    /** Authentication mode: 'hosted' (redirect to hosted pages) or 'inline' (developer handles OAuth UI) */
+    mode?: "hosted" | "inline";
+    /** Callback when authentication succeeds (optional - default shows success notification) */
+    onSuccess?: (user: User, method: "passkey" | "oauth") => void;
+    /** Callback when authentication fails (optional - default shows error notification) */
+    onError?: (error: string) => void;
+    /** Callback when OAuth is required in inline mode (provides available providers) */
+    onOAuthRequired?: (providers: string[]) => void;
+    /** Whether to show default notifications (default: true) */
+    showNotifications?: boolean;
+    /** Force passkey-only authentication, skip OAuth fallback (default: false) */
+    forcePasskeyOnly?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/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/utils/analytics.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Analytics and Monitoring utilities for PasskeyMe React SDK
+ * Provides error boundaries, usage analytics, and performance monitoring
+ */
+import React, { Component, ReactNode } from "react";
+import { PasskeymeError } from "@passkeyme/auth";
+export interface AnalyticsEvent {
+    type: string;
+    category: string;
+    data?: Record<string, any>;
+    timestamp: number;
+    sessionId: string;
+    userId?: string;
+}
+export interface PerformanceMetric {
+    name: string;
+    value: number;
+    timestamp: number;
+    category: "auth" | "component" | "api" | "user";
+    metadata?: Record<string, any>;
+}
+export interface ErrorReport {
+    error: Error | PasskeymeError;
+    errorBoundary?: string;
+    componentStack?: string;
+    userId?: string;
+    sessionId: string;
+    timestamp: number;
+    metadata?: Record<string, any>;
+}
+export interface AnalyticsConfig {
+    enabled?: boolean;
+    apiEndpoint?: string;
+    apiKey?: string;
+    sessionDuration?: number;
+    batchSize?: number;
+    flushInterval?: number;
+    enablePerformanceMetrics?: boolean;
+    enableErrorReporting?: boolean;
+    enableUsageAnalytics?: boolean;
+}
+/**
+ * Analytics Context
+ */
+interface AnalyticsContextType {
+    trackEvent: (event: Omit<AnalyticsEvent, "timestamp" | "sessionId">) => void;
+    trackPerformance: (metric: Omit<PerformanceMetric, "timestamp">) => void;
+    reportError: (report: Omit<ErrorReport, "timestamp" | "sessionId">) => void;
+    config: AnalyticsConfig;
+}
+/**
+ * Analytics Provider
+ */
+export interface AnalyticsProviderProps {
+    children: ReactNode;
+    config: AnalyticsConfig;
+    userId?: string;
+}
+export declare const AnalyticsProvider: ({ children, config, userId, }: AnalyticsProviderProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to use analytics
+ */
+export declare const useAnalytics: () => AnalyticsContextType;
+/**
+ * Error Boundary with Analytics Reporting
+ */
+interface ErrorBoundaryState {
+    hasError: boolean;
+    error?: Error;
+    errorInfo?: React.ErrorInfo;
+}
+export interface PasskeymeErrorBoundaryProps {
+    children: ReactNode;
+    fallback?: ReactNode;
+    onError?: (error: Error, errorInfo: React.ErrorInfo) => void;
+    name?: string;
+}
+export declare class PasskeymeErrorBoundary extends Component<PasskeymeErrorBoundaryProps, ErrorBoundaryState> {
+    constructor(props: PasskeymeErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void;
+    render(): string | number | boolean | Iterable<React.ReactNode> | import("react/jsx-runtime").JSX.Element | null | undefined;
+}
+/**
+ * HOC to wrap components with error boundary
+ */
+export declare const withErrorBoundary: <P extends object>(Component: React.ComponentType<P>, errorBoundaryProps?: Omit<PasskeymeErrorBoundaryProps, "children">) => {
+    (props: P): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/**
+ * Usage analytics helpers
+ */
+export declare const createUsageTracker: () => {
+    trackButtonClick: (buttonType: string, metadata?: Record<string, any>) => void;
+    trackAuthAttempt: (method: "passkey" | "oauth", provider?: string) => void;
+    trackAuthSuccess: (method: "passkey" | "oauth", provider?: string, duration?: number) => void;
+    trackAuthFailure: (method: "passkey" | "oauth", error: string, provider?: string) => void;
+    trackPageView: (page: string, metadata?: Record<string, any>) => void;
+    trackFeatureUsage: (feature: string, metadata?: Record<string, any>) => void;
+};
+/**
+ * Performance monitoring helpers
+ */
+export declare const createPerformanceTracker: () => {
+    trackAPICall: (endpoint: string, duration: number, success: boolean) => void;
+    trackComponentRender: (componentName: string, duration: number) => void;
+    trackAuthFlow: (flow: string, duration: number, success: boolean) => void;
+    trackBundleSize: (bundleName: string, size: number) => void;
+};
+export {};
+//# sourceMappingURL=analytics.d.ts.map

package/dist/utils/analytics.d.ts.map

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

package/dist/utils/debug.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Debug utilities for PasskeyMe React SDK
+ */
+import type { PasskeymeConfig } from "@passkeyme/auth";
+/**
+ * Debug utility to conditionally log messages
+ */
+export declare function debugLog(config: PasskeymeConfig, component: string, ...args: any[]): void;
+//# sourceMappingURL=debug.d.ts.map

package/dist/utils/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/utils/debug.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGvD;;GAEG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,MAAM,EACjB,GAAG,IAAI,EAAE,GAAG,EAAE,QAQf"}

package/dist/utils/devUtils.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Development utilities for PasskeyMe React SDK
+ * These utilities are only active in development mode
+ */
+import React from "react";
+/**
+ * Development warning system
+ */
+export declare const devWarn: (condition: boolean, message: string, ...args: any[]) => void;
+/**
+ * Development error system
+ */
+export declare const devError: (condition: boolean, message: string, ...args: any[]) => void;
+/**
+ * Component prop validation helper
+ */
+export declare const validateProps: <T extends Record<string, any>>(componentName: string, props: T, validators: Partial<Record<keyof T, (value: any) => boolean | string>>) => void;
+/**
+ * Hot reload and development tools initialization
+ */
+export declare const initDevTools: () => void;
+/**
+ * Development component wrapper with debugging
+ */
+export declare const withDevTools: <P extends object>(Component: React.ComponentType<P>, displayName?: string) => React.ComponentType<P> | {
+    (props: P): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/**
+ * Enhanced hot reload helper with React Fast Refresh support
+ */
+export declare const enableHotReload: (component: React.ComponentType, moduleRef?: any) => React.ComponentType<{}> | {
+    (props: any): React.ReactElement<{}, string | React.JSXElementConstructor<any>>;
+    displayName: string;
+};
+/**
+ * Development debug panel component
+ */
+interface DebugPanelProps {
+    data: Record<string, any>;
+    position?: "top-left" | "top-right" | "bottom-left" | "bottom-right";
+}
+export declare const DebugPanel: ({ data, position, }: DebugPanelProps) => import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Component performance profiler for development
+ */
+export declare const withPerformanceProfiler: <P extends Record<string, any>>(Component: React.ComponentType<P>, componentName?: string) => React.ComponentType<P> | React.ForwardRefExoticComponent<React.PropsWithoutRef<P> & React.RefAttributes<any>>;
+/**
+ * Development-only component tree logger
+ */
+export declare const logComponentTree: (componentName: string, props: any, children?: React.ReactNode) => void;
+export {};
+//# sourceMappingURL=devUtils.d.ts.map

package/dist/utils/devUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devUtils.d.ts","sourceRoot":"","sources":["../../src/utils/devUtils.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;GAEG;AACH,eAAO,MAAM,OAAO,cACP,OAAO,WACT,MAAM,WACN,GAAG,EAAE,SAKf,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,cACR,OAAO,WACT,MAAM,WACN,GAAG,EAAE,SAKf,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,iDACT,MAAM,SACd,CAAC,cACI,QAAQ,OAAO,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,GAAG,MAAM,CAAC,CAAC,SAoBvE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,YA0CxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,gCACZ,MAAM,aAAa,CAAC,CAAC,CAAC,gBACnB,MAAM;YAMa,CAAC;;CAqCnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,cACf,MAAM,aAAa,cAClB,GAAG;YAMoB,GAAG;;CAWvC,CAAC;AAEF;;GAEG;AACH,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,QAAQ,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,cAAc,CAAC;CACtE;AAED,eAAO,MAAM,UAAU,wBAGpB,eAAe,mDAoCjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,6CACvB,MAAM,aAAa,CAAC,CAAC,CAAC,kBACjB,MAAM,kHAwCvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,kBACZ,MAAM,SACd,GAAG,aACC,MAAM,SAAS,SAU3B,CAAC"}

package/dist/utils/enhancedButtonStyles.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Enhanced Button Styles Utility
+ * Extracted from PasskeyLoginButton component
+ */
+import React from "react";
+export type ButtonVariant = "primary" | "secondary" | "outline";
+export type ButtonSize = "small" | "medium" | "large";
+export interface ButtonStyleOptions {
+    variant?: ButtonVariant;
+    size?: ButtonSize;
+    disabled?: boolean;
+    loading?: boolean;
+    fullWidth?: boolean;
+    theme?: "light" | "dark" | "auto";
+}
+export interface ButtonStyles {
+    base: React.CSSProperties;
+    size: React.CSSProperties;
+    variant: React.CSSProperties;
+    state: React.CSSProperties;
+    combined: React.CSSProperties;
+}
+/**
+ * Enhanced button styling system with comprehensive variants and sizes
+ */
+export declare function getEnhancedButtonStyles(options?: ButtonStyleOptions): ButtonStyles;
+/**
+ * Get loading spinner styles for buttons
+ */
+export declare function getLoadingSpinnerStyles(size: ButtonSize): React.CSSProperties;
+/**
+ * Get icon styles for buttons
+ */
+export declare function getButtonIconStyles(size: ButtonSize): React.CSSProperties;
+/**
+ * CSS keyframes for loading spinner (to be added to global styles)
+ */
+export declare const spinnerKeyframes = "\n@keyframes spin {\n  0% { transform: rotate(0deg); }\n  100% { transform: rotate(360deg); }\n}\n";
+/**
+ * Default button style presets
+ */
+export declare const buttonPresets: {
+    readonly primary: {
+        readonly variant: "primary";
+        readonly size: "medium";
+    };
+    readonly secondary: {
+        readonly variant: "secondary";
+        readonly size: "medium";
+    };
+    readonly outline: {
+        readonly variant: "outline";
+        readonly size: "medium";
+    };
+    readonly small: {
+        readonly variant: "primary";
+        readonly size: "small";
+    };
+    readonly large: {
+        readonly variant: "primary";
+        readonly size: "large";
+    };
+    readonly fullWidth: {
+        readonly variant: "primary";
+        readonly size: "medium";
+        readonly fullWidth: true;
+    };
+};
+export default getEnhancedButtonStyles;
+//# sourceMappingURL=enhancedButtonStyles.d.ts.map

package/dist/utils/enhancedButtonStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhancedButtonStyles.d.ts","sourceRoot":"","sources":["../../src/utils/enhancedButtonStyles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAChE,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC;IAC1B,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC;IAC1B,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC;IAC7B,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC;IAC3B,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,kBAAuB,GAC/B,YAAY,CAyId;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG,KAAK,CAAC,aAAa,CAe7E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,KAAK,CAAC,aAAa,CAczE;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,uGAK5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;CAWhB,CAAC;AAEX,eAAe,uBAAuB,CAAC"}

package/dist/utils/importOptimizer.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Import optimization utility for PasskeyMe React SDK
+ * Analyzes and optimizes bundle imports to reduce bundle size
+ *
+ * Note: This utility is intended for build-time analysis in Node.js environments only.
+ * It should not be imported in browser/client-side code.
+ */
+export interface ImportAnalysis {
+    file: string;
+    imports: {
+        module: string;
+        imports: string[];
+        isDefaultImport: boolean;
+        isNamespaceImport: boolean;
+    }[];
+    size: number;
+    treeshakable: boolean;
+}
+export interface OptimizationSuggestion {
+    file: string;
+    issue: string;
+    suggestion: string;
+    impact: "high" | "medium" | "low";
+}
+/**
+ * Import analyzer class
+ */
+export declare class ImportAnalyzer {
+    private srcDir;
+    constructor(srcDir: string);
+    /**
+     * Analyze all imports in the source directory
+     * Note: This method only works in Node.js environments
+     */
+    analyzeImports(): Promise<ImportAnalysis[]>;
+    /**
+     * Generate optimization suggestions
+     */
+    generateSuggestions(analyses: ImportAnalysis[]): OptimizationSuggestion[];
+    private getTypeScriptFiles;
+    private analyzeFile;
+    private extractImports;
+    private extractNamedImports;
+    private isTreeshakable;
+}
+/**
+ * Bundle size optimizer
+ */
+export declare class BundleOptimizer {
+    /**
+     * Optimize imports in a file
+     */
+    static optimizeFile(filePath: string): string;
+    private static optimizeBarrelImports;
+    /**
+     * Remove unused dependencies from package.json
+     */
+    static analyzeUnusedDependencies(packageJsonPath: string, srcDir: string): Promise<string[]>;
+}
+/**
+ * Runtime dependency checker
+ */
+export declare const checkRuntimeDependencies: () => string[];
+/**
+ * Generate optimization report
+ * Note: This function only works in Node.js environments
+ */
+export declare const generateOptimizationReport: (srcDir: string) => Promise<{
+    summary: {
+        totalFiles: number;
+        totalImports: number;
+        treeshakableFiles: number;
+        suggestions: number;
+    };
+    suggestions: OptimizationSuggestion[];
+    runtimeIssues: string[];
+    analyses: ImportAnalysis[];
+}>;
+//# sourceMappingURL=importOptimizer.d.ts.map

package/dist/utils/importOptimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importOptimizer.d.ts","sourceRoot":"","sources":["../../src/utils/importOptimizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmBH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,eAAe,EAAE,OAAO,CAAC;QACzB,iBAAiB,EAAE,OAAO,CAAC;KAC5B,EAAE,CAAC;IACJ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACnC;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAI1B;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAmBjD;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,sBAAsB,EAAE;IAkEzE,OAAO,CAAC,kBAAkB;IA0B1B,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,cAAc;CAWvB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAgB7C,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAMpC;;OAEG;WACU,yBAAyB,CACpC,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,CAAC;CA8BrB;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,gBAyBpC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,WAAkB,MAAM;;;;;;;;;;EA6B9D,CAAC"}

package/dist/utils/loadingStates.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Enhanced Loading States for PasskeyMe SDK
+ * Provides granular loading feedback for better user experience
+ */
+export type PasskeymeLoadingState = "idle" | "initializing" | "checking-passkey-support" | "starting-passkey-auth" | "waiting-for-passkey" | "processing-passkey" | "fallback-to-oauth" | "redirecting-to-hosted" | "loading-oauth-providers" | "completing-auth" | "storing-tokens" | "success" | "error";
+export interface PasskeymeLoadingStateInfo {
+    state: PasskeymeLoadingState;
+    message: string;
+    progress?: number;
+    duration?: number;
+    showSpinner?: boolean;
+    showProgress?: boolean;
+    icon?: string;
+    userAction?: "required" | "wait" | "none";
+    userActionText?: string;
+}
+export declare const LOADING_STATE_INFO: Record<PasskeymeLoadingState, PasskeymeLoadingStateInfo>;
+export declare class LoadingStateManager {
+    private currentState;
+    private listeners;
+    private timeouts;
+    private startTime;
+    subscribe(listener: (state: PasskeymeLoadingStateInfo) => void): () => void;
+    setState(state: PasskeymeLoadingState, customMessage?: string): void;
+    getCurrentState(): PasskeymeLoadingState;
+    getElapsedTime(): number;
+    reset(): void;
+    private scheduleAutoAdvance;
+    private shouldAutoAdvance;
+    private advanceToNextState;
+    private clearTimeout;
+    private clearAllTimeouts;
+}
+export declare const globalLoadingStateManager: LoadingStateManager;
+//# sourceMappingURL=loadingStates.d.ts.map

package/dist/utils/loadingStates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadingStates.d.ts","sourceRoot":"","sources":["../../src/utils/loadingStates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,qBAAqB,GAC7B,MAAM,GACN,cAAc,GACd,0BAA0B,GAC1B,uBAAuB,GACvB,qBAAqB,GACrB,oBAAoB,GACpB,mBAAmB,GACnB,uBAAuB,GACvB,yBAAyB,GACzB,iBAAiB,GACjB,gBAAgB,GAChB,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,qBAAqB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CACrC,qBAAqB,EACrB,yBAAyB,CAkI1B,CAAC;AAEF,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,SAAS,CACL;IACZ,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,SAAS,CAAa;IAEvB,SAAS,CACd,QAAQ,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,GACnD,MAAM,IAAI;IAKN,QAAQ,CAAC,KAAK,EAAE,qBAAqB,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IAmBpE,eAAe,IAAI,qBAAqB;IAIxC,cAAc,IAAI,MAAM;IAIxB,KAAK,IAAI,IAAI;IAMpB,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,kBAAkB;IA2B1B,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,gBAAgB;CAIzB;AAGD,eAAO,MAAM,yBAAyB,qBAA4B,CAAC"}