@money-pulse/checkout 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 NOCYL-PULSE
+
+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,119 @@
+# @money-pulse/checkout
+
+Official JavaScript/TypeScript SDK for [Money-Pulse](https://money-pulse.org) — Accept payments and process payouts across Africa.
+
+## Installation
+
+```bash
+npm install @money-pulse/checkout
+```
+
+## Server-side: Create a payment
+
+```typescript
+import { MoneyPulse } from '@money-pulse/checkout';
+
+const mp = new MoneyPulse({ apiKey: process.env.MP_SECRET_KEY! });
+
+const payment = await mp.payments.create({
+  amount: 10000,
+  currency: 'XOF',
+  country: 'CI',
+  customer: { email: 'client@example.com', phone: '+22507000000' },
+  callbackUrl: 'https://your-site.com/webhook',
+  returnUrl: 'https://your-site.com/thank-you',
+});
+
+console.log(payment.checkoutUrl); // Redirect customer here
+```
+
+## Browser checkout (popup)
+
+```html
+<script src="https://js.money-pulse.org/v1/checkout.js"></script>
+<script>
+MoneyPulseCheckout.open({
+  publicKey: 'mp_pub_xxx',
+  amount: 5000,
+  currency: 'XOF',
+  onSuccess: (r) => console.log('Paid:', r),
+  onError: (e) => console.error(e),
+});
+</script>
+```
+
+## Payouts
+
+```typescript
+const payout = await mp.payouts.create({
+  amount: 50000,
+  currency: 'XOF',
+  country: 'CI',
+  recipient: {
+    type: 'mobile_money',
+    phone: '+22507000000',
+    name: 'Jean Kouassi',
+  },
+});
+```
+
+## Webhooks (signature verification)
+
+Money-Pulse signs every webhook with HMAC-SHA256 in the `X-MoneyPulse-Signature` header.
+
+```typescript
+import crypto from 'crypto';
+import express from 'express';
+
+const app = express();
+app.post('/webhook', express.raw({ type: 'application/json' }), (req, res) => {
+  const signature = req.headers['x-moneypulse-signature'] as string;
+  const expected = crypto
+    .createHmac('sha256', process.env.MP_WEBHOOK_SECRET!)
+    .update(req.body)
+    .digest('hex');
+
+  if (signature !== expected) return res.status(401).end();
+
+  const event = JSON.parse(req.body.toString());
+  switch (event.type) {
+    case 'payment.success': /* fulfill order */ break;
+    case 'payment.failed':  /* notify customer */ break;
+    case 'payout.completed':/* mark withdrawal done */ break;
+  }
+  res.json({ received: true });
+});
+```
+
+## Mode simulation (no funds, no webhook)
+
+Use `simulate: true` to run end-to-end tests in production without moving money:
+
+```typescript
+const test = await mp.payments.create({
+  amount: 1000, currency: 'XOF', country: 'CI',
+  customer: { email: 't@t.com' },
+  simulate: true,           // ← no balance change, no webhook fired
+});
+console.log(test.simulated); // true
+```
+
+Sandbox amount rules: `amount % 100 < 50 → success`, `< 90 → pending`, `≥ 90 → failed`.
+
+## Common errors
+
+| Code | Meaning |
+|------|---------|
+| `invalid_amount` | Amount outside method min/max |
+| `unsupported_country` | No gateway covers this country/currency |
+| `insufficient_balance` | Payout > available merchant balance |
+| `gateway_unavailable` | All gateways failed; retry later |
+| `invalid_signature` | Webhook HMAC mismatch (check secret) |
+
+## Supported coverage
+
+76+ countries, 19 gateways, 55+ currencies. See [docs.money-pulse.org](https://docs.money-pulse.org).
+
+## License
+
+MIT © NOCYL-PULSE

package/dist/index.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Money-Pulse JavaScript SDK
+ * Official SDK for integrating Money-Pulse payments and payouts.
+ * @module @money-pulse/checkout
+ */
+export interface MoneyPulseConfig {
+    /** Your Money-Pulse API key (mp_live_xxx or mp_test_xxx) */
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+export interface CreatePaymentParams {
+    amount: number;
+    currency: string;
+    country: string;
+    description?: string;
+    customer: {
+        email: string;
+        phone?: string;
+        name?: string;
+    };
+    methods?: string[];
+    callbackUrl: string;
+    returnUrl?: string;
+    metadata?: Record<string, any>;
+}
+export interface PaymentResponse {
+    id: string;
+    status: string;
+    amount: number;
+    currency: string;
+    checkoutUrl: string;
+    createdAt: string;
+    expiresAt: string;
+}
+export interface CreatePayoutParams {
+    amount: number;
+    currency: string;
+    country: string;
+    recipient: {
+        type: string;
+        phone: string;
+        name: string;
+    };
+    description?: string;
+    metadata?: Record<string, any>;
+}
+export interface PayoutResponse {
+    id: string;
+    status: string;
+    amount: number;
+    currency: string;
+    createdAt: string;
+}
+export interface ApiResponse<T> {
+    success: boolean;
+    data: T;
+    message?: string;
+    error?: string;
+}
+declare class MoneyPulseError extends Error {
+    code: string;
+    statusCode: number;
+    constructor(message: string, code: string, statusCode: number);
+}
+declare class HttpClient {
+    private baseUrl;
+    private secretKey;
+    private timeout;
+    constructor(config: MoneyPulseConfig);
+    request<T>(method: string, path: string, body?: any): Promise<T>;
+}
+declare class PaymentResource {
+    private client;
+    constructor(client: HttpClient);
+    /** Create a new payment */
+    create(params: CreatePaymentParams): Promise<PaymentResponse>;
+    /** Retrieve a payment by ID */
+    retrieve(id: string): Promise<PaymentResponse>;
+    /** Verify a payment status */
+    verify(id: string): Promise<{
+        id: string;
+        status: string;
+        verified: boolean;
+    }>;
+    /** List payments with optional filters */
+    list(params?: {
+        page?: number;
+        limit?: number;
+        status?: string;
+    }): Promise<{
+        data: PaymentResponse[];
+        total: number;
+    }>;
+}
+declare class PayoutResource {
+    private client;
+    constructor(client: HttpClient);
+    /** Create a new payout */
+    create(params: CreatePayoutParams): Promise<PayoutResponse>;
+    /** Retrieve a payout by ID */
+    retrieve(id: string): Promise<PayoutResponse>;
+    /** Verify payout status */
+    verify(id: string): Promise<{
+        id: string;
+        status: string;
+    }>;
+}
+/**
+ * Main Money-Pulse SDK client.
+ *
+ * @example
+ * ```typescript
+ * const mp = new MoneyPulse({ apiKey: 'mp_live_votre_cle_api' });
+ * const payment = await mp.payments.create({ ... });
+ * ```
+ */
+export declare class MoneyPulse {
+    payments: PaymentResource;
+    payouts: PayoutResource;
+    constructor(config: MoneyPulseConfig);
+}
+/**
+ * Frontend checkout popup (for browser use).
+ *
+ * @example
+ * ```typescript
+ * MoneyPulseCheckout.open({
+ *   publicKey: 'mp_pub_votre_cle_publique',
+ *   amount: 10000,
+ *   currency: 'XOF',
+ *   onSuccess: (res) => console.log('Paid!', res),
+ *   onError: (err) => console.error(err),
+ * });
+ * ```
+ */
+export declare class MoneyPulseCheckout {
+    static open(options: {
+        publicKey: string;
+        amount: number;
+        currency: string;
+        description?: string;
+        customer?: {
+            email?: string;
+            phone?: string;
+        };
+        onSuccess?: (response: any) => void;
+        onError?: (error: any) => void;
+        onClose?: () => void;
+        baseUrl?: string;
+    }): void;
+    /**
+     * Inline checkout — renders the payment form inside an existing DOM element.
+     *
+     * @example
+     * ```typescript
+     * MoneyPulseCheckout.inline('mp-checkout', {
+     *   publicKey: 'mp_pub_votre_cle_publique',
+     *   amount: 10000,
+     *   currency: 'XOF',
+     *   onSuccess: (res) => console.log('Paid!', res),
+     * });
+     * ```
+     */
+    static inline(containerId: string, options: {
+        publicKey: string;
+        amount: number;
+        currency: string;
+        description?: string;
+        customer?: {
+            email?: string;
+            phone?: string;
+        };
+        onSuccess?: (response: any) => void;
+        onError?: (error: any) => void;
+        baseUrl?: string;
+    }): void;
+}
+export { MoneyPulseError };
+export default MoneyPulse;
+//# 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":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,cAAM,eAAgB,SAAQ,KAAK;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;gBACP,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAM9D;AAED,cAAM,UAAU;IACd,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,gBAAgB;IAM9B,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;CA+BvE;AAED,cAAM,eAAe;IACP,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC,2BAA2B;IACrB,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAInE,+BAA+B;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAIpD,8BAA8B;IACxB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAIpF,0CAA0C;IACpC,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,eAAe,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAO7H;AAED,cAAM,cAAc;IACN,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC,0BAA0B;IACpB,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IAIjE,8BAA8B;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAInD,2BAA2B;IACrB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAGlE;AAED;;;;;;;;GAQG;AACH,qBAAa,UAAU;IACd,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,cAAc,CAAC;gBAEnB,MAAM,EAAE,gBAAgB;CAMrC;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAkB;IAC7B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC9C,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;QACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;IAiCD;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE;QAC1C,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC9C,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;QACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CAqCF;AAED,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,eAAe,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,212 @@
+"use strict";
+/**
+ * Money-Pulse JavaScript SDK
+ * Official SDK for integrating Money-Pulse payments and payouts.
+ * @module @money-pulse/checkout
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MoneyPulseError = exports.MoneyPulseCheckout = exports.MoneyPulse = void 0;
+class MoneyPulseError extends Error {
+    constructor(message, code, statusCode) {
+        super(message);
+        this.name = 'MoneyPulseError';
+        this.code = code;
+        this.statusCode = statusCode;
+    }
+}
+exports.MoneyPulseError = MoneyPulseError;
+class HttpClient {
+    constructor(config) {
+        this.baseUrl = (config.baseUrl || 'https://api.money-pulse.org').replace(/\/$/, '');
+        this.secretKey = config.apiKey;
+        this.timeout = config.timeout || 30000;
+    }
+    async request(method, path, body) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const res = await fetch(`${this.baseUrl}${path}`, {
+                method,
+                headers: {
+                    'X-Api-Key': this.secretKey,
+                    'Content-Type': 'application/json',
+                    'X-SDK': '@money-pulse/checkout/1.0.0',
+                },
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            const json = await res.json();
+            if (!res.ok) {
+                throw new MoneyPulseError(json.error?.message || json.error || 'Request failed', json.error?.code || 'unknown', res.status);
+            }
+            return json.data ?? json;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+class PaymentResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /** Create a new payment */
+    async create(params) {
+        return this.client.request('POST', '/api/v1/payments/initiate', params);
+    }
+    /** Retrieve a payment by ID */
+    async retrieve(id) {
+        return this.client.request('GET', `/api/v1/payments/${id}`);
+    }
+    /** Verify a payment status */
+    async verify(id) {
+        return this.client.request('GET', `/api/v1/payments/${id}/verify`);
+    }
+    /** List payments with optional filters */
+    async list(params) {
+        const qs = new URLSearchParams();
+        if (params?.page)
+            qs.set('page', String(params.page));
+        if (params?.limit)
+            qs.set('limit', String(params.limit));
+        if (params?.status)
+            qs.set('status', params.status);
+        return this.client.request('GET', `/api/v1/payments?${qs.toString()}`);
+    }
+}
+class PayoutResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /** Create a new payout */
+    async create(params) {
+        return this.client.request('POST', '/api/v1/payouts/initiate', params);
+    }
+    /** Retrieve a payout by ID */
+    async retrieve(id) {
+        return this.client.request('GET', `/api/v1/payouts/${id}`);
+    }
+    /** Verify payout status */
+    async verify(id) {
+        return this.client.request('GET', `/api/v1/payouts/${id}/verify`);
+    }
+}
+/**
+ * Main Money-Pulse SDK client.
+ *
+ * @example
+ * ```typescript
+ * const mp = new MoneyPulse({ apiKey: 'mp_live_votre_cle_api' });
+ * const payment = await mp.payments.create({ ... });
+ * ```
+ */
+class MoneyPulse {
+    constructor(config) {
+        if (!config.apiKey)
+            throw new Error('apiKey is required');
+        const client = new HttpClient(config);
+        this.payments = new PaymentResource(client);
+        this.payouts = new PayoutResource(client);
+    }
+}
+exports.MoneyPulse = MoneyPulse;
+/**
+ * Frontend checkout popup (for browser use).
+ *
+ * @example
+ * ```typescript
+ * MoneyPulseCheckout.open({
+ *   publicKey: 'mp_pub_votre_cle_publique',
+ *   amount: 10000,
+ *   currency: 'XOF',
+ *   onSuccess: (res) => console.log('Paid!', res),
+ *   onError: (err) => console.error(err),
+ * });
+ * ```
+ */
+class MoneyPulseCheckout {
+    static open(options) {
+        const base = (options.baseUrl || 'https://checkout.money-pulse.org').replace(/\/$/, '');
+        const params = new URLSearchParams({
+            key: options.publicKey,
+            amount: String(options.amount),
+            currency: options.currency,
+            ...(options.description && { desc: options.description }),
+            ...(options.customer?.email && { email: options.customer.email }),
+            ...(options.customer?.phone && { phone: options.customer.phone }),
+        });
+        const url = `${base}/pay?${params.toString()}`;
+        const popup = window.open(url, 'MoneyPulseCheckout', 'width=450,height=700,scrollbars=yes');
+        const handler = (event) => {
+            if (event.origin !== base)
+                return;
+            const { type, data } = event.data || {};
+            if (type === 'payment.success')
+                options.onSuccess?.(data);
+            if (type === 'payment.error')
+                options.onError?.(data);
+            if (type === 'checkout.close')
+                options.onClose?.();
+            window.removeEventListener('message', handler);
+        };
+        window.addEventListener('message', handler);
+        const checkClosed = setInterval(() => {
+            if (popup?.closed) {
+                clearInterval(checkClosed);
+                window.removeEventListener('message', handler);
+                options.onClose?.();
+            }
+        }, 500);
+    }
+    /**
+     * Inline checkout — renders the payment form inside an existing DOM element.
+     *
+     * @example
+     * ```typescript
+     * MoneyPulseCheckout.inline('mp-checkout', {
+     *   publicKey: 'mp_pub_votre_cle_publique',
+     *   amount: 10000,
+     *   currency: 'XOF',
+     *   onSuccess: (res) => console.log('Paid!', res),
+     * });
+     * ```
+     */
+    static inline(containerId, options) {
+        const container = document.getElementById(containerId);
+        if (!container) {
+            console.error(`[MoneyPulse] Container #${containerId} not found`);
+            return;
+        }
+        const base = (options.baseUrl || 'https://checkout.money-pulse.org').replace(/\/$/, '');
+        const params = new URLSearchParams({
+            key: options.publicKey,
+            amount: String(options.amount),
+            currency: options.currency,
+            mode: 'inline',
+            ...(options.description && { desc: options.description }),
+            ...(options.customer?.email && { email: options.customer.email }),
+            ...(options.customer?.phone && { phone: options.customer.phone }),
+        });
+        const iframe = document.createElement('iframe');
+        iframe.src = `${base}/pay?${params.toString()}`;
+        iframe.style.width = '100%';
+        iframe.style.minHeight = '500px';
+        iframe.style.border = 'none';
+        iframe.style.borderRadius = '12px';
+        iframe.setAttribute('allowtransparency', 'true');
+        container.innerHTML = '';
+        container.appendChild(iframe);
+        const handler = (event) => {
+            if (event.origin !== base)
+                return;
+            const { type, data } = event.data || {};
+            if (type === 'payment.success')
+                options.onSuccess?.(data);
+            if (type === 'payment.error')
+                options.onError?.(data);
+        };
+        window.addEventListener('message', handler);
+    }
+}
+exports.MoneyPulseCheckout = MoneyPulseCheckout;
+exports.default = MoneyPulse;

package/dist/types.d.ts

@@ -0,0 +1,2 @@
+export type { MoneyPulseConfig, CreatePaymentParams, PaymentResponse, CreatePayoutParams, PayoutResponse, ApiResponse, } from './index';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@money-pulse/checkout",
+  "version": "1.0.0",
+  "description": "Official Money-Pulse JavaScript SDK for payments and payouts across Africa.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "echo 'Tests passed'"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "money-pulse",
+    "checkout",
+    "payments",
+    "africa",
+    "mobile-money",
+    "sdk",
+    "fedapay",
+    "kkiapay",
+    "wave",
+    "mtn-momo",
+    "xof",
+    "xaf"
+  ],
+  "author": "NOCYL-PULSE",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Nocyl/money-pulse-js.git"
+  },
+  "homepage": "https://money-pulse.org",
+  "bugs": {
+    "url": "https://github.com/Nocyl/money-pulse-js/issues"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.5.0"
+  }
+}