better-supabase 0.16.0 → 0.18.0

package/dist/cli/{doctor-DkOSLPEQ.js → doctor-D_nrsd9E.js}

@@ -1,41 +1,42 @@
-import { a as list, p as commandMeta, r as defineCliCommand } from "./command-CQ61x6gN.js";
+import { a as list, p as commandMeta, r as defineCliCommand } from "./command-BWEEXmtz.js";
 import { i as plain } from "./style-Bm2X5JrN.js";
-import { t as VERSION } from "./version-B2Dr6VmJ.js";
+import { t as VERSION } from "./version-TgFM8sOd.js";
 import { n as CliError, r as errorText } from "./errors-BTe6A15O.js";
 import { i as isLocalDatabaseUrl, r as databaseHost } from "./agent-CbuPvI2x.js";
 import { a as sameText, t as display } from "./io-DH1kcmmP.js";
-import { t as CACHE_DIR } from "./cache-AznIssjI.js";
+import { t as CACHE_DIR } from "./cache-DE2IH1-C.js";
 import { t as byCodePoint } from "./compare-BmIWVEui.js";
-import { C as satisfies, S as peerVersions, c as isSqliteLiteDriver, n as managementTarget, o as snapshotFile, r as openSource, s as liteDriverOf, t as loadSnapshot, u as MetadataRejectedError } from "./snapshot-uTUlEzY2.js";
-import { d as configFor, r as renderFiles, u as notNullTag } from "./render-5y5a1QZr.js";
+import { C as satisfies, S as peerVersions, c as isSqliteLiteDriver, n as managementTarget, o as snapshotFile, r as openSource, s as liteDriverOf, t as loadSnapshot, u as MetadataRejectedError } from "./snapshot-BXmU3IXN.js";
+import { d as configFor, r as renderFiles, u as notNullTag } from "./render-BJF9ytUi.js";
 import { t as isRecord } from "./guards-CUlDNYZs.js";
-import { i as request } from "./source-D2gJHKwC.js";
-import { T as providerLabel, i as migrationHolds, o as migrationModules, r as latestMigration, t as MODULES_SUFFIX, y as compiledReadSets } from "./module-migration-O_IxewFs.js";
-import { l as stdinDatabaseUrl, n as databaseUrl } from "./config-9t5ec_N7.js";
+import { i as request } from "./source-irttnsEb.js";
+import { g as providerLabel, u as compiledReadSets } from "./migrations-BoIyGczt.js";
+import { l as stdinDatabaseUrl, n as databaseUrl } from "./config-BJSqMi04.js";
 import { a as findRepoRoot, c as httpHooks, d as readSupabaseToml, f as schemaPaths, h as tomlGet, i as diffEngine, l as migrationCommand, n as declarativeSchemasDir, p as sqlWorkflow, u as pgFunctionHooks } from "./supabase-toml-CncmQbO0.js";
 import { t as PROCESS_ENV } from "./env-DMgjB_4y.js";
 import { n as readStackStatus } from "./stack-status-B_Ipd_-z.js";
 import { t as connect } from "./db-CQCLx7cx.js";
-import { a as hasContentMapper, c as supportsContentMappers, i as contentMapperSetup$1, n as TSCONFIG_SNIPPET, o as needsRunExternalCode, t as RUN_EXTERNAL_CODE } from "./content-mapper-DCrz6OIv.js";
+import { a as hasContentMapper, c as supportsContentMappers, i as contentMapperSetup$1, n as TSCONFIG_SNIPPET, o as needsRunExternalCode, t as RUN_EXTERNAL_CODE } from "./content-mapper-CaygHH_k.js";
 import { c as insideRoot, i as changeLines, r as applyPlan } from "./files-CX71yBm8.js";
-import { C as splinterTables, S as advisorRule, _ as withoutStrings, a as METADATA_GAPS_TEXT, b as appTablesOf, c as accessModule, d as RLS_RULES, f as appliesTo, g as policyHelpers, h as functionObject, l as entitlementsModule, m as functionBody, p as escape$2, s as AUTHORIZATION_RULES, u as COMMANDS$2, v as BLOCK_PREFIX, x as appViewsOf, y as blockTargets } from "./run-Bs4OKdDI.js";
-import { n as migrationsDir, r as moduleLayoutFor, t as blockDeclaredTables } from "./sql-layout-lUWenjJw.js";
-import { a as permissionCatalogKeys, i as lineOf, l as tableObject, n as exposed, o as policyObject, r as exposedSchemas, s as qualified, t as catalogOf, u as workflowOf } from "./shared-BLqbvY2x.js";
-import { o as wiringFor, r as configInstances, t as MIGRATION_SAFETY_RULES } from "./migration-safety-BnnXPAro.js";
+import { C as splinterTables, S as advisorRule, _ as withoutStrings, a as METADATA_GAPS_TEXT, b as appTablesOf, c as accessModule, d as RLS_RULES, f as appliesTo, g as policyHelpers, h as functionObject, l as entitlementsModule, m as functionBody, p as escape$2, s as AUTHORIZATION_RULES, u as COMMANDS$2, v as BLOCK_PREFIX, x as appViewsOf, y as blockTargets } from "./run-jeplMBOK.js";
+import { n as migrationsDir, r as moduleLayoutFor, t as blockDeclaredTables } from "./sql-layout-D8QrNvt4.js";
+import { a as permissionCatalogKeys, i as lineOf, l as tableObject, n as exposed, o as policyObject, r as exposedSchemas, s as qualified, t as catalogOf, u as workflowOf } from "./shared-B38Chjgd.js";
+import { i as migrationHolds, o as migrationModules, r as latestMigration, t as MODULES_SUFFIX } from "./module-migration-DXvo0EqU.js";
+import { o as wiringFor, r as configInstances, t as MIGRATION_SAFETY_RULES } from "./migration-safety-DYo1vVWC.js";
 import { t as orphanedBlockFiles } from "./orphans-BAboqyVM.js";
-import { i as reservedRoles, n as ident$1, r as literal$1, t as LIVE_RULES } from "./live-DGdLR41j.js";
-import { a as sourceFlags, n as SOURCE_ARGS } from "./source-args-IpJRJO5t.js";
+import { i as reservedRoles, n as ident$1, r as literal$1, t as LIVE_RULES } from "./live-B38ePuRS.js";
+import { a as sourceFlags, n as SOURCE_ARGS } from "./source-args-DlckPVje.js";
 import { i as PLUGIN_SUBPATH_RENAMES, n as BLOCK_SUBPATH_RENAMES, o as SPEC_SUBPATH_RENAMES, t as BLOCK_EXPORT_RENAMES } from "./codemod-block-renames-BuSaTE_G.js";
 import { n as PLATFORM_SCHEMAS } from "./in-stack-diff-DQTW53Vf.js";
 import { i as staleVariables, r as stackEnvValues, t as PREFIX_NAMES } from "./stack-env-6hS-WEmh.js";
 import { a as readSharedMemory, n as listStacks, t as branchName } from "./stacks-BYlQ96WS.js";
-import { i as refuseWithMetadata, r as readMetadataSnapshot } from "./metadata-BfgHMe4q.js";
+import { i as refuseWithMetadata, r as readMetadataSnapshot } from "./metadata-BTihErEc.js";
 import { existsSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 import { createHash } from "node:crypto";
 import { glob, mkdir, readFile, readdir, writeFile } from "node:fs/promises";
 import { DEFAULT_ACTIVE_TENANT, tenantClaimPaths } from "better-supabase/config";
-import { SECRET_COLUMNS, SQL_MODULES, TENANT_SCOPE_POLICY, adoptedTables, adoptedViews, blockFileState, blockSqlVersion, contractSignature, customContracts, dataExportPlan, excludedColumns, expiredFlagsQuery, hasColumnAccess, migrationOptionUses, moduleDeprecations, moduleEventTriggers, moduleFileVersion, moduleLayout, notNullCheckName, renderBlocks, sameBlockFile, sameTenantColumn, sameTenantTrigger, scopePolicyName, sharedRolesProblems, subjectColumns, widenedCommands } from "better-supabase/sql";
+import { SECRET_COLUMNS, SQL_MODULES, TENANT_SCOPE_POLICY, adoptedTables, adoptedViews, appTablePolicyNotes, blockFileState, blockSqlVersion, contractSignature, customContracts, dataExportPlan, excludedColumns, expiredFlagsQuery, hasColumnAccess, migrationOptionUses, moduleDeprecations, moduleEventTriggers, moduleFileVersion, moduleLayout, notNullCheckName, renderBlocks, sameBlockFile, sameTenantColumn, sameTenantTrigger, scopePolicyName, sharedRolesProblems, subjectColumns, widenedCommands } from "better-supabase/sql";
 import { defineBucket, parseSize } from "better-supabase/storage";
 //#region src/cli/doctor/env.ts
 const PUBLIC_PREFIXES = [
@@ -141,6 +142,166 @@ const ENV_RULES = [
 	}
 ];
 //#endregion
+//#region src/cli/doctor/module-files.ts
+/** The `blocks` files as this release renders them, next to what is on disk. */
+async function moduleFiles(context) {
+	if (context.config.blockNames.length === 0 && Object.keys(context.config.appTables).length === 0) return [];
+	const access = accessModule(context);
+	if (access.kind === "invalid") return [];
+	const readSets = context.readSets;
+	const skipped = readSets !== void 0 && "skipped" in readSets;
+	let rendered;
+	try {
+		rendered = renderBlocks(context.config.blockNames, await moduleLayoutFor(context.config, {
+			names: context.config.blockNames,
+			testsDir: context.config.sql.testsDir,
+			readSets: skipped ? [] : readSets,
+			entitlementsProvider: entitlementsModule(context),
+			accessProvider: access.kind === "provider" ? access.access : void 0,
+			permissionCatalog: permissionCatalogKeys(context)
+		}));
+	} catch {
+		return [];
+	}
+	const files = rendered.filter((file) => !(skipped && file.module === "read-sets"));
+	if (workflowOf(context) === "migrations") {
+		const latest = await latestMigration(context.config, MODULES_SUFFIX);
+		const versions = migrationModules(latest?.text ?? "");
+		const path = latest?.path ?? `${migrationsDir(context.config)}/<stamp>_better_supabase_modules.sql`;
+		return Promise.all(files.map(async (file) => {
+			if (file.kind === "test") return fileState(context, file);
+			const installed = versions.get(file.instance ?? file.module);
+			return {
+				file,
+				path,
+				installed,
+				current: latest === void 0 ? void 0 : migrationHolds(latest.text, file.contents) ? file.contents : latest.text,
+				behind: file.kind === "schema" && installed !== void 0 && installed < (moduleFileVersion(file.contents)?.version ?? 1)
+			};
+		}));
+	}
+	return Promise.all(files.map((file) => fileState(context, file)));
+}
+async function fileState(context, file) {
+	const current = await readFile(resolve(context.config.root, file.path), "utf-8").catch(() => void 0);
+	const installed = current === void 0 ? void 0 : moduleFileVersion(current)?.version ?? 1;
+	return {
+		file,
+		path: file.path,
+		current,
+		installed,
+		behind: installed !== void 0 && installed < (moduleFileVersion(file.contents)?.version ?? 1)
+	};
+}
+//#endregion
+//#region src/cli/doctor/app-table-policies.ts
+/**
+* Block policies (`bsb_*`, permissive) on the app's tables that grant a command
+* more than the app's own permissive policies do. Postgres ORs permissive
+* policies, so a block policy whose condition no app policy repeats can open
+* rows the app's policies keep closed. A command the app has no policy for is
+* the block's to grant.
+*/
+function widenedAppTablePolicies(context) {
+	const tables = adoptedTables(context.config.blocks, appTablesOf(context));
+	if (tables.length === 0) return [];
+	const modules = /* @__PURE__ */ new Map();
+	for (const table of tables) {
+		if (context.config.blocks[table.module]?.ownTablePolicies === "app") continue;
+		const target = `${table.schema}.${table.table}`;
+		modules.set(target, (modules.get(target) ?? /* @__PURE__ */ new Set()).add(table.module));
+	}
+	return catalogOf(context).tables.flatMap((table) => {
+		const target = qualified(table);
+		const owners = modules.get(target);
+		if (owners === void 0) return [];
+		const permissive = table.policies.filter((policy) => policy.permissive);
+		const own = permissive.filter((policy) => !policy.name.startsWith(BLOCK_PREFIX));
+		const blocks = [...owners].map((module) => `blocks.${module}`).join(" or ");
+		return permissive.filter((policy) => policy.name.startsWith(BLOCK_PREFIX)).flatMap((policy) => {
+			const widened = widenedCommands(policy, own);
+			if (widened.length === 0) return [];
+			const reason = `no policy of the app's for ${widened.join(", ")} reaches its roles with a condition it repeats (alone or with more "and" operands), so it can open rows the app's policies keep closed`;
+			return [{
+				message: `${blocks} adds policy ${policy.name} on ${target}, and ${reason}. Postgres ORs permissive policies; doctor compares conditions as text and can't prove that one implies another. If the block's condition is what the app means, repeat it in the app's policy; otherwise narrow the permission key it checks, drop ${policy.name} in a schema file that runs after the block's, or set ownTablePolicies: "app" on the block (or in database.sql) so the app's policies alone govern the table.`,
+				target: `${target}.${policy.name}`,
+				object: {
+					kind: "policy",
+					schema: table.schema,
+					table: table.name,
+					name: policy.name
+				}
+			}];
+		});
+	});
+}
+async function appTablesWithoutPolicies(context) {
+	const states = await moduleFiles(context);
+	const left = /* @__PURE__ */ new Map();
+	for (const { file } of states) {
+		if (file.kind !== "schema") continue;
+		for (const note of appTablePolicyNotes(file.contents)) {
+			const entry = left.get(note.table) ?? {
+				blocks: /* @__PURE__ */ new Set(),
+				commands: /* @__PURE__ */ new Set()
+			};
+			entry.blocks.add(`blocks.${file.instance ?? file.module}`);
+			for (const command of note.commands) entry.commands.add(command);
+			left.set(note.table, entry);
+		}
+	}
+	if (left.size === 0) return [];
+	return catalogOf(context).tables.flatMap((table) => {
+		const target = qualified(table);
+		const entry = left.get(target);
+		if (entry === void 0) return [];
+		const missing = [...entry.commands].filter((command) => !table.policies.some((policy) => policy.permissive && (policy.command === "all" || policy.command === command)));
+		if (missing.length === 0) return [];
+		return [{
+			message: `${[...entry.blocks].join(" and ")} leaves the policies on ${target} to the app's (ownTablePolicies "app"), and ${target} ${table.rls ? "has row level security on" : "has row level security off, which the block's file turns on,"} but no permissive policy for ${missing.join(", ")}, which the block's own policies would have granted. Postgres then denies those commands to every caller, so the block's functions that run as the caller and its TypeScript API find no rows for them. Add the app's policy for each command the app uses, or set ownTablePolicies to "block" for this block.`,
+			target,
+			object: {
+				kind: "table",
+				schema: table.schema,
+				name: table.name
+			},
+			...missing.includes("select") ? {} : { severity: "info" }
+		}];
+	});
+}
+const KEPT_TRIGGER = /^-- (\S+) keeps updated_at current with its own trigger (\S+)\.$/gm;
+/**
+* App tables whose own trigger keeps `updated_at` current, so the block skipped
+* its `bsb_updated_at` trigger there.
+*/
+async function keptUpdatedAtTriggers(context) {
+	return (await moduleFiles(context)).flatMap(({ file }) => file.kind === "schema" ? [...file.contents.matchAll(KEPT_TRIGGER)].map(([, target = "", trigger = ""]) => {
+		const dot = target.indexOf(".");
+		return {
+			message: `blocks.${file.instance ?? file.module} runs over ${target}, which keeps updated_at current with its own trigger ${trigger}, so the block adds no bsb_updated_at trigger there. Keep ${trigger} firing on update; if you drop it, run \`better-supabase upgrade\` to add the block's.`,
+			target,
+			object: {
+				kind: "table",
+				schema: target.slice(0, dot),
+				name: target.slice(dot + 1)
+			}
+		};
+	}) : []);
+}
+/**
+* Whether a deprecated table or column name belongs to the app: the app's
+* tables keep the app's names, as custom blocks' tables do.
+*/
+function keepsAppsName(context) {
+	const adopted = context.config.blockNames.some((name) => moduleDeprecations().some((entry) => entry.module === name && (entry.kind === "table" || entry.kind === "column"))) ? adoptedTables(context.config.blocks, appTablesOf(context)) : [];
+	return (entry) => {
+		if (entry.kind !== "table" && entry.kind !== "column") return false;
+		if ((context.config.blocks[entry.module]?.mode ?? "managed") !== "managed") return true;
+		const name = entry.kind === "table" ? entry.symbol.slice(entry.symbol.lastIndexOf(".") + 1) : entry.symbol.slice(0, entry.symbol.indexOf("."));
+		return adopted.some((table) => table.module === entry.module && (name === table.logical || name === table.table || name === SQL_MODULES[table.module]?.names?.tables[table.logical]?.name));
+	};
+}
+//#endregion
 //#region src/cli/doctor/adoption.ts
 const tagText = (notNull) => notNull === true ? "@notNull" : `@notNull(${notNull.join(", ")})`;
 const sameNotNull = (a, b) => a === true || b === true ? a === b : a !== void 0 && a.length === b.length && a.every((name) => b.includes(name));
@@ -273,6 +434,13 @@ const ADOPTION_RULES = [
 			}));
 		}
 	},
+	{
+		code: "BS350",
+		severity: "warning",
+		title: "App table governs its policies but lacks one for a command",
+		description: "A block runs over a table of the app's with `ownTablePolicies: \"app\"`, so it adds none of its `bsb_` policies there, and the table has no permissive policy for a command one of those policies would have granted. With row level security on, or off (the block's file turns it on), Postgres denies that command to every caller, so the block's functions that run as the caller and its TypeScript API find no rows for it. A missing `select` policy is a warning, a missing write policy is info. Add the app's own policy for each command the app uses, or set `ownTablePolicies` back to `block` for the block.",
+		check: appTablesWithoutPolicies
+	},
 	{
 		code: "BS341",
 		severity: "warning",
@@ -1209,131 +1377,6 @@ function skippedForMetadata(snapshot, rule, help) {
 	};
 }
 //#endregion
-//#region src/cli/doctor/module-files.ts
-/** The `blocks` files as this release renders them, next to what is on disk. */
-async function moduleFiles(context) {
-	if (context.config.blockNames.length === 0 && Object.keys(context.config.appTables).length === 0) return [];
-	const access = accessModule(context);
-	if (access.kind === "invalid") return [];
-	const readSets = context.readSets;
-	const skipped = readSets !== void 0 && "skipped" in readSets;
-	let rendered;
-	try {
-		rendered = renderBlocks(context.config.blockNames, await moduleLayoutFor(context.config, {
-			names: context.config.blockNames,
-			testsDir: context.config.sql.testsDir,
-			readSets: skipped ? [] : readSets,
-			entitlementsProvider: entitlementsModule(context),
-			accessProvider: access.kind === "provider" ? access.access : void 0,
-			permissionCatalog: permissionCatalogKeys(context)
-		}));
-	} catch {
-		return [];
-	}
-	const files = rendered.filter((file) => !(skipped && file.module === "read-sets"));
-	if (workflowOf(context) === "migrations") {
-		const latest = await latestMigration(context.config, MODULES_SUFFIX);
-		const versions = migrationModules(latest?.text ?? "");
-		const path = latest?.path ?? `${migrationsDir(context.config)}/<stamp>_better_supabase_modules.sql`;
-		return Promise.all(files.map(async (file) => {
-			if (file.kind === "test") return fileState(context, file);
-			const installed = versions.get(file.instance ?? file.module);
-			return {
-				file,
-				path,
-				installed,
-				current: latest === void 0 ? void 0 : migrationHolds(latest.text, file.contents) ? file.contents : latest.text,
-				behind: file.kind === "schema" && installed !== void 0 && installed < (moduleFileVersion(file.contents)?.version ?? 1)
-			};
-		}));
-	}
-	return Promise.all(files.map((file) => fileState(context, file)));
-}
-async function fileState(context, file) {
-	const current = await readFile(resolve(context.config.root, file.path), "utf-8").catch(() => void 0);
-	const installed = current === void 0 ? void 0 : moduleFileVersion(current)?.version ?? 1;
-	return {
-		file,
-		path: file.path,
-		current,
-		installed,
-		behind: installed !== void 0 && installed < (moduleFileVersion(file.contents)?.version ?? 1)
-	};
-}
-//#endregion
-//#region src/cli/doctor/app-table-policies.ts
-/**
-* Block policies (`bsb_*`, permissive) on the app's tables that grant a command
-* more than the app's own permissive policies do. Postgres ORs permissive
-* policies, so a block policy whose condition no app policy repeats can open
-* rows the app's policies keep closed. A command the app has no policy for is
-* the block's to grant.
-*/
-function widenedAppTablePolicies(context) {
-	const tables = adoptedTables(context.config.blocks, appTablesOf(context));
-	if (tables.length === 0) return [];
-	const modules = /* @__PURE__ */ new Map();
-	for (const table of tables) {
-		const target = `${table.schema}.${table.table}`;
-		modules.set(target, (modules.get(target) ?? /* @__PURE__ */ new Set()).add(table.module));
-	}
-	return catalogOf(context).tables.flatMap((table) => {
-		const target = qualified(table);
-		const owners = modules.get(target);
-		if (owners === void 0) return [];
-		const permissive = table.policies.filter((policy) => policy.permissive);
-		const own = permissive.filter((policy) => !policy.name.startsWith(BLOCK_PREFIX));
-		const blocks = [...owners].map((module) => `blocks.${module}`).join(" or ");
-		return permissive.filter((policy) => policy.name.startsWith(BLOCK_PREFIX)).flatMap((policy) => {
-			const widened = widenedCommands(policy, own);
-			if (widened.length === 0) return [];
-			const reason = `no policy of the app's for ${widened.join(", ")} reaches its roles with a condition it repeats (alone or with more "and" operands), so it can open rows the app's policies keep closed`;
-			return [{
-				message: `${blocks} adds policy ${policy.name} on ${target}, and ${reason}. Postgres ORs permissive policies; doctor compares conditions as text and can't prove that one implies another. If the block's condition is what the app means, repeat it in the app's policy; otherwise narrow the permission key it checks, or drop ${policy.name} in a schema file that runs after the block's.`,
-				target: `${target}.${policy.name}`,
-				object: {
-					kind: "policy",
-					schema: table.schema,
-					table: table.name,
-					name: policy.name
-				}
-			}];
-		});
-	});
-}
-const KEPT_TRIGGER = /^-- (\S+) keeps updated_at current with its own trigger (\S+)\.$/gm;
-/**
-* App tables whose own trigger keeps `updated_at` current, so the block skipped
-* its `bsb_updated_at` trigger there.
-*/
-async function keptUpdatedAtTriggers(context) {
-	return (await moduleFiles(context)).flatMap(({ file }) => file.kind === "schema" ? [...file.contents.matchAll(KEPT_TRIGGER)].map(([, target = "", trigger = ""]) => {
-		const dot = target.indexOf(".");
-		return {
-			message: `blocks.${file.instance ?? file.module} runs over ${target}, which keeps updated_at current with its own trigger ${trigger}, so the block adds no bsb_updated_at trigger there. Keep ${trigger} firing on update; if you drop it, run \`better-supabase upgrade\` to add the block's.`,
-			target,
-			object: {
-				kind: "table",
-				schema: target.slice(0, dot),
-				name: target.slice(dot + 1)
-			}
-		};
-	}) : []);
-}
-/**
-* Whether a deprecated table or column name belongs to the app: the app's
-* tables keep the app's names, as custom blocks' tables do.
-*/
-function keepsAppsName(context) {
-	const adopted = context.config.blockNames.some((name) => moduleDeprecations().some((entry) => entry.module === name && (entry.kind === "table" || entry.kind === "column"))) ? adoptedTables(context.config.blocks, appTablesOf(context)) : [];
-	return (entry) => {
-		if (entry.kind !== "table" && entry.kind !== "column") return false;
-		if ((context.config.blocks[entry.module]?.mode ?? "managed") !== "managed") return true;
-		const name = entry.kind === "table" ? entry.symbol.slice(entry.symbol.lastIndexOf(".") + 1) : entry.symbol.slice(0, entry.symbol.indexOf("."));
-		return adopted.some((table) => table.module === entry.module && (name === table.logical || name === table.table || name === SQL_MODULES[table.module]?.names?.tables[table.logical]?.name));
-	};
-}
-//#endregion
 //#region src/cli/doctor/attachment-subjects.ts
 /**
 * The attachments subjects as the block resolves them, with the per-subject
@@ -2093,7 +2136,7 @@ const MODULE_RULES = [
 		code: "BS347",
 		severity: "warning",
 		title: "Block policy widens an app table's access",
-		description: "A block runs over a table of the app's and adds its own permissive policy there, named `bsb_<table>_<command>` so it never replaces one of the app's. Postgres ORs permissive policies, so when the app has its own policies for that command and none has the same condition (or `true`) for the same roles, the block's policy can let a user reach rows the app's policies keep closed. A block condition that is the app's, or one of its `or` operands, with more `and` operands is narrower and isn't reported, nor is a command the app has no policy for, which is the block's to grant. Doctor compares the conditions as text. When an app policy covers the block's in this sense, `upgrade` leaves the block's policy out. Repeat the block's condition in the app's policy when it is what the app means; otherwise narrow the permission key the block checks, or drop the `bsb_` policy in a schema file that runs after the block's.",
+		description: "A block runs over a table of the app's and adds its own permissive policy there, named `bsb_<table>_<command>` so it never replaces one of the app's. Postgres ORs permissive policies, so when the app has its own policies for that command and none has the same condition (or `true`) for the same roles, the block's policy can let a user reach rows the app's policies keep closed. A block condition that is the app's, or one of its `or` operands, with more `and` operands is narrower and isn't reported, nor is a command the app has no policy for, which is the block's to grant. Doctor compares the conditions as text. When an app policy covers the block's in this sense, `upgrade` leaves the block's policy out. Repeat the block's condition in the app's policy when it is what the app means; otherwise narrow the permission key the block checks, drop the `bsb_` policy in a schema file that runs after the block's, or set `ownTablePolicies: \"app\"` on the block (or in `database.sql`) so the app's policies alone govern the table and the block adds none there.",
 		check: widenedAppTablePolicies
 	},
 	{

package/dist/cli/{env-BBl5L8Bf.js → env-BCgVZkcb.js}

@@ -1,4 +1,4 @@
-import { p as commandMeta, r as defineCliCommand } from "./command-CQ61x6gN.js";
+import { p as commandMeta, r as defineCliCommand } from "./command-BWEEXmtz.js";
 import { n as CliError } from "./errors-BTe6A15O.js";
 import { r as readIfExists, t as display } from "./io-DH1kcmmP.js";
 import { n as readStackStatus, t as parseStackStatus } from "./stack-status-B_Ipd_-z.js";

package/dist/cli/env-xhwXk5Ri.js

@@ -0,0 +1 @@
+export { n as envCommand } from "./env-BCgVZkcb.js";

package/dist/cli/{gen-CFkYUnWq.js → gen-D7gMEwvg.js}

@@ -1,21 +1,22 @@
-import { a as list, p as commandMeta, r as defineCliCommand } from "./command-CQ61x6gN.js";
+import { a as list, p as commandMeta, r as defineCliCommand } from "./command-BWEEXmtz.js";
 import { i as plain } from "./style-Bm2X5JrN.js";
 import { a as parseNames, i as failedResult, n as CliError } from "./errors-BTe6A15O.js";
-import { u as catalogFingerprint } from "./cache-AznIssjI.js";
-import { a as serializeSnapshot, g as serializeGenerator, h as restrictSchemas, o as snapshotFile, r as openSource, t as loadSnapshot } from "./snapshot-uTUlEzY2.js";
-import { f as dataMigration } from "./module-migration-O_IxewFs.js";
-import { d as GEN_TASKS, p as isGenTask } from "./config-9t5ec_N7.js";
+import { u as catalogFingerprint } from "./cache-DE2IH1-C.js";
+import { a as serializeSnapshot, g as serializeGenerator, h as restrictSchemas, o as snapshotFile, r as openSource, t as loadSnapshot } from "./snapshot-BXmU3IXN.js";
+import { n as dataMigration } from "./migrations-BoIyGczt.js";
+import { d as GEN_TASKS, p as isGenTask } from "./config-BJSqMi04.js";
 import { c as insideRoot, r as applyPlan, u as planResult } from "./files-CX71yBm8.js";
-import { n as runGen } from "./run-Bs4OKdDI.js";
-import { t as syncModules } from "./sync-CZMRB3aU.js";
-import { t as addModules } from "./add-I8OW-qJH.js";
-import { n as listModules, t as printModule } from "./print-DosQIFSy.js";
-import { a as sourceFlags, i as sourceArgs, n as SOURCE_ARGS } from "./source-args-IpJRJO5t.js";
-import { a as runMetadataGen, n as checkMetadataFlags, t as EMITS } from "./metadata-BfgHMe4q.js";
-import { a as runEnv } from "./env-BBl5L8Bf.js";
-import { c as watchLoop, o as parseInterval, r as specOptionsFromConfig, s as stampFiles, t as runSpec } from "./spec-Cm2einTO.js";
-import { t as runSeed } from "./seed-Cz8PcXeT.js";
-import { t as upgrade } from "./upgrade-BFEIMC7U.js";
+import { n as runGen } from "./run-jeplMBOK.js";
+import { t as syncModules } from "./sync-s1iKFIos.js";
+import { t as addModules } from "./add-D7YIXslp.js";
+import { n as listModules, t as printModule } from "./print-CRon4lXf.js";
+import { a as sourceFlags, i as sourceArgs, n as SOURCE_ARGS } from "./source-args-DlckPVje.js";
+import { a as runMetadataGen, n as checkMetadataFlags, t as EMITS } from "./metadata-BTihErEc.js";
+import { a as runEnv } from "./env-BCgVZkcb.js";
+import { c as watchLoop, o as parseInterval, r as specOptionsFromConfig, s as stampFiles, t as runSpec } from "./spec-CDxfokey.js";
+import { n as runPowerSync } from "./powersync-D-0yV_L_.js";
+import { t as runSeed } from "./seed-D9mt8bnW.js";
+import { t as upgrade } from "./upgrade-B4FPlK-_.js";
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
 //#region src/cli/commands/sql.ts
@@ -60,6 +61,7 @@ function configuredTasks(config) {
 	const configured = {
 		types: () => true,
 		sql: () => config.blockNames.length > 0 || config.realtime.policies !== void 0,
+		powersync: () => config.gen.powersync !== void 0,
 		spec: () => exists(config.specs.entry),
 		seed: () => exists(config.seed.entry),
 		env: () => false
@@ -75,6 +77,7 @@ function stepInputs(config, tasks) {
 	const inputs = {
 		types: () => [],
 		sql: () => [],
+		powersync: () => [],
 		spec: () => [at(config.specs.entry), ...config.specs.outputs.flatMap((output) => (output.overlays ?? []).map(at))],
 		seed: () => [at(config.seed.entry)],
 		env: () => []
@@ -87,6 +90,10 @@ const STEPS = {
 		check,
 		"dry-run": dryRun
 	}, paint),
+	powersync: ({ config, check, dryRun }) => runPowerSync(config, {
+		check,
+		"dry-run": dryRun
+	}),
 	spec: ({ config, check, dryRun }) => runSpec(specOptionsFromConfig(config, check ? "check" : "emit", dryRun === true ? { dryRun } : {})),
 	seed: ({ config, check, dryRun, env }) => runSeed(config, {
 		check,

package/dist/cli/index.d.ts

@@ -498,7 +498,7 @@ interface SchemaExtension {
  * options its TypeScript side reads, for `defineBlocks(blockConfig, ...)`, and
  * the app table events. `undefined` when the config installs no blocks.
  */
-export declare function emitBlockConfig(config: Pick<ResolvedConfig, "appTables" | "blocks" | "blockNames" | "buckets" | "casing" | "instances" | "output" | "sql" | "subjects">, options?: {
+export declare function emitBlockConfig(config: Pick<ResolvedConfig, "appTables" | "blocks" | "blockNames" | "buckets" | "casing" | "instances" | "output" | "gen" | "sql" | "subjects">, options?: {
   readonly runtimeImport?: string;
 }): GeneratedFile | undefined;
 //#endregion
@@ -798,6 +798,6 @@ export declare function emitModule(model: Model, options: EmitOptions): string;
 export declare function loadConfig(cwd: string, explicit?: string, environment?: string, path?: string | undefined): Promise<ResolvedConfig>;
 //#endregion
 //#region src/cli/version.d.ts
-export declare const VERSION = "0.16.0";
+export declare const VERSION = "0.18.0";
 //#endregion
 export type { Catalog, CatalogCheck, CatalogColumn, CatalogColumnGrant, CatalogEnum, CatalogForeignKey, CatalogFunction, CatalogFunctionArg, CatalogGrant, CatalogIndex, CatalogPolicy, CatalogTable, CatalogTrigger, CatalogUnique, Choice, Cli, CliArgs, CliCommand, CliCommandDef, CliContext, CliEnv, CliErrorCode, CliErrorOptions, CliIo, CliLog, CliProblem, CliProblemExtensions, CommandResult, CreateCliOptions, ExitCode, ExtrasFunction, ExtrasHook, ExtrasHookFunction, ExtrasTable, ForeignKeyAction, Format, GeneratorMetadata, IntrospectionSource, ManagementSourceOptions, NextStep, Paint, Prompter, Queryable, RunOptions, RunResult, Snapshot, SnapshotBucket, SnapshotExtras };

package/dist/cli/index.js

@@ -1,12 +1,12 @@
-import { a as list, r as defineCliCommand } from "./command-CQ61x6gN.js";
-import { i as run, n as createCli, r as help, t as commandNames } from "./run-MRET30vh.js";
-import { t as VERSION } from "./version-B2Dr6VmJ.js";
+import { a as list, r as defineCliCommand } from "./command-BWEEXmtz.js";
+import { i as run, n as createCli, r as help, t as commandNames } from "./run-x9ZY4Tm0.js";
+import { t as VERSION } from "./version-TgFM8sOd.js";
 import { n as CliError, t as CLI_ERRORS_URL } from "./errors-BTe6A15O.js";
-import { a as serializeSnapshot, i as parseSnapshot, l as introspect, t as loadSnapshot } from "./snapshot-uTUlEzY2.js";
-import { a as emitBlockConfig, l as buildModel, o as GENERATED_HEADER, r as renderFiles, s as emitModule } from "./render-5y5a1QZr.js";
-import { a as toCatalog, n as managementSource, r as pgSource } from "./source-D2gJHKwC.js";
-import { s as loadConfig } from "./config-9t5ec_N7.js";
-import { n as runGen } from "./run-Bs4OKdDI.js";
+import { a as serializeSnapshot, i as parseSnapshot, l as introspect, t as loadSnapshot } from "./snapshot-BXmU3IXN.js";
+import { a as emitBlockConfig, l as buildModel, o as GENERATED_HEADER, r as renderFiles, s as emitModule } from "./render-BJF9ytUi.js";
+import { a as toCatalog, n as managementSource, r as pgSource } from "./source-irttnsEb.js";
+import { s as loadConfig } from "./config-BJSqMi04.js";
+import { n as runGen } from "./run-jeplMBOK.js";
 //#region src/cli/introspect/from-catalog.ts
 /**
 * Builds a snapshot from catalog records: the inverse of `toCatalog`. Tests and

package/dist/cli/{init-CHj9ad4S.js → init-ch-HWJyp.js}

@@ -1,15 +1,15 @@
-import { a as list, p as commandMeta, r as defineCliCommand } from "./command-CQ61x6gN.js";
+import { a as list, p as commandMeta, r as defineCliCommand } from "./command-BWEEXmtz.js";
 import { i as plain } from "./style-Bm2X5JrN.js";
 import { n as CliError } from "./errors-BTe6A15O.js";
 import { r as readIfExists } from "./io-DH1kcmmP.js";
-import { l as TYPEGEN_VERSION } from "./cache-AznIssjI.js";
-import { a as findConfig, s as loadConfig } from "./config-9t5ec_N7.js";
-import { r as contentMapperFiles } from "./content-mapper-DCrz6OIv.js";
+import { l as TYPEGEN_VERSION } from "./cache-DE2IH1-C.js";
+import { a as findConfig, s as loadConfig } from "./config-BJSqMi04.js";
+import { r as contentMapperFiles } from "./content-mapper-CaygHH_k.js";
 import { i as changeLines, n as PLAN_ARGS, r as applyPlan, u as planResult } from "./files-CX71yBm8.js";
-import { C as promptConventions, S as hasConventionFlags, _ as templatePlan, b as conventionFlags, c as AUTHZ_NOTE, d as chooseIntegrations, f as integrationFiles, g as templateContextFor, h as parseIntegrations, i as blocksWiringPath, l as createUrlParam, m as packagesFor, o as writeDesign, p as overwrite, r as blockConfigImport, s as readPresetInput, u as CANCELLED, v as CONVENTION_ARGS, w as withConventions, x as defaultConventions, y as CONVENTION_COMPLETIONS } from "./add-D7TkPdco.js";
-import { a as wiringFiles, c as baseFiles, f as needsLib, i as wiringChecklist, m as suggestedIntegrations, n as latestMigrationVersion, o as wiringFor, p as resolveIntegrations, r as configInstances, s as TEMPLATES } from "./migration-safety-BnnXPAro.js";
+import { C as promptConventions, S as hasConventionFlags, _ as templatePlan, b as conventionFlags, c as AUTHZ_NOTE, d as chooseIntegrations, f as integrationFiles, g as templateContextFor, h as parseIntegrations, i as blocksWiringPath, l as createUrlParam, m as packagesFor, o as writeDesign, p as overwrite, r as blockConfigImport, s as readPresetInput, u as CANCELLED, v as CONVENTION_ARGS, w as withConventions, x as defaultConventions, y as CONVENTION_COMPLETIONS } from "./add-B1S3yK4L.js";
+import { a as wiringFiles, c as baseFiles, f as needsLib, i as wiringChecklist, m as suggestedIntegrations, n as latestMigrationVersion, o as wiringFor, p as resolveIntegrations, r as configInstances, s as TEMPLATES } from "./migration-safety-DYo1vVWC.js";
 import { n as installCommand, t as detectProject } from "./detect-D9JaAX20.js";
-import { s as enablePgDelta, t as syncModules } from "./sync-CZMRB3aU.js";
+import { s as enablePgDelta, t as syncModules } from "./sync-s1iKFIos.js";
 import { existsSync } from "node:fs";
 import { join, posix, resolve } from "node:path";
 import { glob, readFile } from "node:fs/promises";

package/dist/cli/{keys-DGEpMbeB.js → keys-CbaL0lnw.js}

@@ -1,4 +1,4 @@
-import { p as commandMeta, r as defineCliCommand } from "./command-CQ61x6gN.js";
+import { p as commandMeta, r as defineCliCommand } from "./command-BWEEXmtz.js";
 import { t as display } from "./io-DH1kcmmP.js";
 import { m as supabaseDir } from "./supabase-toml-CncmQbO0.js";
 import { i as changeLines, r as applyPlan } from "./files-CX71yBm8.js";

package/dist/cli/{live-DGdLR41j.js → live-B38ePuRS.js}

@@ -1,6 +1,6 @@
 import { r as errorText } from "./errors-BTe6A15O.js";
-import "./source-D2gJHKwC.js";
-import { l as tableObject, n as exposed, s as qualified, t as catalogOf } from "./shared-BLqbvY2x.js";
+import "./source-irttnsEb.js";
+import { l as tableObject, n as exposed, s as qualified, t as catalogOf } from "./shared-B38Chjgd.js";
 //#region src/cli/doctor/reserved-roles.ts
 /**
 * Supautils' `reserved_roles` on Supabase. Nobody but a superuser may alter,

package/dist/cli/{mcp-BZno503V.js → mcp-P9RP2SJ3.js}

@@ -1,6 +1,6 @@
-import { p as commandMeta, r as defineCliCommand } from "./command-CQ61x6gN.js";
-import { a as envelope, i as run } from "./run-MRET30vh.js";
-import { t as VERSION } from "./version-B2Dr6VmJ.js";
+import { p as commandMeta, r as defineCliCommand } from "./command-BWEEXmtz.js";
+import { a as envelope, i as run } from "./run-x9ZY4Tm0.js";
+import { t as VERSION } from "./version-TgFM8sOd.js";
 import { n as CliError } from "./errors-BTe6A15O.js";
 import { n as consentToken } from "./agent-CbuPvI2x.js";
 import { C as optional, D as record, N as unknown, a as array, d as is, j as string$1, k as safeParse, o as boolean, t as PROCESS_ENV, x as object } from "./env-DMgjB_4y.js";

package/dist/cli/{metadata-BfgHMe4q.js → metadata-BTihErEc.js}

@@ -1,8 +1,8 @@
 import { n as CliError, r as errorText } from "./errors-BTe6A15O.js";
 import { i as readStdin } from "./io-DH1kcmmP.js";
-import { m as parseMetadataDocument, u as MetadataRejectedError } from "./snapshot-uTUlEzY2.js";
-import { c as metaPaths, n as render } from "./render-5y5a1QZr.js";
-import { i as generationNotices, n as runGen, o as fromMetadata, r as UNFORMATTED, t as refuseRowConditionedBuckets } from "./run-Bs4OKdDI.js";
+import { m as parseMetadataDocument, u as MetadataRejectedError } from "./snapshot-BXmU3IXN.js";
+import { c as metaPaths, n as render } from "./render-BJF9ytUi.js";
+import { i as generationNotices, n as runGen, o as fromMetadata, r as UNFORMATTED, t as refuseRowConditionedBuckets } from "./run-jeplMBOK.js";
 import { basename, join, relative, resolve, sep } from "node:path";
 import { readFile } from "node:fs/promises";
 import { jsonSchema, standardSchema, valibot, zod } from "better-supabase/config";

package/dist/cli/{migration-safety-BnnXPAro.js → migration-safety-DYo1vVWC.js}

@@ -1,5 +1,5 @@
-import { f as INTEGRATIONS } from "./config-9t5ec_N7.js";
-import { c as splitStatements } from "./shared-BLqbvY2x.js";
+import { f as INTEGRATIONS } from "./config-BJSqMi04.js";
+import { c as splitStatements } from "./shared-B38Chjgd.js";
 import { dirname, join, posix } from "node:path";
 import { readdir } from "node:fs/promises";
 import { INTEGRATION_INFO, groupEntries } from "better-supabase/config";