better-supabase 0.7.0 → 0.8.0

package/dist/cli/{init-Cr6arjXU.js → glue-C1UE8gQN.js}

@@ -1,24 +1,10 @@
-import { a as list, r as defineCliCommand } from "./command-CK14fP91.js";
-import { i as writeIfChanged, t as display } from "./io-DI1mTdSA.js";
-import { t as VERSION } from "./version-Bp4fyubI.js";
-import { a as loadConfig, r as findConfig } from "./config-NiPxAmUF.js";
-import { a as findSupabaseRoot, p as tomlGet, r as diffEngine, t as PGDELTA_TABLE, u as readSupabaseToml } from "./supabase-toml-B-bIukQF.js";
-import { t as TYPEGEN_VERSION } from "./typegen-version-DeFbtzYI.js";
-import { n as installCommand, t as detectProject } from "./project-DZRaBaY7.js";
-import { join, posix, resolve } from "node:path";
+import { a as parseNames } from "./errors-CqTLXe2M.js";
+import { a as writeIfChanged, t as display } from "./io-CFzJVJ68.js";
+import { t as VERSION } from "./version-B4k0aUxS.js";
+import { n as INTEGRATIONS } from "./names-D6LrQnOv.js";
+import { posix, resolve } from "node:path";
 import { existsSync } from "node:fs";
-import { glob, readFile } from "node:fs/promises";
 //#region src/cli/templates.ts
-const INTEGRATIONS = [
-	"next",
-	"hono",
-	"orpc",
-	"edge",
-	"expo",
-	"mcp",
-	"client",
-	"react"
-];
 const join$1 = (...parts) => posix.normalize(posix.join(...parts));
 const libDir = (context) => join$1(context.srcDir, "lib");
 /** `lib/supabase/`: the shared definition, `server.ts` and `client.ts`. */
@@ -77,14 +63,19 @@ function functionServer(name, contents) {
 /** Edge Functions import `_shared/supabase.ts`, so they don't need the app definition. */
 const needsLib = (names) => names.length === 0 || names.some((name) => name !== "edge" && name !== "mcp");
 /** The files `init` writes: the config and, unless `lib` is false, the isomorphic definition. */
-function baseFiles(context, casing, lib = true) {
+function baseFiles(context, casing, lib = true, integrations = []) {
 	const config = {
 		path: "better-supabase.config.ts",
 		contents: `import { defineConfig } from 'better-supabase/config';
 
 export default defineConfig({
   casing: '${casing}',
-  output: '${context.generated}',
+  output: '${context.generated}',${integrations.length > 0 ? `\n  integrations: [${integrations.map((name) => `'${name}'`).join(", ")}],` : ""}
+  // \`better-supabase gen\` runs every task this file sets up: types, then
+  // sql, spec, seed and scaffold when they are configured. Pin the list with:
+  // gen: { tasks: ['types', 'sql', 'spec'] },
+  // env: { output: '.env.local' },
+  // doctor: { format: 'sarif', output: 'doctor.sarif' },
 });
 `
 	};
@@ -410,127 +401,7 @@ function suggestedIntegrations(frameworks) {
 	return resolveIntegrations(names);
 }
 //#endregion
-//#region src/cli/workspace.ts
-const unquote = (value) => value.replace(/\s+#.*$/, "").trim().replace(/^(["'])(.*)\1$/, "$2");
-/** The `packages` globs of `pnpm-workspace.yaml`, in block or flow style. */
-function pnpmWorkspacePatterns(text) {
-	const lines = text.split(/\r?\n/);
-	const start = lines.findIndex((line) => /^packages\s*:/.test(line));
-	if (start === -1) return [];
-	const inline = /^packages\s*:\s*\[(.*)\]\s*(?:#.*)?$/.exec(lines[start]);
-	if (inline) return inline[1].split(",").map(unquote).filter((entry) => entry !== "");
-	const patterns = [];
-	for (const line of lines.slice(start + 1)) {
-		if (/^\s*(?:#.*)?$/.test(line)) continue;
-		const item = /^\s+-\s*(.+)$/.exec(line);
-		if (!item) break;
-		patterns.push(unquote(item[1]));
-	}
-	return patterns.filter((entry) => entry !== "");
-}
-function packageJsonPatterns(workspaces) {
-	let list = workspaces;
-	if (typeof workspaces === "object" && workspaces !== null && "packages" in workspaces) list = workspaces.packages;
-	return Array.isArray(list) ? list.filter((entry) => typeof entry === "string") : [];
-}
-async function matches(root, pattern) {
-	const dirs = [];
-	const base = pattern.replace(/^\.\//, "").replace(/\/$/, "");
-	for await (const path of glob(`${base}/package.json`, {
-		cwd: root,
-		exclude: (name) => name === "node_modules"
-	})) dirs.push(posix.dirname(path.replaceAll("\\", "/")));
-	return dirs;
-}
-/**
-* The workspace declared at `root` by `pnpm-workspace.yaml` or the
-* `workspaces` field of `package.json`, with its packages in path order.
-* `undefined` when `root` declares none.
-*/
-async function detectWorkspace(root) {
-	let file;
-	let patterns;
-	const yaml = join(root, "pnpm-workspace.yaml");
-	if (existsSync(yaml)) {
-		file = "pnpm-workspace.yaml";
-		patterns = pnpmWorkspacePatterns(await readFile(yaml, "utf8"));
-	} else {
-		const path = join(root, "package.json");
-		if (!existsSync(path)) return void 0;
-		let pkg;
-		try {
-			pkg = JSON.parse(await readFile(path, "utf8"));
-		} catch {
-			return;
-		}
-		if (typeof pkg !== "object" || pkg === null || !("workspaces" in pkg)) return void 0;
-		file = "package.json";
-		patterns = packageJsonPatterns(pkg.workspaces);
-		if (patterns.length === 0) return void 0;
-	}
-	const included = /* @__PURE__ */ new Set();
-	const excluded = /* @__PURE__ */ new Set();
-	for (const pattern of patterns) {
-		const negated = pattern.startsWith("!");
-		for (const dir of await matches(root, negated ? pattern.slice(1) : pattern)) (negated ? excluded : included).add(dir);
-	}
-	const dirs = [...included].filter((dir) => dir !== "." && !excluded.has(dir)).sort();
-	const packages = await Promise.all(dirs.map(async (dir) => ({
-		dir,
-		project: await detectProject(join(root, dir))
-	})));
-	return {
-		file,
-		packages
-	};
-}
-/** The package `init` suggests: one that uses better-supabase, then one with a framework. */
-function suggestedPackage(workspace) {
-	const packages = workspace.packages;
-	return (packages.find((entry) => "better-supabase" in entry.project.dependencies) ?? packages.find((entry) => entry.project.frameworks.length > 0) ?? packages[0])?.dir;
-}
-//#endregion
-//#region src/cli/commands/init.ts
-const INIT_ARGS = {
-	casing: {
-		type: "string",
-		description: "Row keys in camelCase (camel, the default) or the database's snake_case (snake)",
-		valueHint: "camel|snake"
-	},
-	with: {
-		type: "string",
-		description: "Integrations to add next to the detected ones: next, hono, orpc, edge, expo, mcp, client, react",
-		valueHint: "integration,..."
-	},
-	package: {
-		type: "string",
-		description: "Workspace package to write to, relative to --cwd",
-		valueHint: "dir"
-	},
-	force: {
-		type: "boolean",
-		description: "Overwrite files that exist"
-	},
-	"dry-run": {
-		type: "boolean",
-		description: "Show what would be written"
-	}
-};
-const ADD_ARGS = {
-	integration: {
-		type: "positional",
-		required: false,
-		description: "next, hono, orpc, edge, expo, mcp, client or react"
-	},
-	force: {
-		type: "boolean",
-		description: "Overwrite files that exist"
-	},
-	"dry-run": {
-		type: "boolean",
-		description: "Show what would be written"
-	}
-};
+//#region src/cli/glue.ts
 const CANCELLED = {
 	code: 1,
 	error: "Cancelled."
@@ -563,25 +434,7 @@ async function writeFiles(root, files, args, force, base = root) {
 	}
 	return lines;
 }
-/**
-* Adds `[experimental.pgdelta] enabled = true` to `supabase/config.toml`
-* when it has no such table, so `supabase db schema declarative sync`
-* runs on pg-delta. A table set to `enabled = false` is left alone.
-*/
-async function enablePgDelta(root, args, base) {
-	const supabaseRoot = findSupabaseRoot(root);
-	const toml = await readSupabaseToml(root);
-	if (supabaseRoot === void 0 || toml === void 0) return [];
-	const path = join(supabaseRoot, "supabase/config.toml");
-	const shown = display(base, path);
-	if (diffEngine(toml) === "pg-delta") return [];
-	if (tomlGet(toml.document, ["experimental", "pgdelta"]) !== void 0 || toml.text.includes("pgdelta")) return [`Kept    ${shown} (pg-delta is off; set [experimental.pgdelta] enabled = true, remove [db.migrations] schema_paths and use \`supabase db schema declarative sync\` instead of \`supabase db diff\`)`];
-	if (args["dry-run"] === true) return [`Would enable pg-delta in ${shown}`];
-	const separator = toml.text === "" || toml.text.endsWith("\n\n") ? "" : toml.text.endsWith("\n") ? "\n" : "\n\n";
-	await writeIfChanged(path, `${toml.text}${separator}${PGDELTA_TABLE}`);
-	return [`Enabled pg-delta in ${shown}`];
-}
-function context(project, generated) {
+function templateContextFor(project, generated) {
 	return {
 		srcDir: project.srcDir,
 		generated,
@@ -601,11 +454,6 @@ function packagesFor(project, names) {
 	];
 	return [...new Set(wanted)].filter((name) => !(name in project.dependencies));
 }
-/** pg and the pinned postgrest-typegen as dev dependencies, the ones the project lacks. */
-function devPackages(project) {
-	const missing = [..."pg" in project.dependencies ? [] : ["pg"], ..."@supabase/postgrest-typegen" in project.dependencies ? [] : [`@supabase/postgrest-typegen@${TYPEGEN_VERSION}`]];
-	return missing.length === 0 ? [] : [missing];
-}
 function chooseIntegrations(prompts, initial) {
 	return prompts.multiselect("Integrations", INTEGRATIONS.map((name) => ({
 		value: name,
@@ -614,152 +462,7 @@ function chooseIntegrations(prompts, initial) {
 	})), initial);
 }
 function parseIntegrations(values) {
-	const unknown = values.filter((value) => !isIntegration(value));
-	if (unknown.length > 0) return `Unknown integration ${unknown.join(", ")}. Available: ${INTEGRATIONS.join(", ")}`;
-	return values.filter(isIntegration);
-}
-/** Where `init` writes: `--cwd`, `--package`, or the workspace package the person picks. */
-async function initTarget(cwd, args, prompts) {
-	if (args.package !== void 0) {
-		const dir = posix.normalize(args.package.replaceAll("\\", "/"));
-		if (!existsSync(join(cwd, dir, "package.json"))) return {
-			code: 2,
-			error: `--package ${args.package} has no package.json. Pass the directory of a workspace package, relative to --cwd.`
-		};
-		return { dir: dir.replace(/\/$/, "") || "." };
-	}
-	const workspace = await detectWorkspace(cwd);
-	if (!workspace || workspace.packages.length === 0) return { dir: "." };
-	const suggested = suggestedPackage(workspace) ?? ".";
-	if (!prompts) return {
-		code: 2,
-		error: `${workspace.file} makes this a workspace root. Pass --package with the package that owns the runtime (${workspace.packages.map((entry) => entry.dir).join(", ")}), or --package . to write here.`
-	};
-	const dir = await prompts.select("Package that owns the runtime", [...workspace.packages.map((entry) => ({
-		value: entry.dir,
-		label: entry.dir,
-		...entry.project.name ? { hint: entry.project.name } : {}
-	})), {
-		value: ".",
-		label: ".",
-		hint: "the workspace root"
-	}], suggested);
-	return dir === void 0 ? CANCELLED : { dir };
+	return parseNames(values, isIntegration, "integration", INTEGRATIONS);
 }
-async function runInit(config, args, prompts) {
-	const casing = args.casing ?? (prompts ? await prompts.select("Row keys", [{
-		value: "camel",
-		label: "camelCase",
-		hint: "customerId"
-	}, {
-		value: "snake",
-		label: "snake_case",
-		hint: "customer_id, as in the database"
-	}], "camel") : "camel");
-	if (casing === void 0) return CANCELLED;
-	if (casing !== "camel" && casing !== "snake") return {
-		code: 2,
-		error: "--casing must be \"camel\" or \"snake\""
-	};
-	const target = await initTarget(config.root, args, prompts);
-	if ("code" in target) return target;
-	const root = resolve(config.root, target.dir);
-	const inPackage = target.dir !== ".";
-	const workspaceProject = await detectProject(config.root);
-	const project = inPackage ? {
-		...await detectProject(root),
-		packageManager: workspaceProject.packageManager
-	} : workspaceProject;
-	const installTarget = inPackage ? {
-		dir: target.dir,
-		name: project.name
-	} : void 0;
-	const requested = parseIntegrations(list(args.with));
-	if (typeof requested === "string") return {
-		code: 2,
-		error: requested
-	};
-	const detected = resolveIntegrations([...suggestedIntegrations(project.frameworks), ...requested]);
-	const chosen = args.with === void 0 && prompts ? await chooseIntegrations(prompts, detected) : detected;
-	if (chosen === void 0) return CANCELLED;
-	const integrations = resolveIntegrations(chosen);
-	const hasConfig = findConfig(root) !== void 0;
-	let generated = posix.normalize(posix.join(project.srcDir, "lib/supabase/generated.ts"));
-	if (hasConfig) generated = inPackage ? (await loadConfig(root)).output : config.output;
-	const templateContext = context(project, generated);
-	const files = [...baseFiles(templateContext, casing, needsLib(integrations)), ...integrationFiles(integrations, templateContext)];
-	const force = await overwrite(root, files, args, prompts, config.root);
-	if (force === void 0) return CANCELLED;
-	const where = inPackage ? ` in ${target.dir}` : "";
-	const lines = [
-		project.frameworks.length > 0 ? `Found ${project.frameworks.join(", ")}${where}.` : `No framework found${where}.`,
-		"",
-		...await writeFiles(root, files, args, force, config.root),
-		...await enablePgDelta(root, args, config.root)
-	];
-	const packages = packagesFor(project, integrations);
-	const cwdFlag = inPackage ? ` --cwd ${target.dir}` : "";
-	const steps = [
-		...packages.length > 0 ? [installCommand(project.packageManager, packages, false, installTarget)] : [],
-		...devPackages(project).map((names) => installCommand(project.packageManager, names, true, installTarget)),
-		...project.hasSupabase || workspaceProject.hasSupabase ? [] : ["supabase init"],
-		"supabase start",
-		`better-supabase env${cwdFlag}`,
-		`better-supabase gen${cwdFlag}`
-	];
-	lines.push("", "Next:", ...steps.map((step, index) => `  ${index + 1}. ${step}`));
-	for (const name of integrations) for (const hint of TEMPLATES[name].next ?? []) lines.push(`  - ${hint}`);
-	lines.push("", "Agent skills: better-supabase skills install");
-	return {
-		code: 0,
-		output: lines.join("\n")
-	};
-}
-async function runAdd(config, args, prompts) {
-	const named = args._.length === 0 && prompts ? await chooseIntegrations(prompts, []) : args._;
-	if (named === void 0) return CANCELLED;
-	if (named.length === 0) return {
-		code: 2,
-		error: `Name at least one integration: ${INTEGRATIONS.join(", ")}`
-	};
-	const requested = parseIntegrations(named);
-	if (typeof requested === "string") return {
-		code: 2,
-		error: requested
-	};
-	const project = await detectProject(config.root);
-	const integrations = resolveIntegrations(requested);
-	const templateContext = context(project, config.output);
-	const files = integrationFiles(integrations, templateContext);
-	const force = await overwrite(config.root, files, args, prompts);
-	if (force === void 0) return CANCELLED;
-	const lines = await writeFiles(config.root, files, args, force);
-	const lib = libEntry(templateContext);
-	if (!existsSync(resolve(config.root, lib)) && integrations.some((name) => needsLib([name]))) lines.push("", `Warning: ${lib} is missing. Run \`better-supabase init\` first.`);
-	const packages = packagesFor(project, integrations).filter((name) => name !== "better-supabase" && name !== "@supabase/supabase-js");
-	if (packages.length > 0) lines.push("", `Install: ${installCommand(project.packageManager, packages)}`);
-	for (const name of integrations) for (const hint of TEMPLATES[name].next ?? []) lines.push(`- ${hint}`);
-	return {
-		code: 0,
-		output: lines.join("\n")
-	};
-}
-const initCommand = defineCliCommand({
-	meta: {
-		name: "init",
-		description: "Writes better-supabase.config.ts, src/lib/supabase/index.ts and glue for the frameworks in package.json"
-	},
-	args: INIT_ARGS,
-	lists: ["with"],
-	run: (args, { config, io }) => runInit(config, args, io.prompts)
-});
-const addCommand = defineCliCommand({
-	meta: {
-		name: "add",
-		description: "Adds glue for an integration to an existing project"
-	},
-	args: ADD_ARGS,
-	run: (args, { config, io }) => runAdd(config, args, io.prompts)
-});
 //#endregion
-export { addCommand, initCommand };
+export { packagesFor as a, writeFiles as c, libEntry as d, needsLib as f, overwrite as i, TEMPLATES as l, suggestedIntegrations as m, chooseIntegrations as n, parseIntegrations as o, resolveIntegrations as p, integrationFiles as r, templateContextFor as s, CANCELLED as t, baseFiles as u };

package/dist/cli/index.d.ts

@@ -84,6 +84,8 @@ type Resolvable<T> = T | Promise<T> | (() => T) | (() => Promise<T>);
 interface CliEnv {
   /** Postgres connection string for gen, introspect, doctor and seed. */
   readonly DATABASE_URL?: string | undefined;
+  /** The Supabase name for the same connection string, read when `DATABASE_URL` is unset. */
+  readonly SUPABASE_DB_URL?: string | undefined;
   /** Personal access token for reading a hosted project. */
   readonly SUPABASE_ACCESS_TOKEN?: string | undefined;
   /** Management API base URL; defaults to https://api.supabase.com. */
@@ -92,8 +94,10 @@ interface CliEnv {
   readonly SUPABASE_BIN?: string | undefined;
   /** Home directory for `skills install --global`. */
   readonly HOME?: string | undefined;
-  /** Set in CI; prompts never run there. */
+  /** Set in CI; prompts never run there, and the config's `ci` environment applies. */
   readonly CI?: string | undefined;
+  /** The config environment to apply when `--env` is not passed. */
+  readonly BETTER_SUPABASE_ENV?: string | undefined;
 }
 //#endregion
 //#region src/cli/prompts.d.ts
@@ -170,6 +174,11 @@ declare const GLOBAL_ARGS: {
     readonly description: "Config file, relative to --cwd";
     readonly valueHint: "file";
   };
+  readonly env: {
+    readonly type: "string";
+    readonly description: "Config environment to apply ($env.<name> or $<name>). Defaults to $BETTER_SUPABASE_ENV, then ci when $CI is set";
+    readonly valueHint: "name";
+  };
   readonly json: {
     readonly type: "boolean";
     readonly description: "Print one JSON document on stdout; errors as Problem Details";
@@ -218,12 +227,6 @@ interface CommandContext {
 type Command = (context: CommandContext) => Promise<CommandResult>;
 //#endregion
 //#region src/cli/run.d.ts
-/** Registers a citty command; `defineCliCommand` gives it the `CliContext`. */
-export declare function registerCommand(name: string, command: AnyCommand): void;
-/** @deprecated Pass a citty `CommandDef` from `defineCliCommand` instead. */
-export declare function registerCommand(name: string, command: Command, help?: string): void;
-/** The usage text for the CLI, or for one command; plain unless `color` is set. */
-export declare function help(command?: string, color?: boolean): Promise<string>;
 interface RunOptions {
   /** Directory `--cwd` is relative to. */
   readonly cwd?: string;
@@ -232,10 +235,26 @@ interface RunOptions {
   readonly io?: CliIo;
   readonly signal?: AbortSignal;
 }
+interface Cli {
+  /** Runs the CLI. Never exits the process; returns the exit code and output. */
+  run(argv: readonly string[], options?: RunOptions): Promise<RunResult>;
+  /** The usage text for the CLI, or for one command; plain unless `color` is set. */
+  help(command?: string, color?: boolean): Promise<string>;
+  /** The names `run()` dispatches, registered commands included. */
+  commandNames(): string[];
+  /** The root usage's description of each lazily loaded command, for checking against the command. */
+  commandDescriptions(): ReadonlyMap<string, string>;
+  /** Adds a command that is already loaded. */
+  register(name: string, command: AnyCommand): void;
+}
+export declare const run: Cli["run"];
+export declare const help: Cli["help"];
 /** The names `run()` dispatches, registered commands included. */
-export declare function commandNames(): string[];
-/** Runs the CLI. Never exits the process; returns the exit code and output. */
-export declare function run(argv: readonly string[], options?: RunOptions): Promise<RunResult>;
+export declare const commandNames: Cli["commandNames"];
+/** Registers a citty command; `defineCliCommand` gives it the `CliContext`. */
+export declare function registerCommand(name: string, command: AnyCommand): void;
+/** @deprecated Pass a citty `CommandDef` from `defineCliCommand` instead. */
+export declare function registerCommand(name: string, command: Command, help?: string): void;
 //#endregion
 //#region src/cli/errors.d.ts
 /** `1` for a failure, `2` for a usage error the caller can fix by changing the command. */
@@ -271,10 +290,19 @@ export declare class CliError extends Error {
   constructor(code: CliErrorCode, message: string, options?: CliErrorOptions);
 }
 //#endregion
-//#region src/cli/style.d.ts
-type Format = Parameters<typeof styleText>[0];
-/** Styles text, or returns it unchanged when colors are off. */
-type Paint = (format: Format, text: string) => string;
+//#region src/cli/gen/render.d.ts
+interface RenderOptions {
+  /** Where the generated module imports the runtime from. Defaults to `better-supabase`. */
+  readonly runtimeImport?: string;
+  /** Writes the metadata into the main module, so it stands alone on stdout. */
+  readonly inlineMeta?: boolean;
+}
+/**
+ * Renders every generated file for a snapshot, without touching disk:
+ * `database.types.ts` (what `supabase gen types` prints), the main module,
+ * then each configured generator's files.
+ */
+export declare function renderFiles(config: ResolvedConfig, snapshot: Snapshot, options?: RenderOptions): Promise<GeneratedFile[]>;
 //#endregion
 //#region src/cli/db.d.ts
 /** The subset of `pg.Client` the CLI uses. */
@@ -314,6 +342,11 @@ interface Queryable {
 interface IntrospectionSource {
   readonly queryable: Queryable;
   readonly describe: string;
+  /**
+   * Set when the schema was replayed into a throwaway database rather than
+   * read from the one the app runs on, saying why live checks are skipped.
+   */
+  readonly replay?: string;
   close(): Promise<void>;
 }
 /**
@@ -360,7 +393,12 @@ export declare function loadSnapshot(config: ResolvedConfig, env: Env, source: S
 export declare function parseSnapshot(data: unknown, label?: string): Promise<Snapshot>;
 export declare function serializeSnapshot(snapshot: Snapshot): string;
 //#endregion
-//#region src/cli/commands/gen.d.ts
+//#region src/cli/style.d.ts
+type Format = Parameters<typeof styleText>[0];
+/** Styles text, or returns it unchanged when colors are off. */
+type Paint = (format: Format, text: string) => string;
+//#endregion
+//#region src/cli/gen/run.d.ts
 interface GenOptions extends SnapshotSource {
   readonly config: ResolvedConfig;
   readonly env: CliEnv;
@@ -376,18 +414,6 @@ interface GenOptions extends SnapshotSource {
    */
   readonly isolated?: boolean;
 }
-interface RenderOptions {
-  /** Where the generated module imports the runtime from. Defaults to `better-supabase`. */
-  readonly runtimeImport?: string;
-  /** Writes the metadata into the main module, so it stands alone on stdout. */
-  readonly inlineMeta?: boolean;
-}
-/**
- * Renders every generated file for a snapshot, without touching disk:
- * `database.types.ts` (what `supabase gen types` prints), the main module,
- * then each configured generator's files.
- */
-export declare function renderFiles(config: ResolvedConfig, snapshot: Snapshot, options?: RenderOptions): Promise<GeneratedFile[]>;
 export declare function runGen(options: GenOptions): Promise<CommandResult>;
 //#endregion
 //#region src/cli/introspect/extras.d.ts
@@ -521,12 +547,14 @@ export declare function emitModule(model: Model, options: EmitOptions): string;
  * Loads `better-supabase.config.*` with c12 and checks it against the config
  * schema. c12 imports `.ts` natively (Node 24 strips the types), so no
  * loader is needed; rc files, `package.json`, env overrides and `extends`
- * are off so the one file is the whole config. A discovered file sets the
- * project root to its own directory; `--config` keeps `cwd` as the root.
+ * are off so the one file is the whole config. `environment` merges its
+ * blocks in (`applyEnvironment`); c12's own `envName` is off because it
+ * concatenates arrays. A discovered file sets the project root to its own
+ * directory; `--config` keeps `cwd` as the root.
  */
-export declare function loadConfig(cwd: string, explicit?: string): Promise<ResolvedConfig>;
+export declare function loadConfig(cwd: string, explicit?: string, environment?: string): Promise<ResolvedConfig>;
 //#endregion
 //#region src/cli/version.d.ts
-export declare const VERSION = "0.7.0";
+export declare const VERSION = "0.8.0";
 //#endregion
 export type { Catalog, CatalogCheck, CatalogColumn, CatalogColumnGrant, CatalogEnum, CatalogForeignKey, CatalogFunction, CatalogFunctionArg, CatalogGrant, CatalogIndex, CatalogPolicy, CatalogTable, CatalogTrigger, CatalogUnique, CliArgs, CliCommandDef, CliContext, CliEnv, CliErrorCode, CliErrorOptions, CliIo, CliProblem, CliProblemExtensions, Command, CommandContext, CommandResult, ExitCode, ExtrasFunction, ExtrasHook, ExtrasHookFunction, ExtrasTable, ForeignKeyAction, GeneratorMetadata, IntrospectionSource, ManagementSourceOptions, ParsedArgs, Queryable, RunOptions, RunResult, Snapshot, SnapshotBucket, SnapshotExtras };

package/dist/cli/index.js

@@ -1,9 +1,11 @@
-import { a as list, r as defineCliCommand } from "./command-CK14fP91.js";
-import { n as CliError, t as CLI_ERRORS_URL } from "./errors-4v4DTtda.js";
-import { i as run, n as help, r as registerCommand, t as commandNames } from "./run-BO052mki.js";
-import { t as VERSION } from "./version-Bp4fyubI.js";
-import { a as loadConfig } from "./config-NiPxAmUF.js";
-import { L as toCatalog, a as renderFiles, b as emitModule, c as loadSnapshot, d as parseSnapshot, f as serializeSnapshot, g as pgSource, h as managementSource, m as introspect, o as runGen, x as buildModel, y as GENERATED_HEADER } from "./gen-AIf4MREI.js";
+import { a as list, r as defineCliCommand } from "./command-DV-StG1x.js";
+import { i as run, n as help, r as registerCommand, t as commandNames } from "./run-DA6_lg3w.js";
+import { n as CliError, t as CLI_ERRORS_URL } from "./errors-CqTLXe2M.js";
+import { t as VERSION } from "./version-B4k0aUxS.js";
+import { a as buildModel, c as toCatalog, r as emitModule, t as GENERATED_HEADER } from "./emit-BHHfwUoT.js";
+import { n as runGen, y as renderFiles } from "./run-DuN1MX-7.js";
+import { o as loadConfig } from "./config-M-WzL9O2.js";
+import { a as serializeSnapshot, d as pgSource, i as parseSnapshot, l as introspect, t as loadSnapshot, u as managementSource } from "./snapshot-Bstk6ulj.js";
 //#region src/cli/introspect/from-catalog.ts
 /**
 * Builds a snapshot from catalog records: the inverse of `toCatalog`. Tests