better-supabase 0.7.1 → 0.9.0

package/dist/blocks/organizations/react/server.js

@@ -0,0 +1,15 @@
+//#region src/blocks/organizations/react/server.ts
+/** The `react-server` build of `useOrganizations`: call `organizations.mine()` instead. */
+const useOrganizations = () => {
+	throw new Error("better-supabase: useOrganizations() runs in Client Components only. In Server Components call `organizations.mine()` instead.");
+};
+/** The `react-server` build of `useMembers`: call `organizations.members()` instead. */
+const useMembers = () => {
+	throw new Error("better-supabase: useMembers() runs in Client Components only. In Server Components call `organizations.members()` instead.");
+};
+/** The `react-server` build of `useInvitations`: call `organizations.invitations()` instead. */
+const useInvitations = () => {
+	throw new Error("better-supabase: useInvitations() runs in Client Components only. In Server Components call `organizations.invitations()` instead.");
+};
+//#endregion
+export { useInvitations, useMembers, useOrganizations };

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

@@ -0,0 +1,34 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as SolidController } from "../../../solid-controller-DqlvYFZa.js";
+import { A as OrganizationInvitationRow, M as OrganizationMembership, _ as OrganizationsSnapshot, a as InvitationsControllerOptions, c as MembersActions, d as MembersSnapshot, g as OrganizationsControllerOptions, j as OrganizationMember, m as OrganizationsActions, o as InvitationsSnapshot, r as InvitationsActions, u as MembersControllerOptions } from "../../../client-Cmensu7l.js";
+//#region src/blocks/organizations/solid/index.d.ts
+/**
+ * `createOrganizationsController` 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 useOrganizations<T extends {
+  readonly id: string;
+} = OrganizationMembership>(options: BlockOptions<OrganizationsControllerOptions<T>>): SolidController<OrganizationsSnapshot<T>, OrganizationsActions>;
+/**
+ * `createMembersController` 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 useMembers<T extends {
+  readonly userId: string;
+  readonly role: string;
+} = OrganizationMember>(options: BlockOptions<MembersControllerOptions<T>>): SolidController<MembersSnapshot<T>, MembersActions<T["role"]>>;
+/**
+ * `createInvitationsController` 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 useInvitations<T extends {
+  readonly id: string;
+} = OrganizationInvitationRow>(options: BlockOptions<InvitationsControllerOptions<T>>): SolidController<InvitationsSnapshot<T>, InvitationsActions>;
+//#endregion
+export type { BlockOptions, InvitationsActions, InvitationsControllerOptions, InvitationsSnapshot, MembersActions, MembersControllerOptions, MembersSnapshot, OrganizationInvitationRow, OrganizationMember, OrganizationMembership, OrganizationsActions, OrganizationsControllerOptions, OrganizationsSnapshot, SolidController };

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

@@ -0,0 +1,32 @@
+import { n as createMembersController, r as createOrganizationsController, t as createInvitationsController } from "../../../client-CilSKXNu.js";
+import { t as useBlockController } from "../../../solid-controller-DLsmrczT.js";
+//#region src/blocks/organizations/solid/index.ts
+/**
+* `createOrganizationsController` 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 useOrganizations(options) {
+	return useBlockController(createOrganizationsController, options);
+}
+/**
+* `createMembersController` 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 useMembers(options) {
+	return useBlockController(createMembersController, options);
+}
+/**
+* `createInvitationsController` 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 useInvitations(options) {
+	return useBlockController(createInvitationsController, options);
+}
+//#endregion
+export { useInvitations, useMembers, useOrganizations };

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

@@ -0,0 +1,34 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as SvelteController } from "../../../svelte-controller-DxxHEHxD.js";
+import { A as OrganizationInvitationRow, M as OrganizationMembership, _ as OrganizationsSnapshot, a as InvitationsControllerOptions, c as MembersActions, d as MembersSnapshot, g as OrganizationsControllerOptions, j as OrganizationMember, m as OrganizationsActions, o as InvitationsSnapshot, r as InvitationsActions, u as MembersControllerOptions } from "../../../client-Cmensu7l.js";
+//#region src/blocks/organizations/svelte/index.d.ts
+/**
+ * `createOrganizationsController` 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 useOrganizations<T extends {
+  readonly id: string;
+} = OrganizationMembership>(options: BlockOptions<OrganizationsControllerOptions<T>>): SvelteController<OrganizationsSnapshot<T>, OrganizationsActions>;
+/**
+ * `createMembersController` 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 useMembers<T extends {
+  readonly userId: string;
+  readonly role: string;
+} = OrganizationMember>(options: BlockOptions<MembersControllerOptions<T>>): SvelteController<MembersSnapshot<T>, MembersActions<T["role"]>>;
+/**
+ * `createInvitationsController` 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 useInvitations<T extends {
+  readonly id: string;
+} = OrganizationInvitationRow>(options: BlockOptions<InvitationsControllerOptions<T>>): SvelteController<InvitationsSnapshot<T>, InvitationsActions>;
+//#endregion
+export type { BlockOptions, InvitationsActions, InvitationsControllerOptions, InvitationsSnapshot, MembersActions, MembersControllerOptions, MembersSnapshot, OrganizationInvitationRow, OrganizationMember, OrganizationMembership, OrganizationsActions, OrganizationsControllerOptions, OrganizationsSnapshot, SvelteController };

package/dist/blocks/organizations/svelte/index.js

@@ -0,0 +1,32 @@
+import { n as createMembersController, r as createOrganizationsController, t as createInvitationsController } from "../../../client-CilSKXNu.js";
+import { t as useBlockController } from "../../../svelte-controller-CDAujo-_.js";
+//#region src/blocks/organizations/svelte/index.ts
+/**
+* `createOrganizationsController` 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 useOrganizations(options) {
+	return useBlockController(createOrganizationsController, options);
+}
+/**
+* `createMembersController` 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 useMembers(options) {
+	return useBlockController(createMembersController, options);
+}
+/**
+* `createInvitationsController` 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 useInvitations(options) {
+	return useBlockController(createInvitationsController, options);
+}
+//#endregion
+export { useInvitations, useMembers, useOrganizations };

package/dist/blocks/organizations/vue/index.d.ts

@@ -0,0 +1,34 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as VueController } from "../../../vue-controller-HPfMTDa2.js";
+import { A as OrganizationInvitationRow, M as OrganizationMembership, _ as OrganizationsSnapshot, a as InvitationsControllerOptions, c as MembersActions, d as MembersSnapshot, g as OrganizationsControllerOptions, j as OrganizationMember, m as OrganizationsActions, o as InvitationsSnapshot, r as InvitationsActions, u as MembersControllerOptions } from "../../../client-Cmensu7l.js";
+//#region src/blocks/organizations/vue/index.d.ts
+/**
+ * `createOrganizationsController` 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 useOrganizations<T extends {
+  readonly id: string;
+} = OrganizationMembership>(options: BlockOptions<OrganizationsControllerOptions<T>>): VueController<OrganizationsSnapshot<T>, OrganizationsActions>;
+/**
+ * `createMembersController` 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 useMembers<T extends {
+  readonly userId: string;
+  readonly role: string;
+} = OrganizationMember>(options: BlockOptions<MembersControllerOptions<T>>): VueController<MembersSnapshot<T>, MembersActions<T["role"]>>;
+/**
+ * `createInvitationsController` 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 useInvitations<T extends {
+  readonly id: string;
+} = OrganizationInvitationRow>(options: BlockOptions<InvitationsControllerOptions<T>>): VueController<InvitationsSnapshot<T>, InvitationsActions>;
+//#endregion
+export type { BlockOptions, InvitationsActions, InvitationsControllerOptions, InvitationsSnapshot, MembersActions, MembersControllerOptions, MembersSnapshot, OrganizationInvitationRow, OrganizationMember, OrganizationMembership, OrganizationsActions, OrganizationsControllerOptions, OrganizationsSnapshot, VueController };

package/dist/blocks/organizations/vue/index.js

@@ -0,0 +1,32 @@
+import { n as createMembersController, r as createOrganizationsController, t as createInvitationsController } from "../../../client-CilSKXNu.js";
+import { t as useBlockController } from "../../../vue-controller-C9tFzqAc.js";
+//#region src/blocks/organizations/vue/index.ts
+/**
+* `createOrganizationsController` 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 useOrganizations(options) {
+	return useBlockController(createOrganizationsController, options);
+}
+/**
+* `createMembersController` 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 useMembers(options) {
+	return useBlockController(createMembersController, options);
+}
+/**
+* `createInvitationsController` 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 useInvitations(options) {
+	return useBlockController(createInvitationsController, options);
+}
+//#endregion
+export { useInvitations, useMembers, useOrganizations };

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

@@ -1,3 +1,12 @@
-import { t as SqlClient } from "../../executor-DbvExCFC.js";
-import { a as OutboxEvent, c as OutboxPurgeOptions, d as RegisterOptions, f as RelayOptions, h as outboxCloudEvent, i as OutboxDeadLetter, l as OutboxRouteOptions, m as createOutbox, n as HistoryFilter, o as OutboxHandler, p as RelayResult, r as Outbox, s as OutboxOptions, t as EmitOptions, u as OutboxRouteResult } from "../../outbox-Cq7pPYvl.js";
-export { type EmitOptions, type HistoryFilter, type Outbox, type OutboxDeadLetter, type OutboxEvent, type OutboxHandler, type OutboxOptions, type OutboxPurgeOptions, type OutboxRouteOptions, type OutboxRouteResult, type RegisterOptions, type RelayOptions, type RelayResult, type SqlClient, createOutbox, outboxCloudEvent };
+import { n as SqlClient } from "../../executor-BBHgjUJu.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 { a as OutboxEvent, c as OutboxPurgeOptions, d as RegisterOptions, f as RelayOptions, h as outboxCloudEvent, i as OutboxDeadLetter, l as OutboxRouteOptions, m as createOutbox, n as HistoryFilter, o as OutboxHandler, p as RelayResult, r as Outbox, s as OutboxOptions, t as EmitOptions, u as OutboxRouteResult } from "../../outbox-BTeqjbum.js";
+//#region src/blocks/outbox/manifest.d.ts
+/**
+ * The `outbox` block's manifest (ADR 0029). Set the CloudEvents source with
+ * `outboxBlock.with({ source: "https://app.example.com" })`.
+ */
+export declare const outboxBlock: BlockOf<"outbox", typeof createOutbox>;
+//#endregion
+export { type BlockTransport, type EmitOptions, type HistoryFilter, type Outbox, type OutboxDeadLetter, type OutboxEvent, type OutboxHandler, type OutboxOptions, type OutboxPurgeOptions, type OutboxRouteOptions, type OutboxRouteResult, type RegisterOptions, type RelayOptions, type RelayResult, type SqlClient, createOutbox, dbTransport, outboxCloudEvent, rpcTransport, sqlTransport };

package/dist/blocks/outbox/index.js

@@ -1,9 +1,12 @@
-import { n as dbError } from "../../errors-B11Duf73.js";
-import { s as toDbError } from "../../result-DzUbqgdW.js";
-import { a as problemResponse } from "../../problem-BreOl8b8.js";
-import { r as sqlIdent } from "../../template--jDkl3UP.js";
-import { A as workerId, C as run, g as pageOf, k as toInstant, n as applyTemporal, r as asDbError } from "../../block-helpers-DWHxHsEQ.js";
-import { l as verifySharedSecret } from "../../verify-DL41hbvY.js";
+import { t as DbException } from "../../db-exception-CnWcYPxL.js";
+import { s as toDbError } from "../../result-BlgnMB0H.js";
+import "../../cloud-event-CTh9Sr5w.js";
+import { t as cronRoute } from "../../cron-route-CoL-By8Z.js";
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-G4t1umrR.js";
+import { R as toInstant, j as run, n as applyTemporal, o as blockCall, r as asDbError, s as budget, w as pageOf, z as workerId } from "../../block-helpers-CfG_MvDR.js";
+import { r as withBlockHooks } from "../../block-hooks-BsXncUlZ.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { t as outboxSqlOptions } from "../../options-SViK_2x2.js";
 //#region src/blocks/outbox/outbox.ts
 function isOutboxRow(value) {
 	return typeof value === "object" && value !== null && "position" in value && "type" in value && "created_at" in value;
@@ -46,7 +49,7 @@ function outboxCloudEvent(event, options) {
 		...event.source ? { producer: event.source } : {}
 	};
 }
-/** The outbox functions' argument names, for calls through a `BlockTransport`. */
+/** The outbox functions' argument names, in the order the client passes them. */
 const PARAMS = {
 	emit_event: [
 		"event_type",
@@ -110,36 +113,54 @@ function toDeadLetters(value) {
 		}];
 	});
 }
-const isTransport = (source) => "call" in source;
 /**
-* The outbox over a server connection (`SqlClient`), or over a
-* `BlockTransport` such as `rpcTransport(serviceClient, { schema: "api" })`
-* for apps that reach the database only through the Data API. Over a
-* transport, `emit` writes in its own transaction.
+* The outbox over a `BlockTransport`: `sqlTransport(postgres)` on a server
+* connection, where `emit` joins the caller's transaction, or
+* `rpcTransport(serviceClient)` for apps that reach the database only
+* through the Data API, where `emit` writes in its own transaction.
 */
-function createOutbox(source, options) {
+function createOutbox(options) {
 	applyTemporal(options);
-	const name = options.schema ?? "better_supabase";
-	const schema = sqlIdent(name);
-	const transport = isTransport(source) ? source : void 0;
-	const call = async (fn, args) => {
-		if (isTransport(source)) {
-			const names = PARAMS[fn] ?? [];
-			return await source.call(name, fn, Object.fromEntries(names.map((param, index) => [param, args[index]]))) ?? null;
-		}
-		const sql = source;
-		const params = args.map((_, index) => `$${String(index + 1)}`).join(", ");
-		const [row] = await sql.queryRaw(`select ${schema}.${sqlIdent(fn)}(${params}) as value`, args);
-		return row?.value ?? null;
+	const callers = {
+		user: blockCall(options.transport, options.schema, options.mappers),
+		service: blockCall(options.service ?? options.transport, options.schema, options.mappers)
 	};
+	/** Calls `fn` with positional `args`, named by `PARAMS`; a failure throws its `DbError`. */
+	const callAs = (as) => async (fn, args) => callers[as](fn, Object.fromEntries((PARAMS[fn] ?? []).map((param, index) => [param, args[index]])), (value) => value ?? null).orThrow();
+	const userCall = callAs("user");
+	const call = callAs("service");
 	const toSink = (sink) => (events) => sink.send(events.map((event) => outboxCloudEvent(event, options)));
-	async function relay(consumer, handler, relayOptions = {}, deadline) {
+	const subscribers = options.subscribers ?? options.authorization?.delivery?.subscribers;
+	/** The events `subscribers` lets `consumer` have; all of them without a policy. */
+	async function permitted(consumer, events) {
+		if (!subscribers) return events;
+		const allowed = await Promise.all(events.map(async (event) => {
+			const subscriber = {
+				principal: consumer,
+				kind: "service"
+			};
+			return (await subscribers({
+				type: event.type,
+				tenant: event.tenant,
+				actorId: event.actorId,
+				payload: event.payload,
+				subject: event.subject
+			}, [subscriber])).includes(subscriber);
+		}));
+		return events.filter((_, index) => allowed[index]);
+	}
+	async function relay(consumer, handler, relayOptions = {}, spent = budget(relayOptions.budgetMs)) {
 		const owner = relayOptions.owner ?? workerId();
 		const batch = relayOptions.batch ?? 100;
 		const lease = relayOptions.lease ?? "1 minute";
-		const until = deadline ?? (relayOptions.budgetMs === void 0 ? Number.POSITIVE_INFINITY : Date.now() + relayOptions.budgetMs);
 		let delivered = 0;
-		while (Date.now() < until) {
+		let refused = 0;
+		const done = (result) => ({
+			delivered,
+			...refused > 0 ? { refused } : {},
+			...result
+		});
+		while (!spent.expired()) {
 			let events;
 			try {
 				events = toEvents(await call("outbox_claim", [
@@ -149,10 +170,7 @@ function createOutbox(source, options) {
 					lease
 				]));
 			} catch (cause) {
-				return {
-					delivered,
-					error: asDbError(cause)
-				};
+				return done({ error: asDbError(cause) });
 			}
 			const last = events.at(-1);
 			if (last === void 0) {
@@ -163,8 +181,17 @@ function createOutbox(source, options) {
 				]).catch(() => null);
 				break;
 			}
+			let handed;
 			try {
-				await handler(events);
+				handed = await permitted(consumer, events);
+				if (handed.length > 0) {
+					const outcome = await handler(handed);
+					if (typeof outcome === "object" && outcome !== null && "ok" in outcome && outcome.ok === false && "error" in outcome) {
+						const { error } = outcome;
+						if (typeof error === "object" && error !== null && "kind" in error) throw new DbException(error);
+						throw new Error(String(error));
+					}
+				}
 			} catch (cause) {
 				const error = toDbError(cause);
 				return await call("outbox_fail", [
@@ -174,14 +201,10 @@ function createOutbox(source, options) {
 					error.message,
 					relayOptions.maxAttempts ?? 10,
 					relayOptions.maxBackoff ?? "10 minutes"
-				]).catch(() => null) === "dead" ? {
-					delivered,
+				]).catch(() => null) === "dead" ? done({
 					error,
 					deadLettered: 1
-				} : {
-					delivered,
-					error
-				};
+				}) : done({ error });
 			}
 			try {
 				await call("outbox_ack", [
@@ -190,20 +213,18 @@ function createOutbox(source, options) {
 					last.position
 				]);
 			} catch (cause) {
-				return {
-					delivered,
-					error: asDbError(cause)
-				};
+				return done({ error: asDbError(cause) });
 			}
-			delivered += events.length;
+			delivered += handed.length;
+			refused += events.length - handed.length;
 			if (events.length < batch) break;
 		}
-		return { delivered };
+		return done({});
 	}
-	return {
-		emit: (type, payload = {}, emitOptions = {}) => run(async () => String(await call("emit_event", [
+	return withBlockHooks({
+		emit: (type, payload = {}, emitOptions = {}) => run(async () => String(await userCall("emit_event", [
 			type,
-			transport ? payload : JSON.stringify(payload),
+			payload,
 			emitOptions.subject ?? null,
 			emitOptions.tenant ?? null,
 			emitOptions.key ?? null,
@@ -218,22 +239,15 @@ function createOutbox(source, options) {
 		relay: (consumer, sink, relayOptions) => relay(consumer, toSink(sink), relayOptions),
 		consume: (consumer, handler, relayOptions) => relay(consumer, handler, relayOptions),
 		relayRoute(routeOptions) {
-			const secret = routeOptions.secret;
-			if (!secret) throw new TypeError("relayRoute needs a secret, such as process.env.CRON_SECRET");
-			return async (request) => {
-				const instance = new URL(request.url).pathname;
-				if (request.method !== "GET" && request.method !== "POST") return new Response(null, {
-					status: 405,
-					headers: { allow: "GET, POST" }
-				});
-				if (!verifySharedSecret(request, secret)) return problemResponse(dbError("unauthorized", "The relay route needs its bearer secret"), {
-					instance,
-					format: routeOptions.problem
-				});
-				const deadline = Date.now() + (routeOptions.budgetMs ?? 5e4);
+			return cronRoute({
+				name: "relay",
+				secret: routeOptions.secret,
+				problem: routeOptions.problem
+			}, async () => {
+				const spent = budget(routeOptions.budgetMs ?? 5e4);
 				const entries = Object.entries(routeOptions.consumers);
 				const relayed = await Promise.all(entries.map(async ([consumer, sink]) => {
-					const result = await relay(consumer, typeof sink === "function" ? sink : toSink(sink), routeOptions, deadline);
+					const result = await relay(consumer, typeof sink === "function" ? sink : toSink(sink), routeOptions, spent);
 					if (result.error) routeOptions.onError?.(result.error, consumer);
 					return result;
 				}));
@@ -243,12 +257,12 @@ function createOutbox(source, options) {
 				});
 				const result = {
 					consumers: results,
-					budgetExhausted: Date.now() >= deadline
+					budgetExhausted: spent.expired()
 				};
 				return Response.json(result);
-			};
+			});
 		},
-		history: (filter = {}) => run(async () => toEvents(await call("outbox_history", [
+		history: (filter = {}) => run(async () => toEvents(await userCall("outbox_history", [
 			filter.subject ?? null,
 			filter.type ?? null,
 			pageOf(filter).cursor ?? 0,
@@ -260,7 +274,23 @@ function createOutbox(source, options) {
 			batch ?? null,
 			purgeOptions.ignoreIdle ?? null
 		])))
-	};
+	}, options.hooks, {
+		block: "outbox",
+		...options.logger ? { logger: options.logger } : {}
+	});
 }
 //#endregion
-export { createOutbox, outboxCloudEvent };
+//#region src/blocks/outbox/manifest.ts
+/**
+* The `outbox` block's manifest (ADR 0029). Set the CloudEvents source with
+* `outboxBlock.with({ source: "https://app.example.com" })`.
+*/
+const outboxBlock = defineBlock({
+	name: "outbox",
+	sql: ["outbox"],
+	options: { outbox: outboxSqlOptions },
+	create: createOutbox,
+	category: "automation"
+});
+//#endregion
+export { createOutbox, dbTransport, outboxBlock, outboxCloudEvent, rpcTransport, sqlTransport };