@gyxer-studio/generator 0.1.0

package/README.md

@@ -0,0 +1,63 @@
+# @gyxer-studio/generator
+
+NestJS project code generator. Takes a Gyxer schema and generates a complete, production-ready NestJS application with Prisma ORM.
+
+## Installation
+
+```bash
+npm install @gyxer-studio/generator
+```
+
+## Usage
+
+```typescript
+import { generateProject } from '@gyxer-studio/generator';
+import type { GyxerProject } from '@gyxer-studio/schema';
+
+const project: GyxerProject = {
+  name: 'my-app',
+  version: '0.1.0',
+  entities: [/* ... */],
+  modules: [],
+  settings: {
+    port: 3000,
+    database: 'postgresql',
+    // ...
+  },
+};
+
+const files = generateProject(project);
+// files is a Map<string, string> of filepath → content
+
+for (const [path, content] of files) {
+  // write files to disk
+}
+```
+
+## What Gets Generated
+
+- **Prisma schema** with models, relations, and enums
+- **NestJS modules** with controllers, services, and DTOs
+- **CRUD endpoints** with Swagger decorators and validation
+- **JWT auth** (when `auth-jwt` module is enabled)
+- **Docker** files (Dockerfile + docker-compose.yml)
+- **Security report** with best practices assessment
+
+## Individual Generators
+
+```typescript
+import {
+  generatePrismaSchema,
+  generateCreateDto,
+  generateUpdateDto,
+  generateController,
+  generateService,
+  generateModule,
+  generateDockerfile,
+  generateDockerCompose,
+} from '@gyxer-studio/generator';
+```
+
+## Part of [Gyxer Studio](https://github.com/Gyxer513/gyxer-studio)
+
+MIT License

package/dist/generators/app.generator.d.ts

@@ -0,0 +1,19 @@
+import type { GyxerProject } from '@gyxer-studio/schema';
+/**
+ * Generate main.ts bootstrap file.
+ */
+export declare function generateMain(project: GyxerProject): string;
+/**
+ * Generate app.module.ts with all entity modules imported.
+ */
+export declare function generateAppModule(project: GyxerProject): string;
+/**
+ * Generate PrismaService and PrismaModule.
+ */
+export declare function generatePrismaService(): string;
+export declare function generatePrismaModule(): string;
+/**
+ * Generate Prisma exception filter that converts Prisma errors to proper HTTP responses.
+ */
+export declare function generatePrismaExceptionFilter(): string;
+//# sourceMappingURL=app.generator.d.ts.map

package/dist/generators/app.generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.generator.d.ts","sourceRoot":"","sources":["../../src/generators/app.generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAgF1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CA+E/D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAe9C;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAW7C;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,CA6DtD"}

package/dist/generators/app.generator.js

@@ -0,0 +1,237 @@
+import { toKebabCase } from '../utils.js';
+/**
+ * Generate main.ts bootstrap file.
+ */
+export function generateMain(project) {
+    const lines = [];
+    lines.push(`import { NestFactory } from '@nestjs/core';`);
+    lines.push(`import { ValidationPipe } from '@nestjs/common';`);
+    if (project.settings.enableSwagger) {
+        lines.push(`import { DocumentBuilder, SwaggerModule } from '@nestjs/swagger';`);
+    }
+    if (project.settings.enableHelmet) {
+        lines.push(`import helmet from 'helmet';`);
+    }
+    lines.push(`import { AppModule } from './app.module';`);
+    lines.push(`import { PrismaExceptionFilter } from './prisma/prisma-exception.filter';`);
+    lines.push('');
+    lines.push('async function bootstrap() {');
+    lines.push('  const app = await NestFactory.create(AppModule);');
+    lines.push('');
+    // Helmet
+    if (project.settings.enableHelmet) {
+        lines.push('  // Security headers');
+        lines.push('  app.use(helmet());');
+        lines.push('');
+    }
+    // CORS
+    if (project.settings.enableCors) {
+        lines.push('  // CORS');
+        lines.push('  app.enableCors();');
+        lines.push('');
+    }
+    // Validation
+    lines.push('  // Global validation pipe');
+    lines.push('  app.useGlobalPipes(');
+    lines.push('    new ValidationPipe({');
+    lines.push('      whitelist: true,');
+    lines.push('      forbidNonWhitelisted: true,');
+    lines.push('      transform: true,');
+    lines.push('    }),');
+    lines.push('  );');
+    lines.push('');
+    lines.push('  // Prisma exception filter — converts DB errors to proper HTTP responses');
+    lines.push('  app.useGlobalFilters(new PrismaExceptionFilter());');
+    lines.push('');
+    // Swagger
+    if (project.settings.enableSwagger) {
+        lines.push('  // Swagger API documentation');
+        const hasAuthJwt = project.modules?.some((m) => m.name === 'auth-jwt' && m.enabled !== false) ?? false;
+        lines.push('  const config = new DocumentBuilder()');
+        lines.push(`    .setTitle('${project.name}')`);
+        lines.push(`    .setDescription('${project.description || 'API documentation'}')`);
+        lines.push(`    .setVersion('${project.version}')`);
+        if (hasAuthJwt) {
+            lines.push("    .addBearerAuth()");
+        }
+        lines.push('    .build();');
+        lines.push('  const document = SwaggerModule.createDocument(app, config);');
+        lines.push("  SwaggerModule.setup('api/docs', app, document);");
+        lines.push('');
+    }
+    lines.push(`  await app.listen(process.env.PORT ?? ${project.settings.port});`);
+    lines.push(`  console.log(\`Application is running on: \${await app.getUrl()}\`);`);
+    if (project.settings.enableSwagger) {
+        lines.push(`  console.log(\`Swagger docs: \${await app.getUrl()}/api/docs\`);`);
+    }
+    lines.push('}');
+    lines.push('bootstrap();');
+    return lines.join('\n') + '\n';
+}
+/**
+ * Generate app.module.ts with all entity modules imported.
+ */
+export function generateAppModule(project) {
+    const hasAuthJwt = project.modules?.some((m) => m.name === 'auth-jwt' && m.enabled !== false) ?? false;
+    const needsAppGuard = project.settings.enableRateLimit || hasAuthJwt;
+    const imports = [];
+    const moduleNames = [];
+    // Prisma module
+    imports.push(`import { PrismaModule } from './prisma/prisma.module';`);
+    moduleNames.push('PrismaModule');
+    // Rate limiting
+    if (project.settings.enableRateLimit) {
+        imports.push(`import { ThrottlerModule, ThrottlerGuard } from '@nestjs/throttler';`);
+    }
+    // Auth JWT
+    if (hasAuthJwt) {
+        imports.push(`import { AuthModule } from './auth/auth.module';`);
+        imports.push(`import { JwtAuthGuard } from './auth/guards/jwt-auth.guard';`);
+        moduleNames.push('AuthModule');
+    }
+    if (needsAppGuard) {
+        imports.push(`import { APP_GUARD } from '@nestjs/core';`);
+    }
+    // Entity modules
+    for (const entity of project.entities) {
+        const kebab = toKebabCase(entity.name);
+        imports.push(`import { ${entity.name}Module } from './${kebab}/${kebab}.module';`);
+        moduleNames.push(`${entity.name}Module`);
+    }
+    const lines = [];
+    lines.push(`import { Module } from '@nestjs/common';`);
+    for (const imp of imports) {
+        lines.push(imp);
+    }
+    lines.push('');
+    lines.push('@Module({');
+    lines.push('  imports: [');
+    if (project.settings.enableRateLimit) {
+        lines.push('    ThrottlerModule.forRoot([{');
+        lines.push(`      ttl: ${(project.settings.rateLimitTtl ?? 60) * 1000},`);
+        lines.push(`      limit: ${project.settings.rateLimitMax ?? 100},`);
+        lines.push('    }]),');
+    }
+    for (const mod of moduleNames) {
+        lines.push(`    ${mod},`);
+    }
+    lines.push('  ],');
+    if (needsAppGuard) {
+        lines.push('  providers: [');
+        if (project.settings.enableRateLimit) {
+            lines.push('    {');
+            lines.push('      provide: APP_GUARD,');
+            lines.push('      useClass: ThrottlerGuard,');
+            lines.push('    },');
+        }
+        if (hasAuthJwt) {
+            lines.push('    // Global JWT guard — all routes protected by default');
+            lines.push('    // Use @Public() decorator to make specific routes public');
+            lines.push('    {');
+            lines.push('      provide: APP_GUARD,');
+            lines.push('      useClass: JwtAuthGuard,');
+            lines.push('    },');
+        }
+        lines.push('  ],');
+    }
+    lines.push('})');
+    lines.push('export class AppModule {}');
+    return lines.join('\n') + '\n';
+}
+/**
+ * Generate PrismaService and PrismaModule.
+ */
+export function generatePrismaService() {
+    return `import { Injectable, OnModuleInit, OnModuleDestroy } from '@nestjs/common';
+import { PrismaClient } from '@prisma/client';
+
+@Injectable()
+export class PrismaService extends PrismaClient implements OnModuleInit, OnModuleDestroy {
+  async onModuleInit() {
+    await this.$connect();
+  }
+
+  async onModuleDestroy() {
+    await this.$disconnect();
+  }
+}
+`;
+}
+export function generatePrismaModule() {
+    return `import { Global, Module } from '@nestjs/common';
+import { PrismaService } from './prisma.service';
+
+@Global()
+@Module({
+  providers: [PrismaService],
+  exports: [PrismaService],
+})
+export class PrismaModule {}
+`;
+}
+/**
+ * Generate Prisma exception filter that converts Prisma errors to proper HTTP responses.
+ */
+export function generatePrismaExceptionFilter() {
+    return `import { ArgumentsHost, Catch, ExceptionFilter, HttpStatus } from '@nestjs/common';
+import { Prisma } from '@prisma/client';
+import { Response } from 'express';
+
+@Catch(Prisma.PrismaClientKnownRequestError)
+export class PrismaExceptionFilter implements ExceptionFilter {
+  catch(exception: Prisma.PrismaClientKnownRequestError, host: ArgumentsHost) {
+    const ctx = host.switchToHttp();
+    const response = ctx.getResponse<Response>();
+
+    switch (exception.code) {
+      case 'P2002': {
+        // Unique constraint violation
+        const fields = (exception.meta?.target as string[]) || [];
+        response.status(HttpStatus.CONFLICT).json({
+          statusCode: HttpStatus.CONFLICT,
+          message: \`Unique constraint violation on: \${fields.join(', ')}\`,
+          error: 'Conflict',
+        });
+        break;
+      }
+      case 'P2003': {
+        // Foreign key constraint violation
+        const field = (exception.meta?.field_name as string) || 'unknown';
+        response.status(HttpStatus.BAD_REQUEST).json({
+          statusCode: HttpStatus.BAD_REQUEST,
+          message: \`Foreign key constraint violated on: \${field}\`,
+          error: 'Bad Request',
+        });
+        break;
+      }
+      case 'P2025': {
+        // Record not found
+        response.status(HttpStatus.NOT_FOUND).json({
+          statusCode: HttpStatus.NOT_FOUND,
+          message: (exception.meta?.cause as string) || 'Record not found',
+          error: 'Not Found',
+        });
+        break;
+      }
+      case 'P2014': {
+        // Required relation violation
+        response.status(HttpStatus.BAD_REQUEST).json({
+          statusCode: HttpStatus.BAD_REQUEST,
+          message: 'Required relation violation',
+          error: 'Bad Request',
+        });
+        break;
+      }
+      default: {
+        response.status(HttpStatus.INTERNAL_SERVER_ERROR).json({
+          statusCode: HttpStatus.INTERNAL_SERVER_ERROR,
+          message: \`Database error: \${exception.code}\`,
+          error: 'Internal Server Error',
+        });
+      }
+    }
+  }
+}
+`;
+}
+//# sourceMappingURL=app.generator.js.map

package/dist/generators/app.generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.generator.js","sourceRoot":"","sources":["../../src/generators/app.generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAqB;IAChD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC1D,KAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IAE/D,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;IACxF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC3C,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;IACjE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,SAAS;IACT,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO;IACP,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,aAAa;IACb,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC1C,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC;IACzF,KAAK,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;IACnE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,UAAU;IACV,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,IAAI,KAAK,CAAC;QACvG,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,kBAAkB,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,WAAW,IAAI,mBAAmB,IAAI,CAAC,CAAC;QACnF,KAAK,CAAC,IAAI,CAAC,oBAAoB,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;QACpD,IAAI,UAAU,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACrC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;QAChE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,0CAA0C,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;IAChF,KAAK,CAAC,IAAI,CACR,uEAAuE,CACxE,CAAC;IAEF,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CACR,mEAAmE,CACpE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAE3B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAqB;IACrD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,IAAI,KAAK,CAAC;IACvG,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,eAAe,IAAI,UAAU,CAAC;IAErE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,gBAAgB;IAChB,OAAO,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;IACvE,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAEjC,gBAAgB;IAChB,IAAI,OAAO,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;IACvF,CAAC;IAED,WAAW;IACX,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;QAC7E,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IAC5D,CAAC;IAED,iBAAiB;IACjB,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,IAAI,oBAAoB,KAAK,IAAI,KAAK,WAAW,CAAC,CAAC;QACnF,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IACvD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAE3B,IAAI,OAAO,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;QAC1E,KAAK,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,QAAQ,CAAC,YAAY,IAAI,GAAG,GAAG,CAAC,CAAC;QACpE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEnB,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,IAAI,OAAO,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,UAAU,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;YACxE,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;YAC5E,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAExC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;;;;;;;;;;;;;CAaR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO;;;;;;;;;CASR,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B;IAC3C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2DR,CAAC;AACF,CAAC"}

package/dist/generators/controller.generator.d.ts

@@ -0,0 +1,10 @@
+import type { Entity, GyxerProject } from '@gyxer-studio/schema';
+/**
+ * Generate a NestJS controller for an entity with full CRUD + Swagger.
+ * When auth-jwt is enabled:
+ *   - GET endpoints are @Public() (no auth required)
+ *   - POST/PATCH/DELETE require JWT (global guard)
+ *   - @ApiBearerAuth() on protected endpoints for Swagger UI
+ */
+export declare function generateController(entity: Entity, project: GyxerProject): string;
+//# sourceMappingURL=controller.generator.d.ts.map

package/dist/generators/controller.generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.generator.d.ts","sourceRoot":"","sources":["../../src/generators/controller.generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGjE;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CAsFhF"}

package/dist/generators/controller.generator.js

@@ -0,0 +1,88 @@
+import { toCamelCase, toKebabCase, pluralize } from '../utils.js';
+/**
+ * Generate a NestJS controller for an entity with full CRUD + Swagger.
+ * When auth-jwt is enabled:
+ *   - GET endpoints are @Public() (no auth required)
+ *   - POST/PATCH/DELETE require JWT (global guard)
+ *   - @ApiBearerAuth() on protected endpoints for Swagger UI
+ */
+export function generateController(entity, project) {
+    const name = entity.name;
+    const camel = toCamelCase(name);
+    const kebab = toKebabCase(name);
+    const route = pluralize(kebab);
+    const serviceName = `${camel}Service`;
+    const className = `${name}Controller`;
+    const hasAuthJwt = project.modules?.some((m) => m.name === 'auth-jwt' && m.enabled !== false) ?? false;
+    const importLines = [
+        'import {',
+        '  Controller,',
+        '  Get,',
+        '  Post,',
+        '  Body,',
+        '  Patch,',
+        '  Param,',
+        '  Delete,',
+        '  ParseIntPipe,',
+        "} from '@nestjs/common';",
+    ];
+    const swaggerImports = hasAuthJwt
+        ? "import { ApiTags, ApiOperation, ApiResponse, ApiBearerAuth } from '@nestjs/swagger';"
+        : "import { ApiTags, ApiOperation, ApiResponse } from '@nestjs/swagger';";
+    importLines.push(swaggerImports);
+    if (hasAuthJwt) {
+        importLines.push("import { Public } from '../auth/decorators/public.decorator';");
+    }
+    importLines.push(`import { ${name}Service } from './${kebab}.service';`);
+    importLines.push(`import { Create${name}Dto } from './dto/create-${kebab}.dto';`);
+    importLines.push(`import { Update${name}Dto } from './dto/update-${kebab}.dto';`);
+    const protectedDecorator = hasAuthJwt ? '\n  @ApiBearerAuth()' : '';
+    const publicDecorator = hasAuthJwt ? '\n  @Public()' : '';
+    return `${importLines.join('\n')}
+
+@ApiTags('${route}')
+@Controller('${route}')
+export class ${className} {
+  constructor(private readonly ${serviceName}: ${name}Service) {}
+
+  @Post()${protectedDecorator}
+  @ApiOperation({ summary: 'Create a new ${camel}' })
+  @ApiResponse({ status: 201, description: '${name} created successfully' })
+  create(@Body() dto: Create${name}Dto) {
+    return this.${serviceName}.create(dto);
+  }
+
+  @Get()${publicDecorator}
+  @ApiOperation({ summary: 'Get all ${pluralize(camel)}' })
+  @ApiResponse({ status: 200, description: 'List of ${pluralize(camel)}' })
+  findAll() {
+    return this.${serviceName}.findAll();
+  }
+
+  @Get(':id')${publicDecorator}
+  @ApiOperation({ summary: 'Get a ${camel} by id' })
+  @ApiResponse({ status: 200, description: '${name} found' })
+  @ApiResponse({ status: 404, description: '${name} not found' })
+  findOne(@Param('id', ParseIntPipe) id: number) {
+    return this.${serviceName}.findOne(id);
+  }
+
+  @Patch(':id')${protectedDecorator}
+  @ApiOperation({ summary: 'Update a ${camel}' })
+  @ApiResponse({ status: 200, description: '${name} updated successfully' })
+  @ApiResponse({ status: 404, description: '${name} not found' })
+  update(@Param('id', ParseIntPipe) id: number, @Body() dto: Update${name}Dto) {
+    return this.${serviceName}.update(id, dto);
+  }
+
+  @Delete(':id')${protectedDecorator}
+  @ApiOperation({ summary: 'Delete a ${camel}' })
+  @ApiResponse({ status: 200, description: '${name} deleted successfully' })
+  @ApiResponse({ status: 404, description: '${name} not found' })
+  remove(@Param('id', ParseIntPipe) id: number) {
+    return this.${serviceName}.remove(id);
+  }
+}
+`;
+}
+//# sourceMappingURL=controller.generator.js.map

package/dist/generators/controller.generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.generator.js","sourceRoot":"","sources":["../../src/generators/controller.generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,OAAqB;IACtE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,WAAW,GAAG,GAAG,KAAK,SAAS,CAAC;IACtC,MAAM,SAAS,GAAG,GAAG,IAAI,YAAY,CAAC;IAEtC,MAAM,UAAU,GACd,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,IAAI,KAAK,CAAC;IAEtF,MAAM,WAAW,GAAG;QAClB,UAAU;QACV,eAAe;QACf,QAAQ;QACR,SAAS;QACT,SAAS;QACT,UAAU;QACV,UAAU;QACV,WAAW;QACX,iBAAiB;QACjB,0BAA0B;KAC3B,CAAC;IAEF,MAAM,cAAc,GAAG,UAAU;QAC/B,CAAC,CAAC,sFAAsF;QACxF,CAAC,CAAC,uEAAuE,CAAC;IAC5E,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAEjC,IAAI,UAAU,EAAE,CAAC;QACf,WAAW,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IACpF,CAAC;IAED,WAAW,CAAC,IAAI,CAAC,YAAY,IAAI,qBAAqB,KAAK,YAAY,CAAC,CAAC;IACzE,WAAW,CAAC,IAAI,CAAC,kBAAkB,IAAI,4BAA4B,KAAK,QAAQ,CAAC,CAAC;IAClF,WAAW,CAAC,IAAI,CAAC,kBAAkB,IAAI,4BAA4B,KAAK,QAAQ,CAAC,CAAC;IAElF,MAAM,kBAAkB,GAAG,UAAU,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,MAAM,eAAe,GAAG,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAE1D,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;;YAEtB,KAAK;eACF,KAAK;eACL,SAAS;iCACS,WAAW,KAAK,IAAI;;WAE1C,kBAAkB;2CACc,KAAK;8CACF,IAAI;8BACpB,IAAI;kBAChB,WAAW;;;UAGnB,eAAe;sCACa,SAAS,CAAC,KAAK,CAAC;sDACA,SAAS,CAAC,KAAK,CAAC;;kBAEpD,WAAW;;;eAGd,eAAe;oCACM,KAAK;8CACK,IAAI;8CACJ,IAAI;;kBAEhC,WAAW;;;iBAGZ,kBAAkB;uCACI,KAAK;8CACE,IAAI;8CACJ,IAAI;qEACmB,IAAI;kBACvD,WAAW;;;kBAGX,kBAAkB;uCACG,KAAK;8CACE,IAAI;8CACJ,IAAI;;kBAEhC,WAAW;;;CAG5B,CAAC;AACF,CAAC"}

package/dist/generators/docker.generator.d.ts

@@ -0,0 +1,15 @@
+import type { GyxerProject } from '@gyxer-studio/schema';
+/**
+ * Generate Dockerfile for the NestJS app.
+ */
+export declare function generateDockerfile(): string;
+/**
+ * Generate docker-compose.yml with app + PostgreSQL.
+ */
+export declare function generateDockerCompose(project: GyxerProject): string;
+/**
+ * Generate .env and .env.example files.
+ */
+export declare function generateEnvFile(project: GyxerProject): string;
+export declare function generateEnvExample(project: GyxerProject): string;
+//# sourceMappingURL=docker.generator.d.ts.map

package/dist/generators/docker.generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.generator.d.ts","sourceRoot":"","sources":["../../src/generators/docker.generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAkB3C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAsCnE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAO7D;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAMhE"}

package/dist/generators/docker.generator.js

@@ -0,0 +1,82 @@
+/**
+ * Generate Dockerfile for the NestJS app.
+ */
+export function generateDockerfile() {
+    return `FROM node:20-alpine AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm install
+COPY . .
+RUN npx prisma generate
+RUN npm run build
+
+FROM node:20-alpine AS runner
+WORKDIR /app
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/package*.json ./
+COPY --from=builder /app/prisma ./prisma
+EXPOSE 3000
+CMD ["sh", "-c", "npx prisma db push --skip-generate && node dist/main.js"]
+`;
+}
+/**
+ * Generate docker-compose.yml with app + PostgreSQL.
+ */
+export function generateDockerCompose(project) {
+    const dbName = project.name.replace(/-/g, '_');
+    return `version: '3.8'
+
+services:
+  app:
+    build: .
+    ports:
+      - "\${PORT:-${project.settings.port}}:${project.settings.port}"
+    environment:
+      - DATABASE_URL=postgresql://postgres:\${DB_PASSWORD:-postgres}@db:5432/${dbName}
+      - PORT=${project.settings.port}
+    depends_on:
+      db:
+        condition: service_healthy
+    restart: unless-stopped
+
+  db:
+    image: postgres:16-alpine
+    environment:
+      POSTGRES_DB: ${dbName}
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: \${DB_PASSWORD:-postgres}
+    ports:
+      - "\${DB_PORT:-5432}:5432"
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+    restart: unless-stopped
+
+volumes:
+  pgdata:
+`;
+}
+/**
+ * Generate .env and .env.example files.
+ */
+export function generateEnvFile(project) {
+    const dbName = project.name.replace(/-/g, '_');
+    return `DATABASE_URL=postgresql://postgres:postgres@localhost:5432/${dbName}
+PORT=${project.settings.port}
+DB_PASSWORD=postgres
+DB_PORT=5432
+`;
+}
+export function generateEnvExample(project) {
+    return `DATABASE_URL=postgresql://postgres:YOUR_PASSWORD@localhost:5432/YOUR_DB_NAME
+PORT=${project.settings.port}
+DB_PASSWORD=YOUR_PASSWORD
+DB_PORT=5432
+`;
+}
+//# sourceMappingURL=docker.generator.js.map

package/dist/generators/docker.generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.generator.js","sourceRoot":"","sources":["../../src/generators/docker.generator.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;;;;;;;;;;;;;;;;CAgBR,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAqB;IACzD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAE/C,OAAO;;;;;;oBAMW,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC,QAAQ,CAAC,IAAI;;+EAEY,MAAM;eACtE,OAAO,CAAC,QAAQ,CAAC,IAAI;;;;;;;;;qBASf,MAAM;;;;;;;;;;;;;;;;CAgB1B,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAqB;IACnD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC/C,OAAO,8DAA8D,MAAM;OACtE,OAAO,CAAC,QAAQ,CAAC,IAAI;;;CAG3B,CAAC;AACF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACtD,OAAO;OACF,OAAO,CAAC,QAAQ,CAAC,IAAI;;;CAG3B,CAAC;AACF,CAAC"}

package/dist/generators/dto.generator.d.ts

@@ -0,0 +1,23 @@
+import type { Entity, GyxerProject } from '@gyxer-studio/schema';
+/** FK field descriptor for DTO generation. */
+interface FkFieldInfo {
+    name: string;
+    targetEntity: string;
+}
+/**
+ * Collect all foreign key fields that this entity needs in its DTO.
+ * Sources:
+ *   1. Entity's own relations that define a foreignKey (explicit FK).
+ *   2. Inverse relations from other entities that create FK on this entity.
+ */
+export declare function collectFkFields(entity: Entity, project: GyxerProject): FkFieldInfo[];
+/**
+ * Generate Create DTO for an entity.
+ */
+export declare function generateCreateDto(entity: Entity, project: GyxerProject): string;
+/**
+ * Generate Update DTO for an entity (all fields optional).
+ */
+export declare function generateUpdateDto(entity: Entity, project: GyxerProject): string;
+export {};
+//# sourceMappingURL=dto.generator.d.ts.map

package/dist/generators/dto.generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dto.generator.d.ts","sourceRoot":"","sources":["../../src/generators/dto.generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAS,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGxE,8CAA8C;AAC9C,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,WAAW,EAAE,CAgDpF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CAkD/E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CAgC/E"}