snapreq 0.0.4 → 0.0.8

package/build/transports/node-transport.js

@@ -0,0 +1,287 @@
+// @ts-check
+import { buildCapabilities } from "../capabilities.js";
+import { SnapReqAbortError, SnapReqUnsupportedFeatureError } from "../errors.js";
+import SnapReqHeaders from "../headers.js";
+import SnapReqResponse from "../response.js";
+/**
+ * Full-featured transport backed by Node's `http`/`https` modules. Supports
+ * Unix sockets, client TLS, keep-alive, request-body compression, response
+ * decompression and streaming. The `node:*` modules are loaded with a dynamic
+ * `import()` so this file never has to be bundled by web/Expo bundlers — the
+ * transport selector only imports it when running on Node.
+ */
+export default class NodeTransport {
+    /** @returns {string} - Transport name. */
+    static get transportName() {
+        return "node";
+    }
+    /** @returns {boolean} - Whether this transport can run in the current environment. */
+    static isAvailable() {
+        return typeof process !== "undefined" && Boolean(process.versions?.node);
+    }
+    /**
+     * @param {object} [config] - Transport configuration.
+     * @param {string} [config.socketPath] - Unix domain socket path.
+     * @param {{ca?: string | Buffer, cert?: string | Buffer, key?: string | Buffer, rejectUnauthorized?: boolean}} [config.tls] - TLS material for HTTPS connections.
+     * @param {boolean} [config.keepAlive] - Reuse connections across requests. Defaults to true.
+     */
+    constructor({ socketPath, tls, keepAlive = true } = {}) {
+        this.socketPath = socketPath;
+        this.tls = tls;
+        this.keepAlive = keepAlive;
+        /** @type {{http: any, https: any, zlib: any, stream: any} | null} */
+        this._modules = null;
+        /** @type {any} */
+        this._httpAgent = null;
+        /** @type {any} */
+        this._httpsAgent = null;
+    }
+    /** @returns {import("../capabilities.js").TransportCapabilities} - Supported capabilities. */
+    get capabilities() {
+        return buildCapabilities({
+            unixSocket: true,
+            tlsClientCert: true,
+            requestCompression: true,
+            responseStreaming: true,
+            requestStreaming: true,
+            keepAlive: true,
+            abort: true
+        });
+    }
+    /** @returns {Promise<{http: any, https: any, zlib: any, stream: any}>} - Lazily-loaded Node modules. */
+    async _load() {
+        if (!this._modules) {
+            const [http, https, zlib, stream] = await Promise.all([
+                import("node:http"),
+                import("node:https"),
+                import("node:zlib"),
+                import("node:stream")
+            ]);
+            this._modules = { http, https, zlib, stream };
+        }
+        return this._modules;
+    }
+    /**
+     * @param {boolean} useTls - Whether the request uses TLS.
+     * @returns {any} - The keep-alive agent for the protocol.
+     */
+    _agent(useTls) {
+        const { http, https } = /** @type {{http: any, https: any}} */ (this._modules);
+        if (useTls) {
+            this._httpsAgent || (this._httpsAgent = new https.Agent({
+                keepAlive: this.keepAlive,
+                ...(this.tls?.ca !== undefined ? { ca: this.tls.ca } : {}),
+                ...(this.tls?.cert !== undefined ? { cert: this.tls.cert } : {}),
+                ...(this.tls?.key !== undefined ? { key: this.tls.key } : {}),
+                ...(this.tls?.rejectUnauthorized !== undefined ? { rejectUnauthorized: this.tls.rejectUnauthorized } : {})
+            }));
+            return this._httpsAgent;
+        }
+        this._httpAgent || (this._httpAgent = new http.Agent({ keepAlive: this.keepAlive }));
+        return this._httpAgent;
+    }
+    /**
+     * Performs a single request and resolves once the response headers arrive,
+     * exposing the (decoded) body as a stream so callers can buffer or stream it.
+     * @param {import("../snap-req.js").NormalizedRequest} request - Normalized request.
+     * @returns {Promise<SnapReqResponse>} - The response.
+     */
+    async performRequest(request) {
+        const modules = await this._load();
+        const { zlib, stream } = modules;
+        const parsedUrl = new URL(request.url);
+        const useTls = Boolean(this.tls) || parsedUrl.protocol === "https:";
+        const httpModule = useTls ? modules.https : modules.http;
+        const headers = new SnapReqHeaders(request.headers);
+        const requestBody = this._prepareRequestBody(request, headers, { zlib, stream });
+        /** @type {Record<string, any>} */
+        const requestOptions = {
+            method: request.method,
+            path: `${parsedUrl.pathname}${parsedUrl.search}`,
+            headers: headers.toObject(),
+            agent: this._agent(useTls)
+        };
+        if (this.socketPath) {
+            requestOptions.socketPath = this.socketPath;
+        }
+        else {
+            requestOptions.hostname = parsedUrl.hostname;
+            requestOptions.port = parsedUrl.port || (useTls ? 443 : 80);
+        }
+        return await new Promise((resolve, reject) => {
+            if (request.signal?.aborted) {
+                reject(new SnapReqAbortError());
+                return;
+            }
+            let settled = false;
+            const abort = () => req.destroy(new SnapReqAbortError());
+            const removeAbortListener = () => request.signal?.removeEventListener("abort", abort);
+            const req = httpModule.request(requestOptions, (res) => {
+                /** @type {import("node:stream").Readable} */
+                let responseStream;
+                try {
+                    responseStream = this._decodeResponseStream(res, zlib);
+                }
+                catch (error) {
+                    if (!settled) {
+                        settled = true;
+                        removeAbortListener();
+                        reject(error);
+                    }
+                    return;
+                }
+                // Re-point the abort listener at the response stream so aborting after
+                // headers arrive tears down the body stream rather than the request.
+                removeAbortListener();
+                const abortStream = () => responseStream.destroy(new SnapReqAbortError());
+                request.signal?.addEventListener("abort", abortStream, { once: true });
+                responseStream.on("close", () => request.signal?.removeEventListener("abort", abortStream));
+                settled = true;
+                resolve(new SnapReqResponse({
+                    url: request.url,
+                    method: request.method,
+                    status: res.statusCode,
+                    statusText: res.statusMessage || "",
+                    headers: this._responseHeaders(res),
+                    stream: responseStream,
+                    nodeStream: responseStream
+                }));
+            });
+            request.signal?.addEventListener("abort", abort, { once: true });
+            req.on("error", (/** @type {unknown} */ error) => {
+                removeAbortListener();
+                if (!settled) {
+                    settled = true;
+                    reject(error);
+                }
+            });
+            if (requestBody.stream) {
+                requestBody.stream.pipe(req);
+            }
+            else {
+                if (requestBody.buffer)
+                    req.write(requestBody.buffer);
+                req.end();
+            }
+        });
+    }
+    /**
+     * @param {import("../snap-req.js").NormalizedRequest} request - Normalized request.
+     * @param {SnapReqHeaders} headers - Headers, mutated with Content-Length / Content-Encoding.
+     * @param {{zlib: any, stream: any}} modules - Node modules.
+     * @returns {{buffer: Buffer | null, stream: import("node:stream").Readable | null}} - Prepared body.
+     */
+    _prepareRequestBody(request, headers, { zlib, stream }) {
+        const compression = request.bodyCompression || "identity";
+        const body = request.body;
+        if (body.kind === "none")
+            return { buffer: null, stream: null };
+        /** @type {Buffer | null} */
+        let buffer = null;
+        /** @type {import("node:stream").Readable | null} */
+        let bodyStream = null;
+        if (body.kind === "stream") {
+            const value = /** @type {any} */ (body.value);
+            bodyStream = typeof value.pipe === "function" ? value : stream.Readable.from(value);
+        }
+        else if (body.kind === "bytes") {
+            buffer = Buffer.from(/** @type {Uint8Array} */ (body.value));
+        }
+        else {
+            buffer = Buffer.from(/** @type {string} */ (body.value));
+        }
+        if (compression === "identity") {
+            if (buffer)
+                headers.set("Content-Length", String(buffer.length));
+            return { buffer, stream: bodyStream };
+        }
+        if (headers.has("content-encoding")) {
+            throw new SnapReqUnsupportedFeatureError({
+                feature: "bodyCompression",
+                transport: "node",
+                detail: "cannot combine bodyCompression with an explicit Content-Encoding header"
+            });
+        }
+        headers.set("Content-Encoding", compression);
+        const compressor = this._requestCompressor(compression, zlib);
+        const source = bodyStream || stream.Readable.from(/** @type {Buffer} */ (buffer));
+        source.on("error", (/** @type {Error} */ error) => compressor.destroy(error));
+        source.pipe(compressor);
+        return { buffer: null, stream: compressor };
+    }
+    /**
+     * @param {string} encoding - Compression encoding.
+     * @param {any} zlib - The zlib module.
+     * @returns {import("node:stream").Transform} - A compressor transform.
+     */
+    _requestCompressor(encoding, zlib) {
+        if (encoding === "gzip")
+            return zlib.createGzip();
+        if (encoding === "deflate")
+            return zlib.createDeflate();
+        if (encoding === "br")
+            return zlib.createBrotliCompress();
+        if (encoding === "zstd" && typeof zlib.createZstdCompress === "function")
+            return zlib.createZstdCompress();
+        throw new SnapReqUnsupportedFeatureError({ feature: `bodyCompression "${encoding}"`, transport: "node" });
+    }
+    /**
+     * @param {import("node:http").IncomingMessage} response - The raw response.
+     * @param {any} zlib - The zlib module.
+     * @returns {import("node:stream").Readable} - The decoded response body stream.
+     */
+    _decodeResponseStream(response, zlib) {
+        const header = response.headers["content-encoding"];
+        const headerValue = Array.isArray(header) ? header.join(",") : header;
+        const encodings = (headerValue || "")
+            .split(",")
+            .map((encoding) => encoding.trim().toLowerCase())
+            .filter((encoding) => encoding && encoding !== "identity");
+        /** @type {import("node:stream").Readable} */
+        let decoded = response;
+        for (let index = encodings.length - 1; index >= 0; index -= 1) {
+            decoded = decoded.pipe(this._responseDecoder(encodings[index], zlib));
+        }
+        return decoded;
+    }
+    /**
+     * @param {string} encoding - Content encoding.
+     * @param {any} zlib - The zlib module.
+     * @returns {import("node:stream").Transform} - A decompressor transform.
+     */
+    _responseDecoder(encoding, zlib) {
+        if (encoding === "gzip" || encoding === "x-gzip")
+            return zlib.createGunzip();
+        if (encoding === "deflate")
+            return zlib.createInflate();
+        if (encoding === "br")
+            return zlib.createBrotliDecompress();
+        if (encoding === "zstd" && typeof zlib.createZstdDecompress === "function")
+            return zlib.createZstdDecompress();
+        throw new SnapReqUnsupportedFeatureError({ feature: `response content-encoding "${encoding}"`, transport: "node" });
+    }
+    /**
+     * @param {import("node:http").IncomingMessage} response - The raw response.
+     * @returns {SnapReqHeaders} - The response headers.
+     */
+    _responseHeaders(response) {
+        const headers = new SnapReqHeaders();
+        for (const [name, value] of Object.entries(response.headers)) {
+            if (value === undefined)
+                continue;
+            headers.set(name, Array.isArray(value) ? value.join(", ") : value);
+        }
+        return headers;
+    }
+    /**
+     * Destroys the keep-alive agents, closing all persistent connections.
+     * @returns {void}
+     */
+    close() {
+        this._httpAgent?.destroy();
+        this._httpsAgent?.destroy();
+        this._httpAgent = null;
+        this._httpsAgent = null;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibm9kZS10cmFuc3BvcnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdHJhbnNwb3J0cy9ub2RlLXRyYW5zcG9ydC5qcyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxZQUFZO0FBRVosT0FBTyxFQUFDLGlCQUFpQixFQUFDLE1BQU0sb0JBQW9CLENBQUE7QUFDcEQsT0FBTyxFQUFDLGlCQUFpQixFQUFFLDhCQUE4QixFQUFDLE1BQU0sY0FBYyxDQUFBO0FBQzlFLE9BQU8sY0FBYyxNQUFNLGVBQWUsQ0FBQTtBQUMxQyxPQUFPLGVBQWUsTUFBTSxnQkFBZ0IsQ0FBQTtBQUU1Qzs7Ozs7O0dBTUc7QUFDSCxNQUFNLENBQUMsT0FBTyxPQUFPLGFBQWE7SUFDaEMsMENBQTBDO0lBQzFDLE1BQU0sS0FBSyxhQUFhO1FBQ3RCLE9BQU8sTUFBTSxDQUFBO0lBQ2YsQ0FBQztJQUVELHNGQUFzRjtJQUN0RixNQUFNLENBQUMsV0FBVztRQUNoQixPQUFPLE9BQU8sT0FBTyxLQUFLLFdBQVcsSUFBSSxPQUFPLENBQUMsT0FBTyxDQUFDLFFBQVEsRUFBRSxJQUFJLENBQUMsQ0FBQTtJQUMxRSxDQUFDO0lBRUQ7Ozs7O09BS0c7SUFDSCxZQUFZLEVBQUMsVUFBVSxFQUFFLEdBQUcsRUFBRSxTQUFTLEdBQUcsSUFBSSxFQUFDLEdBQUcsRUFBRTtRQUNsRCxJQUFJLENBQUMsVUFBVSxHQUFHLFVBQVUsQ0FBQTtRQUM1QixJQUFJLENBQUMsR0FBRyxHQUFHLEdBQUcsQ0FBQTtRQUNkLElBQUksQ0FBQyxTQUFTLEdBQUcsU0FBUyxDQUFBO1FBQzFCLHFFQUFxRTtRQUNyRSxJQUFJLENBQUMsUUFBUSxHQUFHLElBQUksQ0FBQTtRQUNwQixrQkFBa0I7UUFDbEIsSUFBSSxDQUFDLFVBQVUsR0FBRyxJQUFJLENBQUE7UUFDdEIsa0JBQWtCO1FBQ2xCLElBQUksQ0FBQyxXQUFXLEdBQUcsSUFBSSxDQUFBO0lBQ3pCLENBQUM7SUFFRCw4RkFBOEY7SUFDOUYsSUFBSSxZQUFZO1FBQ2QsT0FBTyxpQkFBaUIsQ0FBQztZQUN2QixVQUFVLEVBQUUsSUFBSTtZQUNoQixhQUFhLEVBQUUsSUFBSTtZQUNuQixrQkFBa0IsRUFBRSxJQUFJO1lBQ3hCLGlCQUFpQixFQUFFLElBQUk7WUFDdkIsZ0JBQWdCLEVBQUUsSUFBSTtZQUN0QixTQUFTLEVBQUUsSUFBSTtZQUNmLEtBQUssRUFBRSxJQUFJO1NBQ1osQ0FBQyxDQUFBO0lBQ0osQ0FBQztJQUVELHdHQUF3RztJQUN4RyxLQUFLLENBQUMsS0FBSztRQUNULElBQUksQ0FBQyxJQUFJLENBQUMsUUFBUSxFQUFFLENBQUM7WUFDbkIsTUFBTSxDQUFDLElBQUksRUFBRSxLQUFLLEVBQUUsSUFBSSxFQUFFLE1BQU0sQ0FBQyxHQUFHLE1BQU0sT0FBTyxDQUFDLEdBQUcsQ0FBQztnQkFDcEQsTUFBTSxDQUFDLFdBQVcsQ0FBQztnQkFDbkIsTUFBTSxDQUFDLFlBQVksQ0FBQztnQkFDcEIsTUFBTSxDQUFDLFdBQVcsQ0FBQztnQkFDbkIsTUFBTSxDQUFDLGFBQWEsQ0FBQzthQUN0QixDQUFDLENBQUE7WUFFRixJQUFJLENBQUMsUUFBUSxHQUFHLEVBQUMsSUFBSSxFQUFFLEtBQUssRUFBRSxJQUFJLEVBQUUsTUFBTSxFQUFDLENBQUE7UUFDN0MsQ0FBQztRQUVELE9BQU8sSUFBSSxDQUFDLFFBQVEsQ0FBQTtJQUN0QixDQUFDO0lBRUQ7OztPQUdHO0lBQ0gsTUFBTSxDQUFDLE1BQU07UUFDWCxNQUFNLEVBQUMsSUFBSSxFQUFFLEtBQUssRUFBQyxHQUFHLHNDQUFzQyxDQUFDLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxDQUFBO1FBRTVFLElBQUksTUFBTSxFQUFFLENBQUM7WUFDWCxJQUFJLENBQUMsV0FBVyxLQUFoQixJQUFJLENBQUMsV0FBVyxHQUFLLElBQUksS0FBSyxDQUFDLEtBQUssQ0FBQztnQkFDbkMsU0FBUyxFQUFFLElBQUksQ0FBQyxTQUFTO2dCQUN6QixHQUFHLENBQUMsSUFBSSxDQUFDLEdBQUcsRUFBRSxFQUFFLEtBQUssU0FBUyxDQUFDLENBQUMsQ0FBQyxFQUFDLEVBQUUsRUFBRSxJQUFJLENBQUMsR0FBRyxDQUFDLEVBQUUsRUFBQyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUM7Z0JBQ3hELEdBQUcsQ0FBQyxJQUFJLENBQUMsR0FBRyxFQUFFLElBQUksS0FBSyxTQUFTLENBQUMsQ0FBQyxDQUFDLEVBQUMsSUFBSSxFQUFFLElBQUksQ0FBQyxHQUFHLENBQUMsSUFBSSxFQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztnQkFDOUQsR0FBRyxDQUFDLElBQUksQ0FBQyxHQUFHLEVBQUUsR0FBRyxLQUFLLFNBQVMsQ0FBQyxDQUFDLENBQUMsRUFBQyxHQUFHLEVBQUUsSUFBSSxDQUFDLEdBQUcsQ0FBQyxHQUFHLEVBQUMsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO2dCQUMzRCxHQUFHLENBQUMsSUFBSSxDQUFDLEdBQUcsRUFBRSxrQkFBa0IsS0FBSyxTQUFTLENBQUMsQ0FBQyxDQUFDLEVBQUMsa0JBQWtCLEVBQUUsSUFBSSxDQUFDLEdBQUcsQ0FBQyxrQkFBa0IsRUFBQyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUM7YUFDekcsQ0FBQyxFQUFBO1lBRUYsT0FBTyxJQUFJLENBQUMsV0FBVyxDQUFBO1FBQ3pCLENBQUM7UUFFRCxJQUFJLENBQUMsVUFBVSxLQUFmLElBQUksQ0FBQyxVQUFVLEdBQUssSUFBSSxJQUFJLENBQUMsS0FBSyxDQUFDLEVBQUMsU0FBUyxFQUFFLElBQUksQ0FBQyxTQUFTLEVBQUMsQ0FBQyxFQUFBO1FBRS9ELE9BQU8sSUFBSSxDQUFDLFVBQVUsQ0FBQTtJQUN4QixDQUFDO0lBRUQ7Ozs7O09BS0c7SUFDSCxLQUFLLENBQUMsY0FBYyxDQUFDLE9BQU87UUFDMUIsTUFBTSxPQUFPLEdBQUcsTUFBTSxJQUFJLENBQUMsS0FBSyxFQUFFLENBQUE7UUFDbEMsTUFBTSxFQUFDLElBQUksRUFBRSxNQUFNLEVBQUMsR0FBRyxPQUFPLENBQUE7UUFDOUIsTUFBTSxTQUFTLEdBQUcsSUFBSSxHQUFHLENBQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxDQUFBO1FBQ3RDLE1BQU0sTUFBTSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLElBQUksU0FBUyxDQUFDLFFBQVEsS0FBSyxRQUFRLENBQUE7UUFDbkUsTUFBTSxVQUFVLEdBQUcsTUFBTSxDQUFDLENBQUMsQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFBO1FBQ3hELE1BQU0sT0FBTyxHQUFHLElBQUksY0FBYyxDQUFDLE9BQU8sQ0FBQyxPQUFPLENBQUMsQ0FBQTtRQUNuRCxNQUFNLFdBQVcsR0FBRyxJQUFJLENBQUMsbUJBQW1CLENBQUMsT0FBTyxFQUFFLE9BQU8sRUFBRSxFQUFDLElBQUksRUFBRSxNQUFNLEVBQUMsQ0FBQyxDQUFBO1FBRTlFLGtDQUFrQztRQUNsQyxNQUFNLGNBQWMsR0FBRztZQUNyQixNQUFNLEVBQUUsT0FBTyxDQUFDLE1BQU07WUFDdEIsSUFBSSxFQUFFLEdBQUcsU0FBUyxDQUFDLFFBQVEsR0FBRyxTQUFTLENBQUMsTUFBTSxFQUFFO1lBQ2hELE9BQU8sRUFBRSxPQUFPLENBQUMsUUFBUSxFQUFFO1lBQzNCLEtBQUssRUFBRSxJQUFJLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQztTQUMzQixDQUFBO1FBRUQsSUFBSSxJQUFJLENBQUMsVUFBVSxFQUFFLENBQUM7WUFDcEIsY0FBYyxDQUFDLFVBQVUsR0FBRyxJQUFJLENBQUMsVUFBVSxDQUFBO1FBQzdDLENBQUM7YUFBTSxDQUFDO1lBQ04sY0FBYyxDQUFDLFFBQVEsR0FBRyxTQUFTLENBQUMsUUFBUSxDQUFBO1lBQzVDLGNBQWMsQ0FBQyxJQUFJLEdBQUcsU0FBUyxDQUFDLElBQUksSUFBSSxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQTtRQUM3RCxDQUFDO1FBRUQsT0FBTyxNQUFNLElBQUksT0FBTyxDQUFDLENBQUMsT0FBTyxFQUFFLE1BQU0sRUFBRSxFQUFFO1lBQzNDLElBQUksT0FBTyxDQUFDLE1BQU0sRUFBRSxPQUFPLEVBQUUsQ0FBQztnQkFDNUIsTUFBTSxDQUFDLElBQUksaUJBQWlCLEVBQUUsQ0FBQyxDQUFBO2dCQUMvQixPQUFNO1lBQ1IsQ0FBQztZQUVELElBQUksT0FBTyxHQUFHLEtBQUssQ0FBQTtZQUNuQixNQUFNLEtBQUssR0FBRyxHQUFHLEVBQUUsQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLElBQUksaUJBQWlCLEVBQUUsQ0FBQyxDQUFBO1lBQ3hELE1BQU0sbUJBQW1CLEdBQUcsR0FBRyxFQUFFLENBQUMsT0FBTyxDQUFDLE1BQU0sRUFBRSxtQkFBbUIsQ0FBQyxPQUFPLEVBQUUsS0FBSyxDQUFDLENBQUE7WUFFckYsTUFBTSxHQUFHLEdBQUcsVUFBVSxDQUFDLE9BQU8sQ0FBQyxjQUFjLEVBQUUsQ0FBQyxHQUFHLEVBQUUsRUFBRTtnQkFDckQsNkNBQTZDO2dCQUM3QyxJQUFJLGNBQWMsQ0FBQTtnQkFFbEIsSUFBSSxDQUFDO29CQUNILGNBQWMsR0FBRyxJQUFJLENBQUMscUJBQXFCLENBQUMsR0FBRyxFQUFFLElBQUksQ0FBQyxDQUFBO2dCQUN4RCxDQUFDO2dCQUFDLE9BQU8sS0FBSyxFQUFFLENBQUM7b0JBQ2YsSUFBSSxDQUFDLE9BQU8sRUFBRSxDQUFDO3dCQUNiLE9BQU8sR0FBRyxJQUFJLENBQUE7d0JBQ2QsbUJBQW1CLEVBQUUsQ0FBQTt3QkFDckIsTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFBO29CQUNmLENBQUM7b0JBRUQsT0FBTTtnQkFDUixDQUFDO2dCQUVELHVFQUF1RTtnQkFDdkUscUVBQXFFO2dCQUNyRSxtQkFBbUIsRUFBRSxDQUFBO2dCQUNyQixNQUFNLFdBQVcsR0FBRyxHQUFHLEVBQUUsQ0FBQyxjQUFjLENBQUMsT0FBTyxDQUFDLElBQUksaUJBQWlCLEVBQUUsQ0FBQyxDQUFBO2dCQUV6RSxPQUFPLENBQUMsTUFBTSxFQUFFLGdCQUFnQixDQUFDLE9BQU8sRUFBRSxXQUFXLEVBQUUsRUFBQyxJQUFJLEVBQUUsSUFBSSxFQUFDLENBQUMsQ0FBQTtnQkFDcEUsY0FBYyxDQUFDLEVBQUUsQ0FBQyxPQUFPLEVBQUUsR0FBRyxFQUFFLENBQUMsT0FBTyxDQUFDLE1BQU0sRUFBRSxtQkFBbUIsQ0FBQyxPQUFPLEVBQUUsV0FBVyxDQUFDLENBQUMsQ0FBQTtnQkFFM0YsT0FBTyxHQUFHLElBQUksQ0FBQTtnQkFDZCxPQUFPLENBQUMsSUFBSSxlQUFlLENBQUM7b0JBQzFCLEdBQUcsRUFBRSxPQUFPLENBQUMsR0FBRztvQkFDaEIsTUFBTSxFQUFFLE9BQU8sQ0FBQyxNQUFNO29CQUN0QixNQUFNLEVBQUUsR0FBRyxDQUFDLFVBQVU7b0JBQ3RCLFVBQVUsRUFBRSxHQUFHLENBQUMsYUFBYSxJQUFJLEVBQUU7b0JBQ25DLE9BQU8sRUFBRSxJQUFJLENBQUMsZ0JBQWdCLENBQUMsR0FBRyxDQUFDO29CQUNuQyxNQUFNLEVBQUUsY0FBYztvQkFDdEIsVUFBVSxFQUFFLGNBQWM7aUJBQzNCLENBQUMsQ0FBQyxDQUFBO1lBQ0wsQ0FBQyxDQUFDLENBQUE7WUFFRixPQUFPLENBQUMsTUFBTSxFQUFFLGdCQUFnQixDQUFDLE9BQU8sRUFBRSxLQUFLLEVBQUUsRUFBQyxJQUFJLEVBQUUsSUFBSSxFQUFDLENBQUMsQ0FBQTtZQUU5RCxHQUFHLENBQUMsRUFBRSxDQUFDLE9BQU8sRUFBRSxDQUFDLHNCQUFzQixDQUFDLEtBQUssRUFBRSxFQUFFO2dCQUMvQyxtQkFBbUIsRUFBRSxDQUFBO2dCQUVyQixJQUFJLENBQUMsT0FBTyxFQUFFLENBQUM7b0JBQ2IsT0FBTyxHQUFHLElBQUksQ0FBQTtvQkFDZCxNQUFNLENBQUMsS0FBSyxDQUFDLENBQUE7Z0JBQ2YsQ0FBQztZQUNILENBQUMsQ0FBQyxDQUFBO1lBRUYsSUFBSSxXQUFXLENBQUMsTUFBTSxFQUFFLENBQUM7Z0JBQ3ZCLFdBQVcsQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFBO1lBQzlCLENBQUM7aUJBQU0sQ0FBQztnQkFDTixJQUFJLFdBQVcsQ0FBQyxNQUFNO29CQUFFLEdBQUcsQ0FBQyxLQUFLLENBQUMsV0FBVyxDQUFDLE1BQU0sQ0FBQyxDQUFBO2dCQUVyRCxHQUFHLENBQUMsR0FBRyxFQUFFLENBQUE7WUFDWCxDQUFDO1FBQ0gsQ0FBQyxDQUFDLENBQUE7SUFDSixDQUFDO0lBRUQ7Ozs7O09BS0c7SUFDSCxtQkFBbUIsQ0FBQyxPQUFPLEVBQUUsT0FBTyxFQUFFLEVBQUMsSUFBSSxFQUFFLE1BQU0sRUFBQztRQUNsRCxNQUFNLFdBQVcsR0FBRyxPQUFPLENBQUMsZUFBZSxJQUFJLFVBQVUsQ0FBQTtRQUN6RCxNQUFNLElBQUksR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFBO1FBRXpCLElBQUksSUFBSSxDQUFDLElBQUksS0FBSyxNQUFNO1lBQUUsT0FBTyxFQUFDLE1BQU0sRUFBRSxJQUFJLEVBQUUsTUFBTSxFQUFFLElBQUksRUFBQyxDQUFBO1FBRTdELDRCQUE0QjtRQUM1QixJQUFJLE1BQU0sR0FBRyxJQUFJLENBQUE7UUFDakIsb0RBQW9EO1FBQ3BELElBQUksVUFBVSxHQUFHLElBQUksQ0FBQTtRQUVyQixJQUFJLElBQUksQ0FBQyxJQUFJLEtBQUssUUFBUSxFQUFFLENBQUM7WUFDM0IsTUFBTSxLQUFLLEdBQUcsa0JBQWtCLENBQUMsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUE7WUFFN0MsVUFBVSxHQUFHLE9BQU8sS0FBSyxDQUFDLElBQUksS0FBSyxVQUFVLENBQUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLFFBQVEsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUE7UUFDckYsQ0FBQzthQUFNLElBQUksSUFBSSxDQUFDLElBQUksS0FBSyxPQUFPLEVBQUUsQ0FBQztZQUNqQyxNQUFNLEdBQUcsTUFBTSxDQUFDLElBQUksQ0FBQyx5QkFBeUIsQ0FBQyxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFBO1FBQzlELENBQUM7YUFBTSxDQUFDO1lBQ04sTUFBTSxHQUFHLE1BQU0sQ0FBQyxJQUFJLENBQUMscUJBQXFCLENBQUMsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQTtRQUMxRCxDQUFDO1FBRUQsSUFBSSxXQUFXLEtBQUssVUFBVSxFQUFFLENBQUM7WUFDL0IsSUFBSSxNQUFNO2dCQUFFLE9BQU8sQ0FBQyxHQUFHLENBQUMsZ0JBQWdCLEVBQUUsTUFBTSxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFBO1lBRWhFLE9BQU8sRUFBQyxNQUFNLEVBQUUsTUFBTSxFQUFFLFVBQVUsRUFBQyxDQUFBO1FBQ3JDLENBQUM7UUFFRCxJQUFJLE9BQU8sQ0FBQyxHQUFHLENBQUMsa0JBQWtCLENBQUMsRUFBRSxDQUFDO1lBQ3BDLE1BQU0sSUFBSSw4QkFBOEIsQ0FBQztnQkFDdkMsT0FBTyxFQUFFLGlCQUFpQjtnQkFDMUIsU0FBUyxFQUFFLE1BQU07Z0JBQ2pCLE1BQU0sRUFBRSx5RUFBeUU7YUFDbEYsQ0FBQyxDQUFBO1FBQ0osQ0FBQztRQUVELE9BQU8sQ0FBQyxHQUFHLENBQUMsa0JBQWtCLEVBQUUsV0FBVyxDQUFDLENBQUE7UUFFNUMsTUFBTSxVQUFVLEdBQUcsSUFBSSxDQUFDLGtCQUFrQixDQUFDLFdBQVcsRUFBRSxJQUFJLENBQUMsQ0FBQTtRQUM3RCxNQUFNLE1BQU0sR0FBRyxVQUFVLElBQUksTUFBTSxDQUFDLFFBQVEsQ0FBQyxJQUFJLENBQUMscUJBQXFCLENBQUMsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFBO1FBRWpGLE1BQU0sQ0FBQyxFQUFFLENBQUMsT0FBTyxFQUFFLENBQUMsb0JBQW9CLENBQUMsS0FBSyxFQUFFLEVBQUUsQ0FBQyxVQUFVLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUE7UUFDN0UsTUFBTSxDQUFDLElBQUksQ0FBQyxVQUFVLENBQUMsQ0FBQTtRQUV2QixPQUFPLEVBQUMsTUFBTSxFQUFFLElBQUksRUFBRSxNQUFNLEVBQUUsVUFBVSxFQUFDLENBQUE7SUFDM0MsQ0FBQztJQUVEOzs7O09BSUc7SUFDSCxrQkFBa0IsQ0FBQyxRQUFRLEVBQUUsSUFBSTtRQUMvQixJQUFJLFFBQVEsS0FBSyxNQUFNO1lBQUUsT0FBTyxJQUFJLENBQUMsVUFBVSxFQUFFLENBQUE7UUFDakQsSUFBSSxRQUFRLEtBQUssU0FBUztZQUFFLE9BQU8sSUFBSSxDQUFDLGFBQWEsRUFBRSxDQUFBO1FBQ3ZELElBQUksUUFBUSxLQUFLLElBQUk7WUFBRSxPQUFPLElBQUksQ0FBQyxvQkFBb0IsRUFBRSxDQUFBO1FBQ3pELElBQUksUUFBUSxLQUFLLE1BQU0sSUFBSSxPQUFPLElBQUksQ0FBQyxrQkFBa0IsS0FBSyxVQUFVO1lBQUUsT0FBTyxJQUFJLENBQUMsa0JBQWtCLEVBQUUsQ0FBQTtRQUUxRyxNQUFNLElBQUksOEJBQThCLENBQUMsRUFBQyxPQUFPLEVBQUUsb0JBQW9CLFFBQVEsR0FBRyxFQUFFLFNBQVMsRUFBRSxNQUFNLEVBQUMsQ0FBQyxDQUFBO0lBQ3pHLENBQUM7SUFFRDs7OztPQUlHO0lBQ0gscUJBQXFCLENBQUMsUUFBUSxFQUFFLElBQUk7UUFDbEMsTUFBTSxNQUFNLEdBQUcsUUFBUSxDQUFDLE9BQU8sQ0FBQyxrQkFBa0IsQ0FBQyxDQUFBO1FBQ25ELE1BQU0sV0FBVyxHQUFHLEtBQUssQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQTtRQUNyRSxNQUFNLFNBQVMsR0FBRyxDQUFDLFdBQVcsSUFBSSxFQUFFLENBQUM7YUFDbEMsS0FBSyxDQUFDLEdBQUcsQ0FBQzthQUNWLEdBQUcsQ0FBQyxDQUFDLFFBQVEsRUFBRSxFQUFFLENBQUMsUUFBUSxDQUFDLElBQUksRUFBRSxDQUFDLFdBQVcsRUFBRSxDQUFDO2FBQ2hELE1BQU0sQ0FBQyxDQUFDLFFBQVEsRUFBRSxFQUFFLENBQUMsUUFBUSxJQUFJLFFBQVEsS0FBSyxVQUFVLENBQUMsQ0FBQTtRQUU1RCw2Q0FBNkM7UUFDN0MsSUFBSSxPQUFPLEdBQUcsUUFBUSxDQUFBO1FBRXRCLEtBQUssSUFBSSxLQUFLLEdBQUcsU0FBUyxDQUFDLE1BQU0sR0FBRyxDQUFDLEVBQUUsS0FBSyxJQUFJLENBQUMsRUFBRSxLQUFLLElBQUksQ0FBQyxFQUFFLENBQUM7WUFDOUQsT0FBTyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLGdCQUFnQixDQUFDLFNBQVMsQ0FBQyxLQUFLLENBQUMsRUFBRSxJQUFJLENBQUMsQ0FBQyxDQUFBO1FBQ3ZFLENBQUM7UUFFRCxPQUFPLE9BQU8sQ0FBQTtJQUNoQixDQUFDO0lBRUQ7Ozs7T0FJRztJQUNILGdCQUFnQixDQUFDLFFBQVEsRUFBRSxJQUFJO1FBQzdCLElBQUksUUFBUSxLQUFLLE1BQU0sSUFBSSxRQUFRLEtBQUssUUFBUTtZQUFFLE9BQU8sSUFBSSxDQUFDLFlBQVksRUFBRSxDQUFBO1FBQzVFLElBQUksUUFBUSxLQUFLLFNBQVM7WUFBRSxPQUFPLElBQUksQ0FBQyxhQUFhLEVBQUUsQ0FBQTtRQUN2RCxJQUFJLFFBQVEsS0FBSyxJQUFJO1lBQUUsT0FBTyxJQUFJLENBQUMsc0JBQXNCLEVBQUUsQ0FBQTtRQUMzRCxJQUFJLFFBQVEsS0FBSyxNQUFNLElBQUksT0FBTyxJQUFJLENBQUMsb0JBQW9CLEtBQUssVUFBVTtZQUFFLE9BQU8sSUFBSSxDQUFDLG9CQUFvQixFQUFFLENBQUE7UUFFOUcsTUFBTSxJQUFJLDhCQUE4QixDQUFDLEVBQUMsT0FBTyxFQUFFLDhCQUE4QixRQUFRLEdBQUcsRUFBRSxTQUFTLEVBQUUsTUFBTSxFQUFDLENBQUMsQ0FBQTtJQUNuSCxDQUFDO0lBRUQ7OztPQUdHO0lBQ0gsZ0JBQWdCLENBQUMsUUFBUTtRQUN2QixNQUFNLE9BQU8sR0FBRyxJQUFJLGNBQWMsRUFBRSxDQUFBO1FBRXBDLEtBQUssTUFBTSxDQUFDLElBQUksRUFBRSxLQUFLLENBQUMsSUFBSSxNQUFNLENBQUMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDO1lBQzdELElBQUksS0FBSyxLQUFLLFNBQVM7Z0JBQUUsU0FBUTtZQUVqQyxPQUFPLENBQUMsR0FBRyxDQUFDLElBQUksRUFBRSxLQUFLLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQTtRQUNwRSxDQUFDO1FBRUQsT0FBTyxPQUFPLENBQUE7SUFDaEIsQ0FBQztJQUVEOzs7T0FHRztJQUNILEtBQUs7UUFDSCxJQUFJLENBQUMsVUFBVSxFQUFFLE9BQU8sRUFBRSxDQUFBO1FBQzFCLElBQUksQ0FBQyxXQUFXLEVBQUUsT0FBTyxFQUFFLENBQUE7UUFDM0IsSUFBSSxDQUFDLFVBQVUsR0FBRyxJQUFJLENBQUE7UUFDdEIsSUFBSSxDQUFDLFdBQVcsR0FBRyxJQUFJLENBQUE7SUFDekIsQ0FBQztDQUNGIn0=

package/build/transports/proxy-bounce-transport.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Transport that bounces every request through a same-origin proxy endpoint.
+ * Used when the real target is a different origin and CORS would block direct
+ * browser `fetch` calls. The proxy backend makes the outbound request
+ * server-side where CORS does not apply.
+ */
+export default class ProxyBounceTransport {
+    /** @returns {string} - Transport name. */
+    static get transportName(): string;
+    /**
+     * @param {object} config - Transport configuration.
+     * @param {string} config.proxyUrl - Absolute URL of the proxy endpoint.
+     */
+    constructor({ proxyUrl }: {
+        proxyUrl: string;
+    });
+    proxyUrl: string;
+    /** @returns {import("../capabilities.js").TransportCapabilities} - Supported capabilities. */
+    get capabilities(): import("../capabilities.js").TransportCapabilities;
+    /**
+     * @param {import("../snap-req.js").NormalizedRequest} request - Normalized request.
+     * @returns {Promise<SnapReqResponse>} - The response.
+     */
+    performRequest(request: import("../snap-req.js").NormalizedRequest): Promise<SnapReqResponse>;
+}
+import SnapReqResponse from "../response.js";
+//# sourceMappingURL=proxy-bounce-transport.d.ts.map

package/build/transports/proxy-bounce-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-bounce-transport.d.ts","sourceRoot":"","sources":["../../src/transports/proxy-bounce-transport.js"],"names":[],"mappings":"AA4CA;;;;;GAKG;AACH;IASE,0CAA0C;IAC1C,4BADc,MAAM,CAGnB;IAXD;;;OAGG;IACH,0BAFG;QAAuB,QAAQ,EAAvB,MAAM;KAChB,EAGA;IADC,iBAAwB;IAQ1B,8FAA8F;IAC9F,oBADc,OAAO,oBAAoB,EAAE,qBAAqB,CAG/D;IAED;;;OAGG;IACH,wBAHW,OAAO,gBAAgB,EAAE,iBAAiB,GACxC,OAAO,CAAC,eAAe,CAAC,CA2EpC;CACF;4BA9I2B,gBAAgB"}

package/build/transports/proxy-bounce-transport.js

@@ -0,0 +1,127 @@
+// @ts-check
+import { buildCapabilities } from "../capabilities.js";
+import { SnapReqUnsupportedFeatureError } from "../errors.js";
+import SnapReqHeaders from "../headers.js";
+import SnapReqResponse from "../response.js";
+/**
+ * @param {Uint8Array} bytes - Bytes to encode.
+ * @returns {string} - Base64 string.
+ */
+function base64Encode(bytes) {
+    const binary = Array.from(bytes, (b) => String.fromCharCode(b)).join("");
+    return btoa(binary);
+}
+/**
+ * @param {string} base64 - Base64-encoded string.
+ * @returns {Uint8Array} - Decoded bytes.
+ */
+function base64Decode(base64) {
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i += 1) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+/**
+ * @param {Uint8Array} bytes - Buffered response bytes.
+ * @returns {AsyncIterable<Uint8Array>} - One-shot stream over the buffered bytes.
+ */
+function bufferedByteStream(bytes) {
+    return (async function* () {
+        if (bytes.byteLength > 0) {
+            yield bytes;
+        }
+    })();
+}
+/**
+ * Transport that bounces every request through a same-origin proxy endpoint.
+ * Used when the real target is a different origin and CORS would block direct
+ * browser `fetch` calls. The proxy backend makes the outbound request
+ * server-side where CORS does not apply.
+ */
+export default class ProxyBounceTransport {
+    /**
+     * @param {object} config - Transport configuration.
+     * @param {string} config.proxyUrl - Absolute URL of the proxy endpoint.
+     */
+    constructor({ proxyUrl }) {
+        this.proxyUrl = proxyUrl;
+    }
+    /** @returns {string} - Transport name. */
+    static get transportName() {
+        return "proxy-bounce";
+    }
+    /** @returns {import("../capabilities.js").TransportCapabilities} - Supported capabilities. */
+    get capabilities() {
+        return buildCapabilities({ abort: true });
+    }
+    /**
+     * @param {import("../snap-req.js").NormalizedRequest} request - Normalized request.
+     * @returns {Promise<SnapReqResponse>} - The response.
+     */
+    async performRequest(request) {
+        const requestBody = request.body;
+        /** @type {string | null} */
+        let serializedBody = null;
+        /** @type {string | undefined} */
+        let bodyEncoding;
+        if (requestBody.kind === "text") {
+            serializedBody = /** @type {string} */ (requestBody.value);
+        }
+        else if (requestBody.kind === "bytes") {
+            serializedBody = base64Encode(/** @type {Uint8Array} */ (requestBody.value));
+            bodyEncoding = "base64";
+        }
+        else if (requestBody.kind === "stream") {
+            throw new SnapReqUnsupportedFeatureError({ feature: "streamed request bodies", transport: "proxy-bounce" });
+        }
+        /** @type {Record<string, any>} */
+        const proxyPayload = {
+            body: serializedBody,
+            headers: request.headers.toObject(),
+            method: request.method,
+            url: request.url
+        };
+        if (bodyEncoding) {
+            proxyPayload.bodyEncoding = bodyEncoding;
+        }
+        /** @type {Response} */
+        let proxyResponse;
+        try {
+            proxyResponse = await fetch(this.proxyUrl, {
+                body: JSON.stringify(proxyPayload),
+                headers: { "Content-Type": "application/json" },
+                method: "POST",
+                signal: request.signal || undefined
+            });
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === "AbortError") {
+                throw error;
+            }
+            throw error;
+        }
+        const payload = await proxyResponse.json();
+        const responseHeaders = new SnapReqHeaders();
+        if (payload.headers) {
+            for (const [name, value] of Object.entries(payload.headers)) {
+                responseHeaders.set(name, String(value));
+            }
+        }
+        /** @type {Uint8Array} */
+        let bodyBytes = new Uint8Array(0);
+        if (payload.body) {
+            bodyBytes = base64Decode(payload.body);
+        }
+        return new SnapReqResponse({
+            headers: responseHeaders,
+            method: request.method,
+            status: payload.status,
+            statusText: payload.statusText || "",
+            stream: bufferedByteStream(bodyBytes),
+            url: request.url
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJveHktYm91bmNlLXRyYW5zcG9ydC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90cmFuc3BvcnRzL3Byb3h5LWJvdW5jZS10cmFuc3BvcnQuanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaLE9BQU8sRUFBQyxpQkFBaUIsRUFBQyxNQUFNLG9CQUFvQixDQUFBO0FBQ3BELE9BQU8sRUFBQyw4QkFBOEIsRUFBQyxNQUFNLGNBQWMsQ0FBQTtBQUMzRCxPQUFPLGNBQWMsTUFBTSxlQUFlLENBQUE7QUFDMUMsT0FBTyxlQUFlLE1BQU0sZ0JBQWdCLENBQUE7QUFFNUM7OztHQUdHO0FBQ0gsU0FBUyxZQUFZLENBQUMsS0FBSztJQUN6QixNQUFNLE1BQU0sR0FBRyxLQUFLLENBQUMsSUFBSSxDQUFDLEtBQUssRUFBRSxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsTUFBTSxDQUFDLFlBQVksQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUMsQ0FBQTtJQUV4RSxPQUFPLElBQUksQ0FBQyxNQUFNLENBQUMsQ0FBQTtBQUNyQixDQUFDO0FBRUQ7OztHQUdHO0FBQ0gsU0FBUyxZQUFZLENBQUMsTUFBTTtJQUMxQixNQUFNLE1BQU0sR0FBRyxJQUFJLENBQUMsTUFBTSxDQUFDLENBQUE7SUFDM0IsTUFBTSxLQUFLLEdBQUcsSUFBSSxVQUFVLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxDQUFBO0lBRTNDLEtBQUssSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsR0FBRyxNQUFNLENBQUMsTUFBTSxFQUFFLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQztRQUMxQyxLQUFLLENBQUMsQ0FBQyxDQUFDLEdBQUcsTUFBTSxDQUFDLFVBQVUsQ0FBQyxDQUFDLENBQUMsQ0FBQTtJQUNqQyxDQUFDO0lBRUQsT0FBTyxLQUFLLENBQUE7QUFDZCxDQUFDO0FBRUQ7OztHQUdHO0FBQ0gsU0FBUyxr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

package/{types → build}/transports/select.d.ts

@@ -7,6 +7,12 @@
  * @property {(request: import("../snap-req.js").NormalizedRequest) => Promise<import("../response.js").default>} performRequest - Perform a request.
  * @property {() => void} [close] - Optional resource cleanup.
  */
+/**
+ * @typedef {new (config: object) => Transport} NodeTransportConstructor
+ */
+/**
+ * @typedef {{default: NodeTransportConstructor}} NodeTransportModule
+ */
 /**
  * Detects the JavaScript runtime so `auto` can pick the right transport.
  * @returns {"node" | "react-native" | "browser" | "unknown"} - Detected runtime.
@@ -36,3 +42,8 @@ export type Transport = {
      */
     close?: () => void;
 };
+export type NodeTransportConstructor = new (config: object) => Transport;
+export type NodeTransportModule = {
+    default: NodeTransportConstructor;
+};
+//# sourceMappingURL=select.d.ts.map

package/build/transports/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/transports/select.js"],"names":[],"mappings":"AAQA;;GAEG;AAEH;;;;;GAKG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;;GAGG;AACH,iCAFa,MAAM,GAAG,cAAc,GAAG,SAAS,GAAG,SAAS,CAU3D;AAeD;;;;;;;GAOG;AACH,4CAJW,aAAa,GAAG,SAAS,GAAG,SAAS,cACrC,MAAM,GACJ,OAAO,CAAC,SAAS,CAAC,CAyB9B;4BA5EY,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK;;;;;kBAKhC,OAAO,oBAAoB,EAAE,qBAAqB;;;;oBAClD,CAAC,OAAO,EAAE,OAAO,gBAAgB,EAAE,iBAAiB,KAAK,OAAO,CAAC,OAAO,gBAAgB,EAAE,OAAO,CAAC;;;;YAClG,MAAM,IAAI;;uCAIX,KAAK,MAAM,EAAE,MAAM,KAAK,SAAS;kCAIjC;IAAC,OAAO,EAAE,wBAAwB,CAAA;CAAC"}

package/build/transports/select.js

@@ -0,0 +1,77 @@
+// @ts-check
+import { SnapReqError } from "../errors.js";
+import FetchTransport from "./fetch-transport.js";
+import XhrTransport from "./xhr-transport.js";
+const NODE_TRANSPORT_MODULE_PATH = "snapreq/transports/node-transport";
+/**
+ * @typedef {"auto" | "node" | "fetch" | "xhr"} TransportName
+ */
+/**
+ * @typedef {object} Transport
+ * @property {import("../capabilities.js").TransportCapabilities} capabilities - Supported capabilities.
+ * @property {(request: import("../snap-req.js").NormalizedRequest) => Promise<import("../response.js").default>} performRequest - Perform a request.
+ * @property {() => void} [close] - Optional resource cleanup.
+ */
+/**
+ * @typedef {new (config: object) => Transport} NodeTransportConstructor
+ */
+/**
+ * @typedef {{default: NodeTransportConstructor}} NodeTransportModule
+ */
+/**
+ * Detects the JavaScript runtime so `auto` can pick the right transport.
+ * @returns {"node" | "react-native" | "browser" | "unknown"} - Detected runtime.
+ */
+export function detectRuntime() {
+    const navigatorRef = /** @type {any} */ (globalThis).navigator;
+    if (navigatorRef && navigatorRef.product === "ReactNative")
+        return "react-native";
+    if (typeof process !== "undefined" && Boolean(process.versions?.node))
+        return "node";
+    if (typeof window !== "undefined" && typeof document !== "undefined")
+        return "browser";
+    return "unknown";
+}
+/**
+ * @param {object} config - Node transport configuration.
+ * @returns {Promise<Transport>} - A Node transport instance.
+ */
+async function createNodeTransport(config) {
+    const dynamicImport = /** @type {(specifier: string) => Promise<NodeTransportModule>} */ (new Function("specifier", "return import(specifier)"));
+    const { default: NodeTransport } = await dynamicImport(NODE_TRANSPORT_MODULE_PATH);
+    return new NodeTransport(config);
+}
+/**
+ * Resolves a transport for the requested preference. Returns the preference
+ * untouched when it is already a transport instance. The Node transport is
+ * imported dynamically so web/Expo bundlers never pull in `node:*` modules.
+ * @param {TransportName | Transport | undefined} preference - Requested transport.
+ * @param {object} nodeConfig - Configuration forwarded to the Node transport.
+ * @returns {Promise<Transport>} - The resolved transport.
+ */
+export async function selectTransport(preference, nodeConfig) {
+    if (preference && typeof preference === "object" && typeof ( /** @type {any} */(preference).performRequest) === "function") {
+        return /** @type {Transport} */ (preference);
+    }
+    const choice = /** @type {TransportName} */ (preference || "auto");
+    if (choice === "node")
+        return await createNodeTransport(nodeConfig);
+    if (choice === "fetch")
+        return new FetchTransport();
+    if (choice === "xhr")
+        return new XhrTransport();
+    if (choice !== "auto") {
+        throw new SnapReqError(`Unknown transport "${choice}". Use "auto", "node", "fetch", "xhr" or a transport instance.`);
+    }
+    const runtime = detectRuntime();
+    if (runtime === "node")
+        return await createNodeTransport(nodeConfig);
+    if (FetchTransport.isAvailable())
+        return new FetchTransport();
+    if (XhrTransport.isAvailable())
+        return new XhrTransport();
+    if (typeof process !== "undefined" && Boolean(process.versions?.node))
+        return await createNodeTransport(nodeConfig);
+    throw new SnapReqError("No suitable transport found: this platform has no fetch, XMLHttpRequest or Node http support.");
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VsZWN0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3RyYW5zcG9ydHMvc2VsZWN0LmpzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLFlBQVk7QUFFWixPQUFPLEVBQUMsWUFBWSxFQUFDLE1BQU0sY0FBYyxDQUFBO0FBQ3pDLE9BQU8sY0FBYyxNQUFNLHNCQUFzQixDQUFBO0FBQ2pELE9BQU8sWUFBWSxNQUFNLG9CQUFvQixDQUFBO0FBRTdDLE1BQU0sMEJBQTBCLEdBQUcsbUNBQW1DLENBQUE7QUFFdEU7O0dBRUc7QUFFSDs7Ozs7R0FLRztBQUVIOztHQUVHO0FBRUg7O0dBRUc7QUFFSDs7O0dBR0c7QUFDSCxNQUFNLFVBQVUsYUFBYTtJQUMzQixNQUFNLFlBQVksR0FBRyxrQkFBa0IsQ0FBQyxDQUFDLFVBQVUsQ0FBQyxDQUFDLFNBQVMsQ0FBQTtJQUU5RCxJQUFJLFlBQVksSUFBSSxZQUFZLENBQUMsT0FBTyxLQUFLLGFBQWE7UUFBRSxPQUFPLGNBQWMsQ0FBQTtJQUNqRixJQUFJLE9BQU8sT0FBTyxLQUFLLFdBQVcsSUFBSSxPQUFPLENBQUMsT0FBTyxDQUFDLFFBQVEsRUFBRSxJQUFJLENBQUM7UUFBRSxPQUFPLE1BQU0sQ0FBQTtJQUNwRixJQUFJLE9BQU8sTUFBTSxLQUFLLFdBQVcsSUFBSSxPQUFPLFFBQVEsS0FBSyxXQUFXO1FBQUUsT0FBTyxTQUFTLENBQUE7SUFFdEYsT0FBTyxTQUFTLENBQUE7QUFDbEIsQ0FBQztBQUVEOzs7R0FHRztBQUNILEtBQUssVUFBVSxtQkFBbUIsQ0FBQyxNQUFNO0lBQ3ZDLE1BQU0sYUFBYSxHQUFHLGtFQUFrRSxDQUFDLENBQ3ZGLElBQUksUUFBUSxDQUFDLFdBQVcsRUFBRSwwQkFBMEIsQ0FBQyxDQUN0RCxDQUFBO0lBQ0QsTUFBTSxFQUFDLE9BQU8sRUFBRSxhQUFhLEVBQUMsR0FBRyxNQUFNLGFBQWEsQ0FBQywwQkFBMEIsQ0FBQyxDQUFBO0lBRWhGLE9BQU8sSUFBSSxhQUFhLENBQUMsTUFBTSxDQUFDLENBQUE7QUFDbEMsQ0FBQztBQUVEOzs7Ozs7O0dBT0c7QUFDSCxNQUFNLENBQUMsS0FBSyxVQUFVLGVBQWUsQ0FBQyxVQUFVLEVBQUUsVUFBVTtJQUMxRCxJQUFJLFVBQVUsSUFBSSxPQUFPLFVBQVUsS0FBSyxRQUFRLElBQUksT0FBTyxFQUFDLGtCQUFtQixDQUFDLFVBQVUsQ0FBQyxDQUFDLGNBQWMsQ0FBQyxLQUFLLFVBQVUsRUFBRSxDQUFDO1FBQzNILE9BQU8sd0JBQXdCLENBQUMsQ0FBQyxVQUFVLENBQUMsQ0FBQTtJQUM5QyxDQUFDO0lBRUQsTUFBTSxNQUFNLEdBQUcsNEJBQTRCLENBQUMsQ0FBQyxVQUFVLElBQUksTUFBTSxDQUFDLENBQUE7SUFFbEUsSUFBSSxNQUFNLEtBQUssTUFBTTtRQUFFLE9BQU8sTUFBTSxtQkFBbUIsQ0FBQyxVQUFVLENBQUMsQ0FBQTtJQUNuRSxJQUFJLE1BQU0sS0FBSyxPQUFPO1FBQUUsT0FBTyxJQUFJLGNBQWMsRUFBRSxDQUFBO0lBQ25ELElBQUksTUFBTSxLQUFLLEtBQUs7UUFBRSxPQUFPLElBQUksWUFBWSxFQUFFLENBQUE7SUFFL0MsSUFBSSxNQUFNLEtBQUssTUFBTSxFQUFFLENBQUM7UUFDdEIsTUFBTSxJQUFJLFlBQVksQ0FBQyxzQkFBc0IsTUFBTSxnRUFBZ0UsQ0FBQyxDQUFBO0lBQ3RILENBQUM7SUFFRCxNQUFNLE9BQU8sR0FBRyxhQUFhLEVBQUUsQ0FBQTtJQUUvQixJQUFJLE9BQU8sS0FBSyxNQUFNO1FBQUUsT0FBTyxNQUFNLG1CQUFtQixDQUFDLFVBQVUsQ0FBQyxDQUFBO0lBQ3BFLElBQUksY0FBYyxDQUFDLFdBQVcsRUFBRTtRQUFFLE9BQU8sSUFBSSxjQUFjLEVBQUUsQ0FBQTtJQUM3RCxJQUFJLFlBQVksQ0FBQyxXQUFXLEVBQUU7UUFBRSxPQUFPLElBQUksWUFBWSxFQUFFLENBQUE7SUFDekQsSUFBSSxPQUFPLE9BQU8sS0FBSyxXQUFXLElBQUksT0FBTyxDQUFDLE9BQU8sQ0FBQyxRQUFRLEVBQUUsSUFBSSxDQUFDO1FBQUUsT0FBTyxNQUFNLG1CQUFtQixDQUFDLFVBQVUsQ0FBQyxDQUFBO0lBRW5ILE1BQU0sSUFBSSxZQUFZLENBQUMsK0ZBQStGLENBQUMsQ0FBQTtBQUN6SCxDQUFDIn0=

package/{types → build}/transports/xhr-transport.d.ts

@@ -23,3 +23,4 @@ export default class XhrTransport {
 }
 import SnapReqResponse from "../response.js";
 import SnapReqHeaders from "../headers.js";
+//# sourceMappingURL=xhr-transport.d.ts.map

package/build/transports/xhr-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xhr-transport.d.ts","sourceRoot":"","sources":["../../src/transports/xhr-transport.js"],"names":[],"mappings":"AAOA;;;;GAIG;AACH;IACE,0CAA0C;IAC1C,4BADc,MAAM,CAGnB;IAED,sFAAsF;IACtF,sBADc,OAAO,CAGpB;IAED,8FAA8F;IAC9F,oBADc,OAAO,oBAAoB,EAAE,qBAAqB,CAG/D;IAED;;;OAGG;IACH,wBAHW,OAAO,gBAAgB,EAAE,iBAAiB,GACxC,OAAO,CAAC,eAAe,CAAC,CA8DpC;IAED;;;OAGG;IACH,0BAHW,MAAM,GACJ,cAAc,CAc1B;CACF;4BA1G2B,gBAAgB;2BADjB,eAAe"}