fastnode-cli 0.1.0

package/README.md

@@ -0,0 +1,108 @@
+# 🧪 fastnode-cli
+
+**The official CLI tool for scaffolding and managing FastNode projects** — bringing the simplicity of FastAPI to the Node.js ecosystem with NestJS under the hood.
+
+---
+
+## 🚀 Features
+
+- 📦 Instantly scaffold a FastNode-based project
+- 🧱 Generate modules, services, controllers, and more
+- ⚙️ Built-in support for TypeScript
+- 📂 Clean project structure inspired by FastAPI
+- 🧪 Easy to extend and integrate with `fastnode-core`
+
+---
+
+## 📦 Installation
+
+```bash
+npm install -g fastnode-cli
+```
+
+---
+
+## 🛠️ Usage
+
+### Create a new project
+
+```bash
+fastnode new my-app
+```
+
+This creates a new FastNode project in the `my-app` folder.
+
+### Generate a module
+
+```bash
+fastnode generate module user
+```
+
+Creates a `user` module with its own folder, service, and controller.
+
+### Generate a service
+
+```bash
+fastnode generate service auth
+```
+
+### Generate a controller
+
+```bash
+fastnode generate controller auth
+```
+
+---
+
+## 📁 Folder Structure
+
+Here’s what a typical FastNode project looks like:
+
+```
+src/
+├── app.module.ts
+├── main.ts
+└── modules/
+    ├── user/
+    │   ├── user.controller.ts
+    │   ├── user.module.ts
+    │   └── user.service.ts
+```
+
+---
+
+## 🔧 Configuration
+
+You can customize the CLI's behavior with a `.fastnoderc` config file (coming soon).
+
+---
+
+## 📚 Documentation
+
+See the core framework:  
+👉 [`fastnode-core`](https://www.npmjs.com/package/fastnode-core)
+
+---
+
+## 🤝 Contributing
+
+Pull requests are welcome! Please open an issue first to discuss what you’d like to change.
+
+---
+
+## 📄 License
+
+MIT License
+
+---
+
+## 💡 Inspiration
+
+Inspired by how fast and intuitive **FastAPI** is for Python developers, `fastnode` aims to bring that same DX (developer experience) to the **Node.js/NestJS** world.
+
+---
+
+## 🔗 Links
+
+- CLI: [fastnode-cli on npm](https://www.npmjs.com/package/fastnode-cli)
+- Core: [fastnode-core on npm](https://www.npmjs.com/package/fastnode-core)

package/dist/index.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const [, , command, arg] = process.argv;
+if (command === "create" && arg) {
+    const projectDir = path_1.default.resolve(arg);
+    const moduleDir = path_1.default.join(projectDir, "src", arg);
+    fs_1.default.mkdirSync(moduleDir, { recursive: true });
+    // 1️⃣ main.ts
+    const mainFile = path_1.default.join(moduleDir, "main.ts");
+    fs_1.default.writeFileSync(mainFile, `import "reflect-metadata";
+import { Controller, Get, Module, createApp } from "@fastnode/core";
+
+@Controller("/${arg}")
+class ${capitalize(arg)}Controller {
+  @Get("/")
+  hello() {
+    return { message: "Hello from ${arg}" };
+  }
+}
+
+@Module({ controllers: [${capitalize(arg)}Controller] })
+class ${capitalize(arg)}Module {}
+
+createApp([${capitalize(arg)}Module]).listen(3000);
+`);
+    // 2️⃣ tsconfig.json
+    fs_1.default.writeFileSync(path_1.default.join(projectDir, "tsconfig.json"), `{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "CommonJS",
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "strict": true,
+    "esModuleInterop": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "useDefineForClassFields": false
+  },
+  "include": ["src"]
+}
+`);
+    // 3️⃣ package.json
+    fs_1.default.writeFileSync(path_1.default.join(projectDir, "package.json"), `{
+  "name": "${arg}",
+  "version": "1.0.0",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "scripts": {
+    "dev": "tsx src/${arg}/main.ts",
+    "build": "tsc",
+    "start": "node dist/${arg}/main.js"
+  },
+  "dependencies": {
+    "@fastnode/core": "latest",
+    "reflect-metadata": "^0.1.13"
+  },
+  "devDependencies": {
+    "tsx": "^4.7.0",
+    "typescript": "^5.0.0"
+  }
+}
+`);
+    console.log(`✔ Project '${arg}' created at ${projectDir}`);
+}
+if (command === "serve" && arg) {
+    const entry = path_1.default.resolve(process.cwd(), `src/${arg}/main.ts`);
+    if (!fs_1.default.existsSync(entry)) {
+        console.error(`❌ Cannot find module at ${entry}`);
+        process.exit(1);
+    }
+    (0, child_process_1.execSync)(`npx tsx ${entry}`, { stdio: "inherit" });
+}
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "fastnode-cli",
+  "version": "0.1.0",
+  "description": "A CLI tool for generating and managing FastNode projects using NestJS, inspired by FastAPI.",
+  "bin": {
+    "fastnode": "./bin/index.js"
+  },
+  "main": "bin/index.js",
+  "type": "module",
+  "scripts": {
+    "start": "node bin/index.js"
+  },
+  "keywords": [
+    "cli",
+    "fastapi",
+    "nestjs",
+    "nodejs",
+    "scaffolding",
+    "generator",
+    "fastnode"
+  ],
+  "author": "Valentine Emmanuel Ikechukwu",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^11.0.0",
+    "chalk": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.ts

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+import { execSync } from "child_process";
+import fs from "fs";
+import path from "path";
+
+const [, , command, arg] = process.argv;
+
+if (command === "create" && arg) {
+  const projectDir = path.resolve(arg);
+  const moduleDir = path.join(projectDir, "src", arg);
+
+  fs.mkdirSync(moduleDir, { recursive: true });
+
+  // 1️⃣ main.ts
+  const mainFile = path.join(moduleDir, "main.ts");
+  fs.writeFileSync(
+    mainFile,
+    `import "reflect-metadata";
+import { Controller, Get, Module, createApp } from "fastnode-core";
+
+@Controller("/${arg}")
+class ${capitalize(arg)}Controller {
+  @Get("/")
+  hello() {
+    return { message: "Hello from ${arg}" };
+  }
+}
+
+@Module({ controllers: [${capitalize(arg)}Controller] })
+class ${capitalize(arg)}Module {}
+
+createApp([${capitalize(arg)}Module]).listen(3000);
+`
+  );
+
+  // 2️⃣ tsconfig.json
+  fs.writeFileSync(
+    path.join(projectDir, "tsconfig.json"),
+    `{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "CommonJS",
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "strict": true,
+    "esModuleInterop": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "useDefineForClassFields": false
+  },
+  "include": ["src"]
+}
+`
+  );
+
+  // 3️⃣ package.json
+  fs.writeFileSync(
+    path.join(projectDir, "package.json"),
+    `{
+  "name": "${arg}",
+  "version": "1.0.0",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "scripts": {
+    "dev": "tsx src/${arg}/main.ts",
+    "build": "tsc",
+    "start": "node dist/${arg}/main.js"
+  },
+  "dependencies": {
+    "fastnode-core": "latest",
+    "reflect-metadata": "^0.1.13"
+  },
+  "devDependencies": {
+    "tsx": "^4.7.0",
+    "typescript": "^5.0.0"
+  }
+}
+`
+  );
+
+  console.log(`✔ Project '${arg}' created at ${projectDir}`);
+}
+
+if (command === "serve" && arg) {
+  const entry = path.resolve(process.cwd(), `src/${arg}/main.ts`);
+
+  if (!fs.existsSync(entry)) {
+    console.error(`❌ Cannot find module at ${entry}`);
+    process.exit(1);
+  }
+
+  execSync(`npx tsx ${entry}`, { stdio: "inherit" });
+}
+
+function capitalize(str: string): string {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "compilerOptions": {
+    "module": "CommonJS",
+    "target": "ES2020",
+    "esModuleInterop": true,
+    "outDir": "dist"
+  },
+  "include": ["src"]
+}