@acedatacloud/sdk 2026.718.1 → 2026.722.0

package/dist/index.d.mts

@@ -3,7 +3,7 @@
  *
  * When the API returns `402 Payment Required`, the transport calls the
  * configured `PaymentHandler` to produce the extra headers (typically
- * `X-Payment`) to attach to the retry. This keeps the SDK free of any
+ * `PAYMENT-SIGNATURE`) to attach to the retry. This keeps the SDK free of any
  * chain-specific signing logic, and lets callers plug in a real x402
  * implementation such as `@acedatacloud/x402-client`.
  */
@@ -11,7 +11,9 @@
 interface PaymentRequirement {
     scheme: string;
     network: string;
-    maxAmountRequired: string;
+    amount?: string;
+    /** @deprecated Legacy challenge field. */
+    maxAmountRequired?: string;
     maxTimeoutSeconds?: number;
     resource?: string;
     description?: string;
@@ -34,7 +36,7 @@ interface PaymentHandlerContext {
 }
 /** Result a payment handler must return. */
 interface PaymentHandlerResult {
-    /** Extra headers to attach to the retry (must include `X-Payment`). */
+    /** Extra headers to attach to the retry (normally `PAYMENT-SIGNATURE`). */
     headers: Record<string, string>;
 }
 /** A callable that signs/settles a payment and returns retry headers. */

package/dist/index.d.ts

@@ -3,7 +3,7 @@
  *
  * When the API returns `402 Payment Required`, the transport calls the
  * configured `PaymentHandler` to produce the extra headers (typically
- * `X-Payment`) to attach to the retry. This keeps the SDK free of any
+ * `PAYMENT-SIGNATURE`) to attach to the retry. This keeps the SDK free of any
  * chain-specific signing logic, and lets callers plug in a real x402
  * implementation such as `@acedatacloud/x402-client`.
  */
@@ -11,7 +11,9 @@
 interface PaymentRequirement {
     scheme: string;
     network: string;
-    maxAmountRequired: string;
+    amount?: string;
+    /** @deprecated Legacy challenge field. */
+    maxAmountRequired?: string;
     maxTimeoutSeconds?: number;
     resource?: string;
     description?: string;
@@ -34,7 +36,7 @@ interface PaymentHandlerContext {
 }
 /** Result a payment handler must return. */
 interface PaymentHandlerResult {
-    /** Extra headers to attach to the retry (must include `X-Payment`). */
+    /** Extra headers to attach to the retry (normally `PAYMENT-SIGNATURE`). */
     headers: Record<string, string>;
 }
 /** A callable that signs/settles a payment and returns retry headers. */

package/dist/index.js

@@ -123,6 +123,23 @@ var TimeoutError = class extends APIError {
 };
 
 // src/runtime/transport.ts
+function parsePaymentRequired(resp, text) {
+  const encoded = resp.headers.get("PAYMENT-REQUIRED");
+  if (encoded) {
+    try {
+      return JSON.parse(atob(encoded));
+    } catch {
+      throw mapError(402, {
+        error: { code: "invalid_402", message: "Invalid PAYMENT-REQUIRED header" }
+      });
+    }
+  }
+  try {
+    return JSON.parse(text);
+  } catch {
+    throw mapError(402, { error: { code: "invalid_402", message: text } });
+  }
+}
 var ERROR_CODE_MAP = {
   invalid_token: AuthenticationError,
   token_expired: AuthenticationError,
@@ -231,12 +248,7 @@ var Transport = class {
         clearTimeout(timer);
         if (resp.status === 402 && this.paymentHandler && !paymentAttempted) {
           const text = await resp.text();
-          let body;
-          try {
-            body = JSON.parse(text);
-          } catch {
-            throw mapError(402, { error: { code: "invalid_402", message: text } });
-          }
+          const body = parsePaymentRequired(resp, text);
           if (!body || typeof body !== "object" || !Array.isArray(body.accepts) || !body.accepts.length || !body.accepts.every(
             (requirement) => requirement !== null && typeof requirement === "object"
           )) {
@@ -312,12 +324,7 @@ var Transport = class {
         }
         if (resp.status === 402 && this.paymentHandler && !paymentAttempted) {
           const text = await resp.text();
-          let body;
-          try {
-            body = JSON.parse(text);
-          } catch {
-            throw mapError(402, { error: { code: "invalid_402", message: text } });
-          }
+          const body = parsePaymentRequired(resp, text);
           if (!body || typeof body !== "object" || !Array.isArray(body.accepts) || !body.accepts.length || !body.accepts.every(
             (requirement) => requirement !== null && typeof requirement === "object"
           )) {