@johntalton/http-util 6.0.0 → 6.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@johntalton/http-util",
-  "version": "6.0.0",
+  "version": "6.1.0",
   "license": "MIT",
   "type": "module",
   "imports": {
@@ -20,10 +20,24 @@
     "src/headers/*.js",
     "src/headers/util/*.js"
   ],
+  "scripts": {
+    "lint": "biome check",
+    "test": "node --test test/**/*.test.js",
+    "coverage": "c8 --src src --check-coverage --statements 90 --branches 90 --functions 90 --lines 90 -r lcovonly -r text node --test   test/**/*.test.js"
+  },
   "repository": {
     "url": "https://github.com/johntalton/http-util"
   },
   "dependencies": {
     "@johntalton/sse-util": "^1.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.15",
+    "c8": "^11.0.0"
+  },
+  "overrides": {
+    "c8": {
+      "yargs": "^18.0.0"
+    }
   }
-}
+}

package/src/defs.js

@@ -26,7 +26,14 @@ export const RANGE_UNITS_BYTES = 'bytes'
 /** @type {'none'} */
 export const RANGE_UNITS_NONE = 'none'
 
+
 /** @import { TimingsInfo } from './headers/server-timing.js' */
+/** @import { EtagItem, IMFFixDateInput,  } from './headers/conditional.js' */
+/** @import { CacheControlOptions } from './headers/cache-control.js' */
+/** @import { ContentRangeDirective } from './headers/content-range.js' */
+/** @import { RateLimitPolicyInfo, RateLimitInfo } from './headers/rate-limit.js' */
+
+/** @typedef {RANGE_UNITS_BYTES | RANGE_UNITS_NONE} AcceptRangeUnits */
 
 /**
  * @typedef {`X-${string}`} CustomHeaderKey
@@ -46,4 +53,30 @@ export const RANGE_UNITS_NONE = 'none'
  * @property {boolean} [bom]
  */
 
-/** @typedef {ArrayBufferLike|ArrayBufferView|ReadableStream|string} SendBody */
+/** @typedef {ArrayBufferLike|ArrayBufferView|ReadableStream|string} SendBody */
+
+/**
+ * @typedef {Object} SendContent
+ * @property {string|undefined} contentType
+ * @property {number|undefined} contentLength
+ * @property {string|undefined} encoding
+ * @property {EtagItem|undefined} etag
+ * @property {IMFFixDateInput|string|undefined} lastModified
+ * @property {number|undefined} age
+ * @property {CacheControlOptions} cacheControl
+ * @property {ContentRangeDirective} rangeDirective
+ */
+
+/**
+ * @typedef {Object} SendInfo
+ * @property {Array<string>} supportedMethods
+ * @property {Array<string>|string} supportedTypes
+ * @property {Array<string>|string} acceptableMediaType
+ * @property {AcceptRangeUnits|undefined} acceptRanges
+ * @property {Array<string>|undefined} supportedQueryTypes
+ * @property {RateLimitInfo} limitInfo
+ * @property {Array<RateLimitPolicyInfo>} policies
+ * @property {number|undefined} retryAfter
+ */
+
+

package/src/headers/accept-encoding.js

@@ -2,6 +2,8 @@ import { parseAcceptStyleHeader } from './util/accept-util.js'
 
 /** @import { AcceptStyleItem } from './util/accept-util.js' */
 
+export const ENCODING_ANY = '*'
+
 export const WELL_KNOWN_ENCODINGS = new Map([
 	[ 'gzip, deflate, br, zstd', [ { name: 'gzip' }, { name: 'deflate' }, { name: 'br' }, { name: 'zstd' } ] ],
 	[ 'gzip, deflate, br', [ { name: 'gzip' }, { name: 'deflate' }, { name: 'br' } ] ]
@@ -29,6 +31,8 @@ export class AcceptEncoding {
 	 * @param {Array<string>} supportedTypes
 	 */
 	static selectFrom(acceptEncodings, supportedTypes) {
+		if(supportedTypes === undefined) { return undefined }
+
 		for(const acceptEncoding of acceptEncodings) {
 			const { name } = acceptEncoding
 			if(supportedTypes.includes(name)) {
@@ -36,18 +40,11 @@ export class AcceptEncoding {
 			 }
 		}
 
+		//
+		if(acceptEncodings.some(item => item.name === ENCODING_ANY)) {
+			return supportedTypes.at(0)
+		}
+
 		return undefined
 	}
 }
-
-
-// console.log(AcceptEncoding.parse(''))
-// console.log(AcceptEncoding.parse(' '))
-// console.log(AcceptEncoding.parse('zstd'))
-// console.log(AcceptEncoding.parse('identity'))
-// console.log(AcceptEncoding.parse('*'))
-// console.log(AcceptEncoding.parse('gzip, deflate, br, zstd'))
-// console.log(AcceptEncoding.parse('br;q=1.0, gzip;q=0.8, *;q=0.1'))
-// console.log(AcceptEncoding.parse('deflate, gzip;q=1.0, *;q=0.5'))
-// console.log(AcceptEncoding.parse('identity;q=0'))
-// console.log(AcceptEncoding.parse('*;q=0'))

package/src/headers/accept-language.js

@@ -2,6 +2,8 @@ import { parseAcceptStyleHeader } from './util/accept-util.js'
 
 /** @import { AcceptStyleItem } from './util/accept-util.js' */
 
+export const LANGUAGE_ANY = '*'
+
 export const WELL_KNOWN_LANGUAGES = new Map([
 	[ 'en-US,en;q=0.5', [ { name: 'en-US', quality: 1 }, { name: 'en', quality: 0.5 } ] ],
 	[ 'en-US,en;q=0.9', [ { name: 'en-US', quality: 1 }, { name: 'en', quality: 0.9 } ] ],
@@ -30,16 +32,20 @@ export class AcceptLanguage {
 	 * @param {Array<string>} supportedTypes
 	 */
 	static selectFrom(acceptLanguages, supportedTypes) {
+		if(supportedTypes === undefined) { return undefined }
+
 		for(const acceptLanguage of acceptLanguages) {
 			const { name } = acceptLanguage
 			if(supportedTypes.includes(name)) {
 				return name
-				}
+			}
+		}
+
+		//
+		if(acceptLanguages.some(item => item.name === LANGUAGE_ANY)) {
+			return supportedTypes.at(0)
 		}
 
 		return undefined
 	}
 }
-
-// console.log(AcceptLanguage.parse('en-US,en;q=0.9'))
-// console.log(AcceptLanguage.select('foo;q=0.2, bar-BZ', [ 'bang', 'foo' ]))

package/src/headers/accept.js

@@ -83,32 +83,4 @@ export class Accept {
 	}
 }
 
-// console.log(Accept.parse('text/html, application/xhtml+xml, application/xml;q=0.9, image/webp, text/*;q=.8, */*;q=0.7'))
-// console.log(Accept.select('text/html, application/xhtml+xml, application/xml;q=0.9, image/webp, text/*;q=.8, */*;q=0.7', [ 'application/json', 'text/plain' ]))
-// console.log(Accept.parse('*'))
-
-
-// const tests = [
-// 	undefined,
-// 	'',
-// 	'	',
-// 	' fake',
-// 	'    application/json',
-// 	' application/xml,',
-// 	' ,application/xml   ,,',
-// 	' audio/*; q=0.2, audio/basic',
-// 	' text/html, application/xhtml+xml, application/xml;q=0.9, image/webp, */*;q=0.8',
-// 	' text/*;q=0.3, text/plain;q=0.7, text/plain;format=flowed,\ntext/plain;format=fixed;q=0.4, */*;q=0.5',
-
-// 	' */*, foo/bar, foo/*, biz/bang, */*;q=.2, quix/quak;q=.1',
-// 	'foo / bar ; q = .5'
-// ]
-
-// tests.forEach(test => {
-// 	const result = Accept.parse(test)
-// 	console.log('=============================')
-// 	console.log({ test })
-// 	console.log('---')
-// 	console.log(result)
-// })
 

package/src/headers/cache-control.js

@@ -54,9 +54,3 @@ export class CacheControl {
 		return result.join(', ')
 	}
 }
-
-// console.log(CacheControl.encode({
-// 	priv: true,
-// 	maxAge: 60,
-// 	directives: ['must-revalidate', 'no-transform']
-// }))

package/src/headers/clear-site-data.js

@@ -42,18 +42,12 @@ export class SiteData {
 		if(directives.prerenderCache === true) { result.push(CSD_DIRECTIVE_PRERENDER_CACHE) }
 		if(directives.storage === true) { result.push(CSD_DIRECTIVE_STORAGE) }
 
+		if(result.length === 0) {
+			return undefined
+		}
+
 		return result
 			.map(item => `${CSD_QUOTE}${item}${CSD_QUOTE}`)
 			.join(CSD_DIRECTIVE_SEPARATOR)
 	}
 }
-
-// console.log(SiteData.encode())
-// console.log(SiteData.encode({}))
-// console.log(SiteData.encode(false))
-// console.log(SiteData.encode('true'))
-// console.log(SiteData.encode(true))
-// console.log(SiteData.encode('*'))
-// console.log(SiteData.encode({ storage: false }))
-// console.log(SiteData.encode({ storage: true }))
-// console.log(SiteData.encode({ storage: true, cookies: true }))

package/src/headers/client-hints.js

@@ -71,9 +71,16 @@ export class ClientHints {
 	 * @param {Array<String>} hints
 	 */
 	static encode(hints) {
-		return hints
+		if(hints === undefined) { return undefined }
+		if(!Array.isArray(hints)) { return undefined }
+		if(hints.length === 0) { return undefined }
+
+		const remaining = hints
 			.filter(hint => KNOWN_CLIENT_HINTS.includes(hint))
-			.join(', ')
+
+		if(remaining.length === 0) { return undefined }
+
+		return remaining.join(', ')
 	}
 }
 

package/src/headers/conditional.js

@@ -1,3 +1,5 @@
+/** biome-ignore-all lint/nursery/noExcessiveClassesPerFile: includes helper classes */
+/** biome-ignore-all lint/nursery/noExcessiveLinesPerFile: includes temporal and date support */
 import { isQuoted, stripQuotes } from './util/quote.js'
 
 /**
@@ -24,7 +26,7 @@ import { isQuoted, stripQuotes } from './util/quote.js'
 /** @typedef {WeakEtagItem | NotWeakEtagItem | AnyEtagItem } EtagItem */
 
 /**
- * @typedef {Object} IMFFixDate
+ * @typedef {Object} IMFFixDateItem
  * @property {typeof DATE_DAYS[number]} dayName
  * @property {number} day
  * @property {typeof DATE_MONTHS[number]} month
@@ -32,8 +34,39 @@ import { isQuoted, stripQuotes } from './util/quote.js'
  * @property {number} hour
  * @property {number} minute
  * @property {number} second
+ */
+
+/**
+ * @typedef {Object} IMFFixDateItemExtension
  * @property {Date|undefined} [date]
+ * @property {Temporal.Instant|undefined} [instant]
+ */
+
+/** @typedef {IMFFixDateItem & IMFFixDateItemExtension} IMFFixDate */
+/** @typedef {IMFFixDate|Date|Temporal.Instant|undefined} IMFFixDateInput */
+
+export const FEATURE_TEMPORAL = typeof Temporal !== 'undefined'
+
+export const IMF_FIX_DATE_FORMATTER = new Intl.DateTimeFormat('en-US', {
+	timeZone: 'UTC',
+	weekday: 'short',
+	year: 'numeric',
+	month: 'short',
+	day: '2-digit',
+	hour: '2-digit',
+	minute: '2-digit',
+	second: '2-digit',
+	hour12: false
+})
+
+/**
+ * @param {IMFFixDate|Date|Temporal.Instant|undefined} reference
+ * @returns {reference is Temporal.Instant}
  */
+export function isTemporalInstant(reference) {
+	if(!FEATURE_TEMPORAL) { return false }
+	return reference instanceof Temporal.Instant
+}
 
 export const CONDITION_ETAG_SEPARATOR = ','
 export const CONDITION_ETAG_ANY = '*'
@@ -67,6 +100,8 @@ export class ETag {
 	 * @param {string} etag
 	 */
 	static isValid(etag) {
+		if(etag === undefined) { return false }
+
 		// %x21 / %x23-7E  and %x80-FF
 		for(const c of etag) {
 			if(c.charCodeAt(0) < 0x21) { return false }
@@ -115,8 +150,9 @@ export class ETag {
 		if(!isQuoted(quotedEtag)) { return undefined }
 		const etag = stripQuotes(quotedEtag)
 		if(etag === undefined) { return undefined }
+		if(etag === '') { return undefined }
+		if(etag === CONDITION_ETAG_ANY) { return ANY_ETAG_ITEM } // todo: should this return undefined?
 		if(!ETag.isValid(etag)) { return undefined }
-		if(etag === CONDITION_ETAG_ANY) { return undefined }
 
 		return {
 			weak,
@@ -126,6 +162,100 @@ export class ETag {
 	}
 }
 
+export class FixDate {
+
+	/**
+	 * True if {@link test} is after (exclusive) the {@link reference}
+	 * (compares are seconds precision)
+	 * @param {IMFFixDateInput} reference
+	 * @param {IMFFixDateInput} test
+	 * @returns {boolean}
+	 */
+	static isAfter(reference, test) {
+		if(reference === undefined) { return false }
+		if(test === undefined) { return false }
+
+		if(FEATURE_TEMPORAL) {
+			/** @type {Temporal.RoundingOptions<Temporal.TimeUnit>} */
+			const precision = {
+				smallestUnit: 'second',
+				roundingMode: 'trunc'
+			}
+
+			const referenceInstant = FixDate.toInstant(reference)?.round(precision)
+			const testInstant = FixDate.toInstant(test)?.round(precision)
+
+			if(referenceInstant === undefined) { return false }
+			if(testInstant === undefined) { return false }
+
+			return Temporal.Instant.compare(referenceInstant, testInstant) === -1
+		}
+
+		//
+		const referenceDate = FixDate.toDate(reference)
+		const testDate = FixDate.toDate(test)
+
+		if(referenceDate === undefined) { return false }
+		if(testDate === undefined) { return false }
+
+		// this effectively rounds to seconds
+		referenceDate.setMilliseconds(0)
+		testDate.setMilliseconds(0)
+
+		return testDate > referenceDate
+	}
+
+	/**
+	 * @param {IMFFixDateInput} reference
+	 * @returns {Temporal.Instant|undefined}
+	 */
+	static toInstant(reference) {
+		if(!FEATURE_TEMPORAL) { return undefined }
+		if(reference === undefined) { return undefined }
+
+		if(isTemporalInstant(reference)) { return reference }
+		if(reference instanceof Date) { return reference.toTemporalInstant() }
+
+		if(reference.instant !== undefined) { return reference.instant }
+		if(reference.date !== undefined) { return reference.date.toTemporalInstant() }
+
+		const { year, month: monthName, day, hour, minute, second } = reference
+
+		const zeroMonth = DATE_MONTHS.indexOf(monthName)
+		if(zeroMonth === -1) { return undefined }
+		const month = zeroMonth + 1
+
+		const zdt = Temporal.ZonedDateTime.from({
+			year,
+			month,
+			day,
+			hour,
+			minute,
+			second,
+			timeZone: 'UTC'
+		})
+
+		return zdt.toInstant()
+	}
+
+	/**
+	 * @param {IMFFixDateInput} reference
+	 * @returns {Date|undefined}
+	 */
+	static toDate(reference) {
+		if(reference === undefined) { return undefined }
+
+		if(reference instanceof Date) { return reference }
+		if(isTemporalInstant(reference)) { return new Date(reference.epochMilliseconds) }
+
+		if(FEATURE_TEMPORAL && (reference.instant !== undefined)) { return new Date(reference.instant.epochMilliseconds) }
+		if(reference.date !== undefined) { return reference.date }
+
+		const { year, month, day, hour, minute, second } = reference
+		return new Date(Date.UTC(year, DATE_MONTHS.indexOf(month), day, hour, minute, second))
+	}
+}
+
 export class Conditional {
 	/**
 	 * @param {EtagItem|undefined} etagItem
@@ -158,29 +288,47 @@ export class Conditional {
 	}
 
 	/**
-	 * @param {Array<EtagItem>} etagItemList
+	 * @param {Array<EtagItem>|undefined} etagItemList
 	 */
 	static hasAny(etagItemList) {
-		return etagItemList.find(item => item.any) !== undefined
+		return etagItemList?.find(item => item.any) !== undefined
 	}
 
 	/**
-	 * @param {Array<EtagItem>} etagItemList
-	 * @param {string} etag
+	 * @param {Array<EtagItem>|undefined} etagItemList
+	 * @param {string|undefined} etag
 	 */
 	static hasEtag(etagItemList, etag) {
-		return etagItemList.find(item => item.etag === etag) !== undefined
+		return etagItemList?.find(item => item.etag === etag) !== undefined
 	}
 
 	/**
-	 * @param {IMFFixDate|undefined} fixDate
+	 * @param {IMFFixDateInput|string|undefined} reference
 	 * @returns {string|undefined}
 	 */
-	static encodeFixDate(fixDate) {
-		if(fixDate === undefined) { return undefined }
-		if(fixDate.date !== undefined) { return fixDate.date.toUTCString() }
+	static encodeFixDate(reference) {
+		if(reference === undefined) { return undefined }
+
+		if(typeof reference === 'string') { return reference }
+		if(reference instanceof Date) { return reference.toUTCString() }
+		if(isTemporalInstant(reference)) {
+
+			const parts = IMF_FIX_DATE_FORMATTER.formatToParts(reference)
+			const m = new Map(parts.map(p => [ p.type, p.value ]))
+			const weekday = m.get('weekday') ?? 'ERR'
+			const day = m.get('day') ?? '00'
+			const month = m.get('month') ?? '00'
+			const year = m.get('year') ?? '0000'
+			const hour = m.get('hour') ?? '00'
+			const minute = m.get('minute') ?? '00'
+			const second = m.get('second') ?? '00'
+
+			return `${weekday}, ${day} ${month} ${year} ${hour}:${minute}:${second} ${DATE_ZONE}`
+		}
+
+		if(reference.date !== undefined) { return reference.date.toUTCString() }
 
-		const { year, month, day, hour, minute, second } = fixDate
+		const { year, month, day, hour, minute, second } = reference
 		const d = new Date(Date.UTC(year, DATE_MONTHS.indexOf(month), day, hour, minute, second))
 		return d.toUTCString()
 	}
@@ -250,105 +398,21 @@ export class Conditional {
 		if(minute > 60 || minute < 0) { return undefined }
 		if(second > 60 || second < 0) { return undefined }
 
-		//
-		return {
+		const fixDate = {
 			dayName,
 			day,
 			month,
 			year,
 			hour,
 			minute,
-			second,
-			date: new Date(Date.UTC(year, DATE_MONTHS.indexOf(month), day, hour, minute, second)),
-			// temporal:
+			second
+		}
+
+		//
+		return {
+			...fixDate,
+			date: FixDate.toDate(fixDate),
+			instant: FixDate.toInstant(fixDate)
 		}
 	}
 }
-
-// Ok
-// console.log(Conditional.encodeEtag({ any: true, weak: false, etag: '*' }))
-// console.log(Conditional.encodeEtag({ any: true, weak: true, etag: '*' }))
-// console.log(Conditional.encodeEtag({ any: false, weak: false, etag: 'Foo' }))
-// console.log(Conditional.encodeEtag({ any: false, weak: true, etag: 'WeakFoo' }))
-
-// Error
-// console.log(Conditional.encodeEtag(undefined))
-// console.log(Conditional.encodeEtag({ any: true, weak: false, etag: 'NotAsterisk' }))
-// console.log(Conditional.encodeEtag({ any: false, weak: false, etag: 'Foo\tBar' }))
-// console.log(Conditional.encodeEtag({ any: false, weak: false, etag: 'Foo"Bar' }))
-// console.log(Conditional.encodeEtag({ any: false, weak: false, etag: '*' }))
-
-
-// Ok
-// console.log(Conditional.parseEtagList('"bfc13a64729c4290ef5b2c2730249c88ca92d82d"'))
-// console.log(Conditional.parseEtagList('W/"67ab43", "54ed21", "7892dd"'))
-// console.log(Conditional.parseEtagList('*'))
-// console.log(Conditional.parseEtagList('"!ÿ©"'))
-// console.log(Conditional.parseEtagList('"!","ÿ", "©"'))
-// console.log(Conditional.parseEtagList('"!","ÿ"   ,\t"©"'))
-
-// Error
-// console.log(Conditional.parseEtagList('"*"'))
-// console.log(Conditional.parseEtagList('W/'))
-// console.log(Conditional.parseEtagList('W/"'))
-// console.log(Conditional.parseEtagList('W/""'))
-// console.log(Conditional.parseEtagList(''))
-// console.log(Conditional.parseEtagList('"'))
-// console.log(Conditional.parseEtagList('""'))
-// console.log(Conditional.parseEtagList('"""'))
-// console.log(Conditional.parseEtagList('" "'))
-// console.log(Conditional.parseEtagList('"\n"'))
-// console.log(Conditional.parseEtagList('"\t"'))
-
-//
-// const testsOk = [
-// 	'Sun, 06 Nov 1994 08:49:37 GMT',
-// 	'Sun, 06 Nov 1994 00:00:00 GMT',
-// 	'Tue, 01 Nov 1994 00:00:00 GMT',
-// 	'Thu, 06 Nov 3000 08:49:37 GMT',
-// 	'Sun, 06 Nov 1994 23:59:59 GMT',
-// 	new String('Sun, 06 Nov 1994 08:49:37 GMT'),
-// ]
-// for(const test of testsOk) {
-// 	const result = Conditional.parseFixDate(test)
-// 	if(result?.date.toUTCString() !== test.toString()) {
-// 		console.log('🛑', test, result, result?.date.toUTCString())
-// 		break
-// 	}
-// }
-
-
-
-// const testBad = [
-// 	undefined,
-// 	null,
-// 	{},
-// 	new String(),
-// 	'',
-// 	'Anything',
-// 	'   ,               :  :   GMT',
-// 	'Sun,    Nov        :  :   GMT',
-// 	'Sun, 00 Nov 0000 00:00:00 GMT',
-// 	'Sun, 06 Nov 1994 08-49-37 GMT',
-// 	'Sun  06 Nov 1994 08:49:37 GMT',
-// 	'FOO, 06 Nov 1994 08:49:37 GMT',
-// 	'Sun, 32 Nov 1994 08:49:37 GMT',
-// 	'Sun, 00 Nov 1994 08:49:37 GMT',
-// 	'Sun, 06 Nov 0900 08:49:37 GMT',
-// 	'Sun, 06 Nov 1994 08:49:37 UTC',
-// 	'Sun, 06 Nov 1994 30:49:37 GMT',
-// 	'Sun,\t06 Nov 1994 08:49:37 GMT',
-
-// 	'Sunday, 06-Nov-94 08:49:37 GMT',
-// 	'Sun Nov  6 08:49:37 1994',
-// 	'Sun Nov  6 08:49:37 1994      ',
-
-// ]
-// for(const test of testBad) {
-// 	const result = Conditional.parseFixDate(test)
-// 	if(result !== undefined) {
-// 		console.log('🛑', test, result)
-// 		break
-// 	}
-// }
-

package/src/headers/content-disposition.js

@@ -42,17 +42,3 @@ export class ContentDisposition {
 		}
 	}
 }
-
-// console.log(parseContentDisposition())
-// // console.log(parseContentDisposition(null))
-// console.log(parseContentDisposition(''))
-// console.log(parseContentDisposition('form-data'))
-// console.log(parseContentDisposition('    form-data ; name'))
-// console.log(parseContentDisposition('form-data; name="key"'))
-
-// console.log(parseContentDisposition('inline'))
-// console.log(parseContentDisposition('attachment'))
-// console.log(parseContentDisposition('attachment; filename="file name.jpg"'))
-// console.log(parseContentDisposition('attachment; filename*=UTF-8\'\'file%20name.jpg'))
-// console.log(parseContentDisposition('attachment; filename*=UTF-8\'\'file%20name.jpg'))
-// console.log(parseContentDisposition('form-data;title*=us-ascii\'en-us\'This%20is%20%2A%2A%2Afun%2A%2A%2A'))

package/src/headers/content-range.js

@@ -40,20 +40,3 @@ export class ContentRange {
 		return `${units} ${rangeStr}${CONTENT_RANGE_SIZE_SEPARATOR}${size}`
 	}
 }
-
-// console.log(ContentRange.encode({}))
-// console.log(ContentRange.encode({ size: '*' }))
-// console.log(ContentRange.encode({ units: 'bytes' }))
-// console.log(ContentRange.encode({ range: '*' }))
-// console.log(ContentRange.encode({ range: '*', size: '*' }))
-
-// console.log()
-// console.log(ContentRange.encode({ range: { start: 0, end: 1024 } }))
-// console.log(ContentRange.encode({ range: { start: 0, end: 1024 }, size: 1024  }))
-// console.log(ContentRange.encode({ range: '*', size: 1024 }))
-// console.log(ContentRange.encode({ size: 1024 }))
-
-// console.log()
-// console.log(ContentRange.encode({ units: 'bob' }))
-// console.log(ContentRange.encode({ range: 'bob' }))
-// console.log(ContentRange.encode({ size: 'bob' }))

package/src/headers/content-type.js

@@ -98,4 +98,4 @@ export class ContentType {
 			parameters
 		}
 	}
-}
+}

package/src/headers/forwarded.js

@@ -41,6 +41,8 @@ export class Forwarded {
 	 * @returns {Map<string, string>|undefined}
 	 */
 	static selectRightMost(forwardedList, skipList = []) {
+		if(forwardedList === undefined) { return undefined }
+
 		const iter = skipList[Symbol.iterator]()
 
 		for(const forwarded of forwardedList.toReversed()) {
@@ -54,39 +56,6 @@ export class Forwarded {
 	}
 }
 
-
-/*
-const examples = [
-	{ f: [], s: [], ef: undefined },
-
-	{ f: [], s: [ '1.1.1.1' ] , ef: undefined },
-	{ f: [], s: [ '*' ] , ef: undefined },
-
-	{ f: [ { for: '1.1.1.1' } ], s: [], ef: '1.1.1.1' },
-	{ f: [ { for: '1.1.1.1' } ], s: [ '*' ], ef: undefined },
-	{ f: [ { for: '1.1.1.1' }, { for: '2.2.2.2' } ], s: [], ef: '2.2.2.2' },
-	{ f: [ { for: '1.1.1.1' }, { for: '2.2.2.2' } ], s: [ '2.2.2.2' ], ef: '1.1.1.1' },
-	{ f: [ { for: '1.1.1.1' }, { for: '2.2.2.2' }, { for: '3.3.3.3' } ], s: [ '3.3.3.3', '2.2.2.2' ], ef: '1.1.1.1' },
-	{ f: [ { for: '1.1.1.1' }, { for: '2.2.2.2' }, { for: '3.3.3.3' } ], s: [ '3.3.3.3', '*' ], ef: '1.1.1.1' },
-	{ f: [ { for: '1.1.1.1' }, { for: '2.2.2.2' }, { for: '3.3.3.3' } ], s: [ '*', '*' ], ef: '1.1.1.1' },
-	{ f: [ { for: '1.1.1.1' }, { for: '2.2.2.2' }, { for: '3.3.3.3' } ], s: [ '*', '*', '*' ], ef: undefined },
-
-	{ f: [ { for: '1.1.1.1' } ], s: [ '*', '*' ], ef: undefined },
-
-	{ f: [ { for: '1.1.1.1' }, { for: '2.2.2.2' }, { for: '3.3.3.3' } ], s: [ '3.3.3.3'], ef: '2.2.2.2' },
-	{ f: [ { for: '1.1.1.1' }, { for: '2.2.2.2' }, { for: '3.3.3.3' } ], s: [ '*'], ef: '2.2.2.2' },
-]
-
-for(const { f, s, ef } of examples) {
-	const result = Forwarded.selectRightMost(f.map(i => new Map(Object.entries(i))), s)
-	const resultFor = result?.get('for')
-	if(resultFor !== ef) {
-		console.log(`mismatch ${ef} !== ${resultFor}`)
-	}
-}
-*/
-
-
 /*
 	const examples = [
 		null,