better-supabase 0.17.0 → 0.18.1

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.17.0";
+export declare const VERSION = "0.18.1";
 //#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-D48ZEU58.js";
-import { t as VERSION } from "./version-T507a49w.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-Q5V5Kle1.js";
+import { t as VERSION } from "./version-DzroJkIT.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-C6vh_n3t.js";
-import { a as emitBlockConfig, l as buildModel, o as GENERATED_HEADER, r as renderFiles, s as emitModule } from "./render-ChIwdIOJ.js";
-import { a as toCatalog, n as managementSource, r as pgSource } from "./source-BZbEK5if.js";
-import { s as loadConfig } from "./config-2rwFHbwj.js";
-import { n as runGen } from "./run-CLSHSVYo.js";
+import { a as serializeSnapshot, i as parseSnapshot, l as introspect, t as loadSnapshot } from "./snapshot-k4R6vT20.js";
+import { a as emitBlockConfig, l as buildModel, o as GENERATED_HEADER, r as renderFiles, s as emitModule } from "./render-D9c5ynjR.js";
+import { a as toCatalog, n as managementSource, r as pgSource } from "./source-MMQKgaIx.js";
+import { s as loadConfig } from "./config-BJSqMi04.js";
+import { n as runGen } from "./run-CuzSU8Sk.js";
 //#region src/cli/introspect/from-catalog.ts
 /**
 * Builds a snapshot from catalog records: the inverse of `toCatalog`. Tests and

package/dist/cli/{init-DrQlf9RL.js → init-Dxvlzka4.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-oU0yHKf0.js";
-import { a as findConfig, s as loadConfig } from "./config-2rwFHbwj.js";
-import { r as contentMapperFiles } from "./content-mapper-DLbXilBz.js";
+import { l as TYPEGEN_VERSION } from "./cache-BxohmNou.js";
+import { a as findConfig, s as loadConfig } from "./config-BJSqMi04.js";
+import { r as contentMapperFiles } from "./content-mapper-D54wumPS.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-DMcrsWjC.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-NtB3dsRU.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-C5kLXuqn.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-DYgarZxP.js";
 import { n as installCommand, t as detectProject } from "./detect-D9JaAX20.js";
-import { s as enablePgDelta, t as syncModules } from "./sync-CHGMZCJ5.js";
+import { s as enablePgDelta, t as syncModules } from "./sync-DYQVml8j.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/{legacy-prefix-DkTA3Rhx.js → legacy-prefix-R7UChFFl.js}

@@ -21,11 +21,11 @@ function legacyPrefixNames(text) {
 }
 const array = (values) => `array[${values.map((value) => `'${value.replaceAll("'", "''")}'`).join(", ")}]::text[]`;
 /**
-* Renames the installed `bs_` triggers, policies, constraints, indexes and
-* functions to `bsb_`, so the module files' `drop ... if exists bsb_x` replace
-* them instead of adding a second copy. Only the names in `names` and the
-* runtime prefixes are renamed, and only while the new name is free, so the
-* step can run again.
+* Renames the installed `bs_` triggers, event triggers, policies, constraints,
+* indexes and functions to `bsb_`, so the module files' `drop ... if exists
+* bsb_x` replace them instead of adding a second copy. Only the names in
+* `names` and the runtime prefixes are renamed, and only while the new name is
+* free, so the step can run again.
 */
 function legacyPrefixSql(names) {
 	return `do $bsb_rename$
@@ -48,6 +48,19 @@ begin
     end;
   end loop;
 
+  for r in
+    select e.evtname as name
+    from pg_event_trigger e
+    where (e.evtname = any (v_names) or exists (select 1 from unnest(v_prefixes) x where starts_with(e.evtname, x)))
+      and not exists (select 1 from pg_event_trigger f where f.evtname = 'bsb_' || substr(e.evtname, 4))
+  loop
+    begin
+      execute format('alter event trigger %I rename to %I', r.name, 'bsb_' || substr(r.name, 4));
+    exception when insufficient_privilege then
+      raise warning 'better-supabase: rename % to bsb_% by hand; the migration role does not own it', r.name, substr(r.name, 4);
+    end;
+  end loop;
+
   for r in
     select p.polname as name, p.polrelid::regclass::text as rel
     from pg_policy p

package/dist/cli/{live-BvWGM4c3.js → live-C-0OdLKE.js}

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

package/dist/cli/{mcp-BrOnGB15.js → mcp-3q5RDvYJ.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-D48ZEU58.js";
-import { t as VERSION } from "./version-T507a49w.js";
+import { p as commandMeta, r as defineCliCommand } from "./command-BWEEXmtz.js";
+import { a as envelope, i as run } from "./run-Q5V5Kle1.js";
+import { t as VERSION } from "./version-DzroJkIT.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-BNSdPuKp.js → metadata-Dvc6U3bk.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-C6vh_n3t.js";
-import { c as metaPaths, n as render } from "./render-ChIwdIOJ.js";
-import { i as generationNotices, n as runGen, o as fromMetadata, r as UNFORMATTED, t as refuseRowConditionedBuckets } from "./run-CLSHSVYo.js";
+import { m as parseMetadataDocument, u as MetadataRejectedError } from "./snapshot-k4R6vT20.js";
+import { c as metaPaths, n as render } from "./render-D9c5ynjR.js";
+import { i as generationNotices, n as runGen, o as fromMetadata, r as UNFORMATTED, t as refuseRowConditionedBuckets } from "./run-CuzSU8Sk.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-NtB3dsRU.js → migration-safety-DYgarZxP.js}

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

package/dist/cli/{module-migration-mKhX88V_.js → migrations-Cwh5VvUC.js}

@@ -2,7 +2,7 @@ import { n as CliError } from "./errors-BTe6A15O.js";
 import { d as readSupabaseToml, p as sqlWorkflow } from "./supabase-toml-CncmQbO0.js";
 import { t as importFresh } from "./fresh-import-DzgsGHkX.js";
 import { i as changeLines, r as applyPlan } from "./files-CX71yBm8.js";
-import { a as sqlPlan, i as schemasDirOf, n as migrationsDir, r as moduleLayoutFor } from "./sql-layout-26LSoifK.js";
+import { a as sqlPlan, i as schemasDirOf, n as migrationsDir, r as moduleLayoutFor } from "./sql-layout-AByPAQXl.js";
 import { resolve } from "node:path";
 import { readFile, readdir } from "node:fs/promises";
 import { MODULE_ID_TYPES, compileReadSets, moduleIdType, moduleLayout, modulePermissionKeys, moduleSchemaExtensions, renderBlocks, resolveBlocks, scopeProblems, templateFunctions } from "better-supabase/sql";
@@ -374,7 +374,7 @@ async function dataMigration(config, args, now) {
 		error: [`No migration before the data migration creates ${missing.map((extension) => extension.name).join(", ")}, and the schema migration needs ${missing.length === 1 ? "it" : "them"} while it applies.`, "Run `better-supabase upgrade` to write the extensions migration, then create the schema migration again after it."].join("\n")
 	};
 	const files = rendered.filter((file) => file.kind === "data");
-	const contents = `-- better-supabase add --adopt: the rows and settings of ${files.map((file) => file.module).join(", ")}, which a schema diff skips.\n\n${files.map((file) => file.contents.trim()).join("\n\n")}\n`;
+	const contents = `-- better-supabase add --adopt: the rows and settings of ${files.map((file) => file.module).join(", ")}, which a schema diff skips.\n\nset lock_timeout = '5s';\n\n${files.map((file) => file.contents.trim()).join("\n\n")}\n`;
 	const dir = migrationsDir(config);
 	const existing = await readdir(resolve(config.root, dir)).catch(() => []);
 	const latest = existing.toSorted().findLast((name) => name.endsWith(DATA_SUFFIX));
@@ -410,114 +410,4 @@ async function dataMigration(config, args, now) {
 	};
 }
 //#endregion
-//#region src/cli/sql/module-migration.ts
-/** The migration the migrations workflow writes the SQL modules into. */
-const MODULES_SUFFIX = "_better_supabase_modules.sql";
-/**
-* The migration `gen` writes the read-sets module into under the migrations
-* workflow.
-*/
-const READ_SETS_SUFFIX = "_better_supabase_read_sets.sql";
-const UPGRADE_START = "-- @bsb-upgrade-start";
-const UPGRADE_END = "-- @bsb-upgrade-end";
-/**
-* Whether the project runs the migrations workflow, with no declarative
-* schemas.
-*/
-async function writesMigrations(config) {
-	return sqlWorkflow(config, await readSupabaseToml(config.root)) === "migrations";
-}
-/**
-* One migration that holds, in order, the extensions, the upgrade steps, each
-* module's schema body with its `@bsb-block` header, the realtime topic
-* policies and the data statements. Every statement is re-runnable, so a later
-* migration carries all of them, not only the changes.
-*/
-function renderModuleMigration(parts) {
-	const schema = parts.files.filter((file) => file.kind === "schema");
-	const data = parts.files.filter((file) => file.kind === "data");
-	const modules = [...new Set(schema.map((file) => file.instance ?? file.module))];
-	const extensions = moduleSchemaExtensions(parts.files);
-	const upgrade = parts.upgrade ?? [];
-	return `${[
-		[
-			`-- better-supabase sql: ${modules.length > 0 ? `the SQL modules ${modules.join(", ")}` : "the realtime topic policies"}, in one migration (database.sql.workflow: 'migrations').`,
-			"-- Managed by `better-supabase add` and `better-supabase upgrade`, which write a new migration when they change.",
-			"-- Change them through `blocks` in better-supabase.config.ts and the module's SQL hooks."
-		].join("\n"),
-		...extensions.length > 0 ? [extensions.map((extension) => extension.statement).join("\n")] : [],
-		...upgrade.length > 0 ? [[
-			UPGRADE_START,
-			...upgrade,
-			UPGRADE_END
-		].join("\n\n")] : [],
-		...schema.map((file) => file.contents.trim()),
-		...parts.topics === void 0 ? [] : [parts.topics.trim()],
-		...data.map((file) => file.contents.trim())
-	].join("\n\n")}\n`;
-}
-/**
-* The migration without its upgrade steps and package versions, which a later
-* one doesn't repeat.
-*/
-function comparable(text) {
-	return text.replaceAll("\r\n", "\n").replace(/\n\n-- @bsb?-upgrade-start\n[\s\S]*?\n-- @bsb?-upgrade-end/, "").replaceAll(/^(-- better-supabase module: [^\n(]*?)(?: \([^)]*\))?$/gm, "$1");
-}
-/** Whether two module migrations hold the same modules. */
-const sameModuleMigration = (current, expected) => current !== void 0 && comparable(current) === comparable(expected);
-/** Whether a module migration holds `contents` (one module's file) unchanged. */
-const migrationHolds = (text, contents) => comparable(text).includes(comparable(contents.trim()));
-/** The newest migration that ends in `suffix`, with its text. */
-async function latestMigration(config, suffix) {
-	const dir = migrationsDir(config);
-	const latest = (await readdir(resolve(config.root, dir)).catch(() => [])).toSorted().findLast((name) => name.endsWith(suffix));
-	if (latest === void 0) return;
-	return {
-		path: `${dir}/${latest}`,
-		text: await readFile(resolve(config.root, dir, latest), "utf-8")
-	};
-}
-const MODULE_MARKERS = /^-- @(?:bsb-block|bs-module) ([a-zA-Z0-9-]+)@(\d+)(?: [a-z]+(?: ([a-z0-9-]+))?)?$/gm;
-/**
-* The modules and versions a module migration installs, from its `@bsb-block`
-* lines.
-*/
-function migrationModules(text) {
-	return new Map([...text.matchAll(MODULE_MARKERS)].map((match) => [match[1], Number(match[2])]));
-}
-/**
-* The instances a module migration installs under another name than their
-* block, each to its block.
-*/
-function migrationInstances(text) {
-	return new Map([...text.matchAll(MODULE_MARKERS)].flatMap((match) => match[3] === void 0 ? [] : [[match[1], match[3]]]));
-}
-/**
-* Writes `contents` as a new migration ending in `suffix`, unless the newest
-* one already holds the same statements. `force` writes it anyway, for upgrade
-* steps that have to run once.
-*/
-async function writeLatestMigration(config, suffix, contents, options) {
-	const latest = await latestMigration(config, suffix);
-	if (options.force !== true && latest !== void 0 && sameModuleMigration(latest.text, contents)) return {
-		path: latest.path,
-		wrote: false,
-		line: `Unchanged ${latest.path} (it has these statements)`
-	};
-	const dir = migrationsDir(config);
-	const path = `${dir}/${stampAfter(await readdir(resolve(config.root, dir)).catch(() => []), options.now)}${suffix}`;
-	const applied = await applyPlan(sqlPlan(config, {
-		regenerate: "better-supabase upgrade",
-		files: [{
-			path,
-			contents
-		}]
-	}), { "dry-run": options.dryRun });
-	return {
-		path,
-		wrote: applied.mode === "write",
-		line: changeLines(applied).join("\n")
-	};
-}
-//#endregion
-export { entitlementsMode as C, unsafeKey as E, entitlementRequirements as S, providerLabel as T, layoutFor as _, migrationInstances as a, accessProviderMode as b, sameModuleMigration as c, DATA_NEXT as d, dataMigration as f, layout as g, MEMBERSHIP_CLAIM_MODULES as h, migrationHolds as i, writeLatestMigration as l, writeExtensionsMigration as m, READ_SETS_SUFFIX as n, migrationModules as o, migrationStamp as p, latestMigration as r, renderModuleMigration as s, MODULES_SUFFIX as t, writesMigrations as u, providerOwnsMemberships as v, moduleKeyProblems as w, accessRequirements as x, compiledReadSets as y };
+export { unsafeKey as _, writeExtensionsMigration as a, layoutFor as c, accessProviderMode as d, accessRequirements as f, providerLabel as g, moduleKeyProblems as h, stampAfter as i, providerOwnsMemberships as l, entitlementsMode as m, dataMigration as n, MEMBERSHIP_CLAIM_MODULES as o, entitlementRequirements as p, migrationStamp as r, layout as s, DATA_NEXT as t, compiledReadSets as u };

package/dist/cli/module-migration-CXtSwDLu.js

@@ -0,0 +1,119 @@
+import { i as stampAfter } from "./migrations-Cwh5VvUC.js";
+import { d as readSupabaseToml, p as sqlWorkflow } from "./supabase-toml-CncmQbO0.js";
+import { i as changeLines, r as applyPlan } from "./files-CX71yBm8.js";
+import { a as sqlPlan, n as migrationsDir } from "./sql-layout-AByPAQXl.js";
+import { resolve } from "node:path";
+import { readFile, readdir } from "node:fs/promises";
+import { moduleSchemaExtensions } from "better-supabase/sql";
+//#region src/cli/sql/module-migration.ts
+/** The migration the migrations workflow writes the SQL modules into. */
+const MODULES_SUFFIX = "_better_supabase_modules.sql";
+/**
+* The migration `gen` writes the read-sets module into under the migrations
+* workflow.
+*/
+const READ_SETS_SUFFIX = "_better_supabase_read_sets.sql";
+const UPGRADE_START = "-- @bsb-upgrade-start";
+const UPGRADE_END = "-- @bsb-upgrade-end";
+/**
+* Whether the project runs the migrations workflow, with no declarative
+* schemas.
+*/
+async function writesMigrations(config) {
+	return sqlWorkflow(config, await readSupabaseToml(config.root)) === "migrations";
+}
+/**
+* One migration that holds, in order, the extensions, the upgrade steps, each
+* module's schema body with its `@bsb-block` header, the realtime topic
+* policies and the data statements. Every statement is re-runnable, so a later
+* migration carries all of them, not only the changes.
+*/
+function renderModuleMigration(parts) {
+	const schema = parts.files.filter((file) => file.kind === "schema");
+	const data = parts.files.filter((file) => file.kind === "data");
+	const modules = [...new Set(schema.map((file) => file.instance ?? file.module))];
+	const extensions = moduleSchemaExtensions(parts.files);
+	const upgrade = parts.upgrade ?? [];
+	return `${[
+		[
+			`-- better-supabase sql: ${modules.length > 0 ? `the SQL modules ${modules.join(", ")}` : "the realtime topic policies"}, in one migration (database.sql.workflow: 'migrations').`,
+			"-- Managed by `better-supabase add` and `better-supabase upgrade`, which write a new migration when they change.",
+			"-- Change them through `blocks` in better-supabase.config.ts and the module's SQL hooks."
+		].join("\n"),
+		...extensions.length > 0 ? [extensions.map((extension) => extension.statement).join("\n")] : [],
+		...upgrade.length > 0 ? [[
+			UPGRADE_START,
+			...upgrade,
+			UPGRADE_END
+		].join("\n\n")] : [],
+		...schema.map((file) => file.contents.trim()),
+		...parts.topics === void 0 ? [] : [parts.topics.trim()],
+		...data.map((file) => file.contents.trim())
+	].join("\n\n")}\n`;
+}
+/**
+* The migration without its upgrade steps and package versions, which a later
+* one doesn't repeat.
+*/
+function comparable(text) {
+	return text.replaceAll("\r\n", "\n").replace(/\n\n-- @bsb?-upgrade-start\n[\s\S]*?\n-- @bsb?-upgrade-end/, "").replaceAll(/^(-- better-supabase module: [^\n(]*?)(?: \([^)]*\))?$/gm, "$1");
+}
+/** Whether two module migrations hold the same modules. */
+const sameModuleMigration = (current, expected) => current !== void 0 && comparable(current) === comparable(expected);
+/** Whether a module migration holds `contents` (one module's file) unchanged. */
+const migrationHolds = (text, contents) => comparable(text).includes(comparable(contents.trim()));
+/** The newest migration that ends in `suffix`, with its text. */
+async function latestMigration(config, suffix) {
+	const dir = migrationsDir(config);
+	const latest = (await readdir(resolve(config.root, dir)).catch(() => [])).toSorted().findLast((name) => name.endsWith(suffix));
+	if (latest === void 0) return;
+	return {
+		path: `${dir}/${latest}`,
+		text: await readFile(resolve(config.root, dir, latest), "utf-8")
+	};
+}
+const MODULE_MARKERS = /^-- @(?:bsb-block|bs-module) ([a-zA-Z0-9-]+)@(\d+)(?: [a-z]+(?: ([a-z0-9-]+))?)?$/gm;
+/**
+* The modules and versions a module migration installs, from its `@bsb-block`
+* lines.
+*/
+function migrationModules(text) {
+	return new Map([...text.matchAll(MODULE_MARKERS)].map((match) => [match[1], Number(match[2])]));
+}
+/**
+* The instances a module migration installs under another name than their
+* block, each to its block.
+*/
+function migrationInstances(text) {
+	return new Map([...text.matchAll(MODULE_MARKERS)].flatMap((match) => match[3] === void 0 ? [] : [[match[1], match[3]]]));
+}
+/**
+* Writes `contents` as a new migration ending in `suffix`, unless the newest
+* one already holds the same statements. `force` writes it anyway, for upgrade
+* steps that have to run once.
+*/
+async function writeLatestMigration(config, suffix, contents, options) {
+	const latest = await latestMigration(config, suffix);
+	if (options.force !== true && latest !== void 0 && sameModuleMigration(latest.text, contents)) return {
+		path: latest.path,
+		wrote: false,
+		line: `Unchanged ${latest.path} (it has these statements)`
+	};
+	const dir = migrationsDir(config);
+	const names = await readdir(resolve(config.root, dir)).catch(() => []);
+	const path = `${dir}/${stampAfter(names, options.now)}${suffix}`;
+	const applied = await applyPlan(sqlPlan(config, {
+		regenerate: "better-supabase upgrade",
+		files: [{
+			path,
+			contents
+		}]
+	}), { "dry-run": options.dryRun });
+	return {
+		path,
+		wrote: applied.mode === "write",
+		line: changeLines(applied).join("\n")
+	};
+}
+//#endregion
+export { migrationInstances as a, sameModuleMigration as c, migrationHolds as i, writeLatestMigration as l, READ_SETS_SUFFIX as n, migrationModules as o, latestMigration as r, renderModuleMigration as s, MODULES_SUFFIX as t, writesMigrations as u };

package/dist/cli/{moved-CsfDQcyk.js → moved-DVwgE8lV.js}

@@ -1,5 +1,5 @@
 import { n as CliError } from "./errors-BTe6A15O.js";
-import { s as positionalIndex } from "./parse-B9Iv_-Pf.js";
+import { s as positionalIndex } from "./parse-B079x40m.js";
 //#region src/cli/core/moved.ts
 const API_REPLACEMENT = "defineApi includes every table and block instance, and createOrpc(betterSupabase).router(api) serves it: https://bettersupabase.com/docs/frameworks/orpc#serve-the-api";
 /** Commands removed in 0.15, with what replaces them, longest path first. */

package/dist/cli/{parse-B9Iv_-Pf.js → parse-B079x40m.js}

@@ -1,5 +1,5 @@
 import { r as __toESM } from "./rolldown-runtime-kJ_i4yPo.js";
-import { t as GLOBAL_ARGS } from "./command-CQ61x6gN.js";
+import { t as GLOBAL_ARGS } from "./command-BWEEXmtz.js";
 import { n as CliError } from "./errors-BTe6A15O.js";
 //#region src/cli/core/parse.ts
 /**

package/dist/cli/powersync-BAE2dlPJ.js

@@ -0,0 +1 @@
+export { t as powersyncStreamsCommand } from "./powersync-BCDuGn5p.js";