better-supabase 0.3.0 → 0.5.0

package/dist/events-Do8jXh4D.d.ts

@@ -1,84 +0,0 @@
-import { g as Operation } from "./executor-DynmIWhq.js";
-import { p as DbError } from "./result-c2OYgCV2.js";
-import { h as RequestContext, l as MutationKind } from "./plugin-DVRB8qNE.js";
-//#region src/core/logger.d.ts
-type LogFields = Readonly<Record<string, unknown>>;
-/**
- * Where better-supabase reports problems it swallows on purpose: event
- * handlers, `afterMutation` hooks, sinks and cache adapters that throw.
- * Structured loggers (pino, consola, OpenTelemetry logs) fit directly.
- */
-interface Logger {
-  debug(message: string, fields?: LogFields): void;
-  info(message: string, fields?: LogFields): void;
-  warn(message: string, fields?: LogFields): void;
-  error(message: string, fields?: LogFields): void;
-}
-/** The default: `console`, with a `better-supabase:` prefix. */
-declare const consoleLogger: Logger;
-declare const silentLogger: Logger;
-//#endregion
-//#region src/core/events.d.ts
-interface QueryEvent {
-  readonly table: string;
-  readonly operation: Operation["kind"];
-  readonly ok: boolean;
-  readonly durationMs: number;
-  readonly rows: number;
-  /**
-   * An unbounded read returned `maxRows` rows: PostgREST's `db-max-rows`
-   * probably cut it short. Add `limit` or use `paginate`.
-   */
-  readonly truncated: boolean;
-}
-interface MutationNotice {
-  readonly table: string;
-  readonly kind: MutationKind;
-  readonly rows: readonly Readonly<Record<string, unknown>>[];
-  readonly context: RequestContext;
-}
-/** A successful RPC registered with `sb.defineRpc(name, { invalidates })`. */
-interface RpcNotice {
-  readonly name: string;
-  /** App keys of the tables the function changes. */
-  readonly invalidates: readonly string[];
-  readonly context: RequestContext;
-}
-interface ErrorEvent {
-  readonly table?: string;
-  readonly error: DbError;
-}
-interface AuthEvent {
-  readonly source: "bearer" | "cookie" | "none";
-  readonly ok: boolean;
-  readonly userId?: string;
-}
-interface RefreshEvent {
-  readonly ok: boolean;
-  readonly shared: boolean;
-  readonly durationMs: number;
-}
-interface BetterSupabaseEvents {
-  query: QueryEvent;
-  mutation: MutationNotice;
-  rpc: RpcNotice;
-  error: ErrorEvent;
-  auth: AuthEvent;
-  refresh: RefreshEvent;
-}
-type EventName = keyof BetterSupabaseEvents;
-type EventHandler<K extends EventName> = (event: BetterSupabaseEvents[K]) => void;
-/**
- * Observers only: a handler that throws is reported to the logger and never
- * changes a result.
- */
-declare class EventHub {
-  #private;
-  readonly logger: Logger;
-  constructor(logger?: Logger);
-  on<K extends EventName>(name: K, handler: EventHandler<K>): () => void;
-  has(name: EventName): boolean;
-  emit<K extends EventName>(name: K, event: BetterSupabaseEvents[K]): void;
-}
-//#endregion
-export { EventHub as a, QueryEvent as c, LogFields as d, Logger as f, EventHandler as i, RefreshEvent as l, silentLogger as m, BetterSupabaseEvents as n, EventName as o, consoleLogger as p, ErrorEvent as r, MutationNotice as s, AuthEvent as t, RpcNotice as u };

package/dist/executor-DynmIWhq.d.ts

@@ -1,195 +0,0 @@
-import { P as TableMeta, T as RelationMeta, c as Codec } from "./types-DONv9SHN.js";
-import { o as Result, v as ErrorMapper } from "./result-c2OYgCV2.js";
-//#region src/ir/types.d.ts
-/**
- * The query IR. Every repository call becomes one of these operations; the
- * executor compiles it to PostgREST or SQL. Column names in the IR are
- * database names; `Selection` carries the app aliases.
- */
-type ColumnOp = "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "is" | "like" | "ilike" | "contains" | "containedBy" | "overlaps" | "fts";
-type Quantifier = "some" | "none" | "every";
-type Condition = {
-  readonly kind: "and";
-  readonly items: readonly Condition[];
-} | {
-  readonly kind: "or";
-  readonly items: readonly Condition[];
-} | {
-  readonly kind: "not";
-  readonly item: Condition;
-} | {
-  readonly kind: "column";
-  readonly column: string;
-  readonly op: ColumnOp;
-  readonly value: unknown;
-  /** Full-text search configuration for `fts`. */
-  readonly config?: string;
-} | {
-  readonly kind: "relation";
-  readonly name: string;
-  readonly relation: RelationMeta;
-  readonly target: TableMeta;
-  readonly quantifier: Quantifier;
-  readonly where: Condition | undefined;
-};
-interface SelectColumn {
-  /** Key in the returned row. */
-  readonly alias: string;
-  /** Database column name. */
-  readonly column: string;
-  /** Read the column as text, so exact `int8`/`numeric` values survive JSON. */
-  readonly cast?: "text";
-  /** Decodes the returned value (see `ColumnMeta.codec`). */
-  readonly codec?: Codec;
-}
-interface OrderTerm {
-  readonly column: string;
-  readonly direction: "asc" | "desc";
-  readonly nulls?: "first" | "last";
-}
-interface Include {
-  readonly alias: string;
-  readonly relation: RelationMeta;
-  readonly target: TableMeta;
-  readonly selection: Selection;
-  readonly where: Condition | undefined;
-  readonly orderBy: readonly OrderTerm[];
-  readonly limit: number | undefined;
-  /** Drop parent rows without a match (`!inner`). */
-  readonly required: boolean;
-  /**
-   * `_count` include: returns the number of matching related rows instead of
-   * rows, folded into `row._count[count]` when decoded.
-   */
-  readonly count?: string;
-  /**
-   * `_sum`/`_avg`/`_min`/`_max` include: `selection.aggregate` holds the
-   * measures, folded into `row[`_${fn}`][name]` when decoded.
-   */
-  readonly aggregate?: {
-    readonly fn: AggregateFn;
-    readonly name: string;
-  };
-}
-type AggregateFn = "sum" | "avg" | "min" | "max";
-interface Measure {
-  readonly fn: AggregateFn;
-  /** Key in the returned row (`_sum_amount`, or the column alias in an include). */
-  readonly key: string;
-  /** App column name, the key under `_sum` in the decoded row. */
-  readonly alias: string;
-  /** Database column name. */
-  readonly column: string;
-  /** Read the result as text, so exact `int8`/`numeric` values survive JSON. */
-  readonly cast?: "text";
-  readonly codec?: Codec;
-}
-/**
- * Aggregates instead of rows. `Selection.columns` become the grouping
- * columns; without any, the result is exactly one row.
- */
-interface Aggregation {
-  /** Also return `_count`, the number of rows in each group. */
-  readonly count: boolean;
-  readonly measures: readonly Measure[];
-}
-interface Selection {
-  readonly columns: readonly SelectColumn[];
-  readonly includes: readonly Include[];
-  readonly aggregate?: Aggregation;
-}
-type CountMode = "exact" | "planned" | "estimated";
-interface SelectOp {
-  readonly kind: "select";
-  readonly table: TableMeta;
-  readonly selection: Selection;
-  readonly where: Condition | undefined;
-  readonly orderBy: readonly OrderTerm[];
-  readonly limit: number | undefined;
-  readonly offset: number | undefined;
-  readonly count: CountMode | undefined;
-  /** Only count, return no rows. */
-  readonly head: boolean;
-  readonly single: "one" | "maybe" | undefined;
-  /**
-   * Read from this set-returning function instead of the table (`db.$search`).
-   * Only executors with `functionSources` honor it.
-   */
-  readonly source?: FunctionSource;
-}
-/** A function returning `setof <table>`, called with named arguments. */
-interface FunctionSource {
-  readonly schema: string;
-  readonly name: string;
-  readonly args: Readonly<Record<string, unknown>>;
-}
-interface InsertOp {
-  readonly kind: "insert";
-  readonly table: TableMeta;
-  /** Rows keyed by database column names. */
-  readonly rows: readonly Readonly<Record<string, unknown>>[];
-  readonly returning: Selection | undefined;
-  readonly onConflict: {
-    readonly columns: readonly string[];
-    readonly action: "update" | "ignore";
-  } | undefined;
-  /** Missing columns become `null` instead of their default in bulk inserts. */
-  readonly defaultToNull: boolean;
-}
-interface UpdateOp {
-  readonly kind: "update";
-  readonly table: TableMeta;
-  /** Keyed by database column names. */
-  readonly set: Readonly<Record<string, unknown>>;
-  readonly where: Condition | undefined;
-  readonly returning: Selection | undefined;
-}
-interface DeleteOp {
-  readonly kind: "delete";
-  readonly table: TableMeta;
-  readonly where: Condition | undefined;
-  readonly returning: Selection | undefined;
-}
-type Operation = SelectOp | InsertOp | UpdateOp | DeleteOp;
-type MutationOp = InsertOp | UpdateOp | DeleteOp;
-declare const and: (...items: (Condition | undefined)[]) => Condition | undefined;
-declare const or: (...items: Condition[]) => Condition;
-declare const not: (item: Condition) => Condition;
-declare const column: (name: string, op: ColumnOp, value: unknown) => Condition;
-//#endregion
-//#region src/core/executor.d.ts
-interface ExecuteContext {
-  readonly signal?: AbortSignal;
-  readonly errorMappers: readonly ErrorMapper[];
-}
-interface ExecuteResult {
-  /** Rows keyed by the aliases in the operation's selection. */
-  readonly rows: readonly Record<string, unknown>[];
-  readonly count: number | null;
-}
-/**
- * Runs IR operations. PostgREST (`postgrestExecutor`) and SQL
- * (`better-supabase/postgres`) are built in; any other backend can implement
- * this interface and prove it with `testExecutor` from `better-supabase/testing`.
- */
-interface Executor {
-  readonly name: string;
-  /** Honors `SelectOp.source`. `db.$search` fails on executors without it. */
-  readonly functionSources?: boolean;
-  execute(op: Operation, context: ExecuteContext): Promise<Result<ExecuteResult>>;
-  /** Calls a database function. Optional; `db.$rpc` fails without it. */
-  rpc?(name: string, args: Readonly<Record<string, unknown>>, context: RpcContext): Promise<Result<unknown>>;
-  /**
-   * Runs several reads together, for `db.$many`: one transaction on a SQL
-   * connection. Returns one result per operation, in order. Optional;
-   * without it `db.$many` runs the operations in parallel.
-   */
-  batch?(ops: readonly Operation[], context: ExecuteContext): Promise<readonly Result<ExecuteResult>[]>;
-}
-interface RpcContext extends ExecuteContext {
-  readonly schema: string;
-  /** The function is `stable`: send it as a GET, so read replicas can serve it. */
-  readonly get?: boolean;
-}
-//#endregion
-export { and as C, or as E, UpdateOp as S, not as T, OrderTerm as _, AggregateFn as a, SelectOp as b, Condition as c, FunctionSource as d, Include as f, Operation as g, MutationOp as h, RpcContext as i, CountMode as l, Measure as m, ExecuteResult as n, Aggregation as o, InsertOp as p, Executor as r, ColumnOp as s, ExecuteContext as t, DeleteOp as u, Quantifier as v, column as w, Selection as x, SelectColumn as y };

package/dist/invalidate-DbxuL2jL.js

@@ -1,18 +0,0 @@
-//#region src/query/invalidate.ts
-function queryTables(query) {
-	const tables = query.meta?.["bsTables"];
-	if (Array.isArray(tables)) return tables.filter((t) => typeof t === "string");
-	const [prefix, table] = query.queryKey;
-	return prefix === "bs" && typeof table === "string" ? [table] : void 0;
-}
-/**
-* Invalidates every query that read one of `tables`: better-supabase queries
-* by their `meta.bsTables`, and other `['bs', table, ...]` keys by prefix.
-*/
-function invalidateTables(client, tables) {
-	if (tables.length === 0) return Promise.resolve();
-	const changed = new Set(tables);
-	return client.invalidateQueries({ predicate: (query) => queryTables(query)?.some((table) => changed.has(table)) ?? false });
-}
-//#endregion
-export { invalidateTables as t };

package/dist/permdock-sql-DImJULY-.d.ts

@@ -1,17 +0,0 @@
-//#region src/core/permdock-sql.d.ts
-/**
- * The part of PermDock's `permissions.catalog.json` the Storage and Realtime
- * builders read: `import catalog from './permissions.catalog.json'`.
- */
-interface PermdockCatalog {
-  readonly permissions: readonly {
-    readonly key: string;
-    readonly rowConditions?: boolean;
-  }[];
-}
-/** The keys a bucket or topic PermDock policy names. */
-declare function permdockKeys(policy: {
-  readonly permdock: object;
-}): string[];
-//#endregion
-export { permdockKeys as n, PermdockCatalog as t };

package/dist/plugin-BqR6wKMB.js

@@ -1,23 +0,0 @@
-//#region src/core/plugin.ts
-const PLUGIN_API_VERSION = 1;
-const RANK = {
-	pre: 0,
-	normal: 1,
-	post: 2
-};
-/** Plugins in hook order: `pre`, then unmarked in `use()` order, then `post`. */
-function orderPlugins(plugins) {
-	return plugins.map((plugin, index) => ({
-		plugin,
-		index
-	})).sort((a, b) => RANK[a.plugin.enforce ?? "normal"] - RANK[b.plugin.enforce ?? "normal"] || a.index - b.index).map(({ plugin }) => plugin);
-}
-/** Identity helper that fixes `apiVersion` and infers the plugin types. */
-function definePlugin(plugin) {
-	return {
-		...plugin,
-		apiVersion: 1
-	};
-}
-//#endregion
-export { definePlugin as n, orderPlugins as r, PLUGIN_API_VERSION as t };