@howells/motif-sdk 5.0.0 → 5.0.1

package/README.md

@@ -32,7 +32,7 @@ console.log(result.value.model, result.value.files[0]?.url, result.value.cost);
 
 Every Task function returns `Result<TaskOutput, MotifError>` from `neverthrow` and does not throw for fal request failures; check `isErr()` / `isOk()`.
 
-Pass `onProgress(status, queuePosition)` to hear fal's queue state while a run waits: `"queued"` with its place in line, then `"in_progress"`, then `"completed"`. Passing it sends the run through fal's queue, since only the queue reports state. Models without streaming report state, not a percentage.
+Pass `onProgress(status, queuePosition)` to hear fal's queue state while a run waits: `"queued"` with its place in line, then `"processing"`, then `"completed"` (or `"failed"`). Passing it sends the run through fal's queue, since only the queue reports state. Models without streaming report state, not a percentage.
 
 ## Plan Without Calling fal
 

package/dist/index.d.cts

@@ -262,6 +262,15 @@ interface ImageSizeBounds {
   /** Both edges must be multiples of this. Motif uses 16 when absent. */
   multipleOf?: number;
 }
+interface JobStatus {
+  error?: string;
+  logs?: {
+    message: string;
+    timestamp: string;
+  }[];
+  queuePosition?: number;
+  status: "queued" | "processing" | "completed" | "failed";
+}
 /** ─── Configuration ──────────────────────────────────────────── */
 /** The network seam: a `fetch`-shaped function. */
 type FalFetch = (url: string, init: RequestInit) => Promise<Response>;
@@ -1189,10 +1198,10 @@ interface TaskInput {
   ephemeral?: boolean;
   /**
    * Called on each poll of fal's queue with its status ("queued",
-   * "in_progress", "completed") and, while queued, the place in line. Passing
+   * "processing", "completed", "failed") and, while queued, the place in line. Passing
    * it runs a fal generation through the queue, since only the queue reports.
    */
-  onProgress?: (status: string, queuePosition?: number) => void;
+  onProgress?: (status: JobStatus["status"], queuePosition?: number) => void;
 }
 interface TaskFile {
   /** Output key the URL came from, e.g. "image", "masks", "model_glb". */

package/dist/index.d.ts

@@ -262,6 +262,15 @@ interface ImageSizeBounds {
   /** Both edges must be multiples of this. Motif uses 16 when absent. */
   multipleOf?: number;
 }
+interface JobStatus {
+  error?: string;
+  logs?: {
+    message: string;
+    timestamp: string;
+  }[];
+  queuePosition?: number;
+  status: "queued" | "processing" | "completed" | "failed";
+}
 /** ─── Configuration ──────────────────────────────────────────── */
 /** The network seam: a `fetch`-shaped function. */
 type FalFetch = (url: string, init: RequestInit) => Promise<Response>;
@@ -1189,10 +1198,10 @@ interface TaskInput {
   ephemeral?: boolean;
   /**
    * Called on each poll of fal's queue with its status ("queued",
-   * "in_progress", "completed") and, while queued, the place in line. Passing
+   * "processing", "completed", "failed") and, while queued, the place in line. Passing
    * it runs a fal generation through the queue, since only the queue reports.
    */
-  onProgress?: (status: string, queuePosition?: number) => void;
+  onProgress?: (status: JobStatus["status"], queuePosition?: number) => void;
 }
 interface TaskFile {
   /** Output key the URL came from, e.g. "image", "masks", "model_glb". */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@howells/motif-sdk",
-  "version": "5.0.0",
+  "version": "5.0.1",
   "description": "Node SDK for Motif: image, video and 3D Tasks on fal.ai, with Motif choosing the Model.",
   "keywords": [
     "fal",