filegate

Monorepo basado en Turborepo para el servicio de subida de ficheros.

Workspaces

• apps/api: API Bun + TypeScript.
• apps/cli: CLI filegate / fg.
• apps/ui: UI estatic HTML/CSS/JS (sin framework).
• packages/sdk: SDK TypeScript generado desde OpenAPI.

Requisitos

• Bun >= 1.3

Comandos

• bun install
• bun run dev
• bun run lint
• bun run typecheck
• bun run test
• bun run openapi:validate
• bun run sdk:generate
• bun run check

Guías

• docs/CLI_API_GUIDE.md: guía práctica de CLI y API (list, show/get, pick, label, archive, curl).

API app

En apps/api puedes usar:

• bun run dev
• bun run start

En apps/cli puedes usar:

• bun run start -- help
• bun run start -- list --json
• bun run start -- pick <session-id> --dest ./data

En apps/ui puedes usar:

• bun run dev y abrir http://localhost:4300

Deploy/infrastructure:

• infra/filegate-api.service (systemd)
• infra/Caddyfile.example (proxy + static)
• infra/deploy-static.sh (subida con sf)

Variables de entorno (ver apps/api/.env.example):

• PORT
• INBOX_PATH
• API_SECRET
• MAX_FILE_SIZE
• UNZIP_ENABLED
• ALLOWED_IPS
• TRUSTED_PROXY_IPS