@thunderid/react 0.2.0 → 0.3.3

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

@@ -1,17 +1,396 @@
+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 BaseRecovery_default from "./v1/BaseRecovery.js";
-import BaseRecovery_default$1 from "./v2/BaseRecovery.js";
-import { Platform } from "@thunderid/browser";
-import { jsx } from "react/jsx-runtime";
+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 { useForm } from "../../../../hooks/useForm.js";
+import Spinner_default from "../../../primitives/Spinner/Spinner.js";
+import { extractErrorMessage, normalizeFlowResponse } from "../../../../utils/flowTransformer.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 "../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, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { cx } from "@emotion/css";
 
 //#region src/components/presentation/auth/Recovery/BaseRecovery.tsx
-const BaseRecovery = (props) => {
-	const { platform } = useThunderID_default();
-	if (platform === Platform.ThunderID) return /* @__PURE__ */ jsx(BaseRecovery_default$1, { ...props });
-	return /* @__PURE__ */ jsx(BaseRecovery_default, { ...props });
+/**
+* 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 }) => {
+	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 } = 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 ((component.type === EmbeddedFlowComponentType.EmailInput || component.variant === "EMAIL") && value && !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value)) return t("field.email.invalid");
+							if (ruleValidator && value) {
+								const ruleMessage = ruleValidator(value);
+								if (ruleMessage) return t(ruleMessage);
+							}
+							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, setErrors: setFormErrors, clearErrors: clearFormErrors, validateForm, touchAllFields, reset: resetForm } = useForm({
+		fields: currentFlow?.data?.components ? extractFormFields(currentFlow.data.components) : [],
+		initialValues: {},
+		requiredMessage: t("validations.required.field.error"),
+		validateOnBlur: true,
+		validateOnChange: false
+	});
+	/**
+	* Project server-side validation errors from the most recent flow response into the
+	* form's `errors` state. See BaseSignIn for the same pattern.
+	*/
+	useEffect(() => {
+		clearFormErrors();
+		const responseFieldErrors = (currentFlow?.data)?.fieldErrors;
+		if (!responseFieldErrors || responseFieldErrors.length === 0) return;
+		const errors = {};
+		for (const fe of responseFieldErrors) if (!(fe.identifier in errors)) errors[fe.identifier] = fe.message;
+		setFormErrors(errors);
+		Object.keys(errors).forEach((field) => setFormTouched(field, true));
+	}, [
+		currentFlow,
+		setFormErrors,
+		setFormTouched,
+		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 filteredInputs = {};
+			if (data) Object.entries(data).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, handleInputChange, {
+		_customRenderers: customRenderers,
+		_theme: theme,
+		buttonClassName: buttonClasses,
+		inputClassName: inputClasses,
+		meta,
+		onInputBlur: handleInputBlur,
+		onSubmit: handleSubmit,
+		size,
+		variant
+	}), [
+		customRenderers,
+		buttonClasses,
+		formErrors,
+		formValues,
+		handleInputBlur,
+		handleSubmit,
+		inputClasses,
+		isFormValid,
+		meta,
+		isLoading,
+		size,
+		theme,
+		touchedFields,
+		variant
+	]);
+	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")
+					})
+				})
+			})
+		] })]
+	});
 };
-var BaseRecovery_default$2 = BaseRecovery;
+/**
+* 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$2 as default };
+export { BaseRecovery_default as default };
 //# sourceMappingURL=BaseRecovery.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"BaseRecovery.js","names":["BaseRecovery: FC<BaseRecoveryProps>","useThunderID","BaseRecoveryV2","BaseRecoveryV1"],"sources":["../../../../../src/components/presentation/auth/Recovery/BaseRecovery.tsx"],"sourcesContent":["/**\n * Copyright (c) 2026, WSO2 LLC. (https://www.wso2.com).\n *\n * WSO2 LLC. licenses this file to you under the Apache License,\n * Version 2.0 (the \"License\"); you may not use this file except\n * in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n */\n\nimport {Platform} from '@thunderid/browser';\nimport {FC} from 'react';\nimport BaseRecoveryV1, {BaseRecoveryProps as BaseRecoveryV1Props} from './v1/BaseRecovery';\nimport BaseRecoveryV2, {BaseRecoveryProps as BaseRecoveryV2Props} from './v2/BaseRecovery';\nimport useThunderID from '../../../../contexts/ThunderID/useThunderID';\n\nexport type BaseRecoveryProps = BaseRecoveryV1Props | BaseRecoveryV2Props;\n\nconst BaseRecovery: FC<BaseRecoveryProps> = (props: BaseRecoveryProps) => {\n  const {platform} = useThunderID();\n\n  if (platform === Platform.ThunderID) {\n    return <BaseRecoveryV2 {...(props as BaseRecoveryV2Props)} />;\n  }\n\n  return <BaseRecoveryV1 {...(props as BaseRecoveryV1Props)} />;\n};\n\nexport default BaseRecovery;\n"],"mappings":";;;;;;;AA0BA,MAAMA,gBAAuC,UAA6B;CACxE,MAAM,EAAC,aAAYC,sBAAc;AAEjC,KAAI,aAAa,SAAS,UACxB,QAAO,oBAACC,0BAAe,GAAK,QAAiC;AAG/D,QAAO,oBAACC,wBAAe,GAAK,QAAiC;;AAG/D,6BAAe"}
+{"version":3,"file":"BaseRecovery.js","names":["BaseRecoveryContent: FC<BaseRecoveryProps>","useTheme","customRenderers: ComponentRendererMap","ComponentRendererContext","useTranslation","useFlow","useThunderID","styles: any","useStyles","initializationAttemptedRef: any","challengeTokenRef: any","handleError: any","errorMessage: string","normalizeFlowResponseLocal: any","extractFormFields: any","fields: FormField[]","fieldName: any","responseFieldErrors: FieldError[] | undefined","errors: Record<string, string>","setupFormFields: any","fields: any","initialValues: Record<string, string>","filteredInputs: Record<string, any>","payload: EmbeddedRecoveryFlowRequest","rawResponse: any","response: any","containerClasses: any","inputClasses: any","buttonClasses: any","errorClasses: any","messageClasses: any","renderComponents: any","result: ReturnType<typeof validateForm>","CardPrimitive","Spinner","AlertPrimitive","getAuthComponentHeadings","Typography","BaseRecovery: FC<BaseRecoveryProps>","content: ReactElement","Logo","FlowProvider","ComponentPreferencesContext"],"sources":["../../../../../src/components/presentation/auth/Recovery/BaseRecovery.tsx"],"sourcesContent":["/**\n * Copyright (c) 2026, WSO2 LLC. (https://www.wso2.com).\n *\n * WSO2 LLC. licenses this file to you under the Apache License,\n * Version 2.0 (the \"License\"); you may not use this file except\n * in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n */\n\nimport {cx} from '@emotion/css';\nimport {\n  EmbeddedRecoveryFlowRequest,\n  EmbeddedRecoveryFlowResponse,\n  EmbeddedRecoveryFlowStatus,\n  EmbeddedFlowComponentType,\n  FieldError,\n  withVendorCSSClassPrefix,\n  buildValidatorFromRules,\n  Preferences,\n  FlowMetadataResponse,\n} from '@thunderid/browser';\nimport {FC, ReactElement, ReactNode, useContext, useEffect, useState, useCallback, useRef} from 'react';\nimport ComponentRendererContext, {\n  ComponentRendererMap,\n} from '../../../../contexts/ComponentRenderer/ComponentRendererContext';\nimport FlowProvider from '../../../../contexts/Flow/FlowProvider';\nimport useFlow from '../../../../contexts/Flow/useFlow';\nimport ComponentPreferencesContext from '../../../../contexts/I18n/ComponentPreferencesContext';\nimport useTheme from '../../../../contexts/Theme/useTheme';\nimport useThunderID from '../../../../contexts/ThunderID/useThunderID';\nimport {useForm, FormField} from '../../../../hooks/useForm';\nimport useTranslation from '../../../../hooks/useTranslation';\nimport {normalizeFlowResponse, extractErrorMessage} from '../../../../utils/flowTransformer';\nimport getAuthComponentHeadings from '../../../../utils/getAuthComponentHeadings';\nimport AlertPrimitive from '../../../primitives/Alert/Alert';\nimport CardPrimitive, {CardProps} from '../../../primitives/Card/Card';\nimport Logo from '../../../primitives/Logo/Logo';\nimport Spinner from '../../../primitives/Spinner/Spinner';\nimport Typography from '../../../primitives/Typography/Typography';\nimport {renderRecoveryComponents} from '../AuthOptionFactory';\nimport useStyles from '../SignUp/BaseSignUp.styles';\n\n/**\n * Render props for custom UI rendering.\n */\nexport interface BaseRecoveryRenderProps {\n  components: any[];\n  error?: Error | null;\n  fieldErrors: Record<string, string>;\n  handleInputChange: (name: string, value: string) => void;\n  handleSubmit: (component: any, data?: Record<string, any>) => Promise<void>;\n  isLoading: boolean;\n  isValid: boolean;\n  messages: {message: string; type: string}[];\n  meta: FlowMetadataResponse | null;\n  subtitle: string;\n  title: string;\n  touched: Record<string, boolean>;\n  validateForm: () => {fieldErrors: Record<string, string>; isValid: boolean};\n  values: Record<string, string>;\n}\n\n/**\n * Props for the BaseRecovery component.\n */\nexport interface BaseRecoveryProps {\n  afterRecoveryUrl?: string;\n  buttonClassName?: string;\n  /**\n   * Render props function for custom UI or static content\n   */\n  children?: ((props: BaseRecoveryRenderProps) => ReactNode) | ReactNode;\n  className?: string;\n  error?: Error | null;\n  errorClassName?: string;\n  inputClassName?: string;\n  isInitialized?: boolean;\n  messageClassName?: string;\n  onComplete?: (response: EmbeddedRecoveryFlowResponse) => void;\n  onError?: (error: Error) => void;\n  onFlowChange?: (response: EmbeddedRecoveryFlowResponse) => void;\n  onInitialize?: (payload?: EmbeddedRecoveryFlowRequest) => Promise<EmbeddedRecoveryFlowResponse>;\n  onSubmit?: (payload: EmbeddedRecoveryFlowRequest) => Promise<EmbeddedRecoveryFlowResponse>;\n  /**\n   * Component-level preferences to override global i18n and theme settings.\n   */\n  preferences?: Preferences;\n  showLogo?: boolean;\n  showSubtitle?: boolean;\n  showTitle?: boolean;\n  size?: 'small' | 'medium' | 'large';\n  variant?: CardProps['variant'];\n}\n\n/**\n * Internal component that renders the V2 recovery UI and manages flow state.\n *\n * @internal\n */\nconst BaseRecoveryContent: FC<BaseRecoveryProps> = ({\n  onInitialize,\n  onSubmit,\n  onError,\n  onFlowChange,\n  onComplete,\n  error: externalError,\n  className = '',\n  inputClassName = '',\n  buttonClassName = '',\n  errorClassName = '',\n  messageClassName = '',\n  size = 'medium',\n  variant = 'outlined',\n  isInitialized,\n  children,\n  showTitle = true,\n  showSubtitle = true,\n}: BaseRecoveryProps): ReactElement => {\n  const {theme, colorScheme} = useTheme();\n  const customRenderers: ComponentRendererMap = useContext(ComponentRendererContext);\n  const {t} = useTranslation();\n  const {subtitle: flowSubtitle, title: flowTitle, messages: flowMessages, addMessage, clearMessages} = useFlow();\n  const {meta} = useThunderID();\n  const styles: any = useStyles(theme, colorScheme);\n\n  const [isLoading, setIsLoading] = useState(false);\n  const [isFlowInitialized, setIsFlowInitialized] = useState(false);\n  const [currentFlow, setCurrentFlow] = useState<EmbeddedRecoveryFlowResponse | null>(null);\n  const [apiError, setApiError] = useState<Error | null>(null);\n\n  const initializationAttemptedRef: any = useRef(false);\n  const challengeTokenRef: any = useRef<string | null>(null);\n\n  const handleError: any = useCallback(\n    (error: any) => {\n      const errorMessage: string = extractErrorMessage(error, t);\n      setApiError(error instanceof Error ? error : new Error(errorMessage));\n      clearMessages();\n      addMessage({message: errorMessage, type: 'error'});\n    },\n    [t, addMessage, clearMessages],\n  );\n\n  const normalizeFlowResponseLocal: any = useCallback(\n    (response: EmbeddedRecoveryFlowResponse): EmbeddedRecoveryFlowResponse => {\n      if (response?.data?.components && Array.isArray(response.data.components)) {\n        return response;\n      }\n\n      if (response?.data) {\n        const {components} = normalizeFlowResponse(\n          response,\n          t,\n          {defaultErrorKey: 'components.recovery.errors.generic', resolveTranslations: false},\n          meta,\n        );\n\n        return {...response, data: {...response.data, components: components as any}};\n      }\n\n      return response;\n    },\n    [t, meta],\n  );\n\n  const extractFormFields: any = useCallback(\n    (components: any[]): FormField[] => {\n      const fields: FormField[] = [];\n\n      const processComponents = (comps: any[]): any => {\n        comps.forEach((component: any) => {\n          if (\n            component.type === EmbeddedFlowComponentType.TextInput ||\n            component.type === EmbeddedFlowComponentType.PasswordInput ||\n            component.type === EmbeddedFlowComponentType.EmailInput ||\n            component.type === EmbeddedFlowComponentType.Select ||\n            component.type === EmbeddedFlowComponentType.DateInput\n          ) {\n            const fieldName: any = component.ref || component.id;\n            const ruleValidator = buildValidatorFromRules(component.validation);\n            fields.push({\n              initialValue: '',\n              name: fieldName,\n              required: component.required || false,\n              validator: (value: string) => {\n                if (component.required && (!value || value.trim() === '')) {\n                  return t('validations.required.field.error');\n                }\n                if (\n                  (component.type === EmbeddedFlowComponentType.EmailInput || component.variant === 'EMAIL') &&\n                  value &&\n                  !/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(value)\n                ) {\n                  return t('field.email.invalid');\n                }\n                // Evaluate declarative validation rules from meta.components[].validation.\n                if (ruleValidator && value) {\n                  const ruleMessage = ruleValidator(value);\n                  if (ruleMessage) {\n                    return t(ruleMessage);\n                  }\n                }\n                return null;\n              },\n            });\n          }\n\n          if (component.components && Array.isArray(component.components)) {\n            processComponents(component.components);\n          }\n        });\n      };\n\n      processComponents(components);\n      return fields;\n    },\n    [t],\n  );\n\n  const formFields: any = currentFlow?.data?.components ? extractFormFields(currentFlow.data.components) : [];\n\n  const form: any = useForm<Record<string, string>>({\n    fields: formFields,\n    initialValues: {},\n    requiredMessage: t('validations.required.field.error'),\n    validateOnBlur: true,\n    validateOnChange: false,\n  });\n\n  const {\n    values: formValues,\n    touched: touchedFields,\n    errors: formErrors,\n    isValid: isFormValid,\n    setValue: setFormValue,\n    setTouched: setFormTouched,\n    setErrors: setFormErrors,\n    clearErrors: clearFormErrors,\n    validateForm,\n    touchAllFields,\n    reset: resetForm,\n  } = form;\n\n  /**\n   * Project server-side validation errors from the most recent flow response into the\n   * form's `errors` state. See BaseSignIn for the same pattern.\n   */\n  useEffect(() => {\n    clearFormErrors();\n    const responseFieldErrors: FieldError[] | undefined = (currentFlow?.data as any)?.fieldErrors;\n    if (!responseFieldErrors || responseFieldErrors.length === 0) {\n      return;\n    }\n    const errors: Record<string, string> = {};\n    for (const fe of responseFieldErrors) {\n      if (!(fe.identifier in errors)) {\n        errors[fe.identifier] = fe.message;\n      }\n    }\n    setFormErrors(errors);\n    Object.keys(errors).forEach((field: string) => setFormTouched(field, true));\n  }, [currentFlow, setFormErrors, setFormTouched, clearFormErrors]);\n\n  const setupFormFields: any = useCallback(\n    (flowResponse: EmbeddedRecoveryFlowResponse) => {\n      const fields: any = extractFormFields(flowResponse.data?.components || []);\n      const initialValues: Record<string, string> = {};\n      fields.forEach((field: any) => {\n        initialValues[field.name] = field.initialValue || '';\n      });\n      resetForm();\n      Object.keys(initialValues).forEach((key: any) => setFormValue(key, initialValues[key]));\n    },\n    [extractFormFields, resetForm, setFormValue],\n  );\n\n  const handleInputChange = (name: string, value: string): void => {\n    setFormValue(name, value);\n  };\n\n  const handleInputBlur = (name: string): void => {\n    setFormTouched(name, true);\n  };\n\n  const handleSubmit = async (component: any, data?: Record<string, any>, skipValidation?: boolean): Promise<void> => {\n    if (!currentFlow) return;\n\n    if (!skipValidation) {\n      touchAllFields();\n      const validation: ReturnType<typeof validateForm> = validateForm();\n      if (!validation.isValid) return;\n    }\n\n    setIsLoading(true);\n    setApiError(null);\n    clearMessages();\n\n    try {\n      const filteredInputs: Record<string, any> = {};\n      if (data) {\n        Object.entries(data).forEach(([key, value]: [string, any]) => {\n          if (value !== null && value !== undefined && value !== '') {\n            filteredInputs[key] = value;\n          }\n        });\n      }\n\n      const payload: EmbeddedRecoveryFlowRequest = {\n        ...(currentFlow.executionId && {executionId: currentFlow.executionId}),\n        ...(component.id && {action: component.id}),\n        ...(challengeTokenRef.current ? {challengeToken: challengeTokenRef.current} : {}),\n        inputs: filteredInputs,\n      };\n\n      const rawResponse: any = await onSubmit?.(payload);\n      if (!rawResponse) return;\n      const response: any = normalizeFlowResponseLocal(rawResponse);\n      onFlowChange?.(response);\n\n      if (response.challengeToken !== undefined) {\n        challengeTokenRef.current = response.challengeToken ?? null;\n      }\n\n      if (response.flowStatus === EmbeddedRecoveryFlowStatus.Error) {\n        handleError(response);\n        onError?.(new Error(extractErrorMessage(response, t)));\n        return;\n      }\n\n      if (response.flowStatus === EmbeddedRecoveryFlowStatus.Complete) {\n        onComplete?.(response);\n        return;\n      }\n\n      if (response.flowStatus === EmbeddedRecoveryFlowStatus.Incomplete) {\n        setCurrentFlow(response);\n        setupFormFields(response);\n\n        // Display error from INCOMPLETE response\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n        if (response?.error) {\n          handleError(response);\n        }\n      }\n    } catch (err) {\n      handleError(err);\n      onError?.(err as Error);\n    } finally {\n      setIsLoading(false);\n    }\n  };\n\n  const containerClasses: any = cx(\n    [\n      withVendorCSSClassPrefix('recovery'),\n      withVendorCSSClassPrefix(`recovery--${size}`),\n      withVendorCSSClassPrefix(`recovery--${variant}`),\n    ],\n    className,\n  );\n\n  const inputClasses: any = cx(\n    [\n      withVendorCSSClassPrefix('recovery__input'),\n      size === 'small' && withVendorCSSClassPrefix('recovery__input--small'),\n      size === 'large' && withVendorCSSClassPrefix('recovery__input--large'),\n    ],\n    inputClassName,\n  );\n\n  const buttonClasses: any = cx(\n    [\n      withVendorCSSClassPrefix('recovery__button'),\n      size === 'small' && withVendorCSSClassPrefix('recovery__button--small'),\n      size === 'large' && withVendorCSSClassPrefix('recovery__button--large'),\n    ],\n    buttonClassName,\n  );\n\n  const errorClasses: any = cx([withVendorCSSClassPrefix('recovery__error')], errorClassName);\n  const messageClasses: any = cx([withVendorCSSClassPrefix('recovery__messages')], messageClassName);\n\n  const renderComponents: any = useCallback(\n    (components: any[]): ReactElement[] =>\n      renderRecoveryComponents(\n        components,\n        formValues,\n        touchedFields,\n        formErrors,\n        isLoading,\n        isFormValid,\n        handleInputChange,\n        {\n          _customRenderers: customRenderers,\n          _theme: theme,\n          buttonClassName: buttonClasses,\n          inputClassName: inputClasses,\n          meta,\n          onInputBlur: handleInputBlur,\n          onSubmit: handleSubmit,\n          size,\n          variant,\n        },\n      ),\n    [\n      customRenderers,\n      buttonClasses,\n      formErrors,\n      formValues,\n      handleInputBlur,\n      handleSubmit,\n      inputClasses,\n      isFormValid,\n      meta,\n      isLoading,\n      size,\n      theme,\n      touchedFields,\n      variant,\n    ],\n  );\n\n  useEffect(() => {\n    if (isInitialized && !isFlowInitialized && !initializationAttemptedRef.current) {\n      initializationAttemptedRef.current = true;\n\n      (async (): Promise<void> => {\n        setIsLoading(true);\n        setApiError(null);\n        clearMessages();\n\n        try {\n          const rawResponse: any = await onInitialize?.();\n          if (!rawResponse) return;\n          const response: any = normalizeFlowResponseLocal(rawResponse);\n\n          if (response.challengeToken !== undefined) {\n            challengeTokenRef.current = response.challengeToken ?? null;\n          }\n\n          if (response.flowStatus === EmbeddedRecoveryFlowStatus.Error) {\n            handleError(response);\n            onError?.(new Error(extractErrorMessage(response, t)));\n          }\n\n          setCurrentFlow(response);\n          setIsFlowInitialized(true);\n          onFlowChange?.(response);\n\n          if (response.flowStatus === EmbeddedRecoveryFlowStatus.Complete) {\n            onComplete?.(response);\n            return;\n          }\n\n          if (response.flowStatus === EmbeddedRecoveryFlowStatus.Incomplete) {\n            setupFormFields(response);\n\n            // Display error from INCOMPLETE response\n            // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n            if (response?.error) {\n              handleError(response);\n            }\n          }\n        } catch (err) {\n          handleError(err);\n          onError?.(err as Error);\n        } finally {\n          setIsLoading(false);\n        }\n      })();\n    }\n  }, [\n    isFlowInitialized,\n    isInitialized,\n    normalizeFlowResponseLocal,\n    onComplete,\n    onError,\n    onFlowChange,\n    onInitialize,\n    setupFormFields,\n    t,\n  ]);\n\n  if (children) {\n    if (typeof children === 'function') {\n      const renderProps: BaseRecoveryRenderProps = {\n        components: currentFlow?.data?.components || [],\n        error: apiError,\n        fieldErrors: formErrors,\n        handleInputChange,\n        handleSubmit,\n        isLoading,\n        isValid: isFormValid,\n        messages: flowMessages || [],\n        meta,\n        subtitle: flowSubtitle || t('recovery.subheading'),\n        title: flowTitle || t('recovery.heading'),\n        touched: touchedFields,\n        validateForm: (): {fieldErrors: Record<string, string>; isValid: boolean} => {\n          const result: ReturnType<typeof validateForm> = validateForm();\n          return {fieldErrors: result.errors, isValid: result.isValid};\n        },\n        values: formValues,\n      };\n\n      return <div className={containerClasses}>{(children as any)(renderProps)}</div>;\n    }\n\n    return <div className={containerClasses}>{children}</div>;\n  }\n\n  if (!isFlowInitialized && isLoading) {\n    return (\n      <CardPrimitive className={cx(containerClasses, styles.card)} variant={variant}>\n        <CardPrimitive.Content>\n          <div className={styles.loadingContainer}>\n            <Spinner size=\"medium\" />\n          </div>\n        </CardPrimitive.Content>\n      </CardPrimitive>\n    );\n  }\n\n  if (!currentFlow) {\n    return (\n      <CardPrimitive className={cx(containerClasses, styles.card)} variant={variant}>\n        <CardPrimitive.Content>\n          <AlertPrimitive variant=\"error\" className={errorClasses}>\n            <AlertPrimitive.Title>{t('errors.heading')}</AlertPrimitive.Title>\n            <AlertPrimitive.Description>{t('errors.recovery.flow.initialization.failure')}</AlertPrimitive.Description>\n          </AlertPrimitive>\n        </CardPrimitive.Content>\n      </CardPrimitive>\n    );\n  }\n\n  const componentsToRender: any = currentFlow.data?.components || [];\n  const {title, subtitle, componentsWithoutHeadings} = getAuthComponentHeadings(\n    componentsToRender,\n    flowTitle,\n    flowSubtitle,\n    t('recovery.heading'),\n    t('recovery.subheading'),\n  );\n\n  return (\n    <CardPrimitive className={cx(containerClasses, styles.card)} variant={variant}>\n      {(showTitle || showSubtitle) && (\n        <CardPrimitive.Header className={styles.header}>\n          {showTitle && (\n            <CardPrimitive.Title level={2} className={styles.title}>\n              {title}\n            </CardPrimitive.Title>\n          )}\n          {showSubtitle && (\n            <Typography variant=\"body1\" className={styles.subtitle}>\n              {subtitle}\n            </Typography>\n          )}\n        </CardPrimitive.Header>\n      )}\n      <CardPrimitive.Content>\n        {externalError && (\n          <div className={styles.flowMessagesContainer}>\n            <AlertPrimitive variant=\"error\" className={cx(styles.flowMessageItem, messageClasses)}>\n              <AlertPrimitive.Description>{externalError.message}</AlertPrimitive.Description>\n            </AlertPrimitive>\n          </div>\n        )}\n        {flowMessages && flowMessages.length > 0 && (\n          <div className={styles.flowMessagesContainer}>\n            {flowMessages.map((message: any, index: number) => (\n              <AlertPrimitive\n                key={message.id || index}\n                variant={message.type?.toLowerCase() === 'error' ? 'error' : 'info'}\n                className={cx(styles.flowMessageItem, messageClasses)}\n              >\n                <AlertPrimitive.Description>{message.message}</AlertPrimitive.Description>\n              </AlertPrimitive>\n            ))}\n          </div>\n        )}\n        <div className={styles.contentContainer}>\n          {componentsWithoutHeadings && componentsWithoutHeadings.length > 0 ? (\n            renderComponents(componentsWithoutHeadings)\n          ) : (\n            <AlertPrimitive variant=\"warning\">\n              <Typography variant=\"body1\">{t('errors.recovery.components.not.available')}</Typography>\n            </AlertPrimitive>\n          )}\n        </div>\n      </CardPrimitive.Content>\n    </CardPrimitive>\n  );\n};\n\n/**\n * BaseRecovery component for ThunderIDV2 that provides an embedded account/password recovery flow.\n * Accepts API functions as props to maintain framework independence.\n */\nconst BaseRecovery: FC<BaseRecoveryProps> = ({\n  preferences,\n  showLogo = true,\n  ...rest\n}: BaseRecoveryProps): ReactElement => {\n  const {theme, colorScheme} = useTheme();\n  const styles: any = useStyles(theme, colorScheme);\n\n  const content: ReactElement = (\n    <div>\n      {showLogo && (\n        <div className={styles.logoContainer}>\n          <Logo size=\"large\" />\n        </div>\n      )}\n      <FlowProvider>\n        <BaseRecoveryContent showLogo={showLogo} {...rest} />\n      </FlowProvider>\n    </div>\n  );\n\n  if (!preferences) return content;\n\n  return <ComponentPreferencesContext.Provider value={preferences}>{content}</ComponentPreferencesContext.Provider>;\n};\n\nexport default BaseRecovery;\n"],"mappings":"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"}

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

@@ -15,34 +15,33 @@
  * specific language governing permissions and limitations
  * under the License.
  */
-import { FC } from 'react';
-import { RecoveryProps as RecoveryV1Props } from './v1/Recovery';
-import { RecoveryProps as RecoveryV2Props } from './v2/Recovery';
+import { FC, PropsWithChildren } from 'react';
+import { BaseRecoveryProps } from './BaseRecovery';
+export type RecoveryProps = PropsWithChildren<BaseRecoveryProps & {
+    /**
+     * URL query parameter name that carries the recovery token when the user lands via a recovery link.
+     * When set and both `executionId` and this param are present in the URL, the component resumes the
+     * existing flow instead of starting a new one.
+     *
+     * @example
+     * // For a link like /recovery?executionId=xxx&recoveryToken=yyy
+     * <Recovery tokenUrlParam="recoveryToken" />
+     */
+    tokenUrlParam?: string;
+}>;
 /**
- * Props for the Recovery component.
- * Extends RecoveryV1Props & RecoveryV2Props for full compatibility with both implementations.
- */
-export type RecoveryProps = RecoveryV1Props | RecoveryV2Props;
-/**
- * Recovery component that provides an embedded account/password recovery flow.
- * Routes to the appropriate version-specific implementation based on the platform.
+ * Recovery component for ThunderIDV2 that provides an embedded account/password recovery flow.
  *
  * @example
  * ```tsx
- * import { Recovery } from '@thunderid/react';
- *
- * const App = () => (
- *   <Recovery
- *     afterRecoveryUrl="/sign-in"
- *     onComplete={(response) => console.log('Recovery complete', response)}
- *     onError={(error) => console.error('Recovery failed', error)}
- *   />
- * );
- * ```
+ * // Default UI
+ * <Recovery
+ *   afterRecoveryUrl="/sign-in"
+ *   onComplete={(response) => console.log('Recovery complete', response)}
+ *   onError={(error) => console.error('Recovery failed', error)}
+ * />
  *
- * @example
  * // Custom UI with render props
- * ```tsx
  * <Recovery>
  *   {({ values, fieldErrors, handleInputChange, handleSubmit, isLoading, components }) => (
  *     <form onSubmit={(e) => { e.preventDefault(); handleSubmit(components[0], values); }}>

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

@@ -1 +1 @@
-{"version":3,"file":"Recovery.d.ts","sourceRoot":"","sources":["../../../../../src/components/presentation/auth/Recovery/Recovery.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAC,EAAE,EAAC,MAAM,OAAO,CAAC;AACzB,OAAmB,EAAC,aAAa,IAAI,eAAe,EAAC,MAAM,eAAe,CAAC;AAC3E,OAAmB,EAAC,aAAa,IAAI,eAAe,EAAC,MAAM,eAAe,CAAC;AAG3E;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,eAAe,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,QAAA,MAAM,QAAQ,EAAE,EAAE,CAAC,aAAa,CAQ/B,CAAC;AAEF,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"Recovery.d.ts","sourceRoot":"","sources":["../../../../../src/components/presentation/auth/Recovery/Recovery.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAC,EAAE,EAAE,iBAAiB,EAA4B,MAAM,OAAO,CAAC;AACvE,OAAqB,EAAC,iBAAiB,EAAC,MAAM,gBAAgB,CAAC;AAG/D,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAC3C,iBAAiB,GAAG;IAClB;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CACF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,QAAA,MAAM,QAAQ,EAAE,EAAE,CAAC,aAAa,CA2E/B,CAAC;AAEF,eAAe,QAAQ,CAAC"}

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

@@ -1,30 +1,23 @@
 import useThunderID_default from "../../../../contexts/ThunderID/useThunderID.js";
-import Recovery_default from "./v1/Recovery.js";
-import Recovery_default$1 from "./v2/Recovery.js";
-import { Platform } from "@thunderid/browser";
+import BaseRecovery_default from "./BaseRecovery.js";
+import { EmbeddedFlowType } from "@thunderid/browser";
+import { useCallback } from "react";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/components/presentation/auth/Recovery/Recovery.tsx
 /**
-* Recovery component that provides an embedded account/password recovery flow.
-* Routes to the appropriate version-specific implementation based on the platform.
+* Recovery component for ThunderIDV2 that provides an embedded account/password recovery flow.
 *
 * @example
 * ```tsx
-* import { Recovery } from '@thunderid/react';
+* // Default UI
+* <Recovery
+*   afterRecoveryUrl="/sign-in"
+*   onComplete={(response) => console.log('Recovery complete', response)}
+*   onError={(error) => console.error('Recovery failed', error)}
+* />
 *
-* const App = () => (
-*   <Recovery
-*     afterRecoveryUrl="/sign-in"
-*     onComplete={(response) => console.log('Recovery complete', response)}
-*     onError={(error) => console.error('Recovery failed', error)}
-*   />
-* );
-* ```
-*
-* @example
 * // Custom UI with render props
-* ```tsx
 * <Recovery>
 *   {({ values, fieldErrors, handleInputChange, handleSubmit, isLoading, components }) => (
 *     <form onSubmit={(e) => { e.preventDefault(); handleSubmit(components[0], values); }}>
@@ -34,13 +27,48 @@ import { jsx } from "react/jsx-runtime";
 * </Recovery>
 * ```
 */
-const Recovery = (props) => {
-	const { platform } = useThunderID_default();
-	if (platform === Platform.ThunderID) return /* @__PURE__ */ jsx(Recovery_default$1, { ...props });
-	return /* @__PURE__ */ jsx(Recovery_default, { ...props });
+const Recovery = ({ className, size = "medium", afterRecoveryUrl, onError, onComplete, tokenUrlParam, children,...rest }) => {
+	const { recover, isInitialized, applicationId } = useThunderID_default();
+	return /* @__PURE__ */ jsx(BaseRecovery_default, {
+		afterRecoveryUrl,
+		onInitialize: useCallback(async (payload) => {
+			const urlParams = new URL(window.location.href).searchParams;
+			const applicationIdFromUrl = urlParams.get("applicationId");
+			const effectiveApplicationId = applicationId ?? applicationIdFromUrl;
+			if (tokenUrlParam) {
+				const executionId = urlParams.get("executionId");
+				const tokenValue = urlParams.get(tokenUrlParam);
+				if (executionId && tokenValue) return await recover({
+					executionId,
+					inputs: { [tokenUrlParam]: tokenValue }
+				});
+			}
+			return await recover(payload ?? {
+				flowType: EmbeddedFlowType.Recovery,
+				...effectiveApplicationId && { applicationId: effectiveApplicationId }
+			});
+		}, [
+			applicationId,
+			tokenUrlParam,
+			recover
+		]),
+		onSubmit: useCallback(async (payload) => await recover(payload), [recover]),
+		onError,
+		onComplete: useCallback((response) => {
+			onComplete?.(response);
+			if (afterRecoveryUrl) window.location.href = afterRecoveryUrl;
+		}, [onComplete, afterRecoveryUrl]),
+		className,
+		size,
+		isInitialized,
+		showTitle: true,
+		showSubtitle: true,
+		children,
+		...rest
+	});
 };
-var Recovery_default$2 = Recovery;
+var Recovery_default = Recovery;
 
 //#endregion
-export { Recovery_default$2 as default };
+export { Recovery_default as default };
 //# sourceMappingURL=Recovery.js.map