@acedatacloud/sdk 2026.718.0 → 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"
           )) {
@@ -484,6 +491,16 @@ var Chat = class {
 };
 
 // src/runtime/tasks.ts
+function taskStatus(state) {
+  const response = state.response ?? state;
+  if (response.status === "succeeded" || response.status === "failed") return response.status;
+  if (response.status !== void 0 && response.status !== null) return "";
+  const finished = response.finished_at !== void 0 && response.finished_at !== null || state.finished_at !== void 0 && state.finished_at !== null;
+  if (!finished) return "";
+  if (response.success === true) return "succeeded";
+  if (response.success === false) return "failed";
+  return "";
+}
 var TaskHandle = class {
   id;
   pollEndpoint;
@@ -501,8 +518,7 @@ var TaskHandle = class {
   }
   async isCompleted() {
     const state = await this.get();
-    const response = state.response ?? state;
-    const status = response.status;
+    const status = taskStatus(state);
     return status === "succeeded" || status === "failed";
   }
   async wait(opts = {}) {
@@ -511,8 +527,7 @@ var TaskHandle = class {
     const start = Date.now();
     while (Date.now() - start < maxWait) {
       const state = await this.get();
-      const response = state.response ?? state;
-      const status = response.status;
+      const status = taskStatus(state);
       if (status === "succeeded" || status === "failed") {
         this._result = state;
         return state;