For the complete documentation index, see llms.txt. This page is also available as Markdown.

TypeScript

Guia completo para hospedar aplicações TypeScript na Discloud.

📁 Preparando os Arquivos

Antes de fazer o upload do seu projeto, você deve excluir arquivos desnecessários para otimizar o deploy.

❌ Arquivos a Excluir

Certifique-se de que os seguintes arquivos e diretórios não estejam incluídos no seu .zip:

- package-lock.json
- node_modules/
- .cache/
- .git/

📌 Use um arquivo .discloudignore para excluir esses arquivos automaticamente.

🔗 Precisa de ajuda para configurar o seu package.json ou encontrar o arquivo principal?

📦 Sobre a pasta dist (TypeScript: bot e site)

Em aplicações TypeScript, a pasta dist/ é reservada para a saída do BUILD da Discloud, tanto em TYPE=bot quanto em TYPE=site. Se você definir BUILD=... no seu discloud.config, a Discloud gera a pasta dist/ para você. Não comprima a dist/ nem envie arquivos para dentro dela.

⚙️ Build automático (recomendado)

  1. Adicione BUILD no discloud.config (ex.: BUILD=npm run build).

  2. Configure o tsconfig.json para gerar a saída em dist/ e adicione os scripts ao package.json.

  3. Executamos o BUILD antes do START e sua aplicação roda a partir da dist/.

Exemplo de discloud.config (bot):

TYPE=bot
MAIN=dist/index.js
BUILD=npm run build
START=npm run start
RAM=100
VERSION=latest
ID=meu-bot-ts

Exemplo de discloud.config (site):

TYPE=site
ID=meusite
MAIN=dist/index.js
BUILD=npm run build
START=npm run start
RAM=512
VERSION=latest

👜 Build feito localmente

  1. Gere a saída em build/ (não use dist/).

  2. Não inclua BUILD no discloud.config.

  3. Aponte o MAIN para o arquivo de entrada dentro da pasta build/.

Exemplo (bot):

TYPE=bot
MAIN=build/index.js
RAM=100
VERSION=latest
ID=meu-bot-ts

Exemplo (site):

TYPE=site
ID=meusite
MAIN=build/server.js
RAM=512
VERSION=latest

⚙️ Configuração do Projeto TypeScript

Normalmente você compila TypeScript para JavaScript com o tsc e executa os arquivos compilados.

package.json (scripts)

tsconfig.json (mínimo)

A Discloud instala as dependências definidas no seu projeto. Garanta que o typescript esteja presente (como devDependency já serve) para que a etapa de BUILD consiga executar o tsc.


🌐 Hospedando Sites e APIs com Express (TypeScript)

Antes de fazer o deploy do seu site ou API na Discloud, garanta que você atende aos seguintes requisitos:

Exemplo com Express (TS)

Instale as dependências do exemplo com npm i express e npm i -D @types/express @types/node.


✍️ Fazendo Deploy da Sua Aplicação

Uma vez que seu projeto esteja configurado e comprimido, você pode escolher um dos seguintes métodos de deploy na Discloud:


🔎 Resumo rápido das particularidades do TypeScript na Discloud

  • A dist/ é reservada para os builds da Discloud tanto em TYPE=bot quanto em TYPE=site.

  • Se você fizer o build localmente, gere a saída em build/ e aponte o MAIN para build/....

  • Em TypeScript, sempre defina BUILD e START no discloud.config quando enviar os arquivos-fonte; o MAIN deve apontar para o arquivo JS de entrada em execução (normalmente dist/index.js).

  • Em sites/APIs, seu servidor deve escutar na porta 8080.