wexts 4.1.5 → 4.1.7

package/templates/README.md

@@ -1,67 +1,67 @@
-# Deprecated Legacy Templates
-
-These templates predate the verified `examples/hello-rpc` runtime/RPC/security model. They are retained for compatibility while the scaffold is consolidated.
-
-For release validation and production guidance, use `examples/hello-rpc`. Do not treat these legacy templates as the recommended production app structure.
-
----
-
-# WEXTS Legacy Templates
-
-This directory contains all the templates needed to create a WEXTS unified server application.
-
-## 📁 Files Included
-
-### Core Templates
-- `server.ts` - Unified server that runs Next.js + NestJS in one process
-- `api-sdk.ts` - legacy SDK scaffold retained for compatibility
-- `root-package.json` - Root package.json with all scripts
-- `tsconfig.json` - TypeScript configuration
-- `.env.example` - Environment variables template
-
-### Deployment Templates
-- `Dockerfile` - Docker multi-stage build
-- `docker-compose.yml` - Docker Compose with PostgreSQL
-- `.dockerignore` - Docker ignore file
-- `nixpacks.toml` - Railway deployment config
-- `Procfile` - Render/Heroku deployment
-
-### App Templates
-- `nestjs-api/` - NestJS backend template
-- `nextjs-web/` - Next.js frontend template
-
-## 🚀 Usage
-
-These templates are legacy scaffold assets. The canonical verified example is:
-
-```bash
-pnpm --filter wexts-example-hello-rpc generate
-pnpm --filter wexts-example-hello-rpc build
-```
-
-## ✨ Features
-
-✅ **Unified Server** - Single Node.js process for frontend + backend  
-✅ **Generated RPC** - In the canonical `examples/hello-rpc` path  
-✅ **Smart Routing** - In the production Fastify runtime  
-✅ **Docker Ready** - Complete Docker setup included  
-✅ **Multi-Platform Deploy** - Railway, Render, Docker, VPS  
-
-## 📦 Template Structure
-
-```
-project/
-├── server.ts              ← Unified server
-├── package.json           ← Root package
-├── tsconfig.json          ← TS config
-├── .env.example           ← Env template
-├── Dockerfile             ← Docker build
-├── docker-compose.yml     ← Docker + DB
-├── apps/
-│   ├── api/              ← From nestjs-api template
-│   └── web/              ← From nextjs-web template
-```
-
-## 🔧 Customization
-
-Templates can be customized before project creation. See CLI documentation for details.
+# Deprecated Legacy Templates
+
+These templates predate the verified `examples/hello-rpc` runtime/RPC/security model. They are retained for compatibility while the scaffold is consolidated.
+
+For release validation and production guidance, use `examples/hello-rpc`. Do not treat these legacy templates as the recommended production app structure.
+
+---
+
+# WEXTS Legacy Templates
+
+This directory contains all the templates needed to create a WEXTS unified server application.
+
+## 📁 Files Included
+
+### Core Templates
+- `server.ts` - Unified server that runs Next.js + NestJS in one process
+- `api-sdk.ts` - legacy SDK scaffold retained for compatibility
+- `root-package.json` - Root package.json with all scripts
+- `tsconfig.json` - TypeScript configuration
+- `.env.example` - Environment variables template
+
+### Deployment Templates
+- `Dockerfile` - Docker multi-stage build
+- `docker-compose.yml` - Docker Compose with PostgreSQL
+- `.dockerignore` - Docker ignore file
+- `nixpacks.toml` - Railway deployment config
+- `Procfile` - Render/Heroku deployment
+
+### App Templates
+- `nestjs-api/` - NestJS backend template
+- `nextjs-web/` - Next.js frontend template
+
+## 🚀 Usage
+
+These templates are legacy scaffold assets. The canonical verified example is:
+
+```bash
+pnpm --filter wexts-example-hello-rpc generate
+pnpm --filter wexts-example-hello-rpc build
+```
+
+## ✨ Features
+
+✅ **Unified Server** - Single Node.js process for frontend + backend  
+✅ **Generated RPC** - In the canonical `examples/hello-rpc` path  
+✅ **Smart Routing** - In the production Fastify runtime  
+✅ **Docker Ready** - Complete Docker setup included  
+✅ **Multi-Platform Deploy** - Railway, Render, Docker, VPS  
+
+## 📦 Template Structure
+
+```
+project/
+├── server.ts              ← Unified server
+├── package.json           ← Root package
+├── tsconfig.json          ← TS config
+├── .env.example           ← Env template
+├── Dockerfile             ← Docker build
+├── docker-compose.yml     ← Docker + DB
+├── apps/
+│   ├── api/              ← From nestjs-api template
+│   └── web/              ← From nextjs-web template
+```
+
+## 🔧 Customization
+
+Templates can be customized before project creation. See CLI documentation for details.

package/templates/api-sdk.ts

@@ -1,115 +1,115 @@
-/**
- * WEXTS Internal SDK
- * Type-safe API client - ZERO URLs needed!
- * Works in both Client and Server Components
- */
-
-// HTTP client - uses relative paths only
-async function request<T>(method: string, path: string, data?: any): Promise<T> {
-    const url = `/api${path}`;
-
-    const options: RequestInit = {
-        method,
-        headers: {
-            'Content-Type': 'application/json',
-        },
-        credentials: 'include',
-    };
-
-    if (data) {
-        options.body = JSON.stringify(data);
-    }
-
-    const response = await fetch(url, options);
-
-    if (!response.ok) {
-        const error = await response.json().catch(() => ({ message: response.statusText }));
-        throw new Error(error.message || 'Request failed');
-    }
-
-    return response.json();
-}
-
-// ==========================================
-// TYPE-SAFE API - NO URLs ANYWHERE!
-// ==========================================
-
-export const api = {
-    /**
-     * Authentication API
-     */
-    auth: {
-        /**
-         * Register new user
-         * @example await api.auth.register({ email, password, name })
-         */
-        register: (data: { email: string; password: string; name?: string }) =>
-            request<{ user: any; access_token: string }>('POST', '/auth/register', data),
-
-        /**
-         * Login user
-         * @example await api.auth.login({ email, password })
-         */
-        login: (data: { email: string; password: string }) =>
-            request<{ user: any; access_token: string }>('POST', '/auth/login', data),
-
-        /**
-         * Get current user
-         * @example const user = await api.auth.me()
-         */
-        me: () => request<any>('GET', '/auth/me'),
-    },
-
-    /**
-     * Users API
-     */
-    users: {
-        /**
-         * Get current user profile
-         * @example const profile = await api.users.me()
-         */
-        me: () => request<any>('GET', '/users/me'),
-    },
-
-    /**
-     * Todos API
-     */
-    todos: {
-        /**
-         * Get all todos
-         * @example const todos = await api.todos.findAll()
-         */
-        findAll: () => request<any[]>('GET', '/todos'),
-
-        /**
-         * Get single todo
-         * @example const todo = await api.todos.findOne('123')
-         */
-        findOne: (id: string) => request<any>('GET', `/todos/${id}`),
-
-        /**
-         * Create new todo
-         * @example await api.todos.create({ title: 'Task', description: 'Do it' })
-         */
-        create: (data: { title: string; description?: string }) =>
-            request<any>('POST', '/todos', data),
-
-        /**
-         * Update todo
-         * @example await api.todos.update('123', { completed: true })
-         */
-        update: (id: string, data: { title?: string; description?: string; completed?: boolean }) =>
-            request<any>('PUT', `/todos/${id}`, data),
-
-        /**
-         * Delete todo
-         * @example await api.todos.delete('123')
-         */
-        delete: (id: string) => request<void>('DELETE', `/todos/${id}`),
-    },
-};
-
-/**
- * Export type-safe API
- */
-export type API = typeof api;
+/**
+ * WEXTS Internal SDK
+ * Type-safe API client - ZERO URLs needed!
+ * Works in both Client and Server Components
+ */
+
+// HTTP client - uses relative paths only
+async function request<T>(method: string, path: string, data?: any): Promise<T> {
+    const url = `/api${path}`;
+
+    const options: RequestInit = {
+        method,
+        headers: {
+            'Content-Type': 'application/json',
+        },
+        credentials: 'include',
+    };
+
+    if (data) {
+        options.body = JSON.stringify(data);
+    }
+
+    const response = await fetch(url, options);
+
+    if (!response.ok) {
+        const error = await response.json().catch(() => ({ message: response.statusText }));
+        throw new Error(error.message || 'Request failed');
+    }
+
+    return response.json();
+}
+
+// ==========================================
+// TYPE-SAFE API - NO URLs ANYWHERE!
+// ==========================================
+
+export const api = {
+    /**
+     * Authentication API
+     */
+    auth: {
+        /**
+         * Register new user
+         * @example await api.auth.register({ email, password, name })
+         */
+        register: (data: { email: string; password: string; name?: string }) =>
+            request<{ user: any; access_token: string }>('POST', '/auth/register', data),
+
+        /**
+         * Login user
+         * @example await api.auth.login({ email, password })
+         */
+        login: (data: { email: string; password: string }) =>
+            request<{ user: any; access_token: string }>('POST', '/auth/login', data),
+
+        /**
+         * Get current user
+         * @example const user = await api.auth.me()
+         */
+        me: () => request<any>('GET', '/auth/me'),
+    },
+
+    /**
+     * Users API
+     */
+    users: {
+        /**
+         * Get current user profile
+         * @example const profile = await api.users.me()
+         */
+        me: () => request<any>('GET', '/users/me'),
+    },
+
+    /**
+     * Todos API
+     */
+    todos: {
+        /**
+         * Get all todos
+         * @example const todos = await api.todos.findAll()
+         */
+        findAll: () => request<any[]>('GET', '/todos'),
+
+        /**
+         * Get single todo
+         * @example const todo = await api.todos.findOne('123')
+         */
+        findOne: (id: string) => request<any>('GET', `/todos/${id}`),
+
+        /**
+         * Create new todo
+         * @example await api.todos.create({ title: 'Task', description: 'Do it' })
+         */
+        create: (data: { title: string; description?: string }) =>
+            request<any>('POST', '/todos', data),
+
+        /**
+         * Update todo
+         * @example await api.todos.update('123', { completed: true })
+         */
+        update: (id: string, data: { title?: string; description?: string; completed?: boolean }) =>
+            request<any>('PUT', `/todos/${id}`, data),
+
+        /**
+         * Delete todo
+         * @example await api.todos.delete('123')
+         */
+        delete: (id: string) => request<void>('DELETE', `/todos/${id}`),
+    },
+};
+
+/**
+ * Export type-safe API
+ */
+export type API = typeof api;

package/templates/docker-compose.yml

@@ -1,34 +1,34 @@
-version: '3.8'
-
-services:
-  # WEXTS Application
-  app:
-    build:
-      context: .
-      dockerfile: Dockerfile
-    ports:
-      - "3000:3000"
-    environment:
-      - NODE_ENV=production
-      - DATABASE_URL=postgresql://wexts:wexts_password@postgres:5432/wexts_db
-      - JWT_SECRET=your-super-secret-jwt-key-change-this
-      - PORT=3000
-    depends_on:
-      - postgres
-    restart: unless-stopped
-
-  # PostgreSQL Database
-  postgres:
-    image: postgres:16-alpine
-    ports:
-      - "5432:5432"
-    environment:
-      - POSTGRES_USER=wexts
-      - POSTGRES_PASSWORD=wexts_password
-      - POSTGRES_DB=wexts_db
-    volumes:
-      - postgres_data:/var/lib/postgresql/data
-    restart: unless-stopped
-
-volumes:
-  postgres_data:
+version: '3.8'
+
+services:
+  # WEXTS Application
+  app:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    ports:
+      - "3000:3000"
+    environment:
+      - NODE_ENV=production
+      - DATABASE_URL=postgresql://wexts:wexts_password@postgres:5432/wexts_db
+      - JWT_SECRET=your-super-secret-jwt-key-change-this
+      - PORT=3000
+    depends_on:
+      - postgres
+    restart: unless-stopped
+
+  # PostgreSQL Database
+  postgres:
+    image: postgres:16-alpine
+    ports:
+      - "5432:5432"
+    environment:
+      - POSTGRES_USER=wexts
+      - POSTGRES_PASSWORD=wexts_password
+      - POSTGRES_DB=wexts_db
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    restart: unless-stopped
+
+volumes:
+  postgres_data:

package/templates/nestjs-api/.env.example

@@ -1,3 +1,3 @@
-DATABASE_URL="file:./dev.db"
-JWT_SECRET="super-secret-secret"
-PORT=5050
+DATABASE_URL="file:./dev.db"
+JWT_SECRET="super-secret-secret"
+PORT=5050

package/templates/nestjs-api/README.md

@@ -1,87 +1,87 @@
-# 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
-
-Deprecated compatibility backend template. The verified Wexts 4 starter uses NestJS 11, generated RPC, and no required Prisma/Auth/Todos stack.
-
-## 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
-```
+# 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
+
+Deprecated compatibility backend template. The verified Wexts 4 starter uses NestJS 11, generated RPC, and no required Prisma/Auth/Todos stack.
+
+## 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
+    }
 }