better-supabase 0.14.0 → 0.15.0

package/dist/blocks/inbox/index.js

@@ -1,11 +1,11 @@
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
-import { t as inboxSqlOptions } from "../../options-D7sgG1bQ.js";
-import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, F as stringsOf, H as rpcTransport, I as textOf, M as seconds, O as recordOrEmpty, R as toInstant, U as sqlTransport, b as oneOf, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall, v as nullableInstant, w as pageOf, y as nullableText } from "../../block-helpers-CiKtrb6g.js";
-import { r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
+import { n as INBOX_AUTOMATIONS, r as inboxSqlOptions, t as CONVERSATION_TO_TASK } from "../../automations-CD1XlL2W.js";
+import { n as whileSignedIn, t as defineController } from "../../controller-BEliOBOv.js";
+import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, F as stringsOf, H as rpcTransport, I as textOf$1, M as seconds, O as recordOrEmpty, R as toInstant, U as sqlTransport, b as oneOf, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall, v as nullableInstant, w as pageOf, y as nullableText } from "../../block-helpers-CtBdjgO4.js";
+import { r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
-import { n as defineBlock } from "../../define-block-Dze77QTw.js";
-import { a as reactionsOf, r as messageOf$1 } from "../../rows-Bb0EPupt.js";
-import { n as createInboxController, r as createInboxWidgetController, t as createConversationController } from "../../client-BW3-RUbq.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+import { a as reactionsOf, r as messageOf$1 } from "../../rows-BDLZStp4.js";
 //#region src/blocks/inbox/rows.ts
 const INBOX_CHANNELS = [
 	"in_app",
@@ -31,9 +31,9 @@ const botModeOf = (value) => oneOf(value, [
 function inboxOf(value) {
 	const row = recordOf(value, "inbox");
 	return {
-		id: textOf(row["id"]),
-		tenant: textOf(row["tenant_id"]),
-		name: textOf(row["name"]),
+		id: textOf$1(row["id"]),
+		tenant: textOf$1(row["tenant_id"]),
+		name: textOf$1(row["name"]),
 		channel: channelOf(row["channel"]),
 		address: nullableText(row["channel_address"]),
 		installationId: nullableText(row["installation_id"]),
@@ -46,8 +46,8 @@ function inboxOf(value) {
 function contactOf(value) {
 	const row = recordOf(value, "contact");
 	return {
-		id: textOf(row["id"]),
-		...row["tenant_id"] === void 0 ? {} : { tenant: textOf(row["tenant_id"]) },
+		id: textOf$1(row["id"]),
+		...row["tenant_id"] === void 0 ? {} : { tenant: textOf$1(row["tenant_id"]) },
 		userId: nullableText(row["user_id"]),
 		name: nullableText(row["name"]),
 		email: nullableText(row["email"]),
@@ -60,10 +60,10 @@ function conversationOf(value) {
 	const row = recordOf(value, "conversation");
 	const inbox = isRecord(row["inbox"]) ? row["inbox"] : void 0;
 	return {
-		id: textOf(row["id"]),
-		tenant: textOf(row["tenant_id"]),
-		inboxId: textOf(row["inbox_id"]),
-		contactId: textOf(row["contact_id"]),
+		id: textOf$1(row["id"]),
+		tenant: textOf$1(row["tenant_id"]),
+		inboxId: textOf$1(row["inbox_id"]),
+		contactId: textOf$1(row["contact_id"]),
 		subject: nullableText(row["subject"]),
 		status: oneOf(row["status"], [
 			"open",
@@ -80,7 +80,7 @@ function conversationOf(value) {
 		assigneeId: nullableText(row["assignee_id"]),
 		teamId: nullableText(row["team_id"]),
 		botMode: botModeOf(row["bot_mode"]),
-		threadId: textOf(row["thread_id"]),
+		threadId: textOf$1(row["thread_id"]),
 		snoozedUntil: nullableInstant(row["snoozed_until"]),
 		lastMessageAt: nullableInstant(row["last_message_at"]),
 		preview: nullableText(row["last_message_preview"]),
@@ -90,8 +90,8 @@ function conversationOf(value) {
 		createdAt: requiredInstant(row["created_at"], "conversation.created_at"),
 		contact: isRecord(row["contact"]) ? contactOf(row["contact"]) : null,
 		inbox: inbox ? {
-			id: textOf(inbox["id"]),
-			name: textOf(inbox["name"]),
+			id: textOf$1(inbox["id"]),
+			name: textOf$1(inbox["name"]),
 			channel: channelOf(inbox["channel"])
 		} : null,
 		lastReadAt: nullableInstant(row["last_read_at"]),
@@ -116,7 +116,7 @@ function messageOf(value) {
 		replyTo: nullableText(row["reply_to"]),
 		metadata: recordOrEmpty(row["metadata"]),
 		...row["delivery"] === void 0 ? {} : { delivery: delivery ? {
-			channel: textOf(delivery["channel"]),
+			channel: textOf$1(delivery["channel"]),
 			status: deliveryStatusOf(delivery["status"]),
 			error: nullableText(delivery["error"])
 		} : null }
@@ -132,8 +132,8 @@ const deliveryStatusOf = (value) => oneOf(value, [
 const conversationsOf = (value) => recordsOf(value, "list_inbox_conversations").map(conversationOf);
 const messagesOf = (value) => recordsOf(value, "list_inbox_messages").map(messageOf);
 const eventsOf = (value) => recordsOf(value, "list_conversation_events").map((row) => ({
-	id: textOf(row["id"]),
-	type: textOf(row["type"]),
+	id: textOf$1(row["id"]),
+	type: textOf$1(row["type"]),
 	actorId: nullableText(row["actor_id"]),
 	data: recordOrEmpty(row["data"]),
 	createdAt: requiredInstant(row["created_at"], "event.created_at")
@@ -154,18 +154,18 @@ function purgedOf(value) {
 		conversations: Number(row["conversations"] ?? 0),
 		messages: Number(row["messages"] ?? 0),
 		attachments: Array.isArray(files) ? files.filter(isRecord).map((file) => ({
-			bucket: textOf(file["bucket"]),
-			path: textOf(file["path"])
+			bucket: textOf$1(file["bucket"]),
+			path: textOf$1(file["path"])
 		})) : []
 	};
 }
 function inboundOf(value) {
 	const row = recordOf(value, "record_inbound");
 	return {
-		conversationId: textOf(row["conversation_id"]),
-		messageId: textOf(row["message_id"]),
-		contactId: textOf(row["contact_id"]),
-		tenant: textOf(row["tenant_id"]),
+		conversationId: textOf$1(row["conversation_id"]),
+		messageId: textOf$1(row["message_id"]),
+		contactId: textOf$1(row["contact_id"]),
+		tenant: textOf$1(row["tenant_id"]),
 		created: row["created"] === true,
 		duplicate: row["duplicate"] === true
 	};
@@ -173,13 +173,13 @@ function inboundOf(value) {
 function templateOf(value) {
 	const row = recordOf(value, "message_template");
 	return {
-		id: textOf(row["id"]),
-		tenant: textOf(row["tenant_id"]),
+		id: textOf$1(row["id"]),
+		tenant: textOf$1(row["tenant_id"]),
 		inboxId: nullableText(row["inbox_id"]),
-		name: textOf(row["name"]),
-		channel: textOf(row["channel"]),
-		language: textOf(row["language"]),
-		body: textOf(row["body"]),
+		name: textOf$1(row["name"]),
+		channel: textOf$1(row["channel"]),
+		language: textOf$1(row["language"]),
+		body: textOf$1(row["body"]),
 		variables: stringsOf(row["variables"]),
 		externalId: nullableText(row["external_id"])
 	};
@@ -189,10 +189,10 @@ function scheduledOf(value) {
 	const input = recordOrEmpty(row["input"]);
 	const format = input["format"];
 	return {
-		id: textOf(row["id"]),
-		tenant: textOf(row["tenant_id"]),
-		conversationId: textOf(row["conversation_id"]),
-		authorId: textOf(row["author_id"]),
+		id: textOf$1(row["id"]),
+		tenant: textOf$1(row["tenant_id"]),
+		conversationId: textOf$1(row["conversation_id"]),
+		authorId: textOf$1(row["author_id"]),
 		body: optionalText(input["body"]) ?? "",
 		format: format === "text" || format === "markdown" ? format : null,
 		attachments: stringsOf(input["attachments"]),
@@ -206,15 +206,15 @@ function scheduledOf(value) {
 const scheduledListOf = (value) => recordsOf(value, "list_scheduled_inbox_messages").map(scheduledOf);
 const storedEventsOf = (value) => recordsOf(value, "pending_inbound_events").map((row) => {
 	const headers = {};
-	for (const [key, header] of Object.entries(recordOrEmpty(row["headers"]))) headers[key] = textOf(header);
+	for (const [key, header] of Object.entries(recordOrEmpty(row["headers"]))) headers[key] = textOf$1(header);
 	return {
-		id: textOf(row["id"]),
-		adapter: textOf(row["adapter"]),
+		id: textOf$1(row["id"]),
+		adapter: textOf$1(row["adapter"]),
 		externalId: nullableText(row["external_id"]),
 		inboxId: nullableText(row["inbox_id"]),
 		tenant: nullableText(row["tenant_id"]),
 		headers,
-		body: textOf(row["body"]),
+		body: textOf$1(row["body"]),
 		attempts: Number(row["attempts"] ?? 0),
 		receivedAt: requiredInstant(row["received_at"], "inbound_event.received_at")
 	};
@@ -237,22 +237,22 @@ function sourceOf(value) {
 	};
 }
 const pendingFilesOf = (value) => recordsOf(value, "pending_inbox_files").map((row) => ({
-	id: textOf(row["id"]),
-	conversationId: textOf(row["conversation_id"]),
-	messageId: textOf(row["message_id"]),
-	tenant: textOf(row["tenant_id"]),
-	bucket: textOf(row["bucket"]),
-	path: textOf(row["object_path"]),
-	name: textOf(row["name"]),
+	id: textOf$1(row["id"]),
+	conversationId: textOf$1(row["conversation_id"]),
+	messageId: textOf$1(row["message_id"]),
+	tenant: textOf$1(row["tenant_id"]),
+	bucket: textOf$1(row["bucket"]),
+	path: textOf$1(row["object_path"]),
+	name: textOf$1(row["name"]),
 	mimeType: optionalText(row["mime_type"]),
 	source: sourceOf(row["source"])
 }));
 function uploadOf(value) {
 	const row = recordOf(value, "create_inbox_attachment");
 	return {
-		id: textOf(row["id"]),
-		bucket: textOf(row["bucket"]),
-		path: textOf(row["object_path"])
+		id: textOf$1(row["id"]),
+		bucket: textOf$1(row["bucket"]),
+		path: textOf$1(row["object_path"])
 	};
 }
 //#endregion
@@ -374,8 +374,8 @@ function createInbox(options) {
 			}, (value) => {
 				const row = recordOf(value, "create_inbox_team");
 				return {
-					id: textOf(row["id"]),
-					name: textOf(row["name"])
+					id: textOf$1(row["id"]),
+					name: textOf$1(row["name"])
 				};
 			}),
 			setTeamMember: (teamId, userId, present = true) => call("set_inbox_team_member", {
@@ -534,7 +534,7 @@ function createInbox(options) {
 			}, (value) => {
 				const row = recordOf(value, "store_inbound_event");
 				return {
-					id: textOf(row["id"]),
+					id: textOf$1(row["id"]),
 					duplicate: row["duplicate"] === true
 				};
 			}),
@@ -608,6 +608,239 @@ function createInbox(options) {
 	});
 }
 //#endregion
+//#region src/blocks/inbox/client.ts
+function loader(load, state) {
+	return async () => {
+		try {
+			state.set({
+				items: await load(),
+				error: void 0
+			});
+		} catch (cause) {
+			state.set({ error: cause });
+		}
+	};
+}
+/**
+* The staff view of an organization's conversations, kept current: loads, then
+* loads again after each ping on `inbox:org:<id>` and on rejoin.
+*/
+function createInboxController(options) {
+	const topic = options.organizationId === null ? null : `${options.topic ?? "inbox"}:org:${options.organizationId}`;
+	return defineController({
+		items: void 0,
+		status: "closed",
+		error: void 0
+	}, (state) => {
+		const refresh = loader(options.load, state);
+		return {
+			actions: { refresh },
+			start: () => {
+				if (topic === null) return;
+				return whileSignedIn(options.auth, () => {
+					refresh();
+					return options.ports.topic(topic, {
+						onMessage: (event, payload) => {
+							options.onMessage?.(event, payload);
+							refresh();
+						},
+						onRejoin: () => void refresh(),
+						onStatus: (status) => {
+							state.set({ status });
+						}
+					}).leave;
+				});
+			}
+		};
+	});
+}
+const NO_TYPERS = [];
+const textOf = (value) => typeof value === "string" ? value : void 0;
+/** `items` with `message` replaced in place, or added last. */
+function upsert(items, message) {
+	const at = items.findIndex((item) => item.id === message.id);
+	return at === -1 ? [...items, message] : items.with(at, message);
+}
+/**
+* One conversation's messages, kept current over the messaging topic
+* `messages:<id>`: each ping fetches the one message it names, so the thread
+* never reloads on a change. Typing pings go both ways between staff and the
+* contact; notes stay out for the contact because `get` returns `null`.
+*/
+function createConversationController(options) {
+	const typingMs = options.typingMs ?? 5e3;
+	const topic = options.conversationId === null ? null : `${options.topic ?? "messages"}:${options.conversationId}`;
+	let joined;
+	return defineController({
+		items: void 0,
+		status: "closed",
+		error: void 0,
+		typing: NO_TYPERS
+	}, (state) => {
+		const refresh = loader(options.load, state);
+		const fetchOne = async (messageId) => {
+			try {
+				const message = await options.get(messageId);
+				if (message !== null) state.set((current) => ({ items: upsert(current.items ?? [], message) }));
+			} catch (cause) {
+				state.set({ error: cause });
+			}
+		};
+		const join = (name, userId) => {
+			const seen = /* @__PURE__ */ new Map();
+			const typer = (who, on) => {
+				const timer = seen.get(who);
+				if (timer !== void 0) clearTimeout(timer);
+				if (on) seen.set(who, setTimeout(() => {
+					typer(who, false);
+				}, typingMs));
+				else seen.delete(who);
+				state.set({ typing: [...seen.keys()] });
+			};
+			const handle = options.ports.topic(name, {
+				onMessage: (event, payload) => {
+					const data = typeof payload === "object" && payload !== null ? { ...payload } : {};
+					if (event === "typing") {
+						const who = textOf(data["userId"]);
+						if (who !== void 0 && who !== userId) typer(who, data["typing"] !== false);
+						return;
+					}
+					const messageId = textOf(data["messageId"]);
+					if (messageId === void 0) {
+						options.onEvent?.(event, payload);
+						return;
+					}
+					fetchOne(messageId);
+				},
+				onRejoin: () => void refresh(),
+				onStatus: (status) => {
+					state.set({ status });
+				}
+			});
+			joined = {
+				userId,
+				send: (on) => {
+					handle.send("typing", {
+						conversationId: options.conversationId,
+						userId,
+						typing: on
+					});
+				}
+			};
+			return () => {
+				for (const timer of seen.values()) clearTimeout(timer);
+				joined = void 0;
+				handle.leave();
+				state.set({ typing: NO_TYPERS });
+			};
+		};
+		return {
+			actions: {
+				refresh,
+				setTyping: (on) => {
+					joined?.send(on);
+				}
+			},
+			start: () => {
+				if (topic === null) return;
+				return whileSignedIn(options.auth, (userId) => {
+					refresh();
+					return join(topic, userId);
+				});
+			}
+		};
+	});
+}
+/**
+* The visitor side of an in-app inbox: the first message opens the
+* conversation, later ones go into it, and the messages and typing pings stay
+* current. Visitors without an account sign in anonymously first.
+*/
+function createInboxWidgetController(options) {
+	const key = options.storageKey === void 0 ? "better-supabase:inbox-widget" : options.storageKey;
+	const storage = key === null ? void 0 : options.ports.storage;
+	let conversationId = null;
+	let restored = storage === void 0;
+	let active = false;
+	let inner;
+	let leaveInner;
+	return defineController({
+		items: void 0,
+		status: "closed",
+		error: void 0,
+		typing: NO_TYPERS,
+		conversationId: null
+	}, (state) => {
+		let show = () => void 0;
+		const attach = () => {
+			leaveInner?.();
+			leaveInner = active ? inner?.subscribe(show) : void 0;
+		};
+		const follow = () => {
+			const id = conversationId;
+			const current = createConversationController({
+				auth: options.auth,
+				ports: options.ports,
+				conversationId: id,
+				load: () => id === null ? Promise.resolve([]) : options.load(id),
+				get: options.get,
+				...options.topic === void 0 ? {} : { topic: options.topic }
+			});
+			inner = current;
+			show = () => {
+				state.set({
+					...current.getSnapshot(),
+					conversationId: id
+				});
+			};
+			show();
+			attach();
+		};
+		const choose = (id) => {
+			if (id === conversationId) return;
+			conversationId = id;
+			follow();
+		};
+		follow();
+		return {
+			actions: {
+				refresh: () => inner?.actions.refresh() ?? Promise.resolve(),
+				setTyping: (on) => {
+					inner?.actions.setTyping(on);
+				},
+				submit: async (message) => {
+					if (conversationId === null) {
+						const id = await options.open(message);
+						if (key !== null) await storage?.set(key, id);
+						choose(id);
+						return;
+					}
+					await options.send(conversationId, message);
+				},
+				reset: () => {
+					if (key !== null) storage?.remove(key);
+					choose(null);
+				}
+			},
+			start: () => {
+				active = true;
+				attach();
+				if (!restored && key !== null && storage) {
+					restored = true;
+					storage.get(key).then((stored) => {
+						if (stored !== null && conversationId === null) choose(stored);
+					});
+				}
+				return () => {
+					active = false;
+					leaveInner?.();
+					leaveInner = void 0;
+				};
+			}
+		};
+	});
+}
+//#endregion
 //#region src/blocks/inbox/events.ts
 /** The `inbox` block's event types, for its manifest and `onBlockEvent`. */
 const inboxEvents = defineEvents({
@@ -629,7 +862,8 @@ const inboxBlock = defineBlock({
 	create: createInbox,
 	client: "inbox",
 	category: "messaging",
-	recipes: ["inbox-threads"]
+	recipes: ["inbox-threads"],
+	automations: INBOX_AUTOMATIONS
 });
 //#endregion
-export { INBOX_CHANNELS, createConversationController, createInbox, createInboxController, createInboxWidgetController, dbTransport, inboxBlock, inboxEvents, rpcTransport, sqlTransport };
+export { CONVERSATION_TO_TASK, INBOX_AUTOMATIONS, INBOX_CHANNELS, createConversationController, createInbox, createInboxController, createInboxWidgetController, dbTransport, inboxBlock, inboxEvents, rpcTransport, sqlTransport };

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

@@ -1,13 +1,13 @@
 /// <reference lib="esnext.temporal" />
-import { T as ErrorMapper, t as AsyncResult } from "../../result-C6jDfedy.js";
-import { t as StandardSchemaV1 } from "../../standard-DbQsD2xZ.js";
-import { n as ExtraFields, r as FieldsOf } from "../../block-fields-3w4MZr8U.js";
-import { Ct as Events } from "../../events-DbLjvxDX.js";
+import { T as ErrorMapper, t as AsyncResult } from "../../result-DZeA5KS6.js";
+import { t as StandardSchemaV1 } from "../../standard-DBV730sF.js";
+import { n as ExtraFields, r as FieldsOf } from "../../block-fields-BE7pInWZ.js";
+import { Ct as Events } from "../../events-vcqenSYU.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { r as BlockTemporalOptions } from "../../block-helpers-BaugZlJV.js";
-import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
-import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-CmjPKqQ_.js";
-import { c as BlockOf, rn as EntitySchema } from "../../define-block-COpcS6aT.js";
+import { r as BlockTemporalOptions } from "../../block-helpers-CRpAHrp_.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-DZN2w69m.js";
+import { Sn as EntitySchema, c as BlockOf } from "../../define-block-BVcLQ3DF.js";
 //#region src/blocks/incidents/incidents.d.ts
 interface IncidentsOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockTemporalOptions {
   readonly transport: BlockTransport;

package/dist/blocks/incidents/index.js

@@ -1,13 +1,13 @@
-import { t as temporal } from "../../temporal-required-B8qQHYbI.js";
-import { t as AsyncResult } from "../../result-B3m7xtRY.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
+import { t as temporal } from "../../temporal-required-Dy0GGD8E.js";
+import { t as AsyncResult } from "../../result-ntFBW2p2.js";
 import { t as incidentsSqlOptions } from "../../options-DJ-aYPVN.js";
-import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, S as optionalInstant, U as sqlTransport, d as enumOrThrow, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall } from "../../block-helpers-CiKtrb6g.js";
-import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
-import { n as entitySchema } from "../../entity-schema-BXXC1NnT.js";
+import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, S as optionalInstant, U as sqlTransport, d as enumOrThrow, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall } from "../../block-helpers-CtBdjgO4.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
+import { n as entitySchema } from "../../entity-schema-BDv6w-OQ.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
-import { n as blockFields } from "../../block-fields-DBSJSeaO.js";
-import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { n as blockFields } from "../../block-fields-DE_FgpOU.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
 //#region src/blocks/incidents/incidents.ts
 const SEVERITIES$1 = [
 	"sev1",

package/dist/blocks/index.d.ts

@@ -1,16 +1,36 @@
 /// <reference lib="esnext.temporal" />
-import { b as DbError, t as AsyncResult } from "../result-C6jDfedy.js";
-import { a as WithExtraFields, n as ExtraFields, o as blockFields, r as FieldsOf, t as BlockFields } from "../block-fields-3w4MZr8U.js";
-import { dt as SubjectRef } from "../executor-CPyrQdjh.js";
-import { Ct as Events, Dt as mergeEvents, Et as event, St as EventSpec, Tt as defineEvents, bt as EventMap, w as BlockEmit, xt as EventMapOf } from "../events-DbLjvxDX.js";
-import { f as onBlockEvent } from "../index-D4420jLW.js";
-import { a as BlockTenantOptions, i as CursorPageOptions, n as BlockOptions, o as BlockTenant } from "../block-helpers-BaugZlJV.js";
-import { a as dbTransport, i as RpcClient, n as DbTransportOptions, o as rpcTransport, r as DbTransportSource, s as sqlTransport, t as BlockTransport } from "../block-transport-d53POsem.js";
-import { a as BlockTransportMiddleware, c as ExtendBlockTools, d as extendBlock, f as withBlockHooks, i as BlockMethodName, l as WithBlockHooksOptions, n as BlockHooks, o as BlockTransportRequest, p as wrapTransport, r as BlockMethodHooks, s as ExtendBlockOptions, t as BlockHookInfo, u as defineTransportMiddleware } from "../block-hooks-CmjPKqQ_.js";
-import { n as FinalRunState, r as RunState, t as FINAL_RUN_STATES } from "../run-state-CPo-1X2B.js";
-import { a as OptionKind, c as blockOptions, i as OptionInput, l as option, n as NO_OPTIONS, o as OptionSpec, r as OptionBuilders, s as OptionSpecs, t as BlockOptionsSchema, u as optionsJsonSchema } from "../options-289GJc2l.js";
-import { At as BlocksHooks, Bt as SectionMap, Ct as BlockClientSource, Dt as BlockSinks, Et as BlockSet, Mt as createBlockClient, Nt as createBlocks, Ot as Blocks, Pt as defineBlocks, St as BlockClientOptions, Tt as BlockMap, _ as Notifier, a as BlockConsumes, an as EntitySchemas, c as BlockOf, cn as GeneratedBlocks, d as ClientOf, dn as BlockNaming, f as ConsumedPorts, fn as blockNames, g as BlockPorts, gn as entityNames, h as defineBlock, hn as EntityRename, i as BlockCategory, in as EntitySchemaSpec, jt as CreateBlocksOptions, kt as BlocksEventMap, l as BlockOptionSchemas, ln as fillTopic, m as UsingOptions, mn as EntityNoun, n as BLOCK_CATEGORIES, nn as EntityFieldSpecs, o as BlockDefinition, on as entitySchema, p as ProvidedPorts, pn as EntityNames, r as Block, rn as EntitySchema, s as BlockInvalidates, sn as GeneratedBlock, t as AnyBlock, tn as BlockSchemas, u as BlockProvides, un as generatedOptions, v as NotifierInput, wt as BlockContext, xt as BLOCK_EVENT_SOURCE, y as PortName } from "../define-block-COpcS6aT.js";
-import { t as subjectKey } from "../block-subjects-FHwLlIHU.js";
+import { b as DbError, t as AsyncResult } from "../result-DZeA5KS6.js";
+import { a as WithExtraFields, n as ExtraFields, o as blockFields, r as FieldsOf, t as BlockFields } from "../block-fields-BE7pInWZ.js";
+import { $ as RecordRef } from "../types-DFdg_4yN.js";
+import { Ct as Events, Dt as mergeEvents, Et as event, St as EventSpec, Tt as defineEvents, bt as EventMap, w as BlockEmit, xt as EventMapOf } from "../events-vcqenSYU.js";
+import { z as onBlockEvent } from "../index-CG9rA8H8.js";
+import { a as BlockTenantOptions, i as CursorPageOptions, n as BlockOptions, o as BlockTenant } from "../block-helpers-CRpAHrp_.js";
+import { a as dbTransport, i as RpcClient, n as DbTransportOptions, o as rpcTransport, r as DbTransportSource, s as sqlTransport, t as BlockTransport } from "../block-transport-DWZSJrwN.js";
+import { a as BlockTransportMiddleware, c as ExtendBlockTools, d as extendBlock, f as withBlockHooks, i as BlockMethodName, l as WithBlockHooksOptions, n as BlockHooks, o as BlockTransportRequest, p as wrapTransport, r as BlockMethodHooks, s as ExtendBlockOptions, t as BlockHookInfo, u as defineTransportMiddleware } from "../block-hooks-DZN2w69m.js";
+import { n as FinalRunState, r as RunState, t as FINAL_RUN_STATES } from "../run-state-BMCD_1Lt.js";
+import { a as OptionKind, c as blockOptions, i as OptionInput, l as option, n as NO_OPTIONS, o as OptionSpec, r as OptionBuilders, s as OptionSpecs, t as BlockOptionsSchema, u as optionsJsonSchema } from "../options-CsGl5BLH.js";
+import { A as CreateBlocksOptions, An as BlockNaming, C as BlockContext, Cn as EntitySchemaSpec, D as Blocks, Dn as GeneratedBlocks, E as BlockSinks, En as GeneratedBlock, F as BlockPorts, Fn as entityNames, I as Notifier, L as NotifierInput, M as createBlockClient, Mn as EntityNames, N as createBlocks, Nn as EntityNoun, O as BlocksEventMap, On as fillTopic, P as defineBlocks, Pn as EntityRename, R as PortName, S as BlockClientSource, Sn as EntitySchema, T as BlockSet, Tn as entitySchema, _ as BlockProvider, a as BlockConsumes, b as BLOCK_EVENT_SOURCE, bn as BlockSchemas, c as BlockOf, d as ClientOf, f as ConsumedPorts, g as BlockEnvKey, h as defineBlock, i as BlockCategory, j as UniquePort, jn as blockNames, k as BlocksHooks, kn as generatedOptions, l as BlockOptionSchemas, m as UsingOptions, n as BLOCK_CATEGORIES, o as BlockDefinition, p as ProvidedPorts, r as Block, s as BlockInvalidates, t as AnyBlock, tn as AnyRecordBinding, u as BlockProvides, v as BlockWiring, w as BlockMap, wn as EntitySchemas, x as BlockClientOptions, xn as EntityFieldSpecs, y as BlockWorker } from "../define-block-BVcLQ3DF.js";
+import { t as VisibleRange } from "../range-p5V4rBhZ.js";
+import { t as subjectKey } from "../block-subjects-CphkQPxp.js";
+import { t as BlockEnv } from "../block-env-B_uEM2xz.js";
+//#region src/blocks/block-env-options.d.ts
+/** What a hook passes a block creator from the env. */
+interface EnvBlockOptions {
+  readonly transport: BlockTransport;
+  readonly schema?: string;
+}
+/**
+ * A block's transport and schema for a hook: the supabase-js client calls the
+ * schema and the function names `gen` wrote for `block` in `blockConfig`, or
+ * the module defaults when the client has no config.
+ */
+export declare function envBlockOptions(env: BlockEnv, block: string): EnvBlockOptions;
+/**
+ * The options `gen` wrote for `block`, such as the reactions `topic`; empty
+ * when the client has no config.
+ */
+export declare function envBlockSettings(env: BlockEnv, block: string): GeneratedBlock["options"];
+//#endregion
 //#region src/blocks/rename-block.d.ts
 /** One renamed noun as `blocks.generated.ts` writes it. */
 interface NounRename {
@@ -116,16 +136,15 @@ type RenamedBlock<B, R extends NounRenames> = B extends Block<infer Name, infer
  * (`projectId` to `initiativeId`) and event types (`work_item.created` to
  * `task.created`), with the same `name`, SQL and ports. Hooks see the renamed
  * client. Pass the block's `names` from `blocks.generated.ts`, which `gen`
- * writes as `export const tasksBlock = renameBlock(workItemsBlock,
- * blockConfig["work-items"].names)`; with no renamed entity it returns
- * `block`.
+ * writes as `export const tasksBlock = renameBlock(tasksBlock,
+ * blockConfig["tasks"].names)`; with no renamed entity it returns `block`.
  */
-export declare function renameBlock<Name extends string, O, Client, M extends EventMap, C extends BlockConsumes, P extends PortName, S extends SectionMap, const N extends BlockNaming | undefined>(block: Block<Name, O, Client, M, C, P, S>, names: N): RenamedBlock<Block<Name, O, Client, M, C, P, S>, RenamesOf<N>>;
+export declare function renameBlock<Name extends string, O, Client, M extends EventMap, C extends BlockConsumes, P extends PortName, R extends AnyRecordBinding | undefined, const N extends BlockNaming | undefined>(block: Block<Name, O, Client, M, C, P, R>, names: N): RenamedBlock<Block<Name, O, Client, M, C, P, R>, RenamesOf<N>>;
 //#endregion
 //#region src/blocks/app-table-events.d.ts
 /**
  * The data of an app table event (ADR 0048): `<type>.created`, `.updated` and
- * `.deleted`, written by the trigger `appTables.<table>.events` adds.
+ * `.deleted`, written by the trigger `tables.<table>.events` adds.
  */
 interface AppTableEventData {
   /** The row id. */
@@ -141,4 +160,4 @@ interface AppTableEventData {
   readonly [column: string]: unknown;
 }
 //#endregion
-export { type AnyBlock, type AppTableEventData, BLOCK_CATEGORIES, BLOCK_EVENT_SOURCE, type Block, type BlockCategory, type BlockClientOptions, type BlockClientSource, type BlockConsumes, type BlockContext, type BlockDefinition, type BlockEmit, type BlockFields, type BlockHookInfo, type BlockHooks, type BlockInvalidates, type BlockMap, type BlockMethodHooks, type BlockMethodName, type BlockNaming, type BlockOf, type BlockOptionSchemas, type BlockOptions, type BlockOptionsSchema, type BlockPorts, type BlockProvides, type BlockSchemas, type BlockSet, type BlockSinks, type BlockTenant, type BlockTenantOptions, type BlockTransport, type BlockTransportMiddleware, type BlockTransportRequest, type Blocks, type BlocksEventMap, type BlocksHooks, type ClientOf, type ConsumedPorts, type CreateBlocksOptions, type CursorPageOptions, type DbTransportOptions, type DbTransportSource, type EntityFieldSpecs, type EntityNames, type EntityNoun, type EntityRename, type EntitySchema, type EntitySchemaSpec, type EntitySchemas, type EventMap, type EventMapOf, type EventSpec, type Events, type ExtendBlockOptions, type ExtendBlockTools, type ExtraFields, FINAL_RUN_STATES, type FieldsOf, type FinalRunState, type GeneratedBlock, type GeneratedBlocks, NO_OPTIONS, type Notifier, type NotifierInput, type NounRename, type NounRenames, type OptionBuilders, type OptionInput, type OptionKind, type OptionSpec, type OptionSpecs, type PortName, type ProvidedPorts, type RenameKey, type RenamedBlock, type RenamedClient, type RenamedEvents, type RenamedOptions, type RenamedType, type RenamesOf, type RpcClient, type RunState, type SubjectRef, type UsingOptions, type WithBlockHooksOptions, type WithExtraFields, blockFields, blockNames, blockOptions, createBlockClient, createBlocks, dbTransport, defineBlock, defineBlocks, defineEvents, defineTransportMiddleware, entityNames, entitySchema, event, extendBlock, fillTopic, generatedOptions, mergeEvents, onBlockEvent, option, optionsJsonSchema, rpcTransport, sqlTransport, subjectKey, withBlockHooks, wrapTransport };
+export { type AnyBlock, type AppTableEventData, BLOCK_CATEGORIES, BLOCK_EVENT_SOURCE, type Block, type BlockCategory, type BlockClientOptions, type BlockClientSource, type BlockConsumes, type BlockContext, type BlockDefinition, type BlockEmit, type BlockEnv, type BlockEnvKey, type BlockFields, type BlockHookInfo, type BlockHooks, type BlockInvalidates, type BlockMap, type BlockMethodHooks, type BlockMethodName, type BlockNaming, type BlockOf, type BlockOptionSchemas, type BlockOptions, type BlockOptionsSchema, type BlockPorts, type BlockProvider, type BlockProvides, type BlockSchemas, type BlockSet, type BlockSinks, type BlockTenant, type BlockTenantOptions, type BlockTransport, type BlockTransportMiddleware, type BlockTransportRequest, type BlockWiring, type BlockWorker, type Blocks, type BlocksEventMap, type BlocksHooks, type ClientOf, type ConsumedPorts, type CreateBlocksOptions, type CursorPageOptions, type DbTransportOptions, type DbTransportSource, type EntityFieldSpecs, type EntityNames, type EntityNoun, type EntityRename, type EntitySchema, type EntitySchemaSpec, type EntitySchemas, type EnvBlockOptions, type EventMap, type EventMapOf, type EventSpec, type Events, type ExtendBlockOptions, type ExtendBlockTools, type ExtraFields, FINAL_RUN_STATES, type FieldsOf, type FinalRunState, type GeneratedBlock, type GeneratedBlocks, NO_OPTIONS, type Notifier, type NotifierInput, type NounRename, type NounRenames, type OptionBuilders, type OptionInput, type OptionKind, type OptionSpec, type OptionSpecs, type PortName, type ProvidedPorts, type RecordRef, type RenameKey, type RenamedBlock, type RenamedClient, type RenamedEvents, type RenamedOptions, type RenamedType, type RenamesOf, type RpcClient, type RunState, type UniquePort, type UsingOptions, type VisibleRange, type WithBlockHooksOptions, type WithExtraFields, blockFields, blockNames, blockOptions, createBlockClient, createBlocks, dbTransport, defineBlock, defineBlocks, defineEvents, defineTransportMiddleware, entityNames, entitySchema, event, extendBlock, fillTopic, generatedOptions, mergeEvents, onBlockEvent, option, optionsJsonSchema, rpcTransport, sqlTransport, subjectKey, withBlockHooks, wrapTransport };