better-supabase 0.9.0 → 0.11.0

package/dist/{define-B2ln373W.js → define-Bu1v781m.js}

@@ -1,12 +1,12 @@
 import { r as isPlainObject, t as cloneValue } from "./clone-dN9XOL1K.js";
 import { t as DbException } from "./db-exception-CnWcYPxL.js";
-import { n as dbError } from "./errors-8i6tSICm.js";
-import { n as invalidRequest, t as builderFor } from "./build-Cx08LOT7.js";
+import { n as dbError } from "./errors-BV1SKTVs.js";
+import { n as invalidRequest, t as builderFor } from "./build-C-D_vn0U.js";
 import { t as lookupOf } from "./lookup-BaP5bI27.js";
 import { i as or, n as column, r as not, t as and } from "./types-R6syp1el.js";
 import { c as optionalTemporal, l as provideTemporal, s as nowInstant, u as providedTemporal } from "./temporal-CB5Fpo5d.js";
-import { i as encodeValue, n as decodeScalar, r as decodeValue } from "./wire-DEY0ajW9.js";
-import { a as ok, c as withErrorMapper, r as err, s as toDbError, t as AsyncResult } from "./result-BlgnMB0H.js";
+import { i as encodeValue, n as decodeScalar, r as decodeValue } from "./wire-BCJxCtHS.js";
+import { a as ok, c as withErrorMapper, r as err, s as toDbError, t as AsyncResult } from "./result-DIeYscA3.js";
 import { t as invalidationTargets } from "./tables-Cb-3_VWc.js";
 import { t as vectorLiteral } from "./search-BtoWY6n_.js";
 import { t as consoleLogger } from "./logger-glM28NVN.js";
@@ -14,10 +14,10 @@ import { n as errorEvent, t as EventHub } from "./events-xbpHkcK9.js";
 import { n as isRecord, t as isList } from "./guards-6F2bCtQR.js";
 import { i as orderPlugins } from "./plugin-tfXW1-qO.js";
 import { t as simplify } from "./simplify-DDO0j0LI.js";
-import { a as postgrestExecutor, c as invalidTuning, l as tuningOf, n as StatsRecorder, o as NO_TUNING, r as recordStats, s as deadline } from "./stats-D6vkb89f.js";
-import { d as isQuerySpec, f as specTables, n as checkParams, o as isReadSet, r as containsPlaceholder, t as bindParams, u as createSpecs } from "./read-set-GEb-i0On.js";
-import { a as toBase64Url, t as base64ToText } from "./base64-BmeCBgGo.js";
-import { n as validate } from "./standard-B5fe2gnW.js";
+import { a as postgrestExecutor, c as invalidTuning, l as tuningOf, n as StatsRecorder, o as NO_TUNING, r as recordStats, s as deadline } from "./stats-Di5VAsYU.js";
+import { d as isQuerySpec, f as specTables, n as checkParams, o as isReadSet, r as containsPlaceholder, t as bindParams, u as createSpecs } from "./read-set-DeesfeL_.js";
+import { a as toBase64Url, t as base64ToText } from "./base64-D4aqdnDR.js";
+import { n as validate } from "./standard-B1BigegP.js";
 //#region src/core/batch.ts
 /**
 * A signal that aborts once every reader's signal has, so one reader giving
@@ -880,6 +880,7 @@ function sensitiveColumnsOf(table) {
 function createRepository(runner, table) {
 	const { builder } = runner.runtime;
 	const sensitiveDb = sensitiveColumnsOf(table);
+	const mutationHooks = runner.runtime.plugins.some((plugin) => plugin.beforeMutation);
 	const selection = (args) => builder.selection(table, args?.["select"], args?.["include"]);
 	const rowCount = (args, name) => {
 		const value = args?.[name];
@@ -1053,16 +1054,27 @@ function createRepository(runner, table) {
 			return guarded(async () => {
 				const key = and(builder.primaryKey(table, id), builder.where(table, args?.["where"]));
 				const expect = args?.["expect"] ? builder.where(table, args["expect"]) : void 0;
+				const set = builder.row(table, patch, "update");
+				const empty = !mutationHooks && Object.keys(set).length === 0;
 				const op = {
 					kind: "update",
 					table,
-					set: builder.row(table, patch, "update"),
+					set,
 					where: and(key, expect),
 					returning: returning(args)
 				};
-				const result = await run(op, args);
+				const result = empty ? await run(selectOp(args, {
+					where: and(key, expect),
+					selection: op.returning ?? {
+						columns: [],
+						includes: []
+					},
+					limit: 1,
+					orderBy: [],
+					offset: void 0
+				}), args) : await run(op, args);
 				if (!result.ok) return result;
-				if ((op.returning ? result.data.rows.length : result.data.count ?? 0) === 0) {
+				if ((op.returning || empty ? result.data.rows.length : result.data.count ?? 0) === 0) {
 					if (!expect) return notFound();
 					const exists = await run(selectOp(void 0, {
 						where: key,
@@ -1086,15 +1098,24 @@ function createRepository(runner, table) {
 				const rows = args["returning"] === true;
 				const bound = maxAffectedOf(args);
 				if ("invalid" in bound) return runner.fail(table, dbError("invalid_request", bound.invalid));
+				const set = builder.row(table, args["data"], "update");
 				const op = {
 					kind: "update",
 					table,
-					set: builder.row(table, args["data"], "update"),
+					set,
 					where,
 					returning: rows ? returning(args) : void 0,
 					...bound,
 					...countOf(args)
 				};
+				if (!mutationHooks && Object.keys(set).length === 0) {
+					if (!rows) return ok({ count: 0 });
+					const found = await run(selectOp(args, {
+						where,
+						selection: op.returning ?? selection(args)
+					}), args);
+					return found.ok ? ok(found.data.rows) : found;
+				}
 				const result = await run(op, args);
 				if (!result.ok) return result;
 				return ok(rows ? result.data.rows : { count: result.data.count ?? 0 });
@@ -1200,7 +1221,7 @@ function createRepository(runner, table) {
 		const window = pageWindow(args);
 		if ("invalid" in window) return runner.fail(table, dbError("invalid_request", window.invalid));
 		const { size, offset } = window;
-		const count = args["count"];
+		const count = args["count"] ?? (args["withCount"] === true ? "exact" : void 0);
 		const orderBy = builder.orderBy(table, args["orderBy"]);
 		const op = selectOp(args, {
 			orderBy: orderBy.length > 0 || table.primaryKey.length === 0 ? orderBy : defaultOrder(),
@@ -1237,10 +1258,27 @@ function createRepository(runner, table) {
 			orderBy,
 			limit: size + 1,
 			lookAhead: true,
-			offset: void 0
+			offset: void 0,
+			count: args["withCount"] === true && after === void 0 ? "exact" : void 0
 		});
 		const result = await run(op, args);
 		if (!result.ok) return result;
+		let total = result.data.count;
+		if (args["withCount"] === true && after !== void 0) {
+			const counted = await run(selectOp(args, {
+				selection: {
+					columns: [],
+					includes: []
+				},
+				orderBy: [],
+				limit: void 0,
+				offset: void 0,
+				count: "exact",
+				head: true
+			}), args);
+			if (!counted.ok) return counted;
+			total = counted.data.count;
+		}
 		const rows = result.data.rows.slice(0, size);
 		const hasMore = result.data.rows.length > size;
 		const last = rows.at(-1);
@@ -1249,7 +1287,8 @@ function createRepository(runner, table) {
 		return ok({
 			items: added.length > 0 ? rows.map((row) => strip(row, added)) : rows,
 			nextCursor,
-			hasMore
+			hasMore,
+			...args["withCount"] === true ? { total: total ?? 0 } : {}
 		});
 	}
 	function withTieBreaker(orderBy) {
@@ -1492,6 +1531,21 @@ var BetterSupabase = class BetterSupabase {
 			throwAs: mapper
 		}, this.events);
 	}
+	/**
+	* Returns a new instance whose `db.$buckets` has one client per bucket,
+	* connected to `db.$storage` so Storage runs as the same caller.
+	*
+	* ```ts
+	* const betterSupabase = defineSupabase(schema).buckets({ logos, avatars });
+	* betterSupabase.connect(client).$buckets.logos.signedUrl({ ... });
+	* ```
+	*/
+	buckets(registered) {
+		return new BetterSupabase(this.schema, this.plugins, {
+			...this.options,
+			buckets: registered
+		}, this.events);
+	}
 	#specs;
 	#truncatedTables = /* @__PURE__ */ new Set();
 	/** A hub without listeners, for decoding read-set results. */
@@ -1638,6 +1692,17 @@ var BetterSupabase = class BetterSupabase {
 			get: () => storageOf(source),
 			configurable: true
 		});
+		const { buckets } = this.options;
+		if (buckets) {
+			let connected;
+			Object.defineProperty(db, "$buckets", {
+				get: () => {
+					connected ??= Object.fromEntries(Object.entries(buckets).map(([name, bucket]) => [name, bucket.connect(storageOf(source))]));
+					return connected;
+				},
+				configurable: true
+			});
+		}
 		Object.assign(db, {
 			$client: client,
 			$executor: executor,
@@ -1840,7 +1905,8 @@ function runSpec(db, spec, signal) {
 	return method(...args);
 }
 function rpc(meta, executor, errorMappers, defaults, name, rest) {
-	const [args, options] = rest;
+	const [given, options] = rest;
+	const args = given === void 0 ? void 0 : Object.fromEntries(Object.entries(given).filter(([, value]) => value !== void 0));
 	return AsyncResult.from(async () => {
 		if (!executor.rpc) return err(dbError("unsupported", `Executor "${executor.name}" does not support rpc()`));
 		const tuning = {

package/dist/{define-DxHHbNEb.d.ts → define-M_r1d2AT.d.ts}

@@ -1,13 +1,26 @@
 /// <reference lib="esnext.temporal" />
-import { b as DbError, p as ThrowMapper, t as AsyncResult, w as ErrorMapper } from "./result-Cj3yWhjH.js";
-import { A as Relations, B as TableMeta, E as PrimaryKeyValue, F as Simplify, H as UniqueKeyName, M as Row, N as Schema, P as SchemaMeta, U as UniqueWhere, W as Update, a as AnyModels, i as AnyFunctions, k as RelationTypes, x as Insert, z as TableKey } from "./types-YfwpIE-d.js";
-import { l as CountMode, r as Executor, v as Operation } from "./executor-DoE-5iM8.js";
-import { a as EventHandler, c as MutationNotice, d as RpcNotice, o as EventHub, s as EventName } from "./events-CTreRrgP.js";
-import { a as ExtensionOf, h as WithExtension, m as RequestContext, n as AnyPlugin, r as ApplyExtension } from "./plugin-CDLJRFFg.js";
+import { T as ErrorMapper, b as DbError, p as ThrowMapper, t as AsyncResult } from "./result-BREt7qOh.js";
+import { A as RelationTypes, B as TableKey, D as PrimaryKeyValue, F as SchemaMeta, G as Update, I as Simplify, N as Row, P as Schema, S as Insert, U as UniqueKeyName, V as TableMeta, W as UniqueWhere, a as AnyModels, i as AnyFunctions, j as Relations } from "./types-BrpW5ixT.js";
+import { l as CountMode, r as Executor, v as Operation } from "./executor-BnMC0lj3.js";
+import { a as EventHandler, c as MutationNotice, d as RpcNotice, o as EventHub, s as EventName } from "./events-P3raDX2E.js";
+import { a as ExtensionOf, h as WithExtension, m as RequestContext, n as AnyPlugin, r as ApplyExtension } from "./plugin-D-95Q0w0.js";
 import { n as Logger } from "./logger-DWVYUmwi.js";
-import { t as StandardSchemaV1 } from "./standard-C3_AAF3g.js";
-import { t as StorageApi } from "./storage-api-Cx-1iWBd.js";
-import { a as PostgrestPlan, i as PostgrestCompileOptions } from "./postgrest-Cw9Bs5gm.js";
+import { t as StandardSchemaV1 } from "./standard-BcUQuUgu.js";
+import { j as StorageApi, n as Bucket, r as BucketClient } from "./bucket-BBSNDFNH.js";
+import { a as PostgrestPlan, i as PostgrestCompileOptions } from "./postgrest-CjnO1hbr.js";
+//#region src/core/db-buckets.d.ts
+/** Buckets registered with `betterSupabase.buckets()`, by key. */
+type BucketRegistry = Readonly<Record<string, Bucket<any, any>>>;
+/** `db.$buckets`: one connected client per registered bucket. */
+type BucketsHelper<B> = unknown extends B ? unknown : {
+  /**
+   * The registered buckets, connected to `db.$storage`. They run as the
+   * same caller as the `Db` and keep the tenant guard. Created on first
+   * read and reused for this `Db`.
+   */
+  readonly $buckets: { readonly [K in keyof B]: B[K] extends Bucket<infer P, infer Id> ? BucketClient<P, Id> : never; };
+};
+//#endregion
 //#region src/core/stats.d.ts
 /** Database work for one request (or one `db`). */
 interface DbStats {
@@ -41,6 +54,8 @@ declare function recordStats(executor: Executor, recorder: StatsRecorder): Execu
 //#endregion
 //#region src/core/define-types.d.ts
 interface SupabaseOptions {
+  /** Set by `betterSupabase.buckets()`; read by `db.$buckets`. */
+  readonly buckets?: BucketRegistry;
   /**
    * Clock used by plugins (timestamps, soft delete) and for the `time` of
    * block events on `betterSupabase.events`. Pass it to `createJobs` too.
@@ -142,6 +157,8 @@ interface TextOps {
   readonly like?: string;
   /** Case-insensitive LIKE pattern. */
   readonly ilike?: string;
+  /** Case-insensitive equality; `%`, `_` and backslashes in the value match themselves. */
+  readonly ieq?: string;
   /** POSIX regular expression (`~`). */
   readonly match?: string;
   /** Case-insensitive POSIX regular expression (`~*`). */
@@ -198,6 +215,8 @@ interface JsonPathOps {
   readonly lte?: string;
   readonly like?: string;
   readonly ilike?: string;
+  /** Case-insensitive equality; `%`, `_` and backslashes in the value match themselves. */
+  readonly ieq?: string;
   readonly match?: string;
   readonly imatch?: string;
 }
@@ -237,8 +256,12 @@ type SortSpec = SortDirection | {
   readonly direction: SortDirection;
   readonly nulls?: "first" | "last";
 };
-/** The columns of one table, each with a sort direction. */
-type ColumnOrderBy<M extends AnyModels, T extends keyof M> = { readonly [K in keyof Row<M, T>]?: SortSpec; };
+/**
+ * The columns of one table, each with a sort direction. `undefined` is
+ * allowed so a ternary between two objects (`?: undefined` after TypeScript
+ * merges the branches) passes `exactOptionalPropertyTypes`.
+ */
+type ColumnOrderBy<M extends AnyModels, T extends keyof M> = { readonly [K in keyof Row<M, T>]?: SortSpec | undefined; };
 /**
  * Columns of the table, and of its to-one relations one level down:
  * `{ organization: { name: "asc" } }` sorts by the related row's name.
@@ -555,12 +578,21 @@ interface UpdateArgs<M extends AnyModels, T extends keyof M> extends WriteArgs<M
    */
   readonly expect?: WhereInput<M, T>;
 }
-/** `updateMany` and `deleteMany` return the written rows with `returning: true`. */
-type ManyResult<M extends AnyModels, T extends keyof M, A> = A extends {
-  readonly returning: true;
-} ? Payload<M, T, A>[] : {
+/**
+ * The result of a many-row write by its `returning` option. Each case of
+ * `returning` (`true`, `false`, absent) picks rows or `{ count }`, and a
+ * widened `boolean` gives both. `Default` is what an absent option means:
+ * `true` for `createMany` and `upsertMany`, `false` for `updateMany` and
+ * `deleteMany`.
+ */
+type ManyOutcome<M extends AnyModels, T extends keyof M, A, Default extends boolean> = ReturningOption<A> extends (infer R) ? R extends true ? Payload<M, T, A>[] : R extends false ? {
   count: number;
-};
+} : Default extends true ? Payload<M, T, A>[] : {
+  count: number;
+} : never;
+type ReturningOption<A> = "returning" extends keyof A ? A["returning" & keyof A] : undefined;
+/** `updateMany` and `deleteMany` return the written rows with `returning: true`. */
+type ManyResult<M extends AnyModels, T extends keyof M, A> = ManyOutcome<M, T, A, false>;
 interface ManyReturningArgs<M extends AnyModels, T extends keyof M> extends RequestArgs {
   readonly where: WhereInput<M, T>;
   /** Return the written rows instead of `{ count }`. */
@@ -607,6 +639,8 @@ type OffsetPageArgs<M extends AnyModels, T extends keyof M> = Omit<FindManyArgs<
   readonly size: number;
   /** Also count all matching rows. */
   readonly count?: CountMode;
+  /** Shorthand for `count: "exact"`. */
+  readonly withCount?: boolean;
   readonly offset?: never;
   readonly limit?: never;
 };
@@ -616,6 +650,8 @@ type OffsetRangeArgs<M extends AnyModels, T extends keyof M> = Omit<FindManyArgs
   readonly limit: number;
   /** Also count all matching rows. */
   readonly count?: CountMode;
+  /** Shorthand for `count: "exact"`. */
+  readonly withCount?: boolean;
   readonly page?: never;
   readonly size?: never;
 };
@@ -623,14 +659,20 @@ type CursorPageArgs<M extends AnyModels, T extends keyof M> = Omit<FindManyArgs<
   /** Cursor from the previous page, or `null` for the first page. */
   readonly after: string | null;
   readonly size: number;
+  /**
+   * Also count every row matching `where` (ignoring the cursor) and return
+   * it as `total`. The first page reads it from the page request; later
+   * pages cost one more request.
+   */
+  readonly withCount?: boolean;
 };
-interface OffsetPage<R> {
+interface OffsetPage<R, Counted extends boolean = false> {
   readonly items: R[];
   readonly page: {
     readonly number: number;
     readonly size: number;
-    readonly total: number | null;
-    readonly pages: number | null;
+    readonly total: Counted extends true ? number : number | null;
+    readonly pages: Counted extends true ? number : number | null;
     readonly hasMore: boolean;
   };
 }
@@ -639,9 +681,18 @@ interface CursorPage<R> {
   readonly nextCursor: string | null;
   readonly hasMore: boolean;
 }
+/** A cursor page that was asked for a count. */
+type CountedCursorPage<R> = CursorPage<R> & {
+  readonly total: number;
+};
+type IsCounted<A> = A extends {
+  readonly withCount: true;
+} ? true : A extends {
+  readonly count: "exact" | "planned" | "estimated";
+} ? true : false;
 type PageOf<M extends AnyModels, T extends keyof M, A> = A extends {
   readonly after: unknown;
-} ? CursorPage<Payload<M, T, A>> : OffsetPage<Payload<M, T, A>>;
+} ? IsCounted<A> extends true ? CountedCursorPage<Payload<M, T, A>> : CursorPage<Payload<M, T, A>> : IsCounted<A> extends true ? OffsetPage<Payload<M, T, A>, true> : OffsetPage<Payload<M, T, A>>;
 interface Repository<M extends AnyModels, T extends TableKey<M>, E = unknown> {
   readonly $tableName: T;
   readonly $meta: TableMeta;
@@ -673,29 +724,21 @@ interface Repository<M extends AnyModels, T extends TableKey<M>, E = unknown> {
   } & FindExt<E, M, T>): AsyncResult<boolean>;
   paginate<const A extends (OffsetPageArgs<M, T> | OffsetRangeArgs<M, T> | CursorPageArgs<M, T>) & FindExt<E, M, T>>(args: A): AsyncResult<PageOf<M, T, A>>;
   create<const A extends WriteArgs<M, T> = {}>(data: Insert<M, T>, args?: A): AsyncResult<Returned<M, T, A>>;
-  createMany<const A extends WriteManyArgs<M, T> = {}>(rows: readonly Insert<M, T>[], args?: A): AsyncResult<A extends {
-    readonly returning: false;
-  } ? {
-    count: number;
-  } : Payload<M, T, A>[]>;
+  createMany<const A extends WriteManyArgs<M, T> = {}>(rows: readonly Insert<M, T>[], args?: A): AsyncResult<ManyOutcome<M, T, A, true>>;
   update<const A extends UpdateArgs<M, T> = {}>(id: PrimaryKeyValue<M, T>, patch: Update<M, T>, args?: A): AsyncResult<Returned<M, T, A>>;
   /**
    * Fails with `invalid_request` when `where` filters no rows (it is empty or
    * every value is `undefined`), unless `allowAll` is `true`.
    */
   updateMany<const A extends ManyReturningArgs<M, T> & {
-    readonly data: Update<M, T>;
+    readonly data: NoInfer<Update<M, T>>;
     /** Update every visible row when `where` filters nothing. */
     readonly allowAll?: boolean;
   } & FindExt<E, M, T>>(args: A): AsyncResult<ManyResult<M, T, A>>;
   upsert<const A extends UpsertArgs<M, T> = {}>(data: Insert<M, T>, args?: A): AsyncResult<A extends {
     readonly ignoreDuplicates: true;
   } ? Returned<M, T, A> | null : Returned<M, T, A>>;
-  upsertMany<const A extends UpsertManyArgs<M, T> = {}>(rows: readonly Insert<M, T>[], args?: A): AsyncResult<A extends {
-    readonly returning: false;
-  } ? {
-    count: number;
-  } : Payload<M, T, A>[]>;
+  upsertMany<const A extends UpsertManyArgs<M, T> = {}>(rows: readonly Insert<M, T>[], args?: A): AsyncResult<ManyOutcome<M, T, A, true>>;
   /** Returns a `not_found` error when no visible row has this key. */
   delete(id: PrimaryKeyValue<M, T>, args?: DeleteArgs & DeleteExt<E, M, T>): AsyncResult<void>;
   deleteMany<const A extends ManyReturningArgs<M, T> & DeleteExt<E, M, T> & FindExt<E, M, T>>(args: A): AsyncResult<ManyResult<M, T, A>>;
@@ -751,7 +794,7 @@ type OverloadArgs<O extends {
 type RawRpcOptions = Omit<RpcOptions<unknown>, "returns" | "raw"> & {
   readonly raw: true;
 };
-interface DbHelpers<M extends AnyModels, F extends AnyFunctions, E, C> {
+interface DbHelpers<M extends AnyModels, F extends AnyFunctions, E, C, B = unknown> {
   /** The underlying client (supabase-js), for anything the repository lacks. */
   readonly $client: C;
   /**
@@ -778,7 +821,7 @@ interface DbHelpers<M extends AnyModels, F extends AnyFunctions, E, C> {
   $rpc<N extends OverloadedName<F>, const A extends F[N]["Args"], R = OverloadReturns<F[N], A>>(name: N, args: OverloadArgs<F[N], A>, options?: RpcOptions<R>): AsyncResult<R>;
   $rpc<N extends NoArgName<F>>(name: N): AsyncResult<OverloadReturns<F[N], Record<never, never>>>;
   /** Same connection with more context (for example a tenant). */
-  $with(context: RequestContext): Db<M, F, E, C>;
+  $with(context: RequestContext): Db<M, F, E, C, B>;
   /**
    * Same connection without plugins: no tenant scoping, soft-delete filters,
    * timestamps, rules or executor wrappers. For migrations and admin tools.
@@ -787,7 +830,7 @@ interface DbHelpers<M extends AnyModels, F extends AnyFunctions, E, C> {
    */
   $withoutPlugins(options?: {
     readonly keep?: readonly string[];
-  }): Db<M, F, unknown, C>;
+  }): Db<M, F, unknown, C, B>;
   /**
    * The repository for a table named at runtime (MCP tools, admin screens).
    * Throws a `TypeError` for unknown names.
@@ -820,7 +863,7 @@ interface DbHelpers<M extends AnyModels, F extends AnyFunctions, E, C> {
    */
   $search<T extends TableKey<M>, const A extends SearchArgs<M, T>>(table: T, args: A): AsyncResult<(Payload<M, T, A> & SearchScore<A>)[]>;
 }
-type Db<M extends AnyModels, F extends AnyFunctions, E, C> = { readonly [T in TableKey<M>]: RepositoryOf<M, T, E>; } & DbHelpers<M, F, E, C>;
+type Db<M extends AnyModels, F extends AnyFunctions, E, C, B = unknown> = { readonly [T in TableKey<M>]: RepositoryOf<M, T, E>; } & DbHelpers<M, F, E, C, B> & BucketsHelper<B>;
 //#endregion
 //#region src/core/cache.d.ts
 /** What a mutation changed: a table, the primary keys of its rows and the tenant. */
@@ -906,7 +949,7 @@ declare function explainPostgrest(op: Operation, options?: PostgrestCompileOptio
  * The isomorphic definition of your data layer: schema plus plugins. Holds no
  * secrets and no connection; `connect()` binds it to a client per request.
  */
-declare class BetterSupabase<M extends AnyModels = AnyModels, D = unknown, F extends AnyFunctions = AnyFunctions, E = unknown, C = unknown, P = unknown> {
+declare class BetterSupabase<M extends AnyModels = AnyModels, D = unknown, F extends AnyFunctions = AnyFunctions, E = unknown, C = unknown, P = unknown, B = unknown> {
   #private;
   readonly schema: Schema<M, D, F>;
   readonly plugins: readonly AnyPlugin[];
@@ -929,7 +972,7 @@ declare class BetterSupabase<M extends AnyModels = AnyModels, D = unknown, F ext
    * const betterSupabase = defineSupabase(schema).claims(z.object({ tenant_id: z.uuid() }));
    * ```
    */
-  claims<S extends StandardSchemaV1>(schema: S): BetterSupabase<M, D, F, E, StandardSchemaV1.InferOutput<S>, P>;
+  claims<S extends StandardSchemaV1>(schema: S): BetterSupabase<M, D, F, E, StandardSchemaV1.InferOutput<S>, P, B>;
   /**
    * Returns a new instance whose sessions parse `user_metadata` with
    * `schema` into a typed `session.profile`. Users can change their metadata
@@ -942,7 +985,7 @@ declare class BetterSupabase<M extends AnyModels = AnyModels, D = unknown, F ext
    * const betterSupabase = defineSupabase(schema).userMetadata(z.object({ display_name: z.string() }));
    * ```
    */
-  userMetadata<S extends StandardSchemaV1>(schema: S): BetterSupabase<M, D, F, E, C, StandardSchemaV1.InferOutput<S>>;
+  userMetadata<S extends StandardSchemaV1>(schema: S): BetterSupabase<M, D, F, E, C, StandardSchemaV1.InferOutput<S>, B>;
   /**
    * Returns a new instance whose `.orThrow()` throws `mapper(error)` instead
    * of a `DbException`, and whose results `toBetterResult` maps the same way.
@@ -952,7 +995,17 @@ declare class BetterSupabase<M extends AnyModels = AnyModels, D = unknown, F ext
    * const betterSupabase = defineSupabase(schema).mapError((error) => new AppError(error));
    * ```
    */
-  mapError(mapper: (error: DbError) => unknown): BetterSupabase<M, D, F, E, C, P>;
+  mapError(mapper: (error: DbError) => unknown): BetterSupabase<M, D, F, E, C, P, B>;
+  /**
+   * Returns a new instance whose `db.$buckets` has one client per bucket,
+   * connected to `db.$storage` so Storage runs as the same caller.
+   *
+   * ```ts
+   * const betterSupabase = defineSupabase(schema).buckets({ logos, avatars });
+   * betterSupabase.connect(client).$buckets.logos.signedUrl({ ... });
+   * ```
+   */
+  buckets<const R extends BucketRegistry>(registered: R): BetterSupabase<M, D, F, E, C, P, R>;
   /**
    * Builds serializable `QuerySpec`s with the same arguments and result types
    * as the repository: `betterSupabase.spec.customers.findMany({ select: ['id'] })`.
@@ -961,7 +1014,7 @@ declare class BetterSupabase<M extends AnyModels = AnyModels, D = unknown, F ext
   /** App keys of every table a spec reads; mutations of any of them make it stale. */
   tablesOf(spec: QuerySpec): string[];
   /** Returns a new instance with the plugin appended. */
-  use<Q extends AnyPlugin>(plugin: Q): BetterSupabase<M, D, F, WithExtension<E, ExtensionOf<Q>>, C, P>;
+  use<Q extends AnyPlugin>(plugin: Q): BetterSupabase<M, D, F, WithExtension<E, ExtensionOf<Q>>, C, P, B>;
   /**
    * Declares the tables an RPC writes, so cache adapters and live queries
    * invalidate them after it succeeds.
@@ -972,7 +1025,7 @@ declare class BetterSupabase<M extends AnyModels = AnyModels, D = unknown, F ext
    */
   defineRpc(name: Extract<keyof F, string>, options: {
     readonly invalidates: readonly TableKey<M>[];
-  }): BetterSupabase<M, D, F, E, C, P>;
+  }): BetterSupabase<M, D, F, E, C, P, B>;
   /** Observes queries, mutations, errors, auth and refreshes. */
   on<K extends EventName>(name: K, handler: EventHandler<K>): () => void;
   /**
@@ -984,8 +1037,8 @@ declare class BetterSupabase<M extends AnyModels = AnyModels, D = unknown, F ext
    * Binds the definition to a supabase-js client (or any `Executor`) and a
    * request context. Cheap: call it once per request.
    */
-  connect<C extends PostgrestClientLike>(client: C, context?: RequestContext, options?: ConnectOptions): Db<M, F, E, C>;
-  connect(executor: Executor, context?: RequestContext, options?: ConnectOptions): Db<M, F, E, undefined>;
+  connect<C extends PostgrestClientLike>(client: C, context?: RequestContext, options?: ConnectOptions): Db<M, F, E, C, B>;
+  connect(executor: Executor, context?: RequestContext, options?: ConnectOptions): Db<M, F, E, undefined, B>;
   /**
    * The `postgrestExecutor` options this definition implies
    * (`urlLengthLimit`, `postgrestVersion`), for adapters that build their
@@ -1002,4 +1055,4 @@ declare class BetterSupabase<M extends AnyModels = AnyModels, D = unknown, F ext
  */
 declare function defineSupabase<M extends AnyModels, D, F extends AnyFunctions>(schema: Schema<M, D, F>, options?: SupabaseOptions): BetterSupabase<M, D, F>;
 //#endregion
-export { ReadSetParams as $, OverloadedName as A, NumericMeasureArg as At, UpsertArgs as B, WhereInput as Bt, ManyReturningArgs as C, FindOnlyArgs as Ct, OffsetRangeArgs as D, MeasureArg as Dt, OffsetPageArgs as E, JsonPathOps as Et, RepositoryOf as F, RelationMeasureArg as Ft, SearchScore as G, EMPTY_STATS as Gt, WriteArgs as H, RpcDefinition as Ht, Returned as I, RequestArgs as It, ReadSetAuth as J, InferReadSetParams as K, StatsRecorder as Kt, RpcArgs as L, SelectArg as Lt, PlainName as M, OrderByInput as Mt, RawRpcOptions as N, Payload as Nt, OverloadArgs as O, MeasureKey as Ot, Repository as P, ReadArgs as Pt, ReadSetParamValue as Q, RpcOptions as R, SortDirection as Rt, ManyResult as S, FindManyArgs as St, OffsetPage as T, IncludeArgs as Tt, WriteManyArgs as U, SupabaseOptions as Ut, UpsertManyArgs as V, ConnectOptions as Vt, SearchArgs as W, DbStats as Wt, ReadSetParamType as X, ReadSetOptions as Y, ReadSetParamTypes as Z, Db as _, ColumnOrderByArg as _t, explainPostgrest as a, QuerySpec as at, DeleteExt as b, FieldFilter as bt, CacheTarget as c, TableSpecs as ct, memoryCache as d, AggregateArgs as dt, ReadSetResult as et, rowKey as f, AggregateOrderBy as ft, CursorPageArgs as g, ColumnOrderBy as gt, CursorPage as h, AggregateRow as ht, PostgrestExecutorOptions as i, InferResult as it, PageOf as j, OrderByArg as jt, OverloadReturns as k, MutableWhere as kt, MemoryCache as l, isQuerySpec as lt, ConflictTarget as m, AggregateResult as mt, defineSupabase as n, isReadSet as nt, postgrestExecutor as o, ReadMethod as ot, rpcCacheTargets as p, AggregateOrderByArg as pt, ReadSet as q, recordStats as qt, PostgrestClientLike as r, readSetTables as rt, CacheAdapter as s, Specs as st, BetterSupabase as t, defineReadSet as tt, cacheTargetOf as u, specTables as ut, DbHelpers as v, CountArg as vt, NoArgName as w, IncludeArg as wt, FindExt as x, FindFirstArgs as xt, DeleteArgs as y, CountArgs as yt, UpdateArgs as z, SortSpec as zt };
+export { ReadSetParams as $, OverloadedName as A, NumericMeasureArg as At, UpsertArgs as B, WhereInput as Bt, ManyReturningArgs as C, FindOnlyArgs as Ct, OffsetRangeArgs as D, MeasureArg as Dt, OffsetPageArgs as E, JsonPathOps as Et, RepositoryOf as F, RelationMeasureArg as Ft, SearchScore as G, EMPTY_STATS as Gt, WriteArgs as H, RpcDefinition as Ht, Returned as I, RequestArgs as It, ReadSetAuth as J, BucketRegistry as Jt, InferReadSetParams as K, StatsRecorder as Kt, RpcArgs as L, SelectArg as Lt, PlainName as M, OrderByInput as Mt, RawRpcOptions as N, Payload as Nt, OverloadArgs as O, MeasureKey as Ot, Repository as P, ReadArgs as Pt, ReadSetParamValue as Q, RpcOptions as R, SortDirection as Rt, ManyResult as S, FindManyArgs as St, OffsetPage as T, IncludeArgs as Tt, WriteManyArgs as U, SupabaseOptions as Ut, UpsertManyArgs as V, ConnectOptions as Vt, SearchArgs as W, DbStats as Wt, ReadSetParamType as X, ReadSetOptions as Y, BucketsHelper as Yt, ReadSetParamTypes as Z, Db as _, ColumnOrderByArg as _t, explainPostgrest as a, QuerySpec as at, DeleteExt as b, FieldFilter as bt, CacheTarget as c, TableSpecs as ct, memoryCache as d, AggregateArgs as dt, ReadSetResult as et, rowKey as f, AggregateOrderBy as ft, CursorPageArgs as g, ColumnOrderBy as gt, CursorPage as h, AggregateRow as ht, PostgrestExecutorOptions as i, InferResult as it, PageOf as j, OrderByArg as jt, OverloadReturns as k, MutableWhere as kt, MemoryCache as l, isQuerySpec as lt, ConflictTarget as m, AggregateResult as mt, defineSupabase as n, isReadSet as nt, postgrestExecutor as o, ReadMethod as ot, rpcCacheTargets as p, AggregateOrderByArg as pt, ReadSet as q, recordStats as qt, PostgrestClientLike as r, readSetTables as rt, CacheAdapter as s, Specs as st, BetterSupabase as t, defineReadSet as tt, cacheTargetOf as u, specTables as ut, DbHelpers as v, CountArg as vt, NoArgName as w, IncludeArg as wt, FindExt as x, FindFirstArgs as xt, DeleteArgs as y, CountArgs as yt, UpdateArgs as z, SortSpec as zt };

package/dist/{define-block-CLZMEFeK.d.ts → define-block-CPyJ95rq.d.ts}

@@ -1,10 +1,10 @@
-import { D as BlockEventPattern, St as EventMapOf, T as BlockEvent, Tt as MergedEventMap, k as BlockEventsMatching, o as EventHub, wt as Events, xt as EventMap } from "./events-CTreRrgP.js";
-import { r as CredentialProvider } from "./provider-9gBq9W6k.js";
-import { n as BlockOptions } from "./block-helpers-C86hPEjI.js";
-import { a as BlockTransportMiddleware, n as BlockHooks } from "./block-hooks-BLPWD3Jt.js";
-import { t as BlockOptionsSchema } from "./options-CbSOj53r.js";
-import { i as EventSink } from "./cloud-event-5rCEzIgK.js";
-import { i as PortName, t as BlockPorts } from "./ports-Ca63W4cW.js";
+import { D as BlockEventPattern, St as EventMapOf, T as BlockEvent, Tt as MergedEventMap, k as BlockEventsMatching, o as EventHub, wt as Events, xt as EventMap } from "./events-P3raDX2E.js";
+import { r as CredentialProvider } from "./provider-CNs0Jx0I.js";
+import { n as BlockOptions } from "./block-helpers-CjcQM1yA.js";
+import { a as BlockTransportMiddleware, n as BlockHooks } from "./block-hooks-DcPJHztl.js";
+import { t as BlockOptionsSchema } from "./options-ZQzNKKBS.js";
+import { i as EventSink } from "./cloud-event-DXkNoI6v.js";
+import { i as PortName, t as BlockPorts } from "./ports-DGe1vzF2.js";
 //#region src/core/block-names.d.ts
 /**
  * How the SQL names the block functions: `sql.naming.tenant` and the

package/dist/{delegation-Dt8hMJWu.js → delegation-B7uNnz6z.js}

@@ -1,6 +1,6 @@
 import { n as isRecord } from "./guards-6F2bCtQR.js";
-import { n as actorOf } from "./actor-KHDOKGb1.js";
-import { n as impersonatorClaim, t as actClaim } from "./impersonation-CDeCzZP6.js";
+import { n as actorOf } from "./actor-CAL8mMih.js";
+import { n as impersonatorClaim, t as actClaim } from "./impersonation-DxU6yHJV.js";
 //#region src/auth/delegation.ts
 /**
 * The claim `forContext({ permissions })` sets: the permission keys the

package/dist/{documents-CWn2mtYf.d.ts → documents-CqtVr2fg.d.ts}

@@ -1,9 +1,9 @@
 /// <reference lib="esnext.temporal" />
-import { t as AsyncResult, w as ErrorMapper } from "./result-Cj3yWhjH.js";
+import { T as ErrorMapper, t as AsyncResult } from "./result-BREt7qOh.js";
 import { n as Logger } from "./logger-DWVYUmwi.js";
-import { t as BlockTransport } from "./block-transport-DaGGXjIw.js";
-import { r as BlockTemporalOptions } from "./block-helpers-C86hPEjI.js";
-import { n as BlockHooks } from "./block-hooks-BLPWD3Jt.js";
+import { t as BlockTransport } from "./block-transport-DezJPPA0.js";
+import { r as BlockTemporalOptions } from "./block-helpers-CjcQM1yA.js";
+import { n as BlockHooks } from "./block-hooks-DcPJHztl.js";
 //#region src/blocks/documents/documents.d.ts
 interface DocumentsOptions extends BlockTemporalOptions {
   readonly transport: BlockTransport;