hightjs 0.3.5 → 0.5.0

package/.idea/copilotDiffState.xml

@@ -1,67 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="CopilotDiffPersistence">
-    <option name="pendingDiffs">
-      <map>
-        <entry key="$PROJECT_DIR$/src/types/websocket.ts">
-          <value>
-            <PendingDiffInfo>
-              <option name="filePath" value="$PROJECT_DIR$/src/types/websocket.ts" />
-              <option name="updatedContent" value="import { IncomingMessage } from 'http';&#10;import { WebSocket } from 'ws';&#10;&#10;export interface WebSocketContext {&#10;    ws: WebSocket;&#10;    req: IncomingMessage;&#10;    url: URL;&#10;    params: Record&lt;string, string&gt;;&#10;    query: Record&lt;string, string&gt;;&#10;    send: (data: any) =&gt; void;&#10;    close: (code?: number, reason?: string) =&gt; void;&#10;    broadcast: (data: any, exclude?: WebSocket[]) =&gt; void;&#10;}&#10;&#10;export interface WebSocketHandler {&#10;    (ctx: WebSocketContext): void | Promise&lt;void&gt;;&#10;}&#10;&#10;export interface WebSocketRoute {&#10;    path: string;&#10;    handler: WebSocketHandler;&#10;    pathPattern?: RegExp;&#10;    paramNames?: string[];&#10;}&#10;&#10;export interface WebSocketServer {&#10;    route: (path: string, handler: WebSocketHandler) =&gt; void;&#10;    start: (port?: number) =&gt; void;&#10;    broadcast: (data: any) =&gt; void;&#10;    getConnections: () =&gt; WebSocket[];&#10;}" />
-            </PendingDiffInfo>
-          </value>
-        </entry>
-        <entry key="$PROJECT_DIR$/src/websocket/adapter.ts">
-          <value>
-            <PendingDiffInfo>
-              <option name="filePath" value="$PROJECT_DIR$/src/websocket/adapter.ts" />
-              <option name="updatedContent" value="import { Server } from 'http';&#10;import { WebSocketServer as WSServer } from 'ws';&#10;import { HightWSServer } from './server';&#10;import { WebSocketServer, WebSocketHandler } from '../types/websocket';&#10;import Console, { Colors } from '../api/console';&#10;&#10;export class WebSocketAdapter {&#10;    private wsServer: HightWSServer;&#10;    private httpServer: Server | null = null;&#10;    private wss: WSServer | null = null;&#10;&#10;    constructor() {&#10;        this.wsServer = new HightWSServer();&#10;    }&#10;&#10;    /**&#10;     * Integra WebSocket com um servidor HTTP existente&#10;     */&#10;    attachToHttpServer(httpServer: Server): void {&#10;        this.httpServer = httpServer;&#10;        this.wss = new WSServer({ &#10;            server: httpServer,&#10;            perMessageDeflate: false &#10;        });&#10;&#10;        console.log(`${Colors.FgGreen}✓${Colors.Reset} WebSocket attached to HTTP server`);&#10;&#10;        this.wss.on('connection', (ws, req) =&gt; {&#10;            this.wsServer['handleConnection'](ws, req);&#10;        });&#10;&#10;        this.wss.on('error', (error) =&gt; {&#10;            console.error(`${Colors.FgRed}[WebSocket Server Error]${Colors.Reset}`, error);&#10;        });&#10;    }&#10;&#10;    /**&#10;     * Adiciona uma rota WebSocket&#10;     */&#10;    route(path: string, handler: WebSocketHandler): void {&#10;        this.wsServer.route(path, handler);&#10;    }&#10;&#10;    /**&#10;     * Faz broadcast para todas as conexões&#10;     */&#10;    broadcast(data: any): void {&#10;        this.wsServer.broadcast(data);&#10;    }&#10;&#10;    /**&#10;     * Retorna todas as conexões ativas&#10;     */&#10;    getConnections() {&#10;        return this.wsServer.getConnections();&#10;    }&#10;&#10;    /**&#10;     * Inicia servidor WebSocket standalone&#10;     */&#10;    startStandalone(port: number = 8080): void {&#10;        this.wsServer.start(port);&#10;    }&#10;}" />
-            </PendingDiffInfo>
-          </value>
-        </entry>
-        <entry key="$PROJECT_DIR$/src/websocket/client.ts">
-          <value>
-            <PendingDiffInfo>
-              <option name="filePath" value="$PROJECT_DIR$/src/websocket/client.ts" />
-              <option name="originalContent" value="&#10;" />
-              <option name="updatedContent" value="import React from 'react';&#10;&#10;export class HightWSClient {&#10;    private ws: WebSocket | null = null;&#10;    private url: string;&#10;    private reconnectAttempts: number = 0;&#10;    private maxReconnectAttempts: number = 5;&#10;    private reconnectDelay: number = 1000;&#10;    private listeners: Map&lt;string, Function[]&gt; = new Map();&#10;&#10;    constructor(url: string) {&#10;        this.url = url;&#10;        this.connect();&#10;    }&#10;&#10;    private connect(): void {&#10;        try {&#10;            this.ws = new WebSocket(this.url);&#10;            &#10;            this.ws.onopen = (event) =&gt; {&#10;                console.log('[HightWS] Connected to WebSocket server');&#10;                this.reconnectAttempts = 0;&#10;                this.emit('open', event);&#10;            };&#10;&#10;            this.ws.onmessage = (event) =&gt; {&#10;                try {&#10;                    const data = JSON.parse(event.data);&#10;                    this.emit('message', data);&#10;                } catch (error) {&#10;                    // Se não for JSON, envia como string&#10;                    this.emit('message', event.data);&#10;                }&#10;            };&#10;&#10;            this.ws.onclose = (event) =&gt; {&#10;                console.log('[HightWS] Connection closed');&#10;                this.emit('close', event);&#10;                this.attemptReconnect();&#10;            };&#10;&#10;            this.ws.onerror = (event) =&gt; {&#10;                console.error('[HightWS] WebSocket error:', event);&#10;                this.emit('error', event);&#10;            };&#10;&#10;        } catch (error) {&#10;            console.error('[HightWS] Failed to connect:', error);&#10;            this.attemptReconnect();&#10;        }&#10;    }&#10;&#10;    private attemptReconnect(): void {&#10;        if (this.reconnectAttempts &lt; this.maxReconnectAttempts) {&#10;            this.reconnectAttempts++;&#10;            console.log(`[HightWS] Attempting to reconnect (${this.reconnectAttempts}/${this.maxReconnectAttempts})...`);&#10;            &#10;            setTimeout(() =&gt; {&#10;                this.connect();&#10;            }, this.reconnectDelay * this.reconnectAttempts);&#10;        } else {&#10;            console.error('[HightWS] Max reconnection attempts reached');&#10;            this.emit('maxReconnectAttemptsReached');&#10;        }&#10;    }&#10;&#10;    public send(data: any): void {&#10;        if (this.ws &amp;&amp; this.ws.readyState === WebSocket.OPEN) {&#10;            const message = typeof data === 'string' ? data : JSON.stringify(data);&#10;            this.ws.send(message);&#10;        } else {&#10;            console.warn('[HightWS] WebSocket is not connected');&#10;        }&#10;    }&#10;&#10;    public on(event: string, callback: Function): void {&#10;        if (!this.listeners.has(event)) {&#10;            this.listeners.set(event, []);&#10;        }&#10;        this.listeners.get(event)!.push(callback);&#10;    }&#10;&#10;    public off(event: string, callback?: Function): void {&#10;        if (!this.listeners.has(event)) return;&#10;&#10;        if (callback) {&#10;            const callbacks = this.listeners.get(event)!;&#10;            const index = callbacks.indexOf(callback);&#10;            if (index &gt; -1) {&#10;                callbacks.splice(index, 1);&#10;            }&#10;        } else {&#10;            this.listeners.delete(event);&#10;        }&#10;    }&#10;&#10;    private emit(event: string, data?: any): void {&#10;        if (this.listeners.has(event)) {&#10;            this.listeners.get(event)!.forEach(callback =&gt; {&#10;                try {&#10;                    callback(data);&#10;                } catch (error) {&#10;                    console.error(`[HightWS] Error in event listener for ${event}:`, error);&#10;                }&#10;            });&#10;        }&#10;    }&#10;&#10;    public close(): void {&#10;        if (this.ws) {&#10;            this.ws.close();&#10;            this.ws = null;&#10;        }&#10;    }&#10;&#10;    public get readyState(): number {&#10;        return this.ws ? this.ws.readyState : WebSocket.CLOSED;&#10;    }&#10;&#10;    public get isConnected(): boolean {&#10;        return this.ws !== null &amp;&amp; this.ws.readyState === WebSocket.OPEN;&#10;    }&#10;}&#10;&#10;// Hook React para usar WebSocket&#10;export function useWebSocket(url: string) {&#10;    const [client, setClient] = React.useState&lt;HightWSClient | null&gt;(null);&#10;    const [isConnected, setIsConnected] = React.useState(false);&#10;    const [lastMessage, setLastMessage] = React.useState&lt;any&gt;(null);&#10;&#10;    React.useEffect(() =&gt; {&#10;        const wsClient = new HightWSClient(url);&#10;&#10;        wsClient.on('open', () =&gt; {&#10;            setIsConnected(true);&#10;        });&#10;&#10;        wsClient.on('close', () =&gt; {&#10;            setIsConnected(false);&#10;        });&#10;&#10;        wsClient.on('message', (data) =&gt; {&#10;            setLastMessage(data);&#10;        });&#10;&#10;        setClient(wsClient);&#10;&#10;        return () =&gt; {&#10;            wsClient.close();&#10;        };&#10;    }, [url]);&#10;&#10;    const sendMessage = React.useCallback((data: any) =&gt; {&#10;        if (client) {&#10;            client.send(data);&#10;        }&#10;    }, [client]);&#10;&#10;    return {&#10;        client,&#10;        isConnected,&#10;        lastMessage,&#10;        sendMessage&#10;    };&#10;}" />
-            </PendingDiffInfo>
-          </value>
-        </entry>
-        <entry key="$PROJECT_DIR$/src/websocket/example.ts">
-          <value>
-            <PendingDiffInfo>
-              <option name="filePath" value="$PROJECT_DIR$/src/websocket/example.ts" />
-              <option name="updatedContent" value="// Exemplo de uso do WebSocket no HightJS&#10;&#10;// ============================================&#10;// BACKEND - Como criar rotas WebSocket&#10;// ============================================&#10;&#10;// Em src/web/backend/websocket.ts (ou qualquer arquivo backend)&#10;import { ws } from 'hightjs/ws';&#10;&#10;// Rota simples de chat&#10;ws('/chat', (ctx) =&gt; {&#10;    console.log('Nova conexão no chat:', ctx.req.socket.remoteAddress);&#10;    &#10;    // Envia mensagem de boas-vindas&#10;    ctx.send({&#10;        type: 'welcome',&#10;        message: 'Bem-vindo ao chat!'&#10;    });&#10;&#10;    // Escuta mensagens do cliente&#10;    ctx.ws.on('message', (data) =&gt; {&#10;        try {&#10;            const message = JSON.parse(data.toString());&#10;            &#10;            // Faz broadcast da mensagem para todos os outros clientes&#10;            ctx.broadcast({&#10;                type: 'message',&#10;                user: message.user || 'Anônimo',&#10;                text: message.text,&#10;                timestamp: new Date().toISOString()&#10;            }, [ctx.ws]); // Exclui o remetente&#10;            &#10;        } catch (error) {&#10;            console.error('Erro ao processar mensagem:', error);&#10;        }&#10;    });&#10;&#10;    // Quando a conexão fechar&#10;    ctx.ws.on('close', () =&gt; {&#10;        console.log('Cliente desconectado do chat');&#10;    });&#10;});&#10;&#10;// Rota com parâmetros&#10;ws('/room/:roomId', (ctx) =&gt; {&#10;    const { roomId } = ctx.params;&#10;    console.log(`Nova conexão na sala: ${roomId}`);&#10;    &#10;    ctx.send({&#10;        type: 'joined',&#10;        room: roomId,&#10;        message: `Você entrou na sala ${roomId}`&#10;    });&#10;});&#10;&#10;// Rota para notificações em tempo real&#10;ws('/notifications/:userId', (ctx) =&gt; {&#10;    const { userId } = ctx.params;&#10;    &#10;    // Pode usar query params também&#10;    const token = ctx.query.token;&#10;    &#10;    if (!token) {&#10;        ctx.close(1008, 'Token obrigatório');&#10;        return;&#10;    }&#10;    &#10;    console.log(`Usuário ${userId} conectado para notificações`);&#10;    &#10;    // Simula envio de notificação a cada 30 segundos&#10;    const interval = setInterval(() =&gt; {&#10;        ctx.send({&#10;            type: 'notification',&#10;            title: 'Nova notificação',&#10;            body: 'Você tem uma nova mensagem',&#10;            timestamp: new Date().toISOString()&#10;        });&#10;    }, 30000);&#10;    &#10;    ctx.ws.on('close', () =&gt; {&#10;        clearInterval(interval);&#10;        console.log(`Usuário ${userId} desconectado das notificações`);&#10;    });&#10;});&#10;&#10;// ============================================&#10;// FRONTEND - Como usar WebSocket no React&#10;// ============================================&#10;&#10;// Em qualquer componente React&#10;import React from 'react';&#10;import { HightWSClient, useWebSocket } from 'hightjs/ws';&#10;&#10;// Método 1: Usando o hook useWebSocket (mais fácil)&#10;function ChatComponent() {&#10;    const { client, isConnected, lastMessage, sendMessage } = useWebSocket('ws://localhost:8080/chat');&#10;    const [messages, setMessages] = React.useState([]);&#10;    const [newMessage, setNewMessage] = React.useState('');&#10;&#10;    // Atualiza mensagens quando recebe uma nova&#10;    React.useEffect(() =&gt; {&#10;        if (lastMessage &amp;&amp; lastMessage.type === 'message') {&#10;            setMessages(prev =&gt; [...prev, lastMessage]);&#10;        }&#10;    }, [lastMessage]);&#10;&#10;    const handleSendMessage = () =&gt; {&#10;        if (newMessage.trim() &amp;&amp; isConnected) {&#10;            sendMessage({&#10;                user: 'Seu Nome',&#10;                text: newMessage&#10;            });&#10;            setNewMessage('');&#10;        }&#10;    };&#10;&#10;    return (&#10;        &lt;div&gt;&#10;            &lt;div&gt;Status: {isConnected ? 'Conectado' : 'Desconectado'}&lt;/div&gt;&#10;            &#10;            &lt;div style={{ height: '300px', overflow: 'auto', border: '1px solid #ccc' }}&gt;&#10;                {messages.map((msg, index) =&gt; (&#10;                    &lt;div key={index}&gt;&#10;                        &lt;strong&gt;{msg.user}:&lt;/strong&gt; {msg.text}&#10;                        &lt;small&gt; ({new Date(msg.timestamp).toLocaleTimeString()})&lt;/small&gt;&#10;                    &lt;/div&gt;&#10;                ))}&#10;            &lt;/div&gt;&#10;            &#10;            &lt;div&gt;&#10;                &lt;input&#10;                    value={newMessage}&#10;                    onChange={(e) =&gt; setNewMessage(e.target.value)}&#10;                    onKeyPress={(e) =&gt; e.key === 'Enter' &amp;&amp; handleSendMessage()}&#10;                    placeholder=&quot;Digite sua mensagem...&quot;&#10;                /&gt;&#10;                &lt;button onClick={handleSendMessage} disabled={!isConnected}&gt;&#10;                    Enviar&#10;                &lt;/button&gt;&#10;            &lt;/div&gt;&#10;        &lt;/div&gt;&#10;    );&#10;}&#10;&#10;// Método 2: Usando a classe HightWSClient diretamente (mais controle)&#10;function NotificationsComponent() {&#10;    const [client, setClient] = React.useState(null);&#10;    const [notifications, setNotifications] = React.useState([]);&#10;    const userId = '123'; // ID do usuário atual&#10;&#10;    React.useEffect(() =&gt; {&#10;        const wsClient = new HightWSClient(`ws://localhost:8080/notifications/${userId}?token=abc123`);&#10;        &#10;        wsClient.on('open', () =&gt; {&#10;            console.log('Conectado às notificações');&#10;        });&#10;&#10;        wsClient.on('message', (data) =&gt; {&#10;            if (data.type === 'notification') {&#10;                setNotifications(prev =&gt; [data, ...prev.slice(0, 9)]); // Mantém só as 10 últimas&#10;                &#10;                // Pode mostrar notificação do browser também&#10;                if (Notification.permission === 'granted') {&#10;                    new Notification(data.title, { body: data.body });&#10;                }&#10;            }&#10;        });&#10;&#10;        wsClient.on('close', () =&gt; {&#10;            console.log('Desconectado das notificações');&#10;        });&#10;&#10;        setClient(wsClient);&#10;&#10;        return () =&gt; {&#10;            wsClient.close();&#10;        };&#10;    }, [userId]);&#10;&#10;    return (&#10;        &lt;div&gt;&#10;            &lt;h3&gt;Notificações em tempo real&lt;/h3&gt;&#10;            {notifications.map((notif, index) =&gt; (&#10;                &lt;div key={index} style={{ padding: '10px', border: '1px solid #ddd', margin: '5px 0' }}&gt;&#10;                    &lt;strong&gt;{notif.title}&lt;/strong&gt;&#10;                    &lt;p&gt;{notif.body}&lt;/p&gt;&#10;                    &lt;small&gt;{new Date(notif.timestamp).toLocaleString()}&lt;/small&gt;&#10;                &lt;/div&gt;&#10;            ))}&#10;        &lt;/div&gt;&#10;    );&#10;}&#10;&#10;// ============================================&#10;// INICIANDO O SERVIDOR WEBSOCKET&#10;// ============================================&#10;&#10;// No seu arquivo principal de servidor (onde você inicia o HightJS)&#10;import { createWebSocketServer } from 'hightjs/ws';&#10;&#10;// Método 1: Servidor WebSocket independente&#10;const wsServer = createWebSocketServer();&#10;wsServer.start(8080); // Inicia na porta 8080&#10;&#10;// Método 2: Integrar com servidor HTTP existente (Express/Fastify)&#10;// Isso ainda precisa ser implementado nos adapters, mas a estrutura está pronta&#10;&#10;export default ChatComponent;" />
-            </PendingDiffInfo>
-          </value>
-        </entry>
-        <entry key="$PROJECT_DIR$/src/websocket/factory.ts">
-          <value>
-            <PendingDiffInfo>
-              <option name="filePath" value="$PROJECT_DIR$/src/websocket/factory.ts" />
-              <option name="updatedContent" value="import { HightWSServer } from './server';&#10;import { WebSocketServer } from '../types/websocket';&#10;&#10;/**&#10; * Cria uma nova instância do servidor WebSocket HightJS&#10; * @returns Uma nova instância do servidor WebSocket&#10; */&#10;export function createWebSocketServer(): WebSocketServer {&#10;    return new HightWSServer();&#10;}&#10;&#10;/**&#10; * Instância global do servidor WebSocket (singleton)&#10; */&#10;let globalWSServer: WebSocketServer | null = null;&#10;&#10;/**&#10; * Retorna a instância global do servidor WebSocket ou cria uma nova&#10; * @returns A instância global do servidor WebSocket&#10; */&#10;export function getGlobalWebSocketServer(): WebSocketServer {&#10;    if (!globalWSServer) {&#10;        globalWSServer = new HightWSServer();&#10;    }&#10;    return globalWSServer;&#10;}&#10;&#10;/**&#10; * Helper para criar rotas WebSocket rapidamente&#10; * @param path Caminho da rota&#10; * @param handler Função handler da rota&#10; */&#10;export function ws(path: string, handler: (ctx: any) =&gt; void | Promise&lt;void&gt;) {&#10;    const server = getGlobalWebSocketServer();&#10;    server.route(path, handler);&#10;    return server;&#10;}" />
-            </PendingDiffInfo>
-          </value>
-        </entry>
-        <entry key="$PROJECT_DIR$/src/websocket/index.ts">
-          <value>
-            <PendingDiffInfo>
-              <option name="filePath" value="$PROJECT_DIR$/src/websocket/index.ts" />
-              <option name="originalContent" value="&#10;&#10;" />
-              <option name="updatedContent" value="export { HightWSServer } from './server';&#10;export { WebSocketContext, WebSocketHandler, WebSocketRoute, WebSocketServer } from '../types/websocket';&#10;export { createWebSocketServer } from './factory';&#10;export { HightWSClient, useWebSocket } from './client';" />
-            </PendingDiffInfo>
-          </value>
-        </entry>
-        <entry key="$PROJECT_DIR$/src/websocket/server.ts">
-          <value>
-            <PendingDiffInfo>
-              <option name="filePath" value="$PROJECT_DIR$/src/websocket/server.ts" />
-              <option name="updatedContent" value="import { WebSocket, WebSocketServer as WSServer } from 'ws';&#10;import { IncomingMessage } from 'http';&#10;import { URL } from 'url';&#10;import { WebSocketContext, WebSocketHandler, WebSocketRoute, WebSocketServer } from '../types/websocket';&#10;import Console, { Colors } from '../api/console';&#10;&#10;export class HightWSServer implements WebSocketServer {&#10;    private wss: WSServer | null = null;&#10;    private routes: WebSocketRoute[] = [];&#10;    private connections: Set&lt;WebSocket&gt; = new Set();&#10;&#10;    constructor() {&#10;        this.setupRoutePatterns();&#10;    }&#10;&#10;    route(path: string, handler: WebSocketHandler): void {&#10;        const route: WebSocketRoute = {&#10;            path,&#10;            handler,&#10;            ...this.createPathPattern(path)&#10;        };&#10;        this.routes.push(route);&#10;        console.log(`${Colors.FgBlue}[WebSocket]${Colors.Reset} Route registered: ${Colors.FgYellow}${path}${Colors.Reset}`);&#10;    }&#10;&#10;    start(port: number = 8080): void {&#10;        this.wss = new WSServer({ &#10;            port,&#10;            perMessageDeflate: false &#10;        });&#10;&#10;        console.log(`${Colors.FgGreen}✓${Colors.Reset} WebSocket server listening on port ${Colors.FgYellow}${port}${Colors.Reset}`);&#10;&#10;        this.wss.on('connection', (ws: WebSocket, req: IncomingMessage) =&gt; {&#10;            this.connections.add(ws);&#10;            console.log(`${Colors.FgBlue}[WebSocket]${Colors.Reset} New connection from ${req.socket.remoteAddress}`);&#10;&#10;            ws.on('close', () =&gt; {&#10;                this.connections.delete(ws);&#10;                console.log(`${Colors.FgBlue}[WebSocket]${Colors.Reset} Connection closed`);&#10;            });&#10;&#10;            ws.on('error', (error) =&gt; {&#10;                console.error(`${Colors.FgRed}[WebSocket Error]${Colors.Reset}`, error);&#10;                this.connections.delete(ws);&#10;            });&#10;&#10;            this.handleConnection(ws, req);&#10;        });&#10;&#10;        this.wss.on('error', (error) =&gt; {&#10;            console.error(`${Colors.FgRed}[WebSocket Server Error]${Colors.Reset}`, error);&#10;        });&#10;    }&#10;&#10;    broadcast(data: any): void {&#10;        const message = typeof data === 'string' ? data : JSON.stringify(data);&#10;        this.connections.forEach(ws =&gt; {&#10;            if (ws.readyState === WebSocket.OPEN) {&#10;                ws.send(message);&#10;            }&#10;        });&#10;    }&#10;&#10;    getConnections(): WebSocket[] {&#10;        return Array.from(this.connections);&#10;    }&#10;&#10;    private handleConnection(ws: WebSocket, req: IncomingMessage): void {&#10;        if (!req.url) return;&#10;&#10;        const url = new URL(req.url, `http://${req.headers.host}`);&#10;        const pathname = url.pathname;&#10;&#10;        // Encontra a rota correspondente&#10;        const matchedRoute = this.findMatchingRoute(pathname);&#10;        if (!matchedRoute) {&#10;            console.log(`${Colors.FgYellow}[WebSocket]${Colors.Reset} No route found for ${pathname}`);&#10;            ws.close(1000, 'No route found');&#10;            return;&#10;        }&#10;&#10;        // Extrai parâmetros da URL&#10;        const params = this.extractParams(pathname, matchedRoute);&#10;        const query = Object.fromEntries(url.searchParams.entries());&#10;&#10;        // Cria o contexto&#10;        const context: WebSocketContext = {&#10;            ws,&#10;            req,&#10;            url,&#10;            params,&#10;            query,&#10;            send: (data: any) =&gt; {&#10;                if (ws.readyState === WebSocket.OPEN) {&#10;                    const message = typeof data === 'string' ? data : JSON.stringify(data);&#10;                    ws.send(message);&#10;                }&#10;            },&#10;            close: (code?: number, reason?: string) =&gt; {&#10;                ws.close(code || 1000, reason);&#10;            },&#10;            broadcast: (data: any, exclude?: WebSocket[]) =&gt; {&#10;                const message = typeof data === 'string' ? data : JSON.stringify(data);&#10;                const excludeSet = new Set(exclude || []);&#10;                this.connections.forEach(connection =&gt; {&#10;                    if (connection.readyState === WebSocket.OPEN &amp;&amp; !excludeSet.has(connection)) {&#10;                        connection.send(message);&#10;                    }&#10;                });&#10;            }&#10;        };&#10;&#10;        try {&#10;            matchedRoute.handler(context);&#10;        } catch (error) {&#10;            console.error(`${Colors.FgRed}[WebSocket Handler Error]${Colors.Reset}`, error);&#10;            ws.close(1011, 'Internal server error');&#10;        }&#10;    }&#10;&#10;    private createPathPattern(path: string): { pathPattern: RegExp; paramNames: string[] } {&#10;        const paramNames: string[] = [];&#10;        const pattern = path&#10;            .replace(/\//g, '\\/')&#10;            .replace(/:([^\/]+)/g, (_, paramName) =&gt; {&#10;                paramNames.push(paramName);&#10;                return '([^/]+)';&#10;            })&#10;            .replace(/\*/g, '.*');&#10;&#10;        return {&#10;            pathPattern: new RegExp(`^${pattern}$`),&#10;            paramNames&#10;        };&#10;    }&#10;&#10;    private findMatchingRoute(pathname: string): WebSocketRoute | null {&#10;        return this.routes.find(route =&gt; {&#10;            if (route.pathPattern) {&#10;                return route.pathPattern.test(pathname);&#10;            }&#10;            return route.path === pathname;&#10;        }) || null;&#10;    }&#10;&#10;    private extractParams(pathname: string, route: WebSocketRoute): Record&lt;string, string&gt; {&#10;        const params: Record&lt;string, string&gt; = {};&#10;        &#10;        if (route.pathPattern &amp;&amp; route.paramNames) {&#10;            const match = pathname.match(route.pathPattern);&#10;            if (match) {&#10;                route.paramNames.forEach((paramName, index) =&gt; {&#10;                    params[paramName] = match[index + 1];&#10;                });&#10;            }&#10;        }&#10;&#10;        return params;&#10;    }&#10;&#10;    private setupRoutePatterns(): void {&#10;        // Reprocessa todos os patterns das rotas existentes&#10;        this.routes.forEach(route =&gt; {&#10;            const { pathPattern, paramNames } = this.createPathPattern(route.path);&#10;            route.pathPattern = pathPattern;&#10;            route.paramNames = paramNames;&#10;        });&#10;    }&#10;}" />
-            </PendingDiffInfo>
-          </value>
-        </entry>
-      </map>
-    </option>
-  </component>
-</project>

package/.idea/inspectionProfiles/Project_Default.xml

@@ -1,13 +0,0 @@
-<component name="InspectionProjectProfileManager">
-  <profile version="1.0">
-    <option name="myName" value="Project Default" />
-    <inspection_tool class="D" enabled="false" level="WEAK WARNING" enabled_by_default="false" />
-    <inspection_tool class="IncorrectHttpHeaderInspection" enabled="true" level="WARNING" enabled_by_default="true">
-      <option name="customHeaders">
-        <set>
-          <option value="Authorization Bearer {{TOKEN}}" />
-        </set>
-      </option>
-    </inspection_tool>
-  </profile>
-</component>

package/.idea/libraries/test_package.xml

@@ -1,9 +0,0 @@
-<component name="libraryTable">
-  <library name="test-package">
-    <CLASSES>
-      <root url="jar://$PROJECT_DIR$/node_modules/thread-stream/test/dir with spaces/test-package.zip!/" />
-    </CLASSES>
-    <JAVADOC />
-    <SOURCES />
-  </library>
-</component>

package/.idea/libraries/ts_commonjs_default_export.xml

@@ -1,9 +0,0 @@
-<component name="libraryTable">
-  <library name="ts-commonjs-default-export">
-    <CLASSES>
-      <root url="jar://$PROJECT_DIR$/node_modules/thread-stream/test/ts-commonjs-default-export.zip!/" />
-    </CLASSES>
-    <JAVADOC />
-    <SOURCES />
-  </library>
-</component>

package/.idea/misc.xml

@@ -1,7 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="KubernetesApiProvider"><![CDATA[{}]]></component>
-  <component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="ms-21" project-jdk-type="JavaSDK">
-    <output url="file://$PROJECT_DIR$/out" />
-  </component>
-</project>

package/.idea/modules.xml

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectModuleManager">
-    <modules>
-      <module fileurl="file://$PROJECT_DIR$/.idea/HightJS.iml" filepath="$PROJECT_DIR$/.idea/HightJS.iml" />
-    </modules>
-  </component>
-</project>

package/.idea/vcs.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="VcsDirectoryMappings">
-    <mapping directory="$PROJECT_DIR$" vcs="Git" />
-  </component>
-</project>

package/dist/auth/client.d.ts

@@ -1,24 +0,0 @@
-import type { SignInOptions, SignInResult, Session } from './types';
-export declare function setBasePath(path: string): void;
-/**
- * Função para obter a sessão atual (similar ao NextAuth getSession)
- */
-export declare function getSession(): Promise<Session | null>;
-/**
- * Função para obter token CSRF
- */
-export declare function getCsrfToken(): Promise<string | null>;
-/**
- * Função para obter providers disponíveis
- */
-export declare function getProviders(): Promise<any[] | null>;
-/**
- * Função para fazer login (similar ao NextAuth signIn)
- */
-export declare function signIn(provider?: string, options?: SignInOptions): Promise<SignInResult | undefined>;
-/**
- * Função para fazer logout (similar ao NextAuth signOut)
- */
-export declare function signOut(options?: {
-    callbackUrl?: string;
-}): Promise<void>;

package/dist/auth/client.js

@@ -1,146 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setBasePath = setBasePath;
-exports.getSession = getSession;
-exports.getCsrfToken = getCsrfToken;
-exports.getProviders = getProviders;
-exports.signIn = signIn;
-exports.signOut = signOut;
-// Configuração global do client
-let basePath = '/api/auth';
-function setBasePath(path) {
-    basePath = path;
-}
-/**
- * Função para obter a sessão atual (similar ao NextAuth getSession)
- */
-async function getSession() {
-    try {
-        const response = await fetch(`${basePath}/session`, {
-            credentials: 'include'
-        });
-        if (!response.ok) {
-            return null;
-        }
-        const data = await response.json();
-        return data.session || null;
-    }
-    catch (error) {
-        console.error('[hweb-auth] Error fetching session:', error);
-        return null;
-    }
-}
-/**
- * Função para obter token CSRF
- */
-async function getCsrfToken() {
-    try {
-        const response = await fetch(`${basePath}/csrf`, {
-            credentials: 'include'
-        });
-        if (!response.ok) {
-            return null;
-        }
-        const data = await response.json();
-        return data.csrfToken || null;
-    }
-    catch (error) {
-        console.error('[hweb-auth] Error fetching CSRF token:', error);
-        return null;
-    }
-}
-/**
- * Função para obter providers disponíveis
- */
-async function getProviders() {
-    try {
-        const response = await fetch(`${basePath}/providers`, {
-            credentials: 'include'
-        });
-        if (!response.ok) {
-            return null;
-        }
-        const data = await response.json();
-        return data.providers || [];
-    }
-    catch (error) {
-        console.error('[hweb-auth] Error searching for providers:', error);
-        return null;
-    }
-}
-/**
- * Função para fazer login (similar ao NextAuth signIn)
- */
-async function signIn(provider = 'credentials', options = {}) {
-    try {
-        const { redirect = true, callbackUrl, ...credentials } = options;
-        const response = await fetch(`${basePath}/signin`, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-            },
-            credentials: 'include',
-            body: JSON.stringify({
-                provider,
-                ...credentials
-            })
-        });
-        const data = await response.json();
-        if (response.ok && data.success) {
-            // Se é OAuth, redireciona para URL fornecida
-            if (data.type === 'oauth' && data.redirectUrl) {
-                if (redirect && typeof window !== 'undefined') {
-                    window.location.href = data.redirectUrl;
-                }
-                return {
-                    ok: true,
-                    status: 200,
-                    url: data.redirectUrl
-                };
-            }
-            // Se é sessão (credentials), redireciona para callbackUrl
-            if (data.type === 'session') {
-                if (redirect && typeof window !== 'undefined') {
-                    window.location.href = callbackUrl || '/';
-                }
-                return {
-                    ok: true,
-                    status: 200,
-                    url: callbackUrl || '/'
-                };
-            }
-        }
-        else {
-            return {
-                error: data.error || 'Authentication failed',
-                status: response.status,
-                ok: false
-            };
-        }
-    }
-    catch (error) {
-        console.error('[hweb-auth] Error on signIn:', error);
-        return {
-            error: 'Network error',
-            status: 500,
-            ok: false
-        };
-    }
-}
-/**
- * Função para fazer logout (similar ao NextAuth signOut)
- */
-async function signOut(options = {}) {
-    try {
-        await fetch(`${basePath}/signout`, {
-            method: 'POST',
-            credentials: 'include'
-        });
-        if (typeof window !== 'undefined') {
-            window.location.href = options.callbackUrl || '/';
-        }
-    }
-    catch (error) {
-        console.error('[hweb-auth] Error on signOut:', error);
-    }
-}

package/dist/auth/components.d.ts

@@ -1,29 +0,0 @@
-import React, { ReactNode } from 'react';
-interface ProtectedRouteProps {
-    children: ReactNode;
-    fallback?: ReactNode;
-    redirectTo?: string;
-    requireAuth?: boolean;
-}
-/**
- * Componente para proteger rotas que requerem autenticação
- */
-export declare function ProtectedRoute({ children, fallback, redirectTo, requireAuth }: ProtectedRouteProps): string | number | bigint | true | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null;
-interface GuardProps {
-    children: ReactNode;
-    fallback?: ReactNode;
-    redirectTo?: string;
-}
-/**
- * Guard simples que só renderiza children se estiver autenticado
- */
-export declare function AuthGuard({ children, fallback, redirectTo }: GuardProps): string | number | bigint | true | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null;
-/**
- * Componente para mostrar conteúdo apenas para usuários não autenticados
- */
-export declare function GuestOnly({ children, fallback, redirectTo }: GuardProps): string | number | bigint | true | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element;
-/**
- * Hook para redirecionar baseado no status de autenticação
- */
-export declare function useAuthRedirect(authenticatedRedirect?: string, unauthenticatedRedirect?: string): void;
-export {};

package/dist/auth/components.js

@@ -1,100 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ProtectedRoute = ProtectedRoute;
-exports.AuthGuard = AuthGuard;
-exports.GuestOnly = GuestOnly;
-exports.useAuthRedirect = useAuthRedirect;
-const jsx_runtime_1 = require("react/jsx-runtime");
-/*
- * This file is part of the HightJS Project.
- * Copyright (c) 2025 itsmuzin
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-const react_1 = __importDefault(require("react"));
-const react_2 = require("./react");
-const clientRouter_1 = require("../client/clientRouter");
-/**
- * Componente para proteger rotas que requerem autenticação
- */
-function ProtectedRoute({ children, fallback, redirectTo = '/auth/signin', requireAuth = true }) {
-    const { isAuthenticated, isLoading } = (0, react_2.useAuth)();
-    // Ainda carregando
-    if (isLoading) {
-        return fallback || (0, jsx_runtime_1.jsx)("div", { children: "Loading..." });
-    }
-    // Requer auth mas não está autenticado
-    if (requireAuth && !isAuthenticated) {
-        if (typeof window !== 'undefined' && redirectTo) {
-            window.location.href = redirectTo;
-            return null;
-        }
-        return fallback || (0, jsx_runtime_1.jsx)("div", { children: "Unauthorized" });
-    }
-    // Não requer auth mas está autenticado (ex: página de login)
-    if (!requireAuth && isAuthenticated && redirectTo) {
-        if (typeof window !== 'undefined') {
-            window.location.href = redirectTo;
-            return null;
-        }
-    }
-    return (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: children });
-}
-/**
- * Guard simples que só renderiza children se estiver autenticado
- */
-function AuthGuard({ children, fallback, redirectTo }) {
-    const { isAuthenticated, isLoading } = (0, react_2.useAuth)();
-    if (redirectTo && !isLoading && !isAuthenticated) {
-        clientRouter_1.router.push(redirectTo);
-    }
-    if (isLoading) {
-        return fallback || (0, jsx_runtime_1.jsx)("div", {});
-    }
-    if (!isAuthenticated) {
-        return fallback || null;
-    }
-    return (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: children });
-}
-/**
- * Componente para mostrar conteúdo apenas para usuários não autenticados
- */
-function GuestOnly({ children, fallback, redirectTo }) {
-    const { isAuthenticated, isLoading } = (0, react_2.useAuth)();
-    if (redirectTo && !isLoading && isAuthenticated) {
-        clientRouter_1.router.push(redirectTo);
-    }
-    if (isLoading || isAuthenticated) {
-        return fallback || (0, jsx_runtime_1.jsx)("div", {});
-    }
-    return (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: children });
-}
-/**
- * Hook para redirecionar baseado no status de autenticação
- */
-function useAuthRedirect(authenticatedRedirect, unauthenticatedRedirect) {
-    const { isAuthenticated, isLoading } = (0, react_2.useAuth)();
-    react_1.default.useEffect(() => {
-        if (isLoading)
-            return;
-        if (isAuthenticated && authenticatedRedirect) {
-            window.location.href = authenticatedRedirect;
-        }
-        else if (!isAuthenticated && unauthenticatedRedirect) {
-            window.location.href = unauthenticatedRedirect;
-        }
-    }, [isAuthenticated, isLoading, authenticatedRedirect, unauthenticatedRedirect]);
-}

package/dist/auth/core.d.ts

@@ -1,55 +0,0 @@
-import { HightJSRequest, HightJSResponse } from '../api/http';
-import type { AuthConfig, AuthProviderClass, Session } from './types';
-export declare class HWebAuth {
-    private config;
-    private sessionManager;
-    constructor(config: AuthConfig);
-    /**
-     * Middleware para adicionar autenticação às rotas
-     */
-    private middleware;
-    /**
-     * Autentica um usuário usando um provider específico
-     */
-    signIn(providerId: string, credentials: Record<string, string>): Promise<{
-        session: Session;
-        token: string;
-    } | {
-        redirectUrl: string;
-    } | null>;
-    /**
-     * Faz logout do usuário
-     */
-    signOut(req: HightJSRequest): Promise<HightJSResponse>;
-    /**
-     * Obtém a sessão atual
-     */
-    getSession(req: HightJSRequest): Promise<Session | null>;
-    /**
-     * Verifica se o usuário está autenticado
-     */
-    isAuthenticated(req: HightJSRequest): Promise<boolean>;
-    /**
-     * Retorna todos os providers disponíveis (dados públicos)
-     */
-    getProviders(): any[];
-    /**
-     * Busca um provider específico
-     */
-    getProvider(id: string): AuthProviderClass | null;
-    /**
-     * Retorna todas as rotas adicionais dos providers
-     */
-    getAllAdditionalRoutes(): Array<{
-        provider: string;
-        route: any;
-    }>;
-    /**
-     * Cria resposta com cookie de autenticação - Secure implementation
-     */
-    createAuthResponse(token: string, data: any): HightJSResponse;
-    /**
-     * Extrai token da requisição (cookie ou header)
-     */
-    private getTokenFromRequest;
-}