feat: Introduce pseudoHeaders

test/types/header.test-d.ts

@@ -1,14 +1,23 @@
 import { IncomingHttpHeaders as CoreIncomingHttpHeaders } from "http";
 import { expectAssignable, expectNotAssignable } from "tsd";
-import { IncomingHttpHeaders } from "../../types/header";
+import {
+  IncomingHttpHeaders,
+  IncomingH2PseudoHeaders,
+} from "../../types/header";
 
 const headers = {
   authorization: undefined,
   ["content-type"]: "application/json",
 } satisfies CoreIncomingHttpHeaders;
 
+const pseudoHeaders = {
+  ":status": 200,
+} satisfies IncomingH2PseudoHeaders;
+
 expectAssignable<IncomingHttpHeaders>(headers);
 
+expectAssignable<IncomingH2PseudoHeaders>(pseudoHeaders);
+
 // It is why we do not need to add ` | null` to `IncomingHttpHeaders`:
 expectNotAssignable<CoreIncomingHttpHeaders>({
   authorization: null,

types/dispatcher.d.ts

@@ -2,7 +2,7 @@ import { URL } from 'url'
 import { Duplex, Readable, Writable } from 'stream'
 import { EventEmitter } from 'events'
 import { Blob } from 'buffer'
-import { IncomingHttpHeaders } from './header'
+import { IncomingH2PseudoHeaders, IncomingHttpHeaders } from './header'
 import BodyReadable from './readable'
 import { FormData } from './formdata'
 import Errors from './errors'
@@ -169,12 +169,14 @@ declare namespace Dispatcher {
   export interface ConnectData {
     statusCode: number;
     headers: IncomingHttpHeaders;
+    pseudoHeaders: IncomingH2PseudoHeaders;
     socket: Duplex;
     opaque: unknown;
   }
   export interface ResponseData {
     statusCode: number;
     headers: IncomingHttpHeaders;
+    pseudoHeaders: IncomingH2PseudoHeaders;
     body: BodyReadable & BodyMixin;
     trailers: Record<string, string>;
     opaque: unknown;
@@ -183,6 +185,7 @@ declare namespace Dispatcher {
   export interface PipelineHandlerData {
     statusCode: number;
     headers: IncomingHttpHeaders;
+    pseudoHeaders: IncomingH2PseudoHeaders;
     opaque: unknown;
     body: BodyReadable;
     context: object;
@@ -211,7 +214,7 @@ declare namespace Dispatcher {
     /** Invoked when request is upgraded either due to a `Upgrade` header or `CONNECT` method. */
     onUpgrade?(statusCode: number, headers: Buffer[] | string[] | null, socket: Duplex): void;
     /** Invoked when statusCode and headers have been received. May be invoked multiple times due to 1xx informational headers. */
-    onHeaders?(statusCode: number, headers: Buffer[] | string[] | null, resume: () => void): boolean;
+    onHeaders?(statusCode: number, headers: Buffer[] | string[] | null, resume: () => void, statusText: string): boolean;
     /** Invoked when response payload data is received. */
     onData?(chunk: Buffer): boolean;
     /** Invoked when response payload and trailers have been received and the request has completed. */

types/header.d.ts

@@ -2,3 +2,8 @@
  * The header type declaration of `undici`.
  */
 export type IncomingHttpHeaders = Record<string, string | string[] | undefined>;
+
+/**
+ * The h2 pseudo-header type declaration of `undici`.
+ */
+export type IncomingH2PseudoHeaders = Record<':status', number | undefined> | Record<`:${string}`, string | number | string[] | undefined>;