kinetex 1.3.0 → 1.5.0

package/dist/types/client.d.ts

@@ -3,7 +3,7 @@
  * Wires all subsystems: transport, interceptors, lifecycle hooks,
  * retry, auth, cache, cookie jar, HAR, logging, progress, and SSE/GraphQL/Pagination.
  */
-import { type DedupOptions } from "./dedup.ts";
+import { DedupMap, type DedupOptions } from "./dedup.ts";
 import { type CircuitBreakerConfig, type CircuitBreakerState } from "./circuit-breaker.ts";
 import { WSClient, type WSClientConfig } from "./ws.ts";
 import type { KinetexConfig, KinetexRequest, KinetexResponse, SendOptions, HTTPMethod, ProxyConfig, RetryConfig, HARLog, HeadersInit, QueryParams, QueryValue, RequestInterceptor, ResponseInterceptor, ErrorInterceptor } from "./types.ts";
@@ -27,7 +27,27 @@ export interface OTelTracer {
     startSpan(name: string, options?: {
         kind?: number;
     }): OTelSpan;
+    /**
+     * Record a value into a histogram. Optional — omit it and only spans are
+     * produced.
+     *
+     * @param name  - Instrument name.
+     * @param value - Recorded value. For `http.client.request.duration` this is
+     *   in **seconds**, matching OpenTelemetry semantic conventions.
+     * @param attributes - Low-cardinality dimensions (method, status, host).
+     */
+    recordHistogram?(name: string, value: number, attributes?: MetricAttributes): void;
+    /**
+     * Increment a counter. Optional — omit it and only spans are produced.
+     *
+     * @param name  - Instrument name.
+     * @param value - Amount to add (default 1).
+     * @param attributes - Low-cardinality dimensions.
+     */
+    incrementCounter?(name: string, value?: number, attributes?: MetricAttributes): void;
 }
+/** Attribute values accepted by {@link OTelTracer}'s metric methods. */
+export type MetricAttributes = Record<string, string | number | boolean>;
 /**
  * Minimal interface for an OpenTelemetry-compatible span.
  * Kinetex does NOT take a hard dependency on \@opentelemetry/api.
@@ -109,6 +129,14 @@ export declare class Kinetex {
     private _circuitBreakerKeyFn;
     /** Active WebSocket connections tracked for cleanup on destroy(). */
     private readonly _wsClients;
+    /**
+     * Optional bulkhead bounding in-flight requests. `null` when
+     * `concurrencyLimit` is not configured, which keeps the hot path free of a
+     * limiter check.
+     */
+    private readonly _concurrencyLimiter;
+    /** SigV4 signer kept so a clock-skew correction survives across retries. */
+    private _awsSigner;
     /**
      * @param config - Global client configuration.
      */
@@ -238,17 +266,16 @@ export declare class Kinetex {
     /**
      * Returns deduplication metrics.
      *
-     * @returns An object with `hits` (coalesced request count), `misses` (actual network request count),
-     *          and `inFlightCount` (currently in-flight requests), or `null` if dedup is not enabled.
+     * The full `DedupMap.getStats()` snapshot, so a caller has to reach for one
+     * shape rather than two. The wrapper used to expose only `hits`, `misses`
+     * and `inFlightCount` — which meant the hit rate, the only figure anyone
+     * actually wants from a dedup map, was unavailable on the client even
+     * though the map computed it.
+     *
+     * @returns `{ hits, misses, totalRequests, hitRate, inFlightCount, trackedKeys }`,
+     *          or `null` if dedup is not enabled.
      */
-    get dedupMetrics(): {
-        /** Number of requests that shared an in-flight or windowed response. */
-        hits: number;
-        /** Number of requests that triggered a real network call. */
-        misses: number;
-        /** Number of currently in-flight requests. */
-        inFlightCount: number;
-    } | null;
+    get dedupMetrics(): ReturnType<DedupMap["getStats"]> | null;
     /**
      * Enable circuit breaker protection.
      *
@@ -326,6 +353,20 @@ export declare class Kinetex {
      * and retries on failure per the retry config.
      */
     private _executeWithRetry;
+    /**
+     * Emit request metrics to the configured tracer, if it supports them.
+     *
+     * Failures here are swallowed on purpose: telemetry must never be able to
+     * fail a request that otherwise succeeded.
+     *
+     * @param req - The originating request.
+     * @param status - Final HTTP status, or undefined if the request threw.
+     * @param errorCode - `KinetexError` code, or undefined on success.
+     * @param durationMs - Wall-clock duration of the logical request.
+     */
+    private _recordMetrics;
+    /** Retry loop body. See {@link _executeWithRetry} for the concurrency gate. */
+    private _executeWithRetryInner;
     /**
      * Follow redirects manually, one hop at a time.
      *
@@ -466,6 +507,23 @@ export declare class FluentRequest {
     constructor(client: Kinetex, method: HTTPMethod, url: string);
     /** Set or override a single header. */
     header(name: string, value: string): this;
+    /**
+     * Attach an `Idempotency-Key`, generating one when none is given.
+     *
+     * Lets a retried `POST` be recognised as the same logical operation by the
+     * server instead of creating a duplicate. Because the header is set on the
+     * request options — not regenerated per attempt — every retry of this
+     * request carries the same key, which is the entire point.
+     *
+     * @param value - An explicit key, or `undefined` to generate a v4 UUID.
+     * @throws {TypeError} If `value` is not a valid key (see `isValidIdempotencyKey`).
+     *
+     * @example
+     * ```ts
+     * await client.POST("/charges").withJSON(body).idempotencyKey().json();
+     * ```
+     */
+    idempotencyKey(value?: string): this;
     /** Merge a headers map. */
     headers(headers: HeadersInit): this;
     /** Set a single query parameter. */

package/dist/types/client.d.ts.map

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

package/dist/types/cookie-parser.d.ts

@@ -174,23 +174,6 @@ export declare function parseSetCookieHeader(header: string): ParsedCookie | nul
  * formatSetCookieHeader(cookie); // "session=abc123; Path=/; Secure"
  */
 export declare function formatSetCookieHeader(cookie: ParsedCookie): string;
-/**
- * Split a raw Set-Cookie header value (or collapsed multi-value string)
- * into individual cookie strings.
- *
- * This is non-trivial because:
- *  - Expires values contain commas: "Expires=Thu, 01 Jan 2099 00:00:00 GMT"
- *  - Multiple Set-Cookie headers may be collapsed with ", " by some HTTP stacks
- *
- * Strategy: Token-based state machine that properly handles:
- *   - Quoted values with commas inside (e.g., `foo="bar,baz"`)
- *   - Escaped quotes inside quoted values (e.g., `foo="bar\"baz"`)
- *   - Attribute values that may contain commas
- *   - Only commits a cookie when we've seen both name and value
- *
- * @param raw - Raw Set-Cookie header string (possibly containing multiple cookies)
- * @returns Array of individual Set-Cookie strings
- */
 export declare function splitSetCookieHeaders(raw: string): string[];
 /**
  * Extract all Set-Cookie header values from a Headers object or plain record.

package/dist/types/cookie-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cookie-parser.d.ts","sourceRoot":"","sources":["../../src/cookie-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,0FAA0F;AAC1F,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,sCAAsC;IACtC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kCAAkC;IAClC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,kBAAkB;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,oBAAoB;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,+BAA+B;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,4CAA4C;IAC5C,SAAS,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3C,6BAA6B;IAC7B,WAAW,EAAE,OAAO,CAAC;CACtB;AAqGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwE9D;AAszCD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8C/D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYpE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAWxD;AA4FD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAsCpD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK7D;AASD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOjD;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAwB9E;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAuBlD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAc1E;AAmCD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CA0HxE;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAoElE;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAsG3D;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GACnD,MAAM,EAAE,CAkBV"}
+{"version":3,"file":"cookie-parser.d.ts","sourceRoot":"","sources":["../../src/cookie-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,0FAA0F;AAC1F,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,sCAAsC;IACtC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kCAAkC;IAClC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,kBAAkB;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,oBAAoB;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,+BAA+B;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,4CAA4C;IAC5C,SAAS,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3C,6BAA6B;IAC7B,WAAW,EAAE,OAAO,CAAC;CACtB;AAqGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwE9D;AAszCD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8C/D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBpE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAWxD;AAsGD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAuDpD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK7D;AA8CD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOjD;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CA8B9E;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAuBlD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAc1E;AAmCD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAoIxE;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAoElE;AA6CD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAsH3D;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GACnD,MAAM,EAAE,CAkBV"}

package/dist/types/cookie-store.d.ts.map

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

package/dist/types/core.d.ts

@@ -6,7 +6,8 @@
  *  - Deno / Bun / Browser / Edge: native `fetch()` (handles HTTP/2 automatically)
  *  - SOCKS5 proxy: custom TCP tunnel (from socks5.ts)
  */
-import type { KinetexRequest, HTTPVersion, Runtime } from "./types.ts";
+import type { KinetexRequest, HTTPVersion, Runtime, SessionPoolConfig } from "./types.ts";
+import { KinetexError } from "./types.ts";
 /**
  * Detect the current JavaScript runtime.
  *
@@ -15,22 +16,6 @@ import type { KinetexRequest, HTTPVersion, Runtime } from "./types.ts";
 export declare function detectRuntime(): Runtime;
 /** Cached runtime value — detected once at module load. */
 export declare const RUNTIME: Runtime;
-/**
- * Override the cached runtime value.
- *
- * Use this in test environments where the detected runtime may be incorrect
- * (e.g., a Node.js test that should behave as a Cloudflare Worker), or when
- * running inside a VM/isolate with dynamic globalThis behavior.
- *
- * Pass `null` to restore auto-detection.
- *
- * @example
- * ```ts
- * import { setRuntime } from "kinetex";
- * setRuntime("cloudflare-workers"); // test CF behavior
- * setRuntime(null);                 // restore detection
- * ```
- */
 export declare function setRuntime(rt: Runtime | null): void;
 /**
  * Return the effective runtime — the override if set, otherwise the
@@ -88,6 +73,25 @@ export interface FetchTransportOptions {
      * Defaults to `globalThis.fetch`.
      */
     fetchFn?: typeof globalThis.fetch;
+    /**
+     * Permit connections to hosts that resolve into private, loopback or
+     * link-local space. Default: false.
+     *
+     * @see {@link import("./types.ts").KinetexOptions.allowPrivateNetwork}
+     */
+    allowPrivateNetwork?: boolean;
+    /**
+     * Per-request timeout in milliseconds.
+     *
+     * `fetch()` has no timeout of its own, so without this a hung request waits
+     * forever. `NodeHTTP2Transport` set its own `requestTimeoutMs`, but the
+     * HTTP/1.1 fallback it delegates to did not pass anything down — so
+     * `new NodeHTTP2Transport({ requestTimeoutMs: 500 })` against a slow host
+     * waited the full response time while the HTTP/2 path gave up at 500 ms.
+     *
+     * Omit for no timeout (the previous behaviour on this path).
+     */
+    requestTimeoutMs?: number;
     /**
      * When `true`, invalid headers cause a `KinetexError` instead of being
      * silently dropped. Recommended for strict/production environments where
@@ -106,6 +110,19 @@ export interface FetchTransportOptions {
      * @param value - The header value that was dropped.
      */
     onDroppedHeader?: (name: string, value: string) => void;
+    /**
+     * A `fetch` implementation extension passed straight through to the runtime,
+     * most usefully an `undici` dispatcher (`Agent`, `ProxyAgent`, `MockAgent`).
+     *
+     * Typed as `unknown` so this stays dependency-free — kinetex never imports,
+     * constructs, or type-checks against `undici`, it only forwards the value.
+     * Whether the runtime honours it is up to that runtime: Node's `fetch` reads
+     * `init.dispatcher`, Deno and Bun ignore it.
+     *
+     * Supplying a dispatcher forces {@link FetchTransport}, because the Node
+     * HTTP/2 transport talks to `node:http2` directly and has no notion of one.
+     */
+    dispatcher?: unknown;
 }
 /**
  * The accept-encoding value client.ts injects when the caller did not set
@@ -121,10 +138,37 @@ export declare class FetchTransport implements Transport {
     private readonly fetchFn;
     private readonly strict;
     private readonly onDroppedHeader;
+    private readonly dispatcher;
+    /** Per-request timeout; omitted means no timeout. */
+    private readonly requestTimeoutMs;
+    /**
+     * Permit connections to hosts resolving into private/loopback space.
+     * Default: false.
+     */
+    private readonly _allowPrivateNetwork;
     /**
      * @param fetchFnOrOptions - Custom fetch function or options object
      */
     constructor(fetchFnOrOptions?: typeof globalThis.fetch | FetchTransportOptions);
+    /**
+     * Refuse a host that resolves into blocked address space.
+     *
+     * The Node transports close DNS rebinding properly: they resolve once and
+     * pin the checked address to the socket (`createPinnedLookup`). `fetch` has no
+     * resolver hook — undici owns the connection and exposes no way to install
+     * one — so the only place to intervene is before the call.
+     *
+     * That closes the case that matters in practice: a name resolving to loopback
+     * or the cloud metadata address is refused outright, which is the vector
+     * behind the classic SSRF-through-DNS attacks. What it cannot close is a
+     * resolver that answers public on this lookup and private on the connect a
+     * moment later. Closing *that* needs a resolver hook `fetch` does not offer,
+     * and claiming otherwise would be worse than saying so.
+     *
+     * The host has already passed the lexical screen by this point, so this is a
+     * second line of defence rather than the first.
+     */
+    private assertReachableHost;
     /**
      * Send a request via the native fetch() API.
      *
@@ -163,6 +207,27 @@ export declare class NodeHTTP2Transport implements Transport {
     private readonly _requestTimeoutMs;
     /** Cached HTTP/1.1 fallback transport — reuse instead of creating fresh FetchTransport per call */
     private _http1Fallback;
+    /**
+     * Dedicated keep-alive agent for the legacy `node:https` path.
+     *
+     * This path called `https.request(options)` with no `agent`, so behaviour was
+     * whatever the global agent happened to do — and that default is a moving
+     * target. Node 19 turned `keepAlive` on for `https.globalAgent`, so this path
+     * silently changed from a TCP + TLS handshake per request (Node 18 and
+     * earlier) to pooled connections, with no code change here to explain it.
+     *
+     * An explicit agent makes the behaviour identical on every supported Node
+     * version, bounds the idle-socket pool (the global agent keeps 256 free
+     * sockets, which is a lot to hold open for a legacy fallback), and gives
+     * callers a way to opt out.
+     */
+    /** Whether to permit connections into private/loopback address space. */
+    private readonly _allowPrivateNetwork;
+    private readonly _http1KeepAlive;
+    private readonly _http1MaxSockets;
+    private _http1Agent;
+    /** HTTP(S) CONNECT proxy, or undefined for a direct connection. */
+    private readonly _proxy;
     /**
      * @param options - Session pool and transport configuration
      */
@@ -178,6 +243,32 @@ export declare class NodeHTTP2Transport implements Transport {
         connectTimeoutMs?: number;
         /** HTTP/2 per-stream request timeout in ms. Default: 30 000 */
         requestTimeoutMs?: number;
+        /** Reuse TCP sockets on the legacy node:https path. Default: true */
+        http1KeepAlive?: boolean;
+        /** Max idle sockets retained by the legacy keep-alive agent. Default: 16 */
+        http1MaxSockets?: number;
+        /**
+         * Route every connection through this HTTP(S) proxy using `CONNECT`.
+         * Node.js only.
+         */
+        proxy?: import("./types.ts").ProxyConfig;
+        /**
+         * Permit connections to hosts that resolve into private, loopback or
+         * link-local address space. Default: `false`.
+         *
+         * A hostname is screened as written, but the socket is dialled at whatever
+         * that name *resolves to*, and nothing between the two re-checked the
+         * answer. Without this, a name that answered with `127.0.0.1` reached a
+         * loopback service and one that answered with `169.254.169.254` reached a
+         * cloud metadata endpoint — DNS rebinding, needing only control of the
+         * domain being requested.
+         *
+         * Set this to reach a service on `localhost`, a private network, or a
+         * container network — which is most local development, and every test
+         * that stands up a local server. Leave it unset for anything processing
+         * untrusted URLs.
+         */
+        allowPrivateNetwork?: boolean;
     });
     /**
      * Get or create a session for the given origin, properly serialising concurrent
@@ -200,6 +291,16 @@ export declare class NodeHTTP2Transport implements Transport {
      * @returns Raw response from the server
      */
     send(req: KinetexRequest): Promise<RawResponse>;
+    /**
+     * Refuse one header on the HTTP/2 path. Strict mode raises `EVALIDATION`
+     * before anything is dialled; non-strict notifies the callback (if any) and
+     * warns, never dropping silently.
+     *
+     * Both the pseudo-header filter and the validation loop go through here so
+     * the two cannot drift apart, which is what let a caller-supplied `:path`
+     * reach the wire while `FetchTransport` dropped the identical header.
+     */
+    private _rejectHeader;
     /**
      * Send a request over HTTP/2 with iterative redirect following.
      * Each hop reuses or creates a session for the target origin.
@@ -213,6 +314,25 @@ export declare class NodeHTTP2Transport implements Transport {
      * Legacy HTTP/1.1 via node:https for Node.js <18 (no global fetch).
      */
     private _sendHTTP1Legacy;
+    /**
+     * Lazily create the keep-alive agent used by the legacy HTTP/1.1 path.
+     *
+     * @param https - The already-imported `node:https` module.
+     * @returns The shared agent, reused across requests.
+     */
+    private _getHttp1Agent;
+    /**
+     * Open a socket to `origin` through the configured proxy.
+     *
+     * The returned socket is fully established — tunneled, and TLS-wrapped when
+     * the origin is `https:` — so it can be handed to a transport that requires
+     * its connection synchronously.
+     *
+     * @param origin - Target origin, e.g. `https://api.example.com:443`.
+     * @param req - Originating request, attached to any thrown error.
+     * @returns A socket connected to the target through the proxy.
+     */
+    private _createProxiedSocket;
     /** @internal Evict one session and its associated ping timer. */
     private _evictSession;
     /** Close all cached HTTP/2 sessions and their ping timers. */
@@ -227,12 +347,14 @@ export declare class NodeHTTP2Transport implements Transport {
  * @param sessionOptions - HTTP/2 session pool options.
  * @param transportOptions - Header validation options (strict mode, dropped-header callback).
  */
-export declare function createTransport(fetchFn?: typeof globalThis.fetch, preferHTTP2?: boolean, sessionOptions?: {
-    sessionTTLMs?: number;
-    pingIntervalMs?: number;
-    connectTimeoutMs?: number;
-    requestTimeoutMs?: number;
-}, transportOptions?: Pick<FetchTransportOptions, "strict" | "onDroppedHeader">): Transport;
+export declare function createTransport(fetchFn?: typeof globalThis.fetch, preferHTTP2?: boolean, sessionOptions?: SessionPoolConfig, transportOptions?: Pick<FetchTransportOptions, "strict" | "onDroppedHeader" | "dispatcher"> & {
+    /** CA certificate(s) trusted in addition to the system store. */
+    ca?: string | string[];
+    /** HTTP(S) CONNECT proxy (Node.js only). */
+    proxy?: import("./types.ts").ProxyConfig;
+    /** Permit connections to hosts resolving into private/loopback space. Default: false. */
+    allowPrivateNetwork?: boolean;
+}): Transport;
 /**
  * Wrap a transport with a per-request timeout.
  * Works by racing the transport promise against a timeout promise.
@@ -273,6 +395,52 @@ export declare function readRawBody(stream: ReadableStream<Uint8Array> | null, m
  * @returns Parsed body value (T, string, or Uint8Array)
  */
 export declare function parseBody<T>(raw: Uint8Array, contentType: string | null, customParser?: (raw: Uint8Array, headers: Record<string, string>, url: string) => T | Promise<T>, onParseFailure?: (raw: Uint8Array, error: Error) => void, headers?: Record<string, string>, url?: string): T | Promise<T>;
+/**
+ * A `lookup` for node:http and node:http2 that closes the DNS-rebinding gap.
+ *
+ * `isSafeURL` reads the hostname the caller wrote. The socket, however, is
+ * dialled at whatever that hostname *resolves to*, and nothing between the two
+ * points re-checked the answer — so a name that resolves to a public address on
+ * the first lookup and to `127.0.0.1` on the second reached a private service.
+ * That is DNS rebinding, and it needs an attacker-controlled resolver, which is
+ * an ordinary capability for whoever controls the domain being requested.
+ *
+ * Resolving here and pinning the result closes it for the connection that
+ * follows: every address the resolver returns is checked against the same
+ * blocklist `isSafeURL` applies to a literal, and only a checked address is
+ * handed back for the dial. A name that resolves solely to private space fails
+ * instead of connecting.
+ *
+ * The alternative — checking the hostname again after connecting — is too late:
+ * the request is already on the wire.
+ *
+ * `dns.lookup` (not `resolve`) is used deliberately: it honours `/etc/hosts`,
+ * the resolver search list and `dns.setDefaultResultOrder`, so a host pinned in
+ * the system file resolves the way it would have without this, and the address
+ * handed back is the one the socket would have reached anyway.
+ */
+/**
+ * Drop every resolved address that falls in a blocked range.
+ *
+ * Exported separately from `createPinnedLookup` so the decision can be tested
+ * against addresses a resolver would have to be trusted to produce: a name
+ * that answers with a public address and a private one is the rebinding case,
+ * and it cannot be arranged offline through a real resolver.
+ */
+export declare function filterSafeAddresses<T extends {
+    address: string;
+    family?: number;
+}>(addresses: readonly T[]): T[];
+/**
+ * The refusal a host whose every resolved address is blocked earns.
+ *
+ * Split out from {@link FetchTransport} so the message and code can be
+ * asserted without arranging a resolver that answers with a blocked address.
+ */
+export declare function blockedHostError(url: string, addresses: ReadonlyArray<{
+    address: string;
+}>): KinetexError;
+export declare function createPinnedLookup(): import("node:net").LookupFunction;
 /**
  * Normalize a Headers object to a plain record.
  *
@@ -281,13 +449,36 @@ export declare function parseBody<T>(raw: Uint8Array, contentType: string | null
  * @returns Plain key-value record
  */
 export declare function normalizeHeaders(headers: Headers): Record<string, string>;
+/**
+ * Encode a `FormData` as `multipart/form-data` (RFC 7578).
+ *
+ * The function this lives in was written to stop the raw Node transports from
+ * sending an *empty* body for the types fetch would have serialized, and it
+ * covered `URLSearchParams` and `Blob`. `FormData` was missed, so on the
+ * default transport on Node — `NodeHTTP2Transport`, which bypasses fetch
+ * entirely — a form upload went out as a request with no body at all and no
+ * `Content-Type`, and the server recorded an empty form. The response was an
+ * ordinary 200, so nothing looked wrong.
+ *
+ * The boundary is generated per call and written into the body. The transports
+ * that call this only ever see bytes, so the header is set by the client from
+ * `options.headers`; a body encoded here without a matching header is
+ * unparseable, which is why the boundary is returned alongside the bytes for a
+ * caller that has to announce it. Passing one in makes the output
+ * deterministic, which is what the test suite pins.
+ */
+export declare function encodeMultipart(form: FormData, boundary?: string): Promise<{
+    bytes: Uint8Array;
+    boundary: string;
+}>;
 /**
  * Apply content-encoding decompression to a raw body stream.
  * Dynamically imports response.ts so that environments that don't use
  * decompression don't pay the code cost. The import is cached by the runtime.
  *
- * Supported encodings: gzip, deflate, br (brotli)
- * Unsupported encodings (zstd, etc.) are passed through compressed; caller must handle or error.
+ * Supported encodings: gzip, deflate, br (brotli), zstd.
+ * Unsupported encodings are passed through compressed; the caller must handle
+ * them.
  *
  * @param body    - Raw body stream (or null)
  * @param headers - Response headers (content-encoding is read and stripped on success)

package/dist/types/core.d.ts.map

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

package/dist/types/dedup.d.ts

@@ -41,7 +41,36 @@ export interface DedupOptions {
      * @experimental
      */
     signal?: AbortSignal;
+    /**
+     * Timer functions used for the coalescing window.
+     *
+     * Defaults to the globals. Injecting them lets a test drive the window
+     * without replacing `globalThis.setTimeout` — which, when done at module
+     * scope, also captures every unrelated timer in the process. That is not
+     * hypothetical: undici's HTTP/1 parser calls `setTimeout` and then `.unref()`s
+     * the result, so a stub returning a plain number crashed a run outright as
+     * soon as any socket was open.
+     */
+    timers?: {
+        setTimeout: (fn: () => void, ms: number) => ReturnType<typeof setTimeout>;
+        clearTimeout: (handle: ReturnType<typeof setTimeout>) => void;
+    };
 }
+/**
+ * A stable, opaque digest of everything that makes a request distinct.
+ *
+ * Hashing rather than concatenating keeps credentials out of the key: a dedup
+ * map is a long-lived map of strings, and its keys should not be a place where
+ * an `Authorization` header sits in plain text. Returns `""` when no header
+ * distinguishes the request, so the common unauthenticated case keys on method
+ * and URL alone.
+ */
+export declare function identityFingerprint(headers: Record<string, string> | undefined): Promise<string>;
+/**
+ * Build a dedup key from a method, URL and identity digest.
+ */
+export declare function dedupKeyFrom(method: string, url: string, fingerprint: string): string;
+export declare function defaultDedupKey(method: string, url: string, headers?: Record<string, string>): string;
 /**
  * `DedupMap` manages in-flight promises keyed by a request fingerprint.
  * It is transport-agnostic — pass any async factory function.
@@ -49,6 +78,9 @@ export interface DedupOptions {
 export declare class DedupMap<T = unknown> {
     private readonly inflight;
     private readonly timeouts;
+    /** Window timers, overridable for tests. See {@link DedupOptions.timers}. */
+    private readonly _setTimeout;
+    private readonly _clearTimeout;
     private readonly windowMs;
     private readonly methods;
     private readonly keyFn;
@@ -81,9 +113,12 @@ export declare class DedupMap<T = unknown> {
      * entry and creating a new one. The first caller becomes the "leader" and all
      * subsequent callers within the same tick share the same promise.
      *
-     * Note: The default `keyFn` does NOT include headers in the deduplication key.
-     * Two requests with different auth tokens to the same URL will NOT be deduplicated
-     * unless you provide a custom `keyFn` that includes headers.
+     * Note: the default key includes the request headers, so two requests to the
+     * same URL carrying different `Authorization` or `Cookie` are separate
+     * requests and are never coalesced. A key of method + URL alone was the
+     * default once, and it handed one caller's response to another: 50 callers
+     * aside, even two callers for different tenants shared a single response.
+     * See {@link defaultDedupKey}.
      */
     execute(method: string, url: string, factory: () => Promise<T>, headers?: Record<string, string>, windowMs?: number, signal?: AbortSignal): Promise<T>;
     /** Number of requests that shared an in-flight or windowed response. */