eps-gateway-nodejs 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 EPS Gateway Node.js Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,620 @@
+# EPS Gateway Node.js SDK
+
+[![npm version](https://img.shields.io/npm/v/eps-gateway-nodejs.svg)](https://www.npmjs.com/package/eps-gateway-nodejs)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
+
+A well-maintained, unofficial Node.js package for integrating EPS (Easy Payment System) payments. Provides reliable support for initiating and handling transactions with minimal setup.
+
+**Official EPS Website:** [https://www.eps.com.bd](https://www.eps.com.bd)
+
+> **Note:** This is an unofficial SDK created by the developer community. EPS does not provide an official Node.js SDK.
+
+## Features
+
+✅ **TypeScript Support** - Full TypeScript definitions included
+✅ **Promise-based API** - Modern async/await syntax
+✅ **Automatic Token Management** - Handles JWT token caching and renewal
+✅ **HMACSHA512 Hash Generation** - Built-in secure hash utility
+✅ **Sandbox & Production** - Easy environment switching
+✅ **Input Validation** - Validates all parameters before API calls
+✅ **Error Handling** - Comprehensive error messages
+✅ **Product List Support** - Multiple products in single transaction
+✅ **Zero Dependencies** - Only uses axios for HTTP requests
+
+## Installation
+
+```bash
+npm install eps-gateway-nodejs
+```
+
+or
+
+```bash
+yarn add eps-gateway-nodejs
+```
+
+## Quick Start
+
+```javascript
+const { EPS, generateTransactionId } = require('eps-gateway-nodejs');
+
+// Initialize EPS
+const eps = new EPS({
+  username: 'your_username@example.com',
+  password: 'your_password',
+  hashKey: 'your_hash_key',
+  merchantId: 'your-merchant-id',
+  storeId: 'your-store-id',
+  sandbox: true // Use sandbox for testing
+});
+
+// Initialize payment
+const payment = await eps.initializePayment({
+  customerOrderId: 'ORD123',
+  merchantTransactionId: generateTransactionId(),
+  totalAmount: 1000,
+
+  successUrl: 'https://yoursite.com/payment/success',
+  failUrl: 'https://yoursite.com/payment/fail',
+  cancelUrl: 'https://yoursite.com/payment/cancel',
+
+  customerName: 'John Doe',
+  customerEmail: 'john@example.com',
+  customerPhone: '01712345678',
+  customerAddress: 'Dhaka',
+  customerCity: 'Dhaka',
+  customerState: 'Dhaka',
+  customerPostcode: '1200',
+
+  productName: 'Test Product'
+});
+
+// Redirect user to payment page
+console.log('Redirect to:', payment.RedirectURL);
+
+// Verify payment (after callback)
+const verification = await eps.verifyPayment({
+  merchantTransactionId: 'your_transaction_id'
+});
+
+if (verification.Status === 'Success') {
+  console.log('Payment successful!');
+}
+```
+
+## Configuration
+
+### Required Parameters
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `username` | string | EPS merchant username (usually email) |
+| `password` | string | EPS merchant password |
+| `hashKey` | string | Hash key provided by EPS (base64 encoded) |
+| `merchantId` | string | Merchant ID (UUID format) |
+| `storeId` | string | Store ID (UUID format) |
+
+### Optional Parameters
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `sandbox` | boolean | `false` | Use sandbox environment for testing |
+| `timeout` | number | `30000` | Request timeout in milliseconds |
+
+### Environment Variables Example
+
+```bash
+EPS_USERNAME=merchant@example.com
+EPS_PASSWORD=your_password
+EPS_HASH_KEY=your_hash_key_base64
+EPS_MERCHANT_ID=094980ee-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+EPS_STORE_ID=35b518f6-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+EPS_SANDBOX=true
+```
+
+```javascript
+const eps = new EPS({
+  username: process.env.EPS_USERNAME,
+  password: process.env.EPS_PASSWORD,
+  hashKey: process.env.EPS_HASH_KEY,
+  merchantId: process.env.EPS_MERCHANT_ID,
+  storeId: process.env.EPS_STORE_ID,
+  sandbox: process.env.EPS_SANDBOX === 'true'
+});
+```
+
+## API Reference
+
+### Initialize Payment
+
+```javascript
+const payment = await eps.initializePayment(params);
+```
+
+#### Required Parameters
+
+```javascript
+{
+  // Order Information
+  customerOrderId: 'ORD123',           // Your unique order ID
+  merchantTransactionId: '20240117001', // Unique transaction ID (min 10 digits)
+  totalAmount: 1000,                    // Amount in BDT
+
+  // Callback URLs
+  successUrl: 'https://yoursite.com/success',
+  failUrl: 'https://yoursite.com/fail',
+  cancelUrl: 'https://yoursite.com/cancel',
+
+  // Customer Information
+  customerName: 'John Doe',
+  customerEmail: 'john@example.com',
+  customerPhone: '01712345678',         // Bangladesh format: 01XXXXXXXXX
+  customerAddress: 'House 123, Road 456',
+  customerCity: 'Dhaka',
+  customerState: 'Dhaka',
+  customerPostcode: '1200',
+
+  // Product Information
+  productName: 'Test Product'
+}
+```
+
+#### Optional Parameters
+
+```javascript
+{
+  // Transaction Type
+  transactionTypeId: TransactionType.WEB, // WEB=1, ANDROID=2, IOS=3
+
+  // Additional Customer Info
+  customerAddress2: 'Sector 7, Uttara',
+  customerCountry: 'BD',
+
+  // Shipping Information
+  shipmentName: 'John Doe',
+  shipmentAddress: 'House 123',
+  shipmentCity: 'Dhaka',
+  shipmentState: 'Dhaka',
+  shipmentPostcode: '1200',
+  shipmentCountry: 'BD',
+
+  // Product Details
+  productProfile: 'general',
+  productCategory: 'Electronics',
+  noOfItem: 1,
+
+  // Multiple Products
+  productList: [
+    {
+      ProductName: 'Product 1',
+      NoOfItem: 2,
+      ProductPrice: 500,
+      ProductProfile: 'Description',
+      ProductCategory: 'Category'
+    }
+  ],
+
+  // Custom Values (for your reference)
+  valueA: 'custom_data_1',
+  valueB: 'custom_data_2',
+  valueC: 'custom_data_3',
+  valueD: 'custom_data_4',
+
+  // Other
+  shippingMethod: 'NO',
+  ipAddress: '103.45.67.89'
+}
+```
+
+#### Response
+
+```javascript
+{
+  TransactionId: '23e02880-f378-4594-86f8-30ecb5998094',
+  RedirectURL: 'https://pg.eps.com.bd/PG?data=...',
+  ErrorMessage: '',
+  ErrorCode: null
+}
+```
+
+### Verify Payment
+
+```javascript
+// Method 1: Verify by merchant transaction ID
+const result = await eps.verifyPayment({
+  merchantTransactionId: '20240117001'
+});
+
+// Method 2: Verify by EPS transaction ID
+const result = await eps.verifyPayment({
+  epsTransactionId: 'C2549190401'
+});
+
+// Method 3: Quick status check
+const isSuccessful = await eps.isPaymentSuccessful('20240117001');
+```
+
+#### Response
+
+```javascript
+{
+  MerchantTransactionId: '20240117001',
+  EpsTransactionId: 'C2549190401',
+  Status: 'Success', // Success, Failed, Pending
+  TotalAmount: '1000.00',
+  TransactionDate: '17 Jan 2024 06:30:15 PM',
+  TransactionType: 'Purchase',
+  FinancialEntity: 'OKWallet', // Payment method used
+
+  // Customer details
+  CustomerName: 'John Doe',
+  CustomerEmail: 'john@example.com',
+  CustomerPhone: '01712345678',
+
+  // Error info (if any)
+  ErrorCode: '',
+  ErrorMessage: ''
+}
+```
+
+## Payment Flow
+
+### 1. Initialize Payment
+
+```javascript
+const payment = await eps.initializePayment({...});
+```
+
+### 2. Redirect User
+
+```javascript
+// Redirect user to EPS payment page
+res.redirect(payment.RedirectURL);
+```
+
+### 3. Handle Callbacks
+
+EPS will redirect users back to your URLs with transaction details:
+
+#### Success URL
+```
+https://yoursite.com/payment/success?merchantTransactionId=xxx&status=success
+```
+
+#### Fail URL
+```
+https://yoursite.com/payment/fail?merchantTransactionId=xxx&status=failed
+```
+
+#### Cancel URL
+```
+https://yoursite.com/payment/cancel?merchantTransactionId=xxx&status=cancelled
+```
+
+### 4. Verify Payment
+
+```javascript
+router.get('/payment/success', async (req, res) => {
+  const { merchantTransactionId } = req.query;
+
+  // ALWAYS verify with EPS
+  const verification = await eps.verifyPayment({ merchantTransactionId });
+
+  if (verification.Status === 'Success') {
+    // Payment confirmed - Update your database
+    await updateOrderStatus(merchantTransactionId, 'PAID');
+    res.render('success', { transaction: verification });
+  } else {
+    res.redirect('/payment/fail');
+  }
+});
+```
+
+## Express.js Integration
+
+```javascript
+const express = require('express');
+const { EPS, generateTransactionId } = require('eps-gateway-nodejs');
+
+const app = express();
+const eps = new EPS({...});
+
+// Initiate payment
+app.post('/payment/initiate', async (req, res) => {
+  try {
+    const payment = await eps.initializePayment({
+      customerOrderId: req.body.orderId,
+      merchantTransactionId: generateTransactionId(),
+      totalAmount: req.body.amount,
+      successUrl: `${req.protocol}://${req.get('host')}/payment/success`,
+      failUrl: `${req.protocol}://${req.get('host')}/payment/fail`,
+      cancelUrl: `${req.protocol}://${req.get('host')}/payment/cancel`,
+      ...req.body.customer,
+      productName: req.body.productName
+    });
+
+    res.redirect(payment.RedirectURL);
+  } catch (error) {
+    res.status(500).json({ error: error.message });
+  }
+});
+
+// Success callback
+app.get('/payment/success', async (req, res) => {
+  const verification = await eps.verifyPayment({
+    merchantTransactionId: req.query.merchantTransactionId
+  });
+
+  if (verification.Status === 'Success') {
+    // Update database, send email, etc.
+    res.render('payment-success', { data: verification });
+  } else {
+    res.redirect('/payment/fail');
+  }
+});
+```
+
+## Utility Functions
+
+### Generate Transaction ID
+
+```javascript
+const { generateTransactionId } = require('eps-gateway-nodejs');
+
+const txnId = generateTransactionId();
+// Returns: 20240117123456789 (17 digits, timestamp-based)
+```
+
+### Generate Hash (Advanced)
+
+```javascript
+const { generateHash } = require('eps-gateway-nodejs');
+
+const hash = generateHash('value_to_hash', 'your_hash_key');
+// Returns: Base64 HMACSHA512 hash
+```
+
+## Error Handling
+
+```javascript
+const { EPSError } = require('eps-gateway-nodejs');
+
+try {
+  const payment = await eps.initializePayment({...});
+} catch (error) {
+  if (error instanceof EPSError) {
+    console.error('EPS Error:', error.message);
+    console.error('Error Code:', error.code);
+    console.error('Response:', error.response);
+  } else {
+    console.error('Unknown error:', error);
+  }
+}
+```
+
+### Common Error Codes
+
+| Code | Description |
+|------|-------------|
+| `INVALID_CONFIG` | Invalid configuration parameters |
+| `INVALID_PARAMS` | Invalid payment parameters |
+| `AUTH_ERROR` | Authentication failed |
+| `INIT_ERROR` | Payment initialization failed |
+| `VERIFY_ERROR` | Transaction verification failed |
+| `NETWORK_ERROR` | Network/connection error |
+
+## TypeScript Usage
+
+```typescript
+import { EPS, InitializePaymentParams, VerifyPaymentResponse, TransactionType } from 'eps-gateway-nodejs';
+
+const eps = new EPS({
+  username: 'merchant@example.com',
+  password: 'password',
+  hashKey: 'hash_key',
+  merchantId: 'merchant-id',
+  storeId: 'store-id',
+  sandbox: true
+});
+
+const params: InitializePaymentParams = {
+  customerOrderId: 'ORD123',
+  merchantTransactionId: '20240117001',
+  totalAmount: 1000,
+  transactionTypeId: TransactionType.WEB,
+  // ... other params
+};
+
+const payment = await eps.initializePayment(params);
+const verification: VerifyPaymentResponse = await eps.verifyPayment({
+  merchantTransactionId: '20240117001'
+});
+```
+
+## Testing
+
+### Sandbox Mode
+
+```javascript
+const eps = new EPS({
+  username: 'sandbox_username',
+  password: 'sandbox_password',
+  hashKey: 'sandbox_hash_key',
+  merchantId: 'sandbox-merchant-id',
+  storeId: 'sandbox-store-id',
+  sandbox: true // Important!
+});
+```
+
+### Test Credentials
+
+Contact EPS support to get sandbox credentials for testing.
+
+## Examples
+
+Check the `/examples` directory for complete working examples:
+
+- `initialize-payment.js` - Basic payment initialization
+- `verify-payment.js` - Payment verification
+- `complete-flow.js` - Complete payment flow with Express.js integration
+
+Run examples:
+
+```bash
+npm run build
+node examples/initialize-payment.js
+node examples/verify-payment.js
+node examples/complete-flow.js
+```
+
+## Best Practices
+
+### 1. Always Verify Payments
+
+Never trust callback URLs alone. Always verify payment status with EPS:
+
+```javascript
+// ❌ BAD - Don't trust the callback alone
+app.get('/payment/success', async (req, res) => {
+  // Directly mark as paid - INSECURE!
+  await markOrderAsPaid(req.query.orderId);
+});
+
+// ✅ GOOD - Always verify with EPS
+app.get('/payment/success', async (req, res) => {
+  const verification = await eps.verifyPayment({
+    merchantTransactionId: req.query.merchantTransactionId
+  });
+
+  if (verification.Status === 'Success') {
+    await markOrderAsPaid(req.query.orderId);
+  }
+});
+```
+
+### 2. Store Transaction IDs
+
+```javascript
+// Save transaction details before redirecting
+await Payment.create({
+  orderId: 'ORD123',
+  merchantTransactionId: txnId,
+  epsTransactionId: payment.TransactionId,
+  amount: 1000,
+  status: 'INITIATED'
+});
+```
+
+### 3. Use Environment Variables
+
+```javascript
+// Never hardcode credentials
+const eps = new EPS({
+  username: process.env.EPS_USERNAME,
+  password: process.env.EPS_PASSWORD,
+  hashKey: process.env.EPS_HASH_KEY,
+  merchantId: process.env.EPS_MERCHANT_ID,
+  storeId: process.env.EPS_STORE_ID,
+  sandbox: process.env.NODE_ENV !== 'production'
+});
+```
+
+### 4. Handle Errors Gracefully
+
+```javascript
+try {
+  const payment = await eps.initializePayment(params);
+  res.redirect(payment.RedirectURL);
+} catch (error) {
+  logger.error('Payment initiation failed:', error);
+  res.render('payment-error', {
+    message: 'Unable to process payment. Please try again.'
+  });
+}
+```
+
+### 5. Use Unique Transaction IDs
+
+```javascript
+const { generateTransactionId } = require('eps-gateway-nodejs');
+
+// Always generate unique transaction IDs
+const txnId = generateTransactionId(); // Timestamp-based, 17 digits
+
+// Or use your own format (minimum 10 digits)
+const customTxnId = `${Date.now()}${Math.random().toString().slice(2, 6)}`;
+```
+
+## FAQ
+
+### Q: Is this an official SDK?
+**A:** No, this is an unofficial SDK created by the developer community. EPS does not provide an official Node.js SDK.
+
+### Q: How do I get EPS credentials?
+**A:** Contact EPS (Easy Payment System) support at info@eps.com.bd or visit www.eps.com.bd
+
+### Q: What's the difference between sandbox and production?
+**A:** Sandbox is for testing with test credentials. Production is for real transactions with real money.
+
+### Q: Can I use this in production?
+**A:** Yes, but thoroughly test in sandbox mode first. This library is used in production by several projects.
+
+### Q: What payment methods does EPS support?
+**A:** EPS supports various methods including bKash, Nagad, Rocket, Bank cards, OKWallet, and more. The actual methods available depend on your EPS merchant account configuration.
+
+### Q: How do I handle webhooks/IPN?
+**A:** EPS uses callback URLs (successUrl, failUrl, cancelUrl). Always verify payment status when handling these callbacks.
+
+## Contributing
+
+Suggestions, improvements, and pull requests are always welcome!
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+### Development Setup
+
+```bash
+git clone https://github.com/imtiaznajim/eps-gateway-nodejs.git
+cd eps-gateway-nodejs
+npm install
+npm run build
+npm test
+```
+
+## License
+
+MIT License - see the [LICENSE](LICENSE) file for details
+
+## Disclaimer
+
+This is an unofficial SDK. The author is not affiliated with EPS (Easy Payment System). Use at your own risk.
+
+## Author
+
+**Imtiaz Najim**
+- GitHub: [@imtiaznajim](https://github.com/imtiaznajim)
+- Email: imtiaznajim@gmail.com
+
+## Support
+
+- 🐛 **Issues:** [GitHub Issues](https://github.com/imtiaznajim/eps-gateway-nodejs/issues)
+- 💬 **Discussions:** [GitHub Discussions](https://github.com/imtiaznajim/eps-gateway-nodejs/discussions)
+- ⭐ **Star this repo** if you find it helpful!
+
+## Acknowledgments
+
+- Thanks to [EPS (Easy Payment System)](https://www.eps.com.bd) for providing the payment gateway service
+- Built with ❤️ for the Bangladesh developer community
+
+## Related Projects
+
+- [bkash-payment](https://www.npmjs.com/package/bkash-payment) - bKash Payment Gateway SDK
+
+---
+
+Made with ❤️ for the Bangladesh developer community

package/dist/EPS.d.ts

@@ -0,0 +1,17 @@
+import { EPSConfig, InitializePaymentParams, InitializePaymentResponse, VerifyPaymentParams, VerifyPaymentResponse } from './types';
+export declare class EPS {
+    private config;
+    private httpClient;
+    private token;
+    private tokenExpiry;
+    private readonly ENDPOINTS;
+    constructor(config: EPSConfig);
+    private getEndpoints;
+    private getToken;
+    initializePayment(params: InitializePaymentParams): Promise<InitializePaymentResponse>;
+    verifyPayment(params: VerifyPaymentParams): Promise<VerifyPaymentResponse>;
+    isPaymentSuccessful(transactionId: string): Promise<boolean>;
+    private handleError;
+    clearToken(): void;
+    getConfig(): Partial<EPSConfig>;
+}

package/dist/EPS.js

@@ -0,0 +1,210 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EPS = void 0;
+const axios_1 = __importDefault(require("axios"));
+const types_1 = require("./types");
+const hash_1 = require("./utils/hash");
+const validator_1 = require("./utils/validator");
+class EPS {
+    constructor(config) {
+        this.token = null;
+        this.tokenExpiry = null;
+        this.ENDPOINTS = {
+            SANDBOX: {
+                GET_TOKEN: 'https://sandbox-pgapi.eps.com.bd/v1/Auth/GetToken',
+                INITIALIZE: 'https://sandbox-pgapi.eps.com.bd/v1/EPSEngine/InitializeEPS',
+                VERIFY: 'https://sandbox-pgapi.eps.com.bd/v1/EPSEngine/CheckMerchantTransactionStatus',
+            },
+            PRODUCTION: {
+                GET_TOKEN: 'https://pgapi.eps.com.bd/v1/Auth/GetToken',
+                INITIALIZE: 'https://pgapi.eps.com.bd/v1/EPSEngine/InitializeEPS',
+                VERIFY: 'https://pgapi.eps.com.bd/v1/EPSEngine/CheckMerchantTransactionStatus',
+            },
+        };
+        (0, validator_1.validateConfig)(config);
+        this.config = {
+            ...config,
+            sandbox: config.sandbox ?? false,
+            timeout: config.timeout ?? 30000,
+        };
+        this.httpClient = axios_1.default.create({
+            timeout: this.config.timeout,
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+        this.httpClient.interceptors.response.use((response) => response, (error) => {
+            throw this.handleError(error);
+        });
+    }
+    getEndpoints() {
+        return this.config.sandbox ? this.ENDPOINTS.SANDBOX : this.ENDPOINTS.PRODUCTION;
+    }
+    async getToken() {
+        if (this.token && this.tokenExpiry && new Date() < this.tokenExpiry) {
+            return this.token;
+        }
+        try {
+            const hash = (0, hash_1.generateHash)(this.config.username, this.config.hashKey);
+            const response = await this.httpClient.post(this.getEndpoints().GET_TOKEN, {
+                userName: this.config.username,
+                password: this.config.password,
+            }, {
+                headers: {
+                    'x-hash': hash,
+                },
+            });
+            const data = response.data;
+            if (data.errorMessage || data.errorCode) {
+                throw new types_1.EPSError(data.errorMessage || 'Failed to get token', data.errorCode || 'TOKEN_ERROR', data);
+            }
+            this.token = data.token;
+            this.tokenExpiry = new Date(data.expireDate);
+            return data.token;
+        }
+        catch (error) {
+            if (error instanceof types_1.EPSError) {
+                throw error;
+            }
+            throw new types_1.EPSError(`Authentication failed: ${error instanceof Error ? error.message : 'Unknown error'}`, 'AUTH_ERROR');
+        }
+    }
+    async initializePayment(params) {
+        (0, validator_1.validatePaymentParams)(params);
+        try {
+            const token = await this.getToken();
+            const hash = (0, hash_1.generateHash)(params.merchantTransactionId, this.config.hashKey);
+            const requestBody = {
+                merchantId: this.config.merchantId,
+                storeId: this.config.storeId,
+                CustomerOrderId: params.customerOrderId,
+                merchantTransactionId: params.merchantTransactionId,
+                transactionTypeId: params.transactionTypeId ?? types_1.TransactionType.WEB,
+                financialEntityId: 0,
+                transitionStatusId: 0,
+                totalAmount: params.totalAmount,
+                ipAddress: params.ipAddress || '0.0.0.0',
+                version: '1',
+                successUrl: params.successUrl,
+                failUrl: params.failUrl,
+                cancelUrl: params.cancelUrl,
+                customerName: params.customerName,
+                customerEmail: params.customerEmail,
+                CustomerAddress: params.customerAddress,
+                CustomerAddress2: params.customerAddress2 || '',
+                CustomerCity: params.customerCity,
+                CustomerState: params.customerState,
+                CustomerPostcode: params.customerPostcode,
+                CustomerCountry: params.customerCountry || 'BD',
+                CustomerPhone: params.customerPhone,
+                ShipmentName: params.shipmentName || '',
+                ShipmentAddress: params.shipmentAddress || '',
+                ShipmentAddress2: params.shipmentAddress2 || '',
+                ShipmentCity: params.shipmentCity || '',
+                ShipmentState: params.shipmentState || '',
+                ShipmentPostcode: params.shipmentPostcode || '',
+                ShipmentCountry: params.shipmentCountry || '',
+                ValueA: params.valueA || '',
+                ValueB: params.valueB || '',
+                ValueC: params.valueC || '',
+                ValueD: params.valueD || '',
+                ShippingMethod: params.shippingMethod || 'NO',
+                NoOfItem: params.noOfItem?.toString() || '1',
+                ProductName: params.productName,
+                ProductProfile: params.productProfile || 'general',
+                ProductCategory: params.productCategory || 'general',
+                ProductList: params.productList || [],
+            };
+            const response = await this.httpClient.post(this.getEndpoints().INITIALIZE, requestBody, {
+                headers: {
+                    'x-hash': hash,
+                    Authorization: `Bearer ${token}`,
+                },
+            });
+            const data = response.data;
+            if (data.ErrorMessage || data.ErrorCode) {
+                throw new types_1.EPSError(data.ErrorMessage || 'Payment initialization failed', data.ErrorCode || 'INIT_ERROR', data);
+            }
+            return data;
+        }
+        catch (error) {
+            if (error instanceof types_1.EPSError) {
+                throw error;
+            }
+            throw new types_1.EPSError(`Payment initialization failed: ${error instanceof Error ? error.message : 'Unknown error'}`, 'INIT_ERROR');
+        }
+    }
+    async verifyPayment(params) {
+        if (!params.merchantTransactionId && !params.epsTransactionId) {
+            throw new types_1.EPSError('Either merchantTransactionId or epsTransactionId is required', 'INVALID_PARAMS');
+        }
+        try {
+            const token = await this.getToken();
+            const hashValue = params.merchantTransactionId || params.epsTransactionId;
+            const hash = (0, hash_1.generateHash)(hashValue, this.config.hashKey);
+            const queryParams = new URLSearchParams();
+            if (params.merchantTransactionId) {
+                queryParams.append('merchantTransactionId', params.merchantTransactionId);
+            }
+            if (params.epsTransactionId) {
+                queryParams.append('EPSTransactionId', params.epsTransactionId);
+            }
+            const url = `${this.getEndpoints().VERIFY}?${queryParams.toString()}`;
+            const response = await this.httpClient.get(url, {
+                headers: {
+                    'x-hash': hash,
+                    Authorization: `Bearer ${token}`,
+                },
+            });
+            const data = response.data;
+            if (data.ErrorMessage || data.ErrorCode) {
+                throw new types_1.EPSError(data.ErrorMessage || 'Transaction verification failed', data.ErrorCode || 'VERIFY_ERROR', data);
+            }
+            return data;
+        }
+        catch (error) {
+            if (error instanceof types_1.EPSError) {
+                throw error;
+            }
+            throw new types_1.EPSError(`Transaction verification failed: ${error instanceof Error ? error.message : 'Unknown error'}`, 'VERIFY_ERROR');
+        }
+    }
+    async isPaymentSuccessful(transactionId) {
+        try {
+            const verification = await this.verifyPayment({
+                merchantTransactionId: transactionId,
+            });
+            return verification.Status.toLowerCase() === 'success';
+        }
+        catch {
+            return false;
+        }
+    }
+    handleError(error) {
+        if (error.response) {
+            const data = error.response.data;
+            return new types_1.EPSError(data?.ErrorMessage || data?.errorMessage || error.message, data?.ErrorCode || data?.errorCode || 'HTTP_ERROR', data);
+        }
+        if (error.request) {
+            return new types_1.EPSError('No response from EPS server', 'NETWORK_ERROR');
+        }
+        return new types_1.EPSError(error.message, 'UNKNOWN_ERROR');
+    }
+    clearToken() {
+        this.token = null;
+        this.tokenExpiry = null;
+    }
+    getConfig() {
+        return {
+            username: this.config.username,
+            merchantId: this.config.merchantId,
+            storeId: this.config.storeId,
+            sandbox: this.config.sandbox,
+        };
+    }
+}
+exports.EPS = EPS;
+//# sourceMappingURL=EPS.js.map

package/dist/EPS.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { EPS } from './EPS';
+export { EPSConfig, EPSError, InitializePaymentParams, InitializePaymentResponse, ProductItem, TokenResponse, TransactionType, VerifyPaymentParams, VerifyPaymentResponse, } from './types';
+export { generateHash, generateTransactionId, validateHashKey } from './utils/hash';

package/dist/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateHashKey = exports.generateTransactionId = exports.generateHash = exports.TransactionType = exports.EPSError = exports.EPS = void 0;
+var EPS_1 = require("./EPS");
+Object.defineProperty(exports, "EPS", { enumerable: true, get: function () { return EPS_1.EPS; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "EPSError", { enumerable: true, get: function () { return types_1.EPSError; } });
+Object.defineProperty(exports, "TransactionType", { enumerable: true, get: function () { return types_1.TransactionType; } });
+var hash_1 = require("./utils/hash");
+Object.defineProperty(exports, "generateHash", { enumerable: true, get: function () { return hash_1.generateHash; } });
+Object.defineProperty(exports, "generateTransactionId", { enumerable: true, get: function () { return hash_1.generateTransactionId; } });
+Object.defineProperty(exports, "validateHashKey", { enumerable: true, get: function () { return hash_1.validateHashKey; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAQA,6BAA4B;AAAnB,0FAAA,GAAG,OAAA;AACZ,iCAUiB;AARf,iGAAA,QAAQ,OAAA;AAKR,wGAAA,eAAe,OAAA;AAIjB,qCAAoF;AAA3E,oGAAA,YAAY,OAAA;AAAE,6GAAA,qBAAqB,OAAA;AAAE,uGAAA,eAAe,OAAA"}

package/dist/types/index.d.ts

@@ -0,0 +1,117 @@
+export interface EPSConfig {
+    username: string;
+    password: string;
+    hashKey: string;
+    merchantId: string;
+    storeId: string;
+    sandbox?: boolean;
+    timeout?: number;
+}
+export declare enum TransactionType {
+    WEB = 1,
+    ANDROID = 2,
+    IOS = 3
+}
+export interface ProductItem {
+    ProductName: string;
+    NoOfItem: string | number;
+    ProductProfile?: string;
+    ProductCategory?: string;
+    ProductPrice: string | number;
+}
+export interface InitializePaymentParams {
+    customerOrderId: string;
+    merchantTransactionId: string;
+    transactionTypeId?: TransactionType;
+    totalAmount: number;
+    successUrl: string;
+    failUrl: string;
+    cancelUrl: string;
+    customerName: string;
+    customerEmail: string;
+    customerAddress: string;
+    customerAddress2?: string;
+    customerCity: string;
+    customerState: string;
+    customerPostcode: string;
+    customerCountry?: string;
+    customerPhone: string;
+    shipmentName?: string;
+    shipmentAddress?: string;
+    shipmentAddress2?: string;
+    shipmentCity?: string;
+    shipmentState?: string;
+    shipmentPostcode?: string;
+    shipmentCountry?: string;
+    valueA?: string;
+    valueB?: string;
+    valueC?: string;
+    valueD?: string;
+    shippingMethod?: string;
+    noOfItem?: string | number;
+    productName: string;
+    productProfile?: string;
+    productCategory?: string;
+    productList?: ProductItem[];
+    ipAddress?: string;
+}
+export interface TokenResponse {
+    token: string;
+    expireDate: string;
+    errorMessage: string | null;
+    errorCode: string | null;
+}
+export interface InitializePaymentResponse {
+    TransactionId: string;
+    RedirectURL: string;
+    ErrorMessage: string;
+    ErrorCode: string | null;
+    FinancialEntityList: any[] | null;
+}
+export interface VerifyPaymentParams {
+    merchantTransactionId?: string;
+    epsTransactionId?: string;
+}
+export interface VerifyPaymentResponse {
+    MerchantTransactionId: string;
+    EpsTransactionId: string;
+    Status: string;
+    TotalAmount: string;
+    TransactionDate: string;
+    TransactionType: string;
+    FinancialEntity: string;
+    ErrorCode: string;
+    ErrorMessage: string;
+    CustomerId: string;
+    CustomerName: string;
+    CustomerEmail: string;
+    CustomerAddress: string;
+    CustomerAddress2: string;
+    CustomerCity: string;
+    CustomerState: string;
+    CustomerPostcode: string;
+    CustomerCountry: string;
+    CustomerPhone: string;
+    ShipmentName: string;
+    ShipmentAddress: string;
+    ShipmentAddress2: string;
+    ShipmentCity: string;
+    ShipmentState: string;
+    ShipmentPostcode: string;
+    ShipmentCountry: string;
+    ValueA: string;
+    ValueB: string;
+    ValueC: string;
+    ValueD: string;
+    ShippingMethod: string;
+    NoOfItem: string;
+    ProductName: string;
+    ProductProfile: string;
+    ProductCategory: string;
+    PaymentReferance?: string;
+}
+export declare class EPSError extends Error {
+    code?: string;
+    response?: any;
+    constructor(message: string, code?: string, response?: any);
+}

package/dist/types/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EPSError = exports.TransactionType = void 0;
+var TransactionType;
+(function (TransactionType) {
+    TransactionType[TransactionType["WEB"] = 1] = "WEB";
+    TransactionType[TransactionType["ANDROID"] = 2] = "ANDROID";
+    TransactionType[TransactionType["IOS"] = 3] = "IOS";
+})(TransactionType || (exports.TransactionType = TransactionType = {}));
+class EPSError extends Error {
+    constructor(message, code, response) {
+        super(message);
+        this.name = 'EPSError';
+        this.code = code;
+        this.response = response;
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+exports.EPSError = EPSError;
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;AAuBA,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,mDAAO,CAAA;IACP,2DAAW,CAAA;IACX,mDAAO,CAAA;AACT,CAAC,EAJW,eAAe,+BAAf,eAAe,QAI1B;AAqND,MAAa,QAAS,SAAQ,KAAK;IAIjC,YAAY,OAAe,EAAE,IAAa,EAAE,QAAc;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AAXD,4BAWC"}

package/dist/utils/hash.d.ts

@@ -0,0 +1,3 @@
+export declare function generateHash(value: string, hashKey: string): string;
+export declare function validateHashKey(hashKey: string): boolean;
+export declare function generateTransactionId(): string;

package/dist/utils/hash.js

@@ -0,0 +1,68 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateHash = generateHash;
+exports.validateHashKey = validateHashKey;
+exports.generateTransactionId = generateTransactionId;
+const crypto = __importStar(require("crypto"));
+function generateHash(value, hashKey) {
+    try {
+        const hmac = crypto.createHmac('sha512', Buffer.from(hashKey, 'utf8'));
+        hmac.update(value, 'utf8');
+        return hmac.digest('base64');
+    }
+    catch (error) {
+        throw new Error(`Hash generation failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+function validateHashKey(hashKey) {
+    if (!hashKey || typeof hashKey !== 'string') {
+        return false;
+    }
+    const base64Regex = /^[A-Za-z0-9+/=]+$/;
+    return base64Regex.test(hashKey) && hashKey.length > 20;
+}
+function generateTransactionId() {
+    const now = new Date();
+    const year = now.getFullYear();
+    const month = String(now.getMonth() + 1).padStart(2, '0');
+    const day = String(now.getDate()).padStart(2, '0');
+    const hours = String(now.getHours()).padStart(2, '0');
+    const minutes = String(now.getMinutes()).padStart(2, '0');
+    const seconds = String(now.getSeconds()).padStart(2, '0');
+    const milliseconds = String(now.getMilliseconds()).padStart(3, '0');
+    return `${year}${month}${day}${hours}${minutes}${seconds}${milliseconds}`;
+}
+//# sourceMappingURL=hash.js.map

package/dist/utils/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeA,oCAaC;AAOD,0CAQC;AAOD,sDAWC;AA7DD,+CAAiC;AAejC,SAAgB,YAAY,CAAC,KAAa,EAAE,OAAe;IACzD,IAAI,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QAGvE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAG3B,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;IACzG,CAAC;AACH,CAAC;AAOD,SAAgB,eAAe,CAAC,OAAe;IAC7C,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAGD,MAAM,WAAW,GAAG,mBAAmB,CAAC;IACxC,OAAO,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC;AAC1D,CAAC;AAOD,SAAgB,qBAAqB;IACnC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAEpE,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,GAAG,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,EAAE,CAAC;AAC5E,CAAC"}

package/dist/utils/validator.d.ts

@@ -0,0 +1,3 @@
+import { EPSConfig, InitializePaymentParams } from '../types';
+export declare function validateConfig(config: EPSConfig): void;
+export declare function validatePaymentParams(params: InitializePaymentParams): void;

package/dist/utils/validator.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateConfig = validateConfig;
+exports.validatePaymentParams = validatePaymentParams;
+const types_1 = require("../types");
+function validateConfig(config) {
+    const required = ['username', 'password', 'hashKey', 'merchantId', 'storeId'];
+    for (const field of required) {
+        if (!config[field]) {
+            throw new types_1.EPSError(`Missing required configuration: ${field}`, 'INVALID_CONFIG');
+        }
+    }
+    if (config.username && !isValidEmail(config.username)) {
+        throw new types_1.EPSError('Invalid username format (expected email)', 'INVALID_CONFIG');
+    }
+    if (config.merchantId && !isValidUUID(config.merchantId)) {
+        throw new types_1.EPSError('Invalid merchantId format (expected UUID)', 'INVALID_CONFIG');
+    }
+    if (config.storeId && !isValidUUID(config.storeId)) {
+        throw new types_1.EPSError('Invalid storeId format (expected UUID)', 'INVALID_CONFIG');
+    }
+}
+function validatePaymentParams(params) {
+    const required = [
+        'customerOrderId',
+        'merchantTransactionId',
+        'totalAmount',
+        'successUrl',
+        'failUrl',
+        'cancelUrl',
+        'customerName',
+        'customerEmail',
+        'customerAddress',
+        'customerCity',
+        'customerState',
+        'customerPostcode',
+        'customerPhone',
+        'productName',
+    ];
+    for (const field of required) {
+        if (!params[field]) {
+            throw new types_1.EPSError(`Missing required parameter: ${field}`, 'INVALID_PARAMS');
+        }
+    }
+    if (params.merchantTransactionId.length < 10) {
+        throw new types_1.EPSError('merchantTransactionId must be at least 10 digits', 'INVALID_TRANSACTION_ID');
+    }
+    if (params.totalAmount <= 0) {
+        throw new types_1.EPSError('totalAmount must be greater than 0', 'INVALID_AMOUNT');
+    }
+    if (!isValidEmail(params.customerEmail)) {
+        throw new types_1.EPSError('Invalid customer email format', 'INVALID_EMAIL');
+    }
+    if (!isValidBDPhone(params.customerPhone)) {
+        throw new types_1.EPSError('Invalid phone number format (expected Bangladesh format: 01XXXXXXXXX)', 'INVALID_PHONE');
+    }
+    const urls = ['successUrl', 'failUrl', 'cancelUrl'];
+    for (const urlField of urls) {
+        const url = params[urlField];
+        if (!isValidURL(url)) {
+            throw new types_1.EPSError(`Invalid ${urlField} format`, 'INVALID_URL');
+        }
+    }
+}
+function isValidEmail(email) {
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailRegex.test(email);
+}
+function isValidUUID(uuid) {
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    return uuidRegex.test(uuid);
+}
+function isValidBDPhone(phone) {
+    const bdPhoneRegex = /^01[0-9]{9}$/;
+    return bdPhoneRegex.test(phone.replace(/[^0-9]/g, ''));
+}
+function isValidURL(url) {
+    try {
+        new URL(url);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/utils/validator.js.map

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

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "eps-gateway-nodejs",
+  "version": "1.0.0",
+  "description": "Unofficial Node.js SDK for EPS (Easy Payment System) Payment Gateway - Bangladesh",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "prepare": "npm run build",
+    "lint": "eslint src/**/*.ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "dev": "ts-node src/index.ts"
+  },
+  "keywords": [
+    "eps",
+    "easy-payment-system",
+    "payment-gateway",
+    "bangladesh",
+    "payment",
+    "nodejs",
+    "typescript",
+    "eps-gateway",
+    "online-payment",
+    "bd-payment"
+  ],
+  "author": "Imtiaz Najim <imtiaznajim@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/imtiaznajim/eps-gateway-nodejs.git"
+  },
+  "bugs": {
+    "url": "https://github.com/imtiaznajim/eps-gateway-nodejs/issues"
+  },
+  "homepage": "https://github.com/imtiaznajim/eps-gateway-nodejs#readme",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "axios": "^1.6.5"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@types/jest": "^29.5.11",
+    "@typescript-eslint/eslint-plugin": "^6.19.0",
+    "@typescript-eslint/parser": "^6.19.0",
+    "eslint": "^8.56.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.2.4",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}