better-supabase 0.13.0 → 0.15.0

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

@@ -1,17 +1,16 @@
 /// <reference lib="esnext.temporal" />
-import { 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 { M as CommerceEventData, wt as Events } from "../../events-DhGgwqQA.js";
+import { 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, j as CommerceEventData } from "../../events-vcqenSYU.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 { n as BlockOptions } 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 { h as FilterQuery } from "../../filter-query-C7qgRYYv.js";
-import { s as BlockOf } from "../../define-block-MyM4lH42.js";
-import { n as SubjectsConfig } from "../../subjects-DQ2SU4cA.js";
+import { i as CursorPageOptions, n as BlockOptions } 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 { h as FilterQuery } from "../../filter-query-BXLs72G9.js";
+import { Sn as EntitySchema, c as BlockOf } from "../../define-block-BVcLQ3DF.js";
 import { n as Money } from "../../money-BNRdJQzA.js";
-import { t as RankNeighbors } from "../../rank-result-DHflCNwo.js";
+import { t as RankNeighbors } from "../../rank-result-Bwe7igy-.js";
 //#region src/blocks/catalog/catalog.d.ts
 export declare const PRODUCT_KINDS: readonly ["physical", "digital", "service"];
 type ProductKind = (typeof PRODUCT_KINDS)[number];
@@ -151,6 +150,83 @@ interface SavedCollection {
   readonly slug: string;
   readonly kind: "manual" | "rule";
 }
+interface ChannelInput {
+  /** Updates this channel; creates one when left out. */
+  readonly id?: string;
+  /** Lower-case letters, digits and hyphens, unique per organization. */
+  readonly key: string;
+  readonly name: string;
+  /** The ISO 4217 code the channel sells in. */
+  readonly currency?: string;
+  /** The price list its prices come from; base prices when left out. */
+  readonly priceListId?: string;
+  /** Default `true` for a new channel; an update keeps it when left out. */
+  readonly active?: boolean;
+}
+interface SavedChannel {
+  readonly id: string;
+  readonly key: string;
+  readonly active: boolean;
+}
+interface LocaleOptions {
+  /**
+   * A language tag. A locale the catalog doesn't list falls back to its
+   * language, then to the default locale (`options.locales[0]`).
+   */
+  readonly locale?: string;
+}
+/** `cursor` is the `slug` of the previous page's last product. */
+interface ChannelProductsOptions extends LocaleOptions, CursorPageOptions<string> {}
+interface ChannelProduct {
+  readonly id: string;
+  readonly slug: string;
+  /** `draft`, `active`, `archived`, or a state a state machine adds. */
+  readonly status: string;
+  readonly kind?: ProductKind;
+  /** The locale the text is in. */
+  readonly locale: string;
+  readonly title: string;
+  readonly description?: string;
+  readonly listedAt: Temporal.Instant;
+}
+/** A product's text in one locale; a key left out falls back to the default. */
+interface ProductTranslation {
+  readonly title?: string;
+  readonly description?: string;
+}
+interface LocalizedVariant {
+  readonly id: string;
+  readonly sku: string;
+  readonly title?: string;
+}
+interface LocalizedProduct {
+  readonly id: string;
+  readonly slug: string;
+  readonly locale: string;
+  readonly title: string;
+  readonly description?: string;
+  readonly variants: readonly LocalizedVariant[];
+}
+interface ProductMediaInput {
+  /** Shows the file for one variant of the product. */
+  readonly variantId?: string;
+  /** Alt text keyed by configured locale. */
+  readonly alt?: Readonly<Record<string, string>>;
+}
+interface SavedProductMedia {
+  readonly id: string;
+  readonly position: number;
+}
+interface ProductMedia {
+  readonly id: string;
+  readonly attachmentId: string;
+  readonly variantId?: string;
+  /** From 0, in display order. */
+  readonly position: number;
+  /** The alt text in the requested locale, or the default locale's. */
+  readonly alt?: string;
+  readonly altByLocale: Readonly<Record<string, string>>;
+}
 /** `F` is the extra product fields `options.fields` describes. */
 interface Catalog<F extends object = Record<never, never>> {
   /** Keys besides the input's own are the product's extra columns. */
@@ -199,27 +275,50 @@ interface Catalog<F extends object = Record<never, never>> {
    * 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;
+  /** Creates a sales channel, or updates the one `input.id` names. */
+  saveChannel(organizationId: string, input: ChannelInput): AsyncResult<SavedChannel>;
+  /** Deletes a channel and its listings. */
+  deleteChannel(channelId: string): AsyncResult<boolean>;
+  /** Lists products on a channel. Resolves to how many were new there. */
+  listOnChannel(channelId: string, productIds: readonly string[]): AsyncResult<number>;
+  /** Takes products off a channel. Resolves to how many were listed. */
+  unlistFromChannel(channelId: string, productIds: readonly string[]): AsyncResult<number>;
+  /** The products listed on a channel by slug, 100 a page (500 at most). */
+  channelProducts(channelId: string, options?: ChannelProductsOptions): AsyncResult<readonly ChannelProduct[]>;
   /**
-   * The product page path, with `{column}` placeholders. Default
-   * `/products/{slug}`.
+   * The variant's price in the channel's currency and price list; null when the
+   * channel has no currency or the variant no price.
    */
-  readonly productUrl?: string;
+  channelPrice(channelId: string, variantId: string, options?: {
+    readonly at?: Temporal.Instant;
+  }): AsyncResult<Price | null>;
+  /**
+   * Sets a product's text in a locale other than the default. An empty
+   * translation removes it. Resolves to whether one is stored.
+   */
+  setProductTranslation(productId: string, locale: string, translation: ProductTranslation): AsyncResult<boolean>;
+  /** Sets a variant's title in a locale; null removes the translation. */
+  setVariantTranslation(variantId: string, locale: string, title: string | null): AsyncResult<boolean>;
+  /** A product's text and its variants' titles in a locale, with fallback. */
+  productText(productId: string, options?: LocaleOptions): AsyncResult<LocalizedProduct | null>;
+  /**
+   * Adds an attachment of the product or one of its variants to the product's
+   * media, last. Needs the attachments block.
+   */
+  addProductMedia(productId: string, attachmentId: string, input?: ProductMediaInput): AsyncResult<SavedProductMedia>;
+  /** Replaces a media item's variant and alt text. */
+  updateProductMedia(mediaId: string, input: ProductMediaInput): AsyncResult<boolean>;
+  /** Puts the product's media in this order; it lists every item once. */
+  reorderProductMedia(productId: string, mediaIds: readonly string[]): AsyncResult<boolean>;
+  /** Removes a media item; the attachment stays. */
+  removeProductMedia(mediaId: string): AsyncResult<boolean>;
+  productMedia(productId: string, options?: LocaleOptions): AsyncResult<readonly ProductMedia[]>;
 }
 /**
- * `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, collections, sales channels,
+ * translations and product media 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. */
@@ -242,4 +341,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 ChannelInput, type ChannelProduct, type ChannelProductsOptions, type CollectionInput, type LocaleOptions, type LocalizedProduct, type LocalizedVariant, type OptionInput, type OptionValue, type Price, type PriceInput, type PriceListInput, type ProductInput, type ProductKind, type ProductMedia, type ProductMediaInput, type ProductStatus, type ProductTranslation, type RpcClient, type SavedCategory, type SavedChannel, type SavedCollection, type SavedOption, type SavedPrice, type SavedProduct, type SavedProductMedia, 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-D7u24ZJH.js";
-import { t as AsyncResult } from "../../result-DIT_qp4G.js";
+import { n as dbError } from "../../errors-BVFgt8BZ.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
-import { t as catalogSqlOptions } from "../../options-BnoJOwXK.js";
+import { t as AsyncResult } from "../../result-ntFBW2p2.js";
+import { t as catalogSqlOptions } from "../../options-BnZS7IK-.js";
+import { B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, U as sqlTransport, d as enumOrThrow, h as instantOf, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall, w as pageOf } from "../../block-helpers-CtBdjgO4.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
+import { n as entitySchema } from "../../entity-schema-BDv6w-OQ.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-Ds0C2mUf.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-DwE32_gT.js";
-import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-C1r-R2r0.js";
-import { c as withFields, n as blockFields, r as extraFieldsArg } 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, n as blockFields, r as extraFieldsArg } from "../../block-fields-DE_FgpOU.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+import { t as rankBetweenResult } from "../../rank-result-BBJIK-k_.js";
 import { d as money } from "../../money-BZl985O-.js";
-import { a as optionalAmountText, o as optionalMoneyOf } from "../../money-codec-BdnIiFFX.js";
+import { a as optionalAmountText, o as optionalMoneyOf } from "../../money-codec-BzddguAQ.js";
 //#region src/blocks/catalog/catalog.ts
 const PRODUCT_KINDS = [
 	"physical",
@@ -51,6 +51,60 @@ function priceOf(value) {
 		...priceListId === void 0 ? {} : { priceListId }
 	};
 }
+function countOf(value) {
+	const count = typeof value === "number" ? value : Number(textOf(value));
+	if (!Number.isInteger(count)) throw new TypeError(`set_channel_listing returned ${JSON.stringify(value)}`);
+	return count;
+}
+function textsOf(value) {
+	if (!isRecord(value)) return {};
+	return Object.fromEntries(Object.entries(value).flatMap(([key, entry]) => typeof entry === "string" ? [[key, entry]] : []));
+}
+function channelProductOf(row) {
+	const description = optionalText(row["description"]);
+	const kind = row["kind"] === null || row["kind"] === void 0 ? void 0 : enumOrThrow(row["kind"], PRODUCT_KINDS, "product kind");
+	return {
+		id: textOf(row["id"]),
+		slug: textOf(row["slug"]),
+		status: textOf(row["status"]),
+		...kind === void 0 ? {} : { kind },
+		locale: textOf(row["locale"]),
+		title: textOf(row["title"]),
+		...description === void 0 ? {} : { description },
+		listedAt: instantOf(row["listedAt"])
+	};
+}
+function localizedOf(value) {
+	if (!isRecord(value)) return null;
+	const description = optionalText(value["description"]);
+	return {
+		id: textOf(value["id"]),
+		slug: textOf(value["slug"]),
+		locale: textOf(value["locale"]),
+		title: textOf(value["title"]),
+		...description === void 0 ? {} : { description },
+		variants: recordsOf(value["variants"], "product_text").map((entry) => {
+			const title = optionalText(entry["title"]);
+			return {
+				id: textOf(entry["id"]),
+				sku: textOf(entry["sku"]),
+				...title === void 0 ? {} : { title }
+			};
+		})
+	};
+}
+function mediaOf(row) {
+	const variantId = optionalText(row["variantId"]);
+	const alt = optionalText(row["alt"]);
+	return {
+		id: textOf(row["id"]),
+		attachmentId: textOf(row["attachmentId"]),
+		...variantId === void 0 ? {} : { variantId },
+		position: Number(row["position"]),
+		...alt === void 0 ? {} : { alt },
+		altByLocale: textsOf(row["altByLocale"])
+	};
+}
 function variantArgs(productId, variantId, input) {
 	return {
 		product: productId,
@@ -65,8 +119,8 @@ function variantArgs(productId, variantId, input) {
 	};
 }
 /**
-* Products, variants, prices, categories and collections over the `catalog` SQL
-* module.
+* Products, variants, prices, categories, collections, sales channels,
+* translations and product media over the `catalog` SQL module.
 */
 function createCatalog(options) {
 	applyTemporal(options);
@@ -219,51 +273,94 @@ function createCatalog(options) {
 		publishStorefront: (organizationId, published) => call("publish_storefront", {
 			tenant: organizationId,
 			published
-		}, (value) => value === true)
+		}, (value) => value === true),
+		saveChannel: (organizationId, input) => call("save_catalog_channel", {
+			tenant: organizationId,
+			channel: input.id ?? null,
+			key: input.key,
+			name: input.name,
+			currency: input.currency ?? null,
+			price_list: input.priceListId ?? null,
+			active: input.active ?? null
+		}, (value) => {
+			const row = recordOf(value, "save_catalog_channel");
+			return {
+				id: textOf(row["id"]),
+				key: textOf(row["key"]),
+				active: row["active"] === true
+			};
+		}),
+		deleteChannel: (channelId) => call("delete_catalog_channel", { channel: channelId }, (value) => value === true),
+		listOnChannel: (channelId, productIds) => call("set_channel_listing", {
+			channel: channelId,
+			products: productIds,
+			listed: true
+		}, countOf),
+		unlistFromChannel: (channelId, productIds) => call("set_channel_listing", {
+			channel: channelId,
+			products: productIds,
+			listed: false
+		}, countOf),
+		channelProducts: (channelId, listOptions = {}) => {
+			const { limit, cursor } = pageOf(listOptions);
+			return call("channel_products", {
+				channel: channelId,
+				locale: listOptions.locale ?? null,
+				page_size: limit ?? null,
+				after: cursor ?? null
+			}, (value) => recordsOf(value, "channel_products").map(channelProductOf));
+		},
+		channelPrice: (channelId, variantId, priceOptions = {}) => call("channel_price", {
+			channel: channelId,
+			variant: variantId,
+			as_of: instantArg(priceOptions.at) ?? null
+		}, priceOf),
+		setProductTranslation: (productId, locale, translation) => call("set_product_translation", {
+			product: productId,
+			locale,
+			title: translation.title ?? null,
+			description: translation.description ?? null
+		}, (value) => value === true),
+		setVariantTranslation: (variantId, locale, title) => call("set_variant_translation", {
+			variant: variantId,
+			locale,
+			title
+		}, (value) => value === true),
+		productText: (productId, textOptions = {}) => call("product_text", {
+			product: productId,
+			locale: textOptions.locale ?? null
+		}, localizedOf),
+		addProductMedia: (productId, attachmentId, input = {}) => call("add_product_media", {
+			product: productId,
+			attachment: attachmentId,
+			variant: input.variantId ?? null,
+			alt: input.alt ?? null
+		}, (value) => {
+			const row = recordOf(value, "add_product_media");
+			return {
+				id: textOf(row["id"]),
+				position: Number(row["position"])
+			};
+		}),
+		updateProductMedia: (mediaId, input) => call("update_product_media", {
+			media: mediaId,
+			variant: input.variantId ?? null,
+			alt: input.alt ?? null
+		}, (value) => value === true),
+		reorderProductMedia: (productId, mediaIds) => call("reorder_product_media", {
+			product: productId,
+			media: mediaIds
+		}, (value) => value === true),
+		removeProductMedia: (mediaId) => call("remove_product_media", { media: mediaId }, (value) => value === true),
+		productMedia: (productId, mediaOptions = {}) => call("product_media", {
+			product: productId,
+			locale: mediaOptions.locale ?? null
+		}, (value) => recordsOf(value, "product_media").map(mediaOf))
 	}, options.hooks, {
 		block: "catalog",
 		...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`. */
@@ -280,6 +377,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({
@@ -289,7 +417,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,113 @@
+/// <reference lib="esnext.temporal" />
+import { T as ErrorMapper, t as AsyncResult } from "../../result-DZeA5KS6.js";
+import { $ as RecordRef } from "../../types-DFdg_4yN.js";
+import { Ct as Events } from "../../events-vcqenSYU.js";
+import { m as ChannelEventData } from "../../index-CG9rA8H8.js";
+import { n as Logger } from "../../logger-DWVYUmwi.js";
+import { a as BlockTenantOptions, r as BlockTemporalOptions } from "../../block-helpers-CRpAHrp_.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-DZN2w69m.js";
+import { Sn as EntitySchema, c as BlockOf } from "../../define-block-BVcLQ3DF.js";
+//#region src/blocks/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: RecordRef | 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?: RecordRef;
+  /** 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, with `browse` every channel they can see, or
+   * with `on` the channels linked to that record that the caller can see.
+   */
+  list(options?: {
+    readonly browse?: boolean;
+    readonly includeArchived?: boolean;
+    readonly on?: RecordRef;
+  }): AsyncResult<Channel[]>;
+  get(channelId: string): AsyncResult<Channel | undefined>;
+  /** A channel by name in the tenant. */
+  find(name: string): AsyncResult<Channel | undefined>;
+}
+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 };