@ar-agents/mercadopago 0.15.3 → 0.16.0

package/dist/testing.cjs

@@ -0,0 +1,281 @@
+'use strict';
+
+// src/testing.ts
+var counter = 0;
+var nextId = () => `mock-${++counter}`;
+function mockPayment(overrides = {}) {
+  return {
+    id: nextId(),
+    status: "approved",
+    status_detail: "accredited",
+    transaction_amount: 1e3,
+    currency_id: "ARS",
+    date_created: (/* @__PURE__ */ new Date()).toISOString(),
+    date_approved: (/* @__PURE__ */ new Date()).toISOString(),
+    external_reference: `mock-ref-${counter}`,
+    description: "Mock payment",
+    payment_method_id: "visa",
+    payment_type_id: "credit_card",
+    payer: {
+      id: nextId(),
+      email: "buyer@example.com"
+    },
+    ...overrides
+  };
+}
+function mockPreapproval(overrides = {}) {
+  return {
+    id: nextId(),
+    status: "authorized",
+    payer_id: 12345,
+    payer_email: "buyer@example.com",
+    init_point: `https://www.mercadopago.com.ar/subscriptions/checkout?preapproval_id=${nextId()}`,
+    reason: "Mock subscription",
+    external_reference: `mock-sub-${counter}`,
+    date_created: (/* @__PURE__ */ new Date()).toISOString(),
+    auto_recurring: {
+      frequency: 1,
+      frequency_type: "months",
+      transaction_amount: 1e3,
+      currency_id: "ARS"
+    },
+    ...overrides
+  };
+}
+function mockSubscriptionPayment(overrides = {}) {
+  return {
+    id: nextId(),
+    preapproval_id: nextId(),
+    status: "approved",
+    payment_id: nextId(),
+    transaction_amount: 1e3,
+    currency_id: "ARS",
+    date_created: (/* @__PURE__ */ new Date()).toISOString(),
+    debit_date: (/* @__PURE__ */ new Date()).toISOString(),
+    retry_attempt: 0,
+    next_retry_date: null,
+    ...overrides
+  };
+}
+function mockPreference(overrides = {}) {
+  const id = nextId();
+  return {
+    id,
+    init_point: `https://www.mercadopago.com.ar/checkout/v1/redirect?pref_id=${id}`,
+    sandbox_init_point: `https://sandbox.mercadopago.com.ar/checkout/v1/redirect?pref_id=${id}`,
+    items: [
+      {
+        id: "item-1",
+        title: "Mock item",
+        quantity: 1,
+        unit_price: 1e3,
+        currency_id: "ARS"
+      }
+    ],
+    external_reference: `mock-pref-${counter}`,
+    date_created: (/* @__PURE__ */ new Date()).toISOString(),
+    ...overrides
+  };
+}
+function mockRefund(overrides = {}) {
+  return {
+    id: nextId(),
+    payment_id: nextId(),
+    amount: 1e3,
+    source: { id: nextId(), name: "Mock Source", type: "test" },
+    date_created: (/* @__PURE__ */ new Date()).toISOString(),
+    status: "approved",
+    ...overrides
+  };
+}
+function mockCustomer(overrides = {}) {
+  return {
+    id: nextId(),
+    email: "buyer@example.com",
+    first_name: "Test",
+    last_name: "Buyer",
+    date_created: (/* @__PURE__ */ new Date()).toISOString(),
+    ...overrides
+  };
+}
+function mockWebhookHeaders(args = {}) {
+  const topic = args.topic ?? "payment";
+  const dataId = args.dataId ?? nextId();
+  const requestId = args.requestId ?? nextId();
+  const headers = new Headers({
+    "x-request-id": requestId,
+    "content-type": "application/json"
+  });
+  const searchParams = new URLSearchParams({
+    topic,
+    "data.id": dataId
+  });
+  const body = JSON.stringify({
+    action: "payment.created",
+    api_version: "v1",
+    data: { id: dataId },
+    type: topic,
+    user_id: 12345,
+    live_mode: false
+  });
+  return { headers, searchParams, body };
+}
+async function mockSignedWebhook(args) {
+  const base = mockWebhookHeaders(args);
+  const dataId = base.searchParams.get("data.id");
+  const requestId = base.headers.get("x-request-id");
+  const ts = args.ts ?? Math.floor(Date.now() / 1e3);
+  const manifest = `id:${dataId};request-id:${requestId};ts:${ts};`;
+  const enc = new TextEncoder();
+  const key = await crypto.subtle.importKey(
+    "raw",
+    enc.encode(args.secret),
+    { name: "HMAC", hash: "SHA-256" },
+    false,
+    ["sign"]
+  );
+  const sigBytes = await crypto.subtle.sign("HMAC", key, enc.encode(manifest));
+  const v1 = Array.from(new Uint8Array(sigBytes)).map((b) => b.toString(16).padStart(2, "0")).join("");
+  base.headers.set("x-signature", `ts=${ts},v1=${v1}`);
+  return base;
+}
+var MockNotImplementedError = class extends Error {
+  constructor(method) {
+    super(
+      `MockMercadoPagoClient.${method} is not implemented. Use MSW or a real sandbox token if your test exercises this path.`
+    );
+    this.name = "MockNotImplementedError";
+  }
+};
+var MockMercadoPagoClient = class {
+  payments = /* @__PURE__ */ new Map();
+  preapprovals = /* @__PURE__ */ new Map();
+  preferences = /* @__PURE__ */ new Map();
+  refunds = /* @__PURE__ */ new Map();
+  customers = /* @__PURE__ */ new Map();
+  /** Seed the in-memory store. */
+  seed = {
+    payments: (xs) => {
+      for (const p of xs) this.payments.set(String(p.id), p);
+    },
+    preapprovals: (xs) => {
+      for (const x of xs) this.preapprovals.set(x.id, x);
+    },
+    preferences: (xs) => {
+      for (const x of xs) this.preferences.set(x.id, x);
+    },
+    refunds: (xs) => {
+      for (const r of xs) this.refunds.set(String(r.id), r);
+    },
+    customers: (xs) => {
+      for (const c of xs) this.customers.set(c.id, c);
+    }
+  };
+  // Payment methods
+  async getPayment(id) {
+    const p = this.payments.get(id);
+    if (!p) throw new Error(`Payment not found: ${id}`);
+    return p;
+  }
+  async createPayment(params) {
+    const p = mockPayment(params);
+    this.payments.set(String(p.id), p);
+    return p;
+  }
+  async searchPayments(filter = {}) {
+    const all = Array.from(this.payments.values());
+    const filtered = all.filter((p) => {
+      if (filter.status && p.status !== filter.status) return false;
+      if (filter.externalReference && p.external_reference !== filter.externalReference)
+        return false;
+      return true;
+    });
+    return {
+      paging: { total: filtered.length, limit: 30, offset: 0 },
+      results: filtered
+    };
+  }
+  async cancelPayment(id) {
+    const p = await this.getPayment(id);
+    const updated = { ...p, status: "cancelled" };
+    this.payments.set(id, updated);
+    return updated;
+  }
+  // Preapproval methods
+  async getPreapproval(id) {
+    const sub = this.preapprovals.get(id);
+    if (!sub) throw new Error(`Preapproval not found: ${id}`);
+    return sub;
+  }
+  async createPreapproval(params) {
+    const sub = mockPreapproval(params);
+    this.preapprovals.set(sub.id, sub);
+    return sub;
+  }
+  async cancelPreapproval(id) {
+    const sub = await this.getPreapproval(id);
+    const updated = { ...sub, status: "cancelled" };
+    this.preapprovals.set(id, updated);
+    return updated;
+  }
+  async pausePreapproval(id) {
+    const sub = await this.getPreapproval(id);
+    const updated = { ...sub, status: "paused" };
+    this.preapprovals.set(id, updated);
+    return updated;
+  }
+  async resumePreapproval(id) {
+    const sub = await this.getPreapproval(id);
+    const updated = { ...sub, status: "authorized" };
+    this.preapprovals.set(id, updated);
+    return updated;
+  }
+  // Refund
+  async createRefund(params) {
+    const refund = mockRefund({
+      payment_id: params.payment_id,
+      amount: params.amount ?? 1e3
+    });
+    this.refunds.set(String(refund.id), refund);
+    const payment = this.payments.get(params.payment_id);
+    if (payment) {
+      this.payments.set(params.payment_id, { ...payment, status: "refunded" });
+    }
+    return refund;
+  }
+  // Customer
+  async getCustomer(id) {
+    const c = this.customers.get(id);
+    if (!c) throw new Error(`Customer not found: ${id}`);
+    return c;
+  }
+  async createCustomer(params) {
+    const c = mockCustomer(params);
+    this.customers.set(c.id, c);
+    return c;
+  }
+  // Preference
+  async getPreference(id) {
+    const pref = this.preferences.get(id);
+    if (!pref) throw new Error(`Preference not found: ${id}`);
+    return pref;
+  }
+  async createPreference(params) {
+    const pref = mockPreference(params);
+    this.preferences.set(pref.id, pref);
+    return pref;
+  }
+};
+
+exports.MockMercadoPagoClient = MockMercadoPagoClient;
+exports.MockNotImplementedError = MockNotImplementedError;
+exports.mockCustomer = mockCustomer;
+exports.mockPayment = mockPayment;
+exports.mockPreapproval = mockPreapproval;
+exports.mockPreference = mockPreference;
+exports.mockRefund = mockRefund;
+exports.mockSignedWebhook = mockSignedWebhook;
+exports.mockSubscriptionPayment = mockSubscriptionPayment;
+exports.mockWebhookHeaders = mockWebhookHeaders;
+//# sourceMappingURL=testing.cjs.map
+//# sourceMappingURL=testing.cjs.map

package/dist/testing.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing.ts"],"names":[],"mappings":"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","file":"testing.cjs","sourcesContent":["/**\n * `@ar-agents/mercadopago/testing` — fixtures and a mock client for tests.\n *\n * What you get:\n *\n *   - **Factories** for every shape a user-side test will need: `mockPayment`,\n *     `mockPreapproval`, `mockSubscriptionPayment`, `mockPreference`,\n *     `mockRefund`, `mockCustomer`, `mockWebhookHeaders`. Each accepts a\n *     partial `overrides` object so you only spell the fields your test\n *     actually cares about.\n *\n *   - **`MockMercadoPagoClient`** — a class with the same surface as\n *     `MercadoPagoClient` but backed by an in-memory store. No network. Its\n *     mutations (createPayment, createPreapproval, etc.) update the store\n *     so a test can do create-then-get without staging fixtures twice.\n *     Read-only methods that don't fit a clean store model (search filters,\n *     pagination edge cases) throw `MockNotImplementedError` — by design,\n *     so you notice when a test wanders into territory that needs MSW or a\n *     real sandbox token.\n *\n *   - **`mockSignedWebhook`** — produces a `{ body, headers, searchParams }`\n *     bundle whose `x-signature` passes `verifyWebhookSignature` against the\n *     same secret. Test the full webhook stack end-to-end without hand-rolling\n *     the HMAC.\n *\n * Why a subpath: the testing helpers are dev-time only and would bloat the\n * production bundle if exported from the main entry. Imports compile away\n * cleanly when bundlers tree-shake.\n *\n * @example\n * ```ts\n * import { MockMercadoPagoClient, mockPayment, mockSignedWebhook } from \"@ar-agents/mercadopago/testing\";\n *\n * test(\"approves and stores a payment\", async () => {\n *   const mp = new MockMercadoPagoClient();\n *   mp.seed.payments([mockPayment({ status: \"approved\", transaction_amount: 1000 })]);\n *   const got = await mp.searchPayments({ status: \"approved\" });\n *   expect(got.results).toHaveLength(1);\n * });\n *\n * test(\"end-to-end webhook with a verified signature\", async () => {\n *   const { body, headers, searchParams } = await mockSignedWebhook({\n *     topic: \"payment\",\n *     dataId: \"123\",\n *     secret: \"test-secret\",\n *   });\n *   const ok = await verifyWebhookSignature({\n *     requestId: headers.get(\"x-request-id\"),\n *     dataId: \"123\",\n *     signatureHeader: headers.get(\"x-signature\"),\n *     secret: \"test-secret\",\n *   });\n *   expect(ok).toBe(true);\n * });\n * ```\n */\n\nimport type {\n  Payment,\n  Preapproval,\n  SubscriptionPayment,\n  Preference,\n  Refund,\n  Customer,\n} from \"./types\";\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Factories\n// ─────────────────────────────────────────────────────────────────────────────\n\nlet counter = 0;\nconst nextId = () => `mock-${++counter}`;\n\n/** Build a Payment fixture. Sensible defaults for the most common scenario\n *  (an approved $1000 ARS sale with an external_reference). */\nexport function mockPayment(overrides: Partial<Payment> = {}): Payment {\n  return {\n    id: nextId(),\n    status: \"approved\",\n    status_detail: \"accredited\",\n    transaction_amount: 1000,\n    currency_id: \"ARS\",\n    date_created: new Date().toISOString(),\n    date_approved: new Date().toISOString(),\n    external_reference: `mock-ref-${counter}`,\n    description: \"Mock payment\",\n    payment_method_id: \"visa\",\n    payment_type_id: \"credit_card\",\n    payer: {\n      id: nextId(),\n      email: \"buyer@example.com\",\n    },\n    ...overrides,\n  } as Payment;\n}\n\n/** Build a Preapproval (recurring subscription) fixture. */\nexport function mockPreapproval(overrides: Partial<Preapproval> = {}): Preapproval {\n  return {\n    id: nextId(),\n    status: \"authorized\",\n    payer_id: 12345,\n    payer_email: \"buyer@example.com\",\n    init_point: `https://www.mercadopago.com.ar/subscriptions/checkout?preapproval_id=${nextId()}`,\n    reason: \"Mock subscription\",\n    external_reference: `mock-sub-${counter}`,\n    date_created: new Date().toISOString(),\n    auto_recurring: {\n      frequency: 1,\n      frequency_type: \"months\",\n      transaction_amount: 1000,\n      currency_id: \"ARS\",\n    },\n    ...overrides,\n  } as Preapproval;\n}\n\n/** Build a SubscriptionPayment (single recurring-charge attempt) fixture. */\nexport function mockSubscriptionPayment(\n  overrides: Partial<SubscriptionPayment> = {},\n): SubscriptionPayment {\n  return {\n    id: nextId(),\n    preapproval_id: nextId(),\n    status: \"approved\",\n    payment_id: nextId(),\n    transaction_amount: 1000,\n    currency_id: \"ARS\",\n    date_created: new Date().toISOString(),\n    debit_date: new Date().toISOString(),\n    retry_attempt: 0,\n    next_retry_date: null,\n    ...overrides,\n  } as SubscriptionPayment;\n}\n\n/** Build a Preference (Checkout Pro) fixture. */\nexport function mockPreference(overrides: Partial<Preference> = {}): Preference {\n  const id = nextId();\n  return {\n    id,\n    init_point: `https://www.mercadopago.com.ar/checkout/v1/redirect?pref_id=${id}`,\n    sandbox_init_point: `https://sandbox.mercadopago.com.ar/checkout/v1/redirect?pref_id=${id}`,\n    items: [\n      {\n        id: \"item-1\",\n        title: \"Mock item\",\n        quantity: 1,\n        unit_price: 1000,\n        currency_id: \"ARS\",\n      },\n    ],\n    external_reference: `mock-pref-${counter}`,\n    date_created: new Date().toISOString(),\n    ...overrides,\n  } as Preference;\n}\n\n/** Build a Refund fixture. */\nexport function mockRefund(overrides: Partial<Refund> = {}): Refund {\n  return {\n    id: nextId(),\n    payment_id: nextId(),\n    amount: 1000,\n    source: { id: nextId(), name: \"Mock Source\", type: \"test\" },\n    date_created: new Date().toISOString(),\n    status: \"approved\",\n    ...overrides,\n  } as Refund;\n}\n\n/** Build a Customer fixture. */\nexport function mockCustomer(overrides: Partial<Customer> = {}): Customer {\n  return {\n    id: nextId(),\n    email: \"buyer@example.com\",\n    first_name: \"Test\",\n    last_name: \"Buyer\",\n    date_created: new Date().toISOString(),\n    ...overrides,\n  } as Customer;\n}\n\n/** Build a `webhookHeaders + searchParams + body` triple for a `payment.created`\n *  topic. Use directly when you don't need a verified signature. */\nexport function mockWebhookHeaders(args: {\n  topic?: string;\n  dataId?: string;\n  requestId?: string;\n} = {}): { headers: Headers; searchParams: URLSearchParams; body: string } {\n  const topic = args.topic ?? \"payment\";\n  const dataId = args.dataId ?? nextId();\n  const requestId = args.requestId ?? nextId();\n  const headers = new Headers({\n    \"x-request-id\": requestId,\n    \"content-type\": \"application/json\",\n  });\n  const searchParams = new URLSearchParams({\n    topic,\n    \"data.id\": dataId,\n  });\n  const body = JSON.stringify({\n    action: \"payment.created\",\n    api_version: \"v1\",\n    data: { id: dataId },\n    type: topic,\n    user_id: 12345,\n    live_mode: false,\n  });\n  return { headers, searchParams, body };\n}\n\n/**\n * Like `mockWebhookHeaders`, but also computes a real HMAC-SHA256 signature\n * against `secret` so `verifyWebhookSignature` accepts it. Use this in tests\n * for the full webhook handler stack.\n */\nexport async function mockSignedWebhook(args: {\n  topic?: string;\n  dataId?: string;\n  requestId?: string;\n  secret: string;\n  ts?: number; // override for replay-window tests\n}): Promise<{ headers: Headers; searchParams: URLSearchParams; body: string }> {\n  const base = mockWebhookHeaders(args);\n  const dataId = base.searchParams.get(\"data.id\")!;\n  const requestId = base.headers.get(\"x-request-id\")!;\n  const ts = args.ts ?? Math.floor(Date.now() / 1000);\n  const manifest = `id:${dataId};request-id:${requestId};ts:${ts};`;\n\n  const enc = new TextEncoder();\n  const key = await crypto.subtle.importKey(\n    \"raw\",\n    enc.encode(args.secret),\n    { name: \"HMAC\", hash: \"SHA-256\" },\n    false,\n    [\"sign\"],\n  );\n  const sigBytes = await crypto.subtle.sign(\"HMAC\", key, enc.encode(manifest));\n  const v1 = Array.from(new Uint8Array(sigBytes))\n    .map((b) => b.toString(16).padStart(2, \"0\"))\n    .join(\"\");\n\n  base.headers.set(\"x-signature\", `ts=${ts},v1=${v1}`);\n  return base;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// MockMercadoPagoClient\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Thrown when a mock client method has no in-memory implementation. By design:\n * if your test relied on the missing path, switch to MSW or a real sandbox\n * token rather than expanding the mock surface ad-hoc.\n */\nexport class MockNotImplementedError extends Error {\n  constructor(method: string) {\n    super(\n      `MockMercadoPagoClient.${method} is not implemented. Use MSW or a real ` +\n        `sandbox token if your test exercises this path.`,\n    );\n    this.name = \"MockNotImplementedError\";\n  }\n}\n\n/**\n * In-memory client. Implements the most-commonly-needed read + write paths.\n * Tests that need long-tail behaviour (search by complex filters, error\n * injection) should reach for MSW.\n */\nexport class MockMercadoPagoClient {\n  private payments = new Map<string, Payment>();\n  private preapprovals = new Map<string, Preapproval>();\n  private preferences = new Map<string, Preference>();\n  private refunds = new Map<string, Refund>();\n  private customers = new Map<string, Customer>();\n\n  /** Seed the in-memory store. */\n  seed = {\n    payments: (xs: Payment[]) => {\n      for (const p of xs) this.payments.set(String(p.id), p);\n    },\n    preapprovals: (xs: Preapproval[]) => {\n      for (const x of xs) this.preapprovals.set(x.id, x);\n    },\n    preferences: (xs: Preference[]) => {\n      for (const x of xs) this.preferences.set(x.id, x);\n    },\n    refunds: (xs: Refund[]) => {\n      for (const r of xs) this.refunds.set(String(r.id), r);\n    },\n    customers: (xs: Customer[]) => {\n      for (const c of xs) this.customers.set(c.id, c);\n    },\n  };\n\n  // Payment methods\n  async getPayment(id: string): Promise<Payment> {\n    const p = this.payments.get(id);\n    if (!p) throw new Error(`Payment not found: ${id}`);\n    return p;\n  }\n\n  async createPayment(params: Partial<Payment>): Promise<Payment> {\n    const p = mockPayment(params);\n    this.payments.set(String(p.id), p);\n    return p;\n  }\n\n  async searchPayments(filter: { status?: string; externalReference?: string } = {}) {\n    const all = Array.from(this.payments.values());\n    const filtered = all.filter((p) => {\n      if (filter.status && p.status !== filter.status) return false;\n      if (\n        filter.externalReference &&\n        p.external_reference !== filter.externalReference\n      )\n        return false;\n      return true;\n    });\n    return {\n      paging: { total: filtered.length, limit: 30, offset: 0 },\n      results: filtered,\n    };\n  }\n\n  async cancelPayment(id: string): Promise<Payment> {\n    const p = await this.getPayment(id);\n    const updated = { ...p, status: \"cancelled\" as const };\n    this.payments.set(id, updated);\n    return updated;\n  }\n\n  // Preapproval methods\n  async getPreapproval(id: string): Promise<Preapproval> {\n    const sub = this.preapprovals.get(id);\n    if (!sub) throw new Error(`Preapproval not found: ${id}`);\n    return sub;\n  }\n\n  async createPreapproval(params: Partial<Preapproval>): Promise<Preapproval> {\n    const sub = mockPreapproval(params);\n    this.preapprovals.set(sub.id, sub);\n    return sub;\n  }\n\n  async cancelPreapproval(id: string): Promise<Preapproval> {\n    const sub = await this.getPreapproval(id);\n    const updated = { ...sub, status: \"cancelled\" as const };\n    this.preapprovals.set(id, updated);\n    return updated;\n  }\n\n  async pausePreapproval(id: string): Promise<Preapproval> {\n    const sub = await this.getPreapproval(id);\n    const updated = { ...sub, status: \"paused\" as const };\n    this.preapprovals.set(id, updated);\n    return updated;\n  }\n\n  async resumePreapproval(id: string): Promise<Preapproval> {\n    const sub = await this.getPreapproval(id);\n    const updated = { ...sub, status: \"authorized\" as const };\n    this.preapprovals.set(id, updated);\n    return updated;\n  }\n\n  // Refund\n  async createRefund(params: { payment_id: string; amount?: number }): Promise<Refund> {\n    const refund = mockRefund({\n      payment_id: params.payment_id,\n      amount: params.amount ?? 1000,\n    });\n    this.refunds.set(String(refund.id), refund);\n    // Mark the payment as refunded.\n    const payment = this.payments.get(params.payment_id);\n    if (payment) {\n      this.payments.set(params.payment_id, { ...payment, status: \"refunded\" });\n    }\n    return refund;\n  }\n\n  // Customer\n  async getCustomer(id: string): Promise<Customer> {\n    const c = this.customers.get(id);\n    if (!c) throw new Error(`Customer not found: ${id}`);\n    return c;\n  }\n\n  async createCustomer(params: Partial<Customer>): Promise<Customer> {\n    const c = mockCustomer(params);\n    this.customers.set(c.id, c);\n    return c;\n  }\n\n  // Preference\n  async getPreference(id: string): Promise<Preference> {\n    const pref = this.preferences.get(id);\n    if (!pref) throw new Error(`Preference not found: ${id}`);\n    return pref;\n  }\n\n  async createPreference(params: Partial<Preference>): Promise<Preference> {\n    const pref = mockPreference(params);\n    this.preferences.set(pref.id, pref);\n    return pref;\n  }\n\n  // Catch-all for unimplemented surface — tests can still construct the client\n  // and only fail on the method they actually need that's missing.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  [key: string]: any;\n}\n"]}

package/dist/testing.d.cts

@@ -0,0 +1,188 @@
+import { b as Payment, P as Preapproval, f as Preference, R as Refund, h as Customer, p as SubscriptionPayment } from './types-BaOjfcOt.cjs';
+import 'zod';
+
+/**
+ * `@ar-agents/mercadopago/testing` — fixtures and a mock client for tests.
+ *
+ * What you get:
+ *
+ *   - **Factories** for every shape a user-side test will need: `mockPayment`,
+ *     `mockPreapproval`, `mockSubscriptionPayment`, `mockPreference`,
+ *     `mockRefund`, `mockCustomer`, `mockWebhookHeaders`. Each accepts a
+ *     partial `overrides` object so you only spell the fields your test
+ *     actually cares about.
+ *
+ *   - **`MockMercadoPagoClient`** — a class with the same surface as
+ *     `MercadoPagoClient` but backed by an in-memory store. No network. Its
+ *     mutations (createPayment, createPreapproval, etc.) update the store
+ *     so a test can do create-then-get without staging fixtures twice.
+ *     Read-only methods that don't fit a clean store model (search filters,
+ *     pagination edge cases) throw `MockNotImplementedError` — by design,
+ *     so you notice when a test wanders into territory that needs MSW or a
+ *     real sandbox token.
+ *
+ *   - **`mockSignedWebhook`** — produces a `{ body, headers, searchParams }`
+ *     bundle whose `x-signature` passes `verifyWebhookSignature` against the
+ *     same secret. Test the full webhook stack end-to-end without hand-rolling
+ *     the HMAC.
+ *
+ * Why a subpath: the testing helpers are dev-time only and would bloat the
+ * production bundle if exported from the main entry. Imports compile away
+ * cleanly when bundlers tree-shake.
+ *
+ * @example
+ * ```ts
+ * import { MockMercadoPagoClient, mockPayment, mockSignedWebhook } from "@ar-agents/mercadopago/testing";
+ *
+ * test("approves and stores a payment", async () => {
+ *   const mp = new MockMercadoPagoClient();
+ *   mp.seed.payments([mockPayment({ status: "approved", transaction_amount: 1000 })]);
+ *   const got = await mp.searchPayments({ status: "approved" });
+ *   expect(got.results).toHaveLength(1);
+ * });
+ *
+ * test("end-to-end webhook with a verified signature", async () => {
+ *   const { body, headers, searchParams } = await mockSignedWebhook({
+ *     topic: "payment",
+ *     dataId: "123",
+ *     secret: "test-secret",
+ *   });
+ *   const ok = await verifyWebhookSignature({
+ *     requestId: headers.get("x-request-id"),
+ *     dataId: "123",
+ *     signatureHeader: headers.get("x-signature"),
+ *     secret: "test-secret",
+ *   });
+ *   expect(ok).toBe(true);
+ * });
+ * ```
+ */
+
+/** Build a Payment fixture. Sensible defaults for the most common scenario
+ *  (an approved $1000 ARS sale with an external_reference). */
+declare function mockPayment(overrides?: Partial<Payment>): Payment;
+/** Build a Preapproval (recurring subscription) fixture. */
+declare function mockPreapproval(overrides?: Partial<Preapproval>): Preapproval;
+/** Build a SubscriptionPayment (single recurring-charge attempt) fixture. */
+declare function mockSubscriptionPayment(overrides?: Partial<SubscriptionPayment>): SubscriptionPayment;
+/** Build a Preference (Checkout Pro) fixture. */
+declare function mockPreference(overrides?: Partial<Preference>): Preference;
+/** Build a Refund fixture. */
+declare function mockRefund(overrides?: Partial<Refund>): Refund;
+/** Build a Customer fixture. */
+declare function mockCustomer(overrides?: Partial<Customer>): Customer;
+/** Build a `webhookHeaders + searchParams + body` triple for a `payment.created`
+ *  topic. Use directly when you don't need a verified signature. */
+declare function mockWebhookHeaders(args?: {
+    topic?: string;
+    dataId?: string;
+    requestId?: string;
+}): {
+    headers: Headers;
+    searchParams: URLSearchParams;
+    body: string;
+};
+/**
+ * Like `mockWebhookHeaders`, but also computes a real HMAC-SHA256 signature
+ * against `secret` so `verifyWebhookSignature` accepts it. Use this in tests
+ * for the full webhook handler stack.
+ */
+declare function mockSignedWebhook(args: {
+    topic?: string;
+    dataId?: string;
+    requestId?: string;
+    secret: string;
+    ts?: number;
+}): Promise<{
+    headers: Headers;
+    searchParams: URLSearchParams;
+    body: string;
+}>;
+/**
+ * Thrown when a mock client method has no in-memory implementation. By design:
+ * if your test relied on the missing path, switch to MSW or a real sandbox
+ * token rather than expanding the mock surface ad-hoc.
+ */
+declare class MockNotImplementedError extends Error {
+    constructor(method: string);
+}
+/**
+ * In-memory client. Implements the most-commonly-needed read + write paths.
+ * Tests that need long-tail behaviour (search by complex filters, error
+ * injection) should reach for MSW.
+ */
+declare class MockMercadoPagoClient {
+    private payments;
+    private preapprovals;
+    private preferences;
+    private refunds;
+    private customers;
+    /** Seed the in-memory store. */
+    seed: {
+        payments: (xs: Payment[]) => void;
+        preapprovals: (xs: Preapproval[]) => void;
+        preferences: (xs: Preference[]) => void;
+        refunds: (xs: Refund[]) => void;
+        customers: (xs: Customer[]) => void;
+    };
+    getPayment(id: string): Promise<Payment>;
+    createPayment(params: Partial<Payment>): Promise<Payment>;
+    searchPayments(filter?: {
+        status?: string;
+        externalReference?: string;
+    }): Promise<{
+        paging: {
+            total: number;
+            limit: number;
+            offset: number;
+        };
+        results: {
+            [x: string]: unknown;
+            id: string;
+            status: string;
+            transaction_amount: number;
+            currency_id: string;
+            status_detail?: string | null | undefined;
+            date_created?: string | null | undefined;
+            date_approved?: string | null | undefined;
+            date_last_updated?: string | null | undefined;
+            installments?: number | null | undefined;
+            payment_method_id?: string | null | undefined;
+            payment_type_id?: string | null | undefined;
+            external_reference?: string | null | undefined;
+            description?: string | null | undefined;
+            payer?: {
+                [x: string]: unknown;
+                id?: string | number | undefined;
+                email?: string | null | undefined;
+                identification?: {
+                    type?: string | null | undefined;
+                    number?: string | null | undefined;
+                } | null | undefined;
+            } | undefined;
+            transaction_details?: {
+                [x: string]: unknown;
+                net_received_amount?: number | null | undefined;
+                total_paid_amount?: number | null | undefined;
+                installment_amount?: number | null | undefined;
+            } | undefined;
+        }[];
+    }>;
+    cancelPayment(id: string): Promise<Payment>;
+    getPreapproval(id: string): Promise<Preapproval>;
+    createPreapproval(params: Partial<Preapproval>): Promise<Preapproval>;
+    cancelPreapproval(id: string): Promise<Preapproval>;
+    pausePreapproval(id: string): Promise<Preapproval>;
+    resumePreapproval(id: string): Promise<Preapproval>;
+    createRefund(params: {
+        payment_id: string;
+        amount?: number;
+    }): Promise<Refund>;
+    getCustomer(id: string): Promise<Customer>;
+    createCustomer(params: Partial<Customer>): Promise<Customer>;
+    getPreference(id: string): Promise<Preference>;
+    createPreference(params: Partial<Preference>): Promise<Preference>;
+    [key: string]: any;
+}
+
+export { MockMercadoPagoClient, MockNotImplementedError, mockCustomer, mockPayment, mockPreapproval, mockPreference, mockRefund, mockSignedWebhook, mockSubscriptionPayment, mockWebhookHeaders };