hightjs 0.4.0 → 0.5.0

package/docs/integracoes.md

@@ -1,240 +0,0 @@
-# 🔌 Integrações
-
-O HightJS pode ser usado de três formas diferentes: **Native** (servidor próprio), **Express** ou **Fastify**.
-
----
-
-## 🚀 Native (Recomendado)
-
-O modo nativo não requer dependências extras e oferece todos os recursos do HightJS, incluindo **SSL integrado**.
-
-### Via CLI (Recomendado)
-
-A forma recomendada de iniciar o servidor Native é usando a CLI:
-
-**Desenvolvimento:**
-```bash
-npx hight dev
-```
-
-**Produção:**
-```bash
-npx hight start
-```
-
-**Com SSL:**
-```bash
-npx hight start --ssl -p 443
-```
-
-**Opções disponíveis:**
-- `--port` ou `-p`: Define a porta (padrão: 3000)
-- `--hostname` ou `-h`: Define o host (padrão: 0.0.0.0)
-- `--ssl`: Ativa HTTPS (requer certificados em `./certs/`)
-
-### Via Código (Alternativa)
-
-Se precisar de mais controle programático, você pode inicializar manualmente:
-
-**Básico:**
-```typescript
-import { app } from "hightjs";
-
-const hightApp = app({
-    port: 3000,
-    dev: true
-});
-
-hightApp.init();
-```
-
-**Com SSL:**
-```typescript
-import { app } from "hightjs";
-
-const hightApp = app({
-    port: 443,
-    dev: false,
-    ssl: {
-        redirectPort: 80,
-        key: "./certs/key.pem",
-        cert: "./certs/cert.pem"
-    }
-});
-
-hightApp.init();
-```
-
-**Estrutura de pastas para SSL:**
-```
-projeto/
-  certs/
-    cert.pem
-    key.pem
-  src/
-    ...
-```
-
-**Opções SSL:**
-- `key`: Caminho para o arquivo de chave privada
-- `cert`: Caminho para o arquivo de certificado
-- `redirectPort`: Porta HTTP que redirecionará para HTTPS (opcional)
-
----
-
-## 📦 Express
-
-Se você já tem um projeto Express ou prefere usar Express, pode integrar o HightJS facilmente.
-
-### Instalação
-
-```bash
-npm install express
-npm install --save-dev @types/express
-```
-
-### Uso
-
-```typescript
-import express from 'express';
-import { app } from "hightjs";
-
-const port = 3000;
-const dev = true;
-
-const expressApp = express();
-const hightApp = app({
-    framework: 'express',
-    port: port,
-    dev: dev
-});
-
-hightApp.integrate(expressApp);
-
-expressApp.listen(port, () => {
-    console.log(`Servidor rodando em http://localhost:${port}`);
-});
-```
-
-### Com middlewares Express
-
-Você pode adicionar middlewares Express normalmente antes da integração:
-
-```typescript
-import express from 'express';
-import { app } from "hightjs";
-import cors from 'cors';
-
-const expressApp = express();
-
-// Middlewares Express
-expressApp.use(cors());
-expressApp.use(express.json());
-
-const hightApp = app({
-    framework: 'express',
-    port: 3000,
-    dev: true
-});
-
-hightApp.integrate(expressApp);
-
-expressApp.listen(3000);
-```
-
----
-
-## ⚡ Fastify
-
-Para máxima performance, você pode usar Fastify como base.
-
-### Instalação
-
-```bash
-npm install fastify
-```
-
-### Uso
-
-```typescript
-import Fastify from 'fastify';
-import { app } from 'hightjs';
-
-const port = 3000;
-const dev = true;
-
-// Cria o servidor Fastify
-const fastifyApp = Fastify({
-    logger: dev // Ativa logs se estiver em modo dev
-});
-
-// Cria a instância do HightJS usando Fastify
-const hightApp = app({
-    framework: 'fastify',
-    port: port,
-    dev: dev
-});
-
-// Integra o Fastify ao HightJS
-hightApp.integrate(fastifyApp);
-
-// Inicia o servidor Fastify
-fastifyApp.listen({ port }, (err, address) => {
-    if (err) {
-        fastifyApp.log.error(err);
-        process.exit(1);
-    }
-    console.log(`Servidor rodando em ${address}`);
-});
-```
-
-### Com plugins Fastify
-
-Você pode registrar plugins Fastify antes da integração:
-
-```typescript
-import Fastify from 'fastify';
-import { app } from 'hightjs';
-import fastifyCors from '@fastify/cors';
-
-const fastifyApp = Fastify({ logger: true });
-
-// Registra plugins Fastify
-await fastifyApp.register(fastifyCors, {
-    origin: true
-});
-
-const hightApp = app({
-    framework: 'fastify',
-    port: 3000,
-    dev: true
-});
-
-hightApp.integrate(fastifyApp);
-
-fastifyApp.listen({ port: 3000 });
-```
-
----
-
-## 🤔 Qual escolher?
-
-| Framework | Vantagens | Use quando |
-|-----------|-----------|------------|
-| **Native** | SSL integrado, zero config, sem dependências extras | Projetos novos, quer simplicidade |
-| **Express** | Ecossistema gigante, muitos middlewares | Já usa Express, precisa de middlewares específicos |
-| **Fastify** | Máxima performance, validação schema | Precisa de alta performance, validação avançada |
-
----
-
-## ⚠️ Notas importantes
-
-1. **SSL só está disponível no modo Native**
-2. Ao usar Express/Fastify, você gerencia o servidor manualmente
-3. O HightJS se integra perfeitamente com qualquer framework escolhido
-4. Todos os recursos do HightJS funcionam em qualquer modo (rotas, WebSocket, auth, etc.)
-
----
-
-Voltar para a [documentação principal](./README.md)
-

package/docs/middlewares.md

@@ -1,73 +0,0 @@
-# 🧩 Middlewares
-
-Adicione middlewares:
-
-- Direto na rota: `middleware: [...]`
-- Arquivo `middleware.ts` na pasta (auto-carregado)
-
-## Interface
-
-```ts
-export type HightMiddleware = (
-  request: HightJSRequest,
-  params: { [key: string]: string },
-  next: () => Promise<HightJSResponse>
-) => Promise<HightJSResponse> | HightJSResponse;
-```
-
-## Exemplo por Pasta
-
-`src/backend/routes/middleware.ts`:
-
-```ts
-import {HightJSRequest, HightJSResponse} from 'hightjs';
-
-export async function log(
-    request: HightJSRequest,
-    params: { [key: string]: string },
-    next: () => Promise<HightJSResponse>
-): Promise<HightJSResponse> {
-
-    console.log('[API]', request.method, request.url);
-    return next();
-}
-
-
-export async function blockLegacy(
-    request: HightJSRequest,
-    params: { [key: string]: string },
-    next: () => Promise<HightJSResponse>
-): Promise<HightJSResponse> {
-    if (request.header('user-agent')?.includes('IE 8')) {
-        return HightJSResponse.json({ error: 'Navegador não suportado' }, {status: 400});
-    }
-    return next();
-}
-
-export default [log, blockLegacy];
-```
-
-## Exemplo por Rota
-
-```ts
-import {BackendRouteConfig, HightJSRequest, HightJSResponse} from 'hightjs';
-
-async function authCheck(
-    request: HightJSRequest,
-    params: { [key: string]: string },
-    next: () => Promise<HightJSResponse>
-): Promise<HightJSResponse> {
-    if(!request.header("authorization")) {
-        return HightJSResponse.json({ error: "Unauthorized" }, { status: 401 });
-    }
-    return next();
-}
-
-const route: BackendRouteConfig = {
-    pattern: '/secure/data',
-    middleware: [authCheck],
-    GET: async () => HightJSResponse.json({ secret: true })
-};
-export default route;
-```
-

package/docs/rotas-backend.md

@@ -1,45 +0,0 @@
-# 🌐 Rotas Backend
-
-Qualquer arquivo em `src/backend/routes` vira endpoint backend.  
-O _pattern_ pode ser qualquer caminho, não só `/api/...`!
-
-## Exemplo Simples
-
-`src/backend/routes/version.ts`:
-
-```ts
-import { HightJSRequest, HightJSResponse, BackendRouteConfig } from 'hightjs';
-
-const route: BackendRouteConfig = {
-  pattern: '/version',
-  GET: async (_req: HightJSRequest) => {
-    return HightJSResponse.json({
-      version: '1.0.0',
-      name: 'HightJS',
-      description: 'Framework web full-stack moderno para Node.js'
-    });
-  }
-};
-export default route;
-```
-
-## Suporte a Métodos
-
-Defina `GET`, `POST`, `PUT`, `DELETE` (ou só os necessários).
-
-## Rotas Dinâmicas Backend
-
-`src/backend/routes/users/[id].ts` → `/users/123`
-
-```ts
-import { BackendRouteConfig, HightJSResponse } from "hightjs";
-
-const route: BackendRouteConfig = {
-    pattern: '/users/[id]',
-    GET: async (req, params) => {
-        return HightJSResponse.json({ userId: params.id });
-    }
-};
-export default route;
-```
-

package/docs/rotas-frontend.md

@@ -1,66 +0,0 @@
-# 🖥️ Rotas Frontend
-
-Cada arquivo em `src/web/routes` é uma página.
-
-```tsx
-import { RouteConfig } from 'hightjs/client';
-import React from 'react';
-
-function Component() {
-  return <h1>HELLO WORLD</h1>;
-}
-
-const config: RouteConfig = {
-  pattern: '/thanks2',
-  component: Component,
-  generateMetadata: () => ({ title: 'HightJS | Thanks' })
-};
-export default config;
-```
-
-## Rotas Dinâmicas com Parâmetros
-
-```tsx
-import {RouteConfig} from "hightjs/client";
-import React from "react";
-
-function PostPage({ params }: { params: { id: string } }) {
-    const id = params.id
-    return (
-        <div>
-            <h1>Post ID: {id}</h1>
-            <p>This is the content of post {id}.</p>
-        </div>
-    );
-}
-
-const config: RouteConfig = {
-    pattern: '/post/[id]',
-    component: PostPage,
-    generateMetadata: async (params) => ({ title: `Post ${params.id}` })
-};
-export default config
-
-```
-
-## Layout Global
-
-`src/web/layout.tsx`:
-
-```tsx
-export const metadata = { title: 'Meu App', description: 'Descrição global' };
-export default function Layout({ children }: { children: React.ReactNode }) {
-  return <div>{children}</div>;
-}
-```
-
-## Página 404
-
-`src/web/notFound.tsx`:
-
-```tsx
-export default function NotFound() {
-  return <h1>Página não encontrada</h1>;
-}
-```
-

package/docs/seguranca.md

@@ -1,8 +0,0 @@
-# 🔐 Segurança Interna
-
-- Sanitização de headers, cookies e body
-- Limites de tamanho configuráveis
-- Proteção contra JSON malformado
-- Timeout de requisição / body parser nativo
-- JWT com HS256, verificação constant-time
-

package/docs/websocket.md

@@ -1,45 +0,0 @@
-# 🛜 WebSocket
-
-O HightJS possui suporte nativo a WebSockets nas rotas do backend.
-
-## Exemplo Prático
-
-`src/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;
-```
-

package/example/certs/cert.pem

@@ -1,20 +0,0 @@
------BEGIN CERTIFICATE-----
-MIIDSTCCAjGgAwIBAgIUEDNwk+twrH227ELWWT9Qn92kOzswDQYJKoZIhvcNAQEL
-BQAwNDELMAkGA1UEBhMCQlIxFTATBgNVBAgMDFPDg8KjbyBQYXVsbzEOMAwGA1UE
-CgwFSGlnaHQwHhcNMjUxMDI2MTY0NDM2WhcNMjYxMDI2MTY0NDM2WjA0MQswCQYD
-VQQGEwJCUjEVMBMGA1UECAwMU8ODwqNvIFBhdWxvMQ4wDAYDVQQKDAVIaWdodDCC
-ASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAL+jVQJ2GbyDOWs+KZ0Mlx1f
-E983vQQVoQpbh/Tzqo4NNGZHGEQF+AcuYiBJUqQAqKBP+aQIqr2u/PL4XUjLLUCo
-ZituhZhvWAMTgFjyc8crOSp3V4zveIQdOTWnJBUp49lgzS1ho4iwxxxfLNsEWo/d
-te98I0ac0kX9dNbtW8xlPwyfaH6ZPKlMlMUdxVkEnEZLnkAx+WoVfc2XH3naLN1F
-bZDCZyxOV/mfdqlZHXqidFMfRK3A3XK7iRNfowUZnj6Cgl9aP7jKQJpUVq1SUVGX
-ZWSMvBrFdizekgXfKnpS5Ha+Sk9bMOSQNo5k70+yLXPhzspYIY3MH8cMZM7EnTMC
-AwEAAaNTMFEwHQYDVR0OBBYEFIyUOMXBKUb/mFU7vYBSgNMGUJWeMB8GA1UdIwQY
-MBaAFIyUOMXBKUb/mFU7vYBSgNMGUJWeMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZI
-hvcNAQELBQADggEBAIHEMxHzdmaqAT2FaEB/KmNAqWIC31huZrVIdRyXS51Dbtnv
-a77YuwXgNmnKmk5/M9feE7mVu+bOAwusNdO9yHuFeuwLuFD4dK/Dx6jNAjeOC+jM
-EIXUK8cNdlnAhhmhs/ni1uxol0RSWz+5+1Vo7M5JgOs182oLSZu5uFKbCbfgijy2
-77nrNbTK79lq3nLnf1b103yRFkbTKphVdLY+QZGuBtGmoFoCDif3dwcTcPhCO6Sw
-HFxLKlqXtwrhY7r/VK4+Q83gQIZUkCY59RWRtG9TI8swauRfP0mGSoDlKVd+HiOY
-bNAA5cGXYqNgpYHaCiPkTBzwU4UroWtRasyDwXs=
------END CERTIFICATE-----

package/example/certs/key.pem

@@ -1,27 +0,0 @@
------BEGIN RSA PRIVATE KEY-----
-MIIEpAIBAAKCAQEAv6NVAnYZvIM5az4pnQyXHV8T3ze9BBWhCluH9POqjg00ZkcY
-RAX4By5iIElSpACooE/5pAiqva788vhdSMstQKhmK26FmG9YAxOAWPJzxys5KndX
-jO94hB05NackFSnj2WDNLWGjiLDHHF8s2wRaj92173wjRpzSRf101u1bzGU/DJ9o
-fpk8qUyUxR3FWQScRkueQDH5ahV9zZcfedos3UVtkMJnLE5X+Z92qVkdeqJ0Ux9E
-rcDdcruJE1+jBRmePoKCX1o/uMpAmlRWrVJRUZdlZIy8GsV2LN6SBd8qelLkdr5K
-T1sw5JA2jmTvT7Itc+HOylghjcwfxwxkzsSdMwIDAQABAoIBAQCZDSRWq+XQFemk
-yefIQwbpcUbYrpZqDbApKoMB0h10B/3CdaNeqHm3mobKDGVRECmcp2LUbAuZJIlm
-r48pFQPWMOgwZbuSy9I52rhV0YVAGzgzv06QA613rjNDs3Jw6JzNvq7/QIywHadX
-9HdJkEeXwNWOJ9GwkoypU0yeXsFDEnEGSDdeHCBDoxzxyqZJ2DHHj9f6oZrIq6sg
-8f9QBziu4y6IDDfhqynScN7nD3JEiyyd8k6Poh0EMo6zdLXeNbDKKP3FA4BuJVkg
-aSUQFkh2YqJnaxB/cwHdQfZT2Znku4MbKPZ9c6BwVgoU4TI9eUjJ8g5UZXu42mW8
-sgd1XmKJAoGBAPonc7/eI/c4vkwAd83lUsq3stoU9fB+oUcTA/cgIuq+jWHOLSW6
-3etWICBXMyN+OoAsEP3y815JItlvypYsN2CJgoR8VbYmeMRaDOpTGQYCnjEArjPB
-QACD12/IamWj+ifAx/lyD8v60rhALW+5usj/P1SiNwCN5wLZUQGxs5p/AoGBAMQd
-zqNvkzKNQR21TqWqw9L/BK8CEag7qMiETvxNTMSTwuRi6o4ZscBIGcnbRBL6oiQl
-uw2qqfwgR/mqDQ8kN5bMIW6PkOvzb2W77VfkaZrVOyQr2a5f7lN5ypmOl+R3PTTc
-IZfa9f9wiK7kpeSDZcazN0AX6+oJqWaXcjAKLFtNAoGBAMpK+Tnh5GfaRVmkzz18
-A9XXdBUT+kc/wCB/6icAn/wBmMfNOYlXcnsLrPM6USqUu65G9H7I57IJptr7onKK
-00WILjoBajbhKaxvvh4IkSXhHBg4mqdT0fQYqjHFevUzA+r95Tl92fR0o89IZvYA
-1mIQuCAzBhO2rWgKYY3jLID1AoGAW5JzbxrlB2Cve/ixnWdsAnRzMmhr6DrbJ62n
-1+UcKFm6UbviO7HBrr+70uYgFiCTXv+DJPGAZ6qHEQuXB2/oyO/N2HsOty224TDr
-tPOBX/uantwey24dsTqYIDVVtSb8HFeBFA/4d2qLV+aJk3bLKgl6jeHdlS0nvTCP
-7+CAL60CgYBBjyUkX3Ok1k25caoiPWwALnzqEyj5yje2qFyV+2HODDFmkJtJ2nZW
-omUzfuugp5jPFt51EBj0nQsRV6y/3LUjmFx0ER3f9juyyVq33OlRRkzFZv6Tq3YE
-cmEZlNonQBPP/sGQGNas28NZLUzt3/8VDVcTRgpn5Q4O8vbaOJJpRg==
------END RSA PRIVATE KEY-----

package/example/hightjs.config.ts

@@ -1,87 +0,0 @@
-import type { HightConfig, HightConfigFunction } from 'hightjs';
-
-/**
- * HightJS Configuration File
- *
- * This file allows you to customize server settings for your HightJS application.
- * You can export either a static configuration object or a function that returns the configuration.
- *
- * In a real project, you would import from 'hightjs' instead:
- * import type { HightConfig, HightConfigFunction } from 'hightjs';
- */
-const hightConfig: HightConfigFunction = (phase, { defaultConfig }) => {
-    const config: HightConfig = {
-        /**
-         * Maximum number of HTTP headers allowed per request
-         * Default: 100
-         * Increase this if you need to support requests with many headers
-         */
-        maxHeadersCount: 100,
-
-        /**
-         * Timeout in milliseconds for receiving HTTP headers
-         * Default: 60000 (60 seconds)
-         */
-        headersTimeout: 60000,
-
-        /**
-         * Timeout in milliseconds for a complete request
-         * Default: 30000 (30 seconds)
-         */
-        requestTimeout: 30000,
-
-        /**
-         * General server timeout in milliseconds
-         * Default: 35000 (35 seconds)
-         */
-        serverTimeout: 35000,
-
-        /**
-         * Timeout per individual request in milliseconds
-         * Default: 30000 (30 seconds)
-         */
-        individualRequestTimeout: 30000,
-
-        /**
-         * Maximum URL length in characters
-         * Default: 2048
-         */
-        maxUrlLength: 2048,
-
-        /**
-         * Enable HTTP access logging (e.g., GET /api/users 200 15ms)
-         * Default: false
-         */
-        accessLogging: true,
-    };
-
-    // You can customize settings based on the phase
-    if (phase === 'development') {
-        // In development, you might want longer timeouts for debugging
-        config.requestTimeout = 60000;
-        config.individualRequestTimeout = 60000;
-    }
-
-    if (phase === 'production') {
-        // In production, you might want stricter limits
-        config.maxHeadersCount = 50;
-        config.maxUrlLength = 1024;
-    }
-
-    return config;
-};
-
-export default hightConfig;
-
-// You can also export a static object instead of a function:
-// const staticConfig: HightConfig = {
-//     maxHeadersCount: 100,
-//     headersTimeout: 60000,
-//     requestTimeout: 30000,
-//     serverTimeout: 35000,
-//     individualRequestTimeout: 30000,
-//     maxUrlLength: 2048,
-// };
-//
-// export default staticConfig;
-