@zudojs/http 0.0.1

package/dist/httpResponse/httpResponse.writer.js

@@ -0,0 +1,278 @@
+/**
+ * HTTP response writer.
+ *
+ * Provides the runtime-independent contract and utilities used to translate
+ * an HttpResponseContext into a concrete HTTP response.
+ *
+ * Runtime adapters such as Node.js, Bun, or Deno should implement the
+ * HttpResponseWriter interface rather than coupling the HTTP core to a
+ * specific runtime.
+ */
+import { HttpResponseContext, serializeResponseCookie, } from "./httpResponse.context.js";
+/* -------------------------------------------------------------------------- */
+/* Errors                                                                     */
+/* -------------------------------------------------------------------------- */
+import { HttpResponseWriterError as ResponseWriterError, ResponseAlreadySentError as ResponseAlreadySentError, UnsupportedResponseBodyError as UnsupportedResponseBodyError, } from "@zudojs/errors";
+export { ResponseWriterError, ResponseAlreadySentError, UnsupportedResponseBodyError, };
+/* -------------------------------------------------------------------------- */
+/* Default Writer                                                             */
+/* -------------------------------------------------------------------------- */
+export class DefaultResponseWriter {
+    async write(context, writer, options = {}) {
+        assertWritable(writer);
+        context.assertMutable();
+        const body = context.body;
+        const status = context.status;
+        const statusText = context.statusText;
+        const headers = context.headers;
+        const cookies = context.cookies;
+        prepareAutomaticHeaders(context);
+        writeHeaders(context, writer, headers);
+        writeCookies(writer, cookies);
+        if (options.flushHeaders !== false && writer.flushHeaders) {
+            writer.flushHeaders();
+        }
+        writer.writeHead(status, statusText);
+        if (isBodyForbidden(status)) {
+            writer.end();
+            context.commit();
+            return;
+        }
+        if (body === undefined || body === null) {
+            if (options.end !== false) {
+                writer.end();
+                context.commit();
+            }
+            return;
+        }
+        if (isReadableStream(body)) {
+            await writeReadableStream(body, writer);
+            writer.end();
+            context.commit();
+            return;
+        }
+        const normalized = normalizeBody(body);
+        if (normalized === undefined) {
+            writer.end();
+            context.commit();
+            return;
+        }
+        if (options.end === false) {
+            writer.write(normalized);
+            return;
+        }
+        writer.end(normalized);
+        context.commit();
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* Convenience Function                                                       */
+/* -------------------------------------------------------------------------- */
+export async function writeResponse(context, writer, options = {}) {
+    const responseWriter = new DefaultResponseWriter();
+    await responseWriter.write(context, writer, options);
+}
+/* -------------------------------------------------------------------------- */
+/* Header Writing                                                             */
+/* -------------------------------------------------------------------------- */
+export function writeHeaders(context, writer, headers = context.headers) {
+    for (const [name, value] of Object.entries(headers)) {
+        if (value === undefined)
+            continue;
+        const strValue = Array.isArray(value) ? value.join(", ") : value;
+        writer.setHeader(name, strValue);
+    }
+}
+export function writeCookies(writer, cookies) {
+    for (const cookie of cookies) {
+        const serialized = serializeResponseCookie(cookie);
+        writer.appendHeader("set-cookie", serialized);
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* Automatic Headers                                                          */
+/* -------------------------------------------------------------------------- */
+export function prepareAutomaticHeaders(context) {
+    const body = context.body;
+    if (context.contentType === undefined &&
+        body !== undefined &&
+        body !== null) {
+        const inferred = inferContentType(body);
+        if (inferred) {
+            context.setContentType(inferred);
+        }
+    }
+    if (context.contentLength === undefined &&
+        body !== undefined &&
+        body !== null &&
+        !isReadableStream(body)) {
+        const length = getBodyByteLength(body);
+        if (length !== undefined) {
+            context.setContentLength(length);
+        }
+    }
+    if (isBodyForbidden(context.status)) {
+        context.removeHeader("content-length");
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* Body Normalization                                                         */
+/* -------------------------------------------------------------------------- */
+export function normalizeBody(body) {
+    if (typeof body === "string") {
+        return body;
+    }
+    if (body instanceof Uint8Array) {
+        return body;
+    }
+    if (body instanceof ArrayBuffer) {
+        return new Uint8Array(body);
+    }
+    if (isReadableStream(body)) {
+        throw new UnsupportedResponseBodyError("ReadableStream bodies must be handled by the streaming writer.");
+    }
+    if (body === undefined || body === null) {
+        return undefined;
+    }
+    if (typeof body === "number" ||
+        typeof body === "boolean" ||
+        typeof body === "bigint") {
+        return String(body);
+    }
+    if (typeof body === "object") {
+        return JSON.stringify(body);
+    }
+    throw new UnsupportedResponseBodyError();
+}
+/* -------------------------------------------------------------------------- */
+/* Streaming                                                                  */
+/* -------------------------------------------------------------------------- */
+export async function writeReadableStream(stream, writer) {
+    const reader = stream.getReader();
+    try {
+        while (true) {
+            const result = await reader.read();
+            if (result.done) {
+                break;
+            }
+            if (result.value) {
+                writer.write(result.value);
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* Body Helpers                                                               */
+/* -------------------------------------------------------------------------- */
+export function getBodyByteLength(body) {
+    if (typeof body === "string") {
+        return getUtf8ByteLength(body);
+    }
+    if (body instanceof Uint8Array) {
+        return body.byteLength;
+    }
+    if (body instanceof ArrayBuffer) {
+        return body.byteLength;
+    }
+    if (body === undefined || body === null) {
+        return 0;
+    }
+    if (isReadableStream(body)) {
+        return undefined;
+    }
+    try {
+        const serialized = JSON.stringify(body);
+        if (serialized === undefined) {
+            return undefined;
+        }
+        return getUtf8ByteLength(serialized);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function getUtf8ByteLength(value) {
+    if (typeof TextEncoder !== "undefined") {
+        return new TextEncoder().encode(value).byteLength;
+    }
+    return unescape(encodeURIComponent(value)).length;
+}
+/* -------------------------------------------------------------------------- */
+/* Content Type Inference                                                     */
+/* -------------------------------------------------------------------------- */
+export function inferContentType(body) {
+    if (typeof body === "string") {
+        return "text/plain; charset=utf-8";
+    }
+    if (body instanceof Uint8Array || body instanceof ArrayBuffer) {
+        return "application/octet-stream";
+    }
+    if (isReadableStream(body)) {
+        return undefined;
+    }
+    if (body !== undefined && body !== null && typeof body === "object") {
+        return "application/json; charset=utf-8";
+    }
+    return "text/plain; charset=utf-8";
+}
+/* -------------------------------------------------------------------------- */
+/* Status Rules                                                               */
+/* -------------------------------------------------------------------------- */
+export function isBodyForbidden(status) {
+    return (status === 101 ||
+        status === 204 ||
+        status === 205 ||
+        status === 304 ||
+        (status >= 100 && status < 200));
+}
+/* -------------------------------------------------------------------------- */
+/* Runtime Detection                                                          */
+/* -------------------------------------------------------------------------- */
+export function isReadableStream(value) {
+    if (typeof ReadableStream === "undefined") {
+        return false;
+    }
+    return value instanceof ReadableStream;
+}
+/* -------------------------------------------------------------------------- */
+/* Writer State                                                               */
+/* -------------------------------------------------------------------------- */
+export function assertWritable(writer) {
+    if (writer.headersSent) {
+        throw new ResponseAlreadySentError("HTTP response headers have already been sent.");
+    }
+    if (writer.writableEnded) {
+        throw new ResponseAlreadySentError("HTTP response has already ended.");
+    }
+    if (writer.writable === false) {
+        throw new ResponseWriterError("HTTP response is not writable.", {
+            code: "HTTP_RESPONSE_NOT_WRITABLE",
+        });
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* Adapter Helpers                                                            */
+/* -------------------------------------------------------------------------- */
+export function createResponseWriter(writer) {
+    return {
+        write(context, _writer, options) {
+            return writeResponse(context, writer, options);
+        },
+    };
+}
+export function isResponseWriter(value) {
+    if (value === null || typeof value !== "object") {
+        return false;
+    }
+    const candidate = value;
+    return (typeof candidate.writeHead === "function" &&
+        typeof candidate.setHeader === "function" &&
+        typeof candidate.appendHeader === "function" &&
+        typeof candidate.removeHeader === "function" &&
+        typeof candidate.write === "function" &&
+        typeof candidate.end === "function");
+}
+//# sourceMappingURL=httpResponse.writer.js.map

package/dist/httpResponse/httpResponse.writer.js.map

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

package/dist/httpResponse/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @zudojs/http/httpResponse
+ *
+ * HTTP response abstraction, context, and writer.
+ */
+export * from "./http.response.js";
+export * from "./httpResponse.context.js";
+export * from "./httpResponse.writer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/httpResponse/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/httpResponse/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC"}

package/dist/httpResponse/index.js

@@ -0,0 +1,9 @@
+/**
+ * @zudojs/http/httpResponse
+ *
+ * HTTP response abstraction, context, and writer.
+ */
+export * from "./http.response.js";
+export * from "./httpResponse.context.js";
+export * from "./httpResponse.writer.js";
+//# sourceMappingURL=index.js.map

package/dist/httpResponse/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/httpResponse/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC"}

package/dist/httpSecurity/httpSecurity.config.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @zudojs/http — Security configuration types.
+ *
+ * Defines the configuration for HTTP security features:
+ * body limits, header validation, host validation, proxy trust,
+ * timeouts, and abort propagation.
+ */
+/** Configuration for HTTP request security guards. */
+export interface HTTPSecurityConfig {
+    /** Maximum request body size in bytes (default: 1MB). */
+    readonly maxBodySize?: number;
+    /** Maximum number of headers allowed (default: 100). */
+    readonly maxHeaders?: number;
+    /** Maximum individual header value size in bytes (default: 8KB). */
+    readonly maxHeaderValueSize?: number;
+    /** Maximum request URL length (default: 2048). */
+    readonly maxUrlLength?: number;
+    /** Maximum query string length (default: 4096). */
+    readonly maxQueryLength?: number;
+    /** Allowed Host header values. Empty = allow all. */
+    readonly allowedHosts?: readonly string[];
+    /** Whether to trust X-Forwarded-* headers (default: false). */
+    readonly trustProxy?: boolean;
+    /** Number of trusted proxy hops (default: 0). */
+    readonly trustedProxyCount?: number;
+    /** Request timeout in milliseconds (default: 30000). */
+    readonly requestTimeout?: number;
+    /** Headers timeout in milliseconds (default: 10000). */
+    readonly headersTimeout?: number;
+    /** Keep-alive timeout in milliseconds (default: 5000). */
+    readonly keepAliveTimeout?: number;
+    /** Maximum request ID length (default: 128). */
+    readonly maxRequestIdLength?: number;
+    /** Characters allowed in request IDs (default: alphanumeric + hyphens + underscores). */
+    readonly requestIdPattern?: RegExp;
+    /** Whether to enable CRLF injection protection (default: true). */
+    readonly enableCrlfProtection?: boolean;
+    /** Whether to enable request smuggling protection (default: true). */
+    readonly enableSmugglingProtection?: boolean;
+}
+/** Default security configuration. */
+export declare const DEFAULT_SECURITY_CONFIG: Required<HTTPSecurityConfig>;
+//# sourceMappingURL=httpSecurity.config.d.ts.map

package/dist/httpSecurity/httpSecurity.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpSecurity.config.d.ts","sourceRoot":"","sources":["../../src/httpSecurity/httpSecurity.config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,wDAAwD;IACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,kDAAkD;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,qDAAqD;IACrD,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,iDAAiD;IACjD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,wDAAwD;IACxD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,wDAAwD;IACxD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,0DAA0D;IAC1D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,gDAAgD;IAChD,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,yFAAyF;IACzF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,mEAAmE;IACnE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,sEAAsE;IACtE,QAAQ,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAC;CAC9C;AAED,sCAAsC;AACtC,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,kBAAkB,CAiB7D,CAAC"}

package/dist/httpSecurity/httpSecurity.config.js

@@ -0,0 +1,26 @@
+/**
+ * @zudojs/http — Security configuration types.
+ *
+ * Defines the configuration for HTTP security features:
+ * body limits, header validation, host validation, proxy trust,
+ * timeouts, and abort propagation.
+ */
+/** Default security configuration. */
+export const DEFAULT_SECURITY_CONFIG = Object.freeze({
+    maxBodySize: 1_048_576, // 1MB
+    maxHeaders: 100,
+    maxHeaderValueSize: 8_192, // 8KB
+    maxUrlLength: 2048,
+    maxQueryLength: 4096,
+    allowedHosts: [],
+    trustProxy: false,
+    trustedProxyCount: 0,
+    requestTimeout: 30_000, // 30s
+    headersTimeout: 10_000, // 10s
+    keepAliveTimeout: 5_000, // 5s
+    maxRequestIdLength: 128,
+    requestIdPattern: /^[a-zA-Z0-9_-]+$/,
+    enableCrlfProtection: true,
+    enableSmugglingProtection: true,
+});
+//# sourceMappingURL=httpSecurity.config.js.map

package/dist/httpSecurity/httpSecurity.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpSecurity.config.js","sourceRoot":"","sources":["../../src/httpSecurity/httpSecurity.config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoCH,sCAAsC;AACtC,MAAM,CAAC,MAAM,uBAAuB,GAClC,MAAM,CAAC,MAAM,CAAC;IACZ,WAAW,EAAE,SAAS,EAAE,MAAM;IAC9B,UAAU,EAAE,GAAG;IACf,kBAAkB,EAAE,KAAK,EAAE,MAAM;IACjC,YAAY,EAAE,IAAI;IAClB,cAAc,EAAE,IAAI;IACpB,YAAY,EAAE,EAAE;IAChB,UAAU,EAAE,KAAK;IACjB,iBAAiB,EAAE,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,MAAM;IAC9B,cAAc,EAAE,MAAM,EAAE,MAAM;IAC9B,gBAAgB,EAAE,KAAK,EAAE,KAAK;IAC9B,kBAAkB,EAAE,GAAG;IACvB,gBAAgB,EAAE,kBAAkB;IACpC,oBAAoB,EAAE,IAAI;IAC1B,yBAAyB,EAAE,IAAI;CAChC,CAAC,CAAC"}

package/dist/httpSecurity/httpSecurity.guard.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @zudojs/http — Request guard middleware.
+ *
+ * Validates incoming requests against security constraints at the
+ * first security boundary. Rejects malformed, oversized, or
+ * suspicious requests before they reach the router.
+ */
+import type { HTTPSecurityConfig } from "./httpSecurity.config.js";
+/** A request-like object for validation (keeps the guard decoupled from HTTP types). */
+export interface GuardableRequest {
+    readonly method: string;
+    readonly url: string;
+    readonly headers: Record<string, string | string[] | undefined>;
+}
+/** Result of the request guard check. */
+export interface GuardResult {
+    readonly allowed: boolean;
+    readonly errors: readonly string[];
+    readonly statusCode: number;
+}
+/**
+ * Run all security validations against an incoming request.
+ *
+ * @param request - The incoming request to validate.
+ * @param config - Security configuration.
+ * @returns A GuardResult indicating whether the request is allowed.
+ */
+export declare function guardRequest(request: GuardableRequest, config?: Partial<HTTPSecurityConfig>): GuardResult;
+//# sourceMappingURL=httpSecurity.guard.d.ts.map

package/dist/httpSecurity/httpSecurity.guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpSecurity.guard.d.ts","sourceRoot":"","sources":["../../src/httpSecurity/httpSecurity.guard.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAYnE,wFAAwF;AACxF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;CACjE;AAED,yCAAyC;AACzC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,WAAW,CA8Cb"}

package/dist/httpSecurity/httpSecurity.guard.js

@@ -0,0 +1,40 @@
+/**
+ * @zudojs/http — Request guard middleware.
+ *
+ * Validates incoming requests against security constraints at the
+ * first security boundary. Rejects malformed, oversized, or
+ * suspicious requests before they reach the router.
+ */
+import { validateHeaders, validateHost, validateUrl, validateQuery, validateContentLength, validateRequestId, validateTransferEncoding, } from "./httpSecurity.validator.js";
+/**
+ * Run all security validations against an incoming request.
+ *
+ * @param request - The incoming request to validate.
+ * @param config - Security configuration.
+ * @returns A GuardResult indicating whether the request is allowed.
+ */
+export function guardRequest(request, config) {
+    const allErrors = [];
+    const urlParts = request.url.split("?");
+    const path = urlParts[0] ?? request.url;
+    const query = urlParts[1] ?? "";
+    const headerResult = validateHeaders(request.headers, config);
+    allErrors.push(...headerResult.errors);
+    const hostResult = validateHost(request.headers.host, config);
+    allErrors.push(...hostResult.errors);
+    const urlResult = validateUrl(path, config);
+    allErrors.push(...urlResult.errors);
+    const queryResult = validateQuery(query, config);
+    allErrors.push(...queryResult.errors);
+    const contentLengthResult = validateContentLength(request.headers["content-length"], config);
+    allErrors.push(...contentLengthResult.errors);
+    const requestIdResult = validateRequestId(request.headers["x-request-id"], config);
+    allErrors.push(...requestIdResult.errors);
+    const transferEncodingResult = validateTransferEncoding(request.headers["transfer-encoding"], request.headers["content-length"], config);
+    allErrors.push(...transferEncodingResult.errors);
+    if (allErrors.length > 0) {
+        return { allowed: false, errors: allErrors, statusCode: 400 };
+    }
+    return { allowed: true, errors: [], statusCode: 200 };
+}
+//# sourceMappingURL=httpSecurity.guard.js.map

package/dist/httpSecurity/httpSecurity.guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpSecurity.guard.js","sourceRoot":"","sources":["../../src/httpSecurity/httpSecurity.guard.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,eAAe,EACf,YAAY,EACZ,WAAW,EACX,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,GAEzB,MAAM,6BAA6B,CAAC;AAgBrC;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAyB,EACzB,MAAoC;IAEpC,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC;IACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEhC,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9D,SAAS,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAEvC,MAAM,UAAU,GAAG,YAAY,CAC7B,OAAO,CAAC,OAAO,CAAC,IAA0B,EAC1C,MAAM,CACP,CAAC;IACF,SAAS,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAErC,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5C,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAEpC,MAAM,WAAW,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACjD,SAAS,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAEtC,MAAM,mBAAmB,GAAG,qBAAqB,CAC/C,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAuB,EACvD,MAAM,CACP,CAAC;IACF,SAAS,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE9C,MAAM,eAAe,GAAG,iBAAiB,CACvC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAuB,EACrD,MAAM,CACP,CAAC;IACF,SAAS,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAE1C,MAAM,sBAAsB,GAAG,wBAAwB,CACrD,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAuB,EAC1D,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAuB,EACvD,MAAM,CACP,CAAC;IACF,SAAS,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAEjD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;IAChE,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;AACxD,CAAC"}

package/dist/httpSecurity/httpSecurity.validator.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @zudojs/http — Request validation functions.
+ *
+ * Validates incoming HTTP requests against security constraints:
+ * body size, header count, header values, URL length, host, and
+ * request ID format.
+ */
+import type { HTTPSecurityConfig } from "./httpSecurity.config.js";
+/** Result of a security validation check. */
+export interface SecurityValidationResult {
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+}
+/**
+ * Validate request headers against security limits.
+ */
+export declare function validateHeaders(headers: Record<string, string | string[] | undefined>, config?: Partial<HTTPSecurityConfig>): SecurityValidationResult;
+/**
+ * Validate the Host header against allowed hosts.
+ */
+export declare function validateHost(host: string | undefined, config?: Partial<HTTPSecurityConfig>): SecurityValidationResult;
+/**
+ * Validate request URL length.
+ */
+export declare function validateUrl(url: string, config?: Partial<HTTPSecurityConfig>): SecurityValidationResult;
+/**
+ * Validate query string length.
+ */
+export declare function validateQuery(query: string, config?: Partial<HTTPSecurityConfig>): SecurityValidationResult;
+/**
+ * Validate Content-Length header against body size limit.
+ */
+export declare function validateContentLength(contentLength: string | undefined, config?: Partial<HTTPSecurityConfig>): SecurityValidationResult;
+/**
+ * Validate X-Request-ID format and length.
+ */
+export declare function validateRequestId(requestId: string | undefined, config?: Partial<HTTPSecurityConfig>): SecurityValidationResult;
+/**
+ * Validate transfer encoding to prevent request smuggling.
+ */
+export declare function validateTransferEncoding(transferEncoding: string | undefined, contentLength: string | undefined, config?: Partial<HTTPSecurityConfig>): SecurityValidationResult;
+//# sourceMappingURL=httpSecurity.validator.d.ts.map

package/dist/httpSecurity/httpSecurity.validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpSecurity.validator.d.ts","sourceRoot":"","sources":["../../src/httpSecurity/httpSecurity.validator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAGnE,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AASD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,EACtD,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,wBAAwB,CAyB1B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,wBAAwB,CAgB1B;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,wBAAwB,CAS1B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,wBAAwB,CAW1B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,wBAAwB,CA0B1B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,wBAAwB,CAwB1B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,wBAAwB,CAqB1B"}