@munchi_oy/payments 1.6.10 → 1.10.0

package/src/strategies/sessionResult.ts

@@ -0,0 +1,92 @@
+import {
+  PaymentFailureCode,
+  PaymentSessionStatus,
+  type PaymentSessionViewDto,
+} from "@munchi_oy/core";
+
+import { PaymentErrorCode, PaymentSDKError } from "../error";
+import { type PaymentResult, SdkPaymentStatus } from "../types/payment";
+
+function assertNever(value: never): never {
+  throw new PaymentSDKError(
+    PaymentErrorCode.UNKNOWN,
+    `Unhandled payment session status: ${String(value)}`,
+  );
+}
+
+export function pendingResult(orderId: string): PaymentResult {
+  return {
+    success: false,
+    status: SdkPaymentStatus.PENDING,
+    orderId,
+    errorCode: "",
+    errorMessage: "",
+  };
+}
+
+export function mapSessionResult(
+  data: PaymentSessionViewDto,
+  orderId: string,
+): PaymentResult {
+  switch (data.status) {
+    case PaymentSessionStatus.Initiated:
+    case PaymentSessionStatus.Processing:
+    case PaymentSessionStatus.Voiding:
+    case PaymentSessionStatus.Refunding:
+      return pendingResult(orderId);
+
+    case PaymentSessionStatus.Success:
+    case PaymentSessionStatus.Closed: {
+      const result: PaymentResult = {
+        success: true,
+        status: SdkPaymentStatus.SUCCESS,
+        orderId,
+        errorCode: "",
+        errorMessage: "",
+      };
+      if (data.providerTransactionId) {
+        result.transactionId = data.providerTransactionId;
+      }
+      return result;
+    }
+
+    case PaymentSessionStatus.VoidFailed:
+    case PaymentSessionStatus.Failed: {
+      const result: PaymentResult = {
+        success: false,
+        status: SdkPaymentStatus.FAILED,
+        orderId,
+        errorCode: data.errorCode || PaymentFailureCode.SystemUnknown,
+        errorMessage:
+          data.errorMessage || "Transaction failed without error details",
+      };
+      if (data.providerTransactionId) {
+        result.transactionId = data.providerTransactionId;
+      }
+      return result;
+    }
+
+    case PaymentSessionStatus.Cancelled:
+    case PaymentSessionStatus.Voided:
+    case PaymentSessionStatus.Refunded: {
+      const result: PaymentResult = {
+        success: false,
+        status: SdkPaymentStatus.CANCELLED,
+        orderId,
+      };
+      if (data.errorCode) {
+        result.errorCode = data.errorCode;
+      }
+      if (data.errorMessage) {
+        result.errorMessage = data.errorMessage;
+      }
+      if (data.providerTransactionId) {
+        result.transactionId = data.providerTransactionId;
+      }
+      return result;
+    }
+
+    default:
+      return assertNever(data.status);
+  }
+}

package/src/types/payment.ts

@@ -1,8 +1,9 @@
 import type {
-    CurrencyCode,
-    PaymentProvider,
-    ProviderEnum,
-    TransactionDto,
+  CurrencyCode,
+  PaymentProvider,
+  ProviderEnum,
+  SplitContextDto,
+  TransactionDto,
 } from "@munchi_oy/core";
 
 export type TransactionDetails = Omit<
@@ -63,6 +64,12 @@ export interface PaymentRequest {
   currency: CurrencyCode;
   displayId: string;
   options?: VivaOptions | NetsOptions | WorldlineOptions;
+  /**
+   * Split context for the payment-session flow. Omit for a full-cart payment,
+   * or send { mode, partId|seatId } for a split. Must match the order's
+   * checkoutModel. Only consumed by VivaSessionStrategy.
+   */
+  splitContext?: SplitContextDto;
 }
 
 export interface RefundRequest {
@@ -83,9 +90,28 @@ export interface RefundRequest {
   options?: VivaRefundOptions | NetsRefundOptions | WorldlineRefundOptions;
 }
 
+export interface ManualPaymentRequest {
+  orderRef: string;
+  amountCents: number;
+  paymethod: string;
+  tipAmount?: number;
+  splitContext?: SplitContextDto;
+  /**
+   * Arbitrary client metadata persisted on the session (e.g. voucher code,
+   * gift card id, employee id, external reference, notes). Surfaced to
+   * reconciliation when building the order paymentEvent.
+   */
+  metadata?: Record<string, unknown>;
+}
+
+export interface VoidRequest {
+  orderRef: string;
+  sessionId: string;
+}
+
 export interface PaymentTerminalConfig {
-  channel: ProviderEnum,
-  provider?: PaymentProvider | null;
+  channel: ProviderEnum;
+  provider: PaymentProvider;
   kioskId: string;
   storeId: string;
 }
@@ -102,13 +128,28 @@ export interface PaymentResult {
 }
 
 export interface TransactionOptions {
-  onConnecting?: (ctx: { orderRef: string; refPaymentId?: string | undefined }) => void;
-  onRequiresInput?: (ctx: { orderRef: string; refPaymentId?: string | undefined }) => void;
-  onProcessing?: (ctx: { orderRef: string; refPaymentId?: string | undefined }) => void;
-  onVerifying?: (ctx: { orderRef: string; refPaymentId?: string | undefined }) => void;
+  onConnecting?: (ctx: {
+    orderRef: string;
+    refPaymentId?: string | undefined;
+  }) => void;
+  onRequiresInput?: (ctx: {
+    orderRef: string;
+    refPaymentId?: string | undefined;
+  }) => void;
+  onProcessing?: (ctx: {
+    orderRef: string;
+    refPaymentId?: string | undefined;
+  }) => void;
+  onVerifying?: (ctx: {
+    orderRef: string;
+    refPaymentId?: string | undefined;
+  }) => void;
   onSuccess?: (result: PaymentResult) => void;
   onError?: (result: PaymentResult) => void;
-  onCancelled?: (ctx: { orderRef: string; refPaymentId?: string | undefined }) => void;
+  onCancelled?: (ctx: {
+    orderRef: string;
+    refPaymentId?: string | undefined;
+  }) => void;
 }
 
 export interface IMessagingAdapter {
@@ -129,6 +170,17 @@ export interface IMunchiPaymentSDK {
     options?: TransactionOptions,
   ): Promise<PaymentResult>;
   cancel(): Promise<boolean>;
-  refund(params: RefundRequest, options?: TransactionOptions): Promise<PaymentResult>;
+  refund(
+    params: RefundRequest,
+    options?: TransactionOptions,
+  ): Promise<PaymentResult>;
+  recordManualPayment(
+    params: ManualPaymentRequest,
+    options?: TransactionOptions,
+  ): Promise<PaymentResult>;
+  voidManualPayment(
+    params: VoidRequest,
+    options?: TransactionOptions,
+  ): Promise<PaymentResult>;
   reset(): void;
 }

package/src/types/sdk.ts

@@ -57,4 +57,14 @@ export interface SDKOptions {
    */
   autoResetOnPaymentComplete?: AutoResetOptions;
   appToApp?: AppToAppConfig;
+  /**
+   * Routes POS Viva payments through the backend payment-session flow
+   * (VivaSessionStrategy) instead of the legacy v4 VivaStrategy. Kiosk/handheld
+   * leave this unset and stay on the legacy flow.
+   */
+  paymentSession?: PaymentSessionConfig;
+}
+
+export interface PaymentSessionConfig {
+  enabled: boolean;
 }

package/src/version.ts

@@ -1,3 +1,3 @@
 // This file is auto-generated. Do not edit manually.
 // Run 'pnpm version:sync' to update this file.
-export const VERSION = "1.6.10";
+export const VERSION = "1.10.0";