lox-airplay-sender 0.1.0

package/dist/esm/index.js

@@ -0,0 +1,265 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoxAirplaySender = void 0;
+exports.start = start;
+const node_events_1 = require("node:events");
+// Airtunes implementation (node_airtunes2 port) in src/core.
+const index_1 = __importDefault(require("./core/index"));
+const config_1 = __importDefault(require("./utils/config"));
+class LoxAirplaySender extends node_events_1.EventEmitter {
+    airtunes = null;
+    deviceKey = null;
+    started = false;
+    source = null;
+    log;
+    lastTrackKey = null;
+    lastCoverKey = null;
+    lastProgressKey = null;
+    lastCoverUrl = null;
+    coverFetch;
+    artworkTimer;
+    pendingArtwork;
+    lastTrackChangeAt = 0;
+    /**
+     * Create + start a sender for a single AirPlay device.
+     * Returns true when the pipeline initializes; safe to call multiple times to restart.
+     */
+    start(options, onEvent) {
+        if (this.started) {
+            this.stop();
+        }
+        this.log = options.log;
+        const inputCodec = options.inputCodec ?? 'pcm';
+        config_1.default.packet_size = inputCodec === 'alac' ? config_1.default.alac_packet_size : config_1.default.pcm_packet_size;
+        this.airtunes = new index_1.default({
+            packetSize: config_1.default.packet_size,
+            startTimeMs: options.startTimeMs,
+        });
+        this.airtunes.on('device', (key, status, desc) => {
+            onEvent?.({ event: 'device', message: status, detail: { key, desc } });
+        });
+        this.airtunes.on('buffer', (status) => {
+            onEvent?.({ event: 'buffer', message: status });
+        });
+        this.airtunes.on('error', (err) => {
+            onEvent?.({ event: 'error', message: err instanceof Error ? err.message : String(err) });
+        });
+        const dev = this.airtunes.add(options.host, {
+            port: options.port,
+            name: options.name,
+            password: options.password ?? null,
+            volume: options.volume ?? 50,
+            mode: options.mode ?? (options.airplay2 ? 2 : 0),
+            txt: options.txt ?? [],
+            forceAlac: options.forceAlac ?? true,
+            alacEncoding: options.alacEncoding ?? true,
+            inputCodec,
+            airplay2: options.airplay2 ?? false,
+            debug: options.debug ?? false,
+            log: options.log,
+        });
+        this.deviceKey = dev?.key ?? `${options.host}:${options.port ?? 5000}`;
+        this.started = true;
+        return true;
+    }
+    /**
+     * Push raw PCM or ALAC frames into the stream.
+     */
+    sendPcm(chunk) {
+        if (!this.airtunes || !this.started)
+            return;
+        this.airtunes.write(chunk);
+    }
+    /**
+     * Pipe a readable stream into the sender; auto-stops on end/error.
+     */
+    pipeStream(stream) {
+        if (!this.airtunes || !this.started)
+            return;
+        this.source = stream;
+        stream.on('data', (chunk) => this.sendPcm(chunk));
+        stream.on('end', () => this.stop());
+        stream.on('error', () => this.stop());
+    }
+    /** Adjust receiver volume (0–100). */
+    setVolume(volume) {
+        if (!this.airtunes || !this.deviceKey)
+            return;
+        this.airtunes.setVolume(this.deviceKey, volume);
+    }
+    /** Update track metadata immediately without artwork/progress. */
+    setTrackInfo(title, artist, album) {
+        if (!this.airtunes || !this.deviceKey)
+            return;
+        this.airtunes.setTrackInfo(this.deviceKey, title, artist, album);
+    }
+    /** Send cover art immediately. */
+    setArtwork(art, contentType) {
+        if (!this.airtunes || !this.deviceKey)
+            return;
+        this.airtunes.setArtwork(this.deviceKey, art, contentType);
+    }
+    /** Send playback progress in seconds (elapsed, duration). */
+    setProgress(progress, duration) {
+        if (!this.airtunes || !this.deviceKey)
+            return;
+        this.airtunes.setProgress(this.deviceKey, progress, duration);
+    }
+    /**
+     * Convenience to send track info, cover (buffer or URL), and progress.
+     * Deduplicates payloads and staggers artwork on track changes.
+     */
+    async setMetadata(payload) {
+        if (!this.airtunes || !this.deviceKey)
+            return;
+        const title = payload.title ?? '';
+        const artist = payload.artist ?? '';
+        const album = payload.album ?? '';
+        const trackKey = `${title}::${artist}::${album}`;
+        const trackChanged = Boolean(title && trackKey !== this.lastTrackKey);
+        if (trackChanged) {
+            this.setTrackInfo(title, artist, album);
+            this.lastTrackKey = trackKey;
+            this.lastCoverKey = null;
+            this.lastCoverUrl = null;
+            this.lastTrackChangeAt = Date.now();
+        }
+        let coverPayload = payload.cover;
+        const coverUrl = payload.coverUrl;
+        if (!coverPayload?.data && coverUrl) {
+            if (coverUrl !== this.lastCoverUrl && !this.coverFetch) {
+                this.lastCoverUrl = coverUrl;
+                this.lastCoverKey = null;
+                this.coverFetch = this.fetchCover(coverUrl).finally(() => {
+                    this.coverFetch = undefined;
+                });
+            }
+            if (this.coverFetch) {
+                coverPayload = (await this.coverFetch) ?? undefined;
+            }
+        }
+        if (coverPayload?.data) {
+            const coverKey = coverUrl
+                ? `${coverUrl}:${coverPayload.mime ?? 'unknown'}:${coverPayload.data.length}`
+                : `${coverPayload.mime ?? 'unknown'}:${coverPayload.data.length}`;
+            if (coverKey !== this.lastCoverKey) {
+                if (trackChanged) {
+                    this.queueArtwork(coverPayload, coverKey, 200);
+                }
+                else {
+                    this.sendArtworkNow(coverPayload, coverKey);
+                }
+            }
+        }
+        const durationInput = typeof payload.durationMs === 'number' && payload.durationMs > 0 ? payload.durationMs : null;
+        const elapsedInput = typeof payload.elapsedMs === 'number' && payload.elapsedMs >= 0 ? payload.elapsedMs : null;
+        const durationSec = durationInput !== null ? Math.floor(durationInput > 1000 ? durationInput / 1000 : durationInput) : null;
+        const elapsedSecRaw = elapsedInput !== null ? Math.floor(elapsedInput > 1000 ? elapsedInput / 1000 : elapsedInput) : null;
+        if (durationSec !== null && elapsedSecRaw !== null && durationSec > 0) {
+            const elapsedSec = Math.min(Math.max(0, elapsedSecRaw), durationSec);
+            const progressKey = `${elapsedSec}/${durationSec}`;
+            if (progressKey !== this.lastProgressKey) {
+                this.setProgress(elapsedSec, durationSec);
+                this.lastProgressKey = progressKey;
+            }
+        }
+    }
+    /** Provide a passcode when a receiver requests it. */
+    setPasscode(passcode) {
+        if (!this.airtunes || !this.deviceKey)
+            return;
+        this.airtunes.setPasscode(this.deviceKey, passcode);
+    }
+    /**
+     * Stop streaming and tear down state/sockets. Safe to call multiple times.
+     */
+    stop() {
+        if (this.source) {
+            try {
+                this.source.destroy();
+            }
+            catch {
+                // ignore
+            }
+            this.source = null;
+        }
+        this.lastTrackKey = null;
+        this.lastCoverKey = null;
+        this.lastProgressKey = null;
+        this.lastCoverUrl = null;
+        this.lastTrackChangeAt = 0;
+        this.pendingArtwork = undefined;
+        if (this.artworkTimer) {
+            clearTimeout(this.artworkTimer);
+            this.artworkTimer = undefined;
+        }
+        if (this.airtunes) {
+            if (this.deviceKey) {
+                this.airtunes.stop(this.deviceKey);
+            }
+            this.airtunes.stopAll?.(() => undefined);
+            this.airtunes.end?.();
+        }
+        this.airtunes = null;
+        this.deviceKey = null;
+        this.started = false;
+    }
+    async fetchCover(url) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 4000);
+        try {
+            const response = await fetch(url, { signal: controller.signal });
+            if (!response.ok) {
+                this.log?.('warn', 'airplay cover fetch failed', { status: response.status, url });
+                return null;
+            }
+            const mime = response.headers.get('content-type') || undefined;
+            const buffer = Buffer.from(await response.arrayBuffer());
+            if (!buffer.length) {
+                this.log?.('warn', 'airplay cover fetch empty', { url });
+                return null;
+            }
+            return { data: buffer, mime };
+        }
+        catch {
+            this.log?.('warn', 'airplay cover fetch error', { url });
+            return null;
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    sendArtworkNow(payload, coverKey) {
+        this.setArtwork(payload.data, payload.mime);
+        this.lastCoverKey = coverKey;
+    }
+    queueArtwork(payload, coverKey, delayMs) {
+        this.pendingArtwork = { ...payload, key: coverKey };
+        if (this.artworkTimer) {
+            clearTimeout(this.artworkTimer);
+        }
+        this.artworkTimer = setTimeout(() => {
+            this.artworkTimer = undefined;
+            const pending = this.pendingArtwork;
+            this.pendingArtwork = undefined;
+            if (!pending)
+                return;
+            if (pending.key === this.lastCoverKey)
+                return;
+            this.sendArtworkNow({ data: pending.data, mime: pending.mime }, pending.key);
+        }, delayMs);
+    }
+}
+exports.LoxAirplaySender = LoxAirplaySender;
+/**
+ * Convenience helper to construct + start a sender in one call.
+ */
+function start(options, onEvent) {
+    const sender = new LoxAirplaySender();
+    sender.start(options, onEvent);
+    return sender;
+}
+exports.default = LoxAirplaySender;

package/dist/esm/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/dist/esm/utils/alac.js

@@ -0,0 +1,62 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALAC_PACKET_SIZE = exports.PCM_PACKET_SIZE = void 0;
+exports.encodePcmToAlac = encodePcmToAlac;
+const config_1 = __importDefault(require("./config"));
+/** PCM packet size (bytes) expected by the encoder. */
+exports.PCM_PACKET_SIZE = config_1.default.pcm_packet_size;
+/** Output ALAC packet size (bytes). */
+exports.ALAC_PACKET_SIZE = config_1.default.alac_packet_size;
+/**
+ * Encode one PCM frame (16-bit LE stereo, 44.1kHz) into ALAC.
+ * Input must be exactly `PCM_PACKET_SIZE` bytes.
+ */
+function encodePcmToAlac(pcmData) {
+    let alacData = Buffer.alloc(exports.ALAC_PACKET_SIZE);
+    const bsize = 352;
+    const frames = 352;
+    const p = new Uint8Array(exports.ALAC_PACKET_SIZE);
+    const input = new Uint32Array(pcmData.length / 4);
+    let j = 0;
+    for (let i = 0; i < pcmData.length; i += 4) {
+        let res = pcmData[i];
+        res |= pcmData[i + 1] << 8;
+        res |= pcmData[i + 2] << 16;
+        res |= pcmData[i + 3] << 24;
+        input[j++] = res;
+    }
+    let pindex = 0;
+    let iindex = 0;
+    p[pindex++] = 1 << 5;
+    p[pindex++] = 0;
+    p[pindex++] = (1 << 4) | (1 << 1) | ((bsize & 0x80000000) >>> 31);
+    p[pindex++] = ((bsize & 0x7f800000) << 1) >>> 24;
+    p[pindex++] = ((bsize & 0x007f8000) << 1) >>> 16;
+    p[pindex++] = ((bsize & 0x00007f80) << 1) >>> 8;
+    p[pindex] = (bsize & 0x0000007f) << 1;
+    p[pindex++] |= (input[iindex] & 0x00008000) >>> 15;
+    let count = frames - 1;
+    while (count--) {
+        const i = input[iindex++];
+        p[pindex++] = (i & 0x00007f80) >>> 7;
+        p[pindex++] = ((i & 0x0000007f) << 1) | ((i & 0x80000000) >>> 31);
+        p[pindex++] = (i & 0x7f800000) >>> 23;
+        p[pindex++] = ((i & 0x007f0000) >>> 15) | ((input[iindex] & 0x00008000) >> 15);
+    }
+    const i = input[iindex];
+    p[pindex++] = (i & 0x00007f80) >>> 7;
+    p[pindex++] = ((i & 0x0000007f) << 1) | ((i & 0x80000000) >>> 31);
+    p[pindex++] = (i & 0x7f800000) >>> 23;
+    p[pindex++] = (i & 0x007f0000) >>> 15;
+    count = (bsize - frames) * 4;
+    while (count--)
+        p[pindex++] = 0;
+    p[pindex - 1] |= 1;
+    p[pindex++] = (7 >>> 1) << 6;
+    const alacSize = pindex;
+    alacData = Buffer.from(p.buffer);
+    return alacData.slice(0, alacSize);
+}

package/dist/esm/utils/alacEncoder.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlacEncoderStream = void 0;
+const node_stream_1 = require("node:stream");
+const alac_1 = require("./alac");
+/**
+ * Transforms PCM (16-bit LE, stereo, 44.1kHz) into fixed-size ALAC frames.
+ * Emits ALAC packets sized per `ALAC_PACKET_SIZE`.
+ */
+class AlacEncoderStream extends node_stream_1.Transform {
+    buffer = Buffer.alloc(0);
+    /** Create a streaming ALAC encoder for PCM input. */
+    constructor() {
+        super();
+    }
+    /**
+     * Buffer PCM until a full frame is available, then emit ALAC.
+     */
+    _transform(chunk, _encoding, callback) {
+        if (!chunk?.length) {
+            callback();
+            return;
+        }
+        this.buffer = (this.buffer.length ? Buffer.concat([this.buffer, chunk]) : chunk);
+        while (this.buffer.length >= alac_1.PCM_PACKET_SIZE) {
+            const frame = this.buffer.subarray(0, alac_1.PCM_PACKET_SIZE);
+            this.buffer = this.buffer.subarray(alac_1.PCM_PACKET_SIZE);
+            const alac = (0, alac_1.encodePcmToAlac)(frame);
+            this.push(alac);
+        }
+        callback();
+    }
+}
+exports.AlacEncoderStream = AlacEncoderStream;

package/dist/esm/utils/circularBuffer.js

@@ -0,0 +1,124 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_events_1 = require("node:events");
+const packetPool_1 = __importDefault(require("./packetPool"));
+const WAITING = 0;
+const FILLING = 1;
+const NORMAL = 2;
+const DRAINING = 3;
+const ENDING = 4;
+const ENDED = 5;
+/**
+ * Fixed-size circular buffer that smooths incoming PCM/ALAC chunks into fixed packet sizes.
+ * Emits status changes for buffering/playing/drain/end to drive UI + sync.
+ */
+class CircularBuffer extends node_events_1.EventEmitter {
+    packetPool;
+    maxSize;
+    packetSize;
+    writable = true;
+    muted = false;
+    buffers = [];
+    currentSize = 0;
+    status = WAITING;
+    constructor(packetsInBuffer, packetSize) {
+        super();
+        this.packetPool = new packetPool_1.default(packetSize);
+        this.maxSize = packetsInBuffer * packetSize;
+        this.packetSize = packetSize;
+    }
+    /**
+     * Write a PCM/ALAC chunk into the buffer.
+     * Returns false when the buffer is full so upstream can throttle.
+     */
+    write(chunk) {
+        this.buffers.push(chunk);
+        this.currentSize += chunk.length;
+        if (this.status === ENDING || this.status === ENDED) {
+            throw new Error('Cannot write in buffer after closing it');
+        }
+        if (this.status === WAITING) {
+            this.emit('status', 'buffering');
+            this.status = FILLING;
+        }
+        if (this.status === FILLING && this.currentSize > this.maxSize / 2) {
+            this.status = NORMAL;
+            this.emit('status', 'playing');
+        }
+        if (this.currentSize >= this.maxSize) {
+            this.status = DRAINING;
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Read the next fixed-size packet, zero-filling gaps to preserve timing.
+     */
+    readPacket() {
+        const packet = this.packetPool.getPacket();
+        if (this.status !== ENDING &&
+            this.status !== ENDED &&
+            (this.status === FILLING || this.currentSize < this.packetSize)) {
+            packet.pcm.fill(0);
+            if (this.status !== FILLING && this.status !== WAITING) {
+                this.status = FILLING;
+                this.emit('status', 'buffering');
+            }
+        }
+        else {
+            let offset = 0;
+            let remaining = this.packetSize;
+            while (remaining > 0) {
+                if (this.buffers.length === 0) {
+                    packet.pcm.fill(0, offset);
+                    remaining = 0;
+                    break;
+                }
+                const first = this.buffers[0];
+                if (first.length <= remaining) {
+                    first.copy(packet.pcm, offset);
+                    offset += first.length;
+                    remaining -= first.length;
+                    this.buffers.shift();
+                }
+                else {
+                    first.copy(packet.pcm, offset, 0, remaining);
+                    this.buffers[0] = first.slice(remaining);
+                    offset += remaining;
+                    remaining = 0;
+                }
+            }
+            this.currentSize -= this.packetSize;
+            if (this.status === ENDING && this.currentSize <= 0) {
+                this.status = ENDED;
+                this.currentSize = 0;
+                this.emit('status', 'end');
+            }
+            if (this.status === DRAINING && this.currentSize < this.maxSize / 2) {
+                this.status = NORMAL;
+                this.emit('drain');
+            }
+        }
+        if (this.muted) {
+            packet.pcm.fill(0);
+        }
+        return packet;
+    }
+    /** Mark the buffer as ending; drains then emits `end`. */
+    end() {
+        if (this.status === FILLING) {
+            this.emit('status', 'playing');
+        }
+        this.status = ENDING;
+    }
+    /** Clear internal buffers and state. */
+    reset() {
+        this.buffers = [];
+        this.currentSize = 0;
+        this.status = WAITING;
+    }
+}
+exports.default = CircularBuffer;

package/dist/esm/utils/config.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.config = void 0;
+const numUtil_1 = require("./numUtil");
+exports.config = {
+    user_agent: 'iTunes/11.3.1 (Windows; Microsoft Windows 10 x64 (Build 19044); x64) (dt:2)',
+    udp_default_port: 54621, // preferred starting port in AirTunes v2
+    frames_per_packet: 352, // samples per frames in ALAC packets
+    channels_per_frame: 2, // always stereo in AirTunes v2
+    bits_per_channel: 16, // -> 2 bytes per channel
+    pcm_packet_size: 352 * 2 * 2, // frames*channels*bytes
+    alac_packet_size: 352 * 2 * 2 + 8, // pcm payload + alac header/footer
+    packet_size: 352 * 2 * 2, // active packet size (depends on input codec)
+    packets_in_buffer: 260, // ~2.1s of audio (matches MA's ~2000ms buffer)
+    coreaudio_min_level: 5, // if CoreAudio's internal buffer drops too much, inject some silence to raise it
+    coreaudio_check_period: 2000, // CoreAudio buffer level check period
+    coreaudio_preload: 352 * 2 * 2 * 50, // ~0.5s of silence pushed to CoreAudio to avoid draining AudioQueue
+    sampling_rate: 44100, // fixed by AirTunes v2
+    sync_period: 126, // UDP sync packets are sent to all AirTunes devices regularly
+    stream_latency: 200, // audio UDP packets are flushed in bursts periodically
+    rtsp_timeout: 2147483647, // RTSP servers are considered gone if no reply is received before the timeout
+    rtsp_heartbeat: 15000, // some RTSP (like HomePod) servers requires heartbeat.
+    device_magic: (0, numUtil_1.randomInt)(9),
+    ntp_epoch: 0x83aa7e80,
+    iv_base64: 'ePRBLI0XN5ArFaaz7ncNZw',
+    rsa_aeskey_base64: 'VjVbxWcmYgbBbhwBNlCh3K0CMNtWoB844BuiHGUJT51zQS7SDpMnlbBIobsKbfEJ3SCgWHRXjYWf7VQWRYtEcfx7ejA8xDIk5PSBYTvXP5dU2QoGrSBv0leDS6uxlEWuxBq3lIxCxpWO2YswHYKJBt06Uz9P2Fq2hDUwl3qOQ8oXb0OateTKtfXEwHJMprkhsJsGDrIc5W5NJFMAo6zCiM9bGSDeH2nvTlyW6bfI/Q0v0cDGUNeY3ut6fsoafRkfpCwYId+bg3diJh+uzw5htHDyZ2sN+BFYHzEfo8iv4KDxzeya9llqg6fRNQ8d5YjpvTnoeEQ9ye9ivjkBjcAfVw',
+};
+exports.default = exports.config;

package/dist/esm/utils/http.js

@@ -0,0 +1,148 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_net_1 = __importDefault(require("node:net"));
+const HttpMessage = (parseStartLine, writeStartLine) => {
+    const instance = {
+        parse: () => ({ headers: {} }),
+        write: () => Buffer.alloc(0),
+    };
+    instance.parse = (buffer) => {
+        const messageObject = { headers: {} };
+        // ...
+        let bodyIndex = buffer.indexOf('\r\n\r\n');
+        let headerString = buffer.slice(0, bodyIndex).toString();
+        let body = buffer.slice(bodyIndex + 4);
+        headerString = headerString.replace(/\r\n/g, '\n');
+        const lines = headerString.split('\n');
+        bodyIndex += 2;
+        // ...
+        let line = lines.shift();
+        if (line) {
+            parseStartLine(line, messageObject);
+        }
+        // ...
+        line = lines.shift();
+        while (line) {
+            const headerName = line.substr(0, line.indexOf(':'));
+            const headerValue = line.substr(line.indexOf(':') + 1);
+            messageObject.headers[headerName] = headerValue.trim();
+            line = lines.shift();
+        }
+        // ...
+        if (messageObject.headers['Content-Length'] && messageObject.headers['Content-Length'] !== '0') {
+            messageObject.body = body;
+        }
+        return messageObject;
+    };
+    instance.write = (messageObject) => {
+        let messageString = writeStartLine(messageObject);
+        messageString += '\r\n';
+        if (messageObject.body) {
+            messageObject.headers['Content-Length'] = String(Buffer.byteLength(messageObject.body));
+        }
+        for (const header in messageObject.headers) {
+            messageString += `${header}: ${messageObject.headers[header]}\r\n`;
+        }
+        messageString += '\r\n';
+        const buffer = Buffer.from(messageString);
+        if (!messageObject.body) {
+            return buffer;
+        }
+        return Buffer.concat([buffer, messageObject.body], buffer.length + messageObject.body.length);
+    };
+    return instance;
+};
+const HttpRequest = () => HttpMessage(() => { }, // currently not parsing requests.
+(messageObject) => `${messageObject.method} ${messageObject.path} HTTP/1.1`);
+const HttpResponse = () => HttpMessage((line, messageObject) => {
+    messageObject.statusCode = parseInt(line.split(' ')[1], 10);
+}, () => '');
+// ...
+class HttpClient {
+    resolveQueue = [];
+    pendingResponse = null;
+    socket;
+    host;
+    // ....
+    parseResponse(data) {
+        const res = HttpResponse().parse(data);
+        if (res.headers['Content-Length'] && Number(res.headers['Content-Length']) > 0) {
+            const remaining = Number(res.headers['Content-Length']) - (res.body?.byteLength ?? 0);
+            if (remaining > 0) {
+                // not all data for this response's corresponding request was read. Create a pending response object
+                // to use for further reads.
+                this.pendingResponse = {
+                    res,
+                    remaining
+                };
+            }
+        }
+        if (!this.pendingResponse) {
+            const rr = this.resolveQueue.shift();
+            if (!rr)
+                return;
+            res.statusCode === 200
+                ? rr.resolve(res)
+                : rr.resolve(null);
+        }
+    }
+    // ...
+    connect(host, port = 80) {
+        this.host = host;
+        return new Promise(resolve => {
+            this.socket = node_net_1.default.connect({
+                host,
+                port
+            }, resolve);
+            this.socket.on('data', data => {
+                if (!this.pendingResponse) {
+                    // there is no response pending, parse the data.
+                    this.parseResponse(data);
+                }
+                else {
+                    // incoming data for the pending response.
+                    const existing = this.pendingResponse.res.body ?? Buffer.alloc(0);
+                    this.pendingResponse.res.body = Buffer.concat([existing, data], data.byteLength + existing.byteLength);
+                    this.pendingResponse.remaining -= data.byteLength;
+                    if (this.pendingResponse.remaining === 0) {
+                        // all remaining data for the pending response has been read; resolve the promise for the 
+                        // corresponding request.
+                        const rr = this.resolveQueue.shift();
+                        if (!rr) {
+                            this.pendingResponse = null;
+                            return;
+                        }
+                        this.pendingResponse.res.statusCode === 200
+                            ? rr.resolve(this.pendingResponse.res)
+                            : rr.reject(new Error(`HTTP status: ${this.pendingResponse.res.statusCode}`));
+                        this.pendingResponse = null;
+                    }
+                }
+            });
+        });
+    }
+    request(method, path, headers, body) {
+        headers = headers || {};
+        // headers['Host'] = `${this.host}:${this.socket.remotePort}`;
+        const data = HttpRequest().write({
+            method,
+            path,
+            headers,
+            body
+        });
+        // ...
+        return new Promise((resolve, reject) => {
+            this.resolveQueue.push({ resolve, reject });
+            this.socket?.write(data);
+        });
+    }
+    close() {
+        this.socket?.end();
+    }
+}
+// ...
+const createHttpClient = () => new HttpClient();
+exports.default = createHttpClient;