wexts 3.0.2 → 4.1.0

package/templates/nestjs-api/README.md

@@ -1,79 +1,87 @@
-# Fusion NestJS API
-
-Complete NestJS 10 backend with authentication, Prisma ORM, and CRUD operations.
-
-## Features
-
-- ✅ JWT Authentication
-- ✅ Prisma ORM (SQLite for development)
-- ✅ User Management
-- ✅ Todo CRUD Operations
-- ✅ Fusion Decorators for Auto API Client Generation
-- ✅ Fastify Adapter
-- ✅ Input Validation
-
-## Setup
-
-```bash
-# Install dependencies
-npm install
-
-# Copy environment variables
-cp .env.example .env
-
-# Generate Prisma client
-npm run prisma:generate
-
-# Run migrations
-npm run prisma:migrate
-
-# Start development server
-npm run start:dev
-```
-
-## API Endpoints
-
-### Authentication
-- `POST /auth/register` - Register new user
-- `POST /auth/login` - Login
-- `GET /auth/me` - Get current user (protected)
-
-### Todos
-- `GET /todos` - Get all todos (protected)
-- `GET /todos/:id` - Get single todo (protected)
-- `POST /todos` - Create todo (protected)
-- `PUT /todos/:id` - Update todo (protected)
-- `DELETE /todos/:id` - Delete todo (protected)
-
-### Users
-- `GET /users/me` - Get current user profile (protected)
-
-## Environment Variables
-
-```env
-DATABASE_URL="file:./dev.db"
-JWT_SECRET="your-secret-key"
-JWT_EXPIRES_IN="7d"
-PORT=5050
-```
-
-## Database
-
-Using Prisma with SQLite for development. To create a new migration:
-
-```bash
-npm run prisma:migrate
-```
-
-To view database in Prisma Studio:
-
-```bash
-npm run prisma:studio
-```
-
-## Building for Production
-
-```bash
-npm run build
-npm run start:prod
-```
+# Deprecated Legacy API Template
+
+This template predates the verified `examples/hello-rpc` runtime/RPC/security model. It is retained for compatibility and should not be used as the production reference.
+
+Use `examples/hello-rpc` for the canonical generated-RPC path.
+
+---
+
+# Fusion NestJS API
+
+Complete NestJS 10 backend with authentication, Prisma ORM, and CRUD operations.
+
+## Features
+
+- ✅ JWT Authentication
+- ✅ Prisma ORM (SQLite for development)
+- ✅ User Management
+- ✅ Todo CRUD Operations
+- ⚠️ Legacy Fusion decorator notes; canonical RPC uses `@RpcService()` and `@RpcMethod()`
+- ✅ Fastify Adapter
+- ✅ Input Validation
+
+## Setup
+
+```bash
+# Install dependencies
+npm install
+
+# Copy environment variables
+cp .env.example .env
+
+# Generate Prisma client
+npm run prisma:generate
+
+# Run migrations
+npm run prisma:migrate
+
+# Start development server
+npm run start:dev
+```
+
+## API Endpoints
+
+### Authentication
+- `POST /auth/register` - Register new user
+- `POST /auth/login` - Login
+- `GET /auth/me` - Get current user (protected)
+
+### Todos
+- `GET /todos` - Get all todos (protected)
+- `GET /todos/:id` - Get single todo (protected)
+- `POST /todos` - Create todo (protected)
+- `PUT /todos/:id` - Update todo (protected)
+- `DELETE /todos/:id` - Delete todo (protected)
+
+### Users
+- `GET /users/me` - Get current user profile (protected)
+
+## Environment Variables
+
+```env
+DATABASE_URL="file:./dev.db"
+JWT_SECRET="your-secret-key"
+JWT_EXPIRES_IN="7d"
+PORT=5050
+```
+
+## Database
+
+Using Prisma with SQLite for development. To create a new migration:
+
+```bash
+npm run prisma:migrate
+```
+
+To view database in Prisma Studio:
+
+```bash
+npm run prisma:studio
+```
+
+## Building for Production
+
+```bash
+npm run build
+npm run start:prod
+```

package/templates/nestjs-api/nest-cli.json

@@ -1,7 +1,7 @@
-{
-    "collection": "@nestjs/schematics",
-    "sourceRoot": "src",
-    "compilerOptions": {
-        "deleteOutDir": true
-    }
+{
+    "collection": "@nestjs/schematics",
+    "sourceRoot": "src",
+    "compilerOptions": {
+        "deleteOutDir": true
+    }
 }

package/templates/nestjs-api/package.json

@@ -1,41 +1,41 @@
-{
-    "name": "wexts-api",
-    "version": "1.0.0",
-    "description": "wexts NestJS API",
-    "scripts": {
-        "build": "nest build",
-        "dev": "nest start --watch",
-        "start": "nest start",
-        "start:dev": "nest start --watch",
-        "start:prod": "node dist/main",
-        "prisma:generate": "prisma generate",
-        "prisma:migrate": "prisma migrate dev",
-        "prisma:studio": "prisma studio"
-    },
-    "dependencies": {
-        "@nestjs/common": "^11.0.0",
-        "@nestjs/config": "^4.0.2",
-        "@nestjs/core": "^11.0.0",
-        "@nestjs/jwt": "^11.0.0",
-        "@nestjs/passport": "^11.0.0",
-        "@nestjs/platform-fastify": "^11.0.0",
-        "@prisma/client": "^6.0.0",
-        "bcrypt": "^5.1.1",
-        "class-transformer": "^0.5.1",
-        "class-validator": "^0.14.1",
-        "passport": "^0.7.0",
-        "passport-jwt": "^4.0.1",
-        "reflect-metadata": "^0.2.2",
-        "rxjs": "^7.8.1",
-        "wexts": "^2.0.0"
-    },
-    "devDependencies": {
-        "@nestjs/cli": "^11.0.0",
-        "@nestjs/schematics": "^11.0.0",
-        "@types/bcrypt": "^5.0.2",
-        "@types/node": "^22.0.0",
-        "@types/passport-jwt": "^4.0.1",
-        "prisma": "^6.0.0",
-        "typescript": "^5.9.3"
-    }
+{
+    "name": "wexts-api",
+    "version": "1.0.0",
+    "description": "wexts NestJS API",
+    "scripts": {
+        "build": "nest build",
+        "dev": "nest start --watch",
+        "start": "nest start",
+        "start:dev": "nest start --watch",
+        "start:prod": "node dist/main",
+        "prisma:generate": "prisma generate",
+        "prisma:migrate": "prisma migrate dev",
+        "prisma:studio": "prisma studio"
+    },
+    "dependencies": {
+        "@nestjs/common": "^11.0.0",
+        "@nestjs/config": "^4.0.2",
+        "@nestjs/core": "^11.0.0",
+        "@nestjs/jwt": "^11.0.0",
+        "@nestjs/passport": "^11.0.0",
+        "@nestjs/platform-fastify": "^11.0.0",
+        "@prisma/client": "^6.0.0",
+        "bcrypt": "^5.1.1",
+        "class-transformer": "^0.5.1",
+        "class-validator": "^0.14.1",
+        "passport": "^0.7.0",
+        "passport-jwt": "^4.0.1",
+        "reflect-metadata": "^0.2.2",
+        "rxjs": "^7.8.1",
+        "wexts": "^2.0.0"
+    },
+    "devDependencies": {
+        "@nestjs/cli": "^11.0.0",
+        "@nestjs/schematics": "^11.0.0",
+        "@types/bcrypt": "^5.0.2",
+        "@types/node": "^22.0.0",
+        "@types/passport-jwt": "^4.0.1",
+        "prisma": "^6.0.0",
+        "typescript": "^5.9.3"
+    }
 }

package/templates/nestjs-api/prisma/schema.prisma

@@ -1,29 +1,29 @@
-generator client {
-  provider = "prisma-client-js"
-}
-
-datasource db {
-  provider = "sqlite"
-  url      = env("DATABASE_URL")
-}
-
-model User {
-  id        String   @id @default(uuid())
-  email     String   @unique
-  name      String?
-  password  String
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-  todos     Todo[]
-}
-
-model Todo {
-  id          String   @id @default(uuid())
-  title       String
-  description String?
-  completed   Boolean  @default(false)
-  userId      String
-  user        User     @relation(fields: [userId], references: [id], onDelete: Cascade)
-  createdAt   DateTime @default(now())
-  updatedAt   DateTime @updatedAt
-}
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "sqlite"
+  url      = env("DATABASE_URL")
+}
+
+model User {
+  id        String   @id @default(uuid())
+  email     String   @unique
+  name      String?
+  password  String
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  todos     Todo[]
+}
+
+model Todo {
+  id          String   @id @default(uuid())
+  title       String
+  description String?
+  completed   Boolean  @default(false)
+  userId      String
+  user        User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+}

package/templates/nestjs-api/src/app.module.ts

@@ -1,17 +1,17 @@
-import { Module } from '@nestjs/common';
-import { ConfigModule } from '@nestjs/config';
-import { PrismaModule } from './prisma/prisma.module';
-import { AuthModule } from './auth/auth.module';
-import { UsersModule } from './users/users.module';
-import { TodosModule } from './todos/todos.module';
-
-@Module({
-    imports: [
-        ConfigModule.forRoot({ isGlobal: true }),
-        PrismaModule,
-        AuthModule,
-        UsersModule,
-        TodosModule,
-    ],
-})
-export class AppModule { }
+import { Module } from '@nestjs/common';
+import { ConfigModule } from '@nestjs/config';
+import { PrismaModule } from './prisma/prisma.module';
+import { AuthModule } from './auth/auth.module';
+import { UsersModule } from './users/users.module';
+import { TodosModule } from './todos/todos.module';
+
+@Module({
+    imports: [
+        ConfigModule.forRoot({ isGlobal: true }),
+        PrismaModule,
+        AuthModule,
+        UsersModule,
+        TodosModule,
+    ],
+})
+export class AppModule { }

package/templates/nestjs-api/src/auth/auth.controller.ts

@@ -1,27 +1,27 @@
-import { Controller, Post, Get, Body, UseGuards, Request, Inject } from '@nestjs/common';
-import { AuthService } from './auth.service';
-import { JwtAuthGuard } from './guards/jwt-auth.guard';
-import { RegisterDto, LoginDto } from './dto/auth.dto';
-
-@Controller('auth')
-export class AuthController {
-    constructor(
-        @Inject(AuthService) private readonly authService: AuthService
-    ) { }
-
-    @Post('register')
-    async register(@Body() dto: RegisterDto) {
-        return this.authService.register(dto);
-    }
-
-    @Post('login')
-    async login(@Body() dto: LoginDto) {
-        return this.authService.login(dto);
-    }
-
-    @Get('me')
-    @UseGuards(JwtAuthGuard)
-    async getMe(@Request() req) {
-        return this.authService.getMe(req.user.userId);
-    }
-}
+import { Controller, Post, Get, Body, UseGuards, Request, Inject } from '@nestjs/common';
+import { AuthService } from './auth.service';
+import { JwtAuthGuard } from './guards/jwt-auth.guard';
+import { RegisterDto, LoginDto } from './dto/auth.dto';
+
+@Controller('auth')
+export class AuthController {
+    constructor(
+        @Inject(AuthService) private readonly authService: AuthService
+    ) { }
+
+    @Post('register')
+    async register(@Body() dto: RegisterDto) {
+        return this.authService.register(dto);
+    }
+
+    @Post('login')
+    async login(@Body() dto: LoginDto) {
+        return this.authService.login(dto);
+    }
+
+    @Get('me')
+    @UseGuards(JwtAuthGuard)
+    async getMe(@Request() req) {
+        return this.authService.getMe(req.user.userId);
+    }
+}

package/templates/nestjs-api/src/auth/auth.module.ts

@@ -1,29 +1,37 @@
-import { Module } from '@nestjs/common';
-import { JwtModule } from '@nestjs/jwt';
-import { PassportModule } from '@nestjs/passport';
-import { ConfigModule, ConfigService } from '@nestjs/config';
-import { AuthController } from './auth.controller';
-import { AuthService } from './auth.service';
-import { JwtStrategy } from './strategies/jwt.strategy';
-import { PrismaModule } from '../prisma/prisma.module';
-
-@Module({
-    imports: [
-        PrismaModule, // ✅ Important: Import PrismaModule
-        ConfigModule,
-        PassportModule,
-        JwtModule.registerAsync({
-            inject: [ConfigService],
-            useFactory: (config: ConfigService) => ({
-                secret: config.get('JWT_SECRET') || 'default-secret',
-                signOptions: {
-                    expiresIn: config.get('JWT_EXPIRES_IN') || '7d',
-                },
-            }),
-        }),
-    ],
-    controllers: [AuthController],
-    providers: [AuthService, JwtStrategy],
-    exports: [AuthService],
-})
-export class AuthModule { }
+import { Module } from '@nestjs/common';
+import { JwtModule } from '@nestjs/jwt';
+import { PassportModule } from '@nestjs/passport';
+import { ConfigModule, ConfigService } from '@nestjs/config';
+import { AuthController } from './auth.controller';
+import { AuthService } from './auth.service';
+import { JwtStrategy } from './strategies/jwt.strategy';
+import { PrismaModule } from '../prisma/prisma.module';
+
+@Module({
+    imports: [
+        PrismaModule, // ✅ Important: Import PrismaModule
+        ConfigModule,
+        PassportModule,
+        JwtModule.registerAsync({
+            inject: [ConfigService],
+            useFactory: (config: ConfigService) => ({
+                secret: getJwtSecret(config),
+                signOptions: {
+                    expiresIn: config.get('JWT_EXPIRES_IN') || '7d',
+                },
+            }),
+        }),
+    ],
+    controllers: [AuthController],
+    providers: [AuthService, JwtStrategy],
+    exports: [AuthService],
+})
+export class AuthModule { }
+
+function getJwtSecret(config: ConfigService): string {
+    const secret = config.get<string>('JWT_SECRET');
+    if (!secret || secret.length < 32) {
+        throw new Error('JWT_SECRET must be set to at least 32 characters.');
+    }
+    return secret;
+}

package/templates/nestjs-api/src/auth/auth.service.ts

@@ -1,86 +1,86 @@
-import { Injectable, UnauthorizedException, Inject } from '@nestjs/common';
-import { JwtService } from '@nestjs/jwt';
-import { PrismaService } from '../prisma/prisma.service';
-import * as bcrypt from 'bcryptjs';
-import { RegisterDto, LoginDto } from './dto/auth.dto';
-
-@Injectable()
-export class AuthService {
-    constructor(
-        @Inject(PrismaService) private readonly prisma: PrismaService,
-        @Inject(JwtService) private readonly jwtService: JwtService,
-    ) { }
-
-    async register(dto: RegisterDto) {
-        const exists = await this.prisma.user.findUnique({
-            where: { email: dto.email },
-        });
-
-        if (exists) {
-            throw new UnauthorizedException('Email already registered');
-        }
-
-        const hashedPassword = await bcrypt.hash(dto.password, 10);
-
-        const user = await this.prisma.user.create({
-            data: {
-                email: dto.email,
-                name: dto.name,
-                password: hashedPassword,
-            },
-            select: {
-                id: true,
-                email: true,
-                name: true,
-                createdAt: true,
-            },
-        });
-
-        const access_token = this.generateToken(user.id, user.email);
-
-        return { user, access_token };
-    }
-
-    async login(dto: LoginDto) {
-        const user = await this.prisma.user.findUnique({
-            where: { email: dto.email },
-        });
-
-        if (!user) {
-            throw new UnauthorizedException('Invalid credentials');
-        }
-
-        const valid = await bcrypt.compare(dto.password, user.password);
-
-        if (!valid) {
-            throw new UnauthorizedException('Invalid credentials');
-        }
-
-        const access_token = this.generateToken(user.id, user.email);
-
-        return {
-            user: {
-                id: user.id,
-                email: user.email,
-                name: user.name,
-            },
-            access_token,
-        };
-    }
-
-    async getMe(userId: string) {
-        return this.prisma.user.findUnique({
-            where: { id: userId },
-            select: {
-                id: true,
-                email: true,
-                name: true,
-                createdAt: true,
-            },
-        });
-    }
-
-    private generateToken(userId: string, email: string): string {
-        return this.jwtService.sign({ sub: userId, email });
-    }
-}
+import { Injectable, UnauthorizedException, Inject } from '@nestjs/common';
+import { JwtService } from '@nestjs/jwt';
+import { PrismaService } from '../prisma/prisma.service';
+import * as bcrypt from 'bcryptjs';
+import { RegisterDto, LoginDto } from './dto/auth.dto';
+
+@Injectable()
+export class AuthService {
+    constructor(
+        @Inject(PrismaService) private readonly prisma: PrismaService,
+        @Inject(JwtService) private readonly jwtService: JwtService,
+    ) { }
+
+    async register(dto: RegisterDto) {
+        const exists = await this.prisma.user.findUnique({
+            where: { email: dto.email },
+        });
+
+        if (exists) {
+            throw new UnauthorizedException('Email already registered');
+        }
+
+        const hashedPassword = await bcrypt.hash(dto.password, 10);
+
+        const user = await this.prisma.user.create({
+            data: {
+                email: dto.email,
+                name: dto.name,
+                password: hashedPassword,
+            },
+            select: {
+                id: true,
+                email: true,
+                name: true,
+                createdAt: true,
+            },
+        });
+
+        const access_token = this.generateToken(user.id, user.email);
+
+        return { user, access_token };
+    }
+
+    async login(dto: LoginDto) {
+        const user = await this.prisma.user.findUnique({
+            where: { email: dto.email },
+        });
+
+        if (!user) {
+            throw new UnauthorizedException('Invalid credentials');
+        }
+
+        const valid = await bcrypt.compare(dto.password, user.password);
+
+        if (!valid) {
+            throw new UnauthorizedException('Invalid credentials');
+        }
+
+        const access_token = this.generateToken(user.id, user.email);
+
+        return {
+            user: {
+                id: user.id,
+                email: user.email,
+                name: user.name,
+            },
+            access_token,
+        };
+    }
+
+    async getMe(userId: string) {
+        return this.prisma.user.findUnique({
+            where: { id: userId },
+            select: {
+                id: true,
+                email: true,
+                name: true,
+                createdAt: true,
+            },
+        });
+    }
+
+    private generateToken(userId: string, email: string): string {
+        return this.jwtService.sign({ sub: userId, email });
+    }
+}