@irvinebroque/http-rfc-utils 0.1.0

package/dist/cors.js

@@ -0,0 +1,170 @@
+/**
+ * CORS helpers aligned with Fetch/CORS specs.
+ */
+/**
+ * Default CORS headers for permissive API access.
+ * Used when no specific options are provided.
+ */
+export const defaultCorsHeaders = {
+    'Access-Control-Allow-Origin': '*',
+    'Access-Control-Allow-Methods': 'GET, HEAD, OPTIONS',
+    'Access-Control-Allow-Headers': 'Content-Type, Accept, If-None-Match, If-Modified-Since',
+    'Access-Control-Expose-Headers': 'ETag, Last-Modified, Link, X-Total-Count',
+    'Access-Control-Max-Age': '86400',
+};
+/**
+ * Validate CORS options and throw if invalid.
+ * Called internally by buildCorsHeaders.
+ */
+function validateCorsOptions(options) {
+    if (options.credentials && (options.origin === '*' || options.origin === undefined)) {
+        throw new Error('CORS error: Cannot use wildcard or undefined origin with credentials. ' +
+            'Specify explicit origin(s) when credentials is true.');
+    }
+}
+function validateSingleOrigin(options) {
+    if (Array.isArray(options.origin)) {
+        throw new Error('CORS error: Multiple origins are not valid in Access-Control-Allow-Origin. ' +
+            'Use buildCorsHeadersForOrigin(requestOrigin, options) with an allowlist.');
+    }
+}
+/**
+ * Build CORS headers from options.
+ *
+ * @param options - CORS configuration
+ * @returns Headers object
+ *
+ * Behavior:
+ * - origin: '*' | string - sets Access-Control-Allow-Origin
+ *   - For multiple origins, use buildCorsHeadersForOrigin(requestOrigin, options)
+ * - methods: string[] - sets Access-Control-Allow-Methods
+ * - allowHeaders: string[] - sets Access-Control-Allow-Headers
+ * - exposeHeaders: string[] - sets Access-Control-Expose-Headers
+ * - credentials: boolean - if true, sets Access-Control-Allow-Credentials: true
+ *   - WARNING: Cannot use '*' for origin when credentials is true
+ * - maxAge: number - sets Access-Control-Max-Age in seconds
+ */
+export function buildCorsHeaders(options) {
+    if (!options) {
+        return { ...defaultCorsHeaders };
+    }
+    validateCorsOptions(options);
+    validateSingleOrigin(options);
+    const headers = {};
+    // Handle origin
+    if (options.origin !== undefined) {
+        headers['Access-Control-Allow-Origin'] = options.origin;
+    }
+    else {
+        headers['Access-Control-Allow-Origin'] = '*';
+    }
+    // Handle methods
+    if (options.methods !== undefined) {
+        headers['Access-Control-Allow-Methods'] = options.methods.join(', ');
+    }
+    else {
+        headers['Access-Control-Allow-Methods'] = 'GET, HEAD, OPTIONS';
+    }
+    // Handle allowHeaders
+    if (options.allowHeaders !== undefined) {
+        headers['Access-Control-Allow-Headers'] = options.allowHeaders.join(', ');
+    }
+    else {
+        headers['Access-Control-Allow-Headers'] = 'Content-Type, Accept, If-None-Match, If-Modified-Since';
+    }
+    // Handle exposeHeaders
+    if (options.exposeHeaders !== undefined) {
+        headers['Access-Control-Expose-Headers'] = options.exposeHeaders.join(', ');
+    }
+    else {
+        headers['Access-Control-Expose-Headers'] = 'ETag, Last-Modified, Link, X-Total-Count';
+    }
+    // Handle credentials
+    if (options.credentials) {
+        headers['Access-Control-Allow-Credentials'] = 'true';
+    }
+    // Handle maxAge
+    if (options.maxAge !== undefined) {
+        headers['Access-Control-Max-Age'] = String(options.maxAge);
+    }
+    else {
+        headers['Access-Control-Max-Age'] = '86400';
+    }
+    return headers;
+}
+/**
+ * Build CORS headers for a preflight response (OPTIONS request).
+ * Same as buildCorsHeaders but always includes max-age.
+ */
+export function buildPreflightHeaders(options) {
+    const headers = buildCorsHeaders(options);
+    // Ensure max-age is always present for preflight
+    if (!headers['Access-Control-Max-Age']) {
+        headers['Access-Control-Max-Age'] = '86400';
+    }
+    return headers;
+}
+/**
+ * Build CORS headers for a specific request origin.
+ *
+ * Use this when you support multiple origins. It echoes the request origin
+ * and adds Vary: Origin for correct caching behavior.
+ */
+export function buildCorsHeadersForOrigin(requestOrigin, options) {
+    if (!options) {
+        return { ...defaultCorsHeaders };
+    }
+    validateCorsOptions(options);
+    if (options.origin === undefined || options.origin === '*') {
+        return buildCorsHeaders(options);
+    }
+    if (!requestOrigin) {
+        return {};
+    }
+    if (!isOriginAllowed(requestOrigin, options)) {
+        return {};
+    }
+    const headers = buildCorsHeaders({
+        ...options,
+        origin: requestOrigin,
+    });
+    if (headers['Vary']) {
+        const existing = headers['Vary']
+            .split(',')
+            .map(value => value.trim())
+            .filter(Boolean);
+        if (!existing.includes('Origin')) {
+            existing.push('Origin');
+        }
+        headers['Vary'] = existing.join(', ');
+    }
+    else {
+        headers['Vary'] = 'Origin';
+    }
+    return headers;
+}
+/**
+ * Check if an origin is allowed based on CorsOptions.
+ * Useful for dynamic origin validation.
+ *
+ * @param requestOrigin - The Origin header from the request
+ * @param options - CORS configuration
+ * @returns true if origin is allowed
+ */
+export function isOriginAllowed(requestOrigin, options) {
+    if (!options || options.origin === undefined || options.origin === '*') {
+        return true;
+    }
+    if (Array.isArray(options.origin)) {
+        return options.origin.includes(requestOrigin);
+    }
+    return options.origin === requestOrigin;
+}
+/**
+ * Legacy alias for backward compatibility.
+ * Returns defaultCorsHeaders.
+ */
+export function corsHeaders() {
+    return { ...defaultCorsHeaders };
+}
+//# sourceMappingURL=cors.js.map

package/dist/cors.js.map

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

package/dist/datetime.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Date/time utilities for HTTP headers.
+ * RFC 3339 §5.6, RFC 9110 §5.6.7, RFC 850 §2.
+ */
+/**
+ * Format a Date as RFC 3339 timestamp (ISO 8601 compatible)
+ * Example output: "2025-02-01T12:30:45.123Z"
+ *
+ * This is the format used in JSON responses.
+ */
+export declare function toRFC3339(date: Date): string;
+/**
+ * Parse an RFC 3339 timestamp string to Date
+ * Returns null for invalid format
+ *
+ * Accepts:
+ * - "2025-02-01T12:30:45Z"
+ * - "2025-02-01T12:30:45.123Z"
+ * - "2025-02-01T12:30:45+00:00"
+ * - "2025-02-01T12:30:45.123+05:30"
+ * - "2025-02-01t12:30:45z" (lowercase per §5.6 NOTE)
+ * - "2025-02-01 12:30:45Z" (space separator per §5.6 NOTE)
+ */
+export declare function parseRFC3339(str: string): Date | null;
+/**
+ * Format a Date as HTTP-date per RFC 9110 Section 5.6.7
+ * Used for Last-Modified, Date, Expires headers.
+ *
+ * Format: "Sat, 01 Feb 2025 12:30:45 GMT"
+ * (IMF-fixdate format - the preferred format)
+ */
+export declare function formatHTTPDate(date: Date): string;
+/**
+ * Parse an HTTP-date string to Date
+ *
+ * RFC 9110 Section 5.6.7 requires parsing these formats:
+ * 1. IMF-fixdate: "Sun, 06 Nov 1994 08:49:37 GMT" (preferred)
+ * 2. RFC 850: "Sunday, 06-Nov-94 08:49:37 GMT" (obsolete)
+ * 3. ANSI C asctime(): "Sun Nov  6 08:49:37 1994" (obsolete)
+ *
+ * Returns null for invalid format.
+ */
+export declare function parseHTTPDate(str: string): Date | null;
+/**
+ * Check if a date is in the past (for cache expiration checks)
+ */
+export declare function isExpired(date: Date): boolean;
+/**
+ * Calculate seconds until a date (for max-age calculations)
+ * Returns 0 if date is in the past
+ */
+export declare function secondsUntil(date: Date): number;
+//# sourceMappingURL=datetime.d.ts.map

package/dist/datetime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../src/datetime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;;GAKG;AAEH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE5C;AAED;;;;;;;;;;;GAWG;AAIH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAiErD;AAoED;;;;;;GAMG;AAEH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEjD;AAED;;;;;;;;;GASG;AAEH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CA2DtD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE7C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAG/C"}

package/dist/datetime.js

@@ -0,0 +1,205 @@
+/**
+ * Date/time utilities for HTTP headers.
+ * RFC 3339 §5.6, RFC 9110 §5.6.7, RFC 850 §2.
+ */
+const DAY_NAMES = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+const MONTH_NAMES = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+/**
+ * Format a Date as RFC 3339 timestamp (ISO 8601 compatible)
+ * Example output: "2025-02-01T12:30:45.123Z"
+ *
+ * This is the format used in JSON responses.
+ */
+// RFC 3339 §5.6: Internet Date/Time Format.
+export function toRFC3339(date) {
+    return date.toISOString();
+}
+/**
+ * Parse an RFC 3339 timestamp string to Date
+ * Returns null for invalid format
+ *
+ * Accepts:
+ * - "2025-02-01T12:30:45Z"
+ * - "2025-02-01T12:30:45.123Z"
+ * - "2025-02-01T12:30:45+00:00"
+ * - "2025-02-01T12:30:45.123+05:30"
+ * - "2025-02-01t12:30:45z" (lowercase per §5.6 NOTE)
+ * - "2025-02-01 12:30:45Z" (space separator per §5.6 NOTE)
+ */
+// RFC 3339 §5.6: Internet Date/Time Format parsing.
+// RFC 3339 §5.6 NOTE: "T" and "Z" may alternatively be lowercase "t" or "z".
+// RFC 3339 §5.6 NOTE: Applications may use space instead of "T" separator.
+export function parseRFC3339(str) {
+    const rfc3339Regex = /^(\d{4})-(\d{2})-(\d{2})[Tt ](\d{2}):(\d{2}):(\d{2})(?:\.(\d+))?(?:[Zz]|([+-])(\d{2}):(\d{2}))$/;
+    const match = str.match(rfc3339Regex);
+    if (!match) {
+        return null;
+    }
+    const year = Number(match[1]);
+    const month = Number(match[2]);
+    const day = Number(match[3]);
+    const hours = Number(match[4]);
+    const minutes = Number(match[5]);
+    const seconds = Number(match[6]);
+    const fraction = match[7];
+    const offsetSign = match[8];
+    const offsetHour = match[9];
+    const offsetMinute = match[10];
+    if (!isValidDateParts(year, month, day)) {
+        return null;
+    }
+    if (hours < 0 || hours > 23) {
+        return null;
+    }
+    if (minutes < 0 || minutes > 59) {
+        return null;
+    }
+    if (seconds < 0 || seconds > 59) {
+        return null;
+    }
+    let offsetTotalMinutes = 0;
+    if (offsetSign) {
+        const parsedOffsetHour = Number(offsetHour);
+        const parsedOffsetMinute = Number(offsetMinute);
+        if (parsedOffsetHour < 0 || parsedOffsetHour > 23) {
+            return null;
+        }
+        if (parsedOffsetMinute < 0 || parsedOffsetMinute > 59) {
+            return null;
+        }
+        offsetTotalMinutes = parsedOffsetHour * 60 + parsedOffsetMinute;
+        if (offsetSign === '-') {
+            offsetTotalMinutes *= -1;
+        }
+    }
+    const milliseconds = parseFractionalMilliseconds(fraction);
+    if (milliseconds === null) {
+        return null;
+    }
+    const utcMillis = Date.UTC(year, month - 1, day, hours, minutes, seconds, milliseconds);
+    if (isNaN(utcMillis)) {
+        return null;
+    }
+    return new Date(utcMillis - offsetTotalMinutes * 60000);
+}
+function isValidDateParts(year, month, day) {
+    if (year < 0 || year > 9999) {
+        return false;
+    }
+    if (month < 1 || month > 12) {
+        return false;
+    }
+    const daysInMonth = getDaysInMonth(year, month);
+    return day >= 1 && day <= daysInMonth;
+}
+function getDaysInMonth(year, month) {
+    switch (month) {
+        case 2:
+            return isLeapYear(year) ? 29 : 28;
+        case 4:
+        case 6:
+        case 9:
+        case 11:
+            return 30;
+        default:
+            return 31;
+    }
+}
+function isLeapYear(year) {
+    if (year % 4 !== 0) {
+        return false;
+    }
+    if (year % 100 !== 0) {
+        return true;
+    }
+    return year % 400 === 0;
+}
+function parseFractionalMilliseconds(fraction) {
+    if (!fraction) {
+        return 0;
+    }
+    if (!/^\d+$/.test(fraction)) {
+        return null;
+    }
+    const padded = fraction.length >= 3
+        ? fraction.slice(0, 3)
+        : fraction.padEnd(3, '0');
+    return Number(padded);
+}
+// RFC 850 §2: Two-digit year handling.
+function resolveRFC850Year(twoDigitYear, now = new Date()) {
+    const currentYear = now.getUTCFullYear();
+    const currentCentury = Math.floor(currentYear / 100) * 100;
+    let year = currentCentury + twoDigitYear;
+    if (year > currentYear + 50) {
+        year -= 100;
+    }
+    return year;
+}
+/**
+ * Format a Date as HTTP-date per RFC 9110 Section 5.6.7
+ * Used for Last-Modified, Date, Expires headers.
+ *
+ * Format: "Sat, 01 Feb 2025 12:30:45 GMT"
+ * (IMF-fixdate format - the preferred format)
+ */
+// RFC 9110 §5.6.7: IMF-fixdate formatting.
+export function formatHTTPDate(date) {
+    return date.toUTCString();
+}
+/**
+ * Parse an HTTP-date string to Date
+ *
+ * RFC 9110 Section 5.6.7 requires parsing these formats:
+ * 1. IMF-fixdate: "Sun, 06 Nov 1994 08:49:37 GMT" (preferred)
+ * 2. RFC 850: "Sunday, 06-Nov-94 08:49:37 GMT" (obsolete)
+ * 3. ANSI C asctime(): "Sun Nov  6 08:49:37 1994" (obsolete)
+ *
+ * Returns null for invalid format.
+ */
+// RFC 9110 §5.6.7, RFC 850 §2: HTTP-date parsing (including rfc850-date).
+export function parseHTTPDate(str) {
+    // Try IMF-fixdate: "Sun, 06 Nov 1994 08:49:37 GMT"
+    const imfMatch = str.match(/^(?:Mon|Tue|Wed|Thu|Fri|Sat|Sun), (\d{2}) (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) (\d{4}) (\d{2}):(\d{2}):(\d{2}) GMT$/);
+    if (imfMatch) {
+        const [, day, month, year, hours, minutes, seconds] = imfMatch;
+        const monthIndex = MONTH_NAMES.indexOf(month);
+        const date = new Date(Date.UTC(parseInt(year, 10), monthIndex, parseInt(day, 10), parseInt(hours, 10), parseInt(minutes, 10), parseInt(seconds, 10)));
+        return isNaN(date.getTime()) ? null : date;
+    }
+    // Try RFC 850: "Sunday, 06-Nov-94 08:49:37 GMT"
+    const rfc850Match = str.match(/^(?:Monday|Tuesday|Wednesday|Thursday|Friday|Saturday|Sunday), (\d{2})-(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)-(\d{2}) (\d{2}):(\d{2}):(\d{2}) GMT$/);
+    if (rfc850Match) {
+        const [, day, month, year2digit, hours, minutes, seconds] = rfc850Match;
+        const monthIndex = MONTH_NAMES.indexOf(month);
+        // RFC 850 uses 2-digit years; interpret with sliding 50-year window.
+        const year = resolveRFC850Year(parseInt(year2digit, 10));
+        const date = new Date(Date.UTC(year, monthIndex, parseInt(day, 10), parseInt(hours, 10), parseInt(minutes, 10), parseInt(seconds, 10)));
+        return isNaN(date.getTime()) ? null : date;
+    }
+    // Try ANSI C asctime(): "Sun Nov  6 08:49:37 1994"
+    // Note: day can be space-padded (single digit has leading space)
+    const asctimeMatch = str.match(/^(?:Mon|Tue|Wed|Thu|Fri|Sat|Sun) (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) ([ \d]\d) (\d{2}):(\d{2}):(\d{2}) (\d{4})$/);
+    if (asctimeMatch) {
+        const [, month, day, hours, minutes, seconds, year] = asctimeMatch;
+        const monthIndex = MONTH_NAMES.indexOf(month);
+        const date = new Date(Date.UTC(parseInt(year, 10), monthIndex, parseInt(day, 10), parseInt(hours, 10), parseInt(minutes, 10), parseInt(seconds, 10)));
+        return isNaN(date.getTime()) ? null : date;
+    }
+    return null;
+}
+/**
+ * Check if a date is in the past (for cache expiration checks)
+ */
+export function isExpired(date) {
+    return date.getTime() < Date.now();
+}
+/**
+ * Calculate seconds until a date (for max-age calculations)
+ * Returns 0 if date is in the past
+ */
+export function secondsUntil(date) {
+    const diff = date.getTime() - Date.now();
+    return diff > 0 ? Math.floor(diff / 1000) : 0;
+}
+//# sourceMappingURL=datetime.js.map

package/dist/datetime.js.map

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

package/dist/digest.d.ts

@@ -0,0 +1,220 @@
+/**
+ * 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.
+ */
+/**
+ * Active digest algorithms suitable for adversarial settings.
+ * RFC 9530 §5, §7.2.
+ */
+export type DigestAlgorithm = 'sha-256' | 'sha-512';
+/**
+ * All recognized algorithms including deprecated ones.
+ * RFC 9530 §5, §7.2.
+ * Deprecated algorithms MAY be used for backward compatibility but
+ * MUST NOT be used in adversarial settings.
+ */
+export type DigestAlgorithmAny = DigestAlgorithm | 'md5' | 'sha' | 'unixsum' | 'unixcksum' | 'adler' | 'crc32c';
+/**
+ * A parsed digest value from Content-Digest or Repr-Digest fields.
+ * RFC 9530 §2, §3.
+ */
+export interface Digest {
+    /** Algorithm key (lowercase) */
+    algorithm: string;
+    /** Raw digest bytes */
+    value: Uint8Array;
+}
+/**
+ * A digest preference from Want-Content-Digest or Want-Repr-Digest fields.
+ * RFC 9530 §4.
+ */
+export interface DigestPreference {
+    /** Algorithm key (lowercase) */
+    algorithm: string;
+    /**
+     * Preference weight (0-10).
+     * 0 = not acceptable, 1 = least preferred, 10 = most preferred.
+     */
+    weight: number;
+}
+/**
+ * Algorithm classification constants.
+ * RFC 9530 §5, §7.2.
+ */
+export declare const DIGEST_ALGORITHMS: {
+    /** Algorithms suitable for adversarial settings */
+    readonly active: readonly ["sha-256", "sha-512"];
+    /** Algorithms that MUST NOT be used in adversarial settings */
+    readonly deprecated: readonly ["md5", "sha", "unixsum", "unixcksum", "adler", "crc32c"];
+};
+/**
+ * Check if an algorithm is active (suitable for adversarial settings).
+ * RFC 9530 §5.
+ */
+export declare function isActiveAlgorithm(algorithm: string): algorithm is DigestAlgorithm;
+/**
+ * Check if an algorithm is deprecated.
+ * RFC 9530 §5.
+ */
+export declare function isDeprecatedAlgorithm(algorithm: string): boolean;
+/**
+ * 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 declare function parseContentDigest(value: string): Digest[] | null;
+/**
+ * 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 declare function parseReprDigest(value: string): Digest[] | null;
+/**
+ * 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 declare function parseWantContentDigest(value: string): DigestPreference[] | null;
+/**
+ * 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 declare function parseWantReprDigest(value: string): DigestPreference[] | null;
+/**
+ * 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 declare function formatContentDigest(digests: Digest[]): string;
+/**
+ * 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 declare function formatReprDigest(digests: Digest[]): string;
+/**
+ * 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 declare function formatWantContentDigest(preferences: DigestPreference[]): string;
+/**
+ * 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 declare function formatWantReprDigest(preferences: DigestPreference[]): string;
+/**
+ * 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 declare function generateDigest(data: string | ArrayBuffer | ArrayBufferView, algorithm?: DigestAlgorithm): Promise<Digest>;
+/**
+ * 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 declare function verifyDigest(data: string | ArrayBuffer | ArrayBufferView, digest: Digest): Promise<boolean>;
+//# sourceMappingURL=digest.d.ts.map

package/dist/digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest.d.ts","sourceRoot":"","sources":["../src/digest.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GACxB,eAAe,GACf,KAAK,GACL,KAAK,GACL,SAAS,GACT,WAAW,GACX,OAAO,GACP,QAAQ,CAAC;AAEf;;;GAGG;AACH,MAAM,WAAW,MAAM;IACnB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,KAAK,EAAE,UAAU,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAClB;AAMD;;;GAGG;AACH,eAAO,MAAM,iBAAiB;IAC1B,mDAAmD;;IAEnD,+DAA+D;;CAEzD,CAAC;AAMX;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,IAAI,eAAe,CAEjF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEhE;AAwCD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAEjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAE9D;AA0CD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,EAAE,GAAG,IAAI,CAE/E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,EAAE,GAAG,IAAI,CAE5E;AAqBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAE7D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAE1D;AAmBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAE/E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAE5E;AAcD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,cAAc,CAChC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,eAAe,EAC5C,SAAS,GAAE,eAA2B,GACvC,OAAO,CAAC,MAAM,CAAC,CAwBjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,YAAY,CAC9B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,eAAe,EAC5C,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CAsBlB"}