@fire-spark/core 0.0.1 → 0.0.2

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AndConditions, CheckoutMode, CheckoutResolved, Condition, CustomerIdentifyInput, CustomerRegisterInput, CustomerUpdateInput, FulfillmentListInput, GroupDisplayType, KioskDeviceConfig, KioskDeviceOverrides, KioskHealthBatchInput, KioskHealthBatchResult, KioskHeartbeatInput, KioskHeartbeatResult, KioskRealtimeToken, MatchResult, MatchableRule, Menu, Menu as Menu$1, MenuLookup, MenuLookup as MenuLookup$1, ModifierControlType, ModifierGroup, OrConditions, Order as Order$1, Order as Order$2, OrderInsertInput, OrderLine, OrderListInput, OrderReorderInput, OrderTotals, OrderUpdateInput, OrderValidateInput, OrderValidateOutput, PaymentIntentInput, PaymentMethod, PaymentProvider, PricingModifier, Product, Product as Product$1, Recommendation, RecurringDateCronResult, RecurringDateCronValues, RulesEngineOrderLine, RulesEngineParams, RulesEngineRuntime, Schedule, StoreListInput, StoreNearbyInput, StorefrontAvailability, StorefrontMenuScope, StorefrontMenuStreamOptions, StorefrontPaymentsListInput } from "@fire-spark/types";
+import { AndConditions, CheckoutMode, CheckoutResolved, Condition, CustomerIdentifyInput, CustomerRegisterInput, CustomerUpdateInput, FulfillmentListInput, GroupDisplayType, KioskDeviceConfig, KioskDeviceOverrides, KioskHealthBatchInput, KioskHealthBatchResult, KioskHeartbeatInput, KioskHeartbeatResult, KioskRealtimeToken, MatchResult, MatchableRule, Menu, Menu as Menu$1, MenuLookup, MenuLookup as MenuLookup$1, ModifierControlType, ModifierGroup, OrConditions, Order as Order$1, Order as Order$2, OrderInsertInput, OrderLine, OrderListInput, OrderRedeem, OrderRedemptionStep, OrderReorderInput, OrderTotals, OrderUpdateInput, OrderValidateInput, OrderValidateOutput, PaymentIntentInput, PaymentMethod, PaymentProvider, PricingModifier, Product, Product as Product$1, Recommendation, RecurringDateCronResult, RecurringDateCronValues, RulesEngineOrderLine, RulesEngineParams, RulesEngineRuntime, Schedule, StoreListInput, StoreNearbyInput, StorefrontAvailability, StorefrontMenuScope, StorefrontMenuStreamOptions, StorefrontPaymentsListInput } from "@fire-spark/types";
 //#region src/productCustomization/types.d.ts
 type SelectionStatus = "IDLE" | "INCOMPLETE" | "VALID" | "INVALID";
 type CustomizationPath = string;
@@ -208,9 +208,11 @@ declare const listOrders: (input?: OrderListInput, options?: ServiceHttpOptions)
       included_quantity: number;
     }[];
     redeem: {
-      id: string;
-      amount: number;
-      value: number;
+      reward_id: string;
+      quantity: number;
+      discount_rate?: number | undefined;
+      discount_amount?: number | undefined;
+      expires_at?: string | undefined;
     }[];
     quantity: number;
     tax_rate: number | null;
@@ -233,9 +235,44 @@ declare const listOrders: (input?: OrderListInput, options?: ServiceHttpOptions)
     group_total: number;
   }[];
   redeem: {
-    id: string;
-    amount: number;
-    value: number;
+    reward_id: string;
+    quantity: number;
+    discount_rate?: number | undefined;
+    discount_amount?: number | undefined;
+    expires_at?: string | undefined;
+  }[];
+  redemption_steps: {
+    reward_id: string;
+    reward_quantity: number;
+    target: "LINE" | "ORDER";
+    target_id?: string | undefined;
+    action: "CREATE" | "DELETE" | "READ" | "UPDATE";
+    discount_amount: number;
+    before: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    };
+    after: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    };
+    target_before?: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    } | undefined;
+    target_after?: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    } | undefined;
+    error?: string | undefined;
   }[];
   customer: {
     customer_info: {
@@ -343,9 +380,11 @@ declare const createOrder: (body: OrderInsertInput, options?: ServiceHttpOptions
       included_quantity: number;
     }[];
     redeem: {
-      id: string;
-      amount: number;
-      value: number;
+      reward_id: string;
+      quantity: number;
+      discount_rate?: number | undefined;
+      discount_amount?: number | undefined;
+      expires_at?: string | undefined;
     }[];
     quantity: number;
     tax_rate: number | null;
@@ -368,9 +407,44 @@ declare const createOrder: (body: OrderInsertInput, options?: ServiceHttpOptions
     group_total: number;
   }[];
   redeem: {
-    id: string;
-    amount: number;
-    value: number;
+    reward_id: string;
+    quantity: number;
+    discount_rate?: number | undefined;
+    discount_amount?: number | undefined;
+    expires_at?: string | undefined;
+  }[];
+  redemption_steps: {
+    reward_id: string;
+    reward_quantity: number;
+    target: "LINE" | "ORDER";
+    target_id?: string | undefined;
+    action: "CREATE" | "DELETE" | "READ" | "UPDATE";
+    discount_amount: number;
+    before: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    };
+    after: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    };
+    target_before?: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    } | undefined;
+    target_after?: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    } | undefined;
+    error?: string | undefined;
   }[];
   customer: {
     customer_info: {
@@ -478,9 +552,11 @@ declare const getOrder: (id: string, options?: ServiceHttpOptions) => Promise<{
       included_quantity: number;
     }[];
     redeem: {
-      id: string;
-      amount: number;
-      value: number;
+      reward_id: string;
+      quantity: number;
+      discount_rate?: number | undefined;
+      discount_amount?: number | undefined;
+      expires_at?: string | undefined;
     }[];
     quantity: number;
     tax_rate: number | null;
@@ -503,9 +579,44 @@ declare const getOrder: (id: string, options?: ServiceHttpOptions) => Promise<{
     group_total: number;
   }[];
   redeem: {
-    id: string;
-    amount: number;
-    value: number;
+    reward_id: string;
+    quantity: number;
+    discount_rate?: number | undefined;
+    discount_amount?: number | undefined;
+    expires_at?: string | undefined;
+  }[];
+  redemption_steps: {
+    reward_id: string;
+    reward_quantity: number;
+    target: "LINE" | "ORDER";
+    target_id?: string | undefined;
+    action: "CREATE" | "DELETE" | "READ" | "UPDATE";
+    discount_amount: number;
+    before: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    };
+    after: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    };
+    target_before?: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    } | undefined;
+    target_after?: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    } | undefined;
+    error?: string | undefined;
   }[];
   customer: {
     customer_info: {
@@ -1051,9 +1162,11 @@ declare const updateOrder: (id: string, body: OrderUpdateInput, options?: Servic
       included_quantity: number;
     }[];
     redeem: {
-      id: string;
-      amount: number;
-      value: number;
+      reward_id: string;
+      quantity: number;
+      discount_rate?: number | undefined;
+      discount_amount?: number | undefined;
+      expires_at?: string | undefined;
     }[];
     quantity: number;
     tax_rate: number | null;
@@ -1076,9 +1189,44 @@ declare const updateOrder: (id: string, body: OrderUpdateInput, options?: Servic
     group_total: number;
   }[];
   redeem: {
-    id: string;
-    amount: number;
-    value: number;
+    reward_id: string;
+    quantity: number;
+    discount_rate?: number | undefined;
+    discount_amount?: number | undefined;
+    expires_at?: string | undefined;
+  }[];
+  redemption_steps: {
+    reward_id: string;
+    reward_quantity: number;
+    target: "LINE" | "ORDER";
+    target_id?: string | undefined;
+    action: "CREATE" | "DELETE" | "READ" | "UPDATE";
+    discount_amount: number;
+    before: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    };
+    after: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    };
+    target_before?: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    } | undefined;
+    target_after?: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    } | undefined;
+    error?: string | undefined;
   }[];
   customer: {
     customer_info: {
@@ -1186,9 +1334,11 @@ declare const cancelOrder: (id: string, options?: ServiceHttpOptions) => Promise
       included_quantity: number;
     }[];
     redeem: {
-      id: string;
-      amount: number;
-      value: number;
+      reward_id: string;
+      quantity: number;
+      discount_rate?: number | undefined;
+      discount_amount?: number | undefined;
+      expires_at?: string | undefined;
     }[];
     quantity: number;
     tax_rate: number | null;
@@ -1211,9 +1361,44 @@ declare const cancelOrder: (id: string, options?: ServiceHttpOptions) => Promise
     group_total: number;
   }[];
   redeem: {
-    id: string;
-    amount: number;
-    value: number;
+    reward_id: string;
+    quantity: number;
+    discount_rate?: number | undefined;
+    discount_amount?: number | undefined;
+    expires_at?: string | undefined;
+  }[];
+  redemption_steps: {
+    reward_id: string;
+    reward_quantity: number;
+    target: "LINE" | "ORDER";
+    target_id?: string | undefined;
+    action: "CREATE" | "DELETE" | "READ" | "UPDATE";
+    discount_amount: number;
+    before: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    };
+    after: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    };
+    target_before?: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    } | undefined;
+    target_after?: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    } | undefined;
+    error?: string | undefined;
   }[];
   customer: {
     customer_info: {
@@ -1321,9 +1506,11 @@ declare const refundOrder: (id: string, options?: ServiceHttpOptions) => Promise
       included_quantity: number;
     }[];
     redeem: {
-      id: string;
-      amount: number;
-      value: number;
+      reward_id: string;
+      quantity: number;
+      discount_rate?: number | undefined;
+      discount_amount?: number | undefined;
+      expires_at?: string | undefined;
     }[];
     quantity: number;
     tax_rate: number | null;
@@ -1346,9 +1533,44 @@ declare const refundOrder: (id: string, options?: ServiceHttpOptions) => Promise
     group_total: number;
   }[];
   redeem: {
-    id: string;
-    amount: number;
-    value: number;
+    reward_id: string;
+    quantity: number;
+    discount_rate?: number | undefined;
+    discount_amount?: number | undefined;
+    expires_at?: string | undefined;
+  }[];
+  redemption_steps: {
+    reward_id: string;
+    reward_quantity: number;
+    target: "LINE" | "ORDER";
+    target_id?: string | undefined;
+    action: "CREATE" | "DELETE" | "READ" | "UPDATE";
+    discount_amount: number;
+    before: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    };
+    after: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    };
+    target_before?: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    } | undefined;
+    target_after?: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    } | undefined;
+    error?: string | undefined;
   }[];
   customer: {
     customer_info: {
@@ -1456,9 +1678,11 @@ declare const reorderOrder: (id: string, body?: OrderReorderInput, options?: Ser
       included_quantity: number;
     }[];
     redeem: {
-      id: string;
-      amount: number;
-      value: number;
+      reward_id: string;
+      quantity: number;
+      discount_rate?: number | undefined;
+      discount_amount?: number | undefined;
+      expires_at?: string | undefined;
     }[];
     quantity: number;
     tax_rate: number | null;
@@ -1481,9 +1705,44 @@ declare const reorderOrder: (id: string, body?: OrderReorderInput, options?: Ser
     group_total: number;
   }[];
   redeem: {
-    id: string;
-    amount: number;
-    value: number;
+    reward_id: string;
+    quantity: number;
+    discount_rate?: number | undefined;
+    discount_amount?: number | undefined;
+    expires_at?: string | undefined;
+  }[];
+  redemption_steps: {
+    reward_id: string;
+    reward_quantity: number;
+    target: "LINE" | "ORDER";
+    target_id?: string | undefined;
+    action: "CREATE" | "DELETE" | "READ" | "UPDATE";
+    discount_amount: number;
+    before: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    };
+    after: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    };
+    target_before?: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    } | undefined;
+    target_after?: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    } | undefined;
+    error?: string | undefined;
   }[];
   customer: {
     customer_info: {
@@ -1594,6 +1853,26 @@ type ReorderOrderOptions = CreateOrderOptions & {
   strategy?: "replace" | "merge";
 };
 type OrderDraft = Order$2;
+type ApplyRedeemInput = {
+  reward_id: string;
+  /** Reward units to redeem (integer ≥ 1). */
+  quantity: number;
+  /** 0–1, compounded per unit over the remaining value. */
+  discount_rate?: number;
+  /** > 0, per unit; caps the rate discount when both are set. */
+  discount_amount?: number;
+  /** Root line to discount; omit to discount the whole order. */
+  line_uid?: string;
+  /** ISO datetime with offset; validation fails once it has passed. */
+  expires_at?: string;
+};
+type RemoveRedeemInput = {
+  reward_id: string;
+  /** Reward units to remove (integer ≥ 1), latest applied first. */
+  quantity: number;
+  /** Root line holding the redeem; omit for order-level redeems. */
+  line_uid?: string;
+};
 //#endregion
 //#region src/order/Order.d.ts
 declare class Order {
@@ -1650,6 +1929,16 @@ declare class Order {
   removeLine(lineUid: string): void;
   replaceLine(lineUid: string, lines: OrderLine | OrderLine[]): void;
   emptyOrder(): void;
+  /**
+   * Appends a redeem to `line_uid` (root line) or to the order. Steps keep
+   * the order in which redeems were applied.
+   */
+  applyRedeem(input: ApplyRedeemInput): void;
+  /**
+   * Removes `quantity` units of `reward_id` from `line_uid` or the order,
+   * latest applied first. Removing more units than applied clears them all.
+   */
+  removeRedeem(input: RemoveRedeemInput): void;
   setScope(scope: Partial<OrderScope>): void;
   /** Shallow-merges into order metadata; `null` values are kept as-is. */
   setMetadata(patch: Record<string, unknown>): void;
@@ -1661,6 +1950,8 @@ declare class Order {
   refundOrder(): Promise<void>;
   validateOrder(): Promise<void>;
   placeOrder(input?: PlaceOrderInput): Promise<void>;
+  /** Applies lines/redeem, replaying redemption steps and totals. */
+  private commitLines;
   private scheduleAfterMutate;
   private notify;
 }
@@ -1725,8 +2016,8 @@ declare const milestoneTrack: (workflow: TrackWorkflow) => MilestoneTrackItem[];
 declare const milestoneSteps: (workflow: TrackWorkflow, currentNodeIds: string[]) => MilestoneSteps | null;
 //#endregion
 //#region src/order/validate.d.ts
-type OrderLineIssueCode = "PRODUCT_NOT_FOUND" | "HIDDEN" | "OUT_OF_STOCK" | "OUTSIDE_HOURS" | "MODIFIER_NOT_FOUND" | "MODIFIER_RULES_INVALID" | "PRICE_MISMATCH" | "TAX_MISMATCH" | "DISCOUNT_MISMATCH" | "QUANTITY_MISMATCH" | "QUANTITY_BELOW_MINIMUM" | "QUANTITY_ABOVE_MAXIMUM" | "STRUCTURE_MISMATCH" | "FEE_MISMATCH";
-type OrderIssueCode = "NO_MENU" | "MENU_CLOSED" | "SCOPE_INACTIVE" | "TOTALS_MISMATCH" | "EMPTY_ORDER" | "ITEMS_BELOW_MINIMUM" | "ITEMS_ABOVE_MAXIMUM" | "TOTAL_BELOW_MINIMUM" | "TOTAL_ABOVE_MAXIMUM" | "REDEEMS_ABOVE_MAXIMUM" | "REDEEMS_TOTAL_ABOVE_MAXIMUM" | "SHIPPING_REQUIRED" | "BILLING_REQUIRED" | "SHIPPING_FIELD_REQUIRED" | "BILLING_FIELD_REQUIRED";
+type OrderLineIssueCode = "PRODUCT_NOT_FOUND" | "HIDDEN" | "OUT_OF_STOCK" | "OUTSIDE_HOURS" | "MODIFIER_NOT_FOUND" | "MODIFIER_RULES_INVALID" | "PRICE_MISMATCH" | "TAX_MISMATCH" | "DISCOUNT_MISMATCH" | "QUANTITY_MISMATCH" | "QUANTITY_BELOW_MINIMUM" | "QUANTITY_ABOVE_MAXIMUM" | "STRUCTURE_MISMATCH" | "FEE_MISMATCH" | "REDEEM_EXPIRED" | "REDEMPTION_STEPS_MISMATCH";
+type OrderIssueCode = "NO_MENU" | "MENU_CLOSED" | "SCOPE_INACTIVE" | "TOTALS_MISMATCH" | "REDEEM_EXPIRED" | "REDEMPTION_STEPS_MISMATCH" | "REDEMPTION_MISMATCH" | "EMPTY_ORDER" | "ITEMS_BELOW_MINIMUM" | "ITEMS_ABOVE_MAXIMUM" | "TOTAL_BELOW_MINIMUM" | "TOTAL_ABOVE_MAXIMUM" | "REDEEMS_ABOVE_MAXIMUM" | "REDEEMS_TOTAL_ABOVE_MAXIMUM" | "SHIPPING_REQUIRED" | "BILLING_REQUIRED" | "SHIPPING_FIELD_REQUIRED" | "BILLING_FIELD_REQUIRED";
 type OrderLineIssue = {
   code: OrderLineIssueCode;
   field?: string;
@@ -1753,6 +2044,10 @@ type ValidateOrderAgainstMenuInput = {
   menuActive: boolean;
   locale?: string;
   expectedFeeLines?: OrderLine[];
+  redeem?: OrderRedeem[];
+  redemptionSteps?: OrderRedemptionStep[];
+  /** Epoch ms used for `expires_at` checks. */
+  now?: number;
 };
 /** Compare cart lines/totals against a fresh menu (exact Big.js equality). */
 declare const validateOrderAgainstMenu: (input: ValidateOrderAgainstMenuInput) => OrderValidationResult;
@@ -1778,6 +2073,58 @@ declare class OrderValidationError extends Error {
 }
 declare const isOrderValidationError: (error: unknown) => error is OrderValidationError;
 //#endregion
+//#region src/order/redemptions.d.ts
+/** Steps + totals for a set of lines and redeems, keeping step order. */
+declare const recomputeRedemptions: (input: {
+  lines: OrderLine[];
+  redeem: OrderRedeem[];
+  redemption_steps: OrderRedemptionStep[];
+  currency: string;
+}) => {
+  redemption_steps: {
+    reward_id: string;
+    reward_quantity: number;
+    target: "LINE" | "ORDER";
+    target_id?: string | undefined;
+    action: "CREATE" | "DELETE" | "READ" | "UPDATE";
+    discount_amount: number;
+    before: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    };
+    after: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    };
+    target_before?: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    } | undefined;
+    target_after?: {
+      value: number;
+      quantity: number;
+      discount_amount: number;
+      discount_rate: number;
+    } | undefined;
+    error?: string | undefined;
+  }[];
+  totals: {
+    currency: string;
+    subtotal: number;
+    discount_rate: number;
+    discount_total: number;
+    tax_rate: number;
+    tax_total: number;
+    total: number;
+  };
+};
+//#endregion
 //#region src/order/totals.d.ts
 /** Sum root line group totals into order totals (Big.js). */
 declare const recomputeTotals: (lines: OrderLine[], currency?: string) => OrderTotals;
@@ -3276,6 +3623,29 @@ type ScheduleWindow = {
 declare const getScheduleWindow: (schedule: Schedule | null | undefined, now?: Date) => ScheduleWindow;
 declare const isOnSchedule: (schedule: Schedule | null | undefined, now?: Date) => boolean;
 //#endregion
+//#region src/shared/genId.d.ts
+type IdBuilder = {
+  /**
+   * Keeps only `[A-Za-z0-9]`, cut to 32 characters. `fallback` is used only
+   * when `value` is empty after trim; throws if nothing alphanumeric is left.
+   */
+  literal: (value: string | null | undefined, fallback?: string) => IdBuilder;
+  /** Appends `-`, the only separator allowed. */
+  separator: () => IdBuilder;
+  /** Cryptographically random `[0-9a-z]`; at least 12 characters. */
+  hash: (length?: number) => IdBuilder;
+  /** New id on every call; throws when the shape is unsafe. */
+  build: () => string;
+};
+/**
+ * Safe id builder: `genId().literal("ord").separator().hash(12).build()`.
+ * Literals are cleaned to `[A-Za-z0-9]`; `-` is the only separator and a
+ * random hash of at least 12 characters is required.
+ */
+declare const genId: () => IdBuilder;
+/** `ord-<store>-<hash>`; `nostore` when the store id is blank. */
+declare const genOrderId: (storeId?: string | null) => string;
+//#endregion
 //#region src/rules/RulesEngine.d.ts
 declare class RulesEngine {
   order?: RulesEngineParams["order"];
@@ -3396,4 +3766,4 @@ declare const paymentMatchesClientConditions: (conditions: OrConditions | null |
   now?: string;
 }) => boolean;
 //#endregion
-export { type AuthConfigureOptions, type CreateOrderOptions, type CreateSessionOptions, type CustomizationPath, type CustomizationSession, DEFAULT_RECOMMENDATION_TYPES, type ExchangeOptions, type FlatMenuCategory, type GroupDisplayType, type ListMenusStreamOptions, type Menu, type MenuCategoryNode, type MenuLookup, type MilestoneSteps, type MilestoneTrackItem, type ModifierControlType, type ModifierCtx, type ModifierGroupCtx, type NestedMenuCategory, Order, type OrderCustomerSource, type OrderDraft, type OrderIssue, type OrderIssueCode, type OrderLineDiff, type OrderLineIssue, type OrderLineIssueCode, type OrderScope, OrderSyncPendingError, OrderValidationError, type OrderValidationResult, type PricingModifier, type Product, type ProductCtx, type QuantitiesByPath, type RecommendationType, RecurringDateCron, type ReorderOrderOptions, type ResetOptions, RulesEngine, type ScheduleWindow, type SelectionStatus, type ServiceHttpOptions, type Snapshot, type StorefrontAccessToken, StorefrontHttpError, type TrackWorkflow, type ValidateOptions, type ValidateOrderAgainstMenuInput, type VisitedState, addLines, auth, buildCustomerSnapshot, collectOrderLineDiffs, countCartProducts, createSession, currentNodes, defaultConditionError, flattenMenuCategories, fromOrderLines, getScheduleWindow, indexMenu, isCheckoutFieldFilled, isDeviceNotLinked, isKioskUnauthorized, isMilestoneStepDone, isOnSchedule, isOrderValidationError, isStorefrontNotFound, listMenusStream, matchAbsoluteDateOperator, matchBooleanOperator, matchCurrencyOperator, matchEnumOperator, matchNumberOperator, matchRecurringDateOperator, matchRelativeDateOperator, matchStringOperator, milestoneSteps, milestoneTrack, nestMenuCategories, paymentMatchesClientConditions, recomputeTotals, resolveCheckout, services, storefrontJson, toOrderLines, validateOrderAgainstMenu, visitedStates };
+export { type ApplyRedeemInput, type AuthConfigureOptions, type CreateOrderOptions, type CreateSessionOptions, type CustomizationPath, type CustomizationSession, DEFAULT_RECOMMENDATION_TYPES, type ExchangeOptions, type FlatMenuCategory, type GroupDisplayType, type IdBuilder, type ListMenusStreamOptions, type Menu, type MenuCategoryNode, type MenuLookup, type MilestoneSteps, type MilestoneTrackItem, type ModifierControlType, type ModifierCtx, type ModifierGroupCtx, type NestedMenuCategory, Order, type OrderCustomerSource, type OrderDraft, type OrderIssue, type OrderIssueCode, type OrderLineDiff, type OrderLineIssue, type OrderLineIssueCode, type OrderScope, OrderSyncPendingError, OrderValidationError, type OrderValidationResult, type PricingModifier, type Product, type ProductCtx, type QuantitiesByPath, type RecommendationType, RecurringDateCron, type RemoveRedeemInput, type ReorderOrderOptions, type ResetOptions, RulesEngine, type ScheduleWindow, type SelectionStatus, type ServiceHttpOptions, type Snapshot, type StorefrontAccessToken, StorefrontHttpError, type TrackWorkflow, type ValidateOptions, type ValidateOrderAgainstMenuInput, type VisitedState, addLines, auth, buildCustomerSnapshot, collectOrderLineDiffs, countCartProducts, createSession, currentNodes, defaultConditionError, flattenMenuCategories, fromOrderLines, genId, genOrderId, getScheduleWindow, indexMenu, isCheckoutFieldFilled, isDeviceNotLinked, isKioskUnauthorized, isMilestoneStepDone, isOnSchedule, isOrderValidationError, isStorefrontNotFound, listMenusStream, matchAbsoluteDateOperator, matchBooleanOperator, matchCurrencyOperator, matchEnumOperator, matchNumberOperator, matchRecurringDateOperator, matchRelativeDateOperator, matchStringOperator, milestoneSteps, milestoneTrack, nestMenuCategories, paymentMatchesClientConditions, recomputeRedemptions, recomputeTotals, resolveCheckout, services, storefrontJson, toOrderLines, validateOrderAgainstMenu, visitedStates };

package/dist/index.js

@@ -1978,6 +1978,83 @@ const services = {
 		isKioskUnauthorized
 	}
 };
+const DISALLOWED = /[^A-Za-z0-9]/g;
+const ALPHABET = "0123456789abcdefghijklmnopqrstuvwxyz";
+const BYTE_LIMIT = 252;
+const toLiteral = (value, fallback) => {
+	const trimmed = (value ?? "").trim();
+	const source = trimmed === "" ? fallback : trimmed;
+	if (source === void 0) throw new Error("Id literal must not be empty");
+	const cleaned = source.replace(DISALLOWED, "");
+	if (cleaned === "") throw new Error(`Id literal has no alphanumeric characters: "${source}"`);
+	return cleaned.slice(0, 32);
+};
+const randomChars = (length) => {
+	const c = globalThis.crypto;
+	if (typeof c?.getRandomValues !== "function") throw new Error("crypto.getRandomValues is required");
+	let out = "";
+	const bytes = new Uint8Array(length * 2);
+	while (out.length < length) {
+		c.getRandomValues(bytes);
+		for (const byte of bytes) {
+			if (byte >= BYTE_LIMIT) continue;
+			out += ALPHABET[byte % 36];
+			if (out.length === length) break;
+		}
+	}
+	return out;
+};
+const assertShape = (parts) => {
+	if (!parts.some((part) => part.kind === "hash")) throw new Error("Id requires a random hash part");
+	const first = parts[0];
+	const last = parts[parts.length - 1];
+	if (first?.kind === "separator" || last?.kind === "separator") throw new Error("Id must not start or end with a separator");
+	parts.forEach((part, index) => {
+		if (part.kind !== "separator") return;
+		if (parts[index - 1]?.kind !== "separator") return;
+		throw new Error("Id must not contain consecutive separators");
+	});
+};
+const render = (part) => {
+	if (part.kind === "literal") return part.value;
+	if (part.kind === "separator") return "-";
+	return randomChars(part.length);
+};
+const builder = (parts) => {
+	return {
+		literal: (value, fallback) => {
+			const literal = {
+				kind: "literal",
+				value: toLiteral(value, fallback)
+			};
+			return builder([...parts, literal]);
+		},
+		separator: () => builder([...parts, { kind: "separator" }]),
+		hash: (length = 12) => {
+			if (!Number.isInteger(length) || length < 12) throw new Error(`Id hash must be an integer ≥ 12, got ${length}`);
+			return builder([...parts, {
+				kind: "hash",
+				length
+			}]);
+		},
+		build: () => {
+			assertShape(parts);
+			const id = parts.map(render).join("");
+			if (id.length > 64) throw new Error(`Id must be ≤ 64 characters`);
+			return id;
+		}
+	};
+};
+/**
+* Safe id builder: `genId().literal("ord").separator().hash(12).build()`.
+* Literals are cleaned to `[A-Za-z0-9]`; `-` is the only separator and a
+* random hash of at least 12 characters is required.
+*/
+const genId = () => builder([]);
+/** `ord-<store>-<hash>`; `nostore` when the store id is blank. */
+const genOrderId = (storeId) => {
+	return genId().literal("ord").separator().literal(storeId, "nostore").separator().hash().build();
+};
 //#endregion
 //#region src/order/retry.ts
 const defaultSleep = (ms) => {
@@ -2037,6 +2114,8 @@ const createFlushController = (runtime) => {
 		const b5 = { customer: order.customer };
 		const b6 = { payment_intents: order.payment_intents };
 		const b7 = { payment_status: order.payment_status };
+		const b8 = { redeem: order.redeem };
+		const b9 = { redemption_steps: order.redemption_steps };
 		return {
 			...b1,
 			...b2,
@@ -2044,7 +2123,9 @@ const createFlushController = (runtime) => {
 			...b4,
 			...b5,
 			...b6,
-			...b7
+			...b7,
+			...b8,
+			...b9
 		};
 	};
 	const insertBody = (order) => {
@@ -2068,6 +2149,8 @@ const createFlushController = (runtime) => {
 		};
 		const b7 = { payment_intents: order.payment_intents };
 		const b8 = { payment_status: order.payment_status };
+		const b9 = { redeem: order.redeem };
+		const b10 = { redemption_steps: order.redemption_steps };
 		return {
 			...b1,
 			...b2,
@@ -2076,7 +2159,9 @@ const createFlushController = (runtime) => {
 			...b5,
 			...b6,
 			...b7,
-			...b8
+			...b8,
+			...b9,
+			...b10
 		};
 	};
 	const flushNow = () => {
@@ -2564,6 +2649,227 @@ const emptyTotals = (currency = "USD") => {
 	};
 };
 //#endregion
+//#region src/order/redemptions.ts
+const ORDER_KEY = "ORDER";
+/** Same rules as `vOrders.redeem()`; throws on invalid input. */
+const buildRedeem = (input) => {
+	const { reward_id, quantity, discount_rate, discount_amount } = input;
+	const { expires_at } = input;
+	if (!reward_id.trim()) throw new Error("Redeem requires reward_id");
+	if (!Number.isInteger(quantity) || quantity < 1) throw new Error("Redeem quantity must be an integer ≥ 1");
+	if (discount_rate === void 0 && discount_amount === void 0) throw new Error("Redeem requires discount_rate or discount_amount");
+	const rate = discount_rate ?? 0;
+	if (!(rate >= 0 && rate <= 1)) throw new Error("Redeem discount_rate must be between 0 and 1");
+	if (discount_amount !== void 0 && !(discount_amount > 0)) throw new Error("Redeem discount_amount must be > 0");
+	if (expires_at !== void 0 && Number.isNaN(Date.parse(expires_at))) throw new Error("Redeem expires_at must be an ISO datetime");
+	const redeem = {
+		reward_id,
+		quantity
+	};
+	if (discount_rate !== void 0) redeem.discount_rate = discount_rate;
+	if (discount_amount !== void 0) redeem.discount_amount = discount_amount;
+	if (expires_at !== void 0) redeem.expires_at = expires_at;
+	return redeem;
+};
+/**
+* Takes `quantity` units of `reward_id` off the latest entries first, so the
+* earlier redeems keep their step position. Entries that reach 0 are removed.
+*/
+const subtractRedeem = (items, reward_id, quantity) => {
+	if (!Number.isInteger(quantity) || quantity < 1) throw new Error("Redeem quantity must be an integer ≥ 1");
+	let pending = quantity;
+	const kept = [];
+	for (let i = items.length - 1; i >= 0; i--) {
+		const item = items[i];
+		if (pending === 0 || item.reward_id !== reward_id) {
+			kept.unshift(item);
+			continue;
+		}
+		const taken = Math.min(item.quantity, pending);
+		pending -= taken;
+		const rest = item.quantity - taken;
+		if (rest > 0) kept.unshift({
+			...item,
+			quantity: rest
+		});
+	}
+	return kept;
+};
+const redemptionTargetKey = (target) => {
+	if (target.target === "ORDER") return ORDER_KEY;
+	return `LINE:${target.target_id ?? ""}`;
+};
+/** Only root lines own redeems; child-line redeems are never applied. */
+const redeemPools = (lines, redeem) => {
+	const pools = /* @__PURE__ */ new Map();
+	for (const line of lines) {
+		const items = line.redeem ?? [];
+		if (line.parent_uid != null || items.length === 0) continue;
+		const target = {
+			target: "LINE",
+			target_id: line.uid
+		};
+		const pool = items.map((item) => ({
+			...target,
+			redeem: item
+		}));
+		pools.set(redemptionTargetKey(target), pool);
+	}
+	const order = { target: "ORDER" };
+	const pool = redeem.map((item) => ({
+		...order,
+		redeem: item
+	}));
+	pools.set(ORDER_KEY, pool);
+	return pools;
+};
+/**
+* Pairs the k-th step of a target with the k-th redeem of that target, in
+* step order. Steps without a matching redeem are dropped; redeems without a
+* step are appended (lines first, then order).
+*/
+const sequenceRedeems = (lines, redeem, steps) => {
+	const pools = redeemPools(lines, redeem);
+	const cursors = /* @__PURE__ */ new Map();
+	const sequence = [];
+	for (const step of steps) {
+		const key = redemptionTargetKey(step);
+		const at = cursors.get(key) ?? 0;
+		const next = pools.get(key)?.[at];
+		if (!next || next.redeem.reward_id !== step.reward_id) continue;
+		cursors.set(key, at + 1);
+		sequence.push(next);
+	}
+	for (const [key, pool] of pools) sequence.push(...pool.slice(cursors.get(key) ?? 0));
+	return sequence;
+};
+const minBig = (a, b) => {
+	return a.lt(b) ? a : b;
+};
+const left = (run) => {
+	return run.base.minus(run.discount);
+};
+const rateOf = (discount, base) => {
+	if (base.lte(0)) return 0;
+	return minBig(discount.div(base), new Big(1)).toNumber();
+};
+const snapshot = (run) => {
+	const b1 = {
+		value: left(run).toNumber(),
+		quantity: run.quantity
+	};
+	const b2 = { discount_amount: run.discount.toNumber() };
+	const b3 = { discount_rate: rateOf(run.discount, run.base) };
+	return {
+		...b1,
+		...b2,
+		...b3
+	};
+};
+/**
+* Rate compounds once per reward unit over the remaining value; amount is
+* per unit. With both, the rate discount is capped at `amount × quantity`.
+*/
+const redeemDiscount = (redeem, remaining) => {
+	const { quantity, discount_rate, discount_amount } = redeem;
+	let cap = null;
+	if (discount_amount !== void 0) cap = new Big(discount_amount).times(quantity);
+	if (discount_rate === void 0) return cap ?? new Big(0);
+	const kept = new Big(1).minus(discount_rate).pow(quantity);
+	const byRate = remaining.times(new Big(1).minus(kept));
+	return cap ? minBig(byRate, cap) : byRate;
+};
+const runningFor = (base, quantity) => {
+	return {
+		base: new Big(base),
+		discount: new Big(0),
+		quantity
+	};
+};
+/**
+* Replays every redeem in persisted step order over the root lines' group
+* totals. A discount never exceeds what is left on its target or the order.
+*/
+const computeRedemptionSteps = (lines, redeem, steps) => {
+	const sequence = sequenceRedeems(lines, redeem, steps);
+	if (sequence.length === 0) return [];
+	const roots = lines.filter((line) => line.parent_uid == null);
+	let orderBase = new Big(0);
+	const lineRuns = /* @__PURE__ */ new Map();
+	for (const root of roots) {
+		orderBase = orderBase.plus(root.group_total);
+		lineRuns.set(root.uid, runningFor(root.group_total, root.quantity));
+	}
+	const order = runningFor(orderBase, 1);
+	return sequence.map((item) => {
+		const line = item.target_id ? lineRuns.get(item.target_id) : void 0;
+		const before = snapshot(order);
+		const targetBefore = line ? snapshot(line) : void 0;
+		const orderLeft = left(order);
+		const targetLeft = line ? left(line) : orderLeft;
+		const raw = redeemDiscount(item.redeem, targetLeft);
+		const discount = minBig(minBig(raw, targetLeft), orderLeft);
+		order.discount = order.discount.plus(discount);
+		if (line) line.discount = line.discount.plus(discount);
+		const action = discount.gt(0) ? "UPDATE" : "READ";
+		const { reward_id, quantity } = item.redeem;
+		const b1 = {
+			reward_id,
+			reward_quantity: quantity,
+			target: item.target
+		};
+		const b2 = item.target_id ? { target_id: item.target_id } : {};
+		const b3 = {
+			action,
+			discount_amount: discount.toNumber()
+		};
+		const b4 = {
+			before,
+			after: snapshot(order)
+		};
+		let b5 = {};
+		if (line) b5 = {
+			target_before: targetBefore,
+			target_after: snapshot(line)
+		};
+		return {
+			...b1,
+			...b2,
+			...b3,
+			...b4,
+			...b5
+		};
+	});
+};
+/** Subtract redemption discounts from line-based order totals. */
+const applyRedemptionTotals = (totals, steps) => {
+	if (steps.length === 0) return totals;
+	let redeemed = new Big(0);
+	for (const step of steps) redeemed = redeemed.plus(step.discount_amount);
+	const discountTotal = new Big(totals.discount_total).plus(redeemed);
+	const subtotal = new Big(totals.subtotal);
+	const discount_rate = rateOf(discountTotal, subtotal);
+	const discount_total = discountTotal.toNumber();
+	const total = new Big(totals.total).minus(redeemed).toNumber();
+	return {
+		...totals,
+		discount_rate,
+		discount_total,
+		total
+	};
+};
+/** Steps + totals for a set of lines and redeems, keeping step order. */
+const recomputeRedemptions = (input) => {
+	const { lines, redeem, currency } = input;
+	const steps = input.redemption_steps;
+	const redemption_steps = computeRedemptionSteps(lines, redeem, steps);
+	const lineTotals = recomputeTotals(lines, currency);
+	return {
+		redemption_steps,
+		totals: applyRedemptionTotals(lineTotals, redemption_steps)
+	};
+};
+//#endregion
 //#region src/order/Order.ts
 const cloneOrder = (order) => {
 	return structuredClone(order);
@@ -2585,7 +2891,7 @@ const optionalBrandId = (value) => {
 const buildInsertFromOptions = (options) => {
 	if (!options.scope) throw new Error("Order requires scope when fromOrderId is omitted");
 	if (!options.customer) throw new Error("Order requires customer when fromOrderId is omitted");
-	const orderId = options.orderId ?? `ord-${randomUUID().slice(0, 8)}`;
+	const orderId = options.orderId ?? genOrderId(options.scope.store_id);
 	const brand_id = optionalBrandId(options.scope.brand_id);
 	const customer = buildCustomerSnapshot(options.customer);
 	const is_anonymous = options.isAnonymous ?? false;
@@ -2606,7 +2912,8 @@ const buildInsertFromOptions = (options) => {
 	};
 	const b5 = {
 		totals: emptyTotals(),
-		metadata: {}
+		metadata: {},
+		redemption_steps: []
 	};
 	return {
 		...b1,
@@ -2617,8 +2924,8 @@ const buildInsertFromOptions = (options) => {
 	};
 };
 const buildInsertFromSource = (options, source) => {
-	const orderId = options.orderId ?? `ord-${randomUUID().slice(0, 8)}`;
 	const store_id = options.scope?.store_id ?? source.store_id;
+	const orderId = options.orderId ?? genOrderId(store_id);
 	const channel_id = options.scope?.channel_id ?? source.channel_id;
 	const fulfillment_id = options.scope?.fulfillment_id ?? source.fulfillment_id;
 	let brand_id = optionalBrandId(source.brand_id);
@@ -2627,7 +2934,13 @@ const buildInsertFromSource = (options, source) => {
 	if (options.customer) customer = buildCustomerSnapshot(options.customer);
 	const lines = structuredClone(source.lines);
 	const is_anonymous = options.isAnonymous ?? source.is_anonymous;
-	const totals = recomputeTotals(lines, source.totals.currency);
+	const redeem = structuredClone(source.redeem ?? []);
+	const { redemption_steps, totals } = recomputeRedemptions({
+		lines,
+		redeem,
+		redemption_steps: source.redemption_steps ?? [],
+		currency: source.totals.currency
+	});
 	const b1 = {
 		id: orderId,
 		store_id,
@@ -2638,7 +2951,6 @@ const buildInsertFromSource = (options, source) => {
 		brand_id,
 		is_anonymous
 	};
-	const redeem = source.redeem ?? [];
 	const b3 = {
 		customer,
 		lines,
@@ -2649,13 +2961,14 @@ const buildInsertFromSource = (options, source) => {
 	return {
 		...b1,
 		...b2,
-		...b3
+		...b3,
+		redemption_steps
 	};
 };
 const toRedeem = (items) => {
 	return (items ?? []).map((item) => ({
 		...item,
-		amount: item.amount ?? 1
+		quantity: item.quantity ?? 1
 	}));
 };
 /** Local draft until the first mutating flush POSTs to the API. */
@@ -2708,7 +3021,10 @@ const buildLocalDraft = (insert) => {
 		totals,
 		metadata
 	};
-	const b6 = { payment_status };
+	const b6 = {
+		payment_status,
+		redemption_steps: insert.redemption_steps ?? []
+	};
 	const b7 = {
 		fulfillment_status: "IDLE",
 		status: "OPEN"
@@ -2924,54 +3240,89 @@ var Order = class Order {
 	}
 	addLine(lines) {
 		if (this.deleted) return;
-		const nextLines = addLines(this.draft.lines, lines);
-		this.draft = {
-			...this.draft,
-			lines: nextLines,
-			totals: recomputeTotals(nextLines, this.draft.totals.currency)
-		};
-		this.scheduleAfterMutate();
+		this.commitLines({ lines: addLines(this.draft.lines, lines) });
 	}
 	subtractLine(lineUid, quantity = 1) {
 		if (this.deleted) return;
-		const nextLines = subtractLine(this.draft.lines, lineUid, quantity);
-		this.draft = {
-			...this.draft,
-			lines: nextLines,
-			totals: recomputeTotals(nextLines, this.draft.totals.currency)
-		};
-		this.scheduleAfterMutate();
+		const p = [
+			this.draft.lines,
+			lineUid,
+			quantity
+		];
+		this.commitLines({ lines: subtractLine(...p) });
 	}
 	removeLine(lineUid) {
 		if (this.deleted) return;
-		const nextLines = removeLine(this.draft.lines, lineUid);
-		this.draft = {
-			...this.draft,
-			lines: nextLines,
-			totals: recomputeTotals(nextLines, this.draft.totals.currency)
-		};
-		this.scheduleAfterMutate();
+		this.commitLines({ lines: removeLine(this.draft.lines, lineUid) });
 	}
 	replaceLine(lineUid, lines) {
 		if (this.deleted) return;
-		const nextLines = replaceLine(this.draft.lines, lineUid, lines);
-		this.draft = {
-			...this.draft,
-			lines: nextLines,
-			totals: recomputeTotals(nextLines, this.draft.totals.currency)
-		};
-		this.scheduleAfterMutate();
+		const p = [
+			this.draft.lines,
+			lineUid,
+			lines
+		];
+		this.commitLines({ lines: replaceLine(...p) });
 	}
 	emptyOrder() {
 		if (this.deleted) return;
-		const nextLines = emptyLines();
-		this.draft = {
-			...this.draft,
-			lines: nextLines,
-			redeem: [],
-			totals: recomputeTotals(nextLines, this.draft.totals.currency)
-		};
-		this.scheduleAfterMutate();
+		this.commitLines({
+			lines: emptyLines(),
+			redeem: []
+		});
+	}
+	/**
+	* Appends a redeem to `line_uid` (root line) or to the order. Steps keep
+	* the order in which redeems were applied.
+	*/
+	applyRedeem(input) {
+		if (this.deleted) return;
+		const { line_uid, ...rest } = input;
+		const redeem = buildRedeem(rest);
+		if (line_uid === void 0) {
+			this.commitLines({ redeem: [...this.draft.redeem ?? [], redeem] });
+			return;
+		}
+		const line = this.draft.lines.find((item) => item.uid === line_uid);
+		if (!line || line.parent_uid != null || line.type === "FEE") throw new Error(`Redeem requires a root product line, got ${line_uid}`);
+		const lines = this.draft.lines.map((item) => {
+			if (item.uid !== line_uid) return item;
+			return {
+				...item,
+				redeem: [...item.redeem ?? [], redeem]
+			};
+		});
+		this.commitLines({ lines });
+	}
+	/**
+	* Removes `quantity` units of `reward_id` from `line_uid` or the order,
+	* latest applied first. Removing more units than applied clears them all.
+	*/
+	removeRedeem(input) {
+		if (this.deleted) return;
+		const { reward_id, quantity, line_uid } = input;
+		if (line_uid === void 0) {
+			const p = [
+				this.draft.redeem ?? [],
+				reward_id,
+				quantity
+			];
+			this.commitLines({ redeem: subtractRedeem(...p) });
+			return;
+		}
+		const lines = this.draft.lines.map((item) => {
+			if (item.uid !== line_uid) return item;
+			const p = [
+				item.redeem ?? [],
+				reward_id,
+				quantity
+			];
+			return {
+				...item,
+				redeem: subtractRedeem(...p)
+			};
+		});
+		this.commitLines({ lines });
 	}
 	setScope(scope) {
 		if (this.deleted) return;
@@ -3068,7 +3419,11 @@ var Order = class Order {
 			lines: draft.lines,
 			redeem: draft.redeem ?? []
 		};
-		const b5 = { totals: draft.totals };
+		const steps = draft.redemption_steps ?? [];
+		const b5 = {
+			totals: draft.totals,
+			redemption_steps: steps
+		};
 		const body = {
 			...b1,
 			...b2,
@@ -3092,6 +3447,25 @@ var Order = class Order {
 		this.synced = cloneOrder(next);
 		this.notify();
 	}
+	/** Applies lines/redeem, replaying redemption steps and totals. */
+	commitLines(patch) {
+		const lines = patch.lines ?? this.draft.lines;
+		const redeem = patch.redeem ?? this.draft.redeem ?? [];
+		const { redemption_steps, totals } = recomputeRedemptions({
+			lines,
+			redeem,
+			redemption_steps: this.draft.redemption_steps ?? [],
+			currency: this.draft.totals.currency
+		});
+		this.draft = {
+			...this.draft,
+			lines,
+			redeem,
+			redemption_steps,
+			totals
+		};
+		this.scheduleAfterMutate();
+	}
 	scheduleAfterMutate() {
 		this.flush.markDirtyDuringFlight();
 		this.notify();
@@ -3611,6 +3985,152 @@ const validateProductRoot = (root, lines, lookup, locale, out) => {
 	}
 	compareTrees(lines, expected, root.uid, expectedRoot.uid, out);
 };
+const isExpired = (redeem, now) => {
+	if (redeem.expires_at === void 0) return false;
+	return Date.parse(redeem.expires_at) <= now;
+};
+const expiredIssues = (redeem, now) => {
+	const issues = [];
+	redeem.forEach((item, index) => {
+		if (!isExpired(item, now)) return;
+		const field = `redeem.${index}.expires_at`;
+		issues.push({
+			code: "REDEEM_EXPIRED",
+			field,
+			actual: item.expires_at
+		});
+	});
+	return issues;
+};
+const redeemSignature = (items) => {
+	return items.map((item) => `${item.reward_id}:${item.quantity}`).join(",");
+};
+const stepSignature = (steps) => {
+	return steps.map((step) => `${step.reward_id}:${step.reward_quantity}`).join(",");
+};
+/** Every target's redeems must have one step each, in the same order. */
+const checkRedemptionTargets = (lines, redeem, steps, issues, lineIssues) => {
+	const byTarget = /* @__PURE__ */ new Map();
+	for (const step of steps) {
+		const key = redemptionTargetKey(step);
+		byTarget.set(key, [...byTarget.get(key) ?? [], step]);
+	}
+	const check = (key, items) => {
+		const targetSteps = byTarget.get(key) ?? [];
+		byTarget.delete(key);
+		const expected = redeemSignature(items);
+		const actual = stepSignature(targetSteps);
+		if (expected === actual) return null;
+		return {
+			code: "REDEMPTION_STEPS_MISMATCH",
+			field: "redemption_steps",
+			expected,
+			actual
+		};
+	};
+	const orderIssue = check(redemptionTargetKey({ target: "ORDER" }), redeem);
+	if (orderIssue) issues.push(orderIssue);
+	for (const line of lines) {
+		const lineIssue = check(redemptionTargetKey({
+			target: "LINE",
+			target_id: line.uid
+		}), line.redeem ?? []);
+		if (lineIssue) pushLineIssue(lineIssues, line.uid, lineIssue);
+	}
+	for (const orphan of byTarget.values()) {
+		const b1 = { code: "REDEMPTION_STEPS_MISMATCH" };
+		const b2 = {
+			field: "redemption_steps.target_id",
+			expected: ""
+		};
+		issues.push({
+			...b1,
+			...b2,
+			actual: stepSignature(orphan)
+		});
+	}
+};
+const STATE_FIELDS = [
+	"value",
+	"quantity",
+	"discount_amount",
+	"discount_rate"
+];
+const STATE_KEYS = [
+	"before",
+	"after",
+	"target_before",
+	"target_after"
+];
+const flattenState = (prefix, state, out) => {
+	for (const field of STATE_FIELDS) out[`${prefix}.${field}`] = state ? bigStr(state[field]) : "";
+};
+const flattenStep = (step) => {
+	const b1 = { reward_id: step.reward_id };
+	const b2 = { reward_quantity: String(step.reward_quantity) };
+	const b3 = {
+		target: step.target,
+		target_id: step.target_id ?? ""
+	};
+	const b4 = { action: step.action };
+	const b5 = { discount_amount: bigStr(step.discount_amount) };
+	const out = {
+		...b1,
+		...b2,
+		...b3,
+		...b4,
+		...b5
+	};
+	for (const key of STATE_KEYS) flattenState(key, step[key], out);
+	return out;
+};
+/** Replayed steps must equal the submitted ones field by field. */
+const compareRedemptionSteps = (submitted, expected, issues) => {
+	if (submitted.length !== expected.length) {
+		const b1 = { code: "REDEMPTION_MISMATCH" };
+		const b2 = { field: "redemption_steps" };
+		const b3 = { expected: String(expected.length) };
+		issues.push({
+			...b1,
+			...b2,
+			...b3,
+			actual: String(submitted.length)
+		});
+		return;
+	}
+	submitted.forEach((step, index) => {
+		const actual = flattenStep(step);
+		const wanted = flattenStep(expected[index]);
+		for (const field of Object.keys(wanted)) {
+			if (actual[field] === wanted[field]) continue;
+			const b1 = { code: "REDEMPTION_MISMATCH" };
+			const b2 = { field: `redemption_steps.${index}.${field}` };
+			const b3 = {
+				expected: wanted[field],
+				actual: actual[field]
+			};
+			issues.push({
+				...b1,
+				...b2,
+				...b3
+			});
+		}
+	});
+};
+const validateRedemptions = (input, issues, lineIssues) => {
+	const redeem = input.redeem ?? [];
+	const steps = input.redemptionSteps ?? [];
+	const now = input.now ?? Date.now();
+	issues.push(...expiredIssues(redeem, now));
+	for (const line of input.lines) {
+		const expired = expiredIssues(line.redeem ?? [], now);
+		for (const issue of expired) pushLineIssue(lineIssues, line.uid, issue);
+	}
+	checkRedemptionTargets(input.lines, redeem, steps, issues, lineIssues);
+	const expected = computeRedemptionSteps(input.lines, redeem, steps);
+	compareRedemptionSteps(steps, expected, issues);
+	return expected;
+};
 /** Compare cart lines/totals against a fresh menu (exact Big.js equality). */
 const validateOrderAgainstMenu = (input) => {
 	const locale = input.locale ?? "en_us";
@@ -3641,7 +4161,8 @@ const validateOrderAgainstMenu = (input) => {
 	}
 	checkRootProductQuantities(roots, lookup, lineIssues);
 	if (input.expectedFeeLines) compareExpectedFeeLines(input.lines, input.expectedFeeLines, lineIssues);
-	const expectedTotals = recomputeTotals(input.lines, input.totals.currency);
+	const expectedSteps = validateRedemptions(input, issues, lineIssues);
+	const expectedTotals = applyRedemptionTotals(recomputeTotals(input.lines, input.totals.currency), expectedSteps);
 	for (const field of TOTALS_FIELDS) {
 		if (bigEq(input.totals[field], expectedTotals[field])) continue;
 		issues.push({
@@ -5018,4 +5539,4 @@ const paymentMatchesClientConditions = (conditions, order, options) => {
 	return Boolean(engine.matchOrConditions(groups).match);
 };
 //#endregion
-export { DEFAULT_RECOMMENDATION_TYPES, Order, OrderSyncPendingError, OrderValidationError, RecurringDateCron, RulesEngine, StorefrontHttpError, addLines, auth, buildCustomerSnapshot, collectOrderLineDiffs, countCartProducts, createSession, currentNodes, defaultConditionError, flattenMenuCategories, fromOrderLines, getScheduleWindow, indexMenu, isCheckoutFieldFilled, isDeviceNotLinked, isKioskUnauthorized, isMilestoneStepDone, isOnSchedule, isOrderValidationError, isStorefrontNotFound, listMenusStream, matchAbsoluteDateOperator, matchBooleanOperator, matchCurrencyOperator, matchEnumOperator, matchNumberOperator, matchRecurringDateOperator, matchRelativeDateOperator, matchStringOperator, milestoneSteps, milestoneTrack, nestMenuCategories, paymentMatchesClientConditions, recomputeTotals, resolveCheckout, services, storefrontJson, toOrderLines, validateOrderAgainstMenu, visitedStates };
+export { DEFAULT_RECOMMENDATION_TYPES, Order, OrderSyncPendingError, OrderValidationError, RecurringDateCron, RulesEngine, StorefrontHttpError, addLines, auth, buildCustomerSnapshot, collectOrderLineDiffs, countCartProducts, createSession, currentNodes, defaultConditionError, flattenMenuCategories, fromOrderLines, genId, genOrderId, getScheduleWindow, indexMenu, isCheckoutFieldFilled, isDeviceNotLinked, isKioskUnauthorized, isMilestoneStepDone, isOnSchedule, isOrderValidationError, isStorefrontNotFound, listMenusStream, matchAbsoluteDateOperator, matchBooleanOperator, matchCurrencyOperator, matchEnumOperator, matchNumberOperator, matchRecurringDateOperator, matchRelativeDateOperator, matchStringOperator, milestoneSteps, milestoneTrack, nestMenuCategories, paymentMatchesClientConditions, recomputeRedemptions, recomputeTotals, resolveCheckout, services, storefrontJson, toOrderLines, validateOrderAgainstMenu, visitedStates };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fire-spark/core",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Fire Spark headless SDK",
   "type": "module",
   "sideEffects": false,
@@ -11,7 +11,6 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "development": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
@@ -20,7 +19,7 @@
   "dependencies": {
     "big.js": "6.2.1",
     "dayjs": "1.11.9",
-    "@fire-spark/types": "0.0.1"
+    "@fire-spark/types": "0.0.2"
   },
   "devDependencies": {
     "@types/big.js": "6.2.2",