hightjs 0.2.42 → 0.2.43

package/.idea/copilotDiffState.xml

@@ -0,0 +1,67 @@
+<?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/README.md

@@ -23,6 +23,7 @@ Caso tenha alguma dúvida, entre em contato por uma das redes abaixo:
 - [📦 Estrutura Recomendada](#-estrutura-recomendada)
 - [🖥️ Rotas Frontend (Páginas)](#-rotas-frontend)
 - [🌐 Rotas Backend (API)](#-rotas-backend)
+- [🛜 WebSocket](#-websocket)
 - [🧩 Middlewares](#-middlewares)
 - [🔐 Autenticação (HightJS/auth)](#-autenticação-hightjsauth)
 - [🛠️ CLI](#-cli)
@@ -38,6 +39,10 @@ Caso tenha alguma dúvida, entre em contato por uma das redes abaixo:
 ## ✨ Principais Recursos
 
 - **Roteamento automático** de páginas [`src/web/routes`] e APIs [`src/web/backend/routes`]
+- **React 19** com client-side hydration
+- **TypeScript** first (totalmente tipado)
+- **WebSockets** nativo nas rotas backend
+- **Rotas dinâmicas** com parâmetros (frontend e backend)
 - **Middlewares** por pasta ou rota
 - **Hot Reload** nativo (WebSocket interno) em dev
 - **Layouts globais** e página 404 customizada
@@ -257,6 +262,53 @@ export default route;
 
 ---
 
+## 🛜 WebSocket
+
+O HightJS possui suporte nativo a WebSockets nas rotas do backend.
+
+### Exemplo Prático
+
+`src/web/backend/routes/chat.ts`:
+
+```ts
+import {BackendRouteConfig, HightJSResponse} from 'hightjs';
+
+const route: BackendRouteConfig = {
+    pattern: '/api/chat',
+    GET: async () => {
+        return HightJSResponse.json({ message: 'Chat HTTP endpoint' });
+    },
+    WS: (ctx) => {
+        console.log('Nova conexão WebSocket no chat');
+
+        ctx.send({
+            type: 'welcome',
+            message: 'Bem-vindo ao chat!'
+        });
+
+        ctx.ws.on('message', (data) => {
+            const message = JSON.parse(data.toString());
+            console.log(message)
+            // Broadcast para todos exceto o remetente
+            ctx.broadcast({
+                type: 'message',
+                user: message.user,
+                text: message.text,
+                timestamp: new Date().toISOString()
+            });
+        });
+
+        ctx.ws.on('close', () => {
+            console.log('Cliente desconectado');
+        });
+    }
+};
+
+export default route;
+```
+
+---
+
 ## 🧩 Middlewares
 
 Adicione middlewares:

package/dist/auth/core.js

@@ -55,7 +55,7 @@ class HWebAuth {
             const sessionResult = this.sessionManager.createSession(user);
             // Callback de sessão se definido
             if (this.config.callbacks?.session) {
-                sessionResult.session = await this.config.callbacks.session(sessionResult.session, user);
+                sessionResult.session = await this.config.callbacks.session({ session: sessionResult.session, user, provider: providerId });
             }
             return sessionResult;
         }
@@ -86,7 +86,7 @@ class HWebAuth {
             .clearCookie('hweb-auth-token', {
             path: '/',
             httpOnly: true,
-            secure: true,
+            secure: this.config.secureCookies || false,
             sameSite: 'strict'
         });
     }
@@ -143,7 +143,7 @@ class HWebAuth {
             .json(data)
             .cookie('hweb-auth-token', token, {
             httpOnly: true,
-            secure: true, // Always secure, even in development
+            secure: this.config.secureCookies || false, // Always secure, even in development
             sameSite: 'strict', // Prevent CSRF attacks
             maxAge: (this.config.session?.maxAge || 86400) * 1000,
             path: '/',

package/dist/auth/index.d.ts

@@ -3,5 +3,5 @@ export * from './providers';
 export * from './core';
 export * from './routes';
 export * from './jwt';
-export { CredentialsProvider, DiscordProvider } from './providers';
+export { CredentialsProvider, DiscordProvider, GoogleProvider } from './providers';
 export { createAuthRoutes } from './routes';

package/dist/auth/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createAuthRoutes = exports.DiscordProvider = exports.CredentialsProvider = void 0;
+exports.createAuthRoutes = exports.GoogleProvider = exports.DiscordProvider = exports.CredentialsProvider = void 0;
 // Exportações principais do sistema de autenticação
 __exportStar(require("./types"), exports);
 __exportStar(require("./providers"), exports);
@@ -24,5 +24,6 @@ __exportStar(require("./jwt"), exports);
 var providers_1 = require("./providers");
 Object.defineProperty(exports, "CredentialsProvider", { enumerable: true, get: function () { return providers_1.CredentialsProvider; } });
 Object.defineProperty(exports, "DiscordProvider", { enumerable: true, get: function () { return providers_1.DiscordProvider; } });
+Object.defineProperty(exports, "GoogleProvider", { enumerable: true, get: function () { return providers_1.GoogleProvider; } });
 var routes_1 = require("./routes");
 Object.defineProperty(exports, "createAuthRoutes", { enumerable: true, get: function () { return routes_1.createAuthRoutes; } });

package/dist/auth/providers/google.d.ts

@@ -0,0 +1,63 @@
+import type { AuthProviderClass, AuthRoute, User } from '../types';
+export interface GoogleConfig {
+    id?: string;
+    name?: string;
+    clientId: string;
+    clientSecret: string;
+    callbackUrl?: string;
+    successUrl?: string;
+    scope?: string[];
+}
+/**
+ * Provider para autenticação com Google OAuth2
+ *
+ * Este provider permite autenticação usando Google OAuth2.
+ * Automaticamente gerencia o fluxo OAuth completo e rotas necessárias.
+ *
+ * Exemplo de uso:
+ * ```typescript
+ * new GoogleProvider({
+ * clientId: process.env.GOOGLE_CLIENT_ID!,
+ * clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
+ * callbackUrl: "http://localhost:3000/api/auth/callback/google"
+ * })
+ * ```
+ *
+ * Fluxo de autenticação:
+ * 1. GET /api/auth/signin/google - Gera URL e redireciona para Google
+ * 2. Google redireciona para /api/auth/callback/google com código
+ * 3. Provider troca código por token e busca dados do usuário
+ * 4. Retorna objeto User com dados do Google
+ */
+export declare class GoogleProvider implements AuthProviderClass {
+    readonly id: string;
+    readonly name: string;
+    readonly type: string;
+    private config;
+    private readonly defaultScope;
+    constructor(config: GoogleConfig);
+    /**
+     * Método para gerar URL OAuth (usado pelo handleSignIn)
+     */
+    handleOauth(credentials?: Record<string, string>): string;
+    /**
+     * Método principal - redireciona para OAuth ou processa o callback
+     */
+    handleSignIn(credentials: Record<string, string>): Promise<User | string | null>;
+    /**
+     * Processa o callback do OAuth (troca o código pelo usuário)
+     */
+    private processOAuthCallback;
+    /**
+     * Rotas adicionais específicas do Google OAuth
+     */
+    additionalRoutes: AuthRoute[];
+    /**
+     * Gera a URL de autorização do Google
+     */
+    getAuthorizationUrl(): string;
+    /**
+     * Retorna a configuração pública do provider
+     */
+    getConfig(): any;
+}

package/dist/auth/providers/google.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoogleProvider = void 0;
+const http_1 = require("../../api/http");
+/**
+ * Provider para autenticação com Google OAuth2
+ *
+ * Este provider permite autenticação usando Google OAuth2.
+ * Automaticamente gerencia o fluxo OAuth completo e rotas necessárias.
+ *
+ * Exemplo de uso:
+ * ```typescript
+ * new GoogleProvider({
+ * clientId: process.env.GOOGLE_CLIENT_ID!,
+ * clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
+ * callbackUrl: "http://localhost:3000/api/auth/callback/google"
+ * })
+ * ```
+ *
+ * Fluxo de autenticação:
+ * 1. GET /api/auth/signin/google - Gera URL e redireciona para Google
+ * 2. Google redireciona para /api/auth/callback/google com código
+ * 3. Provider troca código por token e busca dados do usuário
+ * 4. Retorna objeto User com dados do Google
+ */
+class GoogleProvider {
+    constructor(config) {
+        this.type = 'google';
+        this.defaultScope = [
+            'openid',
+            'https://www.googleapis.com/auth/userinfo.email',
+            'https://www.googleapis.com/auth/userinfo.profile'
+        ];
+        /**
+         * Rotas adicionais específicas do Google OAuth
+         */
+        this.additionalRoutes = [
+            // Rota de callback do Google
+            {
+                method: 'GET',
+                path: '/api/auth/callback/google',
+                handler: async (req, params) => {
+                    const url = new URL(req.url || '', 'http://localhost');
+                    const code = url.searchParams.get('code');
+                    if (!code) {
+                        return http_1.HightJSResponse.json({ error: 'Authorization code not provided' }, { status: 400 });
+                    }
+                    try {
+                        // Delega o 'code' para o endpoint de signin principal
+                        const authResponse = await fetch(`${req.headers.origin || 'http://localhost:3000'}/api/auth/signin`, {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json',
+                            },
+                            body: JSON.stringify({
+                                provider: this.id,
+                                code,
+                            })
+                        });
+                        if (authResponse.ok) {
+                            // Propaga o cookie de sessão e redireciona para a URL de sucesso
+                            const setCookieHeader = authResponse.headers.get('set-cookie');
+                            if (this.config.successUrl) {
+                                return http_1.HightJSResponse
+                                    .redirect(this.config.successUrl)
+                                    .header('Set-Cookie', setCookieHeader || '');
+                            }
+                            return http_1.HightJSResponse.json({ success: true })
+                                .header('Set-Cookie', setCookieHeader || '');
+                        }
+                        else {
+                            const errorText = await authResponse.text();
+                            console.error(`[${this.id} Provider] Session creation failed during callback. Status: ${authResponse.status}, Body: ${errorText}`);
+                            return http_1.HightJSResponse.json({ error: 'Session creation failed' }, { status: 500 });
+                        }
+                    }
+                    catch (error) {
+                        console.error(`[${this.id} Provider] Callback handler fetch error:`, error);
+                        return http_1.HightJSResponse.json({ error: 'Internal server error' }, { status: 500 });
+                    }
+                }
+            }
+        ];
+        this.config = config;
+        this.id = config.id || 'google';
+        this.name = config.name || 'Google';
+    }
+    /**
+     * Método para gerar URL OAuth (usado pelo handleSignIn)
+     */
+    handleOauth(credentials = {}) {
+        return this.getAuthorizationUrl();
+    }
+    /**
+     * Método principal - redireciona para OAuth ou processa o callback
+     */
+    async handleSignIn(credentials) {
+        // Se tem código, é o callback - processa a autenticação
+        if (credentials.code) {
+            return await this.processOAuthCallback(credentials);
+        }
+        // Se não tem código, é o início do OAuth - retorna a URL
+        return this.handleOauth(credentials);
+    }
+    /**
+     * Processa o callback do OAuth (troca o código pelo usuário)
+     */
+    async processOAuthCallback(credentials) {
+        try {
+            const { code } = credentials;
+            if (!code) {
+                throw new Error('Authorization code not provided');
+            }
+            // Troca o código por um access token
+            const tokenResponse = await fetch('https://oauth2.googleapis.com/token', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                },
+                body: new URLSearchParams({
+                    client_id: this.config.clientId,
+                    client_secret: this.config.clientSecret,
+                    grant_type: 'authorization_code',
+                    code,
+                    redirect_uri: this.config.callbackUrl || '',
+                }),
+            });
+            if (!tokenResponse.ok) {
+                const error = await tokenResponse.text();
+                throw new Error(`Failed to exchange code for token: ${error}`);
+            }
+            const tokens = await tokenResponse.json();
+            // Busca os dados do usuário com o access token
+            const userResponse = await fetch('https://www.googleapis.com/oauth2/v2/userinfo', {
+                headers: {
+                    'Authorization': `Bearer ${tokens.access_token}`,
+                },
+            });
+            if (!userResponse.ok) {
+                throw new Error('Failed to fetch user data');
+            }
+            const googleUser = await userResponse.json();
+            // Retorna o objeto User padronizado
+            return {
+                id: googleUser.id,
+                name: googleUser.name,
+                email: googleUser.email,
+                image: googleUser.picture || null,
+                provider: this.id,
+                providerId: googleUser.id,
+                accessToken: tokens.access_token,
+                refreshToken: tokens.refresh_token
+            };
+        }
+        catch (error) {
+            console.error(`[${this.id} Provider] Error during OAuth callback:`, error);
+            return null;
+        }
+    }
+    /**
+     * Gera a URL de autorização do Google
+     */
+    getAuthorizationUrl() {
+        const params = new URLSearchParams({
+            client_id: this.config.clientId,
+            redirect_uri: this.config.callbackUrl || '',
+            response_type: 'code',
+            scope: (this.config.scope || this.defaultScope).join(' ')
+        });
+        return `https://accounts.google.com/o/oauth2/v2/auth?${params.toString()}`;
+    }
+    /**
+     * Retorna a configuração pública do provider
+     */
+    getConfig() {
+        return {
+            id: this.id,
+            name: this.name,
+            type: this.type,
+            clientId: this.config.clientId, // Público
+            scope: this.config.scope || this.defaultScope,
+            callbackUrl: this.config.callbackUrl
+        };
+    }
+}
+exports.GoogleProvider = GoogleProvider;

package/dist/auth/providers.d.ts

@@ -1,2 +1,3 @@
 export { CredentialsProvider } from './providers/credentials';
 export { DiscordProvider } from './providers/discord';
+export { GoogleProvider } from './providers/google';

package/dist/auth/providers.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DiscordProvider = exports.CredentialsProvider = void 0;
+exports.GoogleProvider = exports.DiscordProvider = exports.CredentialsProvider = void 0;
 // Exportações dos providers
 var credentials_1 = require("./providers/credentials");
 Object.defineProperty(exports, "CredentialsProvider", { enumerable: true, get: function () { return credentials_1.CredentialsProvider; } });
 var discord_1 = require("./providers/discord");
 Object.defineProperty(exports, "DiscordProvider", { enumerable: true, get: function () { return discord_1.DiscordProvider; } });
+var google_1 = require("./providers/google");
+Object.defineProperty(exports, "GoogleProvider", { enumerable: true, get: function () { return google_1.GoogleProvider; } });

package/dist/auth/types.d.ts

@@ -48,7 +48,11 @@ export interface AuthConfig {
     };
     callbacks?: {
         signIn?: (user: User, account: any, profile: any) => boolean | Promise<boolean>;
-        session?: (session: Session, user: User) => Session | Promise<Session>;
+        session?: ({ session, user, provider }: {
+            session: Session;
+            user: User;
+            provider: string;
+        }) => Session | Promise<Session>;
         jwt?: (token: any, user: User, account: any, profile: any) => any | Promise<any>;
     };
     session?: {
@@ -58,12 +62,7 @@ export interface AuthConfig {
     };
     secret?: string;
     debug?: boolean;
-}
-export interface AuthProvider {
-    id: string;
-    name: string;
-    type: 'credentials';
-    authorize?: (credentials: Record<string, string>) => Promise<User | null> | User | null;
+    secureCookies?: boolean;
 }
 export interface CredentialsConfig {
     id?: string;

package/dist/client/entry.client.js

@@ -49,7 +49,17 @@ function App({ componentMap, routes, initialComponentPath, initialParams, layout
     const [params, setParams] = (0, react_1.useState)(initialParams);
     const findRouteForPath = (0, react_1.useCallback)((path) => {
         for (const route of routes) {
-            const regexPattern = route.pattern.replace(/\[(\w+)\]/g, '(?<$1>[^/]+)');
+            const regexPattern = route.pattern
+                // [[...param]] → opcional catch-all
+                .replace(/\[\[\.\.\.(\w+)\]\]/g, '(?<$1>.+)?')
+                // [...param] → obrigatório catch-all
+                .replace(/\[\.\.\.(\w+)\]/g, '(?<$1>.+)')
+                // /[[param]] → opcional com barra também opcional
+                .replace(/\/\[\[(\w+)\]\]/g, '(?:/(?<$1>[^/]+))?')
+                // [[param]] → segmento opcional (sem barra anterior)
+                .replace(/\[\[(\w+)\]\]/g, '(?<$1>[^/]+)?')
+                // [param] → segmento obrigatório
+                .replace(/\[(\w+)\]/g, '(?<$1>[^/]+)');
             const regex = new RegExp(`^${regexPattern}/?$`);
             const match = path.match(regex);
             if (match) {

package/dist/hightweb-global.js

@@ -0,0 +1 @@
+"use strict";

package/dist/hotReload.d.ts

@@ -4,14 +4,19 @@ export declare class HotReloadManager {
     private watchers;
     private projectDir;
     private clients;
-    private pingInterval;
     private backendApiChangeCallback;
     private frontendChangeCallback;
+    private isShuttingDown;
+    private debounceTimers;
+    private customHotReloadListener;
     constructor(projectDir: string);
     start(): Promise<void>;
     handleUpgrade(request: IncomingMessage, socket: any, head: Buffer): void;
     private setupWebSocketServer;
+    private cleanupClient;
     private setupWatchers;
+    private debounce;
+    private handleAnySrcChange;
     private notifyClients;
     private restartServer;
     stop(): void;
@@ -19,5 +24,7 @@ export declare class HotReloadManager {
     private clearBackendCache;
     onBackendApiChange(callback: () => void): void;
     onFrontendChange(callback: () => void): void;
+    setHotReloadListener(listener: (file: string) => Promise<void> | void): void;
+    removeHotReloadListener(): void;
     private checkFrontendBuild;
 }