wexts 3.0.2 → 4.1.0

package/README.md

@@ -1,346 +1,49 @@
-<div align="center">
-
-```
-██╗    ██╗███████╗██╗  ██╗████████╗███████╗
-██║    ██║██╔════╝╚██╗██╔╝╚══██╔══╝██╔════╝
-██║ █╗ ██║█████╗   ╚███╔╝    ██║   ███████╗
-██║███╗██║██╔══╝   ██╔██╗    ██║   ╚════██║
-╚███╔███╔╝███████╗██╔╝ ██╗   ██║   ███████║
- ╚══╝╚══╝ ╚══════╝╚═╝  ╚═╝   ╚═╝   ╚══════╝
-```
-
-<h1>WEXTS Framework</h1>
-
-**Build production-ready full-stack apps with Next.js 16 + NestJS 11 in a unified runtime**
-
-[![npm version](https://img.shields.io/npm/v/wexts.svg)](https://www.npmjs.com/package/wexts)
-[![Downloads](https://img.shields.io/npm/dm/wexts.svg)](https://www.npmjs.com/package/wexts)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue.svg)](https://www.typescriptlang.org/)
-
-[Quick Start](#-quick-start) • [Documentation](https://github.com/ziadmustafa1/wexts#documentation) • [Examples](https://github.com/ziadmustafa1/wexts/tree/main/demo)
-
-</div>
-
----
-
-## ✨ Why WEXTS?
-
-Stop managing separate Next.js and NestJS servers. **WEXTS runs both in a single Node.js process** with zero configuration.
-
-**Traditional Approach:**
-```
-❌ Two separate servers (Next.js + NestJS)
-❌ Complex proxy setup
-❌ CORS configuration nightmare
-❌ URLs everywhere in your code
-❌ Two deployments to manage
-```
-
-**WEXTS:**
-```
-✅ One unified server
-✅ Smart routing (automatic)
-✅ Zero configuration
-✅ Type-safe SDK (no URLs!)
-✅ Single deployment
-```
-
----
-
-## 🎯 Key Features
-
-- 🔥 **Unified Runtime** - Single Node.js process for frontend + backend
-- 🎨 **Zero URLs** - Call APIs without explicit URLs
-- ⚡ **Type-Safe** - End-to-end TypeScript with auto-complete
-- 🚀 **Production Ready** - Docker, Railway, Render, Vercel support
-- 🔒 **Auth Built-in** - JWT authentication out of the box
-- 📦 **Prisma ORM** - Database integration ready
-- 🐳 **Docker Ready** - Complete Docker setup included
-
----
-
-## 🚀 Quick Start
-
-```bash
-# Create new project
-npx wexts create my-app
-
-# Start development
-cd my-app
-pnpm install
-pnpm run dev
-
-# Open http://localhost:3000
-```
-
-**That's it!** Your unified server is running with:
-- ✅ Next.js frontend
-- ✅ NestJS backend API
-- ✅ Smart routing
-- ✅ Hot reload
-
----
-
-## 💡 The Magic - Zero URLs!
-
-### ❌ Without WEXTS
-
-```typescript
-// Hardcoded URLs everywhere
-const response = await fetch('http://localhost:3001/api/users');
-const users = await response.json();
-
-// Problems:
-// - No type safety
-// - CORS issues
-// - Environment management
-// - Proxy configuration
-```
-
-### ✅ With WEXTS
-
-```typescript
-import { api } from '@/lib/api';
-
-// Type-safe, zero URLs, works everywhere!
-const users = await api.users.findAll();
-//    ✅ Auto-complete
-//    ✅ Type-safe
-//    ✅ No configuration
-```
-
-**The SDK automatically connects to your backend. No URLs needed!**
-
----
-
-## 📖 Project Structure
-
-```
-my-app/
-├── 🚀 server.ts              # Unified server
-├── apps/
-│   ├── 🔙 api/                # NestJS Backend
-│   │   ├── src/
-│   │   │   ├── auth/          # JWT Authentication
-│   │   │   └── prisma/        # Database ORM
-│   │   └── prisma/schema.prisma
-│   │
-│   └── 🎨 web/                # Next.js Frontend
-│       ├── app/               # App Router
-│       └── lib/
-│           └── api.ts         # 🔥 Type-safe SDK
-│
-├── 🐳 Dockerfile             # Production build
-└── docker-compose.yml         # Docker + PostgreSQL
-```
-
----
-
-## 🏗️ How It Works
-
-```
-┌─────────────────────────────────────────┐
-│      Single Node.js Process            │
-│                                         │
-│  ┌──────────┐        ┌──────────┐     │
-│  │ Next.js  │        │  NestJS  │     │
-│  │ Frontend │        │  Backend │     │
-│  └──────────┘        └──────────┘     │
-│                                         │
-│       Smart Router Middleware          │
-│  ┌─────────────────────────────┐      │
-│  │  /api/* → NestJS            │      │
-│  │  /*     → Next.js           │      │
-│  └─────────────────────────────┘      │
-└─────────────────────────────────────────┘
-```
-
-**No proxy. No CORS. Just works.** ✨
-
----
-
-## 🔐 Built-in Authentication
-
-```typescript
-// Register
-const { user, access_token } = await api.auth.register({
-    email: 'user@example.com',
-    password: 'secure123',
-    name: 'John Doe'
-});
-
-// Login
-const { user, access_token } = await api.auth.login({
-    email: 'user@example.com',
-    password: 'secure123'
-});
-
-// Get current user
-const user = await api.auth.me();
-```
-
-**Secure JWT authentication with httpOnly cookies included!**
-
----
-
-## 🐳 Deploy Anywhere
-
-### Docker (Recommended)
-
-```bash
-docker-compose up -d
-```
-
-**Includes PostgreSQL!** Your app is live at `http://localhost:3000`
-
-### Railway (Easiest)
-
-```bash
-# Push to GitHub, connect Railway, done!
-```
-
-Railway auto-detects WEXTS configuration.
-
-### Render / VPS
-
-```bash
-pnpm run build
-pnpm start
-```
-
-**One build. One deployment. Works everywhere.**
-
----
-
-## 📚 Full Example
-
-```typescript
-// Backend - apps/api/src/posts/posts.controller.ts
-@Controller('posts')
-@UseGuards(JwtAuthGuard)
-export class PostsController {
-    @Get()
-    findAll() {
-        return this.postsService.findAll();
-    }
-
-    @Post()
-    create(@Body() dto: CreatePostDto) {
-        return this.postsService.create(dto);
-    }
-}
-
-// Frontend - apps/web/lib/api.ts
-export const api = {
-    posts: {
-        findAll: () => request<Post[]>('GET', '/posts'),
-        create: (data) => request<Post>('POST', '/posts', data),
-    },
-};
-
-// Usage - apps/web/app/posts/page.tsx
-import { api } from '@/lib/api';
-
-export default async function PostsPage() {
-    const posts = await api.posts.findAll(); // Type-safe!
-    
-    return (
-        <div>
-            {posts.map(post => (
-                <article key={post.id}>
-                    <h2>{post.title}</h2>
-                    <p>{post.content}</p>
-                </article>
-            ))}
-        </div>
-    );
-}
-```
-
-**Complete type safety from database to UI!**
-
----
-
-## 🛠️ Commands
-
-```bash
-# Development
-pnpm run dev          # Start dev server
-
-# Production
-pnpm run build        # Build everything
-pnpm start            # Start production server
-
-# Database
-cd apps/api
-npx prisma migrate dev
-npx prisma studio
-```
-
----
-
-## 📦 What's Included
-
-- **Next.js 16** - Latest React framework with App Router
-- **NestJS 11** - Modern Node.js framework
-- **Prisma** - Type-safe database ORM
-- **JWT Auth** - Secure authentication
-- **TypeScript** - Full type safety
-- **Tailwind CSS** - Utility-first CSS
-- **Docker** - Production deployment
-- **Examples** - Auth, CRUD, and more
-
----
-
-## 🎯 Perfect For
-
-✅ Full-stack applications  
-✅ SaaS products  
-✅ Admin dashboards  
-✅ API + Web combo  
-✅ Production-ready apps  
-✅ Rapid prototyping  
-
----
-
-## 📚 Documentation
-
-- [Getting Started](https://github.com/ziadmustafa1/wexts/blob/main/docs/getting-started.md)
-- [Architecture](https://github.com/ziadmustafa1/wexts/blob/main/docs/architecture.md)
-- [API Reference](https://github.com/ziadmustafa1/wexts/blob/main/docs/api-reference.md)
-- [Deployment](https://github.com/ziadmustafa1/wexts/blob/main/docs/deployment.md)
-- [Examples](https://github.com/ziadmustafa1/wexts/tree/main/demo)
-
----
-
-## 🤝 Contributing
-
-Contributions are welcome! See [CONTRIBUTING.md](https://github.com/ziadmustafa1/wexts/blob/main/CONTRIBUTING.md)
-
----
-
-## 📄 License
-
-MIT © WEXTS Team
-
----
-
-## 🙏 Built With
-
-- [Next.js](https://nextjs.org/) - React framework
-- [NestJS](https://nestjs.com/) - Node.js framework
-- [Prisma](https://www.prisma.io/) - Database ORM
-- [TypeScript](https://www.typescriptlang.org/) - Type safety
-
----
-
-<div align="center">
-
-**Stop managing separate servers. Start building with WEXTS.** 🚀
-
-[GitHub](https://github.com/ziadmustafa1/wexts) • [npm](https://www.npmjs.com/package/wexts) • [Documentation](https://github.com/ziadmustafa1/wexts#readme)
-
-Made with ❤️ for the TypeScript community
-
-</div>
+# 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

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

package/dist/chunk-2KAQYLVN.js.map

@@ -1 +1 @@
-{"version":3,"sources":["c:\\Users\\ziad\\Desktop\\wexts\\packages\\dist\\chunk-2KAQYLVN.js"],"names":[],"mappings":"AAAA","file":"C:\\Users\\ziad\\Desktop\\wexts\\packages\\dist\\chunk-2KAQYLVN.js"}
+{"version":3,"sources":["/Volumes/Projects/wexts/packages/dist/chunk-2KAQYLVN.js"],"names":[],"mappings":"AAAA","file":"/Volumes/Projects/wexts/packages/dist/chunk-2KAQYLVN.js"}

package/dist/{chunk-O42L6HOX.js → chunk-2LJVUMXW.js}

@@ -1,6 +1,6 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2; var _class3;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2;
 
-var _chunk3OM7CHCAjs = require('./chunk-3OM7CHCA.js');
+var _chunkWCKSKU3Cjs = require('./chunk-WCKSKU3C.js');
 
 
 
@@ -30,7 +30,7 @@ var ProcessRunner = (_class = class {constructor() { _class.prototype.__init.cal
     blue: pc.blue
   }}
   async run(configs) {
-    _chunk3OM7CHCAjs.logger.info("\u{1F680} Starting development servers...\n");
+    _chunkWCKSKU3Cjs.logger.info("\u{1F680} Starting development servers...\n");
     for (const config of configs) {
       this.startProcess(config);
     }
@@ -41,7 +41,7 @@ var ProcessRunner = (_class = class {constructor() { _class.prototype.__init.cal
     const { name, command, args, cwd, color, env } = config;
     const colorFn = this.colors[color];
     const prefix = colorFn(`[${name}]`);
-    _chunk3OM7CHCAjs.logger.info(`${prefix} Starting...`);
+    _chunkWCKSKU3Cjs.logger.info(`${prefix} Starting...`);
     const proc = _child_process.spawn.call(void 0, command, args, {
       cwd,
       stdio: "pipe",
@@ -66,18 +66,18 @@ var ProcessRunner = (_class = class {constructor() { _class.prototype.__init.cal
     })]);
     proc.on("exit", (code) => {
       if (code !== 0 && code !== null) {
-        _chunk3OM7CHCAjs.logger.error(`${prefix} Exited with code ${code}`);
+        _chunkWCKSKU3Cjs.logger.error(`${prefix} Exited with code ${code}`);
       }
       this.processes.delete(name);
     });
     proc.on("error", (error) => {
-      _chunk3OM7CHCAjs.logger.error(`${prefix} Error:`, error.message);
+      _chunkWCKSKU3Cjs.logger.error(`${prefix} Error:`, error.message);
     });
   }
   stopAll() {
-    _chunk3OM7CHCAjs.logger.info("\n\u{1F6D1} Stopping all processes...");
+    _chunkWCKSKU3Cjs.logger.info("\n\u{1F6D1} Stopping all processes...");
     for (const [name, proc] of this.processes.entries()) {
-      _chunk3OM7CHCAjs.logger.info(`Stopping ${name}...`);
+      _chunkWCKSKU3Cjs.logger.info(`Stopping ${name}...`);
       proc.kill("SIGTERM");
     }
     setTimeout(() => {
@@ -89,6 +89,71 @@ var ProcessRunner = (_class = class {constructor() { _class.prototype.__init.cal
   }
 }, _class);
 
+// src/dev-server/dev-server.ts
+var _path = require('path'); var path = _interopRequireWildcard(_path);
+var _fs = require('fs'); var fs = _interopRequireWildcard(_fs);
+var FusionDevServer = class {
+  static {
+    _chunkXE4OXN2Wjs.__name.call(void 0, this, "FusionDevServer");
+  }
+  
+  constructor() {
+    this.processRunner = new ProcessRunner();
+  }
+  async start(config) {
+    const { apiPath, webPath, webPort = 3e3, apiPort = 5050, useProxy = false } = config;
+    if (useProxy) {
+      throw new Error("The legacy dev proxy is disabled because it conflicts with the Next.js port. Use the production runtime for single-port serving.");
+    }
+    if (!fs.existsSync(apiPath)) {
+      throw new Error(`API path not found: ${apiPath}`);
+    }
+    if (!fs.existsSync(webPath)) {
+      throw new Error(`Web path not found: ${webPath}`);
+    }
+    const processes = [];
+    processes.push({
+      name: "API",
+      command: "npm",
+      args: [
+        "run",
+        "start:dev"
+      ],
+      cwd: path.resolve(apiPath),
+      color: "cyan",
+      env: {
+        PORT: apiPort.toString()
+      }
+    });
+    processes.push({
+      name: "Web",
+      command: "npm",
+      args: [
+        "run",
+        "dev",
+        "--",
+        "-p",
+        webPort.toString()
+      ],
+      cwd: path.resolve(webPath),
+      color: "green",
+      env: {
+        NEXT_PUBLIC_API_URL: `http://localhost:${apiPort}`
+      }
+    });
+    await this.processRunner.run(processes);
+    _chunkWCKSKU3Cjs.logger.info("\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557");
+    _chunkWCKSKU3Cjs.logger.info("\u2551   Fusion Development Server Ready    \u2551");
+    _chunkWCKSKU3Cjs.logger.info("\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D\n");
+    _chunkWCKSKU3Cjs.logger.info(`\u{1F310} Web:  http://localhost:${webPort}`);
+    _chunkWCKSKU3Cjs.logger.info(`\u{1F50C} API:  http://localhost:${apiPort}`);
+    _chunkWCKSKU3Cjs.logger.info("\n");
+  }
+  stop() {
+    this.processRunner.stopAll();
+  }
+};
+
 // src/dev-server/proxy.ts
 var _http = require('http'); var _http2 = _interopRequireDefault(_http);
 var _httpproxy = require('http-proxy'); var _httpproxy2 = _interopRequireDefault(_httpproxy);
@@ -107,7 +172,7 @@ var ProxyServer = (_class2 = class {constructor() { _class2.prototype.__init3.ca
       ws: true
     });
     this.proxy.on("error", (err, req, res) => {
-      _chunk3OM7CHCAjs.logger.error("Proxy error:", err.message);
+      _chunkWCKSKU3Cjs.logger.error("Proxy error:", err.message);
       if (res && "headersSent" in res && !res.headersSent) {
         res.writeHead(502, {
           "Content-Type": "text/plain"
@@ -119,7 +184,7 @@ var ProxyServer = (_class2 = class {constructor() { _class2.prototype.__init3.ca
       if (_optionalChain([req, 'access', _7 => _7.url, 'optionalAccess', _8 => _8.startsWith, 'call', _9 => _9(apiPrefix)])) {
         const newUrl = req.url.substring(apiPrefix.length) || "/";
         req.url = newUrl;
-        _chunk3OM7CHCAjs.logger.info(pc2.gray(`\u2192 ${req.method} ${apiPrefix}${newUrl}`));
+        _chunkWCKSKU3Cjs.logger.info(pc2.gray(`\u2192 ${req.method} ${apiPrefix}${newUrl}`));
         this.proxy.web(req, res);
       } else {
         res.writeHead(404);
@@ -135,8 +200,8 @@ var ProxyServer = (_class2 = class {constructor() { _class2.prototype.__init3.ca
     });
     return new Promise((resolve2) => {
       this.server.listen(port, () => {
-        _chunk3OM7CHCAjs.logger.success(`\u2705 Proxy server running on port ${port}`);
-        _chunk3OM7CHCAjs.logger.info(`   Forwarding ${pc2.cyan(apiPrefix + "/*")} \u2192 ${pc2.cyan(apiTarget)}
+        _chunkWCKSKU3Cjs.logger.success(`\u2705 Proxy server running on port ${port}`);
+        _chunkWCKSKU3Cjs.logger.info(`   Forwarding ${pc2.cyan(apiPrefix + "/*")} \u2192 ${pc2.cyan(apiTarget)}
 `);
         resolve2();
       });
@@ -154,89 +219,10 @@ var ProxyServer = (_class2 = class {constructor() { _class2.prototype.__init3.ca
   }
 }, _class2);
 
-// src/dev-server/dev-server.ts
-var _path = require('path'); var path = _interopRequireWildcard(_path);
-var _fs = require('fs'); var fs = _interopRequireWildcard(_fs);
-var FusionDevServer = (_class3 = class {
-  static {
-    _chunkXE4OXN2Wjs.__name.call(void 0, this, "FusionDevServer");
-  }
-  
-  __init5() {this.proxyServer = null}
-  constructor() {;_class3.prototype.__init5.call(this);
-    this.processRunner = new ProcessRunner();
-  }
-  async start(config) {
-    const { apiPath, webPath, webPort = 3e3, apiPort = 5050, useProxy = true } = config;
-    if (!fs.existsSync(apiPath)) {
-      throw new Error(`API path not found: ${apiPath}`);
-    }
-    if (!fs.existsSync(webPath)) {
-      throw new Error(`Web path not found: ${webPath}`);
-    }
-    const processes = [];
-    processes.push({
-      name: "API",
-      command: "npm",
-      args: [
-        "run",
-        "start:dev"
-      ],
-      cwd: path.resolve(apiPath),
-      color: "cyan",
-      env: {
-        PORT: apiPort.toString()
-      }
-    });
-    processes.push({
-      name: "Web",
-      command: "npm",
-      args: [
-        "run",
-        "dev",
-        "--",
-        "-p",
-        webPort.toString()
-      ],
-      cwd: path.resolve(webPath),
-      color: "green",
-      env: {
-        NEXT_PUBLIC_API_URL: useProxy ? `http://localhost:${webPort}/api` : `http://localhost:${apiPort}`
-      }
-    });
-    if (useProxy) {
-      this.proxyServer = new ProxyServer();
-      setTimeout(async () => {
-        await this.proxyServer.start({
-          port: webPort,
-          apiTarget: `http://localhost:${apiPort}`,
-          apiPrefix: "/api"
-        });
-      }, 3e3);
-    }
-    await this.processRunner.run(processes);
-    _chunk3OM7CHCAjs.logger.info("\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557");
-    _chunk3OM7CHCAjs.logger.info("\u2551   Fusion Development Server Ready    \u2551");
-    _chunk3OM7CHCAjs.logger.info("\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D\n");
-    _chunk3OM7CHCAjs.logger.info(`\u{1F310} Web:  http://localhost:${webPort}`);
-    _chunk3OM7CHCAjs.logger.info(`\u{1F50C} API:  http://localhost:${apiPort}`);
-    if (useProxy) {
-      _chunk3OM7CHCAjs.logger.info(`\u{1F504} Proxy: Enabled (${webPort}/api \u2192 ${apiPort})`);
-    }
-    _chunk3OM7CHCAjs.logger.info("\n");
-  }
-  stop() {
-    this.processRunner.stopAll();
-    if (this.proxyServer) {
-      this.proxyServer.stop();
-    }
-  }
-}, _class3);
-
 
 
 
 
 
-exports.ProcessRunner = ProcessRunner; exports.ProxyServer = ProxyServer; exports.FusionDevServer = FusionDevServer; exports.dev_server_exports = dev_server_exports;
-//# sourceMappingURL=chunk-O42L6HOX.js.map
+exports.ProcessRunner = ProcessRunner; exports.FusionDevServer = FusionDevServer; exports.ProxyServer = ProxyServer; exports.dev_server_exports = dev_server_exports;
+//# sourceMappingURL=chunk-2LJVUMXW.js.map

package/dist/chunk-2LJVUMXW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Volumes/Projects/wexts/packages/dist/chunk-2LJVUMXW.js","../src/dev-server/index.ts","../src/dev-server/process-runner.ts","../src/dev-server/dev-server.ts","../src/dev-server/proxy.ts"],"names":["ProcessRunner","processes","Map","colors","cyan","green","yellow","magenta","blue","run","configs","logger","info","config","startProcess","process","on","stopAll","name","command","args","cwd","color","env","colorFn","prefix","spawn","lines","forEach","log","error","code","exit","path","fs","FusionDevServer","processRunner","apiPath","useProxy","Error","existsSync","push","resolve","apiPort","toString","NEXT_PUBLIC_API_URL","httpProxy","pc","ProxyServer","port","apiTarget","changeOrigin","writeHead","server","url","newUrl","proxy","Promise","success","close"],"mappings":"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","file":"/Volumes/Projects/wexts/packages/dist/chunk-2LJVUMXW.js","sourcesContent":[null,"export * from './dev-server';\nexport * from './process-runner';\nexport * from './proxy';\n","import { spawn, ChildProcess } from 'child_process';\nimport { logger } from '../core/logger';\nimport * as pc from 'picocolors';\n\nexport interface ProcessConfig {\n    name: string;\n    command: string;\n    args: string[];\n    cwd: string;\n    color: 'cyan' | 'green' | 'yellow' | 'magenta' | 'blue';\n    env?: Record<string, string>;\n}\n\n/**\n * Run multiple processes concurrently with colored output\n */\nexport class ProcessRunner {\n    private processes: Map<string, ChildProcess> = new Map();\n    private colors = {\n        cyan: pc.cyan,\n        green: pc.green,\n        yellow: pc.yellow,\n        magenta: pc.magenta,\n        blue: pc.blue,\n    };\n\n    async run(configs: ProcessConfig[]): Promise<void> {\n        logger.info('🚀 Starting development servers...\\n');\n\n        for (const config of configs) {\n            this.startProcess(config);\n        }\n\n        // Handle graceful shutdown\n        process.on('SIGINT', () => this.stopAll());\n        process.on('SIGTERM', () => this.stopAll());\n    }\n\n    private startProcess(config: ProcessConfig): void {\n        const { name, command, args, cwd, color, env } = config;\n\n        const colorFn = this.colors[color];\n        const prefix = colorFn(`[${name}]`);\n\n        logger.info(`${prefix} Starting...`);\n\n        const proc = spawn(command, args, {\n            cwd,\n            stdio: 'pipe',\n            shell: true,\n            env: { ...process.env, ...env },\n        });\n\n        this.processes.set(name, proc);\n\n        // Handle stdout\n        proc.stdout?.on('data', (data) => {\n            const lines = data.toString().split('\\n').filter((l: string) => l.trim());\n            lines.forEach((line: string) => {\n                console.log(`${prefix} ${line}`);\n            });\n        });\n\n        // Handle stderr\n        proc.stderr?.on('data', (data) => {\n            const lines = data.toString().split('\\n').filter((l: string) => l.trim());\n            lines.forEach((line: string) => {\n                console.error(`${prefix} ${pc.red(line)}`);\n            });\n        });\n\n        // Handle exit\n        proc.on('exit', (code) => {\n            if (code !== 0 && code !== null) {\n                logger.error(`${prefix} Exited with code ${code}`);\n            }\n            this.processes.delete(name);\n        });\n\n        // Handle errors\n        proc.on('error', (error) => {\n            logger.error(`${prefix} Error:`, error.message);\n        });\n    }\n\n    stopAll(): void {\n        logger.info('\\n🛑 Stopping all processes...');\n\n        for (const [name, proc] of this.processes.entries()) {\n            logger.info(`Stopping ${name}...`);\n            proc.kill('SIGTERM');\n        }\n\n        setTimeout(() => {\n            process.exit(0);\n        }, 1000);\n    }\n\n    isRunning(name: string): boolean {\n        return this.processes.has(name);\n    }\n}\n","import { ProcessRunner, ProcessConfig } from './process-runner';\nimport { logger } from '../core/logger';\nimport * as path from 'path';\nimport * as fs from 'fs';\n\nexport interface DevServerConfig {\n    apiPath: string;\n    webPath: string;\n    webPort?: number;\n    apiPort?: number;\n    useProxy?: boolean;\n}\n\n/**\n * Unified development server for Fusion projects\n */\nexport class FusionDevServer {\n    private processRunner: ProcessRunner;\n\n    constructor() {\n        this.processRunner = new ProcessRunner();\n    }\n\n    async start(config: DevServerConfig): Promise<void> {\n        const {\n            apiPath,\n            webPath,\n            webPort = 3000,\n            apiPort = 5050,\n            useProxy = false,\n        } = config;\n\n        if (useProxy) {\n            throw new Error('The legacy dev proxy is disabled because it conflicts with the Next.js port. Use the production runtime for single-port serving.');\n        }\n\n        // Validate paths\n        if (!fs.existsSync(apiPath)) {\n            throw new Error(`API path not found: ${apiPath}`);\n        }\n        if (!fs.existsSync(webPath)) {\n            throw new Error(`Web path not found: ${webPath}`);\n        }\n\n        const processes: ProcessConfig[] = [];\n\n        // Add API server\n        processes.push({\n            name: 'API',\n            command: 'npm',\n            args: ['run', 'start:dev'],\n            cwd: path.resolve(apiPath),\n            color: 'cyan',\n            env: {\n                PORT: apiPort.toString(),\n            },\n        });\n\n        // Add Web server\n        processes.push({\n            name: 'Web',\n            command: 'npm',\n            args: ['run', 'dev', '--', '-p', webPort.toString()],\n            cwd: path.resolve(webPath),\n            color: 'green',\n            env: {\n                NEXT_PUBLIC_API_URL: `http://localhost:${apiPort}`,\n            },\n        });\n\n        // Start processes\n        await this.processRunner.run(processes);\n\n        // Log info\n        logger.info('╔═══════════════════════════════════════╗');\n        logger.info('║   Fusion Development Server Ready    ║');\n        logger.info('╚═══════════════════════════════════════╝\\n');\n        logger.info(`🌐 Web:  http://localhost:${webPort}`);\n        logger.info(`🔌 API:  http://localhost:${apiPort}`);\n        logger.info('\\n');\n    }\n\n    stop(): void {\n        this.processRunner.stopAll();\n    }\n}\n","import http from 'http';\nimport httpProxy from 'http-proxy';\nimport { logger } from '../core/logger';\nimport * as pc from 'picocolors';\n\nexport interface ProxyConfig {\n    port: number;\n    apiTarget: string;\n    apiPrefix: string;\n}\n\n/**\n * Proxy server to forward API requests from Next.js to NestJS\n */\nexport class ProxyServer {\n    private server: http.Server | null = null;\n    private proxy: httpProxy | null = null;\n\n    async start(config: ProxyConfig): Promise<void> {\n        const { port, apiTarget, apiPrefix } = config;\n\n        this.proxy = httpProxy.createProxyServer({\n            target: apiTarget,\n            changeOrigin: true,\n            ws: true, // WebSocket support\n        });\n\n        // Handle proxy errors\n        this.proxy.on('error', (err, req, res) => {\n            logger.error('Proxy error:', err.message);\n            if (res && 'headersSent' in res && !(res as any).headersSent) {\n                (res as http.ServerResponse).writeHead(502, { 'Content-Type': 'text/plain' });\n                (res as http.ServerResponse).end('Bad Gateway - API server unavailable');\n            }\n        });\n\n        this.server = http.createServer((req, res) => {\n            // Check if request is for API\n            if (req.url?.startsWith(apiPrefix)) {\n                // Remove prefix before forwarding\n                const newUrl = req.url.substring(apiPrefix.length) || '/';\n                req.url = newUrl;\n\n                logger.info(pc.gray(`→ ${req.method} ${apiPrefix}${newUrl}`));\n                this.proxy!.web(req, res);\n            } else {\n                // Not an API request - should not happen\n                res.writeHead(404);\n                res.end('Not Found');\n            }\n        });\n\n        // Handle WebSocket upgrade\n        this.server.on('upgrade', (req, socket, head) => {\n            if (req.url?.startsWith(apiPrefix)) {\n                const newUrl = req.url.substring(apiPrefix.length) || '/';\n                req.url = newUrl;\n                this.proxy!.ws(req, socket, head);\n            }\n        });\n\n        return new Promise((resolve) => {\n            this.server!.listen(port, () => {\n                logger.success(`✅ Proxy server running on port ${port}`);\n                logger.info(`   Forwarding ${pc.cyan(apiPrefix + '/*')} → ${pc.cyan(apiTarget)}\\n`);\n                resolve();\n            });\n        });\n    }\n\n    stop(): void {\n        if (this.server) {\n            this.server.close();\n            this.server = null;\n        }\n        if (this.proxy) {\n            this.proxy.close();\n            this.proxy = null;\n        }\n    }\n}\n"]}