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

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';
+    }
+}
+
+/**
+ * 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) => { });
+};
+
+/**
+ * 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

@@ -460,50 +460,6 @@ 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.
  *
@@ -611,6 +567,50 @@ 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stone-js/aws-lambda-http-adapter",
-  "version": "0.1.0",
+  "version": "0.2.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",