@noony-serverless/core 0.3.0 → 0.3.1

package/build/middlewares/authenticationMiddleware.d.ts

@@ -209,7 +209,8 @@ export interface AuthenticationOptions {
  * Class-based authentication middleware with comprehensive security features.
  * Provides JWT validation, rate limiting, token blacklisting, and security logging.
  *
- * @template T - The type of user data returned by the token verification port
+ * @template TUser - The type of user data returned by the token verification port
+ * @template TBody - The type of the request body payload (preserves type chain)
  *
  * @example
  * Basic JWT authentication:
@@ -292,17 +293,18 @@ export interface AuthenticationOptions {
  * });
  * ```
  */
-export declare class AuthenticationMiddleware<T> implements BaseMiddleware {
+export declare class AuthenticationMiddleware<TUser = unknown, TBody = unknown> implements BaseMiddleware<TBody, TUser> {
     private tokenVerificationPort;
     private options;
-    constructor(tokenVerificationPort: CustomTokenVerificationPort<T>, options?: AuthenticationOptions);
-    before(context: Context): Promise<void>;
+    constructor(tokenVerificationPort: CustomTokenVerificationPort<TUser>, options?: AuthenticationOptions);
+    before(context: Context<TBody, TUser>): Promise<void>;
 }
 /**
  * Factory function that creates an authentication middleware with token verification.
  * Provides a functional approach for authentication setup.
  *
- * @template T - The type of user data returned by the token verification port
+ * @template TUser - The type of user data returned by the token verification port
+ * @template TBody - The type of the request body payload (preserves type chain)
  * @param tokenVerificationPort - The token verification implementation
  * @param options - Authentication configuration options
  * @returns A BaseMiddleware object with authentication logic
@@ -427,5 +429,5 @@ export declare class AuthenticationMiddleware<T> implements BaseMiddleware {
  * };
  * ```
  */
-export declare const verifyAuthTokenMiddleware: <T>(tokenVerificationPort: CustomTokenVerificationPort<T>, options?: AuthenticationOptions) => BaseMiddleware;
+export declare const verifyAuthTokenMiddleware: <TUser = unknown, TBody = unknown>(tokenVerificationPort: CustomTokenVerificationPort<TUser>, options?: AuthenticationOptions) => BaseMiddleware<TBody, TUser>;
 //# sourceMappingURL=authenticationMiddleware.d.ts.map

package/build/middlewares/authenticationMiddleware.js

@@ -173,7 +173,8 @@ async function verifyToken(tokenVerificationPort, context, options = {}) {
  * Class-based authentication middleware with comprehensive security features.
  * Provides JWT validation, rate limiting, token blacklisting, and security logging.
  *
- * @template T - The type of user data returned by the token verification port
+ * @template TUser - The type of user data returned by the token verification port
+ * @template TBody - The type of the request body payload (preserves type chain)
  *
  * @example
  * Basic JWT authentication:
@@ -272,7 +273,8 @@ exports.AuthenticationMiddleware = AuthenticationMiddleware;
  * Factory function that creates an authentication middleware with token verification.
  * Provides a functional approach for authentication setup.
  *
- * @template T - The type of user data returned by the token verification port
+ * @template TUser - The type of user data returned by the token verification port
+ * @template TBody - The type of the request body payload (preserves type chain)
  * @param tokenVerificationPort - The token verification implementation
  * @param options - Authentication configuration options
  * @returns A BaseMiddleware object with authentication logic

package/build/middlewares/bodyParserMiddleware.d.ts

@@ -8,7 +8,8 @@ import { BaseMiddleware, Context } from '../core';
  * - Base64 decoding for Pub/Sub messages
  * - Non-blocking parsing using setImmediate
  *
- * @template T - The expected type of the parsed body. Defaults to unknown if not specified.
+ * @template TBody - The expected type of the parsed body. Defaults to unknown if not specified.
+ * @template TUser - The type of the authenticated user (preserves type chain)
  * @implements {BaseMiddleware}
  *
  * @example
@@ -63,10 +64,10 @@ import { BaseMiddleware, Context } from '../core';
  *   });
  * ```
  */
-export declare class BodyParserMiddleware<T = unknown> implements BaseMiddleware {
+export declare class BodyParserMiddleware<TBody = unknown, TUser = unknown> implements BaseMiddleware<TBody, TUser> {
     private maxSize;
     constructor(maxSize?: number);
-    before(context: Context): Promise<void>;
+    before(context: Context<TBody, TUser>): Promise<void>;
 }
 /**
  * Enhanced middleware function for parsing the request body in specific HTTP methods.
@@ -76,7 +77,8 @@ export declare class BodyParserMiddleware<T = unknown> implements BaseMiddleware
  * - Async parsing for large payloads
  * - Size validation
  *
- * @template T - The expected type of the parsed request body.
+ * @template TBody - The expected type of the parsed request body.
+ * @template TUser - The type of the authenticated user (preserves type chain)
  * @param maxSize - Maximum allowed body size in bytes (default: 1MB)
  * @returns {BaseMiddleware} A middleware object containing a `before` hook.
  *
@@ -126,5 +128,5 @@ export declare class BodyParserMiddleware<T = unknown> implements BaseMiddleware
  *   });
  * ```
  */
-export declare const bodyParser: <T = unknown>(maxSize?: number) => BaseMiddleware;
+export declare const bodyParser: <TBody = unknown, TUser = unknown>(maxSize?: number) => BaseMiddleware<TBody, TUser>;
 //# sourceMappingURL=bodyParserMiddleware.d.ts.map

package/build/middlewares/bodyParserMiddleware.js

@@ -157,7 +157,8 @@ const parseBody = async (body) => {
  * - Base64 decoding for Pub/Sub messages
  * - Non-blocking parsing using setImmediate
  *
- * @template T - The expected type of the parsed body. Defaults to unknown if not specified.
+ * @template TBody - The expected type of the parsed body. Defaults to unknown if not specified.
+ * @template TUser - The type of the authenticated user (preserves type chain)
  * @implements {BaseMiddleware}
  *
  * @example
@@ -241,7 +242,8 @@ exports.BodyParserMiddleware = BodyParserMiddleware;
  * - Async parsing for large payloads
  * - Size validation
  *
- * @template T - The expected type of the parsed request body.
+ * @template TBody - The expected type of the parsed request body.
+ * @template TUser - The type of the authenticated user (preserves type chain)
  * @param maxSize - Maximum allowed body size in bytes (default: 1MB)
  * @returns {BaseMiddleware} A middleware object containing a `before` hook.
  *

package/build/middlewares/errorHandlerMiddleware.d.ts

@@ -4,6 +4,9 @@ import { BaseMiddleware, Context } from '../core';
  * Implements the `BaseMiddleware` interface and provides an asynchronous
  * `onError` method that delegates error handling to the `handleError` function.
  *
+ * @template TBody - The type of the request body payload (preserves type chain)
+ * @template TUser - The type of the authenticated user (preserves type chain)
+ *
  * @remarks
  * This middleware should be registered to catch and process errors that occur
  * during request handling.
@@ -50,12 +53,14 @@ import { BaseMiddleware, Context } from '../core';
  * });
  * ```
  */
-export declare class ErrorHandlerMiddleware implements BaseMiddleware {
-    onError(error: Error, context: Context): Promise<void>;
+export declare class ErrorHandlerMiddleware<TBody = unknown, TUser = unknown> implements BaseMiddleware<TBody, TUser> {
+    onError(error: Error, context: Context<TBody, TUser>): Promise<void>;
 }
 /**
  * Creates an error handling middleware for processing errors in the application.
  *
+ * @template TBody - The type of the request body payload (preserves type chain)
+ * @template TUser - The type of the authenticated user (preserves type chain)
  * @returns {BaseMiddleware} An object implementing the `onError` method to handle errors.
  *
  * @remarks
@@ -96,5 +101,5 @@ export declare class ErrorHandlerMiddleware implements BaseMiddleware {
  *   });
  * ```
  */
-export declare const errorHandler: () => BaseMiddleware;
+export declare const errorHandler: <TBody = unknown, TUser = unknown>() => BaseMiddleware<TBody, TUser>;
 //# sourceMappingURL=errorHandlerMiddleware.d.ts.map

package/build/middlewares/errorHandlerMiddleware.js

@@ -9,6 +9,8 @@ const core_1 = require("../core");
  * - For `HttpError` instances, responds with the error message, and optionally details and code based on environment and error type.
  * - For other errors, responds with a generic message in production, and includes stack trace in development.
  *
+ * @template TBody - The type of the request body payload (preserves type chain)
+ * @template TUser - The type of the authenticated user (preserves type chain)
  * @param error - The error object thrown during request processing.
  * @param context - The request context containing request and response objects.
  * @returns A promise that resolves when the error response has been sent.
@@ -65,6 +67,9 @@ const handleError = async (error, context) => {
  * Implements the `BaseMiddleware` interface and provides an asynchronous
  * `onError` method that delegates error handling to the `handleError` function.
  *
+ * @template TBody - The type of the request body payload (preserves type chain)
+ * @template TUser - The type of the authenticated user (preserves type chain)
+ *
  * @remarks
  * This middleware should be registered to catch and process errors that occur
  * during request handling.
@@ -120,6 +125,8 @@ exports.ErrorHandlerMiddleware = ErrorHandlerMiddleware;
 /**
  * Creates an error handling middleware for processing errors in the application.
  *
+ * @template TBody - The type of the request body payload (preserves type chain)
+ * @template TUser - The type of the authenticated user (preserves type chain)
  * @returns {BaseMiddleware} An object implementing the `onError` method to handle errors.
  *
  * @remarks

package/build/middlewares/queryParametersMiddleware.d.ts

@@ -3,6 +3,8 @@ import { BaseMiddleware, Context } from '../core';
  * Middleware class that validates and processes query parameters from the request URL.
  * Extracts query parameters and validates that required parameters are present.
  *
+ * @template TBody - The type of the request body payload (preserves type chain)
+ * @template TUser - The type of the authenticated user (preserves type chain)
  * @implements {BaseMiddleware}
  *
  * @example
@@ -43,15 +45,17 @@ import { BaseMiddleware, Context } from '../core';
  *   });
  * ```
  */
-export declare class QueryParametersMiddleware implements BaseMiddleware {
+export declare class QueryParametersMiddleware<TBody = unknown, TUser = unknown> implements BaseMiddleware<TBody, TUser> {
     private readonly requiredParams;
     constructor(requiredParams?: string[]);
-    before(context: Context): Promise<void>;
+    before(context: Context<TBody, TUser>): Promise<void>;
 }
 /**
  * Factory function that creates a query parameter processing middleware.
  * Extracts and validates query parameters from the request URL.
  *
+ * @template TBody - The type of the request body payload (preserves type chain)
+ * @template TUser - The type of the authenticated user (preserves type chain)
  * @param requiredParams - Array of parameter names that must be present (default: empty array)
  * @returns BaseMiddleware object with query parameter processing logic
  *
@@ -109,5 +113,5 @@ export declare class QueryParametersMiddleware implements BaseMiddleware {
  *   });
  * ```
  */
-export declare const queryParametersMiddleware: (requiredParams?: string[]) => BaseMiddleware;
+export declare const queryParametersMiddleware: <TBody = unknown, TUser = unknown>(requiredParams?: string[]) => BaseMiddleware<TBody, TUser>;
 //# sourceMappingURL=queryParametersMiddleware.d.ts.map

package/build/middlewares/queryParametersMiddleware.js

@@ -24,6 +24,8 @@ const convertQueryToRecord = (query) => {
  * Middleware class that validates and processes query parameters from the request URL.
  * Extracts query parameters and validates that required parameters are present.
  *
+ * @template TBody - The type of the request body payload (preserves type chain)
+ * @template TUser - The type of the authenticated user (preserves type chain)
  * @implements {BaseMiddleware}
  *
  * @example
@@ -84,6 +86,8 @@ exports.QueryParametersMiddleware = QueryParametersMiddleware;
  * Factory function that creates a query parameter processing middleware.
  * Extracts and validates query parameters from the request URL.
  *
+ * @template TBody - The type of the request body payload (preserves type chain)
+ * @template TUser - The type of the authenticated user (preserves type chain)
  * @param requiredParams - Array of parameter names that must be present (default: empty array)
  * @returns BaseMiddleware object with query parameter processing logic
  *

package/build/middlewares/responseWrapperMiddleware.d.ts

@@ -5,6 +5,8 @@ import { Context } from '../core/core';
  * Automatically wraps the response with success flag, payload, and timestamp.
  *
  * @template T - The type of response data being wrapped
+ * @template TBody - The type of the request body payload (preserves type chain)
+ * @template TUser - The type of the authenticated user (preserves type chain)
  * @implements {BaseMiddleware}
  *
  * @example
@@ -60,14 +62,16 @@ import { Context } from '../core/core';
  *   });
  * ```
  */
-export declare class ResponseWrapperMiddleware<T> implements BaseMiddleware {
-    after(context: Context): Promise<void>;
+export declare class ResponseWrapperMiddleware<T = unknown, TBody = unknown, TUser = unknown> implements BaseMiddleware<TBody, TUser> {
+    after(context: Context<TBody, TUser>): Promise<void>;
 }
 /**
  * Factory function that creates a response wrapper middleware.
  * Automatically wraps response data in a standardized format with success flag and timestamp.
  *
  * @template T - The type of response data being wrapped
+ * @template TBody - The type of the request body payload (preserves type chain)
+ * @template TUser - The type of the authenticated user (preserves type chain)
  * @returns BaseMiddleware object with response wrapping logic
  *
  * @example
@@ -118,12 +122,14 @@ export declare class ResponseWrapperMiddleware<T> implements BaseMiddleware {
  *   });
  * ```
  */
-export declare const responseWrapperMiddleware: <T>() => BaseMiddleware;
+export declare const responseWrapperMiddleware: <T = unknown, TBody = unknown, TUser = unknown>() => BaseMiddleware<TBody, TUser>;
 /**
  * Helper function to set response data in context for later wrapping.
  * This function should be used in handlers when using ResponseWrapperMiddleware.
  *
  * @template T - The type of data being set
+ * @template TBody - The type of the request body payload (preserves type chain)
+ * @template TUser - The type of the authenticated user (preserves type chain)
  * @param context - The request context
  * @param data - The data to be included in the response payload
  *
@@ -176,5 +182,5 @@ export declare const responseWrapperMiddleware: <T>() => BaseMiddleware;
  *   });
  * ```
  */
-export declare function setResponseData<T>(context: Context, data: T): void;
+export declare function setResponseData<T, TBody = unknown, TUser = unknown>(context: Context<TBody, TUser>, data: T): void;
 //# sourceMappingURL=responseWrapperMiddleware.d.ts.map

package/build/middlewares/responseWrapperMiddleware.js

@@ -18,6 +18,8 @@ const wrapResponse = (context) => {
  * Automatically wraps the response with success flag, payload, and timestamp.
  *
  * @template T - The type of response data being wrapped
+ * @template TBody - The type of the request body payload (preserves type chain)
+ * @template TUser - The type of the authenticated user (preserves type chain)
  * @implements {BaseMiddleware}
  *
  * @example
@@ -84,6 +86,8 @@ exports.ResponseWrapperMiddleware = ResponseWrapperMiddleware;
  * Automatically wraps response data in a standardized format with success flag and timestamp.
  *
  * @template T - The type of response data being wrapped
+ * @template TBody - The type of the request body payload (preserves type chain)
+ * @template TUser - The type of the authenticated user (preserves type chain)
  * @returns BaseMiddleware object with response wrapping logic
  *
  * @example
@@ -145,6 +149,8 @@ exports.responseWrapperMiddleware = responseWrapperMiddleware;
  * This function should be used in handlers when using ResponseWrapperMiddleware.
  *
  * @template T - The type of data being set
+ * @template TBody - The type of the request body payload (preserves type chain)
+ * @template TUser - The type of the authenticated user (preserves type chain)
  * @param context - The request context
  * @param data - The data to be included in the response payload
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noony-serverless/core",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "A Middy base framework compatible with Firebase and GCP Cloud Functions with TypeScript",
   "main": "build/index.js",
   "types": "build/index.d.ts",