@irvinebroque/http-rfc-utils 0.1.0

package/dist/negotiate.js

@@ -0,0 +1,357 @@
+/**
+ * Content negotiation utilities per RFC 7231.
+ * RFC 7231 §5.3.1, §5.3.2.
+ */
+import { isEmptyHeader, splitQuotedValue, unquote, parseQValue } from './header-utils.js';
+/**
+ * Media type constants mapping format names to MIME types.
+ */
+export const MEDIA_TYPES = {
+    json: 'application/json',
+    csv: 'text/csv',
+    html: 'text/html',
+    text: 'text/plain',
+    xml: 'application/xml',
+};
+/**
+ * Reverse mapping from MIME type to format name.
+ */
+export const MIME_TO_FORMAT = Object.fromEntries(Object.entries(MEDIA_TYPES).map(([format, mime]) => [mime, format]));
+/**
+ * Parse an Accept header into a list of entries sorted by preference.
+ *
+ * RFC 7231 Section 5.3.2 defines Accept header format.
+ *
+ * @param header - The Accept header value
+ * @returns Sorted array of AcceptEntry (highest preference first)
+ *
+ * Sorting rules:
+ * 1. Higher q value first
+ * 2. More specific type beats wildcard (text/html > text/star > star/star)
+ * 3. More parameters beats fewer
+ *
+ * Invalid q-values are rejected and the entry is skipped.
+ *
+ * @example
+ * parseAccept("text/html, application/json;q=0.9, text/star;q=0.8")
+ * // Returns: [text/html q=1], [application/json q=0.9], [text/star q=0.8]
+ */
+// RFC 7231 §5.3.2: Accept header parsing and sorting.
+export function parseAccept(header) {
+    if (isEmptyHeader(header)) {
+        return [];
+    }
+    const entries = [];
+    const parts = splitQuotedValue(header, ',');
+    for (const part of parts) {
+        const trimmed = part.trim();
+        if (!trimmed)
+            continue;
+        const entry = parseMediaRange(trimmed);
+        if (entry) {
+            entries.push(entry);
+        }
+    }
+    // Sort by preference
+    entries.sort((a, b) => {
+        // 1. Higher q value first
+        if (a.q !== b.q) {
+            return b.q - a.q;
+        }
+        // 2. More specific type beats wildcard
+        const specA = getSpecificity(a);
+        const specB = getSpecificity(b);
+        if (specA !== specB) {
+            return specB - specA;
+        }
+        // 3. More parameters beats fewer
+        return b.params.size - a.params.size;
+    });
+    return entries;
+}
+/**
+ * Parse a single media range with optional parameters.
+ */
+function parseMediaRange(range) {
+    const parts = splitQuotedValue(range, ';').map(p => p.trim());
+    const mediaType = parts[0];
+    if (!mediaType || !mediaType.includes('/')) {
+        return null;
+    }
+    const [type, subtype] = mediaType.split('/');
+    if (!type || !subtype) {
+        return null;
+    }
+    let q = 1.0;
+    const params = new Map();
+    let seenQ = false;
+    for (let i = 1; i < parts.length; i++) {
+        const param = parts[i];
+        if (!param)
+            continue;
+        const eqIndex = param.indexOf('=');
+        if (eqIndex === -1)
+            continue;
+        const key = param.slice(0, eqIndex).trim().toLowerCase();
+        const value = unquote(param.slice(eqIndex + 1).trim());
+        if (key === 'q') {
+            const parsed = parseQValue(value);
+            if (parsed === null) {
+                return null;
+            }
+            q = parsed;
+            seenQ = true;
+        }
+        else {
+            if (!seenQ) {
+                params.set(key, value);
+            }
+        }
+    }
+    return {
+        type: type.toLowerCase(),
+        subtype: subtype.toLowerCase(),
+        q,
+        params,
+    };
+}
+/**
+ * Get specificity score for sorting.
+ * - exact match with params: 4
+ * - exact match no params: 3
+ * - type wildcard (text/star): 2
+ * - full wildcard (star/star): 1
+ */
+function getSpecificity(entry) {
+    if (entry.type === '*' && entry.subtype === '*') {
+        return 1;
+    }
+    if (entry.subtype === '*') {
+        return 2;
+    }
+    // Exact match
+    return entry.params.size > 0 ? 4 : 3;
+}
+/**
+ * Check if an Accept entry matches a media type.
+ * Returns specificity score if match, 0 if no match.
+ */
+function matchesMediaType(entry, mediaType) {
+    const mimeType = MEDIA_TYPES[mediaType];
+    return matchesMimeType(entry, mimeType);
+}
+/**
+ * Check if an Accept entry matches a MIME type string.
+ * Returns specificity score if match, 0 if no match.
+ */
+function matchesMimeType(entry, mimeType) {
+    const parsed = parseMimeTypeWithParams(mimeType);
+    if (!parsed) {
+        return 0;
+    }
+    const { type, subtype, params } = parsed;
+    if (!paramsMatch(entry.params, params)) {
+        return 0;
+    }
+    if (!type || !subtype) {
+        return 0;
+    }
+    // Full wildcard matches anything
+    if (entry.type === '*' && entry.subtype === '*') {
+        return 1;
+    }
+    // Type must match for type wildcard
+    if (entry.type === type && entry.subtype === '*') {
+        return 2;
+    }
+    // Exact match
+    if (entry.type === type && entry.subtype === subtype) {
+        return entry.params.size > 0 ? 4 : 3;
+    }
+    return 0;
+}
+function parseMimeTypeWithParams(mimeType) {
+    const parts = splitQuotedValue(mimeType, ';').map(p => p.trim());
+    const mediaType = parts[0];
+    if (!mediaType || !mediaType.includes('/')) {
+        return null;
+    }
+    const [type, subtype] = mediaType.split('/');
+    if (!type || !subtype) {
+        return null;
+    }
+    const params = new Map();
+    for (let i = 1; i < parts.length; i++) {
+        const param = parts[i];
+        if (!param)
+            continue;
+        const eqIndex = param.indexOf('=');
+        if (eqIndex === -1)
+            continue;
+        const key = param.slice(0, eqIndex).trim().toLowerCase();
+        const value = unquote(param.slice(eqIndex + 1).trim());
+        if (key) {
+            params.set(key, value);
+        }
+    }
+    return {
+        type: type.toLowerCase(),
+        subtype: subtype.toLowerCase(),
+        params,
+    };
+}
+function paramsMatch(required, candidate) {
+    if (required.size === 0) {
+        return true;
+    }
+    for (const [key, value] of required.entries()) {
+        if (!candidate.has(key)) {
+            return false;
+        }
+        if (candidate.get(key) !== value) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Negotiate the best media type from supported options.
+ *
+ * @param input - The Request object, Accept header string, or null/undefined
+ * @param supported - Array of supported media types (MIME strings like 'application/json')
+ * @returns Best matching media type or null if none acceptable
+ *
+ * Matching rules:
+ * - Exact match: "application/json" matches 'application/json'
+ * - Type wildcard: "text/\*" matches 'text/html', 'text/csv'
+ * - Full wildcard: "\*\/\*" matches anything
+ * - q=0 means explicitly not acceptable
+ */
+// RFC 7231 §5.3.2: Media type selection based on Accept.
+export function negotiate(input, supported) {
+    if (supported.length === 0) {
+        return null;
+    }
+    let acceptHeader;
+    if (input instanceof Request) {
+        acceptHeader = input.headers.get('Accept');
+    }
+    else {
+        acceptHeader = input ?? null;
+    }
+    // Empty or missing Accept header means accept anything
+    if (!acceptHeader || !acceptHeader.trim()) {
+        return supported[0] ?? null;
+    }
+    const entries = parseAccept(acceptHeader);
+    // No valid entries means accept anything
+    if (entries.length === 0) {
+        return supported[0] ?? null;
+    }
+    // Find best match
+    let bestMatch = null;
+    let bestScore = 0;
+    let bestQ = 0;
+    for (const entry of entries) {
+        // Skip explicitly not acceptable
+        if (entry.q === 0) {
+            continue;
+        }
+        for (const mimeType of supported) {
+            const score = matchesMimeType(entry, mimeType);
+            if (score > 0) {
+                // Prefer higher q, then higher specificity
+                if (entry.q > bestQ || (entry.q === bestQ && score > bestScore)) {
+                    bestMatch = mimeType;
+                    bestScore = score;
+                    bestQ = entry.q;
+                }
+            }
+        }
+    }
+    return bestMatch;
+}
+/**
+ * Get response format from request or Accept header string.
+ * Only distinguishes between 'json' and 'csv'.
+ * Defaults to 'json' if no preference or Accept missing.
+ *
+ * @param input - The Request object or Accept header string
+ * @returns 'json', 'csv', or null when neither is acceptable
+ */
+// RFC 7231 §5.3.2: Response format selection from Accept.
+export function getResponseFormat(input) {
+    let acceptHeader;
+    if (input instanceof Request) {
+        acceptHeader = input.headers.get('Accept');
+    }
+    else {
+        acceptHeader = input ?? null;
+    }
+    if (!acceptHeader) {
+        return 'json';
+    }
+    if (!acceptHeader.trim()) {
+        return 'json';
+    }
+    const entries = parseAccept(acceptHeader);
+    if (entries.length === 0) {
+        return 'json';
+    }
+    const best = negotiate(acceptHeader, ['application/json', 'text/csv']);
+    if (!best) {
+        return null;
+    }
+    return best === 'text/csv' ? 'csv' : 'json';
+}
+/**
+ * Escape a value for CSV output.
+ */
+function escapeCSVValue(value) {
+    if (value === null || value === undefined) {
+        return '';
+    }
+    let str;
+    if (typeof value === 'object') {
+        str = JSON.stringify(value);
+    }
+    else {
+        str = String(value);
+    }
+    // Check if quoting is needed
+    if (str.includes(',') || str.includes('"') || str.includes('\n') || str.includes('\r')) {
+        // Escape quotes by doubling them
+        return '"' + str.replace(/"/g, '""') + '"';
+    }
+    return str;
+}
+/**
+ * Convert an array of objects to CSV format.
+ *
+ * @param data - Array of objects (all should have same keys)
+ * @returns CSV string with headers
+ *
+ * Rules:
+ * - First row is headers (keys from first object)
+ * - Values containing commas, quotes, or newlines are quoted
+ * - Quotes in values are escaped as ""
+ * - null/undefined become empty string
+ * - Objects/arrays are JSON stringified
+ */
+// Non-RFC: CSV formatting helper.
+export function toCSV(data) {
+    if (data.length === 0) {
+        return '';
+    }
+    // Get headers from first object
+    const firstRow = data[0];
+    const headers = Object.keys(firstRow);
+    // Build header row
+    const headerRow = headers.map(h => escapeCSVValue(h)).join(',');
+    // Build data rows
+    const dataRows = data.map(row => {
+        return headers.map(header => escapeCSVValue(row[header])).join(',');
+    });
+    return [headerRow, ...dataRows].join('\n');
+}
+//# sourceMappingURL=negotiate.js.map

package/dist/negotiate.js.map

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

package/dist/pagination.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Pagination helpers with RFC 8288 Link header usage.
+ * RFC 8288 §3, §3.3.
+ */
+import type { PaginationResult, DecodedCursor, PaginationLinks } from './types.js';
+/** Default number of items per page */
+export declare const DEFAULT_LIMIT = 50;
+/** Maximum allowed items per page */
+export declare const MAX_LIMIT = 100;
+/**
+ * Decode a cursor string to get the offset.
+ * Cursor format: base64(JSON({ offset: number }))
+ *
+ * @param cursor - The cursor string
+ * @returns DecodedCursor or null if invalid
+ */
+export declare function decodeCursor(cursor: string): DecodedCursor | null;
+/**
+ * Encode an offset into a cursor string.
+ *
+ * @param offset - The offset to encode
+ * @returns Base64-encoded cursor
+ */
+export declare function encodeCursor(offset: number): string;
+/**
+ * Parse pagination parameters from URL query string.
+ *
+ * Supports two modes:
+ * 1. Cursor-based: ?cursor=<base64>
+ * 2. Offset-based: ?limit=N&offset=N
+ *
+ * Also extracts sort parameter if present.
+ *
+ * @param url - The URL to parse
+ * @param options - Configuration options
+ * @returns PaginationParams on success, PaginationError on failure
+ *
+ * Error cases:
+ * - Invalid cursor format
+ * - Invalid cursor payload (not JSON, missing offset, negative offset)
+ * - Non-numeric limit/offset
+ * - Negative offset
+ */
+export declare function parsePaginationParams(url: URL, options?: {
+    defaultLimit?: number;
+    maxLimit?: number;
+}): PaginationResult;
+/**
+ * Calculate the last page offset given total count and limit.
+ */
+export declare function lastPageOffset(totalCount: number, limit: number): number;
+/**
+ * Check if we're on the first page.
+ */
+export declare function isFirstPage(offset: number): boolean;
+/**
+ * Check if we're on the last page.
+ */
+export declare function isLastPage(offset: number, limit: number, totalCount: number): boolean;
+/**
+ * Build pagination links for a result set.
+ *
+ * @param baseUrl - The base URL (without pagination params)
+ * @param totalCount - Total number of items
+ * @param limit - Items per page
+ * @param currentOffset - Current offset
+ * @param extraParams - Additional URL params to preserve
+ * @returns PaginationLinks object
+ *
+ * Links:
+ * - self: Current page
+ * - first: First page (offset=0)
+ * - last: Last page
+ * - next: Next page (omitted on last page)
+ * - prev: Previous page (omitted on first page)
+ *
+ * All links use cursor-based pagination for consistency.
+ */
+export declare function buildPaginationLinks(baseUrl: string, totalCount: number, limit: number, currentOffset: number, extraParams?: URLSearchParams): PaginationLinks;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAGR,gBAAgB,EAChB,aAAa,EACb,eAAe,EAClB,MAAM,YAAY,CAAC;AAGpB,uCAAuC;AACvC,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,qCAAqC;AACrC,eAAO,MAAM,SAAS,MAAM,CAAC;AAE7B;;;;;;GAMG;AAEH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAqBjE;AAED;;;;;GAKG;AAEH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AAEH,wBAAgB,qBAAqB,CACjC,GAAG,EAAE,GAAG,EACR,OAAO,CAAC,EAAE;IACN,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,GACF,gBAAgB,CAiDlB;AAED;;GAEG;AAEH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKxE;AAED;;GAEG;AAEH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;GAEG;AAEH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAKrF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AAEH,wBAAgB,oBAAoB,CAChC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,eAAe,GAC9B,eAAe,CAmCjB"}

package/dist/pagination.js

@@ -0,0 +1,188 @@
+/**
+ * Pagination helpers with RFC 8288 Link header usage.
+ * RFC 8288 §3, §3.3.
+ */
+/** Default number of items per page */
+export const DEFAULT_LIMIT = 50;
+/** Maximum allowed items per page */
+export const MAX_LIMIT = 100;
+/**
+ * Decode a cursor string to get the offset.
+ * Cursor format: base64(JSON({ offset: number }))
+ *
+ * @param cursor - The cursor string
+ * @returns DecodedCursor or null if invalid
+ */
+// Non-RFC: Cursor decoding helper.
+export function decodeCursor(cursor) {
+    try {
+        const decoded = atob(cursor);
+        const parsed = JSON.parse(decoded);
+        if (typeof parsed.offset !== 'number') {
+            return null;
+        }
+        if (parsed.offset < 0) {
+            return null;
+        }
+        if (!Number.isInteger(parsed.offset)) {
+            return null;
+        }
+        return { offset: parsed.offset };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Encode an offset into a cursor string.
+ *
+ * @param offset - The offset to encode
+ * @returns Base64-encoded cursor
+ */
+// Non-RFC: Cursor encoding helper.
+export function encodeCursor(offset) {
+    return btoa(JSON.stringify({ offset }));
+}
+/**
+ * Parse pagination parameters from URL query string.
+ *
+ * Supports two modes:
+ * 1. Cursor-based: ?cursor=<base64>
+ * 2. Offset-based: ?limit=N&offset=N
+ *
+ * Also extracts sort parameter if present.
+ *
+ * @param url - The URL to parse
+ * @param options - Configuration options
+ * @returns PaginationParams on success, PaginationError on failure
+ *
+ * Error cases:
+ * - Invalid cursor format
+ * - Invalid cursor payload (not JSON, missing offset, negative offset)
+ * - Non-numeric limit/offset
+ * - Negative offset
+ */
+// Non-RFC: Pagination query parsing.
+export function parsePaginationParams(url, options) {
+    const defaultLimit = options?.defaultLimit ?? DEFAULT_LIMIT;
+    const maxLimit = options?.maxLimit ?? MAX_LIMIT;
+    const cursorParam = url.searchParams.get('cursor');
+    const limitParam = url.searchParams.get('limit');
+    const offsetParam = url.searchParams.get('offset');
+    const sortParam = url.searchParams.get('sort');
+    let offset;
+    let limit;
+    // Cursor takes precedence over limit/offset
+    if (cursorParam !== null) {
+        const decoded = decodeCursor(cursorParam);
+        if (decoded === null) {
+            return { error: 'invalid_cursor' };
+        }
+        offset = decoded.offset;
+    }
+    else if (offsetParam !== null) {
+        const parsedOffset = Number(offsetParam);
+        if (Number.isNaN(parsedOffset)) {
+            return { error: 'invalid_offset' };
+        }
+        if (parsedOffset < 0) {
+            return { error: 'invalid_offset' };
+        }
+        offset = Math.floor(parsedOffset);
+    }
+    else {
+        offset = 0;
+    }
+    if (limitParam !== null) {
+        const parsedLimit = Number(limitParam);
+        if (Number.isNaN(parsedLimit)) {
+            return { error: 'invalid_limit' };
+        }
+        limit = Math.min(Math.max(1, Math.floor(parsedLimit)), maxLimit);
+    }
+    else {
+        limit = defaultLimit;
+    }
+    const result = { limit, offset };
+    if (sortParam !== null) {
+        result.sort = sortParam;
+    }
+    return result;
+}
+/**
+ * Calculate the last page offset given total count and limit.
+ */
+// Non-RFC: Pagination helper.
+export function lastPageOffset(totalCount, limit) {
+    if (totalCount <= 0) {
+        return 0;
+    }
+    return Math.floor((totalCount - 1) / limit) * limit;
+}
+/**
+ * Check if we're on the first page.
+ */
+// Non-RFC: Pagination helper.
+export function isFirstPage(offset) {
+    return offset === 0;
+}
+/**
+ * Check if we're on the last page.
+ */
+// Non-RFC: Pagination helper.
+export function isLastPage(offset, limit, totalCount) {
+    if (totalCount === 0) {
+        return true;
+    }
+    return offset + limit >= totalCount;
+}
+/**
+ * Build pagination links for a result set.
+ *
+ * @param baseUrl - The base URL (without pagination params)
+ * @param totalCount - Total number of items
+ * @param limit - Items per page
+ * @param currentOffset - Current offset
+ * @param extraParams - Additional URL params to preserve
+ * @returns PaginationLinks object
+ *
+ * Links:
+ * - self: Current page
+ * - first: First page (offset=0)
+ * - last: Last page
+ * - next: Next page (omitted on last page)
+ * - prev: Previous page (omitted on first page)
+ *
+ * All links use cursor-based pagination for consistency.
+ */
+// RFC 8288 §3, §3.3: Link relations for pagination.
+export function buildPaginationLinks(baseUrl, totalCount, limit, currentOffset, extraParams) {
+    const buildUrl = (offset) => {
+        const url = new URL(baseUrl);
+        url.searchParams.set('cursor', encodeCursor(offset));
+        url.searchParams.set('limit', String(limit));
+        if (extraParams) {
+            extraParams.forEach((value, key) => {
+                if (key !== 'cursor' && key !== 'limit' && key !== 'offset') {
+                    url.searchParams.set(key, value);
+                }
+            });
+        }
+        return url.toString();
+    };
+    const lastOffset = lastPageOffset(totalCount, limit);
+    const links = {
+        self: buildUrl(currentOffset),
+        first: buildUrl(0),
+        last: buildUrl(lastOffset)
+    };
+    if (!isLastPage(currentOffset, limit, totalCount)) {
+        links.next = buildUrl(currentOffset + limit);
+    }
+    if (!isFirstPage(currentOffset)) {
+        const prevOffset = Math.max(0, currentOffset - limit);
+        links.prev = buildUrl(prevOffset);
+    }
+    return links;
+}
+//# sourceMappingURL=pagination.js.map

package/dist/pagination.js.map

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

package/dist/prefer.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Prefer / Preference-Applied utilities per RFC 7240.
+ * RFC 7240 §2, §3.
+ */
+import type { PreferMap, PreferToken } from './types.js';
+/**
+ * Parse a Prefer header into a map of preference tokens.
+ */
+export declare function parsePrefer(header: string): PreferMap;
+/**
+ * Format Prefer header from tokens.
+ */
+export declare function formatPrefer(preferences: PreferMap | PreferToken[]): string;
+/**
+ * Format Preference-Applied header.
+ */
+export declare function formatPreferenceApplied(preferences: PreferMap | string[]): string;
+//# sourceMappingURL=prefer.d.ts.map

package/dist/prefer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefer.d.ts","sourceRoot":"","sources":["../src/prefer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAe,MAAM,YAAY,CAAC;AAGtE;;GAEG;AAEH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAkDrD;AAED;;GAEG;AAEH,wBAAgB,YAAY,CAAC,WAAW,EAAE,SAAS,GAAG,WAAW,EAAE,GAAG,MAAM,CAiB3E;AAED;;GAEG;AAEH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,EAAE,GAAG,MAAM,CAYjF"}