@heliosjs/aws 1.0.3

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

@@ -0,0 +1,65 @@
+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?: any;
+    context?: any;
+    rawBody?: any;
+    event?: unknown;
+    isBase64Encoded?: boolean;
+    source: RequestSource;
+}
+export interface IRequest {
+    method: string;
+    path: string;
+    url: string;
+    requestUrl: URL;
+    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;
+    source: RequestSource;
+    raw: any;
+    context: any;
+    rawBody: any;
+    isBase64Encoded: any;
+    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: any): void;
+    getState<T = any>(key: string): T | undefined;
+    getAllState(): Map<string, any>;
+    isSecure(): boolean;
+    getClientIp(): string;
+    getHost(): string;
+    getFullUrl(): string;
+    clone(overrides?: Partial<RequestOptions>): IRequest;
+    toJSON(): Record<string, any>;
+}

package/dist/types/core/request.js

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

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

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

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

@@ -0,0 +1,49 @@
+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 interface IResponse {
+    headers: Record<string, string | string[]>;
+    data: any;
+    cookies: string[];
+    isBase64Encoded: boolean;
+    source: ResponseSource;
+    raw: any;
+    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): this;
+    error(data: unknown): this;
+    reset(): this;
+    toJSON(): Record<string, any>;
+}

package/dist/types/core/response.js

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

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

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

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

@@ -0,0 +1,8 @@
+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

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

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

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

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

@@ -0,0 +1,37 @@
+import { ServerResponse } from 'http';
+export interface SSEClient {
+    id: string;
+    response: ServerResponse;
+    topics: Set<string>;
+    data: Record<string, any>;
+    connectedAt: Date;
+}
+export interface SSEMessage {
+    event?: string;
+    id?: string;
+    retry?: number;
+    data: any;
+}
+export interface SSEEvent {
+    type: 'connection' | 'close';
+    client: SSEClient;
+    data?: any;
+}
+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

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

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

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

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

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

package/dist/types/ws/index.js

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

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

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

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

@@ -0,0 +1,4 @@
+import { NormalizedEvent } from '../../types/aws';
+export declare const getEventType: (event: any) => "rest" | "http" | "url";
+export declare const getSourceIp: (event: NormalizedEvent) => string;
+export declare const normalizeEvent: (event: any, type: string) => NormalizedEvent;

package/dist/utils/aws/helpers.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeEvent = exports.getSourceIp = exports.getEventType = void 0;
+const getEventType = (event) => {
+    if (event.httpMethod && event.resource) {
+        return 'rest';
+    }
+    if (event.version === '2.0' || event.requestContext?.http) {
+        return 'http';
+    }
+    if (event.version && event.rawPath && !event.requestContext?.http) {
+        return 'url';
+    }
+    return 'rest';
+};
+exports.getEventType = getEventType;
+const getSourceIp = (event) => {
+    const forwardedFor = event.headers['x-forwarded-for'];
+    if (forwardedFor) {
+        if (Array.isArray(forwardedFor)) {
+            return forwardedFor[0].split(',')[0].trim();
+        }
+        return forwardedFor.split(',')[0].trim();
+    }
+    if (event.requestContext?.identity?.sourceIp) {
+        return event.requestContext.identity.sourceIp;
+    }
+    if (event.requestContext?.http?.sourceIp) {
+        return event.requestContext.http.sourceIp;
+    }
+    return '0.0.0.0';
+};
+exports.getSourceIp = getSourceIp;
+const parseQueryString = (queryString) => {
+    const params = {};
+    if (!queryString)
+        return params;
+    new URLSearchParams(queryString).forEach((value, key) => {
+        params[key] = value;
+    });
+    return params;
+};
+const normalizeEvent = (event, type) => {
+    const base = {
+        headers: event.headers || {},
+        body: event.body || null,
+        isBase64Encoded: event.isBase64Encoded || false,
+        requestContext: event.requestContext,
+    };
+    switch (type) {
+        case 'rest':
+            return {
+                ...base,
+                httpMethod: event.httpMethod,
+                path: event.path,
+                queryStringParameters: event.queryStringParameters || {},
+                multiValueQueryStringParameters: event.multiValueQueryStringParameters,
+                pathParameters: event.pathParameters || {},
+                cookies: event.headers?.Cookie ? [event.headers.Cookie] : [],
+            };
+        case 'http':
+            return {
+                ...base,
+                httpMethod: event.requestContext?.http?.method || 'GET',
+                path: event.rawPath,
+                queryStringParameters: event.queryStringParameters || {},
+                pathParameters: event.pathParameters || {},
+                cookies: event.cookies || [],
+            };
+        case 'url':
+            return {
+                ...base,
+                httpMethod: event.requestContext?.http?.method || 'GET',
+                path: event.rawPath,
+                queryStringParameters: parseQueryString(event.rawQueryString),
+                pathParameters: {},
+                cookies: [],
+            };
+        default:
+            throw new Error(`Unsupported event type: ${type}`);
+    }
+};
+exports.normalizeEvent = normalizeEvent;
+//# sourceMappingURL=helpers.js.map

package/dist/utils/aws/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/utils/aws/helpers.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,6 @@
+export * from './lambda';
+export * from './lambda.event.normalizers';
+export * from './parsers';
+export * from './plugin';
+export * from './request.factory';
+export * from './response.factory';

package/dist/utils/aws/index.js

@@ -0,0 +1,23 @@
+"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("./lambda"), exports);
+__exportStar(require("./lambda.event.normalizers"), exports);
+__exportStar(require("./parsers"), exports);
+__exportStar(require("./plugin"), exports);
+__exportStar(require("./request.factory"), exports);
+__exportStar(require("./response.factory"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/aws/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/aws/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,6DAA2C;AAC3C,4CAA0B;AAC1B,2CAAyB;AACzB,oDAAkC;AAClC,qDAAmC"}

package/dist/utils/aws/lambda.d.ts

@@ -0,0 +1,6 @@
+import { ALBEvent, APIGatewayProxyEvent, APIGatewayProxyEventV2 } from 'aws-lambda';
+import { NormalizedEvent } from '../../types/aws';
+export declare const getEventType: (event: any) => "rest" | "http" | "url";
+export declare const getSourceIp: (event: NormalizedEvent) => string;
+export declare const getQueryStringParameters: (event: APIGatewayProxyEvent | APIGatewayProxyEventV2 | ALBEvent) => Record<string, string>;
+export declare const getMultiValueQueryStringParameters: (event: APIGatewayProxyEvent | ALBEvent) => Record<string, string[]>;

package/dist/utils/aws/lambda.event.normalizers.d.ts

@@ -0,0 +1,42 @@
+import { LambdaEvent } from '../../types/aws';
+import { RequestOptions } from '../../types/core';
+import { ALBEvent, APIGatewayProxyEvent, APIGatewayProxyEventV2, CloudFrontRequestEvent, Context, LambdaFunctionURLEvent } from 'aws-lambda';
+export declare const normalizeAPIGatewayEvent: (event: APIGatewayProxyEvent, context: Context) => RequestOptions;
+export declare const normalizeAPIGatewayV2Event: (event: APIGatewayProxyEventV2, context: Context) => RequestOptions;
+export declare const normalizeALBEvent: (event: ALBEvent, context: Context) => RequestOptions;
+export declare const normalizeCloudFrontEvent: (event: CloudFrontRequestEvent, context: Context) => RequestOptions;
+export interface LambdaFunctionUrlEvent {
+    version: string;
+    rawPath: string;
+    rawQueryString: string;
+    headers: Record<string, string>;
+    queryStringParameters?: Record<string, string>;
+    requestContext: {
+        accountId: string;
+        apiId: string;
+        domainName: string;
+        domainPrefix: string;
+        http: {
+            method: string;
+            path: string;
+            protocol: string;
+            sourceIp: string;
+            userAgent: string;
+        };
+        requestId: string;
+        routeKey: string;
+        stage: string;
+        time: string;
+        timeEpoch: number;
+    };
+    body?: string;
+    isBase64Encoded?: boolean;
+    cookies?: string[];
+}
+/**
+ * Нормализует Lambda Function URL event
+ */
+export declare const normalizeLambdaFunctionUrlEvent: (event: LambdaFunctionURLEvent, context: Context) => RequestOptions;
+export type LambdaEventType = 'apigateway' | 'apigatewayv2' | 'alb' | 'cloudfront' | 'lambda-url' | 'unknown';
+export declare const getLambdaEventType: (event: any) => LambdaEventType;
+export declare const normalizeEvent: (event: LambdaEvent, context: Context) => RequestOptions;