@irvinebroque/http-rfc-utils 0.1.0

package/dist/prefer.js

@@ -0,0 +1,93 @@
+/**
+ * Prefer / Preference-Applied utilities per RFC 7240.
+ * RFC 7240 §2, §3.
+ */
+import { isEmptyHeader, splitQuotedValue, unquote, quoteIfNeeded } from './header-utils.js';
+/**
+ * Parse a Prefer header into a map of preference tokens.
+ */
+// RFC 7240 §2: Prefer header parsing.
+export function parsePrefer(header) {
+    const map = new Map();
+    if (isEmptyHeader(header)) {
+        return map;
+    }
+    const parts = splitQuotedValue(header, ',');
+    for (const part of parts) {
+        const trimmed = part.trim();
+        if (!trimmed)
+            continue;
+        const segments = splitQuotedValue(trimmed, ';').map(segment => segment.trim()).filter(Boolean);
+        if (segments.length === 0) {
+            continue;
+        }
+        const [tokenPart, ...paramParts] = segments;
+        if (!tokenPart)
+            continue;
+        const eqIndex = tokenPart.indexOf('=');
+        // RFC 7240 §2: Token names are case-insensitive.
+        const token = (eqIndex === -1 ? tokenPart : tokenPart.slice(0, eqIndex)).trim().toLowerCase();
+        if (!token)
+            continue;
+        const rawValue = eqIndex === -1 ? undefined : unquote(tokenPart.slice(eqIndex + 1).trim());
+        // RFC 7240 §2: Empty values are equivalent to no value.
+        const value = rawValue === '' ? undefined : rawValue;
+        const params = [];
+        for (const paramPart of paramParts) {
+            const paramEq = paramPart.indexOf('=');
+            if (paramEq === -1) {
+                params.push({ key: paramPart.trim().toLowerCase() });
+            }
+            else {
+                const key = paramPart.slice(0, paramEq).trim().toLowerCase();
+                const val = unquote(paramPart.slice(paramEq + 1).trim());
+                if (key) {
+                    // RFC 7240 §2: Empty values are equivalent to no value.
+                    params.push({ key, value: val === '' ? undefined : val });
+                }
+            }
+        }
+        if (!map.has(token)) {
+            map.set(token, { token, value, params });
+        }
+    }
+    return map;
+}
+/**
+ * Format Prefer header from tokens.
+ */
+// RFC 7240 §2: Prefer header formatting.
+export function formatPrefer(preferences) {
+    const tokens = Array.isArray(preferences) ? preferences : Array.from(preferences.values());
+    return tokens.map(token => {
+        const parts = [];
+        const base = token.value !== undefined ? `${token.token}=${quoteIfNeeded(token.value)}` : token.token;
+        parts.push(base);
+        for (const param of token.params ?? []) {
+            if (param.value === undefined) {
+                parts.push(param.key);
+            }
+            else {
+                parts.push(`${param.key}=${quoteIfNeeded(param.value)}`);
+            }
+        }
+        return parts.join('; ');
+    }).join(', ');
+}
+/**
+ * Format Preference-Applied header.
+ */
+// RFC 7240 §3: Preference-Applied header formatting.
+export function formatPreferenceApplied(preferences) {
+    if (Array.isArray(preferences)) {
+        return preferences.join(', ');
+    }
+    const tokens = Array.from(preferences.values());
+    return tokens.map(token => {
+        if (token.value !== undefined) {
+            return `${token.token}=${quoteIfNeeded(token.value)}`;
+        }
+        return token.token;
+    }).join(', ');
+}
+//# sourceMappingURL=prefer.js.map

package/dist/prefer.js.map

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

package/dist/problem.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Problem Details utilities per RFC 9457.
+ * RFC 9457 §3.1, §3.2, §4.1.
+ */
+import type { ProblemDetails, ProblemOptions } from './types.js';
+/**
+ * Create a Problem Details object per RFC 9457.
+ *
+ * @param options - Problem configuration
+ * @returns Problem Details object
+ *
+ * RFC 9457 members:
+ * - type: URI reference identifying problem type (default: 'about:blank')
+ * - title: Short human-readable summary
+ * - status: HTTP status code
+ * - detail: Human-readable explanation specific to this occurrence
+ * - instance: URI reference identifying specific occurrence (optional)
+ *
+ * Extension members from options.extensions are spread into the result.
+ */
+export declare function createProblem(options: ProblemOptions): ProblemDetails;
+/**
+ * Create a Problem Details Response with proper headers.
+ *
+ * @param options - Problem configuration
+ * @param corsHeaders - Optional CORS headers (defaults to defaultCorsHeaders)
+ */
+export declare function problemResponse(options: ProblemOptions, corsHeaders?: Record<string, string>): Response;
+/**
+ * Create a Problem Details Response with proper headers.
+ *
+ * @param status - HTTP status code
+ * @param title - Error title
+ * @param detail - Error detail
+ * @param instance - Optional instance URI
+ */
+export declare function problemResponse(status: number, title: string, detail: string, instance?: string): Response;
+/**
+ * Common HTTP error responses as Problem Details
+ */
+export declare const Problems: {
+    readonly badRequest: (detail: string, instance?: string) => Response;
+    readonly unauthorized: (detail: string, instance?: string) => Response;
+    readonly forbidden: (detail: string, instance?: string) => Response;
+    readonly notFound: (detail: string, instance?: string) => Response;
+    readonly methodNotAllowed: (detail: string, allowed: string[], instance?: string) => Response;
+    readonly conflict: (detail: string, instance?: string) => Response;
+    readonly gone: (detail: string, instance?: string) => Response;
+    readonly unprocessableEntity: (detail: string, errors?: unknown[], instance?: string) => Response;
+    readonly tooManyRequests: (detail: string, retryAfter?: number, instance?: string) => Response;
+    readonly internalServerError: (detail: string, instance?: string) => Response;
+    readonly serviceUnavailable: (detail: string, retryAfter?: number, instance?: string) => Response;
+};
+//# sourceMappingURL=problem.d.ts.map

package/dist/problem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"problem.d.ts","sourceRoot":"","sources":["../src/problem.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjE;;;;;;;;;;;;;;GAcG;AAEH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CAiBrE;AAED;;;;;GAKG;AAEH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC;AACzG;;;;;;;GAOG;AAEH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;AAkC5G;;GAEG;AAEH,eAAO,MAAM,QAAQ;kCACI,MAAM,aAAa,MAAM;oCAGvB,MAAM,aAAa,MAAM;iCAG5B,MAAM,aAAa,MAAM;gCAG1B,MAAM,aAAa,MAAM;wCAGjB,MAAM,WAAW,MAAM,EAAE,aAAa,MAAM;gCASpD,MAAM,aAAa,MAAM;4BAG7B,MAAM,aAAa,MAAM;2CAGV,MAAM,WAAW,OAAO,EAAE,aAAa,MAAM;uCASjD,MAAM,eAAe,MAAM,aAAa,MAAM;2CAS1C,MAAM,aAAa,MAAM;0CAG1B,MAAM,eAAe,MAAM,aAAa,MAAM;CAQrE,CAAC"}

package/dist/problem.js

@@ -0,0 +1,104 @@
+/**
+ * Problem Details utilities per RFC 9457.
+ * RFC 9457 §3.1, §3.2, §4.1.
+ */
+import { defaultCorsHeaders } from './cors.js';
+/**
+ * Create a Problem Details object per RFC 9457.
+ *
+ * @param options - Problem configuration
+ * @returns Problem Details object
+ *
+ * RFC 9457 members:
+ * - type: URI reference identifying problem type (default: 'about:blank')
+ * - title: Short human-readable summary
+ * - status: HTTP status code
+ * - detail: Human-readable explanation specific to this occurrence
+ * - instance: URI reference identifying specific occurrence (optional)
+ *
+ * Extension members from options.extensions are spread into the result.
+ */
+// RFC 9457 §3.1, §3.2: Problem Details members and extensions.
+export function createProblem(options) {
+    const problem = {
+        type: options.type ?? 'about:blank',
+        title: options.title,
+        status: options.status,
+        detail: options.detail,
+    };
+    if (options.instance !== undefined) {
+        problem.instance = options.instance;
+    }
+    if (options.extensions) {
+        Object.assign(problem, options.extensions);
+    }
+    return problem;
+}
+export function problemResponse(optionsOrStatus, titleOrCorsHeaders, detail, instance) {
+    let problem;
+    let cors;
+    if (typeof optionsOrStatus === 'number') {
+        // Backward-compatible signature: (status, title, detail, instance?)
+        problem = createProblem({
+            status: optionsOrStatus,
+            title: titleOrCorsHeaders,
+            detail: detail,
+            instance,
+        });
+        cors = defaultCorsHeaders;
+    }
+    else {
+        // Full options object: (options, corsHeaders?)
+        problem = createProblem(optionsOrStatus);
+        cors = titleOrCorsHeaders ?? defaultCorsHeaders;
+    }
+    return new Response(JSON.stringify(problem), {
+        status: problem.status,
+        headers: {
+            'Content-Type': 'application/problem+json',
+            ...cors,
+        },
+    });
+}
+/**
+ * Common HTTP error responses as Problem Details
+ */
+// RFC 9457 §3.1: Problem Details members populated by helpers.
+export const Problems = {
+    badRequest: (detail, instance) => problemResponse({ status: 400, title: 'Bad Request', detail, instance }),
+    unauthorized: (detail, instance) => problemResponse({ status: 401, title: 'Unauthorized', detail, instance }),
+    forbidden: (detail, instance) => problemResponse({ status: 403, title: 'Forbidden', detail, instance }),
+    notFound: (detail, instance) => problemResponse({ status: 404, title: 'Not Found', detail, instance }),
+    methodNotAllowed: (detail, allowed, instance) => problemResponse({
+        status: 405,
+        title: 'Method Not Allowed',
+        detail,
+        instance,
+        extensions: { allowed },
+    }),
+    conflict: (detail, instance) => problemResponse({ status: 409, title: 'Conflict', detail, instance }),
+    gone: (detail, instance) => problemResponse({ status: 410, title: 'Gone', detail, instance }),
+    unprocessableEntity: (detail, errors, instance) => problemResponse({
+        status: 422,
+        title: 'Unprocessable Entity',
+        detail,
+        instance,
+        extensions: errors ? { errors } : undefined,
+    }),
+    tooManyRequests: (detail, retryAfter, instance) => problemResponse({
+        status: 429,
+        title: 'Too Many Requests',
+        detail,
+        instance,
+        extensions: retryAfter !== undefined ? { retryAfter } : undefined,
+    }),
+    internalServerError: (detail, instance) => problemResponse({ status: 500, title: 'Internal Server Error', detail, instance }),
+    serviceUnavailable: (detail, retryAfter, instance) => problemResponse({
+        status: 503,
+        title: 'Service Unavailable',
+        detail,
+        instance,
+        extensions: retryAfter !== undefined ? { retryAfter } : undefined,
+    }),
+};
+//# sourceMappingURL=problem.js.map

package/dist/problem.js.map

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

package/dist/proxy-status.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Proxy-Status utilities per RFC 9209.
+ * RFC 9209 §2-§2.4.
+ * @see https://www.rfc-editor.org/rfc/rfc9209.html#section-2
+ */
+import type { ProxyStatusEntry, ProxyErrorType } from './types.js';
+/**
+ * All 32 proxy error types defined in RFC 9209 §2.3.
+ */
+export declare const PROXY_ERROR_TYPES: readonly ProxyErrorType[];
+/**
+ * Type guard to check if a value is a known proxy error type.
+ * RFC 9209 §2.3.
+ */
+export declare function isProxyErrorType(value: string): value is ProxyErrorType;
+/**
+ * Parse Proxy-Status header value into entries.
+ * RFC 9209 §2: Proxy-Status is a Structured Field List.
+ * Each member MUST be a String or Token (not Inner List).
+ * First member = closest to origin; last = closest to user agent.
+ */
+export declare function parseProxyStatus(header: string): ProxyStatusEntry[] | null;
+/**
+ * Format Proxy-Status header value from entries.
+ * RFC 9209 §2: Proxy-Status Structured Field serialization.
+ */
+export declare function formatProxyStatus(entries: ProxyStatusEntry[]): string;
+//# sourceMappingURL=proxy-status.d.ts.map

package/dist/proxy-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-status.d.ts","sourceRoot":"","sources":["../src/proxy-status.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAqB,cAAc,EAA8B,MAAM,YAAY,CAAC;AAGlH;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,cAAc,EAiC7C,CAAC;AAIX;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE;AAyID;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,EAAE,GAAG,IAAI,CA4B1E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAQrE"}

package/dist/proxy-status.js

@@ -0,0 +1,220 @@
+/**
+ * Proxy-Status utilities per RFC 9209.
+ * RFC 9209 §2-§2.4.
+ * @see https://www.rfc-editor.org/rfc/rfc9209.html#section-2
+ */
+import { parseSfList, serializeSfList } from './structured-fields.js';
+/**
+ * All 32 proxy error types defined in RFC 9209 §2.3.
+ */
+export const PROXY_ERROR_TYPES = [
+    'dns_timeout',
+    'dns_error',
+    'destination_not_found',
+    'destination_unavailable',
+    'destination_ip_prohibited',
+    'destination_ip_unroutable',
+    'connection_refused',
+    'connection_terminated',
+    'connection_timeout',
+    'connection_read_timeout',
+    'connection_write_timeout',
+    'connection_limit_reached',
+    'tls_protocol_error',
+    'tls_certificate_error',
+    'tls_alert_received',
+    'http_request_error',
+    'http_request_denied',
+    'http_response_incomplete',
+    'http_response_header_section_size',
+    'http_response_header_size',
+    'http_response_body_size',
+    'http_response_trailer_section_size',
+    'http_response_trailer_size',
+    'http_response_transfer_coding',
+    'http_response_content_coding',
+    'http_response_timeout',
+    'http_upgrade_failed',
+    'http_protocol_error',
+    'proxy_internal_response',
+    'proxy_internal_error',
+    'proxy_configuration_error',
+    'proxy_loop_detected',
+];
+const PROXY_ERROR_TYPE_SET = new Set(PROXY_ERROR_TYPES);
+/**
+ * Type guard to check if a value is a known proxy error type.
+ * RFC 9209 §2.3.
+ */
+export function isProxyErrorType(value) {
+    return PROXY_ERROR_TYPE_SET.has(value);
+}
+function isInteger(value) {
+    return Number.isInteger(value) && Number.isFinite(value);
+}
+// RFC 9209 §2.1: Parse parameters from SF item params.
+function parseProxyStatusParams(params) {
+    const result = {};
+    if (!params) {
+        return result;
+    }
+    const extensions = {};
+    for (const [key, value] of Object.entries(params)) {
+        switch (key) {
+            // RFC 9209 §2.1.1: error parameter is a Token.
+            case 'error':
+                if (typeof value === 'string') {
+                    result.error = value;
+                }
+                break;
+            // RFC 9209 §2.1.2: next-hop is a String or Token.
+            case 'next-hop':
+                if (typeof value === 'string') {
+                    result.nextHop = value;
+                }
+                break;
+            // RFC 9209 §2.1.3: next-protocol is a Token or Byte Sequence.
+            case 'next-protocol':
+                if (typeof value === 'string') {
+                    result.nextProtocol = value;
+                }
+                break;
+            // RFC 9209 §2.1.4: received-status is an Integer.
+            case 'received-status':
+                if (typeof value === 'number' && isInteger(value)) {
+                    result.receivedStatus = value;
+                }
+                break;
+            // RFC 9209 §2.1.5: details is a String.
+            case 'details':
+                if (typeof value === 'string') {
+                    result.details = value;
+                }
+                break;
+            // RFC 9209 §2.3.2: rcode extra parameter for dns_error.
+            case 'rcode':
+                if (typeof value === 'string') {
+                    result.rcode = value;
+                }
+                break;
+            // RFC 9209 §2.3.2: info-code extra parameter for dns_error.
+            case 'info-code':
+                if (typeof value === 'number' && isInteger(value)) {
+                    result.infoCode = value;
+                }
+                break;
+            // RFC 9209 §2.3.15: alert-id extra parameter for tls_alert_received.
+            case 'alert-id':
+                if (typeof value === 'number' && isInteger(value)) {
+                    result.alertId = value;
+                }
+                break;
+            // RFC 9209 §2.3.15: alert-message extra parameter for tls_alert_received.
+            case 'alert-message':
+                if (typeof value === 'string') {
+                    result.alertMessage = value;
+                }
+                break;
+            default:
+                // RFC 9209 §2.1: Unrecognized parameters MUST be ignored, but preserve for extensibility.
+                extensions[key] = value;
+                break;
+        }
+    }
+    if (Object.keys(extensions).length > 0) {
+        result.extensions = extensions;
+    }
+    return result;
+}
+// RFC 9209 §2: Build SF item params from typed interface.
+function buildProxyStatusParams(params) {
+    const result = {};
+    if (params.error !== undefined) {
+        result.error = params.error;
+    }
+    if (params.nextHop !== undefined) {
+        result['next-hop'] = params.nextHop;
+    }
+    if (params.nextProtocol !== undefined) {
+        result['next-protocol'] = params.nextProtocol;
+    }
+    if (params.receivedStatus !== undefined) {
+        if (!isInteger(params.receivedStatus)) {
+            throw new Error('Invalid Proxy-Status received-status value');
+        }
+        result['received-status'] = params.receivedStatus;
+    }
+    if (params.details !== undefined) {
+        result.details = params.details;
+    }
+    if (params.rcode !== undefined) {
+        result.rcode = params.rcode;
+    }
+    if (params.infoCode !== undefined) {
+        if (!isInteger(params.infoCode)) {
+            throw new Error('Invalid Proxy-Status info-code value');
+        }
+        result['info-code'] = params.infoCode;
+    }
+    if (params.alertId !== undefined) {
+        if (!isInteger(params.alertId)) {
+            throw new Error('Invalid Proxy-Status alert-id value');
+        }
+        result['alert-id'] = params.alertId;
+    }
+    if (params.alertMessage !== undefined) {
+        result['alert-message'] = params.alertMessage;
+    }
+    if (params.extensions) {
+        for (const [key, value] of Object.entries(params.extensions)) {
+            if (!(key in result)) {
+                result[key] = value;
+            }
+        }
+    }
+    return Object.keys(result).length > 0 ? result : undefined;
+}
+/**
+ * Parse Proxy-Status header value into entries.
+ * RFC 9209 §2: Proxy-Status is a Structured Field List.
+ * Each member MUST be a String or Token (not Inner List).
+ * First member = closest to origin; last = closest to user agent.
+ */
+export function parseProxyStatus(header) {
+    if (!header || !header.trim()) {
+        return [];
+    }
+    const list = parseSfList(header);
+    if (!list) {
+        return null;
+    }
+    const entries = [];
+    for (const member of list) {
+        // RFC 9209 §2: Each member MUST have a type of either String or Token.
+        // Inner lists are not allowed.
+        if ('items' in member) {
+            return null;
+        }
+        if (typeof member.value !== 'string') {
+            return null;
+        }
+        entries.push({
+            proxy: member.value,
+            params: parseProxyStatusParams(member.params),
+        });
+    }
+    return entries;
+}
+/**
+ * Format Proxy-Status header value from entries.
+ * RFC 9209 §2: Proxy-Status Structured Field serialization.
+ */
+export function formatProxyStatus(entries) {
+    const list = entries.map((entry) => {
+        const params = buildProxyStatusParams(entry.params ?? {});
+        const item = params ? { value: entry.proxy, params } : { value: entry.proxy };
+        return item;
+    });
+    return serializeSfList(list);
+}
+//# sourceMappingURL=proxy-status.js.map

package/dist/proxy-status.js.map

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

package/dist/range.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Range request utilities per RFC 9110 (13.2.1, 14.2).
+ */
+import type { ByteRange, RangeSpec, ContentRange, RangeDecision } from './types.js';
+/**
+ * Parse a Range header into raw byte ranges.
+ *
+ * NOTE: Open-ended ranges use end = Infinity.
+ * Suffix ranges use start = -N and end = -1.
+ */
+export declare function parseRange(header: string): RangeSpec | null;
+/**
+ * Parse a Content-Range header.
+ */
+export declare function parseContentRange(header: string): ContentRange | null;
+/**
+ * Format a Content-Range header value.
+ */
+export declare function formatContentRange(range: ByteRange, size: number | '*'): string;
+/**
+ * Build Accept-Ranges header value.
+ */
+export declare function acceptRanges(value?: 'bytes' | 'none'): string;
+/**
+ * Evaluate a Range request and determine partial content handling.
+ */
+export declare function evaluateRange(request: Request, size: number, etag?: string, lastModified?: Date): RangeDecision;
+//# sourceMappingURL=range.d.ts.map

package/dist/range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../src/range.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMpF;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAmE3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAoDrE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,MAAM,CAG/E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,GAAE,OAAO,GAAG,MAAgB,GAAG,MAAM,CAEtE;AA6ED;;GAEG;AACH,wBAAgB,aAAa,CACzB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,IAAI,GACpB,aAAa,CA0Df"}