@stone-js/aws-lambda-http-adapter 0.1.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

@@ -0,0 +1,68 @@
+import { IntegrationError, classDecoratorLegacyWrapper } from '@stone-js/core';
+
+/**
+ * A constant representing the AWS Lambda HTTP platform identifier.
+ *
+ * This constant is used as an alias for the AWS Lambda HTTP Adapter within the Stone.js framework.
+ * It helps in identifying and configuring platform-specific adapters or components for handling
+ * HTTP requests and responses.
+ */
+const AWS_LAMBDA_HTTP_PLATFORM = 'aws_lambda_http';
+
+/**
+ * Custom error for AWS Lambda adapter operations.
+ */
+class AwsLambdaHttpAdapterError extends IntegrationError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'AwsLambdaHttpAdapterError';
+    }
+}
+
+/**
+ * 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.
+ *
+ * This decorator modifies the class to seamlessly enable AWS Lambda HTTP as the
+ * execution environment for a Stone.js application. By applying this decorator,
+ * the class is automatically configured with the necessary blueprint for AWS Lambda HTTP.
+ *
+ * NB: This decorator is stubbed for browser environments compatibility and does not
+ * perform any actual functionality in the browser. It is intended for use in Node.js environments
+ * where the Node.js HTTP adapter is applicable.
+ *
+ * @template T - The type of the class being decorated. Defaults to `ClassType`.
+ * @param options - Optional configuration to customize the AWS Lambda HTTP Adapter.
+ *
+ * @returns A class decorator that applies the AWS Lambda HTTP adapter configuration.
+ *
+ * @example
+ * ```typescript
+ * import { AwsLambdaHttp } from '@stone-js/aws-lambda-http-adapter';
+ *
+ * @AwsLambdaHttp({
+ *   alias: 'MyAwsLambdaHttpAdapter',
+ *   current: true,
+ * })
+ * class App {
+ *   // Your application logic here
+ * }
+ * ```
+ */
+const AwsLambdaHttp = (_options = {}) => {
+    return classDecoratorLegacyWrapper((_target, _context) => { });
+};
+
+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.

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.1.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",
@@ -34,12 +34,18 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
+      "browser": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/browser.js"
+      },
+      "default": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
     }
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=18.17.0"
   },
   "scripts": {
     "lint": "ts-standard src",
@@ -65,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"
@@ -76,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": [