@insforge/react 0.4.0 → 0.4.6

package/dist/components.d.cts

@@ -1,12 +1,29 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { SignInProps, SignUpProps, ProtectProps, ConditionalProps } from './types.cjs';
 import { UserSchema } from '@insforge/sdk';
 import * as react from 'react';
 import { ReactNode } from 'react';
-export { ForgotPasswordForm, ResetPasswordForm, SignInForm, SignUpForm, VerifyEmailStatus } from './forms.cjs';
-export { AuthBranding, AuthContainer, AuthDivider, AuthEmailVerificationStep, AuthErrorBanner, AuthFormField, AuthHeader, AuthLink, AuthOAuthButton, AuthOAuthProviders, AuthPasswordField, AuthPasswordStrengthIndicator, AuthSubmitButton, AuthVerificationCodeInput } from './atoms.cjs';
+import { InsforgeUser } from './types.cjs';
+export { ForgotPasswordForm, ForgotPasswordFormProps, ResetPasswordForm, ResetPasswordFormProps, SignInForm, SignInFormProps, SignUpForm, SignUpFormProps, VerifyEmailStatus, VerifyEmailStatusProps } from './forms.cjs';
+export { AuthBranding, AuthContainer, AuthContainerProps, AuthDivider, AuthDividerProps, AuthEmailVerificationStep, AuthErrorBanner, AuthErrorBannerProps, AuthFormField, AuthFormFieldProps, AuthHeader, AuthHeaderProps, AuthLink, AuthLinkProps, AuthOAuthButton, AuthOAuthButtonProps, AuthOAuthProviders, AuthOAuthProvidersProps, AuthPasswordField, AuthPasswordFieldProps, AuthPasswordStrengthIndicator, AuthPasswordStrengthIndicatorProps, AuthResetPasswordVerificationStep, AuthSubmitButton, AuthSubmitButtonProps, AuthVerificationCodeInput, AuthVerificationCodeInputProps } from './atoms.cjs';
 import '@insforge/shared-schemas';
 
+interface SignInProps {
+    title?: string;
+    subtitle?: string;
+    emailLabel?: string;
+    emailPlaceholder?: string;
+    passwordLabel?: string;
+    passwordPlaceholder?: string;
+    forgotPasswordText?: string;
+    forgotPasswordUrl?: string;
+    submitButtonText?: string;
+    loadingButtonText?: string;
+    signUpText?: string;
+    signUpLinkText?: string;
+    signUpUrl?: string;
+    dividerText?: string;
+    onError?: (error: Error) => void;
+}
 /**
  * Pre-built sign-in component with full authentication logic.
  *
@@ -14,14 +31,28 @@ import '@insforge/shared-schemas';
  * @example
  * ```tsx
  * <SignIn
- *   afterSignInUrl="/auth/callback"
  *   onSuccess={(user) => console.log('Signed in:', user)}
  *   onError={(error) => console.error('Error:', error)}
  * />
  * ```
  */
-declare function SignIn({ afterSignInUrl, onSuccess, onError, ...uiProps }: SignInProps): react_jsx_runtime.JSX.Element | null;
+declare function SignIn({ onError, ...uiProps }: SignInProps): react_jsx_runtime.JSX.Element | null;
 
+interface SignUpProps {
+    title?: string;
+    subtitle?: string;
+    emailLabel?: string;
+    emailPlaceholder?: string;
+    passwordLabel?: string;
+    passwordPlaceholder?: string;
+    submitButtonText?: string;
+    loadingButtonText?: string;
+    signInText?: string;
+    signInLinkText?: string;
+    signInUrl?: string;
+    dividerText?: string;
+    onError?: (error: Error) => void;
+}
 /**
  * Pre-built sign-up component with full authentication logic.
  *
@@ -29,14 +60,12 @@ declare function SignIn({ afterSignInUrl, onSuccess, onError, ...uiProps }: Sign
  * @example
  * ```tsx
  * <SignUp
- *   afterSignUpUrl="/auth/callback"
- *   onSuccess={(user) => console.log('Signed up:', user)}
  *   onError={(error) => console.error('Error:', error)}
  * />
  *
  * ```
  */
-declare function SignUp({ afterSignUpUrl, onSuccess, onError, ...uiProps }: SignUpProps): react_jsx_runtime.JSX.Element | null;
+declare function SignUp({ onError, ...uiProps }: SignUpProps): react_jsx_runtime.JSX.Element | null;
 
 interface ForgotPasswordProps {
     /** Text customization */
@@ -47,11 +76,6 @@ interface ForgotPasswordProps {
     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;
 }
@@ -59,24 +83,22 @@ interface ForgotPasswordProps {
  * 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)
+ * - **Link method**: Two-step flow (email → check email message)
+ *   User receives an email with a reset link to complete the process in a new tab
  * - **Code method**: Three-step flow (email → verify code → reset password)
+ *   User receives a verification code, enters it, then sets a new 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;
+declare function ForgotPassword({ onError, ...uiProps }: ForgotPasswordProps): react_jsx_runtime.JSX.Element | null;
 
 interface ResetPasswordProps {
-    /** Reset password token (from URL query params) */
-    token: string;
     /** Text customization */
     title?: string;
     subtitle?: string;
@@ -86,30 +108,23 @@ interface ResetPasswordProps {
     confirmPasswordPlaceholder?: string;
     submitButtonText?: string;
     loadingButtonText?: string;
-    backToSignInText?: string;
-    backToSignInUrl?: string;
-    /** Callback when password reset is successful */
-    onSuccess?: () => void;
     /** Callback when an error occurs */
     onError?: (error: Error) => void;
 }
 /**
- * Pre-built reset password component with full business logic.
+ * Pre-built reset password page component with full business logic.
+ *
+ * Automatically reads the reset token from URL query parameter (?token=xxx).
+ * Shows an error if token is missing.
  *
  * @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)}
- * />
+ * // Used at /reset-password?token=xxxxx
+ * <ResetPassword />
  * ```
  */
-declare function ResetPassword({ token, backToSignInUrl, onSuccess, onError, ...uiProps }: ResetPasswordProps): react_jsx_runtime.JSX.Element | null;
+declare function ResetPassword({ onError, ...uiProps }: ResetPasswordProps): react_jsx_runtime.JSX.Element | null;
 
 interface VerifyEmailProps {
     /** Verification token (from URL query params) */
@@ -159,6 +174,13 @@ interface UserButtonProps {
  */
 declare function UserButton({ afterSignOutUrl, mode }: UserButtonProps): react_jsx_runtime.JSX.Element | null;
 
+interface ProtectProps {
+    children: ReactNode;
+    fallback?: ReactNode;
+    redirectTo?: string;
+    condition?: (user: InsforgeUser) => boolean;
+    onRedirect?: (url: string) => void;
+}
 /**
  * Protected route component that redirects unauthenticated users.
  *
@@ -193,8 +215,11 @@ declare function UserButton({ afterSignOutUrl, mode }: UserButtonProps): react_j
  * @param {function} [condition] - Custom access condition
  * @param {function} [onRedirect] - Custom redirect handler (default: window.location)
  */
-declare function Protect({ children, fallback, redirectTo, condition, onRedirect, }: ProtectProps): string | number | bigint | true | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react_jsx_runtime.JSX.Element | null;
+declare function Protect({ children, fallback, redirectTo, condition, onRedirect, }: ProtectProps): 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 | null;
 
+interface ConditionalProps$1 {
+    children: ReactNode;
+}
 /**
  * Conditional component that renders children only when user is signed in.
  *
@@ -209,8 +234,11 @@ declare function Protect({ children, fallback, redirectTo, condition, onRedirect
  * @param {ReactNode} children - React nodes to render when user is authenticated
  * @returns {JSX.Element | null} Renders children when signed in, null otherwise
  */
-declare function SignedIn({ children }: ConditionalProps): react_jsx_runtime.JSX.Element | null;
+declare function SignedIn({ children }: ConditionalProps$1): react_jsx_runtime.JSX.Element | null;
 
+interface ConditionalProps {
+    children: ReactNode;
+}
 /**
  * Conditional component that renders children only when user is signed out.
  *
@@ -227,62 +255,4 @@ declare function SignedIn({ children }: ConditionalProps): react_jsx_runtime.JSX
  */
 declare function SignedOut({ children }: ConditionalProps): react_jsx_runtime.JSX.Element | null;
 
-interface InsforgeCallbackProps {
-    /**
-     * Redirect destination after successful authentication
-     */
-    redirectTo?: string;
-    /**
-     * Callback fired on successful authentication
-     */
-    onSuccess?: () => void;
-    /**
-     * Callback fired on authentication error
-     */
-    onError?: (error: string) => void;
-    /**
-     * Custom loading component
-     */
-    loadingComponent?: ReactNode;
-    /**
-     * Custom redirect handler (default: window.location)
-     */
-    onRedirect?: (url: string) => void;
-}
-/**
- * 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 redirectTo="/dashboard" />;
- * }
- * ```
- *
- * @example
- * ```tsx
- * // With Next.js router
- * import { useRouter } from 'next/navigation';
- *
- * export default function CallbackPage() {
- *   const router = useRouter();
- *   return (
- *     <InsforgeCallback
- *       redirectTo="/dashboard"
- *       onRedirect={(url) => router.push(url)}
- *     />
- *   );
- * }
- * ```
- */
-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 { ForgotPassword, InsforgeCallback, type InsforgeCallbackProps, Protect, ResetPassword, SignIn, SignUp, SignedIn, SignedOut, UserButton, VerifyEmail };
+export { type ConditionalProps$1 as ConditionalProps, ForgotPassword, type ForgotPasswordProps, Protect, type ProtectProps, ResetPassword, type ResetPasswordProps, SignIn, type SignInProps, SignUp, type SignUpProps, SignedIn, SignedOut, UserButton, type UserButtonProps, VerifyEmail, type VerifyEmailProps };

package/dist/components.d.ts

@@ -1,12 +1,29 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { SignInProps, SignUpProps, ProtectProps, ConditionalProps } from './types.js';
 import { UserSchema } from '@insforge/sdk';
 import * as react from 'react';
 import { ReactNode } from 'react';
-export { ForgotPasswordForm, ResetPasswordForm, SignInForm, SignUpForm, VerifyEmailStatus } from './forms.js';
-export { AuthBranding, AuthContainer, AuthDivider, AuthEmailVerificationStep, AuthErrorBanner, AuthFormField, AuthHeader, AuthLink, AuthOAuthButton, AuthOAuthProviders, AuthPasswordField, AuthPasswordStrengthIndicator, AuthSubmitButton, AuthVerificationCodeInput } from './atoms.js';
+import { InsforgeUser } from './types.js';
+export { ForgotPasswordForm, ForgotPasswordFormProps, ResetPasswordForm, ResetPasswordFormProps, SignInForm, SignInFormProps, SignUpForm, SignUpFormProps, VerifyEmailStatus, VerifyEmailStatusProps } from './forms.js';
+export { AuthBranding, AuthContainer, AuthContainerProps, AuthDivider, AuthDividerProps, AuthEmailVerificationStep, AuthErrorBanner, AuthErrorBannerProps, AuthFormField, AuthFormFieldProps, AuthHeader, AuthHeaderProps, AuthLink, AuthLinkProps, AuthOAuthButton, AuthOAuthButtonProps, AuthOAuthProviders, AuthOAuthProvidersProps, AuthPasswordField, AuthPasswordFieldProps, AuthPasswordStrengthIndicator, AuthPasswordStrengthIndicatorProps, AuthResetPasswordVerificationStep, AuthSubmitButton, AuthSubmitButtonProps, AuthVerificationCodeInput, AuthVerificationCodeInputProps } from './atoms.js';
 import '@insforge/shared-schemas';
 
+interface SignInProps {
+    title?: string;
+    subtitle?: string;
+    emailLabel?: string;
+    emailPlaceholder?: string;
+    passwordLabel?: string;
+    passwordPlaceholder?: string;
+    forgotPasswordText?: string;
+    forgotPasswordUrl?: string;
+    submitButtonText?: string;
+    loadingButtonText?: string;
+    signUpText?: string;
+    signUpLinkText?: string;
+    signUpUrl?: string;
+    dividerText?: string;
+    onError?: (error: Error) => void;
+}
 /**
  * Pre-built sign-in component with full authentication logic.
  *
@@ -14,14 +31,28 @@ import '@insforge/shared-schemas';
  * @example
  * ```tsx
  * <SignIn
- *   afterSignInUrl="/auth/callback"
  *   onSuccess={(user) => console.log('Signed in:', user)}
  *   onError={(error) => console.error('Error:', error)}
  * />
  * ```
  */
-declare function SignIn({ afterSignInUrl, onSuccess, onError, ...uiProps }: SignInProps): react_jsx_runtime.JSX.Element | null;
+declare function SignIn({ onError, ...uiProps }: SignInProps): react_jsx_runtime.JSX.Element | null;
 
+interface SignUpProps {
+    title?: string;
+    subtitle?: string;
+    emailLabel?: string;
+    emailPlaceholder?: string;
+    passwordLabel?: string;
+    passwordPlaceholder?: string;
+    submitButtonText?: string;
+    loadingButtonText?: string;
+    signInText?: string;
+    signInLinkText?: string;
+    signInUrl?: string;
+    dividerText?: string;
+    onError?: (error: Error) => void;
+}
 /**
  * Pre-built sign-up component with full authentication logic.
  *
@@ -29,14 +60,12 @@ declare function SignIn({ afterSignInUrl, onSuccess, onError, ...uiProps }: Sign
  * @example
  * ```tsx
  * <SignUp
- *   afterSignUpUrl="/auth/callback"
- *   onSuccess={(user) => console.log('Signed up:', user)}
  *   onError={(error) => console.error('Error:', error)}
  * />
  *
  * ```
  */
-declare function SignUp({ afterSignUpUrl, onSuccess, onError, ...uiProps }: SignUpProps): react_jsx_runtime.JSX.Element | null;
+declare function SignUp({ onError, ...uiProps }: SignUpProps): react_jsx_runtime.JSX.Element | null;
 
 interface ForgotPasswordProps {
     /** Text customization */
@@ -47,11 +76,6 @@ interface ForgotPasswordProps {
     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;
 }
@@ -59,24 +83,22 @@ interface ForgotPasswordProps {
  * 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)
+ * - **Link method**: Two-step flow (email → check email message)
+ *   User receives an email with a reset link to complete the process in a new tab
  * - **Code method**: Three-step flow (email → verify code → reset password)
+ *   User receives a verification code, enters it, then sets a new 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;
+declare function ForgotPassword({ onError, ...uiProps }: ForgotPasswordProps): react_jsx_runtime.JSX.Element | null;
 
 interface ResetPasswordProps {
-    /** Reset password token (from URL query params) */
-    token: string;
     /** Text customization */
     title?: string;
     subtitle?: string;
@@ -86,30 +108,23 @@ interface ResetPasswordProps {
     confirmPasswordPlaceholder?: string;
     submitButtonText?: string;
     loadingButtonText?: string;
-    backToSignInText?: string;
-    backToSignInUrl?: string;
-    /** Callback when password reset is successful */
-    onSuccess?: () => void;
     /** Callback when an error occurs */
     onError?: (error: Error) => void;
 }
 /**
- * Pre-built reset password component with full business logic.
+ * Pre-built reset password page component with full business logic.
+ *
+ * Automatically reads the reset token from URL query parameter (?token=xxx).
+ * Shows an error if token is missing.
  *
  * @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)}
- * />
+ * // Used at /reset-password?token=xxxxx
+ * <ResetPassword />
  * ```
  */
-declare function ResetPassword({ token, backToSignInUrl, onSuccess, onError, ...uiProps }: ResetPasswordProps): react_jsx_runtime.JSX.Element | null;
+declare function ResetPassword({ onError, ...uiProps }: ResetPasswordProps): react_jsx_runtime.JSX.Element | null;
 
 interface VerifyEmailProps {
     /** Verification token (from URL query params) */
@@ -159,6 +174,13 @@ interface UserButtonProps {
  */
 declare function UserButton({ afterSignOutUrl, mode }: UserButtonProps): react_jsx_runtime.JSX.Element | null;
 
+interface ProtectProps {
+    children: ReactNode;
+    fallback?: ReactNode;
+    redirectTo?: string;
+    condition?: (user: InsforgeUser) => boolean;
+    onRedirect?: (url: string) => void;
+}
 /**
  * Protected route component that redirects unauthenticated users.
  *
@@ -193,8 +215,11 @@ declare function UserButton({ afterSignOutUrl, mode }: UserButtonProps): react_j
  * @param {function} [condition] - Custom access condition
  * @param {function} [onRedirect] - Custom redirect handler (default: window.location)
  */
-declare function Protect({ children, fallback, redirectTo, condition, onRedirect, }: ProtectProps): string | number | bigint | true | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react_jsx_runtime.JSX.Element | null;
+declare function Protect({ children, fallback, redirectTo, condition, onRedirect, }: ProtectProps): 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 | null;
 
+interface ConditionalProps$1 {
+    children: ReactNode;
+}
 /**
  * Conditional component that renders children only when user is signed in.
  *
@@ -209,8 +234,11 @@ declare function Protect({ children, fallback, redirectTo, condition, onRedirect
  * @param {ReactNode} children - React nodes to render when user is authenticated
  * @returns {JSX.Element | null} Renders children when signed in, null otherwise
  */
-declare function SignedIn({ children }: ConditionalProps): react_jsx_runtime.JSX.Element | null;
+declare function SignedIn({ children }: ConditionalProps$1): react_jsx_runtime.JSX.Element | null;
 
+interface ConditionalProps {
+    children: ReactNode;
+}
 /**
  * Conditional component that renders children only when user is signed out.
  *
@@ -227,62 +255,4 @@ declare function SignedIn({ children }: ConditionalProps): react_jsx_runtime.JSX
  */
 declare function SignedOut({ children }: ConditionalProps): react_jsx_runtime.JSX.Element | null;
 
-interface InsforgeCallbackProps {
-    /**
-     * Redirect destination after successful authentication
-     */
-    redirectTo?: string;
-    /**
-     * Callback fired on successful authentication
-     */
-    onSuccess?: () => void;
-    /**
-     * Callback fired on authentication error
-     */
-    onError?: (error: string) => void;
-    /**
-     * Custom loading component
-     */
-    loadingComponent?: ReactNode;
-    /**
-     * Custom redirect handler (default: window.location)
-     */
-    onRedirect?: (url: string) => void;
-}
-/**
- * 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 redirectTo="/dashboard" />;
- * }
- * ```
- *
- * @example
- * ```tsx
- * // With Next.js router
- * import { useRouter } from 'next/navigation';
- *
- * export default function CallbackPage() {
- *   const router = useRouter();
- *   return (
- *     <InsforgeCallback
- *       redirectTo="/dashboard"
- *       onRedirect={(url) => router.push(url)}
- *     />
- *   );
- * }
- * ```
- */
-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 { ForgotPassword, InsforgeCallback, type InsforgeCallbackProps, Protect, ResetPassword, SignIn, SignUp, SignedIn, SignedOut, UserButton, VerifyEmail };
+export { type ConditionalProps$1 as ConditionalProps, ForgotPassword, type ForgotPasswordProps, Protect, type ProtectProps, ResetPassword, type ResetPasswordProps, SignIn, type SignInProps, SignUp, type SignUpProps, SignedIn, SignedOut, UserButton, type UserButtonProps, VerifyEmail, type VerifyEmailProps };