@monnify/mcp-server 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +563 -0
- package/build/auth/tokenManager.d.ts +11 -0
- package/build/auth/tokenManager.d.ts.map +1 -0
- package/build/auth/tokenManager.js +62 -0
- package/build/auth/tokenManager.js.map +1 -0
- package/build/cli.d.ts +3 -0
- package/build/cli.d.ts.map +1 -0
- package/build/cli.js +39 -0
- package/build/cli.js.map +1 -0
- package/build/client/monnifyClient.d.ts +7 -0
- package/build/client/monnifyClient.d.ts.map +1 -0
- package/build/client/monnifyClient.js +119 -0
- package/build/client/monnifyClient.js.map +1 -0
- package/build/config/env.d.ts +47 -0
- package/build/config/env.d.ts.map +1 -0
- package/build/config/env.js +39 -0
- package/build/config/env.js.map +1 -0
- package/build/index.d.ts +36 -0
- package/build/index.d.ts.map +1 -0
- package/build/index.js +84 -0
- package/build/index.js.map +1 -0
- package/build/schemas/compat.d.ts +24 -0
- package/build/schemas/compat.d.ts.map +1 -0
- package/build/schemas/compat.js +20 -0
- package/build/schemas/compat.js.map +1 -0
- package/build/schemas/extended/collections.d.ts +439 -0
- package/build/schemas/extended/collections.d.ts.map +1 -0
- package/build/schemas/extended/collections.js +403 -0
- package/build/schemas/extended/collections.js.map +1 -0
- package/build/schemas/extended/directDebit.d.ts +123 -0
- package/build/schemas/extended/directDebit.d.ts.map +1 -0
- package/build/schemas/extended/directDebit.js +121 -0
- package/build/schemas/extended/directDebit.js.map +1 -0
- package/build/schemas/extended/verification.d.ts +55 -0
- package/build/schemas/extended/verification.d.ts.map +1 -0
- package/build/schemas/extended/verification.js +51 -0
- package/build/schemas/extended/verification.js.map +1 -0
- package/build/schemas/generated.d.ts +4 -0
- package/build/schemas/generated.d.ts.map +1 -0
- package/build/schemas/generated.js +2603 -0
- package/build/schemas/generated.js.map +1 -0
- package/build/security/guards.d.ts +5 -0
- package/build/security/guards.d.ts.map +1 -0
- package/build/security/guards.js +43 -0
- package/build/security/guards.js.map +1 -0
- package/build/security/sanitiser.d.ts +46 -0
- package/build/security/sanitiser.d.ts.map +1 -0
- package/build/security/sanitiser.js +269 -0
- package/build/security/sanitiser.js.map +1 -0
- package/build/tools/collections/authoriseCard3ds.d.ts +7 -0
- package/build/tools/collections/authoriseCard3ds.d.ts.map +1 -0
- package/build/tools/collections/authoriseCard3ds.js +63 -0
- package/build/tools/collections/authoriseCard3ds.js.map +1 -0
- package/build/tools/collections/authoriseCardOtp.d.ts +7 -0
- package/build/tools/collections/authoriseCardOtp.d.ts.map +1 -0
- package/build/tools/collections/authoriseCardOtp.js +55 -0
- package/build/tools/collections/authoriseCardOtp.js.map +1 -0
- package/build/tools/collections/chargeCard.d.ts +7 -0
- package/build/tools/collections/chargeCard.d.ts.map +1 -0
- package/build/tools/collections/chargeCard.js +59 -0
- package/build/tools/collections/chargeCard.js.map +1 -0
- package/build/tools/collections/chargeCardToken.d.ts +7 -0
- package/build/tools/collections/chargeCardToken.d.ts.map +1 -0
- package/build/tools/collections/chargeCardToken.js +68 -0
- package/build/tools/collections/chargeCardToken.js.map +1 -0
- package/build/tools/collections/createInvoice.d.ts +7 -0
- package/build/tools/collections/createInvoice.d.ts.map +1 -0
- package/build/tools/collections/createInvoice.js +57 -0
- package/build/tools/collections/createInvoice.js.map +1 -0
- package/build/tools/collections/deallocateReservedAccount.d.ts +14 -0
- package/build/tools/collections/deallocateReservedAccount.d.ts.map +1 -0
- package/build/tools/collections/deallocateReservedAccount.js +55 -0
- package/build/tools/collections/deallocateReservedAccount.js.map +1 -0
- package/build/tools/collections/getAllTransactions.d.ts +47 -0
- package/build/tools/collections/getAllTransactions.d.ts.map +1 -0
- package/build/tools/collections/getAllTransactions.js +140 -0
- package/build/tools/collections/getAllTransactions.js.map +1 -0
- package/build/tools/collections/getReservedAccount.d.ts +14 -0
- package/build/tools/collections/getReservedAccount.d.ts.map +1 -0
- package/build/tools/collections/getReservedAccount.js +55 -0
- package/build/tools/collections/getReservedAccount.js.map +1 -0
- package/build/tools/collections/getReservedAccountTransactions.d.ts +20 -0
- package/build/tools/collections/getReservedAccountTransactions.d.ts.map +1 -0
- package/build/tools/collections/getReservedAccountTransactions.js +86 -0
- package/build/tools/collections/getReservedAccountTransactions.js.map +1 -0
- package/build/tools/collections/getTransactionDetails.d.ts +14 -0
- package/build/tools/collections/getTransactionDetails.d.ts.map +1 -0
- package/build/tools/collections/getTransactionDetails.js +60 -0
- package/build/tools/collections/getTransactionDetails.js.map +1 -0
- package/build/tools/collections/getTransactionStatus.d.ts +7 -0
- package/build/tools/collections/getTransactionStatus.d.ts.map +1 -0
- package/build/tools/collections/getTransactionStatus.js +58 -0
- package/build/tools/collections/getTransactionStatus.js.map +1 -0
- package/build/tools/collections/initiatePayment.d.ts +7 -0
- package/build/tools/collections/initiatePayment.d.ts.map +1 -0
- package/build/tools/collections/initiatePayment.js +63 -0
- package/build/tools/collections/initiatePayment.js.map +1 -0
- package/build/tools/collections/payWithBankTransfer.d.ts +7 -0
- package/build/tools/collections/payWithBankTransfer.d.ts.map +1 -0
- package/build/tools/collections/payWithBankTransfer.js +55 -0
- package/build/tools/collections/payWithBankTransfer.js.map +1 -0
- package/build/tools/collections/processRefund.d.ts +7 -0
- package/build/tools/collections/processRefund.d.ts.map +1 -0
- package/build/tools/collections/processRefund.js +55 -0
- package/build/tools/collections/processRefund.js.map +1 -0
- package/build/tools/collections/reserveAccount.d.ts +7 -0
- package/build/tools/collections/reserveAccount.d.ts.map +1 -0
- package/build/tools/collections/reserveAccount.js +57 -0
- package/build/tools/collections/reserveAccount.js.map +1 -0
- package/build/tools/directDebit/cancelMandate.d.ts +7 -0
- package/build/tools/directDebit/cancelMandate.d.ts.map +1 -0
- package/build/tools/directDebit/cancelMandate.js +55 -0
- package/build/tools/directDebit/cancelMandate.js.map +1 -0
- package/build/tools/directDebit/createMandate.d.ts +7 -0
- package/build/tools/directDebit/createMandate.d.ts.map +1 -0
- package/build/tools/directDebit/createMandate.js +55 -0
- package/build/tools/directDebit/createMandate.js.map +1 -0
- package/build/tools/directDebit/debitMandate.d.ts +7 -0
- package/build/tools/directDebit/debitMandate.d.ts.map +1 -0
- package/build/tools/directDebit/debitMandate.js +55 -0
- package/build/tools/directDebit/debitMandate.js.map +1 -0
- package/build/tools/directDebit/getMandateDebitStatus.d.ts +7 -0
- package/build/tools/directDebit/getMandateDebitStatus.d.ts.map +1 -0
- package/build/tools/directDebit/getMandateDebitStatus.js +55 -0
- package/build/tools/directDebit/getMandateDebitStatus.js.map +1 -0
- package/build/tools/directDebit/getMandateStatus.d.ts +7 -0
- package/build/tools/directDebit/getMandateStatus.d.ts.map +1 -0
- package/build/tools/directDebit/getMandateStatus.js +55 -0
- package/build/tools/directDebit/getMandateStatus.js.map +1 -0
- package/build/tools/registry.d.ts +11 -0
- package/build/tools/registry.d.ts.map +1 -0
- package/build/tools/registry.js +15 -0
- package/build/tools/registry.js.map +1 -0
- package/build/tools/utilities/getSupportedBanks.d.ts +8 -0
- package/build/tools/utilities/getSupportedBanks.d.ts.map +1 -0
- package/build/tools/utilities/getSupportedBanks.js +47 -0
- package/build/tools/utilities/getSupportedBanks.js.map +1 -0
- package/build/tools/utilities/getTransactionList.d.ts +47 -0
- package/build/tools/utilities/getTransactionList.d.ts.map +1 -0
- package/build/tools/utilities/getTransactionList.js +136 -0
- package/build/tools/utilities/getTransactionList.js.map +1 -0
- package/build/tools/verification/verifyBankAccount.d.ts +7 -0
- package/build/tools/verification/verifyBankAccount.d.ts.map +1 -0
- package/build/tools/verification/verifyBankAccount.js +58 -0
- package/build/tools/verification/verifyBankAccount.js.map +1 -0
- package/build/tools/verification/verifyBvn.d.ts +7 -0
- package/build/tools/verification/verifyBvn.d.ts.map +1 -0
- package/build/tools/verification/verifyBvn.js +55 -0
- package/build/tools/verification/verifyBvn.js.map +1 -0
- package/build/tools/verification/verifyBvnInfo.d.ts +7 -0
- package/build/tools/verification/verifyBvnInfo.d.ts.map +1 -0
- package/build/tools/verification/verifyBvnInfo.js +55 -0
- package/build/tools/verification/verifyBvnInfo.js.map +1 -0
- package/build/tools/verification/verifyNin.d.ts +7 -0
- package/build/tools/verification/verifyNin.d.ts.map +1 -0
- package/build/tools/verification/verifyNin.js +55 -0
- package/build/tools/verification/verifyNin.js.map +1 -0
- package/build/transport/http.d.ts +3 -0
- package/build/transport/http.d.ts.map +1 -0
- package/build/transport/http.js +71 -0
- package/build/transport/http.js.map +1 -0
- package/build/transport/stdio.d.ts +3 -0
- package/build/transport/stdio.d.ts.map +1 -0
- package/build/transport/stdio.js +8 -0
- package/build/transport/stdio.js.map +1 -0
- package/build/types/mcp.d.ts +11 -0
- package/build/types/mcp.d.ts.map +1 -0
- package/build/types/mcp.js +7 -0
- package/build/types/mcp.js.map +1 -0
- package/build/utils/clientContext.d.ts +7 -0
- package/build/utils/clientContext.d.ts.map +1 -0
- package/build/utils/clientContext.js +24 -0
- package/build/utils/clientContext.js.map +1 -0
- package/build/utils/errors.d.ts +21 -0
- package/build/utils/errors.d.ts.map +1 -0
- package/build/utils/errors.js +45 -0
- package/build/utils/errors.js.map +1 -0
- package/build/utils/format.d.ts +34 -0
- package/build/utils/format.d.ts.map +1 -0
- package/build/utils/format.js +362 -0
- package/build/utils/format.js.map +1 -0
- package/build/utils/formatters.d.ts +4 -0
- package/build/utils/formatters.d.ts.map +1 -0
- package/build/utils/formatters.js +26 -0
- package/build/utils/formatters.js.map +1 -0
- package/build/utils/logger.d.ts +3 -0
- package/build/utils/logger.d.ts.map +1 -0
- package/build/utils/logger.js +30 -0
- package/build/utils/logger.js.map +1 -0
- package/openapi/monnify.yaml +9295 -0
- package/package.json +55 -0
package/build/cli.js
ADDED
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { Command } from "commander";
|
|
3
|
+
const program = new Command();
|
|
4
|
+
program
|
|
5
|
+
.name("monnify-mcp")
|
|
6
|
+
.description("MCP server for Monnify payment APIs")
|
|
7
|
+
.version("1.0.0")
|
|
8
|
+
.requiredOption("--apiKey <key>", "Monnify API key (from Dashboard → Settings → API Keys)")
|
|
9
|
+
.requiredOption("--secretKey <secret>", "Monnify secret key")
|
|
10
|
+
.requiredOption("--contractCode <code>", "Monnify contract code")
|
|
11
|
+
.option("--env <environment>", "Target environment: sandbox or production", "sandbox")
|
|
12
|
+
.option("--transport <transport>", "Transport mode: stdio or http", "stdio")
|
|
13
|
+
.option("--port <port>", "HTTP port (only used when --transport=http)", "3000")
|
|
14
|
+
.option("--tools <categories>", "Comma-separated list of tool categories to enable: collections,directDebit,verification,utilities")
|
|
15
|
+
.option("--format <format>", "Response format override: auto (default), markdown, or json. Auto detects the client — Claude clients get markdown, engineering tools (VS Code, Copilot, Cursor) get JSON.", "auto")
|
|
16
|
+
.option("--httpToken <token>", "Bearer token to authenticate /mcp requests (only used with --transport=http). Strongly recommended when exposing the server beyond localhost.")
|
|
17
|
+
.parse(process.argv);
|
|
18
|
+
const opts = program.opts();
|
|
19
|
+
process.env["MONNIFY_API_KEY"] = opts.apiKey;
|
|
20
|
+
process.env["MONNIFY_SECRET_KEY"] = opts.secretKey;
|
|
21
|
+
process.env["MONNIFY_CONTRACT_CODE"] = opts.contractCode;
|
|
22
|
+
process.env["MONNIFY_ENV"] = opts.env;
|
|
23
|
+
process.env["MONNIFY_BASE_URL"] =
|
|
24
|
+
opts.env === "production"
|
|
25
|
+
? "https://app.monnify.com"
|
|
26
|
+
: "https://sandbox.monnify.com";
|
|
27
|
+
process.env["TRANSPORT"] = opts.transport;
|
|
28
|
+
process.env["PORT"] = opts.port;
|
|
29
|
+
if (opts.tools) {
|
|
30
|
+
process.env["MONNIFY_ALLOWED_OPERATIONS"] = opts.tools;
|
|
31
|
+
}
|
|
32
|
+
if (opts.format && opts.format !== "auto") {
|
|
33
|
+
process.env["MONNIFY_RESPONSE_FORMAT"] = opts.format;
|
|
34
|
+
}
|
|
35
|
+
if (opts.httpToken) {
|
|
36
|
+
process.env["MONNIFY_HTTP_TOKEN"] = opts.httpToken;
|
|
37
|
+
}
|
|
38
|
+
await import("./index.js");
|
|
39
|
+
//# sourceMappingURL=cli.js.map
|
package/build/cli.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,aAAa,CAAC;KACnB,WAAW,CAAC,qCAAqC,CAAC;KAClD,OAAO,CAAC,OAAO,CAAC;KAChB,cAAc,CACb,gBAAgB,EAChB,wDAAwD,CACzD;KACA,cAAc,CAAC,sBAAsB,EAAE,oBAAoB,CAAC;KAC5D,cAAc,CAAC,uBAAuB,EAAE,uBAAuB,CAAC;KAChE,MAAM,CACL,qBAAqB,EACrB,2CAA2C,EAC3C,SAAS,CACV;KACA,MAAM,CAAC,yBAAyB,EAAE,+BAA+B,EAAE,OAAO,CAAC;KAC3E,MAAM,CACL,eAAe,EACf,6CAA6C,EAC7C,MAAM,CACP;KACA,MAAM,CACL,sBAAsB,EACtB,mGAAmG,CACpG;KACA,MAAM,CACL,mBAAmB,EACnB,4KAA4K,EAC5K,MAAM,CACP;KACA,MAAM,CACL,qBAAqB,EACrB,+IAA+I,CAChJ;KACA,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAUrB,CAAC;AAEL,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;AAC7C,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;AACnD,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC;AACzD,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;AACtC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC7B,IAAI,CAAC,GAAG,KAAK,YAAY;QACvB,CAAC,CAAC,yBAAyB;QAC3B,CAAC,CAAC,6BAA6B,CAAC;AACpC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;AAC1C,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;AAEhC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;AACzD,CAAC;AAED,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;AACvD,CAAC;AAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;AACrD,CAAC;AAED,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import { type AxiosInstance } from "axios";
|
|
2
|
+
export declare const monnifyClient: AxiosInstance;
|
|
3
|
+
export declare function apiGet<T>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T>;
|
|
4
|
+
export declare function apiPost<T>(path: string, body: unknown): Promise<T>;
|
|
5
|
+
export declare function apiPatch<T>(path: string, body?: unknown): Promise<T>;
|
|
6
|
+
export declare function apiDelete<T>(path: string): Promise<T>;
|
|
7
|
+
//# sourceMappingURL=monnifyClient.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"monnifyClient.d.ts","sourceRoot":"","sources":["../../src/client/monnifyClient.ts"],"names":[],"mappings":"AAAA,OAAc,EACZ,KAAK,aAAa,EAGnB,MAAM,OAAO,CAAC;AA8Hf,eAAO,MAAM,aAAa,eAAiB,CAAC;AAE5C,wBAAsB,MAAM,CAAC,CAAC,EAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAC7D,OAAO,CAAC,CAAC,CAAC,CAWZ;AAED,wBAAsB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAGxE;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAG1E;AAED,wBAAsB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAG3D"}
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
import axios from "axios";
|
|
2
|
+
import { env } from "../config/env.js";
|
|
3
|
+
import { tokenManager } from "../auth/tokenManager.js";
|
|
4
|
+
import { logger } from "../utils/logger.js";
|
|
5
|
+
import { MonnifyApiError } from "../utils/errors.js";
|
|
6
|
+
const SENSITIVE_FIELDS = new Set([
|
|
7
|
+
"token",
|
|
8
|
+
"accessToken",
|
|
9
|
+
"secretKey",
|
|
10
|
+
"apiKey",
|
|
11
|
+
"bvn",
|
|
12
|
+
"accountNumber",
|
|
13
|
+
"authorizationCode",
|
|
14
|
+
"password",
|
|
15
|
+
]);
|
|
16
|
+
function redactBody(body) {
|
|
17
|
+
if (!body || typeof body !== "object")
|
|
18
|
+
return body;
|
|
19
|
+
return Object.fromEntries(Object.entries(body).map(([k, v]) => [
|
|
20
|
+
k,
|
|
21
|
+
SENSITIVE_FIELDS.has(k) ? "[REDACTED]" : v,
|
|
22
|
+
]));
|
|
23
|
+
}
|
|
24
|
+
function shouldRetry(error) {
|
|
25
|
+
return !error.response || error.response.status >= 500;
|
|
26
|
+
}
|
|
27
|
+
function createClient() {
|
|
28
|
+
const instance = axios.create({
|
|
29
|
+
timeout: 30_000,
|
|
30
|
+
headers: { "Content-Type": "application/json" },
|
|
31
|
+
});
|
|
32
|
+
instance.interceptors.request.use(async (config) => {
|
|
33
|
+
config.baseURL = env().MONNIFY_BASE_URL;
|
|
34
|
+
const token = await tokenManager.getToken();
|
|
35
|
+
config.headers["Authorization"] = `Bearer ${token}`;
|
|
36
|
+
const start = Date.now();
|
|
37
|
+
config._startTime = start;
|
|
38
|
+
logger.debug("Monnify request", {
|
|
39
|
+
method: config.method?.toUpperCase(),
|
|
40
|
+
url: config.url,
|
|
41
|
+
});
|
|
42
|
+
return config;
|
|
43
|
+
});
|
|
44
|
+
instance.interceptors.response.use((response) => {
|
|
45
|
+
const config = response.config;
|
|
46
|
+
const duration = config._startTime ? Date.now() - config._startTime : 0;
|
|
47
|
+
logger.info("Monnify response", {
|
|
48
|
+
method: response.config.method?.toUpperCase(),
|
|
49
|
+
url: response.config.url,
|
|
50
|
+
status: response.status,
|
|
51
|
+
duration,
|
|
52
|
+
});
|
|
53
|
+
return response;
|
|
54
|
+
}, async (error) => {
|
|
55
|
+
// Strip auth headers FIRST — before any logging or retry logic
|
|
56
|
+
if (error.config?.headers) {
|
|
57
|
+
delete error.config.headers["Authorization"];
|
|
58
|
+
delete error.config.headers["authorization"];
|
|
59
|
+
}
|
|
60
|
+
const retryCount = error.config?._retryCount ?? 0;
|
|
61
|
+
// Retry 5xx and network errors (max 3, exponential backoff)
|
|
62
|
+
if (retryCount < 3 && shouldRetry(error)) {
|
|
63
|
+
error.config._retryCount =
|
|
64
|
+
retryCount + 1;
|
|
65
|
+
const delay = 500 * Math.pow(2, retryCount);
|
|
66
|
+
logger.warn("Retrying Monnify request", {
|
|
67
|
+
url: error.config?.url,
|
|
68
|
+
attempt: retryCount + 1,
|
|
69
|
+
delay,
|
|
70
|
+
});
|
|
71
|
+
await new Promise((res) => setTimeout(res, delay));
|
|
72
|
+
return instance(error.config);
|
|
73
|
+
}
|
|
74
|
+
// On 401: clear token cache and retry once
|
|
75
|
+
if (error.response?.status === 401 && retryCount === 0) {
|
|
76
|
+
tokenManager.clearCache();
|
|
77
|
+
error.config._retryCount = 1;
|
|
78
|
+
logger.warn("Got 401 — clearing token cache and retrying once");
|
|
79
|
+
return instance(error.config);
|
|
80
|
+
}
|
|
81
|
+
const responseData = error.response?.data;
|
|
82
|
+
const httpStatus = error.response?.status ?? 0;
|
|
83
|
+
logger.error("Monnify API error", {
|
|
84
|
+
url: error.config?.url,
|
|
85
|
+
status: httpStatus,
|
|
86
|
+
responseCode: responseData?.["responseCode"],
|
|
87
|
+
responseMessage: responseData?.["responseMessage"],
|
|
88
|
+
});
|
|
89
|
+
throw new MonnifyApiError(responseData?.["responseCode"] ?? "UNKNOWN", responseData?.["responseMessage"] ?? error.message, httpStatus);
|
|
90
|
+
});
|
|
91
|
+
return instance;
|
|
92
|
+
}
|
|
93
|
+
export const monnifyClient = createClient();
|
|
94
|
+
export async function apiGet(path, params) {
|
|
95
|
+
const cleanParams = {};
|
|
96
|
+
if (params) {
|
|
97
|
+
for (const [k, v] of Object.entries(params)) {
|
|
98
|
+
if (v !== undefined)
|
|
99
|
+
cleanParams[k] = String(v);
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
const { data } = await monnifyClient.get(path, {
|
|
103
|
+
params: cleanParams,
|
|
104
|
+
});
|
|
105
|
+
return data.responseBody;
|
|
106
|
+
}
|
|
107
|
+
export async function apiPost(path, body) {
|
|
108
|
+
const { data } = await monnifyClient.post(path, body);
|
|
109
|
+
return data.responseBody;
|
|
110
|
+
}
|
|
111
|
+
export async function apiPatch(path, body) {
|
|
112
|
+
const { data } = await monnifyClient.patch(path, body);
|
|
113
|
+
return data.responseBody;
|
|
114
|
+
}
|
|
115
|
+
export async function apiDelete(path) {
|
|
116
|
+
const { data } = await monnifyClient.delete(path);
|
|
117
|
+
return data.responseBody;
|
|
118
|
+
}
|
|
119
|
+
//# sourceMappingURL=monnifyClient.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"monnifyClient.js","sourceRoot":"","sources":["../../src/client/monnifyClient.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
declare const EnvSchema: z.ZodObject<{
|
|
3
|
+
MONNIFY_API_KEY: z.ZodString;
|
|
4
|
+
MONNIFY_SECRET_KEY: z.ZodString;
|
|
5
|
+
MONNIFY_CONTRACT_CODE: z.ZodString;
|
|
6
|
+
MONNIFY_BASE_URL: z.ZodDefault<z.ZodString>;
|
|
7
|
+
MONNIFY_ENV: z.ZodDefault<z.ZodEnum<["sandbox", "production"]>>;
|
|
8
|
+
TRANSPORT: z.ZodDefault<z.ZodEnum<["stdio", "http"]>>;
|
|
9
|
+
PORT: z.ZodDefault<z.ZodNumber>;
|
|
10
|
+
MONNIFY_ALLOWED_OPERATIONS: z.ZodOptional<z.ZodString>;
|
|
11
|
+
MONNIFY_HTTP_TOKEN: z.ZodOptional<z.ZodString>;
|
|
12
|
+
MONNIFY_RESPONSE_FORMAT: z.ZodDefault<z.ZodEnum<["auto", "markdown", "json"]>>;
|
|
13
|
+
NODE_ENV: z.ZodDefault<z.ZodEnum<["development", "production", "test"]>>;
|
|
14
|
+
LOG_LEVEL: z.ZodDefault<z.ZodEnum<["error", "warn", "info", "debug"]>>;
|
|
15
|
+
}, "strip", z.ZodTypeAny, {
|
|
16
|
+
MONNIFY_API_KEY: string;
|
|
17
|
+
MONNIFY_SECRET_KEY: string;
|
|
18
|
+
MONNIFY_CONTRACT_CODE: string;
|
|
19
|
+
MONNIFY_BASE_URL: string;
|
|
20
|
+
MONNIFY_ENV: "sandbox" | "production";
|
|
21
|
+
TRANSPORT: "stdio" | "http";
|
|
22
|
+
PORT: number;
|
|
23
|
+
MONNIFY_RESPONSE_FORMAT: "auto" | "markdown" | "json";
|
|
24
|
+
NODE_ENV: "production" | "development" | "test";
|
|
25
|
+
LOG_LEVEL: "error" | "warn" | "info" | "debug";
|
|
26
|
+
MONNIFY_ALLOWED_OPERATIONS?: string | undefined;
|
|
27
|
+
MONNIFY_HTTP_TOKEN?: string | undefined;
|
|
28
|
+
}, {
|
|
29
|
+
MONNIFY_API_KEY: string;
|
|
30
|
+
MONNIFY_SECRET_KEY: string;
|
|
31
|
+
MONNIFY_CONTRACT_CODE: string;
|
|
32
|
+
MONNIFY_BASE_URL?: string | undefined;
|
|
33
|
+
MONNIFY_ENV?: "sandbox" | "production" | undefined;
|
|
34
|
+
TRANSPORT?: "stdio" | "http" | undefined;
|
|
35
|
+
PORT?: number | undefined;
|
|
36
|
+
MONNIFY_ALLOWED_OPERATIONS?: string | undefined;
|
|
37
|
+
MONNIFY_HTTP_TOKEN?: string | undefined;
|
|
38
|
+
MONNIFY_RESPONSE_FORMAT?: "auto" | "markdown" | "json" | undefined;
|
|
39
|
+
NODE_ENV?: "production" | "development" | "test" | undefined;
|
|
40
|
+
LOG_LEVEL?: "error" | "warn" | "info" | "debug" | undefined;
|
|
41
|
+
}>;
|
|
42
|
+
export type Env = z.infer<typeof EnvSchema>;
|
|
43
|
+
export declare function validateEnv(): Env;
|
|
44
|
+
export declare const env: () => Env;
|
|
45
|
+
export declare const tryEnv: () => Env | undefined;
|
|
46
|
+
export {};
|
|
47
|
+
//# sourceMappingURL=env.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAeb,CAAC;AAEH,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAI5C,wBAAgB,WAAW,IAAI,GAAG,CAajC;AAED,eAAO,MAAM,GAAG,QAAO,GAItB,CAAC;AAEF,eAAO,MAAM,MAAM,QAAO,GAAG,GAAG,SAAiB,CAAC"}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import dotenv from "dotenv";
|
|
3
|
+
dotenv.config();
|
|
4
|
+
const EnvSchema = z.object({
|
|
5
|
+
MONNIFY_API_KEY: z.string().min(1, "MONNIFY_API_KEY is required"),
|
|
6
|
+
MONNIFY_SECRET_KEY: z.string().min(1, "MONNIFY_SECRET_KEY is required"),
|
|
7
|
+
MONNIFY_CONTRACT_CODE: z.string().min(1, "MONNIFY_CONTRACT_CODE is required"),
|
|
8
|
+
MONNIFY_BASE_URL: z.string().url().default("https://sandbox.monnify.com"),
|
|
9
|
+
MONNIFY_ENV: z.enum(["sandbox", "production"]).default("sandbox"),
|
|
10
|
+
TRANSPORT: z.enum(["stdio", "http"]).default("stdio"),
|
|
11
|
+
PORT: z.coerce.number().int().min(1).max(65535).default(3000),
|
|
12
|
+
MONNIFY_ALLOWED_OPERATIONS: z.string().optional(),
|
|
13
|
+
MONNIFY_HTTP_TOKEN: z.string().optional(),
|
|
14
|
+
MONNIFY_RESPONSE_FORMAT: z.enum(["auto", "markdown", "json"]).default("auto"),
|
|
15
|
+
NODE_ENV: z
|
|
16
|
+
.enum(["development", "production", "test"])
|
|
17
|
+
.default("development"),
|
|
18
|
+
LOG_LEVEL: z.enum(["error", "warn", "info", "debug"]).default("info"),
|
|
19
|
+
});
|
|
20
|
+
let _env;
|
|
21
|
+
export function validateEnv() {
|
|
22
|
+
const result = EnvSchema.safeParse(process.env);
|
|
23
|
+
if (!result.success) {
|
|
24
|
+
const issues = result.error.issues
|
|
25
|
+
.map((i) => ` ${String(i.path[0])}: ${i.message}`)
|
|
26
|
+
.join("\n");
|
|
27
|
+
process.stderr.write(`\nMissing or invalid environment variables:\n${issues}\n\n`);
|
|
28
|
+
process.exit(1);
|
|
29
|
+
}
|
|
30
|
+
_env = result.data;
|
|
31
|
+
return _env;
|
|
32
|
+
}
|
|
33
|
+
export const env = () => {
|
|
34
|
+
if (!_env)
|
|
35
|
+
throw new Error("validateEnv() must be called before accessing env()");
|
|
36
|
+
return _env;
|
|
37
|
+
};
|
|
38
|
+
export const tryEnv = () => _env;
|
|
39
|
+
//# sourceMappingURL=env.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,6BAA6B,CAAC;IACjE,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;IACvE,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mCAAmC,CAAC;IAC7E,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,6BAA6B,CAAC;IACzE,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IACjE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACrD,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IAC7D,0BAA0B,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjD,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzC,uBAAuB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7E,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,aAAa,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;SAC3C,OAAO,CAAC,aAAa,CAAC;IACzB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;CACtE,CAAC,CAAC;AAIH,IAAI,IAAqB,CAAC;AAE1B,MAAM,UAAU,WAAW;IACzB,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aAClD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gDAAgD,MAAM,MAAM,CAC7D,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACnB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,GAAQ,EAAE;IAC3B,IAAI,CAAC,IAAI;QACP,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,GAAoB,EAAE,CAAC,IAAI,CAAC"}
|
package/build/index.d.ts
ADDED
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
|
|
2
|
+
export declare const server: Server<{
|
|
3
|
+
method: string;
|
|
4
|
+
params?: {
|
|
5
|
+
[x: string]: unknown;
|
|
6
|
+
_meta?: {
|
|
7
|
+
[x: string]: unknown;
|
|
8
|
+
progressToken?: string | number | undefined;
|
|
9
|
+
"io.modelcontextprotocol/related-task"?: {
|
|
10
|
+
taskId: string;
|
|
11
|
+
} | undefined;
|
|
12
|
+
} | undefined;
|
|
13
|
+
} | undefined;
|
|
14
|
+
}, {
|
|
15
|
+
method: string;
|
|
16
|
+
params?: {
|
|
17
|
+
[x: string]: unknown;
|
|
18
|
+
_meta?: {
|
|
19
|
+
[x: string]: unknown;
|
|
20
|
+
progressToken?: string | number | undefined;
|
|
21
|
+
"io.modelcontextprotocol/related-task"?: {
|
|
22
|
+
taskId: string;
|
|
23
|
+
} | undefined;
|
|
24
|
+
} | undefined;
|
|
25
|
+
} | undefined;
|
|
26
|
+
}, {
|
|
27
|
+
[x: string]: unknown;
|
|
28
|
+
_meta?: {
|
|
29
|
+
[x: string]: unknown;
|
|
30
|
+
progressToken?: string | number | undefined;
|
|
31
|
+
"io.modelcontextprotocol/related-task"?: {
|
|
32
|
+
taskId: string;
|
|
33
|
+
} | undefined;
|
|
34
|
+
} | undefined;
|
|
35
|
+
}>;
|
|
36
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AA2DnE,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGlB,CAAC"}
|
package/build/index.js
ADDED
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
|
|
2
|
+
import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
|
|
3
|
+
import { validateEnv, env } from "./config/env.js";
|
|
4
|
+
import { getAllToolDefinitions, dispatchTool } from "./tools/registry.js";
|
|
5
|
+
import { assertEnvironmentConsistency, isOperationAllowed, } from "./security/guards.js";
|
|
6
|
+
import { logger } from "./utils/logger.js";
|
|
7
|
+
import { MonnifyApiError, ValidationError } from "./utils/errors.js";
|
|
8
|
+
import { errorResult } from "./types/mcp.js";
|
|
9
|
+
import { setClientName, setFormatOverride } from "./utils/clientContext.js";
|
|
10
|
+
validateEnv();
|
|
11
|
+
assertEnvironmentConsistency(env());
|
|
12
|
+
const formatEnv = env().MONNIFY_RESPONSE_FORMAT;
|
|
13
|
+
if (formatEnv !== "auto") {
|
|
14
|
+
setFormatOverride(formatEnv);
|
|
15
|
+
}
|
|
16
|
+
if (isOperationAllowed("utilities", env())) {
|
|
17
|
+
await import("./tools/utilities/getSupportedBanks.js");
|
|
18
|
+
}
|
|
19
|
+
if (isOperationAllowed("verification", env())) {
|
|
20
|
+
await import("./tools/verification/verifyBankAccount.js");
|
|
21
|
+
await import("./tools/verification/verifyBvn.js");
|
|
22
|
+
await import("./tools/verification/verifyBvnInfo.js");
|
|
23
|
+
await import("./tools/verification/verifyNin.js");
|
|
24
|
+
}
|
|
25
|
+
if (isOperationAllowed("collections", env())) {
|
|
26
|
+
await import("./tools/collections/initiatePayment.js");
|
|
27
|
+
await import("./tools/collections/reserveAccount.js");
|
|
28
|
+
await import("./tools/collections/getReservedAccount.js");
|
|
29
|
+
await import("./tools/collections/getReservedAccountTransactions.js");
|
|
30
|
+
await import("./tools/collections/deallocateReservedAccount.js");
|
|
31
|
+
await import("./tools/collections/getTransactionStatus.js");
|
|
32
|
+
await import("./tools/collections/getTransactionDetails.js");
|
|
33
|
+
await import("./tools/collections/getAllTransactions.js");
|
|
34
|
+
await import("./tools/collections/createInvoice.js");
|
|
35
|
+
await import("./tools/collections/processRefund.js");
|
|
36
|
+
await import("./tools/collections/payWithBankTransfer.js");
|
|
37
|
+
await import("./tools/collections/chargeCard.js");
|
|
38
|
+
await import("./tools/collections/chargeCardToken.js");
|
|
39
|
+
await import("./tools/collections/authoriseCardOtp.js");
|
|
40
|
+
await import("./tools/collections/authoriseCard3ds.js");
|
|
41
|
+
}
|
|
42
|
+
if (isOperationAllowed("directDebit", env())) {
|
|
43
|
+
await import("./tools/directDebit/createMandate.js");
|
|
44
|
+
await import("./tools/directDebit/getMandateStatus.js");
|
|
45
|
+
await import("./tools/directDebit/debitMandate.js");
|
|
46
|
+
await import("./tools/directDebit/getMandateDebitStatus.js");
|
|
47
|
+
await import("./tools/directDebit/cancelMandate.js");
|
|
48
|
+
}
|
|
49
|
+
export const server = new Server({ name: "monnify-mcp", version: "1.0.0" }, { capabilities: { tools: {} } });
|
|
50
|
+
server.oninitialized = () => {
|
|
51
|
+
const clientName = server.getClientVersion()?.name;
|
|
52
|
+
setClientName(clientName);
|
|
53
|
+
logger.info("MCP client connected", { client: clientName ?? "unknown" });
|
|
54
|
+
};
|
|
55
|
+
server.setRequestHandler(ListToolsRequestSchema, async () => ({
|
|
56
|
+
tools: getAllToolDefinitions(),
|
|
57
|
+
}));
|
|
58
|
+
server.setRequestHandler(CallToolRequestSchema, async (request) => {
|
|
59
|
+
const { name, arguments: args } = request.params;
|
|
60
|
+
try {
|
|
61
|
+
const result = await dispatchTool(name, args ?? {});
|
|
62
|
+
return { content: result.content, isError: result.isError };
|
|
63
|
+
}
|
|
64
|
+
catch (error) {
|
|
65
|
+
if (error instanceof MonnifyApiError) {
|
|
66
|
+
return { content: [error.toMcpContent()], isError: true };
|
|
67
|
+
}
|
|
68
|
+
if (error instanceof ValidationError) {
|
|
69
|
+
return { content: [error.toMcpContent()], isError: true };
|
|
70
|
+
}
|
|
71
|
+
logger.error("Unhandled tool error", { tool: name, error });
|
|
72
|
+
return errorResult(`Internal error in "${name}". Check server logs.`);
|
|
73
|
+
}
|
|
74
|
+
});
|
|
75
|
+
const transport = env().TRANSPORT;
|
|
76
|
+
if (transport === "http") {
|
|
77
|
+
const { startHttpTransport } = await import("./transport/http.js");
|
|
78
|
+
await startHttpTransport(server);
|
|
79
|
+
}
|
|
80
|
+
else {
|
|
81
|
+
const { startStdioTransport } = await import("./transport/stdio.js");
|
|
82
|
+
await startStdioTransport(server);
|
|
83
|
+
}
|
|
84
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
type AnyZodObject = z.ZodObject<z.ZodRawShape>;
|
|
3
|
+
export declare const InitiatePaymentBodySchema: AnyZodObject;
|
|
4
|
+
export declare const ReserveAccountBodySchema: AnyZodObject;
|
|
5
|
+
export declare const CreateInvoiceBodySchema: AnyZodObject;
|
|
6
|
+
export declare const ProcessRefundBodySchema: AnyZodObject;
|
|
7
|
+
export declare const ChargeCardBodySchema: AnyZodObject;
|
|
8
|
+
export declare const AuthoriseCardOtpBodySchema: AnyZodObject;
|
|
9
|
+
export declare const AuthoriseCard3dsBodySchema: AnyZodObject;
|
|
10
|
+
export declare const CreateMandateBodySchema: AnyZodObject;
|
|
11
|
+
export declare const DebitMandateBodySchema: AnyZodObject;
|
|
12
|
+
export declare const VerifyBvnBodySchema: AnyZodObject;
|
|
13
|
+
export declare const CancelMandateBodySchema: z.ZodObject<{
|
|
14
|
+
mandateReference: z.ZodString;
|
|
15
|
+
cancellationReason: z.ZodOptional<z.ZodString>;
|
|
16
|
+
}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
|
|
17
|
+
mandateReference: z.ZodString;
|
|
18
|
+
cancellationReason: z.ZodOptional<z.ZodString>;
|
|
19
|
+
}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
|
|
20
|
+
mandateReference: z.ZodString;
|
|
21
|
+
cancellationReason: z.ZodOptional<z.ZodString>;
|
|
22
|
+
}, z.ZodTypeAny, "passthrough">>;
|
|
23
|
+
export {};
|
|
24
|
+
//# sourceMappingURL=compat.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"compat.d.ts","sourceRoot":"","sources":["../../src/schemas/compat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,KAAK,YAAY,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;AAI/C,eAAO,MAAM,yBAAyB,cAAqC,CAAC;AAC5E,eAAO,MAAM,wBAAwB,cAAqC,CAAC;AAC3E,eAAO,MAAM,uBAAuB,cAA6B,CAAC;AAClE,eAAO,MAAM,uBAAuB,cAA8B,CAAC;AACnE,eAAO,MAAM,oBAAoB,cAAsB,CAAC;AACxD,eAAO,MAAM,0BAA0B,cAA4B,CAAC;AACpE,eAAO,MAAM,0BAA0B,cAAgC,CAAC;AACxE,eAAO,MAAM,uBAAuB,cAA6B,CAAC;AAClE,eAAO,MAAM,sBAAsB,cAA4B,CAAC;AAChE,eAAO,MAAM,mBAAmB,cAA+B,CAAC;AAEhE,eAAO,MAAM,uBAAuB;;;;;;;;;gCAKpB,CAAC"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { schemas as _s } from "./generated.js";
|
|
3
|
+
const s = _s;
|
|
4
|
+
export const InitiatePaymentBodySchema = s["InitializeTransactionRequest"];
|
|
5
|
+
export const ReserveAccountBodySchema = s["CreateReservedAccountRequest"];
|
|
6
|
+
export const CreateInvoiceBodySchema = s["CreateInvoiceRequest"];
|
|
7
|
+
export const ProcessRefundBodySchema = s["InitiateRefundRequest"];
|
|
8
|
+
export const ChargeCardBodySchema = s["ChargeRequest"];
|
|
9
|
+
export const AuthoriseCardOtpBodySchema = s["AuthorizeOTPRequest"];
|
|
10
|
+
export const AuthoriseCard3dsBodySchema = s["Authorize3DSCardRequest"];
|
|
11
|
+
export const CreateMandateBodySchema = s["CreateMandateRequest"];
|
|
12
|
+
export const DebitMandateBodySchema = s["DebitMandateRequest"];
|
|
13
|
+
export const VerifyBvnBodySchema = s["BVNVerificationRequest"];
|
|
14
|
+
export const CancelMandateBodySchema = z
|
|
15
|
+
.object({
|
|
16
|
+
mandateReference: z.string().min(1),
|
|
17
|
+
cancellationReason: z.string().optional(),
|
|
18
|
+
})
|
|
19
|
+
.passthrough();
|
|
20
|
+
//# sourceMappingURL=compat.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"compat.js","sourceRoot":"","sources":["../../src/schemas/compat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAI/C,MAAM,CAAC,GAAG,EAA6C,CAAC;AAExD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,8BAA8B,CAAE,CAAC;AAC5E,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,8BAA8B,CAAE,CAAC;AAC3E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,sBAAsB,CAAE,CAAC;AAClE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,uBAAuB,CAAE,CAAC;AACnE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,eAAe,CAAE,CAAC;AACxD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,qBAAqB,CAAE,CAAC;AACpE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,yBAAyB,CAAE,CAAC;AACxE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,sBAAsB,CAAE,CAAC;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,qBAAqB,CAAE,CAAC;AAChE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,wBAAwB,CAAE,CAAC;AAEhE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC1C,CAAC;KACD,WAAW,EAAE,CAAC"}
|