@engjts/nexus 0.1.0

package/dist/advanced/postman/types.d.ts

@@ -0,0 +1,133 @@
+import { HTTPMethod, SchemaConfig, RouteMeta } from '../../core/types';
+/**
+ * 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;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/advanced/postman/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/advanced/postman/types.ts"],"names":[],"mappings":"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"}

package/dist/advanced/postman/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/advanced/postman/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/advanced/postman/types.ts"],"names":[],"mappings":""}

package/dist/advanced/realtime/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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';
+//# sourceMappingURL=index.d.ts.map

package/dist/advanced/realtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/advanced/realtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACH,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAC5B,MAAM,aAAa,CAAC"}

package/dist/advanced/realtime/index.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * 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';
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketGateway = void 0;
+var websocket_1 = require("./websocket");
+Object.defineProperty(exports, "WebSocketGateway", { enumerable: true, get: function () { return websocket_1.WebSocketGateway; } });
+//# sourceMappingURL=index.js.map

package/dist/advanced/realtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/advanced/realtime/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,yCAKqB;AAJjB,6GAAA,gBAAgB,OAAA"}

package/dist/advanced/realtime/websocket.d.ts

@@ -0,0 +1,60 @@
+import { IncomingMessage, Server as HTTPServer } from 'http';
+import { EventEmitter } from 'events';
+import WebSocket from 'ws';
+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 declare class WebSocketGateway extends EventEmitter {
+    private routes;
+    private wss?;
+    private connections;
+    private rooms;
+    private socketRooms;
+    register(path: string, config: WebSocketRouteConfig): void;
+    attach(server: HTTPServer): void;
+    broadcast(room: string, payload: any): void;
+    createRoom(name: string): void;
+    joinRoom(room: string, socket: WebSocket): void;
+    leaveRoom(room: string, socket: WebSocket): void;
+    private bindConnection;
+    private createContext;
+    private parseMessage;
+    private cleanupSocket;
+    /**
+     * Helper object to expose room operations in a structured way
+     */
+    get roomManager(): {
+        create: (name: string) => void;
+        join: (name: string, socket: WebSocket) => void;
+        leave: (name: string, socket: WebSocket) => void;
+        broadcast: (name: string, payload: any) => void;
+        list: () => string[];
+    };
+}
+//# sourceMappingURL=websocket.d.ts.map

package/dist/advanced/realtime/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../../src/advanced/realtime/websocket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,SAA8B,MAAM,IAAI,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IACzC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,GAAG,EAAE;QACD,GAAG,EAAE,eAAe,CAAC;KACxB,CAAC;CACL;AAED,MAAM,WAAW,oBAAoB;IACjC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/C,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtF,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrG,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpF,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAe,SAAQ,oBAAoB;IACxD,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC5B,GAAG,EAAE,gBAAgB,CAAC;IACtB,KAAK,EAAE,cAAc,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAC9C,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,GAAG,CAAC,CAAkB;IAC9B,OAAO,CAAC,WAAW,CAAsD;IACzE,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,WAAW,CAAkD;IAErE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB;IAOnD,MAAM,CAAC,MAAM,EAAE,UAAU;IA+BzB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG;IAWpC,UAAU,CAAC,IAAI,EAAE,MAAM;IAMvB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS;IAUxC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS;IASzC,OAAO,CAAC,cAAc;IAkCtB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,IAAI,WAAW;uBAEQ,MAAM;qBACR,MAAM,UAAU,SAAS;sBACxB,MAAM,UAAU,SAAS;0BACrB,MAAM,WAAW,GAAG;;MAG7C;CACJ"}

package/dist/advanced/realtime/websocket.js

@@ -0,0 +1,197 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketGateway = void 0;
+const url_1 = require("url");
+const events_1 = require("events");
+const ws_1 = __importStar(require("ws"));
+/**
+ * WebSocket gateway with room management and authentication hooks
+ */
+class WebSocketGateway extends events_1.EventEmitter {
+    routes = new Map();
+    wss;
+    connections = new WeakMap();
+    rooms = new Map();
+    socketRooms = new WeakMap();
+    register(path, config) {
+        if (!path.startsWith('/')) {
+            throw new Error('WebSocket route path must start with "/"');
+        }
+        this.routes.set(path, { ...config, path });
+    }
+    attach(server) {
+        if (this.wss) {
+            return;
+        }
+        this.wss = new ws_1.WebSocketServer({ noServer: true });
+        server.on('upgrade', async (req, socket, head) => {
+            try {
+                const pathname = (0, url_1.parse)(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) => {
+                    this.bindConnection(ws, route, ctx);
+                });
+            }
+            catch (error) {
+                socket.destroy();
+            }
+        });
+    }
+    broadcast(room, payload) {
+        const sockets = this.rooms.get(room);
+        if (!sockets)
+            return;
+        for (const socket of sockets) {
+            if (socket.readyState === ws_1.default.OPEN) {
+                socket.send(JSON.stringify(payload));
+            }
+        }
+    }
+    createRoom(name) {
+        if (!this.rooms.has(name)) {
+            this.rooms.set(name, new Set());
+        }
+    }
+    joinRoom(room, socket) {
+        this.createRoom(room);
+        const sockets = this.rooms.get(room);
+        sockets.add(socket);
+        const joinedRooms = this.socketRooms.get(socket) ?? new Set();
+        joinedRooms.add(room);
+        this.socketRooms.set(socket, joinedRooms);
+    }
+    leaveRoom(room, socket) {
+        const sockets = this.rooms.get(room);
+        if (!sockets)
+            return;
+        sockets.delete(socket);
+        const joinedRooms = this.socketRooms.get(socket);
+        joinedRooms?.delete(room);
+    }
+    bindConnection(socket, route, ctx) {
+        this.connections.set(socket, { ctx, route });
+        this.emit('connection', socket, ctx);
+        socket.on('message', async (data) => {
+            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, ctx);
+                this.emit('error', error, socket, ctx);
+            }
+        });
+        socket.on('close', async (code, buffer) => {
+            await route.onClose?.(socket, ctx, code, buffer);
+            this.cleanupSocket(socket);
+            this.emit('close', socket, ctx);
+        });
+        socket.on('error', async (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);
+        })();
+    }
+    createContext(req, path) {
+        const parsed = (0, url_1.parse)(req.url || '', true);
+        return {
+            path,
+            query: parsed.query,
+            headers: req.headers,
+            raw: { req }
+        };
+    }
+    parseMessage(data) {
+        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) => this.parseMessage(item));
+        }
+        // Handle string case
+        try {
+            return JSON.parse(data);
+        }
+        catch {
+            return data;
+        }
+    }
+    cleanupSocket(socket) {
+        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) => this.createRoom(name),
+            join: (name, socket) => this.joinRoom(name, socket),
+            leave: (name, socket) => this.leaveRoom(name, socket),
+            broadcast: (name, payload) => this.broadcast(name, payload),
+            list: () => Array.from(this.rooms.keys())
+        };
+    }
+}
+exports.WebSocketGateway = WebSocketGateway;
+//# sourceMappingURL=websocket.js.map

package/dist/advanced/realtime/websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../../../src/advanced/realtime/websocket.ts"],"names":[],"mappings":"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"}