@sonde/packs 0.1.1 → 0.1.3

package/dist/system/probes/ping.test.js

@@ -0,0 +1,127 @@
+import { describe, expect, it } from 'vitest';
+import { parsePingOutput, ping } from './ping.js';
+const LINUX_OUTPUT = `PING 10.0.0.1 (10.0.0.1) 56(84) bytes of data.
+64 bytes from 10.0.0.1: icmp_seq=1 ttl=64 time=0.543 ms
+64 bytes from 10.0.0.1: icmp_seq=2 ttl=64 time=0.401 ms
+64 bytes from 10.0.0.1: icmp_seq=3 ttl=64 time=0.387 ms
+64 bytes from 10.0.0.1: icmp_seq=4 ttl=64 time=0.392 ms
+
+--- 10.0.0.1 ping statistics ---
+4 packets transmitted, 4 received, 0% packet loss, time 3005ms
+rtt min/avg/max/mdev = 0.387/0.430/0.543/0.065 ms
+`;
+const MACOS_OUTPUT = `PING 192.168.1.1 (192.168.1.1): 56 data bytes
+64 bytes from 192.168.1.1: icmp_seq=0 ttl=64 time=1.234 ms
+64 bytes from 192.168.1.1: icmp_seq=1 ttl=64 time=1.456 ms
+64 bytes from 192.168.1.1: icmp_seq=2 ttl=64 time=1.123 ms
+64 bytes from 192.168.1.1: icmp_seq=3 ttl=64 time=1.345 ms
+
+--- 192.168.1.1 ping statistics ---
+4 packets transmitted, 4 packets received, 0.0% packet loss
+round-trip min/avg/max/stddev = 1.123/1.289/1.456/0.122 ms
+`;
+const FULL_LOSS_OUTPUT = `PING 10.99.99.99 (10.99.99.99) 56(84) bytes of data.
+
+--- 10.99.99.99 ping statistics ---
+4 packets transmitted, 0 received, 100% packet loss, time 3003ms
+`;
+const PARTIAL_LOSS_OUTPUT = `PING 10.0.0.5 (10.0.0.5) 56(84) bytes of data.
+64 bytes from 10.0.0.5: icmp_seq=1 ttl=64 time=0.500 ms
+64 bytes from 10.0.0.5: icmp_seq=3 ttl=64 time=0.600 ms
+
+--- 10.0.0.5 ping statistics ---
+4 packets transmitted, 2 received, 50% packet loss, time 3004ms
+rtt min/avg/max/mdev = 0.500/0.550/0.600/0.050 ms
+`;
+describe('parsePingOutput', () => {
+    it('parses valid Linux ping output', () => {
+        const result = parsePingOutput(LINUX_OUTPUT, '10.0.0.1');
+        expect(result.host).toBe('10.0.0.1');
+        expect(result.packetsTransmitted).toBe(4);
+        expect(result.packetsReceived).toBe(4);
+        expect(result.packetLossPercent).toBe(0);
+        expect(result.rttMs).toEqual({
+            min: 0.387,
+            avg: 0.43,
+            max: 0.543,
+            stddev: 0.065,
+        });
+    });
+    it('parses valid macOS ping output', () => {
+        const result = parsePingOutput(MACOS_OUTPUT, '192.168.1.1');
+        expect(result.host).toBe('192.168.1.1');
+        expect(result.packetsTransmitted).toBe(4);
+        expect(result.packetsReceived).toBe(4);
+        expect(result.packetLossPercent).toBe(0);
+        expect(result.rttMs).toEqual({
+            min: 1.123,
+            avg: 1.289,
+            max: 1.456,
+            stddev: 0.122,
+        });
+    });
+    it('handles 100% packet loss', () => {
+        const result = parsePingOutput(FULL_LOSS_OUTPUT, '10.99.99.99');
+        expect(result.packetsTransmitted).toBe(4);
+        expect(result.packetsReceived).toBe(0);
+        expect(result.packetLossPercent).toBe(100);
+        expect(result.rttMs).toBeUndefined();
+    });
+    it('handles partial packet loss with RTT', () => {
+        const result = parsePingOutput(PARTIAL_LOSS_OUTPUT, '10.0.0.5');
+        expect(result.packetsTransmitted).toBe(4);
+        expect(result.packetsReceived).toBe(2);
+        expect(result.packetLossPercent).toBe(50);
+        expect(result.rttMs).toBeDefined();
+        expect(result.rttMs?.avg).toBeCloseTo(0.55);
+    });
+});
+describe('ping handler', () => {
+    it('throws when host param is missing', async () => {
+        const mockExec = async () => '';
+        await expect(ping(undefined, mockExec)).rejects.toThrow('Missing required parameter: host');
+        await expect(ping({}, mockExec)).rejects.toThrow('Missing required parameter: host');
+    });
+    it('passes correct args to exec with default count', async () => {
+        const calls = [];
+        const mockExec = async (cmd, args) => {
+            calls.push({ cmd, args });
+            return LINUX_OUTPUT;
+        };
+        const result = (await ping({ host: '10.0.0.1' }, mockExec));
+        expect(calls).toHaveLength(1);
+        expect(calls[0]?.cmd).toBe('ping');
+        expect(calls[0]?.args).toContain('-c');
+        expect(calls[0]?.args).toContain('4');
+        expect(calls[0]?.args).toContain('10.0.0.1');
+        expect(result.host).toBe('10.0.0.1');
+        expect(result.packetsTransmitted).toBe(4);
+    });
+    it('respects custom count param', async () => {
+        const calls = [];
+        const mockExec = async (cmd, args) => {
+            calls.push({ cmd, args });
+            return LINUX_OUTPUT;
+        };
+        await ping({ host: '10.0.0.1', count: 2 }, mockExec);
+        expect(calls[0]?.args).toContain('2');
+    });
+    it('clamps count to valid range', async () => {
+        const calls = [];
+        const mockExec = async (cmd, args) => {
+            calls.push({ cmd, args });
+            return LINUX_OUTPUT;
+        };
+        await ping({ host: '10.0.0.1', count: 100 }, mockExec);
+        expect(calls[0]?.args).toContain('20');
+        await ping({ host: '10.0.0.1', count: 0 }, mockExec);
+        expect(calls[1]?.args).toContain('1');
+    });
+    it('handles exec failure (DNS resolution error)', async () => {
+        const mockExec = async () => {
+            throw new Error('ping: unknown host nosuchhost.invalid');
+        };
+        await expect(ping({ host: 'nosuchhost.invalid' }, mockExec)).rejects.toThrow('unknown host');
+    });
+});
+//# sourceMappingURL=ping.test.js.map

package/dist/system/probes/ping.test.js.map

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

package/dist/system/probes/traceroute.d.ts

@@ -0,0 +1,17 @@
+import type { ProbeHandler } from '../../types.js';
+export interface TracerouteHop {
+    hop: number;
+    ip: string | null;
+    rttMs: (number | null)[];
+}
+export interface TracerouteResult {
+    host: string;
+    hops: TracerouteHop[];
+}
+/**
+ * Traces the network path to a host via `traceroute -n`.
+ * Works on both Linux and macOS.
+ */
+export declare const traceroute: ProbeHandler;
+export declare function parseTracerouteOutput(raw: string, host: string): TracerouteResult;
+//# sourceMappingURL=traceroute.d.ts.map

package/dist/system/probes/traceroute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceroute.d.ts","sourceRoot":"","sources":["../../../src/system/probes/traceroute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,aAAa,EAAE,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,YAqBxB,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GACX,gBAAgB,CAuBlB"}

package/dist/system/probes/traceroute.js

@@ -0,0 +1,72 @@
+/**
+ * Traces the network path to a host via `traceroute -n`.
+ * Works on both Linux and macOS.
+ */
+export const traceroute = async (params, exec) => {
+    const host = params?.host;
+    if (!host) {
+        throw new Error('Missing required parameter: host');
+    }
+    const maxHops = Math.min(Math.max(Number(params?.maxHops ?? 30), 1), 64);
+    const output = await exec('traceroute', [
+        '-n',
+        '-m',
+        String(maxHops),
+        '-w',
+        '2',
+        host,
+    ]);
+    return parseTracerouteOutput(output, host);
+};
+export function parseTracerouteOutput(raw, host) {
+    const hops = [];
+    const lines = raw.trim().split('\n');
+    for (const line of lines) {
+        // Skip the header line ("traceroute to ...")
+        const hopMatch = line.match(/^\s*(\d+)\s+(.+)/);
+        if (!hopMatch)
+            continue;
+        const hopNum = Number(hopMatch[1]);
+        const rest = hopMatch[2] ?? '';
+        // All probes timed out: "* * *"
+        if (/^\*\s+\*\s+\*\s*$/.test(rest)) {
+            hops.push({ hop: hopNum, ip: null, rttMs: [null, null, null] });
+            continue;
+        }
+        const hop = parseHopLine(hopNum, rest);
+        hops.push(hop);
+    }
+    return { host, hops };
+}
+function parseHopLine(hopNum, rest) {
+    let ip = null;
+    const rttMs = [];
+    // Tokenize the rest of the line
+    const tokens = rest.trim().split(/\s+/);
+    let i = 0;
+    while (i < tokens.length) {
+        const token = tokens[i];
+        if (!token || token === '*') {
+            rttMs.push(null);
+            i++;
+        }
+        else if (token === 'ms') {
+            // Skip "ms" — already consumed the number
+            i++;
+        }
+        else if (/^\d+\.\d+\.\d+\.\d+$/.test(token) || token.includes(':')) {
+            // IPv4 or IPv6 address
+            ip = token;
+            i++;
+        }
+        else {
+            const num = Number.parseFloat(token);
+            if (!Number.isNaN(num)) {
+                rttMs.push(num);
+            }
+            i++;
+        }
+    }
+    return { hop: hopNum, ip, rttMs };
+}
+//# sourceMappingURL=traceroute.js.map

package/dist/system/probes/traceroute.js.map

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

package/dist/system/probes/traceroute.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=traceroute.test.d.ts.map

package/dist/system/probes/traceroute.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceroute.test.d.ts","sourceRoot":"","sources":["../../../src/system/probes/traceroute.test.ts"],"names":[],"mappings":""}

package/dist/system/probes/traceroute.test.js

@@ -0,0 +1,98 @@
+import { describe, expect, it } from 'vitest';
+import { parseTracerouteOutput, traceroute, } from './traceroute.js';
+const LINUX_TRACEROUTE = `traceroute to 8.8.8.8 (8.8.8.8), 30 hops max, 60 byte packets
+ 1  192.168.1.1  1.234 ms  1.100 ms  1.050 ms
+ 2  10.0.0.1  5.432 ms  5.300 ms  5.200 ms
+ 3  * * *
+ 4  172.16.0.1  15.678 ms  15.500 ms  15.400 ms
+ 5  8.8.8.8  20.123 ms  20.050 ms  19.900 ms`;
+const MACOS_TRACEROUTE = `traceroute to 1.1.1.1 (1.1.1.1), 30 hops max, 60 byte packets
+ 1  192.168.0.1  2.345 ms  2.100 ms  2.050 ms
+ 2  * * *
+ 3  1.1.1.1  10.567 ms  10.400 ms  10.300 ms`;
+const ALL_TIMEOUT = `traceroute to 10.0.0.99 (10.0.0.99), 5 hops max, 60 byte packets
+ 1  * * *
+ 2  * * *
+ 3  * * *`;
+describe('parseTracerouteOutput', () => {
+    it('parses Linux traceroute with mixed hops', () => {
+        const result = parseTracerouteOutput(LINUX_TRACEROUTE, '8.8.8.8');
+        expect(result.host).toBe('8.8.8.8');
+        expect(result.hops).toHaveLength(5);
+        // Hop 1: normal response
+        expect(result.hops[0]?.hop).toBe(1);
+        expect(result.hops[0]?.ip).toBe('192.168.1.1');
+        expect(result.hops[0]?.rttMs).toEqual([1.234, 1.1, 1.05]);
+        // Hop 3: all timeouts
+        expect(result.hops[2]?.hop).toBe(3);
+        expect(result.hops[2]?.ip).toBeNull();
+        expect(result.hops[2]?.rttMs).toEqual([null, null, null]);
+        // Hop 5: destination
+        expect(result.hops[4]?.hop).toBe(5);
+        expect(result.hops[4]?.ip).toBe('8.8.8.8');
+        expect(result.hops[4]?.rttMs).toEqual([20.123, 20.05, 19.9]);
+    });
+    it('parses macOS traceroute output', () => {
+        const result = parseTracerouteOutput(MACOS_TRACEROUTE, '1.1.1.1');
+        expect(result.host).toBe('1.1.1.1');
+        expect(result.hops).toHaveLength(3);
+        expect(result.hops[0]?.ip).toBe('192.168.0.1');
+        expect(result.hops[1]?.ip).toBeNull();
+        expect(result.hops[2]?.ip).toBe('1.1.1.1');
+    });
+    it('handles all-timeout output', () => {
+        const result = parseTracerouteOutput(ALL_TIMEOUT, '10.0.0.99');
+        expect(result.hops).toHaveLength(3);
+        for (const hop of result.hops) {
+            expect(hop.ip).toBeNull();
+            expect(hop.rttMs).toEqual([null, null, null]);
+        }
+    });
+    it('handles empty output', () => {
+        const result = parseTracerouteOutput('', '8.8.8.8');
+        expect(result.hops).toHaveLength(0);
+    });
+});
+describe('traceroute handler', () => {
+    it('throws when host is missing', async () => {
+        const mockExec = async () => '';
+        await expect(traceroute(undefined, mockExec)).rejects.toThrow('Missing required parameter: host');
+        await expect(traceroute({}, mockExec)).rejects.toThrow('Missing required parameter: host');
+    });
+    it('passes correct args with defaults', async () => {
+        const calls = [];
+        const mockExec = async (cmd, args) => {
+            calls.push({ cmd, args });
+            return LINUX_TRACEROUTE;
+        };
+        const result = (await traceroute({ host: '8.8.8.8' }, mockExec));
+        expect(calls).toHaveLength(1);
+        expect(calls[0]?.cmd).toBe('traceroute');
+        expect(calls[0]?.args).toEqual([
+            '-n', '-m', '30', '-w', '2', '8.8.8.8',
+        ]);
+        expect(result.host).toBe('8.8.8.8');
+        expect(result.hops).toHaveLength(5);
+    });
+    it('respects custom maxHops', async () => {
+        const calls = [];
+        const mockExec = async (cmd, args) => {
+            calls.push({ cmd, args });
+            return '';
+        };
+        await traceroute({ host: '8.8.8.8', maxHops: 10 }, mockExec);
+        expect(calls[0]?.args).toContain('10');
+    });
+    it('clamps maxHops to valid range', async () => {
+        const calls = [];
+        const mockExec = async (cmd, args) => {
+            calls.push({ cmd, args });
+            return '';
+        };
+        await traceroute({ host: '8.8.8.8', maxHops: 999 }, mockExec);
+        expect(calls[0]?.args).toContain('64');
+        await traceroute({ host: '8.8.8.8', maxHops: 0 }, mockExec);
+        expect(calls[1]?.args).toContain('1');
+    });
+});
+//# sourceMappingURL=traceroute.test.js.map

package/dist/system/probes/traceroute.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sonde/packs",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "private": false,
   "type": "module",
   "main": "dist/index.js",

package/src/index.ts

@@ -39,6 +39,15 @@ export { graphPack } from './integrations/graph.js';
 export { splunkPack } from './integrations/splunk.js';
 export { proxmoxPack } from './integrations/proxmox.js';
 export { nutanixPack } from './integrations/nutanix.js';
+export { vcenterPack } from './integrations/vcenter.js';
+export { datadogPack } from './integrations/datadog.js';
+export { lokiPack } from './integrations/loki.js';
+export { jiraPack } from './integrations/jira.js';
+export { pagerdutyPack } from './integrations/pagerduty.js';
+export { thousandeyesPack } from './integrations/thousandeyes.js';
+export { merakiPack } from './integrations/meraki.js';
+export { checkpointPack } from './integrations/checkpoint.js';
+export { a10Pack } from './integrations/a10.js';
 export { proxmoxDiagnosticRunbooks } from './runbooks/proxmox.js';
 export { nutanixDiagnosticRunbooks } from './runbooks/nutanix.js';