@howells/motif-sdk 0.5.1 → 0.7.0

package/dist/index.cjs

@@ -18,8 +18,8 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
-var index_exports = {};
-__export(index_exports, {
+var src_exports = {};
+__export(src_exports, {
   ASPECT_RATIOS: () => ASPECT_RATIOS,
   CREATIVE_FIELDS: () => CREATIVE_FIELDS,
   CREATIVE_TAXONOMY: () => CREATIVE_TAXONOMY,
@@ -57,7 +57,7 @@ __export(index_exports, {
   parseMotifEnv: () => parseMotifEnv,
   sanitizePrompt: () => sanitizePrompt
 });
-module.exports = __toCommonJS(index_exports);
+module.exports = __toCommonJS(src_exports);
 var import_neverthrow2 = require("neverthrow");
 
 // src/aspects.ts
@@ -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.7.0",
   "description": "Public Node SDK for Motif fal.ai generation, editing, utility tools, and model metadata.",
   "keywords": [
     "fal",
@@ -32,13 +32,19 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./image": {
+      "types": "./dist/image.d.ts",
+      "import": "./dist/image.js"
     }
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
+    "@ai-sdk/google": "^4.0.12",
     "@howells/envy": "^0.3.7",
+    "ai": "^7.0.22",
     "neverthrow": "^8.2.0",
     "zod": "^4.4.3"
   },
@@ -52,8 +58,8 @@
     "vitest": "^4.1.10"
   },
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "build": "tsup",
+    "dev": "tsup --watch",
     "lint": "howells-check .",
     "lint:fix": "howells-fix .",
     "typecheck": "tsc --noEmit",