better-supabase 0.14.0 → 0.15.0

package/dist/blocks/guests/index.js

@@ -1,11 +1,11 @@
 import { t as GUEST_ACTIONS } from "../../guest-actions-B7zdhfnh.js";
-import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, F as stringsOf, 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 { r as sectionRowInput, t as defineSection } from "../../sections-DjxYmpu-.js";
+import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, F as stringsOf, 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 { i as recordRowInput, t as defineRecordBinding } from "../../record-bindings-DkBJpC5A.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
-import { n as defineBlock } from "../../define-block-Dze77QTw.js";
-import { t as requireTenant } from "../../block-tenant-C1sNV8_4.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+import { t as requireOrganization } from "../../block-tenant-DHp7subc.js";
 //#region src/blocks/guests/guests.ts
 const STATUSES = [
 	"invited",
@@ -62,7 +62,7 @@ function grantOf(value, fn) {
 function createGuests(options) {
 	applyTemporal(options);
 	const call = blockCall(options.transport, options.schema, options.mappers);
-	const tenant = () => requireTenant(options.tenant);
+	const tenant = () => requireOrganization(options.tenant);
 	return withBlockHooks({
 		invite: (input) => tenant().andThen((organizationId) => call("invite_guest", {
 			tenant: organizationId,
@@ -183,9 +183,9 @@ const guestSectionGrantSchema = entitySchema({
 	}
 });
 //#endregion
-//#region src/blocks/guests/section.ts
+//#region src/blocks/guests/record-binding.ts
 /** The guests who reach a record: a sharing panel. */
-const guestsSection = defineSection({
+const guestsBinding = defineRecordBinding({
 	permissions: {
 		read: "read",
 		write: "manage"
@@ -199,7 +199,7 @@ const guestsSection = defineSection({
 			run: (client, subject, { guestId, ...input }) => client.grant(guestId, subject, input)
 		},
 		revoke: {
-			input: sectionRowInput,
+			input: recordRowInput,
 			run: (client, _subject, { id }) => client.revokeGrant(id)
 		}
 	}
@@ -217,8 +217,8 @@ const guestsBlock = defineBlock({
 		guest_grant: { input: guestGrantSchema }
 	},
 	create: createGuests,
-	sections: { guests: guestsSection },
+	record: guestsBinding,
 	category: "collaboration"
 });
 //#endregion
-export { createGuests, dbTransport, extendBlock, guestGrantSchema, guestInviteSchema, guestSectionGrantSchema, guestsBlock, guestsEvents, guestsSection, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+export { createGuests, dbTransport, extendBlock, guestGrantSchema, guestInviteSchema, guestSectionGrantSchema, guestsBinding, guestsBlock, guestsEvents, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

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

@@ -1,14 +1,14 @@
 /// <reference lib="esnext.temporal" />
-import { T as ErrorMapper, t as AsyncResult } from "../../result-C6jDfedy.js";
-import { t as StandardSchemaV1 } from "../../standard-DbQsD2xZ.js";
-import { r as FieldsOf } from "../../block-fields-3w4MZr8U.js";
-import { Ct as Events } from "../../events-DbLjvxDX.js";
-import { m as JobEventData, t as ApplicationEventData } from "../../block-events-records-BGVyoz57.js";
+import { T as ErrorMapper, t as AsyncResult } from "../../result-DZeA5KS6.js";
+import { t as StandardSchemaV1 } from "../../standard-DBV730sF.js";
+import { r as FieldsOf } from "../../block-fields-BE7pInWZ.js";
+import { Ct as Events } from "../../events-vcqenSYU.js";
+import { T as JobEventData, f as ApplicationEventData } from "../../index-CG9rA8H8.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 } 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 { Zt as DefaultAutomation, c as BlockOf } from "../../define-block-BVcLQ3DF.js";
 //#region src/blocks/hiring/hiring.d.ts
 type JobStatus = "draft" | "open" | "closed";
 type ApplicationState = "active" | "hired" | "rejected" | "withdrawn";
@@ -40,7 +40,7 @@ interface JobInput<F extends object = Record<never, never>> {
   /** Values for the extra columns, by column name. */
   readonly fields?: Partial<F> & Readonly<Record<string, unknown>>;
 }
-/** A candidate's record in `config.subjects`, a person by default. */
+/** A candidate's record in `config.records`, a person by default. */
 interface Candidate {
   readonly type: string;
   readonly id: string;
@@ -151,4 +151,14 @@ export declare const hiringEvents: Events<HiringEvents>;
 /** The `hiring` block's manifest (ADR 0029). */
 export declare const hiringBlock: BlockOf<"hiring", typeof createHiring, HiringEvents>;
 //#endregion
+//#region src/blocks/hiring/automations.d.ts
+/**
+ * Starts an employee in preboarding for each hired application, through the
+ * employees block's `employees.from_application` action. Ships when employees
+ * is installed.
+ */
+export declare const APPLICATION_TO_EMPLOYEE: DefaultAutomation;
+/** The automations the hiring block ships. */
+export declare const HIRING_AUTOMATIONS: readonly DefaultAutomation[];
+//#endregion
 export { type Application, type ApplicationDetail, type ApplicationState, type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type Candidate, type Hiring, type HiringEvents, type HiringOptions, type Interview, type Job, type JobInput, type JobStatus, type Recommendation, type RpcClient, type Scorecard, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/hiring/index.js

@@ -1,12 +1,12 @@
-import { t as AsyncResult } from "../../result-B3m7xtRY.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
-import { t as hiringSqlOptions } from "../../options-D2Gd6VfS.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 { t as AsyncResult } from "../../result-ntFBW2p2.js";
+import { n as HIRING_AUTOMATIONS, r as hiringSqlOptions, t as APPLICATION_TO_EMPLOYEE } from "../../automations-Bc2ue55V.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 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 { i as refOf, n as compact } from "../../sales-shared-C_u68eq2.js";
+import { n as blockFields } from "../../block-fields-DE_FgpOU.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+import { i as refOf, n as compact } from "../../sales-shared-DXGFJP4g.js";
 //#region src/blocks/hiring/hiring.ts
 const JOB_STATUSES = [
 	"draft",
@@ -173,7 +173,8 @@ const hiringBlock = defineBlock({
 	events: hiringEvents,
 	create: createHiring,
 	category: "people",
-	recipes: ["hiring-board"]
+	recipes: ["hiring-board"],
+	automations: HIRING_AUTOMATIONS
 });
 //#endregion
-export { createHiring, dbTransport, extendBlock, hiringBlock, hiringEvents, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+export { APPLICATION_TO_EMPLOYEE, HIRING_AUTOMATIONS, createHiring, dbTransport, extendBlock, hiringBlock, hiringEvents, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

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

@@ -1,11 +1,11 @@
 /// <reference lib="esnext.temporal" />
-import { T as ErrorMapper, t as AsyncResult } from "../../result-C6jDfedy.js";
+import { T as ErrorMapper, t as AsyncResult } from "../../result-DZeA5KS6.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { r as BlockTemporalOptions } from "../../block-helpers-BaugZlJV.js";
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
-import { n as BlockHooks } from "../../block-hooks-CmjPKqQ_.js";
-import { c as BlockOf } from "../../define-block-COpcS6aT.js";
-import { d as IdentityRef, f as IdentityTarget, p as PrincipalByIdentity } from "../../authorization-hooks-dLmUO_PZ.js";
+import { r as BlockTemporalOptions } from "../../block-helpers-CRpAHrp_.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { n as BlockHooks } from "../../block-hooks-DZN2w69m.js";
+import { c as BlockOf } from "../../define-block-BVcLQ3DF.js";
+import { d as IdentityRef, f as IdentityTarget, p as PrincipalByIdentity } from "../../authorization-hooks-Cs1vP_ej.js";
 //#region src/blocks/identities/identities.d.ts
 interface IdentitiesOptions extends BlockTemporalOptions {
   /**
@@ -76,7 +76,7 @@ interface Identities {
 }
 export declare function createIdentities(options: IdentitiesOptions): Identities;
 /**
- * A `PrincipalByIdentity` over the `identities` table, for `createServer(bs, {
+ * A `PrincipalByIdentity` over the `identities` table, for `createServer(bsb, {
  * authorization: { identities: { principalByIdentity } } })` or a chat helper's
  * `principalByIdentity` option. `transport` runs as the service role. A
  * database error rejects, so the caller retries instead of treating a linked

package/dist/blocks/identities/index.js

@@ -1,8 +1,8 @@
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
 import { t as identitiesSqlOptions } from "../../options-CXFz0xxS.js";
-import { A as requiredInstant, B as dbTransport, D as recordOf, H as rpcTransport, I as textOf, U as sqlTransport, d as enumOrThrow, k as recordsOf, n as applyTemporal, o as blockCall, y as nullableText } from "../../block-helpers-CiKtrb6g.js";
-import { r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
-import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { A as requiredInstant, B as dbTransport, D as recordOf, H as rpcTransport, I as textOf, U as sqlTransport, d as enumOrThrow, k as recordsOf, n as applyTemporal, o as blockCall, y as nullableText } from "../../block-helpers-CtBdjgO4.js";
+import { r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
 //#region src/blocks/identities/identities.ts
 const KINDS = ["email", "chat"];
 const SOURCES = ["link", "verified_email"];
@@ -67,7 +67,7 @@ function createIdentities(options) {
 	});
 }
 /**
-* A `PrincipalByIdentity` over the `identities` table, for `createServer(bs, {
+* A `PrincipalByIdentity` over the `identities` table, for `createServer(bsb, {
 * authorization: { identities: { principalByIdentity } } })` or a chat helper's
 * `principalByIdentity` option. `transport` runs as the service role. A
 * database error rejects, so the caller retries instead of treating a linked

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

@@ -1,10 +1,10 @@
-import { T as ErrorMapper, t as AsyncResult } from "../../result-C6jDfedy.js";
-import { ht as TableMeta } from "../../executor-CPyrQdjh.js";
-import { $ as SaasEventData, Ct as Events } from "../../events-DbLjvxDX.js";
+import { T as ErrorMapper, t as AsyncResult } from "../../result-DZeA5KS6.js";
+import { dt as TableMeta } from "../../types-DFdg_4yN.js";
+import { $ as SaasEventData, Ct as Events } from "../../events-vcqenSYU.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { t as BlockTransport } from "../../block-transport-d53POsem.js";
-import { n as BlockHooks } from "../../block-hooks-CmjPKqQ_.js";
-import { c as BlockOf } from "../../define-block-COpcS6aT.js";
+import { t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { n as BlockHooks } from "../../block-hooks-DZN2w69m.js";
+import { c as BlockOf } from "../../define-block-BVcLQ3DF.js";
 import { r as parseCsv } from "../../csv-DhHQS2x_.js";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/blocks/imports/define-import.d.ts
@@ -71,12 +71,12 @@ type Values = Readonly<Record<string, unknown>>;
  */
 interface AppTableImportRepository<T extends object, K extends Extract<keyof T, string>> {
   readonly $meta: TableMeta;
-  findMany(args: {
+  list(args: {
     readonly where: {
       readonly OR: readonly Pick<T, K>[];
     };
   }): AsyncResult<readonly Values[]>;
-  upsertMany(rows: readonly T[], args: {
+  upsert(rows: readonly T[], args: {
     readonly onConflict: readonly K[];
     readonly returning: false;
   }): AsyncResult<unknown>;

package/dist/blocks/imports/index.js

@@ -1,9 +1,9 @@
-import { n as validate } from "../../standard-DtkpFGkS.js";
-import { D as recordOf, I as textOf, o as blockCall } from "../../block-helpers-CiKtrb6g.js";
-import { r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
+import { n as validate } from "../../standard-BA3mLh6w.js";
+import { D as recordOf, I as textOf, o as blockCall } from "../../block-helpers-CtBdjgO4.js";
+import { r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
 import { n as parseCsv } from "../../csv-2rXGPNtP.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
-import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
 //#region src/blocks/imports/define-import.ts
 /** Registers an import. `runImport` calls `insert` in batches. */
 function defineImport(definition) {
@@ -127,7 +127,7 @@ function appTableImport(options) {
 	const keyOf = (row) => JSON.stringify(key.map((column) => valueOf(row, column) ?? null));
 	const existing = async (rows) => {
 		if (rows.length === 0) return /* @__PURE__ */ new Map();
-		const found = await repository.findMany({ where: { OR: rows.map((row) => pick(row, key)) } }).orThrow();
+		const found = await repository.list({ where: { OR: rows.map((row) => pick(row, key)) } }).orThrow();
 		return new Map(found.map((row) => [keyOf(row), row]));
 	};
 	const merged = (row, current) => current === void 0 || update === "overwrite" ? row : {
@@ -140,7 +140,7 @@ function appTableImport(options) {
 		key: keyOf,
 		insert: async (batch) => {
 			const found = await existing(batch);
-			await repository.upsertMany(batch.map((row) => merged(row, found.get(keyOf(row)))), {
+			await repository.upsert(batch.map((row) => merged(row, found.get(keyOf(row)))), {
 				onConflict: key,
 				returning: false
 			}).orThrow();

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

@@ -1,13 +1,133 @@
-import { Ct as Events, H as InboxEventData } from "../../events-DbLjvxDX.js";
-import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
-import { d as MessageKind, p as MessageReaction, u as MessageFile } from "../../messaging-CZ6aWb10.js";
-import { c as BlockOf } from "../../define-block-COpcS6aT.js";
-import { S as StoredInboundEvent, _ as MessageDirection, a as ConversationEvent, b as PurgedContact, c as DeliveryStatus, d as InboxCounts, f as InboxFileSource, g as MessageDelivery, h as InboxUpload, i as Conversation, l as InboundResult, m as InboxRow, n as BotMode, o as ConversationPriority, p as InboxMessage, r as Contact, s as ConversationStatus, t as AuthorType, u as InboxChannel, v as MessageTemplate, x as ScheduledInboxMessage, y as PendingInboxFile } from "../../types-DkPE7yd2.js";
-import { a as Inbox, c as InboxPatch, d as StartConversationInput, f as TemplateInput, i as InboundInput, l as MessageInput, n as ConversationFilter, o as InboxHooks, p as createInbox, r as CreateInboxInput, s as InboxOptions, t as ContactInput, u as ScheduledMessageInput } from "../../inbox-BPBb6etH.js";
-import { _ as createInboxWidgetController, a as Identified, c as InboxListActions, d as InboxWidgetActions, f as InboxWidgetController, g as createInboxController, h as createConversationController, i as ConversationSnapshot, l as InboxListSnapshot, m as InboxWidgetSnapshot, n as ConversationController, o as InboxController, p as InboxWidgetControllerOptions, r as ConversationControllerOptions, s as InboxControllerOptions, t as ConversationActions, u as InboxSource } from "../../client-7_4Y21ue.js";
+import { Ct as Events, H as InboxEventData } from "../../events-vcqenSYU.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { d as MessageKind, p as MessageReaction, u as MessageFile } from "../../messaging-C_Pr9tGx.js";
+import { Zt as DefaultAutomation, c as BlockOf } from "../../define-block-BVcLQ3DF.js";
+import { p as SubscriptionStatus } from "../../topic-CJrQZQaa.js";
+import { n as TopicPort } from "../../watch-topic-BcGfvZOE.js";
+import { l as StoragePort } from "../../ports-sx226JUL.js";
+import { n as Controller, t as AuthPort } from "../../controller-BrP0gn47.js";
+import { S as StoredInboundEvent, _ as MessageDirection, a as ConversationEvent, b as PurgedContact, c as DeliveryStatus, d as InboxCounts, f as InboxFileSource, g as MessageDelivery, h as InboxUpload, i as Conversation, l as InboundResult, m as InboxRow, n as BotMode, o as ConversationPriority, p as InboxMessage, r as Contact, s as ConversationStatus, t as AuthorType, u as InboxChannel, v as MessageTemplate, x as ScheduledInboxMessage, y as PendingInboxFile } from "../../types-Dp3UCr1e.js";
+import { a as Inbox, c as InboxPatch, d as StartConversationInput, f as TemplateInput, i as InboundInput, l as MessageInput, n as ConversationFilter, o as InboxHooks, p as createInbox, r as CreateInboxInput, s as InboxOptions, t as ContactInput, u as ScheduledMessageInput } from "../../inbox-NDKwSk_H.js";
 //#region src/blocks/inbox/rows.d.ts
 export declare const INBOX_CHANNELS: readonly InboxChannel[];
 //#endregion
+//#region src/blocks/inbox/client.d.ts
+/** Loads one list, e.g. a server action that calls `inbox.conversations.list()`. */
+type InboxSource<T> = () => Promise<readonly T[]>;
+interface InboxListSnapshot<T> {
+  /** `undefined` until the first load. */
+  readonly items: readonly T[] | undefined;
+  readonly status: SubscriptionStatus;
+  readonly error: unknown;
+}
+interface InboxListActions {
+  readonly refresh: () => Promise<void>;
+}
+interface Ports {
+  readonly topic: TopicPort;
+}
+interface InboxControllerOptions<T> {
+  readonly auth: AuthPort;
+  readonly ports: Ports;
+  /** The organization; the controller joins `inbox:org:<id>`. `null` waits. */
+  readonly organizationId: string | null;
+  readonly load: InboxSource<T>;
+  /**
+   * `blockConfig.inbox.options.topic` from `blocks.generated.ts`. Defaults to
+   * `inbox`.
+   */
+  readonly topic?: string;
+  /** Runs for each broadcast, e.g. to show a toast for `message`. */
+  readonly onMessage?: (event: string, payload: unknown) => void;
+}
+type InboxController<T> = Controller<InboxListSnapshot<T>, InboxListActions>;
+/**
+ * The staff view of an organization's conversations, kept current: loads, then
+ * loads again after each ping on `inbox:org:<id>` and on rejoin.
+ */
+export declare function createInboxController<T>(options: InboxControllerOptions<T>): InboxController<T>;
+interface ConversationSnapshot<T> extends InboxListSnapshot<T> {
+  /** User ids typing now, the caller left out. */
+  readonly typing: readonly string[];
+}
+interface ConversationActions extends InboxListActions {
+  /** Tells the others the caller is typing; call it on input, throttled. */
+  readonly setTyping: (typing: boolean) => void;
+}
+interface ConversationControllerOptions<T extends Identified> {
+  readonly auth: AuthPort;
+  readonly ports: Ports;
+  /** `null` waits, e.g. before the widget opens a conversation. */
+  readonly conversationId: string | null;
+  /** The messages, oldest first: on start and after a rejoin. */
+  readonly load: InboxSource<T>;
+  /**
+   * One message after a ping, e.g. a server action that calls
+   * `inbox.messages.get(id)`; `null` when the caller cannot read it.
+   */
+  readonly get: (messageId: string) => Promise<T | null>;
+  /**
+   * `blockConfig.messaging.options.topic` from `blocks.generated.ts`. Defaults
+   * to `messages`.
+   */
+  readonly topic?: string;
+  /** Runs for the other pings, such as `conversation` and `read`. */
+  readonly onEvent?: (event: string, payload: unknown) => void;
+  /** How long a typing ping counts. Defaults to 5000 ms. */
+  readonly typingMs?: number;
+}
+/** What the conversation controller needs of a message. */
+interface Identified {
+  readonly id: string;
+}
+type ConversationController<T extends Identified> = Controller<ConversationSnapshot<T>, ConversationActions>;
+/**
+ * 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`.
+ */
+export declare function createConversationController<T extends Identified>(options: ConversationControllerOptions<T>): ConversationController<T>;
+interface InboxWidgetControllerOptions<T extends Identified> {
+  readonly auth: AuthPort;
+  readonly ports: Ports & {
+    readonly storage?: StoragePort;
+  };
+  /**
+   * Opens the visitor's conversation, e.g. a server action that calls
+   * `inbox.conversations.open(inboxId, { message })` with the visitor's
+   * transport. Returns its id.
+   */
+  readonly open: (message: string) => Promise<string>;
+  /** Sends into the open conversation. */
+  readonly send: (conversationId: string, message: string) => Promise<void>;
+  readonly load: (conversationId: string) => Promise<readonly T[]>;
+  /** One message after a ping; `null` when the visitor cannot read it. */
+  readonly get: (messageId: string) => Promise<T | null>;
+  /**
+   * Remembers the conversation across reloads in the storage port. Defaults to
+   * `better-supabase:inbox-widget`; `null` forgets it.
+   */
+  readonly storageKey?: string | null;
+  readonly topic?: string;
+}
+interface InboxWidgetSnapshot<T> extends ConversationSnapshot<T> {
+  readonly conversationId: string | null;
+}
+interface InboxWidgetActions extends ConversationActions {
+  /** Opens the conversation with the first message, or sends into it. */
+  readonly submit: (message: string) => Promise<void>;
+  /** Forgets the conversation, so the next message opens a new one. */
+  readonly reset: () => void;
+}
+type InboxWidgetController<T extends Identified> = Controller<InboxWidgetSnapshot<T>, InboxWidgetActions>;
+/**
+ * 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.
+ */
+export declare function createInboxWidgetController<T extends Identified>(options: InboxWidgetControllerOptions<T>): InboxWidgetController<T>;
+//#endregion
 //#region src/blocks/inbox/events.d.ts
 /** The events of the `inbox` block: type to data. */
 type InboxEvents = {
@@ -25,4 +145,13 @@ export declare const inboxEvents: Events<InboxEvents>;
 /** The `inbox` block's manifest (ADR 0029). */
 export declare const inboxBlock: BlockOf<"inbox", typeof createInbox, InboxEvents>;
 //#endregion
-export { type AuthorType, type BlockTransport, type BotMode, type Contact, type ContactInput, type Conversation, type ConversationActions, type ConversationController, type ConversationControllerOptions, type ConversationEvent, type ConversationFilter, type ConversationPriority, type ConversationSnapshot, type ConversationStatus, type CreateInboxInput, type DeliveryStatus, type Identified, type InboundInput, type InboundResult, type Inbox, type InboxChannel, type InboxController, type InboxControllerOptions, type InboxCounts, type InboxEvents, type InboxFileSource, type InboxHooks, type InboxListActions, type InboxListSnapshot, type InboxMessage, type InboxOptions, type InboxPatch, type InboxRow, type InboxSource, type InboxUpload, type InboxWidgetActions, type InboxWidgetController, type InboxWidgetControllerOptions, type InboxWidgetSnapshot, type MessageDelivery, type MessageDirection, type MessageFile, type MessageInput, type MessageKind, type MessageReaction, type MessageTemplate, type PendingInboxFile, type PurgedContact, type RpcClient, type ScheduledInboxMessage, type ScheduledMessageInput, type StartConversationInput, type StoredInboundEvent, type TemplateInput, createConversationController, createInbox, createInboxController, createInboxWidgetController, dbTransport, rpcTransport, sqlTransport };
+//#region src/blocks/inbox/automations.d.ts
+/**
+ * Opens a task for each conversation the inbox opens, through the tasks block's
+ * `tasks.from_conversation` action. Ships when tasks is installed.
+ */
+export declare const CONVERSATION_TO_TASK: DefaultAutomation;
+/** The automations the inbox block ships. */
+export declare const INBOX_AUTOMATIONS: readonly DefaultAutomation[];
+//#endregion
+export { type AuthorType, type BlockTransport, type BotMode, type Contact, type ContactInput, type Conversation, type ConversationActions, type ConversationController, type ConversationControllerOptions, type ConversationEvent, type ConversationFilter, type ConversationPriority, type ConversationSnapshot, type ConversationStatus, type CreateInboxInput, type DeliveryStatus, type Identified, type InboundInput, type InboundResult, type Inbox, type InboxChannel, type InboxController, type InboxControllerOptions, type InboxCounts, type InboxEvents, type InboxFileSource, type InboxHooks, type InboxListActions, type InboxListSnapshot, type InboxMessage, type InboxOptions, type InboxPatch, type InboxRow, type InboxSource, type InboxUpload, type InboxWidgetActions, type InboxWidgetController, type InboxWidgetControllerOptions, type InboxWidgetSnapshot, type MessageDelivery, type MessageDirection, type MessageFile, type MessageInput, type MessageKind, type MessageReaction, type MessageTemplate, type PendingInboxFile, type PurgedContact, type RpcClient, type ScheduledInboxMessage, type ScheduledMessageInput, type StartConversationInput, type StoredInboundEvent, type TemplateInput, createInbox, dbTransport, rpcTransport, sqlTransport };