@munchi_oy/cart-engine 0.1.2 → 0.1.5

package/dist/index.js

@@ -8,6 +8,7 @@ import {
   OrderRefundStatus,
   OrderStatusEnum,
   OrderTypePOS,
+  PosDiscountTargetType as PosDiscountTargetType2,
   PosPaymentStatus,
   ProviderEnum as Provider
 } from "@munchi_oy/core";
@@ -16,7 +17,12 @@ import dayjs from "dayjs";
 import lodash from "lodash";
 
 // src/pricing/calculator.ts
-import { DiscountScope, KitchenStatus } from "@munchi_oy/core";
+import {
+  CheckoutModelEnum,
+  DiscountScope,
+  KitchenStatus,
+  PosDiscountTargetType
+} from "@munchi_oy/core";
 
 // src/discount/calculator.ts
 import { DiscountType } from "@munchi_oy/core";
@@ -77,7 +83,49 @@ function calculateSequentialDiscountTotal(discounts, initialAmount) {
   };
 }
 
+// src/discount/modulo.ts
+var allocateProportionalMinorUnits = withSafeIntegers(
+  (weights, totalAmount) => {
+    for (let i = 0; i < weights.length; i++) {
+      if (!Number.isInteger(weights[i])) {
+        throw new Error(
+          `[CartEngine SafeLock] Weight at index ${i} MUST be an integer. Received: ${weights[i]}`
+        );
+      }
+    }
+    if (weights.length === 0 || totalAmount <= 0) {
+      return new Array(weights.length).fill(0);
+    }
+    const totalWeight = weights.reduce((sum, weight) => sum + weight, 0);
+    if (totalWeight <= 0) {
+      return new Array(weights.length).fill(0);
+    }
+    const baseAllocations = weights.map(
+      (weight) => Math.floor(weight * totalAmount / totalWeight)
+    );
+    const remainderOrder = weights.map((weight, index) => ({
+      index,
+      remainder: weight * totalAmount % totalWeight
+    })).sort(
+      (left, right) => right.remainder - left.remainder || left.index - right.index
+    );
+    let remainingAmount = totalAmount - baseAllocations.reduce((sum, amount) => sum + amount, 0);
+    for (const { index } of remainderOrder) {
+      if (remainingAmount <= 0) break;
+      baseAllocations[index] = (baseAllocations[index] ?? 0) + 1;
+      remainingAmount -= 1;
+    }
+    return baseAllocations;
+  }
+);
+
 // src/pricing/calculator.ts
+var EMPTY_SPLIT_PRICING_RESULT = {
+  targets: [],
+  totalGrossAmount: 0,
+  totalDiscountAmount: 0,
+  totalNetAmount: 0
+};
 var assertMinorUnit = (value, fieldName) => {
   if (!Number.isInteger(value)) {
     throw new Error(
@@ -85,6 +133,93 @@ var assertMinorUnit = (value, fieldName) => {
     );
   }
 };
+var sortDiscountsByCreatedAt = (discounts) => {
+  return [...discounts].sort(
+    (left, right) => new Date(left.createdAt).getTime() - new Date(right.createdAt).getTime()
+  );
+};
+var calculateTargetPricing = (id, grossAmount, discounts) => {
+  assertMinorUnit(grossAmount, `target gross amount (${id})`);
+  const { totalDiscountAmount, remainingAmount } = calculateSequentialDiscountTotal(discounts, grossAmount);
+  return {
+    id,
+    grossAmount,
+    discountAmount: totalDiscountAmount,
+    netAmount: remainingAmount
+  };
+};
+var sumAmounts = (targets, field) => {
+  return targets.reduce((sum, target) => sum + target[field], 0);
+};
+var buildSplitPricingResult = (targets) => {
+  return {
+    targets,
+    totalGrossAmount: sumAmounts(targets, "grossAmount"),
+    totalDiscountAmount: sumAmounts(targets, "discountAmount"),
+    totalNetAmount: sumAmounts(targets, "netAmount")
+  };
+};
+var filterTargetedDiscounts = (discounts, targetType, targetId) => {
+  return sortDiscountsByCreatedAt(
+    discounts.filter(
+      (discount) => discount.targetType === targetType && discount.targetId === targetId
+    )
+  );
+};
+var getSeatGrossAmount = (seat) => {
+  return seat.assignments.reduce((sum, assignment) => {
+    assertMinorUnit(assignment.amount, `seat assignment amount (${seat.id})`);
+    return sum + assignment.amount;
+  }, 0);
+};
+var getEqualSplitPartIds = (equalSplitState) => {
+  const partCount = Math.max(equalSplitState.partCount, equalSplitState.parts.length);
+  const ids = equalSplitState.parts.map((part) => part.id);
+  for (let index = ids.length; index < partCount; index += 1) {
+    ids.push(`__generated_equal_split_part_${index + 1}`);
+  }
+  return ids;
+};
+function calculateItemSplitSeatPricing(details) {
+  if (!details.tableService) {
+    return EMPTY_SPLIT_PRICING_RESULT;
+  }
+  const targets = details.tableService.itemSplitSeats.map(
+    (seat) => calculateTargetPricing(
+      seat.id,
+      getSeatGrossAmount(seat),
+      filterTargetedDiscounts(
+        details.discounts,
+        PosDiscountTargetType.ItemSplitSeat,
+        seat.id
+      )
+    )
+  );
+  return buildSplitPricingResult(targets);
+}
+function calculateEqualSplitPartPricing(details) {
+  assertMinorUnit(details.totalAmount, "details.totalAmount");
+  if (!details.equalSplitState || details.equalSplitState.partCount <= 0) {
+    return EMPTY_SPLIT_PRICING_RESULT;
+  }
+  const partIds = getEqualSplitPartIds(details.equalSplitState);
+  const grossAmounts = allocateProportionalMinorUnits(
+    new Array(partIds.length).fill(1),
+    details.totalAmount
+  );
+  const targets = partIds.map(
+    (partId, index) => calculateTargetPricing(
+      partId,
+      grossAmounts[index] ?? 0,
+      filterTargetedDiscounts(
+        details.discounts,
+        PosDiscountTargetType.EqualSplitPart,
+        partId
+      )
+    )
+  );
+  return buildSplitPricingResult(targets);
+}
 function calculateItemPrice(details) {
   assertMinorUnit(details.basePriceInMinorUnit, "details.basePriceInMinorUnit");
   assertMinorUnit(details.quantity, "details.quantity");
@@ -147,7 +282,9 @@ function calculateCartPriceSnapshot(details) {
     (sum, item) => sum + (item.itemPrice.priceBreakdown.totalDiscounts.amount ?? 0),
     0
   );
-  const cartDiscounts = details.discounts.filter((discount) => discount.scope === DiscountScope.Cart).sort(
+  const cartDiscounts = details.discounts.filter(
+    (discount) => discount.scope === DiscountScope.Cart && (discount.targetType === null || discount.targetType === void 0 || discount.targetType === PosDiscountTargetType.Order)
+  ).sort(
     (left, right) => new Date(left.createdAt).getTime() - new Date(right.createdAt).getTime()
   );
   const grossAfterItemDiscounts = Math.max(
@@ -158,7 +295,21 @@ function calculateCartPriceSnapshot(details) {
     cartDiscounts,
     grossAfterItemDiscounts
   );
-  const totalDiscountsAmount = subtotalItemDiscountsAmount + cartDiscountCalculation.totalDiscountAmount;
+  const itemSplitSeatPricing = details.checkoutModel === CheckoutModelEnum.ItemSplit ? calculateItemSplitSeatPricing({
+    tableService: details.tableService,
+    discounts: details.discounts
+  }) : null;
+  const equalSplitPartPricing = details.checkoutModel === CheckoutModelEnum.EqualSplit ? calculateEqualSplitPartPricing({
+    totalAmount: cartDiscountCalculation.remainingAmount,
+    equalSplitState: details.equalSplitState,
+    discounts: details.discounts
+  }) : null;
+  const subtotalTargetedDiscountsAmount = itemSplitSeatPricing?.totalDiscountAmount ?? equalSplitPartPricing?.totalDiscountAmount ?? 0;
+  const totalAmount = Math.max(
+    0,
+    cartDiscountCalculation.remainingAmount - subtotalTargetedDiscountsAmount
+  );
+  const totalDiscountsAmount = subtotalItemDiscountsAmount + cartDiscountCalculation.totalDiscountAmount + subtotalTargetedDiscountsAmount;
   const price = {
     priceBreakdown: {
       totalBeforeDiscounts: {
@@ -179,7 +330,7 @@ function calculateCartPriceSnapshot(details) {
       }
     },
     total: {
-      amount: cartDiscountCalculation.remainingAmount,
+      amount: totalAmount,
       currency: details.currency
     }
   };
@@ -188,52 +339,17 @@ function calculateCartPriceSnapshot(details) {
     totalBeforeDiscountsAmount,
     subtotalItemDiscountsAmount,
     subtotalBasketDiscountsAmount: cartDiscountCalculation.totalDiscountAmount,
+    subtotalTargetedDiscountsAmount,
     totalDiscountsAmount,
-    totalAmount: cartDiscountCalculation.remainingAmount,
+    totalAmount,
+    itemSplitSeatPricing,
+    equalSplitPartPricing,
     price
   };
 }
 
 // src/tax/index.ts
 import { KitchenStatus as KitchenStatus2 } from "@munchi_oy/core";
-
-// src/discount/modulo.ts
-var allocateProportionalMinorUnits = withSafeIntegers(
-  (weights, totalAmount) => {
-    for (let i = 0; i < weights.length; i++) {
-      if (!Number.isInteger(weights[i])) {
-        throw new Error(
-          `[CartEngine SafeLock] Weight at index ${i} MUST be an integer. Received: ${weights[i]}`
-        );
-      }
-    }
-    if (weights.length === 0 || totalAmount <= 0) {
-      return new Array(weights.length).fill(0);
-    }
-    const totalWeight = weights.reduce((sum, weight) => sum + weight, 0);
-    if (totalWeight <= 0) {
-      return new Array(weights.length).fill(0);
-    }
-    const baseAllocations = weights.map(
-      (weight) => Math.floor(weight * totalAmount / totalWeight)
-    );
-    const remainderOrder = weights.map((weight, index) => ({
-      index,
-      remainder: weight * totalAmount % totalWeight
-    })).sort(
-      (left, right) => right.remainder - left.remainder || left.index - right.index
-    );
-    let remainingAmount = totalAmount - baseAllocations.reduce((sum, amount) => sum + amount, 0);
-    for (const { index } of remainderOrder) {
-      if (remainingAmount <= 0) break;
-      baseAllocations[index] = (baseAllocations[index] ?? 0) + 1;
-      remainingAmount -= 1;
-    }
-    return baseAllocations;
-  }
-);
-
-// src/tax/index.ts
 function assertMinorUnit2(value, fieldName) {
   if (!Number.isInteger(value)) {
     throw new Error(
@@ -341,6 +457,76 @@ function calculateOrderTaxSummary(details) {
 
 // src/cart/Cart.ts
 var { isEqual } = lodash;
+function cloneEqualSplitPart(part) {
+  return {
+    ...part,
+    name: part.name ?? null,
+    loyaltyId: part.loyaltyId ?? null,
+    loyaltyUserName: part.loyaltyUserName ?? null,
+    appliedDiscountIds: [...part.appliedDiscountIds ?? []]
+  };
+}
+function cloneEqualSplitState(equalSplitState) {
+  if (!equalSplitState) {
+    return null;
+  }
+  return {
+    partCount: equalSplitState.partCount,
+    parts: (equalSplitState.parts ?? []).map(cloneEqualSplitPart)
+  };
+}
+function createEmptyEqualSplitState() {
+  return {
+    partCount: 0,
+    parts: []
+  };
+}
+function cloneItemSplitSeatAssignment(assignment) {
+  return {
+    ...assignment,
+    appliedDiscountIds: [...assignment.appliedDiscountIds ?? []]
+  };
+}
+function cloneItemSplitSeat(seat) {
+  return {
+    ...seat,
+    name: seat.name ?? null,
+    loyaltyId: seat.loyaltyId ?? null,
+    loyaltyUserName: seat.loyaltyUserName ?? null,
+    appliedDiscountIds: [...seat.appliedDiscountIds ?? []],
+    assignments: (seat.assignments ?? []).map(cloneItemSplitSeatAssignment)
+  };
+}
+function cloneTableService(tableService) {
+  if (!tableService) {
+    return null;
+  }
+  return {
+    name: tableService.name ?? null,
+    seats: tableService.seats,
+    itemSplitSeats: (tableService.itemSplitSeats ?? []).map(cloneItemSplitSeat)
+  };
+}
+function createEmptyTableService() {
+  return {
+    name: null,
+    seats: 0,
+    itemSplitSeats: []
+  };
+}
+function validateEqualSplitState(equalSplitState) {
+  if (!equalSplitState) {
+    return;
+  }
+  if (!Number.isInteger(equalSplitState.partCount) || equalSplitState.partCount < 0) {
+    throw new Error("Equal split part count must be a non-negative integer");
+  }
+  if (equalSplitState.parts.length > equalSplitState.partCount) {
+    throw new Error(
+      "Equal split state cannot contain more parts than partCount"
+    );
+  }
+}
 var Cart = class _Cart {
   id;
   businessId;
@@ -365,11 +551,13 @@ var Cart = class _Cart {
   _customer = null;
   _refunds = [];
   _tableService;
+  _equalSplitState;
   _taxSummary;
   _newlyCancelledItemIds;
   _invoiceCompany;
   _staffId;
   _shiftId;
+  _aggregateMatchingItemsOnAdd;
   version = "1.0.2";
   constructor(id, createdAt, options) {
     this.id = id;
@@ -378,6 +566,7 @@ var Cart = class _Cart {
     this.provider = options.provider;
     this.orderType = options.orderType;
     this.orderNumber = options.orderNumber;
+    this._aggregateMatchingItemsOnAdd = options.aggregateMatchingItemsOnAdd;
     this.checkoutModel = options.checkoutModel;
     this._business = options.business;
     this.currency = options.currency;
@@ -390,7 +579,8 @@ var Cart = class _Cart {
     this.status = OrderStatusEnum.Draft;
     this.orderFormat = OrderFormat.Instant;
     this._locatorType = LocatorType.Table;
-    this._tableService = options.tableService ?? null;
+    this._tableService = cloneTableService(options.tableService);
+    this._equalSplitState = cloneEqualSplitState(options.equalSplitState);
     this._newlyCancelledItemIds = /* @__PURE__ */ new Set();
     this._staffId = options.staffId ?? null;
     this._shiftId = options.shiftId ?? null;
@@ -402,8 +592,10 @@ var Cart = class _Cart {
       provider: options.provider ?? Provider.MunchiPos,
       orderType: options.orderType ?? OrderTypePOS.DineIn,
       orderNumber: options.orderNumber,
+      aggregateMatchingItemsOnAdd: options.aggregateMatchingItemsOnAdd ?? false,
       checkoutModel: options.checkoutModel ?? CheckoutModel.Full,
       tableService: options.tableService ?? null,
+      equalSplitState: options.equalSplitState ?? null,
       currency: options.currency,
       business: options.business,
       staffId: options.staffId,
@@ -416,8 +608,10 @@ var Cart = class _Cart {
       provider: orderDto.provider,
       orderType: orderDto.orderType,
       orderNumber: orderDto.orderNumber,
+      aggregateMatchingItemsOnAdd: false,
       checkoutModel: orderDto.checkoutModel,
       tableService: orderDto.tableService ?? null,
+      equalSplitState: orderDto.equalSplitState ?? null,
       currency: orderDto.currency,
       business: orderDto.business,
       staffId: orderDto.staffId ?? null,
@@ -439,7 +633,8 @@ var Cart = class _Cart {
     cart._refunds = orderDto.refunds ? [...orderDto.refunds] : [];
     cart._loyaltyTransactionIds = [...orderDto.loyaltyTransactionIds];
     cart._loyaltyProgramId = orderDto.loyaltyProgramId ?? null;
-    cart._tableService = orderDto.tableService ? { ...orderDto.tableService } : null;
+    cart._tableService = cloneTableService(orderDto.tableService);
+    cart._equalSplitState = cloneEqualSplitState(orderDto.equalSplitState);
     cart._newlyCancelledItemIds = /* @__PURE__ */ new Set();
     cart._taxSummary = orderDto.taxSummary;
     cart._invoiceCompany = orderDto.invoiceCompany ?? null;
@@ -475,17 +670,29 @@ var Cart = class _Cart {
   get invoiceCompany() {
     return this._invoiceCompany;
   }
+  get aggregateMatchingItemsOnAdd() {
+    return this._aggregateMatchingItemsOnAdd;
+  }
   get guestCount() {
     return this._tableService?.seats ?? null;
   }
   get tableService() {
-    return this._tableService;
+    return this.getTableService();
+  }
+  get equalSplitState() {
+    return this.getEqualSplitState();
+  }
+  get equalSplitPartCount() {
+    return this._equalSplitState?.partCount ?? null;
   }
   get price() {
     return calculateCartPriceSnapshot({
       items: this._items,
       discounts: this._discounts,
-      currency: this.currency
+      currency: this.currency,
+      checkoutModel: this.checkoutModel,
+      tableService: this._tableService,
+      equalSplitState: this._equalSplitState
     }).price;
   }
   setInvoiceCompany(company) {
@@ -495,6 +702,9 @@ var Cart = class _Cart {
     this._invoiceCompany = company;
     this.touch();
   }
+  setAggregateMatchingItemsOnAdd(enabled) {
+    this._aggregateMatchingItemsOnAdd = enabled;
+  }
   addItem(itemData, requiresPrep = false) {
     const lockedStatuses = [
       KitchenStatus3.DispatchedToKitchen,
@@ -502,9 +712,9 @@ var Cart = class _Cart {
       KitchenStatus3.Completed,
       KitchenStatus3.Cancelled
     ];
-    const existingModifiableItem = this._items.find(
+    const existingModifiableItem = this._aggregateMatchingItemsOnAdd ? this._items.find(
       (item) => item.posId === itemData.posId && isEqual(item.options, itemData.options) && item.comments === itemData.comments && !lockedStatuses.includes(item.kitchenStatus) && item.discount === null
-    );
+    ) : void 0;
     if (existingModifiableItem) {
       this._items = this._items.map((item) => {
         if (item.lineItemId !== existingModifiableItem.lineItemId) {
@@ -527,13 +737,24 @@ var Cart = class _Cart {
       this.touch();
       return;
     }
-    this._items.push({
-      ...itemData,
-      lineItemId: createId(),
-      kitchenStatus: requiresPrep ? KitchenStatus3.Pending : KitchenStatus3.NotApplicable,
-      paymentStatus: PosPaymentStatus.Unpaid,
-      discount: null
-    });
+    const quantityPerLine = this._aggregateMatchingItemsOnAdd ? [itemData.quantity] : Array.from({ length: itemData.quantity }, () => 1);
+    for (const quantity of quantityPerLine) {
+      this._items.push({
+        ...itemData,
+        quantity,
+        itemPrice: calculateItemPrice({
+          basePriceInMinorUnit: itemData.basePrice.amount,
+          quantity,
+          taxRate: itemData.taxRate,
+          options: itemData.options,
+          currency: this.currency
+        }),
+        lineItemId: createId(),
+        kitchenStatus: requiresPrep ? KitchenStatus3.Pending : KitchenStatus3.NotApplicable,
+        paymentStatus: PosPaymentStatus.Unpaid,
+        discount: null
+      });
+    }
     this.touch();
   }
   updateItem(lineItemId, updatedItem) {
@@ -588,21 +809,25 @@ var Cart = class _Cart {
     this._newlyCancelledItemIds.clear();
   }
   applyDiscountToCart(discountData) {
-    this._discounts.push({
-      ...discountData,
-      scope: DiscountScope2.Cart,
-      lineItemId: null,
-      createdAt: dayjs().toDate().toISOString()
-    });
+    this._discounts.push(
+      this.createDiscountRecord(
+        discountData,
+        DiscountScope2.Cart,
+        null,
+        PosDiscountTargetType2.Order,
+        null
+      )
+    );
     this.touch();
   }
   applyDiscountToItem(lineItemId, discountData) {
-    const newDiscount = {
-      ...discountData,
-      scope: DiscountScope2.Item,
+    const newDiscount = this.createDiscountRecord(
+      discountData,
+      DiscountScope2.Item,
       lineItemId,
-      createdAt: dayjs().toDate().toISOString()
-    };
+      PosDiscountTargetType2.LineItem,
+      lineItemId
+    );
     const existingDiscountIndex = this._discounts.findIndex(
       (discount) => discount.lineItemId === lineItemId && discount.scope === DiscountScope2.Item
     );
@@ -633,6 +858,42 @@ var Cart = class _Cart {
     });
     this.touch();
   }
+  applyDiscountToItemSplitSeat(seatId, discountData) {
+    this._discounts.push(
+      this.createDiscountRecord(
+        discountData,
+        DiscountScope2.Cart,
+        null,
+        PosDiscountTargetType2.ItemSplitSeat,
+        seatId
+      )
+    );
+    this.touch();
+  }
+  applyDiscountToItemSplitAssignment(assignmentId, discountData) {
+    this._discounts.push(
+      this.createDiscountRecord(
+        discountData,
+        DiscountScope2.Cart,
+        null,
+        PosDiscountTargetType2.ItemSplitAssignment,
+        assignmentId
+      )
+    );
+    this.touch();
+  }
+  applyDiscountToEqualSplitPart(partId, discountData) {
+    this._discounts.push(
+      this.createDiscountRecord(
+        discountData,
+        DiscountScope2.Cart,
+        null,
+        PosDiscountTargetType2.EqualSplitPart,
+        partId
+      )
+    );
+    this.touch();
+  }
   removeItemDiscount(lineItemId) {
     this._items = this._items.map((item) => {
       if (item.lineItemId !== lineItemId) {
@@ -745,15 +1006,277 @@ var Cart = class _Cart {
     this.setCheckoutModel(checkoutModel);
   }
   setGuestCount(guestCount) {
-    if ((this._tableService?.seats ?? null) === guestCount) {
+    if (guestCount === null) {
+      if (this._tableService === null) {
+        return;
+      }
+      this._tableService = null;
+      this.touch();
       return;
     }
-    this._tableService = guestCount === null ? null : { seats: guestCount };
-    this.touch();
+    this.setSeatsCount(guestCount);
   }
   setSeatNumber(guestCount) {
     this.setGuestCount(guestCount);
   }
+  getTableService() {
+    return cloneTableService(this._tableService);
+  }
+  setTableService(tableService) {
+    const nextTableService = cloneTableService(tableService);
+    if (isEqual(this._tableService, nextTableService)) {
+      return this;
+    }
+    this._tableService = nextTableService;
+    this.touch();
+    return this;
+  }
+  clearTableService() {
+    return this.setTableService(null);
+  }
+  getTableName() {
+    return this._tableService?.name ?? null;
+  }
+  setTableName(name) {
+    const tableService = this.getTableService() ?? createEmptyTableService();
+    if (tableService.name === name) {
+      return this;
+    }
+    tableService.name = name;
+    return this.setTableService(tableService);
+  }
+  getSeatsCount() {
+    return this._tableService?.seats ?? null;
+  }
+  setSeatsCount(seats) {
+    if (!Number.isInteger(seats) || seats < 0) {
+      throw new Error("Seats count must be a non-negative integer");
+    }
+    const tableService = this.getTableService() ?? createEmptyTableService();
+    if (tableService.seats === seats) {
+      return this;
+    }
+    tableService.seats = seats;
+    return this.setTableService(tableService);
+  }
+  getItemSplitSeats() {
+    return this._tableService ? this._tableService.itemSplitSeats.map(cloneItemSplitSeat) : [];
+  }
+  setItemSplitSeats(seats) {
+    const tableService = this.getTableService() ?? createEmptyTableService();
+    tableService.itemSplitSeats = seats.map(cloneItemSplitSeat);
+    return this.setTableService(tableService);
+  }
+  clearItemSplitSeats() {
+    return this.setItemSplitSeats([]);
+  }
+  addItemSplitSeat(seat) {
+    if (this.getItemSplitSeatById(seat.id)) {
+      return this;
+    }
+    const seats = this.getItemSplitSeats();
+    seats.push(cloneItemSplitSeat(seat));
+    return this.setItemSplitSeats(seats);
+  }
+  updateItemSplitSeat(seatId, updater) {
+    const seats = this.getItemSplitSeats();
+    const seatIndex = seats.findIndex((seat) => seat.id === seatId);
+    if (seatIndex === -1 || !seats[seatIndex]) {
+      return this;
+    }
+    seats[seatIndex] = cloneItemSplitSeat(updater(cloneItemSplitSeat(seats[seatIndex])));
+    return this.setItemSplitSeats(seats);
+  }
+  removeItemSplitSeat(seatId) {
+    const seats = this.getItemSplitSeats();
+    const nextSeats = seats.filter((seat) => seat.id !== seatId);
+    if (nextSeats.length === seats.length) {
+      return this;
+    }
+    return this.setItemSplitSeats(nextSeats);
+  }
+  getItemSplitSeatById(seatId) {
+    const seat = this._tableService?.itemSplitSeats.find(
+      (itemSplitSeat) => itemSplitSeat.id === seatId
+    );
+    return seat ? cloneItemSplitSeat(seat) : null;
+  }
+  setItemSplitSeatAssignments(seatId, assignments) {
+    return this.updateItemSplitSeat(seatId, (seat) => ({
+      ...seat,
+      assignments: assignments.map(cloneItemSplitSeatAssignment)
+    }));
+  }
+  addItemSplitSeatAssignment(seatId, assignment) {
+    return this.updateItemSplitSeat(seatId, (seat) => ({
+      ...seat,
+      assignments: [...seat.assignments, cloneItemSplitSeatAssignment(assignment)]
+    }));
+  }
+  removeItemSplitSeatAssignmentsByLineItem(seatId, lineItemId) {
+    return this.updateItemSplitSeat(seatId, (seat) => ({
+      ...seat,
+      assignments: seat.assignments.filter(
+        (assignment) => assignment.lineItemId !== lineItemId
+      )
+    }));
+  }
+  clearItemSplitSeatAssignments(seatId) {
+    return this.setItemSplitSeatAssignments(seatId, []);
+  }
+  setItemSplitSeatLoyalty(seatId, loyaltyId, loyaltyUserName) {
+    return this.updateItemSplitSeat(seatId, (seat) => ({
+      ...seat,
+      loyaltyId,
+      loyaltyUserName
+    }));
+  }
+  clearItemSplitSeatLoyalty(seatId) {
+    return this.setItemSplitSeatLoyalty(seatId, null, null);
+  }
+  setItemSplitSeatAppliedDiscountIds(seatId, appliedDiscountIds) {
+    return this.updateItemSplitSeat(seatId, (seat) => ({
+      ...seat,
+      appliedDiscountIds: [...appliedDiscountIds]
+    }));
+  }
+  addItemSplitSeatAppliedDiscountId(seatId, discountId) {
+    return this.updateItemSplitSeat(seatId, (seat) => {
+      if (seat.appliedDiscountIds.includes(discountId)) {
+        return seat;
+      }
+      return {
+        ...seat,
+        appliedDiscountIds: [...seat.appliedDiscountIds, discountId]
+      };
+    });
+  }
+  removeItemSplitSeatAppliedDiscountId(seatId, discountId) {
+    return this.updateItemSplitSeat(seatId, (seat) => ({
+      ...seat,
+      appliedDiscountIds: seat.appliedDiscountIds.filter(
+        (appliedDiscountId) => appliedDiscountId !== discountId
+      )
+    }));
+  }
+  clearItemSplitSeatAppliedDiscountIds(seatId) {
+    return this.setItemSplitSeatAppliedDiscountIds(seatId, []);
+  }
+  getEqualSplitState() {
+    return cloneEqualSplitState(this._equalSplitState);
+  }
+  setEqualSplitState(equalSplitState) {
+    const nextEqualSplitState = cloneEqualSplitState(equalSplitState);
+    validateEqualSplitState(nextEqualSplitState);
+    if (isEqual(this._equalSplitState, nextEqualSplitState)) {
+      return this;
+    }
+    this._equalSplitState = nextEqualSplitState;
+    this.touch();
+    return this;
+  }
+  clearEqualSplitState() {
+    return this.setEqualSplitState(null);
+  }
+  getEqualSplitParts() {
+    return this._equalSplitState ? this._equalSplitState.parts.map(cloneEqualSplitPart) : [];
+  }
+  setEqualSplitParts(parts) {
+    if (parts.length === 0) {
+      return this.clearEqualSplitState();
+    }
+    const equalSplitState = this.getEqualSplitState() ?? createEmptyEqualSplitState();
+    equalSplitState.parts = parts.map(cloneEqualSplitPart);
+    equalSplitState.partCount = parts.length;
+    return this.setEqualSplitState(equalSplitState);
+  }
+  clearEqualSplitParts() {
+    return this.clearEqualSplitState();
+  }
+  addEqualSplitPart(part) {
+    if (this.getEqualSplitPartById(part.id)) {
+      return this;
+    }
+    const parts = this.getEqualSplitParts();
+    parts.push(cloneEqualSplitPart(part));
+    return this.setEqualSplitParts(parts);
+  }
+  updateEqualSplitPart(partId, updater) {
+    const parts = this.getEqualSplitParts();
+    const partIndex = parts.findIndex((part) => part.id === partId);
+    if (partIndex === -1 || !parts[partIndex]) {
+      return this;
+    }
+    parts[partIndex] = cloneEqualSplitPart(updater(cloneEqualSplitPart(parts[partIndex])));
+    return this.setEqualSplitParts(parts);
+  }
+  removeEqualSplitPart(partId) {
+    const parts = this.getEqualSplitParts();
+    const nextParts = parts.filter((part) => part.id !== partId);
+    if (nextParts.length === parts.length) {
+      return this;
+    }
+    return nextParts.length === 0 ? this.clearEqualSplitState() : this.setEqualSplitParts(nextParts);
+  }
+  getEqualSplitPartById(partId) {
+    const part = this._equalSplitState?.parts.find(
+      (equalSplitPart) => equalSplitPart.id === partId
+    );
+    return part ? cloneEqualSplitPart(part) : null;
+  }
+  getEqualSplitPartCount() {
+    return this._equalSplitState?.partCount ?? null;
+  }
+  setEqualSplitPartCount(partCount) {
+    if (partCount === null) {
+      return this.clearEqualSplitState();
+    }
+    if (!Number.isInteger(partCount) || partCount <= 0) {
+      throw new Error("Equal split part count must be a positive integer or null");
+    }
+    const equalSplitState = this.getEqualSplitState() ?? createEmptyEqualSplitState();
+    if (equalSplitState.parts.length > partCount) {
+      throw new Error(
+        "Equal split part count cannot be less than persisted parts length"
+      );
+    }
+    if (equalSplitState.partCount === partCount) {
+      return this;
+    }
+    equalSplitState.partCount = partCount;
+    return this.setEqualSplitState(equalSplitState);
+  }
+  clearEqualSplitPartCount() {
+    return this.clearEqualSplitState();
+  }
+  setEqualSplitPartAppliedDiscountIds(partId, appliedDiscountIds) {
+    return this.updateEqualSplitPart(partId, (part) => ({
+      ...part,
+      appliedDiscountIds: [...appliedDiscountIds]
+    }));
+  }
+  addEqualSplitPartAppliedDiscountId(partId, discountId) {
+    return this.updateEqualSplitPart(partId, (part) => {
+      if (part.appliedDiscountIds.includes(discountId)) {
+        return part;
+      }
+      return {
+        ...part,
+        appliedDiscountIds: [...part.appliedDiscountIds, discountId]
+      };
+    });
+  }
+  removeEqualSplitPartAppliedDiscountId(partId, discountId) {
+    return this.updateEqualSplitPart(partId, (part) => ({
+      ...part,
+      appliedDiscountIds: part.appliedDiscountIds.filter(
+        (appliedDiscountId) => appliedDiscountId !== discountId
+      )
+    }));
+  }
+  clearEqualSplitPartAppliedDiscountIds(partId) {
+    return this.setEqualSplitPartAppliedDiscountIds(partId, []);
+  }
   updateOrderStatus(newStatus) {
     if (this.status === newStatus) {
       return;
@@ -812,7 +1335,8 @@ var Cart = class _Cart {
       locatorType: this._locatorType,
       spotNumber: this.spotNumber,
       comments: this.comments,
-      tableService: this._tableService,
+      tableService: cloneTableService(this._tableService),
+      equalSplitState: cloneEqualSplitState(this._equalSplitState),
       orderRefundStatus: this.orderRefundStatus,
       items: this._items,
       status: this.status,
@@ -839,8 +1363,10 @@ var Cart = class _Cart {
       provider: this.provider,
       orderType: this.orderType,
       orderNumber: this.orderNumber,
+      aggregateMatchingItemsOnAdd: this._aggregateMatchingItemsOnAdd,
       checkoutModel: this.checkoutModel,
       tableService: this._tableService,
+      equalSplitState: this._equalSplitState,
       currency: this.currency,
       business: this._business,
       staffId: this._staffId,
@@ -859,7 +1385,8 @@ var Cart = class _Cart {
     newCart._refunds = [...this._refunds];
     newCart._loyaltyProgramId = this._loyaltyProgramId;
     newCart._loyaltyTransactionIds = [...this._loyaltyTransactionIds];
-    newCart._tableService = this._tableService ? { ...this._tableService } : null;
+    newCart._tableService = cloneTableService(this._tableService);
+    newCart._equalSplitState = cloneEqualSplitState(this._equalSplitState);
     newCart._taxSummary = this._taxSummary;
     newCart._newlyCancelledItemIds = new Set(this._newlyCancelledItemIds);
     newCart._invoiceCompany = this._invoiceCompany ? { ...this._invoiceCompany } : null;
@@ -872,6 +1399,16 @@ var Cart = class _Cart {
       currency: this.currency
     });
   }
+  createDiscountRecord(discountData, scope, lineItemId, targetType, targetId) {
+    return {
+      ...discountData,
+      scope,
+      lineItemId,
+      targetType,
+      targetId,
+      createdAt: dayjs().toDate().toISOString()
+    };
+  }
   touch() {
     this.updatedAt = dayjs().toDate();
   }
@@ -885,7 +1422,7 @@ var ApplyTo = /* @__PURE__ */ ((ApplyTo2) => {
 })(ApplyTo || {});
 
 // src/version.ts
-var VERSION = "0.1.2";
+var VERSION = "0.1.5";
 export {
   ApplyTo,
   Cart,
@@ -893,7 +1430,9 @@ export {
   allocateProportionalMinorUnits,
   calculateCartPriceSnapshot,
   calculateDiscountAmount,
+  calculateEqualSplitPartPricing,
   calculateItemPrice,
+  calculateItemSplitSeatPricing,
   calculateOrderTaxSummary,
   calculateSequentialDiscountTotal,
   splitTaxInclusiveAmount