@thunderid/react 1.5.0 → 1.7.0

package/dist/components/auth/InviteUser/InviteUser.js

@@ -0,0 +1,121 @@
+import useThunderID_default from "../../../contexts/ThunderID/useThunderID.js";
+import useFetchUsers_default from "../../../hooks/management/useFetchUsers.js";
+import useFetchAuthFlows_default from "../../../hooks/auth/useFetchAuthFlows.js";
+import useFetchUserTypes_default from "../../../hooks/management/useFetchUserTypes.js";
+import BaseInviteUser_default from "./BaseInviteUser.js";
+import { EmbeddedFlowType, getOrganizationUnitChildren, resolveResourceEndpoint } from "@thunderid/browser";
+import { useCallback } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/components/auth/InviteUser/InviteUser.tsx
+/**
+* InviteUser component for initiating invite user flow.
+*
+* This component is designed for admin users in the thunder-develop app to:
+* 1. Select a user type (if multiple available)
+* 2. Enter user details (username, email)
+* 3. Generate an invite link for the end user
+*
+* The component uses the authenticated ThunderID SDK context to make API calls
+* with the admin's access token (requires 'system' scope).
+*
+* @example
+* ```tsx
+* import { InviteUser } from '@thunderid/react';
+*
+* const InviteUserPage = () => {
+*   const [inviteLink, setInviteLink] = useState<string>();
+*
+*   return (
+*     <InviteUser
+*       onInviteLinkGenerated={(link, executionId) => setInviteLink(link)}
+*       onError={(error) => console.error(error)}
+*     >
+*       {({ values, components, isLoading, handleInputChange, handleSubmit, inviteLink, isInviteGenerated }) => (
+*         <div>
+*           {isInviteGenerated ? (
+*             <div>
+*               <h2>Invite Link Generated!</h2>
+*               <p>{inviteLink}</p>
+*             </div>
+*           ) : (
+*             // Render form based on components
+*           )}
+*         </div>
+*       )}
+*     </InviteUser>
+*   );
+* };
+* ```
+*/
+const InviteUser = ({ onError, onFlowChange, className, children, size = "medium", variant = "outlined", showTitle = true, showSubtitle = true }) => {
+	const { http, baseUrl, endpoints, getAccessToken, isInitialized } = useThunderID_default();
+	const flowExecuteUrl = resolveResourceEndpoint("flowExecute", { endpoints }) ?? `${baseUrl}/flow/execute`;
+	/**
+	* Initialize the invite user flow.
+	* Makes an authenticated request to /flow/execute with flowType: USER_ONBOARDING.
+	*/
+	const handleInitialize = async (payload) => {
+		return (await http.request({
+			data: {
+				...payload,
+				flowType: EmbeddedFlowType.UserOnboarding,
+				verbose: true
+			},
+			headers: {
+				Accept: "application/json",
+				"Content-Type": "application/json"
+			},
+			method: "POST",
+			url: flowExecuteUrl
+		})).data;
+	};
+	/**
+	* Submit flow step data.
+	* Makes an authenticated request to /flow/execute with the step data.
+	*/
+	const handleSubmit = async (payload) => {
+		return (await http.request({
+			data: {
+				...payload,
+				verbose: true
+			},
+			headers: {
+				Accept: "application/json",
+				"Content-Type": "application/json"
+			},
+			method: "POST",
+			url: flowExecuteUrl
+		})).data;
+	};
+	return /* @__PURE__ */ jsx(BaseInviteUser_default, {
+		onInitialize: handleInitialize,
+		onSubmit: handleSubmit,
+		onError,
+		onFlowChange,
+		className,
+		fetchOrganizationUnitChildren: useCallback(async (parentId, limit, offset) => {
+			return getOrganizationUnitChildren({
+				baseUrl,
+				headers: { Authorization: `Bearer ${await getAccessToken()}` },
+				limit,
+				offset,
+				organizationUnitId: parentId
+			});
+		}, [baseUrl, getAccessToken]),
+		fetchAuthFlows: useFetchAuthFlows_default(),
+		fetchUsers: useFetchUsers_default(),
+		fetchUserTypes: useFetchUserTypes_default(),
+		isInitialized,
+		size,
+		variant,
+		showTitle,
+		showSubtitle,
+		children
+	});
+};
+var InviteUser_default = InviteUser;
+
+//#endregion
+export { InviteUser_default as default };
+//# sourceMappingURL=InviteUser.js.map

package/dist/components/auth/InviteUser/InviteUser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InviteUser.js","names":["InviteUser: FC<InviteUserProps>","useThunderID","flowExecuteUrl: string","BaseInviteUser","useFetchAuthFlows","useFetchUsers","useFetchUserTypes"],"sources":["../../../../src/components/auth/InviteUser/InviteUser.tsx"],"sourcesContent":["// Copyright 2025 The ThunderID Authors\n// SPDX-License-Identifier: Apache-2.0\n\nimport {\n  EmbeddedFlowType,\n  FetchAuthFlows,\n  FetchUsers,\n  FetchUserTypes,\n  getOrganizationUnitChildren,\n  OrganizationUnitListResponse,\n  resolveResourceEndpoint,\n} from '@thunderid/browser';\nimport {FC, ReactElement, ReactNode, useCallback} from 'react';\n// eslint-disable-next-line import/no-named-as-default\nimport BaseInviteUser, {BaseInviteUserRenderProps, InviteUserFlowResponse} from './BaseInviteUser';\nimport useThunderID from '../../../contexts/ThunderID/useThunderID';\nimport useFetchAuthFlows from '../../../hooks/auth/useFetchAuthFlows';\nimport useFetchUsers from '../../../hooks/management/useFetchUsers';\nimport useFetchUserTypes from '../../../hooks/management/useFetchUserTypes';\n\n/**\n * Render props for InviteUser (re-exported for convenience).\n */\nexport type InviteUserRenderProps = BaseInviteUserRenderProps;\n\n/**\n * Props for the InviteUser component.\n */\nexport interface InviteUserProps {\n  /**\n   * Render props function for custom UI.\n   * If not provided, default UI will be rendered by the SDK.\n   */\n  children?: (props: InviteUserRenderProps) => ReactNode;\n\n  /**\n   * Custom CSS class name.\n   */\n  className?: string;\n\n  /**\n   * Callback when an error occurs. It also receives the errors of failed user, flow and user type picker loads,\n   * which the form itself does not show.\n   */\n  onError?: (error: Error) => void;\n\n  /**\n   * Callback when the flow state changes.\n   */\n  onFlowChange?: (response: InviteUserFlowResponse) => void;\n\n  /**\n   * Whether to show the subtitle.\n   */\n  showSubtitle?: boolean;\n\n  /**\n   * Whether to show the title.\n   */\n  showTitle?: boolean;\n\n  /**\n   * Size variant for the component.\n   */\n  size?: 'small' | 'medium' | 'large';\n\n  /**\n   * Theme variant for the component card.\n   */\n  variant?: 'outlined' | 'elevated';\n}\n\n/**\n * InviteUser component for initiating invite user flow.\n *\n * This component is designed for admin users in the thunder-develop app to:\n * 1. Select a user type (if multiple available)\n * 2. Enter user details (username, email)\n * 3. Generate an invite link for the end user\n *\n * The component uses the authenticated ThunderID SDK context to make API calls\n * with the admin's access token (requires 'system' scope).\n *\n * @example\n * ```tsx\n * import { InviteUser } from '@thunderid/react';\n *\n * const InviteUserPage = () => {\n *   const [inviteLink, setInviteLink] = useState<string>();\n *\n *   return (\n *     <InviteUser\n *       onInviteLinkGenerated={(link, executionId) => setInviteLink(link)}\n *       onError={(error) => console.error(error)}\n *     >\n *       {({ values, components, isLoading, handleInputChange, handleSubmit, inviteLink, isInviteGenerated }) => (\n *         <div>\n *           {isInviteGenerated ? (\n *             <div>\n *               <h2>Invite Link Generated!</h2>\n *               <p>{inviteLink}</p>\n *             </div>\n *           ) : (\n *             // Render form based on components\n *           )}\n *         </div>\n *       )}\n *     </InviteUser>\n *   );\n * };\n * ```\n */\nconst InviteUser: FC<InviteUserProps> = ({\n  onError,\n  onFlowChange,\n  className,\n  children,\n  size = 'medium',\n  variant = 'outlined',\n  showTitle = true,\n  showSubtitle = true,\n}: InviteUserProps): ReactElement => {\n  const {http, baseUrl, endpoints, getAccessToken, isInitialized} = useThunderID();\n\n  // The user-onboarding flow runs on the resource server, which may differ from `baseUrl` (the\n  // authorization server) in a trusted-issuer setup. Honor the `flowExecute` endpoint override.\n  const flowExecuteUrl: string = resolveResourceEndpoint('flowExecute', {endpoints}) ?? `${baseUrl}/flow/execute`;\n\n  /**\n   * Initialize the invite user flow.\n   * Makes an authenticated request to /flow/execute with flowType: USER_ONBOARDING.\n   */\n  const handleInitialize = async (payload: Record<string, any>): Promise<InviteUserFlowResponse> => {\n    const response: any = await http.request({\n      data: {\n        ...payload,\n        flowType: EmbeddedFlowType.UserOnboarding,\n        verbose: true,\n      },\n      headers: {\n        Accept: 'application/json',\n        'Content-Type': 'application/json',\n      },\n      method: 'POST',\n      url: flowExecuteUrl,\n    } as any);\n\n    return response.data as InviteUserFlowResponse;\n  };\n\n  /**\n   * Submit flow step data.\n   * Makes an authenticated request to /flow/execute with the step data.\n   */\n  const handleSubmit = async (payload: Record<string, any>): Promise<InviteUserFlowResponse> => {\n    const response: any = await http.request({\n      data: {\n        ...payload,\n        verbose: true,\n      },\n      headers: {\n        Accept: 'application/json',\n        'Content-Type': 'application/json',\n      },\n      method: 'POST',\n      url: flowExecuteUrl,\n    } as any);\n\n    return response.data as InviteUserFlowResponse;\n  };\n\n  const fetchOrganizationUnitChildren: (\n    parentId: string,\n    limit: number,\n    offset: number,\n  ) => Promise<OrganizationUnitListResponse> = useCallback(\n    async (parentId: string, limit: number, offset: number): Promise<OrganizationUnitListResponse> => {\n      const accessToken: string = await getAccessToken();\n\n      return getOrganizationUnitChildren({\n        baseUrl,\n        headers: {Authorization: `Bearer ${accessToken}`},\n        limit,\n        offset,\n        organizationUnitId: parentId,\n      });\n    },\n    [baseUrl, getAccessToken],\n  );\n\n  const fetchAuthFlows: FetchAuthFlows = useFetchAuthFlows();\n  const fetchUsers: FetchUsers = useFetchUsers();\n  const fetchUserTypes: FetchUserTypes = useFetchUserTypes();\n\n  return (\n    <BaseInviteUser\n      onInitialize={handleInitialize}\n      onSubmit={handleSubmit}\n      onError={onError}\n      onFlowChange={onFlowChange}\n      className={className}\n      fetchOrganizationUnitChildren={fetchOrganizationUnitChildren}\n      fetchAuthFlows={fetchAuthFlows}\n      fetchUsers={fetchUsers}\n      fetchUserTypes={fetchUserTypes}\n      isInitialized={isInitialized}\n      size={size}\n      variant={variant}\n      showTitle={showTitle}\n      showSubtitle={showSubtitle}\n    >\n      {children}\n    </BaseInviteUser>\n  );\n};\n\nexport default InviteUser;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgHA,MAAMA,cAAmC,EACvC,SACA,cACA,WACA,UACA,OAAO,UACP,UAAU,YACV,YAAY,MACZ,eAAe,WACoB;CACnC,MAAM,EAAC,MAAM,SAAS,WAAW,gBAAgB,kBAAiBC,sBAAc;CAIhF,MAAMC,iBAAyB,wBAAwB,eAAe,EAAC,WAAU,CAAC,IAAI,GAAG,QAAQ;;;;;CAMjG,MAAM,mBAAmB,OAAO,YAAkE;AAehG,UAdsB,MAAM,KAAK,QAAQ;GACvC,MAAM;IACJ,GAAG;IACH,UAAU,iBAAiB;IAC3B,SAAS;IACV;GACD,SAAS;IACP,QAAQ;IACR,gBAAgB;IACjB;GACD,QAAQ;GACR,KAAK;GACN,CAAQ,EAEO;;;;;;CAOlB,MAAM,eAAe,OAAO,YAAkE;AAc5F,UAbsB,MAAM,KAAK,QAAQ;GACvC,MAAM;IACJ,GAAG;IACH,SAAS;IACV;GACD,SAAS;IACP,QAAQ;IACR,gBAAgB;IACjB;GACD,QAAQ;GACR,KAAK;GACN,CAAQ,EAEO;;AA0BlB,QACE,oBAACC;EACC,cAAc;EACd,UAAU;EACD;EACK;EACH;EACX,+BA1ByC,YAC3C,OAAO,UAAkB,OAAe,WAA0D;AAGhG,UAAO,4BAA4B;IACjC;IACA,SAAS,EAAC,eAAe,UAJC,MAAM,gBAAgB,IAIC;IACjD;IACA;IACA,oBAAoB;IACrB,CAAC;KAEJ,CAAC,SAAS,eAAe,CAC1B;EAcG,gBAZmCC,2BAAmB;EAatD,YAZ2BC,uBAAe;EAa1C,gBAZmCC,2BAAmB;EAavC;EACT;EACG;EACE;EACG;EAEb;GACc;;AAIrB,yBAAe"}

package/dist/components/auth/InviteUser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/auth/InviteUser/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,OAAO,IAAI,UAAU,EAAC,MAAM,cAAc,CAAC;AACnD,YAAY,EAAC,eAAe,EAAE,qBAAqB,EAAC,MAAM,cAAc,CAAC;AACzE,OAAO,EAAC,OAAO,IAAI,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAC3D,YAAY,EAAC,mBAAmB,EAAE,yBAAyB,EAAE,sBAAsB,EAAC,MAAM,kBAAkB,CAAC"}

package/dist/components/auth/Recovery/BaseRecovery.d.ts

@@ -0,0 +1,73 @@
+import { EmbeddedRecoveryFlowRequest, EmbeddedRecoveryFlowResponse, Preferences, FlowMetadataResponse } from '@thunderid/browser';
+import { FC, ReactNode } from 'react';
+import { CardProps } from '../../primitives/Card/Card';
+/**
+ * Render props for custom UI rendering.
+ */
+export interface BaseRecoveryRenderProps {
+    components: any[];
+    error?: Error | null;
+    fieldErrors: Record<string, string>;
+    handleInputChange: (name: string, value: string) => void;
+    handleSubmit: (component: any, data?: Record<string, any>) => Promise<void>;
+    isLoading: boolean;
+    isValid: boolean;
+    messages: {
+        message: string;
+        type: string;
+    }[];
+    meta: FlowMetadataResponse | null;
+    subtitle: string;
+    title: string;
+    touched: Record<string, boolean>;
+    validateForm: () => {
+        fieldErrors: Record<string, string>;
+        isValid: boolean;
+    };
+    values: Record<string, string>;
+}
+/**
+ * Props for the BaseRecovery component.
+ */
+export interface BaseRecoveryProps {
+    afterRecoveryUrl?: string;
+    buttonClassName?: string;
+    /**
+     * Render props function for custom UI or static content
+     */
+    children?: ((props: BaseRecoveryRenderProps) => ReactNode) | ReactNode;
+    className?: string;
+    error?: Error | null;
+    errorClassName?: string;
+    inputClassName?: string;
+    isInitialized?: boolean;
+    messageClassName?: string;
+    onComplete?: (response: EmbeddedRecoveryFlowResponse) => void;
+    onError?: (error: Error) => void;
+    onFlowChange?: (response: EmbeddedRecoveryFlowResponse) => void;
+    onInitialize?: (payload?: EmbeddedRecoveryFlowRequest) => Promise<EmbeddedRecoveryFlowResponse>;
+    onSubmit?: (payload: EmbeddedRecoveryFlowRequest) => Promise<EmbeddedRecoveryFlowResponse>;
+    /**
+     * Component-level preferences to override global i18n and theme settings.
+     */
+    preferences?: Preferences;
+    /**
+     * When a field has been blurred at least once, re-run validation on every subsequent
+     * keystroke so a rendered error clears the moment the value becomes valid. Doesn't
+     * affect fields that have never been blurred — the user isn't shown errors while
+     * initially typing. Default `false` preserves prior behavior.
+     */
+    revalidateOnChangeAfterBlur?: boolean;
+    showLogo?: boolean;
+    showSubtitle?: boolean;
+    showTitle?: boolean;
+    size?: 'small' | 'medium' | 'large';
+    variant?: CardProps['variant'];
+}
+/**
+ * BaseRecovery component for ThunderIDV2 that provides an embedded account/password recovery flow.
+ * Accepts API functions as props to maintain framework independence.
+ */
+declare const BaseRecovery: FC<BaseRecoveryProps>;
+export default BaseRecovery;
+//# sourceMappingURL=BaseRecovery.d.ts.map

package/dist/components/auth/Recovery/BaseRecovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseRecovery.d.ts","sourceRoot":"","sources":["../../../../src/components/auth/Recovery/BaseRecovery.tsx"],"names":[],"mappings":"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"}

package/dist/components/auth/Recovery/BaseRecovery.js

@@ -0,0 +1,401 @@
+import { cx } from "../../../styles/emotion.js";
+import ComponentRendererContext_default from "../../../contexts/ComponentRenderer/ComponentRendererContext.js";
+import FlowProvider_default from "../../../contexts/Flow/FlowProvider.js";
+import useThunderID_default from "../../../contexts/ThunderID/useThunderID.js";
+import useFlow_default from "../../../contexts/Flow/useFlow.js";
+import useTheme_default from "../../../contexts/Theme/useTheme.js";
+import ComponentPreferencesContext_default from "../../../contexts/I18n/ComponentPreferencesContext.js";
+import useTranslation_default from "../../../hooks/useTranslation.js";
+import { extractErrorMessage, normalizeFlowResponse } from "../../../utils/flowTransformer.js";
+import { useForm } from "../../../hooks/useForm.js";
+import Spinner_default from "../../primitives/Spinner/Spinner.js";
+import composeAffixedInputs_default from "../../../utils/composeAffixedInputs.js";
+import Typography_default from "../../primitives/Typography/Typography.js";
+import Alert_default from "../../primitives/Alert/Alert.js";
+import Card_default from "../../primitives/Card/Card.js";
+import { renderRecoveryComponents } from "../flow/AuthOptionFactory.js";
+import BaseSignUp_styles_default from "../SignUp/BaseSignUp.styles.js";
+import getAuthComponentHeadings_default from "../../../utils/getAuthComponentHeadings.js";
+import Logo_default from "../../primitives/Logo/Logo.js";
+import { EmbeddedFlowComponentType, EmbeddedRecoveryFlowStatus, buildValidatorFromRules, withVendorCSSClassPrefix } from "@thunderid/browser";
+import { useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/components/auth/Recovery/BaseRecovery.tsx
+/**
+* Internal component that renders the V2 recovery UI and manages flow state.
+*
+* @internal
+*/
+const BaseRecoveryContent = ({ onInitialize, onSubmit, onError, onFlowChange, onComplete, error: externalError, className = "", inputClassName = "", buttonClassName = "", errorClassName = "", messageClassName = "", size = "medium", variant = "outlined", isInitialized, children, showTitle = true, showSubtitle = true, revalidateOnChangeAfterBlur = false }) => {
+	const { theme, colorScheme } = useTheme_default();
+	const customRenderers = useContext(ComponentRendererContext_default);
+	const { t } = useTranslation_default();
+	const { subtitle: flowSubtitle, title: flowTitle, messages: flowMessages, addMessage, clearMessages } = useFlow_default();
+	const { meta, vendor } = useThunderID_default();
+	const styles = BaseSignUp_styles_default(theme, colorScheme);
+	const [isLoading, setIsLoading] = useState(false);
+	const [isFlowInitialized, setIsFlowInitialized] = useState(false);
+	const [currentFlow, setCurrentFlow] = useState(null);
+	const [apiError, setApiError] = useState(null);
+	const initializationAttemptedRef = useRef(false);
+	const challengeTokenRef = useRef(null);
+	const handleError = useCallback((error) => {
+		const errorMessage = extractErrorMessage(error, t);
+		setApiError(error instanceof Error ? error : new Error(errorMessage));
+		clearMessages();
+		addMessage({
+			message: errorMessage,
+			type: "error"
+		});
+	}, [
+		t,
+		addMessage,
+		clearMessages
+	]);
+	const normalizeFlowResponseLocal = useCallback((response) => {
+		if (response?.data?.components && Array.isArray(response.data.components)) return response;
+		if (response?.data) {
+			const { components } = normalizeFlowResponse(response, t, {
+				defaultErrorKey: "components.recovery.errors.generic",
+				resolveTranslations: false
+			}, meta);
+			return {
+				...response,
+				data: {
+					...response.data,
+					components
+				}
+			};
+		}
+		return response;
+	}, [t, meta]);
+	const extractFormFields = useCallback((components) => {
+		const fields = [];
+		const processComponents = (comps) => {
+			comps.forEach((component) => {
+				if (component.type === EmbeddedFlowComponentType.TextInput || component.type === EmbeddedFlowComponentType.PasswordInput || component.type === EmbeddedFlowComponentType.EmailInput || component.type === EmbeddedFlowComponentType.Select || component.type === EmbeddedFlowComponentType.DateInput) {
+					const fieldName = component.ref || component.id;
+					const ruleValidator = buildValidatorFromRules(component.validation);
+					fields.push({
+						initialValue: "",
+						name: fieldName,
+						required: component.required || false,
+						validator: (value) => {
+							if (component.required && (!value || value.trim() === "")) return t("validations.required.field.error");
+							if (ruleValidator && value) {
+								const ruleMessage = ruleValidator(value);
+								if (ruleMessage) return t(ruleMessage);
+							}
+							if ((component.type === EmbeddedFlowComponentType.EmailInput || component.variant === "EMAIL") && value && !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value)) return t("field.email.invalid");
+							return null;
+						}
+					});
+				}
+				if (component.components && Array.isArray(component.components)) processComponents(component.components);
+			});
+		};
+		processComponents(components);
+		return fields;
+	}, [t]);
+	const { values: formValues, touched: touchedFields, errors: formErrors, isValid: isFormValid, setValue: setFormValue, setTouched: setFormTouched, setTouchedFields, setErrors: setFormErrors, clearErrors: clearFormErrors, validateForm, touchAllFields, reset: resetForm } = useForm({
+		fields: useMemo(() => currentFlow?.data?.components ? extractFormFields(currentFlow.data.components) : [], [currentFlow, extractFormFields]),
+		initialValues: {},
+		requiredMessage: t("validations.required.field.error"),
+		revalidateOnChangeAfterBlur,
+		validateOnBlur: true,
+		validateOnChange: false
+	});
+	useEffect(() => {
+		clearFormErrors();
+		const responseFieldErrors = (currentFlow?.data)?.fieldErrors;
+		if (!responseFieldErrors || responseFieldErrors.length === 0) return;
+		const errors = {};
+		const touched = {};
+		for (const fe of responseFieldErrors) if (!(fe.identifier in errors)) {
+			errors[fe.identifier] = fe.message;
+			touched[fe.identifier] = true;
+		}
+		setTouchedFields(touched);
+		setFormErrors(errors);
+	}, [
+		currentFlow,
+		setFormErrors,
+		setTouchedFields,
+		clearFormErrors
+	]);
+	const setupFormFields = useCallback((flowResponse) => {
+		const fields = extractFormFields(flowResponse.data?.components || []);
+		const initialValues = {};
+		fields.forEach((field) => {
+			initialValues[field.name] = field.initialValue || "";
+		});
+		resetForm();
+		Object.keys(initialValues).forEach((key) => setFormValue(key, initialValues[key]));
+	}, [
+		extractFormFields,
+		resetForm,
+		setFormValue
+	]);
+	const handleInputChange = (name, value) => {
+		setFormValue(name, value);
+	};
+	const handleInputBlur = (name) => {
+		setFormTouched(name, true);
+	};
+	const handleSubmit = async (component, data, skipValidation) => {
+		if (!currentFlow) return;
+		if (!skipValidation) {
+			touchAllFields();
+			if (!validateForm().isValid) return;
+		}
+		setIsLoading(true);
+		setApiError(null);
+		clearMessages();
+		try {
+			const composedData = data ? composeAffixedInputs_default(data, vendor) : void 0;
+			const filteredInputs = {};
+			if (composedData) Object.entries(composedData).forEach(([key, value]) => {
+				if (value !== null && value !== void 0 && value !== "") filteredInputs[key] = value;
+			});
+			const payload = {
+				...currentFlow.executionId && { executionId: currentFlow.executionId },
+				...component.id && { action: component.id },
+				...challengeTokenRef.current ? { challengeToken: challengeTokenRef.current } : {},
+				inputs: filteredInputs
+			};
+			const rawResponse = await onSubmit?.(payload);
+			if (!rawResponse) return;
+			const response = normalizeFlowResponseLocal(rawResponse);
+			onFlowChange?.(response);
+			if (response.challengeToken !== void 0) challengeTokenRef.current = response.challengeToken ?? null;
+			if (response.flowStatus === EmbeddedRecoveryFlowStatus.Error) {
+				handleError(response);
+				onError?.(new Error(extractErrorMessage(response, t)));
+				return;
+			}
+			if (response.flowStatus === EmbeddedRecoveryFlowStatus.Complete) {
+				onComplete?.(response);
+				return;
+			}
+			if (response.flowStatus === EmbeddedRecoveryFlowStatus.Incomplete) {
+				setCurrentFlow(response);
+				setupFormFields(response);
+				if (response?.error) handleError(response);
+			}
+		} catch (err) {
+			handleError(err);
+			onError?.(err);
+		} finally {
+			setIsLoading(false);
+		}
+	};
+	const containerClasses = cx([
+		withVendorCSSClassPrefix("recovery"),
+		withVendorCSSClassPrefix(`recovery--${size}`),
+		withVendorCSSClassPrefix(`recovery--${variant}`)
+	], className);
+	const inputClasses = cx([
+		withVendorCSSClassPrefix("recovery__input"),
+		size === "small" && withVendorCSSClassPrefix("recovery__input--small"),
+		size === "large" && withVendorCSSClassPrefix("recovery__input--large")
+	], inputClassName);
+	const buttonClasses = cx([
+		withVendorCSSClassPrefix("recovery__button"),
+		size === "small" && withVendorCSSClassPrefix("recovery__button--small"),
+		size === "large" && withVendorCSSClassPrefix("recovery__button--large")
+	], buttonClassName);
+	const errorClasses = cx([withVendorCSSClassPrefix("recovery__error")], errorClassName);
+	const messageClasses = cx([withVendorCSSClassPrefix("recovery__messages")], messageClassName);
+	const renderComponents = useCallback((components) => renderRecoveryComponents(components, formValues, touchedFields, formErrors, isLoading, isFormValid, resetForm, handleInputChange, {
+		_customRenderers: customRenderers,
+		_theme: theme,
+		buttonClassName: buttonClasses,
+		inputClassName: inputClasses,
+		meta,
+		onInputBlur: handleInputBlur,
+		onSubmit: handleSubmit,
+		size,
+		variant,
+		vendor
+	}), [
+		customRenderers,
+		buttonClasses,
+		formErrors,
+		formValues,
+		handleInputBlur,
+		handleSubmit,
+		inputClasses,
+		isFormValid,
+		meta,
+		isLoading,
+		size,
+		theme,
+		touchedFields,
+		variant,
+		vendor
+	]);
+	useEffect(() => {
+		if (isInitialized && !isFlowInitialized && !initializationAttemptedRef.current) {
+			initializationAttemptedRef.current = true;
+			(async () => {
+				setIsLoading(true);
+				setApiError(null);
+				clearMessages();
+				try {
+					const rawResponse = await onInitialize?.();
+					if (!rawResponse) return;
+					const response = normalizeFlowResponseLocal(rawResponse);
+					if (response.challengeToken !== void 0) challengeTokenRef.current = response.challengeToken ?? null;
+					if (response.flowStatus === EmbeddedRecoveryFlowStatus.Error) {
+						handleError(response);
+						onError?.(new Error(extractErrorMessage(response, t)));
+					}
+					setCurrentFlow(response);
+					setIsFlowInitialized(true);
+					onFlowChange?.(response);
+					if (response.flowStatus === EmbeddedRecoveryFlowStatus.Complete) {
+						onComplete?.(response);
+						return;
+					}
+					if (response.flowStatus === EmbeddedRecoveryFlowStatus.Incomplete) {
+						setupFormFields(response);
+						if (response?.error) handleError(response);
+					}
+				} catch (err) {
+					handleError(err);
+					onError?.(err);
+				} finally {
+					setIsLoading(false);
+				}
+			})();
+		}
+	}, [
+		isFlowInitialized,
+		isInitialized,
+		normalizeFlowResponseLocal,
+		onComplete,
+		onError,
+		onFlowChange,
+		onInitialize,
+		setupFormFields,
+		t
+	]);
+	if (children) {
+		if (typeof children === "function") return /* @__PURE__ */ jsx("div", {
+			className: containerClasses,
+			children: children({
+				components: currentFlow?.data?.components || [],
+				error: apiError,
+				fieldErrors: formErrors,
+				handleInputChange,
+				handleSubmit,
+				isLoading,
+				isValid: isFormValid,
+				messages: flowMessages || [],
+				meta,
+				subtitle: flowSubtitle || t("recovery.subheading"),
+				title: flowTitle || t("recovery.heading"),
+				touched: touchedFields,
+				validateForm: () => {
+					const result = validateForm();
+					return {
+						fieldErrors: result.errors,
+						isValid: result.isValid
+					};
+				},
+				values: formValues
+			})
+		});
+		return /* @__PURE__ */ jsx("div", {
+			className: containerClasses,
+			children
+		});
+	}
+	if (!isFlowInitialized && isLoading) return /* @__PURE__ */ jsx(Card_default, {
+		className: cx(containerClasses, styles.card),
+		variant,
+		children: /* @__PURE__ */ jsx(Card_default.Content, { children: /* @__PURE__ */ jsx("div", {
+			className: styles.loadingContainer,
+			children: /* @__PURE__ */ jsx(Spinner_default, { size: "medium" })
+		}) })
+	});
+	if (!currentFlow) return /* @__PURE__ */ jsx(Card_default, {
+		className: cx(containerClasses, styles.card),
+		variant,
+		children: /* @__PURE__ */ jsx(Card_default.Content, { children: /* @__PURE__ */ jsxs(Alert_default, {
+			variant: "error",
+			className: errorClasses,
+			children: [/* @__PURE__ */ jsx(Alert_default.Title, { children: t("errors.heading") }), /* @__PURE__ */ jsx(Alert_default.Description, { children: t("errors.recovery.flow.initialization.failure") })]
+		}) })
+	});
+	const { title, subtitle, componentsWithoutHeadings } = getAuthComponentHeadings_default(currentFlow.data?.components || [], flowTitle, flowSubtitle, t("recovery.heading"), t("recovery.subheading"));
+	return /* @__PURE__ */ jsxs(Card_default, {
+		className: cx(containerClasses, styles.card),
+		variant,
+		children: [(showTitle || showSubtitle) && /* @__PURE__ */ jsxs(Card_default.Header, {
+			className: styles.header,
+			children: [showTitle && /* @__PURE__ */ jsx(Card_default.Title, {
+				level: 2,
+				className: styles.title,
+				children: title
+			}), showSubtitle && /* @__PURE__ */ jsx(Typography_default, {
+				variant: "body1",
+				className: styles.subtitle,
+				children: subtitle
+			})]
+		}), /* @__PURE__ */ jsxs(Card_default.Content, { children: [
+			externalError && /* @__PURE__ */ jsx("div", {
+				className: styles.flowMessagesContainer,
+				children: /* @__PURE__ */ jsx(Alert_default, {
+					variant: "error",
+					className: cx(styles.flowMessageItem, messageClasses),
+					children: /* @__PURE__ */ jsx(Alert_default.Description, { children: externalError.message })
+				})
+			}),
+			flowMessages && flowMessages.length > 0 && /* @__PURE__ */ jsx("div", {
+				className: styles.flowMessagesContainer,
+				children: flowMessages.map((message, index) => /* @__PURE__ */ jsx(Alert_default, {
+					variant: message.type?.toLowerCase() === "error" ? "error" : "info",
+					className: cx(styles.flowMessageItem, messageClasses),
+					children: /* @__PURE__ */ jsx(Alert_default.Description, { children: message.message })
+				}, message.id || index))
+			}),
+			/* @__PURE__ */ jsx("div", {
+				className: styles.contentContainer,
+				children: componentsWithoutHeadings && componentsWithoutHeadings.length > 0 ? renderComponents(componentsWithoutHeadings) : /* @__PURE__ */ jsx(Alert_default, {
+					variant: "warning",
+					children: /* @__PURE__ */ jsx(Typography_default, {
+						variant: "body1",
+						children: t("errors.recovery.components.not.available")
+					})
+				})
+			})
+		] })]
+	});
+};
+/**
+* BaseRecovery component for ThunderIDV2 that provides an embedded account/password recovery flow.
+* Accepts API functions as props to maintain framework independence.
+*/
+const BaseRecovery = ({ preferences, showLogo = true,...rest }) => {
+	const { theme, colorScheme } = useTheme_default();
+	const styles = BaseSignUp_styles_default(theme, colorScheme);
+	const content = /* @__PURE__ */ jsxs("div", { children: [showLogo && /* @__PURE__ */ jsx("div", {
+		className: styles.logoContainer,
+		children: /* @__PURE__ */ jsx(Logo_default, { size: "large" })
+	}), /* @__PURE__ */ jsx(FlowProvider_default, { children: /* @__PURE__ */ jsx(BaseRecoveryContent, {
+		showLogo,
+		...rest
+	}) })] });
+	if (!preferences) return content;
+	return /* @__PURE__ */ jsx(ComponentPreferencesContext_default.Provider, {
+		value: preferences,
+		children: content
+	});
+};
+var BaseRecovery_default = BaseRecovery;
+
+//#endregion
+export { BaseRecovery_default as default };
+//# sourceMappingURL=BaseRecovery.js.map