hightjs 0.3.5 → 0.5.0

package/docs/autenticacao.md

@@ -1,212 +0,0 @@
-# 🔐 Autenticação (HightJS/auth)
-
-Autenticação JWT embutida, fácil de configurar.  
-O jeito recomendado é criar as rotas diretamente no `auth.ts` e importar onde quiser.
-
-## Configuração Básica & Rotas
-
-`src/auth.ts`:
-
-```ts
-import { CredentialsProvider, DiscordProvider, createAuthRoutes } from 'hightjs/auth';
-import type { AuthConfig } from 'hightjs/auth';
-
-export const authConfig: AuthConfig = {
-    providers: [
-        new CredentialsProvider({
-            id: 'credentials',
-            name: 'Credentials',
-            credentials: {
-                username: { label: 'Username', type: 'text', placeholder: 'Digite seu usuário' },
-                password: { label: 'Password', type: 'password', placeholder: 'Digite sua senha' }
-            },
-            async authorize(credentials) {
-                if (credentials.username === 'admin' && credentials.password === 'admin') {
-                    return {
-                        id: '1',
-                        username: 'admin',
-                        email: 'admin@test.com',
-                        name: 'Administrador',
-                        testeeee: 'sdondsfndsfndsfodsfo'
-                    };
-                }
-                return null;
-            }
-        }),
-        new DiscordProvider({
-            clientId: "ID",
-            clientSecret: "TOKEN",
-            callbackUrl: "http://localhost:3000/api/auth/callback/discord",
-            scope: ['identify', 'email', 'guilds'],
-            successUrl: "http://localhost:3000/"
-        })
-    ],
-    session: {
-        strategy: 'jwt',
-        maxAge: 24 * 60 * 60, // 24 horas
-    },
-    pages: {
-        signIn: '/login',
-        signOut: '/'
-    },
-    secret: 'hweb-test-secret-key-change-in-production'
-};
-
-// Cria as rotas de autenticação automaticamente
-export const authRoutes = createAuthRoutes(authConfig);
-```
-
-## Exportando as rotas
-
-`src/web/backend/routes/auth.ts`:
-
-```ts
-import { authRoutes } from "../../../auth";
-export default authRoutes;
-```
-
-## Configurando o Frontend
-
-Para usar autenticação no frontend, você precisa configurar o `SessionProvider` no layout:
-
-`src/web/layout.tsx`:
-
-```tsx
-import { SessionProvider } from 'hightjs/auth/react';
-
-export const metadata = { title: 'Meu App', descrição: 'Descrição global' };
-
-export default function Layout({ children }: { children: React.ReactNode }) {
-  return (
-    <SessionProvider>
-      {children}
-    </SessionProvider>
-  );
-}
-```
-
-## Fazendo Login no Frontend
-
-Exemplo de como implementar login com credenciais e Discord:
-
-```tsx
-import { useSession } from 'hightjs/auth/react';
-import React, { useState } from 'react';
-
-function LoginPage() {
-    const { signIn } = useSession();
-    const [username, setUsername] = useState('');
-    const [password, setPassword] = useState('');
-    const [isLoading, setIsLoading] = useState(false);
-    const [error, setError] = useState<string | null>(null);
-
-    const handleDiscordLogin = async () => {
-        await signIn('discord', { redirect: true });
-    }
-
-    const handleLogin = async (e: React.FormEvent) => {
-        e.preventDefault();
-        setIsLoading(true);
-        setError(null);
-
-        try {
-            const result = await signIn('credentials', {
-                username: username,
-                password: password,
-                callbackUrl: '/'
-            });
-
-            if (!result || result.error) {
-                setError('Credenciais inválidas. Verifique seus dados e senha.');
-                setIsLoading(false);
-                return;
-            }
-            router.push("/")
-        } catch (err) {
-            setError('Ocorreu um erro inesperado. Tente novamente.');
-            setIsLoading(false);
-        }
-    };
-
-    return (
-        <div>
-            <form onSubmit={handleLogin}>
-                <input
-                    type="text"
-                    value={username}
-                    onChange={(e) => setUsername(e.target.value)}
-                    placeholder="Username"
-                />
-                <input
-                    type="password"
-                    value={password}
-                    onChange={(e) => setPassword(e.target.value)}
-                    placeholder="Password"
-                />
-                <button type="submit" disabled={isLoading}>Login</button>
-            </form>
-
-            <button onClick={handleDiscordLogin}>Login com Discord</button>
-
-            {error && <p style={{color: 'red'}}>{error}</p>}
-        </div>
-    );
-}
-```
-
-## Acessando Dados do Usuário
-
-Para acessar informações do usuário autenticado:
-
-```tsx
-import { useSession } from 'hightjs/auth/react';
-
-function UserProfile() {
-    const { data: session, status, signOut } = useSession();
-
-    if (status === 'loading') return <p>Carregando...</p>;
-
-    if (!session) return <p>Não autenticado</p>;
-
-    return (
-        <div>
-            <h1>Bem-vindo, {session.user?.name}</h1>
-            <p>Email: {session.user?.email}</p>
-            <button onClick={() => signOut()}>Logout</button>
-        </div>
-    );
-}
-```
-
-## Protegendo rotas backend
-
-```ts
-import { HightJSRequest } from "hightjs";
-import { BackendRouteConfig, HightJSResponse } from "hightjs";
-import { authRoutes } from "../../../../auth";
-
-const route: BackendRouteConfig = {
-    pattern: "/api/version",
-    GET: async (req: HightJSRequest, params: any) => {
-        const session = await authRoutes.auth.getSession(req)
-        if (!session) {
-            return HightJSResponse.json({ error: "Unauthorized" }, { status: 401 });
-        }
-        return HightJSResponse.json({
-            version: "1.0.0",
-            name: "HightJS",
-            description: "Um framework web full-stack moderno para Node.js",
-        });
-    }
-}
-export default route;
-```
-
-## Métodos principais
-
-- `signIn()` - Fazer login (credenciais ou provider)
-- `signOut()` - Fazer logout
-- `useSession()` - Hook para acessar sessão no frontend
-- `authRoutes.auth.getSession()` - Verificar sessão no backend
-- `authRoutes.auth.isAuthenticated()` - Verificar se está autenticado
-

package/docs/checklist.md

@@ -1,9 +0,0 @@
-# ✅ Checklist Mental
-
-1. Precisa de página? Crie em `src/web/routes/...`
-2. Precisa de endpoint? Crie em `src/web/backend/routes/...`
-3. Precisa proteger? Use autenticação nas rotas
-4. Precisa middleware? `middleware.ts` ou `middleware: []` na rota
-5. Metadata? `generateMetadata` ou `metadata` no layout
-6. Deploy? `npx hight start`
-

package/docs/cli.md

@@ -1,72 +0,0 @@
-# 🛠️ CLI
-
-Comandos principais:
-
-| Comando           | Descrição            |
-|-------------------|----------------------|
-| `npx hight dev`   | Modo desenvolvimento |
-| `npx hight start` | Modo produção        |
-
-## Opções
-
-- `--port` ou `-p`      Porta (default 3000)
-- `--hostname` ou `-h`  Host (default 0.0.0.0)
-- `--framework`         Framework: native, express, fastify (default: native)
-- `--ssl`               Ativa HTTPS (requer certificados em `./certs/`)
-
-## Exemplos
-
-### Desenvolvimento básico
-
-```bash
-npx hight dev
-```
-
-### Produção com porta customizada
-
-```bash
-npx hight start -p 8080
-```
-
-### Com SSL (HTTPS)
-
-```bash
-npx hight start --ssl -p 443
-```
-
-**Requisitos para SSL:**
-- Modo Native (não funciona com Express/Fastify via CLI)
-- Pasta `./certs/` na raiz do projeto
-- Arquivos `cert.pem` e `key.pem` dentro de `./certs/`
-
-```
-projeto/
-  certs/
-    cert.pem
-    key.pem
-  src/
-    ...
-```
-
-### Com framework específico
-
-```bash
-# Usando Express
-npx hight dev --framework express
-
-# Usando Fastify
-npx hight dev --framework fastify
-```
-
----
-
-## 🔐 SSL Integrado
-
-O HightJS oferece suporte SSL nativo quando usando o adaptador Native. Para mais detalhes sobre integrações com Express e Fastify, consulte:
-
-👉 [**Guia de Integrações**](./integracoes.md)
-
----
-
-Voltar para a [documentação principal](./README.md)
-

package/docs/config.md

@@ -1,216 +0,0 @@
-# HightJS Configuration (hightjs.config.ts)
-
-O HightJS permite que você personalize as configurações do servidor através de um arquivo `hightjs.config.ts` (ou `.js`) na raiz do seu projeto.
-
-## 📝 Estrutura Básica
-
-### Opção 1: Função de Configuração (Recomendado)
-
-```typescript
-import type { HightConfig, HightConfigFunction } from 'hightjs';
-
-const hightConfig: HightConfigFunction = (phase, { defaultConfig }) => {
-    const config: HightConfig = {
-        maxHeadersCount: 100,
-        headersTimeout: 60000,
-        requestTimeout: 30000,
-        serverTimeout: 35000,
-        individualRequestTimeout: 30000,
-        maxUrlLength: 2048,
-    };
-
-    // Personalize baseado no ambiente
-    if (phase === 'development') {
-        config.requestTimeout = 60000;
-        config.individualRequestTimeout = 60000;
-    }
-
-    if (phase === 'production') {
-        config.maxHeadersCount = 50;
-        config.maxUrlLength = 1024;
-    }
-
-    return config;
-};
-
-export default hightConfig;
-```
-
-### Opção 2: Objeto Estático
-
-```typescript
-import type { HightConfig } from 'hightjs';
-
-const config: HightConfig = {
-    maxHeadersCount: 100,
-    headersTimeout: 60000,
-    requestTimeout: 30000,
-    serverTimeout: 35000,
-    individualRequestTimeout: 30000,
-    maxUrlLength: 2048,
-};
-
-export default config;
-```
-
-## ⚙️ Configurações Disponíveis
-
-| Propriedade | Tipo | Padrão | Descrição |
-|------------|------|--------|-----------|
-| `maxHeadersCount` | `number` | `100` | Número máximo de headers HTTP permitidos por requisição |
-| `headersTimeout` | `number` | `60000` | Timeout em ms para receber os headers HTTP |
-| `requestTimeout` | `number` | `30000` | Timeout em ms para uma requisição completa |
-| `serverTimeout` | `number` | `35000` | Timeout geral do servidor em ms |
-| `individualRequestTimeout` | `number` | `30000` | Timeout por requisição individual em ms |
-| `maxUrlLength` | `number` | `2048` | Tamanho máximo da URL em caracteres |
-| `accessLogging` | `boolean` | `false` | Habilita logs de acesso HTTP (ex: `GET /api/users 200 15ms`) |
-
-## 🎯 Casos de Uso
-
-### Habilitar Logs de Acesso
-
-```typescript
-const config: HightConfig = {
-    accessLogging: true, // Mostra: GET /api/users 200 15ms
-};
-```
-
-### Aumentar Timeouts para Debugging
-
-```typescript
-const config: HightConfig = {
-    requestTimeout: 120000, // 2 minutos
-    individualRequestTimeout: 120000,
-};
-```
-
-### Aumentar Limites para APIs com Muitos Headers
-
-```typescript
-const config: HightConfig = {
-    maxHeadersCount: 200, // Dobro do padrão
-};
-```
-
-### Configuração Rigorosa para Produção
-
-```typescript
-const hightConfig: HightConfigFunction = (phase) => {
-    if (phase === 'production') {
-        return {
-            maxHeadersCount: 50,
-            maxUrlLength: 1024,
-            requestTimeout: 15000, // Mais restritivo
-            individualRequestTimeout: 15000,
-        };
-    }
-    
-    // Valores padrão para desenvolvimento
-    return {};
-};
-```
-
-### Suporte a URLs Muito Longas
-
-```typescript
-const config: HightConfig = {
-    maxUrlLength: 4096, // Dobro do padrão
-};
-```
-
-## 🔄 Hot Reload
-
-Em modo de desenvolvimento (`dev: true`), o arquivo de configuração é recarregado automaticamente quando modificado, permitindo ajustes sem reiniciar o servidor.
-
-## 📦 TypeScript vs JavaScript
-
-### TypeScript (Recomendado)
-- Arquivo: `hightjs.config.ts`
-- Benefícios: Autocomplete, validação de tipos, detecção de erros
-
-### JavaScript
-- Arquivo: `hightjs.config.js`
-- Use JSDoc para ter intellisense:
-
-```javascript
-/**
- * @type {import('hightjs').HightConfigFunction}
- */
-const hightConfig = (phase, { defaultConfig }) => {
-    /** @type {import('hightjs').HightConfig} */
-    const config = {
-        maxHeadersCount: 100,
-    };
-    
-    return config;
-};
-
-module.exports = hightConfig;
-```
-
-## 🚀 Exemplo Completo
-
-```typescript
-import type { HightConfig, HightConfigFunction } from 'hightjs';
-
-const hightConfig: HightConfigFunction = (phase, { defaultConfig }) => {
-    // Começa com valores padrão
-    const config: HightConfig = { ...defaultConfig };
-
-    // Configurações comuns
-    config.maxHeadersCount = 150;
-
-    // Ajustes por ambiente
-    if (phase === 'development') {
-        // Habilita logs de acesso em dev
-        config.accessLogging = true;
-        
-        // Timeouts maiores para debugging
-        config.requestTimeout = 120000;
-        config.individualRequestTimeout = 120000;
-        
-        // URLs longas para testes
-        config.maxUrlLength = 4096;
-    } else if (phase === 'production') {
-        // Logs de acesso também podem ser úteis em produção
-        config.accessLogging = true;
-        
-        // Mais restritivo em produção
-        config.maxHeadersCount = 50;
-        config.maxUrlLength = 1024;
-        config.requestTimeout = 20000;
-        config.individualRequestTimeout = 20000;
-        
-        // Timeouts mais curtos para headers
-        config.headersTimeout = 30000;
-        config.serverTimeout = 25000;
-    }
-
-    return config;
-};
-
-export default hightConfig;
-```
-
-## 📍 Localização do Arquivo
-
-O arquivo `hightjs.config.ts` (ou `.js`) deve estar na **raiz do seu projeto**, no mesmo nível do `package.json`.
-
-```
-seu-projeto/
-├── hightjs.config.ts  ← Aqui
-├── package.json
-├── tsconfig.json
-└── src/
-    └── web/
-        └── ...
-```
-
-## ⚠️ Notas Importantes
-
-1. **Prioridade**: `.ts` tem prioridade sobre `.js` se ambos existirem
-2. **Fallback**: Se o arquivo não existir, valores padrão serão usados
-3. **Validação**: Valores inválidos serão ignorados e substituídos pelos padrões
-4. **Performance**: Use valores apropriados para evitar timeouts desnecessários ou aberturas de segurança
-5. **Segurança**: Não exponha valores muito altos em produção (ex: `maxUrlLength` muito grande pode facilitar ataques DoS)
-

package/docs/estrutura.md

@@ -1,20 +0,0 @@
-# 📦 Estrutura Recomendada
-
-```
-src/
-  web/
-    layout.tsx              // Layout global (opcional)
-    notFound.tsx            // Página 404 customizada (opcional)
-    routes/
-      index.tsx             // Página inicial "/"
-      about.tsx             // Página "/about"
-      blog.tsx         // Rota dinâmica "/blog/123"
-    backend/
-      routes/
-        middleware.ts       // Middlewares globais da pasta
-        version.ts          // Endpoint "/version"
-        users/
-          middleware.ts     // Middlewares só desse grupo
-          list.ts           // Endpoint "/users/list"
-```
-

package/docs/faq.md

@@ -1,10 +0,0 @@
-# ❓ FAQ Rápido
-
-| Pergunta                       | Resposta                                            |
-|--------------------------------|-----------------------------------------------------|
-| Precisa Next/Vite?             | Não, bundler interno via esbuild.                   |
-| Dá para usar React 19?         | Sim (peer dependency).                              |
-| Tem SSR?                       | Atualmente só client-side hydration.                |
-| Posso usar CSS/SCSS?           | Import normal nos componentes.                      |
-| Rota de API conflita com página?| Não, rotas backend podem ser qualquer path.         |
-

package/docs/hot-reload.md

@@ -1,5 +0,0 @@
-# ♻️ Hot Reload
-
-Em modo dev, o cliente abre WebSocket `/hweb-hotreload/`.  
-Mudanças em rotas frontend ou backend recarregam automaticamente.
-