@fire-spark/core 0.7.2 → 0.8.1

package/dist/index.d.ts

@@ -1,6 +1,10 @@
 import { Money, PaymentAdapter, PaymentCollectAt, PaymentContext, PaymentResult, PaymentStorage, PaymentUI, RedeemLike, RedeemSource, isRealPaymentMethod, orderRedeems } from "@fire-spark/payments";
-import { AndConditions, CheckoutMode, CheckoutResolved, CmsBlock, Condition, Customer, CustomerIdentifyInput, CustomerRegisterInput, CustomerUpdateInput, Fulfillment, 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, OrderFulfillment, OrderInsertInput, OrderLine, OrderListInput, OrderRecordPaymentInput, OrderRedeem, OrderRedemptionStep, OrderReorderInput, OrderTotals, OrderUpdateInput, OrderValidateInput, OrderValidateOutput, PaymentCollectAt as PaymentCollectAt$1, PaymentIntentPutInput, PaymentMethod, PaymentProvider, PaymentTender, PaymentTenderInput, PlaceOrderResult, 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, Store, StoreGetInput, StoreListInput, StoreNearbyInput, StorefrontAvailability, StorefrontMenu, StorefrontMenuScope, StorefrontMenuStreamOptions, StorefrontPaymentsListInput, StorefrontPreferences, TenderRefundInput, TenderReplaceInput, TenderVoidInput, Variant, VariantGroup } from "@fire-spark/types";
+import { AndConditions, CheckoutMode, CheckoutResolved, CmsBlock, Condition, Customer, CustomerIdentifyInput, CustomerRegisterInput, CustomerUpdateInput, Fulfillment, 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, OrderDeviceListInput, OrderDeviceListResult, OrderFulfillment, OrderInsertInput, OrderLine, OrderListInput, OrderRecordPaymentInput, OrderRedeem, OrderRedemptionStep, OrderReorderInput, OrderTotals, OrderUpdateInput, OrderValidateInput, OrderValidateOutput, PaymentCollectAt as PaymentCollectAt$1, PaymentIntentPutInput, PaymentMethod, PaymentProvider, PaymentTender, PaymentTenderInput, PlaceOrderResult, PosCatalog, PosFloorInput, PosFloorOccupancy, PosFloorPlan, PosFloorRealtimeToken, PosHealthBatchInput, PosHealthBatchResult, PosHeartbeatInput, PosHeartbeatResult, PosKioskOrder, PosKioskSettleInput, PosKioskSettleResult, PosOrderInput, PosOrderResult, PosTableAttachOrderInput, PosTableCloseInput, PosTableJoinInput, PosTableSeatInput, PosTableSeatReservationInput, PosTableSplitInput, PricingModifier, Product, Product as Product$1, Recommendation, RecurringDateCronResult, RecurringDateCronValues, RulesEngineOrderLine, RulesEngineParams, RulesEngineRuntime, Schedule, SdkLogContext, SdkLogErrorInfo, SdkLogLevel, SdkLogOptions, Store, StoreGetInput, StoreListInput, StoreNearbyInput, StorefrontAvailability, StorefrontMenu, StorefrontMenuScope, StorefrontMenuStreamOptions, StorefrontPaymentsListInput, StorefrontPreferences, TenderRefundInput, TenderReplaceInput, TenderVoidInput, Variant, VariantGroup } from "@fire-spark/types";
 import { Big } from "big.js";
+//#region src/productCustomization/catalog.utils.d.ts
+/** Image for a product inside one modifier group, else the product image. */
+declare const resolveModifierImageUrl: (product: Product$1, groupId: string) => string | null;
+//#endregion
 //#region src/productCustomization/types.d.ts
 type SelectionStatus = "IDLE" | "INCOMPLETE" | "VALID" | "INVALID";
 type StartingPriceCache = Map<string, Big>;
@@ -232,6 +236,11 @@ declare const storefrontJson: <T>(path: string, init?: RequestInit, options?: Se
 declare const listOrders: (input?: OrderListInput, options?: ServiceHttpOptions) => Promise<Order$1[]>;
 declare const createOrder: (body: OrderInsertInput, options?: ServiceHttpOptions) => Promise<Order$1>;
 declare const getOrder: (id: string, options?: ServiceHttpOptions) => Promise<Order$1>;
+type PlaceOrderDevice = {
+  kind: "KIOSK" | "POS";
+  uid: string;
+  secret: string;
+};
 type PlaceOrderInput = {
   /** DRAFT intent built with `PUT /orders/:id/payment-intent`. */
   intent_id?: string;
@@ -245,6 +254,8 @@ type PlaceOrderInput = {
     provider?: PaymentProvider;
     collect_at?: PaymentCollectAt$1;
   };
+  /** Kiosk / POS credential; the server stamps `device_id` on place. */
+  device?: PlaceOrderDevice;
 };
 declare const placeOrder: (id: string, body?: PlaceOrderInput, options?: ServiceHttpOptions) => Promise<PlaceOrderResult>;
 /** Records one tender attempt result (idempotent by `attempt_reference`). */
@@ -387,6 +398,11 @@ type OrderScope = {
   fulfillment_id: string;
   brand_id?: string | null;
 };
+type OrderDeviceCredential = {
+  kind: "KIOSK" | "POS";
+  uid: string;
+  secret: string;
+};
 type CreateOrderOptions = {
   scope?: OrderScope;
   customer?: OrderCustomerSource;
@@ -395,6 +411,8 @@ type CreateOrderOptions = {
   /** When false, skips the OPEN-order lookup and starts a local draft. */
   reuseOpen?: boolean;
   orderId?: string;
+  /** Stamped on `placeOrder`; not sent with the OPEN cart. */
+  device?: OrderDeviceCredential;
   debounceMs?: number;
   baseUrl?: string;
   accessToken?: string;
@@ -464,6 +482,7 @@ declare class Order {
    * total was low recovers its amount once the total grows back.
    */
   private requestedRedeem;
+  private readonly device?;
   private constructor();
   /**
    * Opens a cart session: reuses an existing OPEN order for the scope, or a
@@ -986,6 +1005,8 @@ declare const verifyKioskAdminCode: (input: {
 }>;
 declare const isKioskAdminCodeInvalid: (error: unknown) => boolean;
 declare const isKioskAdminCodeLocked: (error: unknown) => boolean;
+/** Placed orders of this kiosk, newest first. Auth is the device secret. */
+declare const listKioskOrders: (input: OrderDeviceListInput, options?: ServiceHttpOptions) => Promise<OrderDeviceListResult>;
 declare const fetchKioskRealtimeToken: (input: {
   device_uid: string;
   device_secret: string;
@@ -1074,7 +1095,7 @@ declare const withdrawPosSession: (input: unknown, options?: ServiceHttpOptions)
 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 }`. */
+/** The device's open cash register and its events, or `{ session: null }`. */
 declare const getPosCurrentSession: (input: {
   device_uid: string;
   device_secret: string;
@@ -1083,6 +1104,8 @@ declare const listPosKioskOrders: (input: {
   device_uid: string;
   device_secret: string;
 }, options?: ServiceHttpOptions) => Promise<PosKioskOrder[]>;
+/** Placed orders of this POS, newest first. Auth is the device secret. */
+declare const listPosOrders: (input: OrderDeviceListInput, options?: ServiceHttpOptions) => Promise<OrderDeviceListResult>;
 /** 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: {
@@ -1091,6 +1114,20 @@ declare const getPosCatalog: (input: {
 }, 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>;
+/** Floors, tables (with uids) and the store's open parties. */
+declare const getPosFloor: (input: PosFloorInput, options?: ServiceHttpOptions) => Promise<PosFloorPlan>;
+/** Safe to retry with the same `client_id`; the server dedupes the seat. */
+declare const seatPosTable: (input: PosTableSeatInput, options?: ServiceHttpOptions) => Promise<PosFloorOccupancy>;
+/** Seats a booked party on its tables; fails once its wait has passed. */
+declare const seatPosReservation: (input: PosTableSeatReservationInput, options?: ServiceHttpOptions) => Promise<PosFloorOccupancy>;
+/** Adds tables to a party; tables held by another party merge it in. */
+declare const joinPosTables: (input: PosTableJoinInput, options?: ServiceHttpOptions) => Promise<PosFloorOccupancy>;
+/** Moves tables out of a party, optionally seating them as a new party. */
+declare const splitPosTables: (input: PosTableSplitInput, options?: ServiceHttpOptions) => Promise<PosFloorOccupancy>;
+declare const closePosTable: (input: PosTableCloseInput, options?: ServiceHttpOptions) => Promise<PosFloorOccupancy>;
+declare const attachPosTableOrder: (input: PosTableAttachOrderInput, options?: ServiceHttpOptions) => Promise<PosFloorOccupancy>;
+/** Token for the store's private `floor.changed` channel. */
+declare const fetchPosFloorRealtimeToken: (input: PosFloorInput, options?: ServiceHttpOptions) => Promise<PosFloorRealtimeToken>;
 //#endregion
 //#region src/services/preferences.d.ts
 declare const getPreferences: (scope?: StorefrontMenuScope, options?: ServiceHttpOptions) => Promise<StorefrontPreferences>;
@@ -1163,6 +1200,7 @@ declare const services: {
     postHealthSamples: typeof postKioskHealthSamples;
     patchOverrides: typeof patchKioskOverrides;
     realtimeToken: typeof fetchKioskRealtimeToken;
+    listOrders: typeof listKioskOrders;
     unlink: typeof unlinkKioskSelf;
     verifyAdminCode: typeof verifyKioskAdminCode;
     isAdminCodeInvalid: typeof isKioskAdminCodeInvalid;
@@ -1188,9 +1226,18 @@ declare const services: {
     shiftEnd: typeof shiftEndPosSession;
     currentSession: typeof getPosCurrentSession;
     listKioskOrders: typeof listPosKioskOrders;
+    listOrders: typeof listPosOrders;
     settleKioskOrder: typeof settlePosKioskOrder;
     getCatalog: typeof getPosCatalog;
     createOrder: typeof createPosOrder;
+    getFloor: typeof getPosFloor;
+    seatTable: typeof seatPosTable;
+    seatReservation: typeof seatPosReservation;
+    joinTables: typeof joinPosTables;
+    splitTables: typeof splitPosTables;
+    closeTable: typeof closePosTable;
+    attachTableOrder: typeof attachPosTableOrder;
+    floorRealtimeToken: typeof fetchPosFloorRealtimeToken;
     isDeviceNotLinked: typeof isPosDeviceNotLinked;
     isUnauthorized: typeof isPosUnauthorized;
     isPinLocked: typeof isPosPinLocked;
@@ -1465,4 +1512,4 @@ declare const validateCardholderName: (value: string) => CardholderNameError | n
  */
 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 FailedCharge, type FlatMenuCategory, type GroupDisplayType, type IdBuilder, type ListMenusStreamOptions, type ListPaymentsOptions, 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, OrderPaymentRequiredError, type OrderScope, OrderSyncPendingError, OrderSyncRejectedError, OrderValidationError, type OrderValidationResult, type PayIntentOptions, type PayIntentResult, type PayOptions, type PaymentCardBrand, type PaymentProgressEvent, type PaymentProgressListener, type PaymentRunOptions, type PaymentSessionOptions, type PricingModifier, type Product, type ProductCtx, type QuantitiesByPath, type RecommendationType, RecurringDateCron, type RedeemPaymentRow, type RemoveRedeemInput, type ReorderOrderOptions, type ResetOptions, type ReversalOutcome, type ReverseAllOptions, RulesEngine, type ScheduleWindow, type SelectionStatus, type SelectionsByPath, type SerializedError, type ServiceHttpOptions, type SimpleTenderPayment, type Snapshot, type StorefrontAccessToken, type StorefrontErrorDetails, StorefrontHttpError, type TrackWorkflow, type ValidateOptions, type ValidateOrderAgainstMenuInput, type Variant, type VariantGroup, type VariantGroupCtx, type VariantOptionCtx, type VariantSelection, type VerifyWebhookSignatureInput, type VisitedState, addLines, auth, buildCustomerSnapshot, capRedeems, cappedRedeems, cardBrandSpec, cardDigits, cardNumberGaps, cardNumberMaxLength, cardPreviewGroups, caretAfterDigits, collectOrderLineDiffs, computeStartingPrice, countCartProducts, coveredAmount, createSession, currentNodes, cvcMaxLength, defaultConditionError, detectCardBrand, fitRedeems, flattenMenuCategories, flushLogs, formatCardNumber, formatCvc, formatExpiry, fromOrderLines, genId, genOrderId, getLogContext, getScheduleWindow, indexMenu, isCardNumberComplete, isCardNumberDefinitelyInvalid, isCheckoutFieldFilled, isCvcComplete, isDeviceCharged, isDeviceNotLinked, isExpiryComplete, isKioskUnauthorized, isMilestoneStepDone, isOnSchedule, isOrderPaymentRequiredError, isOrderValidationError, isPosDeviceNotLinked, isPosUnauthorized, isRealPaymentMethod, isStorefrontNotFound, isVariantBase, linePayableTotal, listMenusStream, localizePosError, log, logError, luhnCheck, matchAbsoluteDateOperator, matchBooleanOperator, matchCurrencyOperator, matchEnumOperator, matchNumberOperator, matchRecurringDateOperator, matchRelativeDateOperator, matchStringOperator, milestoneSteps, milestoneTrack, nestMenuCategories, normalizeCardholderName, orderPayableTotal, orderRedeemedTotal, orderRedeems, parseExpiry, paymentMatchesClientConditions, rebuildRootGroups, recomputeTotals, redeemedTotal, redemptionCap, redemptionSteps, remainingAmount, removeLine, replaceLine, resolveCheckout, reversePayment, runPaymentAttempt, selectablePayments, serializeError, services, setLineQuantity, storefrontJson, toOrderLines, toPaymentCardBrand, validateCardNumber, validateCardholderName, validateCvc, validateExpiry, validateOrderAgainstMenu, verifyWebhookSignature, visitedStates };
+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 FailedCharge, type FlatMenuCategory, type GroupDisplayType, type IdBuilder, type ListMenusStreamOptions, type ListPaymentsOptions, type Menu, type MenuCategoryNode, type MenuLookup, type MilestoneSteps, type MilestoneTrackItem, type ModifierControlType, type ModifierCtx, type ModifierGroupCtx, type NestedMenuCategory, Order, type OrderCustomerSource, type OrderDeviceCredential, type OrderDraft, type OrderIssue, type OrderIssueCode, type OrderLineDiff, type OrderLineIssue, type OrderLineIssueCode, OrderPaymentRequiredError, type OrderScope, OrderSyncPendingError, OrderSyncRejectedError, OrderValidationError, type OrderValidationResult, type PayIntentOptions, type PayIntentResult, type PayOptions, type PaymentCardBrand, type PaymentProgressEvent, type PaymentProgressListener, type PaymentRunOptions, type PaymentSessionOptions, type PricingModifier, type Product, type ProductCtx, type QuantitiesByPath, type RecommendationType, RecurringDateCron, type RedeemPaymentRow, type RemoveRedeemInput, type ReorderOrderOptions, type ResetOptions, type ReversalOutcome, type ReverseAllOptions, RulesEngine, type ScheduleWindow, type SelectionStatus, type SelectionsByPath, type SerializedError, type ServiceHttpOptions, type SimpleTenderPayment, type Snapshot, type StorefrontAccessToken, type StorefrontErrorDetails, StorefrontHttpError, type TrackWorkflow, type ValidateOptions, type ValidateOrderAgainstMenuInput, type Variant, type VariantGroup, type VariantGroupCtx, type VariantOptionCtx, type VariantSelection, type VerifyWebhookSignatureInput, type VisitedState, addLines, auth, buildCustomerSnapshot, capRedeems, cappedRedeems, cardBrandSpec, cardDigits, cardNumberGaps, cardNumberMaxLength, cardPreviewGroups, caretAfterDigits, collectOrderLineDiffs, computeStartingPrice, countCartProducts, coveredAmount, createSession, currentNodes, cvcMaxLength, defaultConditionError, detectCardBrand, fitRedeems, flattenMenuCategories, flushLogs, formatCardNumber, formatCvc, formatExpiry, fromOrderLines, genId, genOrderId, getLogContext, getScheduleWindow, indexMenu, isCardNumberComplete, isCardNumberDefinitelyInvalid, isCheckoutFieldFilled, isCvcComplete, isDeviceCharged, isDeviceNotLinked, isExpiryComplete, isKioskUnauthorized, isMilestoneStepDone, isOnSchedule, isOrderPaymentRequiredError, isOrderValidationError, isPosDeviceNotLinked, isPosUnauthorized, isRealPaymentMethod, isStorefrontNotFound, isVariantBase, linePayableTotal, listMenusStream, localizePosError, log, logError, luhnCheck, matchAbsoluteDateOperator, matchBooleanOperator, matchCurrencyOperator, matchEnumOperator, matchNumberOperator, matchRecurringDateOperator, matchRelativeDateOperator, matchStringOperator, milestoneSteps, milestoneTrack, nestMenuCategories, normalizeCardholderName, orderPayableTotal, orderRedeemedTotal, orderRedeems, parseExpiry, paymentMatchesClientConditions, rebuildRootGroups, recomputeTotals, redeemedTotal, redemptionCap, redemptionSteps, remainingAmount, removeLine, replaceLine, resolveCheckout, resolveModifierImageUrl, reversePayment, runPaymentAttempt, selectablePayments, serializeError, services, setLineQuantity, storefrontJson, toOrderLines, toPaymentCardBrand, validateCardNumber, validateCardholderName, validateCvc, validateExpiry, validateOrderAgainstMenu, verifyWebhookSignature, visitedStates };

package/dist/index.js

@@ -28,23 +28,16 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-//#region src/productCustomization/clamp.utils.ts
-const clampModifierQuantity = (type, quantity, min, max) => {
-	let next = Math.max(0, Math.floor(quantity));
-	if (type === "RADIO" || type === "CHECKBOX") next = next > 0 ? 1 : 0;
-	if (next === 0) return 0;
-	let lower = min;
-	if (type === "QUANTITY") lower = 0;
-	return Math.min(max, Math.max(lower, next));
-};
-const clampProductQuantity = (quantity, min, max) => {
-	return Math.min(max, Math.max(min, Math.max(0, Math.floor(quantity))));
-};
-//#endregion
 //#region src/productCustomization/catalog.utils.ts
 const resolvePricingModifier = (product, groupId) => {
 	return product.pricing.modifiers.find((modifier) => modifier.modifier_group_id === groupId);
 };
+/** Image for a product inside one modifier group, else the product image. */
+const resolveModifierImageUrl = (product, groupId) => {
+	const entry = resolvePricingModifier(product, groupId);
+	if (entry?.image_url) return entry.image_url;
+	return product.image_url ?? null;
+};
 /** Unit price and tax of a modifier in a group. A variant base listed in the
 * group keeps the limits; the variant it resolves to sets what is charged. */
 const modifierUnitPricing = (listed, ordered, groupId) => {
@@ -138,6 +131,19 @@ const resolveModifierGroupsForLookup = (products, modifierGroups) => {
 	return [...byId.values()];
 };
 //#endregion
+//#region src/productCustomization/clamp.utils.ts
+const clampModifierQuantity = (type, quantity, min, max) => {
+	let next = Math.max(0, Math.floor(quantity));
+	if (type === "RADIO" || type === "CHECKBOX") next = next > 0 ? 1 : 0;
+	if (next === 0) return 0;
+	let lower = min;
+	if (type === "QUANTITY") lower = 0;
+	return Math.min(max, Math.max(lower, next));
+};
+const clampProductQuantity = (quantity, min, max) => {
+	return Math.min(max, Math.max(min, Math.max(0, Math.floor(quantity))));
+};
+//#endregion
 //#region src/productCustomization/store.ts
 const createStore = () => {
 	return {
@@ -2413,6 +2419,21 @@ const isKioskAdminCodeInvalid = (error) => {
 const isKioskAdminCodeLocked = (error) => {
 	return error instanceof StorefrontHttpError && error.status === 429;
 };
+/** Placed orders of this kiosk, newest first. Auth is the device secret. */
+const listKioskOrders = async (input, options) => {
+	const path = "/api/storefront/v1/kiosk/devices/me/orders";
+	const init = {
+		method: "POST",
+		body: JSON.stringify(input)
+	};
+	const response = await kioskFetch(path, init, options);
+	if (!response.ok) {
+		const body = await readError$1(response);
+		throwKioskError(body, response.status);
+	}
+	captureLogDevice(input.device_uid);
+	return await response.json();
+};
 const fetchKioskRealtimeToken = async (input, options) => {
 	const path = "/api/storefront/v1/kiosk/realtime/token";
 	const init = {
@@ -2697,7 +2718,20 @@ const enUS = {
 	BREAKDOWN_MISMATCH: "The cash breakdown does not match the amount.",
 	DIFFERENCE_NEEDS_AUTH: "The difference needs a manager PIN.",
 	KIOSK_ORDER_NOT_SETTLEABLE: "This kiosk order cannot be settled here.",
-	PAYMENT_NOT_AVAILABLE: "This payment method is not available on this register."
+	PAYMENT_NOT_AVAILABLE: "This payment method is not available on this register.",
+	STORE_NOT_FOUND: "This register has no store.",
+	TABLE_NOT_FOUND: "That table is not on this store's floor plan.",
+	TABLE_OCCUPIED: "That table is already seated.",
+	TABLE_NOT_IN_SESSION: "That table is not part of this party.",
+	TABLE_SESSION_NOT_FOUND: "That party no longer exists.",
+	TABLE_SESSION_NOT_OPEN: "That party is already closed.",
+	TABLE_SESSION_CONFLICT: "Someone else changed this party. Check it again.",
+	TABLE_SESSION_LAST_TABLE: "A party needs at least one table.",
+	ORDER_NOT_FOUND: "That order is not from this store.",
+	ORDER_IN_OTHER_TABLE_SESSION: "That order belongs to another open party.",
+	RESERVATION_NOT_FOUND: "That reservation is not from this store.",
+	RESERVATION_NOT_BOOKED: "That reservation was already seated or cancelled.",
+	RESERVATION_EXPIRED: "That reservation is a no-show now. Its tables are free again."
 };
 const posErrorMessages = {
 	en: enUS,
@@ -2717,7 +2751,20 @@ const posErrorMessages = {
 		BREAKDOWN_MISMATCH: "El desglose de efectivo no coincide con el monto.",
 		DIFFERENCE_NEEDS_AUTH: "La diferencia necesita el PIN de un supervisor.",
 		KIOSK_ORDER_NOT_SETTLEABLE: "Este pedido de kiosco no se puede cobrar aquí.",
-		PAYMENT_NOT_AVAILABLE: "Este método de pago no está disponible en esta caja."
+		PAYMENT_NOT_AVAILABLE: "Este método de pago no está disponible en esta caja.",
+		STORE_NOT_FOUND: "Esta caja no tiene tienda.",
+		TABLE_NOT_FOUND: "Esa mesa no está en el plano de esta tienda.",
+		TABLE_OCCUPIED: "Esa mesa ya está ocupada.",
+		TABLE_NOT_IN_SESSION: "Esa mesa no es parte de este grupo.",
+		TABLE_SESSION_NOT_FOUND: "Ese grupo ya no existe.",
+		TABLE_SESSION_NOT_OPEN: "Ese grupo ya se cerró.",
+		TABLE_SESSION_CONFLICT: "Alguien más cambió este grupo. Revísalo otra vez.",
+		TABLE_SESSION_LAST_TABLE: "Un grupo necesita al menos una mesa.",
+		ORDER_NOT_FOUND: "Ese pedido no es de esta tienda.",
+		ORDER_IN_OTHER_TABLE_SESSION: "Ese pedido es de otro grupo abierto.",
+		RESERVATION_NOT_FOUND: "Esa reserva no es de esta tienda.",
+		RESERVATION_NOT_BOOKED: "Esa reserva ya se sentó o se canceló.",
+		RESERVATION_EXPIRED: "Esa reserva se marcó como no presentada. Sus mesas ya están libres."
 	},
 	"pt-BR": {
 		DEVICE_NOT_LINKED: "Este caixa não está vinculado.",
@@ -2734,7 +2781,20 @@ const posErrorMessages = {
 		BREAKDOWN_MISMATCH: "A composição do dinheiro não confere com o valor.",
 		DIFFERENCE_NEEDS_AUTH: "A diferença precisa do PIN de um supervisor.",
 		KIOSK_ORDER_NOT_SETTLEABLE: "Este pedido do totem não pode ser cobrado aqui.",
-		PAYMENT_NOT_AVAILABLE: "Esta forma de pagamento não está disponível neste caixa."
+		PAYMENT_NOT_AVAILABLE: "Esta forma de pagamento não está disponível neste caixa.",
+		STORE_NOT_FOUND: "Este caixa não tem loja.",
+		TABLE_NOT_FOUND: "Essa mesa não está na planta desta loja.",
+		TABLE_OCCUPIED: "Essa mesa já está ocupada.",
+		TABLE_NOT_IN_SESSION: "Essa mesa não faz parte deste grupo.",
+		TABLE_SESSION_NOT_FOUND: "Esse grupo não existe mais.",
+		TABLE_SESSION_NOT_OPEN: "Esse grupo já foi fechado.",
+		TABLE_SESSION_CONFLICT: "Outra pessoa alterou este grupo. Confira de novo.",
+		TABLE_SESSION_LAST_TABLE: "Um grupo precisa de pelo menos uma mesa.",
+		ORDER_NOT_FOUND: "Esse pedido não é desta loja.",
+		ORDER_IN_OTHER_TABLE_SESSION: "Esse pedido é de outro grupo aberto.",
+		RESERVATION_NOT_FOUND: "Essa reserva não é desta loja.",
+		RESERVATION_NOT_BOOKED: "Essa reserva já foi acomodada ou cancelada.",
+		RESERVATION_EXPIRED: "Essa reserva virou não comparecimento. As mesas estão livres de novo."
 	}
 };
 const posErrorMessage = (code, locale = "en-US") => {
@@ -2871,13 +2931,17 @@ const closePosSession = async (input, options) => {
 const shiftEndPosSession = async (input, options) => {
 	return (await postJson("/api/storefront/v1/pos/sessions/shift-end", input, options)).data;
 };
-/** The device's open caja and its events, or `{ session: null }`. */
+/** The device's open cash register and its events, or `{ session: null }`. */
 const getPosCurrentSession = async (input, options) => {
 	return (await postJson("/api/storefront/v1/pos/sessions/current", input, options)).data;
 };
 const listPosKioskOrders = async (input, options) => {
 	return (await postJson("/api/storefront/v1/pos/kiosk-orders", input, options)).data;
 };
+/** Placed orders of this POS, newest first. Auth is the device secret. */
+const listPosOrders = async (input, options) => {
+	return postJson("/api/storefront/v1/pos/devices/me/orders", input, options);
+};
 /** Safe to retry with the same `client_id`; the server dedupes the settle. */
 const settlePosKioskOrder = async (input, options) => {
 	return (await postJson("/api/storefront/v1/pos/kiosk-orders/settle", input, options)).data;
@@ -2889,6 +2953,39 @@ const getPosCatalog = async (input, options) => {
 const createPosOrder = async (input, options) => {
 	return (await postJson("/api/storefront/v1/pos/orders", input, options)).data;
 };
+/** Floors, tables (with uids) and the store's open parties. */
+const getPosFloor = async (input, options) => {
+	return (await postJson("/api/storefront/v1/pos/floor", input, options)).data;
+};
+const postOccupancy = async (path, input, options) => {
+	return (await postJson(path, input, options)).data;
+};
+/** Safe to retry with the same `client_id`; the server dedupes the seat. */
+const seatPosTable = async (input, options) => {
+	return postOccupancy("/api/storefront/v1/pos/tables/seat", input, options);
+};
+/** Seats a booked party on its tables; fails once its wait has passed. */
+const seatPosReservation = async (input, options) => {
+	return postOccupancy("/api/storefront/v1/pos/tables/seat-reservation", input, options);
+};
+/** Adds tables to a party; tables held by another party merge it in. */
+const joinPosTables = async (input, options) => {
+	return postOccupancy("/api/storefront/v1/pos/tables/join", input, options);
+};
+/** Moves tables out of a party, optionally seating them as a new party. */
+const splitPosTables = async (input, options) => {
+	return postOccupancy("/api/storefront/v1/pos/tables/split", input, options);
+};
+const closePosTable = async (input, options) => {
+	return postOccupancy("/api/storefront/v1/pos/tables/close", input, options);
+};
+const attachPosTableOrder = async (input, options) => {
+	return postOccupancy("/api/storefront/v1/pos/tables/attach-order", input, options);
+};
+/** Token for the store's private `floor.changed` channel. */
+const fetchPosFloorRealtimeToken = async (input, options) => {
+	return (await postJson("/api/storefront/v1/pos/realtime/token", input, options)).data;
+};
 //#endregion
 //#region src/services/stores.ts
 const storesPath = (suffix) => {
@@ -2977,6 +3074,7 @@ const services = {
 		postHealthSamples: postKioskHealthSamples,
 		patchOverrides: patchKioskOverrides,
 		realtimeToken: fetchKioskRealtimeToken,
+		listOrders: listKioskOrders,
 		unlink: unlinkKioskSelf,
 		verifyAdminCode: verifyKioskAdminCode,
 		isAdminCodeInvalid: isKioskAdminCodeInvalid,
@@ -3002,9 +3100,18 @@ const services = {
 		shiftEnd: shiftEndPosSession,
 		currentSession: getPosCurrentSession,
 		listKioskOrders: listPosKioskOrders,
+		listOrders: listPosOrders,
 		settleKioskOrder: settlePosKioskOrder,
 		getCatalog: getPosCatalog,
 		createOrder: createPosOrder,
+		getFloor: getPosFloor,
+		seatTable: seatPosTable,
+		seatReservation: seatPosReservation,
+		joinTables: joinPosTables,
+		splitTables: splitPosTables,
+		closeTable: closePosTable,
+		attachTableOrder: attachPosTableOrder,
+		floorRealtimeToken: fetchPosFloorRealtimeToken,
 		isDeviceNotLinked: isPosDeviceNotLinked,
 		isUnauthorized: isPosUnauthorized,
 		isPinLocked: isPosPinLocked,
@@ -3943,6 +4050,22 @@ const reversePayment = async (adapter, ctx, result, options = {}) => {
 	}
 	const run = () => callOperation(ctx, operation, result, clock);
 	const next = await withTerminalLock(ctx.paymentId, run);
+	if (kind === "refund" && next.status === "FAILED") {
+		const error = next.error ?? createPaymentError("UNKNOWN");
+		const m1 = {
+			...result.metadata,
+			error,
+			needs_review: true
+		};
+		return {
+			kind,
+			result: {
+				...result,
+				metadata: m1,
+				error
+			}
+		};
+	}
 	return {
 		kind,
 		result: next
@@ -5276,6 +5399,7 @@ var Order = class Order {
 	* total was low recovers its amount once the total grows back.
 	*/
 	requestedRedeem = null;
+	device;
 	constructor(config, notify) {
 		this.draft = cloneOrder(config.order);
 		this.synced = cloneOrder(config.order);
@@ -5283,6 +5407,7 @@ var Order = class Order {
 		this.persisted = config.persisted;
 		this.http = config.http;
 		this.debounceMs = config.debounceMs;
+		this.device = config.device;
 		this.externalNotify = notify;
 		this.flush = createFlushController({
 			getDraft: () => this.draft,
@@ -5344,14 +5469,16 @@ var Order = class Order {
 			order: existing,
 			http,
 			debounceMs,
-			persisted: true
+			persisted: true,
+			device: options.device
 		}, notify);
 		return new Order({
 			order: buildLocalDraft(body),
 			http,
 			debounceMs,
 			persisted: false,
-			fresh: !reuse
+			fresh: !reuse,
+			device: options.device
 		}, notify);
 	}
 	static async reorder(orderId, options = {}, notify) {
@@ -5748,13 +5875,20 @@ var Order = class Order {
 		await this.flush.settle();
 		if (!input.intent_id) this.assertPayable(input.payment);
 		await this.validateOrder();
-		let body = input;
+		const device = input.device ?? this.device;
+		let body = device ? {
+			...input,
+			device
+		} : input;
 		if (!input.intent_id) {
 			const tenders = this.getTenders(input.payment);
 			const needsPayment = input.payment && !simpleTenderInput(input.payment);
 			if (tenders.length > 0 && !needsPayment) {
 				const intent = activeIntent((await this.syncPaymentIntent(tenders)).payment_intents);
-				if (intent) body = { intent_id: intent.id };
+				if (intent) body = device ? {
+					intent_id: intent.id,
+					device
+				} : { intent_id: intent.id };
 			}
 		}
 		try {
@@ -8657,4 +8791,4 @@ const cardPreviewGroups = (value) => {
 	return groups;
 };
 //#endregion
-export { CARD_BRANDS, DEFAULT_RECOMMENDATION_TYPES, Order, OrderPaymentRequiredError, OrderSyncPendingError, OrderSyncRejectedError, OrderValidationError, RecurringDateCron, RulesEngine, StorefrontHttpError, addLines, auth, buildCustomerSnapshot, capRedeems, cappedRedeems, cardBrandSpec, cardDigits, cardNumberGaps, cardNumberMaxLength, cardPreviewGroups, caretAfterDigits, collectOrderLineDiffs, computeStartingPrice, countCartProducts, coveredAmount, createSession, currentNodes, cvcMaxLength, defaultConditionError, detectCardBrand, fitRedeems, flattenMenuCategories, flushLogs, formatCardNumber, formatCvc, formatExpiry, fromOrderLines, genId, genOrderId, getLogContext, getScheduleWindow, indexMenu, isCardNumberComplete, isCardNumberDefinitelyInvalid, isCheckoutFieldFilled, isCvcComplete, isDeviceCharged, isDeviceNotLinked, isExpiryComplete, isKioskUnauthorized, isMilestoneStepDone, isOnSchedule, isOrderPaymentRequiredError, isOrderValidationError, isPosDeviceNotLinked, isPosUnauthorized, isRealPaymentMethod, isStorefrontNotFound, isVariantBase, linePayableTotal, listMenusStream, localizePosError, log, logError, luhnCheck, matchAbsoluteDateOperator, matchBooleanOperator, matchCurrencyOperator, matchEnumOperator, matchNumberOperator, matchRecurringDateOperator, matchRelativeDateOperator, matchStringOperator, milestoneSteps, milestoneTrack, nestMenuCategories, normalizeCardholderName, orderPayableTotal, orderRedeemedTotal, orderRedeems, parseExpiry, paymentMatchesClientConditions, rebuildRootGroups, recomputeTotals, redeemedTotal, redemptionCap, redemptionSteps, remainingAmount, removeLine, replaceLine, resolveCheckout, reversePayment, runPaymentAttempt, selectablePayments, serializeError, services, setLineQuantity, storefrontJson, toOrderLines, toPaymentCardBrand, validateCardNumber, validateCardholderName, validateCvc, validateExpiry, validateOrderAgainstMenu, verifyWebhookSignature, visitedStates };
+export { CARD_BRANDS, DEFAULT_RECOMMENDATION_TYPES, Order, OrderPaymentRequiredError, OrderSyncPendingError, OrderSyncRejectedError, OrderValidationError, RecurringDateCron, RulesEngine, StorefrontHttpError, addLines, auth, buildCustomerSnapshot, capRedeems, cappedRedeems, cardBrandSpec, cardDigits, cardNumberGaps, cardNumberMaxLength, cardPreviewGroups, caretAfterDigits, collectOrderLineDiffs, computeStartingPrice, countCartProducts, coveredAmount, createSession, currentNodes, cvcMaxLength, defaultConditionError, detectCardBrand, fitRedeems, flattenMenuCategories, flushLogs, formatCardNumber, formatCvc, formatExpiry, fromOrderLines, genId, genOrderId, getLogContext, getScheduleWindow, indexMenu, isCardNumberComplete, isCardNumberDefinitelyInvalid, isCheckoutFieldFilled, isCvcComplete, isDeviceCharged, isDeviceNotLinked, isExpiryComplete, isKioskUnauthorized, isMilestoneStepDone, isOnSchedule, isOrderPaymentRequiredError, isOrderValidationError, isPosDeviceNotLinked, isPosUnauthorized, isRealPaymentMethod, isStorefrontNotFound, isVariantBase, linePayableTotal, listMenusStream, localizePosError, log, logError, luhnCheck, matchAbsoluteDateOperator, matchBooleanOperator, matchCurrencyOperator, matchEnumOperator, matchNumberOperator, matchRecurringDateOperator, matchRelativeDateOperator, matchStringOperator, milestoneSteps, milestoneTrack, nestMenuCategories, normalizeCardholderName, orderPayableTotal, orderRedeemedTotal, orderRedeems, parseExpiry, paymentMatchesClientConditions, rebuildRootGroups, recomputeTotals, redeemedTotal, redemptionCap, redemptionSteps, remainingAmount, removeLine, replaceLine, resolveCheckout, resolveModifierImageUrl, reversePayment, runPaymentAttempt, selectablePayments, serializeError, services, setLineQuantity, storefrontJson, toOrderLines, toPaymentCardBrand, validateCardNumber, validateCardholderName, validateCvc, validateExpiry, validateOrderAgainstMenu, verifyWebhookSignature, visitedStates };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fire-spark/core",
-  "version": "0.7.2",
+  "version": "0.8.1",
   "description": "Fire Spark headless SDK",
   "type": "module",
   "sideEffects": false,
@@ -20,8 +20,8 @@
     "big.js": "6.2.1",
     "dayjs": "1.11.9",
     "@types/big.js": "6.2.2",
-    "@fire-spark/payments": "^0.7.2",
-    "@fire-spark/types": "^0.7.2"
+    "@fire-spark/payments": "^0.8.1",
+    "@fire-spark/types": "^0.8.1"
   },
   "devDependencies": {
     "tsdown": "^0.22.14",