better-supabase 0.12.0 → 0.14.0

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

@@ -1,17 +1,16 @@
 /// <reference lib="esnext.temporal" />
-import { t as AsyncResult } from "../../result-BREt7qOh.js";
-import { M as CommerceEventData, wt as Events } from "../../events-P3raDX2E.js";
+import { 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, j as CommerceEventData } from "../../events-DbLjvxDX.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { t as StandardSchemaV1 } from "../../standard-BcUQuUgu.js";
-import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DezJPPA0.js";
-import { n as BlockOptions } from "../../block-helpers-CjcQM1yA.js";
-import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-DcPJHztl.js";
-import { r as FieldsOf } from "../../block-fields-DnaDbgZS.js";
-import { h as FilterQuery } from "../../filter-query-Bc_Qa8V_.js";
-import { s as BlockOf } from "../../define-block-BHxLHLys.js";
-import { n as SubjectsConfig } from "../../subjects-DP-fvFkk.js";
-import { t as RankNeighbors } from "../../rank-result-BcYfDA0x.js";
-import { n as Money } from "../../money-DFpWzQvk.js";
+import { n as BlockOptions } 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 { n as Money } from "../../money-BNRdJQzA.js";
+import { h as FilterQuery } from "../../filter-query-o3b_GuyC.js";
+import { t as RankNeighbors } from "../../rank-result-DwR0FawB.js";
 //#region src/blocks/catalog/catalog.d.ts
 export declare const PRODUCT_KINDS: readonly ["physical", "digital", "service"];
 type ProductKind = (typeof PRODUCT_KINDS)[number];
@@ -20,10 +19,10 @@ type ProductStatus = (typeof PRODUCT_STATUSES)[number];
 interface CatalogOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockOptions {
   /**
    * A Standard Schema for the product columns the app adds
-   * (`blocks.catalog.options.extraColumns`), keyed by column name. It
-   * validates them on `createProduct` and `updateProduct`, which return a
-   * `validation` error for a bad value, and types and parses them on the
-   * saved product they return.
+   * (`blocks.catalog.options.extraColumns`), keyed by column name. It validates
+   * them on `createProduct` and `updateProduct`, which return a `validation`
+   * error for a bad value, and types and parses them on the saved product they
+   * return.
    */
   readonly fields?: S;
   /** `withBlockHooks` hooks around any catalog method. */
@@ -33,7 +32,10 @@ interface CatalogOptions<S extends StandardSchemaV1 | undefined = undefined> ext
 }
 interface ProductInput {
   readonly title: string;
-  /** Lower-case letters, digits and hyphens; derived from the title when left out. */
+  /**
+   * Lower-case letters, digits and hyphens; derived from the title when left
+   * out.
+   */
   readonly slug?: string;
   readonly description?: string;
   /** Default `physical`. */
@@ -134,8 +136,8 @@ interface CollectionBase {
   readonly slug?: string;
 }
 /**
- * A manual collection lists ranked products; a rule collection stores a
- * filter tree that the app evaluates with its list query over products.
+ * A manual collection lists ranked products; a rule collection stores a filter
+ * tree that the app evaluates with its list query over products.
  */
 type CollectionInput = (CollectionBase & {
   readonly kind: "manual";
@@ -167,38 +169,41 @@ interface Catalog<F extends object = Record<never, never>> {
     readonly id: string;
   }>;
   deletePriceList(priceListId: string): AsyncResult<boolean>;
-  /** Sets a variant's price in the amount's currency. Emits `catalog.price_changed`. */
+  /**
+   * Sets a variant's price in the amount's currency. Emits
+   * `catalog.price_changed`.
+   */
   setPrice(variantId: string, input: PriceInput): AsyncResult<SavedPrice>;
   deletePrice(priceId: string): AsyncResult<boolean>;
   /** The price list's price when it has one, otherwise the base price. */
   variantPrice(variantId: string, currency: string, options?: VariantPriceOptions): AsyncResult<Price | null>;
   saveCategory(organizationId: string, input: CategoryInput): AsyncResult<SavedCategory>;
-  /** Moves a category under `parentId` (null for the top level) between two siblings. */
+  /**
+   * Moves a category under `parentId` (null for the top level) between two
+   * siblings.
+   */
   moveCategory(categoryId: string, parentId: string | null, neighbors: RankNeighbors): AsyncResult<string>;
   deleteCategory(categoryId: string): AsyncResult<boolean>;
   setProductCategories(productId: string, categoryIds: readonly string[]): AsyncResult<boolean>;
   saveCollection(organizationId: string, input: CollectionInput): AsyncResult<SavedCollection>;
   deleteCollection(collectionId: string): AsyncResult<boolean>;
-  /** Adds a product to a manual collection, last or between two neighbors. Resolves to its rank key. */
+  /**
+   * Adds a product to a manual collection, last or between two neighbors.
+   * Resolves to its rank key.
+   */
   addToCollection(collectionId: string, productId: string, neighbors?: RankNeighbors): AsyncResult<string>;
   removeFromCollection(collectionId: string, productId: string): AsyncResult<boolean>;
-  /** With `options.storefront: "public"`, anyone can read a published storefront's active products. */
+  /**
+   * With `options.storefront: "public"`, anyone can read a published
+   * storefront's active products.
+   */
   publishStorefront(organizationId: string, published: boolean): AsyncResult<boolean>;
 }
-/** Products, variants, prices, categories and collections over the `catalog` SQL module. */
-export declare function createCatalog<S extends StandardSchemaV1 | undefined = undefined>(options: CatalogOptions<S>): Catalog<FieldsOf<S>>;
-interface CatalogSubjectsOptions {
-  /** The catalog module's schema. Default `better_supabase`. */
-  readonly schema?: string;
-  /** The product page path, with `{column}` placeholders. Default `/products/{slug}`. */
-  readonly productUrl?: string;
-}
 /**
- * `config.subjects` entries for products and variants, so comments, tags,
- * watchers and the search index attach to them:
- * `subjects: { ...catalogSubjects(), task: { ... } }`.
+ * Products, variants, prices, categories and collections over the `catalog` SQL
+ * module.
  */
-export declare function catalogSubjects(subjectOptions?: CatalogSubjectsOptions): SubjectsConfig;
+export declare function createCatalog<S extends StandardSchemaV1 | undefined = undefined>(options: CatalogOptions<S>): Catalog<FieldsOf<S>>;
 //#endregion
 //#region src/blocks/catalog/events.d.ts
 /** The events of the `catalog` block: type to data. */
@@ -221,4 +226,11 @@ export declare const catalogEvents: Events<CatalogEvents>;
 /** The `catalog` block's manifest (ADR 0029). */
 export declare const catalogBlock: BlockOf<"catalog", typeof createCatalog, CatalogEvents>;
 //#endregion
-export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type Catalog, type CatalogEvents, type CatalogOptions, type CatalogSubjectsOptions, type CategoryInput, type CollectionInput, type OptionInput, type OptionValue, type Price, type PriceInput, type PriceListInput, type ProductInput, type ProductKind, type ProductStatus, type RpcClient, type SavedCategory, type SavedCollection, type SavedOption, type SavedPrice, type SavedProduct, type SavedVariant, type StatusChange, type VariantInput, type VariantPriceOptions, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+//#region src/blocks/catalog/schemas.d.ts
+/**
+ * What `createProduct` and `updateProduct` take, with the bounds the SQL
+ * checks.
+ */
+export declare const productInputSchema: EntitySchema<ProductInput>;
+//#endregion
+export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type Catalog, type CatalogEvents, type CatalogOptions, type CategoryInput, type CollectionInput, type OptionInput, type OptionValue, type Price, type PriceInput, type PriceListInput, type ProductInput, type ProductKind, type ProductStatus, type RpcClient, type SavedCategory, type SavedCollection, type SavedOption, type SavedPrice, type SavedProduct, type SavedVariant, type StatusChange, type VariantInput, type VariantPriceOptions, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/catalog/index.js

@@ -1,16 +1,16 @@
-import { n as dbError } from "../../errors-BV1SKTVs.js";
-import { t as AsyncResult } from "../../result-DIeYscA3.js";
+import { n as dbError } from "../../errors-03ysrOt4.js";
+import { t as AsyncResult } from "../../result-B3m7xtRY.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
 import { t as catalogSqlOptions } from "../../options-BnoJOwXK.js";
-import { n as event, t as defineEvents } from "../../event-map-Dy2vKHai.js";
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-J7ZepTq2.js";
-import { C as optionalText, D as recordOf, I as textOf, d as enumOrThrow, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall } from "../../block-helpers-DkVZNDrj.js";
-import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-C22vuIUd.js";
-import { c as withFields, n as blockFields, r as extraFieldsArg } from "../../block-fields-Bv1hV855.js";
-import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
-import { t as rankBetweenResult } from "../../rank-result-DtQuIvob.js";
-import { d as money } from "../../money-95Rff2vT.js";
-import { a as optionalAmountText, o as optionalMoneyOf } from "../../money-codec-C21MWw50.js";
+import { B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, 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 { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
+import { c as withFields, n as blockFields, r as extraFieldsArg } from "../../block-fields-DBSJSeaO.js";
+import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { t as rankBetweenResult } from "../../rank-result-C_sHjkiz.js";
+import { d as money } from "../../money-BZl985O-.js";
+import { a as optionalAmountText, o as optionalMoneyOf } from "../../money-codec-jMP0PQLZ.js";
 //#region src/blocks/catalog/catalog.ts
 const PRODUCT_KINDS = [
 	"physical",
@@ -64,7 +64,10 @@ function variantArgs(productId, variantId, input) {
 		allow_backorder: input.allowBackorder ?? null
 	};
 }
-/** Products, variants, prices, categories and collections over the `catalog` SQL module. */
+/**
+* Products, variants, prices, categories and collections over the `catalog` SQL
+* module.
+*/
 function createCatalog(options) {
 	applyTemporal(options);
 	const call = blockCall(options.transport, options.schema, options.mappers);
@@ -222,45 +225,6 @@ function createCatalog(options) {
 		...options.logger ? { logger: options.logger } : {}
 	});
 }
-/**
-* `config.subjects` entries for products and variants, so comments, tags,
-* watchers and the search index attach to them:
-* `subjects: { ...catalogSubjects(), task: { ... } }`.
-*/
-function catalogSubjects(subjectOptions = {}) {
-	const schema = subjectOptions.schema ?? "better_supabase";
-	const permissions = {
-		read: "catalog.read",
-		write: "catalog.manage"
-	};
-	return {
-		product: {
-			table: `${schema}.products`,
-			idType: "uuid",
-			tenant: "tenant_id",
-			title: "title",
-			url: subjectOptions.productUrl ?? "/products/{slug}",
-			permissions,
-			cascade: true,
-			search: {
-				title: "title",
-				body: ["description", "slug"]
-			}
-		},
-		product_variant: {
-			table: `${schema}.product_variants`,
-			idType: "uuid",
-			tenant: "tenant_id",
-			title: "sku",
-			permissions,
-			cascade: true,
-			search: {
-				title: "sku",
-				body: ["title", "barcode"]
-			}
-		}
-	};
-}
 //#endregion
 //#region src/blocks/catalog/events.ts
 /** The `catalog` block's event types, for its manifest and `onBlockEvent`. */
@@ -277,6 +241,37 @@ const catalogEvents = defineEvents({
 	"storefront.unpublished": event()
 });
 //#endregion
+//#region src/blocks/catalog/schemas.ts
+/**
+* What `createProduct` and `updateProduct` take, with the bounds the SQL
+* checks.
+*/
+const productInputSchema = entitySchema({
+	title: "ProductInput",
+	fields: {
+		title: {
+			kind: "string",
+			minLength: 1,
+			maxLength: 500
+		},
+		slug: {
+			kind: "string",
+			optional: true,
+			minLength: 1,
+			description: "Lower-case letters, digits and hyphens."
+		},
+		description: {
+			kind: "string",
+			optional: true
+		},
+		kind: {
+			kind: "enum",
+			values: PRODUCT_KINDS,
+			optional: true
+		}
+	}
+});
+//#endregion
 //#region src/blocks/catalog/manifest.ts
 /** The `catalog` block's manifest (ADR 0029). */
 const catalogBlock = defineBlock({
@@ -286,7 +281,8 @@ const catalogBlock = defineBlock({
 	events: catalogEvents,
 	create: createCatalog,
 	category: "commerce",
-	recipes: ["product-catalog-grid"]
+	recipes: ["product-catalog-grid"],
+	schemas: { product: { input: productInputSchema } }
 });
 //#endregion
-export { PRODUCT_KINDS, PRODUCT_STATUSES, catalogBlock, catalogEvents, catalogSubjects, createCatalog, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+export { PRODUCT_KINDS, PRODUCT_STATUSES, catalogBlock, catalogEvents, createCatalog, dbTransport, extendBlock, productInputSchema, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

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

@@ -0,0 +1,111 @@
+/// <reference lib="esnext.temporal" />
+import { T as ErrorMapper, t as AsyncResult } from "../../result-C6jDfedy.js";
+import { dt as SubjectRef } from "../../executor-CPyrQdjh.js";
+import { Ct as Events } from "../../events-DbLjvxDX.js";
+import { r as ChannelEventData } from "../../block-events-records-BGVyoz57.js";
+import { n as Logger } from "../../logger-DWVYUmwi.js";
+import { a as BlockTenantOptions, 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";
+//#region src/blocks/channels/channels.d.ts
+/** Who reads a channel: the tenant, or its members. */
+type ChannelVisibility = "public" | "private";
+/** A channel. Its `id` is also its conversation's id in `messaging`. */
+interface Channel {
+  readonly id: string;
+  readonly organizationId: string;
+  /** Lowercase letters, digits, `-` and `_`, unique in the tenant. */
+  readonly name: string;
+  readonly visibility: ChannelVisibility;
+  readonly topic: string | undefined;
+  readonly purpose: string | undefined;
+  /** The record the channel is linked to. */
+  readonly subject: SubjectRef | undefined;
+  readonly createdBy: string | undefined;
+  /** The caller's role, or `undefined` when they haven't joined. */
+  readonly role: "owner" | "member" | undefined;
+  readonly memberCount: number;
+  readonly lastMessageAt: Temporal.Instant | undefined;
+  readonly archivedAt: Temporal.Instant | undefined;
+  readonly createdAt: Temporal.Instant;
+  readonly updatedAt: Temporal.Instant;
+}
+interface NewChannel {
+  readonly name: string;
+  /** Default `public`. */
+  readonly visibility?: ChannelVisibility;
+  readonly topic?: string | undefined;
+  readonly purpose?: string | undefined;
+  /** A record to link the channel to; the caller must read it. */
+  readonly subject?: SubjectRef;
+  /** Members besides the caller, who owns the channel. */
+  readonly memberIds?: readonly string[];
+}
+/** A key left out keeps its value; `null` clears `topic` and `purpose`. */
+interface ChannelChange {
+  readonly name?: string;
+  readonly visibility?: ChannelVisibility;
+  readonly topic?: string | null;
+  readonly purpose?: string | null;
+}
+/** Every method that takes no id acts in the block's `tenant`. */
+interface Channels {
+  /** Creates a channel and its conversation; the caller owns it. */
+  create(channel: NewChannel): AsyncResult<Channel>;
+  /** The manage key or the channel's owner. */
+  update(channelId: string, change: ChannelChange): AsyncResult<Channel>;
+  /** Archives the channel (read-only from then on) or restores it. */
+  archive(channelId: string, archived?: boolean): AsyncResult<boolean>;
+  /** The caller joins a public channel. */
+  join(channelId: string): AsyncResult<boolean>;
+  /** The caller leaves; `false` when they weren't a member. */
+  leave(channelId: string): AsyncResult<boolean>;
+  /** Adds members; returns how many joined. */
+  invite(channelId: string, userIds: readonly string[]): AsyncResult<number>;
+  /** The caller's channels by name, or with `browse` every channel they can see. */
+  list(options?: {
+    readonly browse?: boolean;
+    readonly includeArchived?: boolean;
+  }): AsyncResult<Channel[]>;
+  get(channelId: string): AsyncResult<Channel | undefined>;
+  /** A channel by name in the tenant. */
+  find(name: string): AsyncResult<Channel | undefined>;
+  /** The channels linked to a record that the caller can see. */
+  forSubject(subject: SubjectRef): AsyncResult<Channel[]>;
+}
+interface ChannelsOptions extends BlockTemporalOptions, BlockTenantOptions {
+  readonly transport: BlockTransport;
+  /** The module schema, or its API schema. Default `better_supabase`. */
+  readonly schema?: string;
+  readonly hooks?: BlockHooks<Channels>;
+  readonly logger?: Logger;
+  readonly mappers?: readonly ErrorMapper[];
+}
+/**
+ * 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.
+ */
+export declare function createChannels(options: ChannelsOptions): Channels;
+//#endregion
+//#region src/blocks/channels/events.d.ts
+/** The events of the `channels` block: type to data. */
+type ChannelsEvents = {
+  readonly "channel.created": ChannelEventData;
+  readonly "channel.updated": ChannelEventData;
+};
+/** The `channels` block's event types, for its manifest and `onBlockEvent`. */
+export declare const channelsEvents: Events<ChannelsEvents>;
+//#endregion
+//#region src/blocks/channels/manifest.d.ts
+/** The `channels` block's manifest (ADR 0029, ADR 0062). */
+export declare const channelsBlock: BlockOf<"channels", typeof createChannels, ChannelsEvents>;
+//#endregion
+//#region src/blocks/channels/schemas.d.ts
+/** What `create` takes. The SQL checks the name's shape. */
+export declare const channelInputSchema: EntitySchema<NewChannel>;
+/** What `update` takes. */
+export declare const channelChangeSchema: EntitySchema<ChannelChange>;
+//#endregion
+export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type Channel, type ChannelChange, type ChannelVisibility, type Channels, type ChannelsEvents, type ChannelsOptions, type NewChannel, type RpcClient, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

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 };