better-supabase 0.8.0 → 0.9.0

package/dist/rate-limit-Bw7HgmFj.js

@@ -1,260 +0,0 @@
-import { n as dbError } from "./errors-2M6CKMP4.js";
-import { a as ok, t as AsyncResult } from "./result-DEqHCMKP.js";
-import { n as isRecord } from "./guards-6F2bCtQR.js";
-import { o as problemResponse } from "./problem-CJvFeGu7.js";
-import { a as verifyWebhook } from "./signatures-DsWv_bYR.js";
-import { D as seconds, E as run, N as toInstant, P as workerId, a as budget, f as leaseHeartbeat, i as blockCall, l as errorText, n as applyTemporal, x as readBodyCapped } from "./block-helpers-Cy3pB96I.js";
-//#region src/blocks/jobs/webhook-inbox.ts
-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`; `duplicate` when the id was stored before. */
-async function receiveWebhook(sql, input) {
-	const [row] = await sql.queryRaw("select * from better_supabase.receive_webhook($1, $2, $3, $4, $5, $6, $7)", [
-		input.source,
-		input.id,
-		input.type ?? null,
-		JSON.stringify(input.payload),
-		JSON.stringify(input.headers),
-		input.tenant,
-		input.maxAttempts ?? null
-	]);
-	return {
-		id: Number(row.id),
-		duplicate: row.duplicate
-	};
-}
-/** Store-then-process webhooks: acknowledge fast, process with retries, never twice. */
-function createWebhookInbox(sql, options) {
-	applyTemporal(options);
-	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) => run(() => receiveWebhook(sql, {
-		source: options.source,
-		id: event.id,
-		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,
-		maxAttempts
-	}));
-	return {
-		store: save,
-		list: (listOptions) => run(async () => {
-			return (await sql.queryRaw("select * from better_supabase.list_webhooks($1, $2, $3, $4)", [
-				listOptions.tenant,
-				options.source,
-				listOptions.status ?? null,
-				listOptions.limit ?? 100
-			])).map((row) => ({
-				id: Number(row.id),
-				messageId: row.message_id,
-				type: row.event_type,
-				status: row.status ?? "pending",
-				attempts: row.attempts,
-				maxAttempts: row.max_attempts ?? maxAttempts,
-				lastError: row.last_error ?? null,
-				tenant: row.tenant ?? null,
-				receivedAt: toInstant(row.received_at),
-				processedAt: row.processed_at === null || row.processed_at === void 0 ? null : toInstant(row.processed_at)
-			}));
-		}),
-		purge: (purgeOptions = {}) => run(async () => {
-			const [row] = await sql.queryRaw("select better_supabase.purge_webhooks($1::interval, $2, $3, $4) as purged", [
-				seconds(purgeOptions.olderThan ?? "30 days"),
-				purgeOptions.includeDead ?? false,
-				purgeOptions.batch ?? 1e4,
-				purgeOptions.tenant ?? null
-			]);
-			return row?.purged ?? 0;
-		}),
-		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 sql.queryRaw("select * from better_supabase.claim_webhooks($1, $2, $3, $4::interval)", [
-					options.source,
-					worker,
-					processOptions.batch ?? 10,
-					lease
-				]);
-				if (rows.length === 0) return {
-					succeeded,
-					failed
-				};
-				for (const row of rows) {
-					const id = Number(row.id);
-					const attempt = row.attempts;
-					const extend = async () => {
-						const [held] = await sql.queryRaw("select better_supabase.extend_webhook($1, $2, $3, $4::interval) as lease", [
-							id,
-							worker,
-							attempt,
-							lease
-						]);
-						return held?.lease ?? void 0;
-					};
-					const leaseSeconds = await extend();
-					if (leaseSeconds === void 0) continue;
-					const message = {
-						id,
-						source: row.source,
-						messageId: row.message_id,
-						type: row.event_type,
-						payload: row.payload,
-						headers: row.headers,
-						attempts: row.attempts,
-						maxAttempts: row.max_attempts ?? maxAttempts,
-						receivedAt: toInstant(row.received_at),
-						tenant: row.tenant ?? null,
-						progress: row.checkpoint ?? {},
-						async checkpoint(fields) {
-							const [saved] = await sql.queryRaw("select better_supabase.checkpoint_webhook($1, $2, $3, $4) as saved", [
-								id,
-								worker,
-								JSON.stringify(fields),
-								attempt
-							]);
-							return saved?.saved ?? false;
-						}
-					};
-					const stopHeartbeat = leaseHeartbeat(leaseSeconds, () => void extend().catch(() => void 0));
-					try {
-						const outcome = await handler(message);
-						if (typeof outcome === "object" && outcome !== null && "ok" in outcome && outcome.ok === false) throw new Error(errorText(outcome.error ?? "The handler failed"));
-						const [done] = await sql.queryRaw("select better_supabase.complete_webhook($1, $2, $3) as done", [
-							message.id,
-							worker,
-							attempt
-						]);
-						if (done?.done !== false) succeeded += 1;
-					} catch (cause) {
-						await sql.queryRaw("select better_supabase.fail_webhook($1, $2, $3, null, $4)", [
-							message.id,
-							worker,
-							errorText(cause),
-							attempt
-						]);
-						failed += 1;
-					} finally {
-						stopHeartbeat();
-					}
-				}
-			}
-		}
-	};
-}
-//#endregion
-//#region src/blocks/jobs/rate-limit.ts
-const isTransport = (source) => "call" in source;
-/**
-* Fixed-window limits for keys that aren't claims, over the `rate-limit`
-* module's counters. Pass a service SQL connection (`ctx.postgresAdmin`,
-* `postgres.admin`), or a service-role `BlockTransport` such as
-* `rpcTransport(adminClient)`.
-*/
-function createRateLimit(source, options = {}) {
-	applyTemporal(options);
-	const hit = isTransport(source) ? overTransport(blockCall(source, void 0, options.mappers)) : overSql(source);
-	return { 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));
-	} };
-}
-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 { receiveWebhook as a, createWebhookInbox as i, hitRateLimit as n, rateLimited as r, createRateLimit as t };

package/dist/react-Bmpo59D7.js

@@ -1,409 +0,0 @@
-import { n as dbError } from "./errors-2M6CKMP4.js";
-import { t as escapeLike } from "./escape-like-DHfx6jRr.js";
-import { r as err, s as toDbError } from "./result-DEqHCMKP.js";
-import "./react/session.js";
-import { n as ClientContext, o as useBroadcastAuth } from "./hooks-Bhza9Hnr.js";
-import { t as fieldErrorsOf } from "./field-errors-DZVRWRkf.js";
-import { n as ttlSeconds } from "./ttl-Hr34gRu8.js";
-import { useCallback, useContext, useEffect, useMemo, useRef, useState, useTransition } from "react";
-//#region src/react/actions.ts
-const IDLE$1 = {
-	data: void 0,
-	error: void 0
-};
-/**
-* Calls a Server Action from an event handler: tracks pending inputs and the
-* last result, and calls `onSuccess` or `onError`.
-*
-* ```tsx
-* const remove = useAction(removeMember, { onError: (e) => toast.error(message(e)) });
-* <Button disabled={remove.pendingInputs.some((p) => p.userId === id)} onClick={() => remove.run({ userId: id })} />
-* ```
-*/
-function useAction(action, options = {}) {
-	const [transitioning, startTransition] = useTransition();
-	const [inFlight, setInFlight] = useState([]);
-	const [settled, setSettled] = useState(IDLE$1);
-	const latest = useRef({
-		action,
-		options
-	});
-	latest.current = {
-		action,
-		options
-	};
-	const run = useCallback((input) => {
-		const entry = { input };
-		setInFlight((current) => [...current, entry]);
-		setSettled((current) => current.error === void 0 ? current : {
-			...current,
-			error: void 0
-		});
-		const settledRun = new Promise((resolve, reject) => {
-			const done = () => {
-				setInFlight((current) => current.filter((item) => item !== entry));
-			};
-			startTransition(async () => {
-				let result;
-				try {
-					result = await latest.current.action(input);
-				} catch (cause) {
-					done();
-					reject(cause instanceof Error ? cause : new Error(String(cause)));
-					throw cause;
-				}
-				done();
-				setSettled(result.ok ? {
-					data: result.data,
-					error: void 0
-				} : (current) => ({
-					data: current.data,
-					error: result.error
-				}));
-				const { onSuccess, onError } = latest.current.options;
-				if (result.ok) onSuccess?.(result.data, input);
-				else onError?.(result.error, input);
-				resolve(result);
-			});
-		});
-		settledRun.catch(() => void 0);
-		return settledRun;
-	}, []);
-	const reset = useCallback(() => {
-		setSettled(IDLE$1);
-	}, []);
-	const pendingInputs = inFlight.map((item) => item.input);
-	return {
-		run,
-		pending: transitioning || inFlight.length > 0,
-		pendingInputs,
-		pendingInput: pendingInputs.at(-1),
-		data: settled.data,
-		error: settled.error,
-		reset
-	};
-}
-/**
-* A `<form>` that submits `FormData` to a Server Action. Fields keep what
-* the user typed when the action fails (a `<form action>` resets them) and
-* clear only on success.
-*
-* ```tsx
-* const form = useActionForm(createCustomer, { onSuccess: () => toast.success('Saved') });
-* <form {...form.formProps}>
-*   <Input name="name" aria-invalid={form.fieldErrors.name !== undefined} />
-* </form>
-* ```
-*/
-function useActionForm(action, options = {}) {
-	const handle = useAction(action);
-	return {
-		formProps: { onSubmit: (event) => {
-			event.preventDefault();
-			const form = event.currentTarget;
-			handle.run(new FormData(form)).then((result) => {
-				if (!result.ok) {
-					options.onError?.(result.error, form);
-					return;
-				}
-				if (options.resetOnSuccess ?? true) form.reset();
-				options.onSuccess?.(result.data, form);
-			}, () => void 0);
-		} },
-		pending: handle.pending,
-		data: handle.data,
-		error: handle.error,
-		fieldErrors: fieldErrorsOf(handle.error),
-		reset: () => {
-			handle.reset();
-		}
-	};
-}
-//#endregion
-//#region src/react/presence.ts
-const NONE = [];
-const NO_HANDLERS = {};
-const notJoined = () => Promise.resolve(dbError("invalid_request", "better-supabase: the presence topic is not joined"));
-/**
-* Joins a presence topic while mounted and returns who is on it. Pass
-* `null` values to pause. It rejoins when the topic or the user changes.
-*
-* ```tsx
-* const { members } = usePresence(roomTopic, { roomId }, { state: { name } });
-* ```
-*/
-function usePresence(topic, values, options = {}) {
-	const context = useContext(ClientContext);
-	const supabase = options.client ?? context?.client.supabase;
-	if (!supabase) throw new Error("better-supabase: usePresence needs <BetterSupabaseProvider client={bs}> or { client: supabase }");
-	const auth = useBroadcastAuth(options.client === void 0 ? context?.client : void 0, supabase);
-	const [members, setMembers] = useState(NONE);
-	const [status, setStatus] = useState("closed");
-	const joinedRef = useRef(null);
-	const trackedKey = useRef(void 0);
-	const name = values ? topic.topic(values) : null;
-	const userId = auth.userId;
-	const state = options.state;
-	const stateKey = state === void 0 ? void 0 : JSON.stringify(state);
-	const latest = useRef({
-		state,
-		stateKey
-	});
-	latest.current = {
-		state,
-		stateKey
-	};
-	useEffect(() => {
-		if (!name || auth.status === "loading") return;
-		const matched = topic.match(name);
-		if (!matched) return;
-		const joined = topic.subscribe(supabase, matched, NO_HANDLERS, {
-			onStatus: setStatus,
-			onPresence: setMembers
-		});
-		joinedRef.current = joined;
-		syncState(joined, latest.current, trackedKey);
-		return () => {
-			joinedRef.current = null;
-			trackedKey.current = void 0;
-			setMembers(NONE);
-			setStatus("closed");
-			joined.unsubscribe();
-		};
-	}, [
-		supabase,
-		topic,
-		name,
-		userId,
-		auth.status
-	]);
-	useEffect(() => {
-		const joined = joinedRef.current;
-		if (joined) syncState(joined, {
-			state: latest.current.state,
-			stateKey
-		}, trackedKey);
-	}, [stateKey]);
-	return {
-		members,
-		status,
-		...useMemo(() => ({
-			track: async (next) => {
-				const joined = joinedRef.current;
-				if (!joined) return notJoined();
-				const result = await joined.track(next);
-				return result.ok ? void 0 : result.error;
-			},
-			untrack: async () => {
-				const joined = joinedRef.current;
-				if (!joined) return notJoined();
-				const result = await joined.untrack();
-				return result.ok ? void 0 : result.error;
-			}
-		}), [])
-	};
-}
-/** Tracks or untracks the `state` option once per distinct value. */
-function syncState(joined, current, tracked) {
-	if (current.stateKey === void 0 || current.stateKey === tracked.current) return;
-	tracked.current = current.stateKey;
-	if (current.state === null || current.state === void 0) joined.untrack();
-	else joined.track(current.state);
-}
-//#endregion
-//#region src/react/search.ts
-/**
-* A search box's value, debounced. Pass `term` to `contains` (which
-* escapes it) or `pattern` to `ilike`; both are `undefined` while empty.
-*
-* ```tsx
-* const search = useDebouncedSearch();
-* useQuery(q.customers.findMany({ where: search.term ? { name: { contains: search.term } } : {} }));
-* ```
-*/
-function useDebouncedSearch(initial = "", options = {}) {
-	const delayMs = options.delayMs ?? 250;
-	const minLength = options.minLength ?? 1;
-	const [value, setValue] = useState(initial);
-	const [settled, setSettled] = useState(initial);
-	useEffect(() => {
-		if (value === settled) return;
-		const timer = setTimeout(() => {
-			setSettled(value);
-		}, delayMs);
-		return () => {
-			clearTimeout(timer);
-		};
-	}, [
-		value,
-		settled,
-		delayMs
-	]);
-	const trimmed = settled.trim();
-	const term = trimmed.length >= minLength ? trimmed : void 0;
-	return {
-		value,
-		setValue,
-		term,
-		pattern: term === void 0 ? void 0 : `%${escapeLike(term)}%`,
-		pending: value !== settled
-	};
-}
-//#endregion
-//#region src/react/storage.ts
-/** Re-sign this share of the TTL before the URL expires. */
-const REFRESH_AT = .9;
-/**
-* A signed URL for an object, signed again before it expires. Pass `null`
-* as the target to pause. Connect the bucket with `cacheSignedUrls: true`
-* so components showing the same object share one URL.
-*
-* ```tsx
-* const { url } = useSignedUrl(avatars, user ? { userId: user.id } : null, { ttl: 'hour' });
-* ```
-*/
-function useSignedUrl(bucket, target, options = {}) {
-	const key = target === null || target === void 0 ? null : JSON.stringify([target, options]);
-	const [state, setState] = useState({
-		key: null,
-		url: void 0,
-		error: void 0
-	});
-	const latest = useRef({
-		target,
-		options
-	});
-	latest.current = {
-		target,
-		options
-	};
-	const ttl = ttlSeconds(options.ttl);
-	useEffect(() => {
-		if (key === null) return;
-		let active = true;
-		const sign = () => {
-			const current = latest.current.target;
-			if (current === null || current === void 0) return;
-			bucket.signedUrl(current, latest.current.options).then((result) => {
-				if (!active) return;
-				if (!result.ok) {
-					setState((last) => ({
-						key,
-						url: last.key === key ? last.url : void 0,
-						error: result.error
-					}));
-					return;
-				}
-				setState({
-					key,
-					url: result.data,
-					error: void 0
-				});
-			});
-		};
-		sign();
-		const timer = setInterval(sign, ttl * 1e3 * REFRESH_AT);
-		return () => {
-			active = false;
-			clearInterval(timer);
-		};
-	}, [
-		bucket,
-		key,
-		ttl
-	]);
-	const fresh = key !== null && state.key === key;
-	return {
-		url: fresh ? state.url : void 0,
-		error: fresh ? state.error : void 0,
-		loading: key !== null && (!fresh || state.url === void 0 && !state.error)
-	};
-}
-const IDLE = {
-	status: "idle",
-	progress: 0,
-	data: void 0,
-	error: void 0
-};
-/**
-* Uploads to a connected bucket with progress, abort and status state.
-* Unmounting aborts the upload in flight.
-*
-* ```tsx
-* const avatar = useUpload(avatars, { onSuccess: ({ path }) => save(path) });
-* <input type="file" onChange={(e) => avatar.upload({ userId }, e.target.files[0], { upsert: true })} />
-* <progress value={avatar.progress} />
-* ```
-*/
-function useUpload(bucket, options = {}) {
-	const [state, setState] = useState(IDLE);
-	const latest = useRef({
-		controller: void 0,
-		options
-	});
-	latest.current.options = options;
-	useEffect(() => () => {
-		latest.current.controller?.abort();
-	}, []);
-	const calls = useMemo(() => {
-		const stop = () => {
-			latest.current.controller?.abort();
-			latest.current.controller = void 0;
-			setState(IDLE);
-		};
-		return {
-			upload: async (target, body, uploadOptions) => {
-				latest.current.controller?.abort();
-				const controller = new AbortController();
-				latest.current.controller = controller;
-				const mine = () => latest.current.controller === controller;
-				setState({
-					...IDLE,
-					status: "uploading"
-				});
-				let result;
-				try {
-					result = await bucket.upload(target, body, {
-						...uploadOptions,
-						signal: controller.signal,
-						onProgress: (progress) => {
-							if (mine()) setState((last) => ({
-								...last,
-								progress
-							}));
-						}
-					});
-				} catch (cause) {
-					result = err(toDbError(cause));
-				}
-				if (!mine() || controller.signal.aborted) return result;
-				latest.current.controller = void 0;
-				if (result.ok) {
-					setState({
-						status: "done",
-						progress: 1,
-						data: result.data,
-						error: void 0
-					});
-					latest.current.options.onSuccess?.(result.data);
-				} else {
-					setState((last) => ({
-						...last,
-						status: "error",
-						error: result.error
-					}));
-					latest.current.options.onError?.(result.error);
-				}
-				return result;
-			},
-			abort: stop,
-			reset: stop
-		};
-	}, [bucket]);
-	return {
-		...state,
-		...calls
-	};
-}
-//#endregion
-export { useAction as a, usePresence as i, useUpload as n, useActionForm as o, useDebouncedSearch as r, useSignedUrl as t };

package/dist/react-topic-seAWjL3_.js

@@ -1,38 +0,0 @@
-import { t as joinTopic } from "./channels-CkgQ_X60.js";
-//#region src/blocks/react-topic.ts
-/**
-* Joins a private topic and returns the function that leaves it. Watches on
-* the same client and topic share one channel, as `defineTopic` subscriptions
-* do, and the channel closes when the last one leaves.
-*/
-function watchTopic(supabase, topic, watch) {
-	let joined = false;
-	let left = false;
-	let leave;
-	try {
-		({leave} = joinTopic(supabase, topic, true, false, false, {
-			onStatus: (status) => {
-				if (left) return;
-				if (status === "subscribed") {
-					if (joined) watch.onRejoin();
-					joined = true;
-				}
-				watch.onStatus(status);
-			},
-			receive: (message) => {
-				if (!left) watch.onMessage(message.event, message.payload);
-			}
-		}));
-	} catch {
-		watch.onStatus("error");
-		return () => void 0;
-	}
-	return () => {
-		if (left) return;
-		left = true;
-		watch.onStatus("closed");
-		queueMicrotask(() => void leave());
-	};
-}
-//#endregion
-export { watchTopic as t };