@rebasepro/cli 0.23.0 → 0.24.1-canary.g19596ef

package/dist/resources-FD7AfZx8.js

@@ -0,0 +1,183 @@
+import { i as failAsJson, p as requireProjectRoot } from "./project-Wp2zoyeN.js";
+import { n as parseCommandArgs, r as wantsHelp } from "./args-BnmsEXvu.js";
+import { d as findBackendApp, o as ManifestError, p as loadManifest } from "./manifest-DRp0UVTj.js";
+import { a as projectResourceGraph, l as writeResourceGraphFile, n as deriveOptionsFor, o as readResourceGraphFile, r as deriveResourceGraph, s as serializeResourceGraph, t as RESOURCE_GRAPH_FILENAME } from "./derive-Dl0z2OWi.js";
+import chalk from "chalk";
+import path from "path";
+import { declaredSubscriptions } from "@rebasepro/types";
+//#region src/commands/resources.ts
+/**
+* CLI command: rebase resources
+*
+* Shows what a project declares, and keeps the committed graph honest.
+*
+* The graph is generated, so it can drift the moment somebody adds a bucket and
+* does not regenerate. Drift here is not cosmetic: the committed file is what a
+* host reads to decide what to provision, so a stale one means the console
+* offers a project one set of resources while the runtime asks for another.
+* `--check` is the gate that makes that impossible to land.
+*/
+function usage() {
+	console.log(`
+${chalk.bold("rebase resources")} — what this project needs
+
+  ${chalk.blue("rebase resources")}            List them, declared and implicit
+  ${chalk.blue("rebase resources --write")}    Regenerate ${RESOURCE_GRAPH_FILENAME}
+  ${chalk.blue("rebase resources --check")}    Fail if the committed graph is stale
+  ${chalk.blue("rebase resources --json")}     The same set, machine-readable; with --check or --write,
+                               their result too (a failed check is an error envelope, exit 1)
+
+A resource is declared in config code — ${chalk.gray("database(\"analytics\"), bucket(\"media\"), topic(\"signups\")")} —
+and never in ${RESOURCE_GRAPH_FILENAME}, which is generated from those declarations so a host
+can read what a project needs without building it. A backend also has a default
+database and a default storage source nobody declared; both are listed here,
+marked ${chalk.gray("implicit")}, and neither is written to that file — the host supplies them.
+`);
+}
+/**
+* Render the projection the way somebody reads it: grouped by kind, key first.
+*
+* The projection, not the raw graph. `rebase status` has always included the
+* implicit default database and bucket and this listing did not, so the two
+* commands answered "what does this project need" differently on the same stock
+* scaffold. There is no "no resources declared" case any more: a backend has a
+* database and a storage source whether or not anyone wrote them down.
+*/
+function print(resources) {
+	const order = [
+		"database",
+		"bucket",
+		"topic",
+		"queue",
+		"cron",
+		"function"
+	];
+	const kinds = [...new Set(resources.map((r) => r.kind))].sort((a, b) => (order.indexOf(a) === -1 ? 99 : order.indexOf(a)) - (order.indexOf(b) === -1 ? 99 : order.indexOf(b)));
+	for (const kind of kinds) {
+		console.log(`\n  ${chalk.bold(kind)}`);
+		for (const r of resources.filter((x) => x.kind === kind)) {
+			const bits = [];
+			if (kind === "cron") {
+				bits.push(chalk.cyan(String(r.options.schedule)));
+				bits.push(chalk.gray(r.options.timezone ? String(r.options.timezone) : "local time"));
+			} else if (kind === "function") {
+				bits.push(chalk.gray(String(r.options.file ?? "")));
+				if (r.options.portable === false) bits.push(chalk.yellow("node-only"));
+			} else {
+				bits.push(chalk.gray(r.engine));
+				if (r.transport !== "server") bits.push(chalk.yellow(r.transport));
+				for (const [k, v] of Object.entries(r.options)) bits.push(chalk.gray(`${k}=${String(v)}`));
+			}
+			if (r.implicit) bits.push(chalk.gray("implicit"));
+			console.log(`    ${r.key.padEnd(24)} ${bits.join(" · ")}`);
+			if (kind === "topic") for (const sub of declaredSubscriptions(r.key)) console.log(`      ${chalk.gray("→")} ${sub.name}`);
+			if (r.usedBy && r.usedBy.length > 0) console.log(`      ${chalk.gray("used by")} ${chalk.gray(r.usedBy.join(", "))}`);
+		}
+	}
+	console.log("");
+}
+async function resourcesCommand(rawArgs) {
+	if (wantsHelp(rawArgs)) return usage();
+	const { flags } = parseCommandArgs({
+		spec: {
+			"--write": Boolean,
+			"--check": Boolean,
+			"--json": Boolean
+		},
+		rawArgs,
+		commandWords: 1,
+		command: "resources",
+		maxPositionals: 0
+	});
+	const projectRoot = requireProjectRoot();
+	const asJson = Boolean(flags["--json"]);
+	let backendApp;
+	try {
+		const backend = findBackendApp(loadManifest(projectRoot).manifest);
+		if (!backend) {
+			if (asJson) failAsJson("This project declares no backend app, so it declares no resources.", "no_backend_app", "Add a backend app to rebase.json, or run `rebase apps init`.");
+			console.error(chalk.red("This project declares no backend app, so it declares no resources."));
+			process.exitCode = 1;
+			return;
+		}
+		backendApp = backend.app;
+	} catch (err) {
+		if (err instanceof ManifestError) {
+			if (asJson) failAsJson(err.message, "manifest_invalid", "Fix rebase.json, then run this again.", err.issues.map((issue) => ({
+				path: issue.path,
+				message: issue.message
+			})));
+			console.error(chalk.red(err.message));
+			for (const issue of err.issues) console.error(`  ${chalk.gray(issue.path)} ${issue.message}`);
+			process.exitCode = 1;
+			return;
+		}
+		throw err;
+	}
+	const { graph, issues } = await deriveResourceGraph(deriveOptionsFor(projectRoot, backendApp));
+	if (issues.length > 0) {
+		if (asJson) failAsJson(`${issues.length} problem(s) in the declared resources.`, "resource_declaration_invalid", "Fix the declarations the issues name, then run this again.", issues.map((issue) => ({
+			path: issue.path,
+			message: issue.message
+		})));
+		console.error(chalk.red(`\n✗ ${issues.length} problem(s) in the declared resources:\n`));
+		for (const issue of issues) console.error(`  ${chalk.bold(issue.path)}  ${issue.message}`);
+		console.error("");
+		process.exitCode = 1;
+		return;
+	}
+	const projection = () => ({
+		version: graph.version,
+		resources: projectResourceGraph(graph)
+	});
+	if (flags["--check"]) {
+		const committed = readResourceGraphFile(projectRoot);
+		const status = committed === serializeResourceGraph(graph) ? "current" : committed === null && graph.resources.length === 0 ? "nothing-declared" : null;
+		if (status !== null) {
+			if (asJson) {
+				console.log(JSON.stringify({
+					...projection(),
+					check: {
+						file: RESOURCE_GRAPH_FILENAME,
+						status
+					}
+				}, null, 2));
+				return;
+			}
+			console.log(status === "current" ? chalk.green(`✓ ${RESOURCE_GRAPH_FILENAME} matches the declarations.`) : chalk.gray("✓ Nothing declared, so there is nothing to record."));
+			return;
+		}
+		const state = committed === null ? "missing" : "stale";
+		if (asJson) failAsJson(`${RESOURCE_GRAPH_FILENAME} is ${state}.`, `resource_graph_${state}`, "Regenerate it with `rebase resources --write`, and commit it.");
+		console.error(chalk.red(`\n✗ ${RESOURCE_GRAPH_FILENAME} is ${state}.\n`));
+		console.error("  A host reads this file to decide what to provision, so a stale one means the\n  console offers one set of resources while the runtime asks for another.\n");
+		console.error(`  Regenerate it:  ${chalk.blue("rebase resources --write")}\n`);
+		process.exitCode = 1;
+		return;
+	}
+	if (flags["--write"]) {
+		const { changed, file } = writeResourceGraphFile(projectRoot, graph);
+		const relative = path.relative(projectRoot, file);
+		if (asJson) {
+			console.log(JSON.stringify({
+				...projection(),
+				written: {
+					file: relative,
+					changed
+				}
+			}, null, 2));
+			return;
+		}
+		console.log(changed ? chalk.green(`✓ Wrote ${relative}`) : chalk.gray(`${relative} already matched the declarations.`));
+		return;
+	}
+	if (asJson) {
+		console.log(JSON.stringify(projection(), null, 2));
+		return;
+	}
+	print(projectResourceGraph(graph));
+}
+//#endregion
+export { resourcesCommand };
+
+//# sourceMappingURL=resources-FD7AfZx8.js.map

package/dist/resources-FD7AfZx8.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources-FD7AfZx8.js","names":[],"sources":["../src/commands/resources.ts"],"sourcesContent":["/**\n * CLI command: rebase resources\n *\n * Shows what a project declares, and keeps the committed graph honest.\n *\n * The graph is generated, so it can drift the moment somebody adds a bucket and\n * does not regenerate. Drift here is not cosmetic: the committed file is what a\n * host reads to decide what to provision, so a stale one means the console\n * offers a project one set of resources while the runtime asks for another.\n * `--check` is the gate that makes that impossible to land.\n */\nimport chalk from \"chalk\";\nimport path from \"path\";\nimport { failAsJson, requireProjectRoot } from \"../utils/project\";\nimport { findBackendApp, loadManifest, ManifestError } from \"../manifest\";\nimport { parseCommandArgs, wantsHelp } from \"../utils/args\";\nimport {\n    RESOURCE_GRAPH_FILENAME,\n    deriveOptionsFor, deriveResourceGraph,\n    projectResourceGraph,\n    readResourceGraphFile,\n    serializeResourceGraph,\n    writeResourceGraphFile,\n    type ProjectedResource\n} from \"../resources/derive\";\nimport { declaredSubscriptions, type RebaseBackendAppConfig } from \"@rebasepro/types\";\n\nfunction usage(): void {\n    console.log(`\n${chalk.bold(\"rebase resources\")} — what this project needs\n\n  ${chalk.blue(\"rebase resources\")}            List them, declared and implicit\n  ${chalk.blue(\"rebase resources --write\")}    Regenerate ${RESOURCE_GRAPH_FILENAME}\n  ${chalk.blue(\"rebase resources --check\")}    Fail if the committed graph is stale\n  ${chalk.blue(\"rebase resources --json\")}     The same set, machine-readable; with --check or --write,\n                               their result too (a failed check is an error envelope, exit 1)\n\nA resource is declared in config code — ${chalk.gray('database(\"analytics\"), bucket(\"media\"), topic(\"signups\")')} —\nand never in ${RESOURCE_GRAPH_FILENAME}, which is generated from those declarations so a host\ncan read what a project needs without building it. A backend also has a default\ndatabase and a default storage source nobody declared; both are listed here,\nmarked ${chalk.gray(\"implicit\")}, and neither is written to that file — the host supplies them.\n`);\n}\n\n/**\n * Render the projection the way somebody reads it: grouped by kind, key first.\n *\n * The projection, not the raw graph. `rebase status` has always included the\n * implicit default database and bucket and this listing did not, so the two\n * commands answered \"what does this project need\" differently on the same stock\n * scaffold. There is no \"no resources declared\" case any more: a backend has a\n * database and a storage source whether or not anyone wrote them down.\n */\nfunction print(resources: ProjectedResource[]): void {\n    // Infrastructure first, then code: what needs binding is what a reader\n    // is here to check.\n    const order = [\"database\", \"bucket\", \"topic\", \"queue\", \"cron\", \"function\"];\n    const kinds = [...new Set(resources.map(r => r.kind))]\n        .sort((a, b) => (order.indexOf(a) === -1 ? 99 : order.indexOf(a)) - (order.indexOf(b) === -1 ? 99 : order.indexOf(b)));\n    for (const kind of kinds) {\n        console.log(`\\n  ${chalk.bold(kind)}`);\n        for (const r of resources.filter(x => x.kind === kind)) {\n            const bits: string[] = [];\n            if (kind === \"cron\") {\n                bits.push(chalk.cyan(String(r.options.schedule)));\n                bits.push(chalk.gray(r.options.timezone ? String(r.options.timezone) : \"local time\"));\n            } else if (kind === \"function\") {\n                bits.push(chalk.gray(String(r.options.file ?? \"\")));\n                if (r.options.portable === false) bits.push(chalk.yellow(\"node-only\"));\n            } else {\n                bits.push(chalk.gray(r.engine));\n                if (r.transport !== \"server\") bits.push(chalk.yellow(r.transport));\n                for (const [k, v] of Object.entries(r.options)) bits.push(chalk.gray(`${k}=${String(v)}`));\n            }\n            // Marked, not hidden: a declared resource is recorded in\n            // `rebase.resources.json` for a host to provision, and an implicit\n            // one is a default the runtime supplies regardless.\n            if (r.implicit) bits.push(chalk.gray(\"implicit\"));\n            console.log(`    ${r.key.padEnd(24)} ${bits.join(\" · \")}`);\n            if (kind === \"topic\") {\n                for (const sub of declaredSubscriptions(r.key)) {\n                    console.log(`      ${chalk.gray(\"→\")} ${sub.name}`);\n                }\n            }\n            if (r.usedBy && r.usedBy.length > 0) {\n                console.log(`      ${chalk.gray(\"used by\")} ${chalk.gray(r.usedBy.join(\", \"))}`);\n            }\n        }\n    }\n    console.log(\"\");\n}\n\nexport async function resourcesCommand(rawArgs: string[]): Promise<void> {\n    if (wantsHelp(rawArgs)) return usage();\n\n    const { flags } = parseCommandArgs({\n        spec: {\n            \"--write\": Boolean,\n            \"--check\": Boolean,\n            \"--json\": Boolean\n        },\n        rawArgs,\n        commandWords: 1,\n        command: \"resources\",\n        maxPositionals: 0\n    });\n\n    const projectRoot = requireProjectRoot();\n\n    // Every exit below has a `--json` arm, for the reason in `failAsJson`:\n    // `--json` is a promise about stdout, and a promise kept on one exit of a\n    // command and broken on the next is not one.\n    const asJson = Boolean(flags[\"--json\"]);\n\n    let backendApp: RebaseBackendAppConfig;\n    try {\n        const loaded = loadManifest(projectRoot);\n        const backend = findBackendApp(loaded.manifest);\n        if (!backend) {\n            if (asJson) {\n                failAsJson(\n                    \"This project declares no backend app, so it declares no resources.\",\n                    \"no_backend_app\",\n                    \"Add a backend app to rebase.json, or run `rebase apps init`.\"\n                );\n            }\n            console.error(chalk.red(\"This project declares no backend app, so it declares no resources.\"));\n            process.exitCode = 1;\n            return;\n        }\n        backendApp = backend.app;\n    } catch (err) {\n        if (err instanceof ManifestError) {\n            if (asJson) {\n                failAsJson(err.message, \"manifest_invalid\", \"Fix rebase.json, then run this again.\",\n                    err.issues.map(issue => ({ path: issue.path, message: issue.message })));\n            }\n            console.error(chalk.red(err.message));\n            for (const issue of err.issues) console.error(`  ${chalk.gray(issue.path)} ${issue.message}`);\n            process.exitCode = 1;\n            return;\n        }\n        throw err;\n    }\n\n    const { graph, issues } = await deriveResourceGraph(deriveOptionsFor(projectRoot, backendApp));\n\n    if (issues.length > 0) {\n        if (asJson) {\n            failAsJson(\n                `${issues.length} problem(s) in the declared resources.`,\n                \"resource_declaration_invalid\",\n                \"Fix the declarations the issues name, then run this again.\",\n                issues.map(issue => ({ path: issue.path, message: issue.message }))\n            );\n        }\n        console.error(chalk.red(`\\n✗ ${issues.length} problem(s) in the declared resources:\\n`));\n        for (const issue of issues) console.error(`  ${chalk.bold(issue.path)}  ${issue.message}`);\n        console.error(\"\");\n        process.exitCode = 1;\n        return;\n    }\n\n    // The projection, so this and `rebase status --json` describe the same\n    // set. `version` is kept so a reader of either can tell them apart from a\n    // future shape. `--check` and `--write` add what they did to it: `--json`\n    // changes how the answer is printed, never which question is answered — it\n    // used to return here, so `--check --json` exited 0 on any drift and\n    // `--write --json` wrote nothing.\n    const projection = () => ({ version: graph.version, resources: projectResourceGraph(graph) });\n\n    if (flags[\"--check\"]) {\n        const committed = readResourceGraphFile(projectRoot);\n        const expected = serializeResourceGraph(graph);\n        // Declaring nothing and having no file is a consistent state, not a\n        // stale one. The file records declarations; a project with none has\n        // nothing to record, and its default database and bucket are implicit\n        // by design — that is the overwhelmingly common project and it must not\n        // be required to commit an empty file saying so.\n        //\n        // This mattered the moment the check was put in a gate: it would have\n        // failed this repository's own reference app, which declares nothing,\n        // and every scaffolded project until someone declared a second bucket.\n        const status = committed === expected\n            ? \"current\"\n            : committed === null && graph.resources.length === 0 ? \"nothing-declared\" : null;\n\n        if (status !== null) {\n            if (asJson) {\n                console.log(JSON.stringify({ ...projection(), check: { file: RESOURCE_GRAPH_FILENAME, status } }, null, 2));\n                return;\n            }\n            console.log(status === \"current\"\n                ? chalk.green(`✓ ${RESOURCE_GRAPH_FILENAME} matches the declarations.`)\n                : chalk.gray(\"✓ Nothing declared, so there is nothing to record.\"));\n            return;\n        }\n\n        const state = committed === null ? \"missing\" : \"stale\";\n        if (asJson) {\n            failAsJson(\n                `${RESOURCE_GRAPH_FILENAME} is ${state}.`,\n                `resource_graph_${state}`,\n                \"Regenerate it with `rebase resources --write`, and commit it.\"\n            );\n        }\n        console.error(chalk.red(`\\n✗ ${RESOURCE_GRAPH_FILENAME} is ${state}.\\n`));\n        console.error(\n            \"  A host reads this file to decide what to provision, so a stale one means the\\n\" +\n            \"  console offers one set of resources while the runtime asks for another.\\n\"\n        );\n        console.error(`  Regenerate it:  ${chalk.blue(\"rebase resources --write\")}\\n`);\n        process.exitCode = 1;\n        return;\n    }\n\n    if (flags[\"--write\"]) {\n        const { changed, file } = writeResourceGraphFile(projectRoot, graph);\n        const relative = path.relative(projectRoot, file);\n        if (asJson) {\n            console.log(JSON.stringify({ ...projection(), written: { file: relative, changed } }, null, 2));\n            return;\n        }\n        console.log(changed\n            ? chalk.green(`✓ Wrote ${relative}`)\n            : chalk.gray(`${relative} already matched the declarations.`));\n        return;\n    }\n\n    if (asJson) {\n        console.log(JSON.stringify(projection(), null, 2));\n        return;\n    }\n\n    print(projectResourceGraph(graph));\n}\n"],"mappings":"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"}

package/dist/schema-DMdr431S.js

@@ -0,0 +1,125 @@
+import { i as recordEvent } from "./telemetry-EMFRVRQi.js";
+import { f as requireBackendDir, h as resolvePluginCliScript, l as getActiveBackendPlugin, o as findEnvFile, p as requireProjectRoot, r as exitDependenciesNotInstalled } from "./project-Wp2zoyeN.js";
+import { r as wantsHelp } from "./args-BnmsEXvu.js";
+import { t as unknownCommand } from "./unknown-command-DNwDcX3w.js";
+import { r as refuseMissingCollectionsPath, t as COLLECTIONS_FLAG_HELP } from "./path-flags-BFgG9V6y.js";
+import { DEV_DATABASE_KIND_ENV, devDatabaseKind } from "./prepare-CDN6lSpz.js";
+import { absolutizeLocalPathArgs, n as argsFromCommand, spawnDriverCli, t as reportSpawnFailure } from "./db-B7RuNuaQ.js";
+import chalk from "chalk";
+//#region src/commands/schema.ts
+/**
+* CLI command: rebase schema <action>
+*/
+/**
+* The line handed to the driver, its paths resolved from where the command was
+* run (the driver runs in `backend/`). `--schema` is left alone: on
+* `introspect` it names a Postgres schema, not a file.
+*/
+function schemaDriverArgs(rawArgs, cwd) {
+	return absolutizeLocalPathArgs(argsFromCommand(rawArgs, "schema"), cwd, [
+		"--collections",
+		"-c",
+		"--output",
+		"-o",
+		"--out"
+	]);
+}
+async function schemaCommand(subcommand, rawArgs) {
+	if (!subcommand || subcommand === "--help" || wantsHelp(rawArgs)) {
+		printSchemaHelp(subcommand === "--help" ? void 0 : subcommand);
+		return;
+	}
+	if (!SCHEMA_ACTION_HELP[subcommand]) unknownCommand(subcommand, Object.keys(SCHEMA_ACTION_HELP), "schema");
+	const projectRoot = requireProjectRoot();
+	recordEvent("cli.schema", { subcommand: subcommand ?? "none" }, { projectRoot });
+	const backendDir = requireBackendDir(projectRoot);
+	const activePlugin = getActiveBackendPlugin(backendDir);
+	if (!activePlugin) {
+		console.error(chalk.red("✗ Could not detect an active database plugin."));
+		console.error(chalk.gray("  Make sure a package like @rebasepro/server-postgres is installed in backend/package.json."));
+		process.exit(1);
+	}
+	const pluginCli = resolvePluginCliScript(backendDir, activePlugin);
+	if (!pluginCli) exitDependenciesNotInstalled(projectRoot);
+	const envFile = findEnvFile(projectRoot);
+	const env = { ...process.env };
+	if (envFile) env.DOTENV_CONFIG_PATH = envFile;
+	env[DEV_DATABASE_KIND_ENV] = devDatabaseKind(projectRoot) ?? "";
+	refuseMissingCollectionsPath(rawArgs, process.cwd(), backendDir);
+	try {
+		await spawnDriverCli({
+			projectRoot,
+			backendDir,
+			pluginCli,
+			env
+		}, schemaDriverArgs(rawArgs, process.cwd()));
+	} catch (error) {
+		reportSpawnFailure(error);
+		process.exit(1);
+	}
+}
+/** One page per subcommand, so `rebase schema <action> --help` says something. */
+var SCHEMA_ACTION_HELP = {
+	generate: {
+		usage: "rebase schema generate [--collections <dir>] [--output <file>] [--watch]",
+		summary: "Generate the Drizzle schema from the collection definitions.",
+		notes: ["--watch regenerates on every change to a collection file."]
+	},
+	introspect: {
+		usage: "rebase schema introspect [--collections <dir>] [--output <dir>] [--schema <name>] [--force]",
+		summary: "Read an existing database and write Rebase collection definitions from it.",
+		notes: ["--force overwrites collection files that are already there."]
+	},
+	stale: {
+		usage: "rebase schema stale [--collections <dir>] [--output <file>] [--fix]",
+		summary: "Report generated schema files that no longer match the collections.",
+		notes: ["--fix regenerates them instead of only reporting."]
+	}
+};
+/** Every subcommand the family dispatches — the help table's keys. */
+var SCHEMA_SUBCOMMANDS = Object.keys(SCHEMA_ACTION_HELP);
+function printSchemaHelp(action) {
+	const entry = action ? SCHEMA_ACTION_HELP[action] : void 0;
+	if (entry) {
+		console.log(`
+${chalk.bold(`rebase schema ${action}`)}
+
+  ${entry.summary}
+
+${chalk.green.bold("Usage")}
+  ${chalk.blue(entry.usage)}
+${entry.notes?.length ? `\n${chalk.green.bold("Notes")}\n${entry.notes.map((n) => `  ${chalk.gray(`• ${n}`)}`).join("\n")}\n` : ""}
+${chalk.gray("Run `rebase schema --help` for every subcommand.")}
+`);
+		return;
+	}
+	console.log(`
+${chalk.bold("rebase schema")} — Schema management commands
+
+${chalk.green.bold("Usage")}
+  rebase schema ${chalk.blue("<command>")} [options]
+
+${chalk.green.bold("Commands")}
+  ${chalk.gray("(Commands are provided by your active database driver plugin)")}
+  ${chalk.blue.bold("generate")}    Generate Schema from collection definitions
+  ${chalk.blue.bold("introspect")}  Introspect an existing database to generate collection definitions
+  ${chalk.blue.bold("stale")}       Report generated schema files that no longer match the collections
+
+${chalk.green.bold("generate Options")}
+  ${chalk.blue("--collections, -c")}  ${COLLECTIONS_FLAG_HELP}
+  ${chalk.blue("--output, -o")}       Output path for generated schema
+  ${chalk.blue("--watch, -w")}        Watch for changes and regenerate automatically
+
+${chalk.green.bold("introspect Options")}
+  ${chalk.blue("--output, -o")}       Output directory for generated collection files
+  ${chalk.blue("--schema")}           Postgres schema to read (default: public)
+  ${chalk.blue("--force, -f")}        Overwrite collection files that already exist
+
+${chalk.green.bold("stale Options")}
+  ${chalk.blue("--fix")}              Regenerate the stale files instead of only reporting them
+`);
+}
+//#endregion
+export { SCHEMA_SUBCOMMANDS, schemaCommand };
+
+//# sourceMappingURL=schema-DMdr431S.js.map

package/dist/schema-DMdr431S.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-DMdr431S.js","names":[],"sources":["../src/commands/schema.ts"],"sourcesContent":["/**\n * CLI command: rebase schema <action>\n */\nimport chalk from \"chalk\";\nimport { spawnDriverCli } from \"./db\";\nimport {\n    requireProjectRoot,\n    requireBackendDir,\n    getActiveBackendPlugin,\n    resolvePluginCliScript,\n    resolveTsx,\n    findEnvFile,\n    exitDependenciesNotInstalled\n} from \"../utils/project\";\nimport { recordEvent } from \"../telemetry\";\nimport { wantsHelp } from \"../utils/args\";\nimport { reportSpawnFailure } from \"../utils/spawn-error\";\nimport { argsFromCommand } from \"../utils/command-words\";\nimport { unknownCommand } from \"../utils/unknown-command\";\nimport { DEV_DATABASE_KIND_ENV, devDatabaseKind } from \"../dev-db/prepare\";\nimport { absolutizeLocalPathArgs } from \"./db\";\nimport { COLLECTIONS_FLAG_HELP, refuseMissingCollectionsPath } from \"../utils/path-flags\";\n\n/**\n * The line handed to the driver, its paths resolved from where the command was\n * run (the driver runs in `backend/`). `--schema` is left alone: on\n * `introspect` it names a Postgres schema, not a file.\n */\nexport function schemaDriverArgs(rawArgs: string[], cwd: string): string[] {\n    return absolutizeLocalPathArgs(argsFromCommand(rawArgs, \"schema\"), cwd, [\"--collections\", \"-c\", \"--output\", \"-o\", \"--out\"]);\n}\n\nexport async function schemaCommand(subcommand: string | undefined, rawArgs: string[]): Promise<void> {\n    // `--help` is answered here, before `requireProjectRoot` and before the\n    // driver is spawned — the same shape `db.ts` already uses, and for the same\n    // reason.\n    //\n    // `cli.ts` rewrites the subcommand to `\"--help\"` only when the user named\n    // none, so `rebase schema --help` was covered and `rebase schema generate\n    // --help` was not: the flag travelled into `rawArgs.slice(2)` and reached\n    // the driver, whose own `schemaCommand` has no `--help` case. It *ran the\n    // generator* — overwriting `src/schema.generated.ts` — for a flag whose\n    // entire job is to print text. Worse, the first thing it hit outside a\n    // project was `requireProjectRoot`, so `rebase schema introspect --help` in\n    // an empty directory exited 1 with \"Could not find a Rebase project root\":\n    // help you cannot read until you already have a project is help for nobody.\n    if (!subcommand || subcommand === \"--help\" || wantsHelp(rawArgs)) {\n        printSchemaHelp(subcommand === \"--help\" ? undefined : subcommand);\n        return;\n    }\n\n    // A typo is answered here, in the same words every other family uses.\n    //\n    // It used to travel to the driver, which said the bare line `Unknown schema\n    // command.` — no list, no pointer, no did-you-mean, for a family with three\n    // subcommands. The set comes from the help table, so what a typo is measured\n    // against and what `--help` prints cannot drift apart.\n    if (!SCHEMA_ACTION_HELP[subcommand]) {\n        unknownCommand(subcommand, Object.keys(SCHEMA_ACTION_HELP), \"schema\");\n    }\n\n    const projectRoot = requireProjectRoot();\n\n    // Fire-and-forget, and a no-op unless the developer opted in. Never awaited:\n    // the command is what the user is waiting for, and a slow collector must not\n    // sit in front of it.\n    void recordEvent(\"cli.schema\", { subcommand: subcommand ?? \"none\" }, { projectRoot });\n    const backendDir = requireBackendDir(projectRoot);\n\n    const activePlugin = getActiveBackendPlugin(backendDir);\n    if (!activePlugin) {\n        console.error(chalk.red(\"✗ Could not detect an active database plugin.\"));\n        console.error(chalk.gray(\"  Make sure a package like @rebasepro/server-postgres is installed in backend/package.json.\"));\n        process.exit(1);\n    }\n\n    const pluginCli = resolvePluginCliScript(backendDir, activePlugin);\n    if (!pluginCli) {\n        exitDependenciesNotInstalled(projectRoot);\n    }\n\n    // Set up environment with DOTENV_CONFIG_PATH\n    const envFile = findEnvFile(projectRoot);\n    const env: Record<string, string> = { ...process.env as Record<string, string> };\n    if (envFile) {\n        env.DOTENV_CONFIG_PATH = envFile;\n    }\n    // Which database this project is on, so the driver's closing line does not\n    // recommend a command that database refuses. A pure decision — nothing is\n    // started, which matters here above all: `schema generate` reads collection\n    // files and writes one file, and booting a database to run it would be a\n    // side effect nobody asked for.\n    env[DEV_DATABASE_KIND_ENV] = devDatabaseKind(projectRoot) ?? \"\";\n\n    refuseMissingCollectionsPath(rawArgs, process.cwd(), backendDir);\n\n    try {\n        // The one spawn, shared with `db`. This file used to carry its own copy\n        // of the tsx-or-node decision; three copies of that rule existed and two\n        // were fixed while the third went on spawning plain node.\n        await spawnDriverCli(\n            { projectRoot, backendDir, pluginCli, env },\n            schemaDriverArgs(rawArgs, process.cwd())\n        );\n    } catch (error) {\n        // A child that ran and exited non-zero already printed its diagnostics\n        // through inherited stdio; a child that never started (ENOENT on tsx,\n        // EACCES on the script) printed nothing at all, and this used to exit 1\n        // in silence.\n        reportSpawnFailure(error);\n        process.exit(1);\n    }\n}\n\n/** One page per subcommand, so `rebase schema <action> --help` says something. */\nconst SCHEMA_ACTION_HELP: Record<string, { usage: string; summary: string; notes?: string[] }> = {\n    generate: {\n        usage: \"rebase schema generate [--collections <dir>] [--output <file>] [--watch]\",\n        summary: \"Generate the Drizzle schema from the collection definitions.\",\n        notes: [\"--watch regenerates on every change to a collection file.\"]\n    },\n    introspect: {\n        usage: \"rebase schema introspect [--collections <dir>] [--output <dir>] [--schema <name>] [--force]\",\n        summary: \"Read an existing database and write Rebase collection definitions from it.\",\n        notes: [\"--force overwrites collection files that are already there.\"]\n    },\n    stale: {\n        usage: \"rebase schema stale [--collections <dir>] [--output <file>] [--fix]\",\n        summary: \"Report generated schema files that no longer match the collections.\",\n        notes: [\"--fix regenerates them instead of only reporting.\"]\n    }\n};\n\n/** Every subcommand the family dispatches — the help table's keys. */\nexport const SCHEMA_SUBCOMMANDS = Object.keys(SCHEMA_ACTION_HELP);\n\nfunction printSchemaHelp(action?: string) {\n    const entry = action ? SCHEMA_ACTION_HELP[action] : undefined;\n    if (entry) {\n        console.log(`\n${chalk.bold(`rebase schema ${action}`)}\n\n  ${entry.summary}\n\n${chalk.green.bold(\"Usage\")}\n  ${chalk.blue(entry.usage)}\n${entry.notes?.length ? `\\n${chalk.green.bold(\"Notes\")}\\n${entry.notes.map(n => `  ${chalk.gray(`• ${n}`)}`).join(\"\\n\")}\\n` : \"\"}\n${chalk.gray(\"Run `rebase schema --help` for every subcommand.\")}\n`);\n        return;\n    }\n\n    console.log(`\n${chalk.bold(\"rebase schema\")} — Schema management commands\n\n${chalk.green.bold(\"Usage\")}\n  rebase schema ${chalk.blue(\"<command>\")} [options]\n\n${chalk.green.bold(\"Commands\")}\n  ${chalk.gray(\"(Commands are provided by your active database driver plugin)\")}\n  ${chalk.blue.bold(\"generate\")}    Generate Schema from collection definitions\n  ${chalk.blue.bold(\"introspect\")}  Introspect an existing database to generate collection definitions\n  ${chalk.blue.bold(\"stale\")}       Report generated schema files that no longer match the collections\n\n${chalk.green.bold(\"generate Options\")}\n  ${chalk.blue(\"--collections, -c\")}  ${COLLECTIONS_FLAG_HELP}\n  ${chalk.blue(\"--output, -o\")}       Output path for generated schema\n  ${chalk.blue(\"--watch, -w\")}        Watch for changes and regenerate automatically\n\n${chalk.green.bold(\"introspect Options\")}\n  ${chalk.blue(\"--output, -o\")}       Output directory for generated collection files\n  ${chalk.blue(\"--schema\")}           Postgres schema to read (default: public)\n  ${chalk.blue(\"--force, -f\")}        Overwrite collection files that already exist\n\n${chalk.green.bold(\"stale Options\")}\n  ${chalk.blue(\"--fix\")}              Regenerate the stale files instead of only reporting them\n`);\n}\n"],"mappings":"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"}