pingflux 1.0.0

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

@@ -0,0 +1,24 @@
+export type PingResult = {
+    ok: boolean;
+    latency: number | null;
+    error?: string;
+};
+/**
+ * Send a raw ICMP echo request to the given IP address and wait for a matching reply.
+ * The blocking `recvfrom` syscall runs inside a Worker thread to avoid blocking the main event loop.
+ *
+ * Requires elevated privileges:
+ * - Linux: root or `CAP_NET_RAW` capability
+ * - macOS: root or process entitlement
+ * - Windows: Administrator
+ *
+ * @param host - Target IPv4 address. Hostname resolution is not supported — resolve before calling.
+ * @param id - ICMP echo identifier (0x0001–0xfffe).
+ * @param seq - ICMP echo sequence number (0x0001–0xfffe).
+ *
+ * @example
+ * const result = await rawPing("1.1.1.1", 1, 1);
+ * console.log(result.ok, result.latency);
+ */
+export declare function rawPing(host: string, id: number, seq: number): Promise<PingResult>;
+//# sourceMappingURL=ping.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ping.d.ts","sourceRoot":"","sources":["../../../src/utils/probes/ping.ts"],"names":[],"mappings":"AA+BA,MAAM,MAAM,UAAU,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AA0HjF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAQlF"}

package/dist/utils/probes/ping.js

@@ -0,0 +1,218 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rawPing = rawPing;
+const koffi_1 = __importDefault(require("koffi"));
+const os = __importStar(require("os"));
+const worker_threads_1 = require("worker_threads");
+const timer_1 = require("../timer");
+const platform = os.platform();
+const lib = platform === "win32"
+    ? koffi_1.default.load("ws2_32.dll")
+    : koffi_1.default.load(platform === "darwin" ? "libSystem.B.dylib" : "libc.so.6");
+const _socket = lib.func("int socket(int domain, int type, int protocol)");
+const _close = platform === "win32"
+    ? lib.func("int closesocket(int s)")
+    : lib.func("int close(int fd)");
+const _sendto = lib.func(platform === "win32"
+    ? "int sendto(int s, uint8* buf, int len, int flags, uint8* to, int tolen)"
+    : "int sendto(int sockfd, uint8* buf, size_t len, int flags, uint8* dest_addr, uint32 addrlen)");
+const _recvfrom = lib.func(platform === "win32"
+    ? "int recvfrom(int s, uint8* buf, int len, int flags, uint8* from, int* fromlen)"
+    : "int recvfrom(int sockfd, uint8* buf, size_t len, int flags, uint8* src_addr, uint32* addrlen)");
+const _inet_addr = lib.func("uint32 inet_addr(str cp)");
+const _setsockopt = lib.func(platform === "win32"
+    ? "int setsockopt(int s, int level, int optname, uint8* optval, int optlen)"
+    : "int setsockopt(int sockfd, int level, int optname, uint8* optval, uint32 optlen)");
+if (platform === "win32") {
+    const _WSAStartup = lib.func("int WSAStartup(uint16 wVersionRequired, uint8* lpWSAData)");
+    _WSAStartup(0x0202, Buffer.alloc(408));
+}
+function icmpChecksum(buffer) {
+    let sum = 0;
+    for (let i = 0; i < buffer.length - 1; i += 2) {
+        sum += (buffer[i] << 8) + buffer[i + 1];
+    }
+    if (buffer.length % 2 !== 0) {
+        sum += buffer[buffer.length - 1] << 8;
+    }
+    while (sum >> 16) {
+        sum = (sum & 0xffff) + (sum >> 16);
+    }
+    return (~sum) & 0xffff;
+}
+function buildICMPPacket(id, seq) {
+    const payload = Buffer.from("pingflux-icmp-probe");
+    const packet = Buffer.alloc(8 + payload.length);
+    packet.writeUInt8(8, 0);
+    packet.writeUInt8(0, 1);
+    packet.writeUInt16BE(0, 2);
+    packet.writeUInt16BE(id & 0xffff, 4);
+    packet.writeUInt16BE(seq & 0xffff, 6);
+    payload.copy(packet, 8);
+    packet.writeUInt16BE(icmpChecksum(packet), 2);
+    return packet;
+}
+function parseICMPReply(buffer) {
+    if (buffer.length < 28)
+        return { type: -1, id: 0, seq: 0 };
+    const ihl = (buffer[0] & 0x0f) * 4;
+    if (buffer.length < ihl + 8)
+        return { type: -1, id: 0, seq: 0 };
+    return {
+        type: buffer.readUInt8(ihl),
+        id: buffer.readUInt16BE(ihl + 4),
+        seq: buffer.readUInt16BE(ihl + 6),
+    };
+}
+function buildSockAddr(host) {
+    const ip = _inet_addr(host);
+    if (ip === 0xffffffff)
+        return null;
+    const addr = Buffer.alloc(16);
+    addr.writeUInt16LE(2, 0);
+    addr.writeUInt32LE(ip, 4);
+    return addr;
+}
+function applyTimeout(sock) {
+    if (platform === "win32") {
+        const tv = Buffer.alloc(4);
+        tv.writeUInt32LE(2000, 0);
+        _setsockopt(sock, 0xffff, 0x1006, tv, 4);
+    }
+    else if (platform === "darwin") {
+        const tv = Buffer.alloc(8);
+        tv.writeInt32LE(2, 0);
+        tv.writeInt32LE(0, 4);
+        _setsockopt(sock, 0xffff, 0x1006, tv, 8);
+    }
+    else {
+        const tv = Buffer.alloc(16);
+        tv.writeBigInt64LE(BigInt(2), 0);
+        tv.writeBigInt64LE(BigInt(0), 8);
+        _setsockopt(sock, 1, 20, tv, 16);
+    }
+}
+function receiveMatchingReply(sock, id, seq) {
+    for (let attempt = 0; attempt < 5; attempt++) {
+        const recvBuf = Buffer.alloc(1024);
+        const fromLen = Buffer.alloc(4);
+        fromLen.writeUInt32LE(16, 0);
+        const received = _recvfrom(sock, recvBuf, recvBuf.length, 0, Buffer.alloc(16), fromLen);
+        if (received < 0)
+            break;
+        const reply = parseICMPReply(recvBuf.slice(0, received));
+        if (reply.type === 0 && reply.id === id && reply.seq === seq)
+            return true;
+    }
+    return false;
+}
+if (!worker_threads_1.isMainThread && worker_threads_1.workerData?.pingfluxWorker === true) {
+    const { host, id, seq } = worker_threads_1.workerData;
+    let sock = -1;
+    try {
+        sock = _socket(2, 3, 1);
+        if (sock < 0) {
+            worker_threads_1.parentPort.postMessage({
+                ok: false,
+                latency: null,
+                error: platform === "win32"
+                    ? "Failed to create raw socket — run as Administrator"
+                    : "Failed to create raw socket — run as root or set CAP_NET_RAW",
+            });
+        }
+        else {
+            applyTimeout(sock);
+            const addr = buildSockAddr(host);
+            if (!addr) {
+                _close(sock);
+                worker_threads_1.parentPort.postMessage({ ok: false, latency: null, error: "Invalid IP — hostname resolution not supported" });
+            }
+            else {
+                const packet = buildICMPPacket(id, seq);
+                const stop = (0, timer_1.startTimer)();
+                if (_sendto(sock, packet, packet.length, 0, addr, 16) < 0) {
+                    _close(sock);
+                    worker_threads_1.parentPort.postMessage({ ok: false, latency: null, error: "Failed to send ICMP packet" });
+                }
+                else {
+                    const matched = receiveMatchingReply(sock, id, seq);
+                    const latency = stop();
+                    _close(sock);
+                    worker_threads_1.parentPort.postMessage(matched
+                        ? { ok: true, latency }
+                        : { ok: false, latency: null, error: "ICMP timeout — no matching reply received" });
+                }
+            }
+        }
+    }
+    catch (err) {
+        try {
+            _close(sock);
+        }
+        catch { }
+        worker_threads_1.parentPort.postMessage({ ok: false, latency: null, error: err.message });
+    }
+}
+/**
+ * Send a raw ICMP echo request to the given IP address and wait for a matching reply.
+ * The blocking `recvfrom` syscall runs inside a Worker thread to avoid blocking the main event loop.
+ *
+ * Requires elevated privileges:
+ * - Linux: root or `CAP_NET_RAW` capability
+ * - macOS: root or process entitlement
+ * - Windows: Administrator
+ *
+ * @param host - Target IPv4 address. Hostname resolution is not supported — resolve before calling.
+ * @param id - ICMP echo identifier (0x0001–0xfffe).
+ * @param seq - ICMP echo sequence number (0x0001–0xfffe).
+ *
+ * @example
+ * const result = await rawPing("1.1.1.1", 1, 1);
+ * console.log(result.ok, result.latency);
+ */
+function rawPing(host, id, seq) {
+    return new Promise((resolve) => {
+        const worker = new worker_threads_1.Worker(__filename, {
+            workerData: { pingfluxWorker: true, host, id, seq },
+        });
+        worker.once("message", (result) => resolve(result));
+        worker.once("error", (err) => resolve({ ok: false, latency: null, error: err.message }));
+    });
+}
+//# sourceMappingURL=ping.js.map

package/dist/utils/probes/ping.js.map

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

package/dist/utils/timer.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Start a high-resolution timer using `process.hrtime.bigint()`.
+ * Call the returned function to get the elapsed time in milliseconds.
+ *
+ * @returns A function that, when called, returns the elapsed time in milliseconds (floating-point).
+ *
+ * @example
+ * const stop = startTimer();
+ * await doSomething();
+ * const ms = stop(); // e.g. 42.317
+ */
+export declare function startTimer(): () => number;
+//# sourceMappingURL=timer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../../src/utils/timer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,IAAI,MAAM,MAAM,CAGzC"}

package/dist/utils/timer.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startTimer = startTimer;
+/**
+ * Start a high-resolution timer using `process.hrtime.bigint()`.
+ * Call the returned function to get the elapsed time in milliseconds.
+ *
+ * @returns A function that, when called, returns the elapsed time in milliseconds (floating-point).
+ *
+ * @example
+ * const stop = startTimer();
+ * await doSomething();
+ * const ms = stop(); // e.g. 42.317
+ */
+function startTimer() {
+    const start = process.hrtime.bigint();
+    return () => Number(process.hrtime.bigint() - start) / 1000000;
+}
+//# sourceMappingURL=timer.js.map

package/dist/utils/timer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.js","sourceRoot":"","sources":["../../src/utils/timer.ts"],"names":[],"mappings":";;AAWA,gCAGC;AAdD;;;;;;;;;;GAUG;AACH,SAAgB,UAAU;IACxB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IACtC,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,OAAS,CAAC;AACnE,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "pingflux",
+  "version": "1.0.0",
+  "description": "A lightweight, event-driven network diagnostics and observability SDK for Node.js",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "network",
+    "ping",
+    "tcp",
+    "udp",
+    "dns",
+    "http",
+    "latency",
+    "diagnostics"
+  ],
+  "author": "AmirVoid12 (https://github.com/AmirVoid12)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AmirVoid12/pingflux.git"
+  },
+  "bugs": {
+    "url": "https://github.com/AmirVoid12/pingflux/issues"
+  },
+  "homepage": "https://github.com/AmirVoid12/pingflux#readme",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "koffi": "^3.0.2"
+  },
+  "directories": {
+    "test": "test"
+  }
+}