@stone-js/aws-lambda-http-adapter 0.2.0 → 0.3.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Stone.js
+Copyright © 2026 Stone Foundation
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -3,7 +3,7 @@
 [![npm](https://img.shields.io/npm/l/@stone-js/aws-lambda-http-adapter)](https://opensource.org/licenses/MIT)
 [![npm](https://img.shields.io/npm/v/@stone-js/aws-lambda-http-adapter)](https://www.npmjs.com/package/@stone-js/aws-lambda-http-adapter)
 [![npm](https://img.shields.io/npm/dm/@stone-js/aws-lambda-http-adapter)](https://www.npmjs.com/package/@stone-js/aws-lambda-http-adapter)
-![Maintenance](https://img.shields.io/maintenance/yes/2025)
+![Maintenance](https://img.shields.io/maintenance/yes/2026)
 [![Build Status](https://github.com/stone-foundation/stone-js-aws-lambda-http-adapter/actions/workflows/main.yml/badge.svg)](https://github.com/stone-foundation/stone-js-aws-lambda-http-adapter/actions/workflows/main.yml)
 [![Publish Package to npmjs](https://github.com/stone-foundation/stone-js-aws-lambda-http-adapter/actions/workflows/release.yml/badge.svg)](https://github.com/stone-foundation/stone-js-aws-lambda-http-adapter/actions/workflows/release.yml)
 [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=stone-foundation_stone-js-aws-lambda-http-adapter&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=stone-foundation_stone-js-aws-lambda-http-adapter)

package/dist/browser.js

@@ -19,6 +19,19 @@ class AwsLambdaHttpAdapterError extends IntegrationError {
     }
 }
 
+/**
+ * Default blueprint configuration for the AWS Lambda Http Adapter.
+ *
+ * This blueprint defines the initial configuration for the AWS Lambda Http adapter
+ * within the Stone.js framework. It includes:
+ * - An alias for the AWS Lambda platform (`AWS_LAMBDA_HTTP_PLATFORM`).
+ * - A default resolver function (currently a placeholder).
+ * - Middleware, hooks, and state flags (`current`, `default`, `preferred`).
+ *
+ * NB: This is a stub for browser environments and does not perform any actual functionality in the browser.
+ */
+const awsLambdaHttpAdapterBlueprint = { stone: { http: {}, adapters: [] } };
+
 /**
  * A Stone.js decorator that integrates the AWS Lambda HTTP Adapter with a class.
  *
@@ -52,17 +65,4 @@ const AwsLambdaHttp = (_options = {}) => {
     return classDecoratorLegacyWrapper((_target, _context) => { });
 };
 
-/**
- * Default blueprint configuration for the AWS Lambda Http Adapter.
- *
- * This blueprint defines the initial configuration for the AWS Lambda Http adapter
- * within the Stone.js framework. It includes:
- * - An alias for the AWS Lambda platform (`AWS_LAMBDA_HTTP_PLATFORM`).
- * - A default resolver function (currently a placeholder).
- * - Middleware, hooks, and state flags (`current`, `default`, `preferred`).
- *
- * NB: This is a stub for browser environments and does not perform any actual functionality in the browser.
- */
-const awsLambdaHttpAdapterBlueprint = { stone: { http: {}, adapters: [] } };
-
 export { AWS_LAMBDA_HTTP_PLATFORM, AwsLambdaHttp, AwsLambdaHttpAdapterError, awsLambdaHttpAdapterBlueprint };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { IRawResponseWrapper, RawResponseOptions, AdapterContext, IAdapterEventBuilder, Adapter, IBlueprint, IAdapterErrorHandler, AdapterErrorContext, AdapterEventBuilderType, AdapterResolver, AdapterConfig, AppConfig, StoneBlueprint, ClassType, IntegrationError, ErrorOptions, BlueprintContext, NextMiddleware, MetaMiddleware } from '@stone-js/core';
+import { IRawResponseWrapper, RawResponseOptions, AdapterContext, IAdapterEventBuilder, Adapter, IBlueprint, IAdapterErrorHandler, AdapterErrorContext, AdapterEventBuilderType, AdapterResolver, AdapterConfig, StoneBlueprint, AppConfig, ClassType, IntegrationError, ErrorOptions, BlueprintContext, NextMiddleware, MetaMiddleware } from '@stone-js/core';
 import { IncomingHttpEvent, IncomingHttpEventOptions, OutgoingHttpResponse, HttpConfig } from '@stone-js/http-core';
 
 /**
@@ -59,6 +59,16 @@ declare class RawHttpResponseWrapper implements IRawResponseWrapper<RawHttpRespo
      * ```
      */
     respond(): RawHttpResponse;
+    /**
+     * Normalizes the headers to a consistent format.
+     *
+     * Converts Headers or Record<string, string> to a normalized Record<string, string>
+     * with all keys in lowercase.
+     *
+     * @param headers - The headers to normalize.
+     * @returns A normalized record of headers.
+     */
+    private normalizeHeaders;
 }
 
 /**
@@ -451,6 +461,24 @@ declare class BodyEventMiddleware {
      * @throws {AwsLambdaHttpAdapterError} If the body parsing fails or is invalid.
      */
     private getBody;
+    /**
+     * Get the normalized raw body from the event.
+     *
+     * @param rawEvent - The raw event containing the body.
+     * @param encoding - The encoding to use for the body.
+     * @returns The normalized body as a string.
+     */
+    private getNormalizedRawBody;
+    /**
+     * Parse the body content based on the specified type and encoding.
+     *
+     * @param type - The content type of the body.
+     * @param body - The raw body content as a string.
+     * @param encoding - The encoding of the body content.
+     * @returns The parsed body content as an object, string, or Buffer.
+     * @throws {AwsLambdaHttpAdapterError} If parsing fails.
+     */
+    private parseBodyContent;
 }
 /**
  * Meta Middleware for processing the request body.
@@ -460,6 +488,50 @@ declare const MetaBodyEventMiddleware: {
     isClass: boolean;
 };
 
+/**
+ * Class representing a FilesEventMiddleware.
+ *
+ * @author Mr. Stone <evensstone@gmail.com>
+ */
+declare class FilesEventMiddleware {
+    /**
+     * The blueprint for resolving configuration and dependencies.
+     */
+    private readonly blueprint;
+    /**
+     * Create a FilesEventMiddleware.
+     *
+     * @param {blueprint} options - Options for creating the FilesEventMiddleware.
+     */
+    constructor({ blueprint }: {
+        blueprint: IBlueprint;
+    });
+    /**
+     * Handles the incoming event, processes it, and invokes the next middleware in the pipeline.
+     *
+     * @param context - The adapter context containing the raw event, execution context, and other data.
+     * @param next - The next middleware to be invoked in the pipeline.
+     * @returns A promise that resolves to the destination type after processing.
+     *
+     * @throws {AwsLambdaHttpAdapterError} If required components such as the rawEvent or IncomingEventBuilder are not provided.
+     */
+    handle(context: AwsLambdaHttpAdapterContext, next: NextMiddleware<AwsLambdaHttpAdapterContext, AwsLambdaHttpAdapterResponseBuilder>): Promise<AwsLambdaHttpAdapterResponseBuilder>;
+    /**
+     * Normalize the incoming event to an IncomingMessage.
+     *
+     * @param rawEvent - The raw event to be normalized.
+     * @returns The normalized event.
+     */
+    private normalizeEvent;
+}
+/**
+ * Meta Middleware for processing files uploads.
+ */
+declare const MetaFilesEventMiddleware: {
+    module: typeof FilesEventMiddleware;
+    isClass: boolean;
+};
+
 /**
  * Middleware for handling incoming events and transforming them into Stone.js events.
  *
@@ -567,50 +639,6 @@ declare const MetaIncomingEventMiddleware: {
     isClass: boolean;
 };
 
-/**
- * Class representing a FilesEventMiddleware.
- *
- * @author Mr. Stone <evensstone@gmail.com>
- */
-declare class FilesEventMiddleware {
-    /**
-     * The blueprint for resolving configuration and dependencies.
-     */
-    private readonly blueprint;
-    /**
-     * Create a FilesEventMiddleware.
-     *
-     * @param {blueprint} options - Options for creating the FilesEventMiddleware.
-     */
-    constructor({ blueprint }: {
-        blueprint: IBlueprint;
-    });
-    /**
-     * Handles the incoming event, processes it, and invokes the next middleware in the pipeline.
-     *
-     * @param context - The adapter context containing the raw event, execution context, and other data.
-     * @param next - The next middleware to be invoked in the pipeline.
-     * @returns A promise that resolves to the destination type after processing.
-     *
-     * @throws {AwsLambdaHttpAdapterError} If required components such as the rawEvent or IncomingEventBuilder are not provided.
-     */
-    handle(context: AwsLambdaHttpAdapterContext, next: NextMiddleware<AwsLambdaHttpAdapterContext, AwsLambdaHttpAdapterResponseBuilder>): Promise<AwsLambdaHttpAdapterResponseBuilder>;
-    /**
-     * Normalize the incoming event to an IncomingMessage.
-     *
-     * @param rawEvent - The raw event to be normalized.
-     * @returns The normalized event.
-     */
-    private normalizeEvent;
-}
-/**
- * Meta Middleware for processing files uploads.
- */
-declare const MetaFilesEventMiddleware: {
-    module: typeof FilesEventMiddleware;
-    isClass: boolean;
-};
-
 /**
  * Middleware for handling server responses and transforming them into the appropriate HTTP responses.
  *

package/dist/index.js

@@ -1,5 +1,5 @@
-import { IntegrationError, Adapter, AdapterEventBuilder, defaultLoggerResolver, isNotEmpty, defaultKernelResolver, classDecoratorLegacyWrapper, addBlueprint } from '@stone-js/core';
-import { IncomingHttpEvent, HTTP_INTERNAL_SERVER_ERROR, BinaryFileResponse, OutgoingHttpResponse, CookieCollection, isIpTrusted, getHostname, getProtocol, httpCoreBlueprint, isMultipart, getCharset, getType, getFilesUploads } from '@stone-js/http-core';
+import { IntegrationError, Adapter, AdapterEventBuilder, defaultLoggerResolver, defaultKernelResolver, isNotEmpty, classDecoratorLegacyWrapper, addBlueprint } from '@stone-js/core';
+import { IncomingHttpEvent, HTTP_INTERNAL_SERVER_ERROR, BinaryFileResponse, OutgoingHttpResponse, CookieCollection, isIpTrusted, getHostname, getProtocol, httpCoreBlueprint, isMultipart, getCharset, getFilesUploads } from '@stone-js/http-core';
 import mime from 'mime';
 import accepts from 'accepts';
 import statuses from 'statuses';
@@ -73,9 +73,22 @@ class RawHttpResponseWrapper {
     respond() {
         return {
             ...this.options,
-            statusCode: this.options.statusCode ?? 500
+            statusCode: this.options.statusCode ?? 500,
+            headers: this.normalizeHeaders(this.options.headers)
         };
     }
+    /**
+     * Normalizes the headers to a consistent format.
+     *
+     * Converts Headers or Record<string, string> to a normalized Record<string, string>
+     * with all keys in lowercase.
+     *
+     * @param headers - The headers to normalize.
+     * @returns A normalized record of headers.
+     */
+    normalizeHeaders(headers) {
+        return Object.fromEntries(new Headers(headers ?? {}));
+    }
 }
 
 /**
@@ -800,19 +813,58 @@ class BodyEventMiddleware {
         const { defaultType, defaultCharset, limit: rawLimit } = this.blueprint.get('stone.http.body', defaultOptions);
         const limit = bytes.parse(rawLimit) ?? 100000;
         const encoding = getCharset(message, defaultCharset);
-        const type = getType(message, defaultType);
-        if (typeIs.is(type, ['urlencoded', 'json', 'text', 'bin']) === false) {
-            return {};
+        const type = typeIs(message, ['urlencoded', 'json', 'text', 'bin']) ?? defaultType;
+        const rawBodyContent = this.getNormalizedRawBody(rawEvent, encoding);
+        if (Buffer.byteLength(rawBodyContent, encoding) > limit) {
+            throw new AwsLambdaHttpAdapterError('Body payload exceeds configured limit.');
         }
-        const stringifiedBody = typeof rawEvent.body === 'string'
-            ? rawEvent.body
-            : (typeof rawEvent.body === 'object' && rawEvent.body !== null
-                ? JSON.stringify(rawEvent.body)
-                : '');
-        if (Buffer.byteLength(stringifiedBody, encoding) > limit) {
-            throw new AwsLambdaHttpAdapterError('The context is missing required components.');
+        return this.parseBodyContent(type, rawBodyContent, encoding);
+    }
+    /**
+     * Get the normalized raw body from the event.
+     *
+     * @param rawEvent - The raw event containing the body.
+     * @param encoding - The encoding to use for the body.
+     * @returns The normalized body as a string.
+     */
+    getNormalizedRawBody(rawEvent, encoding) {
+        if (typeof rawEvent.body === 'string') {
+            return rawEvent.isBase64Encoded === true
+                ? Buffer.from(rawEvent.body, 'base64').toString(encoding)
+                : rawEvent.body;
+        }
+        if (typeof rawEvent.body === 'object' && rawEvent.body !== null) {
+            return JSON.stringify(rawEvent.body);
+        }
+        return '';
+    }
+    /**
+     * Parse the body content based on the specified type and encoding.
+     *
+     * @param type - The content type of the body.
+     * @param body - The raw body content as a string.
+     * @param encoding - The encoding of the body content.
+     * @returns The parsed body content as an object, string, or Buffer.
+     * @throws {AwsLambdaHttpAdapterError} If parsing fails.
+     */
+    parseBodyContent(type, body, encoding) {
+        try {
+            switch (type) {
+                case 'json':
+                    return isNotEmpty(body) ? JSON.parse(body) : {};
+                case 'text':
+                    return body;
+                case 'urlencoded':
+                    return new URLSearchParams(body);
+                case 'bin':
+                    return Buffer.from(body, encoding);
+                default:
+                    return {};
+            }
+        }
+        catch (error) {
+            throw new AwsLambdaHttpAdapterError('Failed to parse request body.', { cause: error });
         }
-        return rawEvent.body;
     }
 }
 /**
@@ -871,8 +923,14 @@ class FilesEventMiddleware {
      * @returns The normalized event.
      */
     normalizeEvent(rawEvent) {
+        let body = rawEvent.body;
+        if (typeof rawEvent.body === 'string') {
+            body = rawEvent.isBase64Encoded === true
+                ? Buffer.from(rawEvent.body, 'base64')
+                : Buffer.from(rawEvent.body, 'utf-8');
+        }
         return {
-            body: rawEvent.body,
+            body,
             headers: {
                 'content-type': rawEvent.headers['content-type'] ?? rawEvent.headers['Content-Type'],
                 'content-length': rawEvent.headers['content-length'] ?? rawEvent.headers['Content-Length'],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stone-js/aws-lambda-http-adapter",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "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",
@@ -71,7 +71,7 @@
     "accepts": "^1.3.8",
     "bytes": "^3.1.2",
     "content-type": "^1.0.5",
-    "mime": "^4.0.7",
+    "mime": "^4.1.0",
     "proxy-addr": "^2.0.7",
     "statuses": "^2.0.1",
     "type-is": "^2.0.1"
@@ -82,27 +82,27 @@
     "@rollup/plugin-commonjs": "^28.0.2",
     "@rollup/plugin-multi-entry": "^6.0.1",
     "@rollup/plugin-node-resolve": "^15.2.3",
-    "@rollup/plugin-typescript": "^12.1.1",
+    "@rollup/plugin-typescript": "^12.3.0",
     "@types/accepts": "^1.3.7",
     "@types/bytes": "^3.1.5",
     "@types/content-type": "^1.1.8",
-    "@types/node": "^24.0.1",
+    "@types/node": "^24.9.2",
     "@types/proxy-addr": "^2.0.3",
     "@types/statuses": "^2.0.5",
     "@types/type-is": "^1.6.7",
-    "@vitest/coverage-v8": "^3.2.3",
+    "@vitest/coverage-v8": "^3.2.4",
     "husky": "^9.1.7",
-    "rimraf": "^6.0.1",
-    "rollup": "^4.43.0",
+    "rimraf": "^6.1.0",
+    "rollup": "^4.52.5",
     "rollup-plugin-delete": "^3.0.1",
-    "rollup-plugin-dts": "^6.2.1",
-    "rollup-plugin-node-externals": "^8.0.0",
+    "rollup-plugin-dts": "^6.2.3",
+    "rollup-plugin-node-externals": "^8.1.1",
     "ts-standard": "^12.0.2",
     "tslib": "^2.8.1",
-    "typedoc": "^0.28.5",
-    "typedoc-plugin-markdown": "^4.6.4",
-    "typescript": "^5.6.3",
-    "vitest": "^3.2.3"
+    "typedoc": "^0.28.14",
+    "typedoc-plugin-markdown": "^4.9.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
   },
   "ts-standard": {
     "globals": [