@thunderid/react 0.1.0 → 0.3.0

package/dist/cjs/utils/normalizeThemeConfig.cjs

@@ -0,0 +1,43 @@
+
+//#region src/utils/normalizeThemeConfig.ts
+/**
+* Normalizes a single color value that may have been supplied as a shorthand
+* CSS color string (`'#2563eb'`) instead of the expected object form
+* (`{ main: '#2563eb' }`).
+*
+* This makes the `preferences.theme.overrides.colors.*` API forgiving for
+* JavaScript callers who don't have TypeScript's type-checker to catch the
+* mismatch at compile time.
+*/
+const normalizeColorValue = (color) => typeof color === "string" ? { main: color } : color;
+/**
+* Normalizes a `RecursivePartial<ThemeConfig>` so that color fields which are
+* supplied as plain CSS color strings are coerced into `{ main: string }`
+* objects before being handed to `createTheme`.
+*
+* Only the color groups that `toCssVariables` in `createTheme` actually reads
+* individual sub-keys from are normalized here (`primary`, `secondary`,
+* `error`, `success`, `warning`, `info`).  `border` is left alone because it
+* IS a plain string in `ThemeConfig`.
+*/
+const normalizeThemeConfig = (config) => {
+	if (!config?.colors) return config;
+	const { primary, secondary, error, success, warning, info,...restColors } = config.colors;
+	return {
+		...config,
+		colors: {
+			...restColors,
+			...primary !== void 0 ? { primary: normalizeColorValue(primary) } : {},
+			...secondary !== void 0 ? { secondary: normalizeColorValue(secondary) } : {},
+			...error !== void 0 ? { error: normalizeColorValue(error) } : {},
+			...success !== void 0 ? { success: normalizeColorValue(success) } : {},
+			...warning !== void 0 ? { warning: normalizeColorValue(warning) } : {},
+			...info !== void 0 ? { info: normalizeColorValue(info) } : {}
+		}
+	};
+};
+var normalizeThemeConfig_default = normalizeThemeConfig;
+
+//#endregion
+exports.default = normalizeThemeConfig_default;
+//# sourceMappingURL=normalizeThemeConfig.cjs.map

package/dist/cjs/utils/normalizeThemeConfig.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeThemeConfig.cjs","names":[],"sources":["../../../src/utils/normalizeThemeConfig.ts"],"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 {RecursivePartial, ThemeConfig} from '@thunderid/browser';\n\ninterface ColorWithMain {\n  [key: string]: unknown;\n  main: string;\n}\n\n/**\n * Normalizes a single color value that may have been supplied as a shorthand\n * CSS color string (`'#2563eb'`) instead of the expected object form\n * (`{ main: '#2563eb' }`).\n *\n * This makes the `preferences.theme.overrides.colors.*` API forgiving for\n * JavaScript callers who don't have TypeScript's type-checker to catch the\n * mismatch at compile time.\n */\nconst normalizeColorValue = (color: string | ColorWithMain): ColorWithMain =>\n  typeof color === 'string' ? {main: color} : color;\n\n/**\n * Normalizes a `RecursivePartial<ThemeConfig>` so that color fields which are\n * supplied as plain CSS color strings are coerced into `{ main: string }`\n * objects before being handed to `createTheme`.\n *\n * Only the color groups that `toCssVariables` in `createTheme` actually reads\n * individual sub-keys from are normalized here (`primary`, `secondary`,\n * `error`, `success`, `warning`, `info`).  `border` is left alone because it\n * IS a plain string in `ThemeConfig`.\n */\nconst normalizeThemeConfig = (\n  config: RecursivePartial<ThemeConfig> | undefined,\n): RecursivePartial<ThemeConfig> | undefined => {\n  if (!config?.colors) {\n    return config;\n  }\n\n  const {primary, secondary, error, success, warning, info, ...restColors} = config.colors as any;\n\n  return {\n    ...config,\n    colors: {\n      ...restColors,\n      ...(primary !== undefined ? {primary: normalizeColorValue(primary)} : {}),\n      ...(secondary !== undefined ? {secondary: normalizeColorValue(secondary)} : {}),\n      ...(error !== undefined ? {error: normalizeColorValue(error)} : {}),\n      ...(success !== undefined ? {success: normalizeColorValue(success)} : {}),\n      ...(warning !== undefined ? {warning: normalizeColorValue(warning)} : {}),\n      ...(info !== undefined ? {info: normalizeColorValue(info)} : {}),\n    },\n  };\n};\n\nexport default normalizeThemeConfig;\n"],"mappings":";;;;;;;;;;;AAkCA,MAAM,uBAAuB,UAC3B,OAAO,UAAU,WAAW,EAAC,MAAM,OAAM,GAAG;;;;;;;;;;;AAY9C,MAAM,wBACJ,WAC8C;AAC9C,KAAI,CAAC,QAAQ,OACX,QAAO;CAGT,MAAM,EAAC,SAAS,WAAW,OAAO,SAAS,SAAS,KAAM,GAAG,eAAc,OAAO;AAElF,QAAO;EACL,GAAG;EACH,QAAQ;GACN,GAAG;GACH,GAAI,YAAY,SAAY,EAAC,SAAS,oBAAoB,QAAQ,EAAC,GAAG,EAAE;GACxE,GAAI,cAAc,SAAY,EAAC,WAAW,oBAAoB,UAAU,EAAC,GAAG,EAAE;GAC9E,GAAI,UAAU,SAAY,EAAC,OAAO,oBAAoB,MAAM,EAAC,GAAG,EAAE;GAClE,GAAI,YAAY,SAAY,EAAC,SAAS,oBAAoB,QAAQ,EAAC,GAAG,EAAE;GACxE,GAAI,YAAY,SAAY,EAAC,SAAS,oBAAoB,QAAQ,EAAC,GAAG,EAAE;GACxE,GAAI,SAAS,SAAY,EAAC,MAAM,oBAAoB,KAAK,EAAC,GAAG,EAAE;GAChE;EACF;;AAGH,mCAAe"}

package/dist/cjs/utils/oauth.cjs

@@ -0,0 +1,28 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let __thunderid_browser = require("@thunderid/browser");
+__thunderid_browser = require_rolldown_runtime.__toESM(__thunderid_browser);
+
+//#region src/utils/oauth.ts
+/**
+* Initiates OAuth redirect with CSRF protection.
+* Generates random state, stores return path in sessionStorage, and redirects to OAuth provider.
+*
+* @param redirectURL - OAuth authorization URL from the server
+*/
+function initiateOAuthRedirect(redirectURL) {
+	const basePath = document.querySelector("base")?.getAttribute("href") || "";
+	let returnPath = window.location.pathname;
+	if (basePath && returnPath.startsWith(basePath)) returnPath = returnPath.slice(basePath.length) || "/";
+	const state = crypto.randomUUID();
+	sessionStorage.setItem(`thunderid_oauth_${state}`, JSON.stringify({
+		path: returnPath,
+		timestamp: Date.now()
+	}));
+	const redirectUrlObj = new URL(redirectURL);
+	redirectUrlObj.searchParams.set("state", state);
+	(0, __thunderid_browser.navigate)(redirectUrlObj.toString());
+}
+
+//#endregion
+exports.initiateOAuthRedirect = initiateOAuthRedirect;
+//# sourceMappingURL=oauth.cjs.map

package/dist/cjs/utils/oauth.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.cjs","names":["basePath: string","returnPath: string","state: string","redirectUrlObj: URL"],"sources":["../../../src/utils/oauth.ts"],"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 {navigate} from '@thunderid/browser';\n\n/**\n * Initiates OAuth redirect with CSRF protection.\n * Generates random state, stores return path in sessionStorage, and redirects to OAuth provider.\n *\n * @param redirectURL - OAuth authorization URL from the server\n */\nexport function initiateOAuthRedirect(redirectURL: string): void {\n  const basePath: string = document.querySelector('base')?.getAttribute('href') || '';\n  let returnPath: string = window.location.pathname;\n\n  if (basePath && returnPath.startsWith(basePath)) {\n    returnPath = returnPath.slice(basePath.length) || '/';\n  }\n\n  const state: string = crypto.randomUUID();\n\n  sessionStorage.setItem(\n    `thunderid_oauth_${state}`,\n    JSON.stringify({\n      path: returnPath,\n      timestamp: Date.now(),\n    }),\n  );\n\n  const redirectUrlObj: URL = new URL(redirectURL);\n  redirectUrlObj.searchParams.set('state', state);\n\n  navigate(redirectUrlObj.toString());\n}\n"],"mappings":";;;;;;;;;;;AA0BA,SAAgB,sBAAsB,aAA2B;CAC/D,MAAMA,WAAmB,SAAS,cAAc,OAAO,EAAE,aAAa,OAAO,IAAI;CACjF,IAAIC,aAAqB,OAAO,SAAS;AAEzC,KAAI,YAAY,WAAW,WAAW,SAAS,CAC7C,cAAa,WAAW,MAAM,SAAS,OAAO,IAAI;CAGpD,MAAMC,QAAgB,OAAO,YAAY;AAEzC,gBAAe,QACb,mBAAmB,SACnB,KAAK,UAAU;EACb,MAAM;EACN,WAAW,KAAK,KAAK;EACtB,CAAC,CACH;CAED,MAAMC,iBAAsB,IAAI,IAAI,YAAY;AAChD,gBAAe,aAAa,IAAI,SAAS,MAAM;AAE/C,mCAAS,eAAe,UAAU,CAAC"}

package/dist/cjs/utils/v2/buildThemeConfigFromFlowMeta.cjs

@@ -0,0 +1,48 @@
+
+//#region src/utils/v2/buildThemeConfigFromFlowMeta.ts
+/**
+* Converts a v2 `FlowMetaTheme` into a `RecursivePartial<ThemeConfig>` that
+* `createTheme` can consume.
+*
+* Only fields explicitly present in the FlowMeta response are included so that
+* `createTheme` can deep-merge them onto its base (light/dark) defaults without
+* accidentally dropping sibling keys that were not returned by the server.
+*
+* For example, when FlowMeta returns only `background.default` and
+* `background.paper`, only `body.main` and `surface` are set — the base
+* theme's `background.disabled` and `background.dark` are **not** overridden
+* and therefore keep their default CSS variable values.
+*/
+const buildThemeConfigFromFlowMeta = (flowMetaTheme, colorScheme) => {
+	const scheme = flowMetaTheme.colorSchemes?.[colorScheme];
+	const borderRadius = flowMetaTheme.shape?.borderRadius;
+	const borderRadiusStr = borderRadius !== void 0 ? `${borderRadius}px` : void 0;
+	let colors;
+	if (scheme?.palette) {
+		colors = {};
+		if (scheme.palette.primary) colors.primary = scheme.palette.primary;
+		if (scheme.palette.secondary) colors.secondary = scheme.palette.secondary;
+		if (scheme.palette.text) colors.text = scheme.palette.text;
+		if (scheme.palette.background) {
+			const bg = {};
+			if (scheme.palette.background.default) bg.body = { main: scheme.palette.background.default };
+			if (scheme.palette.background.paper) bg.surface = scheme.palette.background.paper;
+			if (Object.keys(bg).length > 0) colors.background = bg;
+		}
+	}
+	return {
+		...flowMetaTheme.direction ? { direction: flowMetaTheme.direction } : {},
+		...borderRadiusStr ? { borderRadius: {
+			large: borderRadiusStr,
+			medium: borderRadiusStr,
+			small: borderRadiusStr
+		} } : {},
+		...colors && Object.keys(colors).length > 0 ? { colors } : {},
+		...flowMetaTheme.typography?.fontFamily ? { typography: { fontFamily: flowMetaTheme.typography.fontFamily } } : {}
+	};
+};
+var buildThemeConfigFromFlowMeta_default = buildThemeConfigFromFlowMeta;
+
+//#endregion
+exports.default = buildThemeConfigFromFlowMeta_default;
+//# sourceMappingURL=buildThemeConfigFromFlowMeta.cjs.map

package/dist/cjs/utils/v2/buildThemeConfigFromFlowMeta.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildThemeConfigFromFlowMeta.cjs","names":["scheme: FlowMetaThemeColorScheme | undefined","borderRadius: number | undefined","borderRadiusStr: string | undefined","colors: RecursivePartial<ThemeConfig['colors']> | undefined","bg: RecursivePartial<ThemeConfig['colors']['background']>"],"sources":["../../../../src/utils/v2/buildThemeConfigFromFlowMeta.ts"],"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 {FlowMetaTheme, FlowMetaThemeColorScheme, RecursivePartial, ThemeConfig} from '@thunderid/browser';\n\n/**\n * Converts a v2 `FlowMetaTheme` into a `RecursivePartial<ThemeConfig>` that\n * `createTheme` can consume.\n *\n * Only fields explicitly present in the FlowMeta response are included so that\n * `createTheme` can deep-merge them onto its base (light/dark) defaults without\n * accidentally dropping sibling keys that were not returned by the server.\n *\n * For example, when FlowMeta returns only `background.default` and\n * `background.paper`, only `body.main` and `surface` are set — the base\n * theme's `background.disabled` and `background.dark` are **not** overridden\n * and therefore keep their default CSS variable values.\n */\nconst buildThemeConfigFromFlowMeta = (\n  flowMetaTheme: FlowMetaTheme,\n  colorScheme: 'light' | 'dark',\n): RecursivePartial<ThemeConfig> => {\n  const scheme: FlowMetaThemeColorScheme | undefined = flowMetaTheme.colorSchemes?.[colorScheme];\n  const borderRadius: number | undefined = flowMetaTheme.shape?.borderRadius;\n  const borderRadiusStr: string | undefined = borderRadius !== undefined ? `${borderRadius}px` : undefined;\n\n  // Build only the colors that the server actually provided.\n  // Each nested object is constructed incrementally so that absent fields are\n  // simply omitted rather than set to `undefined`, which would shadow the\n  // base-theme defaults inside `createTheme`.\n  let colors: RecursivePartial<ThemeConfig['colors']> | undefined;\n\n  if (scheme?.palette) {\n    colors = {};\n\n    if (scheme.palette.primary) {\n      colors.primary = scheme.palette.primary;\n    }\n    if (scheme.palette.secondary) {\n      colors.secondary = scheme.palette.secondary;\n    }\n    if (scheme.palette.text) {\n      colors.text = scheme.palette.text;\n    }\n\n    // Build background incrementally to avoid replacing the full base object.\n    if (scheme.palette.background) {\n      const bg: RecursivePartial<ThemeConfig['colors']['background']> = {};\n\n      if (scheme.palette.background.default) {\n        bg.body = {main: scheme.palette.background.default};\n      }\n      if (scheme.palette.background.paper) {\n        bg.surface = scheme.palette.background.paper;\n      }\n\n      if (Object.keys(bg).length > 0) {\n        colors.background = bg;\n      }\n    }\n  }\n\n  return {\n    ...(flowMetaTheme.direction ? {direction: flowMetaTheme.direction} : {}),\n    ...(borderRadiusStr\n      ? {\n          borderRadius: {\n            large: borderRadiusStr,\n            medium: borderRadiusStr,\n            small: borderRadiusStr,\n          },\n        }\n      : {}),\n    ...(colors && Object.keys(colors).length > 0 ? {colors} : {}),\n    ...(flowMetaTheme.typography?.fontFamily ? {typography: {fontFamily: flowMetaTheme.typography.fontFamily}} : {}),\n  };\n};\n\nexport default buildThemeConfigFromFlowMeta;\n"],"mappings":";;;;;;;;;;;;;;;AAiCA,MAAM,gCACJ,eACA,gBACkC;CAClC,MAAMA,SAA+C,cAAc,eAAe;CAClF,MAAMC,eAAmC,cAAc,OAAO;CAC9D,MAAMC,kBAAsC,iBAAiB,SAAY,GAAG,aAAa,MAAM;CAM/F,IAAIC;AAEJ,KAAI,QAAQ,SAAS;AACnB,WAAS,EAAE;AAEX,MAAI,OAAO,QAAQ,QACjB,QAAO,UAAU,OAAO,QAAQ;AAElC,MAAI,OAAO,QAAQ,UACjB,QAAO,YAAY,OAAO,QAAQ;AAEpC,MAAI,OAAO,QAAQ,KACjB,QAAO,OAAO,OAAO,QAAQ;AAI/B,MAAI,OAAO,QAAQ,YAAY;GAC7B,MAAMC,KAA4D,EAAE;AAEpE,OAAI,OAAO,QAAQ,WAAW,QAC5B,IAAG,OAAO,EAAC,MAAM,OAAO,QAAQ,WAAW,SAAQ;AAErD,OAAI,OAAO,QAAQ,WAAW,MAC5B,IAAG,UAAU,OAAO,QAAQ,WAAW;AAGzC,OAAI,OAAO,KAAK,GAAG,CAAC,SAAS,EAC3B,QAAO,aAAa;;;AAK1B,QAAO;EACL,GAAI,cAAc,YAAY,EAAC,WAAW,cAAc,WAAU,GAAG,EAAE;EACvE,GAAI,kBACA,EACE,cAAc;GACZ,OAAO;GACP,QAAQ;GACR,OAAO;GACR,EACF,GACD,EAAE;EACN,GAAI,UAAU,OAAO,KAAK,OAAO,CAAC,SAAS,IAAI,EAAC,QAAO,GAAG,EAAE;EAC5D,GAAI,cAAc,YAAY,aAAa,EAAC,YAAY,EAAC,YAAY,cAAc,WAAW,YAAW,EAAC,GAAG,EAAE;EAChH;;AAGH,2CAAe"}

package/dist/cjs/utils/v2/flowTransformer.cjs

@@ -0,0 +1,153 @@
+const require_resolveTranslationsInArray = require('./resolveTranslationsInArray.cjs');
+
+//#region src/utils/v2/flowTransformer.ts
+/**
+* Create a mapping from ref to identifier based on data.inputs array.
+* This handles cases where meta.components use 'ref' to reference inputs,
+* and data.inputs contain the actual 'identifier' field.
+*
+* @param response - The flow response object
+* @returns Map of ref to identifier
+*/
+const createInputRefMapping = (response) => {
+	const mapping = /* @__PURE__ */ new Map();
+	if (response?.data?.inputs && Array.isArray(response.data.inputs)) response.data.inputs.forEach((input) => {
+		if (input.ref && input.identifier) mapping.set(input.ref, input.identifier);
+	});
+	return mapping;
+};
+/**
+* Create a mapping from action ref to nextNode based on data.actions array.
+* This handles cases where meta.components reference actions by ref,
+* and data.actions contain the actual nextNode field for routing.
+*
+* @param response - The flow response object
+* @returns Map of action ref to nextNode
+*/
+const createActionRefMapping = (response) => {
+	const mapping = /* @__PURE__ */ new Map();
+	if (response?.data?.actions && Array.isArray(response.data.actions)) response.data.actions.forEach((action) => {
+		if (action.ref && action.nextNode) mapping.set(action.ref, action.nextNode);
+	});
+	return mapping;
+};
+/**
+* Apply input ref mapping to components recursively.
+* This ensures that component.ref values are mapped to the correct identifier
+* from data.inputs, enabling proper form submission.
+*
+* @param components - Array of components to transform
+* @param refMapping - Map of ref to identifier
+* @param actionMapping - Map of action ref to nextNode
+* @param inputsData - Array of input data for resolving SELECT options
+* @returns Transformed components with correct identifiers and action references
+*/
+const applyInputRefMapping = (components, refMapping, actionMapping, inputsData = []) => components.map((component) => {
+	const transformedComponent = { ...component };
+	if (transformedComponent.ref && refMapping.has(transformedComponent.ref)) transformedComponent.ref = refMapping.get(transformedComponent.ref);
+	if (transformedComponent.type === "SELECT" && component.id) {
+		const inputData = inputsData.find((input) => input.ref === component.id);
+		if (inputData?.options) transformedComponent.options = inputData.options.map((opt) => {
+			if (typeof opt === "string") return {
+				label: opt,
+				value: opt
+			};
+			const value = typeof opt.value === "object" ? JSON.stringify(opt.value) : String(opt.value || "");
+			return {
+				label: typeof opt.label === "object" ? JSON.stringify(opt.label) : String(opt.label || value),
+				value
+			};
+		});
+	}
+	if (transformedComponent.type === "ACTION" && transformedComponent.id && actionMapping.has(transformedComponent.id)) transformedComponent.actionRef = actionMapping.get(transformedComponent.id);
+	if (transformedComponent.components && Array.isArray(transformedComponent.components)) transformedComponent.components = applyInputRefMapping(transformedComponent.components, refMapping, actionMapping, inputsData);
+	return transformedComponent;
+});
+/**
+* Transform and resolve translations in components from flow response.
+* This function extracts components from the response meta structure and optionally resolves
+* any translation strings within them. It also handles mapping of input refs to identifiers
+* and action refs to nextNode values.
+*
+* @param response - The flow response object containing components in meta structure
+* @param t - Translation function from useTranslation hook
+* @param resolveTranslations - Whether to resolve translation strings or keep them as i18n keys (default: true)
+* @returns Array of flow components with resolved or unresolved translations
+*/
+const transformComponents = (response, t, resolveTranslations = true, meta) => {
+	if (!response?.data?.meta?.components) return [];
+	let { components } = response.data.meta;
+	const refMapping = createInputRefMapping(response);
+	const actionMapping = createActionRefMapping(response);
+	const inputsData = response?.data?.inputs || [];
+	if (refMapping.size > 0 || actionMapping.size > 0 || inputsData.length > 0) components = applyInputRefMapping(components, refMapping, actionMapping, inputsData);
+	return resolveTranslations ? require_resolveTranslationsInArray.default(components, t, void 0, meta) : components;
+};
+/**
+* Extract error message from flow error response.
+*
+* Resolution order:
+* 1. Structured `error` object: try i18n lookup via `t(error.message.key)`.
+* 2. Fallback to `defaultValue` from `message`, then `description`.
+* 3. Standard `Error.message`.
+* 4. Generic translated fallback via `defaultErrorKey`.
+*/
+const extractErrorMessage = (error, t, defaultErrorKey = "errors.flow.generic") => {
+	if (error && typeof error === "object" && error.error) {
+		const flowError = error.error;
+		if (flowError?.message?.key) {
+			const translated = t(flowError.message.key);
+			if (translated && translated !== flowError.message.key) return translated;
+			const systemKey = `system.${flowError.message.key}`;
+			const systemTranslated = t(systemKey);
+			if (systemTranslated && systemTranslated !== systemKey) return systemTranslated;
+		}
+		const fallback = flowError?.message?.defaultValue ?? flowError?.description?.defaultValue;
+		if (fallback) return fallback;
+	}
+	if (error && typeof error === "object" && error.failureReason) return error.failureReason;
+	if (error instanceof Error && error.message) return error.message;
+	return t(defaultErrorKey);
+};
+/**
+* Check if a response is an error response and extract the error message.
+* This function identifies error responses by checking for ERROR status and failure reasons.
+*
+* @param response - The flow response to check
+* @param t - Translation function for error messages
+* @param defaultErrorKey - Default translation key for generic errors
+* @returns Error message string if response is an error, null otherwise
+*/
+const checkForErrorResponse = (response, t, defaultErrorKey = "errors.flow.generic") => {
+	if (response?.flowStatus === "ERROR") return extractErrorMessage(response, t, defaultErrorKey);
+	return null;
+};
+/**
+* Generic flow response normalizer that handles both success and error responses.
+* This is the main transformer function that should be used by all flow components.
+*
+* @param response - The raw flow response from the API
+* @param t - Translation function from useTranslation hook
+* @param options - Configuration options for transformation behavior
+* @returns Normalized flow response with executionId and transformed components
+* @throws {any} The original response if it's an error and throwOnError is true
+*/
+const normalizeFlowResponse = (response, t, options = {}, meta) => {
+	const { throwOnError = true, defaultErrorKey = "errors.flow.generic", resolveTranslations = true } = options;
+	if (checkForErrorResponse(response, t, defaultErrorKey) && throwOnError) throw response;
+	const additionalData = response?.data?.additionalData ?? {};
+	if (typeof additionalData["consentPrompt"] === "string") try {
+		const parsed = JSON.parse(additionalData["consentPrompt"]);
+		additionalData["consentPrompt"] = { purposes: Array.isArray(parsed) ? parsed : [] };
+	} catch {}
+	return {
+		additionalData,
+		components: transformComponents(response, t, resolveTranslations, meta),
+		executionId: response.executionId
+	};
+};
+
+//#endregion
+exports.extractErrorMessage = extractErrorMessage;
+exports.normalizeFlowResponse = normalizeFlowResponse;
+//# sourceMappingURL=flowTransformer.cjs.map

package/dist/cjs/utils/v2/flowTransformer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowTransformer.cjs","names":["mapping: Map<string, string>","transformedComponent: any","inputData: any","value: string","refMapping: Map<string, string>","actionMapping: Map<string, string>","inputsData: any[]","resolveTranslationsInArray","flowError: FlowErrorResponse['error']","translated: string","systemTranslated: string","fallback: string | undefined","additionalData: Record<string, any>","parsed: any"],"sources":["../../../../src/utils/v2/flowTransformer.ts"],"sourcesContent":["/**\n * Copyright (c) 2025-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\n/**\n * @fileoverview Shared flow response transformer utilities for v2 embedded flows.\n *\n * This module provides reusable transformation functions for normalizing embedded flow\n * responses from ThunderID APIs. It handles both successful responses with component\n * extraction and error responses with proper error message extraction.\n *\n * Key features:\n * - Component extraction from flow meta structure\n * - Translation string resolution in components\n * - Error response detection and message extraction\n * - Configurable error handling (throw vs return errors)\n *\n * Usage:\n * ```typescript\n * import { normalizeFlowResponse } from '../../../utils/v2/flowTransformer';\n *\n * const { executionId, components } = normalizeFlowResponse(apiResponse, t, {\n *   defaultErrorKey: 'components.signIn.errors.generic'\n * });\n * ```\n *\n * This transformer is used by both SignIn and SignUp v2 components to ensure\n * consistent response handling across all embedded flows.\n */\n\nimport {EmbeddedFlowComponentV2 as EmbeddedFlowComponent, FlowMetadataResponse} from '@thunderid/browser';\nimport resolveTranslationsInArray from './resolveTranslationsInArray';\nimport {UseTranslation} from '../../hooks/useTranslation';\n\n/**\n * Generic flow error response interface that covers common error structure\n */\nexport interface FlowErrorResponse {\n  error?: {\n    code: string;\n    description: {key: string; defaultValue?: string};\n    message: {key: string; defaultValue?: string};\n  };\n  executionId: string;\n  flowStatus: 'ERROR';\n}\n\n/**\n * Configuration options for flow transformation\n */\nexport interface FlowTransformOptions {\n  /**\n   * Default error message key for translation fallback\n   * @default 'errors.flow.generic'\n   */\n  defaultErrorKey?: string;\n  /**\n   * Whether to resolve translation strings or keep them as i18n keys\n   * @default true\n   */\n  resolveTranslations?: boolean;\n  /**\n   * Whether to throw errors or return them as normalized response\n   * @default true\n   */\n  throwOnError?: boolean;\n}\n\n/**\n * Create a mapping from ref to identifier based on data.inputs array.\n * This handles cases where meta.components use 'ref' to reference inputs,\n * and data.inputs contain the actual 'identifier' field.\n *\n * @param response - The flow response object\n * @returns Map of ref to identifier\n */\nconst createInputRefMapping = (response: any): Map<string, string> => {\n  const mapping: Map<string, string> = new Map<string, string>();\n\n  if (response?.data?.inputs && Array.isArray(response.data.inputs)) {\n    response.data.inputs.forEach((input: any) => {\n      if (input.ref && input.identifier) {\n        mapping.set(input.ref, input.identifier);\n      }\n    });\n  }\n\n  return mapping;\n};\n\n/**\n * Create a mapping from action ref to nextNode based on data.actions array.\n * This handles cases where meta.components reference actions by ref,\n * and data.actions contain the actual nextNode field for routing.\n *\n * @param response - The flow response object\n * @returns Map of action ref to nextNode\n */\nconst createActionRefMapping = (response: any): Map<string, string> => {\n  const mapping: Map<string, string> = new Map<string, string>();\n\n  if (response?.data?.actions && Array.isArray(response.data.actions)) {\n    response.data.actions.forEach((action: any) => {\n      if (action.ref && action.nextNode) {\n        mapping.set(action.ref, action.nextNode);\n      }\n    });\n  }\n\n  return mapping;\n};\n\n/**\n * Apply input ref mapping to components recursively.\n * This ensures that component.ref values are mapped to the correct identifier\n * from data.inputs, enabling proper form submission.\n *\n * @param components - Array of components to transform\n * @param refMapping - Map of ref to identifier\n * @param actionMapping - Map of action ref to nextNode\n * @param inputsData - Array of input data for resolving SELECT options\n * @returns Transformed components with correct identifiers and action references\n */\nconst applyInputRefMapping = (\n  components: EmbeddedFlowComponent[],\n  refMapping: Map<string, string>,\n  actionMapping: Map<string, string>,\n  inputsData: any[] = [],\n): EmbeddedFlowComponent[] =>\n  components.map((component: EmbeddedFlowComponent) => {\n    const transformedComponent: any = {...component} as EmbeddedFlowComponent & {\n      actionRef?: string;\n      options?: {label: string; value: string}[];\n    };\n\n    // If this component has a ref that maps to an identifier, update it\n    if (transformedComponent.ref && refMapping.has(transformedComponent.ref)) {\n      transformedComponent.ref = refMapping.get(transformedComponent.ref);\n    }\n\n    // For SELECT components, copy options from data.inputs\n    // The component.id matches the input.ref in the data structure\n    if (transformedComponent.type === 'SELECT' && component.id) {\n      const inputData: any = inputsData.find((input: any) => input.ref === component.id);\n      if (inputData?.options) {\n        transformedComponent.options = inputData.options.map((opt: any) => {\n          if (typeof opt === 'string') {\n            return {label: opt, value: opt};\n          }\n          // Safely handle non-string values to prevent React key crashes\n          const value: string = typeof opt.value === 'object' ? JSON.stringify(opt.value) : String(opt.value || '');\n          const label: string = typeof opt.label === 'object' ? JSON.stringify(opt.label) : String(opt.label || value);\n\n          return {label, value};\n        });\n      }\n    }\n\n    // If this is an action component, map its id to the nextNode\n    // Store the nextNode reference as actionRef property for later use\n    if (\n      transformedComponent.type === 'ACTION' &&\n      transformedComponent.id &&\n      actionMapping.has(transformedComponent.id)\n    ) {\n      transformedComponent.actionRef = actionMapping.get(transformedComponent.id);\n    }\n\n    // Recursively apply to nested components\n    if (transformedComponent.components && Array.isArray(transformedComponent.components)) {\n      transformedComponent.components = applyInputRefMapping(\n        transformedComponent.components,\n        refMapping,\n        actionMapping,\n        inputsData,\n      );\n    }\n\n    return transformedComponent;\n  });\n\n/**\n * Transform and resolve translations in components from flow response.\n * This function extracts components from the response meta structure and optionally resolves\n * any translation strings within them. It also handles mapping of input refs to identifiers\n * and action refs to nextNode values.\n *\n * @param response - The flow response object containing components in meta structure\n * @param t - Translation function from useTranslation hook\n * @param resolveTranslations - Whether to resolve translation strings or keep them as i18n keys (default: true)\n * @returns Array of flow components with resolved or unresolved translations\n */\nexport const transformComponents = (\n  response: any,\n  t: UseTranslation['t'],\n  resolveTranslations = true,\n  meta?: FlowMetadataResponse | null,\n): EmbeddedFlowComponent[] => {\n  if (!response?.data?.meta?.components) {\n    return [];\n  }\n\n  let {components} = response.data.meta;\n\n  // Create mapping from ref to identifier based on data.inputs\n  const refMapping: Map<string, string> = createInputRefMapping(response);\n\n  // Create mapping from action ref to nextNode based on data.actions\n  const actionMapping: Map<string, string> = createActionRefMapping(response);\n\n  // Get inputs data for SELECT option resolution\n  const inputsData: any[] = response?.data?.inputs || [];\n\n  // Apply ref and action mapping if there are any mappings\n  if (refMapping.size > 0 || actionMapping.size > 0 || inputsData.length > 0) {\n    components = applyInputRefMapping(components, refMapping, actionMapping, inputsData);\n  }\n\n  return resolveTranslations ? resolveTranslationsInArray(components, t, undefined, meta) : components;\n};\n\n/**\n * Extract error message from flow error response.\n *\n * Resolution order:\n * 1. Structured `error` object: try i18n lookup via `t(error.message.key)`.\n * 2. Fallback to `defaultValue` from `message`, then `description`.\n * 3. Standard `Error.message`.\n * 4. Generic translated fallback via `defaultErrorKey`.\n */\nexport const extractErrorMessage = (\n  error: FlowErrorResponse | any,\n  t: UseTranslation['t'],\n  defaultErrorKey = 'errors.flow.generic',\n): string => {\n  if (error && typeof error === 'object' && error.error) {\n    const flowError: FlowErrorResponse['error'] = error.error;\n\n    // 1. Try i18n lookup on message.key first (preferred for user-facing errors)\n    if (flowError?.message?.key) {\n      const translated: string = t(flowError.message.key);\n      if (translated && translated !== flowError.message.key) {\n        return translated;\n      }\n\n      // If the key resolved to itself, retry under the 'system:' namespace\n      const systemKey = `system.${flowError.message.key}`;\n      const systemTranslated: string = t(systemKey);\n      if (systemTranslated && systemTranslated !== systemKey) {\n        return systemTranslated;\n      }\n    }\n\n    // 2. Fall back to defaultValue from message, then description\n    const fallback: string | undefined = flowError?.message?.defaultValue ?? flowError?.description?.defaultValue;\n    if (fallback) {\n      return fallback;\n    }\n  }\n\n  // Legacy backward compatibility\n  if (error && typeof error === 'object' && error.failureReason) {\n    return error.failureReason;\n  }\n\n  if (error instanceof Error && error.message) {\n    return error.message;\n  }\n\n  return t(defaultErrorKey);\n};\n\n/**\n * Check if a response is an error response and extract the error message.\n * This function identifies error responses by checking for ERROR status and failure reasons.\n *\n * @param response - The flow response to check\n * @param t - Translation function for error messages\n * @param defaultErrorKey - Default translation key for generic errors\n * @returns Error message string if response is an error, null otherwise\n */\nexport const checkForErrorResponse = (\n  response: any,\n  t: UseTranslation['t'],\n  defaultErrorKey = 'errors.flow.generic',\n): string | null => {\n  if (response?.flowStatus === 'ERROR') {\n    return extractErrorMessage(response, t, defaultErrorKey);\n  }\n\n  return null;\n};\n\n/**\n * Generic flow response normalizer that handles both success and error responses.\n * This is the main transformer function that should be used by all flow components.\n *\n * @param response - The raw flow response from the API\n * @param t - Translation function from useTranslation hook\n * @param options - Configuration options for transformation behavior\n * @returns Normalized flow response with executionId and transformed components\n * @throws {any} The original response if it's an error and throwOnError is true\n */\nexport const normalizeFlowResponse = (\n  response: any,\n  t: UseTranslation['t'],\n  options: FlowTransformOptions = {},\n  meta?: FlowMetadataResponse | null,\n): {\n  additionalData: Record<string, any>;\n  components: EmbeddedFlowComponent[];\n  executionId: string;\n} => {\n  const {throwOnError = true, defaultErrorKey = 'errors.flow.generic', resolveTranslations = true} = options;\n\n  // Check if this is an error response\n  const errorMessage: string | null = checkForErrorResponse(response, t, defaultErrorKey);\n\n  if (errorMessage && throwOnError) {\n    // Throw the original response so it can be caught by error handling\n    throw response;\n  }\n\n  const additionalData: Record<string, any> = (response?.data?.additionalData as Record<string, any>) ?? {};\n\n  // The consent prompt is serialized as a JSON string (array) by the backend.\n  // Parse it and wrap in the expected {purposes: [...]} structure.\n  if (typeof additionalData['consentPrompt'] === 'string') {\n    try {\n      const parsed: any = JSON.parse(additionalData['consentPrompt']);\n      additionalData['consentPrompt'] = {purposes: Array.isArray(parsed) ? parsed : []};\n    } catch {\n      // Leave unparseable value as-is\n    }\n  }\n\n  return {\n    additionalData,\n    components: transformComponents(response, t, resolveTranslations, meta),\n    executionId: response.executionId,\n  };\n};\n"],"mappings":";;;;;;;;;;;AA0FA,MAAM,yBAAyB,aAAuC;CACpE,MAAMA,0BAA+B,IAAI,KAAqB;AAE9D,KAAI,UAAU,MAAM,UAAU,MAAM,QAAQ,SAAS,KAAK,OAAO,CAC/D,UAAS,KAAK,OAAO,SAAS,UAAe;AAC3C,MAAI,MAAM,OAAO,MAAM,WACrB,SAAQ,IAAI,MAAM,KAAK,MAAM,WAAW;GAE1C;AAGJ,QAAO;;;;;;;;;;AAWT,MAAM,0BAA0B,aAAuC;CACrE,MAAMA,0BAA+B,IAAI,KAAqB;AAE9D,KAAI,UAAU,MAAM,WAAW,MAAM,QAAQ,SAAS,KAAK,QAAQ,CACjE,UAAS,KAAK,QAAQ,SAAS,WAAgB;AAC7C,MAAI,OAAO,OAAO,OAAO,SACvB,SAAQ,IAAI,OAAO,KAAK,OAAO,SAAS;GAE1C;AAGJ,QAAO;;;;;;;;;;;;;AAcT,MAAM,wBACJ,YACA,YACA,eACA,aAAoB,EAAE,KAEtB,WAAW,KAAK,cAAqC;CACnD,MAAMC,uBAA4B,EAAC,GAAG,WAAU;AAMhD,KAAI,qBAAqB,OAAO,WAAW,IAAI,qBAAqB,IAAI,CACtE,sBAAqB,MAAM,WAAW,IAAI,qBAAqB,IAAI;AAKrE,KAAI,qBAAqB,SAAS,YAAY,UAAU,IAAI;EAC1D,MAAMC,YAAiB,WAAW,MAAM,UAAe,MAAM,QAAQ,UAAU,GAAG;AAClF,MAAI,WAAW,QACb,sBAAqB,UAAU,UAAU,QAAQ,KAAK,QAAa;AACjE,OAAI,OAAO,QAAQ,SACjB,QAAO;IAAC,OAAO;IAAK,OAAO;IAAI;GAGjC,MAAMC,QAAgB,OAAO,IAAI,UAAU,WAAW,KAAK,UAAU,IAAI,MAAM,GAAG,OAAO,IAAI,SAAS,GAAG;AAGzG,UAAO;IAAC,OAFc,OAAO,IAAI,UAAU,WAAW,KAAK,UAAU,IAAI,MAAM,GAAG,OAAO,IAAI,SAAS,MAAM;IAE7F;IAAM;IACrB;;AAMN,KACE,qBAAqB,SAAS,YAC9B,qBAAqB,MACrB,cAAc,IAAI,qBAAqB,GAAG,CAE1C,sBAAqB,YAAY,cAAc,IAAI,qBAAqB,GAAG;AAI7E,KAAI,qBAAqB,cAAc,MAAM,QAAQ,qBAAqB,WAAW,CACnF,sBAAqB,aAAa,qBAChC,qBAAqB,YACrB,YACA,eACA,WACD;AAGH,QAAO;EACP;;;;;;;;;;;;AAaJ,MAAa,uBACX,UACA,GACA,sBAAsB,MACtB,SAC4B;AAC5B,KAAI,CAAC,UAAU,MAAM,MAAM,WACzB,QAAO,EAAE;CAGX,IAAI,EAAC,eAAc,SAAS,KAAK;CAGjC,MAAMC,aAAkC,sBAAsB,SAAS;CAGvE,MAAMC,gBAAqC,uBAAuB,SAAS;CAG3E,MAAMC,aAAoB,UAAU,MAAM,UAAU,EAAE;AAGtD,KAAI,WAAW,OAAO,KAAK,cAAc,OAAO,KAAK,WAAW,SAAS,EACvE,cAAa,qBAAqB,YAAY,YAAY,eAAe,WAAW;AAGtF,QAAO,sBAAsBC,2CAA2B,YAAY,GAAG,QAAW,KAAK,GAAG;;;;;;;;;;;AAY5F,MAAa,uBACX,OACA,GACA,kBAAkB,0BACP;AACX,KAAI,SAAS,OAAO,UAAU,YAAY,MAAM,OAAO;EACrD,MAAMC,YAAwC,MAAM;AAGpD,MAAI,WAAW,SAAS,KAAK;GAC3B,MAAMC,aAAqB,EAAE,UAAU,QAAQ,IAAI;AACnD,OAAI,cAAc,eAAe,UAAU,QAAQ,IACjD,QAAO;GAIT,MAAM,YAAY,UAAU,UAAU,QAAQ;GAC9C,MAAMC,mBAA2B,EAAE,UAAU;AAC7C,OAAI,oBAAoB,qBAAqB,UAC3C,QAAO;;EAKX,MAAMC,WAA+B,WAAW,SAAS,gBAAgB,WAAW,aAAa;AACjG,MAAI,SACF,QAAO;;AAKX,KAAI,SAAS,OAAO,UAAU,YAAY,MAAM,cAC9C,QAAO,MAAM;AAGf,KAAI,iBAAiB,SAAS,MAAM,QAClC,QAAO,MAAM;AAGf,QAAO,EAAE,gBAAgB;;;;;;;;;;;AAY3B,MAAa,yBACX,UACA,GACA,kBAAkB,0BACA;AAClB,KAAI,UAAU,eAAe,QAC3B,QAAO,oBAAoB,UAAU,GAAG,gBAAgB;AAG1D,QAAO;;;;;;;;;;;;AAaT,MAAa,yBACX,UACA,GACA,UAAgC,EAAE,EAClC,SAKG;CACH,MAAM,EAAC,eAAe,MAAM,kBAAkB,uBAAuB,sBAAsB,SAAQ;AAKnG,KAFoC,sBAAsB,UAAU,GAAG,gBAAgB,IAEnE,aAElB,OAAM;CAGR,MAAMC,iBAAuC,UAAU,MAAM,kBAA0C,EAAE;AAIzG,KAAI,OAAO,eAAe,qBAAqB,SAC7C,KAAI;EACF,MAAMC,SAAc,KAAK,MAAM,eAAe,iBAAiB;AAC/D,iBAAe,mBAAmB,EAAC,UAAU,MAAM,QAAQ,OAAO,GAAG,SAAS,EAAE,EAAC;SAC3E;AAKV,QAAO;EACL;EACA,YAAY,oBAAoB,UAAU,GAAG,qBAAqB,KAAK;EACvE,aAAa,SAAS;EACvB"}

package/dist/cjs/utils/v2/getAuthComponentHeadings.cjs

@@ -0,0 +1,103 @@
+
+//#region src/utils/v2/getAuthComponentHeadings.ts
+/**
+* Extracts heading and subheading components from authentication flow components
+* and provides resolved title/subtitle text with fallback logic.
+*
+* This utility helps maintain consistent heading extraction across authentication
+* components (SignIn, SignUp, etc.) by identifying heading components within the
+* flow structure and providing clean fallback behavior.
+*
+* @param components - Array of flow components to search
+* @param flowTitle - Title from flow context (highest priority)
+* @param flowSubtitle - Subtitle from flow context (highest priority)
+* @param defaultTitle - Default title fallback (lowest priority)
+* @param defaultSubtitle - Default subtitle fallback (lowest priority)
+* @returns Object with resolved title and subtitle text, plus filtered components
+*
+* @example
+* ```typescript
+* const result = getAuthComponentHeadings(
+*   components,
+*   flowTitle,
+*   flowSubtitle,
+*   t('signin.heading'),
+*   t('signin.subheading')
+* );
+*
+* // Use resolved titles
+* <Card.Title>{result.title}</Card.Title>
+* <Typography>{result.subtitle}</Typography>
+*
+* // Render filtered components (without headings)
+* renderComponents(result.componentsWithoutHeadings);
+* ```
+*/
+const getAuthComponentHeadings = (components, flowTitle, flowSubtitle, defaultTitle, defaultSubtitle) => {
+	let heading = null;
+	let subheading = null;
+	/**
+	* Recursively search for heading components
+	*/
+	const findHeadings = (comps) => {
+		for (const component of comps) {
+			if (component.type === "TEXT" && component.variant?.startsWith("HEADING_")) {
+				if (!heading) heading = component;
+				else if (!subheading) {
+					subheading = component;
+					break;
+				}
+			}
+			if (component.components && component.components.length > 0) {
+				findHeadings(component.components);
+				if (heading && subheading) break;
+			}
+		}
+	};
+	/**
+	* Filter out heading components from the flow
+	*/
+	const filterComponents = (comps) => {
+		let foundHeadings = 0;
+		const maxHeadings = 2;
+		const filter = (items) => items.reduce((acc, component) => {
+			if (foundHeadings < maxHeadings && component.type === "TEXT" && component.variant?.startsWith("HEADING_")) {
+				foundHeadings += 1;
+				return acc;
+			}
+			if (component.components && component.components.length > 0) {
+				const filteredNestedComponents = filter(component.components);
+				if (filteredNestedComponents.length > 0) acc.push({
+					...component,
+					components: filteredNestedComponents
+				});
+			} else acc.push(component);
+			return acc;
+		}, []);
+		return filter(comps);
+	};
+	/**
+	* Extract text content from a component
+	*/
+	const getComponentText = (component) => {
+		if (!component) return "";
+		return component.label || "";
+	};
+	findHeadings(components);
+	const headingText = getComponentText(heading);
+	const subheadingText = getComponentText(subheading);
+	return {
+		componentsWithoutHeadings: filterComponents(components),
+		headingComponents: {
+			heading,
+			subheading
+		},
+		subtitle: flowSubtitle || subheadingText || defaultSubtitle || "",
+		title: flowTitle || headingText || defaultTitle || ""
+	};
+};
+var getAuthComponentHeadings_default = getAuthComponentHeadings;
+
+//#endregion
+exports.default = getAuthComponentHeadings_default;
+//# sourceMappingURL=getAuthComponentHeadings.cjs.map

package/dist/cjs/utils/v2/getAuthComponentHeadings.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAuthComponentHeadings.cjs","names":["heading: EmbeddedFlowComponent | null","subheading: EmbeddedFlowComponent | null","filteredNestedComponents: EmbeddedFlowComponent[]","headingText: string","subheadingText: string"],"sources":["../../../../src/utils/v2/getAuthComponentHeadings.ts"],"sourcesContent":["/**\n * Copyright (c) 2025, 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 {EmbeddedFlowComponentV2 as EmbeddedFlowComponent} from '@thunderid/browser';\n\n/**\n * Result of heading extraction from flow components\n */\nexport interface HeadingExtractionResult {\n  heading: EmbeddedFlowComponent | null;\n  subheading: EmbeddedFlowComponent | null;\n}\n\n/**\n * Complete result of authentication component heading extraction\n */\nexport interface AuthComponentHeadingsResult {\n  componentsWithoutHeadings: EmbeddedFlowComponent[];\n  headingComponents: HeadingExtractionResult;\n  subtitle: string;\n  title: string;\n}\n\n/**\n * Extracts heading and subheading components from authentication flow components\n * and provides resolved title/subtitle text with fallback logic.\n *\n * This utility helps maintain consistent heading extraction across authentication\n * components (SignIn, SignUp, etc.) by identifying heading components within the\n * flow structure and providing clean fallback behavior.\n *\n * @param components - Array of flow components to search\n * @param flowTitle - Title from flow context (highest priority)\n * @param flowSubtitle - Subtitle from flow context (highest priority)\n * @param defaultTitle - Default title fallback (lowest priority)\n * @param defaultSubtitle - Default subtitle fallback (lowest priority)\n * @returns Object with resolved title and subtitle text, plus filtered components\n *\n * @example\n * ```typescript\n * const result = getAuthComponentHeadings(\n *   components,\n *   flowTitle,\n *   flowSubtitle,\n *   t('signin.heading'),\n *   t('signin.subheading')\n * );\n *\n * // Use resolved titles\n * <Card.Title>{result.title}</Card.Title>\n * <Typography>{result.subtitle}</Typography>\n *\n * // Render filtered components (without headings)\n * renderComponents(result.componentsWithoutHeadings);\n * ```\n */\nconst getAuthComponentHeadings = (\n  components: EmbeddedFlowComponent[],\n  flowTitle?: string,\n  flowSubtitle?: string,\n  defaultTitle?: string,\n  defaultSubtitle?: string,\n): AuthComponentHeadingsResult => {\n  let heading: EmbeddedFlowComponent | null = null;\n  let subheading: EmbeddedFlowComponent | null = null;\n\n  /**\n   * Recursively search for heading components\n   */\n  const findHeadings = (comps: EmbeddedFlowComponent[]): void => {\n    for (const component of comps) {\n      if (component.type === 'TEXT' && component.variant?.startsWith('HEADING_')) {\n        if (!heading) {\n          heading = component;\n        } else if (!subheading) {\n          subheading = component;\n          break; // We found both, no need to continue\n        }\n      }\n      if (component.components && component.components.length > 0) {\n        findHeadings(component.components);\n        if (heading && subheading) break; // Early exit if both found\n      }\n    }\n  };\n\n  /**\n   * Filter out heading components from the flow\n   */\n  const filterComponents = (comps: EmbeddedFlowComponent[]): EmbeddedFlowComponent[] => {\n    let foundHeadings = 0;\n    const maxHeadings = 2;\n\n    const filter = (items: EmbeddedFlowComponent[]): EmbeddedFlowComponent[] =>\n      items.reduce((acc: EmbeddedFlowComponent[], component: EmbeddedFlowComponent) => {\n        if (foundHeadings < maxHeadings && component.type === 'TEXT' && component.variant?.startsWith('HEADING_')) {\n          foundHeadings += 1;\n          return acc;\n        }\n\n        if (component.components && component.components.length > 0) {\n          const filteredNestedComponents: EmbeddedFlowComponent[] = filter(component.components);\n          if (filteredNestedComponents.length > 0) {\n            acc.push({\n              ...component,\n              components: filteredNestedComponents,\n            });\n          }\n        } else {\n          acc.push(component);\n        }\n\n        return acc;\n      }, []);\n\n    return filter(comps);\n  };\n\n  /**\n   * Extract text content from a component\n   */\n  const getComponentText = (component: EmbeddedFlowComponent | null): string => {\n    if (!component) return '';\n    return component.label || '';\n  };\n\n  findHeadings(components);\n\n  const headingText: string = getComponentText(heading);\n  const subheadingText: string = getComponentText(subheading);\n\n  const result: AuthComponentHeadingsResult = {\n    componentsWithoutHeadings: filterComponents(components),\n    headingComponents: {heading, subheading},\n    subtitle: flowSubtitle || subheadingText || defaultSubtitle || '',\n    title: flowTitle || headingText || defaultTitle || '',\n  };\n\n  return result;\n};\n\nexport default getAuthComponentHeadings;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuEA,MAAM,4BACJ,YACA,WACA,cACA,cACA,oBACgC;CAChC,IAAIA,UAAwC;CAC5C,IAAIC,aAA2C;;;;CAK/C,MAAM,gBAAgB,UAAyC;AAC7D,OAAK,MAAM,aAAa,OAAO;AAC7B,OAAI,UAAU,SAAS,UAAU,UAAU,SAAS,WAAW,WAAW,EACxE;QAAI,CAAC,QACH,WAAU;aACD,CAAC,YAAY;AACtB,kBAAa;AACb;;;AAGJ,OAAI,UAAU,cAAc,UAAU,WAAW,SAAS,GAAG;AAC3D,iBAAa,UAAU,WAAW;AAClC,QAAI,WAAW,WAAY;;;;;;;CAQjC,MAAM,oBAAoB,UAA4D;EACpF,IAAI,gBAAgB;EACpB,MAAM,cAAc;EAEpB,MAAM,UAAU,UACd,MAAM,QAAQ,KAA8B,cAAqC;AAC/E,OAAI,gBAAgB,eAAe,UAAU,SAAS,UAAU,UAAU,SAAS,WAAW,WAAW,EAAE;AACzG,qBAAiB;AACjB,WAAO;;AAGT,OAAI,UAAU,cAAc,UAAU,WAAW,SAAS,GAAG;IAC3D,MAAMC,2BAAoD,OAAO,UAAU,WAAW;AACtF,QAAI,yBAAyB,SAAS,EACpC,KAAI,KAAK;KACP,GAAG;KACH,YAAY;KACb,CAAC;SAGJ,KAAI,KAAK,UAAU;AAGrB,UAAO;KACN,EAAE,CAAC;AAER,SAAO,OAAO,MAAM;;;;;CAMtB,MAAM,oBAAoB,cAAoD;AAC5E,MAAI,CAAC,UAAW,QAAO;AACvB,SAAO,UAAU,SAAS;;AAG5B,cAAa,WAAW;CAExB,MAAMC,cAAsB,iBAAiB,QAAQ;CACrD,MAAMC,iBAAyB,iBAAiB,WAAW;AAS3D,QAP4C;EAC1C,2BAA2B,iBAAiB,WAAW;EACvD,mBAAmB;GAAC;GAAS;GAAW;EACxC,UAAU,gBAAgB,kBAAkB,mBAAmB;EAC/D,OAAO,aAAa,eAAe,gBAAgB;EACpD;;AAKH,uCAAe"}

package/dist/cjs/utils/v2/passkey.cjs

@@ -0,0 +1,93 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+let __thunderid_browser = require("@thunderid/browser");
+__thunderid_browser = require_rolldown_runtime.__toESM(__thunderid_browser);
+
+//#region src/utils/v2/passkey.ts
+/**
+* Handles WebAuthn/Passkey registration flow for browser environments.
+*
+* @param challengeData - JSON stringified challenge data containing WebAuthn creation options.
+* @returns Promise that resolves to a JSON string containing the WebAuthn registration response.
+*/
+const handlePasskeyRegistration = async (challengeData) => {
+	if (!window.navigator.credentials?.create) throw new __thunderid_browser.ThunderIDRuntimeError("WebAuthn is not supported in this browser.", "browser-webauthn-not-supported", "browser", "WebAuthn/Passkey registration requires a browser that supports the Web Authentication API.");
+	try {
+		const creationOptions = JSON.parse(challengeData);
+		const publicKey = {
+			...creationOptions,
+			challenge: (0, __thunderid_browser.base64urlToArrayBuffer)(creationOptions.challenge),
+			user: {
+				...creationOptions.user,
+				id: (0, __thunderid_browser.base64urlToArrayBuffer)(creationOptions.user.id)
+			},
+			...creationOptions.excludeCredentials && { excludeCredentials: creationOptions.excludeCredentials.map((cred) => ({
+				...cred,
+				id: (0, __thunderid_browser.base64urlToArrayBuffer)(cred.id)
+			})) }
+		};
+		const credential = await navigator.credentials.create({ publicKey });
+		if (!credential) throw new __thunderid_browser.ThunderIDRuntimeError("No credential returned from WebAuthn registration.", "browser-webauthn-no-credential", "browser", "The WebAuthn registration ceremony completed but did not return a valid credential.");
+		const response = credential.response;
+		const registrationResponse = {
+			id: credential.id,
+			rawId: (0, __thunderid_browser.arrayBufferToBase64url)(credential.rawId),
+			response: {
+				attestationObject: (0, __thunderid_browser.arrayBufferToBase64url)(response.attestationObject),
+				clientDataJSON: (0, __thunderid_browser.arrayBufferToBase64url)(response.clientDataJSON),
+				...response.getTransports && { transports: response.getTransports() }
+			},
+			type: credential.type,
+			...credential.authenticatorAttachment && { authenticatorAttachment: credential.authenticatorAttachment }
+		};
+		return JSON.stringify(registrationResponse);
+	} catch (error) {
+		if (error instanceof __thunderid_browser.ThunderIDRuntimeError) throw error;
+		if (error instanceof Error) throw new __thunderid_browser.ThunderIDRuntimeError(`Passkey registration failed: ${error.message}`, "browser-webauthn-registration-error", "browser", `WebAuthn registration failed with error: ${error.name}`);
+		throw new __thunderid_browser.ThunderIDRuntimeError("Passkey registration failed due to an unexpected error.", "browser-webauthn-unexpected-error", "browser", "An unexpected error occurred during WebAuthn registration.");
+	}
+};
+/**
+* Handles WebAuthn/Passkey authentication flow for browser environments.
+*
+* @param challengeData - JSON stringified challenge data containing WebAuthn request options.
+* @returns Promise that resolves to a JSON string containing the WebAuthn authentication response.
+*/
+const handlePasskeyAuthentication = async (challengeData) => {
+	if (!window.navigator.credentials?.get) throw new __thunderid_browser.ThunderIDRuntimeError("WebAuthn is not supported in this browser.", "browser-webauthn-not-supported", "browser", "WebAuthn/Passkey authentication requires a browser that supports the Web Authentication API.");
+	try {
+		const requestOptions = JSON.parse(challengeData);
+		const publicKey = {
+			...requestOptions,
+			challenge: (0, __thunderid_browser.base64urlToArrayBuffer)(requestOptions.challenge),
+			...requestOptions.allowCredentials && { allowCredentials: requestOptions.allowCredentials.map((cred) => ({
+				...cred,
+				id: (0, __thunderid_browser.base64urlToArrayBuffer)(cred.id)
+			})) }
+		};
+		const credential = await navigator.credentials.get({ publicKey });
+		if (!credential) throw new __thunderid_browser.ThunderIDRuntimeError("No credential returned from WebAuthn authentication.", "browser-webauthn-no-credential", "browser", "The WebAuthn authentication ceremony completed but did not return a valid credential.");
+		const response = credential.response;
+		const authenticationResponse = {
+			id: credential.id,
+			rawId: (0, __thunderid_browser.arrayBufferToBase64url)(credential.rawId),
+			response: {
+				authenticatorData: (0, __thunderid_browser.arrayBufferToBase64url)(response.authenticatorData),
+				clientDataJSON: (0, __thunderid_browser.arrayBufferToBase64url)(response.clientDataJSON),
+				signature: (0, __thunderid_browser.arrayBufferToBase64url)(response.signature),
+				...response.userHandle && { userHandle: (0, __thunderid_browser.arrayBufferToBase64url)(response.userHandle) }
+			},
+			type: credential.type,
+			...credential.authenticatorAttachment && { authenticatorAttachment: credential.authenticatorAttachment }
+		};
+		return JSON.stringify(authenticationResponse);
+	} catch (error) {
+		if (error instanceof __thunderid_browser.ThunderIDRuntimeError) throw error;
+		if (error instanceof Error) throw new __thunderid_browser.ThunderIDRuntimeError(`Passkey authentication failed: ${error.message}`, "browser-webauthn-authentication-error", "browser", `WebAuthn authentication failed with error: ${error.name}`);
+		throw new __thunderid_browser.ThunderIDRuntimeError("Passkey authentication failed due to an unexpected error.", "browser-webauthn-unexpected-error", "browser", "An unexpected error occurred during WebAuthn authentication.");
+	}
+};
+
+//#endregion
+exports.handlePasskeyAuthentication = handlePasskeyAuthentication;
+exports.handlePasskeyRegistration = handlePasskeyRegistration;
+//# sourceMappingURL=passkey.cjs.map

package/dist/cjs/utils/v2/passkey.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"passkey.cjs","names":["ThunderIDRuntimeError","creationOptions: any","publicKey: any","credential: PublicKeyCredential","response: AuthenticatorAttestationResponse","registrationResponse: any","requestOptions: any","response: AuthenticatorAssertionResponse","authenticationResponse: any"],"sources":["../../../../src/utils/v2/passkey.ts"],"sourcesContent":["/**\n * Copyright (c) 2025, 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 {ThunderIDRuntimeError, arrayBufferToBase64url, base64urlToArrayBuffer} from '@thunderid/browser';\n\n/**\n * Handles WebAuthn/Passkey registration flow for browser environments.\n *\n * @param challengeData - JSON stringified challenge data containing WebAuthn creation options.\n * @returns Promise that resolves to a JSON string containing the WebAuthn registration response.\n */\nexport const handlePasskeyRegistration = async (challengeData: string): Promise<string> => {\n  if (!window.navigator.credentials?.create) {\n    throw new ThunderIDRuntimeError(\n      'WebAuthn is not supported in this browser.',\n      'browser-webauthn-not-supported',\n      'browser',\n      'WebAuthn/Passkey registration requires a browser that supports the Web Authentication API.',\n    );\n  }\n\n  try {\n    const creationOptions: any = JSON.parse(challengeData);\n\n    // Decode challenge and user ID from base64url to BufferSource\n    const publicKey: any = {\n      ...creationOptions,\n      challenge: base64urlToArrayBuffer(creationOptions.challenge),\n      user: {\n        ...creationOptions.user,\n        id: base64urlToArrayBuffer(creationOptions.user.id),\n      },\n      ...(creationOptions.excludeCredentials && {\n        excludeCredentials: creationOptions.excludeCredentials.map((cred: any) => ({\n          ...cred,\n          id: base64urlToArrayBuffer(cred.id),\n        })),\n      }),\n    };\n\n    const credential: PublicKeyCredential = (await navigator.credentials.create({\n      publicKey,\n    })) as PublicKeyCredential;\n\n    if (!credential) {\n      throw new ThunderIDRuntimeError(\n        'No credential returned from WebAuthn registration.',\n        'browser-webauthn-no-credential',\n        'browser',\n        'The WebAuthn registration ceremony completed but did not return a valid credential.',\n      );\n    }\n\n    const response: AuthenticatorAttestationResponse = credential.response as AuthenticatorAttestationResponse;\n\n    // Encode response fields back to base64url\n    const registrationResponse: any = {\n      id: credential.id,\n      rawId: arrayBufferToBase64url(credential.rawId),\n      response: {\n        attestationObject: arrayBufferToBase64url(response.attestationObject),\n        clientDataJSON: arrayBufferToBase64url(response.clientDataJSON),\n        ...(response.getTransports && {\n          transports: response.getTransports(),\n        }),\n      },\n      type: credential.type,\n      ...(credential.authenticatorAttachment && {\n        authenticatorAttachment: credential.authenticatorAttachment,\n      }),\n    };\n\n    return JSON.stringify(registrationResponse);\n  } catch (error) {\n    if (error instanceof ThunderIDRuntimeError) {\n      throw error;\n    }\n\n    if (error instanceof Error) {\n      // Map specific WebAuthn errors to ThunderIDRuntimeError/friendly messages as needed\n      throw new ThunderIDRuntimeError(\n        `Passkey registration failed: ${error.message}`,\n        'browser-webauthn-registration-error',\n        'browser',\n        `WebAuthn registration failed with error: ${error.name}`,\n      );\n    }\n\n    throw new ThunderIDRuntimeError(\n      'Passkey registration failed due to an unexpected error.',\n      'browser-webauthn-unexpected-error',\n      'browser',\n      'An unexpected error occurred during WebAuthn registration.',\n    );\n  }\n};\n\n/**\n * Handles WebAuthn/Passkey authentication flow for browser environments.\n *\n * @param challengeData - JSON stringified challenge data containing WebAuthn request options.\n * @returns Promise that resolves to a JSON string containing the WebAuthn authentication response.\n */\nexport const handlePasskeyAuthentication = async (challengeData: string): Promise<string> => {\n  if (!window.navigator.credentials?.get) {\n    throw new ThunderIDRuntimeError(\n      'WebAuthn is not supported in this browser.',\n      'browser-webauthn-not-supported',\n      'browser',\n      'WebAuthn/Passkey authentication requires a browser that supports the Web Authentication API.',\n    );\n  }\n\n  try {\n    const requestOptions: any = JSON.parse(challengeData);\n\n    // Decode challenge and allowed credentials from base64url to BufferSource\n    const publicKey: any = {\n      ...requestOptions,\n      challenge: base64urlToArrayBuffer(requestOptions.challenge),\n      ...(requestOptions.allowCredentials && {\n        allowCredentials: requestOptions.allowCredentials.map((cred: any) => ({\n          ...cred,\n          id: base64urlToArrayBuffer(cred.id),\n        })),\n      }),\n    };\n\n    const credential: PublicKeyCredential = (await navigator.credentials.get({\n      publicKey,\n    })) as PublicKeyCredential;\n\n    if (!credential) {\n      throw new ThunderIDRuntimeError(\n        'No credential returned from WebAuthn authentication.',\n        'browser-webauthn-no-credential',\n        'browser',\n        'The WebAuthn authentication ceremony completed but did not return a valid credential.',\n      );\n    }\n\n    const response: AuthenticatorAssertionResponse = credential.response as AuthenticatorAssertionResponse;\n\n    // Encode response fields back to base64url\n    const authenticationResponse: any = {\n      id: credential.id,\n      rawId: arrayBufferToBase64url(credential.rawId),\n      response: {\n        authenticatorData: arrayBufferToBase64url(response.authenticatorData),\n        clientDataJSON: arrayBufferToBase64url(response.clientDataJSON),\n        signature: arrayBufferToBase64url(response.signature),\n        ...(response.userHandle && {\n          userHandle: arrayBufferToBase64url(response.userHandle),\n        }),\n      },\n      type: credential.type,\n      ...(credential.authenticatorAttachment && {\n        authenticatorAttachment: credential.authenticatorAttachment,\n      }),\n    };\n\n    return JSON.stringify(authenticationResponse);\n  } catch (error) {\n    if (error instanceof ThunderIDRuntimeError) {\n      throw error;\n    }\n\n    if (error instanceof Error) {\n      throw new ThunderIDRuntimeError(\n        `Passkey authentication failed: ${error.message}`,\n        'browser-webauthn-authentication-error',\n        'browser',\n        `WebAuthn authentication failed with error: ${error.name}`,\n      );\n    }\n\n    throw new ThunderIDRuntimeError(\n      'Passkey authentication failed due to an unexpected error.',\n      'browser-webauthn-unexpected-error',\n      'browser',\n      'An unexpected error occurred during WebAuthn authentication.',\n    );\n  }\n};\n"],"mappings":";;;;;;;;;;;AA0BA,MAAa,4BAA4B,OAAO,kBAA2C;AACzF,KAAI,CAAC,OAAO,UAAU,aAAa,OACjC,OAAM,IAAIA,0CACR,8CACA,kCACA,WACA,6FACD;AAGH,KAAI;EACF,MAAMC,kBAAuB,KAAK,MAAM,cAAc;EAGtD,MAAMC,YAAiB;GACrB,GAAG;GACH,2DAAkC,gBAAgB,UAAU;GAC5D,MAAM;IACJ,GAAG,gBAAgB;IACnB,oDAA2B,gBAAgB,KAAK,GAAG;IACpD;GACD,GAAI,gBAAgB,sBAAsB,EACxC,oBAAoB,gBAAgB,mBAAmB,KAAK,UAAe;IACzE,GAAG;IACH,oDAA2B,KAAK,GAAG;IACpC,EAAE,EACJ;GACF;EAED,MAAMC,aAAmC,MAAM,UAAU,YAAY,OAAO,EAC1E,WACD,CAAC;AAEF,MAAI,CAAC,WACH,OAAM,IAAIH,0CACR,sDACA,kCACA,WACA,sFACD;EAGH,MAAMI,WAA6C,WAAW;EAG9D,MAAMC,uBAA4B;GAChC,IAAI,WAAW;GACf,uDAA8B,WAAW,MAAM;GAC/C,UAAU;IACR,mEAA0C,SAAS,kBAAkB;IACrE,gEAAuC,SAAS,eAAe;IAC/D,GAAI,SAAS,iBAAiB,EAC5B,YAAY,SAAS,eAAe,EACrC;IACF;GACD,MAAM,WAAW;GACjB,GAAI,WAAW,2BAA2B,EACxC,yBAAyB,WAAW,yBACrC;GACF;AAED,SAAO,KAAK,UAAU,qBAAqB;UACpC,OAAO;AACd,MAAI,iBAAiBL,0CACnB,OAAM;AAGR,MAAI,iBAAiB,MAEnB,OAAM,IAAIA,0CACR,gCAAgC,MAAM,WACtC,uCACA,WACA,4CAA4C,MAAM,OACnD;AAGH,QAAM,IAAIA,0CACR,2DACA,qCACA,WACA,6DACD;;;;;;;;;AAUL,MAAa,8BAA8B,OAAO,kBAA2C;AAC3F,KAAI,CAAC,OAAO,UAAU,aAAa,IACjC,OAAM,IAAIA,0CACR,8CACA,kCACA,WACA,+FACD;AAGH,KAAI;EACF,MAAMM,iBAAsB,KAAK,MAAM,cAAc;EAGrD,MAAMJ,YAAiB;GACrB,GAAG;GACH,2DAAkC,eAAe,UAAU;GAC3D,GAAI,eAAe,oBAAoB,EACrC,kBAAkB,eAAe,iBAAiB,KAAK,UAAe;IACpE,GAAG;IACH,oDAA2B,KAAK,GAAG;IACpC,EAAE,EACJ;GACF;EAED,MAAMC,aAAmC,MAAM,UAAU,YAAY,IAAI,EACvE,WACD,CAAC;AAEF,MAAI,CAAC,WACH,OAAM,IAAIH,0CACR,wDACA,kCACA,WACA,wFACD;EAGH,MAAMO,WAA2C,WAAW;EAG5D,MAAMC,yBAA8B;GAClC,IAAI,WAAW;GACf,uDAA8B,WAAW,MAAM;GAC/C,UAAU;IACR,mEAA0C,SAAS,kBAAkB;IACrE,gEAAuC,SAAS,eAAe;IAC/D,2DAAkC,SAAS,UAAU;IACrD,GAAI,SAAS,cAAc,EACzB,4DAAmC,SAAS,WAAW,EACxD;IACF;GACD,MAAM,WAAW;GACjB,GAAI,WAAW,2BAA2B,EACxC,yBAAyB,WAAW,yBACrC;GACF;AAED,SAAO,KAAK,UAAU,uBAAuB;UACtC,OAAO;AACd,MAAI,iBAAiBR,0CACnB,OAAM;AAGR,MAAI,iBAAiB,MACnB,OAAM,IAAIA,0CACR,kCAAkC,MAAM,WACxC,yCACA,WACA,8CAA8C,MAAM,OACrD;AAGH,QAAM,IAAIA,0CACR,6DACA,qCACA,WACA,+DACD"}

package/dist/cjs/utils/v2/resolveTranslationsInArray.cjs

@@ -0,0 +1,21 @@
+const require_resolveTranslationsInObject = require('./resolveTranslationsInObject.cjs');
+
+//#region src/utils/v2/resolveTranslationsInArray.ts
+/**
+* Recursively resolves translation and meta template strings in an array of objects.
+* @param items - Array of objects to process
+* @param t - The translation function from useTranslation
+* @param properties - Array of property names to resolve (optional)
+* @param meta - Optional flow metadata for resolving meta() expressions
+* @returns A new array with resolved translations
+*/
+const resolveTranslationsInArray = (items, t, properties, meta) => items.map((item) => {
+	const resolved = require_resolveTranslationsInObject.resolveTranslationsInObject(item, t, properties, meta);
+	if (resolved["components"] && Array.isArray(resolved["components"])) resolved.components = resolveTranslationsInArray(resolved["components"], t, properties, meta);
+	return resolved;
+});
+var resolveTranslationsInArray_default = resolveTranslationsInArray;
+
+//#endregion
+exports.default = resolveTranslationsInArray_default;
+//# sourceMappingURL=resolveTranslationsInArray.cjs.map

package/dist/cjs/utils/v2/resolveTranslationsInArray.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveTranslationsInArray.cjs","names":["resolved: T","resolveTranslationsInObject"],"sources":["../../../../src/utils/v2/resolveTranslationsInArray.ts"],"sourcesContent":["/**\n * Copyright (c) 2025, 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 {FlowMetadataResponse} from '@thunderid/browser';\nimport {resolveTranslationsInObject} from './resolveTranslationsInObject';\nimport {UseTranslation} from '../../hooks/useTranslation';\n\n/**\n * Recursively resolves translation and meta template strings in an array of objects.\n * @param items - Array of objects to process\n * @param t - The translation function from useTranslation\n * @param properties - Array of property names to resolve (optional)\n * @param meta - Optional flow metadata for resolving meta() expressions\n * @returns A new array with resolved translations\n */\nconst resolveTranslationsInArray = <T extends Record<string, any>>(\n  items: T[],\n  t: UseTranslation['t'],\n  properties?: string[],\n  meta?: FlowMetadataResponse | null,\n): T[] =>\n  items.map((item: T) => {\n    const resolved: T = resolveTranslationsInObject(item, t, properties, meta);\n\n    // If the item has nested components (like BLOCK or STACK type), resolve those too\n    if (resolved['components'] && Array.isArray(resolved['components'])) {\n      (resolved as any).components = resolveTranslationsInArray(resolved['components'], t, properties, meta);\n    }\n\n    return resolved;\n  });\n\nexport default resolveTranslationsInArray;\n"],"mappings":";;;;;;;;;;;AA8BA,MAAM,8BACJ,OACA,GACA,YACA,SAEA,MAAM,KAAK,SAAY;CACrB,MAAMA,WAAcC,gEAA4B,MAAM,GAAG,YAAY,KAAK;AAG1E,KAAI,SAAS,iBAAiB,MAAM,QAAQ,SAAS,cAAc,CACjE,CAAC,SAAiB,aAAa,2BAA2B,SAAS,eAAe,GAAG,YAAY,KAAK;AAGxG,QAAO;EACP;AAEJ,yCAAe"}