@flight-framework/cli 0.0.16 → 0.2.0

package/dist/index.js

@@ -8,7 +8,7 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 
 // src/index.ts
 import { cac } from "cac";
-import pc5 from "picocolors";
+import pc6 from "picocolors";
 
 // src/version.ts
 var VERSION = "0.0.1";
@@ -61,6 +61,21 @@ async function createCommand(name, options) {
     console.log(pc.red("Project creation cancelled."));
     return;
   }
+  if (options.raw) {
+    const projectPath2 = resolve(process.cwd(), projectName);
+    createRawProject(projectPath2, projectName, options);
+    return;
+  }
+  if (options.empty) {
+    const projectPath2 = resolve(process.cwd(), projectName);
+    createEmptyProject(projectPath2, projectName, options);
+    return;
+  }
+  if (options.minimal) {
+    const projectPath2 = resolve(process.cwd(), projectName);
+    createMinimalProject(projectPath2, projectName, options);
+    return;
+  }
   if (!uiFramework) {
     const response = await prompts({
       type: "select",
@@ -75,6 +90,9 @@ async function createCommand(name, options) {
     console.log(pc.red("Project creation cancelled."));
     return;
   }
+  let useCase = options.useCase;
+  const useCaseDir = join(TEMPLATES_DIR, "use-cases", useCase || "");
+  const isUseCase = useCase && existsSync(useCaseDir);
   let bundler = options.bundler;
   if (!bundler) {
     const response = await prompts({
@@ -110,8 +128,12 @@ async function createCommand(name, options) {
 Creating project in ${projectPath}...
 `));
   try {
-    copyTemplate(projectPath, uiFramework, bundler, projectName);
-    console.log(pc.green("\u2713") + " Project structure created");
+    if (isUseCase && useCase) {
+      copyUseCaseTemplate(projectPath, useCase, projectName);
+    } else {
+      copyTemplate(projectPath, uiFramework, bundler, projectName);
+    }
+    console.log(pc.green("[OK]") + " Project structure created");
     if (options.git) {
       try {
         execSync("git init", { cwd: projectPath, stdio: "ignore" });
@@ -179,6 +201,15 @@ function copyTemplate(projectPath, ui, bundler, projectName) {
     unlinkSync(gitignoreSrc);
   }
 }
+function copyUseCaseTemplate(projectPath, useCase, projectName) {
+  const useCaseDir = join(TEMPLATES_DIR, "use-cases", useCase);
+  mkdirSync(projectPath, { recursive: true });
+  const vars = {
+    "{{PROJECT_NAME}}": projectName,
+    "{{USE_CASE}}": useCase
+  };
+  copyDirWithTemplates(useCaseDir, projectPath, vars);
+}
 function copyDirWithTemplates(srcDir, destDir, vars) {
   if (!existsSync(srcDir)) return;
   const entries = readdirSync(srcDir, { withFileTypes: true });
@@ -205,6 +236,277 @@ function copyDirWithTemplates(srcDir, destDir, vars) {
     }
   }
 }
+function createRawProject(projectPath, projectName, options) {
+  mkdirSync(projectPath, { recursive: true });
+  const packageJson = {
+    name: projectName,
+    version: "0.0.1",
+    type: "module",
+    scripts: {
+      // Works with Bun, Node 22+, or Deno
+      "dev": "node --watch server.js",
+      "dev:bun": "bun --watch server.js",
+      "dev:deno": "deno run --allow-net server.js",
+      "start": "node server.js"
+    },
+    dependencies: {},
+    devDependencies: {}
+  };
+  writeFileSync(
+    join(projectPath, "package.json"),
+    JSON.stringify(packageJson, null, 2)
+  );
+  const serverCode = `/**
+ * ${projectName}
+ * 
+ * 100% Web Standards server. Zero dependencies. Zero lock-in.
+ * Works on: Bun, Deno, Node 22+, Cloudflare Workers
+ * 
+ * Run:
+ *   bun server.js
+ *   deno run --allow-net server.js
+ *   node server.js (Node 22+)
+ */
+
+/**
+ * Handle incoming requests using Web Standard APIs
+ * @param {Request} request
+ * @returns {Response}
+ */
+function handleRequest(request) {
+    const url = new URL(request.url);
+    const method = request.method;
+    
+    // Router
+    if (method === 'GET' && url.pathname === '/') {
+        return Response.json({
+            message: 'Hello World!',
+            runtime: detectRuntime(),
+            docs: 'https://flight.dev/docs/quickstart-http',
+        });
+    }
+    
+    if (method === 'GET' && url.pathname === '/health') {
+        return Response.json({
+            status: 'ok',
+            timestamp: Date.now(),
+        });
+    }
+    
+    if (method === 'GET' && url.pathname.startsWith('/api/')) {
+        return Response.json({
+            path: url.pathname,
+            query: Object.fromEntries(url.searchParams),
+        });
+    }
+    
+    // 404
+    return Response.json(
+        { error: 'Not Found', path: url.pathname },
+        { status: 404 }
+    );
+}
+
+/**
+ * Detect which runtime we're running on
+ */
+function detectRuntime() {
+    if (typeof Bun !== 'undefined') return 'bun';
+    if (typeof Deno !== 'undefined') return 'deno';
+    return 'node';
+}
+
+// Export for different runtimes
+const port = process.env.PORT || 3000;
+
+// Bun / Cloudflare Workers style
+export default {
+    port,
+    fetch: handleRequest,
+};
+
+// Also start server for Node.js
+if (detectRuntime() === 'node') {
+    const { serve } = await import('node:http');
+    serve({ port }, (req, res) => {
+        const url = 'http://localhost' + req.url;
+        const request = new Request(url, { method: req.method });
+        handleRequest(request).then(response => {
+            res.writeHead(response.status, Object.fromEntries(response.headers));
+            response.text().then(body => res.end(body));
+        });
+    });
+    console.log(\`Server running at http://localhost:\${port}\`);
+}
+`;
+  writeFileSync(join(projectPath, "server.js"), serverCode);
+  if (options.git) {
+    writeFileSync(
+      join(projectPath, ".gitignore"),
+      "node_modules\ndist\n.env\n.env.local\n"
+    );
+    try {
+      execSync("git init", { cwd: projectPath, stdio: "ignore" });
+    } catch {
+    }
+  }
+  console.log(`
+${pc.green("[OK] Raw project created!")}
+
+${pc.bold("ZERO dependencies. ZERO lock-in. 100% Web Standards.")}
+
+${pc.cyan("Run with any runtime:")}
+
+  ${pc.dim("# Bun (fastest)")}
+  bun server.js
+
+  ${pc.dim("# Deno")}
+  deno run --allow-net server.js
+
+  ${pc.dim("# Node.js 22+")}
+  node server.js
+
+${pc.dim("Want to add Flight later? Just run:")}
+  flight add http    ${pc.dim("# HTTP server with routing")}
+  flight add db      ${pc.dim("# Database abstraction")}
+  flight add cache   ${pc.dim("# Caching layer")}
+
+${pc.dim("Path:")} ${projectPath}
+`);
+}
+function createEmptyProject(projectPath, projectName, options) {
+  mkdirSync(projectPath, { recursive: true });
+  const packageJson = {
+    name: projectName,
+    version: "0.0.1",
+    type: "module",
+    scripts: {
+      dev: "node server.js"
+    },
+    dependencies: {},
+    devDependencies: {}
+  };
+  writeFileSync(
+    join(projectPath, "package.json"),
+    JSON.stringify(packageJson, null, 2)
+  );
+  if (options.git) {
+    writeFileSync(
+      join(projectPath, ".gitignore"),
+      "node_modules\ndist\n.env\n.env.local\n"
+    );
+    try {
+      execSync("git init", { cwd: projectPath, stdio: "ignore" });
+    } catch {
+    }
+  }
+  console.log(`
+${pc.green("[OK] Empty project created!")}
+
+${pc.cyan("Your project is a blank canvas.")} Add what you need:
+
+  ${pc.dim("# HTTP server")}
+  npm install @flight-framework/http
+
+  ${pc.dim("# Database")}
+  npm install @flight-framework/db
+
+  ${pc.dim("# Cache")}
+  npm install @flight-framework/cache
+
+  ${pc.dim("# Authentication")}
+  npm install @flight-framework/auth
+
+${pc.dim("Path:")} ${projectPath}
+`);
+}
+function createMinimalProject(projectPath, projectName, options) {
+  mkdirSync(projectPath, { recursive: true });
+  const packageJson = {
+    name: projectName,
+    version: "0.0.1",
+    type: "module",
+    scripts: {
+      dev: "node --watch server.js",
+      start: "node server.js"
+    },
+    dependencies: {
+      "@flight-framework/http": "^0.0.1"
+    }
+  };
+  writeFileSync(
+    join(projectPath, "package.json"),
+    JSON.stringify(packageJson, null, 2)
+  );
+  const serverCode = `/**
+ * ${projectName} - Built with Flight
+ * 
+ * This is a minimal Flight server. Add more as you need.
+ * Run: npm run dev
+ */
+
+import { createServer } from '@flight-framework/http';
+
+const app = createServer();
+
+// Your routes
+app.get('/', (c) => c.json({ 
+    message: 'Hello from Flight!',
+    docs: 'https://flight.dev/docs/quickstart-http'
+}));
+
+app.get('/health', (c) => c.json({ 
+    status: 'ok', 
+    timestamp: Date.now() 
+}));
+
+// Start server
+const port = process.env.PORT || 3000;
+console.log(\`Server running at http://localhost:\${port}\`);
+
+export default { port, fetch: app.fetch };
+`;
+  writeFileSync(join(projectPath, "server.js"), serverCode);
+  if (options.git) {
+    writeFileSync(
+      join(projectPath, ".gitignore"),
+      "node_modules\ndist\n.env\n.env.local\n"
+    );
+    try {
+      execSync("git init", { cwd: projectPath, stdio: "ignore" });
+    } catch {
+    }
+  }
+  if (options.install) {
+    console.log(pc.dim("\\nInstalling dependencies...\\n"));
+    try {
+      const pm = detectPackageManager();
+      execSync(`${pm} install`, { cwd: projectPath, stdio: "inherit" });
+    } catch {
+    }
+  }
+  console.log(`
+${pc.green("[OK] Minimal project created!")}
+
+${pc.cyan("Next steps:")}
+
+  ${pc.dim("$")} cd ${projectName}
+  ${pc.dim("$")} ${options.install ? "" : "npm install && "}npm run dev
+
+${pc.dim("Add more features as needed:")}
+
+  ${pc.dim("# File-based routing")}
+  npm install @flight-framework/core
+
+  ${pc.dim("# Database")}
+  npm install @flight-framework/db pg
+
+  ${pc.dim("# Caching")}
+  npm install @flight-framework/cache
+
+${pc.cyan("Happy flying!")}
+`);
+}
 
 // src/commands/dev.ts
 import { resolve as resolve2, join as join2 } from "path";
@@ -1294,25 +1596,234 @@ async function typesGenerateCommand(options = {}) {
   }
 }
 
+// src/commands/add.ts
+import { existsSync as existsSync6 } from "fs";
+import { join as join5 } from "path";
+import { execSync as execSync2 } from "child_process";
+import pc5 from "picocolors";
+var PACKAGES = {
+  // Core
+  "http": {
+    name: "@flight-framework/http",
+    description: "HTTP server with routing and middleware",
+    category: "core"
+  },
+  "core": {
+    name: "@flight-framework/core",
+    description: "File-based routing and configuration",
+    category: "core"
+  },
+  // Data
+  "db": {
+    name: "@flight-framework/db",
+    description: "Database abstraction layer",
+    category: "data",
+    drivers: ["pg", "@libsql/client", "@neondatabase/serverless", "@supabase/supabase-js"]
+  },
+  "cache": {
+    name: "@flight-framework/cache",
+    description: "Caching with multiple adapters",
+    category: "data"
+  },
+  // Auth
+  "auth": {
+    name: "@flight-framework/auth",
+    description: "Authentication adapters",
+    category: "auth"
+  },
+  // Frontend
+  "forms": {
+    name: "@flight-framework/forms",
+    description: "Type-safe form handling",
+    category: "frontend"
+  },
+  "i18n": {
+    name: "@flight-framework/i18n",
+    description: "Internationalization",
+    category: "frontend"
+  },
+  "seo": {
+    name: "@flight-framework/seo",
+    description: "SEO utilities",
+    category: "frontend"
+  },
+  "image": {
+    name: "@flight-framework/image",
+    description: "Image optimization",
+    category: "frontend"
+  },
+  // Communication
+  "email": {
+    name: "@flight-framework/email",
+    description: "Email sending",
+    category: "communication"
+  },
+  "realtime": {
+    name: "@flight-framework/realtime",
+    description: "WebSocket and real-time features",
+    category: "communication"
+  },
+  // Deployment
+  "helpers": {
+    name: "@flight-framework/helpers",
+    description: "Optional helper utilities (detection, suggestions)",
+    category: "utilities"
+  }
+};
+async function addCommand(packageName) {
+  const cwd = process.cwd();
+  if (!existsSync6(join5(cwd, "package.json"))) {
+    console.log(pc5.red("No package.json found. Run this command from your project directory."));
+    process.exit(1);
+  }
+  if (!packageName) {
+    showAvailablePackages();
+    return;
+  }
+  const pkg = PACKAGES[packageName];
+  if (!pkg) {
+    console.log(pc5.red(`Unknown package: ${packageName}`));
+    console.log(pc5.dim("Run `flight add` to see available packages."));
+    process.exit(1);
+  }
+  console.log(`
+${pc5.cyan("Adding")} ${pc5.bold(pkg.name)}...`);
+  console.log(pc5.dim(pkg.description));
+  console.log();
+  const pm = detectPackageManager2();
+  try {
+    const installCmd = pm === "npm" ? "npm install" : `${pm} add`;
+    execSync2(`${installCmd} ${pkg.name}`, { cwd, stdio: "inherit" });
+    console.log(`
+${pc5.green("[OK]")} ${pkg.name} added successfully!`);
+    showNextSteps(packageName, pkg);
+  } catch (error) {
+    console.log(pc5.red(`
+Failed to install ${pkg.name}`));
+    process.exit(1);
+  }
+}
+function detectPackageManager2() {
+  const cwd = process.cwd();
+  if (existsSync6(join5(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync6(join5(cwd, "yarn.lock"))) return "yarn";
+  if (existsSync6(join5(cwd, "bun.lockb"))) return "bun";
+  return "npm";
+}
+function showAvailablePackages() {
+  console.log(`
+${pc5.cyan("Available Flight packages:")}
+
+${pc5.bold("Core")}
+  ${pc5.green("http")}      ${pc5.dim("HTTP server with routing and middleware")}
+  ${pc5.green("core")}      ${pc5.dim("File-based routing and configuration")}
+
+${pc5.bold("Data")}
+  ${pc5.green("db")}        ${pc5.dim("Database abstraction layer")}
+  ${pc5.green("cache")}     ${pc5.dim("Caching with multiple adapters")}
+
+${pc5.bold("Auth")}
+  ${pc5.green("auth")}      ${pc5.dim("Authentication adapters")}
+
+${pc5.bold("Frontend")}
+  ${pc5.green("forms")}     ${pc5.dim("Type-safe form handling")}
+  ${pc5.green("i18n")}      ${pc5.dim("Internationalization")}
+  ${pc5.green("seo")}       ${pc5.dim("SEO utilities")}
+  ${pc5.green("image")}     ${pc5.dim("Image optimization")}
+
+${pc5.bold("Communication")}
+  ${pc5.green("email")}     ${pc5.dim("Email sending")}
+  ${pc5.green("realtime")}  ${pc5.dim("WebSocket and real-time features")}
+
+${pc5.bold("Utilities")}
+  ${pc5.green("helpers")}   ${pc5.dim("Optional helper utilities")}
+
+${pc5.cyan("Usage:")}
+  flight add http
+  flight add db
+  flight add auth
+`);
+}
+function showNextSteps(packageName, pkg) {
+  const examples = {
+    "http": `
+${pc5.cyan("Quick example:")}
+
+  import { createServer } from '@flight-framework/http';
+  
+  const app = createServer();
+  app.get('/', (c) => c.json({ hello: 'world' }));
+  
+  export default { port: 3000, fetch: app.fetch };
+`,
+    "db": `
+${pc5.cyan("Quick example:")}
+
+  import { createDb } from '@flight-framework/db';
+  import { postgres } from '@flight-framework/db/postgres';
+  
+  const db = createDb(postgres({ connectionString: process.env.DATABASE_URL }));
+  const users = await db.query('SELECT * FROM users');
+
+${pc5.dim("You may also need a driver:")}
+  npm install pg                    ${pc5.dim("# PostgreSQL")}
+  npm install @libsql/client        ${pc5.dim("# Turso/SQLite")}
+  npm install @neondatabase/serverless  ${pc5.dim("# Neon")}
+`,
+    "cache": `
+${pc5.cyan("Quick example:")}
+
+  import { createCache, lru } from '@flight-framework/cache';
+  
+  const cache = createCache(lru({ max: 1000 }));
+  await cache.set('key', { data: 'value' });
+  const value = await cache.get('key');
+`,
+    "auth": `
+${pc5.cyan("Quick example:")}
+
+  import { createAuth } from '@flight-framework/auth';
+  import { betterAuth } from '@flight-framework/auth/better-auth';
+  
+  const auth = createAuth(betterAuth({ db }));
+  const user = await auth.getUser(request);
+`,
+    "forms": `
+${pc5.cyan("Quick example:")}
+
+  import { createForm } from '@flight-framework/forms';
+  import { zodAdapter } from '@flight-framework/forms/adapters/zod';
+  
+  const form = createForm({ schema: zodAdapter(schema) });
+  const result = form.validate(data);
+`
+  };
+  if (examples[packageName]) {
+    console.log(examples[packageName]);
+  }
+  console.log(`${pc5.dim("Docs:")} https://flight.dev/docs/packages/${packageName}`);
+}
+
 // src/index.ts
 var cli = cac("flight");
 var LOGO = `
-${pc5.cyan("  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557     \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557")}
-${pc5.cyan("  \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D \u2588\u2588\u2551  \u2588\u2588\u2551\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D")}
-${pc5.cyan("  \u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551   \u2588\u2588\u2551   ")}
-${pc5.cyan("  \u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551   \u2588\u2588\u2551   ")}
-${pc5.cyan("  \u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551  \u2588\u2588\u2551   \u2588\u2588\u2551   ")}
-${pc5.cyan("  \u255A\u2550\u255D     \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D  \u255A\u2550\u255D   \u255A\u2550\u255D   ")}
+${pc6.cyan("  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557     \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557")}
+${pc6.cyan("  \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D \u2588\u2588\u2551  \u2588\u2588\u2551\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D")}
+${pc6.cyan("  \u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551   \u2588\u2588\u2551   ")}
+${pc6.cyan("  \u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551   \u2588\u2588\u2551   ")}
+${pc6.cyan("  \u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551  \u2588\u2588\u2551   \u2588\u2588\u2551   ")}
+${pc6.cyan("  \u255A\u2550\u255D     \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D  \u255A\u2550\u255D   \u255A\u2550\u255D   ")}
   
-  ${pc5.dim("The Agnostic Full-Stack Framework")}
-  ${pc5.dim("Maximum Flexibility. Zero Lock-in.")}
+  ${pc6.dim("The Agnostic Full-Stack Framework")}
+  ${pc6.dim("Maximum Flexibility. Zero Lock-in.")}
 `;
 function printLogo() {
   console.log(LOGO);
 }
 cli.version(VERSION);
 cli.help();
-cli.command("create [name]", "Create a new Flight project").option("-t, --template <template>", "Project template to use", { default: "basic" }).option("--ui <framework>", "UI framework (react, vue, svelte, solid, vanilla)").option("--ts", "Use TypeScript", { default: true }).option("--git", "Initialize git repository", { default: true }).option("--install", "Install dependencies", { default: true }).action(createCommand);
+cli.command("create [name]", "Create a new Flight project").option("-t, --template <template>", "Project template to use", { default: "basic" }).option("--ui <framework>", "UI framework (react, vue, svelte, solid, vanilla)").option("--use-case <useCase>", "Use-case template (blog, ecommerce, saas, api, docs)").option("--ts", "Use TypeScript", { default: true }).option("--git", "Initialize git repository", { default: true }).option("--install", "Install dependencies", { default: true }).option("--raw", "Create raw project (100% Web Standards, zero dependencies)").option("--empty", "Create empty project (just package.json)").option("--minimal", "Create minimal project (single server file with Flight)").action(createCommand);
+cli.command("add [package]", "Add a Flight package to your project").action(addCommand);
 cli.command("dev", "Start development server").option("-p, --port <port>", "Port to listen on").option("-h, --host <host>", "Host to bind to").option("--open", "Open browser on start").option("--https", "Enable HTTPS").option("--ssr", "Enable Server-Side Rendering").action(devCommand);
 cli.command("build", "Build for production").option("--outDir <dir>", "Output directory").option("--sourcemap", "Generate source maps").option("--minify", "Minify output", { default: true }).action(buildCommand);
 cli.command("preview", "Preview production build").option("-p, --port <port>", "Port to listen on").option("-h, --host <host>", "Host to bind to").option("--open", "Open browser on start").action(previewCommand);
@@ -1326,7 +1837,7 @@ function run() {
     }
     cli.runMatchedCommand();
   } catch (error) {
-    console.error(pc5.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc6.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 }