better-supabase 0.8.0 → 0.10.0

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

@@ -0,0 +1,27 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as SolidController } from "../../../solid-controller-CZrt1Tg6.js";
+import { c as InboxListSnapshot, f as InboxWidgetControllerOptions, i as ConversationSnapshot, o as InboxControllerOptions, p as InboxWidgetSnapshot, r as ConversationControllerOptions, s as InboxListActions, t as ConversationActions, u as InboxWidgetActions } from "../../../client-CpMv4-v5.js";
+//#region src/blocks/inbox/solid/index.d.ts
+/**
+ * `createInboxController` 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 useInbox<T>(options: BlockOptions<InboxControllerOptions<T>>): SolidController<InboxListSnapshot<T>, InboxListActions>;
+/**
+ * `createConversationController` 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 useConversation<T>(options: BlockOptions<ConversationControllerOptions<T>>): SolidController<ConversationSnapshot<T>, ConversationActions>;
+/**
+ * `createInboxWidgetController` 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 useInboxWidget<T>(options: BlockOptions<InboxWidgetControllerOptions<T>>): SolidController<InboxWidgetSnapshot<T>, InboxWidgetActions>;
+//#endregion
+export type { BlockOptions, ConversationActions, ConversationControllerOptions, ConversationSnapshot, InboxControllerOptions, InboxListActions, InboxListSnapshot, InboxWidgetActions, InboxWidgetControllerOptions, InboxWidgetSnapshot, SolidController };

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

@@ -0,0 +1,32 @@
+import { t as useBlockController } from "../../../solid-controller-DLsmrczT.js";
+import { n as createInboxController, r as createInboxWidgetController, t as createConversationController } from "../../../client-WgrPIHH-.js";
+//#region src/blocks/inbox/solid/index.ts
+/**
+* `createInboxController` 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 useInbox(options) {
+	return useBlockController(createInboxController, options);
+}
+/**
+* `createConversationController` 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 useConversation(options) {
+	return useBlockController(createConversationController, options);
+}
+/**
+* `createInboxWidgetController` 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 useInboxWidget(options) {
+	return useBlockController(createInboxWidgetController, options);
+}
+//#endregion
+export { useConversation, useInbox, useInboxWidget };

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

@@ -0,0 +1,27 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as SvelteController } from "../../../svelte-controller-DDbju9CW.js";
+import { c as InboxListSnapshot, f as InboxWidgetControllerOptions, i as ConversationSnapshot, o as InboxControllerOptions, p as InboxWidgetSnapshot, r as ConversationControllerOptions, s as InboxListActions, t as ConversationActions, u as InboxWidgetActions } from "../../../client-CpMv4-v5.js";
+//#region src/blocks/inbox/svelte/index.d.ts
+/**
+ * `createInboxController` 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 useInbox<T>(options: BlockOptions<InboxControllerOptions<T>>): SvelteController<InboxListSnapshot<T>, InboxListActions>;
+/**
+ * `createConversationController` 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 useConversation<T>(options: BlockOptions<ConversationControllerOptions<T>>): SvelteController<ConversationSnapshot<T>, ConversationActions>;
+/**
+ * `createInboxWidgetController` 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 useInboxWidget<T>(options: BlockOptions<InboxWidgetControllerOptions<T>>): SvelteController<InboxWidgetSnapshot<T>, InboxWidgetActions>;
+//#endregion
+export type { BlockOptions, ConversationActions, ConversationControllerOptions, ConversationSnapshot, InboxControllerOptions, InboxListActions, InboxListSnapshot, InboxWidgetActions, InboxWidgetControllerOptions, InboxWidgetSnapshot, SvelteController };

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

@@ -0,0 +1,32 @@
+import { t as useBlockController } from "../../../svelte-controller-CDAujo-_.js";
+import { n as createInboxController, r as createInboxWidgetController, t as createConversationController } from "../../../client-WgrPIHH-.js";
+//#region src/blocks/inbox/svelte/index.ts
+/**
+* `createInboxController` 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 useInbox(options) {
+	return useBlockController(createInboxController, options);
+}
+/**
+* `createConversationController` 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 useConversation(options) {
+	return useBlockController(createConversationController, options);
+}
+/**
+* `createInboxWidgetController` 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 useInboxWidget(options) {
+	return useBlockController(createInboxWidgetController, options);
+}
+//#endregion
+export { useConversation, useInbox, useInboxWidget };

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

@@ -0,0 +1,27 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as VueController } from "../../../vue-controller-D_ohttBZ.js";
+import { c as InboxListSnapshot, f as InboxWidgetControllerOptions, i as ConversationSnapshot, o as InboxControllerOptions, p as InboxWidgetSnapshot, r as ConversationControllerOptions, s as InboxListActions, t as ConversationActions, u as InboxWidgetActions } from "../../../client-CpMv4-v5.js";
+//#region src/blocks/inbox/vue/index.d.ts
+/**
+ * `createInboxController` 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 useInbox<T>(options: BlockOptions<InboxControllerOptions<T>>): VueController<InboxListSnapshot<T>, InboxListActions>;
+/**
+ * `createConversationController` 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 useConversation<T>(options: BlockOptions<ConversationControllerOptions<T>>): VueController<ConversationSnapshot<T>, ConversationActions>;
+/**
+ * `createInboxWidgetController` 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 useInboxWidget<T>(options: BlockOptions<InboxWidgetControllerOptions<T>>): VueController<InboxWidgetSnapshot<T>, InboxWidgetActions>;
+//#endregion
+export type { BlockOptions, ConversationActions, ConversationControllerOptions, ConversationSnapshot, InboxControllerOptions, InboxListActions, InboxListSnapshot, InboxWidgetActions, InboxWidgetControllerOptions, InboxWidgetSnapshot, VueController };

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

@@ -0,0 +1,32 @@
+import { t as useBlockController } from "../../../vue-controller-C9tFzqAc.js";
+import { n as createInboxController, r as createInboxWidgetController, t as createConversationController } from "../../../client-WgrPIHH-.js";
+//#region src/blocks/inbox/vue/index.ts
+/**
+* `createInboxController` 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 useInbox(options) {
+	return useBlockController(createInboxController, options);
+}
+/**
+* `createConversationController` 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 useConversation(options) {
+	return useBlockController(createConversationController, options);
+}
+/**
+* `createInboxWidgetController` 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 useInboxWidget(options) {
+	return useBlockController(createInboxWidgetController, options);
+}
+//#endregion
+export { useConversation, useInbox, useInboxWidget };

package/dist/blocks/index.d.ts

@@ -1,65 +1,29 @@
-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-inD4fFq-.js";
-import { a as EventHub } from "../events-D1BOCll8.js";
-import { r as CredentialProvider } from "../provider-ib9wzUDz.js";
-import { i as CursorPageOptions, n as BlockOptions } from "../block-helpers-C0Xj8War.js";
-import { f as AiFiles } from "../types-Bb_4-vdW.js";
+import { Ct as EventSpec, Dt as event, Et as defineEvents, Ot as mergeEvents, St as EventMapOf, bt as onBlockEvent, w as BlockEmit, wt as Events, xt as EventMap } from "../events-CtAHxPal.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-NbUJygA7.js";
+import { i as CursorPageOptions, n as BlockOptions } from "../block-helpers-7pMBVsE6.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-C_WaodoA.js";
+import { a as WithExtraFields, n as ExtraFields, o as blockFields, r as FieldsOf, t as BlockFields } from "../block-fields-5UA84ZUg.js";
 import { n as FinalRunState, r as RunState, t as FINAL_RUN_STATES } from "../run-state-CPo-1X2B.js";
-import { i as EventSink } from "../cloud-event-Dune0KI7.js";
-import { r as AiTaskOutcome } from "../ai-tasks-BRQ6iQLc.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-DaOVC7SC.js";
-import { n as FieldsOf, r as blockFields, t as BlockFields } from "../block-fields-D1pfrcIY.js";
-//#region src/blocks/create-blocks.d.ts
-/** The CloudEvents `source` of block events that `createBlocks` forwards. */
-export declare const BLOCK_EVENT_SOURCE = "/better-supabase/blocks";
-interface CreateBlocksOptions extends BlockOptions {
-  /** Connectors, ai-providers and the builder store their secrets here. */
-  readonly credentials?: CredentialProvider;
-  /** `betterSupabase.events`, for the block events of the blocks that emit them. */
-  readonly events?: EventHub;
-  /**
-   * Where block events go, such as `auditLog.sink()`. Needs `events`; the
-   * forwarding lasts until `close()`, so build these blocks once rather than
-   * per request.
-   */
-  readonly audit?: EventSink;
-  /**
-   * The notification type ai-tasks sends for each finished run, through the
-   * `notifications` block. Its data is `{ taskId, runId, ok, error?, chatId? }`.
-   */
-  readonly aiTaskNotification?: string;
-}
-/** What each block factory receives: the shared options and its siblings. */
-interface BlockContext extends BlockOptions {
-  readonly credentials?: CredentialProvider;
-  readonly events?: EventHub;
-  /** The `aiFiles` block, for knowledge. */
-  readonly files?: AiFiles;
-  /** Sends `aiTaskNotification` through the `notifications` block, for ai-tasks. */
-  readonly notify?: (outcome: AiTaskOutcome) => unknown;
-}
-/** Builds one block, usually a block creator such as `createOrganizations`. */
-type BlockFactory<T = unknown> = (context: BlockContext) => T;
-type BlockFactories = Readonly<Record<string, BlockFactory>> & {
-  readonly aiFiles?: BlockFactory<AiFiles>;
-};
-type BuiltBlocks<F extends BlockFactories> = { readonly [K in keyof F]: F[K] extends BlockFactory<infer T> ? T : never; };
-/** `withBlockHooks` hooks for each block, keyed by the names in `factories`. */
-type BlocksHooks<F extends BlockFactories> = { readonly [K in keyof F]?: BlockHooks<BuiltBlocks<F>[K]>; };
-type Blocks<F extends BlockFactories> = BuiltBlocks<F> & {
-  /** Stops forwarding block events to `audit`. */
-  close(): void;
-};
+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-CbSOj53r.js";
+import { A as BlockNaming, C as CreateBlocksOptions, D as GeneratedBlocks, E as GeneratedBlock, O as fillTopic, S as BlocksHooks, T as defineBlocks, _ as BlockMap, a as BlockConsumes, b as Blocks, c as BlockOptionSchemas, d as ConsumedPorts, f as ProvidedPorts, g as BlockContext, h as BLOCK_EVENT_SOURCE, i as BlockCategory, j as blockNames, k as generatedOptions, l as BlockProvides, m as defineBlock, n as BLOCK_CATEGORIES, o as BlockDefinition, p as UsingOptions, r as Block, s as BlockOf, t as AnyBlock, u as ClientOf, v as BlockSet, w as createBlocks, x as BlocksEventMap, y as BlockSinks } from "../define-block-BlHQxDIQ.js";
+import { i as PortName, n as Notifier, r as NotifierInput, t as BlockPorts } from "../ports-B53rB7zg.js";
+//#region src/blocks/app-table-events.d.ts
 /**
- * Builds the blocks in `factories` with one set of options, and wires the
- * siblings they share: the `aiFiles` block into knowledge, `credentials`
- * into connectors, ai-providers and the builder, the `notifications` block
- * into ai-tasks (with `aiTaskNotification`), and block events into `audit`.
- * Only the blocks you pass are imported, so the rest stay out of the bundle.
- * `hooks` wraps each block's methods with `withBlockHooks`, so siblings that
- * call a block (ai-tasks sending notifications) go through its hooks too.
+ * The data of an app table event (ADR 0048): `<type>.created`, `.updated`
+ * and `.deleted`, written by the trigger `appTables.<table>.events` adds.
  */
-export declare function createBlocks<const F extends BlockFactories>(options: CreateBlocksOptions & {
-  readonly hooks?: NoInfer<BlocksHooks<F>>;
-}, factories: F): Blocks<F>;
+interface AppTableEventData {
+  /** The row id. */
+  readonly id: string | number;
+  /** The row's tenant, for tables kept per tenant. */
+  readonly organizationId?: string;
+  /** Set when the table registers a subject. */
+  readonly subjectType?: string;
+  readonly subjectId?: string;
+  /** The columns an update changed, `updated_at` left out. */
+  readonly changed?: readonly string[];
+  /** The values of the columns in `events.include`. */
+  readonly [column: string]: unknown;
+}
 //#endregion
-export { type BlockContext, type BlockFactories, type BlockFactory, type BlockFields, type BlockHookInfo, type BlockHooks, type BlockMethodHooks, type BlockMethodName, type BlockOptions, type BlockTransport, type BlockTransportMiddleware, type BlockTransportRequest, type Blocks, type BlocksHooks, type CreateBlocksOptions, type CursorPageOptions, type DbTransportOptions, type DbTransportSource, type ExtendBlockOptions, type ExtendBlockTools, FINAL_RUN_STATES, type FieldsOf, type FinalRunState, type RpcClient, type RunState, type WithBlockHooksOptions, blockFields, dbTransport, defineTransportMiddleware, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+export { type AnyBlock, type AppTableEventData, BLOCK_CATEGORIES, BLOCK_EVENT_SOURCE, type Block, type BlockCategory, type BlockConsumes, type BlockContext, type BlockDefinition, type BlockEmit, type BlockFields, type BlockHookInfo, type BlockHooks, type BlockMap, type BlockMethodHooks, type BlockMethodName, type BlockNaming, type BlockOf, type BlockOptionSchemas, type BlockOptions, type BlockOptionsSchema, type BlockPorts, type BlockProvides, type BlockSet, type BlockSinks, 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 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 OptionBuilders, type OptionInput, type OptionKind, type OptionSpec, type OptionSpecs, type PortName, type ProvidedPorts, type RpcClient, type RunState, type UsingOptions, type WithBlockHooksOptions, type WithExtraFields, blockFields, blockNames, blockOptions, createBlocks, dbTransport, defineBlock, defineBlocks, defineEvents, defineTransportMiddleware, event, extendBlock, fillTopic, generatedOptions, mergeEvents, onBlockEvent, option, optionsJsonSchema, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/index.js

@@ -1,77 +1,213 @@
 import { n as isRecord } from "../guards-6F2bCtQR.js";
-import { i as forwardBlockEvents } from "../cloud-event-CTh9Sr5w.js";
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../block-transport-bAKh-dGc.js";
-import { i as wrapTransport, n as extendBlock, r as withBlockHooks, t as defineTransportMiddleware } from "../block-hooks-BPNMIlLl.js";
+import { t as tenantNames } from "../tenant-naming-Bsj3Uvap.js";
+import { i as optionsJsonSchema, n as blockOptions, r as option, t as NO_OPTIONS } from "../options-BMjcVuaI.js";
 import { t as FINAL_RUN_STATES } from "../run-state-CgBKzYMW.js";
-import { t as blockFields } from "../block-fields-CroxUuF2.js";
+import { i as forwardBlockEvents } from "../cloud-event-CTh9Sr5w.js";
+import { n as event, r as mergeEvents, t as defineEvents } from "../event-map-Dy2vKHai.js";
+import { o as onBlockEvent } from "../block-events-DD9Q_NUz.js";
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../block-transport-G4t1umrR.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks, t as defineTransportMiddleware } from "../block-hooks-ByKlh8Qy.js";
+import { n as blockFields } from "../block-fields-BANwJ9Y_.js";
+import { n as defineBlock, t as BLOCK_CATEGORIES } from "../define-block-B6Gjs57G.js";
+//#region src/core/block-names.ts
+const TENANT_COLUMNS = ["organization_id", "active_organization_id"];
+/**
+* Transport middleware that calls each block function by the name the SQL
+* wrote it under: `create_organization` becomes `create_workspace` with
+* `tenant: "workspace"`, then `functions` renames single functions. Wrap
+* a block's transport with it when the config sets `sql.naming` or
+* `blocks.<name>.functions`; `defineBlocks` does it from `blocks.generated.ts`.
+*/
+function blockNames(naming) {
+	const names = tenantNames(naming.tenant);
+	const functions = naming.functions ?? {};
+	const rename = (fn) => {
+		const renamed = names.rename(fn);
+		return functions[fn] ?? functions[renamed] ?? renamed;
+	};
+	const columns = new Map(TENANT_COLUMNS.map((column) => [names.rename(column), column]));
+	const restore = (value) => {
+		if (Array.isArray(value)) return value.map(restore);
+		if (typeof value !== "object" || value === null) return value;
+		return Object.fromEntries(Object.entries(value).map(([key, each]) => [columns.get(key) ?? key, restore(each)]));
+	};
+	return defineTransportMiddleware({
+		name: "block-names",
+		call: async (request, next) => {
+			const result = await next({
+				...request,
+				fn: rename(request.fn)
+			});
+			return names.renamed ? restore(result) : result;
+		}
+	});
+}
+//#endregion
+//#region src/blocks/block-config.ts
+/**
+* The options a block's creator gets from its generated entry: the
+* schema it calls (the API schema when there is one, since the wrappers
+* there are what the caller may run) and the shared options. `defineBlocks`
+* passes them; spread them into a creator you call yourself:
+* `createAiChat({ ...generatedOptions(blockConfig["ai-chat"]), transport })`.
+*/
+function generatedOptions(entry) {
+	return {
+		...entry.options,
+		schema: entry.api ?? entry.schema
+	};
+}
+/**
+* A realtime topic template from `blocks.generated.ts` with its
+* placeholders filled in, such as the notifications topic
+* `notifications:{userId}`.
+*/
+function fillTopic(template, values) {
+	return template.replaceAll(/\{([A-Za-z]+)\}/g, (match, name) => {
+		const value = values[name];
+		if (value === void 0) throw new TypeError(`fillTopic: no value for ${match} in "${template}"`);
+		return value;
+	});
+}
+//#endregion
 //#region src/blocks/create-blocks.ts
 /** The CloudEvents `source` of block events that `createBlocks` forwards. */
 const BLOCK_EVENT_SOURCE = "/better-supabase/blocks";
-const isNotificationSender = (value) => isRecord(value) && typeof value["send"] === "function";
 /**
-* Builds the blocks in `factories` with one set of options, and wires the
-* siblings they share: the `aiFiles` block into knowledge, `credentials`
-* into connectors, ai-providers and the builder, the `notifications` block
-* into ai-tasks (with `aiTaskNotification`), and block events into `audit`.
-* Only the blocks you pass are imported, so the rest stay out of the bundle.
-* `hooks` wraps each block's methods with `withBlockHooks`, so siblings that
-* call a block (ai-tasks sending notifications) go through its hooks too.
+* The blocks an app uses, built with `blockConfig` from
+* `blocks.generated.ts` (`better-supabase gen`), so each block's schema
+* and the options its SQL half shares come from the `blocks` config, and
+* the app's own events (`defineEvents`). The event types are the union of
+* every block's events, so `on` and `events` type each one's data without
+* `declare module` (invariant 2).
+*/
+function defineBlocks(config, blocks, ...appEvents) {
+	const events = { types: [.../* @__PURE__ */ new Set([...Object.values(blocks).flatMap((block) => block.events.types), ...appEvents.flatMap((each) => each.types)])] };
+	return {
+		blocks,
+		config,
+		events,
+		create: (options) => buildBlocks({
+			...options,
+			config
+		}, blocks),
+		on: (betterSupabase, pattern, handler) => onBlockEvent(betterSupabase, events, pattern, handler)
+	};
+}
+/**
+* Builds `blocks` with one set of options and wires them on their ports.
+* Each block gets its schema and shared options from its entry in
+* `config` (`blocks.generated.ts`), keyed by the block's name. Each block
+* that consumes a port (`notifier`, `files`, `attachments`,
+* `workflows`) gets it from the one block in the set that provides it, and
+* `sinks` holds the outbox sinks the blocks provide. `credentials` reaches
+* every block, and block events go to `audit`. Only the blocks you pass are
+* imported, so the rest stay out of the bundle. `hooks` wraps each block's
+* methods with `withBlockHooks`, and the ports are built from the wrapped
+* clients, so a sibling's calls (ai-tasks sending notifications) go through
+* the hooks too.
 */
-function createBlocks(options, factories) {
-	const { credentials, events, audit, aiTaskNotification, hooks, ...shared } = options;
-	if (audit !== void 0 && events === void 0) throw new TypeError("createBlocks: `audit` needs `events` to forward");
+function createBlocks(options, blocks) {
+	return buildBlocks(options, blocks);
+}
+const UNIQUE_PORTS = [
+	"notifier",
+	"files",
+	"attachments",
+	"workflows"
+];
+/** `key`'s entry in `hooks`, which `BlocksHooks` keys like the blocks. */
+function hooksOf(hooks, key) {
+	if (hooks === void 0) return;
+	const entry = Object.entries(hooks).find(([name]) => name === key)?.[1];
+	return isRecord(entry) ? entry : void 0;
+}
+function buildBlocks(options, blocks) {
+	const { audit, hooks, config, ...shared } = options;
+	if (audit !== void 0 && shared.events === void 0) throw new TypeError("createBlocks: `audit` needs `events` to forward");
+	const providers = /* @__PURE__ */ new Map();
+	for (const port of UNIQUE_PORTS) {
+		const keys = Object.keys(blocks).filter((key) => blocks[key]?.provides[port] !== void 0);
+		if (keys.length > 1) throw new TypeError(`createBlocks: ${keys.map((key) => `"${key}"`).join(" and ")} both provide the ${port} port; pass one`);
+		const [key] = keys;
+		if (key !== void 0) providers.set(port, key);
+	}
+	for (const [key, block] of Object.entries(blocks)) for (const [port, need] of Object.entries(block.consumes)) if (need === "required" && !providers.has(port)) throw new TypeError(`createBlocks: "${key}" needs a block that provides the ${port} port`);
 	const built = /* @__PURE__ */ new Map();
 	const building = /* @__PURE__ */ new Set();
-	const notify = aiTaskNotification === void 0 || factories["notifications"] === void 0 ? void 0 : (outcome) => {
-		const notifications = build("notifications");
-		if (!isNotificationSender(notifications)) throw new TypeError("The notifications block has no send method");
-		return notifications.send(aiTaskNotification, {
-			recipients: [outcome.task.userId],
-			tenant: outcome.task.organizationId,
-			key: `ai-task-run:${outcome.run.id}`,
-			data: {
-				taskId: outcome.task.id,
-				runId: outcome.run.id,
-				ok: outcome.ok,
-				...outcome.error === void 0 ? {} : { error: outcome.error },
-				...outcome.chatId === void 0 ? {} : { chatId: outcome.chatId }
-			}
-		});
+	const blockOf = (key) => {
+		const block = blocks[key];
+		if (block === void 0) throw new TypeError(`No block named "${key}"`);
+		return block;
 	};
-	function contextFor(name) {
-		const files = name === "aiFiles" || factories.aiFiles === void 0 ? void 0 : build("aiFiles");
+	/**
+	* The options `key`'s creator gets: shared, then its generated config,
+	* then ports, then `with` settings.
+	*/
+	const optionsOf = (key) => {
+		const ports = {};
+		for (const port of UNIQUE_PORTS) {
+			if (blockOf(key).consumes[port] === void 0) continue;
+			const provider = providers.get(port);
+			if (provider === void 0 || provider === key) continue;
+			const value = portOf(provider, port);
+			if (value !== void 0) ports[port] = value;
+		}
+		const block = blockOf(key);
+		const entry = config?.[block.name];
 		return {
 			...shared,
-			...credentials === void 0 ? {} : { credentials },
-			...events === void 0 ? {} : { events },
-			...files === void 0 ? {} : { files },
-			...notify === void 0 ? {} : { notify }
+			...entry === void 0 ? {} : generatedOptions(entry),
+			...entry?.naming === void 0 ? {} : renamedTransports(entry.naming),
+			...ports,
+			...block.settings
 		};
+	};
+	/** `shared`'s transports, calling the block functions by the names the SQL gave them. */
+	function renamedTransports(naming) {
+		const middleware = blockNames(naming);
+		return {
+			transport: wrapTransport(shared.transport, middleware),
+			...shared.service === void 0 ? {} : { service: wrapTransport(shared.service, middleware) }
+		};
+	}
+	function portOf(key, port) {
+		const provide = blockOf(key).provides[port];
+		if (provide === void 0) return;
+		return provide(build(key), optionsOf(key));
 	}
-	function build(name) {
-		if (built.has(name)) return built.get(name);
-		const factory = factories[name];
-		if (factory === void 0) throw new TypeError(`No block named "${name}"`);
-		if (building.has(name)) throw new TypeError(`The "${name}" block depends on itself`);
-		building.add(name);
+	function build(key) {
+		if (built.has(key)) return built.get(key);
+		const block = blockOf(key);
+		if (block.create === void 0) throw new TypeError(`The "${block.name}" block has only SQL; it has no client to build`);
+		if (building.has(key)) throw new TypeError(`The "${key}" block depends on itself`);
+		building.add(key);
 		try {
-			const created = factory(contextFor(name));
-			const blockHooks = hooks?.[name];
-			const block = blockHooks !== void 0 && isRecord(created) ? withBlockHooks(created, blockHooks, {
-				block: name,
-				...events === void 0 ? {} : { logger: events.logger }
+			const create = block.create;
+			const created = create(optionsOf(key));
+			const blockHooks = hooksOf(hooks, key);
+			const client = blockHooks !== void 0 && isRecord(created) ? withBlockHooks(created, blockHooks, {
+				block: key,
+				...shared.events === void 0 ? {} : { logger: shared.events.logger }
 			}) : created;
-			built.set(name, block);
-			return block;
+			built.set(key, client);
+			return client;
 		} finally {
-			building.delete(name);
+			building.delete(key);
 		}
 	}
-	const blocks = {};
-	for (const name of Object.keys(factories)) blocks[name] = build(name);
-	const stop = audit === void 0 || events === void 0 ? void 0 : forwardBlockEvents({ events }, audit, { source: BLOCK_EVENT_SOURCE });
-	blocks["close"] = () => stop?.();
-	return blocks;
+	const result = {};
+	const sinks = {};
+	for (const [key, block] of Object.entries(blocks)) {
+		if (block.create === void 0) continue;
+		result[key] = build(key);
+		const sink = portOf(key, "sink");
+		if (sink !== void 0) sinks[key] = sink;
+	}
+	result["sinks"] = sinks;
+	const stop = audit === void 0 || shared.events === void 0 ? void 0 : forwardBlockEvents({ events: shared.events }, audit, { source: BLOCK_EVENT_SOURCE });
+	result["close"] = () => stop?.();
+	return result;
 }
 //#endregion
-export { BLOCK_EVENT_SOURCE, FINAL_RUN_STATES, blockFields, createBlocks, dbTransport, defineTransportMiddleware, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+export { BLOCK_CATEGORIES, BLOCK_EVENT_SOURCE, FINAL_RUN_STATES, NO_OPTIONS, blockFields, blockNames, blockOptions, createBlocks, dbTransport, defineBlock, defineBlocks, defineEvents, defineTransportMiddleware, event, extendBlock, fillTopic, generatedOptions, mergeEvents, onBlockEvent, option, optionsJsonSchema, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };