nlcurl 0.6.0 → 0.8.0

package/dist/http/h2/frames.d.ts

@@ -1,8 +1,4 @@
-/**
- * HTTP/2 frame type identifiers as defined in RFC 7540 §11.2.
- *
- * @see {@link https://datatracker.ietf.org/doc/html/rfc7540#section-11.2}
- */
+/** HTTP/2 frame type identifiers. */
 export declare const FrameType: {
     readonly DATA: 0;
     readonly HEADERS: 1;
@@ -15,11 +11,7 @@ export declare const FrameType: {
     readonly WINDOW_UPDATE: 8;
     readonly CONTINUATION: 9;
 };
-/**
- * HTTP/2 frame flag bit masks as defined in RFC 7540. Flags are frame-type
- * specific; e.g. `END_STREAM` is valid on DATA and HEADERS frames while `ACK`
- * shares the same value `0x1` but applies to SETTINGS and PING frames.
- */
+/** HTTP/2 frame flag bitmasks. */
 export declare const Flags: {
     readonly END_STREAM: 1;
     readonly ACK: 1;
@@ -27,11 +19,7 @@ export declare const Flags: {
     readonly PADDED: 8;
     readonly PRIORITY: 32;
 };
-/**
- * HTTP/2 SETTINGS parameter identifiers as defined in RFC 7540 §6.5.2.
- *
- * @see {@link https://datatracker.ietf.org/doc/html/rfc7540#section-6.5.2}
- */
+/** HTTP/2 SETTINGS parameter identifiers. */
 export declare const SettingsParam: {
     readonly HEADER_TABLE_SIZE: 1;
     readonly ENABLE_PUSH: 2;
@@ -40,127 +28,108 @@ export declare const SettingsParam: {
     readonly MAX_FRAME_SIZE: 5;
     readonly MAX_HEADER_LIST_SIZE: 6;
 };
-/**
- * Represents a decoded HTTP/2 frame.
- *
- * @typedef  {Object} H2Frame
- * @property {number} type     - Frame type identifier (see `FrameType`).
- * @property {number} flags    - Frame flags bitmask (see `Flags`).
- * @property {number} streamId - Associated stream identifier (0 for connection-level frames).
- * @property {Buffer} payload  - Raw frame payload (excludes the 9-byte header).
- */
+/** Parsed HTTP/2 frame. */
 export interface H2Frame {
+    /** Frame type code. */
     type: number;
+    /** Frame flags bitmask. */
     flags: number;
+    /** Stream identifier. */
     streamId: number;
+    /** Frame payload data. */
     payload: Buffer;
 }
 /**
- * Attempts to parse one HTTP/2 frame starting at `offset` in `data`.
- * Returns `null` if insufficient bytes are available for a complete frame.
+ * Read a single HTTP/2 frame from a buffer.
  *
- * @param {Buffer} data          - Input buffer potentially containing one or more frames.
- * @param {number} offset        - Byte offset within `data` at which to start parsing.
- * @param {number} [maxFrameSize=16777215] - Maximum permitted payload length.
- *   Frames whose length field exceeds this value cause a `FRAME_SIZE_ERROR`.
- *   Callers should pass the peer's `SETTINGS_MAX_FRAME_SIZE` value here.
- * @returns {{ frame: H2Frame; bytesRead: number } | null} Parsed frame and total bytes consumed,
- *   or `null` if more data is required.
- * @throws {Error} If the frame's length field exceeds `maxFrameSize`.
+ * @param {Buffer} data - Buffer to read from.
+ * @param {number} offset - Byte offset to start reading.
+ * @param {number} [maxFrameSize] - Maximum allowed frame payload size.
+ * @returns {{ frame: H2Frame; bytesRead: number } | null} Parsed frame and bytes consumed, or `null` if insufficient data.
  */
 export declare function readFrame(data: Buffer, offset: number, maxFrameSize?: number): {
     frame: H2Frame;
     bytesRead: number;
 } | null;
 /**
- * Serializes an HTTP/2 frame into a `Buffer` including the 9-byte frame header.
+ * Serialize an HTTP/2 frame to a wire-format buffer.
  *
  * @param {H2Frame} frame - Frame to serialize.
- * @returns {Buffer} Complete frame bytes ready to be written to a transport stream.
+ * @returns {Buffer} Wire-format buffer.
  */
 export declare function writeFrame(frame: H2Frame): Buffer;
 /**
- * Builds a SETTINGS frame optionally containing one or more settings parameters.
- * When `ack` is `true` the frame acknowledges a peer SETTINGS frame and the
- * `settings` array is ignored.
+ * Build an HTTP/2 SETTINGS frame.
  *
- * @param {Array<{id: number; value: number}>} settings - Settings parameters to send.
- * @param {boolean} [ack=false] - Whether to create a SETTINGS acknowledgement (empty payload + ACK flag).
- * @returns {Buffer} Encoded SETTINGS frame.
+ * @param {Array<{ id: number; value: number }>} settings - Setting id/value pairs.
+ * @param {boolean} [ack] - Whether this is a SETTINGS acknowledgment.
+ * @returns {Buffer} Serialized SETTINGS frame.
  */
 export declare function buildSettingsFrame(settings: Array<{
     id: number;
     value: number;
 }>, ack?: boolean): Buffer;
 /**
- * Builds a WINDOW_UPDATE frame that enlarges a flow-control window.
+ * Build an HTTP/2 WINDOW_UPDATE frame.
  *
- * @param {number} streamId  - Stream to update (`0` for the connection-level window).
- * @param {number} increment - Number of octets to add to the flow-control window (1–2^31-1).
- * @returns {Buffer} Encoded WINDOW_UPDATE frame.
+ * @param {number} streamId - Target stream (0 for connection-level).
+ * @param {number} increment - Window size increment.
+ * @returns {Buffer} Serialized WINDOW_UPDATE frame.
  */
 export declare function buildWindowUpdateFrame(streamId: number, increment: number): Buffer;
 /**
- * Builds a HEADERS frame carrying an HPACK-encoded header block fragment.
+ * Build an HTTP/2 HEADERS frame.
  *
- * @param {number}  streamId    - Stream identifier.
- * @param {Buffer}  headerBlock - HPACK-encoded header block.
- * @param {boolean} endStream   - Whether to set the END_STREAM flag (no DATA frames follow).
- * @param {boolean} endHeaders  - Whether to set the END_HEADERS flag (no CONTINUATION frames follow).
- * @returns {Buffer} Encoded HEADERS frame.
+ * @param {number} streamId - Target stream.
+ * @param {Buffer} headerBlock - HPACK-encoded header block.
+ * @param {boolean} endStream - Whether this completes the stream.
+ * @param {boolean} endHeaders - Whether the header block is complete.
+ * @returns {Buffer} Serialized HEADERS frame.
  */
 export declare function buildHeadersFrame(streamId: number, headerBlock: Buffer, endStream: boolean, endHeaders: boolean): Buffer;
 /**
- * Builds a DATA frame carrying application payload bytes for a stream.
+ * Build an HTTP/2 DATA frame.
  *
- * @param {number}  streamId  - Stream identifier.
- * @param {Buffer}  data      - Payload to send.
- * @param {boolean} endStream - Whether to set the END_STREAM flag (last DATA frame for this stream).
- * @returns {Buffer} Encoded DATA frame.
+ * @param {number} streamId - Target stream.
+ * @param {Buffer} data - Payload data.
+ * @param {boolean} endStream - Whether this completes the stream.
+ * @returns {Buffer} Serialized DATA frame.
  */
 export declare function buildDataFrame(streamId: number, data: Buffer, endStream: boolean): Buffer;
 /**
- * Builds a PRIORITY frame that advises the peer about the relative priority
- * and dependency tree position of a stream.
+ * Build an HTTP/2 PRIORITY frame.
  *
- * @param {number}  streamId  - Stream to set priority for.
- * @param {boolean} exclusive - Whether this stream is exclusive in the dependency tree.
- * @param {number}  dependsOn - Parent stream identifier.
- * @param {number}  weight    - Stream weight (1–256 per RFC 7540; value stored as `weight - 1`).
- * @returns {Buffer} Encoded PRIORITY frame.
+ * @param {number} streamId - Target stream.
+ * @param {boolean} exclusive - Whether to use exclusive dependency.
+ * @param {number} dependsOn - Stream dependency.
+ * @param {number} weight - Priority weight (1–256).
+ * @returns {Buffer} Serialized PRIORITY frame.
  */
 export declare function buildPriorityFrame(streamId: number, exclusive: boolean, dependsOn: number, weight: number): Buffer;
 /**
- * Builds a GOAWAY frame notifying the peer that the connection is being
- * gracefully shut down.
+ * Build an HTTP/2 GOAWAY frame.
  *
- * @param {number} lastStreamId - Highest-numbered stream ID that was processed.
- * @param {number} errorCode    - HTTP/2 error code (0 = NO_ERROR for graceful shutdown).
- * @returns {Buffer} Encoded GOAWAY frame.
+ * @param {number} lastStreamId - Last processed stream identifier.
+ * @param {number} errorCode - Error code.
+ * @returns {Buffer} Serialized GOAWAY frame.
  */
 export declare function buildGoawayFrame(lastStreamId: number, errorCode: number): Buffer;
 /**
- * Builds a PING frame used for measuring round-trip time or testing connectivity.
+ * Build an HTTP/2 PING frame.
  *
- * @param {Buffer}  data     - 8-byte opaque payload to echo back.
- * @param {boolean} [ack=false] - When `true`, sets the ACK flag (reply to a received PING).
- * @returns {Buffer} Encoded PING frame.
+ * @param {Buffer} data - 8-byte ping payload.
+ * @param {boolean} [ack] - Whether this is a PING acknowledgment.
+ * @returns {Buffer} Serialized PING frame.
  */
 export declare function buildPingFrame(data: Buffer, ack?: boolean): Buffer;
 /**
- * Builds a RST_STREAM frame that immediately terminates a stream.
+ * Build an HTTP/2 RST_STREAM frame.
  *
- * @param {number} streamId  - Stream to reset.
- * @param {number} errorCode - HTTP/2 error code describing the reason for the reset.
- * @returns {Buffer} Encoded RST_STREAM frame.
+ * @param {number} streamId - Stream to reset.
+ * @param {number} errorCode - Error code.
+ * @returns {Buffer} Serialized RST_STREAM frame.
  */
 export declare function buildRstStreamFrame(streamId: number, errorCode: number): Buffer;
-/**
- * The HTTP/2 client connection preface as defined in RFC 7540 §3.5.
- * Must be the first bytes sent by a client after the transport connection is
- * established and before any SETTINGS frame.
- *
- * @see {@link https://datatracker.ietf.org/doc/html/rfc7540#section-3.5}
- */
+/** HTTP/2 connection preface sent by the client. */
 export declare const H2_PREFACE: Buffer<ArrayBuffer>;
 //# sourceMappingURL=frames.d.ts.map

package/dist/http/h2/frames.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frames.d.ts","sourceRoot":"","sources":["../../../src/http/h2/frames.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;CAWZ,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,KAAK;;;;;;CAMR,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;;CAOhB,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAKD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAE,MAAgC,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAqBpJ;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,GAAG,UAAQ,GAAG,MAAM,CAoBtG;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CASlF;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,CAUxH;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CASzF;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAYlH;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAUhF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAQ,GAAG,MAAM,CAShE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAS/E;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,qBAA2D,CAAC"}
+{"version":3,"file":"frames.d.ts","sourceRoot":"","sources":["../../../src/http/h2/frames.ts"],"names":[],"mappings":"AAEA,qCAAqC;AACrC,eAAO,MAAM,SAAS;;;;;;;;;;;CAWZ,CAAC;AAEX,kCAAkC;AAClC,eAAO,MAAM,KAAK;;;;;;CAMR,CAAC;AAEX,6CAA6C;AAC7C,eAAO,MAAM,aAAa;;;;;;;CAOhB,CAAC;AAEX,2BAA2B;AAC3B,MAAM,WAAW,OAAO;IACtB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAID;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAE,MAAgC,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAqBpJ;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUjD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,GAAG,UAAQ,GAAG,MAAM,CAoBtG;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CASlF;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,CAUxH;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CASzF;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAYlH;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAUhF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAQ,GAAG,MAAM,CAShE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAS/E;AAED,oDAAoD;AACpD,eAAO,MAAM,UAAU,qBAA2D,CAAC"}

package/dist/http/h2/frames.js

@@ -1,9 +1,5 @@
 import { BufferWriter } from "../../utils/buffer-writer.js";
-/**
- * HTTP/2 frame type identifiers as defined in RFC 7540 §11.2.
- *
- * @see {@link https://datatracker.ietf.org/doc/html/rfc7540#section-11.2}
- */
+/** HTTP/2 frame type identifiers. */
 export const FrameType = {
     DATA: 0x0,
     HEADERS: 0x1,
@@ -16,11 +12,7 @@ export const FrameType = {
     WINDOW_UPDATE: 0x8,
     CONTINUATION: 0x9,
 };
-/**
- * HTTP/2 frame flag bit masks as defined in RFC 7540. Flags are frame-type
- * specific; e.g. `END_STREAM` is valid on DATA and HEADERS frames while `ACK`
- * shares the same value `0x1` but applies to SETTINGS and PING frames.
- */
+/** HTTP/2 frame flag bitmasks. */
 export const Flags = {
     END_STREAM: 0x1,
     ACK: 0x1,
@@ -28,11 +20,7 @@ export const Flags = {
     PADDED: 0x8,
     PRIORITY: 0x20,
 };
-/**
- * HTTP/2 SETTINGS parameter identifiers as defined in RFC 7540 §6.5.2.
- *
- * @see {@link https://datatracker.ietf.org/doc/html/rfc7540#section-6.5.2}
- */
+/** HTTP/2 SETTINGS parameter identifiers. */
 export const SettingsParam = {
     HEADER_TABLE_SIZE: 0x1,
     ENABLE_PUSH: 0x2,
@@ -41,20 +29,14 @@ export const SettingsParam = {
     MAX_FRAME_SIZE: 0x5,
     MAX_HEADER_LIST_SIZE: 0x6,
 };
-/** RFC 7540 §4.2: Maximum value for SETTINGS_MAX_FRAME_SIZE (2^24 - 1). */
 const PROTOCOL_MAX_FRAME_SIZE = 16_777_215;
 /**
- * Attempts to parse one HTTP/2 frame starting at `offset` in `data`.
- * Returns `null` if insufficient bytes are available for a complete frame.
+ * Read a single HTTP/2 frame from a buffer.
  *
- * @param {Buffer} data          - Input buffer potentially containing one or more frames.
- * @param {number} offset        - Byte offset within `data` at which to start parsing.
- * @param {number} [maxFrameSize=16777215] - Maximum permitted payload length.
- *   Frames whose length field exceeds this value cause a `FRAME_SIZE_ERROR`.
- *   Callers should pass the peer's `SETTINGS_MAX_FRAME_SIZE` value here.
- * @returns {{ frame: H2Frame; bytesRead: number } | null} Parsed frame and total bytes consumed,
- *   or `null` if more data is required.
- * @throws {Error} If the frame's length field exceeds `maxFrameSize`.
+ * @param {Buffer} data - Buffer to read from.
+ * @param {number} offset - Byte offset to start reading.
+ * @param {number} [maxFrameSize] - Maximum allowed frame payload size.
+ * @returns {{ frame: H2Frame; bytesRead: number } | null} Parsed frame and bytes consumed, or `null` if insufficient data.
  */
 export function readFrame(data, offset, maxFrameSize = PROTOCOL_MAX_FRAME_SIZE) {
     if (data.length - offset < 9)
@@ -75,10 +57,10 @@ export function readFrame(data, offset, maxFrameSize = PROTOCOL_MAX_FRAME_SIZE)
     };
 }
 /**
- * Serializes an HTTP/2 frame into a `Buffer` including the 9-byte frame header.
+ * Serialize an HTTP/2 frame to a wire-format buffer.
  *
  * @param {H2Frame} frame - Frame to serialize.
- * @returns {Buffer} Complete frame bytes ready to be written to a transport stream.
+ * @returns {Buffer} Wire-format buffer.
  */
 export function writeFrame(frame) {
     const w = new BufferWriter(9 + frame.payload.length);
@@ -92,13 +74,11 @@ export function writeFrame(frame) {
     return w.toBuffer();
 }
 /**
- * Builds a SETTINGS frame optionally containing one or more settings parameters.
- * When `ack` is `true` the frame acknowledges a peer SETTINGS frame and the
- * `settings` array is ignored.
+ * Build an HTTP/2 SETTINGS frame.
  *
- * @param {Array<{id: number; value: number}>} settings - Settings parameters to send.
- * @param {boolean} [ack=false] - Whether to create a SETTINGS acknowledgement (empty payload + ACK flag).
- * @returns {Buffer} Encoded SETTINGS frame.
+ * @param {Array<{ id: number; value: number }>} settings - Setting id/value pairs.
+ * @param {boolean} [ack] - Whether this is a SETTINGS acknowledgment.
+ * @returns {Buffer} Serialized SETTINGS frame.
  */
 export function buildSettingsFrame(settings, ack = false) {
     if (ack) {
@@ -122,11 +102,11 @@ export function buildSettingsFrame(settings, ack = false) {
     });
 }
 /**
- * Builds a WINDOW_UPDATE frame that enlarges a flow-control window.
+ * Build an HTTP/2 WINDOW_UPDATE frame.
  *
- * @param {number} streamId  - Stream to update (`0` for the connection-level window).
- * @param {number} increment - Number of octets to add to the flow-control window (1–2^31-1).
- * @returns {Buffer} Encoded WINDOW_UPDATE frame.
+ * @param {number} streamId - Target stream (0 for connection-level).
+ * @param {number} increment - Window size increment.
+ * @returns {Buffer} Serialized WINDOW_UPDATE frame.
  */
 export function buildWindowUpdateFrame(streamId, increment) {
     const w = new BufferWriter(4);
@@ -139,13 +119,13 @@ export function buildWindowUpdateFrame(streamId, increment) {
     });
 }
 /**
- * Builds a HEADERS frame carrying an HPACK-encoded header block fragment.
+ * Build an HTTP/2 HEADERS frame.
  *
- * @param {number}  streamId    - Stream identifier.
- * @param {Buffer}  headerBlock - HPACK-encoded header block.
- * @param {boolean} endStream   - Whether to set the END_STREAM flag (no DATA frames follow).
- * @param {boolean} endHeaders  - Whether to set the END_HEADERS flag (no CONTINUATION frames follow).
- * @returns {Buffer} Encoded HEADERS frame.
+ * @param {number} streamId - Target stream.
+ * @param {Buffer} headerBlock - HPACK-encoded header block.
+ * @param {boolean} endStream - Whether this completes the stream.
+ * @param {boolean} endHeaders - Whether the header block is complete.
+ * @returns {Buffer} Serialized HEADERS frame.
  */
 export function buildHeadersFrame(streamId, headerBlock, endStream, endHeaders) {
     let flags = 0;
@@ -161,12 +141,12 @@ export function buildHeadersFrame(streamId, headerBlock, endStream, endHeaders)
     });
 }
 /**
- * Builds a DATA frame carrying application payload bytes for a stream.
+ * Build an HTTP/2 DATA frame.
  *
- * @param {number}  streamId  - Stream identifier.
- * @param {Buffer}  data      - Payload to send.
- * @param {boolean} endStream - Whether to set the END_STREAM flag (last DATA frame for this stream).
- * @returns {Buffer} Encoded DATA frame.
+ * @param {number} streamId - Target stream.
+ * @param {Buffer} data - Payload data.
+ * @param {boolean} endStream - Whether this completes the stream.
+ * @returns {Buffer} Serialized DATA frame.
  */
 export function buildDataFrame(streamId, data, endStream) {
     let flags = 0;
@@ -180,14 +160,13 @@ export function buildDataFrame(streamId, data, endStream) {
     });
 }
 /**
- * Builds a PRIORITY frame that advises the peer about the relative priority
- * and dependency tree position of a stream.
+ * Build an HTTP/2 PRIORITY frame.
  *
- * @param {number}  streamId  - Stream to set priority for.
- * @param {boolean} exclusive - Whether this stream is exclusive in the dependency tree.
- * @param {number}  dependsOn - Parent stream identifier.
- * @param {number}  weight    - Stream weight (1–256 per RFC 7540; value stored as `weight - 1`).
- * @returns {Buffer} Encoded PRIORITY frame.
+ * @param {number} streamId - Target stream.
+ * @param {boolean} exclusive - Whether to use exclusive dependency.
+ * @param {number} dependsOn - Stream dependency.
+ * @param {number} weight - Priority weight (1–256).
+ * @returns {Buffer} Serialized PRIORITY frame.
  */
 export function buildPriorityFrame(streamId, exclusive, dependsOn, weight) {
     const w = new BufferWriter(5);
@@ -204,12 +183,11 @@ export function buildPriorityFrame(streamId, exclusive, dependsOn, weight) {
     });
 }
 /**
- * Builds a GOAWAY frame notifying the peer that the connection is being
- * gracefully shut down.
+ * Build an HTTP/2 GOAWAY frame.
  *
- * @param {number} lastStreamId - Highest-numbered stream ID that was processed.
- * @param {number} errorCode    - HTTP/2 error code (0 = NO_ERROR for graceful shutdown).
- * @returns {Buffer} Encoded GOAWAY frame.
+ * @param {number} lastStreamId - Last processed stream identifier.
+ * @param {number} errorCode - Error code.
+ * @returns {Buffer} Serialized GOAWAY frame.
  */
 export function buildGoawayFrame(lastStreamId, errorCode) {
     const w = new BufferWriter(8);
@@ -223,11 +201,11 @@ export function buildGoawayFrame(lastStreamId, errorCode) {
     });
 }
 /**
- * Builds a PING frame used for measuring round-trip time or testing connectivity.
+ * Build an HTTP/2 PING frame.
  *
- * @param {Buffer}  data     - 8-byte opaque payload to echo back.
- * @param {boolean} [ack=false] - When `true`, sets the ACK flag (reply to a received PING).
- * @returns {Buffer} Encoded PING frame.
+ * @param {Buffer} data - 8-byte ping payload.
+ * @param {boolean} [ack] - Whether this is a PING acknowledgment.
+ * @returns {Buffer} Serialized PING frame.
  */
 export function buildPingFrame(data, ack = false) {
     const payload = Buffer.alloc(8);
@@ -240,11 +218,11 @@ export function buildPingFrame(data, ack = false) {
     });
 }
 /**
- * Builds a RST_STREAM frame that immediately terminates a stream.
+ * Build an HTTP/2 RST_STREAM frame.
  *
- * @param {number} streamId  - Stream to reset.
- * @param {number} errorCode - HTTP/2 error code describing the reason for the reset.
- * @returns {Buffer} Encoded RST_STREAM frame.
+ * @param {number} streamId - Stream to reset.
+ * @param {number} errorCode - Error code.
+ * @returns {Buffer} Serialized RST_STREAM frame.
  */
 export function buildRstStreamFrame(streamId, errorCode) {
     const w = new BufferWriter(4);
@@ -256,12 +234,6 @@ export function buildRstStreamFrame(streamId, errorCode) {
         payload: w.toBuffer(),
     });
 }
-/**
- * The HTTP/2 client connection preface as defined in RFC 7540 §3.5.
- * Must be the first bytes sent by a client after the transport connection is
- * established and before any SETTINGS frame.
- *
- * @see {@link https://datatracker.ietf.org/doc/html/rfc7540#section-3.5}
- */
+/** HTTP/2 connection preface sent by the client. */
 export const H2_PREFACE = Buffer.from("PRI * HTTP/2.0\r\n\r\nSM\r\n\r\n", "ascii");
 //# sourceMappingURL=frames.js.map

package/dist/http/h2/frames.js.map

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

package/dist/http/h2/hpack.d.ts

@@ -1,67 +1,48 @@
-/**
- * HPACK header compression encoder (RFC 7541). Maintains a dynamic header
- * table and encodes header lists into compact HPACK binary format using
- * Huffman coding and indexed representations.
- *
- * @see {@link https://datatracker.ietf.org/doc/html/rfc7541}
- */
+/** HPACK header compression encoder for HTTP/2. */
 export declare class HPACKEncoder {
     private dynamicTable;
     private staticIndex;
     private staticFullIndex;
     /**
-     * Creates a new HPACKEncoder with the given initial dynamic table size.
+     * Create a new HPACK encoder.
      *
-     * @param {number} [tableSize=4096] - Maximum size of the HPACK dynamic header table in bytes.
+     * @param {number} [tableSize] - Maximum dynamic table size in bytes.
      */
     constructor(tableSize?: number);
     /**
-     * Encodes an ordered header list into an HPACK binary block ready to be
-     * placed in an HTTP/2 HEADERS or PUSH_PROMISE frame payload.
+     * Encode headers into an HPACK header block.
      *
-     * @param {Array<[string, string]>} headers - Header name-value pairs to encode.
-     * @returns {Buffer} HPACK-encoded header block fragment.
+     * @param {Array<[string, string]>} headers - Header name/value pairs to encode.
+     * @returns {Buffer} Compressed header block buffer.
      */
     encode(headers: Array<[string, string]>): Buffer;
     /**
-     * Updates the encoder's dynamic table maximum size — call this whenever a
-     * `SETTINGS_HEADER_TABLE_SIZE` value is received from the remote peer so
-     * that subsequent {@link encode} calls respect the new limit.
+     * Update the dynamic table maximum size.
      *
-     * @param {number} newSize - New maximum dynamic table size in bytes.
+     * @param {number} newSize - New maximum size in bytes.
      */
     updateTableSize(newSize: number): void;
 }
-/**
- * HPACK header decompression decoder (RFC 7541). Maintains a synchronized
- * dynamic header table and decodes HPACK binary blocks received in
- * HTTP/2 HEADERS and PUSH_PROMISE frames.
- *
- * @see {@link https://datatracker.ietf.org/doc/html/rfc7541}
- */
+/** HPACK header compression decoder for HTTP/2. */
 export declare class HPACKDecoder {
     private dynamicTable;
     /**
-     * Creates a new HPACKDecoder with the given initial dynamic table size.
+     * Create a new HPACK decoder.
      *
-     * @param {number} [tableSize=4096] - Maximum size of the HPACK dynamic header table in bytes.
+     * @param {number} [tableSize] - Maximum dynamic table size in bytes.
      */
     constructor(tableSize?: number);
     /**
-     * Updates the maximum size of the decoder's dynamic table. Called when a
-     * SETTINGS_HEADER_TABLE_SIZE frame is received from the server.
+     * Update the dynamic table maximum size.
      *
-     * @param {number} maxSize - New maximum table size in bytes.
+     * @param {number} maxSize - New maximum size in bytes.
      */
     setMaxTableSize(maxSize: number): void;
     /**
-     * Decodes an HPACK-encoded header block fragment into an ordered list of
-     * name-value pairs. Updates the internal dynamic table as required by the
-     * HPACK state machine.
+     * Decode an HPACK header block into header pairs.
      *
-     * @param {Buffer} data - HPACK-encoded header block fragment from a HEADERS or PUSH_PROMISE frame.
-     * @returns {Array<[string, string]>} Decoded header name-value pairs in transmission order.
-     * @throws {Error} If the encoded data references an invalid table index.
+     * @param {Buffer} data - HPACK encoded data.
+     * @returns {Array<[string, string]>} Decoded header name/value pairs.
      */
     decode(data: Buffer): Array<[string, string]>;
     private getEntry;

package/dist/http/h2/hpack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hpack.d.ts","sourceRoot":"","sources":["../../../src/http/h2/hpack.ts"],"names":[],"mappings":"AAqKA;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,eAAe,CAAsB;IAE7C;;;;OAIG;gBACS,SAAS,GAAE,MAAa;IAiBpC;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM;IA6BhD;;;;;;OAMG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAGvC;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAAe;IAEnC;;;;OAIG;gBACS,SAAS,GAAE,MAAa;IAIpC;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAItC;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAyD7C,OAAO,CAAC,QAAQ;CAcjB"}
+{"version":3,"file":"hpack.d.ts","sourceRoot":"","sources":["../../../src/http/h2/hpack.ts"],"names":[],"mappings":"AAqKA,mDAAmD;AACnD,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,eAAe,CAAsB;IAE7C;;;;OAIG;gBACS,SAAS,GAAE,MAAa;IAiBpC;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM;IA6BhD;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAGvC;AAED,mDAAmD;AACnD,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAAe;IAEnC;;;;OAIG;gBACS,SAAS,GAAE,MAAa;IAIpC;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAItC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAyD7C,OAAO,CAAC,QAAQ;CAcjB"}