better-supabase 0.8.0 → 0.10.0

package/dist/events-xbpHkcK9.js

@@ -0,0 +1,82 @@
+import { n as deepFreeze, t as cloneValue } from "./clone-dN9XOL1K.js";
+import { t as consoleLogger } from "./logger-glM28NVN.js";
+//#region src/core/events.ts
+/**
+* The `error` event for `error`: a frozen copy, so a handler can't change
+* the `DbError` the caller gets back (invariant 5).
+*/
+function errorEvent(error, table) {
+	const copy = deepFreeze(cloneValue(error));
+	return table === void 0 ? { error: copy } : {
+		table,
+		error: copy
+	};
+}
+/** More handlers than this for one event usually means a missing unsubscribe. */
+const HANDLER_WARNING = 50;
+function isDevelopment() {
+	return typeof process !== "undefined" && process.env["NODE_ENV"] !== "production";
+}
+/**
+* Observers only: a handler that throws is reported to the logger and never
+* changes a result.
+*/
+var EventHub = class {
+	#handlers = /* @__PURE__ */ new Map();
+	#warned = /* @__PURE__ */ new Set();
+	#pending = /* @__PURE__ */ new Set();
+	logger;
+	/** The definition's `now` option; block events take their `time` from it. */
+	now;
+	constructor(logger = consoleLogger, now) {
+		this.logger = logger;
+		this.now = now;
+	}
+	on(name, handler) {
+		let set = this.#handlers.get(name);
+		if (!set) {
+			set = /* @__PURE__ */ new Set();
+			this.#handlers.set(name, set);
+		}
+		set.add(handler);
+		if (set.size > HANDLER_WARNING && !this.#warned.has(name) && isDevelopment()) {
+			this.#warned.add(name);
+			this.logger.warn(`${set.size} "${name}" handlers are registered; call the function on() returns to remove one you no longer need`);
+		}
+		return () => {
+			set.delete(handler);
+		};
+	}
+	has(name) {
+		return (this.#handlers.get(name)?.size ?? 0) > 0;
+	}
+	/**
+	* Keeps async work a handler started (a sink send) until it settles, so
+	* adapters can hand it to `after()` or `waitUntil`. Its outcome is ignored:
+	* handlers report their own failures.
+	*/
+	track(work) {
+		const settled = Promise.resolve(work).then(() => void 0, () => void 0);
+		this.#pending.add(settled);
+		settled.then(() => this.#pending.delete(settled));
+	}
+	/** Whether tracked work is still running. */
+	get pending() {
+		return this.#pending.size > 0;
+	}
+	/** Resolves once the work tracked so far has settled. Never rejects. */
+	async settled() {
+		await Promise.all(this.#pending);
+	}
+	emit(name, event) {
+		const set = this.#handlers.get(name);
+		if (!set) return;
+		for (const handler of set) try {
+			handler(event);
+		} catch (cause) {
+			this.logger.error(`"${name}" handler threw`, { cause });
+		}
+	}
+};
+//#endregion
+export { errorEvent as n, EventHub as t };

package/dist/executor-BicyP8Nl.d.ts

@@ -0,0 +1,272 @@
+import { f as Result, w as ErrorMapper } from "./result-Cj3yWhjH.js";
+import { B as TableMeta, O as RelationMeta, d as Codec, g as FunctionMeta } from "./types-BO8lVTun.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" | "match" | "imatch" | "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;
+  /**
+   * The column is `json`/`jsonb`: containment values are JSON documents,
+   * also when they are arrays, never Postgres array literals.
+   */
+  readonly json?: true;
+  /**
+   * Keys into a json column: the condition compares the text at this path
+   * (`column->a->>b`, `column #>> '{a,b}'`), and `is null` holds when the
+   * key is missing or JSON `null`.
+   */
+  readonly path?: readonly 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";
+  /**
+   * Added by the repository (the primary key order of `findMany`), not asked
+   * for by the caller, so a split read may sort it approximately.
+   */
+  readonly implicit?: true;
+  /**
+   * Sort `aggregate()` groups by this aggregate of `column`; `count` counts
+   * the group's rows and its `column` is `*`.
+   */
+  readonly aggregate?: AggregateFn | "count";
+  /** Sort by `column` of this to-one relation's row (only on the root table). */
+  readonly relation?: {
+    readonly name: string;
+    readonly relation: RelationMeta;
+    readonly target: TableMeta;
+  };
+}
+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;
+  /** `limit` includes one row past the page, which `paginate()` reads to set `hasMore`. */
+  readonly lookAhead?: boolean;
+  /** `limit` bounds a check, not a page: `findOnly` reads two rows to detect a second match. */
+  readonly unpaged?: boolean;
+  /**
+   * 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>>;
+}
+/** The statement a mutation runs. */
+type MutationKind = "insert" | "upsert" | "update" | "delete";
+/** What the caller asked for: `softDelete` is a `delete` that a plugin turned into an update. */
+type MutationIntent = MutationKind | "softDelete";
+interface MutationBase {
+  /**
+   * What the caller asked for, when a plugin rewrote the mutation into
+   * another kind. The plugin that rewrites it sets this; mutation events
+   * report it.
+   */
+  readonly intent?: MutationIntent;
+  /**
+   * How a mutation without `returning` counts the rows it wrote. Defaults to
+   * `exact`; SQL executors always return the statement's own row count.
+   */
+  readonly count?: CountMode;
+}
+interface BoundedMutation extends MutationBase {
+  /**
+   * The most rows the statement may change. More fails with `max_affected`
+   * and writes nothing. Over PostgREST it needs PostgREST 13 or later.
+   */
+  readonly maxAffected?: number;
+}
+interface InsertOp extends MutationBase {
+  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;
+  /**
+   * In a multi-row insert, columns some rows leave out become `null`
+   * instead of their column default.
+   */
+  readonly defaultToNull: boolean;
+}
+interface UpdateOp extends BoundedMutation {
+  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 extends BoundedMutation {
+  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 {
+  /** Already includes the call's `timeout`, when it has one. */
+  readonly signal?: AbortSignal;
+  readonly errorMappers: readonly ErrorMapper[];
+  /**
+   * The call's `retry` setting. PostgREST passes it to postgrest-js, which
+   * retries idempotent requests on network errors, 503 and 520; executors
+   * without retries ignore it.
+   */
+  readonly retry?: boolean;
+}
+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;
+  readonly function?: FunctionMeta;
+  /**
+   * The result columns to select, by database name. Set when a column has a
+   * codec, which reads it as text: a JSON number has already lost an `int8`
+   * past 2^53 or a `numeric`'s digits.
+   */
+  readonly select?: readonly RpcColumn[];
+}
+/** One column of an `RpcContext.select` list. */
+interface RpcColumn {
+  readonly column: string;
+  readonly cast?: "text";
+}
+//#endregion
+export { Selection as C, not as D, column as E, or as O, SelectOp as S, and as T, MutationOp as _, AggregateFn as a, Quantifier as b, Condition as c, FunctionSource as d, Include as f, MutationKind as g, MutationIntent 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, Operation as v, UpdateOp as w, SelectColumn as x, OrderTerm as y };

package/dist/executor-CHRwEYqt.d.ts

@@ -0,0 +1,95 @@
+import { B as WorkflowGraph } from "./types-DZj8CZMH.js";
+//#region src/blocks/workflow-builder/executor.d.ts
+/** The record a run belongs to. */
+interface GraphSubject {
+  readonly type: string;
+  readonly id: string;
+}
+/** What a step node passes to the engine's step: plain data, so it serializes. */
+interface GraphStepCall {
+  /** The node id, which `workflow_node_runs` keys on. */
+  readonly node: string;
+  /** The library step's name. */
+  readonly step: string;
+  readonly config: Readonly<Record<string, unknown>>;
+  /** The trigger's input. */
+  readonly input: unknown;
+  /** The outputs of the nodes that ran before it, by node id. */
+  readonly results: Readonly<Record<string, unknown>>;
+  /** The run's key; approval hooks use `<runKey>:<node>` as their token. */
+  readonly runKey: string;
+  /** The published version's id; pass it to `builder.versions.runAs`. */
+  readonly version?: string;
+  /** The tenant the run belongs to; pass it to `builder.versions.runAs` too. */
+  readonly tenant?: string;
+  readonly subject?: GraphSubject;
+}
+/** What an approval node passes to `GraphRuntime.requestApproval`: plain data, so it serializes. */
+interface GraphApprovalCall {
+  readonly node: string;
+  /** The node's config, e.g. the approvals `action` to file the request under. */
+  readonly config: Readonly<Record<string, unknown>>;
+  readonly input: unknown;
+  readonly results: Readonly<Record<string, unknown>>;
+  readonly runKey: string;
+  readonly version?: string;
+  readonly tenant?: string;
+  readonly subject?: GraphSubject;
+}
+/** What the engine does for each kind of node. */
+interface GraphRuntime {
+  readonly runKey: string;
+  /** The published version's id (`GraphRunMeta.versionId`), passed to each step. */
+  readonly version?: string;
+  /** The run's tenant, passed to each step. */
+  readonly tenant?: string;
+  /** The record the run belongs to: passed to each step, and conditions read it as `subject`. */
+  readonly subject?: GraphSubject;
+  /** The trigger node the run starts at; required when the graph has several. */
+  readonly triggerNode?: string;
+  /**
+   * Set for a test run: each step node returns its stub (by node id, else
+   * `{ stubbed: true }`) instead of calling `step`, sleeps are skipped, and
+   * an approval node takes its stub as the decision (else approved).
+   */
+  readonly stubs?: Readonly<Record<string, unknown>>;
+  step(call: GraphStepCall): PromiseLike<unknown>;
+  sleep(ms: number): PromiseLike<unknown>;
+  /**
+   * Files the approval request for an approval node and returns its id,
+   * which becomes the hook token. Run it as a step that calls the approvals
+   * block's `request`; `wakeOnApproval` resumes the run once an eligible
+   * approver decides. Without it the token is `<runKey>:<node>`, which
+   * anyone who knows the run key can guess.
+   */
+  requestApproval?(call: GraphApprovalCall): PromiseLike<string>;
+  /** Waits for the approval hook with `token` and returns its payload. */
+  approval(token: string, node: string): PromiseLike<unknown>;
+}
+/** The hook token of an approval node without `requestApproval`. */
+declare const approvalToken: (runKey: string, node: string) => string;
+/** The run fields a graph run's meta carries (`GraphRunMeta` in `workflow-sdk/builder`). */
+type GraphRunFields = Pick<GraphRuntime, "runKey" | "version" | "tenant" | "subject" | "triggerNode" | "stubs">;
+/**
+ * The runtime fields of a static executor's `meta`: spread them into the
+ * runtime passed to `executeGraph`, so a run starts at its trigger node,
+ * conditions read its subject, and a test run returns its stubs instead of
+ * running steps.
+ */
+declare function graphRunFields(meta: unknown): GraphRunFields;
+/**
+ * The trigger node a run starts at: `requested` when the graph has it, else
+ * the graph's only trigger. Throws when neither picks one.
+ */
+declare function startNodeOf(graph: WorkflowGraph, requested: string | undefined): string;
+/**
+ * Runs `graph` in dependency order from its start trigger
+ * (`runtime.triggerNode`): a node runs when the trigger reaches it through
+ * edges whose sources ran (and, from a condition or an approval, took the
+ * edge's branch). Returns each node's output by id. It only calls
+ * `runtime`, so it is deterministic and runs inside a `"use workflow"`
+ * function as the static executor.
+ */
+declare function executeGraph(graph: WorkflowGraph, input: unknown, runtime: GraphRuntime): Promise<Record<string, unknown>>;
+//#endregion
+export { GraphSubject as a, graphRunFields as c, GraphStepCall as i, startNodeOf as l, GraphRunFields as n, approvalToken as o, GraphRuntime as r, executeGraph as s, GraphApprovalCall as t };

package/dist/executor-CIxyatuB.d.ts

@@ -0,0 +1,174 @@
+import { T as RawDbError } from "./result-Cj3yWhjH.js";
+import { B as TableMeta } from "./types-BO8lVTun.js";
+import { r as Executor, v as Operation } from "./executor-BicyP8Nl.js";
+//#region src/compile/sqlite.d.ts
+/** A value SQLite binds: booleans become `0`/`1`, objects JSON text. */
+type SqliteValue = string | number | bigint | null;
+interface SqliteQuery {
+  readonly text: string;
+  readonly params: readonly SqliteValue[];
+}
+/** How the executor turns a returned SQLite value back into its PostgREST shape. */
+type SqliteDecode = "boolean" | "json" | "timestamptz" | "raw";
+interface SqliteColumn {
+  /** Key in the returned row. */
+  readonly alias: string;
+  readonly decode: SqliteDecode;
+}
+/** Primary key values of the rows a write touches, in key column order. */
+type SqliteKeys = readonly (readonly SqliteValue[])[];
+/** A read: the rows, a count, or both. */
+interface SqliteSelectPlan {
+  readonly kind: "select";
+  readonly rows: SqliteQuery | undefined;
+  readonly count: SqliteQuery | undefined;
+  readonly columns: readonly SqliteColumn[];
+}
+/**
+ * An insert as one statement per row. PowerSync tables are views with
+ * `INSTEAD OF` triggers, which take neither `RETURNING` nor `ON CONFLICT`,
+ * so the executor checks for a conflicting row itself and reads the
+ * written rows back by key.
+ */
+interface SqliteInsertPlan {
+  readonly kind: "insert";
+  readonly rows: readonly {
+    readonly key: readonly SqliteValue[];
+    /** The row's tenant; an upsert never updates another tenant's row. */
+    readonly tenant: SqliteValue | undefined;
+    readonly insert: SqliteQuery;
+    /** Finds a row that conflicts on the `onConflict` columns. */
+    readonly existing: SqliteQuery | undefined;
+    /** Updates the conflicting row (`onConflict.action: 'update'`), by its key. */
+    readonly update: ((key: readonly SqliteValue[]) => SqliteQuery) | undefined;
+  }[];
+  readonly conflict: "update" | "ignore" | undefined;
+  readonly returning: SqliteReturning | undefined;
+}
+/** An update or delete: select the keys, then write by key. */
+interface SqliteKeyedPlan {
+  readonly kind: "update" | "delete";
+  readonly keys: SqliteQuery;
+  readonly apply: (keys: SqliteKeys) => SqliteQuery;
+  readonly returning: SqliteReturning | undefined;
+  /** More selected keys than this fails with `max_affected` before any write. */
+  readonly maxAffected?: number;
+}
+interface SqliteReturning {
+  readonly read: (keys: SqliteKeys) => SqliteQuery;
+  readonly columns: readonly SqliteColumn[];
+}
+type SqlitePlan = {
+  readonly kind: "never";
+} | SqliteSelectPlan | SqliteInsertPlan | SqliteKeyedPlan;
+interface SqliteCompilerOptions {
+  /**
+   * The SQLite table or view for a table. Defaults to its database name
+   * without the schema, which is how PowerSync names its views.
+   */
+  readonly tableName?: (table: TableMeta) => string;
+}
+declare function quoteSqliteIdent(name: string): string;
+/** A JavaScript value as a SQLite parameter. */
+declare function sqliteValue(value: unknown): SqliteValue;
+/**
+ * A LIKE pattern (backslash escapes) as a GLOB pattern, which SQLite
+ * matches case-sensitively, like Postgres `like`.
+ */
+declare function likeToGlob(pattern: string): string;
+/**
+ * Compiles IR operations for SQLite (PowerSync's local database). Reads
+ * become one statement; writes become steps the executor runs in a write
+ * transaction. Throws a `DbException` with kind `unsupported` for what
+ * SQLite can't express, before anything runs.
+ */
+declare function compileSqlite(op: Operation, options?: SqliteCompilerOptions): SqlitePlan;
+//#endregion
+//#region src/sqlite/executor.d.ts
+/** What a SQLite database, transaction or lock context can run. */
+interface SqliteContextLike {
+  getAll<T>(sql: string, parameters?: unknown[]): Promise<T[]>;
+  execute(sql: string, parameters?: unknown[]): Promise<unknown>;
+}
+/** What a SQLite database the executor can run on provides: reads, writes and write transactions. */
+interface SqliteDatabaseLike extends SqliteContextLike {
+  writeTransaction<T>(callback: (tx: SqliteContextLike) => Promise<T>): Promise<T>;
+  /** Runs a list's rows and its count on one snapshot when present. */
+  readTransaction?<T>(callback: (tx: SqliteContextLike) => Promise<T>): Promise<T>;
+}
+interface SqliteExecutorOptions extends SqliteCompilerOptions {
+  /**
+   * A primary key for an insert that leaves it out. Offline-first tables key on
+   * a text `id` that the client creates. Defaults to
+   * `crypto.randomUUID()`, else SQLite's `uuid()`.
+   */
+  readonly newId?: (table: TableMeta) => string | Promise<string>;
+  /**
+   * Runs what SQLite can't, usually `postgrestExecutor(supabase)`: reads
+   * that compile to `unsupported` (includes, full-text search, function
+   * sources) and `db.$rpc`. Writes never fall back, so the upload
+   * queue stays the only write path. Offline, the fallback's error comes back.
+   */
+  readonly fallback?: Executor;
+}
+/**
+ * A SQLite constraint error in the shape `mapDbError` reads from Postgres:
+ * its SQLSTATE, and the columns in Postgres's `Key (...)` detail format.
+ */
+declare function fromSqliteError(cause: unknown): RawDbError | undefined;
+/**
+ * Timestamp text as PostgREST sends it (`2026-01-02T10:00:00.5+00:00`), from
+ * whatever the sync wrote (`2026-01-02 10:00:00.500000Z`).
+ */
+declare function postgrestTimestamp(value: string): string;
+//#endregion
+//#region src/powersync/executor.d.ts
+/**
+ * The part of `PowerSyncDatabase` (`@powersync/react-native`,
+ * `@powersync/web`, `@powersync/node`) the executor uses. Typed by shape,
+ * so better-supabase doesn't depend on PowerSync.
+ */
+interface PowerSyncDatabaseLike extends SqliteDatabaseLike {
+  onChange?(handler: {
+    onChange: (event: {
+      changedTables: string[];
+    }) => Promise<void> | void;
+  }, options?: {
+    tables?: string[];
+    throttleMs?: number;
+    signal?: AbortSignal;
+  }): () => void;
+  /** The sync status `watch`'s `refresh` reads to skip runs while offline. */
+  readonly currentStatus?: {
+    readonly connected: boolean;
+  };
+  /** Status updates; `watch`'s `refresh.onReconnect` listens to them. */
+  registerListener?(listener: {
+    statusChanged?: (status: {
+      readonly connected: boolean;
+    }) => void;
+  }): () => void;
+}
+type PowerSyncExecutorOptions = SqliteExecutorOptions;
+/**
+ * Runs repository operations on PowerSync's local SQLite database, so the
+ * same repositories and list definitions work offline on native. Reads
+ * return rows in the PostgREST shape (booleans, parsed JSON, ISO
+ * timestamps); writes go through PowerSync's upload queue. What SQLite
+ * can't express (includes, full-text search, function sources) and
+ * `db.$rpc` return a `DbError` of kind `unsupported` without running
+ * anything, or run on `options.fallback` when you pass one.
+ * `maxAffected` is checked against the selected keys before any write; a
+ * call's `timeout` and `signal` are checked before the statements start,
+ * and `retry` does nothing here. A `bigint` beyond `Number.MAX_SAFE_INTEGER`
+ * comes back as its decimal string instead of a rounded number.
+ *
+ * ```ts
+ * const db = betterSupabase.connect(
+ *   powersyncExecutor(powersync, { fallback: postgrestExecutor(supabase) }),
+ * );
+ * ```
+ */
+declare function powersyncExecutor(db: PowerSyncDatabaseLike, options?: PowerSyncExecutorOptions): Executor;
+//#endregion
+export { SqliteValue as _, fromSqliteError as a, quoteSqliteIdent as b, SqliteCompilerOptions as c, SqliteKeyedPlan as d, SqliteKeys as f, SqliteSelectPlan as g, SqliteReturning as h, SqliteContextLike as i, SqliteDecode as l, SqliteQuery as m, PowerSyncExecutorOptions as n, postgrestTimestamp as o, SqlitePlan as p, powersyncExecutor as r, SqliteColumn as s, PowerSyncDatabaseLike as t, SqliteInsertPlan as u, compileSqlite as v, sqliteValue as x, likeToGlob as y };