better-supabase 0.12.0 → 0.13.0

package/dist/client-DVRFa59w.d.ts

@@ -0,0 +1,309 @@
+import { D as ValidationIssue, T as ErrorMapper, t as AsyncResult } from "./result-mijqfoJN.js";
+import { t as StandardSchemaV1 } from "./standard-16AIDny5.js";
+import { i as RowFields, r as FieldsOf } from "./block-fields-DnXkMney.js";
+import { n as Logger } from "./logger-DWVYUmwi.js";
+import { t as BlockTransport } from "./block-transport-DBPhgF3W.js";
+import { n as BlockHooks } from "./block-hooks-BadAniNI.js";
+import { p as ListQueryInput } from "./list-query-Dx5cAqG6.js";
+import { n as Controller } from "./controller-lWRcKqCl.js";
+import { t as RankNeighbors } from "./rank-result-DHflCNwo.js";
+//#region src/blocks/saved-views/saved-views.d.ts
+declare const SAVED_VIEW_KINDS: readonly ["table", "board", "calendar", "timeline", "gantt"];
+type SavedViewKind = (typeof SAVED_VIEW_KINDS)[number];
+declare const SAVED_VIEW_SCOPES: readonly ["user", "team", "tenant"];
+type SavedViewScope = (typeof SAVED_VIEW_SCOPES)[number];
+declare const SAVED_VIEW_DENSITIES: readonly ["compact", "default", "comfortable"];
+type SavedViewDensity = (typeof SAVED_VIEW_DENSITIES)[number];
+/** Column layout, in the shape of TanStack Table's column state. */
+interface SavedViewColumns {
+  readonly visible?: readonly string[];
+  readonly order?: readonly string[];
+  readonly sizes?: Readonly<Record<string, number>>;
+  readonly pinned?: {
+    readonly left?: readonly string[];
+    readonly right?: readonly string[];
+  };
+}
+/** What a view stores. `query` is the list's typed input, without the page. */
+interface SavedViewState<Q extends ListQueryInput<string, string> = ListQueryInput<string, string>> {
+  readonly query?: Omit<Q, "page" | "after">;
+  readonly columns?: SavedViewColumns;
+  readonly grouping?: readonly string[];
+  readonly density?: SavedViewDensity;
+  /**
+   * Settings of the layout, such as a board's group column or a calendar's date
+   * field.
+   */
+  readonly layout?: Readonly<Record<string, unknown>>;
+  /**
+   * Keeps the view to the records of a collection
+   * (`better-supabase/blocks/collections`): pass `collections.where(id)` as the
+   * list's `where`.
+   */
+  readonly collectionId?: string;
+}
+/** The part of a view's state that lives outside the URL. */
+type SavedViewDisplayState = Omit<SavedViewState, "query">;
+/** The caller's own flags for a view, which need no right to change it. */
+interface SavedViewPreference {
+  /** Opens this view first, ahead of every slot default. */
+  readonly isDefault: boolean;
+  readonly hidden: boolean;
+  readonly pinned: boolean;
+}
+interface SavedViewPreferenceInput {
+  readonly isDefault?: boolean;
+  readonly hidden?: boolean;
+  readonly pinned?: boolean;
+}
+interface DuplicateViewInput {
+  readonly name?: string;
+  /** Default `user`. `team` and `tenant` need `views.share`. */
+  readonly scope?: SavedViewScope;
+  /** The team, for `scope: "team"`. */
+  readonly teamId?: string;
+}
+/**
+ * The part of a `defineListQuery` definition a saved view checks its query
+ * against. Any list definition fits.
+ */
+interface SavedViewList {
+  parse(input: object | undefined): {
+    readonly ok: boolean;
+    readonly issues?: readonly ValidationIssue[] | undefined;
+  };
+  readonly jsonSchema: Readonly<Record<string, unknown>>;
+}
+interface SavedView<Q extends ListQueryInput<string, string> = ListQueryInput<string, string>, F extends object = Record<never, never>> {
+  readonly id: string;
+  readonly list: string;
+  readonly scope: SavedViewScope;
+  readonly ownerId: string | null;
+  readonly teamId: string | null;
+  readonly name: string;
+  readonly kind: SavedViewKind;
+  readonly state: SavedViewState<Q>;
+  readonly rank: string;
+  /** The default of its slot (the owner's, the team's or the tenant's). */
+  readonly isDefault: boolean;
+  /** The caller's own flags; all false without the preferences table. */
+  readonly preference: SavedViewPreference;
+  /** The app's extra columns (`options.extraColumns`), by column name. */
+  readonly fields: RowFields<F>;
+}
+/**
+ * What `save` and `duplicate` resolve to: the view's id, rank key and extra
+ * columns.
+ */
+interface SavedViewRef<F extends object = Record<never, never>> {
+  readonly id: string;
+  readonly rank: string;
+  /** The app's extra columns (`options.extraColumns`), by column name. */
+  readonly fields: RowFields<F>;
+}
+interface SaveViewInput<Q extends ListQueryInput<string, string> = ListQueryInput<string, string>, F extends object = Record<never, never>> {
+  readonly organizationId: string;
+  /** The list's key, such as `tasks`; also the key in `lists`. */
+  readonly list: string;
+  readonly name: string;
+  readonly state: SavedViewState<Q>;
+  /** Default `table`. */
+  readonly kind?: SavedViewKind;
+  /** Default `user`. `team` and `tenant` need `views.share`. */
+  readonly scope?: SavedViewScope;
+  /** The team, for `scope: "team"`. */
+  readonly teamId?: string;
+  /** Updates this view instead of adding one. */
+  readonly id?: string;
+  /**
+   * Values for the app's extra columns (`options.extraColumns`); left out keeps
+   * the stored ones.
+   */
+  readonly fields?: Partial<F> & Readonly<Record<string, unknown>>;
+}
+interface SavedViewsOptions<S extends StandardSchemaV1 | undefined = undefined> {
+  readonly transport: BlockTransport;
+  readonly schema?: string;
+  readonly mappers?: readonly ErrorMapper[];
+  /** List definitions by key; `save` checks a view's query against its list. */
+  readonly lists?: Readonly<Record<string, SavedViewList>>;
+  /**
+   * A Standard Schema for the extra columns of the saved views table
+   * (`blocks.saved-views.options.extraColumns`): writes are validated, reads
+   * parsed.
+   */
+  readonly fields?: S;
+  /** `withBlockHooks` hooks around the client's methods. */
+  readonly hooks?: NoInfer<BlockHooks<SavedViews<FieldsOf<S>>>>;
+  /** Receives the errors `after` hooks throw. Default: `console`. */
+  readonly logger?: Logger;
+}
+interface SavedViews<F extends object = Record<never, never>> {
+  /** Adds a view, or updates `input.id`. Resolves to its id and rank key. */
+  save(input: SaveViewInput<ListQueryInput<string, string>, F>): AsyncResult<SavedViewRef<F>>;
+  /** The views the caller sees for a list, in rank order. */
+  list(organizationId: string, list: string): AsyncResult<SavedView<ListQueryInput<string, string>, F>[]>;
+  /** Moves a view between its neighbours' rank keys. Resolves to its new key. */
+  reorder(id: string, neighbors: RankNeighbors): AsyncResult<string>;
+  /**
+   * Makes a view the default of its slot (the user's, the team's or the
+   * tenant's).
+   */
+  setDefault(id: string, on?: boolean): AsyncResult<boolean>;
+  /**
+   * Sets the caller's own flags on a view they see. Omitted flags keep their
+   * value; one preferred default per user and list.
+   */
+  setPreference(id: string, preference: SavedViewPreferenceInput): AsyncResult<SavedViewPreference>;
+  /**
+   * Copies a view the caller sees as a new view. Resolves to its id and rank
+   * key.
+   */
+  duplicate(id: string, input?: DuplicateViewInput): AsyncResult<SavedViewRef<F>>;
+  delete(id: string): AsyncResult<boolean>;
+}
+/**
+ * Checks a view's state, and its `query` against `list` when given. An empty
+ * list means the state is valid.
+ */
+declare function savedViewIssues(state: unknown, list?: SavedViewList): readonly ValidationIssue[];
+/** The JSON Schema of a view's state, with `query` from the list's schema. */
+declare function savedViewStateSchema(list?: SavedViewList): Readonly<Record<string, unknown>>;
+declare function createSavedViews<S extends StandardSchemaV1 | undefined = undefined>(options: SavedViewsOptions<S>): SavedViews<FieldsOf<S>>;
+/** The fields of a view `defaultView` reads; `SavedView` fits. */
+interface DefaultViewCandidate {
+  readonly scope: SavedViewScope;
+  readonly isDefault: boolean;
+  readonly preference?: Partial<Pick<SavedViewPreference, "isDefault" | "hidden">>;
+}
+/**
+ * The view that opens first: the caller's preferred default, then the user's
+ * slot default, a team default, the tenant's, then the first view. Views the
+ * caller hid are skipped.
+ */
+declare function defaultView<V extends DefaultViewCandidate>(views: readonly V[]): V | undefined;
+//#endregion
+//#region src/blocks/saved-views/query-state.d.ts
+/**
+ * The URL state of a list as nuqs returns it from
+ * `useQueryStates(list.nuqs(createParser))`: one key per parser, `null` when
+ * the parameter is absent.
+ */
+type ListUrlState = Readonly<Record<string, unknown>>;
+/** A list's URL state as the typed query a view stores, without the page. */
+declare function queryFromUrlState(state: ListUrlState): ListQueryInput<string, string>;
+/**
+ * The URL state that opens a view's query: every key in `keys` (the current
+ * state's), `null` unless the query sets it, so applying a view clears what the
+ * previous one set. The page goes back to the first.
+ */
+declare function urlStateFromQuery(query: ListQueryInput<string, string> | undefined, keys: readonly string[]): Record<string, unknown>;
+/** A view's state without `query`: the part `onApplyState` shows. */
+declare function displayStateOf(state: SavedViewState): SavedViewDisplayState;
+/** Whether two states show the same columns, grouping, density and layout. */
+declare function sameDisplayState(a: SavedViewState | undefined, b: SavedViewState | undefined): boolean;
+/** Whether two stored queries select the same rows in the same order. */
+declare function sameQuery(a: ListQueryInput<string, string> | undefined, b: ListQueryInput<string, string> | undefined): boolean;
+//#endregion
+//#region src/blocks/saved-views/client.d.ts
+/** The fields of a saved view the controller reads; `SavedView` fits. */
+interface SavedViewLike extends DefaultViewCandidate {
+  readonly id: string;
+  readonly name: string;
+  readonly state: SavedViewState;
+}
+interface SavedViewsSyncOptions<V extends SavedViewLike> {
+  /**
+   * Loads the list's views, e.g. a server action that calls
+   * `savedViews.list()`.
+   */
+  readonly load: () => Promise<readonly V[]>;
+  /**
+   * The state the UI shows outside the URL: columns, grouping, density and
+   * layout. `saveCurrent` stores it with the query, and `active` and `isDirty`
+   * compare it. Without it only the query counts.
+   */
+  readonly getState?: () => SavedViewDisplayState;
+  /**
+   * Shows a view's state outside the URL; `apply` calls it with everything but
+   * `query`.
+   */
+  readonly onApplyState?: (state: SavedViewDisplayState, view: V) => void;
+  /**
+   * Saves the current state, e.g. a server action that calls
+   * `savedViews.save()`.
+   */
+  readonly save?: (input: {
+    readonly name: string;
+    readonly query: ListQueryInput<string, string>;
+    /** The query and `getState()` together, as `savedViews.save()` takes it. */
+    readonly state: SavedViewState;
+    readonly id?: string;
+  }) => Promise<unknown>;
+  readonly remove?: (id: string) => Promise<unknown>;
+  /** Copies a view, e.g. a server action that calls `savedViews.duplicate()`. */
+  readonly duplicate?: (input: {
+    readonly id: string;
+    readonly name: string;
+    readonly scope?: SavedViewScope;
+  }) => Promise<unknown>;
+  /**
+   * Sets the caller's flags, e.g. a server action that calls
+   * `savedViews.setPreference()`.
+   */
+  readonly setPreference?: (id: string, preference: SavedViewPreferenceInput) => Promise<unknown>;
+  /**
+   * Applies the default view after the first load when the URL holds no query.
+   * Default `true`.
+   */
+  readonly openDefault?: boolean;
+}
+interface SavedViewsControllerOptions<V extends SavedViewLike> extends SavedViewsSyncOptions<V> {
+  /**
+   * The list's URL state now, e.g. from nuqs
+   * `useQueryStates(list.nuqs(createParser))`.
+   */
+  readonly urlState: () => ListUrlState;
+  /** Its setter, which `apply` calls with every key so stale ones clear. */
+  readonly setUrlState: (next: Record<string, unknown>) => unknown;
+}
+interface SavedViewsSnapshot<V extends SavedViewLike> {
+  /** `undefined` until the first load. */
+  readonly views: readonly V[] | undefined;
+  /** The view `apply` opened last. */
+  readonly opened: V | undefined;
+  readonly error: unknown;
+}
+interface SavedViewsActions<V extends SavedViewLike> {
+  /** Puts a view's query in the URL and passes the rest to `onApplyState`. */
+  readonly apply: (view: V) => void;
+  /** Saves the current state as a new view, or over `id`, then loads again. */
+  readonly saveCurrent: (name: string, id?: string) => Promise<void>;
+  readonly remove: (id: string) => Promise<void>;
+  /** Copies a view under `name`, then loads again. */
+  readonly duplicate: (id: string, name: string, scope?: SavedViewScope) => Promise<void>;
+  /** Sets the caller's own default, hidden or pinned flag, then loads again. */
+  readonly setPreference: (id: string, preference: SavedViewPreferenceInput) => Promise<void>;
+  readonly refresh: () => Promise<void>;
+}
+type SavedViewsController<V extends SavedViewLike> = Controller<SavedViewsSnapshot<V>, SavedViewsActions<V>>;
+/** What the URL and the display state show, compared with the views. */
+interface SavedViewsMatch<V extends SavedViewLike> {
+  /** The view whose state the URL and `getState()` hold, if any. */
+  readonly active: V | undefined;
+  /** The URL's query, in the shape a view stores. */
+  readonly query: ListQueryInput<string, string>;
+  /** The URL's query and `getState()`, in the shape a view stores. */
+  readonly state: SavedViewState;
+  /** Whether the state changed since `apply` opened the last view. */
+  readonly isDirty: boolean;
+}
+/** Matches the URL state and the display state against the loaded views. */
+declare function matchSavedViews<V extends SavedViewLike>(snapshot: SavedViewsSnapshot<V>, urlState: ListUrlState, display: SavedViewDisplayState | undefined): SavedViewsMatch<V>;
+/**
+ * Saved views of one list, synced with its URL state and, through `getState`
+ * and `onApplyState`, with the table's columns, grouping, density and layout.
+ */
+declare function createSavedViewsController<V extends SavedViewLike>(options: SavedViewsControllerOptions<V>): SavedViewsController<V>;
+//#endregion
+export { SavedViewRef as A, SavedViewColumns as C, SavedViewList as D, SavedViewKind as E, createSavedViews as F, defaultView as I, savedViewIssues as L, SavedViewState as M, SavedViews as N, SavedViewPreference as O, SavedViewsOptions as P, savedViewStateSchema as R, SavedView as S, SavedViewDisplayState as T, DuplicateViewInput as _, SavedViewsMatch as a, SAVED_VIEW_SCOPES as b, createSavedViewsController as c, displayStateOf as d, queryFromUrlState as f, DefaultViewCandidate as g, urlStateFromQuery as h, SavedViewsControllerOptions as i, SavedViewScope as j, SavedViewPreferenceInput as k, matchSavedViews as l, sameQuery as m, SavedViewsActions as n, SavedViewsSnapshot as o, sameDisplayState as p, SavedViewsController as r, SavedViewsSyncOptions as s, SavedViewLike as t, ListUrlState as u, SAVED_VIEW_DENSITIES as v, SavedViewDensity as w, SaveViewInput as x, SAVED_VIEW_KINDS as y };

package/dist/client-DXb1Nmr3.js

@@ -0,0 +1,111 @@
+import { t as temporal } from "./temporal-required-Dt4mcPsi.js";
+import { t as defineController } from "./controller-BEliOBOv.js";
+import { t as sameRange } from "./range-DwpWe8e7.js";
+//#region src/blocks/bookings/event-calendar.ts
+/**
+* Bookings as event calendar events for a resource view (ReUI's Event Calendar
+* with `resources`, or a schedule): each booking sits on its resource's row.
+* Cancelled bookings are left out.
+*/
+function toEventCalendarBookings(bookings, options = {}) {
+	return bookings.flatMap((booking) => {
+		if (booking.status === "cancelled") return [];
+		const color = options.colorOf?.(booking);
+		return [{
+			id: booking.id,
+			title: options.titleOf?.(booking) ?? booking.customerName ?? "Booking",
+			start: new Date(booking.startsAt.epochMilliseconds),
+			end: new Date(booking.endsAt.epochMilliseconds),
+			resourceId: booking.resourceId,
+			...color === void 0 ? {} : { color },
+			...booking.status === "hold" ? { readOnly: true } : {},
+			data: booking
+		}];
+	});
+}
+/**
+* Slots grouped by their local date (`YYYY-MM-DD`), in start order, for a
+* day-by-day picker.
+*/
+function slotsByDay(slots) {
+	const days = /* @__PURE__ */ new Map();
+	const sorted = slots.toSorted((a, b) => a.startsAt.epochMilliseconds - b.startsAt.epochMilliseconds);
+	for (const slot of sorted) {
+		const day = slot.localStart.toPlainDate().toString();
+		const list = days.get(day);
+		if (list === void 0) days.set(day, [slot]);
+		else list.push(slot);
+	}
+	return days;
+}
+//#endregion
+//#region src/blocks/bookings/client.ts
+const NO_DAYS = /* @__PURE__ */ new Map();
+/**
+* The open slots of a service in the visible range, for a headless date and
+* time picker.
+*/
+function createAvailableSlotsController(options) {
+	const { client, serviceId, tz, resourceId, token } = options;
+	let range = options.range;
+	let ticket = 0;
+	return defineController({
+		slots: void 0,
+		days: NO_DAYS,
+		error: void 0,
+		loading: true
+	}, (state) => {
+		const refresh = async () => {
+			ticket += 1;
+			const request = ticket;
+			state.set({ loading: true });
+			const time = temporal();
+			const span = {
+				from: time.Instant.fromEpochMilliseconds(range.start.getTime()),
+				until: time.Instant.fromEpochMilliseconds(range.end.getTime())
+			};
+			const result = token === void 0 ? await client.availableSlots(serviceId, span, {
+				...tz === void 0 ? {} : { tz },
+				...resourceId === void 0 ? {} : { resourceId }
+			}) : await client.public.slots(token, span, tz === void 0 ? {} : { tz });
+			if (request !== ticket) return;
+			state.set(result.ok ? {
+				slots: result.data,
+				days: slotsByDay(result.data),
+				error: void 0,
+				loading: false
+			} : {
+				error: result.error,
+				loading: false
+			});
+		};
+		return {
+			actions: {
+				refresh,
+				setRange: (next) => {
+					if (sameRange(range, next)) return;
+					range = next;
+					refresh();
+				},
+				hold: async (slot, customer) => {
+					const result = token === void 0 ? await client.hold(serviceId, slot.resourceId, slot.startsAt, customer) : await client.public.hold(token, slot.resourceId, slot.startsAt, {
+						...customer,
+						name: customer?.name ?? "",
+						email: customer?.email ?? ""
+					});
+					if (!result.ok) {
+						state.set({ error: result.error });
+						return;
+					}
+					await refresh();
+					return result.data;
+				}
+			},
+			start: () => {
+				refresh();
+			}
+		};
+	});
+}
+//#endregion
+export { slotsByDay as n, toEventCalendarBookings as r, createAvailableSlotsController as t };

package/dist/client-DkI0oyR7.js

@@ -0,0 +1,76 @@
+import { n as whileSignedIn, t as defineController } from "./controller-BEliOBOv.js";
+//#region src/blocks/audit/client.ts
+function listOptions(organizationId, filters, limit, cursor) {
+	const { actorId, eventType, search } = filters;
+	return {
+		organizationId,
+		order: "desc",
+		...actorId ? { actorId } : {},
+		...eventType ? { eventType } : {},
+		...search?.trim() ? { search: search.trim() } : {},
+		...limit === void 0 ? {} : { limit },
+		...cursor === void 0 ? {} : { cursor }
+	};
+}
+/**
+* One organization's audit trail for an audit table: the newest page as the
+* caller may read it, `setFilters` to narrow it by actor, action or text, and
+* `loadMore` for older pages.
+*/
+function createAuditLogController(options) {
+	const { client, organizationId, limit } = options;
+	return defineController({
+		entries: void 0,
+		filters: options.filters ?? {},
+		loading: false,
+		hasMore: false,
+		error: void 0
+	}, (state) => {
+		let ticket = 0;
+		let next;
+		const load = async (more) => {
+			if (organizationId === null) return;
+			if (more && next === void 0) return;
+			ticket += 1;
+			const request = ticket;
+			state.set({ loading: true });
+			const result = await client.list(listOptions(organizationId, state.get().filters, limit, more ? next : void 0));
+			if (request !== ticket) return;
+			if (!result.ok) {
+				state.set({
+					loading: false,
+					error: result.error
+				});
+				return;
+			}
+			next = result.data.next;
+			state.set((current) => ({
+				loading: false,
+				error: void 0,
+				hasMore: next !== void 0,
+				entries: more ? [...current.entries ?? [], ...result.data.entries] : result.data.entries
+			}));
+		};
+		const refresh = () => load(false);
+		return {
+			actions: {
+				refresh,
+				loadMore: () => load(true),
+				setFilters: (filters) => {
+					next = void 0;
+					state.set({
+						filters,
+						entries: void 0,
+						hasMore: false
+					});
+					return refresh();
+				}
+			},
+			start: () => organizationId === null ? void 0 : whileSignedIn(options.auth, () => {
+				refresh();
+			})
+		};
+	});
+}
+//#endregion
+export { createAuditLogController as t };

package/dist/client-DkQcRKhm.js

@@ -0,0 +1,67 @@
+import { a as ok, r as err, s as toDbError } from "./result-DIT_qp4G.js";
+import { n as whileSignedIn, t as defineController } from "./controller-BEliOBOv.js";
+//#region src/blocks/billing/client.ts
+/**
+* The plans with the tenant's current one, for a plan picker: `choose` starts
+* Checkout through the injected server action and opens the URL it returns.
+*/
+function createPlanPickerController(options) {
+	return defineController({
+		plans: options.initial?.plans,
+		current: options.initial?.current,
+		pending: void 0,
+		error: void 0
+	}, (state) => {
+		let ticket = 0;
+		let seeded = options.initial !== void 0;
+		const refresh = async () => {
+			ticket += 1;
+			const request = ticket;
+			try {
+				const catalog = await options.load();
+				if (request === ticket) state.set({
+					plans: catalog.plans,
+					current: catalog.current,
+					error: void 0
+				});
+			} catch (cause) {
+				if (request === ticket) state.set({ error: toDbError(cause) });
+			}
+		};
+		return {
+			actions: {
+				refresh,
+				choose: async (plan) => {
+					if (plan === state.get().current) return ok({ url: void 0 });
+					state.set({
+						pending: plan,
+						error: void 0
+					});
+					let started;
+					try {
+						started = await options.checkout(plan);
+						if (started.ok && started.data.url !== void 0) await options.open(started.data.url);
+					} catch (cause) {
+						started = err(toDbError(cause));
+					}
+					if (!started.ok) {
+						state.set({
+							pending: void 0,
+							error: started.error
+						});
+						return started;
+					}
+					state.set({ pending: void 0 });
+					if (started.data.url === void 0) await refresh();
+					return started;
+				}
+			},
+			start: () => whileSignedIn(options.auth, () => {
+				if (seeded) seeded = false;
+				else refresh();
+			})
+		};
+	});
+}
+//#endregion
+export { createPlanPickerController as t };

package/dist/client-DoXBX3vS.d.ts

@@ -0,0 +1,116 @@
+import { b as DbError } from "./result-mijqfoJN.js";
+import { O as AiShareLink, a as AiChatInput, c as AiChatPatch, d as AiChatShare, h as AiModel, i as AiChat, k as AiStoredMessage, l as AiChatQuery, u as AiChatRecord } from "./ai-chat-B00sIOjY.js";
+import { p as SubscriptionStatus } from "./topic-CZvLXFND.js";
+import { n as TopicPort } from "./watch-topic-CloXeDTO.js";
+import { n as Controller, t as AuthPort } from "./controller-lWRcKqCl.js";
+//#region src/blocks/ai-chat/client.d.ts
+interface Ports {
+  readonly topic: TopicPort;
+}
+interface AiChatsControllerOptions {
+  readonly client: Pick<AiChat, "chats">;
+  readonly auth: AuthPort;
+  readonly ports: Ports;
+  /** The list's filters and page size. */
+  readonly query?: Omit<AiChatQuery, "cursor">;
+  /**
+   * The prefix of the list topic (`blockConfig["ai-chat"].options.listTopic`
+   * from `blocks.generated.ts`); `null` loads once.
+   */
+  readonly topic?: string | null;
+}
+interface AiChatsSnapshot {
+  /** `undefined` until the first load. */
+  readonly items: readonly AiChatRecord[] | undefined;
+  /** Whether `loadMore` has another page. */
+  readonly hasMore: boolean;
+  readonly status: SubscriptionStatus;
+  readonly error: DbError | undefined;
+}
+interface AiChatsActions {
+  readonly loadMore: () => Promise<void>;
+  readonly refresh: () => Promise<void>;
+  readonly create: (input?: AiChatInput) => Promise<AiChatRecord | undefined>;
+  readonly update: (chatId: string, patch: AiChatPatch) => Promise<AiChatRecord | undefined>;
+  readonly remove: (chatId: string) => Promise<void>;
+}
+type AiChatsController = Controller<AiChatsSnapshot, AiChatsActions>;
+/**
+ * The signed-in user's chats in a tenant, newest first, loaded again when any
+ * of their chats changes. Pages loaded with `loadMore` load again too.
+ */
+declare function createAiChatsController(options: AiChatsControllerOptions): AiChatsController;
+interface AiChatTreeControllerOptions {
+  readonly client: {
+    readonly messages: Pick<AiChat["messages"], "path" | "switchBranch" | "siblings">;
+  };
+  readonly ports: Ports;
+  /** `null` or `undefined` waits. */
+  readonly chatId: string | null | undefined;
+  /**
+   * The prefix of the chat topic (`blockConfig["ai-chat"].options.topic` from
+   * `blocks.generated.ts`); `null` loads once.
+   */
+  readonly topic?: string | null;
+}
+interface AiChatTreeSnapshot {
+  /** The active branch, root first; `undefined` until the first load. */
+  readonly path: readonly AiStoredMessage[] | undefined;
+  readonly status: SubscriptionStatus;
+  readonly error: DbError | undefined;
+}
+interface AiChatTreeActions {
+  readonly refresh: () => Promise<void>;
+  /** Shows the branch through `messageId`. */
+  readonly switchBranch: (messageId: string) => Promise<void>;
+  /** Shows the sibling `offset` places from `messageId` (`-1` older, `1` newer). */
+  readonly step: (messageId: string, offset: number) => Promise<void>;
+}
+type AiChatTreeController = Controller<AiChatTreeSnapshot, AiChatTreeActions>;
+/**
+ * One chat's active branch, loaded again when a message is saved or the branch
+ * changes, in this tab or another.
+ */
+declare function createAiChatTreeController(options: AiChatTreeControllerOptions): AiChatTreeController;
+interface AiModelsControllerOptions {
+  readonly client: {
+    readonly models: Pick<AiChat["models"], "allowed">;
+  };
+  readonly organizationId?: string | null;
+}
+interface AiModelsSnapshot {
+  /** `undefined` until loaded. */
+  readonly models: readonly AiModel[] | undefined;
+  readonly error: DbError | undefined;
+}
+interface AiModelsActions {
+  readonly refresh: () => Promise<void>;
+}
+type AiModelsController = Controller<AiModelsSnapshot, AiModelsActions>;
+/** The models the tenant's plans allow, for a model picker. */
+declare function createAiModelsController(options: AiModelsControllerOptions): AiModelsController;
+interface AiShareControllerOptions {
+  readonly client: {
+    readonly shares: Pick<AiChat["shares"], "list" | "create" | "revoke">;
+  };
+  /** `null` or `undefined` waits. */
+  readonly chatId: string | null | undefined;
+}
+interface AiShareSnapshot {
+  /** The chat's share links, newest first; `undefined` until loaded. */
+  readonly shares: readonly AiChatShare[] | undefined;
+  readonly error: DbError | undefined;
+}
+interface AiShareActions {
+  /**
+   * Makes a link to the active branch, or to `leafId`; the token is in the
+   * result only.
+   */
+  readonly create: (leafId?: string) => Promise<AiShareLink | undefined>;
+  readonly revoke: (shareId: string) => Promise<void>;
+}
+type AiShareController = Controller<AiShareSnapshot, AiShareActions>;
+/** Share links for one chat the user owns. */
+declare function createAiShareController(options: AiShareControllerOptions): AiShareController;
+//#endregion
+export { createAiChatTreeController as _, AiChatsActions as a, createAiShareController as b, AiChatsSnapshot as c, AiModelsControllerOptions as d, AiModelsSnapshot as f, AiShareSnapshot as g, AiShareControllerOptions as h, AiChatTreeSnapshot as i, AiModelsActions as l, AiShareController as m, AiChatTreeController as n, AiChatsController as o, AiShareActions as p, AiChatTreeControllerOptions as r, AiChatsControllerOptions as s, AiChatTreeActions as t, AiModelsController as u, createAiChatsController as v, createAiModelsController as y };