servcraft 0.1.0

package/.dockerignore

@@ -0,0 +1,45 @@
+# Dependencies
+node_modules
+
+# Build output
+dist
+
+# Git
+.git
+.gitignore
+
+# IDE
+.vscode
+.idea
+
+# Logs
+logs
+*.log
+
+# Environment files
+.env
+.env.local
+.env.*.local
+
+# Test coverage
+coverage
+
+# Docker files (not needed inside container)
+Dockerfile*
+docker-compose*
+.dockerignore
+
+# Documentation
+*.md
+docs
+
+# Tests
+tests
+**/*.test.ts
+**/*.spec.ts
+
+# Misc
+.DS_Store
+Thumbs.db
+*.swp
+*.swo

package/.env.example

@@ -0,0 +1,46 @@
+# =================================
+# Server Configuration
+# =================================
+NODE_ENV=development
+PORT=3000
+HOST=0.0.0.0
+
+# =================================
+# Database
+# =================================
+DATABASE_URL="postgresql://user:password@localhost:5432/servcraft?schema=public"
+# DATABASE_URL="mysql://user:password@localhost:3306/servcraft"
+# DATABASE_URL="file:./dev.db"
+
+# =================================
+# JWT Configuration
+# =================================
+JWT_SECRET=your-super-secret-key-min-32-characters-long
+JWT_ACCESS_EXPIRES_IN=15m
+JWT_REFRESH_EXPIRES_IN=7d
+
+# =================================
+# Security
+# =================================
+CORS_ORIGIN=http://localhost:3000,http://localhost:5173
+RATE_LIMIT_MAX=100
+RATE_LIMIT_WINDOW_MS=60000
+
+# =================================
+# Email (SMTP)
+# =================================
+SMTP_HOST=smtp.example.com
+SMTP_PORT=587
+SMTP_USER=your-email@example.com
+SMTP_PASS=your-email-password
+SMTP_FROM="Servcraft <noreply@example.com>"
+
+# =================================
+# Redis (Optional)
+# =================================
+REDIS_URL=redis://localhost:6379
+
+# =================================
+# Logging
+# =================================
+LOG_LEVEL=info

package/.husky/commit-msg

@@ -0,0 +1 @@
+npx --no -- commitlint --edit "$1"

package/.husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged

package/.prettierignore

@@ -0,0 +1,4 @@
+dist
+node_modules
+coverage
+*.md

package/.prettierrc

@@ -0,0 +1,11 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "bracketSpacing": true,
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}

package/Dockerfile

@@ -0,0 +1,76 @@
+# ==========================================
+# Servcraft - Production Dockerfile
+# Multi-stage build for optimized image size
+# ==========================================
+
+# Stage 1: Dependencies
+FROM node:20-alpine AS deps
+WORKDIR /app
+
+# Install dependencies needed for native modules
+RUN apk add --no-cache libc6-compat
+
+# Copy package files
+COPY package*.json ./
+COPY prisma ./prisma/
+
+# Install dependencies
+RUN npm ci --only=production && npm cache clean --force
+
+# Generate Prisma client
+RUN npx prisma generate
+
+# Stage 2: Builder
+FROM node:20-alpine AS builder
+WORKDIR /app
+
+COPY package*.json ./
+COPY tsconfig.json ./
+COPY tsup.config.ts ./
+COPY prisma ./prisma/
+
+# Install all dependencies (including dev)
+RUN npm ci
+
+# Copy source code
+COPY src ./src
+
+# Generate Prisma client
+RUN npx prisma generate
+
+# Build the application
+RUN npm run build
+
+# Stage 3: Production
+FROM node:20-alpine AS production
+WORKDIR /app
+
+# Add non-root user for security
+RUN addgroup --system --gid 1001 nodejs
+RUN adduser --system --uid 1001 servcraft
+
+# Set environment
+ENV NODE_ENV=production
+ENV PORT=3000
+
+# Copy necessary files from previous stages
+COPY --from=deps /app/node_modules ./node_modules
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/prisma ./prisma
+COPY package*.json ./
+
+# Set ownership
+RUN chown -R servcraft:nodejs /app
+
+# Switch to non-root user
+USER servcraft
+
+# Expose port
+EXPOSE 3000
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+  CMD wget --no-verbose --tries=1 --spider http://localhost:3000/health || exit 1
+
+# Start the application
+CMD ["node", "dist/index.js"]

package/Dockerfile.dev

@@ -0,0 +1,31 @@
+# ==========================================
+# Servcraft - Development Dockerfile
+# ==========================================
+
+FROM node:20-alpine
+
+WORKDIR /app
+
+# Install dependencies needed for native modules
+RUN apk add --no-cache libc6-compat
+
+# Copy package files
+COPY package*.json ./
+
+# Install all dependencies
+RUN npm install
+
+# Copy prisma schema
+COPY prisma ./prisma/
+
+# Generate Prisma client
+RUN npx prisma generate
+
+# Copy source code
+COPY . .
+
+# Expose port
+EXPOSE 3000
+
+# Start in development mode with hot reload
+CMD ["npm", "run", "dev"]

package/README.md

@@ -0,0 +1,232 @@
+# Servcraft
+
+A modular, production-ready Node.js backend framework built with TypeScript, Fastify, and Prisma.
+
+## Features
+
+- **Core Server**: Fastify with graceful shutdown, health checks
+- **Authentication**: JWT access/refresh tokens, RBAC
+- **User Management**: Full CRUD with roles & permissions
+- **Validation**: Zod/Joi/Yup support
+- **Database**: Prisma ORM (PostgreSQL, MySQL, SQLite)
+- **Email**: SMTP with Handlebars templates
+- **Security**: Helmet, CORS, Rate limiting
+- **Logging**: Pino structured logs + Audit trail
+- **Docker**: Ready for containerization
+- **CLI**: Generate modules, controllers, services
+
+## Quick Start
+
+### Create a new project
+
+```bash
+npx servcraft init my-app
+cd my-app
+npm run dev
+```
+
+### Interactive setup
+
+```bash
+npx servcraft init
+```
+
+You'll be prompted to choose:
+- Project name
+- Language (TypeScript/JavaScript)
+- Database (PostgreSQL, MySQL, SQLite, MongoDB)
+- Validation library (Zod, Joi, Yup)
+- Features (Auth, Users, Email, etc.)
+
+## CLI Commands
+
+### Initialize project
+
+```bash
+servcraft init [name]           # Create new project
+servcraft init --yes            # Use defaults
+servcraft init --js             # Use JavaScript
+servcraft init --db postgresql  # Specify database
+```
+
+### Generate resources
+
+```bash
+# Generate complete module
+servcraft generate module product
+servcraft g m product --prisma   # Include Prisma model
+
+# Generate individual files
+servcraft generate controller user
+servcraft generate service order
+servcraft generate repository item
+servcraft generate schema post
+servcraft generate routes comment
+
+# Aliases
+servcraft g c user              # controller
+servcraft g s order             # service
+servcraft g r item              # repository
+servcraft g v post              # schema/validator
+```
+
+### Add pre-built modules
+
+```bash
+servcraft add auth              # Authentication module
+servcraft add users             # User management
+servcraft add email             # Email service
+servcraft add audit             # Audit logging
+servcraft add cache             # Redis cache
+servcraft add upload            # File uploads
+servcraft add --list            # Show all modules
+```
+
+### Database commands
+
+```bash
+servcraft db migrate            # Run migrations
+servcraft db push               # Push schema
+servcraft db generate           # Generate client
+servcraft db studio             # Open Prisma Studio
+servcraft db seed               # Seed database
+servcraft db reset              # Reset database
+```
+
+## Project Structure
+
+```
+my-app/
+├── src/
+│   ├── core/                   # Server, logger
+│   ├── config/                 # Environment config
+│   ├── modules/
+│   │   ├── auth/               # Authentication
+│   │   ├── user/               # User management
+│   │   ├── email/              # Email service
+│   │   └── [your-modules]/
+│   ├── middleware/             # Security, error handling
+│   ├── utils/                  # Helpers, errors
+│   ├── types/                  # Type definitions
+│   └── index.ts                # Entry point
+├── prisma/
+│   └── schema.prisma           # Database schema
+├── tests/
+│   ├── unit/
+│   └── integration/
+├── docker-compose.yml
+└── package.json
+```
+
+## Module Architecture
+
+Each module follows the Controller/Service/Repository pattern:
+
+```
+modules/product/
+├── product.types.ts            # Interfaces & types
+├── product.schemas.ts          # Validation schemas
+├── product.repository.ts       # Data access layer
+├── product.service.ts          # Business logic
+├── product.controller.ts       # HTTP handlers
+├── product.routes.ts           # Route definitions
+└── index.ts                    # Module exports
+```
+
+## Environment Variables
+
+```env
+# Server
+NODE_ENV=development
+PORT=3000
+HOST=0.0.0.0
+
+# Database
+DATABASE_URL="postgresql://user:pass@localhost:5432/db"
+DATABASE_PROVIDER=postgresql
+
+# JWT
+JWT_SECRET=your-secret-key-min-32-chars
+JWT_ACCESS_EXPIRES_IN=15m
+JWT_REFRESH_EXPIRES_IN=7d
+
+# Security
+CORS_ORIGIN=http://localhost:3000
+RATE_LIMIT_MAX=100
+
+# Email
+SMTP_HOST=smtp.example.com
+SMTP_PORT=587
+SMTP_USER=user
+SMTP_PASS=pass
+
+# Logging
+LOG_LEVEL=info
+```
+
+## API Endpoints
+
+### Authentication
+
+```
+POST /auth/register     Register new user
+POST /auth/login        Login
+POST /auth/refresh      Refresh tokens
+POST /auth/logout       Logout
+GET  /auth/me           Get current user
+POST /auth/change-password
+```
+
+### Users (Admin)
+
+```
+GET    /users           List users
+GET    /users/:id       Get user
+PATCH  /users/:id       Update user
+DELETE /users/:id       Delete user
+POST   /users/:id/suspend
+POST   /users/:id/ban
+POST   /users/:id/activate
+```
+
+### Health
+
+```
+GET /health             Health check
+GET /ready              Readiness check
+```
+
+## Docker
+
+### Development
+
+```bash
+docker-compose up -d
+```
+
+### Production
+
+```bash
+docker-compose -f docker-compose.prod.yml up -d
+```
+
+## Scripts
+
+```bash
+npm run dev             # Development with hot reload
+npm run build           # Build for production
+npm run start           # Start production server
+npm run test            # Run tests
+npm run test:coverage   # Test with coverage
+npm run lint            # Lint code
+npm run format          # Format code
+npm run typecheck       # Type check
+npm run db:migrate      # Run migrations
+npm run db:push         # Push schema
+npm run db:studio       # Open Prisma Studio
+npm run db:seed         # Seed database
+```
+
+## License
+
+MIT

package/commitlint.config.js

@@ -0,0 +1,24 @@
+export default {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'type-enum': [
+      2,
+      'always',
+      [
+        'feat',     // New feature
+        'fix',      // Bug fix
+        'docs',     // Documentation
+        'style',    // Formatting, missing semicolons, etc.
+        'refactor', // Code refactoring
+        'perf',     // Performance improvements
+        'test',     // Adding tests
+        'chore',    // Maintenance tasks
+        'ci',       // CI/CD changes
+        'build',    // Build system changes
+        'revert',   // Revert previous commit
+      ],
+    ],
+    'subject-case': [2, 'always', 'lower-case'],
+    'subject-max-length': [2, 'always', 72],
+  },
+};