@final-commerce/command-frame 0.11.1-preprod.2 → 0.11.1-preprod.3

package/dist/actions/record-external-payment/mock.js

@@ -19,11 +19,16 @@ export const mockRecordExternalPayment = async (params) => {
     if (amount > balanceDue) {
         throw new Error(`recordExternalPayment: amount ${amount} exceeds the balance due ${balanceDue}`);
     }
+    const tip = params.tip?.amount ?? 0;
+    if (params.tip !== undefined && (!Number.isInteger(tip) || tip <= 0)) {
+        throw new Error('recordExternalPayment: tip.amount must be a positive integer (minor units)');
+    }
     const order = applyMockPayment(amount, 'external', label);
     const remainingBalance = MOCK_CART.remainingBalance ?? 0;
     return {
         success: true,
         amount,
+        tip,
         label,
         paymentType: 'external',
         change: 0,

package/dist/actions/record-external-payment/types.d.ts

@@ -1,4 +1,11 @@
 import { CFOrder } from '../../CommonTypes';
+/** A tip the customer already paid wherever the money was taken (the website, a delivery app). */
+export interface RecordExternalPaymentTip {
+    /** Tip in integer MINOR currency units. Must be positive. */
+    amount: number;
+    /** User id the tip belongs to. Defaults to the cashier recording the payment. */
+    tipTo?: string;
+}
 export interface RecordExternalPaymentParams {
     /**
      * What the payment was — shown on the order and in reports, e.g. 'Paid online',
@@ -12,13 +19,21 @@ export interface RecordExternalPaymentParams {
      * the rest can be taken with any other tender. Above the balance due is an error.
      */
     amount?: number;
+    /**
+     * Tip paid along with it. Recorded ON TOP of `amount` — it never counts toward the
+     * balance due — and stored on the payment like a card tip, so reports and tip-outs
+     * see it. Omit for no tip.
+     */
+    tip?: RecordExternalPaymentTip;
     /** Fulfillment state to land on after full payment, e.g. 'pending' to keep the order going to the kitchen. */
     checkoutFulfillmentTarget?: string;
 }
 export interface RecordExternalPaymentResponse {
     success: boolean;
-    /** The amount recorded, in integer MINOR currency units. */
+    /** The amount recorded against the balance, in integer MINOR currency units. Excludes the tip. */
     amount: number;
+    /** The tip recorded on top of `amount`, in integer MINOR currency units; 0 when none. */
+    tip: number;
     /** The label, as recorded. */
     label: string;
     paymentType: 'external';

package/dist/index.d.ts

@@ -223,7 +223,7 @@ export type { GetOrderStatuses, GetOrderStatusesResponse } from './actions/get-o
 export type { DeleteParkedOrder, DeleteParkedOrderParams, DeleteParkedOrderResponse, } from './actions/delete-parked-order/types';
 export type { VoidOrder, VoidOrderParams, VoidOrderResponse, VoidOrderOutcome } from './actions/void-order/types';
 export type { CashPayment, CashPaymentParams, CashPaymentResponse } from './actions/cash-payment/types';
-export type { RecordExternalPayment, RecordExternalPaymentParams, RecordExternalPaymentResponse, } from './actions/record-external-payment/types';
+export type { RecordExternalPayment, RecordExternalPaymentParams, RecordExternalPaymentResponse, RecordExternalPaymentTip, } from './actions/record-external-payment/types';
 export type { GetCashRoundingAmount, GetCashRoundingAmountParams, GetCashRoundingAmountResponse, } from './actions/get-cash-rounding-amount/types';
 export type { TapToPayPayment, TapToPayPaymentParams, TapToPayPaymentResponse, } from './actions/tap-to-pay-payment/types';
 export type { TerminalPayment, TerminalPaymentParams, TerminalPaymentResponse } from './actions/terminal-payment/types';

package/package.json

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