better-supabase 0.5.0 → 0.6.0

package/dist/plugins/rules/index.d.ts

@@ -1,5 +1,5 @@
-import { U as Operation } from "../../executor-BunPOO-k.js";
-import { h as RepositoryExtension, p as Plugin } from "../../plugin-o144f322.js";
+import { v as Operation } from "../../executor-DvsBbNBS.js";
+import { d as Plugin, p as RepositoryExtension } from "../../plugin-FGY8UhYm.js";
 //#region src/plugins/rules/index.d.ts
 export type RuleLevel = "off" | "warn" | "error";
 /** A level, or a level with the rule's option: `['error', 500]`. */
@@ -37,6 +37,13 @@ export interface RuleSet {
    * the lint rule of the same name flags the call in the editor.
    */
   readonly noDeleteManyWithoutWhere?: RuleSetting;
+  /**
+   * `updateMany` and `deleteMany` without `maxAffected`, or with one above
+   * the given maximum (default 1000). With a bound, a `where` that matches
+   * more rows than intended fails with `max_affected` and writes nothing.
+   * Updates and deletes by key are exempt.
+   */
+  readonly requireMaxAffected?: RuleSetting<number>;
   /**
    * Storage objects written to `*_url` text columns: a column listed in
    * `storagePaths`, or a value that is a Storage URL or matches a bucket's
@@ -78,10 +85,10 @@ export declare function strict(): RuleSet;
  * Runtime query rules, checked before each request is built:
  *
  * ```ts
- * defineSupabase(schema, { plugins: [rules({ rules: recommended() })] });
+ * defineSupabase(schema).use(rules({ rules: recommended() }));
  * ```
  *
- * Runs first (`enforce: 'pre'`) so it sees the query as written, before
+ * Runs first (`enforce: 'first'`) so it sees the query as written, before
  * tenant or soft-delete filters are added. Pair with the static
  * `better-supabase/lint` plugin to catch the same mistakes in the editor.
  */

package/dist/plugins/rules/index.js

@@ -1,7 +1,9 @@
-import { n as dbError, t as DbException } from "../../errors-DtwXa6b8.js";
+import { t as DbException } from "../../db-exception-CnWcYPxL.js";
+import { n as dbError } from "../../errors-B11Duf73.js";
 import { t as lookupOf } from "../../lookup-BaP5bI27.js";
-import { r as definePlugin } from "../../plugin-DwARMuQp.js";
-import { i as tenantClaimPaths, n as claimAt, r as claimsOf } from "../../claims-BAf6c7is.js";
+import { r as definePlugin } from "../../plugin-tfXW1-qO.js";
+import { t as simplify } from "../../simplify-DDO0j0LI.js";
+import { o as tenantFrom, s as tenantPathsFor } from "../../claims-PqzCxaTD.js";
 //#region src/plugins/rules/index.ts
 /** Catches data-exposure and correctness mistakes; everything else off. */
 function safe() {
@@ -31,7 +33,8 @@ function strict() {
 		maxLimit: ["error", 1e3],
 		requireOrderByForCursor: "error",
 		maxIncludeDepth: ["error", 3],
-		storagePathColumns: "error"
+		storagePathColumns: "error",
+		requireMaxAffected: ["error", 1e3]
 	};
 }
 function levelOf(setting) {
@@ -89,7 +92,7 @@ const templatesBySchema = /* @__PURE__ */ new WeakMap();
 function bucketTemplates(schema) {
 	let templates = templatesBySchema.get(schema);
 	if (!templates) {
-		templates = Object.values(schema.buckets ?? {}).filter((bucket) => bucket.path.replaceAll(/\{[^}]*\}|\//g, "").length > 0).map((bucket) => new RegExp(`^${bucket.path.split(/\{[^}]*\}/).map((part) => part.replaceAll(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("[^/]+")}$`));
+		templates = Object.values(schema.buckets ?? {}).flatMap((bucket) => typeof bucket.path === "string" ? [bucket.path] : bucket.path).filter((path) => path.replaceAll(/\{[^}]*\}|\//g, "").length > 0).map((path) => new RegExp(`^${path.split(/(\{[^}]*\})/).map((part, index) => index % 2 === 0 ? part.replaceAll(/[.*+?^${}()|[\]\\]/g, "\\$&") : part.startsWith("{...") ? "[^/]+(?:/[^/]+)*" : "[^/]+").join("")}$`));
 		templatesBySchema.set(schema, templates);
 	}
 	return templates;
@@ -117,9 +120,27 @@ function storedObjectColumn(op, schema) {
 		})) return `"${column.db}" is given a storage object; store its path in "${path}" and build URLs with signedUrl() or renderUrl()`;
 	}
 }
+const primaryColumnsByTable = /* @__PURE__ */ new WeakMap();
+/** `true` when `where` holds `pk = value` for every primary key column: one row at most. */
+function pinsPrimaryKey(table, where) {
+	if (!where || table.primaryKey.length === 0) return false;
+	let columns = primaryColumnsByTable.get(table);
+	if (!columns) {
+		columns = table.primaryKey.map((name) => table.columns[name]?.db ?? name);
+		primaryColumnsByTable.set(table, columns);
+	}
+	const pinned = /* @__PURE__ */ new Set();
+	const visit = (condition) => {
+		if (condition.kind === "and") condition.items.forEach(visit);
+		else if (condition.kind === "column" && condition.op === "eq" && condition.path === void 0) pinned.add(condition.column);
+	};
+	visit(where);
+	return columns.every((column) => pinned.has(column));
+}
 function checks(rules) {
 	const maxLimit = optionOf(rules.maxLimit, 1e3);
 	const maxDepth = optionOf(rules.maxIncludeDepth, 3);
+	const maxAffected = optionOf(rules.requireMaxAffected, 1e3);
 	return {
 		noUnboundedFindMany: (op) => op.kind === "select" && op.single === void 0 && !op.head && op.limit === void 0 && op.selection.aggregate === void 0 ? "findMany without limit reads every visible row" : void 0,
 		maxLimit: (op) => {
@@ -127,7 +148,7 @@ function checks(rules) {
 			const limit = op.lookAhead === true ? op.limit - 1 : op.limit;
 			return limit > maxLimit ? `limit ${limit} is above the maximum of ${maxLimit}` : void 0;
 		},
-		requireOrderByForCursor: (op) => op.kind === "select" && !op.head && op.orderBy.length === 0 && (op.offset !== void 0 || op.limit !== void 0 && op.limit > 1) ? "paging without orderBy returns rows in no stable order" : void 0,
+		requireOrderByForCursor: (op) => op.kind === "select" && !op.head && op.unpaged !== true && op.source === void 0 && op.orderBy.length === 0 && (op.offset !== void 0 || op.limit !== void 0 && op.limit > 1) ? "paging without orderBy returns rows in no stable order" : void 0,
 		maxIncludeDepth: (op) => {
 			const max = maxDepth;
 			const selection = op.kind === "select" ? op.selection : op.returning;
@@ -136,10 +157,10 @@ function checks(rules) {
 		},
 		requireTenantContext: (op, { context, schema }) => {
 			if (!op.table.flags.tenant || context.actor?.kind === "service") return;
-			if (typeof context.tenant === "string") return;
 			const claim = optionOf(rules.requireTenantContext, void 0);
-			const paths = claim === void 0 ? tenantClaimPaths(claimsOf(schema).tenant) : [claim];
-			return paths.some((path) => claimAt(context.claims, path) !== void 0) ? void 0 : `"${op.table.key}" is tenant-scoped but the request has no tenant (context.tenant or claim ${paths.map((path) => `"${path}"`).join(" or ")})`;
+			const paths = tenantPathsFor(claim, schema);
+			if (tenantFrom(context, paths) !== void 0) return;
+			return `"${op.table.key}" is tenant-scoped but the request has no tenant (context.tenant or claim ${paths.map((path) => `"${path}"`).join(" or ")})`;
 		},
 		noAdminInBrowser: (_op, { context }) => context.actor?.kind === "service" && isBrowser() ? "a service-role connection is running in a browser" : void 0,
 		noSensitiveSelect: (op, { options }) => {
@@ -147,7 +168,12 @@ function checks(rules) {
 			const columns = sensitiveColumns(op.selection, op.table);
 			return columns.length > 0 ? `reads sensitive column(s) ${columns.join(", ")}; pass { sensitive: true } to allow` : void 0;
 		},
-		noDeleteManyWithoutWhere: (op) => op.kind === "delete" && op.where === void 0 ? "delete without where removes every visible row" : void 0,
+		noDeleteManyWithoutWhere: (op) => op.kind === "delete" && simplify(op.where) === true ? "delete without where removes every visible row" : void 0,
+		requireMaxAffected: (op) => {
+			if (op.kind !== "update" && op.kind !== "delete") return;
+			if (op.maxAffected === void 0) return pinsPrimaryKey(op.table, op.where) ? void 0 : `${op.kind === "update" ? "updateMany" : "deleteMany"} without maxAffected can change every row its where matches`;
+			return op.maxAffected > maxAffected ? `maxAffected ${op.maxAffected} is above the maximum of ${maxAffected}` : void 0;
+		},
 		storagePathColumns: (op, { schema }) => storedObjectColumn(op, schema)
 	};
 }
@@ -158,10 +184,10 @@ function defaultReport(violation) {
 * Runtime query rules, checked before each request is built:
 *
 * ```ts
-* defineSupabase(schema, { plugins: [rules({ rules: recommended() })] });
+* defineSupabase(schema).use(rules({ rules: recommended() }));
 * ```
 *
-* Runs first (`enforce: 'pre'`) so it sees the query as written, before
+* Runs first (`enforce: 'first'`) so it sees the query as written, before
 * tenant or soft-delete filters are added. Pair with the static
 * `better-supabase/lint` plugin to catch the same mistakes in the editor.
 */
@@ -179,7 +205,8 @@ function rules(options = {}) {
 	});
 	return definePlugin({
 		name: "rules",
-		enforce: "pre",
+		enforce: "first",
+		scopes: [],
 		transformQuery(op, hook) {
 			for (const { rule, level, check } of active) {
 				const message = check(op, hook);

package/dist/plugins/soft-delete/index.d.ts

@@ -1,6 +1,6 @@
-import { w as PrimaryKeyValue } from "../../types-Dnf_wRDz.js";
-import { a as AsyncResult } from "../../executor-BunPOO-k.js";
-import { h as RepositoryExtension, o as HasFlag, p as Plugin } from "../../plugin-o144f322.js";
+import { t as AsyncResult } from "../../result-D7y2fT87.js";
+import { E as PrimaryKeyValue } from "../../types-6BdhkmZe.js";
+import { d as Plugin, o as HasFlag, p as RepositoryExtension } from "../../plugin-FGY8UhYm.js";
 //#region src/plugins/soft-delete/index.d.ts
 export interface SoftDeleteFindArgs {
   /** Include soft-deleted rows of the queried table. */
@@ -32,7 +32,8 @@ export interface SoftDeleteExtension extends RepositoryExtension {
  * - `restore(key)` clears it.
  *
  * Deletes become updates without `RETURNING`, so a SELECT policy that hides
- * deleted rows does not make them fail.
+ * deleted rows does not make them fail. `deleteMany({ returning: true })`
+ * keeps `RETURNING`, which needs a SELECT policy that still shows the row.
  */
 export declare function softDelete(): Plugin<"softDelete", SoftDeleteExtension>;
 //#endregion

package/dist/plugins/soft-delete/index.js

@@ -1,8 +1,8 @@
 import { t as and } from "../../types-6cYK9pbJ.js";
-import { i as ok, t as AsyncResult } from "../../result-BKiliPY7.js";
-import { r as definePlugin } from "../../plugin-DwARMuQp.js";
+import { a as ok, t as AsyncResult } from "../../result-DzUbqgdW.js";
+import { r as definePlugin } from "../../plugin-tfXW1-qO.js";
 import { n as scopeOperation } from "../../scope-CDHcS7dE.js";
-import { a as insertsOnly, i as guardManaged, o as isNotNull, s as isNull, t as dbName, u as withDefault } from "../../shared-D1dRUrAg.js";
+import { a as insertsOnly, i as guardManaged, o as isNotNull, s as isNull, t as dbName, u as withDefault } from "../../shared-CxWmcyqB.js";
 //#region src/plugins/soft-delete/index.ts
 function deletedColumn(table) {
 	return dbName(table, table.flags.softDelete);
@@ -20,12 +20,14 @@ function scopeFor(table) {
 * - `restore(key)` clears it.
 *
 * Deletes become updates without `RETURNING`, so a SELECT policy that hides
-* deleted rows does not make them fail.
+* deleted rows does not make them fail. `deleteMany({ returning: true })`
+* keeps `RETURNING`, which needs a SELECT policy that still shows the row.
 */
 function softDelete() {
 	return definePlugin({
 		name: "softDelete",
 		enforce: "pre",
+		scopes: ["softDelete"],
 		transformQuery(op, { options }) {
 			const hardDelete = op.kind === "delete" && options["hard"] === true;
 			const withDeleted = options["withDeleted"] === true || hardDelete;
@@ -52,10 +54,13 @@ function softDelete() {
 			if (op.kind !== "delete" || options["hard"] === true) return op;
 			return {
 				kind: "update",
+				intent: "softDelete",
 				table,
 				set: { [column]: now().toString() },
 				where: op.where,
-				returning: void 0
+				returning: options["returning"] === true ? op.returning : void 0,
+				...op.maxAffected === void 0 ? {} : { maxAffected: op.maxAffected },
+				...op.count === void 0 ? {} : { count: op.count }
 			};
 		},
 		repository({ table, base }) {

package/dist/plugins/tenant/index.d.ts

@@ -1,5 +1,5 @@
-import { j as SchemaMeta } from "../../types-Dnf_wRDz.js";
-import { g as RequestContext, h as RepositoryExtension, o as HasFlag, p as Plugin } from "../../plugin-o144f322.js";
+import { P as SchemaMeta } from "../../types-6BdhkmZe.js";
+import { d as Plugin, m as RequestContext, o as HasFlag, p as RepositoryExtension } from "../../plugin-FGY8UhYm.js";
 //#region src/plugins/tenant/index.d.ts
 /**
  * Dotted paths to the string claims of `C` (up to three levels), e.g.

package/dist/plugins/tenant/index.js

@@ -1,8 +1,9 @@
-import { n as dbError, t as DbException } from "../../errors-DtwXa6b8.js";
-import { a as recordTenant, o as spansAllTenants, r as definePlugin } from "../../plugin-DwARMuQp.js";
+import { t as DbException } from "../../db-exception-CnWcYPxL.js";
+import { n as dbError } from "../../errors-B11Duf73.js";
+import { a as spansAllTenants, r as definePlugin } from "../../plugin-tfXW1-qO.js";
 import { n as scopeOperation } from "../../scope-CDHcS7dE.js";
-import { i as tenantClaimPaths, n as claimAt, r as claimsOf } from "../../claims-BAf6c7is.js";
-import { a as insertsOnly, n as equals, r as forbidden, t as dbName } from "../../shared-D1dRUrAg.js";
+import { o as tenantFrom, s as tenantPathsFor } from "../../claims-PqzCxaTD.js";
+import { a as insertsOnly, n as equals, r as forbidden, t as dbName } from "../../shared-CxWmcyqB.js";
 //#region src/plugins/tenant/index.ts
 /**
 * The tenant for a request: `context.tenant`, then the configured claim.
@@ -10,13 +11,8 @@ import { a as insertsOnly, n as equals, r as forbidden, t as dbName } from "../.
 */
 function resolveTenant(context, options = {}, schema) {
 	if (options.resolve) return options.resolve(context);
-	if (typeof context.tenant === "string") return context.tenant;
 	const claim = options.claim;
-	const paths = typeof claim === "string" ? [claim] : claim ?? tenantClaimPaths(claimsOf(schema).tenant);
-	for (const path of paths) {
-		const value = claimAt(context.claims, path);
-		if (value !== void 0) return value;
-	}
+	return tenantFrom(context, tenantPathsFor(claim, schema));
 }
 /** Tenant columns may be numeric; the resolved tenant is always a string. */
 function sameTenant(value, id) {
@@ -42,7 +38,6 @@ function tenant(options = {}) {
 		if (id === void 0 && !resolved.has(context)) {
 			id = resolveTenant(context, options, schema);
 			resolved.set(context, id);
-			if (id !== void 0) recordTenant(context, id);
 		}
 		return id;
 	};
@@ -56,6 +51,18 @@ function tenant(options = {}) {
 	};
 	return definePlugin({
 		name: "tenant",
+		scopes: ["tenant"],
+		context(context, { schema }) {
+			if (spansAllTenants(context)) return context;
+			const id = resolvedFor(context, schema);
+			if (id === void 0 || id === context.tenant) return context;
+			const derived = {
+				...context,
+				tenant: id
+			};
+			resolved.set(derived, id);
+			return derived;
+		},
 		transformQuery(op, { context, schema, options: call }) {
 			if (call["allTenants"] === true || spansAllTenants(context)) return op;
 			const id = resolvedFor(context, schema);

package/dist/plugins/timestamps/index.d.ts

@@ -1,9 +1,11 @@
-import { p as Plugin } from "../../plugin-o144f322.js";
+import { d as Plugin } from "../../plugin-FGY8UhYm.js";
 //#region src/plugins/timestamps/index.d.ts
 /**
  * Stamps the columns generated as `Flags.timestamps`: `createdAt` on insert,
- * `updatedAt` on insert and update. Values the caller passes win. Pair it with
- * the `updated-at` SQL kit trigger to cover writes that bypass the app.
+ * `updatedAt` on insert and update. A call that sets either column fails with
+ * `invalid_request` unless it passes `{ override: true }`, which keeps the
+ * caller's values. Pair it with
+ * the `updated-at` SQL module trigger to cover writes that bypass the app.
  */
 export declare function timestamps(): Plugin<"timestamps">;
 //#endregion

package/dist/plugins/timestamps/index.js

@@ -1,10 +1,12 @@
-import { r as definePlugin } from "../../plugin-DwARMuQp.js";
-import { a as insertsOnly, i as guardManaged, t as dbName, u as withDefault } from "../../shared-D1dRUrAg.js";
+import { r as definePlugin } from "../../plugin-tfXW1-qO.js";
+import { a as insertsOnly, i as guardManaged, t as dbName, u as withDefault } from "../../shared-CxWmcyqB.js";
 //#region src/plugins/timestamps/index.ts
 /**
 * Stamps the columns generated as `Flags.timestamps`: `createdAt` on insert,
-* `updatedAt` on insert and update. Values the caller passes win. Pair it with
-* the `updated-at` SQL kit trigger to cover writes that bypass the app.
+* `updatedAt` on insert and update. A call that sets either column fails with
+* `invalid_request` unless it passes `{ override: true }`, which keeps the
+* caller's values. Pair it with
+* the `updated-at` SQL module trigger to cover writes that bypass the app.
 */
 function timestamps() {
 	return definePlugin({

package/dist/plugins/validation/index.d.ts

@@ -1,5 +1,5 @@
-import { p as Plugin } from "../../plugin-o144f322.js";
-import { t as StandardSchemaV1 } from "../../standard-J4YgMOLm.js";
+import { d as Plugin } from "../../plugin-FGY8UhYm.js";
+import { t as StandardSchemaV1 } from "../../standard-CYsm7xpT.js";
 //#region src/plugins/validation/index.d.ts
 export interface TableValidators {
   /** Validates inserts and upserts, with app-cased keys. */

package/dist/plugins/validation/index.js

@@ -1,8 +1,9 @@
-import { n as dbError, t as DbException } from "../../errors-DtwXa6b8.js";
-import { n as decodeValue, r as encodeValue } from "../../wire-D2dT86vi.js";
-import { r as definePlugin } from "../../plugin-DwARMuQp.js";
-import { t as validate } from "../../standard-D7r6dMUu.js";
-import { c as toApp, l as toDb } from "../../shared-D1dRUrAg.js";
+import { t as DbException } from "../../db-exception-CnWcYPxL.js";
+import { n as dbError } from "../../errors-B11Duf73.js";
+import { i as encodeValue, r as decodeValue } from "../../wire-DtZQ4sdE.js";
+import { r as definePlugin } from "../../plugin-tfXW1-qO.js";
+import { n as validate } from "../../standard-BK0cqJ7y.js";
+import { c as toApp, l as toDb } from "../../shared-CxWmcyqB.js";
 //#region src/plugins/validation/index.ts
 /**
 * Rows reach plugins in wire form (ISO text, decimal text), while generated
@@ -27,7 +28,10 @@ async function check(schema, table, row, label, index) {
 	const result = await validate(schema, decoded(table, row), label);
 	if (result.ok) {
 		const output = result.data;
-		return typeof output === "object" && output !== null ? encoded(toDb(table, output)) : { ...row };
+		return typeof output === "object" && output !== null ? {
+			...row,
+			...encoded(toDb(table, output))
+		} : { ...row };
 	}
 	const error = result.error;
 	if (index === void 0 || error.kind !== "validation") throw new DbException(error);

package/dist/{pool-C9voM4Kw.d.ts → pool-CAu2nLrL.d.ts}

@@ -1,5 +1,5 @@
-import { r as Executor } from "./executor-BunPOO-k.js";
-import { t as SqlClient } from "./executor-Cghdstwu.js";
+import { r as Executor } from "./executor-DvsBbNBS.js";
+import { t as SqlClient } from "./executor-DbvExCFC.js";
 //#region src/postgres/pool.d.ts
 /** The part of a `pg` pool client `createPostgres` uses. */
 interface PgPoolClient {

package/dist/postgres/index.d.ts

@@ -1,7 +1,7 @@
-import { U as Operation } from "../executor-BunPOO-k.js";
-import { n as fromPgError, r as postgresExecutor, t as SqlClient } from "../executor-Cghdstwu.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-C9voM4Kw.js";
-import { t as Compiler } from "../compiler-BXH_aZ7N.js";
+import { v as Operation } from "../executor-DvsBbNBS.js";
+import { n as fromPgError, r as postgresExecutor, t as SqlClient } from "../executor-DbvExCFC.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-CAu2nLrL.js";
+import { t as Compiler } from "../compiler-DY_wkj4R.js";
 //#region src/compile/sql.d.ts
 interface SqlQuery {
   readonly text: string;

package/dist/postgres/index.js

@@ -1,5 +1,4 @@
-import { n as quoteIdent, t as compileSql } from "../sql-Coh6n4cC.js";
-import { n as postgresExecutor, t as fromPgError } from "../executor-XycESQPH.js";
+import { i as quoteIdent, n as postgresExecutor, r as compileSql, t as fromPgError } from "../executor-De1Of3m3.js";
 import { Pool } from "pg";
 //#region src/postgres/pool.ts
 const DEFAULT_TIMEOUTS = {

package/dist/{postgrest-CruYKAvV.d.ts → postgrest-BLVdEnfe.d.ts}

@@ -1,4 +1,4 @@
-import { U as Operation } from "./executor-BunPOO-k.js";
+import { v as Operation } from "./executor-DvsBbNBS.js";
 //#region src/compile/postgrest.d.ts
 /**
  * A compiled PostgREST request, expressed as calls on the public
@@ -16,6 +16,16 @@ interface PostgrestPlan {
   } | 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";
@@ -38,6 +48,6 @@ interface PlanLimit {
   readonly referencedTable: string | undefined;
 }
 /** Compiles an operation into a PostgREST plan. */
-declare function compilePostgrest(op: Operation): PostgrestPlan;
+declare function compilePostgrest(op: Operation, options?: PostgrestCompileOptions): PostgrestPlan;
 //#endregion
-export { compilePostgrest as a, PostgrestPlan as i, PlanLimit as n, PlanOrder as r, PlanFilter as t };
+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

@@ -0,0 +1,43 @@
+import { t as AuthSnapshot } from "../bind-Bu_ZNa3W.js";
+import { _ as SqliteValue, a as postgrestTimestamp, b as quoteSqliteIdent, c as SqliteCompilerOptions, d as SqliteKeyedPlan, f as SqliteKeys, g as SqliteSelectPlan, h as SqliteReturning, i as fromSqliteError, l as SqliteDecode, m as SqliteQuery, n as PowerSyncExecutorOptions, o as powersyncExecutor, p as SqlitePlan, r as SqliteContextLike, s as SqliteColumn, t as PowerSyncDatabaseLike, u as SqliteInsertPlan, v as compileSqlite, x as sqliteValue, y as likeToGlob } from "../executor-CaWigTyR.js";
+import { a as sqliteCompiler, i as checkSqlite, n as sqliteTables, r as watch, t as WatchOptions } from "../watch-DI34G86j.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-Dv8kK0MO.js";
+//#region src/powersync/auth.d.ts
+/** The part of a PowerSync database `syncWithAuth` drives. */
+interface SyncedDatabaseLike<C> {
+  connect(connector: C): Promise<void>;
+  disconnect(): Promise<void>;
+  disconnectAndClear(): Promise<void>;
+}
+/** `bs.auth` from a browser or native client. */
+interface AuthSourceLike {
+  readonly current: () => AuthSnapshot;
+  readonly subscribe: (listener: () => void) => () => void;
+}
+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.
+   */
+  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.
+ *
+ * ```ts
+ * useEffect(() => syncWithAuth(powersync, bs.auth, { connector }), []);
+ * ```
+ */
+export declare function syncWithAuth<C>(db: SyncedDatabaseLike<C>, auth: AuthSourceLike, options: SyncWithAuthOptions<C>): () => void;
+//#endregion
+export { type AuthSourceLike, type CrudEntryLike, type CrudQueueLike, type PowerSyncDatabaseLike, type PowerSyncExecutorOptions, type RejectedChange, type RejectedStore, type SqliteColumn, type SqliteCompilerOptions, type SqliteContextLike, type SqliteDecode, type SqliteInsertPlan, type SqliteKeyedPlan, type SqliteKeys, type SqlitePlan, type SqliteQuery, type SqliteReturning, type SqliteSelectPlan, type SqliteValue, type SyncWithAuthOptions, type SyncedDatabaseLike, type UploadConnector, type UploadConnectorOptions, type UploadOutcome, type UploadRepository, type UploadRoute, type WatchOptions, checkSqlite, compileSqlite, createUploadConnector, fromSqliteError, likeToGlob, postgrestTimestamp, powersyncExecutor, quoteSqliteIdent, sqliteCompiler, sqliteTables, sqliteValue, uploadOutcome, watch };