@ar-agents/mercadopago 0.15.3 → 0.17.0

package/cookbook/12-reconciliation-pipeline.ts

@@ -0,0 +1,277 @@
+/**
+ * Recipe 12 — Reconciliation pipeline.
+ *
+ * Daily batch job that compares MP's settlement records against your internal
+ * billing DB and surfaces discrepancies. This is what every finance team
+ * eventually asks the dev team to build, and there's no good off-the-shelf
+ * tool for AR.
+ *
+ * # The four discrepancy classes
+ *
+ *   1. **In MP, not in our DB**: an MP payment exists with no matching
+ *      internal invoice. Usually means a webhook was missed.
+ *      → Action: backfill from MP into our DB.
+ *
+ *   2. **In our DB, not in MP**: we have an invoice marked paid, but no
+ *      matching MP payment. Usually means we marked something paid
+ *      manually or had a bug.
+ *      → Action: flag for human review.
+ *
+ *   3. **Amount mismatch**: amounts differ between MP and our DB. Could be
+ *      partial refund, dispute, currency conversion.
+ *      → Action: classify (refund? dispute?) and update DB.
+ *
+ *   4. **Fee mismatch**: MP's reported `marketplace_fee` differs from what
+ *      we calculated. Means our pricing logic is out of sync with the
+ *      actual MP-side `application_fee`.
+ *      → Action: recompute and surface for billing audit.
+ *
+ * # What this recipe shows
+ *
+ *   - Pagination via `paginatePayments` AsyncIterable (Edge-Runtime safe).
+ *   - Settlement-level reconciliation via `paginateSettlements`.
+ *   - Composition with the marketplace fee calculator (`computeMarketplaceFee`).
+ *   - A human-readable "discrepancy report" the agent can email the finance
+ *     team via @ar-agents/whatsapp or Resend.
+ */
+
+import {
+  MercadoPagoClient,
+  paginatePayments,
+  paginateSettlements,
+  computeMarketplaceFee,
+  type Payment,
+  type Settlement,
+} from "@ar-agents/mercadopago";
+
+const mp = new MercadoPagoClient({
+  accessToken: process.env.MP_ACCESS_TOKEN!,
+});
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Types — what your internal DB looks like (replace with your schema)
+// ─────────────────────────────────────────────────────────────────────────────
+
+type InternalInvoice = {
+  externalReference: string; // matches MP's external_reference
+  amount: number; // in ARS
+  status: "pending" | "paid" | "refunded";
+  mpPaymentId?: string;
+  expectedFee?: number; // what we expect MP to charge us
+};
+
+type Discrepancy =
+  | { type: "missing_in_db"; mpPayment: Payment }
+  | { type: "missing_in_mp"; invoice: InternalInvoice }
+  | { type: "amount_mismatch"; mpPayment: Payment; invoice: InternalInvoice }
+  | { type: "fee_mismatch"; mpPayment: Payment; expectedFee: number };
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Reconciliation entry point
+// ─────────────────────────────────────────────────────────────────────────────
+
+export async function reconcileDay(args: {
+  date: Date;
+  fetchInternalInvoices: (
+    rangeStart: Date,
+    rangeEnd: Date,
+  ) => Promise<InternalInvoice[]>;
+  marketplaceFeePct?: number; // e.g. 5 for a 5% platform fee
+}): Promise<{
+  matched: number;
+  discrepancies: Discrepancy[];
+  totals: { mpGross: number; mpNet: number; mpFees: number };
+}> {
+  const dayStart = new Date(args.date);
+  dayStart.setHours(0, 0, 0, 0);
+  const dayEnd = new Date(dayStart.getTime() + 24 * 60 * 60 * 1000);
+
+  // 1. Pull all approved payments from MP for the day. paginatePayments is
+  //    an AsyncIterable<Payment> wrapped over MP's search endpoint, with
+  //    bounded memory regardless of window size.
+  const mpPayments: Payment[] = [];
+  for await (const p of paginatePayments(mp, {
+    status: "approved",
+    beginDate: dayStart.toISOString(),
+    endDate: dayEnd.toISOString(),
+  })) {
+    mpPayments.push(p);
+  }
+
+  // 2. Pull internal invoices for the same window.
+  const invoices = await args.fetchInternalInvoices(dayStart, dayEnd);
+
+  // 3. Index by external_reference.
+  const byRef = new Map<string, InternalInvoice>();
+  for (const inv of invoices) byRef.set(inv.externalReference, inv);
+
+  const discrepancies: Discrepancy[] = [];
+  let matched = 0;
+
+  // 4. Walk MP payments, match against internal.
+  for (const p of mpPayments) {
+    const ref = p.external_reference;
+    if (!ref) continue; // payments without external_reference can't be matched
+    const inv = byRef.get(ref);
+
+    if (!inv) {
+      discrepancies.push({ type: "missing_in_db", mpPayment: p });
+      continue;
+    }
+
+    // Check 4a: amount.
+    if (Math.abs(p.transaction_amount - inv.amount) > 0.01) {
+      discrepancies.push({
+        type: "amount_mismatch",
+        mpPayment: p,
+        invoice: inv,
+      });
+      continue;
+    }
+
+    // Check 4b: fee, if marketplace.
+    const actualFee = (p as Payment & { marketplace_fee?: number }).marketplace_fee;
+    if (args.marketplaceFeePct != null && actualFee != null) {
+      const expected = computeMarketplaceFee(p.transaction_amount, {
+        percent: args.marketplaceFeePct,
+      });
+      if (Math.abs(actualFee - expected) > 0.01) {
+        discrepancies.push({
+          type: "fee_mismatch",
+          mpPayment: p,
+          expectedFee: expected,
+        });
+        continue;
+      }
+    }
+
+    matched += 1;
+    byRef.delete(ref); // remove so we can detect leftover (4c) below
+  }
+
+  // 4c: any invoice left in byRef has no matching MP payment.
+  for (const inv of byRef.values()) {
+    if (inv.status !== "paid") continue; // unpaid invoices wouldn't have an MP payment yet
+    discrepancies.push({ type: "missing_in_mp", invoice: inv });
+  }
+
+  // 5. Aggregate totals from MP-side settlements (the truth source for
+  //    what was actually credited to your account today). The Settlement
+  //    schema only exposes `amount` (the credited net total per settlement);
+  //    gross/fee breakdowns live on individual payments. We sum payments
+  //    above for gross + fees, and settlements here for the credited-net
+  //    cross-check.
+  let mpGross = 0;
+  let mpFees = 0;
+  for (const p of mpPayments) {
+    mpGross += p.transaction_amount ?? 0;
+    const fee = (p as Payment & { marketplace_fee?: number }).marketplace_fee;
+    if (fee) mpFees += fee;
+  }
+  let mpNet = 0;
+  for await (const s of paginateSettlements(mp, {
+    date_from: dayStart.toISOString(),
+    date_to: dayEnd.toISOString(),
+  } as Parameters<typeof paginateSettlements>[1])) {
+    mpNet += (s as Settlement).amount ?? 0;
+  }
+
+  return {
+    matched,
+    discrepancies,
+    totals: { mpGross, mpNet, mpFees },
+  };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Discrepancy report formatter
+// ─────────────────────────────────────────────────────────────────────────────
+
+export function formatDiscrepancyReport(input: {
+  date: Date;
+  matched: number;
+  discrepancies: Discrepancy[];
+  totals: { mpGross: number; mpNet: number; mpFees: number };
+}): string {
+  const lines: string[] = [];
+  lines.push(`# Reconciliation report — ${input.date.toISOString().slice(0, 10)}`);
+  lines.push("");
+  lines.push(`**Matched payments:** ${input.matched}`);
+  lines.push(`**Discrepancies:** ${input.discrepancies.length}`);
+  lines.push("");
+  lines.push(`**MP totals:**`);
+  lines.push(`  - Gross: $${input.totals.mpGross.toLocaleString("es-AR")}`);
+  lines.push(`  - Fees:  $${input.totals.mpFees.toLocaleString("es-AR")}`);
+  lines.push(`  - Net:   $${input.totals.mpNet.toLocaleString("es-AR")}`);
+  lines.push("");
+
+  if (input.discrepancies.length === 0) {
+    lines.push("✓ All clean.");
+    return lines.join("\n");
+  }
+
+  lines.push("## Discrepancies");
+  lines.push("");
+  for (const d of input.discrepancies) {
+    switch (d.type) {
+      case "missing_in_db":
+        lines.push(
+          `- **Missing in DB**: MP payment ${d.mpPayment.id} (ref=${d.mpPayment.external_reference}, $${d.mpPayment.transaction_amount}). Action: backfill.`,
+        );
+        break;
+      case "missing_in_mp":
+        lines.push(
+          `- **Missing in MP**: internal invoice ${d.invoice.externalReference} marked paid but no MP record. Action: human review.`,
+        );
+        break;
+      case "amount_mismatch":
+        lines.push(
+          `- **Amount mismatch**: ref=${d.invoice.externalReference}: DB says $${d.invoice.amount}, MP says $${d.mpPayment.transaction_amount}. Action: classify (partial refund? dispute?).`,
+        );
+        break;
+      case "fee_mismatch":
+        lines.push(
+          `- **Fee mismatch**: payment ${d.mpPayment.id}: expected $${d.expectedFee}, MP charged $${d.mpPayment.marketplace_fee}. Action: audit pricing logic.`,
+        );
+        break;
+    }
+  }
+
+  return lines.join("\n");
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Cron entry point
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Add to vercel.json:
+ *
+ *   {
+ *     "crons": [
+ *       { "path": "/api/cron/reconcile", "schedule": "0 6 * * *" }
+ *     ]
+ *   }
+ *
+ * Runs at 06:00 every day, reconciles the previous day.
+ */
+export async function GET() {
+  const yesterday = new Date(Date.now() - 24 * 60 * 60 * 1000);
+  const result = await reconcileDay({
+    date: yesterday,
+    fetchInternalInvoices: async (start, end) => {
+      // Replace with your DB query.
+      return [];
+    },
+    marketplaceFeePct: 0.05,
+  });
+
+  const report = formatDiscrepancyReport({ date: yesterday, ...result });
+  // Send via Resend, Slack, Email, or your channel of choice.
+  console.log(report);
+
+  return new Response(report, {
+    status: 200,
+    headers: { "content-type": "text/plain" },
+  });
+}

package/cookbook/README.md

@@ -17,6 +17,9 @@ deploy on Vercel as-is.
 | 07  | `07-auth-only-order.ts`           | `Order` with manual capture → capture later when service completes      |
 | 08  | `08-recovery-patterns.ts`         | Retry expired subscriptions, recover stuck-pending payments, etc.       |
 | 09  | `09-otel-wired.ts`                | Full OpenTelemetry wiring — spans + metrics for every MP call + tool    |
+| 10  | `10-cross-package-billing.ts`     | One agent loop, 5 packages: identity + attest + MP + facturacion + WhatsApp |
+| 11  | `11-dunning-sequence.ts`          | Failed-payment recovery loop with multi-step dunning + cancel-with-retention |
+| 12  | `12-reconciliation-pipeline.ts`   | Daily MP↔internal-DB reconciliation cron with discrepancy report        |
 
 ## Conventions
 

package/dist/cli.cjs

@@ -0,0 +1,341 @@
+'use strict';
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+// src/cli-doctor.ts
+var C = {
+  reset: "\x1B[0m",
+  dim: "\x1B[2m",
+  red: "\x1B[31m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m",
+  magenta: "\x1B[35m",
+  cyan: "\x1B[36m",
+  bold: "\x1B[1m"
+};
+var NO_COLOR = process.env.NO_COLOR != null || !process.stdout.isTTY;
+var c = (color, s) => NO_COLOR ? s : `${C[color]}${s}${C.reset}`;
+function fmt(r) {
+  const icon = r.kind === "ok" ? c("green", "\u2713") : r.kind === "warn" ? c("yellow", "\u26A0") : c("red", "\u2717");
+  const detail = r.detail ? `
+  ${c("dim", "\u2192 " + r.detail)}` : "";
+  return `${icon} ${r.line}${detail}`;
+}
+function checkNode() {
+  const major = Number(process.versions.node.split(".")[0]);
+  if (major >= 20) {
+    return {
+      kind: "ok",
+      line: `Node ${process.versions.node} (>= 20.0.0)`
+    };
+  }
+  return {
+    kind: "fail",
+    line: `Node ${process.versions.node} too old`,
+    detail: `@ar-agents/mercadopago requires Node 20+. Bun and Edge Runtime are also supported.`
+  };
+}
+function checkAccessToken() {
+  const t = process.env.MP_ACCESS_TOKEN?.trim();
+  if (!t) {
+    return {
+      kind: "fail",
+      line: "MP_ACCESS_TOKEN not set",
+      detail: "Get one at https://www.mercadopago.com.ar/developers/panel/app \u2014 TEST- prefix for sandbox, APP_USR- for production."
+    };
+  }
+  if (t.startsWith("TEST-")) {
+    return { kind: "ok", line: `MP_ACCESS_TOKEN set (TEST- prefix \u2192 sandbox)` };
+  }
+  if (t.startsWith("APP_USR-")) {
+    return {
+      kind: "warn",
+      line: `MP_ACCESS_TOKEN set (APP_USR- prefix \u2192 PRODUCTION)`,
+      detail: "Live transactions WILL move real money. Use TEST- in development."
+    };
+  }
+  return {
+    kind: "fail",
+    line: "MP_ACCESS_TOKEN has unexpected prefix",
+    detail: `Expected TEST- or APP_USR-, got "${t.slice(0, 8)}\u2026". Common cause: trailing newline in env file (use printf, not echo).`
+  };
+}
+async function probeToken(token) {
+  try {
+    const res = await fetch("https://api.mercadopago.com/users/me", {
+      headers: { Authorization: `Bearer ${token}` }
+    });
+    if (res.status === 401) {
+      return {
+        kind: "fail",
+        line: "Token rejected by MP API (401 Unauthorized)",
+        detail: "Token is invalid, expired, or copy-pasted with extra whitespace."
+      };
+    }
+    if (!res.ok) {
+      return {
+        kind: "fail",
+        line: `MP API responded with HTTP ${res.status}`,
+        detail: `Unexpected status \u2014 try again or check api.mercadopago.com status.`
+      };
+    }
+    const me = await res.json();
+    return {
+      kind: "ok",
+      line: `Authenticated against api.mercadopago.com`,
+      detail: `account ${me.id ?? "?"} \xB7 site ${me.site_id ?? "?"} \xB7 country ${me.country_id ?? "?"}`
+    };
+  } catch (err) {
+    return {
+      kind: "fail",
+      line: "Could not reach api.mercadopago.com",
+      detail: err instanceof Error ? err.message : "Unknown network error. Check connectivity / proxy."
+    };
+  }
+}
+async function checkPeerDep(name, required) {
+  try {
+    await import(name);
+    return { kind: "ok", line: `${name} installed` };
+  } catch {
+    return {
+      kind: required ? "fail" : "warn",
+      line: `${name} not installed`,
+      detail: required ? `Required peer dep \u2014 install with: pnpm add ${name}` : `Optional \u2014 required only if you use the matching subpath.`
+    };
+  }
+}
+function checkBackUrl() {
+  const url = process.env.NEXT_PUBLIC_BACK_URL ?? process.env.BACK_URL;
+  if (!url) {
+    return {
+      kind: "warn",
+      line: "NEXT_PUBLIC_BACK_URL not set",
+      detail: "Required by mercadoPagoTools({ backUrl }) for create_subscription / create_payment_preference. Must be HTTPS (localhost rejected by MP in production)."
+    };
+  }
+  if (!url.startsWith("https://")) {
+    return {
+      kind: "fail",
+      line: `NEXT_PUBLIC_BACK_URL must be HTTPS (got: ${url.slice(0, 40)}\u2026)`,
+      detail: "MP rejects localhost and http:// URLs server-side."
+    };
+  }
+  return { kind: "ok", line: `NEXT_PUBLIC_BACK_URL set (${url})` };
+}
+function checkWebhookSecret() {
+  const s = process.env.MP_WEBHOOK_SECRET?.trim();
+  if (!s) {
+    return {
+      kind: "warn",
+      line: "MP_WEBHOOK_SECRET not set",
+      detail: "verifyWebhookSignature() needs this. Copy from https://www.mercadopago.com.ar/developers/panel/app \u2192 notificaciones."
+    };
+  }
+  if (s.length < 16) {
+    return {
+      kind: "warn",
+      line: `MP_WEBHOOK_SECRET set but suspiciously short (${s.length} chars)`,
+      detail: "MP secrets are typically 32+ chars. Double-check the paste."
+    };
+  }
+  return { kind: "ok", line: `MP_WEBHOOK_SECRET set (${s.length} chars)` };
+}
+async function loadManifest() {
+  const fs = await import('fs/promises');
+  for (const rel of ["../tools.manifest.json", "../../tools.manifest.json"]) {
+    try {
+      const url = new URL(rel, (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli.cjs', document.baseURI).href)));
+      const text = await fs.readFile(url, "utf-8");
+      return JSON.parse(text);
+    } catch {
+    }
+  }
+  return null;
+}
+function summarizeManifest(m) {
+  const lines = [];
+  lines.push(c("bold", `Tools registered: ${m.tools.length}`));
+  const groups = /* @__PURE__ */ new Map();
+  for (const tool of m.tools) {
+    const cat = tool.category ?? inferCategory(tool.name);
+    if (!groups.has(cat)) groups.set(cat, []);
+    groups.get(cat).push(tool.name);
+  }
+  for (const [cat, names] of [...groups.entries()].sort()) {
+    lines.push(`  ${c("dim", "\u2192")} ${cat} (${names.length})`);
+  }
+  return lines;
+}
+function inferCategory(toolName) {
+  if (toolName.includes("subscription") || toolName.includes("preapproval")) return "Subscriptions";
+  if (toolName.includes("payment") && !toolName.includes("preference")) return "Payments";
+  if (toolName.includes("refund")) return "Refunds";
+  if (toolName.includes("preference") || toolName.includes("checkout")) return "Checkout Pro";
+  if (toolName.includes("oauth") || toolName.includes("marketplace")) return "Marketplace OAuth";
+  if (toolName.includes("merchant_order") || toolName.includes("order")) return "Order Management";
+  if (toolName.includes("customer") && !toolName.includes("card")) return "Customers";
+  if (toolName.includes("customer_card") || toolName.includes("card")) return "Saved cards";
+  if (toolName.includes("installment") || toolName.includes("cuotas") || toolName.includes("promo")) return "Cuotas";
+  if (toolName.includes("qr")) return "QR";
+  if (toolName.includes("3ds") || toolName.includes("challenge")) return "3DS";
+  if (toolName.includes("point")) return "Point devices";
+  if (toolName.includes("store") || toolName.includes("pos")) return "Stores+POS";
+  if (toolName.includes("balance") || toolName.includes("settlement") || toolName.includes("account")) return "Account/Balance";
+  if (toolName.includes("dispute")) return "Disputes";
+  if (toolName.includes("webhook")) return "Webhooks";
+  if (toolName.includes("bank_account")) return "Bank Accounts";
+  if (toolName.includes("lookup") || toolName.includes("validate") || toolName.includes("explain") || toolName.includes("compute")) return "Lookups";
+  return "Other";
+}
+var HITL_TOOLS = [
+  "refund_payment",
+  "cancel_subscription",
+  "pause_subscription",
+  "cancel_payment_preference",
+  "delete_customer_card",
+  "cancel_qr_dynamic",
+  "delete_pos",
+  "revoke_marketplace_token"
+];
+async function runDoctor(args = { probe: false }) {
+  const lines = [];
+  lines.push("");
+  lines.push(c("bold", `${c("cyan", "@ar-agents/mercadopago")} doctor`));
+  lines.push(c("dim", "  diagnosing your environment"));
+  lines.push("");
+  lines.push(fmt(checkNode()));
+  const tokenCheck = checkAccessToken();
+  lines.push(fmt(tokenCheck));
+  if (tokenCheck.kind === "ok" || tokenCheck.kind === "warn") {
+    const probe = await probeToken(process.env.MP_ACCESS_TOKEN.trim());
+    lines.push(fmt(probe));
+  }
+  lines.push(fmt(checkBackUrl()));
+  lines.push(fmt(checkWebhookSecret()));
+  lines.push(fmt(await checkPeerDep("ai", true)));
+  lines.push(fmt(await checkPeerDep("zod", true)));
+  lines.push(fmt(await checkPeerDep("@vercel/kv", false)));
+  lines.push(fmt(await checkPeerDep("@opentelemetry/api", false)));
+  lines.push("");
+  const manifest = await loadManifest();
+  if (manifest) {
+    lines.push(...summarizeManifest(manifest));
+    lines.push("");
+    lines.push(
+      c(
+        "yellow",
+        `${HITL_TOOLS.length} irreversible ops behind requireConfirmation():`
+      )
+    );
+    lines.push("  " + c("dim", HITL_TOOLS.join(" \xB7 ")));
+  } else {
+    lines.push(
+      fmt({
+        kind: "warn",
+        line: "Could not load tools.manifest.json",
+        detail: "The package shipping is incomplete \u2014 reinstall."
+      })
+    );
+  }
+  lines.push("");
+  if (args.probe && tokenCheck.kind === "ok") {
+    lines.push(c("bold", "Probe mode: dry-calling validate_tax_id\u2026"));
+    try {
+      const res = await fetch("https://api.mercadopago.com/v1/identification_types", {
+        headers: { Authorization: `Bearer ${process.env.MP_ACCESS_TOKEN.trim()}` }
+      });
+      if (res.ok) {
+        const types = await res.json();
+        lines.push(
+          fmt({
+            kind: "ok",
+            line: `validate_tax_id reachable \u2014 ${types.length} ID types available`
+          })
+        );
+      } else {
+        lines.push(
+          fmt({
+            kind: "warn",
+            line: `validate_tax_id probe returned HTTP ${res.status}`
+          })
+        );
+      }
+    } catch (err) {
+      lines.push(
+        fmt({
+          kind: "warn",
+          line: "Probe failed",
+          detail: err instanceof Error ? err.message : String(err)
+        })
+      );
+    }
+    lines.push("");
+  }
+  lines.push(
+    c(
+      "dim",
+      args.probe ? "All probes done. Pass without --probe for the lighter check." : "Run with --probe to also dry-call validate_tax_id (no charge)."
+    )
+  );
+  process.stdout.write(lines.join("\n") + "\n");
+  const hasFail = lines.some((l) => l.includes("\u2717"));
+  return hasFail ? 1 : 0;
+}
+
+// src/cli.ts
+var HELP = `@ar-agents/mercadopago CLI
+
+Commands:
+  doctor               Diagnose your environment (Node, token, peer deps, tools)
+  doctor --probe       Same as doctor but also dry-calls validate_tax_id
+  help                 Print this message
+  version              Print the installed package version
+
+Environment:
+  MP_ACCESS_TOKEN      Required for any live calls. TEST- for sandbox, APP_USR- for prod.
+  NEXT_PUBLIC_BACK_URL Required HTTPS URL for create_subscription / create_payment_preference.
+  MP_WEBHOOK_SECRET    Required for verifyWebhookSignature.
+
+Docs: https://github.com/ar-agents/ar-agents/tree/main/packages/mercadopago
+`;
+async function readVersion() {
+  for (const rel of ["../package.json", "../../package.json"]) {
+    try {
+      const url = new URL(rel, (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli.cjs', document.baseURI).href)));
+      const fs = await import('fs/promises');
+      const text = await fs.readFile(url, "utf-8");
+      const pkg = JSON.parse(text);
+      if (pkg.version) return pkg.version;
+    } catch {
+    }
+  }
+  return "unknown";
+}
+async function runCli(argv) {
+  const [, , cmd, ...rest] = argv;
+  if (!cmd || cmd === "help" || cmd === "--help" || cmd === "-h") {
+    process.stdout.write(HELP);
+    return 0;
+  }
+  if (cmd === "version" || cmd === "--version" || cmd === "-v") {
+    process.stdout.write(`@ar-agents/mercadopago ${await readVersion()}
+`);
+    return 0;
+  }
+  if (cmd === "doctor") {
+    const probe = rest.includes("--probe");
+    return runDoctor({ probe });
+  }
+  process.stderr.write(
+    `Unknown command: ${cmd}
+
+Run \`mercadopago help\` for usage.
+`
+  );
+  return 2;
+}
+
+exports.runCli = runCli;
+//# sourceMappingURL=cli.cjs.map
+//# sourceMappingURL=cli.cjs.map