@vercube/serverless 0.0.22 → 0.0.23

package/README.md

@@ -3,10 +3,10 @@
   <br>
   <br>
 
-  # @vercube/serverless
-  
-  Serverless deployment adapters for Vercube applications
-  
+# @vercube/serverless
+
+Serverless deployment adapters for Vercube applications
+
   <a href="https://www.npmjs.com/package/@vercube/serverless">
     <img src="https://img.shields.io/npm/v/%40vercube%2Fserverless?style=for-the-badge&logo=npm&color=%23767eff" alt="npm"/>
   </a>
@@ -16,6 +16,9 @@
   <a href="https://github.com/vercube/vercube/blob/main/LICENSE" target="_blank">
     <img src="https://img.shields.io/npm/l/%40vercube%2Fserverless?style=for-the-badge&color=%23767eff" alt="License"/>
   </a>
+  <a href="https://codecov.io/gh/vercube/vercube" target="_blank">
+    <img src="https://img.shields.io/codecov/c/github/vercube/vercube?style=for-the-badge&color=%23767eff" alt="Coverage"/>
+  </a>
   <br/>
   <br/>
 </div>
@@ -107,12 +110,15 @@ Full support for AWS Lambda with API Gateway integration:
 Converts a Vercube App instance into a serverless handler function.
 
 **Parameters:**
+
 - `app` - The Vercube App instance that will handle requests
 
 **Returns:**
+
 - An async function that accepts serverless events and returns platform-specific responses
 
 **Example:**
+
 ```ts
 import { createApp } from '@vercube/core';
 import { toServerlessHandler } from '@vercube/serverless/aws-lambda';
@@ -128,12 +134,14 @@ export const handler = toServerlessHandler(app);
 The serverless adapters handle automatic conversion between platform-specific events and standard web requests:
 
 ### Request Conversion
+
 - **HTTP Method** - Extracted from event properties
 - **URL Construction** - Built from path, query parameters, and headers
 - **Headers** - Converted to standard Headers object
 - **Body** - Properly decoded and converted to Request body
 
 ### Response Conversion
+
 - **Status Code** - Mapped from Response status
 - **Headers** - Converted to platform-specific format
 - **Body** - Encoded appropriately (text vs binary)
@@ -160,8 +168,8 @@ import { toServerlessHandler } from '@vercube/serverless/aws-lambda';
 
 const app = createApp({
   logger: {
-    level: 'debug'
-  }
+    level: 'debug',
+  },
 });
 
 export const handler = toServerlessHandler(app);
@@ -180,13 +188,12 @@ Explore guides, API references, and best practices to master Vercube serverless
 
 This module is inspired by:
 
-* [Nitro AWS Lambda Preset](https://nitro.build/presets/aws-lambda)
-* [Hono AWS Lambda Adapter](https://hono.dev/guides/aws-lambda)
-* [Vercel Serverless Functions](https://vercel.com/docs/functions)
+- [Nitro AWS Lambda Preset](https://nitro.build/presets/aws-lambda)
+- [Hono AWS Lambda Adapter](https://hono.dev/guides/aws-lambda)
+- [Vercel Serverless Functions](https://vercel.com/docs/functions)
 
 ---
 
 ## 🪪 License
 
 [MIT License](https://github.com/vercube/vercube/blob/main/LICENSE)
-

package/dist/Adapters/aws-lambda/index.mjs

@@ -35,11 +35,11 @@ function getHeaderValue(headers, keys) {
 }
 /**
 * Extracts the HTTP method from an API Gateway event.
-* 
+*
 * Handles both v1 and v2 event formats:
 * - v1: Uses `httpMethod` property
 * - v2: Uses `requestContext.http.method` property
-* 
+*
 * @param event - The AWS API Gateway event object (v1 or v2 format)
 * @returns The HTTP method as a string, defaults to 'GET' if not found
 */
@@ -50,13 +50,13 @@ function getEventMethod(event) {
 }
 /**
 * Constructs a complete URL from an API Gateway event.
-* 
+*
 * Builds the URL by combining:
 * - Protocol (http/https based on X-Forwarded-Proto header)
 * - Hostname (from headers or requestContext)
 * - Path (from event path properties)
 * - Query string (from query parameters)
-* 
+*
 * @param event - The AWS API Gateway event object (v1 or v2 format)
 * @returns A complete URL object
 */
@@ -93,11 +93,11 @@ function getEventProtocol(event) {
 }
 /**
 * Extracts and formats query parameters from an API Gateway event.
-* 
+*
 * Handles both v1 and v2 event formats:
 * - v2: Uses `rawQueryString` if available
 * - v1: Combines `queryStringParameters` and `multiValueQueryStringParameters`
-* 
+*
 * @param event - The AWS API Gateway event object (v1 or v2 format)
 * @returns A formatted query string (without the leading '?')
 */
@@ -113,11 +113,11 @@ function getEventQuery(event) {
 }
 /**
 * Converts API Gateway event headers to a standard Headers object.
-* 
+*
 * Processes all headers from the event and handles cookies specially:
 * - Sets all event headers in the Headers object
 * - Appends cookies from the event's cookies array (v2 format)
-* 
+*
 * @param event - The AWS API Gateway event object (v1 or v2 format)
 * @returns A Headers object with all event headers and cookies
 */
@@ -133,12 +133,12 @@ function getEventHeaders(event) {
 }
 /**
 * Extracts the request body from an API Gateway event.
-* 
+*
 * Handles different body formats:
 * - Returns undefined if no body is present
 * - Decodes base64-encoded bodies when `isBase64Encoded` is true
 * - Returns the raw body string for regular requests
-* 
+*
 * @param event - The AWS API Gateway event object (v1 or v2 format)
 * @returns The request body as BodyInit (string, Buffer, or undefined)
 */
@@ -153,13 +153,13 @@ function getEventBody(event) {
 }
 /**
 * Converts an AWS API Gateway event to a standard Request object.
-* 
+*
 * This function handles both APIGatewayProxyEvent (v1) and APIGatewayProxyEventV2 (v2) formats,
 * extracting the HTTP method, URL, headers, and body to create a web-standard Request object.
-* 
+*
 * This file is highly inspired by the `awsRequest` from `nitro`
 * @see https://github.com/nitrojs/nitro/blob/v3/src/presets/aws-lambda/runtime/_utils.ts
-* 
+*
 * @param event - The AWS API Gateway event object (v1 or v2 format)
 * @returns A new Request object with the extracted event data
 * @throws {Error} If the event is invalid or missing required properties
@@ -192,16 +192,16 @@ const TEXT_CONTENT_TYPE_PATTERNS = [
 ];
 /**
 * Converts a standard web Response object to AWS API Gateway compatible response format.
-* 
+*
 * This function transforms the Response headers and cookies into the format expected by
 * AWS API Gateway proxy integrations. It handles both v1 and v2 API Gateway formats:
 * - v1: Uses `multiValueHeaders` for cookies
 * - v2: Uses `cookies` array for cookies
-* 
+*
 * The function processes all response headers, converting them to the appropriate format
 * for AWS Lambda integration. Headers with multiple values are joined with commas,
 * and cookies are handled specially for both API Gateway versions.
-* 
+*
 * @param response - The standard web Response object to convert
 * @returns An object containing headers and cookies in AWS API Gateway format
 * @throws {Error} If the response object is invalid or headers cannot be processed
@@ -224,21 +224,21 @@ function convertResponseToAWSResponse(response) {
 }
 /**
 * Converts a Response body to AWS API Gateway compatible format with proper encoding.
-* 
+*
 * AWS Lambda proxy integrations require special handling for binary content:
 * - Text content types are returned as UTF-8 strings
 * - Binary content types are base64 encoded with the `isBase64Encoded` flag set
-* 
+*
 * This function determines the appropriate encoding based on the response's content-type
 * header and converts the body accordingly. It supports both text and binary content
 * types, ensuring compatibility with API Gateway's payload encoding requirements.
-* 
+*
 * Binary media types should be configured as * in API Gateway settings.
 * @see https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-payload-encodings.html
-* 
+*
 * This function is heavily inspired by the `awsResponseBody` from `nitro`
 * @see https://github.com/nitrojs/nitro/blob/v3/src/presets/aws-lambda/runtime/_utils.ts
-* 
+*
 * @param response - The standard web Response object containing the body to convert
 * @returns A promise that resolves to an object with the encoded body and encoding flag
 * @throws {Error} If the response body cannot be read or converted
@@ -261,15 +261,15 @@ async function convertBodyToAWSResponse(response) {
 }
 /**
 * Determines if a content type should be treated as text content.
-* 
+*
 * This function uses a set of patterns to identify text-based content types:
 * - Content types starting with "text/" (e.g., text/plain, text/html)
 * - JavaScript, JSON, or XML content types
 * - Content types containing UTF-8 encoding specification
-* 
+*
 * The function performs case-insensitive matching to handle various content type
 * formats and specifications.
-* 
+*
 * @param contentType - The content type string to evaluate (e.g., "text/plain", "application/json")
 * @returns True if the content type should be treated as text, false otherwise
 */
@@ -279,15 +279,15 @@ function isTextType(contentType = DEFAULT_CONTENT_TYPE) {
 }
 /**
 * Converts a ReadableStream to a Buffer using Web Streams API.
-* 
+*
 * This function reads all chunks from a ReadableStream and concatenates them
 * into a single Buffer. It uses the modern Web Streams API with WritableStream
 * to efficiently process the stream data without blocking.
-* 
+*
 * The function handles stream errors gracefully and provides proper cleanup
 * of stream resources. It's designed to work with Response.body streams
 * from fetch API responses.
-* 
+*
 * @param data - The ReadableStream to convert to a Buffer
 * @returns A promise that resolves to a Buffer containing all stream data
 * @throws {Error} If the stream cannot be read or an error occurs during processing
@@ -314,25 +314,25 @@ function toBuffer(data) {
 //#region src/Adapters/aws-lambda/index.ts
 /**
 * Converts a Vercube App instance into an AWS Lambda handler function for API Gateway integration.
-* 
+*
 * This function creates a serverless handler that bridges between AWS API Gateway events and
 * the Vercube application framework. It handles the conversion of AWS Lambda events to standard
 * web Request objects, processes them through the Vercube app, and converts the responses back
 * to the format expected by AWS API Gateway.
-* 
+*
 * The handler supports both API Gateway v1 (APIGatewayProxyEvent) and v2 (APIGatewayProxyEventV2)
 * event formats, automatically detecting and handling the appropriate format. It processes:
 * - HTTP method, URL, headers, and body from the Lambda event
 * - Converts them to a standard web Request object
 * - Passes the request through the Vercube application
 * - Converts the Response back to AWS API Gateway format
-* 
+*
 * The returned handler function can be directly used as an AWS Lambda function handler,
 * providing seamless integration between AWS Lambda and Vercube applications.
-* 
+*
 * @param app - The Vercube App instance that will handle the requests
 * @returns An async function that accepts AWS API Gateway events and returns API Gateway responses
-* 
+*
 * @see {@link convertEventToRequest} For details on event to request conversion
 * @see {@link convertResponseToAWSResponse} For details on response header conversion
 * @see {@link convertBodyToAWSResponse} For details on response body conversion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercube/serverless",
-  "version": "0.0.22",
+  "version": "0.0.23",
   "description": "Serverless module for Vercube framework",
   "repository": {
     "type": "git",
@@ -35,8 +35,8 @@
   ],
   "dependencies": {
     "ufo": "1.6.1",
-    "@vercube/core": "0.0.22",
-    "@vercube/di": "0.0.22"
+    "@vercube/core": "0.0.23",
+    "@vercube/di": "0.0.23"
   },
   "devDependencies": {
     "@types/aws-lambda": "8.10.152",