better-supabase 0.7.1 → 0.9.0

package/dist/tax-D_kSCdWU.js

@@ -0,0 +1,140 @@
+import { n as dbError } from "./errors-8i6tSICm.js";
+import { a as ok, r as err, t as AsyncResult } from "./result-BlgnMB0H.js";
+import { c as isMoney, h as negateMoney, i as applyRate, l as isRate, v as subtractMoney, y as sumMoney } from "./money-95Rff2vT.js";
+//#region src/commerce/tax.ts
+/** The lineId of the shipping line in a quote. */
+const SHIPPING_LINE = "shipping";
+/** Checks the provider's `apiVersion` before a block uses it. */
+function taxProviderOf(provider) {
+	const version = provider.apiVersion;
+	if (version !== 1) throw new TypeError(`tax "${provider.name}" targets tax provider API ${String(version)}; this better-supabase supports 1. Upgrade better-supabase or use a release of the provider for API 1.`);
+	return provider;
+}
+const invalid = (message, hint) => dbError("invalid_input", message, { hint });
+/**
+* The first problem with a cart: a line or shipping amount that isn't
+* money, is negative or is in another currency, or a country that isn't
+* two capital letters.
+*/
+function invalidTaxCart(cart) {
+	if (!/^[A-Z]{2}$/.test(cart.address.country)) return invalid(`"${cart.address.country}" is not an ISO 3166-1 alpha-2 country code`, "TAX_ADDRESS_INVALID");
+	const amounts = [...cart.lines.map((line) => line.amount), ...cart.shipping ? [cart.shipping.amount] : []];
+	for (const amount of amounts) {
+		if (!isMoney(amount) || amount.amount < 0n) return invalid("Every cart line is Money of zero or more", "TAX_AMOUNT_INVALID");
+		if (amount.currency !== cart.currency) return invalid(`A ${amount.currency} line in a ${cart.currency} cart: lines never mix currencies`, "TAX_CURRENCY_MISMATCH");
+	}
+}
+/** The lines and total of a reversal, checked against the sale. */
+function reversalOf(input) {
+	const { transaction } = input;
+	if (input.lines === void 0) {
+		const lines = transaction.lines.map((line) => ({
+			...line,
+			taxable: negateMoney(line.taxable),
+			tax: negateMoney(line.tax)
+		}));
+		return ok({
+			lines,
+			totalTax: negateMoney(transaction.totalTax)
+		});
+	}
+	const byId = new Map(transaction.lines.map((line) => [line.lineId, line]));
+	const lines = [];
+	for (const part of input.lines) {
+		const sold = byId.get(part.lineId);
+		if (sold === void 0) return err(invalid(`The sale has no line "${part.lineId}"`, "TAX_REVERSAL_UNKNOWN_LINE"));
+		if (!isMoney(part.amount) || !isMoney(part.tax) || part.amount.currency !== transaction.currency || part.tax.currency !== transaction.currency || part.amount.amount < 0n || part.tax.amount < 0n || part.tax.amount > sold.tax.amount || part.amount.amount > sold.taxable.amount) return err(invalid(`The reversal of "${part.lineId}" is not a part of the sold line in ${transaction.currency}`, "TAX_REVERSAL_TOO_LARGE"));
+		lines.push({
+			...sold,
+			taxable: negateMoney(part.amount),
+			tax: negateMoney(part.tax)
+		});
+	}
+	return ok({
+		lines,
+		totalTax: sumMoney(lines.map((line) => line.tax), transaction.currency)
+	});
+}
+/**
+* A `TaxProvider` with fixed rates per country (and state) and tax
+* category, rounded half to even per line. It keeps nothing: `commit` and
+* `reverse` return the transaction for the app to store.
+*/
+function fixedRates(options) {
+	for (const [region, rates] of Object.entries(options.rates)) {
+		if (!/^[A-Z]{2}(-[A-Z0-9]{1,3})?$/.test(region)) throw new TypeError(`fixedRates: "${region}" is not a country code (NL) or a country and state (US-CA)`);
+		for (const [category, rate] of Object.entries(rates)) if (!isRate(rate)) throw new TypeError(`fixedRates: the ${region} "${category}" rate "${String(rate)}" is not a decimal fraction such as "0.21"`);
+	}
+	const name = options.name ?? "fixed-rates";
+	const defaultCategory = options.defaultCategory ?? "standard";
+	const shippingCategory = options.shippingCategory ?? defaultCategory;
+	const regionFor = (address) => {
+		const keys = [...address.state === void 0 ? [] : [`${address.country}-${address.state}`], address.country];
+		for (const region of keys) {
+			const rates = options.rates[region];
+			if (rates !== void 0) return {
+				region,
+				rates
+			};
+		}
+	};
+	const lineOf = (lineId, amount, category, inclusive, region, exempt) => {
+		const rate = exempt || region === void 0 ? "0" : region.rates[category];
+		if (rate === void 0) return err(dbError("not_found", `No "${category}" tax rate for this region`, { hint: "TAX_RATE_UNKNOWN" }));
+		const tax = applyRate(amount, rate, { included: inclusive });
+		return ok({
+			lineId,
+			taxable: inclusive ? subtractMoney(amount, tax) : amount,
+			tax,
+			rate,
+			inclusive,
+			...region === void 0 ? {} : { jurisdiction: region.region },
+			taxCategory: category
+		});
+	};
+	return {
+		apiVersion: 1,
+		name,
+		quote: (cart) => AsyncResult.from(() => Promise.resolve(quoteOf(cart))),
+		commit: ({ quote, reference }) => AsyncResult.ok({
+			id: quote.id,
+			reference,
+			currency: quote.currency,
+			totalTax: quote.totalTax,
+			lines: quote.lines
+		}),
+		reverse: (input) => AsyncResult.from(() => Promise.resolve(reversalOf(input))).map((reversal) => ({
+			id: `${input.transaction.id}:${input.reference}`,
+			reference: input.reference,
+			currency: input.transaction.currency,
+			...reversal
+		}))
+	};
+	function quoteOf(cart) {
+		const problem = invalidTaxCart(cart);
+		if (problem) return err(problem);
+		const rates = regionFor(cart.address);
+		if (rates === void 0 && options.unknownRegion !== "zero") return err(dbError("not_found", `No tax rates for ${cart.address.country}${cart.address.state ? `-${cart.address.state}` : ""}`, { hint: "TAX_REGION_UNKNOWN" }));
+		const exempt = cart.customer?.exempt === true;
+		const lines = [];
+		for (const line of cart.lines) {
+			const taxed = lineOf(line.id, line.amount, line.taxCategory ?? defaultCategory, line.inclusive === true, rates, exempt);
+			if (!taxed.ok) return taxed;
+			lines.push(taxed.data);
+		}
+		if (cart.shipping) {
+			const taxed = lineOf(SHIPPING_LINE, cart.shipping.amount, cart.shipping.taxCategory ?? shippingCategory, cart.shipping.inclusive === true, rates, exempt);
+			if (!taxed.ok) return taxed;
+			lines.push(taxed.data);
+		}
+		return ok({
+			id: `fixed_${crypto.randomUUID()}`,
+			provider: name,
+			currency: cart.currency,
+			lines,
+			totalTax: sumMoney(lines.map((line) => line.tax), cart.currency)
+		});
+	}
+}
+//#endregion
+export { taxProviderOf as a, reversalOf as i, fixedRates as n, invalidTaxCart as r, SHIPPING_LINE as t };

package/dist/tee-Bsisfd7t.js

@@ -0,0 +1,101 @@
+import { a as ok, r as err, s as toDbError, t as AsyncResult } from "./result-BlgnMB0H.js";
+//#region src/streams/tee.ts
+/**
+* Copies `source` into `store` under `id` while passing it through. Chunks
+* are written in batches, each at its own index, so a reader that counted
+* `n` chunks of the live stream resumes with `read(id, n)`.
+*/
+function teeToStore(store, id, source, options = {}) {
+	const [live, copy] = source.tee();
+	return {
+		stream: live,
+		persisted: AsyncResult.from(() => persist(store, id, copy, options))
+	};
+}
+/**
+* Stores `source` under `id` without a live copy, for a stream the caller
+* already sends elsewhere (the second branch of its own `tee()`). Settles
+* like `teeToStore`'s `persisted`.
+*/
+function writeToStore(store, id, source, options = {}) {
+	return AsyncResult.from(() => persist(store, id, source, options));
+}
+async function persist(store, id, copy, options) {
+	const { flushMs = 100, flushBytes = 4096, onCancel } = options;
+	const opened = await store.open(id, {
+		...options.owner === void 0 ? {} : { owner: options.owner },
+		...options.tenant === void 0 ? {} : { tenant: options.tenant },
+		...options.kind === void 0 ? {} : { kind: options.kind },
+		...options.ttl === void 0 ? {} : { ttl: options.ttl }
+	});
+	if (!opened.ok) {
+		copy.cancel().catch(() => void 0);
+		return opened;
+	}
+	let next = 0;
+	let buffer = [];
+	let bytes = 0;
+	let failure;
+	let cancelled = false;
+	let timer;
+	let writing = Promise.resolve();
+	const flush = () => {
+		if (timer !== void 0) clearTimeout(timer);
+		timer = void 0;
+		if (buffer.length === 0) return writing;
+		const batch = buffer;
+		const from = next;
+		buffer = [];
+		bytes = 0;
+		next += batch.length;
+		writing = writing.then(async () => {
+			if (failure) return;
+			const appended = await store.append(id, from, batch);
+			if (!appended.ok) {
+				failure = appended.error;
+				return;
+			}
+			if (appended.data.cancelled && !cancelled) {
+				cancelled = true;
+				onCancel?.();
+			}
+		});
+		return writing;
+	};
+	const reader = copy.getReader();
+	let sourceError;
+	try {
+		for (;;) {
+			const { done, value } = await reader.read();
+			if (done) break;
+			buffer.push(value);
+			bytes += value.length;
+			if (bytes >= flushBytes) flush();
+			else timer ??= setTimeout(() => void flush(), flushMs);
+			if (failure) break;
+		}
+	} catch (cause) {
+		sourceError = cause;
+	} finally {
+		reader.releaseLock();
+	}
+	await flush();
+	if (failure) {
+		copy.cancel().catch(() => void 0);
+		return err(failure);
+	}
+	const closed = await store.close(id);
+	if (!closed.ok) return closed;
+	return sourceError === void 0 ? ok(next) : err(toDbError(sourceError));
+}
+/**
+* The rest of stream `id` from `fromIdx`, or `undefined` when there is
+* nothing to resume: no such stream, or a closed one the client has read to
+* the end. A route answers `undefined` with 204.
+*/
+function resumeFromStore(store, id, options = {}) {
+	const from = options.fromIdx ?? 0;
+	return store.status(id).map((status) => status === void 0 || status.closed && from >= status.next ? void 0 : store.read(id, from, options.signal === void 0 ? {} : { signal: options.signal }));
+}
+//#endregion
+export { teeToStore as n, writeToStore as r, resumeFromStore as t };

package/dist/template-DdgYjIZ5.js

@@ -0,0 +1,123 @@
+import { t as DbException } from "./db-exception-CnWcYPxL.js";
+import { n as dbError } from "./errors-8i6tSICm.js";
+//#region src/core/template.ts
+const PLACEHOLDER = /\{(\.\.\.)?([A-Za-z_][A-Za-z0-9_]*)\}/g;
+function parseSegment(segment) {
+	const parts = [];
+	let last = 0;
+	for (const match of segment.matchAll(PLACEHOLDER)) {
+		if (match.index > last) parts.push({
+			kind: "literal",
+			text: segment.slice(last, match.index)
+		});
+		parts.push({
+			kind: match[1] ? "rest" : "param",
+			name: match[2]
+		});
+		last = match.index + match[0].length;
+	}
+	if (last < segment.length) parts.push({
+		kind: "literal",
+		text: segment.slice(last)
+	});
+	return parts;
+}
+const escapeRegex = (text) => text.replaceAll(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function parseTemplate(source, separator, validate, options = {}) {
+	const segments = source.split(separator).map(parseSegment);
+	const params = [];
+	let rest;
+	for (const [position, segment] of segments.entries()) {
+		if (segment.length === 0) throw new TypeError(`Template "${source}" has an empty segment`);
+		for (let index = 1; index < segment.length; index++) if (segment[index].kind !== "literal" && segment[index - 1].kind !== "literal") throw new TypeError(`Template "${source}" has adjacent placeholders`);
+		for (const part of segment) {
+			if (part.kind === "literal") continue;
+			if (part.kind === "rest") {
+				if (!options.rest) throw new TypeError(`Template "${source}" uses {...${part.name}}, which is not supported here`);
+				if (segment.length !== 1 || position !== segments.length - 1) throw new TypeError(`Template "${source}": {...${part.name}} must be the whole last segment`);
+				rest = part.name;
+			}
+			if (params.includes(part.name)) throw new TypeError(`Template "${source}" repeats {${part.name}}`);
+			params.push(part.name);
+		}
+	}
+	if (/[{}]/.test(segments.flat().map((part) => part.kind === "literal" ? part.text : "").join(""))) throw new TypeError(`Template "${source}" has an unbalanced brace`);
+	const sep = escapeRegex(separator);
+	const valueClass = `[^${separator === "/" ? "/" : sep}]+`;
+	const restClass = `${valueClass}(?:${sep}${valueClass})*`;
+	const regexFor = (withNames) => segments.map((segment) => segment.map((part) => {
+		if (part.kind === "literal") return escapeRegex(part.text);
+		const pattern = part.kind === "rest" ? restClass : valueClass;
+		return withNames ? `(?<${part.name}>${pattern})` : pattern;
+	}).join("")).join(sep);
+	const matcher = new RegExp(`^${regexFor(true)}$`);
+	const valueProblem = (name, value) => value === "" ? "is empty" : value.includes(separator) ? `contains "${separator}"` : validate(name, value);
+	const restProblem = (name, value) => {
+		if (value === "") return "is empty";
+		for (const part of value.split(separator)) {
+			const problem = part === "" ? "has an empty segment" : validate(name, part);
+			if (problem) return problem;
+		}
+	};
+	const render = (name, raw) => {
+		if (raw === void 0 || typeof raw !== "string" && typeof raw !== "number") throw new DbException(dbError("invalid_input", `Missing value for {${name}}`));
+		const value = String(raw);
+		const problem = rest === name ? restProblem(name, value) : valueProblem(name, value);
+		if (problem) throw new DbException(dbError("invalid_input", `Value for {${name}} ${problem}`));
+		return value;
+	};
+	const renderSegment = (segment, values) => segment.map((part) => part.kind === "literal" ? part.text : render(part.name, values[part.name])).join("");
+	return {
+		source,
+		separator,
+		params,
+		segments: segments.length,
+		build: (values) => segments.map((segment) => renderSegment(segment, values)).join(separator),
+		match(value) {
+			const found = matcher.exec(value);
+			if (!found?.groups) return found ? {} : null;
+			const out = {};
+			for (const name of params) {
+				const part = found.groups[name];
+				if (rest === name ? restProblem(name, part) : validate(name, part)) return null;
+				out[name] = part;
+			}
+			return out;
+		},
+		prefix(values, maxSegments = segments.length) {
+			const out = [];
+			for (const segment of segments.slice(0, maxSegments)) {
+				if (segment.some((part) => part.kind !== "literal" && values[part.name] === void 0)) break;
+				out.push(renderSegment(segment, values));
+			}
+			return out.join(separator);
+		},
+		segmentOf(name) {
+			const index = segments.findIndex((segment) => segment.length === 1 && segment[0].kind === "param" && segment[0].name === name);
+			return index === -1 ? void 0 : index + 1;
+		},
+		sqlPattern: `^${regexFor(false)}$`,
+		rest
+	};
+}
+function sqlString(value) {
+	return `'${value.replaceAll("'", "''")}'`;
+}
+function sqlIdent(value) {
+	return `"${value.replaceAll("\"", "\"\"")}"`;
+}
+/** Postgres identifier-safe name part: `customer-logos` → `customer_logos`. */
+function slug(value) {
+	return value.replaceAll(/[^A-Za-z0-9]+/g, "_").replaceAll(/^_|_$/g, "").toLowerCase();
+}
+/** SQL for the JWT claim at a dotted path, or the first set one of several (`coalesce`). */
+function claimSql(claim) {
+	const expressions = (typeof claim === "string" ? [claim] : claim).map((path) => {
+		const keys = path.split(".");
+		const last = keys.pop();
+		return `(select auth.jwt())${keys.map((key) => ` -> ${sqlString(key)}`).join("")} ->> ${sqlString(last)}`;
+	});
+	return expressions.length === 1 ? expressions[0] : `coalesce(${expressions.join(", ")})`;
+}
+//#endregion
+export { sqlString as a, sqlIdent as i, parseTemplate as n, slug as r, claimSql as t };

package/dist/temporal-CB5Fpo5d.js

@@ -0,0 +1,79 @@
+const TEMPORAL_MISSING = `Temporal is not available in this runtime. Pass it to defineSupabase(schema, { temporal }) (import { Temporal } from "temporal-polyfill"), or import "temporal-polyfill/global" once at startup.`;
+let provided;
+/**
+* Uses `namespace` wherever better-supabase needs Temporal, without touching
+* `globalThis`. `defineSupabase(schema, { temporal })` calls it; call it
+* yourself when you use a standalone helper (webhook verification, jobs)
+* without a definition. `undefined` goes back to the global.
+*/
+function provideTemporal(namespace) {
+	provided = namespace;
+}
+/** The namespace `provideTemporal` set, without the global fallback. */
+function providedTemporal() {
+	return provided;
+}
+/** The provided `Temporal`, else the runtime's, or `undefined` when neither exists. */
+function optionalTemporal() {
+	if (provided !== void 0) return provided;
+	return globalThis.Temporal;
+}
+/**
+* The current instant, the default `now` everywhere. Without Temporal it
+* throws a `TypeError` that names the injection option and the polyfill.
+*/
+function nowInstant() {
+	const namespace = optionalTemporal();
+	if (namespace === void 0) throw new TypeError(TEMPORAL_MISSING);
+	return namespace.Now.instant();
+}
+const ISO_TAGS = /* @__PURE__ */ new Set([
+	"Temporal.Instant",
+	"Temporal.PlainDateTime",
+	"Temporal.PlainDate",
+	"Temporal.PlainTime"
+]);
+function tagOf(value) {
+	if (typeof value !== "object" || value === null) return;
+	if (!(Symbol.toStringTag in value)) return;
+	return value[Symbol.toStringTag];
+}
+/**
+* The text Postgres reads back for a Temporal value: ISO 8601, with a
+* `ZonedDateTime` sent as its instant because Postgres rejects the
+* `[Region/City]` annotation. `undefined` for anything else.
+*
+* Values are recognized by `Symbol.toStringTag`, not `instanceof`, so values
+* from another realm or a second copy of the polyfill still encode.
+*/
+function temporalText(value) {
+	const tag = tagOf(value);
+	if (tag === void 0) return;
+	if (ISO_TAGS.has(tag)) return String(value);
+	return tag === "Temporal.ZonedDateTime" && typeof value === "object" && value !== null && isZoned(value) ? String(value.toInstant()) : void 0;
+}
+function isZoned(value) {
+	return "toInstant" in value && typeof value.toInstant === "function";
+}
+/** A `Temporal.Instant` from any copy of Temporal, checked by `Symbol.toStringTag`. */
+function isInstant(value) {
+	return tagOf(value) === "Temporal.Instant";
+}
+/** A `Temporal.PlainDateTime` from any copy of Temporal. */
+function isPlainDateTime(value) {
+	return tagOf(value) === "Temporal.PlainDateTime";
+}
+/** A `Temporal.PlainDate` from any copy of Temporal. */
+function isPlainDate(value) {
+	return tagOf(value) === "Temporal.PlainDate";
+}
+/** A `Temporal.PlainTime` from any copy of Temporal. */
+function isPlainTime(value) {
+	return tagOf(value) === "Temporal.PlainTime";
+}
+/** A `Temporal.ZonedDateTime` from any copy of Temporal. */
+function isZonedDateTime(value) {
+	return tagOf(value) === "Temporal.ZonedDateTime";
+}
+//#endregion
+export { isPlainTime as a, optionalTemporal as c, temporalText as d, isPlainDateTime as i, provideTemporal as l, isInstant as n, isZonedDateTime as o, isPlainDate as r, nowInstant as s, TEMPORAL_MISSING as t, providedTemporal as u };

package/dist/temporal-required-DqRzr7i0.js

@@ -0,0 +1,20 @@
+import { t as DbException } from "./db-exception-CnWcYPxL.js";
+import { n as dbError } from "./errors-8i6tSICm.js";
+import { c as optionalTemporal, t as TEMPORAL_MISSING } from "./temporal-CB5Fpo5d.js";
+//#region src/core/temporal-required.ts
+/** The error for a runtime without Temporal, naming the polyfill to load. */
+function temporalMissing() {
+	return dbError("unexpected", TEMPORAL_MISSING);
+}
+/**
+* The runtime's `Temporal`. Node 26, Chromium, Firefox and Deno ship it.
+* Elsewhere it throws a `DbException`, which repositories return as an
+* `unexpected` error that names the polyfill.
+*/
+function temporal() {
+	const namespace = optionalTemporal();
+	if (namespace === void 0) throw new DbException(temporalMissing());
+	return namespace;
+}
+//#endregion
+export { temporalMissing as n, temporal as t };

package/dist/tenant-B-fiItlJ.js

@@ -0,0 +1,27 @@
+import { a as tenantClaimPaths, n as claimAt } from "./claims-PqzCxaTD.js";
+//#region src/auth/tenant.ts
+/**
+* The active tenant of a user session: the `claim` claim (`tenant_id` by
+* default, as `config.claims.tenant`) at the top level of the token, then in
+* `app_metadata`. `undefined` for every other session. Takes a server
+* session or the client's `useAuth()` snapshot.
+*
+* ```ts
+* const organizationId = tenantOf(await bs.session());
+* const organizationId = tenantOf(useAuth());
+* ```
+*/
+function tenantOf(session, claim) {
+	const claims = claimsOf(session);
+	if (claims === void 0) return;
+	for (const path of tenantClaimPaths(claim)) {
+		const value = claimAt(claims, path);
+		if (value !== void 0) return value;
+	}
+}
+function claimsOf(session) {
+	if ("kind" in session) return session.kind === "user" ? session.claims : void 0;
+	return session.status === "signed-in" ? session.claims : void 0;
+}
+//#endregion
+export { tenantOf as t };

package/dist/tenant-DdmVhsff.d.ts

@@ -0,0 +1,17 @@
+import { t as AuthSnapshot } from "./bind-a7sUgvf4.js";
+import { t as AuthSession } from "./view-Dv0A949a.js";
+//#region src/auth/tenant.d.ts
+/**
+ * The active tenant of a user session: the `claim` claim (`tenant_id` by
+ * default, as `config.claims.tenant`) at the top level of the token, then in
+ * `app_metadata`. `undefined` for every other session. Takes a server
+ * session or the client's `useAuth()` snapshot.
+ *
+ * ```ts
+ * const organizationId = tenantOf(await bs.session());
+ * const organizationId = tenantOf(useAuth());
+ * ```
+ */
+declare function tenantOf<C, P>(session: AuthSession<C, P> | AuthSnapshot, claim?: string): string | undefined;
+//#endregion
+export { tenantOf as t };

package/dist/tenant-naming-Bsj3Uvap.js

@@ -0,0 +1,27 @@
+//#region src/core/tenant-naming.ts
+/** The default name of the tenant concept in SQL and method names. */
+const DEFAULT_TENANT_NAME = "organization";
+const TENANT_NAME = /^[a-z][a-z0-9_]{0,40}$/;
+const DEFAULT_PATTERN = /organization(s?)/g;
+function pluralOf(word) {
+	if (/[^aeiou]y$/.test(word)) return `${word.slice(0, -1)}ies`;
+	if (/(s|x|z|ch|sh)$/.test(word)) return `${word}es`;
+	return `${word}s`;
+}
+/**
+* The tenant concept's names for `sql.naming.tenant`. Throws on a name that
+* isn't a lowercase identifier.
+*/
+function tenantNames(name = DEFAULT_TENANT_NAME) {
+	if (!TENANT_NAME.test(name)) throw new TypeError(`sql.naming.tenant: "${name}" is not a lowercase identifier (letters, digits and underscores)`);
+	const plural = pluralOf(name);
+	const renamed = name !== DEFAULT_TENANT_NAME;
+	return {
+		singular: name,
+		plural,
+		renamed,
+		rename: (identifier) => renamed ? identifier.replaceAll(DEFAULT_PATTERN, (_, s) => s === "" ? name : plural) : identifier
+	};
+}
+//#endregion
+export { tenantNames as t };