better-supabase 0.2.0 → 0.4.0

package/dist/postgres/index.d.ts

@@ -1,7 +1,7 @@
-import { g as Operation } from "../executor-CGdNQ27g.js";
-import { n as fromPgError, r as postgresExecutor, t as SqlClient } from "../executor-BYXQ9AGn.js";
-import { i as createPostgres, n as PostgresOptions, r as SqlClaims, t as Postgres } from "../pool-R2m_DkXi.js";
-import { t as Compiler } from "../compiler-CZ9nIuqy.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;
@@ -17,6 +17,11 @@ interface SqlPlan {
   readonly count: SqlQuery | undefined;
   /** No row can match; the executor returns an empty result without a query. */
   readonly never: boolean;
+  /**
+   * The rest of an insert split to stay under the bind-parameter limit. They
+   * run after this plan, in the same transaction; rows and counts add up.
+   */
+  readonly chunks?: readonly SqlPlan[];
 }
 export declare function quoteIdent(name: string): string;
 /** Compiles an operation to parameterized SQL. Rows come back as json. */
@@ -25,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 Postgres, type PostgresOptions, 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,35 +1,55 @@
-import { n as quoteIdent, t as compileSql } from "../sql-DTjA1LPj.js";
-import { n as postgresExecutor, t as fromPgError } from "../executor-DeppvirK.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 = {
+	authenticated: 8e3,
+	anon: 3e3
+};
 const ROLES = /* @__PURE__ */ new Set(["authenticated", "anon"]);
 function roleOf(claims) {
 	const role = claims.role ?? (claims.sub ? "authenticated" : "anon");
 	if (!ROLES.has(role)) throw new TypeError(`Cannot run as role "${role}": only "authenticated" and "anon" are assumed. Use postgres.admin for service work.`);
 	return role;
 }
+function openPool(options) {
+	const connectionString = options.connectionString ?? process.env["SUPABASE_DB_URL"] ?? process.env["DATABASE_URL"];
+	if (!connectionString) throw new TypeError("createPostgres needs a connectionString, $SUPABASE_DB_URL or $DATABASE_URL");
+	return new Pool({
+		connectionString,
+		max: options.max ?? 10,
+		connectionTimeoutMillis: options.connectionTimeout ?? 1e4,
+		idleTimeoutMillis: options.idleTimeout ?? 1e4
+	});
+}
 /**
 * A pooled Postgres connection for jobs, scripts and tests. Each query (or
 * transaction) runs in its own transaction; claims and role are
 * transaction-local, so nothing leaks back into the pool.
 */
 function createPostgres(options = {}) {
-	const connectionString = options.connectionString ?? process.env["SUPABASE_DB_URL"] ?? process.env["DATABASE_URL"];
-	if (!connectionString) throw new TypeError("createPostgres needs a connectionString, $SUPABASE_DB_URL or $DATABASE_URL");
-	const pool = new Pool({
-		connectionString,
-		max: options.max ?? 10
-	});
+	const pool = options.pool ?? openPool(options);
+	const timeouts = typeof options.statementTimeout === "number" ? {
+		admin: options.statementTimeout,
+		authenticated: options.statementTimeout,
+		anon: options.statementTimeout
+	} : {
+		...DEFAULT_TIMEOUTS,
+		...options.statementTimeout
+	};
+	/** Opens the transaction, then sets the timeouts, claims and role in one round trip. */
 	async function begin(client, session) {
 		await client.query("begin");
-		if (options.statementTimeout !== void 0) await client.query(`set local statement_timeout = ${Math.trunc(options.statementTimeout)}`);
-		if (session) {
-			await client.query("select set_config('request.jwt.claims', $1, true)", [JSON.stringify({
-				...session.claims,
-				role: session.role
-			})]);
-			await client.query(`set local role ${session.role}`);
-		}
+		const settings = [];
+		const timeout = session?.role === "authenticated" ? timeouts.authenticated : session?.role === "anon" ? timeouts.anon : timeouts.admin;
+		if (timeout !== void 0) settings.push(["statement_timeout", String(Math.trunc(timeout))]);
+		if (options.idleInTransactionTimeout !== void 0) settings.push(["idle_in_transaction_session_timeout", String(Math.trunc(options.idleInTransactionTimeout))]);
+		if (session) settings.push(["request.jwt.claims", JSON.stringify({
+			...session.claims,
+			role: session.role
+		})], ["role", session.role]);
+		if (settings.length === 0) return;
+		await client.query(`select ${settings.map((_, index) => `set_config($${index * 2 + 1}, $${index * 2 + 2}, true)`).join(", ")}`, settings.flat());
 	}
 	async function transaction(session, fn) {
 		const client = await pool.connect();
@@ -64,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-cAEQ_IQN.d.ts → postgrest-Bc-0Xw62.d.ts}

@@ -1,4 +1,4 @@
-import { g as Operation } from "./executor-CGdNQ27g.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-BTkTtRV9.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";
@@ -33,7 +33,7 @@ const INTERNAL = /* @__PURE__ */ new Set([
 /** Converts a `DbError` to Problem Details. */
 function toProblem(error, options = {}) {
 	const problem = {
-		type: `${PROBLEM_TYPE_BASE}${error.kind.replace(/_/g, "-")}`,
+		type: `${PROBLEM_TYPE_BASE}${error.kind.replaceAll("_", "-")}`,
 		title: TITLES[error.kind],
 		status: error.status,
 		kind: error.kind
@@ -47,21 +47,26 @@ function toProblem(error, options = {}) {
 	if ("column" in error && error.column) problem["column"] = error.column;
 	if ("issues" in error) problem["issues"] = error.issues;
 	if ("required" in error) problem["required"] = error.required;
+	if ("scopes" in error) problem["scopes"] = error.scopes;
 	if ("retryAfter" in error) problem["retryAfter"] = error.retryAfter;
 	return problem;
 }
 /**
-* An `application/problem+json` response. A 401 carries an RFC 6750
-* `WWW-Authenticate: Bearer` challenge.
+* An `application/problem+json` response. A 401, and a 403 for a missing
+* OAuth scope, carry an RFC 6750 `WWW-Authenticate: Bearer` challenge.
 */
 function problemResponse(error, options = {}) {
 	const headers = new Headers(options.headers);
 	headers.set("content-type", PROBLEM_CONTENT_TYPE);
+	const realm = (options.realm ?? "supabase").replaceAll("\"", "");
 	if (error.status === 401 && !headers.has("www-authenticate")) {
-		const realm = (options.realm ?? "supabase").replace(/"/g, "");
 		const params = error.code === "MISSING_CREDENTIALS" ? "" : ", error=\"invalid_token\"";
 		headers.set("www-authenticate", `Bearer realm="${realm}"${params}`);
 	}
+	if ("scopes" in error && error.code === "INSUFFICIENT_SCOPE" && !headers.has("www-authenticate")) {
+		const scope = error.scopes.join(" ").replaceAll("\"", "");
+		headers.set("www-authenticate", `Bearer realm="${realm}", error="insufficient_scope", scope="${scope}"`);
+	}
 	if ("retryAfter" in error && !headers.has("retry-after")) headers.set("retry-after", String(error.retryAfter));
 	return new Response(JSON.stringify(toProblem(error, options)), {
 		status: error.status,
@@ -87,6 +92,7 @@ function fromProblem(problem) {
 		"columns",
 		"column",
 		"required",
+		"scopes",
 		"retryAfter"
 	]) if (problem[key] !== void 0) extra[key] = problem[key];
 	extra["issues"] = problem.issues ?? [];

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

@@ -1,4 +1,4 @@
-import { b as ValidationIssue, m as DbErrorKind, p as DbError } from "./result-CTkCZ6JA.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 {
@@ -17,6 +17,8 @@ interface ProblemDetails {
   readonly issues?: readonly ValidationIssue[];
   /** The assurance level a `forbidden` answer needs (`aal2`). */
   readonly required?: "aal1" | "aal2";
+  /** The OAuth scopes a `forbidden` answer needs. */
+  readonly scopes?: readonly string[];
   /** Seconds until a `rate_limited` caller may retry. */
   readonly retryAfter?: number;
 }
@@ -29,15 +31,15 @@ interface ProblemOptions {
   readonly expose?: boolean;
 }
 interface ProblemResponseOptions extends ProblemOptions {
-  readonly headers?: HeadersInit;
+  readonly headers?: ConstructorParameters<typeof Headers>[0];
   /** `realm` of the RFC 6750 challenge on 401. */
   readonly realm?: string;
 }
 /** Converts a `DbError` to Problem Details. */
 declare function toProblem(error: DbError, options?: ProblemOptions): ProblemDetails;
 /**
- * An `application/problem+json` response. A 401 carries an RFC 6750
- * `WWW-Authenticate: Bearer` challenge.
+ * An `application/problem+json` response. A 401, and a 403 for a missing
+ * OAuth scope, carry an RFC 6750 `WWW-Authenticate: Bearer` challenge.
  */
 declare function problemResponse(error: DbError, options?: ProblemResponseOptions): Response;
 declare function isProblem(value: unknown): value is 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-K-3WM2Hp.js";
-export { type BetterQueryMeta, CreateQueriesOptions, InfiniteOptionsOf, MutationOptionsOf, Queries, QueryHelpers, QueryKeyOf, QueryOptionsOf, 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-ChvDbsDE.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-ChvDbsDE.js → query-BMMSWbI7.js}

@@ -1,8 +1,8 @@
-import { t as DbException } from "./errors-Bl3rkOzo.js";
-import { t as invalidationTargets } from "./tables-rZxRxNPW.js";
-import { t as invalidateTables } from "./invalidate-DbxuL2jL.js";
-//#region src/query/index.ts
-/** Query errors stay `DbException`s, even for an `sb` with `mapError()`. */
+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 `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-TVia554c.js";
-import { t as AuthSession } from "../view-D1s0wa0T.js";
-import { r as LiveCountSeed } from "../live-DJyZMD6w.js";
-import { n as MembershipClaim, r as hasEntitlement, t as EntitlementKey } from "../entitlements-Dng-ctuT.js";
-import { n as SessionProviderProps, r as useSession, t as SessionProvider } from "../session-C3LxnQ0e.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-CBDufH1M.js";
-export { type AuthSession, BetterHooks, BetterSupabaseProvider, BetterSupabaseProviderProps, BroadcastOptions, BrowserLike, ClaimsOf, type EntitlementKey, type Impersonator, LiveCount, LiveCountHookOptions, type LiveCountSeed, LiveQueryHookOptions, type MembershipClaim, ProfileOf, SessionProvider, type SessionProviderProps, createHooks, hasEntitlement, useAuth, useBroadcast, useLiveCount, useLiveQuery, useSession, useSupabase };
+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 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 { n as useSession, t as SessionProvider } from "../session-CqEwzVup.js";
+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-CQHMaESR.js";
 import { t as hasEntitlement } from "../entitlements-CTEBm7IB.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-C83BdBGt.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-D1s0wa0T.js";
-import { n as SessionProviderProps, t as SessionProvider } from "../session-C3LxnQ0e.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-CBDufH1M.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-C83BdBGt.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,2 +1,21 @@
-import { n as SessionProviderProps, r as useSession, t as SessionProvider } from "../session-C3LxnQ0e.js";
-export { SessionProvider, SessionProviderProps, useSession };
+import { t as AuthSession } from "../view-B64o81wp.js";
+import { ReactNode } from "react";
+//#region src/react/session.d.ts
+export interface SessionProviderProps {
+  /**
+   * An unresolved `bs.session()` promise, created inside a `<Suspense>`
+   * boundary so the layout itself never waits for auth.
+   */
+  readonly sessionPromise: Promise<AuthSession>;
+  readonly children?: ReactNode;
+}
+/** Shares the server-verified session with Client Components. */
+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 `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

@@ -1,3 +1,21 @@
 "use client";
-import { n as useSession, t as SessionProvider } from "../session-CqEwzVup.js";
+import { createContext, createElement, use, useContext } from "react";
+//#region src/react/session.ts
+const SessionContext = createContext(null);
+/** Shares the server-verified session with Client Components. */
+function SessionProvider(props) {
+	return createElement(SessionContext.Provider, { value: props.sessionPromise }, props.children);
+}
+/**
+* The session from the nearest `<SessionProvider>`. Suspends until the
+* promise resolves, so render it inside `<Suspense>`. `C` types the claims
+* (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);
+	if (!promise) throw new Error("better-supabase: useSession() needs <SessionProvider sessionPromise={...}>");
+	return use(promise);
+}
+//#endregion
 export { SessionProvider, useSession };