better-supabase 0.12.0 → 0.14.0

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

@@ -1,7 +1,7 @@
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DezJPPA0.js";
-import { n as Embedder } from "../../knowledge-B5zdpDD-.js";
-import { a as MemoryHooks, c as MemoryOptions, d as MemoryView, f as RecalledMessage, i as MemoryHit, l as MemoryRecord, n as MemoryCommand, o as MemoryKind, r as MemoryDocument, s as MemoryNamespace, t as Memory, u as MemoryScope } from "../../types-D_2rClz-.js";
-import { s as BlockOf } from "../../define-block-BHxLHLys.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
+import { n as Embedder } from "../../knowledge-CFkCRxO9.js";
+import { a as MemoryHooks, c as MemoryOptions, d as MemoryView, f as RecalledMessage, i as MemoryHit, l as MemoryRecord, n as MemoryCommand, o as MemoryKind, r as MemoryDocument, s as MemoryNamespace, t as Memory, u as MemoryScope } from "../../types-QHeku_6b.js";
+import { c as BlockOf } from "../../define-block-COpcS6aT.js";
 //#region src/blocks/memory/memory.d.ts
 /** Core memory files, archival facts and recall over earlier chats. */
 export declare function createMemory(options: MemoryOptions): Memory;

package/dist/blocks/memory/index.js

@@ -1,13 +1,12 @@
-import { n as dbError } from "../../errors-BV1SKTVs.js";
-import { a as ok, r as err, t as AsyncResult } from "../../result-DIeYscA3.js";
-import { t as vectorLiteral } from "../../search-BtoWY6n_.js";
+import { n as dbError } from "../../errors-03ysrOt4.js";
+import { a as ok, r as err, t as AsyncResult } from "../../result-B3m7xtRY.js";
+import { t as vectorLiteral } from "../../search-Cn_DGluL.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
 import { t as memorySqlOptions } from "../../options-Bf96aVk5.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, b as oneOf, h as instantOf, j as run, k as recordsOf, n as applyTemporal, o as blockCall, p as injectableOf } from "../../block-helpers-DkVZNDrj.js";
-import { r as withBlockHooks } from "../../block-hooks-C22vuIUd.js";
-import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
-import { t as checkVectors } from "../../knowledge-BbdXOJvY.js";
+import { B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, U as sqlTransport, b as oneOf, h as instantOf, j as run, k as recordsOf, n as applyTemporal, o as blockCall, p as injectableOf } from "../../block-helpers-CiKtrb6g.js";
+import { r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
+import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { t as checkVectors } from "../../knowledge-BKGrXdS_.js";
 //#region src/blocks/memory/rows.ts
 const SCOPES = [
 	"user",

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

@@ -0,0 +1,86 @@
+import { dt as SubjectRef } from "../../executor-CPyrQdjh.js";
+import { Ct as Events } from "../../events-DbLjvxDX.js";
+import { o as ConversationEventData, v as MessageEventData } from "../../block-events-records-BGVyoz57.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 { D as MessagingSqlOptions } from "../../authorization-BuT26_sR.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 { _ as NotifyLevel, a as FollowTarget, b as UnreadCount, c as MessageEdit, d as MessageKind, f as MessageListOptions, g as NewMessage, h as MessagingOptions, i as ConversationSummary, l as MessageEdition, m as Messaging, n as ConversationAccess, o as Message, p as MessageReaction, r as ConversationKind, s as MessageCursor, t as Conversation, u as MessageFile, v as OpenConversation, x as createMessaging, y as RecordMention } from "../../messaging-CZ6aWb10.js";
+import { a as ThreadSummary, i as ThreadSummarizer, n as SummaryMessage, o as ThreadSummaryInput, r as SummaryTarget, s as ThreadSummaryOutput, t as SummarizeOptions } from "../../summaries-8jQTELIX.js";
+import { c as BlockOf, rn as EntitySchema } from "../../define-block-COpcS6aT.js";
+import { a as MessageDraft, c as MessagesControllerOptions, d as createMessagesController, i as ConversationsSnapshot, l as MessagesSnapshot, n as ConversationsController, o as MessagesActions, r as ConversationsControllerOptions, s as MessagesController, t as ConversationsActions, u as createConversationsController } from "../../client-RoAuPQNB.js";
+//#region src/blocks/messaging/mentions.d.ts
+type MentionScope = "channel" | "here";
+interface ParsedMentions {
+  /** Mentioned user ids, lowercase, in order and without repeats. */
+  readonly users: readonly string[];
+  /** Mentioned records, in order and without repeats. */
+  readonly records: readonly SubjectRef[];
+  /** `channel` wins over `here` when the body has both, as in SQL. */
+  readonly scope: MentionScope | undefined;
+}
+/** One piece of a body, for rendering mentions as chips. */
+type MentionSegment = {
+  readonly kind: "text";
+  readonly text: string;
+} | {
+  readonly kind: "user";
+  readonly name: string;
+  readonly userId: string;
+} | {
+  readonly kind: "record";
+  readonly name: string;
+  readonly subject: SubjectRef;
+} | {
+  readonly kind: "scope";
+  readonly scope: MentionScope;
+};
+/**
+ * Splits a body into text and mentions, in order. Adjacent text stays one
+ * segment.
+ *
+ * ```tsx
+ * mentionSegments(message.body).map((part) =>
+ *   part.kind === "record" ? <RecordChip subject={part.subject} /> : ...
+ * );
+ * ```
+ */
+export declare function mentionSegments(body: string): readonly MentionSegment[];
+/** The users, records and scope a body mentions. */
+export declare function parseMentions(body: string): ParsedMentions;
+/** `@[Name](user:<id>)`: the markup that mentions a user. */
+export declare function userMention(name: string, userId: string): string;
+/** `@[Name](subject:<type>/<id>)`: the markup that mentions a record. */
+export declare function recordMention(name: string, subject: SubjectRef): string;
+//#endregion
+//#region src/blocks/messaging/events.d.ts
+/** The events of the `messaging` block: type to data. */
+type MessagingEvents = {
+  readonly "conversation.created": ConversationEventData;
+  readonly "conversation.archived": ConversationEventData;
+  readonly "conversation.member_added": ConversationEventData;
+  readonly "conversation.member_removed": ConversationEventData;
+  readonly "message.sent": MessageEventData;
+  readonly "message.edited": MessageEventData;
+  readonly "message.deleted": MessageEventData;
+  readonly "message.pinned": MessageEventData;
+  readonly "message.resolved": MessageEventData;
+};
+/** The `messaging` block's event types, for its manifest and `onBlockEvent`. */
+export declare const messagingEvents: Events<MessagingEvents>;
+//#endregion
+//#region src/blocks/messaging/manifest.d.ts
+/** The `messaging` block's manifest (ADR 0029, ADR 0062). */
+export declare const messagingBlock: BlockOf<"messaging", typeof createMessaging, MessagingEvents>;
+//#endregion
+//#region src/blocks/messaging/schemas.d.ts
+/**
+ * What `send` takes after the conversation. The body's length limit is
+ * `options.maxBodyLength`, so the SQL checks it; a message with files may have
+ * an empty body.
+ */
+export declare const messageInputSchema: EntitySchema<NewMessage>;
+/** What `edit` takes. */
+export declare const messageChangeSchema: EntitySchema<MessageEdition>;
+//#endregion
+export { type AnchorRegion, type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type Conversation, type ConversationAccess, type ConversationKind, type ConversationSummary, type ConversationsActions, type ConversationsController, type ConversationsControllerOptions, type ConversationsSnapshot, type FileAnchor, type FileAnchorAt, type FollowTarget, type MentionScope, type MentionSegment, type Message, type MessageCursor, type MessageDraft, type MessageEdit, type MessageEdition, type MessageFile, type MessageKind, type MessageListOptions, type MessageReaction, type MessagesActions, type MessagesController, type MessagesControllerOptions, type MessagesSnapshot, type Messaging, type MessagingEvents, type MessagingOptions, type MessagingSqlOptions, type NewMessage, type NotifyLevel, type OpenConversation, type ParsedMentions, type RecordMention, type RpcClient, type SummarizeOptions, type SummaryMessage, type SummaryTarget, type ThreadSummarizer, type ThreadSummary, type ThreadSummaryInput, type ThreadSummaryOutput, type UnreadCount, conversationTopic, createConversationsController, createMessagesController, createMessaging, dbTransport, extendBlock, fileAnchor, isFileAnchor, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/messaging/index.js

@@ -0,0 +1,48 @@
+import { t as messagingSqlOptions } from "../../options-2EMA_x6_.js";
+import { B as dbTransport, H as rpcTransport, U as sqlTransport } 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 { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { t as conversationTopic } from "../../rows-Bb0EPupt.js";
+import { t as createMessaging } from "../../messaging-BC-P-yAv.js";
+import { i as userMention, n as parseMentions, r as recordMention, t as mentionSegments } from "../../mentions-ByYnRNIG.js";
+import { n as createMessagesController, t as createConversationsController } from "../../client-WzuQExHk.js";
+import { i as isFileAnchor, n as messageInputSchema, r as fileAnchor, t as messageChangeSchema } from "../../schemas-9Ci3K0Hk.js";
+//#region src/blocks/messaging/events.ts
+/** The `messaging` block's event types, for its manifest and `onBlockEvent`. */
+const messagingEvents = defineEvents({
+	"conversation.created": event(),
+	"conversation.archived": event(),
+	"conversation.member_added": event(),
+	"conversation.member_removed": event(),
+	"message.sent": event(),
+	"message.edited": event(),
+	"message.deleted": event(),
+	"message.pinned": event(),
+	"message.resolved": event()
+});
+//#endregion
+//#region src/blocks/messaging/manifest.ts
+/** The `messaging` block's manifest (ADR 0029, ADR 0062). */
+const messagingBlock = defineBlock({
+	name: "messaging",
+	sql: ["messaging"],
+	options: { messaging: messagingSqlOptions },
+	events: messagingEvents,
+	schemas: { message: {
+		input: messageInputSchema,
+		change: messageChangeSchema
+	} },
+	create: createMessaging,
+	client: "messaging",
+	category: "collaboration",
+	recipes: [
+		"channel-sidebar",
+		"message-composer",
+		"message-list",
+		"presence-avatars",
+		"thread-panel"
+	]
+});
+//#endregion
+export { conversationTopic, createConversationsController, createMessagesController, createMessaging, dbTransport, extendBlock, fileAnchor, isFileAnchor, mentionSegments, messageChangeSchema, messageInputSchema, messagingBlock, messagingEvents, parseMentions, recordMention, rpcTransport, sqlTransport, userMention, withBlockHooks, wrapTransport };

package/dist/blocks/messaging/react/index.d.ts

@@ -0,0 +1,39 @@
+import { r as ConversationKind } from "../../../messaging-CZ6aWb10.js";
+import { a as MessageDraft, i as ConversationsSnapshot, l as MessagesSnapshot, o as MessagesActions, t as ConversationsActions } from "../../../client-RoAuPQNB.js";
+//#region src/blocks/messaging/react/index.d.ts
+export interface UseMessagesOptions {
+  /** The conversation or channel to show; the view waits without one. */
+  readonly conversationId: string | null | undefined;
+  /** A thread's root message, to show its replies instead. */
+  readonly threadId?: string | null;
+  /** Messages per page, default 50. */
+  readonly limit?: number;
+  /** Moves the read marker as messages arrive; default true. */
+  readonly markRead?: boolean;
+}
+export interface MessagesState extends MessagesSnapshot, MessagesActions {}
+/**
+ * One conversation or thread through the browser client: the latest page, kept
+ * current from Realtime, who is typing, and the read marker. It acts in the
+ * client's tenant with the schema and topic in the client's `blocks` config.
+ * The same hook runs in React DOM and React Native.
+ *
+ * ```tsx
+ * const { messages, send, setTyping } = useMessages({ conversationId });
+ * ```
+ */
+export declare function useMessages(options: UseMessagesOptions): MessagesState;
+export interface UseConversationsOptions {
+  /** Only these kinds, such as `["channel"]`. */
+  readonly kinds?: readonly ConversationKind[];
+  readonly limit?: number;
+}
+export interface ConversationsState extends ConversationsSnapshot, ConversationsActions {}
+/**
+ * The caller's conversations with unread and mention counts, loaded again when
+ * a message arrives in one of them: a channel sidebar or a direct message
+ * list.
+ */
+export declare function useConversations(options?: UseConversationsOptions): ConversationsState;
+//#endregion
+export type { MessageDraft };

package/dist/blocks/messaging/react/index.js

@@ -0,0 +1,80 @@
+"use client";
+import { t as useController } from "../../../react-controller-CKSdtJ10.js";
+import { n as useBlockTenant, t as useBlockEnv } from "../../../react-env-CfA3EdBH.js";
+import { n as envBlockSettings, t as envBlockOptions } from "../../../block-env-options-2e6IQrSw.js";
+import { t as createMessaging } from "../../../messaging-BC-P-yAv.js";
+import { n as createMessagesController, t as createConversationsController } from "../../../client-WzuQExHk.js";
+//#region src/blocks/messaging/react/index.ts
+/** `blocks.messaging.options.topic` from the client's config. */
+function topicOf(env) {
+	const topic = envBlockSettings(env, "messaging")["topic"];
+	return typeof topic === "string" ? topic : "messages";
+}
+/**
+* One conversation or thread through the browser client: the latest page, kept
+* current from Realtime, who is typing, and the read marker. It acts in the
+* client's tenant with the schema and topic in the client's `blocks` config.
+* The same hook runs in React DOM and React Native.
+*
+* ```tsx
+* const { messages, send, setTyping } = useMessages({ conversationId });
+* ```
+*/
+function useMessages(options) {
+	const env = useBlockEnv();
+	const tenant = useBlockTenant(env);
+	const { conversationId, threadId, limit, markRead } = options;
+	return useController(() => createMessagesController({
+		client: createMessaging({
+			...envBlockOptions(env, "messaging"),
+			...tenant === void 0 ? {} : { tenant }
+		}),
+		auth: env.auth,
+		ports: env.ports,
+		conversationId: tenant === void 0 || conversationId === void 0 ? null : conversationId,
+		topic: topicOf(env),
+		...threadId === void 0 ? {} : { threadId },
+		...limit === void 0 ? {} : { limit },
+		...markRead === void 0 ? {} : { markRead }
+	}), [
+		env,
+		tenant,
+		conversationId,
+		threadId,
+		limit,
+		markRead
+	]).view;
+}
+/**
+* The caller's conversations with unread and mention counts, loaded again when
+* a message arrives in one of them: a channel sidebar or a direct message
+* list.
+*/
+function useConversations(options = {}) {
+	const env = useBlockEnv();
+	const tenant = useBlockTenant(env);
+	const { limit } = options;
+	const kinds = options.kinds?.join(",");
+	return useController(() => {
+		const kindList = kinds?.split(",");
+		return createConversationsController({
+			client: createMessaging({
+				...envBlockOptions(env, "messaging"),
+				...tenant === void 0 ? {} : { tenant }
+			}),
+			auth: env.auth,
+			ports: env.ports,
+			enabled: tenant !== void 0,
+			topic: topicOf(env),
+			...kindList === void 0 ? {} : { kinds: kindList },
+			...limit === void 0 ? {} : { limit }
+		});
+	}, [
+		env,
+		tenant,
+		kinds,
+		limit
+	]).view;
+}
+//#endregion
+export { useConversations, useMessages };

package/dist/blocks/messaging/react/server.d.ts

@@ -0,0 +1,12 @@
+import { a as MessageDraft } from "../../../client-RoAuPQNB.js";
+import { ConversationsState, MessagesState, UseConversationsOptions, UseMessagesOptions } from "./index.js";
+//#region src/blocks/messaging/react/server.d.ts
+/** The `react-server` build of `useMessages`: call `messaging.list()` instead. */
+export declare const useMessages: (options: UseMessagesOptions) => MessagesState;
+/**
+ * The `react-server` build of `useConversations`: call
+ * `messaging.conversations()` instead.
+ */
+export declare const useConversations: (options?: UseConversationsOptions) => ConversationsState;
+//#endregion
+export type { ConversationsState, MessageDraft, MessagesState, UseConversationsOptions, UseMessagesOptions };

package/dist/blocks/messaging/react/server.js

@@ -0,0 +1,14 @@
+//#region src/blocks/messaging/react/server.ts
+/** The `react-server` build of `useMessages`: call `messaging.list()` instead. */
+const useMessages = () => {
+	throw new Error("better-supabase: useMessages() runs in Client Components only. In Server Components call `messaging.list()` instead.");
+};
+/**
+* The `react-server` build of `useConversations`: call
+* `messaging.conversations()` instead.
+*/
+const useConversations = () => {
+	throw new Error("better-supabase: useConversations() runs in Client Components only. In Server Components call `messaging.conversations()` instead.");
+};
+//#endregion
+export { useConversations, useMessages };

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

@@ -0,0 +1,20 @@
+import { t as BlockOptions } from "../../../block-env-kFcaaJLM.js";
+import { t as SolidController } from "../../../solid-bind-C1jeq4Qm.js";
+import { c as MessagesControllerOptions, i as ConversationsSnapshot, l as MessagesSnapshot, o as MessagesActions, r as ConversationsControllerOptions, t as ConversationsActions } from "../../../client-RoAuPQNB.js";
+//#region src/blocks/messaging/solid/index.d.ts
+/**
+ * `createMessagesController` as a Solid primitive: `state()` reads the
+ * snapshot. Call it in a component; the work starts on mount and the controller
+ * is disposed with the owner. `auth` and `ports` default to the client of
+ * `<BetterSupabaseProvider client={bs}>`.
+ */
+export declare function useMessages(options: BlockOptions<MessagesControllerOptions>): SolidController<MessagesSnapshot, MessagesActions>;
+/**
+ * `createConversationsController` as a Solid primitive: `state()` reads the
+ * snapshot. Call it in a component; the work starts on mount and the controller
+ * is disposed with the owner. `auth` and `ports` default to the client of
+ * `<BetterSupabaseProvider client={bs}>`.
+ */
+export declare function useConversations(options: BlockOptions<ConversationsControllerOptions>): SolidController<ConversationsSnapshot, ConversationsActions>;
+//#endregion
+export type { BlockOptions, ConversationsActions, ConversationsControllerOptions, ConversationsSnapshot, MessagesActions, MessagesControllerOptions, MessagesSnapshot, SolidController };

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

@@ -0,0 +1,23 @@
+import { t as useBlockController } from "../../../solid-controller-DGuv7V8a.js";
+import { n as createMessagesController, t as createConversationsController } from "../../../client-WzuQExHk.js";
+//#region src/blocks/messaging/solid/index.ts
+/**
+* `createMessagesController` as a Solid primitive: `state()` reads the
+* snapshot. Call it in a component; the work starts on mount and the controller
+* is disposed with the owner. `auth` and `ports` default to the client of
+* `<BetterSupabaseProvider client={bs}>`.
+*/
+function useMessages(options) {
+	return useBlockController(createMessagesController, options);
+}
+/**
+* `createConversationsController` as a Solid primitive: `state()` reads the
+* snapshot. Call it in a component; the work starts on mount and the controller
+* is disposed with the owner. `auth` and `ports` default to the client of
+* `<BetterSupabaseProvider client={bs}>`.
+*/
+function useConversations(options) {
+	return useBlockController(createConversationsController, options);
+}
+//#endregion
+export { useConversations, useMessages };

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

@@ -0,0 +1,20 @@
+import { t as BlockOptions } from "../../../block-env-kFcaaJLM.js";
+import { t as SvelteController } from "../../../svelte-bind-Ja6CtQGp.js";
+import { c as MessagesControllerOptions, i as ConversationsSnapshot, l as MessagesSnapshot, o as MessagesActions, r as ConversationsControllerOptions, t as ConversationsActions } from "../../../client-RoAuPQNB.js";
+//#region src/blocks/messaging/svelte/index.d.ts
+/**
+ * `createMessagesController` as a Svelte readable store of the snapshot, with
+ * the actions on `.actions`. Call it in a component's script; the work starts
+ * on mount and the controller is disposed with the component. `auth` and
+ * `ports` default to the client of `setBetterSupabase(bs)`.
+ */
+export declare function useMessages(options: BlockOptions<MessagesControllerOptions>): SvelteController<MessagesSnapshot, MessagesActions>;
+/**
+ * `createConversationsController` as a Svelte readable store of the snapshot,
+ * with the actions on `.actions`. Call it in a component's script; the work
+ * starts on mount and the controller is disposed with the component. `auth` and
+ * `ports` default to the client of `setBetterSupabase(bs)`.
+ */
+export declare function useConversations(options: BlockOptions<ConversationsControllerOptions>): SvelteController<ConversationsSnapshot, ConversationsActions>;
+//#endregion
+export type { BlockOptions, ConversationsActions, ConversationsControllerOptions, ConversationsSnapshot, MessagesActions, MessagesControllerOptions, MessagesSnapshot, SvelteController };

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

@@ -0,0 +1,23 @@
+import { t as useBlockController } from "../../../svelte-controller-oFKC9AYu.js";
+import { n as createMessagesController, t as createConversationsController } from "../../../client-WzuQExHk.js";
+//#region src/blocks/messaging/svelte/index.ts
+/**
+* `createMessagesController` as a Svelte readable store of the snapshot, with
+* the actions on `.actions`. Call it in a component's script; the work starts
+* on mount and the controller is disposed with the component. `auth` and
+* `ports` default to the client of `setBetterSupabase(bs)`.
+*/
+function useMessages(options) {
+	return useBlockController(createMessagesController, options);
+}
+/**
+* `createConversationsController` as a Svelte readable store of the snapshot,
+* with the actions on `.actions`. Call it in a component's script; the work
+* starts on mount and the controller is disposed with the component. `auth` and
+* `ports` default to the client of `setBetterSupabase(bs)`.
+*/
+function useConversations(options) {
+	return useBlockController(createConversationsController, options);
+}
+//#endregion
+export { useConversations, useMessages };

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

@@ -0,0 +1,20 @@
+import { t as BlockOptions } from "../../../block-env-kFcaaJLM.js";
+import { t as VueController } from "../../../vue-bind-TPkbLl4z.js";
+import { c as MessagesControllerOptions, i as ConversationsSnapshot, l as MessagesSnapshot, o as MessagesActions, r as ConversationsControllerOptions, t as ConversationsActions } from "../../../client-RoAuPQNB.js";
+//#region src/blocks/messaging/vue/index.d.ts
+/**
+ * `createMessagesController` as a Vue composable: `state` is a shallow ref of
+ * the snapshot. Call it in `setup` or an effect scope; the work starts on mount
+ * and the controller is disposed with the scope. `auth` and `ports` default to
+ * the client of `app.use(betterSupabase(bs))`.
+ */
+export declare function useMessages(options: BlockOptions<MessagesControllerOptions>): VueController<MessagesSnapshot, MessagesActions>;
+/**
+ * `createConversationsController` as a Vue composable: `state` is a shallow ref
+ * of the snapshot. Call it in `setup` or an effect scope; the work starts on
+ * mount and the controller is disposed with the scope. `auth` and `ports`
+ * default to the client of `app.use(betterSupabase(bs))`.
+ */
+export declare function useConversations(options: BlockOptions<ConversationsControllerOptions>): VueController<ConversationsSnapshot, ConversationsActions>;
+//#endregion
+export type { BlockOptions, ConversationsActions, ConversationsControllerOptions, ConversationsSnapshot, MessagesActions, MessagesControllerOptions, MessagesSnapshot, VueController };

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

@@ -0,0 +1,23 @@
+import { t as useBlockController } from "../../../vue-controller-WtbuT-Ux.js";
+import { n as createMessagesController, t as createConversationsController } from "../../../client-WzuQExHk.js";
+//#region src/blocks/messaging/vue/index.ts
+/**
+* `createMessagesController` as a Vue composable: `state` is a shallow ref of
+* the snapshot. Call it in `setup` or an effect scope; the work starts on mount
+* and the controller is disposed with the scope. `auth` and `ports` default to
+* the client of `app.use(betterSupabase(bs))`.
+*/
+function useMessages(options) {
+	return useBlockController(createMessagesController, options);
+}
+/**
+* `createConversationsController` as a Vue composable: `state` is a shallow ref
+* of the snapshot. Call it in `setup` or an effect scope; the work starts on
+* mount and the controller is disposed with the scope. `auth` and `ports`
+* default to the client of `app.use(betterSupabase(bs))`.
+*/
+function useConversations(options) {
+	return useBlockController(createConversationsController, options);
+}
+//#endregion
+export { useConversations, useMessages };

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

@@ -1,39 +1,39 @@
 /// <reference lib="esnext.temporal" />
-import { t as AsyncResult } from "../../result-BREt7qOh.js";
+import { t as AsyncResult } from "../../result-C6jDfedy.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DezJPPA0.js";
-import { n as BlockOptions } from "../../block-helpers-CjcQM1yA.js";
-import { n as BlockHooks } from "../../block-hooks-DcPJHztl.js";
-import { g as JobHandler } from "../../types-BEEFkNFY.js";
-import { i as EventSink, t as CloudEvent } from "../../cloud-event-DXkNoI6v.js";
-import { s as BlockOf } from "../../define-block-BHxLHLys.js";
-import { a as MetricWhereValue, c as metricsOf, i as MetricMeasure, n as MetricDefinition, o as checkMetric, r as MetricGrain, s as defineMetric, t as METRIC_GRAINS } from "../../metric-definition-95HFoW1V.js";
+import { n as BlockOptions } 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 { g as JobHandler } from "../../types-CGUDoF5I.js";
+import { i as EventSink, t as CloudEvent } from "../../cloud-event-SPyXMdcd.js";
+import { c as BlockOf } from "../../define-block-COpcS6aT.js";
+import { a as MetricWhereValue, c as metricsOf, i as MetricMeasure, n as MetricDefinition, o as checkMetric, r as MetricGrain, s as defineMetric, t as METRIC_GRAINS } from "../../metric-definition-EAYI1r2n.js";
 //#region src/blocks/metrics/sink.d.ts
 interface MetricsSinkOptions {
   /**
-   * Event type (without `typePrefix`) to the metrics whose rows the event
-   * adds, such as `{ "order.placed": ["orders", "revenue"] }`.
+   * Event type (without `typePrefix`) to the metrics whose rows the event adds,
+   * such as `{ "order.placed": ["orders", "revenue"] }`.
    */
   readonly on: Readonly<Record<string, string | readonly string[] | undefined>>;
   /** Stripped from each event type. Defaults to `dev.better-supabase`. */
   readonly typePrefix?: string;
   /**
    * When the event's rows sit in time, for events about rows bucketed by
-   * another time than when the event happened, such as time logged for a
-   * past day (`timeEntryMetricTime`). Several times re-aggregate each of
-   * their buckets, for an event that moves a row from one day to another.
-   * Default: the event's `time`.
+   * another time than when the event happened, such as time logged for a past
+   * day (`timeEntryMetricTime`). Several times re-aggregate each of their
+   * buckets, for an event that moves a row from one day to another. Default:
+   * the event's `time`.
    */
   readonly time?: (event: CloudEvent) => string | readonly string[] | undefined;
 }
 /**
- * An outbox sink that re-aggregates the buckets an event's rows fall in,
- * so charts catch up without waiting for the periodic rollup:
- * `outbox.relay('metrics', metricsSink(metrics, { on }))`. It reads the
- * event's `time` (or `options.time`, now when neither has one) and runs one
- * rollup per metric for each UTC day the batch's times fall on, so a row
- * moved to another day fixes both days without re-aggregating the days
- * between. Build `metrics` with a service transport.
+ * An outbox sink that re-aggregates the buckets an event's rows fall in, so
+ * charts catch up without waiting for the periodic rollup:
+ * `outbox.relay('metrics', metricsSink(metrics, { on }))`. It reads the event's
+ * `time` (or `options.time`, now when neither has one) and runs one rollup per
+ * metric for each UTC day the batch's times fall on, so a row moved to another
+ * day fixes both days without re-aggregating the days between. Build `metrics`
+ * with a service transport.
  */
 export declare function metricsSink(metrics: Pick<Metrics, "rollup">, options: MetricsSinkOptions): EventSink;
 //#endregion
@@ -48,8 +48,8 @@ type MetricDimension<M extends readonly MetricDefinition[], K extends string> =
 }> extends MetricDefinition<string, infer D> ? D : never;
 interface MetricsOptions<M extends readonly MetricDefinition[]> extends Pick<BlockOptions, "transport" | "service" | "schema" | "mappers"> {
   /**
-   * The same `defineMetric` definitions as `blocks.metrics.options.metrics`,
-   * so `series` and `kpi` type the keys and dimensions.
+   * The same `defineMetric` definitions as `blocks.metrics.options.metrics`, so
+   * `series` and `kpi` type the keys and dimensions.
    */
   readonly metrics?: M;
   /** `withBlockHooks` hooks around the methods. */
@@ -127,7 +127,10 @@ interface MetricsRollupRequest {
   readonly until?: Temporal.Instant;
 }
 interface Metrics<M extends readonly MetricDefinition[] = readonly MetricDefinition[]> {
-  /** One point per bucket of `range`, gaps filled. Checked against the metric's permission. */
+  /**
+   * One point per bucket of `range`, gaps filled. Checked against the metric's
+   * permission.
+   */
   series<K extends MetricKey<M>>(metric: K, range: MetricRange, options: MetricSeriesOptions<MetricDimension<M, K>>): AsyncResult<MetricSeries>;
   /** The total over `range`, for a stat card. */
   kpi<K extends MetricKey<M>>(metric: K, range: MetricRange, options: MetricReadOptions<MetricDimension<M, K>>): AsyncResult<Kpi>;
@@ -137,7 +140,10 @@ interface Metrics<M extends readonly MetricDefinition[] = readonly MetricDefinit
    * Service only. Resolves to the number of points written.
    */
   rollup(request?: MetricsRollupRequest): AsyncResult<number>;
-  /** The handler for `metrics.rollup` jobs, whose payload is a `MetricsRollupRequest` as JSON. */
+  /**
+   * The handler for `metrics.rollup` jobs, whose payload is a
+   * `MetricsRollupRequest` as JSON.
+   */
   readonly job: JobHandler<unknown>;
 }
 /** The range of the same length that ends where `range` starts. */
@@ -145,8 +151,8 @@ export declare function previousRange(range: MetricRange): MetricRange;
 /** How `value` moved from `previous`. */
 export declare function compareValues(value: number | null, previous: number | null): Pick<Kpi, "change" | "trend">;
 /**
- * The `metrics` SQL module as typed calls: `series` and `kpi` for charts
- * and stat cards as the caller, and `rollup` with a service transport.
+ * The `metrics` SQL module as typed calls: `series` and `kpi` for charts and
+ * stat cards as the caller, and `rollup` with a service transport.
  */
 export declare function createMetrics<const M extends readonly MetricDefinition[] = readonly MetricDefinition[]>(options: MetricsOptions<M>): Metrics<M>;
 //#endregion
@@ -161,9 +167,9 @@ interface MetricChartOptions {
   readonly format?: (bucket: Temporal.Instant) => string;
 }
 /**
- * Rows in the shape Recharts (and chart components built on it) read:
- * `{ date, value, previous?, ...groups }`, one per bucket. `previous` is
- * the bucket at the same position of the compared range.
+ * Rows in the shape Recharts (and chart components built on it) read: `{ date,
+ * value, previous?, ...groups }`, one per bucket. `previous` is the bucket at
+ * the same position of the compared range.
  */
 export declare function toChartData(series: MetricSeries, options?: MetricChartOptions): readonly MetricChartRow[];
 //#endregion