better-supabase 0.8.0 → 0.10.0

package/dist/blocks/rules/index.js

@@ -0,0 +1,163 @@
+import { n as dbError } from "../../errors-8i6tSICm.js";
+import { a as ok, r as err } from "../../result-COkvI9t5.js";
+import { t as rulesSqlOptions } from "../../options-ChD15QxJ.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 { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-ByKlh8Qy.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { _ as ruleFilterFieldInfo, a as insertNode, c as removeNode, d as setRuleField, f as setRuleOperator, g as defineRuleFields, h as checkRuleConditions, i as findNode, l as ruleOperators, m as RULE_LIMITS, n as contains, o as moveNode, p as updateNode, r as emptyConditions, s as parentOf, t as createRuleBuilderController, u as setCombinator, v as ruleFilterFields } from "../../client-BGnJ5WJi.js";
+import { a as evaluateRule, i as createRulesAdmin, n as createRuleSink, o as ruleOf, r as createRules, s as ruleRecordFields, t as createRuleDispatcher } from "../../rules-4of_Fq-6.js";
+//#region src/blocks/rules/actions.ts
+function invalid(rule, kind, problem) {
+	return err(dbError("invalid_request", `The rule "${rule.name}" has a ${kind} action ${problem}`, { hint: "RULE_ACTION_INVALID" }));
+}
+function textConfig(config, key) {
+	const value = config?.[key];
+	return typeof value === "string" && value !== "" ? value : void 0;
+}
+/** A key that stays the same when the outbox retries the event. */
+function actionKey(rule, kind, context) {
+	return `rule:${rule.id}:${kind}:${context.eventId ?? `${context.subjectType}/${context.subjectId}`}`;
+}
+/**
+* The `approvals.request` handler: starts an approval of the subject for the
+* action in the rule's `config.action`, such as `{ kind: "approvals.request",
+* config: { action: "manager_review" } }`.
+*/
+function approvalsAction(approvals) {
+	return ({ action, rule, context }) => {
+		const name = action.config?.["action"];
+		if (typeof name !== "string" || name === "") return err(dbError("invalid_request", `The rule "${rule.name}" has an approvals.request action without config.action`, { hint: "RULE_ACTION_INVALID" }));
+		const reason = action.config?.["reason"];
+		return approvals.request({
+			organizationId: context.organizationId,
+			subjectType: context.subjectType,
+			subjectId: context.subjectId,
+			action: name,
+			reason: typeof reason === "string" ? reason : `Rule: ${rule.name}`,
+			...context.payload === void 0 ? {} : { payload: context.payload }
+		});
+	};
+}
+function recipientsOf(config, payload) {
+	const listed = config?.["recipients"];
+	const field = textConfig(config, "recipientField");
+	return [listed, field === void 0 ? void 0 : payload?.[field]].flat().filter((value) => typeof value === "string" && value !== "");
+}
+/**
+* The `notify` handler: sends the notification type in `config.type` to the
+* user ids in `config.recipients` and in the payload column that
+* `config.recipientField` names, with `config.data` and the payload as its
+* data: `{ kind: "notify", config: { type: "task.assigned", recipientField:
+* "assignee_id" } }`.
+*/
+function notifyAction(notifier) {
+	return async ({ action, rule, context }) => {
+		const type = textConfig(action.config, "type");
+		if (type === void 0) return invalid(rule, "notify", "without config.type");
+		const recipients = recipientsOf(action.config, context.payload);
+		if (recipients.length === 0) return invalid(rule, "notify", "without recipients (config.recipients or a filled config.recipientField)");
+		const data = action.config?.["data"];
+		const sent = await notifier.send(type, {
+			recipients,
+			tenant: context.organizationId,
+			key: actionKey(rule, "notify", context),
+			subject: {
+				type: context.subjectType,
+				id: context.subjectId
+			},
+			data: {
+				...context.payload,
+				...typeof data === "object" && data !== null ? data : {},
+				rule: rule.name
+			}
+		});
+		return ok(sent);
+	};
+}
+/**
+* The `set_field` handler: writes `config.value` to the subject's
+* `config.field`: `{ kind: "set_field", config: { field: "status", value:
+* "review" } }`. The setter decides which fields it accepts.
+*/
+function setFieldAction(setField) {
+	return ({ action, rule, context }) => {
+		const field = textConfig(action.config, "field");
+		if (field === void 0) return invalid(rule, "set_field", "without config.field");
+		if (action.config === void 0 || !Object.hasOwn(action.config, "value")) return invalid(rule, "set_field", "without config.value");
+		return setField({
+			organizationId: context.organizationId,
+			subjectType: context.subjectType,
+			subjectId: context.subjectId,
+			field,
+			value: action.config["value"]
+		});
+	};
+}
+/**
+* The `webhook` handler: queues a delivery to the endpoint in
+* `config.endpointId`, typed `config.type` or the rule's trigger, with the
+* payload as its data: `{ kind: "webhook", config: { endpointId: "..." } }`.
+*/
+function webhookAction(webhooks) {
+	return ({ action, rule, context }) => {
+		const endpointId = textConfig(action.config, "endpointId");
+		if (endpointId === void 0) return invalid(rule, "webhook", "without config.endpointId");
+		return webhooks.dispatch({
+			endpointId,
+			type: textConfig(action.config, "type") ?? rule.trigger,
+			data: {
+				subjectType: context.subjectType,
+				subjectId: context.subjectId,
+				...context.payload
+			},
+			...context.eventId === void 0 ? {} : { eventId: context.eventId }
+		});
+	};
+}
+/**
+* The `workflow` handler: starts the workflow definition in
+* `config.definition` on the subject, with the payload as its input:
+* `{ kind: "workflow", config: { definition: "..." } }`. A retried event
+* starts no second run.
+*/
+function workflowAction(workflows) {
+	return ({ action, rule, context }) => {
+		const definition = textConfig(action.config, "definition");
+		if (definition === void 0) return invalid(rule, "workflow", "without config.definition");
+		return workflows.run({
+			definition,
+			input: context.payload ?? {},
+			idempotencyKey: actionKey(rule, "workflow", context),
+			subject: {
+				type: context.subjectType,
+				id: context.subjectId
+			},
+			tenant: context.organizationId
+		});
+	};
+}
+//#endregion
+//#region src/blocks/rules/events.ts
+/** The `rules` block's event types, for its manifest and `onBlockEvent`. */
+const rulesEvents = defineEvents({
+	"rule.saved": event(),
+	"rule.enabled": event(),
+	"rule.disabled": event(),
+	"rule.removed": event(),
+	"rule.matched": event()
+});
+//#endregion
+//#region src/blocks/rules/manifest.ts
+/** The `rules` block's manifest (ADR 0029). */
+const rulesBlock = defineBlock({
+	name: "rules",
+	sql: ["rules"],
+	options: { rules: rulesSqlOptions },
+	events: rulesEvents,
+	create: createRules,
+	category: "automation",
+	recipes: ["rule-builder"]
+});
+//#endregion
+export { RULE_LIMITS, approvalsAction, checkRuleConditions, contains, createRuleBuilderController, createRuleDispatcher, createRuleSink, createRules, createRulesAdmin, dbTransport, defineRuleFields, emptyConditions, evaluateRule, extendBlock, findNode, insertNode, moveNode, notifyAction, parentOf, removeNode, rpcTransport, ruleFilterFieldInfo, ruleFilterFields, ruleOf, ruleOperators, ruleRecordFields, rulesBlock, rulesEvents, setCombinator, setFieldAction, setRuleField, setRuleOperator, sqlTransport, updateNode, webhookAction, withBlockHooks, workflowAction, wrapTransport };

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

@@ -0,0 +1,34 @@
+import { d as FilterLimits, h as FilterQuery } from "../../../filter-query-D3wOD1P_.js";
+import { S as Rules, i as RuleBuilderSnapshot, t as RuleBuilderActions } from "../../../client-BaynD5V-.js";
+//#region src/blocks/rules/react/index.d.ts
+export interface UseRuleBuilderOptions {
+  readonly organizationId: string;
+  /** The rule to edit; `null` edits a new one. */
+  readonly rule: string | null;
+  /** The record type whose fields the rules test. */
+  readonly subjectType: string;
+  /** A new rule's trigger, such as `expense.submitted`. */
+  readonly trigger?: string;
+  /** The tree a new rule starts with. Read once, when the editor starts. */
+  readonly initial?: FilterQuery;
+  /** Node ids the editor may not change. Read once, when the editor starts. */
+  readonly locked?: readonly string[];
+  readonly limits?: FilterLimits;
+  /** The schema the calls go to (default `better_supabase`). */
+  readonly schema?: string;
+}
+export interface RuleBuilderState extends RuleBuilderSnapshot, RuleBuilderActions {
+  /** The rules client for the signed-in user, for lists and toggles. */
+  readonly rules: Rules;
+}
+/**
+ * The editor state of one rule: its fields, its condition tree with the
+ * edits to it, validation, dirty state and save.
+ *
+ * ```tsx
+ * const builder = useRuleBuilder({ organizationId, rule: null, subjectType: "expense" });
+ * builder.addRule(undefined, "amount");
+ * ```
+ */
+export declare function useRuleBuilder(options: UseRuleBuilderOptions): RuleBuilderState;
+//#endregion

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

@@ -0,0 +1,55 @@
+"use client";
+import { r as rpcTransport } from "../../../block-transport-G4t1umrR.js";
+import { n as useLatest, t as useController } from "../../../react-controller-Xn-IU44p.js";
+import { t as useBlockEnv } from "../../../react-env-Cc7Vf6eb.js";
+import { t as createRuleBuilderController } from "../../../client-BGnJ5WJi.js";
+import { r as createRules } from "../../../rules-4of_Fq-6.js";
+import { useMemo } from "react";
+//#region src/blocks/rules/react/index.ts
+/**
+* The editor state of one rule: its fields, its condition tree with the
+* edits to it, validation, dirty state and save.
+*
+* ```tsx
+* const builder = useRuleBuilder({ organizationId, rule: null, subjectType: "expense" });
+* builder.addRule(undefined, "amount");
+* ```
+*/
+function useRuleBuilder(options) {
+	const { supabase, auth } = useBlockEnv();
+	const latest = useLatest(options);
+	const { organizationId, rule, subjectType, trigger, limits, schema } = options;
+	const rules = useMemo(() => createRules({
+		transport: rpcTransport(supabase),
+		...schema === void 0 ? {} : { schema }
+	}), [supabase, schema]);
+	const { view } = useController(() => {
+		const { initial, locked } = latest.current;
+		return createRuleBuilderController({
+			client: rules,
+			auth,
+			organizationId,
+			rule,
+			subjectType,
+			...trigger === void 0 ? {} : { trigger },
+			...initial === void 0 ? {} : { initial },
+			...locked === void 0 ? {} : { locked },
+			...limits === void 0 ? {} : { limits }
+		});
+	}, [
+		rules,
+		auth,
+		latest,
+		organizationId,
+		rule,
+		subjectType,
+		trigger,
+		limits
+	]);
+	return useMemo(() => ({
+		...view,
+		rules
+	}), [view, rules]);
+}
+//#endregion
+export { useRuleBuilder };

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

@@ -0,0 +1,6 @@
+import { RuleBuilderState, UseRuleBuilderOptions } from "./index.js";
+//#region src/blocks/rules/react/server.d.ts
+/** The `react-server` build of `useRuleBuilder`: call `rules.get()` instead. */
+export declare const useRuleBuilder: (options: UseRuleBuilderOptions) => RuleBuilderState;
+//#endregion
+export type { RuleBuilderState, UseRuleBuilderOptions };

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

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

package/dist/blocks/rules/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 { i as RuleBuilderSnapshot, r as RuleBuilderControllerOptions, t as RuleBuilderActions } from "../../../client-BaynD5V-.js";
+//#region src/blocks/rules/solid/index.d.ts
+/**
+ * `createRuleBuilderController` 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 useRuleBuilder(options: BlockOptions<RuleBuilderControllerOptions>): SolidController<RuleBuilderSnapshot, RuleBuilderActions>;
+//#endregion
+export type { BlockOptions, RuleBuilderActions, RuleBuilderControllerOptions, RuleBuilderSnapshot, SolidController };

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

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

package/dist/blocks/rules/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 { i as RuleBuilderSnapshot, r as RuleBuilderControllerOptions, t as RuleBuilderActions } from "../../../client-BaynD5V-.js";
+//#region src/blocks/rules/svelte/index.d.ts
+/**
+ * `createRuleBuilderController` 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 useRuleBuilder(options: BlockOptions<RuleBuilderControllerOptions>): SvelteController<RuleBuilderSnapshot, RuleBuilderActions>;
+//#endregion
+export type { BlockOptions, RuleBuilderActions, RuleBuilderControllerOptions, RuleBuilderSnapshot, SvelteController };

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

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

package/dist/blocks/rules/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 { i as RuleBuilderSnapshot, r as RuleBuilderControllerOptions, t as RuleBuilderActions } from "../../../client-BaynD5V-.js";
+//#region src/blocks/rules/vue/index.d.ts
+/**
+ * `createRuleBuilderController` 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 useRuleBuilder(options: BlockOptions<RuleBuilderControllerOptions>): VueController<RuleBuilderSnapshot, RuleBuilderActions>;
+//#endregion
+export type { BlockOptions, RuleBuilderActions, RuleBuilderControllerOptions, RuleBuilderSnapshot, VueController };

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

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

package/dist/blocks/saved-views/index.d.ts

@@ -0,0 +1,17 @@
+import { $ as SaasEventData, wt as Events } from "../../events-CtAHxPal.js";
+import { s as BlockOf } from "../../define-block-BlHQxDIQ.js";
+import { A as SavedViewRef, C as SavedViewColumns, D as SavedViewList, E as SavedViewKind, F as createSavedViews, I as defaultView, L as savedViewIssues, M as SavedViewState, N as SavedViews, O as SavedViewPreference, P as SavedViewsOptions, R as savedViewStateSchema, S as SavedView, T as SavedViewDisplayState, _ as DuplicateViewInput, a as SavedViewsMatch, b as SAVED_VIEW_SCOPES, c as createSavedViewsController, d as displayStateOf, f as queryFromUrlState, g as DefaultViewCandidate, h as urlStateFromQuery, i as SavedViewsControllerOptions, j as SavedViewScope, k as SavedViewPreferenceInput, l as matchSavedViews, m as sameQuery, n as SavedViewsActions, o as SavedViewsSnapshot, p as sameDisplayState, r as SavedViewsController, s as SavedViewsSyncOptions, t as SavedViewLike, u as ListUrlState, v as SAVED_VIEW_DENSITIES, w as SavedViewDensity, x as SaveViewInput, y as SAVED_VIEW_KINDS } from "../../client-C597NIlL.js";
+//#region src/blocks/saved-views/events.d.ts
+/** The events of the `saved-views` block: type to data. */
+type SavedViewsEvents = {
+  readonly "saved_view.saved": SaasEventData;
+  readonly "saved_view.deleted": SaasEventData;
+};
+/** The `saved-views` block's event types, for its manifest and `onBlockEvent`. */
+export declare const savedViewsEvents: Events<SavedViewsEvents>;
+//#endregion
+//#region src/blocks/saved-views/manifest.d.ts
+/** The `saved-views` block's manifest (ADR 0029). */
+export declare const savedViewsBlock: BlockOf<"saved-views", typeof createSavedViews, SavedViewsEvents>;
+//#endregion
+export { type DefaultViewCandidate, type DuplicateViewInput, type ListUrlState, SAVED_VIEW_DENSITIES, SAVED_VIEW_KINDS, SAVED_VIEW_SCOPES, type SaveViewInput, type SavedView, type SavedViewColumns, type SavedViewDensity, type SavedViewDisplayState, type SavedViewKind, type SavedViewLike, type SavedViewList, type SavedViewPreference, type SavedViewPreferenceInput, type SavedViewRef, type SavedViewScope, type SavedViewState, type SavedViews, type SavedViewsActions, type SavedViewsController, type SavedViewsControllerOptions, type SavedViewsEvents, type SavedViewsMatch, type SavedViewsOptions, type SavedViewsSnapshot, type SavedViewsSyncOptions, createSavedViews, createSavedViewsController, defaultView, displayStateOf, matchSavedViews, queryFromUrlState, sameDisplayState, sameQuery, savedViewIssues, savedViewStateSchema, urlStateFromQuery };

package/dist/blocks/saved-views/index.js

@@ -0,0 +1,29 @@
+import { t as savedViewsSqlOptions } from "../../options-B5woz53h.js";
+import { n as event, t as defineEvents } from "../../event-map-Dy2vKHai.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { a as sameDisplayState, c as SAVED_VIEW_DENSITIES, d as createSavedViews, f as defaultView, i as queryFromUrlState, l as SAVED_VIEW_KINDS, m as savedViewStateSchema, n as matchSavedViews, o as sameQuery, p as savedViewIssues, r as displayStateOf, s as urlStateFromQuery, t as createSavedViewsController, u as SAVED_VIEW_SCOPES } from "../../client-CmHsfDHU.js";
+//#region src/blocks/saved-views/events.ts
+/** The `saved-views` block's event types, for its manifest and `onBlockEvent`. */
+const savedViewsEvents = defineEvents({
+	"saved_view.saved": event(),
+	"saved_view.deleted": event()
+});
+//#endregion
+//#region src/blocks/saved-views/manifest.ts
+/** The `saved-views` block's manifest (ADR 0029). */
+const savedViewsBlock = defineBlock({
+	name: "saved-views",
+	sql: ["saved-views"],
+	options: { "saved-views": savedViewsSqlOptions },
+	events: savedViewsEvents,
+	create: createSavedViews,
+	client: "saved-views",
+	category: "work",
+	recipes: [
+		"record-form",
+		"record-grid",
+		"work-item-grid"
+	]
+});
+//#endregion
+export { SAVED_VIEW_DENSITIES, SAVED_VIEW_KINDS, SAVED_VIEW_SCOPES, createSavedViews, createSavedViewsController, defaultView, displayStateOf, matchSavedViews, queryFromUrlState, sameDisplayState, sameQuery, savedViewIssues, savedViewStateSchema, savedViewsBlock, savedViewsEvents, urlStateFromQuery };

package/dist/blocks/saved-views/react/index.d.ts

@@ -0,0 +1,34 @@
+import { a as SavedViewsMatch, n as SavedViewsActions, s as SavedViewsSyncOptions, t as SavedViewLike, u as ListUrlState } from "../../../client-C597NIlL.js";
+//#region src/blocks/saved-views/react/index.d.ts
+export interface UseSavedViewsOptions<V extends SavedViewLike> extends SavedViewsSyncOptions<V> {
+  /** The list's URL state: the values of 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;
+}
+export interface SavedViewsState<V extends SavedViewLike> extends SavedViewsMatch<V>, SavedViewsActions<V> {
+  /** `undefined` until the first load. */
+  readonly views: readonly V[] | undefined;
+  readonly error: unknown;
+}
+/**
+ * Saved views of one list, synced with its URL state and, through
+ * `getState` and `onApplyState`, with the table's columns, grouping, density
+ * and layout. Pair it with nuqs and a view menu (ReUI's Filters toolbar, a
+ * Select or a Tabs list):
+ *
+ * ```tsx
+ * const [urlState, setUrlState] = useQueryStates(tasksList.nuqs(createParser));
+ * const views = useSavedViews({
+ *   load: () => listViews(organizationId, "tasks"),
+ *   save: ({ name, state, id }) => saveView({ organizationId, list: "tasks", name, state, id }),
+ *   urlState,
+ *   setUrlState,
+ *   getState: () => ({ columns, density }),
+ *   onApplyState: (state) => showState(state),
+ * });
+ * ```
+ */
+export declare function useSavedViews<V extends SavedViewLike>(options: UseSavedViewsOptions<V>): SavedViewsState<V>;
+//#endregion
+export type { SavedViewLike };

package/dist/blocks/saved-views/react/index.js

@@ -0,0 +1,57 @@
+"use client";
+import { n as useLatest, t as useController } from "../../../react-controller-Xn-IU44p.js";
+import { n as matchSavedViews, t as createSavedViewsController } from "../../../client-CmHsfDHU.js";
+//#region src/blocks/saved-views/react/index.ts
+/**
+* Saved views of one list, synced with its URL state and, through
+* `getState` and `onApplyState`, with the table's columns, grouping, density
+* and layout. Pair it with nuqs and a view menu (ReUI's Filters toolbar, a
+* Select or a Tabs list):
+*
+* ```tsx
+* const [urlState, setUrlState] = useQueryStates(tasksList.nuqs(createParser));
+* const views = useSavedViews({
+*   load: () => listViews(organizationId, "tasks"),
+*   save: ({ name, state, id }) => saveView({ organizationId, list: "tasks", name, state, id }),
+*   urlState,
+*   setUrlState,
+*   getState: () => ({ columns, density }),
+*   onApplyState: (state) => showState(state),
+* });
+* ```
+*/
+function useSavedViews(options) {
+	const latest = useLatest(options);
+	const { view } = useController(() => createSavedViewsController({
+		load: () => latest.current.load(),
+		urlState: () => latest.current.urlState,
+		setUrlState: (next) => latest.current.setUrlState(next),
+		getState: () => latest.current.getState?.() ?? {},
+		onApplyState: (state, applied) => {
+			latest.current.onApplyState?.(state, applied);
+		},
+		save: (input) => needs(latest.current.save, "save")(input),
+		remove: (id) => needs(latest.current.remove, "remove")(id),
+		duplicate: (input) => needs(latest.current.duplicate, "duplicate")(input),
+		setPreference: (id, preference) => needs(latest.current.setPreference, "setPreference")(id, preference),
+		openDefault: options.openDefault !== false
+	}), [latest]);
+	const match = matchSavedViews(view, options.urlState, options.getState?.());
+	return {
+		views: view.views,
+		error: view.error,
+		...match,
+		apply: view.apply,
+		saveCurrent: view.saveCurrent,
+		remove: view.remove,
+		duplicate: view.duplicate,
+		setPreference: view.setPreference,
+		refresh: view.refresh
+	};
+}
+function needs(value, name) {
+	if (value === void 0) throw new Error(`useSavedViews: pass \`${name}\``);
+	return value;
+}
+//#endregion
+export { useSavedViews };

package/dist/blocks/saved-views/react/server.d.ts

@@ -0,0 +1,7 @@
+import { t as SavedViewLike } from "../../../client-C597NIlL.js";
+import { SavedViewsState, UseSavedViewsOptions } from "./index.js";
+//#region src/blocks/saved-views/react/server.d.ts
+/** The `react-server` build of `useSavedViews`: call `savedViews.list()` instead. */
+export declare const useSavedViews: <V extends SavedViewLike>(options: UseSavedViewsOptions<V>) => SavedViewsState<V>;
+//#endregion
+export type { SavedViewLike, SavedViewsState, UseSavedViewsOptions };

package/dist/blocks/saved-views/react/server.js

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

package/dist/blocks/saved-views/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 { i as SavedViewsControllerOptions, n as SavedViewsActions, o as SavedViewsSnapshot, t as SavedViewLike } from "../../../client-C597NIlL.js";
+//#region src/blocks/saved-views/solid/index.d.ts
+/**
+ * `createSavedViewsController` 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 useSavedViews<V extends SavedViewLike>(options: BlockOptions<SavedViewsControllerOptions<V>>): SolidController<SavedViewsSnapshot<V>, SavedViewsActions<V>>;
+//#endregion
+export type { BlockOptions, SavedViewLike, SavedViewsActions, SavedViewsControllerOptions, SavedViewsSnapshot, SolidController };

package/dist/blocks/saved-views/solid/index.js

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

package/dist/blocks/saved-views/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 { i as SavedViewsControllerOptions, n as SavedViewsActions, o as SavedViewsSnapshot, t as SavedViewLike } from "../../../client-C597NIlL.js";
+//#region src/blocks/saved-views/svelte/index.d.ts
+/**
+ * `createSavedViewsController` 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 useSavedViews<V extends SavedViewLike>(options: BlockOptions<SavedViewsControllerOptions<V>>): SvelteController<SavedViewsSnapshot<V>, SavedViewsActions<V>>;
+//#endregion
+export type { BlockOptions, SavedViewLike, SavedViewsActions, SavedViewsControllerOptions, SavedViewsSnapshot, SvelteController };

package/dist/blocks/saved-views/svelte/index.js

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

package/dist/blocks/saved-views/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 { i as SavedViewsControllerOptions, n as SavedViewsActions, o as SavedViewsSnapshot, t as SavedViewLike } from "../../../client-C597NIlL.js";
+//#region src/blocks/saved-views/vue/index.d.ts
+/**
+ * `createSavedViewsController` 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 useSavedViews<V extends SavedViewLike>(options: BlockOptions<SavedViewsControllerOptions<V>>): VueController<SavedViewsSnapshot<V>, SavedViewsActions<V>>;
+//#endregion
+export type { BlockOptions, SavedViewLike, SavedViewsActions, SavedViewsControllerOptions, SavedViewsSnapshot, VueController };

package/dist/blocks/saved-views/vue/index.js

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