@dloizides/auth-web 1.18.0 → 1.18.2

package/dist/index.d.mts

@@ -2460,7 +2460,7 @@ interface RegisterFormProps<TResult> {
     onSuccess: (result: TResult) => void;
     /** Called with the failure code; map it to localised copy. */
     onError?: (error: RegisterErrorCode) => void;
-    /** Called on every submit press, before validation (e.g. a "signup started" event). */
+    /** Called once per accepted submit, before validation (e.g. a "signup started" event); never for a press ignored in flight. */
     onSubmitAttempt?: () => void;
     /** Password rule. Defaults to `isRegisterPasswordStrong`. */
     passwordPolicy?: RegisterPasswordPolicy;
@@ -2506,6 +2506,11 @@ interface UseRegisterFormArgs<TResult> {
     onSubmit: (values: RegisterSubmitValues) => Promise<TResult>;
     /** Password rule. Defaults to {@link isRegisterPasswordStrong}. */
     passwordPolicy?: RegisterPasswordPolicy;
+    /**
+     * Called once per ACCEPTED submit, before validation (e.g. a "signup started"
+     * event). A press ignored because a submit is already in flight does not call it.
+     */
+    onSubmitAttempt?: () => void;
 }
 interface UseRegisterFormResult<TResult> {
     state: RegisterFormValues;
@@ -2516,7 +2521,7 @@ interface UseRegisterFormResult<TResult> {
     error: RegisterErrorCode | null;
 }
 /** Headless registration form logic. */
-declare function useRegisterForm<TResult>({ onSubmit, passwordPolicy, }: UseRegisterFormArgs<TResult>): UseRegisterFormResult<TResult>;
+declare function useRegisterForm<TResult>({ onSubmit, passwordPolicy, onSubmitAttempt, }: UseRegisterFormArgs<TResult>): UseRegisterFormResult<TResult>;
 
 /**
  * Pure registration helpers: trimming, client-side validation and decoding of a
@@ -2529,8 +2534,6 @@ declare function useRegisterForm<TResult>({ onSubmit, passwordPolicy, }: UseRegi
 
 /** The default password rule: 8+ characters with a letter, a digit and a special character. */
 declare function isRegisterPasswordStrong(password: string): boolean;
-/** Decode a thrown registration failure into a {@link RegisterErrorCode}. */
-declare function mapRegisterErrorCode(error: unknown): RegisterErrorCode;
 
 /**
  * `createBffAuthClient` — the one-line wiring of a same-origin `BffAuthClient`.
@@ -2821,4 +2824,4 @@ interface UseChangePasswordResult {
 }
 declare function useChangePassword({ client, onChanged, }: UseChangePasswordArgs): UseChangePasswordResult;
 
-export { type AccountSettingsChangePasswordConfig, type AccountSettingsDevicePinConfig, type AccountSettingsLabels, type AccountSettingsPasskeysConfig, type AccountSettingsPreferredMethodConfig, AccountSettingsScreen, type AccountSettingsScreenProps, AuthScreen, type AuthScreenProps, AuthTestIds, type AuthTheme, type AuthThemeColors, AuthThemeProvider, type AuthThemeProviderProps, type AuthThemeRadii, type AuthThemeSpacing, type AuthThemeTypography, BffAuthStatus, type BffDeviceState, type BffLoginConfig, type BffLogoutClient, CHANGE_PASSWORD_ENDPOINT, type ChangePasswordCapableClient, ChangePasswordCard, type ChangePasswordCardProps, ChangePasswordErrorKey, type ChangePasswordRequest, type ChangePasswordResult, type CreateBffAuthClientOptions, type CreateBffChangePasswordClientOptions, DEFAULT_ACCOUNT_SETTINGS_LABELS, DEFAULT_AUTH_CARD_MAX_WIDTH, DEFAULT_DEMO_CREDENTIALS_HINT_LABELS, DEFAULT_DEVICE_PIN_ENROLL_LABELS, DEFAULT_DEVICE_PIN_SETTINGS_LABELS, DEFAULT_DEVICE_PIN_UNLOCK_LABELS, DEFAULT_FORGOT_PASSWORD_FIELDS_LABELS, DEFAULT_FORGOT_PASSWORD_LABELS, DEFAULT_LOGIN_LABELS, DEFAULT_OTP_LABELS, DEFAULT_PASSKEY_LOGIN_LABELS, DEFAULT_PASSKEY_SETTINGS_LABELS, DEFAULT_PIN_LABELS, DEFAULT_PREFERRED_METHOD_HINT_LABELS, DEFAULT_PREFERRED_METHOD_SETTINGS_LABELS, DEFAULT_REGISTER_LABELS, DEFAULT_RESET_PASSWORD_LABELS, DEVICE_PIN_ALLOWED_DIGITS, DEVICE_PIN_DEFAULT_DIGITS, DemoCredentialsHint, type DemoCredentialsHintLabels, type DemoCredentialsHintProps, DemoCredentialsHintVariant, type DemoCredentialsHintWiring, type DemoCredentialsLoginFormProps, type DevicePinCapableClient, type DevicePinDisableCapableClient, type DevicePinEnrollCapableClient, DevicePinEnrollErrorKey, DevicePinEnrollForm, type DevicePinEnrollFormProps, type DevicePinEnrollLabels, type DevicePinEnrollResult, DevicePinErrorKey, DevicePinInput, type DevicePinInputProps, DevicePinLengthPicker, type DevicePinLengthPickerProps, DevicePinOffer, type DevicePinOfferProps, DevicePinSettingsCard, type DevicePinSettingsCardProps, type DevicePinSettingsLabels, type DevicePinUnlockCapableClient, type DevicePinUnlockLabels, type DevicePinUnlockResult, DevicePinUnlockScreen, type DevicePinUnlockScreenProps, type DevicePinUnlockedUser, ForgotPasswordFields, type ForgotPasswordFieldsLabels, type ForgotPasswordFieldsProps, ForgotPasswordForm, type ForgotPasswordFormLabels, type ForgotPasswordFormProps, type LoginConfigCapableClient, LoginForm, type LoginFormLabels, type LoginFormProps, OtpForm, type OtpFormLabels, type OtpFormProps, OtpLoginStep, PASSWORD_MAX_LENGTH, PASSWORD_MIN_LENGTH, PasskeyCeremonyMode, PasskeyCeremonyStatus, type PasskeyErrorCode, PasskeyLoginButton, type PasskeyLoginButtonProps, type PasskeyLoginLabels, PasskeySettingsCard, type PasskeySettingsCardProps, type PasskeySettingsLabels, PasswordPolicyError, type PerformBffLogoutOptions, PinForm, type PinFormLabels, type PinFormProps, type PreferencesClientOptions, type PreferredMethodClient, PreferredMethodHint, type PreferredMethodHintLabels, type PreferredMethodHintProps, PreferredMethodSettingsCard, type PreferredMethodSettingsCardProps, type PreferredMethodSettingsLabels, PrefillIntent, RegisterErrorCode, type RegisterField, type RegisterFieldLabels, RegisterForm, type RegisterFormLabels, type RegisterFormProps, type RegisterFormValues, type RegisterInputField, type RegisterPasswordPolicy, type RegisterSubmitOutcome, type RegisterSubmitValues, RegisterTestIds, ResetPasswordError, ResetPasswordForm, type ResetPasswordFormLabels, type ResetPasswordFormProps, type RoleRoute, type RoleRouteTable, type UseBffAuthOptions, type UseBffAuthResult, type UseBffForgotPasswordOptions, type UseBffLoginConfigResult, type UseBffResetPasswordOptions, type UseChangePasswordArgs, type UseChangePasswordResult, type UseDemoCredentialsOptions, type UseDemoCredentialsResult, type UseDevicePinDisableArgs, type UseDevicePinDisableResult, type UseDevicePinEnrollArgs, type UseDevicePinEnrollResult, type UseDevicePinUnlockArgs, type UseDevicePinUnlockResult, type UseForgotPasswordSubmitArgs, type UseForgotPasswordSubmitResult, type UseOtpLoginOptions, type UseOtpLoginResult, type UsePasskeyCeremonyOptions, type UsePasskeyCeremonyResult, type UsePinLoginOptions, type UsePinLoginResult, type UsePreferredMethodSettingArgs, type UsePreferredMethodSettingResult, type UseRegisterFormArgs, type UseRegisterFormResult, type UseResetPasswordFormArgs, type UseResetPasswordFormResult, cachePreferredMethod, clearCachedPreferredMethod, collectUserRoles, createBffAuthClient, createBffChangePasswordClient, createPreferencesClient, defaultAuthTheme, isAllowedPinDigits, isPasswordValid, isRegisterPasswordStrong, isValidForgotPasswordEmail, mapRegisterErrorCode, performBffLogout, readCachedPreferredMethod, readPasskeyError, readPasskeyRegistered, resolveAccessibleRoutes, resolveAccountList, resolveDemoAccounts, resolveDemoCredentials, resolvePostLoginRoute, startPasskeyLogin, startPasskeyRegistration, syncPreferredMethodFromServer, useAuthTheme, useBffAuth, useBffForgotPassword, useBffLoginConfig, useBffResetPassword, useChangePassword, useDemoCredentials, useDevicePinDisable, useDevicePinEnroll, useDevicePinUnlock, useForgotPasswordSubmit, useOtpLogin, usePasskeyCeremony, usePinLogin, usePreferredMethodSetting, useRegisterForm, useResetPasswordForm, validatePasswordPolicy, withTestIdPrefix };
+export { type AccountSettingsChangePasswordConfig, type AccountSettingsDevicePinConfig, type AccountSettingsLabels, type AccountSettingsPasskeysConfig, type AccountSettingsPreferredMethodConfig, AccountSettingsScreen, type AccountSettingsScreenProps, AuthScreen, type AuthScreenProps, AuthTestIds, type AuthTheme, type AuthThemeColors, AuthThemeProvider, type AuthThemeProviderProps, type AuthThemeRadii, type AuthThemeSpacing, type AuthThemeTypography, BffAuthStatus, type BffDeviceState, type BffLoginConfig, type BffLogoutClient, CHANGE_PASSWORD_ENDPOINT, type ChangePasswordCapableClient, ChangePasswordCard, type ChangePasswordCardProps, ChangePasswordErrorKey, type ChangePasswordRequest, type ChangePasswordResult, type CreateBffAuthClientOptions, type CreateBffChangePasswordClientOptions, DEFAULT_ACCOUNT_SETTINGS_LABELS, DEFAULT_AUTH_CARD_MAX_WIDTH, DEFAULT_DEMO_CREDENTIALS_HINT_LABELS, DEFAULT_DEVICE_PIN_ENROLL_LABELS, DEFAULT_DEVICE_PIN_SETTINGS_LABELS, DEFAULT_DEVICE_PIN_UNLOCK_LABELS, DEFAULT_FORGOT_PASSWORD_FIELDS_LABELS, DEFAULT_FORGOT_PASSWORD_LABELS, DEFAULT_LOGIN_LABELS, DEFAULT_OTP_LABELS, DEFAULT_PASSKEY_LOGIN_LABELS, DEFAULT_PASSKEY_SETTINGS_LABELS, DEFAULT_PIN_LABELS, DEFAULT_PREFERRED_METHOD_HINT_LABELS, DEFAULT_PREFERRED_METHOD_SETTINGS_LABELS, DEFAULT_REGISTER_LABELS, DEFAULT_RESET_PASSWORD_LABELS, DEVICE_PIN_ALLOWED_DIGITS, DEVICE_PIN_DEFAULT_DIGITS, DemoCredentialsHint, type DemoCredentialsHintLabels, type DemoCredentialsHintProps, DemoCredentialsHintVariant, type DemoCredentialsHintWiring, type DemoCredentialsLoginFormProps, type DevicePinCapableClient, type DevicePinDisableCapableClient, type DevicePinEnrollCapableClient, DevicePinEnrollErrorKey, DevicePinEnrollForm, type DevicePinEnrollFormProps, type DevicePinEnrollLabels, type DevicePinEnrollResult, DevicePinErrorKey, DevicePinInput, type DevicePinInputProps, DevicePinLengthPicker, type DevicePinLengthPickerProps, DevicePinOffer, type DevicePinOfferProps, DevicePinSettingsCard, type DevicePinSettingsCardProps, type DevicePinSettingsLabels, type DevicePinUnlockCapableClient, type DevicePinUnlockLabels, type DevicePinUnlockResult, DevicePinUnlockScreen, type DevicePinUnlockScreenProps, type DevicePinUnlockedUser, ForgotPasswordFields, type ForgotPasswordFieldsLabels, type ForgotPasswordFieldsProps, ForgotPasswordForm, type ForgotPasswordFormLabels, type ForgotPasswordFormProps, type LoginConfigCapableClient, LoginForm, type LoginFormLabels, type LoginFormProps, OtpForm, type OtpFormLabels, type OtpFormProps, OtpLoginStep, PASSWORD_MAX_LENGTH, PASSWORD_MIN_LENGTH, PasskeyCeremonyMode, PasskeyCeremonyStatus, type PasskeyErrorCode, PasskeyLoginButton, type PasskeyLoginButtonProps, type PasskeyLoginLabels, PasskeySettingsCard, type PasskeySettingsCardProps, type PasskeySettingsLabels, PasswordPolicyError, type PerformBffLogoutOptions, PinForm, type PinFormLabels, type PinFormProps, type PreferencesClientOptions, type PreferredMethodClient, PreferredMethodHint, type PreferredMethodHintLabels, type PreferredMethodHintProps, PreferredMethodSettingsCard, type PreferredMethodSettingsCardProps, type PreferredMethodSettingsLabels, PrefillIntent, RegisterErrorCode, type RegisterField, type RegisterFieldLabels, RegisterForm, type RegisterFormLabels, type RegisterFormProps, type RegisterFormValues, type RegisterInputField, type RegisterPasswordPolicy, type RegisterSubmitOutcome, type RegisterSubmitValues, RegisterTestIds, ResetPasswordError, ResetPasswordForm, type ResetPasswordFormLabels, type ResetPasswordFormProps, type RoleRoute, type RoleRouteTable, type UseBffAuthOptions, type UseBffAuthResult, type UseBffForgotPasswordOptions, type UseBffLoginConfigResult, type UseBffResetPasswordOptions, type UseChangePasswordArgs, type UseChangePasswordResult, type UseDemoCredentialsOptions, type UseDemoCredentialsResult, type UseDevicePinDisableArgs, type UseDevicePinDisableResult, type UseDevicePinEnrollArgs, type UseDevicePinEnrollResult, type UseDevicePinUnlockArgs, type UseDevicePinUnlockResult, type UseForgotPasswordSubmitArgs, type UseForgotPasswordSubmitResult, type UseOtpLoginOptions, type UseOtpLoginResult, type UsePasskeyCeremonyOptions, type UsePasskeyCeremonyResult, type UsePinLoginOptions, type UsePinLoginResult, type UsePreferredMethodSettingArgs, type UsePreferredMethodSettingResult, type UseRegisterFormArgs, type UseRegisterFormResult, type UseResetPasswordFormArgs, type UseResetPasswordFormResult, cachePreferredMethod, clearCachedPreferredMethod, collectUserRoles, createBffAuthClient, createBffChangePasswordClient, createPreferencesClient, defaultAuthTheme, isAllowedPinDigits, isPasswordValid, isRegisterPasswordStrong, isValidForgotPasswordEmail, performBffLogout, readCachedPreferredMethod, readPasskeyError, readPasskeyRegistered, resolveAccessibleRoutes, resolveAccountList, resolveDemoAccounts, resolveDemoCredentials, resolvePostLoginRoute, startPasskeyLogin, startPasskeyRegistration, syncPreferredMethodFromServer, useAuthTheme, useBffAuth, useBffForgotPassword, useBffLoginConfig, useBffResetPassword, useChangePassword, useDemoCredentials, useDevicePinDisable, useDevicePinEnroll, useDevicePinUnlock, useForgotPasswordSubmit, useOtpLogin, usePasskeyCeremony, usePinLogin, usePreferredMethodSetting, useRegisterForm, useResetPasswordForm, validatePasswordPolicy, withTestIdPrefix };

package/dist/index.d.ts

@@ -2460,7 +2460,7 @@ interface RegisterFormProps<TResult> {
     onSuccess: (result: TResult) => void;
     /** Called with the failure code; map it to localised copy. */
     onError?: (error: RegisterErrorCode) => void;
-    /** Called on every submit press, before validation (e.g. a "signup started" event). */
+    /** Called once per accepted submit, before validation (e.g. a "signup started" event); never for a press ignored in flight. */
     onSubmitAttempt?: () => void;
     /** Password rule. Defaults to `isRegisterPasswordStrong`. */
     passwordPolicy?: RegisterPasswordPolicy;
@@ -2506,6 +2506,11 @@ interface UseRegisterFormArgs<TResult> {
     onSubmit: (values: RegisterSubmitValues) => Promise<TResult>;
     /** Password rule. Defaults to {@link isRegisterPasswordStrong}. */
     passwordPolicy?: RegisterPasswordPolicy;
+    /**
+     * Called once per ACCEPTED submit, before validation (e.g. a "signup started"
+     * event). A press ignored because a submit is already in flight does not call it.
+     */
+    onSubmitAttempt?: () => void;
 }
 interface UseRegisterFormResult<TResult> {
     state: RegisterFormValues;
@@ -2516,7 +2521,7 @@ interface UseRegisterFormResult<TResult> {
     error: RegisterErrorCode | null;
 }
 /** Headless registration form logic. */
-declare function useRegisterForm<TResult>({ onSubmit, passwordPolicy, }: UseRegisterFormArgs<TResult>): UseRegisterFormResult<TResult>;
+declare function useRegisterForm<TResult>({ onSubmit, passwordPolicy, onSubmitAttempt, }: UseRegisterFormArgs<TResult>): UseRegisterFormResult<TResult>;
 
 /**
  * Pure registration helpers: trimming, client-side validation and decoding of a
@@ -2529,8 +2534,6 @@ declare function useRegisterForm<TResult>({ onSubmit, passwordPolicy, }: UseRegi
 
 /** The default password rule: 8+ characters with a letter, a digit and a special character. */
 declare function isRegisterPasswordStrong(password: string): boolean;
-/** Decode a thrown registration failure into a {@link RegisterErrorCode}. */
-declare function mapRegisterErrorCode(error: unknown): RegisterErrorCode;
 
 /**
  * `createBffAuthClient` — the one-line wiring of a same-origin `BffAuthClient`.
@@ -2821,4 +2824,4 @@ interface UseChangePasswordResult {
 }
 declare function useChangePassword({ client, onChanged, }: UseChangePasswordArgs): UseChangePasswordResult;
 
-export { type AccountSettingsChangePasswordConfig, type AccountSettingsDevicePinConfig, type AccountSettingsLabels, type AccountSettingsPasskeysConfig, type AccountSettingsPreferredMethodConfig, AccountSettingsScreen, type AccountSettingsScreenProps, AuthScreen, type AuthScreenProps, AuthTestIds, type AuthTheme, type AuthThemeColors, AuthThemeProvider, type AuthThemeProviderProps, type AuthThemeRadii, type AuthThemeSpacing, type AuthThemeTypography, BffAuthStatus, type BffDeviceState, type BffLoginConfig, type BffLogoutClient, CHANGE_PASSWORD_ENDPOINT, type ChangePasswordCapableClient, ChangePasswordCard, type ChangePasswordCardProps, ChangePasswordErrorKey, type ChangePasswordRequest, type ChangePasswordResult, type CreateBffAuthClientOptions, type CreateBffChangePasswordClientOptions, DEFAULT_ACCOUNT_SETTINGS_LABELS, DEFAULT_AUTH_CARD_MAX_WIDTH, DEFAULT_DEMO_CREDENTIALS_HINT_LABELS, DEFAULT_DEVICE_PIN_ENROLL_LABELS, DEFAULT_DEVICE_PIN_SETTINGS_LABELS, DEFAULT_DEVICE_PIN_UNLOCK_LABELS, DEFAULT_FORGOT_PASSWORD_FIELDS_LABELS, DEFAULT_FORGOT_PASSWORD_LABELS, DEFAULT_LOGIN_LABELS, DEFAULT_OTP_LABELS, DEFAULT_PASSKEY_LOGIN_LABELS, DEFAULT_PASSKEY_SETTINGS_LABELS, DEFAULT_PIN_LABELS, DEFAULT_PREFERRED_METHOD_HINT_LABELS, DEFAULT_PREFERRED_METHOD_SETTINGS_LABELS, DEFAULT_REGISTER_LABELS, DEFAULT_RESET_PASSWORD_LABELS, DEVICE_PIN_ALLOWED_DIGITS, DEVICE_PIN_DEFAULT_DIGITS, DemoCredentialsHint, type DemoCredentialsHintLabels, type DemoCredentialsHintProps, DemoCredentialsHintVariant, type DemoCredentialsHintWiring, type DemoCredentialsLoginFormProps, type DevicePinCapableClient, type DevicePinDisableCapableClient, type DevicePinEnrollCapableClient, DevicePinEnrollErrorKey, DevicePinEnrollForm, type DevicePinEnrollFormProps, type DevicePinEnrollLabels, type DevicePinEnrollResult, DevicePinErrorKey, DevicePinInput, type DevicePinInputProps, DevicePinLengthPicker, type DevicePinLengthPickerProps, DevicePinOffer, type DevicePinOfferProps, DevicePinSettingsCard, type DevicePinSettingsCardProps, type DevicePinSettingsLabels, type DevicePinUnlockCapableClient, type DevicePinUnlockLabels, type DevicePinUnlockResult, DevicePinUnlockScreen, type DevicePinUnlockScreenProps, type DevicePinUnlockedUser, ForgotPasswordFields, type ForgotPasswordFieldsLabels, type ForgotPasswordFieldsProps, ForgotPasswordForm, type ForgotPasswordFormLabels, type ForgotPasswordFormProps, type LoginConfigCapableClient, LoginForm, type LoginFormLabels, type LoginFormProps, OtpForm, type OtpFormLabels, type OtpFormProps, OtpLoginStep, PASSWORD_MAX_LENGTH, PASSWORD_MIN_LENGTH, PasskeyCeremonyMode, PasskeyCeremonyStatus, type PasskeyErrorCode, PasskeyLoginButton, type PasskeyLoginButtonProps, type PasskeyLoginLabels, PasskeySettingsCard, type PasskeySettingsCardProps, type PasskeySettingsLabels, PasswordPolicyError, type PerformBffLogoutOptions, PinForm, type PinFormLabels, type PinFormProps, type PreferencesClientOptions, type PreferredMethodClient, PreferredMethodHint, type PreferredMethodHintLabels, type PreferredMethodHintProps, PreferredMethodSettingsCard, type PreferredMethodSettingsCardProps, type PreferredMethodSettingsLabels, PrefillIntent, RegisterErrorCode, type RegisterField, type RegisterFieldLabels, RegisterForm, type RegisterFormLabels, type RegisterFormProps, type RegisterFormValues, type RegisterInputField, type RegisterPasswordPolicy, type RegisterSubmitOutcome, type RegisterSubmitValues, RegisterTestIds, ResetPasswordError, ResetPasswordForm, type ResetPasswordFormLabels, type ResetPasswordFormProps, type RoleRoute, type RoleRouteTable, type UseBffAuthOptions, type UseBffAuthResult, type UseBffForgotPasswordOptions, type UseBffLoginConfigResult, type UseBffResetPasswordOptions, type UseChangePasswordArgs, type UseChangePasswordResult, type UseDemoCredentialsOptions, type UseDemoCredentialsResult, type UseDevicePinDisableArgs, type UseDevicePinDisableResult, type UseDevicePinEnrollArgs, type UseDevicePinEnrollResult, type UseDevicePinUnlockArgs, type UseDevicePinUnlockResult, type UseForgotPasswordSubmitArgs, type UseForgotPasswordSubmitResult, type UseOtpLoginOptions, type UseOtpLoginResult, type UsePasskeyCeremonyOptions, type UsePasskeyCeremonyResult, type UsePinLoginOptions, type UsePinLoginResult, type UsePreferredMethodSettingArgs, type UsePreferredMethodSettingResult, type UseRegisterFormArgs, type UseRegisterFormResult, type UseResetPasswordFormArgs, type UseResetPasswordFormResult, cachePreferredMethod, clearCachedPreferredMethod, collectUserRoles, createBffAuthClient, createBffChangePasswordClient, createPreferencesClient, defaultAuthTheme, isAllowedPinDigits, isPasswordValid, isRegisterPasswordStrong, isValidForgotPasswordEmail, mapRegisterErrorCode, performBffLogout, readCachedPreferredMethod, readPasskeyError, readPasskeyRegistered, resolveAccessibleRoutes, resolveAccountList, resolveDemoAccounts, resolveDemoCredentials, resolvePostLoginRoute, startPasskeyLogin, startPasskeyRegistration, syncPreferredMethodFromServer, useAuthTheme, useBffAuth, useBffForgotPassword, useBffLoginConfig, useBffResetPassword, useChangePassword, useDemoCredentials, useDevicePinDisable, useDevicePinEnroll, useDevicePinUnlock, useForgotPasswordSubmit, useOtpLogin, usePasskeyCeremony, usePinLogin, usePreferredMethodSetting, useRegisterForm, useResetPasswordForm, validatePasswordPolicy, withTestIdPrefix };
+export { type AccountSettingsChangePasswordConfig, type AccountSettingsDevicePinConfig, type AccountSettingsLabels, type AccountSettingsPasskeysConfig, type AccountSettingsPreferredMethodConfig, AccountSettingsScreen, type AccountSettingsScreenProps, AuthScreen, type AuthScreenProps, AuthTestIds, type AuthTheme, type AuthThemeColors, AuthThemeProvider, type AuthThemeProviderProps, type AuthThemeRadii, type AuthThemeSpacing, type AuthThemeTypography, BffAuthStatus, type BffDeviceState, type BffLoginConfig, type BffLogoutClient, CHANGE_PASSWORD_ENDPOINT, type ChangePasswordCapableClient, ChangePasswordCard, type ChangePasswordCardProps, ChangePasswordErrorKey, type ChangePasswordRequest, type ChangePasswordResult, type CreateBffAuthClientOptions, type CreateBffChangePasswordClientOptions, DEFAULT_ACCOUNT_SETTINGS_LABELS, DEFAULT_AUTH_CARD_MAX_WIDTH, DEFAULT_DEMO_CREDENTIALS_HINT_LABELS, DEFAULT_DEVICE_PIN_ENROLL_LABELS, DEFAULT_DEVICE_PIN_SETTINGS_LABELS, DEFAULT_DEVICE_PIN_UNLOCK_LABELS, DEFAULT_FORGOT_PASSWORD_FIELDS_LABELS, DEFAULT_FORGOT_PASSWORD_LABELS, DEFAULT_LOGIN_LABELS, DEFAULT_OTP_LABELS, DEFAULT_PASSKEY_LOGIN_LABELS, DEFAULT_PASSKEY_SETTINGS_LABELS, DEFAULT_PIN_LABELS, DEFAULT_PREFERRED_METHOD_HINT_LABELS, DEFAULT_PREFERRED_METHOD_SETTINGS_LABELS, DEFAULT_REGISTER_LABELS, DEFAULT_RESET_PASSWORD_LABELS, DEVICE_PIN_ALLOWED_DIGITS, DEVICE_PIN_DEFAULT_DIGITS, DemoCredentialsHint, type DemoCredentialsHintLabels, type DemoCredentialsHintProps, DemoCredentialsHintVariant, type DemoCredentialsHintWiring, type DemoCredentialsLoginFormProps, type DevicePinCapableClient, type DevicePinDisableCapableClient, type DevicePinEnrollCapableClient, DevicePinEnrollErrorKey, DevicePinEnrollForm, type DevicePinEnrollFormProps, type DevicePinEnrollLabels, type DevicePinEnrollResult, DevicePinErrorKey, DevicePinInput, type DevicePinInputProps, DevicePinLengthPicker, type DevicePinLengthPickerProps, DevicePinOffer, type DevicePinOfferProps, DevicePinSettingsCard, type DevicePinSettingsCardProps, type DevicePinSettingsLabels, type DevicePinUnlockCapableClient, type DevicePinUnlockLabels, type DevicePinUnlockResult, DevicePinUnlockScreen, type DevicePinUnlockScreenProps, type DevicePinUnlockedUser, ForgotPasswordFields, type ForgotPasswordFieldsLabels, type ForgotPasswordFieldsProps, ForgotPasswordForm, type ForgotPasswordFormLabels, type ForgotPasswordFormProps, type LoginConfigCapableClient, LoginForm, type LoginFormLabels, type LoginFormProps, OtpForm, type OtpFormLabels, type OtpFormProps, OtpLoginStep, PASSWORD_MAX_LENGTH, PASSWORD_MIN_LENGTH, PasskeyCeremonyMode, PasskeyCeremonyStatus, type PasskeyErrorCode, PasskeyLoginButton, type PasskeyLoginButtonProps, type PasskeyLoginLabels, PasskeySettingsCard, type PasskeySettingsCardProps, type PasskeySettingsLabels, PasswordPolicyError, type PerformBffLogoutOptions, PinForm, type PinFormLabels, type PinFormProps, type PreferencesClientOptions, type PreferredMethodClient, PreferredMethodHint, type PreferredMethodHintLabels, type PreferredMethodHintProps, PreferredMethodSettingsCard, type PreferredMethodSettingsCardProps, type PreferredMethodSettingsLabels, PrefillIntent, RegisterErrorCode, type RegisterField, type RegisterFieldLabels, RegisterForm, type RegisterFormLabels, type RegisterFormProps, type RegisterFormValues, type RegisterInputField, type RegisterPasswordPolicy, type RegisterSubmitOutcome, type RegisterSubmitValues, RegisterTestIds, ResetPasswordError, ResetPasswordForm, type ResetPasswordFormLabels, type ResetPasswordFormProps, type RoleRoute, type RoleRouteTable, type UseBffAuthOptions, type UseBffAuthResult, type UseBffForgotPasswordOptions, type UseBffLoginConfigResult, type UseBffResetPasswordOptions, type UseChangePasswordArgs, type UseChangePasswordResult, type UseDemoCredentialsOptions, type UseDemoCredentialsResult, type UseDevicePinDisableArgs, type UseDevicePinDisableResult, type UseDevicePinEnrollArgs, type UseDevicePinEnrollResult, type UseDevicePinUnlockArgs, type UseDevicePinUnlockResult, type UseForgotPasswordSubmitArgs, type UseForgotPasswordSubmitResult, type UseOtpLoginOptions, type UseOtpLoginResult, type UsePasskeyCeremonyOptions, type UsePasskeyCeremonyResult, type UsePinLoginOptions, type UsePinLoginResult, type UsePreferredMethodSettingArgs, type UsePreferredMethodSettingResult, type UseRegisterFormArgs, type UseRegisterFormResult, type UseResetPasswordFormArgs, type UseResetPasswordFormResult, cachePreferredMethod, clearCachedPreferredMethod, collectUserRoles, createBffAuthClient, createBffChangePasswordClient, createPreferencesClient, defaultAuthTheme, isAllowedPinDigits, isPasswordValid, isRegisterPasswordStrong, isValidForgotPasswordEmail, performBffLogout, readCachedPreferredMethod, readPasskeyError, readPasskeyRegistered, resolveAccessibleRoutes, resolveAccountList, resolveDemoAccounts, resolveDemoCredentials, resolvePostLoginRoute, startPasskeyLogin, startPasskeyRegistration, syncPreferredMethodFromServer, useAuthTheme, useBffAuth, useBffForgotPassword, useBffLoginConfig, useBffResetPassword, useChangePassword, useDemoCredentials, useDevicePinDisable, useDevicePinEnroll, useDevicePinUnlock, useForgotPasswordSubmit, useOtpLogin, usePasskeyCeremony, usePinLogin, usePreferredMethodSetting, useRegisterForm, useResetPasswordForm, validatePasswordPolicy, withTestIdPrefix };

package/dist/index.js

@@ -3,6 +3,7 @@
 var reactNative = require('react-native');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
+var uiButtons = require('@dloizides/ui-buttons');
 var reactQuery = require('@tanstack/react-query');
 var authClient = require('@dloizides/auth-client');
 
@@ -637,6 +638,21 @@ function useLoginSubmit({
   }, [runLogin]);
   return { errorText, handleSubmit };
 }
+function isKeyRepeat(event) {
+  const native = event?.nativeEvent;
+  return native?.repeat === true;
+}
+function useSubmitOnEnter(submit) {
+  return react.useCallback(
+    (event) => {
+      if (isKeyRepeat(event)) {
+        return;
+      }
+      submit();
+    },
+    [submit]
+  );
+}
 var BffAuthStatus = /* @__PURE__ */ ((BffAuthStatus2) => {
   BffAuthStatus2["Loading"] = "loading";
   BffAuthStatus2["Authenticated"] = "authenticated";
@@ -775,7 +791,7 @@ function LoginForm({
     missingFieldsLabel: labels.missingFields,
     invalidCredentialsLabel: labels.invalidCredentials
   });
-  const submitButtonStyle = isSubmitting ? [styles3.primaryButton, styles3.primaryButtonDisabled] : styles3.primaryButton;
+  const handleSubmitEditing = useSubmitOnEnter(handleSubmit);
   const content = /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
     /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: styles3.title, children: labels.title }),
     /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: styles3.subtitle, children: labels.subtitle }),
@@ -791,10 +807,12 @@ function LoginForm({
           editable: !isSubmitting,
           placeholder: labels.usernamePlaceholder,
           placeholderTextColor: theme.colors.textSecondary,
+          returnKeyType: "go",
           style: styles3.input,
           testID: withTestIdPrefix(AuthTestIds.loginUsernameInput, testIdPrefix),
           value: username,
-          onChangeText: setUsername
+          onChangeText: setUsername,
+          onSubmitEditing: handleSubmitEditing
         }
       )
     ] }),
@@ -811,10 +829,12 @@ function LoginForm({
           editable: !isSubmitting,
           placeholder: labels.passwordPlaceholder,
           placeholderTextColor: theme.colors.textSecondary,
+          returnKeyType: "go",
           style: styles3.input,
           testID: withTestIdPrefix(AuthTestIds.loginPasswordInput, testIdPrefix),
           value: password,
-          onChangeText: setPassword
+          onChangeText: setPassword,
+          onSubmitEditing: handleSubmitEditing
         }
       )
     ] }),
@@ -839,19 +859,18 @@ function LoginForm({
         children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: styles3.linkText, children: labels.forgotPassword })
       }
     ) : null,
-    /* @__PURE__ */ jsxRuntime.jsx(
-      reactNative.TouchableOpacity,
+    /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: styles3.fieldGroup, children: /* @__PURE__ */ jsxRuntime.jsx(
+      uiButtons.Button,
       {
+        fullWidth: true,
         accessibilityHint: labels.submit,
         accessibilityLabel: isSubmitting ? labels.submitting : labels.submit,
-        accessibilityRole: "button",
-        disabled: isSubmitting,
-        style: submitButtonStyle,
+        label: labels.submit,
+        loading: isSubmitting,
         testID: withTestIdPrefix(AuthTestIds.loginSubmitButton, testIdPrefix),
-        onPress: handleSubmit,
-        children: isSubmitting ? /* @__PURE__ */ jsxRuntime.jsx(reactNative.ActivityIndicator, { color: theme.colors.onPrimary, size: "small" }) : /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: styles3.primaryButtonText, children: labels.submit })
+        onPress: handleSubmit
       }
-    ),
+    ) }),
     onSignUp !== void 0 ? /* @__PURE__ */ jsxRuntime.jsx(
       reactNative.TouchableOpacity,
       {
@@ -4095,6 +4114,7 @@ function RegisterFormFields({
   theme,
   styles: styles3,
   onChange,
+  onSubmitEditing,
   testIdPrefix
 }) {
   return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
@@ -4114,11 +4134,13 @@ function RegisterFormFields({
             keyboardType: config.keyboardType ?? "default",
             placeholder: copy.placeholder,
             placeholderTextColor: theme.colors.textSecondary,
+            returnKeyType: "go",
             secureTextEntry: config.secure === true,
             style: styles3.input,
             testID: withTestIdPrefix(config.testId, testIdPrefix),
             value: values[config.key],
-            onChangeText: (text) => onChange(config.key, text)
+            onChangeText: (text) => onChange(config.key, text),
+            onSubmitEditing
           }
         )
       ] }, config.key);
@@ -4127,6 +4149,7 @@ function RegisterFormFields({
       reactNative.TextInput,
       {
         accessibilityElementsHidden: true,
+        accessibilityRole: "none",
         autoComplete: "off",
         focusable: false,
         importantForAccessibility: "no-hide-descendants",
@@ -4155,9 +4178,21 @@ var RegisterErrorCode = /* @__PURE__ */ ((RegisterErrorCode2) => {
   return RegisterErrorCode2;
 })(RegisterErrorCode || {});
 
+// src/hooks/routeRegisterOutcome.ts
+function routeRegisterOutcome(outcome, handlers) {
+  if (outcome.ok) {
+    handlers.onSuccess(outcome.result);
+    return;
+  }
+  if (outcome.error !== "inFlight" /* InFlight */) {
+    handlers.onError?.(outcome.error);
+  }
+}
+
 // src/hooks/registerErrors.ts
 var MIN_PASSWORD_LENGTH = 8;
-var EMAIL_REGEX4 = /^[^@\s]+@[^.\s]+\.\S+$/;
+var WHITESPACE_REGEX = /\s/;
+var EMAIL_PART_COUNT = 2;
 var PASSWORD_LETTER_REGEX = /[a-zA-Z]/;
 var PASSWORD_DIGIT_REGEX = /\d/;
 var PASSWORD_SPECIAL_REGEX = /[^a-zA-Z0-9]/;
@@ -4179,6 +4214,17 @@ function isRegisterPasswordStrong(password) {
   }
   return PASSWORD_SPECIAL_REGEX.test(password);
 }
+function isEmailShaped(email) {
+  if (WHITESPACE_REGEX.test(email)) {
+    return false;
+  }
+  const parts = email.split("@");
+  if (parts.length !== EMAIL_PART_COUNT) {
+    return false;
+  }
+  const [local = "", domain = ""] = parts;
+  return local !== "" && domain.slice(1, -1).includes(".");
+}
 function trimRegisterValues(values) {
   return {
     firstName: values.firstName.trim(),
@@ -4206,7 +4252,7 @@ function validateRegisterValues(values, passwordPolicy) {
   if (hasMissingRequiredField(values)) {
     return "missingFields" /* MissingFields */;
   }
-  if (!EMAIL_REGEX4.test(values.email)) {
+  if (!isEmailShaped(values.email)) {
     return "invalidEmail" /* InvalidEmail */;
   }
   if (!passwordPolicy(values.password)) {
@@ -4256,7 +4302,8 @@ function toSubmitValues(values) {
 }
 function useRegisterForm({
   onSubmit,
-  passwordPolicy = isRegisterPasswordStrong
+  passwordPolicy = isRegisterPasswordStrong,
+  onSubmitAttempt
 }) {
   const [state, setState] = react.useState(EMPTY_VALUES);
   const [isSubmitting, setIsSubmitting] = react.useState(false);
@@ -4269,6 +4316,7 @@ function useRegisterForm({
     if (inFlight.current) {
       return { ok: false, error: "inFlight" /* InFlight */ };
     }
+    onSubmitAttempt?.();
     const trimmed = trimRegisterValues(state);
     const refusal = trimmed.website === "" ? validateRegisterValues(trimmed, passwordPolicy) : "failed" /* Failed */;
     if (refusal !== null) {
@@ -4289,7 +4337,7 @@ function useRegisterForm({
       inFlight.current = false;
       setIsSubmitting(false);
     }
-  }, [onSubmit, passwordPolicy, state]);
+  }, [onSubmit, onSubmitAttempt, passwordPolicy, state]);
   return { state, setField, submit, isSubmitting, error };
 }
 function RegisterForm({
@@ -4309,18 +4357,15 @@ function RegisterForm({
     () => ({ ...DEFAULT_REGISTER_LABELS, ...labelsProp }),
     [labelsProp]
   );
-  const { state, setField, submit, isSubmitting } = useRegisterForm({ onSubmit, passwordPolicy });
-  const handlePress = react.useCallback(() => {
-    onSubmitAttempt?.();
-    void submit().then((outcome) => {
-      if (outcome.ok) {
-        onSuccess(outcome.result);
-      } else if (outcome.error !== "inFlight" /* InFlight */) {
-        onError?.(outcome.error);
-      }
-    });
-  }, [onError, onSubmitAttempt, onSuccess, submit]);
-  const buttonStyle = isSubmitting ? [styles3.primaryButton, styles3.primaryButtonDisabled] : styles3.primaryButton;
+  const { state, setField, submit, isSubmitting } = useRegisterForm({
+    onSubmit,
+    onSubmitAttempt,
+    passwordPolicy
+  });
+  const handlePress = react.useCallback(async () => {
+    routeRegisterOutcome(await submit(), { onSuccess, onError });
+  }, [onError, onSuccess, submit]);
+  const handleSubmitEditing = useSubmitOnEnter(handlePress);
   return /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: styles3.screen, children: /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: styles3.card, testID: withTestIdPrefix(RegisterTestIds.form, testIdPrefix), children: [
     /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: styles3.title, children: labels.title }),
     /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: styles3.subtitle, children: labels.subtitle }),
@@ -4333,22 +4378,22 @@ function RegisterForm({
         testIdPrefix,
         theme,
         values: state,
-        onChange: setField
+        onChange: setField,
+        onSubmitEditing: handleSubmitEditing
       }
     ),
-    /* @__PURE__ */ jsxRuntime.jsx(
-      reactNative.TouchableOpacity,
+    /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: styles3.fieldGroup, children: /* @__PURE__ */ jsxRuntime.jsx(
+      uiButtons.Button,
       {
+        fullWidth: true,
         accessibilityHint: labels.submitHint,
         accessibilityLabel: isSubmitting ? labels.submitting : labels.submit,
-        accessibilityRole: "button",
-        disabled: isSubmitting,
-        style: buttonStyle,
+        label: labels.submit,
+        loading: isSubmitting,
         testID: withTestIdPrefix(RegisterTestIds.submitButton, testIdPrefix),
-        onPress: handlePress,
-        children: isSubmitting ? /* @__PURE__ */ jsxRuntime.jsx(reactNative.ActivityIndicator, { color: theme.colors.onPrimary, size: "small" }) : /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: styles3.primaryButtonText, children: labels.submit })
+        onPress: handlePress
       }
-    ),
+    ) }),
     footer
   ] }) });
 }
@@ -4565,7 +4610,6 @@ exports.isAllowedPinDigits = isAllowedPinDigits;
 exports.isPasswordValid = isPasswordValid;
 exports.isRegisterPasswordStrong = isRegisterPasswordStrong;
 exports.isValidForgotPasswordEmail = isValidForgotPasswordEmail;
-exports.mapRegisterErrorCode = mapRegisterErrorCode;
 exports.performBffLogout = performBffLogout;
 exports.readCachedPreferredMethod = readCachedPreferredMethod;
 exports.readPasskeyError = readPasskeyError;