quantum-flow 1.20.1 → 1.20.3

package/README.md

@@ -134,11 +134,12 @@ server.listen().catch(console.error);
 - Use `@Headers` to access request headers.
 - Use `@Query` to handle query parameters.
 - Use `@Params` to access route parameters.
-- Use `@Multipart` for handling multipart/form-data requests.
+- Use `@Files` to access files sent within multipart/form-data requests.
+  Text sent as multipart/form-data is exposed with `@Body` decorators
 - Use `@Request` to access the original request object.
 - Use `@Response` to access the original object.
 - Use `@InjectWS` to access the websocket service.
-- Use `@InjectSSE()` to access the server-side-event service.
+- Use `@InjectSSE` to access the server-side-event service.
 
 # AWS Lambda Support
 
@@ -146,7 +147,7 @@ Use `LambdaAdapter` to convert API Gateway events to requests and responses. Cre
 
 ```typescript
 Example Lambda handler creation
-import { LambdaAdapter, LambdaRequest } from 'quantum-flow/aws';
+import { LambdaAdapter, LambdaRequest, LambdaResponse } from 'quantum-flow/aws';
 import { Request, Query, Headers, Params, Response } from  'quantum-flow/core'
 
 @Controller({ prefix: 'user' })
@@ -156,7 +157,7 @@ class UserController {
     @Headers() headers: Record<string, string | string[]>,
     @Params(ParamDTO, 'param') params: string,
     @Request() req: LambdaRequest,
-    @Response() res: ServerResponse
+    @Response() res: LambdaResponse
   ) { }
 }
 const lambdaAdapter = new LambdaAdapter(UserController);

package/dist/app/aws/index.d.ts

@@ -1,2 +1,2 @@
-export { LambdaEvent, LambdaRequest } from '../../types/index.js';
+export { LambdaEvent, LambdaRequest, LambdaResponse } from '../../types/index.js';
 export * from './lambda';

package/dist/app/aws/utils/response.d.ts

@@ -1,15 +1,20 @@
-import { ILResponse } from '../../../types/index.js';
-import { ServerResponse } from 'http';
-export declare class LResponse implements ILResponse {
-    private originalResponse?;
+import { CookieOptions, LambdaResponse } from '../../../types/index.js';
+export declare class LResponse implements LambdaResponse {
     private _statusCode;
     private _headers;
     body: any;
-    constructor(originalResponse?: ServerResponse | undefined);
+    isBase64Encoded?: boolean;
+    _cookies: string[];
+    setCookie(name: string, value: string, options?: CookieOptions): void;
+    clearCookie(name: string, options?: {
+        path?: string;
+        domain?: string;
+    }): void;
+    getCookies(): string[];
+    clearAllCookies(): void;
+    private _updateCookieHeader;
     setHeader(name: string, value: string): void;
     set statusCode(code: number);
     get statusCode(): number;
     get headers(): Record<string, string>;
-    send(): void;
-    get original(): ServerResponse | undefined;
 }

package/dist/app/aws/utils/response.js

@@ -2,24 +2,61 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LResponse = void 0;
 class LResponse {
-    originalResponse;
     _statusCode = 200;
     _headers = {};
     body = null;
-    constructor(originalResponse) {
-        this.originalResponse = originalResponse;
+    isBase64Encoded;
+    _cookies;
+    setCookie(name, value, options) {
+        let cookie = `${name}=${encodeURIComponent(value)}`;
+        if (options) {
+            if (options.maxAge)
+                cookie += `; Max-Age=${options.maxAge}`;
+            if (options.expires)
+                cookie += `; Expires=${options.expires.toUTCString()}`;
+            if (options.domain)
+                cookie += `; Domain=${options.domain}`;
+            if (options.path)
+                cookie += `; Path=${options.path}`;
+            if (options.secure)
+                cookie += `; Secure`;
+            if (options.httpOnly)
+                cookie += `; HttpOnly`;
+            if (options.sameSite)
+                cookie += `; SameSite=${options.sameSite}`;
+            if (options.priority)
+                cookie += `; Priority=${options.priority}`;
+            if (options.partitioned)
+                cookie += `; Partitioned`;
+        }
+        this._cookies.push(cookie);
+        this._updateCookieHeader();
+    }
+    clearCookie(name, options) {
+        const cookie = `${name}=; Max-Age=0; Expires=${new Date(0).toUTCString()}${options?.path ? `; Path=${options.path}` : ''}${options?.domain ? `; Domain=${options.domain}` : ''}`;
+        this._cookies.push(cookie);
+        this._updateCookieHeader();
+    }
+    getCookies() {
+        return [...this._cookies];
+    }
+    clearAllCookies() {
+        this._cookies = [];
+        delete this._headers['Set-Cookie'];
+    }
+    _updateCookieHeader() {
+        if (this._cookies.length > 0) {
+            this._headers['Set-Cookie'] = this._cookies.join(', ');
+        }
+        else {
+            delete this._headers['Set-Cookie'];
+        }
     }
     setHeader(name, value) {
         this._headers[name] = value;
-        if (this.originalResponse) {
-            this.originalResponse.setHeader(name, value);
-        }
     }
     set statusCode(code) {
         this._statusCode = code;
-        if (this.originalResponse) {
-            this.originalResponse.statusCode = code;
-        }
     }
     get statusCode() {
         return this._statusCode;
@@ -27,12 +64,6 @@ class LResponse {
     get headers() {
         return { ...this._headers };
     }
-    send() {
-        throw `Lambda response doesn't have "send" method`;
-    }
-    get original() {
-        return this.originalResponse;
-    }
 }
 exports.LResponse = LResponse;
 //# sourceMappingURL=response.js.map

package/dist/app/aws/utils/response.js.map

@@ -1 +1 @@
-{"version":3,"file":"response.js","sourceRoot":"","sources":["../../../../src/app/aws/utils/response.ts"],"names":[],"mappings":";;;AAGA,MAAa,SAAS;IAKA;IAJZ,WAAW,GAAW,GAAG,CAAC;IAC1B,QAAQ,GAA2B,EAAE,CAAC;IAC9C,IAAI,GAAQ,IAAI,CAAC;IAEjB,YAAoB,gBAAiC;QAAjC,qBAAgB,GAAhB,gBAAgB,CAAiB;IAAG,CAAC;IAEzD,SAAS,CAAC,IAAY,EAAE,KAAa;QACnC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QAC5B,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,IAAI,UAAU,CAAC,IAAY;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,IAAI,CAAC,gBAAgB,CAAC,UAAU,GAAG,IAAI,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,IAAI,OAAO;QACT,OAAO,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC;IAED,IAAI;QACF,MAAM,4CAA4C,CAAC;IACrD,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;CACF;AApCD,8BAoCC"}
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../../../src/app/aws/utils/response.ts"],"names":[],"mappings":"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"}

package/dist/core/decorators.d.ts

@@ -78,11 +78,11 @@ export declare const Cookies: (name?: string) => (target: any, propertyKey: stri
  *
  * Usage:
  * ```ts
- * @Multipart() multipartData: any
- * @Multipart('file') file: File
+ * @Files() multipartData: any
+ * @Files('file') file: File
  * ```
  */
-export declare const Multipart: (name?: string) => (target: any, propertyKey: string | symbol, parameterIndex: number) => void;
+export declare const Files: (name?: string) => (target: any, propertyKey: string | symbol, parameterIndex: number) => void;
 /**
  * Parameter decorator to inject the response object.
  *

package/dist/core/decorators.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Response = exports.Multipart = exports.Cookies = exports.Headers = exports.Request = exports.Query = exports.Params = exports.Body = void 0;
+exports.Response = exports.Files = exports.Cookies = exports.Headers = exports.Request = exports.Query = exports.Params = exports.Body = void 0;
 const _utils_1 = require("../utils/index.js");
 /**
  * Parameter decorator to extract and validate the request body.
@@ -88,12 +88,12 @@ exports.Cookies = Cookies;
  *
  * Usage:
  * ```ts
- * @Multipart() multipartData: any
- * @Multipart('file') file: File
+ * @Files() multipartData: any
+ * @Files('file') file: File
  * ```
  */
-const Multipart = (name) => (0, _utils_1.createParamDecorator)('multipart', undefined, name);
-exports.Multipart = Multipart;
+const Files = (name) => (0, _utils_1.createParamDecorator)('multipart', undefined, name);
+exports.Files = Files;
 /**
  * Parameter decorator to inject the response object.
  *

package/dist/core/decorators.js.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/core/decorators.ts"],"names":[],"mappings":";;;AAAA,mCAA8C;AAE9C;;;;;;;;;;GAUG;AACI,MAAM,IAAI,GAAG,CAAC,GAAS,EAAE,EAAE,CAAC,IAAA,6BAAoB,EAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAAxD,QAAA,IAAI,QAAoD;AAErE;;;;;;;;;;;;GAYG;AACI,MAAM,MAAM,GAAG,CAAC,GAAS,EAAE,IAAa,EAAE,EAAE,CACjD,IAAA,6BAAoB,EAClB,QAAQ,EACR,OAAO,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,EACxC,OAAO,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CACpC,CAAC;AALS,QAAA,MAAM,UAKf;AAEJ;;;;;;;;;;;;GAYG;AACI,MAAM,KAAK,GAAG,CAAC,GAAS,EAAE,IAAa,EAAE,EAAE,CAChD,IAAA,6BAAoB,EAClB,OAAO,EACP,OAAO,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,EACxC,OAAO,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CACpC,CAAC;AALS,QAAA,KAAK,SAKd;AAEJ;;;;;;;GAOG;AACI,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,IAAA,6BAAoB,EAAC,SAAS,CAAC,CAAC;AAAhD,QAAA,OAAO,WAAyC;AAE7D;;;;;;;;;;GAUG;AACI,MAAM,OAAO,GAAG,CAAC,IAAa,EAAE,EAAE,CAAC,IAAA,6BAAoB,EAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;AAA9E,QAAA,OAAO,WAAuE;AAE3F;;;;;;;;;;GAUG;AACI,MAAM,OAAO,GAAG,CAAC,IAAa,EAAE,EAAE,CAAC,IAAA,6BAAoB,EAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;AAA9E,QAAA,OAAO,WAAuE;AAE3F;;;;;;;;;;GAUG;AACI,MAAM,SAAS,GAAG,CAAC,IAAa,EAAE,EAAE,CAAC,IAAA,6BAAoB,EAAC,WAAW,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;AAAlF,QAAA,SAAS,aAAyE;AAE/F;;;;;;;GAOG;AACI,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,IAAA,6BAAoB,EAAC,UAAU,CAAC,CAAC;AAAlD,QAAA,QAAQ,YAA0C"}
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/core/decorators.ts"],"names":[],"mappings":";;;AAAA,mCAA8C;AAE9C;;;;;;;;;;GAUG;AACI,MAAM,IAAI,GAAG,CAAC,GAAS,EAAE,EAAE,CAAC,IAAA,6BAAoB,EAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAAxD,QAAA,IAAI,QAAoD;AAErE;;;;;;;;;;;;GAYG;AACI,MAAM,MAAM,GAAG,CAAC,GAAS,EAAE,IAAa,EAAE,EAAE,CACjD,IAAA,6BAAoB,EAClB,QAAQ,EACR,OAAO,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,EACxC,OAAO,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CACpC,CAAC;AALS,QAAA,MAAM,UAKf;AAEJ;;;;;;;;;;;;GAYG;AACI,MAAM,KAAK,GAAG,CAAC,GAAS,EAAE,IAAa,EAAE,EAAE,CAChD,IAAA,6BAAoB,EAClB,OAAO,EACP,OAAO,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,EACxC,OAAO,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CACpC,CAAC;AALS,QAAA,KAAK,SAKd;AAEJ;;;;;;;GAOG;AACI,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,IAAA,6BAAoB,EAAC,SAAS,CAAC,CAAC;AAAhD,QAAA,OAAO,WAAyC;AAE7D;;;;;;;;;;GAUG;AACI,MAAM,OAAO,GAAG,CAAC,IAAa,EAAE,EAAE,CAAC,IAAA,6BAAoB,EAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;AAA9E,QAAA,OAAO,WAAuE;AAE3F;;;;;;;;;;GAUG;AACI,MAAM,OAAO,GAAG,CAAC,IAAa,EAAE,EAAE,CAAC,IAAA,6BAAoB,EAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;AAA9E,QAAA,OAAO,WAAuE;AAE3F;;;;;;;;;;GAUG;AACI,MAAM,KAAK,GAAG,CAAC,IAAa,EAAE,EAAE,CAAC,IAAA,6BAAoB,EAAC,WAAW,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;AAA9E,QAAA,KAAK,SAAyE;AAE3F;;;;;;;GAOG;AACI,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,IAAA,6BAAoB,EAAC,UAAU,CAAC,CAAC;AAAlD,QAAA,QAAQ,YAA0C"}

package/dist/types/common.d.ts

@@ -64,4 +64,15 @@ export declare enum HTTP_METHODS {
     OPTIONS = "OPTIONS",
     HEAD = "HEAD"
 }
+export interface CookieOptions {
+    maxAge?: number;
+    expires?: Date;
+    domain?: string;
+    path?: string;
+    secure?: boolean;
+    httpOnly?: boolean;
+    sameSite?: 'Strict' | 'Lax' | 'None';
+    priority?: 'Low' | 'Medium' | 'High';
+    partitioned?: boolean;
+}
 export {};

package/dist/types/lambda.d.ts

@@ -1,5 +1,5 @@
 import { APIGatewayProxyEvent, APIGatewayProxyEventV2, Context, Handler } from 'aws-lambda';
-import { HTTP_METHODS } from './common';
+import { CookieOptions, HTTP_METHODS } from './common';
 import { ControllerClass } from './controller';
 import { MultipartFile } from './multipart';
 import { LambdaPlugin } from './plugins';
@@ -51,14 +51,6 @@ export interface LambdaRequestMeta {
     sourceIp?: string;
     userAgent?: string;
 }
-export interface LambdaResponse {
-    statusCode: number;
-    headers?: Record<string, string>;
-    body: string;
-    isBase64Encoded?: boolean;
-    multiValueHeaders?: Record<string, string[]>;
-    cookies?: string[];
-}
 export interface LambdaApp {
     beforeStart?: () => void;
 }
@@ -86,13 +78,20 @@ export interface LambdaRequest {
     sourceIp: string;
     end(): void;
 }
-export interface ILResponse {
+export interface LambdaResponse {
     body: any;
-    setHeader(name: string, value: string): void;
     statusCode: number;
-    headers: Record<string, string>;
-    send(): void;
-    original: any;
+    headers?: Record<string, string>;
+    cookies?: string[];
+    isBase64Encoded?: boolean;
+    setHeader(name: string, value: string): void;
+    setCookie(name: string, value: string, options?: CookieOptions): void;
+    clearCookie(name: string, options?: {
+        path?: string;
+        domain?: string;
+    }): void;
+    getCookies(): string[];
+    clearAllCookies(): void;
 }
 export interface ILambdaAdapter {
     handler: Handler;

package/dist/types/plugins.d.ts

@@ -2,7 +2,7 @@ import { Context } from 'aws-lambda';
 import { IncomingMessage, Server, ServerResponse } from 'http';
 import { AppRequest, MiddlewareCB } from './common';
 import { IHttpServer } from './http';
-import { ILambdaAdapter, ILResponse, LambdaEvent, LambdaRequest } from './lambda';
+import { ILambdaAdapter, LambdaEvent, LambdaRequest, LambdaResponse } from './lambda';
 export interface HttpPluginHooks {
     beforeRequest?: (req: IncomingMessage) => void | Promise<void>;
     beforeRoute?: (req: AppRequest, response: ServerResponse) => void | Promise<void>;
@@ -21,7 +21,7 @@ export type PluginKeys = keyof Omit<HttpPlugin, 'name' | 'hooks'>;
 export interface LambdaPluginHooks {
     beforeRequest?: (event: LambdaEvent, context: Context) => void | Promise<void>;
     beforeRoute?: (req: LambdaRequest) => void | Promise<void>;
-    afterResponse?: (req: LambdaRequest, res: ILResponse) => void | Promise<void>;
+    afterResponse?: (req: LambdaRequest, res: LambdaResponse) => void | Promise<void>;
 }
 export interface LambdaPlugin {
     name: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quantum-flow",
-  "version": "1.20.1",
+  "version": "1.20.3",
   "description": "Decorator-based API framework",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",