@riddance/aws-host/README.md

This is `@riddance/aws-host`, a TypeScript AWS Lambda host adapter for the Riddance serverless framework. It provides AWS-specific implementations for HTTP, event, timer, and context handling in Lambda functions by providing Lambda entry points that trans

# Project Overview

This is `@riddance/aws-host`, a TypeScript AWS Lambda host adapter for the Riddance serverless framework. It provides AWS-specific implementations for HTTP, event, timer, and context handling in Lambda functions by providing Lambda entry points that translate Lambda-specific idioms to Riddance idioms.

Though we depend on `@riddance/service` we do so to implement it, not to use it.

## Core Components

**Main Entry Points**:

- `context.ts` - Creates a Riddance context that establishes metadata, logging and event transport for Riddance functions based on what the Lambda runtime provides.
- `http.ts` - Handles events from AWS API Gateway, sends them to Riddance HTTP handler, and maps the response back to the gateway.
- `timer.ts` - Takes an EventBridge timer/scheduled event and forwards it to Riddance timer handler.
- `event.ts` - Takes an SNS event and forwards it to Riddance event handler.

**Supporting Infrastructure**:

- `lib/sns.ts` - Event transport that sends events emitted from Riddance handlers to SNS. Events sent this way are in turn handled by `events.ts`