better-supabase 0.8.0 → 0.9.0

package/dist/blocks/workflow-builder/react/index.js

@@ -1,10 +1,11 @@
 "use client";
-import { i as useAuth, l as useSupabase } from "../../../hooks-Bhza9Hnr.js";
-import { r as rpcTransport } from "../../../block-transport-bAKh-dGc.js";
-import { t as watchTopic } from "../../../react-topic-seAWjL3_.js";
-import { t as createWorkflows } from "../../../workflows-IvxzG2cl.js";
-import { t as createBuilder } from "../../../workflow-builder-CHqHpAVt.js";
-import { useCallback, useEffect, useMemo, useState } from "react";
+import { r as rpcTransport } from "../../../block-transport-G4t1umrR.js";
+import { t as useController } from "../../../react-controller-Xn-IU44p.js";
+import { t as useBlockEnv } from "../../../react-env-Cc7Vf6eb.js";
+import { t as createWorkflows } from "../../../workflows-C-OvZpeg.js";
+import { t as createWorkflowBuilder } from "../../../workflow-builder-OrglbXUh.js";
+import { n as createWorkflowCanvasRunController, t as createWorkflowBuilderController } from "../../../client-BzCv4kKE.js";
+import { useMemo } from "react";
 //#region src/blocks/workflow-builder/react/index.ts
 /**
 * The definitions the signed-in user may read and the step library, with a
@@ -15,105 +16,60 @@ import { useCallback, useEffect, useMemo, useState } from "react";
 * ```
 */
 function useWorkflowBuilder(options = {}) {
-	const supabase = useSupabase();
-	const auth = useAuth();
-	const [definitions, setDefinitions] = useState(void 0);
-	const [steps, setSteps] = useState(void 0);
-	const [error, setError] = useState(void 0);
-	const tenant = options.tenant ?? null;
-	const schema = options.schema;
-	const builder = useMemo(() => createBuilder({
+	const { supabase, auth } = useBlockEnv();
+	const { tenant, schema } = options;
+	const builder = useMemo(() => createWorkflowBuilder({
 		transport: rpcTransport(supabase),
 		...schema === void 0 ? {} : { schema }
 	}), [supabase, schema]);
-	const userId = auth.user?.id ?? null;
-	const refresh = useCallback(async () => {
-		const [listed, library] = await Promise.all([builder.definitions.list(tenant ?? void 0), builder.steps.list()]);
-		if (listed.ok) setDefinitions(listed.data);
-		if (library.ok) setSteps(library.data);
-		setError(listed.ok ? library.ok ? void 0 : library.error : listed.error);
-	}, [builder, tenant]);
-	useEffect(() => {
-		if (auth.status !== "signed-in") return;
-		refresh();
-	}, [
-		userId,
-		auth.status,
-		refresh
+	const { view } = useController(() => createWorkflowBuilderController({
+		client: builder,
+		auth,
+		tenant: tenant ?? null
+	}), [
+		builder,
+		auth,
+		tenant
 	]);
-	return {
-		definitions,
-		steps,
-		error,
-		refresh,
+	return useMemo(() => ({
+		...view,
 		builder
-	};
+	}), [view, builder]);
 }
-const NO_NODES = {};
 /**
 * A run and the status of each of its nodes, loaded again on each message
 * on `workflow-run:<id>` (run status changes and node records).
 */
 function useWorkflowCanvasRun(run, options = {}) {
-	const supabase = useSupabase();
-	const auth = useAuth();
-	const [current, setCurrent] = useState(void 0);
-	const [nodes, setNodes] = useState(NO_NODES);
-	const [error, setError] = useState(void 0);
-	const [status, setStatus] = useState("closed");
-	const schema = options.schema;
-	const clients = useMemo(() => {
+	const { supabase, auth, ports } = useBlockEnv();
+	const { schema } = options;
+	return useController(() => {
 		const transport = rpcTransport(supabase);
 		const scoped = schema === void 0 ? {} : { schema };
-		return {
-			workflows: createWorkflows({
-				transport,
-				...scoped
-			}),
-			builder: createBuilder({
-				transport,
-				...scoped
-			})
-		};
-	}, [supabase, schema]);
-	const userId = auth.user?.id ?? null;
-	const refresh = useCallback(async () => {
-		if (run === null) return;
-		const [found, listed] = await Promise.all([clients.workflows.runs.get(run), clients.builder.nodeRuns.list(run)]);
-		if (found.ok) setCurrent(found.data);
-		if (listed.ok) setNodes(Object.fromEntries(listed.data.map((node) => [node.node, node])));
-		setError(found.ok ? listed.ok ? void 0 : listed.error : found.error);
-	}, [clients, run]);
-	useEffect(() => {
-		if (auth.status !== "signed-in" || run === null) return;
-		refresh();
-	}, [
-		run,
-		userId,
-		auth.status,
-		refresh
-	]);
-	const id = current?.id ?? null;
-	useEffect(() => {
-		if (auth.status !== "signed-in" || id === null) return;
-		return watchTopic(supabase, `workflow-run:${id}`, {
-			onMessage: () => void refresh(),
-			onRejoin: () => void refresh(),
-			onStatus: setStatus
+		const workflows = createWorkflows({
+			transport,
+			...scoped
+		});
+		const builder = createWorkflowBuilder({
+			transport,
+			...scoped
+		});
+		return createWorkflowCanvasRunController({
+			client: {
+				runs: workflows.runs,
+				nodeRuns: builder.nodeRuns
+			},
+			auth,
+			ports,
+			run
 		});
 	}, [
 		supabase,
-		id,
-		auth.status,
-		refresh
-	]);
-	return {
-		run: current,
-		nodes,
-		error,
-		status,
-		refresh
-	};
+		auth,
+		ports,
+		schema,
+		run
+	]).view;
 }
 //#endregion
 export { useWorkflowBuilder, useWorkflowCanvasRun };

package/dist/blocks/workflow-builder/solid/index.d.ts

@@ -0,0 +1,20 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as SolidController } from "../../../solid-controller-DqlvYFZa.js";
+import { a as WorkflowCanvasRunActions, c as WorkflowCanvasRunSnapshot, i as WorkflowBuilderSnapshot, r as WorkflowBuilderControllerOptions, s as WorkflowCanvasRunControllerOptions, t as WorkflowBuilderActions } from "../../../client-VvY0K3wr.js";
+//#region src/blocks/workflow-builder/solid/index.d.ts
+/**
+ * `createWorkflowBuilderController` as a Solid primitive: `state()` reads the
+ * snapshot. Call it in a component; the work starts on mount and the controller
+ * is disposed with the owner. `auth` and `ports` default to the client of
+ * `<BetterSupabaseProvider client={bs}>`.
+ */
+export declare function useWorkflowBuilder(options: BlockOptions<WorkflowBuilderControllerOptions>): SolidController<WorkflowBuilderSnapshot, WorkflowBuilderActions>;
+/**
+ * `createWorkflowCanvasRunController` as a Solid primitive: `state()` reads the
+ * snapshot. Call it in a component; the work starts on mount and the controller
+ * is disposed with the owner. `auth` and `ports` default to the client of
+ * `<BetterSupabaseProvider client={bs}>`.
+ */
+export declare function useWorkflowCanvasRun(options: BlockOptions<WorkflowCanvasRunControllerOptions>): SolidController<WorkflowCanvasRunSnapshot, WorkflowCanvasRunActions>;
+//#endregion
+export type { BlockOptions, SolidController, WorkflowBuilderActions, WorkflowBuilderControllerOptions, WorkflowBuilderSnapshot, WorkflowCanvasRunActions, WorkflowCanvasRunControllerOptions, WorkflowCanvasRunSnapshot };

package/dist/blocks/workflow-builder/solid/index.js

@@ -0,0 +1,23 @@
+import { t as useBlockController } from "../../../solid-controller-DLsmrczT.js";
+import { n as createWorkflowCanvasRunController, t as createWorkflowBuilderController } from "../../../client-BzCv4kKE.js";
+//#region src/blocks/workflow-builder/solid/index.ts
+/**
+* `createWorkflowBuilderController` as a Solid primitive: `state()` reads the
+* snapshot. Call it in a component; the work starts on mount and the controller
+* is disposed with the owner. `auth` and `ports` default to the client of
+* `<BetterSupabaseProvider client={bs}>`.
+*/
+function useWorkflowBuilder(options) {
+	return useBlockController(createWorkflowBuilderController, options);
+}
+/**
+* `createWorkflowCanvasRunController` as a Solid primitive: `state()` reads the
+* snapshot. Call it in a component; the work starts on mount and the controller
+* is disposed with the owner. `auth` and `ports` default to the client of
+* `<BetterSupabaseProvider client={bs}>`.
+*/
+function useWorkflowCanvasRun(options) {
+	return useBlockController(createWorkflowCanvasRunController, options);
+}
+//#endregion
+export { useWorkflowBuilder, useWorkflowCanvasRun };

package/dist/blocks/workflow-builder/svelte/index.d.ts

@@ -0,0 +1,20 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as SvelteController } from "../../../svelte-controller-DxxHEHxD.js";
+import { a as WorkflowCanvasRunActions, c as WorkflowCanvasRunSnapshot, i as WorkflowBuilderSnapshot, r as WorkflowBuilderControllerOptions, s as WorkflowCanvasRunControllerOptions, t as WorkflowBuilderActions } from "../../../client-VvY0K3wr.js";
+//#region src/blocks/workflow-builder/svelte/index.d.ts
+/**
+ * `createWorkflowBuilderController` as a Svelte readable store of the snapshot,
+ * with the actions on `.actions`. Call it in a component's script; the work
+ * starts on mount and the controller is disposed with the component. `auth` and
+ * `ports` default to the client of `setBetterSupabase(bs)`.
+ */
+export declare function useWorkflowBuilder(options: BlockOptions<WorkflowBuilderControllerOptions>): SvelteController<WorkflowBuilderSnapshot, WorkflowBuilderActions>;
+/**
+ * `createWorkflowCanvasRunController` as a Svelte readable store of the
+ * snapshot, with the actions on `.actions`. Call it in a component's script;
+ * the work starts on mount and the controller is disposed with the component.
+ * `auth` and `ports` default to the client of `setBetterSupabase(bs)`.
+ */
+export declare function useWorkflowCanvasRun(options: BlockOptions<WorkflowCanvasRunControllerOptions>): SvelteController<WorkflowCanvasRunSnapshot, WorkflowCanvasRunActions>;
+//#endregion
+export type { BlockOptions, SvelteController, WorkflowBuilderActions, WorkflowBuilderControllerOptions, WorkflowBuilderSnapshot, WorkflowCanvasRunActions, WorkflowCanvasRunControllerOptions, WorkflowCanvasRunSnapshot };

package/dist/blocks/workflow-builder/svelte/index.js

@@ -0,0 +1,23 @@
+import { t as useBlockController } from "../../../svelte-controller-CDAujo-_.js";
+import { n as createWorkflowCanvasRunController, t as createWorkflowBuilderController } from "../../../client-BzCv4kKE.js";
+//#region src/blocks/workflow-builder/svelte/index.ts
+/**
+* `createWorkflowBuilderController` as a Svelte readable store of the snapshot,
+* with the actions on `.actions`. Call it in a component's script; the work
+* starts on mount and the controller is disposed with the component. `auth` and
+* `ports` default to the client of `setBetterSupabase(bs)`.
+*/
+function useWorkflowBuilder(options) {
+	return useBlockController(createWorkflowBuilderController, options);
+}
+/**
+* `createWorkflowCanvasRunController` as a Svelte readable store of the
+* snapshot, with the actions on `.actions`. Call it in a component's script;
+* the work starts on mount and the controller is disposed with the component.
+* `auth` and `ports` default to the client of `setBetterSupabase(bs)`.
+*/
+function useWorkflowCanvasRun(options) {
+	return useBlockController(createWorkflowCanvasRunController, options);
+}
+//#endregion
+export { useWorkflowBuilder, useWorkflowCanvasRun };

package/dist/blocks/workflow-builder/vue/index.d.ts

@@ -0,0 +1,20 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as VueController } from "../../../vue-controller-HPfMTDa2.js";
+import { a as WorkflowCanvasRunActions, c as WorkflowCanvasRunSnapshot, i as WorkflowBuilderSnapshot, r as WorkflowBuilderControllerOptions, s as WorkflowCanvasRunControllerOptions, t as WorkflowBuilderActions } from "../../../client-VvY0K3wr.js";
+//#region src/blocks/workflow-builder/vue/index.d.ts
+/**
+ * `createWorkflowBuilderController` as a Vue composable: `state` is a shallow
+ * ref of the snapshot. Call it in `setup` or an effect scope; the work starts
+ * on mount and the controller is disposed with the scope. `auth` and `ports`
+ * default to the client of `app.use(betterSupabase(bs))`.
+ */
+export declare function useWorkflowBuilder(options: BlockOptions<WorkflowBuilderControllerOptions>): VueController<WorkflowBuilderSnapshot, WorkflowBuilderActions>;
+/**
+ * `createWorkflowCanvasRunController` as a Vue composable: `state` is a shallow
+ * ref of the snapshot. Call it in `setup` or an effect scope; the work starts
+ * on mount and the controller is disposed with the scope. `auth` and `ports`
+ * default to the client of `app.use(betterSupabase(bs))`.
+ */
+export declare function useWorkflowCanvasRun(options: BlockOptions<WorkflowCanvasRunControllerOptions>): VueController<WorkflowCanvasRunSnapshot, WorkflowCanvasRunActions>;
+//#endregion
+export type { BlockOptions, VueController, WorkflowBuilderActions, WorkflowBuilderControllerOptions, WorkflowBuilderSnapshot, WorkflowCanvasRunActions, WorkflowCanvasRunControllerOptions, WorkflowCanvasRunSnapshot };

package/dist/blocks/workflow-builder/vue/index.js

@@ -0,0 +1,23 @@
+import { t as useBlockController } from "../../../vue-controller-C9tFzqAc.js";
+import { n as createWorkflowCanvasRunController, t as createWorkflowBuilderController } from "../../../client-BzCv4kKE.js";
+//#region src/blocks/workflow-builder/vue/index.ts
+/**
+* `createWorkflowBuilderController` as a Vue composable: `state` is a shallow
+* ref of the snapshot. Call it in `setup` or an effect scope; the work starts
+* on mount and the controller is disposed with the scope. `auth` and `ports`
+* default to the client of `app.use(betterSupabase(bs))`.
+*/
+function useWorkflowBuilder(options) {
+	return useBlockController(createWorkflowBuilderController, options);
+}
+/**
+* `createWorkflowCanvasRunController` as a Vue composable: `state` is a shallow
+* ref of the snapshot. Call it in `setup` or an effect scope; the work starts
+* on mount and the controller is disposed with the scope. `auth` and `ports`
+* default to the client of `app.use(betterSupabase(bs))`.
+*/
+function useWorkflowCanvasRun(options) {
+	return useBlockController(createWorkflowCanvasRunController, options);
+}
+//#endregion
+export { useWorkflowBuilder, useWorkflowCanvasRun };

package/dist/blocks/workflows/index.d.ts

@@ -1,3 +1,20 @@
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-inD4fFq-.js";
-import { a as WorkflowSchedule, c as WorkflowStartRequest, d as WorkflowTickOptions, f as WorkflowTickResult, h as createWorkflows, i as WorkflowRunsQuery, l as WorkflowStartTicket, m as WorkflowsOptions, n as WorkflowRunRecord, o as WorkflowScheduleInput, p as Workflows, r as WorkflowRunStatus, s as WorkflowStartCall, t as WorkflowRun, u as WorkflowStarter } from "../../workflows-CcpCBfIe.js";
-export { type BlockTransport, type WorkflowRun, type WorkflowRunRecord, type WorkflowRunStatus, type WorkflowRunsQuery, type WorkflowSchedule, type WorkflowScheduleInput, type WorkflowStartCall, type WorkflowStartRequest, type WorkflowStartTicket, type WorkflowStarter, type WorkflowTickOptions, type WorkflowTickResult, type Workflows, type WorkflowsOptions, createWorkflows, dbTransport, rpcTransport, sqlTransport };
+import { _t as WorkflowRunEventData, wt as Events } from "../../events-CTreRrgP.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DaGGXjIw.js";
+import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
+import { _ as WorkflowsHooks, a as WorkflowRunStatus, c as WorkflowScheduleInput, d as WorkflowStartTicket, f as WorkflowStarter, g as Workflows, h as WorkflowTickResult, i as WorkflowRunRecord, l as WorkflowStartCall, m as WorkflowTickOptions, n as WorkflowRun, o as WorkflowRunsQuery, s as WorkflowSchedule, u as WorkflowStartRequest, v as WorkflowsOptions, y as createWorkflows } from "../../workflows-DFQeXDAI.js";
+import { a as WorkflowRunsActions, c as WorkflowRunsSnapshot, i as WorkflowRunSnapshot, l as createWorkflowRunController, n as WorkflowRunController, o as WorkflowRunsController, r as WorkflowRunControllerOptions, s as WorkflowRunsControllerOptions, t as WorkflowRunActions, u as createWorkflowRunsController } from "../../client-WAdEBBrH.js";
+//#region src/blocks/workflows/events.d.ts
+/** The events of the `workflows` block: type to data. */
+type WorkflowsEvents = {
+  readonly "workflow_run.completed": WorkflowRunEventData;
+  readonly "workflow_run.failed": WorkflowRunEventData;
+  readonly "workflow_run.cancelled": WorkflowRunEventData;
+};
+/** The `workflows` block's event types, for its manifest and `onBlockEvent`. */
+export declare const workflowsEvents: Events<WorkflowsEvents>;
+//#endregion
+//#region src/blocks/workflows/manifest.d.ts
+/** The `workflows` block's manifest (ADR 0029). */
+export declare const workflowsBlock: BlockOf<"workflows", typeof createWorkflows, WorkflowsEvents, Record<never, never>, "workflows">;
+//#endregion
+export { type BlockTransport, type WorkflowRun, type WorkflowRunActions, type WorkflowRunController, type WorkflowRunControllerOptions, type WorkflowRunRecord, type WorkflowRunSnapshot, type WorkflowRunStatus, type WorkflowRunsActions, type WorkflowRunsController, type WorkflowRunsControllerOptions, type WorkflowRunsQuery, type WorkflowRunsSnapshot, type WorkflowSchedule, type WorkflowScheduleInput, type WorkflowStartCall, type WorkflowStartRequest, type WorkflowStartTicket, type WorkflowStarter, type WorkflowTickOptions, type WorkflowTickResult, type Workflows, type WorkflowsEvents, type WorkflowsHooks, type WorkflowsOptions, createWorkflowRunController, createWorkflowRunsController, createWorkflows, dbTransport, rpcTransport, sqlTransport };

package/dist/blocks/workflows/index.js

@@ -1,3 +1,27 @@
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-bAKh-dGc.js";
-import { t as createWorkflows } from "../../workflows-IvxzG2cl.js";
-export { createWorkflows, dbTransport, rpcTransport, sqlTransport };
+import { n as event, t as defineEvents } from "../../event-map-Dy2vKHai.js";
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-G4t1umrR.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { t as createWorkflows } from "../../workflows-C-OvZpeg.js";
+import { n as createWorkflowRunsController, t as createWorkflowRunController } from "../../client-C-2ajnhM.js";
+//#region src/blocks/workflows/events.ts
+/** The `workflows` block's event types, for its manifest and `onBlockEvent`. */
+const workflowsEvents = defineEvents({
+	"workflow_run.completed": event(),
+	"workflow_run.failed": event(),
+	"workflow_run.cancelled": event()
+});
+//#endregion
+//#region src/blocks/workflows/manifest.ts
+/** The `workflows` block's manifest (ADR 0029). */
+const workflowsBlock = defineBlock({
+	name: "workflows",
+	sql: ["workflows"],
+	events: workflowsEvents,
+	provides: { workflows: (client) => client },
+	create: createWorkflows,
+	client: "workflows",
+	category: "automation",
+	recipes: ["workflow-canvas", "workflow-runs"]
+});
+//#endregion
+export { createWorkflowRunController, createWorkflowRunsController, createWorkflows, dbTransport, rpcTransport, sqlTransport, workflowsBlock, workflowsEvents };

package/dist/blocks/workflows/react/index.d.ts

@@ -1,6 +1,5 @@
-import { b as DbError } from "../../../result-BchM1XZn.js";
-import { x as SubscriptionStatus } from "../../../index-BCHR4Ucl.js";
-import { r as WorkflowRunStatus, t as WorkflowRun } from "../../../workflows-CcpCBfIe.js";
+import { a as WorkflowRunStatus } from "../../../workflows-DFQeXDAI.js";
+import { a as WorkflowRunsActions, c as WorkflowRunsSnapshot, i as WorkflowRunSnapshot, t as WorkflowRunActions } from "../../../client-WAdEBBrH.js";
 //#region src/blocks/workflows/react/index.d.ts
 export interface UseWorkflowRunsOptions {
   /** The tenant whose runs to list; it also joins the tenant's `workflow-runs:<tenant>` topic. Without one, the signed-in user's own runs load once. */
@@ -8,16 +7,10 @@ export interface UseWorkflowRunsOptions {
   readonly definition?: string;
   readonly status?: WorkflowRunStatus;
   readonly limit?: number;
-  /** The schema the calls go to: the module schema (default `better_supabase`), or the API schema from `sql.modules.workflows.api`. */
+  /** The schema the calls go to: the module schema (default `better_supabase`), or the API schema from `blocks.workflows.api`. */
   readonly schema?: string;
 }
-export interface WorkflowRunsState {
-  /** `undefined` until the first load. */
-  readonly runs: readonly WorkflowRun[] | undefined;
-  readonly error: DbError | undefined;
-  readonly status: SubscriptionStatus;
-  readonly refresh: () => Promise<void>;
-}
+export interface WorkflowRunsState extends WorkflowRunsSnapshot, WorkflowRunsActions {}
 /**
  * The runs the signed-in user may read, newest first, loaded again when a
  * run in the tenant changes status.
@@ -30,15 +23,7 @@ export declare function useWorkflowRuns(options?: UseWorkflowRunsOptions): Workf
 export interface UseWorkflowRunOptions {
   readonly schema?: string;
 }
-export interface WorkflowRunState {
-  /** `undefined` until the first load, and when the user may not read the run. */
-  readonly run: WorkflowRun | undefined;
-  readonly error: DbError | undefined;
-  readonly status: SubscriptionStatus;
-  readonly refresh: () => Promise<void>;
-  /** Asks the engine to cancel the run, then loads it again. */
-  readonly cancel: () => Promise<void>;
-}
+export interface WorkflowRunState extends WorkflowRunSnapshot, WorkflowRunActions {}
 /**
  * One run by its id or its engine's id, loaded again on each status change
  * broadcast on `workflow-run:<id>`.

package/dist/blocks/workflows/react/index.js

@@ -1,9 +1,9 @@
 "use client";
-import { i as useAuth, l as useSupabase } from "../../../hooks-Bhza9Hnr.js";
-import { r as rpcTransport } from "../../../block-transport-bAKh-dGc.js";
-import { t as watchTopic } from "../../../react-topic-seAWjL3_.js";
-import { t as createWorkflows } from "../../../workflows-IvxzG2cl.js";
-import { useCallback, useEffect, useMemo, useState } from "react";
+import { r as rpcTransport } from "../../../block-transport-G4t1umrR.js";
+import { t as useController } from "../../../react-controller-Xn-IU44p.js";
+import { t as useBlockEnv } from "../../../react-env-Cc7Vf6eb.js";
+import { t as createWorkflows } from "../../../workflows-C-OvZpeg.js";
+import { n as createWorkflowRunsController, t as createWorkflowRunController } from "../../../client-C-2ajnhM.js";
 //#region src/blocks/workflows/react/index.ts
 /**
 * The runs the signed-in user may read, newest first, loaded again when a
@@ -14,124 +14,52 @@ import { useCallback, useEffect, useMemo, useState } from "react";
 * ```
 */
 function useWorkflowRuns(options = {}) {
-	const supabase = useSupabase();
-	const auth = useAuth();
-	const [runs, setRuns] = useState(void 0);
-	const [error, setError] = useState(void 0);
-	const [status, setStatus] = useState("closed");
-	const { schema, definition, limit } = options;
-	const runStatus = options.status;
-	const tenant = options.tenant ?? null;
-	const workflows = useMemo(() => createWorkflows({
-		transport: rpcTransport(supabase),
-		...schema === void 0 ? {} : { schema }
-	}), [supabase, schema]);
-	const userId = auth.user?.id ?? null;
-	const refresh = useCallback(async () => {
-		const result = await workflows.runs.list({
-			...tenant === null ? {} : { tenant },
-			...definition === void 0 ? {} : { definition },
-			...runStatus === void 0 ? {} : { status: runStatus },
-			...limit === void 0 ? {} : { limit }
-		});
-		if (result.ok) {
-			setRuns(result.data);
-			setError(void 0);
-		} else setError(result.error);
-	}, [
-		workflows,
-		tenant,
-		definition,
-		runStatus,
-		limit
-	]);
-	useEffect(() => {
-		if (auth.status !== "signed-in") return;
-		refresh();
-		if (tenant === null) return;
-		return watchTopic(supabase, `workflow-runs:${tenant}`, {
-			onMessage: () => void refresh(),
-			onRejoin: () => void refresh(),
-			onStatus: setStatus
-		});
-	}, [
+	const { supabase, auth, ports } = useBlockEnv();
+	const { schema, tenant, definition, status, limit } = options;
+	return useController(() => createWorkflowRunsController({
+		client: createWorkflows({
+			transport: rpcTransport(supabase),
+			...schema === void 0 ? {} : { schema }
+		}),
+		auth,
+		ports,
+		tenant: tenant ?? null,
+		...definition === void 0 ? {} : { definition },
+		...status === void 0 ? {} : { status },
+		...limit === void 0 ? {} : { limit }
+	}), [
 		supabase,
+		auth,
+		ports,
+		schema,
 		tenant,
-		userId,
-		auth.status,
-		refresh
-	]);
-	return {
-		runs,
-		error,
+		definition,
 		status,
-		refresh
-	};
+		limit
+	]).view;
 }
 /**
 * One run by its id or its engine's id, loaded again on each status change
 * broadcast on `workflow-run:<id>`.
 */
 function useWorkflowRun(run, options = {}) {
-	const supabase = useSupabase();
-	const auth = useAuth();
-	const [current, setCurrent] = useState(void 0);
-	const [error, setError] = useState(void 0);
-	const [status, setStatus] = useState("closed");
-	const schema = options.schema;
-	const workflows = useMemo(() => createWorkflows({
-		transport: rpcTransport(supabase),
-		...schema === void 0 ? {} : { schema }
-	}), [supabase, schema]);
-	const userId = auth.user?.id ?? null;
-	const refresh = useCallback(async () => {
-		if (run === null) return;
-		const result = await workflows.runs.get(run);
-		if (result.ok) {
-			setCurrent(result.data);
-			setError(void 0);
-		} else setError(result.error);
-	}, [workflows, run]);
-	const cancel = useCallback(async () => {
-		if (run === null) return;
-		const result = await workflows.runs.requestCancel(run);
-		if (result.ok) await refresh();
-		else setError(result.error);
-	}, [
-		workflows,
-		run,
-		refresh
-	]);
-	useEffect(() => {
-		if (auth.status !== "signed-in" || run === null) return;
-		refresh();
-	}, [
-		run,
-		userId,
-		auth.status,
-		refresh
-	]);
-	const id = current?.id ?? null;
-	useEffect(() => {
-		if (auth.status !== "signed-in" || id === null) return;
-		return watchTopic(supabase, `workflow-run:${id}`, {
-			onMessage: () => void refresh(),
-			onRejoin: () => void refresh(),
-			onStatus: setStatus
-		});
-	}, [
+	const { supabase, auth, ports } = useBlockEnv();
+	const { schema } = options;
+	return useController(() => createWorkflowRunController({
+		client: createWorkflows({
+			transport: rpcTransport(supabase),
+			...schema === void 0 ? {} : { schema }
+		}),
+		auth,
+		ports,
+		run
+	}), [
 		supabase,
-		id,
-		auth.status,
-		refresh
-	]);
-	return {
-		run: current,
-		error,
-		status,
-		refresh,
-		cancel
-	};
+		auth,
+		ports,
+		schema,
+		run
+	]).view;
 }
 //#endregion
 export { useWorkflowRun, useWorkflowRuns };

package/dist/blocks/workflows/solid/index.d.ts

@@ -0,0 +1,20 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as SolidController } from "../../../solid-controller-DqlvYFZa.js";
+import { a as WorkflowRunsActions, c as WorkflowRunsSnapshot, i as WorkflowRunSnapshot, r as WorkflowRunControllerOptions, s as WorkflowRunsControllerOptions, t as WorkflowRunActions } from "../../../client-WAdEBBrH.js";
+//#region src/blocks/workflows/solid/index.d.ts
+/**
+ * `createWorkflowRunsController` as a Solid primitive: `state()` reads the
+ * snapshot. Call it in a component; the work starts on mount and the controller
+ * is disposed with the owner. `auth` and `ports` default to the client of
+ * `<BetterSupabaseProvider client={bs}>`.
+ */
+export declare function useWorkflowRuns(options: BlockOptions<WorkflowRunsControllerOptions>): SolidController<WorkflowRunsSnapshot, WorkflowRunsActions>;
+/**
+ * `createWorkflowRunController` as a Solid primitive: `state()` reads the
+ * snapshot. Call it in a component; the work starts on mount and the controller
+ * is disposed with the owner. `auth` and `ports` default to the client of
+ * `<BetterSupabaseProvider client={bs}>`.
+ */
+export declare function useWorkflowRun(options: BlockOptions<WorkflowRunControllerOptions>): SolidController<WorkflowRunSnapshot, WorkflowRunActions>;
+//#endregion
+export type { BlockOptions, SolidController, WorkflowRunActions, WorkflowRunControllerOptions, WorkflowRunSnapshot, WorkflowRunsActions, WorkflowRunsControllerOptions, WorkflowRunsSnapshot };

package/dist/blocks/workflows/solid/index.js

@@ -0,0 +1,23 @@
+import { t as useBlockController } from "../../../solid-controller-DLsmrczT.js";
+import { n as createWorkflowRunsController, t as createWorkflowRunController } from "../../../client-C-2ajnhM.js";
+//#region src/blocks/workflows/solid/index.ts
+/**
+* `createWorkflowRunsController` as a Solid primitive: `state()` reads the
+* snapshot. Call it in a component; the work starts on mount and the controller
+* is disposed with the owner. `auth` and `ports` default to the client of
+* `<BetterSupabaseProvider client={bs}>`.
+*/
+function useWorkflowRuns(options) {
+	return useBlockController(createWorkflowRunsController, options);
+}
+/**
+* `createWorkflowRunController` as a Solid primitive: `state()` reads the
+* snapshot. Call it in a component; the work starts on mount and the controller
+* is disposed with the owner. `auth` and `ports` default to the client of
+* `<BetterSupabaseProvider client={bs}>`.
+*/
+function useWorkflowRun(options) {
+	return useBlockController(createWorkflowRunController, options);
+}
+//#endregion
+export { useWorkflowRun, useWorkflowRuns };

package/dist/blocks/workflows/svelte/index.d.ts

@@ -0,0 +1,20 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as SvelteController } from "../../../svelte-controller-DxxHEHxD.js";
+import { a as WorkflowRunsActions, c as WorkflowRunsSnapshot, i as WorkflowRunSnapshot, r as WorkflowRunControllerOptions, s as WorkflowRunsControllerOptions, t as WorkflowRunActions } from "../../../client-WAdEBBrH.js";
+//#region src/blocks/workflows/svelte/index.d.ts
+/**
+ * `createWorkflowRunsController` as a Svelte readable store of the snapshot,
+ * with the actions on `.actions`. Call it in a component's script; the work
+ * starts on mount and the controller is disposed with the component. `auth` and
+ * `ports` default to the client of `setBetterSupabase(bs)`.
+ */
+export declare function useWorkflowRuns(options: BlockOptions<WorkflowRunsControllerOptions>): SvelteController<WorkflowRunsSnapshot, WorkflowRunsActions>;
+/**
+ * `createWorkflowRunController` as a Svelte readable store of the snapshot,
+ * with the actions on `.actions`. Call it in a component's script; the work
+ * starts on mount and the controller is disposed with the component. `auth` and
+ * `ports` default to the client of `setBetterSupabase(bs)`.
+ */
+export declare function useWorkflowRun(options: BlockOptions<WorkflowRunControllerOptions>): SvelteController<WorkflowRunSnapshot, WorkflowRunActions>;
+//#endregion
+export type { BlockOptions, SvelteController, WorkflowRunActions, WorkflowRunControllerOptions, WorkflowRunSnapshot, WorkflowRunsActions, WorkflowRunsControllerOptions, WorkflowRunsSnapshot };