better-supabase 0.13.0 → 0.14.0

package/dist/blocks/channels/index.js

@@ -0,0 +1,190 @@
+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, 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 { 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";
+//#region src/blocks/channels/channels.ts
+const VISIBILITY$1 = ["public", "private"];
+const ROLES = ["owner", "member"];
+function channelOf(value) {
+	const row = recordOf(value, "channel");
+	const subjectType = optionalText(row["subject_type"]);
+	const subjectId = optionalText(row["subject_id"]);
+	const role = optionalText(row["role"]);
+	const count = Number(row["memberCount"] ?? 0);
+	return {
+		id: textOf(row["id"]),
+		organizationId: textOf(row["tenant_id"]),
+		name: textOf(row["name"]),
+		visibility: enumOrThrow(row["visibility"], VISIBILITY$1, "visibility"),
+		topic: optionalText(row["topic"]),
+		purpose: optionalText(row["purpose"]),
+		subject: subjectType === void 0 || subjectId === void 0 ? void 0 : {
+			type: subjectType,
+			id: subjectId
+		},
+		createdBy: optionalText(row["created_by"]),
+		role: role === void 0 ? void 0 : enumOrThrow(role, ROLES, "role"),
+		memberCount: Number.isFinite(count) ? count : 0,
+		lastMessageAt: optionalInstant(row["lastMessageAt"]),
+		archivedAt: optionalInstant(row["archivedAt"]),
+		createdAt: requiredInstant(row["created_at"], "createdAt"),
+		updatedAt: requiredInstant(row["updated_at"], "updatedAt")
+	};
+}
+const maybeChannel = (value) => value === null || value === void 0 ? void 0 : channelOf(value);
+/**
+* The channels block: named conversations on the messaging core, public or
+* private, with a topic, a purpose and an optional linked record. Send and read
+* their messages with the `messaging` block, by the channel's id.
+*/
+function createChannels(options) {
+	applyTemporal(options);
+	const call = blockCall(options.transport, options.schema, options.mappers);
+	const tenant = () => requireTenant(options.tenant);
+	const many = (fn, args) => call(fn, args, (value) => recordsOf(value, fn).map(channelOf));
+	return withBlockHooks({
+		create: (channel) => tenant().andThen((organizationId) => call("create_channel", {
+			tenant: organizationId,
+			name: channel.name,
+			attrs: {
+				...channel.visibility === void 0 ? {} : { visibility: channel.visibility },
+				...channel.topic === void 0 ? {} : { topic: channel.topic },
+				...channel.purpose === void 0 ? {} : { purpose: channel.purpose },
+				...channel.subject === void 0 ? {} : {
+					subjectType: channel.subject.type,
+					subjectId: channel.subject.id
+				}
+			},
+			members: [...channel.memberIds ?? []]
+		}, channelOf)),
+		update: (channelId, change) => call("update_channel", {
+			channel: channelId,
+			attrs: change
+		}, channelOf),
+		archive: (channelId, archived = true) => call("archive_channel", {
+			channel: channelId,
+			archived
+		}, (value) => value === true),
+		join: (channelId) => call("join_channel", { channel: channelId }, (value) => value === true),
+		leave: (channelId) => call("leave_channel", { channel: channelId }, (value) => value === true),
+		invite: (channelId, userIds) => call("invite_to_channel", {
+			channel: channelId,
+			users: [...userIds]
+		}, Number),
+		list: (list = {}) => tenant().andThen((organizationId) => many("list_channels", {
+			tenant: organizationId,
+			browse: list.browse ?? false,
+			include_archived: list.includeArchived ?? false
+		})),
+		get: (channelId) => call("get_channel", { channel: channelId }, maybeChannel),
+		find: (name) => tenant().andThen((organizationId) => call("find_channel", {
+			tenant: organizationId,
+			name
+		}, maybeChannel)),
+		forSubject: (subject) => many("channels_for_record", {
+			subject_type: subject.type,
+			subject_id: subject.id
+		})
+	}, options.hooks, {
+		block: "channels",
+		...options.logger ? { logger: options.logger } : {}
+	});
+}
+//#endregion
+//#region src/blocks/channels/events.ts
+/** The `channels` block's event types, for its manifest and `onBlockEvent`. */
+const channelsEvents = defineEvents({
+	"channel.created": event(),
+	"channel.updated": event()
+});
+//#endregion
+//#region src/blocks/channels/schemas.ts
+const VISIBILITY = ["public", "private"];
+/** What `create` takes. The SQL checks the name's shape. */
+const channelInputSchema = entitySchema({
+	title: "NewChannel",
+	fields: {
+		name: {
+			kind: "string",
+			minLength: 1,
+			maxLength: 80
+		},
+		visibility: {
+			kind: "enum",
+			values: VISIBILITY,
+			optional: true
+		},
+		topic: {
+			kind: "string",
+			maxLength: 250,
+			optional: true
+		},
+		purpose: {
+			kind: "string",
+			maxLength: 250,
+			optional: true
+		},
+		subject: {
+			kind: "json",
+			optional: true,
+			description: "The record to link: { type, id }."
+		},
+		memberIds: {
+			kind: "uuid",
+			optional: true,
+			array: true
+		}
+	}
+});
+/** What `update` takes. */
+const channelChangeSchema = entitySchema({
+	title: "ChannelChange",
+	fields: {
+		name: {
+			kind: "string",
+			minLength: 1,
+			maxLength: 80,
+			optional: true
+		},
+		visibility: {
+			kind: "enum",
+			values: VISIBILITY,
+			optional: true
+		},
+		topic: {
+			kind: "string",
+			maxLength: 250,
+			optional: true,
+			nullable: true
+		},
+		purpose: {
+			kind: "string",
+			maxLength: 250,
+			optional: true,
+			nullable: true
+		}
+	}
+});
+//#endregion
+//#region src/blocks/channels/manifest.ts
+/** The `channels` block's manifest (ADR 0029, ADR 0062). */
+const channelsBlock = defineBlock({
+	name: "channels",
+	sql: ["channels"],
+	events: channelsEvents,
+	schemas: { channel: {
+		input: channelInputSchema,
+		change: channelChangeSchema
+	} },
+	create: createChannels,
+	category: "collaboration",
+	recipes: [
+		"channel-sidebar",
+		"message-list",
+		"thread-panel"
+	]
+});
+//#endregion
+export { channelChangeSchema, channelInputSchema, channelsBlock, channelsEvents, createChannels, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

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

@@ -1,15 +1,15 @@
 /// <reference lib="esnext.temporal" />
-import { T as ErrorMapper, t as AsyncResult } from "../../result-mijqfoJN.js";
-import { t as StandardSchemaV1 } from "../../standard-16AIDny5.js";
-import { r as FieldsOf } from "../../block-fields-DnXkMney.js";
-import { wt as Events } from "../../events-DhGgwqQA.js";
-import { m as CollectionEventData, p as CollectionEntryEventData } from "../../index-CE0p3st5.js";
+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 { C as SavedItemEventData, a as CollectionEventData, i as CollectionEntryEventData } from "../../block-events-records-BGVyoz57.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DBPhgF3W.js";
-import { i as CursorPageOptions } from "../../block-helpers-DyA5BAW4.js";
-import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-BadAniNI.js";
-import { s as BlockOf } from "../../define-block-MyM4lH42.js";
-import { t as RankNeighbors } from "../../rank-result-DHflCNwo.js";
+import { i as CursorPageOptions } 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 { _ as Notifier, c as BlockOf } from "../../define-block-COpcS6aT.js";
+import { t as RankNeighbors } from "../../rank-result-DwR0FawB.js";
 //#region src/blocks/collections/collections.d.ts
 /** Who sees a collection: its owner, a team, or the whole organization. */
 export declare const COLLECTION_SCOPES: readonly ["user", "team", "tenant"];
@@ -68,6 +68,44 @@ interface Star {
   readonly title?: string;
   readonly url?: string;
 }
+/**
+ * A record the caller saved for later, with its title and URL from
+ * `config.subjects`.
+ */
+interface SavedItem {
+  readonly id: string;
+  readonly organizationId: string;
+  /** The member who saved it. */
+  readonly userId: string;
+  readonly subjectType: string;
+  readonly subjectId: string;
+  readonly note?: string;
+  /** When to remind the member. */
+  readonly remindAt?: Temporal.Instant;
+  /** When `remindDue` sent the reminder. */
+  readonly remindedAt?: Temporal.Instant;
+  readonly completed: boolean;
+  readonly completedAt?: Temporal.Instant;
+  readonly createdAt: Temporal.Instant;
+  readonly title?: string;
+  readonly url?: string;
+}
+interface SaveForLaterInput {
+  /** At most 1000 characters. */
+  readonly note?: string;
+  /** A future time to remind the member, sent by `remindDue`. */
+  readonly remindAt?: Temporal.Instant;
+}
+/** Where a page of saved items stops: the last item's save time and id. */
+interface SavedItemCursor {
+  readonly createdAt: Temporal.Instant;
+  readonly id: string;
+}
+interface SavedItemPage {
+  readonly items: readonly SavedItem[];
+  /** Pass as `cursor` for the next page; `undefined` on the last page. */
+  readonly next?: SavedItemCursor;
+}
 interface CreateCollectionInput {
   readonly name: string;
   /** A type in `config.subjects` with a tenant column. */
@@ -144,6 +182,31 @@ interface Collections<F extends object = Record<never, never>> {
   }): AsyncResult<Star[]>;
   /** Moves a star between its neighbours' rank keys. Resolves to its new key. */
   reorderStar(subject: CollectionSubject, neighbors: RankNeighbors): AsyncResult<string>;
+  /**
+   * Saves a record for later. Saving it again replaces the note and reminder
+   * and reopens a completed item.
+   */
+  saveForLater(organizationId: string, subject: CollectionSubject, input?: SaveForLaterInput): AsyncResult<SavedItem>;
+  /** Marks a saved item done, or open again with `completed: false`. */
+  completeSaved(id: string, completed?: boolean): AsyncResult<boolean>;
+  /** Resolves to `false` when the caller has no such saved item. */
+  removeSaved(id: string): AsyncResult<boolean>;
+  /**
+   * A page of the caller's saved items, the newest first (default 50, at most
+   * 200): the open ones, or the completed ones with `completed: true`.
+   */
+  saved(organizationId: string, options?: CursorPageOptions<SavedItemCursor> & {
+    readonly completed?: boolean;
+  }): AsyncResult<SavedItemPage>;
+  /**
+   * Service role. Claims the open saved items whose reminder time has passed
+   * (default 100, at most 500), records `saved_item.reminded` for each and
+   * sends `notification` through `notifier` to the member who saved it. Each
+   * reminder is sent at most once.
+   */
+  remindDue(options?: {
+    readonly limit?: number;
+  }): AsyncResult<SavedItem[]>;
 }
 interface CollectionsOptions<S extends StandardSchemaV1 | undefined = undefined> {
   readonly transport: BlockTransport;
@@ -163,6 +226,13 @@ interface CollectionsOptions<S extends StandardSchemaV1 | undefined = undefined>
   readonly hooks?: NoInfer<BlockHooks<Collections<FieldsOf<S>>>>;
   readonly logger?: Logger;
   readonly mappers?: readonly ErrorMapper[];
+  /** The `notifier` port: the `notifications` block, from `createBlocks`. */
+  readonly notifier?: Notifier;
+  /**
+   * The notification type `remindDue` sends for a due saved item, about the
+   * saved record. Its data is `{ savedItemId, note }`.
+   */
+  readonly notification?: string;
 }
 /**
  * The collections block: favorites (a member's starred records, ranked for a
@@ -178,12 +248,15 @@ type CollectionsEvents = {
   readonly "collection.archived": CollectionEventData;
   readonly "collection.entry_added": CollectionEntryEventData;
   readonly "collection.entry_removed": CollectionEntryEventData;
+  readonly "saved_item.reminded": SavedItemEventData;
 };
 /** The `collections` block's event types, for its manifest and `onBlockEvent`. */
 export declare const collectionsEvents: Events<CollectionsEvents>;
 //#endregion
 //#region src/blocks/collections/manifest.d.ts
 /** The `collections` block's manifest (ADR 0029). */
-export declare const collectionsBlock: BlockOf<"collections", typeof createCollections, CollectionsEvents>;
+export declare const collectionsBlock: BlockOf<"collections", typeof createCollections, CollectionsEvents, {
+  readonly notifier: "optional";
+}>;
 //#endregion
-export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type Collection, type CollectionEntry, type CollectionEntryCursor, type CollectionEntryPage, type CollectionListOptions, type CollectionScope, type CollectionSubject, type Collections, type CollectionsEvents, type CollectionsOptions, type CreateCollectionInput, type RenameCollectionInput, type RpcClient, type Star, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type Collection, type CollectionEntry, type CollectionEntryCursor, type CollectionEntryPage, type CollectionListOptions, type CollectionScope, type CollectionSubject, type Collections, type CollectionsEvents, type CollectionsOptions, type CreateCollectionInput, type RenameCollectionInput, type RpcClient, type SaveForLaterInput, type SavedItem, type SavedItemCursor, type SavedItemPage, type Star, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/collections/index.js

@@ -1,13 +1,13 @@
-import { t as AsyncResult } from "../../result-DIT_qp4G.js";
+import { o as isDbError } from "../../errors-03ysrOt4.js";
+import { a as ok, r as err, t as AsyncResult } from "../../result-B3m7xtRY.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
 import { t as collectionsSqlOptions } from "../../options-BOOEzor9.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, b as oneOf, k as recordsOf, m as instantArg, o as blockCall, w as pageOf } from "../../block-helpers-CiKtrb6g.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-Ds0C2mUf.js";
-import { A as requiredInstant, C as optionalText, D as recordOf, F as stringsOf, I as textOf, S as optionalInstant, b as oneOf, k as recordsOf, o as blockCall, w as pageOf } from "../../block-helpers-DwE32_gT.js";
-import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-C1r-R2r0.js";
-import { c as withFields, i as extraOf, n as blockFields, r as extraFieldsArg, t as allWithFields } from "../../block-fields-Cwd4c8m-.js";
-import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
-import { t as rankBetweenResult } from "../../rank-result-C6vsw27N.js";
+import { c as withFields, i as extraOf, n as blockFields, r as extraFieldsArg, t as allWithFields } from "../../block-fields-DBSJSeaO.js";
+import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { t as rankBetweenResult } from "../../rank-result-C_sHjkiz.js";
 //#region src/blocks/collections/collections.ts
 /** Who sees a collection: its owner, a team, or the whole organization. */
 const COLLECTION_SCOPES = [
@@ -75,6 +75,35 @@ function starOf(value) {
 		...optional("url", optionalText(row["url"]))
 	};
 }
+function savedItemOf(value) {
+	const row = recordOf(value, "saved item");
+	const completedAt = optionalInstant(row["completedAt"]);
+	return {
+		id: textOf(row["id"]),
+		organizationId: textOf(row["organizationId"]),
+		userId: textOf(row["userId"]),
+		subjectType: textOf(row["subjectType"]),
+		subjectId: textOf(row["subjectId"]),
+		completed: completedAt !== void 0,
+		createdAt: requiredInstant(row["createdAt"], "createdAt"),
+		...optional("note", optionalText(row["note"])),
+		...optional("remindAt", optionalInstant(row["remindAt"])),
+		...optional("remindedAt", optionalInstant(row["remindedAt"])),
+		...optional("completedAt", completedAt),
+		...optional("title", optionalText(row["title"])),
+		...optional("url", optionalText(row["url"]))
+	};
+}
+function savedPage(rows, limit) {
+	const last = rows.at(-1);
+	return rows.length === (limit ?? 50) && last !== void 0 ? {
+		items: rows,
+		next: {
+			createdAt: last.createdAt,
+			id: last.id
+		}
+	} : { items: rows };
+}
 function entryPage(rows, limit) {
 	const last = rows.at(-1);
 	return rows.length === (limit ?? 50) && last !== void 0 ? {
@@ -101,6 +130,27 @@ function createCollections(options) {
 		collection: id,
 		max_ids: max ?? null
 	}, (value) => [...stringsOf(value)]);
+	const { notifier, notification } = options;
+	/** Sends the due reminders one by one; the first failed send fails the call. */
+	const notifyDue = (items) => AsyncResult.from(async () => {
+		if (notifier !== void 0 && notification !== void 0) for (const item of items) {
+			const outcome = await notifier.send(notification, {
+				recipients: [item.userId],
+				tenant: item.organizationId,
+				key: `saved_item:${item.id}:${String(item.remindAt)}`,
+				subject: {
+					type: item.subjectType,
+					id: item.subjectId
+				},
+				data: {
+					savedItemId: item.id,
+					note: item.note ?? null
+				}
+			});
+			if (isRecord(outcome) && outcome["ok"] === false && isDbError(outcome["error"])) return err(outcome["error"]);
+		}
+		return ok([...items]);
+	});
 	return withBlockHooks({
 		create: (organizationId, input) => saved("create_collection", {
 			tenant: organizationId,
@@ -178,7 +228,30 @@ function createCollections(options) {
 				subject_id: subject.id,
 				rank: key.data
 			}, () => key.data);
-		}
+		},
+		saveForLater: (organizationId, subject, input = {}) => call("save_for_later", {
+			tenant: organizationId,
+			subject_type: subject.type,
+			subject_id: subject.id,
+			note: input.note ?? null,
+			remind_at: instantArg(input.remindAt) ?? null
+		}, savedItemOf),
+		completeSaved: (id, completed = true) => call("complete_saved_item", {
+			item: id,
+			completed
+		}, (value) => value === true),
+		removeSaved: (id) => call("remove_saved_item", { item: id }, (value) => value === true),
+		saved: (organizationId, savedOptions = {}) => {
+			const { limit, cursor } = pageOf(savedOptions);
+			return call("list_saved_items", {
+				tenant: organizationId,
+				completed: savedOptions.completed ?? false,
+				before: instantArg(cursor?.createdAt) ?? null,
+				before_id: cursor?.id ?? null,
+				max_rows: limit ?? null
+			}, (value) => savedPage(recordsOf(value, "list_saved_items").map(savedItemOf), limit));
+		},
+		remindDue: (dueOptions = {}) => call("remind_due_saved_items", { max_rows: dueOptions.limit ?? null }, (value) => recordsOf(value, "remind_due_saved_items").map(savedItemOf)).andThen(notifyDue)
 	}, options.hooks, {
 		block: "collections",
 		...options.logger ? { logger: options.logger } : {}
@@ -191,7 +264,8 @@ const collectionsEvents = defineEvents({
 	"collection.created": event(),
 	"collection.archived": event(),
 	"collection.entry_added": event(),
-	"collection.entry_removed": event()
+	"collection.entry_removed": event(),
+	"saved_item.reminded": event()
 });
 //#endregion
 //#region src/blocks/collections/manifest.ts
@@ -201,6 +275,7 @@ const collectionsBlock = defineBlock({
 	sql: ["collections"],
 	options: { collections: collectionsSqlOptions },
 	events: collectionsEvents,
+	consumes: { notifier: "optional" },
 	create: createCollections,
 	category: "work"
 });

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

@@ -1,53 +1,54 @@
-import { j as CommentEventData, wt as Events } from "../../events-DhGgwqQA.js";
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DBPhgF3W.js";
-import { s as BlockOf } from "../../define-block-MyM4lH42.js";
-import { C as mentionsIn, S as createComments, _ as CommentsOptions, a as CommentsSnapshot, b as activityListQuery, c as ActivityEntry, d as ActivitySinkOptions, f as ActivitySort, g as Comments, h as CommentEdit, i as CommentsControllerOptions, l as ActivityFacet, m as Comment, n as CommentsActions, o as createCommentsController, p as ActivitySource, r as CommentsController, s as ActivityDescription, t as CommentDraft, u as ActivityHistoryOptions, v as ListCommentsOptions, x as activitySink, y as NewComment } from "../../client-EQvEzUQg.js";
-//#region src/sql/subjects.d.ts
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
+import { O as CommentsSqlOptions } from "../../authorization-BuT26_sR.js";
+import { t as Author } from "../../block-authors-DzXLUiIq.js";
+import { a as isFileAnchor, i as fileAnchor, n as FileAnchor, o as conversationTopic, r as FileAnchorAt, t as AnchorRegion } from "../../anchors-7F34QyHa.js";
+import { c as MessageEdit } from "../../messaging-CZ6aWb10.js";
+import { Gt as SectionWrite, Lt as Section, Wt as SectionRowInput, c as BlockOf, rn as EntitySchema } from "../../define-block-COpcS6aT.js";
+import { a as CommentsSnapshot, c as CommentAssignment, d as CommentsOptions, f as ListCommentsOptions, h as mentionsIn, i as CommentsControllerOptions, l as CommentEdit, m as createComments, n as CommentsActions, o as createCommentsController, p as NewComment, r as CommentsController, s as Comment, t as CommentDraft, u as Comments } from "../../client-CA6KuLDu.js";
+//#region src/blocks/comments/section.d.ts
+/** A pending write to a thread, for `useOptimistic`. */
+type CommentsOptimisticAction = {
+  readonly type: "add";
+  readonly comment: Comment;
+} | {
+  readonly type: "edit";
+  readonly id: string;
+  readonly body: string;
+} | {
+  readonly type: "remove";
+  readonly id: string;
+};
 /**
- * One subject type a module's rows belong to (`options.subjects`): the table
- * its ids point at, and who may read it.
+ * The thread with a pending write applied: `add` appends (or replaces the
+ * comment with the same id), `edit` changes the body, `remove` takes it out.
  */
-interface Subject {
-  /** `schema.table`, or a table in `public`. */
-  readonly table: string;
-  /** Default `id`. */
-  readonly id?: string;
-  /**
-   * The id column's type, such as `uuid` or `bigint`. With it, the stored text
-   * id is cast to that type, so the lookup uses the subject table's primary
-   * key; without it the column is cast to text, which can't.
-   */
-  readonly idType?: string;
-  /**
-   * The subject's tenant column, default `organization_id`. `false` for a
-   * subject without a tenant (a user's own records), where the subject table's
-   * policies alone decide, in modules that allow it.
-   */
-  readonly tenant?: string | false;
-  /** A permission the caller also needs in the tenant, e.g. `projects.read`. */
-  readonly permission?: string;
-  /** Delete the module's rows for a subject when the subject row is deleted. */
-  readonly cascade?: boolean;
-  /** The module's own keys, such as a bucket per subject. */
-  readonly extra: Readonly<Record<string, unknown>>;
-}
-//#endregion
-//#region src/sql/modules/comments.d.ts
-/** One commentable subject type: its table, and who may read it. */
-type CommentSubject = Omit<Subject, "extra">;
-//#endregion
-//#region src/blocks/comments/events.d.ts
-/** The events of the `comments` block: type to data. */
-type CommentsEvents = {
-  readonly "comment.created": CommentEventData;
-  readonly "comment.mentioned": CommentEventData;
-  readonly "comment.deleted": CommentEventData;
+export declare function commentsOptimistic(state: readonly Comment[], action: CommentsOptimisticAction): readonly Comment[];
+/** The writes of the comments section. */
+type CommentsWrites = {
+  /** Adds a comment to the record's thread. */
+  readonly add: SectionWrite<Comments, NewComment, Comment>;
+  /** Removes one comment; its author or a moderator. */
+  readonly remove: SectionWrite<Comments, SectionRowInput, boolean>;
 };
-/** The `comments` block's event types, for its manifest and `onBlockEvent`. */
-export declare const commentsEvents: Events<CommentsEvents>;
+/**
+ * A record's comment thread, oldest first. The messaging events make it stale:
+ * a record conversation's messages carry `conversationKind: "subject"`.
+ */
+export declare const commentsSection: Section<Comments, readonly Comment[], ListCommentsOptions, CommentsOptimisticAction, CommentsWrites>;
 //#endregion
 //#region src/blocks/comments/manifest.d.ts
-/** The `comments` block's manifest (ADR 0029). */
-export declare const commentsBlock: BlockOf<"comments", typeof createComments, CommentsEvents>;
+/** The `comments` block's manifest (ADR 0029, ADR 0062). */
+export declare const commentsBlock: BlockOf<"comments", typeof createComments, Record<never, never>, Record<never, never>, never, {
+  readonly comments: typeof commentsSection;
+}>;
+//#endregion
+//#region src/blocks/comments/schemas.d.ts
+/**
+ * What `create` takes after the subject. The body's length limit is
+ * `blocks.messaging.options.maxBodyLength`, so the SQL checks it.
+ */
+export declare const commentInputSchema: EntitySchema<NewComment>;
+/** What `edit` takes: a message edit. */
+export declare const commentChangeSchema: EntitySchema<CommentEdit>;
 //#endregion
-export { type ActivityDescription, type ActivityEntry, type ActivityFacet, type ActivityHistoryOptions, type ActivitySinkOptions, type ActivitySort, type ActivitySource, type BlockTransport, type Comment, type CommentDraft, type CommentEdit, type CommentSubject, type Comments, type CommentsActions, type CommentsController, type CommentsControllerOptions, type CommentsEvents, type CommentsOptions, type CommentsSnapshot, type ListCommentsOptions, type NewComment, activityListQuery, activitySink, createComments, createCommentsController, dbTransport, mentionsIn, rpcTransport, sqlTransport };
+export { type AnchorRegion, type Author, type BlockTransport, type Comment, type CommentAssignment, type CommentDraft, type CommentEdit, type Comments, type CommentsActions, type CommentsController, type CommentsControllerOptions, type CommentsOptimisticAction, type CommentsOptions, type CommentsSnapshot, type CommentsSqlOptions, type CommentsWrites, type FileAnchor, type FileAnchorAt, type ListCommentsOptions, type MessageEdit, type NewComment, conversationTopic, createComments, createCommentsController, dbTransport, fileAnchor, isFileAnchor, mentionsIn, rpcTransport, sqlTransport };