@irvinebroque/http-rfc-utils 0.1.0

package/dist/digest.js

@@ -0,0 +1,355 @@
+/**
+ * Digest Fields per RFC 9530.
+ * RFC 9530 §2, §3, §4, §5.
+ * @see https://www.rfc-editor.org/rfc/rfc9530.html
+ *
+ * Provides Content-Digest and Repr-Digest HTTP header field parsing/formatting
+ * for content and representation integrity verification. Also provides
+ * Want-Content-Digest and Want-Repr-Digest preference fields.
+ */
+import { parseSfDict, serializeSfDict } from './structured-fields.js';
+// =============================================================================
+// Constants
+// =============================================================================
+/**
+ * Algorithm classification constants.
+ * RFC 9530 §5, §7.2.
+ */
+export const DIGEST_ALGORITHMS = {
+    /** Algorithms suitable for adversarial settings */
+    active: ['sha-256', 'sha-512'],
+    /** Algorithms that MUST NOT be used in adversarial settings */
+    deprecated: ['md5', 'sha', 'unixsum', 'unixcksum', 'adler', 'crc32c'],
+};
+// =============================================================================
+// Algorithm Helpers
+// =============================================================================
+/**
+ * Check if an algorithm is active (suitable for adversarial settings).
+ * RFC 9530 §5.
+ */
+export function isActiveAlgorithm(algorithm) {
+    return DIGEST_ALGORITHMS.active.includes(algorithm.toLowerCase());
+}
+/**
+ * Check if an algorithm is deprecated.
+ * RFC 9530 §5.
+ */
+export function isDeprecatedAlgorithm(algorithm) {
+    return DIGEST_ALGORITHMS.deprecated.includes(algorithm.toLowerCase());
+}
+// =============================================================================
+// Parsing
+// =============================================================================
+/**
+ * Parse digest values from a structured field dictionary.
+ * Returns null for malformed input.
+ */
+function parseDigestField(value) {
+    const dict = parseSfDict(value);
+    if (!dict) {
+        return null;
+    }
+    const digests = [];
+    for (const [algorithm, item] of Object.entries(dict)) {
+        // RFC 9530 §2, §3: value is a Byte Sequence
+        if ('items' in item) {
+            // Inner list not valid for digest values
+            continue;
+        }
+        const sfItem = item;
+        if (!(sfItem.value instanceof Uint8Array)) {
+            // Must be a byte sequence
+            continue;
+        }
+        digests.push({
+            algorithm: algorithm.toLowerCase(),
+            value: sfItem.value,
+        });
+    }
+    return digests.length > 0 ? digests : [];
+}
+/**
+ * Parse Content-Digest header field value.
+ * RFC 9530 §2.
+ *
+ * @param value - The Content-Digest header value
+ * @returns Array of digests, or null if malformed
+ *
+ * @example
+ * ```ts
+ * const digests = parseContentDigest('sha-256=:abc123...:');
+ * ```
+ */
+export function parseContentDigest(value) {
+    return parseDigestField(value);
+}
+/**
+ * Parse Repr-Digest header field value.
+ * RFC 9530 §3.
+ *
+ * @param value - The Repr-Digest header value
+ * @returns Array of digests, or null if malformed
+ *
+ * @example
+ * ```ts
+ * const digests = parseReprDigest('sha-512=:xyz789...:');
+ * ```
+ */
+export function parseReprDigest(value) {
+    return parseDigestField(value);
+}
+/**
+ * Parse digest preference values from a structured field dictionary.
+ * Returns null for malformed input.
+ */
+function parseWantDigestField(value) {
+    const dict = parseSfDict(value);
+    if (!dict) {
+        return null;
+    }
+    const preferences = [];
+    for (const [algorithm, item] of Object.entries(dict)) {
+        // RFC 9530 §4: value is an Integer 0-10
+        if ('items' in item) {
+            // Inner list not valid for preferences
+            continue;
+        }
+        const sfItem = item;
+        if (typeof sfItem.value !== 'number') {
+            // Must be an integer
+            continue;
+        }
+        const weight = sfItem.value;
+        // RFC 9530 §4: must be in range 0 to 10 inclusive
+        if (!Number.isInteger(weight) || weight < 0 || weight > 10) {
+            continue;
+        }
+        preferences.push({
+            algorithm: algorithm.toLowerCase(),
+            weight,
+        });
+    }
+    return preferences.length > 0 ? preferences : [];
+}
+/**
+ * Parse Want-Content-Digest header field value.
+ * RFC 9530 §4.
+ *
+ * @param value - The Want-Content-Digest header value
+ * @returns Array of preferences, or null if malformed
+ *
+ * @example
+ * ```ts
+ * const prefs = parseWantContentDigest('sha-256=10, sha-512=3');
+ * ```
+ */
+export function parseWantContentDigest(value) {
+    return parseWantDigestField(value);
+}
+/**
+ * Parse Want-Repr-Digest header field value.
+ * RFC 9530 §4.
+ *
+ * @param value - The Want-Repr-Digest header value
+ * @returns Array of preferences, or null if malformed
+ *
+ * @example
+ * ```ts
+ * const prefs = parseWantReprDigest('sha-512=3, sha-256=10, unixsum=0');
+ * ```
+ */
+export function parseWantReprDigest(value) {
+    return parseWantDigestField(value);
+}
+// =============================================================================
+// Formatting
+// =============================================================================
+/**
+ * Format digests as a structured field dictionary string.
+ */
+function formatDigestField(digests) {
+    const dict = {};
+    for (const digest of digests) {
+        // RFC 9530 §5: MUST NOT generate deprecated algorithms
+        // But we allow formatting any algorithm the caller provides
+        dict[digest.algorithm] = { value: digest.value };
+    }
+    return serializeSfDict(dict);
+}
+/**
+ * Format Content-Digest header field value.
+ * RFC 9530 §2.
+ *
+ * @param digests - Array of digests to format
+ * @returns Formatted header value
+ *
+ * @example
+ * ```ts
+ * const header = formatContentDigest([
+ *     { algorithm: 'sha-256', value: digestBytes }
+ * ]);
+ * ```
+ */
+export function formatContentDigest(digests) {
+    return formatDigestField(digests);
+}
+/**
+ * Format Repr-Digest header field value.
+ * RFC 9530 §3.
+ *
+ * @param digests - Array of digests to format
+ * @returns Formatted header value
+ *
+ * @example
+ * ```ts
+ * const header = formatReprDigest([
+ *     { algorithm: 'sha-512', value: digestBytes }
+ * ]);
+ * ```
+ */
+export function formatReprDigest(digests) {
+    return formatDigestField(digests);
+}
+/**
+ * Format preferences as a structured field dictionary string.
+ */
+function formatWantDigestField(preferences) {
+    const dict = {};
+    for (const pref of preferences) {
+        // RFC 9530 §4: weight is an Integer 0-10
+        if (pref.weight < 0 || pref.weight > 10 || !Number.isInteger(pref.weight)) {
+            continue;
+        }
+        dict[pref.algorithm] = { value: pref.weight };
+    }
+    return serializeSfDict(dict);
+}
+/**
+ * Format Want-Content-Digest header field value.
+ * RFC 9530 §4.
+ *
+ * @param preferences - Array of preferences to format
+ * @returns Formatted header value
+ *
+ * @example
+ * ```ts
+ * const header = formatWantContentDigest([
+ *     { algorithm: 'sha-256', weight: 10 },
+ *     { algorithm: 'sha-512', weight: 3 }
+ * ]);
+ * ```
+ */
+export function formatWantContentDigest(preferences) {
+    return formatWantDigestField(preferences);
+}
+/**
+ * Format Want-Repr-Digest header field value.
+ * RFC 9530 §4.
+ *
+ * @param preferences - Array of preferences to format
+ * @returns Formatted header value
+ *
+ * @example
+ * ```ts
+ * const header = formatWantReprDigest([
+ *     { algorithm: 'sha-512', weight: 3 },
+ *     { algorithm: 'sha-256', weight: 10 },
+ *     { algorithm: 'unixsum', weight: 0 }
+ * ]);
+ * ```
+ */
+export function formatWantReprDigest(preferences) {
+    return formatWantDigestField(preferences);
+}
+// =============================================================================
+// Generation and Verification
+// =============================================================================
+/**
+ * Map algorithm keys to Web Crypto algorithm names.
+ */
+const CRYPTO_ALGORITHMS = {
+    'sha-256': 'SHA-256',
+    'sha-512': 'SHA-512',
+};
+/**
+ * Generate a digest for the given data.
+ * RFC 9530 §2, §3.
+ *
+ * Uses Web Crypto API for hashing. Only active algorithms are supported
+ * for generation per RFC 9530 §5.
+ *
+ * @param data - Data to hash (string, ArrayBuffer, or ArrayBufferView)
+ * @param algorithm - Hash algorithm (default: 'sha-256')
+ * @returns Promise resolving to digest
+ * @throws Error if algorithm is not supported for generation
+ *
+ * @example
+ * ```ts
+ * const digest = await generateDigest('hello world');
+ * const headers = { 'Content-Digest': formatContentDigest([digest]) };
+ * ```
+ */
+export async function generateDigest(data, algorithm = 'sha-256') {
+    const cryptoAlgorithm = CRYPTO_ALGORITHMS[algorithm];
+    if (!cryptoAlgorithm) {
+        throw new Error(`Unsupported algorithm for generation: ${algorithm}`);
+    }
+    let buffer;
+    if (typeof data === 'string') {
+        buffer = new TextEncoder().encode(data).buffer;
+    }
+    else if (data instanceof ArrayBuffer) {
+        buffer = data;
+    }
+    else {
+        // ArrayBufferView - create a copy to ensure it's an ArrayBuffer
+        const view = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+        buffer = view.slice().buffer;
+    }
+    const hashBuffer = await globalThis.crypto.subtle.digest(cryptoAlgorithm, buffer);
+    return {
+        algorithm,
+        value: new Uint8Array(hashBuffer),
+    };
+}
+/**
+ * Verify a digest against the given data.
+ * RFC 9530 §2, §3.
+ *
+ * Only active algorithms (sha-256, sha-512) can be verified.
+ * Deprecated algorithms will return false.
+ *
+ * @param data - Data to verify
+ * @param digest - Digest to check against
+ * @returns Promise resolving to true if digest matches
+ *
+ * @example
+ * ```ts
+ * const digests = parseContentDigest(headers.get('Content-Digest'));
+ * const sha256 = digests?.find(d => d.algorithm === 'sha-256');
+ * if (sha256 && await verifyDigest(content, sha256)) {
+ *     // Content integrity verified
+ * }
+ * ```
+ */
+export async function verifyDigest(data, digest) {
+    // RFC 9530 §5: deprecated algorithms should not be used for verification
+    // in adversarial settings, but we allow it for backward compatibility
+    if (!isActiveAlgorithm(digest.algorithm)) {
+        // Cannot verify deprecated algorithms
+        return false;
+    }
+    const computed = await generateDigest(data, digest.algorithm);
+    // Compare byte arrays
+    if (computed.value.length !== digest.value.length) {
+        return false;
+    }
+    for (let i = 0; i < computed.value.length; i++) {
+        if (computed.value[i] !== digest.value[i]) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=digest.js.map

package/dist/digest.js.map

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

package/dist/encoding.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Accept-Encoding utilities per RFC 9110.
+ * RFC 9110 §12.4.2, §12.4.3, §12.5.3.
+ */
+import type { EncodingRange } from './types.js';
+/**
+ * Parse an Accept-Encoding header into ranges.
+ */
+export declare function parseAcceptEncoding(header: string): EncodingRange[];
+/**
+ * Negotiate encoding based on Accept-Encoding.
+ */
+export declare function negotiateEncoding(ranges: EncodingRange[], supported: string[]): string | null;
+//# sourceMappingURL=encoding.d.ts.map

package/dist/encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../src/encoding.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD;;GAEG;AAEH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,CAsCnE;AAWD;;GAEG;AAEH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAiC7F"}

package/dist/encoding.js

@@ -0,0 +1,86 @@
+/**
+ * Accept-Encoding utilities per RFC 9110.
+ * RFC 9110 §12.4.2, §12.4.3, §12.5.3.
+ */
+import { isEmptyHeader, splitListValue, parseQValue } from './header-utils.js';
+/**
+ * Parse an Accept-Encoding header into ranges.
+ */
+// RFC 9110 §12.5.3: Accept-Encoding field-value parsing.
+export function parseAcceptEncoding(header) {
+    if (isEmptyHeader(header)) {
+        return [];
+    }
+    const ranges = [];
+    const parts = splitListValue(header);
+    for (const part of parts) {
+        const segments = part.split(';').map(segment => segment.trim());
+        const encoding = segments[0]?.toLowerCase();
+        if (!encoding)
+            continue;
+        let q = 1.0;
+        let invalidQ = false;
+        for (let i = 1; i < segments.length; i++) {
+            const segment = segments[i];
+            const eqIndex = segment.indexOf('=');
+            if (eqIndex === -1)
+                continue;
+            const key = segment.slice(0, eqIndex).trim().toLowerCase();
+            if (key !== 'q')
+                continue;
+            const parsed = parseQValue(segment.slice(eqIndex + 1).trim());
+            if (parsed === null) {
+                invalidQ = true;
+                break;
+            }
+            q = parsed;
+        }
+        if (invalidQ) {
+            continue;
+        }
+        ranges.push({ encoding, q });
+    }
+    ranges.sort((a, b) => b.q - a.q);
+    return ranges;
+}
+function getQForEncoding(ranges, encoding) {
+    for (const range of ranges) {
+        if (range.encoding === encoding) {
+            return range.q;
+        }
+    }
+    return null;
+}
+/**
+ * Negotiate encoding based on Accept-Encoding.
+ */
+// RFC 9110 §12.4.2, §12.4.3, §12.5.3: Content-coding selection.
+export function negotiateEncoding(ranges, supported) {
+    if (supported.length === 0) {
+        return null;
+    }
+    if (ranges.length === 0) {
+        return supported[0] ?? null;
+    }
+    const wildcard = ranges.find(range => range.encoding === '*');
+    let best = null;
+    let bestQ = 0;
+    for (const encoding of supported) {
+        const normalized = encoding.toLowerCase();
+        const explicitQ = getQForEncoding(ranges, normalized);
+        const q = explicitQ !== null
+            ? explicitQ
+            : (normalized === 'identity'
+                ? (wildcard ? wildcard.q : 1.0)
+                : (wildcard ? wildcard.q : 0));
+        if (q > bestQ) {
+            best = encoding;
+            bestQ = q;
+        }
+    }
+    if (bestQ === 0) {
+        return null;
+    }
+    return best;
+}
+//# sourceMappingURL=encoding.js.map

package/dist/encoding.js.map

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

package/dist/etag.d.ts

@@ -0,0 +1,55 @@
+/**
+ * ETag utilities per RFC 9110.
+ * RFC 9110 §8.8.3, §8.8.3.2.
+ * @see https://httpwg.org/specs/rfc9110.html#field.etag
+ */
+import type { ETag } from './types.js';
+export type { ETag } from './types.js';
+/**
+ * Generate a simple ETag from data (sync, using string hash)
+ * Uses a simple hash algorithm suitable for most use cases.
+ * Returns format: "hash" (strong) or W/"hash" (if weak option specified)
+ */
+export declare function generateETag(data: unknown, options?: {
+    weak?: boolean;
+}): string;
+/**
+ * Generate an ETag using Web Crypto API (async, more secure)
+ * Uses SHA-256 by default.
+ */
+export declare function generateETagAsync(data: unknown, options?: {
+    algorithm?: 'SHA-1' | 'SHA-256' | 'SHA-384' | 'SHA-512';
+    weak?: boolean;
+}): Promise<string>;
+/**
+ * Parse an ETag string into its components
+ * Handles: "abc", W/"abc", ""
+ * Returns null for invalid format
+ */
+export declare function parseETag(etag: string): ETag | null;
+/**
+ * Format an ETag object back to string
+ */
+export declare function formatETag(etag: ETag): string;
+/**
+ * Compare two ETags per RFC 9110 §8.8.3.
+ *
+ * Strong comparison: both must be strong AND values match
+ * Weak comparison: values match (regardless of weak/strong)
+ *
+ * RFC 9110 §8.8.3.2 comparison table:
+ * | ETag 1  | ETag 2  | Strong | Weak  |
+ * |---------|---------|--------|-------|
+ * | W/"1"   | W/"1"   | false  | true  |
+ * | W/"1"   | "1"     | false  | true  |
+ * | "1"     | "1"     | true   | true  |
+ * | "1"     | W/"1"   | false  | true  |
+ * | W/"1"   | W/"2"   | false  | false |
+ * | "1"     | "2"     | false  | false |
+ */
+export declare function compareETags(a: ETag, b: ETag, strong?: boolean): boolean;
+/**
+ * Convenience function to compare ETag strings directly
+ */
+export declare function compareETagStrings(a: string, b: string, strong?: boolean): boolean;
+//# sourceMappingURL=etag.d.ts.map

package/dist/etag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"etag.d.ts","sourceRoot":"","sources":["../src/etag.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,YAAY,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAoEvC;;;;GAIG;AAEH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAKhF;AAED;;;GAGG;AAEH,wBAAsB,iBAAiB,CACnC,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GACtF,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED;;;;GAIG;AAEH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAmCnD;AAED;;GAEG;AAEH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAE,OAAe,GAAG,OAAO,CAa/E;AAED;;GAEG;AAEH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,OAAe,GAAG,OAAO,CASzF"}