@final-commerce/common 2.4.0 → 2.5.0-staging.1

package/dist/index.mjs

@@ -423,6 +423,7 @@ var ProductType = /* @__PURE__ */ ((ProductType2) => {
   ProductType2["SIMPLE"] = "simple";
   ProductType2["VARIABLE"] = "variable";
   ProductType2["BOOKING"] = "booking";
+  ProductType2["COMPOSITE"] = "composite";
   return ProductType2;
 })(ProductType || {});
 var ProductStatus = /* @__PURE__ */ ((ProductStatus2) => {
@@ -1353,6 +1354,309 @@ function normalizeMongoIdString(value) {
   return null;
 }
 
+// utils/composite-price.util.ts
+var compositeItemCost = (item) => item.extraCharge * item.quantity;
+function cheapestCompositeItem(items) {
+  let cheapest;
+  items.forEach((item, index) => {
+    if (!item.available) return;
+    if (cheapest === void 0 || compositeItemCost(item) < compositeItemCost(items[cheapest])) cheapest = index;
+  });
+  return cheapest;
+}
+function cheapestCompositePrice(parts) {
+  let total = 0;
+  for (const part of parts) {
+    if (part.min === 0) continue;
+    const index = cheapestCompositeItem(part.items) ?? cheapestCompositeItem(part.items.map((item) => ({ ...item, available: true })));
+    if (index === void 0) return void 0;
+    total += part.min * compositeItemCost(part.items[index]);
+  }
+  return total;
+}
+
+// utils/modifier-resolution.util.ts
+function ancestorChain(categoryId, categoriesById) {
+  const chain = [];
+  const seen = /* @__PURE__ */ new Set([categoryId]);
+  let current = categoriesById.get(categoryId)?.parentId ?? void 0;
+  while (current && !seen.has(current)) {
+    chain.push(current);
+    seen.add(current);
+    current = categoriesById.get(current)?.parentId ?? void 0;
+  }
+  return chain;
+}
+function clampRule(rule) {
+  if (rule.min != null && rule.max != null && rule.min > rule.max) {
+    return { ...rule, min: rule.max };
+  }
+  return rule;
+}
+function mergeRules(a, b) {
+  const required = a.required || b.required;
+  const min = a.min == null ? b.min : b.min == null ? a.min : Math.max(a.min, b.min);
+  const max = a.max == null ? b.max : b.max == null ? a.max : Math.min(a.max, b.max);
+  return clampRule({ required, min, max, sortOrder: Math.min(a.sortOrder, b.sortOrder) });
+}
+function toRule(row) {
+  const required = row.required ?? false;
+  return clampRule({
+    required,
+    // `required` is the gate: a stale min left on a placement that went optional is
+    // ignored. A cleared min/max stays the explicit null it arrived as — nothing
+    // downstream distinguishes null from absent.
+    min: required ? row.min : void 0,
+    max: row.max,
+    sortOrder: row.sortOrder ?? 0
+  });
+}
+function toResolvedChoices(modifier) {
+  return (modifier.choices ?? []).map((choice, index) => ({
+    _id: String(choice._id),
+    name: choice.name,
+    price: choice.price ?? 0,
+    isDefault: choice.isDefault,
+    defaultQuantity: choice.defaultQuantity,
+    unavailableOutletIds: choice.unavailableOutletIds?.map(String),
+    sortOrder: choice.sortOrder ?? index
+  })).sort((a, b) => a.sortOrder - b.sortOrder);
+}
+function resolveModifiersForProduct(inputs) {
+  const categoriesById = new Map(
+    inputs.categories.filter((category) => !category.isDeleted).map((category) => [String(category._id), category])
+  );
+  const modifiersById = new Map(
+    inputs.modifiers.filter((modifier) => !modifier.isDeleted).map((modifier) => [String(modifier._id), modifier])
+  );
+  const directCategories = new Set(inputs.categoryIds.map(String));
+  const inheritedCategories = /* @__PURE__ */ new Set();
+  for (const categoryId of directCategories) {
+    for (const ancestor of ancestorChain(categoryId, categoriesById)) {
+      if (!directCategories.has(ancestor)) inheritedCategories.add(ancestor);
+    }
+  }
+  const rules = /* @__PURE__ */ new Map();
+  for (const placement of inputs.categoryModifiers) {
+    if (placement.isDeleted) continue;
+    const categoryId = String(placement.categoryId);
+    const precedence = directCategories.has(categoryId) ? 0 : inheritedCategories.has(categoryId) ? 1 : -1;
+    if (precedence === -1) continue;
+    const modifierId = String(placement.modifierId);
+    if (!modifiersById.has(modifierId)) continue;
+    const incoming = toRule(placement);
+    const existing = rules.get(modifierId);
+    if (!existing || precedence < existing.precedence) {
+      rules.set(modifierId, { precedence, rule: incoming });
+    } else if (precedence === existing.precedence) {
+      rules.set(modifierId, { precedence, rule: mergeRules(existing.rule, incoming) });
+    }
+  }
+  const resolved = [];
+  for (const [modifierId, { rule }] of rules) {
+    const modifier = modifiersById.get(modifierId);
+    if (!modifier) continue;
+    const required = rule.required;
+    resolved.push({
+      _id: modifierId,
+      name: modifier.name,
+      selectionType: modifier.selectionType,
+      allowQuantity: modifier.allowQuantity,
+      required,
+      // single-selection is implicitly capped at 1 — min/max are never carried.
+      min: modifier.selectionType === "single" ? void 0 : rule.min,
+      max: modifier.selectionType === "single" ? void 0 : rule.max,
+      sortOrder: rule.sortOrder,
+      choices: toResolvedChoices(modifier)
+    });
+  }
+  return resolved.sort((a, b) => a.sortOrder - b.sortOrder || a.name.localeCompare(b.name));
+}
+function isChoiceAvailableAtOutlet(choice, outletId) {
+  return !(choice.unavailableOutletIds ?? []).includes(outletId);
+}
+function hasSellableChoice(modifier, outletId) {
+  return modifier.choices.some((choice) => isChoiceAvailableAtOutlet(choice, outletId));
+}
+var modifiersSellable = (modifiers, outletId) => modifiers.every((modifier) => !modifier.required || hasSellableChoice(modifier, outletId));
+
+// utils/composite-availability.util.ts
+function poolStockAt(rows, outletId) {
+  if (!rows.some((row) => row.manageStock === true)) return null;
+  return Math.max(0, rows.find((row) => String(row.outletId) === outletId)?.quantity ?? 0);
+}
+function compositeVariantInStock(variantId, quantity, outlet) {
+  const shelf = outlet.shelves.get(variantId);
+  if (!shelf || shelf.unresolved) return false;
+  const onHand = outlet.poolStock.get(shelf.pool);
+  if (onHand === void 0) return false;
+  if (onHand === null || shelf.backorder) return true;
+  return onHand >= (shelf.unit ? toBase(quantity, shelf.unit) : quantity);
+}
+function compositeItemUnavailable(item, rows) {
+  const { outlet } = rows;
+  const sellableHere = (productId2) => !outlet || !outlet.hiddenProductIds.has(productId2) && !outlet.unsellableProductIds.has(productId2);
+  if (item.categoryId) {
+    const variants = rows.categoryVariants.get(String(item.categoryId));
+    if (!variants) return "deleted";
+    const offered = variants.filter((variantId2) => sellableHere(rows.variantProducts.get(variantId2) ?? ""));
+    if (!offered.length) return "empty";
+    if (!outlet) return null;
+    return offered.some((variantId2) => compositeVariantInStock(variantId2, item.quantity, outlet)) ? null : "out_of_stock";
+  }
+  const variantId = String(item.variantId);
+  const productId = rows.variantProducts.get(variantId);
+  if (!productId || !rows.productStatuses.has(productId)) return "deleted";
+  if (rows.productStatuses.get(productId) !== "active" /* ACTIVE */) return "inactive";
+  if (!outlet) return null;
+  if (outlet.hiddenProductIds.has(productId)) return "hidden";
+  if (outlet.unsellableProductIds.has(productId)) return "empty";
+  if (rows.bookableProductIds.has(productId)) {
+    if (!outlet.bookableSeats) return "by_date";
+    return (outlet.bookableSeats.get(productId) ?? 0) >= item.quantity ? null : "fully_booked";
+  }
+  return compositeVariantInStock(variantId, item.quantity, outlet) ? null : "out_of_stock";
+}
+function compositeMakeable(parts, rows) {
+  const { outlet } = rows;
+  if (!outlet) throw new Error("compositeMakeable counts at one outlet: rows.outlet is required");
+  const required = parts.map((part, partIndex) => ({ ...part, partIndex })).filter((part) => part.min > 0);
+  const isBookable = (variantId) => rows.bookableProductIds.has(rows.variantProducts.get(String(variantId)) ?? "");
+  if (required.some((part) => part.items.some((item) => item.variantId && isBookable(item.variantId))))
+    return { byDate: true };
+  const optionsOf = (item) => (item.categoryId ? rows.categoryVariants.get(String(item.categoryId)) ?? [] : [String(item.variantId)]).flatMap(
+    (variantId) => {
+      const reason = compositeItemUnavailable({ variantId, quantity: item.quantity }, rows);
+      const shelf = outlet.shelves.get(variantId);
+      if (reason && reason !== "out_of_stock" || !shelf) return [];
+      const stock = outlet.poolStock.get(shelf.pool);
+      const onHand = shelf.unresolved || stock === void 0 ? 0 : stock === null || shelf.backorder ? null : stock;
+      const perPick = shelf.unit ? toBase(item.quantity, shelf.unit) : item.quantity;
+      return [{ itemId: item.id, pool: shelf.pool, perPick, onHand }];
+    }
+  );
+  const counted = required.map((part) => ({ ...part, options: part.items.flatMap(optionsOf) }));
+  const order = [...counted].sort((a, b) => Number(a.options.length !== 1) - Number(b.options.length !== 1));
+  const picksLeft = (option, reserved) => option.onHand === null ? Infinity : Math.max(0, Math.floor((option.onHand - (reserved.get(option.pool) ?? 0)) / option.perPick));
+  const shortAt = (n) => {
+    const reserved = /* @__PURE__ */ new Map();
+    for (const part of order) {
+      let wanted = part.min * n;
+      const ranked = [...part.options].sort((a, b) => picksLeft(b, reserved) - picksLeft(a, reserved));
+      for (const option of ranked) {
+        if (wanted <= 0) break;
+        const taken = Math.min(wanted, picksLeft(option, reserved));
+        if (option.onHand !== null)
+          reserved.set(option.pool, (reserved.get(option.pool) ?? 0) + taken * option.perPick);
+        wanted -= taken;
+      }
+      if (wanted > 0) return part.partIndex;
+    }
+    return void 0;
+  };
+  const whyRows = [];
+  const rowPools = /* @__PURE__ */ new Map();
+  const makes = (has, uses) => has === null ? null : Math.floor(has / uses);
+  for (const part of counted) {
+    const [option] = part.options;
+    if (part.options.length === 1) {
+      const uses = option.perPick * part.min;
+      const row = whyRows.find((candidate) => rowPools.get(candidate) === option.pool);
+      if (!row) {
+        const created = { itemIds: [option.itemId], uses, has: option.onHand, makes: makes(option.onHand, uses) };
+        rowPools.set(created, option.pool);
+        whyRows.push(created);
+        continue;
+      }
+      row.itemIds.push(option.itemId);
+      row.uses += uses;
+      if (option.onHand === null) row.has = null;
+      row.makes = makes(row.has, row.uses);
+      continue;
+    }
+    const perPool = /* @__PURE__ */ new Map();
+    for (const candidate of part.options)
+      perPool.set(candidate.pool, Math.max(perPool.get(candidate.pool) ?? 0, picksLeft(candidate, /* @__PURE__ */ new Map())));
+    const total = [...perPool.values()].reduce((sum, picks) => sum + picks, 0);
+    const has = total === Infinity ? null : total;
+    whyRows.push({
+      itemIds: part.items.map((item) => item.id),
+      partIndex: part.partIndex,
+      uses: part.min,
+      has,
+      makes: makes(has, part.min)
+    });
+  }
+  if (counted.every((part) => part.options.some((option) => option.onHand === null)))
+    return { count: null, rows: whyRows };
+  const ceiling = Math.min(
+    ...counted.filter((part) => !part.options.some((option) => option.onHand === null)).map(
+      (part) => Math.floor(part.options.reduce((sum, option) => sum + picksLeft(option, /* @__PURE__ */ new Map()), 0) / part.min)
+    )
+  );
+  let [low, high] = [0, ceiling];
+  while (low < high) {
+    const mid = Math.ceil((low + high) / 2);
+    if (shortAt(mid) === void 0) low = mid;
+    else high = mid - 1;
+  }
+  const short = shortAt(low + 1);
+  const shortPart = counted.find((part) => part.partIndex === short);
+  const limitedBy = whyRows.findIndex(
+    (row) => shortPart?.options.length === 1 ? row.partIndex === void 0 && row.itemIds.includes(shortPart.options[0].itemId) : row.partIndex === short
+  );
+  return { count: low, rows: whyRows, ...limitedBy >= 0 ? { limitedBy } : {} };
+}
+var poolOf = (line) => line.stockVariantId || line.variantId;
+function poolDemand(lines) {
+  const demand = /* @__PURE__ */ new Map();
+  const add = (line, times) => demand.set(
+    poolOf(line),
+    (demand.get(poolOf(line)) ?? 0) + (line.unit ? toBase(line.quantity * times, line.unit) : line.quantity * times)
+  );
+  for (const line of lines) {
+    if (line.components) for (const component of line.components) add(component, line.quantity);
+    else add(line, 1);
+  }
+  return demand;
+}
+function poolShortfall(demand, poolStock, backordered = /* @__PURE__ */ new Set()) {
+  for (const [poolId, wanted] of demand) {
+    const available = poolStock.get(poolId);
+    if (available === null || available === void 0 || backordered.has(poolId)) continue;
+    if (wanted > available) return { poolId, available, wanted };
+  }
+  return null;
+}
+
+// utils/composite-reservation.util.ts
+function compositeModifierMismatches(lineItems) {
+  return lineItems.flatMap(
+    (line) => line.components?.length ? (line.modifiers ?? []).flatMap(
+      (modifier) => modifier.componentIndex !== void 0 && line.components[modifier.componentIndex] !== void 0 ? [] : [
+        `Modifier ${modifier.modifierName ?? "?"} on composite line ${line.internalId ?? "?"} names no component (componentIndex ${modifier.componentIndex}) \u2014 a composite has no modifiers of its own`
+      ]
+    ) : []
+  );
+}
+function compositeReservationMismatches(order) {
+  return (order.reservations ?? []).flatMap((reservation) => {
+    if (reservation.lineItemInternalId === void 0) return [];
+    const name = `Booking ${String(reservation.bookingId ?? "?")}`;
+    const line = order.lineItems?.find((candidate) => candidate.internalId === reservation.lineItemInternalId);
+    if (!line) return [`${name} names line ${reservation.lineItemInternalId}, which is not on the order`];
+    const component = reservation.componentIndex === void 0 ? void 0 : line.components?.[reservation.componentIndex];
+    if (!component) return [`${name} names no component ${reservation.componentIndex} of line ${line.internalId}`];
+    if (String(component.productId) !== String(reservation.productId))
+      return [
+        `${name} is for ${String(reservation.productId)}, but that component sold ${String(component.productId)}`
+      ];
+    if (reservation.price !== 0 || reservation.total !== 0)
+      return [`${name} carries money (${reservation.price}/${reservation.total}); its component already does`];
+    return [];
+  });
+}
+
 // units/family-code.ts
 var MAX_SLUG_LENGTH = 32;
 var FALLBACK_SLUG = "family";
@@ -3002,7 +3306,9 @@ function buildGrid(rule, timeZone, from, to, now, busy = []) {
     const start = startAt.getTime();
     if (start < askedFrom || start >= askedTo) return false;
     if (start < notBefore || start > notAfter) return false;
-    return !blocked.some(({ from: blockFrom, to: blockTo }) => start < blockTo && bufferEndAt.getTime() > blockFrom);
+    return !blocked.some(
+      ({ from: blockFrom, to: blockTo }) => start < blockTo && bufferEndAt.getTime() > blockFrom
+    );
   }).sort((first, second) => +first.startAt - +second.startAt);
 }
 function slotsForWindow(grid, startAt, endAt) {
@@ -3121,7 +3427,14 @@ function buildAvailability({
     for (const slot of slots2) {
       const { taken, foreignProductId } = occupancyIn(mine, productId, slot.startAt, slot.bufferEndAt, shared);
       const free = foreignProductId ? 0 : Math.max(capacity - taken, 0);
-      const entry = byInstant.get(+slot.startAt) ?? { ...slot, capacity: 0, booked: 0, free: 0, resources: [], dayKey: shopDayKey(slot.startAt, resource.timeZone) };
+      const entry = byInstant.get(+slot.startAt) ?? {
+        ...slot,
+        capacity: 0,
+        booked: 0,
+        free: 0,
+        resources: [],
+        dayKey: shopDayKey(slot.startAt, resource.timeZone)
+      };
       entry.capacity += capacity;
       entry.booked += foreignProductId ? capacity : taken;
       entry.free += free;
@@ -3279,6 +3592,7 @@ export {
   UserTypes,
   addAmounts,
   amountToString,
+  ancestorChain,
   assertUnitSane,
   availableIn,
   baseFor,
@@ -3292,6 +3606,14 @@ export {
   buildResolvedConfig,
   calculatePercentage,
   canTransition,
+  cheapestCompositeItem,
+  cheapestCompositePrice,
+  compositeItemCost,
+  compositeItemUnavailable,
+  compositeMakeable,
+  compositeModifierMismatches,
+  compositeReservationMismatches,
+  compositeVariantInStock,
   conditionSummary,
   convertFixedFeeToLocalCurrency,
   createAmount,
@@ -3326,9 +3648,11 @@ export {
   getPricingRegionFromCountry,
   getSettlementTotal,
   getTotalCollected,
+  hasSellableChoice,
   holdExpiresAt,
   inferStatesFromLegacyStatus,
   isAdyenRolloutCountry,
+  isChoiceAvailableAtOutlet,
   isConditionOperator,
   isFulfillmentState,
   isPaymentState,
@@ -3339,6 +3663,7 @@ export {
   mapToLegacyStatus,
   maxPrecisionFor,
   mergeFragment,
+  modifiersSellable,
   multiplyAmount,
   normalizeMongoIdString,
   occupancyIn,
@@ -3346,9 +3671,14 @@ export {
   parseCurrencyCode,
   parseStripeCurrencyCode,
   planWindow,
+  poolDemand,
+  poolOf,
+  poolShortfall,
+  poolStockAt,
   presentAt,
   removeFragment,
   resolveFamily,
+  resolveModifiersForProduct,
   resolveTemplate,
   resolveUnit,
   roundToPrecision,