@civitai/blocks-react 0.38.0 → 0.40.0

package/README.md

@@ -27,7 +27,7 @@ your block app and the SDK share a single React tree.
 import { useRef } from 'react';
 import { useBlockContext, useBlockResize, useBuzzWorkflow } from '@civitai/blocks-react';
 import { Button } from '@civitai/blocks-react/ui';
-import type { ModelSlotContext } from '@civitai/app-sdk/blocks';
+import { isModelSlotContext } from '@civitai/app-sdk/blocks';
 
 export function App() {
   const { ready, context, viewer, theme } = useBlockContext();
@@ -36,21 +36,22 @@ export function App() {
   useBlockResize(rootRef);                 // host fits the iframe to content
 
   if (!ready) return <div ref={rootRef}>Loading…</div>;
-  const model = context as ModelSlotContext;
+  // `context` is a union keyed on slotId — narrow with the guard, not a cast.
+  if (!isModelSlotContext(context)) return <div ref={rootRef}>Wrong slot.</div>;
 
   return (
     // GOTCHA #60: set data-theme on YOUR OWN root — the host can't reach into
     // the iframe to set it. Without this any [data-theme="dark"] CSS is dormant.
     <div ref={rootRef} data-theme={theme}>
-      <p>Block for model {model.modelName} ({viewer?.username ?? 'anon'})</p>
+      <p>Block for model {context.modelName} ({viewer ? 'signed in' : 'anon'})</p>
       {/* `/ui` Button — themed by the data-theme above; `loading` disables + shows a spinner */}
       <Button
         loading={status === 'submitting' || status === 'polling'}
         onClick={() =>
           submit({
             kind: 'textToImage',
-            modelId: model.modelId,
-            modelVersionId: model.modelVersionId,
+            modelId: context.modelId,
+            modelVersionId: context.modelVersionId,
             params: { prompt: 'a cat' },
           })
         }
@@ -112,8 +113,35 @@ const { ready, context, viewer, theme, settings, blockId, blockInstanceId, appId
   model-page slots.
 - `viewer` — `ViewerInfo | null` (`null` = anonymous).
 - `theme` — `'light' | 'dark'`. **Set `data-theme={theme}` on your root** (gotcha #60).
+  LIVE: it starts at the `BLOCK_INIT` value and then tracks the host's
+  `THEME_CHANGE` push when the viewer toggles dark mode mid-session — see
+  [`useBlockTheme()`](#useblocktheme).
 - `settings` — `{ publisherSettings, userSettings }`.
 
+### `useBlockTheme()`
+
+The host's CURRENT site theme, and nothing else. Same value as
+`useBlockContext().theme` — reach for this when theme is all you need.
+
+```tsx
+function ThemedRoot() {
+  const theme = useBlockTheme(); // 'light' | 'dark'
+  return <div data-theme={theme}>…</div>;
+}
+```
+
+The viewer can toggle light/dark **while your block is mounted**. The host pushes
+a `THEME_CHANGE` message and this hook re-renders. You get that for free as long
+as you *read* the theme on every render — a block that copies it into state once
+at mount, or writes `data-theme` imperatively in a mount-only effect, will stay
+stuck on the old theme.
+
+Against a host that predates `THEME_CHANGE` the value simply never moves (the
+old behaviour). Nothing awaits the message, so there is no hang either way.
+
+Exercise it locally: `createMockHost(...).setTheme('light')` (and the same on the
+`dev:live` host) pushes the real message.
+
 ### `useBlockResize(ref)`
 
 Attach to your root element. Observes its height and posts `RESIZE_IFRAME` so the

package/dist/hooks/useBlockContext.d.ts

@@ -18,6 +18,12 @@ declare function useTransportSnapshot(): BlockSnapshot;
  * set `data-theme={theme}` on your root, gotcha #60), `blockId`,
  * `blockInstanceId`, and `appId`.
  *
+ * `theme` is LIVE: it starts at the `BLOCK_INIT` (or URL-fragment) value and
+ * then tracks the host's `THEME_CHANGE` push when the viewer toggles light/dark
+ * mid-session. Reading it here is enough — {@link useBlockTheme} is the same
+ * value, narrower. Against a host that never pushes it, the value simply never
+ * moves (today's behaviour).
+ *
  * @example
  * const { ready, context, viewer, theme, settings } = useBlockContext();
  * if (!ready) return <div>Loading…</div>;

package/dist/hooks/useBlockContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useBlockContext.d.ts","sourceRoot":"","sources":["../../src/hooks/useBlockContext.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D;;;GAGG;AACH,iBAAS,oBAAoB,IAAI,aAAa,CAS7C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,IAAI,IAAI,CACrC,aAAa,EACX,OAAO,GACP,YAAY,GACZ,SAAS,GACT,OAAO,GACP,UAAU,GACV,QAAQ,GACR,OAAO,GACP,SAAS,GACT,iBAAiB,GACjB,OAAO,CACV,CAcA;AAED,6EAA6E;AAC7E,OAAO,EAAE,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"useBlockContext.d.ts","sourceRoot":"","sources":["../../src/hooks/useBlockContext.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D;;;GAGG;AACH,iBAAS,oBAAoB,IAAI,aAAa,CAS7C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,eAAe,IAAI,IAAI,CACrC,aAAa,EACX,OAAO,GACP,YAAY,GACZ,SAAS,GACT,OAAO,GACP,UAAU,GACV,QAAQ,GACR,OAAO,GACP,SAAS,GACT,iBAAiB,GACjB,OAAO,CACV,CAcA;AAED,6EAA6E;AAC7E,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/hooks/useBlockContext.js

@@ -25,6 +25,12 @@ function useTransportSnapshot() {
  * set `data-theme={theme}` on your root, gotcha #60), `blockId`,
  * `blockInstanceId`, and `appId`.
  *
+ * `theme` is LIVE: it starts at the `BLOCK_INIT` (or URL-fragment) value and
+ * then tracks the host's `THEME_CHANGE` push when the viewer toggles light/dark
+ * mid-session. Reading it here is enough — {@link useBlockTheme} is the same
+ * value, narrower. Against a host that never pushes it, the value simply never
+ * moves (today's behaviour).
+ *
  * @example
  * const { ready, context, viewer, theme, settings } = useBlockContext();
  * if (!ready) return <div>Loading…</div>;

package/dist/hooks/useBlockContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"useBlockContext.js","sourceRoot":"","sources":["../../src/hooks/useBlockContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;;GAGG;AACH,SAAS,oBAAoB;IAC3B,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,OAAO,oBAAoB,CACzB,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,EAC/B,GAAG,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE;IAC7B,iEAAiE;IACjE,mEAAmE;IACnE,GAAG,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,CAC9B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,eAAe;IAa7B,MAAM,IAAI,GAAG,oBAAoB,EAAE,CAAC;IACpC,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,OAAO,EAAE,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"useBlockContext.js","sourceRoot":"","sources":["../../src/hooks/useBlockContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;;GAGG;AACH,SAAS,oBAAoB;IAC3B,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,OAAO,oBAAoB,CACzB,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,EAC/B,GAAG,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE;IAC7B,iEAAiE;IACjE,mEAAmE;IACnE,GAAG,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,CAC9B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,eAAe;IAa7B,MAAM,IAAI,GAAG,oBAAoB,EAAE,CAAC;IACpC,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/hooks/useBlockTheme.d.ts

@@ -0,0 +1,39 @@
+import type { Theme } from '@civitai/app-sdk/blocks';
+/**
+ * The host's CURRENT site theme (`'light' | 'dark'`), kept live for the whole
+ * life of the block ON THE IFRAME TRANSPORT.
+ *
+ * Reads the SAME singleton transport snapshot {@link useBlockContext} does, so
+ * it re-renders when the value changes. Three things can set it, in increasing
+ * order of authority:
+ *
+ *  1. the iframe URL fragment fast path (`#civitai-block=v1&theme=…`), read
+ *     synchronously at construction, BEFORE any message — this is why a block
+ *     can paint its first frame in the right theme;
+ *  2. `BLOCK_INIT` (authoritative — replaces the whole snapshot);
+ *  3. `THEME_CHANGE`, the host's push when the viewer toggles light/dark WHILE
+ *     the block is mounted. Without it a mounted block kept its mount-time
+ *     theme until reloaded: `BLOCK_INIT` is deduped by the transport and the
+ *     URL fragment is frozen at mount, so neither can carry a later value.
+ *
+ * BEFORE `BLOCK_INIT` (and with no fragment) this returns the snapshot's
+ * `'light'` sentinel, exactly like `useBlockContext().theme`. Gate first paint
+ * on `useBlockContext().ready` if that matters to you.
+ *
+ * 🔴 OLD HOST: a host that never sends `THEME_CHANGE` simply never moves the
+ * value — the hook degrades to today's mount-time-constant behaviour. Nothing
+ * here awaits a message, so there is no hang and no timeout.
+ *
+ * 🔴 INLINE TRANSPORT: the value is FROZEN at the bootstrap theme. v1 inline
+ * mode receives no host pushes at all (`InlineTransport.onMessage` is a stub and
+ * `subscribe` is a no-op, so nothing can emit), exactly the way
+ * {@link useBlockResize} is a no-op there. Same degradation as an old host —
+ * correct first paint, no live toggle — and it lifts when v2 inline mode lands.
+ *
+ * @example
+ * // The host cannot reach into your iframe's DOM — put the theme on YOUR root.
+ * const theme = useBlockTheme();
+ * return <div data-theme={theme}>…</div>;
+ */
+export declare function useBlockTheme(): Theme;
+//# sourceMappingURL=useBlockTheme.d.ts.map

package/dist/hooks/useBlockTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBlockTheme.d.ts","sourceRoot":"","sources":["../../src/hooks/useBlockTheme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAIrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,aAAa,IAAI,KAAK,CAErC"}

package/dist/hooks/useBlockTheme.js

@@ -0,0 +1,41 @@
+import { useTransportSnapshot } from './useBlockContext.js';
+/**
+ * The host's CURRENT site theme (`'light' | 'dark'`), kept live for the whole
+ * life of the block ON THE IFRAME TRANSPORT.
+ *
+ * Reads the SAME singleton transport snapshot {@link useBlockContext} does, so
+ * it re-renders when the value changes. Three things can set it, in increasing
+ * order of authority:
+ *
+ *  1. the iframe URL fragment fast path (`#civitai-block=v1&theme=…`), read
+ *     synchronously at construction, BEFORE any message — this is why a block
+ *     can paint its first frame in the right theme;
+ *  2. `BLOCK_INIT` (authoritative — replaces the whole snapshot);
+ *  3. `THEME_CHANGE`, the host's push when the viewer toggles light/dark WHILE
+ *     the block is mounted. Without it a mounted block kept its mount-time
+ *     theme until reloaded: `BLOCK_INIT` is deduped by the transport and the
+ *     URL fragment is frozen at mount, so neither can carry a later value.
+ *
+ * BEFORE `BLOCK_INIT` (and with no fragment) this returns the snapshot's
+ * `'light'` sentinel, exactly like `useBlockContext().theme`. Gate first paint
+ * on `useBlockContext().ready` if that matters to you.
+ *
+ * 🔴 OLD HOST: a host that never sends `THEME_CHANGE` simply never moves the
+ * value — the hook degrades to today's mount-time-constant behaviour. Nothing
+ * here awaits a message, so there is no hang and no timeout.
+ *
+ * 🔴 INLINE TRANSPORT: the value is FROZEN at the bootstrap theme. v1 inline
+ * mode receives no host pushes at all (`InlineTransport.onMessage` is a stub and
+ * `subscribe` is a no-op, so nothing can emit), exactly the way
+ * {@link useBlockResize} is a no-op there. Same degradation as an old host —
+ * correct first paint, no live toggle — and it lifts when v2 inline mode lands.
+ *
+ * @example
+ * // The host cannot reach into your iframe's DOM — put the theme on YOUR root.
+ * const theme = useBlockTheme();
+ * return <div data-theme={theme}>…</div>;
+ */
+export function useBlockTheme() {
+    return useTransportSnapshot().theme;
+}
+//# sourceMappingURL=useBlockTheme.js.map

package/dist/hooks/useBlockTheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBlockTheme.js","sourceRoot":"","sources":["../../src/hooks/useBlockTheme.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,oBAAoB,EAAE,CAAC,KAAK,CAAC;AACtC,CAAC"}

package/dist/hooks/useBuzzWorkflow.d.ts

@@ -1,4 +1,76 @@
 import type { BlockWorkflowSnapshot, WorkflowBody, WorkflowStatus } from '@civitai/app-sdk/blocks';
+/**
+ * Default orchestrator-side hold per {@link UseBuzzWorkflowReturn.watch} poll,
+ * in SECONDS.
+ *
+ * 🔴 THE UNIT IS SECONDS, matching the orchestrator's `?wait=` parameter — not
+ * the milliseconds every other timing option in this file uses. Named
+ * `waitSeconds` everywhere for exactly that reason.
+ *
+ * 15 rather than something larger for two reasons, both of them ceilings this
+ * value must stay UNDER, not preferences:
+ *   - civitai's shared `getWorkflow` helper aborts a single orchestrator read at
+ *     20s. A hold at or above that is cancelled by our own backstop before the
+ *     orchestrator can answer.
+ *   - the host's poll additionally runs an inline output-moderation scan with
+ *     its own ~12s ceiling, and the two are SEQUENTIAL — so the round trip's
+ *     worst case is 15 + 12 = 27s, which must stay inside the host's own
+ *     end-to-end response budget.
+ */
+export declare const DEFAULT_WATCH_WAIT_SECONDS = 15;
+/** Optional controls for {@link UseBuzzWorkflowReturn.watch}. */
+export interface WatchWorkflowOptions {
+    /**
+     * Called with EVERY snapshot the host returns, intermediate ones included, in
+     * order. This is the push side of the API: render from here instead of
+     * re-reading `result` on a timer.
+     *
+     * A throw from this callback is not caught — it rejects the `watch` promise.
+     */
+    onUpdate?: (snapshot: BlockWorkflowSnapshot) => void;
+    /**
+     * Stop watching. The promise RESOLVES with the last snapshot seen rather than
+     * rejecting: an abort is the caller's own decision, not a failure, and the
+     * common case (a component unmounting) has nobody left to catch a rejection.
+     *
+     * 🔴 This does NOT cancel the workflow — it stops watching it. Buzz is already
+     * spent and the orchestrator keeps running. To actually stop the work, call
+     * {@link UseBuzzWorkflowReturn.cancel}.
+     */
+    signal?: AbortSignal;
+    /**
+     * Orchestrator-side hold per poll, in **seconds**. Default
+     * {@link DEFAULT_WATCH_WAIT_SECONDS}. `0` disables long polling and falls back
+     * to a plain read per `intervalMs`.
+     *
+     * 🔴 CURRENTLY ADVISORY. It travels on the `POLL_WORKFLOW` message and a host
+     * that does not yet read the field simply answers immediately, exactly as
+     * today — so `watch` is correct either way, it just polls more often. See the
+     * field's note on `BlockToParentMessage`.
+     */
+    waitSeconds?: number;
+    /**
+     * Delay between polls, in ms. Default 1500.
+     *
+     * 🔴 NOT REDUNDANT WITH `waitSeconds`. When the host long-polls, the hold
+     * dominates and this is a few percent of overhead. When it does NOT — an
+     * older host, or `waitSeconds: 0` — this is the only thing standing between
+     * this loop and a request storm.
+     */
+    intervalMs?: number;
+    /** Give up and resolve with the last snapshot after this long. Default 10min. */
+    timeoutMs?: number;
+    /**
+     * Consecutive transport failures to absorb before rejecting. Default 3.
+     *
+     * A poll can fail for reasons that have nothing to do with the workflow (a
+     * pod rolling, a network blip). Because `watch` OWNS the loop, a single blip
+     * would otherwise end a generation the caller's own retry loop used to
+     * survive. The counter RESETS on any successful poll, so this bounds a burst,
+     * not a lifetime.
+     */
+    maxRetries?: number;
+}
 /** Optional per-submit controls. */
 export interface SubmitWorkflowOptions {
     /**
@@ -13,7 +85,37 @@ export interface SubmitWorkflowOptions {
 interface UseBuzzWorkflowReturn {
     estimate: (body: WorkflowBody) => Promise<BlockWorkflowSnapshot>;
     submit: (body: WorkflowBody, options?: SubmitWorkflowOptions) => Promise<BlockWorkflowSnapshot>;
+    /**
+     * ONE host round-trip. The low-level pull primitive — you almost certainly
+     * want {@link UseBuzzWorkflowReturn.watch} instead, which owns the loop.
+     */
     poll: (workflowId: string) => Promise<BlockWorkflowSnapshot>;
+    /**
+     * Watch a workflow to completion. Resolves with the TERMINAL snapshot; calls
+     * `onUpdate` with every intermediate snapshot along the way.
+     *
+     * This is the replacement for the `useEffect` + `setTimeout` backoff every
+     * block used to hand-write around {@link UseBuzzWorkflowReturn.poll}. The app
+     * consumes a promise and/or a callback; the loop lives here.
+     *
+     * 🔴 THE LOOP IS SEQUENTIAL AND NON-OVERLAPPING BY CONSTRUCTION — each poll is
+     * awaited before the next is scheduled, so exactly one request per watched
+     * workflow is ever in flight. That is not tidiness: it is the property that
+     * makes a long hold SAFE. A caller-written `setInterval(poll, 2000)` against
+     * a host holding 15s would stack ~7 concurrent requests per workflow, and
+     * that is precisely why long polling is opt-in on the wire rather than
+     * switched on for every deployed block.
+     *
+     * @example
+     * const { submit, watch, cancel } = useBuzzWorkflow();
+     * const submitted = await submit(body);
+     * const done = await watch(submitted.workflowId, {
+     *   onUpdate: (snap) => setProgress(snap.status),
+     *   signal: abortRef.current.signal,
+     * });
+     * if (done.status === 'succeeded') setImages(done.imageUrls ?? []);
+     */
+    watch: (workflowId: string, options?: WatchWorkflowOptions) => Promise<BlockWorkflowSnapshot>;
     /**
      * Cancel a running workflow on the orchestrator (a real server-side stop,
      * not just client-side untracking). The host re-derives ownership from the
@@ -35,22 +137,29 @@ interface UseBuzzWorkflowReturn {
  * refuses. Block apps should call `useBuzzPurchase().openPurchaseModal()`
  * when that happens.
  *
- * The hook does NOT auto-poll: after `submit` flips `status` to `'polling'`,
- * the caller runs a `useEffect` that calls `poll(workflowId)` on a backoff
- * until the snapshot is terminal. `status === 'confirming'` is IDLE (estimate
- * landed, user reviewing cost) — keep the Generate button enabled.
+ * AFTER `submit` FLIPS `status` TO `'polling'`, USE `watch(workflowId)`. It owns
+ * the loop, resolves on the terminal snapshot, and pushes every intermediate
+ * one to an `onUpdate` callback — so a block consumes a promise/callback rather
+ * than running its own timer. `poll(workflowId)` remains the single-round-trip
+ * primitive for callers that genuinely want to drive their own cadence; the
+ * hand-written `useEffect` + backoff around it that this docstring used to
+ * prescribe is no longer the recommended shape. `status === 'confirming'` is
+ * IDLE (estimate landed, user reviewing cost) — keep the Generate button
+ * enabled.
  *
  * `estimate`/`submit` take a full {@link WorkflowBody} — the discriminated
- * union keyed by `kind`, so either a `textToImage` body (`{ kind, modelId,
- * modelVersionId, params }`) or a `customComfy` recipe body (`{ kind, recipe,
- * params }`), not a bare `{ prompt }`. The hook forwards the body to the host
- * verbatim and never reads variant-specific fields, so both members flow
- * through unchanged.
+ * union keyed by `kind`, with THREE members as of `@civitai/app-sdk@0.30.0`:
+ * a `textToImage` body (`{ kind, modelId, modelVersionId, params }`), a
+ * `customComfy` recipe body (`{ kind, recipe, params }`), or a `step` body
+ * (`{ kind: 'step', step, params }` — a server-registered orchestrator step
+ * such as `'chat-completion'`), never a bare `{ prompt }`. The hook forwards
+ * the body to the host verbatim and never reads variant-specific fields, so
+ * every member flows through unchanged, including any member added later.
  *
- * @returns `{ estimate, submit, poll, cancel, status, result, error }`.
+ * @returns `{ estimate, submit, poll, watch, cancel, status, result, error }`.
  *
  * @example
- * const { estimate, submit, poll, status, result } = useBuzzWorkflow();
+ * const { estimate, submit, watch, status, result } = useBuzzWorkflow();
  * const body = {
  *   kind: 'textToImage' as const,
  *   modelId,
@@ -59,7 +168,7 @@ interface UseBuzzWorkflowReturn {
  * };
  * await estimate(body);            // status 'estimating' → 'confirming' (cost in result.cost.total)
  * const snap = await submit(body); // status 'submitting' → 'polling'; returns a workflowId
- * await poll(snap.workflowId);     // caller loops this on a backoff until terminal
+ * const done = await watch(snap.workflowId, { onUpdate: render }); // → terminal
  */
 export declare function useBuzzWorkflow(): UseBuzzWorkflowReturn;
 export {};

package/dist/hooks/useBuzzWorkflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useBuzzWorkflow.d.ts","sourceRoot":"","sources":["../../src/hooks/useBuzzWorkflow.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AA8BnG,oCAAoC;AACpC,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,qBAAqB;IAC7B,QAAQ,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACjE,MAAM,EAAE,CACN,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE,qBAAqB,KAC5B,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACpC,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC7D;;;;;;OAMG;IACH,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC/D,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACrC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,eAAe,IAAI,qBAAqB,CA0FvD"}
+{"version":3,"file":"useBuzzWorkflow.d.ts","sourceRoot":"","sources":["../../src/hooks/useBuzzWorkflow.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AA8BnG;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAW7C,iEAAiE;AACjE,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACrD;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAyBD,oCAAoC;AACpC,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,qBAAqB;IAC7B,QAAQ,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACjE,MAAM,EAAE,CACN,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE,qBAAqB,KAC5B,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACpC;;;OAGG;IACH,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC7D;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,KAAK,EAAE,CACL,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,oBAAoB,KAC3B,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACpC;;;;;;OAMG;IACH,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC/D,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACrC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,eAAe,IAAI,qBAAqB,CA+MvD"}

package/dist/hooks/useBuzzWorkflow.js

@@ -24,6 +24,54 @@ const TERMINAL_STATUSES = new Set([
  * a spurious `request "SUBMIT_WORKFLOW" timed out` rejection.
  */
 const WORKFLOW_REQUEST_TIMEOUT_MS = 120_000;
+/**
+ * Default orchestrator-side hold per {@link UseBuzzWorkflowReturn.watch} poll,
+ * in SECONDS.
+ *
+ * 🔴 THE UNIT IS SECONDS, matching the orchestrator's `?wait=` parameter — not
+ * the milliseconds every other timing option in this file uses. Named
+ * `waitSeconds` everywhere for exactly that reason.
+ *
+ * 15 rather than something larger for two reasons, both of them ceilings this
+ * value must stay UNDER, not preferences:
+ *   - civitai's shared `getWorkflow` helper aborts a single orchestrator read at
+ *     20s. A hold at or above that is cancelled by our own backstop before the
+ *     orchestrator can answer.
+ *   - the host's poll additionally runs an inline output-moderation scan with
+ *     its own ~12s ceiling, and the two are SEQUENTIAL — so the round trip's
+ *     worst case is 15 + 12 = 27s, which must stay inside the host's own
+ *     end-to-end response budget.
+ */
+export const DEFAULT_WATCH_WAIT_SECONDS = 15;
+/** Gap between `watch` polls, in ms. See {@link WatchWorkflowOptions.intervalMs}. */
+const DEFAULT_WATCH_INTERVAL_MS = 1_500;
+/** Total `watch` budget, in ms. Generation can legitimately take minutes. */
+const DEFAULT_WATCH_TIMEOUT_MS = 10 * 60_000;
+/** How many CONSECUTIVE transport failures `watch` absorbs before rejecting. */
+const DEFAULT_WATCH_MAX_RETRIES = 3;
+/**
+ * Sleep, waking EARLY if `signal` aborts.
+ *
+ * 🔴 A PLAIN `setTimeout` WOULD MAKE ABORT LATENCY EQUAL THE POLL INTERVAL. A
+ * component unmounting mid-gap would keep a pending timer alive for up to
+ * `intervalMs` and only then notice, which is exactly the "unmounted component
+ * kept working" shape an abort signal exists to prevent. The listener is always
+ * removed, so an abort long after the sleep resolved cannot fire into a
+ * finished loop.
+ */
+function sleep(ms, signal) {
+    if (signal?.aborted)
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        const done = () => {
+            clearTimeout(timer);
+            signal?.removeEventListener('abort', done);
+            resolve();
+        };
+        const timer = setTimeout(done, ms);
+        signal?.addEventListener('abort', done);
+    });
+}
 /**
  * Orchestrates the estimate → confirm → submit → poll dance through the
  * host-mediated `postMessage` path.
@@ -33,22 +81,29 @@ const WORKFLOW_REQUEST_TIMEOUT_MS = 120_000;
  * refuses. Block apps should call `useBuzzPurchase().openPurchaseModal()`
  * when that happens.
  *
- * The hook does NOT auto-poll: after `submit` flips `status` to `'polling'`,
- * the caller runs a `useEffect` that calls `poll(workflowId)` on a backoff
- * until the snapshot is terminal. `status === 'confirming'` is IDLE (estimate
- * landed, user reviewing cost) — keep the Generate button enabled.
+ * AFTER `submit` FLIPS `status` TO `'polling'`, USE `watch(workflowId)`. It owns
+ * the loop, resolves on the terminal snapshot, and pushes every intermediate
+ * one to an `onUpdate` callback — so a block consumes a promise/callback rather
+ * than running its own timer. `poll(workflowId)` remains the single-round-trip
+ * primitive for callers that genuinely want to drive their own cadence; the
+ * hand-written `useEffect` + backoff around it that this docstring used to
+ * prescribe is no longer the recommended shape. `status === 'confirming'` is
+ * IDLE (estimate landed, user reviewing cost) — keep the Generate button
+ * enabled.
  *
  * `estimate`/`submit` take a full {@link WorkflowBody} — the discriminated
- * union keyed by `kind`, so either a `textToImage` body (`{ kind, modelId,
- * modelVersionId, params }`) or a `customComfy` recipe body (`{ kind, recipe,
- * params }`), not a bare `{ prompt }`. The hook forwards the body to the host
- * verbatim and never reads variant-specific fields, so both members flow
- * through unchanged.
+ * union keyed by `kind`, with THREE members as of `@civitai/app-sdk@0.30.0`:
+ * a `textToImage` body (`{ kind, modelId, modelVersionId, params }`), a
+ * `customComfy` recipe body (`{ kind, recipe, params }`), or a `step` body
+ * (`{ kind: 'step', step, params }` — a server-registered orchestrator step
+ * such as `'chat-completion'`), never a bare `{ prompt }`. The hook forwards
+ * the body to the host verbatim and never reads variant-specific fields, so
+ * every member flows through unchanged, including any member added later.
  *
- * @returns `{ estimate, submit, poll, cancel, status, result, error }`.
+ * @returns `{ estimate, submit, poll, watch, cancel, status, result, error }`.
  *
  * @example
- * const { estimate, submit, poll, status, result } = useBuzzWorkflow();
+ * const { estimate, submit, watch, status, result } = useBuzzWorkflow();
  * const body = {
  *   kind: 'textToImage' as const,
  *   modelId,
@@ -57,7 +112,7 @@ const WORKFLOW_REQUEST_TIMEOUT_MS = 120_000;
  * };
  * await estimate(body);            // status 'estimating' → 'confirming' (cost in result.cost.total)
  * const snap = await submit(body); // status 'submitting' → 'polling'; returns a workflowId
- * await poll(snap.workflowId);     // caller loops this on a backoff until terminal
+ * const done = await watch(snap.workflowId, { onUpdate: render }); // → terminal
  */
 export function useBuzzWorkflow() {
     const [status, setStatus] = useState('idle');
@@ -96,10 +151,45 @@ export function useBuzzWorkflow() {
             throw err;
         }
     }, []);
+    /**
+     * ONE poll round-trip, with an optional long-poll hint. The single place that
+     * builds a `POLL_WORKFLOW` message, so `poll` and `watch` cannot drift on the
+     * message shape or the request timeout.
+     */
+    const pollOnce = useCallback(async (workflowId, waitSeconds) => {
+        const { snapshot } = await sendTypedRequest(getTransport(), {
+            type: 'POLL_WORKFLOW',
+            payload: {
+                workflowId,
+                // Omitted rather than sent as 0 when long polling is off, so the
+                // message stays byte-identical to what pre-`watch` blocks send.
+                ...(waitSeconds !== undefined && waitSeconds > 0 ? { waitSeconds } : {}),
+            },
+        }, 'WORKFLOW_STATUS', { timeoutMs: WORKFLOW_REQUEST_TIMEOUT_MS });
+        // A reply without a usable snapshot is a failure, not a result: returning
+        // `undefined` would make `poll` resolve with a non-snapshot, and would
+        // make `watch` — whose stop condition is
+        // `TERMINAL_STATUSES.has(snapshot.status)` — loop to its timeout against a
+        // host that is answering with nothing. Throwing routes it into `watch`'s
+        // bounded retry instead.
+        //
+        // 🔴 NOT CLAIMED TO BE REACHABLE THROUGH `IframeTransport`, WHICH ALREADY
+        // FAIL-CLOSES THIS. Its `payloadValidatorFor('WORKFLOW_STATUS')`
+        // (internal/validate.ts) drops a reply whose `snapshot.status` is absent
+        // or outside the known set, so the request never resolves at all and
+        // times out instead. This guard covers the OTHER transports
+        // `sendTypedRequest` accepts (mock/test hosts, `dev:live`), and is kept as
+        // cheap defence — do not cite it as validated input handling on the
+        // iframe path.
+        if (!snapshot || typeof snapshot.status !== 'string') {
+            throw new Error(`POLL_WORKFLOW: malformed response (no snapshot) for ${workflowId}`);
+        }
+        return snapshot;
+    }, []);
     const poll = useCallback(async (workflowId) => {
         setStatus('polling');
         try {
-            const { snapshot } = await sendTypedRequest(getTransport(), { type: 'POLL_WORKFLOW', payload: { workflowId } }, 'WORKFLOW_STATUS', { timeoutMs: WORKFLOW_REQUEST_TIMEOUT_MS });
+            const snapshot = await pollOnce(workflowId);
             setResult(snapshot);
             if (TERMINAL_STATUSES.has(snapshot.status)) {
                 setStatus('done');
@@ -111,7 +201,75 @@ export function useBuzzWorkflow() {
             setStatus('error');
             throw err;
         }
-    }, []);
+    }, [pollOnce]);
+    const watch = useCallback(async (workflowId, options) => {
+        const interval = options?.intervalMs ?? DEFAULT_WATCH_INTERVAL_MS;
+        const waitSeconds = options?.waitSeconds ?? DEFAULT_WATCH_WAIT_SECONDS;
+        const maxRetries = options?.maxRetries ?? DEFAULT_WATCH_MAX_RETRIES;
+        const deadline = Date.now() + (options?.timeoutMs ?? DEFAULT_WATCH_TIMEOUT_MS);
+        setError(null);
+        setStatus('polling');
+        let last = null;
+        let consecutiveFailures = 0;
+        // 🔴 SEQUENTIAL BY CONSTRUCTION. Every iteration AWAITS its poll before
+        // scheduling the next, so at most one request per watched workflow is
+        // ever in flight no matter how long the host holds it. A timer-driven
+        // caller cannot make that guarantee, which is why long polling is
+        // requested here and not enabled globally.
+        for (;;) {
+            if (options?.signal?.aborted)
+                break;
+            let snapshot;
+            try {
+                snapshot = await pollOnce(workflowId, waitSeconds);
+                consecutiveFailures = 0;
+            }
+            catch (err) {
+                // A blip is not the end of a generation. `watch` owns the loop, so a
+                // single transport failure would otherwise kill a run that a
+                // caller-written retry loop used to survive.
+                consecutiveFailures += 1;
+                if (consecutiveFailures > maxRetries || Date.now() >= deadline) {
+                    setError(err);
+                    setStatus('error');
+                    throw err;
+                }
+                await sleep(interval, options?.signal);
+                continue;
+            }
+            last = snapshot;
+            setResult(snapshot);
+            // 🔴 `onUpdate` RECEIVES THE SNAPSHOT AS AN ARGUMENT AND MUST USE IT.
+            // `setResult` above is a React state update, so it is NOT visible to a
+            // callback reading the hook's `result` in this same tick — that reads
+            // the PREVIOUS render's value. The argument is the current one; the
+            // hook state catches up on the next render.
+            //
+            // A throw here propagates deliberately — swallowing a consumer's error
+            // would leave the loop spinning against a broken consumer.
+            options?.onUpdate?.(snapshot);
+            if (TERMINAL_STATUSES.has(snapshot.status)) {
+                setStatus('done');
+                return snapshot;
+            }
+            // Budget exhausted: resolve with what we have rather than throwing. A
+            // non-terminal result is a legitimate answer ("still running"), and the
+            // caller can tell the difference by reading `.status`.
+            if (Date.now() + interval >= deadline)
+                break;
+            await sleep(interval, options?.signal);
+        }
+        // Aborted or timed out with a snapshot in hand — resolve with it.
+        if (last)
+            return last;
+        // 🔴 NO SNAPSHOT AT ALL. Only reachable when the signal was ALREADY
+        // aborted on entry. Rejecting is the only honest option: there is nothing
+        // to resolve with, and issuing a poll here would make a request the
+        // caller explicitly asked us not to make.
+        const aborted = new Error(`watch(${workflowId}) aborted before any snapshot`);
+        aborted.name = 'AbortError';
+        throw aborted;
+    }, [pollOnce]);
     const cancel = useCallback(async (workflowId) => {
         try {
             const { snapshot } = await sendTypedRequest(getTransport(), { type: 'CANCEL_WORKFLOW', payload: { workflowId } }, 'WORKFLOW_CANCELED', { timeoutMs: WORKFLOW_REQUEST_TIMEOUT_MS });
@@ -127,6 +285,6 @@ export function useBuzzWorkflow() {
             throw err;
         }
     }, []);
-    return { estimate, submit, poll, cancel, status, result, error };
+    return { estimate, submit, poll, watch, cancel, status, result, error };
 }
 //# sourceMappingURL=useBuzzWorkflow.js.map

package/dist/hooks/useBuzzWorkflow.js.map

@@ -1 +1 @@
-{"version":3,"file":"useBuzzWorkflow.js","sourceRoot":"","sources":["../../src/hooks/useBuzzWorkflow.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useBuzzWorkflow.js","sourceRoot":"","sources":["../../src/hooks/useBuzzWorkflow.ts"],"names":[],"mappings":"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"}