wexts 3.0.0 → 3.0.1

package/templates/nextjs-web/lib/api.ts

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

package/templates/nixpacks.toml

@@ -0,0 +1,11 @@
+[phases.setup]
+nixPacks = ["nodejs-20", "pnpm"]
+
+[phases.install]
+cmds = ["pnpm install"]
+
+[phases.build]
+cmds = ["pnpm run build"]
+
+[start]
+cmd = "pnpm start"

package/templates/root-package.json

@@ -0,0 +1,32 @@
+{
+    "name": "wexts-app",
+    "version": "1.0.0",
+    "private": true,
+    "scripts": {
+        "dev": "tsx server.ts",
+        "build": "pnpm run build:api && pnpm run build:web && pnpm run build:server",
+        "build:api": "cd apps/api && npm run build",
+        "build:web": "cd apps/web && npm run build",
+        "build:server": "tsc",
+        "start": "node dist/server.js",
+        "postinstall": "cd apps/api && npx prisma generate"
+    },
+    "dependencies": {
+        "@nestjs/common": "^11.0.0",
+        "@nestjs/core": "^11.0.0",
+        "@nestjs/platform-express": "^11.1.9",
+        "express": "^5.1.0",
+        "next": "16.0.0",
+        "react": "^19.0.0",
+        "react-dom": "^19.0.0"
+    },
+    "devDependencies": {
+        "@types/express": "^4.17.21",
+        "@types/node": "^20.0.0",
+        "tsx": "^4.7.0",
+        "typescript": "^5.3.0"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    }
+}

package/templates/server.ts

@@ -0,0 +1,66 @@
+import express from 'express';
+import { NestFactory } from '@nestjs/core';
+import { ExpressAdapter } from '@nestjs/platform-express';
+import next from 'next';
+import path from 'path';
+
+const dev = process.env.NODE_ENV !== 'production';
+const port = parseInt(process.env.PORT || '3000', 10);
+
+async function bootstrap() {
+    console.log('🚀 Starting WEXTS Unified Server...\n');
+
+    // 1. Initialize Next.js
+    console.log('📦 Loading Next.js...');
+    const nextApp = next({
+        dev,
+        dir: path.join(__dirname, 'apps/web'),
+    });
+    await nextApp.prepare();
+    const nextHandler = nextApp.getRequestHandler();
+    console.log('✅ Next.js ready\n');
+
+    // 2. Initialize NestJS with Express
+    console.log('📦 Loading NestJS...');
+    const server = express();
+
+    // Import AppModule dynamically
+    const { AppModule } = dev
+        ? await import('./apps/api/src/app.module')
+        : await import('./apps/api/dist/app.module');
+
+    const app = await NestFactory.create(
+        AppModule,
+        new ExpressAdapter(server),
+        { cors: true }
+    );
+
+    app.setGlobalPrefix('api');
+
+    // Smart routing middleware - MUST be before NestJS init
+    server.use((req, res, next) => {
+        if (req.url.startsWith('/api')) {
+            return next(); // Let NestJS handle API routes
+        }
+        return nextHandler(req, res); // Next.js handles everything else
+    });
+
+    await app.init();
+    console.log('✅ NestJS ready\n');
+
+    // 3. Start server
+    server.listen(port, () => {
+        console.log('\n🎉 WEXTS Unified Server Running!');
+        console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+        console.log(`   🌐 Server: http://localhost:${port}`);
+        console.log(`   📱 Frontend: All routes except /api/*`);
+        console.log(`   🔌 Backend: /api/*`);
+        console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
+        console.log('✨ Routes are smartly separated!\n');
+    });
+}
+
+bootstrap().catch((err) => {
+    console.error('❌ Failed to start:', err);
+    process.exit(1);
+});

package/templates/tsconfig.json

@@ -0,0 +1,31 @@
+{
+    "compilerOptions": {
+        "target": "ES2020",
+        "module": "commonjs",
+        "lib": [
+            "ES2020"
+        ],
+        "experimentalDecorators": true,
+        "emitDecoratorMetadata": true,
+        "esModuleInterop": true,
+        "allowSyntheticDefaultImports": true,
+        "skipLibCheck": true,
+        "strict": false,
+        "forceConsistentCasingInFileNames": true,
+        "moduleResolution": "node",
+        "resolveJsonModule": true,
+        "outDir": "./dist",
+        "declaration": true,
+        "declarationMap": true,
+        "sourceMap": true
+    },
+    "include": [
+        "server.ts",
+        "apps/api/src/**/*"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist",
+        "apps/web"
+    ]
+}