@farm.js/cli 0.1.0-beta.3 → 0.1.0-beta.31

package/README.md

@@ -8,4 +8,16 @@ Farm.js is currently in beta.
 npm install @farm.js/cli@beta
 ```
 
+Upgrade every published `@farm.js/*` dependency in an app to one release channel:
+
+```bash
+farm upgrade --latest
+farm upgrade --beta
+farm upgrade --latest --dry-run
+```
+
+`--latest` selects the newest stable release. `--beta` selects the newest beta release. The CLI
+detects npm, pnpm, Yarn, or Bun from the project and leaves `workspace:`, `file:`, and other local
+package references unchanged.
+
 See the [Farm.js repository](https://github.com/farming-labs/farm.js) for documentation, examples, and support.

package/bin/farm.js

@@ -16,14 +16,19 @@ const { program } = require("commander");
 const { version } = require("../package.json");
 
 const banner = `
- _______                         
-|  ___  |__ _ _ __ _ __ ___     
-| |_ /| / _\` | '__| '_ \` _ \\ 
-|  _ \\| | (_| | |  | | | | | |
-|_| \\_\\_|\\__,_|_|  |_| |_| |_|
+░██████████   ░███    ░█████████  ░███     ░███         ░█████   ░██████
+░██          ░██░██   ░██     ░██ ░████   ░████           ░██   ░██   ░██
+░██         ░██  ░██  ░██     ░██ ░██░██ ░██░██           ░██  ░██
+░█████████ ░█████████ ░█████████  ░██ ░████ ░██           ░██   ░████████
+░██        ░██    ░██ ░██   ░██   ░██  ░██  ░██     ░██   ░██          ░██
+░██        ░██    ░██ ░██    ░██  ░██       ░██     ░██   ░██   ░██   ░██
+░██        ░██    ░██ ░██     ░██ ░██       ░██ ░██  ░██████     ░██████
 `;
 
-program.name("farm").description("Farm.js CLI - A modern React meta-framework").version(version);
+program
+  .name("farm")
+  .description("Farm.js CLI - A framework for product-integrated apps")
+  .version(version);
 program.addHelpText("beforeAll", `${banner}\n`);
 
 function collectOption(value, previous) {
@@ -33,7 +38,7 @@ function collectOption(value, previous) {
 program
   .command("dev")
   .description("Start development server")
-  .option("-p, --port <port>", "Port to run the server on", "3000")
+  .option("-p, --port <port>", "Override the port to run the server on")
   .option("-r, --root <root>", "Root directory", process.cwd())
   .option("--cron", "Run configured cron routes in-process during development")
   .action(async (options) => {
@@ -43,12 +48,12 @@ program
         {
           root: options.root,
         },
-        parseInt(options.port),
+        options.port === undefined ? undefined : parseInt(options.port, 10),
       );
       if (options.cron) {
         const { startFarmCronScheduler } = require("../dist/index.js");
         const address = server.httpServer?.address();
-        const port = typeof address === "object" && address ? address.port : parseInt(options.port);
+        const port = typeof address === "object" && address ? address.port : 3000;
         const scheduler = await startFarmCronScheduler({
           root: options.root,
           url: `http://localhost:${port}`,
@@ -80,6 +85,59 @@ program
     }
   });
 
+const authCommand = program.command("auth").description("Manage Farm-native authentication");
+
+authCommand
+  .command("migrate")
+  .description("Create or update the Farm Auth database schema")
+  .option("-r, --root <root>", "Root directory", process.cwd())
+  .option("-c, --config <config>", "Path to farm config file")
+  .action(async (options) => {
+    try {
+      const { migrateFarmAuth } = require("../dist/index.js");
+      await migrateFarmAuth({
+        root: options.root,
+        configPath: options.config,
+      });
+    } catch (error) {
+      console.error("Failed to migrate Farm Auth:", error);
+      process.exit(1);
+    }
+  });
+
+program
+  .command("upgrade")
+  .description("Upgrade installed Farm.js packages to a stable or beta release")
+  .option("-r, --root <root>", "Project root", process.cwd())
+  .option("--latest", "Upgrade to the latest stable release")
+  .option("--beta", "Upgrade to the latest beta release")
+  .option("--dry-run", "Print the package-manager commands without installing")
+  .action(async (options) => {
+    try {
+      if (options.latest === options.beta) {
+        throw new Error("Choose exactly one release channel: --latest (stable) or --beta.");
+      }
+
+      const { formatFarmUpgradePlan, upgradeFarm } = require("../dist/index.js");
+      const result = await upgradeFarm({
+        root: options.root,
+        channel: options.beta ? "beta" : "latest",
+        dryRun: options.dryRun,
+      });
+      console.log(formatFarmUpgradePlan(result.plan));
+      console.log(
+        result.executed
+          ? `Upgraded ${result.plan.packages.length} Farm package${
+              result.plan.packages.length === 1 ? "" : "s"
+            } to ${result.plan.channel}.`
+          : "Dry run only. No packages were changed.",
+      );
+    } catch (error) {
+      console.error("Failed to upgrade Farm packages:", error);
+      process.exit(1);
+    }
+  });
+
 program
   .command("generate")
   .description("Generate route/API types and integration schema artifacts")
@@ -91,6 +149,7 @@ program
   )
   .option("--dialect <dialect>", "SQL dialect for Drizzle generation (postgres, mysql, sqlite)")
   .option("-o, --output <output>", "Custom output path")
+  .option("--check", "Fail when committed generated framework types are stale")
   .action(async (options) => {
     try {
       const { generateFarmArtifacts } = require("../dist/index.js");
@@ -100,6 +159,7 @@ program
         orm: options.orm,
         dialect: options.dialect,
         output: options.output,
+        check: options.check,
       });
     } catch (error) {
       console.error("Failed to generate Farm artifacts:", error);
@@ -116,6 +176,7 @@ program
   .option("--host <host>", "Host of a running local app")
   .option("--url <url>", "Base URL of a running Farm app")
   .option("--offline", "Inspect project files without probing a running app")
+  .option("--fix", "Apply safe additive corrections without overwriting application files")
   .option("--timeout <ms>", "Live runtime probe timeout in milliseconds", "1200")
   .option("--json", "Print machine-readable JSON")
   .action(async (options) => {
@@ -132,6 +193,7 @@ program
         host: options.host,
         url: options.url,
         offline: options.offline,
+        fix: options.fix,
         timeoutMs,
       });
       console.log(options.json ? JSON.stringify(report, null, 2) : formatFarmDoctorReport(report));
@@ -142,6 +204,30 @@ program
     }
   });
 
+program
+  .command("explain <path>")
+  .description("Explain how a URL maps to a Farm route and deployment runtime")
+  .option("-r, --root <root>", "Root directory", process.cwd())
+  .option("-c, --config <config>", "Path to farm config file")
+  .option("--json", "Print machine-readable JSON")
+  .action(async (pathname, options) => {
+    try {
+      const { explainFarmRoute, formatFarmRouteExplanation } = require("../dist/index.js");
+      const explanation = await explainFarmRoute(pathname, {
+        root: options.root,
+        configPath: options.config,
+      });
+      console.log(
+        options.json
+          ? JSON.stringify(explanation, null, 2)
+          : formatFarmRouteExplanation(explanation),
+      );
+    } catch (error) {
+      console.error("Failed to explain Farm route:", error);
+      process.exit(1);
+    }
+  });
+
 program
   .command("preview")
   .description("Create a public URL for a running local Farm app")
@@ -380,14 +466,17 @@ program
   .option("--cloudflare", "Deploy to Cloudflare")
   .option("--netlify", "Deploy to Netlify")
   .option("--prod", "Deploy to production (Vercel: uses prebuilt output)")
+  .option("--plan", "Print the resolved deployment plan without building or deploying")
   .option("--custom", "Use your own credentials (not Farm.js managed)")
   .action(async (options) => {
     try {
       const { deployFarm } = require("../dist/index.js");
       await deployFarm(options);
     } catch (error) {
-      console.error("Failed to deploy:", error);
-      process.exit(1);
+      const code = error?.name === "FarmDeployError" ? ` [${error.code}]` : "";
+      const message = error instanceof Error ? error.message : String(error);
+      console.error(`Failed to deploy${code}: ${message}`);
+      process.exitCode = 1;
     }
   });