better-supabase 0.7.1 → 0.9.0

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

@@ -0,0 +1,103 @@
+import { t as AsyncResult } from "../../result-Cj3yWhjH.js";
+import { wt as Events } from "../../events-CTreRrgP.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DaGGXjIw.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-BLPWD3Jt.js";
+import { _ as FilterRule, f as FilterNode, h as FilterQuery, i as FilterCombinator, m as FilterOperatorSpec } from "../../filter-query-BKmRYrTE.js";
+import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
+import { o as ApprovalRequestInput } from "../../approvals-a2KmioBh.js";
+import { A as RuleField, C as createRuleDispatcher, D as ruleOf, E as evaluateRule, F as ruleFilterFieldInfo, I as ruleFilterFields, M as RuleFieldDefinition, N as checkRuleConditions, O as ruleRecordFields, P as defineRuleFields, S as RulesOptions, T as createRulesAdmin, _ as RuleSubject, a as createRuleBuilderController, b as RulesAdmin, c as RuleActionCall, d as RuleDispatcher, f as RuleDispatcherOptions, g as RuleMatch, h as RuleListOptions, i as RuleBuilderSnapshot, j as RuleFieldCatalog, k as RULE_LIMITS, l as RuleActionHandler, m as RuleInput, n as RuleBuilderController, o as Rule, p as RuleEvaluationEntry, r as RuleBuilderControllerOptions, s as RuleAction, t as RuleBuilderActions, u as RuleActionOutcome, v as RuleVersion, w as createRules, x as RulesAdminOptions, y as Rules } from "../../client-Tc47rlSe.js";
+//#region src/blocks/rules/tree.d.ts
+/** The operators a field allows, in the order the editor lists them. */
+export declare function ruleOperators(field: RuleField): readonly FilterOperatorSpec[];
+/** An empty `and` group, the tree a new rule starts with. */
+export declare const emptyConditions: (id?: string) => FilterQuery;
+/** The node with `id`, or `undefined`. */
+export declare function findNode(tree: FilterNode, id: string): FilterNode | undefined;
+/** The group that holds `id`, or `undefined` for the root and unknown ids. */
+export declare function parentOf(tree: FilterQuery, id: string): FilterQuery | undefined;
+/** Whether `id` is `ancestor` or sits anywhere under it. */
+export declare function contains(ancestor: FilterNode, id: string): boolean;
+/** Replaces the node with `id` by what `change` returns. */
+export declare function updateNode(tree: FilterQuery, id: string, change: (node: FilterNode) => FilterNode): FilterQuery;
+/** Drops the node with `id` and everything under it; the root stays. */
+export declare function removeNode(tree: FilterQuery, id: string): FilterQuery;
+/**
+ * Adds `node` to the group `parent` at `index` (the end by default).
+ * Unchanged when `parent` isn't a group in the tree.
+ */
+export declare function insertNode(tree: FilterQuery, parent: string, node: FilterNode, index?: number): FilterQuery;
+/**
+ * Moves the node with `id` into the group `parent`, where it ends up at
+ * `index` (as `arrayMove` counts it). Unchanged for the root, an unknown
+ * node or group, or a move into the node itself.
+ */
+export declare function moveNode(tree: FilterQuery, id: string, parent: string, index: number): FilterQuery;
+/** Changes a group's `and` or `or`. */
+export declare function setCombinator(tree: FilterQuery, id: string, combinator: FilterCombinator): FilterQuery;
+/**
+ * Points a rule at another field. A field of the same type keeps the
+ * operator it allows, and its value; another type starts at the field's
+ * first operator without a value.
+ */
+export declare function setRuleField(rule: FilterRule, field: RuleField, previous: RuleField | undefined): FilterRule;
+/**
+ * Changes a rule's operator. The value stays when the new operator takes
+ * the same kind of value (one, many or a range), and is dropped otherwise.
+ */
+export declare function setRuleOperator(rule: FilterRule, operator: string, field: RuleField | undefined): FilterRule;
+//#endregion
+//#region src/blocks/rules/actions.d.ts
+/** The context `dispatch` passes when rules start approvals or other subject work. */
+interface RuleSubjectContext {
+  readonly organizationId: string;
+  readonly subjectType: string;
+  readonly subjectId: string;
+  /** Passed on to the approval request, such as the expense amount. */
+  readonly payload?: Readonly<Record<string, unknown>>;
+}
+/** The part of the approvals client the handler calls. */
+interface RuleApprovals {
+  request(input: ApprovalRequestInput): AsyncResult<unknown>;
+}
+/**
+ * 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" } }`.
+ */
+export declare function approvalsAction(approvals: RuleApprovals): RuleActionHandler<RuleSubjectContext>;
+//#endregion
+//#region src/blocks/rules/events.d.ts
+/** `rule.saved`, `rule.enabled`, `rule.disabled` and `rule.removed`. */
+interface RuleEventData {
+  readonly organizationId: string;
+  readonly ruleId: string;
+  readonly name: string;
+  readonly subjectType: string;
+  readonly trigger: string;
+  readonly version: number;
+}
+/** `rule.matched`: a live evaluation matched a subject. */
+interface RuleMatchedEventData {
+  readonly organizationId: string;
+  readonly ruleId: string;
+  readonly version: number;
+  readonly subjectType: string;
+  readonly subjectId: string;
+  readonly trigger: string;
+}
+/** The events of the `rules` block: type to data. */
+type RulesEvents = {
+  readonly "rule.saved": RuleEventData;
+  readonly "rule.enabled": RuleEventData;
+  readonly "rule.disabled": RuleEventData;
+  readonly "rule.removed": RuleEventData;
+  readonly "rule.matched": RuleMatchedEventData;
+};
+/** The `rules` block's event types, for its manifest and `onBlockEvent`. */
+export declare const rulesEvents: Events<RulesEvents>;
+//#endregion
+//#region src/blocks/rules/manifest.d.ts
+/** The `rules` block's manifest (ADR 0029). */
+export declare const rulesBlock: BlockOf<"rules", typeof createRules, RulesEvents>;
+//#endregion
+export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, RULE_LIMITS, type RpcClient, type Rule, type RuleAction, type RuleActionCall, type RuleActionHandler, type RuleActionOutcome, type RuleApprovals, type RuleBuilderActions, type RuleBuilderController, type RuleBuilderControllerOptions, type RuleBuilderSnapshot, type RuleDispatcher, type RuleDispatcherOptions, type RuleEvaluationEntry, type RuleEventData, type RuleField, type RuleFieldCatalog, type RuleFieldDefinition, type RuleInput, type RuleListOptions, type RuleMatch, type RuleMatchedEventData, type RuleSubject, type RuleSubjectContext, type RuleVersion, type Rules, type RulesAdmin, type RulesAdminOptions, type RulesEvents, type RulesOptions, checkRuleConditions, createRuleBuilderController, createRuleDispatcher, createRules, createRulesAdmin, dbTransport, defineRuleFields, evaluateRule, extendBlock, rpcTransport, ruleFilterFieldInfo, ruleFilterFields, ruleOf, ruleRecordFields, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/rules/index.js

@@ -0,0 +1,54 @@
+import { n as dbError } from "../../errors-8i6tSICm.js";
+import { r as err } from "../../result-BlgnMB0H.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-BsXncUlZ.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-b2_GjzzD.js";
+import { a as ruleOf, i as evaluateRule, n as createRules, o as ruleRecordFields, r as createRulesAdmin, t as createRuleDispatcher } from "../../rules-B0-3Iosu.js";
+import { t as rulesSqlOptions } from "../../options-ChD15QxJ.js";
+//#region src/blocks/rules/actions.ts
+/**
+* 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 }
+		});
+	};
+}
+//#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, createRules, createRulesAdmin, dbTransport, defineRuleFields, emptyConditions, evaluateRule, extendBlock, findNode, insertNode, moveNode, parentOf, removeNode, rpcTransport, ruleFilterFieldInfo, ruleFilterFields, ruleOf, ruleOperators, ruleRecordFields, rulesBlock, rulesEvents, setCombinator, setRuleField, setRuleOperator, sqlTransport, updateNode, withBlockHooks, wrapTransport };

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

@@ -0,0 +1,34 @@
+import { d as FilterLimits, h as FilterQuery } from "../../../filter-query-BKmRYrTE.js";
+import { i as RuleBuilderSnapshot, t as RuleBuilderActions, y as Rules } from "../../../client-Tc47rlSe.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-b2_GjzzD.js";
+import { n as createRules } from "../../../rules-B0-3Iosu.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-DqlvYFZa.js";
+import { i as RuleBuilderSnapshot, r as RuleBuilderControllerOptions, t as RuleBuilderActions } from "../../../client-Tc47rlSe.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-b2_GjzzD.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-DxxHEHxD.js";
+import { i as RuleBuilderSnapshot, r as RuleBuilderControllerOptions, t as RuleBuilderActions } from "../../../client-Tc47rlSe.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-b2_GjzzD.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-HPfMTDa2.js";
+import { i as RuleBuilderSnapshot, r as RuleBuilderControllerOptions, t as RuleBuilderActions } from "../../../client-Tc47rlSe.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-b2_GjzzD.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-CTreRrgP.js";
+import { s as BlockOf } from "../../define-block-CLZMEFeK.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-CFdMJ1h9.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 { 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-Cdedx_lw.js";
+import { t as savedViewsSqlOptions } from "../../options-B5woz53h.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-CFdMJ1h9.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-Cdedx_lw.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-CFdMJ1h9.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-DqlvYFZa.js";
+import { i as SavedViewsControllerOptions, n as SavedViewsActions, o as SavedViewsSnapshot, t as SavedViewLike } from "../../../client-CFdMJ1h9.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-Cdedx_lw.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-DxxHEHxD.js";
+import { i as SavedViewsControllerOptions, n as SavedViewsActions, o as SavedViewsSnapshot, t as SavedViewLike } from "../../../client-CFdMJ1h9.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-Cdedx_lw.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-HPfMTDa2.js";
+import { i as SavedViewsControllerOptions, n as SavedViewsActions, o as SavedViewsSnapshot, t as SavedViewLike } from "../../../client-CFdMJ1h9.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-Cdedx_lw.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 };