@dloizides/auth-web 1.18.3 → 1.20.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 1.20.0
+
+`mapRegisterErrorCode` reads the typed `status` + body `errorCode` that `@dloizides/auth-client` 4.5.0
+`BffRequestError` carries (duck-typed, so it needs no auth-client bump to compile). New codes:
+`TenantNameTaken` (409 `TENANT_NAME_TAKEN`), `RateLimited` (429) and `AutoLoginFailed` (account created, sign-in
+failed: tell the user to sign in, not to retry). `USER_EXISTS` maps to `EmailTaken`; 5xx to `Failed`. Consumers
+with an exhaustive `Record<RegisterErrorCode, string>` must add the three new keys.
+
+## 1.19.0
+
+**`<RegisterForm compact>` (AUTH-REG-1 "Compact register form").** Opt-in; the default seven-field form is unchanged.
+Shows only "Your name", Email, Password and the tenant name. The name is split into firstName/lastName (one word
+fills both, since Keycloak needs a last name), the username is derived from the whole email (lower-cased, chars
+outside `[a-z0-9._-]` become `_`), and there is no confirm-password field. New optional `labels.fullName`.
+`splitFullName` and `deriveUsernameFromEmail` are exported. `useRegisterForm({ compact })` for headless use.
+
 ## 1.18.3
 
 - `useLoginSubmit` has an in-flight ref guard, like `useRegisterForm`. A focused field stays read-only (not

package/dist/index.d.mts

@@ -525,10 +525,19 @@ declare const enum RegisterErrorCode {
     PasswordMismatch = "passwordMismatch",
     /** The server reported `USERNAME_TAKEN`. */
     UsernameTaken = "usernameTaken",
-    /** The server reported `EMAIL_TAKEN`. */
+    /** The server reported `EMAIL_TAKEN` or `USER_EXISTS` (409). */
     EmailTaken = "emailTaken",
     /** The server reported `REALM_REQUIRED` or `REALM_INVALID`. */
     RealmInvalid = "realmInvalid",
+    /** The server reported `TENANT_NAME_TAKEN` (409): the organisation / shop name is in use. */
+    TenantNameTaken = "tenantNameTaken",
+    /** The server rate-limited the request (HTTP 429). */
+    RateLimited = "rateLimited",
+    /**
+     * The account WAS created but the automatic sign-in failed (`AUTO_LOGIN_FAILED`).
+     * Tell the user to sign in; do not ask them to register again.
+     */
+    AutoLoginFailed = "autoLoginFailed",
     /** The server rejected the request with an unrecognised message. */
     ValidationFailed = "validationFailed",
     /** Generic failure: network error, empty message, or a filled honeypot (never revealed). */
@@ -592,6 +601,8 @@ interface RegisterFormLabels {
     /** `accessibilityLabel` for the submit button while the request runs. */
     submitting: string;
     fields: Record<RegisterInputField, RegisterFieldLabels>;
+    /** Copy for the single "Your name" input of the compact form. Defaults to English. */
+    fullName?: RegisterFieldLabels;
 }
 declare const DEFAULT_REGISTER_LABELS: RegisterFormLabels;
 
@@ -2472,9 +2483,15 @@ interface RegisterFormProps<TResult> {
     footer?: ReactNode;
     /** Prefix applied to every `testID`. */
     testIdPrefix?: string;
+    /**
+     * Opt-in compact form (AUTH-REG-1): only "Your name", Email, Password and the
+     * tenant name. First/last name are split from the name (one word fills both),
+     * the username is derived from the email, and there is no confirm-password field.
+     */
+    compact?: boolean;
 }
 /** Themeable registration form built on `useRegisterForm`. */
-declare function RegisterForm<TResult>({ onSubmit, onSuccess, onError, onSubmitAttempt, passwordPolicy, labels: labelsProp, theme: themeProp, footer, testIdPrefix, }: Readonly<RegisterFormProps<TResult>>): ReactElement;
+declare function RegisterForm<TResult>({ onSubmit, onSuccess, onError, onSubmitAttempt, passwordPolicy, labels: labelsProp, theme: themeProp, footer, testIdPrefix, compact, }: Readonly<RegisterFormProps<TResult>>): ReactElement;
 
 /**
  * `testID` values for `<RegisterForm>`.
@@ -2511,6 +2528,11 @@ interface UseRegisterFormArgs<TResult> {
      * event). A press ignored because a submit is already in flight does not call it.
      */
     onSubmitAttempt?: () => void;
+    /**
+     * Compact mode (AUTH-REG-1): `firstName` holds the full name; last name, username
+     * (from the email) and the password confirmation are derived before validation.
+     */
+    compact?: boolean;
 }
 interface UseRegisterFormResult<TResult> {
     state: RegisterFormValues;
@@ -2521,7 +2543,7 @@ interface UseRegisterFormResult<TResult> {
     error: RegisterErrorCode | null;
 }
 /** Headless registration form logic. */
-declare function useRegisterForm<TResult>({ onSubmit, passwordPolicy, onSubmitAttempt, }: UseRegisterFormArgs<TResult>): UseRegisterFormResult<TResult>;
+declare function useRegisterForm<TResult>({ onSubmit, passwordPolicy, onSubmitAttempt, compact, }: UseRegisterFormArgs<TResult>): UseRegisterFormResult<TResult>;
 
 /**
  * Pure registration helpers: trimming, client-side validation and decoding of a
@@ -2535,6 +2557,30 @@ declare function useRegisterForm<TResult>({ onSubmit, passwordPolicy, onSubmitAt
 /** The default password rule: 8+ characters with a letter, a digit and a special character. */
 declare function isRegisterPasswordStrong(password: string): boolean;
 
+/**
+ * Compact registration (AUTH-REG-1 "Compact register form"): the form shows only
+ * "Your name", Email, Password (+ tenant name). Keycloak still needs a username,
+ * a first name AND a last name, so they are derived here before validation.
+ *
+ * In compact mode the single "Your name" input is stored in `firstName`.
+ */
+
+interface SplitName {
+    firstName: string;
+    lastName: string;
+}
+/**
+ * Split a full name on whitespace: the first word is the first name, the rest the
+ * last name. A single word is used for both (Keycloak requires a last name).
+ */
+declare function splitFullName(fullName: string): SplitName;
+/**
+ * A username derived from the whole email (so two people with the same local part
+ * on different domains never collide): lower-cased, every char outside
+ * `[a-z0-9._-]` replaced by `_`. `Ada+shop@Example.com` becomes `ada_shop_example.com`.
+ */
+declare function deriveUsernameFromEmail(email: string): string;
+
 /**
  * `createBffAuthClient` — the one-line wiring of a same-origin `BffAuthClient`.
  *
@@ -2824,4 +2870,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, 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 SplitName, 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, deriveUsernameFromEmail, isAllowedPinDigits, isPasswordValid, isRegisterPasswordStrong, isValidForgotPasswordEmail, performBffLogout, readCachedPreferredMethod, readPasskeyError, readPasskeyRegistered, resolveAccessibleRoutes, resolveAccountList, resolveDemoAccounts, resolveDemoCredentials, resolvePostLoginRoute, splitFullName, 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

@@ -525,10 +525,19 @@ declare const enum RegisterErrorCode {
     PasswordMismatch = "passwordMismatch",
     /** The server reported `USERNAME_TAKEN`. */
     UsernameTaken = "usernameTaken",
-    /** The server reported `EMAIL_TAKEN`. */
+    /** The server reported `EMAIL_TAKEN` or `USER_EXISTS` (409). */
     EmailTaken = "emailTaken",
     /** The server reported `REALM_REQUIRED` or `REALM_INVALID`. */
     RealmInvalid = "realmInvalid",
+    /** The server reported `TENANT_NAME_TAKEN` (409): the organisation / shop name is in use. */
+    TenantNameTaken = "tenantNameTaken",
+    /** The server rate-limited the request (HTTP 429). */
+    RateLimited = "rateLimited",
+    /**
+     * The account WAS created but the automatic sign-in failed (`AUTO_LOGIN_FAILED`).
+     * Tell the user to sign in; do not ask them to register again.
+     */
+    AutoLoginFailed = "autoLoginFailed",
     /** The server rejected the request with an unrecognised message. */
     ValidationFailed = "validationFailed",
     /** Generic failure: network error, empty message, or a filled honeypot (never revealed). */
@@ -592,6 +601,8 @@ interface RegisterFormLabels {
     /** `accessibilityLabel` for the submit button while the request runs. */
     submitting: string;
     fields: Record<RegisterInputField, RegisterFieldLabels>;
+    /** Copy for the single "Your name" input of the compact form. Defaults to English. */
+    fullName?: RegisterFieldLabels;
 }
 declare const DEFAULT_REGISTER_LABELS: RegisterFormLabels;
 
@@ -2472,9 +2483,15 @@ interface RegisterFormProps<TResult> {
     footer?: ReactNode;
     /** Prefix applied to every `testID`. */
     testIdPrefix?: string;
+    /**
+     * Opt-in compact form (AUTH-REG-1): only "Your name", Email, Password and the
+     * tenant name. First/last name are split from the name (one word fills both),
+     * the username is derived from the email, and there is no confirm-password field.
+     */
+    compact?: boolean;
 }
 /** Themeable registration form built on `useRegisterForm`. */
-declare function RegisterForm<TResult>({ onSubmit, onSuccess, onError, onSubmitAttempt, passwordPolicy, labels: labelsProp, theme: themeProp, footer, testIdPrefix, }: Readonly<RegisterFormProps<TResult>>): ReactElement;
+declare function RegisterForm<TResult>({ onSubmit, onSuccess, onError, onSubmitAttempt, passwordPolicy, labels: labelsProp, theme: themeProp, footer, testIdPrefix, compact, }: Readonly<RegisterFormProps<TResult>>): ReactElement;
 
 /**
  * `testID` values for `<RegisterForm>`.
@@ -2511,6 +2528,11 @@ interface UseRegisterFormArgs<TResult> {
      * event). A press ignored because a submit is already in flight does not call it.
      */
     onSubmitAttempt?: () => void;
+    /**
+     * Compact mode (AUTH-REG-1): `firstName` holds the full name; last name, username
+     * (from the email) and the password confirmation are derived before validation.
+     */
+    compact?: boolean;
 }
 interface UseRegisterFormResult<TResult> {
     state: RegisterFormValues;
@@ -2521,7 +2543,7 @@ interface UseRegisterFormResult<TResult> {
     error: RegisterErrorCode | null;
 }
 /** Headless registration form logic. */
-declare function useRegisterForm<TResult>({ onSubmit, passwordPolicy, onSubmitAttempt, }: UseRegisterFormArgs<TResult>): UseRegisterFormResult<TResult>;
+declare function useRegisterForm<TResult>({ onSubmit, passwordPolicy, onSubmitAttempt, compact, }: UseRegisterFormArgs<TResult>): UseRegisterFormResult<TResult>;
 
 /**
  * Pure registration helpers: trimming, client-side validation and decoding of a
@@ -2535,6 +2557,30 @@ declare function useRegisterForm<TResult>({ onSubmit, passwordPolicy, onSubmitAt
 /** The default password rule: 8+ characters with a letter, a digit and a special character. */
 declare function isRegisterPasswordStrong(password: string): boolean;
 
+/**
+ * Compact registration (AUTH-REG-1 "Compact register form"): the form shows only
+ * "Your name", Email, Password (+ tenant name). Keycloak still needs a username,
+ * a first name AND a last name, so they are derived here before validation.
+ *
+ * In compact mode the single "Your name" input is stored in `firstName`.
+ */
+
+interface SplitName {
+    firstName: string;
+    lastName: string;
+}
+/**
+ * Split a full name on whitespace: the first word is the first name, the rest the
+ * last name. A single word is used for both (Keycloak requires a last name).
+ */
+declare function splitFullName(fullName: string): SplitName;
+/**
+ * A username derived from the whole email (so two people with the same local part
+ * on different domains never collide): lower-cased, every char outside
+ * `[a-z0-9._-]` replaced by `_`. `Ada+shop@Example.com` becomes `ada_shop_example.com`.
+ */
+declare function deriveUsernameFromEmail(email: string): string;
+
 /**
  * `createBffAuthClient` — the one-line wiring of a same-origin `BffAuthClient`.
  *
@@ -2824,4 +2870,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, 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 SplitName, 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, deriveUsernameFromEmail, isAllowedPinDigits, isPasswordValid, isRegisterPasswordStrong, isValidForgotPasswordEmail, performBffLogout, readCachedPreferredMethod, readPasskeyError, readPasskeyRegistered, resolveAccessibleRoutes, resolveAccountList, resolveDemoAccounts, resolveDemoCredentials, resolvePostLoginRoute, splitFullName, 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

@@ -342,6 +342,7 @@ var DEFAULT_REGISTER_LABELS = {
   submit: "Create account",
   submitHint: "Creates your account",
   submitting: "Creating account...",
+  fullName: field("Your name", "Enter your full name"),
   fields: {
     firstName: field("First name", "Enter your first name"),
     lastName: field("Last name", "Enter your last name"),
@@ -4101,6 +4102,18 @@ var FIELDS = [
   { key: "confirmPassword", testId: RegisterTestIds.confirmPasswordInput, secure: true },
   { key: "tenantName", testId: RegisterTestIds.tenantNameInput }
 ];
+var COMPACT_FIELDS = [
+  { key: "firstName", testId: RegisterTestIds.firstNameInput, autoComplete: "name" },
+  { key: "email", testId: RegisterTestIds.emailInput, autoComplete: "email", keyboardType: "email-address" },
+  { key: "password", testId: RegisterTestIds.passwordInput, secure: true },
+  { key: "tenantName", testId: RegisterTestIds.tenantNameInput }
+];
+function copyFor(key, labels, compact) {
+  if (compact && key === "firstName" && labels.fullName !== void 0) {
+    return labels.fullName;
+  }
+  return labels.fields[key];
+}
 var OFF_SCREEN = -9999;
 var HONEYPOT_SIZE = 1;
 var HONEYPOT_PLACEHOLDER = "Website";
@@ -4122,11 +4135,12 @@ function RegisterFormFields({
   styles: styles3,
   onChange,
   onSubmitEditing,
-  testIdPrefix
+  testIdPrefix,
+  compact = false
 }) {
   return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
-    FIELDS.map((config) => {
-      const copy = labels.fields[config.key];
+    (compact ? COMPACT_FIELDS : FIELDS).map((config) => {
+      const copy = copyFor(config.key, labels, compact);
       return /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: styles3.fieldGroup, children: [
         /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: styles3.label, children: copy.label }),
         /* @__PURE__ */ jsxRuntime.jsx(
@@ -4179,6 +4193,9 @@ var RegisterErrorCode = /* @__PURE__ */ ((RegisterErrorCode2) => {
   RegisterErrorCode2["UsernameTaken"] = "usernameTaken";
   RegisterErrorCode2["EmailTaken"] = "emailTaken";
   RegisterErrorCode2["RealmInvalid"] = "realmInvalid";
+  RegisterErrorCode2["TenantNameTaken"] = "tenantNameTaken";
+  RegisterErrorCode2["RateLimited"] = "rateLimited";
+  RegisterErrorCode2["AutoLoginFailed"] = "autoLoginFailed";
   RegisterErrorCode2["ValidationFailed"] = "validationFailed";
   RegisterErrorCode2["Failed"] = "failed";
   RegisterErrorCode2["InFlight"] = "inFlight";
@@ -4270,6 +4287,41 @@ function validateRegisterValues(values, passwordPolicy) {
   }
   return null;
 }
+var HTTP_TOO_MANY_REQUESTS = 429;
+var HTTP_SERVER_ERROR_MIN = 500;
+var BODY_ERROR_CODES = {
+  USER_EXISTS: "emailTaken" /* EmailTaken */,
+  USERNAME_TAKEN: "usernameTaken" /* UsernameTaken */,
+  EMAIL_TAKEN: "emailTaken" /* EmailTaken */,
+  TENANT_NAME_TAKEN: "tenantNameTaken" /* TenantNameTaken */,
+  AUTO_LOGIN_FAILED: "autoLoginFailed" /* AutoLoginFailed */,
+  INVALID_REQUEST: "validationFailed" /* ValidationFailed */,
+  REALM_REQUIRED: "realmInvalid" /* RealmInvalid */,
+  REALM_INVALID: "realmInvalid" /* RealmInvalid */
+};
+function typedFailureOf(error) {
+  if (typeof error !== "object" || error === null) {
+    return null;
+  }
+  const { status, errorCode } = error;
+  const hasStatus = typeof status === "number";
+  const hasCode = typeof errorCode === "string";
+  if (!hasStatus && !hasCode) {
+    return null;
+  }
+  return { status: hasStatus ? status : null, errorCode: hasCode ? errorCode : null };
+}
+function mapTypedFailure(failure) {
+  const byCode = failure.errorCode === null ? void 0 : BODY_ERROR_CODES[failure.errorCode];
+  if (byCode !== void 0) {
+    return byCode;
+  }
+  if (failure.status === HTTP_TOO_MANY_REQUESTS) {
+    return "rateLimited" /* RateLimited */;
+  }
+  const isServerError = failure.status !== null && failure.status >= HTTP_SERVER_ERROR_MIN;
+  return isServerError ? "failed" /* Failed */ : null;
+}
 function messageOf(error) {
   if (error instanceof Error) {
     return error.message;
@@ -4277,6 +4329,11 @@ function messageOf(error) {
   return typeof error === "string" ? error : "";
 }
 function mapRegisterErrorCode(error) {
+  const failure = typedFailureOf(error);
+  const typed = failure === null ? null : mapTypedFailure(failure);
+  if (typed !== null) {
+    return typed;
+  }
   const message = messageOf(error);
   if (message === "") {
     return "failed" /* Failed */;
@@ -4285,6 +4342,29 @@ function mapRegisterErrorCode(error) {
   return match === void 0 ? "validationFailed" /* ValidationFailed */ : match[1];
 }
 
+// src/hooks/registerCompact.ts
+var WHITESPACE_RUN = /\s+/;
+var UNSAFE_USERNAME_CHARS = /[^a-z0-9._-]/g;
+var USERNAME_REPLACEMENT = "_";
+function splitFullName(fullName) {
+  const words = fullName.trim().split(WHITESPACE_RUN).filter((word) => word !== "");
+  const [first = "", ...rest] = words;
+  return { firstName: first, lastName: rest.length > 0 ? rest.join(" ") : first };
+}
+function deriveUsernameFromEmail(email) {
+  return email.trim().toLowerCase().replace(UNSAFE_USERNAME_CHARS, USERNAME_REPLACEMENT);
+}
+function expandCompactRegisterValues(values) {
+  const { firstName, lastName } = splitFullName(values.firstName);
+  return {
+    ...values,
+    firstName,
+    lastName,
+    username: deriveUsernameFromEmail(values.email),
+    confirmPassword: values.password
+  };
+}
+
 // src/hooks/useRegisterForm.ts
 var EMPTY_VALUES = {
   firstName: "",
@@ -4310,7 +4390,8 @@ function toSubmitValues(values) {
 function useRegisterForm({
   onSubmit,
   passwordPolicy = isRegisterPasswordStrong,
-  onSubmitAttempt
+  onSubmitAttempt,
+  compact = false
 }) {
   const [state, setState] = react.useState(EMPTY_VALUES);
   const [isSubmitting, setIsSubmitting] = react.useState(false);
@@ -4324,7 +4405,8 @@ function useRegisterForm({
       return { ok: false, error: "inFlight" /* InFlight */ };
     }
     onSubmitAttempt?.();
-    const trimmed = trimRegisterValues(state);
+    const trimmedRaw = trimRegisterValues(state);
+    const trimmed = compact ? expandCompactRegisterValues(trimmedRaw) : trimmedRaw;
     const refusal = trimmed.website === "" ? validateRegisterValues(trimmed, passwordPolicy) : "failed" /* Failed */;
     if (refusal !== null) {
       setError(refusal);
@@ -4344,7 +4426,7 @@ function useRegisterForm({
       inFlight.current = false;
       setIsSubmitting(false);
     }
-  }, [onSubmit, onSubmitAttempt, passwordPolicy, state]);
+  }, [compact, onSubmit, onSubmitAttempt, passwordPolicy, state]);
   return { state, setField, submit, isSubmitting, error };
 }
 function RegisterForm({
@@ -4356,7 +4438,8 @@ function RegisterForm({
   labels: labelsProp,
   theme: themeProp,
   footer,
-  testIdPrefix
+  testIdPrefix,
+  compact = false
 }) {
   const theme = useAuthTheme(themeProp);
   const styles3 = useAuthStyles(theme);
@@ -4367,7 +4450,8 @@ function RegisterForm({
   const { state, setField, submit, isSubmitting } = useRegisterForm({
     onSubmit,
     onSubmitAttempt,
-    passwordPolicy
+    passwordPolicy,
+    compact
   });
   const handlePress = react.useCallback(async () => {
     routeRegisterOutcome(await submit(), { onSuccess, onError });
@@ -4379,6 +4463,7 @@ function RegisterForm({
     /* @__PURE__ */ jsxRuntime.jsx(
       RegisterFormFields,
       {
+        compact,
         disabled: isSubmitting,
         labels,
         styles: styles3,
@@ -4613,6 +4698,7 @@ exports.createBffAuthClient = createBffAuthClient;
 exports.createBffChangePasswordClient = createBffChangePasswordClient;
 exports.createPreferencesClient = createPreferencesClient;
 exports.defaultAuthTheme = defaultAuthTheme;
+exports.deriveUsernameFromEmail = deriveUsernameFromEmail;
 exports.isAllowedPinDigits = isAllowedPinDigits;
 exports.isPasswordValid = isPasswordValid;
 exports.isRegisterPasswordStrong = isRegisterPasswordStrong;
@@ -4626,6 +4712,7 @@ exports.resolveAccountList = resolveAccountList;
 exports.resolveDemoAccounts = resolveDemoAccounts;
 exports.resolveDemoCredentials = resolveDemoCredentials;
 exports.resolvePostLoginRoute = resolvePostLoginRoute;
+exports.splitFullName = splitFullName;
 exports.startPasskeyLogin = startPasskeyLogin;
 exports.startPasskeyRegistration = startPasskeyRegistration;
 exports.syncPreferredMethodFromServer = syncPreferredMethodFromServer;