better-supabase 0.5.0 → 0.6.0

package/dist/{live-D9W2M5aO.d.ts → index-DunNRdnT.d.ts}

@@ -1,13 +1,15 @@
-import { P as TableKey, S as PermdockTopicPolicy, j as SchemaMeta, k as Row, n as AnyFunctions, r as AnyModels } from "./types-Dnf_wRDz.js";
-import { _ as DbError, a as AsyncResult, u as Result, w as ValidationIssue } from "./executor-BunPOO-k.js";
-import { Z as QuerySpec, t as BetterSupabase } from "./define-Bp_BZa5h.js";
-import { n as PermdockCatalog } from "./permdock-sql-C2Inc6Xc.js";
-import { n as TemplateValues, t as TemplateParams } from "./template-mbvlysOo.js";
+import { E as ValidationIssue, b as DbError, f as Result, t as AsyncResult } from "./result-D7y2fT87.js";
+import { L as TableKey, M as Row, P as SchemaMeta, a as AnyModels, i as AnyFunctions, r as AccessTopicPolicy } from "./types-6BdhkmZe.js";
+import { it as QuerySpec, t as BetterSupabase } from "./define-CJJkkr1-.js";
+import { n as TemplateValues, t as TemplateParams } from "./template-CwO38Do8.js";
+import { t as AuthorizationFunctions } from "./authorization-BFCqamMs.js";
 import { RealtimeChannel, SupabaseClient } from "@supabase/supabase-js";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/realtime/topic.d.ts
 type EventSchemas = Readonly<Record<string, StandardSchemaV1>>;
-interface TopicOptions<E extends EventSchemas> {
+/** `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. */
@@ -15,8 +17,8 @@ interface TopicOptions<E extends EventSchemas> {
   /** Private channels are authorized by `realtime.messages` policies. Defaults to `true`. */
   readonly private?: boolean;
   /**
-   * Tenant check for the generated policy. Defaults to `{orgId}` against
-   * `tenant_id` / `app_metadata.tenant_id` when the template has `{orgId}`.
+   * 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;
@@ -28,27 +30,25 @@ interface TopicOptions<E extends EventSchemas> {
     readonly param?: string;
   };
   /**
-   * Authorize with PermDock's SQL helpers instead of the tenant claim:
-   * `permitted_<scope>_ids(receive)` on the scope segment (or
-   * `permdock_has` for `scope: 'global'`), and `send` for broadcasting.
+   * 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 helpers check role and scope only. Use this just for permissions
-   * whose grants have no row conditions beyond the scope: for a permission
-   * with row conditions (e.g. `authorId = principal.id`) every member of the
-   * scope could join. Pass `catalog` to refuse those keys here;
-   * `better-supabase doctor` (BS214) refuses them from the catalog file.
+   * 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 permdock?: PermdockTopicPolicy;
-  /**
-   * PermDock's `permissions.catalog.json`. With it, a `permdock` policy
-   * naming a permission without `rowConditions: false` (including one the
-   * catalog doesn't list) throws.
-   */
-  readonly catalog?: PermdockCatalog;
+  readonly access?: AccessTopicPolicy;
   /** Let clients broadcast on the topic, not only receive. Defaults to `false`. */
   readonly send?: boolean;
-  /** Also authorize presence. Defaults to `false`. */
-  readonly presence?: 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;
 }
 interface TopicMessage {
   readonly event: string;
@@ -79,12 +79,76 @@ interface Subscription extends Disposable, AsyncDisposable {
   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";
 interface TriggerOptions<M extends AnyModels, T extends keyof M, P extends string> {
-  /** Column that fills each placeholder. */
-  readonly values: { readonly [K in TemplateParams<P>]: Extract<keyof Row<M, T>, string>; };
+  /**
+   * 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.
+   */
+  readonly values: { readonly [K in TemplateParams<P>]: TriggerValue<M, T>; };
   /** Defaults to all three. */
-  readonly events?: readonly ("insert" | "update" | "delete")[];
+  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; };
+  /**
+   * Send this payload with `realtime.send` instead of the row change from
+   * `realtime.broadcast_changes`: each key is a column, a lookup, or
+   * `{ sql }`, an expression on the row `{row}` (`tg_op` is the operation).
+   */
+  readonly payload?: Readonly<Record<string, TriggerValue<M, T> | {
+    readonly sql: string;
+  }>>;
   /**
    * Schema for the generated function. Defaults to `better_supabase`, which
    * the Data API does not expose.
@@ -97,18 +161,29 @@ interface RowChange<R> {
   readonly record: R | null;
   readonly oldRecord: Partial<R> | null;
 }
-interface Topic<P extends string, E extends EventSchemas> {
+/** Options for `topic.sql()`. */
+interface TopicSqlOptions {
+  /** The provider's templates, for an access policy with `sql: "provider"`. */
+  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;
   topic(values: TemplateValues<P>): string;
   match(topic: string): TemplateValues<P> | null;
-  /** `realtime.messages` policies for this topic. Idempotent. */
-  sql(): string;
+  /**
+   * `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 (`realtime.broadcast_changes`) to this topic. */
   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?: SubscribeOptions): Subscription;
+  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>;
 }
@@ -117,13 +192,13 @@ interface Topic<P extends string, E extends EventSchemas> {
  * private channels, row-change triggers, and disposable subscriptions.
  *
  * ```ts
- * export const notifications = defineTopic('org:{orgId}:notifications:{userId}', {
+ * export const notifications = defineTopic('organization:{organizationId}:notifications:{userId}', {
  *   events: { created: v.object({ id: v.string(), title: v.string() }) },
  * });
- * using sub = notifications.subscribe(supabase, { orgId, userId }, { created: (n) => toast(n.title) });
+ * 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>>(template: P, options?: TopicOptions<E>): Topic<P, E>;
+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 `realtime.broadcast_changes` message as an app-cased row change.
  * Returns `null` for messages about other tables.
@@ -141,9 +216,20 @@ interface LiveQueryOptions {
   readonly onChange: (tables: readonly string[]) => void;
   /** Tenant value for tables scoped by a tenant column (`realtime-tables` topics). */
   readonly tenant?: string;
+  /** The signed-in user's id, for tables that broadcast per user (`realtime.users`). */
+  readonly user?: string;
   /** Waits this long after the last change before calling `onChange`. Defaults to 100 ms. */
   readonly debounceMs?: number;
+  /**
+   * Also reports a channel that errors after it joined (`error`) and its
+   * rejoin (`subscribed`), not only the first join.
+   */
   readonly onStatus?: (status: SubscriptionStatus, error?: Error) => void;
+  /**
+   * Retries a first join that failed, after 1 s and then twice as long each
+   * time, up to 30 s. Pass `false` to stay in `error`. Defaults to `true`.
+   */
+  readonly retry?: boolean;
 }
 interface LiveSubscription extends Disposable, AsyncDisposable {
   /** App keys of the watched tables. */
@@ -161,9 +247,15 @@ interface LiveSubscription extends Disposable, AsyncDisposable {
 interface LiveCountSeed<T extends string = string> {
   readonly spec: QuerySpec<T, "count", number>;
   readonly count: number | null;
+  /** When the count was taken (epoch ms). `useLiveCount` counts again after joining when it is older than a second. */
+  readonly at?: number;
 }
-/** Topic a `realtime-tables` trigger broadcasts on: `bs:t:<schema>.<table>[:<tenant>]`. */
-declare function liveTopic(meta: SchemaMeta, table: string, tenant?: string): string;
+/**
+ * Topic a `realtime-tables` trigger broadcasts on:
+ * `bs:t:<schema>.<table>[:<tenant>]`, or `bs:t:<schema>.<table>:u:<user>`
+ * for a `realtime.users` table.
+ */
+declare function liveTopic(meta: SchemaMeta, table: string, tenant?: string, user?: string): string;
 /**
  * Calls `onChange` when a table the spec reads changes, so you can refetch.
  * Needs the `realtime-tables` SQL module and the tables in
@@ -185,6 +277,12 @@ interface LiveCountOptions extends Omit<LiveQueryOptions, "onChange"> {
   readonly onError?: (error: DbError) => void;
   /** Count right away. Defaults to `true`; pass `false` when you have a seed. */
   readonly immediate?: boolean;
+  /**
+   * When the count you already have was taken (epoch ms). Counts again once
+   * the channel joins when that is more than a second ago, so a change made
+   * before the join is not lost.
+   */
+  readonly since?: number;
 }
 /**
  * Keeps a count current: runs the `count` spec (a HEAD request) now, after
@@ -199,4 +297,4 @@ interface LiveCountOptions extends Omit<LiveQueryOptions, "onChange"> {
  */
 declare function liveCount(betterSupabase: LiveSource, client: RealtimeClient, db: CountRunner, spec: QuerySpec<string, "count", number>, options: LiveCountOptions): LiveSubscription;
 //#endregion
-export { defineTopic as C, TriggerOptions as S, TopicEvent as _, LiveSource as a, TopicOptions as b, liveQuery as c, RealtimeClient as d, RowChange as f, Topic as g, SubscriptionStatus as h, LiveQueryOptions as i, liveTopic as l, Subscription as m, LiveCountOptions as n, LiveSubscription as o, SubscribeOptions as p, LiveCountSeed as r, liveCount as s, CountRunner as t, EventSchemas as u, TopicHandlers as v, rowChange as w, TopicPayload as x, TopicMessage as y };
+export { TopicSubscription as A, TopicEvent as C, TopicPayload as D, TopicOptions as E, rowChange as F, TriggerOptions as M, TriggerValue as N, TopicSqlOptions as O, defineTopic as P, Topic as S, TopicMessage as T, RealtimeClient as _, LiveSource as a, Subscription as b, liveQuery as c, PresenceInput as d, PresenceMember as f, PresenceSubscription as g, PresenceSchema as h, LiveQueryOptions as i, TriggerLookup as j, TopicSubscribeOptions as k, liveTopic as l, PresenceOutput as m, LiveCountOptions as n, LiveSubscription as o, PresenceOptions as p, LiveCountSeed as r, liveCount as s, CountRunner as t, EventSchemas as u, RowChange as v, TopicHandlers as w, SubscriptionStatus as x, SubscribeOptions as y };

package/dist/index.d.ts

@@ -1,14 +1,39 @@
-import { A as Schema, C as PrimaryKeyColumn, D as RelationTypes, E as RelationMeta, F as TableMeta, I as UniqueConstraint, L as UniqueKeyName, M as Simplify, N as TableFlags, O as Relations, P as TableKey, R as UniqueWhere, S as PermdockTopicPolicy, T as RealtimeTableMeta, _ as Insert, a as BucketPolicyName, b as ModelsOf, c as ClaimsMeta, d as DatabaseOf, f as Flags, g as FunctionsOf, h as FunctionTypes, i as BucketMeta, j as SchemaMeta, k as Row, l as Codec, m as FunctionMeta, n as AnyFunctions, o as Casing, p as ForeignKeyConstraint, r as AnyModels, s as CheckConstraint, t as AccessBucketPolicy, u as ColumnMeta, v as ModelFlags, w as PrimaryKeyValue, x as PermdockBucketPolicy, y as ModelTypes, z as Update } from "./types-Dnf_wRDz.js";
-import { $ as or, A as mapDbError, B as InsertOp, C as RawDbError, D as isConflict, E as isCheck, F as Condition, G as Quantifier, H as MutationOp, I as CountMode, J as Selection, K as SelectColumn, L as DeleteOp, M as AggregateFn, N as Aggregation, O as isDbError, P as ColumnOp, Q as not, R as FunctionSource, S as ErrorMapper, T as dbError, U as Operation, V as Measure, W as OrderTerm, X as and, Y as UpdateOp, Z as column, _ as DbError, a as AsyncResult, b as DbErrorOf, c as Err, f as err, g as toDbError, h as toBetterResult, i as RpcContext, j as statusOf, k as isForeignKey, l as Ok, m as ok, n as ExecuteResult, o as BetterResultApi, p as fromBetterResult, q as SelectOp, r as Executor, s as BetterResultValue, t as ExecuteContext, u as Result, v as DbErrorKind, w as ValidationIssue, x as DbException, y as DbErrorKinds, z as Include } from "./executor-BunPOO-k.js";
-import { D as consoleLogger, E as Logger, O as silentLogger, T as LogFields, _ as KitEventType, a as EventHub, c as QueryEvent, i as EventHandler, l as RefreshEvent, m as KitEventMap, n as BetterSupabaseEvents, o as EventName, p as KitEvent, r as ErrorEvent, s as MutationNotice, t as AuthEvent, u as RpcNotice } from "./events-aIO7vsIk.js";
-import { $ as Specs, A as RpcOptions, B as ReadSet, C as FindExt, Ct as WhereInput, D as Repository, E as PageOf, F as EMPTY_STATS, G as ReadSetParams, H as ReadSetParamType, I as StatsRecorder, J as isReadSet, K as ReadSetResult, L as recordStats, M as UpsertArgs, N as WriteArgs, O as RepositoryOf, P as DbStats, Q as ReadMethod, R as SearchArgs, S as DeleteExt, St as SortDirection, T as OffsetPageArgs, U as ReadSetParamTypes, V as ReadSetOptions, W as ReadSetParamValue, X as InferResult, Y as readSetTables, Z as QuerySpec, _ as CursorPage, _t as OrderByInput, a as defineSupabase, at as AggregateRow, b as DbHelpers, bt as RelationMeasureArg, c as postgrestExecutor, ct as FieldFilter, d as MemoryCache, dt as IncludeArg, et as TableSpecs, f as cacheTargetOf, ft as IncludeArgs, g as ConflictTarget, gt as OrderByArg, h as rpcCacheTargets, ht as NumericMeasureArg, i as SupabaseOptions, it as AggregateResult, j as UpdateArgs, k as Returned, l as CacheAdapter, lt as FindFirstArgs, m as rowKey, mt as MeasureKey, n as ConnectOptions, nt as specTables, o as PostgrestClientLike, ot as CountArg, p as memoryCache, pt as MeasureArg, q as defineReadSet, r as RpcDefinition, rt as AggregateArgs, s as explainPostgrest, st as CountArgs, t as BetterSupabase, tt as isQuerySpec, u as CacheTarget, ut as FindManyArgs, v as CursorPageArgs, vt as Payload, w as OffsetPage, x as DeleteArgs, xt as SelectArg, y as Db, yt as ReadArgs, z as InferReadSetParams } from "./define-Bp_BZa5h.js";
-import { _ as WithExtension, a as ExtensionOf, c as MutationEvent, d as NoExtension, f as PLUGIN_API_VERSION, g as RequestContext, h as RepositoryExtension, i as CallOptions, l as MutationIntent, m as RepositoryApi, n as AnyPlugin, o as HasFlag, p as Plugin, r as ApplyExtension, s as HookArgs, t as Actor, u as MutationKind, v as definePlugin } from "./plugin-o144f322.js";
-import { n as validate, t as StandardSchemaV1 } from "./standard-J4YgMOLm.js";
-import { a as compilePostgrest, i as PostgrestPlan, n as PlanLimit, r as PlanOrder, t as PlanFilter } from "./postgrest-CruYKAvV.js";
+/// <reference lib="esnext.temporal" />
+import { n as DbException, t as escapeLike } from "./escape-like-ImTK0ps_.js";
+import { A as isDbError, C as DbErrorOf, D as dbError, E as ValidationIssue, M as mapDbError, N as statusOf, O as isCheck, S as DbErrorKinds, T as RawDbError, _ as ok, a as BetterResultOk, b as DbError, c as DbErrorClasses, d as Ok, f as Result, g as fromBetterResult, h as err, i as BetterResultErrors, j as isForeignKey, k as isConflict, l as Err, m as defineBetterResultErrors, n as BetterResultApi, o as BetterResultValue, r as BetterResultErr, s as DbErrorClass, t as AsyncResult, u as MappedDbError, v as toBetterResult, w as ErrorMapper, x as DbErrorKind, y as toDbError } from "./result-D7y2fT87.js";
+import { A as Relations, B as UniqueKeyName, C as ModelTypes, D as RealtimeTableMeta, E as PrimaryKeyValue, F as Simplify, H as Update, I as TableFlags, L as TableKey, M as Row, N as Schema, O as RelationMeta, P as SchemaMeta, R as TableMeta, S as ModelFlags, T as PrimaryKeyColumn, V as UniqueWhere, _ as FunctionResult, a as AnyModels, b as FunctionsOf, c as Casing, d as Codec, f as ColumnMeta, g as FunctionMeta, h as ForeignKeyConstraint, i as AnyFunctions, j as ResultColumn, k as RelationTypes, l as CheckConstraint, m as Flags, n as AccessPolicySql, o as BucketMeta, p as DatabaseOf, r as AccessTopicPolicy, s as BucketPolicyName, t as AccessBucketPolicy, u as ClaimsMeta, v as FunctionSignature, w as ModelsOf, x as Insert, y as FunctionTypes, z as UniqueConstraint } from "./types-6BdhkmZe.js";
+import { C as Selection, D as not, E as column, O as or, S as SelectOp, T as and, _ as MutationOp, a as AggregateFn, b as Quantifier, c as Condition, d as FunctionSource, f as Include, g as MutationKind, h as MutationIntent, i as RpcContext, l as CountMode, m as Measure, n as ExecuteResult, o as Aggregation, p as InsertOp, r as Executor, s as ColumnOp, t as ExecuteContext, u as DeleteOp, v as Operation, w as UpdateOp, x as SelectColumn, y as OrderTerm } from "./executor-DvsBbNBS.js";
+import { a as ExtensionOf, c as MutationEvent, d as Plugin, f as RepositoryApi, g as definePlugin, h as WithExtension, i as CallOptions, l as NoExtension, m as RequestContext, n as AnyPlugin, o as HasFlag, p as RepositoryExtension, r as ApplyExtension, s as HookArgs, t as Actor, u as PLUGIN_API_VERSION } from "./plugin-FGY8UhYm.js";
+import { C as BlockEventMap, E as BlockEventType, S as BlockEvent, a as EventHub, c as QueryEvent, i as EventHandler, l as RefreshEvent, n as BetterSupabaseEvents, o as EventName, r as ErrorEvent, s as MutationNotice, t as AuthEvent, u as RpcNotice } from "./events-DWDhx77e.js";
+import { i as silentLogger, n as Logger, r as consoleLogger, t as LogFields } from "./logger-DWVYUmwi.js";
+import { n as validate, t as StandardSchemaV1 } from "./standard-CYsm7xpT.js";
+import { a as ProblemFormat, c as fromProblem, d as toProblem, i as ProblemDetails, l as isProblem, n as PROBLEM_CONTENT_TYPE, o as ProblemOptions, r as PROBLEM_TYPE_BASE, s as ProblemResponseOptions, t as BlockProblemOptions, u as problemResponse } from "./problem-DD8LZFjc.js";
+import { $ as ReadSetResult, A as PageOf, At as OrderByArg, B as DbStats, C as DeleteExt, Ct as IncludeArg, D as OffsetPage, Dt as MeasureKey, E as ManyReturningArgs, Et as MeasureArg, F as UpdateArgs, Ft as RequestArgs, G as InferReadSetParams, H as StatsRecorder, I as UpsertArgs, It as SelectArg, J as ReadSetOptions, K as ReadSet, L as UpsertManyArgs, Lt as SortDirection, M as RepositoryOf, Mt as Payload, N as Returned, Nt as ReadArgs, O as OffsetPageArgs, Ot as MutableWhere, P as RpcOptions, Pt as RelationMeasureArg, Q as ReadSetParams, R as WriteArgs, Rt as SortSpec, S as DeleteArgs, St as FindOnlyArgs, T as ManyResult, Tt as JsonPathOps, U as recordStats, V as EMPTY_STATS, W as SearchArgs, X as ReadSetParamTypes, Y as ReadSetParamType, Z as ReadSetParamValue, _ as ConflictTarget, _t as CountArg, a as defineSupabase, at as ReadMethod, b as Db, bt as FindFirstArgs, c as explainPostgrest, ct as isQuerySpec, d as CacheTarget, dt as AggregateOrderBy, et as defineReadSet, f as MemoryCache, ft as AggregateOrderByArg, g as rpcCacheTargets, gt as ColumnOrderByArg, h as rowKey, ht as ColumnOrderBy, i as SupabaseOptions, it as QuerySpec, j as Repository, jt as OrderByInput, k as OffsetRangeArgs, kt as NumericMeasureArg, l as postgrestExecutor, lt as specTables, m as memoryCache, mt as AggregateRow, n as ConnectOptions, nt as readSetTables, o as PostgrestClientLike, ot as Specs, p as cacheTargetOf, pt as AggregateResult, q as ReadSetAuth, r as RpcDefinition, rt as InferResult, s as PostgrestExecutorOptions, st as TableSpecs, t as BetterSupabase, tt as isReadSet, u as CacheAdapter, ut as AggregateArgs, v as CursorPage, vt as CountArgs, w as FindExt, wt as IncludeArgs, x as DbHelpers, xt as FindManyArgs, y as CursorPageArgs, yt as FieldFilter, z as WriteManyArgs, zt as WhereInput } from "./define-CJJkkr1-.js";
+import { a as PostgrestPlan, n as PlanLimit, o as compilePostgrest, r as PlanOrder, t as PlanFilter } from "./postgrest-BLVdEnfe.js";
 import { n as StoragePath } from "./path-Cv__-OTj.js";
-import { n as postgrestCompiler, t as Compiler } from "./compiler-BXH_aZ7N.js";
-import { a as ProblemResponseOptions, c as problemResponse, i as ProblemOptions, l as toProblem, n as PROBLEM_TYPE_BASE, o as fromProblem, r as ProblemDetails, s as isProblem, t as PROBLEM_CONTENT_TYPE } from "./problem-Blxe8S31.js";
-import { t as SPEC_PINS } from "./spec-pins-CqorWDnO.js";
+import { n as postgrestCompiler, t as Compiler } from "./compiler-DY_wkj4R.js";
+import { t as SPEC_PINS } from "./spec-pins-C89s6DyW.js";
+//#region src/core/error-messages.d.ts
+/**
+ * A message for every `DbError` kind: a string, or a function of the error.
+ * Leaving a kind out is a type error, so a new kind can't fall through.
+ */
+type ErrorMessages = { readonly [K in DbErrorKind]: string | ((error: DbErrorOf<K>) => string); };
+/**
+ * Turns an error into the sentence to show the user. Build it where your
+ * translations are, e.g. inside a hook that has `t`.
+ *
+ * ```ts
+ * const message = createErrorMessages({
+ *   unauthorized: t('Sign in again to continue.'),
+ *   raised: (error) => error.message,
+ *   // ...every other kind
+ * });
+ * toast.error(message(result.error));
+ * ```
+ */
+export declare function createErrorMessages(messages: ErrorMessages): (error: DbError) => string;
+//#endregion
 //#region src/core/define-repository.d.ts
 /** Adds `Methods` to the repository of `Table` only. */
 interface TableRepositoryExtension<Table extends string, Methods> extends RepositoryExtension {
@@ -44,7 +69,7 @@ export declare function invalidationTargets(meta: SchemaMeta, table: string): re
 //#endregion
 //#region src/core/policy.d.ts
 /**
- * A callback that decides something a kit would otherwise allow or refuse
+ * A callback that decides something a module would otherwise allow or refuse
  * by default: `authorize`, `canInvite`, `shouldDeliver`, `allowUrl`. Only
  * `true` allows; `false`, any other value, a throw or a rejection denies.
  */
@@ -61,6 +86,7 @@ type PolicyDecision = {
 //#region src/core/cursor.d.ts
 /** Opaque, URL-safe keyset cursor. */
 export declare function encodeCursor(values: readonly unknown[]): string;
+/** The values of a cursor from `encodeCursor` or from `paginate()`. */
 export declare function decodeCursor(cursor: string): unknown[] | undefined;
 //#endregion
 //#region src/schema/define.d.ts
@@ -81,18 +107,36 @@ type EnrichSchema<S, O> = { [P in keyof S]: P extends "Tables" | "Views" ? Enric
  */
 type EnrichDatabase<D, O> = { [S in keyof D]: S extends keyof O ? EnrichSchema<D[S], O[S]> : D[S]; };
 //#endregion
-//#region src/ir/build.d.ts
-/** Escapes LIKE wildcards so user input matches literally. */
-export declare function escapeLike(value: string): string;
-//#endregion
 //#region src/ir/codec.d.ts
 /** Applies column codecs to returned rows, including embedded relations. */
 export declare function decodeRows(selection: Selection | undefined, rows: readonly Record<string, unknown>[], checked?: boolean): Record<string, unknown>[];
 //#endregion
 //#region src/ir/wire.d.ts
-/** Wire form of an app value: Temporal values to ISO text, `bigint` to decimal text. */
+/**
+ * Wire form of an app value: Temporal values and `Date` to ISO text, `bigint`
+ * to decimal text.
+ */
 export declare function encodeValue(value: unknown): unknown;
 //#endregion
+//#region src/core/temporal.d.ts
+/**
+ * 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.
+ */
+export declare function provideTemporal(namespace: typeof Temporal | undefined): void;
+/** A `Temporal.Instant` from any copy of Temporal, checked by `Symbol.toStringTag`. */
+export declare function isInstant(value: unknown): value is Temporal.Instant;
+/** A `Temporal.PlainDateTime` from any copy of Temporal. */
+export declare function isPlainDateTime(value: unknown): value is Temporal.PlainDateTime;
+/** A `Temporal.PlainDate` from any copy of Temporal. */
+export declare function isPlainDate(value: unknown): value is Temporal.PlainDate;
+/** A `Temporal.PlainTime` from any copy of Temporal. */
+export declare function isPlainTime(value: unknown): value is Temporal.PlainTime;
+/** A `Temporal.ZonedDateTime` from any copy of Temporal. */
+export declare function isZonedDateTime(value: unknown): value is Temporal.ZonedDateTime;
+//#endregion
 //#region src/ir/scope.d.ts
 /** Returns the filter that always applies to rows of `table`, if any. */
 type ScopeFor = (table: TableMeta) => Condition | undefined;
@@ -119,9 +163,12 @@ export declare function scopeOperation(op: Operation, scopeFor: ScopeFor, root?:
 export declare function simplify(condition: Condition | undefined): Condition | boolean;
 //#endregion
 //#region src/casing/index.d.ts
-/** `first_name` to `firstName`. Leaves already camel-cased names untouched. */
+/**
+ * `first_name` to `firstName`. Leaves already camel-cased names and leading
+ * underscores (`_internal`) untouched.
+ */
 export declare function toCamel(name: string): string;
 /** `firstName` to `first_name`. */
 export declare function toSnake(name: string): string;
 //#endregion
-export { type AccessBucketPolicy, type Actor, type AggregateArgs, type AggregateFn, type AggregateResult, type AggregateRow, type Aggregation, type AnyFunctions, type AnyModels, type AnyPlugin, type ApplyExtension, AsyncResult, type AuthEvent, type BetterResultApi, type BetterResultValue, BetterSupabase, type BetterSupabaseEvents, type BucketMeta, type BucketPolicyName, type CacheAdapter, type CacheTarget, type CallOptions, type Casing, type CheckConstraint, type ClaimsMeta, type Codec, type ColumnMeta, type ColumnOp, type Compiler, type Condition, type ConflictTarget, type ConnectOptions, type CountArg, type CountArgs, type CountMode, type CursorPage, type CursorPageArgs, type DatabaseOf, type Db, type DbError, type DbErrorKind, type DbErrorKinds, type DbErrorOf, DbException, type DbHelpers, type DbStats, type DeleteArgs, type DeleteExt, type DeleteOp, EMPTY_STATS, type EnrichDatabase, type Err, type ErrorEvent, type ErrorMapper, type EventHandler, EventHub, type EventName, type ExecuteContext, type ExecuteResult, type Executor, type ExtensionOf, type FieldFilter, type FindExt, type FindFirstArgs, type FindManyArgs, type Flags, type ForeignKeyConstraint, type FunctionMeta, type FunctionSource, type FunctionTypes, type FunctionsOf, type HasFlag, type HookArgs, type Include, type IncludeArg, type IncludeArgs, type InferReadSetParams, type InferResult, type Insert, type InsertOp, type KitEvent, type KitEventMap, type KitEventType, type LogFields, type Logger, type Measure, type MeasureArg, type MeasureKey, type MemoryCache, type ModelFlags, type ModelTypes, type ModelsOf, type MutationEvent, type MutationIntent, type MutationKind, type MutationNotice, type MutationOp, type NoExtension, type NumericMeasureArg, type OffsetPage, type OffsetPageArgs, type Ok, type Operation, type OrderByArg, type OrderByInput, type OrderTerm, PLUGIN_API_VERSION, PROBLEM_CONTENT_TYPE, PROBLEM_TYPE_BASE, type PageOf, type Payload, type PermdockBucketPolicy, type PermdockTopicPolicy, type PlanFilter, type PlanLimit, type PlanOrder, type Plugin, type Policy, type PolicyDecision, type PostgrestClientLike, type PostgrestPlan, type PrimaryKeyColumn, type PrimaryKeyValue, type ProblemDetails, type ProblemOptions, type ProblemResponseOptions, type Quantifier, type QueryEvent, type QuerySpec, type RawDbError, type ReadArgs, type ReadMethod, type ReadSet, type ReadSetOptions, type ReadSetParamType, type ReadSetParamTypes, type ReadSetParamValue, type ReadSetParams, type ReadSetResult, type RealtimeTableMeta, type RefreshEvent, type RelationMeasureArg, type RelationMeta, type RelationTypes, type Relations, type Repository, type RepositoryApi, type RepositoryExtension, type RepositoryOf, type RequestContext, type Result, type Returned, type Row, type RpcContext, type RpcDefinition, type RpcNotice, type RpcOptions, SPEC_PINS, type Schema, type SchemaMeta, type ScopeFor, type SearchArgs, type SelectArg, type SelectColumn, type SelectOp, type Selection, type Simplify, type SortDirection, type Specs, type StandardSchemaV1, StatsRecorder, type StoragePath, type SupabaseOptions, type TableFlags, type TableKey, type TableMeta, type TableRepositoryExtension, type TableSpecs, type UniqueConstraint, type UniqueKeyName, type UniqueWhere, type Update, type UpdateArgs, type UpdateOp, type UpsertArgs, type ValidationIssue, type WhereInput, type WithExtension, type WriteArgs, and, cacheTargetOf, column, compilePostgrest, consoleLogger, dbError, definePlugin, defineReadSet, defineSupabase, err, explainPostgrest, fromBetterResult, fromProblem, isCheck, isConflict, isDbError, isForeignKey, isProblem, isQuerySpec, isReadSet, mapDbError, memoryCache, not, ok, or, postgrestCompiler, postgrestExecutor, problemResponse, readSetTables, recordStats, rowKey, rpcCacheTargets, silentLogger, specTables, statusOf, toBetterResult, toDbError, toProblem, validate };
+export { type AccessBucketPolicy, type AccessPolicySql, type AccessTopicPolicy, type Actor, type AggregateArgs, type AggregateFn, type AggregateOrderBy, type AggregateOrderByArg, type AggregateResult, type AggregateRow, type Aggregation, type AnyFunctions, type AnyModels, type AnyPlugin, type ApplyExtension, AsyncResult, type AuthEvent, type BetterResultApi, type BetterResultErr, type BetterResultErrors, type BetterResultOk, type BetterResultValue, BetterSupabase, type BetterSupabaseEvents, type BlockEvent, type BlockEventMap, type BlockEventType, type BlockProblemOptions, type BucketMeta, type BucketPolicyName, type CacheAdapter, type CacheTarget, type CallOptions, type Casing, type CheckConstraint, type ClaimsMeta, type Codec, type ColumnMeta, type ColumnOp, type ColumnOrderBy, type ColumnOrderByArg, type Compiler, type Condition, type ConflictTarget, type ConnectOptions, type CountArg, type CountArgs, type CountMode, type CursorPage, type CursorPageArgs, type DatabaseOf, type Db, type DbError, type DbErrorClass, type DbErrorClasses, type DbErrorKind, type DbErrorKinds, type DbErrorOf, DbException, type DbHelpers, type DbStats, type DeleteArgs, type DeleteExt, type DeleteOp, EMPTY_STATS, type EnrichDatabase, type Err, type ErrorEvent, type ErrorMapper, type ErrorMessages, type EventHandler, EventHub, type EventName, type ExecuteContext, type ExecuteResult, type Executor, type ExtensionOf, type FieldFilter, type FindExt, type FindFirstArgs, type FindManyArgs, type FindOnlyArgs, type Flags, type ForeignKeyConstraint, type FunctionMeta, type FunctionResult, type FunctionSignature, type FunctionSource, type FunctionTypes, type FunctionsOf, type HasFlag, type HookArgs, type Include, type IncludeArg, type IncludeArgs, type InferReadSetParams, type InferResult, type Insert, type InsertOp, type JsonPathOps, type LogFields, type Logger, type ManyResult, type ManyReturningArgs, type MappedDbError, type Measure, type MeasureArg, type MeasureKey, type MemoryCache, type ModelFlags, type ModelTypes, type ModelsOf, type MutableWhere, type MutationEvent, type MutationIntent, type MutationKind, type MutationNotice, type MutationOp, type NoExtension, type NumericMeasureArg, type OffsetPage, type OffsetPageArgs, type OffsetRangeArgs, type Ok, type Operation, type OrderByArg, type OrderByInput, type OrderTerm, PLUGIN_API_VERSION, PROBLEM_CONTENT_TYPE, PROBLEM_TYPE_BASE, type PageOf, type Payload, type PlanFilter, type PlanLimit, type PlanOrder, type Plugin, type Policy, type PolicyDecision, type PostgrestClientLike, type PostgrestExecutorOptions, type PostgrestPlan, type PrimaryKeyColumn, type PrimaryKeyValue, type ProblemDetails, type ProblemFormat, type ProblemOptions, type ProblemResponseOptions, type Quantifier, type QueryEvent, type QuerySpec, type RawDbError, type ReadArgs, type ReadMethod, type ReadSet, type ReadSetAuth, type ReadSetOptions, type ReadSetParamType, type ReadSetParamTypes, type ReadSetParamValue, type ReadSetParams, type ReadSetResult, type RealtimeTableMeta, type RefreshEvent, type RelationMeasureArg, type RelationMeta, type RelationTypes, type Relations, type Repository, type RepositoryApi, type RepositoryExtension, type RepositoryOf, type RequestArgs, type RequestContext, type Result, type ResultColumn, type Returned, type Row, type RpcContext, type RpcDefinition, type RpcNotice, type RpcOptions, SPEC_PINS, type Schema, type SchemaMeta, type ScopeFor, type SearchArgs, type SelectArg, type SelectColumn, type SelectOp, type Selection, type Simplify, type SortDirection, type SortSpec, type Specs, type StandardSchemaV1, StatsRecorder, type StoragePath, type SupabaseOptions, type TableFlags, type TableKey, type TableMeta, type TableRepositoryExtension, type TableSpecs, type UniqueConstraint, type UniqueKeyName, type UniqueWhere, type Update, type UpdateArgs, type UpdateOp, type UpsertArgs, type UpsertManyArgs, type ValidationIssue, type WhereInput, type WithExtension, type WriteArgs, type WriteManyArgs, and, cacheTargetOf, column, compilePostgrest, consoleLogger, dbError, defineBetterResultErrors, definePlugin, defineReadSet, defineSupabase, err, escapeLike, explainPostgrest, fromBetterResult, fromProblem, isCheck, isConflict, isDbError, isForeignKey, isProblem, isQuerySpec, isReadSet, mapDbError, memoryCache, not, ok, or, postgrestCompiler, postgrestExecutor, problemResponse, readSetTables, recordStats, rowKey, rpcCacheTargets, silentLogger, specTables, statusOf, toBetterResult, toDbError, toProblem, validate };

package/dist/index.js

@@ -1,18 +1,43 @@
-import { a as isConflict, c as mapDbError, i as isCheck, l as statusOf, n as dbError, o as isDbError, s as isForeignKey, t as DbException } from "./errors-DtwXa6b8.js";
-import { i as escapeLike, o as defineSchema, s as tableMeta, t as simplify } from "./simplify-_0oUKqCd.js";
+import { t as DbException } from "./db-exception-CnWcYPxL.js";
+import { a as isConflict, c as mapDbError, i as isCheck, l as statusOf, n as dbError, o as isDbError, s as isForeignKey } from "./errors-B11Duf73.js";
+import { i as tableMeta, r as defineSchema } from "./build-BXIzE6Xv.js";
+import { t as escapeLike } from "./escape-like-DHfx6jRr.js";
 import { i as or, n as column, r as not, t as and } from "./types-6cYK9pbJ.js";
-import { r as encodeValue } from "./wire-D2dT86vi.js";
-import { a as toBetterResult, i as ok, n as err, o as toDbError, r as fromBetterResult, t as AsyncResult } from "./result-BKiliPY7.js";
-import { a as decodeRows, c as memoryCache, i as encodeCursor, l as rowKey, n as defineSupabase, o as EventHub, r as decodeCursor, s as cacheTargetOf, t as BetterSupabase, u as rpcCacheTargets } from "./define-cNKzqwL_.js";
+import { a as isPlainTime, i as isPlainDateTime, l as provideTemporal, n as isInstant, o as isZonedDateTime, r as isPlainDate } from "./temporal-BJGitm-h.js";
+import { i as encodeValue } from "./wire-DtZQ4sdE.js";
+import { a as ok, i as fromBetterResult, n as defineBetterResultErrors, o as toBetterResult, r as err, s as toDbError, t as AsyncResult } from "./result-DzUbqgdW.js";
+import { a as decodeRows, c as memoryCache, i as encodeCursor, l as rowKey, n as defineSupabase, o as EventHub, r as decodeCursor, s as cacheTargetOf, t as BetterSupabase, u as rpcCacheTargets } from "./define-B-TVjC25.js";
 import { n as touchedTables, t as invalidationTargets } from "./tables-Cb-3_VWc.js";
 import { n as silentLogger, t as consoleLogger } from "./logger-glM28NVN.js";
-import { r as definePlugin, t as PLUGIN_API_VERSION } from "./plugin-DwARMuQp.js";
-import { a as postgrestExecutor, i as explainPostgrest, n as StatsRecorder, o as compilePostgrest, r as recordStats, t as EMPTY_STATS } from "./stats-Bqob3WqT.js";
-import { c as readSetTables, d as isQuerySpec, f as specTables, i as defineReadSet, o as isReadSet } from "./read-set-DQFt1N_Y.js";
-import { t as validate } from "./standard-D7r6dMUu.js";
-import { a as problemResponse, i as isProblem, n as PROBLEM_TYPE_BASE, o as toProblem, r as fromProblem, t as PROBLEM_CONTENT_TYPE } from "./problem-BW1KhzSG.js";
-import { t as SPEC_PINS } from "./spec-pins-C3oc-Tdp.js";
+import { r as definePlugin, t as PLUGIN_API_VERSION } from "./plugin-tfXW1-qO.js";
+import { t as simplify } from "./simplify-DDO0j0LI.js";
+import { a as postgrestExecutor, i as explainPostgrest, n as StatsRecorder, r as recordStats, t as EMPTY_STATS, u as compilePostgrest } from "./stats-D_AD9GGu.js";
+import { c as readSetTables, d as isQuerySpec, f as specTables, i as defineReadSet, o as isReadSet } from "./read-set-DuKWC9Mj.js";
+import { n as validate } from "./standard-BK0cqJ7y.js";
+import { a as problemResponse, i as isProblem, n as PROBLEM_TYPE_BASE, o as toProblem, r as fromProblem, t as PROBLEM_CONTENT_TYPE } from "./problem-BreOl8b8.js";
+import { t as SPEC_PINS } from "./spec-pins--j6mTok4.js";
 import { n as scopeOperation, r as scopeSelection, t as scopeCondition } from "./scope-CDHcS7dE.js";
+//#region src/core/error-messages.ts
+/**
+* Turns an error into the sentence to show the user. Build it where your
+* translations are, e.g. inside a hook that has `t`.
+*
+* ```ts
+* const message = createErrorMessages({
+*   unauthorized: t('Sign in again to continue.'),
+*   raised: (error) => error.message,
+*   // ...every other kind
+* });
+* toast.error(message(result.error));
+* ```
+*/
+function createErrorMessages(messages) {
+	return (error) => {
+		const message = messages[error.kind];
+		return typeof message === "string" ? message : message(error);
+	};
+}
+//#endregion
 //#region src/core/define-repository.ts
 /**
 * Domain methods for one table, installed with `use()`. `base` is the
@@ -41,13 +66,16 @@ const postgrestCompiler = {
 };
 //#endregion
 //#region src/casing/index.ts
-/** `first_name` to `firstName`. Leaves already camel-cased names untouched. */
+/**
+* `first_name` to `firstName`. Leaves already camel-cased names and leading
+* underscores (`_internal`) untouched.
+*/
 function toCamel(name) {
-	return name.replaceAll(/_+([a-z0-9])/g, (_, char) => char.toUpperCase());
+	return name.replaceAll(/(?<=[^_])_+([a-z0-9])/g, (_, char) => char.toUpperCase());
 }
 /** `firstName` to `first_name`. */
 function toSnake(name) {
 	return name.replaceAll(/([a-z0-9])([A-Z])/g, "$1_$2").replaceAll(/([A-Z])([A-Z][a-z])/g, "$1_$2").toLowerCase();
 }
 //#endregion
-export { AsyncResult, BetterSupabase, DbException, EMPTY_STATS, EventHub, PLUGIN_API_VERSION, PROBLEM_CONTENT_TYPE, PROBLEM_TYPE_BASE, SPEC_PINS, StatsRecorder, and, cacheTargetOf, column, compilePostgrest, consoleLogger, dbError, decodeCursor, decodeRows, definePlugin, defineReadSet, defineRepository, defineSchema, defineSupabase, encodeCursor, encodeValue, err, escapeLike, explainPostgrest, fromBetterResult, fromProblem, invalidationTargets, isCheck, isConflict, isDbError, isForeignKey, isProblem, isQuerySpec, isReadSet, mapDbError, memoryCache, not, ok, or, postgrestCompiler, postgrestExecutor, problemResponse, readSetTables, recordStats, rowKey, rpcCacheTargets, scopeCondition, scopeOperation, scopeSelection, silentLogger, simplify, specTables, statusOf, tableMeta, toBetterResult, toCamel, toDbError, toProblem, toSnake, touchedTables, validate };
+export { AsyncResult, BetterSupabase, DbException, EMPTY_STATS, EventHub, PLUGIN_API_VERSION, PROBLEM_CONTENT_TYPE, PROBLEM_TYPE_BASE, SPEC_PINS, StatsRecorder, and, cacheTargetOf, column, compilePostgrest, consoleLogger, createErrorMessages, dbError, decodeCursor, decodeRows, defineBetterResultErrors, definePlugin, defineReadSet, defineRepository, defineSchema, defineSupabase, encodeCursor, encodeValue, err, escapeLike, explainPostgrest, fromBetterResult, fromProblem, invalidationTargets, isCheck, isConflict, isDbError, isForeignKey, isInstant, isPlainDate, isPlainDateTime, isPlainTime, isProblem, isQuerySpec, isReadSet, isZonedDateTime, mapDbError, memoryCache, not, ok, or, postgrestCompiler, postgrestExecutor, problemResponse, provideTemporal, readSetTables, recordStats, rowKey, rpcCacheTargets, scopeCondition, scopeOperation, scopeSelection, silentLogger, simplify, specTables, statusOf, tableMeta, toBetterResult, toCamel, toDbError, toProblem, toSnake, touchedTables, validate };

package/dist/invalidate-BBqhpxyB.d.ts

@@ -0,0 +1,19 @@
+import { QueryClient, QueryMeta } from "@tanstack/query-core";
+//#region src/query/invalidate.d.ts
+/**
+ * Carried by every better-supabase query: the tables whose changes make it
+ * stale, on top of the app's `Register['queryMeta']`, so the options stay
+ * assignable to `useQuery` when the app narrows its query meta.
+ */
+type BetterQueryMeta = QueryMeta & {
+  readonly bsTables: readonly string[];
+};
+/**
+ * Invalidates every query that read one of `tables`: better-supabase queries
+ * by their `meta.bsTables`, and other `['bs', table, ...]` keys by prefix.
+ * An index from table to queries finds them, so a write to a table nothing
+ * read skips the cache scan.
+ */
+declare function invalidateTables(client: QueryClient, tables: readonly string[]): Promise<void>;
+//#endregion
+export { invalidateTables as n, BetterQueryMeta as t };

package/dist/json-CEnpTHlZ.js

@@ -0,0 +1,16 @@
+//#region src/core/json.ts
+/** A `JSON.stringify` replacer: `bigint` values become decimal strings, as the wire codec writes them. */
+function jsonReplacer(_key, value) {
+	return typeof value === "bigint" ? value.toString() : value;
+}
+/** `Response.json` that writes `bigint` values as decimal strings instead of throwing. */
+function jsonResponse(data, init = {}) {
+	const headers = new Headers(init.headers);
+	if (!headers.has("content-type")) headers.set("content-type", "application/json");
+	return new Response(JSON.stringify(data, jsonReplacer), {
+		...init,
+		headers
+	});
+}
+//#endregion
+export { jsonResponse as n, jsonReplacer as t };