vasuzex 2.0.5 → 2.0.7

package/README.md

@@ -9,6 +9,9 @@
 
 ---
 
+## STRICT ❌ - NOT FOR PROD USE
+
+
 ## 🆕 What's New in V2?
 
 ### **Hybrid Dependency Management**
@@ -49,63 +52,164 @@ That's it! The installer will:
 
 ## 🚀 Quick Start
 
-### 1. Create New Project
+### Option 1: Full Stack App (Recommended)
+
+Create a complete full stack application with API backend + Web frontend:
+
 ```bash
+# Create project
 npx create-vasuzex my-app
-cd my-app
-```
 
-### 2. Generate Your First App
-```bash
-# Full-stack app (API + Web)
-pnpm exec vasuzex generate:app blog
+# Choose "Full Stack (API + Web)" template
+# Select web framework (React/Vue/Svelte)
+# Configure database (PostgreSQL/MySQL/SQLite)
 
-# API only
-pnpm exec vasuzex generate:app shop --type api
+cd my-app
 
-# Web only  
-pnpm exec vasuzex generate:app admin --type web
-```
+# All config files are automatically copied to ./config/
+# All dependencies installed in root node_modules/
 
-### 3. Run Database Migrations
-```bash
+# Run migrations
 pnpm db:migrate
+
+# Terminal 1 - Start API server
+cd apps/blog/api
+pnpm dev
+
+# Terminal 2 - Start web app
+cd apps/blog/web
+pnpm dev
 ```
 
-### 4. Start Development
+- ✅ API Server: http://localhost:3000
+- ✅ Web App: http://localhost:3001
+- ✅ All configs in `./config/` directory
+
+### Option 2: Manual App Generation
+
 ```bash
-# Start all apps
-pnpm dev
+# 1. Create minimal project
+npx create-vasuzex my-app
+cd my-app
 
-# Or start specific app
-pnpm dev:blog-api    # API at http://localhost:3000
-pnpm dev:blog-web    # Web at http://localhost:5173
+# 2. Generate apps manually
+pnpm exec vasuzex generate:app blog --type fullstack
+# or
+pnpm exec vasuzex generate:app shop --type api
+pnpm exec vasuzex generate:app admin --type web
 ```
 
-### 5. Generated Project Structure
+### Project Structure After Installation
+
 ```
 my-app/
+├── config/                   # ⭐ ALL framework configs copied here
+│   ├── app.cjs              # Application settings
+│   ├── auth.cjs             # JWT authentication
+│   ├── database.cjs         # Database connections
+│   ├── filesystems.cjs      # File storage (S3, Local)
+│   ├── mail.cjs             # Email settings
+│   ├── cache.cjs            # Cache drivers
+│   ├── queue.cjs            # Queue jobs
+│   ├── session.cjs          # Sessions
+│   ├── http.cjs             # HTTP server
+│   ├── upload.cjs           # File uploads
+│   ├── media.cjs            # Media processing
+│   ├── image.cjs            # Image manipulation
+│   ├── sms.cjs              # SMS services
+│   ├── payment.cjs          # Payment gateways
+│   ├── translation.cjs      # Multi-language
+│   └── ... (20+ config files)
+│
 ├── apps/
-│   ├── blog/
-│   │   ├── api/             # Express API
-│   │   │   ├── src/
-│   │   │   ├── routes/
-│   │   │   └── package.json # Scripts only, NO dependencies
-│   │   └── web/             # React/Vue/Svelte app
-│   │       ├── src/
-│   │       └── package.json # Scripts only, NO dependencies
-├── config/                  # Framework config
+│   └── blog/
+│       ├── api/             # Backend Express server
+│       │   ├── src/
+│       │   │   ├── controllers/    # HTTP controllers
+│       │   │   ├── services/       # Business logic
+│       │   │   ├── middleware/     # Auth, validation
+│       │   │   ├── routes/         # API routes
+│       │   │   └── models/         # Database models
+│       │   ├── index.js            # Server entry point
+│       │   └── package.json        # Scripts only (no deps)
+│       │
+│       └── web/             # Frontend React/Vue/Svelte
+│           ├── src/
+│           │   ├── components/
+│           │   ├── pages/
+│           │   └── services/       # API client
+│           ├── index.html
+│           ├── vite.config.js
+│           └── package.json        # Scripts only (no deps)
+│
 ├── database/
-│   ├── models/              # GuruORM models
+│   ├── models/              # Shared GuruORM models
 │   ├── migrations/          # Database migrations
 │   └── seeders/             # Database seeders
-├── node_modules/            # Single hoisted node_modules
-├── package.json             # ALL dependencies here
-├── .npmrc                   # Hoisting config
-└── pnpm-workspace.yaml      # Workspace definition
+│
+├── node_modules/            # ⭐ Single hoisted node_modules (all deps)
+├── package.json             # ⭐ ALL dependencies defined here
+├── .env                     # Root environment config
+├── pnpm-workspace.yaml      # Workspace definition
+└── turbo.json               # Build pipeline config
+```
+
+**Key Features:**
+- ✅ **All configs in `./config/`** - Easily customize any framework feature
+- ✅ **Single `node_modules/`** - 64% disk space savings
+- ✅ **Centralized dependencies** - Manage versions in one place
+- ✅ **Zero config for apps** - Apps inherit all dependencies
+
+---
+
+## 🎯 Full Stack Development
+
+Vasuzex V2 makes full stack development seamless:
+
+### Backend API (Express)
+```javascript
+// apps/blog/api/index.js
+import { BaseApp } from 'vasuzex';
+
+class BlogServer extends BaseApp {
+  async setupRoutes() {
+    this.app.use('/api', getAllRoutes());
+  }
+}
+
+const server = new BlogServer();
+await server.start();
+```
+
+### Frontend Web (React/Vue/Svelte)
+```javascript
+// apps/blog/web/src/services/api.js
+import { createApiClient } from '@vasuzex/client';
+
+export const api = createApiClient({
+  baseURL: 'http://localhost:3000/api'
+});
+
+// Usage
+const posts = await api.get('/posts');
+const newPost = await api.post('/posts', { title: 'Hello' });
+```
+
+### Authentication Flow
+```javascript
+// Backend: Auto-generated AuthController
+POST /api/auth/register  // Register new user
+POST /api/auth/login     // Login (returns JWT)
+GET  /api/auth/me        // Get authenticated user
+POST /api/auth/logout    // Logout
+
+// Frontend: Auto-configured API client
+const { data } = await api.post('/auth/login', credentials);
+localStorage.setItem('token', data.token);
+api.defaults.headers.common['Authorization'] = `Bearer ${data.token}`;
 ```
 
-**Key Point:** App `package.json` files contain ONLY scripts. All dependencies in root!
+📖 **[Full Stack Guide →](./docs/getting-started/fullstack-guide.md)**
 
 ---
 
@@ -475,10 +579,22 @@ pnpm start
 
 ## 📚 Documentation
 
-- [Migration Results](./MIGRATION_RESULTS.md) - V2 migration details
-- [Dependency Strategy](./docs/DEPENDENCY_MANAGEMENT_STRATEGY.md) - Why hybrid approach?
-- [Import Aliases](./docs/IMPORT_ALIASES.md) - How to import modules
-- [Getting Started](./docs/getting-started/installation.md) - Detailed setup guide
+### Getting Started
+- 🚀 [**Full Stack Setup**](./docs/FULL_STACK_SETUP.md) - Quick reference for fullstack apps
+- 📖 [Full Stack Guide](./docs/getting-started/fullstack-guide.md) - Complete fullstack tutorial
+- 📦 [Installation](./docs/getting-started/installation.md) - Detailed setup guide
+- 🏗️ [Project Structure](./docs/getting-started/project-structure.md) - Understanding the structure
+
+### Advanced
+- 🔄 [Migration Results](./MIGRATION_RESULTS.md) - V2 migration details
+- 📦 [Dependency Strategy](./docs/DEPENDENCY_MANAGEMENT_STRATEGY.md) - Why hybrid approach?
+- 🔗 [Import Aliases](./docs/IMPORT_ALIASES.md) - How to import modules
+- 🗄️ [Database Guide](./docs/database/getting-started.md) - Database & migrations
+
+### Configuration
+All 26 config files are in `./config/` directory:
+- `auth.cjs`, `database.cjs`, `mail.cjs`, `sms.cjs`, `payment.cjs`, etc.
+- See [Full Stack Setup](./docs/FULL_STACK_SETUP.md) for complete list
 
 ---
 

package/TODO.md

@@ -0,0 +1,248 @@
+# VASUZEX v2 - TODO LIST
+> Comprehensive checklist of remaining tasks after recent generator fixes
+
+**Last Updated:** Dec 7, 2024  
+**Priority:** 🔴 Critical | 🟡 Important | 🟢 Nice to Have
+
+---
+
+## ✅ COMPLETED
+
+### Generator Fixes
+- ✅ Fixed @vasuzex/client imports in templates (was using wrong `vasuzex/client`)
+- ✅ Fixed API response handling (`response.data.data` for actual payload)
+- ✅ Fixed apiClient initialization (using `createApiClient` with proper config)
+- ✅ Fixed logout to manually clear localStorage (no `.clearAuthToken()` method exists)
+- ✅ Fixed import paths in generated code (relative paths, no `#models` aliases)
+- ✅ Added explicit dependencies to generated apps (no hoisting reliance)
+- ✅ Cleaned up unnecessary README files (removed scattered docs)
+- ✅ Verified @vasuzex/client package imports work correctly
+
+### Documentation Cleanup
+- ✅ Deleted unnecessary READMEs from config/, tests/, examples/
+- ✅ Deleted duplicate READMEs from framework/Services/*
+- ✅ Centralized all docs in /docs/ directory
+- ✅ Organized docs structure (getting-started, services, cli, core, frontend)
+
+---
+
+## 🔴 CRITICAL PRIORITY
+
+### 1. **E2E Generator Testing**
+- [ ] Generate fresh fullstack app from scratch
+- [ ] Verify all files created correctly (controllers, models, routes, pages)
+- [ ] Test dependencies install without errors
+- [ ] Run generated API app and verify auth endpoints work
+- [ ] Run generated Web app and verify React auth flow works
+- [ ] Test login/register/logout flow end-to-end
+- [ ] Verify JWT token persistence in localStorage
+- [ ] Check protected routes work correctly
+
+**Files to check:**
+- `framework/Console/Commands/generate-app.js`
+- `framework/Console/Commands/utils/apiStructure.js`
+- `framework/Console/Commands/utils/webStructure.js`
+
+### 2. **Vue & Svelte Template Verification**
+- [ ] Check if Vue templates have same issues as React templates had
+- [ ] Check if Svelte templates have same issues
+- [ ] Verify Vue auth flow if it exists (or add TODO to implement)
+- [ ] Verify Svelte auth flow if it exists (or add TODO to implement)
+
+**Current Status:**
+- Vue templates exist but NOT VERIFIED for @vasuzex/client usage
+- Svelte templates exist but NOT VERIFIED for @vasuzex/client usage
+- Only React templates were fixed and verified
+
+**Files to check:**
+- Lines 1076-1130 in `framework/Console/Commands/utils/templateGenerator.js` (Vue)
+- Lines 1130+ in `framework/Console/Commands/utils/templateGenerator.js` (Svelte)
+
+### 3. **Package Publishing Preparation**
+- [ ] Verify package.json exports are correct for npm publish
+- [ ] Test installation from npm (or local tarball simulation)
+- [ ] Verify CLI bin commands work after npm install
+- [ ] Check if all peer dependencies are listed
+- [ ] Verify @vasuzex/client is properly built before publishing
+- [ ] Test workspace linking vs npm install scenarios
+
+**Files to check:**
+- `package.json` (root - main vasuzex package)
+- `frontend/client/package.json` (@vasuzex/client package)
+
+---
+
+## 🟡 IMPORTANT
+
+### 4. **API Template Verification**
+- [ ] Check all generated controllers use correct BaseController pattern
+- [ ] Verify all middleware imports use relative paths (no aliases)
+- [ ] Check AuthService uses correct model imports
+- [ ] Verify database migrations are generated correctly
+- [ ] Test seeder files work with GuruORM
+- [ ] Check .env template has all required variables
+
+**Files to check:**
+- `framework/Console/Commands/utils/apiTemplates.js` (all template functions)
+
+### 5. **Config & Database Centralization**
+- [ ] Verify generated apps use /config from root (not app-level config)
+- [ ] Verify generated apps use /database from root (models, migrations)
+- [ ] Check if app.js template uses correct config imports
+- [ ] Test that multiple apps can share same database
+- [ ] Verify migrations run from root, not app directory
+
+**Current Design:**
+- Config: Centralized in `/config/` (project root)
+- Database: Centralized in `/database/` (project root)
+- Apps should NOT have their own config/ or database/
+
+### 6. **Monorepo Scripts & Turbo**
+- [ ] Verify turbo.json is configured correctly
+- [ ] Check if dev:app-name scripts are generated in root package.json
+- [ ] Test parallel running of multiple apps
+- [ ] Verify build scripts work for all app types
+- [ ] Check if turbo cache works correctly
+
+**Files to check:**
+- `turbo.json`
+- `package.json` (scripts section)
+- `framework/Console/Commands/utils/packageManager.js` (addRootScripts)
+
+---
+
+## 🟢 NICE TO HAVE
+
+### 7. **Frontend Client Package**
+- [ ] Add comprehensive JSDoc documentation to all exports
+- [ ] Add usage examples for each utility
+- [ ] Test tree-shaking works correctly
+- [ ] Verify TypeScript types are exported properly
+- [ ] Add more validators (PAN, GST, Vehicle Number, etc.)
+- [ ] Add Indian-specific formatters (lakhs/crores)
+
+**Files to check:**
+- `frontend/client/` (entire package)
+- `frontend/client/README.md` (examples & docs)
+
+### 8. **Error Handling Improvements**
+- [ ] Add better error messages in generators
+- [ ] Validate app names (no spaces, special chars)
+- [ ] Check for port conflicts
+- [ ] Add rollback on failed generation
+- [ ] Better error display (colored, formatted)
+
+### 9. **Testing Infrastructure**
+- [ ] Add tests for generator commands
+- [ ] Test template generation functions
+- [ ] Add integration tests for generated apps
+- [ ] Test @vasuzex/client utilities
+- [ ] Add E2E tests for auth flow
+
+**Existing:**
+- Unit tests in `/tests/unit/`
+- E2E placeholder in `/tests/e2e/`
+- Need to add generator-specific tests
+
+### 10. **Documentation Updates**
+- [ ] Update /docs/cli/commands.md with latest generate:app syntax
+- [ ] Add @vasuzex/client usage guide to /docs/frontend/
+- [ ] Document monorepo structure in /docs/getting-started/
+- [ ] Add troubleshooting guide for common errors
+- [ ] Create video walkthrough for generator
+
+---
+
+## 🔍 VERIFICATION CHECKLIST
+
+### Before Publishing v2.0.0:
+
+**Package Integrity:**
+- [ ] `vasuzex` package builds successfully
+- [ ] `@vasuzex/client` package builds successfully
+- [ ] No console.log() in production code
+- [ ] No TODO comments in critical code
+- [ ] All imports resolve correctly
+
+**Generator Quality:**
+- [ ] Generated API apps run without errors
+- [ ] Generated Web apps run without errors
+- [ ] Auth flow works end-to-end
+- [ ] Database migrations work
+- [ ] Models work with GuruORM
+
+**External User Experience:**
+- [ ] `npm create vasuzex@latest myapp` works
+- [ ] Generated apps work WITHOUT monorepo context
+- [ ] Dependencies install correctly
+- [ ] No missing peer dependencies errors
+- [ ] CLI commands accessible via `npx vasuzex`
+
+**Code Quality:**
+- [ ] No import aliases in generated code
+- [ ] No hardcoded paths
+- [ ] Proper error handling everywhere
+- [ ] Consistent code style
+- [ ] No security vulnerabilities
+
+---
+
+## 🎯 IMMEDIATE NEXT STEPS
+
+1. **Generate test app:**
+   ```bash
+   cd /Users/rishi/Desktop/work/vasuzex-v2
+   npx vasuzex generate:app testapp --type api --auth
+   npx vasuzex generate:app testapp --type web --framework react
+   ```
+
+2. **Test generated apps:**
+   ```bash
+   cd apps/testapp/api
+   pnpm install
+   pnpm dev
+   # Test auth endpoints with curl/Postman
+   
+   cd ../web
+   pnpm install
+   pnpm dev
+   # Test login/register/logout flow
+   ```
+
+3. **Check for issues:**
+   - File imports work?
+   - API responds correctly?
+   - Web app connects to API?
+   - Token persistence works?
+   - Protected routes work?
+
+4. **Fix any bugs found**
+
+5. **Update TODO with findings**
+
+---
+
+## 📝 NOTES
+
+### Known Issues:
+- Vue/Svelte templates NOT verified yet (only React was fixed)
+- No E2E tests for generator yet
+- Documentation needs updates after recent changes
+
+### Design Decisions:
+- Generated apps use explicit dependencies (no hoisting)
+- Import paths are relative (no aliases like #models)
+- @vasuzex/client is separate package on npm
+- Config & database centralized at project root
+- Each app type (api/web) in apps/{name}/{type}/
+
+### Questions to Answer:
+- Should Vue/Svelte have auth templates like React?
+- Should we support Next.js generation?
+- Do we need app-specific config overrides?
+- How to handle database per app vs shared?
+
+---
+
+**Status:** In Progress  
+**Focus:** E2E testing and Vue/Svelte template verification

package/apps/pilot-test/api/.env.example

@@ -0,0 +1,8 @@
+# PILOT-TEST API Application
+APP_NAME=pilot-test-api
+APP_PORT=3000
+APP_ENV=development
+
+# ⚠️  IMPORTANT: Change APP_PORT if running multiple apps
+# Each app needs a unique port number
+# Example: 3000, 3001, 3002, etc.

package/apps/pilot-test/api/README.md

@@ -0,0 +1,105 @@
+# Pilot-test API
+
+Pilot-test application with authentication and framework integration.
+
+## Structure
+
+```
+apps/pilot-test/api/
+├── src/
+│   ├── controllers/        # Controllers (extend BaseController)
+│   │   ├── BaseController.js
+│   │   └── AuthController.js
+│   ├── models/            # Data models
+│   │   └── User.js
+│   ├── services/          # Business logic
+│   │   └── AuthService.js
+│   ├── middleware/        # Express middleware
+│   │   ├── authMiddleware.js
+│   │   └── errorHandler.js
+│   ├── routes/            # API routes
+│   │   └── auth.routes.js
+│   ├── requests/          # Request validators
+│   │   └── AuthRequests.js
+│   ├── app.js             # Express app setup
+│   └── index.js           # Framework bootstrap
+├── package.json
+├── .env
+└── README.md
+```
+
+## Centralized Config & Database
+
+This app uses:
+- **Config**: `/config/` from project root (NO app-level config)
+- **Database**: `/database/` from project root (centralized models & migrations)
+
+## Installation
+
+Dependencies are installed from project root:
+
+```bash
+cd /path/to/project-root
+pnpm install
+```
+
+## Development
+
+From project root:
+
+```bash
+pnpm dev:pilot-test-api
+```
+
+Or from app directory:
+
+```bash
+cd apps/pilot-test/api
+pnpm dev
+```
+
+## API Endpoints
+
+### Health Check
+```
+GET /health
+```
+
+### Authentication
+```
+POST /api/auth/register  - Register new user
+POST /api/auth/login     - Login user
+GET  /api/auth/me        - Get current user (protected)
+POST /api/auth/logout    - Logout (protected)
+```
+
+## Authentication Flow
+
+1. **Register:**
+```bash
+curl -X POST http://localhost:3000/api/auth/register \
+  -H "Content-Type: application/json" \
+  -d '{"name":"John","email":"john@example.com","password":"123456"}'
+```
+
+2. **Login:**
+```bash
+curl -X POST http://localhost:3000/api/auth/login \
+  -H "Content-Type: application/json" \
+  -d '{"email":"john@example.com","password":"123456"}'
+```
+
+3. **Access Protected Route:**
+```bash
+curl -X GET http://localhost:3000/api/auth/me \
+  -H "Authorization: Bearer YOUR_TOKEN"
+```
+
+## Environment Variables
+
+```env
+APP_NAME=pilot-test-api
+APP_PORT=3000
+JWT_SECRET=your-secret-key
+JWT_EXPIRES_IN=7d
+```

package/apps/pilot-test/api/config/database.js

@@ -0,0 +1,27 @@
+/**
+ * Database Configuration
+ * Uses environment variables via env() helper
+ */
+
+import { env } from '../helpers/env.js';
+
+export default {
+  // Database connection URL
+  url: env('DATABASE_URL', 'postgresql://user:password@localhost:5432/mydb'),
+  
+  // Connection pool settings
+  pool: {
+    min: parseInt(env('DB_POOL_MIN', '2')),
+    max: parseInt(env('DB_POOL_MAX', '10'))
+  },
+  
+  // Migrations path
+  migrations: {
+    directory: './database/migrations'
+  },
+  
+  // Seeds path
+  seeds: {
+    directory: './database/seeders'
+  }
+};

package/apps/pilot-test/api/database/migrations/2025_12_06_19_20_57_create_users_table.js

@@ -0,0 +1,21 @@
+/**
+ * Users Table Migration
+ * Creates users table with authentication fields
+ */
+
+export const up = async (db) => {
+  await db.schema.createTable('users', (table) => {
+    table.increments('id').primary();
+    table.string('name', 255).notNullable();
+    table.string('email', 255).unique().notNullable();
+    table.string('password', 255).notNullable();
+    table.timestamps();
+  });
+  
+  console.log('✅ Users table created');
+};
+
+export const down = async (db) => {
+  await db.schema.dropTableIfExists('users');
+  console.log('✅ Users table dropped');
+};

package/apps/pilot-test/api/database/seeders/UserSeeder.js

@@ -0,0 +1,30 @@
+/**
+ * User Seeder
+ * Creates demo users for development
+ */
+
+import bcrypt from 'bcryptjs';
+
+export default class UserSeeder {
+  async run(db) {
+    const users = [
+      {
+        name: 'Admin User',
+        email: 'admin@example.com',
+        password: await bcrypt.hash('password123', 10),
+        created_at: new Date(),
+        updated_at: new Date()
+      },
+      {
+        name: 'Test User',
+        email: 'test@example.com',
+        password: await bcrypt.hash('password123', 10),
+        created_at: new Date(),
+        updated_at: new Date()
+      }
+    ];
+
+    await db.table('users').insert(users);
+    console.log('✅ Seeded', users.length, 'users');
+  }
+}