@irvinebroque/http-rfc-utils 0.1.0

package/dist/sorting.js

@@ -0,0 +1,168 @@
+/**
+ * Parse a sort string into field/direction pairs.
+ *
+ * Format: "field1,-field2,field3"
+ * - Prefix with '-' for descending
+ * - No prefix for ascending
+ * - Multiple fields separated by comma
+ *
+ * @param sort - The sort string
+ * @returns Array of SortField objects
+ */
+export function parseSortString(sort) {
+    if (!sort || !sort.trim()) {
+        return [];
+    }
+    return sort
+        .split(',')
+        .map(field => field.trim())
+        .filter(field => field.length > 0)
+        .map(field => {
+        if (field.startsWith('-')) {
+            return {
+                field: field.slice(1),
+                direction: 'desc'
+            };
+        }
+        return {
+            field,
+            direction: 'asc'
+        };
+    });
+}
+/**
+ * Get a nested value from an object using dot notation.
+ *
+ * @param obj - The object to access
+ * @param path - Dot-separated path (e.g., "user.name")
+ * @returns The value at the path, or undefined if not found
+ */
+function getNestedValue(obj, path) {
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined) {
+            return undefined;
+        }
+        if (typeof current !== 'object') {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return current;
+}
+/**
+ * Compare two values for sorting.
+ * Internal helper exposed for custom comparators.
+ *
+ * @param a - First value
+ * @param b - Second value
+ * @param direction - Sort direction
+ * @returns Comparison result (-1, 0, 1)
+ */
+export function compareValues(a, b, direction) {
+    const multiplier = direction === 'desc' ? -1 : 1;
+    // Handle null/undefined - always sort last
+    const aIsNullish = a === null || a === undefined;
+    const bIsNullish = b === null || b === undefined;
+    if (aIsNullish && bIsNullish) {
+        return 0;
+    }
+    if (aIsNullish) {
+        return 1; // a sorts last regardless of direction
+    }
+    if (bIsNullish) {
+        return -1; // b sorts last regardless of direction
+    }
+    // Handle dates
+    if (a instanceof Date && b instanceof Date) {
+        return multiplier * (a.getTime() - b.getTime());
+    }
+    // Handle booleans (false < true)
+    if (typeof a === 'boolean' && typeof b === 'boolean') {
+        if (a === b)
+            return 0;
+        return multiplier * (a ? 1 : -1);
+    }
+    // Handle numbers
+    if (typeof a === 'number' && typeof b === 'number') {
+        return multiplier * (a - b);
+    }
+    // Handle strings (case-insensitive)
+    if (typeof a === 'string' && typeof b === 'string') {
+        const comparison = a.toLowerCase().localeCompare(b.toLowerCase());
+        return multiplier * comparison;
+    }
+    // Mixed types - convert to strings for comparison
+    const aStr = String(a).toLowerCase();
+    const bStr = String(b).toLowerCase();
+    return multiplier * aStr.localeCompare(bStr);
+}
+/**
+ * Apply sorting to an array of objects.
+ *
+ * @param data - Array to sort (not mutated, returns new array)
+ * @param sort - Sort string (e.g., "-date,title")
+ * @returns Sorted array
+ *
+ * Sorting rules:
+ * - undefined/null values sort last
+ * - Strings are compared case-insensitively
+ * - Numbers compared numerically
+ * - Dates compared by timestamp
+ * - Booleans: false < true
+ * - Multiple sort fields applied in order
+ */
+export function applySorting(data, sort) {
+    if (!sort || !sort.trim()) {
+        return data;
+    }
+    const sortFields = parseSortString(sort);
+    if (sortFields.length === 0) {
+        return data;
+    }
+    // Create shallow copy to avoid mutating input
+    const result = [...data];
+    result.sort((a, b) => {
+        for (const { field, direction } of sortFields) {
+            const aValue = getNestedValue(a, field);
+            const bValue = getNestedValue(b, field);
+            const comparison = compareValues(aValue, bValue, direction);
+            if (comparison !== 0) {
+                return comparison;
+            }
+        }
+        return 0;
+    });
+    return result;
+}
+/**
+ * Validate that sort fields exist in the data.
+ *
+ * @param sort - Sort string
+ * @param allowedFields - Array of allowed field names
+ * @returns true if all fields are allowed, false otherwise
+ */
+export function validateSortFields(sort, allowedFields) {
+    const sortFields = parseSortString(sort);
+    if (sortFields.length === 0) {
+        return true;
+    }
+    const allowedSet = new Set(allowedFields);
+    return sortFields.every(({ field }) => allowedSet.has(field));
+}
+/**
+ * Build a sort string from field/direction pairs.
+ * Inverse of parseSortString.
+ *
+ * @param fields - Array of SortField objects
+ * @returns Sort string
+ */
+export function buildSortString(fields) {
+    return fields
+        .map(({ field, direction }) => {
+        return direction === 'desc' ? `-${field}` : field;
+    })
+        .join(',');
+}
+//# sourceMappingURL=sorting.js.map

package/dist/sorting.js.map

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

package/dist/structured-fields.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Structured Field Values per RFC 8941.
+ * RFC 8941 §3, §4.
+ */
+import type { SfItem, SfList, SfDictionary } from './types.js';
+/**
+ * Parse a Structured Field List.
+ */
+export declare function parseSfList(value: string): SfList | null;
+/**
+ * Parse a Structured Field Dictionary.
+ */
+export declare function parseSfDict(value: string): SfDictionary | null;
+/**
+ * Parse a Structured Field Item.
+ */
+export declare function parseSfItem(value: string): SfItem | null;
+/**
+ * Serialize a Structured Field List.
+ */
+export declare function serializeSfList(list: SfList): string;
+/**
+ * Serialize a Structured Field Dictionary.
+ */
+export declare function serializeSfDict(dict: SfDictionary): string;
+/**
+ * Serialize a Structured Field Item.
+ */
+export declare function serializeSfItem(item: SfItem): string;
+//# sourceMappingURL=structured-fields.d.ts.map

package/dist/structured-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-fields.d.ts","sourceRoot":"","sources":["../src/structured-fields.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAc,MAAM,EAAe,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAiXxF;;GAEG;AAEH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUxD;AAED;;GAEG;AAEH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAU9D;AAED;;GAEG;AAEH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUxD;AAqED;;GAEG;AAEH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED;;GAEG;AAEH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAoB1D;AAED;;GAEG;AAEH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/structured-fields.js

@@ -0,0 +1,468 @@
+/**
+ * Structured Field Values per RFC 8941.
+ * RFC 8941 §3, §4.
+ */
+import { Buffer } from 'node:buffer';
+// RFC 8941 §3.3.4: sf-token allows ALPHA (case-insensitive), digits, and tchar plus : and /
+const TOKEN_RE = /^[A-Za-z*][A-Za-z0-9!#$%&'*+\-.^_`|~:\/]*$/;
+const BASE64_RE = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;
+const KEY_RE = /^[a-z*][a-z0-9_\-\.\*]*$/;
+class Parser {
+    input;
+    index;
+    constructor(input) {
+        this.input = input;
+        this.index = 0;
+    }
+    eof() {
+        return this.index >= this.input.length;
+    }
+    peek() {
+        return this.input[this.index] ?? '';
+    }
+    consume() {
+        return this.input[this.index++] ?? '';
+    }
+    skipOWS() {
+        while (!this.eof()) {
+            const char = this.peek();
+            if (char === ' ' || char === '\t') {
+                this.consume();
+            }
+            else {
+                break;
+            }
+        }
+    }
+    isAtEnd() {
+        this.skipOWS();
+        return this.eof();
+    }
+    parseItem() {
+        const value = this.parseBareItem();
+        if (value === null) {
+            return null;
+        }
+        const params = this.parseParameters();
+        return params ? { value, params } : { value };
+    }
+    parseInnerList() {
+        if (this.peek() !== '(') {
+            return null;
+        }
+        this.consume();
+        const items = [];
+        this.skipOWS();
+        while (!this.eof() && this.peek() !== ')') {
+            const item = this.parseItem();
+            if (!item) {
+                return null;
+            }
+            items.push(item);
+            this.skipOWS();
+        }
+        if (this.peek() !== ')') {
+            return null;
+        }
+        this.consume();
+        const params = this.parseParameters();
+        return params ? { items, params } : { items };
+    }
+    parseList() {
+        const list = [];
+        while (true) {
+            this.skipOWS();
+            if (this.eof()) {
+                break;
+            }
+            const member = this.peek() === '(' ? this.parseInnerList() : this.parseItem();
+            if (!member) {
+                return null;
+            }
+            list.push(member);
+            this.skipOWS();
+            if (this.eof()) {
+                break;
+            }
+            if (this.peek() === ',') {
+                this.consume();
+                continue;
+            }
+            return null;
+        }
+        return list;
+    }
+    parseDictionary() {
+        const dict = {};
+        while (true) {
+            this.skipOWS();
+            if (this.eof()) {
+                break;
+            }
+            const key = this.parseKey();
+            if (!key) {
+                return null;
+            }
+            this.skipOWS();
+            let value;
+            if (this.peek() === '=') {
+                this.consume();
+                this.skipOWS();
+                if (this.peek() === '(') {
+                    const list = this.parseInnerList();
+                    if (!list) {
+                        return null;
+                    }
+                    value = list;
+                }
+                else {
+                    const item = this.parseItem();
+                    if (!item) {
+                        return null;
+                    }
+                    value = item;
+                }
+            }
+            else {
+                const params = this.parseParameters();
+                value = params ? { value: true, params } : { value: true };
+            }
+            dict[key] = value;
+            this.skipOWS();
+            if (this.eof()) {
+                break;
+            }
+            if (this.peek() === ',') {
+                this.consume();
+                continue;
+            }
+            return null;
+        }
+        return dict;
+    }
+    parseParameters() {
+        const params = {};
+        while (true) {
+            this.skipOWS();
+            if (this.peek() !== ';') {
+                break;
+            }
+            this.consume();
+            this.skipOWS();
+            const key = this.parseKey();
+            if (!key) {
+                return null;
+            }
+            let value = true;
+            this.skipOWS();
+            if (this.peek() === '=') {
+                this.consume();
+                this.skipOWS();
+                const bare = this.parseBareItem();
+                if (bare === null) {
+                    return null;
+                }
+                value = bare;
+            }
+            params[key] = value;
+        }
+        return Object.keys(params).length > 0 ? params : null;
+    }
+    parseBareItem() {
+        if (this.eof()) {
+            return null;
+        }
+        const char = this.peek();
+        if (char === '"') {
+            return this.parseString();
+        }
+        if (char === '?') {
+            return this.parseBoolean();
+        }
+        if (char === ':') {
+            return this.parseByteSequence();
+        }
+        if (char === '-' || (char >= '0' && char <= '9')) {
+            return this.parseNumber();
+        }
+        return this.parseToken();
+    }
+    parseKey() {
+        let key = '';
+        while (!this.eof()) {
+            const char = this.peek();
+            if (!/[a-z0-9_\-\.\*]/.test(char)) {
+                break;
+            }
+            key += char;
+            this.consume();
+        }
+        if (!key || !KEY_RE.test(key)) {
+            return null;
+        }
+        return key;
+    }
+    // RFC 8941 §3.3.3: String bare item.
+    parseString() {
+        if (this.consume() !== '"') {
+            return null;
+        }
+        let result = '';
+        while (!this.eof()) {
+            const char = this.consume();
+            if (char === '"') {
+                return result;
+            }
+            if (char === '\\') {
+                if (this.eof()) {
+                    return null;
+                }
+                const escapedChar = this.consume();
+                // RFC 8941 §3.3.3: Only \" and \\ are valid escape sequences.
+                if (escapedChar !== '"' && escapedChar !== '\\') {
+                    return null;
+                }
+                result += escapedChar;
+            }
+            else {
+                // RFC 8941 §3.3.3: Validate unescaped chars are printable ASCII (excluding " and \).
+                const code = char.charCodeAt(0);
+                if (code < 0x20 || code > 0x7E || code === 0x22 || code === 0x5C) {
+                    return null;
+                }
+                result += char;
+            }
+        }
+        return null;
+    }
+    // RFC 8941 §3.3.6: Boolean bare item.
+    parseBoolean() {
+        if (this.consume() !== '?') {
+            return null;
+        }
+        const char = this.consume();
+        if (char === '1') {
+            return true;
+        }
+        if (char === '0') {
+            return false;
+        }
+        return null;
+    }
+    // RFC 8941 §3.3.5: Byte sequence bare item.
+    parseByteSequence() {
+        if (this.consume() !== ':') {
+            return null;
+        }
+        let base64 = '';
+        while (!this.eof()) {
+            const char = this.consume();
+            if (char === ':') {
+                try {
+                    if (base64.includes('\n') || base64.includes('\r')) {
+                        return null;
+                    }
+                    if (!BASE64_RE.test(base64)) {
+                        return null;
+                    }
+                    if (base64.length % 4 !== 0) {
+                        return null;
+                    }
+                    const buffer = Buffer.from(base64, 'base64');
+                    return new Uint8Array(buffer);
+                }
+                catch {
+                    return null;
+                }
+            }
+            base64 += char;
+        }
+        return null;
+    }
+    // RFC 8941 §3.3.1: Numeric bare item.
+    parseNumber() {
+        const remaining = this.input.slice(this.index);
+        const match = remaining.match(/^(-?)(\d+)(?:\.(\d{1,3}))?/);
+        if (!match) {
+            return null;
+        }
+        const integerPart = match[2] ?? '';
+        const fractionalPart = match[3];
+        if (fractionalPart !== undefined) {
+            if (integerPart.length > 12) {
+                return null;
+            }
+            if (fractionalPart.length > 3) {
+                return null;
+            }
+        }
+        else if (integerPart.length > 15) {
+            return null;
+        }
+        this.index += match[0].length;
+        const value = Number(match[0]);
+        if (!Number.isFinite(value)) {
+            return null;
+        }
+        return value;
+    }
+    // RFC 8941 §3.3.4: Token parsing.
+    parseToken() {
+        let token = '';
+        while (!this.eof()) {
+            const char = this.peek();
+            // RFC 8941 §3.3.4: tchar plus ":" and "/"
+            if (!/[A-Za-z0-9!#$%&'*+\-.^_`|~:\/]/.test(char)) {
+                break;
+            }
+            token += char;
+            this.consume();
+        }
+        if (!token || !TOKEN_RE.test(token)) {
+            return null;
+        }
+        return token;
+    }
+}
+/**
+ * Parse a Structured Field List.
+ */
+// RFC 8941 §3.1: Structured Field List.
+export function parseSfList(value) {
+    const parser = new Parser(value);
+    const list = parser.parseList();
+    if (!list) {
+        return null;
+    }
+    if (!parser.isAtEnd()) {
+        return null;
+    }
+    return list;
+}
+/**
+ * Parse a Structured Field Dictionary.
+ */
+// RFC 8941 §3.2: Structured Field Dictionary.
+export function parseSfDict(value) {
+    const parser = new Parser(value);
+    const dict = parser.parseDictionary();
+    if (!dict) {
+        return null;
+    }
+    if (!parser.isAtEnd()) {
+        return null;
+    }
+    return dict;
+}
+/**
+ * Parse a Structured Field Item.
+ */
+// RFC 8941 §3.3: Structured Field Item.
+export function parseSfItem(value) {
+    const parser = new Parser(value.trim());
+    const item = parser.parseItem();
+    if (!item) {
+        return null;
+    }
+    if (!parser.isAtEnd()) {
+        return null;
+    }
+    return item;
+}
+// RFC 8941 §4: Structured Field serialization.
+function serializeBareItem(value) {
+    if (typeof value === 'boolean') {
+        return value ? '?1' : '?0';
+    }
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value)) {
+            throw new Error('Invalid numeric structured field value');
+        }
+        if (Number.isInteger(value)) {
+            // RFC 8941 §4.1.4: Integer range check.
+            if (value < -999_999_999_999_999 || value > 999_999_999_999_999) {
+                throw new Error('Integer out of range for structured field');
+            }
+            return String(value);
+        }
+        let encoded = value.toFixed(3);
+        encoded = encoded.replace(/0+$/, '');
+        if (encoded.endsWith('.')) {
+            encoded = encoded.slice(0, -1);
+        }
+        return encoded;
+    }
+    if (value instanceof Uint8Array) {
+        const base64 = Buffer.from(value).toString('base64');
+        return `:${base64}:`;
+    }
+    if (TOKEN_RE.test(value)) {
+        return value;
+    }
+    const escaped = value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+    return `"${escaped}"`;
+}
+function serializeParams(params) {
+    if (!params) {
+        return '';
+    }
+    const parts = [];
+    for (const [key, value] of Object.entries(params)) {
+        if (value === true) {
+            parts.push(`;${key}`);
+        }
+        else {
+            parts.push(`;${key}=${serializeBareItem(value)}`);
+        }
+    }
+    return parts.join('');
+}
+function serializeItem(item) {
+    const base = serializeBareItem(item.value);
+    return base + serializeParams(item.params);
+}
+function serializeInnerList(list) {
+    const items = list.items.map(serializeItem).join(' ');
+    return `(${items})${serializeParams(list.params)}`;
+}
+/**
+ * Serialize a Structured Field List.
+ */
+// RFC 8941 §4: Structured Field List serialization.
+export function serializeSfList(list) {
+    return list.map(member => {
+        if ('items' in member) {
+            return serializeInnerList(member);
+        }
+        return serializeItem(member);
+    }).join(', ');
+}
+/**
+ * Serialize a Structured Field Dictionary.
+ */
+// RFC 8941 §4: Structured Field Dictionary serialization.
+export function serializeSfDict(dict) {
+    const parts = [];
+    for (const [key, value] of Object.entries(dict)) {
+        if ('items' in value) {
+            parts.push(`${key}=${serializeInnerList(value)}`);
+            continue;
+        }
+        const item = value;
+        const isBareTrue = item.value === true && !item.params;
+        if (isBareTrue) {
+            parts.push(key);
+            continue;
+        }
+        parts.push(`${key}=${serializeItem(item)}`);
+    }
+    return parts.join(', ');
+}
+/**
+ * Serialize a Structured Field Item.
+ */
+// RFC 8941 §4: Structured Field Item serialization.
+export function serializeSfItem(item) {
+    return serializeItem(item);
+}
+//# sourceMappingURL=structured-fields.js.map