better-supabase 0.12.0 → 0.14.0

package/dist/solid/index.d.ts

@@ -1,38 +1,68 @@
-import { b as DbError } from "../result-BREt7qOh.js";
-import { O as TemplateValues } from "../bucket-BbePDVwc.js";
-import { at as QuerySpec } from "../define-DYZnvAbs.js";
-import { g as TopicHandlers, m as Topic, p as SubscriptionStatus, r as PresenceMember, t as EventSchemas } from "../topic-DAY_HOX2.js";
-import { t as AuthSnapshot } from "../bind-Bfo40o63.js";
-import { t as AuthSession } from "../view-KQhe6eNc.js";
-import { a as BroadcastOptions, c as LiveCountHookOptions, d as PresenceHookOptions, f as PresenceTopic, i as ActionState, l as LiveCountSource, m as UseActionOptions, n as ActionInputOf, o as ClaimsOf, p as ProfileOf, r as ActionResultOf, s as ClientLike, t as fieldErrorsOf, u as LiveQueryHookOptions } from "../field-errors-Z-sgsdoN.js";
-import { t as SupportView } from "../support-view-Bj_lZ8Wr.js";
+import { b as DbError } from "../result-C6jDfedy.js";
+import { Ct as Events, D as BlockEventPattern, T as BlockEvent, bt as EventMap, k as BlockEventsMatching } from "../events-DbLjvxDX.js";
+import { J as QuerySpec } from "../define-Dw7pRO4h.js";
+import { $ as TemplateValues } from "../bucket-TkB7_xv8.js";
+import { g as TopicHandlers, m as Topic, p as SubscriptionStatus, r as PresenceMember, t as EventSchemas } from "../topic-D9j8G2dw.js";
+import { t as AuthSnapshot } from "../bind-Dz8y3T5T.js";
+import { t as AuthSession } from "../view-2_I-2ukO.js";
+import { _ as LiveQueryHookOptions, a as BlockQueryActions, b as ProfileOf, c as BlockRefetchOn, d as ActionState, f as BroadcastOptions, g as LiveCountSource, h as LiveCountHookOptions, i as BlockMutationState, l as ActionInputOf, m as ClientLike, n as BlockEventSource, o as BlockQueryOptions, p as ClaimsOf, r as BlockMutationActions, s as BlockQueryState, t as fieldErrorsOf, u as ActionResultOf, v as PresenceHookOptions, x as UseActionOptions, y as PresenceTopic } from "../field-errors-vshYTVKr.js";
+import { t as SolidController } from "../solid-bind-C1jeq4Qm.js";
+import { i as BlockMethodName, n as BlockDataOf, t as BlockArgsOf } from "../block-method-hsPAGFi5.js";
+import { t as SupportView } from "../support-view-vwJbRMpV.js";
 import { SupabaseClient } from "@supabase/supabase-js";
 import { Accessor, JSX } from "solid-js";
 import { QueryClient } from "@tanstack/query-core";
+//#region src/solid/block-hooks.d.ts
+/**
+ * Calls a read method of any block client (`blocks.tasks.list`, renamed or not)
+ * from mount. `refetchOn` calls it again on block events.
+ */
+export declare function useBlockQuery<C extends object, const K extends BlockMethodName<C>>(client: C, method: K, args: BlockArgsOf<C, K>, options?: BlockQueryOptions): SolidController<BlockQueryState<BlockDataOf<C, K>>, BlockQueryActions>;
+/** Calls a write method of any block client and tracks its state. */
+export declare function useBlockMutation<C extends object, const K extends BlockMethodName<C>>(client: C, method: K): SolidController<BlockMutationState<BlockDataOf<C, K>>, BlockMutationActions<BlockArgsOf<C, K>, BlockDataOf<C, K>>>;
+/**
+ * Calls `handler` for each block event matching `pattern` (`"task.*"`), typed
+ * by `events` (`blockEvents` from `blocks.generated.ts`), from mount until the
+ * component goes away. `source` is the client's `betterSupabase`.
+ */
+export declare function useBlockEvent<M extends EventMap, const P extends BlockEventPattern<M>>(source: BlockEventSource, events: Events<M>, pattern: P, handler: (event: BlockEvent<M, BlockEventsMatching<M, P>>) => void): void;
+//#endregion
 //#region src/solid/index.d.ts
 /** A value, or an accessor Solid tracks. */
 export type MaybeAccessor<T> = T | Accessor<T>;
 export interface BetterSupabaseProviderProps {
   readonly client: ClientLike;
-  /** better-supabase queries are reset when the user signs out or changes. */
+  /** Better-supabase queries are reset when the user signs out or changes. */
   readonly queryClient?: QueryClient;
-  /** A server-verified session (`createAsync(() => getSession())`) for `useSession()`. */
+  /**
+   * A server-verified session (`createAsync(() => getSession())`) for
+   * `useSession()`.
+   */
   readonly session?: Accessor<AuthSession | undefined>;
   readonly children?: JSX.Element;
 }
 /** Provides the better-supabase client to the primitives. */
 export declare function BetterSupabaseProvider(props: BetterSupabaseProviderProps): JSX.Element;
-/** The session state for UI: `loading`, `signed-out` or `signed-in` with the user and claims. */
+/**
+ * The session state for UI: `loading`, `signed-out` or `signed-in` with the
+ * user and claims.
+ */
 export declare function useAuth(): Accessor<AuthSnapshot>;
 export declare function useSupabase(): SupabaseClient;
-/** The session passed to `<BetterSupabaseProvider session={...}>`, `undefined` while it loads. */
+/**
+ * The session passed to `<BetterSupabaseProvider session={...}>`, `undefined`
+ * while it loads.
+ */
 export declare function useSession<C = unknown, P = unknown>(): Accessor<AuthSession<C, P> | undefined>;
 /** The support session the page renders in, or `undefined` for a normal session. */
 export declare function useSupportSession(): Accessor<SupportView | undefined>;
 export interface BetterPrimitives<B extends ClientLike> {
   /** Repositories bound to the current session. */
   readonly useDb: () => B["db"];
-  /** TanStack Query option factories: `useQuery(() => useQueries().customers.findMany())`. */
+  /**
+   * TanStack Query option factories: `useQuery(() =>
+   * useQueries().customers.findMany())`.
+   */
   readonly useQueries: () => B["queries"];
   readonly useSupabase: () => SupabaseClient;
   readonly useAuth: () => Accessor<AuthSnapshot>;
@@ -42,7 +72,8 @@ export interface BetterPrimitives<B extends ClientLike> {
  * Primitives typed for your schema.
  *
  * ```ts
- * export const { useDb, useQueries, useAuth } = createBindings<typeof bs>();
+ * export const { useDb, useQueries, useAuth } =
+ *   createBindings<typeof bs>();
  * ```
  */
 export declare function createBindings<B extends ClientLike>(): BetterPrimitives<B>;
@@ -51,7 +82,12 @@ export declare function createBindings<B extends ClientLike>(): BetterPrimitives
  * resubscribes when the topic values or the signed-in user change.
  *
  * ```ts
- * useBroadcast(customersTopic, () => ({ organizationId: org() }), {}, { invalidate: ['customers'] });
+ * useBroadcast(
+ *   customersTopic,
+ *   () => ({ organizationId: org() }),
+ *   {},
+ *   { invalidate: ["customers"] },
+ * );
  * ```
  */
 export declare function useBroadcast<P extends string, E extends EventSchemas>(topic: Topic<P, E>, values: MaybeAccessor<TemplateValues<P> | null | undefined>, handlers?: TopicHandlers<E>, options?: BroadcastOptions): Accessor<SubscriptionStatus>;
@@ -60,7 +96,9 @@ export declare function useBroadcast<P extends string, E extends EventSchemas>(t
  * spec touches whenever one of them changes. A `null` spec pauses.
  *
  * ```ts
- * useLiveQuery(() => betterSupabase.spec.customers.findMany({ where: { orgId: org() } }));
+ * useLiveQuery(() =>
+ *   betterSupabase.spec.customers.findMany({ where: { orgId: org() } }),
+ * );
  * ```
  */
 export declare function useLiveQuery(spec: MaybeAccessor<QuerySpec | null | undefined>, options?: LiveQueryHookOptions): Accessor<SubscriptionStatus>;
@@ -77,8 +115,10 @@ export interface LiveCount {
  * seed; `null` pauses. The returned object's fields are reactive.
  *
  * ```tsx
- * const unread = useLiveCount(() => betterSupabase.spec.messages.count({ where: { read: false } }));
- * <span>{unread.count}</span>
+ * const unread = useLiveCount(() =>
+ *   betterSupabase.spec.messages.count({ where: { read: false } }),
+ * );
+ * <span>{unread.count}</span>;
  * ```
  */
 export declare function useLiveCount(source: MaybeAccessor<LiveCountSource>, options?: LiveCountHookOptions): LiveCount;
@@ -98,7 +138,9 @@ export interface SolidPresenceOptions<I> extends Omit<PresenceHookOptions<I>, "s
  * `null` value pauses. The returned object's fields are reactive.
  *
  * ```ts
- * const room = usePresence(roomTopic, () => ({ roomId: id() }), { state: () => ({ name: name() }) });
+ * const room = usePresence(roomTopic, () => ({ roomId: id() }), {
+ *   state: () => ({ name: name() }),
+ * });
  * ```
  */
 export declare function usePresence<P extends string, I, O>(topic: PresenceTopic<P, I, O>, values: MaybeAccessor<TemplateValues<P> | null | undefined>, options?: SolidPresenceOptions<I>): Presence<I, O>;
@@ -108,15 +150,18 @@ export interface ActionHandle<I, T> extends ActionState<I, T> {
   readonly reset: () => void;
 }
 /**
- * Calls a server action (`action()` from SolidStart, or a `bs.action()`)
- * from an event handler: tracks pending inputs and the last result, and
- * calls `onSuccess` or `onError`. The returned object's fields are reactive.
+ * Calls a server action (`action()` from SolidStart, or a `bs.action()`) from
+ * an event handler: tracks pending inputs and the last result, and calls
+ * `onSuccess` or `onError`. The returned object's fields are reactive.
  *
  * ```tsx
  * const remove = useAction(removeMember);
- * <button disabled={remove.pending} onClick={() => remove.run({ userId })} />
+ * <button
+ *   disabled={remove.pending}
+ *   onClick={() => remove.run({ userId })}
+ * />;
  * ```
  */
 export declare function useAction<I, T>(action: (input: I) => Promise<ActionResultOf<T>>, options?: UseActionOptions<ActionInputOf<I>, T>): ActionHandle<ActionInputOf<I>, T>;
 //#endregion
-export { type ActionInputOf, type ActionResultOf, type ActionState, type AuthSession, type AuthSnapshot, type BroadcastOptions, type ClaimsOf, type ClientLike, type LiveCountHookOptions, type LiveCountSource, type LiveQueryHookOptions, type PresenceHookOptions, type PresenceTopic, type ProfileOf, type SupportView, type UseActionOptions, fieldErrorsOf };
+export { type ActionInputOf, type ActionResultOf, type ActionState, type AuthSession, type AuthSnapshot, type BlockEventSource, type BlockMutationActions, type BlockMutationState, type BlockQueryActions, type BlockQueryOptions, type BlockQueryState, type BlockRefetchOn, type BroadcastOptions, type ClaimsOf, type ClientLike, type LiveCountHookOptions, type LiveCountSource, type LiveQueryHookOptions, type PresenceHookOptions, type PresenceTopic, type ProfileOf, type SupportView, type UseActionOptions, fieldErrorsOf };

package/dist/solid/index.js

@@ -1,9 +1,33 @@
-import { t as clearOnUserChange } from "../user-change-XzvgafU4.js";
-import { a as createActionRunner, c as liveKey, d as shownCount, f as startBroadcast, i as countSource, l as notJoined, m as startLiveQuery, n as assertInvalidateClient, o as joinPresence, p as startLiveCount, r as callerOf, s as keyed, t as NO_COUNT, u as plainCaller } from "../client-CHR8IBNG.js";
+import { t as clearOnUserChange } from "../user-change-CSR_prhd.js";
+import { a as createActionRunner, c as liveKey, d as shownCount, f as startBroadcast, i as countSource, l as notJoined, m as startLiveQuery, n as assertInvalidateClient, o as joinPresence, p as startLiveCount, r as callerOf, s as keyed, t as NO_COUNT, u as plainCaller } from "../client-C_0XZieg.js";
 import { t as supportOf } from "../support-view-g4YLBeqX.js";
-import { t as fieldErrorsOf } from "../field-errors-DZVRWRkf.js";
-import { n as useContext$1, t as ClientContext } from "../context-B8_p3MXo.js";
+import { a as fieldErrorsOf, i as listenToBlockEvents, n as createBlockMutation, r as createBlockQuery } from "../block-controller-DTGuBemi.js";
+import { n as ClientContext, r as useContext$1, t as bindSolidController } from "../solid-bind-iHGfGtBK.js";
 import { createComponent, createEffect, createMemo, createSignal, onCleanup, onMount, untrack, useContext } from "solid-js";
+//#region src/solid/block-hooks.ts
+/**
+* Calls a read method of any block client (`blocks.tasks.list`, renamed or not)
+* from mount. `refetchOn` calls it again on block events.
+*/
+function useBlockQuery(client, method, args, options = {}) {
+	return bindSolidController(createBlockQuery(client, method, args, options));
+}
+/** Calls a write method of any block client and tracks its state. */
+function useBlockMutation(client, method) {
+	return bindSolidController(createBlockMutation(client, method));
+}
+/**
+* Calls `handler` for each block event matching `pattern` (`"task.*"`), typed
+* by `events` (`blockEvents` from `blocks.generated.ts`), from mount until the
+* component goes away. `source` is the client's `betterSupabase`.
+*/
+function useBlockEvent(source, events, pattern, handler) {
+	onMount(() => {
+		const stop = listenToBlockEvents(source, events, pattern, () => handler);
+		onCleanup(stop);
+	});
+}
+//#endregion
 //#region src/solid/index.ts
 function read(value) {
 	return typeof value === "function" ? value() : value;
@@ -32,14 +56,20 @@ function BetterSupabaseProvider(props) {
 		}
 	});
 }
-/** The session state for UI: `loading`, `signed-out` or `signed-in` with the user and claims. */
+/**
+* The session state for UI: `loading`, `signed-out` or `signed-in` with the
+* user and claims.
+*/
 function useAuth() {
 	return useContext$1().auth;
 }
 function useSupabase() {
 	return useContext$1().client.supabase;
 }
-/** The session passed to `<BetterSupabaseProvider session={...}>`, `undefined` while it loads. */
+/**
+* The session passed to `<BetterSupabaseProvider session={...}>`, `undefined`
+* while it loads.
+*/
 function useSession() {
 	const { session } = useContext$1();
 	if (!session) throw new Error("better-supabase: useSession() needs <BetterSupabaseProvider session={...}>");
@@ -57,7 +87,8 @@ function useSupportSession() {
 * Primitives typed for your schema.
 *
 * ```ts
-* export const { useDb, useQueries, useAuth } = createBindings<typeof bs>();
+* export const { useDb, useQueries, useAuth } =
+*   createBindings<typeof bs>();
 * ```
 */
 function createBindings() {
@@ -103,7 +134,12 @@ function supabaseFor(hook, context, client) {
 * resubscribes when the topic values or the signed-in user change.
 *
 * ```ts
-* useBroadcast(customersTopic, () => ({ organizationId: org() }), {}, { invalidate: ['customers'] });
+* useBroadcast(
+*   customersTopic,
+*   () => ({ organizationId: org() }),
+*   {},
+*   { invalidate: ["customers"] },
+* );
 * ```
 */
 function useBroadcast(topic, values, handlers, options) {
@@ -145,7 +181,9 @@ function useBroadcast(topic, values, handlers, options) {
 * spec touches whenever one of them changes. A `null` spec pauses.
 *
 * ```ts
-* useLiveQuery(() => betterSupabase.spec.customers.findMany({ where: { orgId: org() } }));
+* useLiveQuery(() =>
+*   betterSupabase.spec.customers.findMany({ where: { orgId: org() } }),
+* );
 * ```
 */
 function useLiveQuery(spec, options = {}) {
@@ -182,8 +220,10 @@ function useLiveQuery(spec, options = {}) {
 * seed; `null` pauses. The returned object's fields are reactive.
 *
 * ```tsx
-* const unread = useLiveCount(() => betterSupabase.spec.messages.count({ where: { read: false } }));
-* <span>{unread.count}</span>
+* const unread = useLiveCount(() =>
+*   betterSupabase.spec.messages.count({ where: { read: false } }),
+* );
+* <span>{unread.count}</span>;
 * ```
 */
 function useLiveCount(source, options = {}) {
@@ -240,7 +280,9 @@ const NO_MEMBERS = [];
 * `null` value pauses. The returned object's fields are reactive.
 *
 * ```ts
-* const room = usePresence(roomTopic, () => ({ roomId: id() }), { state: () => ({ name: name() }) });
+* const room = usePresence(roomTopic, () => ({ roomId: id() }), {
+*   state: () => ({ name: name() }),
+* });
 * ```
 */
 function usePresence(topic, values, options = {}) {
@@ -296,13 +338,16 @@ function usePresence(topic, values, options = {}) {
 	};
 }
 /**
-* Calls a server action (`action()` from SolidStart, or a `bs.action()`)
-* from an event handler: tracks pending inputs and the last result, and
-* calls `onSuccess` or `onError`. The returned object's fields are reactive.
+* Calls a server action (`action()` from SolidStart, or a `bs.action()`) from
+* an event handler: tracks pending inputs and the last result, and calls
+* `onSuccess` or `onError`. The returned object's fields are reactive.
 *
 * ```tsx
 * const remove = useAction(removeMember);
-* <button disabled={remove.pending} onClick={() => remove.run({ userId })} />
+* <button
+*   disabled={remove.pending}
+*   onClick={() => remove.run({ userId })}
+* />;
 * ```
 */
 function useAction(action, options = {}) {
@@ -336,4 +381,4 @@ function useAction(action, options = {}) {
 	};
 }
 //#endregion
-export { BetterSupabaseProvider, createBindings, fieldErrorsOf, useAction, useAuth, useBroadcast, useLiveCount, useLiveQuery, usePresence, useSession, useSupabase, useSupportSession };
+export { BetterSupabaseProvider, createBindings, fieldErrorsOf, useAction, useAuth, useBlockEvent, useBlockMutation, useBlockQuery, useBroadcast, useLiveCount, useLiveQuery, usePresence, useSession, useSupabase, useSupportSession };

package/dist/solid-bind-C1jeq4Qm.d.ts

@@ -0,0 +1,11 @@
+import { n as Controller } from "./controller-DAD4hbl4.js";
+import { Accessor } from "solid-js";
+//#region src/blocks/solid-bind.d.ts
+/** A block controller in a Solid component: `state` follows the controller. */
+interface SolidController<S, A> {
+  readonly state: Accessor<S>;
+  readonly actions: A;
+  readonly controller: Controller<S, A>;
+}
+//#endregion
+export { SolidController as t };

package/dist/solid-bind-iHGfGtBK.js

@@ -0,0 +1,38 @@
+import { createContext, from, onCleanup, onMount, useContext } from "solid-js";
+//#region src/solid/context.ts
+const ClientContext = createContext();
+/** What `<BetterSupabaseProvider>` provides. */
+function useContext$1() {
+	const context = useContext(ClientContext);
+	if (!context) throw new Error("better-supabase: wrap your app in <BetterSupabaseProvider client={bs}>");
+	return context;
+}
+//#endregion
+//#region src/blocks/solid-bind.ts
+/**
+* Reads a controller through `from`. Its work starts on mount (never during
+* server rendering), and the controller is disposed with the owner.
+*/
+function bindSolidController(controller) {
+	const state = from({ subscribe: (next) => {
+		next(controller.getSnapshot());
+		let stop;
+		onMount(() => {
+			stop = controller.subscribe(() => {
+				next(controller.getSnapshot());
+			});
+			next(controller.getSnapshot());
+		});
+		return () => stop?.();
+	} }, controller.getSnapshot());
+	onCleanup(() => {
+		controller.dispose();
+	});
+	return {
+		state,
+		actions: controller.actions,
+		controller
+	};
+}
+//#endregion
+export { ClientContext as n, useContext$1 as r, bindSolidController as t };

package/dist/solid-controller-DGuv7V8a.js

@@ -0,0 +1,13 @@
+import { n as withEnv, t as blockEnv } from "./block-env-DJiUu1fq.js";
+import { r as useContext, t as bindSolidController } from "./solid-bind-iHGfGtBK.js";
+//#region src/blocks/solid-controller.ts
+/**
+* Makes a controller once and reads it through `from`. Its work starts on mount
+* (never during server rendering), and the controller is disposed with the
+* owner.
+*/
+function useBlockController(create, options, usesEnv = true) {
+	return bindSolidController(create(withEnv(options, usesEnv ? () => blockEnv(useContext().client) : void 0)));
+}
+//#endregion
+export { useBlockController as t };

package/dist/solid-start/index.d.ts

@@ -1,9 +1,10 @@
-import { a as AnyModels, i as AnyFunctions } from "../types-BrpW5ixT.js";
-import { t as BetterSupabase } from "../define-DYZnvAbs.js";
-import { n as BetterServer } from "../server-types-fLdep4gb.js";
-import { a as AuthorizedContext, c as Unwrapped, n as ActionParsed, o as BlockActionOptions, r as ActionResult, s as BlockRequireOptions } from "../kit-De-EVRhw.js";
-import { t as RefusalRedirects } from "../refusal-C7geIBRl.js";
-import { n as FrameworkOptions, t as FrameworkLocals } from "../framework-BQhTsLX-.js";
+import { M as AnyFunctions, N as AnyModels } from "../executor-CPyrQdjh.js";
+import { s as PermissionRef, t as AnyAuthorizer } from "../authorizer-DFP3gHv8.js";
+import { t as BetterSupabase } from "../define-Dw7pRO4h.js";
+import { n as BetterServer } from "../server-types-BOs-eFpo.js";
+import { a as AuthorizedContext, l as Unwrapped, n as ActionParsed, o as BlockActionOptions, r as ActionResult, s as BlockRequireOptions } from "../kit-DKfbNTAA.js";
+import { t as RefusalRedirects } from "../refusal-efy5bZMd.js";
+import { n as FrameworkOptions, r as LocalsResource, t as FrameworkLocals } from "../framework-FxfJpyoF.js";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/solid-start/index.d.ts
 /** The part of a SolidStart `FetchEvent` the integration reads and writes. */
@@ -13,15 +14,18 @@ export interface SolidFetchEvent {
     readonly headers: Headers;
   };
   readonly locals: Record<string, unknown>;
-  /** The H3 2 event; Nitro 3's Cloudflare preset puts the bindings on its request. */
+  /**
+   * The H3 2 event; Nitro 3's Cloudflare preset puts the bindings on its
+   * request.
+   */
   readonly nativeEvent?: {
     readonly req: Request;
   } | undefined;
 }
 export interface SolidStartOptions extends FrameworkOptions {
   /**
-   * `getRequestEvent` from `solid-js/web`, which `require` and `action`
-   * call inside `"use server"` functions.
+   * `getRequestEvent` from `solid-js/web`, which `require` and `action` call
+   * inside `"use server"` functions.
    */
   readonly getRequestEvent: () => SolidFetchEvent | undefined;
   /** The host's env object for `getEnv`; defaults to the Cloudflare bindings. */
@@ -32,23 +36,24 @@ export interface SolidStartMiddleware {
   readonly onRequest: (event: SolidFetchEvent) => Promise<Response | undefined>;
   readonly onBeforeResponse: (event: SolidFetchEvent) => void;
 }
-export interface BetterSolidStart<M extends AnyModels, F extends AnyFunctions, E, C = unknown, P = unknown, B = unknown> extends BetterServer<M, F, E, C, P, B> {
+export interface BetterSolidStart<M extends AnyModels, F extends AnyFunctions, E, C = unknown, P = unknown, Ref = string, B = unknown> extends BetterServer<M, F, E, C, P, B> {
   /**
-   * Verifies the caller, refreshes the session cookie on navigations and
-   * form posts, and puts `db`, `bs`, `auth`, `tenant` and `session` on
+   * Verifies the caller, refreshes the session cookie on navigations and form
+   * posts, and puts `db`, `bs`, `auth`, `tenant` and `session` on
    * `event.locals`.
    *
-   * ```ts title="src/middleware.ts"
-   * export default createMiddleware(bs.middleware)
+   * ```ts
+   * // src/middleware.ts
+   * export default createMiddleware(bs.middleware);
    * ```
    */
   readonly middleware: SolidStartMiddleware;
   /** The current request's `locals`, inside a `"use server"` function. */
   readonly locals: () => FrameworkLocals<M, F, E, C, P, B>;
   /**
-   * The caller inside a `"use server"` function (a `query`, an `action`,
-   * an API route), or a thrown refusal: a redirect to `signIn` or `mfa`
-   * when configured, else Problem Details.
+   * The caller inside a `"use server"` function (a `query`, an `action`, an API
+   * route), or a thrown refusal: a redirect to `signIn` or `mfa` when
+   * configured, else Problem Details.
    *
    * ```ts
    * const notes = query(async () => {
@@ -58,14 +63,16 @@ export interface BetterSolidStart<M extends AnyModels, F extends AnyFunctions, E
    * }, "notes");
    * ```
    */
-  require<R extends boolean = false>(options?: BlockRequireOptions<C, P, R>): Promise<FrameworkLocals<M, F, E, C, P, B> & AuthorizedContext<C, P, R>>;
+  require<R extends boolean = false>(options?: BlockRequireOptions<C, P, R, Ref, LocalsResource<M, F, E, C, P, B>>): Promise<FrameworkLocals<M, F, E, C, P, B> & AuthorizedContext<C, P, R>>;
   /**
    * A server function returning an `ActionResult`, for `action()` from
    * `@solidjs/router`: `FormData` or a plain object, validated by `input`.
    */
-  action<S extends StandardSchemaV1 | undefined, T, R extends boolean = false>(options: BlockActionOptions<S, C, P, R>, fn: (input: ActionParsed<S>, ctx: FrameworkLocals<M, F, E, C, P, B> & AuthorizedContext<C, P, R>) => T): (input: unknown) => Promise<ActionResult<Unwrapped<Awaited<T>>>>;
+  action<S extends StandardSchemaV1 | undefined, T, R extends boolean = false>(options: BlockActionOptions<S, C, P, R, Ref, LocalsResource<M, F, E, C, P, B>>, fn: (input: ActionParsed<S>, ctx: FrameworkLocals<M, F, E, C, P, B> & AuthorizedContext<C, P, R>) => T): (input: unknown) => Promise<ActionResult<Unwrapped<Awaited<T>>>>;
 }
 /** SolidStart integration: middleware, guards and server function actions. */
-export declare function createSolidStart<M extends AnyModels, D, F extends AnyFunctions, E, C = unknown, P = unknown, B = unknown>(betterSupabase: BetterSupabase<M, D, F, E, C, P, B>, options: SolidStartOptions): BetterSolidStart<M, F, E, C, P, B>;
+export declare function createSolidStart<M extends AnyModels, D, F extends AnyFunctions, E, C = unknown, P = unknown, A extends AnyAuthorizer | undefined = undefined, B = unknown>(betterSupabase: BetterSupabase<M, D, F, E, C, P, B>, options: SolidStartOptions & {
+  readonly authorizer?: A;
+}): BetterSolidStart<M, F, E, C, P, PermissionRef<A>, B>;
 //#endregion
 export type { ActionResult, RefusalRedirects };

package/dist/solid-start/index.js

@@ -1,10 +1,10 @@
-import { c as extendServer, n as flushEvents, s as createServer } from "../adapter-CRNH2aX_.js";
-import { t as defaultExpose } from "../respond-Bhp3G__q.js";
-import { i as requireCaller, o as runAction } from "../kit-LTbHrWWD.js";
-import { i as nitroCloudflareEnv } from "../shared-BmMcMoW9.js";
-import { i as localsOf, r as frameworkEntry } from "../framework-C6PKBgme.js";
-import { r as refusalResponse } from "../refusal-CFpfmjcS.js";
-import { t as beforeRoute } from "../before-route-B98js9m_.js";
+import { c as extendServer, n as flushEvents, s as createServer } from "../adapter-BCFAg58A.js";
+import { t as defaultExpose } from "../respond-z_yfyitp.js";
+import { i as requireCaller, o as runAction } from "../kit-Ct4Z6GIO.js";
+import { i as nitroCloudflareEnv } from "../shared-Bf-I13Ht.js";
+import { i as localsOf, r as frameworkEntry } from "../framework-CXoyWGgd.js";
+import { r as refusalResponse } from "../refusal-DXydjgsS.js";
+import { t as beforeRoute } from "../before-route-B23K2zYU.js";
 //#region src/solid-start/index.ts
 /** SolidStart integration: middleware, guards and server function actions. */
 function createSolidStart(betterSupabase, options) {
@@ -37,7 +37,7 @@ function createSolidStart(betterSupabase, options) {
 		require: async (requireOptions = {}) => {
 			const event = eventOf();
 			const scope = scopeOf(event);
-			const caller = await requireCaller(scope.bs.auth, requireOptions, scope.tenant, options.authorizer);
+			const caller = await requireCaller(scope.bs.auth, requireOptions, scope.tenant, options.authorizer, scope);
 			if ("kind" in caller) throw refusalResponse(caller, event.request, options, expose);
 			return {
 				...scope,
@@ -50,7 +50,7 @@ function createSolidStart(betterSupabase, options) {
 				return await runAction(scope.bs.auth, actionOptions, input, scope.tenant, (parsed, caller) => fn(parsed, {
 					...scope,
 					...caller
-				}), options.authorizer);
+				}), options.authorizer, scope);
 			};
 		}
 	});

package/dist/spec/index.d.ts

@@ -1,8 +1,9 @@
-import { C as ModelWebhook, D as ResourceOperation, E as OperationSource, O as SecurityRequirement, S as ModelTag, T as OAuthFlow, _ as ModelResponseOrRef, a as JsonSchema, b as ModelServer, c as ModelChannelOperation, d as ModelInfo, f as ModelMessage, g as ModelResponse, h as ModelParameter, i as JsonObject, l as ModelContent, m as ModelOperation, n as DataApiOperation, o as ModelBody, p as ModelMessageTrait, r as HttpMethod, s as ModelChannel, t as ApiModel, u as ModelExample, v as ModelSecurityProfileRequirement, w as ModelWorkflow, x as ModelStep, y as ModelSecurityScheme } from "../model-lUafmeBQ.js";
-import { a as FormatVersion, c as SpecDiagnostic, d as defineDocumentFormat, i as DocumentOf, l as VersionOf, n as DiagnosticSeverity, o as LowerContext, r as DocumentFormat, s as RenderedOf, t as AnyDocumentFormat, u as VersionStatus } from "../format-CNwSjXUU.js";
-import { a as ResourcePlan, r as ResourceDescription } from "../resource-DYEtc-KN.js";
-import { B as DEFAULT_ERRORS, C as ApiSource, D as OperationIdContext, E as EnrichHooks, F as EventsOptions, H as SecurityPreset, I as TopicInput, L as topicsFrom, O as ResourceInput, R as DataApiOptions, S as ApiOptions, T as ComponentNameContext, V as PROBLEM_SCHEMA, a as OverlayEngine, c as defineApi, i as OpenApiRenderResult, k as RouteSpec, n as DefineApiOptions, o as RenderOptions, r as OpenApiRenderOptions, s as RenderResult, t as Api, w as BuiltModel, z as CustomSecurity } from "../api-DoWK3dTw.js";
-import { t as DescribedFunction } from "../function-contract-DWqFl_QO.js";
+import { a as OverlayEngine, c as defineApi, i as OpenApiRenderResult, n as DefineApiOptions, o as RenderOptions, r as OpenApiRenderOptions, s as RenderResult, t as Api } from "../api-CWhpq24a.js";
+import { C as ModelWebhook, D as ResourceOperation, E as OperationSource, O as SecurityRequirement, S as ModelTag, T as OAuthFlow, _ as ModelResponseOrRef, a as JsonSchema, b as ModelServer, c as ModelChannelOperation, d as ModelInfo, f as ModelMessage, g as ModelResponse, h as ModelParameter, i as JsonObject, l as ModelContent, m as ModelOperation, n as DataApiOperation, o as ModelBody, p as ModelMessageTrait, r as HttpMethod, s as ModelChannel, t as ApiModel, u as ModelExample, v as ModelSecurityProfileRequirement, w as ModelWorkflow, x as ModelStep, y as ModelSecurityScheme } from "../model-Btl8X9cs.js";
+import { a as FormatVersion, c as SpecDiagnostic, d as defineDocumentFormat, i as DocumentOf, l as VersionOf, n as DiagnosticSeverity, o as LowerContext, r as DocumentFormat, s as RenderedOf, t as AnyDocumentFormat, u as VersionStatus } from "../format-AYHceC2m.js";
+import { a as ResourcePlan, r as ResourceDescription } from "../resource-DYDEnww-.js";
+import { _ as DataApiOptions, a as EnrichHooks, b as PROBLEM_SCHEMA, c as RouteSpec, g as topicsFrom, h as TopicInput, i as ComponentNameContext, m as EventsOptions, n as ApiSource, o as OperationIdContext, r as BuiltModel, s as ResourceInput, t as ApiOptions, v as CustomSecurity, x as SecurityPreset, y as DEFAULT_ERRORS } from "../options-Dm-2crCx.js";
+import { t as DescribedFunction } from "../function-contract-vPqwt1j4.js";
 //#region src/spec/build.d.ts
 /**
  * Builds the version-neutral API model once per metadata, plugin list and
@@ -19,9 +20,9 @@ interface FunctionRouteOptions {
   readonly tags?: readonly string[];
 }
 /**
- * The route of a `defineFunction` handler, at `/functions/v1/<name>`: its
- * input is the request body and its output the 200 response. Pass it in
- * `routes`; `basePath` goes in front of it like any other route.
+ * The route of a `defineFunction` handler, at `/functions/v1/<name>`: its input
+ * is the request body and its output the 200 response. Pass it in `routes`;
+ * `basePath` goes in front of it like any other route.
  *
  * ```ts
  * defineApi(bs, { routes: [functionRoute("send-invite", sendInvite)] });
@@ -33,8 +34,8 @@ export declare function functionRoute(name: string, fn: DescribedFunction, optio
 /** Escapes a key for a JSON Pointer (RFC 6901). */
 export declare function pointerToken(key: string): string;
 /**
- * Deep merge: objects merge key by key, anything else (arrays included)
- * is replaced by the patch. `onConflict` hears each replaced leaf whose value
+ * Deep merge: objects merge key by key, anything else (arrays included) is
+ * replaced by the patch. `onConflict` hears each replaced leaf whose value
  * differs, with its JSON Pointer. Neither input is changed.
  */
 export declare function mergeJson<T>(base: T, patch: unknown, onConflict?: (pointer: string) => void, pointer?: string): T;
@@ -43,13 +44,15 @@ export declare function mergeJson<T>(base: T, patch: unknown, onConflict?: (poin
 interface SerializeOptions {
   /** Spaces per level. Defaults to 2; 0 writes one line. */
   readonly indent?: number;
-  /** Sorts object keys by UTF-16 code unit. Off by default, so generated order stays. */
+  /**
+   * Sorts object keys by UTF-16 code unit. Off by default, so generated order
+   * stays.
+   */
   readonly sortKeys?: boolean;
 }
 /**
- * The document as JSON text: the same document always gives the same
- * bytes, ending in a newline. Throws on `NaN` and infinities, which JSON
- * cannot hold.
+ * The document as JSON text: the same document always gives the same bytes,
+ * ending in a newline. Throws on `NaN` and infinities, which JSON cannot hold.
  */
 export declare function serializeDocument(document: unknown, options?: SerializeOptions): string;
 interface SpecResponseOptions {
@@ -60,10 +63,10 @@ interface SpecResponseOptions {
   readonly indent?: number;
 }
 /**
- * A `Response` that serves a rendered document with a strong ETag (the
- * SHA-256 of the body). A matching `If-None-Match` gets `304`; `HEAD` gets
- * the headers only; other methods than `GET` and `HEAD` get `405`. The body
- * and ETag are computed once per document object.
+ * A `Response` that serves a rendered document with a strong ETag (the SHA-256
+ * of the body). A matching `If-None-Match` gets `304`; `HEAD` gets the headers
+ * only; other methods than `GET` and `HEAD` get `405`. The body and ETag are
+ * computed once per document object.
  */
 export declare function specResponse(document: object, request?: Request, options?: SpecResponseOptions): Promise<Response>;
 //#endregion
@@ -95,9 +98,15 @@ interface SpecReferenceOptions {
    * files the app hosts itself.
    */
   readonly assets?: string | SpecUiAssets;
-  /** Set on every script and style tag, for a Content Security Policy with nonces. */
+  /**
+   * Set on every script and style tag, for a Content Security Policy with
+   * nonces.
+   */
   readonly nonce?: string;
-  /** UI options: Scalar's configuration, Swagger UI's and Redoc's options, or attributes of the Elements and RapiDoc components. */
+  /**
+   * UI options: Scalar's configuration, Swagger UI's and Redoc's options, or
+   * attributes of the Elements and RapiDoc components.
+   */
   readonly config?: Readonly<Record<string, unknown>>;
 }
 /**
@@ -105,7 +114,10 @@ interface SpecReferenceOptions {
  * Swagger UI, Redoc, Stoplight Elements and RapiDoc load the same way.
  *
  * ```ts
- * const html = specReferenceHtml({ specUrl: "/api/openapi.json", ui: "redoc" });
+ * const html = specReferenceHtml({
+ *   specUrl: "/api/openapi.json",
+ *   ui: "redoc",
+ * });
  * ```
  */
 export declare function specReferenceHtml(options: SpecReferenceOptions): string;
@@ -133,7 +145,10 @@ export declare function specReferenceCsp(options: Pick<SpecReferenceOptions, "ui
  */
 export declare function specReference(options: SpecReferenceResponseOptions, request?: Request): Response;
 interface ScalarPresetOptions {
-  /** A public OAuth client Scalar's "try it" uses for the authorization code flow. */
+  /**
+   * A public OAuth client Scalar's "try it" uses for the authorization code
+   * flow.
+   */
   readonly clientId?: string;
   readonly redirectUri?: string;
   /** PKCE for the authorization code flow. Defaults to `SHA-256`. */
@@ -145,9 +160,9 @@ interface ScalarPresetOptions {
 }
 /**
  * Adds Scalar's `x-scalar-*` extensions to an OpenAPI document, so the
- * reference can sign in through the OAuth flows the document declares.
- * Returns a copy. Use it in a `transform`:
- * `transform: ({ document }) => scalarPreset(document, { clientId })`.
+ * reference can sign in through the OAuth flows the document declares. Returns
+ * a copy. Use it in a `transform`: `transform: ({ document }) =>
+ * scalarPreset(document, { clientId })`.
  */
 export declare function scalarPreset<D extends object>(document: D, options?: ScalarPresetOptions): D;
 //#endregion