@stone-js/aws-lambda-http-adapter 0.3.1 → 0.8.0

package/dist/middleware/BlueprintMiddleware.d.ts

@@ -0,0 +1,21 @@
+import { ClassType, BlueprintContext, IBlueprint, MetaMiddleware, NextMiddleware } from '@stone-js/core';
+/**
+ * Middleware to dynamically set response resolver for adapter.
+ *
+ * @param context - The configuration context containing modules and blueprint.
+ * @param next - The next pipeline function to continue processing.
+ * @returns The updated blueprint or a promise resolving to it.
+ *
+ * @example
+ * ```typescript
+ * SetAwsLambdaHttpResponseResolverMiddleware(context, next)
+ * ```
+ */
+export declare const SetAwsLambdaHttpResponseResolverMiddleware: (context: BlueprintContext<IBlueprint, ClassType>, next: NextMiddleware<BlueprintContext<IBlueprint, ClassType>, IBlueprint>) => Promise<IBlueprint>;
+/**
+ * Configuration for adapter processing middleware.
+ *
+ * This array defines a list of middleware pipes, each with a `pipe` function and a `priority`.
+ * These pipes are executed in the order of their priority values, with lower values running first.
+ */
+export declare const metaAdapterBlueprintMiddleware: Array<MetaMiddleware<BlueprintContext<IBlueprint, ClassType>, IBlueprint>>;

package/dist/middleware/BodyEventMiddleware.d.ts

@@ -0,0 +1,78 @@
+import { IBlueprint, NextMiddleware, type MetaMiddleware } from '@stone-js/core';
+import { AwsLambdaHttpAdapterContext, AwsLambdaHttpAdapterResponseBuilder } from '../declarations';
+/**
+ * Class representing a BodyEventMiddleware.
+ *
+ * This middleware handles platform-specific messages and transforms them into Stone.js IncomingEvent objects.
+ *
+ * @author Mr. Stone
+ */
+export declare class BodyEventMiddleware {
+    /**
+     * The blueprint for resolving configuration and dependencies.
+     */
+    private readonly blueprint;
+    /**
+     * Create a BodyEventMiddleware.
+     *
+     * @param {blueprint} options - Options for creating the BodyEventMiddleware.
+     */
+    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>;
+    /**
+     * Extract a spoofed HTTP method from a parsed body, supporting both JSON objects and
+     * urlencoded bodies (whose fields live on a `URLSearchParams`, not as own properties).
+     *
+     * @param body - The parsed body.
+     * @returns The spoofed method, or undefined.
+     */
+    private extractSpoofedMethod;
+    /**
+     * Convert the raw event into a Node.js IncomingMessage.
+     *
+     * @param rawEvent - The raw event from the platform.
+     * @returns The converted IncomingMessage.
+     */
+    private toNodeMessage;
+    /**
+     * Extract and parse the body from the message.
+     *
+     * @param message - The incoming HTTP message.
+     * @returns A Promise resolving to the parsed body.
+     * @throws {AwsLambdaHttpAdapterError} If the body parsing fails or is invalid.
+     */
+    private getBody;
+    /**
+     * Decode the request body into a Buffer, honouring base64 encoding.
+     *
+     * @param rawEvent - The raw event containing the body.
+     * @param encoding - The charset for a plain-text (non-base64) body.
+     * @returns The body as a Buffer.
+     */
+    private getRawBuffer;
+    /**
+     * Parse the body content based on the specified type and encoding.
+     *
+     * @param type - The content type of the body.
+     * @param buffer - The raw body content as a Buffer.
+     * @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.
+ */
+export declare const MetaBodyEventMiddleware: MetaMiddleware<any, any>;

package/dist/middleware/FilesEventMiddleware.d.ts

@@ -0,0 +1,42 @@
+import { IBlueprint, NextMiddleware, type MetaMiddleware } from '@stone-js/core';
+import { AwsLambdaHttpAdapterContext, AwsLambdaHttpAdapterResponseBuilder } from '../declarations';
+/**
+ * Class representing a FilesEventMiddleware.
+ *
+ * @author Mr. Stone <evensstone@gmail.com>
+ */
+export 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.
+ */
+export declare const MetaFilesEventMiddleware: MetaMiddleware<any, any>;

package/dist/middleware/IncomingEventMiddleware.d.ts

@@ -0,0 +1,97 @@
+import { IBlueprint, NextMiddleware, type MetaMiddleware } from '@stone-js/core';
+import { AwsLambdaHttpAdapterContext, AwsLambdaHttpAdapterResponseBuilder } from '../declarations';
+/**
+ * Middleware for handling incoming events and transforming them into Stone.js events.
+ *
+ * It first normalizes the raw AWS event (API Gateway v1/v2, ALB, Function URLs) into a single
+ * canonical shape, then extracts URL, IP addresses, headers, cookies, query and the raw body,
+ * so the pipeline never has to reason about which trigger fired. The untouched request body is
+ * always exposed as `metadata.rawBody` — even when no body-parsing middleware is installed — so
+ * consumers can read the original payload (e.g. to verify a webhook signature).
+ */
+export declare class IncomingEventMiddleware {
+    /**
+     * The blueprint for resolving configuration and dependencies.
+     */
+    private readonly blueprint;
+    /**
+     * Create an IncomingEventMiddleware instance.
+     *
+     * @param options - Options containing the blueprint for resolving configuration and dependencies.
+     */
+    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 processed context.
+     * @throws {AwsLambdaHttpAdapterError} If required components are missing in the context.
+     */
+    handle(context: AwsLambdaHttpAdapterContext, next: NextMiddleware<AwsLambdaHttpAdapterContext, AwsLambdaHttpAdapterResponseBuilder>): Promise<AwsLambdaHttpAdapterResponseBuilder>;
+    /**
+     * Create the IncomingEventSource from the context.
+     *
+     * @param context - The adapter context containing the raw event, execution context, and other data.
+     * @returns The Incoming Event Source.
+     */
+    private getSource;
+    /**
+     * Extracts proxy-related options from the blueprint.
+     *
+     * @returns Proxy options.
+     */
+    private getProxyOptions;
+    /**
+     * Retrieves cookie-related options from the blueprint.
+     *
+     * @returns Cookie options.
+     */
+    private getCookieOptions;
+    /**
+     * Retrieves the cookie secret from the blueprint.
+     *
+     * @returns The cookie secret string.
+     */
+    private getCookieSecret;
+    /**
+     * Extracts and parses the URL (including the query string) from the normalized event.
+     *
+     * @param event - The normalized HTTP event.
+     * @param options - Proxy options.
+     * @returns The parsed URL object.
+     */
+    private extractUrl;
+    /**
+     * Extracts a list of IP addresses from the normalized event.
+     *
+     * @param event - The normalized HTTP event.
+     * @param options - Proxy options.
+     * @returns An array of IP addresses.
+     */
+    private extractIpAddresses;
+    /**
+     * Converts the normalized event to a minimal Node.js IncomingMessage for `proxy-addr`.
+     *
+     * All standard forwarding headers are forwarded (not just `x-forwarded-for`) so proxy-addr can
+     * honour the deployment's trust configuration.
+     *
+     * @param event - The normalized HTTP event.
+     * @returns The converted IncomingMessage.
+     */
+    private toNodeMessage;
+    /**
+     * Determines the protocol from the normalized event.
+     *
+     * @param event - The normalized HTTP event.
+     * @param options - Proxy options.
+     * @returns The protocol string.
+     */
+    private getProtocol;
+}
+/**
+ * Meta Middleware for processing incoming events.
+ */
+export declare const MetaIncomingEventMiddleware: MetaMiddleware<any, any>;

package/dist/middleware/ServerResponseMiddleware.d.ts

@@ -0,0 +1,23 @@
+import { NextMiddleware, type MetaMiddleware } from '@stone-js/core';
+import { AwsLambdaHttpAdapterContext, AwsLambdaHttpAdapterResponseBuilder } from '../declarations';
+/**
+ * Middleware for handling server responses and transforming them into the appropriate HTTP responses.
+ *
+ * This middleware processes outgoing responses and attaches the necessary headers, status codes,
+ * and body content to the HTTP response.
+ */
+export declare class ServerResponseMiddleware {
+    /**
+     * Handles the outgoing response, 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 resolving to the rawResponseBuilder.
+     * @throws {AwsLambdaHttpAdapterError} If required components are missing in the context.
+     */
+    handle(context: AwsLambdaHttpAdapterContext, next: NextMiddleware<AwsLambdaHttpAdapterContext, AwsLambdaHttpAdapterResponseBuilder>): Promise<AwsLambdaHttpAdapterResponseBuilder>;
+}
+/**
+ * Meta Middleware for processing server responses.
+ */
+export declare const MetaServerResponseMiddleware: MetaMiddleware<any, any>;

package/dist/options/AwsLambdaHttpAdapterBlueprint.d.ts

@@ -0,0 +1,41 @@
+import { AwsLambdaContext, AwsLambdaHttpEvent, RawHttpResponse } from '../declarations';
+import { AdapterConfig, AppConfig, StoneBlueprint } from '@stone-js/core';
+import { HttpConfig, IncomingHttpEvent, IncomingHttpEventOptions, OutgoingHttpResponse } from '@stone-js/http-core';
+/**
+ * Configuration interface for the AWS Lambda Http Adapter.
+ *
+ * Extends the `AdapterConfig` interface from the Stone.js framework and provides
+ * customizable options specific to the AWS Lambda platform. This includes
+ * alias, resolver, middleware, hooks, and various adapter state flags.
+ */
+export interface AwsLambdaHttpAdapterAdapterConfig extends AdapterConfig<AwsLambdaHttpEvent, RawHttpResponse, AwsLambdaContext, IncomingHttpEvent, IncomingHttpEventOptions, OutgoingHttpResponse> {
+}
+/**
+ * Represents the AwsLambdaHttpAdapterConfig configuration options for the application.
+ */
+export interface AwsLambdaHttpAdapterConfig extends Partial<AppConfig<IncomingHttpEvent, OutgoingHttpResponse>> {
+    http: Partial<HttpConfig>;
+}
+/**
+ * Blueprint interface for the AWS Lambda Http Adapter.
+ *
+ * This interface extends `StoneBlueprint` and defines the structure of the
+ * AWS Lambda Http adapter blueprint used in the Stone.js framework. It includes
+ * a `stone` object with an array of `AwsLambdaHttpAdapterConfig` items.
+ */
+export interface AwsLambdaHttpAdapterBlueprint extends StoneBlueprint<IncomingHttpEvent, OutgoingHttpResponse> {
+    /**
+     * Application-level settings, including environment, middleware, logging, and service registration.
+     */
+    stone: AwsLambdaHttpAdapterConfig;
+}
+/**
+ * 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`).
+ */
+export declare const awsLambdaHttpAdapterBlueprint: AwsLambdaHttpAdapterBlueprint;

package/dist/resolvers.d.ts

@@ -0,0 +1,10 @@
+import { AdapterResolver } from '@stone-js/core';
+/**
+ * Adapter resolver for AWS Lambda HTTP adapter.
+ *
+ * Creates and configures an `AWSLambdaHttpAdapter` for handling HTTP events in AWS Lambda.
+ *
+ * @param blueprint - The `IBlueprint` providing configuration and dependencies.
+ * @returns An `AWSLambdaHttpAdapter` instance.
+ */
+export declare const awsLambdaHttpAdapterResolver: AdapterResolver;

package/package.json

@@ -1,16 +1,17 @@
 {
   "name": "@stone-js/aws-lambda-http-adapter",
-  "version": "0.3.1",
+  "version": "0.8.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",
   "repository": {
     "type": "git",
-    "url": "git+ssh://git@github.com/stone-foundation/stone-js-aws-lambda-http-adapter.git"
+    "url": "git+https://github.com/stone-foundation/stone-js-framework.git",
+    "directory": "stone-js-aws-lambda-http-adapter"
   },
   "homepage": "https://stonejs.dev",
   "bugs": {
-    "url": "https://github.com/stone-foundation/stone-js-aws-lambda-http-adapter/issues"
+    "url": "https://github.com/stone-foundation/stone-js-framework/issues"
   },
   "keywords": [
     "aws",
@@ -31,6 +32,7 @@
     "/dist"
   ],
   "type": "module",
+  "sideEffects": false,
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
@@ -52,7 +54,7 @@
     "lint:fix": "ts-standard --fix src tests",
     "predoc": "rimraf docs",
     "doc": "typedoc",
-    "prebuild": "rimraf dist && npm run doc",
+    "clean": "rimraf dist",
     "build": "rollup -c",
     "test": "vitest run",
     "test:cvg": "npm run test -- --coverage",
@@ -62,12 +64,13 @@
     "prepare": "husky"
   },
   "peerDependencies": {
-    "@stone-js/core": "^0.2.1",
-    "@stone-js/env": "^0.1.2",
-    "@stone-js/filesystem": "^0.1.2",
-    "@stone-js/http-core": "^0.1.4"
+    "@stone-js/core": "workspace:*",
+    "@stone-js/env": "workspace:*",
+    "@stone-js/filesystem": "workspace:*",
+    "@stone-js/http-core": "workspace:*"
   },
   "dependencies": {
+    "@stone-js/config": "workspace:*",
     "accepts": "^1.3.8",
     "bytes": "^3.1.2",
     "content-type": "^1.0.5",
@@ -94,8 +97,6 @@
     "husky": "^9.1.7",
     "rimraf": "^6.1.0",
     "rollup": "^4.52.5",
-    "rollup-plugin-delete": "^3.0.1",
-    "rollup-plugin-dts": "^6.2.3",
     "rollup-plugin-node-externals": "^8.1.1",
     "ts-standard": "^12.0.2",
     "tslib": "^2.8.1",