wexts 4.0.0 → 4.1.5

package/README.md

@@ -1,49 +1,49 @@
-# Wexts Package
-
-`wexts` is a production-focused toolkit for running Next.js + NestJS behind one Fastify production runtime with generated typed RPC.
-
-## Stable In This Patch
-
-- `wexts generate` creates a deterministic RPC manifest and typed client.
-- `wexts start` starts the Fastify production runtime.
-- `wexts doctor` and `wexts doctor --security` validate common release blockers.
-- `wexts/next` exposes `FusionProvider`, `useFusion`, and `useWexts<T>()`.
-- `wexts/client` exposes `createWextsRpcClient()`.
-- `wexts/rpc` exposes RPC metadata types/decorators.
-- `wexts/runtime` exposes the production runtime helpers.
-
-## Canonical Example
-
-Use `examples/hello-rpc` from the repository as the release-verified path.
-
-```bash
-pnpm --filter wexts-example-hello-rpc generate
-pnpm --filter wexts-example-hello-rpc build
-pnpm --filter wexts-example-hello-rpc run doctor
-pnpm --filter wexts-example-hello-rpc run doctor:security
-```
-
-## Production Runtime
-
-Production runtime is single-port:
-
-- `/health`
-- `/api/health`
-- `/rpc/:service/:method`
-- optional Nest under `/api`
-- optional Next frontend routes
-
-Development mode currently runs separate web/API processes. Use `wexts start` for the supported single-port runtime path.
-
-## Security
-
-Use `@wexts/security` / Wexts Shield before runtime routes. It provides application-layer controls. It does not replace Cloudflare/WAF/provider DDoS protection, and its default memory rate limit store is single-process only.
-
-## Deprecated Compatibility Paths
-
-- `demo/`
-- `packages/templates/nestjs-api`
-- `packages/templates/nextjs-web`
-- legacy Fusion controller codegen paths
-
-These are retained for compatibility and should not be marketed as the recommended production structure.
+# Wexts Package
+
+`wexts` is a production-focused toolkit for running Next.js + NestJS behind one Fastify production runtime with generated typed RPC.
+
+## Stable In This Patch
+
+- `wexts generate` creates a deterministic RPC manifest and typed client.
+- `wexts start` starts the Fastify production runtime.
+- `wexts doctor` and `wexts doctor --security` validate common release blockers.
+- `wexts/next` exposes `FusionProvider`, `useFusion`, and `useWexts<T>()`.
+- `wexts/client` exposes `createWextsRpcClient()`.
+- `wexts/rpc` exposes RPC metadata types/decorators.
+- `wexts/runtime` exposes the production runtime helpers.
+
+## Canonical Example
+
+Use `examples/hello-rpc` from the repository as the release-verified path.
+
+```bash
+pnpm --filter wexts-example-hello-rpc generate
+pnpm --filter wexts-example-hello-rpc build
+pnpm --filter wexts-example-hello-rpc run doctor
+pnpm --filter wexts-example-hello-rpc run doctor:security
+```
+
+## Production Runtime
+
+Production runtime is single-port:
+
+- `/health`
+- `/api/health`
+- `/rpc/:service/:method`
+- optional Nest under `/api`
+- optional Next frontend routes
+
+Development mode currently runs separate web/API processes. Use `wexts start` for the supported single-port runtime path.
+
+## Security
+
+Use `@wexts/security` / Wexts Shield before runtime routes. It provides application-layer controls. It does not replace Cloudflare/WAF/provider DDoS protection, and its default memory rate limit store is single-process only.
+
+## Deprecated Compatibility Paths
+
+- `demo/`
+- `packages/templates/nestjs-api`
+- `packages/templates/nextjs-web`
+- legacy Fusion controller codegen paths
+
+These are retained for compatibility and should not be marketed as the recommended production structure.

package/bin/wexts.cjs

@@ -1,2 +1,2 @@
-#!/usr/bin/env node
-require("../dist/cli/index.js");
+#!/usr/bin/env node
+require("../dist/cli/index.js");

package/package.json

@@ -1,148 +1,153 @@
-{
-    "name": "wexts",
-    "version": "4.0.0",
-    "description": "Production-focused single-runtime Next.js + NestJS toolkit with typed RPC.",
-    "main": "./dist/index.js",
-    "module": "./dist/index.mjs",
-    "types": "./dist/index.d.ts",
-    "bin": {
-        "wexts": "bin/wexts.cjs"
-    },
-    "files": [
-        "dist",
-        "templates",
-        "bin",
-        "README.md",
-        "LICENSE"
-    ],
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.mjs",
-            "require": "./dist/index.js"
-        },
-        "./client": {
-            "types": "./dist/client/index.d.ts",
-            "import": "./dist/client/index.mjs",
-            "require": "./dist/client/index.js"
-        },
-        "./types": {
-            "types": "./dist/types/index.d.ts",
-            "import": "./dist/types/index.mjs",
-            "require": "./dist/types/index.js"
-        },
-        "./nest": {
-            "types": "./dist/nest/index.d.ts",
-            "import": "./dist/nest/index.mjs",
-            "require": "./dist/nest/index.js"
-        },
-        "./next": {
-            "types": "./dist/next/index.d.ts",
-            "import": "./dist/next/index.mjs",
-            "require": "./dist/next/index.js"
-        },
-        "./rpc": {
-            "types": "./dist/rpc/index.d.ts",
-            "import": "./dist/rpc/index.mjs",
-            "require": "./dist/rpc/index.js"
-        },
-        "./runtime": {
-            "types": "./dist/runtime/index.d.ts",
-            "import": "./dist/runtime/index.mjs",
-            "require": "./dist/runtime/index.js"
-        }
-    },
-    "scripts": {
-        "build": "tsup",
-        "dev": "tsup --watch",
-        "test": "vitest run",
-        "test:watch": "vitest",
-        "lint": "tsc --noEmit",
-        "typecheck": "tsc --noEmit",
-        "release": "npm run build && npm publish --access public"
-    },
-    "keywords": [
-        "wexts",
-        "framework",
-        "fullstack",
-        "nestjs",
-        "nextjs",
-        "monorepo",
-        "typescript",
-        "react",
-        "unified-runtime",
-        "generated-rpc",
-        "type-safe",
-        "prisma",
-        "jwt-auth",
-        "docker",
-        "next.js",
-        "nest.js"
-    ],
-    "author": "WEXTS Team",
-    "license": "MIT",
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/ziadmustafa1/wexts.git"
-    },
-    "homepage": "https://github.com/ziadmustafa1/wexts#readme",
-    "bugs": {
-        "url": "https://github.com/ziadmustafa1/wexts/issues"
-    },
-    "engines": {
-        "node": ">=20.9.0",
-        "pnpm": ">=10.0.0"
-    },
-    "devDependencies": {
-        "@swc/core": "^1.15.32",
-        "@types/http-proxy": "^1.17.15",
-        "@types/node": "^22.19.1",
-        "@types/react": "^19.2.14",
-        "eslint": "^9.17.0",
-        "tsup": "^8.5.1",
-        "vite": "^6.4.2",
-        "vitest": "^4.1.5"
-    },
-    "dependencies": {
-        "@wexts/security": "^0.1.0",
-        "chokidar": "^4.0.3",
-        "commander": "^14.0.3",
-        "consola": "^3.2.3",
-        "fastify": "^5.8.5",
-        "http-proxy": "^1.18.1",
-        "picocolors": "^1.1.1",
-        "reflect-metadata": "^0.2.2",
-        "typescript": "^5.9.3"
-    },
-    "peerDependencies": {
-        "@nestjs/common": "^11.0.0",
-        "@nestjs/core": "^11.0.0",
-        "@nestjs/platform-fastify": "^11.0.0",
-        "next": "^16.2.4",
-        "react": "^19.2.5",
-        "react-dom": "^19.2.5"
-    },
-    "peerDependenciesMeta": {
-        "@nestjs/common": {
-            "optional": true
-        },
-        "@nestjs/core": {
-            "optional": true
-        },
-        "@nestjs/platform-fastify": {
-            "optional": true
-        },
-        "react": {
-            "optional": true
-        },
-        "react-dom": {
-            "optional": true
-        },
-        "next": {
-            "optional": true
-        }
-    },
-    "publishConfig": {
-        "access": "public"
-    }
-}
+{
+    "name": "wexts",
+    "version": "4.1.5",
+    "description": "Production-focused single-runtime Next.js + NestJS toolkit with typed RPC.",
+    "main": "./dist/index.js",
+    "module": "./dist/index.mjs",
+    "types": "./dist/index.d.ts",
+    "bin": {
+        "wexts": "bin/wexts.cjs"
+    },
+    "files": [
+        "dist",
+        "templates",
+        "bin",
+        "README.md",
+        "LICENSE"
+    ],
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.mjs",
+            "require": "./dist/index.js"
+        },
+        "./client": {
+            "types": "./dist/client/index.d.ts",
+            "import": "./dist/client/index.mjs",
+            "require": "./dist/client/index.js"
+        },
+        "./types": {
+            "types": "./dist/types/index.d.ts",
+            "import": "./dist/types/index.mjs",
+            "require": "./dist/types/index.js"
+        },
+        "./nest": {
+            "types": "./dist/nest/index.d.ts",
+            "import": "./dist/nest/index.mjs",
+            "require": "./dist/nest/index.js"
+        },
+        "./next": {
+            "types": "./dist/next/index.d.ts",
+            "import": "./dist/next/index.mjs",
+            "require": "./dist/next/index.js"
+        },
+        "./rpc": {
+            "types": "./dist/rpc/index.d.ts",
+            "import": "./dist/rpc/index.mjs",
+            "require": "./dist/rpc/index.js"
+        },
+        "./runtime": {
+            "types": "./dist/runtime/index.d.ts",
+            "import": "./dist/runtime/index.mjs",
+            "require": "./dist/runtime/index.js"
+        },
+        "./server": {
+            "types": "./dist/server/index.d.ts",
+            "import": "./dist/server/index.mjs",
+            "require": "./dist/server/index.js"
+        }
+    },
+    "scripts": {
+        "build": "tsup",
+        "dev": "tsup --watch",
+        "test": "vitest run",
+        "test:watch": "vitest",
+        "lint": "tsc --noEmit",
+        "typecheck": "tsc --noEmit",
+        "release": "npm run build && npm publish --access public"
+    },
+    "keywords": [
+        "wexts",
+        "framework",
+        "fullstack",
+        "nestjs",
+        "nextjs",
+        "monorepo",
+        "typescript",
+        "react",
+        "unified-runtime",
+        "generated-rpc",
+        "type-safe",
+        "prisma",
+        "jwt-auth",
+        "docker",
+        "next.js",
+        "nest.js"
+    ],
+    "author": "WEXTS Team",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/ziadmustafa1/wexts.git"
+    },
+    "homepage": "https://github.com/ziadmustafa1/wexts#readme",
+    "bugs": {
+        "url": "https://github.com/ziadmustafa1/wexts/issues"
+    },
+    "engines": {
+        "node": ">=20.9.0",
+        "pnpm": ">=10.0.0"
+    },
+    "devDependencies": {
+        "@swc/core": "^1.15.32",
+        "@types/http-proxy": "^1.17.15",
+        "@types/node": "^22.19.1",
+        "@types/react": "^19.2.14",
+        "eslint": "^9.17.0",
+        "tsup": "^8.5.1",
+        "vite": "^6.4.2",
+        "vitest": "^4.1.5"
+    },
+    "dependencies": {
+        "@wexts/security": "^0.1.0",
+        "chokidar": "^4.0.3",
+        "commander": "^14.0.3",
+        "consola": "^3.2.3",
+        "fastify": "^5.8.5",
+        "http-proxy": "^1.18.1",
+        "picocolors": "^1.1.1",
+        "reflect-metadata": "^0.2.2",
+        "typescript": "^5.9.3"
+    },
+    "peerDependencies": {
+        "@nestjs/common": "^11.0.0",
+        "@nestjs/core": "^11.0.0",
+        "@nestjs/platform-fastify": "^11.0.0",
+        "next": "^16.2.4",
+        "react": "^19.2.5",
+        "react-dom": "^19.2.5"
+    },
+    "peerDependenciesMeta": {
+        "@nestjs/common": {
+            "optional": true
+        },
+        "@nestjs/core": {
+            "optional": true
+        },
+        "@nestjs/platform-fastify": {
+            "optional": true
+        },
+        "react": {
+            "optional": true
+        },
+        "react-dom": {
+            "optional": true
+        },
+        "next": {
+            "optional": true
+        }
+    },
+    "publishConfig": {
+        "access": "public"
+    }
+}

package/templates/.dockerignore

@@ -1,43 +1,43 @@
-# Environment files
-.env
-.env.local
-.env.*.local
-
-# Node modules
-node_modules
-dist
-build
-.next
-.turbo
-
-# Database
-*.db
-*.db-journal
-
-# Logs
-*.log
-npm-debug.log*
-
-# OS
-.DS_Store
-Thumbs.db
-
-# IDE
-.vscode
-.idea
-*.swp
-
-# Git
-.git
-.gitignore
-
-# CI/CD
-.github
-
-# Documentation
-*.md
-!README.md
-
-# Config files
-.prettierrc
-.eslintrc*
+# Environment files
+.env
+.env.local
+.env.*.local
+
+# Node modules
+node_modules
+dist
+build
+.next
+.turbo
+
+# Database
+*.db
+*.db-journal
+
+# Logs
+*.log
+npm-debug.log*
+
+# OS
+.DS_Store
+Thumbs.db
+
+# IDE
+.vscode
+.idea
+*.swp
+
+# Git
+.git
+.gitignore
+
+# CI/CD
+.github
+
+# Documentation
+*.md
+!README.md
+
+# Config files
+.prettierrc
+.eslintrc*

package/templates/.env.example

@@ -1,17 +1,17 @@
-# WEXTS Environment Variables
-# Copy this file to .env and update values
-
-# JWT Authentication
-JWT_SECRET=your-super-secret-jwt-key-change-in-production
-JWT_EXPIRES_IN=7d
-
-# Database (Local Development - SQLite)
-DATABASE_URL="file:./apps/api/dev.db"
-
-# Database (Production - PostgreSQL)
-# DATABASE_URL="postgresql://user:password@host:5432/dbname"
-# DIRECT_URL="postgresql://user:password@host:5432/dbname"
-
-# Server
-PORT=3000
-NODE_ENV=development
+# WEXTS Environment Variables
+# Copy this file to .env and update values
+
+# JWT Authentication
+JWT_SECRET=your-super-secret-jwt-key-change-in-production
+JWT_EXPIRES_IN=7d
+
+# Database (Local Development - SQLite)
+DATABASE_URL="file:./apps/api/dev.db"
+
+# Database (Production - PostgreSQL)
+# DATABASE_URL="postgresql://user:password@host:5432/dbname"
+# DIRECT_URL="postgresql://user:password@host:5432/dbname"
+
+# Server
+PORT=3000
+NODE_ENV=development

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