@irvinebroque/http-rfc-utils 0.1.0

package/dist/uri.d.ts

@@ -0,0 +1,80 @@
+/**
+ * URI utilities per RFC 3986.
+ * RFC 3986 §2, §3.1, §3.2.2, §5.2.4, §6.2.
+ * @see https://www.rfc-editor.org/rfc/rfc3986.html
+ */
+import type { UriComponent } from './types.js';
+export declare const UNRESERVED_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~";
+export declare const GEN_DELIMS = ":/?#[]@";
+export declare const SUB_DELIMS = "!$&'()*+,;=";
+/**
+ * Check if a character is unreserved per RFC 3986 §2.3.
+ *
+ * @param char - Single character to check
+ * @returns true if unreserved
+ */
+export declare function isUnreserved(char: string): boolean;
+/**
+ * Check if a character is reserved per RFC 3986 §2.2.
+ *
+ * @param char - Single character to check
+ * @returns true if reserved (gen-delims or sub-delims)
+ */
+export declare function isReserved(char: string): boolean;
+/**
+ * Percent-encode a string for use in a URI component.
+ *
+ * - Uses uppercase hex digits per RFC 3986 §2.1 SHOULD.
+ * - Does not encode unreserved characters per RFC 3986 §2.3.
+ * - Encodes based on component context (path/query/fragment/userinfo).
+ * - Detects already-encoded sequences to avoid double-encoding.
+ *
+ * @param str - String to encode
+ * @param component - URI component context (default: 'path')
+ * @returns Percent-encoded string
+ */
+export declare function percentEncode(str: string, component?: UriComponent): string;
+/**
+ * Decode percent-encoded octets in a string.
+ *
+ * - Decodes all percent-encoded sequences.
+ * - Handles UTF-8 multi-byte sequences.
+ * - Returns original string if decoding fails.
+ *
+ * @param str - Percent-encoded string
+ * @returns Decoded string
+ */
+export declare function percentDecode(str: string): string;
+/**
+ * Remove dot segments from a URI path per RFC 3986 §5.2.4.
+ *
+ * Implements the remove_dot_segments algorithm exactly as specified.
+ *
+ * @param path - Path component (may contain . and .. segments)
+ * @returns Path with dot segments removed
+ */
+export declare function removeDotSegments(path: string): string;
+/**
+ * Normalize a URI per RFC 3986 §6.2.
+ *
+ * Applies:
+ * - Case normalization (§6.2.2.1): lowercase scheme and host
+ * - Percent-encoding normalization (§6.2.2.2): uppercase hex, decode unreserved
+ * - Path segment normalization (§6.2.2.3): remove dot segments
+ * - Scheme-based normalization (§6.2.3): remove default ports, ensure path
+ *
+ * @param uri - URI to normalize
+ * @returns Normalized URI
+ */
+export declare function normalizeUri(uri: string): string;
+/**
+ * Compare two URIs for equivalence per RFC 3986 §6.2.1.
+ *
+ * Normalizes both URIs and performs simple string comparison.
+ *
+ * @param a - First URI
+ * @param b - Second URI
+ * @returns true if URIs are equivalent
+ */
+export declare function compareUris(a: string, b: string): boolean;
+//# sourceMappingURL=uri.d.ts.map

package/dist/uri.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri.d.ts","sourceRoot":"","sources":["../src/uri.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,eAAO,MAAM,gBAAgB,uEAAuE,CAAC;AAIrG,eAAO,MAAM,UAAU,YAAY,CAAC;AAGpC,eAAO,MAAM,UAAU,gBAAiB,CAAC;AA6BzC;;;;;GAKG;AAEH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKlD;AAED;;;;;GAKG;AAEH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKhD;AAED;;;;;;;;;;;GAWG;AAGH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,GAAE,YAAqB,GAAG,MAAM,CAsDnF;AAED;;;;;;;;;GASG;AAEH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAsCjD;AAED;;;;;;;GAOG;AAEH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAwEtD;AAED;;;;;;;;;;;GAWG;AAEH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAuEhD;AAED;;;;;;;;GAQG;AAEH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAKzD"}

package/dist/uri.js

@@ -0,0 +1,423 @@
+/**
+ * URI utilities per RFC 3986.
+ * RFC 3986 §2, §3.1, §3.2.2, §5.2.4, §6.2.
+ * @see https://www.rfc-editor.org/rfc/rfc3986.html
+ */
+// RFC 3986 §2.3: Unreserved characters.
+// unreserved = ALPHA / DIGIT / "-" / "." / "_" / "~"
+export const UNRESERVED_CHARS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~';
+// RFC 3986 §2.2: Reserved characters.
+// gen-delims = ":" / "/" / "?" / "#" / "[" / "]" / "@"
+export const GEN_DELIMS = ':/?#[]@';
+// sub-delims = "!" / "$" / "&" / "'" / "(" / ")" / "*" / "+" / "," / ";" / "="
+export const SUB_DELIMS = '!$&\'()*+,;=';
+// Combined reserved = gen-delims / sub-delims
+const RESERVED_CHARS = GEN_DELIMS + SUB_DELIMS;
+// RFC 3986 §3.3: pchar = unreserved / pct-encoded / sub-delims / ":" / "@"
+const PCHAR_EXTRA = SUB_DELIMS + ':@';
+// Characters allowed in each component without encoding (beyond unreserved)
+const COMPONENT_ALLOWED = {
+    // RFC 3986 §3.3: path uses pchar
+    path: PCHAR_EXTRA,
+    // RFC 3986 §3.4: query = *( pchar / "/" / "?" )
+    query: PCHAR_EXTRA + '/?',
+    // RFC 3986 §3.5: fragment = *( pchar / "/" / "?" )
+    fragment: PCHAR_EXTRA + '/?',
+    // RFC 3986 §3.2.1: userinfo = *( unreserved / pct-encoded / sub-delims / ":" )
+    userinfo: SUB_DELIMS + ':',
+};
+// Default ports for scheme-based normalization (RFC 3986 §6.2.3)
+const DEFAULT_PORTS = {
+    http: '80',
+    https: '443',
+    ftp: '21',
+    ws: '80',
+    wss: '443',
+};
+/**
+ * Check if a character is unreserved per RFC 3986 §2.3.
+ *
+ * @param char - Single character to check
+ * @returns true if unreserved
+ */
+// RFC 3986 §2.3: unreserved = ALPHA / DIGIT / "-" / "." / "_" / "~"
+export function isUnreserved(char) {
+    if (char.length !== 1) {
+        return false;
+    }
+    return UNRESERVED_CHARS.includes(char);
+}
+/**
+ * Check if a character is reserved per RFC 3986 §2.2.
+ *
+ * @param char - Single character to check
+ * @returns true if reserved (gen-delims or sub-delims)
+ */
+// RFC 3986 §2.2: reserved = gen-delims / sub-delims
+export function isReserved(char) {
+    if (char.length !== 1) {
+        return false;
+    }
+    return RESERVED_CHARS.includes(char);
+}
+/**
+ * Percent-encode a string for use in a URI component.
+ *
+ * - Uses uppercase hex digits per RFC 3986 §2.1 SHOULD.
+ * - Does not encode unreserved characters per RFC 3986 §2.3.
+ * - Encodes based on component context (path/query/fragment/userinfo).
+ * - Detects already-encoded sequences to avoid double-encoding.
+ *
+ * @param str - String to encode
+ * @param component - URI component context (default: 'path')
+ * @returns Percent-encoded string
+ */
+// RFC 3986 §2.1: Percent-encoding uses uppercase HEXDIG.
+// RFC 3986 §2.3: Unreserved characters SHOULD NOT be encoded.
+export function percentEncode(str, component = 'path') {
+    if (!str) {
+        return '';
+    }
+    const allowedExtra = COMPONENT_ALLOWED[component];
+    const result = [];
+    // Encode string as UTF-8 bytes
+    const encoder = new TextEncoder();
+    const bytes = encoder.encode(str);
+    let i = 0;
+    while (i < bytes.length) {
+        const byte = bytes[i];
+        // Check if this is an ASCII character we can represent directly
+        if (byte < 128) {
+            const char = String.fromCharCode(byte);
+            // RFC 3986 §2.3: Do not encode unreserved characters
+            if (UNRESERVED_CHARS.includes(char)) {
+                result.push(char);
+                i++;
+                continue;
+            }
+            // Check component-specific allowed characters
+            if (allowedExtra.includes(char)) {
+                result.push(char);
+                i++;
+                continue;
+            }
+            // Check for already-encoded sequence to avoid double-encoding
+            // RFC 3986 §2.4: MUST NOT percent-encode an already percent-encoded string
+            if (char === '%' && i + 2 < bytes.length) {
+                const hex1 = String.fromCharCode(bytes[i + 1]);
+                const hex2 = String.fromCharCode(bytes[i + 2]);
+                if (isHexDigit(hex1) && isHexDigit(hex2)) {
+                    // Already encoded - pass through with uppercase normalization
+                    result.push('%', hex1.toUpperCase(), hex2.toUpperCase());
+                    i += 3;
+                    continue;
+                }
+            }
+        }
+        // Percent-encode the byte with uppercase hex
+        result.push('%', byte.toString(16).toUpperCase().padStart(2, '0'));
+        i++;
+    }
+    return result.join('');
+}
+/**
+ * Decode percent-encoded octets in a string.
+ *
+ * - Decodes all percent-encoded sequences.
+ * - Handles UTF-8 multi-byte sequences.
+ * - Returns original string if decoding fails.
+ *
+ * @param str - Percent-encoded string
+ * @returns Decoded string
+ */
+// RFC 3986 §2.1: Percent-decoding.
+export function percentDecode(str) {
+    if (!str || !str.includes('%')) {
+        return str;
+    }
+    const bytes = [];
+    let i = 0;
+    while (i < str.length) {
+        if (str[i] === '%' && i + 2 < str.length) {
+            const hex = str.slice(i + 1, i + 3);
+            if (isHexDigit(hex[0]) && isHexDigit(hex[1])) {
+                bytes.push(parseInt(hex, 16));
+                i += 3;
+                continue;
+            }
+        }
+        // Non-encoded character - get its UTF-8 bytes
+        const charCode = str.charCodeAt(i);
+        if (charCode < 128) {
+            bytes.push(charCode);
+        }
+        else {
+            // Non-ASCII character that wasn't encoded - encode as UTF-8
+            const encoder = new TextEncoder();
+            const charBytes = encoder.encode(str[i]);
+            bytes.push(...charBytes);
+        }
+        i++;
+    }
+    // Decode UTF-8 bytes to string
+    try {
+        const decoder = new TextDecoder('utf-8', { fatal: true });
+        return decoder.decode(new Uint8Array(bytes));
+    }
+    catch {
+        // Invalid UTF-8 - return original
+        return str;
+    }
+}
+/**
+ * Remove dot segments from a URI path per RFC 3986 §5.2.4.
+ *
+ * Implements the remove_dot_segments algorithm exactly as specified.
+ *
+ * @param path - Path component (may contain . and .. segments)
+ * @returns Path with dot segments removed
+ */
+// RFC 3986 §5.2.4: Remove Dot Segments algorithm.
+export function removeDotSegments(path) {
+    if (!path) {
+        return '';
+    }
+    // Input buffer
+    let input = path;
+    // Output buffer
+    const output = [];
+    while (input.length > 0) {
+        // A: If the input buffer begins with a prefix of "../" or "./"
+        if (input.startsWith('../')) {
+            input = input.slice(3);
+            continue;
+        }
+        if (input.startsWith('./')) {
+            input = input.slice(2);
+            continue;
+        }
+        // B: If the input buffer begins with a prefix of "/./" or "/."
+        //    where "." is a complete path segment
+        if (input.startsWith('/./')) {
+            input = '/' + input.slice(3);
+            continue;
+        }
+        if (input === '/.') {
+            input = '/';
+            continue;
+        }
+        // C: If the input buffer begins with a prefix of "/../" or "/.."
+        //    where ".." is a complete path segment
+        if (input.startsWith('/../')) {
+            input = '/' + input.slice(4);
+            // Remove last segment from output
+            removeLastSegment(output);
+            continue;
+        }
+        if (input === '/..') {
+            input = '/';
+            removeLastSegment(output);
+            continue;
+        }
+        // D: If the input buffer consists only of "." or ".."
+        if (input === '.' || input === '..') {
+            input = '';
+            continue;
+        }
+        // E: Move the first path segment (including initial "/" if any)
+        //    to the end of the output buffer
+        let segmentEnd;
+        if (input.startsWith('/')) {
+            segmentEnd = input.indexOf('/', 1);
+            if (segmentEnd === -1) {
+                segmentEnd = input.length;
+            }
+        }
+        else {
+            segmentEnd = input.indexOf('/');
+            if (segmentEnd === -1) {
+                segmentEnd = input.length;
+            }
+        }
+        output.push(input.slice(0, segmentEnd));
+        input = input.slice(segmentEnd);
+    }
+    return output.join('');
+}
+/**
+ * Normalize a URI per RFC 3986 §6.2.
+ *
+ * Applies:
+ * - Case normalization (§6.2.2.1): lowercase scheme and host
+ * - Percent-encoding normalization (§6.2.2.2): uppercase hex, decode unreserved
+ * - Path segment normalization (§6.2.2.3): remove dot segments
+ * - Scheme-based normalization (§6.2.3): remove default ports, ensure path
+ *
+ * @param uri - URI to normalize
+ * @returns Normalized URI
+ */
+// RFC 3986 §6.2: Comparison Ladder normalization.
+export function normalizeUri(uri) {
+    if (!uri) {
+        return '';
+    }
+    // Use URL for parsing when possible
+    let url;
+    try {
+        url = new URL(uri);
+    }
+    catch {
+        // Not a valid absolute URI - try basic normalization
+        return normalizeUriBasic(uri);
+    }
+    // RFC 3986 §6.2.2.1: Lowercase scheme
+    const scheme = url.protocol.slice(0, -1).toLowerCase();
+    // RFC 3986 §6.2.2.1: Lowercase host (reg-name)
+    // Note: URL already lowercases the hostname
+    const host = url.hostname.toLowerCase();
+    // RFC 3986 §6.2.3: Remove default port
+    let port = url.port;
+    if (port && DEFAULT_PORTS[scheme] === port) {
+        port = '';
+    }
+    // RFC 3986 §6.2.2.2: Percent-encoding normalization for path
+    let path = normalizePercentEncoding(url.pathname);
+    // RFC 3986 §6.2.2.3: Path segment normalization
+    path = removeDotSegments(path);
+    // RFC 3986 §6.2.3: Ensure non-empty path when authority present
+    if (host && !path) {
+        path = '/';
+    }
+    // RFC 3986 §6.2.2.2: Normalize query percent-encoding
+    let query = '';
+    if (url.search) {
+        query = '?' + normalizePercentEncoding(url.search.slice(1));
+    }
+    // RFC 3986 §6.2.2.2: Normalize fragment percent-encoding
+    let fragment = '';
+    if (url.hash) {
+        fragment = '#' + normalizePercentEncoding(url.hash.slice(1));
+    }
+    // Reconstruct URI
+    let result = scheme + '://';
+    // Add userinfo if present (rare)
+    if (url.username) {
+        result += normalizePercentEncoding(url.username);
+        if (url.password) {
+            result += ':' + normalizePercentEncoding(url.password);
+        }
+        result += '@';
+    }
+    result += host;
+    if (port) {
+        result += ':' + port;
+    }
+    result += path + query + fragment;
+    return result;
+}
+/**
+ * Compare two URIs for equivalence per RFC 3986 §6.2.1.
+ *
+ * Normalizes both URIs and performs simple string comparison.
+ *
+ * @param a - First URI
+ * @param b - Second URI
+ * @returns true if URIs are equivalent
+ */
+// RFC 3986 §6.2.1: Simple String Comparison after normalization.
+export function compareUris(a, b) {
+    if (a === b) {
+        return true;
+    }
+    return normalizeUri(a) === normalizeUri(b);
+}
+// --- Internal helpers ---
+/**
+ * Check if a character is a hex digit.
+ */
+function isHexDigit(char) {
+    return /^[0-9A-Fa-f]$/.test(char);
+}
+/**
+ * Remove the last path segment from the output buffer.
+ * Used by removeDotSegments for ".." processing.
+ *
+ * RFC 3986 §5.2.4 step C says to remove "the last segment and its
+ * preceding '/' (if any)". Since our output buffer stores segments
+ * with their leading slashes (e.g., "/a", "/b"), we just pop the
+ * last element.
+ */
+function removeLastSegment(output) {
+    if (output.length > 0) {
+        output.pop();
+    }
+}
+/**
+ * Normalize percent-encoding in a string.
+ * - Uppercase hex digits
+ * - Decode unreserved characters
+ */
+// RFC 3986 §6.2.2.2: Percent-Encoding Normalization.
+function normalizePercentEncoding(str) {
+    if (!str) {
+        return '';
+    }
+    const result = [];
+    let i = 0;
+    while (i < str.length) {
+        if (str[i] === '%' && i + 2 < str.length) {
+            const hex1 = str[i + 1];
+            const hex2 = str[i + 2];
+            if (isHexDigit(hex1) && isHexDigit(hex2)) {
+                const byte = parseInt(hex1 + hex2, 16);
+                const char = String.fromCharCode(byte);
+                // RFC 3986 §6.2.2.2: Decode unreserved characters
+                if (UNRESERVED_CHARS.includes(char)) {
+                    result.push(char);
+                }
+                else {
+                    // Keep encoded but with uppercase hex
+                    result.push('%', hex1.toUpperCase(), hex2.toUpperCase());
+                }
+                i += 3;
+                continue;
+            }
+        }
+        result.push(str[i]);
+        i++;
+    }
+    return result.join('');
+}
+/**
+ * Basic normalization for URIs that can't be parsed by URL.
+ * Handles relative references and other edge cases.
+ */
+function normalizeUriBasic(uri) {
+    // Just normalize percent-encoding and dot segments
+    let result = normalizePercentEncoding(uri);
+    // If it looks like it has a path, normalize dot segments
+    if (result.includes('/')) {
+        // Find where the path starts
+        const pathStart = result.indexOf('/');
+        const beforePath = result.slice(0, pathStart);
+        let path = result.slice(pathStart);
+        // Check for query/fragment
+        const queryStart = path.indexOf('?');
+        const fragStart = path.indexOf('#');
+        let query = '';
+        let fragment = '';
+        if (fragStart !== -1) {
+            fragment = path.slice(fragStart);
+            path = path.slice(0, fragStart);
+        }
+        if (queryStart !== -1 && (fragStart === -1 || queryStart < fragStart)) {
+            const qEnd = fragStart !== -1 ? fragStart : path.length;
+            query = path.slice(queryStart, qEnd);
+            path = path.slice(0, queryStart);
+        }
+        path = removeDotSegments(path);
+        result = beforePath + path + query + fragment;
+    }
+    return result;
+}
+//# sourceMappingURL=uri.js.map

package/dist/uri.js.map

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

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@irvinebroque/http-rfc-utils",
+  "version": "0.1.0",
+  "description": "RFC-compliant HTTP utilities for APIs (9110, 8288, 7231, 9457, 9111)",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "keywords": [
+    "http",
+    "rfc",
+    "etag",
+    "cors",
+    "cache-control",
+    "content-negotiation",
+    "link-header",
+    "problem-details",
+    "conditional-requests",
+    "rfc9110",
+    "rfc8288",
+    "rfc9457"
+  ],
+  "author": "Brendan Irvine-Broque",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/irvinebroque/http-rfc-utils.git"
+  },
+  "homepage": "https://github.com/irvinebroque/http-rfc-utils#readme",
+  "bugs": {
+    "url": "https://github.com/irvinebroque/http-rfc-utils/issues"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "devDependencies": {
+    "@changesets/changelog-github": "^0.5.2",
+    "@changesets/cli": "^2.29.8",
+    "@types/node": "^22.10.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "tsx --test test/*.test.ts",
+    "test:watch": "tsx --test --watch test/*.test.ts",
+    "typecheck": "tsc --noEmit",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "changeset publish"
+  }
+}