@massimo.mazzoleni/cognito-max 1.0.0

package/dist/ui/index.d.ts

@@ -0,0 +1,241 @@
+import * as react from 'react';
+import { FormEvent, ReactNode } from 'react';
+import { C as CognitoAuthError } from '../errors-BkUDHleb.js';
+import { h as SignInResult, g as MfaType } from '../types-bxA1vonL.js';
+
+type SignInStep = 'credentials' | 'mfa' | 'new_password' | 'mfa_setup';
+interface UseSignInFormOptions {
+    onSuccess?: (result: Extract<SignInResult, {
+        status: 'SUCCESS';
+    }>) => void;
+    onError?: (error: CognitoAuthError) => void;
+}
+interface UseSignInFormReturn {
+    step: SignInStep;
+    isLoading: boolean;
+    error: CognitoAuthError | null;
+    mfaType: MfaType | null;
+    credentials: {
+        email: string;
+        password: string;
+        setEmail(v: string): void;
+        setPassword(v: string): void;
+        onSubmit(e: FormEvent): void;
+    };
+    mfa: {
+        code: string;
+        setCode(v: string): void;
+        onSubmit(e: FormEvent): void;
+    };
+    newPassword: {
+        password: string;
+        confirmPassword: string;
+        requiredAttributes: string[];
+        setPassword(v: string): void;
+        setConfirmPassword(v: string): void;
+        onSubmit(e: FormEvent): void;
+    };
+    mfaSetup: {
+        qrCodeUri: string | null;
+        secretCode: string | null;
+        totpCode: string;
+        setTotpCode(v: string): void;
+        /** Chiama setupTotpChallenge e popola qrCodeUri / secretCode */
+        start(): Promise<void>;
+        /** Chiama verifyTotpChallenge poi handleSignInResult */
+        onVerify(e: FormEvent): void;
+    };
+    reset(): void;
+}
+declare function useSignInForm(options?: UseSignInFormOptions): UseSignInFormReturn;
+
+type RegisterStep = 'register' | 'confirm';
+interface UseRegisterFormOptions {
+    onSuccess?: () => void;
+    onError?: (error: CognitoAuthError) => void;
+    /** Attributi aggiuntivi (es. name, phone_number) */
+    extraAttributes?: Record<string, string>;
+}
+interface UseRegisterFormReturn {
+    step: RegisterStep;
+    isLoading: boolean;
+    error: CognitoAuthError | null;
+    register: {
+        email: string;
+        password: string;
+        confirmPassword: string;
+        setEmail(v: string): void;
+        setPassword(v: string): void;
+        setConfirmPassword(v: string): void;
+        onSubmit(e: FormEvent): void;
+    };
+    confirm: {
+        email: string;
+        code: string;
+        setCode(v: string): void;
+        onSubmit(e: FormEvent): void;
+        resend(): Promise<void>;
+    };
+    reset(): void;
+}
+declare function useRegisterForm(options?: UseRegisterFormOptions): UseRegisterFormReturn;
+
+type ForgotPasswordStep = 'request' | 'reset';
+interface UseForgotPasswordFormOptions {
+    onSuccess?: () => void;
+    onError?: (error: CognitoAuthError) => void;
+}
+interface UseForgotPasswordFormReturn {
+    step: ForgotPasswordStep;
+    isLoading: boolean;
+    error: CognitoAuthError | null;
+    request: {
+        email: string;
+        setEmail(v: string): void;
+        onSubmit(e: FormEvent): void;
+    };
+    reset: {
+        email: string;
+        code: string;
+        newPassword: string;
+        confirmPassword: string;
+        setCode(v: string): void;
+        setNewPassword(v: string): void;
+        setConfirmPassword(v: string): void;
+        onSubmit(e: FormEvent): void;
+    };
+    restart(): void;
+}
+declare function useForgotPasswordForm(options?: UseForgotPasswordFormOptions): UseForgotPasswordFormReturn;
+
+interface UseChangePasswordFormOptions {
+    onSuccess?: () => void;
+    onError?: (error: CognitoAuthError) => void;
+}
+interface UseChangePasswordFormReturn {
+    isLoading: boolean;
+    error: CognitoAuthError | null;
+    success: boolean;
+    currentPassword: string;
+    newPassword: string;
+    confirmPassword: string;
+    setCurrentPassword(v: string): void;
+    setNewPassword(v: string): void;
+    setConfirmPassword(v: string): void;
+    onSubmit(e: FormEvent): void;
+    reset(): void;
+}
+declare function useChangePasswordForm(options?: UseChangePasswordFormOptions): UseChangePasswordFormReturn;
+
+type MfaSetupStep = 'idle' | 'loading' | 'scan' | 'verify' | 'done';
+interface UseMfaSetupOptions {
+    onSuccess?: () => void;
+    onError?: (error: CognitoAuthError) => void;
+}
+interface UseMfaSetupReturn {
+    step: MfaSetupStep;
+    isLoading: boolean;
+    error: CognitoAuthError | null;
+    /** URI otpauth:// da passare a un QR code renderer */
+    qrCodeUri: string | null;
+    /** Secret testuale (per inserimento manuale nell'app) */
+    secretCode: string | null;
+    totpCode: string;
+    setTotpCode(v: string): void;
+    /** Avvia il setup TOTP */
+    start(): Promise<void>;
+    /** Verifica il codice inserito dall'app authenticator */
+    onVerify(e: FormEvent): void;
+    reset(): void;
+}
+declare function useMfaSetup(options?: UseMfaSetupOptions): UseMfaSetupReturn;
+
+interface SignInFormProps extends UseSignInFormOptions {
+    className?: string;
+    labels?: {
+        email?: string;
+        password?: string;
+        submit?: string;
+        mfaCode?: string;
+        mfaSubmit?: string;
+        newPassword?: string;
+        confirmNewPassword?: string;
+        newPasswordSubmit?: string;
+        mfaSetupScanInstruction?: string;
+        mfaSetupSecretLabel?: string;
+        mfaSetupCode?: string;
+        mfaSetupSubmit?: string;
+    };
+    /** Slot per il link "Password dimenticata?" */
+    forgotPasswordLink?: ReactNode;
+    /** Slot per il link "Crea account" */
+    registerLink?: ReactNode;
+    /**
+     * Render del QR code per lo step mfa_setup.
+     * Riceve il URI otpauth:// — usa react-qr-code o simile.
+     * Default: mostra il URI come testo copiabile.
+     */
+    renderQrCode?: (uri: string) => ReactNode;
+}
+declare function SignInForm({ className, labels, forgotPasswordLink, registerLink, renderQrCode, onSuccess, onError, }: SignInFormProps): react.JSX.Element;
+
+interface RegisterFormProps extends UseRegisterFormOptions {
+    className?: string;
+    labels?: {
+        email?: string;
+        password?: string;
+        confirmPassword?: string;
+        submit?: string;
+        code?: string;
+        confirmSubmit?: string;
+        resend?: string;
+    };
+    signInLink?: ReactNode;
+}
+declare function RegisterForm({ className, labels, signInLink, onSuccess, onError, extraAttributes, }: RegisterFormProps): react.JSX.Element;
+
+interface ForgotPasswordFormProps extends UseForgotPasswordFormOptions {
+    className?: string;
+    labels?: {
+        email?: string;
+        requestSubmit?: string;
+        code?: string;
+        newPassword?: string;
+        confirmPassword?: string;
+        resetSubmit?: string;
+    };
+    signInLink?: ReactNode;
+}
+declare function ForgotPasswordForm({ className, labels, signInLink, onSuccess, onError, }: ForgotPasswordFormProps): react.JSX.Element;
+
+interface ChangePasswordFormProps extends UseChangePasswordFormOptions {
+    className?: string;
+    labels?: {
+        currentPassword?: string;
+        newPassword?: string;
+        confirmPassword?: string;
+        submit?: string;
+        successMessage?: string;
+    };
+}
+declare function ChangePasswordForm({ className, labels, onSuccess, onError, }: ChangePasswordFormProps): react.JSX.Element;
+
+interface MfaSetupWizardProps extends UseMfaSetupOptions {
+    className?: string;
+    labels?: {
+        start?: string;
+        scanInstruction?: string;
+        manualEntry?: string;
+        codeLabel?: string;
+        verifySubmit?: string;
+        successMessage?: string;
+    };
+    /**
+     * Render del QR code. Riceve il URI otpauth:// — usa react-qr-code o simile.
+     * Default: mostra il URI come testo copiabile.
+     */
+    renderQrCode?: (uri: string) => ReactNode;
+}
+declare function MfaSetupWizard({ className, labels, renderQrCode, onSuccess, onError, }: MfaSetupWizardProps): react.JSX.Element;
+
+export { ChangePasswordForm, type ChangePasswordFormProps, ForgotPasswordForm, type ForgotPasswordFormProps, type ForgotPasswordStep, type MfaSetupStep, MfaSetupWizard, type MfaSetupWizardProps, RegisterForm, type RegisterFormProps, type RegisterStep, SignInForm, type SignInFormProps, type SignInStep, type UseChangePasswordFormOptions, type UseChangePasswordFormReturn, type UseForgotPasswordFormOptions, type UseForgotPasswordFormReturn, type UseMfaSetupOptions, type UseMfaSetupReturn, type UseRegisterFormOptions, type UseRegisterFormReturn, type UseSignInFormOptions, type UseSignInFormReturn, useChangePasswordForm, useForgotPasswordForm, useMfaSetup, useRegisterForm, useSignInForm };