@engjts/nexus 0.1.8 → 0.1.9

package/src/advanced/postman/generateFieldExample.ts

@@ -1,45 +0,0 @@
-import { generateExampleFromZod } from './generateExampleFromZod';
-
-
-export function generateFieldExample(field: any, fieldName: string): any {
-  if (!field?._def) return '';
-
-  const def = field._def;
-  const typeName = def.typeName;
-
-  switch (typeName) {
-    case 'ZodString': {
-      // Check for specific formats
-      for (const check of def.checks || []) {
-        if (check.kind === 'email') return 'user@example.com';
-        if (check.kind === 'url') return 'https://example.com';
-        if (check.kind === 'uuid') return '550e8400-e29b-41d4-a716-446655440000';
-      }
-      // Generate based on field name
-      if (fieldName.toLowerCase().includes('email')) return 'user@example.com';
-      if (fieldName.toLowerCase().includes('password')) return 'password123';
-      if (fieldName.toLowerCase().includes('name')) return 'John Doe';
-      if (fieldName.toLowerCase().includes('username')) return 'johndoe';
-      if (fieldName.toLowerCase().includes('phone')) return '+1234567890';
-      if (fieldName.toLowerCase().includes('token')) return 'your-token-here';
-      return 'string';
-    }
-    case 'ZodNumber':
-      return 0;
-    case 'ZodBoolean':
-      return true;
-    case 'ZodArray':
-      return [generateFieldExample(def.type, 'item')];
-    case 'ZodObject':
-      return generateExampleFromZod(field);
-    case 'ZodEnum':
-      return def.values?.[0] || 'enum';
-    case 'ZodOptional':
-    case 'ZodNullable':
-      return generateFieldExample(def.innerType, fieldName);
-    case 'ZodDefault':
-      return def.defaultValue();
-    default:
-      return '';
-  }
-}

package/src/advanced/postman/generateName.ts

@@ -1,20 +0,0 @@
-import { HTTPMethod } from '../../core/types';
-
-
-export function generateName(method: HTTPMethod, path: string): string {
-  const parts = path.split('/').filter(Boolean);
-  const resource = parts.find(p => !p.startsWith(':')) || 'resource';
-  const hasId = parts.some(p => p.startsWith(':'));
-
-  const actions: Record<HTTPMethod, string> = {
-    'GET': hasId ? `Get ${resource} by ID` : `List ${resource}`,
-    'POST': `Create ${resource}`,
-    'PUT': `Update ${resource}`,
-    'PATCH': `Patch ${resource}`,
-    'DELETE': `Delete ${resource}`,
-    'HEAD': `Head ${resource}`,
-    'OPTIONS': `Options ${resource}`
-  };
-
-  return actions[method] || `${method} ${path}`;
-}

package/src/advanced/postman/generateUUID.ts

@@ -1,11 +0,0 @@
-// ============================================
-// UTILITIES
-// ============================================
-
-export function generateUUID(): string {
-  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
-    const r = Math.random() * 16 | 0;
-    const v = c === 'x' ? r : (r & 0x3 | 0x8);
-    return v.toString(16);
-  });
-}

package/src/advanced/postman/getTagFromPath.ts

@@ -1,10 +0,0 @@
-import { capitalize } from './capitalize';
-
-
-export function getTagFromPath(path: string): string {
-  const firstSegment = path.split('/').filter(Boolean)[0];
-  if (firstSegment && !firstSegment.startsWith(':')) {
-    return capitalize(firstSegment);
-  }
-  return 'General';
-}

package/src/advanced/postman/index.ts

@@ -1,28 +0,0 @@
-/**
- * Postman Collection Generator for Nexus Framework
- * Auto-generate Postman collection & environment from routes
- * 
- * @example
- * ```typescript
- * import { createApp, postman } from 'nexus';
- * 
- * const app = createApp();
- * 
- * // Zero config
- * app.plugin(postman());
- * 
- * // With config
- * app.plugin(postman({
- *   path: '/postman',
- *   name: 'My API',
- *   baseUrl: 'http://localhost:3000'
- * }));
- * 
- * // Access:
- * // GET /postman → Download collection.json
- * // GET /postman/environment → Download environment.json
- * ```
- */
-
-import { postman } from './postman';
-export default postman;

package/src/advanced/postman/postman.ts

@@ -1,156 +0,0 @@
-import { Application } from '../../core/application';
-import { RouteConfig, HTTPMethod, Context, Plugin } from '../../core/types';
-import { generateCollection } from './generateCollection';
-import { generateEnvironment } from './generateEnvironment';
-import { slugify } from './slugify';
-import { PostmanConfig, StoredRoute } from './types';
-
-// ============================================
-// POSTMAN FEATURE (PLUGIN)
-// ============================================
-/**
- * Create Postman feature plugin for Nexus
- */
-
-export function postman(config: PostmanConfig = {}): Plugin {
-  const resolvedConfig: PostmanConfig = {
-    path: '/postman',
-    name: 'API Collection',
-    description: 'Auto-generated Postman collection',
-    environmentName: 'API Environment',
-    includeExamples: true,
-    ...config
-  };
-
-  const routes: StoredRoute[] = [];
-  let detectedBaseUrl = '';
-
-  return {
-    name: 'postman',
-    version: '1.0.0',
-
-    install(app: Application) {
-      // Hook into route registration
-      const originalRoute = app.route.bind(app);
-      const originalGet = app.get.bind(app);
-      const originalPost = app.post.bind(app);
-      const originalPut = app.put.bind(app);
-      const originalDelete = app.delete.bind(app);
-      const originalPatch = app.patch.bind(app);
-
-      app.route = function (routeConfig: RouteConfig) {
-        routes.push({
-          method: routeConfig.method,
-          path: routeConfig.path,
-          schema: routeConfig.schema,
-          meta: routeConfig.meta
-        });
-        return originalRoute(routeConfig);
-      };
-
-      const wrapMethod = (method: HTTPMethod, original: Function) => {
-        return function (pathOrRoute: string | any, handlerOrConfig?: any) {
-          // Class-based routing
-          if (typeof pathOrRoute === 'object' && 'pathName' in pathOrRoute) {
-            const route = pathOrRoute;
-            routes.push({
-              method,
-              path: route.pathName,
-              schema: route.schema?.(),
-              meta: route.meta?.()
-            });
-            return original(pathOrRoute);
-          }
-
-          const path = pathOrRoute;
-          if (typeof handlerOrConfig !== 'function' && handlerOrConfig) {
-            routes.push({
-              method,
-              path,
-              schema: handlerOrConfig.schema,
-              meta: handlerOrConfig.meta
-            });
-          } else {
-            routes.push({ method, path });
-          }
-          return original(path, handlerOrConfig);
-        };
-      };
-
-      app.get = wrapMethod('GET', originalGet);
-      app.post = wrapMethod('POST', originalPost);
-      app.put = wrapMethod('PUT', originalPut);
-      app.delete = wrapMethod('DELETE', originalDelete);
-      app.patch = wrapMethod('PATCH', originalPatch);
-
-      const basePath = resolvedConfig.path!;
-
-      // GET /postman → Download collection
-      originalGet(basePath, async (ctx: Context) => {
-        // Auto-detect base URL
-        if (!detectedBaseUrl && ctx.raw?.req) {
-          const req = ctx.raw.req;
-          const protocol = req.headers['x-forwarded-proto'] || 'http';
-          const host = req.headers.host || 'localhost:3000';
-          detectedBaseUrl = `${protocol}://${host}`;
-        }
-
-        const baseUrl = resolvedConfig.baseUrl || detectedBaseUrl || 'http://localhost:3000';
-        const collection = generateCollection(routes, resolvedConfig, baseUrl);
-        const filename = `${slugify(resolvedConfig.name!)}_collection.json`;
-
-        return {
-          statusCode: 200,
-          headers: {
-            'Content-Type': 'application/json',
-            'Content-Disposition': `attachment; filename="${filename}"`
-          },
-          body: JSON.stringify(collection, null, 2)
-        };
-      });
-
-      // GET /postman/environment → Download environment
-      originalGet(basePath + '/environment', async (ctx: Context) => {
-        if (!detectedBaseUrl && ctx.raw?.req) {
-          const req = ctx.raw.req;
-          const protocol = req.headers['x-forwarded-proto'] || 'http';
-          const host = req.headers.host || 'localhost:3000';
-          detectedBaseUrl = `${protocol}://${host}`;
-        }
-
-        const baseUrl = resolvedConfig.baseUrl || detectedBaseUrl || 'http://localhost:3000';
-        const environment = generateEnvironment(resolvedConfig, baseUrl);
-        const filename = `${slugify(resolvedConfig.environmentName!)}_environment.json`;
-
-        return {
-          statusCode: 200,
-          headers: {
-            'Content-Type': 'application/json',
-            'Content-Disposition': `attachment; filename="${filename}"`
-          },
-          body: JSON.stringify(environment, null, 2)
-        };
-      });
-
-      // GET /postman/preview → Preview collection (no download)
-      originalGet(basePath + '/preview', async (ctx: Context) => {
-        if (!detectedBaseUrl && ctx.raw?.req) {
-          const req = ctx.raw.req;
-          const protocol = req.headers['x-forwarded-proto'] || 'http';
-          const host = req.headers.host || 'localhost:3000';
-          detectedBaseUrl = `${protocol}://${host}`;
-        }
-
-        const baseUrl = resolvedConfig.baseUrl || detectedBaseUrl || 'http://localhost:3000';
-        const collection = generateCollection(routes, resolvedConfig, baseUrl);
-
-        return ctx.json(collection);
-      });
-
-      if (process.env.DEBUG === 'true' || process.env.NODE_ENV === 'development') {
-        console.log(`📦 Postman Collection: ${basePath}`);
-        console.log(`🌍 Postman Environment: ${basePath}/environment`);
-      }
-    }
-  };
-}

package/src/advanced/postman/slugify.ts

@@ -1,7 +0,0 @@
-
-export function slugify(text: string): string {
-  return text
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, '_')
-    .replace(/^_|_$/g, '');
-}

package/src/advanced/postman/types.ts

@@ -1,140 +0,0 @@
-import { HTTPMethod, SchemaConfig, RouteMeta } from '../../core/types';
-
-// ============================================
-// TYPES & INTERFACES
-// ============================================
-/**
- * Postman configuration options
- */
-
-export interface PostmanConfig {
-  /** Path to serve Postman endpoints (default: /postman) */
-  path?: string;
-  /** Collection name */
-  name?: string;
-  /** Collection description */
-  description?: string;
-  /** Base URL for requests (auto-detected if not provided) */
-  baseUrl?: string;
-  /** Environment name */
-  environmentName?: string;
-  /** Additional environment variables */
-  variables?: Record<string, string>;
-  /** Auth type for collection */
-  auth?: PostmanAuth;
-  /** Include example responses */
-  includeExamples?: boolean;
-}
-
-
-/**
- * Postman auth configuration
- */
-export interface PostmanAuth {
-  type: 'bearer' | 'apikey' | 'basic' | 'oauth2';
-  bearer?: { token: string };
-  apikey?: { key: string; value: string; in: 'header' | 'query' };
-  basic?: { username: string; password: string };
-}
-
-/**
- * Postman Collection v2.1 format
- */
-export interface PostmanCollection {
-  info: {
-    _postman_id: string;
-    name: string;
-    description?: string;
-    schema: string;
-  };
-  item: PostmanItem[];
-  auth?: any;
-  variable?: PostmanVariable[];
-}
-
-export interface PostmanItem {
-  name: string;
-  item?: PostmanItem[];
-  request?: PostmanRequest;
-  response?: PostmanResponse[];
-}
-
-export interface PostmanRequest {
-  method: string;
-  header: PostmanHeader[];
-  url: PostmanUrl;
-  body?: PostmanBody;
-  description?: string;
-  auth?: any;
-}
-
-export interface PostmanHeader {
-  key: string;
-  value: string;
-  type: string;
-  disabled?: boolean;
-}
-
-export interface PostmanUrl {
-  raw: string;
-  host: string[];
-  path: string[];
-  query?: PostmanQuery[];
-  variable?: PostmanVariable[];
-}
-
-export interface PostmanQuery {
-  key: string;
-  value: string;
-  disabled?: boolean;
-  description?: string;
-}
-
-export interface PostmanVariable {
-  key: string;
-  value: string;
-  type?: string;
-  description?: string;
-}
-
-export interface PostmanBody {
-  mode: 'raw' | 'formdata' | 'urlencoded';
-  raw?: string;
-  options?: {
-    raw: { language: string };
-  };
-}
-
-export interface PostmanResponse {
-  name: string;
-  status: string;
-  code: number;
-  body?: string;
-}
-
-/**
- * Postman Environment format
- */
-export interface PostmanEnvironment {
-  id: string;
-  name: string;
-  values: PostmanEnvVariable[];
-  _postman_variable_scope: string;
-}
-
-export interface PostmanEnvVariable {
-  key: string;
-  value: string;
-  type: string;
-  enabled: boolean;
-}
-
-/**
- * Internal route storage
- */
-export interface StoredRoute {
-  method: HTTPMethod;
-  path: string;
-  schema?: SchemaConfig;
-  meta?: RouteMeta;
-}

package/src/advanced/realtime/index.ts

@@ -1,18 +0,0 @@
-/**
- * Nexus Realtime Module
- * 
- * Optional WebSocket/Realtime integration for Nexus framework.
- * Requires `ws` as peer dependency.
- * 
- * Install: npm install ws
- * 
- * Usage:
- * import { WebSocketGateway } from '@engjts/server/realtime';
- */
-
-export {
-    WebSocketGateway,
-    type WebSocketContext,
-    type WebSocketRoute,
-    type WebSocketRouteConfig
-} from './websocket';

package/src/advanced/realtime/websocket.ts

@@ -1,231 +0,0 @@
-import { IncomingMessage, Server as HTTPServer } from 'http';
-import { parse as parseUrl } from 'url';
-import { EventEmitter } from 'events';
-
-let WebSocket: any;
-let WebSocketServer: any;
-let RawData: any;
-
-try {
-    const wsModule = require('ws');
-    WebSocket = wsModule.default || wsModule;
-    WebSocketServer = wsModule.WebSocketServer;
-    RawData = wsModule.RawData;
-} catch (error) {
-    // ws module not installed
-}
-
-export interface WebSocketContext {
-    path: string;
-    query: Record<string, string | string[]>;
-    headers: IncomingMessage['headers'];
-    user?: any;
-    metadata?: Record<string, any>;
-    raw: {
-        req: IncomingMessage;
-    };
-}
-
-export interface WebSocketRouteConfig {
-    auth?: (ctx: WebSocketContext) => Promise<any>;
-    beforeConnect?: (socket: WebSocket, ctx: WebSocketContext) => Promise<void>;
-    onConnect?: (socket: WebSocket, ctx: WebSocketContext) => Promise<void>;
-    onMessage?: (socket: WebSocket, message: any, ctx: WebSocketContext) => Promise<void>;
-    onClose?: (socket: WebSocket, ctx: WebSocketContext, code: number, reason?: Buffer) => Promise<void>;
-    onError?: (socket: WebSocket, error: Error, ctx: WebSocketContext) => Promise<void>;
-    rooms?: boolean;
-}
-
-export interface WebSocketRoute extends WebSocketRouteConfig {
-    path: string;
-}
-
-export interface ConnectionState {
-    ctx: WebSocketContext;
-    route: WebSocketRoute;
-}
-
-/**
- * WebSocket gateway with room management and authentication hooks
- */
-export class WebSocketGateway extends EventEmitter {
-    private routes: Map<string, WebSocketRoute> = new Map();
-    private wss?: any;
-    private connections: WeakMap<any, ConnectionState> = new WeakMap();
-    private rooms: Map<string, Set<any>> = new Map();
-    private socketRooms: WeakMap<any, Set<string>> = new WeakMap();
-
-    register(path: string, config: WebSocketRouteConfig) {
-        if (!path.startsWith('/')) {
-            throw new Error('WebSocket route path must start with "/"');
-        }
-        this.routes.set(path, { ...config, path });
-    }
-
-    attach(server: HTTPServer) {
-        if (this.wss) {
-            return;
-        }
-
-        if (!WebSocketServer) {
-            throw new Error(
-                'WebSocket support requires the "ws" package to be installed.\n' +
-                'Install it with: npm install ws\n' +
-                'Or if using the CLI: nexus create my-app --skip-install && npm install'
-            );
-        }
-
-        this.wss = new WebSocketServer({ noServer: true });
-
-        server.on('upgrade', async (req, socket, head) => {
-            try {
-                const pathname = parseUrl(req.url || '').pathname || '/';
-                const route = this.routes.get(pathname);
-
-                if (!route) {
-                    socket.destroy();
-                    return;
-                }
-
-                const ctx = this.createContext(req, pathname);
-                if (route.auth) {
-                    ctx.user = await route.auth(ctx);
-                }
-
-                this.wss!.handleUpgrade(req, socket, head, (ws: WebSocket) => {
-                    this.bindConnection(ws, route, ctx);
-                });
-            } catch (error) {
-                socket.destroy();
-            }
-        });
-    }
-
-    broadcast(room: string, payload: any) {
-        const sockets = this.rooms.get(room);
-        if (!sockets) return;
-
-        for (const socket of sockets) {
-            if (socket.readyState === WebSocket.OPEN) {
-                socket.send(JSON.stringify(payload));
-            }
-        }
-    }
-
-    createRoom(name: string) {
-        if (!this.rooms.has(name)) {
-            this.rooms.set(name, new Set());
-        }
-    }
-
-    joinRoom(room: string, socket: WebSocket) {
-        this.createRoom(room);
-        const sockets = this.rooms.get(room)!;
-        sockets.add(socket);
-
-        const joinedRooms = this.socketRooms.get(socket) ?? new Set<string>();
-        joinedRooms.add(room);
-        this.socketRooms.set(socket, joinedRooms);
-    }
-
-    leaveRoom(room: string, socket: WebSocket) {
-        const sockets = this.rooms.get(room);
-        if (!sockets) return;
-        sockets.delete(socket);
-
-        const joinedRooms = this.socketRooms.get(socket);
-        joinedRooms?.delete(room);
-    }
-
-    private bindConnection(socket: any, route: WebSocketRoute, ctx: WebSocketContext) {
-        this.connections.set(socket, { ctx, route });
-        this.emit('connection', socket, ctx);
-
-        socket.on('message', async (data: any) => {
-            try {
-                const payload = this.parseMessage(data);
-                await route.onMessage?.(socket, payload, ctx);
-                this.emit('message', socket, payload, ctx);
-            } catch (error) {
-                await route.onError?.(socket, error as Error, ctx);
-                this.emit('error', error, socket, ctx);
-            }
-        });
-
-        socket.on('close', async (code: number, buffer: Buffer) => {
-            await route.onClose?.(socket, ctx, code, buffer);
-            this.cleanupSocket(socket);
-            this.emit('close', socket, ctx);
-        });
-
-        socket.on('error', async (error: Error) => {
-            await route.onError?.(socket, error, ctx);
-            this.emit('error', error, socket, ctx);
-        });
-
-        void (async () => {
-            if (route.beforeConnect) {
-                await route.beforeConnect(socket, ctx);
-            }
-            await route.onConnect?.(socket, ctx);
-        })();
-    }
-
-    private createContext(req: IncomingMessage, path: string): WebSocketContext {
-        const parsed = parseUrl(req.url || '', true);
-        return {
-            path,
-            query: parsed.query as Record<string, string | string[]>,
-            headers: req.headers,
-            raw: { req }
-        };
-    }
-
-    private parseMessage(data: any): any {
-        if (Buffer.isBuffer(data) || data instanceof ArrayBuffer) {
-            const buffer = Buffer.isBuffer(data) ? data : Buffer.from(data);
-            const stringPayload = buffer.toString('utf-8');
-            try {
-                return JSON.parse(stringPayload);
-            } catch {
-                return stringPayload;
-            }
-        }
-
-        if (Array.isArray(data)) {
-            return data.map((item): any => this.parseMessage(item));
-        }
-
-        // Handle string case
-        try {
-            return JSON.parse(data as string);
-        } catch {
-            return data as string;
-        }
-    }
-
-    private cleanupSocket(socket: any) {
-        const rooms = this.socketRooms.get(socket);
-        if (rooms) {
-            for (const room of rooms) {
-                this.rooms.get(room)?.delete(socket);
-            }
-        }
-        this.socketRooms.delete(socket);
-        this.connections.delete(socket);
-    }
-
-    /**
-     * Helper object to expose room operations in a structured way
-     */
-    get roomManager() {
-        return {
-            create: (name: string) => this.createRoom(name),
-            join: (name: string, socket: WebSocket) => this.joinRoom(name, socket),
-            leave: (name: string, socket: WebSocket) => this.leaveRoom(name, socket),
-            broadcast: (name: string, payload: any) => this.broadcast(name, payload),
-            list: () => Array.from(this.rooms.keys())
-        };
-    }
-}
-