@movmo_app/react-common 0.11.2 → 0.11.3

package/dist/index.d.ts

@@ -171,7 +171,7 @@ export declare interface ModalProps {
     allowOverflow?: boolean;
 }
 
-export declare const OTPModal: ({ email, phone, otpLength, otpAction, onVerify, onClose, externalError, title, description, }: OTPModalProps) => JSX_2.Element;
+export declare const OTPModal: ({ email, phone, otpLength, otpAction, onVerify, onClose, externalError, externalErrorVariant, disabled, title, description, onOtpChange, }: OTPModalProps) => JSX_2.Element;
 
 export declare interface OTPModalProps {
     email: string;
@@ -181,8 +181,16 @@ export declare interface OTPModalProps {
     onVerify: (otp: string) => void;
     onClose: () => void;
     externalError?: string;
+    externalErrorVariant?: 'error' | 'warning';
+    disabled?: boolean;
     title?: string;
     description?: string;
+    /**
+     * Fires when the user edits the OTP (type, paste, backspace). Use to clear
+     * stale parent-controlled `externalError` so the message disappears as soon
+     * as the user starts correcting their input. Not fired while `disabled`.
+     */
+    onOtpChange?: (otp: string) => void;
 }
 
 export declare const Pagination: React_2.FC<PaginationProps>;
@@ -285,12 +293,32 @@ export declare const SignInModal: default_2.FC<SignInModalProps>;
 export declare interface SignInModalProps {
     isOpen: boolean;
     onClose: () => void;
+    /**
+     * Called to start the sign-in flow. Rejected errors are inspected via
+     * `isRateLimitError` to decide whether to show the rate-limit notice. The
+     * default detector expects an axios-shaped rejection (`error.response.status`
+     * === 429); pass a custom `isRateLimitError` if you use a different HTTP client.
+     */
     loginUser: (email: string, phone: string, usernameType: AuthenticationUsernameType) => Promise<LoginUserResponse>;
+    /**
+     * Called to verify the OTP code. Rejected errors are surfaced to the user:
+     *  - 429 (per `isRateLimitError`) → OTP modal locked + warning notice.
+     *  - 400 → "Invalid or expired code…" (most common: typo / expired code).
+     *  - 401 → "Your session has expired…".
+     *  - anything else → "Something went wrong. Please try again."
+     * Status is read from `error.response.status` (axios shape).
+     */
     verifyOTP: (username: string, code: string, session: string, challengeName: AuthenticationChallengeName | null) => Promise<void>;
     getCurrentUser: () => Promise<User>;
     onLoginSuccess: (user: User) => void;
     hideCloseButton?: boolean;
     showPhone?: boolean;
+    /**
+     * Predicate used to detect HTTP 429 rate-limit rejections. Defaults to an
+     * axios-shaped check (`error.response?.status === 429`). Supply a custom
+     * implementation for non-axios clients (fetch, ky, custom error types).
+     */
+    isRateLimitError?: (error: unknown) => boolean;
 }
 
 export declare const Textarea: React_2.ForwardRefExoticComponent<TextareaProps & React_2.RefAttributes<HTMLTextAreaElement>>;