@fire-spark/core 0.3.1 → 0.3.3

package/dist/index.js

@@ -1,4 +1,4 @@
-import { DIGITAL_COLLECT_AT, PARTIAL_APPROVAL_ERROR, activeIntent, amountTolerance, createAttemptReference, createPaymentError, currencyDecimals, currentIntent, defaultReversalFor, groupPaymentRedeems, isDeliveryFee, isPaymentError, isRealPaymentMethod, isRealPaymentMethod as isRealPaymentMethod$1, isTenderSettled, isTipFee, liveTenders, memoryPaymentStorage, missingDeviceFields, resolvePaymentPolicy, resolveProviderEnvironment, roundTo, scopedPaymentStorage, taxBreakdown, toChargeAmount, withTerminalLock } from "@fire-spark/payments";
+import { DIGITAL_COLLECT_AT, PARTIAL_APPROVAL_ERROR, activeIntent, amountTolerance, createAttemptReference, createPaymentError, currencyDecimals, currentIntent, defaultReversalFor, discountRedeems, groupPaymentRedeems, isDeliveryFee, isPaymentError, isPaymentRedeem, isRealPaymentMethod, isRealPaymentMethod as isRealPaymentMethod$1, isTenderSettled, isTipFee, liveTenders, memoryPaymentStorage, missingDeviceFields, paymentRedeemsCoverTotal, resolvePaymentPolicy, resolveProviderEnvironment, roundTo, scopedPaymentStorage, taxBreakdown, toChargeAmount, withTerminalLock } from "@fire-spark/payments";
 import advancedFormat from "dayjs/plugin/advancedFormat.js";
 import isBetween from "dayjs/plugin/isBetween.js";
 import isSameOrAfter from "dayjs/plugin/isSameOrAfter.js";
@@ -2605,6 +2605,15 @@ const reorderOrder = (id, body = {}, options) => {
 		body: JSON.stringify(body)
 	}, options);
 };
+/**
+* `POST /storefront/v1/orders/:id/reopen`: voids every payment of a placed,
+* unpaid order, cancels it (`VOIDED`) and returns the new `OPEN` order with
+* the same content. Rejects with `StorefrontHttpError` 400
+* (`details.code: "ORDER_PAYMENT_CAPTURED"`) when a payment was captured.
+*/
+const reopenOrder = (id, options) => {
+	return storefrontJson(`${orderPath(id)}/reopen`, { method: "POST" }, options);
+};
 const parseValidationDetails = (body) => {
 	if (!body || typeof body !== "object") return null;
 	const details = body.details;
@@ -2940,6 +2949,7 @@ const services = {
 		cancel: cancelOrder,
 		refund: refundOrder,
 		reorder: reorderOrder,
+		reopen: reopenOrder,
 		validate: validateOrder,
 		place: placeOrder,
 		recordPayment: recordOrderPayment,
@@ -3441,1027 +3451,598 @@ const emptyLines = () => {
 	return [];
 };
 //#endregion
-//#region src/order/totals.ts
-/** Sum root line group totals into order totals (Big.js). */
-const recomputeTotals = (lines, currency = "USD") => {
-	let subtotal = new Big(0);
-	let discountTotal = new Big(0);
-	let taxTotal = new Big(0);
-	let total = new Big(0);
-	for (const line of lines) {
-		if (line.parent_uid != null) continue;
-		subtotal = subtotal.plus(line.group_subtotal);
-		discountTotal = discountTotal.plus(line.group_discount);
-		taxTotal = taxTotal.plus(line.group_tax_total);
-		total = total.plus(line.group_total);
-	}
-	let taxRate = 0;
-	let discountRate = 0;
-	if (subtotal.gt(0)) {
-		taxRate = taxTotal.div(subtotal).toNumber();
-		discountRate = discountTotal.div(subtotal).toNumber();
-	}
-	const discount_total = discountTotal.toNumber();
-	const tax_total = taxTotal.toNumber();
-	const b1 = {
-		currency,
-		subtotal: subtotal.toNumber()
-	};
-	const b2 = {
-		discount_rate: discountRate,
-		discount_total
-	};
-	const b3 = {
-		tax_rate: taxRate,
-		tax_total,
-		total: total.toNumber()
-	};
-	return {
-		...b1,
-		...b2,
-		...b3
-	};
+//#region src/order/tenders.ts
+/** Catalog provider of `REDEMPTION` payments (§3.3). */
+const DEFAULT_REDEMPTION_PROVIDER = "firespark";
+/**
+* Digital tender the SDK charges (`DEVICE`, §7.3). `KIOSK`, `COUNTER`,
+* `DOOR` and `OTHER` are in person: the POS, an operator or the courier
+* collects them (§12).
+*/
+const isDeviceCharged = (tender) => {
+	return DIGITAL_COLLECT_AT.includes(tender.collect_at);
 };
-const emptyTotals = (currency = "USD") => {
-	const b1 = {
-		currency,
-		subtotal: 0,
-		discount_rate: 0,
-		discount_total: 0
-	};
-	const b2 = {
-		tax_rate: 0,
-		tax_total: 0,
-		total: 0
-	};
-	return {
-		...b1,
-		...b2
-	};
+/** Most a REDEMPTION can cover: order total − tip − delivery (D18). */
+const redemptionCap = (order) => {
+	const primaryOnly = order.lines.filter((line) => line.parent_uid == null).reduce((sum, line) => {
+		return isTipFee(line) || isDeliveryFee(line) ? sum + line.group_total : sum;
+	}, 0);
+	const decimals = currencyDecimals(order.totals.currency);
+	return Math.max(roundTo(order.totals.total - primaryOnly, decimals), 0);
 };
-//#endregion
-//#region src/order/redemptions.ts
-const ORDER_KEY = "ORDER";
-/** Points / balance paid with a REDEMPTION tender, not a discount (D16). */
-const isPaymentRedeem = (redeem) => {
-	return Boolean(redeem.payment_id);
+/**
+* Trims payment redeems in application order so their sum fits the cap;
+* points shrink in proportion. Discount redeems are left untouched.
+*/
+const clampPaymentRedeems = (redeem, cap, currency) => {
+	const decimals = currencyDecimals(currency);
+	let left = cap;
+	return redeem.flatMap((item) => {
+		if (!isPaymentRedeem(item)) return [item];
+		const amount = item.amount ?? 0;
+		const fits = Math.max(roundTo(Math.min(amount, left), decimals), 0);
+		left = roundTo(left - fits, decimals);
+		if (fits <= 0) return [];
+		if (fits + amountTolerance(currency) >= amount) return [item];
+		const ratio = amount > 0 ? fits / amount : 0;
+		const points = roundTo((item.points ?? 0) * ratio, 0);
+		return [{
+			...item,
+			amount: fits,
+			points
+		}];
+	});
 };
-const buildPaymentRedeem = (input) => {
-	const { reward_id, quantity, payment_id, amount, points } = input;
-	if (amount === void 0 || !(amount > 0)) throw new Error("Redeem with payment_id requires amount > 0");
-	if (points === void 0 || !(points >= 0)) throw new Error("Redeem with payment_id requires points ≥ 0");
-	const redeem = {
-		reward_id,
-		quantity,
-		payment_id,
-		amount
-	};
-	redeem.points = points;
-	if (input.program !== void 0) redeem.program = input.program;
-	if (input.expires_at !== void 0) redeem.expires_at = input.expires_at;
-	return redeem;
+/**
+* One REDEMPTION tender per `payment_id` of the payment redeems (D15,
+* D19); its `details.rewards[]` lists every grouped redeem.
+*/
+const redemptionTenderInputs = (redeem, providers = /* @__PURE__ */ new Map()) => {
+	return groupPaymentRedeems(redeem).map(({ payment_id, details }) => {
+		const fallback = DEFAULT_REDEMPTION_PROVIDER;
+		const t1 = {
+			method: "REDEMPTION",
+			provider: providers.get(payment_id) ?? fallback,
+			payment_id
+		};
+		const t2 = {
+			collect_at: "OTHER",
+			allocation: null,
+			details
+		};
+		return {
+			...t1,
+			...t2
+		};
+	});
 };
-/** Same rules as `vOrders.redeem()`; throws on invalid input. */
-const buildRedeem = (input) => {
-	const { reward_id, quantity, discount_rate, discount_amount } = input;
-	const { before_taxes, expires_at } = input;
-	if (!reward_id.trim()) throw new Error("Redeem requires reward_id");
-	if (!Number.isInteger(quantity) || quantity < 1) throw new Error("Redeem quantity must be an integer ≥ 1");
-	if (expires_at !== void 0 && Number.isNaN(Date.parse(expires_at))) throw new Error("Redeem expires_at must be an ISO datetime");
-	if (input.payment_id) return buildPaymentRedeem(input);
-	if (discount_rate === void 0 && discount_amount === void 0) throw new Error("Redeem requires discount_rate or discount_amount");
-	const rate = discount_rate ?? 0;
-	if (!(rate >= 0 && rate <= 1)) throw new Error("Redeem discount_rate must be between 0 and 1");
-	if (discount_amount !== void 0 && !(discount_amount > 0)) throw new Error("Redeem discount_amount must be > 0");
-	const redeem = {
-		reward_id,
-		quantity
+/** The one real tender of the simple flow (`allocation: null`). */
+const simpleTenderInput = (payment) => {
+	if (!payment.type || !payment.provider) return null;
+	if (!isRealPaymentMethod(payment.type)) return null;
+	const collect_at = payment.collect_at ?? "DEVICE";
+	const t1 = {
+		method: payment.type,
+		provider: payment.provider
 	};
-	if (discount_rate !== void 0) redeem.discount_rate = discount_rate;
-	if (discount_amount !== void 0) redeem.discount_amount = discount_amount;
-	if (before_taxes !== void 0) redeem.before_taxes = before_taxes;
-	if (expires_at !== void 0) redeem.expires_at = expires_at;
-	return redeem;
-};
-/** Payment redeems hold totals, so the kept units keep their share. */
-const keepUnits = (item, rest) => {
-	if (!isPaymentRedeem(item) || rest === item.quantity) return {
-		...item,
-		quantity: rest
+	const t2 = {
+		payment_id: payment.id,
+		collect_at,
+		allocation: null
 	};
-	const ratio = new Big(rest).div(item.quantity);
-	const amount = new Big(item.amount ?? 0).times(ratio).round(6).toNumber();
-	const points = new Big(item.points ?? 0).times(ratio).round(0).toNumber();
 	return {
-		...item,
-		quantity: rest,
-		amount,
-		points
+		...t1,
+		...t2
 	};
 };
 /**
-* Takes `quantity` units of `reward_id` off the latest entries first, so the
-* earlier redeems keep their step position. Entries that reach 0 are removed.
+* Charge order of §6.1: deferred capture (authorize only), immediate
+* capture reversible with cancel/refund, manual reversal only, then cash /
+* IDLE last.
 */
-const subtractRedeem = (items, reward_id, quantity) => {
-	if (!Number.isInteger(quantity) || quantity < 1) throw new Error("Redeem quantity must be an integer ≥ 1");
-	let pending = quantity;
-	const kept = [];
-	for (let i = items.length - 1; i >= 0; i--) {
-		const item = items[i];
-		if (pending === 0 || item.reward_id !== reward_id) {
-			kept.unshift(item);
-			continue;
-		}
-		const taken = Math.min(item.quantity, pending);
-		pending -= taken;
-		const rest = item.quantity - taken;
-		if (rest > 0) kept.unshift(keepUnits(item, rest));
-	}
-	return kept;
+const chargeRank = (tender, adapter) => {
+	if (tender.method === "CASH") return 3;
+	if (adapter.capabilities?.deferredCapture) return 0;
+	if (adapter.cancel || adapter.refund) return 1;
+	return 2;
 };
-const redemptionTargetKey = (target) => {
-	if (target.target === "ORDER") return ORDER_KEY;
-	return `LINE:${target.target_id ?? ""}`;
+//#endregion
+//#region src/order/payments/orchestrator.ts
+const AMBIGUOUS_QUERIES = 3;
+const defaultSleep = (ms, signal) => {
+	return new Promise((resolve) => {
+		const timer = setTimeout(resolve, ms);
+		signal?.addEventListener("abort", () => {
+			clearTimeout(timer);
+			resolve();
+		});
+	});
 };
-/** Only root lines own redeems; child-line redeems are never applied. */
-const redeemPools = (lines, redeem) => {
-	const pools = /* @__PURE__ */ new Map();
-	for (const line of lines) {
-		const items = line.redeem ?? [];
-		if (line.parent_uid != null || items.length === 0) continue;
-		const target = {
-			target: "LINE",
-			target_id: line.uid
-		};
-		const pool = items.map((item) => ({
-			...target,
-			redeem: item
-		}));
-		pools.set(redemptionTargetKey(target), pool);
-	}
-	const order = { target: "ORDER" };
-	const pool = redeem.filter((item) => !isPaymentRedeem(item)).map((item) => ({
-		...order,
-		redeem: item
-	}));
-	pools.set(ORDER_KEY, pool);
-	return pools;
+const defaultClock = {
+	now: () => Date.now(),
+	sleep: defaultSleep
 };
+var TimeoutSignal = class extends Error {};
 /**
-* Pairs the k-th step of a target with the k-th redeem of that target, in
-* step order. Steps without a matching redeem are dropped; redeems without a
-* step are appended (lines first, then order).
+* Provider deadline that pauses while the customer is answering `ctx.ui`;
+* user waits run on `interaction_timeout_ms` instead.
 */
-const sequenceRedeems = (lines, redeem, steps) => {
-	const pools = redeemPools(lines, redeem);
-	const cursors = /* @__PURE__ */ new Map();
-	const sequence = [];
-	for (const step of steps) {
-		const key = redemptionTargetKey(step);
-		const at = cursors.get(key) ?? 0;
-		const next = pools.get(key)?.[at];
-		if (!next || next.redeem.reward_id !== step.reward_id) continue;
-		cursors.set(key, at + 1);
-		sequence.push(next);
-	}
-	for (const [key, pool] of pools) sequence.push(...pool.slice(cursors.get(key) ?? 0));
-	return sequence;
+const createDeadline = (timeoutMs, onExpire) => {
+	let remaining = timeoutMs;
+	let startedAt = 0;
+	let timer = null;
+	let paused = 0;
+	const run = () => {
+		startedAt = Date.now();
+		timer = setTimeout(onExpire, Math.max(remaining, 0));
+	};
+	const stop = () => {
+		if (!timer) return;
+		clearTimeout(timer);
+		timer = null;
+		remaining -= Date.now() - startedAt;
+	};
+	return {
+		start: run,
+		pause: () => {
+			if (paused === 0) stop();
+			paused += 1;
+		},
+		resume: () => {
+			paused -= 1;
+			if (paused === 0) run();
+		},
+		clear: stop
+	};
 };
-const minBig = (a, b) => {
-	return a.lt(b) ? a : b;
+const withUserTimeout = (promise, ms) => {
+	return new Promise((resolve, reject) => {
+		const timer = setTimeout(() => {
+			reject(new PaymentUserTimeout());
+		}, ms);
+		promise.then((value) => {
+			clearTimeout(timer);
+			resolve(value);
+		}, (error) => {
+			clearTimeout(timer);
+			reject(error);
+		});
+	});
 };
-const rateOf = (discount, base) => {
-	if (base.lte(0)) return 0;
-	return minBig(discount.div(base), new Big(1)).toNumber();
+var PaymentUserTimeout = class extends Error {};
+const timedUI = (ui, deadline, interactionMs) => {
+	const wrap = (call) => {
+		deadline.pause();
+		return withUserTimeout(call(), interactionMs).finally(() => deadline.resume());
+	};
+	return {
+		message: (input) => ui.message(input),
+		action: (input) => ui.action(input),
+		select: (input) => {
+			return wrap(() => ui.select(input));
+		},
+		input: (input) => wrap(() => ui.input(input)),
+		confirm: (input) => wrap(() => ui.confirm(input))
+	};
 };
-const snapshot = (roots, quantity) => {
-	let subtotal = new Big(0);
-	let total = new Big(0);
-	let discount = new Big(0);
-	for (const root of roots) {
-		subtotal = subtotal.plus(root.subtotal);
-		total = total.plus(root.total);
-		discount = discount.plus(root.discount);
+/** Runs one adapter call with the provider timeout and the user clock. */
+const runTimed = async (ctx, call) => {
+	const controller = new AbortController();
+	const parent = ctx.signal;
+	const abort = () => controller.abort();
+	parent.addEventListener("abort", abort);
+	let expire = () => void 0;
+	const expired = new Promise((_, reject) => {
+		expire = () => {
+			controller.abort();
+			reject(new TimeoutSignal());
+		};
+	});
+	const deadline = createDeadline(ctx.policy.timeout_ms, () => expire());
+	const interaction = ctx.policy.interaction_timeout_ms;
+	const ui = timedUI(ctx.ui, deadline, interaction);
+	const scoped = {
+		...ctx,
+		ui,
+		signal: controller.signal
+	};
+	deadline.start();
+	try {
+		return await Promise.race([call(scoped), expired]);
+	} finally {
+		deadline.clear();
+		parent.removeEventListener("abort", abort);
 	}
-	const b1 = {
-		value: total.toNumber(),
-		quantity
+};
+const failed = (ctx, error, extra = {}) => {
+	const metadata = {
+		attempt_reference: ctx.attemptReference,
+		error,
+		...extra
 	};
-	const b2 = { discount_amount: discount.toNumber() };
-	const b3 = { discount_rate: rateOf(discount, subtotal) };
 	return {
-		...b1,
-		...b2,
-		...b3
+		status: "FAILED",
+		amount: ctx.amount.value,
+		metadata,
+		error
 	};
 };
-const netOf = (root) => {
-	const net = root.total.minus(root.tax);
-	return net.gt(0) ? net : new Big(0);
+const errorOf = (ctx, error, startedAt, clock) => {
+	const elapsed_ms = clock.now() - startedAt;
+	const attempt = ctx.attempt;
+	if (isPaymentError(error)) return {
+		...error.error,
+		attempt,
+		elapsed_ms
+	};
+	let code = "UNKNOWN";
+	if (error instanceof TimeoutSignal) code = "TIMEOUT";
+	if (error instanceof PaymentUserTimeout) code = "USER_TIMEOUT";
+	const extra = {
+		attempt,
+		elapsed_ms,
+		provider_message: error instanceof Error ? error.message : null
+	};
+	return createPaymentError(code, extra);
 };
-/** What a redeem can still discount on a root: pre-tax or with taxes. */
-const baseOf = (root, beforeTaxes) => {
-	return beforeTaxes ? netOf(root) : root.total;
+/** `start` that timed out after leaving the device is ambiguous. */
+const startError = (error) => {
+	if (error.code !== "TIMEOUT") return error;
+	return createPaymentError("AMBIGUOUS", {
+		attempt: error.attempt,
+		elapsed_ms: error.elapsed_ms
+	});
 };
-/** Before taxes, taxes shrink with the pre-tax value they were charged on. */
-const discountRoot = (root, amount, beforeTaxes) => {
-	if (amount.lte(0)) return;
-	root.discount = root.discount.plus(amount);
-	if (!beforeTaxes) {
-		root.total = root.total.minus(amount);
-		return;
+const isFinal = (result) => result.status !== "PENDING";
+const callOperation = async (ctx, operation, result, clock) => {
+	const startedAt = clock.now();
+	try {
+		return await runTimed(ctx, (scoped) => operation(scoped, result));
+	} catch (error) {
+		return failed(ctx, errorOf(ctx, error, startedAt, clock));
 	}
-	const net = netOf(root);
-	const nextNet = net.minus(amount);
-	root.tax = root.tax.times(nextNet).div(net);
-	root.total = nextNet.plus(root.tax);
 };
-/** Splits an order discount across roots by what each can still discount. */
-const discountOrder = (roots, amount, beforeTaxes) => {
-	const bases = roots.map((root) => baseOf(root, beforeTaxes));
-	const sum = bases.reduce((acc, base) => acc.plus(base), new Big(0));
-	if (sum.lte(0) || amount.lte(0)) return;
-	let last = -1;
-	bases.forEach((base, index) => {
-		if (base.gt(0)) last = index;
-	});
-	let rest = amount;
-	roots.forEach((root, index) => {
-		const base = bases[index];
-		if (base.lte(0)) return;
-		const share = amount.times(base).div(sum);
-		const part = minBig(index === last ? rest : share, base);
-		rest = rest.minus(part);
-		discountRoot(root, part, beforeTaxes);
-	});
+/** Query up to 3 times, cancel once, else FAILED + needs_review. */
+const resolveAmbiguous = async (adapter, ctx, pending, clock) => {
+	if (adapter.query) for (let i = 0; i < AMBIGUOUS_QUERIES; i += 1) {
+		await clock.sleep(ctx.policy.poll_interval_ms, ctx.signal);
+		const next = await callOperation(ctx, adapter.query, pending, clock);
+		if (next.status === "PAID") return next;
+		const definitive = next.error?.code !== "TIMEOUT" && !next.error?.retryable;
+		if (next.status === "FAILED" && definitive && next.error?.code !== "AMBIGUOUS") return next;
+	}
+	if (adapter.cancel) {
+		const cancelled = await callOperation(ctx, adapter.cancel, pending, clock);
+		if (cancelled.status === "CANCELLED") return cancelled;
+	}
+	const error = createPaymentError("AMBIGUOUS", { attempt: ctx.attempt });
+	return failed(ctx, error, { needs_review: true });
 };
-/**
-* Rate compounds once per reward unit over the remaining value; amount is
-* per unit. With both, the rate discount is capped at `amount × quantity`.
-*/
-const redeemDiscount = (redeem, remaining) => {
-	const { quantity, discount_rate, discount_amount } = redeem;
-	let cap = null;
-	if (discount_amount !== void 0) cap = new Big(discount_amount).times(quantity);
-	if (discount_rate === void 0) return cap ?? new Big(0);
-	const kept = new Big(1).minus(discount_rate).pow(quantity);
-	const byRate = remaining.times(new Big(1).minus(kept));
-	return cap ? minBig(byRate, cap) : byRate;
+/** PENDING with an action: poll until paid, rejected or the QR expires. */
+const pollPending = async (adapter, ctx, pending, clock, options) => {
+	if (pending.metadata.confirm_after_inject) return pending;
+	if (!adapter.query) return pending;
+	const expiresAt = clock.now() + ctx.policy.qr_ttl_ms;
+	let current = pending;
+	while (clock.now() < expiresAt) {
+		if (ctx.signal.aborted) break;
+		await clock.sleep(ctx.policy.poll_interval_ms, ctx.signal);
+		if (ctx.signal.aborted) break;
+		const next = await callOperation(ctx, adapter.query, current, clock);
+		if (next.status === "FAILED" && next.error?.retryable) continue;
+		if (isFinal(next)) return next;
+		current = next;
+		await options.onProgress?.(current);
+	}
+	if (adapter.cancel) await callOperation(ctx, adapter.cancel, current, clock);
+	const code = ctx.signal.aborted ? "CANCELLED_BY_USER" : "WALLET_EXPIRED";
+	return failed(ctx, createPaymentError(code, { attempt: ctx.attempt }));
 };
-/**
-* Root group money rebuilt from the line itself plus its children, i.e. the
-* menu price before any redemption. Child lines are never discounted.
-*/
-const stripRedemptionLines = (lines) => {
-	const children = /* @__PURE__ */ new Map();
-	for (const line of lines) {
-		if (line.parent_uid == null) continue;
-		const list = children.get(line.parent_uid) ?? [];
-		list.push(line);
-		children.set(line.parent_uid, list);
+const runStart = async (adapter, ctx, clock) => {
+	const startedAt = clock.now();
+	try {
+		return await runTimed(ctx, (scoped) => adapter.start(scoped));
+	} catch (error) {
+		const raw = errorOf(ctx, error, startedAt, clock);
+		return failed(ctx, startError(raw));
 	}
-	return lines.map((line) => {
-		if (line.parent_uid != null) return line;
-		const qty = new Big(line.quantity);
-		let sub = new Big(0);
-		let disc = new Big(0);
-		let tax = new Big(0);
-		let tot = new Big(0);
-		for (const child of children.get(line.uid) ?? []) {
-			sub = sub.plus(child.group_subtotal);
-			disc = disc.plus(child.group_discount);
-			tax = tax.plus(child.group_tax_total);
-			tot = tot.plus(child.group_total);
-		}
-		const gSub = new Big(line.subtotal).plus(sub.times(qty));
-		const gDisc = new Big(line.discount_total).plus(disc.times(qty));
-		const gTax = new Big(line.tax_total).plus(tax.times(qty));
-		const gTot = new Big(line.total).plus(tot.times(qty));
-		const u1 = { unit_group_subtotal: gSub.div(qty).toNumber() };
-		const u2 = { unit_group_discount: gDisc.div(qty).toNumber() };
-		const u3 = { unit_group_tax_total: gTax.div(qty).toNumber() };
-		const u4 = { unit_group_total: gTot.div(qty).toNumber() };
-		const g1 = { group_subtotal: gSub.toNumber() };
-		const g2 = { group_discount: gDisc.toNumber() };
-		const g3 = { group_tax_total: gTax.toNumber() };
-		const g4 = { group_total: gTot.toNumber() };
-		const p1 = {
-			...u1,
-			...u2,
-			...u3,
-			...u4
-		};
-		return {
-			...line,
-			...p1,
-			...g1,
-			...g2,
-			...g3,
-			...g4
-		};
-	});
 };
-const withRootMoney = (line, money) => {
-	const qty = new Big(line.quantity);
-	const discount = new Big(line.group_discount).plus(money.discount);
-	const u1 = { unit_group_discount: discount.div(qty).toNumber() };
-	const u2 = { unit_group_tax_total: money.tax.div(qty).toNumber() };
-	const u3 = { unit_group_total: money.total.div(qty).toNumber() };
-	const g1 = { group_discount: discount.toNumber() };
-	const g2 = { group_tax_total: money.tax.toNumber() };
-	const g3 = { group_total: money.total.toNumber() };
+const toTerminalContext = (ctx) => {
+	const b1 = {
+		paymentId: ctx.paymentId,
+		attempt: ctx.attempt
+	};
+	const b2 = { attemptReference: ctx.attemptReference };
+	const b3 = {
+		environment: ctx.environment,
+		config: ctx.config
+	};
+	const b4 = {
+		deviceSettings: ctx.deviceSettings,
+		policy: ctx.policy
+	};
+	const b5 = {
+		ui: ctx.ui,
+		storage: ctx.storage,
+		server: ctx.server
+	};
 	return {
-		...line,
-		...u1,
-		...u2,
-		...u3,
-		...g1,
-		...g2,
-		...g3
+		...b1,
+		...b2,
+		...b3,
+		...b4,
+		...b5,
+		signal: ctx.signal
 	};
 };
+const closeBatch = async (adapter, ctx) => {
+	const close = adapter.terminal?.closeBatch;
+	if (!close) return false;
+	const done = await close(toTerminalContext(ctx)).catch(() => null);
+	return Boolean(done?.ok);
+};
 /**
-* Replays every redeem in persisted step order over the root lines' group
-* money. Line redeems discount their root; order redeems are prorated over
-* every root. A discount never exceeds what is left on its target.
+* One payment attempt with the policy of section 7: timeout, retries on
+* retryable errors (same `attempt_reference`), batch close and retry,
+* polling for actions and resolution of ambiguous results.
 */
-const replayRedemptions = (lines, redeem, steps) => {
-	const base = stripRedemptionLines(lines);
-	const sequence = sequenceRedeems(base, redeem, steps);
-	const moneyByUid = /* @__PURE__ */ new Map();
-	for (const line of base) {
-		if (line.parent_uid != null) continue;
-		const b1 = { quantity: line.quantity };
-		const b2 = { subtotal: new Big(line.group_subtotal) };
-		const b3 = { tax: new Big(line.group_tax_total) };
-		const b4 = {
-			total: new Big(line.group_total),
-			discount: new Big(0)
-		};
-		moneyByUid.set(line.uid, {
-			...b1,
-			...b2,
-			...b3,
-			...b4
-		});
-	}
-	const roots = [...moneyByUid.values()];
-	const redemption_steps = sequence.map((item) => {
-		const id = item.target_id;
-		const root = id ? moneyByUid.get(id) : void 0;
-		const beforeTaxes = item.redeem.before_taxes ?? true;
-		const before = snapshot(roots, 1);
-		const targetBefore = root ? snapshot([root], root.quantity) : void 0;
-		let left = new Big(0);
-		if (root) left = baseOf(root, beforeTaxes);
-		else for (const r of roots) left = left.plus(baseOf(r, beforeTaxes));
-		const raw = redeemDiscount(item.redeem, left);
-		const discount = minBig(raw, left);
-		if (root) discountRoot(root, discount, beforeTaxes);
-		else discountOrder(roots, discount, beforeTaxes);
-		const action = discount.gt(0) ? "UPDATE" : "READ";
-		const { reward_id, quantity } = item.redeem;
-		const b1 = {
-			reward_id,
-			reward_quantity: quantity,
-			target: item.target
-		};
-		const b2 = id ? { target_id: id } : {};
-		const b3 = {
-			action,
-			discount_amount: discount.toNumber()
-		};
-		const b4 = {
-			before,
-			after: snapshot(roots, 1)
-		};
-		let b5 = {};
-		if (root) b5 = {
-			target_before: targetBefore,
-			target_after: snapshot([root], root.quantity)
+const runPaymentAttempt = async (adapter, ctx, options = {}) => {
+	const clock = options.clock ?? defaultClock;
+	return withTerminalLock(ctx.paymentId, async () => {
+		let batchClosed = false;
+		let attempt = 1;
+		while (true) {
+			const current = {
+				...ctx,
+				attempt
+			};
+			const result = await runStart(adapter, current, clock);
+			const code = result.error?.code;
+			if (code === "BATCH_CLOSE_REQUIRED" && !batchClosed) {
+				batchClosed = true;
+				if (await closeBatch(adapter, current)) continue;
+			}
+			if (code === "AMBIGUOUS") {
+				await options.onProgress?.({
+					...result,
+					status: "PENDING"
+				});
+				return resolveAmbiguous(adapter, current, result, clock);
+			}
+			const canRetry = attempt < ctx.policy.max_attempts;
+			if (result.status === "FAILED" && result.error?.retryable && canRetry) {
+				attempt += 1;
+				continue;
+			}
+			if (result.status !== "PENDING") return result;
+			await options.onProgress?.(result);
+			return pollPending(adapter, current, result, clock, options);
+		}
+	});
+};
+/** Undo a charge after a failed injection or an incomplete split payment. */
+const reversePayment = async (adapter, ctx, result, options = {}) => {
+	const clock = options.clock ?? defaultClock;
+	const now = options.now ?? new Date(clock.now());
+	let kind = (adapter.reversalFor ?? defaultReversalFor)(result, now);
+	const operation = kind === "cancel" ? adapter.cancel : adapter.refund;
+	if (kind !== "manual" && !operation) kind = "manual";
+	if (kind === "manual" || !operation) {
+		const error = createPaymentError("MANUAL_REVERSAL_REQUIRED");
+		const m1 = {
+			...result.metadata,
+			error,
+			needs_review: true
 		};
 		return {
-			...b1,
-			...b2,
-			...b3,
-			...b4,
-			...b5
+			kind: "manual",
+			result: {
+				...result,
+				metadata: m1,
+				error
+			}
 		};
-	});
-	return {
-		lines: base.map((line) => {
-			const money = moneyByUid.get(line.uid);
-			if (!money || money.discount.eq(0)) return line;
-			return withRootMoney(line, money);
-		}),
-		redemption_steps
-	};
-};
-/** Discounted lines, steps and totals, keeping step order. */
-const recomputeRedemptions = (input) => {
-	const { redeem, currency } = input;
-	const steps = input.redemption_steps;
-	const { lines, redemption_steps } = replayRedemptions(input.lines, redeem, steps);
+	}
+	const run = () => callOperation(ctx, operation, result, clock);
+	const next = await withTerminalLock(ctx.paymentId, run);
 	return {
-		lines,
-		redemption_steps,
-		totals: recomputeTotals(lines, currency)
+		kind,
+		result: next
 	};
 };
 //#endregion
-//#region src/order/tenders.ts
-/** Catalog provider of `REDEMPTION` payments (§3.3). */
-const DEFAULT_REDEMPTION_PROVIDER = "firespark";
-/**
-* Digital tender the SDK charges (`DEVICE`, §7.3). `KIOSK`, `COUNTER`,
-* `DOOR` and `OTHER` are in person: the POS, an operator or the courier
-* collects them (§12).
-*/
-const isDeviceCharged = (tender) => {
-	return DIGITAL_COLLECT_AT.includes(tender.collect_at);
+//#region src/order/payments/session.ts
+const noopUI = {
+	message: () => void 0,
+	action: () => void 0,
+	select: () => Promise.reject(/* @__PURE__ */ new Error("Payment UI not configured")),
+	input: () => Promise.reject(/* @__PURE__ */ new Error("Payment UI not configured")),
+	confirm: () => Promise.resolve(false)
 };
-/** Most a REDEMPTION can cover: order total − tip − delivery (D18). */
-const redemptionCap = (order) => {
-	const primaryOnly = order.lines.filter((line) => line.parent_uid == null).reduce((sum, line) => {
-		return isTipFee(line) || isDeliveryFee(line) ? sum + line.group_total : sum;
-	}, 0);
-	const decimals = currencyDecimals(order.totals.currency);
-	return Math.max(roundTo(order.totals.total - primaryOnly, decimals), 0);
+const adapterKey = (provider, method) => {
+	return `${provider}:${method}`;
 };
-/**
-* Trims payment redeems in application order so their sum fits the cap;
-* points shrink in proportion. Discount redeems are left untouched.
-*/
-const clampPaymentRedeems = (redeem, cap, currency) => {
-	const decimals = currencyDecimals(currency);
-	let left = cap;
-	return redeem.flatMap((item) => {
-		if (!isPaymentRedeem(item)) return [item];
-		const amount = item.amount ?? 0;
-		const fits = Math.max(roundTo(Math.min(amount, left), decimals), 0);
-		left = roundTo(left - fits, decimals);
-		if (fits <= 0) return [];
-		if (fits + amountTolerance(currency) >= amount) return [item];
-		const ratio = amount > 0 ? fits / amount : 0;
-		const points = roundTo((item.points ?? 0) * ratio, 0);
-		return [{
-			...item,
-			amount: fits,
-			points
-		}];
-	});
-};
-/**
-* One REDEMPTION tender per `payment_id` of the payment redeems (D15,
-* D19); its `details.rewards[]` lists every grouped redeem.
-*/
-const redemptionTenderInputs = (redeem, providers = /* @__PURE__ */ new Map()) => {
-	return groupPaymentRedeems(redeem).map(({ payment_id, details }) => {
-		const fallback = DEFAULT_REDEMPTION_PROVIDER;
-		const t1 = {
-			method: "REDEMPTION",
-			provider: providers.get(payment_id) ?? fallback,
-			payment_id
-		};
-		const t2 = {
-			collect_at: "OTHER",
-			allocation: null,
-			details
-		};
-		return {
-			...t1,
-			...t2
-		};
-	});
-};
-/** The one real tender of the simple flow (`allocation: null`). */
-const simpleTenderInput = (payment) => {
-	if (!payment.type || !payment.provider) return null;
-	if (!isRealPaymentMethod(payment.type)) return null;
-	const collect_at = payment.collect_at ?? "DEVICE";
-	const t1 = {
-		method: payment.type,
-		provider: payment.provider
-	};
-	const t2 = {
-		payment_id: payment.id,
-		collect_at,
-		allocation: null
-	};
-	return {
-		...t1,
-		...t2
-	};
+const record = (value) => {
+	if (!value || typeof value !== "object") return {};
+	return value;
 };
-/**
-* Charge order of §6.1: deferred capture (authorize only), immediate
-* capture reversible with cancel/refund, manual reversal only, then cash /
-* IDLE last.
-*/
-const chargeRank = (tender, adapter) => {
-	if (tender.method === "CASH") return 3;
-	if (adapter.capabilities?.deferredCapture) return 0;
-	if (adapter.cancel || adapter.refund) return 1;
-	return 2;
+const isPendingConfirm = (tender) => {
+	const confirm = record(tender.metadata).confirm_after_inject === true;
+	return tender.status === "PENDING" && confirm;
 };
-//#endregion
-//#region src/order/payments/orchestrator.ts
-const AMBIGUOUS_QUERIES = 3;
-const defaultSleep = (ms, signal) => {
-	return new Promise((resolve) => {
-		const timer = setTimeout(resolve, ms);
-		signal?.addEventListener("abort", () => {
-			clearTimeout(timer);
-			resolve();
-		});
+/** Live tenders of the current intent that hold the customer's money. */
+const chargedTenders = (intents) => {
+	return liveTenders(currentIntent(intents)).filter((tender) => {
+		return isTenderSettled(tender) || isPendingConfirm(tender);
 	});
 };
-const defaultClock = {
-	now: () => Date.now(),
-	sleep: defaultSleep
+/** Settled tenders plus PENDING `confirm_after_inject`, order currency. */
+const coveredAmount = (intents) => {
+	return chargedTenders(intents).reduce((sum, tender) => {
+		return sum + tender.amount.total;
+	}, 0);
 };
-var TimeoutSignal = class extends Error {};
-/**
-* Provider deadline that pauses while the customer is answering `ctx.ui`;
-* user waits run on `interaction_timeout_ms` instead.
-*/
-const createDeadline = (timeoutMs, onExpire) => {
-	let remaining = timeoutMs;
-	let startedAt = 0;
-	let timer = null;
-	let paused = 0;
-	const run = () => {
-		startedAt = Date.now();
-		timer = setTimeout(onExpire, Math.max(remaining, 0));
-	};
-	const stop = () => {
-		if (!timer) return;
-		clearTimeout(timer);
-		timer = null;
-		remaining -= Date.now() - startedAt;
-	};
+const remainingAmount = (order) => {
+	const decimals = currencyDecimals(order.totals.currency);
+	const left = order.totals.total - coveredAmount(order.payment_intents);
+	return Math.max(roundTo(left, decimals), 0);
+};
+const isPlaced = (order) => order.status !== "OPEN";
+/** Orchestrator failures carry the charge-currency amount, not the order's. */
+const withOrderAmount = (result, amount) => {
+	if (result.status !== "FAILED") return result;
 	return {
-		start: run,
-		pause: () => {
-			if (paused === 0) stop();
-			paused += 1;
-		},
-		resume: () => {
-			paused -= 1;
-			if (paused === 0) run();
-		},
-		clear: stop
+		...result,
+		amount
 	};
 };
-const withUserTimeout = (promise, ms) => {
-	return new Promise((resolve, reject) => {
-		const timer = setTimeout(() => {
-			reject(new PaymentUserTimeout());
-		}, ms);
-		promise.then((value) => {
-			clearTimeout(timer);
-			resolve(value);
-		}, (error) => {
-			clearTimeout(timer);
-			reject(error);
-		});
-	});
+const partialOf = (result) => {
+	return record(result.metadata).partial_approval !== void 0;
 };
-var PaymentUserTimeout = class extends Error {};
-const timedUI = (ui, deadline, interactionMs) => {
-	const wrap = (call) => {
-		deadline.pause();
-		return withUserTimeout(call(), interactionMs).finally(() => deadline.resume());
-	};
+/** D31: PAID for less than the tender (same currency only). */
+const isPartialApproval = (result, tender, ctx) => {
+	if (result.status !== "PAID") return false;
+	if (ctx.amount.currency !== tender.amount.currency) return false;
+	const tolerance = amountTolerance(tender.amount.currency);
+	return result.amount + tolerance < tender.amount.total;
+};
+const toFailure = (error) => {
+	const message = error instanceof Error ? error.message : "Terminal failed";
 	return {
-		message: (input) => ui.message(input),
-		action: (input) => ui.action(input),
-		select: (input) => {
-			return wrap(() => ui.select(input));
-		},
-		input: (input) => wrap(() => ui.input(input)),
-		confirm: (input) => wrap(() => ui.confirm(input))
+		ok: false,
+		message,
+		error: createPaymentError("UNKNOWN", { provider_message: message })
 	};
 };
-/** Runs one adapter call with the provider timeout and the user clock. */
-const runTimed = async (ctx, call) => {
-	const controller = new AbortController();
-	const parent = ctx.signal;
-	const abort = () => controller.abort();
-	parent.addEventListener("abort", abort);
-	let expire = () => void 0;
-	const expired = new Promise((_, reject) => {
-		expire = () => {
-			controller.abort();
-			reject(new TimeoutSignal());
+/**
+* Payment state of one order: adapters, device settings and the attempt
+* orchestration. The app only provides adapters, UI and storage.
+*/
+var PaymentSession = class {
+	deps;
+	adapters = /* @__PURE__ */ new Map();
+	payments = /* @__PURE__ */ new Map();
+	ui = noopUI;
+	storage = memoryPaymentStorage();
+	options = {};
+	constructor(deps) {
+		this.deps = deps;
+	}
+	setAdapters(adapters) {
+		this.adapters.clear();
+		for (const adapter of adapters) this.adapters.set(adapterKey(adapter.provider, adapter.method), adapter);
+	}
+	setUI(ui) {
+		this.ui = ui;
+	}
+	setStorage(storage) {
+		this.storage = storage;
+	}
+	setOptions(options) {
+		this.options = {
+			...this.options,
+			...options
 		};
-	});
-	const deadline = createDeadline(ctx.policy.timeout_ms, () => expire());
-	const interaction = ctx.policy.interaction_timeout_ms;
-	const ui = timedUI(ctx.ui, deadline, interaction);
-	const scoped = {
-		...ctx,
-		ui,
-		signal: controller.signal
-	};
-	deadline.start();
-	try {
-		return await Promise.race([call(scoped), expired]);
-	} finally {
-		deadline.clear();
-		parent.removeEventListener("abort", abort);
+		captureLogDevice(options.deviceId);
 	}
-};
-const failed = (ctx, error, extra = {}) => {
-	const metadata = {
-		attempt_reference: ctx.attemptReference,
-		error,
-		...extra
-	};
-	return {
-		status: "FAILED",
-		amount: ctx.amount.value,
-		metadata,
-		error
-	};
-};
-const errorOf = (ctx, error, startedAt, clock) => {
-	const elapsed_ms = clock.now() - startedAt;
-	const attempt = ctx.attempt;
-	if (isPaymentError(error)) return {
-		...error.error,
-		attempt,
-		elapsed_ms
-	};
-	let code = "UNKNOWN";
-	if (error instanceof TimeoutSignal) code = "TIMEOUT";
-	if (error instanceof PaymentUserTimeout) code = "USER_TIMEOUT";
-	const extra = {
-		attempt,
-		elapsed_ms,
-		provider_message: error instanceof Error ? error.message : null
-	};
-	return createPaymentError(code, extra);
-};
-/** `start` that timed out after leaving the device is ambiguous. */
-const startError = (error) => {
-	if (error.code !== "TIMEOUT") return error;
-	return createPaymentError("AMBIGUOUS", {
-		attempt: error.attempt,
-		elapsed_ms: error.elapsed_ms
-	});
-};
-const isFinal = (result) => result.status !== "PENDING";
-const callOperation = async (ctx, operation, result, clock) => {
-	const startedAt = clock.now();
-	try {
-		return await runTimed(ctx, (scoped) => operation(scoped, result));
-	} catch (error) {
-		return failed(ctx, errorOf(ctx, error, startedAt, clock));
+	adapterFor(payment) {
+		const key = adapterKey(payment.provider.provider_id, payment.method.method);
+		return this.adapters.get(key) ?? null;
 	}
-};
-/** Query up to 3 times, cancel once, else FAILED + needs_review. */
-const resolveAmbiguous = async (adapter, ctx, pending, clock) => {
-	if (adapter.query) for (let i = 0; i < AMBIGUOUS_QUERIES; i += 1) {
-		await clock.sleep(ctx.policy.poll_interval_ms, ctx.signal);
-		const next = await callOperation(ctx, adapter.query, pending, clock);
-		if (next.status === "PAID") return next;
-		const definitive = next.error?.code !== "TIMEOUT" && !next.error?.retryable;
-		if (next.status === "FAILED" && definitive && next.error?.code !== "AMBIGUOUS") return next;
+	/** Device fields still missing for a payment on this device. */
+	missingFields(payment) {
+		const adapter = this.adapterFor(payment);
+		if (!adapter) return [];
+		const fromCatalog = record(payment.method.config).device_fields;
+		const fields = adapter.deviceFields ?? fromCatalog;
+		const settings = this.options.deviceSettings?.[payment.id];
+		return missingDeviceFields(Array.isArray(fields) ? fields : [], settings);
 	}
-	if (adapter.cancel) {
-		const cancelled = await callOperation(ctx, adapter.cancel, pending, clock);
-		if (cancelled.status === "CANCELLED") return cancelled;
+	/**
+	* Merchant payments with an installed adapter (provider + method) that
+	* are fully configured on this device.
+	*/
+	available(payments) {
+		return payments.filter((payment) => {
+			if (!this.adapterFor(payment)) return false;
+			this.payments.set(payment.id, payment);
+			return this.missingFields(payment).length === 0;
+		});
 	}
-	const error = createPaymentError("AMBIGUOUS", { attempt: ctx.attempt });
-	return failed(ctx, error, { needs_review: true });
-};
-/** PENDING with an action: poll until paid, rejected or the QR expires. */
-const pollPending = async (adapter, ctx, pending, clock, options) => {
-	if (pending.metadata.confirm_after_inject) return pending;
-	if (!adapter.query) return pending;
-	const expiresAt = clock.now() + ctx.policy.qr_ttl_ms;
-	let current = pending;
-	while (clock.now() < expiresAt) {
-		if (ctx.signal.aborted) break;
-		await clock.sleep(ctx.policy.poll_interval_ms, ctx.signal);
-		if (ctx.signal.aborted) break;
-		const next = await callOperation(ctx, adapter.query, current, clock);
-		if (next.status === "FAILED" && next.error?.retryable) continue;
-		if (isFinal(next)) return next;
-		current = next;
-		await options.onProgress?.(current);
+	remaining() {
+		return remainingAmount(this.deps.getOrder());
 	}
-	if (adapter.cancel) await callOperation(ctx, adapter.cancel, current, clock);
-	const code = ctx.signal.aborted ? "CANCELLED_BY_USER" : "WALLET_EXPIRED";
-	return failed(ctx, createPaymentError(code, { attempt: ctx.attempt }));
-};
-const runStart = async (adapter, ctx, clock) => {
-	const startedAt = clock.now();
-	try {
-		return await runTimed(ctx, (scoped) => adapter.start(scoped));
-	} catch (error) {
-		const raw = errorOf(ctx, error, startedAt, clock);
-		return failed(ctx, startError(raw));
+	server(payment, attempt) {
+		const order_id = this.deps.getOrder().id;
+		const http = this.deps.http;
+		return { call: (operation, input) => {
+			const body = {
+				order_id,
+				attempt_reference: attempt,
+				input
+			};
+			const op = services.payments.operation;
+			return op(payment.id, operation, body, http);
+		} };
 	}
-};
-const toTerminalContext = (ctx) => {
-	const b1 = {
-		paymentId: ctx.paymentId,
-		attempt: ctx.attempt
-	};
-	const b2 = { attemptReference: ctx.attemptReference };
-	const b3 = {
-		environment: ctx.environment,
-		config: ctx.config
-	};
-	const b4 = {
-		deviceSettings: ctx.deviceSettings,
-		policy: ctx.policy
-	};
-	const b5 = {
-		ui: ctx.ui,
-		storage: ctx.storage,
-		server: ctx.server
-	};
-	return {
-		...b1,
-		...b2,
-		...b3,
-		...b4,
-		...b5,
-		signal: ctx.signal
-	};
-};
-const closeBatch = async (adapter, ctx) => {
-	const close = adapter.terminal?.closeBatch;
-	if (!close) return false;
-	const done = await close(toTerminalContext(ctx)).catch(() => null);
-	return Boolean(done?.ok);
-};
-/**
-* One payment attempt with the policy of section 7: timeout, retries on
-* retryable errors (same `attempt_reference`), batch close and retry,
-* polling for actions and resolution of ambiguous results.
-*/
-const runPaymentAttempt = async (adapter, ctx, options = {}) => {
-	const clock = options.clock ?? defaultClock;
-	return withTerminalLock(ctx.paymentId, async () => {
-		let batchClosed = false;
-		let attempt = 1;
-		while (true) {
-			const current = {
-				...ctx,
-				attempt
+	async chargeAmount(payment, value, server) {
+		const config = record(payment.config);
+		const orderCurrency = this.deps.getOrder().totals.currency;
+		const chargeCurrency = config.charge_currency;
+		if (!chargeCurrency || chargeCurrency === orderCurrency) return toChargeAmount({
+			value,
+			orderCurrency
+		});
+		const exchange = record(config.exchange_rate);
+		let rate = typeof exchange.rate === "number" ? exchange.rate : null;
+		if (exchange.source === "provider") {
+			const input = {
+				from: orderCurrency,
+				to: chargeCurrency
 			};
-			const result = await runStart(adapter, current, clock);
-			const code = result.error?.code;
-			if (code === "BATCH_CLOSE_REQUIRED" && !batchClosed) {
-				batchClosed = true;
-				if (await closeBatch(adapter, current)) continue;
-			}
-			if (code === "AMBIGUOUS") {
-				await options.onProgress?.({
-					...result,
-					status: "PENDING"
-				});
-				return resolveAmbiguous(adapter, current, result, clock);
-			}
-			const canRetry = attempt < ctx.policy.max_attempts;
-			if (result.status === "FAILED" && result.error?.retryable && canRetry) {
-				attempt += 1;
-				continue;
-			}
-			if (result.status !== "PENDING") return result;
-			await options.onProgress?.(result);
-			return pollPending(adapter, current, result, clock, options);
+			rate = (await server.call("exchange_rate", input)).rate;
 		}
-	});
-};
-/** Undo a charge after a failed injection or an incomplete split payment. */
-const reversePayment = async (adapter, ctx, result, options = {}) => {
-	const clock = options.clock ?? defaultClock;
-	const now = options.now ?? new Date(clock.now());
-	let kind = (adapter.reversalFor ?? defaultReversalFor)(result, now);
-	const operation = kind === "cancel" ? adapter.cancel : adapter.refund;
-	if (kind !== "manual" && !operation) kind = "manual";
-	if (kind === "manual" || !operation) {
-		const error = createPaymentError("MANUAL_REVERSAL_REQUIRED");
-		const m1 = {
-			...result.metadata,
-			error,
-			needs_review: true
+		return toChargeAmount({
+			value,
+			orderCurrency,
+			chargeCurrency,
+			rate
+		});
+	}
+	async buildContext(payment, amount, attemptReference, signal) {
+		const order = this.deps.getOrder();
+		const server = this.server(payment, attemptReference);
+		const conversion = await this.chargeAmount(payment, amount, server);
+		const config = record(payment.config);
+		const methodConfig = record(payment.method.config);
+		const share = order.totals.total > 0 ? amount / order.totals.total : 1;
+		const decimals = currencyDecimals(order.totals.currency);
+		const taxes = taxBreakdown(order.lines, {
+			share,
+			decimals
+		});
+		const info = order.customer.customer_info;
+		const customer = {
+			document: info.document_number ?? null,
+			documentType: info.document_type ?? null,
+			phone: info.phone ?? null
 		};
-		return {
-			kind: "manual",
-			result: {
-				...result,
-				metadata: m1,
-				error
-			}
-		};
-	}
-	const run = () => callOperation(ctx, operation, result, clock);
-	const next = await withTerminalLock(ctx.paymentId, run);
-	return {
-		kind,
-		result: next
-	};
-};
-//#endregion
-//#region src/order/payments/session.ts
-const noopUI = {
-	message: () => void 0,
-	action: () => void 0,
-	select: () => Promise.reject(/* @__PURE__ */ new Error("Payment UI not configured")),
-	input: () => Promise.reject(/* @__PURE__ */ new Error("Payment UI not configured")),
-	confirm: () => Promise.resolve(false)
-};
-const adapterKey = (provider, method) => {
-	return `${provider}:${method}`;
-};
-const record = (value) => {
-	if (!value || typeof value !== "object") return {};
-	return value;
-};
-const isPendingConfirm = (tender) => {
-	const confirm = record(tender.metadata).confirm_after_inject === true;
-	return tender.status === "PENDING" && confirm;
-};
-/** Live tenders of the current intent that hold the customer's money. */
-const chargedTenders = (intents) => {
-	return liveTenders(currentIntent(intents)).filter((tender) => {
-		return isTenderSettled(tender) || isPendingConfirm(tender);
-	});
-};
-/** Settled tenders plus PENDING `confirm_after_inject`, order currency. */
-const coveredAmount = (intents) => {
-	return chargedTenders(intents).reduce((sum, tender) => {
-		return sum + tender.amount.total;
-	}, 0);
-};
-const remainingAmount = (order) => {
-	const decimals = currencyDecimals(order.totals.currency);
-	const left = order.totals.total - coveredAmount(order.payment_intents);
-	return Math.max(roundTo(left, decimals), 0);
-};
-const isPlaced = (order) => order.status !== "OPEN";
-/** Orchestrator failures carry the charge-currency amount, not the order's. */
-const withOrderAmount = (result, amount) => {
-	if (result.status !== "FAILED") return result;
-	return {
-		...result,
-		amount
-	};
-};
-const partialOf = (result) => {
-	return record(result.metadata).partial_approval !== void 0;
-};
-/** D31: PAID for less than the tender (same currency only). */
-const isPartialApproval = (result, tender, ctx) => {
-	if (result.status !== "PAID") return false;
-	if (ctx.amount.currency !== tender.amount.currency) return false;
-	const tolerance = amountTolerance(tender.amount.currency);
-	return result.amount + tolerance < tender.amount.total;
-};
-const toFailure = (error) => {
-	const message = error instanceof Error ? error.message : "Terminal failed";
-	return {
-		ok: false,
-		message,
-		error: createPaymentError("UNKNOWN", { provider_message: message })
-	};
-};
-/**
-* Payment state of one order: adapters, device settings and the attempt
-* orchestration. The app only provides adapters, UI and storage.
-*/
-var PaymentSession = class {
-	deps;
-	adapters = /* @__PURE__ */ new Map();
-	payments = /* @__PURE__ */ new Map();
-	ui = noopUI;
-	storage = memoryPaymentStorage();
-	options = {};
-	constructor(deps) {
-		this.deps = deps;
-	}
-	setAdapters(adapters) {
-		this.adapters.clear();
-		for (const adapter of adapters) this.adapters.set(adapterKey(adapter.provider, adapter.method), adapter);
-	}
-	setUI(ui) {
-		this.ui = ui;
-	}
-	setStorage(storage) {
-		this.storage = storage;
-	}
-	setOptions(options) {
-		this.options = {
-			...this.options,
-			...options
-		};
-		captureLogDevice(options.deviceId);
-	}
-	adapterFor(payment) {
-		const key = adapterKey(payment.provider.provider_id, payment.method.method);
-		return this.adapters.get(key) ?? null;
-	}
-	/** Device fields still missing for a payment on this device. */
-	missingFields(payment) {
-		const adapter = this.adapterFor(payment);
-		if (!adapter) return [];
-		const fromCatalog = record(payment.method.config).device_fields;
-		const fields = adapter.deviceFields ?? fromCatalog;
-		const settings = this.options.deviceSettings?.[payment.id];
-		return missingDeviceFields(Array.isArray(fields) ? fields : [], settings);
-	}
-	/**
-	* Merchant payments with an installed adapter (provider + method) that
-	* are fully configured on this device.
-	*/
-	available(payments) {
-		return payments.filter((payment) => {
-			if (!this.adapterFor(payment)) return false;
-			this.payments.set(payment.id, payment);
-			return this.missingFields(payment).length === 0;
-		});
-	}
-	remaining() {
-		return remainingAmount(this.deps.getOrder());
-	}
-	server(payment, attempt) {
-		const order_id = this.deps.getOrder().id;
-		const http = this.deps.http;
-		return { call: (operation, input) => {
-			const body = {
-				order_id,
-				attempt_reference: attempt,
-				input
-			};
-			const op = services.payments.operation;
-			return op(payment.id, operation, body, http);
-		} };
-	}
-	async chargeAmount(payment, value, server) {
-		const config = record(payment.config);
-		const orderCurrency = this.deps.getOrder().totals.currency;
-		const chargeCurrency = config.charge_currency;
-		if (!chargeCurrency || chargeCurrency === orderCurrency) return toChargeAmount({
-			value,
-			orderCurrency
-		});
-		const exchange = record(config.exchange_rate);
-		let rate = typeof exchange.rate === "number" ? exchange.rate : null;
-		if (exchange.source === "provider") {
-			const input = {
-				from: orderCurrency,
-				to: chargeCurrency
-			};
-			rate = (await server.call("exchange_rate", input)).rate;
-		}
-		return toChargeAmount({
-			value,
-			orderCurrency,
-			chargeCurrency,
-			rate
-		});
-	}
-	async buildContext(payment, amount, attemptReference, signal) {
-		const order = this.deps.getOrder();
-		const server = this.server(payment, attemptReference);
-		const conversion = await this.chargeAmount(payment, amount, server);
-		const config = record(payment.config);
-		const methodConfig = record(payment.method.config);
-		const share = order.totals.total > 0 ? amount / order.totals.total : 1;
-		const decimals = currencyDecimals(order.totals.currency);
-		const taxes = taxBreakdown(order.lines, {
-			share,
-			decimals
-		});
-		const info = order.customer.customer_info;
-		const customer = {
-			document: info.document_number ?? null,
-			documentType: info.document_type ?? null,
-			phone: info.phone ?? null
-		};
-		const environment = resolveProviderEnvironment({
-			isProduction: this.options.isProduction ?? false,
-			paymentConfig: config
-		});
-		const policy = resolvePaymentPolicy({
-			methodConfig,
-			paymentConfig: config
-		});
-		const prefix = `payments:${payment.id}`;
-		const storage = scopedPaymentStorage(this.storage, prefix);
-		const deviceSettings = this.options.deviceSettings?.[payment.id] ?? {};
-		const totals = order.totals;
-		const o1 = {
-			id: order.id,
-			currency: totals.currency,
-			totals
+		const environment = resolveProviderEnvironment({
+			isProduction: this.options.isProduction ?? false,
+			paymentConfig: config
+		});
+		const policy = resolvePaymentPolicy({
+			methodConfig,
+			paymentConfig: config
+		});
+		const prefix = `payments:${payment.id}`;
+		const storage = scopedPaymentStorage(this.storage, prefix);
+		const deviceSettings = this.options.deviceSettings?.[payment.id] ?? {};
+		const totals = order.totals;
+		const o1 = {
+			id: order.id,
+			currency: totals.currency,
+			totals
 		};
 		const b1 = {
 			paymentId: payment.id,
@@ -4865,215 +4446,648 @@ var PaymentSession = class {
 			closeBatch: terminal.closeBatch,
 			status: terminal.status
 		};
-		const named = {
-			...base,
-			...more
+		const named = {
+			...base,
+			...more
+		};
+		const extra = terminal.extra?.find((item) => item.key === key)?.run;
+		const operation = named[key] ?? extra;
+		if (!operation) return {
+			ok: false,
+			message: `Unknown operation ${key}`
+		};
+		const signal = new AbortController().signal;
+		const reference = createAttemptReference();
+		const result = await operation(toTerminalContext(await this.buildContext(payment, 0, reference, signal))).catch(toFailure);
+		if (!result.ok) await this.reportTerminal(payment, key, result);
+		return result;
+	}
+	async reportTerminal(payment, operation, result) {
+		const fallback = createPaymentError("UNKNOWN");
+		const error = result.error ?? {
+			...fallback,
+			message: result.message ?? fallback.message
+		};
+		const body = {
+			operation,
+			device_id: this.options.deviceId ?? null,
+			error
+		};
+		const report = services.payments.terminalFailure;
+		await report(payment.id, body, this.deps.http).catch(() => void 0);
+	}
+};
+//#endregion
+//#region src/schedule/schedule.ts
+const DAY_OF_WEEK = [
+	"sunday",
+	"monday",
+	"tuesday",
+	"wednesday",
+	"thursday",
+	"friday",
+	"saturday"
+];
+const timeToMinutes = (time) => {
+	const [hours = "0", minutes = "0"] = time.split(":");
+	return Number(hours) * 60 + Number(minutes);
+};
+const hasSpecificDates = (period) => {
+	return period.start_date != null && period.end_date != null;
+};
+const periodCoversDate = (period, now) => {
+	if (!hasSpecificDates(period)) return false;
+	const nowMs = now.getTime();
+	const startMs = Date.parse(period.start_date);
+	const endMs = Date.parse(period.end_date);
+	if (Number.isNaN(startMs) || Number.isNaN(endMs)) return false;
+	return startMs <= nowMs && nowMs <= endMs;
+};
+const timeMatches = (period, now) => {
+	if (!period.start_time || !period.end_time) return false;
+	const nowMinutes = now.getHours() * 60 + now.getMinutes();
+	const start = timeToMinutes(period.start_time);
+	const end = timeToMinutes(period.end_time);
+	return nowMinutes >= start && nowMinutes < end;
+};
+const isClosedAt = (period, now) => {
+	if (!period.closed) return false;
+	if (!period.start_time || !period.end_time) return true;
+	return timeMatches(period, now);
+};
+const isOpenAt = (period, now) => {
+	if (period.closed) return false;
+	return timeMatches(period, now);
+};
+const isPeriodsActiveAt = (periods, now) => {
+	return getOpenPeriodAt(periods, now) != null;
+};
+const getOpenPeriodAt = (periods, now) => {
+	if (periods.length === 0) return null;
+	const coveringSpecific = periods.filter((period) => {
+		return periodCoversDate(period, now);
+	});
+	const fallback = periods.filter((period) => !hasSpecificDates(period));
+	const specificOpens = coveringSpecific.filter((period) => !period.closed);
+	if (coveringSpecific.filter((period) => period.closed).some((period) => isClosedAt(period, now))) return null;
+	if (specificOpens.length > 0) return specificOpens.find((period) => isOpenAt(period, now)) ?? null;
+	if (fallback.some((period) => isClosedAt(period, now))) return null;
+	return fallback.filter((period) => !period.closed).find((period) => isOpenAt(period, now)) ?? null;
+};
+const atTimeOnDate = (day, time) => {
+	const [hours = "0", minutes = "0"] = time.split(":");
+	const next = new Date(day);
+	next.setHours(Number(hours), Number(minutes), 0, 0);
+	return next;
+};
+const isWithinPeriodDates = (period, instantMs) => {
+	if (!hasSpecificDates(period)) return true;
+	const startMs = Date.parse(period.start_date);
+	const endMs = Date.parse(period.end_date);
+	if (Number.isNaN(startMs) || Number.isNaN(endMs)) return false;
+	return startMs <= instantMs && instantMs <= endMs;
+};
+const dayPeriods = (schedule, instant) => {
+	const day = DAY_OF_WEEK[instant.getDay()];
+	if (!day) return [];
+	return schedule.find((row) => row.day_of_week === day)?.periods ?? [];
+};
+const getActiveUntil = (periods, now) => {
+	const open = getOpenPeriodAt(periods, now);
+	if (!open?.end_time) return null;
+	let untilMs = atTimeOnDate(now, open.end_time).getTime();
+	const openIsSpecific = hasSpecificDates(open);
+	for (const period of periods) {
+		if (!period.closed || !period.start_time) continue;
+		const closeMs = atTimeOnDate(now, period.start_time).getTime();
+		if (closeMs <= now.getTime() || closeMs >= untilMs) continue;
+		if (!isWithinPeriodDates(period, closeMs)) continue;
+		if (!hasSpecificDates(period) && openIsSpecific) continue;
+		untilMs = closeMs;
+	}
+	return new Date(untilMs);
+};
+const getNextStart = (schedule, now) => {
+	const nowMs = now.getTime();
+	let nextStartMs = null;
+	const consider = (candidate, periods) => {
+		const startMs = candidate.getTime();
+		if (startMs <= nowMs) return;
+		if (!isPeriodsActiveAt(periods, candidate)) return;
+		if (nextStartMs === null || startMs < nextStartMs) nextStartMs = startMs;
+	};
+	for (let dayOffset = 0; dayOffset < 8; dayOffset += 1) {
+		const candidateDate = new Date(now);
+		candidateDate.setDate(candidateDate.getDate() + dayOffset);
+		candidateDate.setSeconds(0, 0);
+		const periods = dayPeriods(schedule, candidateDate);
+		if (periods.length === 0) continue;
+		for (const period of periods) {
+			if (period.closed || !period.start_time) continue;
+			const start = atTimeOnDate(candidateDate, period.start_time);
+			if (!isWithinPeriodDates(period, start.getTime())) continue;
+			consider(start, periods);
+		}
+		for (const period of periods) {
+			if (!period.closed || !period.end_time) continue;
+			const reopen = atTimeOnDate(candidateDate, period.end_time);
+			if (!isWithinPeriodDates(period, reopen.getTime())) continue;
+			consider(reopen, periods);
+		}
+	}
+	return nextStartMs === null ? null : new Date(nextStartMs);
+};
+/** Whether `schedule` is in hours now, and until / next open. */
+const getScheduleWindow = (schedule, now = /* @__PURE__ */ new Date()) => {
+	if (schedule == null) return {
+		active: true,
+		until: null
+	};
+	const periods = dayPeriods(schedule, now);
+	if (isPeriodsActiveAt(periods, now)) return {
+		active: true,
+		until: getActiveUntil(periods, now)
+	};
+	return {
+		active: false,
+		next: getNextStart(schedule, now)
+	};
+};
+const isOnSchedule = (schedule, now) => {
+	return getScheduleWindow(schedule, now).active;
+};
+//#endregion
+//#region src/order/recommendations.ts
+const DEFAULT_RECOMMENDATION_TYPES = ["CROSS_SELL"];
+const linkedRecommendationIds = (pricing) => {
+	return [...pricing.recommendations_ids ?? [], ...(pricing.recommendations ?? []).map((link) => link.recommendation_id)];
+};
+const collectRecommendations = (config) => {
+	const { lines, lookup, quantity, types } = config;
+	if (quantity <= 0) return [];
+	const typeSet = new Set(types ?? DEFAULT_RECOMMENDATION_TYPES);
+	const roots = lines.filter((line) => line.parent_uid == null);
+	const fingerprints = roots.map((root) => computeLineFingerprint(root, lines));
+	const cartKeys = new Set(fingerprints);
+	const seenTargetIds = /* @__PURE__ */ new Set();
+	const products = [];
+	for (const root of roots) {
+		const source = lookup.productsById[root.id];
+		if (!source) continue;
+		for (const recommendationId of linkedRecommendationIds(source.pricing)) {
+			const recommendation = lookup.recommendationsById[recommendationId];
+			if (!recommendation || !typeSet.has(recommendation.type)) continue;
+			const targetId = recommendation.target_product_id;
+			if (seenTargetIds.has(targetId)) continue;
+			if (cartKeys.has(bareProductFingerprint(targetId))) continue;
+			const target = lookup.productsById[targetId];
+			if (!target || target.status !== "ACTIVE") continue;
+			if (!isOnSchedule(target.availability.schedules)) continue;
+			seenTargetIds.add(targetId);
+			products.push(target);
+			if (products.length >= quantity) return products;
+		}
+	}
+	return products;
+};
+//#endregion
+//#region src/order/totals.ts
+/** Sum root line group totals into order totals (Big.js). */
+const recomputeTotals = (lines, currency = "USD") => {
+	let subtotal = new Big(0);
+	let discountTotal = new Big(0);
+	let taxTotal = new Big(0);
+	let total = new Big(0);
+	for (const line of lines) {
+		if (line.parent_uid != null) continue;
+		subtotal = subtotal.plus(line.group_subtotal);
+		discountTotal = discountTotal.plus(line.group_discount);
+		taxTotal = taxTotal.plus(line.group_tax_total);
+		total = total.plus(line.group_total);
+	}
+	let taxRate = 0;
+	let discountRate = 0;
+	if (subtotal.gt(0)) {
+		taxRate = taxTotal.div(subtotal).toNumber();
+		discountRate = discountTotal.div(subtotal).toNumber();
+	}
+	const discount_total = discountTotal.toNumber();
+	const tax_total = taxTotal.toNumber();
+	const b1 = {
+		currency,
+		subtotal: subtotal.toNumber()
+	};
+	const b2 = {
+		discount_rate: discountRate,
+		discount_total
+	};
+	const b3 = {
+		tax_rate: taxRate,
+		tax_total,
+		total: total.toNumber()
+	};
+	return {
+		...b1,
+		...b2,
+		...b3
+	};
+};
+const emptyTotals = (currency = "USD") => {
+	const b1 = {
+		currency,
+		subtotal: 0,
+		discount_rate: 0,
+		discount_total: 0
+	};
+	const b2 = {
+		tax_rate: 0,
+		tax_total: 0,
+		total: 0
+	};
+	return {
+		...b1,
+		...b2
+	};
+};
+//#endregion
+//#region src/order/redemptions.ts
+const ORDER_KEY = "ORDER";
+const buildPaymentRedeem = (input) => {
+	const { reward_id, quantity, payment_id, amount, points } = input;
+	if (amount === void 0 || !(amount > 0)) throw new Error("Redeem with payment_id requires amount > 0");
+	if (points === void 0 || !(points >= 0)) throw new Error("Redeem with payment_id requires points ≥ 0");
+	const redeem = {
+		reward_id,
+		quantity,
+		payment_id,
+		amount
+	};
+	redeem.points = points;
+	if (input.program !== void 0) redeem.program = input.program;
+	if (input.expires_at !== void 0) redeem.expires_at = input.expires_at;
+	return redeem;
+};
+/** Same rules as `vOrders.redeem()`; throws on invalid input. */
+const buildRedeem = (input) => {
+	const { reward_id, quantity, discount_rate, discount_amount } = input;
+	const { before_taxes, expires_at } = input;
+	if (!reward_id.trim()) throw new Error("Redeem requires reward_id");
+	if (!Number.isInteger(quantity) || quantity < 1) throw new Error("Redeem quantity must be an integer ≥ 1");
+	if (expires_at !== void 0 && Number.isNaN(Date.parse(expires_at))) throw new Error("Redeem expires_at must be an ISO datetime");
+	if (input.payment_id) return buildPaymentRedeem(input);
+	if (discount_rate === void 0 && discount_amount === void 0) throw new Error("Redeem requires discount_rate or discount_amount");
+	const rate = discount_rate ?? 0;
+	if (!(rate >= 0 && rate <= 1)) throw new Error("Redeem discount_rate must be between 0 and 1");
+	if (discount_amount !== void 0 && !(discount_amount > 0)) throw new Error("Redeem discount_amount must be > 0");
+	const redeem = {
+		reward_id,
+		quantity
+	};
+	if (discount_rate !== void 0) redeem.discount_rate = discount_rate;
+	if (discount_amount !== void 0) redeem.discount_amount = discount_amount;
+	if (before_taxes !== void 0) redeem.before_taxes = before_taxes;
+	if (expires_at !== void 0) redeem.expires_at = expires_at;
+	return redeem;
+};
+/** Payment redeems hold totals, so the kept units keep their share. */
+const keepUnits = (item, rest) => {
+	if (!isPaymentRedeem(item) || rest === item.quantity) return {
+		...item,
+		quantity: rest
+	};
+	const ratio = new Big(rest).div(item.quantity);
+	const amount = new Big(item.amount ?? 0).times(ratio).round(6).toNumber();
+	const points = new Big(item.points ?? 0).times(ratio).round(0).toNumber();
+	return {
+		...item,
+		quantity: rest,
+		amount,
+		points
+	};
+};
+/**
+* Takes `quantity` units of `reward_id` off the latest entries first, so the
+* earlier redeems keep their step position. Entries that reach 0 are removed.
+*/
+const subtractRedeem = (items, reward_id, quantity) => {
+	if (!Number.isInteger(quantity) || quantity < 1) throw new Error("Redeem quantity must be an integer ≥ 1");
+	let pending = quantity;
+	const kept = [];
+	for (let i = items.length - 1; i >= 0; i--) {
+		const item = items[i];
+		if (pending === 0 || item.reward_id !== reward_id) {
+			kept.unshift(item);
+			continue;
+		}
+		const taken = Math.min(item.quantity, pending);
+		pending -= taken;
+		const rest = item.quantity - taken;
+		if (rest > 0) kept.unshift(keepUnits(item, rest));
+	}
+	return kept;
+};
+const redemptionTargetKey = (target) => {
+	if (target.target === "ORDER") return ORDER_KEY;
+	return `LINE:${target.target_id ?? ""}`;
+};
+/**
+* Only root lines own redeems; child-line redeems are never applied.
+* Payment redeems are skipped on lines and on the order alike.
+*/
+const redeemPools = (lines, redeem) => {
+	const pools = /* @__PURE__ */ new Map();
+	for (const line of lines) {
+		const items = discountRedeems(line.redeem ?? []);
+		if (line.parent_uid != null || items.length === 0) continue;
+		const target = {
+			target: "LINE",
+			target_id: line.uid
+		};
+		const pool = items.map((item) => ({
+			...target,
+			redeem: item
+		}));
+		pools.set(redemptionTargetKey(target), pool);
+	}
+	const order = { target: "ORDER" };
+	const pool = discountRedeems(redeem).map((item) => ({
+		...order,
+		redeem: item
+	}));
+	pools.set(ORDER_KEY, pool);
+	return pools;
+};
+/**
+* Pairs the k-th step of a target with the k-th redeem of that target, in
+* step order. Steps without a matching redeem are dropped; redeems without a
+* step are appended (lines first, then order).
+*/
+const sequenceRedeems = (lines, redeem, steps) => {
+	const pools = redeemPools(lines, redeem);
+	const cursors = /* @__PURE__ */ new Map();
+	const sequence = [];
+	for (const step of steps) {
+		const key = redemptionTargetKey(step);
+		const at = cursors.get(key) ?? 0;
+		const next = pools.get(key)?.[at];
+		if (!next || next.redeem.reward_id !== step.reward_id) continue;
+		cursors.set(key, at + 1);
+		sequence.push(next);
+	}
+	for (const [key, pool] of pools) sequence.push(...pool.slice(cursors.get(key) ?? 0));
+	return sequence;
+};
+const minBig = (a, b) => {
+	return a.lt(b) ? a : b;
+};
+const rateOf = (discount, base) => {
+	if (base.lte(0)) return 0;
+	return minBig(discount.div(base), new Big(1)).toNumber();
+};
+const snapshot = (roots, quantity) => {
+	let subtotal = new Big(0);
+	let total = new Big(0);
+	let discount = new Big(0);
+	for (const root of roots) {
+		subtotal = subtotal.plus(root.subtotal);
+		total = total.plus(root.total);
+		discount = discount.plus(root.discount);
+	}
+	const b1 = {
+		value: total.toNumber(),
+		quantity
+	};
+	const b2 = { discount_amount: discount.toNumber() };
+	const b3 = { discount_rate: rateOf(discount, subtotal) };
+	return {
+		...b1,
+		...b2,
+		...b3
+	};
+};
+const netOf = (root) => {
+	const net = root.total.minus(root.tax);
+	return net.gt(0) ? net : new Big(0);
+};
+/** What a redeem can still discount on a root: pre-tax or with taxes. */
+const baseOf = (root, beforeTaxes) => {
+	return beforeTaxes ? netOf(root) : root.total;
+};
+/** Before taxes, taxes shrink with the pre-tax value they were charged on. */
+const discountRoot = (root, amount, beforeTaxes) => {
+	if (amount.lte(0)) return;
+	root.discount = root.discount.plus(amount);
+	if (!beforeTaxes) {
+		root.total = root.total.minus(amount);
+		return;
+	}
+	const net = netOf(root);
+	const nextNet = net.minus(amount);
+	root.tax = root.tax.times(nextNet).div(net);
+	root.total = nextNet.plus(root.tax);
+};
+/** Splits an order discount across roots by what each can still discount. */
+const discountOrder = (roots, amount, beforeTaxes) => {
+	const bases = roots.map((root) => baseOf(root, beforeTaxes));
+	const sum = bases.reduce((acc, base) => acc.plus(base), new Big(0));
+	if (sum.lte(0) || amount.lte(0)) return;
+	let last = -1;
+	bases.forEach((base, index) => {
+		if (base.gt(0)) last = index;
+	});
+	let rest = amount;
+	roots.forEach((root, index) => {
+		const base = bases[index];
+		if (base.lte(0)) return;
+		const share = amount.times(base).div(sum);
+		const part = minBig(index === last ? rest : share, base);
+		rest = rest.minus(part);
+		discountRoot(root, part, beforeTaxes);
+	});
+};
+/**
+* Rate compounds once per reward unit over the remaining value; amount is
+* per unit. With both, the rate discount is capped at `amount × quantity`.
+*/
+const redeemDiscount = (redeem, remaining) => {
+	const { quantity, discount_rate, discount_amount } = redeem;
+	let cap = null;
+	if (discount_amount !== void 0) cap = new Big(discount_amount).times(quantity);
+	if (discount_rate === void 0) return cap ?? new Big(0);
+	const kept = new Big(1).minus(discount_rate).pow(quantity);
+	const byRate = remaining.times(new Big(1).minus(kept));
+	return cap ? minBig(byRate, cap) : byRate;
+};
+/**
+* Root group money rebuilt from the line itself plus its children, i.e. the
+* menu price before any redemption. Child lines are never discounted.
+*/
+const stripRedemptionLines = (lines) => {
+	const children = /* @__PURE__ */ new Map();
+	for (const line of lines) {
+		if (line.parent_uid == null) continue;
+		const list = children.get(line.parent_uid) ?? [];
+		list.push(line);
+		children.set(line.parent_uid, list);
+	}
+	return lines.map((line) => {
+		if (line.parent_uid != null) return line;
+		const qty = new Big(line.quantity);
+		let sub = new Big(0);
+		let disc = new Big(0);
+		let tax = new Big(0);
+		let tot = new Big(0);
+		for (const child of children.get(line.uid) ?? []) {
+			sub = sub.plus(child.group_subtotal);
+			disc = disc.plus(child.group_discount);
+			tax = tax.plus(child.group_tax_total);
+			tot = tot.plus(child.group_total);
+		}
+		const gSub = new Big(line.subtotal).plus(sub.times(qty));
+		const gDisc = new Big(line.discount_total).plus(disc.times(qty));
+		const gTax = new Big(line.tax_total).plus(tax.times(qty));
+		const gTot = new Big(line.total).plus(tot.times(qty));
+		const u1 = { unit_group_subtotal: gSub.div(qty).toNumber() };
+		const u2 = { unit_group_discount: gDisc.div(qty).toNumber() };
+		const u3 = { unit_group_tax_total: gTax.div(qty).toNumber() };
+		const u4 = { unit_group_total: gTot.div(qty).toNumber() };
+		const g1 = { group_subtotal: gSub.toNumber() };
+		const g2 = { group_discount: gDisc.toNumber() };
+		const g3 = { group_tax_total: gTax.toNumber() };
+		const g4 = { group_total: gTot.toNumber() };
+		const p1 = {
+			...u1,
+			...u2,
+			...u3,
+			...u4
+		};
+		return {
+			...line,
+			...p1,
+			...g1,
+			...g2,
+			...g3,
+			...g4
+		};
+	});
+};
+const withRootMoney = (line, money) => {
+	const qty = new Big(line.quantity);
+	const discount = new Big(line.group_discount).plus(money.discount);
+	const u1 = { unit_group_discount: discount.div(qty).toNumber() };
+	const u2 = { unit_group_tax_total: money.tax.div(qty).toNumber() };
+	const u3 = { unit_group_total: money.total.div(qty).toNumber() };
+	const g1 = { group_discount: discount.toNumber() };
+	const g2 = { group_tax_total: money.tax.toNumber() };
+	const g3 = { group_total: money.total.toNumber() };
+	return {
+		...line,
+		...u1,
+		...u2,
+		...u3,
+		...g1,
+		...g2,
+		...g3
+	};
+};
+/**
+* Replays every redeem in persisted step order over the root lines' group
+* money. Line redeems discount their root; order redeems are prorated over
+* every root. A discount never exceeds what is left on its target.
+*/
+const replayRedemptions = (lines, redeem, steps) => {
+	const base = stripRedemptionLines(lines);
+	const sequence = sequenceRedeems(base, redeem, steps);
+	const moneyByUid = /* @__PURE__ */ new Map();
+	for (const line of base) {
+		if (line.parent_uid != null) continue;
+		const b1 = { quantity: line.quantity };
+		const b2 = { subtotal: new Big(line.group_subtotal) };
+		const b3 = { tax: new Big(line.group_tax_total) };
+		const b4 = {
+			total: new Big(line.group_total),
+			discount: new Big(0)
+		};
+		moneyByUid.set(line.uid, {
+			...b1,
+			...b2,
+			...b3,
+			...b4
+		});
+	}
+	const roots = [...moneyByUid.values()];
+	const redemption_steps = sequence.map((item) => {
+		const id = item.target_id;
+		const root = id ? moneyByUid.get(id) : void 0;
+		const beforeTaxes = item.redeem.before_taxes ?? true;
+		const before = snapshot(roots, 1);
+		const targetBefore = root ? snapshot([root], root.quantity) : void 0;
+		let left = new Big(0);
+		if (root) left = baseOf(root, beforeTaxes);
+		else for (const r of roots) left = left.plus(baseOf(r, beforeTaxes));
+		const raw = redeemDiscount(item.redeem, left);
+		const discount = minBig(raw, left);
+		if (root) discountRoot(root, discount, beforeTaxes);
+		else discountOrder(roots, discount, beforeTaxes);
+		const action = discount.gt(0) ? "UPDATE" : "READ";
+		const { reward_id, quantity } = item.redeem;
+		const b1 = {
+			reward_id,
+			reward_quantity: quantity,
+			target: item.target
+		};
+		const b2 = id ? { target_id: id } : {};
+		const b3 = {
+			action,
+			discount_amount: discount.toNumber()
 		};
-		const extra = terminal.extra?.find((item) => item.key === key)?.run;
-		const operation = named[key] ?? extra;
-		if (!operation) return {
-			ok: false,
-			message: `Unknown operation ${key}`
+		const b4 = {
+			before,
+			after: snapshot(roots, 1)
 		};
-		const signal = new AbortController().signal;
-		const reference = createAttemptReference();
-		const result = await operation(toTerminalContext(await this.buildContext(payment, 0, reference, signal))).catch(toFailure);
-		if (!result.ok) await this.reportTerminal(payment, key, result);
-		return result;
-	}
-	async reportTerminal(payment, operation, result) {
-		const fallback = createPaymentError("UNKNOWN");
-		const error = result.error ?? {
-			...fallback,
-			message: result.message ?? fallback.message
+		let b5 = {};
+		if (root) b5 = {
+			target_before: targetBefore,
+			target_after: snapshot([root], root.quantity)
 		};
-		const body = {
-			operation,
-			device_id: this.options.deviceId ?? null,
-			error
+		return {
+			...b1,
+			...b2,
+			...b3,
+			...b4,
+			...b5
 		};
-		const report = services.payments.terminalFailure;
-		await report(payment.id, body, this.deps.http).catch(() => void 0);
-	}
-};
-//#endregion
-//#region src/schedule/schedule.ts
-const DAY_OF_WEEK = [
-	"sunday",
-	"monday",
-	"tuesday",
-	"wednesday",
-	"thursday",
-	"friday",
-	"saturday"
-];
-const timeToMinutes = (time) => {
-	const [hours = "0", minutes = "0"] = time.split(":");
-	return Number(hours) * 60 + Number(minutes);
-};
-const hasSpecificDates = (period) => {
-	return period.start_date != null && period.end_date != null;
-};
-const periodCoversDate = (period, now) => {
-	if (!hasSpecificDates(period)) return false;
-	const nowMs = now.getTime();
-	const startMs = Date.parse(period.start_date);
-	const endMs = Date.parse(period.end_date);
-	if (Number.isNaN(startMs) || Number.isNaN(endMs)) return false;
-	return startMs <= nowMs && nowMs <= endMs;
-};
-const timeMatches = (period, now) => {
-	if (!period.start_time || !period.end_time) return false;
-	const nowMinutes = now.getHours() * 60 + now.getMinutes();
-	const start = timeToMinutes(period.start_time);
-	const end = timeToMinutes(period.end_time);
-	return nowMinutes >= start && nowMinutes < end;
-};
-const isClosedAt = (period, now) => {
-	if (!period.closed) return false;
-	if (!period.start_time || !period.end_time) return true;
-	return timeMatches(period, now);
-};
-const isOpenAt = (period, now) => {
-	if (period.closed) return false;
-	return timeMatches(period, now);
-};
-const isPeriodsActiveAt = (periods, now) => {
-	return getOpenPeriodAt(periods, now) != null;
-};
-const getOpenPeriodAt = (periods, now) => {
-	if (periods.length === 0) return null;
-	const coveringSpecific = periods.filter((period) => {
-		return periodCoversDate(period, now);
 	});
-	const fallback = periods.filter((period) => !hasSpecificDates(period));
-	const specificOpens = coveringSpecific.filter((period) => !period.closed);
-	if (coveringSpecific.filter((period) => period.closed).some((period) => isClosedAt(period, now))) return null;
-	if (specificOpens.length > 0) return specificOpens.find((period) => isOpenAt(period, now)) ?? null;
-	if (fallback.some((period) => isClosedAt(period, now))) return null;
-	return fallback.filter((period) => !period.closed).find((period) => isOpenAt(period, now)) ?? null;
-};
-const atTimeOnDate = (day, time) => {
-	const [hours = "0", minutes = "0"] = time.split(":");
-	const next = new Date(day);
-	next.setHours(Number(hours), Number(minutes), 0, 0);
-	return next;
-};
-const isWithinPeriodDates = (period, instantMs) => {
-	if (!hasSpecificDates(period)) return true;
-	const startMs = Date.parse(period.start_date);
-	const endMs = Date.parse(period.end_date);
-	if (Number.isNaN(startMs) || Number.isNaN(endMs)) return false;
-	return startMs <= instantMs && instantMs <= endMs;
-};
-const dayPeriods = (schedule, instant) => {
-	const day = DAY_OF_WEEK[instant.getDay()];
-	if (!day) return [];
-	return schedule.find((row) => row.day_of_week === day)?.periods ?? [];
-};
-const getActiveUntil = (periods, now) => {
-	const open = getOpenPeriodAt(periods, now);
-	if (!open?.end_time) return null;
-	let untilMs = atTimeOnDate(now, open.end_time).getTime();
-	const openIsSpecific = hasSpecificDates(open);
-	for (const period of periods) {
-		if (!period.closed || !period.start_time) continue;
-		const closeMs = atTimeOnDate(now, period.start_time).getTime();
-		if (closeMs <= now.getTime() || closeMs >= untilMs) continue;
-		if (!isWithinPeriodDates(period, closeMs)) continue;
-		if (!hasSpecificDates(period) && openIsSpecific) continue;
-		untilMs = closeMs;
-	}
-	return new Date(untilMs);
-};
-const getNextStart = (schedule, now) => {
-	const nowMs = now.getTime();
-	let nextStartMs = null;
-	const consider = (candidate, periods) => {
-		const startMs = candidate.getTime();
-		if (startMs <= nowMs) return;
-		if (!isPeriodsActiveAt(periods, candidate)) return;
-		if (nextStartMs === null || startMs < nextStartMs) nextStartMs = startMs;
+	return {
+		lines: base.map((line) => {
+			const money = moneyByUid.get(line.uid);
+			if (!money || money.discount.eq(0)) return line;
+			return withRootMoney(line, money);
+		}),
+		redemption_steps
 	};
-	for (let dayOffset = 0; dayOffset < 8; dayOffset += 1) {
-		const candidateDate = new Date(now);
-		candidateDate.setDate(candidateDate.getDate() + dayOffset);
-		candidateDate.setSeconds(0, 0);
-		const periods = dayPeriods(schedule, candidateDate);
-		if (periods.length === 0) continue;
-		for (const period of periods) {
-			if (period.closed || !period.start_time) continue;
-			const start = atTimeOnDate(candidateDate, period.start_time);
-			if (!isWithinPeriodDates(period, start.getTime())) continue;
-			consider(start, periods);
-		}
-		for (const period of periods) {
-			if (!period.closed || !period.end_time) continue;
-			const reopen = atTimeOnDate(candidateDate, period.end_time);
-			if (!isWithinPeriodDates(period, reopen.getTime())) continue;
-			consider(reopen, periods);
-		}
-	}
-	return nextStartMs === null ? null : new Date(nextStartMs);
 };
-/** Whether `schedule` is in hours now, and until / next open. */
-const getScheduleWindow = (schedule, now = /* @__PURE__ */ new Date()) => {
-	if (schedule == null) return {
-		active: true,
-		until: null
-	};
-	const periods = dayPeriods(schedule, now);
-	if (isPeriodsActiveAt(periods, now)) return {
-		active: true,
-		until: getActiveUntil(periods, now)
-	};
+/** Discounted lines, steps and totals, keeping step order. */
+const recomputeRedemptions = (input) => {
+	const { redeem, currency } = input;
+	const steps = input.redemption_steps;
+	const { lines, redemption_steps } = replayRedemptions(input.lines, redeem, steps);
 	return {
-		active: false,
-		next: getNextStart(schedule, now)
+		lines,
+		redemption_steps,
+		totals: recomputeTotals(lines, currency)
 	};
 };
-const isOnSchedule = (schedule, now) => {
-	return getScheduleWindow(schedule, now).active;
-};
-//#endregion
-//#region src/order/recommendations.ts
-const DEFAULT_RECOMMENDATION_TYPES = ["CROSS_SELL"];
-const linkedRecommendationIds = (pricing) => {
-	return [...pricing.recommendations_ids ?? [], ...(pricing.recommendations ?? []).map((link) => link.recommendation_id)];
-};
-const collectRecommendations = (config) => {
-	const { lines, lookup, quantity, types } = config;
-	if (quantity <= 0) return [];
-	const typeSet = new Set(types ?? DEFAULT_RECOMMENDATION_TYPES);
-	const roots = lines.filter((line) => line.parent_uid == null);
-	const fingerprints = roots.map((root) => computeLineFingerprint(root, lines));
-	const cartKeys = new Set(fingerprints);
-	const seenTargetIds = /* @__PURE__ */ new Set();
-	const products = [];
-	for (const root of roots) {
-		const source = lookup.productsById[root.id];
-		if (!source) continue;
-		for (const recommendationId of linkedRecommendationIds(source.pricing)) {
-			const recommendation = lookup.recommendationsById[recommendationId];
-			if (!recommendation || !typeSet.has(recommendation.type)) continue;
-			const targetId = recommendation.target_product_id;
-			if (seenTargetIds.has(targetId)) continue;
-			if (cartKeys.has(bareProductFingerprint(targetId))) continue;
-			const target = lookup.productsById[targetId];
-			if (!target || target.status !== "ACTIVE") continue;
-			if (!isOnSchedule(target.availability.schedules)) continue;
-			seenTargetIds.add(targetId);
-			products.push(target);
-			if (products.length >= quantity) return products;
-		}
-	}
-	return products;
-};
 //#endregion
 //#region src/order/Order.ts
 const cloneOrder = (order) => {
 	return structuredClone(order);
 };
+const redeemSignature$1 = (items) => {
+	return items.map((item) => {
+		return `${`${item.reward_id}:${item.quantity}:${item.payment_id ?? ""}`}:${`${item.amount ?? ""}:${item.points ?? ""}`}:${`${item.discount_rate ?? ""}:${item.discount_amount ?? ""}`}`;
+	}).join("|");
+};
 const buildHttpOptions = (options) => {
 	return {
 		baseUrl: options.baseUrl,
@@ -5279,22 +5293,30 @@ var Order = class Order {
 	listeners = /* @__PURE__ */ new Set();
 	externalNotify;
 	http;
+	debounceMs;
 	flush;
 	payments;
 	/** Real tenders chosen with `setTenders`; REDEMPTION ones come from redeem. */
 	realTenders = null;
 	redemptionProviders = /* @__PURE__ */ new Map();
+	/**
+	* Redeems as applied, before the D18 cap trims payment amounts. The cap
+	* is re-derived from these on every edit, so a redeem trimmed while the
+	* total was low recovers its amount once the total grows back.
+	*/
+	requestedRedeem = null;
 	constructor(config, notify) {
 		this.draft = cloneOrder(config.order);
 		this.synced = cloneOrder(config.order);
 		this.rememberLogScope();
 		this.persisted = config.persisted;
 		this.http = config.http;
+		this.debounceMs = config.debounceMs;
 		this.externalNotify = notify;
 		this.flush = createFlushController({
 			getDraft: () => this.draft,
 			setDraft: (next) => {
-				this.draft = next;
+				this.replaceDraft(next);
 			},
 			getSynced: () => this.synced,
 			setSynced: (next) => {
@@ -5314,11 +5336,7 @@ var Order = class Order {
 		this.payments = new PaymentSession({
 			getOrder: () => this.draft,
 			placeOrder: (input) => this.placeOrder(input),
-			applyOrder: (next) => {
-				this.draft = cloneOrder(next);
-				this.synced = cloneOrder(next);
-				this.notify();
-			},
+			applyOrder: (next) => this.applyServerOrder(next),
 			http: this.http
 		});
 	}
@@ -5496,7 +5514,7 @@ var Order = class Order {
 		if (isPaymentRedeem(redeem) && line_uid !== void 0) throw new Error("Points / balance redeems apply to the whole order");
 		if (redeem.payment_id && provider) this.redemptionProviders.set(redeem.payment_id, provider);
 		if (line_uid === void 0) {
-			this.commitLines({ redeem: [...this.draft.redeem ?? [], redeem] });
+			this.commitLines({ redeem: [...this.appliedRedeem(), redeem] });
 			return;
 		}
 		const line = this.draft.lines.find((item) => item.uid === line_uid);
@@ -5522,7 +5540,7 @@ var Order = class Order {
 		const { reward_id, quantity, line_uid } = input;
 		if (line_uid === void 0) {
 			const p = [
-				this.draft.redeem ?? [],
+				this.appliedRedeem(),
 				reward_id,
 				quantity
 			];
@@ -5620,6 +5638,32 @@ var Order = class Order {
 		this.deleted = true;
 		this.notify();
 	}
+	/**
+	* Reopens this placed, unpaid order: the server voids every payment
+	* (REDEMPTION points released), cancels it as `VOIDED` and opens a new
+	* `OPEN` order with the same content. This instance is closed afterwards;
+	* replace it with the returned `Order` (same HTTP options and listener).
+	*
+	* Rejects with `StorefrontHttpError` 400 and
+	* `details.code: "ORDER_PAYMENT_CAPTURED"` when a payment was already
+	* captured; nothing changes then and this instance stays usable.
+	*/
+	async reopen() {
+		if (!this.persisted) throw new Error("Only a placed order is reopened");
+		this.flush.cancel();
+		const c1 = {
+			order: await services.orders.reopen(this.draft.id, this.http),
+			http: this.http,
+			debounceMs: this.debounceMs
+		};
+		const reopened = new Order({
+			...c1,
+			persisted: true
+		}, this.externalNotify);
+		this.deleted = true;
+		this.notify();
+		return reopened;
+	}
 	async refundOrder() {
 		if (this.deleted) return;
 		this.flush.cancel();
@@ -5659,13 +5703,17 @@ var Order = class Order {
 		};
 		await services.orders.validate(body, this.http);
 	}
-	/** Tenders of the next intent: real ones plus one per payment redeem. */
+	/**
+	* Tenders of the next intent: real ones plus one per payment redeem.
+	* When the payment redeems cover the total, only REDEMPTION tenders.
+	*/
 	getTenders(payment) {
-		const simple = payment ? simpleTenderInput(payment) : null;
-		const real = simple ? [simple] : this.realTenders ?? [];
 		const redeem = this.draft.redeem ?? [];
 		const providers = this.redemptionProviders;
-		return [...real, ...redemptionTenderInputs(redeem, providers)];
+		const redemption = redemptionTenderInputs(redeem, providers);
+		if (paymentRedeemsCoverTotal(redeem, this.draft.totals)) return redemption;
+		const simple = payment ? simpleTenderInput(payment) : null;
+		return [...simple ? [simple] : this.realTenders ?? [], ...redemption];
 	}
 	/**
 	* Chooses the real tenders (with allocation for mixed payments) and saves
@@ -5696,10 +5744,18 @@ var Order = class Order {
 		return this.getOrder();
 	}
 	applyServerOrder(next) {
-		this.draft = cloneOrder(next);
+		this.replaceDraft(cloneOrder(next));
 		this.synced = cloneOrder(next);
 		this.notify();
 	}
+	/** Keeps the applied redeems while the server holds the same capped ones. */
+	replaceDraft(next) {
+		if (redeemSignature$1(this.draft.redeem ?? []) !== redeemSignature$1(next.redeem ?? [])) this.requestedRedeem = null;
+		this.draft = next;
+	}
+	appliedRedeem() {
+		return this.requestedRedeem ?? this.draft.redeem ?? [];
+	}
 	/**
 	* Places the order with a DRAFT intent: `intent_id` as is, else the
 	* tenders of `getTenders(input.payment)` saved first (simple flow: one
@@ -5825,7 +5881,7 @@ var Order = class Order {
 	/** Applies lines/redeem, replaying redemption steps and totals. */
 	commitLines(patch) {
 		const patched = patch.lines ?? this.draft.lines;
-		const applied = patch.redeem ?? this.draft.redeem ?? [];
+		const applied = patch.redeem ?? this.appliedRedeem();
 		const steps = this.draft.redemption_steps ?? [];
 		const currency = this.draft.totals.currency;
 		const { lines, redemption_steps, totals } = recomputeRedemptions({
@@ -5838,6 +5894,7 @@ var Order = class Order {
 			lines,
 			totals
 		}), currency);
+		this.requestedRedeem = applied;
 		this.draft = {
 			...this.draft,
 			lines,
@@ -6401,7 +6458,10 @@ const redeemSignature = (items) => {
 const stepSignature = (steps) => {
 	return steps.map((step) => `${step.reward_id}:${step.reward_quantity}`).join(",");
 };
-/** Every target's redeems must have one step each, in the same order. */
+/**
+* Every target's discount redeems must have one step each, in the same
+* order. Payment redeems are a REDEMPTION tender, never a step (D16).
+*/
 const checkRedemptionTargets = (lines, redeem, steps, issues, lineIssues) => {
 	const byTarget = /* @__PURE__ */ new Map();
 	for (const step of steps) {
@@ -6411,7 +6471,7 @@ const checkRedemptionTargets = (lines, redeem, steps, issues, lineIssues) => {
 	const check = (key, items) => {
 		const targetSteps = byTarget.get(key) ?? [];
 		byTarget.delete(key);
-		const expected = redeemSignature(items);
+		const expected = redeemSignature(discountRedeems(items));
 		const actual = stepSignature(targetSteps);
 		if (expected === actual) return null;
 		return {