rezo 1.0.46 → 1.0.47

package/dist/adapters/http.cjs

@@ -22,6 +22,7 @@ const { ResponseCache } = require('../cache/response-cache.cjs');
 const { getGlobalAgentPool } = require('../utils/agent-pool.cjs');
 const { StagedTimeoutManager, parseStagedTimeouts } = require('../utils/staged-timeout.cjs');
 const { handleRateLimitWait, shouldWaitOnStatus } = require('../utils/rate-limit-wait.cjs');
+const { getSocketTelemetry, beginRequestContext } = require('../utils/socket-telemetry.cjs');
 const dns = require("node:dns");
 const debugLog = {
   requestStart: (config, url, method) => {
@@ -1029,149 +1030,188 @@ async function request(config, fetchOptions, requestCount, timing, _stats, respo
             }
             resolve(error);
           });
-          const isAlreadyConnected = !socket.connecting && (socket.readyState === "open" || socket.writable === true);
-          if (isAlreadyConnected) {
-            timeoutManager.clearPhase("connect");
-            if (timeoutManager.hasPhase("headers")) {
-              timeoutManager.startPhase("headers");
-            }
-          } else {
-            if (timeoutManager.hasPhase("connect")) {
-              timeoutManager.startPhase("connect");
-            }
-          }
+          const reqContext = beginRequestContext(socket, isSecure);
+          const telemetry = getSocketTelemetry(socket);
           socket.once("error", (err) => {
             timeoutManager.clearAll();
             _stats.statusOnNext = "error";
             const error = buildSmartError(config, fetchOptions, err);
             resolve(error);
           });
-          timing.dnsStart = performance.now();
-          config.timing.domainLookupStart = timing.dnsStart;
-          socket.once("lookup", (err, address, family) => {
-            if (!timing.dnsEnd) {
-              timing.dnsEnd = performance.now();
-              config.timing.domainLookupEnd = timing.dnsEnd;
-              timing.tcpStart = performance.now();
-              config.timing.connectStart = timing.tcpStart;
-            }
-            if (config.hooks?.onDns && config.hooks.onDns.length > 0) {
-              const familyNum = typeof family === "number" ? family : family === "IPv6" ? 6 : 4;
-              for (const hook of config.hooks.onDns) {
-                try {
-                  hook({
-                    hostname: url.hostname,
-                    address: address || "",
-                    family: familyNum,
-                    duration: timing.dnsEnd - timing.dnsStart,
-                    timestamp: Date.now()
-                  }, config);
-                } catch (err) {
-                  if (config.debug) {
-                    console.log("[Rezo Debug] onDns hook error:", err);
-                  }
-                }
-              }
-            }
-          });
-          socket.once("secureConnect", () => {
+          if (reqContext.connectionReused) {
             timeoutManager.clearPhase("connect");
             if (timeoutManager.hasPhase("headers")) {
               timeoutManager.startPhase("headers");
             }
-            if (!timing.tlsEnd && timing.tlsStart) {
-              timing.tlsEnd = performance.now();
-              config.timing.connectEnd = timing.tlsEnd;
+            if (telemetry) {
+              config.timing.domainLookupStart = timing.dnsStart = performance.now();
+              config.timing.domainLookupEnd = timing.dnsEnd = timing.dnsStart;
+              config.timing.connectStart = timing.tcpStart = timing.dnsEnd;
+              config.timing.connectEnd = timing.tcpEnd = timing.tcpStart;
+              if (telemetry.network.remoteAddress) {
+                config.network.remoteAddress = telemetry.network.remoteAddress;
+                config.network.remotePort = telemetry.network.remotePort;
+                config.network.localAddress = telemetry.network.localAddress;
+                config.network.localPort = telemetry.network.localPort;
+                config.network.family = telemetry.network.family;
+              }
+              if (isSecure && telemetry.tls) {
+                config.security.tlsVersion = telemetry.tls.protocol;
+                config.security.cipher = telemetry.tls.cipher;
+                if (telemetry.tls.certificate) {
+                  config.security.certificateInfo = {
+                    subject: { CN: telemetry.tls.certificate.subject },
+                    issuer: { CN: telemetry.tls.certificate.issuer },
+                    validFrom: telemetry.tls.certificate.validFrom,
+                    validTo: telemetry.tls.certificate.validTo,
+                    fingerprint: telemetry.tls.certificate.fingerprint
+                  };
+                }
+              }
+              config.connectionReuse = {
+                reused: true,
+                reuseCount: telemetry.reuse.count,
+                socketAge: Date.now() - telemetry.timings.created,
+                historicalDns: telemetry.timings.dnsDuration || 0,
+                historicalTcp: telemetry.timings.tcpDuration || 0,
+                historicalTls: telemetry.timings.tlsDuration || 0
+              };
             }
-            const tls = {
-              cipher: socket.getCipher(),
-              cert: socket.getPeerCertificate(),
-              tlsVersion: socket.getProtocol()
-            };
-            const { cipher, cert, tlsVersion } = tls;
-            config.security.tlsVersion = tlsVersion;
-            config.security.cipher = cipher?.name;
-            config.security.certificateInfo = {
-              subject: cert.subject,
-              issuer: cert.issuer,
-              validFrom: cert.valid_from,
-              validTo: cert.valid_to,
-              fingerprint: cert.fingerprint
-            };
-            config.security.validationResults = {
-              certificateValid: !cert.fingerprint?.includes("error"),
-              hostnameMatch: cert.subject?.CN === url.hostname,
-              chainValid: socket.authorized === true,
-              authorizationError: socket.authorizationError || null
+          } else {
+            if (timeoutManager.hasPhase("connect")) {
+              timeoutManager.startPhase("connect");
+            }
+            timing.dnsStart = performance.now();
+            config.timing.domainLookupStart = timing.dnsStart;
+            config.connectionReuse = {
+              reused: false,
+              reuseCount: 1
             };
-            if (config.hooks?.onTls && config.hooks.onTls.length > 0) {
-              for (const hook of config.hooks.onTls) {
-                try {
-                  hook({
-                    protocol: tlsVersion,
-                    cipher: cipher?.name || "",
-                    authorized: !socket.authorizationError,
-                    authorizationError: socket.authorizationError,
-                    certificate: cert ? {
-                      subject: cert.subject?.CN || "",
-                      issuer: cert.issuer?.CN || "",
-                      validFrom: cert.valid_from || "",
-                      validTo: cert.valid_to || "",
-                      fingerprint: cert.fingerprint || ""
-                    } : undefined,
-                    duration: timing.tlsEnd - timing.tlsStart,
-                    timestamp: Date.now()
-                  }, config);
-                } catch (err) {
-                  if (config.debug) {
-                    console.log("[Rezo Debug] onTls hook error:", err);
+            const populateFromTelemetry = () => {
+              if (!telemetry)
+                return;
+              if (telemetry.timings.dnsEnd && !timing.dnsEnd) {
+                timing.dnsEnd = performance.now();
+                config.timing.domainLookupEnd = timing.dnsEnd;
+                timing.tcpStart = performance.now();
+                config.timing.connectStart = timing.tcpStart;
+                if (config.hooks?.onDns && config.hooks.onDns.length > 0) {
+                  for (const hook of config.hooks.onDns) {
+                    try {
+                      hook({
+                        hostname: url.hostname,
+                        address: telemetry.timings.address || "",
+                        family: telemetry.timings.family || 4,
+                        duration: telemetry.timings.dnsDuration || 0,
+                        timestamp: Date.now()
+                      }, config);
+                    } catch (err) {
+                      if (config.debug) {
+                        console.log("[Rezo Debug] onDns hook error:", err);
+                      }
+                    }
                   }
                 }
               }
-            }
-          });
-          socket.once("connect", () => {
-            if (!isSecure) {
-              timeoutManager.clearPhase("connect");
-              if (timeoutManager.hasPhase("headers")) {
-                timeoutManager.startPhase("headers");
-              }
-            }
-            if (!timing.tcpEnd) {
-              timing.tcpEnd = performance.now();
-              config.timing.connectEnd = timing.tcpEnd;
-              if (isSecure) {
-                timing.tlsStart = performance.now();
-                config.timing.secureConnectionStart = timing.tlsStart;
+              if (telemetry.timings.connectEnd && !timing.tcpEnd) {
+                timing.tcpEnd = performance.now();
+                config.timing.connectEnd = timing.tcpEnd;
+                if (isSecure) {
+                  timing.tlsStart = performance.now();
+                  config.timing.secureConnectionStart = timing.tlsStart;
+                }
+                if (telemetry.network.remoteAddress) {
+                  config.network.remoteAddress = telemetry.network.remoteAddress;
+                  config.network.remotePort = telemetry.network.remotePort;
+                  config.network.localAddress = telemetry.network.localAddress;
+                  config.network.localPort = telemetry.network.localPort;
+                  config.network.family = telemetry.network.family;
+                }
+                if (config.hooks?.onSocket && config.hooks.onSocket.length > 0) {
+                  for (const hook of config.hooks.onSocket) {
+                    try {
+                      hook({
+                        type: "connect",
+                        localAddress: telemetry.network.localAddress,
+                        localPort: telemetry.network.localPort,
+                        remoteAddress: telemetry.network.remoteAddress,
+                        remotePort: telemetry.network.remotePort,
+                        timestamp: Date.now()
+                      }, socket);
+                    } catch (err) {
+                      if (config.debug) {
+                        console.log("[Rezo Debug] onSocket hook error:", err);
+                      }
+                    }
+                  }
+                }
+                if (!isSecure) {
+                  timeoutManager.clearPhase("connect");
+                  if (timeoutManager.hasPhase("headers")) {
+                    timeoutManager.startPhase("headers");
+                  }
+                }
               }
-            }
-            const { remoteAddress, remotePort, localAddress, localPort, remoteFamily } = socket;
-            if (remoteAddress && !config.network.remoteAddress) {
-              config.network.remoteAddress = remoteAddress;
-              config.network.remotePort = remotePort;
-              config.network.localAddress = localAddress;
-              config.network.localPort = localPort;
-              config.network.family = remoteFamily;
-            }
-            if (config.hooks?.onSocket && config.hooks.onSocket.length > 0) {
-              for (const hook of config.hooks.onSocket) {
-                try {
-                  hook({
-                    type: "connect",
-                    localAddress,
-                    localPort,
-                    remoteAddress,
-                    remotePort,
-                    timestamp: Date.now()
-                  }, socket);
-                } catch (err) {
-                  if (config.debug) {
-                    console.log("[Rezo Debug] onSocket hook error:", err);
+              if (isSecure && telemetry.timings.secureConnectEnd && !timing.tlsEnd) {
+                timing.tlsEnd = performance.now();
+                config.timing.connectEnd = timing.tlsEnd;
+                timeoutManager.clearPhase("connect");
+                if (timeoutManager.hasPhase("headers")) {
+                  timeoutManager.startPhase("headers");
+                }
+                if (telemetry.tls) {
+                  config.security.tlsVersion = telemetry.tls.protocol;
+                  config.security.cipher = telemetry.tls.cipher;
+                  config.security.certificateInfo = telemetry.tls.certificate ? {
+                    subject: { CN: telemetry.tls.certificate.subject },
+                    issuer: { CN: telemetry.tls.certificate.issuer },
+                    validFrom: telemetry.tls.certificate.validFrom,
+                    validTo: telemetry.tls.certificate.validTo,
+                    fingerprint: telemetry.tls.certificate.fingerprint
+                  } : undefined;
+                  config.security.validationResults = {
+                    certificateValid: true,
+                    hostnameMatch: telemetry.tls.certificate?.subject === url.hostname || false,
+                    chainValid: telemetry.tls.authorized === true,
+                    authorizationError: telemetry.tls.authorizationError ? true : false
+                  };
+                  if (config.hooks?.onTls && config.hooks.onTls.length > 0) {
+                    for (const hook of config.hooks.onTls) {
+                      try {
+                        hook({
+                          protocol: telemetry.tls.protocol || "",
+                          cipher: telemetry.tls.cipher || "",
+                          authorized: telemetry.tls.authorized !== false,
+                          authorizationError: telemetry.tls.authorizationError,
+                          certificate: telemetry.tls.certificate ? {
+                            subject: telemetry.tls.certificate.subject || "",
+                            issuer: telemetry.tls.certificate.issuer || "",
+                            validFrom: telemetry.tls.certificate.validFrom || "",
+                            validTo: telemetry.tls.certificate.validTo || "",
+                            fingerprint: telemetry.tls.certificate.fingerprint || ""
+                          } : undefined,
+                          duration: telemetry.timings.tlsDuration || 0,
+                          timestamp: Date.now()
+                        }, config);
+                      } catch (err) {
+                        if (config.debug) {
+                          console.log("[Rezo Debug] onTls hook error:", err);
+                        }
+                      }
+                    }
                   }
                 }
               }
-            }
-          });
+            };
+            const checkTelemetry = setInterval(() => {
+              if (telemetry?.connected || telemetry?.closed) {
+                clearInterval(checkTelemetry);
+                populateFromTelemetry();
+              }
+            }, 1);
+            socket.once("close", () => clearInterval(checkTelemetry));
+            setTimeout(() => clearInterval(checkTelemetry), 30000);
+          }
         });
         req.on("error", (error) => {
           timeoutManager.clearAll();

package/dist/adapters/http.js

@@ -22,6 +22,7 @@ import { ResponseCache } from '../cache/response-cache.js';
 import { getGlobalAgentPool } from '../utils/agent-pool.js';
 import { StagedTimeoutManager, parseStagedTimeouts } from '../utils/staged-timeout.js';
 import { handleRateLimitWait, shouldWaitOnStatus } from '../utils/rate-limit-wait.js';
+import { getSocketTelemetry, beginRequestContext } from '../utils/socket-telemetry.js';
 import dns from "node:dns";
 const debugLog = {
   requestStart: (config, url, method) => {
@@ -1029,149 +1030,188 @@ async function request(config, fetchOptions, requestCount, timing, _stats, respo
             }
             resolve(error);
           });
-          const isAlreadyConnected = !socket.connecting && (socket.readyState === "open" || socket.writable === true);
-          if (isAlreadyConnected) {
-            timeoutManager.clearPhase("connect");
-            if (timeoutManager.hasPhase("headers")) {
-              timeoutManager.startPhase("headers");
-            }
-          } else {
-            if (timeoutManager.hasPhase("connect")) {
-              timeoutManager.startPhase("connect");
-            }
-          }
+          const reqContext = beginRequestContext(socket, isSecure);
+          const telemetry = getSocketTelemetry(socket);
           socket.once("error", (err) => {
             timeoutManager.clearAll();
             _stats.statusOnNext = "error";
             const error = buildSmartError(config, fetchOptions, err);
             resolve(error);
           });
-          timing.dnsStart = performance.now();
-          config.timing.domainLookupStart = timing.dnsStart;
-          socket.once("lookup", (err, address, family) => {
-            if (!timing.dnsEnd) {
-              timing.dnsEnd = performance.now();
-              config.timing.domainLookupEnd = timing.dnsEnd;
-              timing.tcpStart = performance.now();
-              config.timing.connectStart = timing.tcpStart;
-            }
-            if (config.hooks?.onDns && config.hooks.onDns.length > 0) {
-              const familyNum = typeof family === "number" ? family : family === "IPv6" ? 6 : 4;
-              for (const hook of config.hooks.onDns) {
-                try {
-                  hook({
-                    hostname: url.hostname,
-                    address: address || "",
-                    family: familyNum,
-                    duration: timing.dnsEnd - timing.dnsStart,
-                    timestamp: Date.now()
-                  }, config);
-                } catch (err) {
-                  if (config.debug) {
-                    console.log("[Rezo Debug] onDns hook error:", err);
-                  }
-                }
-              }
-            }
-          });
-          socket.once("secureConnect", () => {
+          if (reqContext.connectionReused) {
             timeoutManager.clearPhase("connect");
             if (timeoutManager.hasPhase("headers")) {
               timeoutManager.startPhase("headers");
             }
-            if (!timing.tlsEnd && timing.tlsStart) {
-              timing.tlsEnd = performance.now();
-              config.timing.connectEnd = timing.tlsEnd;
+            if (telemetry) {
+              config.timing.domainLookupStart = timing.dnsStart = performance.now();
+              config.timing.domainLookupEnd = timing.dnsEnd = timing.dnsStart;
+              config.timing.connectStart = timing.tcpStart = timing.dnsEnd;
+              config.timing.connectEnd = timing.tcpEnd = timing.tcpStart;
+              if (telemetry.network.remoteAddress) {
+                config.network.remoteAddress = telemetry.network.remoteAddress;
+                config.network.remotePort = telemetry.network.remotePort;
+                config.network.localAddress = telemetry.network.localAddress;
+                config.network.localPort = telemetry.network.localPort;
+                config.network.family = telemetry.network.family;
+              }
+              if (isSecure && telemetry.tls) {
+                config.security.tlsVersion = telemetry.tls.protocol;
+                config.security.cipher = telemetry.tls.cipher;
+                if (telemetry.tls.certificate) {
+                  config.security.certificateInfo = {
+                    subject: { CN: telemetry.tls.certificate.subject },
+                    issuer: { CN: telemetry.tls.certificate.issuer },
+                    validFrom: telemetry.tls.certificate.validFrom,
+                    validTo: telemetry.tls.certificate.validTo,
+                    fingerprint: telemetry.tls.certificate.fingerprint
+                  };
+                }
+              }
+              config.connectionReuse = {
+                reused: true,
+                reuseCount: telemetry.reuse.count,
+                socketAge: Date.now() - telemetry.timings.created,
+                historicalDns: telemetry.timings.dnsDuration || 0,
+                historicalTcp: telemetry.timings.tcpDuration || 0,
+                historicalTls: telemetry.timings.tlsDuration || 0
+              };
             }
-            const tls = {
-              cipher: socket.getCipher(),
-              cert: socket.getPeerCertificate(),
-              tlsVersion: socket.getProtocol()
-            };
-            const { cipher, cert, tlsVersion } = tls;
-            config.security.tlsVersion = tlsVersion;
-            config.security.cipher = cipher?.name;
-            config.security.certificateInfo = {
-              subject: cert.subject,
-              issuer: cert.issuer,
-              validFrom: cert.valid_from,
-              validTo: cert.valid_to,
-              fingerprint: cert.fingerprint
-            };
-            config.security.validationResults = {
-              certificateValid: !cert.fingerprint?.includes("error"),
-              hostnameMatch: cert.subject?.CN === url.hostname,
-              chainValid: socket.authorized === true,
-              authorizationError: socket.authorizationError || null
+          } else {
+            if (timeoutManager.hasPhase("connect")) {
+              timeoutManager.startPhase("connect");
+            }
+            timing.dnsStart = performance.now();
+            config.timing.domainLookupStart = timing.dnsStart;
+            config.connectionReuse = {
+              reused: false,
+              reuseCount: 1
             };
-            if (config.hooks?.onTls && config.hooks.onTls.length > 0) {
-              for (const hook of config.hooks.onTls) {
-                try {
-                  hook({
-                    protocol: tlsVersion,
-                    cipher: cipher?.name || "",
-                    authorized: !socket.authorizationError,
-                    authorizationError: socket.authorizationError,
-                    certificate: cert ? {
-                      subject: cert.subject?.CN || "",
-                      issuer: cert.issuer?.CN || "",
-                      validFrom: cert.valid_from || "",
-                      validTo: cert.valid_to || "",
-                      fingerprint: cert.fingerprint || ""
-                    } : undefined,
-                    duration: timing.tlsEnd - timing.tlsStart,
-                    timestamp: Date.now()
-                  }, config);
-                } catch (err) {
-                  if (config.debug) {
-                    console.log("[Rezo Debug] onTls hook error:", err);
+            const populateFromTelemetry = () => {
+              if (!telemetry)
+                return;
+              if (telemetry.timings.dnsEnd && !timing.dnsEnd) {
+                timing.dnsEnd = performance.now();
+                config.timing.domainLookupEnd = timing.dnsEnd;
+                timing.tcpStart = performance.now();
+                config.timing.connectStart = timing.tcpStart;
+                if (config.hooks?.onDns && config.hooks.onDns.length > 0) {
+                  for (const hook of config.hooks.onDns) {
+                    try {
+                      hook({
+                        hostname: url.hostname,
+                        address: telemetry.timings.address || "",
+                        family: telemetry.timings.family || 4,
+                        duration: telemetry.timings.dnsDuration || 0,
+                        timestamp: Date.now()
+                      }, config);
+                    } catch (err) {
+                      if (config.debug) {
+                        console.log("[Rezo Debug] onDns hook error:", err);
+                      }
+                    }
                   }
                 }
               }
-            }
-          });
-          socket.once("connect", () => {
-            if (!isSecure) {
-              timeoutManager.clearPhase("connect");
-              if (timeoutManager.hasPhase("headers")) {
-                timeoutManager.startPhase("headers");
-              }
-            }
-            if (!timing.tcpEnd) {
-              timing.tcpEnd = performance.now();
-              config.timing.connectEnd = timing.tcpEnd;
-              if (isSecure) {
-                timing.tlsStart = performance.now();
-                config.timing.secureConnectionStart = timing.tlsStart;
+              if (telemetry.timings.connectEnd && !timing.tcpEnd) {
+                timing.tcpEnd = performance.now();
+                config.timing.connectEnd = timing.tcpEnd;
+                if (isSecure) {
+                  timing.tlsStart = performance.now();
+                  config.timing.secureConnectionStart = timing.tlsStart;
+                }
+                if (telemetry.network.remoteAddress) {
+                  config.network.remoteAddress = telemetry.network.remoteAddress;
+                  config.network.remotePort = telemetry.network.remotePort;
+                  config.network.localAddress = telemetry.network.localAddress;
+                  config.network.localPort = telemetry.network.localPort;
+                  config.network.family = telemetry.network.family;
+                }
+                if (config.hooks?.onSocket && config.hooks.onSocket.length > 0) {
+                  for (const hook of config.hooks.onSocket) {
+                    try {
+                      hook({
+                        type: "connect",
+                        localAddress: telemetry.network.localAddress,
+                        localPort: telemetry.network.localPort,
+                        remoteAddress: telemetry.network.remoteAddress,
+                        remotePort: telemetry.network.remotePort,
+                        timestamp: Date.now()
+                      }, socket);
+                    } catch (err) {
+                      if (config.debug) {
+                        console.log("[Rezo Debug] onSocket hook error:", err);
+                      }
+                    }
+                  }
+                }
+                if (!isSecure) {
+                  timeoutManager.clearPhase("connect");
+                  if (timeoutManager.hasPhase("headers")) {
+                    timeoutManager.startPhase("headers");
+                  }
+                }
               }
-            }
-            const { remoteAddress, remotePort, localAddress, localPort, remoteFamily } = socket;
-            if (remoteAddress && !config.network.remoteAddress) {
-              config.network.remoteAddress = remoteAddress;
-              config.network.remotePort = remotePort;
-              config.network.localAddress = localAddress;
-              config.network.localPort = localPort;
-              config.network.family = remoteFamily;
-            }
-            if (config.hooks?.onSocket && config.hooks.onSocket.length > 0) {
-              for (const hook of config.hooks.onSocket) {
-                try {
-                  hook({
-                    type: "connect",
-                    localAddress,
-                    localPort,
-                    remoteAddress,
-                    remotePort,
-                    timestamp: Date.now()
-                  }, socket);
-                } catch (err) {
-                  if (config.debug) {
-                    console.log("[Rezo Debug] onSocket hook error:", err);
+              if (isSecure && telemetry.timings.secureConnectEnd && !timing.tlsEnd) {
+                timing.tlsEnd = performance.now();
+                config.timing.connectEnd = timing.tlsEnd;
+                timeoutManager.clearPhase("connect");
+                if (timeoutManager.hasPhase("headers")) {
+                  timeoutManager.startPhase("headers");
+                }
+                if (telemetry.tls) {
+                  config.security.tlsVersion = telemetry.tls.protocol;
+                  config.security.cipher = telemetry.tls.cipher;
+                  config.security.certificateInfo = telemetry.tls.certificate ? {
+                    subject: { CN: telemetry.tls.certificate.subject },
+                    issuer: { CN: telemetry.tls.certificate.issuer },
+                    validFrom: telemetry.tls.certificate.validFrom,
+                    validTo: telemetry.tls.certificate.validTo,
+                    fingerprint: telemetry.tls.certificate.fingerprint
+                  } : undefined;
+                  config.security.validationResults = {
+                    certificateValid: true,
+                    hostnameMatch: telemetry.tls.certificate?.subject === url.hostname || false,
+                    chainValid: telemetry.tls.authorized === true,
+                    authorizationError: telemetry.tls.authorizationError ? true : false
+                  };
+                  if (config.hooks?.onTls && config.hooks.onTls.length > 0) {
+                    for (const hook of config.hooks.onTls) {
+                      try {
+                        hook({
+                          protocol: telemetry.tls.protocol || "",
+                          cipher: telemetry.tls.cipher || "",
+                          authorized: telemetry.tls.authorized !== false,
+                          authorizationError: telemetry.tls.authorizationError,
+                          certificate: telemetry.tls.certificate ? {
+                            subject: telemetry.tls.certificate.subject || "",
+                            issuer: telemetry.tls.certificate.issuer || "",
+                            validFrom: telemetry.tls.certificate.validFrom || "",
+                            validTo: telemetry.tls.certificate.validTo || "",
+                            fingerprint: telemetry.tls.certificate.fingerprint || ""
+                          } : undefined,
+                          duration: telemetry.timings.tlsDuration || 0,
+                          timestamp: Date.now()
+                        }, config);
+                      } catch (err) {
+                        if (config.debug) {
+                          console.log("[Rezo Debug] onTls hook error:", err);
+                        }
+                      }
+                    }
                   }
                 }
               }
-            }
-          });
+            };
+            const checkTelemetry = setInterval(() => {
+              if (telemetry?.connected || telemetry?.closed) {
+                clearInterval(checkTelemetry);
+                populateFromTelemetry();
+              }
+            }, 1);
+            socket.once("close", () => clearInterval(checkTelemetry));
+            setTimeout(() => clearInterval(checkTelemetry), 30000);
+          }
         });
         req.on("error", (error) => {
           timeoutManager.clearAll();

package/dist/adapters/index.cjs

@@ -1,6 +1,6 @@
-const _mod_hql2dt = require('./picker.cjs');
-exports.detectRuntime = _mod_hql2dt.detectRuntime;
-exports.getAdapterCapabilities = _mod_hql2dt.getAdapterCapabilities;
-exports.buildAdapterContext = _mod_hql2dt.buildAdapterContext;
-exports.getAvailableAdapters = _mod_hql2dt.getAvailableAdapters;
-exports.selectAdapter = _mod_hql2dt.selectAdapter;;
+const _mod_nhcrtu = require('./picker.cjs');
+exports.detectRuntime = _mod_nhcrtu.detectRuntime;
+exports.getAdapterCapabilities = _mod_nhcrtu.getAdapterCapabilities;
+exports.buildAdapterContext = _mod_nhcrtu.buildAdapterContext;
+exports.getAvailableAdapters = _mod_nhcrtu.getAvailableAdapters;
+exports.selectAdapter = _mod_nhcrtu.selectAdapter;;

package/dist/cache/index.cjs

@@ -1,9 +1,9 @@
-const _mod_7sa5is = require('./lru-cache.cjs');
-exports.LRUCache = _mod_7sa5is.LRUCache;;
-const _mod_7a00cs = require('./dns-cache.cjs');
-exports.DNSCache = _mod_7a00cs.DNSCache;
-exports.getGlobalDNSCache = _mod_7a00cs.getGlobalDNSCache;
-exports.resetGlobalDNSCache = _mod_7a00cs.resetGlobalDNSCache;;
-const _mod_6w1tvn = require('./response-cache.cjs');
-exports.ResponseCache = _mod_6w1tvn.ResponseCache;
-exports.normalizeResponseCacheConfig = _mod_6w1tvn.normalizeResponseCacheConfig;;
+const _mod_bw1z42 = require('./lru-cache.cjs');
+exports.LRUCache = _mod_bw1z42.LRUCache;;
+const _mod_pywm2s = require('./dns-cache.cjs');
+exports.DNSCache = _mod_pywm2s.DNSCache;
+exports.getGlobalDNSCache = _mod_pywm2s.getGlobalDNSCache;
+exports.resetGlobalDNSCache = _mod_pywm2s.resetGlobalDNSCache;;
+const _mod_1izn4c = require('./response-cache.cjs');
+exports.ResponseCache = _mod_1izn4c.ResponseCache;
+exports.normalizeResponseCacheConfig = _mod_1izn4c.normalizeResponseCacheConfig;;

package/dist/crawler/index.cjs

@@ -1,40 +1,40 @@
-const _mod_33fvzd = require('./crawler.cjs');
-exports.Crawler = _mod_33fvzd.Crawler;;
-const _mod_1ldv58 = require('./crawler-options.cjs');
-exports.CrawlerOptions = _mod_1ldv58.CrawlerOptions;;
-const _mod_imehct = require('./plugin/robots-txt.cjs');
-exports.RobotsTxt = _mod_imehct.RobotsTxt;;
-const _mod_u0gyun = require('./plugin/file-cacher.cjs');
-exports.FileCacher = _mod_u0gyun.FileCacher;;
-const _mod_9wk5ke = require('./plugin/url-store.cjs');
-exports.UrlStore = _mod_9wk5ke.UrlStore;;
-const _mod_yqhjwv = require('./plugin/navigation-history.cjs');
-exports.NavigationHistory = _mod_yqhjwv.NavigationHistory;;
-const _mod_klxadq = require('./addon/oxylabs/index.cjs');
-exports.Oxylabs = _mod_klxadq.Oxylabs;;
-const _mod_n6jnu4 = require('./addon/oxylabs/options.cjs');
-exports.OXYLABS_BROWSER_TYPES = _mod_n6jnu4.OXYLABS_BROWSER_TYPES;
-exports.OXYLABS_COMMON_LOCALES = _mod_n6jnu4.OXYLABS_COMMON_LOCALES;
-exports.OXYLABS_COMMON_GEO_LOCATIONS = _mod_n6jnu4.OXYLABS_COMMON_GEO_LOCATIONS;
-exports.OXYLABS_US_STATES = _mod_n6jnu4.OXYLABS_US_STATES;
-exports.OXYLABS_EUROPEAN_COUNTRIES = _mod_n6jnu4.OXYLABS_EUROPEAN_COUNTRIES;
-exports.OXYLABS_ASIAN_COUNTRIES = _mod_n6jnu4.OXYLABS_ASIAN_COUNTRIES;
-exports.getRandomOxylabsBrowserType = _mod_n6jnu4.getRandomBrowserType;
-exports.getRandomOxylabsLocale = _mod_n6jnu4.getRandomLocale;
-exports.getRandomOxylabsGeoLocation = _mod_n6jnu4.getRandomGeoLocation;;
-const _mod_sjw00p = require('./addon/decodo/index.cjs');
-exports.Decodo = _mod_sjw00p.Decodo;;
-const _mod_f5prd7 = require('./addon/decodo/options.cjs');
-exports.DECODO_DEVICE_TYPES = _mod_f5prd7.DECODO_DEVICE_TYPES;
-exports.DECODO_HEADLESS_MODES = _mod_f5prd7.DECODO_HEADLESS_MODES;
-exports.DECODO_COMMON_LOCALES = _mod_f5prd7.DECODO_COMMON_LOCALES;
-exports.DECODO_COMMON_COUNTRIES = _mod_f5prd7.DECODO_COMMON_COUNTRIES;
-exports.DECODO_EUROPEAN_COUNTRIES = _mod_f5prd7.DECODO_EUROPEAN_COUNTRIES;
-exports.DECODO_ASIAN_COUNTRIES = _mod_f5prd7.DECODO_ASIAN_COUNTRIES;
-exports.DECODO_US_STATES = _mod_f5prd7.DECODO_US_STATES;
-exports.DECODO_COMMON_CITIES = _mod_f5prd7.DECODO_COMMON_CITIES;
-exports.getRandomDecodoDeviceType = _mod_f5prd7.getRandomDeviceType;
-exports.getRandomDecodoLocale = _mod_f5prd7.getRandomLocale;
-exports.getRandomDecodoCountry = _mod_f5prd7.getRandomCountry;
-exports.getRandomDecodoCity = _mod_f5prd7.getRandomCity;
-exports.generateDecodoSessionId = _mod_f5prd7.generateSessionId;;
+const _mod_9vxiez = require('./crawler.cjs');
+exports.Crawler = _mod_9vxiez.Crawler;;
+const _mod_y54fdi = require('./crawler-options.cjs');
+exports.CrawlerOptions = _mod_y54fdi.CrawlerOptions;;
+const _mod_wq1zsf = require('./plugin/robots-txt.cjs');
+exports.RobotsTxt = _mod_wq1zsf.RobotsTxt;;
+const _mod_m3lb7n = require('./plugin/file-cacher.cjs');
+exports.FileCacher = _mod_m3lb7n.FileCacher;;
+const _mod_lp12wc = require('./plugin/url-store.cjs');
+exports.UrlStore = _mod_lp12wc.UrlStore;;
+const _mod_mauvz5 = require('./plugin/navigation-history.cjs');
+exports.NavigationHistory = _mod_mauvz5.NavigationHistory;;
+const _mod_ajlky5 = require('./addon/oxylabs/index.cjs');
+exports.Oxylabs = _mod_ajlky5.Oxylabs;;
+const _mod_u3qll6 = require('./addon/oxylabs/options.cjs');
+exports.OXYLABS_BROWSER_TYPES = _mod_u3qll6.OXYLABS_BROWSER_TYPES;
+exports.OXYLABS_COMMON_LOCALES = _mod_u3qll6.OXYLABS_COMMON_LOCALES;
+exports.OXYLABS_COMMON_GEO_LOCATIONS = _mod_u3qll6.OXYLABS_COMMON_GEO_LOCATIONS;
+exports.OXYLABS_US_STATES = _mod_u3qll6.OXYLABS_US_STATES;
+exports.OXYLABS_EUROPEAN_COUNTRIES = _mod_u3qll6.OXYLABS_EUROPEAN_COUNTRIES;
+exports.OXYLABS_ASIAN_COUNTRIES = _mod_u3qll6.OXYLABS_ASIAN_COUNTRIES;
+exports.getRandomOxylabsBrowserType = _mod_u3qll6.getRandomBrowserType;
+exports.getRandomOxylabsLocale = _mod_u3qll6.getRandomLocale;
+exports.getRandomOxylabsGeoLocation = _mod_u3qll6.getRandomGeoLocation;;
+const _mod_1qdq35 = require('./addon/decodo/index.cjs');
+exports.Decodo = _mod_1qdq35.Decodo;;
+const _mod_2k0fmv = require('./addon/decodo/options.cjs');
+exports.DECODO_DEVICE_TYPES = _mod_2k0fmv.DECODO_DEVICE_TYPES;
+exports.DECODO_HEADLESS_MODES = _mod_2k0fmv.DECODO_HEADLESS_MODES;
+exports.DECODO_COMMON_LOCALES = _mod_2k0fmv.DECODO_COMMON_LOCALES;
+exports.DECODO_COMMON_COUNTRIES = _mod_2k0fmv.DECODO_COMMON_COUNTRIES;
+exports.DECODO_EUROPEAN_COUNTRIES = _mod_2k0fmv.DECODO_EUROPEAN_COUNTRIES;
+exports.DECODO_ASIAN_COUNTRIES = _mod_2k0fmv.DECODO_ASIAN_COUNTRIES;
+exports.DECODO_US_STATES = _mod_2k0fmv.DECODO_US_STATES;
+exports.DECODO_COMMON_CITIES = _mod_2k0fmv.DECODO_COMMON_CITIES;
+exports.getRandomDecodoDeviceType = _mod_2k0fmv.getRandomDeviceType;
+exports.getRandomDecodoLocale = _mod_2k0fmv.getRandomLocale;
+exports.getRandomDecodoCountry = _mod_2k0fmv.getRandomCountry;
+exports.getRandomDecodoCity = _mod_2k0fmv.getRandomCity;
+exports.generateDecodoSessionId = _mod_2k0fmv.generateSessionId;;

package/dist/entries/crawler.cjs

@@ -1,5 +1,5 @@
-const _mod_jqo3a7 = require('../crawler/crawler.cjs');
-exports.Crawler = _mod_jqo3a7.Crawler;;
-const _mod_5y7u4a = require('../crawler/crawler-options.cjs');
-exports.CrawlerOptions = _mod_5y7u4a.CrawlerOptions;
-exports.Domain = _mod_5y7u4a.Domain;;
+const _mod_6eolh9 = require('../crawler/crawler.cjs');
+exports.Crawler = _mod_6eolh9.Crawler;;
+const _mod_28rvj3 = require('../crawler/crawler-options.cjs');
+exports.CrawlerOptions = _mod_28rvj3.CrawlerOptions;
+exports.Domain = _mod_28rvj3.Domain;;

package/dist/index.cjs

@@ -1,30 +1,30 @@
-const _mod_vh18hs = require('./core/rezo.cjs');
-exports.Rezo = _mod_vh18hs.Rezo;
-exports.createRezoInstance = _mod_vh18hs.createRezoInstance;
-exports.createDefaultInstance = _mod_vh18hs.createDefaultInstance;;
-const _mod_o1tm8z = require('./errors/rezo-error.cjs');
-exports.RezoError = _mod_o1tm8z.RezoError;
-exports.RezoErrorCode = _mod_o1tm8z.RezoErrorCode;;
-const _mod_qs57sl = require('./utils/headers.cjs');
-exports.RezoHeaders = _mod_qs57sl.RezoHeaders;;
-const _mod_bcveiy = require('./utils/form-data.cjs');
-exports.RezoFormData = _mod_bcveiy.RezoFormData;;
-const _mod_j7t4t9 = require('./utils/cookies.cjs');
-exports.RezoCookieJar = _mod_j7t4t9.RezoCookieJar;
-exports.Cookie = _mod_j7t4t9.Cookie;;
-const _mod_cuuq7u = require('./utils/curl.cjs');
-exports.toCurl = _mod_cuuq7u.toCurl;
-exports.fromCurl = _mod_cuuq7u.fromCurl;;
-const _mod_psm01k = require('./core/hooks.cjs');
-exports.createDefaultHooks = _mod_psm01k.createDefaultHooks;
-exports.mergeHooks = _mod_psm01k.mergeHooks;;
-const _mod_x2anu4 = require('./proxy/manager.cjs');
-exports.ProxyManager = _mod_x2anu4.ProxyManager;;
-const _mod_tnhdd0 = require('./queue/index.cjs');
-exports.RezoQueue = _mod_tnhdd0.RezoQueue;
-exports.HttpQueue = _mod_tnhdd0.HttpQueue;
-exports.Priority = _mod_tnhdd0.Priority;
-exports.HttpMethodPriority = _mod_tnhdd0.HttpMethodPriority;;
+const _mod_s1gca7 = require('./core/rezo.cjs');
+exports.Rezo = _mod_s1gca7.Rezo;
+exports.createRezoInstance = _mod_s1gca7.createRezoInstance;
+exports.createDefaultInstance = _mod_s1gca7.createDefaultInstance;;
+const _mod_v6gpph = require('./errors/rezo-error.cjs');
+exports.RezoError = _mod_v6gpph.RezoError;
+exports.RezoErrorCode = _mod_v6gpph.RezoErrorCode;;
+const _mod_u3m56y = require('./utils/headers.cjs');
+exports.RezoHeaders = _mod_u3m56y.RezoHeaders;;
+const _mod_mswq0f = require('./utils/form-data.cjs');
+exports.RezoFormData = _mod_mswq0f.RezoFormData;;
+const _mod_zi4sg0 = require('./utils/cookies.cjs');
+exports.RezoCookieJar = _mod_zi4sg0.RezoCookieJar;
+exports.Cookie = _mod_zi4sg0.Cookie;;
+const _mod_pmct8p = require('./utils/curl.cjs');
+exports.toCurl = _mod_pmct8p.toCurl;
+exports.fromCurl = _mod_pmct8p.fromCurl;;
+const _mod_joston = require('./core/hooks.cjs');
+exports.createDefaultHooks = _mod_joston.createDefaultHooks;
+exports.mergeHooks = _mod_joston.mergeHooks;;
+const _mod_roms61 = require('./proxy/manager.cjs');
+exports.ProxyManager = _mod_roms61.ProxyManager;;
+const _mod_s72k3v = require('./queue/index.cjs');
+exports.RezoQueue = _mod_s72k3v.RezoQueue;
+exports.HttpQueue = _mod_s72k3v.HttpQueue;
+exports.Priority = _mod_s72k3v.Priority;
+exports.HttpMethodPriority = _mod_s72k3v.HttpMethodPriority;;
 const { RezoError } = require('./errors/rezo-error.cjs');
 const isRezoError = exports.isRezoError = RezoError.isRezoError;
 const Cancel = exports.Cancel = RezoError;

package/dist/internal/agents/https-proxy.cjs

@@ -87,8 +87,8 @@ function parseProxyResponse(socket) {
         buffered
       });
     }
-    socket.on("error", onerror);
-    socket.on("end", onend);
+    socket.once("error", onerror);
+    socket.once("end", onend);
     read();
   });
 }

package/dist/internal/agents/https-proxy.js

@@ -87,8 +87,8 @@ function parseProxyResponse(socket) {
         buffered
       });
     }
-    socket.on("error", onerror);
-    socket.on("end", onend);
+    socket.once("error", onerror);
+    socket.once("end", onend);
     read();
   });
 }

package/dist/internal/agents/index.cjs

@@ -1,10 +1,10 @@
-const _mod_150zmc = require('./base.cjs');
-exports.Agent = _mod_150zmc.Agent;;
-const _mod_0kmp78 = require('./http-proxy.cjs');
-exports.HttpProxyAgent = _mod_0kmp78.HttpProxyAgent;;
-const _mod_4tvb7u = require('./https-proxy.cjs');
-exports.HttpsProxyAgent = _mod_4tvb7u.HttpsProxyAgent;;
-const _mod_wgeif4 = require('./socks-proxy.cjs');
-exports.SocksProxyAgent = _mod_wgeif4.SocksProxyAgent;;
-const _mod_3nqvg8 = require('./socks-client.cjs');
-exports.SocksClient = _mod_3nqvg8.SocksClient;;
+const _mod_zivpen = require('./base.cjs');
+exports.Agent = _mod_zivpen.Agent;;
+const _mod_acdvd9 = require('./http-proxy.cjs');
+exports.HttpProxyAgent = _mod_acdvd9.HttpProxyAgent;;
+const _mod_uuge9b = require('./https-proxy.cjs');
+exports.HttpsProxyAgent = _mod_uuge9b.HttpsProxyAgent;;
+const _mod_6egylw = require('./socks-proxy.cjs');
+exports.SocksProxyAgent = _mod_6egylw.SocksProxyAgent;;
+const _mod_6r9bok = require('./socks-client.cjs');
+exports.SocksClient = _mod_6r9bok.SocksClient;;

package/dist/proxy/index.cjs

@@ -1,9 +1,9 @@
 const { Agent, HttpProxyAgent, HttpsProxyAgent, SocksProxyAgent } = require('../internal/agents/index.cjs');
 const { parseProxyString } = require('./parse.cjs');
-const _mod_raejif = require('./manager.cjs');
-exports.ProxyManager = _mod_raejif.ProxyManager;;
-const _mod_4tr5da = require('./parse.cjs');
-exports.parseProxyString = _mod_4tr5da.parseProxyString;;
+const _mod_cch0wk = require('./manager.cjs');
+exports.ProxyManager = _mod_cch0wk.ProxyManager;;
+const _mod_ktsrlf = require('./parse.cjs');
+exports.parseProxyString = _mod_ktsrlf.parseProxyString;;
 function createOptions(uri, opts) {
   if (uri instanceof URL || typeof uri === "string") {
     return {

package/dist/queue/index.cjs

@@ -1,8 +1,8 @@
-const _mod_o7kuxe = require('./queue.cjs');
-exports.RezoQueue = _mod_o7kuxe.RezoQueue;;
-const _mod_6uv6qn = require('./http-queue.cjs');
-exports.HttpQueue = _mod_6uv6qn.HttpQueue;
-exports.extractDomain = _mod_6uv6qn.extractDomain;;
-const _mod_3lc2he = require('./types.cjs');
-exports.Priority = _mod_3lc2he.Priority;
-exports.HttpMethodPriority = _mod_3lc2he.HttpMethodPriority;;
+const _mod_vhb3c6 = require('./queue.cjs');
+exports.RezoQueue = _mod_vhb3c6.RezoQueue;;
+const _mod_g8qvdd = require('./http-queue.cjs');
+exports.HttpQueue = _mod_g8qvdd.HttpQueue;
+exports.extractDomain = _mod_g8qvdd.extractDomain;;
+const _mod_ndfksp = require('./types.cjs');
+exports.Priority = _mod_ndfksp.Priority;
+exports.HttpMethodPriority = _mod_ndfksp.HttpMethodPriority;;

package/dist/responses/universal/index.cjs

@@ -1,11 +1,11 @@
-const _mod_074c53 = require('./event-emitter.cjs');
-exports.UniversalEventEmitter = _mod_074c53.UniversalEventEmitter;;
-const _mod_z5czf2 = require('./stream.cjs');
-exports.UniversalStreamResponse = _mod_z5czf2.UniversalStreamResponse;
-exports.StreamResponse = _mod_z5czf2.StreamResponse;;
-const _mod_n8mvxg = require('./download.cjs');
-exports.UniversalDownloadResponse = _mod_n8mvxg.UniversalDownloadResponse;
-exports.DownloadResponse = _mod_n8mvxg.DownloadResponse;;
-const _mod_n99wlf = require('./upload.cjs');
-exports.UniversalUploadResponse = _mod_n99wlf.UniversalUploadResponse;
-exports.UploadResponse = _mod_n99wlf.UploadResponse;;
+const _mod_i1xls3 = require('./event-emitter.cjs');
+exports.UniversalEventEmitter = _mod_i1xls3.UniversalEventEmitter;;
+const _mod_ris11a = require('./stream.cjs');
+exports.UniversalStreamResponse = _mod_ris11a.UniversalStreamResponse;
+exports.StreamResponse = _mod_ris11a.StreamResponse;;
+const _mod_itq9aa = require('./download.cjs');
+exports.UniversalDownloadResponse = _mod_itq9aa.UniversalDownloadResponse;
+exports.DownloadResponse = _mod_itq9aa.DownloadResponse;;
+const _mod_c440cb = require('./upload.cjs');
+exports.UniversalUploadResponse = _mod_c440cb.UniversalUploadResponse;
+exports.UploadResponse = _mod_c440cb.UploadResponse;;

package/dist/utils/socket-telemetry.cjs

@@ -0,0 +1,125 @@
+const socketTelemetryMap = new WeakMap;
+let socketIdCounter = 0;
+function instrumentSocket(socket, isSecure = false) {
+  const existing = socketTelemetryMap.get(socket);
+  if (existing) {
+    existing.reuse.count++;
+    existing.reuse.lastUsed = Date.now();
+    existing.reuse.isReused = true;
+    return existing;
+  }
+  const now = Date.now();
+  const telemetry = {
+    id: ++socketIdCounter,
+    timings: {
+      created: now
+    },
+    network: {},
+    reuse: {
+      count: 1,
+      lastUsed: now,
+      isReused: false
+    },
+    connected: false,
+    closed: false
+  };
+  socketTelemetryMap.set(socket, telemetry);
+  socket.once("lookup", (err, address, family) => {
+    if (!err && address) {
+      telemetry.timings.dnsEnd = Date.now();
+      telemetry.timings.dnsDuration = telemetry.timings.dnsEnd - telemetry.timings.created;
+      telemetry.timings.address = address;
+      telemetry.timings.family = typeof family === "number" ? family : family === "IPv6" ? 6 : 4;
+    }
+  });
+  socket.once("connect", () => {
+    telemetry.timings.connectEnd = Date.now();
+    telemetry.timings.tcpDuration = telemetry.timings.connectEnd - (telemetry.timings.dnsEnd || telemetry.timings.created);
+    telemetry.connected = true;
+    const s = socket;
+    telemetry.network = {
+      remoteAddress: s.remoteAddress,
+      remotePort: s.remotePort,
+      localAddress: s.localAddress,
+      localPort: s.localPort,
+      family: s.remoteFamily
+    };
+  });
+  if (isSecure) {
+    socket.once("secureConnect", () => {
+      const tlsSocket = socket;
+      telemetry.timings.secureConnectEnd = Date.now();
+      telemetry.timings.tlsDuration = telemetry.timings.secureConnectEnd - (telemetry.timings.connectEnd || telemetry.timings.created);
+      const cipher = tlsSocket.getCipher?.();
+      const cert = tlsSocket.getPeerCertificate?.();
+      telemetry.tls = {
+        protocol: tlsSocket.getProtocol?.() || undefined,
+        cipher: cipher?.name,
+        authorized: tlsSocket.authorized,
+        authorizationError: tlsSocket.authorizationError,
+        certificate: cert ? {
+          subject: cert.subject?.CN,
+          issuer: cert.issuer?.CN,
+          validFrom: cert.valid_from,
+          validTo: cert.valid_to,
+          fingerprint: cert.fingerprint
+        } : undefined
+      };
+    });
+  }
+  socket.once("close", () => {
+    telemetry.closed = true;
+    telemetry.connected = false;
+  });
+  return telemetry;
+}
+function getSocketTelemetry(socket) {
+  return socketTelemetryMap.get(socket);
+}
+function isSocketInstrumented(socket) {
+  return socketTelemetryMap.has(socket);
+}
+function beginRequestContext(socket, isSecure = false) {
+  const startTime = Date.now();
+  let telemetry = getSocketTelemetry(socket);
+  const wasInstrumented = !!telemetry;
+  if (!telemetry) {
+    telemetry = instrumentSocket(socket, isSecure);
+  } else {
+    telemetry.reuse.count++;
+    telemetry.reuse.lastUsed = startTime;
+    telemetry.reuse.isReused = true;
+  }
+  const connectionReused = wasInstrumented || telemetry.connected;
+  return {
+    startTime,
+    connectionReused,
+    socketWait: 0,
+    dns: connectionReused ? 0 : telemetry.timings.dnsDuration || 0,
+    tcp: connectionReused ? 0 : telemetry.timings.tcpDuration || 0,
+    tls: connectionReused ? 0 : telemetry.timings.tlsDuration || 0,
+    socketTimings: { ...telemetry.timings }
+  };
+}
+function getSocketReuseStats(socket) {
+  const telemetry = socketTelemetryMap.get(socket);
+  if (!telemetry)
+    return;
+  return {
+    count: telemetry.reuse.count,
+    lifetime: Date.now() - telemetry.timings.created,
+    isReused: telemetry.reuse.isReused
+  };
+}
+function exportTelemetryStats() {
+  return {
+    activeSocketCount: socketIdCounter
+  };
+}
+
+exports.instrumentSocket = instrumentSocket;
+exports.getSocketTelemetry = getSocketTelemetry;
+exports.isSocketInstrumented = isSocketInstrumented;
+exports.beginRequestContext = beginRequestContext;
+exports.getSocketReuseStats = getSocketReuseStats;
+exports.exportTelemetryStats = exportTelemetryStats;

package/dist/utils/socket-telemetry.js

@@ -0,0 +1,118 @@
+const socketTelemetryMap = new WeakMap;
+let socketIdCounter = 0;
+export function instrumentSocket(socket, isSecure = false) {
+  const existing = socketTelemetryMap.get(socket);
+  if (existing) {
+    existing.reuse.count++;
+    existing.reuse.lastUsed = Date.now();
+    existing.reuse.isReused = true;
+    return existing;
+  }
+  const now = Date.now();
+  const telemetry = {
+    id: ++socketIdCounter,
+    timings: {
+      created: now
+    },
+    network: {},
+    reuse: {
+      count: 1,
+      lastUsed: now,
+      isReused: false
+    },
+    connected: false,
+    closed: false
+  };
+  socketTelemetryMap.set(socket, telemetry);
+  socket.once("lookup", (err, address, family) => {
+    if (!err && address) {
+      telemetry.timings.dnsEnd = Date.now();
+      telemetry.timings.dnsDuration = telemetry.timings.dnsEnd - telemetry.timings.created;
+      telemetry.timings.address = address;
+      telemetry.timings.family = typeof family === "number" ? family : family === "IPv6" ? 6 : 4;
+    }
+  });
+  socket.once("connect", () => {
+    telemetry.timings.connectEnd = Date.now();
+    telemetry.timings.tcpDuration = telemetry.timings.connectEnd - (telemetry.timings.dnsEnd || telemetry.timings.created);
+    telemetry.connected = true;
+    const s = socket;
+    telemetry.network = {
+      remoteAddress: s.remoteAddress,
+      remotePort: s.remotePort,
+      localAddress: s.localAddress,
+      localPort: s.localPort,
+      family: s.remoteFamily
+    };
+  });
+  if (isSecure) {
+    socket.once("secureConnect", () => {
+      const tlsSocket = socket;
+      telemetry.timings.secureConnectEnd = Date.now();
+      telemetry.timings.tlsDuration = telemetry.timings.secureConnectEnd - (telemetry.timings.connectEnd || telemetry.timings.created);
+      const cipher = tlsSocket.getCipher?.();
+      const cert = tlsSocket.getPeerCertificate?.();
+      telemetry.tls = {
+        protocol: tlsSocket.getProtocol?.() || undefined,
+        cipher: cipher?.name,
+        authorized: tlsSocket.authorized,
+        authorizationError: tlsSocket.authorizationError,
+        certificate: cert ? {
+          subject: cert.subject?.CN,
+          issuer: cert.issuer?.CN,
+          validFrom: cert.valid_from,
+          validTo: cert.valid_to,
+          fingerprint: cert.fingerprint
+        } : undefined
+      };
+    });
+  }
+  socket.once("close", () => {
+    telemetry.closed = true;
+    telemetry.connected = false;
+  });
+  return telemetry;
+}
+export function getSocketTelemetry(socket) {
+  return socketTelemetryMap.get(socket);
+}
+export function isSocketInstrumented(socket) {
+  return socketTelemetryMap.has(socket);
+}
+export function beginRequestContext(socket, isSecure = false) {
+  const startTime = Date.now();
+  let telemetry = getSocketTelemetry(socket);
+  const wasInstrumented = !!telemetry;
+  if (!telemetry) {
+    telemetry = instrumentSocket(socket, isSecure);
+  } else {
+    telemetry.reuse.count++;
+    telemetry.reuse.lastUsed = startTime;
+    telemetry.reuse.isReused = true;
+  }
+  const connectionReused = wasInstrumented || telemetry.connected;
+  return {
+    startTime,
+    connectionReused,
+    socketWait: 0,
+    dns: connectionReused ? 0 : telemetry.timings.dnsDuration || 0,
+    tcp: connectionReused ? 0 : telemetry.timings.tcpDuration || 0,
+    tls: connectionReused ? 0 : telemetry.timings.tlsDuration || 0,
+    socketTimings: { ...telemetry.timings }
+  };
+}
+export function getSocketReuseStats(socket) {
+  const telemetry = socketTelemetryMap.get(socket);
+  if (!telemetry)
+    return;
+  return {
+    count: telemetry.reuse.count,
+    lifetime: Date.now() - telemetry.timings.created,
+    isReused: telemetry.reuse.isReused
+  };
+}
+export function exportTelemetryStats() {
+  return {
+    activeSocketCount: socketIdCounter
+  };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rezo",
-  "version": "1.0.46",
+  "version": "1.0.47",
   "description": "Lightning-fast, enterprise-grade HTTP client for modern JavaScript. Full HTTP/2 support, intelligent cookie management, multiple adapters (HTTP, Fetch, cURL, XHR), streaming, proxy support (HTTP/HTTPS/SOCKS), and cross-environment compatibility.",
   "main": "dist/index.cjs",
   "module": "dist/index.js",