@final-commerce/command-frame 0.3.2-preprod.1 → 0.4.1-preprod.1

package/dist/actions/redeem-refund/mock.js

@@ -0,0 +1,59 @@
+import { MOCK_ORDERS, mockPublishEvent } from '../../demo/database';
+// Payment states in which an order is refundable
+const REFUNDABLE_PAYMENT_STATES = ['paid', 'partially_refunded'];
+// Track refunded amounts per order to enforce remaining capacity gate
+const mockRefundedAmounts = {};
+export const mockRedeemRefund = async (params) => {
+    console.log('[Mock] redeemRefund called', params);
+    // Validate required params
+    if (!params.amount || params.amount <= 0) {
+        throw new Error('Amount must be greater than 0');
+    }
+    if (!params.referenceId) {
+        throw new Error('referenceId is required');
+    }
+    // Find order
+    const order = params.orderId ? MOCK_ORDERS.find((o) => o._id === params.orderId) : MOCK_ORDERS[0];
+    if (!order) {
+        throw new Error(`Order with ID ${params.orderId} not found`);
+    }
+    const orderId = order._id;
+    // Check if order is in a refundable state
+    if (!REFUNDABLE_PAYMENT_STATES.includes(order.paymentState)) {
+        throw new Error(`ORDER_NOT_REFUNDABLE: order ${orderId} is '${order.paymentState}' — only 'paid' or 'partially_refunded' orders can be refunded`);
+    }
+    // Track refunded amounts and check remaining capacity
+    const refundedSoFar = mockRefundedAmounts[orderId] || 0;
+    const remainingCapacity = order.summary.total - refundedSoFar;
+    if (params.amount > remainingCapacity) {
+        throw new Error(`REFUND_AMOUNT_EXCEEDS_CAPACITY: Refund amount ${params.amount} exceeds remaining refundable capacity ${remainingCapacity}`);
+    }
+    // Update refunded amount tracking
+    const refundedAfter = refundedSoFar + params.amount;
+    mockRefundedAmounts[orderId] = refundedAfter;
+    // Update order state based on remaining capacity after this refund
+    const remainingAfterRefund = order.summary.total - refundedAfter;
+    if (remainingAfterRefund > 0) {
+        order.paymentState = 'partially_refunded';
+    }
+    else {
+        order.paymentState = 'refunded';
+    }
+    // Publish refund event
+    mockPublishEvent('refunds', 'refund-created', {
+        orderId,
+        amount: params.amount,
+        referenceId: params.referenceId,
+        processor: params.processor || 'giftCard',
+        label: params.label,
+        reason: params.reason,
+    });
+    return {
+        success: true,
+        orderId,
+        amount: params.amount,
+        referenceId: params.referenceId,
+        legCount: 1,
+        timestamp: new Date().toISOString(),
+    };
+};

package/dist/actions/redeem-refund/types.d.ts

@@ -0,0 +1,39 @@
+export interface RedeemRefundParams {
+    /** Order to refund; defaults to the active order. */
+    orderId?: string;
+    /**
+     * Amount to refund onto the redeem tender, integer MINOR currency units
+     * (1575 = $15.75). Required; must be > 0 and within the order's remaining
+     * refundable capacity (tip-inclusive, across all source payments).
+     */
+    amount: number;
+    /**
+     * Destination card/account identifier the funds were credited to
+     * (e.g. the gift-card number). Recorded in the emv block (`'Card Number'`)
+     * of every refund payment entry on the order, and in paymentData on the
+     * local transaction rows, for the audit trail. Required.
+     */
+    referenceId: string;
+    /** Destination provider label; defaults to "giftCard" (matches redeemPayment). */
+    processor?: string;
+    /** Human-readable label for receipts/reporting. */
+    label?: string;
+    /** Extension identity, recorded on the legs when provided. */
+    extensionId?: string;
+    /** Opaque extension payload, recorded on the legs when provided. */
+    metadata?: Record<string, unknown>;
+    /** Cashier-facing reason, recorded on the refund + state-event audit rows. */
+    reason?: string;
+}
+export interface RedeemRefundResponse {
+    success: boolean;
+    orderId: string;
+    /** Total refunded onto the redeem tender (minor units). */
+    amount: number;
+    /** Echo of the destination identifier the legs were recorded against. */
+    referenceId: string;
+    /** Number of source payments the amount was drawn from. */
+    legCount: number;
+    timestamp: string;
+}
+export type RedeemRefund = (params: RedeemRefundParams) => Promise<RedeemRefundResponse>;

package/dist/actions/redeem-refund/types.js

@@ -0,0 +1,2 @@
+// Redeem Refund Types
+export {};

package/dist/actions/terminal-payment/types.d.ts

@@ -12,9 +12,9 @@ export interface TerminalPaymentParams {
      */
     amount: number;
     /** "Bluetooth" or "Cloud". Defaults to "Cloud". */
-    paymentType?: 'Bluetooth' | 'Cloud';
-    /** Override the fulfillment state after full payment. Render resolves the cascade. */
-    checkoutFulfillmentTarget?: string;
+    paymentType?: "Bluetooth" | "Cloud";
+    /** Override the fulfillment landing on full payment. Omitted: preserve advanced fulfillment, auto-fulfill from draft/pending/on_hold. */
+    targetFulfillmentState?: string;
 }
 export interface TerminalPaymentResponse {
     success: boolean;

package/dist/demo/database.d.ts

@@ -2,8 +2,8 @@
  * Mock Database for Standalone/Demo Mode
  * Stores mock data that mimics the Render environment
  */
-import { CFActiveCompany, CFActiveUser, CFActiveStation, CFActiveOutlet, CFActiveOrder, CFCustomer, CFProduct, CFActiveCart, CFCategory, CFActiveProduct, CFSession, CFActiveRefundDetails, CFSmartGridLayout } from "../CommonTypes";
-export * from "./mocks";
+import { CFActiveCompany, CFActiveUser, CFActiveStation, CFActiveOutlet, CFActiveOrder, CFCustomer, CFProduct, CFActiveCart, CFCategory, CFActiveProduct, CFSession, CFActiveRefundDetails, CFSmartGridLayout } from '../CommonTypes';
+export * from './mocks';
 /** Replace mock catalog / context data in place (same array references mock handlers use). */
 export interface MockDatabaseConfig {
     company?: Partial<CFActiveCompany>;