Funções Serverless em TypeScript: AWS Lambda do A ao Z

Introdução às Funções Serverless em TypeScript com AWS Lambda

A arquitetura serverless tornou-se o padrão do desenvolvimento moderno em nuvem. O AWS Lambda permite executar código sem gerenciar servidores, e o TypeScript adiciona tipagem estrita e facilidade de desenvolvimento. Neste artigo, abordaremos todo o processo: desde a criação da primeira função até o deploy em produção. Você aprenderá a escrever funções serverless eficientes em TypeScript, trabalhar com triggers e tratar erros.

As funções serverless são ideais para microsserviços, processamento de eventos, webhooks e tarefas em segundo plano. O TypeScript torna o código mais seguro e previsível, o que é essencial para soluções em produção.

1. Configuração do ambiente para AWS Lambda em TypeScript

Antes de começar, instale as ferramentas necessárias. Você precisará do Node.js (versão 18+), npm e AWS CLI.

1.1. Instalação de dependências

npm init -y\nnpm install -D typescript @types/node @aws-sdk/client-lambda\nnpm install aws-lambda @types/aws-lambda\n

1.2. Configuração do TypeScript

Crie o arquivo tsconfig.json com as configurações para Lambda:

{\n  "compilerOptions": {\n    "target": "ES2020",\n    "module": "commonjs",\n    "lib": ["ES2020"],\n    "outDir": "./dist",\n    "rootDir": "./src",\n    "strict": true,\n    "esModuleInterop": true,\n    "skipLibCheck": true,\n    "forceConsistentCasingInFileNames": true,\n    "resolveJsonModule": true,\n    "declaration": true,\n    "declarationMap": true,\n    "sourceMap": true\n  },\n  "include": ["src/**/*"],\n  "exclude": ["node_modules", "dist"]\n}\n

1.3. Instalação do AWS CLI

Baixe e configure o AWS CLI a partir da fonte oficial. Após a instalação, execute:

aws configure\n

Insira seu Access Key ID, Secret Access Key, região (por exemplo, us-east-1) e formato de saída (json).

2. Criação da primeira função serverless em TypeScript

A estrutura do projeto deve ser assim:

my-lambda-project/\n├── src/\n│   └── handler.ts\n├── dist/\n├── tsconfig.json\n├── package.json\n└── .gitignore\n

2.1. Handler básico do Lambda

Crie o arquivo src/handler.ts com uma função simples:

import { Context, APIGatewayProxyEvent, APIGatewayProxyResult } from 'aws-lambda';\n\ninterface HelloResponse {\n  message: string;\n  timestamp: string;\n  eventType: string;\n}\n\nexport const handler = async (\n  event: APIGatewayProxyEvent,\n  context: Context\n): Promise<APIGatewayProxyResult> => {\n  console.log('Event:', JSON.stringify(event, null, 2));\n  console.log('Context:', context);\n\n  const response: HelloResponse = {\n    message: 'Hello from AWS Lambda with TypeScript!',\n    timestamp: new Date().toISOString(),\n    eventType: event.httpMethod || 'UNKNOWN'\n  };\n\n  return {\n    statusCode: 200,\n    headers: {\n      'Content-Type': 'application/json',\n      'Access-Control-Allow-Origin': '*'\n    },\n    body: JSON.stringify(response)\n  };\n};\n

2.2. Compilação do TypeScript

Adicione scripts ao package.json:

"scripts": {\n  "build": "tsc",\n  "watch": "tsc --watch",\n  "clean": "rm -rf dist"\n}\n

Execute a compilação:

npm run build\n

Verifique se o arquivo handler.js foi criado na pasta dist.

3. Deploy da função Lambda na AWS

Existem várias formas de fazer deploy. Vamos considerar a mais simples — via AWS CLI.

3.1. Empacotamento da função

Crie um arquivo ZIP com o código:

cd dist\nzip -r ../function.zip .\ncd ..\n

3.2. Criação da função Lambda

Execute o comando AWS CLI:

aws lambda create-function \\\n  --function-name hello-typescript \\\n  --runtime nodejs18.x \\\n  --role arn:aws:iam::Y