@polyphron/viper-react 0.2.1 → 0.4.0

package/dist/runs.js

@@ -0,0 +1,59 @@
+import { useEffect, useState } from "react";
+import { useViper } from "./provider.js";
+/** A run is still going while it runs or waits; done, failed and cancelled are final. */
+function unfinished(run) {
+    return run.status === "running" || run.status === "waiting";
+}
+/**
+ * Watches a background workflow's run until it's done, failed or cancelled, reading
+ * it every `every` milliseconds (a second by default). Pass the
+ * `StartedRun` its call returned; nothing is read while it's empty.
+ *
+ * ```tsx
+ * const [started, setStarted] = useState<StartedRun>()
+ * const { data, pending } = useRun<{ text: string }>("forge", started)
+ * // on click: setStarted(await viper.workflows.call<StartedRun>("forge", input))
+ * // when done: data.response.body.text
+ * ```
+ */
+export function useRun(name, started, options = {}) {
+    const viper = useViper();
+    const every = options.every ?? 1000;
+    const run = started?.run;
+    const token = started?.token;
+    // The answer carries the run it's for, so another run's never shows.
+    const [state, setState] = useState({ key: "", data: null, error: null });
+    useEffect(() => {
+        if (run === undefined || token === undefined)
+            return;
+        const key = `${name}/${run}`;
+        const controller = new AbortController();
+        let timer;
+        const read = async () => {
+            try {
+                const data = await viper.workflows.run(name, { run, token }, { signal: controller.signal });
+                setState({ key, data, error: null });
+                if (unfinished(data)) {
+                    timer = setTimeout(() => void read(), every);
+                }
+            }
+            catch (error) {
+                if (!controller.signal.aborted)
+                    setState({ key, data: null, error });
+            }
+        };
+        void read();
+        return () => {
+            controller.abort();
+            clearTimeout(timer);
+        };
+    }, [viper, name, run, token, every]);
+    const mine = run !== undefined && state.key === `${name}/${run}`;
+    const data = mine ? state.data : null;
+    const error = mine ? state.error : null;
+    return {
+        data,
+        error,
+        pending: run !== undefined && !error && (data === null || unfinished(data)),
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polyphron/viper-react",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "React provider and hooks for the Viper app API.",
   "license": "MIT",
   "type": "module",
@@ -30,7 +30,7 @@
     "typecheck": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@polyphron/viper-client": "^0.2.0",
+    "@polyphron/viper-client": "^0.4.0",
     "@tanstack/db": "0.9.2",
     "@tanstack/react-db": "0.4.1",
     "react": "^18.3.0 || ^19.0.0"
@@ -42,6 +42,7 @@
     "@tanstack/react-db": "0.4.1",
     "@types/node": "^24",
     "@types/react": "^19",
+    "@viper/admin": "*",
     "eslint": "^10",
     "eslint-plugin-react-hooks": "^7.1.1",
     "react": "^19.2.8",