rapidkit 0.40.1 → 0.41.1

package/templates/kits/nestjs-standard/env.example.j2

@@ -0,0 +1,18 @@
+# Application
+APP_NAME={{ project_name | upper }}
+PORT=8000
+HOST=0.0.0.0
+NODE_ENV=development
+
+# Security
+JWT_SECRET="{{ '' | generate_secret(48) }}"
+JWT_EXPIRATION=1h
+
+# Database
+DATABASE_URL=postgresql://user:password@localhost:5432/{{ project_name | replace('-', '_') }}
+
+# Redis
+REDIS_HOST=localhost
+REDIS_PORT=6379
+
+# <<<inject:module-env>>>

package/templates/kits/nestjs-standard/eslint.config.cjs.j2

@@ -0,0 +1,9 @@
+const { FlatCompat } = require('@eslint/eslintrc');
+
+const compat = new FlatCompat({
+  baseDirectory: __dirname,
+});
+
+const legacyConfig = require('./.eslintrc.js');
+
+module.exports = compat.config(legacyConfig);

package/templates/kits/nestjs-standard/jest.config.ts.j2

@@ -0,0 +1,22 @@
+import type { Config } from 'jest';
+
+const config: Config = {
+  moduleFileExtensions: ['js', 'json', 'ts'],
+  rootDir: '.',
+  testEnvironment: 'node',
+  testRegex: '.*\\.spec.ts$',
+  testPathIgnorePatterns: ['/node_modules/', '/.rapidkit/vendor/', '/.rapidkit/snapshots/'],
+  transform: {
+    '^.+\\.ts$': 'ts-jest',
+  },
+  collectCoverageFrom: ['src/**/*.{ts,tsx}', '!src/**/*.module.ts'],
+  coverageDirectory: './coverage',
+  moduleNameMapper: {
+    '^@config/(.*)$': '<rootDir>/src/config/$1',
+    '^@modules/(.*)$': '<rootDir>/src/modules/$1',
+    '^@shared/(.*)$': '<rootDir>/src/shared/$1',
+  },
+  setupFiles: ['dotenv/config'],
+};
+
+export default config;

package/templates/kits/nestjs-standard/nest-cli.json.j2

@@ -0,0 +1,10 @@
+{
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src",
+  "entryFile": "main",
+  "compilerOptions": {
+    "deleteOutDir": true,
+    "webpack": false,
+    "tsConfigPath": "tsconfig.build.json"
+  }
+}

package/templates/kits/nestjs-standard/package.json.j2

@@ -0,0 +1,101 @@
+{
+  "name": "{{ project_name | replace('_', '-') | lower }}",
+  "version": "{{ app_version | default('1.0.0') }}",
+  "description": "{{ description | default('NestJS application generated with RapidKit') }}",
+  "license": "{{ license | default('Apache-2.0') }}",
+  "author": "{{ author }}",
+  "engines": {
+    "node": ">={{ node_version }}"
+  },
+  "private": true,
+  "scripts": {
+    "start": "node dist/main",
+    "dev": "nest start --watch",
+    "start:dev": "nest start --watch",
+    "start:debug": "nest start --debug --watch",
+    "start:prod": "node dist/main",
+    "build": "nest build",
+    "lint": "eslint \"{src,test}/**/*.ts\" --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:cov": "jest --coverage",
+    "test:e2e": "jest --config ./test/jest-e2e.json"
+  },
+  "dependencies": {
+    "@nestjs/common": "^11.1.10",
+    "@nestjs/config": "^4.0.2",
+    "@nestjs/core": "^11.1.10",
+    "@nestjs/platform-express": "^11.1.10",
+    "@nestjs/swagger": "^11.2.3",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.3",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2",
+    "helmet": "^8.1.0",
+    "compression": "^1.8.1",
+    "winston": "^3.19.0",
+    "zod": "^4.2.1",
+    "joi": "^18.0.2",
+    "@nestjs/terminus": "^11.0.0",
+    {% if database_type in ['postgresql', 'mysql'] %}
+    "@nestjs/typeorm": "^11.0.0",
+    "typeorm": "^0.3.28",
+    {% if database_type == 'postgresql' %}
+    "pg": "^8.16.3",
+    {% elif database_type == 'mysql' %}
+    "mysql2": "^3.15.3",
+    {% endif %}
+    {% elif database_type == 'mongodb' %}
+    "@nestjs/mongoose": "^11.0.3",
+    "mongoose": "^9.0.1",
+    {% endif %}
+    {% if include_caching %}
+    "@nestjs/cache-manager": "^3.0.1",
+    "cache-manager": "^7.2.6",
+    "cache-manager-redis-store": "^3.0.1",
+    "ioredis": "^5.8.2",
+    {% endif %}
+    {% if include_monitoring %}
+    "prom-client": "^15.1.3",
+    {% endif %}
+    {% if auth_type in ['jwt', 'oauth2'] %}
+    "@nestjs/jwt": "^11.0.2",
+    "@nestjs/passport": "^11.0.5",
+    "bcrypt": "^6.0.0",
+    "passport": "^0.7.0",
+    "passport-jwt": "^4.0.1",
+    {% endif %}
+    "dotenv": "^17.2.3"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.3.3",
+    "@nestjs/cli": "^11.0.14",
+    "@nestjs/schematics": "^11.0.9",
+    "@nestjs/testing": "^11.1.10",
+    "@types/compression": "^1.8.1",
+    "@types/express": "^5.0.6",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^18.19.130",
+    "@types/supertest": "^6.0.3",
+    "@typescript-eslint/eslint-plugin": "^8.50.1",
+    "@typescript-eslint/parser": "^8.50.1",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^30.2.0",
+    "prettier": "^3.7.4",
+    "source-map-support": "^0.5.21",
+    "supertest": "^7.1.4",
+    "ts-jest": "^29.4.6",
+    "ts-loader": "^9.5.4",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.9.3"
+  },
+  "overrides": {
+    "cross-spawn": "7.0.5",
+    "glob": "10.5.0"
+  }
+}

package/templates/kits/nestjs-standard/src/app.controller.ts.j2

@@ -0,0 +1,14 @@
+import { Controller, Get } from '@nestjs/common';
+import { AppService } from './app.service';
+
+@Controller()
+export class AppController {
+  constructor(private readonly appService: AppService) {}
+
+  @Get('health')
+  getHealth() {
+    return this.appService.getHealth();
+  }
+
+  // <<<inject:controller-routes>>>
+}

package/templates/kits/nestjs-standard/src/app.module.ts.j2

@@ -0,0 +1,26 @@
+import { Module } from '@nestjs/common';
+import { ConfigModule } from '@nestjs/config';
+
+import { settingsConfiguration } from './config/configuration';
+import { validationSchema } from './config/validation';
+import { AppController } from './app.controller';
+import { AppService } from './app.service';
+import { rapidkitModules } from './modules';
+import { ExamplesModule } from './examples/examples.module';
+// <<<inject:module-imports>>>
+
+@Module({
+  imports: [
+    ConfigModule.forRoot({
+      isGlobal: true,
+      load: [settingsConfiguration],
+      validationSchema,
+      expandVariables: true,
+    }),
+    ExamplesModule,
+    ...rapidkitModules,
+  ],
+  controllers: [AppController],
+  providers: [AppService],
+})
+export class AppModule {}

package/templates/kits/nestjs-standard/src/app.service.ts.j2

@@ -0,0 +1,16 @@
+import { Injectable } from '@nestjs/common';
+
+@Injectable()
+export class AppService {
+  getHealth() {
+    return {
+      status: 'ok',
+      timestamp: new Date().toISOString(),
+      version: process.env.APP_VERSION ?? process.env.npm_package_version ?? '0.0.1',
+      uptime: process.uptime(),
+      module: process.env.APP_MODULE ?? process.env.APP_NAME ?? process.env.npm_package_name ?? 'app',
+    };
+  }
+
+  // <<<inject:service-methods>>>
+}

package/templates/kits/nestjs-standard/src/auth/auth.controller.ts.j2

@@ -0,0 +1,20 @@
+import { Controller } from '@nestjs/common';
+
+@Controller('auth')
+export class AuthController {
+  // <<<inject:auth-login>>>
+  // <<<inject:auth-signup>>>
+  // <<<inject:auth-refresh>>>
+  // <<<inject:auth-logout>>>
+  // <<<inject:auth-logout-all>>>
+  // <<<inject:auth-me>>>
+  // <<<inject:auth-protected>>>
+  // <<<inject:auth-oauth-google>>>
+  // <<<inject:auth-mfa-totp>>>
+  // <<<inject:auth-email-verification>>>
+  // <<<inject:auth-captcha>>>
+  // <<<inject:auth-biometric>>>
+  // <<<inject:auth-passwordless>>>
+  // <<<inject:auth-federated>>>
+  // <<<inject:auth-zero-trust>>>
+}

package/templates/kits/nestjs-standard/src/auth/auth.module.ts.j2

@@ -0,0 +1,13 @@
+import { Module } from '@nestjs/common';
+
+// <<<inject:auth-imports>>>
+
+@Module({
+  imports: [
+    // <<<inject:auth-module>>>
+  ],
+  controllers: [],
+  providers: [],
+  exports: [],
+})
+export class AuthModule {}

package/templates/kits/nestjs-standard/src/auth/auth.service.ts.j2

@@ -0,0 +1,6 @@
+import { Injectable } from '@nestjs/common';
+
+@Injectable()
+export class AuthService {
+  // <<<inject:auth-service>>>
+}

package/templates/kits/nestjs-standard/src/auth/entities/token.entity.ts.j2

@@ -0,0 +1,3 @@
+export class TokenEntity {
+  // <<<inject:auth-token-entity>>>
+}

package/templates/kits/nestjs-standard/src/auth/entities/user.entity.ts.j2

@@ -0,0 +1,3 @@
+export class UserEntity {
+  // <<<inject:auth-user-entity>>>
+}

package/templates/kits/nestjs-standard/src/auth/entities/webauthn.entity.ts.j2

@@ -0,0 +1,3 @@
+export class WebAuthnEntity {
+  // <<<inject:auth-webauthn-entity>>>
+}

package/templates/kits/nestjs-standard/src/config/configuration.ts.j2

@@ -0,0 +1,85 @@
+import path from 'node:path';
+import { registerAs } from '@nestjs/config';
+
+/* eslint-disable @typescript-eslint/no-require-imports */
+
+// Dynamic vendor loader - resolves .rapidkit/vendor in project root or uses
+// RAPIDKIT_VENDOR_ROOT if set. This avoids hard-coded relative imports into
+// src/.rapidkit and makes generated projects robust and portable.
+const VENDOR_ROOT_ENV = 'RAPIDKIT_VENDOR_ROOT';
+const VENDOR_MODULE = '{{ rapidkit_vendor_module }}';
+const VENDOR_VERSION = '{{ rapidkit_vendor_version }}';
+const VENDOR_CONFIGURATION_RELATIVE = 'src/config/configuration';
+
+function resolveVendorRoot(): string {
+  const override = process.env[VENDOR_ROOT_ENV];
+  if (override && override.trim().length > 0) {
+    return path.resolve(override);
+  }
+  return path.resolve(process.cwd(), '.rapidkit', 'vendor');
+}
+
+function resolveVendorModule() {
+  const vendorPath = path.join(
+    resolveVendorRoot(),
+    VENDOR_MODULE,
+    VENDOR_VERSION,
+    VENDOR_CONFIGURATION_RELATIVE,
+  );
+  // Attempt to dynamically load a vendor-provided configuration. If the
+  // vendor snapshot is not present in .rapidkit/vendor (common when the
+  // 'settings' module wasn't installed), fail gracefully instead of
+  // allowing require() to throw and crash the application.
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires, global-require
+    return require(vendorPath);
+  } catch (err: unknown) {
+    const e = err as { code?: string } | undefined;
+    // Only suppress MODULE_NOT_FOUND / ENOENT for the vendor path so other
+    // unexpected errors still surface to the user.
+    if (e && (e.code === 'MODULE_NOT_FOUND' || e.code === 'ENOENT')) {
+      // eslint-disable-next-line no-console
+      console.warn(`WARN: vendor settings not found at ${vendorPath} - continuing without vendor settings`);
+      return null;
+    }
+    throw err;
+  }
+}
+
+const _vendor = resolveVendorModule();
+
+export default registerAs('app', () => ({
+  name: process.env.APP_NAME ?? "{{ project_name | replace('-', ' ') | title }}",
+  env: process.env.NODE_ENV ?? 'development',
+  host: process.env.HOST ?? '0.0.0.0',
+  port: parseInt(process.env.PORT ?? '8000', 10),
+  logLevel: (() => {
+    const raw = (process.env.LOG_LEVEL ?? 'log').toLowerCase();
+    if (raw === 'info') return 'log';
+    if (raw === 'warning') return 'warn';
+    return raw;
+  })(),
+  // <<<inject:configuration>>>
+}));
+
+// Provide a safe default settingsConfiguration if no vendor snapshot is present
+// so generated projects still boot even when the optional settings module
+// hasn't been installed.
+const defaultSettings = () => ({
+  ENV: process.env.NODE_ENV ?? 'development',
+  DEBUG: process.env.DEBUG === '1' || process.env.DEBUG?.toLowerCase() === 'true',
+  PROJECT_NAME: process.env.APP_NAME ?? '{{ project_name | replace('-', ' ') | title }}',
+  SECRET_KEY: process.env.SECRET_KEY ?? '{{ '' | generate_secret(48) }}',
+  VERSION: process.env.APP_VERSION ?? '0.0.1',
+  ALLOWED_HOSTS: (process.env.ALLOWED_HOSTS ?? '*').split(',').map((s) => s.trim()).filter(Boolean),
+  CONFIG_FILES: [],
+  CONFIG_REFRESH_INTERVAL: Number.parseInt(process.env.CONFIG_REFRESH_INTERVAL ?? '60', 10),
+  VAULT_URL: null,
+  AWS_REGION: null,
+  HOT_RELOAD_ENABLED:
+    process.env.HOT_RELOAD_ENABLED === '1' || process.env.HOT_RELOAD_ENABLED?.toLowerCase() === 'true',
+  HOT_RELOAD_ENV_ALLOWLIST: (process.env.HOT_RELOAD_ENV_ALLOWLIST ?? '').split(',').map((s) => s.trim()).filter(Boolean),
+});
+
+export const settingsConfiguration =
+  _vendor?.settingsConfiguration ?? _vendor?.default?.settingsConfiguration ?? (() => defaultSettings());

package/templates/kits/nestjs-standard/src/config/index.ts.j2

@@ -0,0 +1,2 @@
+export * from './configuration';
+export * from './validation';

package/templates/kits/nestjs-standard/src/config/validation.ts.j2

@@ -0,0 +1,21 @@
+import * as Joi from 'joi';
+
+export const validationSchema = Joi.object({
+  APP_NAME: Joi.string().default("{{ project_name | replace('-', ' ') | title }}"),
+  NODE_ENV: Joi.string().valid('development', 'production', 'test').default('development'),
+  HOST: Joi.string().hostname().default('0.0.0.0'),
+  PORT: Joi.number().port().default(8000),
+  LOG_LEVEL: Joi.string()
+    .lowercase()
+    .valid('error', 'warn', 'log', 'debug', 'verbose', 'info', 'warning')
+    .default('log'),
+});
+
+export const loggingValidationSchema = Joi.object({
+  LOG_LEVEL: Joi.string().valid('debug', 'info', 'warning', 'error').default('info'),
+  LOG_FORMAT: Joi.string().valid('json', 'text', 'colored').default('json'),
+  LOG_SINKS: Joi.string().default('stderr'),
+  LOG_ASYNC_QUEUE: Joi.boolean().truthy('true').falsy('false').default(true),
+  LOG_FILE_PATH: Joi.string().default('logs/app.log'),
+  LOG_SAMPLING_RATE: Joi.number().min(0).max(1).default(1),
+});

package/templates/kits/nestjs-standard/src/examples/dto/create-note.dto.ts.j2

@@ -0,0 +1,11 @@
+import { IsString, MaxLength } from 'class-validator';
+
+export class CreateNoteDto {
+  @IsString()
+  @MaxLength(80)
+  title!: string;
+
+  @IsString()
+  @MaxLength(500)
+  body!: string;
+}

package/templates/kits/nestjs-standard/src/examples/examples.controller.ts.j2

@@ -0,0 +1,24 @@
+import { Body, Controller, Get, Param, ParseIntPipe, Post } from '@nestjs/common';
+
+import { CreateNoteDto } from './dto/create-note.dto';
+import { ExamplesService } from './examples.service';
+
+@Controller('examples/notes')
+export class ExamplesController {
+  constructor(private readonly examplesService: ExamplesService) {}
+
+  @Post()
+  create(@Body() payload: CreateNoteDto) {
+    return this.examplesService.create(payload);
+  }
+
+  @Get()
+  findAll() {
+    return this.examplesService.findAll();
+  }
+
+  @Get(':id')
+  findOne(@Param('id', ParseIntPipe) id: number) {
+    return this.examplesService.findOne(id);
+  }
+}

package/templates/kits/nestjs-standard/src/examples/examples.module.ts.j2

@@ -0,0 +1,10 @@
+import { Module } from '@nestjs/common';
+
+import { ExamplesController } from './examples.controller';
+import { ExamplesService } from './examples.service';
+
+@Module({
+  controllers: [ExamplesController],
+  providers: [ExamplesService],
+})
+export class ExamplesModule {}

package/templates/kits/nestjs-standard/src/examples/examples.service.ts.j2

@@ -0,0 +1,33 @@
+import { Injectable, NotFoundException } from '@nestjs/common';
+
+import { CreateNoteDto } from './dto/create-note.dto';
+
+export interface ExampleNote {
+  id: number;
+  title: string;
+  body: string;
+}
+
+@Injectable()
+export class ExamplesService {
+  private notes: ExampleNote[] = [];
+  private sequence = 1;
+
+  create(payload: CreateNoteDto): ExampleNote {
+    const note: ExampleNote = { id: this.sequence++, ...payload };
+    this.notes.push(note);
+    return note;
+  }
+
+  findAll(): ExampleNote[] {
+    return [...this.notes];
+  }
+
+  findOne(id: number): ExampleNote {
+    const note = this.notes.find((entry) => entry.id === id);
+    if (!note) {
+      throw new NotFoundException('Note not found');
+    }
+    return note;
+  }
+}

package/templates/kits/nestjs-standard/src/main.ts.j2

@@ -0,0 +1,53 @@
+import { Logger } from '@nestjs/common';
+import { SwaggerModule, DocumentBuilder } from '@nestjs/swagger';
+import { NestFactory } from '@nestjs/core';
+import helmet from 'helmet';
+import compression from 'compression';
+
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule, {
+    bufferLogs: true,
+  });
+
+  const logger = new Logger('Bootstrap');
+
+  app.use(helmet());
+  app.use(compression());
+
+  app.enableCors({
+    origin: '*',
+    credentials: true,
+  });
+
+  // <<<inject:global-middleware>>>
+
+  const port = parseInt(process.env.PORT ?? '8000', 10);
+  const host = process.env.HOST ?? '0.0.0.0';
+
+  // Enable Swagger docs in development or when explicitly requested.
+  const enableDocs = process.env.RAPIDKIT_ENABLE_SWAGGER === '1' || process.env.NODE_ENV !== 'production';
+  if (enableDocs) {
+    const config = new DocumentBuilder()
+      .setTitle('{{ project_name | default("RapidKit App") }} API')
+      .setDescription('Auto-generated API docs')
+      .setVersion('{{ app_version | default("1.0.0") }}')
+      .addBearerAuth()
+      .build();
+
+    const document = SwaggerModule.createDocument(app, config);
+    SwaggerModule.setup('docs', app, document);
+  }
+
+  await app.listen(port, host);
+
+  logger.log(`🚀 Application is running on http://${host}:${port}`);
+  // <<<inject:bootstrap-hooks>>>
+}
+
+bootstrap().catch((error) => {
+  // eslint-disable-next-line no-console
+  console.error('❌ Failed to bootstrap application', error);
+  process.exit(1);
+});

package/templates/kits/nestjs-standard/src/modules/index.ts.j2

@@ -0,0 +1,25 @@
+/* eslint-disable @typescript-eslint/no-var-requires, @typescript-eslint/no-require-imports, global-require */
+
+import type { DynamicModule, Type } from '@nestjs/common';
+
+// Central export for dynamically injected RapidKit modules
+
+type ModuleRef = DynamicModule | Type<unknown>;
+
+const registerOptionalModule = (loader: () => ModuleRef | null | undefined): ModuleRef | null => {
+	try {
+		const resolved = loader();
+		return resolved ?? null;
+	} catch {
+		return null;
+	}
+};
+
+const optionalModules: Array<ModuleRef | null> = [
+	registerOptionalModule(() => require('../config/logging.module').LoggingModule as ModuleRef),
+	registerOptionalModule(() => require('../config/settings.module').SettingsModule as ModuleRef),
+	registerOptionalModule(() => require('../deployment/deployment.module').DeploymentModule as ModuleRef),
+	// <<<inject:module-exports>>>
+];
+
+export const rapidkitModules: ModuleRef[] = optionalModules.filter(Boolean) as ModuleRef[];

package/templates/kits/nestjs-standard/test/app.controller.spec.ts.j2

@@ -0,0 +1,24 @@
+import { Test, TestingModule } from '@nestjs/testing';
+
+import { AppController } from '../src/app.controller';
+import { AppService } from '../src/app.service';
+
+describe('AppController', () => {
+  let appController: AppController;
+
+  beforeEach(async () => {
+    const app: TestingModule = await Test.createTestingModule({
+      controllers: [AppController],
+      providers: [AppService],
+    }).compile();
+
+    appController = app.get<AppController>(AppController);
+  });
+
+  it('should return health status', () => {
+    const result = appController.getHealth();
+    expect(result).toHaveProperty('status', 'ok');
+  });
+
+  // <<<inject:controller-tests>>>
+});

package/templates/kits/nestjs-standard/test/app.e2e-spec.ts.j2

@@ -0,0 +1,60 @@
+import { Test, TestingModule } from '@nestjs/testing';
+import { INestApplication } from '@nestjs/common';
+import request from 'supertest';
+
+import { AppModule } from '../src/app.module';
+
+describe('AppController (e2e)', () => {
+  let app: INestApplication;
+
+  beforeAll(async () => {
+    const moduleFixture: TestingModule = await Test.createTestingModule({
+      imports: [AppModule],
+    }).compile();
+
+    app = moduleFixture.createNestApplication();
+    await app.init();
+  });
+
+  afterAll(async () => {
+    await app.close();
+  });
+
+  it('/health (GET)', () => {
+    return request(app.getHttpServer())
+      .get('/health')
+      .expect(200)
+      .expect((res) => {
+        expect(res.body).toEqual(
+          expect.objectContaining({
+            status: 'ok',
+            timestamp: expect.any(String),
+            version: expect.any(String),
+            uptime: expect.any(Number),
+            module: expect.any(String),
+          }),
+        );
+      });
+  });
+
+  it('/examples/notes (POST + GET)', async () => {
+    const server = app.getHttpServer();
+    const createResponse = await request(server)
+      .post('/examples/notes')
+      .send({ title: 'ddd', body: 'documented via e2e' })
+      .expect(201);
+
+    const noteId = createResponse.body.id;
+
+    await request(server)
+      .get('/examples/notes')
+      .expect(200)
+      .expect((res) => {
+        expect(res.body).toEqual(
+          expect.arrayContaining([expect.objectContaining({ id: noteId, title: 'ddd' })]),
+        );
+      });
+  });
+
+  // <<<inject:e2e-tests>>>
+});