@irvinebroque/http-rfc-utils 0.1.0

package/dist/linkset.js

@@ -0,0 +1,501 @@
+/**
+ * Linkset utilities per RFC 9264.
+ * API catalog support per RFC 9727.
+ * RFC 9264 §4.1, §4.2, §5, §6.
+ * RFC 9727 §§2-4, §7.
+ * @see https://www.rfc-editor.org/rfc/rfc9264.html
+ * @see https://www.rfc-editor.org/rfc/rfc9727.html
+ */
+import { parseLinkHeader, formatLink } from './link.js';
+// RFC 9264 §4.2: Linkset JSON media type.
+export const LINKSET_MEDIA_TYPE = 'application/linkset+json';
+// RFC 9727 §7.3: API catalog profile URI.
+export const API_CATALOG_PROFILE = 'https://www.rfc-editor.org/info/rfc9727';
+// RFC 9727 §2: Well-known URI path for API catalog.
+export const API_CATALOG_PATH = '/.well-known/api-catalog';
+/**
+ * Parse an application/linkset document into link definitions.
+ * RFC 9264 §4.1: Same as HTTP Link header format but allows newlines as separators.
+ *
+ * @param document - The linkset document content
+ * @returns Array of parsed link definitions, or null if parsing fails
+ */
+// RFC 9264 §4.1: application/linkset uses RFC 8288 Link format with newlines allowed.
+export function parseLinkset(document) {
+    if (!document || document.trim() === '') {
+        return [];
+    }
+    // RFC 9264 §4.1: Newlines are valid separators in addition to commas.
+    // Normalize CR/LF to LF, then replace newlines outside quotes with commas.
+    const normalized = normalizeNewlines(document);
+    return parseLinkHeader(normalized);
+}
+/**
+ * Normalize newlines in linkset format for parsing.
+ * RFC 9264 §4.1: Newlines allowed as separators between link-values.
+ *
+ * Handles two patterns:
+ * 1. Continuation lines: newline + whitespace + `;` - these continue parameters
+ * 2. Link separators: newline followed by `<` or end of document
+ */
+function normalizeNewlines(document) {
+    // Replace CR/LF with LF
+    let result = document.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    // RFC 9264 §4.1: Newlines with continuation (whitespace + ;) should become spaces
+    // This handles the indented parameter continuation pattern from RFC examples
+    result = result.replace(/\n[ \t]+;/g, ' ;');
+    // Track quote state for remaining newline handling
+    let inQuote = false;
+    let escaped = false;
+    let output = '';
+    for (let i = 0; i < result.length; i++) {
+        const char = result[i];
+        if (escaped) {
+            output += char;
+            escaped = false;
+            continue;
+        }
+        if (char === '\\') {
+            output += char;
+            escaped = true;
+            continue;
+        }
+        if (char === '"') {
+            inQuote = !inQuote;
+            output += char;
+            continue;
+        }
+        if (char === '\n' && !inQuote) {
+            // RFC 9264 §4.1: Newlines between links act as separators
+            // Look ahead to determine if this is a link separator
+            let j = i + 1;
+            while (j < result.length && (result[j] === ' ' || result[j] === '\t')) {
+                j++;
+            }
+            const nextNonWs = result[j];
+            // If next non-whitespace is '<', this newline separates links
+            if (nextNonWs === '<') {
+                const trimmed = output.trimEnd();
+                if (trimmed.length > 0 && !trimmed.endsWith(',')) {
+                    output = trimmed + ', ';
+                }
+                else {
+                    output = trimmed + ' ';
+                }
+            }
+            else {
+                // Otherwise treat as continuation (just whitespace)
+                output += ' ';
+            }
+            continue;
+        }
+        output += char;
+    }
+    return output;
+}
+/**
+ * Parse an application/linkset+json document.
+ * RFC 9264 §4.2: JSON format for link sets.
+ *
+ * @param json - The JSON string or object
+ * @returns Parsed Linkset object, or null if invalid
+ */
+// RFC 9264 §4.2: application/linkset+json parsing.
+export function parseLinksetJson(json) {
+    let obj;
+    if (typeof json === 'string') {
+        try {
+            obj = JSON.parse(json);
+        }
+        catch {
+            return null;
+        }
+    }
+    else {
+        obj = json;
+    }
+    if (!isValidLinkset(obj)) {
+        return null;
+    }
+    return obj;
+}
+/**
+ * Format link definitions as an application/linkset document.
+ * RFC 9264 §4.1: Uses Link header format with newlines for readability.
+ *
+ * @param links - Array of link definitions
+ * @returns Formatted linkset document
+ */
+// RFC 9264 §4.1: application/linkset formatting with newline separators.
+export function formatLinkset(links) {
+    if (links.length === 0) {
+        return '';
+    }
+    // Format each link and join with newlines for readability
+    return links.map(formatLink).join(',\n');
+}
+/**
+ * Format link definitions as an application/linkset+json object.
+ * RFC 9264 §4.2: JSON format for link sets.
+ *
+ * @param links - Array of link definitions
+ * @param options - Formatting options
+ * @returns Linkset JSON object
+ */
+// RFC 9264 §4.2: application/linkset+json formatting.
+export function formatLinksetJson(links, options = {}) {
+    const { groupByAnchor = true } = options;
+    if (!groupByAnchor) {
+        // Each link gets its own context object
+        const contexts = links.map((link) => {
+            const target = linkDefinitionToTarget(link);
+            const context = {};
+            if (link.anchor) {
+                context.anchor = link.anchor;
+            }
+            context[link.rel] = [target];
+            return context;
+        });
+        return { linkset: contexts };
+    }
+    // Group by anchor
+    const byAnchor = new Map();
+    for (const link of links) {
+        const anchor = link.anchor ?? '';
+        if (!byAnchor.has(anchor)) {
+            byAnchor.set(anchor, new Map());
+        }
+        const relMap = byAnchor.get(anchor);
+        if (!relMap.has(link.rel)) {
+            relMap.set(link.rel, []);
+        }
+        relMap.get(link.rel).push(linkDefinitionToTarget(link));
+    }
+    const contexts = [];
+    for (const [anchor, relMap] of byAnchor) {
+        const context = {};
+        if (anchor) {
+            context.anchor = anchor;
+        }
+        for (const [rel, targets] of relMap) {
+            context[rel] = targets;
+        }
+        contexts.push(context);
+    }
+    return { linkset: contexts };
+}
+/**
+ * Convert a LinkDefinition to a LinksetTarget.
+ */
+function linkDefinitionToTarget(link) {
+    const target = { href: link.href };
+    if (link.type) {
+        target.type = link.type;
+    }
+    if (link.title) {
+        target.title = link.title;
+    }
+    // RFC 9264 §4.2.4.2: title* with language
+    if (link.titleLang && link.title) {
+        target['title*'] = [{ value: link.title, language: link.titleLang }];
+    }
+    if (link.hreflang) {
+        // RFC 9264 §4.2.4.1: hreflang is always an array
+        target.hreflang = Array.isArray(link.hreflang) ? link.hreflang : [link.hreflang];
+    }
+    if (link.media) {
+        target.media = link.media;
+    }
+    // Copy extension attributes
+    const standardKeys = new Set(['href', 'rel', 'type', 'title', 'titleLang', 'hreflang', 'media', 'anchor', 'rev']);
+    for (const [key, value] of Object.entries(link)) {
+        if (!standardKeys.has(key) && value !== undefined) {
+            // RFC 9264 §4.2.4.3: Extension attributes are always arrays
+            target[key] = Array.isArray(value) ? value : [value];
+        }
+    }
+    return target;
+}
+/**
+ * Convert an application/linkset document to JSON format.
+ * RFC 9264 §4.1, §4.2: Format conversion.
+ *
+ * @param document - The linkset document
+ * @returns Linkset JSON object, or null if parsing fails
+ */
+// RFC 9264 §4.1, §4.2: Convert between formats.
+export function linksetToJson(document) {
+    const links = parseLinkset(document);
+    if (links === null) {
+        return null;
+    }
+    return formatLinksetJson(links);
+}
+/**
+ * Convert a JSON linkset to application/linkset format.
+ * RFC 9264 §4.1, §4.2: Format conversion.
+ *
+ * @param linkset - The Linkset object
+ * @returns Formatted linkset document
+ */
+// RFC 9264 §4.1, §4.2: Convert between formats.
+export function jsonToLinkset(linkset) {
+    const links = linksetJsonToDefinitions(linkset);
+    return formatLinkset(links);
+}
+/**
+ * Convert a Linkset JSON object to LinkDefinition array.
+ */
+function linksetJsonToDefinitions(linkset) {
+    const links = [];
+    for (const context of linkset.linkset) {
+        const anchor = context.anchor;
+        for (const [key, value] of Object.entries(context)) {
+            if (key === 'anchor') {
+                continue;
+            }
+            // key is a relation type, value is an array of targets
+            if (!Array.isArray(value)) {
+                continue;
+            }
+            const targets = value;
+            for (const target of targets) {
+                const link = {
+                    href: target.href,
+                    rel: key,
+                };
+                if (anchor) {
+                    link.anchor = anchor;
+                }
+                if (target.type) {
+                    link.type = target.type;
+                }
+                if (target.title) {
+                    link.title = target.title;
+                }
+                // RFC 9264 §4.2.4.2: title* with language
+                if (target['title*'] && target['title*'].length > 0) {
+                    const titleStar = target['title*'][0];
+                    link.title = titleStar.value;
+                    if (titleStar.language) {
+                        link.titleLang = titleStar.language;
+                    }
+                }
+                if (target.hreflang) {
+                    // Flatten to single value if only one, otherwise keep array
+                    link.hreflang = target.hreflang.length === 1 ? target.hreflang[0] : target.hreflang;
+                }
+                if (target.media) {
+                    link.media = target.media;
+                }
+                // Copy extension attributes
+                const standardKeys = new Set(['href', 'type', 'title', 'title*', 'hreflang', 'media']);
+                for (const [attrKey, attrValue] of Object.entries(target)) {
+                    if (!standardKeys.has(attrKey) && attrValue !== undefined) {
+                        // Flatten single-element arrays
+                        if (Array.isArray(attrValue) && attrValue.length === 1) {
+                            const first = attrValue[0];
+                            if (typeof first === 'string') {
+                                link[attrKey] = first;
+                            }
+                            else if (typeof first === 'object' && 'value' in first) {
+                                // Internationalized value
+                                link[attrKey] = first.value;
+                            }
+                        }
+                        else if (Array.isArray(attrValue)) {
+                            // Keep as array for multi-value extensions
+                            link[attrKey] = attrValue.map((v) => typeof v === 'object' && 'value' in v ? v.value : v);
+                        }
+                    }
+                }
+                links.push(link);
+            }
+        }
+    }
+    return links;
+}
+/**
+ * Type guard to validate a Linkset object.
+ * RFC 9264 §4.2.1: linkset must be the sole top-level member.
+ *
+ * @param obj - Object to validate
+ * @returns True if valid Linkset
+ */
+// RFC 9264 §4.2.1: Validate linkset structure.
+export function isValidLinkset(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return false;
+    }
+    const record = obj;
+    // RFC 9264 §4.2.1: linkset MUST be the sole member (profile is allowed for api-catalog)
+    const keys = Object.keys(record);
+    if (!keys.includes('linkset')) {
+        return false;
+    }
+    // Allow 'profile' as additional key for API catalogs
+    for (const key of keys) {
+        if (key !== 'linkset' && key !== 'profile') {
+            return false;
+        }
+    }
+    if (!Array.isArray(record.linkset)) {
+        return false;
+    }
+    // Validate each context object
+    for (const context of record.linkset) {
+        if (typeof context !== 'object' || context === null) {
+            return false;
+        }
+        // Validate each relation type's targets
+        for (const [key, value] of Object.entries(context)) {
+            if (key === 'anchor') {
+                if (typeof value !== 'string') {
+                    return false;
+                }
+                continue;
+            }
+            // Value must be an array of target objects
+            if (!Array.isArray(value)) {
+                return false;
+            }
+            for (const target of value) {
+                if (typeof target !== 'object' || target === null) {
+                    return false;
+                }
+                // RFC 9264 §4.2.3: href is required
+                if (!('href' in target) || typeof target.href !== 'string') {
+                    return false;
+                }
+            }
+        }
+    }
+    return true;
+}
+// =============================================================================
+// API Catalog (RFC 9727)
+// =============================================================================
+/**
+ * Create an API catalog document.
+ * RFC 9727 §4: API catalog document structure.
+ *
+ * @param options - API catalog configuration
+ * @returns API catalog Linkset document
+ */
+// RFC 9727 §4.1, §4.2: Create API catalog with required structure.
+export function createApiCatalog(options) {
+    const { anchor, apis = [], items = [], nested = [], profile = true } = options;
+    if (!anchor) {
+        throw new Error('API catalog requires an anchor URI');
+    }
+    const contexts = [];
+    // RFC 9727 §4.1: Include hyperlinks to API endpoints
+    if (items.length > 0 || nested.length > 0) {
+        // Create a context for simple item links and nested catalogs
+        const mainContext = { anchor };
+        // RFC 9727 §3.1: "item" relation identifies API members
+        if (items.length > 0) {
+            mainContext.item = items.map((item) => {
+                const target = { href: item.href };
+                if (item.type)
+                    target.type = item.type;
+                if (item.title)
+                    target.title = item.title;
+                if (item.hreflang)
+                    target.hreflang = [item.hreflang];
+                return target;
+            });
+        }
+        // RFC 9727 §4.3: Nested api-catalog links
+        if (nested.length > 0) {
+            mainContext['api-catalog'] = nested.map((href) => ({ href }));
+        }
+        contexts.push(mainContext);
+    }
+    // RFC 9727 Appendix A.1: Full API entries with service relations
+    for (const api of apis) {
+        const apiContext = { anchor: api.anchor };
+        if (api['service-desc']) {
+            apiContext['service-desc'] = api['service-desc'];
+        }
+        if (api['service-doc']) {
+            apiContext['service-doc'] = api['service-doc'];
+        }
+        if (api['service-meta']) {
+            apiContext['service-meta'] = api['service-meta'];
+        }
+        if (api.status) {
+            apiContext.status = api.status;
+        }
+        contexts.push(apiContext);
+    }
+    const catalog = { linkset: contexts };
+    // RFC 9727 §4.2: SHOULD include profile parameter
+    if (profile) {
+        catalog.profile = API_CATALOG_PROFILE;
+    }
+    return catalog;
+}
+/**
+ * Parse an API catalog document.
+ * RFC 9727 §4: Validate and parse API catalog structure.
+ *
+ * @param json - JSON string or object
+ * @returns Parsed API catalog, or null if invalid
+ */
+// RFC 9727 §4: Parse and validate API catalog.
+export function parseApiCatalog(json) {
+    const linkset = parseLinksetJson(json);
+    if (!linkset) {
+        return null;
+    }
+    // Add profile if present in the input
+    const input = typeof json === 'string' ? JSON.parse(json) : json;
+    if (input && typeof input === 'object' && 'profile' in input) {
+        return { ...linkset, profile: input.profile };
+    }
+    return linkset;
+}
+/**
+ * Check if a Linkset is an API catalog (has the RFC 9727 profile).
+ * RFC 9727 §4.2, §7.3: Profile URI indicates api-catalog semantics.
+ *
+ * @param linkset - Linkset to check
+ * @returns True if the linkset has the api-catalog profile
+ */
+// RFC 9727 §7.3: Check for API catalog profile.
+export function isApiCatalog(linkset) {
+    if ('profile' in linkset) {
+        return linkset.profile === API_CATALOG_PROFILE;
+    }
+    return false;
+}
+/**
+ * Convert a Linkset to an array of LinkDefinitions.
+ * Useful for converting API catalog entries to Link header format.
+ *
+ * @param linkset - Linkset to convert
+ * @returns Array of LinkDefinition objects
+ */
+// RFC 9264 §4: Convert between linkset and link definitions.
+export function linksetToLinks(linkset) {
+    return linksetJsonToDefinitions(linkset);
+}
+/**
+ * Convert an array of LinkDefinitions to a Linkset.
+ * Useful for creating API catalogs from Link header entries.
+ *
+ * @param links - Array of link definitions
+ * @param anchor - Default anchor URI for links without one
+ * @returns Linkset object
+ */
+// RFC 9264 §4: Convert between link definitions and linkset.
+export function linksToLinkset(links, anchor) {
+    // Set anchor on links that don't have one
+    const linksWithAnchor = links.map((link) => ({
+        ...link,
+        anchor: link.anchor ?? anchor,
+    }));
+    return formatLinksetJson(linksWithAnchor);
+}
+//# sourceMappingURL=linkset.js.map

package/dist/linkset.js.map

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

package/dist/negotiate.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Content negotiation utilities per RFC 7231.
+ * RFC 7231 §5.3.1, §5.3.2.
+ */
+import type { AcceptEntry, MediaType } from './types.js';
+/**
+ * Media type constants mapping format names to MIME types.
+ */
+export declare const MEDIA_TYPES: Record<MediaType, string>;
+/**
+ * Reverse mapping from MIME type to format name.
+ */
+export declare const MIME_TO_FORMAT: Record<string, MediaType>;
+/**
+ * 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]
+ */
+export declare function parseAccept(header: string): AcceptEntry[];
+/**
+ * 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
+ */
+export declare function negotiate(input: Request | string | undefined | null, supported: string[]): string | null;
+/**
+ * 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
+ */
+export declare function getResponseFormat(input: Request | string | undefined | null): 'json' | 'csv' | null;
+/**
+ * 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
+ */
+export declare function toCSV<T extends Record<string, unknown>>(data: T[]): string;
+//# sourceMappingURL=negotiate.d.ts.map

package/dist/negotiate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"negotiate.d.ts","sourceRoot":"","sources":["../src/negotiate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGzD;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAMjD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAEvB,CAAC;AAE/B;;;;;;;;;;;;;;;;;;GAkBG;AAEH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAqCzD;AA4KD;;;;;;;;;;;;GAYG;AAEH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAkDxG;AAED;;;;;;;GAOG;AAEH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,CA4BnG;AA0BD;;;;;;;;;;;;GAYG;AAEH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,CAkB1E"}