@mnemopay/sdk 0.7.5 → 0.8.0

package/dist/rails/paystack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paystack.d.ts","sourceRoot":"","sources":["../../src/rails/paystack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAKjE,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAErE,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,aAAa,CAAC,EAAE;QACd,iBAAiB,EAAE,MAAM,CAAC;QAC1B,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,gCAAgC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC3B;AAID,qBAAa,YAAa,YAAW,WAAW;IAC9C,QAAQ,CAAC,IAAI,cAAc;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAW;IAErC,sEAAsE;IACtE,OAAO,CAAC,aAAa,CAA0B;gBAEnC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc;IAiBtD;;;;;;OAMG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GACA,OAAO,CAAC,kBAAkB,CAAC;IA4D9B;;;OAGG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA8BxF;;;OAGG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiCpF;;;OAGG;IACG,uBAAuB,CAC3B,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,OAAO,CAAC,yBAAyB,CAAC;IAiCrC;;;OAGG;IACG,gBAAgB,CACpB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,sBAAsB,CAAC;IA6BlC;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,oBAAoB;IAsBhF;;OAEG;IACG,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAYnH;;OAEG;IACG,SAAS,CAAC,OAAO,SAAY,EAAE,OAAO,SAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAUnG,OAAO,CAAC,iBAAiB;IA0BzB;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIpC;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;YAM7B,OAAO;CAiCtB;AAID,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAwBjD,CAAC"}

package/dist/rails/paystack.js

@@ -0,0 +1,366 @@
+"use strict";
+/**
+ * Paystack Payment Rail for MnemoPay
+ *
+ * Production-grade integration with Paystack's payment infrastructure.
+ * Supports NGN, GHS, ZAR, KES, USD. Uses the same battle-tested patterns
+ * from the Dele backend: idempotency guards, webhook HMAC-SHA512 verification,
+ * failure reversals, and reference-based deduplication.
+ *
+ * Usage:
+ *   const rail = new PaystackRail("sk_live_...", { currency: "NGN" });
+ *   const agent = MnemoPay.quick("agent-1", { paymentRail: rail });
+ *
+ * Flows:
+ *   1. Checkout:  createHold → user pays at authorization_url → capturePayment (verify)
+ *   2. Saved card: createHold with authorizationCode → auto-charged → capturePayment (verify)
+ *   3. Payout:    createTransferRecipient → initiateTransfer
+ *   4. Webhook:   verifyWebhook → process event
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NIGERIAN_BANKS = exports.PaystackRail = void 0;
+const crypto_1 = require("crypto");
+// ─── Paystack Rail ─────────────────────────────────────────────────────────
+class PaystackRail {
+    name = "paystack";
+    secretKey;
+    currency;
+    baseUrl;
+    callbackUrl;
+    timeoutMs;
+    channels;
+    /** Reference-based idempotency guard — tracks processed references */
+    processedRefs = new Set();
+    constructor(secretKey, config) {
+        if (!secretKey || typeof secretKey !== "string") {
+            throw new Error("Paystack secret key is required");
+        }
+        if (!secretKey.startsWith("sk_")) {
+            throw new Error("Invalid Paystack secret key format (must start with sk_)");
+        }
+        this.secretKey = secretKey;
+        this.currency = config?.currency ?? "NGN";
+        this.baseUrl = (config?.baseUrl ?? "https://api.paystack.co").replace(/\/$/, "");
+        this.callbackUrl = config?.callbackUrl;
+        this.timeoutMs = config?.timeoutMs ?? 30_000;
+        this.channels = config?.channels;
+    }
+    // ── PaymentRail Interface ───────────────────────────────────────────────
+    /**
+     * Initialize a Paystack transaction (hold).
+     *
+     * If no authorizationCode is in metadata, returns an authorization_url
+     * for checkout. If authorizationCode is present, charges the saved card
+     * directly (no redirect needed).
+     */
+    async createHold(amount, reason, agentId, options) {
+        if (!Number.isFinite(amount) || amount <= 0) {
+            throw new Error("Amount must be a positive finite number");
+        }
+        const reference = `mnemo_${agentId}_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+        const amountInMinor = this.toMinorUnits(amount);
+        const email = options?.email ?? `${agentId}@mnemopay.agent`;
+        if (options?.authorizationCode) {
+            // Charge saved card directly
+            const response = await this.request("POST", "/transaction/charge_authorization", {
+                authorization_code: options.authorizationCode,
+                email,
+                amount: amountInMinor,
+                currency: this.currency,
+                reference,
+                metadata: {
+                    agentId,
+                    reason: reason.slice(0, 500),
+                    source: "mnemopay",
+                    ...options?.metadata,
+                },
+            });
+            return {
+                externalId: reference,
+                status: response.data?.status ?? "pending",
+                reference,
+            };
+        }
+        // Initialize checkout transaction
+        const payload = {
+            email,
+            amount: amountInMinor,
+            currency: this.currency,
+            reference,
+            metadata: {
+                agentId,
+                reason: reason.slice(0, 500),
+                source: "mnemopay",
+                ...options?.metadata,
+            },
+        };
+        if (this.callbackUrl)
+            payload.callback_url = this.callbackUrl;
+        if (this.channels)
+            payload.channels = this.channels;
+        const response = await this.request("POST", "/transaction/initialize", payload);
+        return {
+            externalId: reference,
+            status: "initialized",
+            authorizationUrl: response.data?.authorization_url,
+            accessCode: response.data?.access_code,
+            reference,
+        };
+    }
+    /**
+     * Verify/capture a Paystack transaction.
+     * Call after user completes checkout or after charging saved card.
+     */
+    async capturePayment(externalId, _amount) {
+        if (!externalId || typeof externalId !== "string") {
+            throw new Error("Transaction reference is required");
+        }
+        // Idempotency: check if already processed
+        if (this.processedRefs.has(externalId)) {
+            // Re-verify to return current state
+            const response = await this.request("GET", `/transaction/verify/${encodeURIComponent(externalId)}`);
+            return this.mapVerifyResponse(response, externalId);
+        }
+        const response = await this.request("GET", `/transaction/verify/${encodeURIComponent(externalId)}`);
+        if (response.data?.status !== "success") {
+            return {
+                externalId,
+                status: response.data?.status ?? "failed",
+                amount: this.fromMinorUnits(response.data?.amount ?? 0),
+                currency: response.data?.currency ?? this.currency,
+                gatewayResponse: response.data?.gateway_response,
+            };
+        }
+        // Mark as processed (idempotency guard)
+        this.processedRefs.add(externalId);
+        return this.mapVerifyResponse(response, externalId);
+    }
+    /**
+     * Refund a Paystack transaction.
+     * Supports full and partial refunds.
+     */
+    async reversePayment(externalId, amount) {
+        if (!externalId || typeof externalId !== "string") {
+            throw new Error("Transaction reference is required");
+        }
+        if (!Number.isFinite(amount) || amount <= 0) {
+            throw new Error("Refund amount must be a positive finite number");
+        }
+        // First verify the transaction exists and get Paystack's internal ID
+        const verifyResponse = await this.request("GET", `/transaction/verify/${encodeURIComponent(externalId)}`);
+        const txId = verifyResponse.data?.id;
+        if (!txId) {
+            throw new Error(`Transaction ${externalId} not found on Paystack`);
+        }
+        const response = await this.request("POST", "/refund", {
+            transaction: txId,
+            amount: this.toMinorUnits(amount),
+        });
+        // Remove from processed refs so it can be re-verified
+        this.processedRefs.delete(externalId);
+        return {
+            externalId,
+            status: response.data?.status ?? "pending",
+            receiptId: response.data?.id?.toString(),
+        };
+    }
+    // ── Paystack-Specific Methods ───────────────────────────────────────────
+    /**
+     * Create a transfer recipient (bank account for payouts).
+     * Must be called before initiateTransfer.
+     */
+    async createTransferRecipient(name, accountNumber, bankCode, currency) {
+        if (!name || !accountNumber || !bankCode) {
+            throw new Error("Name, account number, and bank code are required");
+        }
+        // Resolve bank account first to verify it exists
+        const resolveResponse = await this.request("GET", `/bank/resolve?account_number=${encodeURIComponent(accountNumber)}&bank_code=${encodeURIComponent(bankCode)}`);
+        if (!resolveResponse.status) {
+            throw new Error(`Could not resolve bank account: ${resolveResponse.message}`);
+        }
+        const cur = currency ?? this.currency;
+        const response = await this.request("POST", "/transferrecipient", {
+            type: "nuban",
+            name,
+            account_number: accountNumber,
+            bank_code: bankCode,
+            currency: cur,
+        });
+        return {
+            recipientCode: response.data?.recipient_code,
+            name: response.data?.details?.account_name ?? name,
+            bankCode,
+            accountNumber,
+            currency: cur,
+        };
+    }
+    /**
+     * Initiate a bank transfer (payout).
+     * The recipient must already be created via createTransferRecipient.
+     */
+    async initiateTransfer(recipientCode, amount, reason, agentId) {
+        if (!recipientCode)
+            throw new Error("Recipient code is required");
+        if (!Number.isFinite(amount) || amount <= 0) {
+            throw new Error("Transfer amount must be a positive finite number");
+        }
+        const reference = `mnemo_xfer_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+        const response = await this.request("POST", "/transfer", {
+            source: "balance",
+            amount: this.toMinorUnits(amount),
+            recipient: recipientCode,
+            reason: reason.slice(0, 500),
+            reference,
+            metadata: {
+                agentId,
+                source: "mnemopay",
+            },
+        });
+        return {
+            externalId: response.data?.transfer_code ?? reference,
+            status: response.data?.status ?? "pending",
+            reference,
+            amount,
+            transferStatus: response.data?.status ?? "pending",
+        };
+    }
+    /**
+     * Verify a webhook signature (HMAC-SHA512).
+     * Returns the parsed event if valid, throws if signature mismatch.
+     */
+    verifyWebhook(rawBody, signature) {
+        if (!signature)
+            throw new Error("Webhook signature is required");
+        if (!rawBody)
+            throw new Error("Webhook body is required");
+        const bodyStr = typeof rawBody === "string" ? rawBody : rawBody.toString("utf-8");
+        const expected = (0, crypto_1.createHmac)("sha512", this.secretKey)
+            .update(bodyStr)
+            .digest("hex");
+        // Timing-safe comparison to prevent timing attacks
+        const sigBuffer = Buffer.from(signature, "hex");
+        const expectedBuffer = Buffer.from(expected, "hex");
+        if (sigBuffer.length !== expectedBuffer.length || !(0, crypto_1.timingSafeEqual)(sigBuffer, expectedBuffer)) {
+            throw new Error("Invalid webhook signature");
+        }
+        const event = JSON.parse(bodyStr);
+        return event;
+    }
+    /**
+     * Resolve a bank account — verify the account name matches.
+     */
+    async resolveBank(accountNumber, bankCode) {
+        const response = await this.request("GET", `/bank/resolve?account_number=${encodeURIComponent(accountNumber)}&bank_code=${encodeURIComponent(bankCode)}`);
+        return {
+            accountName: response.data?.account_name ?? "",
+            accountNumber: response.data?.account_number ?? accountNumber,
+        };
+    }
+    /**
+     * List available banks for a given country/currency.
+     */
+    async listBanks(country = "nigeria", perPage = 100) {
+        const response = await this.request("GET", `/bank?country=${country}&perPage=${perPage}`);
+        return (response.data ?? []).map((b) => ({
+            name: b.name,
+            code: b.code,
+        }));
+    }
+    // ── Response Mapping ─────────────────────────────────────────────────────
+    mapVerifyResponse(response, externalId) {
+        const data = response.data ?? {};
+        const auth = data.authorization;
+        return {
+            externalId,
+            status: data.status ?? "unknown",
+            amount: this.fromMinorUnits(data.amount ?? 0),
+            currency: data.currency ?? this.currency,
+            customerEmail: data.customer?.email,
+            authorization: auth ? {
+                authorizationCode: auth.authorization_code,
+                cardType: auth.card_type,
+                last4: auth.last4,
+                bank: auth.bank,
+                reusable: auth.reusable ?? false,
+            } : undefined,
+            metadata: data.metadata,
+            gatewayResponse: data.gateway_response,
+            paidAt: data.paid_at,
+            receiptId: data.id?.toString(),
+        };
+    }
+    // ── Currency Conversion ─────────────────────────────────────────────────
+    /**
+     * Convert major currency units to minor units (e.g., Naira → kobo).
+     * Paystack API expects amounts in minor units.
+     */
+    toMinorUnits(amount) {
+        return Math.round(amount * 100);
+    }
+    /**
+     * Convert minor units back to major units (e.g., kobo → Naira).
+     */
+    fromMinorUnits(minorAmount) {
+        return Math.round(minorAmount) / 100;
+    }
+    // ── HTTP Client ─────────────────────────────────────────────────────────
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const res = await fetch(url, {
+                method,
+                headers: {
+                    Authorization: `Bearer ${this.secretKey}`,
+                    "Content-Type": "application/json",
+                },
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            const json = await res.json().catch(() => ({}));
+            if (!res.ok) {
+                const msg = json.message || json.error || `Paystack API error (${res.status})`;
+                throw new Error(`Paystack ${method} ${path} failed: ${msg}`);
+            }
+            return json;
+        }
+        catch (err) {
+            if (err.name === "AbortError") {
+                throw new Error(`Paystack request timed out after ${this.timeoutMs}ms`);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+exports.PaystackRail = PaystackRail;
+// ─── Nigerian Bank Codes (common) ──────────────────────────────────────────
+exports.NIGERIAN_BANKS = {
+    "access": "044",
+    "citibank": "023",
+    "ecobank": "050",
+    "fidelity": "070",
+    "firstbank": "011",
+    "fcmb": "214",
+    "gtbank": "058",
+    "heritage": "030",
+    "keystone": "082",
+    "polaris": "076",
+    "providus": "101",
+    "stanbic": "221",
+    "standard": "068",
+    "sterling": "232",
+    "uba": "033",
+    "union": "032",
+    "unity": "215",
+    "wema": "035",
+    "zenith": "057",
+    "kuda": "50211",
+    "opay": "999992",
+    "palmpay": "999991",
+    "moniepoint": "50515",
+};
+//# sourceMappingURL=paystack.js.map

package/dist/rails/paystack.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mnemopay/sdk",
-  "version": "0.7.5",
-  "description": "Give any AI agent memory and a wallet in 5 lines. Unified SDK for Mnemosyne (cognitive memory) + AgentPay (escrow economics).",
+  "version": "0.8.0",
+  "description": "Give your AI agents real superpowers. Memory + Payments + Identity in one SDK. Double-entry ledger, escrow, fraud detection, multi-agent commerce.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -57,29 +57,31 @@
   "keywords": [
     "ai-agent",
     "agent-memory",
-    "memory",
     "agent-wallet",
+    "agent-payments",
+    "agent-identity",
+    "agent-banking",
     "payment",
     "escrow",
-    "llm",
-    "openai",
-    "anthropic",
-    "claude",
-    "aws-bedrock",
-    "google-vertex",
-    "langchain",
-    "langgraph",
+    "double-entry-ledger",
+    "fraud-detection",
+    "multi-agent",
     "mcp",
     "model-context-protocol",
+    "paystack",
+    "stripe",
+    "lightning",
     "cognitive-memory",
-    "wallet",
     "reputation",
     "agent-sdk",
-    "multi-agent",
     "ai-memory",
-    "session-memory",
-    "fraud-detection",
-    "micropayments"
+    "micropayments",
+    "llm",
+    "openai",
+    "anthropic",
+    "claude",
+    "langchain",
+    "langgraph"
   ],
   "author": "Jerry Omiagbo <jeremiah@getbizsuite.com>",
   "license": "MIT",