feat: add lambda container image support

[k0nkupa]

Summary

Add first-class Lambda container-image support to ts-lambda-api.

This PR introduces native Lambda HTTP event support, adds a createHandler() API for exporting standard Lambda handlers, makes controller discovery recursive/deduplicated, and updates the README to document container-image deployment as a supported path.

Changes

• support native API Gateway v1, API Gateway v2, and ALB events in ApiLambdaApp
• add createHandler() for standard Lambda handler exports
• make controller discovery recursive and deduplicated
• update README with current AWS Lambda container-image guidance

Why

Container-image deployment itself was not the real problem. The friction came from missing package-level support, which forced downstream apps to manually reshape events and enumerate controller paths.

This PR moves that logic into the library and makes container-image usage a supported, tested path.

Validation

Ran successfully:

• yarn build
• yarn build-tests
• scripts/runTests.sh

Tests cover:

• API Gateway v1/v2 events
• ALB events
• createHandler()
• recursive controller loading
• duplicate path handling
• OpenAPI regressions

[k0nkupa]

Hey @djfdyuruiry, can you please have a look when you have time. Our team really like this package but it doesn't support Lambda Container Image so we updated it.

[djfdyuruiry]

Hey @djfdyuruiry, can you please have a look when you have time. Our team really like this package but it doesn't support Lambda Container Image so we updated it.

Hi @k0nkupa - thanks for this PR.

There are some unrelated issues that are causing the build to fail in GitHub Actions. I have fixed these issues in release v2.5.4 - https://github.com/djfdyuruiry/ts-lambda-api/releases/tag/v2.5.4

If you can update your PR with the lastest changes on master to get the build passing I would be happy to merge

[k0nkupa]

Hey @djfdyuruiry, can you please have a look when you have time. Our team really like this package but it doesn't support Lambda Container Image so we updated it.

Hi @k0nkupa - thanks for this PR.

There are some unrelated issues that are causing the build to fail in GitHub Actions. I have fixed these issues in release v2.5.4 - https://github.com/djfdyuruiry/ts-lambda-api/releases/tag/v2.5.4

If you can update your PR with the lastest changes on master to get the build passing I would be happy to merge

Hey mate, I’ve updated the PR with the latest changes from master/v2.5.4.

I also verified locally that:

• yarn improved-audit passes with 0 vulnerabilities
• yarn test passes

[djfdyuruiry]

Thanks for resolving that conflict, I will roll this into a new release.

[djfdyuruiry]

This has been included in the v2.5.5 release

ts-lambda-api-local has been bumped as well