@pisell/private-materials 6.12.168 → 6.12.170

package/es/components/HDLKiosk/runtime/devices/scannerSessionRouter.js

@@ -0,0 +1,212 @@
+import { _asyncToGenerator } from "../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/asyncToGenerator.js";
+import { createScannerIngress } from "./scannerIngress.js";
+//#region src/components/HDLKiosk/runtime/devices/scannerSessionRouter.ts
+function createScannerSessionRouter({ host, entrySupported, maxPendingEvents = 5 }) {
+	const ingress = createScannerIngress({ maxPendingEvents });
+	let phase = "idle";
+	let activeStartId;
+	let listening = false;
+	let session;
+	let queue = [];
+	let currentTask;
+	let processing = false;
+	let generation = 0;
+	let rejectionSequence = 0;
+	const emitRejected = (task, reason) => {
+		rejectionSequence += 1;
+		try {
+			host.telemetry.emit({
+				name: "hdlKiosk.device.eventRejected",
+				traceId: `hdl-scanner-rejected-${rejectionSequence}`,
+				occurredAt: Date.now(),
+				attributes: {
+					eventType: task.event.type,
+					eventId: task.event.eventId,
+					reason
+				}
+			});
+		} catch (_unused) {}
+	};
+	const rejectQueue = (reason) => {
+		const rejected = queue;
+		queue = [];
+		rejected.forEach((task) => emitRejected(task, reason));
+	};
+	const emitCompleted = (task, target, result, stale) => {
+		try {
+			host.telemetry.emit({
+				name: "hdlKiosk.scanner.taskFinished",
+				traceId: `hdl-scan:${target.sessionEpoch()}:${task.event.eventId}`,
+				occurredAt: Date.now(),
+				attributes: {
+					eventId: task.event.eventId,
+					sessionEpoch: target.sessionEpoch(),
+					status: result.operationStatus,
+					stale
+				}
+			});
+		} catch (_unused2) {}
+	};
+	const processQueue = function() {
+		var _ref = _asyncToGenerator(function* () {
+			if (processing || phase !== "active" || !listening || !session) return;
+			processing = true;
+			const processGeneration = generation;
+			try {
+				while (phase === "active" && listening && generation === processGeneration && session && queue.length > 0) {
+					const target = session;
+					const task = queue.shift();
+					if (!task) continue;
+					const decision = target.decideConsume();
+					if (decision.status === "rejected") {
+						emitRejected(task, decision.reason);
+						continue;
+					}
+					let result;
+					try {
+						var _target$beforeConsume;
+						(_target$beforeConsume = target.beforeConsume) === null || _target$beforeConsume === void 0 || _target$beforeConsume.call(target);
+						currentTask = task;
+						result = yield target.consume({
+							eventId: task.event.eventId,
+							code: task.code
+						});
+					} catch (_unused3) {
+						currentTask = void 0;
+						emitRejected(task, "scanExecutionFailed");
+						rejectQueue("previousScanExecutionFailed");
+						break;
+					}
+					currentTask = void 0;
+					const stale = generation !== processGeneration || phase !== "active" || !listening || session !== target;
+					emitCompleted(task, target, result, stale);
+					if (stale) break;
+					if (result.queueDirective === "pauseForSelection") {
+						rejectQueue("barcodeSelectionPending");
+						break;
+					}
+					if (result.queueDirective === "stopUncertain") {
+						rejectQueue("previousScanResultUncertain");
+						break;
+					}
+				}
+			} finally {
+				currentTask = void 0;
+				processing = false;
+				if (phase === "active" && listening && queue.length > 0) processQueue();
+			}
+		});
+		return function processQueue() {
+			return _ref.apply(this, arguments);
+		};
+	}();
+	const beginSessionStart = (startId) => {
+		if (!startId.trim() || phase === "disposed" || phase === "active") return false;
+		if (phase === "starting") return activeStartId === startId;
+		phase = "starting";
+		activeStartId = startId;
+		return true;
+	};
+	const failSessionStart = (startId, reason = "sessionStartFailed") => {
+		if (phase !== "starting" || activeStartId !== startId) return false;
+		generation += 1;
+		rejectQueue(reason);
+		activeStartId = void 0;
+		session = void 0;
+		phase = "idle";
+		return true;
+	};
+	const triggerAdapter = Object.freeze({
+		trigger: "onScan",
+		activate: ({ emit }) => {
+			if (phase === "disposed") return void 0;
+			listening = true;
+			const unsubscribe = host.devices.subscribe((event) => {
+				if (!listening || phase === "disposed" || event.type !== "barcode") return;
+				const target = session;
+				const decision = target === null || target === void 0 ? void 0 : target.decideConsume();
+				const rejectedReason = (decision === null || decision === void 0 ? void 0 : decision.status) === "rejected" ? decision.reason : void 0;
+				const result = ingress.accept(event, {
+					active: listening,
+					supported: host.capabilities.scanner.available && (phase !== "idle" || entrySupported),
+					workflowLocked: false,
+					nodeAcceptsEvent: phase !== "active" || (decision === null || decision === void 0 ? void 0 : decision.status) === "accepted" || rejectedReason === "paymentFrozen",
+					paymentFrozen: phase === "active" && rejectedReason === "paymentFrozen",
+					pendingEventCount: queue.length + (currentTask ? 1 : 0)
+				});
+				if (result.status === "rejected") {
+					emitRejected({
+						event,
+						code: event.code
+					}, result.reason);
+					return;
+				}
+				const task = {
+					event: result.event,
+					code: result.code
+				};
+				queue.push(task);
+				if (phase === "active") {
+					processQueue();
+					return;
+				}
+				if (phase === "starting") return;
+				const startId = `device:scanner:${result.event.eventId}`;
+				if (!beginSessionStart(startId)) {
+					queue.pop();
+					emitRejected(task, "sessionStartConflict");
+					return;
+				}
+				emit({
+					channel: "product",
+					occurrenceId: result.event.eventId,
+					correlationId: startId
+				}).then((startResult) => {
+					if (startResult.status === "rejected") failSessionStart(startId, startResult.reason);
+				}).catch(() => failSessionStart(startId, "sessionStartFailed"));
+			}, { sources: ["scanner"] });
+			return () => {
+				listening = false;
+				generation += 1;
+				rejectQueue("inactive");
+				if (phase === "starting" && activeStartId) failSessionStart(activeStartId, "inactive");
+				unsubscribe();
+			};
+		}
+	});
+	return Object.freeze({
+		triggerAdapter,
+		beginSessionStart,
+		bindSession: (startId, nextSession) => {
+			if (phase !== "starting" || activeStartId !== startId) return false;
+			activeStartId = void 0;
+			session = nextSession;
+			phase = "active";
+			processQueue();
+			return true;
+		},
+		failSessionStart,
+		releaseSession: (sessionId) => {
+			if ((session === null || session === void 0 ? void 0 : session.id) !== sessionId) return false;
+			generation += 1;
+			rejectQueue("sessionDisposed");
+			activeStartId = void 0;
+			session = void 0;
+			phase = "idle";
+			ingress.reset();
+			return true;
+		},
+		dispose: () => {
+			if (phase === "disposed") return;
+			generation += 1;
+			rejectQueue("inactive");
+			activeStartId = void 0;
+			session = void 0;
+			listening = false;
+			phase = "disposed";
+			ingress.reset();
+		}
+	});
+}
+//#endregion
+export { createScannerSessionRouter };

package/es/components/HDLKiosk/runtime/operations/barcode.js

@@ -0,0 +1,18 @@
+import { _asyncToGenerator } from "../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/asyncToGenerator.js";
+import { barcodeConsumeOperation } from "../../app/operations.js";
+import { finalizeCartMutation } from "./cartConsistency.js";
+import { bindOperation } from "./types.js";
+//#region src/components/HDLKiosk/runtime/operations/barcode.ts
+const barcodeConsumeOperationBinding = bindOperation(barcodeConsumeOperation, { execute: function() {
+	var _ref = _asyncToGenerator(function* (context, input, signal) {
+		const beforeFingerprint = context.host.sales.getObservedSnapshot().fingerprint.value;
+		const mutation = yield context.host.sales.consumeBarcode(input.code, signal);
+		if (mutation.status === "succeeded" && mutation.data.code === "requiresSelection") return mutation;
+		return finalizeCartMutation(context, mutation, signal, () => mutation.status === "succeeded" && mutation.data.code === "added" && mutation.data.cartChangeConfirmed === true || context.host.sales.getObservedSnapshot().fingerprint.value !== beforeFingerprint);
+	});
+	return function execute(_x, _x2, _x3) {
+		return _ref.apply(this, arguments);
+	};
+}() });
+//#endregion
+export { barcodeConsumeOperationBinding };

package/es/components/HDLKiosk/runtime/operations/cart.js

@@ -0,0 +1,44 @@
+import { _asyncToGenerator } from "../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/asyncToGenerator.js";
+import { cartAddProductOperation, cartRemoveLineOperation, cartUpdateQuantityOperation } from "../../app/operations.js";
+import { finalizeCartMutation } from "./cartConsistency.js";
+import { bindOperation } from "./types.js";
+//#region src/components/HDLKiosk/runtime/operations/cart.ts
+const cartAddProductOperationBinding = bindOperation(cartAddProductOperation, { execute: function() {
+	var _ref = _asyncToGenerator(function* (context, input, signal) {
+		return finalizeCartMutation(context, yield context.host.sales.addProduct(input, signal), signal);
+	});
+	return function execute(_x, _x2, _x3) {
+		return _ref.apply(this, arguments);
+	};
+}() });
+const cartUpdateQuantityOperationBinding = bindOperation(cartUpdateQuantityOperation, { execute: function() {
+	var _ref2 = _asyncToGenerator(function* (context, input, signal) {
+		const mutation = yield context.host.sales.updateQuantity(input, signal);
+		return finalizeCartMutation(context, mutation, signal, () => {
+			var _mutation$data$confir;
+			if (mutation.status === "succeeded" && mutation.data.affectedLineId === input.lineId && ((_mutation$data$confir = mutation.data.confirmedLine) === null || _mutation$data$confir === void 0 ? void 0 : _mutation$data$confir.lineId) === input.lineId && decimalValuesEqual(mutation.data.confirmedLine.quantity, input.quantity)) return true;
+			const line = context.host.sales.getObservedSnapshot().cart.lines.find((item) => item.lineId === input.lineId);
+			return decimalValuesEqual(line === null || line === void 0 ? void 0 : line.quantity, input.quantity);
+		});
+	});
+	return function execute(_x4, _x5, _x6) {
+		return _ref2.apply(this, arguments);
+	};
+}() });
+function decimalValuesEqual(left, right) {
+	if (left === void 0) return false;
+	const leftNumber = Number(left);
+	const rightNumber = Number(right);
+	return Number.isFinite(leftNumber) && Number.isFinite(rightNumber) && leftNumber === rightNumber;
+}
+const cartRemoveLineOperationBinding = bindOperation(cartRemoveLineOperation, { execute: function() {
+	var _ref3 = _asyncToGenerator(function* (context, input, signal) {
+		const mutation = yield context.host.sales.removeLine(input, signal);
+		return finalizeCartMutation(context, mutation, signal, () => mutation.status === "succeeded" && mutation.data.removedLineId === input.lineId || !context.host.sales.getObservedSnapshot().cart.lines.some((item) => item.lineId === input.lineId));
+	});
+	return function execute(_x7, _x8, _x9) {
+		return _ref3.apply(this, arguments);
+	};
+}() });
+//#endregion
+export { cartAddProductOperationBinding, cartRemoveLineOperationBinding, cartUpdateQuantityOperationBinding };

package/es/components/HDLKiosk/{app → runtime}/operations/cartConsistency.js

@@ -1,6 +1,6 @@
 import { _asyncToGenerator } from "../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/asyncToGenerator.js";
 import { createOperationError, operationUnknown } from "./errors.js";
-//#region src/components/HDLKiosk/app/operations/cartConsistency.ts
+//#region src/components/HDLKiosk/runtime/operations/cartConsistency.ts
 function finalizeCartMutation(_x, _x2, _x3, _x4) {
 	return _finalizeCartMutation.apply(this, arguments);
 }

package/es/components/HDLKiosk/{app → runtime}/operations/checkout.js

@@ -1,11 +1,23 @@
+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 { checkoutOpenOperation, checkoutPayEftposOperation, checkoutPrepareOperation, checkoutRequestStaffPaymentApprovalOperation } from "../../app/operations.js";
 import { operationFailed, operationUnknown } from "./errors.js";
-import { defineOperation } from "./types.js";
+import { bindOperation } from "./types.js";
 import { defaultCheckoutRequirementRegistry } from "./checkoutRequirements.js";
-//#region src/components/HDLKiosk/app/operations/checkout.ts
+//#region src/components/HDLKiosk/runtime/operations/checkout.ts
 function forwardFailure(result) {
 	return result;
 }
+const PAYMENT_ALREADY_STARTED_ERRORS = new Set([
+	"checkoutPaymentAlreadySettled",
+	"checkoutPaymentAlreadyStarted",
+	"checkoutAlreadyStarted"
+]);
+/** 标记当前支付命令尚未进入 Host dispatch，供硬阻断策略安全放行。 */
+function forwardPreDispatchFailure(result) {
+	if ((result.status === "partialFailure" || result.status === "unknown") && !PAYMENT_ALREADY_STARTED_ERRORS.has(result.error.code)) return _objectSpread2(_objectSpread2({}, result), {}, { error: _objectSpread2(_objectSpread2({}, result.error), {}, { details: _objectSpread2(_objectSpread2({}, result.error.details), {}, { checkoutDispatched: false }) }) });
+	return result;
+}
 function evaluateCheckoutRequirements(context, sales) {
 	return defaultCheckoutRequirementRegistry.evaluate(context.checkoutRequirementIds, {
 		workflow: context.workflowContext,
@@ -98,123 +110,96 @@ function _ensureCheckoutPrepared() {
 	});
 	return _ensureCheckoutPrepared.apply(this, arguments);
 }
-const checkoutPrepareOperation = defineOperation({
-	id: "checkout.prepare",
-	conflictScope: "checkout",
-	timeoutMs: 2e4,
-	retry: "explicit-user",
-	execute: (context, _input, signal) => {
-		const fulfillment = context.workflowContext.fulfillment;
-		return prepareCheckout(context, signal, fulfillment ? { mode: fulfillment } : void 0);
-	}
-});
-const checkoutOpenOperation = defineOperation({
-	id: "checkout.open",
-	tags: ["checkout-dispatch"],
-	conflictScope: "checkout",
-	timeoutMs: 12e4,
-	retry: "never",
-	execute: function() {
-		var _ref = _asyncToGenerator(function* (context, _input, signal) {
-			const { host, checkoutSafety, sessionEpoch } = context;
-			const preparation = yield ensureCheckoutPrepared(context, signal);
-			if (preparation.status !== "succeeded") return forwardFailure(preparation);
-			const snapshot = host.sales.getObservedSnapshot();
-			const requirements = evaluateCheckoutRequirements(context, snapshot);
-			const validationFailure = requirementFailure(requirements);
-			if (validationFailure) return validationFailure;
-			const decision = checkoutSafety.beginOpen(snapshot, sessionEpoch, requirements.requirementIds);
-			if (decision.status === "rejected") return decision.reason === "checkoutAlreadyStarted" ? operationUnknown(decision.reason) : operationFailed(decision.reason, "back");
-			if (signal.aborted) {
-				const result = {
-					status: "cancelled",
-					reason: "checkoutAbortedBeforeDispatch"
-				};
-				checkoutSafety.settle(result);
-				return result;
-			}
-			let result;
-			try {
-				result = yield host.sales.openCheckout(signal);
-			} catch (error) {
-				result = operationUnknown("checkoutInvocationUnhandled", error);
-			}
+const checkoutPrepareOperationBinding = bindOperation(checkoutPrepareOperation, { execute: (context, _input, signal) => {
+	const fulfillment = context.workflowContext.fulfillment;
+	return prepareCheckout(context, signal, fulfillment ? { mode: fulfillment } : void 0);
+} });
+const checkoutOpenOperationBinding = bindOperation(checkoutOpenOperation, { execute: function() {
+	var _ref = _asyncToGenerator(function* (context, _input, signal) {
+		const { host, checkoutSafety, sessionEpoch } = context;
+		const preparation = yield ensureCheckoutPrepared(context, signal);
+		if (preparation.status !== "succeeded") return forwardPreDispatchFailure(preparation);
+		const snapshot = host.sales.getObservedSnapshot();
+		const requirements = evaluateCheckoutRequirements(context, snapshot);
+		const validationFailure = requirementFailure(requirements);
+		if (validationFailure) return validationFailure;
+		const decision = checkoutSafety.beginOpen(snapshot, sessionEpoch, requirements.requirementIds);
+		if (decision.status === "rejected") return decision.reason === "checkoutAlreadyStarted" ? operationUnknown(decision.reason) : operationFailed(decision.reason, "back");
+		if (signal.aborted) {
+			const result = {
+				status: "cancelled",
+				reason: "checkoutAbortedBeforeDispatch"
+			};
 			checkoutSafety.settle(result);
 			return result;
-		});
-		return function execute(_x8, _x9, _x10) {
-			return _ref.apply(this, arguments);
-		};
-	}()
-});
+		}
+		let result;
+		try {
+			result = yield host.sales.openCheckout(signal);
+		} catch (error) {
+			result = operationUnknown("checkoutInvocationUnhandled", error);
+		}
+		checkoutSafety.settle(result);
+		return result;
+	});
+	return function execute(_x8, _x9, _x10) {
+		return _ref.apply(this, arguments);
+	};
+}() });
 /** Kiosk EFTPOS 直连入口：Host 只能调用嵌入式 PaymentMethodRuntime。 */
-const checkoutPayEftposOperation = defineOperation({
-	id: "checkout.payEftpos",
-	tags: ["checkout-dispatch"],
-	conflictScope: "checkout",
-	timeoutMs: 12e4,
-	retry: "never",
-	execute: function() {
-		var _ref2 = _asyncToGenerator(function* (context, input, signal) {
-			const { host, checkoutSafety, sessionEpoch } = context;
-			const preparation = yield ensureCheckoutPrepared(context, signal);
-			if (preparation.status !== "succeeded") return forwardFailure(preparation);
-			const snapshot = host.sales.getObservedSnapshot();
-			const requirements = evaluateCheckoutRequirements(context, snapshot);
-			const validationFailure = requirementFailure(requirements);
-			if (validationFailure) return validationFailure;
-			const decision = checkoutSafety.beginOpen(snapshot, sessionEpoch, requirements.requirementIds);
-			if (decision.status === "rejected") return decision.reason === "checkoutAlreadyStarted" ? operationUnknown(decision.reason) : operationFailed(decision.reason, "back");
-			if (signal.aborted) {
-				const result = {
-					status: "cancelled",
-					reason: "checkoutAbortedBeforeDispatch"
-				};
-				checkoutSafety.settle(result);
-				return result;
-			}
-			let result;
-			try {
-				result = yield host.sales.payEftpos(input, signal);
-			} catch (error) {
-				result = operationUnknown("checkoutInvocationUnhandled", error);
-			}
-			if (result.status === "succeeded" && !(yield waitForPaymentProjection(context, signal))) result = operationUnknown("checkoutPaymentProjectionNotConfirmed");
+const checkoutPayEftposOperationBinding = bindOperation(checkoutPayEftposOperation, { execute: function() {
+	var _ref2 = _asyncToGenerator(function* (context, input, signal) {
+		const { host, checkoutSafety, sessionEpoch } = context;
+		const preparation = yield ensureCheckoutPrepared(context, signal);
+		if (preparation.status !== "succeeded") return forwardPreDispatchFailure(preparation);
+		const snapshot = host.sales.getObservedSnapshot();
+		const requirements = evaluateCheckoutRequirements(context, snapshot);
+		const validationFailure = requirementFailure(requirements);
+		if (validationFailure) return validationFailure;
+		const decision = checkoutSafety.beginOpen(snapshot, sessionEpoch, requirements.requirementIds);
+		if (decision.status === "rejected") return decision.reason === "checkoutAlreadyStarted" ? operationUnknown(decision.reason) : operationFailed(decision.reason, "back");
+		if (signal.aborted) {
+			const result = {
+				status: "cancelled",
+				reason: "checkoutAbortedBeforeDispatch"
+			};
 			checkoutSafety.settle(result);
 			return result;
-		});
-		return function execute(_x11, _x12, _x13) {
-			return _ref2.apply(this, arguments);
-		};
-	}()
-});
+		}
+		let result;
+		try {
+			result = yield host.sales.payEftpos(input, signal);
+		} catch (error) {
+			result = operationUnknown("checkoutInvocationUnhandled", error);
+		}
+		if (result.status === "succeeded" && !(yield waitForPaymentProjection(context, signal))) result = operationUnknown("checkoutPaymentProjectionNotConfirmed");
+		checkoutSafety.settle(result);
+		return result;
+	});
+	return function execute(_x11, _x12, _x13) {
+		return _ref2.apply(this, arguments);
+	};
+}() });
 /** 店员付款只请求主屏授权；授权派发绝不视作付款成功。 */
-const checkoutRequestStaffPaymentApprovalOperation = defineOperation({
-	id: "checkout.requestStaffPaymentApproval",
-	tags: ["checkout-authorization"],
-	conflictScope: "checkout",
-	timeoutMs: 2e4,
-	retry: "explicit-user",
-	execute: function() {
-		var _ref3 = _asyncToGenerator(function* (context, input, signal) {
-			const preparation = yield ensureCheckoutPrepared(context, signal);
-			if (preparation.status !== "succeeded") return forwardFailure(preparation);
-			const validationFailure = requirementFailure(evaluateCheckoutRequirements(context, context.host.sales.getObservedSnapshot()));
-			if (validationFailure) return validationFailure;
-			if (signal.aborted) return {
-				status: "cancelled",
-				reason: "authorizationAborted"
-			};
-			return context.host.sales.requestStaffPaymentApproval(input, signal);
-		});
-		return function execute(_x14, _x15, _x16) {
-			return _ref3.apply(this, arguments);
+const checkoutRequestStaffPaymentApprovalOperationBinding = bindOperation(checkoutRequestStaffPaymentApprovalOperation, { execute: function() {
+	var _ref3 = _asyncToGenerator(function* (context, input, signal) {
+		const preparation = yield ensureCheckoutPrepared(context, signal);
+		if (preparation.status !== "succeeded") return forwardFailure(preparation);
+		const validationFailure = requirementFailure(evaluateCheckoutRequirements(context, context.host.sales.getObservedSnapshot()));
+		if (validationFailure) return validationFailure;
+		if (signal.aborted) return {
+			status: "cancelled",
+			reason: "authorizationAborted"
 		};
-	}()
-});
+		return context.host.sales.requestStaffPaymentApproval(input, signal);
+	});
+	return function execute(_x14, _x15, _x16) {
+		return _ref3.apply(this, arguments);
+	};
+}() });
 const MONEY = /^(?:0|[1-9]\d*)(?:\.\d+)?$/;
 function isSafeMoney(value) {
 	return MONEY.test(value) && Number.isFinite(Number(value));
 }
 //#endregion
-export { checkoutOpenOperation, checkoutPayEftposOperation, checkoutPrepareOperation, checkoutRequestStaffPaymentApprovalOperation };
+export { checkoutOpenOperationBinding, checkoutPayEftposOperationBinding, checkoutPrepareOperationBinding, checkoutRequestStaffPaymentApprovalOperationBinding };

package/es/components/HDLKiosk/{app → runtime}/operations/checkoutRequirements.js

@@ -1,5 +1,5 @@
 import { _objectSpread2 } from "../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/objectSpread2.js";
-//#region src/components/HDLKiosk/app/operations/checkoutRequirements.ts
+//#region src/components/HDLKiosk/runtime/operations/checkoutRequirements.ts
 function createCheckoutRequirementRegistry(definitions) {
 	const byId = /* @__PURE__ */ new Map();
 	definitions.forEach((definition) => {

package/es/components/HDLKiosk/{app → runtime}/operations/checkoutSafety.js

@@ -1,5 +1,5 @@
 import { _objectSpread2 } from "../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/objectSpread2.js";
-//#region src/components/HDLKiosk/app/operations/checkoutSafety.ts
+//#region src/components/HDLKiosk/runtime/operations/checkoutSafety.ts
 const DEFAULT_TOKEN_TTL_MS = 3e4;
 function createCheckoutSafetyController({ tokenTtlMs = DEFAULT_TOKEN_TTL_MS, now = Date.now } = {}) {
 	if (!Number.isFinite(tokenTtlMs) || tokenTtlMs <= 0) throw new Error("HDLKiosk checkout token TTL must be positive");

package/es/components/HDLKiosk/{app → runtime}/operations/coordinator.js

@@ -1,8 +1,8 @@
 import { _objectSpread2 } from "../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/objectSpread2.js";
-import { operationFailed, operationUnknown } from "./errors.js";
 import { createKernelOperationCoordinator } from "../../kernel/operations/coordinator.js";
+import { operationFailed, operationUnknown } from "./errors.js";
 import { createCheckoutSafetyController } from "./checkoutSafety.js";
-//#region src/components/HDLKiosk/app/operations/coordinator.ts
+//#region src/components/HDLKiosk/runtime/operations/coordinator.ts
 function conflicts(left, right) {
 	if (left === "none" || right === "none") return false;
 	if (left === "session" || right === "session") return true;

package/es/components/HDLKiosk/runtime/operations/customization.js

@@ -0,0 +1,70 @@
+import { _asyncToGenerator } from "../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/asyncToGenerator.js";
+import { canonicalizeSkuValue, createSkuValueFingerprint } from "../../../../plus/skuOptionsSelection/utils/canonicalSkuValue.js";
+import { productRemovePrimaryProductOperation, productSyncPrimaryWeightedProductOperation } from "../../app/operations.js";
+import { operationFailed } from "./errors.js";
+import { finalizeCartMutation } from "./cartConsistency.js";
+import { bindOperation } from "./types.js";
+import Decimal from "decimal.js";
+//#region src/components/HDLKiosk/runtime/operations/customization.ts
+/**
+* 文件角色：在 Customization Next 边界提交称重主商品本地草稿。
+* 运行机制：校验稳定净重/必选项，调用 Host/OS 主商品 writer，再验证目标行、重量、
+* SkuValue 和“新增或原行发生变化”的最小 receipt/Projection 事实。
+* 边界：页面输入变化不调用本 Operation；OS 内部的加购弹窗与业务判断不属于 HDLKiosk。
+*/
+const productRemovePrimaryProductOperationBinding = bindOperation(productRemovePrimaryProductOperation, { execute: function() {
+	var _ref = _asyncToGenerator(function* (context, input, signal) {
+		if (!input.lineId) return {
+			status: "succeeded",
+			data: {}
+		};
+		const mutation = yield context.host.sales.removeLine({ lineId: input.lineId }, signal);
+		return finalizeCartMutation(context, mutation, signal, () => mutation.status === "succeeded" && mutation.data.removedLineId === input.lineId || !context.host.sales.getObservedSnapshot().cart.lines.some((item) => item.lineId === input.lineId));
+	});
+	return function execute(_x, _x2, _x3) {
+		return _ref.apply(this, arguments);
+	};
+}() });
+function hasValidSkuValue(input) {
+	const canonical = canonicalizeSkuValue(input.skuValue);
+	return Boolean(input.productId && canonical && canonical.productId === input.productId);
+}
+function sameSkuValue(expected, actual) {
+	const expectedFingerprint = createSkuValueFingerprint(expected);
+	return Boolean(expectedFingerprint && expectedFingerprint === createSkuValueFingerprint(actual));
+}
+function sameWeight(actual, expected) {
+	const actualValue = new Decimal(actual || NaN);
+	const expectedValue = new Decimal(expected || NaN);
+	return actualValue.isFinite() && expectedValue.isFinite() && actualValue.equals(expectedValue);
+}
+const productSyncPrimaryWeightedProductOperationBinding = bindOperation(productSyncPrimaryWeightedProductOperation, { execute: function() {
+	var _ref2 = _asyncToGenerator(function* (context, input, signal) {
+		if (!hasValidSkuValue(input)) return operationFailed("customizationInputInvalid", "back");
+		const beforeLines = new Map(context.host.sales.getObservedSnapshot().cart.lines.map((line) => [line.lineId, line.quantity]));
+		const before = context.host.sales.getObservedSnapshot();
+		const previousPrimary = input.existingLineId ? before.cart.lines.find((line) => line.lineId === input.existingLineId) : void 0;
+		if (input.existingLineId && (!previousPrimary || previousPrimary.productId !== input.productId)) return operationFailed("customizationExistingLineInvalid", "back");
+		const mutation = yield context.host.sales.syncPrimaryWeightedProduct(input, signal);
+		return finalizeCartMutation(context, mutation, signal, () => {
+			const after = context.host.sales.getObservedSnapshot();
+			const projectionMatches = after.cart.lines.some((line) => {
+				if (mutation.status === "succeeded" && mutation.data.affectedLineId && line.lineId !== mutation.data.affectedLineId) return false;
+				if (line.productId !== input.productId) return false;
+				const skuMatches = sameSkuValue(input.skuValue, line.skuValue);
+				const weightMatches = sameWeight(line.quantity, input.measurement.netWeightKg);
+				const previousQuantity = beforeLines.get(line.lineId);
+				if (input.existingLineId) return line.lineId === input.existingLineId && skuMatches && weightMatches && mutation.status === "succeeded" && mutation.data.affectedLineId === input.existingLineId && after.observationId > before.observationId;
+				return skuMatches && weightMatches && (previousQuantity === void 0 || previousQuantity !== line.quantity);
+			});
+			const successfulOutcome = mutation.status === "succeeded" ? mutation.data : void 0;
+			const confirmedLine = successfulOutcome === null || successfulOutcome === void 0 ? void 0 : successfulOutcome.confirmedLine;
+			return Boolean(confirmedLine && confirmedLine.productId === input.productId && (!(successfulOutcome === null || successfulOutcome === void 0 ? void 0 : successfulOutcome.affectedLineId) || confirmedLine.lineId === successfulOutcome.affectedLineId) && (!input.existingLineId || (successfulOutcome === null || successfulOutcome === void 0 ? void 0 : successfulOutcome.affectedLineId) === input.existingLineId && confirmedLine.lineId === input.existingLineId) && sameWeight(confirmedLine.quantity, input.measurement.netWeightKg) && sameSkuValue(input.skuValue, confirmedLine.skuValue) && (Boolean(input.existingLineId) || !beforeLines.has(confirmedLine.lineId) || beforeLines.get(confirmedLine.lineId) !== confirmedLine.quantity)) || projectionMatches;
+		});
+	});
+	return function execute(_x4, _x5, _x6) {
+		return _ref2.apply(this, arguments);
+	};
+}() });
+//#endregion
+export { productRemovePrimaryProductOperationBinding, productSyncPrimaryWeightedProductOperationBinding };

package/es/components/HDLKiosk/{app → runtime}/operations/errors.js

@@ -1,4 +1,4 @@
-//#region src/components/HDLKiosk/app/operations/errors.ts
+//#region src/components/HDLKiosk/runtime/operations/errors.ts
 let errorSequence = 0;
 function createOperationError(code, recovery, cause) {
 	errorSequence += 1;

package/es/components/HDLKiosk/runtime/operations/fulfillment.js

@@ -0,0 +1,6 @@
+import { setFulfillmentOperation } from "../../app/operations.js";
+import { bindOperation } from "./types.js";
+//#region src/components/HDLKiosk/runtime/operations/fulfillment.ts
+const setFulfillmentOperationBinding = bindOperation(setFulfillmentOperation, { execute: (context, input, signal) => context.host.sales.setFulfillment(input, signal) });
+//#endregion
+export { setFulfillmentOperationBinding };