@adaas/a-server 0.0.22 → 0.0.23

package/dist/node/lib/A-Request/A-Request.helper.js

@@ -0,0 +1,181 @@
+'use strict';
+
+var ARequest_error = require('./A-Request.error');
+
+class A_RequestHelper {
+  /**
+   * Extract URL parameters from a URL using a route pattern
+   * @param url - The actual URL to extract parameters from
+   * @param routePattern - The route pattern with parameters (e.g., "/users/:id/posts/:postId")
+   * @returns Object containing extracted parameters
+   */
+  static extractParams(url, routePattern) {
+    const cleanUrl = url.split("?")[0];
+    const cleanPattern = routePattern.split("?")[0];
+    const urlSegments = cleanUrl.split("/").filter(Boolean);
+    const patternSegments = cleanPattern.split("/").filter(Boolean);
+    const params = {};
+    for (let i = 0; i < patternSegments.length; i++) {
+      const patternSegment = patternSegments[i];
+      const urlSegment = urlSegments[i];
+      if (patternSegment.startsWith(":")) {
+        const paramName = patternSegment.slice(1);
+        if (urlSegment) {
+          params[paramName] = decodeURIComponent(urlSegment);
+        }
+      } else if (patternSegment !== urlSegment) {
+        return {};
+      }
+    }
+    return params;
+  }
+  /**
+   * Extract query parameters from URL
+   * @param url - The URL to extract query parameters from
+   * @returns Object containing query parameters
+   */
+  static extractQuery(url) {
+    const query = {};
+    const queryString = url.split("?")[1];
+    if (!queryString) return query;
+    const cleanQuery = queryString.split("#")[0];
+    for (const pair of cleanQuery.split("&")) {
+      if (!pair) continue;
+      const [key, value = ""] = pair.split("=");
+      query[decodeURIComponent(key)] = decodeURIComponent(value);
+    }
+    return query;
+  }
+  /**
+   * Parse cookies from Cookie header
+   */
+  static parseCookies(cookieHeader) {
+    const cookies = {};
+    if (!cookieHeader) return {};
+    cookieHeader.split(";").forEach((cookie) => {
+      const [name, ...rest] = cookie.trim().split("=");
+      const value = rest.join("=");
+      if (name && value) {
+        cookies[name] = decodeURIComponent(value);
+      }
+    });
+    return cookies;
+  }
+  /**
+   * Parse request body based on Content-Type
+   * 
+   * 
+   * @param context - The HTTP server request context
+   * @returns Parsed body data and detected body type
+   */
+  static parseRequestBody(context) {
+    let parsedBody;
+    let bodyType;
+    switch (true) {
+      case (!!context.contentType && context.contentType.includes("application/json")):
+        parsedBody = JSON.parse(context.data);
+        bodyType = "json";
+        break;
+      case (!!context.contentType && context.contentType.includes("application/x-www-form-urlencoded")):
+        parsedBody = A_RequestHelper.parseFormUrlEncoded(context.data);
+        bodyType = "form";
+        break;
+      case (!!context.contentType && context.contentType.includes("multipart/form-data")):
+        const multipartResult = A_RequestHelper.parseMultipartData(Buffer.concat(context.buffers), context.contentType);
+        parsedBody = {
+          ...multipartResult.fields,
+          _files: multipartResult.files
+        };
+        bodyType = "multipart";
+        break;
+      case (!!context.contentType && context.contentType.includes("text/")):
+        parsedBody = context.data;
+        bodyType = "text";
+        break;
+      default:
+        parsedBody = Buffer.concat(context.buffers);
+        bodyType = "raw";
+        break;
+    }
+    return {
+      data: parsedBody,
+      type: bodyType
+    };
+  }
+  /**
+   * Parse URL-encoded form data (application/x-www-form-urlencoded)
+   * @param body - The URL-encoded body string
+   * @returns Object containing form data
+   */
+  static parseFormUrlEncoded(body) {
+    const result = {};
+    if (!body) return result;
+    const pairs = body.split("&");
+    for (const pair of pairs) {
+      if (!pair) continue;
+      const [key, value = ""] = pair.split("=");
+      const decodedKey = decodeURIComponent(key.replace(/\+/g, " "));
+      const decodedValue = decodeURIComponent(value.replace(/\+/g, " "));
+      if (decodedKey in result) {
+        const existing = result[decodedKey];
+        if (Array.isArray(existing)) {
+          existing.push(decodedValue);
+        } else {
+          result[decodedKey] = [existing, decodedValue];
+        }
+      } else {
+        result[decodedKey] = decodedValue;
+      }
+    }
+    return result;
+  }
+  /**
+   * Parse multipart form data (for file uploads and form data)
+   * @param buffer - The raw buffer containing multipart data
+   * @param contentType - The content type header
+   * @returns Object containing fields and files
+   */
+  static parseMultipartData(buffer, contentType) {
+    const boundaryMatch = contentType.match(/boundary=(.+)/);
+    if (!boundaryMatch) {
+      throw new ARequest_error.A_RequestError(
+        ARequest_error.A_RequestError.RequestBodyParsingError,
+        "Missing boundary in multipart/form-data content type"
+      );
+    }
+    const boundary = "--" + boundaryMatch[1];
+    const textData = buffer.toString();
+    const parts = textData.split(boundary).filter((part) => part.trim() && !part.includes("--"));
+    const fields = {};
+    const files = [];
+    parts.forEach((part) => {
+      const [headers, content] = part.split("\r\n\r\n");
+      if (!headers || content === void 0) return;
+      const nameMatch = headers.match(/name="([^"]+)"/);
+      const filenameMatch = headers.match(/filename="([^"]+)"/);
+      const contentTypeMatch = headers.match(/Content-Type: ([^\r\n]+)/);
+      if (nameMatch) {
+        const fieldName = nameMatch[1];
+        const cleanContent = content.replace(/\r\n$/, "");
+        if (filenameMatch) {
+          const file = {
+            fieldName,
+            filename: filenameMatch[1],
+            encoding: "binary",
+            mimetype: contentTypeMatch?.[1] || "application/octet-stream",
+            size: Buffer.byteLength(cleanContent),
+            buffer: Buffer.from(cleanContent, "binary")
+          };
+          files.push(file);
+        } else {
+          fields[fieldName] = cleanContent;
+        }
+      }
+    });
+    return { fields, files };
+  }
+}
+
+exports.A_RequestHelper = A_RequestHelper;
+//# sourceMappingURL=A-Request.helper.js.map
+//# sourceMappingURL=A-Request.helper.js.map

package/dist/node/lib/A-Request/A-Request.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/A-Request/A-Request.helper.ts"],"names":["A_RequestError"],"mappings":"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","file":"A-Request.helper.js","sourcesContent":["import { A_HttpServerRequestContext } from \"./A-HttpServerRequest.context\";\nimport { A_RequestError } from \"./A-Request.error\";\nimport { A_Request_BodyType, A_Request_FileUpload } from \"./A-Request.types\";\n\n/**\n * A_RequestHelper - Stateless utility class for HTTP request processing\n * \n * This helper class provides static methods for parsing and processing HTTP request data:\n * - URL parameter extraction from route patterns\n * - Query string parsing\n * - Request body parsing (JSON, form-data, multipart, raw)\n * - URL-encoded form data parsing\n * - Multipart form data parsing (including file uploads)\n * \n * All methods are stateless and only depend on input parameters.\n * \n * @example\n * ```typescript\n * // Extract URL parameters\n * const params = A_RequestHelper.extractParams('/users/123', '/users/:id');\n * // { id: '123' }\n * \n * // Parse query string\n * const query = A_RequestHelper.extractQuery('/api/users?page=1&limit=10');\n * // { page: '1', limit: '10' }\n * \n * // Parse request body\n * const result = await A_RequestHelper.parseRequestBody(req, { maxBodySize: 1024 * 1024 });\n * // { data: {...}, type: 'json' }\n * ```\n */\nexport class A_RequestHelper {\n\n    /**\n     * Extract URL parameters from a URL using a route pattern\n     * @param url - The actual URL to extract parameters from\n     * @param routePattern - The route pattern with parameters (e.g., \"/users/:id/posts/:postId\")\n     * @returns Object containing extracted parameters\n     */\n    static extractParams(url: string, routePattern: string): Record<string, string> {\n        // Remove query string (anything after ?)\n        const cleanUrl = url.split('?')[0];\n        const cleanPattern = routePattern.split('?')[0];\n\n        const urlSegments = cleanUrl.split('/').filter(Boolean);\n        const patternSegments = cleanPattern.split('/').filter(Boolean);\n\n        const params: Record<string, string> = {};\n\n        for (let i = 0; i < patternSegments.length; i++) {\n            const patternSegment = patternSegments[i];\n            const urlSegment = urlSegments[i];\n\n            if (patternSegment.startsWith(':')) {\n                const paramName = patternSegment.slice(1); // Remove ':' from pattern\n                if (urlSegment) {\n                    params[paramName] = decodeURIComponent(urlSegment);\n                }\n            } else if (patternSegment !== urlSegment) {\n                // If static segments don't match → fail\n                return {};\n            }\n        }\n\n        return params;\n    }\n\n\n\n    /**\n     * Extract query parameters from URL\n     * @param url - The URL to extract query parameters from\n     * @returns Object containing query parameters\n     */\n    static extractQuery<T = Record<string, string>>(url: string): T {\n        const query: Record<string, string> = {};\n\n        // Take only the part after \"?\"\n        const queryString = url.split('?')[1];\n        if (!queryString) return query as T;\n\n        // Remove fragment (#...) if present\n        const cleanQuery = queryString.split('#')[0];\n\n        // Split into key=value pairs\n        for (const pair of cleanQuery.split('&')) {\n            if (!pair) continue;\n            const [key, value = ''] = pair.split('=');\n            query[decodeURIComponent(key)] = decodeURIComponent(value);\n        }\n\n        return query as T;\n    }\n\n\n    /**\n     * Parse cookies from Cookie header\n     */\n    static parseCookies(\n        cookieHeader?: string\n    ): Record<string, string> {\n        const cookies: Record<string, string> = {};\n\n        if (!cookieHeader) return {};\n\n        cookieHeader.split(';').forEach(cookie => {\n            const [name, ...rest] = cookie.trim().split('=');\n            const value = rest.join('=');\n            if (name && value) {\n                cookies[name] = decodeURIComponent(value);\n            }\n        });\n\n        return cookies;\n    }\n\n    /**\n     * Parse request body based on Content-Type\n     * \n     * \n     * @param context - The HTTP server request context\n     * @returns Parsed body data and detected body type\n     */\n    static parseRequestBody<T extends any = any>(\n        context: A_HttpServerRequestContext\n    ): {\n        data: T;\n        type: A_Request_BodyType;\n    } {\n        let parsedBody: any;\n        let bodyType: A_Request_BodyType;\n\n        switch (true) {\n            case !!context.contentType && context.contentType.includes('application/json'):\n                parsedBody = JSON.parse(context.data);\n                bodyType = 'json';\n                break;\n            case !!context.contentType && context.contentType.includes('application/x-www-form-urlencoded'):\n                parsedBody = A_RequestHelper.parseFormUrlEncoded(context.data) as T;\n                bodyType = 'form';\n                break;\n            case !!context.contentType && context.contentType.includes('multipart/form-data'):\n                const multipartResult = A_RequestHelper.parseMultipartData(Buffer.concat(context.buffers), context.contentType);\n                // Return the entire multipart result (fields + files) as T\n                parsedBody = {\n                    ...multipartResult.fields,\n                    _files: multipartResult.files\n                } as T;\n                bodyType = 'multipart';\n                break;\n            case !!context.contentType && context.contentType.includes('text/'):\n                parsedBody = context.data as T;\n                bodyType = 'text';\n                break;\n            default:\n                parsedBody = Buffer.concat(context.buffers) as T;\n                bodyType = 'raw';\n                break;\n        }\n\n\n        return {\n            data: parsedBody,\n            type: bodyType\n        };\n    }\n\n    /**\n     * Parse URL-encoded form data (application/x-www-form-urlencoded)\n     * @param body - The URL-encoded body string\n     * @returns Object containing form data\n     */\n    static parseFormUrlEncoded(\n        /**\n         * The URL-encoded body string\n         */\n        body: string\n    ): Record<string, string | string[]> {\n        const result: Record<string, string | string[]> = {};\n\n        if (!body) return result;\n\n        const pairs = body.split('&');\n\n        for (const pair of pairs) {\n            if (!pair) continue;\n\n            const [key, value = ''] = pair.split('=');\n            const decodedKey = decodeURIComponent(key.replace(/\\+/g, ' '));\n            const decodedValue = decodeURIComponent(value.replace(/\\+/g, ' '));\n\n            // Handle multiple values for the same key (arrays)\n            if (decodedKey in result) {\n                const existing = result[decodedKey];\n                if (Array.isArray(existing)) {\n                    existing.push(decodedValue);\n                } else {\n                    result[decodedKey] = [existing, decodedValue];\n                }\n            } else {\n                result[decodedKey] = decodedValue;\n            }\n        }\n\n        return result;\n    }\n\n    /**\n     * Parse multipart form data (for file uploads and form data)\n     * @param buffer - The raw buffer containing multipart data\n     * @param contentType - The content type header\n     * @returns Object containing fields and files\n     */\n    static parseMultipartData(\n        /**\n         * The raw buffer containing multipart data\n         */\n        buffer: Buffer,\n        /**\n         * The content type header\n         */\n        contentType: string\n    ): {\n        fields: Record<string, string>;\n        files: A_Request_FileUpload[];\n    } {\n        // Extract boundary\n        const boundaryMatch = contentType.match(/boundary=(.+)/);\n        if (!boundaryMatch) {\n            throw new A_RequestError(\n                A_RequestError.RequestBodyParsingError,\n                'Missing boundary in multipart/form-data content type'\n            )\n        }\n\n        const boundary = '--' + boundaryMatch[1];\n        const textData = buffer.toString();\n        const parts = textData.split(boundary).filter(part => part.trim() && !part.includes('--'));\n\n        const fields: Record<string, string> = {};\n        const files: A_Request_FileUpload[] = [];\n\n        parts.forEach(part => {\n            const [headers, content] = part.split('\\r\\n\\r\\n');\n            if (!headers || content === undefined) return;\n\n            const nameMatch = headers.match(/name=\"([^\"]+)\"/);\n            const filenameMatch = headers.match(/filename=\"([^\"]+)\"/);\n            const contentTypeMatch = headers.match(/Content-Type: ([^\\r\\n]+)/);\n\n            if (nameMatch) {\n                const fieldName = nameMatch[1];\n                const cleanContent = content.replace(/\\r\\n$/, '');\n\n                if (filenameMatch) {\n                    // It's a file upload\n                    const file: A_Request_FileUpload = {\n                        fieldName,\n                        filename: filenameMatch[1],\n                        encoding: 'binary',\n                        mimetype: contentTypeMatch?.[1] || 'application/octet-stream',\n                        size: Buffer.byteLength(cleanContent),\n                        buffer: Buffer.from(cleanContent, 'binary')\n                    };\n                    files.push(file);\n                } else {\n                    // It's a regular field\n                    fields[fieldName] = cleanContent;\n                }\n            }\n        });\n\n        return { fields, files };\n    }\n\n}"]}

package/dist/node/lib/A-Request/A-Request.helper.mjs

@@ -0,0 +1,180 @@
+import '../../chunk-EQQGB2QZ.mjs';
+import { A_RequestError } from './A-Request.error';
+
+class A_RequestHelper {
+  /**
+   * Extract URL parameters from a URL using a route pattern
+   * @param url - The actual URL to extract parameters from
+   * @param routePattern - The route pattern with parameters (e.g., "/users/:id/posts/:postId")
+   * @returns Object containing extracted parameters
+   */
+  static extractParams(url, routePattern) {
+    const cleanUrl = url.split("?")[0];
+    const cleanPattern = routePattern.split("?")[0];
+    const urlSegments = cleanUrl.split("/").filter(Boolean);
+    const patternSegments = cleanPattern.split("/").filter(Boolean);
+    const params = {};
+    for (let i = 0; i < patternSegments.length; i++) {
+      const patternSegment = patternSegments[i];
+      const urlSegment = urlSegments[i];
+      if (patternSegment.startsWith(":")) {
+        const paramName = patternSegment.slice(1);
+        if (urlSegment) {
+          params[paramName] = decodeURIComponent(urlSegment);
+        }
+      } else if (patternSegment !== urlSegment) {
+        return {};
+      }
+    }
+    return params;
+  }
+  /**
+   * Extract query parameters from URL
+   * @param url - The URL to extract query parameters from
+   * @returns Object containing query parameters
+   */
+  static extractQuery(url) {
+    const query = {};
+    const queryString = url.split("?")[1];
+    if (!queryString) return query;
+    const cleanQuery = queryString.split("#")[0];
+    for (const pair of cleanQuery.split("&")) {
+      if (!pair) continue;
+      const [key, value = ""] = pair.split("=");
+      query[decodeURIComponent(key)] = decodeURIComponent(value);
+    }
+    return query;
+  }
+  /**
+   * Parse cookies from Cookie header
+   */
+  static parseCookies(cookieHeader) {
+    const cookies = {};
+    if (!cookieHeader) return {};
+    cookieHeader.split(";").forEach((cookie) => {
+      const [name, ...rest] = cookie.trim().split("=");
+      const value = rest.join("=");
+      if (name && value) {
+        cookies[name] = decodeURIComponent(value);
+      }
+    });
+    return cookies;
+  }
+  /**
+   * Parse request body based on Content-Type
+   * 
+   * 
+   * @param context - The HTTP server request context
+   * @returns Parsed body data and detected body type
+   */
+  static parseRequestBody(context) {
+    let parsedBody;
+    let bodyType;
+    switch (true) {
+      case (!!context.contentType && context.contentType.includes("application/json")):
+        parsedBody = JSON.parse(context.data);
+        bodyType = "json";
+        break;
+      case (!!context.contentType && context.contentType.includes("application/x-www-form-urlencoded")):
+        parsedBody = A_RequestHelper.parseFormUrlEncoded(context.data);
+        bodyType = "form";
+        break;
+      case (!!context.contentType && context.contentType.includes("multipart/form-data")):
+        const multipartResult = A_RequestHelper.parseMultipartData(Buffer.concat(context.buffers), context.contentType);
+        parsedBody = {
+          ...multipartResult.fields,
+          _files: multipartResult.files
+        };
+        bodyType = "multipart";
+        break;
+      case (!!context.contentType && context.contentType.includes("text/")):
+        parsedBody = context.data;
+        bodyType = "text";
+        break;
+      default:
+        parsedBody = Buffer.concat(context.buffers);
+        bodyType = "raw";
+        break;
+    }
+    return {
+      data: parsedBody,
+      type: bodyType
+    };
+  }
+  /**
+   * Parse URL-encoded form data (application/x-www-form-urlencoded)
+   * @param body - The URL-encoded body string
+   * @returns Object containing form data
+   */
+  static parseFormUrlEncoded(body) {
+    const result = {};
+    if (!body) return result;
+    const pairs = body.split("&");
+    for (const pair of pairs) {
+      if (!pair) continue;
+      const [key, value = ""] = pair.split("=");
+      const decodedKey = decodeURIComponent(key.replace(/\+/g, " "));
+      const decodedValue = decodeURIComponent(value.replace(/\+/g, " "));
+      if (decodedKey in result) {
+        const existing = result[decodedKey];
+        if (Array.isArray(existing)) {
+          existing.push(decodedValue);
+        } else {
+          result[decodedKey] = [existing, decodedValue];
+        }
+      } else {
+        result[decodedKey] = decodedValue;
+      }
+    }
+    return result;
+  }
+  /**
+   * Parse multipart form data (for file uploads and form data)
+   * @param buffer - The raw buffer containing multipart data
+   * @param contentType - The content type header
+   * @returns Object containing fields and files
+   */
+  static parseMultipartData(buffer, contentType) {
+    const boundaryMatch = contentType.match(/boundary=(.+)/);
+    if (!boundaryMatch) {
+      throw new A_RequestError(
+        A_RequestError.RequestBodyParsingError,
+        "Missing boundary in multipart/form-data content type"
+      );
+    }
+    const boundary = "--" + boundaryMatch[1];
+    const textData = buffer.toString();
+    const parts = textData.split(boundary).filter((part) => part.trim() && !part.includes("--"));
+    const fields = {};
+    const files = [];
+    parts.forEach((part) => {
+      const [headers, content] = part.split("\r\n\r\n");
+      if (!headers || content === void 0) return;
+      const nameMatch = headers.match(/name="([^"]+)"/);
+      const filenameMatch = headers.match(/filename="([^"]+)"/);
+      const contentTypeMatch = headers.match(/Content-Type: ([^\r\n]+)/);
+      if (nameMatch) {
+        const fieldName = nameMatch[1];
+        const cleanContent = content.replace(/\r\n$/, "");
+        if (filenameMatch) {
+          const file = {
+            fieldName,
+            filename: filenameMatch[1],
+            encoding: "binary",
+            mimetype: contentTypeMatch?.[1] || "application/octet-stream",
+            size: Buffer.byteLength(cleanContent),
+            buffer: Buffer.from(cleanContent, "binary")
+          };
+          files.push(file);
+        } else {
+          fields[fieldName] = cleanContent;
+        }
+      }
+    });
+    return { fields, files };
+  }
+}
+
+export { A_RequestHelper };
+//# sourceMappingURL=A-Request.helper.mjs.map
+//# sourceMappingURL=A-Request.helper.mjs.map

package/dist/node/lib/A-Request/A-Request.helper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/A-Request/A-Request.helper.ts"],"names":[],"mappings":"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","file":"A-Request.helper.mjs","sourcesContent":["import { A_HttpServerRequestContext } from \"./A-HttpServerRequest.context\";\nimport { A_RequestError } from \"./A-Request.error\";\nimport { A_Request_BodyType, A_Request_FileUpload } from \"./A-Request.types\";\n\n/**\n * A_RequestHelper - Stateless utility class for HTTP request processing\n * \n * This helper class provides static methods for parsing and processing HTTP request data:\n * - URL parameter extraction from route patterns\n * - Query string parsing\n * - Request body parsing (JSON, form-data, multipart, raw)\n * - URL-encoded form data parsing\n * - Multipart form data parsing (including file uploads)\n * \n * All methods are stateless and only depend on input parameters.\n * \n * @example\n * ```typescript\n * // Extract URL parameters\n * const params = A_RequestHelper.extractParams('/users/123', '/users/:id');\n * // { id: '123' }\n * \n * // Parse query string\n * const query = A_RequestHelper.extractQuery('/api/users?page=1&limit=10');\n * // { page: '1', limit: '10' }\n * \n * // Parse request body\n * const result = await A_RequestHelper.parseRequestBody(req, { maxBodySize: 1024 * 1024 });\n * // { data: {...}, type: 'json' }\n * ```\n */\nexport class A_RequestHelper {\n\n    /**\n     * Extract URL parameters from a URL using a route pattern\n     * @param url - The actual URL to extract parameters from\n     * @param routePattern - The route pattern with parameters (e.g., \"/users/:id/posts/:postId\")\n     * @returns Object containing extracted parameters\n     */\n    static extractParams(url: string, routePattern: string): Record<string, string> {\n        // Remove query string (anything after ?)\n        const cleanUrl = url.split('?')[0];\n        const cleanPattern = routePattern.split('?')[0];\n\n        const urlSegments = cleanUrl.split('/').filter(Boolean);\n        const patternSegments = cleanPattern.split('/').filter(Boolean);\n\n        const params: Record<string, string> = {};\n\n        for (let i = 0; i < patternSegments.length; i++) {\n            const patternSegment = patternSegments[i];\n            const urlSegment = urlSegments[i];\n\n            if (patternSegment.startsWith(':')) {\n                const paramName = patternSegment.slice(1); // Remove ':' from pattern\n                if (urlSegment) {\n                    params[paramName] = decodeURIComponent(urlSegment);\n                }\n            } else if (patternSegment !== urlSegment) {\n                // If static segments don't match → fail\n                return {};\n            }\n        }\n\n        return params;\n    }\n\n\n\n    /**\n     * Extract query parameters from URL\n     * @param url - The URL to extract query parameters from\n     * @returns Object containing query parameters\n     */\n    static extractQuery<T = Record<string, string>>(url: string): T {\n        const query: Record<string, string> = {};\n\n        // Take only the part after \"?\"\n        const queryString = url.split('?')[1];\n        if (!queryString) return query as T;\n\n        // Remove fragment (#...) if present\n        const cleanQuery = queryString.split('#')[0];\n\n        // Split into key=value pairs\n        for (const pair of cleanQuery.split('&')) {\n            if (!pair) continue;\n            const [key, value = ''] = pair.split('=');\n            query[decodeURIComponent(key)] = decodeURIComponent(value);\n        }\n\n        return query as T;\n    }\n\n\n    /**\n     * Parse cookies from Cookie header\n     */\n    static parseCookies(\n        cookieHeader?: string\n    ): Record<string, string> {\n        const cookies: Record<string, string> = {};\n\n        if (!cookieHeader) return {};\n\n        cookieHeader.split(';').forEach(cookie => {\n            const [name, ...rest] = cookie.trim().split('=');\n            const value = rest.join('=');\n            if (name && value) {\n                cookies[name] = decodeURIComponent(value);\n            }\n        });\n\n        return cookies;\n    }\n\n    /**\n     * Parse request body based on Content-Type\n     * \n     * \n     * @param context - The HTTP server request context\n     * @returns Parsed body data and detected body type\n     */\n    static parseRequestBody<T extends any = any>(\n        context: A_HttpServerRequestContext\n    ): {\n        data: T;\n        type: A_Request_BodyType;\n    } {\n        let parsedBody: any;\n        let bodyType: A_Request_BodyType;\n\n        switch (true) {\n            case !!context.contentType && context.contentType.includes('application/json'):\n                parsedBody = JSON.parse(context.data);\n                bodyType = 'json';\n                break;\n            case !!context.contentType && context.contentType.includes('application/x-www-form-urlencoded'):\n                parsedBody = A_RequestHelper.parseFormUrlEncoded(context.data) as T;\n                bodyType = 'form';\n                break;\n            case !!context.contentType && context.contentType.includes('multipart/form-data'):\n                const multipartResult = A_RequestHelper.parseMultipartData(Buffer.concat(context.buffers), context.contentType);\n                // Return the entire multipart result (fields + files) as T\n                parsedBody = {\n                    ...multipartResult.fields,\n                    _files: multipartResult.files\n                } as T;\n                bodyType = 'multipart';\n                break;\n            case !!context.contentType && context.contentType.includes('text/'):\n                parsedBody = context.data as T;\n                bodyType = 'text';\n                break;\n            default:\n                parsedBody = Buffer.concat(context.buffers) as T;\n                bodyType = 'raw';\n                break;\n        }\n\n\n        return {\n            data: parsedBody,\n            type: bodyType\n        };\n    }\n\n    /**\n     * Parse URL-encoded form data (application/x-www-form-urlencoded)\n     * @param body - The URL-encoded body string\n     * @returns Object containing form data\n     */\n    static parseFormUrlEncoded(\n        /**\n         * The URL-encoded body string\n         */\n        body: string\n    ): Record<string, string | string[]> {\n        const result: Record<string, string | string[]> = {};\n\n        if (!body) return result;\n\n        const pairs = body.split('&');\n\n        for (const pair of pairs) {\n            if (!pair) continue;\n\n            const [key, value = ''] = pair.split('=');\n            const decodedKey = decodeURIComponent(key.replace(/\\+/g, ' '));\n            const decodedValue = decodeURIComponent(value.replace(/\\+/g, ' '));\n\n            // Handle multiple values for the same key (arrays)\n            if (decodedKey in result) {\n                const existing = result[decodedKey];\n                if (Array.isArray(existing)) {\n                    existing.push(decodedValue);\n                } else {\n                    result[decodedKey] = [existing, decodedValue];\n                }\n            } else {\n                result[decodedKey] = decodedValue;\n            }\n        }\n\n        return result;\n    }\n\n    /**\n     * Parse multipart form data (for file uploads and form data)\n     * @param buffer - The raw buffer containing multipart data\n     * @param contentType - The content type header\n     * @returns Object containing fields and files\n     */\n    static parseMultipartData(\n        /**\n         * The raw buffer containing multipart data\n         */\n        buffer: Buffer,\n        /**\n         * The content type header\n         */\n        contentType: string\n    ): {\n        fields: Record<string, string>;\n        files: A_Request_FileUpload[];\n    } {\n        // Extract boundary\n        const boundaryMatch = contentType.match(/boundary=(.+)/);\n        if (!boundaryMatch) {\n            throw new A_RequestError(\n                A_RequestError.RequestBodyParsingError,\n                'Missing boundary in multipart/form-data content type'\n            )\n        }\n\n        const boundary = '--' + boundaryMatch[1];\n        const textData = buffer.toString();\n        const parts = textData.split(boundary).filter(part => part.trim() && !part.includes('--'));\n\n        const fields: Record<string, string> = {};\n        const files: A_Request_FileUpload[] = [];\n\n        parts.forEach(part => {\n            const [headers, content] = part.split('\\r\\n\\r\\n');\n            if (!headers || content === undefined) return;\n\n            const nameMatch = headers.match(/name=\"([^\"]+)\"/);\n            const filenameMatch = headers.match(/filename=\"([^\"]+)\"/);\n            const contentTypeMatch = headers.match(/Content-Type: ([^\\r\\n]+)/);\n\n            if (nameMatch) {\n                const fieldName = nameMatch[1];\n                const cleanContent = content.replace(/\\r\\n$/, '');\n\n                if (filenameMatch) {\n                    // It's a file upload\n                    const file: A_Request_FileUpload = {\n                        fieldName,\n                        filename: filenameMatch[1],\n                        encoding: 'binary',\n                        mimetype: contentTypeMatch?.[1] || 'application/octet-stream',\n                        size: Buffer.byteLength(cleanContent),\n                        buffer: Buffer.from(cleanContent, 'binary')\n                    };\n                    files.push(file);\n                } else {\n                    // It's a regular field\n                    fields[fieldName] = cleanContent;\n                }\n            }\n        });\n\n        return { fields, files };\n    }\n\n}"]}

package/dist/node/lib/A-Request/A-Request.types.d.mts

@@ -0,0 +1,17 @@
+import 'http';
+export { a as A_RequestFeatureNames, b as A_Request_BodyType, c as A_Request_Event, d as A_Request_EventCallback, e as A_Request_FileUpload, f as A_Request_Init, g as A_Request_Listener, h as A_Request_Methods, i as A_Request_Options, j as A_Request_ParsedBody, k as A_Request_Serialized, l as A_Request_SessionData, m as A_Request_ValidationResult } from '../../A-Request.entity-r905O60G.mjs';
+import '@adaas/a-concept';
+import '../A-Server/A-HttpServer.types.mjs';
+import './A-Request.constants.mjs';
+import '../A-Server/A-HttpServer.error.mjs';
+import '../A-Server/A-HttpServer.constants.mjs';
+import './A-Request.env.mjs';
+import './A-HttpServerRequest.context.mjs';
+import '@adaas/a-utils/a-operation';
+import './A-HttpRequestData.context.mjs';
+import '@adaas/a-utils/a-execution';
+import '@adaas/a-utils/a-config';
+import '../A-ServerRoute/A-ServerRoute.entity.mjs';
+import '@adaas/a-utils/a-route';
+import '../A-ServerRoute/A-ServerRoute.types.mjs';
+import '../A-ServerRoute/A-ServerRoute.constants.mjs';

package/dist/node/lib/A-Request/A-Request.types.d.ts

@@ -0,0 +1,17 @@
+import 'http';
+export { a as A_RequestFeatureNames, b as A_Request_BodyType, c as A_Request_Event, d as A_Request_EventCallback, e as A_Request_FileUpload, f as A_Request_Init, g as A_Request_Listener, h as A_Request_Methods, i as A_Request_Options, j as A_Request_ParsedBody, k as A_Request_Serialized, l as A_Request_SessionData, m as A_Request_ValidationResult } from '../../A-Request.entity-8_9MCXT2.js';
+import '@adaas/a-concept';
+import '../A-Server/A-HttpServer.types.js';
+import './A-Request.constants.js';
+import '../A-Server/A-HttpServer.error.js';
+import '../A-Server/A-HttpServer.constants.js';
+import './A-Request.env.js';
+import './A-HttpServerRequest.context.js';
+import '@adaas/a-utils/a-operation';
+import './A-HttpRequestData.context.js';
+import '@adaas/a-utils/a-execution';
+import '@adaas/a-utils/a-config';
+import '../A-ServerRoute/A-ServerRoute.entity.js';
+import '@adaas/a-utils/a-route';
+import '../A-ServerRoute/A-ServerRoute.types.js';
+import '../A-ServerRoute/A-ServerRoute.constants.js';

package/dist/node/lib/A-Request/A-Request.types.js

@@ -0,0 +1,14 @@
+'use strict';
+
+var A_Request_Event = /* @__PURE__ */ ((A_Request_Event2) => {
+  A_Request_Event2["Error"] = "error";
+  A_Request_Event2["Finish"] = "finish";
+  A_Request_Event2["Data"] = "data";
+  A_Request_Event2["End"] = "end";
+  A_Request_Event2["Close"] = "close";
+  return A_Request_Event2;
+})(A_Request_Event || {});
+
+exports.A_Request_Event = A_Request_Event;
+//# sourceMappingURL=A-Request.types.js.map
+//# sourceMappingURL=A-Request.types.js.map

package/dist/node/lib/A-Request/A-Request.types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/A-Request/A-Request.types.ts"],"names":["A_Request_Event"],"mappings":";;AA2EO,IAAK,eAAA,qBAAAA,gBAAAA,KAAL;AACH,EAAAA,iBAAA,OAAA,CAAA,GAAQ,OAAA;AACR,EAAAA,iBAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,iBAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,iBAAA,KAAA,CAAA,GAAM,KAAA;AACN,EAAAA,iBAAA,OAAA,CAAA,GAAQ,OAAA;AALA,EAAA,OAAAA,gBAAAA;AAAA,CAAA,EAAA,eAAA,IAAA,EAAA","file":"A-Request.types.js","sourcesContent":["import type { IncomingMessage } from \"http\";\nimport { A_Request } from \"./A-Request.entity\";\nimport { A_TYPES__Entity_Serialized } from \"@adaas/a-concept\";\nimport { A_HttpServerRequestMethod } from \"@adaas/a-server/server/A-HttpServer.types\";\nimport { A_RequestFeatures } from \"./A-Request.constants\";\n\n\n// =============================================\n// Core Request Types\n// =============================================\n/**\n * Constructor parameters for A_Request entity\n */\nexport type A_Request_Init = {\n    /**\n     * Unique identifier for the request (should correspond to Response id)\n     */\n    id: string;\n\n    /**\n     * ASEID Shard for the request.  \n     * it's some sort of request fingerprint\n     */\n    shard: string\n    /**\n     * Node.js IncomingMessage object\n     */\n    request: IncomingMessage;\n    /**\n     * Request scope for context resolution\n     */\n    scope: string;\n};\n\n/**\n * Serialized representation of A_Request entity\n */\nexport type A_Request_Serialized<\n    _ReqBodyType = any,\n    _ParamsType extends Record<string, string> = any,\n    _QueryType = any,\n> = A_TYPES__Entity_Serialized & {\n    method: A_HttpServerRequestMethod;\n    url: string;\n    headers: Record<string, string | string[] | undefined>;\n    params?: _ParamsType;\n    query?: _QueryType;\n    cookies: Record<string, string>;\n    body?: _ReqBodyType;\n    userAgent?: string;\n    isValid: boolean;\n    bodyType?: A_Request_BodyType;\n    filesCount?: number;\n    fileFieldNames?: string[];\n    totalFileSize?: number;\n}\n\n/**\n * Supported HTTP request methods\n */\nexport type A_Request_Methods =\n    | 'GET'\n    | 'POST'\n    | 'PUT'\n    | 'DELETE'\n    | 'PATCH'\n    | 'OPTIONS'\n    | 'HEAD'\n    | 'CONNECT'\n    | 'TRACE'\n    | 'DEFAULT'; // Default is used for routes that do not have a method specified\n\n/**\n * Request lifecycle events\n */\nexport enum A_Request_Event {\n    Error = 'error',\n    Finish = 'finish',\n    Data = 'data',\n    End = 'end',\n    Close = 'close',\n}\n\n\nexport type A_RequestFeatureNames = typeof A_RequestFeatures[keyof typeof A_RequestFeatures];\n\n/**\n * Request event callback function type\n */\nexport type A_Request_EventCallback = (request: A_Request) => void;\n\n\n// =============================================\n// Body Parsing Types\n// =============================================\n\n/**\n * Supported body content types for parsing\n */\nexport type A_Request_BodyType = 'json' | 'form' | 'multipart' | 'raw' | 'text';\n\n/**\n * Result of body parsing operation\n */\nexport type A_Request_ParsedBody = {\n    /**\n     * Type of parsed content\n     */\n    type: A_Request_BodyType;\n    /**\n     * Parsed data\n     */\n    data: any;\n    /**\n     * Size of the body in bytes\n     */\n    size: number;\n    /**\n     * Character encoding used\n     */\n    encoding?: string;\n    /**\n     * Multipart boundary (for multipart content)\n     */\n    boundary?: string;\n};\n\n\n\n// =============================================\n// Session Management Types\n// =============================================\n\n/**\n * Session data structure for user session management\n */\nexport type A_Request_SessionData = {\n    /**\n     * Unique session identifier\n     */\n    id?: string;\n    /**\n     * Associated user ID\n     */\n    userId?: string;\n    /**\n     * Session creation timestamp\n     */\n    createdAt?: Date;\n    /**\n     * Last access timestamp\n     */\n    lastAccess?: Date;\n    /**\n     * Session data storage\n     */\n    data?: Record<string, any>;\n    /**\n     * Whether session is expired\n     */\n    isExpired?: boolean;\n    /**\n     * Maximum session age in milliseconds\n     */\n    maxAge?: number;\n};\n\n\n// =============================================\n// File Upload Types\n// =============================================\n\n/**\n * File upload information for multipart requests\n */\nexport type A_Request_FileUpload = {\n    /**\n     * Form field name\n     */\n    fieldName: string;\n    /**\n     * Original filename\n     */\n    filename: string;\n    /**\n     * File encoding\n     */\n    encoding: string;\n    /**\n     * MIME type\n     */\n    mimetype: string;\n    /**\n     * File size in bytes\n     */\n    size: number;\n    /**\n     * File buffer data\n     */\n    buffer: Buffer;\n    /**\n     * Path if saved to disk\n     */\n    path?: string;\n    /**\n     * File hash for integrity verification\n     */\n    hash?: string;\n};\n\n\n// =============================================\n// Validation Types\n// =============================================\n\n/**\n * Request validation result with detailed feedback\n */\nexport type A_Request_ValidationResult = {\n    /**\n     * Whether validation passed\n     */\n    isValid: boolean;\n    /**\n     * Validation error messages\n     */\n    errors: string[];\n    /**\n     * Warning messages\n     */\n    warnings: string[];\n    /**\n     * Sanitized data after validation\n     */\n    sanitized?: any;\n};\n\n\n// =============================================\n// Configuration Types\n// =============================================\n\n/**\n * Request processing configuration options\n */\nexport type A_Request_Options = {\n    /**\n     * Maximum request body size in bytes (default: 10MB)\n     */\n    maxBodySize?: number;\n    /**\n     * Request timeout in milliseconds (default: 30s)\n     */\n    timeout?: number;\n    /**\n     * Default character encoding (default: 'utf8')\n     */\n    encoding?: string;\n    /**\n     * Automatically parse cookies (default: true)\n     */\n    parseCookies?: boolean;\n    /**\n     * Automatically parse query parameters (default: true)\n     */\n    parseQuery?: boolean;\n    /**\n     * Automatically parse request body (default: true)\n     */\n    parseBody?: boolean;\n    /**\n     * Enable file upload handling (default: false)\n     */\n    enableFileUploads?: boolean;\n    /**\n     * Enable strict validation mode (default: false)\n     */\n    strictValidation?: boolean;\n};\n\n/**\n * Request Event Listener Function\n */\nexport type A_Request_Listener = (req?: A_Request) => void;"]}

package/dist/node/lib/A-Request/A-Request.types.mjs

@@ -0,0 +1,14 @@
+import '../../chunk-EQQGB2QZ.mjs';
+
+var A_Request_Event = /* @__PURE__ */ ((A_Request_Event2) => {
+  A_Request_Event2["Error"] = "error";
+  A_Request_Event2["Finish"] = "finish";
+  A_Request_Event2["Data"] = "data";
+  A_Request_Event2["End"] = "end";
+  A_Request_Event2["Close"] = "close";
+  return A_Request_Event2;
+})(A_Request_Event || {});
+
+export { A_Request_Event };
+//# sourceMappingURL=A-Request.types.mjs.map
+//# sourceMappingURL=A-Request.types.mjs.map

package/dist/node/lib/A-Request/A-Request.types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/A-Request/A-Request.types.ts"],"names":["A_Request_Event"],"mappings":";;AA2EO,IAAK,eAAA,qBAAAA,gBAAAA,KAAL;AACH,EAAAA,iBAAA,OAAA,CAAA,GAAQ,OAAA;AACR,EAAAA,iBAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,iBAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,iBAAA,KAAA,CAAA,GAAM,KAAA;AACN,EAAAA,iBAAA,OAAA,CAAA,GAAQ,OAAA;AALA,EAAA,OAAAA,gBAAAA;AAAA,CAAA,EAAA,eAAA,IAAA,EAAA","file":"A-Request.types.mjs","sourcesContent":["import type { IncomingMessage } from \"http\";\nimport { A_Request } from \"./A-Request.entity\";\nimport { A_TYPES__Entity_Serialized } from \"@adaas/a-concept\";\nimport { A_HttpServerRequestMethod } from \"@adaas/a-server/server/A-HttpServer.types\";\nimport { A_RequestFeatures } from \"./A-Request.constants\";\n\n\n// =============================================\n// Core Request Types\n// =============================================\n/**\n * Constructor parameters for A_Request entity\n */\nexport type A_Request_Init = {\n    /**\n     * Unique identifier for the request (should correspond to Response id)\n     */\n    id: string;\n\n    /**\n     * ASEID Shard for the request.  \n     * it's some sort of request fingerprint\n     */\n    shard: string\n    /**\n     * Node.js IncomingMessage object\n     */\n    request: IncomingMessage;\n    /**\n     * Request scope for context resolution\n     */\n    scope: string;\n};\n\n/**\n * Serialized representation of A_Request entity\n */\nexport type A_Request_Serialized<\n    _ReqBodyType = any,\n    _ParamsType extends Record<string, string> = any,\n    _QueryType = any,\n> = A_TYPES__Entity_Serialized & {\n    method: A_HttpServerRequestMethod;\n    url: string;\n    headers: Record<string, string | string[] | undefined>;\n    params?: _ParamsType;\n    query?: _QueryType;\n    cookies: Record<string, string>;\n    body?: _ReqBodyType;\n    userAgent?: string;\n    isValid: boolean;\n    bodyType?: A_Request_BodyType;\n    filesCount?: number;\n    fileFieldNames?: string[];\n    totalFileSize?: number;\n}\n\n/**\n * Supported HTTP request methods\n */\nexport type A_Request_Methods =\n    | 'GET'\n    | 'POST'\n    | 'PUT'\n    | 'DELETE'\n    | 'PATCH'\n    | 'OPTIONS'\n    | 'HEAD'\n    | 'CONNECT'\n    | 'TRACE'\n    | 'DEFAULT'; // Default is used for routes that do not have a method specified\n\n/**\n * Request lifecycle events\n */\nexport enum A_Request_Event {\n    Error = 'error',\n    Finish = 'finish',\n    Data = 'data',\n    End = 'end',\n    Close = 'close',\n}\n\n\nexport type A_RequestFeatureNames = typeof A_RequestFeatures[keyof typeof A_RequestFeatures];\n\n/**\n * Request event callback function type\n */\nexport type A_Request_EventCallback = (request: A_Request) => void;\n\n\n// =============================================\n// Body Parsing Types\n// =============================================\n\n/**\n * Supported body content types for parsing\n */\nexport type A_Request_BodyType = 'json' | 'form' | 'multipart' | 'raw' | 'text';\n\n/**\n * Result of body parsing operation\n */\nexport type A_Request_ParsedBody = {\n    /**\n     * Type of parsed content\n     */\n    type: A_Request_BodyType;\n    /**\n     * Parsed data\n     */\n    data: any;\n    /**\n     * Size of the body in bytes\n     */\n    size: number;\n    /**\n     * Character encoding used\n     */\n    encoding?: string;\n    /**\n     * Multipart boundary (for multipart content)\n     */\n    boundary?: string;\n};\n\n\n\n// =============================================\n// Session Management Types\n// =============================================\n\n/**\n * Session data structure for user session management\n */\nexport type A_Request_SessionData = {\n    /**\n     * Unique session identifier\n     */\n    id?: string;\n    /**\n     * Associated user ID\n     */\n    userId?: string;\n    /**\n     * Session creation timestamp\n     */\n    createdAt?: Date;\n    /**\n     * Last access timestamp\n     */\n    lastAccess?: Date;\n    /**\n     * Session data storage\n     */\n    data?: Record<string, any>;\n    /**\n     * Whether session is expired\n     */\n    isExpired?: boolean;\n    /**\n     * Maximum session age in milliseconds\n     */\n    maxAge?: number;\n};\n\n\n// =============================================\n// File Upload Types\n// =============================================\n\n/**\n * File upload information for multipart requests\n */\nexport type A_Request_FileUpload = {\n    /**\n     * Form field name\n     */\n    fieldName: string;\n    /**\n     * Original filename\n     */\n    filename: string;\n    /**\n     * File encoding\n     */\n    encoding: string;\n    /**\n     * MIME type\n     */\n    mimetype: string;\n    /**\n     * File size in bytes\n     */\n    size: number;\n    /**\n     * File buffer data\n     */\n    buffer: Buffer;\n    /**\n     * Path if saved to disk\n     */\n    path?: string;\n    /**\n     * File hash for integrity verification\n     */\n    hash?: string;\n};\n\n\n// =============================================\n// Validation Types\n// =============================================\n\n/**\n * Request validation result with detailed feedback\n */\nexport type A_Request_ValidationResult = {\n    /**\n     * Whether validation passed\n     */\n    isValid: boolean;\n    /**\n     * Validation error messages\n     */\n    errors: string[];\n    /**\n     * Warning messages\n     */\n    warnings: string[];\n    /**\n     * Sanitized data after validation\n     */\n    sanitized?: any;\n};\n\n\n// =============================================\n// Configuration Types\n// =============================================\n\n/**\n * Request processing configuration options\n */\nexport type A_Request_Options = {\n    /**\n     * Maximum request body size in bytes (default: 10MB)\n     */\n    maxBodySize?: number;\n    /**\n     * Request timeout in milliseconds (default: 30s)\n     */\n    timeout?: number;\n    /**\n     * Default character encoding (default: 'utf8')\n     */\n    encoding?: string;\n    /**\n     * Automatically parse cookies (default: true)\n     */\n    parseCookies?: boolean;\n    /**\n     * Automatically parse query parameters (default: true)\n     */\n    parseQuery?: boolean;\n    /**\n     * Automatically parse request body (default: true)\n     */\n    parseBody?: boolean;\n    /**\n     * Enable file upload handling (default: false)\n     */\n    enableFileUploads?: boolean;\n    /**\n     * Enable strict validation mode (default: false)\n     */\n    strictValidation?: boolean;\n};\n\n/**\n * Request Event Listener Function\n */\nexport type A_Request_Listener = (req?: A_Request) => void;"]}

package/dist/node/lib/A-Response/A-Response.constants.d.mts

@@ -0,0 +1,24 @@
+declare const A_ResponseFeatures: {
+    /**
+     * Event fired when an error occurs while sending the response
+     */
+    readonly onError: "_A_Response_onError";
+    /**
+     * Event fired when the response is closed
+     */
+    readonly onClose: "_A_Response_onClose";
+    /**
+     * Event fired when the response is finished
+     */
+    readonly onFinish: "_A_Response_onFinish";
+    /**
+     * Event fired when the response is sent
+     */
+    readonly onSend: "_A_Response_onSend";
+    /**
+     * Event fired when the response is redirected
+     */
+    readonly onRedirect: "_A_Response_onRedirect";
+};
+
+export { A_ResponseFeatures };

package/dist/node/lib/A-Response/A-Response.constants.d.ts

@@ -0,0 +1,24 @@
+declare const A_ResponseFeatures: {
+    /**
+     * Event fired when an error occurs while sending the response
+     */
+    readonly onError: "_A_Response_onError";
+    /**
+     * Event fired when the response is closed
+     */
+    readonly onClose: "_A_Response_onClose";
+    /**
+     * Event fired when the response is finished
+     */
+    readonly onFinish: "_A_Response_onFinish";
+    /**
+     * Event fired when the response is sent
+     */
+    readonly onSend: "_A_Response_onSend";
+    /**
+     * Event fired when the response is redirected
+     */
+    readonly onRedirect: "_A_Response_onRedirect";
+};
+
+export { A_ResponseFeatures };

package/dist/node/lib/A-Response/A-Response.constants.js

@@ -0,0 +1,28 @@
+'use strict';
+
+const A_ResponseFeatures = {
+  /**
+   * Event fired when an error occurs while sending the response
+   */
+  onError: "_A_Response_onError",
+  /**
+   * Event fired when the response is closed
+   */
+  onClose: "_A_Response_onClose",
+  /**
+   * Event fired when the response is finished
+   */
+  onFinish: "_A_Response_onFinish",
+  /**
+   * Event fired when the response is sent
+   */
+  onSend: "_A_Response_onSend",
+  /**
+   * Event fired when the response is redirected
+   */
+  onRedirect: "_A_Response_onRedirect"
+};
+
+exports.A_ResponseFeatures = A_ResponseFeatures;
+//# sourceMappingURL=A-Response.constants.js.map
+//# sourceMappingURL=A-Response.constants.js.map

package/dist/node/lib/A-Response/A-Response.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/A-Response/A-Response.constants.ts"],"names":[],"mappings":";;AAEO,MAAM,kBAAA,GAAqB;AAAA;AAAA;AAAA;AAAA,EAI9B,OAAA,EAAS,qBAAA;AAAA;AAAA;AAAA;AAAA,EAIT,OAAA,EAAS,qBAAA;AAAA;AAAA;AAAA;AAAA,EAIT,QAAA,EAAU,sBAAA;AAAA;AAAA;AAAA;AAAA,EAIV,MAAA,EAAQ,oBAAA;AAAA;AAAA;AAAA;AAAA,EAIR,UAAA,EAAY;AAChB","file":"A-Response.constants.js","sourcesContent":["\n\nexport const A_ResponseFeatures = {\n    /**\n     * Event fired when an error occurs while sending the response\n     */\n    onError: '_A_Response_onError',\n    /**\n     * Event fired when the response is closed\n     */\n    onClose: '_A_Response_onClose',\n    /**\n     * Event fired when the response is finished\n     */\n    onFinish: '_A_Response_onFinish',\n    /**\n     * Event fired when the response is sent\n     */\n    onSend: '_A_Response_onSend',\n    /**\n     * Event fired when the response is redirected\n     */\n    onRedirect: '_A_Response_onRedirect',\n} as const;"]}

package/dist/node/lib/A-Response/A-Response.constants.mjs

@@ -0,0 +1,28 @@
+import '../../chunk-EQQGB2QZ.mjs';
+
+const A_ResponseFeatures = {
+  /**
+   * Event fired when an error occurs while sending the response
+   */
+  onError: "_A_Response_onError",
+  /**
+   * Event fired when the response is closed
+   */
+  onClose: "_A_Response_onClose",
+  /**
+   * Event fired when the response is finished
+   */
+  onFinish: "_A_Response_onFinish",
+  /**
+   * Event fired when the response is sent
+   */
+  onSend: "_A_Response_onSend",
+  /**
+   * Event fired when the response is redirected
+   */
+  onRedirect: "_A_Response_onRedirect"
+};
+
+export { A_ResponseFeatures };
+//# sourceMappingURL=A-Response.constants.mjs.map
+//# sourceMappingURL=A-Response.constants.mjs.map