nlcurl 0.1.0

package/dist/http/h2/client.js

@@ -0,0 +1,376 @@
+/**
+ * HTTP/2 client.
+ *
+ * Multiplexed HTTP/2 client that runs over a TLS Duplex stream.
+ * Sends the connection preface with browser-profile-matched SETTINGS
+ * and WINDOW_UPDATE for Akamai HTTP/2 fingerprint control.
+ */
+import { NLcURLResponse } from '../../core/response.js';
+import { HTTPError, TimeoutError, ProtocolError } from '../../core/errors.js';
+import { decompressBody } from '../../utils/encoding.js';
+import { HPACKEncoder, HPACKDecoder } from './hpack.js';
+import { readFrame, writeFrame, buildSettingsFrame, buildWindowUpdateFrame, buildHeadersFrame, buildDataFrame, buildPingFrame, buildGoawayFrame, H2_PREFACE, FrameType, Flags, } from './frames.js';
+// ---- Client ----
+export class H2Client {
+    stream;
+    encoder;
+    decoder;
+    h2Profile;
+    defaultHeaders;
+    nextStreamId = 1;
+    streams = new Map();
+    readBuffer = Buffer.alloc(0);
+    prefaceSent = false;
+    closed = false;
+    constructor(stream, h2Profile, defaultHeaders = []) {
+        this.stream = stream;
+        this.encoder = new HPACKEncoder();
+        this.decoder = new HPACKDecoder();
+        this.h2Profile = h2Profile;
+        this.defaultHeaders = defaultHeaders;
+        stream.on('data', (chunk) => this.onData(chunk));
+        stream.once('error', (err) => this.onError(err));
+        stream.once('close', () => this.onClose());
+    }
+    /**
+     * Send the HTTP/2 connection preface.
+     *
+     * Must be called before sending any requests.
+     */
+    sendPreface() {
+        if (this.prefaceSent)
+            return;
+        this.prefaceSent = true;
+        // 1. Magic octets
+        this.write(H2_PREFACE);
+        // 2. SETTINGS frame (ordered per profile)
+        if (this.h2Profile) {
+            this.write(buildSettingsFrame(this.h2Profile.settings));
+            // 3. WINDOW_UPDATE on stream 0
+            if (this.h2Profile.windowUpdate > 0) {
+                this.write(buildWindowUpdateFrame(0, this.h2Profile.windowUpdate));
+            }
+            // 4. PRIORITY frames
+            if (this.h2Profile.priorityFrames) {
+                for (const pf of this.h2Profile.priorityFrames) {
+                    const payload = Buffer.allocUnsafe(5);
+                    let dep = pf.dependsOn & 0x7fffffff;
+                    if (pf.exclusive)
+                        dep |= 0x80000000;
+                    payload.writeUInt32BE(dep >>> 0, 0);
+                    payload[4] = (pf.weight - 1) & 0xff;
+                    this.write(writeFrame({
+                        type: FrameType.PRIORITY,
+                        flags: 0,
+                        streamId: pf.streamId,
+                        payload,
+                    }));
+                }
+            }
+        }
+        else {
+            // Default settings
+            this.write(buildSettingsFrame([
+                { id: 1, value: 65536 },
+                { id: 2, value: 0 },
+                { id: 4, value: 6291456 },
+                { id: 6, value: 262144 },
+            ]));
+            this.write(buildWindowUpdateFrame(0, 15663105));
+        }
+    }
+    /**
+     * Send an HTTP/2 request and return the response.
+     */
+    async request(req, timings = {}) {
+        if (this.closed) {
+            throw new ProtocolError('HTTP/2 connection is closed');
+        }
+        if (!this.prefaceSent)
+            this.sendPreface();
+        const streamId = this.nextStreamId;
+        if (streamId > 0x7fffffff) {
+            throw new ProtocolError('HTTP/2 stream ID exhausted; open a new connection');
+        }
+        this.nextStreamId += 2; // Client streams are odd
+        return new Promise((resolve, reject) => {
+            const h2stream = {
+                id: streamId,
+                request: req,
+                responseHeaders: new Map(),
+                responseRawHeaders: [],
+                status: 0,
+                dataChunks: [],
+                endStream: false,
+                resolve,
+                reject,
+                timings,
+            };
+            this.streams.set(streamId, h2stream);
+            // Build headers
+            const headers = this.buildRequestHeaders(req);
+            const headerBlock = this.encoder.encode(headers);
+            const hasBody = req.body !== undefined &&
+                req.body !== null &&
+                req.method !== 'GET' &&
+                req.method !== 'HEAD';
+            // Send HEADERS frame
+            this.write(buildHeadersFrame(streamId, headerBlock, !hasBody, true));
+            // Send body if present
+            if (hasBody) {
+                const bodyBuf = serializeBody(req.body);
+                this.write(buildDataFrame(streamId, bodyBuf, true));
+            }
+            // Timeout
+            const timeout = req.timeout;
+            const timeoutMs = typeof timeout === 'number' ? timeout : (timeout?.total ?? timeout?.response ?? 0);
+            if (timeoutMs > 0) {
+                h2stream.timer = setTimeout(() => {
+                    if (this.streams.has(streamId)) {
+                        this.streams.delete(streamId);
+                        reject(new TimeoutError('HTTP/2 request timed out', 'response'));
+                    }
+                }, timeoutMs);
+            }
+        });
+    }
+    /**
+     * Gracefully close the HTTP/2 connection.
+     */
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.write(buildGoawayFrame(0, 0));
+        this.stream.end();
+    }
+    destroy() {
+        this.closed = true;
+        this.stream.destroy();
+        for (const [, s] of this.streams) {
+            if (s.timer)
+                clearTimeout(s.timer);
+            s.reject(new ProtocolError('HTTP/2 connection destroyed'));
+        }
+        this.streams.clear();
+    }
+    // ---- Internal ----
+    buildRequestHeaders(req) {
+        const url = new URL(req.url);
+        const authority = url.port ? `${url.hostname}:${url.port}` : url.hostname;
+        const path = url.pathname + url.search;
+        // Pseudo headers in profile-defined order
+        const order = this.h2Profile?.pseudoHeaderOrder ?? [
+            ':method',
+            ':authority',
+            ':scheme',
+            ':path',
+        ];
+        const pseudoMap = {
+            ':method': req.method ?? 'GET',
+            ':authority': authority,
+            ':scheme': url.protocol.replace(':', ''),
+            ':path': path || '/',
+        };
+        const headers = [];
+        // Emit pseudo headers in profile order
+        for (const ph of order) {
+            const v = pseudoMap[ph];
+            if (v !== undefined) {
+                headers.push([ph, v]);
+            }
+        }
+        // Default headers
+        const seen = new Set(order);
+        for (const [k, v] of this.defaultHeaders) {
+            const lower = k.toLowerCase();
+            if (!seen.has(lower)) {
+                seen.add(lower);
+                headers.push([lower, v]);
+            }
+        }
+        // Request headers
+        if (req.headers) {
+            for (const [k, v] of Object.entries(req.headers)) {
+                const lower = k.toLowerCase();
+                if (!seen.has(lower)) {
+                    seen.add(lower);
+                    headers.push([lower, v]);
+                }
+            }
+        }
+        return headers;
+    }
+    write(data) {
+        if (!this.closed) {
+            this.stream.write(data);
+        }
+    }
+    onData(chunk) {
+        this.readBuffer = Buffer.concat([this.readBuffer, chunk]);
+        this.processFrames();
+    }
+    processFrames() {
+        while (true) {
+            const result = readFrame(this.readBuffer, 0);
+            if (!result)
+                break;
+            this.readBuffer = this.readBuffer.subarray(result.bytesRead);
+            this.handleFrame(result.frame);
+        }
+    }
+    handleFrame(frame) {
+        switch (frame.type) {
+            case FrameType.SETTINGS:
+                if (!(frame.flags & Flags.ACK)) {
+                    // Acknowledge server settings
+                    this.write(buildSettingsFrame([], true));
+                }
+                break;
+            case FrameType.HEADERS: {
+                const s = this.streams.get(frame.streamId);
+                if (!s)
+                    break;
+                const headers = this.decoder.decode(frame.payload);
+                for (const [name, value] of headers) {
+                    if (name === ':status') {
+                        s.status = parseInt(value, 10);
+                    }
+                    s.responseRawHeaders.push([name, value]);
+                    const existing = s.responseHeaders.get(name);
+                    if (existing !== undefined) {
+                        s.responseHeaders.set(name, existing + ', ' + value);
+                    }
+                    else {
+                        s.responseHeaders.set(name, value);
+                    }
+                }
+                if (frame.flags & Flags.END_STREAM) {
+                    this.finalizeStream(s);
+                }
+                break;
+            }
+            case FrameType.DATA: {
+                const s = this.streams.get(frame.streamId);
+                if (!s)
+                    break;
+                s.dataChunks.push(Buffer.from(frame.payload));
+                if (frame.flags & Flags.END_STREAM) {
+                    this.finalizeStream(s);
+                }
+                break;
+            }
+            case FrameType.RST_STREAM: {
+                const s = this.streams.get(frame.streamId);
+                if (s) {
+                    if (s.timer)
+                        clearTimeout(s.timer);
+                    this.streams.delete(frame.streamId);
+                    const errorCode = frame.payload.readUInt32BE(0);
+                    s.reject(new ProtocolError(`HTTP/2 stream reset: error code ${errorCode}`));
+                }
+                break;
+            }
+            case FrameType.PING:
+                if (!(frame.flags & Flags.ACK)) {
+                    this.write(buildPingFrame(frame.payload, true));
+                }
+                break;
+            case FrameType.GOAWAY: {
+                this.closed = true;
+                const errorCode = frame.payload.readUInt32BE(4);
+                if (errorCode !== 0) {
+                    for (const [, s] of this.streams) {
+                        if (s.timer)
+                            clearTimeout(s.timer);
+                        s.reject(new ProtocolError(`HTTP/2 GOAWAY: error code ${errorCode}`));
+                    }
+                    this.streams.clear();
+                }
+                break;
+            }
+            case FrameType.WINDOW_UPDATE:
+                // Flow control -- in a full implementation we would track
+                // per-stream and connection-level windows. For now, accepted.
+                break;
+        }
+    }
+    async finalizeStream(s) {
+        if (s.timer)
+            clearTimeout(s.timer);
+        this.streams.delete(s.id);
+        const rawBody = Buffer.concat(s.dataChunks);
+        const encoding = s.responseHeaders.get('content-encoding');
+        let body;
+        try {
+            body = encoding ? await decompressBody(rawBody, encoding) : rawBody;
+        }
+        catch {
+            body = rawBody;
+        }
+        const responseHeaders = {};
+        for (const [k, v] of s.responseHeaders) {
+            if (!k.startsWith(':')) {
+                responseHeaders[k] = v;
+            }
+        }
+        const response = new NLcURLResponse({
+            status: s.status,
+            statusText: '',
+            headers: responseHeaders,
+            rawHeaders: s.responseRawHeaders.filter(([k]) => !k.startsWith(':')),
+            rawBody: body,
+            httpVersion: 'h2',
+            url: s.request.url,
+            redirectCount: 0,
+            timings: {
+                dns: s.timings.dns ?? 0,
+                connect: s.timings.connect ?? 0,
+                tls: s.timings.tls ?? 0,
+                firstByte: s.timings.firstByte ?? 0,
+                total: 0,
+            },
+            request: {
+                url: s.request.url,
+                method: s.request.method ?? 'GET',
+                headers: s.request.headers ?? {},
+            },
+        });
+        s.resolve(response);
+    }
+    onError(err) {
+        for (const [, s] of this.streams) {
+            if (s.timer)
+                clearTimeout(s.timer);
+            s.reject(new HTTPError(err.message, 0));
+        }
+        this.streams.clear();
+        this.closed = true;
+    }
+    onClose() {
+        for (const [, s] of this.streams) {
+            if (s.timer)
+                clearTimeout(s.timer);
+            s.reject(new HTTPError('HTTP/2 connection closed', 0));
+        }
+        this.streams.clear();
+        this.closed = true;
+    }
+}
+// ---- Body serialization ----
+function serializeBody(body) {
+    if (body === null || body === undefined)
+        return Buffer.alloc(0);
+    if (Buffer.isBuffer(body))
+        return body;
+    if (typeof body === 'string')
+        return Buffer.from(body, 'utf-8');
+    if (body instanceof URLSearchParams) {
+        return Buffer.from(body.toString(), 'utf-8');
+    }
+    if (typeof body === 'object' && !(body instanceof ReadableStream)) {
+        return Buffer.from(JSON.stringify(body), 'utf-8');
+    }
+    return Buffer.alloc(0);
+}
+//# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +1,65 @@
+/**
+ * HTTP/2 frame types and constants.
+ *
+ * Implements the binary frame format from RFC 7540 / RFC 9113.
+ */
+export declare const FrameType: {
+    readonly DATA: 0;
+    readonly HEADERS: 1;
+    readonly PRIORITY: 2;
+    readonly RST_STREAM: 3;
+    readonly SETTINGS: 4;
+    readonly PUSH_PROMISE: 5;
+    readonly PING: 6;
+    readonly GOAWAY: 7;
+    readonly WINDOW_UPDATE: 8;
+    readonly CONTINUATION: 9;
+};
+export declare const Flags: {
+    readonly END_STREAM: 1;
+    readonly ACK: 1;
+    readonly END_HEADERS: 4;
+    readonly PADDED: 8;
+    readonly PRIORITY: 32;
+};
+export declare const SettingsParam: {
+    readonly HEADER_TABLE_SIZE: 1;
+    readonly ENABLE_PUSH: 2;
+    readonly MAX_CONCURRENT_STREAMS: 3;
+    readonly INITIAL_WINDOW_SIZE: 4;
+    readonly MAX_FRAME_SIZE: 5;
+    readonly MAX_HEADER_LIST_SIZE: 6;
+};
+export interface H2Frame {
+    type: number;
+    flags: number;
+    streamId: number;
+    payload: Buffer;
+}
+/**
+ * Parse an HTTP/2 frame from a buffer.
+ *
+ * Returns the frame and bytes consumed, or null if incomplete.
+ */
+export declare function readFrame(data: Buffer, offset: number): {
+    frame: H2Frame;
+    bytesRead: number;
+} | null;
+/**
+ * Serialize an HTTP/2 frame to bytes.
+ */
+export declare function writeFrame(frame: H2Frame): Buffer;
+export declare function buildSettingsFrame(settings: Array<{
+    id: number;
+    value: number;
+}>, ack?: boolean): Buffer;
+export declare function buildWindowUpdateFrame(streamId: number, increment: number): Buffer;
+export declare function buildHeadersFrame(streamId: number, headerBlock: Buffer, endStream: boolean, endHeaders: boolean): Buffer;
+export declare function buildDataFrame(streamId: number, data: Buffer, endStream: boolean): Buffer;
+export declare function buildPriorityFrame(streamId: number, exclusive: boolean, dependsOn: number, weight: number): Buffer;
+export declare function buildGoawayFrame(lastStreamId: number, errorCode: number): Buffer;
+export declare function buildPingFrame(data: Buffer, ack?: boolean): Buffer;
+export declare function buildRstStreamFrame(streamId: number, errorCode: number): Buffer;
+/** HTTP/2 connection preface magic. */
+export declare const H2_PREFACE: Buffer<ArrayBuffer>;
+//# sourceMappingURL=frames.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frames.d.ts","sourceRoot":"","sources":["../../../src/http/h2/frames.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,eAAO,MAAM,SAAS;;;;;;;;;;;CAWZ,CAAC;AAIX,eAAO,MAAM,KAAK;;;;;;CAMR,CAAC;AAIX,eAAO,MAAM,aAAa;;;;;;;CAOhB,CAAC;AAIX,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAuBpG;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAejD;AAID,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAC9C,GAAG,UAAQ,GACV,MAAM,CAoBR;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,MAAM,CASR;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,OAAO,EAClB,UAAU,EAAE,OAAO,GAClB,MAAM,CAUR;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,OAAO,GACjB,MAAM,CASR;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,MAAM,CAYR;AAED,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,MAAM,CAUR;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAQ,GAAG,MAAM,CAShE;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,MAAM,CASR;AAED,uCAAuC;AACvC,eAAO,MAAM,UAAU,qBAA2D,CAAC"}

package/dist/http/h2/frames.js

@@ -0,0 +1,184 @@
+/**
+ * HTTP/2 frame types and constants.
+ *
+ * Implements the binary frame format from RFC 7540 / RFC 9113.
+ */
+import { BufferWriter } from '../../utils/buffer-writer.js';
+// ---- Frame types ----
+export const FrameType = {
+    DATA: 0x0,
+    HEADERS: 0x1,
+    PRIORITY: 0x2,
+    RST_STREAM: 0x3,
+    SETTINGS: 0x4,
+    PUSH_PROMISE: 0x5,
+    PING: 0x6,
+    GOAWAY: 0x7,
+    WINDOW_UPDATE: 0x8,
+    CONTINUATION: 0x9,
+};
+// ---- Flags ----
+export const Flags = {
+    END_STREAM: 0x1,
+    ACK: 0x1,
+    END_HEADERS: 0x4,
+    PADDED: 0x8,
+    PRIORITY: 0x20,
+};
+// ---- Settings parameters ----
+export const SettingsParam = {
+    HEADER_TABLE_SIZE: 0x1,
+    ENABLE_PUSH: 0x2,
+    MAX_CONCURRENT_STREAMS: 0x3,
+    INITIAL_WINDOW_SIZE: 0x4,
+    MAX_FRAME_SIZE: 0x5,
+    MAX_HEADER_LIST_SIZE: 0x6,
+};
+/**
+ * Parse an HTTP/2 frame from a buffer.
+ *
+ * Returns the frame and bytes consumed, or null if incomplete.
+ */
+export function readFrame(data, offset) {
+    if (data.length - offset < 9)
+        return null;
+    const length = (data[offset] << 16) |
+        (data[offset + 1] << 8) |
+        data[offset + 2];
+    const type = data[offset + 3];
+    const flags = data[offset + 4];
+    const streamId = ((data[offset + 5] & 0x7f) << 24) |
+        (data[offset + 6] << 16) |
+        (data[offset + 7] << 8) |
+        data[offset + 8];
+    if (data.length - offset - 9 < length)
+        return null;
+    const payload = data.subarray(offset + 9, offset + 9 + length);
+    return {
+        frame: { type, flags, streamId, payload },
+        bytesRead: 9 + length,
+    };
+}
+/**
+ * Serialize an HTTP/2 frame to bytes.
+ */
+export function writeFrame(frame) {
+    const w = new BufferWriter(9 + frame.payload.length);
+    // Length (24-bit)
+    w.writeUInt8((frame.payload.length >> 16) & 0xff);
+    w.writeUInt8((frame.payload.length >> 8) & 0xff);
+    w.writeUInt8(frame.payload.length & 0xff);
+    // Type
+    w.writeUInt8(frame.type);
+    // Flags
+    w.writeUInt8(frame.flags);
+    // Stream ID (31-bit, MSB reserved)
+    w.writeUInt32(frame.streamId & 0x7fffffff);
+    // Payload
+    w.writeBytes(frame.payload);
+    return w.toBuffer();
+}
+// ---- Frame builders ----
+export function buildSettingsFrame(settings, ack = false) {
+    if (ack) {
+        return writeFrame({
+            type: FrameType.SETTINGS,
+            flags: Flags.ACK,
+            streamId: 0,
+            payload: Buffer.alloc(0),
+        });
+    }
+    const w = new BufferWriter(settings.length * 6);
+    for (const s of settings) {
+        w.writeUInt16(s.id);
+        w.writeUInt32(s.value);
+    }
+    return writeFrame({
+        type: FrameType.SETTINGS,
+        flags: 0,
+        streamId: 0,
+        payload: w.toBuffer(),
+    });
+}
+export function buildWindowUpdateFrame(streamId, increment) {
+    const w = new BufferWriter(4);
+    w.writeUInt32(increment & 0x7fffffff);
+    return writeFrame({
+        type: FrameType.WINDOW_UPDATE,
+        flags: 0,
+        streamId,
+        payload: w.toBuffer(),
+    });
+}
+export function buildHeadersFrame(streamId, headerBlock, endStream, endHeaders) {
+    let flags = 0;
+    if (endStream)
+        flags |= Flags.END_STREAM;
+    if (endHeaders)
+        flags |= Flags.END_HEADERS;
+    return writeFrame({
+        type: FrameType.HEADERS,
+        flags,
+        streamId,
+        payload: headerBlock,
+    });
+}
+export function buildDataFrame(streamId, data, endStream) {
+    let flags = 0;
+    if (endStream)
+        flags |= Flags.END_STREAM;
+    return writeFrame({
+        type: FrameType.DATA,
+        flags,
+        streamId,
+        payload: data,
+    });
+}
+export function buildPriorityFrame(streamId, exclusive, dependsOn, weight) {
+    const w = new BufferWriter(5);
+    let dep = dependsOn & 0x7fffffff;
+    if (exclusive)
+        dep |= 0x80000000;
+    w.writeUInt32(dep);
+    w.writeUInt8(weight - 1); // RFC: weight = value + 1
+    return writeFrame({
+        type: FrameType.PRIORITY,
+        flags: 0,
+        streamId,
+        payload: w.toBuffer(),
+    });
+}
+export function buildGoawayFrame(lastStreamId, errorCode) {
+    const w = new BufferWriter(8);
+    w.writeUInt32(lastStreamId & 0x7fffffff);
+    w.writeUInt32(errorCode);
+    return writeFrame({
+        type: FrameType.GOAWAY,
+        flags: 0,
+        streamId: 0,
+        payload: w.toBuffer(),
+    });
+}
+export function buildPingFrame(data, ack = false) {
+    const payload = Buffer.alloc(8);
+    data.copy(payload, 0, 0, Math.min(8, data.length));
+    return writeFrame({
+        type: FrameType.PING,
+        flags: ack ? Flags.ACK : 0,
+        streamId: 0,
+        payload,
+    });
+}
+export function buildRstStreamFrame(streamId, errorCode) {
+    const w = new BufferWriter(4);
+    w.writeUInt32(errorCode);
+    return writeFrame({
+        type: FrameType.RST_STREAM,
+        flags: 0,
+        streamId,
+        payload: w.toBuffer(),
+    });
+}
+/** HTTP/2 connection preface magic. */
+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

@@ -0,0 +1 @@
+{"version":3,"file":"frames.js","sourceRoot":"","sources":["../../../src/http/h2/frames.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,wBAAwB;AAExB,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,IAAI,EAAE,GAAG;IACT,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,IAAI,EAAE,GAAG;IACT,MAAM,EAAE,GAAG;IACX,aAAa,EAAE,GAAG;IAClB,YAAY,EAAE,GAAG;CACT,CAAC;AAEX,kBAAkB;AAElB,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,UAAU,EAAE,GAAG;IACf,GAAG,EAAE,GAAG;IACR,WAAW,EAAE,GAAG;IAChB,MAAM,EAAE,GAAG;IACX,QAAQ,EAAE,IAAI;CACN,CAAC;AAEX,gCAAgC;AAEhC,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,iBAAiB,EAAE,GAAG;IACtB,WAAW,EAAE,GAAG;IAChB,sBAAsB,EAAE,GAAG;IAC3B,mBAAmB,EAAE,GAAG;IACxB,cAAc,EAAE,GAAG;IACnB,oBAAoB,EAAE,GAAG;CACjB,CAAC;AAWX;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,MAAc;IACpD,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1C,MAAM,MAAM,GACV,CAAC,IAAI,CAAC,MAAM,CAAE,IAAI,EAAE,CAAC;QACrB,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;IACpB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;IAChC,MAAM,QAAQ,GACZ,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAClC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,IAAI,EAAE,CAAC;QACzB,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;IAEpB,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,MAAM;QAAE,OAAO,IAAI,CAAC;IAEnD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IAE/D,OAAO;QACL,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE;QACzC,SAAS,EAAE,CAAC,GAAG,MAAM;KACtB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,MAAM,CAAC,GAAG,IAAI,YAAY,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,kBAAkB;IAClB,CAAC,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IAClD,CAAC,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACjD,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1C,OAAO;IACP,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzB,QAAQ;IACR,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,mCAAmC;IACnC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC,CAAC;IAC3C,UAAU;IACV,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;AACtB,CAAC;AAED,2BAA2B;AAE3B,MAAM,UAAU,kBAAkB,CAChC,QAA8C,EAC9C,GAAG,GAAG,KAAK;IAEX,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,UAAU,CAAC;YAChB,IAAI,EAAE,SAAS,CAAC,QAAQ;YACxB,KAAK,EAAE,KAAK,CAAC,GAAG;YAChB,QAAQ,EAAE,CAAC;YACX,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;SACzB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,CAAC,GAAG,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACpB,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,SAAS,CAAC,QAAQ;QACxB,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;KACtB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,QAAgB,EAChB,SAAiB;IAEjB,MAAM,CAAC,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC,CAAC,WAAW,CAAC,SAAS,GAAG,UAAU,CAAC,CAAC;IACtC,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,SAAS,CAAC,aAAa;QAC7B,KAAK,EAAE,CAAC;QACR,QAAQ;QACR,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;KACtB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,WAAmB,EACnB,SAAkB,EAClB,UAAmB;IAEnB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,SAAS;QAAE,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC;IACzC,IAAI,UAAU;QAAE,KAAK,IAAI,KAAK,CAAC,WAAW,CAAC;IAC3C,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,SAAS,CAAC,OAAO;QACvB,KAAK;QACL,QAAQ;QACR,OAAO,EAAE,WAAW;KACrB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,IAAY,EACZ,SAAkB;IAElB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,SAAS;QAAE,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC;IACzC,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,KAAK;QACL,QAAQ;QACR,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,SAAkB,EAClB,SAAiB,EACjB,MAAc;IAEd,MAAM,CAAC,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,GAAG,GAAG,SAAS,GAAG,UAAU,CAAC;IACjC,IAAI,SAAS;QAAE,GAAG,IAAI,UAAU,CAAC;IACjC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,0BAA0B;IACpD,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,SAAS,CAAC,QAAQ;QACxB,KAAK,EAAE,CAAC;QACR,QAAQ;QACR,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;KACtB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,YAAoB,EACpB,SAAiB;IAEjB,MAAM,CAAC,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC,CAAC,WAAW,CAAC,YAAY,GAAG,UAAU,CAAC,CAAC;IACzC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IACzB,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,SAAS,CAAC,MAAM;QACtB,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;KACtB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,GAAG,GAAG,KAAK;IACtD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC1B,QAAQ,EAAE,CAAC;QACX,OAAO;KACR,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,SAAiB;IAEjB,MAAM,CAAC,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IACzB,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,SAAS,CAAC,UAAU;QAC1B,KAAK,EAAE,CAAC;QACR,QAAQ;QACR,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;KACtB,CAAC,CAAC;AACL,CAAC;AAED,uCAAuC;AACvC,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE,OAAO,CAAC,CAAC"}