better-supabase 0.13.0 → 0.15.0

package/dist/vue/index.d.ts

@@ -1,14 +1,66 @@
-import { b as DbError } from "../result-mijqfoJN.js";
-import { J as QuerySpec } from "../define-D0LSXmUP.js";
-import { $ as TemplateValues } from "../bucket-DBay-ICp.js";
-import { g as TopicHandlers, m as Topic, p as SubscriptionStatus, r as PresenceMember, t as EventSchemas } from "../topic-CZvLXFND.js";
-import { t as AuthSnapshot } from "../bind-DcXLU1ul.js";
-import { t as AuthSession } from "../view-CKzCp8FW.js";
-import { a as BroadcastOptions, c as LiveCountHookOptions, d as PresenceHookOptions, f as PresenceTopic, i as ActionState, l as LiveCountSource, m as UseActionOptions, n as ActionInputOf, o as ClaimsOf, p as ProfileOf, r as ActionResultOf, s as ClientLike, t as fieldErrorsOf, u as LiveQueryHookOptions } from "../field-errors-CKEqR38q.js";
-import { t as SupportView } from "../support-view-BOJJSZKv.js";
+import { b as DbError } from "../result-DZeA5KS6.js";
+import { Ct as Events, D as BlockEventPattern, T as BlockEvent, bt as EventMap, k as BlockEventsMatching } from "../events-vcqenSYU.js";
+import { pt as QuerySpec } from "../define-DFBnQyYg.js";
+import { $ as TemplateValues } from "../bucket-CiNi8sIw.js";
+import { g as TopicHandlers, m as Topic, p as SubscriptionStatus, r as PresenceMember, t as EventSchemas } from "../topic-CJrQZQaa.js";
+import { t as AuthSnapshot } from "../bind-CrMBwrPN.js";
+import { t as AuthSession } from "../view-DyFdMCqg.js";
+import { n as Controller } from "../controller-BrP0gn47.js";
+import { C as LiveCountSource, D as ProfileOf, E as PresenceTopic, O as UseActionOptions, S as LiveCountHookOptions, T as PresenceHookOptions, _ as ActionResultOf, a as DataRows, b as ClaimsOf, c as DataWrites, d as BlockMutationState, f as BlockQueryActions, g as ActionInputOf, h as BlockRefetchOn, i as DataRow, l as BlockEventSource, m as BlockQueryState, n as DataId, o as DataSource, p as BlockQueryOptions, r as DataListArgs, s as DataState, t as fieldErrorsOf, u as BlockMutationActions, v as ActionState, w as LiveQueryHookOptions, x as ClientLike, y as BroadcastOptions } from "../field-errors-fsbFktYF.js";
+import { n as BlockOptions } from "../block-env-B_uEM2xz.js";
+import { n as BlockDataOf, r as BlockMethodName, t as BlockArgsOf } from "../block-method-CiVa2G-J.js";
+import { t as SupportView } from "../support-view-BYOgwXsJ.js";
 import { SupabaseClient } from "@supabase/supabase-js";
-import { App, ComputedRef, MaybeRefOrGetter, Ref } from "vue";
 import { QueryClient } from "@tanstack/query-core";
+import { App, ComputedRef, MaybeRefOrGetter, Ref, ShallowRef } from "vue";
+//#region src/blocks/vue-bind.d.ts
+/** A block controller in a Vue component: `state` follows the controller. */
+interface VueController<S, A> {
+  readonly state: Readonly<ShallowRef<S>>;
+  readonly actions: A;
+  readonly controller: Controller<S, A>;
+}
+//#endregion
+//#region src/vue/block-hooks.d.ts
+/**
+ * Calls a read method of any block client (`blocks.tasks.list`, renamed or not)
+ * from mount. `refetchOn` calls it again on block events.
+ */
+export declare function useBlockQuery<C extends object, const K extends BlockMethodName<C>>(client: C, method: K, args: BlockArgsOf<C, K>, options?: BlockQueryOptions): VueController<BlockQueryState<BlockDataOf<C, K>>, BlockQueryActions>;
+/** Calls a write method of any block client and tracks its state. */
+export declare function useBlockMutation<C extends object, const K extends BlockMethodName<C>>(client: C, method: K): VueController<BlockMutationState<BlockDataOf<C, K>>, BlockMutationActions<BlockArgsOf<C, K>, BlockDataOf<C, K>>>;
+/**
+ * Calls `handler` for each block event matching `pattern` (`"task.*"`), typed
+ * by `events` (`blockEvents` from `blocks.generated.ts`), from mount until the
+ * component goes away. `source` is the client's `betterSupabase`.
+ */
+export declare function useBlockEvent<M extends EventMap, const P extends BlockEventPattern<M>>(source: BlockEventSource, events: Events<M>, pattern: P, handler: (event: BlockEvent<M, BlockEventsMatching<M, P>>) => void): void;
+//#endregion
+//#region src/blocks/vue-controller.d.ts
+/**
+ * Makes a controller once and keeps `state` current. Its work starts on mount
+ * (at once in an effect scope, never during server rendering), and the
+ * controller is disposed with the component or scope.
+ */
+export declare function useBlockController<O, S, A>(create: (options: O) => Controller<S, A>, options: BlockOptions<O>, usesEnv?: boolean): VueController<S, A>;
+//#endregion
+//#region src/vue/data-hooks.d.ts
+/** What `useList` and `useOne` return: `state` and the writes. */
+type DataView<S extends DataSource, T> = VueController<DataState<T>, DataWrites<S>>;
+/** The composables `defineDataHooks` makes for one table or block instance. */
+interface DataHooks<S extends DataSource> {
+  /** `source.list(args)`, kept fresh after every write. */
+  readonly useList: (args?: DataListArgs<S>) => DataView<S, DataRows<S>>;
+  /** `source.get(id)`, kept fresh after every write. */
+  readonly useOne: (id: DataId<S>) => DataView<S, DataRow<S>>;
+}
+/**
+ * The list and record composables for one table or block instance. The
+ * generated `hooks.ts` calls it once per table; `select` picks the source from
+ * the plugin's `db`.
+ */
+export declare function defineDataHooks<D, S extends DataSource>(name: string, select: (db: D) => S): DataHooks<S>;
+//#endregion
 //#region src/vue/index.d.ts
 export interface BetterSupabaseVueOptions {
   /** Better-supabase queries are reset when the user signs out or changes. */
@@ -24,7 +76,7 @@ export interface BetterSupabasePlugin {
  * ```ts
  * app
  *   .use(VueQueryPlugin, { queryClient })
- *   .use(betterSupabase(bs, { queryClient }));
+ *   .use(betterSupabase(bsb, { queryClient }));
  * ```
  */
 export declare function betterSupabase(client: ClientLike, options?: BetterSupabaseVueOptions): BetterSupabasePlugin;
@@ -46,10 +98,7 @@ export declare function useSupportSession(): ComputedRef<SupportView | undefined
 export interface BetterComposables<B extends ClientLike> {
   /** Repositories bound to the current session. */
   readonly useDb: () => B["db"];
-  /**
-   * TanStack Query option factories:
-   * `useQuery(useQueries().customers.findMany())`.
-   */
+  /** TanStack Query option factories: `useQuery(useQueries().customers.list())`. */
   readonly useQueries: () => B["queries"];
   readonly useSupabase: () => SupabaseClient;
   readonly useAuth: () => Readonly<Ref<AuthSnapshot>>;
@@ -60,7 +109,7 @@ export interface BetterComposables<B extends ClientLike> {
  *
  * ```ts
  * export const { useDb, useQueries, useAuth } =
- *   createBindings<typeof bs>();
+ *   createBindings<typeof bsb>();
  * ```
  */
 export declare function createBindings<B extends ClientLike>(): BetterComposables<B>;
@@ -84,9 +133,7 @@ export declare function useBroadcast<P extends string, E extends EventSchemas>(t
  *
  * ```ts
  * const spec = computed(() =>
- *   betterSupabase.spec.customers.findMany({
- *     where: { orgId: org.value },
- *   }),
+ *   betterSupabase.spec.customers.list({ where: { orgId: org.value } }),
  * );
  * useLiveQuery(spec);
  * ```
@@ -101,7 +148,7 @@ export interface LiveCount {
 }
 /**
  * A count that stays current: refetches only the `count` spec after each
- * debounced change to a table it reads. Takes a spec or a `bs.liveCount()`
+ * debounced change to a table it reads. Takes a spec or a `bsb.liveCount()`
  * seed; `null` pauses. The returned object's fields are reactive.
  *
  * ```ts
@@ -153,4 +200,4 @@ export interface ActionHandle<I, T> extends ActionState<I, T> {
  */
 export declare function useAction<I, T>(action: (input: I) => Promise<ActionResultOf<T>>, options?: UseActionOptions<ActionInputOf<I>, T>): ActionHandle<ActionInputOf<I>, T>;
 //#endregion
-export { type ActionInputOf, type ActionResultOf, type ActionState, type AuthSession, type AuthSnapshot, type BroadcastOptions, type ClaimsOf, type ClientLike, type LiveCountHookOptions, type LiveCountSource, type LiveQueryHookOptions, type PresenceHookOptions, type PresenceTopic, type ProfileOf, type SupportView, type UseActionOptions, fieldErrorsOf };
+export { type ActionInputOf, type ActionResultOf, type ActionState, type AuthSession, type AuthSnapshot, type BlockEventSource, type BlockMutationActions, type BlockMutationState, type BlockOptions, type BlockQueryActions, type BlockQueryOptions, type BlockQueryState, type BlockRefetchOn, type BroadcastOptions, type ClaimsOf, type ClientLike, type DataHooks, type DataSource, type DataState, type DataView, type DataWrites, type LiveCountHookOptions, type LiveCountSource, type LiveQueryHookOptions, type PresenceHookOptions, type PresenceTopic, type ProfileOf, type SupportView, type UseActionOptions, type VueController, fieldErrorsOf };

package/dist/vue/index.js

@@ -1,9 +1,99 @@
-import { t as clearOnUserChange } from "../user-change-CSR_prhd.js";
-import { a as createActionRunner, c as liveKey, d as shownCount, f as startBroadcast, i as countSource, l as notJoined, m as startLiveQuery, n as assertInvalidateClient, o as joinPresence, p as startLiveCount, r as callerOf, s as keyed, t as NO_COUNT, u as plainCaller } from "../client-YASsOslj.js";
+import { t as clearOnUserChange } from "../user-change-DgWC6RRC.js";
+import { a as createActionRunner, c as liveKey, d as shownCount, f as startBroadcast, i as countSource, l as notJoined, m as startLiveQuery, n as assertInvalidateClient, o as joinPresence, p as startLiveCount, r as callerOf, s as keyed, t as NO_COUNT, u as plainCaller } from "../client-BAEbEA7t.js";
 import { t as supportOf } from "../support-view-g4YLBeqX.js";
-import { t as fieldErrorsOf } from "../field-errors-DZVRWRkf.js";
-import { n as onClient, r as useContext, t as CLIENT } from "../context-CCz6ZgyI.js";
-import { computed, getCurrentScope, inject, onScopeDispose, provide, readonly, shallowRef, toValue, watch } from "vue";
+import { c as listenToBlockEvents, d as fieldErrorsOf, i as dataTarget, l as blockEnv, n as createDataOne, o as createBlockMutation, s as createBlockQuery, t as createDataList, u as withEnv } from "../data-hooks-tgF1Ct0F.js";
+import { computed, getCurrentInstance, getCurrentScope, inject, onMounted, onScopeDispose, provide, readonly, shallowRef, toValue, watch } from "vue";
+//#region src/vue/context.ts
+const CLIENT = Symbol("better-supabase");
+/** What `app.use(betterSupabase(bsb))` provides. */
+function useContext() {
+	const context = inject(CLIENT, null);
+	if (!context) throw new Error("better-supabase: install the plugin with app.use(betterSupabase(bsb))");
+	return context;
+}
+/**
+* Runs `start` on mount in a component, at once elsewhere (an effect scope),
+* and never during server rendering.
+*/
+function onClient(start) {
+	if (getCurrentInstance()) onMounted(start);
+	else start();
+}
+//#endregion
+//#region src/blocks/vue-bind.ts
+/**
+* Keeps `state` current from mount (at once in an effect scope, never during
+* server rendering), and disposes the controller with the component or scope.
+*/
+function bindVueController(controller) {
+	const state = shallowRef(controller.getSnapshot());
+	let unsubscribe;
+	onClient(() => {
+		const sync = () => {
+			state.value = controller.getSnapshot();
+		};
+		unsubscribe = controller.subscribe(sync);
+		sync();
+	});
+	if (getCurrentScope()) onScopeDispose(() => {
+		unsubscribe?.();
+		controller.dispose();
+	});
+	return {
+		state,
+		actions: controller.actions,
+		controller
+	};
+}
+//#endregion
+//#region src/vue/block-hooks.ts
+/**
+* Calls a read method of any block client (`blocks.tasks.list`, renamed or not)
+* from mount. `refetchOn` calls it again on block events.
+*/
+function useBlockQuery(client, method, args, options = {}) {
+	return bindVueController(createBlockQuery(client, method, args, options));
+}
+/** Calls a write method of any block client and tracks its state. */
+function useBlockMutation(client, method) {
+	return bindVueController(createBlockMutation(client, method));
+}
+/**
+* Calls `handler` for each block event matching `pattern` (`"task.*"`), typed
+* by `events` (`blockEvents` from `blocks.generated.ts`), from mount until the
+* component goes away. `source` is the client's `betterSupabase`.
+*/
+function useBlockEvent(source, events, pattern, handler) {
+	let stop;
+	onClient(() => {
+		stop = listenToBlockEvents(source, events, pattern, () => handler);
+	});
+	if (getCurrentScope()) onScopeDispose(() => stop?.());
+}
+//#endregion
+//#region src/blocks/vue-controller.ts
+/**
+* Makes a controller once and keeps `state` current. Its work starts on mount
+* (at once in an effect scope, never during server rendering), and the
+* controller is disposed with the component or scope.
+*/
+function useBlockController(create, options, usesEnv = true) {
+	return bindVueController(create(withEnv(options, usesEnv ? () => blockEnv(useContext().client) : void 0)));
+}
+//#endregion
+//#region src/vue/data-hooks.ts
+/**
+* The list and record composables for one table or block instance. The
+* generated `hooks.ts` calls it once per table; `select` picks the source from
+* the plugin's `db`.
+*/
+function defineDataHooks(name, select) {
+	return {
+		useList: (args) => bindVueController(createDataList(dataTarget(useContext().client, name, select), args)),
+		useOne: (id) => bindVueController(createDataOne(dataTarget(useContext().client, name, select), id))
+	};
+}
+//#endregion
 //#region src/vue/index.ts
 const SESSION = Symbol("better-supabase-session");
 /**
@@ -13,7 +103,7 @@ const SESSION = Symbol("better-supabase-session");
 * ```ts
 * app
 *   .use(VueQueryPlugin, { queryClient })
-*   .use(betterSupabase(bs, { queryClient }));
+*   .use(betterSupabase(bsb, { queryClient }));
 * ```
 */
 function betterSupabase(client, options = {}) {
@@ -66,7 +156,7 @@ function useSupportSession() {
 *
 * ```ts
 * export const { useDb, useQueries, useAuth } =
-*   createBindings<typeof bs>();
+*   createBindings<typeof bsb>();
 * ```
 */
 function createBindings() {
@@ -95,7 +185,7 @@ function useCaller(context, client) {
 }
 function supabaseFor(hook, context, client) {
 	const supabase = client ?? context?.client.supabase;
-	if (!supabase) throw new Error(`better-supabase: ${hook} needs app.use(betterSupabase(bs)) or { client: supabase }`);
+	if (!supabase) throw new Error(`better-supabase: ${hook} needs app.use(betterSupabase(bsb)) or { client: supabase }`);
 	return supabase;
 }
 /**
@@ -154,9 +244,7 @@ function useBroadcast(topic, values, handlers, options) {
 *
 * ```ts
 * const spec = computed(() =>
-*   betterSupabase.spec.customers.findMany({
-*     where: { orgId: org.value },
-*   }),
+*   betterSupabase.spec.customers.list({ where: { orgId: org.value } }),
 * );
 * useLiveQuery(spec);
 * ```
@@ -168,7 +256,7 @@ function useLiveQuery(spec, options = {}) {
 	let joined = null;
 	const key = computed(() => {
 		const current = toValue(spec);
-		if (current && !queryClient) throw new Error("better-supabase: useLiveQuery needs betterSupabase(bs, { queryClient })");
+		if (current && !queryClient) throw new Error("better-supabase: useLiveQuery needs betterSupabase(bsb, { queryClient })");
 		return liveKey(client, current, auth.value, options);
 	});
 	onClient(() => {
@@ -197,7 +285,7 @@ function useLiveQuery(spec, options = {}) {
 }
 /**
 * A count that stays current: refetches only the `count` spec after each
-* debounced change to a table it reads. Takes a spec or a `bs.liveCount()`
+* debounced change to a table it reads. Takes a spec or a `bsb.liveCount()`
 * seed; `null` pauses. The returned object's fields are reactive.
 *
 * ```ts
@@ -367,4 +455,4 @@ function useAction(action, options = {}) {
 	};
 }
 //#endregion
-export { betterSupabase, createBindings, fieldErrorsOf, provideSession, useAction, useAuth, useBroadcast, useLiveCount, useLiveQuery, usePresence, useSession, useSupabase, useSupportSession };
+export { betterSupabase, createBindings, defineDataHooks, fieldErrorsOf, provideSession, useAction, useAuth, useBlockController, useBlockEvent, useBlockMutation, useBlockQuery, useBroadcast, useLiveCount, useLiveQuery, usePresence, useSession, useSupabase, useSupportSession };

package/dist/watch-topic-BcGfvZOE.d.ts

@@ -0,0 +1,31 @@
+import { c as RealtimeClient, p as SubscriptionStatus } from "./topic-CJrQZQaa.js";
+//#region src/realtime/watch-topic.d.ts
+interface TopicWatch {
+  readonly onMessage: (event: string, payload: unknown) => void;
+  readonly onRejoin: () => void;
+  readonly onStatus: (status: SubscriptionStatus) => void;
+}
+/**
+ * A joined topic: `leave` is safe to call twice, `send` broadcasts to the other
+ * members.
+ */
+interface TopicHandle {
+  readonly leave: () => void;
+  readonly send: (event: string, payload: Readonly<Record<string, unknown>>) => void;
+}
+/**
+ * Joins a private topic and reports its messages, rejoins and status: the
+ * realtime port of the block controllers. `topicPort(supabase)` is the default;
+ * a test passes a fake.
+ */
+type TopicPort = (topic: string, watch: TopicWatch) => TopicHandle;
+/**
+ * Joins a private topic and returns its handle. Watches on the same client and
+ * topic share one channel, as `defineTopic` subscriptions do, and the channel
+ * closes when the last one leaves.
+ */
+declare function watchTopic(supabase: RealtimeClient, topic: string, watch: TopicWatch): TopicHandle;
+/** The realtime port over a supabase-js client. */
+declare function topicPort(supabase: RealtimeClient): TopicPort;
+//#endregion
+export { watchTopic as a, topicPort as i, TopicPort as n, TopicWatch as r, TopicHandle as t };

package/dist/wiring-CDNuQoJJ.js

@@ -0,0 +1,13 @@
+//#region src/blocks/wiring.ts
+/** The keys the cron routes check in the `Authorization` header. */
+const CRON_SECRET_ENV = {
+	key: "CRON_SECRET",
+	description: "Server-only: the bearer token the cron routes require (Vercel Cron sends it)."
+};
+/** The server connection the relay and drain routes use. */
+const DATABASE_URL_ENV = {
+	key: "DATABASE_URL",
+	description: "Server-only: the Postgres connection the registry's queue drain and Stripe processing routes use."
+};
+//#endregion
+export { DATABASE_URL_ENV as n, CRON_SECRET_ENV as t };

package/dist/workflow-sdk/builder/index.d.ts

@@ -1,6 +1,6 @@
-import { B as WorkflowGraph, i as BuilderStarter, l as NodeRunRecord } from "../../types-vVsLvOUJ.js";
-import { a as GraphSubject, i as GraphStepCall, o as approvalToken, r as GraphRuntime, s as executeGraph, t as GraphApprovalCall } from "../../executor-Cy1nk4MZ.js";
-import { s as WorkflowFn } from "../../workflow-sdk-BXwl1THQ.js";
+import { L as WorkflowGraph, i as BuilderStarter, l as NodeRunRecord } from "../../types-BBQLbui9.js";
+import { a as GraphSubject, i as GraphStepCall, o as approvalToken, r as GraphRuntime, s as executeGraph, t as GraphApprovalCall } from "../../executor-_2ekNofh.js";
+import { s as WorkflowFn } from "../../workflow-sdk-BFHu4sci.js";
 import { World } from "@workflow/world";
 //#region src/workflow-sdk/builder/builder.d.ts
 /** The env flag the Workflow SDK reads before it starts or runs dynamic source. */
@@ -50,10 +50,10 @@ interface GraphRunMeta {
  * Compiles a graph to Workflow SDK dynamic source: plain JavaScript that starts
  * at `meta.triggerNode` (or the only trigger), calls each step node through its
  * own alias, sleeps with `sleep` and waits on approvals with `createHook`: the
- * token is the id `steps.bs_approval` returns (graphStarter's `approval`), else
- * `<runKey>:<node>`. A `meta.mode` of `test` returns `meta.stubs` instead. It
- * runs the same way `executeGraph` does. Throws when the graph is invalid or
- * the source is over 128 KiB. Pass it as `compile` to `createWorkflowBuilder`.
+ * token is the id `steps.bsb_approval` returns (graphStarter's `approval`),
+ * else `<runKey>:<node>`. A `meta.mode` of `test` returns `meta.stubs` instead.
+ * It runs the same way `executeGraph` does. Throws when the graph is invalid or
+ * the source is over 128 KiB. Pass it as `compile` to `createWorkflowEditor`.
  */
 export declare function compileGraph(graph: WorkflowGraph): CompiledGraph;
 /** `value` as a compiled graph, or `undefined` when it isn't one. */
@@ -94,19 +94,19 @@ interface GraphStarterOptions {
   readonly approval?: GraphStep;
 }
 /**
- * The `start` for `createWorkflowBuilder`: starts the published version as
+ * The `start` for `createWorkflowEditor`: starts the published version as
  * dynamic source when dynamic workflows are on, and through `executor`
  * otherwise. The source is always compiled from the version's graph; a stored
- * compiled form is never run. Runs carry `bs.tenant`, `bs.actor`,
- * `bs.definition`, `bs.version` and `bs.key`, plus `bs.subject`, `bs.mode` and
- * `bs.trigger_node` when set. A live run also records its principal: the
+ * compiled form is never run. Runs carry `bsb.tenant`, `bsb.actor`,
+ * `bsb.definition`, `bsb.version` and `bsb.key`, plus `bsb.subject`, `bsb.mode`
+ * and `bsb.trigger_node` when set. A live run also records its principal: the
  * publisher (`user`), or the app's service principal for an organization-owned
  * version. A repeated key returns the first run.
  */
 export declare function graphStarter(options: GraphStarterOptions): BuilderStarter;
 /**
  * Where `nodeRunReporter` writes: `builder.nodeRuns` from
- * `createWorkflowBuilder`.
+ * `createWorkflowEditor`.
  */
 interface NodeRunSink {
   record(input: NodeRunRecord): PromiseLike<unknown>;

package/dist/workflow-sdk/builder/index.js

@@ -1,7 +1,6 @@
-import { n as subjectAttribute, t as WORKFLOW_ATTRIBUTES } from "../../attributes-BOFl922R.js";
-import { c as isGraphRecord, i as durationMs, p as validateGraph, u as topologicalOrder } from "../../graph-B4eubUQG.js";
-import { i as startNodeOf, n as executeGraph, t as approvalToken } from "../../executor-QtVn0axs.js";
-import { o as runForKey, r as contextAttributes } from "../../workflow-sdk-CPGiFE1B.js";
+import { n as subjectAttribute, t as WORKFLOW_ATTRIBUTES } from "../../attributes-Bzf51_nc.js";
+import { d as isGraphRecord, i as startNodeOf, m as validateGraph, n as executeGraph, p as topologicalOrder, s as durationMs, t as approvalToken } from "../../executor-D3gB-9si.js";
+import { o as runForKey, r as contextAttributes } from "../../workflow-sdk-BVlFEB5Q.js";
 import { start } from "workflow/api";
 import { getStepMetadata, getWorkflowMetadata } from "workflow";
 //#region src/workflow-sdk/builder/builder.ts
@@ -14,7 +13,7 @@ const EXPORT_NAME = "workflow";
 * The `steps` key the compiled source calls to file an approval request; never
 * a step alias.
 */
-const APPROVAL_ALIAS = "bs_approval";
+const APPROVAL_ALIAS = "bsb_approval";
 const literal = (value) => JSON.stringify(value ?? null);
 const aliasOf = (node, index) => `n${index}_${node.id.replaceAll(/[^A-Za-z0-9_]/g, "_").slice(0, 40)}`;
 const RUNTIME = `  const results = {};
@@ -78,7 +77,7 @@ function nodeBody(node, alias) {
     ran[${id}] = outcome;`;
 		default: {
 			const unknown = node.kind;
-			throw new TypeError(`workflow-builder: unknown node kind ${String(unknown)}`);
+			throw new TypeError(`workflow-editor: unknown node kind ${String(unknown)}`);
 		}
 	}
 }
@@ -87,14 +86,14 @@ const guard = (edges) => edges.map((edge) => `took(${literal(edge.source)}, ${ed
 * Compiles a graph to Workflow SDK dynamic source: plain JavaScript that starts
 * at `meta.triggerNode` (or the only trigger), calls each step node through its
 * own alias, sleeps with `sleep` and waits on approvals with `createHook`: the
-* token is the id `steps.bs_approval` returns (graphStarter's `approval`), else
-* `<runKey>:<node>`. A `meta.mode` of `test` returns `meta.stubs` instead. It
-* runs the same way `executeGraph` does. Throws when the graph is invalid or
-* the source is over 128 KiB. Pass it as `compile` to `createWorkflowBuilder`.
+* token is the id `steps.bsb_approval` returns (graphStarter's `approval`),
+* else `<runKey>:<node>`. A `meta.mode` of `test` returns `meta.stubs` instead.
+* It runs the same way `executeGraph` does. Throws when the graph is invalid or
+* the source is over 128 KiB. Pass it as `compile` to `createWorkflowEditor`.
 */
 function compileGraph(graph) {
 	const errors = validateGraph(graph);
-	if (errors.length > 0) throw new TypeError(`workflow-builder: ${errors.join("; ")}`);
+	if (errors.length > 0) throw new TypeError(`workflow-editor: ${errors.join("; ")}`);
 	const order = topologicalOrder(graph) ?? [];
 	const incoming = /* @__PURE__ */ new Map();
 	for (const edge of graph.edges) incoming.set(edge.target, [...incoming.get(edge.target) ?? [], edge]);
@@ -111,7 +110,7 @@ function compileGraph(graph) {
 		if (node.kind === "trigger") return `${comment}\n  if (${triggers.length === 1 ? `start === null || start === ${literal(node.id)}` : `start === ${literal(node.id)}`}) {\n    ${body}\n  }`;
 		return `${comment}\n  if (${guard(incoming.get(node.id) ?? [])}) {\n    ${body}\n  }`;
 	});
-	const pick = triggers.length === 1 ? "" : `  if (start === null) throw new TypeError("workflow-builder: pass the trigger node the run starts at, the id of one of the graph's trigger nodes");\n`;
+	const pick = triggers.length === 1 ? "" : `  if (start === null) throw new TypeError("workflow-editor: pass the trigger node the run starts at, the id of one of the graph's trigger nodes");\n`;
 	const source = `async function ${EXPORT_NAME}(input, meta) {
   "use workflow";
 ${RUNTIME}${pick}
@@ -120,7 +119,7 @@ ${blocks.join("\n")}
 }
 `;
 	const bytes = new TextEncoder().encode(source).length;
-	if (bytes > 131072) throw new RangeError(`workflow-builder: the compiled source is ${bytes} bytes; dynamic workflows take at most ${DYNAMIC_SOURCE_MAX_BYTES}`);
+	if (bytes > 131072) throw new RangeError(`workflow-editor: the compiled source is ${bytes} bytes; dynamic workflows take at most ${DYNAMIC_SOURCE_MAX_BYTES}`);
 	return {
 		engine: "workflow-sdk",
 		format: 1,
@@ -178,12 +177,12 @@ function contextOf(call) {
 	};
 }
 /**
-* The `start` for `createWorkflowBuilder`: starts the published version as
+* The `start` for `createWorkflowEditor`: starts the published version as
 * dynamic source when dynamic workflows are on, and through `executor`
 * otherwise. The source is always compiled from the version's graph; a stored
-* compiled form is never run. Runs carry `bs.tenant`, `bs.actor`,
-* `bs.definition`, `bs.version` and `bs.key`, plus `bs.subject`, `bs.mode` and
-* `bs.trigger_node` when set. A live run also records its principal: the
+* compiled form is never run. Runs carry `bsb.tenant`, `bsb.actor`,
+* `bsb.definition`, `bsb.version` and `bsb.key`, plus `bsb.subject`, `bsb.mode`
+* and `bsb.trigger_node` when set. A live run also records its principal: the
 * publisher (`user`), or the app's service principal for an organization-owned
 * version. A repeated key returns the first run.
 */

package/dist/workflow-sdk/index.d.ts

@@ -1,5 +1,5 @@
 /// <reference lib="esnext.temporal" />
-import { _ as workflowContext, a as StartOnEventOptions, c as WorkflowRunAs, d as authorizeHook, f as contextAttributes, g as startOnEvent, h as startFor, i as StartForOptions, l as WorkflowRunAsFor, m as protectWebHandler, n as HookForbiddenError, o as WorkflowContextOptions, p as hookMetadata, r as ProtectWebHandlerOptions, s as WorkflowFn, t as AuthorizeHookOptions, u as WorkflowStarterOptions, v as workflowStarter } from "../workflow-sdk-BXwl1THQ.js";
+import { _ as workflowContext, a as StartOnEventOptions, c as WorkflowRunAs, d as authorizeHook, f as contextAttributes, g as startOnEvent, h as startFor, i as StartForOptions, l as WorkflowRunAsFor, m as protectWebHandler, n as HookForbiddenError, o as WorkflowContextOptions, p as hookMetadata, r as ProtectWebHandlerOptions, s as WorkflowFn, t as AuthorizeHookOptions, u as WorkflowStarterOptions, v as workflowStarter } from "../workflow-sdk-BFHu4sci.js";
 //#region src/workflow-sdk/approval-waiter.d.ts
 /** How `approvalWaiter.wait` ended. */
 type ApprovalWaitResult<P> = {
@@ -65,32 +65,35 @@ export declare function wakeOnApproval(event: ApprovalOutcomeEvent, waiter?: Pic
  * `workflow_runs`.
  */
 export declare const WORKFLOW_ATTRIBUTES: {
-  readonly tenant: "bs.tenant";
-  readonly actor: "bs.actor";
-  readonly key: "bs.key";
+  readonly tenant: "bsb.tenant";
+  readonly actor: "bsb.actor";
+  readonly key: "bsb.key";
   /** The builder definition a run started from; its alerts match on it. */
-  readonly definition: "bs.definition";
+  readonly definition: "bsb.definition";
   /** The builder version number a run started from. */
-  readonly version: "bs.version";
-  /** The opaque ticket `bs.forContext` resolves into the context a step runs as. */
-  readonly ticket: "bs.ticket";
+  readonly version: "bsb.version";
+  /**
+   * The opaque ticket `bsb.forContext` resolves into the context a step runs
+   * as.
+   */
+  readonly ticket: "bsb.ticket";
   /** The user an event or schedule start runs as (`runAs`). */
-  readonly publisher: "bs.publisher";
+  readonly publisher: "bsb.publisher";
   /** The event actor or schedule creator behind a `runAs` start, for audit only. */
-  readonly trigger: "bs.trigger";
+  readonly trigger: "bsb.trigger";
   /** The record a run belongs to, as `<type>/<id>`. */
-  readonly subject: "bs.subject";
+  readonly subject: "bsb.subject";
   /**
    * What a `runAs` run's steps run as: `user`, `service_principal`, `system` or
    * `external`.
    */
-  readonly principalKind: "bs.principal_kind";
+  readonly principalKind: "bsb.principal_kind";
   /** The id of that principal, when it has one. */
-  readonly principal: "bs.principal";
+  readonly principal: "bsb.principal";
   /** `test` for a builder test run; anything else records `live`. */
-  readonly mode: "bs.mode";
+  readonly mode: "bsb.mode";
   /** The trigger node a builder run started at. */
-  readonly triggerNode: "bs.trigger_node";
+  readonly triggerNode: "bsb.trigger_node";
 };
 //#endregion
 export { type ApprovalOutcome, type ApprovalOutcomeEvent, type ApprovalWaitOptions, type ApprovalWaitResult, type ApprovalWaiter, type AuthorizeHookOptions, HookForbiddenError, type ProtectWebHandlerOptions, type StartForOptions, type StartOnEventOptions, type WorkflowContextOptions, type WorkflowFn, type WorkflowRunAs, type WorkflowRunAsFor, type WorkflowStarterOptions, authorizeHook, contextAttributes, hookMetadata, protectWebHandler, startFor, startOnEvent, workflowContext, workflowStarter };

package/dist/workflow-sdk/index.js

@@ -1,5 +1,5 @@
-import { t as WORKFLOW_ATTRIBUTES } from "../attributes-BOFl922R.js";
-import { a as protectWebHandler, c as startOnEvent, i as hookMetadata, l as workflowContext, n as authorizeHook, r as contextAttributes, s as startFor, t as HookForbiddenError, u as workflowStarter } from "../workflow-sdk-CPGiFE1B.js";
+import { t as WORKFLOW_ATTRIBUTES } from "../attributes-Bzf51_nc.js";
+import { a as protectWebHandler, c as startOnEvent, i as hookMetadata, l as workflowContext, n as authorizeHook, r as contextAttributes, s as startFor, t as HookForbiddenError, u as workflowStarter } from "../workflow-sdk-BVlFEB5Q.js";
 import { resumeHook } from "workflow/api";
 import { createHook, sleep } from "workflow";
 //#region src/workflow-sdk/approval-waiter.ts

package/dist/workflow-sdk/world/index.d.ts

@@ -1,8 +1,8 @@
-import { o as EventHub } from "../../events-DhGgwqQA.js";
+import { o as EventHub } from "../../events-vcqenSYU.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
 import { Pool } from "pg";
 import { World } from "@workflow/world";
-//#region src/sql/modules/workflow-sdk-world.d.ts
+//#region src/sql/modules/workflow-sdk.d.ts
 declare const WORKFLOW_DELIVERY_MODES: readonly ["poll", "pg_net"];
 type WorkflowDeliveryMode = (typeof WORKFLOW_DELIVERY_MODES)[number];
 //#endregion
@@ -49,7 +49,7 @@ interface SupabaseWorldOptions {
   readonly encryptionKey?: string;
   /**
    * The jobs queue the messages wait in
-   * (`blocks.workflow-sdk-world.options.queue`).
+   * (`blocks["workflow-sdk"].options.queue`).
    */
   readonly queue?: string;
   /** The schema of the jobs functions, default `better_supabase`. */
@@ -119,9 +119,9 @@ type SupabaseWorld = World & {
 };
 /**
  * A Workflow SDK World on Supabase Postgres: the run, step, event, hook and
- * stream tables of `@workflow/world-postgres` (installed by the
- * `workflow-sdk-world` SQL module), with messages in the jobs module's queue
- * instead of graphile-worker.
+ * stream tables of `@workflow/world-postgres` (installed by the `workflow-sdk`
+ * SQL module), with messages in the queue block's queue instead of
+ * graphile-worker.
  *
  * ```ts
  * // workflow.config or WORKFLOW_TARGET_WORLD=better-supabase/workflow-sdk/world

package/dist/workflow-sdk/world/index.js

@@ -1,9 +1,9 @@
-import { n as dbError } from "../../errors-D7u24ZJH.js";
-import { o as problemResponse } from "../../problem-D0KDiYPk.js";
-import { i as sqlIdent } from "../../template-DXsGm_R0.js";
-import { i as WORLD_POSTGRES_VERSION, r as WORKFLOW_VAULT_SECRETS } from "../../workflow-sdk-world-BOEsvWmx.js";
+import { n as dbError } from "../../errors-BVFgt8BZ.js";
+import { o as problemResponse } from "../../problem-Bf0cJ7tk.js";
+import { i as sqlIdent } from "../../template-Drgg3v2J.js";
+import { i as WORLD_POSTGRES_VERSION, r as WORKFLOW_VAULT_SECRETS } from "../../workflow-sdk-Bw6_u0ar.js";
 import { n as hmacHex, r as timingSafeEqual } from "../../hmac-B3CTTlfv.js";
-import { t as watchPoolErrors } from "../../pool-errors-DOZ3oDeS.js";
+import { t as watchPoolErrors } from "../../pool-errors-JUBcGrre.js";
 import { n as memoized } from "../../optional-peer-C1NbBRJm.js";
 import { Pool } from "pg";
 import { reenqueueActiveRuns } from "@workflow/world";
@@ -306,8 +306,8 @@ function createAnalytics(pool) {
 * `@workflow/world-postgres` at `WORLD_POSTGRES_VERSION`.
 */
 const WORKFLOW_WORLD_PROTOCOL = "5.0.2";
-const JOB_HEADER = "x-bs-job";
-const SIGNATURE_HEADER = "x-bs-signature";
+const JOB_HEADER = "x-bsb-job";
+const SIGNATURE_HEADER = "x-bsb-signature";
 const FLOW_PATH = "/.well-known/workflow/v1/flow";
 const HKDF_SALT = "better-supabase/workflow";
 //#endregion
@@ -446,9 +446,9 @@ function deliveryProblem(kind, detail) {
 const backoffSeconds = (attempt) => Math.ceil(Math.exp(Math.min(attempt, 10)));
 /**
 * A Workflow SDK World on Supabase Postgres: the run, step, event, hook and
-* stream tables of `@workflow/world-postgres` (installed by the
-* `workflow-sdk-world` SQL module), with messages in the jobs module's queue
-* instead of graphile-worker.
+* stream tables of `@workflow/world-postgres` (installed by the `workflow-sdk`
+* SQL module), with messages in the queue block's queue instead of
+* graphile-worker.
 *
 * ```ts
 * // workflow.config or WORKFLOW_TARGET_WORLD=better-supabase/workflow-sdk/world
@@ -691,7 +691,7 @@ function createSupabaseWorld(options = {}) {
 					return deliveryProblem("unauthorized", "Unsigned workflow delivery: set WORKFLOW_DELIVERY_SECRET or the Vault secret workflow_delivery_secret");
 				}
 				const text = await req.text();
-				if (secret === void 0 || !await verifyDelivery(secret, req.headers.get("x-bs-signature"), "", text)) return deliveryProblem("unauthorized", "Unsigned workflow delivery");
+				if (secret === void 0 || !await verifyDelivery(secret, req.headers.get("x-bsb-signature"), "", text)) return deliveryProblem("unauthorized", "Unsigned workflow delivery");
 				return inner(new Request(req.url, {
 					method: "POST",
 					headers: req.headers,
@@ -699,7 +699,7 @@ function createSupabaseWorld(options = {}) {
 				}));
 			}
 			const text = await req.text();
-			if (secret === void 0 || !await verifyDelivery(secret, req.headers.get("x-bs-signature"), job, text)) return deliveryProblem("unauthorized", "Bad workflow delivery signature");
+			if (secret === void 0 || !await verifyDelivery(secret, req.headers.get("x-bsb-signature"), job, text)) return deliveryProblem("unauthorized", "Bad workflow delivery signature");
 			const [jobQueue, id, readCount] = job.split(":");
 			const attempts = Number(readCount);
 			let payload;