create-wabck 1.0.0

package/src/templates/routes.js

@@ -0,0 +1,179 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Route Templates
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** Generate src/routes/index.js — Master router */
+export function routesIndex(options) {
+  const { auth, language } = options;
+  const isTS = language === 'typescript';
+  const hasAuth = auth !== 'none';
+
+  return `import { Router } from 'express';
+import healthRoutes from './health.route.js';
+import userRoutes from './user.route.js';
+${hasAuth && auth === 'jwt' ? "import authRoutes from './auth.route.js';\n" : ''}
+const router = Router();
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Route Registration
+// All routes here are mounted at /api/v1 (configured in app.js)
+// ─────────────────────────────────────────────────────────────────────────────
+router.use('/health', healthRoutes);
+router.use('/users',  userRoutes);
+${hasAuth && auth === 'jwt' ? "router.use('/auth', authRoutes);\n" : ''}
+export default router;
+`;
+}
+
+/** Generate src/routes/health.route.js */
+export function healthRoute(options) {
+  const { language, database, projectName } = options;
+  const isTS = language === 'typescript';
+
+  const typeImports = isTS ? `import { Request, Response } from 'express';\n` : '';
+
+  return `${typeImports}import { Router } from 'express';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import path from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname  = path.dirname(__filename);
+
+let _version = '1.0.0';
+try {
+  const pkg = JSON.parse(readFileSync(path.join(__dirname, '..', '..', 'package.json'), 'utf-8'));
+  _version = pkg.version;
+} catch { /* ignore */ }
+
+const router = Router();
+
+/**
+ * GET /api/v1/health
+ *
+ * Returns the current health status of the API including uptime,
+ * version, environment, and timestamp.
+ */
+router.get('/', (_req${isTS ? ': Request' : ''}, res${isTS ? ': Response' : ''}) => {
+  res.status(200).json({
+    status:    'ok',
+    uptime:    Math.floor(process.uptime()),
+    version:   _version,
+    env:       process.env.NODE_ENV || 'development',
+    timestamp: new Date().toISOString(),
+    memory: {
+      used:  Math.round(process.memoryUsage().heapUsed / 1024 / 1024) + ' MB',
+      total: Math.round(process.memoryUsage().heapTotal / 1024 / 1024) + ' MB',
+    },
+  });
+});
+
+export default router;
+`;
+}
+
+/** Generate src/routes/user.route.js */
+export function userRoute(options) {
+  const { auth, language, validation } = options;
+  const isTS = language === 'typescript';
+  const hasJwt = auth === 'jwt';
+  const hasValidation = validation && validation !== 'none';
+
+  const authImport = hasJwt
+    ? `import { authenticate, authorize } from '../middlewares/auth.middleware.js';\n`
+    : auth === 'clerk'
+    ? `import { requireAuth } from '../middlewares/auth.middleware.js';\n`
+    : auth === 'firebase'
+    ? `import { authenticate } from '../middlewares/auth.middleware.js';\n`
+    : '';
+
+  const guardStart = hasJwt ? 'authenticate, ' : auth !== 'none' ? 'requireAuth, ' : '';
+  const adminGuard = hasJwt ? 'authenticate, authorize("admin"), ' : guardStart;
+
+  let validationImport = '';
+  let validateCreate = '';
+  let validateUpdate = '';
+
+  if (hasValidation) {
+    if (validation === 'zod' || validation === 'joi') {
+      validationImport = `import { validate, createUserSchema, updateUserSchema } from '../validators/user.validator.js';\n`;
+      validateCreate = `validate(createUserSchema), `;
+      validateUpdate = `validate(updateUserSchema), `;
+    } else if (validation === 'express-validator') {
+      validationImport = `import { createUserRules, updateUserRules, handleValidationErrors } from '../validators/user.validator.js';\n`;
+      validateCreate = `createUserRules, handleValidationErrors, `;
+      validateUpdate = `updateUserRules, handleValidationErrors, `;
+    }
+  }
+
+  return `import { Router } from 'express';
+import {
+  getAllUsers,
+  getUserById,
+  createUser,
+  updateUser,
+  deleteUser,
+} from '../controllers/user.controller.js';
+${authImport}${validationImport}
+const router = Router();
+
+// ─────────────────────────────────────────────────────────────────────────────
+// User Routes — /api/v1/users
+// ─────────────────────────────────────────────────────────────────────────────
+
+router.get('/',     ${guardStart}getAllUsers);
+router.post('/',    ${guardStart}${validateCreate}createUser);
+router.get('/:id',  ${guardStart}getUserById);
+router.put('/:id',  ${guardStart}${validateUpdate}updateUser);
+router.delete('/:id', ${adminGuard}deleteUser);
+
+export default router;
+`;
+}
+
+/** Generate src/routes/auth.route.js (JWT only) */
+export function authRoute(options) {
+  const { language, validation } = options;
+  const isTS = language === 'typescript';
+  const hasValidation = validation && validation !== 'none';
+
+  let validationImport = '';
+  let validateRegister = '';
+  let validateLogin = '';
+
+  if (hasValidation) {
+    if (validation === 'zod' || validation === 'joi') {
+      validationImport = `import { validate, createUserSchema, loginSchema } from '../validators/user.validator.js';\n`;
+      validateRegister = `validate(createUserSchema), `;
+      validateLogin = `validate(loginSchema), `;
+    } else if (validation === 'express-validator') {
+      validationImport = `import { createUserRules, loginRules, handleValidationErrors } from '../validators/user.validator.js';\n`;
+      validateRegister = `createUserRules, handleValidationErrors, `;
+      validateLogin = `loginRules, handleValidationErrors, `;
+    }
+  }
+
+  return `import { Router } from 'express';
+import {
+  register,
+  login,
+  logout,
+  getMe,
+} from '../controllers/user.controller.js';
+import { authenticate } from '../middlewares/auth.middleware.js';
+import { authRateLimiter } from '../middlewares/rateLimiter.middleware.js';
+${validationImport}
+const router = Router();
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Auth Routes — /api/v1/auth
+// ─────────────────────────────────────────────────────────────────────────────
+
+router.post('/register', authRateLimiter, ${validateRegister}register);
+router.post('/login',    authRateLimiter, ${validateLogin}login);
+router.post('/logout',   authenticate,   logout);
+router.get('/me',        authenticate,   getMe);
+
+export default router;
+`;
+}

package/src/templates/services.js

@@ -0,0 +1,252 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Service Templates — user.service.js
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** Generate src/services/user.service.js */
+export function userService(options) {
+  const { database, auth, language } = options;
+  const isTS = language === 'typescript';
+  const hasDB = database !== 'none';
+
+  // ── MongoDB ────────────────────────────────────────────────────────────────
+  if (database === 'mongodb') {
+    return `import { User } from '../models/user.model.js';
+import { ApiError } from '../utils/apiError.js';
+${auth === 'jwt' ? "import { generateTokens } from '../helpers/token.helper.js';\n" : ''}
+/**
+ * User Service (MongoDB)
+ *
+ * Encapsulates all business logic related to users.
+ * Controllers should call service methods and never directly touch models.
+ */
+export const UserService = {
+  /** Retrieve all active users (passwords excluded) */
+  async getAll()${isTS ? ': Promise<any[]>' : ''} {
+    return User.find({ isActive: true }).select('-password').lean();
+  },
+
+  /** Retrieve a single user by ID */
+  async getById(id${isTS ? ': string' : ''}) {
+    const user = await User.findById(id).select('-password');
+    if (!user) throw new ApiError(404, 'User not found');
+    return user;
+  },
+
+  /** Create a new user */
+  async create(data${isTS ? ': { name: string; email: string; password: string }' : ''}) {
+    const exists = await User.findOne({ email: data.email });
+    if (exists) throw new ApiError(409, 'A user with this email already exists');
+    return User.create(data);
+  },
+
+  /** Update an existing user */
+  async update(id${isTS ? ': string' : ''}, data${isTS ? ': Partial<{ name: string; email: string }>' : ''}) {
+    const user = await User.findByIdAndUpdate(id, { $set: data }, { new: true, runValidators: true }).select('-password');
+    if (!user) throw new ApiError(404, 'User not found');
+    return user;
+  },
+
+  /** Soft-delete a user (sets isActive = false) */
+  async remove(id${isTS ? ': string' : ''}) {
+    const user = await User.findByIdAndUpdate(id, { isActive: false }, { new: true });
+    if (!user) throw new ApiError(404, 'User not found');
+    return { message: 'User deleted successfully' };
+  },
+${auth === 'jwt' ? `
+  /** Register + issue tokens */
+  async register(data${isTS ? ': { name: string; email: string; password: string }' : ''}) {
+    const exists = await User.findOne({ email: data.email });
+    if (exists) throw new ApiError(409, 'Email already in use');
+    const user = await User.create(data);
+    const tokens = generateTokens({ id: user._id, email: user.email, role: user.role });
+    return { user: { id: user._id, name: user.name, email: user.email, role: user.role }, ...tokens };
+  },
+
+  /** Login + issue tokens */
+  async login(email${isTS ? ': string' : ''}, password${isTS ? ': string' : ''}) {
+    const user = await User.findOne({ email }).select('+password');
+    if (!user) throw new ApiError(401, 'Invalid credentials');
+    const isMatch = await user.comparePassword(password);
+    if (!isMatch) throw new ApiError(401, 'Invalid credentials');
+    const tokens = generateTokens({ id: user._id, email: user.email, role: user.role });
+    const { password: _pw, ...safeUser } = user.toObject();
+    return { user: safeUser, ...tokens };
+  },
+` : ''}};
+`;
+  }
+
+  // ── PostgreSQL / Prisma ────────────────────────────────────────────────────
+  if (database === 'postgresql') {
+    return `import { prisma } from '../config/db.js';
+import { ApiError } from '../utils/apiError.js';
+import bcrypt from 'bcryptjs';
+${auth === 'jwt' ? "import { generateTokens } from '../helpers/token.helper.js';\n" : ''}
+export const UserService = {
+  async getAll() {
+    return prisma.user.findMany({
+      where:  { isActive: true },
+      select: { id: true, name: true, email: true, role: true, createdAt: true, updatedAt: true },
+    });
+  },
+
+  async getById(id${isTS ? ': string' : ''}) {
+    const user = await prisma.user.findUnique({
+      where:  { id },
+      select: { id: true, name: true, email: true, role: true, createdAt: true, updatedAt: true },
+    });
+    if (!user) throw new ApiError(404, 'User not found');
+    return user;
+  },
+
+  async create(data${isTS ? ': { name: string; email: string; password: string }' : ''}) {
+    const exists = await prisma.user.findUnique({ where: { email: data.email } });
+    if (exists) throw new ApiError(409, 'A user with this email already exists');
+    const password = await bcrypt.hash(data.password, 12);
+    const user = await prisma.user.create({ data: { ...data, password } });
+    const { password: _pw, ...safe } = user;
+    return safe;
+  },
+
+  async update(id${isTS ? ': string' : ''}, data${isTS ? ': any' : ''}) {
+    try {
+      const user = await prisma.user.update({ where: { id }, data });
+      const { password: _pw, ...safe } = user;
+      return safe;
+    } catch {
+      throw new ApiError(404, 'User not found');
+    }
+  },
+
+  async remove(id${isTS ? ': string' : ''}) {
+    try {
+      await prisma.user.update({ where: { id }, data: { isActive: false } });
+      return { message: 'User deleted successfully' };
+    } catch {
+      throw new ApiError(404, 'User not found');
+    }
+  },
+${auth === 'jwt' ? `
+  async register(data${isTS ? ': { name: string; email: string; password: string }' : ''}) {
+    const exists = await prisma.user.findUnique({ where: { email: data.email } });
+    if (exists) throw new ApiError(409, 'Email already in use');
+    const password = await bcrypt.hash(data.password, 12);
+    const user = await prisma.user.create({ data: { ...data, password } });
+    const tokens = generateTokens({ id: user.id, email: user.email, role: user.role });
+    const { password: _pw, ...safeUser } = user;
+    return { user: safeUser, ...tokens };
+  },
+
+  async login(email${isTS ? ': string' : ''}, password${isTS ? ': string' : ''}) {
+    const user = await prisma.user.findUnique({ where: { email } });
+    if (!user) throw new ApiError(401, 'Invalid credentials');
+    const isMatch = await bcrypt.compare(password, user.password);
+    if (!isMatch) throw new ApiError(401, 'Invalid credentials');
+    const tokens = generateTokens({ id: user.id, email: user.email, role: user.role });
+    const { password: _pw, ...safeUser } = user;
+    return { user: safeUser, ...tokens };
+  },
+` : ''}};
+`;
+  }
+
+  // ── MySQL ──────────────────────────────────────────────────────────────────
+  if (database === 'mysql' || database === 'sqlite') {
+    const Model = 'UserModel';
+    return `import { ${Model} } from '../models/user.model.js';
+import { ApiError } from '../utils/apiError.js';
+${auth === 'jwt' ? "import { generateTokens } from '../helpers/token.helper.js';\n" : ''}
+export const UserService = {
+  async getAll() {
+    return ${Model}.findAll();
+  },
+
+  async getById(id${isTS ? ': number' : ''}) {
+    const user = await ${Model}.findById(id);
+    if (!user) throw new ApiError(404, 'User not found');
+    return user;
+  },
+
+  async create(data${isTS ? ': { name: string; email: string; password: string }' : ''}) {
+    const exists = await ${Model}.findByEmail(data.email);
+    if (exists) throw new ApiError(409, 'A user with this email already exists');
+    return ${Model}.create(data);
+  },
+
+  async update(id${isTS ? ': number' : ''}, data${isTS ? ': Record<string, any>' : ''}) {
+    const user = await ${Model}.findById(id);
+    if (!user) throw new ApiError(404, 'User not found');
+    return ${Model}.update(id, data);
+  },
+
+  async remove(id${isTS ? ': number' : ''}) {
+    const user = await ${Model}.findById(id);
+    if (!user) throw new ApiError(404, 'User not found');
+    await ${Model}.delete(id);
+    return { message: 'User deleted successfully' };
+  },
+${auth === 'jwt' ? `
+  async register(data${isTS ? ': { name: string; email: string; password: string }' : ''}) {
+    const exists = await ${Model}.findByEmail(data.email);
+    if (exists) throw new ApiError(409, 'Email already in use');
+    const user = await ${Model}.create(data);
+    const tokens = generateTokens({ id: String(user.id), email: user.email, role: user.role });
+    const { password: _pw, ...safeUser } = user;
+    return { user: safeUser, ...tokens };
+  },
+
+  async login(email${isTS ? ': string' : ''}, password${isTS ? ': string' : ''}) {
+    const user = await ${Model}.findByEmail(email);
+    if (!user) throw new ApiError(401, 'Invalid credentials');
+    const isMatch = await ${Model}.comparePassword(password, user.password || '');
+    if (!isMatch) throw new ApiError(401, 'Invalid credentials');
+    const tokens = generateTokens({ id: String(user.id), email: user.email, role: user.role });
+    const { password: _pw, ...safeUser } = user;
+    return { user: safeUser, ...tokens };
+  },
+` : ''}};
+`;
+  }
+
+  // ── No database ────────────────────────────────────────────────────────────
+  return `import { ApiError } from '../utils/apiError.js';
+
+/**
+ * User Service — In-Memory Store
+ *
+ * No database is configured. Uses an in-memory array as a placeholder.
+ * Replace with a real database integration before going to production.
+ */
+
+${isTS ? 'interface User { id: string; name: string; email: string; createdAt: string; }' : ''}
+
+const users${isTS ? ': User[]' : ''} = [];
+let nextId = 1;
+
+export const UserService = {
+  async getAll() { return users; },
+  async getById(id${isTS ? ': string' : ''}) {
+    const user = users.find((u) => u.id === id);
+    if (!user) throw new ApiError(404, 'User not found');
+    return user;
+  },
+  async create(data${isTS ? ': { name: string; email: string }' : ''}) {
+    const user = { id: String(nextId++), ...data, createdAt: new Date().toISOString() };
+    users.push(user);
+    return user;
+  },
+  async update(id${isTS ? ': string' : ''}, data${isTS ? ': Partial<User>' : ''}) {
+    const idx = users.findIndex((u) => u.id === id);
+    if (idx === -1) throw new ApiError(404, 'User not found');
+    users[idx] = { ...users[idx], ...data };
+    return users[idx];
+  },
+  async remove(id${isTS ? ': string' : ''}) {
+    const idx = users.findIndex((u) => u.id === id);
+    if (idx === -1) throw new ApiError(404, 'User not found');
+    users.splice(idx, 1);
+    return { message: 'User deleted' };
+  },
+};
+`;
+}

package/src/templates/typescript.js

@@ -0,0 +1,96 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// TypeScript-Specific Templates — tsconfig.json, src/types/index.ts
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** Generate tsconfig.json */
+export function tsconfig() {
+  return JSON.stringify(
+    {
+      compilerOptions: {
+        target:           'ES2022',
+        module:           'NodeNext',
+        moduleResolution: 'NodeNext',
+        outDir:           './dist',
+        rootDir:          './src',
+        strict:           true,
+        esModuleInterop:  true,
+        skipLibCheck:     true,
+        forceConsistentCasingInFileNames: true,
+        resolveJsonModule: true,
+        declaration:      true,
+        declarationMap:   true,
+        sourceMap:        true,
+        removeComments:   false,
+        noUnusedLocals:   true,
+        noUnusedParameters: false,
+        noImplicitReturns: true,
+        noFallthroughCasesInSwitch: true,
+        useUnknownInCatchVariables: true,
+        exactOptionalPropertyTypes: false,
+        lib:              ['ES2022'],
+        types:            ['node'],
+      },
+      include:  ['src/**/*.ts'],
+      exclude:  ['node_modules', 'dist', 'coverage'],
+    },
+    null,
+    2
+  );
+}
+
+/** Generate src/types/index.ts */
+export function tsTypes(options) {
+  const { auth } = options;
+
+  return `import type { Request } from 'express';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Global Type Extensions
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Extend Express Request to carry the authenticated user.
+ * Set by the auth middleware after token verification.
+ */
+declare global {
+  namespace Express {
+    interface Request {
+      user?: AuthUser;
+    }
+  }
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Shared Application Types
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface AuthUser {
+  id:    string;
+  email: string;
+  role:  string;
+}
+
+export interface PaginationQuery {
+  page?:  string;
+  limit?: string;
+  sort?:  string;
+  order?: 'asc' | 'desc';
+}
+
+export interface PaginatedResult<T> {
+  data:       T[];
+  total:      number;
+  page:       number;
+  limit:      number;
+  totalPages: number;
+}
+
+export type AsyncHandler = (
+  req: Request,
+  res: import('express').Response,
+  next: import('express').NextFunction
+) => Promise<void>;
+
+export {};
+`;
+}

package/src/templates/utils.js

@@ -0,0 +1,109 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Utility Templates — asyncHandler, ApiError, ApiResponse
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** Generate src/utils/asyncHandler.js */
+export function asyncHandler(options) {
+  const { language } = options;
+  const isTS = language === 'typescript';
+
+  return `${isTS ? `import { Request, Response, NextFunction } from 'express';\n\ntype AsyncRouteHandler = (req: Request, res: Response, next: NextFunction) => Promise<any>;\n` : ''}
+/**
+ * asyncHandler
+ *
+ * Wraps an async Express route handler to catch unhandled promise rejections
+ * and pass them to the next error-handling middleware (errorMiddleware).
+ *
+ * Usage:
+ *   router.get('/resource', asyncHandler(async (req, res) => { ... }));
+ *
+ * @param {Function} fn - Async route handler
+ * @returns {Function} - Standard Express (req, res, next) handler
+ */
+export const asyncHandler = (fn${isTS ? ': AsyncRouteHandler' : ''}) =>
+  (req${isTS ? ': Request' : ''}, res${isTS ? ': Response' : ''}, next${isTS ? ': NextFunction' : ''}) => {
+    Promise.resolve(fn(req, res, next)).catch(next);
+  };
+`;
+}
+
+/** Generate src/utils/apiError.js */
+export function apiError(options) {
+  const { language } = options;
+  const isTS = language === 'typescript';
+
+  return `/**
+ * ApiError — Custom Application Error Class
+ *
+ * Extends the native Error with HTTP status code and structured error list.
+ * Throw this in controllers/services and it will be caught by errorMiddleware.
+ *
+ * @example
+ *   throw new ApiError(404, 'User not found');
+ *   throw new ApiError(422, 'Validation failed', ['email is required']);
+ */
+export class ApiError extends Error {
+  statusCode${isTS ? ': number' : ''};
+  errors${isTS ? ': string[]' : ''};
+  success${isTS ? ': boolean' : ''};
+  data${isTS ? ': null' : ''};
+
+  constructor(
+    statusCode${isTS ? ': number' : ''},
+    message = 'An unexpected error occurred',
+    errors${isTS ? ': string[]' : ''} = [],
+    stack = ''
+  ) {
+    super(message);
+    this.name       = 'ApiError';
+    this.statusCode = statusCode;
+    this.errors     = errors;
+    this.success    = false;
+    this.data       = null;
+
+    if (stack) {
+      this.stack = stack;
+    } else {
+      Error.captureStackTrace(this, this.constructor);
+    }
+  }
+}
+`;
+}
+
+/** Generate src/utils/apiResponse.js */
+export function apiResponse(options) {
+  const { language } = options;
+  const isTS = language === 'typescript';
+
+  return `/**
+ * ApiResponse — Standardized HTTP Response Wrapper
+ *
+ * Creates a consistent JSON response shape across the entire API.
+ *
+ * Shape:
+ *   { success: boolean, statusCode: number, message: string, data: T }
+ *
+ * @example
+ *   res.status(200).json(new ApiResponse(200, users, 'Users fetched'));
+ *   res.status(201).json(new ApiResponse(201, newUser, 'User created'));
+ */
+export class ApiResponse${isTS ? '<T = unknown>' : ''} {
+  statusCode${isTS ? ': number' : ''};
+  data${isTS ? ': T' : ''};
+  message${isTS ? ': string' : ''};
+  success${isTS ? ': boolean' : ''};
+
+  constructor(
+    statusCode${isTS ? ': number' : ''},
+    data${isTS ? ': T' : ''},
+    message = 'Success'
+  ) {
+    this.statusCode = statusCode;
+    this.data       = data;
+    this.message    = message;
+    this.success    = statusCode < 400;
+  }
+}
+`;
+}