better-supabase 0.11.0 → 0.13.0

package/dist/ports-CM3aG3zn.js

@@ -0,0 +1,137 @@
+import { a as ok, r as err, t as AsyncResult } from "./result-DIT_qp4G.js";
+import { n as decodeJwtPayload } from "./base64-B9Wlsdj7.js";
+import { i as userContext } from "./impersonation-DFfDVJHk.js";
+import { t as hasAuthModule } from "./auth-module-CwCIY97x.js";
+import { n as identityKey } from "./user-change-CSR_prhd.js";
+import { n as createQueries } from "./query-DgPYlU82.js";
+import { t as fromStorageError } from "./errors-Cq72lONT.js";
+//#region src/client/bind.ts
+const LOADING = {
+	status: "loading",
+	user: null,
+	claims: null
+};
+const SIGNED_OUT = {
+	status: "signed-out",
+	user: null,
+	claims: null
+};
+/**
+* `session.user`, or `undefined` when auth-js put its placeholder there: with
+* `tokens-only` cookies and no user in `userStorage`, reading `id` throws.
+*/
+function storedUser(session) {
+	try {
+		return typeof session.user.id === "string" ? session.user : void 0;
+	} catch {
+		return;
+	}
+}
+const text = (value) => typeof value === "string" && value !== "" ? value : void 0;
+function snapshotOf(session) {
+	if (!session) return SIGNED_OUT;
+	const claims = decodeJwtPayload(session.access_token) ?? {};
+	const stored = storedUser(session);
+	const id = text(claims["sub"]) ?? stored?.id;
+	if (id === void 0) return SIGNED_OUT;
+	const email = text(claims["email"]) ?? text(stored?.email);
+	const role = text(claims["role"]) ?? text(stored?.role);
+	return {
+		status: "signed-in",
+		user: {
+			id,
+			...email ? { email } : {},
+			...role ? { role } : {}
+		},
+		claims
+	};
+}
+function contextOf(snapshot) {
+	if (snapshot.status !== "signed-in") return {
+		actor: {
+			id: "anon",
+			kind: "anon",
+			role: "anon"
+		},
+		claims: { role: "anon" }
+	};
+	return userContext(snapshot.user, snapshot.claims);
+}
+/**
+* Repositories that follow `supabase`'s session, TanStack Query options and an
+* auth store, for a supabase-js client you created yourself.
+*/
+function bindClient(betterSupabase, supabase, options = {}) {
+	let snapshot = LOADING;
+	let db;
+	const listeners = /* @__PURE__ */ new Set();
+	const followsAuth = hasAuthModule(supabase);
+	if (!followsAuth) snapshot = snapshotOf(null);
+	const onChange = (_event, session) => {
+		const next = snapshotOf(session);
+		if (next.status === snapshot.status && identityKey(next) === identityKey(snapshot)) return;
+		snapshot = next;
+		db = void 0;
+		for (const listener of listeners) listener();
+	};
+	const subscription = followsAuth ? supabase.auth.onAuthStateChange(onChange) : void 0;
+	const client = {
+		betterSupabase,
+		supabase,
+		ports: options.ports ?? {},
+		get db() {
+			db ??= betterSupabase.connect(supabase, contextOf(snapshot));
+			return db;
+		},
+		queries: createQueries(betterSupabase, () => client.db, options.staleTime === void 0 ? {} : { staleTime: options.staleTime }),
+		dispose: () => {
+			subscription?.data.subscription.unsubscribe();
+			listeners.clear();
+		},
+		auth: {
+			current: () => snapshot,
+			subscribe: (listener) => {
+				listeners.add(listener);
+				return () => {
+					listeners.delete(listener);
+				};
+			}
+		}
+	};
+	return client;
+}
+//#endregion
+//#region src/client/ports.ts
+/** A storage port that keeps values in memory, for tests and server renders. */
+function memoryStorage(initial = {}) {
+	const values = new Map(Object.entries(initial));
+	return {
+		get: (key) => Promise.resolve(values.get(key) ?? null),
+		set: (key, value) => {
+			values.set(key, value);
+			return Promise.resolve();
+		},
+		remove: (key) => {
+			values.delete(key);
+			return Promise.resolve();
+		}
+	};
+}
+/** The upload port over Supabase Storage, for web and native picked files alike. */
+function storageUpload(supabase) {
+	return (file, to) => AsyncResult.from(async () => {
+		try {
+			const body = await file.read();
+			const { data, error } = await supabase.storage.from(to.bucket).upload(to.path, body, {
+				...file.type === void 0 ? {} : { contentType: file.type },
+				...to.upsert === void 0 ? {} : { upsert: to.upsert }
+			});
+			if (error) return err(fromStorageError(error, to.bucket));
+			return ok({ path: data.path });
+		} catch (cause) {
+			return err(fromStorageError(cause, to.bucket));
+		}
+	});
+}
+//#endregion
+export { storageUpload as n, bindClient as r, memoryStorage as t };

package/dist/ports-n3ZWSS_I.d.ts

@@ -0,0 +1,89 @@
+import { t as AsyncResult } from "./result-mijqfoJN.js";
+import { n as TopicPort } from "./watch-topic-CloXeDTO.js";
+import { SupabaseClient } from "@supabase/supabase-js";
+//#region src/client/ports.d.ts
+/**
+ * A string store: `localStorage` on the web (`webStorage()`), AsyncStorage,
+ * MMKV or SecureStore on React Native (`nativeStorage()`).
+ */
+interface StoragePort {
+  readonly get: (key: string) => Promise<string | null>;
+  readonly set: (key: string, value: string) => Promise<void>;
+  readonly remove: (key: string) => Promise<void>;
+}
+/** A key combination. `mod` is Cmd on macOS and Ctrl elsewhere. */
+interface Shortcut {
+  readonly key: string;
+  readonly mod?: boolean;
+  readonly shift?: boolean;
+  readonly alt?: boolean;
+}
+/** Runs `run` on each press of `shortcut` until the returned function is called. */
+type KeyboardPort = (shortcut: Shortcut, run: () => void) => () => void;
+/** A file the user picked, readable on every platform. */
+interface PickedFile {
+  readonly name: string;
+  /** The MIME type, when the platform reports one. */
+  readonly type: string | undefined;
+  readonly size: number | undefined;
+  /** The local URI on React Native; `undefined` on the web. */
+  readonly uri: string | undefined;
+  /** The bytes: a `Blob` on the web, an `ArrayBuffer` on React Native. */
+  readonly read: () => Promise<Blob | ArrayBuffer>;
+}
+interface PickFilesOptions {
+  /** MIME types or extensions, such as `image/*` or `.pdf`. */
+  readonly accept?: readonly string[];
+  readonly multiple?: boolean;
+}
+/**
+ * Opens the platform's file picker; resolves with no files when the user
+ * cancels.
+ */
+type FilePickerPort = (options?: PickFilesOptions) => Promise<readonly PickedFile[]>;
+interface UploadDestination {
+  readonly bucket: string;
+  readonly path: string;
+  readonly upsert?: boolean;
+}
+/** Uploads a picked file and resolves with its stored path. */
+type UploadPort = (file: PickedFile, to: UploadDestination) => AsyncResult<{
+  readonly path: string;
+}>;
+/** The device's push token for the platform's push service. */
+interface PushTokenPort {
+  /** The push provider the token belongs to, such as `expo` or `webpush`. */
+  readonly provider: string;
+  /**
+   * The token, asking for permission first unless `request` is false. Resolves
+   * with `null` when the user denies it or the platform has none.
+   */
+  readonly token: (options?: {
+    readonly request?: boolean;
+  }) => Promise<string | null>;
+}
+/** The URL the app opened with, and the ones it opens later. */
+interface DeepLinkPort {
+  readonly initial: () => Promise<string | null>;
+  readonly subscribe: (listener: (url: string) => void) => () => void;
+}
+/**
+ * The platform services block controllers use. `createClient` from
+ * `better-supabase/client` fills the web ports, and `nativePorts()` from
+ * `better-supabase/client/native` the React Native ones.
+ */
+interface ClientPorts {
+  readonly topic?: TopicPort;
+  readonly storage?: StoragePort;
+  readonly keyboard?: KeyboardPort;
+  readonly files?: FilePickerPort;
+  readonly upload?: UploadPort;
+  readonly push?: PushTokenPort;
+  readonly links?: DeepLinkPort;
+}
+/** A storage port that keeps values in memory, for tests and server renders. */
+declare function memoryStorage(initial?: Readonly<Record<string, string>>): StoragePort;
+/** The upload port over Supabase Storage, for web and native picked files alike. */
+declare function storageUpload(supabase: Pick<SupabaseClient, "storage">): UploadPort;
+//#endregion
+export { PickFilesOptions as a, Shortcut as c, UploadPort as d, memoryStorage as f, KeyboardPort as i, StoragePort as l, DeepLinkPort as n, PickedFile as o, storageUpload as p, FilePickerPort as r, PushTokenPort as s, ClientPorts as t, UploadDestination as u };

package/dist/postgres/index.d.ts

@@ -1,10 +1,10 @@
-import { E as RawDbError } from "../result-BREt7qOh.js";
-import { v as Operation } from "../executor-BnMC0lj3.js";
-import { n as SqlClient, r as postgresExecutor, t as PostgresExecutorOptions } from "../executor-D1hECPGG.js";
-import { a as PostgresTimeouts, c as createPostgres, i as PostgresOptions, n as PgPool, o as SessionOptions, r as PgPoolClient, s as SqlClaims, t as BetterPostgres } from "../pool-cM3rpOQr.js";
-import { t as Compiler } from "../compiler-D_Gjpw_O.js";
+import { E as RawDbError } from "../result-mijqfoJN.js";
+import { v as Operation } from "../executor-C29668fO.js";
+import { n as SqlClient, r as postgresExecutor, t as PostgresExecutorOptions } from "../executor-DXfgDsKd.js";
+import { a as PostgresTimeouts, c as createPostgres, i as PostgresOptions, n as PgPool, o as SessionOptions, r as PgPoolClient, s as SqlClaims, t as BetterPostgres } from "../pool-Bu8zXGzI.js";
+import { t as Compiler } from "../compiler-DCotQWcs.js";
 //#region src/postgres/pg-error.d.ts
-/** node-postgres error fields to the shape `mapDbError` reads. */
+/** Node-postgres error fields to the shape `mapDbError` reads. */
 export declare function fromPgError(error: unknown): RawDbError | undefined;
 //#endregion
 //#region src/compile/sql.d.ts
@@ -13,9 +13,9 @@ interface SqlQuery {
   readonly params: readonly unknown[];
 }
 /**
- * The SQL for one operation. `rows` returns a `row` json column per result
- * row; `count` returns one `count` column. Either may be absent: a HEAD read
- * only counts, a filter that can never match runs nothing.
+ * The SQL for one operation. `rows` returns a `row` json column per result row;
+ * `count` returns one `count` column. Either may be absent: a HEAD read only
+ * counts, a filter that can never match runs nothing.
  */
 interface SqlPlan {
   readonly rows: SqlQuery | undefined;
@@ -28,20 +28,20 @@ interface SqlPlan {
    */
   readonly chunks?: readonly SqlPlan[];
   /**
-   * `explain (format json)` of the counted rows, for a `planned` or
-   * `estimated` count. The executor reads the top node's `Plan Rows`.
+   * `explain (format json)` of the counted rows, for a `planned` or `estimated`
+   * count. The executor reads the top node's `Plan Rows`.
    */
   readonly plannedCount?: SqlQuery;
   /**
-   * Set for an `estimated` count: `count` stops at this many rows plus one,
-   * and above it the executor answers with the planner's estimate.
+   * Set for an `estimated` count: `count` stops at this many rows plus one, and
+   * above it the executor answers with the planner's estimate.
    */
   readonly countThreshold?: number;
 }
 interface CompileSqlOptions {
   /**
-   * Where an `estimated` count switches from exact to planned, like
-   * PostgREST's `db-max-rows`. Defaults to 1000, Supabase's `max_rows`.
+   * Where an `estimated` count switches from exact to planned, like PostgREST's
+   * `db-max-rows`. Defaults to 1000, Supabase's `max_rows`.
    */
   readonly estimatedCountThreshold?: number;
 }

package/dist/postgres/index.js

@@ -1,7 +1,7 @@
-import { n as quoteIdent, t as compileSql } from "../sql-BPKRNutj.js";
-import { t as fromPgError } from "../pg-error-BV_X8Isq.js";
-import { t as postgresExecutor } from "../executor-CxGQiQN_.js";
-import { t as watchPoolErrors } from "../pool-errors-CGqvTQOC.js";
+import { n as quoteIdent, t as compileSql } from "../sql-CQIikLnQ.js";
+import { t as fromPgError } from "../pg-error-B5QLDcbG.js";
+import { t as postgresExecutor } from "../executor-C5uyGttm.js";
+import { t as watchPoolErrors } from "../pool-errors-DOZ3oDeS.js";
 import { Pool } from "pg";
 //#region src/postgres/pool.ts
 /** Supabase sets no idle-in-transaction timeout; 15 s frees a stuck connection. */
@@ -40,8 +40,8 @@ function checkSettings(settings = {}) {
 /**
 * A pooled Postgres connection for jobs, scripts and tests. Each query (or
 * transaction) runs in its own transaction; claims and role are
-* transaction-local, so nothing leaks back into the pool. An `admin` query
-* with no timeout to set runs on its own, without `begin` and `commit`.
+* transaction-local, so nothing leaks back into the pool. An `admin` query with
+* no timeout to set runs on its own, without `begin` and `commit`.
 */
 function createPostgres(options = {}) {
 	const pool = options.pool ?? openPool(options);
@@ -69,14 +69,20 @@ function createPostgres(options = {}) {
 		})], ["role", session.role]);
 		return settings;
 	}
-	/** Opens the transaction, then sets the timeouts, claims and role in one round trip. */
+	/**
+	* Opens the transaction, then sets the timeouts, claims and role in one round
+	* trip.
+	*/
 	async function begin(client, session, settings) {
 		await client.query(session.readOnly ? "begin read only" : "begin");
 		const all = idleInTransaction > 0 ? [...settings, ["idle_in_transaction_session_timeout", String(idleInTransaction)]] : settings;
 		if (all.length === 0) return;
 		await client.query(`select ${all.map((_, index) => `set_config($${index * 2 + 1}, $${index * 2 + 2}, true)`).join(", ")}`, all.flat());
 	}
-	/** One statement on a pooled connection in autocommit, for sessions that set nothing. */
+	/**
+	* One statement on a pooled connection in autocommit, for sessions that set
+	* nothing.
+	*/
 	async function single(text, params) {
 		const client = await pool.connect();
 		try {

package/dist/postgrest-DGjrW4sK.d.ts

@@ -0,0 +1,53 @@
+import { v as Operation } from "./executor-C29668fO.js";
+//#region src/compile/postgrest.d.ts
+/**
+ * A compiled PostgREST request, expressed as calls on the public postgrest-js
+ * builder so it works with any supabase-js client.
+ */
+interface PostgrestPlan {
+  /** `select` parameter, or `undefined` for mutations without returning. */
+  readonly select: string | undefined;
+  readonly filters: readonly PlanFilter[];
+  readonly orders: readonly PlanOrder[];
+  readonly limits: readonly PlanLimit[];
+  readonly range: {
+    readonly from: number;
+    readonly to: number;
+  } | undefined;
+  /** The condition can never match; skip the request. */
+  readonly never: boolean;
+  /** `Prefer: max-affected` on an update or delete (PostgREST 13 and later). */
+  readonly maxAffected?: number;
+}
+interface PostgrestCompileOptions {
+  /**
+   * The PostgREST version the request goes to, from `postgrestVersion` in the
+   * config. `maxAffected` needs 13 or later; older versions fail with
+   * `invalid_request` before any request. Defaults to `"13"`.
+   */
+  readonly postgrestVersion?: string;
+}
+type PlanFilter = {
+  readonly kind: "filter";
+  readonly path: string;
+  readonly operator: string;
+  readonly value: string;
+} | {
+  readonly kind: "or";
+  readonly expression: string;
+  readonly referencedTable: string | undefined;
+};
+interface PlanOrder {
+  readonly column: string;
+  readonly ascending: boolean;
+  readonly nullsFirst: boolean | undefined;
+  readonly referencedTable: string | undefined;
+}
+interface PlanLimit {
+  readonly count: number;
+  readonly referencedTable: string | undefined;
+}
+/** Compiles an operation into a PostgREST plan. */
+declare function compilePostgrest(op: Operation, options?: PostgrestCompileOptions): PostgrestPlan;
+//#endregion
+export { PostgrestPlan as a, PostgrestCompileOptions as i, PlanLimit as n, compilePostgrest as o, PlanOrder as r, PlanFilter as t };

package/dist/powersync/index.d.ts

@@ -1,7 +1,7 @@
-import { t as AuthSnapshot } from "../bind-CTNKpBM6.js";
-import { _ as SqliteValue, a as fromSqliteError, b as quoteSqliteIdent, c as SqliteCompilerOptions, d as SqliteKeyedPlan, f as SqliteKeys, g as SqliteSelectPlan, h as SqliteReturning, i as SqliteContextLike, l as SqliteDecode, m as SqliteQuery, n as PowerSyncExecutorOptions, o as postgrestTimestamp, p as SqlitePlan, r as powersyncExecutor, s as SqliteColumn, t as PowerSyncDatabaseLike, u as SqliteInsertPlan, v as compileSqlite, x as sqliteValue, y as likeToGlob } from "../executor-CvsNcQsa.js";
-import { a as checkSqlite, i as CheckSqliteOptions, n as sqliteTables, o as sqliteCompiler, r as watch, t as WatchOptions } from "../watch-ry70AEm6.js";
-import { a as UploadConnector, c as UploadRepository, d as uploadOutcome, i as RejectedStore, l as UploadRoute, n as CrudQueueLike, o as UploadConnectorOptions, r as RejectedChange, s as UploadOutcome, t as CrudEntryLike, u as createUploadConnector } from "../connector-D9NMNkv0.js";
+import { t as AuthSnapshot } from "../bind-DcXLU1ul.js";
+import { _ as SqliteValue, a as fromSqliteError, b as quoteSqliteIdent, c as SqliteCompilerOptions, d as SqliteKeyedPlan, f as SqliteKeys, g as SqliteSelectPlan, h as SqliteReturning, i as SqliteContextLike, l as SqliteDecode, m as SqliteQuery, n as PowerSyncExecutorOptions, o as postgrestTimestamp, p as SqlitePlan, r as powersyncExecutor, s as SqliteColumn, t as PowerSyncDatabaseLike, u as SqliteInsertPlan, v as compileSqlite, x as sqliteValue, y as likeToGlob } from "../executor-D_viYkhf.js";
+import { a as checkSqlite, i as CheckSqliteOptions, n as sqliteTables, o as sqliteCompiler, r as watch, t as WatchOptions } from "../watch-CYeMXFtj.js";
+import { a as UploadConnector, c as UploadRepository, d as uploadOutcome, i as RejectedStore, l as UploadRoute, n as CrudQueueLike, o as UploadConnectorOptions, r as RejectedChange, s as UploadOutcome, t as CrudEntryLike, u as createUploadConnector } from "../connector-CKcTPJRV.js";
 //#region src/powersync/auth.d.ts
 /** The part of a PowerSync database `syncWithAuth` drives. */
 interface SyncedDatabaseLike<C> {
@@ -18,21 +18,20 @@ interface SyncWithAuthOptions<C> {
   /** The connector, e.g. `createUploadConnector(...)`. */
   readonly connector: C;
   /**
-   * Clears the local database on sign-out and when another user signs in,
-   * so one user never reads another's rows. Unsynced changes are lost.
-   * Defaults to true.
+   * Clears the local database on sign-out and when another user signs in, so
+   * one user never reads another's rows. Unsynced changes are lost. Defaults to
+   * true.
    */
   readonly clearOnSignOut?: boolean;
   /** Called after each connect, disconnect or clear fails. */
   readonly onError?: (cause: unknown) => void;
 }
 /**
- * Syncs while a user is signed in: connects on sign-in, and on sign-out
- * (or a different user) disconnects and clears the local database. An app
- * that starts signed out clears it too, since the rows may belong to a user
- * whose session ended while the app was closed. Steps
- * run one at a time in order. Returns a function that stops following the
- * session and disconnects.
+ * Syncs while a user is signed in: connects on sign-in, and on sign-out (or a
+ * different user) disconnects and clears the local database. An app that starts
+ * signed out clears it too, since the rows may belong to a user whose session
+ * ended while the app was closed. Steps run one at a time in order. Returns a
+ * function that stops following the session and disconnects.
  *
  * ```ts
  * useEffect(() => syncWithAuth(powersync, bs.auth, { connector }), []);

package/dist/powersync/index.js

@@ -1,15 +1,14 @@
-import { n as dbError } from "../errors-BV1SKTVs.js";
-import { r as err } from "../result-DIeYscA3.js";
-import { n as watch, t as sqliteTables } from "../watch-BAuIzC2r.js";
-import { a as sqliteCompiler, c as quoteSqliteIdent, i as checkSqlite, l as sqliteValue, n as fromSqliteError, o as compileSqlite, r as postgrestTimestamp, s as likeToGlob, t as powersyncExecutor } from "../executor-BiB0wMBA.js";
+import { n as dbError } from "../errors-D7u24ZJH.js";
+import { r as err } from "../result-DIT_qp4G.js";
+import { n as watch, t as sqliteTables } from "../watch-Cnd6XDnU.js";
+import { a as sqliteCompiler, c as quoteSqliteIdent, i as checkSqlite, l as sqliteValue, n as fromSqliteError, o as compileSqlite, r as postgrestTimestamp, s as likeToGlob, t as powersyncExecutor } from "../executor-DK2F9Zis.js";
 //#region src/powersync/auth.ts
 /**
-* Syncs while a user is signed in: connects on sign-in, and on sign-out
-* (or a different user) disconnects and clears the local database. An app
-* that starts signed out clears it too, since the rows may belong to a user
-* whose session ended while the app was closed. Steps
-* run one at a time in order. Returns a function that stops following the
-* session and disconnects.
+* Syncs while a user is signed in: connects on sign-in, and on sign-out (or a
+* different user) disconnects and clears the local database. An app that starts
+* signed out clears it too, since the rows may belong to a user whose session
+* ended while the app was closed. Steps run one at a time in order. Returns a
+* function that stops following the session and disconnects.
 *
 * ```ts
 * useEffect(() => syncWithAuth(powersync, bs.auth, { connector }), []);
@@ -74,9 +73,9 @@ const OUTCOMES = {
 	unsupported: "discard"
 };
 /**
-* The default for a failed upload: transient errors retry, a newer server
-* row is a conflict, and a change the server will never accept is
-* discarded so it doesn't block the queue.
+* The default for a failed upload: transient errors retry, a newer server row
+* is a conflict, and a change the server will never accept is discarded so it
+* doesn't block the queue.
 */
 function uploadOutcome(kind) {
 	return OUTCOMES[kind];
@@ -119,12 +118,12 @@ function replay(route, entry) {
 }
 /**
 * A PowerSync connector that authenticates with the Supabase session and
-* replays queued changes through repositories. Changes upload in batches;
-* a transient error keeps the batch queued for PowerSync's retry, and
-* refused changes land in `rejected` instead of blocking the queue. A table
-* without a route stops the upload with an error, so no change is dropped
-* silently. When the session is gone (the refresh token was revoked), the
-* upload stops until the user signs in again.
+* replays queued changes through repositories. Changes upload in batches; a
+* transient error keeps the batch queued for PowerSync's retry, and refused
+* changes land in `rejected` instead of blocking the queue. A table without a
+* route stops the upload with an error, so no change is dropped silently. When
+* the session is gone (the refresh token was revoked), the upload stops until
+* the user signs in again.
 *
 * ```ts
 * const connector = createUploadConnector({

package/dist/powersync/react/index.d.ts

@@ -1,6 +1,6 @@
-import { b as DbError, f as Result } from "../../result-BREt7qOh.js";
-import { t as PowerSyncDatabaseLike } from "../../executor-CvsNcQsa.js";
-import { i as RejectedStore, r as RejectedChange } from "../../connector-D9NMNkv0.js";
+import { b as DbError, f as Result } from "../../result-mijqfoJN.js";
+import { t as PowerSyncDatabaseLike } from "../../executor-D_viYkhf.js";
+import { i as RejectedStore, r as RejectedChange } from "../../connector-CKcTPJRV.js";
 //#region src/powersync/react/index.d.ts
 export interface UseWatchOptions<T> {
   readonly db: PowerSyncDatabaseLike;
@@ -27,14 +27,15 @@ export interface WatchState<T> {
   readonly loading: boolean;
 }
 /**
- * A live repository call over PowerSync's SQLite database: reruns when
- * one of `tables` changes, keeps unchanged rows' identity, and restarts
- * when `deps` change.
+ * A live repository call over PowerSync's SQLite database: reruns when one of
+ * `tables` changes, keeps unchanged rows' identity, and restarts when `deps`
+ * change.
  *
  * ```tsx
  * const { data, loading } = useWatch({
  *   db: powersync,
- *   query: () => customerList.run(local, { ...customerList.defaults, search }),
+ *   query: () =>
+ *     customerList.run(local, { ...customerList.defaults, search }),
  *   tables,
  *   deps: [search],
  * });
@@ -70,8 +71,8 @@ export interface SyncState {
   readonly error: Error | undefined;
 }
 /**
- * PowerSync's connection and sync progress, for a status badge or a
- * "syncing" banner. Re-renders only when one of the fields changes.
+ * PowerSync's connection and sync progress, for a status badge or a "syncing"
+ * banner. Re-renders only when one of the fields changes.
  */
 export declare function useSyncStatus(db: SyncStatusSource): SyncState;
 export interface Conflicts {
@@ -81,9 +82,9 @@ export interface Conflicts {
   readonly dismiss: (change?: RejectedChange) => void;
 }
 /**
- * The changes `createUploadConnector` could not upload: conflicts with a
- * newer server row and changes the server refused. Show them next to the
- * row, then `dismiss` them.
+ * The changes `createUploadConnector` could not upload: conflicts with a newer
+ * server row and changes the server refused. Show them next to the row, then
+ * `dismiss` them.
  */
 export declare function useConflicts(connector: {
   readonly rejected: RejectedStore;

package/dist/powersync/react/index.js

@@ -1,16 +1,17 @@
 "use client";
-import { n as watch } from "../../watch-BAuIzC2r.js";
+import { n as watch } from "../../watch-Cnd6XDnU.js";
 import { useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 //#region src/powersync/react/index.ts
 /**
-* A live repository call over PowerSync's SQLite database: reruns when
-* one of `tables` changes, keeps unchanged rows' identity, and restarts
-* when `deps` change.
+* A live repository call over PowerSync's SQLite database: reruns when one of
+* `tables` changes, keeps unchanged rows' identity, and restarts when `deps`
+* change.
 *
 * ```tsx
 * const { data, loading } = useWatch({
 *   db: powersync,
-*   query: () => customerList.run(local, { ...customerList.defaults, search }),
+*   query: () =>
+*     customerList.run(local, { ...customerList.defaults, search }),
 *   tables,
 *   deps: [search],
 * });
@@ -81,14 +82,17 @@ function sameState(a, b) {
 	return a.connected === b.connected && a.connecting === b.connecting && a.hasSynced === b.hasSynced && a.uploading === b.uploading && a.downloading === b.downloading && a.error === b.error;
 }
 /**
-* PowerSync's connection and sync progress, for a status badge or a
-* "syncing" banner. Re-renders only when one of the fields changes.
+* PowerSync's connection and sync progress, for a status badge or a "syncing"
+* banner. Re-renders only when one of the fields changes.
 */
 function useSyncStatus(db) {
 	const store = useMemo(() => statusStore(db), [db]);
 	return useSyncExternalStore(store.subscribe, store.read, store.read);
 }
-/** Keeps the last snapshot while its fields stay equal, as `useSyncExternalStore` needs. */
+/**
+* Keeps the last snapshot while its fields stay equal, as
+* `useSyncExternalStore` needs.
+*/
 function statusStore(db) {
 	let snapshot = stateOf(db.currentStatus);
 	return {
@@ -101,9 +105,9 @@ function statusStore(db) {
 	};
 }
 /**
-* The changes `createUploadConnector` could not upload: conflicts with a
-* newer server row and changes the server refused. Show them next to the
-* row, then `dismiss` them.
+* The changes `createUploadConnector` could not upload: conflicts with a newer
+* server row and changes the server refused. Show them next to the row, then
+* `dismiss` them.
 */
 function useConflicts(connector) {
 	const { rejected } = connector;

package/dist/preset/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as PRESET_FRAMEWORKS, G as PRESET_GROUPS, J as PresetName, K as PRESET_NAMES, Q as PRESET_FIELDS, U as NamedPreset, W as PRESETS, X as namedPreset, Y as isPresetName, Z as DEFAULT_CONVENTIONS, at as PresetConventions, bn as AppColumnFormat, ct as PresetFieldValue, dt as PresetScope, et as PRESET_TENANT_NAMES, gt as presetValueLabel, ht as presetField, lt as PresetFramework, mt as integrationsForFramework, nt as Preset, ot as PresetField, pn as APP_COLUMN_FORMATS, pt as PresetValueInfo, q as PresetGroup, rt as PresetAccess, st as PresetFieldKey, tt as PRESET_VERSION, ut as PresetPlatforms } from "../codegen-C64C0NZG.js";
-import { A as presetConfig, B as decodePreset, C as designOf, D as PresetInput, E as ConfigConventions, F as ResolvedPresetBlock, G as PresetCatalog, H as isPresetCode, I as listNames, J as PresetGlueItem, K as PresetCatalogBlock, L as presetBlockConflict, M as PresetConflict, N as PresetIntegration, O as conventionConfig, P as ResolvedPreset, R as resolvePreset, S as designInstallCommand, T as isDesignCode, U as withPresetField, V as encodePreset, W as PRESET_CATALOG, Y as PRESET_BLOCKS, _ as decodeDesign, a as presetConfigSource, b as designConfigSource, c as DesignChange, d as diffAppTables, f as diffDesigns, g as MAX_DESIGN_CODE_LENGTH, h as DesignTooLongError, i as presetBlocksSource, j as presetOf, k as expandPreset, l as DesignChangeKind, m as DESIGN_FORMAT, n as glueCommand, o as presetGlue, p as CreateDesign, q as PresetCatalogManifest, r as presetApplyCommand, s as presetInstallCommand, t as PROVIDER_COMMENT, u as DiffOptions, v as designApplyCommand, w as encodeDesign, x as designFormat, y as designConfig, z as DecodedPreset } from "../index-D8yhOz_4.js";
-import { a as appReservedColumns, i as appNameLengthError, n as appDefaultError, r as appIdentifierError, s as isAppDefault, t as APP_NAME_MAX } from "../app-tables-BrMBjyuq.js";
-export { APP_COLUMN_FORMATS, APP_NAME_MAX, type AppColumnFormat, type ConfigConventions, type CreateDesign, DEFAULT_CONVENTIONS, DESIGN_FORMAT, type DecodedPreset, type DesignChange, type DesignChangeKind, DesignTooLongError, type DiffOptions, MAX_DESIGN_CODE_LENGTH, type NamedPreset, PRESETS, PRESET_BLOCKS, PRESET_CATALOG, PRESET_FIELDS, PRESET_FRAMEWORKS, PRESET_GROUPS, PRESET_NAMES, PRESET_TENANT_NAMES, PRESET_VERSION, PROVIDER_COMMENT, type Preset, type PresetAccess, type PresetCatalog, type PresetCatalogBlock, type PresetCatalogManifest, type PresetConflict, type PresetConventions, type PresetField, type PresetFieldKey, type PresetFieldValue, type PresetFramework, type PresetGlueItem, type PresetGroup, type PresetInput, type PresetIntegration, type PresetName, type PresetPlatforms, type PresetScope, type PresetValueInfo, type ResolvedPreset, type ResolvedPresetBlock, appDefaultError, appIdentifierError, appNameLengthError, appReservedColumns, conventionConfig, decodeDesign, decodePreset, designApplyCommand, designConfig, designConfigSource, designFormat, designInstallCommand, designOf, diffAppTables, diffDesigns, encodeDesign, encodePreset, expandPreset, glueCommand, integrationsForFramework, isAppDefault, isDesignCode, isPresetCode, isPresetName, listNames, namedPreset, presetApplyCommand, presetBlockConflict, presetBlocksSource, presetConfig, presetConfigSource, presetField, presetGlue, presetInstallCommand, presetOf, presetValueLabel, resolvePreset, withPresetField };
+import { $ as namedPreset, Cn as AppColumnFormat, G as PRESETS, J as PresetGroup, K as PRESET_GROUPS, Q as isPresetName, U as DEFAULT_PRESET_NAME, W as NamedPreset, X as defaultPreset, Y as PresetName, Z as defaultPresetCode, _t as integrationsForFramework, at as Preset, ct as PresetConventions, dt as PresetFieldValue, et as DEFAULT_CONVENTIONS, ft as PresetFramework, gn as APP_COLUMN_FORMATS, gt as PresetValueInfo, it as PRESET_VERSION, lt as PresetField, mt as PresetScope, nt as PRESET_FRAMEWORKS, ot as PresetAccess, pt as PresetPlatforms, q as PRESET_NAMES, rt as PRESET_TENANT_NAMES, tt as PRESET_FIELDS, ut as PresetFieldKey, vt as presetField, yt as presetValueLabel } from "../codegen-DGtOsqz9.js";
+import { $ as encodePreset, A as designOf, B as conventionConfig, C as decodeDesign, D as designFileSource, E as designConfigSource, F as readDesignFile, G as PresetIntegration, H as presetConfig, I as safeDesignFileSource, J as listNames, K as ResolvedPreset, L as safeParseDesign, M as encodeDesign, N as isDesignCode, O as designFormat, P as parseDesign, Q as decodePreset, R as ConfigConventions, S as MAX_DESIGN_CODE_LENGTH, T as designConfig, U as presetOf, V as expandPreset, W as PresetConflict, X as resolvePreset, Y as presetBlockConflict, Z as DecodedPreset, _ as DesignFile, a as presetConfigSource, at as PresetCatalogManifest, b as DesignParseResult, c as DesignChange, d as diffAppTables, et as isPresetCode, f as diffDesigns, g as DesignErrorCode, h as DESIGN_FORMAT, i as presetBlocksSource, it as PresetCatalogBlock, j as designSchema, k as designInstallCommand, l as DesignChangeKind, m as DESIGN_FILE, n as glueCommand, nt as PRESET_CATALOG, o as presetGlue, ot as PresetGlueItem, p as CreateDesign, q as ResolvedPresetBlock, r as presetApplyCommand, rt as PresetCatalog, s as presetInstallCommand, st as PRESET_BLOCKS, t as PROVIDER_COMMENT, tt as withPresetField, u as DiffOptions, v as DesignParseError, w as designApplyCommand, x as DesignTooLongError, y as DesignParseIssue, z as PresetInput } from "../index-PADpaDku.js";
+import { a as appReservedColumns, i as appNameLengthError, n as appDefaultError, r as appIdentifierError, s as isAppDefault, t as APP_NAME_MAX } from "../app-tables-CbWUI7h_.js";
+export { APP_COLUMN_FORMATS, APP_NAME_MAX, type AppColumnFormat, type ConfigConventions, type CreateDesign, DEFAULT_CONVENTIONS, DEFAULT_PRESET_NAME, DESIGN_FILE, DESIGN_FORMAT, type DecodedPreset, type DesignChange, type DesignChangeKind, type DesignErrorCode, type DesignFile, DesignParseError, type DesignParseIssue, type DesignParseResult, DesignTooLongError, type DiffOptions, MAX_DESIGN_CODE_LENGTH, type NamedPreset, PRESETS, PRESET_BLOCKS, PRESET_CATALOG, PRESET_FIELDS, PRESET_FRAMEWORKS, PRESET_GROUPS, PRESET_NAMES, PRESET_TENANT_NAMES, PRESET_VERSION, PROVIDER_COMMENT, type Preset, type PresetAccess, type PresetCatalog, type PresetCatalogBlock, type PresetCatalogManifest, type PresetConflict, type PresetConventions, type PresetField, type PresetFieldKey, type PresetFieldValue, type PresetFramework, type PresetGlueItem, type PresetGroup, type PresetInput, type PresetIntegration, type PresetName, type PresetPlatforms, type PresetScope, type PresetValueInfo, type ResolvedPreset, type ResolvedPresetBlock, appDefaultError, appIdentifierError, appNameLengthError, appReservedColumns, conventionConfig, decodeDesign, decodePreset, defaultPreset, defaultPresetCode, designApplyCommand, designConfig, designConfigSource, designFileSource, designFormat, designInstallCommand, designOf, designSchema, diffAppTables, diffDesigns, encodeDesign, encodePreset, expandPreset, glueCommand, integrationsForFramework, isAppDefault, isDesignCode, isPresetCode, isPresetName, listNames, namedPreset, parseDesign, presetApplyCommand, presetBlockConflict, presetBlocksSource, presetConfig, presetConfigSource, presetField, presetGlue, presetInstallCommand, presetOf, presetValueLabel, readDesignFile, resolvePreset, safeDesignFileSource, safeParseDesign, withPresetField };

package/dist/preset/index.js

@@ -1,4 +1,4 @@
-import { C as integrationsForFramework, E as PRESET_BLOCKS, S as PRESET_VERSION, T as presetValueLabel, _ as withPresetField, a as listNames, b as PRESET_FRAMEWORKS, c as PRESET_CATALOG, d as PRESET_NAMES, f as isPresetName, g as isPresetCode, h as encodePreset, i as presetOf, l as PRESETS, m as decodePreset, n as expandPreset, o as presetBlockConflict, p as namedPreset, r as presetConfig, s as resolvePreset, t as conventionConfig, u as PRESET_GROUPS, v as DEFAULT_CONVENTIONS, w as presetField, x as PRESET_TENANT_NAMES, y as PRESET_FIELDS } from "../config-DHhQmmuD.js";
-import { a as appDefaultError, c as appReservedColumns, n as APP_NAME_MAX, o as appIdentifierError, p as isAppDefault, s as appNameLengthError, y as APP_COLUMN_FORMATS } from "../app-tables-BRjMcWhW.js";
-import { _ as presetApplyCommand, a as MAX_DESIGN_CODE_LENGTH, b as presetGlue, c as designConfig, d as designInstallCommand, f as designOf, g as glueCommand, h as PROVIDER_COMMENT, i as DesignTooLongError, l as designConfigSource, m as isDesignCode, n as diffDesigns, o as decodeDesign, p as encodeDesign, r as DESIGN_FORMAT, s as designApplyCommand, t as diffAppTables, u as designFormat, v as presetBlocksSource, x as presetInstallCommand, y as presetConfigSource } from "../preset-Cqwlwx6G.js";
-export { APP_COLUMN_FORMATS, APP_NAME_MAX, DEFAULT_CONVENTIONS, DESIGN_FORMAT, DesignTooLongError, MAX_DESIGN_CODE_LENGTH, PRESETS, PRESET_BLOCKS, PRESET_CATALOG, PRESET_FIELDS, PRESET_FRAMEWORKS, PRESET_GROUPS, PRESET_NAMES, PRESET_TENANT_NAMES, PRESET_VERSION, PROVIDER_COMMENT, appDefaultError, appIdentifierError, appNameLengthError, appReservedColumns, conventionConfig, decodeDesign, decodePreset, designApplyCommand, designConfig, designConfigSource, designFormat, designInstallCommand, designOf, diffAppTables, diffDesigns, encodeDesign, encodePreset, expandPreset, glueCommand, integrationsForFramework, isAppDefault, isDesignCode, isPresetCode, isPresetName, listNames, namedPreset, presetApplyCommand, presetBlockConflict, presetBlocksSource, presetConfig, presetConfigSource, presetField, presetGlue, presetInstallCommand, presetOf, presetValueLabel, resolvePreset, withPresetField };
+import { C as PRESET_FRAMEWORKS, D as presetField, E as integrationsForFramework, O as presetValueLabel, S as PRESET_FIELDS, T as PRESET_VERSION, _ as decodePreset, a as listNames, b as withPresetField, c as PRESET_CATALOG, d as PRESET_GROUPS, f as PRESET_NAMES, g as namedPreset, h as isPresetName, i as presetOf, k as PRESET_BLOCKS, l as DEFAULT_PRESET_NAME, m as defaultPresetCode, n as expandPreset, o as presetBlockConflict, p as defaultPreset, r as presetConfig, s as resolvePreset, t as conventionConfig, u as PRESETS, v as encodePreset, w as PRESET_TENANT_NAMES, x as DEFAULT_CONVENTIONS, y as isPresetCode } from "../config-V6HMvce5.js";
+import { a as appDefaultError, c as appReservedColumns, n as APP_NAME_MAX, o as appIdentifierError, p as isAppDefault, s as appNameLengthError, y as APP_COLUMN_FORMATS } from "../app-tables-0YZ9IskE.js";
+import { A as presetInstallCommand, C as safeParseDesign, D as presetBlocksSource, E as presetApplyCommand, O as presetConfigSource, S as safeDesignFileSource, T as glueCommand, _ as encodeDesign, a as DesignParseError, b as parseDesign, c as decodeDesign, d as designConfigSource, f as designFileSource, g as designSchema, h as designOf, i as DESIGN_FORMAT, k as presetGlue, l as designApplyCommand, m as designInstallCommand, n as diffDesigns, o as DesignTooLongError, p as designFormat, r as DESIGN_FILE, s as MAX_DESIGN_CODE_LENGTH, t as diffAppTables, u as designConfig, v as isDesignCode, w as PROVIDER_COMMENT, x as readDesignFile } from "../preset-HNFqCWaD.js";
+export { APP_COLUMN_FORMATS, APP_NAME_MAX, DEFAULT_CONVENTIONS, DEFAULT_PRESET_NAME, DESIGN_FILE, DESIGN_FORMAT, DesignParseError, DesignTooLongError, MAX_DESIGN_CODE_LENGTH, PRESETS, PRESET_BLOCKS, PRESET_CATALOG, PRESET_FIELDS, PRESET_FRAMEWORKS, PRESET_GROUPS, PRESET_NAMES, PRESET_TENANT_NAMES, PRESET_VERSION, PROVIDER_COMMENT, appDefaultError, appIdentifierError, appNameLengthError, appReservedColumns, conventionConfig, decodeDesign, decodePreset, defaultPreset, defaultPresetCode, designApplyCommand, designConfig, designConfigSource, designFileSource, designFormat, designInstallCommand, designOf, designSchema, diffAppTables, diffDesigns, encodeDesign, encodePreset, expandPreset, glueCommand, integrationsForFramework, isAppDefault, isDesignCode, isPresetCode, isPresetName, listNames, namedPreset, parseDesign, presetApplyCommand, presetBlockConflict, presetBlocksSource, presetConfig, presetConfigSource, presetField, presetGlue, presetInstallCommand, presetOf, presetValueLabel, readDesignFile, resolvePreset, safeDesignFileSource, safeParseDesign, withPresetField };