servcraft 0.1.0

package/npm-cache/_cacache/index-v5/58/94/c2cba79e0f16b4c10e95a87e32255741149e8222cc314a476aab67c39cc0

@@ -0,0 +1,5 @@
+
+d6bee00ec15bdca9908a56fdc20675409c9ed366	{"key":"pacote:tarball:file:/mnt/d4169edb-8c9f-4e15-9e9d-358608611b0c/Projetcts/Node.js/servcraft","integrity":"sha512-HNADRA1QCgSHYhqtHWQCl4NAaYl2YCBG244k+gPAHubAIsabBYL5aQQtlELuh2rDXAOOlg3UJ9HmIvokuOt9ug==","time":1766018965337,"size":220811}
+9b065a6b5dd7776f840aa247a52a96b098d3280b	{"key":"pacote:tarball:file:/mnt/d4169edb-8c9f-4e15-9e9d-358608611b0c/Projetcts/Node.js/servcraft","integrity":"sha512-4BLzYNyTFe5fF4RKDIwjPua/fDCDfEoC6g1Wxhx/erIcDpWOUO0sV8WfmDx2K5MFZ3jJAJsjmP/Cbe8Bg5mbEw==","time":1766019082154,"size":443837}
+793f695e6f45c908cbf359d9bb41e39e78c1827f	{"key":"pacote:tarball:file:/mnt/d4169edb-8c9f-4e15-9e9d-358608611b0c/Projetcts/Node.js/servcraft","integrity":"sha512-7bD64RYZAomPTJE8Z9f2zfa+BmWuw7OJucT08KEByh2lm63xtZxOADD1IjAjuNY8/lAcRqMsIMiV1Ps/EcoiMg==","time":1766019259320,"size":888564}
+d817e3cb064934d074e652dfa4e82c5a29df0bda	{"key":"pacote:tarball:file:/mnt/d4169edb-8c9f-4e15-9e9d-358608611b0c/Projetcts/Node.js/servcraft","integrity":"sha512-QlUotJPKSRgz5aqw6cMQjSmrPzbCSMqI9F1GMGdPzpEwlZ5WrjCHl6wrYyj6fwmmELlVDtCcuXHQOYdtKT/GnQ==","time":1766019329526,"size":1777318}

package/package.json

@@ -0,0 +1,112 @@
+{
+  "name": "servcraft",
+  "version": "0.1.0",
+  "description": "A modular, production-ready Node.js backend framework",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "servcraft": "dist/cli/index.js"
+  },
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsup",
+    "start": "node dist/index.js",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "prepare": "command -v husky >/dev/null 2>&1 && husky install || echo \"husky not installed, skipping hooks\"",
+    "typecheck": "tsc --noEmit",
+    "docs": "tsx src/cli/index.ts docs",
+    "prepublishOnly": "npm run build",
+    "db:generate": "prisma generate",
+    "db:migrate": "prisma migrate dev",
+    "db:push": "prisma db push",
+    "db:studio": "prisma studio",
+    "db:seed": "tsx src/database/seed.ts"
+  },
+  "prisma": {
+    "seed": "tsx src/database/seed.ts"
+  },
+  "keywords": [
+    "backend",
+    "framework",
+    "nodejs",
+    "fastify",
+    "typescript",
+    "api",
+    "rest",
+    "modular",
+    "authentication",
+    "jwt"
+  ],
+  "author": "Le-Sourcier",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@fastify/cors": "^9.0.1",
+    "@fastify/helmet": "^11.1.1",
+    "@fastify/jwt": "^8.0.1",
+    "@fastify/rate-limit": "^9.1.0",
+    "@fastify/cookie": "^9.3.1",
+    "@fastify/swagger": "^8.15.0",
+    "@fastify/swagger-ui": "^4.1.0",
+    "@prisma/client": "^5.22.0",
+    "fastify": "^4.28.1",
+    "pino": "^9.5.0",
+    "pino-pretty": "^11.3.0",
+    "zod": "^3.23.8",
+    "bcryptjs": "^2.4.3",
+    "dotenv": "^16.4.5",
+    "nodemailer": "^6.9.15",
+    "handlebars": "^4.7.8",
+    "commander": "^12.1.0",
+    "chalk": "^5.3.0",
+    "inquirer": "^12.1.0",
+    "ora": "^8.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.1",
+    "@types/bcryptjs": "^2.4.6",
+    "@types/nodemailer": "^6.4.17",
+    "@typescript-eslint/eslint-plugin": "^8.17.0",
+    "@typescript-eslint/parser": "^8.17.0",
+    "eslint": "^9.16.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-prettier": "^5.2.1",
+    "prettier": "^3.4.2",
+    "husky": "^9.1.7",
+    "lint-staged": "^15.2.10",
+    "typescript": "^5.7.2",
+    "tsx": "^4.19.2",
+    "tsup": "^8.3.5",
+    "vitest": "^2.1.8",
+    "@vitest/coverage-v8": "^2.1.8",
+    "prisma": "^5.22.0",
+    "@commitlint/cli": "^19.6.0",
+    "@commitlint/config-conventional": "^19.6.0",
+    "typescript-eslint": "^8.17.0",
+    "@eslint/js": "^9.16.0"
+  },
+  "type": "module",
+  "lint-staged": {
+    "*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  },
+  "directories": {
+    "test": "tests"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Le-Sourcier/servcraft.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Le-Sourcier/servcraft/issues"
+  },
+  "homepage": "https://github.com/Le-Sourcier/servcraft#readme"
+}

package/prisma/schema.prisma

@@ -0,0 +1,157 @@
+// Servcraft - Prisma Schema
+// Supports: PostgreSQL, MySQL, SQLite
+
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = env("DATABASE_PROVIDER") // "postgresql", "mysql", or "sqlite"
+  url      = env("DATABASE_URL")
+}
+
+// ==========================================
+// USER & AUTHENTICATION
+// ==========================================
+
+model User {
+  id            String    @id @default(uuid())
+  email         String    @unique
+  password      String
+  name          String?
+  role          UserRole  @default(USER)
+  status        UserStatus @default(ACTIVE)
+  emailVerified Boolean   @default(false)
+  lastLoginAt   DateTime?
+  metadata      Json?
+
+  createdAt     DateTime  @default(now())
+  updatedAt     DateTime  @updatedAt
+
+  // Relations
+  refreshTokens RefreshToken[]
+  sessions      Session[]
+  auditLogs     AuditLog[]
+
+  @@index([email])
+  @@index([status])
+  @@index([role])
+  @@map("users")
+}
+
+enum UserRole {
+  USER
+  MODERATOR
+  ADMIN
+  SUPER_ADMIN
+}
+
+enum UserStatus {
+  ACTIVE
+  INACTIVE
+  SUSPENDED
+  BANNED
+}
+
+model RefreshToken {
+  id        String   @id @default(uuid())
+  token     String   @unique
+  userId    String
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  expiresAt DateTime
+  createdAt DateTime @default(now())
+
+  @@index([userId])
+  @@index([token])
+  @@map("refresh_tokens")
+}
+
+model Session {
+  id        String   @id @default(uuid())
+  userId    String
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  userAgent String?
+  ipAddress String?
+  expiresAt DateTime
+  createdAt DateTime @default(now())
+
+  @@index([userId])
+  @@map("sessions")
+}
+
+// ==========================================
+// PASSWORD RESET
+// ==========================================
+
+model PasswordReset {
+  id        String   @id @default(uuid())
+  email     String
+  token     String   @unique
+  expiresAt DateTime
+  used      Boolean  @default(false)
+  createdAt DateTime @default(now())
+
+  @@index([email])
+  @@index([token])
+  @@map("password_resets")
+}
+
+// ==========================================
+// EMAIL VERIFICATION
+// ==========================================
+
+model EmailVerification {
+  id        String   @id @default(uuid())
+  email     String
+  token     String   @unique
+  expiresAt DateTime
+  verified  Boolean  @default(false)
+  createdAt DateTime @default(now())
+
+  @@index([email])
+  @@index([token])
+  @@map("email_verifications")
+}
+
+// ==========================================
+// AUDIT LOGS
+// ==========================================
+
+model AuditLog {
+  id        String   @id @default(uuid())
+  userId    String?
+  user      User?    @relation(fields: [userId], references: [id], onDelete: SetNull)
+  action    String
+  resource  String
+  resourceId String?
+  oldValue  Json?
+  newValue  Json?
+  ipAddress String?
+  userAgent String?
+  metadata  Json?
+  createdAt DateTime @default(now())
+
+  @@index([userId])
+  @@index([action])
+  @@index([resource])
+  @@index([createdAt])
+  @@map("audit_logs")
+}
+
+// ==========================================
+// SETTINGS / CONFIG
+// ==========================================
+
+model Setting {
+  id        String   @id @default(uuid())
+  key       String   @unique
+  value     Json
+  type      String   @default("string")
+  group     String   @default("general")
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@index([key])
+  @@index([group])
+  @@map("settings")
+}

package/src/cli/commands/add-module.ts

@@ -0,0 +1,422 @@
+import { Command } from 'commander';
+import path from 'path';
+import fs from 'fs/promises';
+import ora from 'ora';
+import chalk from 'chalk';
+import { ensureDir, writeFile, fileExists, success, error, info, warn, getModulesDir, getSourceDir } from '../utils/helpers.js';
+
+// Pre-built modules that can be added
+const AVAILABLE_MODULES = {
+  auth: {
+    name: 'Authentication',
+    description: 'JWT authentication with access/refresh tokens',
+    files: ['auth.service', 'auth.controller', 'auth.routes', 'auth.middleware', 'auth.schemas', 'auth.types', 'index'],
+  },
+  users: {
+    name: 'User Management',
+    description: 'User CRUD with RBAC (roles & permissions)',
+    files: ['user.service', 'user.controller', 'user.repository', 'user.routes', 'user.schemas', 'user.types', 'index'],
+  },
+  email: {
+    name: 'Email Service',
+    description: 'SMTP email with templates (Handlebars)',
+    files: ['email.service', 'email.templates', 'email.types', 'index'],
+  },
+  audit: {
+    name: 'Audit Logs',
+    description: 'Activity logging and audit trail',
+    files: ['audit.service', 'audit.types', 'index'],
+  },
+  upload: {
+    name: 'File Upload',
+    description: 'File upload with local/S3 storage',
+    files: ['upload.service', 'upload.controller', 'upload.routes', 'upload.types', 'index'],
+  },
+  cache: {
+    name: 'Redis Cache',
+    description: 'Redis caching service',
+    files: ['cache.service', 'cache.types', 'index'],
+  },
+  notifications: {
+    name: 'Notifications',
+    description: 'In-app and push notifications',
+    files: ['notification.service', 'notification.types', 'index'],
+  },
+  settings: {
+    name: 'Settings',
+    description: 'Application settings management',
+    files: ['settings.service', 'settings.controller', 'settings.routes', 'settings.types', 'index'],
+  },
+};
+
+export const addModuleCommand = new Command('add')
+  .description('Add a pre-built module to your project')
+  .argument('[module]', 'Module to add (auth, users, email, audit, upload, cache, notifications, settings)')
+  .option('-l, --list', 'List available modules')
+  .action(async (moduleName?: string, options?: { list?: boolean }) => {
+    if (options?.list || !moduleName) {
+      console.log(chalk.bold('\n📦 Available Modules:\n'));
+
+      for (const [key, mod] of Object.entries(AVAILABLE_MODULES)) {
+        console.log(`  ${chalk.cyan(key.padEnd(15))} ${mod.name}`);
+        console.log(`  ${' '.repeat(15)} ${chalk.gray(mod.description)}\n`);
+      }
+
+      console.log(chalk.bold('Usage:'));
+      console.log(`  ${chalk.yellow('servcraft add auth')}      Add authentication module`);
+      console.log(`  ${chalk.yellow('servcraft add users')}     Add user management module`);
+      console.log(`  ${chalk.yellow('servcraft add email')}     Add email service module\n`);
+      return;
+    }
+
+    const module = AVAILABLE_MODULES[moduleName as keyof typeof AVAILABLE_MODULES];
+
+    if (!module) {
+      error(`Unknown module: ${moduleName}`);
+      info('Run "servcraft add --list" to see available modules');
+      return;
+    }
+
+    const spinner = ora(`Adding ${module.name} module...`).start();
+
+    try {
+      const moduleDir = path.join(getModulesDir(), moduleName);
+
+      // Check if module already exists
+      if (await fileExists(moduleDir)) {
+        spinner.stop();
+        warn(`Module "${moduleName}" already exists`);
+        return;
+      }
+
+      await ensureDir(moduleDir);
+
+      // Generate module files based on type
+      switch (moduleName) {
+        case 'auth':
+          await generateAuthModule(moduleDir);
+          break;
+        case 'users':
+          await generateUsersModule(moduleDir);
+          break;
+        case 'email':
+          await generateEmailModule(moduleDir);
+          break;
+        case 'audit':
+          await generateAuditModule(moduleDir);
+          break;
+        case 'upload':
+          await generateUploadModule(moduleDir);
+          break;
+        case 'cache':
+          await generateCacheModule(moduleDir);
+          break;
+        default:
+          await generateGenericModule(moduleDir, moduleName);
+      }
+
+      spinner.succeed(`${module.name} module added successfully!`);
+
+      console.log('\n📁 Files created:');
+      module.files.forEach((f) => success(`  src/modules/${moduleName}/${f}.ts`));
+
+      console.log('\n📌 Next steps:');
+      info('  1. Register the module in your main app file');
+      info('  2. Configure any required environment variables');
+      info('  3. Run database migrations if needed');
+
+    } catch (err) {
+      spinner.fail('Failed to add module');
+      error(err instanceof Error ? err.message : String(err));
+    }
+  });
+
+async function generateAuthModule(dir: string): Promise<void> {
+  // This would copy from templates or generate inline
+  // For now, we'll create placeholder files
+  const files = {
+    'auth.types.ts': `export interface JwtPayload {
+  sub: string;
+  email: string;
+  role: string;
+  type: 'access' | 'refresh';
+}
+
+export interface TokenPair {
+  accessToken: string;
+  refreshToken: string;
+  expiresIn: number;
+}
+
+export interface AuthUser {
+  id: string;
+  email: string;
+  role: string;
+}
+`,
+    'auth.schemas.ts': `import { z } from 'zod';
+
+export const loginSchema = z.object({
+  email: z.string().email(),
+  password: z.string().min(1),
+});
+
+export const registerSchema = z.object({
+  email: z.string().email(),
+  password: z.string().min(8),
+  name: z.string().min(2).optional(),
+});
+
+export const refreshTokenSchema = z.object({
+  refreshToken: z.string().min(1),
+});
+`,
+    'index.ts': `export * from './auth.types.js';
+export * from './auth.schemas.js';
+// Export services, controllers, etc.
+`,
+  };
+
+  for (const [name, content] of Object.entries(files)) {
+    await writeFile(path.join(dir, name), content);
+  }
+}
+
+async function generateUsersModule(dir: string): Promise<void> {
+  const files = {
+    'user.types.ts': `export type UserStatus = 'active' | 'inactive' | 'suspended' | 'banned';
+export type UserRole = 'user' | 'admin' | 'moderator' | 'super_admin';
+
+export interface User {
+  id: string;
+  email: string;
+  password: string;
+  name?: string;
+  role: UserRole;
+  status: UserStatus;
+  createdAt: Date;
+  updatedAt: Date;
+}
+`,
+    'user.schemas.ts': `import { z } from 'zod';
+
+export const createUserSchema = z.object({
+  email: z.string().email(),
+  password: z.string().min(8),
+  name: z.string().min(2).optional(),
+  role: z.enum(['user', 'admin', 'moderator']).optional(),
+});
+
+export const updateUserSchema = z.object({
+  email: z.string().email().optional(),
+  name: z.string().min(2).optional(),
+  role: z.enum(['user', 'admin', 'moderator', 'super_admin']).optional(),
+  status: z.enum(['active', 'inactive', 'suspended', 'banned']).optional(),
+});
+`,
+    'index.ts': `export * from './user.types.js';
+export * from './user.schemas.js';
+`,
+  };
+
+  for (const [name, content] of Object.entries(files)) {
+    await writeFile(path.join(dir, name), content);
+  }
+}
+
+async function generateEmailModule(dir: string): Promise<void> {
+  const files = {
+    'email.types.ts': `export interface EmailOptions {
+  to: string | string[];
+  subject: string;
+  html?: string;
+  text?: string;
+  template?: string;
+  data?: Record<string, unknown>;
+}
+
+export interface EmailResult {
+  success: boolean;
+  messageId?: string;
+  error?: string;
+}
+`,
+    'email.service.ts': `import nodemailer from 'nodemailer';
+import type { EmailOptions, EmailResult } from './email.types.js';
+
+export class EmailService {
+  private transporter;
+
+  constructor() {
+    this.transporter = nodemailer.createTransport({
+      host: process.env.SMTP_HOST,
+      port: parseInt(process.env.SMTP_PORT || '587', 10),
+      auth: {
+        user: process.env.SMTP_USER,
+        pass: process.env.SMTP_PASS,
+      },
+    });
+  }
+
+  async send(options: EmailOptions): Promise<EmailResult> {
+    try {
+      const result = await this.transporter.sendMail({
+        from: process.env.SMTP_FROM,
+        ...options,
+      });
+      return { success: true, messageId: result.messageId };
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  }
+}
+
+export const emailService = new EmailService();
+`,
+    'index.ts': `export * from './email.types.js';
+export { EmailService, emailService } from './email.service.js';
+`,
+  };
+
+  for (const [name, content] of Object.entries(files)) {
+    await writeFile(path.join(dir, name), content);
+  }
+}
+
+async function generateAuditModule(dir: string): Promise<void> {
+  const files = {
+    'audit.types.ts': `export interface AuditLogEntry {
+  userId?: string;
+  action: string;
+  resource: string;
+  resourceId?: string;
+  oldValue?: Record<string, unknown>;
+  newValue?: Record<string, unknown>;
+  ipAddress?: string;
+  userAgent?: string;
+  createdAt: Date;
+}
+`,
+    'audit.service.ts': `import type { AuditLogEntry } from './audit.types.js';
+
+const logs: AuditLogEntry[] = [];
+
+export class AuditService {
+  async log(entry: Omit<AuditLogEntry, 'createdAt'>): Promise<void> {
+    logs.push({ ...entry, createdAt: new Date() });
+    console.log('[AUDIT]', entry.action, entry.resource);
+  }
+
+  async query(filters: Partial<AuditLogEntry>): Promise<AuditLogEntry[]> {
+    return logs.filter((log) => {
+      for (const [key, value] of Object.entries(filters)) {
+        if (log[key as keyof AuditLogEntry] !== value) return false;
+      }
+      return true;
+    });
+  }
+}
+
+export const auditService = new AuditService();
+`,
+    'index.ts': `export * from './audit.types.js';
+export { AuditService, auditService } from './audit.service.js';
+`,
+  };
+
+  for (const [name, content] of Object.entries(files)) {
+    await writeFile(path.join(dir, name), content);
+  }
+}
+
+async function generateUploadModule(dir: string): Promise<void> {
+  const files = {
+    'upload.types.ts': `export interface UploadedFile {
+  id: string;
+  filename: string;
+  originalName: string;
+  mimetype: string;
+  size: number;
+  path: string;
+  url: string;
+  createdAt: Date;
+}
+
+export interface UploadOptions {
+  maxSize?: number;
+  allowedTypes?: string[];
+  destination?: string;
+}
+`,
+    'index.ts': `export * from './upload.types.js';
+`,
+  };
+
+  for (const [name, content] of Object.entries(files)) {
+    await writeFile(path.join(dir, name), content);
+  }
+}
+
+async function generateCacheModule(dir: string): Promise<void> {
+  const files = {
+    'cache.types.ts': `export interface CacheOptions {
+  ttl?: number;
+  prefix?: string;
+}
+`,
+    'cache.service.ts': `import type { CacheOptions } from './cache.types.js';
+
+// In-memory cache (replace with Redis in production)
+const cache = new Map<string, { value: unknown; expiry: number }>();
+
+export class CacheService {
+  async get<T>(key: string): Promise<T | null> {
+    const item = cache.get(key);
+    if (!item) return null;
+    if (Date.now() > item.expiry) {
+      cache.delete(key);
+      return null;
+    }
+    return item.value as T;
+  }
+
+  async set(key: string, value: unknown, ttl = 3600): Promise<void> {
+    cache.set(key, { value, expiry: Date.now() + ttl * 1000 });
+  }
+
+  async del(key: string): Promise<void> {
+    cache.delete(key);
+  }
+
+  async clear(): Promise<void> {
+    cache.clear();
+  }
+}
+
+export const cacheService = new CacheService();
+`,
+    'index.ts': `export * from './cache.types.js';
+export { CacheService, cacheService } from './cache.service.js';
+`,
+  };
+
+  for (const [name, content] of Object.entries(files)) {
+    await writeFile(path.join(dir, name), content);
+  }
+}
+
+async function generateGenericModule(dir: string, name: string): Promise<void> {
+  const files = {
+    [`${name}.types.ts`]: `// ${name} types
+export interface ${name.charAt(0).toUpperCase() + name.slice(1)}Data {
+  // Define your types here
+}
+`,
+    'index.ts': `export * from './${name}.types.js';
+`,
+  };
+
+  for (const [fileName, content] of Object.entries(files)) {
+    await writeFile(path.join(dir, fileName), content);
+  }
+}