better-supabase 0.3.0 → 0.4.0

package/dist/{pool-B9qsLyFR.d.ts → pool-DFwEQwmN.d.ts}

@@ -1,4 +1,5 @@
-import { t as SqlClient } from "./executor-B26lgbHD.js";
+import { r as Executor } from "./executor-B5IoUxLE.js";
+import { t as SqlClient } from "./executor-CZ7ImRiD.js";
 //#region src/postgres/pool.d.ts
 /** The part of a `pg` pool client `createPostgres` uses. */
 interface PgPoolClient {
@@ -47,13 +48,19 @@ interface SqlClaims {
   readonly role?: string;
   readonly [claim: string]: unknown;
 }
-interface Postgres {
+interface BetterPostgres {
   /** Connects as the connection-string role. On Supabase that bypasses RLS. */
   readonly admin: SqlClient;
   /** Runs every query as the given user, with RLS, like PostgREST does. */
   asUser(claims: SqlClaims): SqlClient;
   /** Runs every query as `anon`. */
   readonly anon: SqlClient;
+  /**
+   * Repositories' executor as the given user (`postgresExecutor(asUser(claims))`).
+   * `createServer` calls it for `ctx.sql`, so only apps that pass `postgres`
+   * bundle the SQL compiler.
+   */
+  executorFor(claims: SqlClaims): Executor;
   /** Runs `fn` in one transaction. Pass claims to run it as a user. */
   transaction<T>(fn: (client: SqlClient) => Promise<T>, options?: {
     readonly claims?: SqlClaims;
@@ -66,6 +73,6 @@ interface Postgres {
  * transaction) runs in its own transaction; claims and role are
  * transaction-local, so nothing leaks back into the pool.
  */
-declare function createPostgres(options?: PostgresOptions): Postgres;
+declare function createPostgres(options?: PostgresOptions): BetterPostgres;
 //#endregion
-export { PostgresTimeouts as a, PostgresOptions as i, PgPoolClient as n, SqlClaims as o, Postgres as r, createPostgres as s, PgPool as t };
+export { PostgresTimeouts as a, PostgresOptions as i, PgPool as n, SqlClaims as o, PgPoolClient as r, createPostgres as s, BetterPostgres as t };

package/dist/postgres/index.d.ts

@@ -1,7 +1,7 @@
-import { g as Operation } from "../executor-DynmIWhq.js";
-import { n as fromPgError, r as postgresExecutor, t as SqlClient } from "../executor-B26lgbHD.js";
-import { a as PostgresTimeouts, i as PostgresOptions, n as PgPoolClient, o as SqlClaims, r as Postgres, s as createPostgres, t as PgPool } from "../pool-B9qsLyFR.js";
-import { t as Compiler } from "../compiler-2zqGzxVZ.js";
+import { g as Operation } from "../executor-B5IoUxLE.js";
+import { n as fromPgError, r as postgresExecutor, t as SqlClient } from "../executor-CZ7ImRiD.js";
+import { a as PostgresTimeouts, i as PostgresOptions, n as PgPool, o as SqlClaims, r as PgPoolClient, s as createPostgres, t as BetterPostgres } from "../pool-DFwEQwmN.js";
+import { t as Compiler } from "../compiler-DB3aSFOA.js";
 //#region src/compile/sql.d.ts
 interface SqlQuery {
   readonly text: string;
@@ -30,4 +30,4 @@ export declare function compileSql(op: Operation): SqlPlan;
 //#region src/postgres/compiler.d.ts
 export declare const sqlCompiler: Compiler<SqlPlan>;
 //#endregion
-export { type PgPool, type PgPoolClient, type Postgres, type PostgresOptions, type PostgresTimeouts, type SqlClaims, type SqlClient, type SqlPlan, type SqlQuery, createPostgres, fromPgError, postgresExecutor };
+export { type BetterPostgres, type PgPool, type PgPoolClient, type PostgresOptions, type PostgresTimeouts, type SqlClaims, type SqlClient, type SqlPlan, type SqlQuery, createPostgres, fromPgError, postgresExecutor };

package/dist/postgres/index.js

@@ -1,5 +1,5 @@
-import { n as quoteIdent, t as compileSql } from "../sql-BIgk12ew.js";
-import { n as postgresExecutor, t as fromPgError } from "../executor-C57jx2pn.js";
+import { n as quoteIdent, t as compileSql } from "../sql-B34HU2DI.js";
+import { n as postgresExecutor, t as fromPgError } from "../executor-CVt6dD0B.js";
 import { Pool } from "pg";
 //#region src/postgres/pool.ts
 const DEFAULT_TIMEOUTS = {
@@ -84,6 +84,7 @@ function createPostgres(options = {}) {
 			role: "anon"
 		}),
 		asUser: (claims) => clientFor(sessionFor(claims)),
+		executorFor: (claims) => postgresExecutor(clientFor(sessionFor(claims))),
 		transaction: (fn, txOptions) => transaction(txOptions?.claims ? sessionFor(txOptions.claims) : void 0, fn),
 		end: () => pool.end(),
 		[Symbol.asyncDispose]: () => pool.end()

package/dist/{postgrest-DmBlevh-.d.ts → postgrest-Bc-0Xw62.d.ts}

@@ -1,4 +1,4 @@
-import { g as Operation } from "./executor-DynmIWhq.js";
+import { g as Operation } from "./executor-B5IoUxLE.js";
 //#region src/compile/postgrest.d.ts
 /**
  * A compiled PostgREST request, expressed as calls on the public

package/dist/{problem-CGt1ADix.js → problem-BihjPR0t.js}

@@ -1,4 +1,4 @@
-import { n as dbError } from "./errors-Bl3rkOzo.js";
+import { n as dbError } from "./errors-L0xK41y_.js";
 //#region src/core/problem.ts
 const PROBLEM_TYPE_BASE = "https://bettersupabase.com/problems/";
 const PROBLEM_CONTENT_TYPE = "application/problem+json";

package/dist/{problem-Z2RTQjZD.d.ts → problem-U8UEKccv.d.ts}

@@ -1,4 +1,4 @@
-import { b as ValidationIssue, m as DbErrorKind, p as DbError } from "./result-c2OYgCV2.js";
+import { b as ValidationIssue, m as DbErrorKind, p as DbError } from "./result-CqEsbgYs.js";
 //#region src/core/problem.d.ts
 /** RFC 9457 Problem Details, with the `DbError` fields as extension members. */
 interface ProblemDetails {

package/dist/query/index.d.ts

@@ -1,2 +1,2 @@
-import { a as QueryHelpers, c as TableQueries, d as queryCache, f as BetterQueryMeta, i as Queries, l as createQueries, n as InfiniteOptionsOf, o as QueryKeyOf, p as invalidateTables, r as MutationOptionsOf, s as QueryOptionsOf, t as CreateQueriesOptions, u as invalidateOnMutation } from "../index-CriFFJ_p.js";
-export { type BetterQueryMeta, type CreateQueriesOptions, type InfiniteOptionsOf, type MutationOptionsOf, type Queries, type QueryHelpers, type QueryKeyOf, type QueryOptionsOf, type TableQueries, createQueries, invalidateOnMutation, invalidateTables, queryCache };
+import { a as QueryHelpers, c as TableQueries, d as queryCache, f as BetterQueryMeta, i as QueriesOptions, l as createQueries, n as InfiniteOptionsOf, o as QueryKeyOf, p as invalidateTables, r as MutationOptionsOf, s as QueryOptionsOf, t as BetterQueries, u as invalidateOnMutation } from "../index-DFmOpBGC.js";
+export { type BetterQueries, type BetterQueryMeta, type InfiniteOptionsOf, type MutationOptionsOf, type QueriesOptions, type QueryHelpers, type QueryKeyOf, type QueryOptionsOf, type TableQueries, createQueries, invalidateOnMutation, invalidateTables, queryCache };

package/dist/query/index.js

@@ -1,3 +1,3 @@
-import { t as invalidateTables } from "../invalidate-DbxuL2jL.js";
-import { n as invalidateOnMutation, r as queryCache, t as createQueries } from "../query-BdKLTPlj.js";
+import { t as invalidateTables } from "../invalidate-CgxmRamI.js";
+import { n as invalidateOnMutation, r as queryCache, t as createQueries } from "../query-BMMSWbI7.js";
 export { createQueries, invalidateOnMutation, invalidateTables, queryCache };

package/dist/{query-BdKLTPlj.js → query-BMMSWbI7.js}

@@ -1,8 +1,8 @@
-import { t as DbException } from "./errors-Bl3rkOzo.js";
-import { t as invalidationTargets } from "./tables-Dhha3BXM.js";
-import { t as invalidateTables } from "./invalidate-DbxuL2jL.js";
+import { t as DbException } from "./errors-L0xK41y_.js";
+import { t as invalidationTargets } from "./tables-Cb-3_VWc.js";
+import { t as invalidateTables } from "./invalidate-CgxmRamI.js";
 //#region src/query/queries.ts
-/** Query errors stay `DbException`s, even for an `sb` with `mapError()`. */
+/** Query errors stay `DbException`s, even for an `betterSupabase` with `mapError()`. */
 const asException = (error) => new DbException(error);
 function isSkip(value) {
 	return typeof value === "symbol";
@@ -28,13 +28,13 @@ function specQuery(runtime, spec, key) {
 			...spec.args
 		],
 		queryFn: ({ signal }) => runtime.db().$run(spec, { signal }).orThrow(asException),
-		meta: { bsTables: runtime.sb.tablesOf(spec) },
+		meta: { bsTables: runtime.betterSupabase.tablesOf(spec) },
 		...stale
 	};
 }
 function tableQueries(runtime, table) {
 	const key = ["bs", table];
-	const specs = runtime.sb.spec[table];
+	const specs = runtime.betterSupabase.spec[table];
 	const stale = runtime.staleTime === void 0 ? {} : { staleTime: runtime.staleTime };
 	const read = (method) => (args) => isSkip(args) ? specQuery(runtime, args, [
 		...key,
@@ -84,7 +84,7 @@ function tableQueries(runtime, table) {
 				}), { signal }).orThrow(asException),
 				initialPageParam: null,
 				getNextPageParam: (last) => last.nextCursor ?? void 0,
-				meta: { bsTables: runtime.sb.tablesOf(specs["paginate"]({
+				meta: { bsTables: runtime.betterSupabase.tablesOf(specs["paginate"]({
 					...base,
 					after: null
 				})) },
@@ -105,14 +105,14 @@ function tableQueries(runtime, table) {
 				}), { signal }).orThrow(asException),
 				initialPageParam: base.page ?? 1,
 				getNextPageParam: (last) => last.page.hasMore ? last.page.number + 1 : void 0,
-				meta: { bsTables: runtime.sb.tablesOf(specs["paginate"](base)) },
+				meta: { bsTables: runtime.betterSupabase.tablesOf(specs["paginate"](base)) },
 				...stale
 			};
 		},
 		create: (args) => mutation("create", (data) => call("create", data, args), [table]),
 		update: (args) => mutation("update", (variables) => call("update", variables.id, variables.patch, args), [table]),
 		upsert: (args) => mutation("upsert", (data) => call("upsert", data, args), [table]),
-		delete: (args) => mutation("delete", (id) => call("delete", id, args), invalidationTargets(runtime.sb.meta, table))
+		delete: (args) => mutation("delete", (id) => call("delete", id, args), invalidationTargets(runtime.betterSupabase.meta, table))
 	};
 }
 /**
@@ -123,19 +123,19 @@ function tableQueries(runtime, table) {
 * changed table.
 *
 * ```ts
-* const q = createQueries(sb, () => browser.db);
+* const q = createQueries(betterSupabase, () => bs.db);
 * const { data } = useQuery(q.customers.findMany({ select: ['id', 'name'] }));
 * ```
 */
-function createQueries(sb, db, options = {}) {
+function createQueries(betterSupabase, db, options = {}) {
 	const runtime = {
-		sb,
+		betterSupabase,
 		db: typeof db === "function" ? db : () => db,
 		staleTime: options.staleTime
 	};
 	const stale = options.staleTime === void 0 ? {} : { staleTime: options.staleTime };
 	const queries = {
-		key: ["bs"],
+		$key: ["bs"],
 		$spec: (spec) => specQuery(runtime, spec),
 		$prefetch: (client, spec) => client.prefetchQuery(specQuery(runtime, spec)),
 		$rpc: (name, args, rpcOptions = {}) => ({
@@ -156,10 +156,10 @@ function createQueries(sb, db, options = {}) {
 				name
 			],
 			mutationFn: (args) => runtime.db().$rpc(name, args ?? {}).orThrow(asException),
-			onSuccess: (_data, _variables, _result, context) => invalidateTables(context.client, (sb.options.rpc?.[name]?.invalidates ?? []).flatMap((table) => invalidationTargets(sb.meta, table)))
+			onSuccess: (_data, _variables, _result, context) => invalidateTables(context.client, (betterSupabase.options.rpc?.[name]?.invalidates ?? []).flatMap((table) => invalidationTargets(betterSupabase.meta, table)))
 		})
 	};
-	for (const table of Object.keys(sb.meta.tables)) {
+	for (const table of Object.keys(betterSupabase.meta.tables)) {
 		let built;
 		Object.defineProperty(queries, table, {
 			enumerable: true,
@@ -178,9 +178,9 @@ function queryCache(client) {
 		invalidate: (target) => invalidateTables(client, target.tables)
 	};
 }
-/** Invalidates affected queries for every mutation and declared RPC `sb` performs in this runtime. */
-function invalidateOnMutation(sb, client) {
-	return sb.cache(queryCache(client));
+/** Invalidates affected queries for every mutation and declared RPC `betterSupabase` performs in this runtime. */
+function invalidateOnMutation(betterSupabase, client) {
+	return betterSupabase.cache(queryCache(client));
 }
 //#endregion
 export { invalidateOnMutation as n, queryCache as r, createQueries as t };

package/dist/react/index.d.ts

@@ -1,7 +1,7 @@
-import { s as Impersonator } from "../mfa-x3V3vGh-.js";
-import { t as AuthSession } from "../view-3Po_PVlr.js";
-import { r as LiveCountSeed } from "../live-QE3UPbGm.js";
-import { n as MembershipClaim, r as hasEntitlement, t as EntitlementKey } from "../entitlements-DvJXoI02.js";
-import { a as BrowserLike, c as LiveCountHookOptions, d as createHooks, f as useAuth, g as useSupabase, h as useLiveQuery, i as BroadcastOptions, l as LiveQueryHookOptions, m as useLiveCount, n as BetterSupabaseProvider, o as ClaimsOf, p as useBroadcast, r as BetterSupabaseProviderProps, s as LiveCount, t as BetterHooks, u as ProfileOf } from "../index-BNsABq7P.js";
+import { s as Impersonator } from "../mfa-C7MNQ1Ob.js";
+import { t as AuthSession } from "../view-B64o81wp.js";
+import { r as LiveCountSeed } from "../live-BHakSWWo.js";
+import { n as MembershipClaim, r as hasEntitlement, t as EntitlementKey } from "../entitlements-Dm-FHpNH.js";
+import { a as ClaimsOf, c as LiveCountHookOptions, d as createHooks, f as useAuth, g as useSupabase, h as useLiveQuery, i as BroadcastOptions, l as LiveQueryHookOptions, m as useLiveCount, n as BetterSupabaseProvider, o as ClientLike, p as useBroadcast, r as BetterSupabaseProviderProps, s as LiveCount, t as BetterHooks, u as ProfileOf } from "../index-BBdvo-5d.js";
 import { SessionProvider, SessionProviderProps, useSession } from "./session.js";
-export { type AuthSession, type BetterHooks, BetterSupabaseProvider, type BetterSupabaseProviderProps, type BroadcastOptions, type BrowserLike, type ClaimsOf, type EntitlementKey, type Impersonator, type LiveCount, type LiveCountHookOptions, type LiveCountSeed, type LiveQueryHookOptions, type MembershipClaim, type ProfileOf, SessionProvider, type SessionProviderProps, createHooks, hasEntitlement, useAuth, useBroadcast, useLiveCount, useLiveQuery, useSession, useSupabase };
+export { type AuthSession, type BetterHooks, BetterSupabaseProvider, type BetterSupabaseProviderProps, type BroadcastOptions, type ClaimsOf, type ClientLike, type EntitlementKey, type Impersonator, type LiveCount, type LiveCountHookOptions, type LiveCountSeed, type LiveQueryHookOptions, type MembershipClaim, type ProfileOf, SessionProvider, type SessionProviderProps, createHooks, hasEntitlement, useAuth, useBroadcast, useLiveCount, useLiveQuery, useSession, useSupabase };

package/dist/react/index.js

@@ -1,5 +1,5 @@
 "use client";
 import { SessionProvider, useSession } from "./session.js";
-import { a as useLiveCount, i as useBroadcast, n as createHooks, o as useLiveQuery, r as useAuth, s as useSupabase, t as BetterSupabaseProvider } from "../react-DNBYNazu.js";
+import { a as useLiveCount, i as useBroadcast, n as createHooks, o as useLiveQuery, r as useAuth, s as useSupabase, t as BetterSupabaseProvider } from "../react-CQHMaESR.js";
 import { t as hasEntitlement } from "../entitlements-CTEBm7IB.js";
 export { BetterSupabaseProvider, SessionProvider, createHooks, hasEntitlement, useAuth, useBroadcast, useLiveCount, useLiveQuery, useSession, useSupabase };

package/dist/react/server.d.ts

@@ -1,13 +1,13 @@
-import { t as AuthSession } from "../view-3Po_PVlr.js";
-import { a as BrowserLike, f as useAuth, g as useSupabase, h as useLiveQuery, i as BroadcastOptions, l as LiveQueryHookOptions, n as BetterSupabaseProvider, o as ClaimsOf, p as useBroadcast, r as BetterSupabaseProviderProps, t as BetterHooks, u as ProfileOf } from "../index-BNsABq7P.js";
+import { t as AuthSession } from "../view-B64o81wp.js";
+import { a as ClaimsOf, f as useAuth, g as useSupabase, h as useLiveQuery, i as BroadcastOptions, l as LiveQueryHookOptions, n as BetterSupabaseProvider, o as ClientLike, p as useBroadcast, r as BetterSupabaseProviderProps, t as BetterHooks, u as ProfileOf } from "../index-BBdvo-5d.js";
 import { SessionProvider, SessionProviderProps } from "./session.js";
 //#region src/react/server.d.ts
-/** The `react-server` build of `useSession`: await `next.session()` instead. */
+/** The `react-server` build of `useSession`: await `bs.session()` instead. */
 export declare const useSession: <C = unknown, P = unknown>() => AuthSession<C, P>;
 /**
  * The `react-server` build of `createHooks`: importing a module that creates
  * hooks is safe on the server, calling a hook there throws.
  */
-export declare function createHooks<B extends BrowserLike>(): BetterHooks<B>;
+export declare function createHooks<B extends ClientLike>(): BetterHooks<B>;
 //#endregion
-export { type AuthSession, type BetterHooks, BetterSupabaseProvider, type BetterSupabaseProviderProps, type BroadcastOptions, type BrowserLike, type ClaimsOf, type LiveQueryHookOptions, type ProfileOf, SessionProvider, type SessionProviderProps, useAuth, useBroadcast, useLiveQuery, useSupabase };
+export { type AuthSession, type BetterHooks, BetterSupabaseProvider, type BetterSupabaseProviderProps, type BroadcastOptions, type ClaimsOf, type ClientLike, type LiveQueryHookOptions, type ProfileOf, SessionProvider, type SessionProviderProps, useAuth, useBroadcast, useLiveQuery, useSupabase };

package/dist/react/server.js

@@ -1,12 +1,12 @@
-import { i as useBroadcast, o as useLiveQuery, r as useAuth, s as useSupabase, t as BetterSupabaseProvider } from "../react-DNBYNazu.js";
+import { i as useBroadcast, o as useLiveQuery, r as useAuth, s as useSupabase, t as BetterSupabaseProvider } from "../react-CQHMaESR.js";
 import { SessionProvider } from "./session.js";
 //#region src/react/server.ts
 function clientOnly(name) {
 	return () => {
-		throw new Error(`better-supabase: ${name}() runs in Client Components only. In Server Components use \`next.server()\` or \`db.$run(spec)\`.`);
+		throw new Error(`better-supabase: ${name}() runs in Client Components only. In Server Components use \`bs.context()\` or \`db.$run(spec)\`.`);
 	};
 }
-/** The `react-server` build of `useSession`: await `next.session()` instead. */
+/** The `react-server` build of `useSession`: await `bs.session()` instead. */
 const useSession = clientOnly("useSession");
 /**
 * The `react-server` build of `createHooks`: importing a module that creates

package/dist/react/session.d.ts

@@ -1,9 +1,9 @@
-import { t as AuthSession } from "../view-3Po_PVlr.js";
+import { t as AuthSession } from "../view-B64o81wp.js";
 import { ReactNode } from "react";
 //#region src/react/session.d.ts
 export interface SessionProviderProps {
   /**
-   * An unresolved `next.session()` promise, created inside a `<Suspense>`
+   * An unresolved `bs.session()` promise, created inside a `<Suspense>`
    * boundary so the layout itself never waits for auth.
    */
   readonly sessionPromise: Promise<AuthSession>;
@@ -14,8 +14,8 @@ export declare function SessionProvider(props: SessionProviderProps): ReactNode;
 /**
  * The session from the nearest `<SessionProvider>`. Suspends until the
  * promise resolves, so render it inside `<Suspense>`. `C` types the claims
- * (the output of `sb.claims(schema)`) and `P` the profile (the output of
- * `sb.userMetadata(schema)`); `createHooks().useSession` infers both.
+ * (the output of `betterSupabase.claims(schema)`) and `P` the profile (the output of
+ * `betterSupabase.userMetadata(schema)`); `createHooks().useSession` infers both.
  */
 export declare function useSession<C = unknown, P = unknown>(): AuthSession<C, P>;
 //#endregion

package/dist/react/session.js

@@ -9,8 +9,8 @@ function SessionProvider(props) {
 /**
 * The session from the nearest `<SessionProvider>`. Suspends until the
 * promise resolves, so render it inside `<Suspense>`. `C` types the claims
-* (the output of `sb.claims(schema)`) and `P` the profile (the output of
-* `sb.userMetadata(schema)`); `createHooks().useSession` infers both.
+* (the output of `betterSupabase.claims(schema)`) and `P` the profile (the output of
+* `betterSupabase.userMetadata(schema)`); `createHooks().useSession` infers both.
 */
 function useSession() {
 	const promise = useContext(SessionContext);

package/dist/{react-DNBYNazu.js → react-CQHMaESR.js}

@@ -1,66 +1,66 @@
-import { i as tenantClaimPaths, n as claimAt, r as claimsOf } from "./claims-CoTobNC-.js";
-import { t as invalidateTables } from "./invalidate-DbxuL2jL.js";
-import { n as liveQuery, t as liveCount } from "./live-D8rV1Ldw.js";
+import { i as tenantClaimPaths, n as claimAt, r as claimsOf } from "./claims-BAf6c7is.js";
+import { t as invalidateTables } from "./invalidate-CgxmRamI.js";
+import { n as liveQuery, t as liveCount } from "./live-CdJBOc4f.js";
 import { useSession } from "./react/session.js";
 import { createContext, createElement, useContext, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 //#region src/react/hooks.ts
-const BrowserContext = createContext(null);
+const ClientContext = createContext(null);
 const LOADING = {
 	status: "loading",
 	user: null,
 	claims: null
 };
-/** Provides the browser client to the hooks. */
+/** Provides the better-supabase client to the hooks. */
 function BetterSupabaseProvider(props) {
-	const { browser, queryClient } = props;
+	const { client, queryClient } = props;
 	const user = useRef(void 0);
-	useEffect(() => browser.auth.subscribe(() => {
-		const snapshot = browser.auth.current();
+	useEffect(() => client.auth.subscribe(() => {
+		const snapshot = client.auth.current();
 		if (snapshot.status === "loading") return;
 		const id = snapshot.user?.id ?? null;
 		if (user.current !== void 0 && user.current !== id) queryClient?.removeQueries({ queryKey: ["bs"] });
 		user.current = id;
-	}), [browser, queryClient]);
+	}), [client, queryClient]);
 	const value = useMemo(() => ({
-		browser,
+		client,
 		queryClient
-	}), [browser, queryClient]);
-	return createElement(BrowserContext.Provider, { value }, props.children);
+	}), [client, queryClient]);
+	return createElement(ClientContext.Provider, { value }, props.children);
 }
-function useBrowserContext() {
-	const value = useContext(BrowserContext);
-	if (!value) throw new Error("better-supabase: wrap your app in <BetterSupabaseProvider browser={browser}>");
+function useClientContext() {
+	const value = useContext(ClientContext);
+	if (!value) throw new Error("better-supabase: wrap your app in <BetterSupabaseProvider client={bs}>");
 	return value;
 }
-function useBrowser() {
-	return useBrowserContext().browser;
+function useClient() {
+	return useClientContext().client;
 }
 /** The session state for UI: `loading`, `signed-out` or `signed-in` with the user and claims. */
 function useAuth() {
-	const browser = useBrowser();
-	return useSyncExternalStore(browser.auth.subscribe, browser.auth.current, () => LOADING);
+	const client = useClient();
+	return useSyncExternalStore(client.auth.subscribe, client.auth.current, () => LOADING);
 }
 function useSupabase() {
-	return useBrowser().supabase;
+	return useClient().supabase;
 }
 /**
 * Hooks typed for your schema.
 *
 * ```ts
-* export const { useDb, useQueries, useAuth } = createHooks<typeof browser>();
+* export const { useDb, useQueries, useAuth } = createHooks<typeof bs>();
 * ```
 */
 function createHooks() {
 	return {
 		useDb() {
-			const browser = useBrowser();
+			const client = useClient();
 			useAuth();
-			return browser.db;
+			return client.db;
 		},
 		useQueries() {
-			const browser = useBrowser();
+			const client = useClient();
 			useAuth();
-			return browser.queries;
+			return client.queries;
 		},
 		useSupabase,
 		useAuth,
@@ -76,7 +76,7 @@ function createHooks() {
 * ```
 */
 function useBroadcast(topic, values, handlers, options) {
-	const { browser, queryClient } = useBrowserContext();
+	const { client, queryClient } = useClientContext();
 	const auth = useAuth();
 	const [status, setStatus] = useState("closed");
 	const latest = useRef({
@@ -106,7 +106,7 @@ function useBroadcast(topic, values, handlers, options) {
 			}
 			for (const queryKey of invalidate(message)) queryClient.invalidateQueries({ queryKey });
 		};
-		const subscription = topic.subscribe(browser.supabase, matched, { "*": forward }, {
+		const subscription = topic.subscribe(client.supabase, matched, { "*": forward }, {
 			...latest.current.options?.self === void 0 ? {} : { self: latest.current.options.self },
 			onStatus: setStatus,
 			onInvalid: (message, issues) => latest.current.options?.onInvalid?.(message, issues)
@@ -116,7 +116,7 @@ function useBroadcast(topic, values, handlers, options) {
 			setStatus("closed");
 		};
 	}, [
-		browser,
+		client,
 		topic,
 		name,
 		userId,
@@ -138,23 +138,23 @@ function claimedTenant(auth, meta) {
 * resubscribes when the spec, tenant or user changes.
 *
 * ```ts
-* const spec = sb.spec.customers.findMany({ include: { notes: true } });
+* const spec = betterSupabase.spec.customers.findMany({ include: { notes: true } });
 * const { data } = useQuery(q.$spec(spec));
 * useLiveQuery(spec);
 * ```
 */
 function useLiveQuery(spec, options = {}) {
-	const { browser, queryClient } = useBrowserContext();
+	const { client, queryClient } = useClientContext();
 	const auth = useAuth();
 	const [status, setStatus] = useState("closed");
 	if (spec && !queryClient) throw new Error("better-supabase: useLiveQuery needs <BetterSupabaseProvider queryClient={...}>");
 	const key = spec ? JSON.stringify(spec) : null;
-	const tenant = options.tenant ?? claimedTenant(auth, browser.sb.meta);
+	const tenant = options.tenant ?? claimedTenant(auth, client.betterSupabase.meta);
 	const userId = auth.user?.id ?? null;
 	const debounceMs = options.debounceMs;
 	useEffect(() => {
 		if (!key || !queryClient || auth.status === "loading") return;
-		const live = liveQuery(browser.sb, browser.supabase, JSON.parse(key), {
+		const live = liveQuery(client.betterSupabase, client.supabase, JSON.parse(key), {
 			onChange: (tables) => void invalidateTables(queryClient, tables),
 			onStatus: setStatus,
 			...tenant === void 0 ? {} : { tenant },
@@ -164,7 +164,7 @@ function useLiveQuery(spec, options = {}) {
 			live.unsubscribe();
 		};
 	}, [
-		browser,
+		client,
 		queryClient,
 		key,
 		tenant,
@@ -177,15 +177,15 @@ function useLiveQuery(spec, options = {}) {
 /**
 * A count that stays current: refetches only the `count` spec (a HEAD
 * request) after each debounced change to a table it reads, and after the
-* channel rejoins. Takes a spec or a `next.liveCount()` seed; pass `null` to
+* channel rejoins. Takes a spec or a `bs.liveCount()` seed; pass `null` to
 * pause. Doesn't need a `QueryClient`.
 *
 * ```tsx
-* const { count } = useLiveCount(seed); // seed = await next.liveCount(spec)
+* const { count } = useLiveCount(seed); // seed = await bs.liveCount(spec)
 * ```
 */
 function useLiveCount(source, options = {}) {
-	const { browser } = useBrowserContext();
+	const { client } = useClientContext();
 	const auth = useAuth();
 	const seed = source && "spec" in source ? source : void 0;
 	const spec = seed ? seed.spec : source;
@@ -197,13 +197,13 @@ function useLiveCount(source, options = {}) {
 	});
 	const [status, setStatus] = useState("closed");
 	const key = spec ? JSON.stringify(spec) : null;
-	const tenant = options.tenant ?? claimedTenant(auth, browser.sb.meta);
+	const tenant = options.tenant ?? claimedTenant(auth, client.betterSupabase.meta);
 	const userId = auth.user?.id ?? null;
 	const debounceMs = options.debounceMs;
 	const hasInitial = initial !== void 0;
 	useEffect(() => {
 		if (!key || auth.status === "loading") return;
-		const live = liveCount(browser.sb, browser.supabase, browser.db, JSON.parse(key), {
+		const live = liveCount(client.betterSupabase, client.supabase, client.db, JSON.parse(key), {
 			immediate: !hasInitial,
 			onCount: (count) => {
 				setState({
@@ -227,7 +227,7 @@ function useLiveCount(source, options = {}) {
 			live.unsubscribe();
 		};
 	}, [
-		browser,
+		client,
 		key,
 		tenant,
 		userId,

package/dist/{read-set-D0qBcboM.js → read-set-FWK8qQ58.js}

@@ -1,5 +1,5 @@
-import { r as IrBuilder, u as tableMeta } from "./simplify-LakqK1vH.js";
-import { n as touchedTables } from "./tables-Dhha3BXM.js";
+import { r as builderFor, u as tableMeta } from "./simplify-Cqvfr9dj.js";
+import { n as touchedTables } from "./tables-Cb-3_VWc.js";
 //#region src/core/spec.ts
 const READ_METHODS = [
 	"findMany",
@@ -40,7 +40,6 @@ function specOptions(spec) {
 	const value = spec.method === "findById" ? spec.args[1] : spec.args[0];
 	return typeof value === "object" && value !== null ? value : void 0;
 }
-const builders = /* @__PURE__ */ new WeakMap();
 /**
 * App keys of every table a spec reads: its table, included relations and
 * relations used in `where`. Queries keyed by a spec go stale when any of
@@ -48,18 +47,54 @@ const builders = /* @__PURE__ */ new WeakMap();
 * spec reports the error.
 */
 function specTables(meta, spec) {
+	const table = meta.tables[spec.table];
+	const args = specOptions(spec);
+	if (table && args?.["include"] === void 0 && !touchesRelations(table, args?.["where"])) return [spec.table];
+	const key = specKey(spec);
+	let byKey = tablesByMeta.get(meta);
+	if (!byKey) {
+		byKey = /* @__PURE__ */ new Map();
+		tablesByMeta.set(meta, byKey);
+	}
+	const known = key === void 0 ? void 0 : byKey.get(key);
+	if (known) return [...known];
+	let tables;
 	try {
-		return readTables(meta, spec);
+		tables = readTables(meta, spec);
 	} catch {
-		return [spec.table];
+		tables = [spec.table];
+	}
+	if (key !== void 0) {
+		if (byKey.size >= SPEC_CACHE_SIZE) byKey.clear();
+		byKey.set(key, tables);
 	}
+	return [...tables];
 }
-function readTables(meta, spec) {
-	let builder = builders.get(meta);
-	if (!builder) {
-		builder = new IrBuilder(meta);
-		builders.set(meta, builder);
+const SPEC_CACHE_SIZE = 500;
+const tablesByMeta = /* @__PURE__ */ new WeakMap();
+/** A text key for the spec, or `undefined` when its arguments do not serialize. */
+function specKey(spec) {
+	try {
+		return JSON.stringify([
+			spec.table,
+			spec.method,
+			spec.args
+		], (_key, value) => typeof value === "bigint" ? `${value}n` : value);
+	} catch {
+		return;
 	}
+}
+function touchesRelations(table, where) {
+	if (typeof where !== "object" || where === null) return false;
+	if (Array.isArray(where)) return where.some((item) => touchesRelations(table, item));
+	for (const [key, value] of Object.entries(where)) {
+		if (key in table.relations) return true;
+		if ((key === "AND" || key === "OR" || key === "NOT") && touchesRelations(table, value)) return true;
+	}
+	return false;
+}
+function readTables(meta, spec) {
+	const builder = builderFor(meta);
 	const table = tableMeta(meta, spec.table);
 	const args = specOptions(spec);
 	const counts = spec.method === "count" || spec.method === "exists" || spec.method === "aggregate";
@@ -98,7 +133,7 @@ function sentinel(name) {
 *
 * ```ts
 * export const appChrome = defineReadSet(
-*   sb,
+*   betterSupabase,
 *   'app_chrome',
 *   { params: { userId: 'uuid' } },
 *   (s, p) => ({
@@ -111,7 +146,7 @@ function sentinel(name) {
 * `p` holds placeholders, not values: pass them straight into `where` (or
 * `in`), where the function reads them from its `p jsonb` argument.
 */
-function defineReadSet(sb, name, options, build) {
+function defineReadSet(betterSupabase, name, options, build) {
 	if (!NAME.test(name)) throw new TypeError(`better-supabase: read set name "${name}" must be snake_case and at most 60 characters`);
 	const params = options.params ?? {};
 	const placeholders = {};
@@ -120,10 +155,10 @@ function defineReadSet(sb, name, options, build) {
 		if (!TYPE.test(type)) throw new TypeError(`better-supabase: read set "${name}" parameter "${key}" has an invalid type "${type}"`);
 		placeholders[key] = type.endsWith("[]") ? [sentinel(key)] : sentinel(key);
 	}
-	const specs = build(sb.spec, placeholders);
+	const specs = build(betterSupabase.spec, placeholders);
 	const entries = Object.entries(specs);
 	if (entries.length === 0 || entries.length > MAX_ENTRIES) throw new TypeError(`better-supabase: read set "${name}" needs between 1 and ${MAX_ENTRIES} reads`);
-	for (const [key, spec] of entries) if (!isQuerySpec(spec)) throw new TypeError(`better-supabase: read set "${name}" entry "${key}" is not a spec from sb.spec`);
+	for (const [key, spec] of entries) if (!isQuerySpec(spec)) throw new TypeError(`better-supabase: read set "${name}" entry "${key}" is not a spec from betterSupabase.spec`);
 	return {
 		kind: "read-set",
 		name,
@@ -131,7 +166,7 @@ function defineReadSet(sb, name, options, build) {
 		params,
 		roles: options.roles ?? ["authenticated"],
 		specs,
-		definition: sb
+		definition: betterSupabase
 	};
 }
 function isReadSet(value) {

package/dist/realtime/index.d.ts

@@ -1,5 +1,5 @@
 import { x as PermdockTopicPolicy } from "../types-DONv9SHN.js";
 import { t as PermdockCatalog } from "../permdock-sql-DImJULY-.js";
 import { n as TemplateValues, t as TemplateParams } from "../template-mbvlysOo.js";
-import { C as defineTopic, S as TriggerOptions, _ as TopicEvent, a as LiveSource, b as TopicOptions, c as liveQuery, d as RealtimeClient, f as RowChange, g as Topic, h as SubscriptionStatus, i as LiveQueryOptions, l as liveTopic, m as Subscription, n as LiveCountOptions, o as LiveSubscription, p as SubscribeOptions, r as LiveCountSeed, s as liveCount, t as CountRunner, u as EventSchemas, v as TopicHandlers, w as rowChange, x as TopicPayload, y as TopicMessage } from "../live-QE3UPbGm.js";
+import { C as defineTopic, S as TriggerOptions, _ as TopicEvent, a as LiveSource, b as TopicOptions, c as liveQuery, d as RealtimeClient, f as RowChange, g as Topic, h as SubscriptionStatus, i as LiveQueryOptions, l as liveTopic, m as Subscription, n as LiveCountOptions, o as LiveSubscription, p as SubscribeOptions, r as LiveCountSeed, s as liveCount, t as CountRunner, u as EventSchemas, v as TopicHandlers, w as rowChange, x as TopicPayload, y as TopicMessage } from "../live-BHakSWWo.js";
 export { type CountRunner, type EventSchemas, type LiveCountOptions, type LiveCountSeed, type LiveQueryOptions, type LiveSource, type LiveSubscription, type PermdockCatalog, type PermdockTopicPolicy, type RealtimeClient, type RowChange, type SubscribeOptions, type Subscription, type SubscriptionStatus, type TemplateParams, type TemplateValues, type Topic, type TopicEvent, type TopicHandlers, type TopicMessage, type TopicOptions, type TopicPayload, type TriggerOptions, defineTopic, liveCount, liveQuery, liveTopic, rowChange };