wexts 3.0.0 → 3.0.1

package/README.md

@@ -1,340 +1,346 @@
-# Wexts Framework v2
+<div align="center">
 
-![npm version](https://img.shields.io/npm/v/wexts)
-![license](https://img.shields.io/npm/l/wexts)
-![node version](https://img.shields.io/node/v/wexts)
-
-**Wexts v2** is a modern, production‑ready full‑stack framework that seamlessly integrates **NestJS 11** and **Next.js 16**. Build type‑safe applications with automatic API client generation, shared types, and an exceptional developer experience.
+```
+██╗    ██╗███████╗██╗  ██╗████████╗███████╗
+██║    ██║██╔════╝╚██╗██╔╝╚══██╔══╝██╔════╝
+██║ █╗ ██║█████╗   ╚███╔╝    ██║   ███████╗
+██║███╗██║██╔══╝   ██╔██╗    ██║   ╚════██║
+╚███╔███╔╝███████╗██╔╝ ██╗   ██║   ███████║
+ ╚══╝╚══╝ ╚══════╝╚═╝  ╚═╝   ╚═╝   ╚══════╝
+```
 
-> **Requirements:** Node.js 20.9.0+, PNPM 10.0.0+
+<h1>WEXTS Framework</h1>
 
-## ✨ What's New in v2
+**Build production-ready full-stack apps with Next.js 16 + NestJS 11 in a unified runtime**
 
-- 🎯 **Next.js 16** with Turbopack (stable) and React Compiler
-- 🚀 **NestJS 11** with latest architectural improvements
-- ⚡ **TypeScript 5.9** with enhanced type inference
-- 📦 **Modern Build System** with optimized bundling
-- 🔥 **React 19** full support
+[![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/)
 
-## 🚀 Features
+[Quick Start](#-quick-start) • [Documentation](https://github.com/ziadmustafa1/wexts#documentation) • [Examples](https://github.com/ziadmustafa1/wexts/tree/main/demo)
 
-- **🔗 NestJS + Next.js Integration** – seamless backend‑frontend connection
-- **📦 All‑in‑One SDK** – core utilities, HTTP client, decorators, and hooks in one package
-- **🎯 Type‑Safe** – end‑to‑end TypeScript from database to UI
-- **🛠️ CLI Tools** – scaffold projects, generate code, manage development
-- **⚡ Auto API Client** – generate type‑safe clients from NestJS controllers
-- **🔐 Auth Built‑in** – ready‑to‑use authentication hooks for Next.js
-- **📝 Configuration Management** – environment‑aware config loader
-- **🎨 React Hooks** – `useWexts()`, `useAuth()` for seamless API integration
+</div>
 
 ---
 
-## 📦 Installation
+## ✨ Why WEXTS?
 
-### Global CLI (run without installing globally)
+Stop managing separate Next.js and NestJS servers. **WEXTS runs both in a single Node.js process** with zero configuration.
 
-```bash
-npx wexts
+**Traditional Approach:**
+```
+❌ Two separate servers (Next.js + NestJS)
+❌ Complex proxy setup
+❌ CORS configuration nightmare
+❌ URLs everywhere in your code
+❌ Two deployments to manage
 ```
 
-### Project Dependency
-
-```bash
-npm install wexts
-# or
-yarn add wexts
+**WEXTS:**
+```
+✅ One unified server
+✅ Smart routing (automatic)
+✅ Zero configuration
+✅ Type-safe SDK (no URLs!)
+✅ Single deployment
 ```
 
 ---
 
-## 🏁 Quick Start
+## 🎯 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
+
+---
 
-### Create New Project
+## 🚀 Quick Start
 
 ```bash
-npx wexts create my-app --template monorepo
+# Create new project
+npx wexts create my-app
+
+# Start development
 cd my-app
-pnpm dev
+pnpm install
+pnpm run dev
+
+# Open http://localhost:3000
 ```
 
-This creates:
-- `apps/api/` – NestJS 11 backend
-- `apps/web/` – Next.js 16 frontend
-- `packages/types/` – shared TypeScript definitions
-- `packages/api-client/` – auto‑generated SDK
+**That's it!** Your unified server is running with:
+- ✅ Next.js frontend
+- ✅ NestJS backend API
+- ✅ Smart routing
+- ✅ Hot reload
 
 ---
 
-## 📚 Usage
+## 💡 The Magic - Zero URLs!
 
-### NestJS Backend
+### ❌ Without WEXTS
 
 ```typescript
-import { Controller, Get, Post, Body } from '@nestjs/common';
-import { WextsController, WextsGet, WextsPost } from 'wexts/nest';
-
-@WextsController('users')
-@Controller('users')
-export class UsersController {
-  @WextsGet()
-  async findAll() {
-    return this.usersService.findAll();
-  }
-
-  @WextsPost()
-  async create(@Body() createUserDto: CreateUserDto) {
-    return this.usersService.create(createUserDto);
-  }
-}
+// 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
 ```
 
-**Benefits**: The `WextsController` and `WextsRoute` decorators add metadata for automatic API client generation.
+### ✅ With WEXTS
 
----
-
-### Next.js Frontend
-
-#### Setup Provider
-
-```tsx
-// app/layout.tsx
-import { WextsProvider } from 'wexts/next';
+```typescript
+import { api } from '@/lib/api';
 
-export default function RootLayout({ children }: { children: React.ReactNode }) {
-  return (
-    <html lang="en">
-      <body>
-        <WextsProvider baseUrl={process.env.NEXT_PUBLIC_API_URL || '/api'}>
-          {children}
-        </WextsProvider>
-      </body>
-    </html>
-  );
-}
+// Type-safe, zero URLs, works everywhere!
+const users = await api.users.findAll();
+//    ✅ Auto-complete
+//    ✅ Type-safe
+//    ✅ No configuration
 ```
 
-#### Use in Components
-
-```tsx
-'use client';
-import { useWexts, useAuth } from 'wexts/next';
-import { useEffect, useState } from 'react';
-
-export default function UsersPage() {
-  const { client } = useWexts();
-  const { user, isAuthenticated } = useAuth();
-  const [users, setUsers] = useState([]);
-
-  useEffect(() => {
-    client.get<User[]>('/users').then(setUsers);
-  }, []);
-
-  return (
-    <div>
-      {isAuthenticated && <p>Welcome, {user.name}!</p>}
-      <ul>
-        {users.map(u => (
-          <li key={u.id}>{u.name}</li>
-        ))}
-      </ul>
-    </div>
-  );
-}
-```
+**The SDK automatically connects to your backend. No URLs needed!**
 
 ---
 
-### HTTP Client
+## 📖 Project Structure
 
-```typescript
-import { apiFetcher } from 'wexts/client';
+```
+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
+```
 
-// GET request
-const users = await apiFetcher.get<User[]>('/users');
+---
 
-// POST request
-const newUser = await apiFetcher.post('/users', {
-  name: 'John',
-  email: 'john@example.com',
-});
+## 🏗️ How It Works
 
-// Automatic Bearer token from localStorage
-// Token stored as 'wexts_token'
+```
+┌─────────────────────────────────────────┐
+│      Single Node.js Process            │
+│                                         │
+│  ┌──────────┐        ┌──────────┐     │
+│  │ Next.js  │        │  NestJS  │     │
+│  │ Frontend │        │  Backend │     │
+│  └──────────┘        └──────────┘     │
+│                                         │
+│       Smart Router Middleware          │
+│  ┌─────────────────────────────┐      │
+│  │  /api/* → NestJS            │      │
+│  │  /*     → Next.js           │      │
+│  └─────────────────────────────┘      │
+└─────────────────────────────────────────┘
 ```
 
+**No proxy. No CORS. Just works.** ✨
+
 ---
 
-## ⚙️ Configuration
+## 🔐 Built-in Authentication
 
 ```typescript
-import { config } from 'wexts';
+// Register
+const { user, access_token } = await api.auth.register({
+    email: 'user@example.com',
+    password: 'secure123',
+    name: 'John Doe'
+});
 
-// Load from wexts.config.json or environment variables
-const dbUrl = config.load('database');
-const apiKey = config.load('apiKey', 'default-key');
+// Login
+const { user, access_token } = await api.auth.login({
+    email: 'user@example.com',
+    password: 'secure123'
+});
 
-// Set runtime config
-config.set('feature_flags', { newUI: true });
+// Get current user
+const user = await api.auth.me();
 ```
 
-Create `wexts.config.json` in your project root:
-
-```json
-{
-  "database": "postgresql://localhost/mydb",
-  "apiPort": 5050,
-  "webPort": 3000,
-  "jwt": {
-    "secret": "your-secret-key",
-    "expiresIn": "7d"
-  }
-}
-```
+**Secure JWT authentication with httpOnly cookies included!**
 
-**Environment Variables**: Prefix with `WEXTS_`
+---
+
+## 🐳 Deploy Anywhere
+
+### Docker (Recommended)
 
 ```bash
-WEXTS_DATABASE=postgresql://localhost/mydb
-WEXTS_JWT__SECRET=your-secret-key
+docker-compose up -d
 ```
 
----
+**Includes PostgreSQL!** Your app is live at `http://localhost:3000`
 
-## 🛠 CLI Commands
+### Railway (Easiest)
 
 ```bash
-# Create new project
-wexts create <name> [--template monorepo|api|web]
-
-# Start development servers
-wexts dev [--port <port>]
+# Push to GitHub, connect Railway, done!
+```
 
-# Build for production
-wexts build
+Railway auto-detects WEXTS configuration.
 
-# Generate code
-wexts generate controller <name>
+### Render / VPS
 
-# Shortcut for generate
-wexts g module <name>
+```bash
+pnpm run build
+pnpm start
 ```
 
----
+**One build. One deployment. Works everywhere.**
 
-## 📖 API Reference
+---
 
-### Core Modules
+## 📚 Full Example
 
 ```typescript
-import { Core, Config, Insight, Nest, Next } from 'wexts';
-```
-
-- **Core** – process management, filesystem utilities
-- **Config** – configuration loader
-- **Insight** – logging and metrics
-- **Nest** – NestJS decorators and helpers
-- **Next** – Next.js providers and hooks
-
-### `wexts/client`
+// 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);
+    }
+}
 
-```typescript
-import { WextsFetcher, apiFetcher } from 'wexts/client';
+// 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>
+    );
+}
 ```
 
-- **WextsFetcher** – HTTP client class
-- **apiFetcher** – singleton instance
+**Complete type safety from database to UI!**
 
-### `wexts/nest`
+---
 
-```typescript
-import { WextsController, WextsGet, WextsPost, WextsPut, WextsDelete } from 'wexts/nest';
-```
+## 🛠️ Commands
 
-- NestJS decorators for API codegen (works alongside standard `@nestjs/common` decorators)
+```bash
+# Development
+pnpm run dev          # Start dev server
 
-### `wexts/next`
+# Production
+pnpm run build        # Build everything
+pnpm start            # Start production server
 
-```typescript
-import { WextsProvider, useWexts, useAuth } from 'wexts/next';
+# Database
+cd apps/api
+npx prisma migrate dev
+npx prisma studio
 ```
 
-- **WextsProvider** – React context provider for API client
-- **useWexts()** – access API client in components
-- **useAuth()** – authentication state management
-
-### `wexts/types`
+---
 
-```typescript
-import type { User, ApiResponse, WextsConfig } from 'wexts/types';
-```
+## 📦 What's Included
 
-- Shared TypeScript type definitions
+- **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
 
 ---
 
-## 🏗️ Project Structure
+## 🎯 Perfect For
 
-When you create a project with `wexts create`, you get:
-
-```text
-my-app/
- ├── apps/
- │   ├── api/   # NestJS 11 backend
- │   │   └── src/
- │   └── web/   # Next.js 16 frontend
- │       └── app/
- ├── packages/
- │   ├── types/      # Shared DTOs
- │   └── api-client/  # Auto‑generated SDK
- ├── turbo.json
- ├── package.json
- └── wexts.config.json
-```
+✅ Full-stack applications  
+✅ SaaS products  
+✅ Admin dashboards  
+✅ API + Web combo  
+✅ Production-ready apps  
+✅ Rapid prototyping  
 
 ---
 
-## 🚀 Deployment
-
-### Build
+## 📚 Documentation
 
-```bash
-wexts build
-```
-
-### Deploy API (NestJS)
+- [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)
 
-```bash
-cd apps/api
-npm run build
-npm run start:prod
-```
+---
 
-### Deploy Web (Next.js)
+## 🤝 Contributing
 
-```bash
-cd apps/web
-npm run build
-npm start
-```
+Contributions are welcome! See [CONTRIBUTING.md](https://github.com/ziadmustafa1/wexts/blob/main/CONTRIBUTING.md)
 
 ---
 
 ## 📄 License
 
-MIT © [wexts Team](https://github.com/ziadmustafa1/wexts)
+MIT © WEXTS Team
 
 ---
 
-## 🤝 Contributing
+## 🙏 Built With
 
-Contributions welcome! Please read our contributing guidelines.
+- [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
 
-## 📬 Support
+---
 
-- **GitHub**: [ziadmustafa1/wexts](https://github.com/ziadmustafa1/wexts)
-- **Issues**: [Report bugs](https://github.com/ziadmustafa1/wexts/issues)
-- **Discussions**: [Community forums](https://github.com/ziadmustafa1/wexts/discussions)
+<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
 
-**Built with ❤️ by the wexts Team**
+</div>

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "wexts",
-    "version": "3.0.0",
-    "description": "Modern full-stack framework combining NestJS 11 and Next.js 16",
+    "version": "3.0.1",
+    "description": "Build production-ready full-stack apps with Next.js 16 + NestJS 11 in a unified runtime. Zero URLs. Zero configuration.",
     "main": "./dist/index.js",
     "module": "./dist/index.mjs",
     "types": "./dist/index.d.ts",
@@ -10,7 +10,9 @@
     },
     "files": [
         "dist",
-        "templates"
+        "templates",
+        "README.md",
+        "LICENSE"
     ],
     "exports": {
         ".": {
@@ -56,14 +58,25 @@
         "nextjs",
         "monorepo",
         "typescript",
-        "react"
+        "react",
+        "unified-runtime",
+        "zero-config",
+        "type-safe",
+        "prisma",
+        "jwt-auth",
+        "docker",
+        "next.js",
+        "nest.js"
     ],
-    "author": "wexts Team",
+    "author": "WEXTS Team",
     "license": "MIT",
     "repository": {
         "type": "git",
-        "url": "https://github.com/ziadmustafa1/wexts.git",
-        "directory": "packages/fusionjs"
+        "url": "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",

package/templates/.dockerignore

@@ -0,0 +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*