@litepos/payment 1.0.12 → 1.0.15

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { CancelResponse, PaymentRequest, PaymentResponse, RefundResponse } from './interfaces';
+import type { CancelResponse, PaymentRequest, PaymentResponse, RefundResponse, VoidResponse } from './interfaces';
 import { PaymentStatus } from './types/status';
 export declare function validateConfig(method: string, config: unknown): void;
 export declare class LitePosPayment {
@@ -6,8 +6,9 @@ export declare class LitePosPayment {
     queryPayment(method: string, transactionId: string, config: Record<string, unknown>): Promise<PaymentResponse>;
     cancelPayment(method: string, transactionId: string, config: Record<string, unknown>): Promise<CancelResponse>;
     refund(method: string, transactionId: string, config: Record<string, unknown>, amount?: number): Promise<RefundResponse>;
+    voidPayment(method: string, transactionId: string, config: Record<string, unknown>): Promise<VoidResponse>;
     queryRefund(method: string, refundId: string, config: Record<string, unknown>): Promise<RefundResponse>;
     simulateCharge(request: PaymentRequest): PaymentResponse;
-    simulateQuery(transactionId: string, status: PaymentStatus): PaymentResponse;
+    simulateQuery(transactionId: string, status: PaymentStatus, amount?: number, currency?: string): PaymentResponse;
     private getGatewayName;
 }

package/dist/client.js

@@ -1,4 +1,4 @@
-import { cancelPayment as cancelFiuuPayment, chargeCard, chargeQrCode, queryPayment, refund, validateConfig as validateFiuuConfig } from '@litepos/payment-fiuu';
+import { cancelPayment as cancelFiuuPayment, chargeCard, chargeQrCode, queryPayment, refund, validateConfig as validateFiuuConfig, voidPayment as voidFiuuPayment } from '@litepos/payment-fiuu';
 import { ValidationError } from './types/error';
 import { PaymentStatus } from './types/status';
 import { logError, logInfo } from './utils/logger';
@@ -23,6 +23,10 @@ const CANCEL_ROUTING = {
     'FIUU': cancelFiuuPayment,
     'fiuu-qrcode': cancelFiuuPayment,
 };
+const VOID_ROUTING = {
+    'FIUU': voidFiuuPayment,
+    'fiuu-qrcode': voidFiuuPayment,
+};
 // Config validation routing
 const VALIDATE_ROUTING = {
     'FIUU': validateFiuuConfig,
@@ -92,6 +96,20 @@ export class LitePosPayment {
             throw error;
         }
     }
+    async voidPayment(method, transactionId, config) {
+        const handler = VOID_ROUTING[method];
+        if (!handler)
+            throw new ValidationError(`Payment method not supported: ${method}`, method);
+        try {
+            const response = await handler(transactionId, config);
+            logInfo(`${this.getGatewayName(method)}: Void payment, Transaction ID ${transactionId}, Void ID ${response.voidId}, Status ${response.status}`, { transactionId, response });
+            return response;
+        }
+        catch (error) {
+            logError(`${this.getGatewayName(method)}: Void payment failed, Transaction ID ${transactionId}`, { transactionId, error });
+            throw error;
+        }
+    }
     async queryRefund(method, refundId, config) {
         const handler = REFUND_QUERY_ROUTING[method];
         if (!handler)
@@ -108,25 +126,118 @@ export class LitePosPayment {
     }
     // Simulation methods (for testing, returns mock data without calling adapters)
     simulateCharge(request) {
-        const transactionId = `SIM-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+        const transactionId = `SIM-${Date.now()}`;
+        const isQrCode = request.method.includes('qrcode');
+        const paymentChannel = isQrCode ? (request.metadata?.paymentChannel || 'tng') : 'Mastercard';
+        const cardLabel = isQrCode ? '' : 'Mastercard';
+        const cardNo = isQrCode ? '' : '************2066';
+        const now = new Date();
+        const invNo = now.toISOString().replace(/[-:T]/g, '').slice(0, 14);
         return {
             transactionId,
             status: PaymentStatus.Pending,
             amount: request.amount,
             currency: request.currency,
-            qrCodeData: request.method.includes('qrcode') ? `QR_${request.orderId}` : undefined,
-            metadata: { simulated: true, ...request.metadata },
-            raw: { simulated: true, request },
+            qrCodeData: isQrCode ? `QR_${request.orderId}` : undefined,
+            payment_source_method: cardLabel || paymentChannel,
+            payment_source_last4: isQrCode ? '' : '2066',
+            payment_source_charge_ref: transactionId,
+            metadata: {
+                responseCode: '00',
+                responseText: 'Approved',
+                paymentChannel,
+                invNo,
+                tid: '00000001',
+                mid: '000000000000001',
+                cardNo,
+                entryMode: 'contactless',
+                cardLabel,
+            },
+            raw: {
+                transType: 'sale',
+                posId: 'SIM_POS_ID',
+                deviceId: 'SIM_DEVICE_ID',
+                referenceLabel: request.orderId.slice(0, 10),
+                apiVersion: 'v1',
+                statusCode: '00',
+                responseCode: '00',
+                responseText: 'Approved',
+                terminalSn: 'SIM_TERMINAL',
+                softwareVersion: 'Version 1.0.0',
+                transData: {
+                    cardNo,
+                    entryMode: 'contactless',
+                    rrn: '000000000001',
+                    tvr: '0000008001',
+                    appCrypt: 'simulated',
+                    aid: 'A0000000041010',
+                    cvmType: '00',
+                    cardLabel,
+                    paymentChannel,
+                    transAmt: request.amount.toFixed(2),
+                    transDateTime: now.toISOString().slice(0, 19),
+                    transId: transactionId,
+                    invNo,
+                    batchNo: '',
+                    tid: '00000001',
+                    mid: '000000000000001',
+                    currency: request.currency,
+                    apprCode: '000001',
+                },
+                referenceId: `SIM-${Date.now()}`,
+                signature: 'simulated',
+            },
         };
     }
-    simulateQuery(transactionId, status) {
+    simulateQuery(transactionId, status, amount = 0, currency = 'SGD') {
+        const now = new Date();
+        const invNo = now.toISOString().replace(/[-:T]/g, '').slice(0, 14);
         return {
             transactionId,
             status,
-            amount: 0,
-            currency: 'MYR',
-            metadata: { simulated: true },
-            raw: { simulated: true },
+            amount,
+            currency,
+            payment_source_method: 'Mastercard',
+            payment_source_last4: '2066',
+            payment_source_charge_ref: transactionId,
+            metadata: {
+                responseCode: '00',
+                responseText: 'Approved',
+                paymentChannel: 'Mastercard',
+                invNo,
+                tid: '00000001',
+                mid: '000000000000001',
+                cardNo: '************2066',
+                entryMode: 'contactless',
+                cardLabel: 'Mastercard',
+            },
+            raw: {
+                transType: 'sale',
+                posId: 'SIM_POS_ID',
+                deviceId: 'SIM_DEVICE_ID',
+                apiVersion: 'v1',
+                statusCode: '00',
+                responseCode: '00',
+                responseText: 'Approved',
+                terminalSn: 'SIM_TERMINAL',
+                softwareVersion: 'Version 1.0.0',
+                transData: {
+                    cardNo: '************2066',
+                    entryMode: 'contactless',
+                    rrn: '000000000001',
+                    cardLabel: 'Mastercard',
+                    paymentChannel: 'Mastercard',
+                    transAmt: amount.toFixed(2),
+                    transDateTime: now.toISOString().slice(0, 19),
+                    transId: transactionId,
+                    invNo,
+                    tid: '00000001',
+                    mid: '000000000000001',
+                    currency,
+                },
+                referenceId: `SIM-${Date.now()}`,
+                signature: 'simulated',
+            },
         };
     }
     getGatewayName(method) {

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { LitePosPayment, validateConfig } from './client';
-export { CancelResponse, PaymentRequest, PaymentResponse, RefundResponse, ValidationResult, } from './interfaces';
+export { CancelResponse, PaymentRequest, PaymentResponse, RefundResponse, ValidationResult, VoidResponse, } from './interfaces';
 export { Simulator } from './simulator';
 export type { PaymentConfig } from './types/config';
 export { PaymentError, ValidationError } from './types/error';
-export { CancelStatus, PaymentStatus, RefundStatus } from './types/status';
+export { CancelStatus, PaymentStatus, RefundStatus, VoidStatus } from './types/status';
 export { logError, logInfo } from './utils/logger';

package/dist/index.js

@@ -3,6 +3,6 @@ export { LitePosPayment, validateConfig } from './client';
 export { Simulator } from './simulator';
 export { PaymentError, ValidationError } from './types/error';
 // Type exports
-export { CancelStatus, PaymentStatus, RefundStatus } from './types/status';
+export { CancelStatus, PaymentStatus, RefundStatus, VoidStatus } from './types/status';
 // Logger exports
 export { logError, logInfo } from './utils/logger';

package/dist/interfaces.d.ts

@@ -1,4 +1,4 @@
-import type { CancelStatus, PaymentStatus, RefundStatus } from './types/status';
+import type { CancelStatus, PaymentStatus, RefundStatus, VoidStatus } from './types/status';
 export interface PaymentRequest {
     method: string;
     amount: number;
@@ -35,6 +35,16 @@ export interface CancelResponse {
     metadata?: Record<string, unknown>;
     raw?: unknown;
 }
+export interface VoidResponse {
+    voidId: string;
+    transactionId: string;
+    status: VoidStatus;
+    amount: number;
+    currency: string;
+    voidedAt?: Date;
+    metadata?: Record<string, unknown>;
+    raw?: unknown;
+}
 export interface ValidationResult {
     valid: boolean;
     errors?: string[];

package/dist/types/status.d.ts

@@ -13,3 +13,8 @@ export declare enum CancelStatus {
     Success = "success",
     Failed = "failed"
 }
+export declare enum VoidStatus {
+    Pending = "pending",
+    Success = "success",
+    Failed = "failed"
+}

package/dist/types/status.js

@@ -19,3 +19,10 @@ export var CancelStatus;
     CancelStatus["Success"] = "success";
     CancelStatus["Failed"] = "failed";
 })(CancelStatus || (CancelStatus = {}));
+// Void status enumeration
+export var VoidStatus;
+(function (VoidStatus) {
+    VoidStatus["Pending"] = "pending";
+    VoidStatus["Success"] = "success";
+    VoidStatus["Failed"] = "failed";
+})(VoidStatus || (VoidStatus = {}));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@litepos/payment",
   "type": "module",
-  "version": "1.0.12",
+  "version": "1.0.15",
   "description": "LitePOS payment gateway SDK - Core package",
   "author": "",
   "license": "MIT",
@@ -25,7 +25,7 @@
     "dist"
   ],
   "dependencies": {
-    "@litepos/payment-fiuu": "1.0.12"
+    "@litepos/payment-fiuu": "1.0.15"
   },
   "devDependencies": {
     "typescript": "^5.9.2",