@rebasepro/cli 0.6.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/README.md +0 -1
  2. package/dist/commands/api-keys.d.ts +1 -0
  3. package/dist/commands/generate_sdk.d.ts +1 -1
  4. package/dist/commands/init.d.ts +13 -0
  5. package/dist/index.es.js +463 -105
  6. package/dist/index.es.js.map +1 -1
  7. package/package.json +22 -18
  8. package/templates/template/backend/package.json +0 -1
  9. package/templates/template/backend/src/index.ts +1 -1
  10. package/templates/template/config/collections/posts.ts +1 -3
  11. package/templates/template/config/collections/tags.ts +1 -3
  12. package/templates/template/config/collections/users.ts +1 -4
  13. package/templates/template/package.json +0 -1
  14. package/templates/template/scripts/example.ts +4 -1
  15. package/dist/index.cjs +0 -1948
  16. package/dist/index.cjs.map +0 -1
  17. package/skills/rebase-api/SKILL.md +0 -662
  18. package/skills/rebase-api/references/.gitkeep +0 -3
  19. package/skills/rebase-auth/SKILL.md +0 -1143
  20. package/skills/rebase-auth/references/.gitkeep +0 -3
  21. package/skills/rebase-backend-postgres/SKILL.md +0 -633
  22. package/skills/rebase-backend-postgres/references/.gitkeep +0 -3
  23. package/skills/rebase-basics/SKILL.md +0 -749
  24. package/skills/rebase-basics/references/.gitkeep +0 -3
  25. package/skills/rebase-collections/SKILL.md +0 -1328
  26. package/skills/rebase-collections/references/.gitkeep +0 -3
  27. package/skills/rebase-cron-jobs/SKILL.md +0 -699
  28. package/skills/rebase-cron-jobs/references/.gitkeep +0 -1
  29. package/skills/rebase-custom-functions/SKILL.md +0 -233
  30. package/skills/rebase-deployment/SKILL.md +0 -583
  31. package/skills/rebase-deployment/references/.gitkeep +0 -3
  32. package/skills/rebase-design-language/SKILL.md +0 -664
  33. package/skills/rebase-email/SKILL.md +0 -701
  34. package/skills/rebase-email/references/.gitkeep +0 -1
  35. package/skills/rebase-entity-history/SKILL.md +0 -485
  36. package/skills/rebase-entity-history/references/.gitkeep +0 -1
  37. package/skills/rebase-local-env-setup/SKILL.md +0 -189
  38. package/skills/rebase-local-env-setup/references/.gitkeep +0 -3
  39. package/skills/rebase-realtime/SKILL.md +0 -755
  40. package/skills/rebase-realtime/references/.gitkeep +0 -3
  41. package/skills/rebase-sdk/SKILL.md +0 -594
  42. package/skills/rebase-sdk/references/.gitkeep +0 -0
  43. package/skills/rebase-storage/SKILL.md +0 -765
  44. package/skills/rebase-storage/references/.gitkeep +0 -3
  45. package/skills/rebase-studio/SKILL.md +0 -746
  46. package/skills/rebase-studio/references/.gitkeep +0 -3
  47. package/skills/rebase-ui-components/SKILL.md +0 -1411
  48. package/skills/rebase-ui-components/references/.gitkeep +0 -3
  49. package/skills/rebase-webhooks/SKILL.md +0 -623
  50. package/skills/rebase-webhooks/references/.gitkeep +0 -1
  51. package/templates/template/backend/drizzle.config.ts +0 -51
package/dist/index.cjs DELETED
@@ -1,1948 +0,0 @@
1
- (function(global, factory) {
2
- typeof exports === "object" && typeof module !== "undefined" ? factory(exports, require("chalk"), require("arg"), require("inquirer"), require("path"), require("fs"), require("net"), require("util"), require("execa"), require("fs/promises"), require("url"), require("crypto"), require("@rebasepro/sdk-generator"), require("child_process")) : typeof define === "function" && define.amd ? define([
3
- "exports",
4
- "chalk",
5
- "arg",
6
- "inquirer",
7
- "path",
8
- "fs",
9
- "net",
10
- "util",
11
- "execa",
12
- "fs/promises",
13
- "url",
14
- "crypto",
15
- "@rebasepro/sdk-generator",
16
- "child_process"
17
- ], factory) : (global = typeof globalThis !== "undefined" ? globalThis : global || self, factory(global["Rebase CLI"] = {}, global.chalk, global.arg, global.inquirer, global.path, global.fs, global.net, global.util, global.execa, global.fs_promises, global.url, global.crypto, global._rebasepro_sdk_generator, global.child_process));
18
- })(this, function(exports, chalk, arg, inquirer, path, fs, net, util, execa, fs_promises, url, crypto, _rebasepro_sdk_generator, child_process) {
19
- Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
20
- //#region \0rolldown/runtime.js
21
- var __create = Object.create;
22
- var __defProp = Object.defineProperty;
23
- var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
24
- var __getOwnPropNames = Object.getOwnPropertyNames;
25
- var __getProtoOf = Object.getPrototypeOf;
26
- var __hasOwnProp = Object.prototype.hasOwnProperty;
27
- var __copyProps = (to, from, except, desc) => {
28
- if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
29
- key = keys[i];
30
- if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
31
- get: ((k) => from[k]).bind(null, key),
32
- enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
33
- });
34
- }
35
- return to;
36
- };
37
- var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
38
- value: mod,
39
- enumerable: true
40
- }) : target, mod));
41
- //#endregion
42
- chalk = __toESM(chalk, 1);
43
- arg = __toESM(arg, 1);
44
- inquirer = __toESM(inquirer, 1);
45
- path = __toESM(path, 1);
46
- fs = __toESM(fs, 1);
47
- net = __toESM(net, 1);
48
- crypto = __toESM(crypto, 1);
49
- //#region src/utils/package-manager.ts
50
- /**
51
- * Package manager detection and command abstraction.
52
- *
53
- * Detects whether the user is running pnpm or npm and provides
54
- * a unified interface for common package-manager operations so
55
- * the rest of the CLI never has to hardcode a specific PM.
56
- */
57
- /**
58
- * Detect the package manager from the environment or the target directory.
59
- *
60
- * Detection order:
61
- * 1. Explicit override (if provided)
62
- * 2. `npm_config_user_agent` env var (set by npm/pnpm when running via `npx`/`pnpm dlx`)
63
- * 3. Lock-file presence in the target directory
64
- * 4. Default to pnpm (Rebase's recommended PM)
65
- */
66
- function detectPackageManager(targetDir) {
67
- const userAgent = process.env.npm_config_user_agent ?? "";
68
- if (userAgent.startsWith("npm/")) return "npm";
69
- if (userAgent.startsWith("pnpm/")) return "pnpm";
70
- if (targetDir) {
71
- if (fs.default.existsSync(path.default.join(targetDir, "package-lock.json"))) return "npm";
72
- if (fs.default.existsSync(path.default.join(targetDir, "pnpm-lock.yaml"))) return "pnpm";
73
- }
74
- const cwd = process.cwd();
75
- if (cwd !== targetDir) {
76
- if (fs.default.existsSync(path.default.join(cwd, "package-lock.json"))) return "npm";
77
- if (fs.default.existsSync(path.default.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
78
- }
79
- return "pnpm";
80
- }
81
- /** Build the command helpers for a given package manager. */
82
- function getPMCommands(pm) {
83
- if (pm === "npm") return {
84
- name: "npm",
85
- install: ["npm", "install"],
86
- run: (script) => [
87
- "npm",
88
- "run",
89
- script
90
- ],
91
- exec: (bin, args) => [
92
- "npx",
93
- bin,
94
- ...args
95
- ],
96
- view: (pkg, field) => [
97
- "npm",
98
- "view",
99
- pkg,
100
- field
101
- ],
102
- runAll: (script) => [
103
- "npm",
104
- "run",
105
- script,
106
- "--workspaces",
107
- "--if-present"
108
- ],
109
- runWorkspace: (workspace, script) => [
110
- "npm",
111
- "run",
112
- script,
113
- "-w",
114
- workspace
115
- ],
116
- dlx: (pkg, args) => [
117
- "npx",
118
- "-y",
119
- pkg,
120
- ...args
121
- ],
122
- workspaceProtocol: "*"
123
- };
124
- return {
125
- name: "pnpm",
126
- install: ["pnpm", "install"],
127
- run: (script) => [
128
- "pnpm",
129
- "run",
130
- script
131
- ],
132
- exec: (bin, args) => [
133
- "pnpm",
134
- "exec",
135
- bin,
136
- ...args
137
- ],
138
- view: (pkg, field) => [
139
- "pnpm",
140
- "view",
141
- pkg,
142
- field
143
- ],
144
- runAll: (script) => [
145
- "pnpm",
146
- "-r",
147
- "run",
148
- script
149
- ],
150
- runWorkspace: (workspace, script) => [
151
- "pnpm",
152
- "--filter",
153
- workspace,
154
- script
155
- ],
156
- dlx: (pkg, args) => [
157
- "pnpm",
158
- "dlx",
159
- pkg,
160
- ...args
161
- ],
162
- workspaceProtocol: "workspace:*"
163
- };
164
- }
165
- //#endregion
166
- //#region src/commands/init.ts
167
- var access = (0, util.promisify)(fs.default.access);
168
- var __filename$2 = (0, url.fileURLToPath)({}.url);
169
- var __dirname$2 = path.default.dirname(__filename$2);
170
- function findParentDir$1(currentDir, targetName) {
171
- const root = path.default.parse(currentDir).root;
172
- while (currentDir && currentDir !== root) {
173
- if (path.default.basename(currentDir) === targetName) return currentDir;
174
- currentDir = path.default.dirname(currentDir);
175
- }
176
- return null;
177
- }
178
- var cliRoot = findParentDir$1(__dirname$2, "cli");
179
- var PRESET_CHOICES = [
180
- {
181
- name: "Blog — Posts, Authors, Tags (with markdown editor)",
182
- value: "blog",
183
- short: "Blog"
184
- },
185
- {
186
- name: "E-commerce — Products, Categories, Orders",
187
- value: "ecommerce",
188
- short: "E-commerce"
189
- },
190
- {
191
- name: "Blank — Empty project, just authentication",
192
- value: "blank",
193
- short: "Blank"
194
- }
195
- ];
196
- async function createRebaseApp(rawArgs) {
197
- console.log(`
198
- ${chalk.default.bold("Rebase")} — Create a new project 🚀
199
- `);
200
- await createProject(await promptForOptions(rawArgs, detectPackageManager()));
201
- }
202
- async function promptForOptions(rawArgs, pm) {
203
- const args = (0, arg.default)({
204
- "--git": Boolean,
205
- "--install": Boolean,
206
- "--database-url": String,
207
- "--introspect": Boolean,
208
- "--template": String,
209
- "--yes": Boolean,
210
- "-g": "--git",
211
- "-i": "--install",
212
- "-t": "--template",
213
- "-y": "--yes"
214
- }, {
215
- argv: rawArgs.slice(3),
216
- permissive: true
217
- });
218
- const nameArg = args._[0];
219
- const isNonInteractive = args["--yes"] || false;
220
- const templateArg = args["--template"];
221
- if (templateArg && !PRESET_CHOICES.some((p) => p.value === templateArg)) {
222
- console.error(chalk.default.red(`Unknown template "${templateArg}". Available: ${PRESET_CHOICES.map((p) => p.value).join(", ")}`));
223
- process.exit(1);
224
- }
225
- if (isNonInteractive) {
226
- const projectName = nameArg || "my-rebase-app";
227
- const targetDirectory = path.default.resolve(process.cwd(), projectName);
228
- const templateDirectory = path.default.resolve(cliRoot, "templates", "template");
229
- const pmCommands = getPMCommands(pm);
230
- return {
231
- projectName: path.default.basename(targetDirectory),
232
- git: args["--git"] ?? false,
233
- installDeps: args["--install"] ?? false,
234
- targetDirectory,
235
- templateDirectory,
236
- databaseUrl: args["--database-url"] || void 0,
237
- introspect: args["--introspect"] || false,
238
- preset: templateArg || "blog",
239
- pm,
240
- pmCommands
241
- };
242
- }
243
- const questions = [];
244
- if (!nameArg) questions.push({
245
- type: "input",
246
- name: "projectName",
247
- message: "Project name:",
248
- default: "my-rebase-app",
249
- validate: (input) => {
250
- if (!input.trim()) return "Project name is required";
251
- if (!/^[a-z0-9][a-z0-9._-]*$/.test(input)) return "Project name must start with a lowercase letter or number and contain only lowercase letters, numbers, hyphens, dots, or underscores";
252
- return true;
253
- }
254
- });
255
- if (!templateArg) questions.push({
256
- type: "list",
257
- name: "preset",
258
- message: "Choose a starter template:",
259
- choices: PRESET_CHOICES,
260
- default: "blog"
261
- });
262
- if (!args["--git"]) questions.push({
263
- type: "confirm",
264
- name: "git",
265
- message: "Initialize a git repository?",
266
- default: true
267
- });
268
- if (!args["--install"]) questions.push({
269
- type: "confirm",
270
- name: "installDeps",
271
- message: `Install dependencies with ${pm}?`,
272
- default: true
273
- });
274
- questions.push({
275
- type: "input",
276
- name: "databaseUrl",
277
- message: "Enter your PostgreSQL database connection string (leave blank to use a local default):",
278
- default: "",
279
- validate: (input) => {
280
- if (input.trim() && /[\r\n]/.test(input)) return "Database URL cannot contain newline characters.";
281
- return true;
282
- }
283
- });
284
- questions.push({
285
- type: "confirm",
286
- name: "introspect",
287
- message: "Would you like to introspect this database to automatically generate collections?",
288
- default: true,
289
- when: (answers) => !!answers.databaseUrl?.trim()
290
- });
291
- const answers = await inquirer.default.prompt(questions);
292
- const targetDirectory = path.default.resolve(process.cwd(), nameArg || answers.projectName);
293
- const projectName = path.default.basename(targetDirectory);
294
- const templateDirectory = path.default.resolve(cliRoot, "templates", "template");
295
- const pmCommands = getPMCommands(pm);
296
- return {
297
- projectName,
298
- git: args["--git"] || answers.git || false,
299
- installDeps: args["--install"] || answers.installDeps || false,
300
- targetDirectory,
301
- templateDirectory,
302
- databaseUrl: answers.databaseUrl?.trim() || void 0,
303
- introspect: answers.introspect || false,
304
- preset: templateArg || answers.preset || "blog",
305
- pm,
306
- pmCommands
307
- };
308
- }
309
- async function createProject(options) {
310
- if (fs.default.existsSync(options.targetDirectory)) {
311
- if (fs.default.readdirSync(options.targetDirectory).length !== 0) {
312
- console.error(`${chalk.default.red.bold("ERROR")} Directory "${options.projectName}" already exists and is not empty`);
313
- process.exit(1);
314
- }
315
- } else fs.default.mkdirSync(options.targetDirectory, { recursive: true });
316
- try {
317
- await access(options.templateDirectory, fs.default.constants.R_OK);
318
- } catch {
319
- console.error(`${chalk.default.red.bold("ERROR")} Template not found at ${options.templateDirectory}`);
320
- process.exit(1);
321
- }
322
- console.log(chalk.default.gray(" Copying project files..."));
323
- try {
324
- await (0, fs_promises.cp)(options.templateDirectory, options.targetDirectory, {
325
- recursive: true,
326
- filter: (source) => {
327
- const basename = path.default.basename(source);
328
- return basename !== "node_modules" && basename !== ".DS_Store";
329
- }
330
- });
331
- } catch (err) {
332
- console.error(`${chalk.default.red.bold("ERROR")} Failed to copy template files: ${err instanceof Error ? err.message : String(err)}`);
333
- process.exit(1);
334
- }
335
- await applyPreset(options.targetDirectory, options.preset);
336
- await replacePlaceholders(options);
337
- await configureEnvFile(options.targetDirectory, options.databaseUrl);
338
- if (options.git) {
339
- console.log(chalk.default.gray(" Initializing git repository..."));
340
- try {
341
- await (0, execa.execa)("git", ["init"], { cwd: options.targetDirectory });
342
- } catch {
343
- console.warn(chalk.default.yellow(" Warning: Failed to initialize git repository"));
344
- }
345
- }
346
- const { pm, pmCommands } = options;
347
- const installCmd = pmCommands.install;
348
- const execCmd = pmCommands.exec("rebase", [
349
- "schema",
350
- "introspect",
351
- "--force"
352
- ]);
353
- if (options.installDeps) {
354
- console.log("");
355
- console.log(chalk.default.gray(` Installing dependencies with ${pm}...`));
356
- console.log("");
357
- try {
358
- await (0, execa.execa)(installCmd[0], installCmd.slice(1), {
359
- cwd: options.targetDirectory,
360
- stdio: "inherit"
361
- });
362
- } catch {
363
- console.warn(chalk.default.yellow(` Warning: Failed to install dependencies. You may need to run \`${installCmd.join(" ")}\` manually.`));
364
- }
365
- }
366
- if (options.introspect) {
367
- console.log("");
368
- if (options.installDeps) {
369
- console.log(chalk.default.gray(" Introspecting database and generating collections..."));
370
- console.log("");
371
- try {
372
- await (0, execa.execa)(execCmd[0], execCmd.slice(1), {
373
- cwd: options.targetDirectory,
374
- stdio: "inherit"
375
- });
376
- console.log(chalk.default.green(" Database successfully introspected!"));
377
- } catch {
378
- console.warn(chalk.default.yellow(" Warning: Failed to introspect database automatically."));
379
- console.warn(chalk.default.yellow(` You can run \`${execCmd.join(" ")}\` manually after setup.`));
380
- }
381
- } else {
382
- console.warn(chalk.default.yellow(" Skipping introspection because dependencies were not installed."));
383
- console.warn(chalk.default.yellow(` Run \`${installCmd.join(" ")}\` then \`${execCmd.join(" ")}\` manually.`));
384
- }
385
- }
386
- console.log("");
387
- console.log(`${chalk.default.green.bold("✓")} Project ${chalk.default.bold(options.projectName)} created successfully!`);
388
- console.log("");
389
- console.log(chalk.default.bold("Next steps:"));
390
- console.log("");
391
- const runDev = pmCommands.run("dev");
392
- const runDbPush = pmCommands.run("db:push");
393
- console.log(` ${chalk.default.cyan("cd")} ${options.projectName}`);
394
- if (!options.installDeps) console.log(` ${chalk.default.cyan(installCmd.join(" "))}`);
395
- console.log("");
396
- if (options.databaseUrl) if (options.introspect) {
397
- console.log(chalk.default.gray(" # Database has been introspected & collections generated!"));
398
- console.log(chalk.default.gray(" # Start the development server (frontend + backend):"));
399
- console.log(` ${chalk.default.cyan(runDev.join(" "))}`);
400
- } else {
401
- console.log(chalk.default.gray(" # Your custom database is configured in .env."));
402
- console.log(chalk.default.gray(" # If the database is empty, push the Rebase schema to initialize it:"));
403
- console.log(` ${chalk.default.cyan(runDbPush.join(" "))}`);
404
- console.log("");
405
- console.log(chalk.default.gray(" # Then start the development server:"));
406
- console.log(` ${chalk.default.cyan(runDev.join(" "))}`);
407
- }
408
- else {
409
- console.log(chalk.default.gray(" # A local database configuration has been generated in .env."));
410
- console.log(chalk.default.gray(" # 1. Start the PostgreSQL database container:"));
411
- console.log(` ${chalk.default.cyan("docker compose up -d db")}`);
412
- console.log("");
413
- console.log(chalk.default.gray(" # 2. Push the Rebase schema to initialize database tables:"));
414
- console.log(` ${chalk.default.cyan(runDbPush.join(" "))}`);
415
- console.log("");
416
- console.log(chalk.default.gray(" # 3. Start the development server (frontend + backend):"));
417
- console.log(` ${chalk.default.cyan(runDev.join(" "))}`);
418
- }
419
- console.log("");
420
- console.log(chalk.default.gray("This starts both the backend (Hono + PostgreSQL)") + chalk.default.gray(" and the frontend (Vite + React) concurrently."));
421
- console.log("");
422
- console.log(chalk.default.gray("Docs: https://rebase.pro/docs"));
423
- console.log(chalk.default.gray("GitHub: https://github.com/rebasepro/rebase"));
424
- console.log("");
425
- console.log(chalk.default.bold("🤖 AI Agent Skills"));
426
- console.log("");
427
- console.log(chalk.default.gray(" Install Rebase agent skills for your AI coding assistant:"));
428
- console.log("");
429
- console.log(` ${chalk.default.cyan("rebase skills install")} ${chalk.default.gray("or")} ${chalk.default.cyan(pmCommands.run("skills:install").join(" "))}`);
430
- console.log("");
431
- }
432
- /**
433
- * Apply a template preset by replacing the default collection files.
434
- *
435
- * The template ships with blog collections at the top level and
436
- * preset alternatives under `config/collections/presets/<name>/`.
437
- * This function swaps the active collection files and removes the
438
- * presets directory so the final project is clean.
439
- */
440
- async function applyPreset(targetDirectory, preset) {
441
- const collectionsDir = path.default.join(targetDirectory, "config", "collections");
442
- const presetsDir = path.default.join(collectionsDir, "presets");
443
- if (preset !== "blog") {
444
- const presetDir = path.default.join(presetsDir, preset);
445
- if (!fs.default.existsSync(presetDir)) {
446
- console.warn(chalk.default.yellow(` Warning: Preset "${preset}" not found, falling back to blog template.`));
447
- cleanupPresets(presetsDir);
448
- return;
449
- }
450
- for (const file of [
451
- "posts.ts",
452
- "authors.ts",
453
- "tags.ts",
454
- "index.ts"
455
- ]) {
456
- const filePath = path.default.join(collectionsDir, file);
457
- if (fs.default.existsSync(filePath)) fs.default.unlinkSync(filePath);
458
- }
459
- const presetFiles = fs.default.readdirSync(presetDir).filter((f) => f.endsWith(".ts"));
460
- for (const file of presetFiles) fs.default.copyFileSync(path.default.join(presetDir, file), path.default.join(collectionsDir, file));
461
- }
462
- cleanupPresets(presetsDir);
463
- }
464
- function cleanupPresets(presetsDir) {
465
- if (fs.default.existsSync(presetsDir)) fs.default.rmSync(presetsDir, {
466
- recursive: true,
467
- force: true
468
- });
469
- }
470
- async function replacePlaceholders(options) {
471
- const filesToProcess = [
472
- "package.json",
473
- "frontend/package.json",
474
- "backend/package.json",
475
- "config/package.json",
476
- "frontend/index.html",
477
- "pnpm-workspace.yaml",
478
- "README.md"
479
- ];
480
- const packageJsonPath = path.default.resolve(cliRoot, "package.json");
481
- let cliVersion = "latest";
482
- if (fs.default.existsSync(packageJsonPath)) cliVersion = JSON.parse(fs.default.readFileSync(packageJsonPath, "utf-8")).version || "latest";
483
- const versionCache = /* @__PURE__ */ new Map();
484
- const viewBin = "npm";
485
- const getPackageVersion = async (pkgName) => {
486
- if (versionCache.has(pkgName)) return versionCache.get(pkgName);
487
- if (process.env.REBASE_E2E === "true") {
488
- versionCache.set(pkgName, cliVersion);
489
- return cliVersion;
490
- }
491
- let versionToUse = cliVersion;
492
- try {
493
- const { stdout } = await (0, execa.execa)(viewBin, [
494
- "view",
495
- `${pkgName}@${cliVersion}`,
496
- "version"
497
- ]);
498
- if (!stdout.trim()) throw new Error("Not found");
499
- versionToUse = stdout.trim();
500
- } catch {
501
- try {
502
- const { stdout } = await (0, execa.execa)(viewBin, [
503
- "view",
504
- `${pkgName}@${cliVersion.includes("canary") ? "canary" : "latest"}`,
505
- "version"
506
- ]);
507
- if (!stdout.trim()) throw new Error("Not found");
508
- versionToUse = stdout.trim();
509
- } catch {
510
- try {
511
- const { stdout } = await (0, execa.execa)(viewBin, [
512
- "view",
513
- pkgName,
514
- "version"
515
- ]);
516
- versionToUse = stdout.trim() || "latest";
517
- } catch {
518
- versionToUse = "latest";
519
- }
520
- }
521
- }
522
- versionCache.set(pkgName, versionToUse);
523
- return versionToUse;
524
- };
525
- const allPackages = /* @__PURE__ */ new Set();
526
- const fileContents = /* @__PURE__ */ new Map();
527
- for (const file of filesToProcess) {
528
- const fullPath = path.default.resolve(options.targetDirectory, file);
529
- if (!fs.default.existsSync(fullPath)) continue;
530
- const content = fs.default.readFileSync(fullPath, "utf-8");
531
- fileContents.set(fullPath, content);
532
- const matches = [...content.matchAll(/"(@rebasepro\/[^"]+)":\s*"workspace:\*"/g)];
533
- for (const match of matches) allPackages.add(match[1]);
534
- }
535
- console.log(chalk.default.gray(" Resolving package versions..."));
536
- await Promise.all(Array.from(allPackages).map(getPackageVersion));
537
- for (const [fullPath, originalContent] of fileContents.entries()) {
538
- let content = originalContent.replace(/\{\{PROJECT_NAME\}\}/g, options.projectName);
539
- const matches = [...content.matchAll(/"(@rebasepro\/[^"]+)":\s*"workspace:\*"/g)];
540
- for (const match of matches) {
541
- const pkgName = match[1];
542
- const resolvedVersion = versionCache.get(pkgName) || "latest";
543
- content = content.replace(new RegExp(`"${pkgName}":\\s*"workspace:\\*"`, "g"), `"${pkgName}": "${resolvedVersion}"`);
544
- }
545
- fs.default.writeFileSync(fullPath, content, "utf-8");
546
- }
547
- }
548
- async function isPortAvailable(port) {
549
- return new Promise((resolve) => {
550
- const server = net.default.createServer();
551
- server.once("error", () => {
552
- resolve(false);
553
- });
554
- server.once("listening", () => {
555
- server.close(() => resolve(true));
556
- });
557
- server.listen(port);
558
- });
559
- }
560
- async function findAvailablePort(startPort) {
561
- let port = startPort;
562
- while (!await isPortAvailable(port)) port++;
563
- return port;
564
- }
565
- async function configureEnvFile(targetDirectory, databaseUrl) {
566
- const envExamplePath = path.default.join(targetDirectory, ".env.example");
567
- const envPath = path.default.join(targetDirectory, ".env");
568
- if (fs.default.existsSync(envExamplePath) && !fs.default.existsSync(envPath)) {
569
- fs.default.copyFileSync(envExamplePath, envPath);
570
- const jwtSecret = crypto.default.randomBytes(32).toString("hex");
571
- const dbPassword = crypto.default.randomBytes(16).toString("hex");
572
- let envContent = fs.default.readFileSync(envPath, "utf-8");
573
- envContent = envContent.replace(/^JWT_SECRET=.*$/m, `JWT_SECRET=${jwtSecret}`);
574
- if (databaseUrl) {
575
- if (/[\r\n]/.test(databaseUrl)) throw new Error("Invalid DATABASE_URL: multiline values are not allowed.");
576
- envContent = envContent.replace(/^DATABASE_URL=.*$/m, `DATABASE_URL=${databaseUrl}`);
577
- } else {
578
- const dbPort = await findAvailablePort(5432);
579
- envContent = envContent.replace(/^DATABASE_URL=.*$/m, `DATABASE_URL=postgresql://rebase:${dbPassword}@localhost:${dbPort}/rebase?options=-c%20search_path=public\nDATABASE_PASSWORD=${dbPassword}`);
580
- const dockerComposePath = path.default.join(targetDirectory, "docker-compose.yml");
581
- if (fs.default.existsSync(dockerComposePath)) {
582
- let dockerComposeContent = fs.default.readFileSync(dockerComposePath, "utf-8");
583
- dockerComposeContent = dockerComposeContent.replace(/-\s*"5432:5432"/g, `- "${dbPort}:5432"`);
584
- fs.default.writeFileSync(dockerComposePath, dockerComposeContent, "utf-8");
585
- }
586
- }
587
- fs.default.writeFileSync(envPath, envContent, "utf-8");
588
- }
589
- }
590
- //#endregion
591
- //#region src/commands/generate_sdk.ts
592
- /**
593
- * CLI command: generate-sdk
594
- *
595
- * Reads collection definitions from a specified directory (default: ./config/collections),
596
- * generates a typed JS SDK, and writes it to the output directory (default: ./generated/sdk).
597
- *
598
- * Uses jiti for dynamic TypeScript import of collection files.
599
- */
600
- /**
601
- * Dynamically load collection definitions from a directory.
602
- *
603
- * Expects the directory to have an index.ts/index.js that exports a default
604
- * array of EntityCollection objects (matching the app/config/collections pattern).
605
- */
606
- async function loadCollections(collectionsDir) {
607
- const absDir = path.default.resolve(collectionsDir);
608
- if (!fs.default.existsSync(absDir)) throw new Error(`Collections directory not found: ${absDir}`);
609
- let jiti;
610
- try {
611
- const jitiModule = await import("jiti");
612
- jiti = jitiModule.default || jitiModule;
613
- } catch {
614
- const installCmd = [
615
- ...getPMCommands(detectPackageManager()).install,
616
- "-D",
617
- "jiti"
618
- ].join(" ");
619
- throw new Error(`Could not load 'jiti'. Install it with: ${installCmd}\njiti is required to dynamically import TypeScript collection definitions.`);
620
- }
621
- const jitiInstance = jiti(absDir, {
622
- interopDefault: true,
623
- esmResolve: true
624
- });
625
- const indexCandidates = [
626
- "index.ts",
627
- "index.js",
628
- "index.mjs"
629
- ];
630
- let indexPath = null;
631
- for (const candidate of indexCandidates) {
632
- const p = path.default.join(absDir, candidate);
633
- if (fs.default.existsSync(p)) {
634
- indexPath = p;
635
- break;
636
- }
637
- }
638
- if (!indexPath) {
639
- console.log(chalk.default.yellow(" No index file found, scanning individual collection files..."));
640
- const collections = [];
641
- const files = fs.default.readdirSync(absDir).filter((f) => (f.endsWith(".ts") || f.endsWith(".js")) && !f.startsWith("."));
642
- for (const file of files) try {
643
- const mod = jitiInstance(path.default.join(absDir, file));
644
- const exported = mod.default || mod;
645
- if (exported && typeof exported === "object" && "slug" in exported) collections.push(exported);
646
- else if (Array.isArray(exported)) collections.push(...exported);
647
- } catch (err) {
648
- console.warn(chalk.default.yellow(` ⚠ Skipping ${file}: ${err.message}`));
649
- }
650
- return collections;
651
- }
652
- const mod = jitiInstance(indexPath);
653
- const exported = mod.default || mod;
654
- if (Array.isArray(exported)) return exported;
655
- else if (typeof exported === "object" && exported !== null) {
656
- if ("collections" in exported && Array.isArray(exported.collections)) return exported.collections;
657
- const collections = [];
658
- for (const value of Object.values(exported)) if (value && typeof value === "object" && "slug" in value) collections.push(value);
659
- if (collections.length > 0) return collections;
660
- }
661
- throw new Error(`Could not extract collections from ${indexPath}.\nExpected a default export of EntityCollection[] or an object with named collection exports.`);
662
- }
663
- /**
664
- * Write generated files to the output directory.
665
- */
666
- function writeFiles(outputDir, files) {
667
- const absOutput = path.default.resolve(outputDir);
668
- fs.default.mkdirSync(absOutput, { recursive: true });
669
- for (const file of files) {
670
- const filePath = path.default.join(absOutput, file.path);
671
- const dir = path.default.dirname(filePath);
672
- if (!fs.default.existsSync(dir)) fs.default.mkdirSync(dir, { recursive: true });
673
- fs.default.writeFileSync(filePath, file.content, "utf-8");
674
- }
675
- }
676
- /**
677
- * Main entry point for the generate-sdk command.
678
- */
679
- async function generateSdkCommand(args) {
680
- const { collectionsDir, output, cwd } = args;
681
- const resolvedCollectionsDir = path.default.isAbsolute(collectionsDir) ? collectionsDir : path.default.join(cwd, collectionsDir);
682
- const resolvedOutput = path.default.isAbsolute(output) ? output : path.default.join(cwd, output);
683
- console.log("");
684
- console.log(chalk.default.bold(" 🔧 Rebase SDK Generator"));
685
- console.log("");
686
- console.log(` ${chalk.default.gray("Collections:")} ${resolvedCollectionsDir}`);
687
- console.log(` ${chalk.default.gray("Output:")} ${resolvedOutput}`);
688
- console.log("");
689
- console.log(chalk.default.cyan(" → Loading collection definitions..."));
690
- const collections = await loadCollections(resolvedCollectionsDir);
691
- collections.sort((a, b) => a.slug.localeCompare(b.slug));
692
- if (collections.length === 0) {
693
- console.log(chalk.default.red(" ✗ No collections found. Nothing to generate."));
694
- process.exit(1);
695
- }
696
- console.log(chalk.default.green(` ✓ Found ${collections.length} collection(s): ${collections.map((c) => c.slug).join(", ")}`));
697
- console.log("");
698
- console.log(chalk.default.cyan(" → Generating SDK files..."));
699
- const files = (0, _rebasepro_sdk_generator.generateSDK)(collections);
700
- console.log(chalk.default.green(` ✓ Generated ${files.length} file(s)`));
701
- console.log(chalk.default.cyan(` → Writing to ${resolvedOutput}...`));
702
- writeFiles(resolvedOutput, files);
703
- console.log("");
704
- console.log(chalk.default.green.bold(" ✓ SDK generated successfully!"));
705
- console.log("");
706
- console.log(chalk.default.gray(" Usage:"));
707
- console.log(chalk.default.gray(" import { createRebaseClient } from '@rebasepro/client';"));
708
- console.log(chalk.default.gray(` import type { Database } from './${path.default.relative(cwd, path.default.join(resolvedOutput, "database.types"))}';`));
709
- console.log("");
710
- console.log(chalk.default.gray(" const rebase = createRebaseClient<Database>({"));
711
- console.log(chalk.default.gray(" baseUrl: 'http://localhost:3001',"));
712
- console.log(chalk.default.gray(" // token: 'your-jwt-token',"));
713
- console.log(chalk.default.gray(" });"));
714
- console.log("");
715
- console.log(chalk.default.gray(` const { data } = await rebase.collection('${collections[0]?.slug || "my_collection"}').find();`));
716
- console.log("");
717
- }
718
- //#endregion
719
- //#region src/utils/project.ts
720
- /**
721
- * Project discovery utilities for the Rebase CLI.
722
- *
723
- * These helpers locate the project root, backend directory, .env file,
724
- * and local binaries — used by all CLI command modules.
725
- */
726
- /**
727
- * Walk up from `startDir` to find the Rebase project root.
728
- *
729
- * The root is identified by a `package.json` that either:
730
- * - has `workspaces` containing "backend" or "frontend", OR
731
- * - has a sibling `backend/` directory
732
- */
733
- function findProjectRoot(startDir = process.cwd()) {
734
- let dir = path.default.resolve(startDir);
735
- const root = path.default.parse(dir).root;
736
- while (dir !== root) {
737
- const pkgPath = path.default.join(dir, "package.json");
738
- if (fs.default.existsSync(pkgPath)) {
739
- try {
740
- const pkg = JSON.parse(fs.default.readFileSync(pkgPath, "utf-8"));
741
- if (pkg.workspaces && Array.isArray(pkg.workspaces)) {
742
- if (pkg.workspaces.some((w) => w === "backend" || w.includes("backend"))) return dir;
743
- }
744
- } catch {}
745
- if (fs.default.existsSync(path.default.join(dir, "backend")) && fs.default.existsSync(path.default.join(dir, "config"))) return dir;
746
- }
747
- dir = path.default.dirname(dir);
748
- }
749
- return null;
750
- }
751
- /**
752
- * Locate the backend directory within the project root.
753
- */
754
- function findBackendDir(projectRoot) {
755
- const backendDir = path.default.join(projectRoot, "backend");
756
- return fs.default.existsSync(backendDir) ? backendDir : null;
757
- }
758
- /**
759
- * Detect the active backend plugin (e.g. @rebasepro/server-postgresql) from the backend's package.json.
760
- */
761
- function getActiveBackendPlugin(backendDir) {
762
- const pkgPath = path.default.join(backendDir, "package.json");
763
- if (!fs.default.existsSync(pkgPath)) return null;
764
- try {
765
- const pkg = JSON.parse(fs.default.readFileSync(pkgPath, "utf-8"));
766
- const deps = {
767
- ...pkg.dependencies,
768
- ...pkg.devDependencies
769
- };
770
- const candidates = Object.keys(deps).filter((dep) => dep.startsWith("@rebasepro/server-") && dep !== "@rebasepro/server-core");
771
- if (candidates.length === 0) return null;
772
- if (candidates.includes("@rebasepro/server-postgresql")) return "@rebasepro/server-postgresql";
773
- for (const candidate of candidates) if (resolvePluginCliScript(backendDir, candidate)) return candidate;
774
- return candidates[0];
775
- } catch {}
776
- return null;
777
- }
778
- /**
779
- * Resolve the active plugin's CLI script.
780
- */
781
- function resolvePluginCliScript(backendDir, pluginName) {
782
- const candidates = [
783
- path.default.join(backendDir, "node_modules", pluginName, "src", "cli.ts"),
784
- path.default.join(backendDir, "node_modules", pluginName, "dist", "cli.js"),
785
- path.default.resolve(backendDir, "..", "..", "..", "packages", pluginName.replace("@rebasepro/", ""), "src", "cli.ts"),
786
- path.default.resolve(backendDir, "..", "..", "packages", pluginName.replace("@rebasepro/", ""), "src", "cli.ts"),
787
- path.default.resolve(backendDir, "..", "packages", pluginName.replace("@rebasepro/", ""), "src", "cli.ts")
788
- ];
789
- for (const candidate of candidates) if (fs.default.existsSync(candidate)) return candidate;
790
- return null;
791
- }
792
- /**
793
- * Locate the frontend directory within the project root.
794
- */
795
- function findFrontendDir(projectRoot) {
796
- const frontendDir = path.default.join(projectRoot, "frontend");
797
- return fs.default.existsSync(frontendDir) ? frontendDir : null;
798
- }
799
- /**
800
- * Find the .env file. Checks the project root first, then backend.
801
- */
802
- function findEnvFile(projectRoot) {
803
- const candidates = [path.default.join(projectRoot, ".env"), path.default.join(projectRoot, "backend", ".env")];
804
- for (const candidate of candidates) if (fs.default.existsSync(candidate)) return candidate;
805
- return null;
806
- }
807
- /**
808
- * Resolve a binary from the project's node_modules/.bin.
809
- * Checks backend, root, parent monorepo root, then falls back to PATH.
810
- */
811
- function resolveLocalBin(projectRoot, binName) {
812
- const candidates = [path.default.join(projectRoot, "backend", "node_modules", ".bin", binName), path.default.join(projectRoot, "node_modules", ".bin", binName)];
813
- let parent = path.default.dirname(projectRoot);
814
- const rootDir = path.default.parse(parent).root;
815
- while (parent !== rootDir) {
816
- candidates.push(path.default.join(parent, "node_modules", ".bin", binName));
817
- parent = path.default.dirname(parent);
818
- }
819
- for (const candidate of candidates) if (fs.default.existsSync(candidate)) return candidate;
820
- try {
821
- const globalPath = (0, child_process.execSync)(`which ${binName}`, { encoding: "utf-8" }).trim();
822
- if (globalPath && fs.default.existsSync(globalPath)) return globalPath;
823
- } catch {}
824
- return null;
825
- }
826
- /**
827
- * Resolve the tsx binary. Checks backend node_modules first, then root.
828
- */
829
- function resolveTsx(projectRoot) {
830
- return resolveLocalBin(projectRoot, "tsx");
831
- }
832
- /**
833
- * Require the project root or exit with a helpful error.
834
- */
835
- function requireProjectRoot() {
836
- const root = findProjectRoot();
837
- if (!root) {
838
- console.error(chalk.default.red("✗ Could not find a Rebase project root."));
839
- console.error(chalk.default.gray(" Make sure you are inside a Rebase project directory"));
840
- console.error(chalk.default.gray(" (one with backend/, frontend/, and config/ directories)."));
841
- process.exit(1);
842
- }
843
- return root;
844
- }
845
- /**
846
- * Require the backend directory or exit with a helpful error.
847
- */
848
- function requireBackendDir(projectRoot) {
849
- const backendDir = findBackendDir(projectRoot);
850
- if (!backendDir) {
851
- console.error(chalk.default.red("✗ Could not find a backend/ directory."));
852
- console.error(chalk.default.gray(` Expected at: ${path.default.join(projectRoot, "backend")}`));
853
- process.exit(1);
854
- }
855
- return backendDir;
856
- }
857
- //#endregion
858
- //#region src/commands/schema.ts
859
- /**
860
- * CLI command: rebase schema <action>
861
- */
862
- async function schemaCommand(subcommand, rawArgs) {
863
- if (!subcommand || subcommand === "--help") {
864
- printSchemaHelp();
865
- return;
866
- }
867
- const projectRoot = requireProjectRoot();
868
- const backendDir = requireBackendDir(projectRoot);
869
- const activePlugin = getActiveBackendPlugin(backendDir);
870
- if (!activePlugin) {
871
- console.error(chalk.default.red("✗ Could not detect an active database plugin."));
872
- console.error(chalk.default.gray(" Make sure a package like @rebasepro/server-postgresql is installed in backend/package.json."));
873
- process.exit(1);
874
- }
875
- const pluginCli = resolvePluginCliScript(backendDir, activePlugin);
876
- if (!pluginCli) {
877
- console.error(chalk.default.red(`✗ Could not find CLI entry point for ${activePlugin}.`));
878
- process.exit(1);
879
- }
880
- const envFile = findEnvFile(projectRoot);
881
- const env = { ...process.env };
882
- if (envFile) env.DOTENV_CONFIG_PATH = envFile;
883
- try {
884
- if (pluginCli.endsWith(".ts")) {
885
- const tsxBin = resolveTsx(projectRoot);
886
- if (!tsxBin) {
887
- console.error(chalk.default.red("✗ Could not find tsx binary."));
888
- process.exit(1);
889
- }
890
- await (0, execa.execa)(tsxBin, [pluginCli, ...rawArgs.slice(2)], {
891
- cwd: backendDir,
892
- stdio: "inherit",
893
- env
894
- });
895
- } else await (0, execa.execa)("node", [pluginCli, ...rawArgs.slice(2)], {
896
- cwd: backendDir,
897
- stdio: "inherit",
898
- env
899
- });
900
- } catch {
901
- process.exit(1);
902
- }
903
- }
904
- function printSchemaHelp() {
905
- console.log(`
906
- ${chalk.default.bold("rebase schema")} — Schema management commands
907
-
908
- ${chalk.default.green.bold("Usage")}
909
- rebase schema ${chalk.default.blue("<command>")} [options]
910
-
911
- ${chalk.default.green.bold("Commands")}
912
- ${chalk.default.gray("(Commands are provided by your active database driver plugin)")}
913
- ${chalk.default.blue.bold("generate")} Generate Schema from collection definitions
914
- ${chalk.default.blue.bold("introspect")} Introspect an existing database to generate collection definitions
915
-
916
- ${chalk.default.green.bold("generate Options")}
917
- ${chalk.default.blue("--collections, -c")} Path to collections directory
918
- ${chalk.default.blue("--output, -o")} Output path for generated schema
919
- ${chalk.default.blue("--watch, -w")} Watch for changes and regenerate automatically
920
-
921
- ${chalk.default.green.bold("introspect Options")}
922
- ${chalk.default.blue("--output, -o")} Output directory for generated collection files
923
- `);
924
- }
925
- //#endregion
926
- //#region src/commands/db.ts
927
- /**
928
- * CLI command: rebase db <action>
929
- */
930
- async function dbCommand(subcommand, rawArgs) {
931
- if (!subcommand || subcommand === "--help") {
932
- printDbHelp();
933
- return;
934
- }
935
- const projectRoot = requireProjectRoot();
936
- const backendDir = requireBackendDir(projectRoot);
937
- const activePlugin = getActiveBackendPlugin(backendDir);
938
- if (!activePlugin) {
939
- console.error(chalk.default.red("✗ Could not detect an active database plugin."));
940
- console.error(chalk.default.gray(" Make sure a package like @rebasepro/server-postgresql is installed in backend/package.json."));
941
- process.exit(1);
942
- }
943
- const pluginCli = resolvePluginCliScript(backendDir, activePlugin);
944
- if (!pluginCli) {
945
- console.error(chalk.default.red(`✗ Could not find CLI entry point for ${activePlugin}.`));
946
- process.exit(1);
947
- }
948
- const envFile = findEnvFile(projectRoot);
949
- const env = { ...process.env };
950
- if (envFile) env.DOTENV_CONFIG_PATH = envFile;
951
- try {
952
- if (pluginCli.endsWith(".ts")) {
953
- const tsxBin = resolveTsx(projectRoot);
954
- if (!tsxBin) {
955
- console.error(chalk.default.red("✗ Could not find tsx binary."));
956
- process.exit(1);
957
- }
958
- await (0, execa.execa)(tsxBin, [pluginCli, ...rawArgs.slice(2)], {
959
- cwd: backendDir,
960
- stdio: "inherit",
961
- env
962
- });
963
- } else await (0, execa.execa)("node", [pluginCli, ...rawArgs.slice(2)], {
964
- cwd: backendDir,
965
- stdio: "inherit",
966
- env
967
- });
968
- } catch {
969
- process.exit(1);
970
- }
971
- }
972
- function printDbHelp() {
973
- console.log(`
974
- ${chalk.default.bold("rebase db")} — Database management commands
975
-
976
- ${chalk.default.green.bold("Usage")}
977
- rebase db ${chalk.default.blue("<command>")} [options]
978
-
979
- ${chalk.default.green.bold("Commands")}
980
- ${chalk.default.gray("(Commands are provided by your active database driver plugin)")}
981
- ${chalk.default.blue.bold("push")} Apply schema directly to database (development)
982
- ${chalk.default.blue.bold("generate")} Generate migration files
983
- ${chalk.default.blue.bold("migrate")} Run pending migrations
984
- ${chalk.default.blue.bold("studio")} Open Studio viewer
985
- ${chalk.default.blue.bold("branch")} Database branching (create, list, delete, info)
986
-
987
- ${chalk.default.green.bold("Examples")}
988
- ${chalk.default.gray("# Quick development workflow")}
989
- rebase schema generate && rebase db push
990
-
991
- ${chalk.default.gray("# Production migration workflow")}
992
- rebase db generate
993
- rebase db migrate
994
-
995
- ${chalk.default.gray("# Create a database branch")}
996
- rebase db branch create feature_auth
997
- `);
998
- }
999
- //#endregion
1000
- //#region src/commands/dev.ts
1001
- /**
1002
- * CLI command: rebase dev
1003
- *
1004
- * Starts the full development environment:
1005
- * - Backend: tsx watch with auto-reload
1006
- * - Frontend: vite dev server
1007
- *
1008
- * Both processes stream output with color-coded prefixes.
1009
- *
1010
- * When the backend uses port-retry (i.e. the configured port is busy and it
1011
- * binds to the next free one), the CLI detects the actual port from stdout
1012
- * and injects VITE_API_URL into the frontend so it connects automatically.
1013
- *
1014
- * Each project gets a deterministic default port derived from the project
1015
- * root path, so multiple Rebase instances never collide.
1016
- */
1017
- /** Well-known filename the backend writes its actual port to. */
1018
- var DEV_PORT_FILENAME = ".rebase-dev-port";
1019
- /**
1020
- * Compute a deterministic port from the project root path.
1021
- * Range: 3001–3999 (avoids privileged ports and common services).
1022
- * Two different project directories will almost always get different ports.
1023
- */
1024
- function getProjectPort(projectRoot) {
1025
- let hash = 0;
1026
- for (let i = 0; i < projectRoot.length; i++) hash = (hash << 5) - hash + projectRoot.charCodeAt(i) | 0;
1027
- return 3001 + Math.abs(hash) % 999;
1028
- }
1029
- /**
1030
- * Resolve the best starting port for this project:
1031
- * 1. Explicit --port flag (highest priority)
1032
- * 2. PORT env var
1033
- * 3. Previously used port from .rebase-dev-port (port affinity across restarts)
1034
- * 4. Deterministic hash from project path (unique per project)
1035
- */
1036
- function resolveStartPort(projectRoot, explicitPort) {
1037
- if (explicitPort) return explicitPort;
1038
- if (process.env.PORT) return parseInt(process.env.PORT, 10);
1039
- try {
1040
- const portFile = path.default.join(projectRoot, DEV_PORT_FILENAME);
1041
- if (fs.default.existsSync(portFile)) {
1042
- const saved = parseInt(fs.default.readFileSync(portFile, "utf-8").trim(), 10);
1043
- if (saved > 0 && saved < 65536) return saved;
1044
- }
1045
- } catch {}
1046
- return getProjectPort(projectRoot);
1047
- }
1048
- async function devCommand(rawArgs) {
1049
- const args = (0, arg.default)({
1050
- "--backend-only": Boolean,
1051
- "--frontend-only": Boolean,
1052
- "--port": Number,
1053
- "--generate": Boolean,
1054
- "--help": Boolean,
1055
- "-b": "--backend-only",
1056
- "-f": "--frontend-only",
1057
- "-p": "--port",
1058
- "-g": "--generate",
1059
- "-h": "--help"
1060
- }, {
1061
- argv: rawArgs.slice(3),
1062
- permissive: true
1063
- });
1064
- if (args["--help"]) {
1065
- printDevHelp();
1066
- return;
1067
- }
1068
- const projectRoot = requireProjectRoot();
1069
- const backendDir = findBackendDir(projectRoot);
1070
- const frontendDir = findFrontendDir(projectRoot);
1071
- const backendOnly = args["--backend-only"] || false;
1072
- const frontendOnly = args["--frontend-only"] || false;
1073
- const shouldGenerate = args["--generate"] || process.env.REBASE_AUTO_GENERATE === "true" || process.env.REBASE_GENERATE === "true";
1074
- const startPort = resolveStartPort(projectRoot, args["--port"]);
1075
- console.log("");
1076
- console.log(chalk.default.bold(" 🚀 Rebase Dev Server"));
1077
- console.log("");
1078
- const children = [];
1079
- let frontendUrl = "";
1080
- let backendUrl = "";
1081
- let debounceSummary = null;
1082
- let bannerPrinted = false;
1083
- /** Actual backend port, resolved once the server prints its URL. */
1084
- let resolvedBackendPort = null;
1085
- const stripAnsi = (str) => str.replace(/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g, "");
1086
- function printSummary() {
1087
- if (!frontendUrl || !backendUrl) return;
1088
- if (debounceSummary) clearTimeout(debounceSummary);
1089
- debounceSummary = setTimeout(() => {
1090
- if (bannerPrinted) return;
1091
- console.log("");
1092
- console.log(chalk.default.cyan("┌────────────────────────────────────────────────────────────┐"));
1093
- console.log(chalk.default.cyan("│ │"));
1094
- console.log(chalk.default.cyan("│ ✦ Rebase Admin App is ready! │"));
1095
- const paddedUrl = stripAnsi(frontendUrl).padEnd(41);
1096
- console.log(chalk.default.cyan("│ ➜ Frontend URL: ") + chalk.default.white(paddedUrl) + chalk.default.cyan("│"));
1097
- console.log(chalk.default.cyan("│ │"));
1098
- console.log(chalk.default.cyan("└────────────────────────────────────────────────────────────┘"));
1099
- console.log("");
1100
- bannerPrinted = true;
1101
- }, 500);
1102
- }
1103
- const cleanup = () => {
1104
- try {
1105
- const portFile = path.default.join(projectRoot, DEV_PORT_FILENAME);
1106
- if (fs.default.existsSync(portFile)) fs.default.unlinkSync(portFile);
1107
- const urlFile = path.default.join(projectRoot, ".rebase-dev-url");
1108
- if (fs.default.existsSync(urlFile)) fs.default.unlinkSync(urlFile);
1109
- } catch {}
1110
- children.forEach((child) => {
1111
- if (child.pid && !child.killed) try {
1112
- if (process.platform === "win32") (0, execa.execaCommandSync)(`taskkill /pid ${child.pid} /T /F`);
1113
- else process.kill(-child.pid, "SIGKILL");
1114
- } catch (e) {
1115
- try {
1116
- child.kill("SIGKILL");
1117
- } catch (err) {}
1118
- }
1119
- });
1120
- process.exit(0);
1121
- };
1122
- process.on("SIGINT", cleanup);
1123
- process.on("SIGTERM", cleanup);
1124
- /**
1125
- * Start the Vite frontend, optionally injecting the backend port.
1126
- */
1127
- function startFrontend(backendPort) {
1128
- if (!frontendDir) return;
1129
- console.log(` ${chalk.default.magenta("▶")} Frontend: ${chalk.default.gray(frontendDir)}`);
1130
- const frontendEnv = { ...process.env };
1131
- if (backendPort) {
1132
- frontendEnv.VITE_API_URL = `http://localhost:${backendPort}`;
1133
- console.log(` ${chalk.default.gray("↳ VITE_API_URL")} = ${chalk.default.white(`http://localhost:${backendPort}`)}`);
1134
- }
1135
- const runDevCmd = getPMCommands(detectPackageManager(projectRoot)).run("dev");
1136
- const frontendChild = (0, execa.execa)(runDevCmd[0], runDevCmd.slice(1), {
1137
- cwd: frontendDir,
1138
- stdio: [
1139
- "inherit",
1140
- "pipe",
1141
- "pipe"
1142
- ],
1143
- env: frontendEnv,
1144
- shell: true,
1145
- detached: process.platform !== "win32"
1146
- });
1147
- frontendChild.catch(() => {});
1148
- frontendChild.stdout?.on("data", (data) => {
1149
- data.toString().split("\n").filter(Boolean).forEach((line) => {
1150
- console.log(`${chalk.default.magenta.bold("[admin]")} ${line}`);
1151
- const cleanLine = stripAnsi(line);
1152
- const urlMatch = cleanLine.match(/(http:\/\/(?:localhost|127\.0\.0\.1):\d+)/);
1153
- if (cleanLine.includes("Local:") && urlMatch) {
1154
- frontendUrl = urlMatch[1];
1155
- printSummary();
1156
- }
1157
- });
1158
- });
1159
- frontendChild.stderr?.on("data", (data) => {
1160
- data.toString().split("\n").filter(Boolean).forEach((line) => {
1161
- console.log(`${chalk.default.magenta.bold("[admin]")} ${line}`);
1162
- });
1163
- });
1164
- children.push(frontendChild);
1165
- }
1166
- if (!frontendOnly && backendDir) {
1167
- const tsxBin = resolveTsx(projectRoot);
1168
- if (!tsxBin) {
1169
- const addCmd = [
1170
- ...getPMCommands(detectPackageManager(projectRoot)).install,
1171
- "-D",
1172
- "tsx"
1173
- ].join(" ");
1174
- console.error(chalk.default.red(" ✗ Could not find tsx binary for backend."));
1175
- console.error(chalk.default.gray(` Install it with: ${addCmd}`));
1176
- process.exit(1);
1177
- }
1178
- const envFile = findEnvFile(projectRoot);
1179
- const env = { ...process.env };
1180
- if (envFile) env.DOTENV_CONFIG_PATH = envFile;
1181
- env.PORT = String(startPort);
1182
- console.log(` ${chalk.default.cyan("▶")} Backend: ${chalk.default.gray(backendDir)}`);
1183
- console.log(` ${chalk.default.gray("↳ PORT")} = ${chalk.default.white(String(startPort))}`);
1184
- /** Whether the frontend has been launched (we only launch it once). */
1185
- let frontendLaunched = false;
1186
- if (shouldGenerate) {
1187
- console.log(chalk.default.gray(" → Ensuring schema and SDK are generated on start..."));
1188
- try {
1189
- const activePlugin = getActiveBackendPlugin(backendDir);
1190
- const pluginCli = activePlugin ? resolvePluginCliScript(backendDir, activePlugin) : null;
1191
- if (pluginCli) await (0, execa.execa)(tsxBin, [
1192
- pluginCli,
1193
- "schema",
1194
- "generate"
1195
- ], {
1196
- cwd: backendDir,
1197
- stdio: "inherit",
1198
- env
1199
- });
1200
- const sdkCmd = getPMCommands(detectPackageManager(projectRoot)).exec("rebase", ["generate-sdk"]);
1201
- await (0, execa.execa)(sdkCmd[0], sdkCmd.slice(1), {
1202
- cwd: projectRoot,
1203
- stdio: "inherit",
1204
- env
1205
- });
1206
- console.log(chalk.default.green(" ✓ Initial schema and SDK generated successfully.\n"));
1207
- } catch (err) {
1208
- console.error(chalk.default.red(` ✗ Initial schema/SDK generation failed: ${err instanceof Error ? err.message : err}\n`));
1209
- }
1210
- const collectionsDir = path.default.join(projectRoot, "config", "collections");
1211
- if (fs.default.existsSync(collectionsDir)) {
1212
- let watchDebounce = null;
1213
- fs.default.watch(collectionsDir, { recursive: true }, (eventType, filename) => {
1214
- if (!filename || filename.startsWith(".") || filename.endsWith(".tmp")) return;
1215
- if (watchDebounce) clearTimeout(watchDebounce);
1216
- watchDebounce = setTimeout(async () => {
1217
- console.log(chalk.default.yellow(`\n 🔄 Collection change detected (${filename}). Regenerating schema & SDK...`));
1218
- try {
1219
- const activePlugin = getActiveBackendPlugin(backendDir);
1220
- const pluginCli = activePlugin ? resolvePluginCliScript(backendDir, activePlugin) : null;
1221
- if (pluginCli) await (0, execa.execa)(tsxBin, [
1222
- pluginCli,
1223
- "schema",
1224
- "generate"
1225
- ], {
1226
- cwd: backendDir,
1227
- stdio: "inherit",
1228
- env
1229
- });
1230
- const sdkCmd = getPMCommands(detectPackageManager(projectRoot)).exec("rebase", ["generate-sdk"]);
1231
- await (0, execa.execa)(sdkCmd[0], sdkCmd.slice(1), {
1232
- cwd: projectRoot,
1233
- stdio: "inherit",
1234
- env
1235
- });
1236
- console.log(chalk.default.green(" ✓ Schema & SDK regenerated successfully. Hono will reload."));
1237
- } catch (err) {
1238
- console.error(chalk.default.red(` ✗ Failed to regenerate schema/SDK: ${err instanceof Error ? err.message : err}`));
1239
- }
1240
- }, 300);
1241
- });
1242
- }
1243
- }
1244
- const watchArgs = [
1245
- "watch",
1246
- "--conditions",
1247
- "development",
1248
- "src/index.ts"
1249
- ];
1250
- if (!shouldGenerate) {
1251
- watchArgs.splice(1, 0, `--watch="${path.default.join("..", "config", "**", "*")}"`);
1252
- const collectionsDir = path.default.join(projectRoot, "config", "collections");
1253
- if (fs.default.existsSync(collectionsDir)) {
1254
- let driftDebounce = null;
1255
- fs.default.watch(collectionsDir, { recursive: true }, (_eventType, filename) => {
1256
- if (!filename || filename.startsWith(".") || filename.endsWith(".tmp")) return;
1257
- if (driftDebounce) clearTimeout(driftDebounce);
1258
- driftDebounce = setTimeout(() => {
1259
- console.log([
1260
- "",
1261
- chalk.default.yellow(" ┌──────────────────────────────────────────────────────────────┐"),
1262
- chalk.default.yellow(" │ ⚠️ Collection file changed: ") + chalk.default.white(filename.padEnd(31)) + chalk.default.yellow("│"),
1263
- chalk.default.yellow(" │ │"),
1264
- chalk.default.yellow(" │ Your schema may be out of sync. Run: │"),
1265
- chalk.default.yellow(" │ ") + chalk.default.cyan("rebase schema generate") + chalk.default.yellow(" regenerate Drizzle schema │"),
1266
- chalk.default.yellow(" │ ") + chalk.default.cyan("rebase db push ") + chalk.default.yellow(" sync schema to database │"),
1267
- chalk.default.yellow(" │ ") + chalk.default.cyan("rebase doctor ") + chalk.default.yellow(" check for drift │"),
1268
- chalk.default.yellow(" │ │"),
1269
- chalk.default.yellow(" │ TIP: Use ") + chalk.default.bold("rebase dev --generate") + chalk.default.yellow(" for auto-regeneration │"),
1270
- chalk.default.yellow(" └──────────────────────────────────────────────────────────────┘"),
1271
- ""
1272
- ].join("\n"));
1273
- }, 500);
1274
- });
1275
- }
1276
- }
1277
- const backendChild = (0, execa.execa)(tsxBin, watchArgs, {
1278
- cwd: backendDir,
1279
- stdio: [
1280
- "inherit",
1281
- "pipe",
1282
- "pipe"
1283
- ],
1284
- env,
1285
- shell: true,
1286
- detached: process.platform !== "win32"
1287
- });
1288
- backendChild.catch(() => {});
1289
- backendChild.stdout?.on("data", (data) => {
1290
- data.toString().split("\n").filter(Boolean).forEach((line) => {
1291
- console.log(`${chalk.default.cyan.bold("[backend]")} ${line}`);
1292
- const serverMatch = stripAnsi(line).match(/Server running at http:\/\/(?:localhost|127\.0\.0\.1):(\d+)/);
1293
- if (serverMatch) {
1294
- resolvedBackendPort = parseInt(serverMatch[1], 10);
1295
- backendUrl = "started";
1296
- printSummary();
1297
- const urlFile = path.default.join(projectRoot, ".rebase-dev-url");
1298
- fs.default.writeFileSync(urlFile, `http://localhost:${resolvedBackendPort}`, "utf-8");
1299
- const portFile = path.default.join(projectRoot, DEV_PORT_FILENAME);
1300
- fs.default.writeFileSync(portFile, String(resolvedBackendPort), "utf-8");
1301
- if (!backendOnly && frontendDir && !frontendLaunched) {
1302
- frontendLaunched = true;
1303
- startFrontend(resolvedBackendPort);
1304
- }
1305
- }
1306
- });
1307
- });
1308
- backendChild.stderr?.on("data", (data) => {
1309
- data.toString().split("\n").filter(Boolean).forEach((line) => {
1310
- console.log(`${chalk.default.cyan.bold("[backend]")} ${line}`);
1311
- });
1312
- });
1313
- children.push(backendChild);
1314
- } else if (!frontendOnly && !backendDir) console.warn(chalk.default.yellow(" ⚠ No backend/ directory found, skipping backend."));
1315
- if (!backendOnly && frontendDir && (frontendOnly || !backendDir)) startFrontend(null);
1316
- else if (!backendOnly && !frontendDir) console.warn(chalk.default.yellow(" ⚠ No frontend/ directory found, skipping frontend."));
1317
- if (children.length === 0) {
1318
- console.error(chalk.default.red(" ✗ Nothing to start. Check your project structure."));
1319
- process.exit(1);
1320
- }
1321
- console.log("");
1322
- console.log(chalk.default.gray(" Press Ctrl+C to stop all servers."));
1323
- console.log("");
1324
- await Promise.all(children.map((child) => new Promise((resolve) => {
1325
- child.finally(() => resolve());
1326
- })));
1327
- }
1328
- function printDevHelp() {
1329
- console.log(`
1330
- ${chalk.default.bold("rebase dev")} — Start the development server
1331
-
1332
- ${chalk.default.green.bold("Usage")}
1333
- rebase dev [options]
1334
-
1335
- ${chalk.default.green.bold("Options")}
1336
- ${chalk.default.blue("--backend-only, -b")} Only start the backend server
1337
- ${chalk.default.blue("--frontend-only, -f")} Only start the frontend server
1338
- ${chalk.default.blue("--port, -p")} Backend port (default: auto-detected per project)
1339
- ${chalk.default.blue("--generate, -g")} Enable automatic schema and SDK generation on startup and file changes
1340
-
1341
- ${chalk.default.green.bold("Description")}
1342
- Starts both the backend (tsx watch + Hono) and frontend (Vite)
1343
- dev servers concurrently with color-coded output prefixes.
1344
-
1345
- Each project automatically receives a unique default port derived
1346
- from its directory path, preventing collisions when running multiple
1347
- Rebase instances simultaneously.
1348
-
1349
- If the assigned port is already in use, the server will automatically
1350
- try the next available port. The frontend is started only after the
1351
- backend is ready, and VITE_API_URL is injected automatically.
1352
-
1353
- By default, automatic schema and SDK generation is disabled on startup
1354
- and file changes. Pass --generate (-g) or set REBASE_AUTO_GENERATE=true
1355
- in your environment to enable it.
1356
- `);
1357
- }
1358
- //#endregion
1359
- //#region src/commands/build.ts
1360
- /**
1361
- * CLI command: rebase build
1362
- *
1363
- * Runs the build script in all workspace packages.
1364
- * Automatically detects the package manager (pnpm or npm) and
1365
- * uses the correct workspace-aware command.
1366
- */
1367
- async function buildCommand() {
1368
- const projectRoot = requireProjectRoot();
1369
- const pm = detectPackageManager(projectRoot);
1370
- const buildCmd = getPMCommands(pm).runAll("build");
1371
- console.log(`${chalk.default.bold("Rebase")} — Building all workspaces with ${chalk.default.cyan(pm)}...\n`);
1372
- try {
1373
- await (0, execa.execa)(buildCmd[0], buildCmd.slice(1), {
1374
- cwd: projectRoot,
1375
- stdio: "inherit"
1376
- });
1377
- } catch {
1378
- console.error(chalk.default.red("\n✗ Build failed."));
1379
- process.exit(1);
1380
- }
1381
- }
1382
- //#endregion
1383
- //#region src/commands/start.ts
1384
- /**
1385
- * CLI command: rebase start
1386
- *
1387
- * Starts the backend server in production mode.
1388
- * Automatically detects the package manager (pnpm or npm) and
1389
- * runs the start script in the backend workspace.
1390
- */
1391
- async function startCommand() {
1392
- const projectRoot = requireProjectRoot();
1393
- const startCmd = getPMCommands(detectPackageManager(projectRoot)).runWorkspace("backend", "start");
1394
- const envFile = findEnvFile(projectRoot);
1395
- const env = { ...process.env };
1396
- if (envFile) env.DOTENV_CONFIG_PATH = envFile;
1397
- console.log(`${chalk.default.bold("Rebase")} — Starting backend server...\n`);
1398
- try {
1399
- await (0, execa.execa)(startCmd[0], startCmd.slice(1), {
1400
- cwd: projectRoot,
1401
- stdio: "inherit",
1402
- env
1403
- });
1404
- } catch {
1405
- console.error(chalk.default.red("\n✗ Failed to start server."));
1406
- process.exit(1);
1407
- }
1408
- }
1409
- //#endregion
1410
- //#region src/commands/auth.ts
1411
- /**
1412
- * CLI command: rebase auth <action>
1413
- *
1414
- * Subcommands:
1415
- * reset-password — Reset a user's password
1416
- */
1417
- async function authCommand(subcommand, rawArgs) {
1418
- if (!subcommand || subcommand === "--help") {
1419
- printAuthHelp();
1420
- return;
1421
- }
1422
- switch (subcommand) {
1423
- case "reset-password":
1424
- await resetPassword(rawArgs);
1425
- break;
1426
- default:
1427
- console.error(chalk.default.red(`Unknown auth command: ${subcommand}`));
1428
- console.log("");
1429
- printAuthHelp();
1430
- process.exit(1);
1431
- }
1432
- }
1433
- async function resetPassword(rawArgs) {
1434
- const args = (0, arg.default)({
1435
- "--email": String,
1436
- "--password": String,
1437
- "-e": "--email",
1438
- "-p": "--password"
1439
- }, {
1440
- argv: rawArgs.slice(4),
1441
- permissive: true
1442
- });
1443
- const email = args["--email"] || args._[0];
1444
- const newPassword = args["--password"] || args._[1];
1445
- if (!email) {
1446
- console.error(chalk.default.red("✗ Email is required."));
1447
- console.log("");
1448
- console.log(chalk.default.gray(" Usage: rebase auth reset-password <email> [new-password]"));
1449
- console.log(chalk.default.gray(" rebase auth reset-password --email user@example.com --password NewPass123!"));
1450
- process.exit(1);
1451
- }
1452
- const projectRoot = requireProjectRoot();
1453
- const backendDir = requireBackendDir(projectRoot);
1454
- const tsxBin = resolveTsx(projectRoot);
1455
- if (!tsxBin) {
1456
- console.error(chalk.default.red("✗ Could not find tsx binary."));
1457
- process.exit(1);
1458
- }
1459
- const envFile = findEnvFile(projectRoot);
1460
- const env = { ...process.env };
1461
- if (envFile) env.DOTENV_CONFIG_PATH = envFile;
1462
- env.REBASE_RESET_EMAIL = email;
1463
- env.REBASE_RESET_PASSWORD = newPassword || "NewPassword123!";
1464
- env.REBASE_ENV_FILE_PATH = envFile || path.default.join(projectRoot, ".env");
1465
- const scriptContent = `
1466
- import { createPostgresDatabaseConnection } from "@rebasepro/server-postgresql";
1467
- import { hashPassword } from "@rebasepro/server-core";
1468
- import { eq } from "drizzle-orm";
1469
- import * as dotenv from "dotenv";
1470
- import path from "path";
1471
- import fs from "fs";
1472
-
1473
- dotenv.config({ path: process.env.REBASE_ENV_FILE_PATH });
1474
-
1475
- const email = process.env.REBASE_RESET_EMAIL!;
1476
- const newPassword = process.env.REBASE_RESET_PASSWORD!;
1477
-
1478
- async function resetPassword() {
1479
- const { db } = createPostgresDatabaseConnection(process.env.DATABASE_URL!);
1480
- const hash = await hashPassword(newPassword);
1481
-
1482
- let usersTable;
1483
- try {
1484
- const schemaPath = path.resolve("./src/schema.generated.ts");
1485
- if (fs.existsSync(schemaPath)) {
1486
- const schema = await import("file://" + schemaPath);
1487
- usersTable = schema.users || schema.tables?.users;
1488
- }
1489
- } catch (e) {
1490
- // ignore and fallback
1491
- }
1492
-
1493
- if (!usersTable) {
1494
- const pgServer = await import("@rebasepro/server-postgresql");
1495
- usersTable = pgServer.users;
1496
- }
1497
-
1498
- const passwordHashKey = (usersTable.passwordHash || "passwordHash" in usersTable) ? "passwordHash" : "password_hash";
1499
-
1500
- const result = await db.update(usersTable)
1501
- .set({ [passwordHashKey]: hash })
1502
- .where(eq(usersTable.email, email))
1503
- .returning({
1504
- id: usersTable.id,
1505
- email: usersTable.email
1506
- });
1507
-
1508
- if (result.length > 0) {
1509
- console.log("✅ Password reset for: " + result[0].email);
1510
- ${!newPassword ? "console.log(\" New password: \" + newPassword);" : ""}
1511
- } else {
1512
- console.log("✗ User not found: " + email);
1513
- }
1514
- process.exit(0);
1515
- }
1516
-
1517
- resetPassword().catch(console.error);
1518
- `;
1519
- const tmpScriptPath = path.default.join(backendDir, ".tmp-reset-password.ts");
1520
- fs.default.writeFileSync(tmpScriptPath, scriptContent, "utf-8");
1521
- console.log("");
1522
- console.log(chalk.default.bold(" 🔑 Rebase Auth — Reset Password"));
1523
- console.log("");
1524
- console.log(` ${chalk.default.gray("Email:")} ${email}`);
1525
- if (newPassword) console.log(` ${chalk.default.gray("Password:")} ${"*".repeat(newPassword.length)}`);
1526
- console.log("");
1527
- const child = (0, child_process.spawn)(tsxBin, [tmpScriptPath], {
1528
- cwd: backendDir,
1529
- stdio: "inherit",
1530
- env
1531
- });
1532
- return new Promise((resolve) => {
1533
- child.on("close", (code) => {
1534
- try {
1535
- fs.default.unlinkSync(tmpScriptPath);
1536
- } catch {}
1537
- if (code !== 0) process.exit(code ?? 1);
1538
- resolve();
1539
- });
1540
- });
1541
- }
1542
- function printAuthHelp() {
1543
- console.log(`
1544
- ${chalk.default.bold("rebase auth")} — Authentication management commands
1545
-
1546
- ${chalk.default.green.bold("Usage")}
1547
- rebase auth ${chalk.default.blue("<command>")} [options]
1548
-
1549
- ${chalk.default.green.bold("Commands")}
1550
- ${chalk.default.blue.bold("reset-password")} Reset a user's password
1551
-
1552
- ${chalk.default.green.bold("reset-password Options")}
1553
- ${chalk.default.blue("--email, -e")} User's email address
1554
- ${chalk.default.blue("--password, -p")} New password (default: NewPassword123!)
1555
-
1556
- ${chalk.default.green.bold("Examples")}
1557
- rebase auth reset-password user@example.com
1558
- rebase auth reset-password --email user@example.com --password MyNewPass!
1559
- `);
1560
- }
1561
- //#endregion
1562
- //#region src/commands/doctor.ts
1563
- /**
1564
- * CLI command: rebase doctor
1565
- *
1566
- * Detects three-way schema drift between collection definitions,
1567
- * the generated Drizzle schema, and the live PostgreSQL database.
1568
- */
1569
- async function doctorCommand(rawArgs) {
1570
- const projectRoot = requireProjectRoot();
1571
- const backendDir = requireBackendDir(projectRoot);
1572
- const activePlugin = getActiveBackendPlugin(backendDir);
1573
- if (!activePlugin) {
1574
- console.error(chalk.default.red("✗ Could not detect an active database plugin."));
1575
- console.error(chalk.default.gray(" Make sure a package like @rebasepro/server-postgresql is installed in backend/package.json."));
1576
- process.exit(1);
1577
- }
1578
- const pluginCli = resolvePluginCliScript(backendDir, activePlugin);
1579
- if (!pluginCli) {
1580
- console.error(chalk.default.red(`✗ Could not find CLI entry point for ${activePlugin}.`));
1581
- process.exit(1);
1582
- }
1583
- const envFile = findEnvFile(projectRoot);
1584
- const env = { ...process.env };
1585
- if (envFile) env.DOTENV_CONFIG_PATH = envFile;
1586
- try {
1587
- if (pluginCli.endsWith(".ts")) {
1588
- const tsxBin = resolveTsx(projectRoot);
1589
- if (!tsxBin) {
1590
- console.error(chalk.default.red("✗ Could not find tsx binary."));
1591
- process.exit(1);
1592
- }
1593
- await (0, execa.execa)(tsxBin, [pluginCli, ...rawArgs.slice(2)], {
1594
- cwd: backendDir,
1595
- stdio: "inherit",
1596
- env
1597
- });
1598
- } else await (0, execa.execa)("node", [pluginCli, ...rawArgs.slice(2)], {
1599
- cwd: backendDir,
1600
- stdio: "inherit",
1601
- env
1602
- });
1603
- } catch {
1604
- process.exit(1);
1605
- }
1606
- }
1607
- //#endregion
1608
- //#region src/commands/skills.ts
1609
- var __filename$1 = (0, url.fileURLToPath)({}.url);
1610
- var __dirname$1 = path.default.dirname(__filename$1);
1611
- /** Supported agent environments and their target directories. */
1612
- var AGENTS = {
1613
- cursor: {
1614
- label: "Cursor",
1615
- detectDir: ".cursor",
1616
- targetDir: ".cursor/rules",
1617
- /** Cursor uses .mdc files (Markdown with Context). */
1618
- transformFile: (skillName, content) => ({
1619
- fileName: `${skillName}.mdc`,
1620
- content
1621
- })
1622
- },
1623
- claude: {
1624
- label: "Claude Code",
1625
- detectDir: ".claude",
1626
- targetDir: ".claude/skills",
1627
- /** Claude Code uses the standard SKILL.md format in subdirectories. */
1628
- transformFile: (skillName, content) => ({
1629
- fileName: path.default.join(skillName, "SKILL.md"),
1630
- content
1631
- })
1632
- },
1633
- windsurf: {
1634
- label: "Windsurf",
1635
- detectDir: ".windsurf",
1636
- targetDir: ".windsurf/rules",
1637
- /** Windsurf uses plain .md files. */
1638
- transformFile: (skillName, content) => ({
1639
- fileName: `${skillName}.md`,
1640
- content
1641
- })
1642
- },
1643
- gemini: {
1644
- label: "Gemini CLI / Antigravity",
1645
- detectDir: ".agents",
1646
- targetDir: ".agents/skills",
1647
- /** Gemini uses the standard SKILL.md format in subdirectories. */
1648
- transformFile: (skillName, content) => ({
1649
- fileName: path.default.join(skillName, "SKILL.md"),
1650
- content
1651
- })
1652
- }
1653
- };
1654
- function findParentDir(currentDir, targetName) {
1655
- const root = path.default.parse(currentDir).root;
1656
- while (currentDir && currentDir !== root) {
1657
- if (path.default.basename(currentDir) === targetName) return currentDir;
1658
- currentDir = path.default.dirname(currentDir);
1659
- }
1660
- return null;
1661
- }
1662
- /** Resolve the path to the bundled skills directory. */
1663
- function getSkillsSourceDir() {
1664
- const cliRoot = findParentDir(__dirname$1, "cli");
1665
- if (cliRoot) {
1666
- const dir = path.default.join(cliRoot, "skills");
1667
- if (fs.default.existsSync(dir)) return dir;
1668
- }
1669
- const distSkills = path.default.resolve(__dirname$1, "../../skills");
1670
- if (fs.default.existsSync(distSkills)) return distSkills;
1671
- throw new Error("Could not find bundled skills directory. Make sure the CLI was built with `pnpm build`.");
1672
- }
1673
- /** Read all skill directories and return their names + content. */
1674
- function loadSkills(skillsDir) {
1675
- const entries = fs.default.readdirSync(skillsDir, { withFileTypes: true });
1676
- const skills = [];
1677
- for (const entry of entries) {
1678
- if (!entry.isDirectory()) continue;
1679
- const skillMdPath = path.default.join(skillsDir, entry.name, "SKILL.md");
1680
- if (!fs.default.existsSync(skillMdPath)) continue;
1681
- skills.push({
1682
- name: entry.name,
1683
- content: fs.default.readFileSync(skillMdPath, "utf-8")
1684
- });
1685
- }
1686
- return skills;
1687
- }
1688
- /** Detect which agent environments already exist in the project. */
1689
- function detectAgents(projectDir) {
1690
- const detected = [];
1691
- for (const [key, agent] of Object.entries(AGENTS)) if (fs.default.existsSync(path.default.join(projectDir, agent.detectDir))) detected.push(key);
1692
- return detected;
1693
- }
1694
- /** Install skills for a specific agent into the project directory. */
1695
- function installForAgent(agentKey, skills, projectDir) {
1696
- const agent = AGENTS[agentKey];
1697
- const targetBase = path.default.join(projectDir, agent.targetDir);
1698
- fs.default.mkdirSync(targetBase, { recursive: true });
1699
- let count = 0;
1700
- for (const skill of skills) {
1701
- const { fileName, content } = agent.transformFile(skill.name, skill.content);
1702
- const targetPath = path.default.join(targetBase, fileName);
1703
- fs.default.mkdirSync(path.default.dirname(targetPath), { recursive: true });
1704
- fs.default.writeFileSync(targetPath, content, "utf-8");
1705
- count++;
1706
- }
1707
- return count;
1708
- }
1709
- async function skillsCommand(subcommand, _args) {
1710
- switch (subcommand) {
1711
- case "install":
1712
- await skillsInstall();
1713
- break;
1714
- case "--help":
1715
- case void 0:
1716
- printSkillsHelp();
1717
- break;
1718
- default:
1719
- console.log(chalk.default.red(`Unknown skills subcommand: ${subcommand}`));
1720
- console.log("");
1721
- printSkillsHelp();
1722
- }
1723
- }
1724
- async function skillsInstall() {
1725
- const projectDir = process.cwd();
1726
- let skillsDir;
1727
- try {
1728
- skillsDir = getSkillsSourceDir();
1729
- } catch (err) {
1730
- console.error(`${chalk.default.red.bold("ERROR")} ${err instanceof Error ? err.message : String(err)}`);
1731
- process.exit(1);
1732
- }
1733
- const skills = loadSkills(skillsDir);
1734
- if (skills.length === 0) {
1735
- console.error(`${chalk.default.red.bold("ERROR")} No skills found in ${skillsDir}`);
1736
- process.exit(1);
1737
- }
1738
- let agents = detectAgents(projectDir);
1739
- if (agents.length === 0) {
1740
- const choices = Object.entries(AGENTS).map(([key, agent]) => ({
1741
- name: agent.label,
1742
- value: key,
1743
- checked: false
1744
- }));
1745
- const { selectedAgents } = await inquirer.default.prompt([{
1746
- type: "checkbox",
1747
- name: "selectedAgents",
1748
- message: "No AI agent configuration detected. Which agents do you use?",
1749
- choices,
1750
- validate: (input) => {
1751
- if (input.length === 0) return "Please select at least one agent.";
1752
- return true;
1753
- }
1754
- }]);
1755
- agents = selectedAgents;
1756
- }
1757
- console.log("");
1758
- console.log(chalk.default.gray(` Found ${chalk.default.white(skills.length)} Rebase skills`));
1759
- console.log("");
1760
- for (const agentKey of agents) {
1761
- const agent = AGENTS[agentKey];
1762
- const count = installForAgent(agentKey, skills, projectDir);
1763
- console.log(` ${chalk.default.green("✓")} ${chalk.default.bold(agent.label)} — ${count} skills installed to ${chalk.default.gray(agent.targetDir)}`);
1764
- }
1765
- console.log("");
1766
- console.log(chalk.default.gray(" Skills are project-local. Commit them to share with your team."));
1767
- console.log(chalk.default.gray(" Re-run this command anytime to update to the latest skills."));
1768
- console.log("");
1769
- }
1770
- function printSkillsHelp() {
1771
- console.log(`
1772
- ${chalk.default.bold("rebase skills")} — Manage AI agent skills
1773
-
1774
- ${chalk.default.green.bold("Usage")}
1775
- rebase skills ${chalk.default.blue("<subcommand>")}
1776
-
1777
- ${chalk.default.green.bold("Subcommands")}
1778
- ${chalk.default.blue.bold("install")} Install Rebase agent skills for your AI coding assistant
1779
- Supports: Cursor, Claude Code, Windsurf, Gemini CLI, Antigravity
1780
-
1781
- ${chalk.default.green.bold("Examples")}
1782
- ${chalk.default.cyan("rebase skills install")}
1783
- `);
1784
- }
1785
- //#endregion
1786
- //#region src/cli.ts
1787
- var __filename = (0, url.fileURLToPath)({}.url);
1788
- var __dirname = path.default.dirname(__filename);
1789
- function getVersion() {
1790
- try {
1791
- const pkgPath = path.default.resolve(__dirname, "../package.json");
1792
- if (fs.default.existsSync(pkgPath)) return JSON.parse(fs.default.readFileSync(pkgPath, "utf-8")).version;
1793
- } catch {}
1794
- return "unknown";
1795
- }
1796
- async function entry(args) {
1797
- const parsedArgs = (0, arg.default)({
1798
- "--version": Boolean,
1799
- "--help": Boolean,
1800
- "-v": "--version",
1801
- "-h": "--help"
1802
- }, {
1803
- argv: args.slice(2),
1804
- permissive: true
1805
- });
1806
- if (parsedArgs["--version"]) {
1807
- console.log(getVersion());
1808
- return;
1809
- }
1810
- const command = parsedArgs._[0];
1811
- const subcommand = parsedArgs._[1];
1812
- if (!command || parsedArgs["--help"] && ![
1813
- "schema",
1814
- "db",
1815
- "dev",
1816
- "build",
1817
- "start",
1818
- "auth",
1819
- "doctor",
1820
- "skills"
1821
- ].includes(command)) {
1822
- printHelp();
1823
- return;
1824
- }
1825
- const effectiveSubcommand = parsedArgs["--help"] ? "--help" : subcommand;
1826
- switch (command) {
1827
- case "init":
1828
- await createRebaseApp(args);
1829
- break;
1830
- case "generate-sdk": {
1831
- const sdkArgs = (0, arg.default)({
1832
- "--collections-dir": String,
1833
- "--output": String,
1834
- "-c": "--collections-dir",
1835
- "-o": "--output"
1836
- }, {
1837
- argv: args.slice(3),
1838
- permissive: true
1839
- });
1840
- await generateSdkCommand({
1841
- collectionsDir: sdkArgs["--collections-dir"] || "./config/collections",
1842
- output: sdkArgs["--output"] || "./generated/sdk",
1843
- cwd: process.cwd()
1844
- });
1845
- break;
1846
- }
1847
- case "schema":
1848
- await schemaCommand(effectiveSubcommand, args);
1849
- break;
1850
- case "db":
1851
- await dbCommand(effectiveSubcommand, args);
1852
- break;
1853
- case "dev":
1854
- await devCommand(args);
1855
- break;
1856
- case "build":
1857
- await buildCommand();
1858
- break;
1859
- case "start":
1860
- await startCommand();
1861
- break;
1862
- case "auth":
1863
- await authCommand(effectiveSubcommand, args);
1864
- break;
1865
- case "doctor":
1866
- await doctorCommand(args);
1867
- break;
1868
- case "skills":
1869
- await skillsCommand(effectiveSubcommand, args);
1870
- break;
1871
- default:
1872
- console.log(chalk.default.red(`Unknown command: ${command}`));
1873
- console.log("");
1874
- printHelp();
1875
- }
1876
- }
1877
- function printHelp() {
1878
- console.log(`
1879
- ${chalk.default.bold("Rebase CLI")} — Developer tools for Rebase projects
1880
-
1881
- ${chalk.default.green.bold("Usage")}
1882
- rebase ${chalk.default.blue("<command>")} [options]
1883
-
1884
- ${chalk.default.green.bold("Commands")}
1885
- ${chalk.default.blue.bold("init")} Create a new Rebase project
1886
- ${chalk.default.blue.bold("dev")} Start the development server
1887
- ${chalk.default.blue.bold("build")} Build all workspace packages
1888
- ${chalk.default.blue.bold("start")} Start the backend server ${chalk.default.gray("(production)")}
1889
-
1890
- ${chalk.default.green.bold("Schema")}
1891
- ${chalk.default.blue.bold("schema generate")} Generate Drizzle schema from collections
1892
- ${chalk.default.blue.bold("schema introspect")} Introspect database → Rebase collections
1893
- ${chalk.default.blue.bold("schema")} ${chalk.default.gray("--help")} Show schema command help
1894
-
1895
- ${chalk.default.green.bold("Database")}
1896
- ${chalk.default.blue.bold("db push")} Apply schema directly to database ${chalk.default.gray("(dev)")}
1897
- ${chalk.default.blue.bold("db generate")} Generate SQL migration files
1898
- ${chalk.default.blue.bold("db migrate")} Run pending migrations
1899
- ${chalk.default.blue.bold("db studio")} Open Drizzle Studio
1900
- ${chalk.default.blue.bold("db")} ${chalk.default.gray("--help")} Show database command help
1901
-
1902
- ${chalk.default.green.bold("SDK")}
1903
- ${chalk.default.blue.bold("generate-sdk")} Generate a typed JS SDK from collections
1904
-
1905
- ${chalk.default.green.bold("Auth")}
1906
- ${chalk.default.blue.bold("auth reset-password")} Reset a user's password
1907
- ${chalk.default.blue.bold("auth")} ${chalk.default.gray("--help")} Show auth command help
1908
-
1909
- ${chalk.default.green.bold("Diagnostics")}
1910
- ${chalk.default.blue.bold("doctor")} Detect schema drift between collections, schema, and DB
1911
-
1912
- ${chalk.default.green.bold("AI Agent Skills")}
1913
- ${chalk.default.blue.bold("skills install")} Install Rebase agent skills for your AI coding assistant
1914
-
1915
- ${chalk.default.green.bold("Options")}
1916
- ${chalk.default.blue("--version, -v")} Show version number
1917
- ${chalk.default.blue("--help, -h")} Show this help message
1918
-
1919
- ${chalk.default.gray("Documentation: https://rebase.pro/docs")}
1920
- `);
1921
- }
1922
- //#endregion
1923
- exports.authCommand = authCommand;
1924
- exports.buildCommand = buildCommand;
1925
- exports.configureEnvFile = configureEnvFile;
1926
- exports.createRebaseApp = createRebaseApp;
1927
- exports.dbCommand = dbCommand;
1928
- exports.detectPackageManager = detectPackageManager;
1929
- exports.devCommand = devCommand;
1930
- exports.doctorCommand = doctorCommand;
1931
- exports.entry = entry;
1932
- exports.findBackendDir = findBackendDir;
1933
- exports.findEnvFile = findEnvFile;
1934
- exports.findFrontendDir = findFrontendDir;
1935
- exports.findProjectRoot = findProjectRoot;
1936
- exports.generateSdkCommand = generateSdkCommand;
1937
- exports.getActiveBackendPlugin = getActiveBackendPlugin;
1938
- exports.getPMCommands = getPMCommands;
1939
- exports.requireBackendDir = requireBackendDir;
1940
- exports.requireProjectRoot = requireProjectRoot;
1941
- exports.resolveLocalBin = resolveLocalBin;
1942
- exports.resolvePluginCliScript = resolvePluginCliScript;
1943
- exports.resolveTsx = resolveTsx;
1944
- exports.schemaCommand = schemaCommand;
1945
- exports.startCommand = startCommand;
1946
- });
1947
-
1948
- //# sourceMappingURL=index.cjs.map