@fire-spark/core 0.0.1 → 0.0.3

package/dist/index.d.ts

@@ -1,11 +1,16 @@
-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, StoreGetInput, StoreListInput, StoreNearbyInput, StorefrontAvailability, StorefrontMenuScope, StorefrontMenuStreamOptions, StorefrontPaymentsListInput, Variant, VariantGroup } from "@fire-spark/types";
+import { Big } from "big.js";
 //#region src/productCustomization/types.d.ts
 type SelectionStatus = "IDLE" | "INCOMPLETE" | "VALID" | "INVALID";
+type StartingPriceCache = Map<string, Big>;
 type CustomizationPath = string;
 type QuantitiesByPath = Record<CustomizationPath, number>;
+type SelectionsByPath = Record<CustomizationPath, VariantSelection>;
 interface Snapshot {
   productId: string;
   quantities: QuantitiesByPath;
+  /** Variant picks of modifiers whose product is a variant base. */
+  variants?: SelectionsByPath;
 }
 interface CreateSessionOptions {
   initial?: QuantitiesByPath;
@@ -50,12 +55,40 @@ interface ModifierCtx {
   status: SelectionStatus;
   data: Product;
   type: ModifierControlType;
+  /** Nested customization; for a variant base, the resolved variant (or the
+   * base while options are pending). */
   product: ProductCtx | null;
+  /** Variant questions when `data` is a variant base; empty otherwise. */
+  variants: VariantGroupCtx[];
+  /** Product that is ordered: `data`, the resolved variant, or null while a
+   * variant base still has unanswered options. */
+  resolved: Product | null;
   onChange: (quantity: number) => void;
   linePrice: number;
 }
+/** Variant group id → chosen variant (option) id. */
+type VariantSelection = Record<string, string>;
+interface VariantOptionCtx {
+  path: CustomizationPath;
+  data: Variant;
+  selected: boolean;
+  disabled: boolean;
+  select: () => void;
+}
+interface VariantGroupCtx {
+  path: CustomizationPath;
+  data: VariantGroup;
+  selectedId: string | null;
+  status: SelectionStatus;
+  options: VariantOptionCtx[];
+}
 interface CustomizationSession {
+  /** Resolved product; the base selector until every variant group is chosen. */
   root: ProductCtx;
+  /** Product carrying variant_group_ids, or null for plain products. */
+  base: Product | null;
+  /** Rendered before modifier groups; empty for plain products. */
+  variants: VariantGroupCtx[];
   subscribe: (listener: () => void) => () => void;
   snapshot: () => Snapshot;
   totalPrice: () => number;
@@ -100,10 +133,18 @@ declare const fromOrderLines: (root: OrderLine, lines: OrderLine[], lookup: Menu
 //#region src/productCustomization/menu.d.ts
 declare const indexMenu: (menu: Menu$1) => MenuLookup$1;
 //#endregion
+//#region src/productCustomization/startingPrice.d.ts
+/** Lowest unit price reachable while satisfying every required modifier.
+ * For a variant base, the cheapest of its variant products. */
+declare const computeStartingPrice: (lookup: MenuLookup$1, product: Product$1, cache?: StartingPriceCache) => number;
+//#endregion
 //#region src/productCustomization/toOrderLines.d.ts
 /** Flatten a customized product tree into priced OrderLine rows. */
 declare const toOrderLines: (root: ProductCtx, locale: string) => OrderLine[];
 //#endregion
+//#region src/productCustomization/variants.d.ts
+declare const isVariantBase: (product: Product$1) => boolean;
+//#endregion
 //#region src/shared/baseUrl.d.ts
 declare const resolveBaseUrl: (baseUrl?: string) => string;
 //#endregion
@@ -208,9 +249,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 +276,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 +421,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 +448,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 +593,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 +620,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 +1203,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 +1230,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 +1375,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 +1402,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 +1547,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 +1574,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 +1719,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 +1746,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 +1894,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 +1970,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 +1991,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 +2057,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" | "VARIANT_BASE_NOT_ORDERABLE" | "VARIANT_NOT_OFFERED" | "PRICE_MISMATCH" | "TAX_MISMATCH" | "DISCOUNT_MISMATCH" | "QUANTITY_MISMATCH" | "QUANTITY_BELOW_MINIMUM" | "QUANTITY_ABOVE_MAXIMUM" | "STRUCTURE_MISMATCH" | "FEE_MISMATCH" | "REDEEM_EXPIRED" | "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 +2085,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 +2114,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;
@@ -2387,6 +2775,7 @@ declare const listMenus: (scope?: StorefrontMenuScope, options?: ServiceHttpOpti
       price: number;
       anchor_price?: number | undefined;
       anchor_price_percentage?: number | undefined;
+      starting_price?: number | null | undefined;
       modifiers: {
         modifier_group_id: string;
         default_quantity: number;
@@ -2405,6 +2794,11 @@ declare const listMenus: (scope?: StorefrontMenuScope, options?: ServiceHttpOpti
         anchor_price_percentage?: number | undefined;
       }[];
       modifier_group_ids: string[];
+      variants: {
+        product_id: string;
+        variant_group_option_ids: string[];
+      }[];
+      variant_group_ids: string[];
       recommendations: {
         recommendation_id: string;
         default_quantity: number;
@@ -2492,6 +2886,22 @@ declare const listMenus: (scope?: StorefrontMenuScope, options?: ServiceHttpOpti
     charge_above_quantity?: number | null | undefined;
     metadata: Record<string, unknown>;
   }[];
+  variant_groups: {
+    id: string;
+    title: Record<string, string>;
+    description?: Record<string, string> | null | undefined;
+    display_type?: "GRID" | "LIST" | null | undefined;
+    variants: {
+      id: string;
+      name: Record<string, string>;
+      description?: Record<string, string> | null | undefined;
+      image_url?: string | null | undefined;
+      image_origin_url?: string | null | undefined;
+      product_ids: string[];
+      metadata: Record<string, unknown>;
+    }[];
+    metadata: Record<string, unknown>;
+  }[];
   recommendations: ({
     id: string;
     title: Record<string, string>;
@@ -2582,6 +2992,7 @@ declare const listMenusStream: (scope?: StorefrontMenuScope, options?: ListMenus
       price: number;
       anchor_price?: number | undefined;
       anchor_price_percentage?: number | undefined;
+      starting_price?: number | null | undefined;
       modifiers: {
         modifier_group_id: string;
         default_quantity: number;
@@ -2600,6 +3011,11 @@ declare const listMenusStream: (scope?: StorefrontMenuScope, options?: ListMenus
         anchor_price_percentage?: number | undefined;
       }[];
       modifier_group_ids: string[];
+      variants: {
+        product_id: string;
+        variant_group_option_ids: string[];
+      }[];
+      variant_group_ids: string[];
       recommendations: {
         recommendation_id: string;
         default_quantity: number;
@@ -2687,6 +3103,22 @@ declare const listMenusStream: (scope?: StorefrontMenuScope, options?: ListMenus
     charge_above_quantity?: number | null | undefined;
     metadata: Record<string, unknown>;
   }[];
+  variant_groups: {
+    id: string;
+    title: Record<string, string>;
+    description?: Record<string, string> | null | undefined;
+    display_type?: "GRID" | "LIST" | null | undefined;
+    variants: {
+      id: string;
+      name: Record<string, string>;
+      description?: Record<string, string> | null | undefined;
+      image_url?: string | null | undefined;
+      image_origin_url?: string | null | undefined;
+      product_ids: string[];
+      metadata: Record<string, unknown>;
+    }[];
+    metadata: Record<string, unknown>;
+  }[];
   recommendations: ({
     id: string;
     title: Record<string, string>;
@@ -2958,6 +3390,8 @@ declare const listStores: (input?: StoreListInput, options?: ServiceHttpOptions)
     temporary_closed_until?: string | null | undefined;
     status: "CLOSED" | "OPEN" | "TEMPORARILY_CLOSED";
   };
+  channel_ids: string[];
+  fulfillment_ids: string[];
   tags: Record<string, string | number | boolean>;
   cms_template_id?: string | null | undefined;
   status: string;
@@ -3052,6 +3486,8 @@ declare const listNearbyStores: (input: StoreNearbyInput, options?: ServiceHttpO
     temporary_closed_until?: string | null | undefined;
     status: "CLOSED" | "OPEN" | "TEMPORARILY_CLOSED";
   };
+  channel_ids: string[];
+  fulfillment_ids: string[];
   tags: Record<string, string | number | boolean>;
   cms_template_id?: string | null | undefined;
   status: string;
@@ -3107,7 +3543,7 @@ declare const listNearbyStores: (input: StoreNearbyInput, options?: ServiceHttpO
   } | null | undefined;
   labels: string[];
 }[]>;
-declare const getStore: (id: string, options?: ServiceHttpOptions) => Promise<{
+declare const getStore: (id: string, input?: StoreGetInput, options?: ServiceHttpOptions) => Promise<{
   id: string;
   uid: string;
   merchant_id: string;
@@ -3146,6 +3582,8 @@ declare const getStore: (id: string, options?: ServiceHttpOptions) => Promise<{
     temporary_closed_until?: string | null | undefined;
     status: "CLOSED" | "OPEN" | "TEMPORARILY_CLOSED";
   };
+  channel_ids: string[];
+  fulfillment_ids: string[];
   tags: Record<string, string | number | boolean>;
   cms_template_id?: string | null | undefined;
   status: string;
@@ -3276,6 +3714,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 +3857,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 SelectionsByPath, type ServiceHttpOptions, type Snapshot, type StorefrontAccessToken, StorefrontHttpError, type TrackWorkflow, type ValidateOptions, type ValidateOrderAgainstMenuInput, type Variant, type VariantGroup, type VariantGroupCtx, type VariantOptionCtx, type VariantSelection, type VisitedState, addLines, auth, buildCustomerSnapshot, collectOrderLineDiffs, computeStartingPrice, countCartProducts, createSession, currentNodes, defaultConditionError, flattenMenuCategories, fromOrderLines, genId, genOrderId, getScheduleWindow, indexMenu, isCheckoutFieldFilled, isDeviceNotLinked, isKioskUnauthorized, isMilestoneStepDone, isOnSchedule, isOrderValidationError, isStorefrontNotFound, isVariantBase, listMenusStream, matchAbsoluteDateOperator, matchBooleanOperator, matchCurrencyOperator, matchEnumOperator, matchNumberOperator, matchRecurringDateOperator, matchRelativeDateOperator, matchStringOperator, milestoneSteps, milestoneTrack, nestMenuCategories, paymentMatchesClientConditions, recomputeRedemptions, recomputeTotals, resolveCheckout, services, storefrontJson, toOrderLines, validateOrderAgainstMenu, visitedStates };