cobroya 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CobroYa
+
+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,231 @@
+# mercadopago-tool
+
+Mercado Pago tool connector for AI agents. Exposes Mercado Pago API actions through a simple, typed interface that AI agents can call via MCP-style tool registries.
+
+## Setup
+
+```bash
+npm install
+npm run build
+```
+
+```bash
+cp .env.example .env
+# Edit .env with your real token
+export MERCADO_PAGO_ACCESS_TOKEN="APP_USR-..."
+```
+
+Get your token from [Mercado Pago Developers](https://www.mercadopago.com/developers/en/docs/checkout-pro/additional-content/your-integrations/credentials).
+
+## Actions
+
+| Action | Description |
+|--------|-------------|
+| `create_payment_preference` | Create a checkout payment link with optional back_urls and notification_url |
+| `get_payment` | Retrieve a payment by ID |
+| `create_refund` | Full or partial refund of a payment |
+| `search_payments` | Search payments with filters (status, sort, pagination) |
+| `get_merchant_info` | Get merchant user profile |
+
+## Agent Usage
+
+```typescript
+import { createMercadoPagoTools } from "mercadopago-tool";
+
+const mp = createMercadoPagoTools(process.env.MERCADO_PAGO_ACCESS_TOKEN!);
+
+// Create a payment link
+const pref = await mp.tools.create_payment_preference({
+  title: "Premium Plan",
+  quantity: 1,
+  currency: "ARS",
+  unit_price: 5000,
+  back_urls: {
+    success: "https://myapp.com/success",
+    failure: "https://myapp.com/failure",
+  },
+  notification_url: "https://myapp.com/webhooks/mp",
+});
+// pref.init_point -> checkout URL to share with the buyer
+
+// Search approved payments
+const payments = await mp.tools.search_payments({ status: "approved", limit: 10 });
+
+// Refund a payment
+const refund = await mp.tools.create_refund({ payment_id: "123456789" });
+
+// Partial refund
+const partial = await mp.tools.create_refund({ payment_id: "123456789", amount: 500 });
+
+// Get payment details
+const payment = await mp.tools.get_payment({ payment_id: "123456789" });
+
+// List schemas for AI agent tool registration
+console.log(mp.schemas);
+```
+
+## Error Handling
+
+```typescript
+import { MercadoPagoError } from "mercadopago-tool";
+
+try {
+  await mp.tools.get_payment({ payment_id: "invalid" });
+} catch (err) {
+  if (err instanceof MercadoPagoError) {
+    console.log(err.status);        // 404
+    console.log(err.isNotFound);     // true
+    console.log(err.isUnauthorized); // false
+    console.log(err.isRateLimited);  // false
+  }
+}
+```
+
+## Integration Test
+
+Test against the real API:
+
+```bash
+MERCADO_PAGO_ACCESS_TOKEN=APP_USR-... npm run integration
+```
+
+## Curl Examples
+
+**Create preference:**
+
+```bash
+curl -X POST https://api.mercadopago.com/checkout/preferences \
+  -H "Authorization: Bearer $MERCADO_PAGO_ACCESS_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"items":[{"title":"Test","quantity":1,"currency_id":"ARS","unit_price":1000}],"back_urls":{"success":"https://myapp.com/ok"},"notification_url":"https://myapp.com/webhooks/mp"}'
+```
+
+**Get payment:**
+
+```bash
+curl https://api.mercadopago.com/v1/payments/123456789 \
+  -H "Authorization: Bearer $MERCADO_PAGO_ACCESS_TOKEN"
+```
+
+**Refund payment:**
+
+```bash
+curl -X POST https://api.mercadopago.com/v1/payments/123456789/refunds \
+  -H "Authorization: Bearer $MERCADO_PAGO_ACCESS_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{}'
+```
+
+**Search payments:**
+
+```bash
+curl "https://api.mercadopago.com/v1/payments/search?status=approved&limit=10" \
+  -H "Authorization: Bearer $MERCADO_PAGO_ACCESS_TOKEN"
+```
+
+**Merchant info:**
+
+```bash
+curl https://api.mercadopago.com/users/me \
+  -H "Authorization: Bearer $MERCADO_PAGO_ACCESS_TOKEN"
+```
+
+## WhatsApp Business Integration
+
+### Setup
+
+1. Create a Meta app at [Meta for Developers](https://developers.facebook.com/)
+2. Enable WhatsApp Business API
+3. Get your access token, phone number ID, and set a verify token
+
+```bash
+# Add to .env
+WHATSAPP_ACCESS_TOKEN=your-meta-graph-api-token
+WHATSAPP_PHONE_NUMBER_ID=your-phone-number-id
+WHATSAPP_VERIFY_TOKEN=your-webhook-verify-token
+```
+
+### Run the WhatsApp server
+
+```bash
+npm run whatsapp
+# Server starts on http://localhost:3000/webhook
+# Use ngrok to expose: ngrok http 3000
+```
+
+Then configure the webhook URL in Meta Dashboard: `https://your-ngrok-url/webhook`
+
+### Supported commands
+
+Users send plain text messages to your WhatsApp number:
+
+```
+cobrar 5000 curso python
+→ 💳 Link de pago generado
+  https://www.mercadopago.com/checkout/v1/redirect?pref_id=...
+
+pagos
+→ ✅ Aprobado
+  $5000
+  ID: 123456
+
+estado 123456
+→ Pago #123456
+  Estado: ✅ Aprobado
+  Monto: $5000
+
+devolver 123456
+→ Devolucion total realizada
+  Monto devuelto: $5000
+
+devolver 123456 2000
+→ Devolucion parcial realizada
+  Monto devuelto: $2000
+
+ayuda
+→ Lista de comandos
+```
+
+### Payment notifications
+
+When a payment is confirmed via the Mercado Pago webhook, you can forward it to WhatsApp:
+
+```typescript
+import { createWhatsAppWebhookHandler, WhatsAppClient, createPaymentNotifier, createWebhookHandler } from "mercadopago-tool";
+
+const wa = new WhatsAppClient({
+  accessToken: process.env.WHATSAPP_ACCESS_TOKEN!,
+  phoneNumberId: process.env.WHATSAPP_PHONE_NUMBER_ID!,
+});
+
+// Notify merchant on WhatsApp when payment is approved
+const notifier = createPaymentNotifier(wa, "5491155551234");
+
+const mpWebhook = createWebhookHandler({
+  accessToken: process.env.MERCADO_PAGO_ACCESS_TOKEN!,
+  onPayment: notifier,
+});
+```
+
+### Programmatic usage
+
+```typescript
+import { WhatsAppClient } from "mercadopago-tool";
+
+const wa = new WhatsAppClient({
+  accessToken: process.env.WHATSAPP_ACCESS_TOKEN!,
+  phoneNumberId: process.env.WHATSAPP_PHONE_NUMBER_ID!,
+});
+
+await wa.sendMessage("5491155551234", "Tu pago fue recibido!");
+```
+
+## Testing
+
+```bash
+npm test
+```
+
+## License
+
+MIT

package/bin/mcp-server.mjs

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/mcp-server.js";

package/bin/telegram-bot.mjs

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/telegram-bot.js";

package/dist/actions.d.ts

@@ -0,0 +1,7 @@
+import { MercadoPagoClient } from "./client.js";
+import type { CreatePaymentPreferenceParams, GetPaymentParams, CreateRefundParams, SearchPaymentsParams } from "./schemas.js";
+export declare function createPaymentPreference(client: MercadoPagoClient, params: CreatePaymentPreferenceParams): Promise<unknown>;
+export declare function getPayment(client: MercadoPagoClient, params: GetPaymentParams): Promise<unknown>;
+export declare function createRefund(client: MercadoPagoClient, params: CreateRefundParams): Promise<unknown>;
+export declare function searchPayments(client: MercadoPagoClient, params?: SearchPaymentsParams): Promise<unknown>;
+export declare function getMerchantInfo(client: MercadoPagoClient): Promise<unknown>;

package/dist/actions.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPaymentPreference = createPaymentPreference;
+exports.getPayment = getPayment;
+exports.createRefund = createRefund;
+exports.searchPayments = searchPayments;
+exports.getMerchantInfo = getMerchantInfo;
+async function createPaymentPreference(client, params) {
+    if (!params.title || typeof params.title !== "string") {
+        throw new Error("title is required and must be a string");
+    }
+    if (typeof params.quantity !== "number" || params.quantity < 1) {
+        throw new Error("quantity must be a positive number");
+    }
+    if (!params.currency || typeof params.currency !== "string") {
+        throw new Error("currency is required and must be a string");
+    }
+    if (typeof params.unit_price !== "number" || params.unit_price <= 0) {
+        throw new Error("unit_price must be a positive number");
+    }
+    const payload = {
+        items: [
+            {
+                title: params.title,
+                quantity: params.quantity,
+                currency_id: params.currency,
+                unit_price: params.unit_price,
+            },
+        ],
+    };
+    if (params.back_urls) {
+        payload.back_urls = params.back_urls;
+        payload.auto_return = "approved";
+    }
+    if (params.notification_url) {
+        payload.notification_url = params.notification_url;
+    }
+    return client.post("/checkout/preferences", payload);
+}
+async function getPayment(client, params) {
+    if (!params.payment_id || typeof params.payment_id !== "string") {
+        throw new Error("payment_id is required and must be a string");
+    }
+    return client.get(`/v1/payments/${encodeURIComponent(params.payment_id)}`);
+}
+async function createRefund(client, params) {
+    if (!params.payment_id || typeof params.payment_id !== "string") {
+        throw new Error("payment_id is required and must be a string");
+    }
+    if (params.amount !== undefined && (typeof params.amount !== "number" || params.amount <= 0)) {
+        throw new Error("amount must be a positive number when provided");
+    }
+    const body = params.amount !== undefined ? { amount: params.amount } : {};
+    return client.post(`/v1/payments/${encodeURIComponent(params.payment_id)}/refunds`, body);
+}
+async function searchPayments(client, params) {
+    const query = new URLSearchParams();
+    if (params?.status)
+        query.set("status", params.status);
+    if (params?.sort)
+        query.set("sort", params.sort);
+    if (params?.criteria)
+        query.set("criteria", params.criteria);
+    if (params?.limit)
+        query.set("limit", String(params.limit));
+    if (params?.offset)
+        query.set("offset", String(params.offset));
+    const qs = query.toString();
+    return client.get(`/v1/payments/search${qs ? `?${qs}` : ""}`);
+}
+async function getMerchantInfo(client) {
+    return client.get("/users/me");
+}
+//# sourceMappingURL=actions.js.map

package/dist/actions.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,10 @@
+export interface ClientOptions {
+    idempotencyKey?: string;
+}
+export declare class MercadoPagoClient {
+    private accessToken;
+    constructor(accessToken: string);
+    private headers;
+    get<T = unknown>(path: string): Promise<T>;
+    post<T = unknown>(path: string, body: unknown, opts?: ClientOptions): Promise<T>;
+}

package/dist/client.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MercadoPagoClient = void 0;
+const errors_js_1 = require("./errors.js");
+const BASE_URL = "https://api.mercadopago.com";
+class MercadoPagoClient {
+    accessToken;
+    constructor(accessToken) {
+        if (!accessToken) {
+            throw new Error("MERCADO_PAGO_ACCESS_TOKEN is required");
+        }
+        this.accessToken = accessToken;
+    }
+    headers(opts) {
+        const h = {
+            Authorization: `Bearer ${this.accessToken}`,
+            "Content-Type": "application/json",
+        };
+        if (opts?.idempotencyKey) {
+            h["X-Idempotency-Key"] = opts.idempotencyKey;
+        }
+        return h;
+    }
+    async get(path) {
+        const res = await fetch(`${BASE_URL}${path}`, {
+            method: "GET",
+            headers: this.headers(),
+        });
+        if (!res.ok) {
+            const body = await res.text();
+            throw new errors_js_1.MercadoPagoError("GET", path, res.status, body);
+        }
+        return res.json();
+    }
+    async post(path, body, opts) {
+        const res = await fetch(`${BASE_URL}${path}`, {
+            method: "POST",
+            headers: this.headers(opts),
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new errors_js_1.MercadoPagoError("POST", path, res.status, text);
+        }
+        return res.json();
+    }
+}
+exports.MercadoPagoClient = MercadoPagoClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;AAAA,2CAA+C;AAE/C,MAAM,QAAQ,GAAG,6BAA6B,CAAC;AAM/C,MAAa,iBAAiB;IACpB,WAAW,CAAS;IAE5B,YAAY,WAAmB;QAC7B,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAEO,OAAO,CAAC,IAAoB;QAClC,MAAM,CAAC,GAA2B;YAChC,aAAa,EAAE,UAAU,IAAI,CAAC,WAAW,EAAE;YAC3C,cAAc,EAAE,kBAAkB;SACnC,CAAC;QACF,IAAI,IAAI,EAAE,cAAc,EAAE,CAAC;YACzB,CAAC,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC;QAC/C,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,KAAK,CAAC,GAAG,CAAc,IAAY;QACjC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,GAAG,IAAI,EAAE,EAAE;YAC5C,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;SACxB,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,IAAI,4BAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,IAAI,CAAc,IAAY,EAAE,IAAa,EAAE,IAAoB;QACvE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,GAAG,IAAI,EAAE,EAAE;YAC5C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YAC3B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,IAAI,4BAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAC;IAClC,CAAC;CACF;AA7CD,8CA6CC"}

package/dist/errors.d.ts

@@ -0,0 +1,10 @@
+export declare class MercadoPagoError extends Error {
+    readonly status: number;
+    readonly method: string;
+    readonly path: string;
+    readonly body: string;
+    constructor(method: string, path: string, status: number, body: string);
+    get isUnauthorized(): boolean;
+    get isNotFound(): boolean;
+    get isRateLimited(): boolean;
+}

package/dist/errors.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MercadoPagoError = void 0;
+class MercadoPagoError extends Error {
+    status;
+    method;
+    path;
+    body;
+    constructor(method, path, status, body) {
+        super(`${method} ${path} failed (${status}): ${body}`);
+        this.name = "MercadoPagoError";
+        this.method = method;
+        this.path = path;
+        this.status = status;
+        this.body = body;
+    }
+    get isUnauthorized() {
+        return this.status === 401;
+    }
+    get isNotFound() {
+        return this.status === 404;
+    }
+    get isRateLimited() {
+        return this.status === 429;
+    }
+}
+exports.MercadoPagoError = MercadoPagoError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,gBAAiB,SAAQ,KAAK;IAChC,MAAM,CAAS;IACf,MAAM,CAAS;IACf,IAAI,CAAS;IACb,IAAI,CAAS;IAEtB,YAAY,MAAc,EAAE,IAAY,EAAE,MAAc,EAAE,IAAY;QACpE,KAAK,CAAC,GAAG,MAAM,IAAI,IAAI,YAAY,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC;IAC7B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC;IAC7B,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC;IAC7B,CAAC;CACF;AA1BD,4CA0BC"}

package/dist/index.d.ts

@@ -0,0 +1,133 @@
+import type { CreatePaymentPreferenceParams, GetPaymentParams, CreateRefundParams, SearchPaymentsParams } from "./schemas.js";
+export declare function createMercadoPagoTools(accessToken: string): {
+    schemas: ({
+        readonly name: "create_payment_preference";
+        readonly description: "Creates a Mercado Pago checkout payment preference (payment link). Returns init_point URL for redirecting buyers.";
+        readonly parameters: {
+            readonly type: "object";
+            readonly required: readonly ["title", "quantity", "currency", "unit_price"];
+            readonly properties: {
+                readonly title: {
+                    readonly type: "string";
+                    readonly description: "Product or service title";
+                };
+                readonly quantity: {
+                    readonly type: "number";
+                    readonly description: "Quantity of items";
+                };
+                readonly currency: {
+                    readonly type: "string";
+                    readonly description: "Currency ID (e.g. ARS, BRL, MXN, CLP, COP, UYU, PEN)";
+                };
+                readonly unit_price: {
+                    readonly type: "number";
+                    readonly description: "Unit price of the item";
+                };
+                readonly back_urls: {
+                    readonly type: "object";
+                    readonly description: "URLs to redirect the buyer after payment";
+                    readonly properties: {
+                        readonly success: {
+                            readonly type: "string";
+                            readonly description: "URL on approved payment";
+                        };
+                        readonly failure: {
+                            readonly type: "string";
+                            readonly description: "URL on rejected payment";
+                        };
+                        readonly pending: {
+                            readonly type: "string";
+                            readonly description: "URL on pending payment";
+                        };
+                    };
+                };
+                readonly notification_url: {
+                    readonly type: "string";
+                    readonly description: "Webhook URL for payment notifications (IPN)";
+                };
+            };
+        };
+    } | {
+        readonly name: "get_payment";
+        readonly description: "Retrieve a payment by its ID. Returns full payment details including status, amount, payer info.";
+        readonly parameters: {
+            readonly type: "object";
+            readonly required: readonly ["payment_id"];
+            readonly properties: {
+                readonly payment_id: {
+                    readonly type: "string";
+                    readonly description: "The payment ID to look up";
+                };
+            };
+        };
+    } | {
+        readonly name: "create_refund";
+        readonly description: "Refund a payment fully or partially. Omit amount for full refund.";
+        readonly parameters: {
+            readonly type: "object";
+            readonly required: readonly ["payment_id"];
+            readonly properties: {
+                readonly payment_id: {
+                    readonly type: "string";
+                    readonly description: "The payment ID to refund";
+                };
+                readonly amount: {
+                    readonly type: "number";
+                    readonly description: "Partial refund amount. Omit for full refund.";
+                };
+            };
+        };
+    } | {
+        readonly name: "search_payments";
+        readonly description: "Search recent payments for the authenticated merchant. Supports filtering by status.";
+        readonly parameters: {
+            readonly type: "object";
+            readonly properties: {
+                readonly status: {
+                    readonly type: "string";
+                    readonly description: "Filter by status: approved, pending, rejected, refunded, cancelled";
+                };
+                readonly sort: {
+                    readonly type: "string";
+                    readonly description: "Sort field (e.g. date_created)";
+                };
+                readonly criteria: {
+                    readonly type: "string";
+                    readonly description: "Sort order: asc or desc";
+                };
+                readonly limit: {
+                    readonly type: "number";
+                    readonly description: "Max results (default 30, max 100)";
+                };
+                readonly offset: {
+                    readonly type: "number";
+                    readonly description: "Pagination offset";
+                };
+            };
+        };
+    } | {
+        readonly name: "get_merchant_info";
+        readonly description: "Retrieve the authenticated merchant's user profile including ID, nickname, and site.";
+        readonly parameters: {
+            readonly type: "object";
+            readonly properties: {};
+        };
+    })[];
+    tools: {
+        create_payment_preference: (params: CreatePaymentPreferenceParams) => Promise<unknown>;
+        get_payment: (params: GetPaymentParams) => Promise<unknown>;
+        create_refund: (params: CreateRefundParams) => Promise<unknown>;
+        search_payments: (params?: SearchPaymentsParams) => Promise<unknown>;
+        get_merchant_info: () => Promise<unknown>;
+    };
+};
+export { MercadoPagoClient } from "./client.js";
+export type { ClientOptions } from "./client.js";
+export { MercadoPagoError } from "./errors.js";
+export { createPaymentPreference, getPayment, createRefund, searchPayments, getMerchantInfo, } from "./actions.js";
+export { allSchemas } from "./schemas.js";
+export type { CreatePaymentPreferenceParams, GetPaymentParams, CreateRefundParams, SearchPaymentsParams, BackUrls, } from "./schemas.js";
+export { createWebhookHandler } from "./webhook.js";
+export type { WebhookConfig } from "./webhook.js";
+export { createWhatsAppWebhookHandler, WhatsAppClient, createCommandHandlers, createPaymentNotifier, parseMessage, extractMessages } from "./whatsapp/webhook.js";
+export type { WhatsAppWebhookConfig, WhatsAppClientConfig, HandlersConfig, ParsedCommand, IncomingWhatsAppMessage, CommandName } from "./whatsapp/webhook.js";

package/dist/index.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractMessages = exports.parseMessage = exports.createPaymentNotifier = exports.createCommandHandlers = exports.WhatsAppClient = exports.createWhatsAppWebhookHandler = exports.createWebhookHandler = exports.allSchemas = exports.getMerchantInfo = exports.searchPayments = exports.createRefund = exports.getPayment = exports.createPaymentPreference = exports.MercadoPagoError = exports.MercadoPagoClient = void 0;
+exports.createMercadoPagoTools = createMercadoPagoTools;
+const client_js_1 = require("./client.js");
+const actions_js_1 = require("./actions.js");
+const schemas_js_1 = require("./schemas.js");
+function createMercadoPagoTools(accessToken) {
+    const client = new client_js_1.MercadoPagoClient(accessToken);
+    return {
+        schemas: schemas_js_1.allSchemas,
+        tools: {
+            create_payment_preference: (params) => (0, actions_js_1.createPaymentPreference)(client, params),
+            get_payment: (params) => (0, actions_js_1.getPayment)(client, params),
+            create_refund: (params) => (0, actions_js_1.createRefund)(client, params),
+            search_payments: (params) => (0, actions_js_1.searchPayments)(client, params),
+            get_merchant_info: () => (0, actions_js_1.getMerchantInfo)(client),
+        },
+    };
+}
+var client_js_2 = require("./client.js");
+Object.defineProperty(exports, "MercadoPagoClient", { enumerable: true, get: function () { return client_js_2.MercadoPagoClient; } });
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "MercadoPagoError", { enumerable: true, get: function () { return errors_js_1.MercadoPagoError; } });
+var actions_js_2 = require("./actions.js");
+Object.defineProperty(exports, "createPaymentPreference", { enumerable: true, get: function () { return actions_js_2.createPaymentPreference; } });
+Object.defineProperty(exports, "getPayment", { enumerable: true, get: function () { return actions_js_2.getPayment; } });
+Object.defineProperty(exports, "createRefund", { enumerable: true, get: function () { return actions_js_2.createRefund; } });
+Object.defineProperty(exports, "searchPayments", { enumerable: true, get: function () { return actions_js_2.searchPayments; } });
+Object.defineProperty(exports, "getMerchantInfo", { enumerable: true, get: function () { return actions_js_2.getMerchantInfo; } });
+var schemas_js_2 = require("./schemas.js");
+Object.defineProperty(exports, "allSchemas", { enumerable: true, get: function () { return schemas_js_2.allSchemas; } });
+var webhook_js_1 = require("./webhook.js");
+Object.defineProperty(exports, "createWebhookHandler", { enumerable: true, get: function () { return webhook_js_1.createWebhookHandler; } });
+var webhook_js_2 = require("./whatsapp/webhook.js");
+Object.defineProperty(exports, "createWhatsAppWebhookHandler", { enumerable: true, get: function () { return webhook_js_2.createWhatsAppWebhookHandler; } });
+Object.defineProperty(exports, "WhatsAppClient", { enumerable: true, get: function () { return webhook_js_2.WhatsAppClient; } });
+Object.defineProperty(exports, "createCommandHandlers", { enumerable: true, get: function () { return webhook_js_2.createCommandHandlers; } });
+Object.defineProperty(exports, "createPaymentNotifier", { enumerable: true, get: function () { return webhook_js_2.createPaymentNotifier; } });
+Object.defineProperty(exports, "parseMessage", { enumerable: true, get: function () { return webhook_js_2.parseMessage; } });
+Object.defineProperty(exports, "extractMessages", { enumerable: true, get: function () { return webhook_js_2.extractMessages; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAgBA,wDAuBC;AAvCD,2CAAgD;AAChD,6CAMsB;AACtB,6CAA0C;AAQ1C,SAAgB,sBAAsB,CAAC,WAAmB;IACxD,MAAM,MAAM,GAAG,IAAI,6BAAiB,CAAC,WAAW,CAAC,CAAC;IAElD,OAAO;QACL,OAAO,EAAE,uBAAU;QAEnB,KAAK,EAAE;YACL,yBAAyB,EAAE,CAAC,MAAqC,EAAE,EAAE,CACnE,IAAA,oCAAuB,EAAC,MAAM,EAAE,MAAM,CAAC;YAEzC,WAAW,EAAE,CAAC,MAAwB,EAAE,EAAE,CACxC,IAAA,uBAAU,EAAC,MAAM,EAAE,MAAM,CAAC;YAE5B,aAAa,EAAE,CAAC,MAA0B,EAAE,EAAE,CAC5C,IAAA,yBAAY,EAAC,MAAM,EAAE,MAAM,CAAC;YAE9B,eAAe,EAAE,CAAC,MAA6B,EAAE,EAAE,CACjD,IAAA,2BAAc,EAAC,MAAM,EAAE,MAAM,CAAC;YAEhC,iBAAiB,EAAE,GAAG,EAAE,CACtB,IAAA,4BAAe,EAAC,MAAM,CAAC;SAC1B;KACF,CAAC;AACJ,CAAC;AAED,yCAAgD;AAAvC,8GAAA,iBAAiB,OAAA;AAE1B,yCAA+C;AAAtC,6GAAA,gBAAgB,OAAA;AACzB,2CAMsB;AALpB,qHAAA,uBAAuB,OAAA;AACvB,wGAAA,UAAU,OAAA;AACV,0GAAA,YAAY,OAAA;AACZ,4GAAA,cAAc,OAAA;AACd,6GAAA,eAAe,OAAA;AAEjB,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AAQnB,2CAAoD;AAA3C,kHAAA,oBAAoB,OAAA;AAE7B,oDAAkK;AAAzJ,0HAAA,4BAA4B,OAAA;AAAE,4GAAA,cAAc,OAAA;AAAE,mHAAA,qBAAqB,OAAA;AAAE,mHAAA,qBAAqB,OAAA;AAAE,0GAAA,YAAY,OAAA;AAAE,6GAAA,eAAe,OAAA"}