@heliosjs/middlewares 7.0.10 → 9.0.0

package/dist/types/core/controller.d.ts

@@ -1,121 +0,0 @@
-import { HANDLE_REQUEST_HASH, WS_HASH } from '../../constants';
-import { HTTP_METHODS, InterceptorCB, MiddlewareCB, ParamMetadata } from './common';
-import { CORSConfig } from './cors';
-import { ErrorHandler } from './error';
-import { Request } from './request';
-import { Response } from './response';
-import { SanitizerConfig } from './sanitize';
-export type ControllerClass = {
-    new (...args: any[]): any;
-};
-export type ControllerMethods = Array<{
-    name: string;
-    httpMethod: HTTP_METHODS;
-    pattern: string;
-    middlewares?: MiddlewareCB[];
-}>;
-export type ControllerType = {
-    [HANDLE_REQUEST_HASH]?(request: Request, response: Response): Promise<any>;
-    [WS_HASH]?: WsControllerHandlers;
-    sse?: SeeControllerHandlers;
-    new (...args: any[]): any;
-};
-export type ControllerInstance = InstanceType<ControllerType>;
-export interface ControllerConfig {
-    prefix: string;
-    middlewares?: Array<MiddlewareCB>;
-    controllers?: ControllerInstance[];
-}
-export type SSE_HANDLER_META = {
-    type: string;
-    method: string;
-};
-export type HandlerMeta = {
-    type: 'connection';
-    topic: undefined;
-    method: 'onconnect';
-    fn: (...args: any[]) => any;
-};
-export type WsHandlerMeta = HandlerMeta & {
-    topic?: string;
-};
-export type WsControllerHandlers = {
-    handlers: {
-        connection: WsHandlerMeta[];
-        message: WsHandlerMeta[];
-        close: WsHandlerMeta[];
-        error: WsHandlerMeta[];
-    };
-    topics: HandlerMeta[];
-};
-export type SeeControllerHandlers = {
-    handlers: {
-        connection: HandlerMeta[];
-        close: HandlerMeta[];
-        error: HandlerMeta[];
-    };
-};
-export type FunctionsMeta = {
-    middlewares: MiddlewareCB[];
-    errors: ErrorHandler[];
-    cors: CORSConfig[];
-    sanitizers: SanitizerConfig[];
-    pipes: Pipe[];
-    guards: (Guard | GuardFn)[];
-    interceptors: InterceptorCB[];
-    status?: number;
-};
-export type Route = {
-    name: string;
-    route: string;
-    method: HTTP_METHODS;
-    cors?: CORSConfig[];
-    ok: number;
-    parameters: ParamMetadata[];
-    interceptor?: InterceptorCB;
-    functions: FunctionsMeta[];
-    fn: (...args: any[]) => any;
-};
-export type NextFunction = (error?: unknown) => void;
-export type ControllerMeta = {
-    prefix: string;
-    name: string;
-    routes: Route[];
-    children?: ControllerMeta[];
-    functions: MiddlewaresMetadata[];
-    controllers: ControllerClass[];
-};
-export type ControllerMetadata = {
-    prefix: string;
-    name: string;
-    middlewares: MiddlewareCB[];
-    controllers: ControllerInstance[];
-};
-export type RouteMetadata = {
-    route: string;
-    method: HTTP_METHODS;
-    middlewares: MiddlewareCB[];
-    parameters: ParamMetadata[];
-};
-export type PipeKey = 'body' | 'query' | 'params' | 'headers';
-export type Pipe = {
-    body?: (body: unknown, request: Request) => unknown;
-    query?: (query: Record<string, string | string[]>, request: Request) => Record<string, string | string[]>;
-    params?: (params: Record<string, string>, request: Request) => Record<string, string>;
-    headers?: (headers: Record<string, string | string[]>, request: Request) => Record<string, string | string[]>;
-};
-export interface Guard {
-    new (...any: any[]): any;
-    canActivate(request: Request, response: Response): boolean;
-}
-export type GuardFn = (request: Request, response: Response) => boolean;
-export type MiddlewaresMetadata = {
-    middlewares: MiddlewareCB[];
-    errors: ErrorHandler[];
-    cors: CORSConfig[];
-    sanitizers: SanitizerConfig[];
-    pipes: Pipe[];
-    guards: (Guard | GuardFn)[];
-    interceptors: InterceptorCB[];
-    status?: number;
-};

package/dist/types/core/controller.js

@@ -1,4 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const constants_1 = require("../../constants");
-//# sourceMappingURL=controller.js.map

package/dist/types/core/controller.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../../src/types/core/controller.ts"],"names":[],"mappings":";;AAAA,+CAA+D"}

package/dist/types/core/cors.d.ts

@@ -1,10 +0,0 @@
-export interface CORSConfig {
-    origin?: string | string[] | ((origin: string) => boolean);
-    methods?: string[];
-    allowedHeaders?: string[];
-    exposedHeaders?: string[];
-    credentials?: boolean;
-    maxAge?: number;
-    preflightContinue?: boolean;
-    optionsSuccessStatus?: number;
-}

package/dist/types/core/cors.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=cors.js.map

package/dist/types/core/cors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cors.js","sourceRoot":"","sources":["../../../src/types/core/cors.ts"],"names":[],"mappings":""}

package/dist/types/core/error.d.ts

@@ -1,90 +0,0 @@
-import { Request } from './request';
-import { Response } from './response';
-export declare enum ErrorCode {
-    BAD_REQUEST = "BAD_REQUEST",
-    UNAUTHORIZED = "UNAUTHORIZED",
-    FORBIDDEN = "FORBIDDEN",
-    NOT_FOUND = "NOT_FOUND",
-    VALIDATION_FAILED = "VALIDATION_FAILED",
-    RATE_LIMIT_EXCEEDED = "RATE_LIMIT_EXCEEDED",
-    SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
-    DATABASE_ERROR = "DATABASE_ERROR",
-    DUPLICATE_ENTRY = "DUPLICATE_ENTRY",
-    INVALID_STATE = "INVALID_STATE",
-    DEPENDENCY_FAILED = "DEPENDENCY_FAILED",
-    INTERNAL_SERVER_ERROR = "INTERNAL_SERVER_ERROR"
-}
-export interface ErrorDetails {
-    field?: string;
-    value?: unknown;
-    constraint?: string;
-    [key: string]: unknown;
-}
-export interface HeliosError extends Error {
-    code: ErrorCode;
-    status: number;
-    details?: ErrorDetails[];
-    timestamp: Date;
-    requestId?: string;
-    path?: string;
-    method?: string;
-    toResponse(): ErrorResponse;
-}
-export interface IValidationError extends HeliosError {
-    code: ErrorCode.VALIDATION_FAILED;
-    details?: ErrorDetails[];
-}
-export interface ErrorResponse {
-    success: false;
-    error: {
-        code: ErrorCode;
-        status: number;
-        message: string;
-        details?: ErrorDetails[];
-        timestamp: string;
-        requestId?: string;
-        path?: string;
-    };
-}
-export interface ErrorHandlerConfig {
-    includeStack?: boolean;
-    logErrors?: boolean;
-    logStack?: boolean;
-    customHandlers?: Record<ErrorCode, (error: HeliosError) => unknown>;
-}
-export interface SerializedError {
-    type: 'Error' | 'HttpError' | 'AxiosError' | 'Unknown' | 'ValidationError';
-    message: string;
-    status?: number;
-    code?: string;
-    stack?: string;
-    data?: unknown;
-    original?: unknown;
-    errors?: unknown[];
-    details?: ErrorDetails[];
-}
-export interface ErrorHandlerConfig {
-    includeStack?: boolean;
-    logErrors?: boolean;
-    logStack?: boolean;
-    customHandlers?: Record<ErrorCode, (error: HeliosError) => unknown>;
-}
-export type ErrorHandler = (error: Error, req: Request, response: Response) => unknown;
-type ErrorChildren = {
-    property?: string;
-    value: unknown;
-    constraints?: unknown[];
-    children?: ErrorChildren[];
-};
-export type ErrorObject = Partial<{
-    name: string;
-    status: number;
-    statusCode: number;
-    code: string;
-    message: string;
-    stack: string;
-    errors: ErrorChildren[];
-    details: ErrorDetails[];
-    validationError?: unknown;
-}>;
-export {};

package/dist/types/core/error.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ErrorCode = void 0;
-var ErrorCode;
-(function (ErrorCode) {
-    ErrorCode["BAD_REQUEST"] = "BAD_REQUEST";
-    ErrorCode["UNAUTHORIZED"] = "UNAUTHORIZED";
-    ErrorCode["FORBIDDEN"] = "FORBIDDEN";
-    ErrorCode["NOT_FOUND"] = "NOT_FOUND";
-    ErrorCode["VALIDATION_FAILED"] = "VALIDATION_FAILED";
-    ErrorCode["RATE_LIMIT_EXCEEDED"] = "RATE_LIMIT_EXCEEDED";
-    ErrorCode["SERVICE_UNAVAILABLE"] = "SERVICE_UNAVAILABLE";
-    ErrorCode["DATABASE_ERROR"] = "DATABASE_ERROR";
-    ErrorCode["DUPLICATE_ENTRY"] = "DUPLICATE_ENTRY";
-    ErrorCode["INVALID_STATE"] = "INVALID_STATE";
-    ErrorCode["DEPENDENCY_FAILED"] = "DEPENDENCY_FAILED";
-    ErrorCode["INTERNAL_SERVER_ERROR"] = "INTERNAL_SERVER_ERROR";
-})(ErrorCode || (exports.ErrorCode = ErrorCode = {}));
-//# sourceMappingURL=error.js.map

package/dist/types/core/error.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../src/types/core/error.ts"],"names":[],"mappings":";;;AAGA,IAAY,SAaX;AAbD,WAAY,SAAS;IACnB,wCAA2B,CAAA;IAC3B,0CAA6B,CAAA;IAC7B,oCAAuB,CAAA;IACvB,oCAAuB,CAAA;IACvB,oDAAuC,CAAA;IACvC,wDAA2C,CAAA;IAC3C,wDAA2C,CAAA;IAC3C,8CAAiC,CAAA;IACjC,gDAAmC,CAAA;IACnC,4CAA+B,CAAA;IAC/B,oDAAuC,CAAA;IACvC,4DAA+C,CAAA;AACjD,CAAC,EAbW,SAAS,yBAAT,SAAS,QAapB"}

package/dist/types/core/index.d.ts

@@ -1,9 +0,0 @@
-export * from './common';
-export * from './controller';
-export * from './cors';
-export * from './error';
-export * from './multipart';
-export * from './request';
-export * from './response';
-export * from './sanitize';
-export * from './sse';

package/dist/types/core/index.js

@@ -1,26 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./common"), exports);
-__exportStar(require("./controller"), exports);
-__exportStar(require("./cors"), exports);
-__exportStar(require("./error"), exports);
-__exportStar(require("./multipart"), exports);
-__exportStar(require("./request"), exports);
-__exportStar(require("./response"), exports);
-__exportStar(require("./sanitize"), exports);
-__exportStar(require("./sse"), exports);
-//# sourceMappingURL=index.js.map

package/dist/types/core/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,+CAA6B;AAC7B,yCAAuB;AACvB,0CAAwB;AACxB,8CAA4B;AAC5B,4CAA0B;AAC1B,6CAA2B;AAC3B,6CAA2B;AAC3B,wCAAsB"}

package/dist/types/core/multipart.d.ts

@@ -1,8 +0,0 @@
-export interface MultipartFile {
-    fieldname: string;
-    filename: string;
-    contentType: string;
-    data: Buffer;
-    size: number;
-    encoding?: string;
-}

package/dist/types/core/multipart.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=multipart.js.map

package/dist/types/core/multipart.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"multipart.js","sourceRoot":"","sources":["../../../src/types/core/multipart.ts"],"names":[],"mappings":""}

package/dist/types/core/request.d.ts

@@ -1,65 +0,0 @@
-import { IncomingHttpHeaders } from 'http';
-export type RequestSource = 'http' | 'lambda' | 'unknown';
-export type EventType = 'apigateway' | 'apigatewayv2' | 'alb' | 'cloudfront' | 's3' | 'sns' | 'sqs' | 'dynamodb' | 'unknown';
-export interface RequestOptions {
-    method: string;
-    requestUrl: URL;
-    url: string;
-    path: string;
-    headers: Record<string, string | string[]>;
-    query: Record<string, string | string[]>;
-    body?: any;
-    params: Record<string, string>;
-    cookies: Record<string, string>;
-    sourceIp?: string;
-    userAgent?: string;
-    requestId: string;
-    stage?: string;
-    timestamp: Date;
-    raw?: unknown;
-    context?: unknown;
-    rawBody?: unknown;
-    event?: unknown;
-    isBase64Encoded?: boolean;
-    source: RequestSource;
-}
-export interface Request<B = unknown, Q = Record<string, string | string[]>, P = Record<string, string>> {
-    method: string;
-    path: string;
-    url: string;
-    requestUrl: URL;
-    headers: Record<string, string | string[]>;
-    query: Q;
-    body: B;
-    params: P;
-    cookies: Record<string, string>;
-    sourceIp: string;
-    userAgent: string;
-    requestId: string;
-    stage: string;
-    timestamp: Date;
-    source: RequestSource;
-    raw: any;
-    context: unknown;
-    rawBody: unknown;
-    isBase64Encoded: boolean;
-    startTime: number;
-    getHeader(name: string): string | string[] | undefined;
-    getCookie(name: string): string | undefined;
-    getQuery(name: string): string | string[] | undefined;
-    getParam(name: string): string | undefined;
-    isHttp(): boolean;
-    isLambda(): boolean;
-    getLambdaEvent(): unknown;
-    getLambdaContext(): unknown;
-    getHttpRequest(): IncomingHttpHeaders | undefined;
-    setState(key: string, value: unknown): void;
-    getState<T>(key: string): T | undefined;
-    getAllState(): Map<string, unknown>;
-    isSecure(): boolean;
-    getClientIp(): string;
-    getHost(): string;
-    getFullUrl(): string;
-    clone(overrides?: Partial<RequestOptions>): Request;
-    toJSON(): Record<string, this>;
-}

package/dist/types/core/request.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=request.js.map

package/dist/types/core/request.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../src/types/core/request.ts"],"names":[],"mappings":""}

package/dist/types/core/response.d.ts

@@ -1,64 +0,0 @@
-export type ResponseSource = 'http' | 'lambda' | 'unknown';
-export interface CookieOptions {
-    maxAge?: number;
-    expires?: Date;
-    path?: string;
-    domain?: string;
-    secure?: boolean;
-    httpOnly?: boolean;
-    sameSite?: 'strict' | 'lax' | 'none';
-    priority?: 'low' | 'medium' | 'high';
-    partitioned?: boolean;
-}
-export interface ResponseOptions {
-    statusCode?: number;
-    headers?: Record<string, string | string[]>;
-    body?: any;
-    cookies?: string[];
-    isBase64Encoded?: boolean;
-    encoding?: BufferEncoding;
-}
-export type _Raw = Partial<{
-    headersSent: boolean;
-    statusCode: number;
-    headers: {
-        [key: string]: string | string[];
-    };
-    cookies: string[];
-    end(args: unknown): unknown;
-    requestUrl: URL;
-    method: string;
-    requestId: string;
-    sourceIp: string;
-    userAgent: string;
-    startTime: number;
-}>;
-export interface Response {
-    headers: Record<string, string | string[]>;
-    data: any;
-    cookies: string[];
-    isBase64Encoded: boolean;
-    source: ResponseSource;
-    raw: _Raw;
-    headersSent: boolean;
-    ok: boolean;
-    meta: {
-        requestUrl: URL;
-        method: string;
-    };
-    status: number;
-    getStatus(): number;
-    setHeader(name: string, value: string | string[]): this;
-    getHeader(name: string): string | string[] | undefined;
-    hasHeader(name: string): boolean;
-    removeHeader(name: string): this;
-    setHeaders(headers: Record<string, string | string[]>): this;
-    setCookie(name: string, value: string, options?: CookieOptions): this;
-    clearCookie(name: string, options?: CookieOptions): this;
-    getCookies(): string[];
-    redirect(url: string, statusCode?: number): this;
-    end(data: unknown): unknown;
-    error(data: unknown): this;
-    reset(): this;
-    toJSON(): Record<string, unknown>;
-}

package/dist/types/core/response.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=response.js.map

package/dist/types/core/response.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"response.js","sourceRoot":"","sources":["../../../src/types/core/response.ts"],"names":[],"mappings":""}

package/dist/types/core/sanitize.d.ts

@@ -1,8 +0,0 @@
-import * as Joi from 'joi';
-export interface SanitizerConfig {
-    schema: Joi.Schema;
-    action?: 'validate' | 'sanitize' | 'both';
-    options?: Joi.ValidationOptions;
-    stripUnknown?: boolean;
-    type: 'headers' | 'body' | 'params' | 'query';
-}

package/dist/types/core/sanitize.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=sanitize.js.map

package/dist/types/core/sanitize.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../../src/types/core/sanitize.ts"],"names":[],"mappings":""}

package/dist/types/core/sse.d.ts

@@ -1,37 +0,0 @@
-import { ServerResponse } from 'http';
-export interface SSEClient {
-    id: string;
-    response: ServerResponse;
-    topics: Set<string>;
-    data: Record<string, unknown>;
-    connectedAt: Date;
-}
-export interface SSEMessage {
-    event?: string;
-    id?: string;
-    retry?: number;
-    data: unknown;
-}
-export interface SSEEvent {
-    type: 'connection' | 'close';
-    client: SSEClient;
-    data?: unknown;
-}
-export interface ISSEServer {
-    createConnection(res: ServerResponse): SSEClient;
-    sendToClient(clientId: string, message: SSEMessage): boolean;
-    broadcast(message: SSEMessage, excludeClientId?: string): void;
-    getStats(): {
-        clients: number;
-    };
-}
-export interface ISSEService {
-    initialize(sse: ISSEServer): void;
-    sendToClient(clientId: string, message: SSEMessage): boolean;
-    broadcast(message: SSEMessage, excludeClientId?: string): void;
-    getStats(): {
-        clients: number;
-    };
-    isAvailable(): boolean;
-    createConnection(res: ServerResponse): SSEClient;
-}

package/dist/types/core/sse.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=sse.js.map

package/dist/types/core/sse.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../../src/types/core/sse.ts"],"names":[],"mappings":""}

package/dist/types/ws/index.d.ts

@@ -1,50 +0,0 @@
-import WebSocket from 'ws';
-export type WebSocketHandlerType = 'connection' | 'message' | 'close' | 'error';
-export interface WebSocketEvent {
-    type: WebSocketHandlerType;
-    client: WebSocketClient;
-    message?: WebSocketMessage;
-    data?: unknown;
-}
-export interface WebSocketClient {
-    id: string;
-    socket: WebSocket;
-    topics: Set<string>;
-    data: Record<string, unknown>;
-    connectedAt: Date;
-}
-export interface WebSocketMessage {
-    type: string;
-    topic?: string;
-    data: any;
-    clientId?: string;
-}
-export interface WebSocketStats {
-    clients: number;
-    topics: Array<{
-        topic: string;
-        subscribers: number;
-    }>;
-}
-export interface IWebSocketService {
-    sendToClient(clientId: string, message: unknown): boolean;
-    publishToTopic(topic: string, data: any, exclude?: string[]): void;
-    broadcast(message: unknown, excludeClientId?: string): void;
-    getStats(): {
-        clients: number;
-        topics: Array<{
-            topic: string;
-            subscribers: number;
-        }>;
-    };
-    isAvailable(): boolean;
-}
-export interface IWebSocketServer {
-    sendToClient(clientId: string, message: unknown): boolean;
-    publishToTopic(topic: string, data: any, exclude: string[]): void;
-    broadcast(message: unknown, excludeClientId?: string): void;
-    getStats(): WebSocketStats;
-    subscribeToTopic(client: WebSocketClient, topic: string): void;
-    unsubscribeFromTopic(client: WebSocketClient, topic: string): void;
-    registerControllers(controllers: (new (...args: any[]) => any)[]): void;
-}

package/dist/types/ws/index.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=index.js.map

package/dist/types/ws/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/ws/index.ts"],"names":[],"mappings":""}

package/dist/utils/shared/helpers.d.ts

@@ -1,10 +0,0 @@
-import 'reflect-metadata';
-import { ControllerMeta, MiddlewaresMetadata, RouteMetadata } from '../../types/core/controller';
-export declare const generateUniqueId: () => string;
-export declare function reflectControllerMeta(target: object): ControllerMeta;
-export declare function defineControllerMeta(meta: Partial<ControllerMeta>, target: object): void;
-export declare function reflectMiddlewaresMetadata(target: any, propertie?: string): MiddlewaresMetadata;
-export declare function reflectRouteMetadata(target: object, popertie: string): RouteMetadata;
-export declare function defineMiddlewaresMeta(meta: Partial<MiddlewaresMetadata>, target: object): void;
-export declare function defineMiddlewaresMeta(meta: Partial<MiddlewaresMetadata>, target: object, propertie?: string): void;
-export declare function defineRouteMeta(meta: Partial<RouteMetadata>, target: object, propertie: string): void;