@rebasepro/cli 0.24.0 → 0.24.1-canary.g56af4a4

package/dist/generate_sdk-UV635zSe.js

@@ -0,0 +1,477 @@
+import { n as getPMCommands, t as detectPackageManager } from "./package-manager-DSEOwTqM.js";
+import { c as findProjectRoot } from "./project-Wp2zoyeN.js";
+import { d as findBackendApp, m as manifestExists, p as loadManifest, x as writeManifest } from "./manifest-DzlC60WX.js";
+import { M as readLink } from "./context-BqhRydBg.js";
+import { n as COLLECTIONS_PATH_RULE, t as COLLECTIONS_FLAG_HELP } from "./path-flags-DUBuI2i1.js";
+import { n as isLoadedCollectionFile } from "./collection-drift-BKj_BoMq.js";
+import chalk from "chalk";
+import fs from "fs";
+import path from "path";
+import { computeSchemaVersion, deserializeCollections } from "@rebasepro/types";
+import { CodegenError, generateSDK, toCollectionAccessor } from "@rebasepro/codegen";
+//#region src/commands/generate_sdk.ts
+/**
+* CLI command: generate-sdk
+*
+* Reads every collection file in a directory (default: ./config/collections) —
+* the files the backend serves, not the barrel's list — generates a typed
+* TypeScript SDK, and writes it to the output directory (default: ./generated/sdk).
+*
+* Uses jiti for dynamic TypeScript import of collection files.
+*/
+/** What `--register` writes, and what marks a project as having opted in. */
+var REGISTER_FILE = "register.ts";
+/** The first line of {@link REGISTER_FILE}: a file without it is the developer's own. */
+var REGISTER_MARKER = "// Auto-generated by `rebase generate-sdk --register`. Do not edit.";
+var REGISTER_SOURCE = `${REGISTER_MARKER}
+//
+// Registers this project's generated \`Database\` on \`@rebasepro/types\`, so
+// \`context.data\` in collection callbacks, \`rebase.dataAsAdmin\`, and the
+// \`rebase\` a function or a cron receives are typed from it. Every later
+// \`rebase generate-sdk\` (and \`rebase dev\`) refreshes this directory; delete
+// it to go back to untyped server-side data.
+import type { Database } from "./database.types";
+
+declare module "@rebasepro/types" {
+    interface Register {
+        database: Database;
+    }
+}
+`;
+/**
+* Where `--register` writes: `generated/` beside the collections directory,
+* which is `config/generated/` in a scaffolded project.
+*
+* Inside `config/` because that is the one directory both compiles of a
+* collection file include: the backend's program (it includes
+* `../config/**`) and the `config` package's own `tsc`. A registration
+* there that imported `../generated/sdk/database.types` pulled a file from
+* outside `config/` into that package's program, which TypeScript refuses
+* (the file is not under its `rootDir`) — so the types are copied in beside
+* the registration rather than imported from the SDK.
+*/
+function registrationDir(collectionsDir) {
+	return path.join(path.dirname(path.resolve(collectionsDir)), "generated");
+}
+/** Whether this project opted in: the registration is there, and it is ours. */
+function hasRegistration(dir) {
+	try {
+		return fs.readFileSync(path.join(dir, REGISTER_FILE), "utf-8").startsWith(REGISTER_MARKER);
+	} catch {
+		return false;
+	}
+}
+/** Write a file only when its content changed, so a watcher on the directory does not restart for nothing. */
+function writeIfChanged(filePath, content) {
+	try {
+		if (fs.readFileSync(filePath, "utf-8") === content) return;
+	} catch {}
+	fs.writeFileSync(filePath, content, "utf-8");
+}
+/**
+* Write the generated `Database` and its `Register` augmentation into
+* {@link registrationDir}. Refuses to overwrite a `register.ts` it did not
+* write.
+*/
+function writeRegistration(dir, databaseTypes) {
+	const registerPath = path.join(dir, REGISTER_FILE);
+	if (fs.existsSync(registerPath) && !hasRegistration(dir)) throw new Error(`${registerPath} exists and was not written by "rebase generate-sdk --register". Move it, or register the Database there yourself.`);
+	fs.mkdirSync(dir, { recursive: true });
+	writeIfChanged(path.join(dir, "database.types.ts"), databaseTypes);
+	writeIfChanged(registerPath, REGISTER_SOURCE);
+}
+/**
+* Whether `rebase.json` asks for the registration (`registerDatabase: true` on
+* the backend app). That is what survives a clone: `generated/` is gitignored,
+* so a `register.ts` from an earlier run is not there to say it.
+*
+* An unreadable manifest answers no; `rebase build` is where it is reported.
+*/
+function manifestRegisters(projectRoot) {
+	if (!projectRoot || !manifestExists(projectRoot)) return false;
+	try {
+		return findBackendApp(loadManifest(projectRoot).manifest)?.app.registerDatabase === true;
+	} catch {
+		return false;
+	}
+}
+/**
+* Remember `--register` in `rebase.json`, so later runs, `rebase dev` and a
+* fresh clone keep registering. Returns where it was written, or why not.
+*
+* Never creates the file: a project without one is synthesized from its
+* layout, and writing one is `rebase apps init`'s decision, not this flag's.
+*/
+function rememberRegistration(projectRoot) {
+	if (!projectRoot || !manifestExists(projectRoot)) return { skipped: "No rebase.json here, so the choice lasts as long as the generated files." };
+	let loaded;
+	try {
+		loaded = loadManifest(projectRoot);
+	} catch (error) {
+		return { skipped: `rebase.json could not be read (${error instanceof Error ? error.message : String(error)}).` };
+	}
+	const backend = findBackendApp(loaded.manifest);
+	if (!backend) return { skipped: "rebase.json declares no backend app to remember it on." };
+	if (backend.app.registerDatabase === true) return { written: loaded.filePath ?? projectRoot };
+	return { written: writeManifest(projectRoot, {
+		...loaded.manifest,
+		apps: {
+			...loaded.manifest.apps,
+			[backend.name]: {
+				...backend.app,
+				registerDatabase: true
+			}
+		}
+	}) };
+}
+/**
+* Load the collections the backend serves, the way it finds them.
+*
+* A directory is read as `loadCollectionsFromDirectory` in @rebasepro/server
+* reads it: every top-level collection file, each default-exporting one
+* collection. The barrel (`index.ts`) is not a registry. The runtime, the admin
+* panel, `rebase build` and `rebase schema generate` all scan the directory, and
+* the barrel only orders the panel's navigation and declares
+* `defaultSecurityRules`. This command used to read the barrel instead, so a
+* collection file left out of it was created, served at `/api/data/<slug>` and
+* listed in the panel, and missing from the typed SDK alone.
+*
+* A file that does not load is fatal, as it is at boot: `rebase dev` runs this
+* on every save, and skipping the file would overwrite good types with a
+* `Database` that is silently short a collection.
+*
+* A path to a single module is read as the runtime reads one: its
+* `backendCollections`, or its `collections`.
+*/
+async function loadCollections(collectionsDir) {
+	const absDir = path.resolve(collectionsDir);
+	if (!fs.existsSync(absDir)) throw new Error(`Collections directory not found: ${absDir} (${COLLECTIONS_PATH_RULE})`);
+	let jiti;
+	try {
+		const jitiModule = await import("jiti");
+		jiti = jitiModule.default || jitiModule;
+	} catch {
+		const installCmd = [
+			...getPMCommands(detectPackageManager()).install,
+			"-D",
+			"jiti"
+		].join(" ");
+		throw new Error(`Could not load 'jiti'. Install it with: ${installCmd}\njiti is required to dynamically import TypeScript collection definitions.`);
+	}
+	if (!fs.statSync(absDir).isDirectory()) {
+		const mod = jiti(path.dirname(absDir), {
+			interopDefault: true,
+			esmResolve: true
+		})(absDir);
+		const listed = mod.backendCollections ?? mod.collections ?? mod.default;
+		if (Array.isArray(listed)) return listed;
+		throw new Error(`Could not extract collections from ${absDir}.\nA single collections module exports \`backendCollections\` or \`collections\`: an array of collections.`);
+	}
+	const jitiInstance = jiti(absDir, {
+		interopDefault: true,
+		esmResolve: true
+	});
+	const collections = [];
+	const failures = [];
+	const files = fs.readdirSync(absDir).filter(isLoadedCollectionFile).sort();
+	for (const file of files) try {
+		const mod = jitiInstance(path.join(absDir, file));
+		const exported = mod.default ?? mod;
+		if (exported && typeof exported === "object" && "slug" in exported) collections.push(exported);
+		else failures.push(`${file}: no default export of a collection`);
+	} catch (err) {
+		failures.push(`${file}: ${err.message}`);
+	}
+	if (failures.length > 0) throw new Error(`Could not load ${failures.length} collection file(s) from ${absDir}:\n` + failures.map((failure) => `  • ${failure}`).join("\n") + "\n\nEvery collection file must import cleanly and default-export a collection — the backend refuses to boot on the same file.");
+	return collections;
+}
+/**
+* Write generated files to the output directory.
+*/
+function writeFiles(outputDir, files) {
+	const absOutput = path.resolve(outputDir);
+	fs.mkdirSync(absOutput, { recursive: true });
+	for (const file of files) {
+		const filePath = path.join(absOutput, file.path);
+		const dir = path.dirname(filePath);
+		if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+		fs.writeFileSync(filePath, file.content, "utf-8");
+	}
+}
+function printSdkHelp() {
+	console.log(`
+${chalk.bold("rebase generate-sdk")} — generate a typed client from a project's schema
+
+${chalk.bold("Usage")}
+  rebase generate-sdk [options]
+
+${chalk.bold("Options")}
+  -c, --collections <dir>      ${COLLECTIONS_FLAG_HELP}
+                               (--collections-dir is accepted too)
+  -o, --output <dir>           Where to write the SDK (default: ./generated/sdk)
+                               (--out is accepted too, as on 'rebase build')
+      --from <link|url>        Fetch the schema from a running project instead of
+                               local source. "link" uses this checkout's linked project.
+      --token <token>          Bearer token for the contract endpoint
+                               (default: $REBASE_SERVICE_KEY)
+      --register               Also type server-side data: write the types and the
+                               Register declaration to config/generated/, and
+                               remember it in rebase.json so later runs keep it.
+  -h, --help                   Show this help
+
+${chalk.bold("Examples")}
+  rebase generate-sdk                              From local collections
+  rebase generate-sdk --from link                  From the linked project
+  rebase generate-sdk --from https://api.acme.com  From any Rebase backend
+  rebase generate-sdk --register                   Type context.data and rebase.dataAsAdmin too
+`.trim());
+}
+/**
+* Fetch collections from a running project's contract endpoint.
+*
+* The payload replaces relation `target` functions with slug references, so it
+* has to be rehydrated before the generator sees it — the generator *calls*
+* `target()` to decide whether a foreign key is a string or a number, and a
+* missing target silently degrades that to a union rather than failing.
+*/
+async function fetchRemoteCollections(baseUrl, token) {
+	const url = `${baseUrl.replace(/\/+$/, "")}/api/meta/contract`;
+	const headers = { accept: "application/json" };
+	if (token) headers.authorization = `Bearer ${token}`;
+	let response;
+	try {
+		response = await fetch(url, { headers });
+	} catch (err) {
+		console.log(chalk.red(`  ✗ Could not reach ${url}`));
+		console.log(chalk.gray(`    ${err instanceof Error ? err.message : String(err)}`));
+		process.exit(1);
+	}
+	if (response.status === 401 || response.status === 403) {
+		console.log(chalk.red(`  ✗ Not authorized to read the project contract (${response.status}).`));
+		console.log(chalk.gray("    The contract describes every table and relation, so it is admin-only."));
+		console.log(chalk.gray("    Pass --token, or set REBASE_SERVICE_KEY."));
+		process.exit(1);
+	}
+	if (response.status === 404) {
+		console.log(chalk.red("  ✗ This server has no contract endpoint."));
+		console.log(chalk.gray("    It needs to be running Rebase 0.11 or newer."));
+		process.exit(1);
+	}
+	if (!response.ok) {
+		console.log(chalk.red(`  ✗ Contract request failed with ${response.status}.`));
+		process.exit(1);
+	}
+	const contract = await response.json();
+	if (!Array.isArray(contract.collections)) {
+		console.log(chalk.red("  ✗ The contract response did not contain collections."));
+		process.exit(1);
+	}
+	return {
+		collections: deserializeCollections(contract.collections),
+		schemaVersion: contract.schemaVersion ?? "unknown"
+	};
+}
+/**
+* Decide whether the ambient service key may be sent to this host.
+*
+* `REBASE_SERVICE_KEY` grants full admin bypass. Attaching it to whatever URL
+* happened to be passed — or, worse, to whatever a committed `.rebase/cloud.json`
+* points at — would hand the project's most powerful credential to a host nobody
+* vetted. An explicit `--token` is a decision the caller made; the ambient
+* variable is not, so it only travels to the project this checkout is linked to.
+*/
+function mayUseAmbientKey(target, cwd) {
+	const link = readLink(findProjectRoot(cwd) ?? cwd);
+	if (!link?.apiUrl) return false;
+	try {
+		return new URL(link.apiUrl).origin === new URL(target).origin;
+	} catch {
+		return false;
+	}
+}
+/**
+* The base URL to show in the printed usage example.
+*
+* `rebase dev` binds a port derived from the project path, not 3001, and writes
+* the one it actually got to `.rebase/state.json`. Printing a hardcoded
+* `localhost:3001` sent people to a port nothing was listening on — or, with
+* several projects on one machine, to a different project's backend. Prefer the
+* port this project last ran on; fall back to the literal only when the project
+* has never been started.
+*/
+function resolveExampleBaseUrl(cwd) {
+	const projectRoot = findProjectRoot(cwd) ?? cwd;
+	try {
+		const state = JSON.parse(fs.readFileSync(path.join(projectRoot, ".rebase", "state.json"), "utf-8"));
+		if (typeof state.baseUrl === "string" && state.baseUrl) return state.baseUrl;
+		if (typeof state.port === "number") return `http://localhost:${state.port}`;
+	} catch {}
+	return "http://localhost:3001";
+}
+/** Whether a slug can be written as `rebase.data.<slug>` rather than a lookup. */
+function isIdentifierLike(slug) {
+	return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(slug);
+}
+/** Resolve `--from` into a base URL, following the link file when asked. */
+function resolveSchemaSource(from, cwd) {
+	if (from !== "link") {
+		let parsed;
+		try {
+			parsed = new URL(from);
+		} catch {
+			console.log(chalk.red(`  ✗ "${from}" is not a valid URL.`));
+			console.log(chalk.gray("    Pass a full URL, e.g. https://api.example.com, or \"link\"."));
+			process.exit(1);
+		}
+		if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+			console.log(chalk.red("  ✗ The project URL must be http or https."));
+			process.exit(1);
+		}
+		return from;
+	}
+	const link = readLink(findProjectRoot(cwd) ?? cwd);
+	if (!link) {
+		console.log(chalk.red("  ✗ This checkout is not linked to a project."));
+		console.log(chalk.gray("    Run `rebase cloud link <url>`, or pass --from <url>."));
+		process.exit(1);
+	}
+	const apiUrl = link.apiUrl;
+	if (!apiUrl) {
+		console.log(chalk.red("  ✗ The project link has no API URL."));
+		console.log(chalk.gray("    Re-link with `rebase cloud link <url>` to record one."));
+		process.exit(1);
+	}
+	return apiUrl;
+}
+/**
+* Main entry point for the generate-sdk command.
+*/
+async function generateSdkCommand(args) {
+	const { collectionsDir, output, cwd } = args;
+	if (args.help) {
+		printSdkHelp();
+		return;
+	}
+	const resolvedCollectionsDir = path.isAbsolute(collectionsDir) ? collectionsDir : path.join(cwd, collectionsDir);
+	const resolvedOutput = path.isAbsolute(output) ? output : path.join(cwd, output);
+	console.log("");
+	console.log(chalk.bold("  🔧 Rebase SDK Generator"));
+	console.log("");
+	let collections;
+	let remoteSchemaVersion;
+	if (args.from) {
+		const baseUrl = resolveSchemaSource(args.from, cwd);
+		console.log(`  ${chalk.gray("Project:")}     ${baseUrl}`);
+		console.log(`  ${chalk.gray("Output:")}      ${resolvedOutput}`);
+		console.log("");
+		console.log(chalk.cyan("  → Fetching the project contract..."));
+		const ambient = mayUseAmbientKey(baseUrl, cwd) ? process.env.REBASE_SERVICE_KEY : void 0;
+		if (!args.token && !ambient && process.env.REBASE_SERVICE_KEY) console.log(chalk.dim("  (not sending REBASE_SERVICE_KEY — this host is not the linked project; pass --token to override)"));
+		const remote = await fetchRemoteCollections(baseUrl, args.token || ambient);
+		collections = remote.collections;
+		remoteSchemaVersion = remote.schemaVersion;
+	} else {
+		if (!fs.existsSync(resolvedCollectionsDir)) {
+			console.log(chalk.gray("  ○ This project derives its API from the database — run `rebase schema introspect` first."));
+			console.log(chalk.gray(`    Nothing to generate from: ${resolvedCollectionsDir} does not exist.`));
+			console.log("");
+			return;
+		}
+		console.log(`  ${chalk.gray("Collections:")} ${resolvedCollectionsDir}`);
+		console.log(`  ${chalk.gray("Output:")}      ${resolvedOutput}`);
+		console.log("");
+		console.log(chalk.cyan("  → Loading collection definitions..."));
+		collections = await loadCollections(resolvedCollectionsDir);
+	}
+	collections.sort((a, b) => a.slug.localeCompare(b.slug));
+	if (collections.length === 0) {
+		console.log(chalk.red("  ✗ No collections found. Nothing to generate."));
+		process.exit(1);
+	}
+	console.log(chalk.green(`  ✓ Found ${collections.length} collection(s): ${collections.map((c) => c.slug).join(", ")}`));
+	console.log("");
+	console.log(chalk.cyan("  → Generating SDK files..."));
+	let files;
+	try {
+		files = generateSDK(collections);
+	} catch (err) {
+		if (err instanceof CodegenError) {
+			console.log("");
+			console.log(chalk.red(`  ✗ ${err.message}`));
+			process.exit(1);
+		}
+		throw err;
+	}
+	const schemaVersion = remoteSchemaVersion ?? computeSchemaVersion(collections);
+	files.push({
+		path: "schema.meta.ts",
+		content: `// Auto-generated by \`rebase generate-sdk\`. Do not edit.
+//
+// The schema version this SDK was generated from. Compare it against the
+// project's current version to detect drift:
+//
+//     curl -s <api-url>/api/meta/schema-version
+//
+// Pass it to the client as \`schemaVersion\` and every request carries it in
+// the \`x-rebase-schema\` header, so the server can name the drift instead of
+// answering a renamed field with a bare 400.
+export const SCHEMA_VERSION = ${JSON.stringify(schemaVersion)};
+`
+	});
+	console.log(chalk.green(`  ✓ Generated ${files.length} file(s)`));
+	console.log(chalk.gray(`    schema ${schemaVersion}`));
+	console.log(chalk.cyan(`  → Writing to ${resolvedOutput}...`));
+	writeFiles(resolvedOutput, files);
+	const registerDir = registrationDir(resolvedCollectionsDir);
+	const projectRoot = args.projectRoot ?? findProjectRoot(cwd) ?? void 0;
+	if (args.register || hasRegistration(registerDir) || manifestRegisters(projectRoot)) {
+		if (!fs.existsSync(path.dirname(registerDir))) {
+			console.log(chalk.red(`  ✗ No ${path.dirname(registerDir)} to register the Database in.`));
+			console.log(chalk.gray("    --register writes beside the collections directory; pass --collections."));
+			process.exit(1);
+			return;
+		}
+		const databaseTypes = files.find((file) => file.path === "database.types.ts")?.content;
+		if (databaseTypes !== void 0) {
+			try {
+				writeRegistration(registerDir, databaseTypes);
+			} catch (error) {
+				console.log(chalk.red(`  ✗ ${error instanceof Error ? error.message : String(error)}`));
+				process.exit(1);
+				return;
+			}
+			console.log(chalk.green(`  ✓ Registered the Database for server-side code in ${registerDir}`));
+			if (args.register) {
+				const remembered = rememberRegistration(projectRoot);
+				if ("written" in remembered) console.log(chalk.gray(`    Remembered in ${path.relative(cwd, remembered.written) || "rebase.json"} (registerDatabase).`));
+				else console.log(chalk.yellow(`    ${remembered.skipped}`));
+			}
+		}
+	}
+	console.log("");
+	console.log(chalk.green.bold("  ✓ SDK generated successfully!"));
+	console.log("");
+	const typesImport = `./${path.relative(cwd, path.join(resolvedOutput, "database.types"))}`;
+	const metaImport = `./${path.relative(cwd, path.join(resolvedOutput, "schema.meta"))}`;
+	const exampleSlug = collections[0]?.slug || "my_collection";
+	console.log(chalk.gray("  Usage:"));
+	console.log(chalk.gray("    import { createRebaseClient } from '@rebasepro/client';"));
+	console.log(chalk.gray(`    import { collectionsDictionary, type Database } from '${typesImport}';`));
+	console.log(chalk.gray(`    import { SCHEMA_VERSION } from '${metaImport}';`));
+	console.log("");
+	console.log(chalk.gray("    const rebase = createRebaseClient<Database>({"));
+	console.log(chalk.gray(`        baseUrl: '${resolveExampleBaseUrl(cwd)}',`));
+	console.log(chalk.gray("        schemaVersion: SCHEMA_VERSION,"));
+	console.log(chalk.gray("        collections: collectionsDictionary,"));
+	console.log(chalk.gray("        // token: 'your-jwt-token',"));
+	console.log(chalk.gray("    });"));
+	console.log("");
+	const exampleAccessor = toCollectionAccessor(exampleSlug);
+	const exampleAccess = isIdentifierLike(exampleAccessor) ? `rebase.data.${exampleAccessor}` : `rebase.data[${JSON.stringify(exampleAccessor)}]`;
+	console.log(chalk.gray(`    const { data } = await ${exampleAccess}.find();`));
+	console.log("");
+}
+//#endregion
+export { generateSdkCommand };
+
+//# sourceMappingURL=generate_sdk-UV635zSe.js.map

package/dist/generate_sdk-UV635zSe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate_sdk-UV635zSe.js","names":[],"sources":["../src/commands/generate_sdk.ts"],"sourcesContent":["/**\n * CLI command: generate-sdk\n *\n * Reads every collection file in a directory (default: ./config/collections) —\n * the files the backend serves, not the barrel's list — generates a typed\n * TypeScript SDK, and writes it to the output directory (default: ./generated/sdk).\n *\n * Uses jiti for dynamic TypeScript import of collection files.\n */\n\nimport fs from \"fs\";\nimport path from \"path\";\nimport chalk from \"chalk\";\nimport { CollectionConfig, computeSchemaVersion, deserializeCollections } from \"@rebasepro/types\";\nimport { CodegenError, generateSDK, GeneratedFile, toCollectionAccessor } from \"@rebasepro/codegen\";\nimport { detectPackageManager, getPMCommands } from \"../utils/package-manager\";\nimport { findProjectRoot } from \"../utils/project\";\nimport { findBackendApp, loadManifest, manifestExists, writeManifest } from \"../manifest\";\nimport { readLink } from \"./cloud/context\";\nimport { COLLECTIONS_FLAG_HELP, COLLECTIONS_PATH_RULE } from \"../utils/path-flags\";\nimport { isLoadedCollectionFile } from \"../utils/collection-drift\";\n\ninterface GenerateSDKArgs {\n    collectionsDir: string;\n    output: string;\n    cwd: string;\n    /**\n     * Where to read the schema from instead of local source.\n     *\n     * `link` uses this checkout's linked project; anything else is treated as\n     * the base URL of a Rebase backend. This is what lets a repository that\n     * contains no collections — a separate frontend, a second web app — generate\n     * a typed client from the project it talks to.\n     */\n    from?: string;\n    /** Bearer token for the contract endpoint. Falls back to REBASE_SERVICE_KEY. */\n    token?: string;\n    /**\n     * Also register the generated `Database` for server-side code: write the\n     * types and the `Register` augmentation into `config/generated/`. See\n     * {@link writeRegistration}.\n     */\n    register?: boolean;\n    /**\n     * The directory holding `rebase.json`, where `--register` is remembered.\n     * Found from `cwd` when not given.\n     */\n    projectRoot?: string;\n    help?: boolean;\n}\n\n/** What `--register` writes, and what marks a project as having opted in. */\nexport const REGISTER_FILE = \"register.ts\";\n\n/** The first line of {@link REGISTER_FILE}: a file without it is the developer's own. */\nconst REGISTER_MARKER = \"// Auto-generated by `rebase generate-sdk --register`. Do not edit.\";\n\nconst REGISTER_SOURCE = `${REGISTER_MARKER}\n//\n// Registers this project's generated \\`Database\\` on \\`@rebasepro/types\\`, so\n// \\`context.data\\` in collection callbacks, \\`rebase.dataAsAdmin\\`, and the\n// \\`rebase\\` a function or a cron receives are typed from it. Every later\n// \\`rebase generate-sdk\\` (and \\`rebase dev\\`) refreshes this directory; delete\n// it to go back to untyped server-side data.\nimport type { Database } from \"./database.types\";\n\ndeclare module \"@rebasepro/types\" {\n    interface Register {\n        database: Database;\n    }\n}\n`;\n\n/**\n * Where `--register` writes: `generated/` beside the collections directory,\n * which is `config/generated/` in a scaffolded project.\n *\n * Inside `config/` because that is the one directory both compiles of a\n * collection file include: the backend's program (it includes\n * `../config/**`) and the `config` package's own `tsc`. A registration\n * there that imported `../generated/sdk/database.types` pulled a file from\n * outside `config/` into that package's program, which TypeScript refuses\n * (the file is not under its `rootDir`) — so the types are copied in beside\n * the registration rather than imported from the SDK.\n */\nexport function registrationDir(collectionsDir: string): string {\n    return path.join(path.dirname(path.resolve(collectionsDir)), \"generated\");\n}\n\n/** Whether this project opted in: the registration is there, and it is ours. */\nfunction hasRegistration(dir: string): boolean {\n    try {\n        return fs.readFileSync(path.join(dir, REGISTER_FILE), \"utf-8\").startsWith(REGISTER_MARKER);\n    } catch {\n        return false;\n    }\n}\n\n/** Write a file only when its content changed, so a watcher on the directory does not restart for nothing. */\nfunction writeIfChanged(filePath: string, content: string): void {\n    try {\n        if (fs.readFileSync(filePath, \"utf-8\") === content) return;\n    } catch {\n        // Not there yet.\n    }\n    fs.writeFileSync(filePath, content, \"utf-8\");\n}\n\n/**\n * Write the generated `Database` and its `Register` augmentation into\n * {@link registrationDir}. Refuses to overwrite a `register.ts` it did not\n * write.\n */\nfunction writeRegistration(dir: string, databaseTypes: string): void {\n    const registerPath = path.join(dir, REGISTER_FILE);\n    if (fs.existsSync(registerPath) && !hasRegistration(dir)) {\n        throw new Error(\n            `${registerPath} exists and was not written by \"rebase generate-sdk --register\". ` +\n            \"Move it, or register the Database there yourself.\"\n        );\n    }\n    fs.mkdirSync(dir, { recursive: true });\n    writeIfChanged(path.join(dir, \"database.types.ts\"), databaseTypes);\n    writeIfChanged(registerPath, REGISTER_SOURCE);\n}\n\n/**\n * Whether `rebase.json` asks for the registration (`registerDatabase: true` on\n * the backend app). That is what survives a clone: `generated/` is gitignored,\n * so a `register.ts` from an earlier run is not there to say it.\n *\n * An unreadable manifest answers no; `rebase build` is where it is reported.\n */\nfunction manifestRegisters(projectRoot: string | undefined): boolean {\n    if (!projectRoot || !manifestExists(projectRoot)) return false;\n    try {\n        return findBackendApp(loadManifest(projectRoot).manifest)?.app.registerDatabase === true;\n    } catch {\n        return false;\n    }\n}\n\n/**\n * Remember `--register` in `rebase.json`, so later runs, `rebase dev` and a\n * fresh clone keep registering. Returns where it was written, or why not.\n *\n * Never creates the file: a project without one is synthesized from its\n * layout, and writing one is `rebase apps init`'s decision, not this flag's.\n */\nfunction rememberRegistration(projectRoot: string | undefined): { written: string } | { skipped: string } {\n    if (!projectRoot || !manifestExists(projectRoot)) {\n        return { skipped: \"No rebase.json here, so the choice lasts as long as the generated files.\" };\n    }\n    let loaded: ReturnType<typeof loadManifest>;\n    try {\n        loaded = loadManifest(projectRoot);\n    } catch (error) {\n        return { skipped: `rebase.json could not be read (${error instanceof Error ? error.message : String(error)}).` };\n    }\n    const backend = findBackendApp(loaded.manifest);\n    if (!backend) return { skipped: \"rebase.json declares no backend app to remember it on.\" };\n    if (backend.app.registerDatabase === true) return { written: loaded.filePath ?? projectRoot };\n    const manifest = {\n        ...loaded.manifest,\n        apps: { ...loaded.manifest.apps, [backend.name]: { ...backend.app, registerDatabase: true } }\n    };\n    return { written: writeManifest(projectRoot, manifest) };\n}\n\n/**\n * Load the collections the backend serves, the way it finds them.\n *\n * A directory is read as `loadCollectionsFromDirectory` in @rebasepro/server\n * reads it: every top-level collection file, each default-exporting one\n * collection. The barrel (`index.ts`) is not a registry. The runtime, the admin\n * panel, `rebase build` and `rebase schema generate` all scan the directory, and\n * the barrel only orders the panel's navigation and declares\n * `defaultSecurityRules`. This command used to read the barrel instead, so a\n * collection file left out of it was created, served at `/api/data/<slug>` and\n * listed in the panel, and missing from the typed SDK alone.\n *\n * A file that does not load is fatal, as it is at boot: `rebase dev` runs this\n * on every save, and skipping the file would overwrite good types with a\n * `Database` that is silently short a collection.\n *\n * A path to a single module is read as the runtime reads one: its\n * `backendCollections`, or its `collections`.\n */\nasync function loadCollections(collectionsDir: string): Promise<CollectionConfig[]> {\n    const absDir = path.resolve(collectionsDir);\n\n    if (!fs.existsSync(absDir)) {\n        throw new Error(`Collections directory not found: ${absDir} (${COLLECTIONS_PATH_RULE})`);\n    }\n\n    let jiti: (id: string, userOptions?: Record<string, unknown>) => (modulePath: string) => Record<string, unknown>;\n    try {\n        const jitiModule = await import(\"jiti\");\n        jiti = (jitiModule.default || jitiModule) as typeof jiti;\n    } catch {\n        const installCmd = [...getPMCommands(detectPackageManager()).install, \"-D\", \"jiti\"].join(\" \");\n        throw new Error(\n            `Could not load 'jiti'. Install it with: ${installCmd}\\n` +\n            \"jiti is required to dynamically import TypeScript collection definitions.\"\n        );\n    }\n\n    if (!fs.statSync(absDir).isDirectory()) {\n        const mod = jiti(path.dirname(absDir), { interopDefault: true, esmResolve: true })(absDir);\n        const listed = mod.backendCollections ?? mod.collections ?? mod.default;\n        if (Array.isArray(listed)) return listed as CollectionConfig[];\n        throw new Error(\n            `Could not extract collections from ${absDir}.\\n` +\n            \"A single collections module exports `backendCollections` or `collections`: an array of collections.\"\n        );\n    }\n\n    const jitiInstance = jiti(absDir, {\n        interopDefault: true,\n        esmResolve: true\n    });\n\n    const collections: CollectionConfig[] = [];\n    const failures: string[] = [];\n    const files = fs.readdirSync(absDir).filter(isLoadedCollectionFile).sort();\n\n    for (const file of files) {\n        try {\n            const mod = jitiInstance(path.join(absDir, file));\n            const exported = mod.default ?? mod;\n            if (exported && typeof exported === \"object\" && \"slug\" in exported) {\n                collections.push(exported as CollectionConfig);\n            } else {\n                failures.push(`${file}: no default export of a collection`);\n            }\n        } catch (err) {\n            failures.push(`${file}: ${(err as Error).message}`);\n        }\n    }\n\n    if (failures.length > 0) {\n        throw new Error(\n            `Could not load ${failures.length} collection file(s) from ${absDir}:\\n` +\n            failures.map(failure => `  • ${failure}`).join(\"\\n\") +\n            \"\\n\\nEvery collection file must import cleanly and default-export a collection — \" +\n            \"the backend refuses to boot on the same file.\"\n        );\n    }\n\n    return collections;\n}\n\n/**\n * Write generated files to the output directory.\n */\nfunction writeFiles(outputDir: string, files: GeneratedFile[]): void {\n    const absOutput = path.resolve(outputDir);\n\n    // Create output directory\n    fs.mkdirSync(absOutput, { recursive: true });\n\n    for (const file of files) {\n        const filePath = path.join(absOutput, file.path);\n        const dir = path.dirname(filePath);\n        if (!fs.existsSync(dir)) {\n            fs.mkdirSync(dir, { recursive: true });\n        }\n        fs.writeFileSync(filePath, file.content, \"utf-8\");\n    }\n}\n\nfunction printSdkHelp(): void {\n    console.log(`\n${chalk.bold(\"rebase generate-sdk\")} — generate a typed client from a project's schema\n\n${chalk.bold(\"Usage\")}\n  rebase generate-sdk [options]\n\n${chalk.bold(\"Options\")}\n  -c, --collections <dir>      ${COLLECTIONS_FLAG_HELP}\n                               (--collections-dir is accepted too)\n  -o, --output <dir>           Where to write the SDK (default: ./generated/sdk)\n                               (--out is accepted too, as on 'rebase build')\n      --from <link|url>        Fetch the schema from a running project instead of\n                               local source. \"link\" uses this checkout's linked project.\n      --token <token>          Bearer token for the contract endpoint\n                               (default: $REBASE_SERVICE_KEY)\n      --register               Also type server-side data: write the types and the\n                               Register declaration to config/generated/, and\n                               remember it in rebase.json so later runs keep it.\n  -h, --help                   Show this help\n\n${chalk.bold(\"Examples\")}\n  rebase generate-sdk                              From local collections\n  rebase generate-sdk --from link                  From the linked project\n  rebase generate-sdk --from https://api.acme.com  From any Rebase backend\n  rebase generate-sdk --register                   Type context.data and rebase.dataAsAdmin too\n`.trim());\n}\n\n/**\n * Fetch collections from a running project's contract endpoint.\n *\n * The payload replaces relation `target` functions with slug references, so it\n * has to be rehydrated before the generator sees it — the generator *calls*\n * `target()` to decide whether a foreign key is a string or a number, and a\n * missing target silently degrades that to a union rather than failing.\n */\nasync function fetchRemoteCollections(\n    baseUrl: string,\n    token: string | undefined\n): Promise<{ collections: CollectionConfig[]; schemaVersion: string }> {\n    const url = `${baseUrl.replace(/\\/+$/, \"\")}/api/meta/contract`;\n\n    const headers: Record<string, string> = { accept: \"application/json\" };\n    if (token) headers.authorization = `Bearer ${token}`;\n\n    let response: Response;\n    try {\n        response = await fetch(url, { headers });\n    } catch (err) {\n        console.log(chalk.red(`  ✗ Could not reach ${url}`));\n        console.log(chalk.gray(`    ${err instanceof Error ? err.message : String(err)}`));\n        process.exit(1);\n    }\n\n    if (response.status === 401 || response.status === 403) {\n        console.log(chalk.red(`  ✗ Not authorized to read the project contract (${response.status}).`));\n        console.log(chalk.gray(\"    The contract describes every table and relation, so it is admin-only.\"));\n        console.log(chalk.gray(\"    Pass --token, or set REBASE_SERVICE_KEY.\"));\n        process.exit(1);\n    }\n\n    if (response.status === 404) {\n        console.log(chalk.red(\"  ✗ This server has no contract endpoint.\"));\n        console.log(chalk.gray(\"    It needs to be running Rebase 0.11 or newer.\"));\n        process.exit(1);\n    }\n\n    if (!response.ok) {\n        console.log(chalk.red(`  ✗ Contract request failed with ${response.status}.`));\n        process.exit(1);\n    }\n\n    const contract = await response.json() as {\n        collections?: unknown[];\n        schemaVersion?: string;\n    };\n\n    if (!Array.isArray(contract.collections)) {\n        console.log(chalk.red(\"  ✗ The contract response did not contain collections.\"));\n        process.exit(1);\n    }\n\n    return {\n        collections: deserializeCollections(contract.collections),\n        schemaVersion: contract.schemaVersion ?? \"unknown\"\n    };\n}\n\n/**\n * Decide whether the ambient service key may be sent to this host.\n *\n * `REBASE_SERVICE_KEY` grants full admin bypass. Attaching it to whatever URL\n * happened to be passed — or, worse, to whatever a committed `.rebase/cloud.json`\n * points at — would hand the project's most powerful credential to a host nobody\n * vetted. An explicit `--token` is a decision the caller made; the ambient\n * variable is not, so it only travels to the project this checkout is linked to.\n */\nfunction mayUseAmbientKey(target: string, cwd: string): boolean {\n    const link = readLink(findProjectRoot(cwd) ?? cwd);\n    if (!link?.apiUrl) return false;\n    try {\n        // Origin, not host: with a link recorded as https, an `http://` target\n        // for the same host would otherwise pass and send the key in cleartext.\n        return new URL(link.apiUrl).origin === new URL(target).origin;\n    } catch {\n        return false;\n    }\n}\n\n/**\n * The base URL to show in the printed usage example.\n *\n * `rebase dev` binds a port derived from the project path, not 3001, and writes\n * the one it actually got to `.rebase/state.json`. Printing a hardcoded\n * `localhost:3001` sent people to a port nothing was listening on — or, with\n * several projects on one machine, to a different project's backend. Prefer the\n * port this project last ran on; fall back to the literal only when the project\n * has never been started.\n */\nexport function resolveExampleBaseUrl(cwd: string): string {\n    const projectRoot = findProjectRoot(cwd) ?? cwd;\n    try {\n        const state = JSON.parse(fs.readFileSync(path.join(projectRoot, \".rebase\", \"state.json\"), \"utf-8\"));\n        if (typeof state.baseUrl === \"string\" && state.baseUrl) return state.baseUrl;\n        if (typeof state.port === \"number\") return `http://localhost:${state.port}`;\n    } catch {\n        // Never started, or the file is unreadable — fall through.\n    }\n    return \"http://localhost:3001\";\n}\n\n/** Whether a slug can be written as `rebase.data.<slug>` rather than a lookup. */\nexport function isIdentifierLike(slug: string): boolean {\n    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(slug);\n}\n\n/** Resolve `--from` into a base URL, following the link file when asked. */\nfunction resolveSchemaSource(from: string, cwd: string): string {\n    if (from !== \"link\") {\n        // A bare hostname or a typo would otherwise be handed to `fetch` and fail\n        // with something unhelpful; a non-http scheme has no business here at all.\n        let parsed: URL;\n        try {\n            parsed = new URL(from);\n        } catch {\n            console.log(chalk.red(`  ✗ \"${from}\" is not a valid URL.`));\n            console.log(chalk.gray(\"    Pass a full URL, e.g. https://api.example.com, or \\\"link\\\".\"));\n            process.exit(1);\n        }\n        if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n            console.log(chalk.red(\"  ✗ The project URL must be http or https.\"));\n            process.exit(1);\n        }\n        return from;\n    }\n\n    const projectRoot = findProjectRoot(cwd) ?? cwd;\n    const link = readLink(projectRoot);\n\n    if (!link) {\n        console.log(chalk.red(\"  ✗ This checkout is not linked to a project.\"));\n        console.log(chalk.gray(\"    Run `rebase cloud link <url>`, or pass --from <url>.\"));\n        process.exit(1);\n    }\n\n    const apiUrl = link.apiUrl;\n    if (!apiUrl) {\n        console.log(chalk.red(\"  ✗ The project link has no API URL.\"));\n        console.log(chalk.gray(\"    Re-link with `rebase cloud link <url>` to record one.\"));\n        process.exit(1);\n    }\n\n    return apiUrl;\n}\n\n/**\n * Main entry point for the generate-sdk command.\n */\nexport async function generateSdkCommand(args: GenerateSDKArgs): Promise<void> {\n    const { collectionsDir, output, cwd } = args;\n\n    if (args.help) {\n        printSdkHelp();\n        return;\n    }\n\n    const resolvedCollectionsDir = path.isAbsolute(collectionsDir)\n        ? collectionsDir\n        : path.join(cwd, collectionsDir);\n\n    const resolvedOutput = path.isAbsolute(output)\n        ? output\n        : path.join(cwd, output);\n\n    console.log(\"\");\n    console.log(chalk.bold(\"  🔧 Rebase SDK Generator\"));\n    console.log(\"\");\n\n    let collections: CollectionConfig[];\n    let remoteSchemaVersion: string | undefined;\n\n    if (args.from) {\n        const baseUrl = resolveSchemaSource(args.from, cwd);\n        console.log(`  ${chalk.gray(\"Project:\")}     ${baseUrl}`);\n        console.log(`  ${chalk.gray(\"Output:\")}      ${resolvedOutput}`);\n        console.log(\"\");\n        console.log(chalk.cyan(\"  → Fetching the project contract...\"));\n\n        const ambient = mayUseAmbientKey(baseUrl, cwd)\n            ? process.env.REBASE_SERVICE_KEY\n            : undefined;\n\n        if (!args.token && !ambient && process.env.REBASE_SERVICE_KEY) {\n            console.log(chalk.dim(\n                \"  (not sending REBASE_SERVICE_KEY — this host is not the linked project; pass --token to override)\"\n            ));\n        }\n\n        const remote = await fetchRemoteCollections(baseUrl, args.token || ambient);\n        collections = remote.collections;\n        remoteSchemaVersion = remote.schemaVersion;\n    } else {\n        // A headless project has no collections directory by design: its API is\n        // introspected from the live database at boot, and there is nothing here\n        // to generate a client from. The scaffold ships `pnpm generate:sdk`\n        // anyway, so the documented headless path had a script that could only\n        // ever fail — and it failed with a path, which reads as a broken install\n        // rather than a question with an answer.\n        if (!fs.existsSync(resolvedCollectionsDir)) {\n            console.log(chalk.gray(\n                \"  ○ This project derives its API from the database — \"\n                + \"run `rebase schema introspect` first.\"\n            ));\n            console.log(chalk.gray(\n                `    Nothing to generate from: ${resolvedCollectionsDir} does not exist.`\n            ));\n            console.log(\"\");\n            return;\n        }\n        console.log(`  ${chalk.gray(\"Collections:\")} ${resolvedCollectionsDir}`);\n        console.log(`  ${chalk.gray(\"Output:\")}      ${resolvedOutput}`);\n        console.log(\"\");\n        console.log(chalk.cyan(\"  → Loading collection definitions...\"));\n        collections = await loadCollections(resolvedCollectionsDir);\n    }\n\n    // Sort collections alphabetically by slug to ensure deterministic SDK generation\n    collections.sort((a, b) => a.slug.localeCompare(b.slug));\n\n    if (collections.length === 0) {\n        console.log(chalk.red(\"  ✗ No collections found. Nothing to generate.\"));\n        process.exit(1);\n    }\n\n    console.log(chalk.green(`  ✓ Found ${collections.length} collection(s): ${collections.map(c => c.slug).join(\", \")}`));\n    console.log(\"\");\n\n    // 2. Generate SDK files\n    console.log(chalk.cyan(\"  → Generating SDK files...\"));\n    let files: GeneratedFile[];\n    try {\n        files = generateSDK(collections);\n    } catch (err) {\n        // A schema that cannot be expressed as valid TypeScript — two slugs\n        // that collide on one accessor, a slug with no usable name. The\n        // generator refuses rather than emitting a file that does not compile,\n        // or one that silently routes a collection's reads to another's table.\n        if (err instanceof CodegenError) {\n            console.log(\"\");\n            console.log(chalk.red(`  ✗ ${err.message}`));\n            process.exit(1);\n        }\n        throw err;\n    }\n\n    // Stamp the schema this SDK was built from.\n    //\n    // Without it, an app in a separate repository has no way to know its client\n    // is stale: the backend moves on, the frontend keeps compiling against types\n    // captured weeks ago, and the mismatch only surfaces as a runtime error. With\n    // it, CI can compare against `/api/meta/schema-version` and say so.\n    //\n    // No generation timestamp. Collections are sorted above precisely so that\n    // the same schema produces the same bytes; a timestamp put that back,\n    // turning every regeneration into a diff and making the obvious staleness\n    // gate — `rebase generate-sdk && git diff --exit-code` — impossible to pass.\n    // `SCHEMA_VERSION` already identifies what this was built from, and does it\n    // in a way that can be compared against a running project.\n    const schemaVersion = remoteSchemaVersion ?? computeSchemaVersion(collections);\n    files.push({\n        path: \"schema.meta.ts\",\n        content: `// Auto-generated by \\`rebase generate-sdk\\`. Do not edit.\n//\n// The schema version this SDK was generated from. Compare it against the\n// project's current version to detect drift:\n//\n//     curl -s <api-url>/api/meta/schema-version\n//\n// Pass it to the client as \\`schemaVersion\\` and every request carries it in\n// the \\`x-rebase-schema\\` header, so the server can name the drift instead of\n// answering a renamed field with a bare 400.\nexport const SCHEMA_VERSION = ${JSON.stringify(schemaVersion)};\n`\n    });\n\n    console.log(chalk.green(`  ✓ Generated ${files.length} file(s)`));\n    console.log(chalk.gray(`    schema ${schemaVersion}`));\n\n    // 3. Write to disk\n    console.log(chalk.cyan(`  → Writing to ${resolvedOutput}...`));\n    writeFiles(resolvedOutput, files);\n\n    // 4. The server-side registration: on request, and kept current once a\n    // project has it, so `rebase dev` regenerating the SDK never leaves the\n    // server typed against an older schema than the client.\n    const registerDir = registrationDir(resolvedCollectionsDir);\n    const projectRoot = args.projectRoot ?? findProjectRoot(cwd) ?? undefined;\n    if (args.register || hasRegistration(registerDir) || manifestRegisters(projectRoot)) {\n        if (!fs.existsSync(path.dirname(registerDir))) {\n            console.log(chalk.red(`  ✗ No ${path.dirname(registerDir)} to register the Database in.`));\n            console.log(chalk.gray(\"    --register writes beside the collections directory; pass --collections.\"));\n            process.exit(1);\n            return;\n        }\n        const databaseTypes = files.find((file) => file.path === \"database.types.ts\")?.content;\n        if (databaseTypes !== undefined) {\n            try {\n                writeRegistration(registerDir, databaseTypes);\n            } catch (error) {\n                console.log(chalk.red(`  ✗ ${error instanceof Error ? error.message : String(error)}`));\n                process.exit(1);\n                return;\n            }\n            console.log(chalk.green(`  ✓ Registered the Database for server-side code in ${registerDir}`));\n            if (args.register) {\n                const remembered = rememberRegistration(projectRoot);\n                if (\"written\" in remembered) {\n                    console.log(chalk.gray(`    Remembered in ${path.relative(cwd, remembered.written) || \"rebase.json\"} (registerDatabase).`));\n                } else {\n                    console.log(chalk.yellow(`    ${remembered.skipped}`));\n                }\n            }\n        }\n    }\n\n    console.log(\"\");\n    console.log(chalk.green.bold(\"  ✓ SDK generated successfully!\"));\n    console.log(\"\");\n    const typesImport = `./${path.relative(cwd, path.join(resolvedOutput, \"database.types\"))}`;\n    const metaImport = `./${path.relative(cwd, path.join(resolvedOutput, \"schema.meta\"))}`;\n    const exampleSlug = collections[0]?.slug || \"my_collection\";\n\n    console.log(chalk.gray(\"  Usage:\"));\n    console.log(chalk.gray(\"    import { createRebaseClient } from '@rebasepro/client';\"));\n    console.log(chalk.gray(`    import { collectionsDictionary, type Database } from '${typesImport}';`));\n    console.log(chalk.gray(`    import { SCHEMA_VERSION } from '${metaImport}';`));\n    console.log(\"\");\n    console.log(chalk.gray(\"    const rebase = createRebaseClient<Database>({\"));\n    console.log(chalk.gray(`        baseUrl: '${resolveExampleBaseUrl(cwd)}',`));\n    // Sent as `x-rebase-schema` on every request. Costs one line here and is\n    // the difference between a server that can say \"this client is three\n    // deploys behind\" and one that can only reject a field it does not know.\n    console.log(chalk.gray(\"        schemaVersion: SCHEMA_VERSION,\"));\n    // Without the dictionary a hyphenated slug is not resolvable from the\n    // property name alone, and the request 404s at runtime.\n    console.log(chalk.gray(\"        collections: collectionsDictionary,\"));\n    console.log(chalk.gray(\"        // token: 'your-jwt-token',\"));\n    console.log(chalk.gray(\"    });\"));\n    console.log(\"\");\n    // `rebase.data.<accessor>` is the typed surface, so it is what gets printed.\n    // `rebase.data.collection(slug)` exists too, but it is generic over\n    // `Record<string, unknown>` and has no link to `Database` — it was the\n    // headline example here for a while, which advertised the one call shape\n    // that throws away the types this command just generated.\n    const exampleAccessor = toCollectionAccessor(exampleSlug);\n    const exampleAccess = isIdentifierLike(exampleAccessor)\n        ? `rebase.data.${exampleAccessor}`\n        : `rebase.data[${JSON.stringify(exampleAccessor)}]`;\n    console.log(chalk.gray(`    const { data } = await ${exampleAccess}.find();`));\n    console.log(\"\");\n}\n"],"mappings":"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"}