better-supabase 0.8.0 → 0.9.0

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 };

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

@@ -0,0 +1,31 @@
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DaGGXjIw.js";
+import { i as EventSink } from "../../cloud-event-5rCEzIgK.js";
+import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
+import { _ as createSearch, a as createCommandSearchController, d as Search, f as SearchHit, g as SearchUserItem, h as SearchQuery, i as CommandSearchSnapshot, l as Embedder, m as SearchOptions, n as CommandSearchController, p as SearchListOptions, r as CommandSearchOptions, t as CommandSearchActions, u as PendingEmbedding } from "../../client-ClZ0D-if.js";
+//#region src/blocks/search/sink.d.ts
+/** What an event does to the index. */
+type SearchSinkAction = "remove" | "refresh";
+/**
+ * The events a soft-delete block emits, as `searchSink` handles them by
+ * default: trashing or purging drops the subject, restoring reads it again.
+ */
+export declare const SEARCH_SINK_DEFAULTS: Readonly<Record<string, SearchSinkAction>>;
+interface SearchSinkOptions {
+  /** Event type (without `typePrefix`) to its action. Default `SEARCH_SINK_DEFAULTS`. */
+  readonly on?: Readonly<Record<string, SearchSinkAction | undefined>>;
+  /** Stripped from each event type. Defaults to `dev.better-supabase`. */
+  readonly typePrefix?: string;
+}
+/**
+ * An outbox sink that keeps the index in step with soft deletes the
+ * registry's `deletedAt` column doesn't describe, such as a trash table:
+ * `outbox.relay('search', searchSink(search))`. Build `search` with a
+ * service transport. A subject type without a `search` entry is skipped.
+ */
+export declare function searchSink(search: Pick<Search, "remove" | "refresh">, options?: SearchSinkOptions): EventSink;
+//#endregion
+//#region src/blocks/search/manifest.d.ts
+/** The `search` block's manifest (ADR 0029). */
+export declare const searchBlock: BlockOf<"search", typeof createSearch, Record<never, never>, Record<never, never>, "sink">;
+//#endregion
+export { type BlockTransport, type CommandSearchActions, type CommandSearchController, type CommandSearchOptions, type CommandSearchSnapshot, type Embedder, type PendingEmbedding, type Search, type SearchHit, type SearchListOptions, type SearchOptions, type SearchQuery, type SearchSinkAction, type SearchSinkOptions, type SearchUserItem, createCommandSearchController, createSearch, dbTransport, rpcTransport, sqlTransport };

package/dist/blocks/search/index.js

@@ -0,0 +1,61 @@
+import { n as isRecord } from "../../guards-6F2bCtQR.js";
+import { a as stripTypePrefix } from "../../cloud-event-CTh9Sr5w.js";
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-G4t1umrR.js";
+import { C as optionalText } from "../../block-helpers-CfG_MvDR.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { t as createSearch } from "../../search-B6h03cAx.js";
+import { t as createCommandSearchController } from "../../client-BfgwocyT.js";
+import { t as searchSqlOptions } from "../../options-DYBQ973I.js";
+//#region src/blocks/search/sink.ts
+/**
+* The events a soft-delete block emits, as `searchSink` handles them by
+* default: trashing or purging drops the subject, restoring reads it again.
+*/
+const SEARCH_SINK_DEFAULTS = {
+	"subject.trashed": "remove",
+	"subject.purged": "remove",
+	"subject.restored": "refresh"
+};
+function subjectOf(event) {
+	if (!isRecord(event.data)) return;
+	const type = optionalText(event.data["subjectType"]);
+	const id = optionalText(event.data["subjectId"]);
+	return type === void 0 || id === void 0 ? void 0 : {
+		type,
+		id
+	};
+}
+/**
+* An outbox sink that keeps the index in step with soft deletes the
+* registry's `deletedAt` column doesn't describe, such as a trash table:
+* `outbox.relay('search', searchSink(search))`. Build `search` with a
+* service transport. A subject type without a `search` entry is skipped.
+*/
+function searchSink(search, options = {}) {
+	const actions = options.on ?? SEARCH_SINK_DEFAULTS;
+	return { async send(events) {
+		for (const event of events) {
+			const action = actions[stripTypePrefix(event.type, options.typePrefix)];
+			if (action === void 0) continue;
+			const subject = subjectOf(event);
+			if (subject === void 0) continue;
+			const result = action === "remove" ? await search.remove(subject.type, subject.id) : await search.refresh(subject.type, subject.id);
+			if (!result.ok && result.error.hint !== "SEARCH_SUBJECT_UNKNOWN") throw new Error(`searchSink: ${action} ${subject.type}/${subject.id} failed: ${result.error.message}`);
+		}
+	} };
+}
+//#endregion
+//#region src/blocks/search/manifest.ts
+/** The `search` block's manifest (ADR 0029). */
+const searchBlock = defineBlock({
+	name: "search",
+	sql: ["search"],
+	options: { search: searchSqlOptions },
+	provides: { sink: (client) => searchSink(client) },
+	create: createSearch,
+	client: "search",
+	category: "work",
+	recipes: ["command-search"]
+});
+//#endregion
+export { SEARCH_SINK_DEFAULTS, createCommandSearchController, createSearch, dbTransport, rpcTransport, searchBlock, searchSink, sqlTransport };

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

@@ -0,0 +1,36 @@
+import { c as groupHits, i as CommandSearchSnapshot, o as CommandSearchGroup, s as CommandSearchItem, t as CommandSearchActions } from "../../../client-ClZ0D-if.js";
+//#region src/blocks/search/react/index.d.ts
+export interface UseCommandSearchOptions {
+  /** One tenant. Default: every tenant the caller can read. */
+  readonly organizationId?: string | null;
+  readonly types?: readonly string[];
+  /** Results per query. Default 20. */
+  readonly limit?: number;
+  /** Recents and favorites shown before the user types. Default 5. */
+  readonly listLimit?: number;
+  /** Milliseconds between the last keystroke and the query. Default 150. */
+  readonly debounceMs?: number;
+  /**
+   * Toggles the dialog on Cmd+K and Ctrl+K through the client's keyboard
+   * port (`webKeyboard()` on the web; none on React Native). Default true.
+   */
+  readonly shortcut?: boolean;
+  /** 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 CommandSearchState extends CommandSearchSnapshot, CommandSearchActions {}
+/**
+ * State for a Cmd+K dialog over the `search` module: a debounced query that
+ * ignores stale responses, favorites and recents for an empty query, and
+ * `select` that records the open. Render it with any command palette.
+ *
+ * ```tsx
+ * const search = useCommandSearch({ organizationId });
+ * <CommandDialog open={search.open} onOpenChange={search.setOpen}>
+ *   <CommandInput value={search.query} onValueChange={search.setQuery} />
+ * </CommandDialog>
+ * ```
+ */
+export declare function useCommandSearch(options?: UseCommandSearchOptions): CommandSearchState;
+//#endregion
+export { type CommandSearchGroup, type CommandSearchItem, groupHits };

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

@@ -0,0 +1,49 @@
+"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 createSearch } from "../../../search-B6h03cAx.js";
+import { t as groupHits } from "../../../groups-CxonH3u5.js";
+import { t as createCommandSearchController } from "../../../client-BfgwocyT.js";
+//#region src/blocks/search/react/index.ts
+/**
+* State for a Cmd+K dialog over the `search` module: a debounced query that
+* ignores stale responses, favorites and recents for an empty query, and
+* `select` that records the open. Render it with any command palette.
+*
+* ```tsx
+* const search = useCommandSearch({ organizationId });
+* <CommandDialog open={search.open} onOpenChange={search.setOpen}>
+*   <CommandInput value={search.query} onValueChange={search.setQuery} />
+* </CommandDialog>
+* ```
+*/
+function useCommandSearch(options = {}) {
+	const { supabase, ports } = useBlockEnv();
+	const { schema, organizationId, limit, listLimit, debounceMs } = options;
+	const keyboard = options.shortcut ?? true ? ports.keyboard : void 0;
+	const typesKey = options.types?.join("\0") ?? null;
+	return useController(() => createCommandSearchController({
+		client: createSearch({
+			transport: rpcTransport(supabase),
+			...schema === void 0 ? {} : { schema }
+		}),
+		...keyboard === void 0 ? {} : { keyboard },
+		organizationId: organizationId ?? null,
+		...typesKey === null ? {} : { types: typesKey.split("\0") },
+		...limit === void 0 ? {} : { limit },
+		...listLimit === void 0 ? {} : { listLimit },
+		...debounceMs === void 0 ? {} : { debounceMs }
+	}), [
+		supabase,
+		schema,
+		keyboard,
+		organizationId,
+		typesKey,
+		limit,
+		listLimit,
+		debounceMs
+	]).view;
+}
+//#endregion
+export { groupHits, useCommandSearch };

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

@@ -0,0 +1,7 @@
+import { c as groupHits, o as CommandSearchGroup, s as CommandSearchItem } from "../../../client-ClZ0D-if.js";
+import { CommandSearchState, UseCommandSearchOptions } from "./index.js";
+//#region src/blocks/search/react/server.d.ts
+/** The `react-server` build of `useCommandSearch`: call `search.search()` instead. */
+export declare const useCommandSearch: (options?: UseCommandSearchOptions) => CommandSearchState;
+//#endregion
+export { type CommandSearchGroup, type CommandSearchItem, type CommandSearchState, type UseCommandSearchOptions, groupHits };

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

@@ -0,0 +1,8 @@
+import { t as groupHits } from "../../../groups-CxonH3u5.js";
+//#region src/blocks/search/react/server.ts
+/** The `react-server` build of `useCommandSearch`: call `search.search()` instead. */
+const useCommandSearch = () => {
+	throw new Error("better-supabase: useCommandSearch() runs in Client Components only. In Server Components call `search.search()` instead.");
+};
+//#endregion
+export { groupHits, useCommandSearch };

package/dist/blocks/search/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 CommandSearchSnapshot, r as CommandSearchOptions, t as CommandSearchActions } from "../../../client-ClZ0D-if.js";
+//#region src/blocks/search/solid/index.d.ts
+/**
+ * `createCommandSearchController` 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 useCommandSearch(options: BlockOptions<CommandSearchOptions>): SolidController<CommandSearchSnapshot, CommandSearchActions>;
+//#endregion
+export type { BlockOptions, CommandSearchActions, CommandSearchOptions, CommandSearchSnapshot, SolidController };