Class AwsLambdaHttpAdapter

AWS Lambda HTTP Adapter for Stone.js.

The AwsLambdaHttpAdapter extends the functionality of the Stone.js Adapter to provide seamless integration with AWS Lambda for HTTP-based events. This adapter transforms incoming HTTP events from AWS Lambda into IncomingHttpEvent instances and produces a RawHttpResponse as output.

This adapter simplifies the process of handling HTTP events within AWS Lambda while adhering to the Stone.js framework's event-driven architecture.

Template: AwsLambdaHttpEvent

The type of the raw HTTP event from AWS Lambda.

Template: RawHttpResponse

The type of the raw HTTP response to send back.

Template: AwsLambdaContext

The AWS Lambda execution context type.

Template: IncomingHttpEvent

The type of the processed incoming HTTP event.

Template: IncomingHttpEventOptions

Options used to create an incoming HTTP event.

Template: OutgoingHttpResponse

The type of the outgoing HTTP response after processing.

Template: AwsLambdaHttpAdapterContext

Context type specific to the HTTP adapter.

Example

import { AwsLambdaHttpAdapter } from '@stone-js/aws-lambda-http-adapter';

const adapter = AwsLambdaHttpAdapter.create({...});

const handler = await adapter.run();

export { handler };

See

Hierarchy

Adapter<
    AwsLambdaHttpEvent,
    RawHttpResponse,
    AwsLambdaContext,
    IncomingHttpEvent,
    IncomingHttpEventOptions,
    OutgoingHttpResponse,
    AwsLambdaHttpAdapterContext,
>
- AwsLambdaHttpAdapter

Constructors

`Protected`constructor

new AwsLambdaHttpAdapter(blueprint: IBlueprint): AwsLambdaHttpAdapter
Create an Adapter.
Parameters
- blueprint: IBlueprint
  The blueprint to create the adapter.
Returns AwsLambdaHttpAdapter

Inherited from Adapter< AwsLambdaHttpEvent, RawHttpResponse, AwsLambdaContext, IncomingHttpEvent, IncomingHttpEventOptions, OutgoingHttpResponse, AwsLambdaHttpAdapterContext >.constructor

Properties

`Protected` `Readonly`blueprint

blueprint: IBlueprint

`Protected` `Readonly`hooks

hooks: AdapterHookType<AwsLambdaHttpAdapterContext, RawHttpResponseOptions>

`Protected` `Readonly`middleware

middleware: AdapterMixedPipeType<
AwsLambdaHttpAdapterContext,
RawHttpResponseOptions,
>[]

`Protected` `Readonly`resolvedErrorHandlers

resolvedErrorHandlers: Record<
string,
IAdapterErrorHandler<RawEventType, RawResponseType, ExecutionContextType>,
>

Methods

`Protected`buildRawResponse

buildRawResponse(
    context: AwsLambdaHttpAdapterContext,
    eventHandler?: AdapterEventHandlerType<
        IncomingHttpEvent,
        OutgoingHttpResponse,
    >,
): Promise<RawHttpResponseOptions>
Build the raw response.
Parameters
- context: AwsLambdaHttpAdapterContext
  The event context.
- OptionaleventHandler: AdapterEventHandlerType<IncomingHttpEvent, OutgoingHttpResponse>
  The event handler to be run.
Returns Promise<RawHttpResponseOptions>
The raw response wrapper.

Inherited from Adapter.buildRawResponse

`Protected`eventListener

eventListener(
rawEvent: AwsLambdaHttpEvent,
executionContext: AwsLambdaContext,
): Promise<RawHttpResponseOptions>
Processes an incoming AWS Lambda HTTP event.

Converts a raw AWS Lambda HTTP event into an IncomingHttpEvent, processes it through the Stone.js pipeline, and generates a RawHttpResponse to send back.
Parameters
- rawEvent: AwsLambdaHttpEvent
  The raw HTTP event received from AWS Lambda.
- executionContext: AwsLambdaContext
  The AWS Lambda execution context associated with the event.
Returns Promise<RawHttpResponseOptions>
A promise resolving to the processed RawHttpResponse.

`Protected`executeEventHandlerHooks

executeEventHandlerHooks(
    hook: KernelHookName,
    eventHandler: AdapterEventHandlerType<
        IncomingHttpEvent,
        OutgoingHttpResponse,
    >,
): Promise<void>
Execute the event handler lifecycle hooks.
Parameters
- hook: KernelHookName
  The hook to execute.
- eventHandler: AdapterEventHandlerType<IncomingHttpEvent, OutgoingHttpResponse>
  The event handler to be run.
Returns Promise<void>

Inherited from Adapter.executeEventHandlerHooks

`Protected`executeHooks

executeHooks(
    name: AdapterHookName,
    context?: AwsLambdaHttpAdapterContext,
    error?: any,
): Promise<void>
Execute adapter lifecycle hooks.
Parameters
- name: AdapterHookName
  The hook's name.
- Optionalcontext: AwsLambdaHttpAdapterContext
  The event context.
- Optionalerror: any
  The error to handle.
Returns Promise<void>

Inherited from Adapter.executeHooks

`Protected`handleError

handleError(
error: Error,
context: AwsLambdaHttpAdapterContext,
): Promise<AdapterEventBuilderType<RawHttpResponseOptions>>
Handle error.
Parameters
- error: Error
  The error to handle.
- context: AwsLambdaHttpAdapterContext
  The event context.
Returns Promise<AdapterEventBuilderType<RawHttpResponseOptions>>
The raw response.

Inherited from Adapter.handleError

`Protected`handleEvent

handleEvent(
    context: AwsLambdaHttpAdapterContext,
    eventHandler: AdapterEventHandlerType<
        IncomingHttpEvent,
        OutgoingHttpResponse,
    >,
): Promise<
    IAdapterEventBuilder<
        RawResponseOptions,
        IRawResponseWrapper<RawHttpResponseOptions>,
    >,
>
Handle the event.
Parameters
- context: AwsLambdaHttpAdapterContext
  The event context.
- eventHandler: AdapterEventHandlerType<IncomingHttpEvent, OutgoingHttpResponse>
  The event handler to be run.
Returns Promise<
    IAdapterEventBuilder<
        RawResponseOptions,
        IRawResponseWrapper<RawHttpResponseOptions>,
    >,
>
The raw response wrapper.

Inherited from Adapter.handleEvent

`Protected`makePipelineOptions

makePipelineOptions(): PipelineOptions<
    AwsLambdaHttpAdapterContext,
    AdapterEventBuilderType<RawHttpResponseOptions>,
>

Create pipeline options for the Adapter.

Returns PipelineOptions<
    AwsLambdaHttpAdapterContext,
    AdapterEventBuilderType<RawHttpResponseOptions>,
>
The pipeline options for transforming the event.

Inherited from Adapter.makePipelineOptions

`Protected`onStart

onStart(): Promise<void>

Initializes the adapter and validates its execution context.

Ensures that the adapter is running in an AWS Lambda environment. Throws an error if it detects that the adapter is being used in an unsupported environment (e.g., a browser).

Returns Promise<void>

Throws
If executed outside an AWS Lambda environment.

`Protected`resolveErrorHandler

resolveErrorHandler(
    error: Error,
): IAdapterErrorHandler<
    AwsLambdaHttpEvent,
    RawHttpResponseOptions,
    AwsLambdaContext,
>
Get the error handler for the given error.
Parameters
- error: Error
  The error to get the handler for.
Returns IAdapterErrorHandler<
    AwsLambdaHttpEvent,
    RawHttpResponseOptions,
    AwsLambdaContext,
>
The error handler.

Throws
IntegrationError

Inherited from Adapter.resolveErrorHandler

`Protected`resolveEventHandler

resolveEventHandler(): AdapterEventHandlerType<
IncomingHttpEvent,
OutgoingHttpResponse,
>

Get the event handler for the adapter.

Returns AdapterEventHandlerType<IncomingHttpEvent, OutgoingHttpResponse>
The event handler for the adapter.

Throws
If the event handler is missing.

Inherited from Adapter.resolveEventHandler

run

run<ExecutionResultType = AwsLambdaEventHandlerFunction<RawHttpResponseOptions>>(): Promise<
ExecutionResultType,
>
Executes the adapter and provides an AWS Lambda-compatible HTTP handler function.

This method initializes the adapter and returns a handler function that can process HTTP events in AWS Lambda. It transforms raw events into IncomingHttpEvent instances and produces RawHttpResponse objects as output.
Type Parameters
- ExecutionResultType = AwsLambdaEventHandlerFunction<RawHttpResponseOptions>
  The type representing the AWS Lambda event handler function.
Returns Promise<ExecutionResultType>
A promise resolving to the AWS Lambda HTTP handler function.

Throws
If used outside the AWS Lambda environment.

Overrides Adapter.run

`Protected`sendEventThroughDestination

sendEventThroughDestination(
    context: AwsLambdaHttpAdapterContext,
    eventHandler: AdapterEventHandlerType<
        IncomingHttpEvent,
        OutgoingHttpResponse,
    >,
): Promise<RawHttpResponseOptions>
Send the raw event through the destination.
Parameters
- context: AwsLambdaHttpAdapterContext
  The event context.
- eventHandler: AdapterEventHandlerType<IncomingHttpEvent, OutgoingHttpResponse>
  The event handler to be run.
Returns Promise<RawHttpResponseOptions>
Platform-specific response.

Throws
IntegrationError

Inherited from Adapter.sendEventThroughDestination

`Protected`validateContextAndEventHandler

validateContextAndEventHandler(
    context: AwsLambdaHttpAdapterContext,
    eventHandler: AdapterEventHandlerType<
        IncomingHttpEvent,
        OutgoingHttpResponse,
    >,
): void
Validate the context and event handler.
Parameters
- context: AwsLambdaHttpAdapterContext
  The context to validate.
- eventHandler: AdapterEventHandlerType<IncomingHttpEvent, OutgoingHttpResponse>
  The event handler to validate.
Returns void

Throws
IntegrationError

Inherited from Adapter.validateContextAndEventHandler

`Static`create

create(blueprint: IBlueprint): AwsLambdaHttpAdapter
Creates an instance of the AwsLambdaHttpAdapter.
Parameters
- blueprint: IBlueprint
  The application blueprint.
Returns AwsLambdaHttpAdapter
A new instance of AwsLambdaHttpAdapter.
Example
```
const adapter = AwsLambdaHttpAdapter.create(blueprint);
await adapter.run();
```

Class AwsLambdaHttpAdapter

Template: AwsLambdaHttpEvent

Template: RawHttpResponse

Template: AwsLambdaContext

Template: IncomingHttpEvent

Template: IncomingHttpEventOptions

Template: OutgoingHttpResponse

Template: AwsLambdaHttpAdapterContext

Example

See

Hierarchy

Index

Constructors

Properties

Methods

Constructors

Protectedconstructor

Parameters

Returns AwsLambdaHttpAdapter

Properties

Protected Readonlyblueprint

Protected Readonlyhooks

Protected Readonlymiddleware

Protected ReadonlyresolvedErrorHandlers

Methods

ProtectedbuildRawResponse

Parameters

Returns Promise<RawHttpResponseOptions>

ProtectedeventListener

Parameters

Returns Promise<RawHttpResponseOptions>

ProtectedexecuteEventHandlerHooks

Parameters

Returns Promise<void>

ProtectedexecuteHooks

Parameters

Returns Promise<void>

ProtectedhandleError

Parameters

Returns Promise<AdapterEventBuilderType<RawHttpResponseOptions>>

ProtectedhandleEvent

Parameters

Returns Promise< IAdapterEventBuilder< RawResponseOptions, IRawResponseWrapper<RawHttpResponseOptions>, >,>

ProtectedmakePipelineOptions

Returns PipelineOptions< AwsLambdaHttpAdapterContext, AdapterEventBuilderType<RawHttpResponseOptions>,>

ProtectedonStart

Returns Promise<void>

Throws

ProtectedresolveErrorHandler

Parameters

Returns IAdapterErrorHandler< AwsLambdaHttpEvent, RawHttpResponseOptions, AwsLambdaContext,>

Throws

ProtectedresolveEventHandler

Returns AdapterEventHandlerType<IncomingHttpEvent, OutgoingHttpResponse>

Throws

run

Type Parameters

Returns Promise<ExecutionResultType>

Throws

ProtectedsendEventThroughDestination

Parameters

Returns Promise<RawHttpResponseOptions>

Throws

ProtectedvalidateContextAndEventHandler

Parameters

Returns void

Throws

Staticcreate

Parameters

Returns AwsLambdaHttpAdapter

Example

Settings

On This Page

`Protected`constructor

`Protected` `Readonly`blueprint

`Protected` `Readonly`hooks

`Protected` `Readonly`middleware

`Protected` `Readonly`resolvedErrorHandlers

`Protected`buildRawResponse

`Protected`eventListener

`Protected`executeEventHandlerHooks

`Protected`executeHooks

`Protected`handleError

`Protected`handleEvent

Returns Promise<
IAdapterEventBuilder<
RawResponseOptions,
IRawResponseWrapper<RawHttpResponseOptions>,
>,
>

`Protected`makePipelineOptions

Returns PipelineOptions<
AwsLambdaHttpAdapterContext,
AdapterEventBuilderType<RawHttpResponseOptions>,
>

`Protected`onStart

`Protected`resolveErrorHandler

Returns IAdapterErrorHandler<
AwsLambdaHttpEvent,
RawHttpResponseOptions,
AwsLambdaContext,
>

`Protected`resolveEventHandler

`Protected`sendEventThroughDestination

`Protected`validateContextAndEventHandler

`Static`create