@node-initializr/generator 0.1.0

package/dist/templates/base-nestjs/.env.example.hbs

@@ -0,0 +1,24 @@
+NODE_ENV=development
+PORT=3000
+{{#if usePostgres}}
+DATABASE_URL=postgresql://postgres:postgres@localhost:5432/{{projectSlug}}
+{{/if}}
+{{#if useMysql}}
+DATABASE_URL=mysql://root:root@localhost:3306/{{projectSlug}}
+{{/if}}
+{{#if useMongodb}}
+DATABASE_URL=mongodb://localhost:27017/{{projectSlug}}
+{{/if}}
+{{#if hasRedis}}
+REDIS_URL=redis://localhost:6379
+{{/if}}
+{{#if useJwt}}
+JWT_SECRET=change-me-in-production
+JWT_EXPIRES_IN=7d
+{{/if}}
+{{#if useClerk}}
+CLERK_SECRET_KEY=sk_test_xxx
+{{/if}}
+{{#if useRabbitmq}}
+RABBITMQ_URL=amqp://guest:guest@localhost:5672
+{{/if}}

package/dist/templates/base-nestjs/.gitignore.hbs

@@ -0,0 +1,10 @@
+node_modules
+dist
+.env
+.env.local
+coverage
+*.log
+.DS_Store
+{{#if usePrisma}}
+prisma/migrations/**/migration_lock.toml
+{{/if}}

package/dist/templates/base-nestjs/README.md.hbs

@@ -0,0 +1,46 @@
+# {{projectSlug}}
+
+{{description}}
+
+Projeto gerado pelo [Node Initializr](https://github.com/node-initializr).
+
+## Stack
+
+| Tecnologia | Escolha |
+|------------|---------|
+| Framework | {{framework}} |
+| Linguagem | {{language}} |
+| Arquitetura | {{architecture}} |
+| Banco | {{database}} |
+| ORM | {{orm}} |
+| Auth | {{auth}} |
+| Mensageria | {{messageBroker}} |
+| Redis | {{#if hasRedis}}Sim{{else}}Não{{/if}} |
+| Pacotes | {{packageManager}} |
+
+## Como rodar
+
+```bash
+{{pmInstallDev}}
+{{#if usePrisma}}
+cp .env.example .env
+{{#if isPnpm}}pnpm run db:generate
+pnpm run db:migrate{{else}}{{#if isYarn}}yarn db:generate
+yarn db:migrate{{else}}npm run db:generate
+npm run db:migrate{{/if}}{{/if}}
+{{/if}}
+{{#if docker}}
+docker compose up -d
+{{/if}}
+{{pmRunDev}}
+```
+
+## Estrutura
+
+```
+src/
+├── modules/     # Módulos de domínio
+├── shared/      # Utilitários compartilhados
+├── infra/       # Integrações externas
+└── config/      # Configuração da aplicação
+```

package/dist/templates/base-nestjs/docker/Dockerfile.hbs

@@ -0,0 +1,21 @@
+FROM node:{{nodeVersion}}-alpine
+WORKDIR /app
+ENV NODE_ENV=production
+
+{{#if isPnpm}}RUN corepack enable
+COPY package.json ./
+RUN pnpm install --prod
+{{else}}{{#if isYarn}}COPY package.json yarn.lock* ./
+RUN yarn install --frozen-lockfile --production
+{{else}}COPY package*.json ./
+RUN npm ci --omit=dev
+{{/if}}{{/if}}COPY . .
+{{#if usePrisma}}
+RUN npx prisma generate
+{{/if}}
+{{#if isTypescript}}
+RUN {{pmRunBuild}}
+{{/if}}
+
+EXPOSE 3000
+CMD ["node", "dist/main.js"]

package/dist/templates/base-nestjs/docker/docker-compose.yml.hbs

@@ -0,0 +1,69 @@
+services:
+  app:
+    build: ..
+    ports:
+      - "3000:3000"
+    env_file:
+      - ../.env
+    depends_on:
+{{#if hasDatabase}}
+      db:
+        condition: service_healthy
+{{/if}}
+{{#if needsRedis}}
+      redis:
+        condition: service_started
+{{/if}}
+
+{{#if usePostgres}}
+  db:
+    image: postgres:16-alpine
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
+      POSTGRES_DB: {{projectSlug}}
+    ports:
+      - "5432:5432"
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+{{/if}}
+
+{{#if useMysql}}
+  db:
+    image: mysql:8
+    environment:
+      MYSQL_ROOT_PASSWORD: root
+      MYSQL_DATABASE: {{projectSlug}}
+    ports:
+      - "3306:3306"
+    healthcheck:
+      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+{{/if}}
+
+{{#if useMongodb}}
+  db:
+    image: mongo:7
+    ports:
+      - "27017:27017"
+{{/if}}
+
+{{#if needsRedis}}
+  redis:
+    image: redis:7-alpine
+    ports:
+      - "6379:6379"
+{{/if}}
+
+{{#if useRabbitmq}}
+  rabbitmq:
+    image: rabbitmq:3-management-alpine
+    ports:
+      - "5672:5672"
+      - "15672:15672"
+{{/if}}

package/dist/templates/base-nestjs/drizzle/drizzle.config.ts.hbs

@@ -0,0 +1,10 @@
+import { defineConfig } from 'drizzle-kit';
+
+export default defineConfig({
+  schema: './src/{{#if isCleanArch}}infrastructure{{else}}infra{{/if}}/drizzle/schema.ts',
+  out: './drizzle/migrations',
+  dialect: '{{#if usePostgres}}postgresql{{/if}}{{#if useMysql}}mysql{{/if}}',
+  dbCredentials: {
+    url: process.env.DATABASE_URL!,
+  },
+});

package/dist/templates/base-nestjs/github-actions/ci.yml.hbs

@@ -0,0 +1,38 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+{{#if isPnpm}}      - uses: pnpm/action-setup@v4
+        with:
+          version: 9
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '{{nodeVersion}}'
+          cache: pnpm
+      - run: {{pmInstall}}
+{{else}}{{#if isYarn}}      - uses: actions/setup-node@v4
+        with:
+          node-version: '{{nodeVersion}}'
+          cache: yarn
+      - run: {{pmInstall}}
+{{else}}      - uses: actions/setup-node@v4
+        with:
+          node-version: '{{nodeVersion}}'
+          cache: npm
+      - run: {{pmInstall}}
+{{/if}}{{/if}}{{#if usePrisma}}
+      - run: npx prisma generate
+{{/if}}
+      - run: {{pmRunBuild}}
+{{#if jest}}
+      - run: {{pmRunTest}}
+{{/if}}

package/dist/templates/base-nestjs/nest-cli.json.hbs

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://json.schemastore.org/nest-cli",
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src",
+  "compilerOptions": {
+    "deleteOutDir": true
+  }
+}

package/dist/templates/base-nestjs/package.json.hbs

@@ -0,0 +1,65 @@
+{
+  "name": "{{projectSlug}}",
+  "version": "0.0.1",
+  "description": "{{description}}",
+  "private": true,{{#if isPnpm}}
+  "packageManager": "pnpm@9.15.0",{{/if}}{{#if isYarn}}
+  "packageManager": "yarn@1.22.22",{{/if}}
+  "scripts": {
+    "build": "nest build",
+    "start": "nest start",
+    "start:dev": "nest start --watch",
+    "start:prod": "node dist/main",
+    {{#if jest}}"test": "jest",{{/if}}
+    {{#if usePrisma}}"db:generate": "prisma generate",
+    "db:migrate": "prisma migrate dev",{{/if}}
+    {{#if useDrizzle}}"db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate",{{/if}}
+    "lint": "eslint \"{src,test}/**/*.{{ext}}\" --fix"
+  },
+  "dependencies": {
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@nestjs/platform-express": "^11.0.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1"{{#if swagger}},
+    "@nestjs/swagger": "^11.0.0"{{/if}}{{#if useJwt}},
+    "@nestjs/jwt": "^11.0.0",
+    "@nestjs/passport": "^11.0.0",
+    "passport": "^0.7.0",
+    "passport-jwt": "^4.0.1",
+    "bcrypt": "^5.1.1"{{/if}}{{#if useClerk}},
+    "@clerk/clerk-sdk-node": "^5.0.0"{{/if}}{{#if usePrisma}},
+    "@prisma/client": "^6.0.0"{{/if}}{{#if useTypeorm}},
+    "typeorm": "^0.3.20",
+    "@nestjs/typeorm": "^11.0.0",
+    "{{dbDriver}}": "latest"{{/if}}{{#if useDrizzle}},
+    "drizzle-orm": "^0.38.0",
+    "{{dbDriver}}": "latest"{{/if}}{{#if useSequelize}},
+    "sequelize": "^6.37.0",
+    "sequelize-typescript": "^2.1.6",
+    "@nestjs/sequelize": "^11.0.0",
+    "{{dbDriver}}": "latest"{{/if}}{{#if hasRedis}},
+    "@nestjs/cache-manager": "^3.0.0",
+    "cache-manager": "^6.0.0",
+    "cache-manager-redis-yet": "^5.0.0"{{/if}}{{#if useBullmq}},
+    "@nestjs/bullmq": "^11.0.0",
+    "bullmq": "^5.0.0"{{/if}}{{#if useRabbitmq}},
+    "@golevelup/nestjs-rabbitmq": "^5.0.0",
+    "amqplib": "^0.10.0"{{/if}}
+  },
+  "devDependencies": {
+    "@nestjs/cli": "^11.0.0",
+    "@nestjs/schematics": "^11.0.0"{{#if isTypescript}},
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"{{/if}}{{#if jest}},
+    "jest": "^30.0.0",
+    "@nestjs/testing": "^11.0.0",
+    "ts-jest": "^29.0.0"{{/if}}    {{#if usePrisma}},
+    "prisma": "^6.0.0"{{/if}}{{#if useDrizzle}},
+    "drizzle-kit": "^0.30.0"{{/if}}
+  },
+  "engines": {
+    "node": ">={{nodeVersion}}.0.0"
+  }
+}

package/dist/templates/base-nestjs/prisma/schema.prisma.hbs

@@ -0,0 +1,16 @@
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "{{#if usePostgres}}postgresql{{/if}}{{#if useMysql}}mysql{{/if}}{{#if useMongodb}}mongodb{{/if}}"
+  url      = env("DATABASE_URL")
+}
+
+model User {
+  id        String   @id @default(cuid())
+  email     String   @unique
+  name      String?
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+}

package/dist/templates/base-nestjs/tsconfig.json.hbs

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "declaration": true,
+    "removeComments": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "target": "ES2022",
+    "sourceMap": true,
+    "outDir": "./dist",
+    "baseUrl": "./",
+    "incremental": true,
+    "skipLibCheck": true,
+    "strict": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/dist/templates/shared-express/src/infra/auth/clerk.middleware.hbs

@@ -0,0 +1,12 @@
+import { clerkMiddleware, getAuth } from '@clerk/express';
+import type { Request, Response, NextFunction } from 'express';
+
+export const clerkAuth = clerkMiddleware();
+
+export function requireClerkAuth(req: Request, res: Response, next: NextFunction) {
+  const auth = getAuth(req);
+  if (!auth?.userId) {
+    return res.status(401).json({ message: 'Unauthorized' });
+  }
+  next();
+}

package/dist/templates/shared-express/src/infra/auth/jwt.middleware.hbs

@@ -0,0 +1,18 @@
+import jwt from 'jsonwebtoken';
+import type { Request, Response, NextFunction } from 'express';
+
+export function jwtMiddleware(req: Request, res: Response, next: NextFunction) {
+  const token = req.headers.authorization?.replace('Bearer ', '');
+  if (!token) {
+    return res.status(401).json({ message: 'Unauthorized' });
+  }
+  try {
+    (req as Request & { user?: unknown }).user = jwt.verify(
+      token,
+      process.env.JWT_SECRET ?? 'change-me',
+    );
+    next();
+  } catch {
+    return res.status(401).json({ message: 'Invalid token' });
+  }
+}

package/dist/templates/shared-express/src/infra/drizzle/client.hbs

@@ -0,0 +1,18 @@
+{{#if usePostgres}}
+import { drizzle } from 'drizzle-orm/node-postgres';
+import pg from 'pg';
+{{/if}}
+{{#if useMysql}}
+import { drizzle } from 'drizzle-orm/mysql2';
+import mysql from 'mysql2/promise';
+{{/if}}
+import * as schema from './schema.js';
+
+{{#if usePostgres}}
+const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL });
+export const db = drizzle(pool, { schema });
+{{/if}}
+{{#if useMysql}}
+const pool = mysql.createPool(process.env.DATABASE_URL!);
+export const db = drizzle(pool, { schema, mode: 'default' });
+{{/if}}

package/dist/templates/shared-express/src/infra/drizzle/schema.hbs

@@ -0,0 +1,22 @@
+{{#if usePostgres}}
+import { pgTable, timestamp, uuid, varchar } from 'drizzle-orm/pg-core';
+
+export const users = pgTable('users', {
+  id: uuid('id').primaryKey().defaultRandom(),
+  email: varchar('email', { length: 255 }).notNull().unique(),
+  name: varchar('name', { length: 255 }),
+  createdAt: timestamp('created_at').defaultNow().notNull(),
+  updatedAt: timestamp('updated_at').defaultNow().notNull(),
+});
+{{/if}}
+{{#if useMysql}}
+import { mysqlTable, timestamp, varchar } from 'drizzle-orm/mysql-core';
+
+export const users = mysqlTable('users', {
+  id: varchar('id', { length: 36 }).primaryKey(),
+  email: varchar('email', { length: 255 }).notNull().unique(),
+  name: varchar('name', { length: 255 }),
+  createdAt: timestamp('created_at').defaultNow().notNull(),
+  updatedAt: timestamp('updated_at').defaultNow().notNull(),
+});
+{{/if}}

package/dist/templates/shared-express/src/infra/prisma/client.hbs

@@ -0,0 +1,15 @@
+import { PrismaClient } from '@prisma/client';
+
+const globalForPrisma = globalThis as typeof globalThis & {
+  prisma?: PrismaClient;
+};
+
+export const prisma =
+  globalForPrisma.prisma ??
+  new PrismaClient({
+    log: process.env.NODE_ENV === 'development' ? ['query', 'error'] : ['error'],
+  });
+
+if (process.env.NODE_ENV !== 'production') {
+  globalForPrisma.prisma = prisma;
+}

package/dist/templates/shared-express/src/infra/sequelize/models/user.model.ts.hbs

@@ -0,0 +1,22 @@
+import {
+  Column,
+  DataType,
+  Default,
+  Model,
+  PrimaryKey,
+  Table,
+} from 'sequelize-typescript';
+
+@Table({ tableName: 'users' })
+export class User extends Model {
+  @PrimaryKey
+  @Default(DataType.UUIDV4)
+  @Column(DataType.UUID)
+  declare id: string;
+
+  @Column({ unique: true })
+  declare email: string;
+
+  @Column({ allowNull: true })
+  declare name: string | null;
+}

package/dist/templates/shared-express/src/infra/sequelize/sequelize.ts.hbs

@@ -0,0 +1,16 @@
+import { Sequelize } from 'sequelize-typescript';
+import { User } from './models/user.model.js';
+
+export const sequelize = new Sequelize(process.env.DATABASE_URL!, {
+  dialect: '{{sequelizeDialect}}',
+  models: [User],
+  logging: false,
+});
+
+export async function initSequelize() {
+  await sequelize.authenticate();
+  if (process.env.NODE_ENV !== 'production') {
+    await sequelize.sync();
+  }
+  return sequelize;
+}

package/dist/templates/shared-express/src/infra/swagger/setup.hbs

@@ -0,0 +1,19 @@
+import swaggerJsdoc from 'swagger-jsdoc';
+import swaggerUi from 'swagger-ui-express';
+import type { Express } from 'express';
+
+export function setupSwagger(app: Express) {
+  const spec = swaggerJsdoc({
+    definition: {
+      openapi: '3.0.0',
+      info: {
+        title: '{{projectSlug}}',
+        description: '{{description}}',
+        version: '1.0.0',
+      },
+    },
+    apis: ['./src/**/*.{{ext}}'],
+  });
+
+  app.use('/docs', swaggerUi.serve, swaggerUi.setup(spec));
+}

package/dist/templates/shared-express/src/infra/typeorm/data-source.hbs

@@ -0,0 +1,17 @@
+import 'reflect-metadata';
+import { DataSource } from 'typeorm';
+import { UserEntity } from './entities/user.entity.js';
+
+export const AppDataSource = new DataSource({
+  type: '{{typeormDriver}}',
+  url: process.env.DATABASE_URL,
+  entities: [UserEntity],
+  synchronize: process.env.NODE_ENV !== 'production',
+});
+
+export async function initTypeorm() {
+  if (!AppDataSource.isInitialized) {
+    await AppDataSource.initialize();
+  }
+  return AppDataSource;
+}

package/dist/templates/shared-express/src/infra/typeorm/entities/user.entity.hbs

@@ -0,0 +1,25 @@
+import {
+  Column,
+  CreateDateColumn,
+  Entity,
+  PrimaryGeneratedColumn,
+  UpdateDateColumn,
+} from 'typeorm';
+
+@Entity('users')
+export class UserEntity {
+  @PrimaryGeneratedColumn('uuid')
+  id!: string;
+
+  @Column({ unique: true })
+  email!: string;
+
+  @Column({ nullable: true })
+  name!: string | null;
+
+  @CreateDateColumn()
+  createdAt!: Date;
+
+  @UpdateDateColumn()
+  updatedAt!: Date;
+}

package/dist/templates/shared-fastify/src/infra/auth/clerk.middleware.hbs

@@ -0,0 +1,16 @@
+import { createClerkClient } from '@clerk/backend';
+import type { FastifyReply, FastifyRequest } from 'fastify';
+
+const clerk = createClerkClient({ secretKey: process.env.CLERK_SECRET_KEY });
+
+export async function clerkMiddleware(request: FastifyRequest, reply: FastifyReply) {
+  const token = request.headers.authorization?.replace('Bearer ', '');
+  if (!token) {
+    return reply.status(401).send({ message: 'Unauthorized' });
+  }
+  try {
+    request.user = await clerk.verifyToken(token);
+  } catch {
+    return reply.status(401).send({ message: 'Invalid token' });
+  }
+}

package/dist/templates/shared-fastify/src/infra/auth/jwt.middleware.hbs

@@ -0,0 +1,14 @@
+import jwt from 'jsonwebtoken';
+import type { FastifyReply, FastifyRequest } from 'fastify';
+
+export async function jwtMiddleware(request: FastifyRequest, reply: FastifyReply) {
+  const token = request.headers.authorization?.replace('Bearer ', '');
+  if (!token) {
+    return reply.status(401).send({ message: 'Unauthorized' });
+  }
+  try {
+    request.user = jwt.verify(token, process.env.JWT_SECRET ?? 'change-me');
+  } catch {
+    return reply.status(401).send({ message: 'Invalid token' });
+  }
+}

package/dist/templates/shared-fastify/src/infra/drizzle/client.hbs

@@ -0,0 +1,18 @@
+{{#if usePostgres}}
+import { drizzle } from 'drizzle-orm/node-postgres';
+import pg from 'pg';
+{{/if}}
+{{#if useMysql}}
+import { drizzle } from 'drizzle-orm/mysql2';
+import mysql from 'mysql2/promise';
+{{/if}}
+import * as schema from './schema.js';
+
+{{#if usePostgres}}
+const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL });
+export const db = drizzle(pool, { schema });
+{{/if}}
+{{#if useMysql}}
+const pool = mysql.createPool(process.env.DATABASE_URL!);
+export const db = drizzle(pool, { schema, mode: 'default' });
+{{/if}}

package/dist/templates/shared-fastify/src/infra/drizzle/schema.hbs

@@ -0,0 +1,22 @@
+{{#if usePostgres}}
+import { pgTable, timestamp, uuid, varchar } from 'drizzle-orm/pg-core';
+
+export const users = pgTable('users', {
+  id: uuid('id').primaryKey().defaultRandom(),
+  email: varchar('email', { length: 255 }).notNull().unique(),
+  name: varchar('name', { length: 255 }),
+  createdAt: timestamp('created_at').defaultNow().notNull(),
+  updatedAt: timestamp('updated_at').defaultNow().notNull(),
+});
+{{/if}}
+{{#if useMysql}}
+import { mysqlTable, timestamp, varchar } from 'drizzle-orm/mysql-core';
+
+export const users = mysqlTable('users', {
+  id: varchar('id', { length: 36 }).primaryKey(),
+  email: varchar('email', { length: 255 }).notNull().unique(),
+  name: varchar('name', { length: 255 }),
+  createdAt: timestamp('created_at').defaultNow().notNull(),
+  updatedAt: timestamp('updated_at').defaultNow().notNull(),
+});
+{{/if}}

package/dist/templates/shared-fastify/src/infra/prisma/client.hbs

@@ -0,0 +1,15 @@
+import { PrismaClient } from '@prisma/client';
+
+const globalForPrisma = globalThis as typeof globalThis & {
+  prisma?: PrismaClient;
+};
+
+export const prisma =
+  globalForPrisma.prisma ??
+  new PrismaClient({
+    log: process.env.NODE_ENV === 'development' ? ['query', 'error'] : ['error'],
+  });
+
+if (process.env.NODE_ENV !== 'production') {
+  globalForPrisma.prisma = prisma;
+}

package/dist/templates/shared-fastify/src/infra/sequelize/models/user.model.ts.hbs

@@ -0,0 +1,22 @@
+import {
+  Column,
+  DataType,
+  Default,
+  Model,
+  PrimaryKey,
+  Table,
+} from 'sequelize-typescript';
+
+@Table({ tableName: 'users' })
+export class User extends Model {
+  @PrimaryKey
+  @Default(DataType.UUIDV4)
+  @Column(DataType.UUID)
+  declare id: string;
+
+  @Column({ unique: true })
+  declare email: string;
+
+  @Column({ allowNull: true })
+  declare name: string | null;
+}

package/dist/templates/shared-fastify/src/infra/sequelize/sequelize.ts.hbs

@@ -0,0 +1,16 @@
+import { Sequelize } from 'sequelize-typescript';
+import { User } from './models/user.model.js';
+
+export const sequelize = new Sequelize(process.env.DATABASE_URL!, {
+  dialect: '{{sequelizeDialect}}',
+  models: [User],
+  logging: false,
+});
+
+export async function initSequelize() {
+  await sequelize.authenticate();
+  if (process.env.NODE_ENV !== 'production') {
+    await sequelize.sync();
+  }
+  return sequelize;
+}