create-wabck 1.0.0

package/src/templates/controllers.js

@@ -0,0 +1,99 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Controller Templates — user.controller.js
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** Generate src/controllers/user.controller.js */
+export function userController(options) {
+  const { auth, language } = options;
+  const isTS = language === 'typescript';
+  const hasJwt = auth === 'jwt';
+
+  const typeImports = isTS
+    ? `import { Request, Response } from 'express';\n`
+    : '';
+
+  return `${typeImports}import { asyncHandler } from '../utils/asyncHandler.js';
+import { ApiResponse } from '../utils/apiResponse.js';
+import { UserService } from '../services/user.service.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// User CRUD Controllers
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** GET /api/v1/users — List all users */
+export const getAllUsers = asyncHandler(async (_req${isTS ? ': Request' : ''}, res${isTS ? ': Response' : ''}) => {
+  const users = await UserService.getAll();
+  res.status(200).json(new ApiResponse(200, users, 'Users fetched successfully'));
+});
+
+/** GET /api/v1/users/:id — Get user by ID */
+export const getUserById = asyncHandler(async (req${isTS ? ': Request' : ''}, res${isTS ? ': Response' : ''}) => {
+  const user = await UserService.getById(req.params.id);
+  res.status(200).json(new ApiResponse(200, user, 'User fetched successfully'));
+});
+
+/** POST /api/v1/users — Create a new user */
+export const createUser = asyncHandler(async (req${isTS ? ': Request' : ''}, res${isTS ? ': Response' : ''}) => {
+  const user = await UserService.create(req.body);
+  res.status(201).json(new ApiResponse(201, user, 'User created successfully'));
+});
+
+/** PUT /api/v1/users/:id — Update a user */
+export const updateUser = asyncHandler(async (req${isTS ? ': Request' : ''}, res${isTS ? ': Response' : ''}) => {
+  const user = await UserService.update(req.params.id, req.body);
+  res.status(200).json(new ApiResponse(200, user, 'User updated successfully'));
+});
+
+/** DELETE /api/v1/users/:id — Delete a user */
+export const deleteUser = asyncHandler(async (req${isTS ? ': Request' : ''}, res${isTS ? ': Response' : ''}) => {
+  const result = await UserService.remove(req.params.id);
+  res.status(200).json(new ApiResponse(200, result, 'User deleted successfully'));
+});
+${hasJwt ? `
+// ─────────────────────────────────────────────────────────────────────────────
+// Auth Controllers
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** POST /api/v1/auth/register */
+export const register = asyncHandler(async (req${isTS ? ': Request' : ''}, res${isTS ? ': Response' : ''}) => {
+  const result = await UserService.register(req.body);
+  res
+    .status(201)
+    .cookie('refreshToken', result.refreshToken, {
+      httpOnly: true,
+      secure:   process.env.NODE_ENV === 'production',
+      sameSite: 'strict',
+      maxAge:   30 * 24 * 60 * 60 * 1000, // 30 days
+    })
+    .json(new ApiResponse(201, result, 'Registration successful'));
+});
+
+/** POST /api/v1/auth/login */
+export const login = asyncHandler(async (req${isTS ? ': Request' : ''}, res${isTS ? ': Response' : ''}) => {
+  const { email, password } = req.body;
+  const result = await UserService.login(email, password);
+  res
+    .status(200)
+    .cookie('refreshToken', result.refreshToken, {
+      httpOnly: true,
+      secure:   process.env.NODE_ENV === 'production',
+      sameSite: 'strict',
+      maxAge:   30 * 24 * 60 * 60 * 1000, // 30 days
+    })
+    .json(new ApiResponse(200, result, 'Login successful'));
+});
+
+/** POST /api/v1/auth/logout */
+export const logout = asyncHandler(async (_req${isTS ? ': Request' : ''}, res${isTS ? ': Response' : ''}) => {
+  res
+    .clearCookie('refreshToken')
+    .status(200)
+    .json(new ApiResponse(200, null, 'Logged out successfully'));
+});
+
+/** GET /api/v1/auth/me — Get current authenticated user */
+export const getMe = asyncHandler(async (req${isTS ? ': Request' : ''}, res${isTS ? ': Response' : ''}) => {
+  const user = await UserService.getById((req${isTS ? ' as any' : ''}).user.id);
+  res.status(200).json(new ApiResponse(200, user, 'Profile fetched'));
+});
+` : ''}`;
+}

package/src/templates/docker.js

@@ -0,0 +1,205 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Docker Templates — Dockerfile, docker-compose.yml, .dockerignore
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** Generate Dockerfile */
+export function dockerfile(options) {
+  const { language, database } = options;
+  const isTS = language === 'typescript';
+  const port = 5000;
+
+  if (isTS) {
+    return `# ─── Stage 1: Build ──────────────────────────────────────────────────────────
+FROM node:20-alpine AS builder
+
+WORKDIR /app
+
+COPY package*.json ./
+RUN npm ci
+
+COPY . .
+RUN npm run build
+
+# ─── Stage 2: Production ─────────────────────────────────────────────────────
+FROM node:20-alpine AS production
+
+WORKDIR /app
+
+# Create non-root user for security
+RUN addgroup -g 1001 -S nodejs && \\
+    adduser  -S nodejs -u 1001
+
+COPY package*.json ./
+RUN npm ci --omit=dev
+
+COPY --from=builder --chown=nodejs:nodejs /app/dist ./dist
+
+USER nodejs
+
+EXPOSE ${port}
+
+HEALTHCHECK --interval=30s --timeout=5s --start-period=5s --retries=3 \\
+  CMD wget -qO- http://localhost:${port}/api/v1/health || exit 1
+
+CMD ["node", "dist/server.js"]
+`;
+  }
+
+  return `# ─── Stage 1: Dependencies ───────────────────────────────────────────────────
+FROM node:20-alpine AS deps
+
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci --omit=dev
+
+# ─── Stage 2: Production ─────────────────────────────────────────────────────
+FROM node:20-alpine AS production
+
+WORKDIR /app
+
+# Create non-root user
+RUN addgroup -g 1001 -S nodejs && \\
+    adduser  -S nodejs -u 1001
+
+COPY --from=deps --chown=nodejs:nodejs /app/node_modules ./node_modules
+COPY --chown=nodejs:nodejs . .
+
+USER nodejs
+
+EXPOSE ${port}
+
+HEALTHCHECK --interval=30s --timeout=5s --start-period=5s --retries=3 \\
+  CMD wget -qO- http://localhost:${port}/api/v1/health || exit 1
+
+CMD ["node", "src/server.js"]
+`;
+}
+
+/** Generate docker-compose.yml */
+export function dockerCompose(options) {
+  const { database, projectName } = options;
+  const safe = projectName.toLowerCase().replace(/[^a-z0-9]/g, '_');
+
+  const dbService = {
+    mongodb: `
+  mongo:
+    image: mongo:7-jammy
+    container_name: ${safe}_mongo
+    restart: unless-stopped
+    ports:
+      - "27017:27017"
+    environment:
+      MONGO_INITDB_DATABASE: ${safe}
+    volumes:
+      - mongo_data:/data/db
+    networks:
+      - app_network
+`,
+    postgresql: `
+  postgres:
+    image: postgres:16-alpine
+    container_name: ${safe}_postgres
+    restart: unless-stopped
+    ports:
+      - "5432:5432"
+    environment:
+      POSTGRES_USER:     \${DB_USER:-postgres}
+      POSTGRES_PASSWORD: \${DB_PASSWORD:-password}
+      POSTGRES_DB:       \${DB_NAME:-${safe}}
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    networks:
+      - app_network
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+`,
+    mysql: `
+  mysql:
+    image: mysql:8.0
+    container_name: ${safe}_mysql
+    restart: unless-stopped
+    ports:
+      - "3306:3306"
+    environment:
+      MYSQL_ROOT_PASSWORD: \${DB_PASSWORD:-password}
+      MYSQL_DATABASE:      \${DB_NAME:-${safe}}
+      MYSQL_USER:          \${DB_USER:-appuser}
+      MYSQL_PASSWORD:      \${DB_PASSWORD:-password}
+    volumes:
+      - mysql_data:/var/lib/mysql
+    networks:
+      - app_network
+    healthcheck:
+      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+`,
+    sqlite: '',
+    none:   '',
+  }[database] || '';
+
+  const dbVolume = {
+    mongodb:    '  mongo_data:\n',
+    postgresql: '  postgres_data:\n',
+    mysql:      '  mysql_data:\n',
+    sqlite:     '',
+    none:       '',
+  }[database] || '';
+
+  const dbDepends = ['mongodb', 'postgresql', 'mysql'].includes(database)
+    ? `    depends_on:\n      - ${database === 'mongodb' ? 'mongo' : database}\n`
+    : '';
+
+  return `# docker-compose.yml — ${projectName}
+# Usage: docker compose up --build
+
+version: '3.9'
+
+services:
+  app:
+    build:
+      context: .
+      target:  production
+    container_name: ${safe}_app
+    restart: unless-stopped
+    ports:
+      - "\${PORT:-5000}:5000"
+    env_file:
+      - .env
+    networks:
+      - app_network
+${dbDepends}    healthcheck:
+      test: ["CMD", "wget", "-qO-", "http://localhost:5000/api/v1/health"]
+      interval: 30s
+      timeout:  10s
+      retries:  3
+      start_period: 30s
+${dbService}
+networks:
+  app_network:
+    driver: bridge
+
+${dbVolume ? `volumes:\n${dbVolume}` : ''}`;
+}
+
+/** Generate .dockerignore */
+export function dockerignore() {
+  return `node_modules/
+npm-debug.log*
+.git/
+.gitignore
+.env
+.env.local
+dist/
+coverage/
+*.md
+.dockerignore
+Dockerfile
+docker-compose.yml
+.DS_Store
+`;
+}

package/src/templates/graphql.js

@@ -0,0 +1,157 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// GraphQL Templates — Apollo Server 4 integration
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** Generate src/graphql/schema.js */
+export function graphqlSchema(options) {
+  const { language } = options;
+  const isTS = language === 'typescript';
+
+  return `import { gql } from 'graphql-tag';
+
+/**
+ * GraphQL Type Definitions
+ *
+ * Defines the schema for the API including:
+ * - User type
+ * - Queries  (getUsers, getUserById)
+ * - Mutations (createUser, updateUser, deleteUser)
+ */
+export const typeDefs = gql\`
+  type User {
+    id:        ID!
+    name:      String!
+    email:     String!
+    role:      String!
+    isActive:  Boolean!
+    createdAt: String!
+    updatedAt: String!
+  }
+
+  type AuthPayload {
+    user:         User!
+    accessToken:  String!
+    refreshToken: String!
+  }
+
+  type DeleteResult {
+    message: String!
+  }
+
+  input CreateUserInput {
+    name:     String!
+    email:    String!
+    password: String!
+  }
+
+  input UpdateUserInput {
+    name:  String
+    email: String
+  }
+
+  type Query {
+    "Get all active users"
+    users: [User!]!
+
+    "Get a single user by ID"
+    user(id: ID!): User
+  }
+
+  type Mutation {
+    "Create a new user"
+    createUser(input: CreateUserInput!): User!
+
+    "Update an existing user"
+    updateUser(id: ID!, input: UpdateUserInput!): User!
+
+    "Delete a user"
+    deleteUser(id: ID!): DeleteResult!
+  }
+\`;
+`;
+}
+
+/** Generate src/graphql/resolvers.js */
+export function graphqlResolvers(options) {
+  const { language } = options;
+  const isTS = language === 'typescript';
+
+  return `import { UserService } from '../services/user.service.js';
+import { ApiError } from '../utils/apiError.js';
+
+/**
+ * GraphQL Resolvers
+ *
+ * Maps GraphQL operations to service layer methods.
+ * Errors thrown by services are naturally propagated to Apollo's error handler.
+ */
+export const resolvers = {
+  Query: {
+    users: async (_parent${isTS ? ': unknown' : ''}, _args${isTS ? ': unknown' : ''}, _ctx${isTS ? ': unknown' : ''}) => {
+      return UserService.getAll();
+    },
+
+    user: async (_parent${isTS ? ': unknown' : ''}, args${isTS ? ': { id: string }' : ''}, _ctx${isTS ? ': unknown' : ''}) => {
+      return UserService.getById(args.id);
+    },
+  },
+
+  Mutation: {
+    createUser: async (
+      _parent${isTS ? ': unknown' : ''},
+      args${isTS ? ': { input: { name: string; email: string; password: string } }' : ''},
+      _ctx${isTS ? ': unknown' : ''}
+    ) => {
+      return UserService.create(args.input);
+    },
+
+    updateUser: async (
+      _parent${isTS ? ': unknown' : ''},
+      args${isTS ? ': { id: string; input: { name?: string; email?: string } }' : ''},
+      _ctx${isTS ? ': unknown' : ''}
+    ) => {
+      return UserService.update(args.id, args.input);
+    },
+
+    deleteUser: async (_parent${isTS ? ': unknown' : ''}, args${isTS ? ': { id: string }' : ''}, _ctx${isTS ? ': unknown' : ''}) => {
+      return UserService.remove(args.id);
+    },
+  },
+};
+`;
+}
+
+/** Generate src/graphql/server.js */
+export function graphqlServer(options) {
+  const { language } = options;
+  const isTS = language === 'typescript';
+
+  return `import { ApolloServer } from '@apollo/server';
+import { typeDefs } from './schema.js';
+import { resolvers } from './resolvers.js';
+
+/**
+ * Creates and returns a configured Apollo Server instance.
+ * Mount via expressMiddleware in app.js.
+ *
+ * @returns {ApolloServer}
+ */
+export function createApolloServer()${isTS ? ': ApolloServer' : ''} {
+  return new ApolloServer({
+    typeDefs,
+    resolvers,
+    introspection: process.env.NODE_ENV !== 'production',
+    formatError: (formattedError${isTS ? ': any' : ''}, error${isTS ? ': unknown' : ''}) => {
+      // Mask internal server errors in production
+      if (
+        process.env.NODE_ENV === 'production' &&
+        formattedError.extensions?.code === 'INTERNAL_SERVER_ERROR'
+      ) {
+        return { message: 'Internal server error' };
+      }
+      return formattedError;
+    },
+  });
+}
+`;
+}

package/src/templates/helpers.js

@@ -0,0 +1,117 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Helper Templates — token.helper.js, constants, etc.
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** Generate src/helpers/token.helper.js (JWT only) */
+export function tokenHelper(options) {
+  const { language } = options;
+  const isTS = language === 'typescript';
+
+  return `import jwt from 'jsonwebtoken';
+import { ApiError } from '../utils/apiError.js';
+
+${isTS ? `
+interface TokenPayload {
+  id:    string;
+  email: string;
+  role:  string;
+}
+
+interface TokenPair {
+  accessToken:  string;
+  refreshToken: string;
+}
+` : ''}
+const ACCESS_TOKEN_EXPIRY  = process.env.JWT_EXPIRES_IN        || '15m';
+const REFRESH_TOKEN_EXPIRY = process.env.JWT_REFRESH_EXPIRES_IN || '30d';
+
+/**
+ * Generates an access token + refresh token pair for the given payload.
+ *
+ * Access tokens are short-lived (15 min by default).
+ * Refresh tokens are long-lived (30 days by default).
+ *
+ * @param payload - Data to embed in the token { id, email, role }
+ * @returns {{ accessToken, refreshToken }}
+ */
+export function generateTokens(payload${isTS ? ': TokenPayload' : ''})${isTS ? ': TokenPair' : ''} {
+  const secret = process.env.JWT_SECRET;
+  if (!secret) throw new ApiError(500, 'JWT_SECRET is not configured');
+
+  const accessToken = jwt.sign(payload, secret, {
+    expiresIn: ACCESS_TOKEN_EXPIRY,
+  });
+
+  const refreshToken = jwt.sign({ id: payload.id }, secret, {
+    expiresIn: REFRESH_TOKEN_EXPIRY,
+  });
+
+  return { accessToken, refreshToken };
+}
+
+/**
+ * Verifies a JWT token and returns the decoded payload.
+ * Throws an ApiError on invalid or expired tokens.
+ *
+ * @param token - The raw JWT string
+ * @returns Decoded payload
+ */
+export function verifyToken(token${isTS ? ': string' : ''})${isTS ? ': TokenPayload & jwt.JwtPayload' : ''} {
+  const secret = process.env.JWT_SECRET;
+  if (!secret) throw new ApiError(500, 'JWT_SECRET is not configured');
+
+  try {
+    return jwt.verify(token, secret)${isTS ? ' as TokenPayload & jwt.JwtPayload' : ''};
+  } catch (error) {
+    if ((error${isTS ? ' as Error' : ''}).name === 'TokenExpiredError') {
+      throw new ApiError(401, 'Token has expired. Please log in again.');
+    }
+    throw new ApiError(401, 'Invalid token. Please log in again.');
+  }
+}
+`;
+}
+
+/** Generate src/constants/index.js */
+export function constants(options) {
+  const { language } = options;
+  const isTS = language === 'typescript';
+
+  return `// ─────────────────────────────────────────────────────────────────────────────
+// Application-Wide Constants
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** HTTP Status Codes — avoids magic numbers in controllers/services */
+export const HTTP_STATUS = {
+  OK:                    200,
+  CREATED:               201,
+  NO_CONTENT:            204,
+  BAD_REQUEST:           400,
+  UNAUTHORIZED:          401,
+  FORBIDDEN:             403,
+  NOT_FOUND:             404,
+  CONFLICT:              409,
+  UNPROCESSABLE_ENTITY:  422,
+  TOO_MANY_REQUESTS:     429,
+  INTERNAL_SERVER_ERROR: 500,
+}${isTS ? ' as const' : ''};
+
+/** User roles */
+export const ROLES = {
+  USER:  'user',
+  ADMIN: 'admin',
+}${isTS ? ' as const' : ''};
+
+/** Default pagination settings */
+export const PAGINATION = {
+  DEFAULT_PAGE:  1,
+  DEFAULT_LIMIT: 10,
+  MAX_LIMIT:     100,
+}${isTS ? ' as const' : ''};
+
+/** Cookie names */
+export const COOKIES = {
+  REFRESH_TOKEN: 'refreshToken',
+}${isTS ? ' as const' : ''};
+`;
+}

package/src/templates/index.js

@@ -0,0 +1,78 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Template Index — Re-exports all template functions
+// ─────────────────────────────────────────────────────────────────────────────
+
+export {
+  app,
+  server,
+  envFile,
+  envExample,
+  gitignore,
+  prettierrc,
+  eslintConfig,
+  readme,
+} from './base.js';
+
+export {
+  db,
+  envConfig,
+} from './config.js';
+
+export {
+  routesIndex,
+  healthRoute,
+  userRoute,
+  authRoute,
+} from './routes.js';
+
+export {
+  userController,
+} from './controllers.js';
+
+export {
+  userModel,
+  prismaSchema,
+} from './models.js';
+
+export {
+  errorMiddleware,
+  notFoundMiddleware,
+  rateLimiterMiddleware,
+  authMiddleware,
+} from './middlewares.js';
+
+export {
+  userService,
+} from './services.js';
+
+export {
+  asyncHandler,
+  apiError,
+  apiResponse,
+} from './utils.js';
+
+export {
+  userValidator,
+} from './validators.js';
+
+export {
+  tokenHelper,
+  constants,
+} from './helpers.js';
+
+export {
+  dockerfile,
+  dockerCompose,
+  dockerignore,
+} from './docker.js';
+
+export {
+  tsconfig,
+  tsTypes,
+} from './typescript.js';
+
+export {
+  graphqlSchema,
+  graphqlResolvers,
+  graphqlServer,
+} from './graphql.js';