aws-lambda-typescript

AWS Lambda TypeScript

Skill para desarrollo de funciones Lambda en TypeScript: handlers, bundling con esbuild, AWS SDK v3, Powertools, tipado estricto, manejo de errores, testing y mejores prácticas de rendimiento.

Principios fundamentales

• Un handler, una responsabilidad. Evitar Lambdas monolíticos.
• Separar lógica de negocio del handler. El handler solo parsea el evento, invoca la lógica y formatea la respuesta.
• Usar AWS Lambda Powertools para TypeScript: Logger, Tracer, Metrics, Idempotency, Parameters.
• AWS SDK v3 obligatorio (modular, tree-shakeable). Nunca usar SDK v2.
• Tipado estricto: strict: true en tsconfig, no usar any.
• Inicializar clientes AWS fuera del handler (reutilización en warm starts).

Estructura de proyecto recomendada

functions/
├── mi-funcion/
│   ├── handler.ts          # Entry point del Lambda
│   ├── service.ts          # Lógica de negocio
│   ├── repository.ts       # Acceso a datos
│   ├── types.ts            # Interfaces y tipos
│   └── errors.ts           # Errores custom
├── shared/
│   ├── middleware.ts
│   ├── constants.ts
│   └── types.ts
├── tests/
│   ├── unit/
│   │   ├── service.test.ts
│   │   └── handler.test.ts
│   └── integration/
│       └── api.test.ts
├── tsconfig.json
├── package.json
└── vitest.config.ts

Handler con Powertools (patrón recomendado)

import { Logger } from '@aws-lambda-powertools/logger';
import { Tracer } from '@aws-lambda-powertools/tracer';
import { Metrics, MetricUnit } from '@aws-lambda-powertools/metrics';
import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
import { DynamoDBDocumentClient, QueryCommand, PutCommand } from '@aws-sdk/lib-dynamodb';
import type { APIGatewayProxyEventV2, APIGatewayProxyResultV2, Context } from 'aws-lambda';

const logger = new Logger({ serviceName: 'mi-servicio' });
const tracer = new Tracer({ serviceName: 'mi-servicio' });
const metrics = new Metrics({ namespace: 'MiApp', serviceName: 'mi-servicio' });

// Clientes AWS fuera del handler (warm start reuse)
const ddbClient = tracer.captureAWSv3Client(new DynamoDBClient({}));
const docClient = DynamoDBDocumentClient.from(ddbClient);
const TABLE_NAME = process.env.TABLE_NAME!;

export const handler = async (
  event: APIGatewayProxyEventV2,
  context: Context
): Promise<APIGatewayProxyResultV2> => {
  logger.addContext(context);

  try {
    const method = event.requestContext.http.method;
    const path = event.rawPath;

    if (method === 'GET' && path === '/items') {
      return await listItems();
    }
    if (method === 'POST' && path === '/items') {
      return await createItem(JSON.parse(event.body ?? '{}'));
    }

    return { statusCode: 404, body: JSON.stringify({ error: { code: 'NOT_FOUND', message: 'Route not found' } }) };
  } catch (error) {
    logger.error('Unexpected error', { error });
    return { statusCode: 500, body: JSON.stringify({ error: { code: 'INTERNAL_ERROR', message: 'Internal server error' } }) };
  }
};