@oneuptime/common 14.0.2 → 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/Rum/SessionTraceState.js

@@ -0,0 +1,154 @@
+/*
+ * The replay session id, carried on W3C trace context.
+ *
+ * The browser recorder adds one `tracestate` list member to the requests a
+ * page makes to its own origin:
+ *
+ *   tracestate: oneuptime=sid:<32 hex session id>[;p:<16 hex parent id>]
+ *
+ * tracestate is the one channel a stock OpenTelemetry backend carries
+ * without being told to. Every SDK's W3C propagator extracts it onto the
+ * remote parent, every child span inherits it, every OTLP exporter sends
+ * it as the span's `traceState`, and every outgoing call re-injects it. So
+ * span ingest can stamp Span.sessionId for every service a browser request
+ * touched, with no code in the customer's backend. (OTLP log records carry
+ * no trace state; logs are joined to a session by trace id instead.)
+ *
+ * `p` is present only when the recorder MINTED the traceparent. Its parent
+ * id then names a browser span that is never exported, so the backend's
+ * entry span would otherwise arrive pointing at a parent that does not
+ * exist: never a root span, flagged as missing its parent. Ingest treats a
+ * span whose parent is exactly `p` as the root it really is.
+ *
+ * Both halves live here so the recorder that writes the member and the
+ * ingest that reads it cannot drift. Standalone functions rather than
+ * class statics, because the recorder bundle tree-shakes unused exports
+ * but not unused statics - the recorder imports only the builder.
+ *
+ * Dependency-free: bundled into the browser recorder as well as imported
+ * by the server.
+ */
+/* The list-member key. A valid W3C tracestate simple key. */
+export const SESSION_TRACE_STATE_KEY = "oneuptime";
+/*
+ * Hostile-input bounds for the parser. W3C caps a well-formed header at 32
+ * members, and the OpenTelemetry JS SDK at 512 characters, but other SDKs
+ * only cap member count and member length, so a legitimate value carrying
+ * other vendors' members can be longer than 512. Past these a value is not
+ * one the recorder wrote, so no session is read out of it - but our
+ * members are still stripped from it.
+ */
+const MAX_TRACE_STATE_LENGTH = 8192;
+const MAX_TRACE_STATE_MEMBERS = 64;
+const SESSION_ID_PATTERN = /^[0-9a-f]{32}$/;
+const PARENT_SPAN_ID_PATTERN = /^[0-9a-f]{16}$/;
+const ALL_ZERO_PATTERN = /^0+$/;
+/*
+ * The tracestate list member for a session. Callers pass recorder-minted
+ * values (a 32-hex session id, a 16-hex parent id); nothing here needs
+ * escaping, because hex and the ':' / ';' separators are all legal in a
+ * tracestate value.
+ */
+export function buildSessionTraceStateMember(sessionId, syntheticParentSpanId) {
+    return (SESSION_TRACE_STATE_KEY +
+        "=sid:" +
+        sessionId +
+        (syntheticParentSpanId ? ";p:" + syntheticParentSpanId : ""));
+}
+/*
+ * Read the session member out of a span's trace state.
+ *
+ * Accepts anything, because the value comes from an OTLP body a customer
+ * (or anyone holding an ingestion key) controls: a non-string, an
+ * oversized string or a malformed member yields no session and never
+ * throws. The first `oneuptime` member wins, as in the W3C rule that a
+ * vendor's own member is the left-most one; fields inside it are
+ * `name:value` pairs separated by ';', in any order, and unknown fields are
+ * ignored so the format can grow.
+ */
+export function parseSessionTraceState(traceState) {
+    if (typeof traceState !== "string") {
+        return { sessionTraceState: null, remainingTraceState: "" };
+    }
+    /*
+     * Fast path, and the path almost every span takes: no member of ours,
+     * nothing to parse and nothing to strip.
+     */
+    if (traceState.indexOf(SESSION_TRACE_STATE_KEY) === -1) {
+        return { sessionTraceState: null, remainingTraceState: traceState };
+    }
+    const members = traceState.split(",");
+    /*
+     * Past the bounds nothing is READ as a session - a value this far out of
+     * spec is not one the recorder wrote - but our members are still
+     * stripped, so an id cannot survive in the raw trace state just because
+     * the value around it was oversized.
+     */
+    const isWithinBounds = traceState.length <= MAX_TRACE_STATE_LENGTH &&
+        members.length <= MAX_TRACE_STATE_MEMBERS;
+    let sessionTraceState = null;
+    let sawSessionMember = false;
+    const remaining = [];
+    for (const rawMember of members) {
+        const member = rawMember.trim();
+        if (member === "") {
+            continue;
+        }
+        const equalsIndex = member.indexOf("=");
+        const key = equalsIndex === -1 ? member : member.slice(0, equalsIndex).trim();
+        if (key !== SESSION_TRACE_STATE_KEY) {
+            remaining.push(member);
+            continue;
+        }
+        /*
+         * Every member under our key is stripped, parsed or not: a malformed
+         * one can still hold an id, and the point of stripping is that no id
+         * survives outside the sessionId column.
+         */
+        if (isWithinBounds && !sawSessionMember && equalsIndex !== -1) {
+            sessionTraceState = readSessionMemberValue(member.slice(equalsIndex + 1));
+        }
+        sawSessionMember = true;
+    }
+    return {
+        sessionTraceState: sessionTraceState,
+        remainingTraceState: remaining.join(","),
+    };
+}
+function readSessionMemberValue(value) {
+    let sessionId = null;
+    let syntheticParentSpanId = null;
+    for (const rawField of value.split(";")) {
+        const field = rawField.trim();
+        const colonIndex = field.indexOf(":");
+        if (colonIndex === -1) {
+            continue;
+        }
+        const name = field.slice(0, colonIndex);
+        const fieldValue = field.slice(colonIndex + 1).toLowerCase();
+        if (name === "sid" && sessionId === null) {
+            if (!SESSION_ID_PATTERN.test(fieldValue)) {
+                return null;
+            }
+            sessionId = fieldValue;
+        }
+        else if (name === "p" && syntheticParentSpanId === null) {
+            /*
+             * A malformed parent id costs only the root-span repair, never the
+             * session: the session id is what the member is for.
+             */
+            if (PARENT_SPAN_ID_PATTERN.test(fieldValue) &&
+                !ALL_ZERO_PATTERN.test(fieldValue)) {
+                syntheticParentSpanId = fieldValue;
+            }
+        }
+    }
+    if (sessionId === null || ALL_ZERO_PATTERN.test(sessionId)) {
+        return null;
+    }
+    return {
+        sessionId: sessionId,
+        syntheticParentSpanId: syntheticParentSpanId,
+    };
+}
+//# sourceMappingURL=SessionTraceState.js.map

package/build/dist/Utils/Rum/SessionTraceState.js.map

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