@fire-spark/core 0.12.4 → 0.13.0

package/dist/index.d.ts

@@ -216,8 +216,32 @@ type OrderCustomerSource = {
   email?: string | null;
   phone?: string | null;
 };
+/**
+ * Stand-ins the order schema needs while a guest's contact data is unknown.
+ * Only valid when the merchant's `anonymous_customer` field is optional or
+ * hidden; the API rejects them on required fields (`CUSTOMER_FIELD_REQUIRED`).
+ */
+declare const CUSTOMER_INFO_PLACEHOLDERS: {
+  readonly email: "unknown@example.com";
+  readonly phone: "+10000000000";
+};
 /** Builds the order `customer` snapshot sent on create/update. */
 declare const buildCustomerSnapshot: (source: OrderCustomerSource) => Order$1["customer"];
+/**
+ * True when `value` is a stand-in, not data the guest typed: the
+ * placeholders above, or a name equal to the anonymous customer id.
+ */
+declare const isCustomerInfoPlaceholder: (key: string, value: unknown, customerId?: string | null) => boolean;
+/** A `customer_info` field holds real (non-placeholder) guest data. */
+declare const isCustomerInfoFieldFilled: (info: Record<string, unknown> | null | undefined, key: string, customerId?: string | null) => boolean;
+/** Strips spaces, dashes, dots and parentheses: "+593 99-123" → "+59399123". */
+declare const normalizeCustomerPhone: (value: string) => string;
+/**
+ * Format check the order schema enforces on `customer_info`: email shape and
+ * E.164 phone (`+593991234567`). Empty values are valid (presence is checked
+ * against the merchant's `anonymous_customer` modes instead).
+ */
+declare const isCustomerInfoValueValid: (key: string, value: string) => boolean;
 //#endregion
 //#region src/services/http.d.ts
 type ServiceHttpOptions = {
@@ -620,6 +644,8 @@ declare class Order {
   setCustomerDetails(details: {
     address_info?: Order$1["customer"]["address_info"];
     billing_info?: Order$1["customer"]["billing_info"];
+    /** Guest contact data (anonymous checkout); blanks keep the snapshot. */
+    customer_info?: Partial<Order$1["customer"]["customer_info"]>;
   }): void;
   cancelOrder(): Promise<void>;
   /**
@@ -824,7 +850,7 @@ declare const isOrderPaymentRequiredError: (error: unknown) => error is OrderPay
 //#endregion
 //#region src/order/validate.d.ts
 type OrderLineIssueCode = "PRODUCT_NOT_FOUND" | "HIDDEN" | "OUT_OF_STOCK" | "OUTSIDE_HOURS" | "MODIFIER_NOT_FOUND" | "MODIFIER_RULES_INVALID" | "VARIANT_BASE_NOT_ORDERABLE" | "VARIANT_NOT_OFFERED" | "PRICE_MISMATCH" | "TAX_MISMATCH" | "DISCOUNT_MISMATCH" | "QUANTITY_MISMATCH" | "QUANTITY_BELOW_MINIMUM" | "QUANTITY_ABOVE_MAXIMUM" | "STRUCTURE_MISMATCH" | "FEE_MISMATCH" | "REDEEM_EXPIRED" | RedeemIssueCode;
-type OrderIssueCode = "NO_MENU" | "MENU_CLOSED" | "SCOPE_INACTIVE" | "TOTALS_MISMATCH" | "REDEEM_EXPIRED" | RedeemIssueCode | "REDEMPTION_STEPS_MISMATCH" | "REDEMPTION_MISMATCH" | "EMPTY_ORDER" | "ITEMS_BELOW_MINIMUM" | "ITEMS_ABOVE_MAXIMUM" | "TOTAL_BELOW_MINIMUM" | "TOTAL_ABOVE_MAXIMUM" | "REDEEMS_ABOVE_MAXIMUM" | "REDEEMS_TOTAL_ABOVE_MAXIMUM" | "SHIPPING_REQUIRED" | "BILLING_REQUIRED" | "SHIPPING_FIELD_REQUIRED" | "BILLING_FIELD_REQUIRED" | "DAILY_ORDER_LIMIT_REACHED";
+type OrderIssueCode = "NO_MENU" | "MENU_CLOSED" | "SCOPE_INACTIVE" | "TOTALS_MISMATCH" | "REDEEM_EXPIRED" | RedeemIssueCode | "REDEMPTION_STEPS_MISMATCH" | "REDEMPTION_MISMATCH" | "EMPTY_ORDER" | "ITEMS_BELOW_MINIMUM" | "ITEMS_ABOVE_MAXIMUM" | "TOTAL_BELOW_MINIMUM" | "TOTAL_ABOVE_MAXIMUM" | "REDEEMS_ABOVE_MAXIMUM" | "REDEEMS_TOTAL_ABOVE_MAXIMUM" | "SHIPPING_REQUIRED" | "BILLING_REQUIRED" | "SHIPPING_FIELD_REQUIRED" | "BILLING_FIELD_REQUIRED" | "CUSTOMER_FIELD_REQUIRED" | "DAILY_ORDER_LIMIT_REACHED";
 type OrderLineIssue = {
   code: OrderLineIssueCode;
   field?: string;
@@ -941,6 +967,7 @@ declare const capRedeems: <T extends CapOrder>(order: T) => T & {
     id: string;
     parent_uid: string | null;
     parent_id: string | null;
+    group_id?: string | undefined;
     name: string;
     image_url?: string | undefined;
     menu_id?: string | undefined;
@@ -1570,6 +1597,10 @@ interface CheckoutSection {
 interface CheckoutPreferences {
   shipping: CheckoutSection;
   billing: CheckoutSection;
+  /** Missing on orders stamped before the setting existed → defaults. */
+  anonymous_customer?: {
+    fields: Record<string, CheckoutMode>;
+  };
 }
 declare const isCheckoutFieldFilled: (info: Record<string, unknown> | null | undefined, key: string) => boolean;
 interface CheckoutOrderInput {
@@ -1674,4 +1705,4 @@ declare const validateCardholderName: (value: string) => CardholderNameError | n
  */
 declare const cardPreviewGroups: (value: string) => CardPreviewSlot[][];
 //#endregion
-export { type ApplyRedeemInput, type AuthConfigureOptions, CARD_BRANDS, type CardBrand, type CardBrandSpec, type CardCvcError, type CardExpiry, type CardExpiryError, type CardNumberError, type CardPreviewSlot, type CardholderNameError, type CreateOrderOptions, type CreateSessionOptions, type CustomizationPath, type CustomizationSession, DEFAULT_RECOMMENDATION_TYPES, type DeunaCallbackUrls, type DeunaOrderStatus, type ExchangeOptions, type FailedCharge, type FlatMenuCategory, type GenOrderIdOptions, type GroupDisplayType, ID_HASH_FORMATS, type IdBuilder, type IdHashFormat, type ListMenusStreamOptions, type ListPaymentsOptions, type Menu, type MenuCategoryNode, type MenuLookup, type MilestoneSteps, type MilestoneTrackItem, type ModifierControlType, type ModifierCtx, type ModifierGroupCtx, type NestedMenuCategory, Order, type OrderCancelInput, type OrderCancelOptions, type OrderCancelResult, type OrderCancelType, type OrderCustomerSource, type OrderDeviceCredential, type OrderDraft, type OrderIssue, type OrderIssueCode, type OrderLineDiff, type OrderLineIssue, type OrderLineIssueCode, OrderPaymentRequiredError, type OrderScope, OrderSyncPendingError, OrderSyncRejectedError, OrderValidationError, type OrderValidationResult, type PayIntentOptions, type PayIntentResult, type PayOptions, type PaymentCardBrand, type PaymentProgressEvent, type PaymentProgressListener, type PaymentRunOptions, type PaymentSessionOptions, type PricingModifier, type Product, type ProductCtx, type QuantitiesByPath, type RecommendationType, RecurringDateCron, type RedeemPaymentRow, type RemoveRedeemInput, type ReorderOrderOptions, type ResetOptions, type ReversalOutcome, type ReverseAllOptions, RulesEngine, type ScheduleWindow, type SelectionStatus, type SelectionsByPath, type SerializedError, type ServiceHttpOptions, type SimpleTenderPayment, type Snapshot, type StorefrontAccessToken, type StorefrontErrorDetails, StorefrontHttpError, type TrackWorkflow, type ValidateOptions, type ValidateOrderAgainstMenuInput, type Variant, type VariantGroup, type VariantGroupCtx, type VariantOptionCtx, type VariantSelection, type VerifyWebhookSignatureInput, type VisitedState, addLines, auth, buildCustomerSnapshot, cancelTypeOf, capRedeems, cappedRedeems, cardBrandSpec, cardDigits, cardNumberGaps, cardNumberMaxLength, cardPreviewGroups, caretAfterDigits, collectOrderLineDiffs, computeStartingPrice, countCartProducts, coveredAmount, createDeunaWidgetApi, createSession, currentNodes, cvcMaxLength, defaultConditionError, detectCardBrand, fitRedeems, flattenMenuCategories, flushLogs, formatCardNumber, formatCvc, formatExpiry, fromOrderLines, genId, genOrderId, getLogContext, getScheduleWindow, indexMenu, isCardNumberComplete, isCardNumberDefinitelyInvalid, isCheckoutFieldFilled, isCvcComplete, isDeviceCharged, isDeviceNotLinked, isExpiryComplete, isGenId, isKioskUnauthorized, isMilestoneStepDone, isOnSchedule, isOrderPaymentRequiredError, isOrderValidationError, isPosDeviceNotLinked, isPosUnauthorized, isRealPaymentMethod, isStorefrontNotFound, isVariantBase, linePayableTotal, listMenusStream, localizePosError, log, logError, luhnCheck, matchAbsoluteDateOperator, matchBooleanOperator, matchCurrencyOperator, matchEnumOperator, matchNumberOperator, matchRecurringDateOperator, matchRelativeDateOperator, matchStringOperator, milestoneSteps, milestoneTrack, nestMenuCategories, normalizeCardholderName, orderPayableTotal, orderRedeemedTotal, orderRedeems, parseExpiry, paymentMatchesClientConditions, rebuildRootGroups, recomputeTotals, redeemedTotal, redemptionCap, redemptionSteps, remainingAmount, removeLine, replaceLine, resolveCheckout, resolveModifierImageUrl, reversePayment, runPaymentAttempt, selectablePayments, serializeError, services, setLineQuantity, storefrontJson, toOrderLines, toPaymentCardBrand, validateCardNumber, validateCardholderName, validateCvc, validateExpiry, validateOrderAgainstMenu, verifyWebhookSignature, visitedStates };
+export { type ApplyRedeemInput, type AuthConfigureOptions, CARD_BRANDS, CUSTOMER_INFO_PLACEHOLDERS, type CardBrand, type CardBrandSpec, type CardCvcError, type CardExpiry, type CardExpiryError, type CardNumberError, type CardPreviewSlot, type CardholderNameError, type CreateOrderOptions, type CreateSessionOptions, type CustomizationPath, type CustomizationSession, DEFAULT_RECOMMENDATION_TYPES, type DeunaCallbackUrls, type DeunaOrderStatus, type ExchangeOptions, type FailedCharge, type FlatMenuCategory, type GenOrderIdOptions, type GroupDisplayType, ID_HASH_FORMATS, type IdBuilder, type IdHashFormat, type ListMenusStreamOptions, type ListPaymentsOptions, type Menu, type MenuCategoryNode, type MenuLookup, type MilestoneSteps, type MilestoneTrackItem, type ModifierControlType, type ModifierCtx, type ModifierGroupCtx, type NestedMenuCategory, Order, type OrderCancelInput, type OrderCancelOptions, type OrderCancelResult, type OrderCancelType, type OrderCustomerSource, type OrderDeviceCredential, type OrderDraft, type OrderIssue, type OrderIssueCode, type OrderLineDiff, type OrderLineIssue, type OrderLineIssueCode, OrderPaymentRequiredError, type OrderScope, OrderSyncPendingError, OrderSyncRejectedError, OrderValidationError, type OrderValidationResult, type PayIntentOptions, type PayIntentResult, type PayOptions, type PaymentCardBrand, type PaymentProgressEvent, type PaymentProgressListener, type PaymentRunOptions, type PaymentSessionOptions, type PricingModifier, type Product, type ProductCtx, type QuantitiesByPath, type RecommendationType, RecurringDateCron, type RedeemPaymentRow, type RemoveRedeemInput, type ReorderOrderOptions, type ResetOptions, type ReversalOutcome, type ReverseAllOptions, RulesEngine, type ScheduleWindow, type SelectionStatus, type SelectionsByPath, type SerializedError, type ServiceHttpOptions, type SimpleTenderPayment, type Snapshot, type StorefrontAccessToken, type StorefrontErrorDetails, StorefrontHttpError, type TrackWorkflow, type ValidateOptions, type ValidateOrderAgainstMenuInput, type Variant, type VariantGroup, type VariantGroupCtx, type VariantOptionCtx, type VariantSelection, type VerifyWebhookSignatureInput, type VisitedState, addLines, auth, buildCustomerSnapshot, cancelTypeOf, capRedeems, cappedRedeems, cardBrandSpec, cardDigits, cardNumberGaps, cardNumberMaxLength, cardPreviewGroups, caretAfterDigits, collectOrderLineDiffs, computeStartingPrice, countCartProducts, coveredAmount, createDeunaWidgetApi, createSession, currentNodes, cvcMaxLength, defaultConditionError, detectCardBrand, fitRedeems, flattenMenuCategories, flushLogs, formatCardNumber, formatCvc, formatExpiry, fromOrderLines, genId, genOrderId, getLogContext, getScheduleWindow, indexMenu, isCardNumberComplete, isCardNumberDefinitelyInvalid, isCheckoutFieldFilled, isCustomerInfoFieldFilled, isCustomerInfoPlaceholder, isCustomerInfoValueValid, isCvcComplete, isDeviceCharged, isDeviceNotLinked, isExpiryComplete, isGenId, isKioskUnauthorized, isMilestoneStepDone, isOnSchedule, isOrderPaymentRequiredError, isOrderValidationError, isPosDeviceNotLinked, isPosUnauthorized, isRealPaymentMethod, isStorefrontNotFound, isVariantBase, linePayableTotal, listMenusStream, localizePosError, log, logError, luhnCheck, matchAbsoluteDateOperator, matchBooleanOperator, matchCurrencyOperator, matchEnumOperator, matchNumberOperator, matchRecurringDateOperator, matchRelativeDateOperator, matchStringOperator, milestoneSteps, milestoneTrack, nestMenuCategories, normalizeCardholderName, normalizeCustomerPhone, orderPayableTotal, orderRedeemedTotal, orderRedeems, parseExpiry, paymentMatchesClientConditions, rebuildRootGroups, recomputeTotals, redeemedTotal, redemptionCap, redemptionSteps, remainingAmount, removeLine, replaceLine, resolveCheckout, resolveModifierImageUrl, reversePayment, runPaymentAttempt, selectablePayments, serializeError, services, setLineQuantity, storefrontJson, toOrderLines, toPaymentCardBrand, validateCardNumber, validateCardholderName, validateCvc, validateExpiry, validateOrderAgainstMenu, verifyWebhookSignature, visitedStates };

package/dist/index.js

@@ -1415,9 +1415,11 @@ const flattenMenuCategories = (categories, categoriesById, options) => {
 //#endregion
 //#region src/productCustomization/fromOrderLines.ts
 /** Group slot of a child line: listed directly, or as the variant of a base
-* listed in one of the parent's modifier groups. */
-const matchModifierLine = (lookup, parent, childId) => {
+* listed in one of the parent's modifier groups. With `onlyGroupId` (the
+* line's declared `group_id`) only that group of this parent is searched. */
+const matchModifierLine = (lookup, parent, childId, onlyGroupId) => {
 	const groups = parent.pricing.modifier_group_ids.flatMap((groupId) => {
+		if (onlyGroupId !== void 0 && groupId !== onlyGroupId) return [];
 		const group = lookup.modifierGroupsById[groupId];
 		return group ? [group] : [];
 	});
@@ -1463,7 +1465,13 @@ const fromOrderLines = (root, lines, lookup) => {
 		const parentProduct = lookup.productsById[parentLine.id];
 		if (!parentProduct) return;
 		for (const child of childrenByParent.get(parentLine.uid) ?? []) {
-			const match = matchModifierLine(lookup, parentProduct, child.id);
+			const p = [
+				lookup,
+				parentProduct,
+				child.id,
+				child.group_id
+			];
+			const match = matchModifierLine(...p);
 			if (!match) continue;
 			const { groupId, modifierId, selection } = match;
 			const path = `${pathPrefix}/group/${groupId}/modifier/${modifierId}`;
@@ -1750,6 +1758,7 @@ const buildLine = (args) => {
 		name: args.name
 	};
 	const r4 = {
+		...args.group_id ? { group_id: args.group_id } : {},
 		...imagePatch,
 		...catalog
 	};
@@ -1835,7 +1844,8 @@ const appendModifierLine = (modifier, groupId, parent, locale) => {
 	const line = buildLine({
 		...l1,
 		...l2,
-		...l3
+		...l3,
+		group_id: groupId
 	});
 	parent.children.push(line);
 	if (modifier.product) appendGroupLines(modifier.product.groups, line, locale);
@@ -1955,6 +1965,15 @@ const auth = {
 };
 //#endregion
 //#region src/order/customer.ts
+/**
+* Stand-ins the order schema needs while a guest's contact data is unknown.
+* Only valid when the merchant's `anonymous_customer` field is optional or
+* hidden; the API rejects them on required fields (`CUSTOMER_FIELD_REQUIRED`).
+*/
+const CUSTOMER_INFO_PLACEHOLDERS = {
+	email: "unknown@example.com",
+	phone: "+10000000000"
+};
 const splitName = (name) => {
 	const parts = name.trim().split(/\s+/).filter(Boolean);
 	const first_name = parts[0] ?? name;
@@ -1967,14 +1986,108 @@ const splitName = (name) => {
 /** Builds the order `customer` snapshot sent on create/update. */
 const buildCustomerSnapshot = (source) => {
 	const names = splitName(source.name);
+	const email = source.email || CUSTOMER_INFO_PLACEHOLDERS.email;
+	const phone = source.phone || CUSTOMER_INFO_PLACEHOLDERS.phone;
 	return { customer_info: {
 		display_name: names.display_name,
 		first_name: names.first_name,
 		last_name: names.last_name,
-		email: source.email ?? "unknown@example.com",
-		phone: source.phone ?? "+10000000000"
+		email,
+		phone
 	} };
 };
+/**
+* True when `value` is a stand-in, not data the guest typed: the
+* placeholders above, or a name equal to the anonymous customer id.
+*/
+const isCustomerInfoPlaceholder = (key, value, customerId) => {
+	if (typeof value !== "string") return false;
+	const text = value.trim();
+	if (key === "email") return text === CUSTOMER_INFO_PLACEHOLDERS.email;
+	if (key === "phone") return text === CUSTOMER_INFO_PLACEHOLDERS.phone;
+	if ((key === "first_name" || key === "last_name") && customerId) return text === customerId;
+	return false;
+};
+/** A `customer_info` field holds real (non-placeholder) guest data. */
+const isCustomerInfoFieldFilled = (info, key, customerId) => {
+	let value = info?.[key];
+	const metadata = info?.metadata;
+	if (value == null && metadata && typeof metadata === "object" && !Array.isArray(metadata)) value = metadata[key];
+	if (value == null) return false;
+	if (typeof value === "string" && !value.trim()) return false;
+	return !isCustomerInfoPlaceholder(key, value, customerId);
+};
+const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+const PHONE_RE = /^\+[1-9]\d{1,14}$/;
+/** Strips spaces, dashes, dots and parentheses: "+593 99-123" → "+59399123". */
+const normalizeCustomerPhone = (value) => {
+	return value.trim().replace(/[\s\-().]/g, "");
+};
+/**
+* Format check the order schema enforces on `customer_info`: email shape and
+* E.164 phone (`+593991234567`). Empty values are valid (presence is checked
+* against the merchant's `anonymous_customer` modes instead).
+*/
+const isCustomerInfoValueValid = (key, value) => {
+	const text = value.trim();
+	if (!text) return true;
+	if (key === "email") return EMAIL_RE.test(text);
+	if (key === "phone") return PHONE_RE.test(normalizeCustomerPhone(text));
+	return text.length <= 100;
+};
+/**
+* Merges guest contact data into `customer_info`; empty or malformed values
+* fall back to the current snapshot (placeholders for optional/hidden fields)
+* so a half-typed field never breaks the order sync.
+*/
+const mergeCustomerInfo = (current, patch) => {
+	const clean = (value, key = "") => {
+		let text = value?.trim();
+		if (text && key === "phone") text = normalizeCustomerPhone(text);
+		if (!text || !isCustomerInfoValueValid(key, text)) return void 0;
+		return text;
+	};
+	const first_name = clean(patch.first_name) ?? current.first_name;
+	const last_name = clean(patch.last_name) ?? current.last_name;
+	const email = clean(patch.email, "email") ?? current.email;
+	const phone = clean(patch.phone, "phone") ?? current.phone;
+	const typedName = clean(patch.first_name) || clean(patch.last_name);
+	let display_name = current.display_name;
+	if (typedName) display_name = `${first_name} ${last_name}`.trim();
+	const b1 = {
+		display_name,
+		first_name,
+		last_name,
+		email,
+		phone
+	};
+	if (!patch.metadata) return {
+		...current,
+		...b1
+	};
+	const metadata = mergeCustomMetadata(current.metadata, patch.metadata);
+	const { metadata: _drop, ...rest } = current;
+	if (metadata === void 0) return {
+		...rest,
+		...b1
+	};
+	return {
+		...rest,
+		...b1,
+		metadata
+	};
+};
+/** Custom guest fields: non-empty text is set, blanks remove the key. */
+const mergeCustomMetadata = (current, patch) => {
+	const next = { ...current };
+	for (const [key, value] of Object.entries(patch)) {
+		const text = typeof value === "string" ? value.trim() : value;
+		const valid = typeof text !== "string" || isCustomerInfoValueValid(key, text);
+		if (text == null || text === "" || !valid) delete next[key];
+		else next[key] = text;
+	}
+	return Object.keys(next).length > 0 ? next : void 0;
+};
 //#endregion
 //#region src/logs/limits.ts
 /** Mirrors the API limits so oversized logs are trimmed, not rejected. */
@@ -3687,7 +3800,8 @@ const computeLineFingerprint = (root, lines) => {
 		const keys = lines.filter((line) => {
 			return line.parent_uid === parentUid;
 		}).map((line) => {
-			return `${line.id}x${line.quantity}(${childKeys(line.uid)})`;
+			const slot = line.group_id ? `@${line.group_id}` : "";
+			return `${line.id}${slot}x${line.quantity}(${childKeys(line.uid)})`;
 		});
 		keys.sort((left, right) => left.localeCompare(right));
 		return keys.join(",");
@@ -6000,15 +6114,21 @@ var Order = class Order {
 	}
 	setCustomerDetails(details) {
 		if (this.deleted) return;
+		let customer_info = this.draft.customer.customer_info;
+		if (details.customer_info) customer_info = mergeCustomerInfo(customer_info, details.customer_info);
 		const hasAddressInfo = details.address_info !== void 0;
 		const hasBillingInfo = details.billing_info !== void 0;
 		const address_info = !hasAddressInfo ? this.draft.customer.address_info : details.address_info;
 		const billing_info = !hasBillingInfo ? this.draft.customer.billing_info : details.billing_info;
-		const customer = {
-			...this.draft.customer,
+		const c1 = {
+			customer_info,
 			address_info,
 			billing_info
 		};
+		const customer = {
+			...this.draft.customer,
+			...c1
+		};
 		this.draft = {
 			...this.draft,
 			customer
@@ -6643,7 +6763,8 @@ const selectionKey = (line, kidsOf, cache) => {
 		return selectionKey(child, kidsOf, cache);
 	});
 	nested.sort((left, right) => left.localeCompare(right));
-	const key = `${line.id}x${line.quantity}(${nested.join(",")})`;
+	const slot = line.group_id ? `@${line.group_id}` : "";
+	const key = `${line.id}${slot}x${line.quantity}(${nested.join(",")})`;
 	cache.set(line.uid, key);
 	return key;
 };
@@ -6730,6 +6851,36 @@ const hasRepeatedProductSibling = (lines, rootUid) => {
 	};
 	return walk(rootUid);
 };
+/** A line whose product the parent's menu lists in more than one slot, at
+* any depth. Cart lines carry no group id, so the slot is chosen by
+* `placeCartLines`; with a single listing the session path is unambiguous. */
+const hasMultiSlotChild = (lines, rootUid, lookup) => {
+	const kidsOf = /* @__PURE__ */ new Map();
+	for (const line of lines) {
+		if (line.parent_uid == null) continue;
+		const list = kidsOf.get(line.parent_uid) ?? [];
+		list.push(line);
+		kidsOf.set(line.parent_uid, list);
+	}
+	const walk = (line) => {
+		const parent = lookup.productsById[line.id];
+		const groups = parent ? parentGroups(lookup, parent) : [];
+		for (const kid of kidsOf.get(line.uid) ?? []) {
+			const ids = listingsFor(lookup, groups, kid.id).map((row) => slotKey(row.group.id, row.modifierId));
+			if (new Set(ids).size > 1) return true;
+			if (walk(kid)) return true;
+		}
+		return false;
+	};
+	const root = lines.find((line) => line.uid === rootUid);
+	return root ? walk(root) : false;
+};
+/** Cart shapes the slot search must place: a repeated sibling product, or
+* a product listed in several slots. Everything else keeps the session. */
+const needsSlotPlacement = (lines, rootUid, lookup) => {
+	if (hasRepeatedProductSibling(lines, rootUid)) return true;
+	return hasMultiSlotChild(lines, rootUid, lookup);
+};
 const noteRules = (state, broken) => {
 	if (broken) state.rulesBroken = true;
 };
@@ -6897,13 +7048,21 @@ const greedyAssignment = (plans) => {
 		overCapacity
 	};
 };
+/** The groups a line may sit in under this parent: only its declared
+* `group_id` when it names one, else every group of the parent. A declared id
+* the parent does not own leaves none, so the line is never placed. */
+const groupsDeclared = (groups, line) => {
+	if (line.group_id === void 0) return groups;
+	return groups.filter((group) => group.id === line.group_id);
+};
 const planKids = (lookup, groups, byKey, kids, prefix, state) => {
 	const plans = [];
 	let previous = "";
 	for (const child of kids) {
 		if (pathVisits(prefix, child.id)) continue;
 		const ordered = lookup.productsById[child.id];
-		const listings = listingsFor(lookup, groups, child.id);
+		const scope = groupsDeclared(groups, child);
+		const listings = listingsFor(lookup, scope, child.id);
 		if (!ordered || listings.length === 0) continue;
 		const listed = [];
 		for (const item of listings) {
@@ -7123,14 +7282,17 @@ const emit = (node, parentUid, parentId, locale, out) => {
 		type: "PRODUCT",
 		uid: randomUUID()
 	};
+	const id = node.product.id;
+	const groupPatch = node.group ? { group_id: node.group.id } : {};
 	const r2 = {
-		id: node.product.id,
+		id,
 		parent_uid: parentUid,
 		parent_id: parentId
 	};
 	const r3 = {
 		name: displayName(node.product.name, locale),
-		quantity: node.quantity
+		quantity: node.quantity,
+		...groupPatch
 	};
 	const r4 = {
 		redeem: [],
@@ -7321,10 +7483,25 @@ const childrenOf = (lines, parentUid) => {
 		if (byShape !== 0) return byShape;
 		const bySubtotal = new Big(a.unit_subtotal).cmp(b.unit_subtotal);
 		if (bySubtotal !== 0) return bySubtotal;
-		return new Big(a.unit_tax_total).cmp(b.unit_tax_total);
+		const byTax = new Big(a.unit_tax_total).cmp(b.unit_tax_total);
+		if (byTax !== 0) return byTax;
+		return (a.group_id ?? "").localeCompare(b.group_id ?? "");
 	});
 	return children;
 };
+/** A declared `group_id` that the parent's menu does not back (unknown under
+* this parent, or it does not hold the product) names the field; a line that
+* is no modifier of its parent at all keeps the plain code. */
+const notFoundIssue = (lookup, parent, child) => {
+	const code = "MODIFIER_NOT_FOUND";
+	if (child.group_id === void 0) return { code };
+	if (!matchModifierLine(lookup, parent, child.id)) return { code };
+	return {
+		code,
+		field: "group_id",
+		actual: child.group_id
+	};
+};
 const collectUnmatchedModifiers = (lines, lookup, parentProductId, parentUid, out) => {
 	const parent = lookup.productsById[parentProductId];
 	if (!parent) return;
@@ -7336,9 +7513,14 @@ const collectUnmatchedModifiers = (lines, lookup, parentProductId, parentUid, ou
 			pushLineIssue(out, child.uid, { code: "VARIANT_BASE_NOT_ORDERABLE" });
 			continue;
 		}
-		const match = matchModifierLine(lookup, parent, child.id);
+		const match = matchModifierLine(...[
+			lookup,
+			parent,
+			child.id,
+			child.group_id
+		]);
 		if (!match) {
-			pushLineIssue(out, child.uid, { code: "MODIFIER_NOT_FOUND" });
+			pushLineIssue(out, child.uid, notFoundIssue(lookup, parent, child));
 			continue;
 		}
 		const base = lookup.productsById[match.modifierId];
@@ -7481,6 +7663,13 @@ const compareTrees = (actualLines, expectedLines, actualUid, expectedUid, out) =
 		});
 		return;
 	}
+	const declared = actual.group_id;
+	if (declared !== void 0 && declared !== expected.group_id) pushLineIssue(out, actual.uid, {
+		code: "STRUCTURE_MISMATCH",
+		field: "group_id",
+		expected: expected.group_id,
+		actual: declared
+	});
 	if (actual.quantity !== expected.quantity) pushLineIssue(out, actual.uid, {
 		code: "QUANTITY_MISMATCH",
 		field: "quantity",
@@ -7566,7 +7755,7 @@ const validateProductRoot = (root, lines, lookup, locale, out) => {
 	if (!isOnSchedule(product.availability.schedules)) pushLineIssue(out, root.uid, { code: "OUTSIDE_HOURS" });
 	collectUnmatchedModifiers(lines, lookup, root.id, root.uid, out);
 	let expected;
-	if (hasRepeatedProductSibling(lines, root.uid)) {
+	if (needsSlotPlacement(lines, root.uid, lookup)) {
 		const placed = placeCartLines(root, lines, lookup, locale);
 		if (placed.rulesBroken) pushLineIssue(out, root.uid, { code: "MODIFIER_RULES_INVALID" });
 		expected = placed.lines;
@@ -7898,7 +8087,7 @@ const collectOrderLineDiffs = (input) => {
 			continue;
 		}
 		try {
-			if (hasRepeatedProductSibling(input.lines, root.uid)) {
+			if (needsSlotPlacement(input.lines, root.uid, lookup)) {
 				const placed = placeCartLines(root, input.lines, lookup, locale);
 				const next = placed.rulesBroken ? null : placed.lines;
 				diffs.push({
@@ -9452,6 +9641,13 @@ const DEFAULT_BILLING_FIELDS = {
 	tax_id: "required",
 	tax_id_type: "required"
 };
+/** Guest contact fields → `customer.customer_info` (anonymous orders). */
+const DEFAULT_CUSTOMER_FIELDS = {
+	email: "required",
+	first_name: "required",
+	last_name: "required",
+	phone: "required"
+};
 const getCheckoutFieldValue = (info, key) => {
 	if (!info) return void 0;
 	const top = info[key];
@@ -9481,7 +9677,8 @@ const defaultCheckoutPreferences = {
 	billing: {
 		fields: DEFAULT_BILLING_FIELDS,
 		rules: [fallbackRequired]
-	}
+	},
+	anonymous_customer: { fields: DEFAULT_CUSTOMER_FIELDS }
 };
 const factsFromOrder = (order) => {
 	const brand_id = order.brand_id ?? void 0;
@@ -9536,13 +9733,15 @@ const resolveCheckout = (order, options) => {
 	let shipping = "hidden";
 	if (ships) shipping = resolveSection(checkout.shipping, engine);
 	const billing = resolveSection(checkout.billing, engine);
-	const shippingFields = checkout.shipping.fields ?? DEFAULT_SHIPPING_FIELDS;
-	const billingFields = checkout.billing.fields ?? DEFAULT_BILLING_FIELDS;
+	const f1 = {
+		shippingFields: checkout.shipping.fields ?? DEFAULT_SHIPPING_FIELDS,
+		billingFields: checkout.billing.fields ?? DEFAULT_BILLING_FIELDS,
+		customerFields: checkout.anonymous_customer?.fields ?? DEFAULT_CUSTOMER_FIELDS
+	};
 	return {
 		shipping,
 		billing,
-		shippingFields,
-		billingFields
+		...f1
 	};
 };
 //#endregion
@@ -9881,4 +10080,4 @@ const cardPreviewGroups = (value) => {
 	return groups;
 };
 //#endregion
-export { CARD_BRANDS, DEFAULT_RECOMMENDATION_TYPES, ID_HASH_FORMATS, Order, OrderPaymentRequiredError, OrderSyncPendingError, OrderSyncRejectedError, OrderValidationError, RecurringDateCron, RulesEngine, StorefrontHttpError, addLines, auth, buildCustomerSnapshot, cancelTypeOf, capRedeems, cappedRedeems, cardBrandSpec, cardDigits, cardNumberGaps, cardNumberMaxLength, cardPreviewGroups, caretAfterDigits, collectOrderLineDiffs, computeStartingPrice, countCartProducts, coveredAmount, createDeunaWidgetApi, createSession, currentNodes, cvcMaxLength, defaultConditionError, detectCardBrand, fitRedeems, flattenMenuCategories, flushLogs, formatCardNumber, formatCvc, formatExpiry, fromOrderLines, genId, genOrderId, getLogContext, getScheduleWindow, indexMenu, isCardNumberComplete, isCardNumberDefinitelyInvalid, isCheckoutFieldFilled, isCvcComplete, isDeviceCharged, isDeviceNotLinked, isExpiryComplete, isGenId, isKioskUnauthorized, isMilestoneStepDone, isOnSchedule, isOrderPaymentRequiredError, isOrderValidationError, isPosDeviceNotLinked, isPosUnauthorized, isRealPaymentMethod, isStorefrontNotFound, isVariantBase, linePayableTotal, listMenusStream, localizePosError, log, logError, luhnCheck, matchAbsoluteDateOperator, matchBooleanOperator, matchCurrencyOperator, matchEnumOperator, matchNumberOperator, matchRecurringDateOperator, matchRelativeDateOperator, matchStringOperator, milestoneSteps, milestoneTrack, nestMenuCategories, normalizeCardholderName, orderPayableTotal, orderRedeemedTotal, orderRedeems, parseExpiry, paymentMatchesClientConditions, rebuildRootGroups, recomputeTotals, redeemedTotal, redemptionCap, redemptionSteps, remainingAmount, removeLine, replaceLine, resolveCheckout, resolveModifierImageUrl, reversePayment, runPaymentAttempt, selectablePayments, serializeError, services, setLineQuantity, storefrontJson, toOrderLines, toPaymentCardBrand, validateCardNumber, validateCardholderName, validateCvc, validateExpiry, validateOrderAgainstMenu, verifyWebhookSignature, visitedStates };
+export { CARD_BRANDS, CUSTOMER_INFO_PLACEHOLDERS, DEFAULT_RECOMMENDATION_TYPES, ID_HASH_FORMATS, Order, OrderPaymentRequiredError, OrderSyncPendingError, OrderSyncRejectedError, OrderValidationError, RecurringDateCron, RulesEngine, StorefrontHttpError, addLines, auth, buildCustomerSnapshot, cancelTypeOf, capRedeems, cappedRedeems, cardBrandSpec, cardDigits, cardNumberGaps, cardNumberMaxLength, cardPreviewGroups, caretAfterDigits, collectOrderLineDiffs, computeStartingPrice, countCartProducts, coveredAmount, createDeunaWidgetApi, createSession, currentNodes, cvcMaxLength, defaultConditionError, detectCardBrand, fitRedeems, flattenMenuCategories, flushLogs, formatCardNumber, formatCvc, formatExpiry, fromOrderLines, genId, genOrderId, getLogContext, getScheduleWindow, indexMenu, isCardNumberComplete, isCardNumberDefinitelyInvalid, isCheckoutFieldFilled, isCustomerInfoFieldFilled, isCustomerInfoPlaceholder, isCustomerInfoValueValid, isCvcComplete, isDeviceCharged, isDeviceNotLinked, isExpiryComplete, isGenId, isKioskUnauthorized, isMilestoneStepDone, isOnSchedule, isOrderPaymentRequiredError, isOrderValidationError, isPosDeviceNotLinked, isPosUnauthorized, isRealPaymentMethod, isStorefrontNotFound, isVariantBase, linePayableTotal, listMenusStream, localizePosError, log, logError, luhnCheck, matchAbsoluteDateOperator, matchBooleanOperator, matchCurrencyOperator, matchEnumOperator, matchNumberOperator, matchRecurringDateOperator, matchRelativeDateOperator, matchStringOperator, milestoneSteps, milestoneTrack, nestMenuCategories, normalizeCardholderName, normalizeCustomerPhone, orderPayableTotal, orderRedeemedTotal, orderRedeems, parseExpiry, paymentMatchesClientConditions, rebuildRootGroups, recomputeTotals, redeemedTotal, redemptionCap, redemptionSteps, remainingAmount, removeLine, replaceLine, resolveCheckout, resolveModifierImageUrl, reversePayment, runPaymentAttempt, selectablePayments, serializeError, services, setLineQuantity, storefrontJson, toOrderLines, toPaymentCardBrand, validateCardNumber, validateCardholderName, validateCvc, validateExpiry, validateOrderAgainstMenu, verifyWebhookSignature, visitedStates };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fire-spark/core",
-  "version": "0.12.4",
+  "version": "0.13.0",
   "description": "Fire Spark headless SDK",
   "type": "module",
   "sideEffects": false,
@@ -20,8 +20,8 @@
     "big.js": "6.2.1",
     "dayjs": "1.11.9",
     "@types/big.js": "6.2.2",
-    "@fire-spark/payments": "^0.12.4",
-    "@fire-spark/types": "^0.12.4"
+    "@fire-spark/payments": "^0.13.0",
+    "@fire-spark/types": "^0.13.0"
   },
   "devDependencies": {
     "tsdown": "^0.22.14",