@ar-agents/mercadopago 0.17.2 → 0.18.0

package/dist/index.d.cts

@@ -3,6 +3,7 @@ export { L as AutoRecurring, N as CurrencyId, U as FrequencyType, V as Marketpla
 import { I as IdempotencyCache, S as SubscriptionStateAdapter, A as AuditLogger, a as AuditOperation } from './audit-B9Nhj3PH.cjs';
 export { b as AuditEntry, c as AuditLogAdapter, d as InMemoryAuditLog, e as InMemoryIdempotencyCache, f as InMemoryOAuthTokenStore, g as InMemoryStateAdapter, O as OAuthTokenRecord, h as OAuthTokenStore, i as SubscriptionStateRecord } from './audit-B9Nhj3PH.cjs';
 import { ToolSet, Tool } from 'ai';
+import { ArAgentsError } from '@ar-agents/core';
 import 'zod';
 
 /**
@@ -174,12 +175,27 @@ declare class CircuitBreaker {
  * Base class for any error originating from the Mercado Pago integration. All
  * specific error types extend this. Carries the MP HTTP status, the parsed
  * body when available, and the endpoint that failed for debugging.
+ *
+ * Extends `ArAgentsError` from `@ar-agents/core` so the family contract
+ * (code / retryable / context) is uniform across every `@ar-agents/*`
+ * integration. Existing public properties (`status`, `endpoint`,
+ * `mpResponse`) are preserved on the instance AND mirrored into
+ * `context` for callers using the new contract.
+ *
+ * `code` is derived from the MP error type (e.g. `"mp_auth_failed"`,
+ * `"mp_rate_limited"`, `"mp_overloaded"`); the generic surface uses
+ * `"mp_api_error"`. `retryable` defaults to true for 5xx, 429, and
+ * timeouts; false otherwise.
  */
-declare class MercadoPagoError extends Error {
-    status: number;
-    endpoint: string;
-    mpResponse?: unknown | undefined;
-    constructor(message: string, status: number, endpoint: string, mpResponse?: unknown | undefined);
+
+declare class MercadoPagoError extends ArAgentsError {
+    readonly status: number;
+    readonly endpoint: string;
+    readonly mpResponse?: unknown;
+    constructor(message: string, status: number, endpoint: string, mpResponse?: unknown, init?: {
+        code?: string;
+        retryable?: boolean;
+    });
 }
 /**
  * Thrown when the access token is missing, expired, or rejected by MP.

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export { L as AutoRecurring, N as CurrencyId, U as FrequencyType, V as Marketpla
 import { I as IdempotencyCache, S as SubscriptionStateAdapter, A as AuditLogger, a as AuditOperation } from './audit-B9Nhj3PH.js';
 export { b as AuditEntry, c as AuditLogAdapter, d as InMemoryAuditLog, e as InMemoryIdempotencyCache, f as InMemoryOAuthTokenStore, g as InMemoryStateAdapter, O as OAuthTokenRecord, h as OAuthTokenStore, i as SubscriptionStateRecord } from './audit-B9Nhj3PH.js';
 import { ToolSet, Tool } from 'ai';
+import { ArAgentsError } from '@ar-agents/core';
 import 'zod';
 
 /**
@@ -174,12 +175,27 @@ declare class CircuitBreaker {
  * Base class for any error originating from the Mercado Pago integration. All
  * specific error types extend this. Carries the MP HTTP status, the parsed
  * body when available, and the endpoint that failed for debugging.
+ *
+ * Extends `ArAgentsError` from `@ar-agents/core` so the family contract
+ * (code / retryable / context) is uniform across every `@ar-agents/*`
+ * integration. Existing public properties (`status`, `endpoint`,
+ * `mpResponse`) are preserved on the instance AND mirrored into
+ * `context` for callers using the new contract.
+ *
+ * `code` is derived from the MP error type (e.g. `"mp_auth_failed"`,
+ * `"mp_rate_limited"`, `"mp_overloaded"`); the generic surface uses
+ * `"mp_api_error"`. `retryable` defaults to true for 5xx, 429, and
+ * timeouts; false otherwise.
  */
-declare class MercadoPagoError extends Error {
-    status: number;
-    endpoint: string;
-    mpResponse?: unknown | undefined;
-    constructor(message: string, status: number, endpoint: string, mpResponse?: unknown | undefined);
+
+declare class MercadoPagoError extends ArAgentsError {
+    readonly status: number;
+    readonly endpoint: string;
+    readonly mpResponse?: unknown;
+    constructor(message: string, status: number, endpoint: string, mpResponse?: unknown, init?: {
+        code?: string;
+        retryable?: boolean;
+    });
 }
 /**
  * Thrown when the access token is missing, expired, or rejected by MP.

package/dist/index.js

@@ -1,3 +1,4 @@
+import { ArAgentsError } from '@ar-agents/core';
 import { tool } from 'ai';
 import { z } from 'zod';
 
@@ -69,19 +70,25 @@ var init_crypto = __esm({
     encoder = new TextEncoder();
   }
 });
-
-// src/errors.ts
-var MercadoPagoError = class extends Error {
-  constructor(message, status, endpoint, mpResponse) {
-    super(message);
-    this.status = status;
-    this.endpoint = endpoint;
-    this.mpResponse = mpResponse;
-    this.name = "MercadoPagoError";
-  }
+var MercadoPagoError = class extends ArAgentsError {
   status;
   endpoint;
   mpResponse;
+  constructor(message, status, endpoint, mpResponse, init = {}) {
+    super(message, {
+      code: init.code ?? "mp_api_error",
+      retryable: init.retryable ?? (status >= 500 || status === 429 || status === 0),
+      context: {
+        status,
+        endpoint,
+        ...mpResponse !== void 0 ? { mpResponse } : {}
+      }
+    });
+    this.name = "MercadoPagoError";
+    this.status = status;
+    this.endpoint = endpoint;
+    if (mpResponse !== void 0) this.mpResponse = mpResponse;
+  }
 };
 var MercadoPagoAuthError = class extends MercadoPagoError {
   constructor(endpoint, body) {
@@ -89,7 +96,8 @@ var MercadoPagoAuthError = class extends MercadoPagoError {
       "Mercado Pago rejected the request as unauthorized. Check the access token (TEST- prefix for sandbox, APP_USR- for production).",
       401,
       endpoint,
-      body
+      body,
+      { code: "mp_auth_failed", retryable: false }
     );
     this.name = "MercadoPagoAuthError";
   }
@@ -159,7 +167,8 @@ var MercadoPagoRateLimitError = class extends MercadoPagoError {
       `Mercado Pago rate limit hit on ${endpoint}. ${retryAfterSeconds ? `Retry after ${retryAfterSeconds}s.` : "Retry with exponential backoff."}`,
       429,
       endpoint,
-      body
+      body,
+      { code: "mp_rate_limited", retryable: true }
     );
     this.retryAfterSeconds = retryAfterSeconds;
     this.name = "MercadoPagoRateLimitError";
@@ -171,7 +180,9 @@ var MercadoPagoOverloadedError = class extends MercadoPagoError {
     super(
       `Mercado Pago appears overloaded \u2014 returned a non-JSON ${status} response for ${endpoint}. Wait a few seconds and retry.`,
       status,
-      endpoint
+      endpoint,
+      void 0,
+      { code: "mp_overloaded", retryable: true }
     );
     this.name = "MercadoPagoOverloadedError";
   }
@@ -181,7 +192,9 @@ var MercadoPagoTimeoutError = class extends MercadoPagoError {
     super(
       `Mercado Pago request timed out after ${timeoutMs}ms on ${endpoint}. Increase requestTimeoutMs or check connectivity.`,
       0,
-      endpoint
+      endpoint,
+      void 0,
+      { code: "mp_timeout", retryable: true }
     );
     this.timeoutMs = timeoutMs;
     this.name = "MercadoPagoTimeoutError";