@fiddupay/fiddupay-node 1.0.0

package/README.md

@@ -0,0 +1,248 @@
+# FidduPay Node.js SDK
+
+Official Node.js SDK for the FidduPay cryptocurrency payment gateway platform.
+
+[![npm version](https://badge.fury.io/js/fiddupay-node.svg)](https://www.npmjs.com/package/fiddupay-node)
+[![Build Status](https://github.com/fiddupay/fiddupay-node/workflows/CI%2FCD%20Pipeline/badge.svg)](https://github.com/fiddupay/fiddupay-node/actions)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+npm install fiddupay-node
+```
+
+### Basic Usage
+
+```typescript
+import { FidduPay } from 'fiddupay-node';
+
+const fiddupay = new FidduPay({
+  apiKey: 'your-api-key',
+  environment: 'sandbox' // or 'production'
+});
+
+// Create a payment
+const payment = await fiddupay.payments.create({
+  amount: 100.50,
+  currency: 'USDT',
+  network: 'ethereum',
+  description: 'Order #12345'
+});
+
+console.log('Payment created:', payment.id);
+```
+
+## 📚 Features
+
+- **💳 Payment Processing**: Create, retrieve, list, and cancel payments
+- **🔔 Webhook Verification**: Secure HMAC-SHA256 signature validation
+- **🏪 Merchant Management**: Profile, balance, and wallet configuration
+- **💰 Refund Operations**: Create and track refunds
+- **📊 Analytics**: Data retrieval and export
+- **🔒 Security**: Input validation, rate limiting, retry logic
+- **📝 TypeScript**: Full type definitions included
+
+## 🔧 Configuration
+
+```typescript
+const fiddupay = new FidduPay({
+  apiKey: 'your-api-key',
+  environment: 'sandbox', // 'sandbox' or 'production'
+  timeout: 30000, // Request timeout in milliseconds
+  retries: 3, // Number of retry attempts
+  baseURL: 'https://api.fiddupay.com' // Custom API base URL
+});
+```
+
+## 💳 Payment Operations
+
+### Create Payment
+
+```typescript
+const payment = await fiddupay.payments.create({
+  amount: 100.50,
+  currency: 'USDT',
+  network: 'ethereum',
+  description: 'Order #12345',
+  metadata: {
+    orderId: '12345',
+    customerId: 'cust_123'
+  }
+});
+```
+
+### Retrieve Payment
+
+```typescript
+const payment = await fiddupay.payments.retrieve('pay_123');
+```
+
+### List Payments
+
+```typescript
+const payments = await fiddupay.payments.list({
+  limit: 10,
+  status: 'completed'
+});
+```
+
+## 🔔 Webhook Handling
+
+```typescript
+import express from 'express';
+
+const app = express();
+
+app.post('/webhooks/fiddupay', express.raw({type: 'application/json'}), (req, res) => {
+  const signature = req.headers['fiddupay-signature'] as string;
+  
+  try {
+    const event = fiddupay.webhooks.constructEvent(
+      req.body,
+      signature,
+      'your-webhook-secret'
+    );
+    
+    switch (event.type) {
+      case 'payment.completed':
+        console.log('Payment completed:', event.data);
+        break;
+      case 'payment.failed':
+        console.log('Payment failed:', event.data);
+        break;
+    }
+    
+    res.status(200).send('OK');
+  } catch (error) {
+    console.error('Webhook error:', error);
+    res.status(400).send('Invalid signature');
+  }
+});
+```
+
+## 🏪 Merchant Operations
+
+```typescript
+// Get merchant profile
+const profile = await fiddupay.merchants.getProfile();
+
+// Get account balance
+const balance = await fiddupay.merchants.getBalance();
+
+// Configure wallet
+await fiddupay.merchants.configureWallet({
+  currency: 'USDT',
+  network: 'ethereum',
+  address: '0x742d35Cc6634C0532925a3b8D4C9db96590c6C87'
+});
+```
+
+## 💰 Refund Operations
+
+```typescript
+// Create refund
+const refund = await fiddupay.refunds.create({
+  paymentId: 'pay_123',
+  amount: 50.25,
+  reason: 'customer_request'
+});
+
+// List refunds
+const refunds = await fiddupay.refunds.list({
+  paymentId: 'pay_123'
+});
+```
+
+## 📊 Analytics
+
+```typescript
+// Get analytics data
+const analytics = await fiddupay.analytics.getData({
+  startDate: '2026-01-01',
+  endDate: '2026-01-31',
+  metrics: ['revenue', 'transaction_count']
+});
+
+// Export data
+const exportData = await fiddupay.analytics.exportData({
+  format: 'csv',
+  startDate: '2026-01-01',
+  endDate: '2026-01-31'
+});
+```
+
+## 🚨 Error Handling
+
+```typescript
+import { 
+  FidduPayError, 
+  APIError, 
+  AuthenticationError, 
+  ValidationError, 
+  RateLimitError 
+} from 'fiddupay-node';
+
+try {
+  const payment = await fiddupay.payments.create({
+    amount: 100,
+    currency: 'USDT'
+  });
+} catch (error) {
+  if (error instanceof AuthenticationError) {
+    console.error('Invalid API key');
+  } else if (error instanceof ValidationError) {
+    console.error('Invalid parameters:', error.details);
+  } else if (error instanceof RateLimitError) {
+    console.error('Rate limit exceeded, retry after:', error.retryAfter);
+  } else if (error instanceof APIError) {
+    console.error('API error:', error.message);
+  }
+}
+```
+
+## 🔒 Security
+
+- **API Key Security**: Never expose API keys in client-side code
+- **Webhook Verification**: Always verify webhook signatures
+- **HTTPS Only**: All API calls use HTTPS encryption
+- **Input Validation**: All inputs are validated and sanitized
+
+## 🌍 Supported Cryptocurrencies
+
+**5 Major Blockchain Networks:**
+- **Solana** - SOL + USDT (SPL)
+- **Ethereum** - ETH + USDT (ERC-20)
+- **Binance Smart Chain** - BNB + USDT (BEP-20)
+- **Polygon** - MATIC + USDT
+- **Arbitrum** - ARB + USDT
+
+**Total: 10 cryptocurrency options across 5 blockchains**
+
+## 📖 API Reference
+
+For complete API documentation, visit: [https://docs.fiddupay.com](https://docs.fiddupay.com)
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/new-feature`
+3. Commit changes: `git commit -am 'Add new feature'`
+4. Push to branch: `git push origin feature/new-feature`
+5. Submit a pull request
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## 🆘 Support
+
+- **Documentation**: [https://docs.fiddupay.com](https://docs.fiddupay.com)
+- **Issues**: [GitHub Issues](https://github.com/fiddupay/fiddupay-node/issues)
+- **Email**: support@fiddupay.com
+
+---
+
+**Made with ❤️ by the FidduPay Team**

package/dist/client.d.ts

@@ -0,0 +1,18 @@
+import { FidduPayConfig, RequestOptions } from './types';
+export declare class HttpClient {
+    private client;
+    private apiKey;
+    private maxRetries;
+    constructor(config: FidduPayConfig);
+    private getBaseURL;
+    private setupInterceptors;
+    private handleAPIError;
+    private generateRequestId;
+    private sleep;
+    request<T>(method: 'GET' | 'POST' | 'PUT' | 'DELETE', path: string, data?: any, options?: RequestOptions): Promise<T>;
+    get<T>(path: string, options?: RequestOptions): Promise<T>;
+    post<T>(path: string, data?: any, options?: RequestOptions): Promise<T>;
+    put<T>(path: string, data?: any, options?: RequestOptions): Promise<T>;
+    delete<T>(path: string, options?: RequestOptions): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAQzD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,cAAc;IAsBlC,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,iBAAiB;YAIX,KAAK;IAIb,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,EACzC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC;IA6DP,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1D,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAIvE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAItE,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;CAGpE"}

package/dist/client.js

@@ -0,0 +1,140 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const errors_1 = require("./errors");
+class HttpClient {
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.maxRetries = config.maxRetries || 3;
+        const baseURL = config.baseURL || this.getBaseURL(config.environment || 'sandbox');
+        this.client = axios_1.default.create({
+            baseURL,
+            timeout: config.timeout || 30000,
+            headers: {
+                'Content-Type': 'application/json',
+                'User-Agent': 'FidduPay-Node/1.0.0',
+                'Authorization': `Bearer ${this.apiKey}`
+            },
+            // Security configurations
+            maxRedirects: 0, // Prevent redirect attacks
+            validateStatus: (status) => status >= 200 && status < 300,
+        });
+        this.setupInterceptors();
+    }
+    getBaseURL(environment) {
+        return environment === 'production'
+            ? 'https://api.fiddupay.com/v1'
+            : 'https://api-sandbox.fiddupay.com/v1';
+    }
+    setupInterceptors() {
+        // Request interceptor
+        this.client.interceptors.request.use((config) => {
+            // Add request ID for tracking
+            config.headers['X-Request-ID'] = this.generateRequestId();
+            return config;
+        }, (error) => Promise.reject(error));
+        // Response interceptor
+        this.client.interceptors.response.use((response) => response, (error) => {
+            if (error.response) {
+                return Promise.reject(this.handleAPIError(error.response));
+            }
+            else if (error.request) {
+                return Promise.reject(new errors_1.FidduPayConnectionError('Network request failed'));
+            }
+            else {
+                return Promise.reject(new errors_1.FidduPayConnectionError(error.message));
+            }
+        });
+    }
+    handleAPIError(response) {
+        const { status, data } = response;
+        const message = data?.error?.message || data?.message || 'API request failed';
+        const code = data?.error?.code || data?.code;
+        const requestId = response.headers['x-request-id'];
+        switch (status) {
+            case 401:
+                return new errors_1.FidduPayAuthenticationError(message);
+            case 429:
+                const retryAfter = parseInt(response.headers['retry-after']) || undefined;
+                return new errors_1.FidduPayRateLimitError(message, retryAfter);
+            default:
+                return new errors_1.FidduPayAPIError(message, status, code, requestId);
+        }
+    }
+    generateRequestId() {
+        return `req_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    async sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    async request(method, path, data, options = {}) {
+        const config = {
+            method,
+            url: path,
+            timeout: options.timeout,
+        };
+        if (data) {
+            config.data = data;
+        }
+        if (options.idempotencyKey) {
+            config.headers = {
+                ...config.headers,
+                'Idempotency-Key': options.idempotencyKey
+            };
+        }
+        const maxRetries = options.retries !== undefined ? options.retries : this.maxRetries;
+        let lastError;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                const response = await this.client.request(config);
+                return response.data;
+            }
+            catch (error) {
+                lastError = error;
+                // Don't retry on authentication errors or client errors (4xx except 429)
+                if (error instanceof errors_1.FidduPayAuthenticationError) {
+                    throw error;
+                }
+                if (error instanceof errors_1.FidduPayAPIError && error.statusCode) {
+                    if (error.statusCode >= 400 && error.statusCode < 500 && error.statusCode !== 429) {
+                        throw error;
+                    }
+                }
+                // Don't retry on the last attempt
+                if (attempt === maxRetries) {
+                    break;
+                }
+                // Calculate backoff delay
+                const baseDelay = Math.pow(2, attempt) * 1000; // Exponential backoff
+                const jitter = Math.random() * 1000; // Add jitter
+                const delay = baseDelay + jitter;
+                // For rate limit errors, respect the Retry-After header
+                if (error instanceof errors_1.FidduPayRateLimitError && error.retryAfter) {
+                    await this.sleep(error.retryAfter * 1000);
+                }
+                else {
+                    await this.sleep(delay);
+                }
+            }
+        }
+        throw lastError;
+    }
+    async get(path, options) {
+        return this.request('GET', path, undefined, options);
+    }
+    async post(path, data, options) {
+        return this.request('POST', path, data, options);
+    }
+    async put(path, data, options) {
+        return this.request('PUT', path, data, options);
+    }
+    async delete(path, options) {
+        return this.request('DELETE', path, undefined, options);
+    }
+}
+exports.HttpClient = HttpClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors/index.d.ts

@@ -0,0 +1,28 @@
+export declare class FidduPayError extends Error {
+    readonly type: string;
+    readonly code?: string;
+    readonly statusCode?: number;
+    readonly requestId?: string;
+    constructor(message: string, type?: string);
+}
+export declare class FidduPayAPIError extends FidduPayError {
+    readonly statusCode: number;
+    readonly code?: string;
+    readonly requestId?: string;
+    constructor(message: string, statusCode: number, code?: string, requestId?: string);
+}
+export declare class FidduPayValidationError extends FidduPayError {
+    readonly param?: string;
+    constructor(message: string, param?: string);
+}
+export declare class FidduPayAuthenticationError extends FidduPayError {
+    constructor(message?: string);
+}
+export declare class FidduPayRateLimitError extends FidduPayError {
+    readonly retryAfter?: number;
+    constructor(message?: string, retryAfter?: number);
+}
+export declare class FidduPayConnectionError extends FidduPayError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAEA,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAyB;CAM7D;AAED,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGjC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM;CASrB;AAED,qBAAa,uBAAwB,SAAQ,aAAa;IACxD,SAAgB,KAAK,CAAC,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAM5C;AAED,qBAAa,2BAA4B,SAAQ,aAAa;gBAChD,OAAO,GAAE,MAAmC;CAKzD;AAED,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,OAAO,GAAE,MAA4B,EAAE,UAAU,CAAC,EAAE,MAAM;CAMvE;AAED,qBAAa,uBAAwB,SAAQ,aAAa;gBAC5C,OAAO,GAAE,MAAoC;CAK1D"}

package/dist/errors/index.js

@@ -0,0 +1,59 @@
+"use strict";
+// Custom error classes for FidduPay SDK
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FidduPayConnectionError = exports.FidduPayRateLimitError = exports.FidduPayAuthenticationError = exports.FidduPayValidationError = exports.FidduPayAPIError = exports.FidduPayError = void 0;
+class FidduPayError extends Error {
+    constructor(message, type = 'fiddupay_error') {
+        super(message);
+        this.name = 'FidduPayError';
+        this.type = type;
+        Object.setPrototypeOf(this, FidduPayError.prototype);
+    }
+}
+exports.FidduPayError = FidduPayError;
+class FidduPayAPIError extends FidduPayError {
+    constructor(message, statusCode, code, requestId) {
+        super(message, 'api_error');
+        this.name = 'FidduPayAPIError';
+        this.statusCode = statusCode;
+        this.code = code;
+        this.requestId = requestId;
+        Object.setPrototypeOf(this, FidduPayAPIError.prototype);
+    }
+}
+exports.FidduPayAPIError = FidduPayAPIError;
+class FidduPayValidationError extends FidduPayError {
+    constructor(message, param) {
+        super(message, 'validation_error');
+        this.name = 'FidduPayValidationError';
+        this.param = param;
+        Object.setPrototypeOf(this, FidduPayValidationError.prototype);
+    }
+}
+exports.FidduPayValidationError = FidduPayValidationError;
+class FidduPayAuthenticationError extends FidduPayError {
+    constructor(message = 'Invalid API key provided') {
+        super(message, 'authentication_error');
+        this.name = 'FidduPayAuthenticationError';
+        Object.setPrototypeOf(this, FidduPayAuthenticationError.prototype);
+    }
+}
+exports.FidduPayAuthenticationError = FidduPayAuthenticationError;
+class FidduPayRateLimitError extends FidduPayError {
+    constructor(message = 'Too many requests', retryAfter) {
+        super(message, 'rate_limit_error');
+        this.name = 'FidduPayRateLimitError';
+        this.retryAfter = retryAfter;
+        Object.setPrototypeOf(this, FidduPayRateLimitError.prototype);
+    }
+}
+exports.FidduPayRateLimitError = FidduPayRateLimitError;
+class FidduPayConnectionError extends FidduPayError {
+    constructor(message = 'Network connection failed') {
+        super(message, 'connection_error');
+        this.name = 'FidduPayConnectionError';
+        Object.setPrototypeOf(this, FidduPayConnectionError.prototype);
+    }
+}
+exports.FidduPayConnectionError = FidduPayConnectionError;
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":";AAAA,wCAAwC;;;AAExC,MAAa,aAAc,SAAQ,KAAK;IAMtC,YAAY,OAAe,EAAE,OAAe,gBAAgB;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;CACF;AAZD,sCAYC;AAED,MAAa,gBAAiB,SAAQ,aAAa;IAKjD,YACE,OAAe,EACf,UAAkB,EAClB,IAAa,EACb,SAAkB;QAElB,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;CACF;AAlBD,4CAkBC;AAED,MAAa,uBAAwB,SAAQ,aAAa;IAGxD,YAAY,OAAe,EAAE,KAAc;QACzC,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC;IACjE,CAAC;CACF;AATD,0DASC;AAED,MAAa,2BAA4B,SAAQ,aAAa;IAC5D,YAAY,UAAkB,0BAA0B;QACtD,KAAK,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,2BAA2B,CAAC,SAAS,CAAC,CAAC;IACrE,CAAC;CACF;AAND,kEAMC;AAED,MAAa,sBAAuB,SAAQ,aAAa;IAGvD,YAAY,UAAkB,mBAAmB,EAAE,UAAmB;QACpE,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC;CACF;AATD,wDASC;AAED,MAAa,uBAAwB,SAAQ,aAAa;IACxD,YAAY,UAAkB,2BAA2B;QACvD,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC;IACjE,CAAC;CACF;AAND,0DAMC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import { FidduPayConfig } from './types';
+import { Payments } from './resources/payments';
+import { Merchants } from './resources/merchants';
+import { Refunds } from './resources/refunds';
+import { AnalyticsResource } from './resources/analytics';
+import { Webhooks } from './resources/webhooks';
+export declare class FidduPay {
+    private client;
+    readonly payments: Payments;
+    readonly merchants: Merchants;
+    readonly refunds: Refunds;
+    readonly analytics: AnalyticsResource;
+    readonly webhooks: typeof Webhooks;
+    constructor(config: FidduPayConfig);
+    private validateConfig;
+}
+export * from './types';
+export * from './errors';
+export { Webhooks } from './resources/webhooks';
+export default FidduPay;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAa;IAE3B,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IACnC,SAAgB,SAAS,EAAE,SAAS,CAAC;IACrC,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,SAAgB,SAAS,EAAE,iBAAiB,CAAC;IAC7C,SAAgB,QAAQ,kBAAY;gBAExB,MAAM,EAAE,cAAc;IAYlC,OAAO,CAAC,cAAc;CAqBvB;AAGD,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD,eAAe,QAAQ,CAAC"}

package/dist/index.js

@@ -0,0 +1,62 @@
+"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 __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.Webhooks = exports.FidduPay = void 0;
+const client_1 = require("./client");
+const errors_1 = require("./errors");
+const payments_1 = require("./resources/payments");
+const merchants_1 = require("./resources/merchants");
+const refunds_1 = require("./resources/refunds");
+const analytics_1 = require("./resources/analytics");
+const webhooks_1 = require("./resources/webhooks");
+class FidduPay {
+    constructor(config) {
+        this.webhooks = webhooks_1.Webhooks;
+        this.validateConfig(config);
+        this.client = new client_1.HttpClient(config);
+        // Initialize resource classes
+        this.payments = new payments_1.Payments(this.client);
+        this.merchants = new merchants_1.Merchants(this.client);
+        this.refunds = new refunds_1.Refunds(this.client);
+        this.analytics = new analytics_1.AnalyticsResource(this.client);
+    }
+    validateConfig(config) {
+        if (!config.apiKey) {
+            throw new errors_1.FidduPayValidationError('API key is required');
+        }
+        if (!config.apiKey.startsWith('sk_')) {
+            throw new errors_1.FidduPayValidationError('Invalid API key format. API key must start with "sk_"');
+        }
+        if (config.environment && !['sandbox', 'production'].includes(config.environment)) {
+            throw new errors_1.FidduPayValidationError('Environment must be either "sandbox" or "production"');
+        }
+        if (config.timeout && (config.timeout < 1000 || config.timeout > 60000)) {
+            throw new errors_1.FidduPayValidationError('Timeout must be between 1000ms and 60000ms');
+        }
+        if (config.maxRetries && (config.maxRetries < 0 || config.maxRetries > 10)) {
+            throw new errors_1.FidduPayValidationError('Max retries must be between 0 and 10');
+        }
+    }
+}
+exports.FidduPay = FidduPay;
+// Export everything
+__exportStar(require("./types"), exports);
+__exportStar(require("./errors"), exports);
+var webhooks_2 = require("./resources/webhooks");
+Object.defineProperty(exports, "Webhooks", { enumerable: true, get: function () { return webhooks_2.Webhooks; } });
+// Default export
+exports.default = FidduPay;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qCAAsC;AAEtC,qCAAmD;AACnD,mDAAgD;AAChD,qDAAkD;AAClD,iDAA8C;AAC9C,qDAA0D;AAC1D,mDAAgD;AAEhD,MAAa,QAAQ;IASnB,YAAY,MAAsB;QAFlB,aAAQ,GAAG,mBAAQ,CAAC;QAGlC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAE5B,IAAI,CAAC,MAAM,GAAG,IAAI,mBAAU,CAAC,MAAM,CAAC,CAAC;QAErC,8BAA8B;QAC9B,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,OAAO,GAAG,IAAI,iBAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,SAAS,GAAG,IAAI,6BAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtD,CAAC;IAEO,cAAc,CAAC,MAAsB;QAC3C,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,gCAAuB,CAAC,qBAAqB,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,gCAAuB,CAAC,uDAAuD,CAAC,CAAC;QAC7F,CAAC;QAED,IAAI,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;YAClF,MAAM,IAAI,gCAAuB,CAAC,sDAAsD,CAAC,CAAC;QAC5F,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,gCAAuB,CAAC,4CAA4C,CAAC,CAAC;QAClF,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,IAAI,MAAM,CAAC,UAAU,GAAG,EAAE,CAAC,EAAE,CAAC;YAC3E,MAAM,IAAI,gCAAuB,CAAC,sCAAsC,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;CACF;AA1CD,4BA0CC;AAED,oBAAoB;AACpB,0CAAwB;AACxB,2CAAyB;AACzB,iDAAgD;AAAvC,oGAAA,QAAQ,OAAA;AAEjB,iBAAiB;AACjB,kBAAe,QAAQ,CAAC"}

package/dist/resources/analytics.d.ts

@@ -0,0 +1,30 @@
+import { HttpClient } from '../client';
+import { Analytics, RequestOptions } from '../types';
+export declare class AnalyticsResource {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * Get analytics data
+     */
+    retrieve(params?: {
+        start_date?: string;
+        end_date?: string;
+        granularity?: 'day' | 'week' | 'month';
+    }, options?: RequestOptions): Promise<Analytics>;
+    /**
+     * Export analytics data
+     */
+    export(params: {
+        format: 'csv' | 'json' | 'xlsx';
+        start_date: string;
+        end_date: string;
+    }, options?: RequestOptions): Promise<{
+        export_id: string;
+        status: string;
+        format: string;
+        download_url: string | null;
+        expires_at: string;
+        created_at: string;
+    }>;
+}
+//# sourceMappingURL=analytics.d.ts.map

package/dist/resources/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/resources/analytics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAErD,qBAAa,iBAAiB;IAChB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC;;OAEG;IACG,QAAQ,CAAC,MAAM,CAAC,EAAE;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;KACxC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAahD;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE;QACnB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;QAChC,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;KAClB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;QACpC,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CAGH"}