wexts 3.0.1 → 4.0.0

package/templates/Dockerfile

@@ -1,60 +1,60 @@
-# Stage 1: Build
-FROM node:20-alpine AS builder
-
-# Install pnpm
-RUN npm install -g pnpm
-
-# Set working directory
-WORKDIR /app
-
-# Copy package files
-COPY package.json pnpm-lock.yaml pnpm-workspace.yaml ./
-COPY apps/web/package.json ./apps/web/
-COPY apps/api/package.json ./apps/api/
-
-# Install dependencies
-RUN pnpm install --frozen-lockfile
-
-# Copy source code
-COPY . .
-
-# Generate Prisma Client
-RUN cd apps/api && npx prisma generate
-
-# Build all apps
-RUN pnpm run build
-
-# Stage 2: Production
-FROM node:20-alpine AS runner
-
-# Install pnpm
-RUN npm install -g pnpm
-
-WORKDIR /app
-
-# Copy package files
-COPY package.json pnpm-lock.yaml pnpm-workspace.yaml ./
-COPY apps/web/package.json ./apps/web/
-COPY apps/api/package.json ./apps/api/
-
-# Install production dependencies only
-RUN pnpm install --prod --frozen-lockfile
-
-# Copy built files from builder
-COPY --from=builder /app/dist ./dist
-COPY --from=builder /app/apps/web/.next ./apps/web/.next
-COPY --from=builder /app/apps/web/public ./apps/web/public
-COPY --from=builder /app/apps/api/dist ./apps/api/dist
-COPY --from=builder /app/apps/api/prisma ./apps/api/prisma
-COPY --from=builder /app/node_modules/.prisma ./node_modules/.prisma
-COPY --from=builder /app/server.ts ./server.ts
-
-# Expose port
-EXPOSE 3000
-
-# Set environment
-ENV NODE_ENV=production
-ENV PORT=3000
-
-# Start application
-CMD ["node", "dist/server.js"]
+# Stage 1: Build
+FROM node:20-alpine AS builder
+
+# Install pnpm
+RUN npm install -g pnpm
+
+# Set working directory
+WORKDIR /app
+
+# Copy package files
+COPY package.json pnpm-lock.yaml pnpm-workspace.yaml ./
+COPY apps/web/package.json ./apps/web/
+COPY apps/api/package.json ./apps/api/
+
+# Install dependencies
+RUN pnpm install --frozen-lockfile
+
+# Copy source code
+COPY . .
+
+# Generate Prisma Client
+RUN cd apps/api && npx prisma generate
+
+# Build all apps
+RUN pnpm run build
+
+# Stage 2: Production
+FROM node:20-alpine AS runner
+
+# Install pnpm
+RUN npm install -g pnpm
+
+WORKDIR /app
+
+# Copy package files
+COPY package.json pnpm-lock.yaml pnpm-workspace.yaml ./
+COPY apps/web/package.json ./apps/web/
+COPY apps/api/package.json ./apps/api/
+
+# Install production dependencies only
+RUN pnpm install --prod --frozen-lockfile
+
+# Copy built files from builder
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/apps/web/.next ./apps/web/.next
+COPY --from=builder /app/apps/web/public ./apps/web/public
+COPY --from=builder /app/apps/api/dist ./apps/api/dist
+COPY --from=builder /app/apps/api/prisma ./apps/api/prisma
+COPY --from=builder /app/node_modules/.prisma ./node_modules/.prisma
+COPY --from=builder /app/server.ts ./server.ts
+
+# Expose port
+EXPOSE 3000
+
+# Set environment
+ENV NODE_ENV=production
+ENV PORT=3000
+
+# Start application
+CMD ["node", "dist/server.js"]

package/templates/Procfile

@@ -1 +1 @@
-web: pnpm start
+web: pnpm start

package/templates/README.md

@@ -1,58 +1,67 @@
-# WEXTS 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` - Type-safe SDK for API calls (zero URLs needed!)
-- `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 used by the WEXTS CLI when creating a new project:
-
-```bash
-npx wexts create my-app
-```
-
-## ✨ Features
-
-✅ **Unified Server** - Single Node.js process for frontend + backend  
-✅ **Zero URLs** - Type-safe SDK without explicit API URLs  
-✅ **Smart Routing** - Automatic routing between Next.js and NestJS  
-✅ **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: