better-supabase 0.14.0 → 0.15.0

package/dist/rate-limit-o44SYkVY.js

@@ -0,0 +1,327 @@
+import { n as dbError } from "./errors-BVFgt8BZ.js";
+import { n as isRecord } from "./guards-6F2bCtQR.js";
+import { a as ok, t as AsyncResult } from "./result-ntFBW2p2.js";
+import { o as problemResponse } from "./problem-Bf0cJ7tk.js";
+import { D as recordOf, E as readBodyCapped, M as seconds, R as toInstant, U as sqlTransport, f as errorText, g as leaseHeartbeat, j as run, k as recordsOf, n as applyTemporal, o as blockCall, s as budget, z as workerId } from "./block-helpers-CtBdjgO4.js";
+import { r as withBlockHooks } from "./block-hooks-BfxX3682.js";
+import { s as verifyWebhook } from "./signatures-CNcoq392.js";
+import { n as blockFields } from "./block-fields-DE_FgpOU.js";
+//#region src/blocks/queue/webhook-inbox.ts
+/**
+* Deletes processed messages from the inbox (`purge_webhooks`) over a service
+* SQL connection or a service-role transport; returns how many.
+*/
+function purgeWebhookInbox(source, options = {}) {
+	const args = {
+		older_than: seconds(options.olderThan ?? "30 days"),
+		include_dead: options.includeDead ?? false,
+		batch: options.batch ?? 1e4,
+		for_tenant: options.tenant ?? null
+	};
+	if ("call" in source) return blockCall(source, options.schema)("purge_webhooks", args, (value) => Number(value ?? 0));
+	return run(async () => {
+		const [row] = await source.queryRaw("select better_supabase.purge_webhooks($1::interval, $2, $3, $4) as purged", [
+			args.older_than,
+			args.include_dead,
+			args.batch,
+			args.for_tenant
+		]);
+		return row?.purged ?? 0;
+	});
+}
+const STATUSES = /* @__PURE__ */ new Set([
+	"pending",
+	"processing",
+	"processed",
+	"dead"
+]);
+function statusOf(value) {
+	if (typeof value !== "string" || !STATUSES.has(value)) return "pending";
+	return value;
+}
+const nullableText = (value) => value === null || value === void 0 ? null : String(value);
+const instantOf = (value) => toInstant(value instanceof Date ? value : String(value));
+const headersOf = (value) => isRecord(value) ? Object.fromEntries(Object.entries(value).map(([key, item]) => [key, String(item)])) : {};
+function defaultType(payload) {
+	if (typeof payload !== "object" || payload === null) return null;
+	const type = payload.type;
+	return typeof type === "string" ? type : null;
+}
+/**
+* Stores one webhook through `receive_webhook` over a service SQL connection;
+* `duplicate` when the id was stored before.
+*/
+async function receiveWebhook(sql, input) {
+	const [row] = await sql.queryRaw("select better_supabase.receive_webhook($1, $2, $3, $4, $5, $6, $7) as value", [
+		input.source,
+		input.id,
+		input.type ?? null,
+		JSON.stringify(input.payload),
+		JSON.stringify(input.headers),
+		input.tenant,
+		input.maxAttempts ?? null
+	]);
+	return storedOf(row?.value);
+}
+function storedOf(value) {
+	const row = recordOf(value, "receive_webhook");
+	return {
+		id: Number(row["id"]),
+		duplicate: row["duplicate"] === true
+	};
+}
+/**
+* Store-then-process webhooks: acknowledge fast, process with retries, never
+* twice. Pass a service transport, `sqlTransport(postgres.admin)`: the inbox
+* functions are granted to the service role only.
+*/
+function createWebhookInbox(options) {
+	applyTemporal(options);
+	const call = blockCall(options.transport, options.schema, options.mappers);
+	const fields = blockFields(options.fields, "webhook inbox fields");
+	const worker = options.worker ?? workerId();
+	const format = options.problem;
+	const maxAttempts = options.maxAttempts ?? 8;
+	if (!Number.isInteger(maxAttempts) || maxAttempts < 1) throw new TypeError(`createWebhookInbox maxAttempts must be a positive integer, not ${String(maxAttempts)}`);
+	const maxBodyBytes = options.maxBodyBytes ?? 1048576;
+	if (!Number.isInteger(maxBodyBytes) || maxBodyBytes < 1) throw new TypeError(`createWebhookInbox maxBodyBytes must be a positive integer, not ${String(maxBodyBytes)}`);
+	const verified = async (request, body) => {
+		if (options.verify) return options.verify(request, body);
+		const result = await verifyWebhook({
+			headers: request.headers,
+			body
+		}, options.secrets ?? []);
+		return result.ok ? ok({
+			id: result.data.id,
+			payload: result.data.payload
+		}) : result;
+	};
+	const save = (event) => fields.args(event.fields).andThen((checked) => call("receive_webhook", {
+		source: options.source,
+		message_id: event.id,
+		event_type: event.type === void 0 ? (options.typeOf ?? defaultType)(event.payload) : event.type,
+		payload: event.payload,
+		headers: event.headers ?? {},
+		tenant: (event.tenant === void 0 ? options.tenantOf?.(event.payload) : event.tenant) ?? null,
+		max_attempts: maxAttempts,
+		fields: checked
+	}, storedOf));
+	/** Runs a call the worker can't go on without; it throws the `DbError`. */
+	const must = (fn, args, then) => call(fn, args, then).orThrow();
+	const client = {
+		store: save,
+		list: (listOptions) => call("list_webhooks", {
+			for_tenant: listOptions.tenant,
+			for_source: options.source,
+			for_status: listOptions.status ?? null,
+			max_rows: listOptions.limit ?? 100
+		}, (value) => recordsOf(value, "list_webhooks").map((row) => ({
+			id: Number(row["id"]),
+			messageId: String(row["message_id"]),
+			type: nullableText(row["event_type"]),
+			status: statusOf(row["status"]),
+			attempts: Number(row["attempts"]),
+			maxAttempts: row["max_attempts"] === null || row["max_attempts"] === void 0 ? maxAttempts : Number(row["max_attempts"]),
+			lastError: nullableText(row["last_error"]),
+			tenant: nullableText(row["tenant"]),
+			receivedAt: instantOf(row["received_at"]),
+			processedAt: row["processed_at"] === null || row["processed_at"] === void 0 ? null : instantOf(row["processed_at"]),
+			fields: isRecord(row["fields"]) ? row["fields"] : {}
+		}))).andThen(fields.rows),
+		purge: (purgeOptions) => purgeWebhookInbox(options.transport, {
+			...options.schema === void 0 ? {} : { schema: options.schema },
+			...purgeOptions
+		}),
+		purgeJob: (purgeOptions) => async () => client.purge(purgeOptions).orThrow(),
+		async receive(request) {
+			const instance = new URL(request.url).pathname;
+			if (request.method !== "POST") return new Response(null, {
+				status: 405,
+				headers: { allow: "POST" }
+			});
+			if (!options.verify && !options.secrets) throw new TypeError(`The inbox for "${options.source}" has no \`secrets\` or \`verify\`, so it only stores events through \`store\``);
+			const body = await readBodyCapped(request.clone(), maxBodyBytes);
+			if (body === void 0) return problemResponse({
+				...dbError("invalid_input", "The body is too large", { code: "WEBHOOK_TOO_LARGE" }),
+				status: 413
+			}, {
+				instance,
+				format
+			});
+			const message = await verified(request, body);
+			if (!message.ok) return problemResponse(message.error, {
+				instance,
+				format
+			});
+			const headers = Object.fromEntries((options.keepHeaders ?? []).flatMap((name) => {
+				const value = request.headers.get(name);
+				return value === null ? [] : [[name.toLowerCase(), value]];
+			}));
+			const stored = await save({
+				id: message.data.id,
+				payload: message.data.payload,
+				headers,
+				...message.data.tenant === void 0 ? {} : { tenant: message.data.tenant }
+			});
+			if (!stored.ok) return problemResponse(stored.error, {
+				instance,
+				format
+			});
+			return Response.json(stored.data, { status: stored.data.duplicate ? 200 : 202 });
+		},
+		async process(handler, processOptions = {}) {
+			let succeeded = 0;
+			let failed = 0;
+			const lease = seconds(processOptions.lease ?? 300);
+			const spent = budget(processOptions.budgetMs);
+			for (;;) {
+				if (spent.expired()) return {
+					succeeded,
+					failed
+				};
+				const rows = await must("claim_webhooks", {
+					source: options.source,
+					worker,
+					batch: processOptions.batch ?? 10,
+					lease
+				}, (value) => recordsOf(value, "claim_webhooks"));
+				if (rows.length === 0) return {
+					succeeded,
+					failed
+				};
+				for (const row of rows) {
+					const id = Number(row["id"]);
+					const attempt = Number(row["attempts"]);
+					const extend = () => must("extend_webhook", {
+						inbox_id: id,
+						worker,
+						attempt,
+						lease
+					}, (value) => value === null || value === void 0 ? void 0 : Number(value));
+					const leaseSeconds = await extend();
+					if (leaseSeconds === void 0) continue;
+					const controller = new AbortController();
+					const stopHeartbeat = leaseHeartbeat(leaseSeconds, () => {
+						extend().then((renewed) => {
+							if (renewed === void 0) controller.abort();
+						}, () => {
+							controller.abort();
+						});
+					});
+					try {
+						const parsed = await fields.read(isRecord(row["fields"]) ? row["fields"] : {});
+						if (!parsed.ok) throw new Error(parsed.error.message);
+						const outcome = await handler({
+							id,
+							source: String(row["source"]),
+							messageId: String(row["message_id"]),
+							type: nullableText(row["event_type"]),
+							payload: row["payload"],
+							headers: headersOf(row["headers"]),
+							attempts: attempt,
+							maxAttempts: row["max_attempts"] === null || row["max_attempts"] === void 0 ? maxAttempts : Number(row["max_attempts"]),
+							receivedAt: instantOf(row["received_at"]),
+							tenant: nullableText(row["tenant"]),
+							progress: isRecord(row["checkpoint"]) ? row["checkpoint"] : {},
+							fields: parsed.data,
+							checkpoint: (progress) => must("checkpoint_webhook", {
+								inbox_id: id,
+								worker,
+								fields: progress,
+								attempt
+							}, (value) => value === true)
+						}, controller.signal);
+						if (controller.signal.aborted) continue;
+						if (typeof outcome === "object" && outcome !== null && "ok" in outcome && outcome.ok === false) throw new Error(errorText(outcome.error ?? "The handler failed"));
+						if (await must("complete_webhook", {
+							inbox_id: id,
+							worker,
+							attempt
+						}, (value) => value !== false)) succeeded += 1;
+					} catch (cause) {
+						if (controller.signal.aborted) continue;
+						await must("fail_webhook", {
+							inbox_id: id,
+							worker,
+							error: errorText(cause),
+							attempt
+						}, () => void 0);
+						failed += 1;
+					} finally {
+						stopHeartbeat();
+					}
+				}
+			}
+		}
+	};
+	return withBlockHooks(client, options.hooks, {
+		block: "webhook-inbox",
+		...options.logger ? { logger: options.logger } : {}
+	});
+}
+//#endregion
+//#region src/blocks/queue/rate-limit.ts
+/**
+* Fixed-window limits for keys that aren't claims, over the `rate-limit`
+* module's counters. Pass `sql`, a service SQL connection (`ctx.postgresAdmin`,
+* `postgres.admin`), or `transport`, a service-role `BlockTransport` such as
+* `rpcTransport(adminClient)`.
+*/
+function createRateLimit(options) {
+	applyTemporal(options);
+	const call = options.transport === void 0 ? blockCall(sqlTransport(options.sql), void 0, options.mappers) : blockCall(options.transport, options.schema, options.mappers);
+	const hit = options.transport === void 0 ? overSql(options.sql) : overTransport(call);
+	const hooked = withBlockHooks({
+		purge: (purgeOptions = {}) => call("purge_rate_limits", { batch: purgeOptions.batch }, (value) => Number(value ?? 0)),
+		purgeJob: (jobOptions) => async () => hooked.purge(jobOptions).orThrow(),
+		check: (scope, key, rule) => {
+			if (rule !== void 0 && (!Number.isInteger(rule.max) || rule.max < 1)) return AsyncResult.err(dbError("invalid_input", "A rate limit's max must be a positive integer"));
+			return hit(scope, key, rule?.max ?? null, rule === void 0 ? null : seconds(rule.period));
+		}
+	}, options.hooks, {
+		block: "rate-limit",
+		...options.logger ? { logger: options.logger } : {}
+	});
+	return hooked;
+}
+const overTransport = (call) => (scope, key, max, period) => call("check_rate_limit", {
+	scope,
+	key,
+	max_requests: max ?? void 0,
+	period: period ?? void 0
+}, (value) => {
+	const row = isRecord(value) ? value : {};
+	return {
+		allowed: row["allowed"] === true,
+		remaining: Number(row["remaining"] ?? 0),
+		retryAfter: Number(row["retry_after"] ?? 0)
+	};
+});
+/**
+* One `hit_rate_limit` call: whether the hit is allowed, what is left and when
+* to retry.
+*/
+async function hitRateLimit(sql, scope, key, max, period) {
+	const [row] = await sql.queryRaw("select * from better_supabase.hit_rate_limit($1, $2, $3, $4::interval)", [
+		scope,
+		key,
+		max,
+		period
+	]);
+	return {
+		allowed: row?.allowed ?? false,
+		remaining: row?.remaining ?? 0,
+		retryAfter: row?.retry_after ?? 0
+	};
+}
+const overSql = (sql) => (scope, key, max, period) => run(() => hitRateLimit(sql, scope, key, max, period));
+/** A `problem+json` 429 with `Retry-After`, for a refused `check`. */
+function rateLimited(decision, options = {}) {
+	const retryAfter = Math.max(1, Math.ceil(decision.retryAfter));
+	return problemResponse(dbError("rate_limited", options.detail ?? `Too many requests. Retry after ${retryAfter} seconds.`, { retryAfter }), {
+		...options.instance === void 0 ? {} : { instance: options.instance },
+		format: options.problem
+	});
+}
+//#endregion
+export { purgeWebhookInbox as a, createWebhookInbox as i, hitRateLimit as n, receiveWebhook as o, rateLimited as r, createRateLimit as t };

package/dist/react/index.d.ts

@@ -1,12 +1,13 @@
-import { t as escapeLike } from "../escape-like-BfXS-iVe.js";
+import { t as escapeLike } from "../escape-like-PReMbEEU.js";
 import { n as Impersonator } from "../impersonation-YTa9dZUv.js";
-import { t as tenantOf } from "../tenant-Bg4PDLkG.js";
-import { t as AuthSession } from "../view-2_I-2ukO.js";
-import { r as LiveCountSeed } from "../index-eTY4kJzo.js";
-import { _ as LiveQueryHookOptions, a as BlockQueryActions, b as ProfileOf, c as BlockRefetchOn, f as BroadcastOptions, 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, x as UseActionOptions } from "../field-errors-vshYTVKr.js";
-import { r as MembershipClaim } from "../entitlements-DDevu4ZE.js";
-import { n as supportOf, t as SupportView } from "../support-view-vwJbRMpV.js";
-import { $ as useSupabase, A as useRecordListState, B as ActionHandle, C as EntityFormState, D as RecordListState, E as RecordListQueryStates, F as RecordProviderProps, G as BetterSupabaseProvider, H as useAction, I as RecordState, J as createHooks, K as BetterSupabaseProviderProps, L as RecordWriteHandlers, M as RecordContextValue, N as RecordInitial, O as RecordListUrl, P as RecordProviderKit, Q as useLiveQuery, R as createRecordProvider, S as useBlockQuery, T as useEntityForm, U as useActionForm, V as UseActionFormOptions, W as BetterHooks, X as useBroadcast, Y as useAuth, Z as useLiveCount, _ as PresenceHookOptions, a as Upload, b as useBlockEvent, c as UseImageOptions, d as useSignedUrl, f as useUpload, g as Presence, h as useDebouncedSearch, i as StorageImage, j as RecordActionsOf, k as RecordListUrlState, l as UseUploadOptions, m as DebouncedSearchOptions, n as SignedUrl, o as UploadStatus, p as DebouncedSearch, q as LiveCount, r as SignedUrlSource, s as UploadTarget, t as ImageSource, u as useImage, v as PresenceTopic, w as UseEntityFormOptions, x as useBlockMutation, y as usePresence, z as ActionForm } from "../index-C7CrdGgz.js";
+import { i as DataEntry, m as RejectedChange, n as DataEngine, o as DataSyncState } from "../data-engine-BWoz9lED.js";
+import { t as tenantOf } from "../tenant-yYg0E2-n.js";
+import { t as AuthSession } from "../view-DyFdMCqg.js";
+import { r as LiveCountSeed } from "../index-B938YqY-.js";
+import { r as MembershipClaim } from "../entitlements-CJpYQXeE.js";
+import { D as ProfileOf, O as UseActionOptions, S as LiveCountHookOptions, _ as ActionResultOf, b as ClaimsOf, c as DataWrites, d as BlockMutationState, f as BlockQueryActions, g as ActionInputOf, h as BlockRefetchOn, l as BlockEventSource, m as BlockQueryState, o as DataSource, p as BlockQueryOptions, s as DataState, t as fieldErrorsOf, u as BlockMutationActions, w as LiveQueryHookOptions, x as ClientLike, y as BroadcastOptions } from "../field-errors-fsbFktYF.js";
+import { n as supportOf, t as SupportView } from "../support-view-BYOgwXsJ.js";
+import { $ as useActionForm, A as useBlockEvent, B as useRecordListState, C as DataHooks, D as useBlockTenant, E as useBlockEnv, F as useRecordForm, G as RecordProviderProps, H as RecordContextValue, I as RecordListQueryStates, J as createRecordProvider, K as RecordState, L as RecordListState, M as useBlockQuery, N as RecordFormState, O as useController, P as UseRecordFormOptions, Q as useAction, R as RecordListUrl, S as useSyncStatus, T as defineDataHooks, U as RecordInitial, V as RecordActionsOf, W as RecordProviderKit, X as ActionHandle, Y as ActionForm, Z as UseActionFormOptions, _ as PresenceHookOptions, a as Upload, at as useAuth, b as Conflicts, c as UseImageOptions, ct as useLiveQuery, d as useSignedUrl, et as BetterHooks, f as useUpload, g as Presence, h as useDebouncedSearch, i as StorageImage, it as createHooks, j as useBlockMutation, k as useLatest, l as UseUploadOptions, lt as useSupabase, m as DebouncedSearchOptions, n as SignedUrl, nt as BetterSupabaseProviderProps, o as UploadStatus, ot as useBroadcast, p as DebouncedSearch, q as RecordWriteHandlers, r as SignedUrlSource, rt as LiveCount, s as UploadTarget, st as useLiveCount, t as ImageSource, tt as BetterSupabaseProvider, u as useImage, v as PresenceTopic, w as DataView, x as useConflicts, y as usePresence, z as RecordListUrlState } from "../index-BnH4Gomw.js";
 import { SessionProvider, SessionProviderProps, useSession, useSupportSession } from "./session.js";
 import { a as useSignIn, i as SignOut, n as PendingState, o as useSignOut, r as SignIn, t as AuthHookOptions } from "../sign-in-D54FLMQy.js";
-export { type ActionForm, type ActionHandle, type ActionInputOf, type ActionResultOf, type AuthHookOptions, type AuthSession, type BetterHooks, BetterSupabaseProvider, type BetterSupabaseProviderProps, type BlockEventSource, type BlockMutationActions, type BlockMutationState, type BlockQueryActions, type BlockQueryOptions, type BlockQueryState, type BlockRefetchOn, type BroadcastOptions, type ClaimsOf, type ClientLike, type DebouncedSearch, type DebouncedSearchOptions, type EntityFormState, type ImageSource, type Impersonator, type LiveCount, type LiveCountHookOptions, type LiveCountSeed, type LiveQueryHookOptions, type MembershipClaim, type PendingState, type Presence, type PresenceHookOptions, type PresenceTopic, type ProfileOf, type RecordActionsOf, type RecordContextValue, type RecordInitial, type RecordListQueryStates, type RecordListState, type RecordListUrl, type RecordListUrlState, type RecordProviderKit, type RecordProviderProps, type RecordState, type RecordWriteHandlers, SessionProvider, type SessionProviderProps, type SignIn, type SignOut, type SignedUrl, type SignedUrlSource, type StorageImage, type SupportView, type Upload, type UploadStatus, type UploadTarget, type UseActionFormOptions, type UseActionOptions, type UseEntityFormOptions, type UseImageOptions, type UseUploadOptions, createHooks, createRecordProvider, escapeLike, fieldErrorsOf, supportOf, tenantOf, useAction, useActionForm, useAuth, useBlockEvent, useBlockMutation, useBlockQuery, useBroadcast, useDebouncedSearch, useEntityForm, useImage, useLiveCount, useLiveQuery, usePresence, useRecordListState, useSession, useSignIn, useSignOut, useSignedUrl, useSupabase, useSupportSession, useUpload };
+export { type ActionForm, type ActionHandle, type ActionInputOf, type ActionResultOf, type AuthHookOptions, type AuthSession, type BetterHooks, BetterSupabaseProvider, type BetterSupabaseProviderProps, type BlockEventSource, type BlockMutationActions, type BlockMutationState, type BlockQueryActions, type BlockQueryOptions, type BlockQueryState, type BlockRefetchOn, type BroadcastOptions, type ClaimsOf, type ClientLike, type Conflicts, type DataEngine, type DataEntry, type DataHooks, type DataSource, type DataState, type DataSyncState, type DataView, type DataWrites, type DebouncedSearch, type DebouncedSearchOptions, type ImageSource, type Impersonator, type LiveCount, type LiveCountHookOptions, type LiveCountSeed, type LiveQueryHookOptions, type MembershipClaim, type PendingState, type Presence, type PresenceHookOptions, type PresenceTopic, type ProfileOf, type RecordActionsOf, type RecordContextValue, type RecordFormState, type RecordInitial, type RecordListQueryStates, type RecordListState, type RecordListUrl, type RecordListUrlState, type RecordProviderKit, type RecordProviderProps, type RecordState, type RecordWriteHandlers, type RejectedChange, SessionProvider, type SessionProviderProps, type SignIn, type SignOut, type SignedUrl, type SignedUrlSource, type StorageImage, type SupportView, type Upload, type UploadStatus, type UploadTarget, type UseActionFormOptions, type UseActionOptions, type UseImageOptions, type UseRecordFormOptions, type UseUploadOptions, createHooks, createRecordProvider, defineDataHooks, escapeLike, fieldErrorsOf, supportOf, tenantOf, useAction, useActionForm, useAuth, useBlockEnv, useBlockEvent, useBlockMutation, useBlockQuery, useBlockTenant, useBroadcast, useConflicts, useController, useDebouncedSearch, useImage, useLatest, useLiveCount, useLiveQuery, usePresence, useRecordForm, useRecordListState, useSession, useSignIn, useSignOut, useSignedUrl, useSupabase, useSupportSession, useSyncStatus, useUpload };

package/dist/react/index.js

@@ -1,9 +1,9 @@
 "use client";
 import { t as escapeLike } from "../escape-like-DHfx6jRr.js";
+import { a as createHooks, d as useSupabase, i as BetterSupabaseProvider, l as useLiveCount, n as useSignIn, o as useAuth, r as useSignOut, s as useBroadcast, u as useLiveQuery } from "../sign-in-BsIaNx2C.js";
 import { t as supportOf } from "../support-view-g4YLBeqX.js";
 import { SessionProvider, useSession, useSupportSession } from "./session.js";
-import { a as createHooks, d as useSupabase, i as BetterSupabaseProvider, l as useLiveCount, n as useSignIn, o as useAuth, r as useSignOut, s as useBroadcast, u as useLiveQuery } from "../sign-in-lAyf6Ohy.js";
-import { a as fieldErrorsOf } from "../block-controller-DTGuBemi.js";
-import { a as usePresence, c as useBlockQuery, d as createRecordProvider, f as useAction, i as useDebouncedSearch, l as useEntityForm, n as useSignedUrl, o as useBlockEvent, p as useActionForm, r as useUpload, s as useBlockMutation, t as useImage, u as useRecordListState } from "../react-28VgUbm9.js";
-import { t as tenantOf } from "../tenant-DnMqeNIM.js";
-export { BetterSupabaseProvider, SessionProvider, createHooks, createRecordProvider, escapeLike, fieldErrorsOf, supportOf, tenantOf, useAction, useActionForm, useAuth, useBlockEvent, useBlockMutation, useBlockQuery, useBroadcast, useDebouncedSearch, useEntityForm, useImage, useLiveCount, useLiveQuery, usePresence, useRecordListState, useSession, useSignIn, useSignOut, useSignedUrl, useSupabase, useSupportSession, useUpload };
+import { d as fieldErrorsOf } from "../data-hooks-tgF1Ct0F.js";
+import { _ as useController, a as usePresence, b as useActionForm, c as defineDataHooks, d as useBlockQuery, f as useRecordForm, g as useBlockTenant, h as useBlockEnv, i as useDebouncedSearch, l as useBlockEvent, m as createRecordProvider, n as useSignedUrl, o as useConflicts, p as useRecordListState, r as useUpload, s as useSyncStatus, t as useImage, u as useBlockMutation, v as useLatest, y as useAction } from "../react-BuDYI62C.js";
+import { t as tenantOf } from "../tenant-BgIiMQpo.js";
+export { BetterSupabaseProvider, SessionProvider, createHooks, createRecordProvider, defineDataHooks, escapeLike, fieldErrorsOf, supportOf, tenantOf, useAction, useActionForm, useAuth, useBlockEnv, useBlockEvent, useBlockMutation, useBlockQuery, useBlockTenant, useBroadcast, useConflicts, useController, useDebouncedSearch, useImage, useLatest, useLiveCount, useLiveQuery, usePresence, useRecordForm, useRecordListState, useSession, useSignIn, useSignOut, useSignedUrl, useSupabase, useSupportSession, useSyncStatus, useUpload };

package/dist/react/native/index.d.ts

@@ -1,4 +1,4 @@
-import { t as AuthSnapshot } from "../../bind-Dz8y3T5T.js";
+import { t as AuthSnapshot } from "../../bind-CrMBwrPN.js";
 import { a as OAuthSignInOptions, i as OAuthClient, n as AuthLinkClient, o as WebBrowserLike, r as AuthLinkResult, t as AuthFailure } from "../../auth-link-B4NL84XU.js";
 import { n as PendingState } from "../../sign-in-D54FLMQy.js";
 import { Provider } from "@supabase/supabase-js";

package/dist/react/native/index.js

@@ -1,12 +1,11 @@
 import { r as signInWithOAuthBrowser, t as handleAuthDeepLink } from "../../auth-link-D3-bU6yz.js";
-import { t as ClientContext } from "../../context-CMxVnPMY.js";
-import { o as useAuth, t as usePending } from "../../sign-in-lAyf6Ohy.js";
+import { f as ClientContext, o as useAuth, t as usePending } from "../../sign-in-BsIaNx2C.js";
 import { useContext, useEffect, useMemo, useRef, useState } from "react";
 //#region src/react/native/index.ts
 function useClientOf(explicit, hook) {
 	const context = useContext(ClientContext);
 	const client = explicit ?? context?.client.supabase;
-	if (!client) throw new Error(`better-supabase: ${hook} needs <BetterSupabaseProvider client={bs}> or { client: supabase }`);
+	if (!client) throw new Error(`better-supabase: ${hook} needs <BetterSupabaseProvider client={bsb}> or { client: supabase }`);
 	return client;
 }
 const NOT_FINISHED = { error: null };

package/dist/react/server.d.ts

@@ -1,25 +1,25 @@
-import { t as escapeLike } from "../escape-like-BfXS-iVe.js";
-import { J as QuerySpec } from "../define-Dw7pRO4h.js";
+import { t as escapeLike } from "../escape-like-PReMbEEU.js";
+import { pt as QuerySpec } from "../define-DFBnQyYg.js";
 import { n as Impersonator } from "../impersonation-YTa9dZUv.js";
-import { t as tenantOf } from "../tenant-Bg4PDLkG.js";
-import { t as AuthSession } from "../view-2_I-2ukO.js";
-import { r as LiveCountSeed } from "../index-eTY4kJzo.js";
-import { _ as LiveQueryHookOptions, b as ProfileOf, f as BroadcastOptions, h as LiveCountHookOptions, l as ActionInputOf, m as ClientLike, p as ClaimsOf, t as fieldErrorsOf, u as ActionResultOf, x as UseActionOptions } from "../field-errors-vshYTVKr.js";
-import { r as MembershipClaim } from "../entitlements-DDevu4ZE.js";
-import { n as supportOf, t as SupportView } from "../support-view-vwJbRMpV.js";
-import { $ as useSupabase, A as useRecordListState$1, B as ActionHandle, C as EntityFormState, D as RecordListState, E as RecordListQueryStates, F as RecordProviderProps, G as BetterSupabaseProvider, I as RecordState, K as BetterSupabaseProviderProps, L as RecordWriteHandlers, M as RecordContextValue, N as RecordInitial, O as RecordListUrl, P as RecordProviderKit, Q as useLiveQuery, R as createRecordProvider$1, S as useBlockQuery$1, T as useEntityForm$1, V as UseActionFormOptions, W as BetterHooks, X as useBroadcast, Y as useAuth, _ as PresenceHookOptions, a as Upload, b as useBlockEvent$1, c as UseImageOptions, d as useSignedUrl$1, f as useUpload$1, g as Presence, h as useDebouncedSearch$1, i as StorageImage, j as RecordActionsOf, k as RecordListUrlState, l as UseUploadOptions, m as DebouncedSearchOptions, n as SignedUrl, o as UploadStatus, p as DebouncedSearch, q as LiveCount, r as SignedUrlSource, s as UploadTarget, t as ImageSource, u as useImage$1, v as PresenceTopic, w as UseEntityFormOptions, x as useBlockMutation$1, y as usePresence$1, z as ActionForm } from "../index-C7CrdGgz.js";
+import { t as tenantOf } from "../tenant-yYg0E2-n.js";
+import { t as AuthSession } from "../view-DyFdMCqg.js";
+import { r as LiveCountSeed } from "../index-B938YqY-.js";
+import { r as MembershipClaim } from "../entitlements-CJpYQXeE.js";
+import { D as ProfileOf, O as UseActionOptions, S as LiveCountHookOptions, _ as ActionResultOf, b as ClaimsOf, g as ActionInputOf, t as fieldErrorsOf, w as LiveQueryHookOptions, x as ClientLike, y as BroadcastOptions } from "../field-errors-fsbFktYF.js";
+import { n as supportOf, t as SupportView } from "../support-view-BYOgwXsJ.js";
+import { A as useBlockEvent$1, B as useRecordListState$1, D as useBlockTenant$1, E as useBlockEnv$1, F as useRecordForm$1, G as RecordProviderProps, H as RecordContextValue, I as RecordListQueryStates, J as createRecordProvider$1, K as RecordState, L as RecordListState, M as useBlockQuery$1, N as RecordFormState, O as useController$1, P as UseRecordFormOptions, R as RecordListUrl, S as useSyncStatus$1, T as defineDataHooks$1, U as RecordInitial, V as RecordActionsOf, W as RecordProviderKit, X as ActionHandle, Y as ActionForm, Z as UseActionFormOptions, _ as PresenceHookOptions, a as Upload, at as useAuth, c as UseImageOptions, ct as useLiveQuery, d as useSignedUrl$1, et as BetterHooks, f as useUpload$1, g as Presence, h as useDebouncedSearch$1, i as StorageImage, j as useBlockMutation$1, k as useLatest$1, l as UseUploadOptions, lt as useSupabase, m as DebouncedSearchOptions, n as SignedUrl, nt as BetterSupabaseProviderProps, o as UploadStatus, ot as useBroadcast, p as DebouncedSearch, q as RecordWriteHandlers, r as SignedUrlSource, rt as LiveCount, s as UploadTarget, t as ImageSource, tt as BetterSupabaseProvider, u as useImage$1, v as PresenceTopic, x as useConflicts$1, y as usePresence$1, z as RecordListUrlState } from "../index-BnH4Gomw.js";
 import { SessionProvider, SessionProviderProps } from "./session.js";
 import { a as useSignIn$1, i as SignOut, n as PendingState, o as useSignOut$1, r as SignIn, t as AuthHookOptions } from "../sign-in-D54FLMQy.js";
 //#region src/react/server.d.ts
-/** The `react-server` build of `useSession`: await `bs.session()` instead. */
+/** The `react-server` build of `useSession`: await `bsb.session()` instead. */
 export declare const useSession: <C = unknown, P = unknown>() => AuthSession<C, P>;
 /**
  * The `react-server` build of `useSupportSession`: use `supportOf(await
- * bs.session())` instead.
+ * bsb.session())` instead.
  */
 export declare const useSupportSession: () => SupportView | undefined;
 /**
- * The `react-server` build of `useLiveCount`: render the `bs.liveCount()` seed
+ * The `react-server` build of `useLiveCount`: render the `bsb.liveCount()` seed
  * instead.
  */
 export declare const useLiveCount: (source: QuerySpec<string, "count", number> | LiveCountSeed | null | undefined, options?: LiveCountHookOptions) => LiveCount;
@@ -65,6 +65,11 @@ export declare const useBlockEvent: typeof useBlockEvent$1;
  * client"` module, such as the generated `-provider.tsx`.
  */
 export declare const createRecordProvider: typeof createRecordProvider$1;
+/**
+ * The `react-server` build of `defineDataHooks`: importing the generated
+ * `hooks.ts` is safe on the server, calling a hook there throws.
+ */
+export declare const defineDataHooks: typeof defineDataHooks$1;
 /**
  * The `react-server` build of `useDebouncedSearch`: read the term from
  * `searchParams` instead.
@@ -79,6 +84,16 @@ export declare const useSignedUrl: typeof useSignedUrl$1;
 export declare const useImage: typeof useImage$1;
 /** The `react-server` build of `useUpload`: upload from a Client Component. */
 export declare const useUpload: typeof useUpload$1;
+/**
+ * The `react-server` build of `useSyncStatus`: the local database syncs in the
+ * client.
+ */
+export declare const useSyncStatus: typeof useSyncStatus$1;
+/**
+ * The `react-server` build of `useConflicts`: refused changes live in the
+ * client.
+ */
+export declare const useConflicts: typeof useConflicts$1;
 /**
  * The `react-server` build of `createHooks`: importing a module that creates
  * hooks is safe on the server, calling a hook there throws.
@@ -90,9 +105,26 @@ export declare function createHooks<B extends ClientLike>(): BetterHooks<B>;
  */
 export declare const useRecordListState: typeof useRecordListState$1;
 /**
- * The `react-server` build of `useEntityForm`: render the form in a client
+ * The `react-server` build of `useRecordForm`: render the form in a client
  * component.
  */
-export declare const useEntityForm: typeof useEntityForm$1;
+export declare const useRecordForm: typeof useRecordForm$1;
+/**
+ * The `react-server` build of `useController`: run the block method and await
+ * it instead.
+ */
+export declare const useController: typeof useController$1;
+/** The `react-server` build of `useLatest`: use the value directly instead. */
+export declare const useLatest: typeof useLatest$1;
+/**
+ * The `react-server` build of `useBlockEnv`: call the block on `await bsb.db()`
+ * instead.
+ */
+export declare const useBlockEnv: typeof useBlockEnv$1;
+/**
+ * The `react-server` build of `useBlockTenant`: read the tenant from `await
+ * bsb.context()` instead.
+ */
+export declare const useBlockTenant: typeof useBlockTenant$1;
 //#endregion
-export { type ActionForm, type ActionHandle, type ActionInputOf, type ActionResultOf, type AuthHookOptions, type AuthSession, type BetterHooks, BetterSupabaseProvider, type BetterSupabaseProviderProps, type BroadcastOptions, type ClaimsOf, type ClientLike, type DebouncedSearch, type DebouncedSearchOptions, type EntityFormState, type ImageSource, type Impersonator, type LiveCount, type LiveCountHookOptions, type LiveCountSeed, type LiveQueryHookOptions, type MembershipClaim, type PendingState, type Presence, type PresenceHookOptions, type PresenceTopic, type ProfileOf, type RecordActionsOf, type RecordContextValue, type RecordInitial, type RecordListQueryStates, type RecordListState, type RecordListUrl, type RecordListUrlState, type RecordProviderKit, type RecordProviderProps, type RecordState, type RecordWriteHandlers, SessionProvider, type SessionProviderProps, type SignIn, type SignOut, type SignedUrl, type SignedUrlSource, type StorageImage, type SupportView, type Upload, type UploadStatus, type UploadTarget, type UseActionFormOptions, type UseActionOptions, type UseEntityFormOptions, type UseImageOptions, type UseUploadOptions, escapeLike, fieldErrorsOf, supportOf, tenantOf, useAuth, useBroadcast, useLiveQuery, useSupabase };
+export { type ActionForm, type ActionHandle, type ActionInputOf, type ActionResultOf, type AuthHookOptions, type AuthSession, type BetterHooks, BetterSupabaseProvider, type BetterSupabaseProviderProps, type BroadcastOptions, type ClaimsOf, type ClientLike, type DebouncedSearch, type DebouncedSearchOptions, type ImageSource, type Impersonator, type LiveCount, type LiveCountHookOptions, type LiveCountSeed, type LiveQueryHookOptions, type MembershipClaim, type PendingState, type Presence, type PresenceHookOptions, type PresenceTopic, type ProfileOf, type RecordActionsOf, type RecordContextValue, type RecordFormState, type RecordInitial, type RecordListQueryStates, type RecordListState, type RecordListUrl, type RecordListUrlState, type RecordProviderKit, type RecordProviderProps, type RecordState, type RecordWriteHandlers, SessionProvider, type SessionProviderProps, type SignIn, type SignOut, type SignedUrl, type SignedUrlSource, type StorageImage, type SupportView, type Upload, type UploadStatus, type UploadTarget, type UseActionFormOptions, type UseActionOptions, type UseImageOptions, type UseRecordFormOptions, type UseUploadOptions, escapeLike, fieldErrorsOf, supportOf, tenantOf, useAuth, useBroadcast, useLiveQuery, useSupabase };

package/dist/react/server.js

@@ -1,25 +1,25 @@
 import { t as escapeLike } from "../escape-like-DHfx6jRr.js";
+import { d as useSupabase, i as BetterSupabaseProvider, o as useAuth, s as useBroadcast, u as useLiveQuery } from "../sign-in-BsIaNx2C.js";
 import { t as supportOf } from "../support-view-g4YLBeqX.js";
-import { d as useSupabase, i as BetterSupabaseProvider, o as useAuth, s as useBroadcast, u as useLiveQuery } from "../sign-in-lAyf6Ohy.js";
-import { a as fieldErrorsOf } from "../block-controller-DTGuBemi.js";
-import "../react-28VgUbm9.js";
-import { t as tenantOf } from "../tenant-DnMqeNIM.js";
+import { d as fieldErrorsOf } from "../data-hooks-tgF1Ct0F.js";
+import "../react-BuDYI62C.js";
+import { t as tenantOf } from "../tenant-BgIiMQpo.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 \`bs.context()\` or \`db.$run(spec)\`.`);
+		throw new Error(`better-supabase: ${name}() runs in Client Components only. In Server Components use \`bsb.context()\` or \`db.$run(spec)\`.`);
 	};
 }
-/** The `react-server` build of `useSession`: await `bs.session()` instead. */
+/** The `react-server` build of `useSession`: await `bsb.session()` instead. */
 const useSession = clientOnly("useSession");
 /**
 * The `react-server` build of `useSupportSession`: use `supportOf(await
-* bs.session())` instead.
+* bsb.session())` instead.
 */
 const useSupportSession = clientOnly("useSupportSession");
 /**
-* The `react-server` build of `useLiveCount`: render the `bs.liveCount()` seed
+* The `react-server` build of `useLiveCount`: render the `bsb.liveCount()` seed
 * instead.
 */
 const useLiveCount = clientOnly("useLiveCount");
@@ -66,6 +66,14 @@ const useBlockEvent = clientOnly("useBlockEvent");
 */
 const createRecordProvider = clientOnly("createRecordProvider");
 /**
+* The `react-server` build of `defineDataHooks`: importing the generated
+* `hooks.ts` is safe on the server, calling a hook there throws.
+*/
+const defineDataHooks = () => ({
+	useList: clientOnly("useList"),
+	useOne: clientOnly("useOne")
+});
+/**
 * The `react-server` build of `useDebouncedSearch`: read the term from
 * `searchParams` instead.
 */
@@ -80,6 +88,16 @@ const useImage = clientOnly("useImage");
 /** The `react-server` build of `useUpload`: upload from a Client Component. */
 const useUpload = clientOnly("useUpload");
 /**
+* The `react-server` build of `useSyncStatus`: the local database syncs in the
+* client.
+*/
+const useSyncStatus = clientOnly("useSyncStatus");
+/**
+* The `react-server` build of `useConflicts`: refused changes live in the
+* client.
+*/
+const useConflicts = clientOnly("useConflicts");
+/**
 * The `react-server` build of `createHooks`: importing a module that creates
 * hooks is safe on the server, calling a hook there throws.
 */
@@ -98,9 +116,26 @@ function createHooks() {
 */
 const useRecordListState = clientOnly("useRecordListState");
 /**
-* The `react-server` build of `useEntityForm`: render the form in a client
+* The `react-server` build of `useRecordForm`: render the form in a client
 * component.
 */
-const useEntityForm = clientOnly("useEntityForm");
+const useRecordForm = clientOnly("useRecordForm");
+/**
+* The `react-server` build of `useController`: run the block method and await
+* it instead.
+*/
+const useController = clientOnly("useController");
+/** The `react-server` build of `useLatest`: use the value directly instead. */
+const useLatest = clientOnly("useLatest");
+/**
+* The `react-server` build of `useBlockEnv`: call the block on `await bsb.db()`
+* instead.
+*/
+const useBlockEnv = clientOnly("useBlockEnv");
+/**
+* The `react-server` build of `useBlockTenant`: read the tenant from `await
+* bsb.context()` instead.
+*/
+const useBlockTenant = clientOnly("useBlockTenant");
 //#endregion
-export { BetterSupabaseProvider, SessionProvider, createHooks, createRecordProvider, escapeLike, fieldErrorsOf, supportOf, tenantOf, useAction, useActionForm, useAuth, useBlockEvent, useBlockMutation, useBlockQuery, useBroadcast, useDebouncedSearch, useEntityForm, useImage, useLiveCount, useLiveQuery, usePresence, useRecordListState, useSession, useSignIn, useSignOut, useSignedUrl, useSupabase, useSupportSession, useUpload };
+export { BetterSupabaseProvider, SessionProvider, createHooks, createRecordProvider, defineDataHooks, escapeLike, fieldErrorsOf, supportOf, tenantOf, useAction, useActionForm, useAuth, useBlockEnv, useBlockEvent, useBlockMutation, useBlockQuery, useBlockTenant, useBroadcast, useConflicts, useController, useDebouncedSearch, useImage, useLatest, useLiveCount, useLiveQuery, usePresence, useRecordForm, useRecordListState, useSession, useSignIn, useSignOut, useSignedUrl, useSupabase, useSupportSession, useSyncStatus, useUpload };

package/dist/react/session.d.ts

@@ -1,10 +1,10 @@
-import { t as AuthSession } from "../view-2_I-2ukO.js";
-import { t as SupportView } from "../support-view-vwJbRMpV.js";
+import { t as AuthSession } from "../view-DyFdMCqg.js";
+import { t as SupportView } from "../support-view-BYOgwXsJ.js";
 import { ReactNode } from "react";
 //#region src/react/session.d.ts
 export interface SessionProviderProps {
   /**
-   * An unresolved `bs.session()` promise, created inside a `<Suspense>`
+   * An unresolved `bsb.session()` promise, created inside a `<Suspense>`
    * boundary so the layout itself never waits for auth.
    */
   readonly sessionPromise: Promise<AuthSession>;