@insforge/react 0.2.9 → 0.3.0

package/dist/components.d.ts

@@ -1,9 +1,9 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { SignInProps, SignUpProps, UserButtonProps, ProtectProps, ConditionalProps } from './types.js';
+import { SignInProps, SignUpProps, ForgotPasswordAppearance, ResetPasswordAppearance, VerifyEmailStatusProps, UserButtonProps, ProtectProps, ConditionalProps } from './types.js';
 import * as react from 'react';
 import { ReactNode } from 'react';
 export { ForgotPasswordForm, ResetPasswordForm, SignInForm, SignUpForm, VerifyEmailStatus } from './forms.js';
-export { AuthBranding, AuthContainer, AuthDivider, AuthErrorBanner, AuthFormField, AuthHeader, AuthLink, AuthOAuthButton, AuthOAuthProviders, AuthPasswordField, AuthPasswordStrengthIndicator, AuthSubmitButton, AuthVerificationCodeInput, validatePasswordStrength } from './atoms.js';
+export { AuthBranding, AuthContainer, AuthDivider, AuthEmailVerificationStep, AuthErrorBanner, AuthFormField, AuthHeader, AuthLink, AuthOAuthButton, AuthOAuthProviders, AuthPasswordField, AuthPasswordStrengthIndicator, AuthSubmitButton, AuthVerificationCodeInput, validatePasswordStrength } from './atoms.js';
 import '@insforge/shared-schemas';
 
 /**
@@ -37,6 +37,123 @@ declare function SignIn({ afterSignInUrl, onSuccess, onError, ...uiProps }: Sign
  */
 declare function SignUp({ afterSignUpUrl, onSuccess, onError, ...uiProps }: SignUpProps): react_jsx_runtime.JSX.Element | null;
 
+interface ForgotPasswordProps {
+    /** Hierarchical appearance configuration for deep customization */
+    appearance?: ForgotPasswordAppearance;
+    /** Text customization */
+    title?: string;
+    subtitle?: string;
+    emailLabel?: string;
+    emailPlaceholder?: string;
+    submitButtonText?: string;
+    loadingButtonText?: string;
+    backToSignInText?: string;
+    backToSignInUrl?: string;
+    successTitle?: string;
+    successMessage?: string;
+    /** Callback when password is successfully reset */
+    onSuccess?: () => void;
+    /** Callback when an error occurs */
+    onError?: (error: Error) => void;
+}
+/**
+ * Pre-built forgot password component with full business logic.
+ *
+ * Supports two password reset methods (auto-detected from backend config):
+ * - **Link method**: Sends email with reset link (handled by ResetPassword component)
+ * - **Code method**: Three-step flow (email → verify code → reset password)
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <ForgotPassword
+ *   backToSignInUrl="/sign-in"
+ *   onSuccess={() => console.log('Password reset!')}
+ *   onError={(error) => console.error('Error:', error)}
+ * />
+ * ```
+ */
+declare function ForgotPassword({ backToSignInUrl, onSuccess, onError, ...uiProps }: ForgotPasswordProps): react_jsx_runtime.JSX.Element | null;
+
+interface ResetPasswordProps {
+    /** Reset password token (from URL query params) */
+    token: string;
+    /** Hierarchical appearance configuration for deep customization */
+    appearance?: ResetPasswordAppearance;
+    /** Text customization */
+    title?: string;
+    subtitle?: string;
+    newPasswordLabel?: string;
+    newPasswordPlaceholder?: string;
+    confirmPasswordLabel?: string;
+    confirmPasswordPlaceholder?: string;
+    submitButtonText?: string;
+    loadingButtonText?: string;
+    backToSignInText?: string;
+    backToSignInUrl?: string;
+    /** Callback when password reset is successful */
+    onSuccess?: (redirectTo?: string) => void;
+    /** Callback when an error occurs */
+    onError?: (error: Error) => void;
+}
+/**
+ * Pre-built reset password component with full business logic.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * const token = new URLSearchParams(window.location.search).get('token');
+ *
+ * <ResetPassword
+ *   token={token || ''}
+ *   backToSignInUrl="/sign-in"
+ *   onSuccess={(redirectTo) => window.location.href = redirectTo || '/'}
+ *   onError={(error) => console.error('Error:', error)}
+ * />
+ * ```
+ */
+declare function ResetPassword({ token, backToSignInUrl, onSuccess, onError, ...uiProps }: ResetPasswordProps): react_jsx_runtime.JSX.Element | null;
+
+interface VerifyEmailProps {
+    /** Verification token (from URL query params) */
+    token: string;
+    /** Appearance configuration */
+    appearance?: VerifyEmailStatusProps["appearance"];
+    /** Text customization */
+    verifyingTitle?: string;
+    successTitle?: string;
+    successMessage?: string;
+    errorTitle?: string;
+    /** Callback when verification is successful */
+    onSuccess?: (data: {
+        accessToken: string;
+        user?: any;
+    }) => void;
+    /** Callback when verification fails */
+    onError?: (error: Error) => void;
+}
+/**
+ * Pre-built email verification component with full business logic.
+ *
+ * Automatically verifies the email when mounted using the provided token.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * const token = new URLSearchParams(window.location.search).get('token');
+ *
+ * <VerifyEmail
+ *   token={token || ''}
+ *   onSuccess={(data) => {
+ *     console.log('Email verified!', data);
+ *     // Optionally navigate or close window
+ *   }}
+ *   onError={(error) => console.error('Verification failed:', error)}
+ * />
+ * ```
+ */
+declare function VerifyEmail({ token, onSuccess, onError, ...uiProps }: VerifyEmailProps): react_jsx_runtime.JSX.Element;
+
 /**
  * User profile button with dropdown menu and sign-out functionality.
  *
@@ -154,15 +271,20 @@ interface InsforgeCallbackProps {
     onRedirect?: (url: string) => void;
 }
 /**
- * InsforgeCallback - Handles OAuth and email/password authentication callbacks
+ * InsforgeCallback - Handles OAuth authentication callbacks
  *
  * Place this component on your `/auth/callback` page.
  *
+ * How it works:
+ * 1. SDK automatically detects OAuth callback parameters and saves to localStorage
+ * 2. Provider validates the session from localStorage
+ * 3. This component waits for validation and handles redirect
+ *
  * @example
  * ```tsx
  * // Minimal usage
  * export default function CallbackPage() {
- *   return <InsforgeCallback />;
+ *   return <InsforgeCallback redirectTo="/dashboard" />;
  * }
  * ```
  *
@@ -184,4 +306,4 @@ interface InsforgeCallbackProps {
  */
 declare function InsforgeCallback({ redirectTo, onSuccess, onError, loadingComponent, onRedirect, }: InsforgeCallbackProps): string | number | bigint | true | Iterable<ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | react_jsx_runtime.JSX.Element;
 
-export { InsforgeCallback, type InsforgeCallbackProps, Protect, SignIn, SignUp, SignedIn, SignedOut, UserButton };
+export { ForgotPassword, InsforgeCallback, type InsforgeCallbackProps, Protect, ResetPassword, SignIn, SignUp, SignedIn, SignedOut, UserButton, VerifyEmail };