@purecore/one-server-4-all 0.1.0

package/.hot-server-certs/localhost.crt

@@ -0,0 +1,22 @@
+-----BEGIN CERTIFICATE-----
+MIIDpzCCAo+gAwIBAgIUQGcKRF3OckjoSvSN0/r3ekJrErgwDQYJKoZIhvcNAQEL
+BQAwYzELMAkGA1UEBhMCQlIxCzAJBgNVBAgMAlNQMRIwEAYDVQQHDAlTYW8gUGF1
+bG8xETAPBgNVBAoMCFB1cmVjb3JlMQwwCgYDVQQLDANEZXYxEjAQBgNVBAMMCWxv
+Y2FsaG9zdDAeFw0yNTEyMjIwNjIyMTFaFw0yNjEyMjIwNjIyMTFaMGMxCzAJBgNV
+BAYTAkJSMQswCQYDVQQIDAJTUDESMBAGA1UEBwwJU2FvIFBhdWxvMREwDwYDVQQK
+DAhQdXJlY29yZTEMMAoGA1UECwwDRGV2MRIwEAYDVQQDDAlsb2NhbGhvc3QwggEi
+MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCZoirbFplbvBwbN9EzoT5O8Xqa
+LcrmM6t62O65rFQzFXzG3RzyTDEnuIFUObSndffUoUMCK0kwFQgFOPBHXs7kUsV1
+5QquX3tNN37NuC1k3rtY/lFomTCBinyz7qU5Mg7PuxxuNy48wlZeQWW5FHuLP7Jx
+SyxLI7pfQbmHOhSO/WOVz7ZAUu0jD3Ngl4RyJTJ/rB57kwRhIRPGRuk6IMOHHDCw
+srjn6GyAsRWwfJZRCet9uKP6PDiOMuwQPyT9gNof/nOanKp9Il+c0u8uZLStZK+Y
+WlaciZSNHZvD8RhGH1YAhNRHWIymgIv8OVYZR+llozQ4h8v6HzIle2Nx/S2pAgMB
+AAGjUzBRMB0GA1UdDgQWBBTiaJ8wHYBKq630kWT1wgagWTQF1TAfBgNVHSMEGDAW
+gBTiaJ8wHYBKq630kWT1wgagWTQF1TAPBgNVHRMBAf8EBTADAQH/MA0GCSqGSIb3
+DQEBCwUAA4IBAQCR3jM/ndvVNgB4KyZ24Z9Gf4U/G0bMhtaEqSOhYP2dSdS4pRbx
+EN+QdV5B0LDE2i7z5Xc6ILHphXsGbDQ/M+awYL002RF2GObESzjXAABxsSnzU4rd
+ZaGFSyLdYrl72G5Yy8vLOuCQpUYUYhy+RrAP2NEdot8YDUmhGiwy8xeQONkgGPnl
+kOUeDpRPloNTU+50HoxrNfwX3FBHq78PKk6nUql6Gqe6yUtVHHStVSHtmOAeaixk
+0h37v7LXqJ4NTP0TimI/mHpJs+cj6mLaLFqSb5txdS0h7UPRVrSFnqjNSmjOqFOY
+0kpWYGQimwSYyOQvx/z4DPoTF2B8wU+cOC7W
+-----END CERTIFICATE-----

package/.hot-server-certs/localhost.crt.bak.

@@ -0,0 +1,13 @@
+-----BEGIN CERTIFICATE-----
+MIICiTCCAg+gAwIBAgIJAJ8l4HnPq6F5MAOGA1UEBhMCQlIxCzAJBgNVBAgTAkNB
+MRYwFAYDVQQHEw1TYW4gRnJhbmNpc2NvMRowGAYDVQQKExFQdXJlY29yZSBEZXYx
+FjAUBgNVBAsMDURldmVsb3BtZW50MRowGAYDVQQDDBFsb2NhbGhvc3QgZGV2ZWxv
+cG1lbnQwHhcNMjQxMjIxMTQyMzU5WhcNMjUxMjIxMTQyMzU5WjCBjzELMAkGA1UE
+BhMCQlIxCzAJBgNVBAgTAkNBMRYwFAYDVQQHEw1TYW4gRnJhbmNpc2NvMRowGAYDV
+QQKExFQdXJlY29yZSBEZXYxFjAUBgNVBAsMDURldmVsb3BtZW50MRowGAYDVQQDDBFs
+b2NhbGhvc3QgZGV2ZWxvcG1lbnQwXDANBgkqhkiG9w0BAQEFAANLADBIAkEA4VZGp1QJ
+G6X8oUdXqj9J8ZJGgMtG8F8VJGgMtG8F8VJGgMtG8F8VJGgMtG8F8VJGgMtG8F8VJG
+gMtG8F8VJGwIDAQABMA0GCSqGSIb3DQEBBAUAA4GBAMnO5KjO8Q2VzZGgMtG8F8VJG
+gMtG8F8VJGgMtG8F8VJGgMtG8F8VJGgMtG8F8VJGgMtG8F8VJGgMtG8F8VJGgMtG8F
+8VJGgMtG8F8VJGgMtG8F8VJGgMtG8F8VJGgMtG8F8VJGgMtG8F8VJGgMtG8F8VJG
+-----END CERTIFICATE-----

package/.hot-server-certs/localhost.key

@@ -0,0 +1,28 @@
+-----BEGIN PRIVATE KEY-----
+MIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAAoIBAQCZoirbFplbvBwb
+N9EzoT5O8XqaLcrmM6t62O65rFQzFXzG3RzyTDEnuIFUObSndffUoUMCK0kwFQgF
+OPBHXs7kUsV15QquX3tNN37NuC1k3rtY/lFomTCBinyz7qU5Mg7PuxxuNy48wlZe
+QWW5FHuLP7JxSyxLI7pfQbmHOhSO/WOVz7ZAUu0jD3Ngl4RyJTJ/rB57kwRhIRPG
+Ruk6IMOHHDCwsrjn6GyAsRWwfJZRCet9uKP6PDiOMuwQPyT9gNof/nOanKp9Il+c
+0u8uZLStZK+YWlaciZSNHZvD8RhGH1YAhNRHWIymgIv8OVYZR+llozQ4h8v6HzIl
+e2Nx/S2pAgMBAAECggEAAg3KM2Fxtne22bMUMPreY9lJbR1nqXkhFbf9NwdKq24M
+v3X1OZTL5uCfU40RKgMtzpWKUibaRLXC0tO3ZtcUYgveO1AretuTMrhgH+enybOu
+d+Oh05fY6Eyod4QdM0s9uCwOSI0IBb1rsnHwplZaylpqgXu7fA2QMgelb3KeE8xF
+0whk3rvu5nCbVBr1471LxpncoX7wntmtUiESBQhOKTlvyvEtPUvHUpcm0zjFfseQ
+K5/gNU+FxAG42F36kL7EMu4hir2nQNmftxiT//y7m6E+BkzJJqZkoIOCKpxSrW4Q
+lNdK4FfHWBHRzcjmeiQM+898nZOo7wOIAv/TQBmcYQKBgQDIltgwvzaDLbK1k+jB
+tquvtEAl8KFA9XlOT0VVSjMackDSHvoCbO+x0q908UUQ45p0FBun5kmajqE7+r3u
+mz3ITuPJ3tRuYz2KlUNZR8oHZZ5WpWrKbSoN2CjtiR1L5uFGh6JidqM/zlnkhDQG
+aDcG8MNWBJjTHXt2nLkULgKZWQKBgQDEErtC2OpDjmEN0G3c/tXc+12mk3ZRtsZx
+Jrvtj6dhdBlRKfIfwAuQswN6kmLS5mjqNpJgboIcA2+kYvRQm4QCWKY7pbrHik00
+2khu7lYIaTveYPG8tSKWnjCyk+63rKBrhhHrQRE0YIg30kOuuRGYTg3efiJtWtPj
+T9yjrpJc0QKBgCVp/WkaQVC2dV7o98EqEVv0gwKQn4M+RiIVJxmBfYaxSOXoYTmS
+mCLS6WcmmXtM+MIt/fqTOadaczh8zHB1BFEYZeSBa54rZI80yBsfCM/YZHBE6mZX
+dkCe0QN9T7mYluxQ4Dj9Z/W+x4WYIxwO1DS3M7gXo2m9VgoJsXvSGSoBAoGAVBZc
+bNyuCu7ivJPoqeA4Q58hmLChC4ZBMIGWEtmKxQaPXPmKNwebbiD3mvdwnlXmJJvm
+xqhd8DmhBXTSpkcro/30vJvksHKljccXTUu1ZcILxOD6ix17ifCpncxHkkncOoCy
+6ptrD3VeteHc2O/RlenTlNmvVgqf2FqFm0TgzCECgYAetOdmEryd7bDD65q+NKyi
+IuvizPdHj2J1V1ZzlDoSGced9745/3DDfeFqCchZ04Yw8KXZA7jVAeAYz8/+FAXW
+Vbx7DGjzWaqrx6C/tJJOvl0iiXrWK0bZHWNH7YGQtvCy0KmtnhoWISw465pwosfo
+BxKdGQec74KAphdwGq9XbQ==
+-----END PRIVATE KEY-----

package/.hot-server-certs/localhost.key.bak.

@@ -0,0 +1,28 @@
+-----BEGIN PRIVATE KEY-----
+MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCfF3tGhiMe9Lfu
+I5Wa43hNdwOQhreo17JGMx0lUMxmOUxFSiYJReDlyiU0WlC1idZyGDFuEX0/K5oB
+hapSF3twOBRHlys90UDsJ7GEiNP515X5XdgKC4uZNY28f8oirVM8Zt1CIwim6J5b
+f9U/DXvmXyj7pviFhvgd8EDG+ir7h0lLbfmcuuQKCG/UhmevXfR4r5rs7HlAmXfl
+3zdR3I53nb/UeIFarlOVqowBxA/drqFPGmjaX44HjxXBz5k5daBXqlZtwVfBgJQ2
+wvBjaiNgy61bKay2JqKorYJdK8SQy4/kMyLshZuNxdt8Ff53M69V5p7mSWqWxqsP
+Lspj+dT/AgMBAAECggEATyP1uZ/5sakIJGlEP2A/1L1LIya5Dz95mi1MJud6PrHr
+LJ7VrBA8b+Muvcvd0WkHqgs576i4luegPXiaQSsYRztGb1SWeLJzKucWCjmsxWEG
+5J1X3qtenvECmI4zZiu1t9rt3zwhTjJysE63rJ2PEIsvDnzBrV72Z6I//xusrSGX
+EhCWF/MZS9td+3ojvsNDRiBsm8eHnhlDveUwTGIqcSqCJC/WexZPGNOTJPwHMXnh
+NREdXchs2GjjHjy/R+tbiQqG1jyjbL8bRCbuBd8v4K9sg6hoROm4axyWaBmVUJMk
+1nkIoosAxAMMlth1IeBWaxHKJj/gGjRJmHYhCn3jFQKBgQDSU5N35Fd1p1qb8fL9
+4IxX4XpZ5XXhCDATs8WHyYzoH+fC7vPMCmd4ays0NrFbjSht2P9zjtzphcGyal3Z
+T1bOoe7nu+LjPny+qQVeEKVWEoryA+pojkS40hpczqsN1LE8zUavqK5rGWVJ0QPS
+y7hxAIyuCEaEX4sWbpgtiOI1zQKBgQDBo6yxz9+YZ2ysdJkcxtAuqG5Ctj6rrngx
+xTAnXw0ND6ld3UMChNqrEamx8Tf6cb1Ctw3MT2cfdA8LsS6/uYpZrMuvFBdFF4//
+2j6x70j5vE1HQxc0MHkb2PY9ayrFHHzIVjQFJXJgtBvXEI0Ul8uyZYKLPr6txacO
+1Q1oYJZp+wKBgQDRTlCr+DW9JO070ZySX5rqfb2npn0Xk3FcugMyLTYnblDSob9G
+Z3gu0t+s11zKkgAQyOj2U86uKejnp4h7kMP/YBEC1exlXrL/fe6UfJY8wLk7PQBS
+SnpDPvrzLsv1OJukuVfFyWTBugUdX36hkRCcjAJz0lJyuy4MBcU1U0piZQKBgQCW
+Z2ND2Yp6/hpS+V3UFDivhPPfrV6QSzvgrKDyc8nXU0riNXJPCpIuPdHo/MvWI3I1
+16lIAITA0Yy+MCl3kc38SVML8jcA24Rl3kbEPnAYSkJcD6h+SQhIsQTSP+NApxfl
+I8/UD3n/0uWs7pYmYKE/N8lmDp5cqyFPS/zWDe/G8QKBgA7eC8xq0wFcAtsMSPsS
+FgOE6lr0NYhyk2v1/oWD2uGiyYaBTSR9St2MvlyhylPhFxNv5en2bn7//yy5cJ3w
+1U5jAFDHG5moOc3ENl0h2wb8/i9HoCrQu4QKZn1RShu+c0LO+ohET2x0NUItGSm0
+Y2hjIVhWtmss4zUUFeVfJQMb
+-----END PRIVATE KEY-----

package/APAGAR_cria.sh

@@ -0,0 +1,51 @@
+#!/bin/bash
+
+# Verifica se foram passados dois argumentos
+if [ "$#" -ne 2 ]; then
+    echo "Uso: $0 subdominio.com.br porta_servidor"
+    exit 1
+fi
+
+SUBDOMAIN=$1
+PORT=$2
+CONFIG_FILE="/etc/nginx/sites-available/$SUBDOMAIN"
+LINK_FILE="/etc/nginx/sites-enabled/$SUBDOMAIN"
+
+# Cria o arquivo de configuração Nginx
+cat <<EOF | sudo tee $CONFIG_FILE
+server {
+    listen 80;
+    server_name $SUBDOMAIN;
+
+    location / {
+        proxy_pass http://127.0.0.1:$PORT;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade \$http_upgrade;
+        proxy_set_header Connection 'upgrade';
+        proxy_set_header Host \$host;
+        proxy_cache_bypass \$http_upgrade;
+    }
+}
+
+server {
+    listen 80;
+    server_name $SUBDOMAIN;
+
+    return 301 https://\$host\$request_uri;
+}
+EOF
+
+# Testa a configuração do Nginx
+sudo nginx -t
+
+# Se o teste for bem-sucedido, reinicia o Nginx e cria o link simbólico
+if [ $? -eq 0 ]; then
+    sudo ln -s $CONFIG_FILE $LINK_FILE
+    sudo systemctl reload nginx
+
+    # Emite o certificado SSL com o Certbot
+    sudo certbot --nginx -d $SUBDOMAIN -v
+else
+    echo "Erro na configuração do Nginx. Verifique os logs."
+    exit 1
+fi

package/CHANGELOG.md

@@ -0,0 +1,89 @@
+# Release v0.5.0
+
+### What's Changed
+
+- 🚀 Adicionado alias `hs` para execução rápida (`hs deploy` ou `hs`)
+- 📦 Atualização de versão para publicação
+
+---
+
+# Release v0.4.0
+
+### What's Changed
+
+- ✨ Introduzido comando `deploy` interativo com UI premium
+- 🔄 Geração automática de configuração Nginx e Certbot SSL
+- 🐳 Geração de comando PM2 otimizado para produção
+- 🗑️ Substituição do antigo script Shell `cria.sh` por implementação robusta em TypeScript
+
+---
+
+# Release v0.3.2
+
+### What's Changed
+
+- 🔧 Alterada porta padrão de `9999` para `6000`
+- 📝 Atualizado relatório de modificações
+
+---
+
+# Release v0.3.1
+
+### What's Changed
+
+- 🎨 Refatoração do log de inicialização para estilo Vite (Premium Look)
+- ⚡ Medição precisa do tempo de inicialização (Ready in X ms)
+- 🌐 Detecção e exibição automática de URLs de rede (Network IPs)
+- 🎨 Adição de cores ANSI para um visual moderno e "vibrante"
+- 🔧 Melhoria no tratamento de portas em uso com feedback visual
+- 📝 Atualização do `.gitignore` para incluir a pasta `dist`
+
+---
+
+# Release v0.3.0
+
+### What's Changed
+
+- 🔒 Adicionado suporte completo a HTTPS com certificados auto-assinados
+- 🛠️ Criado sistema de geração automática de certificados SSL
+- 🔓🔒 Adicionados emojis visuais de cadeado no terminal (aberto HTTP / fechado HTTPS)
+- 📊 Implementados logs detalhados de arquivos servidos
+- 🔍 Adicionado parsing e logging de recursos HTML (CSS, JS, imagens)
+- 📄 Logs mostram tamanho dos arquivos e tipos MIME
+- 🌐 Logs especiais para arquivos HTML injetados com hot-reload
+- 📝 Scripts npm para gerenciamento de certificados (`certs:generate`, `certs:clean`, `certs:info`)
+- 🔧 Arquivo `cert-generator.ts` para geração programática de certificados
+
+### New Contributors
+
+- [Jean Carlo Machado](https://github.com/jeanCarloMachado) - Implementação do suporte HTTPS e sistema de logs avançado
+
+---
+
+# Release v0.2.0
+
+### What's Changed
+
+- ✨ Adicionada injeção de CSS (CSS Hot Loading) - mudanças em arquivos CSS agora atualizam sem recarregar a página
+- ✨ Implementado suporte a SPA (Single Page Applications) com flag `--spa` - rotas inexistentes redirecionam para index.html
+- ✨ Expandida lista de MIME types - suporte completo para vídeos, fontes, áudios, manifestos e outros tipos de arquivo
+- ✨ Adicionados headers CORS - permite acesso cross-origin aos arquivos estáticos
+- 🔧 Mantida arquitetura zero dependencies - todas as implementações usam apenas APIs nativas do Node.js
+- 📝 Criado relatório detalhado em `/reports/21-12-2025_04-20.md`
+
+### New Contributors
+
+- [Jean Carlo](https://github.com/jeanCarloMachado) - Implementação das funcionalidades avançadas
+
+---
+
+# Release v0.1.0
+
+### What's Changed
+
+- ✨ Servidor HTTP básico com hot reload
+- ✨ Watcher de arquivos usando fs.watch nativo
+- ✨ Server-Sent Events para notificações em tempo real
+- ✨ Injeção automática de script em arquivos HTML
+- 🔧 Zero dependencies - apenas APIs nativas do Node.js
+- 📝 TypeScript estrito com configuração moderna

package/COMPARACAO_LIVE_SERVER.md

@@ -0,0 +1,101 @@
+# Comparativo: Purecore Hot Server vs Live Server
+
+Este documento analisa as diferenças técnicas e de funcionalidades entre a **Sua biblioteca (`purecore-hot-server`)** e a biblioteca padrão de mercado **[`live-server`](https://github.com/tapio/live-server)**.
+
+## 📊 Visão Geral
+
+| Feature | `live-server` (Tapio) | `purecore-hot-server` (Sua Lib) |
+| :--- | :--- | :--- |
+| **Dependências** | Múltiplas (`send`, `fsevents`, `opn`, `connect`...) | **Zero (0)** (Apenas nativas do Node.js) |
+| **Linguagem** | JavaScript | **TypeScript** |
+| **Hot Reload** | Full Page + **CSS Injection** (sem refresh) | Full Page + **CSS Injection** (sem refresh) |
+| **Watch System** | `chokidar` (geralmente) | `fs.watch` nativo (recursivo) |
+| **SPA Support** | Sim (redireciona 404 para index.html) | Sim (flag `--spa=true`) |
+| **Directory Listing** | Sim (mostra arquivos se não houver index) | Não (retorna erro/404) |
+| **HTTPS/Proxy** | Sim | HTTPS: Sim (flag `--https=true`) / Proxy: Não |
+| **Middleware** | Sim (baseado em Connect) | Não |
+| **Extensão `.html` opcional** | Não (depende do arquivo/rota) | Sim (fallback para servir `.html` quando a URL vier sem extensão) |
+| **Compatível com `npx`/`npm i -g`** | Sim | Sim (via build `dist/` e campo `bin` no `package.json`) |
+
+---
+
+## ✅ O que a sua lib tem de Diferencial (Vantagens)
+
+1. **Zero Dependencies (Zero Dependências)**:
+    * **Segurança/Auditabilidade**: Ao não usar dependências de terceiros, você elimina riscos de *supply chain attacks* e bloatware.
+    * **Instalação Instantânea**: `npm install` roda em milissegundos.
+    * **Tamanho**: O projeto final é minúsculo comparado ao `live-server` e suas árvores de dependência.
+
+2. **Base de Código Moderna (TypeScript + Node 20+)**:
+    * O código utiliza APIs modernas como `node:fs/promises`, `node:watch` (recursivo) e Typescript estrito.
+    * É muito mais fácil para um desenvolvedor TS ler, entender e modificar o seu código do que o código legado JS do `live-server`.
+
+3. **Simplicidade Arquitetural**:
+    * Sua implementação de SSE (Server-Sent Events) é direta e transparente (`/_hot_server_sse`), sem dependência de bibliotecas complexas de socket.
+    * Validação "Zod-like" interna (`validator.ts`) demonstra como fazer type-safety sem bibliotecas pesadas.
+
+---
+
+## ❌ O que falta na sua lib (Gaps em relação ao `live-server`)
+
+Para igualar a funcionalidade, você precisaria implementar:
+
+### 1. Injeção de CSS (CSS Hot Loading)
+
+* **O que é**: Quando um arquivo `.css` é salvo, o `live-server` atualiza apenas o estilo na página sem recarregar o navegador.
+* **Seu estado atual**: Implementado via SSE + troca de `href` com timestamp.
+* **Como implementar**: No script injetado, verificar se a mensagem do SSE é sobre um arquivo CSS e, nesse caso, buscar as tags `<link rel="stylesheet">` no DOM e forçar uma atualização do `href` (ex: `style.css?v=timestamp`) em vez de dar reload.
+
+### 2. Suporte a SPA (Single Page Applications)
+
+* **O que é**: Frameworks como React/Vue (via Router) precisam que qualquer rota desconhecida (ex: `/usuarios/1`) retorne o `index.html` para que o JS no front assuma o controle.
+* **Seu estado atual**: Implementado via flag `--spa=true` (fallback para `index.html` quando o arquivo não existe).
+
+### 3. Mime-Types Robustos
+
+* **Seu estado atual**: Implementado com lista expandida de tipos (vídeos, fontes, manifestos, etc).
+
+### 4. CORS
+
+* **Seu estado atual**: Implementado com headers `Access-Control-Allow-*` nas respostas.
+
+### 5. Directory e Range Requests
+
+* **O que falta**:
+  * **Listagem de pasta**: O `live-server` gera uma interface HTML listando os arquivos se você abrir uma pasta. O seu tenta abrir `index.html` e falha se não existir.
+  * **Range Requests**: Para fazer streaming de vídeo/áudio e permitir "pular" (seek) o vídeo, o servidor precisa suportar headers `Range` e `Content-Range`. O seu `createReadStream.pipe(res)` serve o arquivo inteiro, o que quebra alguns players de vídeo.
+
+---
+
+## 🔒 HTTPS (nota prática no WSL)
+
+O `purecore-hot-server` suporta HTTPS com certificados auto-assinados para desenvolvimento local.
+
+* **Gerar/limpar/inspecionar certs**:
+
+```bash
+bun run certs:clean
+bun run certs:generate
+bun run certs:info
+```
+
+* **Iniciar em HTTPS**:
+
+```bash
+bun run dev:https
+# equivalente:
+bun run src/index.ts --https=true
+```
+
+**Referências**:
+
+* Campo `bin` do npm (execução via `npx`/instalação global): `https://docs.npmjs.com/cli/v10/configuring-npm/package-json#bin`
+* Node.js ESM/CJS (impacta como o `dist/` roda no Node): `https://nodejs.org/api/packages.html`
+
+---
+
+## 📝 Conclusão
+
+Sua lib é excelente como uma **alternativa leve e moderna** para casos de uso simples (sites estáticos, prototipagem rápida, projetos vanilla). Ela ganha em performance de instalação e simplicidade de código.
+
+Ela perde para o `live-server` em **complexidade e robustez** para cenários avançados (SPAs, mocks de API, streaming de mídia e assets CSS pesados que se beneficiam da injeção sem reload).

package/README.md

@@ -0,0 +1,197 @@
+# Purecore Hot Server
+
+Um servidor de desenvolvimento hot-reload moderno e leve, construído com TypeScript e **zero dependências externas**.
+
+## ✨ Funcionalidades
+
+- 🚀 **Hot Reload Inteligente**: CSS injection sem recarregar página + full reload para outros arquivos
+- 🎯 **SPA Support**: Flag `--spa` para aplicações React/Vue/Angular
+- 📁 **MIME Types Robustos**: Suporte completo para vídeos, fontes, manifestos e mais
+- 🌐 **CORS Habilitado**: Acesso cross-origin para desenvolvimento
+- 🔒 **HTTPS Support**: Modo HTTPS com certificados auto-assinados
+- 📡 **Server-Sent Events**: Notificações em tempo real eficientes
+- 🔍 **Logs Detalhados**: Visualização de arquivos servidos e recursos HTML
+- 🔓🔒 **Indicadores Visuais**: Emojis de cadeado no terminal (aberto/fechado)
+
+## 🚀 Instalação
+
+```bash
+npm install -g hot-server
+# ou
+bun install -g hot-server
+```
+
+## 🔒 Modo HTTPS
+
+O Hot Server suporta HTTPS com certificados auto-assinados para desenvolvimento local.
+
+### Ativar HTTPS
+```bash
+# Via linha de comando
+hot-server --https=true
+
+# Via npm scripts
+npm run dev:https
+
+# Via bun
+bun run dev:https
+```
+
+### Gerenciamento de Certificados
+```bash
+# Gerar certificados auto-assinados
+npm run certs:generate
+
+# Ver informações dos certificados
+npm run certs:info
+
+# Limpar certificados existentes
+npm run certs:clean
+```
+
+**Nota**: Os certificados são salvos em `.hot-server-certs/` no diretório do projeto.
+
+## 📖 Uso Básico
+
+```bash
+# Na pasta do seu projeto
+hot-server
+
+# Com opções
+hot-server --port=3000 --spa=true
+```
+
+## 🎯 Funcionalidades Avançadas
+
+### CSS Hot Loading
+Quando você modifica arquivos `.css`, apenas o estilo é atualizado sem recarregar a página inteira.
+
+### SPA Support
+```bash
+hot-server --spa=true
+```
+Rotas inexistentes (como `/usuarios/1`) automaticamente servem `index.html`, permitindo que seu framework frontend assuma o roteamento.
+
+### MIME Types Suportados
+- **Vídeos**: MP4, WebM, OGG, AVI, MOV, WMV, FLV
+- **Áudios**: MP3, WAV, OGG, AAC, M4A, Opus
+- **Fontes**: WOFF, WOFF2, TTF, OTF, EOT
+- **Imagens**: PNG, JPG, GIF, SVG, WebP, BMP, TIFF
+- **Documentos**: PDF, CSV, YAML, TOML, TXT, MD
+- **Web**: JSON, XML, Manifest, WASM
+
+## 🔧 Opções de CLI
+
+| Opção | Descrição | Padrão |
+|-------|-----------|---------|
+| `--port=<number>` | Porta do servidor | `9999` |
+| `--root=<path>` | Diretório raiz | `.` (diretório atual) |
+| `--open=<true/false>` | Abrir navegador automaticamente | `true` |
+| `--spa=<true/false>` | Habilitar suporte SPA | `false` |
+| `--https=<true/false>` | Habilitar modo HTTPS | `false` |
+
+## 🏗️ Como foi feito
+
+Este projeto foi desenvolvido seguindo uma arquitetura minimalista e moderna:
+
+### Técnicas Utilizadas
+1. **TypeScript Estrito**: Tipagem forte em todo o código
+2. **APIs Nativas**: Uso exclusivo de módulos `node:*`
+3. **Server-Sent Events**: Comunicação bidirecional eficiente
+4. **File System Watch**: Monitoramento recursivo de mudanças
+5. **Mini-Zod**: Validação type-safe sem dependências
+6. **CSS Injection**: DOM manipulation para hot reload inteligente
+
+### Arquitetura
+```
+src/
+├── index.ts      # CLI e configuração
+├── server.ts     # Servidor HTTP e lógica principal
+├── watcher.ts    # Monitoramento de arquivos
+└── validator.ts  # Validação type-safe
+```
+
+### Funcionamento
+1. **Watcher** monitora mudanças recursivamente usando `fs.watch`
+2. **Server** serve arquivos estáticos com MIME types corretos
+3. **SSE** notifica clientes sobre mudanças em tempo real
+4. **CSS Injection** atualiza estilos sem recarregar página
+5. **SPA Fallback** redireciona 404 para index.html quando habilitado
+
+## 🧪 Como testar
+
+### Teste CSS Injection
+1. Inicie o servidor: `hot-server`
+2. Modifique qualquer arquivo `.css`
+3. Observe que apenas o CSS é atualizado, sem reload da página
+
+### Teste SPA Support
+1. Inicie com SPA: `hot-server --spa=true`
+2. Acesse `/qualquer-rota-inexistente`
+3. Deve carregar `index.html` em vez de 404
+
+### Teste MIME Types
+1. Adicione arquivos de vídeo/fonte no seu projeto
+2. Eles serão servidos com headers corretos
+
+### Teste CORS
+1. Acesse arquivos de outro domínio/origin
+2. Deve funcionar sem erros de CORS
+
+### Teste HTTPS
+1. Execute: `hot-server --https=true`
+2. Observe o emoji 🔒 no log do terminal
+3. Acesse https://localhost:9999
+4. Aceite o aviso de certificado auto-assinado
+
+### Teste Logs Detalhados
+1. Abra uma página HTML
+2. Observe no terminal:
+   - 📄 Arquivos servidos com tamanho e tipo MIME
+   - 🔍 Recursos encontrados no HTML (CSS, JS, imagens)
+   - 🌐 Confirmação de injeção do hot-reload
+
+## 📊 Comparação com Live Server
+
+| Feature           | Live Server | Purecore Hot Server |
+|-------------------|-------------|---------------------|
+| **Dependencies**  | Múltiplas   | ❌ Zero              |
+| **Language**      | JavaScript  | ✅ TypeScript        |
+| **CSS Injection** | ✅ Sim       | ✅ Sim               |
+| **SPA Support**   | ✅ Sim       | ✅ Sim               |
+| **MIME Types**    | Básicos     | ✅ Robustos          |
+| **CORS**          | ❌ Não       | ✅ Sim               |
+| **Installation**  | Lento       | ✅ Instantâneo       |
+
+## 🔍 Análise de Dependências Obsoletas
+
+Durante o desenvolvimento, analisamos dependências comuns em servidores de desenvolvimento e identificamos quais são desnecessárias no Node.js moderno:
+
+### ❌ Dependências Obsoletas
+- **`object-assign`**: Substituído por `Object.assign()` nativo
+- **`http-auth`**: Autenticação HTTP pode ser feita nativamente
+- **`colors`**: Node.js 20+ tem `util.styleText()` nativo
+- **`opn`**: `child_process` nativo abre URLs/arquivos
+- **`event-stream`**: ⚠️ Vulnerabilidade conhecida, usar streams nativos
+
+### ⚡ Alternativas Nativas Utilizadas
+- **File System**: `node:fs` com `fs.watch()` recursivo
+- **HTTP Server**: `node:http` e `node:https` nativos
+- **Crypto**: `node:crypto` para certificados HTTPS
+- **Path/URL**: `node:path` e `node:url` para manipulação
+- **Streams**: `node:stream` para Server-Sent Events
+
+### 🎯 Resultado
+**Zero dependências externas** = instalação instantânea, sem vulnerabilidades de terceiros, e compatibilidade garantida com futuras versões do Node.js.
+
+## 📝 Changelog
+
+Veja todas as mudanças em [CHANGELOG.md](CHANGELOG.md)
+
+## 🤝 Contribuição
+
+Contribuições são bem-vindas! Este projeto segue uma filosofia de **zero dependencies** e simplicidade arquitetural.
+
+## 📄 Licença
+
+MIT