feat: Http Api lambda handler (#86)

* feat: initial version of `makeApiLambda`

* feat: implement fromHttpApi function

* refactor: improve namespacing and example, add changeset

* docs: missed jsdoc

* docs: fix docgen flaws

* test: cover 3 main event with tests

* feat: more performant and effect native implementation

* revert: back to initial implementation

Author: floydspace

.changeset/gorgeous-phones-sin.md

@@ -0,0 +1,26 @@
+---
+"@effect-aws/lambda": minor
+---
+
+add an option to make lambda handler from platform httpApi, for instance
+
+```ts
+import { LambdaHandler } from "@effect-aws/lambda"
+import { HttpApi, HttpApiBuilder, HttpServer } from "@effect/platform"
+import { Layer } from "effect"
+
+class MyApi extends HttpApi.make("api") {}
+
+const MyApiLive = HttpApiBuilder.api(MyApi)
+
+//              ┌─── Handler<LambdaEvent, LambdaResult>
+//              ▼
+export const handler = LambdaHandler.fromHttpApi(
+  Layer.mergeAll(
+    MyApiLive,
+    // you could also use NodeHttpServer.layerContext, depending on your
+    // server's platform
+    HttpServer.layerContext
+  )
+)
+```

.projenrc.ts

@@ -108,6 +108,7 @@ const lambda = new TypeScriptLibProject({
   description: "Effectful AWS Lambda handler",
   devDeps: [...effectDeps, "@types/aws-lambda"],
   peerDeps: commonPeerDeps,
+  addExamples: true,
 });
 
 new TypeScriptLibProject({

package.json

@@ -0,0 +1,73 @@
+import { LambdaHandler } from "@effect-aws/lambda";
+import {
+  FetchHttpClient,
+  HttpApi,
+  HttpApiBuilder,
+  HttpApiEndpoint,
+  HttpApiGroup,
+  HttpApiSchema,
+  HttpClient,
+  HttpClientResponse,
+  HttpServer,
+} from "@effect/platform";
+import { Effect, Layer, Schema } from "effect";
+
+const YahooResponse = Schema.Struct({
+  chart: Schema.Struct({
+    result: Schema.Array(Schema.Struct({
+      indicators: Schema.Struct({
+        quote: Schema.Array(Schema.Struct({
+          close: Schema.Array(Schema.Number),
+          high: Schema.Array(Schema.Number),
+          low: Schema.Array(Schema.Number),
+          open: Schema.Array(Schema.Number),
+          volume: Schema.Array(Schema.Number),
+        })),
+      }),
+      timestamp: Schema.Array(Schema.Number),
+    })),
+  }),
+});
+
+const symbolParam = HttpApiSchema.param("symbol", Schema.String);
+
+const getQuote = HttpApiEndpoint.get(
+  "getQuote",
+)`/quote/${symbolParam}`.addSuccess(YahooResponse);
+
+const quotesGroup = HttpApiGroup.make("quotes").add(getQuote);
+
+const MyApi = HttpApi.make("MyApi").add(quotesGroup);
+
+// Implement the "quotes" group
+const QuotesLive = HttpApiBuilder.group(
+  MyApi,
+  "quotes",
+  (handlers) =>
+    handlers.handle(
+      "getQuote",
+      ({ path }) =>
+        HttpClient.get(`https://query2.finance.yahoo.com/v8/finance/chart/${path.symbol}`, {
+          urlParams: { interval: "1d" },
+        }).pipe(
+          Effect.andThen(HttpClientResponse.schemaBodyJson(YahooResponse)),
+          Effect.orDie,
+        ),
+    ),
+);
+
+// Provide the implementation for the API
+const MyApiLive = HttpApiBuilder.api(MyApi).pipe(
+  Layer.provide(QuotesLive),
+  Layer.provide(FetchHttpClient.layer),
+);
+
+// Create the Lambda handler
+export const handler = LambdaHandler.fromHttpApi(
+  Layer.mergeAll(
+    MyApiLive,
+    // you could also use NodeHttpServer.layerContext, depending on your
+    // server's platform
+    HttpServer.layerContext,
+  ),
+);

packages/lambda/.gitattributes

@@ -0,0 +1,23 @@
+service: example-app
+frameworkVersion: "3"
+
+plugins: [serverless-esbuild]
+
+provider:
+  name: aws
+  runtime: nodejs22.x
+  region: eu-west-1
+
+custom:
+  esbuild:
+    packager: pnpm
+
+functions:
+  api:
+    handler: fromHttpApi.handler
+    layers:
+      - arn:aws:lambda:eu-west-1:580247275435:layer:LambdaInsightsExtension:53 # Needed for graceful shutdown
+    events:
+      - http:
+          path: /{proxy+} # This will match all paths on the API Gateway level, so routing is handled by Effect HttpApi
+          method: ANY