better-supabase 0.12.0 → 0.14.0

package/dist/client-D7T7OLiw.js

@@ -1,169 +0,0 @@
-import { n as dbError } from "./errors-BV1SKTVs.js";
-import { a as ok, r as err } from "./result-DIeYscA3.js";
-import { n as whileSignedIn, t as defineController } from "./controller-D6NyNrlZ.js";
-import { R as toInstant } from "./block-helpers-DkVZNDrj.js";
-import { t as authResult } from "./auth-reply-Daq72lY4.js";
-//#region src/blocks/sessions/client.ts
-const filled = (value) => value === null || value === void 0 || value === "" ? void 0 : value;
-const clientInfo = (raw) => ({
-	id: raw.id,
-	name: raw.name,
-	uri: filled(raw.uri),
-	logoUri: filled(raw.logo_uri)
-});
-const hostOf = (uri) => {
-	try {
-		return new URL(uri).host;
-	} catch {
-		return uri;
-	}
-};
-/**
-* Reads per authorization id. A request the user approved before is used up
-* by its first read, so a second controller for the same id (React Strict
-* Mode mounts twice) has to share the answer.
-*/
-const reads = /* @__PURE__ */ new Map();
-async function readDetails(oauth, authorizationId) {
-	const result = await authResult(() => oauth.getAuthorizationDetails(authorizationId));
-	if (!result.ok) return result;
-	const data = result.data;
-	if (!("authorization_id" in data)) return ok({ redirectUrl: data.redirect_url });
-	return ok({
-		authorizationId: data.authorization_id,
-		client: clientInfo(data.client),
-		user: data.user,
-		scopes: data.scope.split(" ").filter((scope) => scope !== ""),
-		redirectUri: data.redirect_uri,
-		redirectHost: hostOf(data.redirect_uri)
-	});
-}
-const assign = (url) => {
-	globalThis.location.assign(url);
-};
-/**
-* The consent page of the Supabase Auth OAuth server: it reads the request
-* for `authorizationId`, and `approve` or `deny` send the browser to the
-* `redirect_url` that Auth returns, never to a URL from the page.
-*/
-function createOAuthConsentController(options) {
-	const { oauth, authorizationId } = options;
-	const redirect = options.redirect ?? assign;
-	return defineController({
-		request: void 0,
-		redirectUrl: void 0,
-		deciding: void 0,
-		error: void 0
-	}, (state) => {
-		const leave = (url) => {
-			state.set({
-				request: void 0,
-				redirectUrl: url
-			});
-			redirect(url);
-		};
-		const load = async (id) => {
-			let read = reads.get(id);
-			if (read === void 0) {
-				read = readDetails(oauth, id);
-				reads.set(id, read);
-			}
-			const run = state.run();
-			const result = await read;
-			if (run !== state.run()) return;
-			if (!result.ok) {
-				reads.delete(id);
-				state.set({ error: result.error });
-				return;
-			}
-			if ("redirectUrl" in result.data) {
-				leave(result.data.redirectUrl);
-				return;
-			}
-			state.set({
-				request: result.data,
-				error: void 0
-			});
-		};
-		const decide = async (decision) => {
-			const id = state.get().request?.authorizationId;
-			if (id === void 0 || state.get().deciding !== void 0) return err(dbError("invalid_input", "No authorization request to decide"));
-			state.set({
-				deciding: decision,
-				error: void 0
-			});
-			const result = await authResult(() => decision === "approve" ? oauth.approveAuthorization(id, { skipBrowserRedirect: true }) : oauth.denyAuthorization(id, { skipBrowserRedirect: true }));
-			if (!result.ok) {
-				state.set({
-					deciding: void 0,
-					error: result.error
-				});
-				return result;
-			}
-			reads.delete(id);
-			leave(result.data.redirect_url);
-			return ok(result.data.redirect_url);
-		};
-		return {
-			actions: {
-				approve: () => decide("approve"),
-				deny: () => decide("deny")
-			},
-			start: () => whileSignedIn(options.auth, () => {
-				if (authorizationId !== void 0) load(authorizationId);
-			})
-		};
-	});
-}
-/** The OAuth clients (such as MCP clients) the user approved, for a connected agents list. */
-function createOAuthGrantsController(options) {
-	const { oauth } = options;
-	return defineController({
-		grants: void 0,
-		revoking: [],
-		error: void 0
-	}, (state) => {
-		let ticket = 0;
-		const refresh = async () => {
-			const request = ++ticket;
-			const result = await authResult(() => oauth.listGrants());
-			if (request !== ticket) return;
-			if (!result.ok) {
-				state.set({ error: result.error });
-				return;
-			}
-			state.set({
-				grants: result.data.map((grant) => ({
-					client: clientInfo(grant.client),
-					scopes: grant.scopes,
-					grantedAt: toInstant(grant.granted_at)
-				})).toSorted((a, b) => b.grantedAt.epochMilliseconds - a.grantedAt.epochMilliseconds),
-				error: void 0
-			});
-		};
-		return {
-			actions: {
-				refresh,
-				revoke: async (clientId) => {
-					state.set((current) => ({
-						revoking: [...current.revoking, clientId],
-						error: void 0
-					}));
-					const result = await authResult(() => oauth.revokeGrant({ clientId }));
-					state.set((current) => ({
-						revoking: current.revoking.filter((each) => each !== clientId),
-						...result.ok ? {} : { error: result.error }
-					}));
-					if (!result.ok) return result;
-					await refresh();
-					return ok(true);
-				}
-			},
-			start: () => whileSignedIn(options.auth, () => {
-				refresh();
-			})
-		};
-	});
-}
-//#endregion
-export { createOAuthGrantsController as n, createOAuthConsentController as t };

package/dist/client-DB34f_7i.d.ts

@@ -1,58 +0,0 @@
-import { b as DbError, f as Result } from "./result-BREt7qOh.js";
-import { n as Controller, t as AuthPort } from "./controller-BZhiIb-N.js";
-import { d as CreateApiKeyInput, f as CreatedApiKey, l as ApiKeys, t as ApiKey } from "./api-keys-AgDXbcql.js";
-//#region src/blocks/api-keys/client.d.ts
-/** What `create` takes: the organization comes from the controller. */
-type ApiKeyDraft = Omit<CreateApiKeyInput, "organizationId">;
-/** A key change that committed, for `onChanged`. */
-type ApiKeyChange = {
-  readonly kind: "created";
-  readonly key: ApiKey;
-} | {
-  readonly kind: "revoked";
-  readonly id: string;
-};
-interface ApiKeysControllerOptions {
-  readonly client: Pick<ApiKeys, "list" | "create" | "revoke">;
-  readonly auth: AuthPort;
-  /**
-   * The organization whose keys to list and create: all of them for its
-   * managers, the caller's own for everyone else. `null` lists the
-   * caller's personal keys.
-   */
-  readonly organizationId: string | null;
-  /**
-   * Runs after a key was created or revoked, such as a server action that
-   * completes an onboarding step. A throw is kept in `error`.
-   */
-  readonly onChanged?: (change: ApiKeyChange) => void | Promise<void>;
-}
-interface ApiKeysSnapshot {
-  /** Newest first; `undefined` until the first load. */
-  readonly keys: readonly ApiKey[] | undefined;
-  /** Whether a key is being created. */
-  readonly creating: boolean;
-  /** The key `create` made, with its token, which is shown once; until `dismiss`. */
-  readonly created: CreatedApiKey | undefined;
-  /** The key ids with a revoke in flight. */
-  readonly revoking: readonly string[];
-  readonly error: DbError | undefined;
-}
-interface ApiKeysActions {
-  /** Creates a key and keeps its token in `created`; a failure is also kept in `error`. */
-  readonly create: (draft: ApiKeyDraft) => Promise<Result<CreatedApiKey>>;
-  /** Revokes a key at once, then loads the list again. */
-  readonly revoke: (id: string) => Promise<Result<boolean>>;
-  /** Forgets `created` and `error`, such as when the token dialog closes. */
-  readonly dismiss: () => void;
-  readonly refresh: () => Promise<void>;
-}
-type ApiKeysController = Controller<ApiKeysSnapshot, ApiKeysActions>;
-/**
- * The API keys of an organization (or the caller's personal keys) for an
- * API keys table: `create` returns the token once, `revoke` revokes a key,
- * and both load the list again.
- */
-declare function createApiKeysController(options: ApiKeysControllerOptions): ApiKeysController;
-//#endregion
-export { ApiKeysControllerOptions as a, ApiKeysController as i, ApiKeyDraft as n, ApiKeysSnapshot as o, ApiKeysActions as r, createApiKeysController as s, ApiKeyChange as t };

package/dist/client-DCawyopp.d.ts

@@ -1,65 +0,0 @@
-import { b as DbError } from "./result-BREt7qOh.js";
-import { p as SubscriptionStatus } from "./topic-DAY_HOX2.js";
-import { n as TopicPort } from "./watch-topic-C79ZW5-R.js";
-import { a as WorkflowRunStatus, g as Workflows, n as WorkflowRun } from "./workflows-DQBCzrHC.js";
-import { n as Controller, t as AuthPort } from "./controller-BZhiIb-N.js";
-//#region src/blocks/workflows/client.d.ts
-interface WorkflowRunsControllerOptions {
-  readonly client: {
-    readonly runs: Pick<Workflows["runs"], "list">;
-  };
-  readonly auth: AuthPort;
-  readonly ports: {
-    readonly topic: TopicPort;
-  };
-  /** The tenant whose runs to list; it also joins the tenant's `workflow-runs:<tenant>` topic. Without one, the signed-in user's own runs load once. */
-  readonly tenant?: string | null;
-  readonly definition?: string;
-  readonly status?: WorkflowRunStatus;
-  readonly limit?: number;
-}
-interface WorkflowRunsSnapshot {
-  /** `undefined` until the first load. */
-  readonly runs: readonly WorkflowRun[] | undefined;
-  readonly error: DbError | undefined;
-  readonly status: SubscriptionStatus;
-}
-interface WorkflowRunsActions {
-  readonly refresh: () => Promise<void>;
-}
-type WorkflowRunsController = Controller<WorkflowRunsSnapshot, WorkflowRunsActions>;
-/**
- * The runs the signed-in user may read, newest first, loaded again when a
- * run in the tenant changes status.
- */
-declare function createWorkflowRunsController(options: WorkflowRunsControllerOptions): WorkflowRunsController;
-interface WorkflowRunControllerOptions {
-  readonly client: {
-    readonly runs: Pick<Workflows["runs"], "get" | "requestCancel">;
-  };
-  readonly auth: AuthPort;
-  readonly ports: {
-    readonly topic: TopicPort;
-  };
-  /** The run's id or its engine's id; `null` waits. */
-  readonly run: string | null;
-}
-interface WorkflowRunSnapshot {
-  /** `undefined` until the first load, and when the user may not read the run. */
-  readonly run: WorkflowRun | undefined;
-  readonly error: DbError | undefined;
-  readonly status: SubscriptionStatus;
-}
-interface WorkflowRunActions {
-  readonly refresh: () => Promise<void>;
-  /** Asks the engine to cancel the run, then loads it again. */
-  readonly cancel: () => Promise<void>;
-}
-type WorkflowRunController = Controller<WorkflowRunSnapshot, WorkflowRunActions>;
-/**
- * One run by its id or its engine's id, loaded again on each status change
- * broadcast on `workflow-run:<id>`.
- */
-declare function createWorkflowRunController(options: WorkflowRunControllerOptions): WorkflowRunController;
-//#endregion
-export { WorkflowRunsActions as a, WorkflowRunsSnapshot as c, WorkflowRunSnapshot as i, createWorkflowRunController as l, WorkflowRunController as n, WorkflowRunsController as o, WorkflowRunControllerOptions as r, WorkflowRunsControllerOptions as s, WorkflowRunActions as t, createWorkflowRunsController as u };

package/dist/client-DNq8xYb-.js

@@ -1,52 +0,0 @@
-import { n as whileSignedIn, t as defineController } from "./controller-D6NyNrlZ.js";
-//#region src/blocks/announcements/client.ts
-/**
-* The signed-in user's live announcements, loaded again whenever staff
-* publish, change or remove one.
-*/
-function createAnnouncementsController(options) {
-	const { client } = options;
-	const organizationId = options.organizationId ?? null;
-	const topic = options.topic === void 0 ? "announcements" : options.topic;
-	return defineController({
-		items: void 0,
-		status: "closed",
-		error: void 0
-	}, (state) => {
-		const refresh = async () => {
-			const run = state.run();
-			const result = await client.listActive(organizationId);
-			if (run !== state.run()) return;
-			state.set(result.ok ? {
-				items: result.data,
-				error: void 0
-			} : { error: result.error });
-		};
-		return {
-			actions: {
-				refresh,
-				dismiss: async (announcementId) => {
-					const result = await client.dismiss(announcementId);
-					if (!result.ok) {
-						state.set({ error: result.error });
-						return;
-					}
-					state.set((current) => ({ items: current.items?.filter((item) => item.id !== announcementId) }));
-				}
-			},
-			start: () => whileSignedIn(options.auth, () => {
-				refresh();
-				if (!topic) return;
-				return options.ports.topic(topic, {
-					onMessage: () => void refresh(),
-					onRejoin: () => void refresh(),
-					onStatus: (status) => {
-						state.set({ status });
-					}
-				}).leave;
-			})
-		};
-	});
-}
-//#endregion
-export { createAnnouncementsController as t };

package/dist/client-Dqa4XyJ5.d.ts

@@ -1,108 +0,0 @@
-import { b as DbError, f as Result, t as AsyncResult } from "./result-BREt7qOh.js";
-import { n as Logger } from "./logger-DWVYUmwi.js";
-import { t as StandardSchemaV1 } from "./standard-BcUQuUgu.js";
-import { n as BlockOptions } from "./block-helpers-CjcQM1yA.js";
-import { n as BlockHooks } from "./block-hooks-DcPJHztl.js";
-import { n as ExtraFields, r as FieldsOf } from "./block-fields-DnaDbgZS.js";
-import { n as Controller, t as AuthPort } from "./controller-BZhiIb-N.js";
-import { t as RankNeighbors } from "./rank-result-BcYfDA0x.js";
-//#region src/blocks/tags/tags.d.ts
-interface TagsOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockOptions {
-  /**
-   * A Standard Schema for the tag's extra columns
-   * (`blocks.tags.options.extraColumns`), keyed by database name. It types
-   * and parses them on reads, and validates them on `create` and `update`.
-   */
-  readonly fields?: S;
-  /** `withBlockHooks` hooks around the client's methods. */
-  readonly hooks?: NoInfer<BlockHooks<Tags<FieldsOf<S>>>>;
-  /** Receives the errors `after` hooks throw. Default: `console`. */
-  readonly logger?: Logger;
-}
-/** A tag. `F` types the extra columns the `fields` schema describes. */
-interface Tag<F extends object = Record<never, never>> {
-  readonly id: string;
-  readonly name: string;
-  readonly slug: string;
-  /** Its rank key among the tenant's tags of the same kind, when it has one. */
-  readonly rank?: string;
-  /** Set on the tags `list` and `forSubject` return. */
-  readonly kind?: string;
-  readonly color?: string;
-  readonly description?: string;
-  /** The extra columns, keyed by database name. */
-  readonly fields: ExtraFields<F>;
-}
-interface Tags<F extends object = Record<never, never>> {
-  /** Creates a tag; `fields` sets its extra columns. */
-  create(organizationId: string, kind: string, name: string, color?: string, description?: string, fields?: Partial<F>): AsyncResult<Tag<F>>;
-  /** Renames a tag (`name` null keeps it) and sets the extra columns `fields` names. */
-  update(id: string, name: string | null, fields?: Partial<F>): AsyncResult<boolean>;
-  /**
-   * Moves a tag between the tags with rank keys `previous` and `next`.
-   * Resolves to its new key.
-   */
-  reorder(id: string, neighbors: RankNeighbors): AsyncResult<string>;
-  delete(id: string): AsyncResult<boolean>;
-  tag(organizationId: string, subjectType: string, subjectId: string, tagId: string): AsyncResult<boolean>;
-  untag(organizationId: string, subjectType: string, subjectId: string, tagId: string): AsyncResult<boolean>;
-  /** The tenant's tags of `kind` (every kind without it), in rank order. */
-  list(organizationId: string, kind?: string): AsyncResult<readonly Tag<F>[]>;
-  /** The tags on one subject, in rank order; the caller must be able to read it. */
-  forSubject(organizationId: string, subjectType: string, subjectId: string): AsyncResult<readonly Tag<F>[]>;
-}
-/** The `tags` SQL module as typed calls. */
-declare function createTags<S extends StandardSchemaV1 | undefined = undefined>(options: TagsOptions<S>): Tags<FieldsOf<S>>;
-//#endregion
-//#region src/blocks/tags/client.d.ts
-/** A tag change on the subject that committed, for `onChanged`. */
-type TagChange = {
-  readonly kind: "added";
-  readonly tag: Tag;
-  readonly created: boolean;
-} | {
-  readonly kind: "removed";
-  readonly tag: Tag;
-};
-interface TagInputControllerOptions {
-  readonly client: Pick<Tags, "list" | "forSubject" | "tag" | "untag" | "create">;
-  readonly auth: AuthPort;
-  /** The organization; the input waits without one. */
-  readonly organizationId: string | null;
-  readonly subjectType: string;
-  readonly subjectId: string;
-  /** The kind of tags the input offers and creates, such as `customer`. */
-  readonly kind: string;
-  /** Runs after a tag was added or removed. A throw is kept in `error`. */
-  readonly onChanged?: (change: TagChange) => void | Promise<void>;
-}
-interface TagInputSnapshot {
-  /** The subject's tags, in rank order; `undefined` until the first load. */
-  readonly tags: readonly Tag[] | undefined;
-  /** Every tag of the kind, for suggestions; `undefined` until the first load. */
-  readonly available: readonly Tag[] | undefined;
-  /** The tag ids, or the names of tags being created, with a write in flight. */
-  readonly pending: readonly string[];
-  readonly error: DbError | undefined;
-}
-interface TagInputActions {
-  /** Adds an existing tag, shown at once and taken back when it fails. */
-  readonly add: (tagId: string) => Promise<Result<Tag>>;
-  /** Removes a tag, hidden at once and put back when it fails. */
-  readonly remove: (tagId: string) => Promise<Result<boolean>>;
-  /**
-   * Adds the tag called `name`: an existing one of the kind with the same
-   * name (ignoring case), or a new one, which needs `tags.manage`.
-   */
-  readonly create: (name: string) => Promise<Result<Tag>>;
-  readonly refresh: () => Promise<void>;
-}
-type TagInputController = Controller<TagInputSnapshot, TagInputActions>;
-/**
- * One subject's tags for a tag input: the tags on it, every tag of the
- * kind for suggestions, and `add`, `remove` and `create`, which show the
- * change at once.
- */
-declare function createTagInputController(options: TagInputControllerOptions): TagInputController;
-//#endregion
-export { TagInputSnapshot as a, Tags as c, TagInputControllerOptions as i, TagsOptions as l, TagInputActions as n, createTagInputController as o, TagInputController as r, Tag as s, TagChange as t, createTags as u };

package/dist/client-Dr5h2r9r.d.ts

@@ -1,34 +0,0 @@
-import { b as DbError } from "./result-BREt7qOh.js";
-import { a as Usage, h as UsageStatus } from "./usage-C504GF55.js";
-import { n as Controller, t as AuthPort } from "./controller-BZhiIb-N.js";
-//#region src/blocks/usage/client.d.ts
-interface UsageMeterControllerOptions {
-  /** `createUsage({ transport })`, or a `Pick` with `overview`. */
-  readonly client: Pick<Usage, "overview">;
-  readonly auth: AuthPort;
-  /** The organization whose usage to read; the meter waits without one. */
-  readonly organizationId: string | null;
-  /** Only these meters, in this order. Default every meter with usage or a quota. */
-  readonly meters?: readonly string[];
-}
-/** One meter against its quota. */
-interface MeterReading extends UsageStatus {
-  /** `used / limit` from 0 to 1, or `undefined` without a limit. */
-  readonly fraction: number | undefined;
-  /** True once the period's quota is used up. */
-  readonly exceeded: boolean;
-}
-interface UsageMeterSnapshot {
-  /** `undefined` until the first load. */
-  readonly meters: readonly MeterReading[] | undefined;
-  readonly error: DbError | undefined;
-}
-interface UsageMeterActions {
-  /** Reads the usage again, such as after the app records some. */
-  readonly refresh: () => Promise<void>;
-}
-type UsageMeterController = Controller<UsageMeterSnapshot, UsageMeterActions>;
-/** This period's usage of an organization against its plan's quotas, per meter. */
-declare function createUsageMeterController(options: UsageMeterControllerOptions): UsageMeterController;
-//#endregion
-export { UsageMeterSnapshot as a, UsageMeterControllerOptions as i, UsageMeterActions as n, createUsageMeterController as o, UsageMeterController as r, MeterReading as t };

package/dist/client-DrTqKgvy.d.ts

@@ -1,155 +0,0 @@
-import { b as DbError, f as Result, t as AsyncResult } from "./result-BREt7qOh.js";
-import { n as Logger } from "./logger-DWVYUmwi.js";
-import { n as BlockOptions } from "./block-helpers-CjcQM1yA.js";
-import { n as BlockHooks } from "./block-hooks-DcPJHztl.js";
-import { n as Controller, t as AuthPort } from "./controller-BZhiIb-N.js";
-import { StandardSchemaV1 } from "@standard-schema/spec";
-//#region src/blocks/settings/settings.d.ts
-/** One setting: its Standard Schema and the value `get` returns when none is stored. */
-interface SettingEntry<S extends StandardSchemaV1 = StandardSchemaV1> {
-  readonly schema: S;
-  readonly default?: StandardSchemaV1.InferOutput<S>;
-  /**
-   * Platform settings only: the platform permission (`is_platform`) that
-   * may change this key. Default `blocks.settings.options.platform.permission`,
-   * then `settings.manage`.
-   */
-  readonly permission?: string;
-  /**
-   * Platform settings only: who reads this key, `public` (anyone, also
-   * signed out), `authenticated` (default) or `staff` (holders of its
-   * permission).
-   */
-  readonly read?: "public" | "authenticated" | "staff";
-}
-type SettingEntries = Readonly<Record<string, SettingEntry>>;
-/** The value type of each key: the schema output, or `undefined` without a default. */
-type SettingValues<E extends SettingEntries> = { readonly [K in keyof E]: E[K] extends SettingEntry<infer S> ? E[K] extends {
-  readonly default: unknown;
-} ? StandardSchemaV1.InferOutput<S> : StandardSchemaV1.InferOutput<S> | undefined : never; };
-/** What a scope's `set` accepts per key: the schema input. */
-type SettingInputs<E extends SettingEntries> = { readonly [K in keyof E]: E[K] extends SettingEntry<infer S> ? StandardSchemaV1.InferInput<S> : never; };
-interface SettingsSpec<U extends SettingEntries = SettingEntries, O extends SettingEntries = SettingEntries, P extends SettingEntries = SettingEntries> {
-  readonly user?: U;
-  readonly organization?: O;
-  /** Settings for the whole product, such as an admin console edits. */
-  readonly platform?: P;
-}
-interface SettingsOptions<U extends SettingEntries = SettingEntries, O extends SettingEntries = SettingEntries, P extends SettingEntries = SettingEntries> extends BlockOptions {
-  /**
-   * The app's settings, from `defineSettings`. Without it (a block wired
-   * with no definition) every key is unknown.
-   */
-  readonly settings?: SettingsDefinition<U, O, P>;
-  /** `withBlockHooks` hooks around the client's methods. */
-  readonly hooks?: NoInfer<BlockHooks<Settings<U, O, P>>>;
-  /** Receives the errors `after` hooks throw. Default: `console`. */
-  readonly logger?: Logger;
-}
-/**
- * Typed reads and writes of the caller's settings, an organization's
- * settings (reads need `settings.read`, writes `settings.update`) and the
- * product-wide settings (reads follow each key's `read`, writes need its
- * platform permission).
- */
-interface Settings<U extends SettingEntries = SettingEntries, O extends SettingEntries = SettingEntries, P extends SettingEntries = Record<never, never>> {
-  /** Every key of the caller's settings, stored values merged over the defaults. */
-  getUser(): AsyncResult<SettingValues<U>>;
-  getUser<K extends keyof U & string>(key: K): AsyncResult<SettingValues<U>[K]>;
-  /** Validates `value` with the key's schema, then stores the output. */
-  setUser<K extends keyof U & string>(key: K, value: SettingInputs<U>[K]): AsyncResult<SettingValues<U>[K]>;
-  /** Removes the stored value, so `getUser` returns the default again. */
-  resetUser(key: keyof U & string): AsyncResult<boolean>;
-  getOrganization(organizationId: string): AsyncResult<SettingValues<O>>;
-  getOrganization<K extends keyof O & string>(organizationId: string, key: K): AsyncResult<SettingValues<O>[K]>;
-  setOrganization<K extends keyof O & string>(organizationId: string, key: K, value: SettingInputs<O>[K]): AsyncResult<SettingValues<O>[K]>;
-  resetOrganization(organizationId: string, key: keyof O & string): AsyncResult<boolean>;
-  getPlatform(): AsyncResult<SettingValues<P>>;
-  getPlatform<K extends keyof P & string>(key: K): AsyncResult<SettingValues<P>[K]>;
-  setPlatform<K extends keyof P & string>(key: K, value: SettingInputs<P>[K]): AsyncResult<SettingValues<P>[K]>;
-  resetPlatform(key: keyof P & string): AsyncResult<boolean>;
-}
-interface SettingsDefinition<U extends SettingEntries, O extends SettingEntries, P extends SettingEntries = Record<never, never>> {
-  /**
-   * Pass as `blocks.settings.options.schemas` for the database checks,
-   * and the platform keys' permissions and read rules.
-   */
-  readonly schemas: {
-    readonly user: U;
-    readonly organization: O;
-    readonly platform: P;
-  };
-}
-/**
- * Declares the app's settings with a Standard Schema per key. Values are
- * validated before they are written, and stored values that no longer match
- * their schema read as the default. Pass the result to `createSettings`.
- */
-declare function defineSettings<const U extends SettingEntries = Record<never, never>, const O extends SettingEntries = Record<never, never>, const P extends SettingEntries = Record<never, never>>(spec: SettingsSpec<U, O, P>): SettingsDefinition<U, O, P>;
-/** The settings block: typed `get`, `set` and `reset` over the settings module's functions. */
-declare function createSettings<U extends SettingEntries, O extends SettingEntries, P extends SettingEntries = Record<never, never>>(options: SettingsOptions<U, O, P>): Settings<U, O, P>;
-//#endregion
-//#region src/blocks/settings/client.d.ts
-/** How a settings page renders a key. */
-type SettingKind = "boolean" | "number" | "text" | "choice" | "json";
-/** One generated form field: a key of the settings definition and what its schema says about it. */
-interface SettingField<K extends string = string> {
-  readonly key: K;
-  /**
-   * From the schema's Standard JSON Schema (`type` and `enum`), or from the
-   * default's type for a schema library without it.
-   */
-  readonly kind: SettingKind;
-  /** The values a `choice` allows, from the JSON Schema `enum`. */
-  readonly choices: readonly (string | number)[];
-  /** The JSON Schema `title` and `description`, such as zod's `.meta()`. */
-  readonly title: string | undefined;
-  readonly description: string | undefined;
-  readonly default: unknown;
-}
-/**
- * The form fields of one scope of a settings definition, in declaration
- * order: `settingFields(settings.schemas.organization)`.
- */
-declare function settingFields<E extends SettingEntries>(entries: E): readonly SettingField<keyof E & string>[];
-interface SettingsControllerOptions<E extends SettingEntries> {
-  /** One scope of the definition: `settings.schemas.user` or `settings.schemas.organization`. */
-  readonly entries: E;
-  readonly auth: AuthPort;
-  /** The caller's own settings: a `createSettings` client. Pass this or `organization`. */
-  readonly user?: Pick<Settings<E>, "getUser" | "setUser" | "resetUser">;
-  /** An organization's settings: a `createSettings` client, with `organizationId`. */
-  readonly organization?: Pick<Settings<SettingEntries, E>, "getOrganization" | "setOrganization" | "resetOrganization">;
-  /** The organization for `organization`; the page waits without one. */
-  readonly organizationId?: string | null;
-}
-interface SettingsSnapshot<E extends SettingEntries> {
-  /** The form fields, from the definition; there before the first load. */
-  readonly fields: readonly SettingField<keyof E & string>[];
-  /** Stored values over the defaults; `undefined` until the first load. */
-  readonly values: SettingValues<E> | undefined;
-  /** The key being saved. */
-  readonly saving: (keyof E & string) | undefined;
-  readonly error: DbError | undefined;
-}
-interface SettingsActions<E extends SettingEntries> {
-  /** Validates and stores one value, then shows it; a failure is also kept in `error`. */
-  readonly set: <K extends keyof E & string>(key: K, value: SettingInputs<E>[K]) => Promise<Result<SettingValues<E>[K]>>;
-  /**
-   * `set` for a form generated from `fields`, whose controls produce plain
-   * values: the key's schema validates `value` before it is stored.
-   */
-  readonly setField: (key: keyof E & string, value: unknown) => Promise<Result<unknown>>;
-  /** Removes the stored value, so the key reads as its default again. */
-  readonly reset: (key: keyof E & string) => Promise<Result<boolean>>;
-  readonly refresh: () => Promise<void>;
-}
-type SettingsController<E extends SettingEntries> = Controller<SettingsSnapshot<E>, SettingsActions<E>>;
-/**
- * One scope of the app's settings for a settings page: the form fields
- * generated from the definition, the stored values over the defaults, and
- * `set` and `reset` per key.
- */
-declare function createSettingsController<E extends SettingEntries>(options: SettingsControllerOptions<E>): SettingsController<E>;
-//#endregion
-export { createSettings as _, SettingsControllerOptions as a, settingFields as c, SettingInputs as d, SettingValues as f, SettingsSpec as g, SettingsOptions as h, SettingsController as i, SettingEntries as l, SettingsDefinition as m, SettingKind as n, SettingsSnapshot as o, Settings as p, SettingsActions as r, createSettingsController as s, SettingField as t, SettingEntry as u, defineSettings as v };