@express-tool/cli 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mustak Ahmed Khan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,187 @@
+<div align="center">
+
+# 🚀 Express Next CLI
+
+[![npm version](https://img.shields.io/npm/v/express-next?style=flat-square)](https://www.npmjs.com/package/express-next)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)
+
+</div>
+
+A production-grade Command Line Interface for generating robust, scalable Express.js applications.
+`express-next` automates the boring setup, enforcing best practices, modern tooling, and clean architecture from day one.
+
+## ✨ Features
+
+- **Language Support**: First-class TypeScript support (recommended) or modern JavaScript (ES Modules).
+- **Architecture**: Choose between **Feature-based** (great for scalability) or Classic **MVC**.
+- **Database Integration**:
+  - **Prisma ORM**: PostgreSQL, MySQL, MongoDB.
+  - **Mongoose**: Native MongoDB support.
+- **Authentication**: Built-in simple JWT authentication boilerplate.
+- **API Documentation**: Automatic Swagger/OpenAPI options.
+- **Package Managers**: Support for `npm`, `pnpm`, `yarn`, and `bun`.
+- **Production Ready**:
+  - 🐳 Docker & Docker Compose setup included.
+  - 🧪 Testing with Vitest + Supertest.
+  - 🧹 Linting & Formatting (ESLint + Prettier + Husky).
+  - 📝 Structured logging with Pino.
+
+---
+
+## 📦 Installation
+
+Install globally via your preferred package manager:
+
+### npm
+
+```bash
+npm install -g express-next
+```
+
+### pnpm (Recommended)
+
+```bash
+pnpm add -g express-next
+```
+
+### Yarn
+
+```bash
+yarn global add express-next
+```
+
+### Bun
+
+```bash
+bun add -g express-next
+```
+
+---
+
+## 🛠 Usage
+
+### 1. Initialize a New Project
+
+The `init` command launches an interactive wizard to configure your new application.
+
+```bash
+express-next init
+```
+
+**Interactive Prompts:**
+
+1. **Project Name**: Name of your project directory (kebab-case).
+2. **Language**: `TypeScript` (Recommended) or `JavaScript`.
+3. **Architecture**:
+   - `Feature-based`: Groups files by domain feature (e.g., `src/modules/users/`).
+   - `MVC`: Classic layering (`src/controllers`, `src/routes`, `src/models`).
+4. **API Type**:
+   - `REST API + Swagger`: Includes setup for auto-generated API docs.
+   - `REST API (Basic)`: Simple setup without documentation tools.
+5. **Database**:
+   - `PostgreSQL (Prisma)`
+   - `MySQL (Prisma)`
+   - `MongoDB (Prisma)`
+   - `MongoDB (Mongoose)`
+   - `None`
+6. **Package Manager**: Select `npm`, `pnpm`, `yarn`, or `bun`.
+
+---
+
+### 2. Generate Resources (`generate` or `g`)
+
+Quickly scaffold new resources (features) into your existing application. This command respects your project's language (TS/JS).
+
+**Syntax:**
+
+```bash
+express-next generate <resource-name>
+# or shorcut
+express-next g <resource-name>
+```
+
+**Example:**
+
+```bash
+express-next g blogs
+```
+
+**Output:**
+This will create the following files (example for a `blogs` feature):
+
+- 📄 `src/controllers/blogs.controller.ts` (CRUD handlers)
+- 🛣️ `src/routes/blogs.routes.ts` (Router definition)
+- 🧪 `test/blogs.test.ts` (Integration tests)
+
+**After Generation:**
+The CLI will print instructions on how to register the new route in your `src/index.ts` (or `app.ts`):
+
+```typescript
+import { blogsRouter } from './routes/blogs.routes.js';
+app.use('/blogs', blogsRouter);
+```
+
+---
+
+### 3. Utility Commands
+
+#### Check Environment
+
+View debugging information about your local environment. useful for reporting issues.
+
+```bash
+express-next info
+```
+
+#### Update CLI
+
+Check for updates or self-update the CLI tool.
+
+```bash
+express-next upgrade
+```
+
+---
+
+## 📂 Project Structure
+
+A typical project created with `express-next` looks like this:
+
+```
+my-express-app/
+├── 🐳 .dockerignore
+├── ⚙️ .env
+├── ⚙️ .eslintrc.json
+├── 🐙 .github/               # CI/CD Workflows
+├── 🙈 .gitignore
+├── 💅 .prettierrc
+├── 🐳 docker-compose.yml
+├── 🐳 Dockerfile
+├── 📦 package.json
+├── 📘 README.md
+├── 📐 tsconfig.json          # (If TypeScript)
+├── 🧪 vitest.config.ts
+├── src/
+│   ├── 📁 controllers/       # Route handlers
+│   ├── 📁 middleware/        # Custom middleware (auth, validation, error)
+│   ├── 📁 models/            # Database models (Mongoose schemas)
+│   ├── 📁 routes/            # Route definitions
+│   ├── 📁 utils/             # Utility functions and Logger
+│   ├── 📄 index.ts           # Application entry point
+│   └── 📄 app.test.ts        # App setup tests
+└── prisma/                   # (If Prisma selected)
+    └── 📄 schema.prisma
+```
+
+## 💻 Local Development
+
+If you want to contribute to the project or run it from source, please check out our [Development Guide](./DEVELOPMENT.md).
+
+## 🤝 Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request on our [GitHub Repository](https://github.com/iam-mustak-ak/express-next.git).
+
+## 📄 License
+
+MIT © Mustak Ahmed Khan

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+import{createRequire as e}from"module";e(import.meta.url);import{Command as t}from"commander";import s from"picocolors";import{authPlugin as r}from"@express-tool/plugin-auth";import{ciPlugin as a}from"@express-tool/plugin-ci";import{commonPlugin as o}from"@express-tool/plugin-common";import{databasePlugin as n}from"@express-tool/plugin-database";import{dockerPlugin as i}from"@express-tool/plugin-docker";import{middlewarePlugin as p}from"@express-tool/plugin-middleware";import{qualityPlugin as l}from"@express-tool/plugin-quality";import{swaggerPlugin as c}from"@express-tool/plugin-swagger";import{testingPlugin as m}from"@express-tool/plugin-testing";import{viewsPlugin as g}from"@express-tool/plugin-views";import u from"fs-extra";import d from"prompts";import{z as w}from"zod";import{controllerJs as f,controllerTs as y,routesJs as v,routesTs as j,testJs as h,testTs as x}from"@express-tool/plugin-resource";import S from"envinfo";import{createRequire as b}from"node:module";let $=b(import.meta.url);var C={656(e,b,C){C.d(b,{x:()=>G});var k=JSON.parse('{"UU":"@express-tool/cli","rE":"0.0.1"}');let E=e=>console.log(s.blue("ℹ"),e),D=e=>console.log(s.green("✔"),e),N=e=>console.log(s.yellow("⚠"),e),T=e=>console.log(s.red("✖"),e),P=$("path");var M=C.n(P);async function O(e,t,s,r,a,o){E(`Applying plugin: ${e.name}`);let n=await e.apply(t,o);if(n.dependencies&&(r.dependencies={...r.dependencies,...n.dependencies}),n.devDependencies&&(r.devDependencies={...r.devDependencies,...n.devDependencies}),n.files)for(let e of n.files){let t=M().join(s,"src",e.path);u.ensureDirSync(M().dirname(t)),u.writeFileSync(t,e.content),E(`  Created ${e.path}`)}if(n.env)for(let[e,t]of Object.entries(n.env))a.push(`${e}=${t}`);return n.scripts&&(r.scripts={...r.scripts,...n.scripts}),n}async function R(e){let t=M().resolve(process.cwd(),e.projectName);u.existsSync(t)&&(T(`Directory ${e.projectName} already exists.`),process.exit(1)),E(`Creating project in ${t}...`),u.mkdirSync(t);let s=[],d={name:e.projectName,version:"0.0.0",private:!0,type:"module",packageManager:`${e.packageManager}@latest`,scripts:{dev:"ts"===e.language?"tsx watch src/index.ts":"node --watch src/index.js",build:"ts"===e.language?"tsc":void 0,start:"ts"===e.language?"node dist/index.js":"node src/index.js"},dependencies:{express:"^4.18.2"},devDependencies:{}};"rest-swagger"===e.apiType&&(Object.assign(d.dependencies,{"swagger-ui-express":"^5.0.0",zod:"^3.22.4","@asteasolutions/zod-to-openapi":"^7.0.0"}),"ts"===e.language&&Object.assign(d.devDependencies,{"@types/swagger-ui-express":"^4.1.6"})),"jwt"===e.auth&&(Object.assign(d.dependencies,{jsonwebtoken:"^9.0.2"}),"ts"===e.language&&Object.assign(d.devDependencies,{"@types/jsonwebtoken":"^9.0.5"})),"none"!==e.templateEngine&&(Object.assign(d.dependencies,{[e.templateEngine]:"ejs"===e.templateEngine?"^3.1.9":"^3.0.2"}),"ts"===e.language&&Object.assign(d.devDependencies,{[`@types/${e.templateEngine}`]:"ejs"===e.templateEngine?"^3.1.5":"^2.0.10"})),u.writeJsonSync(M().join(t,"package.json"),d,{spaces:2});let w=M().join(t,"src");u.mkdirSync(w),e.language;let f={projectRoot:t,projectName:e.projectName,isTs:"ts"===e.language,language:e.language};await O(o,f,t,d,s),await O(p,f,t,d,s),"rest-swagger"===e.apiType&&await O(c,f,t,d,s),"none"!==e.database&&await O(n,f,t,d,s,{database:e.database}),"jwt"===e.auth&&await O(r,f,t,d,[]),"none"!==e.templateEngine&&await O(g,f,t,d,s,{templateEngine:e.templateEngine});let y=s.join("\n")+"\n";u.writeFileSync(M().join(t,".env"),y),u.writeFileSync(M().join(t,".env.example"),y);let v=`import 'dotenv/config';
+import express from 'express';
+import cors from 'cors';
+import helmet from 'helmet';
+import path from 'path';
+import pinoHttp from 'pino-http';
+import { rateLimit } from 'express-rate-limit';
+import { logger } from './utils/logger';
+import { errorHandler } from './middleware/errorHandler';
+${"mongodb"===e.database?"import { connectDB } from './lib/db';":""}
+`;"jwt"===e.auth&&(v+=`import { authRouter } from './routes/auth';
+import { authenticateToken } from './middleware/auth';
+`),"rest-swagger"===e.apiType&&(v+=`import { swaggerRouter } from './docs/index';
+`),v+=`
+const app = express();
+const port = process.env.PORT || 3000;
+
+app.use(helmet());
+app.use(cors());
+app.use(express.json());
+app.use(pinoHttp({ logger }));
+
+const limiter = rateLimit({
+  windowMs: 15 * 60 * 1000, 
+  limit: 100, 
+  standardHeaders: 'draft-7',
+  legacyHeaders: false,
+});
+app.use(limiter);
+
+${"mongodb"===e.database?"connectDB();":""}
+
+// View Engine Setup
+${"none"!==e.templateEngine?`
+app.set('views', path.join(__dirname, 'views'));
+app.set('view engine', '${e.templateEngine}');
+app.use(express.static(path.join(__dirname, 'public')));
+`:""}
+
+`,"rest-swagger"===e.apiType&&(v+=`app.use('/docs', swaggerRouter);
+`),"jwt"===e.auth&&(v+=`app.use('/auth', authRouter);
+`),v+=`app.get('/', (req, res) => {
+  ${"none"!==e.templateEngine?`res.render('index', { title: 'Express App', message: 'Hello from ${e.templateEngine.toUpperCase()}!' });`:"res.json({ status: 'ok', timestamp: new Date().toISOString() });"}
+});
+
+app.get('/health', (req, res) => {
+  res.json({ status: 'ok', timestamp: new Date().toISOString() });
+});
+`,"jwt"===e.auth&&(v+=`
+app.get('/protected', authenticateToken, (req, res) => {
+  res.json({ message: 'This is a protected route', user: (req as any).user });
+});
+`),v+=`
+app.use(errorHandler);
+
+// Export app for testing
+export { app };
+`;let j=`
+const server = app.listen(port, () => {
+  logger.info(\`Server running on http://localhost:\${port}\`);
+});
+
+// Graceful Shutdown
+const shutdown = () => {
+  logger.info('SIGTERM signal received: closing HTTP server');
+  server.close(() => {
+    logger.info('HTTP server closed');
+    process.exit(0);
+  });
+};
+
+process.on('SIGTERM', shutdown);
+process.on('SIGINT', shutdown);
+`;"ts"===e.language?v+=`
+if (import.meta.url === \`file://\${process.argv[1]}\`) {
+${j}
+}
+`:v+=`
+if (process.argv[1] === import.meta.filename) { // Node 20.11+
+${j}
+} else if (import.meta.url === \`file://\${process.argv[1]}\`) {
+${j}
+}
+`;let h="ts"===e.language?"index.ts":"index.js";u.writeFileSync(M().join(w,h),v),await O(m,f,t,d,s),await O(l,f,t,d,s),await O(i,f,t,d,s,{packageManager:e.packageManager,database:e.database}),await O(a,f,t,d,s,{packageManager:e.packageManager}),"ts"===e.language&&u.writeJsonSync(M().join(t,"tsconfig.json"),{compilerOptions:{target:"ES2022",module:"NodeNext",moduleResolution:"NodeNext",outDir:"./dist",rootDir:"./src",strict:!0,esModuleInterop:!0},include:["src/**/*"]},{spaces:2});let x=`node_modules
+dist
+.env
+.DS_Store
+`;u.writeFileSync(M().join(t,".gitignore"),x),D(`Project ${e.projectName} created successfully!`)}let L=w.object({projectName:w.string().min(1).regex(/^[a-z0-9-]+$/,"Project name must be kebab-case (lowercase letters, numbers, and hyphens)"),language:w.enum(["ts","js"]),architecture:w.enum(["feature","mvc"]),apiType:w.enum(["rest","rest-swagger"]),database:w.enum(["postgresql","mysql","mongodb","mongodb-prisma","none"]),auth:w.enum(["jwt","none"]),templateEngine:w.enum(["ejs","pug","none"]),packageManager:w.enum(["npm","pnpm","yarn","bun"])});async function I(){return await d([{type:"text",name:"projectName",message:"What is your project name?",initial:"my-express-app",validate:e=>{let t=L.shape.projectName.safeParse(e);return!!t.success||t.error.issues[0].message}},{type:"select",name:"language",message:"Select language",choices:[{title:"TypeScript (Recommended)",value:"ts"},{title:"JavaScript",value:"js"}],initial:0},{type:"select",name:"packageManager",message:"Select package manager",choices:[{title:"pnpm (Recommended)",value:"pnpm"},{title:"npm",value:"npm"},{title:"Yarn",value:"yarn"},{title:"Bun",value:"bun"}],initial:0},{type:"select",name:"architecture",message:"Select architecture",choices:[{title:"Feature-based (Recommended)",value:"feature",description:"Modules grouped by feature (e.g., users, posts)"},{title:"MVC",value:"mvc",description:"Classic Model-View-Controller structure"}],initial:0},{type:"select",name:"apiType",message:"Select API type",choices:[{title:"REST API + Swagger",value:"rest-swagger"},{title:"REST API (Basic)",value:"rest"}],initial:0},{type:"select",name:"database",message:"Select database",choices:[{title:"PostgreSQL (Prisma)",value:"postgresql"},{title:"MySQL (Prisma)",value:"mysql"},{title:"MongoDB (Prisma)",value:"mongodb-prisma"},{title:"MongoDB (Mongoose)",value:"mongodb"},{title:"None",value:"none"}],initial:0},{type:"select",name:"auth",message:"Select authentication",choices:[{title:"JWT (JSON Web Token)",value:"jwt"},{title:"None",value:"none"}],initial:0},{type:"select",name:"templateEngine",message:"Select template engine",choices:[{title:"EJS (Embedded JavaScript)",value:"ejs"},{title:"Pug (Jade)",value:"pug"},{title:"None (API only)",value:"none"}],initial:0}],{onCancel:()=>{T("Operation cancelled"),process.exit(1)}})}let F=new t("init").description("Initialize a new Express.js project").action(async()=>{let e=await I();await R(e)});async function J(e){let t=process.cwd(),s=M().join(t,"package.json");u.existsSync(s)||(T("No package.json found. Are you in the root of the project?"),process.exit(1));let r=u.readJsonSync(s),a=r.devDependencies&&r.devDependencies.typescript,o=a?"ts":"js",n=M().join(t,"src"),i=M().join(n,"controllers"),p=M().join(n,"routes"),l=M().join(t,"test");u.ensureDirSync(i),u.ensureDirSync(p),u.ensureDirSync(l);let c=e.charAt(0).toUpperCase()+e.slice(1),m=M().join(i,`${e.toLowerCase()}.controller.${o}`);u.existsSync(m)?N(`Controller ${m} already exists. Skipping.`):(u.writeFileSync(m,a?y(c):f(c)),E(`Created controller: src/controllers/${e.toLowerCase()}.controller.${o}`));let g=M().join(p,`${e.toLowerCase()}.routes.${o}`);u.existsSync(g)?N(`Route ${g} already exists. Skipping.`):(u.writeFileSync(g,a?j(c):v(c)),E(`Created route: src/routes/${e.toLowerCase()}.routes.${o}`));let d=M().join(l,`${e.toLowerCase()}.test.${o}`);u.existsSync(d)?N(`Test ${d} already exists. Skipping.`):(u.writeFileSync(d,a?x(c):h(c)),E(`Created test: test/${e.toLowerCase()}.test.${o}`)),D(`Feature ${e} generated successfully!`),E(`
+Don't forget to register the route in src/index.${o}:`),E(`import { ${e.toLowerCase()}Router } from './routes/${e.toLowerCase()}.routes';`),E(`app.use('/${e.toLowerCase()}s', ${e.toLowerCase()}Router);`)}let q=new t().name("generate").alias("g").description("Generate a new feature (controller, routes, test)").argument("<name>","Name of the feature (e.g. users, blogs)").action(async e=>{await J(e)}),H=new t().name("info").description("Print debugging information about your environment").action(async()=>{console.log("  System:"),await S.run({System:["OS","CPU","Memory","Shell"],Binaries:["Node","Yarn","npm","pnpm"],Utilities:["Git"],IDEs:["VSCode"],Browsers:["Chrome","Edge","Firefox","Safari"],npmPackages:["typescript","express","express-next"]},{console:!0,showNotFound:!0})}),A=$("https");var B=C.n(A);let U=new t().name("upgrade").description("Check for updates").action(async()=>{E("Checking for updates...");let e=k.rE,t=k.UU;try{var s;let r=await (s=t,new Promise(e=>{B().get(`https://registry.npmjs.org/${s}/latest`,t=>{let s="";t.on("data",e=>s+=e),t.on("end",()=>{try{let t=JSON.parse(s);e(t.version)}catch{e(null)}})}).on("error",()=>e(null))}));if(!r)return void N("Could not fetch latest version info.");r!==e?(E(`New version available: ${r} (current: ${e})`),E(`Run 'npm install -g ${t}' to update.`)):D("You are using the latest version.")}catch(e){T("Failed to check for updates.")}}),{rE:_}=k,G=new t;G.name("express-next").description("Production-grade CLI for Express.js applications").version(_),G.hook("preAction",()=>{E("Welcome to express-next CLI")}),G.addCommand(F),G.addCommand(q),G.addCommand(H),G.addCommand(U)}},k={};function E(e){var t=k[e];if(void 0!==t)return t.exports;var s=k[e]={exports:{}};return C[e](s,s.exports,E),s.exports}E.n=e=>{var t=e&&e.__esModule?()=>e.default:()=>e;return E.d(t,{a:t}),t},E.d=(e,t)=>{for(var s in t)E.o(t,s)&&!E.o(e,s)&&Object.defineProperty(e,s,{enumerable:!0,get:t[s]})},E.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),E(656).x.parse(process.argv);

package/dist/commands/generate.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const generate: Command;
+//# sourceMappingURL=generate.d.ts.map

package/dist/commands/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,eAAO,MAAM,QAAQ,SAOjB,CAAC"}

package/dist/commands/generate.generator.d.ts

@@ -0,0 +1,2 @@
+export declare function generateResource(name: string): Promise<void>;
+//# sourceMappingURL=generate.generator.d.ts.map

package/dist/commands/generate.generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.generator.d.ts","sourceRoot":"","sources":["../../src/commands/generate.generator.ts"],"names":[],"mappings":"AAgBA,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,iBA6DlD"}

package/dist/commands/info.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const info: Command;
+//# sourceMappingURL=info.d.ts.map

package/dist/commands/info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../src/commands/info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,IAAI,SAmBb,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const initCommand: Command;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,WAAW,SAKpB,CAAC"}

package/dist/commands/init.generator.d.ts

@@ -0,0 +1,3 @@
+import { InitOptions } from './init.prompts';
+export declare function generateBaseApp(options: InitOptions): Promise<void>;
+//# sourceMappingURL=init.generator.d.ts.map

package/dist/commands/init.generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.generator.d.ts","sourceRoot":"","sources":["../../src/commands/init.generator.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,wBAAsB,eAAe,CAAC,OAAO,EAAE,WAAW,iBAySzD"}

package/dist/commands/init.prompts.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+export declare const initOptionsSchema: z.ZodObject<{
+    projectName: z.ZodString;
+    language: z.ZodEnum<{
+        ts: "ts";
+        js: "js";
+    }>;
+    architecture: z.ZodEnum<{
+        feature: "feature";
+        mvc: "mvc";
+    }>;
+    apiType: z.ZodEnum<{
+        rest: "rest";
+        "rest-swagger": "rest-swagger";
+    }>;
+    database: z.ZodEnum<{
+        postgresql: "postgresql";
+        mysql: "mysql";
+        mongodb: "mongodb";
+        "mongodb-prisma": "mongodb-prisma";
+        none: "none";
+    }>;
+    auth: z.ZodEnum<{
+        none: "none";
+        jwt: "jwt";
+    }>;
+    templateEngine: z.ZodEnum<{
+        none: "none";
+        ejs: "ejs";
+        pug: "pug";
+    }>;
+    packageManager: z.ZodEnum<{
+        npm: "npm";
+        pnpm: "pnpm";
+        yarn: "yarn";
+        bun: "bun";
+    }>;
+}, z.core.$strip>;
+export type InitOptions = z.infer<typeof initOptionsSchema>;
+export declare function promptInitOptions(): Promise<InitOptions>;
+//# sourceMappingURL=init.prompts.d.ts.map

package/dist/commands/init.prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.prompts.d.ts","sourceRoot":"","sources":["../../src/commands/init.prompts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAe5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,WAAW,CAAC,CAuG9D"}

package/dist/commands/upgrade.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const upgrade: Command;
+//# sourceMappingURL=upgrade.d.ts.map

package/dist/commands/upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,OAAO,SAwBhB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const cli: Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,eAAO,MAAM,GAAG,SAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,89 @@
+import{Command as e}from"commander";import t from"picocolors";import{authPlugin as s}from"@express-tool/plugin-auth";import{ciPlugin as a}from"@express-tool/plugin-ci";import{commonPlugin as r}from"@express-tool/plugin-common";import{databasePlugin as o}from"@express-tool/plugin-database";import{dockerPlugin as n}from"@express-tool/plugin-docker";import{middlewarePlugin as i}from"@express-tool/plugin-middleware";import{qualityPlugin as p}from"@express-tool/plugin-quality";import{swaggerPlugin as l}from"@express-tool/plugin-swagger";import{testingPlugin as c}from"@express-tool/plugin-testing";import{viewsPlugin as m}from"@express-tool/plugin-views";import g from"fs-extra";import u from"prompts";import{z as d}from"zod";import{controllerJs as w,controllerTs as f,routesJs as y,routesTs as v,testJs as j,testTs as h}from"@express-tool/plugin-resource";import x from"envinfo";import{createRequire as S}from"node:module";let b=S(import.meta.url);var $={};$.n=e=>{var t=e&&e.__esModule?()=>e.default:()=>e;return $.d(t,{a:t}),t},$.d=(e,t)=>{for(var s in t)$.o(t,s)&&!$.o(e,s)&&Object.defineProperty(e,s,{enumerable:!0,get:t[s]})},$.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t);var C={};$.d(C,{x:()=>G});var k=JSON.parse('{"UU":"@express-tool/cli","rE":"0.0.1"}');let E=e=>console.log(t.blue("ℹ"),e),D=e=>console.log(t.green("✔"),e),N=e=>console.log(t.yellow("⚠"),e),T=e=>console.log(t.red("✖"),e),P=b("path");var M=$.n(P);async function O(e,t,s,a,r,o){E(`Applying plugin: ${e.name}`);let n=await e.apply(t,o);if(n.dependencies&&(a.dependencies={...a.dependencies,...n.dependencies}),n.devDependencies&&(a.devDependencies={...a.devDependencies,...n.devDependencies}),n.files)for(let e of n.files){let t=M().join(s,"src",e.path);g.ensureDirSync(M().dirname(t)),g.writeFileSync(t,e.content),E(`  Created ${e.path}`)}if(n.env)for(let[e,t]of Object.entries(n.env))r.push(`${e}=${t}`);return n.scripts&&(a.scripts={...a.scripts,...n.scripts}),n}async function R(e){let t=M().resolve(process.cwd(),e.projectName);g.existsSync(t)&&(T(`Directory ${e.projectName} already exists.`),process.exit(1)),E(`Creating project in ${t}...`),g.mkdirSync(t);let u=[],d={name:e.projectName,version:"0.0.0",private:!0,type:"module",packageManager:`${e.packageManager}@latest`,scripts:{dev:"ts"===e.language?"tsx watch src/index.ts":"node --watch src/index.js",build:"ts"===e.language?"tsc":void 0,start:"ts"===e.language?"node dist/index.js":"node src/index.js"},dependencies:{express:"^4.18.2"},devDependencies:{}};"rest-swagger"===e.apiType&&(Object.assign(d.dependencies,{"swagger-ui-express":"^5.0.0",zod:"^3.22.4","@asteasolutions/zod-to-openapi":"^7.0.0"}),"ts"===e.language&&Object.assign(d.devDependencies,{"@types/swagger-ui-express":"^4.1.6"})),"jwt"===e.auth&&(Object.assign(d.dependencies,{jsonwebtoken:"^9.0.2"}),"ts"===e.language&&Object.assign(d.devDependencies,{"@types/jsonwebtoken":"^9.0.5"})),"none"!==e.templateEngine&&(Object.assign(d.dependencies,{[e.templateEngine]:"ejs"===e.templateEngine?"^3.1.9":"^3.0.2"}),"ts"===e.language&&Object.assign(d.devDependencies,{[`@types/${e.templateEngine}`]:"ejs"===e.templateEngine?"^3.1.5":"^2.0.10"})),g.writeJsonSync(M().join(t,"package.json"),d,{spaces:2});let w=M().join(t,"src");g.mkdirSync(w),e.language;let f={projectRoot:t,projectName:e.projectName,isTs:"ts"===e.language,language:e.language};await O(r,f,t,d,u),await O(i,f,t,d,u),"rest-swagger"===e.apiType&&await O(l,f,t,d,u),"none"!==e.database&&await O(o,f,t,d,u,{database:e.database}),"jwt"===e.auth&&await O(s,f,t,d,[]),"none"!==e.templateEngine&&await O(m,f,t,d,u,{templateEngine:e.templateEngine});let y=u.join("\n")+"\n";g.writeFileSync(M().join(t,".env"),y),g.writeFileSync(M().join(t,".env.example"),y);let v=`import 'dotenv/config';
+import express from 'express';
+import cors from 'cors';
+import helmet from 'helmet';
+import path from 'path';
+import pinoHttp from 'pino-http';
+import { rateLimit } from 'express-rate-limit';
+import { logger } from './utils/logger';
+import { errorHandler } from './middleware/errorHandler';
+${"mongodb"===e.database?"import { connectDB } from './lib/db';":""}
+`;"jwt"===e.auth&&(v+=`import { authRouter } from './routes/auth';
+import { authenticateToken } from './middleware/auth';
+`),"rest-swagger"===e.apiType&&(v+=`import { swaggerRouter } from './docs/index';
+`),v+=`
+const app = express();
+const port = process.env.PORT || 3000;
+
+app.use(helmet());
+app.use(cors());
+app.use(express.json());
+app.use(pinoHttp({ logger }));
+
+const limiter = rateLimit({
+  windowMs: 15 * 60 * 1000, 
+  limit: 100, 
+  standardHeaders: 'draft-7',
+  legacyHeaders: false,
+});
+app.use(limiter);
+
+${"mongodb"===e.database?"connectDB();":""}
+
+// View Engine Setup
+${"none"!==e.templateEngine?`
+app.set('views', path.join(__dirname, 'views'));
+app.set('view engine', '${e.templateEngine}');
+app.use(express.static(path.join(__dirname, 'public')));
+`:""}
+
+`,"rest-swagger"===e.apiType&&(v+=`app.use('/docs', swaggerRouter);
+`),"jwt"===e.auth&&(v+=`app.use('/auth', authRouter);
+`),v+=`app.get('/', (req, res) => {
+  ${"none"!==e.templateEngine?`res.render('index', { title: 'Express App', message: 'Hello from ${e.templateEngine.toUpperCase()}!' });`:"res.json({ status: 'ok', timestamp: new Date().toISOString() });"}
+});
+
+app.get('/health', (req, res) => {
+  res.json({ status: 'ok', timestamp: new Date().toISOString() });
+});
+`,"jwt"===e.auth&&(v+=`
+app.get('/protected', authenticateToken, (req, res) => {
+  res.json({ message: 'This is a protected route', user: (req as any).user });
+});
+`),v+=`
+app.use(errorHandler);
+
+// Export app for testing
+export { app };
+`;let j=`
+const server = app.listen(port, () => {
+  logger.info(\`Server running on http://localhost:\${port}\`);
+});
+
+// Graceful Shutdown
+const shutdown = () => {
+  logger.info('SIGTERM signal received: closing HTTP server');
+  server.close(() => {
+    logger.info('HTTP server closed');
+    process.exit(0);
+  });
+};
+
+process.on('SIGTERM', shutdown);
+process.on('SIGINT', shutdown);
+`;"ts"===e.language?v+=`
+if (import.meta.url === \`file://\${process.argv[1]}\`) {
+${j}
+}
+`:v+=`
+if (process.argv[1] === import.meta.filename) { // Node 20.11+
+${j}
+} else if (import.meta.url === \`file://\${process.argv[1]}\`) {
+${j}
+}
+`;let h="ts"===e.language?"index.ts":"index.js";g.writeFileSync(M().join(w,h),v),await O(c,f,t,d,u),await O(p,f,t,d,u),await O(n,f,t,d,u,{packageManager:e.packageManager,database:e.database}),await O(a,f,t,d,u,{packageManager:e.packageManager}),"ts"===e.language&&g.writeJsonSync(M().join(t,"tsconfig.json"),{compilerOptions:{target:"ES2022",module:"NodeNext",moduleResolution:"NodeNext",outDir:"./dist",rootDir:"./src",strict:!0,esModuleInterop:!0},include:["src/**/*"]},{spaces:2});let x=`node_modules
+dist
+.env
+.DS_Store
+`;g.writeFileSync(M().join(t,".gitignore"),x),D(`Project ${e.projectName} created successfully!`)}let L=d.object({projectName:d.string().min(1).regex(/^[a-z0-9-]+$/,"Project name must be kebab-case (lowercase letters, numbers, and hyphens)"),language:d.enum(["ts","js"]),architecture:d.enum(["feature","mvc"]),apiType:d.enum(["rest","rest-swagger"]),database:d.enum(["postgresql","mysql","mongodb","mongodb-prisma","none"]),auth:d.enum(["jwt","none"]),templateEngine:d.enum(["ejs","pug","none"]),packageManager:d.enum(["npm","pnpm","yarn","bun"])});async function I(){return await u([{type:"text",name:"projectName",message:"What is your project name?",initial:"my-express-app",validate:e=>{let t=L.shape.projectName.safeParse(e);return!!t.success||t.error.issues[0].message}},{type:"select",name:"language",message:"Select language",choices:[{title:"TypeScript (Recommended)",value:"ts"},{title:"JavaScript",value:"js"}],initial:0},{type:"select",name:"packageManager",message:"Select package manager",choices:[{title:"pnpm (Recommended)",value:"pnpm"},{title:"npm",value:"npm"},{title:"Yarn",value:"yarn"},{title:"Bun",value:"bun"}],initial:0},{type:"select",name:"architecture",message:"Select architecture",choices:[{title:"Feature-based (Recommended)",value:"feature",description:"Modules grouped by feature (e.g., users, posts)"},{title:"MVC",value:"mvc",description:"Classic Model-View-Controller structure"}],initial:0},{type:"select",name:"apiType",message:"Select API type",choices:[{title:"REST API + Swagger",value:"rest-swagger"},{title:"REST API (Basic)",value:"rest"}],initial:0},{type:"select",name:"database",message:"Select database",choices:[{title:"PostgreSQL (Prisma)",value:"postgresql"},{title:"MySQL (Prisma)",value:"mysql"},{title:"MongoDB (Prisma)",value:"mongodb-prisma"},{title:"MongoDB (Mongoose)",value:"mongodb"},{title:"None",value:"none"}],initial:0},{type:"select",name:"auth",message:"Select authentication",choices:[{title:"JWT (JSON Web Token)",value:"jwt"},{title:"None",value:"none"}],initial:0},{type:"select",name:"templateEngine",message:"Select template engine",choices:[{title:"EJS (Embedded JavaScript)",value:"ejs"},{title:"Pug (Jade)",value:"pug"},{title:"None (API only)",value:"none"}],initial:0}],{onCancel:()=>{T("Operation cancelled"),process.exit(1)}})}let F=new e("init").description("Initialize a new Express.js project").action(async()=>{let e=await I();await R(e)});async function _(e){let t=process.cwd(),s=M().join(t,"package.json");g.existsSync(s)||(T("No package.json found. Are you in the root of the project?"),process.exit(1));let a=g.readJsonSync(s),r=a.devDependencies&&a.devDependencies.typescript,o=r?"ts":"js",n=M().join(t,"src"),i=M().join(n,"controllers"),p=M().join(n,"routes"),l=M().join(t,"test");g.ensureDirSync(i),g.ensureDirSync(p),g.ensureDirSync(l);let c=e.charAt(0).toUpperCase()+e.slice(1),m=M().join(i,`${e.toLowerCase()}.controller.${o}`);g.existsSync(m)?N(`Controller ${m} already exists. Skipping.`):(g.writeFileSync(m,r?f(c):w(c)),E(`Created controller: src/controllers/${e.toLowerCase()}.controller.${o}`));let u=M().join(p,`${e.toLowerCase()}.routes.${o}`);g.existsSync(u)?N(`Route ${u} already exists. Skipping.`):(g.writeFileSync(u,r?v(c):y(c)),E(`Created route: src/routes/${e.toLowerCase()}.routes.${o}`));let d=M().join(l,`${e.toLowerCase()}.test.${o}`);g.existsSync(d)?N(`Test ${d} already exists. Skipping.`):(g.writeFileSync(d,r?h(c):j(c)),E(`Created test: test/${e.toLowerCase()}.test.${o}`)),D(`Feature ${e} generated successfully!`),E(`
+Don't forget to register the route in src/index.${o}:`),E(`import { ${e.toLowerCase()}Router } from './routes/${e.toLowerCase()}.routes';`),E(`app.use('/${e.toLowerCase()}s', ${e.toLowerCase()}Router);`)}let J=new e().name("generate").alias("g").description("Generate a new feature (controller, routes, test)").argument("<name>","Name of the feature (e.g. users, blogs)").action(async e=>{await _(e)}),q=new e().name("info").description("Print debugging information about your environment").action(async()=>{console.log("  System:"),await x.run({System:["OS","CPU","Memory","Shell"],Binaries:["Node","Yarn","npm","pnpm"],Utilities:["Git"],IDEs:["VSCode"],Browsers:["Chrome","Edge","Firefox","Safari"],npmPackages:["typescript","express","express-next"]},{console:!0,showNotFound:!0})}),H=b("https");var A=$.n(H);let B=new e().name("upgrade").description("Check for updates").action(async()=>{E("Checking for updates...");let e=k.rE,t=k.UU;try{var s;let a=await (s=t,new Promise(e=>{A().get(`https://registry.npmjs.org/${s}/latest`,t=>{let s="";t.on("data",e=>s+=e),t.on("end",()=>{try{let t=JSON.parse(s);e(t.version)}catch{e(null)}})}).on("error",()=>e(null))}));if(!a)return void N("Could not fetch latest version info.");a!==e?(E(`New version available: ${a} (current: ${e})`),E(`Run 'npm install -g ${t}' to update.`)):D("You are using the latest version.")}catch(e){T("Failed to check for updates.")}}),{rE:U}=k,G=new e;G.name("express-next").description("Production-grade CLI for Express.js applications").version(U),G.hook("preAction",()=>{E("Welcome to express-next CLI")}),G.addCommand(F),G.addCommand(J),G.addCommand(q),G.addCommand(B);var z=C.x;export{z as cli};

package/dist/utils/logger.d.ts

@@ -0,0 +1,7 @@
+export declare const logger: {
+    info: (msg: string) => void;
+    success: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM;gBACL,MAAM;mBACH,MAAM;gBACT,MAAM;iBACL,MAAM;CACpB,CAAC"}

package/dist/utils/plugin.d.ts

@@ -0,0 +1,3 @@
+import { Plugin, PluginContext } from '@express-tool/core';
+export declare function executePlugin(plugin: Plugin, context: PluginContext, targetDir: string, packageJson: any, envVars: string[], pluginOptions?: any): Promise<import("@express-tool/core").PluginAction>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/utils/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/utils/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAK3D,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,GAAG,EAChB,OAAO,EAAE,MAAM,EAAE,EACjB,aAAa,CAAC,EAAE,GAAG,sDA8CpB"}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@express-tool/cli",
+  "version": "0.0.1",
+  "description": "Production-grade CLI for Express.js applications",
+  "keywords": [
+    "express",
+    "cli",
+    "generator",
+    "scaffold",
+    "typescript",
+    "prisma",
+    "mongodb"
+  ],
+  "author": "Mustak Ahmed Khan",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iam-mustak-ak/express-next.git"
+  },
+  "homepage": "https://github.com/iam-mustak-ak/express-next",
+  "bugs": {
+    "url": "https://github.com/iam-mustak-ak/express-next/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "express-tool": "./dist/bin.js"
+  },
+  "dependencies": {
+    "commander": "^14.0.3",
+    "envinfo": "^7.21.0",
+    "fs-extra": "^11.3.3",
+    "picocolors": "^1.1.1",
+    "prompts": "^2.4.2",
+    "zod": "^4.3.6",
+    "@express-tool/core": "0.0.1",
+    "@express-tool/plugin-auth": "0.0.1",
+    "@express-tool/plugin-swagger": "0.0.1",
+    "@express-tool/plugin-views": "0.0.1",
+    "@express-tool/plugin-database": "0.0.1",
+    "@express-tool/plugin-testing": "0.0.1",
+    "@express-tool/plugin-common": "0.0.1",
+    "@express-tool/plugin-middleware": "0.0.1",
+    "@express-tool/plugin-docker": "0.0.1",
+    "@express-tool/plugin-quality": "0.0.1",
+    "@express-tool/plugin-resource": "0.0.1",
+    "@express-tool/plugin-ci": "0.0.1"
+  },
+  "devDependencies": {
+    "@rsbuild/core": "^1.7.3",
+    "@rsbuild/plugin-type-check": "^1.3.3",
+    "@types/envinfo": "^7.8.4",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^25.2.1",
+    "@types/prompts": "^2.4.9",
+    "eslint": "^8.57.1",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "rsbuild build && tsc -b --force --emitDeclarationOnly",
+    "dev": "rsbuild build --watch",
+    "start": "node dist/bin.js",
+    "lint": "eslint . --max-warnings 0",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  }
+}