@howells/motif-sdk 0.5.1 → 0.6.0

package/dist/index.cjs

@@ -2305,6 +2305,18 @@ function toHeaderRecord(headers) {
   }
   return headers;
 }
+function requestIdFromBody(text) {
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    return void 0;
+  }
+  if (!isRecord(parsed)) {
+    return void 0;
+  }
+  return asString(parsed.request_id) ?? asString(parsed.requestId) ?? asString(parsed.trace_id);
+}
 
 // src/tools.ts
 var FAL_EXPLORE_CHECKED_AT = "2026-05-12";
@@ -2764,9 +2776,8 @@ var MotifServer = class {
         return await this.getJobResult(job.value.endpoint, job.value.requestId);
       }
       if (status.value.status === "failed") {
-        return (0, import_neverthrow.err)(
-          new MotifError(status.value.error ?? "Queued generation failed", 0)
-        );
+        const message = status.value.error ?? "Queued generation failed";
+        return (0, import_neverthrow.err)(new MotifError(message, 0, void 0, job.value.requestId));
       }
       await new Promise((resolve) => {
         setTimeout(resolve, pollIntervalMs);
@@ -3165,11 +3176,10 @@ var MotifServer = class {
         }
         if (!response.ok) {
           const text = await response.text();
+          const message = `Request failed: ${response.status} ${text}`;
+          const requestId = response.headers.get("x-fal-request-id") ?? requestIdFromBody(text);
           return (0, import_neverthrow.err)(
-            new MotifError(
-              `Request failed: ${response.status} ${text}`,
-              response.status
-            )
+            new MotifError(message, response.status, void 0, requestId)
           );
         }
         return (0, import_neverthrow.ok)(response);
@@ -3229,11 +3239,15 @@ var MotifServer = class {
 var MotifError = class extends Error {
   status;
   code;
-  constructor(message, status, code) {
+  /** fal's request-correlation id (from the `x-fal-request-id` header or the
+   * error body). Ties a failure back to fal's dashboard/support. */
+  requestId;
+  constructor(message, status, code, requestId) {
     super(message);
     this.name = "MotifError";
     this.status = status;
     this.code = code;
+    this.requestId = requestId;
   }
 };
 function toMotifError(error) {

package/dist/index.d.cts

@@ -927,7 +927,10 @@ declare class MotifServer {
 declare class MotifError extends Error {
     readonly status: number;
     readonly code?: string;
-    constructor(message: string, status: number, code?: string);
+    /** fal's request-correlation id (from the `x-fal-request-id` header or the
+     * error body). Ties a failure back to fal's dashboard/support. */
+    readonly requestId?: string;
+    constructor(message: string, status: number, code?: string, requestId?: string);
 }
 
 type FalToolInputKind = "image" | "images" | "video";

package/dist/index.d.ts

@@ -927,7 +927,10 @@ declare class MotifServer {
 declare class MotifError extends Error {
     readonly status: number;
     readonly code?: string;
-    constructor(message: string, status: number, code?: string);
+    /** fal's request-correlation id (from the `x-fal-request-id` header or the
+     * error body). Ties a failure back to fal's dashboard/support. */
+    readonly requestId?: string;
+    constructor(message: string, status: number, code?: string, requestId?: string);
 }
 
 type FalToolInputKind = "image" | "images" | "video";

package/dist/index.js

@@ -2246,6 +2246,18 @@ function toHeaderRecord(headers) {
   }
   return headers;
 }
+function requestIdFromBody(text) {
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    return void 0;
+  }
+  if (!isRecord(parsed)) {
+    return void 0;
+  }
+  return asString(parsed.request_id) ?? asString(parsed.requestId) ?? asString(parsed.trace_id);
+}
 
 // src/tools.ts
 var FAL_EXPLORE_CHECKED_AT = "2026-05-12";
@@ -2705,9 +2717,8 @@ var MotifServer = class {
         return await this.getJobResult(job.value.endpoint, job.value.requestId);
       }
       if (status.value.status === "failed") {
-        return err(
-          new MotifError(status.value.error ?? "Queued generation failed", 0)
-        );
+        const message = status.value.error ?? "Queued generation failed";
+        return err(new MotifError(message, 0, void 0, job.value.requestId));
       }
       await new Promise((resolve) => {
         setTimeout(resolve, pollIntervalMs);
@@ -3106,11 +3117,10 @@ var MotifServer = class {
         }
         if (!response.ok) {
           const text = await response.text();
+          const message = `Request failed: ${response.status} ${text}`;
+          const requestId = response.headers.get("x-fal-request-id") ?? requestIdFromBody(text);
           return err(
-            new MotifError(
-              `Request failed: ${response.status} ${text}`,
-              response.status
-            )
+            new MotifError(message, response.status, void 0, requestId)
           );
         }
         return ok(response);
@@ -3170,11 +3180,15 @@ var MotifServer = class {
 var MotifError = class extends Error {
   status;
   code;
-  constructor(message, status, code) {
+  /** fal's request-correlation id (from the `x-fal-request-id` header or the
+   * error body). Ties a failure back to fal's dashboard/support. */
+  requestId;
+  constructor(message, status, code, requestId) {
     super(message);
     this.name = "MotifError";
     this.status = status;
     this.code = code;
+    this.requestId = requestId;
   }
 };
 function toMotifError(error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@howells/motif-sdk",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Public Node SDK for Motif fal.ai generation, editing, utility tools, and model metadata.",
   "keywords": [
     "fal",