@johntalton/http-util 5.1.6 → 6.1.0

package/src/headers/link.js

@@ -0,0 +1,34 @@
+/**
+ * @typedef {Object} LinkItem
+ * @property {URL|string} url
+ * @property {string|undefined} [relation]
+ * @property {Map<string, string>|undefined} [parameters]
+ */
+
+export class Link {
+	/**
+	 * @param {LinkItem} link
+	 */
+	static  *#encode(link) {
+		const encodedUri = (link.url instanceof URL) ? link.url : encodeURI(link.url)
+
+		yield `<${encodedUri}>`
+		if(link.relation !== undefined) { yield `rel="${link.relation}"` }
+		if(link.parameters === undefined) { return }
+		for(const [ key, value ] of link.parameters) {
+			yield `${key}="${value}"`
+		}
+	}
+
+	/**
+	 * @param {Array<LinkItem>|LinkItem|undefined} links
+	 */
+	static encode(links) {
+		if(links === undefined) { return undefined }
+		const linkAry = Array.isArray(links) ? links : [ links ]
+		if(linkAry.length === 0) { return undefined }
+		return linkAry
+			.map(link => [ ...Link.#encode(link) ].join('; '))
+			.join(', ')
+	}
+}

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

@@ -1,11 +1,12 @@
 import { ReadableStream } from 'node:stream/web'
 
-import { parseContentDisposition } from './content-disposition.js'
+import { isQuoted, stripQuotes } from '../headers/util/quote.js'
+import { ContentDisposition } from './content-disposition.js'
 import { ContentRange } from './content-range.js'
-import { parseContentType } from './content-type.js'
+import { ContentType } from './content-type.js'
 
 /** @import { ContentRangeDirective } from './content-range.js' */
-/** @import { SendBody } from './response/send-util.js' */
+/** @import { SendBody } from '../defs.js' */
 
 /**
  * @typedef {Object} MultipartBytePart
@@ -49,11 +50,14 @@ export class Multipart {
 	 * @param {string} text
 	 * @param {string} boundary
 	 * @param {string} [_charset='utf8']
+	 * @returns {FormData}
 	 */
 	static parse_FormData(text, boundary, _charset = 'utf8') {
-		// console.log({ boundary, text })
 		const formData = new FormData()
 
+		if(text === undefined) { return formData }
+		if(boundary === undefined) { return formData }
+
 		if(text === '') {
 			// empty body
 			return formData
@@ -94,17 +98,16 @@ export class Multipart {
 					const name = rawName?.toLowerCase()
 					// console.log('header', name, value)
 					if(name === MULTIPART_HEADER.CONTENT_TYPE) {
-						const _contentType = parseContentType(value)
-						// console.log({ contentType })
+						const contentType = ContentType.parse(value)
+						//console.log({ contentType })
 					}
 					else if(name === MULTIPART_HEADER.CONTENT_DISPOSITION) {
-						const disposition = parseContentDisposition(value)
+						const disposition = ContentDisposition.parse(value)
 						if(disposition?.disposition !== DISPOSITION_FORM_DATA) {
 							throw new Error('disposition not form-data')
 						}
 
-						// todo: are names always quoted?
-						partName = disposition.name?.slice(1, -1)
+						partName = isQuoted(disposition.name) ? stripQuotes(disposition.name) : disposition.name
 					}
 					else {
 						// unsupported part header - ignore
@@ -150,6 +153,7 @@ export class Multipart {
 
 		return new ReadableStream({
 			type: 'bytes',
+			// async pull(controller) {},
 			async start(controller) {
 				const encoder = new TextEncoder()
 
@@ -158,9 +162,9 @@ export class Multipart {
 					controller.enqueue(encoder.encode(`${MULTIPART_HEADER.CONTENT_TYPE}: ${contentType}${MULTIPART_SEPARATOR}`))
 					controller.enqueue(encoder.encode(`${MULTIPART_HEADER.CONTENT_RANGE}: ${ContentRange.encode({ ...part.range, size: contentLength })}${MULTIPART_SEPARATOR}`))
 					controller.enqueue(encoder.encode(MULTIPART_SEPARATOR))
-					// controller.enqueue(encoder.encode(MULTIPART_SEPARATOR))
 
 					if(part.obj instanceof ReadableStream) {
+						// biome-ignore lint/performance/noAwaitInLoops: readable
 						for await (const chunk of part.obj) {
 							if(chunk instanceof ArrayBuffer || ArrayBuffer.isView(chunk)) {
 								controller.enqueue(chunk)
@@ -174,7 +178,10 @@ export class Multipart {
 							}
 						}
 					}
-					else if(part.obj instanceof ArrayBuffer || ArrayBuffer.isView(part.obj)) {
+					else if(part.obj instanceof ArrayBuffer) {
+						controller.enqueue(new Uint8Array(part.obj))
+					}
+					else if(ArrayBuffer.isView(part.obj)) {
 						controller.enqueue(part.obj)
 					}
 					else if(typeof part.obj === 'string'){
@@ -182,7 +189,7 @@ export class Multipart {
 					}
 					else {
 						// console.log('error', typeof part.obj, part.obj)
-						throw new Error('unknown part type')
+						controller.error(new Error('unknown part type'))
 					}
 
 					controller.enqueue(encoder.encode(MULTIPART_SEPARATOR))
@@ -190,7 +197,9 @@ export class Multipart {
 
 				controller.enqueue(encoder.encode(boundaryEnd))
 
-      	controller.close()
+				// controller.enqueue(encoder.encode(MULTIPART_SEPARATOR))
+
+				controller.close()
 			}
 		})
 	}

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

@@ -1,7 +1,8 @@
 // https://datatracker.ietf.org/doc/html/rfc7240
 // https://www.rfc-editor.org/rfc/rfc7240#section-3
 
-import { isQuoted, stripQuotes } from './quote.js'
+import { KVP } from './util/kvp.js'
+import { isQuoted, stripQuotes } from './util/quote.js'
 
 export const PREFERENCE_SEPARATOR = {
 	PREFERENCE: ',',
@@ -53,26 +54,13 @@ export class Preferences {
 
 		const preferences = new Map(header.split(PREFERENCE_SEPARATOR.PREFERENCE)
 			.map(pref => {
-				const [ kvp, ...params ] = pref.trim().split(PREFERENCE_SEPARATOR.PARAMS)
+				const { name: kvp, parameters } = KVP.parse(pref) ?? { parameters: new Map() }
 				const [ key, rawValue ] = kvp?.split(PREFERENCE_SEPARATOR.KVP) ?? []
 
 				if(key === undefined) { return {} }
 				const valueOrEmpty = isQuoted(rawValue) ? stripQuotes(rawValue) : rawValue
 				const value = (valueOrEmpty !== '') ? valueOrEmpty : undefined
 
-				const parameters = new Map(params
-					.map(param => {
-						const [ pKey, rawPValue ] = param.split(PREFERENCE_SEPARATOR.PARAM_KVP)
-						if(pKey === undefined) { return {} }
-						const trimmedRawPValue = rawPValue?.trim()
-						const pValueOrEmpty = isQuoted(trimmedRawPValue) ? stripQuotes(trimmedRawPValue) : trimmedRawPValue
-						const pValue = (pValueOrEmpty !== '') ? pValueOrEmpty : undefined
-						return { key: pKey.trim(), value: pValue }
-					})
-					.filter(item => item.key !== undefined)
-					.map(item => ([ item.key, item.value ]))
-				)
-
 				return { key, value, parameters }
 			})
 			.filter(item => item.key !== undefined)
@@ -140,46 +128,3 @@ export class AppliedPreferences {
 		return AppliedPreferences.#encode_Map(applied)
 	}
 }
-
-
-// console.log(AppliedPreferences.encode(undefined))
-// console.log(AppliedPreferences.encode({ }))
-// console.log(AppliedPreferences.encode({ wait: 10 }))
-// console.log(AppliedPreferences.encode({ asynchronous: undefined }))
-// console.log(AppliedPreferences.encode({ asynchronous: false }))
-// console.log(AppliedPreferences.encode({ asynchronous: true }))
-// console.log(AppliedPreferences.encode({ preferences: new Map([
-// 	[ 'respond-async', { value: undefined } ]
-// ]) }))
-// console.log(AppliedPreferences.encode({
-// 	asynchronous: false,
-// 	preferences: new Map([
-// 	[ 'respond-async', { value: 'fake' } ]
-// ]) }))
-// console.log(AppliedPreferences.encode({ asynchronous: true, wait: 100 }))
-// console.log(AppliedPreferences.encode({
-// 	representation: DIRECTIVE_REPRESENTATION_MINIMAL,
-// 	preferences: new Map([
-// 		['foo', { value: 'bar', parameters: new Map([ [ 'biz', 'bang' ] ]) } ],
-// 		[ 'fake', undefined ]
-// 	])
-// }))
-
-// console.log(Preferences.parse('handling=lenient, wait=100, respond-async'))
-// console.log(Preferences.parse(' foo; bar')?.preferences)
-// console.log(Preferences.parse(' foo; bar=""')?.preferences)
-// console.log(Preferences.parse(' foo=""; bar')?.preferences)
-// console.log(Preferences.parse(' foo =""; bar;biz; bang ')?.preferences)
-// console.log(Preferences.parse('return=minimal; foo="some parameter"')?.preferences)
-
-// console.log(Preferences.parse('timezone=America/Los_Angeles'))
-// console.log(Preferences.parse('return=headers-only'))
-// console.log(Preferences.parse('return=minimal'))
-// console.log(Preferences.parse('return=representation'))
-// console.log(Preferences.parse('respond-async, wait=10`'))
-// console.log(Preferences.parse('priority=5'))
-// console.log(Preferences.parse('foo; bar'))
-// console.log(Preferences.parse('foo; bar=""'))
-// console.log(Preferences.parse('foo=""; bar'))
-// console.log(Preferences.parse('handling=lenient, wait=100, respond-async'))
-// console.log(Preferences.parse('return=minimal; foo="some parameter"'))

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

@@ -1,4 +1,6 @@
-import { RANGE_UNITS_BYTES } from "./response/defs.js"
+import { RANGE_UNITS_BYTES } from '../defs.js'
+
+/** @import { AcceptRangeUnits } from '../defs.js' */
 
 export const RANGE_EQUAL = '='
 export const RANGE_SEPARATOR = '-'
@@ -32,7 +34,7 @@ export const RANGE_EMPTY = ''
 /**
  * @template RV
  * @typedef {Object} RangeDirective
- * @property {'bytes'|'none'|undefined} units
+ * @property {AcceptRangeUnits|undefined} units
  * @property {Array<RV>} ranges
  */
 
@@ -122,33 +124,3 @@ export class Range {
 		}
 	}
 }
-
-// console.log(Range.parse(''))
-// console.log(Range.parse('='))
-// console.log(Range.parse('foo'))
-// console.log(Range.parse('bytes'))
-// console.log(Range.parse('bytes='))
-// console.log(Range.parse('bytes=-'))
-// console.log(Range.parse('bytes=foo'))
-// console.log(Range.parse('bytes=0-foo'))
-// console.log(Range.parse('bytes=0-0xff'))
-// console.log()
-// console.log(Range.parse('bytes=1024-'))
-// console.log(Range.parse('bytes=-1024'))
-// console.log(Range.parse('bytes=0-1024'))
-// console.log()
-// console.log(Range.parse('bytes=0-0,-1'))
-// console.log(Range.parse('bytes=0-1024, -1024'))
-// console.log(Range.parse('bytes= 0-999, 4500-5499, -1000'))
-// console.log(Range.parse('bytes=500-600,601-999'))
-
-// console.log('------')
-// console.log(Range.normalize(Range.parse('bytes=1024-'), 5000))
-// console.log(Range.normalize(Range.parse('bytes=-1024'), 5000))
-// console.log(Range.normalize(Range.parse('bytes=0-1024'), 5000))
-// console.log(Range.normalize(Range.parse('bytes=0-0,-1'), 10000)) // 0 and 9999
-// console.log(Range.normalize(Range.parse('bytes=0-1024, -1024'), 5000))
-// console.log(Range.normalize(Range.parse('bytes= 0-999, 4500-5499, -1000'), 5000))
-// console.log(Range.normalize(Range.parse('bytes=500-600,601-999'), 5000))
-
-// console.log(Range.normalize(Range.parse('bytes=-500'), 10000)) // 9500-9999

package/src/{rate-limit.js → headers/rate-limit.js}

@@ -45,6 +45,7 @@ export class RateLimit {
 	 * @param {RateLimitInfo} limitInfo
 	 */
 	static from(limitInfo) {
+		if(limitInfo === undefined) { return undefined }
 		const { name, remaining, resetSeconds, partitionKey } = limitInfo
 
 		if(name === undefined || remaining === undefined) { return undefined }
@@ -61,8 +62,12 @@ export class RateLimitPolicy {
 	 */
 	static from(...policies) {
 		if(policies === undefined) { return undefined }
+		if(policies.length === 0) { return undefined }
 
-		return policies
+		const remainingPolicies = policies.filter(pol => pol !== undefined)
+		if(remainingPolicies.length === 0) { return undefined }
+
+		return remainingPolicies
 			.filter(policy => policy.name !== undefined && policy.quota !== undefined)
 			.map(policy => {
 				const {

package/src/{server-timing.js → headers/server-timing.js}

@@ -19,7 +19,7 @@ export const SERVER_TIMING_SEPARATOR = {
 
 export class ServerTiming {
 	/**
-	 * @param {Array<TimingsInfo>} timings
+	 * @param {Array<TimingsInfo>|undefined} timings
 	 */
 	static encode(timings) {
 		if(timings === undefined) { return undefined }
@@ -28,24 +28,11 @@ export class ServerTiming {
 		return timings
 			.map(({ name, duration, description }) => [
 					`${name}`,
-					description !== undefined ? `${SERVER_TIMING_KEY_DESCRIPTION}${SERVER_TIMING_SEPARATOR.KVP}"${description}"` : undefined,
-					duration !== undefined ? `${SERVER_TIMING_KEY_DURATION}${SERVER_TIMING_SEPARATOR.KVP}${Math.trunc(duration * 10) / 10}` : undefined
+					description === undefined ? undefined : `${SERVER_TIMING_KEY_DESCRIPTION}${SERVER_TIMING_SEPARATOR.KVP}"${description}"`,
+					duration === undefined ? undefined : `${SERVER_TIMING_KEY_DURATION}${SERVER_TIMING_SEPARATOR.KVP}${Math.trunc(duration * 10) / 10}`
 				]
 				.filter(item => item !== undefined)
 				.join(SERVER_TIMING_SEPARATOR.PARAMETER))
 			.join(SERVER_TIMING_SEPARATOR.METRIC)
 	}
 }
-
-
-// console.log(ServerTiming.encode([{ name: 'missedCache' }]))
-// console.log(ServerTiming.encode([{ name: 'cpu', duration: 2.4 }]))
-
-// // cache;desc="Cache Read";dur=23.2
-// console.log(ServerTiming.encode([{ name: 'cache', duration: 23.2, description: "Cache Read" }]))
-
-// // db;dur=53, app;dur=47.2
-// console.log(ServerTiming.encode([
-// 	{ name: 'db', duration: 54 },
-// 	{ name: 'app', duration: 47.2 }
-// ]))

package/src/headers/strict-transport-security.js

@@ -0,0 +1,39 @@
+
+
+export const STS_MAX_AGE = 'max-age'
+export const STS_INCLUDE_SUBDOMAIN = 'includeSubDomains'
+export const STS_PRELOAD = 'preload'
+
+export const STS_MIN_AGE_FOR_PRELOAD_SECS = 60 * 60 * 24 * 365 // 31536000
+
+
+/**
+ * @typedef {Object} StrictTransportSecurityOptions
+ * @property {number} maxAge
+ * @property {boolean|undefined} [includeSubDomains]
+ * @property {boolean|undefined} [preload]
+ */
+
+export class StrictTransportSecurity {
+	/**
+	 * @param {StrictTransportSecurityOptions} sts
+	 */
+	static *#encode(sts) {
+		if(!Number.isFinite(sts.maxAge)) {
+			throw new Error('invalid max-age')
+		}
+
+		const maxAge = sts.preload ? Math.max(STS_MIN_AGE_FOR_PRELOAD_SECS, sts.maxAge) : sts.maxAge
+		yield `${STS_MAX_AGE}=${maxAge}`
+		if(sts.includeSubDomains) { yield STS_INCLUDE_SUBDOMAIN }
+		if(sts.preload) { yield STS_PRELOAD }
+	}
+
+	/**
+	 * @param {StrictTransportSecurityOptions} sts
+	 */
+	static encode(sts) {
+		if(sts === undefined) { return undefined }
+		return [ ...StrictTransportSecurity.#encode(sts) ].join('; ')
+	}
+}

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

@@ -1,8 +1,8 @@
+import { KVP } from './kvp.js'
+
 export const QUALITY = 'q'
 export const SEPARATOR = {
-	MEDIA_RANGE: ',',
-	PARAMETER: ';',
-	KVP: '='
+	MEDIA_RANGE: ','
 }
 
 export const DEFAULT_QUALITY_STRING = '1'
@@ -29,16 +29,10 @@ export function parseAcceptStyleHeader(header, wellKnown) {
 		.trim()
 			.split(SEPARATOR.MEDIA_RANGE)
 			.map(mediaRange => {
-				const [ name, ...parametersSet ] = mediaRange
-					.trim()
-					.split(SEPARATOR.PARAMETER)
-
-				const parameters = new Map(parametersSet.map(parameter => {
-					const [ key, value ] = parameter.split(SEPARATOR.KVP).map(p => p.trim())
-					return [ key, value ]
-				}))
+				const { name, parameters } = KVP.parse(mediaRange) ?? { parameters: new Map() }
+				if(name === undefined) { return undefined }
+				if(name === '') { return undefined }
 
-				if(!parameters.has(QUALITY)) { parameters.set(QUALITY, DEFAULT_QUALITY_STRING) }
 				const quality = Number.parseFloat(parameters.get(QUALITY) ?? DEFAULT_QUALITY_STRING)
 
 				return {
@@ -47,9 +41,9 @@ export function parseAcceptStyleHeader(header, wellKnown) {
 					parameters
 				}
 			})
-			.filter(entry => entry.name !== undefined && entry.name !== '')
+			.filter(entry => entry !== undefined)
 			.sort((entryA, entryB) => {
 				// B - A descending order
 				return entryB.quality - entryA.quality
 			})
-}
+}

package/src/headers/util/index.js

@@ -0,0 +1,7 @@
+/** biome-ignore-all lint/performance/noBarrelFile: entry point */
+/** biome-ignore-all lint/performance/noReExportAll: entry point */
+export * from './accept-util.js'
+export * from './kvp.js'
+export * from './mime.js'
+export * from './quote.js'
+export * from './whitespace.js'

package/src/headers/util/kvp.js

@@ -0,0 +1,79 @@
+import { hasSpecialChar } from './mime.js'
+import { isQuoted, stripQuotes } from './quote.js'
+
+export const DEFAULT_DELIMITER = ';'
+export const KVP_DELIMITER = '='
+export const KVP_EMPTY = ''
+
+
+export class KVP {
+	/**
+	 * @param {Array<string>|undefined} params
+	 * @param {Array<string>|undefined} [acceptableKeys=undefined]
+	 */
+	static #parse(params, acceptableKeys = undefined) {
+		const parameters = new Map()
+
+		if(params === undefined) { return parameters }
+
+		for(const kvp of params) {
+			const [ rawKey, rawValue ] = kvp
+				.split(KVP_DELIMITER)
+				.map(p => p.trim())
+
+			if(rawKey === undefined) { continue }
+			if(rawKey === KVP_EMPTY) { continue }
+			const key = rawKey.toLowerCase()
+			if(hasSpecialChar(key)) { continue }
+
+			if(acceptableKeys !== undefined && !acceptableKeys.includes(key)) { continue }
+
+			const unquotedValue = isQuoted(rawValue) ? stripQuotes(rawValue) : rawValue
+			const value = unquotedValue === KVP_EMPTY ? undefined : unquotedValue
+
+			if(!parameters.has(key)) {
+				parameters.set(key, value)
+			}
+		}
+
+		return parameters
+	}
+
+	/**
+	 * @param {string|undefined} str
+	 * @param {Array<string>|undefined} [acceptableKeys=undefined]
+	 */
+	static parse(str, acceptableKeys = undefined, delimiter = DEFAULT_DELIMITER) {
+		if(str === undefined) { return undefined }
+		if(str === KVP_EMPTY) { return undefined }
+
+		const [ name, ...params ] = str
+			.trim()
+			.split(delimiter)
+			.map(p => p.trim())
+
+		const parameters = KVP.#parse(params, acceptableKeys)
+
+		return { name, parameters }
+	}
+
+	/**
+	 * @param {string|undefined} str
+	 * @param {Array<string>|undefined} [acceptableKeys=undefined]
+	 */
+	static parseParameters(str, acceptableKeys = undefined, delimiter = DEFAULT_DELIMITER) {
+		if(str === undefined) { return undefined }
+		if(str === KVP_EMPTY) { return undefined }
+
+		const params = str
+			.trim()
+			.split(delimiter)
+			.map(p => p.trim())
+
+		const parameters = KVP.#parse(params, acceptableKeys)
+
+		return { parameters }
+	}
+}
+
+

package/src/headers/util/mime.js

@@ -0,0 +1,77 @@
+
+/**
+ * @typedef {Object} MimeItem
+ * @property {string} mimetype
+ * @property {string} type
+ * @property {string} subtype
+ */
+
+export const MIME_SEPARATOR = { SUBTYPE: '/' }
+
+export const MIME_ANY = '*'
+
+//
+export const SPECIAL_CHARS = [
+	// special
+	'(', ')',
+	'<', '>',
+	'[', ']',
+	'{', '}',
+	'@', ',', ';', ':',
+	'\\', '"', '/', '?', '=', // '.',
+	// '%', // '!', '$', '&', // #  ^ * | ~ `
+	// space
+	' ', '\u000B', '\u000C',
+	// control
+	'\n', '\r', '\t'
+]
+
+/**
+ * @param {string|undefined} value
+ */
+export function hasSpecialChar(value) {
+	if(value === undefined) { return false }
+	for(const special of SPECIAL_CHARS) {
+		if(value.includes(special)) { return true }
+	}
+
+	return false
+}
+
+export class Mime {
+	/**
+	 * @param {string|undefined} name
+	 * @returns {MimeItem|undefined}
+	 */
+	static parse(name) {
+		// console.log('mime::parse', name)
+		if(name === undefined) { return undefined }
+		if(name === '') { return undefined }
+
+		const parts = name
+			.trim() // leading space of type and trailing of subtype
+			.split(MIME_SEPARATOR.SUBTYPE)
+			.map(t => t.toLowerCase()) // all type/subtypes should be lower
+
+		// protect against multiple slashes
+		if(parts.length > 2) { return undefined }
+
+		const [ type, candidateSubtype ] = parts
+
+		if(type === undefined) { return undefined }
+		if(type === '') { return undefined }
+		if(hasSpecialChar(type)) { return undefined }
+
+		// if(candidateSubtype === undefined) { return undefined }
+		// if(candidateSubtype === '') { return undefined }
+		if(hasSpecialChar(candidateSubtype)) { return undefined }
+
+		const subtype = (candidateSubtype === '') ? MIME_ANY : (candidateSubtype ?? MIME_ANY)
+
+		return {
+			mimetype: `${type}${MIME_SEPARATOR.SUBTYPE}${subtype}`,
+			type,
+			subtype
+		}
+	}
+}

package/src/headers/util/whitespace.js

@@ -0,0 +1,8 @@
+export const WHITESPACE_REGEX = /\s/
+
+/**
+ * @param {string} c
+ */
+export function isWhitespace(c){
+  return WHITESPACE_REGEX.test(c)
+}

package/src/{www-authenticate.js → headers/www-authenticate.js}

@@ -99,7 +99,7 @@ export class Challenge {
 			return `${key}=${value}`
 		})
 
-		const params = parameters !== undefined ? [ ...parameters ].join(',') : ''
+		const params = parameters === undefined ? '' : [ ...parameters ].join(',')
 
 		return `${challenge.scheme} ${params}`
 	}

package/src/response/{accepted.js → 2xx/accepted.js}

@@ -1,9 +1,9 @@
 import http2 from 'node:http2'
 
-import { send } from './send-util.js'
+import { send } from '../send-util.js'
 
 /** @import { ServerHttp2Stream } from 'node:http2' */
-/** @import { Metadata } from './defs.js' */
+/** @import { Metadata } from '../../defs.js' */
 
 const { HTTP_STATUS_ACCEPTED } = http2.constants
 

package/src/response/2xx/bytes.js

@@ -0,0 +1,62 @@
+import http2 from 'node:http2'
+
+import { send_bytes } from '../send-util.js'
+
+/** @import { ServerHttp2Stream } from 'node:http2' */
+/** @import { AcceptRangeUnits, SendContent, SendInfo, Metadata, SendBody } from '../../defs.js' */
+/** @import { EtagItem, IMFFixDateInput } from '../../headers/conditional.js' */
+/** @import { CacheControlOptions } from '../../headers/cache-control.js' */
+
+const { HTTP_STATUS_OK } = http2.constants
+
+/**
+ * @param {ServerHttp2Stream} stream
+ * @param {SendBody|undefined} obj
+ * @param {string|undefined} contentType
+ * @param {number|undefined} contentLength
+ * @param {string|undefined} encoding
+ * @param {EtagItem|undefined} etag
+ * @param {IMFFixDateInput|string|undefined} lastModified
+ * @param {number|undefined} age
+ * @param {CacheControlOptions} cacheControl
+ * @param {AcceptRangeUnits|undefined} acceptRanges
+ * @param {Metadata} meta
+ */
+export function sendBytes(stream, contentType, obj, contentLength, encoding, etag, lastModified, age, cacheControl, acceptRanges, meta) {
+	_sendBytes(stream, obj, {
+		contentType,
+		contentLength,
+		encoding,
+		etag,
+		lastModified,
+		age,
+		cacheControl
+	}, {
+		acceptRanges
+	}, meta)
+}
+
+/**
+ * @param {ServerHttp2Stream} stream
+ * @param {SendBody|undefined} obj
+ * @param {Omit<SendContent, 'rangeDirective'>} content
+ * @param {Pick<SendInfo, 'acceptRanges'>} info
+ * @param {Metadata} meta
+ */
+export function _sendBytes(stream, obj, content, info, meta) {
+	const {
+		contentType,
+		contentLength,
+		encoding,
+		etag,
+		lastModified,
+		age,
+		cacheControl,
+	} = content
+
+	const { acceptRanges } = info
+
+	const supportedQueryType = undefined
+	const range = undefined
+	send_bytes(stream, HTTP_STATUS_OK, contentType, obj, range, contentLength, encoding, etag, lastModified, age, cacheControl, acceptRanges, supportedQueryType, meta)
+}