nlcurl 0.6.0 → 0.8.0

package/dist/core/validation.d.ts

@@ -1,106 +1,108 @@
 /**
- * Validates a single HTTP header name per RFC 7230 §3.2.6.
- * Must be a non-empty token consisting solely of tchar characters.
+ * Validates that a header name conforms to RFC 7230 token syntax.
+ *
+ * @param {string} name - The header name to validate.
+ * @throws {NLcURLError} If the name contains invalid characters.
  */
 export declare function validateHeaderName(name: string): void;
 /**
- * Validates a single HTTP header value per RFC 7230 §3.2.6.
- * Must not contain CR (\r), LF (\n), or NUL (\0) bytes.
+ * Validates that a header value does not contain forbidden control characters.
+ *
+ * @param {string} name - The header name (used in the error message).
+ * @param {string} value - The header value to validate.
+ * @throws {NLcURLError} If the value contains CR, LF, NUL, or other forbidden characters.
  */
 export declare function validateHeaderValue(name: string, value: string): void;
 /**
- * Asserts that `value` is a non-empty string.
+ * Asserts that the value is a non-empty string.
  *
  * @param {unknown} value - The value to check.
- * @param {string}  label - Parameter name for the error message.
+ * @param {string} label - A human-readable label for error messages.
  * @throws {NLcURLError} If the value is not a non-empty string.
  */
 export declare function assertNonEmptyString(value: unknown, label: string): asserts value is string;
 /**
- * Asserts that `value` is a positive finite number.
+ * Asserts that the value is a positive finite number.
  *
  * @param {unknown} value - The value to check.
- * @param {string}  label - Parameter name for the error message.
+ * @param {string} label - A human-readable label for error messages.
  * @throws {NLcURLError} If the value is not a positive finite number.
  */
 export declare function assertPositiveNumber(value: unknown, label: string): asserts value is number;
 /**
- * Asserts that `value` is a non-negative finite integer.
+ * Asserts that the value is a non-negative integer.
  *
  * @param {unknown} value - The value to check.
- * @param {string}  label - Parameter name for the error message.
+ * @param {string} label - A human-readable label for error messages.
  * @throws {NLcURLError} If the value is not a non-negative integer.
  */
 export declare function assertNonNegativeInt(value: unknown, label: string): asserts value is number;
 /**
- * Asserts that `value` is a member of the allowed set.
+ * Asserts that the value belongs to a predefined set of allowed values.
  *
- * @param {unknown}    value   - The value to check.
- * @param {Set<T>}     allowed - Set of permitted values.
- * @param {string}     label   - Parameter name for the error message.
+ * @template T
+ * @param {unknown} value - The value to check.
+ * @param {Set<T>} allowed - The set of allowed values.
+ * @param {string} label - A human-readable label for error messages.
  * @throws {NLcURLError} If the value is not in the allowed set.
  */
 export declare function assertEnum<T>(value: unknown, allowed: Set<T>, label: string): asserts value is T;
 /**
- * Asserts that `value` is a plain object (not `null`, not an array, not a
- * class instance other than `Object`).
+ * Asserts that the value is a plain object (not null, not an array).
  *
  * @param {unknown} value - The value to check.
- * @param {string}  label - Parameter name for the error message.
+ * @param {string} label - A human-readable label for error messages.
  * @throws {NLcURLError} If the value is not a plain object.
  */
 export declare function assertPlainObject(value: unknown, label: string): asserts value is Record<string, unknown>;
 /**
- * Validates the URL string and its protocol for HTTP requests.
+ * Validates that a URL string is well-formed and uses one of the allowed schemes.
  *
- * @param {string}     url              - The URL string to validate.
- * @param {Set<string>} [allowedSchemes] - Permitted protocol schemes.
- * @throws {NLcURLError} If the URL is invalid or uses an unsupported protocol.
+ * @param {string} url - The URL to validate.
+ * @param {Set<string>} [allowedSchemes] - Permitted URL schemes. Defaults to `http:` and `https:`.
+ * @throws {NLcURLError} If the URL is invalid or uses a disallowed scheme.
  */
 export declare function validateUrl(url: string, allowedSchemes?: Set<string>): void;
 /**
- * Validates per-phase timeout configuration. Each field must be a positive
- * finite number when present.
+ * Validates a timeout value, accepting either a positive number or a TimeoutConfig object.
  *
- * @param {unknown} timeout - A flat timeout number or per-phase object.
- * @throws {NLcURLError} If any timeout value is invalid.
+ * @param {unknown} timeout - The timeout value to validate.
+ * @throws {NLcURLError} If the timeout is not a valid number or TimeoutConfig.
  */
 export declare function validateTimeout(timeout: unknown): void;
 /**
- * Validates all user-supplied fields of an outgoing request descriptor.
- * Called at the entry of every public request function before any processing.
+ * Validates all fields of a request descriptor.
  *
- * @param {Record<string, unknown>} input - The raw request descriptor.
- * @throws {NLcURLError} If any field fails validation.
+ * @param {Record<string, unknown>} input - The request fields to validate.
+ * @throws {NLcURLError} If any field value is invalid.
  */
 export declare function validateRequest(input: Record<string, unknown>): void;
 /**
- * Validates session-level configuration. Called once in the
- * {@link NLcURLSession} constructor.
+ * Validates all fields of a session configuration object.
  *
- * @param {Record<string, unknown>} config - The raw session config.
- * @throws {NLcURLError} If any field fails validation.
+ * @param {Record<string, unknown>} config - The session config fields to validate.
+ * @throws {NLcURLError} If any field value is invalid.
  */
 export declare function validateSessionConfig(config: Record<string, unknown>): void;
 /**
- * Validates the retry configuration object.
+ * Validates retry configuration fields.
  *
- * @param {Record<string, unknown>} config - The raw retry config.
- * @throws {NLcURLError} If any retry setting is invalid.
+ * @param {Record<string, unknown>} config - The retry config fields to validate.
+ * @throws {NLcURLError} If any field value is invalid.
  */
 export declare function validateRetryConfig(config: Record<string, unknown>): void;
 /**
- * Validates rate limit configuration.
+ * Validates rate limit configuration fields.
  *
- * @param {Record<string, unknown>} config - The raw rate limit config.
- * @throws {NLcURLError} If any rate limit parameter is invalid.
+ * @param {Record<string, unknown>} config - The rate limit config fields to validate.
+ * @throws {NLcURLError} If maxRequests or windowMs is invalid.
  */
 export declare function validateRateLimitConfig(config: Record<string, unknown>): void;
 /**
- * Validates a WebSocket URL (must use `ws:` or `wss:` protocol).
+ * Validates that a URL uses the `ws:` or `wss:` scheme for WebSocket connections.
  *
- * @param {string} url - The WebSocket URL to validate.
- * @throws {NLcURLError} If the URL is invalid or uses a non-WebSocket protocol.
+ * @param {string} url - The URL to validate.
+ * @throws {NLcURLError} If the URL is invalid or uses a non-WebSocket scheme.
  */
 export declare function validateWebSocketUrl(url: string): void;
 //# sourceMappingURL=validation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIrD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIrE;AAYD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAI3F;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAI3F;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAI3F;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAKhG;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIzG;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,cAA+B,GAAG,IAAI,CAc5F;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoBtD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAuBpE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CA0B3E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAezE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAM7E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEtD"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIrD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIrE;AAMD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAI3F;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAI3F;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAI3F;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAKhG;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIzG;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,cAA+B,GAAG,IAAI,CAc5F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoBtD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAuBpE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CA0B3E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAezE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAM7E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEtD"}

package/dist/core/validation.js

@@ -1,20 +1,15 @@
-/**
- * @module validation
- * @description Provides reusable runtime validation helpers for all public API
- * entry points. Functions throw {@link NLcURLError} with code `ERR_VALIDATION`
- * when an input fails a check. These guards protect every trust boundary
- * between caller-supplied data and internal library logic.
- */
 import { NLcURLError } from "./errors.js";
 const VALID_METHODS = new Set(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]);
-const VALID_HTTP_VERSIONS = new Set(["1.1", "2"]);
+const VALID_HTTP_VERSIONS = new Set(["1.1", "2", "3"]);
 const VALID_DNS_FAMILIES = new Set([4, 6]);
 const VALID_BACKOFF = new Set(["linear", "exponential"]);
 const HEADER_NAME_RE = /^[!#$%&'*+\-.0-9A-Za-z^_`|~]+$/;
-const HEADER_VALUE_FORBIDDEN_RE = /[\r\n\0]/;
+const HEADER_VALUE_FORBIDDEN_RE = /[\x00-\x08\x0a-\x1f\x7f]/;
 /**
- * Validates a single HTTP header name per RFC 7230 §3.2.6.
- * Must be a non-empty token consisting solely of tchar characters.
+ * Validates that a header name conforms to RFC 7230 token syntax.
+ *
+ * @param {string} name - The header name to validate.
+ * @throws {NLcURLError} If the name contains invalid characters.
  */
 export function validateHeaderName(name) {
     if (!name || !HEADER_NAME_RE.test(name)) {
@@ -22,28 +17,25 @@ export function validateHeaderName(name) {
     }
 }
 /**
- * Validates a single HTTP header value per RFC 7230 §3.2.6.
- * Must not contain CR (\r), LF (\n), or NUL (\0) bytes.
+ * Validates that a header value does not contain forbidden control characters.
+ *
+ * @param {string} name - The header name (used in the error message).
+ * @param {string} value - The header value to validate.
+ * @throws {NLcURLError} If the value contains CR, LF, NUL, or other forbidden characters.
  */
 export function validateHeaderValue(name, value) {
     if (HEADER_VALUE_FORBIDDEN_RE.test(value)) {
-        fail(`HTTP header "${name}" contains forbidden characters (CR/LF/NUL)`);
+        fail(`HTTP header "${name}" contains forbidden control characters`);
     }
 }
-/**
- * Throws an `ERR_VALIDATION` error with the supplied message.
- *
- * @param {string} message - Description of the validation failure.
- * @throws {NLcURLError} Always.
- */
 function fail(message) {
     throw new NLcURLError(message, "ERR_VALIDATION");
 }
 /**
- * Asserts that `value` is a non-empty string.
+ * Asserts that the value is a non-empty string.
  *
  * @param {unknown} value - The value to check.
- * @param {string}  label - Parameter name for the error message.
+ * @param {string} label - A human-readable label for error messages.
  * @throws {NLcURLError} If the value is not a non-empty string.
  */
 export function assertNonEmptyString(value, label) {
@@ -52,10 +44,10 @@ export function assertNonEmptyString(value, label) {
     }
 }
 /**
- * Asserts that `value` is a positive finite number.
+ * Asserts that the value is a positive finite number.
  *
  * @param {unknown} value - The value to check.
- * @param {string}  label - Parameter name for the error message.
+ * @param {string} label - A human-readable label for error messages.
  * @throws {NLcURLError} If the value is not a positive finite number.
  */
 export function assertPositiveNumber(value, label) {
@@ -64,10 +56,10 @@ export function assertPositiveNumber(value, label) {
     }
 }
 /**
- * Asserts that `value` is a non-negative finite integer.
+ * Asserts that the value is a non-negative integer.
  *
  * @param {unknown} value - The value to check.
- * @param {string}  label - Parameter name for the error message.
+ * @param {string} label - A human-readable label for error messages.
  * @throws {NLcURLError} If the value is not a non-negative integer.
  */
 export function assertNonNegativeInt(value, label) {
@@ -76,11 +68,12 @@ export function assertNonNegativeInt(value, label) {
     }
 }
 /**
- * Asserts that `value` is a member of the allowed set.
+ * Asserts that the value belongs to a predefined set of allowed values.
  *
- * @param {unknown}    value   - The value to check.
- * @param {Set<T>}     allowed - Set of permitted values.
- * @param {string}     label   - Parameter name for the error message.
+ * @template T
+ * @param {unknown} value - The value to check.
+ * @param {Set<T>} allowed - The set of allowed values.
+ * @param {string} label - A human-readable label for error messages.
  * @throws {NLcURLError} If the value is not in the allowed set.
  */
 export function assertEnum(value, allowed, label) {
@@ -90,11 +83,10 @@ export function assertEnum(value, allowed, label) {
     }
 }
 /**
- * Asserts that `value` is a plain object (not `null`, not an array, not a
- * class instance other than `Object`).
+ * Asserts that the value is a plain object (not null, not an array).
  *
  * @param {unknown} value - The value to check.
- * @param {string}  label - Parameter name for the error message.
+ * @param {string} label - A human-readable label for error messages.
  * @throws {NLcURLError} If the value is not a plain object.
  */
 export function assertPlainObject(value, label) {
@@ -103,11 +95,11 @@ export function assertPlainObject(value, label) {
     }
 }
 /**
- * Validates the URL string and its protocol for HTTP requests.
+ * Validates that a URL string is well-formed and uses one of the allowed schemes.
  *
- * @param {string}     url              - The URL string to validate.
- * @param {Set<string>} [allowedSchemes] - Permitted protocol schemes.
- * @throws {NLcURLError} If the URL is invalid or uses an unsupported protocol.
+ * @param {string} url - The URL to validate.
+ * @param {Set<string>} [allowedSchemes] - Permitted URL schemes. Defaults to `http:` and `https:`.
+ * @throws {NLcURLError} If the URL is invalid or uses a disallowed scheme.
  */
 export function validateUrl(url, allowedSchemes = new Set(["http:", "https:"])) {
     if (typeof url !== "string" || url.length === 0) {
@@ -126,11 +118,10 @@ export function validateUrl(url, allowedSchemes = new Set(["http:", "https:"]))
     }
 }
 /**
- * Validates per-phase timeout configuration. Each field must be a positive
- * finite number when present.
+ * Validates a timeout value, accepting either a positive number or a TimeoutConfig object.
  *
- * @param {unknown} timeout - A flat timeout number or per-phase object.
- * @throws {NLcURLError} If any timeout value is invalid.
+ * @param {unknown} timeout - The timeout value to validate.
+ * @throws {NLcURLError} If the timeout is not a valid number or TimeoutConfig.
  */
 export function validateTimeout(timeout) {
     if (timeout === undefined || timeout === null)
@@ -155,11 +146,10 @@ export function validateTimeout(timeout) {
     fail("timeout must be a number or a TimeoutConfig object");
 }
 /**
- * Validates all user-supplied fields of an outgoing request descriptor.
- * Called at the entry of every public request function before any processing.
+ * Validates all fields of a request descriptor.
  *
- * @param {Record<string, unknown>} input - The raw request descriptor.
- * @throws {NLcURLError} If any field fails validation.
+ * @param {Record<string, unknown>} input - The request fields to validate.
+ * @throws {NLcURLError} If any field value is invalid.
  */
 export function validateRequest(input) {
     if (input["method"] !== undefined) {
@@ -186,11 +176,10 @@ export function validateRequest(input) {
     }
 }
 /**
- * Validates session-level configuration. Called once in the
- * {@link NLcURLSession} constructor.
+ * Validates all fields of a session configuration object.
  *
- * @param {Record<string, unknown>} config - The raw session config.
- * @throws {NLcURLError} If any field fails validation.
+ * @param {Record<string, unknown>} config - The session config fields to validate.
+ * @throws {NLcURLError} If any field value is invalid.
  */
 export function validateSessionConfig(config) {
     if (config["baseURL"] !== undefined && config["baseURL"] !== null) {
@@ -220,10 +209,10 @@ export function validateSessionConfig(config) {
     }
 }
 /**
- * Validates the retry configuration object.
+ * Validates retry configuration fields.
  *
- * @param {Record<string, unknown>} config - The raw retry config.
- * @throws {NLcURLError} If any retry setting is invalid.
+ * @param {Record<string, unknown>} config - The retry config fields to validate.
+ * @throws {NLcURLError} If any field value is invalid.
  */
 export function validateRetryConfig(config) {
     if (config["count"] !== undefined) {
@@ -242,10 +231,10 @@ export function validateRetryConfig(config) {
     }
 }
 /**
- * Validates rate limit configuration.
+ * Validates rate limit configuration fields.
  *
- * @param {Record<string, unknown>} config - The raw rate limit config.
- * @throws {NLcURLError} If any rate limit parameter is invalid.
+ * @param {Record<string, unknown>} config - The rate limit config fields to validate.
+ * @throws {NLcURLError} If maxRequests or windowMs is invalid.
  */
 export function validateRateLimitConfig(config) {
     assertPositiveNumber(config["maxRequests"], "maxRequests");
@@ -255,10 +244,10 @@ export function validateRateLimitConfig(config) {
     }
 }
 /**
- * Validates a WebSocket URL (must use `ws:` or `wss:` protocol).
+ * Validates that a URL uses the `ws:` or `wss:` scheme for WebSocket connections.
  *
- * @param {string} url - The WebSocket URL to validate.
- * @throws {NLcURLError} If the URL is invalid or uses a non-WebSocket protocol.
+ * @param {string} url - The URL to validate.
+ * @throws {NLcURLError} If the URL is invalid or uses a non-WebSocket scheme.
  */
 export function validateWebSocketUrl(url) {
     validateUrl(url, new Set(["ws:", "wss:"]));

package/dist/core/validation.js.map

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

package/dist/dns/cache.d.ts

@@ -0,0 +1,59 @@
+import type { DNSRecord } from "./types.js";
+/** Stored DNS cache entry with TTL and access tracking. */
+export interface DNSCacheEntry {
+    /** Cached DNS records. */
+    records: DNSRecord[];
+    /** Timestamp when the entry was stored. */
+    storedAt: number;
+    /** Effective time-to-live in seconds. */
+    ttl: number;
+    /** Monotonic counter value of the last access (for LRU eviction). */
+    lastAccessedAt: number;
+}
+/** Configuration options for {@link DNSCache}. */
+export interface DNSCacheConfig {
+    /** Maximum number of entries before LRU eviction. */
+    maxEntries?: number;
+    /** Minimum TTL in seconds applied to any cached record. */
+    minTTL?: number;
+    /** Maximum TTL in seconds applied to any cached record. */
+    maxTTL?: number;
+}
+/** LRU cache for DNS records with configurable TTL bounds. */
+export declare class DNSCache {
+    private readonly entries;
+    private readonly maxEntries;
+    private readonly minTTL;
+    private readonly maxTTL;
+    private accessCounter;
+    /**
+     * Create a new DNS cache.
+     *
+     * @param {DNSCacheConfig} [config] - Cache configuration options.
+     */
+    constructor(config?: DNSCacheConfig);
+    private cacheKey;
+    /**
+     * Retrieve cached records for a name and type.
+     *
+     * @param {string} name - Domain name to look up.
+     * @param {string} type - Record type string.
+     * @returns {DNSRecord[]|undefined} Cached records, or `undefined` if absent or expired.
+     */
+    get(name: string, type: string): DNSRecord[] | undefined;
+    /**
+     * Store DNS records in the cache.
+     *
+     * @param {string} name - Domain name.
+     * @param {string} type - Record type string.
+     * @param {DNSRecord[]} records - DNS records to cache.
+     */
+    set(name: string, type: string, records: DNSRecord[]): void;
+    private computeTTL;
+    private evictLRU;
+    /** Remove all entries from the cache. */
+    clear(): void;
+    /** Number of entries currently in the cache. */
+    get size(): number;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/dns/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/dns/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,cAAc,EAAE,MAAM,CAAC;CACxB;AAMD,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8DAA8D;AAC9D,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,aAAa,CAAK;IAE1B;;;;OAIG;gBACS,MAAM,CAAC,EAAE,cAAc;IAMnC,OAAO,CAAC,QAAQ;IAIhB;;;;;;OAMG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,SAAS;IAexD;;;;;;OAMG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI;IAkB3D,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,QAAQ;IAchB,yCAAyC;IACzC,KAAK,IAAI,IAAI;IAIb,gDAAgD;IAChD,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/dns/cache.js

@@ -0,0 +1,99 @@
+const DEFAULT_MAX_ENTRIES = 500;
+const DEFAULT_MIN_TTL = 30;
+const DEFAULT_MAX_TTL = 86400;
+/** LRU cache for DNS records with configurable TTL bounds. */
+export class DNSCache {
+    entries = new Map();
+    maxEntries;
+    minTTL;
+    maxTTL;
+    accessCounter = 0;
+    /**
+     * Create a new DNS cache.
+     *
+     * @param {DNSCacheConfig} [config] - Cache configuration options.
+     */
+    constructor(config) {
+        this.maxEntries = config?.maxEntries ?? DEFAULT_MAX_ENTRIES;
+        this.minTTL = config?.minTTL ?? DEFAULT_MIN_TTL;
+        this.maxTTL = config?.maxTTL ?? DEFAULT_MAX_TTL;
+    }
+    cacheKey(name, type) {
+        return `${type}:${name.toLowerCase()}`;
+    }
+    /**
+     * Retrieve cached records for a name and type.
+     *
+     * @param {string} name - Domain name to look up.
+     * @param {string} type - Record type string.
+     * @returns {DNSRecord[]|undefined} Cached records, or `undefined` if absent or expired.
+     */
+    get(name, type) {
+        const key = this.cacheKey(name, type);
+        const entry = this.entries.get(key);
+        if (!entry)
+            return undefined;
+        const age = (Date.now() - entry.storedAt) / 1000;
+        if (age >= entry.ttl) {
+            this.entries.delete(key);
+            return undefined;
+        }
+        entry.lastAccessedAt = ++this.accessCounter;
+        return entry.records;
+    }
+    /**
+     * Store DNS records in the cache.
+     *
+     * @param {string} name - Domain name.
+     * @param {string} type - Record type string.
+     * @param {DNSRecord[]} records - DNS records to cache.
+     */
+    set(name, type, records) {
+        if (records.length === 0)
+            return;
+        const ttl = this.computeTTL(records);
+        const key = this.cacheKey(name, type);
+        if (this.entries.size >= this.maxEntries && !this.entries.has(key)) {
+            this.evictLRU();
+        }
+        this.entries.set(key, {
+            records,
+            storedAt: Date.now(),
+            ttl,
+            lastAccessedAt: ++this.accessCounter,
+        });
+    }
+    computeTTL(records) {
+        let minRecordTTL = Infinity;
+        for (const record of records) {
+            if (record.ttl < minRecordTTL) {
+                minRecordTTL = record.ttl;
+            }
+        }
+        if (minRecordTTL === Infinity)
+            minRecordTTL = this.minTTL;
+        return Math.max(this.minTTL, Math.min(this.maxTTL, minRecordTTL));
+    }
+    evictLRU() {
+        let oldestKey;
+        let oldestAccess = Infinity;
+        for (const [key, entry] of this.entries) {
+            if (entry.lastAccessedAt < oldestAccess) {
+                oldestAccess = entry.lastAccessedAt;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey) {
+            this.entries.delete(oldestKey);
+        }
+    }
+    /** Remove all entries from the cache. */
+    clear() {
+        this.entries.clear();
+    }
+    /** Number of entries currently in the cache. */
+    get size() {
+        return this.entries.size;
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/dns/cache.js.map

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

package/dist/dns/codec.d.ts

@@ -0,0 +1,39 @@
+import { type DNSRecord, type SVCBRecord } from "./types.js";
+/**
+ * Build a raw DNS query packet.
+ *
+ * @param {string} name - Domain name to query.
+ * @param {number} type - Numeric record type.
+ * @param {number} [id] - Query identifier (defaults to 0).
+ * @returns {Buffer} Wire-format DNS query buffer.
+ */
+export declare function buildDNSQuery(name: string, type: number, id?: number): Buffer;
+/**
+ * Parse a wire-format DNS response packet into records.
+ *
+ * @param {Buffer} packet - Raw DNS response data.
+ * @returns {DNSRecord[]} Array of parsed DNS records from the answer section.
+ */
+export declare function parseDNSResponse(packet: Buffer): DNSRecord[];
+/**
+ * Parse a 4-byte buffer into a dotted-decimal IPv4 address string.
+ *
+ * @param {Buffer} data - Raw A record data.
+ * @returns {string} IPv4 address string.
+ */
+export declare function parseARecord(data: Buffer): string;
+/**
+ * Parse a 16-byte buffer into a colon-hex IPv6 address string.
+ *
+ * @param {Buffer} data - Raw AAAA record data.
+ * @returns {string} IPv6 address string.
+ */
+export declare function parseAAAARecord(data: Buffer): string;
+/**
+ * Parse raw SVCB/HTTPS record data into a structured record.
+ *
+ * @param {Buffer} data - Raw SVCB record data.
+ * @returns {SVCBRecord} Parsed SVCB record with service parameters.
+ */
+export declare function parseSVCBRecord(data: Buffer): SVCBRecord;
+//# sourceMappingURL=codec.d.ts.map

package/dist/dns/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../src/dns/codec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAElF;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAE,MAAU,GAAG,MAAM,CAgBhF;AAcD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CA4C5D;AA8CD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAuDxD"}