npm - @muhammedaksam/sipay-node - Versions diffs - 1.1.2 → 1.1.3 - Mend

@muhammedaksam/sipay-node 1.1.2 → 1.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

package/dist/esm/index.js +3 -0
package/dist/esm/index.js.map +1 -1
package/dist/esm/resources/webhooks.js +147 -0
package/dist/esm/resources/webhooks.js.map +1 -0
package/dist/index.d.ts +3 -0
package/dist/index.d.ts.map +1 -1
package/dist/index.js +5 -1
package/dist/index.js.map +1 -1
package/dist/resources/webhooks.d.ts +96 -0
package/dist/resources/webhooks.d.ts.map +1 -0
package/dist/resources/webhooks.js +151 -0
package/dist/resources/webhooks.js.map +1 -0
package/package.json +1 -1

package/dist/esm/index.js CHANGED Viewed

@@ -8,6 +8,7 @@ import { PaymentCompletion } from './resources/payment-completion';
 import { Marketplace } from './resources/marketplace';
 import { Cashout } from './resources/cashout';
 import { SubMerchant } from './resources/sub-merchant';
+import { SipayWebhooks } from './resources/webhooks';
 export class Sipay {
     constructor(config) {
         this.client = new SipayHttpClient(config);
@@ -21,6 +22,7 @@ export class Sipay {
         this.marketplace = new Marketplace(this.client);
         this.cashout = new Cashout(this.client);
         this.subMerchant = new SubMerchant(this.client);
+        this.webhooks = new SipayWebhooks(this.client);
     }
     /**
      * Manually authenticate with Sipay API
@@ -57,5 +59,6 @@ export { PaymentCompletion } from './resources/payment-completion';
 export { Marketplace } from './resources/marketplace';
 export { Cashout } from './resources/cashout';
 export { SubMerchant } from './resources/sub-merchant';
+export { SipayWebhooks } from './resources/webhooks';
 export * from './utils';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;~~AAEvD~~,MAAM,OAAO,KAAK;~~IAahB~~,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;QAE1C,uBAAuB;QACvB,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,iBAAiB,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;~~IAClD~~,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,iBAAiB;AACjB,eAAe,KAAK,CAAC;AAErB,gBAAgB;AAChB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,cAAc,SAAS,CAAC"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,OAAO,KAAK;IAchB,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;QAE1C,uBAAuB;QACvB,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,iBAAiB,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,iBAAiB;AACjB,eAAe,KAAK,CAAC;AAErB,gBAAgB;AAChB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,cAAc,SAAS,CAAC"}

package/dist/esm/resources/webhooks.js ADDED Viewed

@@ -0,0 +1,147 @@
+import { SipayResource } from './base';
+import { validateHashKey } from '../utils';
+/**
+ * Webhooks resource for handling Sipay webhook events
+ * Provides methods to validate and parse webhook notifications
+ *
+ * Uses the existing validateHashKey utility from utils for hash validation,
+ * which provides full AES-256-CBC decryption compatible with PHP SDK
+ */
+export class SipayWebhooks extends SipayResource {
+    /**
+     * Validate webhook hash key to ensure request authenticity
+     * Uses the existing validateHashKey utility function
+     */
+    validateHashKey(hashKey, secretKey) {
+        try {
+            if (!hashKey) {
+                return { isValid: false, error: 'Hash key is required' };
+            }
+            // Use the existing validateHashKey function from utils
+            const [status, total, invoiceId, orderId, currencyCode] = validateHashKey(hashKey, secretKey);
+            // If we got valid data back, consider it a successful validation
+            const isValid = status !== '' || total !== 0 || invoiceId !== '' || orderId !== 0 || currencyCode !== '';
+            return {
+                isValid,
+                status,
+                total,
+                invoiceId,
+                orderId,
+                currencyCode,
+                error: isValid ? undefined : 'Hash validation failed',
+            };
+        }
+        catch (error) {
+            return {
+                isValid: false,
+                error: `Hash validation error: ${error.message}`,
+            };
+        }
+    }
+    /**
+     * Parse sales webhook payload
+     */
+    parseSalesWebhook(payload) {
+        return {
+            sipay_status: payload.sipay_status || '',
+            order_no: payload.order_no || '',
+            invoice_id: payload.invoice_id || '',
+            status_code: payload.status_code || '',
+            status_description: payload.status_description || '',
+            sipay_payment_method: payload.sipay_payment_method || '',
+            credit_card_no: payload.credit_card_no || '',
+            transaction_type: payload.transaction_type || 'Auth',
+            payment_status: payload.payment_status || '0',
+            payment_method: payload.payment_method || '1',
+            error_code: payload.error_code || '',
+            error: payload.error || '',
+            status: payload.status || '',
+            hash_key: payload.hash_key || '',
+        };
+    }
+    /**
+     * Parse recurring webhook payload
+     */
+    parseRecurringWebhook(payload) {
+        return {
+            merchant_key: payload.merchant_key || '',
+            invoice_id: payload.invoice_id || '',
+            order_id: payload.order_id || '',
+            product_price: parseFloat(payload.product_price) || 0,
+            plan_code: payload.plan_code || '',
+            recurring_number: payload.recurring_number || '',
+            status: payload.status || '',
+            attempts: payload.attempts || '',
+            action_date: payload.action_date || '',
+        };
+    }
+    /**
+     * Parse refund webhook payload
+     */
+    parseRefundWebhook(payload) {
+        return {
+            invoice_id: payload.invoice_id || '',
+            order_id: payload.order_id || '',
+            amount: parseFloat(payload.amount) || 0,
+            status: payload.status || '',
+            hash_key: payload.hash_key || '',
+        };
+    }
+    /**
+     * Verify sales webhook - validates hash and parses event
+     */
+    verifySalesWebhook(payload, appSecret) {
+        try {
+            const event = this.parseSalesWebhook(payload);
+            if (!event.hash_key) {
+                return { isValid: false, error: 'Missing hash key in webhook payload' };
+            }
+            const validation = this.validateHashKey(event.hash_key, appSecret);
+            return {
+                isValid: validation.isValid,
+                event: validation.isValid ? event : undefined,
+                validation,
+                error: validation.error,
+            };
+        }
+        catch (error) {
+            return {
+                isValid: false,
+                error: `Webhook verification failed: ${error.message}`,
+            };
+        }
+    }
+    /**
+     * Check if payment was successful based on webhook data
+     */
+    isPaymentSuccessful(event) {
+        return event.payment_status === '1' && event.status_code === '100';
+    }
+    /**
+     * Check if payment was pre-authorized (needs confirmation)
+     */
+    isPaymentPreAuthorized(event) {
+        return event.payment_status === '1' && event.transaction_type === 'Pre-Authorization';
+    }
+    /**
+     * Check if payment failed
+     */
+    isPaymentFailed(event) {
+        return event.payment_status === '0';
+    }
+    /**
+     * Get human-readable payment status
+     */
+    getPaymentStatusDescription(event) {
+        if (this.isPaymentSuccessful(event)) {
+            return event.transaction_type === 'Pre-Authorization'
+                ? 'Payment pre-authorized successfully - requires confirmation'
+                : 'Payment completed successfully';
+        }
+        if (this.isPaymentFailed(event)) {
+            return `Payment failed: ${event.status_description}`;
+        }
+        return `Payment status: ${event.status_description}`;
+    }
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/esm/resources/webhooks.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../../src/resources/webhooks.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts CHANGED Viewed

@@ -8,6 +8,7 @@ import { PaymentCompletion } from './resources/payment-completion';
 import { Marketplace } from './resources/marketplace';
 import { Cashout } from './resources/cashout';
 import { SubMerchant } from './resources/sub-merchant';
+import { SipayWebhooks } from './resources/webhooks';
 export declare class Sipay {
     private client;
     payments: Payments;
@@ -19,6 +20,7 @@ export declare class Sipay {
     marketplace: Marketplace;
     cashout: Cashout;
     subMerchant: SubMerchant;
+    webhooks: SipayWebhooks;
     constructor(config: SipayConfig);
     /**
      * Manually authenticate with Sipay API
@@ -47,5 +49,6 @@ export { PaymentCompletion } from './resources/payment-completion';
 export { Marketplace } from './resources/marketplace';
 export { Cashout } from './resources/cashout';
 export { SubMerchant } from './resources/sub-merchant';
+export { SipayWebhooks } from './resources/webhooks';
 export * from './utils';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;~~AAEvD~~,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAkB;IAEzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,eAAe,EAAE,eAAe,CAAC;IACjC,WAAW,EAAE,WAAW,CAAC;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;~~gBAEpB~~,MAAM,EAAE,WAAW;~~IAe~~/B;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC;;OAEG;IACH,QAAQ,IAAI,MAAM,GAAG,SAAS;IAI9B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAG9B;AAGD,eAAe,KAAK,CAAC;AAGrB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,cAAc,SAAS,CAAC"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAkB;IAEzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,eAAe,EAAE,eAAe,CAAC;IACjC,WAAW,EAAE,WAAW,CAAC;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,aAAa,CAAC;gBAEnB,MAAM,EAAE,WAAW;IAgB/B;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC;;OAEG;IACH,QAAQ,IAAI,MAAM,GAAG,SAAS;IAI9B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAG9B;AAGD,eAAe,KAAK,CAAC;AAGrB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,cAAc,SAAS,CAAC"}

package/dist/index.js CHANGED Viewed

@@ -14,7 +14,7 @@ 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.SubMerchant = exports.Cashout = exports.Marketplace = exports.PaymentCompletion = exports.Cards = exports.Commissions = exports.BrandedSolution = exports.Recurring = exports.Payments = exports.SipayResource = exports.SipayHttpClient = exports.Sipay = void 0;
+exports.SipayWebhooks = exports.SubMerchant = exports.Cashout = exports.Marketplace = exports.PaymentCompletion = exports.Cards = exports.Commissions = exports.BrandedSolution = exports.Recurring = exports.Payments = exports.SipayResource = exports.SipayHttpClient = exports.Sipay = void 0;
 const http_client_1 = require("./utils/http-client");
 const payments_1 = require("./resources/payments");
 const recurring_1 = require("./resources/recurring");
@@ -25,6 +25,7 @@ const payment_completion_1 = require("./resources/payment-completion");
 const marketplace_1 = require("./resources/marketplace");
 const cashout_1 = require("./resources/cashout");
 const sub_merchant_1 = require("./resources/sub-merchant");
+const webhooks_1 = require("./resources/webhooks");
 class Sipay {
     constructor(config) {
         this.client = new http_client_1.SipayHttpClient(config);
@@ -38,6 +39,7 @@ class Sipay {
         this.marketplace = new marketplace_1.Marketplace(this.client);
         this.cashout = new cashout_1.Cashout(this.client);
         this.subMerchant = new sub_merchant_1.SubMerchant(this.client);
+        this.webhooks = new webhooks_1.SipayWebhooks(this.client);
     }
     /**
      * Manually authenticate with Sipay API
@@ -86,5 +88,7 @@ var cashout_2 = require("./resources/cashout");
 Object.defineProperty(exports, "Cashout", { enumerable: true, get: function () { return cashout_2.Cashout; } });
 var sub_merchant_2 = require("./resources/sub-merchant");
 Object.defineProperty(exports, "SubMerchant", { enumerable: true, get: function () { return sub_merchant_2.SubMerchant; } });
+var webhooks_2 = require("./resources/webhooks");
+Object.defineProperty(exports, "SipayWebhooks", { enumerable: true, get: function () { return webhooks_2.SipayWebhooks; } });
 __exportStar(require("./utils"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qDAAsD;AAEtD,mDAAgD;AAChD,qDAAkD;AAClD,mEAA+D;AAC/D,yDAAsD;AACtD,6CAA0C;AAC1C,uEAAmE;AACnE,yDAAsD;AACtD,iDAA8C;AAC9C,2DAAuD;~~AAEvD~~,MAAa,KAAK;~~IAahB~~,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,6BAAe,CAAC,MAAM,CAAC,CAAC;QAE1C,uBAAuB;QACvB,IAAI,CAAC,QAAQ,GAAG,IAAI,mBAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,IAAI,qBAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,eAAe,GAAG,IAAI,kCAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,WAAW,GAAG,IAAI,yBAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,IAAI,aAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,iBAAiB,GAAG,IAAI,sCAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,CAAC,WAAW,GAAG,IAAI,yBAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,IAAI,iBAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,IAAI,0BAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;~~IAClD~~,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;CACF;~~AAjDD~~,~~sBAiDC~~;AAED,iBAAiB;AACjB,kBAAe,KAAK,CAAC;AAErB,gBAAgB;AAChB,0CAAwB;AACxB,mDAAsD;AAA7C,8GAAA,eAAe,OAAA;AACxB,yCAAiD;AAAxC,qGAAA,aAAa,OAAA;AACtB,iDAAgD;AAAvC,oGAAA,QAAQ,OAAA;AACjB,mDAAkD;AAAzC,sGAAA,SAAS,OAAA;AAClB,iEAA+D;AAAtD,mHAAA,eAAe,OAAA;AACxB,uDAAsD;AAA7C,0GAAA,WAAW,OAAA;AACpB,2CAA0C;AAAjC,8FAAA,KAAK,OAAA;AACd,qEAAmE;AAA1D,uHAAA,iBAAiB,OAAA;AAC1B,uDAAsD;AAA7C,0GAAA,WAAW,OAAA;AACpB,+CAA8C;AAArC,kGAAA,OAAO,OAAA;AAChB,yDAAuD;AAA9C,2GAAA,WAAW,OAAA;AACpB,0CAAwB"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qDAAsD;AAEtD,mDAAgD;AAChD,qDAAkD;AAClD,mEAA+D;AAC/D,yDAAsD;AACtD,6CAA0C;AAC1C,uEAAmE;AACnE,yDAAsD;AACtD,iDAA8C;AAC9C,2DAAuD;AACvD,mDAAqD;AAErD,MAAa,KAAK;IAchB,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,6BAAe,CAAC,MAAM,CAAC,CAAC;QAE1C,uBAAuB;QACvB,IAAI,CAAC,QAAQ,GAAG,IAAI,mBAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,IAAI,qBAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,eAAe,GAAG,IAAI,kCAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,WAAW,GAAG,IAAI,yBAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,IAAI,aAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,iBAAiB,GAAG,IAAI,sCAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,CAAC,WAAW,GAAG,IAAI,yBAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,IAAI,iBAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,IAAI,0BAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,IAAI,wBAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;CACF;AAnDD,sBAmDC;AAED,iBAAiB;AACjB,kBAAe,KAAK,CAAC;AAErB,gBAAgB;AAChB,0CAAwB;AACxB,mDAAsD;AAA7C,8GAAA,eAAe,OAAA;AACxB,yCAAiD;AAAxC,qGAAA,aAAa,OAAA;AACtB,iDAAgD;AAAvC,oGAAA,QAAQ,OAAA;AACjB,mDAAkD;AAAzC,sGAAA,SAAS,OAAA;AAClB,iEAA+D;AAAtD,mHAAA,eAAe,OAAA;AACxB,uDAAsD;AAA7C,0GAAA,WAAW,OAAA;AACpB,2CAA0C;AAAjC,8FAAA,KAAK,OAAA;AACd,qEAAmE;AAA1D,uHAAA,iBAAiB,OAAA;AAC1B,uDAAsD;AAA7C,0GAAA,WAAW,OAAA;AACpB,+CAA8C;AAArC,kGAAA,OAAO,OAAA;AAChB,yDAAuD;AAA9C,2GAAA,WAAW,OAAA;AACpB,iDAAqD;AAA5C,yGAAA,aAAa,OAAA;AACtB,0CAAwB"}

package/dist/resources/webhooks.d.ts ADDED Viewed

@@ -0,0 +1,96 @@
+import { SipayResource } from './base';
+export interface SalesWebhookEvent {
+    sipay_status: string;
+    order_no: string;
+    invoice_id: string;
+    status_code: string;
+    status_description: string;
+    sipay_payment_method: string;
+    credit_card_no: string;
+    transaction_type: 'Auth' | 'Pre-Authorization';
+    payment_status: '0' | '1';
+    payment_method: '1' | '2' | '3';
+    error_code: string;
+    error: string;
+    status: string;
+    hash_key: string;
+}
+export interface RecurringWebhookEvent {
+    merchant_key: string;
+    invoice_id: string;
+    order_id: string;
+    product_price: number;
+    plan_code: string;
+    recurring_number: string;
+    status: string;
+    attempts: string;
+    action_date: string;
+}
+export interface RefundWebhookEvent {
+    invoice_id: string;
+    order_id: string;
+    amount: number;
+    status: string;
+    hash_key: string;
+}
+export interface WebhookValidationResult {
+    isValid: boolean;
+    status?: string;
+    total?: number;
+    invoiceId?: string;
+    orderId?: number;
+    currencyCode?: string;
+    error?: string;
+}
+/**
+ * Webhooks resource for handling Sipay webhook events
+ * Provides methods to validate and parse webhook notifications
+ *
+ * Uses the existing validateHashKey utility from utils for hash validation,
+ * which provides full AES-256-CBC decryption compatible with PHP SDK
+ */
+export declare class SipayWebhooks extends SipayResource {
+    /**
+     * Validate webhook hash key to ensure request authenticity
+     * Uses the existing validateHashKey utility function
+     */
+    validateHashKey(hashKey: string, secretKey: string): WebhookValidationResult;
+    /**
+     * Parse sales webhook payload
+     */
+    parseSalesWebhook(payload: any): SalesWebhookEvent;
+    /**
+     * Parse recurring webhook payload
+     */
+    parseRecurringWebhook(payload: any): RecurringWebhookEvent;
+    /**
+     * Parse refund webhook payload
+     */
+    parseRefundWebhook(payload: any): RefundWebhookEvent;
+    /**
+     * Verify sales webhook - validates hash and parses event
+     */
+    verifySalesWebhook(payload: any, appSecret: string): {
+        isValid: boolean;
+        event?: SalesWebhookEvent;
+        validation?: WebhookValidationResult;
+        error?: string;
+    };
+    /**
+     * Check if payment was successful based on webhook data
+     */
+    isPaymentSuccessful(event: SalesWebhookEvent): boolean;
+    /**
+     * Check if payment was pre-authorized (needs confirmation)
+     */
+    isPaymentPreAuthorized(event: SalesWebhookEvent): boolean;
+    /**
+     * Check if payment failed
+     */
+    isPaymentFailed(event: SalesWebhookEvent): boolean;
+    /**
+     * Get human-readable payment status
+     */
+    getPaymentStatusDescription(event: SalesWebhookEvent): string;
+}
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/resources/webhooks.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/resources/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAGvC,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,GAAG,mBAAmB,CAAC;IAC/C,cAAc,EAAE,GAAG,GAAG,GAAG,CAAC;IAC1B,cAAc,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,aAAa;IAC9C;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,uBAAuB;IA8B5E;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,GAAG,GAAG,iBAAiB;IAmBlD;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,GAAG,GAAG,qBAAqB;IAc1D;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,GAAG,GAAG,kBAAkB;IAUpD;;OAEG;IACH,kBAAkB,CAChB,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,MAAM,GAChB;QACD,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,iBAAiB,CAAC;QAC1B,UAAU,CAAC,EAAE,uBAAuB,CAAC;QACrC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;IAwBD;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO;IAItD;;OAEG;IACH,sBAAsB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO;IAIzD;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO;IAIlD;;OAEG;IACH,2BAA2B,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM;CAa9D"}

package/dist/resources/webhooks.js ADDED Viewed

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SipayWebhooks = void 0;
+const base_1 = require("./base");
+const utils_1 = require("../utils");
+/**
+ * Webhooks resource for handling Sipay webhook events
+ * Provides methods to validate and parse webhook notifications
+ *
+ * Uses the existing validateHashKey utility from utils for hash validation,
+ * which provides full AES-256-CBC decryption compatible with PHP SDK
+ */
+class SipayWebhooks extends base_1.SipayResource {
+    /**
+     * Validate webhook hash key to ensure request authenticity
+     * Uses the existing validateHashKey utility function
+     */
+    validateHashKey(hashKey, secretKey) {
+        try {
+            if (!hashKey) {
+                return { isValid: false, error: 'Hash key is required' };
+            }
+            // Use the existing validateHashKey function from utils
+            const [status, total, invoiceId, orderId, currencyCode] = (0, utils_1.validateHashKey)(hashKey, secretKey);
+            // If we got valid data back, consider it a successful validation
+            const isValid = status !== '' || total !== 0 || invoiceId !== '' || orderId !== 0 || currencyCode !== '';
+            return {
+                isValid,
+                status,
+                total,
+                invoiceId,
+                orderId,
+                currencyCode,
+                error: isValid ? undefined : 'Hash validation failed',
+            };
+        }
+        catch (error) {
+            return {
+                isValid: false,
+                error: `Hash validation error: ${error.message}`,
+            };
+        }
+    }
+    /**
+     * Parse sales webhook payload
+     */
+    parseSalesWebhook(payload) {
+        return {
+            sipay_status: payload.sipay_status || '',
+            order_no: payload.order_no || '',
+            invoice_id: payload.invoice_id || '',
+            status_code: payload.status_code || '',
+            status_description: payload.status_description || '',
+            sipay_payment_method: payload.sipay_payment_method || '',
+            credit_card_no: payload.credit_card_no || '',
+            transaction_type: payload.transaction_type || 'Auth',
+            payment_status: payload.payment_status || '0',
+            payment_method: payload.payment_method || '1',
+            error_code: payload.error_code || '',
+            error: payload.error || '',
+            status: payload.status || '',
+            hash_key: payload.hash_key || '',
+        };
+    }
+    /**
+     * Parse recurring webhook payload
+     */
+    parseRecurringWebhook(payload) {
+        return {
+            merchant_key: payload.merchant_key || '',
+            invoice_id: payload.invoice_id || '',
+            order_id: payload.order_id || '',
+            product_price: parseFloat(payload.product_price) || 0,
+            plan_code: payload.plan_code || '',
+            recurring_number: payload.recurring_number || '',
+            status: payload.status || '',
+            attempts: payload.attempts || '',
+            action_date: payload.action_date || '',
+        };
+    }
+    /**
+     * Parse refund webhook payload
+     */
+    parseRefundWebhook(payload) {
+        return {
+            invoice_id: payload.invoice_id || '',
+            order_id: payload.order_id || '',
+            amount: parseFloat(payload.amount) || 0,
+            status: payload.status || '',
+            hash_key: payload.hash_key || '',
+        };
+    }
+    /**
+     * Verify sales webhook - validates hash and parses event
+     */
+    verifySalesWebhook(payload, appSecret) {
+        try {
+            const event = this.parseSalesWebhook(payload);
+            if (!event.hash_key) {
+                return { isValid: false, error: 'Missing hash key in webhook payload' };
+            }
+            const validation = this.validateHashKey(event.hash_key, appSecret);
+            return {
+                isValid: validation.isValid,
+                event: validation.isValid ? event : undefined,
+                validation,
+                error: validation.error,
+            };
+        }
+        catch (error) {
+            return {
+                isValid: false,
+                error: `Webhook verification failed: ${error.message}`,
+            };
+        }
+    }
+    /**
+     * Check if payment was successful based on webhook data
+     */
+    isPaymentSuccessful(event) {
+        return event.payment_status === '1' && event.status_code === '100';
+    }
+    /**
+     * Check if payment was pre-authorized (needs confirmation)
+     */
+    isPaymentPreAuthorized(event) {
+        return event.payment_status === '1' && event.transaction_type === 'Pre-Authorization';
+    }
+    /**
+     * Check if payment failed
+     */
+    isPaymentFailed(event) {
+        return event.payment_status === '0';
+    }
+    /**
+     * Get human-readable payment status
+     */
+    getPaymentStatusDescription(event) {
+        if (this.isPaymentSuccessful(event)) {
+            return event.transaction_type === 'Pre-Authorization'
+                ? 'Payment pre-authorized successfully - requires confirmation'
+                : 'Payment completed successfully';
+        }
+        if (this.isPaymentFailed(event)) {
+            return `Payment failed: ${event.status_description}`;
+        }
+        return `Payment status: ${event.status_description}`;
+    }
+}
+exports.SipayWebhooks = SipayWebhooks;
+//# sourceMappingURL=webhooks.js.map

package/dist/resources/webhooks.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../src/resources/webhooks.ts"],"names":[],"mappings":";;;AAAA,iCAAuC;AACvC,oCAA2C;AAiD3C;;;;;;GAMG;AACH,MAAa,aAAc,SAAQ,oBAAa;IAC9C;;;OAGG;IACH,eAAe,CAAC,OAAe,EAAE,SAAiB;QAChD,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC;YAC3D,CAAC;YAED,uDAAuD;YACvD,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,CAAC,GAAG,IAAA,uBAAe,EAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAE9F,iEAAiE;YACjE,MAAM,OAAO,GACX,MAAM,KAAK,EAAE,IAAI,KAAK,KAAK,CAAC,IAAI,SAAS,KAAK,EAAE,IAAI,OAAO,KAAK,CAAC,IAAI,YAAY,KAAK,EAAE,CAAC;YAE3F,OAAO;gBACL,OAAO;gBACP,MAAM;gBACN,KAAK;gBACL,SAAS;gBACT,OAAO;gBACP,YAAY;gBACZ,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,wBAAwB;aACtD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,0BAA2B,KAAe,CAAC,OAAO,EAAE;aAC5D,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,OAAY;QAC5B,OAAO;YACL,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE;YACxC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;YAChC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;YACpC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;YACtC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,EAAE;YACpD,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,IAAI,EAAE;YACxD,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,EAAE;YAC5C,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,MAAM;YACpD,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,GAAG;YAC7C,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,GAAG;YAC7C,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;YACpC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;SACjC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,OAAY;QAChC,OAAO;YACL,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE;YACxC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;YACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;YAChC,aAAa,EAAE,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC;YACrD,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;YAClC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,EAAE;YAChD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;YAChC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;SACvC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,OAAY;QAC7B,OAAO;YACL,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;YACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;YAChC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;YACvC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;SACjC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,kBAAkB,CAChB,OAAY,EACZ,SAAiB;QAOjB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAE9C,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;YAC1E,CAAC;YAED,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAEnE,OAAO;gBACL,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;gBAC7C,UAAU;gBACV,KAAK,EAAE,UAAU,CAAC,KAAK;aACxB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,gCAAiC,KAAe,CAAC,OAAO,EAAE;aAClE,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,KAAwB;QAC1C,OAAO,KAAK,CAAC,cAAc,KAAK,GAAG,IAAI,KAAK,CAAC,WAAW,KAAK,KAAK,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,sBAAsB,CAAC,KAAwB;QAC7C,OAAO,KAAK,CAAC,cAAc,KAAK,GAAG,IAAI,KAAK,CAAC,gBAAgB,KAAK,mBAAmB,CAAC;IACxF,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,KAAwB;QACtC,OAAO,KAAK,CAAC,cAAc,KAAK,GAAG,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,2BAA2B,CAAC,KAAwB;QAClD,IAAI,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,OAAO,KAAK,CAAC,gBAAgB,KAAK,mBAAmB;gBACnD,CAAC,CAAC,6DAA6D;gBAC/D,CAAC,CAAC,gCAAgC,CAAC;QACvC,CAAC;QAED,IAAI,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,mBAAmB,KAAK,CAAC,kBAAkB,EAAE,CAAC;QACvD,CAAC;QAED,OAAO,mBAAmB,KAAK,CAAC,kBAAkB,EAAE,CAAC;IACvD,CAAC;CACF;AA/JD,sCA+JC"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@muhammedaksam/sipay-node",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "description": "Node.js TypeScript SDK for Sipay payment gateway",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",