@howells/motif-sdk 0.3.0 → 0.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daniel Howells
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -941,6 +941,10 @@ function estimateCost(model, resolution, numImages = 1) {
     if ((model === "banana" || model === "gemini3") && resolution === "4K") {
       return configuredPrice * 2 * numImages;
     }
+    if (model === "banana2") {
+      const multiplier = resolution === "4K" ? 2 : resolution === "2K" ? 1.5 : resolution === "0.5K" ? 0.75 : 1;
+      return configuredPrice * multiplier * numImages;
+    }
     return configuredPrice * numImages;
   }
   switch (model) {
@@ -2252,23 +2256,6 @@ var FAL_TOOLS = {
       output_format: "png"
     }
   },
-  "sam3-1-image": {
-    name: "SAM 3.1 Image",
-    endpoint: "fal-ai/sam-3-1/image",
-    task: "promptable image segmentation",
-    category: "segmentation",
-    description: "Segment image objects with text, point, or box prompts. SAM 3.1 adds Object Multiplex for faster multi-object tracking.",
-    inputKind: "image",
-    inputField: "image_url",
-    outputKeys: ["image", "masks", "metadata", "scores", "boxes"],
-    pricing: "$0.005/request",
-    sourceUrl: "https://fal.ai/models/fal-ai/sam-3-1/image",
-    defaultOptions: {
-      apply_mask: true,
-      max_masks: 3,
-      output_format: "png"
-    }
-  },
   "sam3-image-rle": {
     name: "SAM 3 Image RLE",
     endpoint: "fal-ai/sam-3/image-rle",
@@ -2452,7 +2439,13 @@ var MotifServer = class {
     if (config?.useQueue) {
       return this.generateQueued(options);
     }
-    const { endpoint, body } = buildGenerateBody(options);
+    let built;
+    try {
+      built = buildGenerateBody(options);
+    } catch (error) {
+      return (0, import_neverthrow.err)(toMotifError(error));
+    }
+    const { endpoint, body } = built;
     const response = await this.request(`${FAL_BASE_URL}/${endpoint}`, {
       method: "POST",
       body: JSON.stringify(body),
@@ -2494,7 +2487,13 @@ var MotifServer = class {
   /** ─── Queue-Based Generation ──────────────────────────────── */
   /** Submit a generation to the fal.ai queue (returns immediately). */
   async submitGeneration(options) {
-    const { endpoint, body } = buildGenerateBody(options);
+    let built;
+    try {
+      built = buildGenerateBody(options);
+    } catch (error) {
+      return (0, import_neverthrow.err)(toMotifError(error));
+    }
+    const { endpoint, body } = built;
     const response = await this.request(`${FAL_QUEUE_URL}/${endpoint}`, {
       method: "POST",
       body: JSON.stringify(body),
@@ -2894,6 +2893,14 @@ var MotifError = class extends Error {
     this.code = code;
   }
 };
+function toMotifError(error) {
+  if (error instanceof MotifError) {
+    return error;
+  }
+  const message = error instanceof Error ? error.message : String(error);
+  const code = error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : void 0;
+  return new MotifError(message, 0, code);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ASPECT_RATIOS,

package/dist/index.d.cts

@@ -783,23 +783,6 @@ declare class MotifServer {
                 readonly output_format: "png";
             };
         };
-        readonly "sam3-1-image": {
-            readonly name: "SAM 3.1 Image";
-            readonly endpoint: "fal-ai/sam-3-1/image";
-            readonly task: "promptable image segmentation";
-            readonly category: "segmentation";
-            readonly description: "Segment image objects with text, point, or box prompts. SAM 3.1 adds Object Multiplex for faster multi-object tracking.";
-            readonly inputKind: "image";
-            readonly inputField: "image_url";
-            readonly outputKeys: ["image", "masks", "metadata", "scores", "boxes"];
-            readonly pricing: "$0.005/request";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3-1/image";
-            readonly defaultOptions: {
-                readonly apply_mask: true;
-                readonly max_masks: 3;
-                readonly output_format: "png";
-            };
-        };
         readonly "sam3-image-rle": {
             readonly name: "SAM 3 Image RLE";
             readonly endpoint: "fal-ai/sam-3/image-rle";
@@ -1180,23 +1163,6 @@ declare const FAL_TOOLS: {
             readonly output_format: "png";
         };
     };
-    readonly "sam3-1-image": {
-        readonly name: "SAM 3.1 Image";
-        readonly endpoint: "fal-ai/sam-3-1/image";
-        readonly task: "promptable image segmentation";
-        readonly category: "segmentation";
-        readonly description: "Segment image objects with text, point, or box prompts. SAM 3.1 adds Object Multiplex for faster multi-object tracking.";
-        readonly inputKind: "image";
-        readonly inputField: "image_url";
-        readonly outputKeys: ["image", "masks", "metadata", "scores", "boxes"];
-        readonly pricing: "$0.005/request";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3-1/image";
-        readonly defaultOptions: {
-            readonly apply_mask: true;
-            readonly max_masks: 3;
-            readonly output_format: "png";
-        };
-    };
     readonly "sam3-image-rle": {
         readonly name: "SAM 3 Image RLE";
         readonly endpoint: "fal-ai/sam-3/image-rle";

package/dist/index.d.ts

@@ -783,23 +783,6 @@ declare class MotifServer {
                 readonly output_format: "png";
             };
         };
-        readonly "sam3-1-image": {
-            readonly name: "SAM 3.1 Image";
-            readonly endpoint: "fal-ai/sam-3-1/image";
-            readonly task: "promptable image segmentation";
-            readonly category: "segmentation";
-            readonly description: "Segment image objects with text, point, or box prompts. SAM 3.1 adds Object Multiplex for faster multi-object tracking.";
-            readonly inputKind: "image";
-            readonly inputField: "image_url";
-            readonly outputKeys: ["image", "masks", "metadata", "scores", "boxes"];
-            readonly pricing: "$0.005/request";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3-1/image";
-            readonly defaultOptions: {
-                readonly apply_mask: true;
-                readonly max_masks: 3;
-                readonly output_format: "png";
-            };
-        };
         readonly "sam3-image-rle": {
             readonly name: "SAM 3 Image RLE";
             readonly endpoint: "fal-ai/sam-3/image-rle";
@@ -1180,23 +1163,6 @@ declare const FAL_TOOLS: {
             readonly output_format: "png";
         };
     };
-    readonly "sam3-1-image": {
-        readonly name: "SAM 3.1 Image";
-        readonly endpoint: "fal-ai/sam-3-1/image";
-        readonly task: "promptable image segmentation";
-        readonly category: "segmentation";
-        readonly description: "Segment image objects with text, point, or box prompts. SAM 3.1 adds Object Multiplex for faster multi-object tracking.";
-        readonly inputKind: "image";
-        readonly inputField: "image_url";
-        readonly outputKeys: ["image", "masks", "metadata", "scores", "boxes"];
-        readonly pricing: "$0.005/request";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3-1/image";
-        readonly defaultOptions: {
-            readonly apply_mask: true;
-            readonly max_masks: 3;
-            readonly output_format: "png";
-        };
-    };
     readonly "sam3-image-rle": {
         readonly name: "SAM 3 Image RLE";
         readonly endpoint: "fal-ai/sam-3/image-rle";

package/dist/index.js

@@ -883,6 +883,10 @@ function estimateCost(model, resolution, numImages = 1) {
     if ((model === "banana" || model === "gemini3") && resolution === "4K") {
       return configuredPrice * 2 * numImages;
     }
+    if (model === "banana2") {
+      const multiplier = resolution === "4K" ? 2 : resolution === "2K" ? 1.5 : resolution === "0.5K" ? 0.75 : 1;
+      return configuredPrice * multiplier * numImages;
+    }
     return configuredPrice * numImages;
   }
   switch (model) {
@@ -2194,23 +2198,6 @@ var FAL_TOOLS = {
       output_format: "png"
     }
   },
-  "sam3-1-image": {
-    name: "SAM 3.1 Image",
-    endpoint: "fal-ai/sam-3-1/image",
-    task: "promptable image segmentation",
-    category: "segmentation",
-    description: "Segment image objects with text, point, or box prompts. SAM 3.1 adds Object Multiplex for faster multi-object tracking.",
-    inputKind: "image",
-    inputField: "image_url",
-    outputKeys: ["image", "masks", "metadata", "scores", "boxes"],
-    pricing: "$0.005/request",
-    sourceUrl: "https://fal.ai/models/fal-ai/sam-3-1/image",
-    defaultOptions: {
-      apply_mask: true,
-      max_masks: 3,
-      output_format: "png"
-    }
-  },
   "sam3-image-rle": {
     name: "SAM 3 Image RLE",
     endpoint: "fal-ai/sam-3/image-rle",
@@ -2394,7 +2381,13 @@ var MotifServer = class {
     if (config?.useQueue) {
       return this.generateQueued(options);
     }
-    const { endpoint, body } = buildGenerateBody(options);
+    let built;
+    try {
+      built = buildGenerateBody(options);
+    } catch (error) {
+      return err(toMotifError(error));
+    }
+    const { endpoint, body } = built;
     const response = await this.request(`${FAL_BASE_URL}/${endpoint}`, {
       method: "POST",
       body: JSON.stringify(body),
@@ -2436,7 +2429,13 @@ var MotifServer = class {
   /** ─── Queue-Based Generation ──────────────────────────────── */
   /** Submit a generation to the fal.ai queue (returns immediately). */
   async submitGeneration(options) {
-    const { endpoint, body } = buildGenerateBody(options);
+    let built;
+    try {
+      built = buildGenerateBody(options);
+    } catch (error) {
+      return err(toMotifError(error));
+    }
+    const { endpoint, body } = built;
     const response = await this.request(`${FAL_QUEUE_URL}/${endpoint}`, {
       method: "POST",
       body: JSON.stringify(body),
@@ -2836,6 +2835,14 @@ var MotifError = class extends Error {
     this.code = code;
   }
 };
+function toMotifError(error) {
+  if (error instanceof MotifError) {
+    return error;
+  }
+  const message = error instanceof Error ? error.message : String(error);
+  const code = error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : void 0;
+  return new MotifError(message, 0, code);
+}
 export {
   ASPECT_RATIOS,
   CREATIVE_FIELDS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@howells/motif-sdk",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Public Node SDK for Motif fal.ai generation, editing, utility tools, and model metadata.",
   "license": "MIT",
   "author": "Daniel Howells",
@@ -37,17 +37,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
-    "lint": "howells-lint",
-    "format": "howells-format",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "prepack": "pnpm build"
-  },
   "dependencies": {
     "@howells/envy": "^0.3.7",
     "neverthrow": "^8.2.0",
@@ -61,5 +50,15 @@
     "tsup": "^8.0.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.5"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "lint": "howells-lint",
+    "format": "howells-format",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
   }
-}
+}