better-supabase 0.12.0 → 0.14.0

package/dist/temporal-CB5Fpo5d.js

@@ -1,79 +0,0 @@
-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-nfZ87U-0.js

@@ -1,20 +0,0 @@
-import { t as DbException } from "./db-exception-CnWcYPxL.js";
-import { n as dbError } from "./errors-BV1SKTVs.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

@@ -1,27 +0,0 @@
-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-DZMLVuyQ.d.ts

@@ -1,17 +0,0 @@
-import { t as AuthSnapshot } from "./bind-Bfo40o63.js";
-import { t as AuthSession } from "./view-KQhe6eNc.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

@@ -1,27 +0,0 @@
-//#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 };

package/dist/timing-BMCWgpdZ.js

@@ -1,92 +0,0 @@
-import { defineMiddleware } from "@supabase/middleware";
-//#region src/server/entries/timing.ts
-/** The header `withDbStats` sets: `calls;waves;ms`, what `expectDbBudget` reads. */
-const DB_CALLS_HEADER = "x-bs-db-calls";
-/** `calls;waves;ms`, the value of the stats header. */
-function formatDbStats(stats) {
-	return `${stats.calls};${stats.waves};${stats.ms}`;
-}
-/** Parses the stats header back into numbers, or `undefined` when it is malformed. */
-function parseDbStats(value) {
-	if (!value) return;
-	const [calls, waves, ms] = value.split(";").map(Number);
-	if (calls === void 0 || waves === void 0 || ms === void 0 || [
-		calls,
-		waves,
-		ms
-	].some(Number.isNaN)) return;
-	return {
-		calls,
-		waves,
-		ms
-	};
-}
-function withHeaders(response, edit) {
-	const headers = new Headers(response.headers);
-	edit(headers);
-	return new Response(response.body, {
-		status: response.status,
-		statusText: response.statusText,
-		headers
-	});
-}
-const TOKEN = /[^!#$%&'*+\-.^_`|~0-9A-Za-z]/g;
-function metric(name, dur, description) {
-	const desc = description === void 0 ? "" : `;desc="${description.replaceAll(/["\\]/g, "")}"`;
-	return `${name.replaceAll(TOKEN, "_")};dur=${dur.toFixed(1)}${desc}`;
-}
-/**
-* Entry contributing `ctx.timing`, and adding `Server-Timing` to the
-* response: `bs;dur=<ms>` for everything after it, plus the metrics handlers
-* add with `ctx.timing.add()` or `measure()`. Put it first, so it times the
-* whole request. Browsers show it in the network panel.
-*/
-function withServerTiming(now = () => performance.now()) {
-	return defineMiddleware({
-		key: "timing",
-		run: () => async function* run() {
-			const started = now();
-			const metrics = [];
-			const response = yield { timing: {
-				add: (name, dur, description) => {
-					metrics.push(metric(name, dur, description));
-				},
-				async measure(name, fn) {
-					const start = now();
-					try {
-						return await fn();
-					} finally {
-						metrics.push(metric(name, now() - start));
-					}
-				}
-			} };
-			const total = metric("bs", now() - started);
-			return withHeaders(response, (headers) => {
-				headers.append("server-timing", [total, ...metrics].join(", "));
-			});
-		}
-	})();
-}
-/**
-* Entry adding the request's database totals to the response, after the
-* handler ran: `x-bs-db-calls: calls;waves;ms`, which `expectDbBudget(response)`
-* reads, and a `bs-db` `Server-Timing` metric. Put it
-* after `withBetterSupabase`, which contributes `ctx.bs`.
-*/
-function withDbStats(options = {}) {
-	const header = options.header ?? "x-bs-db-calls";
-	return defineMiddleware({
-		key: "dbStats",
-		run: () => async function* run(_request, ctx) {
-			const dbStats = () => ctx.bs.stats();
-			const response = yield { dbStats };
-			const stats = dbStats();
-			return withHeaders(response, (headers) => {
-				headers.set(header, formatDbStats(stats));
-				headers.append("server-timing", metric("bs-db", stats.ms, `${stats.calls} calls, ${stats.waves} waves`));
-			});
-		}
-	})();
-}
-//#endregion
-export { withServerTiming as i, parseDbStats as n, withDbStats as r, DB_CALLS_HEADER as t };

package/dist/topic-DAY_HOX2.d.ts

@@ -1,387 +0,0 @@
-import { D as ValidationIssue, b as DbError, t as AsyncResult } from "./result-BREt7qOh.js";
-import { B as TableKey, N as Row, a as AnyModels, i as AnyFunctions, r as AccessTopicPolicy } from "./types-BrpW5ixT.js";
-import { t as AuthorizationFunctions } from "./authorization-ClWBcXJi.js";
-import { t as RealtimeStatus } from "./realtime-status-DcsO00Gw.js";
-import { D as TemplateParams, O as TemplateValues } from "./bucket-BbePDVwc.js";
-import { t as BetterSupabase } from "./define-DYZnvAbs.js";
-import { g as SubscriberPolicy, h as SubscriberEvent, i as AuthorizationHooks, m as Subscriber } from "./authorization-hooks-WDQMKIsc.js";
-import { RealtimeChannel, SupabaseClient } from "@supabase/supabase-js";
-import { StandardSchemaV1 } from "@standard-schema/spec";
-//#region src/realtime/fan-out.d.ts
-interface TopicFanOutOptions<P extends string, E extends EventSchemas, K extends TopicEvent<E>, S extends Subscriber> {
-  readonly subscribers: readonly S[];
-  /** The topic values of one subscriber, e.g. `(s) => ({ userId: s.principal })`. */
-  readonly values: (subscriber: S) => TemplateValues<P>;
-  readonly event: K;
-  readonly payload: TopicPayload<E, K>;
-  /** What the subscriber policy reads about the event. */
-  readonly source: SubscriberEvent;
-  /**
-   * Defaults to the topic's `subscribers`, then
-   * `server.authorization.delivery.subscribers`. With `server.authorization`
-   * and none of them, an event with a `subject` goes to no one
-   * (`REALTIME_SUBSCRIBER_POLICY_REQUIRED`); pass `subjectReaders(transport)`.
-   */
-  readonly policy?: SubscriberPolicy;
-  readonly server?: {
-    readonly authorization?: AuthorizationHooks | undefined;
-  };
-}
-interface FanOutResult<S> {
-  readonly sent: readonly S[];
-  /** Left out by the subscriber policy. */
-  readonly skipped: readonly S[];
-  /** Sends that failed, with their error. */
-  readonly failed: readonly {
-    readonly subscriber: S;
-    readonly error: DbError;
-  }[];
-}
-//#endregion
-//#region src/realtime/topic.d.ts
-type EventSchemas = Readonly<Record<string, StandardSchemaV1>>;
-/** `true`, or a schema every tracked presence state is validated against. */
-type PresenceSchema = boolean | StandardSchemaV1;
-interface TopicOptions<E extends EventSchemas, R extends PresenceSchema = PresenceSchema> {
-  /** Name used for generated policies and functions. Defaults to the template's literal parts. */
-  readonly name?: string;
-  /** Payload schemas per event. Incoming and outgoing payloads are validated. */
-  readonly events?: E;
-  /** Private channels are authorized by `realtime.messages` policies. Defaults to `true`. */
-  readonly private?: boolean;
-  /**
-   * Tenant check for the generated policy. Defaults to `{organizationId}` against
-   * `tenant_id` / `app_metadata.tenant_id` when the template has `{organizationId}`.
-   */
-  readonly tenant?: false | {
-    readonly param?: string;
-    readonly claim?: string | readonly string[];
-    readonly sql?: string;
-  };
-  /** Owner check. Defaults to `{userId}` against `auth.uid()` when the template has `{userId}`. */
-  readonly owner?: false | {
-    readonly param?: string;
-  };
-  /**
-   * Authorize with the SQL modules' access contract instead of the tenant
-   * claim: `tenant_ids_with(receive)` on the tenant segment (or
-   * `is_platform` for `scope: 'platform'`), or the `sql` templates it is
-   * given, and `send` for broadcasting.
-   *
-   * The checks decide by role and scope only: for a permission with row
-   * conditions (e.g. `authorId = principal.id`) every member of the scope
-   * could join. `better-supabase doctor` (BS214) refuses keys the
-   * authorization provider doesn't mark `sqlComplete: true`.
-   */
-  readonly access?: AccessTopicPolicy;
-  /**
-   * A permission on the instance the topic is about, such as
-   * `'posts.read'` on `org:{organizationId}:posts:{postId}`: every receiver
-   * and sender must hold it on that instance. With an authorization
-   * provider, `sql({ functions })` checks it with the provider's `permitted`
-   * template; without one, with the access contract's tenant check.
-   */
-  readonly permission?: string | TopicPermission;
-  /**
-   * Narrows `fanOut` to the subscribers that may read the event. Defaults
-   * to `server.authorization.delivery.subscribers` when `fanOut` gets the
-   * server.
-   */
-  readonly subscribers?: SubscriberPolicy;
-  /** Let clients broadcast on the topic, not only receive. Defaults to `false`. */
-  readonly send?: boolean;
-  /**
-   * Presence: authorizes it in the policies and adds `track` and
-   * `onPresence` to subscriptions. Pass a schema to validate the states
-   * this client tracks and the ones it receives. Defaults to `false`.
-   */
-  readonly presence?: R;
-}
-/** A topic's instance permission. */
-interface TopicPermission {
-  readonly key: string;
-  /** The placeholder holding the instance id, as a whole segment. Defaults to the last one. */
-  readonly param?: string;
-  /** `{resource}` in the `permitted` template. Defaults to the key up to its first `.`. */
-  readonly resource?: string;
-  /** `{scope}` in the `permitted` template. Defaults to `tenant`. */
-  readonly scope?: string;
-}
-interface TopicMessage {
-  readonly event: string;
-  readonly payload: unknown;
-  readonly topic: string;
-}
-type Output<S> = S extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<S> : unknown;
-type Input<S> = S extends StandardSchemaV1 ? StandardSchemaV1.InferInput<S> : unknown;
-type TopicHandlers<E extends EventSchemas> = [keyof E] extends [never] ? {
-  readonly [event: string]: ((payload: unknown, message: TopicMessage) => void) | undefined;
-} : { readonly [K in keyof E & string]?: (payload: Output<E[K]>, message: TopicMessage) => void; } & {
-  readonly "*"?: (payload: unknown, message: TopicMessage) => void;
-};
-type TopicEvent<E extends EventSchemas> = [keyof E] extends [never] ? string : keyof E & string;
-type TopicPayload<E extends EventSchemas, K extends string> = [keyof E] extends [never] ? unknown : Input<E[K]>;
-type SubscriptionStatus = "joining" | "subscribed" | "closed" | "error";
-interface SubscribeOptions {
-  /** Receive your own broadcasts. */
-  readonly self?: boolean;
-  readonly onStatus?: (status: SubscriptionStatus, error?: Error) => void;
-  /** Called when a payload fails its event schema. The handler is skipped. */
-  readonly onInvalid?: (message: TopicMessage, issues: readonly ValidationIssue[]) => void;
-}
-interface Subscription extends Disposable, AsyncDisposable {
-  readonly topic: string;
-  readonly channel: RealtimeChannel;
-  /** Resolves once joined; rejects if the join is refused or times out. */
-  readonly ready: Promise<void>;
-  unsubscribe(): Promise<void>;
-}
-/** One tracked state on a presence topic. */
-interface PresenceMember<S> {
-  /** The connection's presence key; a client tracking twice keeps one key. */
-  readonly key: string;
-  readonly state: S;
-}
-interface PresenceOptions<S> {
-  /**
-   * Called with everyone on the topic, this client included, after each
-   * presence sync. States that fail the presence schema are left out and
-   * passed to `onInvalid` as a `presence` message.
-   */
-  readonly onPresence?: (members: readonly PresenceMember<S>[]) => void;
-}
-interface PresenceSubscription<I, O> extends Subscription {
-  /**
-   * Validates the state, waits for the join and shares it with the topic.
-   * One state per client and topic: the last `track` wins, and leaving the
-   * topic removes it.
-   */
-  track(state: I): AsyncResult<void>;
-  /** Removes this client's state from the topic. */
-  untrack(): AsyncResult<void>;
-  /** Everyone from the last sync, as `onPresence` received them. */
-  members(): readonly PresenceMember<O>[];
-}
-type PresenceState = Readonly<Record<string, unknown>>;
-type PresenceInput<R> = R extends StandardSchemaV1 ? StandardSchemaV1.InferInput<R> : PresenceState;
-type PresenceOutput<R> = R extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<R> : PresenceState;
-/** What `subscribe` returns: with `track` and `members` on presence topics. */
-type TopicSubscription<R> = [R] extends [false] ? Subscription : PresenceSubscription<PresenceInput<R>, PresenceOutput<R>>;
-/** `subscribe` options: with `onPresence` on presence topics. */
-type TopicSubscribeOptions<R> = [R] extends [false] ? SubscribeOptions : SubscribeOptions & PresenceOptions<PresenceOutput<R>>;
-type RealtimeClient = Pick<SupabaseClient, "channel" | "getChannels" | "removeChannel" | "realtime">;
-/**
- * A value read from another table: the `select` column of the `from` row
- * whose `key` (its primary key by default) equals `via`, a column of the
- * changed row or another lookup.
- */
-interface TriggerLookup<M extends AnyModels> {
-  readonly from: TableKey<M>;
-  readonly via: string | TriggerLookup<M>;
-  readonly select: string;
-  readonly key?: string;
-}
-/** A trigger value: a column of the changed row, or a lookup through it. */
-type TriggerValue<M extends AnyModels, T extends keyof M> = Extract<keyof Row<M, T>, string> | TriggerLookup<M>;
-type TriggerOperation = "insert" | "update" | "delete";
-/**
- * What a broadcast trigger sends. `"keys"` (the default) sends
- * `{ operation, schema, table, id, values }`: the primary key and the
- * topic's placeholder values, so clients refetch the row through RLS.
- * `"row"` sends the whole row as `record` and `old_record`, which bypasses
- * column grants: every receiver of the topic sees every column.
- */
-type TriggerPayloadMode = "keys" | "row";
-/** A topic the same row change also goes to (`topics` on `trigger()`). */
-interface TriggerTopic<V> {
-  readonly topic: {
-    readonly template: string;
-    readonly params: readonly string[];
-    readonly private: boolean;
-  };
-  /** What fills each of its placeholders, as in `values`. */
-  readonly values?: Readonly<Record<string, V>>;
-}
-interface TriggerCommonOptions {
-  /** Defaults to all three. */
-  readonly events?: readonly TriggerOperation[];
-  /**
-   * The broadcast event name, or one per operation. Defaults to the
-   * operation (`INSERT`, `UPDATE`, `DELETE`).
-   */
-  readonly event?: string | { readonly [O in TriggerOperation]?: string; };
-  /**
-   * Schema for a generated function. Defaults to `better_supabase`, which
-   * the Data API does not expose.
-   */
-  readonly functionSchema?: string;
-}
-/** `topic.trigger()` with the app's `betterSupabase`: typed columns and lookups. */
-interface TriggerOptions<M extends AnyModels, T extends keyof M, P extends string> extends TriggerCommonOptions {
-  /**
-   * What fills each placeholder: a column of the changed row, or a lookup
-   * (`{ from, via, select }`) for a value on a parent row. A row whose
-   * topic comes out null is not sent to that topic.
-   */
-  readonly values: { readonly [K in TemplateParams<P>]: TriggerValue<M, T>; };
-  /**
-   * `"keys"` (default), `"row"` (bypasses column grants), or the payload
-   * itself: each key is a column, a lookup, or `{ sql }`, an expression on
-   * the row `{row}` (`tg_op` is the operation).
-   */
-  readonly payload?: TriggerPayloadMode | Readonly<Record<string, TriggerValue<M, T> | {
-    readonly sql: string;
-  }>>;
-  /** More topics the row change goes to, each with its own values. */
-  readonly topics?: readonly TriggerTopic<TriggerValue<M, T>>[];
-  /**
-   * Send an UPDATE only when one of these columns changed. Inserts and
-   * deletes always send.
-   */
-  readonly when?: {
-    readonly changed: readonly Extract<keyof Row<M, T>, string>[];
-  };
-}
-interface TopicTriggerLookup {
-  readonly from: string;
-  readonly via: string | TopicTriggerLookup;
-  readonly select: string;
-  readonly key?: string;
-}
-type TopicTriggerValue = string | TopicTriggerLookup;
-/** `topic.trigger()` without `betterSupabase`: database names. */
-interface TopicTriggerOptions<P extends string> extends TriggerCommonOptions {
-  /**
-   * The column or lookup that fills each placeholder. Defaults to the
-   * placeholder in snake_case (`{organizationId}` reads `organization_id`).
-   */
-  readonly values?: { readonly [K in TemplateParams<P>]?: TopicTriggerValue; };
-  /**
-   * `"keys"` (default), `"row"` (bypasses column grants), or the payload
-   * itself: each key is a column, a lookup, or `{ sql }`, an expression on
-   * the row `{row}` (`tg_op` is the operation).
-   */
-  readonly payload?: TriggerPayloadMode | Readonly<Record<string, TopicTriggerValue | {
-    readonly sql: string;
-  }>>;
-  /** More topics the row change goes to, each with its own values. */
-  readonly topics?: readonly TriggerTopic<TopicTriggerValue>[];
-  /**
-   * Send an UPDATE only when one of these columns (database names)
-   * changed. Inserts and deletes always send.
-   */
-  readonly when?: {
-    readonly changed: readonly string[];
-  };
-}
-/** A row change sent with `payload: "row"`. */
-interface RowChange<R> {
-  readonly operation: "INSERT" | "UPDATE" | "DELETE";
-  readonly table: string;
-  readonly record: R | null;
-  readonly oldRecord: Partial<R> | null;
-}
-/** A row change sent with the default `payload: "keys"`: refetch the row through RLS. */
-interface RowKeys {
-  readonly operation: "INSERT" | "UPDATE" | "DELETE";
-  readonly schema: string;
-  readonly table: string;
-  /** The primary key value, or an object keyed by column for a composite key. */
-  readonly id: unknown;
-  /** The topic's placeholder values. */
-  readonly values: Readonly<Record<string, string>>;
-}
-/** Options for `topic.sql()`. */
-interface TopicSqlOptions {
-  /**
-   * The provider's templates, for an access policy with `sql: "provider"`
-   * and for `permission` (its `permitted` template).
-   */
-  readonly functions?: AuthorizationFunctions;
-}
-interface Topic<P extends string, E extends EventSchemas, R extends PresenceSchema = false> {
-  readonly template: P;
-  readonly name: string;
-  readonly params: readonly TemplateParams<P>[];
-  readonly private: boolean;
-  /** Whether subscriptions get `track` and `onPresence`. */
-  readonly presence: boolean;
-  /** The schema tracked presence states are validated against, if any. */
-  readonly presenceSchema: StandardSchemaV1 | undefined;
-  /** Payload schemas per event, as given to `defineTopic`. */
-  readonly events: E;
-  /** Whether clients may broadcast on the topic (the `send` option). */
-  readonly clientSend: boolean;
-  /** The instance permission's key, when the topic has one. */
-  readonly permission: string | undefined;
-  /**
-   * Supabase's status for what the topic relies on: `beta` for a private
-   * topic (Realtime Authorization is in public beta), `ga` otherwise.
-   */
-  readonly status: RealtimeStatus;
-  topic(values: TemplateValues<P>): string;
-  match(topic: string): TemplateValues<P> | null;
-  /**
-   * `realtime.messages` policies for this topic. Idempotent. An access
-   * policy with `sql: "provider"` needs the provider's templates in
-   * `options.functions`; `better-supabase sql sync` passes them.
-   */
-  sql(options?: TopicSqlOptions): string;
-  /**
-   * A trigger that broadcasts row changes on `table` to this topic, and to
-   * each of `topics`. A topic whose values come out null is skipped, and
-   * a value topics don't allow skips that topic with a warning instead of
-   * failing the write.
-   *
-   * With `betterSupabase`, `table`, columns and lookup tables are app keys.
-   * Without it they are database names, and a single topic whose values
-   * are columns, with a mode payload and one event name, calls
-   * `better_supabase.broadcast_topic()` from the `realtime-tables` module.
-   * Every other trigger creates a function for the topic.
-   *
-   * The payload carries keys only unless `payload` says otherwise:
-   * `payload: "row"` sends whole rows and bypasses column grants.
-   */
-  trigger<M extends AnyModels, D, F extends AnyFunctions, X, T extends TableKey<M>>(table: T, options: TriggerOptions<M, T, P> & {
-    readonly betterSupabase: BetterSupabase<M, D, F, X>;
-  }): string;
-  trigger(table: string, options?: TopicTriggerOptions<P>): string;
-  /**
-   * @deprecated Use `trigger(table, { ...options, betterSupabase })`. The
-   * payload default is keys only; pass `payload: "row"` for whole rows.
-   */
-  triggerSql<M extends AnyModels, D, F extends AnyFunctions, X, T extends TableKey<M>>(betterSupabase: BetterSupabase<M, D, F, X>, table: T, options: TriggerOptions<M, T, P>): string;
-  subscribe(client: RealtimeClient, values: TemplateValues<P>, handlers: TopicHandlers<E>, options?: TopicSubscribeOptions<R>): TopicSubscription<R>;
-  /** Sends over HTTP, without joining the channel. */
-  send<K extends TopicEvent<E>>(client: RealtimeClient, values: TemplateValues<P>, event: K, payload: TopicPayload<E, K>): AsyncResult<void>;
-  /**
-   * Sends one event to each subscriber's own topic (such as
-   * `notifications:{userId}`) after the subscriber policy narrows them.
-   * A policy that throws sends to no one and returns a `forbidden` error.
-   */
-  fanOut<S extends Subscriber, K extends TopicEvent<E>>(client: RealtimeClient, options: TopicFanOutOptions<P, E, K, S>): AsyncResult<FanOutResult<S>>;
-}
-/**
- * A typed Realtime broadcast topic: names from a template, RLS policies for
- * private channels, row-change triggers, and disposable subscriptions.
- *
- * ```ts
- * export const notifications = defineTopic('organization:{organizationId}:notifications:{userId}', {
- *   events: { created: v.object({ id: v.string(), title: v.string() }) },
- * });
- * using sub = notifications.subscribe(supabase, { organizationId, userId }, { created: (n) => toast(n.title) });
- * ```
- */
-declare function defineTopic<const P extends string, const E extends EventSchemas = Record<never, never>, const R extends PresenceSchema = false>(template: P, options?: TopicOptions<E, R>): Topic<P, E, R>;
-/**
- * Reads a broadcast trigger's default message (`payload: "keys"`). Returns
- * `null` for messages about other tables or with another shape.
- */
-declare function rowKeys<M extends AnyModels, D, F extends AnyFunctions, X, T extends TableKey<M>>(betterSupabase: BetterSupabase<M, D, F, X>, table: T, message: TopicMessage): RowKeys | null;
-/**
- * Reads a `payload: "row"` message as an app-cased row change. Returns
- * `null` for messages about other tables.
- */
-declare function rowChange<M extends AnyModels, D, F extends AnyFunctions, X, T extends TableKey<M>>(betterSupabase: BetterSupabase<M, D, F, X>, table: T, message: TopicMessage): RowChange<Row<M, T>> | null;
-//#endregion
-export { TriggerTopic as A, TopicSubscription as C, TriggerLookup as D, TopicTriggerValue as E, FanOutResult as F, TopicFanOutOptions as I, defineTopic as M, rowChange as N, TriggerOptions as O, rowKeys as P, TopicSubscribeOptions as S, TopicTriggerOptions as T, TopicMessage as _, PresenceOutput as a, TopicPermission as b, RealtimeClient as c, SubscribeOptions as d, Subscription as f, TopicHandlers as g, TopicEvent as h, PresenceOptions as i, TriggerValue as j, TriggerPayloadMode as k, RowChange as l, Topic as m, PresenceInput as n, PresenceSchema as o, SubscriptionStatus as p, PresenceMember as r, PresenceSubscription as s, EventSchemas as t, RowKeys as u, TopicOptions as v, TopicTriggerLookup as w, TopicSqlOptions as x, TopicPayload as y };