@stone-js/aws-lambda-http-adapter 0.8.17 → 0.8.18

package/dist/index.js

@@ -1,8 +1,8 @@
-import { IntegrationError, Adapter, AdapterEventBuilder, defaultLoggerResolver, isNotEmpty, Logger, defaultKernelResolver, classDecoratorLegacyWrapper, addBlueprint } from '@stone-js/core';
-import { IncomingHttpEvent, HTTP_INTERNAL_SERVER_ERROR, BinaryFileResponse, OutgoingHttpResponse, isMultipart, getCharset, CookieCollection, isIpTrusted, getHostname, getProtocol, httpCoreBlueprint, getFilesUploads } from '@stone-js/http-core';
+import { defaultLoggerResolver, IntegrationError, Adapter, AdapterEventBuilder, isNotEmpty, Logger, defaultKernelResolver, classDecoratorLegacyWrapper, addBlueprint } from '@stone-js/core';
 import mime from 'mime';
 import accepts from 'accepts';
 import statuses from 'statuses';
+import { HTTP_INTERNAL_SERVER_ERROR, IncomingHttpEvent, BinaryFileResponse, OutgoingHttpResponse, isMultipart, getCharset, CookieCollection, isIpTrusted, getHostname, getProtocol, httpCoreBlueprint, getFilesUploads } from '@stone-js/http-core';
 import { cloneValue, deepMerge } from '@stone-js/config';
 import { getString } from '@stone-js/env';
 import { File } from '@stone-js/filesystem';
@@ -109,136 +109,6 @@ class RawHttpResponseWrapper {
     }
 }
 
-/**
- * Custom error for AWS Lambda adapter operations.
- */
-class AwsLambdaHttpAdapterError extends IntegrationError {
-    constructor(message, options) {
-        super(message, options);
-        this.name = 'AwsLambdaHttpAdapterError';
-    }
-}
-
-/**
- * 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.
- *
- * @extends Adapter
- *
- * @example
- * ```typescript
- * import { AwsLambdaHttpAdapter } from '@stone-js/aws-lambda-http-adapter';
- *
- * const adapter = AwsLambdaHttpAdapter.create({...});
- *
- * const handler = await adapter.run();
- *
- * export { handler };
- * ```
- *
- * @see {@link https://stone-js.com/docs Stone.js Documentation}
- * @see {@link https://docs.aws.amazon.com/lambda/latest/dg/ AWS Lambda Documentation}
- */
-class AwsLambdaHttpAdapter extends Adapter {
-    /**
-     * Creates an instance of the `AwsLambdaHttpAdapter`.
-     *
-     * @param blueprint - The application blueprint.
-     * @returns A new instance of `AwsLambdaHttpAdapter`.
-     *
-     * @example
-     * ```typescript
-     * const adapter = AwsLambdaHttpAdapter.create(blueprint);
-     * await adapter.run();
-     * ```
-     */
-    static create(blueprint) {
-        return new this(blueprint);
-    }
-    /**
-     * 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.
-     *
-     * @template ExecutionResultType - The type representing the AWS Lambda event handler function.
-     * @returns A promise resolving to the AWS Lambda HTTP handler function.
-     * @throws {AwsLambdaHttpAdapterError} If used outside the AWS Lambda environment.
-     */
-    async run() {
-        await this.onStart();
-        const handler = async (rawEvent, executionContext) => {
-            return await this.eventListener(rawEvent, executionContext);
-        };
-        return handler;
-    }
-    /**
-     * 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).
-     *
-     * @throws {AwsLambdaHttpAdapterError} If executed outside an AWS Lambda environment.
-     */
-    async onStart() {
-        if (typeof window === 'object') {
-            throw new AwsLambdaHttpAdapterError('This `AwsLambdaHttpAdapter` must be used only in AWS Lambda context.');
-        }
-        await this.executeHooks('onStart');
-    }
-    /**
-     * 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.
-     *
-     * @param rawEvent - The raw HTTP event received from AWS Lambda.
-     * @param executionContext - The AWS Lambda execution context associated with the event.
-     * @returns A promise resolving to the processed `RawHttpResponse`.
-     */
-    async eventListener(rawEvent, executionContext) {
-        const incomingEventBuilder = AdapterEventBuilder.create({
-            resolver: (options) => IncomingHttpEvent.create(options)
-        });
-        const rawResponseBuilder = AdapterEventBuilder.create({
-            resolver: (options) => RawHttpResponseWrapper.create(options)
-        });
-        const rawResponse = { statusCode: 500 };
-        const context = {
-            rawEvent,
-            rawResponse,
-            executionContext,
-            rawResponseBuilder,
-            incomingEventBuilder
-        };
-        try {
-            const eventHandler = this.resolveEventHandler();
-            await this.executeEventHandlerHooks('onInit', eventHandler);
-            return await this.sendEventThroughDestination(context, eventHandler);
-        }
-        catch (error) {
-            const rawResponseBuilder = await this.handleError(error, context);
-            return await this.buildRawResponse({ ...context, rawResponseBuilder });
-        }
-    }
-}
-
 /**
  * Class representing an AwsLambdaHttpErrorHandler.
  */
@@ -453,6 +323,136 @@ function getRawBody(event) {
     return event.body;
 }
 
+/**
+ * Custom error for AWS Lambda adapter operations.
+ */
+class AwsLambdaHttpAdapterError extends IntegrationError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'AwsLambdaHttpAdapterError';
+    }
+}
+
+/**
+ * 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.
+ *
+ * @extends Adapter
+ *
+ * @example
+ * ```typescript
+ * import { AwsLambdaHttpAdapter } from '@stone-js/aws-lambda-http-adapter';
+ *
+ * const adapter = AwsLambdaHttpAdapter.create({...});
+ *
+ * const handler = await adapter.run();
+ *
+ * export { handler };
+ * ```
+ *
+ * @see {@link https://stone-js.com/docs Stone.js Documentation}
+ * @see {@link https://docs.aws.amazon.com/lambda/latest/dg/ AWS Lambda Documentation}
+ */
+class AwsLambdaHttpAdapter extends Adapter {
+    /**
+     * Creates an instance of the `AwsLambdaHttpAdapter`.
+     *
+     * @param blueprint - The application blueprint.
+     * @returns A new instance of `AwsLambdaHttpAdapter`.
+     *
+     * @example
+     * ```typescript
+     * const adapter = AwsLambdaHttpAdapter.create(blueprint);
+     * await adapter.run();
+     * ```
+     */
+    static create(blueprint) {
+        return new this(blueprint);
+    }
+    /**
+     * 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.
+     *
+     * @template ExecutionResultType - The type representing the AWS Lambda event handler function.
+     * @returns A promise resolving to the AWS Lambda HTTP handler function.
+     * @throws {AwsLambdaHttpAdapterError} If used outside the AWS Lambda environment.
+     */
+    async run() {
+        await this.onStart();
+        const handler = async (rawEvent, executionContext) => {
+            return await this.eventListener(rawEvent, executionContext);
+        };
+        return handler;
+    }
+    /**
+     * 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).
+     *
+     * @throws {AwsLambdaHttpAdapterError} If executed outside an AWS Lambda environment.
+     */
+    async onStart() {
+        if (typeof window === 'object') {
+            throw new AwsLambdaHttpAdapterError('This `AwsLambdaHttpAdapter` must be used only in AWS Lambda context.');
+        }
+        await this.executeHooks('onStart');
+    }
+    /**
+     * 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.
+     *
+     * @param rawEvent - The raw HTTP event received from AWS Lambda.
+     * @param executionContext - The AWS Lambda execution context associated with the event.
+     * @returns A promise resolving to the processed `RawHttpResponse`.
+     */
+    async eventListener(rawEvent, executionContext) {
+        const incomingEventBuilder = AdapterEventBuilder.create({
+            resolver: (options) => IncomingHttpEvent.create(options)
+        });
+        const rawResponseBuilder = AdapterEventBuilder.create({
+            resolver: (options) => RawHttpResponseWrapper.create(options)
+        });
+        const rawResponse = { statusCode: 500 };
+        const context = {
+            rawEvent,
+            rawResponse,
+            executionContext,
+            rawResponseBuilder,
+            incomingEventBuilder
+        };
+        try {
+            const eventHandler = this.resolveEventHandler();
+            await this.executeEventHandlerHooks('onInit', eventHandler);
+            return await this.sendEventThroughDestination(context, eventHandler);
+        }
+        catch (error) {
+            const rawResponseBuilder = await this.handleError(error, context);
+            return await this.buildRawResponse({ ...context, rawResponseBuilder });
+        }
+    }
+}
+
 /**
  * Adapter resolver for AWS Lambda HTTP adapter.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stone-js/aws-lambda-http-adapter",
-  "version": "0.8.17",
+  "version": "0.8.18",
   "description": "Official AWS Lambda HTTP adapter for Stone.js. Run your Stone.js apps on AWS Lambda behind API Gateway with full Continuum lifecycle support.",
   "author": "Mr. Stone <evensstone@gmail.com>",
   "license": "MIT",
@@ -50,10 +50,10 @@
     "node": ">=18.17.0"
   },
   "peerDependencies": {
-    "@stone-js/core": "0.8.17",
-    "@stone-js/env": "0.8.17",
-    "@stone-js/filesystem": "0.8.17",
-    "@stone-js/http-core": "0.8.17"
+    "@stone-js/core": "0.8.18",
+    "@stone-js/env": "0.8.18",
+    "@stone-js/filesystem": "0.8.18",
+    "@stone-js/http-core": "0.8.18"
   },
   "dependencies": {
     "accepts": "^1.3.8",
@@ -63,7 +63,7 @@
     "proxy-addr": "^2.0.7",
     "statuses": "^2.0.1",
     "type-is": "^2.0.1",
-    "@stone-js/config": "0.8.17"
+    "@stone-js/config": "0.8.18"
   },
   "devDependencies": {
     "@commitlint/cli": "^19.6.1",