@flaredev/cli 0.1.1 → 0.1.2

package/README.md

@@ -1,47 +1,47 @@
-# @flaredev/cli
-
-The `flare` command for [Flare](https://flare-docs.codetotech.com), a
-batteries-included fullstack framework on Cloudflare Workers (vinext, D1,
-Drizzle, Better Auth, R2). It scaffolds apps, generates resources with an admin
-dashboard and REST API, runs migrations and deploys.
-
-## Install
-
-```sh
-npm install -g @flaredev/cli     # or: pnpm add -g @flaredev/cli
-```
-
-Or with the install scripts (they check for Node.js 22+ and use npm or pnpm):
-
-```sh
-# macOS / Linux
-curl -fsSL https://flare-docs.codetotech.com/install.sh | bash
-```
-
-```powershell
-# Windows PowerShell
-irm https://flare-docs.codetotech.com/install.ps1 | iex
-```
-
-Or skip the install entirely:
-
-```sh
-npm create flare-framework@latest my-app
-npx @flaredev/cli create my-app
-```
-
-## Use
-
-```sh
-flare create shop
-cd shop
-flare gen resource Product --fields "name:string, price:int, sku:string!"
-flare migrate
-flare dev
-flare deploy
-```
-
-Run `flare --help` for every command, or read the
-[CLI reference](https://flare-docs.codetotech.com/reference/cli/).
-
-Requires Node.js 22 or later.
+# @flaredev/cli
+
+The `flare` command for [Flare](https://flare-docs.codetotech.com), a
+batteries-included fullstack framework on Cloudflare Workers (vinext, D1,
+Drizzle, Better Auth, R2). It scaffolds apps, generates resources with an admin
+dashboard and REST API, runs migrations and deploys.
+
+## Install
+
+```sh
+npm install -g @flaredev/cli     # or: pnpm add -g @flaredev/cli
+```
+
+Or with the install scripts (they check for Node.js 22+ and use npm or pnpm):
+
+```sh
+# macOS / Linux
+curl -fsSL https://flare-docs.codetotech.com/install.sh | bash
+```
+
+```powershell
+# Windows PowerShell
+irm https://flare-docs.codetotech.com/install.ps1 | iex
+```
+
+Or skip the install entirely:
+
+```sh
+npm create flare-framework@latest my-app
+npx @flaredev/cli create my-app
+```
+
+## Use
+
+```sh
+flare create shop
+cd shop
+flare gen resource Product --fields 'name:string, price:int, sku:string!'
+flare migrate
+flare dev
+flare deploy
+```
+
+Run `flare --help` for every command, or read the
+[CLI reference](https://flare-docs.codetotech.com/reference/cli/).
+
+Requires Node.js 22 or later.

package/dist/index.js

@@ -157,6 +157,15 @@ function childEnv(env = process.env) {
   }
   return next;
 }
+function runQuiet(command, args, cwd) {
+  const env = childEnv();
+  const result = process.platform === "win32" ? spawnSync([command, ...args].join(" "), { cwd, env, shell: true, encoding: "utf8" }) : spawnSync(command, args, { cwd, env, encoding: "utf8" });
+  return { code: result.status ?? 1, output: `${result.stdout ?? ""}${result.stderr ?? ""}` };
+}
+function installArgs(pm) {
+  if (pm === "npm") return ["install", "--no-audit", "--no-fund", "--loglevel=error"];
+  return ["install"];
+}
 
 // src/commands/create.ts
 function toAppName(dir) {
@@ -221,24 +230,42 @@ ${devVarsEntries(authProviders)}`
   if (packageManager === "pnpm" && !inWorkspace) {
     writeFileSync2(join2(dir, "pnpm-workspace.yaml"), "allowBuilds:\n  esbuild: true\n  workerd: true\n  sharp: false\n");
   }
+  const log = options2.log ?? ((message) => console.log(message));
   if (options2.install !== false) {
-    const code = run(packageManager, ["install"], dir);
+    log(`${pc.green("\u2714")} Wrote the app to ${relative(process.cwd(), dir) || "."}`);
+    log(`${pc.cyan("\u25CF")} Installing dependencies with ${packageManager}. The first install downloads the Workers runtime and toolchain, so it can take a few minutes.
+`);
+    const started = Date.now();
+    const code = run(packageManager, installArgs(packageManager), dir);
     if (code !== 0) throw new Error(`${packageManager} install failed (exit code ${code}).`);
-    const typegen = run(packageManager, ["run", "cf-typegen"], dir);
-    if (typegen !== 0) throw new Error(`wrangler types failed (exit code ${typegen}).`);
+    log(`${pc.green("\u2714")} Installed dependencies ${pc.dim(`(${formatDuration(Date.now() - started)})`)}`);
+    const typegen = runQuiet(packageManager, ["run", "cf-typegen"], dir);
+    if (typegen.code !== 0) {
+      process.stderr.write(typegen.output);
+      throw new Error(`wrangler types failed (exit code ${typegen.code}).`);
+    }
+    log(`${pc.green("\u2714")} Generated types for the Cloudflare bindings`);
   }
   return { dir, name, packageManager, inWorkspace };
 }
+function formatDuration(ms) {
+  const seconds = Math.round(ms / 1e3);
+  return seconds < 60 ? `${seconds}s` : `${Math.floor(seconds / 60)}m ${String(seconds % 60).padStart(2, "0")}s`;
+}
 function printNextSteps(result, installed) {
   const rel = relative(process.cwd(), result.dir) || ".";
   const pm = result.packageManager;
+  const step = (command, note) => `  ${command.padEnd(30)}${pc.dim(note)}`;
   console.log(`
-${pc.green("\u2714")} Created ${pc.bold(result.name)} in ${rel}
+${pc.green("\u2714")} Created ${pc.bold(result.name)}
 `);
   console.log("Next steps:");
   console.log(`  cd ${rel}`);
   if (!installed) console.log(`  ${pm} install`);
-  console.log(`  ${pm} run dev`);
+  console.log(step(`${pm} run dev`, "start it at http://localhost:3000"));
+  console.log(step("npx flare gen resource ...", "add your first resource"));
+  console.log(`
+Quickstart: ${pc.cyan("https://flare-docs.codetotech.com/start/quickstart/")}`);
 }
 
 // src/commands/gen-billing.ts
@@ -3760,7 +3787,7 @@ function createCli() {
     const result = createApp(dir, { pm: options2.pm, install, authProviders: options2.authProviders });
     printNextSteps(result, install);
   });
-  cli.command("gen <generator> [name]", "Generate code. Generators: resource, migration, policy, billing, security").option("--fields <fields>", 'resource: fields, e.g. "name:string, email:string!, status:enum(lead,customer)"').option("--force", "resource/policy/billing/security: overwrite hand-edited generated blocks").option("--from-schema", "migration: diff the current tables instead of a blank migration").option("--roles <roles>", "policy: roles allowed to read, create and update, e.g. admin,staff").option("--delete-roles <roles>", "policy: roles allowed to delete (default: the first --roles entry)").option("--provider <provider>", "billing: payment provider (default: stripe)").option("--mode <mode>", "billing: subscriptions (the default; includes one-time checkout)").option("--skip-install", "billing: write files without installing the stripe dependency").option("--skip-migration", "billing/security: skip generating the schema migration").example('flare gen resource Contact --fields "name:string, email:string!, company:belongsTo(Company)?"').example("flare gen migration backfill_contact_status").example("flare gen migration add_phone_to_contacts --from-schema").example("flare gen policy Invoice --roles admin,staff --delete-roles admin").example("flare gen billing --provider stripe --mode subscriptions").example("flare gen security").action(
+  cli.command("gen <generator> [name]", "Generate code. Generators: resource, migration, policy, billing, security").option("--fields <fields>", "resource: fields, e.g. 'name:string, email:string!, status:enum(lead,customer)' (single quotes: bash treats ! in double quotes as history)").option("--force", "resource/policy/billing/security: overwrite hand-edited generated blocks").option("--from-schema", "migration: diff the current tables instead of a blank migration").option("--roles <roles>", "policy: roles allowed to read, create and update, e.g. admin,staff").option("--delete-roles <roles>", "policy: roles allowed to delete (default: the first --roles entry)").option("--provider <provider>", "billing: payment provider (default: stripe)").option("--mode <mode>", "billing: subscriptions (the default; includes one-time checkout)").option("--skip-install", "billing: write files without installing the stripe dependency").option("--skip-migration", "billing/security: skip generating the schema migration").example("flare gen resource Contact --fields 'name:string, email:string!, company:belongsTo(Company)?'").example("flare gen migration backfill_contact_status").example("flare gen migration add_phone_to_contacts --from-schema").example("flare gen policy Invoice --roles admin,staff --delete-roles admin").example("flare gen billing --provider stripe --mode subscriptions").example("flare gen security").action(
     async (generator, name, options2) => {
       if (generator === "billing")
         return genBilling({ provider: options2.provider, mode: options2.mode, force: options2.force, skipInstall: options2.skipInstall, skipMigration: options2.skipMigration });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flaredev/cli",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "The flare command-line tool: create, generate, migrate, and deploy Flare apps",
   "license": "MIT",
   "author": "Muke Johnbaptist",
@@ -40,7 +40,7 @@
     "jiti": "^2.7.0",
     "jsonc-parser": "^3.3.1",
     "picocolors": "^1.1.1",
-    "@flaredev/core": "0.1.1"
+    "@flaredev/core": "0.1.2"
   },
   "engines": {
     "node": ">=22"