@oneuptime/common 14.0.3 → 14.0.5

package/build/dist/Utils/Monitor/PlatformResourceIdentity.js.map

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

package/build/dist/Utils/NetworkDiscovery/DiscoveredHostNamingDiagnosis.js

@@ -0,0 +1,270 @@
+import { DiscoveredHostNetbiosStatus, DiscoveredHostReverseDnsStatus, readDiscoveredHostNetbiosStatus, readDiscoveredHostReverseDnsStatus, } from "../../Types/NetworkDevice/DiscoveredHostNamingStatus";
+import { DiscoveryScanStatus } from "./DiscoveryScanStatus";
+import { isNetbiosQueryableIPv4Address, normalizeNetbiosName, } from "./NetbiosNameUtil";
+import { normalizeReverseDnsName } from "./ReverseDnsNameUtil";
+import { ScanModeUtil } from "./ScanModeUtil";
+export const UNNAMED_HOST_LABEL = "No name found";
+export const NOT_YET_NAMED_HOST_LABEL = "Not named yet";
+/*
+ * Said for a scan still sweeping. Names are looked up only after the sweep
+ * finishes (Probe/Jobs/Discovery/FetchScans.ts, scanWithDeadline), so every
+ * host a running scan has reported so far is unnamed by construction — the
+ * interesting question has not been asked yet.
+ */
+export const IN_PROGRESS_EXPLANATION = "Names are looked up after the sweep finishes, so hosts found so far are listed by address. Open Review Results again when the scan completes.";
+/*
+ * Said for a scan that failed. A sweep that misses its deadline or throws is
+ * reported without ever reaching the naming passes, so its hosts are the ones
+ * it had uploaded along the way — which carry no names by design.
+ */
+export const FAILED_SCAN_EXPLANATION = "This scan stopped before it looked up names, so its hosts are listed by address. Run it again to name them.";
+/*
+ * One sentence per code. None of them says how many times the probe asked:
+ * a retry has to fit in the naming pass's time budget, so "even on a retry"
+ * could be false for exactly the hosts a slow DNS server pushed past the
+ * deadline. The tip that follows these codes says to rescan, which is the
+ * part the operator can act on.
+ */
+const REVERSE_DNS_SENTENCES = {
+    [DiscoveredHostReverseDnsStatus.NoRecord]: "Reverse DNS: the probe's DNS server has no PTR record for this address.",
+    [DiscoveredHostReverseDnsStatus.UnusableName]: "Reverse DNS: a PTR record came back, but it is not a valid hostname, so it was not used.",
+    [DiscoveredHostReverseDnsStatus.Timeout]: "Reverse DNS: the probe's DNS server did not answer in time.",
+    [DiscoveredHostReverseDnsStatus.ServerFailure]: "Reverse DNS: the probe's DNS server answered with a server failure (SERVFAIL).",
+    [DiscoveredHostReverseDnsStatus.Refused]: "Reverse DNS: the probe's DNS server refused the query.",
+    [DiscoveredHostReverseDnsStatus.Unreachable]: "Reverse DNS: the probe could not reach its DNS server.",
+    [DiscoveredHostReverseDnsStatus.Failed]: "Reverse DNS: the lookup failed on the probe.",
+    [DiscoveredHostReverseDnsStatus.SkippedTimeBudget]: "Reverse DNS: not looked up. The scan ran out of time for name lookups before reaching this address.",
+    [DiscoveredHostReverseDnsStatus.SkippedNoResolver]: "Reverse DNS: not looked up. The probe's DNS server was not answering, so it stopped asking.",
+};
+/*
+ * A row with no reverse-DNS code: stored by a probe older than the codes, or
+ * by one whose pass failed outright. Nothing on the row says which, or why,
+ * so this claims neither.
+ */
+export const REVERSE_DNS_NOT_RECORDED_SENTENCE = "Reverse DNS: no name was recorded for this address.";
+const NETBIOS_SENTENCES = {
+    [DiscoveredHostNetbiosStatus.NoReply]: "NetBIOS: no reply on UDP 137, which is usual for devices that are not Windows, or when a firewall blocks it.",
+    [DiscoveredHostNetbiosStatus.NoUsableName]: "NetBIOS: the device replied, but reported no usable name.",
+    [DiscoveredHostNetbiosStatus.SendFailed]: "NetBIOS: the query could not be sent from the probe.",
+    [DiscoveredHostNetbiosStatus.Skipped]: "NetBIOS: not asked. The lookup stopped before reaching this address.",
+    [DiscoveredHostNetbiosStatus.SkippedHostCap]: "NetBIOS: not asked. The scan reached the probe's NetBIOS host limit.",
+    [DiscoveredHostNetbiosStatus.SkippedIneligibleAddress]: "NetBIOS: not asked. Only private addresses are asked.",
+    [DiscoveredHostNetbiosStatus.SkippedGlobalProbe]: "NetBIOS: not asked. This scan ran on a global probe, and global probes never send NetBIOS queries.",
+};
+export const NETBIOS_OFF_SENTENCE = "NetBIOS: off for this scan.";
+// NetBIOS was on, and yet the row carries no code: an older probe's row.
+export const NETBIOS_NOT_RECORDED_SENTENCE = "NetBIOS: no name was recorded.";
+export const SNMP_NOT_CHECKED_SENTENCE = "SNMP: not checked by this scan.";
+export const SNMP_NO_ANSWER_SENTENCE = "SNMP: no answer with this scan's credentials.";
+export const SNMP_NO_SYSNAME_SENTENCE = "SNMP: the device answered, but reported no name (sysName).";
+/*
+ * The one piece of advice that fits the reverse-DNS code best, when any
+ * does. "No record" gets the one that matters most for the issue this came
+ * from: the probe resolves through ITS OWN DNS server, which need not be the
+ * one the operator checked with, so the comparison worth making is from where
+ * the probe resolves. That is inside its container or pod, not the machine
+ * under it (#3916): a pod's resolver is the cluster DNS, not the node's
+ * /etc/resolv.conf, and a Docker container's can differ from its host's too,
+ * so "from the probe's host" sent the operator to a lookup that could name
+ * the device while the probe's could not. The probe image ships nslookup
+ * (dnsutils, Probe/Dockerfile.tpl), so the advice can be followed as written.
+ */
+export const NO_RECORD_TIP = "The probe uses its own DNS server, which may not be the one you checked with. Run nslookup on this address inside the probe's container or pod to compare.";
+export const TRANSIENT_FAILURE_TIP = "Rescan to try again. If it keeps happening, check the DNS servers the probe uses, inside its container or pod.";
+/*
+ * Offered when the scan left one or both of the ways of asking the DEVICE for
+ * its name switched off. Those are exactly the names the issue asked to see
+ * first — the one configured on the device — so saying where they come from
+ * is the useful answer to "but it has a hostname". Only the sources that were
+ * actually off, and would run if turned on, are named — for NetBIOS that
+ * means the probe is not a global one AND the address is one its lookup
+ * would query at all (isNetbiosQueryableIPv4Address).
+ */
+export const ASK_THE_DEVICE_TIP = "Checking SNMP, or NetBIOS lookup for Windows hosts, asks the device for its own name.";
+export const ASK_THE_DEVICE_SNMP_TIP = "Checking SNMP asks the device for its own name.";
+export const ASK_THE_DEVICE_NETBIOS_TIP = "NetBIOS lookup asks Windows hosts for their own name.";
+/*
+ * The codes that get TRANSIENT_FAILURE_TIP: the lookup failed rather than
+ * answered, so a rescan may name the host, and the DNS servers the probe's
+ * host uses are where to look when it does not.
+ *
+ * SkippedNoResolver is one of them although its address was never looked up
+ * (#3916). The probe stopped asking only because every lookup before it had
+ * failed in these same ways, so the advice is the same. Without it, the hosts
+ * a pass gave up on were the only failed lookups with nothing to check.
+ */
+const TRANSIENT_REVERSE_DNS_STATUSES = new Set([
+    DiscoveredHostReverseDnsStatus.Timeout,
+    DiscoveredHostReverseDnsStatus.ServerFailure,
+    DiscoveredHostReverseDnsStatus.Refused,
+    DiscoveredHostReverseDnsStatus.Unreachable,
+    DiscoveredHostReverseDnsStatus.Failed,
+    DiscoveredHostReverseDnsStatus.SkippedNoResolver,
+]);
+// A string with something in it besides whitespace.
+function hasText(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+/**
+ * True when the row would be named by something other than its address: a
+ * sysName, a usable PTR name or a usable NetBIOS name. Mirrors
+ * getDiscoveredHostFullName's order and its re-normalisation, so the hint is
+ * shown on exactly the rows whose name line is the address.
+ */
+export function isDiscoveredHostNamed(host) {
+    return (hasText(host.sysName) ||
+        Boolean(normalizeReverseDnsName(host.dnsHostname)) ||
+        Boolean(normalizeNetbiosName(host.netbiosName)));
+}
+function describeSnmp(data) {
+    if (data.scan && !ScanModeUtil.isSnmpEnabled(data.scan)) {
+        return SNMP_NOT_CHECKED_SENTENCE;
+    }
+    if (data.host.snmpReachable === false) {
+        return SNMP_NO_ANSWER_SENTENCE;
+    }
+    /*
+     * Answered SNMP — or a row from before `snmpReachable` existed, when every
+     * host listed had answered it. Either way the host is unnamed, so whatever
+     * it said had no sysName in it.
+     */
+    if (data.scan || data.host.snmpReachable === true) {
+        return SNMP_NO_SYSNAME_SENTENCE;
+    }
+    return undefined;
+}
+function describeNetbios(data) {
+    if (data.status) {
+        return NETBIOS_SENTENCES[data.status];
+    }
+    // Without the scan there is no telling whether NetBIOS was ever on.
+    if (!data.scan) {
+        return undefined;
+    }
+    if (data.scan.isNetbiosLookupEnabled !== true) {
+        return NETBIOS_OFF_SENTENCE;
+    }
+    /*
+     * On, but no code: a row from a probe older than the codes. If the scan's
+     * probe is a global one, the lookup was skipped whatever that probe's
+     * version — the global-probe refusal predates the codes.
+     */
+    if (data.isGlobalProbe) {
+        return NETBIOS_SENTENCES[DiscoveredHostNetbiosStatus.SkippedGlobalProbe];
+    }
+    /*
+     * Likewise for an address outside the private and CGNAT ranges (#3916):
+     * the probe's refusal of those shipped in the same change as the
+     * isNetbiosLookupEnabled column, so no probe that honoured the setting
+     * ever asked one.
+     */
+    if (!data.isQueryableAddress) {
+        return NETBIOS_SENTENCES[DiscoveredHostNetbiosStatus.SkippedIneligibleAddress];
+    }
+    return NETBIOS_NOT_RECORDED_SENTENCE;
+}
+/**
+ * Why this discovered host has no name, or undefined when it has one (or has
+ * no address, which its row already explains).
+ *
+ * `isGlobalProbe` is whether the scan's probe is a global one, when the
+ * caller knows. It matters only for rows that carry no NetBIOS code, and for
+ * whether a scan with NetBIOS off is advised to turn it on.
+ */
+export function explainUnnamedDiscoveredHost(data) {
+    var _a, _b;
+    const host = data.host;
+    if (!host || typeof host !== "object") {
+        return undefined;
+    }
+    /*
+     * A row with no address cannot be imported, and says so on its checkbox.
+     * Nullish is checked before stringifying: String(null) is "null", which
+     * would read as an address.
+     */
+    if (host.ipAddress === undefined ||
+        host.ipAddress === null ||
+        !hasText(String(host.ipAddress))) {
+        return undefined;
+    }
+    if (isDiscoveredHostNamed(host)) {
+        return undefined;
+    }
+    const dnsHostnameStatus = readDiscoveredHostReverseDnsStatus(host.dnsHostnameStatus);
+    const netbiosNameStatus = readDiscoveredHostNetbiosStatus(host.netbiosNameStatus);
+    /*
+     * A per-host code means the naming passes ran for this row, whatever the
+     * scan is doing now — a recurring scan keeps its previous run's results
+     * while the next run starts. Only a row with no code at all is explained by
+     * the scan's state.
+     */
+    if (!dnsHostnameStatus && !netbiosNameStatus) {
+        if (((_a = data.scan) === null || _a === void 0 ? void 0 : _a.status) === DiscoveryScanStatus.InProgress) {
+            return {
+                label: NOT_YET_NAMED_HOST_LABEL,
+                text: IN_PROGRESS_EXPLANATION,
+            };
+        }
+        if (((_b = data.scan) === null || _b === void 0 ? void 0 : _b.status) === DiscoveryScanStatus.Failed) {
+            return { label: UNNAMED_HOST_LABEL, text: FAILED_SCAN_EXPLANATION };
+        }
+    }
+    /*
+     * Whether the probe's NetBIOS lookup would send this address a query at
+     * all. It refuses everything but private and CGNAT IPv4, whoever asks.
+     */
+    const isNetbiosQueryableAddress = isNetbiosQueryableIPv4Address(host.ipAddress);
+    const netbiosSentence = describeNetbios({
+        status: netbiosNameStatus,
+        scan: data.scan,
+        isGlobalProbe: data.isGlobalProbe === true,
+        isQueryableAddress: isNetbiosQueryableAddress,
+    });
+    const sentences = [];
+    // The naming order, so the sentences read in the order the sources win.
+    const snmpSentence = describeSnmp({
+        host: host,
+        scan: data.scan,
+    });
+    if (snmpSentence) {
+        sentences.push(snmpSentence);
+    }
+    sentences.push(dnsHostnameStatus
+        ? REVERSE_DNS_SENTENCES[dnsHostnameStatus]
+        : REVERSE_DNS_NOT_RECORDED_SENTENCE);
+    if (netbiosSentence) {
+        sentences.push(netbiosSentence);
+    }
+    if (dnsHostnameStatus === DiscoveredHostReverseDnsStatus.NoRecord) {
+        sentences.push(NO_RECORD_TIP);
+    }
+    else if (dnsHostnameStatus &&
+        TRANSIENT_REVERSE_DNS_STATUSES.has(dnsHostnameStatus)) {
+        sentences.push(TRANSIENT_FAILURE_TIP);
+    }
+    const isSnmpOff = snmpSentence === SNMP_NOT_CHECKED_SENTENCE;
+    /*
+     * NetBIOS is suggested only where turning it on could work. A global probe
+     * never sends NetBIOS queries whatever the scan asks for, so on one this
+     * advice would send the operator to a setting whose only effect is the
+     * "not asked" line on the next scan (#3916). The bundled self-hosted probes
+     * are global, so that is not a rare case. The same goes for an address the
+     * lookup refuses — public space, IPv6, anything not a strict dotted quad —
+     * where the next scan would only say "Only private addresses are asked".
+     */
+    const shouldSuggestNetbios = netbiosSentence === NETBIOS_OFF_SENTENCE &&
+        data.isGlobalProbe !== true &&
+        isNetbiosQueryableAddress;
+    if (isSnmpOff && shouldSuggestNetbios) {
+        sentences.push(ASK_THE_DEVICE_TIP);
+    }
+    else if (isSnmpOff) {
+        sentences.push(ASK_THE_DEVICE_SNMP_TIP);
+    }
+    else if (shouldSuggestNetbios) {
+        sentences.push(ASK_THE_DEVICE_NETBIOS_TIP);
+    }
+    return { label: UNNAMED_HOST_LABEL, text: sentences.join(" ") };
+}
+export default explainUnnamedDiscoveredHost;
+//# sourceMappingURL=DiscoveredHostNamingDiagnosis.js.map

package/build/dist/Utils/NetworkDiscovery/DiscoveredHostNamingDiagnosis.js.map

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

package/build/dist/Utils/NetworkDiscovery/DiscoveredHostUtil.js

@@ -1,3 +1,4 @@
+import { readDiscoveredHostNetbiosStatus, readDiscoveredHostReverseDnsStatus, } from "../../Types/NetworkDevice/DiscoveredHostNamingStatus";
 import { normalizeNetbiosName } from "./NetbiosNameUtil";
 import { normalizeReverseDnsName } from "./ReverseDnsNameUtil";
 /*
@@ -121,6 +122,28 @@ export function normalizeDiscoveredHosts(hosts) {
         else {
             delete normalized.netbiosName;
         }
+        /*
+         * The two "why is this host unnamed" codes (OneUptime issue #3916). Not
+         * chosen by the scanned network, but still read out of the same verbatim
+         * jsonb, and the dialog turns them into tooltip copy — so only the exact
+         * codes survive, and anything else is DELETED for the reason the names
+         * above are. A code this build does not know (a newer probe's) goes the
+         * same way and the row falls back to the explanation older rows get.
+         */
+        const dnsHostnameStatus = readDiscoveredHostReverseDnsStatus(host.dnsHostnameStatus);
+        if (dnsHostnameStatus) {
+            normalized.dnsHostnameStatus = dnsHostnameStatus;
+        }
+        else {
+            delete normalized.dnsHostnameStatus;
+        }
+        const netbiosNameStatus = readDiscoveredHostNetbiosStatus(host.netbiosNameStatus);
+        if (netbiosNameStatus) {
+            normalized.netbiosNameStatus = netbiosNameStatus;
+        }
+        else {
+            delete normalized.netbiosNameStatus;
+        }
         cleaned.push(normalized);
     }
     // An address the scan reports as registered is registered on every row.

package/build/dist/Utils/NetworkDiscovery/DiscoveredHostUtil.js.map

@@ -1 +1 @@
-{"version":3,"file":"DiscoveredHostUtil.js","sourceRoot":"","sources":["../../../../Utils/NetworkDiscovery/DiscoveredHostUtil.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D;;;;;;;GAOG;AAEH;;;GAGG;AACH,SAAS,sBAAsB,CAC7B,IAAa;IAEb,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC;AACnD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAqC;IAErC,MAAM,OAAO,GAAmC,EAAE,CAAC;IAEnD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,SAAS;QACX,CAAC;QAED;;;;WAIG;QACH,MAAM,UAAU,mCACX,IAAI,KACP,SAAS,EACP,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI;gBACrD,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,GACpC,CAAC;QAEF;;;;;;;;;;;;;;;;;;;WAmBG;QACH,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACnE,UAAU,CAAC,OAAO,GAAG,EAAE,CAAC;QAC1B,CAAC;QAED;;;;;;;;;WASG;QACH,MAAM,WAAW,GAAuB,uBAAuB,CAC7D,IAAI,CAAC,WAAW,CACjB,CAAC;QAEF,IAAI,WAAW,EAAE,CAAC;YAChB,UAAU,CAAC,WAAW,GAAG,WAAW,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,OAAO,UAAU,CAAC,WAAW,CAAC;QAChC,CAAC;QAED;;;;;;;;;;WAUG;QACH,MAAM,WAAW,GAAuB,oBAAoB,CAC1D,IAAI,CAAC,WAAW,CACjB,CAAC;QAEF,IAAI,WAAW,EAAE,CAAC;YAChB,UAAU,CAAC,WAAW,GAAG,WAAW,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,OAAO,UAAU,CAAC,WAAW,CAAC;QAChC,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;IAED,wEAAwE;IACxE,MAAM,qBAAqB,GAAgB,IAAI,GAAG,EAAU,CAAC;IAE7D,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC/C,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,IAAI,qBAAqB,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAA6B,EAAE,EAAE;QACnD,IACE,IAAI,CAAC,mBAAmB;YACxB,CAAC,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAC1C,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,uCAAY,IAAI,KAAE,mBAAmB,EAAE,IAAI,IAAG;IAChD,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"DiscoveredHostUtil.js","sourceRoot":"","sources":["../../../../Utils/NetworkDiscovery/DiscoveredHostUtil.ts"],"names":[],"mappings":"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"}

package/build/dist/Utils/NetworkDiscovery/NetbiosNameUtil.js

@@ -125,5 +125,66 @@ export function normalizeNetbiosName(value) {
     }
     return lowerCased;
 }
+/*
+ * One octet of a dotted quad in the only spelling the probe's sweep reports:
+ * ASCII digits, no leading zero. The 0-255 bound is checked on the number.
+ */
+const IPV4_OCTET_PATTERN = /^(?:0|[1-9][0-9]{0,2})$/;
+/**
+ * True exactly for the addresses the probe's NetBIOS lookup would send a
+ * query to: a strict dotted-quad IPv4 literal in 10.0.0.0/8, 172.16.0.0/12,
+ * 192.168.0.0/16 or the 100.64.0.0/10 CGNAT range (OneUptime issue #3916).
+ *
+ * The probe's own rule is isNetbiosQueryAddressAllowed
+ * (Probe/Utils/Discovery/NetbiosNameResolver.ts), which refuses every other
+ * address whoever asks. This is the dashboard's copy of it, for the Review
+ * dialog: an unnamed host on a scan with NetBIOS off used to be told that
+ * "NetBIOS lookup asks Windows hosts for their own name" whatever its
+ * address, so an operator scanning public space turned NetBIOS on, rescanned,
+ * and got "not asked. Only private addresses are asked." — advice whose only
+ * effect was a different way of saying no name.
+ *
+ * A copy rather than an import, because Common is bundled into the dashboard
+ * and the probe's rule leans on Node's `net.isIPv4`. The strict form below is
+ * what `net.isIPv4` accepts (no leading zeros, no whitespace, no IPv6 or
+ * IPv4-mapped IPv6). The probe's NetbiosEligibilityParity test holds the two
+ * to the same answer on every range edge, on a sweep of every first and
+ * second octet, and on the malformed spellings, so changing one without the
+ * other fails it.
+ *
+ * `unknown`, like normalizeNetbiosName, because the dashboard reads the
+ * address out of jsonb.
+ */
+export function isNetbiosQueryableIPv4Address(value) {
+    if (typeof value !== "string") {
+        return false;
+    }
+    const parts = value.split(".");
+    if (parts.length !== 4) {
+        return false;
+    }
+    const octets = [];
+    for (const part of parts) {
+        if (!IPV4_OCTET_PATTERN.test(part)) {
+            return false;
+        }
+        const octet = parseInt(part, 10);
+        if (octet > 255) {
+            return false;
+        }
+        octets.push(octet);
+    }
+    const first = octets[0];
+    const second = octets[1];
+    return (
+    // 10.0.0.0/8, RFC 1918.
+    first === 10 ||
+        // 172.16.0.0/12, RFC 1918: second octet 16-31.
+        (first === 172 && second >= 16 && second <= 31) ||
+        // 192.168.0.0/16, RFC 1918.
+        (first === 192 && second === 168) ||
+        // 100.64.0.0/10, RFC 6598 shared/CGNAT space: second octet 64-127.
+        (first === 100 && second >= 64 && second <= 127));
+}
 export default normalizeNetbiosName;
 //# sourceMappingURL=NetbiosNameUtil.js.map

package/build/dist/Utils/NetworkDiscovery/NetbiosNameUtil.js.map

@@ -1 +1 @@
-{"version":3,"file":"NetbiosNameUtil.js","sourceRoot":"","sources":["../../../../Utils/NetworkDiscovery/NetbiosNameUtil.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAW,EAAE,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,4BAA4B,GAAW,cAAc,CAAC;AAE5D,uEAAuE;AACvE,MAAM,cAAc,GAAW,UAAU,CAAC;AAE1C;;;;;;;;GAQG;AACH,SAAS,iBAAiB,CAAC,SAAiB;IAC1C,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,SAAS,oBAAoB,CAAC,KAAa;IACzC,IAAI,GAAG,GAAW,KAAK,CAAC,MAAM,CAAC;IAE/B,OAAO,GAAG,GAAG,CAAC,IAAI,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,EAAE,CAAC;IACR,CAAC;IAED,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAW,oBAAoB,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAE7D,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,uBAAuB,EAAE,CAAC;QAC7D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,IAAI,uBAAuB,CAAC,SAAS,CAAC,KAAK,SAAS,EAAE,CAAC;QACrD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAAW,SAAS,CAAC,WAAW,EAAE,CAAC;IAEnD,IAAI,UAAU,KAAK,4BAA4B,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"NetbiosNameUtil.js","sourceRoot":"","sources":["../../../../Utils/NetworkDiscovery/NetbiosNameUtil.ts"],"names":[],"mappings":"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"}

package/build/dist/Utils/Telemetry/DatabaseServerEntityKeys.js

@@ -0,0 +1,178 @@
+import { keyForDatabaseEndpoint, keyForDatabaseServerRow } from "./EntityKey";
+import { parseDatabaseEndpointString, } from "../../Types/DatabaseServer/DatabaseEndpoint";
+export const DEFAULT_MEMBER_KEY_MAX_AGE_DAYS = 30;
+export const DEFAULT_MEMBER_KEY_MAX_COUNT = 200;
+export const MAX_DATABASE_SERVER_ENTITY_KEYS = 200;
+const ENTITY_KEY_REGEX = /^[0-9a-f]{16}$/;
+const DAY_IN_MS = 24 * 60 * 60 * 1000;
+function normalizeEntityKey(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const key = value.trim().toLowerCase();
+    return ENTITY_KEY_REGEX.test(key) ? key : null;
+}
+function toTimestamp(value) {
+    if (typeof value !== "string" && !(value instanceof Date)) {
+        return null;
+    }
+    const time = value instanceof Date ? value.getTime() : Date.parse(value);
+    return Number.isFinite(time) ? time : null;
+}
+/*
+ * Read a stored member-key value leniently: the canonical `{ key: iso }`
+ * map, or an array of `{ key, lastSeenAt }` entries (plus, when
+ * `acceptBareKeys`, bare key strings, treated as oldest). Anything malformed
+ * is skipped, never thrown on — the column is JSON written by a worker.
+ */
+function readMemberKeys(value, acceptBareKeys = false) {
+    const entries = new Map();
+    const add = (rawKey, rawTime) => {
+        const key = normalizeEntityKey(rawKey);
+        const time = toTimestamp(rawTime);
+        if (key === null || time === null) {
+            return;
+        }
+        const existing = entries.get(key);
+        if (existing === undefined || time > existing) {
+            entries.set(key, time);
+        }
+    };
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            if (acceptBareKeys && typeof item === "string") {
+                add(item, new Date(0));
+            }
+            else if (item && typeof item === "object") {
+                add(item.key, item.lastSeenAt);
+            }
+        }
+        return entries;
+    }
+    if (value && typeof value === "object") {
+        for (const rawKey of Object.keys(value)) {
+            add(rawKey, value[rawKey]);
+        }
+    }
+    return entries;
+}
+// Most recent first; ties broken by key so the order is stable.
+function sortByRecency(entries) {
+    return Array.from(entries.entries())
+        .map(([key, time]) => {
+        return { key, time };
+    })
+        .sort((a, b) => {
+        if (b.time !== a.time) {
+            return b.time - a.time;
+        }
+        if (a.key < b.key) {
+            return -1;
+        }
+        return a.key > b.key ? 1 : 0;
+    });
+}
+/**
+ * Merge the member keys seen this run into the stored set: seen keys are
+ * stamped `now`, older ones are kept until they have not been seen for
+ * `maxAgeDays` (default 30 — a restarted pod's logs stay on the page), and
+ * the set is capped at `max` (default 200) by recency. Timestamps in the
+ * future are clamped to `now`. Never throws.
+ */
+export function mergeDatabaseServerMemberKeys(existing, seenNow, now, opts) {
+    const nowTime = now instanceof Date && Number.isFinite(now.getTime())
+        ? now.getTime()
+        : Date.now();
+    const maxAgeDays = typeof (opts === null || opts === void 0 ? void 0 : opts.maxAgeDays) === "number" && opts.maxAgeDays > 0
+        ? opts.maxAgeDays
+        : DEFAULT_MEMBER_KEY_MAX_AGE_DAYS;
+    const max = typeof (opts === null || opts === void 0 ? void 0 : opts.max) === "number" && opts.max >= 1
+        ? Math.floor(opts.max)
+        : DEFAULT_MEMBER_KEY_MAX_COUNT;
+    const entries = readMemberKeys(existing);
+    for (const [key, time] of entries) {
+        if (time > nowTime) {
+            entries.set(key, nowTime);
+        }
+    }
+    for (const raw of Array.isArray(seenNow) ? seenNow : []) {
+        const key = normalizeEntityKey(raw);
+        if (key !== null) {
+            entries.set(key, nowTime);
+        }
+    }
+    const cutoff = nowTime - maxAgeDays * DAY_IN_MS;
+    const merged = {};
+    let count = 0;
+    for (const entry of sortByRecency(entries)) {
+        if (entry.time < cutoff) {
+            continue;
+        }
+        if (count >= max) {
+            break;
+        }
+        merged[entry.key] = new Date(entry.time).toISOString();
+        count++;
+    }
+    return merged;
+}
+/*
+ * A row id as text: a string or anything with a string form (an ObjectID),
+ * trimmed; "" when there is none.
+ */
+function databaseServerIdText(value) {
+    if (typeof value === "string") {
+        return value.trim();
+    }
+    if (value && typeof value === "object") {
+        const text = value.toString();
+        return typeof text === "string" && text !== "[object Object]"
+            ? text.trim()
+            : "";
+    }
+    return "";
+}
+/**
+ * Every entity key that belongs to a DatabaseServer: its row key (when the
+ * row's id is given), then the `database.server` key of each parseable
+ * stored endpoint (engine default port applied, as ingest does), then its
+ * member keys (valid 16-hex keys only, most recent first). Deduped, stable,
+ * capped at 200 with the row key first and endpoint keys next, so a large
+ * member set never evicts either.
+ *
+ * An empty result means "nothing to query" — callers must NEVER turn it into
+ * an empty `Includes` (that drops the predicate and scopes to the whole
+ * project).
+ */
+export function getDatabaseServerSignalEntityKeys(input) {
+    const projectId = input && typeof input.projectId === "string" ? input.projectId.trim() : "";
+    if (!projectId) {
+        return [];
+    }
+    const keys = [];
+    const seen = new Set();
+    const push = (key) => {
+        if (keys.length < MAX_DATABASE_SERVER_ENTITY_KEYS && !seen.has(key)) {
+            seen.add(key);
+            keys.push(key);
+        }
+    };
+    const databaseServerId = databaseServerIdText(input.databaseServerId);
+    if (databaseServerId) {
+        push(keyForDatabaseServerRow(projectId, databaseServerId));
+    }
+    for (const item of Array.isArray(input.endpoints) ? input.endpoints : []) {
+        const value = item && typeof item === "object"
+            ? item.endpoint
+            : item;
+        const endpoint = parseDatabaseEndpointString(value, { system: input.dbSystem || "" });
+        if (endpoint) {
+            push(keyForDatabaseEndpoint(projectId, endpoint));
+        }
+    }
+    for (const entry of sortByRecency(readMemberKeys(input.memberEntityKeys, true))) {
+        push(entry.key);
+    }
+    return keys;
+}
+//# sourceMappingURL=DatabaseServerEntityKeys.js.map

package/build/dist/Utils/Telemetry/DatabaseServerEntityKeys.js.map

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