@aglyn/plugins-commerce 1.0.0-beta.291 → 1.0.0-beta.292

package/src/lib/model/product-modifiers.js

@@ -26,9 +26,19 @@
  * structured in `modifiers`: every receipt, email, order view and export
  * already prints the label, so the choice reaches all of them without each
  * learning a new field.
+ *
+ * ADD-ONS ON THE WEBSITE (AGL-4100). A group switched to "Show on the
+ * website" (`online`) is offered on the product's page too, and a cart line,
+ * Buy now and the order carry its picks the same way: ids from the shopper,
+ * prices from the product. A choice may cost more on one variant than
+ * another (`priceCentsByVariant`), which is how one page sells a canopy whose
+ * walls cost more at a larger size without a variant for every combination.
  *=========================================*/ /** One choice in a modifier group. `priceCents` is added to the item, 0 for free. */ export const POS_MAX_MODIFIER_GROUPS = 10;
 export const POS_MAX_MODIFIER_OPTIONS = 20;
 /** $1,000 on one modifier: anything larger is a product, not an add-on. */ export const POS_MAX_MODIFIER_PRICE_CENTS = 100000;
+function modifierPriceIsValid(price) {
+    return typeof price === 'number' && Number.isInteger(price) && price >= 0 && price <= POS_MAX_MODIFIER_PRICE_CENTS;
+}
 /** Why a product's modifier groups cannot be saved, or null when they can. */ export function modifierGroupsProblem(groups) {
     if (groups == null) return null;
     if (!Array.isArray(groups)) return 'Modifiers must be a list';
@@ -53,9 +63,21 @@ export const POS_MAX_MODIFIER_OPTIONS = 20;
             optionIds.add(option.id);
             if (!String((_option_name = option.name) != null ? _option_name : '').trim()) return `Name every choice in “${group.name}”`;
             const price = option.priceCents;
-            if (!Number.isInteger(price) || price < 0 || price > POS_MAX_MODIFIER_PRICE_CENTS) {
+            if (!modifierPriceIsValid(price)) {
                 return `“${option.name}” needs a price of $0 to $1,000`;
             }
+            const byVariant = option.priceCentsByVariant;
+            if (byVariant != null) {
+                if (typeof byVariant !== 'object' || Array.isArray(byVariant)) {
+                    return `“${option.name}” has prices that are not a list by option`;
+                }
+                if (Object.values(byVariant).some((cents)=>!modifierPriceIsValid(cents))) {
+                    return `“${option.name}” needs a price of $0 to $1,000 for each option it is priced by`;
+                }
+            }
+        }
+        if (group.online != null && typeof group.online !== 'boolean') {
+            return `“${group.name}” is shown on the website or not`;
         }
         const { min, max } = group;
         if (!Number.isInteger(min) || min < 0) return `“${group.name}” needs a minimum of 0 or more`;
@@ -74,7 +96,42 @@ export const POS_MAX_MODIFIER_OPTIONS = 20;
 /** Whether a group must be answered before the item can be added. */ export function modifierGroupRequired(group) {
     return group.min > 0;
 }
-export function resolveLineModifiers(product, raw) {
+/**
+ * The groups the product's page on the website offers (AGL-4100): those
+ * switched to "Show on the website". A register-only group is never sent to
+ * a shopper, never asked of one and never priced on an online order.
+ */ export function websiteModifierGroups(product) {
+    return productModifierGroups(product).filter((group)=>group.online === true);
+}
+/** Whether the website must ask a shopper a choice before the item goes in a cart. */ export function websiteModifiersRequired(product) {
+    return websiteModifierGroups(product).some(modifierGroupRequired);
+}
+/**
+ * What one choice adds to one unit of the picked variant (AGL-4100): its
+ * price on that variant where it has one, else its own price.
+ */ export function modifierOptionPriceCents(option, variantId) {
+    var _option_priceCentsByVariant;
+    const byVariant = variantId ? (_option_priceCentsByVariant = option.priceCentsByVariant) == null ? void 0 : _option_priceCentsByVariant[variantId] : undefined;
+    return typeof byVariant === 'number' && Number.isFinite(byVariant) ? byVariant : option.priceCents;
+}
+/** The picks a request names, as ids only, bounded; nothing for a value that is not a list. */ export function modifierSelectionFrom(raw) {
+    return (Array.isArray(raw) ? raw : []).slice(0, POS_MAX_MODIFIER_GROUPS * POS_MAX_MODIFIER_OPTIONS).map((entry)=>{
+        var _ref, _ref1;
+        return {
+            groupId: String((_ref = entry == null ? void 0 : entry.groupId) != null ? _ref : ''),
+            optionId: String((_ref1 = entry == null ? void 0 : entry.optionId) != null ? _ref1 : '')
+        };
+    });
+}
+/**
+ * Prices a line's chosen modifiers from the PRODUCT, in group order, and
+ * checks every group's minimum and maximum. Unknown ids, a repeated choice
+ * and a group answered past its maximum are refused with what to fix.
+ *
+ * `variantId` is the variant the line sells (AGL-4100): a choice priced by
+ * variant adds its price on that one. Without it every choice adds its own
+ * `priceCents`, as it always did.
+ */ export function resolveLineModifiers(product, raw, variantId) {
     const refuse = (error)=>({
             ok: false,
             modifiers: [],
@@ -82,13 +139,7 @@ export function resolveLineModifiers(product, raw) {
             error
         });
     const groups = productModifierGroups(product);
-    const picks = (Array.isArray(raw) ? raw : []).slice(0, POS_MAX_MODIFIER_GROUPS * POS_MAX_MODIFIER_OPTIONS).map((entry)=>{
-        var _ref, _ref1;
-        return {
-            groupId: String((_ref = entry == null ? void 0 : entry.groupId) != null ? _ref : ''),
-            optionId: String((_ref1 = entry == null ? void 0 : entry.optionId) != null ? _ref1 : '')
-        };
-    });
+    const picks = modifierSelectionFrom(raw);
     const seen = new Set();
     for (const pick of picks){
         const key = `${pick.groupId}:${pick.optionId}`;
@@ -114,7 +165,7 @@ export function resolveLineModifiers(product, raw) {
                 optionId: option.id,
                 group: group.name,
                 name: option.name,
-                priceCents: option.priceCents
+                priceCents: modifierOptionPriceCents(option, variantId)
             });
         }
     }
@@ -124,6 +175,76 @@ export function resolveLineModifiers(product, raw) {
         extraCents: modifiers.reduce((sum, modifier)=>sum + modifier.priceCents, 0)
     };
 }
+/**
+ * {@link resolveLineModifiers} for a sale made online (AGL-4100): only the
+ * groups shown on the website are offered, asked or priced. A register-only
+ * group, required or not, is not the shopper's to answer.
+ */ export function resolveWebsiteLineModifiers(product, raw, variantId) {
+    return resolveLineModifiers({
+        name: product.name,
+        modifierGroups: websiteModifierGroups(product)
+    }, raw, variantId);
+}
+/**
+ * The modifiers a PAID line names, for its order record (AGL-4100): every
+ * pick the product still offers, in group order, priced as it is now, with no
+ * minimum or maximum asked. The money was taken when the sale was priced;
+ * a choice the merchant removed since is left off the record, never a reason
+ * to lose the order.
+ */ export function soldLineModifiers(product, raw, variantId) {
+    const picks = modifierSelectionFrom(raw);
+    const modifiers = [];
+    for (const group of productModifierGroups(product)){
+        for (const option of group.options){
+            if (picks.some((pick)=>pick.groupId === group.id && pick.optionId === option.id)) {
+                modifiers.push({
+                    groupId: group.id,
+                    optionId: option.id,
+                    group: group.name,
+                    name: option.name,
+                    priceCents: modifierOptionPriceCents(option, variantId)
+                });
+            }
+        }
+    }
+    return modifiers;
+}
+/**
+ * What a shopper is told about a cart line whose add-ons no longer answer
+ * the product (AGL-4100): the resolver's reason, and how to put it right.
+ */ export function cartLineModifierProblem(error) {
+    const reason = String(error != null ? error : '').trim() || 'The choices on this item have changed.';
+    return /Remove it and add it again/.test(reason) ? reason : `${reason} Remove it and add it again from its page.`;
+}
+/** The picks a priced line keeps: ids only, in the product's group order. */ export function modifierSelectionOf(modifiers) {
+    return modifiers.map((modifier)=>({
+            groupId: modifier.groupId,
+            optionId: modifier.optionId
+        }));
+}
+/**
+ * The picks as one metadata value (AGL-4100), for a payment processor that
+ * holds strings only: `[["group","option"],…]`. Empty for no picks.
+ */ export function encodeModifierSelection(selection) {
+    if (!(selection == null ? void 0 : selection.length)) return '';
+    return JSON.stringify(selection.map((pick)=>[
+            pick.groupId,
+            pick.optionId
+        ]));
+}
+/** {@link encodeModifierSelection} read back; nothing for a value it did not write. */ export function decodeModifierSelection(value) {
+    if (typeof value !== 'string' || !value) return [];
+    try {
+        const parsed = JSON.parse(value);
+        if (!Array.isArray(parsed)) return [];
+        return parsed.filter((pair)=>Array.isArray(pair) && typeof pair[0] === 'string' && typeof pair[1] === 'string').slice(0, POS_MAX_MODIFIER_GROUPS * POS_MAX_MODIFIER_OPTIONS).map(([groupId, optionId])=>({
+                groupId,
+                optionId
+            }));
+    } catch (unused) {
+        return [];
+    }
+}
 /** The label a line prints: the variant, then each modifier (`Large / Oat milk, Extra shot`). */ export function lineLabelWithModifiers(variantLabel, modifiers) {
     const added = modifiers.map((modifier)=>modifier.name).join(', ');
     return [

package/src/lib/model/product-modifiers.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/product-modifiers.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/*==========================================\n * REGISTER MODIFIERS AND QUICK KEYS (AGL-3607).\n *\n * A modifier is a choice added to an item as it is rung up — \"Oat milk\",\n * \"Extra shot +$0.75\", \"No onions\" — that is not a stocked variant. Groups\n * live on the product (`modifierGroups`); the register sends the chosen\n * option ids with each line and the SERVER prices them from the product\n * document, so a register never names what a modifier costs.\n *\n * A chosen modifier is folded into the line's `variantLabel` as well as kept\n * structured in `modifiers`: every receipt, email, order view and export\n * already prints the label, so the choice reaches all of them without each\n * learning a new field.\n *=========================================*/\n\n/** One choice in a modifier group. `priceCents` is added to the item, 0 for free. */\nexport interface ProductModifierOption {\n  id: string\n  name: string\n  priceCents: number\n}\n\n/**\n * A set of choices offered together (\"Milk\", \"Add-ons\"). `min` of 1 or more\n * makes it required; `max` caps how many can be picked (1 = pick one).\n */\nexport interface ProductModifierGroup {\n  id: string\n  name: string\n  min: number\n  max: number\n  options: ProductModifierOption[]\n}\n\n/** A modifier as the order line keeps it: names and price as sold. */\nexport interface OrderLineModifier {\n  groupId: string\n  optionId: string\n  group: string\n  name: string\n  priceCents: number\n}\n\n/** What the register sends for a line: the option ids it picked, nothing priced. */\nexport interface ModifierSelection {\n  groupId: string\n  optionId: string\n}\n\nexport const POS_MAX_MODIFIER_GROUPS = 10\nexport const POS_MAX_MODIFIER_OPTIONS = 20\n/** $1,000 on one modifier: anything larger is a product, not an add-on. */\nexport const POS_MAX_MODIFIER_PRICE_CENTS = 100_000\n\n/** Why a product's modifier groups cannot be saved, or null when they can. */\nexport function modifierGroupsProblem(groups: unknown): string | null {\n  if (groups == null) return null\n  if (!Array.isArray(groups)) return 'Modifiers must be a list'\n  if (groups.length > POS_MAX_MODIFIER_GROUPS) {\n    return `At most ${POS_MAX_MODIFIER_GROUPS} modifier groups per product`\n  }\n  const groupIds = new Set<string>()\n  for (const group of groups as ProductModifierGroup[]) {\n    if (!group?.id || groupIds.has(group.id)) return 'Modifier groups need unique ids'\n    groupIds.add(group.id)\n    if (!String(group.name ?? '').trim()) return 'Name every modifier group'\n    const options = Array.isArray(group.options) ? group.options : []\n    if (options.length === 0) return `Add a choice to “${group.name}”`\n    if (options.length > POS_MAX_MODIFIER_OPTIONS) {\n      return `“${group.name}” has more than ${POS_MAX_MODIFIER_OPTIONS} choices`\n    }\n    const optionIds = new Set<string>()\n    for (const option of options) {\n      if (!option?.id || optionIds.has(option.id)) return 'Modifier choices need unique ids'\n      optionIds.add(option.id)\n      if (!String(option.name ?? '').trim()) return `Name every choice in “${group.name}”`\n      const price = option.priceCents\n      if (!Number.isInteger(price) || price < 0 || price > POS_MAX_MODIFIER_PRICE_CENTS) {\n        return `“${option.name}” needs a price of $0 to $1,000`\n      }\n    }\n    const { min, max } = group\n    if (!Number.isInteger(min) || min < 0) return `“${group.name}” needs a minimum of 0 or more`\n    if (!Number.isInteger(max) || max < 1 || max > options.length) {\n      return `“${group.name}” allows 1 to ${options.length} choices`\n    }\n    if (min > max) return `“${group.name}” requires more choices than it allows`\n  }\n  return null\n}\n\n/** The product's groups, or none when they are missing or malformed. */\nexport function productModifierGroups(product: {\n  modifierGroups?: unknown\n}): ProductModifierGroup[] {\n  const groups = product?.modifierGroups\n  if (!Array.isArray(groups) || modifierGroupsProblem(groups)) return []\n  return groups as ProductModifierGroup[]\n}\n\n/** Whether a group must be answered before the item can be added. */\nexport function modifierGroupRequired(group: ProductModifierGroup): boolean {\n  return group.min > 0\n}\n\n/**\n * Prices a line's chosen modifiers from the PRODUCT, in group order, and\n * checks every group's minimum and maximum. Unknown ids, a repeated choice\n * and a group answered past its maximum are refused with what to fix.\n */\nexport interface ResolvedLineModifiers {\n  ok: boolean\n  /** The chosen modifiers, in group order; empty when not `ok`. */\n  modifiers: OrderLineModifier[]\n  /** What they add to one unit, in cents. */\n  extraCents: number\n  /** What to fix, when not `ok`. */\n  error?: string\n}\n\nexport function resolveLineModifiers(\n  product: { name?: string; modifierGroups?: unknown },\n  raw: unknown,\n): ResolvedLineModifiers {\n  const refuse = (error: string): ResolvedLineModifiers => ({\n    ok: false,\n    modifiers: [],\n    extraCents: 0,\n    error,\n  })\n  const groups = productModifierGroups(product)\n  const picks: ModifierSelection[] = (Array.isArray(raw) ? raw : [])\n    .slice(0, POS_MAX_MODIFIER_GROUPS * POS_MAX_MODIFIER_OPTIONS)\n    .map((entry: any) => ({\n      groupId: String(entry?.groupId ?? ''),\n      optionId: String(entry?.optionId ?? ''),\n    }))\n  const seen = new Set<string>()\n  for (const pick of picks) {\n    const key = `${pick.groupId}:${pick.optionId}`\n    if (seen.has(key)) return refuse(`A choice on ${product.name} was picked twice.`)\n    seen.add(key)\n    const group = groups.find((entry) => entry.id === pick.groupId)\n    if (!group || !group.options.some((option) => option.id === pick.optionId)) {\n      return refuse(`A choice on ${product.name} is no longer offered. Remove it and add it again.`)\n    }\n  }\n  const modifiers: OrderLineModifier[] = []\n  for (const group of groups) {\n    const chosen = group.options.filter((option) =>\n      picks.some((pick) => pick.groupId === group.id && pick.optionId === option.id),\n    )\n    if (chosen.length < group.min) {\n      return refuse(`Choose ${group.name.toLowerCase()} for ${product.name}.`)\n    }\n    if (chosen.length > group.max) {\n      return refuse(`Choose at most ${group.max} for ${group.name.toLowerCase()} on ${product.name}.`)\n    }\n    for (const option of chosen) {\n      modifiers.push({\n        groupId: group.id,\n        optionId: option.id,\n        group: group.name,\n        name: option.name,\n        priceCents: option.priceCents,\n      })\n    }\n  }\n  return {\n    ok: true,\n    modifiers,\n    extraCents: modifiers.reduce((sum, modifier) => sum + modifier.priceCents, 0),\n  }\n}\n\n/** The label a line prints: the variant, then each modifier (`Large / Oat milk, Extra shot`). */\nexport function lineLabelWithModifiers(\n  variantLabel: string | undefined,\n  modifiers: readonly Pick<OrderLineModifier, 'name'>[],\n): string {\n  const added = modifiers.map((modifier) => modifier.name).join(', ')\n  return [variantLabel, added].filter(Boolean).join(' / ')\n}\n\n/** Two lines merge only when they are the same item with the same choices. */\nexport function modifierSelectionKey(selection: readonly ModifierSelection[] | undefined): string {\n  return [...(selection ?? [])]\n    .map((pick) => `${pick.groupId}:${pick.optionId}`)\n    .sort()\n    .join('|')\n}\n"],"names":["POS_MAX_MODIFIER_GROUPS","POS_MAX_MODIFIER_OPTIONS","POS_MAX_MODIFIER_PRICE_CENTS","modifierGroupsProblem","groups","Array","isArray","length","groupIds","Set","group","id","has","add","String","name","trim","options","optionIds","option","price","priceCents","Number","isInteger","min","max","productModifierGroups","product","modifierGroups","modifierGroupRequired","resolveLineModifiers","raw","refuse","error","ok","modifiers","extraCents","picks","slice","map","entry","groupId","optionId","seen","pick","key","find","some","chosen","filter","toLowerCase","push","reduce","sum","modifier","lineLabelWithModifiers","variantLabel","added","join","Boolean","modifierSelectionKey","selection","sort"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/product-modifiers.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/*==========================================\n * REGISTER MODIFIERS AND QUICK KEYS (AGL-3607).\n *\n * A modifier is a choice added to an item as it is rung up — \"Oat milk\",\n * \"Extra shot +$0.75\", \"No onions\" — that is not a stocked variant. Groups\n * live on the product (`modifierGroups`); the register sends the chosen\n * option ids with each line and the SERVER prices them from the product\n * document, so a register never names what a modifier costs.\n *\n * A chosen modifier is folded into the line's `variantLabel` as well as kept\n * structured in `modifiers`: every receipt, email, order view and export\n * already prints the label, so the choice reaches all of them without each\n * learning a new field.\n *\n * ADD-ONS ON THE WEBSITE (AGL-4100). A group switched to \"Show on the\n * website\" (`online`) is offered on the product's page too, and a cart line,\n * Buy now and the order carry its picks the same way: ids from the shopper,\n * prices from the product. A choice may cost more on one variant than\n * another (`priceCentsByVariant`), which is how one page sells a canopy whose\n * walls cost more at a larger size without a variant for every combination.\n *=========================================*/\n\n/** One choice in a modifier group. `priceCents` is added to the item, 0 for free. */\nexport interface ProductModifierOption {\n  id: string\n  name: string\n  priceCents: number\n  /**\n   * What the choice adds on one variant, keyed by variant id (AGL-4100):\n   * walls cost more on a larger canopy. A variant not listed pays\n   * `priceCents`. Read through {@link modifierOptionPriceCents}.\n   */\n  priceCentsByVariant?: Record<string, number>\n}\n\n/**\n * A set of choices offered together (\"Milk\", \"Add-ons\"). `min` of 1 or more\n * makes it required; `max` caps how many can be picked (1 = pick one).\n */\nexport interface ProductModifierGroup {\n  id: string\n  name: string\n  min: number\n  max: number\n  options: ProductModifierOption[]\n  /**\n   * Offered on the product's page on the website as well as at the register\n   * (AGL-4100), \"Show on the website\". Absent reads as register only, so a\n   * group made before the switch changes nothing on a live store; the\n   * console makes new groups with it on.\n   */\n  online?: boolean\n}\n\n/** A modifier as the order line keeps it: names and price as sold. */\nexport interface OrderLineModifier {\n  groupId: string\n  optionId: string\n  group: string\n  name: string\n  priceCents: number\n}\n\n/** What the register sends for a line: the option ids it picked, nothing priced. */\nexport interface ModifierSelection {\n  groupId: string\n  optionId: string\n}\n\nexport const POS_MAX_MODIFIER_GROUPS = 10\nexport const POS_MAX_MODIFIER_OPTIONS = 20\n/** $1,000 on one modifier: anything larger is a product, not an add-on. */\nexport const POS_MAX_MODIFIER_PRICE_CENTS = 100_000\n\nfunction modifierPriceIsValid(price: unknown): boolean {\n  return (\n    typeof price === 'number' &&\n    Number.isInteger(price) &&\n    price >= 0 &&\n    price <= POS_MAX_MODIFIER_PRICE_CENTS\n  )\n}\n\n/** Why a product's modifier groups cannot be saved, or null when they can. */\nexport function modifierGroupsProblem(groups: unknown): string | null {\n  if (groups == null) return null\n  if (!Array.isArray(groups)) return 'Modifiers must be a list'\n  if (groups.length > POS_MAX_MODIFIER_GROUPS) {\n    return `At most ${POS_MAX_MODIFIER_GROUPS} modifier groups per product`\n  }\n  const groupIds = new Set<string>()\n  for (const group of groups as ProductModifierGroup[]) {\n    if (!group?.id || groupIds.has(group.id)) return 'Modifier groups need unique ids'\n    groupIds.add(group.id)\n    if (!String(group.name ?? '').trim()) return 'Name every modifier group'\n    const options = Array.isArray(group.options) ? group.options : []\n    if (options.length === 0) return `Add a choice to “${group.name}”`\n    if (options.length > POS_MAX_MODIFIER_OPTIONS) {\n      return `“${group.name}” has more than ${POS_MAX_MODIFIER_OPTIONS} choices`\n    }\n    const optionIds = new Set<string>()\n    for (const option of options) {\n      if (!option?.id || optionIds.has(option.id)) return 'Modifier choices need unique ids'\n      optionIds.add(option.id)\n      if (!String(option.name ?? '').trim()) return `Name every choice in “${group.name}”`\n      const price = option.priceCents\n      if (!modifierPriceIsValid(price)) {\n        return `“${option.name}” needs a price of $0 to $1,000`\n      }\n      const byVariant = option.priceCentsByVariant\n      if (byVariant != null) {\n        if (typeof byVariant !== 'object' || Array.isArray(byVariant)) {\n          return `“${option.name}” has prices that are not a list by option`\n        }\n        if (Object.values(byVariant).some((cents) => !modifierPriceIsValid(cents))) {\n          return `“${option.name}” needs a price of $0 to $1,000 for each option it is priced by`\n        }\n      }\n    }\n    if (group.online != null && typeof group.online !== 'boolean') {\n      return `“${group.name}” is shown on the website or not`\n    }\n    const { min, max } = group\n    if (!Number.isInteger(min) || min < 0) return `“${group.name}” needs a minimum of 0 or more`\n    if (!Number.isInteger(max) || max < 1 || max > options.length) {\n      return `“${group.name}” allows 1 to ${options.length} choices`\n    }\n    if (min > max) return `“${group.name}” requires more choices than it allows`\n  }\n  return null\n}\n\n/** The product's groups, or none when they are missing or malformed. */\nexport function productModifierGroups(product: {\n  modifierGroups?: unknown\n}): ProductModifierGroup[] {\n  const groups = product?.modifierGroups\n  if (!Array.isArray(groups) || modifierGroupsProblem(groups)) return []\n  return groups as ProductModifierGroup[]\n}\n\n/** Whether a group must be answered before the item can be added. */\nexport function modifierGroupRequired(group: ProductModifierGroup): boolean {\n  return group.min > 0\n}\n\n/**\n * The groups the product's page on the website offers (AGL-4100): those\n * switched to \"Show on the website\". A register-only group is never sent to\n * a shopper, never asked of one and never priced on an online order.\n */\nexport function websiteModifierGroups(product: { modifierGroups?: unknown }): ProductModifierGroup[] {\n  return productModifierGroups(product).filter((group) => group.online === true)\n}\n\n/** Whether the website must ask a shopper a choice before the item goes in a cart. */\nexport function websiteModifiersRequired(product: { modifierGroups?: unknown }): boolean {\n  return websiteModifierGroups(product).some(modifierGroupRequired)\n}\n\n/**\n * What one choice adds to one unit of the picked variant (AGL-4100): its\n * price on that variant where it has one, else its own price.\n */\nexport function modifierOptionPriceCents(\n  option: Pick<ProductModifierOption, 'priceCents' | 'priceCentsByVariant'>,\n  variantId?: string | null,\n): number {\n  const byVariant = variantId ? option.priceCentsByVariant?.[variantId] : undefined\n  return typeof byVariant === 'number' && Number.isFinite(byVariant) ? byVariant : option.priceCents\n}\n\n/** A line's chosen modifiers, priced. */\nexport interface ResolvedLineModifiers {\n  ok: boolean\n  /** The chosen modifiers, in group order; empty when not `ok`. */\n  modifiers: OrderLineModifier[]\n  /** What they add to one unit, in cents. */\n  extraCents: number\n  /** What to fix, when not `ok`. */\n  error?: string\n}\n\n/** The picks a request names, as ids only, bounded; nothing for a value that is not a list. */\nexport function modifierSelectionFrom(raw: unknown): ModifierSelection[] {\n  return (Array.isArray(raw) ? raw : [])\n    .slice(0, POS_MAX_MODIFIER_GROUPS * POS_MAX_MODIFIER_OPTIONS)\n    .map((entry: any) => ({\n      groupId: String(entry?.groupId ?? ''),\n      optionId: String(entry?.optionId ?? ''),\n    }))\n}\n\n/**\n * Prices a line's chosen modifiers from the PRODUCT, in group order, and\n * checks every group's minimum and maximum. Unknown ids, a repeated choice\n * and a group answered past its maximum are refused with what to fix.\n *\n * `variantId` is the variant the line sells (AGL-4100): a choice priced by\n * variant adds its price on that one. Without it every choice adds its own\n * `priceCents`, as it always did.\n */\nexport function resolveLineModifiers(\n  product: { name?: string; modifierGroups?: unknown },\n  raw: unknown,\n  variantId?: string | null,\n): ResolvedLineModifiers {\n  const refuse = (error: string): ResolvedLineModifiers => ({\n    ok: false,\n    modifiers: [],\n    extraCents: 0,\n    error,\n  })\n  const groups = productModifierGroups(product)\n  const picks = modifierSelectionFrom(raw)\n  const seen = new Set<string>()\n  for (const pick of picks) {\n    const key = `${pick.groupId}:${pick.optionId}`\n    if (seen.has(key)) return refuse(`A choice on ${product.name} was picked twice.`)\n    seen.add(key)\n    const group = groups.find((entry) => entry.id === pick.groupId)\n    if (!group || !group.options.some((option) => option.id === pick.optionId)) {\n      return refuse(`A choice on ${product.name} is no longer offered. Remove it and add it again.`)\n    }\n  }\n  const modifiers: OrderLineModifier[] = []\n  for (const group of groups) {\n    const chosen = group.options.filter((option) =>\n      picks.some((pick) => pick.groupId === group.id && pick.optionId === option.id),\n    )\n    if (chosen.length < group.min) {\n      return refuse(`Choose ${group.name.toLowerCase()} for ${product.name}.`)\n    }\n    if (chosen.length > group.max) {\n      return refuse(`Choose at most ${group.max} for ${group.name.toLowerCase()} on ${product.name}.`)\n    }\n    for (const option of chosen) {\n      modifiers.push({\n        groupId: group.id,\n        optionId: option.id,\n        group: group.name,\n        name: option.name,\n        priceCents: modifierOptionPriceCents(option, variantId),\n      })\n    }\n  }\n  return {\n    ok: true,\n    modifiers,\n    extraCents: modifiers.reduce((sum, modifier) => sum + modifier.priceCents, 0),\n  }\n}\n\n/**\n * {@link resolveLineModifiers} for a sale made online (AGL-4100): only the\n * groups shown on the website are offered, asked or priced. A register-only\n * group, required or not, is not the shopper's to answer.\n */\nexport function resolveWebsiteLineModifiers(\n  product: { name?: string; modifierGroups?: unknown },\n  raw: unknown,\n  variantId?: string | null,\n): ResolvedLineModifiers {\n  return resolveLineModifiers(\n    { name: product.name, modifierGroups: websiteModifierGroups(product) },\n    raw,\n    variantId,\n  )\n}\n\n/**\n * The modifiers a PAID line names, for its order record (AGL-4100): every\n * pick the product still offers, in group order, priced as it is now, with no\n * minimum or maximum asked. The money was taken when the sale was priced;\n * a choice the merchant removed since is left off the record, never a reason\n * to lose the order.\n */\nexport function soldLineModifiers(\n  product: { modifierGroups?: unknown },\n  raw: unknown,\n  variantId?: string | null,\n): OrderLineModifier[] {\n  const picks = modifierSelectionFrom(raw)\n  const modifiers: OrderLineModifier[] = []\n  for (const group of productModifierGroups(product)) {\n    for (const option of group.options) {\n      if (picks.some((pick) => pick.groupId === group.id && pick.optionId === option.id)) {\n        modifiers.push({\n          groupId: group.id,\n          optionId: option.id,\n          group: group.name,\n          name: option.name,\n          priceCents: modifierOptionPriceCents(option, variantId),\n        })\n      }\n    }\n  }\n  return modifiers\n}\n\n/**\n * What a shopper is told about a cart line whose add-ons no longer answer\n * the product (AGL-4100): the resolver's reason, and how to put it right.\n */\nexport function cartLineModifierProblem(error: string | undefined): string {\n  const reason = String(error ?? '').trim() || 'The choices on this item have changed.'\n  return /Remove it and add it again/.test(reason)\n    ? reason\n    : `${reason} Remove it and add it again from its page.`\n}\n\n/** The picks a priced line keeps: ids only, in the product's group order. */\nexport function modifierSelectionOf(\n  modifiers: readonly Pick<OrderLineModifier, 'groupId' | 'optionId'>[],\n): ModifierSelection[] {\n  return modifiers.map((modifier) => ({ groupId: modifier.groupId, optionId: modifier.optionId }))\n}\n\n/**\n * The picks as one metadata value (AGL-4100), for a payment processor that\n * holds strings only: `[[\"group\",\"option\"],…]`. Empty for no picks.\n */\nexport function encodeModifierSelection(selection: readonly ModifierSelection[] | undefined): string {\n  if (!selection?.length) return ''\n  return JSON.stringify(selection.map((pick) => [pick.groupId, pick.optionId]))\n}\n\n/** {@link encodeModifierSelection} read back; nothing for a value it did not write. */\nexport function decodeModifierSelection(value: unknown): ModifierSelection[] {\n  if (typeof value !== 'string' || !value) return []\n  try {\n    const parsed: unknown = JSON.parse(value)\n    if (!Array.isArray(parsed)) return []\n    return parsed\n      .filter(\n        (pair): pair is [string, string] =>\n          Array.isArray(pair) && typeof pair[0] === 'string' && typeof pair[1] === 'string',\n      )\n      .slice(0, POS_MAX_MODIFIER_GROUPS * POS_MAX_MODIFIER_OPTIONS)\n      .map(([groupId, optionId]) => ({ groupId, optionId }))\n  } catch {\n    return []\n  }\n}\n\n/** The label a line prints: the variant, then each modifier (`Large / Oat milk, Extra shot`). */\nexport function lineLabelWithModifiers(\n  variantLabel: string | undefined,\n  modifiers: readonly Pick<OrderLineModifier, 'name'>[],\n): string {\n  const added = modifiers.map((modifier) => modifier.name).join(', ')\n  return [variantLabel, added].filter(Boolean).join(' / ')\n}\n\n/** Two lines merge only when they are the same item with the same choices. */\nexport function modifierSelectionKey(selection: readonly ModifierSelection[] | undefined): string {\n  return [...(selection ?? [])]\n    .map((pick) => `${pick.groupId}:${pick.optionId}`)\n    .sort()\n    .join('|')\n}\n"],"names":["POS_MAX_MODIFIER_GROUPS","POS_MAX_MODIFIER_OPTIONS","POS_MAX_MODIFIER_PRICE_CENTS","modifierPriceIsValid","price","Number","isInteger","modifierGroupsProblem","groups","Array","isArray","length","groupIds","Set","group","id","has","add","String","name","trim","options","optionIds","option","priceCents","byVariant","priceCentsByVariant","Object","values","some","cents","online","min","max","productModifierGroups","product","modifierGroups","modifierGroupRequired","websiteModifierGroups","filter","websiteModifiersRequired","modifierOptionPriceCents","variantId","undefined","isFinite","modifierSelectionFrom","raw","slice","map","entry","groupId","optionId","resolveLineModifiers","refuse","error","ok","modifiers","extraCents","picks","seen","pick","key","find","chosen","toLowerCase","push","reduce","sum","modifier","resolveWebsiteLineModifiers","soldLineModifiers","cartLineModifierProblem","reason","test","modifierSelectionOf","encodeModifierSelection","selection","JSON","stringify","decodeModifierSelection","value","parsed","parse","pair","lineLabelWithModifiers","variantLabel","added","join","Boolean","modifierSelectionKey","sort"],"mappings":"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"}

package/src/lib/server/billing-webhook.js

@@ -1892,7 +1892,7 @@ async function findOrderForDispute(paymentIntentId) {
         const { hostId, productId } = (_object_metadata15 = object.metadata) != null ? _object_metadata15 : {};
         if (hostId && productId) {
             var _productForSnapshot_data, _ref9, _productForSnapshot_get, _subTotals_totalCents, _productForSnapshot_get1, _ref10;
-            var _object_metadata16, _liftedForSnapshot_subscription, _object_customer_details, _object_customer_details1, _object_customer_details2;
+            var _object_metadata16, _object_metadata17, _liftedForSnapshot_subscription, _object_customer_details, _object_customer_details1, _object_customer_details2;
             const firestore = firebaseAdmin.app().firestore();
             const hostRef = firestore.collection('hosts').doc(String(hostId));
             // AGL-1732: this branch used to write the subscription doc and stop —
@@ -1923,10 +1923,16 @@ async function findOrderForDispute(paymentIntentId) {
             });
             const soldVariant = ((_object_metadata16 = object.metadata) == null ? void 0 : _object_metadata16.variantId) ? liftedForSnapshot.variants.find((item)=>item.id === String(object.metadata.variantId)) : liftedForSnapshot.variants[0];
             const variantOptions = Object.values((_ref9 = soldVariant == null ? void 0 : soldVariant.options) != null ? _ref9 : {});
+            // The add-ons bought with it (AGL-4100), named from the product; their
+            // price is already in the session's `unitAmountCents`.
+            const subModifiers = CommerceModel.soldLineModifiers(liftedForSnapshot, CommerceModel.decodeModifierSelection((_object_metadata17 = object.metadata) == null ? void 0 : _object_metadata17.modifiers), soldVariant == null ? void 0 : soldVariant.id);
+            const subLabel = CommerceModel.lineLabelWithModifiers(variantOptions.length ? variantOptions.join(' / ') : undefined, subModifiers);
             const { lineItems: subLineItems, totals: subTotals } = CommerceModel.computeBuyNowOrder(object, _extends({
                 name: String((_productForSnapshot_get = productForSnapshot.get('name')) != null ? _productForSnapshot_get : 'Product')
-            }, variantOptions.length ? {
-                variantLabel: variantOptions.join(' / ')
+            }, subLabel ? {
+                variantLabel: subLabel
+            } : {}, subModifiers.length ? {
+                modifiers: subModifiers
             } : {}, (soldVariant == null ? void 0 : soldVariant.sku) ? {
                 sku: soldVariant.sku
             } : {}, liftedForSnapshot.type ? {
@@ -2617,11 +2623,11 @@ async function findOrderForDispute(paymentIntentId) {
     }
     // Reservations (AGL-310): payment confirms the pending hold.
     if (type === 'checkout.session.completed' && (object == null ? void 0 : (_object_metadata1 = object.metadata) == null ? void 0 : _object_metadata1.type) === 'commerce-reservation' && (object == null ? void 0 : object.payment_status) === 'paid') {
-        var _object_metadata17;
-        const { hostId, reservationId } = (_object_metadata17 = object.metadata) != null ? _object_metadata17 : {};
+        var _object_metadata18;
+        const { hostId, reservationId } = (_object_metadata18 = object.metadata) != null ? _object_metadata18 : {};
         if (hostId && reservationId) {
             var _ref30, _ref31;
-            var _object_metadata18;
+            var _object_metadata19;
             const firestore = firebaseAdmin.app().firestore();
             const reservationRef = firestore.collection('hosts').doc(String(hostId)).collection('reservations').doc(String(reservationId));
             // THE MERCHANT'S LODGING TAX, SEPARATED FROM THE STAY (AGL-1969).
@@ -2633,7 +2639,7 @@ async function findOrderForDispute(paymentIntentId) {
             // `amount_total` is stay-plus-tax and Stripe's own tax fields read
             // zero; the session's metadata is the only witness, exactly as it is
             // for a buy-now sale.
-            const taxCents = Math.max(0, Math.round(Number((_ref30 = object == null ? void 0 : (_object_metadata18 = object.metadata) == null ? void 0 : _object_metadata18.taxCents) != null ? _ref30 : 0)));
+            const taxCents = Math.max(0, Math.round(Number((_ref30 = object == null ? void 0 : (_object_metadata19 = object.metadata) == null ? void 0 : _object_metadata19.taxCents) != null ? _ref30 : 0)));
             // What the guest actually handed over, MINUS that tax. This is the
             // DEPOSIT when the resource has one (`reserve.ts` charges
             // `depositCents || totalCents`), never the stay's `totalCents` — see
@@ -2850,11 +2856,11 @@ async function findOrderForDispute(paymentIntentId) {
     // Cart orders (AGL-293): one multi-line order from the cart doc;
     // clears the cart and decrements each line's stock.
     if (type === 'checkout.session.completed' && (object == null ? void 0 : (_object_metadata2 = object.metadata) == null ? void 0 : _object_metadata2.type) === 'commerce-cart' && (object == null ? void 0 : object.payment_status) === 'paid') {
-        var _object_metadata19;
-        const { hostId, cartId, feeCents, couponCode } = (_object_metadata19 = object.metadata) != null ? _object_metadata19 : {};
+        var _object_metadata20;
+        const { hostId, cartId, feeCents, couponCode } = (_object_metadata20 = object.metadata) != null ? _object_metadata20 : {};
         if (hostId && cartId) {
             var _cartSnapshot_data, _ref40, _object_shipping_details_address_postal_code, _object_shipping_details_address_country, _ref41, _ref42, _ref43, _ref44, _ref45;
-            var _object_shipping_details, _object_customer_details7, _object_metadata20, _object_customer_details8, _object_customer_details9, _object_customer_details10, _object_metadata21, _this2, _object_metadata22;
+            var _object_shipping_details, _object_customer_details7, _object_metadata21, _object_customer_details8, _object_customer_details9, _object_customer_details10, _object_metadata22, _this2, _object_metadata23;
             const firestore = firebaseAdmin.app().firestore();
             const hostRef = firestore.collection('hosts').doc(String(hostId));
             const cartRef = hostRef.collection('carts').doc(String(cartId));
@@ -2900,6 +2906,12 @@ async function findOrderForDispute(paymentIntentId) {
                 const product = productsById.get(line.productId);
                 if (!product) return null;
                 const variant = line.variantId ? product.variants.find((item)=>item.id === line.variantId) : product.variants[0];
+                // The add-ons on the line (AGL-4100), priced from the product as
+                // `cart-checkout.ts` priced them on the variant sold, and named
+                // on the line as the register names its modifiers.
+                const modifiers = CommerceModel.soldLineModifiers(product, line.modifiers, variant == null ? void 0 : variant.id);
+                const extraCents = modifiers.reduce((sum, modifier)=>sum + modifier.priceCents, 0);
+                const variantLabel = CommerceModel.lineLabelWithModifiers(variant && Object.keys((_variant_options = variant.options) != null ? _variant_options : {}).length ? Object.values((_variant_options1 = variant.options) != null ? _variant_options1 : {}).join(' / ') : undefined, modifiers);
                 return _extends({
                     productId: line.productId
                 }, line.variantId ? {
@@ -2908,8 +2920,10 @@ async function findOrderForDispute(paymentIntentId) {
                     useDayKey: line.useDayKey
                 } : {}, {
                     name: product.name
-                }, variant && Object.keys((_variant_options = variant.options) != null ? _variant_options : {}).length ? {
-                    variantLabel: Object.values((_variant_options1 = variant.options) != null ? _variant_options1 : {}).join(' / ')
+                }, variantLabel ? {
+                    variantLabel
+                } : {}, modifiers.length ? {
+                    modifiers
                 } : {}, (variant == null ? void 0 : variant.sku) ? {
                     sku: variant.sku
                 } : {}, {
@@ -2918,7 +2932,7 @@ async function findOrderForDispute(paymentIntentId) {
                     supplierId: product.supplierId
                 } : {}, {
                     quantity: line.quantity,
-                    unitAmountCents: Math.round(Number((_ref = variant == null ? void 0 : variant.priceUsd) != null ? _ref : 0) * 100)
+                    unitAmountCents: Math.round(Number((_ref = variant == null ? void 0 : variant.priceUsd) != null ? _ref : 0) * 100) + extraCents
                 });
             }).filter(Boolean);
             const shipping = (_ref40 = object == null ? void 0 : object.shipping_details) != null ? _ref40 : object == null ? void 0 : object.customer_details;
@@ -3314,7 +3328,7 @@ async function findOrderForDispute(paymentIntentId) {
             // is byte-identical to what it was before this issue for exactly that
             // reason. The hold refuses the SECOND shopper; it never gates the
             // first one's goods.
-            await releaseStockHold(hostRef, String((_ref41 = (_object_metadata20 = object.metadata) == null ? void 0 : _object_metadata20.stockHoldKey) != null ? _ref41 : ''));
+            await releaseStockHold(hostRef, String((_ref41 = (_object_metadata21 = object.metadata) == null ? void 0 : _object_metadata21.stockHoldKey) != null ? _ref41 : ''));
             const cartOrderTotal = `$${(Number((_ref42 = object == null ? void 0 : object.amount_total) != null ? _ref42 : 0) / 100).toFixed(2)}`;
             const cartUnits = lineItems.reduce((sum, line)=>sum + line.quantity, 0);
             void notifyHostManagers(String(hostId), {
@@ -3357,22 +3371,22 @@ async function findOrderForDispute(paymentIntentId) {
             }));
             if (couponCode) {
                 var _ref52;
-                var _object_metadata23;
+                var _object_metadata24;
                 await settleRedemption({
                     firestore,
                     ref: hostRef.collection('coupons').doc(String(couponCode)),
-                    holdKey: String((_ref52 = (_object_metadata23 = object.metadata) == null ? void 0 : _object_metadata23.couponHoldKey) != null ? _ref52 : ''),
+                    holdKey: String((_ref52 = (_object_metadata24 = object.metadata) == null ? void 0 : _object_metadata24.couponHoldKey) != null ? _ref52 : ''),
                     orderRef,
                     label: `coupon ${couponCode}`,
                     detail: `Coupon ${couponCode} was applied to this order but no longer ` + 'exists, so the redemption is uncounted against its limit.'
                 });
             }
             // Gift card balance settlement (AGL-322, made a settlement by AGL-2449).
-            if ((_object_metadata21 = object.metadata) == null ? void 0 : _object_metadata21.giftCardCode) {
+            if ((_object_metadata22 = object.metadata) == null ? void 0 : _object_metadata22.giftCardCode) {
                 var _ref53, _ref54;
-                var _object_metadata24, _object_metadata25;
-                const giftCardCents = Number((_ref53 = (_object_metadata24 = object.metadata) == null ? void 0 : _object_metadata24.giftCardCents) != null ? _ref53 : 0);
-                const holdKey = String((_ref54 = (_object_metadata25 = object.metadata) == null ? void 0 : _object_metadata25.giftCardHoldKey) != null ? _ref54 : '');
+                var _object_metadata25, _object_metadata26;
+                const giftCardCents = Number((_ref53 = (_object_metadata25 = object.metadata) == null ? void 0 : _object_metadata25.giftCardCents) != null ? _ref53 : 0);
+                const holdKey = String((_ref54 = (_object_metadata26 = object.metadata) == null ? void 0 : _object_metadata26.giftCardHoldKey) != null ? _ref54 : '');
                 const cardRef = hostRef.collection('giftCards').doc(String(object.metadata.giftCardCode));
                 const orphanNote = `$${(giftCardCents / 100).toFixed(2)} was applied from gift card ` + `${object.metadata.giftCardCode}, which no longer exists. The ` + 'balance was not deducted from any card.';
                 if (!holdKey) {
@@ -3538,13 +3552,13 @@ async function findOrderForDispute(paymentIntentId) {
                 }
             }
             // Discounts engine redemptions (AGL-305).
-            if ((_object_metadata22 = object.metadata) == null ? void 0 : _object_metadata22.discountId) {
+            if ((_object_metadata23 = object.metadata) == null ? void 0 : _object_metadata23.discountId) {
                 var _ref58;
-                var _object_metadata26;
+                var _object_metadata27;
                 await settleRedemption({
                     firestore,
                     ref: hostRef.collection('discounts').doc(String(object.metadata.discountId)),
-                    holdKey: String((_ref58 = (_object_metadata26 = object.metadata) == null ? void 0 : _object_metadata26.discountHoldKey) != null ? _ref58 : ''),
+                    holdKey: String((_ref58 = (_object_metadata27 = object.metadata) == null ? void 0 : _object_metadata27.discountHoldKey) != null ? _ref58 : ''),
                     orderRef,
                     label: `discount ${object.metadata.discountId}`,
                     detail: `Discount ${object.metadata.discountId} was applied to this ` + 'order but no longer exists, so the redemption is uncounted ' + 'against its limit.'
@@ -3558,8 +3572,8 @@ async function findOrderForDispute(paymentIntentId) {
     // this type and the quote's own id as `orderId`, and the quote document is
     // what becomes the order.
     if (type === 'checkout.session.completed' && (object == null ? void 0 : (_object_metadata3 = object.metadata) == null ? void 0 : _object_metadata3.type) === 'commerce-draft' && (object == null ? void 0 : object.payment_status) === 'paid') {
-        var _object_metadata27;
-        const { hostId, orderId, productId } = (_object_metadata27 = object.metadata) != null ? _object_metadata27 : {};
+        var _object_metadata28;
+        const { hostId, orderId, productId } = (_object_metadata28 = object.metadata) != null ? _object_metadata28 : {};
         if (hostId && orderId) {
             var _ref59, _ref60, _ref61;
             var _object_total_details, _object_total_details1;
@@ -3848,7 +3862,7 @@ async function findOrderForDispute(paymentIntentId) {
             }
             if (flipped) {
                 var _ref62, _ref63, _ref64, _ref65, _ref66, _ref67, _ref68;
-                var _object_metadata28, _object_customer_details15, _order_totals, _object_metadata29, _object_customer_details16;
+                var _object_metadata29, _object_customer_details15, _order_totals, _object_metadata30, _object_customer_details16;
                 const order = paidOrder;
                 // A legacy register QR sale is a register sale completing (AGL-3607).
                 if (order.channel === 'pos') {
@@ -3872,13 +3886,13 @@ async function findOrderForDispute(paymentIntentId) {
                 // `increment(1)` for uncapped promotions and sessions minted before
                 // the hold existed, which Stripe's at-least-once delivery would run
                 // twice. The transition is what makes it once.
-                if ((_object_metadata28 = object.metadata) == null ? void 0 : _object_metadata28.discountId) {
+                if ((_object_metadata29 = object.metadata) == null ? void 0 : _object_metadata29.discountId) {
                     var _ref69;
-                    var _object_metadata30;
+                    var _object_metadata31;
                     await settleRedemption({
                         firestore,
                         ref: hostRef.collection('discounts').doc(String(object.metadata.discountId)),
-                        holdKey: String((_ref69 = (_object_metadata30 = object.metadata) == null ? void 0 : _object_metadata30.discountHoldKey) != null ? _ref69 : ''),
+                        holdKey: String((_ref69 = (_object_metadata31 = object.metadata) == null ? void 0 : _object_metadata31.discountHoldKey) != null ? _ref69 : ''),
                         orderRef,
                         label: `discount ${object.metadata.discountId}`,
                         detail: `Discount ${object.metadata.discountId} was applied to this ` + 'order but no longer exists, so the redemption is uncounted ' + 'against its limit.'
@@ -3889,7 +3903,7 @@ async function findOrderForDispute(paymentIntentId) {
                 const draftPaidCents = Number((_ref64 = object == null ? void 0 : object.amount_total) != null ? _ref64 : 0) || Number((_ref65 = (_order_totals = order.totals) == null ? void 0 : _order_totals.totalCents) != null ? _ref65 : 0);
                 const isQuotePayment = CommerceModel.isQuote(order);
                 // A draft paid through its invoice's link (AGL-4099).
-                const isInvoicePayment = !isQuotePayment && String((_ref66 = object == null ? void 0 : (_object_metadata29 = object.metadata) == null ? void 0 : _object_metadata29.payLinkVersion) != null ? _ref66 : '') !== '';
+                const isInvoicePayment = !isQuotePayment && String((_ref66 = object == null ? void 0 : (_object_metadata30 = object.metadata) == null ? void 0 : _object_metadata30.payLinkVersion) != null ? _ref66 : '') !== '';
                 void notifyHostManagers(String(hostId), {
                     type: 'content.order',
                     title: isQuotePayment ? `Quote paid — ${CommerceModel.formatQuoteNumber(order, String(orderId))}` : isInvoicePayment ? `Invoice paid — ${draftLabel}` : `Draft order paid — ${draftLabel}`,
@@ -3947,13 +3961,13 @@ async function findOrderForDispute(paymentIntentId) {
                 });
                 if (productId) {
                     var _productSnapshot_data, _ref74, _ref75;
-                    var _object_metadata31, _lifted_variants_, _order_lineItems_, _order_lineItems;
+                    var _object_metadata32, _lifted_variants_, _order_lineItems_, _order_lineItems;
                     const productRef = hostRef.collection('products').doc(String(productId));
                     const productSnapshot = await productRef.get();
                     const lifted = CommerceModel.liftLegacyProduct((_productSnapshot_data = productSnapshot.data()) != null ? _productSnapshot_data : {
                         name: 'Product'
                     });
-                    const soldVariantId = String((_ref74 = (_object_metadata31 = object.metadata) == null ? void 0 : _object_metadata31.variantId) != null ? _ref74 : '') || ((_lifted_variants_ = lifted.variants[0]) == null ? void 0 : _lifted_variants_.id);
+                    const soldVariantId = String((_ref74 = (_object_metadata32 = object.metadata) == null ? void 0 : _object_metadata32.variantId) != null ? _ref74 : '') || ((_lifted_variants_ = lifted.variants[0]) == null ? void 0 : _lifted_variants_.id);
                     const quantity = (_ref75 = (_order_lineItems = order.lineItems) == null ? void 0 : (_order_lineItems_ = _order_lineItems[0]) == null ? void 0 : _order_lineItems_.quantity) != null ? _ref75 : 1;
                     if (soldVariantId) {
                         // Atomic since AGL-2320.
@@ -4069,11 +4083,11 @@ async function findOrderForDispute(paymentIntentId) {
     }
     // Commerce Starter orders (AGL-90): recorded under the selling host.
     if (type === 'checkout.session.completed' && (object == null ? void 0 : (_object_metadata4 = object.metadata) == null ? void 0 : _object_metadata4.type) === 'commerce-order' && (object == null ? void 0 : object.payment_status) === 'paid') {
-        var _object_metadata32;
-        const { hostId, productId, feeCents, couponCode } = (_object_metadata32 = object.metadata) != null ? _object_metadata32 : {};
+        var _object_metadata33;
+        const { hostId, productId, feeCents, couponCode } = (_object_metadata33 = object.metadata) != null ? _object_metadata33 : {};
         if (hostId && productId) {
             var _ref78, _productForSnapshot_get2, _productForSnapshot_data1, _ref79, _ref80, _object_shipping_details_address_postal_code1, _object_shipping_details_address_country1, _ref81, _ref82, _ref83, _ref84, _ref85;
-            var _object_metadata33, _buyNowLineItems_, _object_shipping_details1, _object_customer_details18, _object_customer_details19, _object_customer_details20, _object_metadata34;
+            var _object_metadata34, _object_metadata35, _buyNowLineItems_, _object_shipping_details1, _object_customer_details18, _object_customer_details19, _object_customer_details20, _object_metadata36;
             const firestore = firebaseAdmin.app().firestore();
             const hostRef = firestore.collection('hosts').doc(String(hostId));
             // Orders v1 (AGL-283): line-item snapshot + totals + timeline with
@@ -4095,12 +4109,19 @@ async function findOrderForDispute(paymentIntentId) {
             const liftedForSnapshot = CommerceModel.liftLegacyProduct((_productForSnapshot_data1 = productForSnapshot.data()) != null ? _productForSnapshot_data1 : {
                 name: snapshotName
             });
-            const soldVariant = ((_object_metadata33 = object.metadata) == null ? void 0 : _object_metadata33.variantId) ? liftedForSnapshot.variants.find((item)=>item.id === String(object.metadata.variantId)) : liftedForSnapshot.variants[0];
+            const soldVariant = ((_object_metadata34 = object.metadata) == null ? void 0 : _object_metadata34.variantId) ? liftedForSnapshot.variants.find((item)=>item.id === String(object.metadata.variantId)) : liftedForSnapshot.variants[0];
             const variantOptions = Object.values((_ref79 = soldVariant == null ? void 0 : soldVariant.options) != null ? _ref79 : {});
+            // The add-ons bought with it (AGL-4100), named from the product; their
+            // price is already in the session's `unitAmountCents`, so a price
+            // edit since the sale moves no money on the record.
+            const buyNowModifiers = CommerceModel.soldLineModifiers(liftedForSnapshot, CommerceModel.decodeModifierSelection((_object_metadata35 = object.metadata) == null ? void 0 : _object_metadata35.modifiers), soldVariant == null ? void 0 : soldVariant.id);
+            const buyNowLabel = CommerceModel.lineLabelWithModifiers(variantOptions.length ? variantOptions.join(' / ') : undefined, buyNowModifiers);
             const { lineItems: buyNowLineItems, totals: buyNowTotals } = CommerceModel.computeBuyNowOrder(object, _extends({
                 name: snapshotName
-            }, variantOptions.length ? {
-                variantLabel: variantOptions.join(' / ')
+            }, buyNowLabel ? {
+                variantLabel: buyNowLabel
+            } : {}, buyNowModifiers.length ? {
+                modifiers: buyNowModifiers
             } : {}, (soldVariant == null ? void 0 : soldVariant.sku) ? {
                 sku: soldVariant.sku
             } : {}, liftedForSnapshot.type ? {
@@ -4385,11 +4406,11 @@ async function findOrderForDispute(paymentIntentId) {
             // the receipt below, and no longer decides any count.
             {
                 var _productSnapshot_data2, _ref86;
-                var _object_metadata35, _lifted_variants_1;
+                var _object_metadata37, _lifted_variants_1;
                 const lifted = CommerceModel.liftLegacyProduct((_productSnapshot_data2 = productSnapshot.data()) != null ? _productSnapshot_data2 : {
                     name: 'Product'
                 });
-                const soldVariantId = String((_ref86 = (_object_metadata35 = object.metadata) == null ? void 0 : _object_metadata35.variantId) != null ? _ref86 : '') || ((_lifted_variants_1 = lifted.variants[0]) == null ? void 0 : _lifted_variants_1.id);
+                const soldVariantId = String((_ref86 = (_object_metadata37 = object.metadata) == null ? void 0 : _object_metadata37.variantId) != null ? _ref86 : '') || ((_lifted_variants_1 = lifted.variants[0]) == null ? void 0 : _lifted_variants_1.id);
                 if (soldVariantId) {
                     // AGL-1711: `-1` regardless of how many units were bought, so a
                     // 3-unit buy-now sale decremented stock by one and the difference
@@ -4422,14 +4443,14 @@ async function findOrderForDispute(paymentIntentId) {
             // Settlement, the same way round and for the same reason as the cart
             // branch above (AGL-2356): the decrement lands first, then the
             // reservation is dropped.
-            await releaseStockHold(hostRef, String((_ref85 = (_object_metadata34 = object.metadata) == null ? void 0 : _object_metadata34.stockHoldKey) != null ? _ref85 : ''));
+            await releaseStockHold(hostRef, String((_ref85 = (_object_metadata36 = object.metadata) == null ? void 0 : _object_metadata36.stockHoldKey) != null ? _ref85 : ''));
             if (couponCode) {
                 var _ref87;
-                var _object_metadata36;
+                var _object_metadata38;
                 await settleRedemption({
                     firestore,
                     ref: hostRef.collection('coupons').doc(String(couponCode)),
-                    holdKey: String((_ref87 = (_object_metadata36 = object.metadata) == null ? void 0 : _object_metadata36.couponHoldKey) != null ? _ref87 : ''),
+                    holdKey: String((_ref87 = (_object_metadata38 = object.metadata) == null ? void 0 : _object_metadata38.couponHoldKey) != null ? _ref87 : ''),
                     orderRef,
                     label: `coupon ${couponCode}`,
                     detail: `Coupon ${couponCode} was applied to this order but no longer ` + 'exists, so the redemption is uncounted against its limit.'