@rebasepro/cli 0.23.0 → 0.24.1-canary.g19596ef

package/dist/storage-DyVq-f_F.js

@@ -0,0 +1,303 @@
+import { d as readEnvFile, p as requireProjectRoot } from "./project-Wp2zoyeN.js";
+import { n as parseCommandArgs, r as wantsHelp, t as UsageError } from "./args-BnmsEXvu.js";
+import { t as unknownCommand } from "./unknown-command-DNwDcX3w.js";
+import { t as cliUserAgent } from "./version-Buyyo1ut.js";
+import { describeFailure, resolveBaseUrl } from "./api-keys-Bl1I9q7M.js";
+import chalk from "chalk";
+import { RebaseApiError } from "@rebasepro/client";
+import readline from "node:readline/promises";
+//#region src/commands/storage.ts
+/**
+* CLI command: rebase storage <action>
+*
+* Whole-store maintenance through the running backend's `/api/admin/storage`,
+* authenticated with the service key from `.env`.
+*
+* Subcommands:
+*   orphans — Stored files no row names; `--delete` deletes them
+*   move    — Copy a folder of files to another storage source, same keys
+*/
+/** Everything the switch below dispatches, for the did-you-mean. */
+var STORAGE_SUBCOMMANDS = ["orphans", "move"];
+/** The flags `rebase storage orphans` takes. */
+var ORPHANS_FLAGS = {
+	"--source": String,
+	"--older-than": Number,
+	"--delete": Boolean,
+	"--yes": Boolean,
+	"-y": "--yes",
+	"--json": Boolean
+};
+/** The flags `rebase storage move` takes. */
+var MOVE_FLAGS = {
+	"--from": String,
+	"--to": String,
+	"--prefix": String,
+	"--delete-source": Boolean,
+	"--json": Boolean
+};
+/** The project's backend, holding the service key — the `admin` role, every scope. */
+function connect() {
+	const projectRoot = requireProjectRoot();
+	const env = readEnvFile(projectRoot);
+	const baseUrl = resolveBaseUrl(env, projectRoot).replace(/\/+$/, "");
+	const serviceKey = env.SERVICE_KEY || env.REBASE_SERVICE_KEY;
+	if (!serviceKey) {
+		console.error(chalk.red("✗ REBASE_SERVICE_KEY not found in .env — required for storage maintenance."));
+		process.exit(1);
+	}
+	return {
+		baseUrl,
+		async request(method, path, body) {
+			let response;
+			try {
+				response = await fetch(`${baseUrl}/api/admin/storage${path}`, {
+					method,
+					headers: {
+						"Authorization": `Bearer ${serviceKey}`,
+						"Accept": "application/json",
+						"User-Agent": cliUserAgent(),
+						...body === void 0 ? {} : { "Content-Type": "application/json" }
+					},
+					...body === void 0 ? {} : { body: JSON.stringify(body) }
+				});
+			} catch (error) {
+				throw new RebaseApiError(error instanceof Error ? error.message : String(error), {
+					status: 0,
+					code: "NETWORK_ERROR"
+				});
+			}
+			const answer = await response.json().catch(() => void 0);
+			if (!response.ok) {
+				const error = answer && typeof answer === "object" && "error" in answer && answer.error && typeof answer.error === "object" ? answer.error : void 0;
+				throw new RebaseApiError(typeof error?.message === "string" ? error.message : `The server answered ${response.status}.`, {
+					status: response.status,
+					code: typeof error?.code === "string" ? error.code : void 0,
+					details: error?.details
+				});
+			}
+			return answer.data;
+		}
+	};
+}
+function fail(action, error, baseUrl) {
+	for (const line of describeFailure(action, error, baseUrl)) console.error(line.startsWith("✗") ? chalk.red(line) : chalk.gray(line));
+	if (error instanceof RebaseApiError && error.status === 404 && error.code !== "UNKNOWN_STORAGE_SOURCE") console.error(chalk.gray("  This backend has no storage maintenance routes: they arrived in 0.25, and need storage configured."));
+	process.exit(1);
+}
+/** Bytes, as a person reads them. */
+function formatBytes(bytes) {
+	if (bytes < 1024) return `${bytes} B`;
+	const units = [
+		"KB",
+		"MB",
+		"GB",
+		"TB"
+	];
+	let value = bytes / 1024;
+	let unit = 0;
+	while (value >= 1024 && unit < units.length - 1) {
+		value /= 1024;
+		unit++;
+	}
+	return `${value.toFixed(value < 10 ? 1 : 0)} ${units[unit]}`;
+}
+/**
+* The lines that describe an orphan scan. Exported so its tests can read them
+* without a server.
+*/
+function describeOrphanReport(report, olderThanHours) {
+	const lines = [];
+	const bytes = report.orphans.reduce((sum, orphan) => sum + (orphan.size ?? 0), 0);
+	lines.push(`  ${report.objects} file(s) in source "${report.storageId}", ${report.scanned.length} collection(s) read.`);
+	if (report.orphans.length === 0) lines.push(`  No file older than ${olderThanHours}h is unused.`);
+	else {
+		lines.push(`  ${report.orphans.length} file(s) no row names, ${formatBytes(bytes)}:`);
+		for (const orphan of report.orphans) lines.push(`    ${orphan.key}${orphan.size !== void 0 ? `  ${formatBytes(orphan.size)}` : ""}${orphan.updated ? `  ${orphan.updated}` : ""}`);
+	}
+	if (report.recent > 0) lines.push(`  ${report.recent} more no row names are newer than ${olderThanHours}h, or of unknown age, and are left out: an upload can be saved before the row that names it.`);
+	for (const entry of report.unscanned) lines.push(`  ⚠ ${entry.collection} could not be read (${entry.reason}): a file only it names is listed above.`);
+	return lines;
+}
+async function confirm(question) {
+	const prompt = readline.createInterface({
+		input: process.stdin,
+		output: process.stdout
+	});
+	try {
+		return /^y(es)?$/i.test((await prompt.question(question)).trim());
+	} finally {
+		prompt.close();
+	}
+}
+async function orphans(rawArgs) {
+	const { flags } = parseCommandArgs({
+		spec: ORPHANS_FLAGS,
+		rawArgs,
+		commandWords: 2,
+		command: "storage orphans",
+		maxPositionals: 0
+	});
+	const olderThan = flags["--older-than"] ?? 24;
+	if (!Number.isFinite(olderThan) || olderThan < 0) throw new UsageError("--older-than takes a number of hours, 0 or more.");
+	const query = new URLSearchParams({ olderThanHours: String(olderThan) });
+	if (flags["--source"]) query.set("storageId", flags["--source"]);
+	const backend = connect();
+	let report;
+	try {
+		report = await backend.request("GET", `/orphans?${query}`);
+	} catch (error) {
+		fail("Failed to scan storage", error, backend.baseUrl);
+	}
+	if (!flags["--delete"]) {
+		if (flags["--json"]) {
+			console.log(JSON.stringify(report, null, 2));
+			return;
+		}
+		console.log("");
+		for (const line of describeOrphanReport(report, olderThan)) console.log(line);
+		if (report.orphans.length > 0) {
+			console.log("");
+			console.log(chalk.gray("  Nothing was deleted. Run again with --delete to delete them."));
+		}
+		console.log("");
+		return;
+	}
+	if (!flags["--json"]) {
+		console.log("");
+		for (const line of describeOrphanReport(report, olderThan)) console.log(line);
+		console.log("");
+	}
+	if (report.orphans.length === 0) return;
+	if (report.unscanned.length > 0) {
+		console.error(chalk.red("✗ Not deleting: some collections could not be read, so a file they name would look unused."));
+		process.exit(1);
+	}
+	if (!flags["--yes"]) {
+		if (!process.stdin.isTTY) throw new UsageError("--delete deletes files for good; pass --yes to confirm when there is no terminal to ask.");
+		if (!await confirm(`  Delete these ${report.orphans.length} file(s) for good? [y/N] `)) {
+			console.log(chalk.gray("  Nothing was deleted."));
+			return;
+		}
+	}
+	let result;
+	try {
+		result = await backend.request("DELETE", `/orphans?${query}`);
+	} catch (error) {
+		fail("Failed to delete unused files", error, backend.baseUrl);
+	}
+	if (flags["--json"]) console.log(JSON.stringify(result, null, 2));
+	else {
+		console.log(chalk.green(`  ✓ Deleted ${result.deleted.length} file(s).`));
+		for (const failure of result.failed) console.error(chalk.red(`  ✗ ${failure.key}: ${failure.error}`));
+		console.log("");
+	}
+	if (result.failed.length > 0) process.exitCode = 1;
+}
+async function move(rawArgs) {
+	const { flags } = parseCommandArgs({
+		spec: MOVE_FLAGS,
+		rawArgs,
+		commandWords: 2,
+		command: "storage move",
+		maxPositionals: 0
+	});
+	const from = flags["--from"];
+	const to = flags["--to"];
+	if (!from && !to) throw new UsageError("Name the sources: --from <source> --to <source>. The default source is \"(default)\", and either may be left out for it.");
+	const backend = connect();
+	const counts = {
+		copied: 0,
+		exists: 0,
+		failed: 0,
+		deleted: 0
+	};
+	const failures = [];
+	let cursor;
+	do {
+		let page;
+		try {
+			page = await backend.request("POST", "/move", {
+				from,
+				to,
+				prefix: flags["--prefix"],
+				cursor,
+				deleteSource: flags["--delete-source"] === true
+			});
+		} catch (error) {
+			fail("Failed to move files", error, backend.baseUrl);
+		}
+		for (const object of page.moved) {
+			counts[object.outcome]++;
+			if (object.deleted) counts.deleted++;
+			if (object.outcome === "failed") failures.push(object);
+		}
+		if (!flags["--json"] && process.stdout.isTTY) process.stdout.write(`\r  ${counts.copied} copied, ${counts.exists} already there, ${counts.failed} failed…`);
+		cursor = page.cursor;
+	} while (cursor);
+	if (flags["--json"]) console.log(JSON.stringify({
+		...counts,
+		failures
+	}, null, 2));
+	else {
+		if (process.stdout.isTTY) process.stdout.write("\n");
+		console.log(chalk.green(`  ✓ ${counts.copied} copied, ${counts.exists} already there${flags["--delete-source"] ? `, ${counts.deleted} deleted from the source` : ""}.`));
+		for (const failure of failures) console.error(chalk.red(`  ✗ ${failure.key}: ${failure.error ?? "failed"}`));
+		if (counts.copied + counts.exists > 0 && !flags["--delete-source"]) console.log(chalk.gray("  The source keeps its copies. Point the property at the new source, then run again with --delete-source."));
+	}
+	if (failures.length > 0) process.exitCode = 1;
+}
+async function storageCommand(subcommand, rawArgs) {
+	if (!subcommand || subcommand === "--help" || wantsHelp(rawArgs)) {
+		printStorageHelp();
+		return;
+	}
+	switch (subcommand) {
+		case "orphans":
+			await orphans(rawArgs);
+			break;
+		case "move":
+			await move(rawArgs);
+			break;
+		default: unknownCommand(subcommand, STORAGE_SUBCOMMANDS, "storage");
+	}
+}
+function printStorageHelp() {
+	console.log(`
+${chalk.bold("rebase storage")} — Maintain stored files, through the running backend
+
+${chalk.green.bold("Usage")}
+  rebase storage ${chalk.blue("<command>")} [options]
+
+${chalk.green.bold("Commands")}
+  ${chalk.blue.bold("orphans")}           List the stored files no row names
+  ${chalk.blue.bold("move")}              Copy a folder of files to another storage source, same keys
+
+${chalk.green.bold("orphans Options")}
+  ${chalk.blue("--source")}          Storage source key ${chalk.gray("(default: the default source)")}
+  ${chalk.blue("--older-than")}      Hours a file must be old to count ${chalk.gray("(default: 24)")}
+  ${chalk.blue("--delete")}          Delete them, after asking
+  ${chalk.blue("--yes, -y")}         Do not ask ${chalk.gray("(required with --delete when there is no terminal)")}
+  ${chalk.blue("--json")}            Print the report as JSON
+
+${chalk.green.bold("move Options")}
+  ${chalk.blue("--from")}            Source to copy from ${chalk.gray("(default: the default source)")}
+  ${chalk.blue("--to")}              Source to copy to ${chalk.gray("(default: the default source)")}
+  ${chalk.blue("--prefix")}          Folder to copy ${chalk.gray("(default: everything)")}
+  ${chalk.blue("--delete-source")}   Delete each file from the source once the target holds it
+  ${chalk.blue("--json")}            Print the counts as JSON
+
+${chalk.green.bold("Notes")}
+  A file is unused when no string in any row of any collection names it —
+  a key, a URL, a ${chalk.blue("rebase-storage:")} reference in text — whatever property
+  or source holds it. Files newer than ${chalk.blue("--older-than")} are left out: the admin
+  panel uploads a file before the row that names it is saved. Files your own
+  tables name, outside collections, are not seen: check before deleting.
+
+  Both read ${chalk.blue("REBASE_SERVICE_KEY")} from .env and need the backend running.
+`);
+}
+//#endregion
+export { STORAGE_SUBCOMMANDS, storageCommand };
+
+//# sourceMappingURL=storage-DyVq-f_F.js.map

package/dist/storage-DyVq-f_F.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-DyVq-f_F.js","names":[],"sources":["../src/commands/storage.ts"],"sourcesContent":["/**\n * CLI command: rebase storage <action>\n *\n * Whole-store maintenance through the running backend's `/api/admin/storage`,\n * authenticated with the service key from `.env`.\n *\n * Subcommands:\n *   orphans — Stored files no row names; `--delete` deletes them\n *   move    — Copy a folder of files to another storage source, same keys\n */\nimport chalk from \"chalk\";\nimport readline from \"node:readline/promises\";\nimport { RebaseApiError } from \"@rebasepro/client\";\nimport { requireProjectRoot, readEnvFile } from \"../utils/project\";\nimport { parseCommandArgs, UsageError, wantsHelp } from \"../utils/args\";\nimport { unknownCommand } from \"../utils/unknown-command\";\nimport { cliUserAgent } from \"../utils/version\";\nimport { describeFailure, resolveBaseUrl } from \"./api-keys\";\n\n/** Everything the switch below dispatches, for the did-you-mean. */\nexport const STORAGE_SUBCOMMANDS = [\"orphans\", \"move\"] as const;\n\n/** The flags `rebase storage orphans` takes. */\nexport const ORPHANS_FLAGS = {\n    \"--source\": String,\n    \"--older-than\": Number,\n    \"--delete\": Boolean,\n    \"--yes\": Boolean,\n    \"-y\": \"--yes\",\n    \"--json\": Boolean\n} as const;\n\n/** The flags `rebase storage move` takes. */\nexport const MOVE_FLAGS = {\n    \"--from\": String,\n    \"--to\": String,\n    \"--prefix\": String,\n    \"--delete-source\": Boolean,\n    \"--json\": Boolean\n} as const;\n\n/** One stored object, as the backend lists it. */\ninterface StoredObjectEntry {\n    key: string;\n    size?: number;\n    updated?: string;\n}\n\n/** What `GET /admin/storage/orphans` answers. */\nexport interface OrphanReport {\n    storageId: string;\n    objects: number;\n    orphans: StoredObjectEntry[];\n    recent: number;\n    scanned: string[];\n    unscanned: { collection: string; reason: string }[];\n}\n\ninterface MovedObject {\n    key: string;\n    outcome: \"copied\" | \"exists\" | \"failed\";\n    deleted?: boolean;\n    error?: string;\n}\n\ninterface Backend {\n    baseUrl: string;\n    request<T>(method: string, path: string, body?: unknown): Promise<T>;\n}\n\n/** The project's backend, holding the service key — the `admin` role, every scope. */\nfunction connect(): Backend {\n    const projectRoot = requireProjectRoot();\n    const env = readEnvFile(projectRoot);\n    const baseUrl = resolveBaseUrl(env, projectRoot).replace(/\\/+$/, \"\");\n    const serviceKey = env.SERVICE_KEY || env.REBASE_SERVICE_KEY;\n    if (!serviceKey) {\n        console.error(chalk.red(\"✗ REBASE_SERVICE_KEY not found in .env — required for storage maintenance.\"));\n        process.exit(1);\n    }\n    return {\n        baseUrl,\n        async request<T>(method: string, path: string, body?: unknown): Promise<T> {\n            let response: Response;\n            try {\n                response = await fetch(`${baseUrl}/api/admin/storage${path}`, {\n                    method,\n                    headers: {\n                        \"Authorization\": `Bearer ${serviceKey}`,\n                        \"Accept\": \"application/json\",\n                        \"User-Agent\": cliUserAgent(),\n                        ...(body === undefined ? {} : { \"Content-Type\": \"application/json\" })\n                    },\n                    ...(body === undefined ? {} : { body: JSON.stringify(body) })\n                });\n            } catch (error: unknown) {\n                throw new RebaseApiError(error instanceof Error ? error.message : String(error), { status: 0, code: \"NETWORK_ERROR\" });\n            }\n            const answer: unknown = await response.json().catch(() => undefined);\n            if (!response.ok) {\n                const error = answer && typeof answer === \"object\" && \"error\" in answer && answer.error && typeof answer.error === \"object\"\n                    ? answer.error as { message?: unknown; code?: unknown; details?: unknown }\n                    : undefined;\n                throw new RebaseApiError(\n                    typeof error?.message === \"string\" ? error.message : `The server answered ${response.status}.`,\n                    { status: response.status, code: typeof error?.code === \"string\" ? error.code : undefined, details: error?.details }\n                );\n            }\n            return (answer as { data: T }).data;\n        }\n    };\n}\n\nfunction fail(action: string, error: unknown, baseUrl: string): never {\n    for (const line of describeFailure(action, error, baseUrl)) {\n        console.error(line.startsWith(\"✗\") ? chalk.red(line) : chalk.gray(line));\n    }\n    if (error instanceof RebaseApiError && error.status === 404 && error.code !== \"UNKNOWN_STORAGE_SOURCE\") {\n        console.error(chalk.gray(\"  This backend has no storage maintenance routes: they arrived in 0.25, and need storage configured.\"));\n    }\n    process.exit(1);\n}\n\n/** Bytes, as a person reads them. */\nexport function formatBytes(bytes: number): string {\n    if (bytes < 1024) return `${bytes} B`;\n    const units = [\"KB\", \"MB\", \"GB\", \"TB\"];\n    let value = bytes / 1024;\n    let unit = 0;\n    while (value >= 1024 && unit < units.length - 1) {\n        value /= 1024;\n        unit++;\n    }\n    return `${value.toFixed(value < 10 ? 1 : 0)} ${units[unit]}`;\n}\n\n/**\n * The lines that describe an orphan scan. Exported so its tests can read them\n * without a server.\n */\nexport function describeOrphanReport(report: OrphanReport, olderThanHours: number): string[] {\n    const lines: string[] = [];\n    const bytes = report.orphans.reduce((sum, orphan) => sum + (orphan.size ?? 0), 0);\n    lines.push(`  ${report.objects} file(s) in source \"${report.storageId}\", ${report.scanned.length} collection(s) read.`);\n    if (report.orphans.length === 0) {\n        lines.push(\"  No file older than \" + `${olderThanHours}h is unused.`);\n    } else {\n        lines.push(`  ${report.orphans.length} file(s) no row names, ${formatBytes(bytes)}:`);\n        for (const orphan of report.orphans) {\n            lines.push(`    ${orphan.key}${orphan.size !== undefined ? `  ${formatBytes(orphan.size)}` : \"\"}${orphan.updated ? `  ${orphan.updated}` : \"\"}`);\n        }\n    }\n    if (report.recent > 0) {\n        lines.push(`  ${report.recent} more no row names are newer than ${olderThanHours}h, or of unknown age, and are left out: ` +\n            \"an upload can be saved before the row that names it.\");\n    }\n    for (const entry of report.unscanned) {\n        lines.push(`  ⚠ ${entry.collection} could not be read (${entry.reason}): a file only it names is listed above.`);\n    }\n    return lines;\n}\n\nasync function confirm(question: string): Promise<boolean> {\n    const prompt = readline.createInterface({ input: process.stdin, output: process.stdout });\n    try {\n        return /^y(es)?$/i.test((await prompt.question(question)).trim());\n    } finally {\n        prompt.close();\n    }\n}\n\nasync function orphans(rawArgs: string[]): Promise<void> {\n    const { flags } = parseCommandArgs({ spec: ORPHANS_FLAGS, rawArgs, commandWords: 2, command: \"storage orphans\", maxPositionals: 0 });\n    const olderThan = flags[\"--older-than\"] ?? 24;\n    if (!Number.isFinite(olderThan) || olderThan < 0) {\n        throw new UsageError(\"--older-than takes a number of hours, 0 or more.\");\n    }\n    const query = new URLSearchParams({ olderThanHours: String(olderThan) });\n    if (flags[\"--source\"]) query.set(\"storageId\", flags[\"--source\"]);\n    const backend = connect();\n\n    let report: OrphanReport;\n    try {\n        report = await backend.request<OrphanReport>(\"GET\", `/orphans?${query}`);\n    } catch (error: unknown) {\n        fail(\"Failed to scan storage\", error, backend.baseUrl);\n    }\n\n    if (!flags[\"--delete\"]) {\n        if (flags[\"--json\"]) {\n            console.log(JSON.stringify(report, null, 2));\n            return;\n        }\n        console.log(\"\");\n        for (const line of describeOrphanReport(report, olderThan)) console.log(line);\n        if (report.orphans.length > 0) {\n            console.log(\"\");\n            console.log(chalk.gray(\"  Nothing was deleted. Run again with --delete to delete them.\"));\n        }\n        console.log(\"\");\n        return;\n    }\n\n    if (!flags[\"--json\"]) {\n        console.log(\"\");\n        for (const line of describeOrphanReport(report, olderThan)) console.log(line);\n        console.log(\"\");\n    }\n    if (report.orphans.length === 0) return;\n    if (report.unscanned.length > 0) {\n        console.error(chalk.red(\"✗ Not deleting: some collections could not be read, so a file they name would look unused.\"));\n        process.exit(1);\n    }\n    if (!flags[\"--yes\"]) {\n        if (!process.stdin.isTTY) {\n            throw new UsageError(\"--delete deletes files for good; pass --yes to confirm when there is no terminal to ask.\");\n        }\n        if (!await confirm(`  Delete these ${report.orphans.length} file(s) for good? [y/N] `)) {\n            console.log(chalk.gray(\"  Nothing was deleted.\"));\n            return;\n        }\n    }\n\n    let result: { deleted: string[]; failed: { key: string; error: string }[] };\n    try {\n        // The server finds them again before it deletes: a file a row has\n        // named since the list was printed is not deleted.\n        result = await backend.request(\"DELETE\", `/orphans?${query}`);\n    } catch (error: unknown) {\n        fail(\"Failed to delete unused files\", error, backend.baseUrl);\n    }\n    if (flags[\"--json\"]) {\n        console.log(JSON.stringify(result, null, 2));\n    } else {\n        console.log(chalk.green(`  ✓ Deleted ${result.deleted.length} file(s).`));\n        for (const failure of result.failed) console.error(chalk.red(`  ✗ ${failure.key}: ${failure.error}`));\n        console.log(\"\");\n    }\n    if (result.failed.length > 0) process.exitCode = 1;\n}\n\nasync function move(rawArgs: string[]): Promise<void> {\n    const { flags } = parseCommandArgs({ spec: MOVE_FLAGS, rawArgs, commandWords: 2, command: \"storage move\", maxPositionals: 0 });\n    const from = flags[\"--from\"];\n    const to = flags[\"--to\"];\n    if (!from && !to) {\n        throw new UsageError(\"Name the sources: --from <source> --to <source>. The default source is \\\"(default)\\\", and either may be left out for it.\");\n    }\n    const backend = connect();\n    const counts = { copied: 0, exists: 0, failed: 0, deleted: 0 };\n    const failures: MovedObject[] = [];\n    let cursor: string | undefined;\n    do {\n        let page: { moved: MovedObject[]; cursor?: string };\n        try {\n            page = await backend.request(\"POST\", \"/move\", {\n                from,\n                to,\n                prefix: flags[\"--prefix\"],\n                cursor,\n                deleteSource: flags[\"--delete-source\"] === true\n            });\n        } catch (error: unknown) {\n            fail(\"Failed to move files\", error, backend.baseUrl);\n        }\n        for (const object of page.moved) {\n            counts[object.outcome]++;\n            if (object.deleted) counts.deleted++;\n            if (object.outcome === \"failed\") failures.push(object);\n        }\n        if (!flags[\"--json\"] && process.stdout.isTTY) {\n            process.stdout.write(`\\r  ${counts.copied} copied, ${counts.exists} already there, ${counts.failed} failed…`);\n        }\n        cursor = page.cursor;\n    } while (cursor);\n\n    if (flags[\"--json\"]) {\n        console.log(JSON.stringify({ ...counts, failures }, null, 2));\n    } else {\n        if (process.stdout.isTTY) process.stdout.write(\"\\n\");\n        console.log(chalk.green(`  ✓ ${counts.copied} copied, ${counts.exists} already there` +\n            `${flags[\"--delete-source\"] ? `, ${counts.deleted} deleted from the source` : \"\"}.`));\n        for (const failure of failures) console.error(chalk.red(`  ✗ ${failure.key}: ${failure.error ?? \"failed\"}`));\n        if (counts.copied + counts.exists > 0 && !flags[\"--delete-source\"]) {\n            console.log(chalk.gray(\"  The source keeps its copies. Point the property at the new source, then run again with --delete-source.\"));\n        }\n    }\n    if (failures.length > 0) process.exitCode = 1;\n}\n\nexport async function storageCommand(subcommand: string | undefined, rawArgs: string[]): Promise<void> {\n    if (!subcommand || subcommand === \"--help\" || wantsHelp(rawArgs)) {\n        printStorageHelp();\n        return;\n    }\n    switch (subcommand) {\n        case \"orphans\":\n            await orphans(rawArgs);\n            break;\n        case \"move\":\n            await move(rawArgs);\n            break;\n        default:\n            unknownCommand(subcommand, STORAGE_SUBCOMMANDS, \"storage\");\n    }\n}\n\nfunction printStorageHelp(): void {\n    console.log(`\n${chalk.bold(\"rebase storage\")} — Maintain stored files, through the running backend\n\n${chalk.green.bold(\"Usage\")}\n  rebase storage ${chalk.blue(\"<command>\")} [options]\n\n${chalk.green.bold(\"Commands\")}\n  ${chalk.blue.bold(\"orphans\")}           List the stored files no row names\n  ${chalk.blue.bold(\"move\")}              Copy a folder of files to another storage source, same keys\n\n${chalk.green.bold(\"orphans Options\")}\n  ${chalk.blue(\"--source\")}          Storage source key ${chalk.gray(\"(default: the default source)\")}\n  ${chalk.blue(\"--older-than\")}      Hours a file must be old to count ${chalk.gray(\"(default: 24)\")}\n  ${chalk.blue(\"--delete\")}          Delete them, after asking\n  ${chalk.blue(\"--yes, -y\")}         Do not ask ${chalk.gray(\"(required with --delete when there is no terminal)\")}\n  ${chalk.blue(\"--json\")}            Print the report as JSON\n\n${chalk.green.bold(\"move Options\")}\n  ${chalk.blue(\"--from\")}            Source to copy from ${chalk.gray(\"(default: the default source)\")}\n  ${chalk.blue(\"--to\")}              Source to copy to ${chalk.gray(\"(default: the default source)\")}\n  ${chalk.blue(\"--prefix\")}          Folder to copy ${chalk.gray(\"(default: everything)\")}\n  ${chalk.blue(\"--delete-source\")}   Delete each file from the source once the target holds it\n  ${chalk.blue(\"--json\")}            Print the counts as JSON\n\n${chalk.green.bold(\"Notes\")}\n  A file is unused when no string in any row of any collection names it —\n  a key, a URL, a ${chalk.blue(\"rebase-storage:\")} reference in text — whatever property\n  or source holds it. Files newer than ${chalk.blue(\"--older-than\")} are left out: the admin\n  panel uploads a file before the row that names it is saved. Files your own\n  tables name, outside collections, are not seen: check before deleting.\n\n  Both read ${chalk.blue(\"REBASE_SERVICE_KEY\")} from .env and need the backend running.\n`);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,IAAa,sBAAsB,CAAC,WAAW,MAAM;;AAGrD,IAAa,gBAAgB;CACzB,YAAY;CACZ,gBAAgB;CAChB,YAAY;CACZ,SAAS;CACT,MAAM;CACN,UAAU;AACd;;AAGA,IAAa,aAAa;CACtB,UAAU;CACV,QAAQ;CACR,YAAY;CACZ,mBAAmB;CACnB,UAAU;AACd;;AAgCA,SAAS,UAAmB;CACxB,MAAM,cAAc,mBAAmB;CACvC,MAAM,MAAM,YAAY,WAAW;CACnC,MAAM,UAAU,eAAe,KAAK,WAAW,CAAC,CAAC,QAAQ,QAAQ,EAAE;CACnE,MAAM,aAAa,IAAI,eAAe,IAAI;CAC1C,IAAI,CAAC,YAAY;EACb,QAAQ,MAAM,MAAM,IAAI,4EAA4E,CAAC;EACrG,QAAQ,KAAK,CAAC;CAClB;CACA,OAAO;EACH;EACA,MAAM,QAAW,QAAgB,MAAc,MAA4B;GACvE,IAAI;GACJ,IAAI;IACA,WAAW,MAAM,MAAM,GAAG,QAAQ,oBAAoB,QAAQ;KAC1D;KACA,SAAS;MACL,iBAAiB,UAAU;MAC3B,UAAU;MACV,cAAc,aAAa;MAC3B,GAAI,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,gBAAgB,mBAAmB;KACvE;KACA,GAAI,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM,KAAK,UAAU,IAAI,EAAE;IAC/D,CAAC;GACL,SAAS,OAAgB;IACrB,MAAM,IAAI,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG;KAAE,QAAQ;KAAG,MAAM;IAAgB,CAAC;GACzH;GACA,MAAM,SAAkB,MAAM,SAAS,KAAK,CAAC,CAAC,YAAY,KAAA,CAAS;GACnE,IAAI,CAAC,SAAS,IAAI;IACd,MAAM,QAAQ,UAAU,OAAO,WAAW,YAAY,WAAW,UAAU,OAAO,SAAS,OAAO,OAAO,UAAU,WAC7G,OAAO,QACP,KAAA;IACN,MAAM,IAAI,eACN,OAAO,OAAO,YAAY,WAAW,MAAM,UAAU,uBAAuB,SAAS,OAAO,IAC5F;KAAE,QAAQ,SAAS;KAAQ,MAAM,OAAO,OAAO,SAAS,WAAW,MAAM,OAAO,KAAA;KAAW,SAAS,OAAO;IAAQ,CACvH;GACJ;GACA,OAAQ,OAAuB;EACnC;CACJ;AACJ;AAEA,SAAS,KAAK,QAAgB,OAAgB,SAAwB;CAClE,KAAK,MAAM,QAAQ,gBAAgB,QAAQ,OAAO,OAAO,GACrD,QAAQ,MAAM,KAAK,WAAW,GAAG,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,KAAK,IAAI,CAAC;CAE3E,IAAI,iBAAiB,kBAAkB,MAAM,WAAW,OAAO,MAAM,SAAS,0BAC1E,QAAQ,MAAM,MAAM,KAAK,sGAAsG,CAAC;CAEpI,QAAQ,KAAK,CAAC;AAClB;;AAGA,SAAgB,YAAY,OAAuB;CAC/C,IAAI,QAAQ,MAAM,OAAO,GAAG,MAAM;CAClC,MAAM,QAAQ;EAAC;EAAM;EAAM;EAAM;CAAI;CACrC,IAAI,QAAQ,QAAQ;CACpB,IAAI,OAAO;CACX,OAAO,SAAS,QAAQ,OAAO,MAAM,SAAS,GAAG;EAC7C,SAAS;EACT;CACJ;CACA,OAAO,GAAG,MAAM,QAAQ,QAAQ,KAAK,IAAI,CAAC,EAAE,GAAG,MAAM;AACzD;;;;;AAMA,SAAgB,qBAAqB,QAAsB,gBAAkC;CACzF,MAAM,QAAkB,CAAC;CACzB,MAAM,QAAQ,OAAO,QAAQ,QAAQ,KAAK,WAAW,OAAO,OAAO,QAAQ,IAAI,CAAC;CAChF,MAAM,KAAK,KAAK,OAAO,QAAQ,sBAAsB,OAAO,UAAU,KAAK,OAAO,QAAQ,OAAO,qBAAqB;CACtH,IAAI,OAAO,QAAQ,WAAW,GAC1B,MAAM,KAAK,wBAA6B,eAAe,aAAa;MACjE;EACH,MAAM,KAAK,KAAK,OAAO,QAAQ,OAAO,yBAAyB,YAAY,KAAK,EAAE,EAAE;EACpF,KAAK,MAAM,UAAU,OAAO,SACxB,MAAM,KAAK,OAAO,OAAO,MAAM,OAAO,SAAS,KAAA,IAAY,KAAK,YAAY,OAAO,IAAI,MAAM,KAAK,OAAO,UAAU,KAAK,OAAO,YAAY,IAAI;CAEvJ;CACA,IAAI,OAAO,SAAS,GAChB,MAAM,KAAK,KAAK,OAAO,OAAO,oCAAoC,eAAe,6FACvB;CAE9D,KAAK,MAAM,SAAS,OAAO,WACvB,MAAM,KAAK,OAAO,MAAM,WAAW,sBAAsB,MAAM,OAAO,yCAAyC;CAEnH,OAAO;AACX;AAEA,eAAe,QAAQ,UAAoC;CACvD,MAAM,SAAS,SAAS,gBAAgB;EAAE,OAAO,QAAQ;EAAO,QAAQ,QAAQ;CAAO,CAAC;CACxF,IAAI;EACA,OAAO,YAAY,MAAM,MAAM,OAAO,SAAS,QAAQ,EAAA,CAAG,KAAK,CAAC;CACpE,UAAU;EACN,OAAO,MAAM;CACjB;AACJ;AAEA,eAAe,QAAQ,SAAkC;CACrD,MAAM,EAAE,UAAU,iBAAiB;EAAE,MAAM;EAAe;EAAS,cAAc;EAAG,SAAS;EAAmB,gBAAgB;CAAE,CAAC;CACnI,MAAM,YAAY,MAAM,mBAAmB;CAC3C,IAAI,CAAC,OAAO,SAAS,SAAS,KAAK,YAAY,GAC3C,MAAM,IAAI,WAAW,kDAAkD;CAE3E,MAAM,QAAQ,IAAI,gBAAgB,EAAE,gBAAgB,OAAO,SAAS,EAAE,CAAC;CACvE,IAAI,MAAM,aAAa,MAAM,IAAI,aAAa,MAAM,WAAW;CAC/D,MAAM,UAAU,QAAQ;CAExB,IAAI;CACJ,IAAI;EACA,SAAS,MAAM,QAAQ,QAAsB,OAAO,YAAY,OAAO;CAC3E,SAAS,OAAgB;EACrB,KAAK,0BAA0B,OAAO,QAAQ,OAAO;CACzD;CAEA,IAAI,CAAC,MAAM,aAAa;EACpB,IAAI,MAAM,WAAW;GACjB,QAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;GAC3C;EACJ;EACA,QAAQ,IAAI,EAAE;EACd,KAAK,MAAM,QAAQ,qBAAqB,QAAQ,SAAS,GAAG,QAAQ,IAAI,IAAI;EAC5E,IAAI,OAAO,QAAQ,SAAS,GAAG;GAC3B,QAAQ,IAAI,EAAE;GACd,QAAQ,IAAI,MAAM,KAAK,gEAAgE,CAAC;EAC5F;EACA,QAAQ,IAAI,EAAE;EACd;CACJ;CAEA,IAAI,CAAC,MAAM,WAAW;EAClB,QAAQ,IAAI,EAAE;EACd,KAAK,MAAM,QAAQ,qBAAqB,QAAQ,SAAS,GAAG,QAAQ,IAAI,IAAI;EAC5E,QAAQ,IAAI,EAAE;CAClB;CACA,IAAI,OAAO,QAAQ,WAAW,GAAG;CACjC,IAAI,OAAO,UAAU,SAAS,GAAG;EAC7B,QAAQ,MAAM,MAAM,IAAI,4FAA4F,CAAC;EACrH,QAAQ,KAAK,CAAC;CAClB;CACA,IAAI,CAAC,MAAM,UAAU;EACjB,IAAI,CAAC,QAAQ,MAAM,OACf,MAAM,IAAI,WAAW,0FAA0F;EAEnH,IAAI,CAAC,MAAM,QAAQ,kBAAkB,OAAO,QAAQ,OAAO,0BAA0B,GAAG;GACpF,QAAQ,IAAI,MAAM,KAAK,wBAAwB,CAAC;GAChD;EACJ;CACJ;CAEA,IAAI;CACJ,IAAI;EAGA,SAAS,MAAM,QAAQ,QAAQ,UAAU,YAAY,OAAO;CAChE,SAAS,OAAgB;EACrB,KAAK,iCAAiC,OAAO,QAAQ,OAAO;CAChE;CACA,IAAI,MAAM,WACN,QAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;MACxC;EACH,QAAQ,IAAI,MAAM,MAAM,eAAe,OAAO,QAAQ,OAAO,UAAU,CAAC;EACxE,KAAK,MAAM,WAAW,OAAO,QAAQ,QAAQ,MAAM,MAAM,IAAI,OAAO,QAAQ,IAAI,IAAI,QAAQ,OAAO,CAAC;EACpG,QAAQ,IAAI,EAAE;CAClB;CACA,IAAI,OAAO,OAAO,SAAS,GAAG,QAAQ,WAAW;AACrD;AAEA,eAAe,KAAK,SAAkC;CAClD,MAAM,EAAE,UAAU,iBAAiB;EAAE,MAAM;EAAY;EAAS,cAAc;EAAG,SAAS;EAAgB,gBAAgB;CAAE,CAAC;CAC7H,MAAM,OAAO,MAAM;CACnB,MAAM,KAAK,MAAM;CACjB,IAAI,CAAC,QAAQ,CAAC,IACV,MAAM,IAAI,WAAW,0HAA0H;CAEnJ,MAAM,UAAU,QAAQ;CACxB,MAAM,SAAS;EAAE,QAAQ;EAAG,QAAQ;EAAG,QAAQ;EAAG,SAAS;CAAE;CAC7D,MAAM,WAA0B,CAAC;CACjC,IAAI;CACJ,GAAG;EACC,IAAI;EACJ,IAAI;GACA,OAAO,MAAM,QAAQ,QAAQ,QAAQ,SAAS;IAC1C;IACA;IACA,QAAQ,MAAM;IACd;IACA,cAAc,MAAM,uBAAuB;GAC/C,CAAC;EACL,SAAS,OAAgB;GACrB,KAAK,wBAAwB,OAAO,QAAQ,OAAO;EACvD;EACA,KAAK,MAAM,UAAU,KAAK,OAAO;GAC7B,OAAO,OAAO,QAAQ;GACtB,IAAI,OAAO,SAAS,OAAO;GAC3B,IAAI,OAAO,YAAY,UAAU,SAAS,KAAK,MAAM;EACzD;EACA,IAAI,CAAC,MAAM,aAAa,QAAQ,OAAO,OACnC,QAAQ,OAAO,MAAM,OAAO,OAAO,OAAO,WAAW,OAAO,OAAO,kBAAkB,OAAO,OAAO,SAAS;EAEhH,SAAS,KAAK;CAClB,SAAS;CAET,IAAI,MAAM,WACN,QAAQ,IAAI,KAAK,UAAU;EAAE,GAAG;EAAQ;CAAS,GAAG,MAAM,CAAC,CAAC;MACzD;EACH,IAAI,QAAQ,OAAO,OAAO,QAAQ,OAAO,MAAM,IAAI;EACnD,QAAQ,IAAI,MAAM,MAAM,OAAO,OAAO,OAAO,WAAW,OAAO,OAAO,gBAC/D,MAAM,qBAAqB,KAAK,OAAO,QAAQ,4BAA4B,GAAG,EAAE,CAAC;EACxF,KAAK,MAAM,WAAW,UAAU,QAAQ,MAAM,MAAM,IAAI,OAAO,QAAQ,IAAI,IAAI,QAAQ,SAAS,UAAU,CAAC;EAC3G,IAAI,OAAO,SAAS,OAAO,SAAS,KAAK,CAAC,MAAM,oBAC5C,QAAQ,IAAI,MAAM,KAAK,2GAA2G,CAAC;CAE3I;CACA,IAAI,SAAS,SAAS,GAAG,QAAQ,WAAW;AAChD;AAEA,eAAsB,eAAe,YAAgC,SAAkC;CACnG,IAAI,CAAC,cAAc,eAAe,YAAY,UAAU,OAAO,GAAG;EAC9D,iBAAiB;EACjB;CACJ;CACA,QAAQ,YAAR;EACI,KAAK;GACD,MAAM,QAAQ,OAAO;GACrB;EACJ,KAAK;GACD,MAAM,KAAK,OAAO;GAClB;EACJ,SACI,eAAe,YAAY,qBAAqB,SAAS;CACjE;AACJ;AAEA,SAAS,mBAAyB;CAC9B,QAAQ,IAAI;EACd,MAAM,KAAK,gBAAgB,EAAE;;EAE7B,MAAM,MAAM,KAAK,OAAO,EAAE;mBACT,MAAM,KAAK,WAAW,EAAE;;EAEzC,MAAM,MAAM,KAAK,UAAU,EAAE;IAC3B,MAAM,KAAK,KAAK,SAAS,EAAE;IAC3B,MAAM,KAAK,KAAK,MAAM,EAAE;;EAE1B,MAAM,MAAM,KAAK,iBAAiB,EAAE;IAClC,MAAM,KAAK,UAAU,EAAE,+BAA+B,MAAM,KAAK,+BAA+B,EAAE;IAClG,MAAM,KAAK,cAAc,EAAE,0CAA0C,MAAM,KAAK,eAAe,EAAE;IACjG,MAAM,KAAK,UAAU,EAAE;IACvB,MAAM,KAAK,WAAW,EAAE,sBAAsB,MAAM,KAAK,oDAAoD,EAAE;IAC/G,MAAM,KAAK,QAAQ,EAAE;;EAEvB,MAAM,MAAM,KAAK,cAAc,EAAE;IAC/B,MAAM,KAAK,QAAQ,EAAE,kCAAkC,MAAM,KAAK,+BAA+B,EAAE;IACnG,MAAM,KAAK,MAAM,EAAE,kCAAkC,MAAM,KAAK,+BAA+B,EAAE;IACjG,MAAM,KAAK,UAAU,EAAE,2BAA2B,MAAM,KAAK,uBAAuB,EAAE;IACtF,MAAM,KAAK,iBAAiB,EAAE;IAC9B,MAAM,KAAK,QAAQ,EAAE;;EAEvB,MAAM,MAAM,KAAK,OAAO,EAAE;;oBAER,MAAM,KAAK,iBAAiB,EAAE;yCACT,MAAM,KAAK,cAAc,EAAE;;;;cAItD,MAAM,KAAK,oBAAoB,EAAE;CAC9C;AACD"}

package/dist/telemetry/identity.d.ts

@@ -7,7 +7,8 @@
  *  - `machineId` — one developer's machine. Lives beside the cloud credentials
  *    in `~/.rebase/`, so it survives across every project they scaffold.
  *  - `projectId` — one *checkout*. Lives in the project's gitignored
- *    `.rebase/`, next to `cloud.json` and `state.json`.
+ *    `.rebase/`, in a file of its own, `telemetry-project.json`, so it lasts
+ *    as long as the checkout does.
  *
  * Without the split, a developer trying five templates in an afternoon reads as
  * five installations. With it, that is one machine and five projects, which is
@@ -51,6 +52,8 @@ export declare function writeConfig(config: TelemetryConfig): void;
  * be a record we had no right to create, even unsent.
  */
 export declare function ensureMachineId(): string;
+/** Where a checkout keeps its id, under the project's gitignored `.rebase/`. */
+export declare const PROJECT_ID_FILE = "telemetry-project.json";
 /**
  * The checkout's id, generating one if this project has none.
  *
@@ -65,5 +68,11 @@ export declare function ensureMachineId(): string;
  * The `rebase.json` check is what keeps the fix from being "scatter `.rebase/`
  * wherever a command happens to run": no manifest, no project, no directory,
  * and the event simply reports no project.
+ *
+ * A file of its own, written by nothing else. The id used to be a key in
+ * `.rebase/state.json`, which is the dev server's runtime file: rewritten
+ * from scratch on every start and deleted on every shutdown. So every
+ * restart of `rebase dev` minted a new id, and one checkout read as a new
+ * project each time — the error this split exists to prevent, by another way.
  */
 export declare function ensureProjectId(projectRoot: string): string | undefined;

package/dist/telemetry-C8Uq8phb.js

@@ -0,0 +1,129 @@
+import { a as setConsent, d as configPath, f as readConfig, r as previewEvent, s as readProjectPolicy, t as endpoint } from "./telemetry-EMFRVRQi.js";
+import { n as parseCommandArgs, r as wantsHelp } from "./args-BnmsEXvu.js";
+import { t as unknownCommand } from "./unknown-command-DNwDcX3w.js";
+import { r as renderPreview, t as describeState } from "./consent-ClRHmcxf.js";
+import chalk from "chalk";
+//#region src/commands/telemetry.ts
+/**
+* `rebase telemetry` — the command that makes the rest of it inspectable.
+*
+* The whole subsystem asks for trust it cannot otherwise earn, and the cheapest
+* way to earn it is to stop describing the payload and print it. `show` runs
+* the same builder the sender uses, so what appears here is what would go, not
+* a documentation comment that quietly fell out of date two releases ago.
+*/
+/** Everything the switch below dispatches, for the did-you-mean. */
+var TELEMETRY_SUBCOMMANDS = [
+	"status",
+	"show",
+	"enable",
+	"disable"
+];
+async function telemetryCommand(rawArgs) {
+	if (wantsHelp(rawArgs)) {
+		printHelp();
+		return;
+	}
+	const { positionals } = parseCommandArgs({
+		spec: {},
+		rawArgs,
+		commandWords: 1,
+		command: "telemetry",
+		maxPositionals: 1
+	});
+	const subcommand = positionals[0];
+	switch (subcommand) {
+		case "status":
+		case void 0:
+			printStatus();
+			return;
+		case "show":
+			printPayload();
+			return;
+		case "enable":
+			if (!setConsent(true)) {
+				console.error(chalk.red(`Could not write ${configPath()} — sharing was not enabled.`));
+				process.exitCode = 1;
+				return;
+			}
+			console.log(chalk.green("Anonymous usage sharing enabled."));
+			console.log(chalk.gray(`Inspect what gets sent with ${chalk.cyan("rebase telemetry show")}.`));
+			return;
+		case "disable":
+			if (!setConsent(false)) {
+				console.error(chalk.red(`Could not write ${configPath()} — sharing is still ON.`));
+				console.error(chalk.yellow(`Set ${chalk.cyan("REBASE_TELEMETRY_DISABLED=1")} in your environment instead; it needs no file.`));
+				process.exitCode = 1;
+				return;
+			}
+			console.log(chalk.gray("Anonymous usage sharing disabled. Nothing further will be sent."));
+			return;
+		default: unknownCommand(subcommand, TELEMETRY_SUBCOMMANDS, "telemetry");
+	}
+}
+function printStatus() {
+	console.log("");
+	console.log(`  Status:   ${describeState()}`);
+	if (readProjectPolicy() === "ignored_opt_in") {
+		console.log("");
+		console.log(chalk.yellow("  Note: this project's rebase.json sets \"telemetry\": true, which is ignored."));
+		console.log(chalk.gray("        A committed file cannot consent on behalf of everyone who clones it."));
+		console.log(chalk.gray(`        Only "telemetry": false is honoured there. Use ${chalk.cyan("rebase telemetry enable")}.`));
+	}
+	console.log(`  Endpoint: ${chalk.gray(endpoint())}`);
+	console.log(`  Config:   ${chalk.gray(configPath())}`);
+	console.log("");
+	console.log(chalk.gray(`  ${chalk.cyan("rebase telemetry show")} prints the exact payload.`));
+	console.log("");
+}
+function printPayload() {
+	if (readConfig().enabled !== true) {
+		console.log("");
+		console.log(`  ${describeState()}`);
+		console.log("");
+		console.log(chalk.gray("  Nothing is being sent. This is what WOULD be sent if you said yes:"));
+		console.log("");
+		console.log(renderPreview("cli.dev", { first_run: false }).split("\n").map((l) => "  " + l).join("\n"));
+		console.log("");
+		console.log(chalk.gray(`  Start sharing with ${chalk.cyan("rebase telemetry enable")}.`));
+		console.log("");
+		return;
+	}
+	const event = previewEvent("cli.dev", { first_run: false }, process.cwd());
+	console.log("");
+	console.log(chalk.gray("  Sent to ") + chalk.gray(endpoint()) + chalk.gray(", for example:"));
+	console.log("");
+	console.log(JSON.stringify(event, null, 2).split("\n").map((l) => "  " + l).join("\n"));
+	console.log("");
+	console.log(chalk.gray("  Both ids are random. Neither is derived from your machine, your"));
+	console.log(chalk.gray("  hostname, your project name or anything you have typed."));
+	console.log("");
+}
+function printHelp() {
+	console.log(`
+${chalk.bold("rebase telemetry")} — anonymous usage sharing (off until you say yes; ${chalk.cyan("rebase init")} asks)
+
+${chalk.bold("Commands")}
+  ${chalk.blue("status")}     Whether anything is being shared, and why ${chalk.gray("(default)")}
+  ${chalk.blue("show")}       Print the exact payload that would be sent
+  ${chalk.blue("enable")}     Start sharing
+  ${chalk.blue("disable")}    Stop sharing, permanently
+
+${chalk.bold("Project policy")}
+  ${chalk.blue("\"telemetry\": false")} in ${chalk.blue("rebase.json")} disables sharing for everyone who
+  clones the repository, overriding each developer's own choice.
+  ${chalk.gray("\"telemetry\": true is ignored — a committed file cannot consent for others.")}
+
+${chalk.bold("Environment")}
+  ${chalk.blue("DO_NOT_TRACK")}                 Set to disable, across every tool that honours it
+  ${chalk.blue("REBASE_TELEMETRY_DISABLED")}    Set to disable Rebase specifically
+  ${chalk.blue("REBASE_TELEMETRY_ENDPOINT")}    Send elsewhere — your own collector, for instance
+
+${chalk.gray("Never shared: project names, paths, collection or table names, database")}
+${chalk.gray("URLs, hostnames, error messages, stack traces, or exact record counts.")}
+`);
+}
+//#endregion
+export { TELEMETRY_SUBCOMMANDS, telemetryCommand };
+
+//# sourceMappingURL=telemetry-C8Uq8phb.js.map

package/dist/telemetry-C8Uq8phb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-C8Uq8phb.js","names":[],"sources":["../src/commands/telemetry.ts"],"sourcesContent":["import chalk from \"chalk\";\n\nimport { describeState, renderPreview } from \"../telemetry/consent\";\nimport { configPath, endpoint, previewEvent, readConfig, readProjectPolicy, setConsent } from \"../telemetry\";\nimport { parseCommandArgs, wantsHelp } from \"../utils/args\";\nimport { unknownCommand } from \"../utils/unknown-command\";\n\n/**\n * `rebase telemetry` — the command that makes the rest of it inspectable.\n *\n * The whole subsystem asks for trust it cannot otherwise earn, and the cheapest\n * way to earn it is to stop describing the payload and print it. `show` runs\n * the same builder the sender uses, so what appears here is what would go, not\n * a documentation comment that quietly fell out of date two releases ago.\n */\n/** Everything the switch below dispatches, for the did-you-mean. */\nexport const TELEMETRY_SUBCOMMANDS = [\"status\", \"show\", \"enable\", \"disable\"] as const;\n\nexport async function telemetryCommand(rawArgs: string[]): Promise<void> {\n    // Checked before parsing, because `--help` is answered by the dispatcher\n    // and never by a handler. It used to be checked after a `filter(a =>\n    // !a.startsWith(\"-\"))` that stripped every flag off the line, so `rebase\n    // telemetry --help` reached `case undefined` and printed the status page.\n    if (wantsHelp(rawArgs)) {\n        printHelp();\n        return;\n    }\n\n    // Strictly, like every other family. That `filter` was not \"be lenient\": it\n    // deleted every `-`-prefixed token before dispatch, so `rebase telemetry\n    // --frobnicate` printed the status page and exited 0, and a mistyped\n    // `--disable` looked exactly like asking for the status. `parseCommandArgs`\n    // is the CLI's one rule for an undeclared flag, and the comment at the top\n    // of `utils/args.ts` is why: guessing that an unknown flag was meant as\n    // something else is the unsafe branch.\n    const { positionals } = parseCommandArgs({\n        spec: {},\n        rawArgs,\n        commandWords: 1,\n        command: \"telemetry\",\n        maxPositionals: 1\n    });\n    const subcommand = positionals[0];\n\n    switch (subcommand) {\n        case \"status\":\n        case undefined:\n            printStatus();\n            return;\n        case \"show\":\n            printPayload();\n            return;\n        case \"enable\":\n            if (!setConsent(true)) {\n                console.error(chalk.red(`Could not write ${configPath()} — sharing was not enabled.`));\n                process.exitCode = 1;\n                return;\n            }\n            console.log(chalk.green(\"Anonymous usage sharing enabled.\"));\n            console.log(chalk.gray(`Inspect what gets sent with ${chalk.cyan(\"rebase telemetry show\")}.`));\n            return;\n        case \"disable\":\n            if (!setConsent(false)) {\n                // The failure direction that matters. Someone turning sharing\n                // off must never be left believing it worked — so this is loud,\n                // non-zero, and points at the switch that needs no disk.\n                console.error(chalk.red(`Could not write ${configPath()} — sharing is still ON.`));\n                console.error(chalk.yellow(`Set ${chalk.cyan(\"REBASE_TELEMETRY_DISABLED=1\")} in your environment instead; it needs no file.`));\n                process.exitCode = 1;\n                return;\n            }\n            console.log(chalk.gray(\"Anonymous usage sharing disabled. Nothing further will be sent.\"));\n            return;\n        default:\n            // Printing the help and setting exit 1 said nothing about *why*:\n            // the page that came back looked like the page `rebase telemetry\n            // --help` prints, and the only difference was an exit code nobody\n            // reads at a prompt.\n            unknownCommand(subcommand, TELEMETRY_SUBCOMMANDS, \"telemetry\");\n    }\n}\n\nfunction printStatus(): void {\n    console.log(\"\");\n    console.log(`  Status:   ${describeState()}`);\n    if (readProjectPolicy() === \"ignored_opt_in\") {\n        // Said out loud rather than silently ignored: a maintainer who wrote\n        // `\"telemetry\": true` believes they turned something on, and leaving\n        // them to believe it is worse than refusing.\n        console.log(\"\");\n        console.log(chalk.yellow(\"  Note: this project's rebase.json sets \\\"telemetry\\\": true, which is ignored.\"));\n        console.log(chalk.gray(\"        A committed file cannot consent on behalf of everyone who clones it.\"));\n        console.log(chalk.gray(`        Only \"telemetry\": false is honoured there. Use ${chalk.cyan(\"rebase telemetry enable\")}.`));\n    }\n    console.log(`  Endpoint: ${chalk.gray(endpoint())}`);\n    console.log(`  Config:   ${chalk.gray(configPath())}`);\n    console.log(\"\");\n    console.log(chalk.gray(`  ${chalk.cyan(\"rebase telemetry show\")} prints the exact payload.`));\n    console.log(\"\");\n}\n\nfunction printPayload(): void {\n    const config = readConfig();\n    if (config.enabled !== true) {\n        // Deliberately still prints one. The consent prompt points here so the\n        // question can stay short, and someone deciding whether to say yes is\n        // exactly the person who most needs to see the payload — telling them\n        // to enable sharing first, in order to find out what sharing sends,\n        // is the wrong way round.\n        console.log(\"\");\n        console.log(`  ${describeState()}`);\n        console.log(\"\");\n        console.log(chalk.gray(\"  Nothing is being sent. This is what WOULD be sent if you said yes:\"));\n        console.log(\"\");\n        console.log(renderPreview(\"cli.dev\", { first_run: false }).split(\"\\n\").map((l) => \"  \" + l).join(\"\\n\"));\n        console.log(\"\");\n        console.log(chalk.gray(`  Start sharing with ${chalk.cyan(\"rebase telemetry enable\")}.`));\n        console.log(\"\");\n        return;\n    }\n\n    // A representative event rather than a synthetic one: `cli.dev` is the\n    // event that fires most often, so it is the one worth being sure about.\n    const event = previewEvent(\"cli.dev\", { first_run: false }, process.cwd());\n    console.log(\"\");\n    console.log(chalk.gray(\"  Sent to \") + chalk.gray(endpoint()) + chalk.gray(\", for example:\"));\n    console.log(\"\");\n    console.log(JSON.stringify(event, null, 2).split(\"\\n\").map((l) => \"  \" + l).join(\"\\n\"));\n    console.log(\"\");\n    console.log(chalk.gray(\"  Both ids are random. Neither is derived from your machine, your\"));\n    console.log(chalk.gray(\"  hostname, your project name or anything you have typed.\"));\n    console.log(\"\");\n}\n\nfunction printHelp(): void {\n    console.log(`\n${chalk.bold(\"rebase telemetry\")} — anonymous usage sharing (off until you say yes; ${chalk.cyan(\"rebase init\")} asks)\n\n${chalk.bold(\"Commands\")}\n  ${chalk.blue(\"status\")}     Whether anything is being shared, and why ${chalk.gray(\"(default)\")}\n  ${chalk.blue(\"show\")}       Print the exact payload that would be sent\n  ${chalk.blue(\"enable\")}     Start sharing\n  ${chalk.blue(\"disable\")}    Stop sharing, permanently\n\n${chalk.bold(\"Project policy\")}\n  ${chalk.blue('\"telemetry\": false')} in ${chalk.blue(\"rebase.json\")} disables sharing for everyone who\n  clones the repository, overriding each developer's own choice.\n  ${chalk.gray('\"telemetry\": true is ignored — a committed file cannot consent for others.')}\n\n${chalk.bold(\"Environment\")}\n  ${chalk.blue(\"DO_NOT_TRACK\")}                 Set to disable, across every tool that honours it\n  ${chalk.blue(\"REBASE_TELEMETRY_DISABLED\")}    Set to disable Rebase specifically\n  ${chalk.blue(\"REBASE_TELEMETRY_ENDPOINT\")}    Send elsewhere — your own collector, for instance\n\n${chalk.gray(\"Never shared: project names, paths, collection or table names, database\")}\n${chalk.gray(\"URLs, hostnames, error messages, stack traces, or exact record counts.\")}\n`);\n}\n"],"mappings":"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"}