@final-commerce/command-frame 0.9.0-online.4 → 0.9.0-online.6

package/dist/actions/get-checkout-status/action.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Get Checkout Status action
+ * Calls the getCheckoutStatus action on the parent window
+ */
+import type { GetCheckoutStatus } from './types';
+export declare const getCheckoutStatus: GetCheckoutStatus;

package/dist/actions/get-checkout-status/action.js

@@ -0,0 +1,8 @@
+/**
+ * Get Checkout Status action
+ * Calls the getCheckoutStatus action on the parent window
+ */
+import { commandFrameClient } from '../../client';
+export const getCheckoutStatus = async (params) => {
+    return await commandFrameClient.call('getCheckoutStatus', params ?? {});
+};

package/dist/actions/get-checkout-status/mock.d.ts

@@ -0,0 +1,3 @@
+import { GetCheckoutStatus } from './types';
+/** Standalone mock: every order the preview knows about is already paid. */
+export declare const mockGetCheckoutStatus: GetCheckoutStatus;

package/dist/actions/get-checkout-status/mock.js

@@ -0,0 +1,11 @@
+/** Standalone mock: every order the preview knows about is already paid. */
+export const mockGetCheckoutStatus = async (params) => {
+    console.log('[Mock] getCheckoutStatus called', params);
+    return {
+        success: true,
+        status: 'paid',
+        paid: true,
+        receiptId: params?.receiptId ?? 'ON-001-000001',
+        timestamp: new Date().toISOString(),
+    };
+};

package/dist/actions/get-checkout-status/types.d.ts

@@ -0,0 +1,20 @@
+/** The shopper-facing vocabulary: never the platform's payment / fulfilment states. */
+export type CheckoutOrderStatus = 'awaiting_payment' | 'confirming' | 'payment_failed' | 'paid' | 'fulfilled' | 'partially_refunded' | 'refunded' | 'cancelled';
+export interface GetCheckoutStatusParams {
+    /**
+     * The receipt `startCheckout` returned, to name which order. Omitted: the checkout in flight,
+     * else the last one this tab finished.
+     */
+    receiptId?: string;
+}
+export interface GetCheckoutStatusResponse {
+    success: boolean;
+    /** `null` when this tab placed no such order, or the server could not be asked. */
+    status: CheckoutOrderStatus | null;
+    /** True once the money is in: `paid`, `fulfilled`, or refunded since. */
+    paid: boolean;
+    receiptId: string | null;
+    timestamp: string;
+}
+/** Never throws for an unknown order: answers `status: null`. */
+export type GetCheckoutStatus = (params?: GetCheckoutStatusParams) => Promise<GetCheckoutStatusResponse>;

package/dist/actions/get-checkout-status/types.js

@@ -0,0 +1,12 @@
+// Get Checkout Status Types
+//
+// Where an online order stands NOW, as the server holds it. A confirmation page uses it to move
+// from "we're confirming your payment" to "paid" once the payment provider's notification has
+// landed, which the browser alone can never know: it only ever sees that the provider ACCEPTED
+// a payment.
+//
+// The runtime asks about a checkout THIS TAB placed (it keeps the checkout's key), so a page can
+// only ever ask about its own order. No password: the server no longer issues one.
+//
+// Served ONLY by the storefront runtime (a published website). On a register it does not exist.
+export {};

package/dist/actions/get-product-modifier-selections/mock.js

@@ -13,18 +13,23 @@ export const mockGetProductModifierSelections = async (params) => {
             selections: [],
             rows: [],
             modifiersTotal: 0,
+            lineTotal: 0,
+            unitTotal: 0,
             timestamp: new Date().toISOString(),
         };
     }
     // The priced rows already sit on the line; extending them by the line quantity is
     // the host's job, not the flow's.
     const { rows, modifiersTotal } = buildModifierRows(line.modifiers, line.quantity);
+    const { modifiersTotal: unitModifiers } = buildModifierRows(line.modifiers, 1);
     return {
         success: true,
         internalId: line.internalId,
         selections: line.modifierSelections ?? [],
         rows,
         modifiersTotal,
+        lineTotal: line.price * line.quantity + modifiersTotal,
+        unitTotal: line.price + unitModifiers,
         timestamp: new Date().toISOString(),
     };
 };

package/dist/actions/get-product-modifier-selections/types.d.ts

@@ -18,6 +18,10 @@ export interface GetProductModifierSelectionsResponse {
     rows: CFProdModifierBreakdown[];
     /** Sum of `rows[].amount` for THIS line, in minor units. */
     modifiersTotal: number;
+    /** The whole line as the cart prices it (item, its discounts, fees and modifiers), in minor units. */
+    lineTotal: number;
+    /** The same for ONE unit, for an "each" price. */
+    unitTotal: number;
     timestamp: string;
 }
 export type GetProductModifierSelections = (params?: GetProductModifierSelectionsParams) => Promise<GetProductModifierSelectionsResponse>;

package/dist/index.d.ts

@@ -61,6 +61,7 @@ export declare const command: {
     readonly selectShippingOption: import(".").SelectShippingOption;
     readonly setOutlet: import(".").SetOutlet;
     readonly resumeCheckout: import(".").ResumeCheckout;
+    readonly getCheckoutStatus: import(".").GetCheckoutStatus;
     readonly addCustomerNote: import(".").AddCustomerNote;
     readonly removeCustomerNote: import(".").RemoveCustomerNote;
     readonly removeCustomerFromCart: import(".").RemoveCustomerFromCart;
@@ -214,6 +215,7 @@ export type { GetShippingOptions, GetShippingOptionsResponse, ShippingOptionView
 export type { SelectShippingOption, SelectShippingOptionParams, SelectShippingOptionResponse, } from './actions/select-shipping-option/types';
 export type { SetOutlet, SetOutletParams, SetOutletResponse } from './actions/set-outlet/types';
 export type { ResumeCheckout, ResumeCheckoutParams, ResumeCheckoutResponse, ResumeCheckoutResult, } from './actions/resume-checkout/types';
+export type { GetCheckoutStatus, GetCheckoutStatusParams, GetCheckoutStatusResponse, CheckoutOrderStatus, } from './actions/get-checkout-status/types';
 export type { AddCustomerNote, AddCustomerNoteParams, AddCustomerNoteResponse, } from './actions/add-customer-note/types';
 export type { RemoveCustomerNote, RemoveCustomerNoteParams, RemoveCustomerNoteResponse, } from './actions/remove-customer-note/types';
 export type { RemoveCustomerFromCart, RemoveCustomerFromCartResponse } from './actions/remove-customer-from-cart/types';

package/dist/index.js

@@ -61,6 +61,7 @@ import { getShippingOptions } from './actions/get-shipping-options/action';
 import { selectShippingOption } from './actions/select-shipping-option/action';
 import { setOutlet } from './actions/set-outlet/action';
 import { resumeCheckout } from './actions/resume-checkout/action';
+import { getCheckoutStatus } from './actions/get-checkout-status/action';
 // Customer Actions
 import { addCustomerNote } from './actions/add-customer-note/action';
 import { removeCustomerNote } from './actions/remove-customer-note/action';
@@ -216,6 +217,7 @@ export const command = {
     selectShippingOption,
     setOutlet,
     resumeCheckout,
+    getCheckoutStatus,
     // Customer Actions
     addCustomerNote,
     removeCustomerNote,

package/dist/projects/render/mocks.js

@@ -43,6 +43,7 @@ import { mockSelectShippingOption } from '../../actions/select-shipping-option/m
 import { mockGetOutlets } from '../../actions/get-outlets/mock';
 import { mockSetOutlet } from '../../actions/set-outlet/mock';
 import { mockResumeCheckout } from '../../actions/resume-checkout/mock';
+import { mockGetCheckoutStatus } from '../../actions/get-checkout-status/mock';
 import { mockGetTimeClockStatus } from '../../actions/get-time-clock-status/mock';
 import { mockClearCart } from '../../actions/clear-cart/mock';
 import { mockDeleteParkedOrder } from '../../actions/delete-parked-order/mock';
@@ -159,6 +160,7 @@ export const RENDER_MOCKS = {
     getOutlets: mockGetOutlets,
     setOutlet: mockSetOutlet,
     resumeCheckout: mockResumeCheckout,
+    getCheckoutStatus: mockGetCheckoutStatus,
     clearCart: mockClearCart,
     deleteParkedOrder: mockDeleteParkedOrder,
     voidOrder: mockVoidOrder,

package/dist/projects/render/types.d.ts

@@ -1,4 +1,4 @@
-import type { ExampleFunction, GetProducts, AddCustomSale, EditCustomSale, GetCustomers, AssignCustomer, AddCustomer, EditCustomer, GetCategories, GetOrders, GetRefunds, GetTaxTables, GetCustomStockActions, AddProductDiscount, AddProductToCart, RemoveProductFromCart, UpdateCartItemQuantity, AddCartDiscount, GetContext, GetFinalContext, AddProductNote, AddProductFee, GetProductModifierSelections, SetProductModifierSelections, SetActiveProductFee, SetActiveProductDiscount, GetActiveProduct, SetActiveProduct, AdjustInventory, AddOrderNote, AddCartFee, ClearCart, ParkOrder, ResumeParkedOrder, DeleteParkedOrder, VoidOrder, InitiateRefund, CashPayment, GetCashRoundingAmount, TapToPayPayment, TerminalPayment, ExtensionPayment, RedeemPayment, AddNonRevenueItem, AddCustomerNote, RemoveCustomerNote, RemoveCustomerFromCart, GoToStationHome, OpenCashDrawer, ShowNotification, ShowConfirmation, AuthenticateUser, PartialPayment, SwitchUser, SetRefundStockAction, SelectAllRefundItems, ResetRefundDetails, CalculateRefundTotal, GetRemainingRefundableQuantities, ProcessPartialRefund, RedeemRefund, GetRefundPlan, CheckPermission, GetCurrentCart, Print, SetActiveOrder, GetCustomTables, GetCustomTableData, UpsertCustomTableData, DeleteCustomTableData, GetCustomExtensions, GetCurrentCompanyCustomExtensions, GetCustomExtensionCustomTables, GetCustomTableFields, GetSecretsKeys, GetSecretVal, SetSecretVal, GetUsers, GetRoles, RemoveCartDiscount, GetActiveOrder, GetActiveCustomer, SetActiveCustomer, GetActiveOutlet, GetActiveStation, GetActiveSession, GetActiveUser, SetActiveUser, SetActiveRefund, RemoveProductDiscount, RemoveProductFee, RemoveProductNote, RemoveCartFee, RemoveOrderNote, RemoveCustomSale, RemoveNonRevenueItem, CanTransition, GetAvailableTransitions, ApplyTransition, IntegrationPayment, GetSmartGridLayout, SaveSmartGridLayout, SendEmail, SendSms, GetBookingResources, GetBookingAvailability, GetBookings, HoldBooking, AddBookingToCart, RemoveBookingFromCart, CancelBooking, CreatePaymentLink, ChargeMoto, StartCheckout, AttachCheckoutContact, GetAddressOptions, SetOrderAddress, GetShippingOptions, SelectShippingOption, GetOutlets, SetOutlet, ResumeCheckout, GetTimeClockStatus } from '../../index';
+import type { ExampleFunction, GetProducts, AddCustomSale, EditCustomSale, GetCustomers, AssignCustomer, AddCustomer, EditCustomer, GetCategories, GetOrders, GetRefunds, GetTaxTables, GetCustomStockActions, AddProductDiscount, AddProductToCart, RemoveProductFromCart, UpdateCartItemQuantity, AddCartDiscount, GetContext, GetFinalContext, AddProductNote, AddProductFee, GetProductModifierSelections, SetProductModifierSelections, SetActiveProductFee, SetActiveProductDiscount, GetActiveProduct, SetActiveProduct, AdjustInventory, AddOrderNote, AddCartFee, ClearCart, ParkOrder, ResumeParkedOrder, DeleteParkedOrder, VoidOrder, InitiateRefund, CashPayment, GetCashRoundingAmount, TapToPayPayment, TerminalPayment, ExtensionPayment, RedeemPayment, AddNonRevenueItem, AddCustomerNote, RemoveCustomerNote, RemoveCustomerFromCart, GoToStationHome, OpenCashDrawer, ShowNotification, ShowConfirmation, AuthenticateUser, PartialPayment, SwitchUser, SetRefundStockAction, SelectAllRefundItems, ResetRefundDetails, CalculateRefundTotal, GetRemainingRefundableQuantities, ProcessPartialRefund, RedeemRefund, GetRefundPlan, CheckPermission, GetCurrentCart, Print, SetActiveOrder, GetCustomTables, GetCustomTableData, UpsertCustomTableData, DeleteCustomTableData, GetCustomExtensions, GetCurrentCompanyCustomExtensions, GetCustomExtensionCustomTables, GetCustomTableFields, GetSecretsKeys, GetSecretVal, SetSecretVal, GetUsers, GetRoles, RemoveCartDiscount, GetActiveOrder, GetActiveCustomer, SetActiveCustomer, GetActiveOutlet, GetActiveStation, GetActiveSession, GetActiveUser, SetActiveUser, SetActiveRefund, RemoveProductDiscount, RemoveProductFee, RemoveProductNote, RemoveCartFee, RemoveOrderNote, RemoveCustomSale, RemoveNonRevenueItem, CanTransition, GetAvailableTransitions, ApplyTransition, IntegrationPayment, GetSmartGridLayout, SaveSmartGridLayout, SendEmail, SendSms, GetBookingResources, GetBookingAvailability, GetBookings, HoldBooking, AddBookingToCart, RemoveBookingFromCart, CancelBooking, CreatePaymentLink, ChargeMoto, StartCheckout, AttachCheckoutContact, GetAddressOptions, SetOrderAddress, GetShippingOptions, SelectShippingOption, GetOutlets, SetOutlet, ResumeCheckout, GetCheckoutStatus, GetTimeClockStatus } from '../../index';
 export interface RenderProviderActions {
     exampleFunction: ExampleFunction;
     getProducts: GetProducts;
@@ -73,6 +73,8 @@ export interface RenderProviderActions {
      * `startCheckout`, and safe to call on every page load.
      */
     resumeCheckout: ResumeCheckout;
+    /** Where an online order stands now, by its order password. Storefront-only. */
+    getCheckoutStatus: GetCheckoutStatus;
     addNonRevenueItem: AddNonRevenueItem;
     addCustomerNote: AddCustomerNote;
     removeCustomerNote: RemoveCustomerNote;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@final-commerce/command-frame",
-  "version": "0.9.0-online.4",
+  "version": "0.9.0-online.6",
   "description": "Commands Frame library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",