rapidkit 0.11.2 → 0.12.0

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

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

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

@@ -0,0 +1,11 @@
+import { Injectable } from '@nestjs/common';
+
+@Injectable()
+export class AppService {
+  getHealth() {
+    return {
+      status: 'ok',
+      timestamp: new Date().toISOString(),
+    };
+  }
+}

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

@@ -0,0 +1,9 @@
+import { registerAs } from '@nestjs/config';
+
+export default registerAs('app', () => ({
+  name: process.env.APP_NAME ?? '{{ project_name }}',
+  env: process.env.NODE_ENV ?? 'development',
+  host: process.env.HOST ?? '0.0.0.0',
+  port: parseInt(process.env.PORT ?? '8000', 10),
+  logLevel: process.env.LOG_LEVEL ?? 'info',
+}));

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

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

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

@@ -0,0 +1,11 @@
+import * as Joi from 'joi';
+
+export const validationSchema = Joi.object({
+  APP_NAME: Joi.string().default('{{ project_name }}'),
+  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()
+    .valid('error', 'warn', 'log', 'debug', 'verbose')
+    .default('log'),
+});

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,51 @@
+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,
+  });
+
+  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 }} API')
+      .setDescription('{{ description }}')
+      .setVersion('{{ app_version }}')
+      .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}`);
+  logger.log(`📚 API docs available at http://${host}:${port}/docs`);
+}
+
+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,3 @@
+// Central export for RapidKit modules
+// Add module exports here as needed
+export const rapidkitModules = [];

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

@@ -0,0 +1,22 @@
+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');
+  });
+});

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

@@ -0,0 +1,48 @@
+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({
+      status: 'ok',
+      timestamp: expect.any(String),
+    });
+  });
+
+  it('/examples/notes (POST + GET)', async () => {
+    const server = app.getHttpServer();
+    const createResponse = await request(server)
+      .post('/examples/notes')
+      .send({ title: 'test', body: 'e2e test note' })
+      .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: 'test' })]),
+        );
+      });
+  });
+});

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

@@ -0,0 +1,28 @@
+import { Test, TestingModule } from '@nestjs/testing';
+
+import { ExamplesController } from '../src/examples/examples.controller';
+import { ExamplesService } from '../src/examples/examples.service';
+
+describe('ExamplesController', () => {
+  let controller: ExamplesController;
+
+  beforeEach(async () => {
+    const module: TestingModule = await Test.createTestingModule({
+      controllers: [ExamplesController],
+      providers: [ExamplesService],
+    }).compile();
+
+    controller = module.get<ExamplesController>(ExamplesController);
+  });
+
+  it('creates and retrieves notes', () => {
+    const created = controller.create({ title: 'spec', body: 'covered by tests' });
+    expect(created).toMatchObject({ id: 1, title: 'spec' });
+
+    const list = controller.findAll();
+    expect(list).toHaveLength(1);
+
+    const single = controller.findOne(created.id);
+    expect(single).toMatchObject({ id: created.id, title: 'spec' });
+  });
+});

package/templates/kits/nestjs-standard/test/jest-e2e.json.j2

@@ -0,0 +1,15 @@
+{
+  "moduleFileExtensions": ["js", "json", "ts"],
+  "rootDir": "../",
+  "testEnvironment": "node",
+  "testRegex": ".e2e-spec.ts$",
+  "transform": {
+    "^.+\\.ts$": "ts-jest"
+  },
+  "setupFiles": ["dotenv/config"],
+  "moduleNameMapper": {
+    "^@config/(.*)$": "<rootDir>/src/config/$1",
+    "^@modules/(.*)$": "<rootDir>/src/modules/$1",
+    "^@shared/(.*)$": "<rootDir>/src/shared/$1"
+  }
+}

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

@@ -0,0 +1,12 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "declaration": true,
+    "sourceMap": false,
+    "removeComments": true,
+    "incremental": false
+  },
+  "exclude": ["node_modules", "test", "src/**/*.spec.ts", "src/**/*.e2e-spec.ts"],
+  "include": ["src/**/*.ts"]
+}

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

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "declaration": true,
+    "removeComments": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "target": "es2021",
+    "sourceMap": true,
+    "outDir": "./dist",
+    "baseUrl": "./",
+    "incremental": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "moduleResolution": "node",
+    "esModuleInterop": true,
+    "paths": {
+      "@config/*": ["src/config/*"],
+      "@modules/*": ["src/modules/*"],
+      "@shared/*": ["src/shared/*"]
+    }
+  },
+  "exclude": ["node_modules", "dist"],
+  "include": ["src/**/*.ts", "test/**/*.ts"]
+}