@maxkabechani/mtn-momo-sdk 0.1.0

package/lib/esm/validate.js

@@ -0,0 +1,100 @@
+import { strictEqual } from "assert";
+import { Environment } from "./common";
+export function validateRequestToPay(paymentRequest) {
+    const { amount, currency, payer } = paymentRequest || {};
+    return Promise.resolve().then(() => {
+        strictEqual(isTruthy(amount), true, "amount is required");
+        strictEqual(isNumeric(amount), true, "amount must be a number");
+        strictEqual(isTruthy(currency), true, "currency is required");
+        strictEqual(isTruthy(payer), true, "payer is required");
+        strictEqual(isTruthy(payer.partyId), true, "payer.partyId is required");
+        strictEqual(isTruthy(payer.partyIdType), true, "payer.partyIdType is required");
+        strictEqual(isString(currency), true, "currency must be a string");
+    });
+}
+export function validateWithdrawalRequest(request) {
+    const { amount, currency, payee } = request || {};
+    return Promise.resolve().then(() => {
+        strictEqual(isTruthy(amount), true, "amount is required");
+        strictEqual(isNumeric(amount), true, "amount must be a number");
+        strictEqual(isTruthy(currency), true, "currency is required");
+        strictEqual(isTruthy(payee), true, "payee is required");
+        strictEqual(isTruthy(payee?.partyId), true, "payee.partyId is required");
+        strictEqual(isTruthy(payee?.partyIdType), true, "payee.partyIdType is required");
+        strictEqual(isString(currency), true, "currency must be a string");
+    });
+}
+export function validateDepositRequest(request) {
+    const { amount, currency, payee } = request || {};
+    return Promise.resolve().then(() => {
+        strictEqual(isTruthy(amount), true, "amount is required");
+        strictEqual(isNumeric(amount), true, "amount must be a number");
+        strictEqual(isTruthy(currency), true, "currency is required");
+        strictEqual(isTruthy(payee), true, "payee is required");
+        strictEqual(isTruthy(payee?.partyId), true, "payee.partyId is required");
+        strictEqual(isTruthy(payee?.partyIdType), true, "payee.partyIdType is required");
+        strictEqual(isString(currency), true, "currency must be a string");
+    });
+}
+export function validateRefundRequest(request) {
+    const { amount, currency, referenceIdToRefund } = request || {};
+    return Promise.resolve().then(() => {
+        strictEqual(isTruthy(referenceIdToRefund), true, "referenceIdToRefund is required");
+        strictEqual(isUuid4(referenceIdToRefund), true, "referenceIdToRefund must be a valid uuid v4");
+        strictEqual(isTruthy(amount), true, "amount is required");
+        strictEqual(isNumeric(amount), true, "amount must be a number");
+        strictEqual(isTruthy(currency), true, "currency is required");
+        strictEqual(isString(currency), true, "currency must be a string");
+    });
+}
+export function validateTransfer(payoutRequest) {
+    const { amount, currency, payee, referenceId } = payoutRequest || {};
+    return Promise.resolve().then(() => {
+        strictEqual(isTruthy(referenceId), true, "referenceId is required");
+        strictEqual(isUuid4(referenceId), true, "referenceId must be a valid uuid v4");
+        strictEqual(isTruthy(amount), true, "amount is required");
+        strictEqual(isNumeric(amount), true, "amount must be a number");
+        strictEqual(isTruthy(currency), true, "currency is required");
+        strictEqual(isTruthy(payee), true, "payee is required");
+        strictEqual(isTruthy(payee.partyId), true, "payee.partyId is required");
+        strictEqual(isTruthy(payee.partyIdType), true, "payee.partyIdType is required");
+        strictEqual(isString(currency), true, "amount must be a string");
+    });
+}
+export function validateGlobalConfig(config) {
+    const { callbackHost, baseUrl, environment } = config;
+    strictEqual(isTruthy(callbackHost), true, "callbackHost is required");
+    if (environment && environment !== Environment.SANDBOX) {
+        strictEqual(isTruthy(baseUrl), true, "baseUrl is required if environment is not sandbox");
+        strictEqual(isString(baseUrl), true, "baseUrl must be a string");
+    }
+}
+export function validateProductConfig(config) {
+    validateSubscriptionConfig(config);
+    validateUserConfig(config);
+}
+export function validateSubscriptionConfig(config) {
+    const { primaryKey } = config;
+    strictEqual(isTruthy(primaryKey), true, "primaryKey is required");
+    strictEqual(isString(primaryKey), true, "primaryKey must be a string");
+}
+export function validateUserConfig({ userId, userSecret }) {
+    strictEqual(isTruthy(userId), true, "userId is required");
+    strictEqual(isString(userId), true, "userId must be a string");
+    strictEqual(isTruthy(userSecret), true, "userSecret is required");
+    strictEqual(isString(userSecret), true, "userSecret must be a string");
+    strictEqual(isUuid4(userId), true, "userId must be a valid uuid v4");
+}
+function isNumeric(value) {
+    return !isNaN(parseInt(value, 10));
+}
+function isTruthy(value) {
+    return !!value;
+}
+function isString(value) {
+    return typeof value === "string";
+}
+function isUuid4(value) {
+    return /^[0-9A-F]{8}-[0-9A-F]{4}-4[0-9A-F]{3}-[89AB][0-9A-F]{3}-[0-9A-F]{12}$/i.test(value);
+}
+//# sourceMappingURL=validate.js.map

package/lib/esm/validate.js.map

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

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@maxkabechani/mtn-momo-sdk",
+  "version": "0.1.0",
+  "description": "MTN Mobile Money API Client for NodeJS written in TypeScript",
+  "type": "module",
+  "main": "./lib/cjs/index.js",
+  "module": "./lib/esm/index.js",
+  "types": "./lib/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./lib/esm/index.d.ts",
+        "default": "./lib/esm/index.js"
+      },
+      "require": {
+        "types": "./lib/cjs/index.d.ts",
+        "default": "./lib/cjs/index.js"
+      }
+    }
+  },
+  "scripts": {
+    "clean": "rm -rf lib",
+    "typecheck": "bunx tsc -p tsconfig.typecheck.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build": "bun run clean && bun run build:esm && bun run build:cjs && mkdir -p lib/esm lib/cjs && echo '{\"type\":\"module\"}' > lib/esm/package.json && echo '{\"type\":\"commonjs\"}' > lib/cjs/package.json",
+    "test": "NODE_ENV=test vitest run",
+    "test:integration": "vitest run test/integration.test.ts",
+    "test:watch": "NODE_ENV=test vitest",
+    "test:coverage": "NODE_ENV=test vitest run --coverage",
+    "example:collections": "bun examples/collections.ts",
+    "example:collections:extended": "bun examples/collections-extended.ts",
+    "example:disbursements": "bun examples/disbursements.ts",
+    "example:disbursements:v2": "bun examples/disbursements-v2.ts",
+    "example:remittance": "bun examples/remittance.ts",
+    "example:users": "bun examples/users.ts"
+  },
+  "keywords": [
+    "MTN",
+    "Mobile",
+    "Money",
+    "Momo",
+    "TypeScript",
+    "NodeJS",
+    "Payment",
+    "API"
+  ],
+  "bin": {
+    "momo-sandbox": "lib/cjs/cli.js"
+  },
+  "license": "ISC",
+  "dependencies": {
+    "axios": "^1.13.6",
+    "commander": "^14.0.3",
+    "uuid": "^13.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "@vitest/coverage-v8": "^4.1.1",
+    "axios-mock-adapter": "^2.1.0",
+    "dotenv": "^17.3.1",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.1"
+  },
+  "files": [
+    "lib"
+  ]
+}