@ar-agents/mercadopago 0.7.0 → 0.9.0

package/dist/index.d.ts

@@ -1,5 +1,172 @@
 import { z } from 'zod';
 import { ToolSet } from 'ai';
+import { S as SubscriptionStateAdapter } from './state-C6Wzb_XX.js';
+export { I as IdempotencyCache, a as InMemoryIdempotencyCache, b as InMemoryOAuthTokenStore, c as InMemoryStateAdapter, O as OAuthTokenRecord, d as OAuthTokenStore, e as SubscriptionStateRecord } from './state-C6Wzb_XX.js';
+
+/**
+ * Circuit breaker — protects your app from cascading failures when MP
+ * (or any upstream) is degraded.
+ *
+ * # Why
+ *
+ * When MP's API has an outage, naive retry-with-backoff still pounds the
+ * dead service N times per request × every concurrent request. That makes
+ * MP's outage worse AND your app's error rate worse (each request burns
+ * `requestTimeoutMs × maxRetries` ms of CPU/event-loop time before failing).
+ *
+ * A circuit breaker observes failures over a rolling window. After enough
+ * failures it OPENS — subsequent calls fail fast (no network round-trip)
+ * with a `CircuitOpenError`. After a cooldown it HALF-OPENs — lets one
+ * trial through. If that succeeds, it CLOSES (back to normal). If it
+ * fails, it RE-OPENs for another cooldown.
+ *
+ * # State machine
+ *
+ *  CLOSED ──(failures ≥ threshold)──▶ OPEN
+ *    ▲                                  │
+ *    │                                  │ (cooldown elapsed)
+ *    │                                  ▼
+ *    │                              HALF_OPEN
+ *    │                                  │
+ *    └──(trial succeeds)────────────────┤
+ *                                       │ (trial fails)
+ *                                       ▼
+ *                                     OPEN
+ *
+ * # When to use
+ *
+ * - **Protects YOUR app** from being slow/dead when MP is slow/dead.
+ * - **Protects MP** from your app pummeling it during incidents.
+ * - **Surfaces a clear signal to ops**: `circuit_open` event tells you
+ *   "MP is broken, my app is intentionally short-circuiting" — different
+ *   from "MP timed out 30s × 3 retries × 1000 concurrent users".
+ *
+ * # When NOT to use
+ *
+ * - For idempotent reads where stale-cached data is acceptable, prefer
+ *   a cache-aside pattern instead.
+ * - For fire-and-forget webhooks where the backpressure should propagate
+ *   to MP itself (return 5xx, MP retries with backoff).
+ *
+ * # Configuration
+ *
+ * Defaults are tuned for typical MP traffic patterns:
+ * - `failureThreshold: 5` — open after 5 consecutive failures
+ * - `successThreshold: 2` — close after 2 trial successes (half-open)
+ * - `resetTimeoutMs: 30_000` — 30s cooldown before half-open trial
+ * - `monitoringWindowMs: 60_000` — count failures within a 60s window
+ *
+ * # Per-host vs global
+ *
+ * The default `MercadoPagoClient` uses ONE breaker per client instance
+ * (which means one per upstream host: `api.mercadopago.com` for prod,
+ * `api.mercadopago.com` sandbox for TEST). For multi-host setups (e.g.,
+ * marketplace flows with per-seller clients), instantiate a SHARED breaker
+ * and pass it to all clients — they all benefit from the same backpressure
+ * signal.
+ */
+type CircuitState = "CLOSED" | "OPEN" | "HALF_OPEN";
+interface CircuitBreakerOptions {
+    /** Open the breaker after this many consecutive failures. Default 5. */
+    failureThreshold?: number;
+    /** Close the breaker after this many successive successes in HALF_OPEN. Default 2. */
+    successThreshold?: number;
+    /** Time to stay OPEN before allowing a HALF_OPEN trial. Default 30s. */
+    resetTimeoutMs?: number;
+    /** Rolling window for counting failures. Failures older than this don't count. Default 60s. */
+    monitoringWindowMs?: number;
+    /**
+     * Called on EVERY state transition. Useful for emitting metrics/logs.
+     * `cause` is the error that triggered the transition (when applicable).
+     */
+    onStateChange?: (event: {
+        from: CircuitState;
+        to: CircuitState;
+        cause?: unknown;
+        consecutiveFailures: number;
+    }) => void;
+    /**
+     * Predicate to decide whether an error should count as a circuit failure.
+     * By default, all errors count. Override to ignore expected business
+     * errors (e.g., 404s, validation errors) — they shouldn't open the breaker.
+     */
+    isFailure?: (error: unknown) => boolean;
+    /** Time provider (for tests). Defaults to `Date.now`. */
+    now?: () => number;
+}
+/**
+ * Thrown when a circuit breaker is OPEN and rejects a call without trying.
+ * Catch this separately from MercadoPagoError to differentiate "MP said no"
+ * from "we didn't even ask MP".
+ */
+declare class CircuitOpenError extends Error {
+    readonly retryAfterMs: number;
+    readonly consecutiveFailures: number;
+    constructor(retryAfterMs: number, consecutiveFailures: number);
+}
+/**
+ * Thread-safe circuit breaker. Single-instance per upstream (typically per
+ * `MercadoPagoClient`). Pass to multiple clients to share state.
+ *
+ * @example
+ * ```ts
+ * import { CircuitBreaker, MercadoPagoClient } from "@ar-agents/mercadopago";
+ *
+ * const breaker = new CircuitBreaker({
+ *   failureThreshold: 5,
+ *   resetTimeoutMs: 30_000,
+ *   onStateChange: (e) => metrics.increment(`circuit.${e.to}`),
+ * });
+ *
+ * const client = new MercadoPagoClient({
+ *   accessToken: process.env.MP_ACCESS_TOKEN!,
+ *   circuitBreaker: breaker,
+ * });
+ * ```
+ */
+declare class CircuitBreaker {
+    private state;
+    private consecutiveFailures;
+    private halfOpenSuccesses;
+    private openedAt;
+    /** Timestamps of failures within the monitoring window. */
+    private failureWindow;
+    private readonly failureThreshold;
+    private readonly successThreshold;
+    private readonly resetTimeoutMs;
+    private readonly monitoringWindowMs;
+    private readonly onStateChange;
+    private readonly isFailureFn;
+    private readonly now;
+    constructor(opts?: CircuitBreakerOptions);
+    /** Read the current state. Useful for health checks + metrics. */
+    getState(): CircuitState;
+    /** Read diagnostic state for health checks + dashboards. */
+    getStats(): {
+        state: CircuitState;
+        consecutiveFailures: number;
+        failuresInWindow: number;
+        msSinceOpened: number | null;
+        msUntilHalfOpen: number | null;
+    };
+    /**
+     * Execute `fn` under the breaker's protection.
+     * - If the breaker is OPEN, throws `CircuitOpenError` immediately.
+     * - If `fn` succeeds, may transition HALF_OPEN → CLOSED.
+     * - If `fn` fails (and the error counts as a failure), records the
+     *   failure; may transition CLOSED → OPEN or HALF_OPEN → OPEN.
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /** Manually force the breaker open. Useful for runbook / manual ops. */
+    trip(reason?: unknown): void;
+    /** Manually reset the breaker to CLOSED. */
+    reset(): void;
+    private recordSuccess;
+    private recordFailure;
+    private transitionTo;
+    private pruneWindow;
+    private failuresInCurrentWindow;
+}
 
 /**
  * Base class for any error originating from the Mercado Pago integration. All
@@ -1118,6 +1285,10 @@ interface MercadoPagoClientOptions {
     /**
      * Observability hook fired AFTER every request (success or failure).
      * Useful for logging, metrics, tracing. Synchronous, fire-and-forget.
+     *
+     * The `traceContext` field follows the W3C Trace Context spec — pass
+     * an OpenTelemetry-compatible context propagator and you get full
+     * distributed tracing for free. See `traceContext` option below.
      */
     onCall?: (event: {
         method: string;
@@ -1126,7 +1297,52 @@ interface MercadoPagoClientOptions {
         httpStatus: number | null;
         retried: number;
         success: boolean;
+        /** v0.9: MP's `x-request-id` echo. Useful for support tickets. */
+        requestId?: string | null;
+        /** v0.9: MP's rate-limit headers when present. */
+        rateLimit?: {
+            remaining: number | null;
+            resetSeconds: number | null;
+        };
+        /** v0.9: Circuit breaker state at the time of the call. */
+        circuitState?: "CLOSED" | "OPEN" | "HALF_OPEN";
+        /** v0.9: Trace context for OpenTelemetry-style propagation. */
+        traceContext?: {
+            traceId?: string;
+            spanId?: string;
+        };
     }) => void;
+    /**
+     * v0.9 — Opt-in circuit breaker. When MP is failing, fail fast instead of
+     * piling up retries against a dead service. Pass a configured instance
+     * (or share one across multiple clients to give them shared backpressure
+     * signal).
+     *
+     * @example
+     * ```ts
+     * const breaker = new CircuitBreaker({
+     *   failureThreshold: 5,
+     *   resetTimeoutMs: 30_000,
+     *   onStateChange: (e) => metrics.gauge("circuit.state", e.to),
+     * });
+     * const client = new MercadoPagoClient({ accessToken: "...", circuitBreaker: breaker });
+     * ```
+     */
+    circuitBreaker?: CircuitBreaker;
+    /**
+     * v0.9 — Optional W3C Trace Context propagator. If provided, the client
+     * extracts traceId/spanId on each request, injects `traceparent` /
+     * `tracestate` headers (MP echoes them back via x-request-id), and surfaces
+     * them in `onCall` events. Compatible with OpenTelemetry without adding
+     * `@opentelemetry/api` as a peer dep.
+     *
+     * If you have OTEL set up, just pass `() => trace.getActiveSpan()?.spanContext()`.
+     */
+    traceContext?: () => {
+        traceId?: string;
+        spanId?: string;
+        traceFlags?: number;
+    } | undefined;
 }
 interface RequestOptions {
     /** Idempotency key. Required for POST/PUT to dedupe retries safely. */
@@ -1141,6 +1357,13 @@ interface RequestOptions {
         payerEmail?: string;
         sellerEmail?: string;
     };
+    /**
+     * v0.9 — Parent AbortSignal for deadline propagation. When the agent
+     * has a fixed budget (e.g., 5s for the whole tool call), pass it here.
+     * The client merges it with its own per-request timeout — whichever
+     * fires first wins.
+     */
+    signal?: AbortSignal;
 }
 /**
  * Thin, typed wrapper around Mercado Pago's REST API. Exposes the surface
@@ -1156,8 +1379,16 @@ declare class MercadoPagoClient {
     private readonly requestTimeoutMs;
     private readonly maxRetries;
     private readonly onCall;
+    private readonly circuitBreaker;
+    private readonly traceContext;
     constructor(options: MercadoPagoClientOptions);
+    /**
+     * v0.9 — Inspect the circuit breaker state (when configured). Returns
+     * `null` when no circuit breaker is wired. Useful for health checks.
+     */
+    getCircuitState(): ReturnType<CircuitBreaker["getStats"]> | null;
     private request;
+    private requestUnprotected;
     /**
      * Create a recurring subscription (preapproval). The returned `init_point`
      * URL is where the buyer must complete the FIRST payment with their card +
@@ -1623,52 +1854,26 @@ declare class MercadoPagoClient {
         id: string;
         canceled: true;
     }>;
-}
-
-/**
- * In-memory record of a subscription. The lib persists the MP-side fields
- * needed to reason about a subscription without hitting the API every time
- * (status, last webhook info, customer email, etc.) plus a free-form metadata
- * bag for callers to attach business context (tenant id, plan name, etc.).
- */
-interface SubscriptionStateRecord {
-    status?: string;
-    payerEmail?: string;
-    amount?: number;
-    currency?: string;
-    frequency?: number;
-    frequencyType?: string;
-    initPoint?: string;
-    externalReference?: string;
-    createdAt?: string;
-    cancelledAt?: string;
-    lastWebhookStatus?: string;
-    lastWebhookAt?: string;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Persistence surface for subscription state. Implementations may back this
- * with Upstash Redis, Vercel KV, Postgres, in-memory, or anything that
- * supports the three operations. The default `InMemoryStateAdapter` is
- * provided for tests and trivial single-process deployments; production
- * setups should plug in a durable store.
- */
-interface SubscriptionStateAdapter {
-    set(id: string, state: Partial<SubscriptionStateRecord>): Promise<void>;
-    get(id: string): Promise<SubscriptionStateRecord | null>;
-    list?(): Promise<string[]>;
-}
-/**
- * Volatile, single-process state adapter. Useful for tests and demos. Do not
- * use in production: state is lost on restart and is not safe across tenants.
- */
-declare class InMemoryStateAdapter implements SubscriptionStateAdapter {
-    private readonly store;
-    set(id: string, state: Partial<SubscriptionStateRecord>): Promise<void>;
-    get(id: string): Promise<SubscriptionStateRecord | null>;
-    list(): Promise<string[]>;
-    /** Test helper: drop everything. Not part of the adapter interface. */
-    reset(): void;
+    /**
+     * Liveness probe against MP. Returns latency + circuit-breaker state.
+     * Use as a /health endpoint for k8s, Vercel cron, or status-page checks.
+     *
+     * Returns `{ ok: false, ... }` instead of throwing — designed for
+     * monitoring loops that want to keep running.
+     *
+     * @param signal Optional AbortSignal to cap wait time (e.g., 2s for
+     *               status-page polling).
+     */
+    healthCheck(signal?: AbortSignal): Promise<{
+        ok: boolean;
+        latencyMs: number;
+        /** MP user_id when reachable. */
+        userId: string | null;
+        /** Last error message when not OK. */
+        error: string | null;
+        /** Circuit breaker state when configured. */
+        circuit: ReturnType<CircuitBreaker["getStats"]> | null;
+    }>;
 }
 
 interface MercadoPagoToolsOptions {
@@ -1709,7 +1914,7 @@ interface MercadoPagoToolsOptions {
         clientSecret: string;
     };
 }
-type ToolName = "create_subscription" | "get_subscription_status" | "cancel_subscription" | "pause_subscription" | "resume_subscription" | "create_payment" | "get_payment" | "search_payments" | "cancel_payment" | "capture_payment" | "refund_payment" | "list_refunds" | "create_payment_preference" | "get_payment_preference" | "create_customer" | "find_customer_by_email" | "list_customer_cards" | "delete_customer_card" | "list_payment_methods" | "calculate_installments" | "get_account_info" | "charge_saved_card" | "create_qr_payment" | "cancel_qr_payment" | "create_subscription_plan" | "list_subscription_plans" | "update_subscription_plan" | "subscribe_to_plan" | "list_subscription_payments" | "create_store" | "list_stores" | "create_pos" | "list_pos" | "list_payment_disputes" | "get_dispute" | "list_identification_types" | "list_issuers" | "list_webhooks" | "create_webhook" | "update_webhook" | "delete_webhook" | "handle_webhook" | "oauth_authorize_url" | "oauth_exchange_code" | "oauth_refresh_token" | "create_order" | "get_order" | "update_order" | "capture_order" | "cancel_order" | "get_account_balance" | "list_account_movements" | "list_settlements" | "get_settlement" | "analyze_payment_3ds" | "get_test_cards" | "get_customer" | "update_customer" | "create_customer_card" | "get_customer_card" | "get_subscription_plan" | "update_subscription" | "search_subscriptions" | "get_refund" | "update_payment_preference" | "get_merchant_order" | "search_merchant_orders" | "update_merchant_order" | "get_store" | "update_store" | "delete_store" | "get_pos" | "update_pos" | "delete_pos" | "list_bank_accounts" | "register_bank_account" | "list_point_devices" | "update_point_device_mode" | "create_point_payment_intent" | "get_point_payment_intent" | "cancel_point_payment_intent" | "compute_marketplace_fee" | "explain_payment_status";
+type ToolName = "create_subscription" | "get_subscription_status" | "cancel_subscription" | "pause_subscription" | "resume_subscription" | "create_payment" | "get_payment" | "search_payments" | "cancel_payment" | "capture_payment" | "refund_payment" | "list_refunds" | "create_payment_preference" | "get_payment_preference" | "create_customer" | "find_customer_by_email" | "list_customer_cards" | "delete_customer_card" | "list_payment_methods" | "calculate_installments" | "get_account_info" | "charge_saved_card" | "create_qr_payment" | "cancel_qr_payment" | "create_subscription_plan" | "list_subscription_plans" | "update_subscription_plan" | "subscribe_to_plan" | "list_subscription_payments" | "create_store" | "list_stores" | "create_pos" | "list_pos" | "list_payment_disputes" | "get_dispute" | "list_identification_types" | "list_issuers" | "list_webhooks" | "create_webhook" | "update_webhook" | "delete_webhook" | "handle_webhook" | "oauth_authorize_url" | "oauth_exchange_code" | "oauth_refresh_token" | "create_order" | "get_order" | "update_order" | "capture_order" | "cancel_order" | "get_account_balance" | "list_account_movements" | "list_settlements" | "get_settlement" | "analyze_payment_3ds" | "get_test_cards" | "get_customer" | "update_customer" | "create_customer_card" | "get_customer_card" | "get_subscription_plan" | "update_subscription" | "search_subscriptions" | "get_refund" | "update_payment_preference" | "get_merchant_order" | "search_merchant_orders" | "update_merchant_order" | "get_store" | "update_store" | "delete_store" | "get_pos" | "update_pos" | "delete_pos" | "list_bank_accounts" | "register_bank_account" | "list_point_devices" | "update_point_device_mode" | "create_point_payment_intent" | "get_point_payment_intent" | "cancel_point_payment_intent" | "compute_marketplace_fee" | "explain_payment_status" | "mp_health_check";
 /**
  * Build a tool set for the Vercel AI SDK that exposes Mercado Pago to an
  * agent. Pass directly to `Experimental_Agent`'s `tools` option, or merge with
@@ -1733,12 +1938,26 @@ type ToolName = "create_subscription" | "get_subscription_status" | "cancel_subs
  */
 declare function mercadoPagoTools(client: MercadoPagoClient, options: MercadoPagoToolsOptions): ToolSet;
 
+/**
+ * Webhook helpers — parse incoming MP notifications and verify the
+ * HMAC-SHA256 signature MP sends in the `x-signature` header.
+ *
+ * # Edge Runtime
+ *
+ * Both `verifyWebhookSignature` and `parseWebhookEvent` work in Vercel
+ * Edge Runtime, Cloudflare Workers, Deno, browsers, and Node 18+. The
+ * HMAC verification uses Web Crypto under the hood (see `./crypto.ts`)
+ * and is **async** — make sure to `await` the call.
+ */
+
 /**
  * Parse a Mercado Pago webhook from the raw request body and URL search params.
  * MP sends the topic and resource id in EITHER the URL query string OR the
  * body, depending on integration version — this normalizes both shapes into a
  * single structure.
  *
+ * **Pure function — synchronous, no I/O.**
+ *
  * @example
  * ```ts
  * export async function POST(req: Request) {
@@ -1755,25 +1974,34 @@ declare function parseWebhookEvent(body: unknown, searchParams?: URLSearchParams
 /**
  * Verify the HMAC-SHA256 signature MP sends in the `x-signature` header for
  * webhook authenticity. Returns true if the signature matches the expected
- * value derived from the integration's secret key.
+ * value derived from the integration's secret key AND the timestamp is
+ * within the replay-tolerance window.
+ *
+ * **Async** — runs on Web Crypto under the hood, works in Edge Runtime.
  *
  * @param requestId The value of the `x-request-id` request header.
  * @param dataId The id of the resource the webhook is about (from query or body).
  * @param signatureHeader The full `x-signature` header value MP sent.
  * @param secret Your integration's webhook secret (configured in MP dev panel).
+ * @param replayToleranceSeconds Optional override. Default 300s (5 min).
  *
  * @remarks
  * MP's `x-signature` header has the form: `ts=NNNNNNNN,v1=HEXSIGNATURE`. We
  * extract the timestamp and the v1 signature, then compute
  * `HMAC-SHA256(secret, "id:${dataId};request-id:${requestId};ts:${ts};")`
  * and compare with constant-time equality.
+ *
+ * **Replay protection**: rejects signatures whose `ts` is older than
+ * `replayToleranceSeconds` (default 5min) — prevents an attacker who
+ * captured a valid webhook from replaying it later.
  */
 declare function verifyWebhookSignature(params: {
     requestId: string | null;
     dataId: string;
     signatureHeader: string | null;
     secret: string;
-}): boolean;
+    replayToleranceSeconds?: number;
+}): Promise<boolean>;
 
 /**
  * Mercado Pago OAuth flow — for marketplace integrations where YOUR app
@@ -2079,4 +2307,4 @@ interface PaymentStatusExplanation {
  */
 declare function explainPaymentStatus(payment: Payment): PaymentStatusExplanation;
 
-export { type AccountBalance, type AccountInfo, type AccountMovement, type AutoRecurring, type BankAccount, type CardToken, type CreateCardTokenParams, type CreateCustomerParams, type CreateOrderParams, type CreatePaymentParams, type CreatePointPaymentIntentParams, type CreatePosParams, type CreatePreapprovalParams, type CreatePreferenceParams, type CreateQrPaymentParams, type CreateRefundParams, type CreateStoreParams, type CreateSubscriptionPlanParams, type CreateWebhookParams, type CurrencyId, type Customer, type CustomerCard, type Dispute, type FrequencyType, type IdentificationType, InMemoryStateAdapter, type InstallmentOffer, type Issuer, type MarketplaceFeeRule, type MarketplaceParams, MercadoPagoAccountTypeMismatchError, MercadoPagoAuthError, MercadoPagoAuthorizeForbiddenError, MercadoPagoBackUrlInvalidError, MercadoPagoClient, type MercadoPagoClientOptions, MercadoPagoError, MercadoPagoOverloadedError, MercadoPagoPaymentRejectedError, MercadoPagoRateLimitError, MercadoPagoSelfPaymentError, MercadoPagoTimeoutError, type MercadoPagoToolsOptions, type MerchantOrder, type OAuthToken, type Order, type OrderItem, type OrderStatus, type ParsedWebhookEvent, type Payment, type PaymentMethod, type PaymentStatus, type PaymentStatusExplanation, type PaymentsSearchResult, type PointDevice, type PointPaymentIntent, type PointPaymentIntentState, type Pos, type Preapproval, type PreapprovalStatus, type Preference, type PreferenceItem, type QrOrder, type Refund, type SearchPaymentsParams, type Settlement, type SiteId, type Store, type SubscriptionPayment, type SubscriptionPlan, type SubscriptionStateAdapter, type SubscriptionStateRecord, TEST_CARDS_AR, TEST_PAYERS_AR, type TestCard, type ThreeDSInfo, type ThreeDSStatus, type WebhookBody, type WebhookConfig, type WebhookTopic, analyze3DS, buildAuthorizeUrl, buildTestCardScenario, classifyError, computeMarketplaceFee, exchangeCodeForToken, expirationTimeMs, explainPaymentStatus, isExpiringSoon, mercadoPagoTools, parseWebhookEvent, refreshAccessToken, verifyWebhookSignature };
+export { type AccountBalance, type AccountInfo, type AccountMovement, type AutoRecurring, type BankAccount, type CardToken, CircuitBreaker, type CircuitBreakerOptions, CircuitOpenError, type CircuitState, type CreateCardTokenParams, type CreateCustomerParams, type CreateOrderParams, type CreatePaymentParams, type CreatePointPaymentIntentParams, type CreatePosParams, type CreatePreapprovalParams, type CreatePreferenceParams, type CreateQrPaymentParams, type CreateRefundParams, type CreateStoreParams, type CreateSubscriptionPlanParams, type CreateWebhookParams, type CurrencyId, type Customer, type CustomerCard, type Dispute, type FrequencyType, type IdentificationType, type InstallmentOffer, type Issuer, type MarketplaceFeeRule, type MarketplaceParams, MercadoPagoAccountTypeMismatchError, MercadoPagoAuthError, MercadoPagoAuthorizeForbiddenError, MercadoPagoBackUrlInvalidError, MercadoPagoClient, type MercadoPagoClientOptions, MercadoPagoError, MercadoPagoOverloadedError, MercadoPagoPaymentRejectedError, MercadoPagoRateLimitError, MercadoPagoSelfPaymentError, MercadoPagoTimeoutError, type MercadoPagoToolsOptions, type MerchantOrder, type OAuthToken, type Order, type OrderItem, type OrderStatus, type ParsedWebhookEvent, type Payment, type PaymentMethod, type PaymentStatus, type PaymentStatusExplanation, type PaymentsSearchResult, type PointDevice, type PointPaymentIntent, type PointPaymentIntentState, type Pos, type Preapproval, type PreapprovalStatus, type Preference, type PreferenceItem, type QrOrder, type Refund, type SearchPaymentsParams, type Settlement, type SiteId, type Store, type SubscriptionPayment, type SubscriptionPlan, SubscriptionStateAdapter, TEST_CARDS_AR, TEST_PAYERS_AR, type TestCard, type ThreeDSInfo, type ThreeDSStatus, type WebhookBody, type WebhookConfig, type WebhookTopic, analyze3DS, buildAuthorizeUrl, buildTestCardScenario, classifyError, computeMarketplaceFee, exchangeCodeForToken, expirationTimeMs, explainPaymentStatus, isExpiringSoon, mercadoPagoTools, parseWebhookEvent, refreshAccessToken, verifyWebhookSignature };