@johntalton/http-util 5.1.6 → 6.0.0

package/README.md

@@ -6,7 +6,7 @@ Set of utilities to aid in building from-scratch [node:http2](https://nodejs.org
 - [Stream Response methods](#response)
 - [Body parser](#body)
 
-## Header Parsers
+## Header Parsers / Encoders
 ### From Client:
 - Accept Encoding - `parse` and `select` based on server/client values
 - Accept Language - `parse` and `select`
@@ -17,10 +17,21 @@ Set of utilities to aid in building from-scratch [node:http2](https://nodejs.org
 - Multipart - parse into `FormData`
 - Content Disposition - for use inside of Multipart
 - Conditionals - Etag / FixDate for IfMatch, IfModifiedSince etc
+- Client Hints
+- Forwarded
+- Applied Preferences
 
 ### Server Sent:
 - Rate Limit
 - Server Timing
+- Cache Control
+- Clear Site Data
+- Conditional (Etag / IMF Date)
+- Content Range
+- Preferences
+- WWW Auth
+- STS
+
 
 
 ```javascript
@@ -49,11 +60,12 @@ All responders take in a `stream` as well as a metadata object to hint on server
 - [`sendContentTooLarge`](#)
 - [`sendCreated`](#responsecreated)
 - [`sendError`](#responseerror) - 500
-- [`sendGone`](#)
+- [`sendForbidden`](#responseforbidden)
+- [`sendGone`](#responsegone)
 - [`sendImATeapot`](#)
 - [`sendInsufficientStorage`](#)
 - [`sendJSON_Encoded`](#responsejson) - Standard Ok response with encoding
-- [`sendMovedPermanently`](#)
+- [`sendMovedPermanently`](#responsemovedpermanently)
 - [`sendMultipleChoices`](#)
 - [`sendNoContent`](#responsenocontent)
 - [`sendNotAcceptable`](#responsenotacceptable)
@@ -62,9 +74,10 @@ All responders take in a `stream` as well as a metadata object to hint on server
 - [`sendNotImplemented`](#responsenotimplemented)
 - [`sendNotModified`](#responsenotmodified)
 - [`sendPartialContent`](#)
+- [`sendPermanentRedirect`](#)
 - [`sendPreconditionFailed`](#responsepreconditionfailed)
 - [`sendPreflight`](#responsepreflight) - Response to OPTIONS with CORS headers
-- [`sendRangeNotSatisfiable`](#)
+- [`sendRangeNotSatisfiable`](#responserangenotsatisfiable)
 - [`sendSeeOther`](#)
 - [`sendTemporaryRedirect`](#)
 - [`sendTimeout`](#responsetimeout)
@@ -145,8 +158,8 @@ Parameters:
 
 Parameters:
 - stream
-- location
-- etag
+- location - URL to newly create object
+- etag - etag of the related object
 - meta
 
 Additional Exposed Headers:
@@ -158,6 +171,27 @@ Parameters:
 - stream
 - meta
 
+### Response.forbidden
+
+Parameters:
+- stream
+- meta
+
+### Response.gone
+
+Parameters:
+- stream
+- meta
+
+### Response.movedPermanently
+
+Parameters:
+- steam
+- location
+- meta
+
+Additional Exposed Headers:
+- location
 
 ### Response.json
 
@@ -186,7 +220,7 @@ Parameters:
 
 Parameters:
 - stream
-- supportedTypes
+- supportedTypes - array of supported types (mime/lang/encodings etc)
 - meta
 
 ### Response.notAllowed
@@ -237,10 +271,22 @@ Parameters:
 - stream
 - methods
 - supportedQueryTypes - undefined | Array of supported types
+- acceptRanges
 - meta
 
 Additional Exposed Headers:
 - accept-query
+- accept-ranges
+
+### Response.rangeNotSatisfiable
+
+Parameters:
+- stream
+- directive - specify size of acceptable range of bytes
+- meta
+
+Additional Exposed Headers:
+- content-range
 
 ### Response.sse
 
@@ -282,6 +328,7 @@ Parameters:
 
 Parameters:
 - stream
+- challenge
 - meta
 
 

package/package.json

@@ -1,18 +1,24 @@
 {
   "name": "@johntalton/http-util",
-  "version": "5.1.6",
+  "version": "6.0.0",
   "license": "MIT",
   "type": "module",
+  "imports": {
+    "#util": "./src/headers/util/index.js"
+  },
   "exports": {
-    ".": "./src/index.js",
-    "./headers": "./src/index.js",
+    ".": "./src/headers/index.js",
+    "./headers": "./src/headers/index.js",
     "./body": "./src/body.js",
     "./response": "./src/response/index.js",
-    "./response/object": "./src/response/response.js"
+    "./response/object": "./src/response/response.js",
+    "./util": "./src/headers/util/index.js"
   },
   "files": [
     "src/*.js",
-    "src/response/*.js"
+    "src/response/**/*.js",
+    "src/headers/*.js",
+    "src/headers/util/*.js"
   ],
   "repository": {
     "url": "https://github.com/johntalton/http-util"

package/src/body.js

@@ -2,28 +2,28 @@ import {
 	CHARSET_UTF8,
 	MIME_TYPE_MULTIPART_FORM_DATA,
 	MIME_TYPE_URL_FORM_DATA
-} from './content-type.js'
-import { Multipart } from './multipart.js'
+} from './headers/content-type.js'
+import { Multipart } from './headers/multipart.js'
 
 export const BYTE_PER_K = 1024
 export const DEFAULT_BYTE_LIMIT = BYTE_PER_K * BYTE_PER_K //
 
 /** @import { Readable } from 'node:stream' */
-/** @import { ContentType } from './content-type.js' */
+/** @import { ContentTypeItem } from './headers/content-type.js' */
 
 /**
  * @typedef {Object} BodyOptions
  * @property {AbortSignal|undefined} [signal]
  * @property {number|undefined} [byteLimit]
  * @property {number|undefined} [contentLength]
- * @property {ContentType|undefined} [contentType]
+ * @property {ContentTypeItem|undefined} [contentType]
  */
 
 /**
  * @typedef {Object} BodyFuture
  * @property {number} duration
  * @property {ReadableStream} body
- * @property {ContentType|undefined} contentType
+ * @property {ContentTypeItem|undefined} contentType
  * @property { (mimetype: string) => Promise<Blob> } blob
  * @property { () => Promise<ArrayBufferLike> } arrayBuffer
  * @property { () => Promise<Uint8Array> } bytes
@@ -277,7 +277,7 @@ export async function bodyJSON(reader, charset) {
 
 /**
  * @param {ReadableStream} reader
- * @param {ContentType} contentType
+ * @param {ContentTypeItem} contentType
  */
 export async function _bodyFormData_Multipart(reader, contentType) {
 	const MULTIPART_FORM_DATA_BOUNDARY_PARAMETER = 'boundary'
@@ -291,7 +291,7 @@ export async function _bodyFormData_Multipart(reader, contentType) {
 
 /**
  * @param {ReadableStream} reader
- * @param {ContentType} contentType
+ * @param {ContentTypeItem} contentType
  */
 export async function _bodyFormData_URL(reader, contentType) {
 	const text = await bodyText(reader, contentType.charset)
@@ -307,7 +307,7 @@ export async function _bodyFormData_URL(reader, contentType) {
 
 /**
  * @param {ReadableStream} reader
- * @param {ContentType|undefined} contentType
+ * @param {ContentTypeItem|undefined} contentType
  */
 export async function bodyFormData(reader, contentType) {
 	if(contentType === undefined) { throw new Error('undefined content type for form data') }

package/src/{response/defs.js → defs.js}

@@ -26,7 +26,7 @@ export const RANGE_UNITS_BYTES = 'bytes'
 /** @type {'none'} */
 export const RANGE_UNITS_NONE = 'none'
 
-/** @import { TimingsInfo } from '../server-timing.js' */
+/** @import { TimingsInfo } from './headers/server-timing.js' */
 
 /**
  * @typedef {`X-${string}`} CustomHeaderKey
@@ -46,3 +46,4 @@ export const RANGE_UNITS_NONE = 'none'
  * @property {boolean} [bom]
  */
 
+/** @typedef {ArrayBufferLike|ArrayBufferView|ReadableStream|string} SendBody */

package/src/{accept-encoding.js → headers/accept-encoding.js}

@@ -1,6 +1,6 @@
-import { parseAcceptStyleHeader } from './accept-util.js'
+import { parseAcceptStyleHeader } from './util/accept-util.js'
 
-/** @import { AcceptStyleItem } from './accept-util.js' */
+/** @import { AcceptStyleItem } from './util/accept-util.js' */
 
 export const WELL_KNOWN_ENCODINGS = new Map([
 	[ 'gzip, deflate, br, zstd', [ { name: 'gzip' }, { name: 'deflate' }, { name: 'br' }, { name: 'zstd' } ] ],

package/src/{accept-language.js → headers/accept-language.js}

@@ -1,12 +1,11 @@
-import { parseAcceptStyleHeader } from './accept-util.js'
+import { parseAcceptStyleHeader } from './util/accept-util.js'
 
-/**
- * @import { AcceptStyleItem } from './accept-util.js'
- */
+/** @import { AcceptStyleItem } from './util/accept-util.js' */
 
 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 } ] ]
+	[ 'en-US,en;q=0.9', [ { name: 'en-US', quality: 1 }, { name: 'en', quality: 0.9 } ] ],
+	// [ '*', [ { name: '*', quality: 1 } ]]
 ])
 
 export class AcceptLanguage {

package/src/{accept.js → headers/accept.js}

@@ -1,22 +1,10 @@
-import { parseAcceptStyleHeader } from './accept-util.js'
+import { parseAcceptStyleHeader } from './util/accept-util.js'
+import { MIME_ANY, Mime } from './util/mime.js'
 
-/**
- * @import { AcceptStyleItem } from './accept-util.js'
- */
+/** @import { AcceptStyleItem } from './util/accept-util.js' */
+/** @import { MimeItem } from './util/mime.js' */
 
-/**
- * @typedef {Object} AcceptExtensionItem
- * @property {string} mimetype
- * @property {string} type
- * @property {string} subtype
- */
-
-/**
- * @typedef {AcceptStyleItem & AcceptExtensionItem} AcceptItem
- */
-
-export const ACCEPT_SEPARATOR = { SUBTYPE: '/' }
-export const ACCEPT_ANY = '*'
+/** @typedef {AcceptStyleItem & MimeItem} AcceptItem */
 
 export const WELL_KNOWN = new Map([
 	[ '*/*', [ { name: '*/*', quality: 1 } ] ],
@@ -31,22 +19,23 @@ export class Accept {
 	static parse(acceptHeader) {
 		return parseAcceptStyleHeader(acceptHeader, WELL_KNOWN)
 			.map(({ name, quality, parameters }) => {
-				const [ type, subtype ] = name
-					.split(ACCEPT_SEPARATOR.SUBTYPE)
-					.map(t => t.trim())
+
+				const mime = Mime.parse(name)
+				if(mime === undefined) { return undefined }
 
 				return {
-					mimetype: `${type}${ACCEPT_SEPARATOR.SUBTYPE}${subtype ?? ACCEPT_ANY}`,
-					name, type, subtype,
+					name,
+					...mime,
 					quality,
 					parameters
 				}
 			})
+			.filter(entry => entry !== undefined)
 			.sort((entryA, entryB) => {
 				if(entryA.quality === entryB.quality) {
 					// prefer things with less ANY
-					const specificityA = (entryA.type === ACCEPT_ANY ? 1 : 0) + (entryA.subtype === ACCEPT_ANY ? 1 : 0)
-					const specificityB = (entryB.type === ACCEPT_ANY ? 1 : 0) + (entryB.subtype === ACCEPT_ANY ? 1 : 0)
+					const specificityA = (entryA.type === MIME_ANY ? 1 : 0) + (entryA.subtype === MIME_ANY ? 1 : 0)
+					const specificityB = (entryB.type === MIME_ANY ? 1 : 0) + (entryB.subtype === MIME_ANY ? 1 : 0)
 					return specificityA - specificityB
 				}
 
@@ -74,8 +63,9 @@ export class Accept {
 		const bests = accepts.map(accept => {
 			const { type, subtype, quality } = accept
 			const st = supportedTypes.filter(supportedType => {
-				const [ stType, stSubtype ] = supportedType.split(ACCEPT_SEPARATOR.SUBTYPE)
-				return ((stType === type || type === ACCEPT_ANY) && (stSubtype === subtype || subtype === ACCEPT_ANY))
+				const supportedMime = Mime.parse(supportedType)
+				if(supportedMime === undefined) { return false }
+				return ((supportedMime.type === type || type === MIME_ANY) && (supportedMime.subtype === subtype || subtype === MIME_ANY))
 			})
 
 			return {
@@ -95,6 +85,8 @@ 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,

package/src/headers/client-hints.js

@@ -0,0 +1,81 @@
+
+
+export const CLIENT_HINT_USER_AGENT = 'Sec-CH-UA'
+export const CLIENT_HINT_ARCHITECTURE = 'Sec-CH-UA-Arch'
+export const CLIENT_HINT_BITNESS = 'Sec-CH-UA-Bitness'
+export const CLIENT_HINT_FORM_FACTORS = 'Sec-CH-UA-Form-Factors'
+// export const CLIENT_HINT_ = 'Sec-CH-UA-Full-Version'
+export const CLIENT_HINT_VERSION_LIST = 'Sec-CH-UA-Full-Version-List'
+export const CLIENT_HINT_MOBILE = 'Sec-CH-UA-Mobile'
+export const CLIENT_HINT_MODEL = 'Sec-CH-UA-Model'
+export const CLIENT_HINT_PLATFORM = 'Sec-CH-UA-Platform'
+export const CLIENT_HINT_PLATFORM_VERSION = 'Sec-CH-UA-Platform-Version'
+export const CLIENT_HINT_WOW64 = 'Sec-CH-UA-WoW64'
+export const CLIENT_HINT_PREFERS_COLOR_SCHEME = 'Sec-CH-Prefers-Color-Scheme'
+export const CLIENT_HINT_PREFERS_REDUCED_MOTION = 'Sec-CH-Prefers-Reduced-Motion'
+export const CLIENT_HINT_PREFERS_REDUCED_TRANSPARENCY = 'Sec-CH-Prefers-Reduced-Transparency'
+export const CLIENT_HINT_DEVICE_MEMORY = 'Sec-CH-Device-Memory'
+export const CLIENT_HINT_DEVICE_PIXEL_RATIO = 'Sec-CH-DPR'
+export const CLIENT_HINT_VIEWPORT_HEIGHT = 'Sec-CH-Viewport-Height'
+export const CLIENT_HINT_VIEWPORT_WIDTH = 'Sec-CH-Viewport-Width'
+export const CLIENT_HINT_IMAGE_WIDTH = 'Sec-CH-Width'
+export const CLIENT_HINT_DOWNLINK = 'Downlink'
+export const CLIENT_HINT_EFFECTIVE_CONNECTION_TYPE = 'ECT'
+export const CLIENT_HINT_ROUND_TRIP_TIME = 'RTT'
+export const CLIENT_HINT_SAVE_DATA = 'Save-Data'
+export const CLIENT_HINT_GLOBAL_PRIVACY_CONTROL = 'Sec-GPC'
+
+export const KNOWN_CLIENT_HINTS = [
+	CLIENT_HINT_USER_AGENT,
+	CLIENT_HINT_ARCHITECTURE,
+	CLIENT_HINT_BITNESS,
+	CLIENT_HINT_FORM_FACTORS,
+	CLIENT_HINT_VERSION_LIST,
+	CLIENT_HINT_MOBILE,
+	CLIENT_HINT_MODEL,
+	CLIENT_HINT_PLATFORM,
+	CLIENT_HINT_PLATFORM_VERSION,
+	CLIENT_HINT_WOW64,
+	CLIENT_HINT_PREFERS_COLOR_SCHEME,
+	CLIENT_HINT_PREFERS_REDUCED_MOTION,
+	CLIENT_HINT_PREFERS_REDUCED_TRANSPARENCY,
+	CLIENT_HINT_DEVICE_MEMORY,
+	CLIENT_HINT_DEVICE_PIXEL_RATIO,
+	CLIENT_HINT_VIEWPORT_HEIGHT,
+	CLIENT_HINT_VIEWPORT_WIDTH,
+	CLIENT_HINT_IMAGE_WIDTH,
+	CLIENT_HINT_DOWNLINK,
+	CLIENT_HINT_EFFECTIVE_CONNECTION_TYPE,
+	CLIENT_HINT_ROUND_TRIP_TIME,
+	CLIENT_HINT_SAVE_DATA,
+	CLIENT_HINT_GLOBAL_PRIVACY_CONTROL
+]
+
+export const KNOWN_FORM_FACTORS = [
+	'Desktop',
+	'Automotive',
+	'Mobile',
+	'Tablet',
+	'XR',
+	'EInk',
+	'Watch'
+]
+
+export const CLIENT_HINT_TRUE = '?1'
+export const CLIENT_HINT_FALSE = '?0'
+
+
+export class ClientHints {
+
+	/**
+	 * @param {Array<String>} hints
+	 */
+	static encode(hints) {
+		return hints
+			.filter(hint => KNOWN_CLIENT_HINTS.includes(hint))
+			.join(', ')
+	}
+}
+
+
+

package/src/{conditional.js → headers/conditional.js}

@@ -1,4 +1,4 @@
-import { isQuoted, stripQuotes } from './quote.js'
+import { isQuoted, stripQuotes } from './util/quote.js'
 
 /**
  * @typedef {Object} WeakEtagItem
@@ -54,25 +54,34 @@ export const MINIMUM_YEAR = 1900
 export const MAXIMUM_DAY = 31
 
 /**
+ * @deprecated
+ * @see {@link ETag.isValid}
  * @param {string} etag
  */
 export function isValidEtag(etag) {
-	// %x21 / %x23-7E  and %x80-FF
-	for(const c of etag) {
-		if(c.charCodeAt(0) < 0x21) { return false }
-		if(c.charCodeAt(0) > 0xFF) { return false }
-		if(c === ETAG_QUOTE) { return false }
-	}
-	return true
+	return ETag.isValid(etag)
 }
 
 export class ETag {
+	/**
+	 * @param {string} etag
+	 */
+	static isValid(etag) {
+		// %x21 / %x23-7E  and %x80-FF
+		for(const c of etag) {
+			if(c.charCodeAt(0) < 0x21) { return false }
+			if(c.charCodeAt(0) > 0xFF) { return false }
+			if(c === ETAG_QUOTE) { return false }
+		}
+		return true
+	}
+
 	/**
 	 * @param {string} etag
 	 * @returns {WeakEtagItem}
 	 */
 	static weak(etag) {
-		if(!isValidEtag(etag)) { throw new Error('invalid etag format') }
+		if(!ETag.isValid(etag)) { throw new Error('invalid etag format') }
 		return { any: false, weak: true, etag }
 	}
 
@@ -81,7 +90,7 @@ export class ETag {
 	 * @returns {NotWeakEtagItem}
 	 */
 	static strong(etag) {
-		if(!isValidEtag(etag)) { throw new Error('invalid etag format') }
+		if(!ETag.isValid(etag)) { throw new Error('invalid etag format') }
 		return { any: false, weak: false, etag }
 	}
 
@@ -106,7 +115,7 @@ export class ETag {
 		if(!isQuoted(quotedEtag)) { return undefined }
 		const etag = stripQuotes(quotedEtag)
 		if(etag === undefined) { return undefined }
-		if(!isValidEtag(etag)) { return undefined }
+		if(!ETag.isValid(etag)) { return undefined }
 		if(etag === CONDITION_ETAG_ANY) { return undefined }
 
 		return {
@@ -130,7 +139,7 @@ export class Conditional {
 		}
 
 		if(etagItem.etag === CONDITION_ETAG_ANY) { return undefined }
-		if(!isValidEtag(etagItem.etag)) { return undefined }
+		if(!ETag.isValid(etagItem.etag)) { return undefined }
 
 		const prefix = etagItem.weak ? CONDITION_ETAG_WEAK_PREFIX : ''
 		return `${prefix}${ETAG_QUOTE}${etagItem.etag}${ETAG_QUOTE}`

package/src/{content-disposition.js → headers/content-disposition.js}

@@ -1,3 +1,5 @@
+import { KVP } from './util/kvp.js'
+
 /**
  * @typedef {Object} Disposition
  * @property {string} disposition
@@ -6,39 +8,38 @@
  * @property {string|undefined} [filename]
  */
 
-export const DISPOSITION_SEPARATOR = {
-	PARAMETER: ';',
-	KVP: '='
-}
-
 export const DISPOSITION_PARAM_NAME = 'name'
 export const DISPOSITION_PARAM_FILENAME = 'filename'
 
 /**
+ * @deprecated
+ * @see {@link ContentDisposition.parse}
  * @param {string|undefined} contentDispositionHeader
  * @returns {Disposition|undefined}
  */
 export function parseContentDisposition(contentDispositionHeader) {
-	if(contentDispositionHeader === undefined) { return undefined }
-
-	const [ disposition, ...parameterSet ] = contentDispositionHeader.trim().split(DISPOSITION_SEPARATOR.PARAMETER).map(entry => entry.trim())
-	if(disposition === undefined) { return undefined }
-	const parameters = new Map(parameterSet.map(parameter => {
-			const [ key, value ] = parameter.split(DISPOSITION_SEPARATOR.KVP).map(p => p.trim())
-			if(key === undefined) { return undefined }
-			return { key, value }
-		})
-		.filter(item => item !== undefined)
-		.map(({ key, value }) => ([ key, value ])))
-
-
-	const name = parameters.get(DISPOSITION_PARAM_NAME)
-	const filename = parameters.get(DISPOSITION_PARAM_FILENAME)
-
-	return {
-		disposition,
-		parameters,
-		name, filename
+	return ContentDisposition.parse(contentDispositionHeader)
+}
+
+export class ContentDisposition {
+	/**
+	 * @param {string|undefined} header
+	 * @returns {Disposition|undefined}
+	 */
+	static parse(header) {
+		if(header === undefined) { return undefined }
+
+		const { name: disposition, parameters } = KVP.parse(header) ?? { parameters: new Map() }
+		if(disposition === undefined) { return undefined }
+
+		const name = parameters.get(DISPOSITION_PARAM_NAME)
+		const filename = parameters.get(DISPOSITION_PARAM_FILENAME)
+
+		return {
+			disposition,
+			parameters,
+			name, filename
+		}
 	}
 }
 

package/src/{content-range.js → headers/content-range.js}

@@ -1,4 +1,4 @@
-import { RANGE_UNITS_BYTES } from "./response/defs.js"
+import { RANGE_UNITS_BYTES } from '../defs.js'
 
 export const CONTENT_RANGE_UNKNOWN = '*'
 export const CONTENT_RANGE_SEPARATOR = '-'

package/src/headers/content-type.js

@@ -0,0 +1,101 @@
+import { KVP } from './util/kvp.js'
+import { MIME_ANY, Mime } from './util/mime.js'
+
+/** @import { MimeItem } from './util/mime.js' */
+
+export const MIME_TYPE_JSON = 'application/json'
+export const MIME_TYPE_TEXT = 'text/plain'
+export const MIME_TYPE_EVENT_STREAM = 'text/event-stream'
+export const MIME_TYPE_XML = 'application/xml'
+export const MIME_TYPE_URL_FORM_DATA = 'application/x-www-form-urlencoded'
+export const MIME_TYPE_MULTIPART_FORM_DATA = 'multipart/form-data'
+export const MIME_TYPE_MULTIPART_RANGE = 'multipart/byteranges'
+export const MIME_TYPE_OCTET_STREAM = 'application/octet-stream'
+export const MIME_TYPE_MESSAGE_HTTP = 'message/http'
+
+
+export const KNOWN_CONTENT_TYPES = [
+	'application', 'audio', 'image', 'message',
+	'multipart','text', 'video'
+]
+
+export const TYPE_X_TOKEN_PREFIX = 'X-'
+
+/**
+ * @typedef {Object} ContentTypeExtension
+ * @property {string} name
+ * @property {string} [charset]
+ * @property {Map<string, string>} parameters
+ */
+
+/** @typedef {MimeItem & ContentTypeExtension} ContentTypeItem */
+
+export const CONTENT_TYPE_SEPARATOR = {
+	SUBTYPE: '/',
+	PARAMETER: ';',
+	KVP: '='
+}
+
+export const CHARSET_UTF8 = 'utf8'
+export const CHARSET = 'charset'
+export const PARAMETER_CHARSET_UTF8 = `${CHARSET}${CONTENT_TYPE_SEPARATOR.KVP}${CHARSET_UTF8}`
+export const CONTENT_TYPE_JSON = `${MIME_TYPE_JSON}${CONTENT_TYPE_SEPARATOR.PARAMETER}${PARAMETER_CHARSET_UTF8}`
+export const CONTENT_TYPE_TEXT = `${MIME_TYPE_TEXT}${CONTENT_TYPE_SEPARATOR.PARAMETER}${PARAMETER_CHARSET_UTF8}`
+export const CONTENT_TYPE_MESSAGE_HTTP = `${MIME_TYPE_MESSAGE_HTTP}${CONTENT_TYPE_SEPARATOR.PARAMETER}${PARAMETER_CHARSET_UTF8}`
+
+/** @type {ContentTypeItem} */
+export const WELL_KNOWN_JSON = {
+	mimetype: MIME_TYPE_JSON,
+	name: MIME_TYPE_JSON,
+	type: 'application',
+	subtype: 'json',
+	charset: 'utf8',
+	parameters: new Map()
+}
+
+export const WELL_KNOWN_CONTENT_TYPES = new Map([
+	[ 'application/json', WELL_KNOWN_JSON ],
+	[ 'application/json;charset=utf8', WELL_KNOWN_JSON ]
+])
+
+/**
+ * @deprecated
+ * @see {@link ContentType.parse}
+ * @param {string|undefined} contentTypeHeader
+ * @returns {ContentTypeItem|undefined}
+ */
+export function parseContentType(contentTypeHeader) {
+	return ContentType.parse(contentTypeHeader)
+}
+
+export class ContentType {
+	/**
+	 * @param {string|undefined} header
+	 * @returns {ContentTypeItem|undefined}
+	 */
+	static parse(header) {
+		if(header === undefined) { return undefined }
+		if(header === null) { return undefined }
+
+		const wellKnown = WELL_KNOWN_CONTENT_TYPES.get(header)
+		if(wellKnown !== undefined) { return wellKnown }
+
+		const { name, parameters } = KVP.parse(header) ?? { parameters: new Map() }
+		if(name === undefined) { return undefined }
+
+		const mimetype = Mime.parse(name)
+		if(mimetype === undefined) { return undefined }
+
+		if(mimetype.type === MIME_ANY) { return undefined }
+		if(mimetype.subtype === MIME_ANY) { return undefined }
+
+		const charset = parameters?.get(CHARSET)
+
+		return {
+			...mimetype,
+			name,
+			charset,
+			parameters
+		}
+	}
+}