@grtsnx/payba3 1.0.0

package/dist/lib/seerbit/seerbit.service.js

@@ -0,0 +1,83 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SeerbitService = void 0;
+const common_1 = require("@nestjs/common");
+const response_helper_1 = require("../shared/response.helper");
+const seerbit_helper_1 = require("./config/seerbit.helper");
+let SeerbitService = class SeerbitService {
+    baseUrl;
+    publicKey;
+    secretKey;
+    bearerToken = null;
+    constructor() {
+        const environment = (process.env.SEERBIT_ENVIRONMENT ??
+            'sandbox');
+        const credentials = (0, seerbit_helper_1.getSeerbitCredentials)(environment);
+        this.baseUrl = (0, seerbit_helper_1.getSeerbitBaseUrl)(environment, process.env.SEERBIT_BASE_URL);
+        this.publicKey = credentials.publicKey;
+        this.secretKey = credentials.secretKey;
+    }
+    async getBearerToken() {
+        (0, seerbit_helper_1.assertSeerbitKeys)(this.publicKey, this.secretKey);
+        if (!this.bearerToken) {
+            this.bearerToken = await (0, seerbit_helper_1.generateSeerbitBearerToken)(this.baseUrl, this.publicKey, this.secretKey);
+        }
+        return this.bearerToken;
+    }
+    async createVirtualAccount(input) {
+        const token = await this.getBearerToken();
+        const body = await (0, seerbit_helper_1.requestSeerbit)({
+            baseUrl: this.baseUrl,
+            endpoint: '/virtual-accounts',
+            options: {
+                method: 'POST',
+                token,
+                body: {
+                    publicKey: this.publicKey,
+                    fullName: input.fullName,
+                    bankVerificationNumber: input.bankVerificationNumber ?? '',
+                    currency: input.currency ?? 'NGN',
+                    country: input.country ?? 'NG',
+                    reference: input.reference,
+                    email: input.email,
+                },
+            },
+        });
+        if (body.status !== 'SUCCESS' || !body.data?.payments?.accountNumber) {
+            throw new response_helper_1.handleResponse(common_1.HttpStatus.BAD_REQUEST, body.data?.message ?? 'Failed to create Seerbit virtual account', body);
+        }
+        return body;
+    }
+    async getVirtualAccount(reference) {
+        const token = await this.getBearerToken();
+        try {
+            const body = await (0, seerbit_helper_1.requestSeerbit)({
+                baseUrl: this.baseUrl,
+                endpoint: `/virtual-accounts/${encodeURIComponent(reference)}`,
+                options: { token },
+            });
+            if (body.status === 'SUCCESS' && body.data?.payments?.accountNumber) {
+                return body;
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+};
+exports.SeerbitService = SeerbitService;
+exports.SeerbitService = SeerbitService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [])
+], SeerbitService);
+//# sourceMappingURL=seerbit.service.js.map

package/dist/lib/seerbit/seerbit.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seerbit.service.js","sourceRoot":"","sources":["../../../src/lib/seerbit/seerbit.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAwD;AACxD,+DAA2D;AAC3D,4DAMiC;AAQ1B,IAAM,cAAc,GAApB,MAAM,cAAc;IACR,OAAO,CAAS;IAChB,SAAS,CAAS;IAClB,SAAS,CAAS;IAC3B,WAAW,GAAkB,IAAI,CAAC;IAE1C;QACE,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB;YAClD,SAAS,CAAuB,CAAC;QACnC,MAAM,WAAW,GAAG,IAAA,sCAAqB,EAAC,WAAW,CAAC,CAAC;QAEvD,IAAI,CAAC,OAAO,GAAG,IAAA,kCAAiB,EAAC,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC5E,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,IAAA,kCAAiB,EAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAElD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,IAAI,CAAC,WAAW,GAAG,MAAM,IAAA,2CAA0B,EACjD,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,SAAS,CACf,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,oBAAoB,CACxB,KAAuC;QAEvC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,MAAM,IAAA,+BAAc,EAAoC;YACnE,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,mBAAmB;YAC7B,OAAO,EAAE;gBACP,MAAM,EAAE,MAAM;gBACd,KAAK;gBACL,IAAI,EAAE;oBACJ,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,sBAAsB,EAAE,KAAK,CAAC,sBAAsB,IAAI,EAAE;oBAC1D,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK;oBACjC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;oBAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;iBACnB;aACF;SACF,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;YACrE,MAAM,IAAI,gCAAc,CACtB,mBAAU,CAAC,WAAW,EACtB,IAAI,CAAC,IAAI,EAAE,OAAO,IAAI,0CAA0C,EAChE,IAAI,CACL,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,SAAiB;QAEjB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAE1C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAA,+BAAc,EAAoC;gBACnE,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,QAAQ,EAAE,qBAAqB,kBAAkB,CAAC,SAAS,CAAC,EAAE;gBAC9D,OAAO,EAAE,EAAE,KAAK,EAAE;aACnB,CAAC,CAAC;YAEH,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;gBACpE,OAAO,IAAI,CAAC;YACd,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF,CAAA;AApFY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,mBAAU,GAAE;;GACA,cAAc,CAoF1B"}

package/dist/lib/shared/index.d.ts

@@ -0,0 +1 @@
+export * from './response.helper';

package/dist/lib/shared/index.js

@@ -0,0 +1,18 @@
+"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 });
+__exportStar(require("./response.helper"), exports);
+//# sourceMappingURL=index.js.map

package/dist/lib/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/shared/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC"}

package/dist/lib/shared/response.helper.d.ts

@@ -0,0 +1,15 @@
+import { HttpException } from '@nestjs/common';
+export type HandleResponseBody = {
+    statusCode: number;
+    statusType: string;
+    message: string;
+    data?: unknown;
+};
+export declare class handleResponse extends HttpException {
+    statusCode: number;
+    message: string;
+    data?: unknown | undefined;
+    constructor(statusCode: number, message: string, data?: unknown | undefined);
+    getResponse(): HandleResponseBody;
+    getStatus(): number;
+}

package/dist/lib/shared/response.helper.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleResponse = void 0;
+const common_1 = require("@nestjs/common");
+class handleResponse extends common_1.HttpException {
+    statusCode;
+    message;
+    data;
+    constructor(statusCode, message, data) {
+        const response = {
+            statusCode,
+            statusType: common_1.HttpStatus[statusCode],
+            message,
+        };
+        if (data !== undefined) {
+            response.data = data;
+        }
+        super(response, statusCode);
+        this.statusCode = statusCode;
+        this.message = message;
+        this.data = data;
+    }
+    getResponse() {
+        const response = {
+            statusCode: this.getStatus(),
+            statusType: common_1.HttpStatus[this.getStatus()],
+            message: this.message,
+        };
+        if (this.data !== undefined) {
+            response.data = this.data;
+        }
+        return response;
+    }
+    getStatus() {
+        return this.statusCode;
+    }
+}
+exports.handleResponse = handleResponse;
+//# sourceMappingURL=response.helper.js.map

package/dist/lib/shared/response.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.helper.js","sourceRoot":"","sources":["../../../src/lib/shared/response.helper.ts"],"names":[],"mappings":";;;AAAA,2CAA2D;AAS3D,MAAa,cAAe,SAAQ,sBAAa;IAEtC;IACA;IACA;IAHT,YACS,UAAkB,EAClB,OAAe,EACf,IAAc;QAErB,MAAM,QAAQ,GAAuB;YACnC,UAAU;YACV,UAAU,EAAE,mBAAU,CAAC,UAAU,CAAC;YAClC,OAAO;SACR,CAAC;QAEF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC;QACvB,CAAC;QAED,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAdrB,eAAU,GAAV,UAAU,CAAQ;QAClB,YAAO,GAAP,OAAO,CAAQ;QACf,SAAI,GAAJ,IAAI,CAAU;IAavB,CAAC;IAED,WAAW;QACT,MAAM,QAAQ,GAAuB;YACnC,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE;YAC5B,UAAU,EAAE,mBAAU,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACxC,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;QAEF,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAC5B,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF;AApCD,wCAoCC"}

package/llms.txt

@@ -0,0 +1,25 @@
+# payba3 LLM Index
+
+payba3 is a developer-first integration surface for multiple payment and verification providers. It is designed for apps, libraries, backend services, and AI agents that need one predictable way to choose a provider and call provider-specific capabilities.
+
+## Provider References
+
+- Paystack: `src/lib/paystack/paystack_llm.txt`
+- Safehaven: `src/lib/safehaven/safehaven_llm.txt`
+- SeerBit: `src/lib/seerbit/seerbit_llm.txt`
+- OPay: `src/lib/opay/opay_llm.txt`
+- Mono: `src/lib/mono/mono_llm.txt`
+- Monnify: `src/lib/monnify/monnify_llm.txt`
+- QoreID: `src/lib/qoreid/qoreid_llm.txt`
+
+## Integration Rules
+
+- Import payba3 from `@grtsnx/payba3` and select providers with `Payba3Service.use('<provider>')`.
+- Configure only the provider you use.
+- Use provider-specific environment switches such as `SAFEHAVEN_ENVIRONMENT`, `OPAY_ENVIRONMENT`, `MONNIFY_ENVIRONMENT`, `PAYSTACK_ENVIRONMENT`, `QOREID_ENVIRONMENT`, and `SEERBIT_ENVIRONMENT`.
+- Keep secrets server-side.
+- Verify provider webhooks before trusting callback payloads.
+- Verify transaction status server-side before delivering value.
+- Refresh expiring access tokens before they expire.
+- Core Nest packages are peer dependencies, so host applications should provide `@nestjs/common`, `@nestjs/core`, `@nestjs/config`, `reflect-metadata`, and `rxjs`.
+- Validate package readiness with `bun run pack:dry`, `bun run test:package`, and `bun run test:package:bun`.

package/package.json

@@ -0,0 +1,169 @@
+{
+  "name": "@grtsnx/payba3",
+  "version": "1.0.0",
+  "description": "One payment integration surface for many payment channels.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./llms.txt": "./llms.txt",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/index.js",
+    "dist/index.d.ts",
+    "dist/lib",
+    "assets/payba3-logo.svg",
+    "README.md",
+    "CHANGELOG.md",
+    "CODE_OF_CONDUCT.md",
+    "CONTRIBUTING.md",
+    "llms.txt",
+    "src/lib/**/*_llm.txt",
+    "LICENSE",
+    "SECURITY.md",
+    "SUPPORT.md"
+  ],
+  "author": "",
+  "private": false,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grtsnx/payba3.git"
+  },
+  "bugs": {
+    "url": "https://github.com/grtsnx/payba3/issues"
+  },
+  "homepage": "https://github.com/grtsnx/payba3#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "payments",
+    "paystack",
+    "safehaven",
+    "seerbit",
+    "opay",
+    "mono",
+    "monnify",
+    "qoreid",
+    "fintech",
+    "ai-agents"
+  ],
+  "overrides": {
+    "js-yaml": "4.2.0",
+    "multer": "2.2.0"
+  },
+  "scripts": {
+    "build": "nest build",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "start": "nest start",
+    "start:dev": "nest start --watch",
+    "start:debug": "nest start --debug --watch",
+    "start:prod": "node dist/main",
+    "lint": "node node_modules/eslint/bin/eslint.js \"{src,apps,libs,test}/**/*.ts\"",
+    "lint:fix": "node node_modules/eslint/bin/eslint.js \"{src,apps,libs,test}/**/*.ts\" --fix",
+    "package:release": "scripts/package-release.sh",
+    "pack:dry": "npm pack --dry-run",
+    "prepack": "npm run lint && npm run test && npm run build",
+    "test": "node node_modules/jest/bin/jest.js --passWithNoTests --runInBand",
+    "test:package": "node scripts/package-smoke-test.mjs",
+    "test:package:bun": "node scripts/package-smoke-test.mjs --installer bun",
+    "test:providers": "node node_modules/jest/bin/jest.js --passWithNoTests --runInBand test/unit/lib",
+    "test:watch": "node node_modules/jest/bin/jest.js --watch",
+    "test:cov": "node node_modules/jest/bin/jest.js --coverage --runInBand",
+    "test:debug": "node --inspect-brk -r tsconfig-paths/register -r ts-node/register node_modules/.bin/jest --runInBand",
+    "test:e2e": "node node_modules/jest/bin/jest.js --config ./test/jest-e2e.json --runInBand"
+  },
+  "dependencies": {},
+  "peerDependencies": {
+    "@nestjs/common": ">=10 <12",
+    "@nestjs/config": ">=3 <5",
+    "@nestjs/core": ">=10 <12",
+    "reflect-metadata": "^0.2.0",
+    "rxjs": "^7.8.0"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.2.0",
+    "@eslint/js": "^9.18.0",
+    "@nestjs/common": "^11.0.1",
+    "@nestjs/cli": "^11.0.0",
+    "@nestjs/config": "^4.0.4",
+    "@nestjs/core": "^11.0.1",
+    "@nestjs/platform-express": "^11.0.1",
+    "@nestjs/schematics": "^11.0.0",
+    "@nestjs/swagger": "^11.4.4",
+    "@nestjs/terminus": "^11.1.1",
+    "@nestjs/testing": "^11.0.1",
+    "@nestjs/throttler": "^6.5.0",
+    "@scalar/nestjs-api-reference": "^1.2.3",
+    "@types/compression": "^1.8.1",
+    "@types/express": "^5.0.0",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.0.0",
+    "@types/supertest": "^7.0.0",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.15.1",
+    "compression": "^1.8.1",
+    "eslint": "^9.18.0",
+    "eslint-config-prettier": "^10.0.1",
+    "eslint-plugin-prettier": "^5.2.2",
+    "globals": "^17.0.0",
+    "helmet": "^8.2.0",
+    "joi": "^18.2.1",
+    "jest": "^30.0.0",
+    "moment-timezone": "^0.6.2",
+    "nestjs-pino": "^4.6.1",
+    "pino": "^10.3.1",
+    "pino-http": "^11.0.0",
+    "pino-pretty": "^13.1.3",
+    "prettier": "^3.4.2",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1",
+    "source-map-support": "^0.5.21",
+    "supertest": "^7.0.0",
+    "ts-jest": "^29.2.5",
+    "ts-loader": "^9.5.2",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.20.0"
+  },
+  "jest": {
+    "moduleFileExtensions": [
+      "js",
+      "json",
+      "ts"
+    ],
+    "moduleNameMapper": {
+      "^src/(.*)$": "<rootDir>/src/$1"
+    },
+    "rootDir": ".",
+    "testRegex": "test/.*\\.spec\\.ts$",
+    "testPathIgnorePatterns": [
+      "/node_modules/",
+      "/dist/",
+      "/coverage/",
+      "/\\.release/"
+    ],
+    "modulePathIgnorePatterns": [
+      "<rootDir>/dist",
+      "<rootDir>/coverage",
+      "<rootDir>/.release"
+    ],
+    "transform": {
+      "^.+\\.(t|j)s$": "ts-jest"
+    },
+    "collectCoverageFrom": [
+      "src/**/*.(t|j)s",
+      "!src/**/*.module.ts",
+      "!src/main.ts"
+    ],
+    "coverageDirectory": "coverage",
+    "testEnvironment": "node"
+  }
+}