1. Introdução
O PDF do documento está |AQUI|.
Os códigos do documento estão |AQUI|.
Este documento é um produto do Claude, a IA da Anthropic. Seu objetivo é transpor o documento [Introduction to the Python 3 Language and the Flask Web Framework Through Examples] de duas formas:
- a linguagem Python 3 é substituída pela linguagem TypeScript 6;
- o framework web Flask em Python é substituído pelo framework web NestJS;
O Claude, da Anthropic, fez a maior parte do trabalho (90%):
- geração do código. Partimos do código já escrito para o curso “Introdução à linguagem ECMASCRIPT 6 por meio de exemplos”. Em seguida, pedi ao Claude que ampliasse os scripts do curso para incluir o gerenciamento de banco de dados e depois construísse um serviço web com o framework NestJS;
- geração do curso em formato ODT. Aqui também, partimos do ODT do curso “Introdução à linguagem ECMASCRIPT 6 por meio de exemplos”. Em seguida, pedi ao Claude que incluísse todos os novos scripts que ele havia criado e que os comentasse.
Meu trabalho consistiu em duas coisas:
- testar o código;
- revisar o documento ODT. Em particular, acrescentei capturas de tela para ajudar o leitor;
Serge Tahé, setembro de 2026
==
A linguagem ECMAScript evoluiu significativamente desde 2019: o ECMAScript passou pelas edições de 2020 a 2026, e uma linguagem complementar, [TypeScript], firmou-se como a forma mais segura de escrever JavaScript em grande escala. Esta reescrita segue de perto a estrutura e a abordagem pedagógica do documento original “Introdução à linguagem ECMASCRIPT 6 por meio de exemplos”—um script, seu código, sua explicação linha por linha e sua execução—mas:
- todos os scripts agora são escritos em [TypeScript] em vez de JavaScript puro;
- as explicações abordam não só a sintaxe da linguagem, mas também seus tipos de dados e as diferenças em relação ao JavaScript;
- foram acrescentados novos capítulos para cobrir os recursos introduzidos entre 2020 e 2026: encadeamento opcional, classes com campos privados,
awaitno nível superior, Object.groupBy, Array.fromAsync e as últimas adições do ECMAScript 2026 (Math.sumPrecise, Iterator.concat, Error.isError...); - um capítulo é dedicado ao [Temporal], o sucessor moderno do objeto Date;
- as capturas de tela da execução no VSCode do documento original foram substituídas pela saída real e verificada de cada script, usando tsx no Node.js 26.
Como o documento original, este se refere a um servidor de cálculo de imposto escrito em PHP 7 (veja o curso “Introdução à linguagem PHP7 por meio de exemplos”). Os capítulos finais constroem, em TypeScript, um cliente para esse servidor—primeiro uma aplicação de console, estruturada em camadas com [UI, business, dao], e depois um cliente executado em um navegador com [webpack].
Este documento exige leitura ativa: para entender um script, é preciso ler seu código, seus comentários e o resultado real de sua execução.
1.1. Público-alvo e pré-requisitos
Este documento destina-se a iniciantes em TypeScript que já conhecem os fundamentos da programação (variáveis, laços, funções, estruturas condicionais) em outra linguagem. Não é necessário nenhum conhecimento prévio de JavaScript ou TypeScript.
1.2. Organização do projeto de exemplo
Todos os scripts apresentados neste documento pertencem a um único projeto do VSCode—a pasta typescript-fundamentals/ da estrutura de diretórios completa descrita abaixo—organizado em uma pasta por capítulo (basics, arrays, objects, strings, regexp, functions, exceptions, modules, async, http, classes, whats-new, ecmascript-2026, temporal, tax client). Cada script é um arquivo .ts que pode ser executado diretamente com o seguinte comando, a partir da raiz do projeto:
A partir dos capítulos sobre bancos de dados e NestJS, este projeto deixa de se limitar à pasta mencionada acima: ele passa a fazer parte de uma única estrutura de diretórios mais ampla, que inclui todos os scripts apresentados neste documento—fundamentos do TypeScript, acesso a bancos de dados, miniprojetos NestJS e estudos de caso. É essa estrutura de diretórios completa que o leitor baixa, e um único comando **npm install , executado a partir de sua raiz, instala tudo de uma só vez, graças aos [npm workspaces]**:
typescript-nestjs-course-scripts/
├── package.json
├── README.md
├── typescript-fundamentals/
│ ├── basics/ arrays/ objects/ strings/ regexp/ functions/
│ ├── exceptions/ modules/ async/ http/ classes/
│ └── whats-new/ ecmascript-2026/ temporal/ tax client/
├── typescript-databases/
│ ├── sql/
│ └── databases/ (mysql/ typeorm/ prisma/)
├── nestjs-course/
│ ├── hello-nest/
│ ├── actions-response/
│ ├── actions-model/
│ └── data-access/ (native-driver/ typeorm/ prisma/)
└── nestjs-case-study/
├── src/ (actions/ config/ entities/ filters/ model/ responses/ session/ utilities/)
└── views/
A finalidade de cada uma dessas pastas:
- typescript-fundamentals/ — os scripts dos capítulos sobre a linguagem (o descrito acima: basics, arrays, objects, functions, classes, async, exceptions, modules, novidades do ECMAScript, [Temporal], seguidos do cliente do servidor de cálculo de imposto);
- typescript-databases/ — os três capítulos sobre acesso a bancos de dados: o driver nativo mysql2, o ORM TypeORM e o ORM Prisma;
- nestjs-course/ — os miniprojetos NestJS dos capítulos sobre o framework: hello-nest (primeiro projeto), actions-response, actions-model e os trechos data-access que ilustram o NestJS combinado com o driver nativo, o TypeORM e o Prisma;
- nestjs-case-study/ — o projeto completo do capítulo “Estudo de caso”: a portabilidade para o NestJS do servidor PHP de cálculo de imposto.
O arquivo README.md na raiz segue essa estrutura; como observado acima, cada subpasta também contém seu próprio arquivo README.md, com suas instruções específicas de execução.