finconnect 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Elisha Gerson
+
+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,328 @@
+# FinConnect
+
+<div align="center">
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-16+-green.svg)](https://nodejs.org/)
+
+**A unified wrapper for East African fintech payment providers**
+
+[Features](#features) • [Quick Start](#quick-start) • [Supported Providers](#supported-providers) • [Documentation](#documentation) • [Contributing](#contributing)
+
+</div>
+
+---
+
+## Overview
+
+FinConnect is a lightweight, provider-agnostic integration wrapper that simplifies payment processing across multiple East African fintech platforms. Instead of managing different authentication flows, payload structures, and error handling for each provider, FinConnect provides a **single, unified API** for PesaPal, AzamPay, ClickPesa, and more.
+
+### The Problem We Solve
+
+Integrating multiple payment providers typically requires:
+- Learning different authentication flows (OAuth2 vs. JWT)
+- Managing different payload structures per provider
+- Implementing custom error handling for each API
+- Maintaining complex provider-specific logic
+
+FinConnect eliminates this complexity with a consistent, developer-friendly interface.
+
+---
+
+## ✨ Features
+
+- 🔌 **Provider-Agnostic API** - Single interface for multiple payment providers
+- 🔐 **Multi-Auth Support** - OAuth2, JWT, Bearer tokens handled transparently
+- ⚡ **Type-Safe** - Full TypeScript support with complete type definitions
+- 🌍 **Regional Coverage** - PesaPal (East Africa), AzamPay (Tanzania), ClickPesa (East Africa)
+- 🛡️ **Error Handling** - Consistent error messages and status tracking
+- 🔄 **Async/Await Ready** - Modern async patterns throughout
+- 📝 **Well-Documented** - Comprehensive examples and API documentation
+
+---
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+- Node.js 16.x or later
+- npm 7.x or later
+
+### Installation
+
+```bash
+npm install finconnect
+```
+
+Or from the repository source:
+
+```bash
+# Clone the repository
+git clone https://github.com/somebody1011/finconnect.git
+
+# Navigate to project directory
+cd finconnect
+
+# Install dependencies
+npm install
+```
+
+### Configuration
+
+Create a `.env` file in your root directory with your provider credentials:
+
+```env
+# PesaPal Configuration
+PESAPAL_APP_KEY=your_key
+PESAPAL_APP_SECRET=your_secret
+
+
+# AzamPay Configuration
+AZAMPAY_SECRET=your_secret
+
+# ClickPesa Configuration
+CLICKPESA_CLIENT_ID=your_id
+CLICKPESA_API_KEY=your_api_key
+```
+
+### Basic Usage
+
+```typescript
+import { FintechGateway } from './src/index';
+
+// Initialize gateway for pesapal
+const gateway = new FintechGateway('pesapal', {
+  apiKey: process.env.PESAPAL_CONSUMER_KEY,
+  apiSecret: process.env.PESAPAL_CONSUMER_SECRET,
+  shortCode: '174379',
+  environment: 'sandbox'
+});
+
+// Process a payment
+async function processPayment() {
+  try {
+    const response = await gateway.processPayment({
+      amount: 1000,
+      phoneNumber: '255700000000',
+      reference: 'REF-99'
+    });
+
+    if (response.success) {
+      console.log(`✅ Payment successful! Transaction ID: ${response.transactionId}`);
+    } else {
+      console.error(`❌ Payment failed: ${response.message}`);
+    }
+  } catch (error) {
+    console.error('Error processing payment:', error);
+  }
+}
+
+processPayment();
+```
+
+---
+
+## 🏗️ Supported Providers
+
+| Provider | Status | Auth Method | Region(s) |
+|----------|--------|-------------|-----------|
+| **ClickPesa** |🚧🛠️ Onprogress | JWT | East Africa |
+| **PesaPal** | 🚧🛠️ Onprogress| OAuth2 | East Africa |
+| **AzamPay** |  📋 Planned   | Bearer/Secret | Tanzania |
+
+
+---
+
+## 📚 API Reference
+
+### FintechGateway
+
+#### Constructor
+
+```typescript
+new FintechGateway(provider: string, config: ProviderConfig)
+```
+
+**Parameters:**
+- `provider` - The payment provider identifier ('pesapal', 'azampay', 'clickpesa')
+- `config` - Provider-specific configuration object
+
+#### Methods
+
+##### `processPayment()`
+
+```typescript
+processPayment(params: PaymentParams): Promise<PaymentResponse>
+```
+
+**Parameters:**
+```typescript
+interface PaymentParams {
+  amount: number;
+  phoneNumber: string;
+  reference: string;
+  description?: string;
+}
+```
+
+**Returns:**
+```typescript
+interface PaymentResponse {
+  success: boolean;
+  transactionId?: string;
+  message: string;
+  status: 'pending' | 'completed' | 'failed';
+  timestamp: Date;
+}
+```
+
+**Example:**
+```typescript
+const result = await gateway.processPayment({
+  amount: 5000,
+  phoneNumber: '254712345678',
+  reference: 'ORD-2024-001',
+  description: 'Payment for order #123'
+});
+```
+
+---
+
+## 📁 Project Structure
+
+```
+finconnect/
+├── src/
+│   ├── FintechGateway.ts        # Main gateway class
+│   ├── providers/
+│   │   ├── BaseProvider.ts      # Abstract base class
+│   │   ├── MpesaProvider.ts     # M-Pesa implementation
+│   │   ├── AzampayProvider.ts   # AzamPay implementation
+│   │   └── ClickpesaProvider.ts # ClickPesa implementation
+│   ├── types/
+│   │   └── index.ts             # TypeScript type definitions
+│   └── utils/
+│       └── errorHandler.ts      # Error handling utilities
+├── tests/
+│   ├── unit/
+│   └── integration/
+├── .env.example
+├── package.json
+├── tsconfig.json
+├── jest.config.js
+└── README.md
+```
+
+---
+
+## 🔒 Security Best Practices
+
+1. **Never commit credentials** - Use `.env` files and add them to `.gitignore`
+2. **Use environment variables** - Store sensitive keys outside version control
+3. **Validate inputs** - Always validate payment amounts and phone numbers
+4. **HTTPS only** - All API calls are made over HTTPS
+5. **Error messages** - Avoid exposing sensitive details in error responses
+
+**Example:**
+```typescript
+// ❌ DO NOT DO THIS
+const gateway = new FintechGateway('mpesa', {
+  apiKey: 'your_actual_key_here'
+});
+
+// ✅ DO THIS
+const gateway = new FintechGateway('pesapal', {
+  apiKey: process.env.PESAPAL_CONSUMER_KEY,
+  apiSecret: process.env.PESAPAL_CONSUMER_SECRET
+});
+```
+
+---
+
+## 🗺️ Roadmap
+
+- [x] ClickPesa integration
+- [x] PesaPal integration
+- [ ] AzamPay integration
+- [ ] Add B2C (Business to Customer) support
+- [ ] Implement automatic retry logic for failed API calls
+- [ ] Add comprehensive unit tests using Jest
+- [ ] Add rate limiting and throttling
+- [ ] Support for transaction status polling
+- [ ] Webhook integration for payment notifications
+- [ ] SDK for React Native
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! Here's how to get started:
+
+1. **Fork the repository** on GitHub
+2. **Create a feature branch** for your changes:
+   ```bash
+   git checkout -b feature/add-new-provider
+   ```
+3. **Add a new provider** (if applicable):
+   - Create a new file in `src/providers/` (e.g., `NewProviderName.ts`)
+   - Extend the `BaseProvider` class
+   - Implement required methods: `authenticate()`, `processPayment()`, `getTransactionStatus()`
+4. **Add tests** for your changes:
+   ```bash
+   npm test
+   ```
+5. **Commit your changes** with clear messages:
+   ```bash
+   git commit -m "Add support for XYZ provider"
+   ```
+6. **Push to your fork** and submit a Pull Request
+
+### Development Setup
+
+```bash
+# Install dev dependencies
+npm install --save-dev
+
+# Run tests
+npm test
+
+# Build the project
+npm run build
+
+# Lint the code
+npm run lint
+```
+
+---
+
+## 📝 License
+
+This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
+
+---
+
+## 📞 Support & Contact
+
+- **Issues** - Report bugs or request features via [GitHub Issues](https://github.com/somebody1011/finconnect/issues)
+- **Discussions** - Join our community discussions [here](https://github.com/somebody1011/finconnect/discussions)
+- **Author** - [@somebody1011](https://github.com/somebody1011)
+
+---
+
+## 🙏 Acknowledgments
+
+- Built with ❤️ for the East African fintech community
+- Inspired by Stripe's elegant API design
+- Special thanks to all contributors and early users
+- Thanks to the open-source community for amazing tools and libraries
+
+---
+
+<div align="center">
+
+Made with ❤️ by [somebody1011](https://github.com/somebody1011)
+
+⭐ Star us on GitHub! [somebody1011/finconnect](https://github.com/somebody1011/finconnect)
+
+</div>

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export declare const ProviderType: {
+    readonly clickpesa: "clickpesa";
+    readonly pesapal: "pesapal";
+    readonly azampay: "azampay";
+};
+export type ProviderType = typeof ProviderType[keyof typeof ProviderType];
+export declare class FintechSDK {
+    private gateway;
+    constructor(options: {
+        provider: ProviderType | string;
+        config: any;
+    });
+    registerIpn(ipnUrl: string, ipnNotificationType?: "GET" | "POST"): Promise<any>;
+    pay(data: any, ipnId?: string): Promise<any>;
+    checkPaymentStatus(transactionId: string): Promise<any>;
+    handleCallback(callbackData: any): Promise<{
+        isValid: boolean;
+        data: any;
+    }>;
+}
+//# 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":"AAKA,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAuC1E,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAe;gBAElB,OAAO,EAAE;QAAE,QAAQ,EAAE,YAAY,GAAG,MAAM,CAAC;QAAC,MAAM,EAAE,GAAG,CAAA;KAAE;IAK/D,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAE,KAAK,GAAG,MAAc;IAKvE,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM;IAc7B,kBAAkB,CAAC,aAAa,EAAE,MAAM;IAIxC,cAAc,CAAC,YAAY,EAAE,GAAG;;;;CAMvC"}

package/dist/index.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FintechSDK = exports.ProviderType = void 0;
+const ClickpesaProvider_js_1 = require("./providers/ClickpesaProvider.js");
+const PesapalProvider_js_1 = require("./providers/PesapalProvider.js");
+const AzampayProvider_js_1 = require("./providers/AzampayProvider.js");
+exports.ProviderType = {
+    clickpesa: 'clickpesa',
+    pesapal: 'pesapal',
+    azampay: 'azampay',
+};
+class ProviderFactory {
+    /**
+     * Factory method to create a specific provider instance.
+     *
+     * Security Considerations:
+     * 1. Validates the provider type against an allowed list via a switch statement,
+     *    preventing prototype pollution or instantiation of arbitrary objects.
+     * 2. Throws an explicit error for unsupported providers, avoiding silent failures.
+     * 3. Validates that essential configuration parameters are present before instantiating.
+     */
+    static createProvider(provider, config) {
+        switch (String(provider).toLowerCase()) {
+            case exports.ProviderType.clickpesa:
+                if (!config || !config.baseUrl || !config.CLICKPESA_CLIENT_ID || !config.CLICKPESA_API_KEY) {
+                    throw new Error("Invalid configuration: Missing required fields for Clickpesa.");
+                }
+                return new ClickpesaProvider_js_1.ClickpesaProvider(config);
+            case exports.ProviderType.pesapal:
+                if (!config || !config.baseUrl || !config.PESAPAL_CONSUMER_KEY || !config.PESAPAL_CONSUMER_SECRET) {
+                    throw new Error("Invalid configuration: Missing required fields for Pesapal.");
+                }
+                return new PesapalProvider_js_1.PesapalProvider(config);
+            case exports.ProviderType.azampay:
+                if (!config || !config.baseUrl || !config.AZAMPAY_APP_NAME || !config.AZAMPAY_CONSUMER_KEY || !config.AZAMPAY_CONSUMER_SECRET) {
+                    throw new Error("Invalid configuration: Missing required fields for Azampay.");
+                }
+                return new AzampayProvider_js_1.AzampayProvider(config);
+            default:
+                // Security: Fail securely if an unknown provider is requested.
+                throw new Error(`Unsupported provider type: ${String(provider)}`);
+        }
+    }
+}
+class FintechSDK {
+    gateway;
+    constructor(options) {
+        // Utilize the secure ProviderFactory to instantiate the gateway
+        this.gateway = ProviderFactory.createProvider(options.provider, options.config);
+    }
+    async registerIpn(ipnUrl, ipnNotificationType = "GET") {
+        // Allows the user to register an IPN and retrieve an ipnId
+        return this.gateway.registerIpn(ipnUrl, ipnNotificationType);
+    }
+    async pay(data, ipnId) {
+        // Normalizes the data structure depending on what the underlying provider expects.
+        if (this.gateway instanceof PesapalProvider_js_1.PesapalProvider) {
+            // Pesapal expects an object with payload and ipnId
+            return this.gateway.initiateUssdPushRequest({ payload: data, ipnId });
+        }
+        else if (this.gateway instanceof AzampayProvider_js_1.AzampayProvider) {
+            // Azampay expects an object with payload
+            return this.gateway.initiateUssdPushRequest({ payload: data });
+        }
+        else {
+            // Clickpesa and others expect the raw payload directly
+            return this.gateway.initiateUssdPushRequest(data);
+        }
+    }
+    async checkPaymentStatus(transactionId) {
+        return this.gateway.checkPaymentStatus({ transactionId });
+    }
+    async handleCallback(callbackData) {
+        if (this.gateway instanceof AzampayProvider_js_1.AzampayProvider) {
+            return this.gateway.handleCallback(callbackData);
+        }
+        throw new Error(`Callback handling is not supported for provider ${this.gateway.constructor.name}`);
+    }
+}
+exports.FintechSDK = FintechSDK;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/providers/AzampayProvider.d.ts

@@ -0,0 +1,18 @@
+import { baseProvider } from "./BaseProvider.js";
+export declare class AzampayProvider extends baseProvider {
+    constructor(config: any);
+    authenticate(): Promise<string>;
+    initiateUssdPushRequest({ payload }: {
+        payload: any;
+    }): Promise<any>;
+    checkPaymentStatus(params: {
+        transactionId: string;
+    }): Promise<any>;
+    getPublicKey(): Promise<string>;
+    verifyCallbackSignature(utilityRef: string, externalReference: string, transactionStatus: string, operatorName: string, signatureBase64: string, publicKeyPem: string): boolean;
+    handleCallback(callbackData: any): Promise<{
+        isValid: boolean;
+        data: any;
+    }>;
+}
+//# sourceMappingURL=AzampayProvider.d.ts.map

package/dist/providers/AzampayProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AzampayProvider.d.ts","sourceRoot":"","sources":["../../src/providers/AzampayProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAM/C,qBAAa,eAAgB,SAAQ,YAAY;gBACjC,MAAM,EAAE,GAAG;IAIjB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IA2B/B,uBAAuB,CAAC,EAAE,OAAO,EAAE,EAAE;QAAE,OAAO,EAAE,GAAG,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IA4BpE,kBAAkB,CAAC,MAAM,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAKnE,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAcrC,uBAAuB,CACnB,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,EACzB,iBAAiB,EAAE,MAAM,EACzB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,GACrB,OAAO;IAQJ,cAAc,CAAC,YAAY,EAAE,GAAG,GAAG,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAC,CAAC;CAkBlF"}

package/dist/providers/AzampayProvider.js

@@ -0,0 +1,134 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AzampayProvider = void 0;
+const BaseProvider_js_1 = require("./BaseProvider.js");
+const dotenv = __importStar(require("dotenv"));
+dotenv.config();
+const axios_1 = __importDefault(require("axios"));
+const crypto = __importStar(require("crypto"));
+class AzampayProvider extends BaseProvider_js_1.baseProvider {
+    constructor(config) {
+        super(config);
+    }
+    async authenticate() {
+        try {
+            const response = await axios_1.default.post(` https://authenticator-sandbox.azampay.co.tz/AppRegistration/GenerateToken`, {
+                'appName': this.config.AZAMPAY_APP_NAME,
+                'clientId': this.config.AZAMPAY_CONSUMER_KEY,
+                'clientSecret': this.config.AZAMPAY_CONSUMER_SECRET,
+            }, {
+                headers: {
+                    'Content-Type': 'application/json',
+                }
+            });
+            return response.data.data.accessToken;
+        }
+        catch (error) {
+            if (error.response) {
+                console.error('Authentication Error Response:', error.response.data);
+                throw new Error(`Authentication failed: ${error.response.data.message || error.message}`);
+            }
+            throw new Error(`Authentication failed: ${error}`);
+        }
+    }
+    async initiateUssdPushRequest({ payload }) {
+        try {
+            const token = await this.authenticate();
+            // console.log('Obtained Auth Token:', token); // Debug log for token  
+            const response = await axios_1.default.post(`${this.config.baseUrl}/azampay/mno/checkout`, payload, {
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${token}`,
+                }
+            });
+            return response.data.transactionId;
+        }
+        catch (error) {
+            if (error.response) {
+                console.error('USSD Push Request Error Response:', error.response.data);
+                throw new Error(`Payment request failed: ${error.response.data.message || error.message}`);
+            }
+            throw new Error(`Payment request failed: ${error.message || error}`);
+        }
+    }
+    //  Check Transaction Status (Unsupported in Tanzania Sandbox)
+    async checkPaymentStatus(params) {
+        throw new Error("AzamPay Tanzania does not support polling for payment status. Please use the Webhook Callback (handleCallback) strategy instead.");
+    }
+    // Handle Payment Callback with Signature Verification 
+    async getPublicKey() {
+        try {
+            const token = await this.authenticate();
+            const response = await axios_1.default.get(`${this.config.baseUrl}/azampay/v1/public-key?format=Pem`, {
+                headers: {
+                    'Authorization': `Bearer ${token}`
+                }
+            });
+            return response.data.publicKey;
+        }
+        catch (error) {
+            throw new Error(`Failed to fetch public key: ${error.message}`);
+        }
+    }
+    verifyCallbackSignature(utilityRef, externalReference, transactionStatus, operatorName, signatureBase64, publicKeyPem) {
+        const dataToVerify = `${utilityRef}${externalReference}${transactionStatus}${operatorName}`;
+        const verifier = crypto.createVerify('SHA256');
+        verifier.update(dataToVerify, 'utf8');
+        verifier.end();
+        return verifier.verify(publicKeyPem, signatureBase64, 'base64');
+    }
+    async handleCallback(callbackData) {
+        try {
+            const publicKeyPem = await this.getPublicKey();
+            const isValid = this.verifyCallbackSignature(callbackData.utilityref || '', callbackData.externalreference || '', callbackData.transactionstatus || '', callbackData.operator || '', callbackData.signature || '', publicKeyPem);
+            return { isValid, data: callbackData };
+        }
+        catch (error) {
+            throw new Error(`Callback handling failed: ${error.message}`);
+        }
+    }
+}
+exports.AzampayProvider = AzampayProvider;
+// async function testAzampay() {
+//     const azampay = new AzampayProvider({baseUrl:process.env.AZAMPAY_BASE_URL,AZAMPAY_APP_NAME:process.env.AZAMPAY_APP_NAME, AZAMPAY_CONSUMER_KEY:process.env.AZAMPAY_CLIENT_ID, AZAMPAY_CONSUMER_SECRET:process.env.AZAMPAY_API_KEY});
+//     const auth = await azampay.authenticate();
+//     console.log('Auth token:', auth);
+// }
+// testAzampay()
+//# sourceMappingURL=AzampayProvider.js.map

package/dist/providers/AzampayProvider.js.map

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

package/dist/providers/BaseProvider.d.ts

@@ -0,0 +1,14 @@
+export declare abstract class baseProvider {
+    protected config: any;
+    constructor(config: any);
+    abstract authenticate(): Promise<string>;
+    abstract initiateUssdPushRequest(params: {
+        payload: any;
+        ipnId?: string;
+    }): Promise<any>;
+    abstract checkPaymentStatus(params: {
+        transactionId: string;
+    }): Promise<any>;
+    registerIpn(_ipnUrl: string, _ipnNotificationType: "GET" | "POST"): Promise<any>;
+}
+//# sourceMappingURL=BaseProvider.d.ts.map

package/dist/providers/BaseProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseProvider.d.ts","sourceRoot":"","sources":["../../src/providers/BaseProvider.ts"],"names":[],"mappings":"AACA,8BAAsB,YAAY;IAChC,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC;gBACV,MAAM,EAAE,GAAG;IAGvB,QAAQ,CAAC,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IACxC,QAAQ,CAAC,uBAAuB,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IACxF,QAAQ,CAAC,kBAAkB,CAAC,MAAM,EAAC;QAAC,aAAa,EAAC,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAClE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;CAGvF"}

package/dist/providers/BaseProvider.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.baseProvider = void 0;
+// Add 'export' right here
+class baseProvider {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async registerIpn(_ipnUrl, _ipnNotificationType) {
+        throw new Error("IPN registration not supported by this provider");
+    }
+}
+exports.baseProvider = baseProvider;
+//# sourceMappingURL=BaseProvider.js.map

package/dist/providers/BaseProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseProvider.js","sourceRoot":"","sources":["../../src/providers/BaseProvider.ts"],"names":[],"mappings":";;;AAAA,0BAA0B;AAC1B,MAAsB,YAAY;IACtB,MAAM,CAAM;IACtB,YAAY,MAAW;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAID,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,oBAAoC;QACrE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;CACF;AAXD,oCAWC"}

package/dist/providers/ClickpesaProvider.d.ts

@@ -0,0 +1,10 @@
+import { baseProvider } from "./BaseProvider.js";
+export declare class ClickpesaProvider extends baseProvider {
+    constructor(config: any);
+    authenticate(): Promise<string>;
+    initiateUssdPushRequest(payload: any): Promise<any>;
+    checkPaymentStatus(params: {
+        transactionId: string;
+    }): Promise<any>;
+}
+//# sourceMappingURL=ClickpesaProvider.d.ts.map

package/dist/providers/ClickpesaProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClickpesaProvider.d.ts","sourceRoot":"","sources":["../../src/providers/ClickpesaProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMjD,qBAAa,iBAAkB,SAAQ,YAAY;gBACrC,MAAM,EAAE,GAAG;IAIjB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAkB/B,uBAAuB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAoBnD,kBAAkB,CAAC,MAAM,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;CAkB1E"}

package/dist/providers/ClickpesaProvider.js

@@ -0,0 +1,99 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClickpesaProvider = void 0;
+const BaseProvider_js_1 = require("./BaseProvider.js");
+const axios_1 = __importDefault(require("axios"));
+const dotenv = __importStar(require("dotenv"));
+dotenv.config();
+class ClickpesaProvider extends BaseProvider_js_1.baseProvider {
+    constructor(config) {
+        super(config);
+    }
+    async authenticate() {
+        try {
+            const response = await axios_1.default.post(`${this.config.baseUrl}/third-parties/generate-token`, {
+                headers: {
+                    'client-id': this.config.CLICKPESA_CLIENT_ID,
+                    'api-key': this.config.CLICKPESA_API_KEY,
+                    "Content-Type": "application/json",
+                },
+            });
+            return response.data?.token || response.data;
+        }
+        catch (error) {
+            throw new Error(`Authentication failed: ${error}`);
+        }
+    }
+    async initiateUssdPushRequest(payload) {
+        try {
+            const token = await this.authenticate();
+            const response = await axios_1.default.post(`${this.config.baseUrl}/third-parties/payments/initiate-ussd-push-request`, // Added /third-parties/
+            payload, {
+                headers: {
+                    "Content-Type": "application/json",
+                    "Authorization": token,
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            console.error('USSD Push Error:', error.response?.data || error.message);
+            throw new Error(`Payment request failed: ${error.response?.data?.message || error.message}`);
+        }
+    }
+    async checkPaymentStatus(params) {
+        try {
+            const token = await this.authenticate();
+            const response = await axios_1.default.get(`${this.config.baseUrl}/third-parties/payments/${params.transactionId}`, // Added /third-parties/
+            {
+                headers: {
+                    'Accept': 'application/json',
+                    'Content-Type': 'application/json',
+                    'Authorization': token,
+                }
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw new Error(`Payment status check failed: ${error}`);
+        }
+    }
+}
+exports.ClickpesaProvider = ClickpesaProvider;
+//# sourceMappingURL=ClickpesaProvider.js.map

package/dist/providers/ClickpesaProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClickpesaProvider.js","sourceRoot":"","sources":["../../src/providers/ClickpesaProvider.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uDAAiD;AACjD,kDAA0B;AAC1B,+CAAiC;AAEjC,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,MAAa,iBAAkB,SAAQ,8BAAY;IACjD,YAAY,MAAW;QACrB,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,IAAI,CAC/B,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,+BAA+B,EACrD;gBACE,OAAO,EAAE;oBACP,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,mBAAmB;oBAC5C,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB;oBACxC,cAAc,EAAE,kBAAkB;iBACnC;aACF,CACF,CAAC;YACF,OAAO,QAAQ,CAAC,IAAI,EAAE,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,uBAAuB,CAAC,OAAY;QACxC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YACxC,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,IAAI,CAC/B,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,oDAAoD,EAAE,wBAAwB;YACpG,OAAO,EACP;gBACE,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,eAAe,EAAE,KAAK;iBACvB;aACF,CACF,CAAC;YACF,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;YACzE,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,MAAiC;QACxD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YACxC,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,GAAG,CAC9B,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,2BAA2B,MAAM,CAAC,aAAa,EAAE,EAAE,wBAAwB;YACjG;gBACE,OAAO,EAAE;oBACP,QAAQ,EAAE,kBAAkB;oBAC5B,cAAc,EAAE,kBAAkB;oBAClC,eAAe,EAAE,KAAK;iBACvB;aACF,CACF,CAAC;YACF,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;CACF;AA7DD,8CA6DC"}

package/dist/providers/PesapalProvider.d.ts

@@ -0,0 +1,14 @@
+import { baseProvider } from './BaseProvider.js';
+export declare class PesapalProvider extends baseProvider {
+    constructor(config: any);
+    authenticate(): Promise<string>;
+    registerIpn(ipnUrl: string, ipnNotificationType: "GET" | "POST"): Promise<any>;
+    initiateUssdPushRequest({ payload, ipnId }: {
+        payload: any;
+        ipnId?: string;
+    }): Promise<any>;
+    checkPaymentStatus(params: {
+        transactionId: string;
+    }): Promise<any>;
+}
+//# sourceMappingURL=PesapalProvider.d.ts.map

package/dist/providers/PesapalProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PesapalProvider.d.ts","sourceRoot":"","sources":["../../src/providers/PesapalProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAG/C,qBAAa,eAAgB,SAAQ,YAAY;gBACjC,MAAM,EAAE,GAAG;IAIjB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAqBnC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAwB1E,uBAAuB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAAE,OAAO,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAwB3F,kBAAkB,CAAC,MAAM,EAAC;QAAC,aAAa,EAAC,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,GAAG,CAAC;CAmBxE"}

package/dist/providers/PesapalProvider.js

@@ -0,0 +1,88 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PesapalProvider = void 0;
+const BaseProvider_js_1 = require("./BaseProvider.js");
+const axios_1 = __importDefault(require("axios"));
+class PesapalProvider extends BaseProvider_js_1.baseProvider {
+    constructor(config) {
+        super(config);
+    }
+    async authenticate() {
+        try {
+            const response = await axios_1.default.post(`${this.config.baseUrl}/api/Auth/RequestToken`, {
+                consumer_key: this.config.PESAPAL_CONSUMER_KEY,
+                consumer_secret: this.config.PESAPAL_CONSUMER_SECRET,
+            }, {
+                headers: {
+                    'Accept': 'application/json',
+                    'Content-Type': 'application/json',
+                }
+            });
+            return response.data.token;
+        }
+        catch (error) {
+            throw new Error(`Authentication failed: ${error}`);
+        }
+    }
+    async registerIpn(ipnUrl, ipnNotificationType) {
+        try {
+            const token = await this.authenticate();
+            const response = await axios_1.default.post(`${this.config.baseUrl}/api/URLSetup/RegisterIPN`, // sandbox path
+            {
+                url: ipnUrl,
+                ipn_notification_type: ipnNotificationType
+            }, {
+                headers: {
+                    'Accept': 'application/json',
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${token}`,
+                }
+            });
+            return response.data.ipn_id;
+        }
+        catch (error) {
+            throw new Error(`IPN registration failed: ${error}`);
+        }
+    }
+    async initiateUssdPushRequest({ payload, ipnId }) {
+        try {
+            const token = await this.authenticate();
+            const finalPayload = {
+                ...payload,
+                notification_id: ipnId
+            };
+            const response = await axios_1.default.post(`${this.config.baseUrl}/api/Transactions/SubmitOrderRequest`, finalPayload, {
+                headers: {
+                    'Accept': 'application/json',
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${token}`,
+                }
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw new Error(`Payment request failed: ${error}`);
+        }
+    }
+    async checkPaymentStatus(params) {
+        try {
+            const token = await this.authenticate();
+            const response = await axios_1.default.get(`${this.config.baseUrl}/api/Transactions/GetTransactionStatus?orderTrackingId=${params.transactionId}`, {
+                headers: {
+                    'Accept': 'application/json',
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${token}`,
+                }
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw new Error(`Payment status check failed: ${error}`);
+        }
+    }
+}
+exports.PesapalProvider = PesapalProvider;
+//# sourceMappingURL=PesapalProvider.js.map

package/dist/providers/PesapalProvider.js.map

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

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "finconnect",
+  "version": "1.0.0",
+  "description": "A lightweight, provider-agnostic integration wrapper for East African Fintech APIs.",
+  "homepage": "https://github.com/somebody1011/finconnect#readme",
+  "bugs": {
+    "url": "https://github.com/somebody1011/finconnect/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/somebody1011/finconnect.git"
+  },
+  "license": "MIT",
+  "author": "elisha gerson",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "directories": {
+    "example": "examples",
+    "test": "test"
+  },
+  "keywords": [
+    "fintech",
+    "payments",
+    "azampay",
+    "pesapal",
+    "clickpesa",
+    "typescript",
+    "node"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "jest --runInBand",
+    "dev": "ts-node scripts/server.ts",
+    "dev-tool": "tsx scripts/dev-tool.ts",
+    "provider-test": "tsx src/providers/ClickpesaProvider.ts",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "axios": "^1.15.2",
+    "dotenv": "^17.4.2",
+    "express": "^5.2.1"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.6.0",
+    "axios-mock-adapter": "^2.1.0",
+    "jest": "^30.3.0",
+    "ts-jest": "^29.4.9",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}