@pisell/private-materials 6.12.200 → 6.12.201

package/es/components/HDLKiosk/index.js

@@ -57,10 +57,11 @@ function HDLKioskContent({ host, config, isActive = true, entryDataPreparing = f
 		setActiveLocale(nextLocale);
 		onLocaleChange === null || onLocaleChange === void 0 || onLocaleChange(nextLocale);
 	}, [onLocaleChange]);
-	const { session, starting, startErrorReference, exiting, exitError, pendingExit, start, back, requestExit, resolveExit, completeOrder, recover } = useHDLKioskSessionController({
+	const { session, starting, preparingEntry, entryPreparationErrorReference, startErrorReference, exiting, exitError, pendingExit, start, back, requestExit, resolveExit, completeOrder, recover, retryEntryPreparation } = useHDLKioskSessionController({
 		host,
 		config,
-		isActive
+		isActive,
+		entryPreparationBlocked: entryDataPreparing || sales.hostStatus === "loading"
 	});
 	const observeExit = useCallback((result) => {
 		if (result.status === "exited") onPaymentResultReset === null || onPaymentResultReset === void 0 || onPaymentResultReset();
@@ -167,10 +168,12 @@ function HDLKioskContent({ host, config, isActive = true, entryDataPreparing = f
 				start({ entry });
 			}
 		},
-		busy: starting,
-		errorReference: startErrorReference,
-		errorMessage: locales.getText("pisell2.hdl-kiosk.session-start-failed")
-	}), starting ? /* @__PURE__ */ React.createElement("div", {
+		busy: starting || preparingEntry || Boolean(entryPreparationErrorReference),
+		errorReference: entryPreparationErrorReference || startErrorReference,
+		errorMessage: locales.getText(entryPreparationErrorReference ? "pisell2.hdl-kiosk.reset-failed-description" : "pisell2.hdl-kiosk.session-start-failed"),
+		retryLabel: entryPreparationErrorReference ? locales.getText("pisell2.hdl-kiosk.retry-entry-preparation") : void 0,
+		onRetry: entryPreparationErrorReference ? retryEntryPreparation : void 0
+	}), starting || preparingEntry ? /* @__PURE__ */ React.createElement("div", {
 		className: "hdl-operation-overlay",
 		role: "status"
 	}, /* @__PURE__ */ React.createElement("span", { className: "hdl-operation-overlay__spinner" }), /* @__PURE__ */ React.createElement("strong", null, locales.getText("pisell2.hdl-kiosk.working"))) : null));

package/es/components/HDLKiosk/locales.js

@@ -45,6 +45,7 @@ const localeTexts = {
 		"pisell2.hdl-kiosk.payment-conflict-title": "Payment needs attention",
 		"pisell2.hdl-kiosk.payment-conflict-description": "Please do not pay again. Ask a staff member to check your payment.",
 		"pisell2.hdl-kiosk.resetting-order": "Preparing next order…",
+		"pisell2.hdl-kiosk.retry-entry-preparation": "Retry preparation",
 		"pisell2.hdl-kiosk.order-needs-attention": "The previous action did not complete. Review the order before continuing.",
 		"pisell2.hdl-kiosk.fulfillment-unavailable": "This device cannot save the dining option yet. Please ask a staff member for help.",
 		"pisell2.hdl-kiosk.keep-ordering": "Keep ordering",
@@ -86,6 +87,8 @@ const localeTexts = {
 		"pisell2.hdl-kiosk.customization-unit-price": "Unit price",
 		"pisell2.hdl-kiosk.customization-per100g": "/100g",
 		"pisell2.hdl-kiosk.customization-next": "Next",
+		"pisell2.hdl-kiosk.customization-required-options": "Please select an option for every required group.",
+		"pisell2.hdl-kiosk.customization-required-group": (groupName) => `Please select an option in “${groupName}”.`,
 		"pisell2.hdl-kiosk.primary-product-prompt-eyebrow": "Before Checkout",
 		"pisell2.hdl-kiosk.primary-product-prompt-title": "Would you like to add a Malatang bowl?",
 		"pisell2.hdl-kiosk.primary-product-prompt-accept": "Yes",
@@ -202,6 +205,7 @@ const localeTexts = {
 		"pisell2.hdl-kiosk.payment-conflict-title": "请确认支付状态",
 		"pisell2.hdl-kiosk.payment-conflict-description": "请勿重复付款，并联系工作人员确认。",
 		"pisell2.hdl-kiosk.resetting-order": "正在准备下一单…",
+		"pisell2.hdl-kiosk.retry-entry-preparation": "重新准备",
 		"pisell2.hdl-kiosk.order-needs-attention": "上一步未完成，请核对订单后再继续。",
 		"pisell2.hdl-kiosk.fulfillment-unavailable": "当前设备尚未接入用餐方式写入能力，请联系工作人员处理。",
 		"pisell2.hdl-kiosk.keep-ordering": "继续点餐",
@@ -243,6 +247,8 @@ const localeTexts = {
 		"pisell2.hdl-kiosk.customization-unit-price": "单价",
 		"pisell2.hdl-kiosk.customization-per100g": "/100克",
 		"pisell2.hdl-kiosk.customization-next": "下一步",
+		"pisell2.hdl-kiosk.customization-required-options": "请完成所有必选规格的选择。",
+		"pisell2.hdl-kiosk.customization-required-group": (groupName) => `请选择「${groupName}」中的必选项。`,
 		"pisell2.hdl-kiosk.primary-product-prompt-eyebrow": "结账前确认",
 		"pisell2.hdl-kiosk.primary-product-prompt-title": "需要添加一份麻辣烫吗？",
 		"pisell2.hdl-kiosk.primary-product-prompt-accept": "需要",
@@ -359,6 +365,7 @@ const localeTexts = {
 		"pisell2.hdl-kiosk.payment-conflict-title": "請確認付款狀態",
 		"pisell2.hdl-kiosk.payment-conflict-description": "請勿重複付款，並聯絡工作人員確認。",
 		"pisell2.hdl-kiosk.resetting-order": "正在準備下一單…",
+		"pisell2.hdl-kiosk.retry-entry-preparation": "重新準備",
 		"pisell2.hdl-kiosk.order-needs-attention": "上一步未完成，請核對訂單後再繼續。",
 		"pisell2.hdl-kiosk.fulfillment-unavailable": "當前設備尚未接入用餐方式寫入能力，請聯絡工作人員處理。",
 		"pisell2.hdl-kiosk.keep-ordering": "繼續點餐",
@@ -400,6 +407,8 @@ const localeTexts = {
 		"pisell2.hdl-kiosk.customization-unit-price": "單價",
 		"pisell2.hdl-kiosk.customization-per100g": "/100克",
 		"pisell2.hdl-kiosk.customization-next": "下一步",
+		"pisell2.hdl-kiosk.customization-required-options": "請完成所有必選規格的選擇。",
+		"pisell2.hdl-kiosk.customization-required-group": (groupName) => `請選擇「${groupName}」中的必選項。`,
 		"pisell2.hdl-kiosk.primary-product-prompt-eyebrow": "結帳前確認",
 		"pisell2.hdl-kiosk.primary-product-prompt-title": "需要加入一份麻辣燙嗎？",
 		"pisell2.hdl-kiosk.primary-product-prompt-accept": "需要",
@@ -516,6 +525,7 @@ const localeTexts = {
 		"pisell2.hdl-kiosk.payment-conflict-title": "お支払い状況をご確認ください",
 		"pisell2.hdl-kiosk.payment-conflict-description": "再度支払わず、スタッフにお声がけください。",
 		"pisell2.hdl-kiosk.resetting-order": "次の注文を準備中…",
+		"pisell2.hdl-kiosk.retry-entry-preparation": "もう一度準備する",
 		"pisell2.hdl-kiosk.order-needs-attention": "前の操作が完了していません。注文を確認してから続けてください。",
 		"pisell2.hdl-kiosk.fulfillment-unavailable": "この端末では現在、飲食方法を保存できません。スタッフにお声がけください。",
 		"pisell2.hdl-kiosk.keep-ordering": "注文を続ける",
@@ -557,6 +567,8 @@ const localeTexts = {
 		"pisell2.hdl-kiosk.customization-unit-price": "単価",
 		"pisell2.hdl-kiosk.customization-per100g": "/100g",
 		"pisell2.hdl-kiosk.customization-next": "次へ",
+		"pisell2.hdl-kiosk.customization-required-options": "必須項目をすべて選択してください。",
+		"pisell2.hdl-kiosk.customization-required-group": (groupName) => `「${groupName}」の必須項目を選択してください。`,
 		"pisell2.hdl-kiosk.primary-product-prompt-eyebrow": "お会計前の確認",
 		"pisell2.hdl-kiosk.primary-product-prompt-title": "麻辣湯を1杯追加しますか？",
 		"pisell2.hdl-kiosk.primary-product-prompt-accept": "はい",
@@ -673,6 +685,7 @@ const localeTexts = {
 		"pisell2.hdl-kiosk.payment-conflict-title": "Confirme o estado do pagamento",
 		"pisell2.hdl-kiosk.payment-conflict-description": "Não pague novamente. Peça ajuda a um funcionário.",
 		"pisell2.hdl-kiosk.resetting-order": "A preparar o próximo pedido…",
+		"pisell2.hdl-kiosk.retry-entry-preparation": "Tentar preparar novamente",
 		"pisell2.hdl-kiosk.order-needs-attention": "A ação anterior não foi concluída. Verifique o pedido antes de continuar.",
 		"pisell2.hdl-kiosk.fulfillment-unavailable": "Este dispositivo ainda não consegue guardar a opção de consumo. Peça ajuda a um funcionário.",
 		"pisell2.hdl-kiosk.keep-ordering": "Continuar a pedir",
@@ -714,6 +727,8 @@ const localeTexts = {
 		"pisell2.hdl-kiosk.customization-unit-price": "Preço unitário",
 		"pisell2.hdl-kiosk.customization-per100g": "/100 g",
 		"pisell2.hdl-kiosk.customization-next": "Seguinte",
+		"pisell2.hdl-kiosk.customization-required-options": "Selecione uma opção em cada grupo obrigatório.",
+		"pisell2.hdl-kiosk.customization-required-group": (groupName) => `Selecione uma opção obrigatória em “${groupName}”.`,
 		"pisell2.hdl-kiosk.primary-product-prompt-eyebrow": "Antes de finalizar",
 		"pisell2.hdl-kiosk.primary-product-prompt-title": "Deseja adicionar uma tigela de Malatang?",
 		"pisell2.hdl-kiosk.primary-product-prompt-accept": "Sim",

package/es/components/HDLKiosk/runtime/entryPreparation.js

@@ -0,0 +1,48 @@
+import { _asyncToGenerator } from "../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/asyncToGenerator.js";
+import { createOperationError, operationUnknown } from "./operations/errors.js";
+//#region src/components/HDLKiosk/runtime/entryPreparation.ts
+function forwardFailure(result) {
+	return result;
+}
+/** Entry 首次展示或重新激活时，必须先证明 Host 已不存在上一笔购物车。 */
+function prepareHDLKioskEntry(_x, _x2) {
+	return _prepareHDLKioskEntry.apply(this, arguments);
+}
+function _prepareHDLKioskEntry() {
+	_prepareHDLKioskEntry = _asyncToGenerator(function* (host, signal) {
+		let result;
+		try {
+			const payment = host.sales.readTransactionState().payment;
+			if (payment.status === "pending" || payment.status === "unknown") result = operationUnknown("entryPreparationBlockedByPaymentState");
+			else if (signal.aborted) result = {
+				status: "cancelled",
+				reason: "entryPreparationAborted"
+			};
+			else {
+				const reset = yield host.sales.clearAndReset(signal);
+				if (reset.status !== "succeeded") result = forwardFailure(reset);
+				else if (!reset.data.cartEmpty) result = operationUnknown("entryPreparationHostResultNotEmpty");
+				else if (signal.aborted) result = {
+					status: "cancelled",
+					reason: "entryPreparationAborted"
+				};
+				else {
+					const consistency = yield host.sales.waitForCartConsistency(signal);
+					result = consistency.status === "succeeded" ? {
+						status: "succeeded",
+						data: void 0
+					} : forwardFailure(consistency);
+				}
+			}
+		} catch (cause) {
+			result = {
+				status: "failed",
+				error: createOperationError("entryPreparationUnhandled", "staff", cause)
+			};
+		}
+		return result;
+	});
+	return _prepareHDLKioskEntry.apply(this, arguments);
+}
+//#endregion
+export { prepareHDLKioskEntry };

package/es/components/HDLKiosk/runtime/session/createSession.js

@@ -61,9 +61,30 @@ function createHDLKioskWorkflowSession(entry, host, options = {}) {
 	let staffPaymentPending = false;
 	let staffPaymentConfirmed = false;
 	let staffPaymentRejected = false;
+	let staffPaymentObserved = false;
+	let staffPaymentAdvanceDispatched = false;
+	let lastStaffPaymentAdvanceDiagnostic = "";
 	let completedOrderFinalized = false;
 	let completedOrderFinalizePromise;
 	const staffPaymentReceipt = Object.freeze({ paymentConfirmed: true });
+	const emitStaffPaymentWorkflow = (phase, authorizationStatus, reason) => {
+		const snapshot = workflowActor.getSnapshot();
+		try {
+			host.telemetry.emit({
+				name: "hdlKiosk.staffPayment.workflow",
+				traceId: `${snapshot.workflowId}:${snapshot.sessionEpoch}:staff-payment`,
+				occurredAt: Date.now(),
+				attributes: _objectSpread2({
+					phase,
+					authorizationStatus,
+					workflowId: snapshot.workflowId,
+					sessionEpoch: snapshot.sessionEpoch,
+					nodeId: snapshot.nodeId,
+					workflowStatus: snapshot.status
+				}, reason ? { reason } : {})
+			});
+		} catch (_unused) {}
+	};
 	const dispatchConfirmedPayment = (receipt, intentId) => {
 		var _definition$nodes$sna;
 		const snapshot = workflowActor.getSnapshot();
@@ -79,8 +100,26 @@ function createHDLKioskWorkflowSession(entry, host, options = {}) {
 	};
 	const advanceConfirmedStaffPayment = () => {
 		var _definition$nodes$sna2;
+		if (!staffPaymentObserved || staffPaymentPending || staffPaymentAdvanceDispatched) return;
 		const snapshot = workflowActor.getSnapshot();
-		if (snapshot.status !== "idle" || ((_definition$nodes$sna2 = definition.nodes[snapshot.nodeId]) === null || _definition$nodes$sna2 === void 0 ? void 0 : _definition$nodes$sna2.activity) !== "paymentMethod" || staffPaymentRejected || staffPaymentPending && !staffPaymentConfirmed || !staffPaymentConfirmed) return;
+		if (staffPaymentRejected || !staffPaymentConfirmed) return;
+		const skipReason = snapshot.status !== "idle" ? "workflow-not-idle" : ((_definition$nodes$sna2 = definition.nodes[snapshot.nodeId]) === null || _definition$nodes$sna2 === void 0 ? void 0 : _definition$nodes$sna2.activity) !== "paymentMethod" ? "not-payment-method" : void 0;
+		if (skipReason) {
+			const diagnostic = [
+				snapshot.sessionEpoch,
+				snapshot.nodeId,
+				snapshot.status,
+				skipReason
+			].join(":");
+			if (diagnostic !== lastStaffPaymentAdvanceDiagnostic) {
+				lastStaffPaymentAdvanceDiagnostic = diagnostic;
+				emitStaffPaymentWorkflow("advanceSkipped", "succeeded", skipReason);
+			}
+			return;
+		}
+		staffPaymentAdvanceDispatched = true;
+		lastStaffPaymentAdvanceDiagnostic = `${snapshot.sessionEpoch}:advanced`;
+		emitStaffPaymentWorkflow("advanced", "succeeded");
 		dispatchConfirmedPayment(staffPaymentReceipt, `staff-payment:${snapshot.sessionEpoch}`);
 	};
 	const finalizeCompletedOrder = (intentId) => {
@@ -115,15 +154,20 @@ function createHDLKioskWorkflowSession(entry, host, options = {}) {
 	try {
 		unsubscribePaymentWorkflow = workflowActor.subscribe(handleWorkflowUpdate);
 		unsubscribeStaffPayment = host.sales.subscribeStaffPaymentAuthorizationResult((result) => {
+			staffPaymentObserved = true;
 			if (result.status === "pending") {
 				staffPaymentPending = true;
 				staffPaymentConfirmed = false;
 				staffPaymentRejected = false;
+				staffPaymentAdvanceDispatched = false;
+				lastStaffPaymentAdvanceDiagnostic = "";
+				emitStaffPaymentWorkflow("pending", result.status);
 				return;
 			}
 			staffPaymentPending = false;
 			staffPaymentConfirmed = result.status === "succeeded";
 			staffPaymentRejected = !staffPaymentConfirmed;
+			emitStaffPaymentWorkflow(staffPaymentConfirmed ? "confirmed" : "rejected", result.status);
 			if (staffPaymentConfirmed) coordinator.confirmPaymentSucceeded();
 			advanceConfirmedStaffPayment();
 		});
@@ -153,7 +197,7 @@ function createHDLKioskWorkflowSession(entry, host, options = {}) {
 				sessionEpoch: snapshot.sessionEpoch
 			}
 		});
-	} catch (_unused) {}
+	} catch (_unused2) {}
 	const disposeSession = () => {
 		if (disposed) return;
 		disposed = true;

package/es/components/HDLKiosk/slices/customization/Screen/index.js

@@ -1,5 +1,6 @@
 import { _objectSpread2 } from "../../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/objectSpread2.js";
 import { _asyncToGenerator } from "../../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/asyncToGenerator.js";
+import { resolveLocalizedText } from "../../../../../plus/salesSdk/utils/resolveLocalizedText.js";
 import { useHDLKioskBottomBar, useHDLKioskBottomBarController } from "../../../components/shell/HDLKioskBottomBarHost/index.js";
 import { HDLKioskOrderSummary } from "../../../components/shell/HDLKioskOrderSummary/index.js";
 import { createHDLKioskSkuValue } from "../../../components/common/HDLKioskSkuOptionsSelection/model.js";
@@ -9,6 +10,7 @@ import { useHDLScaleRuntime, useHDLScaleSnapshot } from "../../../ui/scale.js";
 import React, { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { STANDARD_WEIGHT_UNIT, formatAmount, getWeightUnitSymbol, locales } from "@pisell/utils";
 import Decimal from "decimal.js";
+import { useToast } from "@pisell/materials";
 //#region src/components/HDLKiosk/slices/customization/Screen/index.tsx
 /**
 * 文件角色：呈现主称重商品的本地重量与标准 SkuValue 草稿。
@@ -47,6 +49,22 @@ function formatMoney(value, currencySymbol) {
 	const amount = value.toDecimalPlaces(2).toNumber();
 	return String(formatAmount(amount, 2, currencySymbol || ""));
 }
+function resolveInvalidSkuGroupName(error, product) {
+	var _group$name;
+	if (!error || typeof error !== "object" || Array.isArray(error) || !product) return;
+	const firstInvalidGroupId = Object.keys(error)[0];
+	if (!firstInvalidGroupId) return void 0;
+	const source = product;
+	const group = [
+		"variant_group",
+		"option_group",
+		"bundle_group"
+	].flatMap((key) => Array.isArray(source[key]) ? source[key] : []).find((candidate) => {
+		var _candidate$id;
+		return String((_candidate$id = candidate === null || candidate === void 0 ? void 0 : candidate.id) !== null && _candidate$id !== void 0 ? _candidate$id : "") === firstInvalidGroupId;
+	});
+	return resolveLocalizedText((_group$name = group === null || group === void 0 ? void 0 : group.name) !== null && _group$name !== void 0 ? _group$name : group === null || group === void 0 ? void 0 : group.title) || void 0;
+}
 function resolveScaleMeasurement(scale, productFacts, minimumWeightKg) {
 	var _scale$grossWeightKg, _productFacts$fixedTa, _productFacts$fixedTa2;
 	const gross = new Decimal((_scale$grossWeightKg = scale.grossWeightKg) !== null && _scale$grossWeightKg !== void 0 ? _scale$grossWeightKg : NaN);
@@ -148,6 +166,7 @@ function ProductFallback() {
 }
 function CustomizationScreen({ product, loading, errorReference, errorMessage, busy, syncing, canGoBack, minimumWeightKg, orderBar, send }) {
 	var _productFacts$product, _orderBar$primaryLine, _orderBar$primaryLine2, _orderBar$primaryLine3, _orderBar$primaryLine4, _orderBar$primaryLine7, _productFacts$unitPri, _orderBar$primaryLine9, _orderBar$primaryLine11;
+	const Toast = useToast();
 	const scaleRuntime = useHDLScaleRuntime();
 	const scale = useHDLScaleSnapshot();
 	const skuOptionsRef = useRef(null);
@@ -187,7 +206,9 @@ function CustomizationScreen({ product, loading, errorReference, errorMessage, b
 		try {
 			var _skuOptionsRef$curren;
 			yield (_skuOptionsRef$curren = skuOptionsRef.current) === null || _skuOptionsRef$curren === void 0 ? void 0 : _skuOptionsRef$curren.validate();
-		} catch (_unused) {
+		} catch (error) {
+			const invalidGroupName = resolveInvalidSkuGroupName(error, product);
+			Toast.fail(invalidGroupName ? locales.getText("pisell2.hdl-kiosk.customization-required-group")(invalidGroupName) : locales.getText("pisell2.hdl-kiosk.customization-required-options"));
 			return;
 		}
 		const submittedSkuValue = (_skuOptionsRef$curren2 = (_skuOptionsRef$curren3 = skuOptionsRef.current) === null || _skuOptionsRef$curren3 === void 0 ? void 0 : _skuOptionsRef$curren3.getTransformValues()) !== null && _skuOptionsRef$curren2 !== void 0 ? _skuOptionsRef$curren2 : skuValue;
@@ -213,11 +234,13 @@ function CustomizationScreen({ product, loading, errorReference, errorMessage, b
 		busy,
 		minimumWeightKg,
 		(_orderBar$primaryLine9 = orderBar.primaryLine) === null || _orderBar$primaryLine9 === void 0 ? void 0 : _orderBar$primaryLine9.lineId,
+		product,
 		productFacts,
 		scaleRuntime,
 		skuValue,
 		send,
-		syncing
+		syncing,
+		Toast
 	]);
 	const omitPrimaryProduct = useCallback(() => {
 		var _orderBar$primaryLine10;

package/es/components/HDLKiosk/ui/controllers/useHDLKioskSessionController.js

@@ -1,43 +1,83 @@
 import { _asyncToGenerator } from "../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/asyncToGenerator.js";
 import "../../runtime/admissionPolicy.js";
 import { hdlKioskApplication } from "../../runtime/application.js";
-import { useCallback, useEffect, useMemo, useSyncExternalStore } from "react";
+import { prepareHDLKioskEntry } from "../../runtime/entryPreparation.js";
+import { useCallback, useEffect, useMemo, useState, useSyncExternalStore } from "react";
 //#region src/components/HDLKiosk/ui/controllers/useHDLKioskSessionController.ts
 /**
 * 文件角色：把 React Entry 状态适配到无头 Application Runtime。
-* 运行机制：Controller 只处理能力/可见性和 UI pending；Trigger 路由、Session 创建、
-* ensure、单会话准入与销毁均由 Runtime 持有。
+* 运行机制：Controller 先建立 Entry Host 清理屏障，再激活 Trigger；Session 创建、ensure、
+* 单会话准入与销毁均由 Runtime 持有。
 * 边界：不直接创建 Actor，也不消费具体 Screen 的局部交互。
 */
-function useHDLKioskSessionController({ host, config, isActive }) {
+function useHDLKioskSessionController({ host, config, isActive, entryPreparationBlocked = false }) {
 	const applicationRuntime = useMemo(() => hdlKioskApplication.bind({
 		host,
 		config
 	}), [config, host]);
 	const snapshot = useSyncExternalStore(applicationRuntime.subscribe, applicationRuntime.getSnapshot, applicationRuntime.getSnapshot);
+	const [entryPreparationAttempt, setEntryPreparationAttempt] = useState(0);
+	const [entryPreparation, setEntryPreparation] = useState(() => ({ status: isActive ? "preparing" : "inactive" }));
 	useEffect(() => {
 		return () => applicationRuntime.dispose();
 	}, [applicationRuntime]);
 	useEffect(() => {
 		if (!isActive) {
 			applicationRuntime.deactivate();
+			setEntryPreparation({ status: "inactive" });
 			return;
 		}
-		applicationRuntime.activate();
-		return () => applicationRuntime.deactivate();
-	}, [applicationRuntime, isActive]);
+		if (applicationRuntime.getSnapshot().session) {
+			applicationRuntime.activate();
+			setEntryPreparation({ status: "ready" });
+			return () => applicationRuntime.deactivate();
+		}
+		if (entryPreparationBlocked) {
+			applicationRuntime.deactivate();
+			setEntryPreparation({ status: "preparing" });
+			return () => applicationRuntime.deactivate();
+		}
+		applicationRuntime.deactivate();
+		setEntryPreparation({ status: "preparing" });
+		const abortController = new AbortController();
+		prepareHDLKioskEntry(host, abortController.signal).then((result) => {
+			if (abortController.signal.aborted) return;
+			if (result.status === "succeeded") {
+				setEntryPreparation({ status: "ready" });
+				applicationRuntime.activate();
+				return;
+			}
+			setEntryPreparation({
+				status: "failed",
+				errorReference: result.status === "failed" || result.status === "partialFailure" || result.status === "unknown" ? result.error.traceId : result.reason || "entryPreparationCancelled"
+			});
+		});
+		return () => {
+			abortController.abort();
+			applicationRuntime.deactivate();
+		};
+	}, [
+		applicationRuntime,
+		entryPreparationBlocked,
+		entryPreparationAttempt,
+		host,
+		isActive
+	]);
 	const start = useCallback(function() {
 		var _ref = _asyncToGenerator(function* ({ entry }) {
+			if (entryPreparation.status !== "ready") return void 0;
 			const result = yield applicationRuntime.start(entry);
 			return result.status === "started" || result.status === "duplicate" ? result.session : void 0;
 		});
 		return function(_x) {
 			return _ref.apply(this, arguments);
 		};
-	}(), [applicationRuntime]);
+	}(), [applicationRuntime, entryPreparation.status]);
 	return {
 		session: snapshot.session,
 		starting: snapshot.status === "starting",
+		preparingEntry: entryPreparation.status === "preparing",
+		entryPreparationErrorReference: entryPreparation.status === "failed" ? entryPreparation.errorReference : void 0,
 		startErrorReference: snapshot.startFailure ? typeof snapshot.startFailure.error === "object" && snapshot.startFailure.error !== null && "traceId" in snapshot.startFailure.error && typeof snapshot.startFailure.error.traceId === "string" ? snapshot.startFailure.error.traceId : snapshot.startFailure.reason : void 0,
 		exiting: snapshot.status === "exiting",
 		exitError: snapshot.exitError,
@@ -47,7 +87,8 @@ function useHDLKioskSessionController({ host, config, isActive }) {
 		requestExit: applicationRuntime.requestExit,
 		resolveExit: applicationRuntime.resolveExit,
 		completeOrder: applicationRuntime.completeOrder,
-		recover: applicationRuntime.recover
+		recover: applicationRuntime.recover,
+		retryEntryPreparation: () => setEntryPreparationAttempt((attempt) => attempt + 1)
 	};
 }
 //#endregion

package/es/components/HDLKiosk/ui/entry/Screen/index.js

@@ -177,7 +177,7 @@ function EntryGraphic({ entry }) {
 	if (entry === "barcode") return /* @__PURE__ */ React.createElement(BarcodeGraphic, null);
 	return /* @__PURE__ */ React.createElement(ScaleGraphic, null);
 }
-function EntryScreen({ locale, model, onLocaleChange, onTechnicalSupportClick, onSelect, busy = false, errorReference, errorMessage = "Unable to start a safe order session." }) {
+function EntryScreen({ locale, model, onLocaleChange, onTechnicalSupportClick, onSelect, busy = false, errorReference, errorMessage = "Unable to start a safe order session.", retryLabel, onRetry }) {
 	const [reachMode, setReachMode] = useState(false);
 	const entryLocale = locale || "en";
 	return /* @__PURE__ */ React.createElement("section", {
@@ -236,7 +236,10 @@ function EntryScreen({ locale, model, onLocaleChange, onTechnicalSupportClick, o
 	}, model.assistanceMessage) : null, errorReference ? /* @__PURE__ */ React.createElement("div", {
 		className: "hdl-inline-error hdl-entry-screen__error",
 		role: "alert"
-	}, /* @__PURE__ */ React.createElement("strong", null, errorMessage), /* @__PURE__ */ React.createElement("small", null, errorReference)) : null), /* @__PURE__ */ React.createElement("footer", { className: "hdl-entry-screen__utilities" }, /* @__PURE__ */ React.createElement("button", {
+	}, /* @__PURE__ */ React.createElement("strong", null, errorMessage), /* @__PURE__ */ React.createElement("small", null, errorReference), onRetry && retryLabel ? /* @__PURE__ */ React.createElement("button", {
+		type: "button",
+		onClick: onRetry
+	}, retryLabel) : null) : null), /* @__PURE__ */ React.createElement("footer", { className: "hdl-entry-screen__utilities" }, /* @__PURE__ */ React.createElement("button", {
 		className: `hdl-entry-reach${reachMode ? " is-active" : ""}`,
 		type: "button",
 		"aria-pressed": reachMode,

package/es/components/HDLKiosk/ui/entry/Screen/index.less

@@ -745,6 +745,16 @@
     color: rgba(255, 255, 255, 0.68);
   }
 
+  .hdl-entry-screen__error button {
+    align-self: flex-start;
+    border: 1px solid rgba(255, 255, 255, 0.45);
+    border-radius: 999px;
+    padding: 7px 14px;
+    background: rgba(255, 255, 255, 0.12);
+    color: #fff;
+    cursor: pointer;
+  }
+
   .hdl-entry-screen__utilities {
     position: absolute;
     right: 52px;

package/es/components/bigSale/templates/HDLKiosk/index.js

@@ -156,9 +156,11 @@ function HDLKioskBigSaleTemplate({ isActive = true, context, businessCode, local
 		renderCartContent,
 		cartOverlayActions
 	}), /* @__PURE__ */ React.createElement(HDLKioskPaymentRuntime, {
+		active: isActive,
 		context,
 		controllerRef: paymentControllerRef,
-		onPaymentResultChange: handlePaymentResultChange
+		onPaymentResultChange: handlePaymentResultChange,
+		telemetry: host.telemetry
 	}), orderNoteModal);
 }
 //#endregion