@sonde/packs 0.1.2 → 0.1.4

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.2",
+  "version": "0.1.4",
   "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';
 

package/src/integrations/a10.ts

@@ -0,0 +1,370 @@
+import type {
+  FetchFn,
+  IntegrationConfig,
+  IntegrationCredentials,
+  IntegrationPack,
+  IntegrationProbeHandler,
+} from '@sonde/shared';
+
+// --- Session-based auth ---
+
+/** Auth signature cache: signature + expiry timestamp */
+let cachedSession: { signature: string; expiresAt: number } | null = null;
+
+/** Acquire an A10 auth signature via POST /axapi/v3/auth */
+async function getSignature(
+  config: IntegrationConfig,
+  credentials: IntegrationCredentials,
+  fetchFn: FetchFn,
+): Promise<string> {
+  const now = Date.now();
+  if (cachedSession && cachedSession.expiresAt > now) {
+    return cachedSession.signature;
+  }
+
+  const { username, password } = credentials.credentials;
+  if (!username || !password) {
+    throw new Error('A10 Networks requires username and password credentials');
+  }
+
+  const url = `${config.endpoint.replace(/\/$/, '')}/axapi/v3/auth`;
+  const res = await fetchFn(url, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      ...config.headers,
+    },
+    body: JSON.stringify({ credentials: { username, password } }),
+  });
+
+  if (!res.ok) {
+    throw new Error(`A10 auth failed: ${res.status} ${res.statusText}`);
+  }
+
+  const data = (await res.json()) as {
+    authresponse?: { signature?: string };
+  };
+  const signature = data.authresponse?.signature;
+  if (!signature) {
+    throw new Error('A10 auth response missing signature');
+  }
+
+  cachedSession = { signature, expiresAt: now + 5 * 60 * 1000 };
+  return signature;
+}
+
+// --- REST helper ---
+
+async function a10Get<T>(
+  apiPath: string,
+  config: IntegrationConfig,
+  credentials: IntegrationCredentials,
+  fetchFn: FetchFn,
+  params?: Record<string, string>,
+): Promise<T> {
+  const signature = await getSignature(config, credentials, fetchFn);
+  const base = `${config.endpoint.replace(/\/$/, '')}/axapi/v3/${apiPath}`;
+  const url = new URL(base);
+  if (params) {
+    for (const [key, value] of Object.entries(params)) {
+      url.searchParams.set(key, value);
+    }
+  }
+
+  const headers: Record<string, string> = {
+    Accept: 'application/json',
+    Authorization: `A10 ${signature}`,
+    ...config.headers,
+  };
+
+  const res = await fetchFn(url.toString(), { headers });
+  if (!res.ok) {
+    throw new Error(`A10 API returned ${res.status}: ${res.statusText}`);
+  }
+  return (await res.json()) as T;
+}
+
+// --- Probe handlers ---
+
+const systemInfo: IntegrationProbeHandler = async (
+  _params,
+  config,
+  credentials,
+  fetchFn,
+) => {
+  const data = await a10Get<{
+    version?: {
+      oper?: {
+        'sw-version'?: string;
+        'serial-number'?: string;
+        'platform-name'?: string;
+        'up-time'?: string;
+      };
+    };
+  }>('version/oper', config, credentials, fetchFn);
+
+  const oper = data.version?.oper ?? {};
+  return {
+    version: oper['sw-version'] ?? null,
+    serialNumber: oper['serial-number'] ?? null,
+    platform: oper['platform-name'] ?? null,
+    uptime: oper['up-time'] ?? null,
+  };
+};
+
+const virtualServersList: IntegrationProbeHandler = async (
+  _params,
+  config,
+  credentials,
+  fetchFn,
+) => {
+  const data = await a10Get<{
+    'virtual-server-list'?: Array<{
+      name?: string;
+      'ip-address'?: string;
+      status?: string;
+      'port-list'?: Array<{
+        'port-number'?: number;
+        protocol?: string;
+        status?: string;
+      }>;
+    }>;
+  }>('slb/virtual-server', config, credentials, fetchFn);
+
+  const servers = (data['virtual-server-list'] ?? []).map((vs) => ({
+    name: vs.name ?? null,
+    ipAddress: vs['ip-address'] ?? null,
+    status: vs.status ?? null,
+    ports: (vs['port-list'] ?? []).map((p) => ({
+      portNumber: p['port-number'] ?? null,
+      protocol: p.protocol ?? null,
+      status: p.status ?? null,
+    })),
+  }));
+
+  return { virtualServers: servers, count: servers.length };
+};
+
+const virtualServerStats: IntegrationProbeHandler = async (
+  params,
+  config,
+  credentials,
+  fetchFn,
+) => {
+  const name = params?.name as string;
+  if (!name) throw new Error('name parameter is required (virtual server name)');
+
+  const data = await a10Get<{
+    'virtual-server'?: {
+      stats?: {
+        'curr-conn'?: number;
+        'total-conn'?: number;
+        'bytes-in'?: number;
+        'bytes-out'?: number;
+      };
+    };
+  }>(
+    `slb/virtual-server/${encodeURIComponent(name)}/stats`,
+    config,
+    credentials,
+    fetchFn,
+  );
+
+  const stats = data['virtual-server']?.stats ?? {};
+  return {
+    name,
+    currConn: stats['curr-conn'] ?? 0,
+    totalConn: stats['total-conn'] ?? 0,
+    bytesIn: stats['bytes-in'] ?? 0,
+    bytesOut: stats['bytes-out'] ?? 0,
+  };
+};
+
+const serviceGroupsList: IntegrationProbeHandler = async (
+  _params,
+  config,
+  credentials,
+  fetchFn,
+) => {
+  const data = await a10Get<{
+    'service-group-list'?: Array<{
+      name?: string;
+      protocol?: string;
+      'lb-method'?: string;
+      'member-list'?: Array<{
+        name?: string;
+        port?: number;
+        'member-state'?: string;
+      }>;
+    }>;
+  }>('slb/service-group', config, credentials, fetchFn);
+
+  const groups = (data['service-group-list'] ?? []).map((sg) => ({
+    name: sg.name ?? null,
+    protocol: sg.protocol ?? null,
+    lbMethod: sg['lb-method'] ?? null,
+    members: (sg['member-list'] ?? []).map((m) => ({
+      name: m.name ?? null,
+      port: m.port ?? null,
+      state: m['member-state'] ?? null,
+    })),
+  }));
+
+  return { serviceGroups: groups, count: groups.length };
+};
+
+const serversList: IntegrationProbeHandler = async (
+  _params,
+  config,
+  credentials,
+  fetchFn,
+) => {
+  const data = await a10Get<{
+    'server-list'?: Array<{
+      name?: string;
+      host?: string;
+      status?: string;
+      'port-list'?: Array<{
+        'port-number'?: number;
+        protocol?: string;
+        'health-check'?: string;
+        status?: string;
+      }>;
+    }>;
+  }>('slb/server', config, credentials, fetchFn);
+
+  const servers = (data['server-list'] ?? []).map((s) => ({
+    name: s.name ?? null,
+    host: s.host ?? null,
+    status: s.status ?? null,
+    ports: (s['port-list'] ?? []).map((p) => ({
+      portNumber: p['port-number'] ?? null,
+      protocol: p.protocol ?? null,
+      healthCheck: p['health-check'] ?? null,
+      status: p.status ?? null,
+    })),
+  }));
+
+  return { servers, count: servers.length };
+};
+
+const interfacesStats: IntegrationProbeHandler = async (
+  _params,
+  config,
+  credentials,
+  fetchFn,
+) => {
+  const data = await a10Get<{
+    ethernet?: {
+      oper?: {
+        'interface-list'?: Array<{
+          'port-num'?: number;
+          status?: string;
+          speed?: string;
+          'rx-pkts'?: number;
+          'tx-pkts'?: number;
+          'rx-errors'?: number;
+          'tx-errors'?: number;
+        }>;
+      };
+    };
+  }>('interface/ethernet/oper', config, credentials, fetchFn);
+
+  const interfaces = (data.ethernet?.oper?.['interface-list'] ?? []).map((iface) => ({
+    portNum: iface['port-num'] ?? null,
+    status: iface.status ?? null,
+    speed: iface.speed ?? null,
+    rxPackets: iface['rx-pkts'] ?? 0,
+    txPackets: iface['tx-pkts'] ?? 0,
+    rxErrors: iface['rx-errors'] ?? 0,
+    txErrors: iface['tx-errors'] ?? 0,
+  }));
+
+  return { interfaces, count: interfaces.length };
+};
+
+// --- Pack definition ---
+
+export const a10Pack: IntegrationPack = {
+  manifest: {
+    name: 'a10',
+    type: 'integration',
+    version: '0.1.0',
+    description:
+      'A10 Networks — virtual servers, service groups, real server health, and interface stats',
+    requires: { groups: [], files: [], commands: [] },
+    probes: [
+      {
+        name: 'system.info',
+        description: 'System version, serial number, platform, and uptime',
+        capability: 'observe',
+        params: {},
+        timeout: 15000,
+      },
+      {
+        name: 'virtual-servers.list',
+        description: 'List virtual servers (VIPs) with port and status info',
+        capability: 'observe',
+        params: {},
+        timeout: 15000,
+      },
+      {
+        name: 'virtual-server.stats',
+        description: 'Connection and throughput stats for a virtual server',
+        capability: 'observe',
+        params: {
+          name: {
+            type: 'string',
+            description: 'Virtual server name',
+            required: true,
+          },
+        },
+        timeout: 15000,
+      },
+      {
+        name: 'service-groups.list',
+        description: 'List service groups with members and health status',
+        capability: 'observe',
+        params: {},
+        timeout: 15000,
+      },
+      {
+        name: 'servers.list',
+        description: 'List real servers with port health checks',
+        capability: 'observe',
+        params: {},
+        timeout: 15000,
+      },
+      {
+        name: 'interfaces.stats',
+        description: 'Ethernet interface stats: packets, errors, speed, and status',
+        capability: 'observe',
+        params: {},
+        timeout: 15000,
+      },
+    ],
+    runbook: {
+      category: 'load-balancer',
+      probes: ['system.info', 'virtual-servers.list'],
+      parallel: true,
+    },
+  },
+
+  handlers: {
+    'system.info': systemInfo,
+    'virtual-servers.list': virtualServersList,
+    'virtual-server.stats': virtualServerStats,
+    'service-groups.list': serviceGroupsList,
+    'servers.list': serversList,
+    'interfaces.stats': interfacesStats,
+  },
+
+  testConnection: async (config, credentials, fetchFn) => {
+    try {
+      await getSignature(config, credentials, fetchFn);
+      return true;
+    } catch {
+      return false;
+    }
+  },
+};