create-wabck 1.0.0

package/src/templates/validators.js

@@ -0,0 +1,183 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Validator Templates — user.validator.js
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** Generate src/validators/user.validator.js */
+export function userValidator(options) {
+  const { validation, language } = options;
+  const isTS = language === 'typescript';
+
+  // ── Zod ─────────────────────────────────────────────────────────────────────
+  if (validation === 'zod') {
+    return `import { z } from 'zod';
+${isTS ? "import { Request, Response, NextFunction } from 'express';\n" : ''}
+// ─────────────────────────────────────────────────────────────────────────────
+// Zod Schemas
+// ─────────────────────────────────────────────────────────────────────────────
+
+export const createUserSchema = z.object({
+  body: z.object({
+    name:     z.string().min(2, 'Name must be at least 2 characters').max(50),
+    email:    z.string().email('Invalid email address'),
+    password: z
+      .string()
+      .min(8, 'Password must be at least 8 characters')
+      .regex(/[A-Z]/, 'Password must contain at least one uppercase letter')
+      .regex(/[0-9]/, 'Password must contain at least one number'),
+  }),
+});
+
+export const updateUserSchema = z.object({
+  body: z.object({
+    name:  z.string().min(2).max(50).optional(),
+    email: z.string().email().optional(),
+  }),
+  params: z.object({
+    id: z.string().min(1, 'User ID is required'),
+  }),
+});
+
+export const loginSchema = z.object({
+  body: z.object({
+    email:    z.string().email('Invalid email'),
+    password: z.string().min(1, 'Password is required'),
+  }),
+});
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Validation Middleware Factory
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Creates an Express middleware that validates the request against a Zod schema.
+ * Throws a ZodError (caught by errorMiddleware) on failure.
+ *
+ * @param {z.ZodSchema} schema - Zod schema with body/params/query fields
+ */
+export const validate = (schema${isTS ? ': z.ZodSchema' : ''}) =>
+  (req${isTS ? ': Request' : ''}, _res${isTS ? ': Response' : ''}, next${isTS ? ': NextFunction' : ''}) => {
+    schema.parse({
+      body:   req.body,
+      params: req.params,
+      query:  req.query,
+    });
+    next();
+  };
+`;
+  }
+
+  // ── Joi ──────────────────────────────────────────────────────────────────────
+  if (validation === 'joi') {
+    return `import Joi from 'joi';
+${isTS ? "import { Request, Response, NextFunction } from 'express';\n" : ''}
+// ─────────────────────────────────────────────────────────────────────────────
+// Joi Schemas
+// ─────────────────────────────────────────────────────────────────────────────
+
+export const createUserSchema = Joi.object({
+  name:     Joi.string().min(2).max(50).required(),
+  email:    Joi.string().email().required(),
+  password: Joi.string()
+    .min(8)
+    .pattern(/[A-Z]/, 'uppercase')
+    .pattern(/[0-9]/, 'number')
+    .required()
+    .messages({
+      'string.pattern.name': 'Password must contain at least one {{#name}}',
+    }),
+});
+
+export const updateUserSchema = Joi.object({
+  name:  Joi.string().min(2).max(50),
+  email: Joi.string().email(),
+}).min(1);
+
+export const loginSchema = Joi.object({
+  email:    Joi.string().email().required(),
+  password: Joi.string().required(),
+});
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Validation Middleware Factory
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Creates an Express middleware that validates req.body against a Joi schema.
+ * Passes a 422 ApiError to next() on failure.
+ */
+export const validate = (schema${isTS ? ': Joi.Schema' : ''}) =>
+  (req${isTS ? ': Request' : ''}, _res${isTS ? ': Response' : ''}, next${isTS ? ': NextFunction' : ''}) => {
+    const { error } = schema.validate(req.body, { abortEarly: false });
+    if (error) {
+      const messages = error.details.map((d${isTS ? ': Joi.ValidationErrorItem' : ''}) => d.message);
+      const err = new Error('Validation failed');
+      (err${isTS ? ' as any' : ''}).statusCode = 422;
+      (err${isTS ? ' as any' : ''}).errors = messages;
+      return next(err);
+    }
+    next();
+  };
+`;
+  }
+
+  // ── Express Validator ──────────────────────────────────────────────────────
+  return `import { body, param, validationResult } from 'express-validator';
+${isTS ? "import { Request, Response, NextFunction } from 'express';\n" : ''}
+// ─────────────────────────────────────────────────────────────────────────────
+// Express Validator Rules
+// ─────────────────────────────────────────────────────────────────────────────
+
+export const createUserRules = [
+  body('name')
+    .trim()
+    .isLength({ min: 2, max: 50 })
+    .withMessage('Name must be between 2 and 50 characters'),
+  body('email')
+    .isEmail()
+    .normalizeEmail()
+    .withMessage('Must be a valid email address'),
+  body('password')
+    .isLength({ min: 8 })
+    .withMessage('Password must be at least 8 characters')
+    .matches(/[A-Z]/)
+    .withMessage('Password must contain at least one uppercase letter')
+    .matches(/[0-9]/)
+    .withMessage('Password must contain at least one number'),
+];
+
+export const updateUserRules = [
+  param('id').notEmpty().withMessage('User ID is required'),
+  body('name').optional().trim().isLength({ min: 2, max: 50 }),
+  body('email').optional().isEmail().normalizeEmail(),
+];
+
+export const loginRules = [
+  body('email').isEmail().normalizeEmail().withMessage('Valid email required'),
+  body('password').notEmpty().withMessage('Password is required'),
+];
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Validation Error Handler Middleware
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Run after validation rule arrays. Collects all errors and passes a
+ * 422 error to next() if any rules failed.
+ */
+export const handleValidationErrors = (
+  req${isTS ? ': Request' : ''},
+  _res${isTS ? ': Response' : ''},
+  next${isTS ? ': NextFunction' : ''}
+) => {
+  const errors = validationResult(req);
+  if (!errors.isEmpty()) {
+    const messages = errors.array().map((e${isTS ? ': any' : ''}) => e.msg);
+    const err = new Error('Validation failed');
+    (err${isTS ? ' as any' : ''}).statusCode = 422;
+    (err${isTS ? ' as any' : ''}).errors = messages;
+    return next(err);
+  }
+  next();
+};
+`;
+}

package/src/utils/fs.js

@@ -0,0 +1,41 @@
+import fs from 'fs-extra';
+import path from 'path';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// File System Utilities (thin wrappers around fs-extra)
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Ensures a directory exists, creating it (and parents) if necessary.
+ * @param {string} dirPath
+ */
+export async function createDir(dirPath) {
+  await fs.ensureDir(dirPath);
+}
+
+/**
+ * Writes content to a file, creating all ancestor directories as needed.
+ * @param {string} filePath
+ * @param {string} content
+ */
+export async function writeFile(filePath, content) {
+  await fs.ensureDir(path.dirname(filePath));
+  await fs.writeFile(filePath, content, 'utf-8');
+}
+
+/**
+ * Checks if a path (file or directory) exists.
+ * @param {string} p
+ * @returns {Promise<boolean>}
+ */
+export async function pathExists(p) {
+  return fs.pathExists(p);
+}
+
+/**
+ * Removes a file or directory recursively. Silent on missing paths.
+ * @param {string} p
+ */
+export async function remove(p) {
+  return fs.remove(p);
+}

package/src/utils/logger.js

@@ -0,0 +1,89 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import boxen from 'boxen';
+import gradient from 'gradient-string';
+import figlet from 'figlet';
+
+/** Promisify figlet manually to avoid DEP0174 warning */
+const figletAsync = (text, opts) =>
+  new Promise((resolve, reject) => {
+    figlet.text(text, opts, (err, data) => (err ? reject(err) : resolve(data)));
+  });
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Colorized Logger
+// ─────────────────────────────────────────────────────────────────────────────
+
+export const log = {
+  info:    (msg) => console.log(chalk.cyan('ℹ ') + chalk.white(msg)),
+  success: (msg) => console.log(chalk.green('✔ ') + chalk.green(msg)),
+  error:   (msg) => console.log(chalk.red('✖ ')  + chalk.red(msg)),
+  warn:    (msg) => console.log(chalk.yellow('⚠ ') + chalk.yellow(msg)),
+  step:    (msg) => console.log(chalk.blue('→ ')  + chalk.white(msg)),
+  dim:     (msg) => console.log(chalk.dim(msg)),
+  label:   (label, value) => console.log(chalk.cyan(`  ${label}: `) + chalk.white(value)),
+  blank:   ()    => console.log(),
+};
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Spinner Factory
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Creates a pre-configured ora spinner.
+ * @param {string} text - Initial spinner text
+ * @returns {import('ora').Ora}
+ */
+export const spinner = (text) =>
+  ora({
+    text: chalk.cyan(text),
+    color: 'cyan',
+    spinner: 'dots',
+  });
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Boxen Wrapper
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Wraps content in a styled boxen box.
+ * @param {string} content
+ * @param {import('boxen').Options} opts
+ */
+export const box = (content, opts = {}) =>
+  boxen(content, {
+    padding: 1,
+    margin: { top: 0, bottom: 1, left: 1, right: 1 },
+    borderStyle: 'round',
+    borderColor: 'cyan',
+    ...opts,
+  });
+
+// ─────────────────────────────────────────────────────────────────────────────
+// ASCII Art Banner
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Renders the WABCK banner with gradient colors and a subtitle box.
+ */
+export async function renderBanner() {
+  try {
+    const art = await figletAsync('WABCK', {
+      font: 'ANSI Shadow',
+      horizontalLayout: 'default',
+      verticalLayout: 'default',
+    });
+    console.log(gradient.cristal.multiline(art));
+  } catch {
+    // Fallback if figlet font fails
+    console.log(gradient.cristal('\n  ██╗    ██╗ █████╗ ██████╗  ██████╗██╗  ██╗\n  ██║    ██║██╔══██╗██╔══██╗██╔════╝██║ ██╔╝\n  ██║ █╗ ██║███████║██████╔╝██║     █████╔╝ \n  ██║███╗██║██╔══██║██╔══██╗██║     ██╔═██╗ \n  ╚███╔███╔╝██║  ██║██████╔╝╚██████╗██║  ██╗\n   ╚══╝╚══╝ ╚═╝  ╚═╝╚═════╝  ╚═════╝╚═╝  ╚═╝\n'));
+  }
+
+  console.log(
+    box(
+      chalk.white('⚡ Scaffold production-ready Express.js backends in seconds\n') +
+        chalk.dim('   by wabck — https://github.com/wabck/wabck'),
+      { borderColor: 'magenta', padding: { top: 0, bottom: 0, left: 2, right: 2 } }
+    )
+  );
+}

package/src/utils/pkg.js

@@ -0,0 +1,158 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// package.json Builder for the Generated Project
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Builds a complete package.json object based on the user's selections.
+ * @param {object} options - Options from the CLI prompts
+ * @returns {object} - Parsed package.json content
+ */
+export function buildPackageJson(options) {
+  const { projectName, language, database, auth, validation, apiStyle } = options;
+  const isTS = language === 'typescript';
+
+  // ── Scripts ────────────────────────────────────────────────────────────────
+  const scripts = isTS
+    ? {
+        dev:        'tsx watch src/server.ts',
+        build:      'tsc --outDir dist',
+        start:      'node dist/server.js',
+        lint:       'eslint src --ext .ts',
+        'lint:fix': 'eslint src --ext .ts --fix',
+        'type-check': 'tsc --noEmit',
+      }
+    : {
+        dev:        'nodemon src/server.js',
+        start:      'node src/server.js',
+        lint:       'eslint src',
+        'lint:fix': 'eslint src --fix',
+      };
+
+  // ── Core Dependencies (always included) ────────────────────────────────────
+  const dependencies = {
+    express:              '^4.19.2',
+    dotenv:               '^16.4.5',
+    cors:                 '^2.8.5',
+    helmet:               '^7.1.0',
+    compression:          '^1.7.4',
+    morgan:               '^1.10.0',
+    'cookie-parser':      '^1.4.6',
+    'express-rate-limit': '^7.3.1',
+  };
+
+  // ── Dev Dependencies ───────────────────────────────────────────────────────
+  const devDependencies = {
+    eslint:                   '^9.6.0',
+    '@eslint/js':             '^9.6.0',
+    prettier:                 '^3.3.2',
+    'eslint-config-prettier': '^9.1.0',
+    'eslint-plugin-prettier': '^5.1.3',
+  };
+
+  if (isTS) {
+    Object.assign(devDependencies, {
+      typescript:             '^5.4.5',
+      tsx:                    '^4.15.7',
+      '@types/express':       '^4.17.21',
+      '@types/node':          '^20.14.9',
+      '@types/cors':          '^2.8.17',
+      '@types/morgan':        '^1.9.9',
+      '@types/compression':   '^1.7.5',
+      '@types/cookie-parser': '^1.4.7',
+    });
+  } else {
+    devDependencies.nodemon = '^3.1.4';
+  }
+
+  // ── Database ───────────────────────────────────────────────────────────────
+  switch (database) {
+    case 'mongodb':
+      dependencies.mongoose = '^8.4.4';
+      break;
+    case 'postgresql':
+      dependencies['@prisma/client'] = '^5.16.1';
+      devDependencies.prisma         = '^5.16.1';
+      break;
+    case 'mysql':
+      dependencies.mysql2 = '^3.10.1';
+      break;
+    case 'sqlite':
+      dependencies['better-sqlite3'] = '^9.6.0';
+      if (isTS) devDependencies['@types/better-sqlite3'] = '^7.6.11';
+      break;
+    // 'none' → no extra dependency
+  }
+
+  // ── Authentication ─────────────────────────────────────────────────────────
+  switch (auth) {
+    case 'jwt':
+      dependencies.jsonwebtoken = '^9.0.2';
+      dependencies.bcryptjs     = '^2.4.3';
+      if (isTS) {
+        devDependencies['@types/jsonwebtoken'] = '^9.0.6';
+        devDependencies['@types/bcryptjs']     = '^2.4.6';
+      }
+      break;
+    case 'clerk':
+      dependencies['@clerk/express'] = '^1.1.2';
+      break;
+    case 'firebase':
+      dependencies['firebase-admin'] = '^12.2.0';
+      break;
+    // 'none' → no extra dependency
+  }
+
+  // ── Validation ─────────────────────────────────────────────────────────────
+  switch (validation) {
+    case 'zod':
+      dependencies.zod = '^3.23.8';
+      break;
+    case 'joi':
+      dependencies.joi = '^17.13.1';
+      break;
+    case 'express-validator':
+      dependencies['express-validator'] = '^7.1.0';
+      break;
+  }
+
+  // ── API Style ──────────────────────────────────────────────────────────────
+  if (apiStyle === 'graphql') {
+    dependencies['@apollo/server']         = '^4.10.5';
+    dependencies['graphql']                = '^16.9.0';
+    dependencies['@as-integrations/express4'] = '^1.0.0';
+  }
+
+  return {
+    name:        projectName,
+    version:     '1.0.0',
+    description: `${projectName} — Production-ready Express.js API`,
+    type:        'module',
+    main:        isTS ? 'dist/server.js' : 'src/server.js',
+    scripts,
+    dependencies,
+    devDependencies,
+    engines:     { node: '>=18.0.0' },
+    keywords:    ['express', 'api', 'backend', 'nodejs'],
+    author:      '',
+    license:     'MIT',
+  };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Install Command Builder
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Returns the install command args for the chosen package manager.
+ * @param {'npm'|'pnpm'|'yarn'|'bun'} pm - Package manager
+ * @returns {{ cmd: string, args: string[] }}
+ */
+export function getInstallCmd(pm) {
+  const map = {
+    npm:  { cmd: 'npm',  args: ['install'] },
+    pnpm: { cmd: 'pnpm', args: ['install'] },
+    yarn: { cmd: 'yarn', args: [] },
+    bun:  { cmd: 'bun',  args: ['install'] },
+  };
+  return map[pm] ?? map.npm;
+}