@fire-spark/core 0.0.2 → 0.0.4

package/dist/index.d.ts

@@ -1,11 +1,17 @@
-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";
+import { PaymentAdapter, PaymentCollectAt, PaymentContext, PaymentResult, PaymentStorage, PaymentUI } from "@fire-spark/payments";
+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, MerchantPayment, ModifierControlType, ModifierGroup, OrConditions, Order as Order$1, Order as Order$2, OrderInsertInput, OrderLine, OrderListInput, OrderRecordPaymentInput, OrderRedeem, OrderRedemptionStep, OrderReorderInput, OrderTotals, OrderUpdateInput, OrderValidateInput, OrderValidateOutput, PaymentIntentInput, PaymentMethod, PaymentProvider, PosCatalog, PosHealthBatchInput, PosHealthBatchResult, PosHeartbeatInput, PosHeartbeatResult, PosKioskOrder, PosKioskSettleInput, PosKioskSettleResult, PosOrderInput, PosOrderResult, PricingModifier, Product, Product as Product$1, Recommendation, RecurringDateCronResult, RecurringDateCronValues, RulesEngineOrderLine, RulesEngineParams, RulesEngineRuntime, Schedule, SdkLogContext, SdkLogErrorInfo, SdkLogLevel, SdkLogOptions, 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 +56,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 +134,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
@@ -319,8 +361,9 @@ declare const listOrders: (input?: OrderListInput, options?: ServiceHttpOptions)
   };
   payment_intents: {
     id?: string | undefined;
-    method: "BANK_TRANSFER" | "CARD" | "CASH" | "PIN_PAD" | "WALLET";
-    provider: "firespark" | "kushki" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "stripe" | "yape";
+    payment_id?: string | undefined;
+    method: "BANK_TRANSFER" | "CARD" | "CASH" | "FINANCING" | "PIN_PAD" | "WALLET";
+    provider: "amipass" | "cashea" | "clisitef" | "credibanco" | "datafast" | "deuna" | "edenred" | "firespark" | "kushki" | "mach" | "medianet" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "pluxee" | "posnet" | "redeban" | "rutpay" | "sitef_venezuela" | "stripe" | "transbank" | "yape";
     collect_at: "COUNTER" | "DEVICE" | "DOOR" | "KIOSK" | "OTHER";
     status: "CANCELLED" | "FAILED" | "IDLE" | "PAID" | "PENDING" | "REFUNDED";
     totals: {
@@ -491,8 +534,9 @@ declare const createOrder: (body: OrderInsertInput, options?: ServiceHttpOptions
   };
   payment_intents: {
     id?: string | undefined;
-    method: "BANK_TRANSFER" | "CARD" | "CASH" | "PIN_PAD" | "WALLET";
-    provider: "firespark" | "kushki" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "stripe" | "yape";
+    payment_id?: string | undefined;
+    method: "BANK_TRANSFER" | "CARD" | "CASH" | "FINANCING" | "PIN_PAD" | "WALLET";
+    provider: "amipass" | "cashea" | "clisitef" | "credibanco" | "datafast" | "deuna" | "edenred" | "firespark" | "kushki" | "mach" | "medianet" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "pluxee" | "posnet" | "redeban" | "rutpay" | "sitef_venezuela" | "stripe" | "transbank" | "yape";
     collect_at: "COUNTER" | "DEVICE" | "DOOR" | "KIOSK" | "OTHER";
     status: "CANCELLED" | "FAILED" | "IDLE" | "PAID" | "PENDING" | "REFUNDED";
     totals: {
@@ -663,8 +707,9 @@ declare const getOrder: (id: string, options?: ServiceHttpOptions) => Promise<{
   };
   payment_intents: {
     id?: string | undefined;
-    method: "BANK_TRANSFER" | "CARD" | "CASH" | "PIN_PAD" | "WALLET";
-    provider: "firespark" | "kushki" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "stripe" | "yape";
+    payment_id?: string | undefined;
+    method: "BANK_TRANSFER" | "CARD" | "CASH" | "FINANCING" | "PIN_PAD" | "WALLET";
+    provider: "amipass" | "cashea" | "clisitef" | "credibanco" | "datafast" | "deuna" | "edenred" | "firespark" | "kushki" | "mach" | "medianet" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "pluxee" | "posnet" | "redeban" | "rutpay" | "sitef_venezuela" | "stripe" | "transbank" | "yape";
     collect_at: "COUNTER" | "DEVICE" | "DOOR" | "KIOSK" | "OTHER";
     status: "CANCELLED" | "FAILED" | "IDLE" | "PAID" | "PENDING" | "REFUNDED";
     totals: {
@@ -699,6 +744,7 @@ declare const getOrder: (id: string, options?: ServiceHttpOptions) => Promise<{
 }>;
 type PlaceOrderInput = {
   payment?: {
+    id?: string;
     type?: PaymentMethod;
     provider?: PaymentProvider;
     intents?: PaymentIntentInput[];
@@ -709,6 +755,180 @@ declare const placeOrder: (id: string, body?: PlaceOrderInput, options?: Service
   order_fulfillment_id: string;
   status: "ACCEPTED" | "EXISTS" | "IN_PROGRESS";
 }>;
+/** Records (or updates by `metadata.attempt_reference`) one payment intent. */
+declare const recordOrderPayment: (id: string, body: OrderRecordPaymentInput, options?: ServiceHttpOptions) => Promise<{
+  uid: string;
+  id: string;
+  brand_id?: string | null | undefined;
+  store_id: string;
+  channel_id: string;
+  customer_id: string;
+  fulfillment_id: string;
+  is_anonymous: boolean;
+  lines: {
+    type: "FEE" | "PRODUCT";
+    uid: string;
+    id: string;
+    parent_uid: string | null;
+    parent_id: string | null;
+    name: string;
+    image_url?: string | undefined;
+    menu_id?: string | undefined;
+    internal_attribution_source?: string | undefined;
+    internal_attribution_id?: string | undefined;
+    metadata: Record<string, unknown>;
+    bundled_items: {
+      id: string;
+      refund_price: number;
+      included_quantity: number;
+    }[];
+    redeem: {
+      reward_id: string;
+      quantity: number;
+      discount_rate?: number | undefined;
+      discount_amount?: number | undefined;
+      expires_at?: string | undefined;
+    }[];
+    quantity: number;
+    tax_rate: number | null;
+    discount_rate: number;
+    unit_subtotal: number;
+    unit_discount: number;
+    unit_tax_total: number;
+    unit_total: number;
+    subtotal: number;
+    discount_total: number;
+    tax_total: number;
+    total: number;
+    unit_group_subtotal: number;
+    unit_group_discount: number;
+    unit_group_tax_total: number;
+    unit_group_total: number;
+    group_subtotal: number;
+    group_discount: number;
+    group_tax_total: number;
+    group_total: number;
+  }[];
+  redeem: {
+    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: {
+      display_name: string;
+      first_name: string;
+      middle_name?: string | undefined;
+      last_name: string;
+      second_last_name?: string | undefined;
+      email: string;
+      phone: string;
+      gender?: "FEMALE" | "MALE" | undefined;
+      dob?: string | undefined;
+      document_type?: "CI" | "DNI" | "OTHER" | "PASSPORT" | "RUC" | undefined;
+      document_number?: string | undefined;
+      city?: string | undefined;
+      country?: string | undefined;
+    };
+    address_info?: {
+      address_line1: string;
+      address_line2?: string | undefined;
+      city?: string | undefined;
+      state?: string | undefined;
+      zip?: string | undefined;
+      country?: string | undefined;
+      reference?: string | undefined;
+      latitude?: number | undefined;
+      longitude?: number | undefined;
+      instructions?: string | undefined;
+      metadata: Record<string, unknown> | null;
+    } | null | undefined;
+    billing_info?: {
+      type: "BUSINESS" | "INDIVIDUAL";
+      legal_name: string;
+      address_line1: string;
+      address_line2?: string | undefined;
+      city?: string | undefined;
+      state?: string | undefined;
+      zip?: string | undefined;
+      country?: string | undefined;
+      tax_id: string;
+      tax_id_type: "CI" | "CUIT" | "DNI" | "EIN" | "NIF" | "NIT" | "OTHER" | "PASSPORT" | "RCN" | "RUC" | "RUT" | "SSN" | "TIN" | "VAT";
+      metadata: Record<string, unknown> | null;
+    } | null | undefined;
+  };
+  payment_intents: {
+    id?: string | undefined;
+    payment_id?: string | undefined;
+    method: "BANK_TRANSFER" | "CARD" | "CASH" | "FINANCING" | "PIN_PAD" | "WALLET";
+    provider: "amipass" | "cashea" | "clisitef" | "credibanco" | "datafast" | "deuna" | "edenred" | "firespark" | "kushki" | "mach" | "medianet" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "pluxee" | "posnet" | "redeban" | "rutpay" | "sitef_venezuela" | "stripe" | "transbank" | "yape";
+    collect_at: "COUNTER" | "DEVICE" | "DOOR" | "KIOSK" | "OTHER";
+    status: "CANCELLED" | "FAILED" | "IDLE" | "PAID" | "PENDING" | "REFUNDED";
+    totals: {
+      currency: string;
+      subtotal: number;
+      discount_rate: number;
+      discount_total: number;
+      tax_rate: number;
+      tax_total: number;
+      total: number;
+    };
+    error_message?: string | undefined;
+    placed_at: string;
+    resolved_at?: string | undefined;
+    metadata: Record<string, unknown>;
+  }[];
+  totals: {
+    currency: string;
+    subtotal: number;
+    discount_rate: number;
+    discount_total: number;
+    tax_rate: number;
+    tax_total: number;
+    total: number;
+  };
+  metadata: Record<string, unknown>;
+  payment_status: "CANCELLED" | "FAILED" | "IDLE" | "PAID" | "PENDING" | "REFUNDED";
+  fulfillment_status: string;
+  status: "CANCELLED" | "CLOSED" | "COMPLETED" | "OPEN" | "REFUNDED" | "REVERSED" | "VOIDED";
+  issued_at?: string | null | undefined;
+  resolved_at?: string | null | undefined;
+}>;
 declare const getOrderFulfillment: (id: string, options?: ServiceHttpOptions) => Promise<{
   uid: string;
   id: string;
@@ -884,7 +1104,7 @@ declare const getOrderFulfillment: (id: string, options?: ServiceHttpOptions) =>
         } | {
           interpretation?: "both" | "client" | "server" | undefined;
           primitive: "custom";
-          type: "Brand" | "Brands" | "Channel" | "Channels" | "Fulfillment" | "Fulfillments" | "Store" | "Stores";
+          type: "Brand" | "Brands" | "Channel" | "Channels" | "Fulfillment" | "Fulfillments" | "Payment" | "Payments" | "Store" | "Stores";
           operator: "is" | "is all of" | "is any of" | "is none of" | "is not";
           value: string;
           label_ids?: string[] | undefined;
@@ -1097,7 +1317,7 @@ declare const listOrderFulfillments: (ids: string[], options?: ServiceHttpOption
         } | {
           interpretation?: "both" | "client" | "server" | undefined;
           primitive: "custom";
-          type: "Brand" | "Brands" | "Channel" | "Channels" | "Fulfillment" | "Fulfillments" | "Store" | "Stores";
+          type: "Brand" | "Brands" | "Channel" | "Channels" | "Fulfillment" | "Fulfillments" | "Payment" | "Payments" | "Store" | "Stores";
           operator: "is" | "is all of" | "is any of" | "is none of" | "is not";
           value: string;
           label_ids?: string[] | undefined;
@@ -1273,8 +1493,9 @@ declare const updateOrder: (id: string, body: OrderUpdateInput, options?: Servic
   };
   payment_intents: {
     id?: string | undefined;
-    method: "BANK_TRANSFER" | "CARD" | "CASH" | "PIN_PAD" | "WALLET";
-    provider: "firespark" | "kushki" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "stripe" | "yape";
+    payment_id?: string | undefined;
+    method: "BANK_TRANSFER" | "CARD" | "CASH" | "FINANCING" | "PIN_PAD" | "WALLET";
+    provider: "amipass" | "cashea" | "clisitef" | "credibanco" | "datafast" | "deuna" | "edenred" | "firespark" | "kushki" | "mach" | "medianet" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "pluxee" | "posnet" | "redeban" | "rutpay" | "sitef_venezuela" | "stripe" | "transbank" | "yape";
     collect_at: "COUNTER" | "DEVICE" | "DOOR" | "KIOSK" | "OTHER";
     status: "CANCELLED" | "FAILED" | "IDLE" | "PAID" | "PENDING" | "REFUNDED";
     totals: {
@@ -1445,8 +1666,9 @@ declare const cancelOrder: (id: string, options?: ServiceHttpOptions) => Promise
   };
   payment_intents: {
     id?: string | undefined;
-    method: "BANK_TRANSFER" | "CARD" | "CASH" | "PIN_PAD" | "WALLET";
-    provider: "firespark" | "kushki" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "stripe" | "yape";
+    payment_id?: string | undefined;
+    method: "BANK_TRANSFER" | "CARD" | "CASH" | "FINANCING" | "PIN_PAD" | "WALLET";
+    provider: "amipass" | "cashea" | "clisitef" | "credibanco" | "datafast" | "deuna" | "edenred" | "firespark" | "kushki" | "mach" | "medianet" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "pluxee" | "posnet" | "redeban" | "rutpay" | "sitef_venezuela" | "stripe" | "transbank" | "yape";
     collect_at: "COUNTER" | "DEVICE" | "DOOR" | "KIOSK" | "OTHER";
     status: "CANCELLED" | "FAILED" | "IDLE" | "PAID" | "PENDING" | "REFUNDED";
     totals: {
@@ -1617,8 +1839,9 @@ declare const refundOrder: (id: string, options?: ServiceHttpOptions) => Promise
   };
   payment_intents: {
     id?: string | undefined;
-    method: "BANK_TRANSFER" | "CARD" | "CASH" | "PIN_PAD" | "WALLET";
-    provider: "firespark" | "kushki" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "stripe" | "yape";
+    payment_id?: string | undefined;
+    method: "BANK_TRANSFER" | "CARD" | "CASH" | "FINANCING" | "PIN_PAD" | "WALLET";
+    provider: "amipass" | "cashea" | "clisitef" | "credibanco" | "datafast" | "deuna" | "edenred" | "firespark" | "kushki" | "mach" | "medianet" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "pluxee" | "posnet" | "redeban" | "rutpay" | "sitef_venezuela" | "stripe" | "transbank" | "yape";
     collect_at: "COUNTER" | "DEVICE" | "DOOR" | "KIOSK" | "OTHER";
     status: "CANCELLED" | "FAILED" | "IDLE" | "PAID" | "PENDING" | "REFUNDED";
     totals: {
@@ -1789,8 +2012,9 @@ declare const reorderOrder: (id: string, body?: OrderReorderInput, options?: Ser
   };
   payment_intents: {
     id?: string | undefined;
-    method: "BANK_TRANSFER" | "CARD" | "CASH" | "PIN_PAD" | "WALLET";
-    provider: "firespark" | "kushki" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "stripe" | "yape";
+    payment_id?: string | undefined;
+    method: "BANK_TRANSFER" | "CARD" | "CASH" | "FINANCING" | "PIN_PAD" | "WALLET";
+    provider: "amipass" | "cashea" | "clisitef" | "credibanco" | "datafast" | "deuna" | "edenred" | "firespark" | "kushki" | "mach" | "medianet" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "pluxee" | "posnet" | "redeban" | "rutpay" | "sitef_venezuela" | "stripe" | "transbank" | "yape";
     collect_at: "COUNTER" | "DEVICE" | "DOOR" | "KIOSK" | "OTHER";
     status: "CANCELLED" | "FAILED" | "IDLE" | "PAID" | "PENDING" | "REFUNDED";
     totals: {
@@ -1825,6 +2049,56 @@ declare const reorderOrder: (id: string, body?: OrderReorderInput, options?: Ser
 }>;
 declare const validateOrder: (body: OrderValidateInput, options?: ServiceHttpOptions) => Promise<OrderValidateOutput>;
 //#endregion
+//#region src/order/payments/orchestrator.d.ts
+type Clock = {
+  now: () => number;
+  sleep: (ms: number, signal?: AbortSignal) => Promise<void>;
+};
+type PaymentRunOptions = {
+  clock?: Clock;
+  /** Called with every intermediate result (e.g. to record PENDING + QR). */
+  onProgress?: (result: PaymentResult) => void | Promise<void>;
+};
+/**
+ * One payment attempt with the policy of section 7: timeout, retries on
+ * retryable errors (same `attempt_reference`), batch close and retry,
+ * polling for actions and resolution of ambiguous results.
+ */
+declare const runPaymentAttempt: (adapter: PaymentAdapter, ctx: PaymentContext, options?: PaymentRunOptions) => Promise<PaymentResult>;
+type ReversalOutcome = {
+  kind: "cancel" | "refund" | "manual";
+  result: PaymentResult;
+};
+/** Undo a charge after a failed injection or an incomplete split payment. */
+declare const reversePayment: (adapter: PaymentAdapter, ctx: PaymentContext, result: PaymentResult, options?: {
+  clock?: Clock;
+  now?: Date;
+}) => Promise<ReversalOutcome>;
+//#endregion
+//#region src/order/payments/session.d.ts
+type Intent = Order$1["payment_intents"][number];
+type PaymentSessionOptions = {
+  /** Merchant env is production (`env_is_prod`). */
+  isProduction?: boolean;
+  /** Where the customer pays: `KIOSK` on a kiosk, `DEVICE` on web/app. */
+  collectAt?: PaymentCollectAt;
+  /** Where cash is collected: `COUNTER` on a kiosk, `DOOR` on delivery. */
+  cashCollectAt?: PaymentCollectAt;
+  /** `settings_overrides.payment_settings` of this device, by payment id. */
+  deviceSettings?: Record<string, Record<string, unknown>>;
+  /** Kiosk device id, sent with terminal failure reports. */
+  deviceId?: string | null;
+};
+type PayOptions = {
+  /** Amount in the order currency; defaults to the remaining amount. */
+  amount?: number;
+  signal?: AbortSignal;
+  onProgress?: PaymentRunOptions["onProgress"];
+};
+/** PAID plus PENDING with `confirm_after_inject`, in the order currency. */
+declare const coveredAmount: (intents: Intent[]) => number;
+declare const remainingAmount: (order: Order$1) => number;
+//#endregion
 //#region src/order/recommendations.d.ts
 type RecommendationType = Recommendation["type"];
 declare const DEFAULT_RECOMMENDATION_TYPES: RecommendationType[];
@@ -1884,6 +2158,7 @@ declare class Order {
   private readonly externalNotify?;
   private readonly http;
   private readonly flush;
+  private readonly payments;
   private constructor();
   /**
    * Opens a cart session: reuses an existing OPEN order for the scope, or a
@@ -1939,6 +2214,7 @@ declare class Order {
    * latest applied first. Removing more units than applied clears them all.
    */
   removeRedeem(input: RemoveRedeemInput): void;
+  private rememberLogScope;
   setScope(scope: Partial<OrderScope>): void;
   /** Shallow-merges into order metadata; `null` values are kept as-is. */
   setMetadata(patch: Record<string, unknown>): void;
@@ -1950,6 +2226,165 @@ declare class Order {
   refundOrder(): Promise<void>;
   validateOrder(): Promise<void>;
   placeOrder(input?: PlaceOrderInput): Promise<void>;
+  /** Installed `@fire-spark/payments-*` adapters (provider + method). */
+  setPaymentAdapters(adapters: PaymentAdapter[]): void;
+  /** Template modal/sheet the adapters use to talk to the customer. */
+  setPaymentUI(ui: PaymentUI): void;
+  /** Persistent device storage (terminal keys, last batch close). */
+  setPaymentStorage(storage: PaymentStorage): void;
+  /** Environment, collect point and this device's `payment_settings`. */
+  setPaymentOptions(options: PaymentSessionOptions): void;
+  /** Merchant payments with an adapter installed and configured here. */
+  getPaymentOptions(payments: MerchantPayment[]): {
+    created_at: string;
+    updated_at: string;
+    deleted_at: string | null;
+    id: string;
+    payment_provider_id: string;
+    payment_method_id: string;
+    rules: {
+      minimum_order_value: number;
+      maximum_order_value: number;
+    }[];
+    conditions: ({
+      interpretation?: "both" | "client" | "server" | undefined;
+      product_id?: string | undefined;
+      tag?: string | undefined;
+      fulfillment_id: string;
+      store_id: string;
+      channel_id: string;
+      brand_id: string;
+      primitive: "string";
+      type: "Failure message" | "Order includes product with tag" | "Request path";
+      operator: "contains" | "ends with" | "equal to" | "not equal to" | "starts with";
+      caseInsensitive?: boolean | undefined;
+      value: string;
+      invalidMessage?: string | undefined;
+    } | {
+      interpretation?: "both" | "client" | "server" | undefined;
+      product_id?: string | undefined;
+      tag?: string | undefined;
+      fulfillment_id: string;
+      store_id: string;
+      channel_id: string;
+      brand_id: string;
+      primitive: "number";
+      type: "API error rate" | "Accumulated events" | "Cart product count" | "Customer age" | "HTTP status" | "Order includes product" | "Order includes product with tag";
+      operator: "equal to" | "greater than" | "greater than or equal to" | "less than" | "less than or equal to" | "not equal to";
+      value: number;
+      include_modifiers?: boolean | undefined;
+      window_minutes?: number | undefined;
+      invalidMessage?: string | undefined;
+    } | {
+      interpretation?: "both" | "client" | "server" | undefined;
+      product_id?: string | undefined;
+      tag?: string | undefined;
+      fulfillment_id: string;
+      store_id: string;
+      channel_id: string;
+      brand_id: string;
+      primitive: "currency";
+      type: "Order includes product with tag" | "Order total";
+      operator: "equal to" | "greater than" | "greater than or equal to" | "less than" | "less than or equal to" | "not equal to";
+      value: number;
+      invalidMessage?: string | undefined;
+    } | {
+      interpretation?: "both" | "client" | "server" | undefined;
+      product_id?: string | undefined;
+      tag?: string | undefined;
+      fulfillment_id: string;
+      store_id: string;
+      channel_id: string;
+      brand_id: string;
+      primitive: "boolean";
+      type: "Customer is anonymous" | "Is anonymous order" | "Order includes product with tag";
+      operator: "is" | "is not";
+      value: boolean;
+      invalidMessage?: string | undefined;
+    } | {
+      interpretation?: "both" | "client" | "server" | undefined;
+      primitive: "enum";
+      type: "Payment collect at" | "Payment method" | "Payment status";
+      operator: "is" | "is any of" | "is none of" | "is not";
+      value: string | string[];
+      invalidMessage?: string | undefined;
+    } | {
+      interpretation?: "both" | "client" | "server" | undefined;
+      primitive: "absolute date";
+      type: "Today";
+      operator: "is" | "is after" | "is before" | "is not";
+      value: Date;
+      invalidMessage?: string | undefined;
+    } | {
+      interpretation?: "both" | "client" | "server" | undefined;
+      primitive: "relative date";
+      type: "Birthday" | "Customer last session" | "Customer last visit" | "Registration";
+      operator: "occurred" | "occurred in the last" | "occurred more than";
+      value: string;
+      invalidMessage?: string | undefined;
+    } | {
+      interpretation?: "both" | "client" | "server" | undefined;
+      primitive: "recurring date";
+      type: "Current date";
+      operator: "falls within period";
+      startDate: Date;
+      endDate: Date;
+      allDay: boolean;
+      repeat: "CUSTOM" | "DAILY" | "FORTNIGHTLY" | "LAST_DAY_OF_MONTH" | "MONTHLY" | "NONE" | "WEEKDAYS" | "WEEKENDS" | "WEEKLY" | "WEEK_OF_MONTH";
+      value: string;
+      invalidMessage?: string | undefined;
+    } | {
+      interpretation?: "both" | "client" | "server" | undefined;
+      primitive: "custom";
+      type: "Brand" | "Brands" | "Channel" | "Channels" | "Fulfillment" | "Fulfillments" | "Payment" | "Payments" | "Store" | "Stores";
+      operator: "is" | "is all of" | "is any of" | "is none of" | "is not";
+      value: string;
+      label_ids?: string[] | undefined;
+      invalidMessage?: string | undefined;
+    })[][];
+    status: string;
+    provider: {
+      id: string;
+      provider_id: string;
+      name: string;
+      logo_url?: string | null | undefined;
+    };
+    method: {
+      id: string;
+      method: "BANK_TRANSFER" | "CARD" | "CASH" | "FINANCING" | "PIN_PAD" | "WALLET";
+      name: string;
+      version: string;
+      config?: {
+        [x: string]: unknown;
+        device_fields?: {
+          key: string;
+          label: string;
+          type: "boolean" | "number" | "password" | "select" | "text";
+          required: boolean;
+          secret: boolean;
+          options?: string[] | undefined;
+          visible_if?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        qr_ttl_ms?: number | undefined;
+        terminal_models?: string[] | undefined;
+        supports_installments?: boolean | undefined;
+      } | undefined;
+    };
+    config: Record<string, unknown>;
+    has_conditions: boolean;
+  }[];
+  /** Device fields still missing for `payment` on this device. */
+  getMissingPaymentFields(payment: MerchantPayment): import("@fire-spark/payments").DeviceField[];
+  /** Order total minus PAID (and confirm-after-inject) intents. */
+  getRemainingAmount(): number;
+  /** Places the order if needed and charges `payment` (all or part). */
+  pay(payment: MerchantPayment, options?: PayOptions): Promise<import("@fire-spark/payments").PaymentResult>;
+  /** Confirms intents that waited for the order injection. */
+  confirmPaymentsAfterInject(): Promise<import("@fire-spark/payments").PaymentResult[]>;
+  /** Cancels or refunds every charge of this order (or flags it manual). */
+  reversePayments(): Promise<ReversalOutcome[]>;
+  /** Terminal admin operation (init, test, closeBatch, status, extra). */
+  runPaymentTerminal(payment: MerchantPayment, key: string): Promise<import("@fire-spark/payments").TerminalResult>;
   /** Applies lines/redeem, replaying redemption steps and totals. */
   private commitLines;
   private scheduleAfterMutate;
@@ -2016,8 +2451,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" | "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 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" | "DAILY_ORDER_LIMIT_REACHED";
 type OrderLineIssue = {
   code: OrderLineIssueCode;
   field?: string;
@@ -2131,6 +2566,11 @@ declare const recomputeTotals: (lines: OrderLine[], currency?: string) => OrderT
 //#endregion
 //#region src/order/lines.d.ts
 declare const addLines: (lines: OrderLine[], incoming: OrderLine | OrderLine[]) => OrderLine[];
+declare const removeLine: (lines: OrderLine[], lineUid: string) => OrderLine[];
+/** Rescale one line's money to `quantity`; zero or less drops its subtree. */
+declare const setLineQuantity: (lines: OrderLine[], lineUid: string, quantity: number) => OrderLine[];
+/** Drop a root subtree, then add the replacement tree (may merge by fingerprint). */
+declare const replaceLine: (lines: OrderLine[], lineUid: string, next: OrderLine | OrderLine[]) => OrderLine[];
 //#endregion
 //#region src/services/availability.d.ts
 declare const getAvailability: (scope?: StorefrontMenuScope, options?: ServiceHttpOptions) => Promise<StorefrontAvailability>;
@@ -2272,7 +2712,7 @@ declare const getCustomer: (id: string, options?: ServiceHttpOptions) => Promise
     last4: string;
     exp_month: number;
     exp_year: number;
-    provider: "firespark" | "kushki" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "stripe" | "yape";
+    provider: "amipass" | "cashea" | "clisitef" | "credibanco" | "datafast" | "deuna" | "edenred" | "firespark" | "kushki" | "mach" | "medianet" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "pluxee" | "posnet" | "redeban" | "rutpay" | "sitef_venezuela" | "stripe" | "transbank" | "yape";
     provider_payment_method_id: string;
     preferred: boolean;
     metadata: Record<string, unknown> | null;
@@ -2280,7 +2720,7 @@ declare const getCustomer: (id: string, options?: ServiceHttpOptions) => Promise
     id: string;
     type: "WALLET";
     alias: string;
-    provider: "firespark" | "kushki" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "stripe" | "yape";
+    provider: "amipass" | "cashea" | "clisitef" | "credibanco" | "datafast" | "deuna" | "edenred" | "firespark" | "kushki" | "mach" | "medianet" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "pluxee" | "posnet" | "redeban" | "rutpay" | "sitef_venezuela" | "stripe" | "transbank" | "yape";
     provider_payment_method_id: string;
     account_hint?: string | undefined;
     preferred: boolean;
@@ -2291,7 +2731,7 @@ declare const getCustomer: (id: string, options?: ServiceHttpOptions) => Promise
     alias: string;
     bank_name?: string | undefined;
     last4: string;
-    provider?: "firespark" | "kushki" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "stripe" | "yape" | undefined;
+    provider?: "amipass" | "cashea" | "clisitef" | "credibanco" | "datafast" | "deuna" | "edenred" | "firespark" | "kushki" | "mach" | "medianet" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "pluxee" | "posnet" | "redeban" | "rutpay" | "sitef_venezuela" | "stripe" | "transbank" | "yape" | undefined;
     provider_payment_method_id?: string | undefined;
     preferred: boolean;
     metadata: Record<string, unknown> | null;
@@ -2376,7 +2816,7 @@ declare const createCustomer: (body: CustomerRegisterInput, options?: ServiceHtt
     last4: string;
     exp_month: number;
     exp_year: number;
-    provider: "firespark" | "kushki" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "stripe" | "yape";
+    provider: "amipass" | "cashea" | "clisitef" | "credibanco" | "datafast" | "deuna" | "edenred" | "firespark" | "kushki" | "mach" | "medianet" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "pluxee" | "posnet" | "redeban" | "rutpay" | "sitef_venezuela" | "stripe" | "transbank" | "yape";
     provider_payment_method_id: string;
     preferred: boolean;
     metadata: Record<string, unknown> | null;
@@ -2384,7 +2824,7 @@ declare const createCustomer: (body: CustomerRegisterInput, options?: ServiceHtt
     id: string;
     type: "WALLET";
     alias: string;
-    provider: "firespark" | "kushki" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "stripe" | "yape";
+    provider: "amipass" | "cashea" | "clisitef" | "credibanco" | "datafast" | "deuna" | "edenred" | "firespark" | "kushki" | "mach" | "medianet" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "pluxee" | "posnet" | "redeban" | "rutpay" | "sitef_venezuela" | "stripe" | "transbank" | "yape";
     provider_payment_method_id: string;
     account_hint?: string | undefined;
     preferred: boolean;
@@ -2395,7 +2835,7 @@ declare const createCustomer: (body: CustomerRegisterInput, options?: ServiceHtt
     alias: string;
     bank_name?: string | undefined;
     last4: string;
-    provider?: "firespark" | "kushki" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "stripe" | "yape" | undefined;
+    provider?: "amipass" | "cashea" | "clisitef" | "credibanco" | "datafast" | "deuna" | "edenred" | "firespark" | "kushki" | "mach" | "medianet" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "pluxee" | "posnet" | "redeban" | "rutpay" | "sitef_venezuela" | "stripe" | "transbank" | "yape" | undefined;
     provider_payment_method_id?: string | undefined;
     preferred: boolean;
     metadata: Record<string, unknown> | null;
@@ -2480,7 +2920,7 @@ declare const identifyAnonymousCustomer: (id: string, body: CustomerIdentifyInpu
     last4: string;
     exp_month: number;
     exp_year: number;
-    provider: "firespark" | "kushki" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "stripe" | "yape";
+    provider: "amipass" | "cashea" | "clisitef" | "credibanco" | "datafast" | "deuna" | "edenred" | "firespark" | "kushki" | "mach" | "medianet" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "pluxee" | "posnet" | "redeban" | "rutpay" | "sitef_venezuela" | "stripe" | "transbank" | "yape";
     provider_payment_method_id: string;
     preferred: boolean;
     metadata: Record<string, unknown> | null;
@@ -2488,7 +2928,7 @@ declare const identifyAnonymousCustomer: (id: string, body: CustomerIdentifyInpu
     id: string;
     type: "WALLET";
     alias: string;
-    provider: "firespark" | "kushki" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "stripe" | "yape";
+    provider: "amipass" | "cashea" | "clisitef" | "credibanco" | "datafast" | "deuna" | "edenred" | "firespark" | "kushki" | "mach" | "medianet" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "pluxee" | "posnet" | "redeban" | "rutpay" | "sitef_venezuela" | "stripe" | "transbank" | "yape";
     provider_payment_method_id: string;
     account_hint?: string | undefined;
     preferred: boolean;
@@ -2499,7 +2939,7 @@ declare const identifyAnonymousCustomer: (id: string, body: CustomerIdentifyInpu
     alias: string;
     bank_name?: string | undefined;
     last4: string;
-    provider?: "firespark" | "kushki" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "stripe" | "yape" | undefined;
+    provider?: "amipass" | "cashea" | "clisitef" | "credibanco" | "datafast" | "deuna" | "edenred" | "firespark" | "kushki" | "mach" | "medianet" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "pluxee" | "posnet" | "redeban" | "rutpay" | "sitef_venezuela" | "stripe" | "transbank" | "yape" | undefined;
     provider_payment_method_id?: string | undefined;
     preferred: boolean;
     metadata: Record<string, unknown> | null;
@@ -2584,7 +3024,7 @@ declare const updateCustomer: (id: string, body: CustomerUpdateInput, options?:
     last4: string;
     exp_month: number;
     exp_year: number;
-    provider: "firespark" | "kushki" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "stripe" | "yape";
+    provider: "amipass" | "cashea" | "clisitef" | "credibanco" | "datafast" | "deuna" | "edenred" | "firespark" | "kushki" | "mach" | "medianet" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "pluxee" | "posnet" | "redeban" | "rutpay" | "sitef_venezuela" | "stripe" | "transbank" | "yape";
     provider_payment_method_id: string;
     preferred: boolean;
     metadata: Record<string, unknown> | null;
@@ -2592,7 +3032,7 @@ declare const updateCustomer: (id: string, body: CustomerUpdateInput, options?:
     id: string;
     type: "WALLET";
     alias: string;
-    provider: "firespark" | "kushki" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "stripe" | "yape";
+    provider: "amipass" | "cashea" | "clisitef" | "credibanco" | "datafast" | "deuna" | "edenred" | "firespark" | "kushki" | "mach" | "medianet" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "pluxee" | "posnet" | "redeban" | "rutpay" | "sitef_venezuela" | "stripe" | "transbank" | "yape";
     provider_payment_method_id: string;
     account_hint?: string | undefined;
     preferred: boolean;
@@ -2603,7 +3043,7 @@ declare const updateCustomer: (id: string, body: CustomerUpdateInput, options?:
     alias: string;
     bank_name?: string | undefined;
     last4: string;
-    provider?: "firespark" | "kushki" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "stripe" | "yape" | undefined;
+    provider?: "amipass" | "cashea" | "clisitef" | "credibanco" | "datafast" | "deuna" | "edenred" | "firespark" | "kushki" | "mach" | "medianet" | "mercadopago" | "niubiz" | "paymentz" | "paypal" | "payphone" | "place_to_pay" | "pluxee" | "posnet" | "redeban" | "rutpay" | "sitef_venezuela" | "stripe" | "transbank" | "yape" | undefined;
     provider_payment_method_id?: string | undefined;
     preferred: boolean;
     metadata: Record<string, unknown> | null;
@@ -2734,6 +3174,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;
@@ -2752,6 +3193,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;
@@ -2839,6 +3285,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>;
@@ -2929,6 +3391,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;
@@ -2947,6 +3410,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;
@@ -3034,6 +3502,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>;
@@ -3185,7 +3669,7 @@ declare const listPayments: (input: StorefrontPaymentsListInput, options?: Servi
   } | {
     interpretation?: "both" | "client" | "server" | undefined;
     primitive: "custom";
-    type: "Brand" | "Brands" | "Channel" | "Channels" | "Fulfillment" | "Fulfillments" | "Store" | "Stores";
+    type: "Brand" | "Brands" | "Channel" | "Channels" | "Fulfillment" | "Fulfillments" | "Payment" | "Payments" | "Store" | "Stores";
     operator: "is" | "is all of" | "is any of" | "is none of" | "is not";
     value: string;
     label_ids?: string[] | undefined;
@@ -3200,13 +3684,109 @@ declare const listPayments: (input: StorefrontPaymentsListInput, options?: Servi
   };
   method: {
     id: string;
-    method: "BANK_TRANSFER" | "CARD" | "CASH" | "PIN_PAD" | "WALLET";
+    method: "BANK_TRANSFER" | "CARD" | "CASH" | "FINANCING" | "PIN_PAD" | "WALLET";
     name: string;
     version: string;
+    config?: {
+      [x: string]: unknown;
+      device_fields?: {
+        key: string;
+        label: string;
+        type: "boolean" | "number" | "password" | "select" | "text";
+        required: boolean;
+        secret: boolean;
+        options?: string[] | undefined;
+        visible_if?: Record<string, unknown> | undefined;
+      }[] | undefined;
+      qr_ttl_ms?: number | undefined;
+      terminal_models?: string[] | undefined;
+      supports_installments?: boolean | undefined;
+    } | undefined;
   };
   config: Record<string, unknown>;
   has_conditions: boolean;
 }[]>;
+type PaymentOperationBody = {
+  order_id: string | null;
+  attempt_reference: string | null;
+  input: Record<string, unknown>;
+};
+/** Server half of an adapter (`POST /payments/:id/operations/:operation`). */
+declare const callPaymentOperation: <T>(paymentId: string, operation: string, body: PaymentOperationBody, options?: ServiceHttpOptions) => Promise<T>;
+type TerminalFailureBody = {
+  operation: string;
+  device_id?: string | null;
+  error: {
+    code: string;
+    message: string;
+  } & Record<string, unknown>;
+};
+/** Reports a failed terminal operation (`payment.terminal_failed`). */
+declare const reportTerminalFailure: (paymentId: string, body: TerminalFailureBody, options?: ServiceHttpOptions) => Promise<{
+  reported: boolean;
+}>;
+//#endregion
+//#region src/i18n/pos.d.ts
+type PosMessageLocale = "en" | "en-US" | "es" | "pt-BR";
+//#endregion
+//#region src/services/pos.d.ts
+declare const isPosDeviceNotLinked: (error: unknown) => boolean;
+declare const isPosUnauthorized: (error: unknown) => boolean;
+declare const isPosPinLocked: (error: unknown) => boolean;
+declare const localizePosError: (error: unknown, locale?: PosMessageLocale) => string | undefined;
+declare const pairPosDevice: (input: {
+  pairing_code: string;
+  device_secret: string;
+}, options?: ServiceHttpOptions) => Promise<unknown>;
+declare const relinkPosDevice: (input: {
+  relink_code: string;
+  device_secret: string;
+}, options?: ServiceHttpOptions) => Promise<unknown>;
+declare const postPosHeartbeat: (input: PosHeartbeatInput, options?: ServiceHttpOptions) => Promise<PosHeartbeatResult>;
+declare const postPosHealthSamples: (input: PosHealthBatchInput, options?: ServiceHttpOptions) => Promise<PosHealthBatchResult>;
+declare const postPosDeviceLogs: (input: unknown, options?: ServiceHttpOptions) => Promise<{
+  ok: boolean;
+  accepted: number;
+}>;
+declare const listPosOperators: (input: {
+  device_uid: string;
+  device_secret: string;
+}, options?: ServiceHttpOptions) => Promise<unknown>;
+declare const verifyPosOperator: (input: {
+  device_uid: string;
+  device_secret: string;
+  operator_id: string;
+  pin: string;
+}, options?: ServiceHttpOptions) => Promise<unknown>;
+declare const listPosAuthorizers: (input: {
+  device_uid: string;
+  device_secret: string;
+  action: string;
+}, options?: ServiceHttpOptions) => Promise<unknown>;
+declare const verifyPosAuthorizer: (input: unknown, options?: ServiceHttpOptions) => Promise<unknown>;
+declare const openPosSession: (input: unknown, options?: ServiceHttpOptions) => Promise<unknown>;
+declare const countPosSession: (input: unknown, options?: ServiceHttpOptions) => Promise<unknown>;
+declare const withdrawPosSession: (input: unknown, options?: ServiceHttpOptions) => Promise<unknown>;
+declare const drawerPosSession: (input: unknown, options?: ServiceHttpOptions) => Promise<unknown>;
+declare const closePosSession: (input: unknown, options?: ServiceHttpOptions) => Promise<unknown>;
+declare const shiftEndPosSession: (input: unknown, options?: ServiceHttpOptions) => Promise<unknown>;
+/** The device's open caja and its events, or `{ session: null }`. */
+declare const getPosCurrentSession: (input: {
+  device_uid: string;
+  device_secret: string;
+}, options?: ServiceHttpOptions) => Promise<unknown>;
+declare const listPosKioskOrders: (input: {
+  device_uid: string;
+  device_secret: string;
+}, options?: ServiceHttpOptions) => Promise<PosKioskOrder[]>;
+/** Safe to retry with the same `client_id`; the server dedupes the settle. */
+declare const settlePosKioskOrder: (input: PosKioskSettleInput, options?: ServiceHttpOptions) => Promise<PosKioskSettleResult>;
+declare const getPosCatalog: (input: {
+  device_uid: string;
+  device_secret: string;
+}, options?: ServiceHttpOptions) => Promise<PosCatalog>;
+/** Safe to retry with the same `client_id`; the server dedupes the sale. */
+declare const createPosOrder: (input: PosOrderInput, options?: ServiceHttpOptions) => Promise<PosOrderResult>;
 //#endregion
 //#region src/services/preferences.d.ts
 declare const getPreferences: (scope?: StorefrontMenuScope, options?: ServiceHttpOptions) => Promise<{
@@ -3262,6 +3842,18 @@ declare const getPreferences: (scope?: StorefrontMenuScope, options?: ServiceHtt
     ios_store_url: string;
     android_store_url: string;
   };
+  country?: string | undefined;
+  locale?: string | undefined;
+  currency?: {
+    code: string;
+    symbol: string;
+    name: string;
+  } | undefined;
+  denominations?: {
+    kind: "BILL" | "COIN";
+    value: number;
+    sort_order: number;
+  }[] | undefined;
 }>;
 //#endregion
 //#region src/services/stores.d.ts
@@ -3305,6 +3897,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;
@@ -3399,6 +3993,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;
@@ -3454,7 +4050,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;
@@ -3493,6 +4089,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;
@@ -3585,11 +4183,14 @@ declare const services: {
     reorder: typeof reorderOrder;
     validate: typeof validateOrder;
     place: typeof placeOrder;
+    recordPayment: typeof recordOrderPayment;
     getFulfillment: typeof getOrderFulfillment;
     listFulfillments: typeof listOrderFulfillments;
   };
   payments: {
     list: typeof listPayments;
+    operation: typeof callPaymentOperation;
+    terminalFailure: typeof reportTerminalFailure;
   };
   stores: {
     list: typeof listStores;
@@ -3609,6 +4210,32 @@ declare const services: {
     isDeviceNotLinked: typeof isDeviceNotLinked;
     isKioskUnauthorized: typeof isKioskUnauthorized;
   };
+  pos: {
+    pair: typeof pairPosDevice;
+    relink: typeof relinkPosDevice;
+    heartbeat: typeof postPosHeartbeat;
+    postHealthSamples: typeof postPosHealthSamples;
+    postLogs: typeof postPosDeviceLogs;
+    listOperators: typeof listPosOperators;
+    verifyOperator: typeof verifyPosOperator;
+    listAuthorizers: typeof listPosAuthorizers;
+    verifyAuthorizer: typeof verifyPosAuthorizer;
+    openSession: typeof openPosSession;
+    countSession: typeof countPosSession;
+    withdraw: typeof withdrawPosSession;
+    drawer: typeof drawerPosSession;
+    closeSession: typeof closePosSession;
+    shiftEnd: typeof shiftEndPosSession;
+    currentSession: typeof getPosCurrentSession;
+    listKioskOrders: typeof listPosKioskOrders;
+    settleKioskOrder: typeof settlePosKioskOrder;
+    getCatalog: typeof getPosCatalog;
+    createOrder: typeof createPosOrder;
+    isDeviceNotLinked: typeof isPosDeviceNotLinked;
+    isUnauthorized: typeof isPosUnauthorized;
+    isPinLocked: typeof isPosPinLocked;
+    localizeError: typeof localizePosError;
+  };
 };
 //#endregion
 //#region src/schedule/schedule.d.ts
@@ -3623,6 +4250,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/logs/context.d.ts
+declare const getLogContext: () => SdkLogContext;
+//#endregion
+//#region src/logs/log.d.ts
+/** Sends queued logs now; resolves once every batch has been attempted. */
+declare const flushLogs: () => Promise<void>;
+/**
+ * Reports a log to the merchant dashboard with the SDK's current context
+ * (channel, fulfillment, store, brand, device). Never throws; resolves to
+ * `false` when the log could not be delivered.
+ */
+declare const log: (level: SdkLogLevel, message: string, options?: SdkLogOptions) => Promise<boolean>;
+/** `log("error", …)` with message, name, stack and cause read from `error`. */
+declare const logError: (error: unknown, options?: SdkLogOptions) => Promise<boolean>;
+//#endregion
+//#region src/logs/serializeError.d.ts
+type SerializedError = {
+  message: string;
+  error: SdkLogErrorInfo;
+};
+/** Accepts anything a `catch` can receive. */
+declare const serializeError: (value: unknown) => SerializedError;
+//#endregion
 //#region src/shared/genId.d.ts
 type IdBuilder = {
   /**
@@ -3766,4 +4416,77 @@ declare const paymentMatchesClientConditions: (conditions: OrConditions | null |
   now?: string;
 }) => boolean;
 //#endregion
-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 };
+//#region src/card/card.types.d.ts
+type CardBrand = "visa" | "mastercard" | "amex" | "diners" | "discover" | "jcb" | "unionpay" | "unknown";
+/** Brands accepted by the customer `payments[].brand` contract. */
+type PaymentCardBrand = "visa" | "mastercard" | "amex" | "diners" | "discover" | "other";
+interface CardBrandSpec {
+  brand: CardBrand;
+  label: string;
+  pattern: RegExp;
+  /** Valid PAN lengths, ascending. */
+  lengths: number[];
+  /** Digit indexes where a space is inserted (e.g. `[4, 10]` for 4-6-5). */
+  gaps: number[];
+  /** Valid CVC lengths, ascending. */
+  cvcLengths: number[];
+}
+type CardNumberError = "required" | "incomplete" | "invalid";
+type CardExpiryError = "required" | "incomplete" | "invalid_month" | "expired" | "too_far";
+type CardCvcError = "required" | "incomplete";
+type CardholderNameError = "required" | "too_short" | "too_long" | "invalid_chars";
+interface CardExpiry {
+  month: number;
+  /** Four-digit year. */
+  year: number;
+}
+interface CardPreviewSlot {
+  /** Digit, `•` for masked digits, or empty when not typed yet. */
+  char: string;
+  filled: boolean;
+}
+//#endregion
+//#region src/card/card.d.ts
+/** Detection order matters: narrower prefixes first. */
+declare const CARD_BRANDS: readonly CardBrandSpec[];
+declare const cardDigits: (value: string) => string;
+/** Mod-10 checksum. Expects digits only (non-digits are ignored). */
+declare const luhnCheck: (value: string) => boolean;
+declare const cardBrandSpec: (brand: CardBrand) => CardBrandSpec;
+/** Brand from the typed prefix; `unknown` until the prefix is unambiguous. */
+declare const detectCardBrand: (value: string) => CardBrand;
+declare const toPaymentCardBrand: (brand: CardBrand) => PaymentCardBrand;
+declare const cardNumberMaxLength: (brand: CardBrand) => number;
+/** Space positions for a PAN of `length` digits (Diners 14 → 4-6-4). */
+declare const cardNumberGaps: (brand: CardBrand, length: number) => number[];
+/** Digits only, capped to the brand max length, grouped with spaces. */
+declare const formatCardNumber: (value: string) => string;
+/** Caret index in `formatted` right after its `digitCount`-th digit. */
+declare const caretAfterDigits: (formatted: string, digitCount: number) => number;
+declare const validateCardNumber: (value: string) => CardNumberError | null;
+/** Ready to move focus on: a valid length for the brand that passes Luhn. */
+declare const isCardNumberComplete: (value: string) => boolean;
+/** Full-length PAN that fails Luhn — safe to flag while the user types. */
+declare const isCardNumberDefinitelyInvalid: (value: string) => boolean;
+/**
+ * `MM/YY` as the user types or pastes: `4` → `04`, `13` → `01/3`,
+ * `12/2030` → `12/30`. The slash only appears once a year digit exists so
+ * backspace never gets stuck.
+ */
+declare const formatExpiry: (value: string) => string;
+declare const parseExpiry: (value: string) => CardExpiry | null;
+declare const isExpiryComplete: (value: string) => boolean;
+declare const validateExpiry: (value: string, now?: Date) => CardExpiryError | null;
+declare const cvcMaxLength: (brand: CardBrand) => number;
+declare const formatCvc: (value: string, brand: CardBrand) => string;
+declare const validateCvc: (value: string, brand: CardBrand) => CardCvcError | null;
+declare const isCvcComplete: (value: string, brand: CardBrand) => boolean;
+declare const normalizeCardholderName: (value: string) => string;
+declare const validateCardholderName: (value: string) => CardholderNameError | null;
+/**
+ * Digit slots for a card preview, grouped like the formatted number. Middle
+ * digits are masked as `•`; first and last groups stay readable.
+ */
+declare const cardPreviewGroups: (value: string) => CardPreviewSlot[][];
+//#endregion
+export { type ApplyRedeemInput, type AuthConfigureOptions, CARD_BRANDS, type CardBrand, type CardBrandSpec, type CardCvcError, type CardExpiry, type CardExpiryError, type CardNumberError, type CardPreviewSlot, type CardholderNameError, 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 PayOptions, type PaymentCardBrand, type PaymentRunOptions, type PaymentSessionOptions, type PricingModifier, type Product, type ProductCtx, type QuantitiesByPath, type RecommendationType, RecurringDateCron, type RemoveRedeemInput, type ReorderOrderOptions, type ResetOptions, type ReversalOutcome, RulesEngine, type ScheduleWindow, type SelectionStatus, type SelectionsByPath, type SerializedError, 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, cardBrandSpec, cardDigits, cardNumberGaps, cardNumberMaxLength, cardPreviewGroups, caretAfterDigits, collectOrderLineDiffs, computeStartingPrice, countCartProducts, coveredAmount, createSession, currentNodes, cvcMaxLength, defaultConditionError, detectCardBrand, flattenMenuCategories, flushLogs, formatCardNumber, formatCvc, formatExpiry, fromOrderLines, genId, genOrderId, getLogContext, getScheduleWindow, indexMenu, isCardNumberComplete, isCardNumberDefinitelyInvalid, isCheckoutFieldFilled, isCvcComplete, isDeviceNotLinked, isExpiryComplete, isKioskUnauthorized, isMilestoneStepDone, isOnSchedule, isOrderValidationError, isPosDeviceNotLinked, isPosUnauthorized, isStorefrontNotFound, isVariantBase, listMenusStream, localizePosError, log, logError, luhnCheck, matchAbsoluteDateOperator, matchBooleanOperator, matchCurrencyOperator, matchEnumOperator, matchNumberOperator, matchRecurringDateOperator, matchRelativeDateOperator, matchStringOperator, milestoneSteps, milestoneTrack, nestMenuCategories, normalizeCardholderName, parseExpiry, paymentMatchesClientConditions, recomputeRedemptions, recomputeTotals, remainingAmount, removeLine, replaceLine, resolveCheckout, reversePayment, runPaymentAttempt, serializeError, services, setLineQuantity, storefrontJson, toOrderLines, toPaymentCardBrand, validateCardNumber, validateCardholderName, validateCvc, validateExpiry, validateOrderAgainstMenu, visitedStates };