@muhammedaksam/sipay-node 1.0.5 → 1.1.0

package/dist/utils/index.js

@@ -32,39 +32,43 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateHashKey = generateHashKey;
+exports.luhnCheck = luhnCheck;
 exports.validateCreditCard = validateCreditCard;
+exports.maskCardNumber = maskCardNumber;
 exports.formatAmount = formatAmount;
+exports.formatAmountForHash = formatAmountForHash;
+exports.generatePaymentHashKey = generatePaymentHashKey;
+exports.generateStatusHashKey = generateStatusHashKey;
+exports.generateConfirmPaymentHashKey = generateConfirmPaymentHashKey;
+exports.generateHashKey = generateHashKey;
 exports.generateInvoiceId = generateInvoiceId;
 exports.validatePaymentData = validatePaymentData;
 exports.maskCreditCard = maskCreditCard;
 exports.parseSipayError = parseSipayError;
+exports.validateHashKey = validateHashKey;
+exports.generateServerFormatHashKey = generateServerFormatHashKey;
 const crypto = __importStar(require("crypto"));
+const { createHash, createCipheriv, createDecipheriv } = crypto;
 /**
  * Utility functions for Sipay SDK
  */
-/**
- * Generate hash key for payment requests
- * Based on Sipay documentation requirements
- */
-function generateHashKey(merchantKey, invoiceId, amount, secretKey) {
-    const hashString = `${merchantKey}${invoiceId}${amount}${secretKey}`;
-    return crypto.createHash('sha256').update(hashString).digest('hex');
-}
 /**
  * Validate credit card number using Luhn algorithm
  */
-function validateCreditCard(cardNumber) {
-    const num = cardNumber.replace(/\D/g, '');
-    // Check if empty or less than 13 digits
-    if (num.length < 13 || num.length > 19) {
+function luhnCheck(cardNumber) {
+    const digits = cardNumber.replace(/\D/g, '').split('').map(Number);
+    // Check minimum length
+    if (digits.length < 13 || digits.length > 19) {
         return false;
     }
     let sum = 0;
     let isEven = false;
-    for (let i = num.length - 1; i >= 0; i--) {
-        let digit = parseInt(num.charAt(i), 10);
+    for (let i = digits.length - 1; i >= 0; i--) {
+        let digit = digits[i];
         if (isEven) {
             digit *= 2;
             if (digit > 9) {
@@ -77,11 +81,100 @@ function validateCreditCard(cardNumber) {
     return sum % 10 === 0;
 }
 /**
- * Format currency amount for Sipay API
+ * Validate credit card number (alias for luhnCheck)
+ */
+function validateCreditCard(cardNumber) {
+    return luhnCheck(cardNumber);
+}
+/**
+ * Mask credit card number for display
+ */
+function maskCardNumber(cardNumber) {
+    const cleaned = cardNumber.replace(/\D/g, '');
+    if (cleaned.length < 8)
+        return cleaned;
+    const first4 = cleaned.slice(0, 4);
+    const last4 = cleaned.slice(-4);
+    const middle = '*'.repeat(cleaned.length - 8);
+    return `${first4}${middle}${last4}`;
+}
+/**
+ * Format amount for Sipay API - amounts should be sent as numbers, not cents
  */
 function formatAmount(amount) {
+    // Amount should be formatted as a float with proper decimal places
+    // For amounts like 100.00, it should be "100.00", not "1.00"
     return amount.toFixed(2);
 }
+/**
+ * Format amount specifically for hash key generation
+ * This should match PHP's number_format($amount, 2, ".", "") exactly
+ * PHP always formats with 2 decimal places: 10.00, 125.50, etc.
+ */
+function formatAmountForHash(amount) {
+    // Match PHP number_format($amount, 2, ".", "") - always 2 decimal places
+    return amount.toFixed(2);
+}
+/**
+ * Generate hash key for payment requests
+ * Order matches PHP SDK CreateNonSecurePaymentRequest::generateHashKeyParts():
+ * 1. total, 2. installments_number, 3. currency_code, 4. merchant_key, 5. invoice_id
+ */
+function generatePaymentHashKey(total, installment, currencyCode, merchantKey, invoiceId, apiSecret) {
+    const parts = [
+        formatAmountForHash(total),
+        installment.toString(),
+        currencyCode,
+        merchantKey,
+        invoiceId,
+    ];
+    return generateHashKey(parts, apiSecret);
+}
+/**
+ * Generate hash key for status check requests
+ * Order matches PHP SDK CheckTransactionStatusRequest::generateHashKeyParts():
+ * 1. invoice_id, 2. merchant_key
+ */
+function generateStatusHashKey(invoiceId, merchantKey, apiSecret) {
+    const parts = [invoiceId, merchantKey];
+    return generateHashKey(parts, apiSecret);
+}
+/**
+ * Generate hash key for payment confirmation requests
+ * Order matches PHP SDK: merchant_key|invoice_id|status
+ */
+function generateConfirmPaymentHashKey(merchantKey, invoiceId, status, apiSecret) {
+    const parts = [merchantKey, invoiceId, status.toString()];
+    return generateHashKey(parts, apiSecret);
+}
+/**
+ * Generate hash key for payment requests
+ * Exact 1:1 Node.js implementation of PHP's generateHashKey function
+ * Matches: $total . '|' . $installment . '|' . $currency_code . '|' . $merchant_key . '|' . $invoice_id
+ * with openssl_encrypt('aes-256-cbc') encryption
+ */
+function generateHashKey(parts, appSecret) {
+    const data = parts.join('|');
+    // Generate IV using SHA1 hash of random value
+    const iv = createHash('sha1').update(String(Math.random())).digest('hex').slice(0, 16);
+    // Generate password using SHA1 hash of app secret
+    const password = createHash('sha1').update(appSecret).digest('hex');
+    // Generate salt using SHA1 hash of random value
+    const salt = createHash('sha1').update(String(Math.random())).digest('hex').slice(0, 4);
+    // Create encryption key using SHA256 hash of password and salt
+    const saltWithPassword = createHash('sha256')
+        .update(password + salt)
+        .digest('hex')
+        .slice(0, 32);
+    // Encrypt data using AES-256-CBC
+    const cipher = createCipheriv('aes-256-cbc', saltWithPassword, iv);
+    let encrypted = cipher.update(data, 'binary', 'base64');
+    encrypted += cipher.final('base64');
+    // Bundle components and replace forward slashes with double underscores
+    let msgEncryptedBundle = `${iv}:${salt}:${encrypted}`;
+    msgEncryptedBundle = msgEncryptedBundle.replace(/\//g, '__');
+    return msgEncryptedBundle;
+}
 /**
  * Generate a unique invoice ID
  */
@@ -175,4 +268,65 @@ function parseSipayError(error) {
         message: error.message || 'Network error',
     };
 }
+/**
+ * Validate hash key using server-side validation logic
+ * This matches exactly what the PHP SDK does for server-side validation
+ * Expected decrypted format: status|total|invoiceId|orderId|currencyCode
+ */
+function validateHashKey(hashKey, secretKey) {
+    let status = '';
+    let currencyCode = '';
+    let total = 0;
+    let invoiceId = '';
+    let orderId = 0;
+    if (!hashKey) {
+        return [status, total, invoiceId, orderId, currencyCode];
+    }
+    try {
+        // Replace underscores with forward slashes (PHP compatibility)
+        const normalizedHashKey = hashKey.replace(/_/g, '/');
+        const password = createHash('sha1').update(secretKey).digest('hex');
+        const components = normalizedHashKey.split(':');
+        if (components.length > 2) {
+            const iv = components[0] || '';
+            const saltHex = components[1] || '';
+            const encryptedMsg = components[2] || '';
+            // Generate salt exactly like PHP: hash('sha256', $password . $salt)
+            const saltWithPassword = createHash('sha256')
+                .update(password + saltHex)
+                .digest('hex');
+            // Create decipher with proper parameters
+            // PHP's openssl_decrypt expects:
+            // - IV as raw ASCII bytes (16-char hex string treated as ASCII)
+            // - Key as binary from hex string (32 bytes for AES-256)
+            const decipher = createDecipheriv('aes-256-cbc', Buffer.from(saltWithPassword, 'hex').slice(0, 32), // 32-byte key from hex
+            Buffer.from(iv, 'ascii') // IV: 16-char hex string as ASCII bytes
+            );
+            let decrypted = decipher.update(encryptedMsg, 'base64', 'utf8');
+            decrypted += decipher.final('utf8');
+            if (decrypted.includes('|')) {
+                const array = decrypted.split('|');
+                status = array[0] || '0';
+                total = parseFloat(array[1] || '0');
+                invoiceId = array[2] || '0';
+                orderId = parseInt(array[3] || '0');
+                currencyCode = array[4] || '';
+            }
+        }
+    }
+    catch {
+        // Silently handle decryption errors
+    }
+    return [status, total, invoiceId, orderId, currencyCode];
+}
+/**
+ * Generate hash key in server validation format
+ * Server expects: status|total|invoiceId|orderId|currencyCode
+ */
+function generateServerFormatHashKey(status, total, invoiceId, orderId, currencyCode, appSecret) {
+    const parts = [status, formatAmountForHash(total), invoiceId, orderId.toString(), currencyCode];
+    return generateHashKey(parts, appSecret);
+}
+// Export status code helpers
+__exportStar(require("./status-code-helpers"), exports);
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,0CAQC;AAKD,gDA0BC;AAKD,oCAEC;AAKD,8CAIC;AAKD,kDAsDC;AAKD,wCAmBC;AAKD,0CAaC;AAtKD,+CAAiC;AAEjC;;GAEG;AAEH;;;GAGG;AACH,SAAgB,eAAe,CAC7B,WAAmB,EACnB,SAAiB,EACjB,MAAc,EACd,SAAiB;IAEjB,MAAM,UAAU,GAAG,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,EAAE,CAAC;IACrE,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACtE,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,UAAkB;IACnD,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAE1C,wCAAwC;IACxC,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,IAAI,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAExC,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,IAAI,CAAC,CAAC;YACX,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACd,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;QACH,CAAC;QAED,GAAG,IAAI,KAAK,CAAC;QACb,MAAM,GAAG,CAAC,MAAM,CAAC;IACnB,CAAC;IAED,OAAO,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,MAAc;IACzC,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,MAAM,GAAG,KAAK;IAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;IACjD,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,IAAS;IAC3C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,cAAc,GAAG;QACrB,gBAAgB;QAChB,OAAO;QACP,cAAc;QACd,aAAa;QACb,eAAe;QACf,YAAY;QACZ,OAAO;QACP,MAAM;QACN,SAAS;QACT,OAAO;KACR,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC5C,CAAC;IAED,kBAAkB;IAClB,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAChC,CAAC;IAED,oBAAoB;IACpB,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC9C,IAAI,IAAI,CAAC,aAAa,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QACxE,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACvC,CAAC;IAED,kBAAkB;IAClB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAC9C,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC7C,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,WAAW,IAAI,IAAI,GAAG,WAAW,GAAG,EAAE,EAAE,CAAC;YACjE,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,UAAkB;IAC/C,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAE1C,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACpB,MAAM,UAAU,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC9C,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAEvD,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,EAAE,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,KAAU;IACxC,IAAI,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;QACzB,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC;YAC1C,OAAO,EACL,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,IAAI,eAAe;SAC3F,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,CAAC;QACP,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,eAAe;KAC1C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"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"}

package/dist/utils/status-code-helpers.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Sipay Status Code Utilities
+ * Helper functions for working with Sipay API status codes
+ */
+import { SipayStatusCode, SipayStatusCategory } from '../types/status-codes';
+/**
+ * Enhanced error information for status codes
+ */
+export interface StatusCodeInfo {
+    code: number;
+    description: string;
+    category: SipayStatusCategory;
+    isSuccess: boolean;
+    isError: boolean;
+    isRetryable: boolean;
+    httpEquivalent?: number;
+}
+/**
+ * Get comprehensive information about a status code
+ */
+export declare function getStatusCodeInfo(statusCode: number): StatusCodeInfo;
+/**
+ * Common status code groups for easy checking
+ */
+export declare const StatusCodeGroups: {
+    readonly SUCCESS: readonly [SipayStatusCode.SUCCESSFUL, SipayStatusCode.REFUND_REQUEST_CREATED, SipayStatusCode.PARTIALLY_SUCCESSFUL];
+    readonly VALIDATION_ERRORS: readonly [SipayStatusCode.BASIC_VALIDATION, SipayStatusCode.ITEMS_VALIDATION_ERROR, SipayStatusCode.PRICE_TOTAL_MISMATCH, SipayStatusCode.QUANTITY_MUST_BE_INTEGER, SipayStatusCode.INVALID_INVOICE_ID, SipayStatusCode.INVALID_CHARACTER, SipayStatusCode.INVALID_CARD_NUMBER, SipayStatusCode.CANCELLATION_URL_SHOULD_NOT_BE_BLANK];
+    readonly PAYMENT_ERRORS: readonly [SipayStatusCode.ORDER_FAILED, SipayStatusCode.PAYMENT_TERM_NOT_SET, SipayStatusCode.REFUND_FAILED, SipayStatusCode.TRANSACTION_NOT_FOUND, SipayStatusCode.ORDER_NOT_YET_PROCESSED, SipayStatusCode.TRANSACTION_NOT_APPROVED];
+    readonly MERCHANT_LIMIT_ERRORS: readonly [SipayStatusCode.CREDIT_CARD_BLOCKED, SipayStatusCode.MERCHANT_DAILY_AMOUNT_LIMIT_EXCEEDED, SipayStatusCode.MERCHANT_MONTHLY_TRANSACTION_LIMIT_EXCEEDED, SipayStatusCode.MERCHANT_MONTHLY_AMOUNT_LIMIT_EXCEEDED, SipayStatusCode.MINIMUM_TRANSACTION_LIMIT_VIOLATED];
+    readonly CARD_ERRORS: readonly [SipayStatusCode.CREDIT_CARD_BLOCKED, SipayStatusCode.MERCHANT_CARD_TRANSACTION_NOT_ALLOWED, SipayStatusCode.CARD_PROGRAM_MISMATCH, SipayStatusCode.FOREIGN_CARDS_NOT_ALLOWED, SipayStatusCode.NO_FOREIGN_CARD_COMMISSION];
+    readonly HASH_KEY_ERRORS: readonly [SipayStatusCode.HASH_KEY_VALIDATION_ERROR, SipayStatusCode.INVALID_HASH_KEY, SipayStatusCode.HASH_KEY_MERCHANT_KEY_MISMATCH, SipayStatusCode.HASH_KEY_CUSTOMER_NUMBER_MISMATCH, SipayStatusCode.HASH_KEY_CARD_HOLDER_NAME_MISMATCH, SipayStatusCode.HASH_KEY_CARD_NUMBER_MISMATCH, SipayStatusCode.HASH_KEY_EXPIRY_MONTH_MISMATCH, SipayStatusCode.HASH_KEY_EXPIRY_YEAR_MISMATCH, SipayStatusCode.HASH_KEY_CARD_TOKEN_MISMATCH];
+    readonly RETRYABLE_ERRORS: readonly [SipayStatusCode.ORDER_NOT_YET_PROCESSED, SipayStatusCode.INVOICE_ID_ALREADY_PROCESSED, SipayStatusCode.INVOICE_ID_ALREADY_PROCESSED_ALT, SipayStatusCode.REFUND_FAILED];
+};
+/**
+ * Check if status code is in a specific group
+ */
+export declare function isStatusInGroup(statusCode: number, group: readonly number[]): boolean;
+/**
+ * Get suggested actions based on status code
+ */
+export declare function getSuggestedAction(statusCode: number): string;
+//# sourceMappingURL=status-code-helpers.d.ts.map

package/dist/utils/status-code-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-code-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/status-code-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,eAAe,EACf,mBAAmB,EAMpB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAUpE;AAsDD;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;CA6DnB,CAAC;AAEX;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAErF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAkC7D"}

package/dist/utils/status-code-helpers.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * Sipay Status Code Utilities
+ * Helper functions for working with Sipay API status codes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatusCodeGroups = void 0;
+exports.getStatusCodeInfo = getStatusCodeInfo;
+exports.isStatusInGroup = isStatusInGroup;
+exports.getSuggestedAction = getSuggestedAction;
+const status_codes_1 = require("../types/status-codes");
+/**
+ * Get comprehensive information about a status code
+ */
+function getStatusCodeInfo(statusCode) {
+    return {
+        code: statusCode,
+        description: (0, status_codes_1.getStatusDescription)(statusCode),
+        category: (0, status_codes_1.getStatusCategory)(statusCode),
+        isSuccess: (0, status_codes_1.isSuccessStatus)(statusCode),
+        isError: (0, status_codes_1.isErrorStatus)(statusCode),
+        isRetryable: (0, status_codes_1.isRetryableStatus)(statusCode),
+        httpEquivalent: getHttpEquivalent(statusCode),
+    };
+}
+/**
+ * Map Sipay status codes to HTTP status codes where applicable
+ */
+function getHttpEquivalent(statusCode) {
+    switch (statusCode) {
+        case status_codes_1.SipayStatusCode.SUCCESSFUL:
+        case status_codes_1.SipayStatusCode.REFUND_REQUEST_CREATED:
+        case status_codes_1.SipayStatusCode.PARTIALLY_SUCCESSFUL:
+            return 200; // OK
+        case status_codes_1.SipayStatusCode.BASIC_VALIDATION:
+        case status_codes_1.SipayStatusCode.ITEMS_VALIDATION_ERROR:
+        case status_codes_1.SipayStatusCode.PRICE_TOTAL_MISMATCH:
+        case status_codes_1.SipayStatusCode.QUANTITY_MUST_BE_INTEGER:
+        case status_codes_1.SipayStatusCode.INVALID_INVOICE_ID:
+        case status_codes_1.SipayStatusCode.INVALID_CHARACTER:
+        case status_codes_1.SipayStatusCode.INVALID_CARD_NUMBER:
+        case status_codes_1.SipayStatusCode.CANCELLATION_URL_SHOULD_NOT_BE_BLANK:
+            return 400; // Bad Request
+        case status_codes_1.SipayStatusCode.INVALID_CREDENTIALS:
+        case status_codes_1.SipayStatusCode.INVALID_TOKEN_OR_CLIENT_NUMBER:
+            return 401; // Unauthorized
+        case status_codes_1.SipayStatusCode.PAYMENT_INTEGRATION_NOT_ALLOWED:
+        case status_codes_1.SipayStatusCode.MERCHANT_NOT_ALLOWED_TOKEN_PAYMENT:
+        case status_codes_1.SipayStatusCode.MERCHANT_CARD_TRANSACTION_NOT_ALLOWED:
+        case status_codes_1.SipayStatusCode.FOREIGN_CARDS_NOT_ALLOWED:
+            return 403; // Forbidden
+        case status_codes_1.SipayStatusCode.MERCHANT_NOT_FOUND:
+        case status_codes_1.SipayStatusCode.TRANSACTION_NOT_FOUND:
+        case status_codes_1.SipayStatusCode.POS_NOT_FOUND:
+        case status_codes_1.SipayStatusCode.COMMISSION_NOT_FOUND:
+        case status_codes_1.SipayStatusCode.INSTALLMENT_NOT_FOUND:
+        case status_codes_1.SipayStatusCode.SUB_MERCHANT_NOT_FOUND:
+            return 404; // Not Found
+        case status_codes_1.SipayStatusCode.INVOICE_ID_ALREADY_PROCESSED:
+        case status_codes_1.SipayStatusCode.INVOICE_ID_ALREADY_PROCESSED_ALT:
+            return 409; // Conflict
+        case status_codes_1.SipayStatusCode.UNKNOWN_ERROR:
+        case status_codes_1.SipayStatusCode.CURRENCY_CONVERSION_FAILED:
+        case status_codes_1.SipayStatusCode.FILE_PROCESSING_ERROR:
+            return 500; // Internal Server Error
+        default:
+            return undefined;
+    }
+}
+/**
+ * Common status code groups for easy checking
+ */
+exports.StatusCodeGroups = {
+    SUCCESS: [
+        status_codes_1.SipayStatusCode.SUCCESSFUL,
+        status_codes_1.SipayStatusCode.REFUND_REQUEST_CREATED,
+        status_codes_1.SipayStatusCode.PARTIALLY_SUCCESSFUL,
+    ],
+    VALIDATION_ERRORS: [
+        status_codes_1.SipayStatusCode.BASIC_VALIDATION,
+        status_codes_1.SipayStatusCode.ITEMS_VALIDATION_ERROR,
+        status_codes_1.SipayStatusCode.PRICE_TOTAL_MISMATCH,
+        status_codes_1.SipayStatusCode.QUANTITY_MUST_BE_INTEGER,
+        status_codes_1.SipayStatusCode.INVALID_INVOICE_ID,
+        status_codes_1.SipayStatusCode.INVALID_CHARACTER,
+        status_codes_1.SipayStatusCode.INVALID_CARD_NUMBER,
+        status_codes_1.SipayStatusCode.CANCELLATION_URL_SHOULD_NOT_BE_BLANK,
+    ],
+    PAYMENT_ERRORS: [
+        status_codes_1.SipayStatusCode.ORDER_FAILED,
+        status_codes_1.SipayStatusCode.PAYMENT_TERM_NOT_SET,
+        status_codes_1.SipayStatusCode.REFUND_FAILED,
+        status_codes_1.SipayStatusCode.TRANSACTION_NOT_FOUND,
+        status_codes_1.SipayStatusCode.ORDER_NOT_YET_PROCESSED,
+        status_codes_1.SipayStatusCode.TRANSACTION_NOT_APPROVED,
+    ],
+    MERCHANT_LIMIT_ERRORS: [
+        status_codes_1.SipayStatusCode.MERCHANT_DAILY_TRANSACTION_LIMIT_EXCEEDED,
+        status_codes_1.SipayStatusCode.MERCHANT_DAILY_AMOUNT_LIMIT_EXCEEDED,
+        status_codes_1.SipayStatusCode.MERCHANT_MONTHLY_TRANSACTION_LIMIT_EXCEEDED,
+        status_codes_1.SipayStatusCode.MERCHANT_MONTHLY_AMOUNT_LIMIT_EXCEEDED,
+        status_codes_1.SipayStatusCode.MINIMUM_TRANSACTION_LIMIT_VIOLATED,
+    ],
+    CARD_ERRORS: [
+        status_codes_1.SipayStatusCode.CREDIT_CARD_BLOCKED,
+        status_codes_1.SipayStatusCode.MERCHANT_CARD_TRANSACTION_NOT_ALLOWED,
+        status_codes_1.SipayStatusCode.CARD_PROGRAM_MISMATCH,
+        status_codes_1.SipayStatusCode.FOREIGN_CARDS_NOT_ALLOWED,
+        status_codes_1.SipayStatusCode.NO_FOREIGN_CARD_COMMISSION,
+    ],
+    HASH_KEY_ERRORS: [
+        status_codes_1.SipayStatusCode.HASH_KEY_VALIDATION_ERROR,
+        status_codes_1.SipayStatusCode.INVALID_HASH_KEY,
+        status_codes_1.SipayStatusCode.HASH_KEY_MERCHANT_KEY_MISMATCH,
+        status_codes_1.SipayStatusCode.HASH_KEY_CUSTOMER_NUMBER_MISMATCH,
+        status_codes_1.SipayStatusCode.HASH_KEY_CARD_HOLDER_NAME_MISMATCH,
+        status_codes_1.SipayStatusCode.HASH_KEY_CARD_NUMBER_MISMATCH,
+        status_codes_1.SipayStatusCode.HASH_KEY_EXPIRY_MONTH_MISMATCH,
+        status_codes_1.SipayStatusCode.HASH_KEY_EXPIRY_YEAR_MISMATCH,
+        status_codes_1.SipayStatusCode.HASH_KEY_CARD_TOKEN_MISMATCH,
+    ],
+    RETRYABLE_ERRORS: [
+        status_codes_1.SipayStatusCode.ORDER_NOT_YET_PROCESSED,
+        status_codes_1.SipayStatusCode.INVOICE_ID_ALREADY_PROCESSED,
+        status_codes_1.SipayStatusCode.INVOICE_ID_ALREADY_PROCESSED_ALT,
+        status_codes_1.SipayStatusCode.MAXIMUM_TRANSACTION_LIMIT_VIOLATED,
+    ],
+};
+/**
+ * Check if status code is in a specific group
+ */
+function isStatusInGroup(statusCode, group) {
+    return group.includes(statusCode);
+}
+/**
+ * Get suggested actions based on status code
+ */
+function getSuggestedAction(statusCode) {
+    const info = getStatusCodeInfo(statusCode);
+    switch (info.category) {
+        case status_codes_1.SipayStatusCategory.SUCCESS:
+            return 'Transaction completed successfully';
+        case status_codes_1.SipayStatusCategory.VALIDATION_ERROR:
+            return 'Check request parameters and fix validation errors';
+        case status_codes_1.SipayStatusCategory.AUTHENTICATION_ERROR:
+            return 'Verify API credentials and merchant configuration';
+        case status_codes_1.SipayStatusCategory.PAYMENT_ERROR:
+            if (info.isRetryable) {
+                return 'Transaction may be retried after a short delay';
+            }
+            return 'Check payment details and try with different parameters';
+        case status_codes_1.SipayStatusCategory.MERCHANT_ERROR:
+            return 'Contact your payment provider to resolve merchant configuration issues';
+        case status_codes_1.SipayStatusCategory.CARD_ERROR:
+            return 'Try with a different card or contact the card issuer';
+        case status_codes_1.SipayStatusCategory.HASH_ERROR:
+            return 'Verify hash key generation parameters and algorithm';
+        case status_codes_1.SipayStatusCategory.RECURRING_ERROR:
+            return 'Check recurring payment configuration and parameters';
+        default:
+            return 'Contact technical support for assistance';
+    }
+}
+//# sourceMappingURL=status-code-helpers.js.map

package/dist/utils/status-code-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-code-helpers.js","sourceRoot":"","sources":["../../src/utils/status-code-helpers.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@muhammedaksam/sipay-node",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "description": "Node.js TypeScript SDK for Sipay payment gateway",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -35,22 +35,22 @@
   },
   "homepage": "https://github.com/muhammedaksam/sipay-node#readme",
   "devDependencies": {
-    "@eslint/js": "^9.34.0",
+    "@eslint/js": "^9.36.0",
     "@types/jest": "^30.0.0",
-    "@types/node": "^24.3.0",
-    "@typescript-eslint/eslint-plugin": "^8.41.0",
-    "@typescript-eslint/parser": "^8.41.0",
-    "eslint": "^9.34.0",
-    "jest": "^30.0.5",
+    "@types/node": "^24.5.2",
+    "@typescript-eslint/eslint-plugin": "^8.44.0",
+    "@typescript-eslint/parser": "^8.44.0",
+    "eslint": "^9.36.0",
+    "jest": "^30.1.3",
     "prettier": "^3.6.2",
     "rimraf": "^6.0.1",
-    "ts-jest": "^29.4.1",
+    "ts-jest": "^29.4.4",
     "ts-node": "^10.9.2",
     "tsx": "^4.20.5",
     "typescript": "^5.9.2"
   },
   "dependencies": {
-    "axios": "^1.11.0"
+    "axios": "^1.12.2"
   },
   "engines": {
     "node": ">=18"
@@ -64,6 +64,8 @@
     "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
+    "test:integration": "npx tsx test/integration/test-runner.ts",
+    "test:final": "npx tsx examples/final-payment-test.ts",
     "lint": "eslint src test examples --ext .ts",
     "lint:fix": "eslint src test examples --ext .ts --fix",
     "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\" \"examples/**/*.ts\"",