better-supabase 0.11.0 → 0.13.0

package/dist/cli/version-DiwcIKOL.js

@@ -0,0 +1,4 @@
+//#region src/cli/version.ts
+const VERSION = "0.13.0";
+//#endregion
+export { VERSION as t };

package/dist/cli/write-DZKk5rSF.js

@@ -0,0 +1,201 @@
+import { n as CliError } from "./errors-BTe6A15O.js";
+import { t as display } from "./io-DH1kcmmP.js";
+import { b as sqlPlan, c as writeLatestMigration, o as renderModuleMigration, p as writeExtensionsMigration, t as MODULES_SUFFIX, u as DATA_NEXT } from "./module-migration-CbX-jRhV.js";
+import { d as readSupabaseToml, f as schemaPaths, h as tomlGet, i as diffEngine, l as migrationCommand, o as findSupabaseRoot, p as sqlWorkflow, t as PGDELTA_TABLE } from "./supabase-toml-CncmQbO0.js";
+import { n as applyPlan, r as changeLines } from "./files-C5JfVnj5.js";
+import { t as loadTopics } from "./topics-BpdnYmWb.js";
+import { dirname, join, resolve } from "node:path";
+import { readFile, readdir } from "node:fs/promises";
+import { APP_TABLES_MARKER, APP_TABLES_MODULE, moduleTopics, renderModules, resolveModules, sameModuleFile } from "better-supabase/sql";
+import { CONFIG_DEFAULTS } from "better-supabase/config";
+//#region src/cli/enable-pgdelta.ts
+/**
+* Adds `[experimental.pgdelta] enabled = true` to `supabase/config.toml` when
+* it has no such table, so `supabase db schema declarative sync` runs on
+* pg-delta. A table set to `enabled = false` is left alone, and a project
+* without `config.toml` gets nothing.
+*/
+async function enablePgDelta(root, dryRun, base = root) {
+	const supabaseRoot = findSupabaseRoot(root);
+	const toml = await readSupabaseToml(root);
+	if (supabaseRoot === void 0 || toml === void 0) return [];
+	const path = join(supabaseRoot, "supabase/config.toml");
+	const shown = display(base, path);
+	if (diffEngine(toml) === "pg-delta") return [];
+	if (tomlGet(toml.document, ["experimental", "pgdelta"]) !== void 0 || toml.text.includes("pgdelta")) return [`Skipped ${shown} (pg-delta is off; set [experimental.pgdelta] enabled = true, remove [db.migrations] schema_paths and use \`supabase db schema declarative sync\` instead of \`supabase db diff\`)`];
+	const separator = toml.text === "" || toml.text.endsWith("\n\n") ? "" : toml.text.endsWith("\n") ? "\n" : "\n\n";
+	await applyPlan({
+		root: dirname(path),
+		regenerate: "better-supabase init",
+		files: [{
+			path,
+			contents: `${toml.text}${separator}${PGDELTA_TABLE}`,
+			policy: "edit"
+		}]
+	}, { "dry-run": dryRun });
+	return [`${dryRun ? "Would enable" : "Enabled"} pg-delta in ${shown}`];
+}
+//#endregion
+//#region src/cli/topic-policies.ts
+const literalParts = (template) => template.replaceAll(/\{[^}]+\}/g, "{}");
+const owns = (owned, template) => owned.endsWith("*") ? template.startsWith(owned.slice(0, -1)) : literalParts(owned) === literalParts(template);
+const receivesOnly = (sql) => !sql.includes(" for insert ") && !sql.includes("'presence'");
+function triggerStatement(topic, table, options, index) {
+	try {
+		return topic.trigger(table, options);
+	} catch (error) {
+		if (error instanceof TypeError) throw new CliError("config_invalid", `realtime.triggers[${String(index)}]: ${error.message}`);
+		throw error;
+	}
+}
+/** The file `realtime.policies` writes, or `undefined` when it isn't set. */
+async function topicPolicyFile(config, owned = []) {
+	const policies = config.realtime.policies;
+	const triggers = config.realtime.triggers;
+	if (policies === void 0) {
+		if (triggers.length > 0) throw new CliError("config_invalid", "realtime.triggers needs realtime.policies: the triggers go to its output, for topics its from files export");
+		return;
+	}
+	const topics = (await loadTopics(config.root, policies.from)).map((each) => each.topic);
+	const functions = config.authorization?.functions;
+	const sqlOf = (topic) => topic.sql(functions === void 0 ? void 0 : { functions });
+	const skipped = [];
+	const written = topics.filter((topic) => {
+		const owner = owned.find((entry) => owns(entry.topic, topic.template));
+		if (owner === void 0 || !receivesOnly(sqlOf(topic))) return true;
+		skipped.push(`-- Skipped topic ${topic.template}: the ${owner.module} module writes its receive policy.`);
+		return false;
+	});
+	const topicFor = (template, where) => {
+		const topic = topics.find((candidate) => candidate.template === template);
+		if (topic === void 0) throw new CliError("config_invalid", `${where}: no topic "${template}" in ${policies.from.join(", ")}`);
+		return topic;
+	};
+	const triggerSql = triggers.map(({ topic: template, table, topics: extra, ...options }, index) => {
+		const statement = triggerStatement(topicFor(template, "realtime.triggers"), table, {
+			...options,
+			...extra === void 0 ? {} : { topics: extra.map((each) => ({
+				topic: topicFor(each.topic, `realtime.triggers[${String(index)}].topics`),
+				...each.values === void 0 ? {} : { values: each.values }
+			})) }
+		}, index);
+		if (statement.includes("better_supabase.broadcast_topic(") && !config.blockNames.includes("realtime-tables")) throw new CliError("config_invalid", `realtime.triggers: the trigger for ${template} on ${table} calls better_supabase.broadcast_topic(): add realtime-tables to blocks`);
+		return statement;
+	});
+	const header = [
+		"-- better-supabase: realtime topic policies",
+		`-- Written by \`better-supabase sql sync\` from ${policies.from.join(", ")}; edit the topics, not this file.`,
+		...skipped
+	].join("\n");
+	return {
+		path: policies.output,
+		contents: `${header}\n\n${[...written.map(sqlOf), ...triggerSql].join("\n")}`
+	};
+}
+//#endregion
+//#region src/cli/sql/write.ts
+const MODULE_TEST_MARKER = /^-- @bs-module-test ([a-z0-9-]+)$/m;
+/**
+* Test files a SQL module wrote for an earlier layout (a table that is no
+* longer audited), for the modules in `names`. With `appTables`, also the app
+* tables files once `appTables` is empty.
+*/
+async function staleModuleTests(config, names, sqlLayout, files, appTables = true) {
+	const dir = (sqlLayout.testsDir ?? CONFIG_DEFAULTS.sql.testsDir).replace(/\/$/, "");
+	const entries = await readdir(resolve(config.root, dir)).catch(() => []);
+	const current = new Set(files.map((file) => file.path));
+	const modules = /* @__PURE__ */ new Set([...resolveModules(names, sqlLayout).map((module) => module.name), ...appTables ? [APP_TABLES_MODULE] : []]);
+	const stale = appTables ? await staleAppTablesSchema(config, sqlLayout, current) : [];
+	for (const name of entries.toSorted()) {
+		const path = `${dir}/${name}`;
+		if (!name.endsWith(".test.sql") || current.has(path)) continue;
+		const text = await readFile(resolve(config.root, path), "utf-8");
+		const module = MODULE_TEST_MARKER.exec(text)?.[1];
+		if (module !== void 0 && modules.has(module)) stale.push(path);
+	}
+	return stale;
+}
+/** The app tables schema file, when `appTables` no longer renders it. */
+async function staleAppTablesSchema(config, sqlLayout, current) {
+	const path = `${(sqlLayout.dir ?? CONFIG_DEFAULTS.sql.dir).replace(/\/$/, "")}/${sqlLayout.prefix ?? CONFIG_DEFAULTS.sql.prefix}_app_tables.sql`;
+	if (current.has(path)) return [];
+	return (await readFile(resolve(config.root, path), "utf-8").catch(() => "")).split("\n").includes(APP_TABLES_MARKER) ? [path] : [];
+}
+/** A rendered module file as a plan entry, compared without its module version. */
+const moduleFile = (file) => ({
+	path: file.path,
+	contents: file.contents,
+	note: file.module,
+	same: sameModuleFile
+});
+async function write(config, args, names, sqlLayout, now, only, upgrade = []) {
+	const workflow = sqlWorkflow(config, await readSupabaseToml(config.root));
+	const migrations = workflow === "migrations";
+	const lines = [];
+	const dryRun = args["dry-run"] === true;
+	const rendered = renderModules(names, sqlLayout);
+	const files = rendered.filter((file) => only === void 0 || only.includes(file.module));
+	const written = files.filter((file) => !migrations || file.kind === "test");
+	const applied = await applyPlan(sqlPlan(config, {
+		regenerate: "better-supabase sql sync",
+		files: written.map((file) => moduleFile(file)),
+		remove: await staleModuleTests(config, only ?? names, sqlLayout, files, only === void 0)
+	}), { "dry-run": dryRun });
+	lines.push(...changeLines(applied));
+	const data = !dryRun && applied.changes.some((change, index) => (change.outcome === "create" || change.outcome === "update") && written[index]?.kind === "data");
+	if (migrations) {
+		const topics = await topicPolicyFile(config, moduleTopics(names, sqlLayout));
+		const written = await writeLatestMigration(config, MODULES_SUFFIX, renderModuleMigration({
+			files: rendered,
+			upgrade,
+			...topics === void 0 ? {} : { topics: topics.contents }
+		}), {
+			now: now(),
+			dryRun,
+			force: upgrade.length > 0
+		});
+		lines.push(written.line);
+		return lines;
+	}
+	lines.push(...await writeExtensionsMigration(config, files, dryRun, now));
+	if (data) lines.push("", DATA_NEXT);
+	if (workflow === "pg-delta") lines.push(...await enablePgDelta(config.root, dryRun));
+	return lines;
+}
+/** The command that takes the written modules to the database. */
+async function nextStep(config) {
+	const workflow = sqlWorkflow(config, await readSupabaseToml(config.root));
+	return workflow === "migrations" ? {
+		command: migrationCommand(workflow),
+		when: "applies the migration"
+	} : {
+		command: migrationCommand(workflow, "better_supabase_module"),
+		when: "creates a migration from the module files"
+	};
+}
+/**
+* A note when migra's `schema_paths` is set and misses module files, which
+* `supabase db diff` would then skip.
+*/
+async function unlistedModuleFiles(config, names, sqlLayout) {
+	const toml = await readSupabaseToml(config.root);
+	const workflow = sqlWorkflow(config, toml);
+	if (workflow !== "migra") return [];
+	const order = await schemaPaths(config.root, toml, workflow);
+	if (!order.configured) return [];
+	const supabase = `${toml?.dir ?? "supabase"}/`;
+	const unlisted = new Set(order.unlisted);
+	const listed = new Set(order.files.filter((path) => !unlisted.has(path)));
+	const dir = `${config.sql.dir.replace(/\/$/, "")}/`;
+	const missing = renderModules(names, sqlLayout).filter((file) => file.kind !== "data").map((file) => file.path).filter((path) => path.startsWith(dir) && !listed.has(path));
+	if (missing.length === 0) return [];
+	return [
+		"",
+		`${toml?.path ?? "supabase/config.toml"} sets [db.migrations] schema_paths, and no entry matches these files, so \`supabase db diff\` skips them.`,
+		"Add them before the schemas that call their functions:",
+		...missing.map((path) => `  "./${path.startsWith(supabase) ? path.slice(supabase.length) : path}",`),
+		"Or switch to pg-delta, which orders the files by dependency: add [experimental.pgdelta] with enabled = true and remove schema_paths (doctor BS316)."
+	];
+}
+//#endregion
+export { write as a, unlistedModuleFiles as i, nextStep as n, topicPolicyFile as o, staleModuleTests as r, enablePgDelta as s, moduleFile as t };

package/dist/client/index.d.ts

@@ -1,7 +1,7 @@
-import { n as TopicPort, r as TopicWatch, t as TopicHandle } from "../watch-topic-DWHy63ZJ.js";
-import { a as PickFilesOptions, c as Shortcut, d as UploadPort, f as memoryStorage, i as KeyboardPort, l as StoragePort, n as DeepLinkPort, o as PickedFile, p as storageUpload, r as FilePickerPort, s as PushTokenPort, t as ClientPorts, u as UploadDestination } from "../ports-DCAcG26M.js";
-import { a as ClientAuth, i as BindClientOptions, n as AuthUser, o as bindClient, r as BetterClient, t as AuthSnapshot } from "../bind-CTNKpBM6.js";
-import { a as defineController, i as ControllerState, n as Controller, o as whileSignedIn, r as ControllerParts, t as AuthPort } from "../controller-BBXX1RMw.js";
-import { n as FunctionContract } from "../function-contract-DWqFl_QO.js";
-import { a as webDeepLinks, c as webPorts, d as FunctionContracts, f as FunctionsHost, h as functions, i as WebPushTokenOptions, l as webPushToken, m as TypedFunctions, n as createClient, o as webFilePicker, p as InvokeOptions, r as PushRegistrationLike, s as webKeyboard, t as ClientOptions, u as webStorage } from "../index-F6XTTkC9.js";
+import { n as TopicPort, r as TopicWatch, t as TopicHandle } from "../watch-topic-CloXeDTO.js";
+import { a as PickFilesOptions, c as Shortcut, d as UploadPort, f as memoryStorage, i as KeyboardPort, l as StoragePort, n as DeepLinkPort, o as PickedFile, p as storageUpload, r as FilePickerPort, s as PushTokenPort, t as ClientPorts, u as UploadDestination } from "../ports-n3ZWSS_I.js";
+import { a as ClientAuth, i as BindClientOptions, n as AuthUser, o as bindClient, r as BetterClient, t as AuthSnapshot } from "../bind-DcXLU1ul.js";
+import { a as defineController, i as ControllerState, n as Controller, o as whileSignedIn, r as ControllerParts, t as AuthPort } from "../controller-lWRcKqCl.js";
+import { n as FunctionContract } from "../function-contract-4vfi93Y5.js";
+import { a as webDeepLinks, c as webPorts, d as FunctionContracts, f as FunctionsHost, h as functions, i as WebPushTokenOptions, l as webPushToken, m as TypedFunctions, n as createClient, o as webFilePicker, p as InvokeOptions, r as PushRegistrationLike, s as webKeyboard, t as ClientOptions, u as webStorage } from "../index-B5dVVZtW.js";
 export { type AuthPort, type AuthSnapshot, type AuthUser, type BetterClient, type BindClientOptions, type ClientAuth, ClientOptions, type ClientPorts, type Controller, type ControllerParts, type ControllerState, type DeepLinkPort, type FilePickerPort, type FunctionContract, type FunctionContracts, type FunctionsHost, type InvokeOptions, type KeyboardPort, type PickFilesOptions, type PickedFile, type PushRegistrationLike, type PushTokenPort, type Shortcut, type StoragePort, type TopicHandle, type TopicPort, type TopicWatch, type TypedFunctions, type UploadDestination, type UploadPort, type WebPushTokenOptions, bindClient, createClient, defineController, functions, memoryStorage, storageUpload, webDeepLinks, webFilePicker, webKeyboard, webPorts, webPushToken, webStorage, whileSignedIn };

package/dist/client/index.js

@@ -1,9 +1,9 @@
-import { n as dbError } from "../errors-BV1SKTVs.js";
-import { a as ok, r as err, t as AsyncResult } from "../result-DIeYscA3.js";
-import { i as isProblem, r as fromProblem } from "../problem-JRCohp1j.js";
+import { n as dbError } from "../errors-D7u24ZJH.js";
+import { a as ok, r as err, t as AsyncResult } from "../result-DIT_qp4G.js";
+import { i as isProblem, r as fromProblem } from "../problem-D0KDiYPk.js";
 import { EnvValidationError, parseEnv } from "../env/index.js";
-import { n as storageUpload, r as bindClient, t as memoryStorage } from "../ports-aALjot-D.js";
-import { n as whileSignedIn, t as defineController } from "../controller-D6NyNrlZ.js";
+import { n as storageUpload, r as bindClient, t as memoryStorage } from "../ports-CM3aG3zn.js";
+import { n as whileSignedIn, t as defineController } from "../controller-BEliOBOv.js";
 import { createBrowserClient } from "@supabase/ssr";
 import { FunctionsFetchError, FunctionsHttpError, FunctionsRelayError, createClient as createClient$1 } from "@supabase/supabase-js";
 //#region src/client/web-ports.ts
@@ -111,8 +111,8 @@ function keyBytes(base64url) {
 	return Uint8Array.from(atob(padded), (char) => char.codePointAt(0) ?? 0);
 }
 /**
-* The push token port over the Push API: the token is the JSON of the
-* browser's push subscription, which a Web Push sender needs.
+* The push token port over the Push API: the token is the JSON of the browser's
+* push subscription, which a Web Push sender needs.
 */
 function webPushToken(options) {
 	return {
@@ -133,7 +133,10 @@ function webPushToken(options) {
 		}
 	};
 }
-/** The web ports `createClient` uses: storage, the keyboard, the file picker and deep links. */
+/**
+* The web ports `createClient` uses: storage, the keyboard, the file picker and
+* deep links.
+*/
 function webPorts() {
 	return {
 		storage: webStorage(),
@@ -216,11 +219,13 @@ function clientFor(options) {
 	});
 }
 /**
-* The browser side: a supabase-js client, repositories that follow the
-* session, TanStack Query options and an auth store for UI state.
+* The browser side: a supabase-js client, repositories that follow the session,
+* TanStack Query options and an auth store for UI state.
 *
 * ```ts
-* export const bs = createClient(betterSupabase, { env: { url, publishableKey } });
+* export const bs = createClient(betterSupabase, {
+*   env: { url, publishableKey },
+* });
 * ```
 */
 function createClient(betterSupabase, options = {}) {

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

@@ -1,10 +1,10 @@
-import { t as AsyncResult } from "../../result-BREt7qOh.js";
-import { S as UploadOptions, x as UploadBody } from "../../bucket-BBSNDFNH.js";
-import { n as TopicPort, r as TopicWatch, t as TopicHandle } from "../../watch-topic-DWHy63ZJ.js";
-import { a as PickFilesOptions, c as Shortcut, d as UploadPort, f as memoryStorage, i as KeyboardPort, l as StoragePort, n as DeepLinkPort, o as PickedFile, p as storageUpload, r as FilePickerPort, s as PushTokenPort, t as ClientPorts, u as UploadDestination } from "../../ports-DCAcG26M.js";
-import { a as ClientAuth, i as BindClientOptions, n as AuthUser, o as bindClient, r as BetterClient, t as AuthSnapshot } from "../../bind-CTNKpBM6.js";
-import { n as ExpoPushTokenOptions, r as expoPushToken, t as ExpoNotificationsLike } from "../../push-token-D2sDxSNN.js";
-import { a as OAuthSignInOptions, c as linkParams, i as OAuthClient, l as signInWithOAuthBrowser, n as AuthLinkClient, o as WebBrowserLike, r as AuthLinkResult, s as handleAuthDeepLink, t as AuthFailure } from "../../auth-link-BjFPqwLz.js";
+import { t as AsyncResult } from "../../result-mijqfoJN.js";
+import { C as UploadOptions, S as UploadBody } from "../../bucket-DBay-ICp.js";
+import { n as TopicPort, r as TopicWatch, t as TopicHandle } from "../../watch-topic-CloXeDTO.js";
+import { a as PickFilesOptions, c as Shortcut, d as UploadPort, f as memoryStorage, i as KeyboardPort, l as StoragePort, n as DeepLinkPort, o as PickedFile, p as storageUpload, r as FilePickerPort, s as PushTokenPort, t as ClientPorts, u as UploadDestination } from "../../ports-n3ZWSS_I.js";
+import { a as ClientAuth, i as BindClientOptions, n as AuthUser, o as bindClient, r as BetterClient, t as AuthSnapshot } from "../../bind-DcXLU1ul.js";
+import { n as ExpoPushTokenOptions, r as expoPushToken, t as ExpoNotificationsLike } from "../../push-token-8lvtOEv4.js";
+import { a as OAuthSignInOptions, c as linkParams, i as OAuthClient, l as signInWithOAuthBrowser, n as AuthLinkClient, o as WebBrowserLike, r as AuthLinkResult, s as handleAuthDeepLink, t as AuthFailure } from "../../auth-link-B4NL84XU.js";
 import { SupabaseClient } from "@supabase/supabase-js";
 //#region src/client/native/auto-refresh.d.ts
 /** The part of React Native's `AppState` that `autoRefreshOnForeground` uses. */
@@ -22,12 +22,12 @@ interface AutoRefreshClient {
   };
 }
 /**
- * Refreshes the Supabase session only while the app is in the foreground,
- * as supabase-js requires on React Native. Returns a function that removes
- * the listener and stops refreshing.
+ * Refreshes the Supabase session only while the app is in the foreground, as
+ * supabase-js requires on React Native. Returns a function that removes the
+ * listener and stops refreshing.
  *
  * ```ts
- * import { AppState } from 'react-native';
+ * import { AppState } from "react-native";
  * autoRefreshOnForeground(supabase, AppState);
  * ```
  */
@@ -59,7 +59,10 @@ export declare function keyValue(store: KeyValueStoreLike): KeyValue;
 //#region src/client/native/ports.d.ts
 /** The storage port over AsyncStorage, MMKV or any async string store. */
 export declare function nativeStorage(store: KeyValueStoreLike): StoragePort;
-/** The part of `expo-linking` (or React Native's `Linking`) the deep link port uses. */
+/**
+ * The part of `expo-linking` (or React Native's `Linking`) the deep link port
+ * uses.
+ */
 interface LinkingLike {
   getInitialURL(): Promise<string | null>;
   addEventListener(type: "url", listener: (event: {
@@ -114,7 +117,12 @@ interface NativePortsOptions {
  * result to `createNativeClient(betterSupabase, supabase, { ports })`.
  *
  * ```ts
- * const ports = nativePorts({ supabase, storage: AsyncStorage, linking: Linking, notifications: Notifications });
+ * const ports = nativePorts({
+ *   supabase,
+ *   storage: AsyncStorage,
+ *   linking: Linking,
+ *   notifications: Notifications,
+ * });
  * ```
  */
 export declare function nativePorts(options: NativePortsOptions): ClientPorts;
@@ -127,14 +135,14 @@ interface SecureStoreLike {
   deleteItemAsync(key: string, options?: SecureStoreOptionsLike): Promise<void>;
 }
 /**
- * The `expo-secure-store` options every call gets, such as
- * `keychainAccessible` or `keychainService`.
+ * The `expo-secure-store` options every call gets, such as `keychainAccessible`
+ * or `keychainService`.
  */
 interface SecureStoreOptionsLike {
   /**
-   * When the keychain item is readable. `SecureStore.AFTER_FIRST_UNLOCK`
-   * lets a background task or a push handler refresh the session while the
-   * device is locked; the default (`WHEN_UNLOCKED`) does not.
+   * When the keychain item is readable. `SecureStore.AFTER_FIRST_UNLOCK` lets a
+   * background task or a push handler refresh the session while the device is
+   * locked; the default (`WHEN_UNLOCKED`) does not.
    */
   readonly keychainAccessible?: number;
   readonly keychainService?: string;
@@ -149,23 +157,25 @@ interface AuthStorage {
 }
 interface SecureStorageOptions {
   /**
-   * Characters per stored value. Defaults to 1800: iOS warns above 2048
-   * bytes, and a Supabase session with custom claims is larger than that.
+   * Characters per stored value. Defaults to 1800: iOS warns above 2048 bytes,
+   * and a Supabase session with custom claims is larger than that.
    */
   readonly chunkSize?: number;
   /** Passed to every `expo-secure-store` call. */
   readonly storeOptions?: SecureStoreOptionsLike;
 }
 /**
- * Supabase Auth storage on the device keychain (`expo-secure-store`),
- * split into chunks so sessions above the platform's value size fit.
- * Operations on one key run one at a time, and a write moves the pointer
- * only after every chunk is stored, so a reader never joins chunks of two
- * values and a write that fails part way keeps the previous value.
+ * Supabase Auth storage on the device keychain (`expo-secure-store`), split
+ * into chunks so sessions above the platform's value size fit. Operations on
+ * one key run one at a time, and a write moves the pointer only after every
+ * chunk is stored, so a reader never joins chunks of two values and a write
+ * that fails part way keeps the previous value.
  *
  * ```ts
- * import * as SecureStore from 'expo-secure-store';
- * createClient(url, key, { auth: { storage: secureStorage(SecureStore) } });
+ * import * as SecureStore from "expo-secure-store";
+ * createClient(url, key, {
+ *   auth: { storage: secureStorage(SecureStore) },
+ * });
  * ```
  */
 export declare function secureStorage(store: SecureStoreLike, options?: SecureStorageOptions): AuthStorage;
@@ -187,16 +197,23 @@ interface LargeSecureStorageOptions {
   readonly storeOptions?: SecureStoreOptionsLike;
 }
 /**
- * Supabase Auth storage for sessions of any size: the session is encrypted
- * with AES-GCM and kept in MMKV or AsyncStorage, and only its key lives in
- * the keychain. A key that no longer decrypts (the app was reinstalled and
- * one store kept its data) reads as signed out and is replaced on the next
+ * Supabase Auth storage for sessions of any size: the session is encrypted with
+ * AES-GCM and kept in MMKV or AsyncStorage, and only its key lives in the
+ * keychain. A key that no longer decrypts (the app was reinstalled and one
+ * store kept its data) reads as signed out and is replaced on the next
  * sign-in.
  *
  * ```ts
- * import * as SecureStore from 'expo-secure-store';
- * import AsyncStorage from '@react-native-async-storage/async-storage';
- * createClient(url, key, { auth: { storage: largeSecureStorage({ secureStore: SecureStore, storage: AsyncStorage }) } });
+ * import * as SecureStore from "expo-secure-store";
+ * import AsyncStorage from "@react-native-async-storage/async-storage";
+ * createClient(url, key, {
+ *   auth: {
+ *     storage: largeSecureStorage({
+ *       secureStore: SecureStore,
+ *       storage: AsyncStorage,
+ *     }),
+ *   },
+ * });
  * ```
  */
 export declare function largeSecureStorage(options: LargeSecureStorageOptions): AuthStorage;
@@ -214,13 +231,16 @@ interface QueryPersister<T> {
 interface PersistQueryCacheOptions {
   /** Defaults to `better-supabase.query-cache`. */
   readonly key?: string;
-  /** Writes at most once per interval, keeping the latest cache. Defaults to 1000 ms. */
+  /**
+   * Writes at most once per interval, keeping the latest cache. Defaults to
+   * 1000 ms.
+   */
   readonly throttleMs?: number;
 }
 /**
- * Persists the query cache to MMKV or AsyncStorage, so a cold start shows
- * the last rows before the first fetch. The provider's `clearOnUserChange`
- * drops them when another user signs in.
+ * Persists the query cache to MMKV or AsyncStorage, so a cold start shows the
+ * last rows before the first fetch. The provider's `clearOnUserChange` drops
+ * them when another user signs in.
  *
  * ```tsx
  * <PersistQueryClientProvider client={queryClient} persistOptions={{ persister: persistQueryCache(storage) }}>
@@ -250,20 +270,29 @@ interface SyncQueryWithAppOptions {
   /** With `netInfo`, queries pause offline and refetch on reconnect. */
   readonly onlineManager?: OnlineManagerLike;
   readonly netInfo?: NetInfoLike;
-  /** Also refresh the session only in the foreground (`autoRefreshOnForeground`). */
+  /**
+   * Also refresh the session only in the foreground
+   * (`autoRefreshOnForeground`).
+   */
   readonly supabase?: AutoRefreshClient;
 }
 /**
- * Wires TanStack Query to the app lifecycle on React Native: queries count
- * as focused while the app is active, and as online while NetInfo reports
- * a connection (an unreachable internet counts as offline). Returns a
- * function that removes every listener.
+ * Wires TanStack Query to the app lifecycle on React Native: queries count as
+ * focused while the app is active, and as online while NetInfo reports a
+ * connection (an unreachable internet counts as offline). Returns a function
+ * that removes every listener.
  *
  * ```ts
- * import { focusManager, onlineManager } from '@tanstack/react-query';
- * import NetInfo from '@react-native-community/netinfo';
- * import { AppState } from 'react-native';
- * syncQueryWithApp({ focusManager, onlineManager, appState: AppState, netInfo: NetInfo, supabase });
+ * import { focusManager, onlineManager } from "@tanstack/react-query";
+ * import NetInfo from "@react-native-community/netinfo";
+ * import { AppState } from "react-native";
+ * syncQueryWithApp({
+ *   focusManager,
+ *   onlineManager,
+ *   appState: AppState,
+ *   netInfo: NetInfo,
+ *   supabase,
+ * });
  * ```
  */
 export declare function syncQueryWithApp(options: SyncQueryWithAppOptions): () => void;
@@ -274,20 +303,25 @@ interface UriUploadTarget<T, R> {
   upload(target: T, body: UploadBody, options?: UploadOptions): AsyncResult<R>;
 }
 interface UploadFromUriOptions extends UploadOptions {
-  /** Defaults to the global `fetch`, which reads `file://` and `content://` URIs on React Native. */
+  /**
+   * Defaults to the global `fetch`, which reads `file://` and `content://` URIs
+   * on React Native.
+   */
   readonly fetch?: (uri: string) => Promise<Response>;
 }
 /** The content type for a file URI's extension, ignoring a query or fragment. */
 export declare function contentTypeOf(uri: string): string | undefined;
 /**
- * Uploads a local file (an `expo-image-picker` or `expo-document-picker`
- * URI) to a connected bucket. The file is read into an `ArrayBuffer`, as
- * React Native's `Blob` can't be uploaded; the content type comes from the
- * option, the response or the extension.
+ * Uploads a local file (an `expo-image-picker` or `expo-document-picker` URI)
+ * to a connected bucket. The file is read into an `ArrayBuffer`, as React
+ * Native's `Blob` can't be uploaded; the content type comes from the option,
+ * the response or the extension.
  *
  * ```ts
  * const picked = await ImagePicker.launchImageLibraryAsync();
- * await uploadFromUri(avatars, { userId }, picked.assets[0].uri, { upsert: true });
+ * await uploadFromUri(avatars, { userId }, picked.assets[0].uri, {
+ *   upsert: true,
+ * });
  * ```
  */
 export declare function uploadFromUri<T, R>(bucket: UriUploadTarget<T, R>, target: T, uri: string, options?: UploadFromUriOptions): AsyncResult<R>;