pingflux 1.0.0

package/dist/probes/dns.js

@@ -0,0 +1,86 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dnsProbe = dnsProbe;
+const dns = __importStar(require("dns"));
+const timer_1 = require("../utils/timer");
+/**
+ * Probe a host via DNS resolution.
+ * Attempts A record lookup first, then AAAA, then CNAME as a final fallback.
+ * Resolves `ok: true` if any record type is found.
+ *
+ * Note: only A, AAAA, and CNAME record types are checked.
+ * Hosts with exclusively MX, TXT, or other record types will resolve as `ok: false`.
+ *
+ * @param url - Hostname to resolve, optionally with a port suffix (e.g. `"example.com"` or `"example.com:53"`).
+ *
+ * @example
+ * const result = await dnsProbe("example.com");
+ * console.log(result.ok, result.latency);
+ */
+function dnsProbe(url) {
+    return new Promise((resolve) => {
+        const host = url.split(":")[0];
+        const stop = (0, timer_1.startTimer)();
+        dns.resolve4(host, (err4, v4) => {
+            if (!err4 && v4.length > 0) {
+                resolve({ ok: true, latency: stop(), protocol: "dns", target: url, timestamp: Date.now() });
+                return;
+            }
+            dns.resolve6(host, (err6, v6) => {
+                if (!err6 && v6.length > 0) {
+                    resolve({ ok: true, latency: stop(), protocol: "dns", target: url, timestamp: Date.now() });
+                    return;
+                }
+                dns.resolveCname(host, (errCname, cnames) => {
+                    const latency = stop();
+                    if (!errCname && cnames.length > 0) {
+                        resolve({ ok: true, latency, protocol: "dns", target: url, timestamp: Date.now() });
+                        return;
+                    }
+                    resolve({
+                        ok: false,
+                        latency: null,
+                        error: err4?.message ?? err6?.message ?? errCname?.message ?? "No records found",
+                        protocol: "dns",
+                        target: url,
+                        timestamp: Date.now(),
+                    });
+                });
+            });
+        });
+    });
+}
+//# sourceMappingURL=dns.js.map

package/dist/probes/dns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dns.js","sourceRoot":"","sources":["../../src/probes/dns.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBA,4BAmCC;AArDD,yCAA2B;AAE3B,0CAA4C;AAE5C;;;;;;;;;;;;;GAaG;AACH,SAAgB,QAAQ,CAAC,GAAW;IAClC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAA,kBAAU,GAAE,CAAC;QAE1B,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE;YAC9B,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3B,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC5F,OAAO;YACT,CAAC;YAED,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE;gBAC9B,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC3B,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;oBAC5F,OAAO;gBACT,CAAC;gBAED,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;oBAC1C,MAAM,OAAO,GAAG,IAAI,EAAE,CAAC;oBACvB,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACnC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;wBACpF,OAAO;oBACT,CAAC;oBACD,OAAO,CAAC;wBACN,EAAE,EAAE,KAAK;wBACT,OAAO,EAAE,IAAI;wBACb,KAAK,EAAE,IAAI,EAAE,OAAO,IAAI,IAAI,EAAE,OAAO,IAAI,QAAQ,EAAE,OAAO,IAAI,kBAAkB;wBAChF,QAAQ,EAAE,KAAK;wBACf,MAAM,EAAE,GAAG;wBACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;qBACtB,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/probes/http.d.ts

@@ -0,0 +1,17 @@
+import { ProbeResult, Protocol } from "../interfaces";
+/**
+ * Probe a host via HTTP or HTTPS GET request.
+ * Resolves `ok: true` if the response status code is less than 400.
+ * Automatically strips any existing protocol prefix from `url` before parsing
+ * to avoid double-prefixing (e.g. passing `"https://example.com"` with protocol `"https"` is safe).
+ *
+ * @param url - Target URL or hostname, with or without protocol prefix
+ *              (e.g. `"example.com"`, `"example.com/health"`, or `"https://example.com/health"`).
+ * @param protocol - Must be `"http"` or `"https"`. Determines the transport and default port.
+ *
+ * @example
+ * const result = await httpProbe("example.com/health", "https");
+ * console.log(result.ok, result.latency);
+ */
+export declare function httpProbe(url: string, protocol: Protocol): Promise<ProbeResult>;
+//# sourceMappingURL=http.d.ts.map

package/dist/probes/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/probes/http.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGtD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CAkE/E"}

package/dist/probes/http.js

@@ -0,0 +1,117 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.httpProbe = httpProbe;
+const http = __importStar(require("http"));
+const https = __importStar(require("https"));
+const url_1 = require("url");
+const timer_1 = require("../utils/timer");
+/**
+ * Probe a host via HTTP or HTTPS GET request.
+ * Resolves `ok: true` if the response status code is less than 400.
+ * Automatically strips any existing protocol prefix from `url` before parsing
+ * to avoid double-prefixing (e.g. passing `"https://example.com"` with protocol `"https"` is safe).
+ *
+ * @param url - Target URL or hostname, with or without protocol prefix
+ *              (e.g. `"example.com"`, `"example.com/health"`, or `"https://example.com/health"`).
+ * @param protocol - Must be `"http"` or `"https"`. Determines the transport and default port.
+ *
+ * @example
+ * const result = await httpProbe("example.com/health", "https");
+ * console.log(result.ok, result.latency);
+ */
+function httpProbe(url, protocol) {
+    return new Promise((resolve) => {
+        const stop = (0, timer_1.startTimer)();
+        const lib = protocol === "https" ? https : http;
+        const stripped = url.replace(/^https?:\/\//i, "");
+        let parsedUrl;
+        try {
+            parsedUrl = new url_1.URL(`${protocol}://${stripped}`);
+        }
+        catch {
+            resolve({
+                ok: false,
+                latency: null,
+                error: "Invalid URL format",
+                protocol,
+                target: url,
+                timestamp: Date.now(),
+            });
+            return;
+        }
+        const options = {
+            hostname: parsedUrl.hostname,
+            port: parsedUrl.port || (protocol === "https" ? 443 : 80),
+            path: parsedUrl.pathname + parsedUrl.search,
+            method: "GET",
+            timeout: 10000,
+        };
+        const req = lib.request(options, (res) => {
+            const latency = stop();
+            res.resume();
+            resolve({
+                ok: res.statusCode !== undefined && res.statusCode < 400,
+                latency,
+                protocol,
+                target: url,
+                timestamp: Date.now(),
+            });
+        });
+        req.on("timeout", () => {
+            req.destroy();
+            resolve({
+                ok: false,
+                latency: null,
+                error: "Request timeout",
+                protocol,
+                target: url,
+                timestamp: Date.now(),
+            });
+        });
+        req.on("error", (err) => {
+            resolve({
+                ok: false,
+                latency: null,
+                error: err.message,
+                protocol,
+                target: url,
+                timestamp: Date.now(),
+            });
+        });
+        req.end();
+    });
+}
+//# sourceMappingURL=http.js.map

package/dist/probes/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/probes/http.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoBA,8BAkEC;AAtFD,2CAA6B;AAC7B,6CAA+B;AAC/B,6BAA0B;AAE1B,0CAA4C;AAE5C;;;;;;;;;;;;;GAaG;AACH,SAAgB,SAAS,CAAC,GAAW,EAAE,QAAkB;IACvD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,IAAA,kBAAU,GAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAChD,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QAElD,IAAI,SAAc,CAAC;QACnB,IAAI,CAAC;YACH,SAAS,GAAG,IAAI,SAAG,CAAC,GAAG,QAAQ,MAAM,QAAQ,EAAE,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC;gBACN,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,oBAAoB;gBAC3B,QAAQ;gBACR,MAAM,EAAE,GAAG;gBACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAwB;YACnC,QAAQ,EAAE,SAAS,CAAC,QAAQ;YAC5B,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,IAAI,EAAE,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,MAAM;YAC3C,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,KAAK;SACf,CAAC;QAEF,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACvC,MAAM,OAAO,GAAG,IAAI,EAAE,CAAC;YACvB,GAAG,CAAC,MAAM,EAAE,CAAC;YACb,OAAO,CAAC;gBACN,EAAE,EAAE,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,GAAG,CAAC,UAAU,GAAG,GAAG;gBACxD,OAAO;gBACP,QAAQ;gBACR,MAAM,EAAE,GAAG;gBACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YACrB,GAAG,CAAC,OAAO,EAAE,CAAC;YACd,OAAO,CAAC;gBACN,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,iBAAiB;gBACxB,QAAQ;gBACR,MAAM,EAAE,GAAG;gBACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACtB,OAAO,CAAC;gBACN,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,GAAG,CAAC,OAAO;gBAClB,QAAQ;gBACR,MAAM,EAAE,GAAG;gBACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,GAAG,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/probes/ping.d.ts

@@ -0,0 +1,21 @@
+import { ProbeResult } from "../interfaces";
+/**
+ * Probe a host via raw ICMP echo request (ping).
+ * Internally uses a Worker thread to avoid blocking the event loop.
+ *
+ * Requires elevated privileges:
+ * - Linux: root or `CAP_NET_RAW` capability (`sudo setcap cap_net_raw+ep node`)
+ * - macOS: root
+ * - Windows: Administrator
+ *
+ * Note: `url` must be a plain IPv4 address — hostname resolution is not performed.
+ *
+ * @param url - Target IPv4 address, optionally with port suffix (port is ignored).
+ *              IPv6 addresses in bracket notation are also parsed (e.g. `"[::1]"`).
+ *
+ * @example
+ * const result = await pingProbe("1.1.1.1");
+ * console.log(result.ok, result.latency);
+ */
+export declare function pingProbe(url: string): Promise<ProbeResult>;
+//# sourceMappingURL=ping.d.ts.map

package/dist/probes/ping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping.d.ts","sourceRoot":"","sources":["../../src/probes/ping.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAcjE"}

package/dist/probes/ping.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pingProbe = pingProbe;
+const ping_1 = require("../utils/probes/ping");
+/**
+ * Probe a host via raw ICMP echo request (ping).
+ * Internally uses a Worker thread to avoid blocking the event loop.
+ *
+ * Requires elevated privileges:
+ * - Linux: root or `CAP_NET_RAW` capability (`sudo setcap cap_net_raw+ep node`)
+ * - macOS: root
+ * - Windows: Administrator
+ *
+ * Note: `url` must be a plain IPv4 address — hostname resolution is not performed.
+ *
+ * @param url - Target IPv4 address, optionally with port suffix (port is ignored).
+ *              IPv6 addresses in bracket notation are also parsed (e.g. `"[::1]"`).
+ *
+ * @example
+ * const result = await pingProbe("1.1.1.1");
+ * console.log(result.ok, result.latency);
+ */
+async function pingProbe(url) {
+    const host = url.startsWith("[") ? url.slice(1, url.indexOf("]")) : url.split(":")[0];
+    const id = (Math.floor(Math.random() * 0xfffe) + 1) & 0xffff;
+    const seq = (Math.floor(Math.random() * 0xfffe) + 1) & 0xffff;
+    const result = await (0, ping_1.rawPing)(host, id, seq);
+    return {
+        ok: result.ok,
+        latency: result.latency,
+        error: result.error,
+        protocol: "ping",
+        target: url,
+        timestamp: Date.now(),
+    };
+}
+//# sourceMappingURL=ping.js.map

package/dist/probes/ping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping.js","sourceRoot":"","sources":["../../src/probes/ping.ts"],"names":[],"mappings":";;AAqBA,8BAcC;AAlCD,+CAA+C;AAE/C;;;;;;;;;;;;;;;;;GAiBG;AACI,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACtF,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC;IAC7D,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC;IAC9D,MAAM,MAAM,GAAG,MAAM,IAAA,cAAO,EAAC,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;IAE5C,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;AACJ,CAAC"}

package/dist/probes/tcp.d.ts

@@ -0,0 +1,14 @@
+import { ProbeResult } from "../interfaces";
+/**
+ * Probe a host via TCP connection attempt.
+ * Resolves `ok: true` if the connection is established successfully.
+ * The socket is immediately destroyed after a successful connect — no data is sent.
+ *
+ * @param url - Target in `"host:port"` format (e.g. `"example.com:443"` or `"1.2.3.4:80"`).
+ *
+ * @example
+ * const result = await tcpProbe("example.com:443");
+ * console.log(result.ok, result.latency);
+ */
+export declare function tcpProbe(url: string): Promise<ProbeResult>;
+//# sourceMappingURL=tcp.d.ts.map

package/dist/probes/tcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tcp.d.ts","sourceRoot":"","sources":["../../src/probes/tcp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAsE1D"}

package/dist/probes/tcp.js

@@ -0,0 +1,115 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tcpProbe = tcpProbe;
+const net = __importStar(require("net"));
+const timer_1 = require("../utils/timer");
+/**
+ * Probe a host via TCP connection attempt.
+ * Resolves `ok: true` if the connection is established successfully.
+ * The socket is immediately destroyed after a successful connect — no data is sent.
+ *
+ * @param url - Target in `"host:port"` format (e.g. `"example.com:443"` or `"1.2.3.4:80"`).
+ *
+ * @example
+ * const result = await tcpProbe("example.com:443");
+ * console.log(result.ok, result.latency);
+ */
+function tcpProbe(url) {
+    return new Promise((resolve) => {
+        const [host, portStr] = url.split(":");
+        const port = parseInt(portStr, 10);
+        if (!host || isNaN(port)) {
+            resolve({
+                ok: false,
+                latency: null,
+                error: "Invalid host:port format",
+                protocol: "tcp",
+                target: url,
+                timestamp: Date.now(),
+            });
+            return;
+        }
+        const stop = (0, timer_1.startTimer)();
+        const socket = new net.Socket();
+        let resolved = false;
+        const cleanup = () => {
+            if (!socket.destroyed)
+                socket.destroy();
+        };
+        socket.setTimeout(10000);
+        socket.connect(port, host, () => {
+            const latency = stop();
+            resolved = true;
+            cleanup();
+            resolve({
+                ok: true,
+                latency,
+                protocol: "tcp",
+                target: url,
+                timestamp: Date.now(),
+            });
+        });
+        socket.on("timeout", () => {
+            if (!resolved) {
+                resolved = true;
+                cleanup();
+                resolve({
+                    ok: false,
+                    latency: null,
+                    error: "TCP connection timeout",
+                    protocol: "tcp",
+                    target: url,
+                    timestamp: Date.now(),
+                });
+            }
+        });
+        socket.on("error", (err) => {
+            if (!resolved) {
+                resolved = true;
+                cleanup();
+                resolve({
+                    ok: false,
+                    latency: null,
+                    error: err.message,
+                    protocol: "tcp",
+                    target: url,
+                    timestamp: Date.now(),
+                });
+            }
+        });
+    });
+}
+//# sourceMappingURL=tcp.js.map

package/dist/probes/tcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tcp.js","sourceRoot":"","sources":["../../src/probes/tcp.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeA,4BAsEC;AArFD,yCAA2B;AAE3B,0CAA4C;AAE5C;;;;;;;;;;GAUG;AACH,SAAgB,QAAQ,CAAC,GAAW;IAClC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAEnC,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC;gBACN,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,0BAA0B;gBACjC,QAAQ,EAAE,KAAK;gBACf,MAAM,EAAE,GAAG;gBACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,IAAA,kBAAU,GAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAChC,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,IAAI,CAAC,MAAM,CAAC,SAAS;gBAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QAC1C,CAAC,CAAC;QAEF,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAEzB,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;YAC9B,MAAM,OAAO,GAAG,IAAI,EAAE,CAAC;YACvB,QAAQ,GAAG,IAAI,CAAC;YAChB,OAAO,EAAE,CAAC;YACV,OAAO,CAAC;gBACN,EAAE,EAAE,IAAI;gBACR,OAAO;gBACP,QAAQ,EAAE,KAAK;gBACf,MAAM,EAAE,GAAG;gBACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YACxB,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,QAAQ,GAAG,IAAI,CAAC;gBAChB,OAAO,EAAE,CAAC;gBACV,OAAO,CAAC;oBACN,EAAE,EAAE,KAAK;oBACT,OAAO,EAAE,IAAI;oBACb,KAAK,EAAE,wBAAwB;oBAC/B,QAAQ,EAAE,KAAK;oBACf,MAAM,EAAE,GAAG;oBACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;iBACtB,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACzB,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,QAAQ,GAAG,IAAI,CAAC;gBAChB,OAAO,EAAE,CAAC;gBACV,OAAO,CAAC;oBACN,EAAE,EAAE,KAAK;oBACT,OAAO,EAAE,IAAI;oBACb,KAAK,EAAE,GAAG,CAAC,OAAO;oBAClB,QAAQ,EAAE,KAAK;oBACf,MAAM,EAAE,GAAG;oBACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;iBACtB,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/probes/udp.d.ts

@@ -0,0 +1,19 @@
+import { ProbeResult } from "../interfaces";
+/**
+ * Probe a host via UDP by sending a small packet and waiting for any response.
+ * Resolves `ok: true` only if a response packet is received within the timeout window.
+ *
+ * Note: UDP is connectionless — most servers do not reply to arbitrary packets.
+ * A timeout (`ok: false`) does not necessarily mean the host is down; it may simply
+ * mean the server ignored the probe. This probe is most useful for services that
+ * explicitly echo UDP packets (e.g. custom health-check endpoints, DNS on port 53).
+ * For DNS specifically, use the `dns` protocol instead.
+ *
+ * @param url - Target in `"host:port"` format (e.g. `"1.2.3.4:9000"`).
+ *
+ * @example
+ * const result = await udpProbe("1.2.3.4:9000");
+ * console.log(result.ok, result.latency);
+ */
+export declare function udpProbe(url: string): Promise<ProbeResult>;
+//# sourceMappingURL=udp.d.ts.map

package/dist/probes/udp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"udp.d.ts","sourceRoot":"","sources":["../../src/probes/udp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAqF1D"}

package/dist/probes/udp.js

@@ -0,0 +1,135 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.udpProbe = udpProbe;
+const dgram = __importStar(require("dgram"));
+const timer_1 = require("../utils/timer");
+/**
+ * Probe a host via UDP by sending a small packet and waiting for any response.
+ * Resolves `ok: true` only if a response packet is received within the timeout window.
+ *
+ * Note: UDP is connectionless — most servers do not reply to arbitrary packets.
+ * A timeout (`ok: false`) does not necessarily mean the host is down; it may simply
+ * mean the server ignored the probe. This probe is most useful for services that
+ * explicitly echo UDP packets (e.g. custom health-check endpoints, DNS on port 53).
+ * For DNS specifically, use the `dns` protocol instead.
+ *
+ * @param url - Target in `"host:port"` format (e.g. `"1.2.3.4:9000"`).
+ *
+ * @example
+ * const result = await udpProbe("1.2.3.4:9000");
+ * console.log(result.ok, result.latency);
+ */
+function udpProbe(url) {
+    return new Promise((resolve) => {
+        const [host, portStr] = url.split(":");
+        const port = parseInt(portStr, 10);
+        if (!host || isNaN(port)) {
+            resolve({
+                ok: false,
+                latency: null,
+                error: "Invalid host:port format",
+                protocol: "udp",
+                target: url,
+                timestamp: Date.now(),
+            });
+            return;
+        }
+        const client = dgram.createSocket("udp4");
+        const stop = (0, timer_1.startTimer)();
+        const message = Buffer.from("ping");
+        let resolved = false;
+        const timeout = setTimeout(() => {
+            if (!resolved) {
+                resolved = true;
+                client.close();
+                resolve({
+                    ok: false,
+                    latency: null,
+                    error: "UDP timeout — no response received",
+                    protocol: "udp",
+                    target: url,
+                    timestamp: Date.now(),
+                });
+            }
+        }, 5000);
+        client.on("message", () => {
+            if (!resolved) {
+                const latency = stop();
+                resolved = true;
+                clearTimeout(timeout);
+                client.close();
+                resolve({
+                    ok: true,
+                    latency,
+                    protocol: "udp",
+                    target: url,
+                    timestamp: Date.now(),
+                });
+            }
+        });
+        client.on("error", (err) => {
+            if (!resolved) {
+                resolved = true;
+                clearTimeout(timeout);
+                client.close();
+                resolve({
+                    ok: false,
+                    latency: null,
+                    error: err.message,
+                    protocol: "udp",
+                    target: url,
+                    timestamp: Date.now(),
+                });
+            }
+        });
+        client.send(message, 0, message.length, port, host, (err) => {
+            if (err && !resolved) {
+                resolved = true;
+                clearTimeout(timeout);
+                client.close();
+                resolve({
+                    ok: false,
+                    latency: null,
+                    error: err.message,
+                    protocol: "udp",
+                    target: url,
+                    timestamp: Date.now(),
+                });
+            }
+        });
+    });
+}
+//# sourceMappingURL=udp.js.map

package/dist/probes/udp.js.map

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

package/dist/utils/latency.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Determine whether a measured latency exceeds the given threshold.
+ *
+ * @param latency - Measured latency in milliseconds.
+ * @param threshold - Maximum acceptable latency in milliseconds. Default: `1000`.
+ * @returns `true` if `latency` is strictly greater than `threshold`.
+ *
+ * @example
+ * isSlowLatency(1200, 1000); // true
+ * isSlowLatency(800, 1000);  // false
+ * isSlowLatency(1000, 1000); // false — equal is not slow
+ */
+export declare function isSlowLatency(latency: number, threshold?: number): boolean;
+//# sourceMappingURL=latency.d.ts.map

package/dist/utils/latency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latency.d.ts","sourceRoot":"","sources":["../../src/utils/latency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAa,GAAG,OAAO,CAEhF"}

package/dist/utils/latency.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSlowLatency = isSlowLatency;
+/**
+ * Determine whether a measured latency exceeds the given threshold.
+ *
+ * @param latency - Measured latency in milliseconds.
+ * @param threshold - Maximum acceptable latency in milliseconds. Default: `1000`.
+ * @returns `true` if `latency` is strictly greater than `threshold`.
+ *
+ * @example
+ * isSlowLatency(1200, 1000); // true
+ * isSlowLatency(800, 1000);  // false
+ * isSlowLatency(1000, 1000); // false — equal is not slow
+ */
+function isSlowLatency(latency, threshold = 1000) {
+    return latency > threshold;
+}
+//# sourceMappingURL=latency.js.map

package/dist/utils/latency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"latency.js","sourceRoot":"","sources":["../../src/utils/latency.ts"],"names":[],"mappings":";;AAYA,sCAEC;AAdD;;;;;;;;;;;GAWG;AACH,SAAgB,aAAa,CAAC,OAAe,EAAE,YAAoB,IAAI;IACrE,OAAO,OAAO,GAAG,SAAS,CAAC;AAC7B,CAAC"}