hightjs 0.3.0 → 0.3.2

package/README.md

@@ -1,10 +1,18 @@
-# HightJS
+<div align="center">
+  <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://repository-images.githubusercontent.com/1069175740/e5c59d3a-e1fd-446c-a89f-785ed08f6a16">
+      <img alt="Next.js logo" src="https://repository-images.githubusercontent.com/1069175740/e5c59d3a-e1fd-446c-a89f-785ed08f6a16" height="128">
+    </picture>
+  <h1>HightJS</h1>
 
-> Um framework web full‑stack moderno para Node.js, focado em simplicidade, DX e velocidade. Bundler via esbuild, hot reload, roteamento automático, APIs, autenticação JWT, CLI e muito mais.
+[![NPM](https://img.shields.io/npm/v/hightjs.svg?style=for-the-badge&labelColor=000000)](https://www.npmjs.com/package/hightjs)
+[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg?style=for-the-badge&labelColor=000000)](./LICENSE)
 
-<br>
 
-[![NPM](https://img.shields.io/npm/v/hightjs.svg?style=for-the-badge&labelColor=000000)](https://www.npmjs.com/package/hightjs)
+</div>
+
+> Um framework web full‑stack moderno para Node.js, focado em simplicidade, DX e velocidade. Bundler via esbuild, hot reload, roteamento automático, APIs, autenticação JWT, CLI e muito mais.
+---
 
 # Precisa de ajuda?
 Caso tenha alguma dúvida, entre em contato por uma das redes abaixo:
@@ -36,7 +44,7 @@ Caso tenha alguma dúvida, entre em contato por uma das redes abaixo:
 - **Layouts globais** e página 404 customizada
 - **Metadata** dinâmica por página
 - **Build inteligente** (single bundle ou chunks)
-- **Adapters**: Native, Express, Fastify
+- **SSL integrado** no modo Native (HTTPS out-of-the-box)
 - **Autenticação** JWT embutida (HWebAuth)
 - **CLI própria** (`hight`) para dev e produção
 - **Entrega de estáticos** (`public/`)
@@ -130,7 +138,7 @@ Documentação completa disponível na pasta `docs/`:
 ### Ferramentas e Configuração
 - [🛠️ CLI](./docs/cli.md)
 - [📂 Arquivos Especiais](./docs/arquivos-especiais.md)
-- [🧱 Adapters](./docs/adapters.md)
+- [🔌 Integrações](./docs/integracoes.md)
 - [🔐 Segurança Interna](./docs/seguranca.md)
 - [♻️ Hot Reload](./docs/hot-reload.md)
 

package/dist/builder.js

@@ -17,7 +17,7 @@
  */
 const esbuild = require('esbuild');
 const path = require('path');
-const Console = require("./api/console");
+const Console = require("./api/console").default;
 const fs = require('fs');
 // Lista de módulos nativos do Node.js para marcar como externos (apenas os built-ins do Node)
 const nodeBuiltIns = [

package/dist/hotReload.js

@@ -127,7 +127,6 @@ class HotReloadManager {
                 console_1.default.logWithout(console_1.Levels.ERROR, console_1.Colors.BgRed, `WebSocket error: ${error.message}`);
                 this.cleanupClient(ws);
             });
-            console_1.default.logWithout(console_1.Levels.INFO, console_1.Colors.BgRed, '🔌 Hot-reload cliente conectado');
         });
     }
     cleanupClient(ws) {

package/docs/README.md

@@ -17,7 +17,7 @@ Bem-vindo à documentação completa do HightJS!
 ### Ferramentas e Configuração
 - [🛠️ CLI](./cli.md) - Comandos e opções
 - [📂 Arquivos Especiais](./arquivos-especiais.md) - Arquivos com funções especiais
-- [🧱 Adapters](./adapters.md) - Native, Express, Fastify
+- [🔌 Integrações](./integracoes.md) - Como integrar com Express, Fastify e usar SSL
 - [🔐 Segurança Interna](./seguranca.md) - Proteções nativas
 - [♻️ Hot Reload](./hot-reload.md) - Desenvolvimento com recarregamento automático
 
@@ -49,7 +49,6 @@ Quando estiver confortável com o básico, explore:
 Consulte estas páginas quando precisar de informações específicas:
 
 - [Arquivos Especiais](./arquivos-especiais.md) - Todos os arquivos especiais do framework
-- [Adapters](./adapters.md) - Diferentes formas de executar seu app
 - [Segurança Interna](./seguranca.md) - Como o HightJS protege sua aplicação
 - [Hot Reload](./hot-reload.md) - Como funciona o recarregamento automático
 

package/docs/cli.md

@@ -9,12 +9,64 @@ Comandos principais:
 
 ## Opções
 
-- `--port`      Porta (default 3000)
-- `--hostname`  Host (default 0.0.0.0)
+- `--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/`)
 
-## Produção
+## 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/integracoes.md

@@ -0,0 +1,240 @@
+# 🔌 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/example/.hweb/entry.client.js

@@ -0,0 +1,24 @@
+// Arquivo gerado automaticamente pelo hweb
+import route0 from '../src/web/routes/index.tsx';
+import route1 from '../src/web/routes/login.tsx';
+import LayoutComponent from '../src/web/layout.tsx';
+
+import DefaultNotFound from '../node_modules/hightjs/src/client/DefaultNotFound.tsx';
+
+// Registra os componentes para o cliente
+window.__HWEB_COMPONENTS__ = {
+  'src/web/routes/index.tsx': route0.component || route0.default?.component,
+  'src/web/routes/login.tsx': route1.component || route1.default?.component,
+};
+
+// Registra o layout se existir
+window.__HWEB_LAYOUT__ = LayoutComponent.default || LayoutComponent;
+
+// Registra o notFound se existir
+window.__HWEB_NOT_FOUND__ = null;
+
+// Registra o DefaultNotFound do hweb
+window.__HWEB_DEFAULT_NOT_FOUND__ = DefaultNotFound;
+
+// Importa e executa o entry.client.tsx
+import '../node_modules/hightjs/src/client/entry.client.tsx';

package/example/certs/cert.pem

@@ -0,0 +1,20 @@
+-----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

@@ -0,0 +1,27 @@
+-----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-----