## Ephemeral Downloader

Um proxy de download efêmero para você usar a **sua VPS como ponte de alta velocidade** entre servidores lentos e a sua máquina local.

Em vez de baixar direto de um host congestionado, você aponta o link para o Ephemeral Downloader, que:

- Faz o download via VPS (geralmente com rota/peering melhor).
- Transmite o arquivo por **streaming** para o seu navegador.
- Libera os recursos assim que o download termina.

Simples, focado e pensado para quem vive baixando ISOs, ROMs e arquivos grandes.

---

## Como funciona (visão rápida)

- **Frontend (React + Vite)**

  - Interface SPA com campo de texto para múltiplos links (um por linha).
  - Lista de downloads recentes com:
    - Progresso em tempo real.
    - Tamanho total e já baixado.
    - Velocidade em **MB/s** e **Mbps**.
    - Botão para **retomar downloads** que falharam dentro da mesma sessão.

- **Backend (Fastify + Streams)**
  - Rota `GET /stream?url=...&offset=...` que:
    - Faz `HEAD` na origem para validar o link e obter `Content-Length`.
    - Faz `GET` (ou `Range: bytes=offset-` para retomada).
    - Faz o **streaming direto** para o cliente, sem guardar arquivo em disco.
  - Em produção, também serve o build do frontend (Vite) na própria porta do servidor.

---

## Requisitos

- Node.js **>= 20**
- `pnpm` **>= 8**

---

## Instalação

Clone o repositório e instale as dependências:

```bash
git clone <seu-fork-ou-repo> Downloader
cd Downloader
pnpm install
```

---

## Scripts principais

Na raiz do projeto:

- **Desenvolvimento (backend + frontend juntos)**:

```bash
pnpm dev
```

Isso sobe:

- Fastify em `http://localhost:3000`
- Vite em `http://localhost:5173`

- **Build de produção (server + web)**:

```bash
pnpm build
```

- **Start de produção (tudo pela porta 3000)**:

```bash
pnpm start
```

O servidor Fastify:

- Servirá o build do Vite na raiz (`/`).
- Continuará expondo `GET /stream` para o proxy de download.

---

## Configuração de ambiente

### Desenvolvimento

Por padrão o frontend conversa com o backend em:

```ts
const API_URL = import.meta.env.VITE_API_URL ?? "http://localhost:3000";
```

Se você mudar a porta ou rodar o backend em outro host, basta criar um arquivo `.env` dentro de `web/`:

```bash
VITE_API_URL=http://seu-backend:3000
```

### Produção (Nixpacks ou similar)

- Defina a variável `PORT` (a maioria das plataformas faz isso automaticamente).
- O servidor Fastify faz fallback para `3000` se `PORT` não estiver definida.
- O arquivo `nixpacks.toml` já descreve:
  - Comando de build: `pnpm build`
  - Comando de start: `pnpm start`

---

## Fluxo de uso típico

1. Você tem uma **VPS bem localizada** (por exemplo, no mesmo continente do servidor de origem).
2. No seu desktop/notebook, abre o Ephemeral Downloader.
3. Cola um ou mais links HTTP/HTTPS diretos (por exemplo, ROMs no SourceForge).
4. Clica em **“Iniciar download”**.
5. A VPS baixa em alta velocidade e o app:
   - Mostra o progresso.
   - Indica tamanho total / baixado.
   - Mostra velocidade agregada em MB/s e Mbps.
6. Se a conexão cair, você pode **retomar** dentro da mesma sessão.

---

## Limitações intencionais

- **Retomada entre sessões** (fechar aba / desligar máquina) **não é suportada**.
  - O projeto é focado em uso efêmero, sem manter arquivos em disco no servidor.
- O servidor realiza apenas:
  - Validação básica de URL (somente `http`/`https`).
  - Proxy por streaming com **backpressure** nativo do Node.js.
  - Nenhuma autenticação ou controle de cota por usuário (idealmente coloque atrás de VPN, auth reverso ou firewall).

---

## Ideias futuras

- Autenticação simples para restringir o painel.
- Limite de banda por IP/usuário.
- Modo “linha de comando” usando a mesma API do servidor.

---

## Por que esse projeto existe?

Porque às vezes o problema não é a sua internet nem o servidor de origem, e sim o **caminho entre eles**.

Colocando uma VPS no meio do caminho, você “puxa” o arquivo por uma rota melhor até a VPS e, de lá, faz o streaming até você com muito mais previsibilidade.

O Ephemeral Downloader encapsula essa ideia em uma interface simples, focada em quem só quer **colar o link, apertar um botão e acompanhar o progresso**.