better-supabase 0.8.0 → 0.10.0

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

@@ -0,0 +1,11 @@
+//#region src/blocks/sessions/react/server.ts
+/** The `react-server` build of `useOAuthConsent`: it runs in Client Components only. */
+const useOAuthConsent = () => {
+	throw new Error("better-supabase: useOAuthConsent() runs in Client Components only; render the consent form as one.");
+};
+/** The `react-server` build of `useOAuthGrants`: it runs in Client Components only. */
+const useOAuthGrants = () => {
+	throw new Error("better-supabase: useOAuthGrants() runs in Client Components only; render the list as one.");
+};
+//#endregion
+export { useOAuthConsent, useOAuthGrants };

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

@@ -0,0 +1,20 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as SolidController } from "../../../solid-controller-CZrt1Tg6.js";
+import { a as OAuthConsentControllerOptions, d as OAuthGrantsControllerOptions, f as OAuthGrantsSnapshot, l as OAuthGrantsActions, r as OAuthConsentActions, s as OAuthConsentSnapshot } from "../../../client-kKdkLGPB.js";
+//#region src/blocks/sessions/solid/index.d.ts
+/**
+ * `createOAuthConsentController` 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 useOAuthConsent(options: BlockOptions<OAuthConsentControllerOptions>): SolidController<OAuthConsentSnapshot, OAuthConsentActions>;
+/**
+ * `createOAuthGrantsController` 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 useOAuthGrants(options: BlockOptions<OAuthGrantsControllerOptions>): SolidController<OAuthGrantsSnapshot, OAuthGrantsActions>;
+//#endregion
+export type { BlockOptions, OAuthConsentActions, OAuthConsentControllerOptions, OAuthConsentSnapshot, OAuthGrantsActions, OAuthGrantsControllerOptions, OAuthGrantsSnapshot, SolidController };

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

@@ -0,0 +1,23 @@
+import { t as useBlockController } from "../../../solid-controller-DLsmrczT.js";
+import { n as createOAuthGrantsController, t as createOAuthConsentController } from "../../../client-D727oIVC.js";
+//#region src/blocks/sessions/solid/index.ts
+/**
+* `createOAuthConsentController` 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 useOAuthConsent(options) {
+	return useBlockController(createOAuthConsentController, options);
+}
+/**
+* `createOAuthGrantsController` 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 useOAuthGrants(options) {
+	return useBlockController(createOAuthGrantsController, options);
+}
+//#endregion
+export { useOAuthConsent, useOAuthGrants };

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

@@ -0,0 +1,20 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as SvelteController } from "../../../svelte-controller-DDbju9CW.js";
+import { a as OAuthConsentControllerOptions, d as OAuthGrantsControllerOptions, f as OAuthGrantsSnapshot, l as OAuthGrantsActions, r as OAuthConsentActions, s as OAuthConsentSnapshot } from "../../../client-kKdkLGPB.js";
+//#region src/blocks/sessions/svelte/index.d.ts
+/**
+ * `createOAuthConsentController` 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 useOAuthConsent(options: BlockOptions<OAuthConsentControllerOptions>): SvelteController<OAuthConsentSnapshot, OAuthConsentActions>;
+/**
+ * `createOAuthGrantsController` 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 useOAuthGrants(options: BlockOptions<OAuthGrantsControllerOptions>): SvelteController<OAuthGrantsSnapshot, OAuthGrantsActions>;
+//#endregion
+export type { BlockOptions, OAuthConsentActions, OAuthConsentControllerOptions, OAuthConsentSnapshot, OAuthGrantsActions, OAuthGrantsControllerOptions, OAuthGrantsSnapshot, SvelteController };

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

@@ -0,0 +1,23 @@
+import { t as useBlockController } from "../../../svelte-controller-CDAujo-_.js";
+import { n as createOAuthGrantsController, t as createOAuthConsentController } from "../../../client-D727oIVC.js";
+//#region src/blocks/sessions/svelte/index.ts
+/**
+* `createOAuthConsentController` 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 useOAuthConsent(options) {
+	return useBlockController(createOAuthConsentController, options);
+}
+/**
+* `createOAuthGrantsController` 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 useOAuthGrants(options) {
+	return useBlockController(createOAuthGrantsController, options);
+}
+//#endregion
+export { useOAuthConsent, useOAuthGrants };

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

@@ -0,0 +1,20 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as VueController } from "../../../vue-controller-D_ohttBZ.js";
+import { a as OAuthConsentControllerOptions, d as OAuthGrantsControllerOptions, f as OAuthGrantsSnapshot, l as OAuthGrantsActions, r as OAuthConsentActions, s as OAuthConsentSnapshot } from "../../../client-kKdkLGPB.js";
+//#region src/blocks/sessions/vue/index.d.ts
+/**
+ * `createOAuthConsentController` 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 useOAuthConsent(options: BlockOptions<OAuthConsentControllerOptions>): VueController<OAuthConsentSnapshot, OAuthConsentActions>;
+/**
+ * `createOAuthGrantsController` 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 useOAuthGrants(options: BlockOptions<OAuthGrantsControllerOptions>): VueController<OAuthGrantsSnapshot, OAuthGrantsActions>;
+//#endregion
+export type { BlockOptions, OAuthConsentActions, OAuthConsentControllerOptions, OAuthConsentSnapshot, OAuthGrantsActions, OAuthGrantsControllerOptions, OAuthGrantsSnapshot, VueController };

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

@@ -0,0 +1,23 @@
+import { t as useBlockController } from "../../../vue-controller-C9tFzqAc.js";
+import { n as createOAuthGrantsController, t as createOAuthConsentController } from "../../../client-D727oIVC.js";
+//#region src/blocks/sessions/vue/index.ts
+/**
+* `createOAuthConsentController` 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 useOAuthConsent(options) {
+	return useBlockController(createOAuthConsentController, options);
+}
+/**
+* `createOAuthGrantsController` 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 useOAuthGrants(options) {
+	return useBlockController(createOAuthGrantsController, options);
+}
+//#endregion
+export { useOAuthConsent, useOAuthGrants };

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

@@ -1,89 +1,23 @@
-import { t as AsyncResult, w as ErrorMapper } from "../../result-BchM1XZn.js";
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-inD4fFq-.js";
-import { r as BlockTemporalOptions } from "../../block-helpers-C0Xj8War.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 `sql.modules.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 SettingsConnectOptions extends BlockTemporalOptions {
-  readonly transport: BlockTransport;
-  /** The module schema (`sql.modules.settings.schema`), default `better_supabase`. */
-  readonly schema?: string;
-  readonly mappers?: readonly ErrorMapper[];
-}
-/** The caller's own settings. */
-interface UserSettings<E extends SettingEntries> {
-  /** Every key, stored values merged over the defaults. */
-  get(): AsyncResult<SettingValues<E>>;
-  get<K extends keyof E & string>(key: K): AsyncResult<SettingValues<E>[K]>;
-  /** Validates `value` with the key's schema, then stores the output. */
-  set<K extends keyof E & string>(key: K, value: SettingInputs<E>[K]): AsyncResult<SettingValues<E>[K]>;
-  /** Removes the stored value, so `get` returns the default again. */
-  reset(key: keyof E & string): AsyncResult<boolean>;
-}
-/** One organization's settings; reads need `settings.read`, writes `settings.update`. */
-interface OrganizationSettings<E extends SettingEntries> {
-  get(organizationId: string): AsyncResult<SettingValues<E>>;
-  get<K extends keyof E & string>(organizationId: string, key: K): AsyncResult<SettingValues<E>[K]>;
-  set<K extends keyof E & string>(organizationId: string, key: K, value: SettingInputs<E>[K]): AsyncResult<SettingValues<E>[K]>;
-  reset(organizationId: string, key: keyof E & string): AsyncResult<boolean>;
-}
-/**
- * The product-wide settings: reads follow each key's `read`, writes need
- * its platform permission.
- */
-type PlatformSettings<E extends SettingEntries> = UserSettings<E>;
-interface SettingsClient<U extends SettingEntries, O extends SettingEntries, P extends SettingEntries = Record<never, never>> {
-  readonly user: UserSettings<U>;
-  readonly organization: OrganizationSettings<O>;
-  readonly platform: PlatformSettings<P>;
-}
-interface SettingsDefinition<U extends SettingEntries, O extends SettingEntries, P extends SettingEntries = Record<never, never>> {
-  /**
-   * Pass as `sql.modules.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;
-  };
-  /** Typed `get`, `set` and `reset` over the settings module's functions. */
-  connect(options: SettingsConnectOptions): SettingsClient<U, O, P>;
-}
+import { rt as SettingEventData, wt as Events } from "../../events-CtAHxPal.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-NbUJygA7.js";
+import { s as BlockOf } from "../../define-block-BlHQxDIQ.js";
+import { _ as createSettings, a as SettingsControllerOptions, c as settingFields, d as SettingInputs, f as SettingValues, g as SettingsSpec, h as SettingsOptions, i as SettingsController, l as SettingEntries, m as SettingsDefinition, n as SettingKind, o as SettingsSnapshot, p as Settings, r as SettingsActions, s as createSettingsController, t as SettingField, u as SettingEntry, v as defineSettings } from "../../client-BO9fQgBB.js";
+//#region src/blocks/settings/events.d.ts
+/** The events of the `settings` block: type to data. */
+type SettingsEvents = {
+  readonly "organization_setting.updated": SettingEventData;
+  readonly "organization_setting.reset": SettingEventData;
+  readonly "platform_setting.updated": SettingEventData;
+  readonly "platform_setting.reset": SettingEventData;
+};
+/** The `settings` block's event types, for its manifest and `onBlockEvent`. */
+export declare const settingsEvents: Events<SettingsEvents>;
+//#endregion
+//#region src/blocks/settings/manifest.d.ts
 /**
- * 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.
+ * The `settings` block's manifest (ADR 0029). Pass the app's settings with
+ * `settingsBlock.using((options) => createSettings({ ...options, settings }))`.
  */
-export 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>;
+export declare const settingsBlock: BlockOf<"settings", typeof createSettings, SettingsEvents>;
 //#endregion
-export { type BlockTransport, type OrganizationSettings, type PlatformSettings, type SettingEntries, type SettingEntry, type SettingInputs, type SettingValues, type SettingsClient, type SettingsConnectOptions, type SettingsDefinition, type SettingsSpec, type UserSettings, dbTransport, rpcTransport, sqlTransport };
+export { type BlockTransport, type SettingEntries, type SettingEntry, type SettingField, type SettingInputs, type SettingKind, type SettingValues, type Settings, type SettingsActions, type SettingsController, type SettingsControllerOptions, type SettingsDefinition, type SettingsEvents, type SettingsOptions, type SettingsSnapshot, type SettingsSpec, createSettings, createSettingsController, dbTransport, defineSettings, rpcTransport, settingFields, sqlTransport };

package/dist/blocks/settings/index.js

@@ -1,105 +1,31 @@
-import { n as dbError } from "../../errors-2M6CKMP4.js";
-import { r as err, t as AsyncResult } from "../../result-DEqHCMKP.js";
-import { n as isRecord } from "../../guards-6F2bCtQR.js";
-import { n as validate } from "../../standard-DkzZUneg.js";
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-bAKh-dGc.js";
-import { i as blockCall, n as applyTemporal } from "../../block-helpers-Cy3pB96I.js";
-//#region src/blocks/settings/settings.ts
+import { t as settingsSqlOptions } from "../../options-CVSWgZpY.js";
+import { n as event, t as defineEvents } from "../../event-map-Dy2vKHai.js";
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-G4t1umrR.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { n as defineSettings, t as createSettings } from "../../settings-DxXfDUmh.js";
+import { n as settingFields, t as createSettingsController } from "../../client-jvtwGFy4.js";
+//#region src/blocks/settings/events.ts
+/** The `settings` block's event types, for its manifest and `onBlockEvent`. */
+const settingsEvents = defineEvents({
+	"organization_setting.updated": event(),
+	"organization_setting.reset": event(),
+	"platform_setting.updated": event(),
+	"platform_setting.reset": event()
+});
+//#endregion
+//#region src/blocks/settings/manifest.ts
 /**
-* 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.
+* The `settings` block's manifest (ADR 0029). Pass the app's settings with
+* `settingsBlock.using((options) => createSettings({ ...options, settings }))`.
 */
-function defineSettings(spec) {
-	const user = spec.user ?? {};
-	const organization = spec.organization ?? {};
-	const platform = spec.platform ?? {};
-	return {
-		schemas: {
-			user,
-			organization,
-			platform
-		},
-		connect: (options) => {
-			applyTemporal(options);
-			const call = blockCall(options.transport, options.schema, options.mappers);
-			return {
-				user: userScope(user, call),
-				organization: organizationScope(organization, call),
-				platform: platformScope(platform, call)
-			};
-		}
-	};
-}
-/** Stored values merged over the defaults; unknown keys are dropped. */
-async function merged(entries, stored) {
-	const values = isRecord(stored) ? stored : {};
-	const out = {};
-	for (const [key, entry] of Object.entries(entries)) out[key] = await readValue(entry, values[key]);
-	return out;
-}
-async function readValue(entry, stored) {
-	if (stored === void 0) return entry.default;
-	const parsed = await validate(entry.schema, stored);
-	return parsed.ok ? parsed.data : entry.default;
-}
-function unknownSetting(key) {
-	return AsyncResult.from(() => Promise.resolve(err(dbError("invalid_input", `Unknown setting "${key}"`))));
-}
-/** Reads every key, or one key, through `fn`. */
-function reader(entries, call, fn, args, key) {
-	if (key !== void 0 && !(key in entries)) return unknownSetting(key);
-	return call(fn, args, async (stored) => {
-		const values = await merged(entries, stored);
-		return key === void 0 ? values : values[key];
-	});
-}
-/** Validates `value` with the key's schema, then writes the output through `fn`. */
-function writer(entries, call, fn, args, key, value) {
-	const entry = entries[key];
-	if (!entry) return unknownSetting(key);
-	return AsyncResult.from(() => validate(entry.schema, value, `setting "${key}"`)).andThen((output) => call(fn, {
-		...args,
-		key,
-		value: { value: output ?? null }
-	}, () => output));
-}
-function remover(entries, call, fn, args, key) {
-	if (!(key in entries)) return unknownSetting(key);
-	return call(fn, {
-		...args,
-		key
-	}, (removed) => removed === true);
-}
-function userScope(entries, call) {
-	function get(key) {
-		return reader(entries, call, "get_user_settings", {}, key);
-	}
-	return {
-		get,
-		set: (key, value) => writer(entries, call, "set_user_setting", {}, key, value),
-		reset: (key) => remover(entries, call, "reset_user_setting", {}, key)
-	};
-}
-function organizationScope(entries, call) {
-	function get(organizationId, key) {
-		return reader(entries, call, "get_organization_settings", { tenant: organizationId }, key);
-	}
-	return {
-		get,
-		set: (organizationId, key, value) => writer(entries, call, "set_organization_setting", { tenant: organizationId }, key, value),
-		reset: (organizationId, key) => remover(entries, call, "reset_organization_setting", { tenant: organizationId }, key)
-	};
-}
-function platformScope(entries, call) {
-	function get(key) {
-		return reader(entries, call, "get_platform_settings", {}, key);
-	}
-	return {
-		get,
-		set: (key, value) => writer(entries, call, "set_platform_setting", {}, key, value),
-		reset: (key) => remover(entries, call, "reset_platform_setting", {}, key)
-	};
-}
+const settingsBlock = defineBlock({
+	name: "settings",
+	sql: ["settings"],
+	options: { settings: settingsSqlOptions },
+	events: settingsEvents,
+	create: createSettings,
+	category: "tenancy",
+	recipes: ["settings-layout"]
+});
 //#endregion
-export { dbTransport, defineSettings, rpcTransport, sqlTransport };
+export { createSettings, createSettingsController, dbTransport, defineSettings, rpcTransport, settingFields, settingsBlock, settingsEvents, sqlTransport };

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

@@ -0,0 +1,25 @@
+import { l as SettingEntries, m as SettingsDefinition, n as SettingKind, o as SettingsSnapshot, r as SettingsActions, t as SettingField } from "../../../client-BO9fQgBB.js";
+//#region src/blocks/settings/react/index.d.ts
+export interface UseSettingsOptions<S extends "user" | "organization"> {
+  /** Which part of the definition the page edits. */
+  readonly scope: S;
+  /** The organization, for `scope: "organization"`; the page waits without one. */
+  readonly organizationId?: string | null;
+  /** The schema the calls go to: the module schema (default `better_supabase`), or the API schema from `blocks.<module>.api`. */
+  readonly schema?: string;
+}
+export interface SettingsState<E extends SettingEntries> extends SettingsSnapshot<E>, SettingsActions<E> {}
+/**
+ * One scope of a `defineSettings()` definition for a settings page,
+ * through the browser client: `fields` to render, generated from the
+ * definition, the stored `values`, and `set` and `reset` per key. The same
+ * hook runs in React DOM and React Native.
+ *
+ * ```tsx
+ * const { fields, values, set } = useSettings(settings, { scope: "organization", organizationId });
+ * ```
+ */
+export declare function useSettings<U extends SettingEntries, O extends SettingEntries, P extends SettingEntries>(settings: SettingsDefinition<U, O, P>, options: UseSettingsOptions<"user">): SettingsState<U>;
+export declare function useSettings<U extends SettingEntries, O extends SettingEntries, P extends SettingEntries>(settings: SettingsDefinition<U, O, P>, options: UseSettingsOptions<"organization">): SettingsState<O>;
+//#endregion
+export type { SettingField, SettingKind };

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

@@ -0,0 +1,37 @@
+"use client";
+import { r as rpcTransport } from "../../../block-transport-G4t1umrR.js";
+import { t as useController } from "../../../react-controller-Xn-IU44p.js";
+import { t as useBlockEnv } from "../../../react-env-Cc7Vf6eb.js";
+import { t as createSettings } from "../../../settings-DxXfDUmh.js";
+import { t as createSettingsController } from "../../../client-jvtwGFy4.js";
+//#region src/blocks/settings/react/index.ts
+function useSettings(settings, options) {
+	const { supabase, auth } = useBlockEnv();
+	const { scope, organizationId, schema } = options;
+	return useController(() => {
+		const client = createSettings({
+			settings,
+			transport: rpcTransport(supabase),
+			...schema === void 0 ? {} : { schema }
+		});
+		return scope === "user" ? createSettingsController({
+			entries: settings.schemas.user,
+			auth,
+			user: client
+		}) : createSettingsController({
+			entries: settings.schemas.organization,
+			auth,
+			organization: client,
+			organizationId: organizationId ?? null
+		});
+	}, [
+		settings,
+		supabase,
+		auth,
+		scope,
+		organizationId,
+		schema
+	]).view;
+}
+//#endregion
+export { useSettings };

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

@@ -0,0 +1,7 @@
+import { n as SettingKind, t as SettingField } from "../../../client-BO9fQgBB.js";
+import { SettingsState, UseSettingsOptions, useSettings as useSettings$1 } from "./index.js";
+//#region src/blocks/settings/react/server.d.ts
+/** The `react-server` build of `useSettings`: call `createSettings(...).getUser()` instead. */
+export declare const useSettings: typeof useSettings$1;
+//#endregion
+export type { SettingField, SettingKind, SettingsState, UseSettingsOptions };

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

@@ -0,0 +1,7 @@
+//#region src/blocks/settings/react/server.ts
+/** The `react-server` build of `useSettings`: call `createSettings(...).getUser()` instead. */
+const useSettings = () => {
+	throw new Error("better-supabase: useSettings() runs in Client Components only. In Server Components call `createSettings(...).getUser()` or `.getOrganization(organizationId)` instead.");
+};
+//#endregion
+export { useSettings };

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

@@ -0,0 +1,13 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as SolidController } from "../../../solid-controller-CZrt1Tg6.js";
+import { a as SettingsControllerOptions, l as SettingEntries, o as SettingsSnapshot, r as SettingsActions } from "../../../client-BO9fQgBB.js";
+//#region src/blocks/settings/solid/index.d.ts
+/**
+ * `createSettingsController` 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 useSettings<E extends SettingEntries>(options: BlockOptions<SettingsControllerOptions<E>>): SolidController<SettingsSnapshot<E>, SettingsActions<E>>;
+//#endregion
+export type { BlockOptions, SettingEntries, SettingsActions, SettingsControllerOptions, SettingsSnapshot, SolidController };

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

@@ -0,0 +1,14 @@
+import { t as useBlockController } from "../../../solid-controller-DLsmrczT.js";
+import { t as createSettingsController } from "../../../client-jvtwGFy4.js";
+//#region src/blocks/settings/solid/index.ts
+/**
+* `createSettingsController` 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 useSettings(options) {
+	return useBlockController(createSettingsController, options);
+}
+//#endregion
+export { useSettings };

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

@@ -0,0 +1,13 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as SvelteController } from "../../../svelte-controller-DDbju9CW.js";
+import { a as SettingsControllerOptions, l as SettingEntries, o as SettingsSnapshot, r as SettingsActions } from "../../../client-BO9fQgBB.js";
+//#region src/blocks/settings/svelte/index.d.ts
+/**
+ * `createSettingsController` 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 useSettings<E extends SettingEntries>(options: BlockOptions<SettingsControllerOptions<E>>): SvelteController<SettingsSnapshot<E>, SettingsActions<E>>;
+//#endregion
+export type { BlockOptions, SettingEntries, SettingsActions, SettingsControllerOptions, SettingsSnapshot, SvelteController };

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

@@ -0,0 +1,14 @@
+import { t as useBlockController } from "../../../svelte-controller-CDAujo-_.js";
+import { t as createSettingsController } from "../../../client-jvtwGFy4.js";
+//#region src/blocks/settings/svelte/index.ts
+/**
+* `createSettingsController` 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 useSettings(options) {
+	return useBlockController(createSettingsController, options);
+}
+//#endregion
+export { useSettings };

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

@@ -0,0 +1,13 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as VueController } from "../../../vue-controller-D_ohttBZ.js";
+import { a as SettingsControllerOptions, l as SettingEntries, o as SettingsSnapshot, r as SettingsActions } from "../../../client-BO9fQgBB.js";
+//#region src/blocks/settings/vue/index.d.ts
+/**
+ * `createSettingsController` 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 useSettings<E extends SettingEntries>(options: BlockOptions<SettingsControllerOptions<E>>): VueController<SettingsSnapshot<E>, SettingsActions<E>>;
+//#endregion
+export type { BlockOptions, SettingEntries, SettingsActions, SettingsControllerOptions, SettingsSnapshot, VueController };

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

@@ -0,0 +1,14 @@
+import { t as useBlockController } from "../../../vue-controller-C9tFzqAc.js";
+import { t as createSettingsController } from "../../../client-jvtwGFy4.js";
+//#region src/blocks/settings/vue/index.ts
+/**
+* `createSettingsController` 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 useSettings(options) {
+	return useBlockController(createSettingsController, options);
+}
+//#endregion
+export { useSettings };