@oneuptime/common 12.0.25 → 12.0.26

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

@@ -0,0 +1,560 @@
+import ColumnLength from "../../Types/Database/ColumnLength";
+import ObjectID from "../../Types/ObjectID";
+import SnmpAuthProtocol, { SnmpAuthProtocolUtil, } from "../../Types/Monitor/SnmpMonitor/SnmpAuthProtocol";
+import SnmpPrivProtocol, { SnmpPrivProtocolUtil, } from "../../Types/Monitor/SnmpMonitor/SnmpPrivProtocol";
+import SnmpSecurityLevel, { SnmpSecurityLevelUtil, } from "../../Types/Monitor/SnmpMonitor/SnmpSecurityLevel";
+import SnmpVersion, { SnmpVersionUtil, } from "../../Types/Monitor/SnmpMonitor/SnmpVersion";
+/*
+ * The id given to the single config synthesized from a scan's flattened
+ * columns — every scan created before `snmpConfigs` existed, and every scan
+ * written by an API caller that only knows the old fields.
+ *
+ * A literal rather than a minted ObjectID because it has to be STABLE across
+ * calls: the probe stamps it onto each discovered host, and the import path
+ * looks it up again in a separately resolved list, in a different process,
+ * possibly days later.
+ */
+export const LEGACY_SNMP_CONFIG_ID = "legacy";
+/*
+ * How many credential sets one scan may carry.
+ *
+ * WHAT AN EXTRA SET COSTS
+ *
+ * The sweep tries sets in order and stops at the first that answers, so a host
+ * that ANSWERS costs what it always did. A host that answers nothing costs one
+ * full SNMP timeout per set, and the arithmetic for a whole range is
+ *
+ *   hosts x sets x 2s timeout / 32 concurrent probes
+ *
+ * WHICH DOES NOT FIT THE MAXIMUM TARGET, AND DID NOT BEFORE THIS EXISTED
+ *
+ * ScanTargetUtil.MAX_SCAN_HOSTS is 32,768, so a full-range sweep costs ~34
+ * minutes per set: about 34 minutes at one set, 68 at two, and past the
+ * probe's PROBE_DISCOVERY_SCAN_TIMEOUT_IN_MS deadline (90 minutes) at three.
+ * Ten sets would be some 5.7 hours. This ceiling therefore CANNOT be chosen to
+ * make the worst case fit — a single-credential scan of a maximum target
+ * already sits inside a factor of three of the deadline, and always has.
+ *
+ * WHAT ACTUALLY BOUNDS IT
+ *
+ * The ICMP pre-sweep. Only hosts that answered ping are SNMP-probed, so the
+ * realistic cost is proportional to LIVE hosts, not to the size of the range —
+ * and a 32,768-address range with a few hundred live hosts costs seconds per
+ * set. Exactly two paths pay the full-range price: a probe that cannot send
+ * ICMP at all (no ping binary, no NET_RAW), and the phase-3 fallback, which
+ * re-probes every ICMP-silent address when NO set answered anything. Both are
+ * already unusual, and the second is itself the "your credentials are wrong"
+ * case this feature exists to fix.
+ *
+ * When a sweep does cross the deadline the probe abandons it and reports the
+ * scan Failed with a sentence telling the operator to narrow the target — so
+ * the failure is loud and actionable rather than silent. This ceiling is the
+ * cheaper guard in front of that: ten is far more than any real segment needs
+ * (three or four is the shape of a mixed subnet), and the validation message
+ * below says what to do instead of a longer list.
+ */
+export const MAX_SNMP_CONFIGS_PER_SCAN = 10;
+/*
+ * Matches NetworkDeviceDiscoveryScan.name, which is a ShortText column, for
+ * the same reason ScanNameUtil bounds that one: these names are rendered on a
+ * single line in a card header and inlined into the probe's log messages. The
+ * value itself lives inside a jsonb column with no length of its own, so
+ * nothing downstream would reject an essay — which is exactly why it is
+ * bounded here.
+ */
+export const MAX_SNMP_CONFIG_NAME_LENGTH = ColumnLength.ShortText;
+/*
+ * The credential fields are bounded to the columns they are MIRRORED INTO, not
+ * to the jsonb column they live in.
+ *
+ * A jsonb value has no length of its own, so nothing downstream would reject a
+ * novel typed into a community string — but the first config of every list is
+ * copied onto the flattened columns for probes that predate the list
+ * (getMirroredLegacyColumns), and those are a varchar(100) and a varchar(500).
+ * Postgres does not truncate an over-long value there, it throws, so without
+ * this the save failed on the WRITE with an error naming `snmpCommunityString`
+ * — a column that no longer appears on the form — and only when the offending
+ * value happened to be in card #1. In any other card it stored fine and became
+ * a credential the mirror could never carry.
+ *
+ * Bounding here makes it one rule, checked on every card, in the words of the
+ * field the operator is actually looking at.
+ */
+export const MAX_SNMP_CONFIG_SHORT_TEXT_LENGTH = ColumnLength.ShortText;
+export const MAX_SNMP_CONFIG_KEY_LENGTH = ColumnLength.LongText;
+// Matches the UDP port range; see validateSnmpPort in the Dashboard's form.
+export const MINIMUM_SNMP_PORT = 1;
+export const MAXIMUM_SNMP_PORT = 65535;
+export class SnmpScanConfigUtil {
+    /*
+     * The credential sets this scan tries, in the order it tries them. NEVER
+     * empty: a scan with no `snmpConfigs` is a scan configured the old way, and
+     * its flattened columns ARE its one credential set.
+     *
+     * This is the single reader. The probe sweeps with what it returns, the
+     * import path resolves a host's credentials out of it, and the form seeds
+     * its editor from it — so "what does this scan actually try?" has exactly
+     * one answer no matter who asks.
+     */
+    static resolve(scan) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+        const stored = Array.isArray(scan.snmpConfigs)
+            ? scan.snmpConfigs.filter((config) => {
+                return Boolean(config) && typeof config === "object";
+            })
+            : [];
+        if (stored.length > 0) {
+            return stored.map((config, index) => {
+                return SnmpScanConfigUtil.normalizeConfig(config, index);
+            });
+        }
+        /*
+         * The legacy shape. Read straight off the flattened columns rather than
+         * migrated into the new column, deliberately: a data migration over every
+         * historical scan buys nothing (this synthesizes the identical config on
+         * every read) and would have to guess at rows whose columns are half
+         * populated.
+         */
+        return [
+            SnmpScanConfigUtil.normalizeConfig({
+                id: LEGACY_SNMP_CONFIG_ID,
+                snmpVersion: (_a = scan.snmpVersion) !== null && _a !== void 0 ? _a : undefined,
+                snmpCommunityString: (_b = scan.snmpCommunityString) !== null && _b !== void 0 ? _b : undefined,
+                snmpPort: (_c = scan.snmpPort) !== null && _c !== void 0 ? _c : undefined,
+                snmpV3SecurityLevel: (_d = scan.snmpV3SecurityLevel) !== null && _d !== void 0 ? _d : undefined,
+                snmpV3Username: (_e = scan.snmpV3Username) !== null && _e !== void 0 ? _e : undefined,
+                snmpV3AuthProtocol: (_f = scan.snmpV3AuthProtocol) !== null && _f !== void 0 ? _f : undefined,
+                snmpV3AuthKey: (_g = scan.snmpV3AuthKey) !== null && _g !== void 0 ? _g : undefined,
+                snmpV3PrivProtocol: (_h = scan.snmpV3PrivProtocol) !== null && _h !== void 0 ? _h : undefined,
+                snmpV3PrivKey: (_j = scan.snmpV3PrivKey) !== null && _j !== void 0 ? _j : undefined,
+            }, 0),
+        ];
+    }
+    /*
+     * The stored list, when the value really is one, or null.
+     *
+     * The distinction matters at every WRITE site: "this row has its own
+     * credential list" and "this row is described by its flattened columns" are
+     * two different states, and a jsonb column can arrive holding neither shape
+     * (a string, an object, an empty array) from an out-of-band writer. resolve()
+     * papers over all of that for readers; this is the version writers need,
+     * which answers the question honestly rather than synthesizing something.
+     */
+    static readStoredList(value) {
+        if (!Array.isArray(value) || value.length === 0) {
+            return null;
+        }
+        const configs = value.filter((config) => {
+            return Boolean(config) && typeof config === "object";
+        });
+        return configs.length > 0 ? configs : null;
+    }
+    /*
+     * The config that found a given host, or undefined when the host carries no
+     * config id (every result stored before this feature) or names one that is
+     * no longer in the list.
+     *
+     * Callers fall back to the FIRST config rather than to nothing — see
+     * `resolveForHost` — because a device imported with the wrong credentials is
+     * repairable on the device form, whereas a device imported with none can
+     * never poll and gives the operator nothing to correct.
+     */
+    static findById(configs, id) {
+        if (!id) {
+            return undefined;
+        }
+        return configs.find((config) => {
+            return config.id === id;
+        });
+    }
+    /*
+     * The credentials to import a discovered host with: the config that actually
+     * answered it, falling back to the first config in the list.
+     *
+     * The fallback is what makes results stored before this feature — and
+     * ping-only hosts, which no config found — import exactly as they did
+     * before, because for a legacy scan the first (and only) config IS the
+     * flattened columns.
+     */
+    static resolveForHost(scan, snmpConfigId) {
+        const configs = SnmpScanConfigUtil.resolve(scan);
+        return SnmpScanConfigUtil.findById(configs, snmpConfigId) || configs[0];
+    }
+    /*
+     * One config, cleaned up into the shape everything downstream expects:
+     * trimmed strings, a numeric port, blanks dropped, and an id guaranteed.
+     *
+     * The `index` is only used to synthesize an id for a config that has none.
+     * That is a repair for out-of-band writers, NOT the normal path — the form
+     * mints an id per card and the service's write hooks mint one for anything
+     * that arrives without. It is index-derived rather than random so that
+     * resolving the same row twice yields the same ids, which matters because
+     * this runs independently in the probe and in the importer.
+     */
+    static normalizeConfig(config, index) {
+        const normalized = {
+            id: SnmpScanConfigUtil.readString(config.id) || `config-${index + 1}`,
+        };
+        const name = SnmpScanConfigUtil.readString(config.name);
+        if (name !== undefined) {
+            normalized.name = name;
+        }
+        /*
+         * Normalized to the stored spelling ("V1"/"V2c"/"V3") rather than left as
+         * typed. SnmpVersionUtil.parse accepts either spelling and defaults to
+         * V2c, so this both repairs a hand-written "3" and gives the version an
+         * unambiguous value for the comparisons the service does on save.
+         */
+        normalized.snmpVersion = SnmpScanConfigUtil.toStoredVersion(config.snmpVersion);
+        const communityString = SnmpScanConfigUtil.readString(config.snmpCommunityString);
+        if (communityString !== undefined) {
+            normalized.snmpCommunityString = communityString;
+        }
+        const port = SnmpScanConfigUtil.readPort(config.snmpPort);
+        if (port !== undefined) {
+            normalized.snmpPort = port;
+        }
+        /*
+         * The v3 block is carried verbatim (beyond trimming). It is NOT dropped
+         * for a v1/v2c config, nor is the community dropped for a v3 one: an
+         * operator who switches a card's version to try something and switches it
+         * back must not silently lose the keys they had typed. The probe reads
+         * only what the chosen version needs.
+         */
+        const v3Fields = [
+            ["snmpV3SecurityLevel", config.snmpV3SecurityLevel],
+            ["snmpV3Username", config.snmpV3Username],
+            ["snmpV3AuthProtocol", config.snmpV3AuthProtocol],
+            ["snmpV3AuthKey", config.snmpV3AuthKey],
+            ["snmpV3PrivProtocol", config.snmpV3PrivProtocol],
+            ["snmpV3PrivKey", config.snmpV3PrivKey],
+        ];
+        for (const [key, rawValue] of v3Fields) {
+            const value = SnmpScanConfigUtil.readString(rawValue);
+            if (value !== undefined) {
+                normalized[key] = value;
+            }
+        }
+        return normalized;
+    }
+    /*
+     * The stored spelling of a version ("V1" / "V2c" / "V3").
+     *
+     * Written as an explicit map off the parsed enum rather than by
+     * upper-casing the input, so an unrecognized value lands on the same
+     * default the probe would have used ("V2c") instead of being stored as
+     * itself and disagreeing with the sweep.
+     */
+    static toStoredVersion(value) {
+        if (SnmpVersionUtil.isV3(value)) {
+            return "V3";
+        }
+        return SnmpVersionUtil.parse(value) === SnmpVersion.V1 ? "V1" : "V2c";
+    }
+    /*
+     * A short, non-secret way to refer to one config in running text — a probe
+     * log line, a validation message, the caption under a discovered host.
+     *
+     * NEVER includes a community string or a key. These strings reach places the
+     * credential columns deliberately do not (the probe's log, the scan's
+     * statusMessage, which is readable by a Viewer), so the label is built from
+     * the operator's own name and the version alone.
+     */
+    static getConfigLabel(config, index) {
+        const name = SnmpScanConfigUtil.readString(config.name);
+        const version = SnmpScanConfigUtil.toStoredVersion(config.snmpVersion);
+        if (name) {
+            return `${name} (${version})`;
+        }
+        return index === undefined
+            ? version
+            : `SNMP config ${index + 1} (${version})`;
+    }
+    /*
+     * The single validation entry point for the whole list, shared by the
+     * Dashboard form and the server's create/update hooks — so the sentence the
+     * operator reads on the form is the same sentence the API returns.
+     *
+     * Returns null when the value is storable, INCLUDING when it is absent: the
+     * column is optional and a scan with no list is a scan configured through
+     * the flattened columns.
+     *
+     * `value` is typed unknown for the same reason ScanTargetUtil's target is:
+     * the server hook runs before the model's own type checks, so it is the
+     * first thing to see whatever the client actually sent — which for a jsonb
+     * column really can be a string, a number or an object.
+     */
+    static getValidationError(value) {
+        if (value === undefined || value === null) {
+            return null;
+        }
+        if (!Array.isArray(value)) {
+            return "SNMP configs must be a list.";
+        }
+        if (value.length === 0) {
+            /*
+             * An empty list is refused rather than quietly treated as "use the
+             * flattened columns". The operator got here by deleting every card, and
+             * silently falling back to a hidden credential set they can no longer
+             * see is the kind of behaviour that produces a scan nobody can explain.
+             */
+            return "Add at least one SNMP config, or the scan has no credentials to try.";
+        }
+        if (value.length > MAX_SNMP_CONFIGS_PER_SCAN) {
+            return (`A scan can try at most ${MAX_SNMP_CONFIGS_PER_SCAN} SNMP configs. ` +
+                `This one has ${value.length}. Every extra config costs another SNMP ` +
+                `timeout on each address that answers nothing, so a long list can push ` +
+                `a large sweep past the probe's time limit. Split the range into more scans instead.`);
+        }
+        const seenIds = new Set();
+        for (let index = 0; index < value.length; index++) {
+            const config = value[index];
+            if (!config || typeof config !== "object" || Array.isArray(config)) {
+                return `SNMP config ${index + 1} is not valid.`;
+            }
+            const error = SnmpScanConfigUtil.getConfigValidationError(config, index);
+            if (error) {
+                return error;
+            }
+            /*
+             * Duplicate ids would make `findById` ambiguous, so a host found by the
+             * second of two identically-identified configs could import with the
+             * first one's credentials — the precise bug this whole id scheme exists
+             * to prevent. Only reachable through an out-of-band write; the form
+             * mints one id per card.
+             */
+            const id = SnmpScanConfigUtil.readString(config.id);
+            if (id) {
+                if (seenIds.has(id)) {
+                    return `Two SNMP configs share the id "${id}". Each config needs its own.`;
+                }
+                seenIds.add(id);
+            }
+        }
+        return null;
+    }
+    /*
+     * One config's rules. Split out so the message can name WHICH card is wrong
+     * — with five credential sets on screen, "SNMP v3 Username is required" on
+     * its own is not an actionable sentence.
+     */
+    static getConfigValidationError(config, index) {
+        const position = `SNMP config ${index + 1}`;
+        for (const [key, label] of [
+            ["id", "id"],
+            ["name", "name"],
+            ["snmpVersion", "version"],
+            ["snmpCommunityString", "community string"],
+            ["snmpV3SecurityLevel", "v3 security level"],
+            ["snmpV3Username", "v3 username"],
+            ["snmpV3AuthProtocol", "v3 authentication protocol"],
+            ["snmpV3AuthKey", "v3 authentication key"],
+            ["snmpV3PrivProtocol", "v3 privacy protocol"],
+            ["snmpV3PrivKey", "v3 privacy key"],
+        ]) {
+            const raw = config[key];
+            if (raw !== undefined && raw !== null && typeof raw !== "string") {
+                return `${position}: the ${label} must be text.`;
+            }
+        }
+        const name = SnmpScanConfigUtil.readString(config.name);
+        if (name !== undefined && name.length > MAX_SNMP_CONFIG_NAME_LENGTH) {
+            return (`${position}: a name cannot be longer than ${MAX_SNMP_CONFIG_NAME_LENGTH} ` +
+                `characters. This one is ${name.length}.`);
+        }
+        for (const [key, label, maxLength] of [
+            ["id", "id", MAX_SNMP_CONFIG_SHORT_TEXT_LENGTH],
+            [
+                "snmpCommunityString",
+                "community string",
+                MAX_SNMP_CONFIG_SHORT_TEXT_LENGTH,
+            ],
+            ["snmpV3Username", "v3 username", MAX_SNMP_CONFIG_SHORT_TEXT_LENGTH],
+            [
+                "snmpV3SecurityLevel",
+                "v3 security level",
+                MAX_SNMP_CONFIG_SHORT_TEXT_LENGTH,
+            ],
+            [
+                "snmpV3AuthProtocol",
+                "v3 authentication protocol",
+                MAX_SNMP_CONFIG_SHORT_TEXT_LENGTH,
+            ],
+            [
+                "snmpV3PrivProtocol",
+                "v3 privacy protocol",
+                MAX_SNMP_CONFIG_SHORT_TEXT_LENGTH,
+            ],
+            ["snmpV3AuthKey", "v3 authentication key", MAX_SNMP_CONFIG_KEY_LENGTH],
+            ["snmpV3PrivKey", "v3 privacy key", MAX_SNMP_CONFIG_KEY_LENGTH],
+        ]) {
+            const value = SnmpScanConfigUtil.readString(config[key]);
+            if (value !== undefined && value.length > maxLength) {
+                return (`${position}: the ${label} cannot be longer than ${maxLength} ` +
+                    `characters. This one is ${value.length}.`);
+            }
+        }
+        const portError = SnmpScanConfigUtil.getPortValidationError(config.snmpPort, position);
+        if (portError) {
+            return portError;
+        }
+        if (!SnmpVersionUtil.isV3(config.snmpVersion)) {
+            /*
+             * v1/v2c. The community string is NOT required here even though the
+             * device certainly needs one, because the probe falls back to "public"
+             * — which is a real, and very common, answer for discovery. Requiring it
+             * would refuse the single most useful default.
+             */
+            return null;
+        }
+        if (!SnmpScanConfigUtil.readString(config.snmpV3Username)) {
+            return `${position}: SNMP v3 needs a username (the security name configured on the device).`;
+        }
+        if (SnmpSecurityLevelUtil.isUnrecognized(config.snmpV3SecurityLevel)) {
+            return (`${position}: "${config.snmpV3SecurityLevel}" is not a recognized SNMP v3 security level. ` +
+                `Expected one of: ${Object.values(SnmpSecurityLevel).join(", ")}.`);
+        }
+        if (SnmpAuthProtocolUtil.isUnrecognized(config.snmpV3AuthProtocol)) {
+            return (`${position}: "${config.snmpV3AuthProtocol}" is not a recognized SNMP v3 authentication protocol. ` +
+                `Expected one of: ${Object.values(SnmpAuthProtocol).join(", ")}.`);
+        }
+        if (SnmpPrivProtocolUtil.isUnrecognized(config.snmpV3PrivProtocol)) {
+            return (`${position}: "${config.snmpV3PrivProtocol}" is not a recognized SNMP v3 privacy protocol. ` +
+                `Expected one of: ${Object.values(SnmpPrivProtocol).join(", ")}.`);
+        }
+        const securityLevel = SnmpSecurityLevelUtil.parse(config.snmpV3SecurityLevel);
+        /*
+         * A level that asks for authentication with nothing to authenticate with
+         * does not fail loudly — the session is simply rejected by every device,
+         * host after host, and the scan reports zero. Caught here so it is a
+         * sentence on the form instead.
+         */
+        const needsAuth = securityLevel === SnmpSecurityLevel.AuthNoPriv ||
+            securityLevel === SnmpSecurityLevel.AuthPriv;
+        if (needsAuth && !SnmpScanConfigUtil.readString(config.snmpV3AuthKey)) {
+            return `${position}: the "${securityLevel}" security level needs an authentication key.`;
+        }
+        if (securityLevel === SnmpSecurityLevel.AuthPriv &&
+            !SnmpScanConfigUtil.readString(config.snmpV3PrivKey)) {
+            return `${position}: the "${SnmpSecurityLevel.AuthPriv}" security level needs a privacy key.`;
+        }
+        return null;
+    }
+    /*
+     * The port rule, in the same words the single-config form used before this
+     * list existed (see validateSnmpPort in the Dashboard's SnmpConfigFormFields
+     * — that one still guards the NetworkDevice forms).
+     *
+     * Checked against the RAW value: a Number form field posts its contents as
+     * text, so "161.5" would parseInt to 161, clear both bounds, and then fail
+     * the write against a port the probe cannot dial.
+     */
+    static getPortValidationError(raw, position) {
+        if (raw === undefined || raw === null || String(raw).trim() === "") {
+            return null;
+        }
+        const port = Number(String(raw).trim());
+        if (!isFinite(port) || !Number.isInteger(port)) {
+            return `${position}: the SNMP port must be a whole number.`;
+        }
+        if (port < MINIMUM_SNMP_PORT || port > MAXIMUM_SNMP_PORT) {
+            return `${position}: the SNMP port must be between ${MINIMUM_SNMP_PORT} and ${MAXIMUM_SNMP_PORT}.`;
+        }
+        return null;
+    }
+    /*
+     * The list as it should be stored: validated by the caller, then normalized
+     * and given ids.
+     *
+     * Returns null for an absent list, which is what the column holds for a scan
+     * configured the old way — so a write that never mentions `snmpConfigs`
+     * leaves it alone rather than materializing a list nobody asked for.
+     */
+    static normalizeForStorage(value) {
+        if (!Array.isArray(value) || value.length === 0) {
+            return null;
+        }
+        return value.map((config, index) => {
+            const normalized = SnmpScanConfigUtil.normalizeConfig((config || {}), index);
+            /*
+             * Mint a real id for anything that arrived without one. The
+             * index-derived id `normalizeConfig` falls back to is fine for READING
+             * a row, but storing it would make the id positional — delete the
+             * first card and every id below it now names a different credential
+             * set, re-pointing results the probe has already stamped.
+             */
+            if (!SnmpScanConfigUtil.readString(config === null || config === void 0 ? void 0 : config.id)) {
+                normalized.id = ObjectID.generate().toString();
+            }
+            return normalized;
+        });
+    }
+    /*
+     * The flattened columns that should accompany a stored list, taken from its
+     * FIRST config.
+     *
+     * This mirroring is a compatibility guarantee, not redundancy. A probe is
+     * deployed separately from the server and is routinely a version behind; a
+     * probe that has never heard of `snmpConfigs` reads the flattened columns
+     * and nothing else. Without the mirror, saving a multi-config scan would
+     * blank the credentials of every older probe in the fleet — the scan would
+     * run with the column defaults (v2c/"public") and report a confident zero.
+     *
+     * The FIRST config specifically, because that is the one such a probe would
+     * have been given under the old single-config UI, and because the list is
+     * ordered by the operator's own preference.
+     *
+     * Every key is always present, with null for "unset": these values are also
+     * what the probe-claim endpoint compares its optimistic-concurrency
+     * `expectedData` against, and a key omitted for being empty would read as
+     * "unchanged" instead of "cleared".
+     */
+    static getMirroredLegacyColumns(configs) {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        const first = configs[0];
+        return {
+            snmpVersion: SnmpScanConfigUtil.toStoredVersion(first === null || first === void 0 ? void 0 : first.snmpVersion),
+            snmpCommunityString: (_a = first === null || first === void 0 ? void 0 : first.snmpCommunityString) !== null && _a !== void 0 ? _a : null,
+            snmpPort: (_b = first === null || first === void 0 ? void 0 : first.snmpPort) !== null && _b !== void 0 ? _b : null,
+            snmpV3SecurityLevel: (_c = first === null || first === void 0 ? void 0 : first.snmpV3SecurityLevel) !== null && _c !== void 0 ? _c : null,
+            snmpV3Username: (_d = first === null || first === void 0 ? void 0 : first.snmpV3Username) !== null && _d !== void 0 ? _d : null,
+            snmpV3AuthProtocol: (_e = first === null || first === void 0 ? void 0 : first.snmpV3AuthProtocol) !== null && _e !== void 0 ? _e : null,
+            snmpV3AuthKey: (_f = first === null || first === void 0 ? void 0 : first.snmpV3AuthKey) !== null && _f !== void 0 ? _f : null,
+            snmpV3PrivProtocol: (_g = first === null || first === void 0 ? void 0 : first.snmpV3PrivProtocol) !== null && _g !== void 0 ? _g : null,
+            snmpV3PrivKey: (_h = first === null || first === void 0 ? void 0 : first.snmpV3PrivKey) !== null && _h !== void 0 ? _h : null,
+        };
+    }
+    /*
+     * A trimmed string, or undefined for anything that is not usable text.
+     * Values arrive straight from request JSON, so "not a string" is a real
+     * case rather than a defensive one.
+     */
+    static readString(value) {
+        if (typeof value !== "string") {
+            return undefined;
+        }
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : undefined;
+    }
+    /*
+     * A usable port number, or undefined. Anything out of range is dropped
+     * rather than clamped, so the column default (161) applies — callers that
+     * want to REFUSE it call getPortValidationError first, exactly like
+     * ScanNameUtil.normalize/getValidationError.
+     */
+    static readPort(value) {
+        if (value === undefined || value === null || String(value).trim() === "") {
+            return undefined;
+        }
+        const port = Number(String(value).trim());
+        if (!isFinite(port) ||
+            !Number.isInteger(port) ||
+            port < MINIMUM_SNMP_PORT ||
+            port > MAXIMUM_SNMP_PORT) {
+            return undefined;
+        }
+        return port;
+    }
+}
+export default SnmpScanConfigUtil;
+//# sourceMappingURL=SnmpScanConfigUtil.js.map

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

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

package/build/dist/Utils/NetworkSite/SiteMaintenanceUtil.js

@@ -0,0 +1,56 @@
+import MaterializedPathUtil from "./MaterializedPathUtil";
+export class SiteMaintenanceUtil {
+    /*
+     * The windows that cover one site: those attached to the site itself, and
+     * those attached to any of its ancestors.
+     *
+     * Ancestry is read off the site's materialized path, whose segments are
+     * exactly its ancestor ids followed by its own. A site with no path (never
+     * placed in the hierarchy, or mid-repair) still matches windows attached
+     * to it directly - `siteId` is checked on its own rather than trusted to
+     * appear in the path.
+     */
+    static windowsCoveringSite(data) {
+        const coveringIds = new Set([data.siteId]);
+        for (const segment of MaterializedPathUtil.segmentsOf(data.materializedPath)) {
+            coveringIds.add(segment);
+        }
+        const windows = [];
+        for (const event of data.events) {
+            if (!SiteMaintenanceUtil.intersects(event.siteIds, coveringIds)) {
+                continue;
+            }
+            windows.push({
+                startsAt: event.startsAt,
+                endsAt: event.endsAt,
+            });
+        }
+        return windows;
+    }
+    /*
+     * The same resolution for many sites at once, keyed by site id. Sites with
+     * no covering window are present in the map with an empty array, so a
+     * caller can tell "resolved, nothing covers it" from "never looked".
+     */
+    static windowsBySite(data) {
+        const bySite = new Map();
+        for (const site of data.sites) {
+            bySite.set(site.id, SiteMaintenanceUtil.windowsCoveringSite({
+                siteId: site.id,
+                materializedPath: site.materializedPath,
+                events: data.events,
+            }));
+        }
+        return bySite;
+    }
+    static intersects(values, set) {
+        for (const value of values) {
+            if (set.has(value)) {
+                return true;
+            }
+        }
+        return false;
+    }
+}
+export default SiteMaintenanceUtil;
+//# sourceMappingURL=SiteMaintenanceUtil.js.map

package/build/dist/Utils/NetworkSite/SiteMaintenanceUtil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SiteMaintenanceUtil.js","sourceRoot":"","sources":["../../../../Utils/NetworkSite/SiteMaintenanceUtil.ts"],"names":[],"mappings":"AAAA,OAAO,oBAAoB,MAAM,wBAAwB,CAAC;AAkC1D,MAAM,OAAO,mBAAmB;IAC9B;;;;;;;;;OASG;IACI,MAAM,CAAC,mBAAmB,CAAC,IAIjC;QACC,MAAM,WAAW,GAAgB,IAAI,GAAG,CAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAEhE,KAAK,MAAM,OAAO,IAAI,oBAAoB,CAAC,UAAU,CACnD,IAAI,CAAC,gBAAgB,CACtB,EAAE,CAAC;YACF,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;QAED,MAAM,OAAO,GAAiC,EAAE,CAAC;QAEjD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC;gBAChE,SAAS;YACX,CAAC;YAED,OAAO,CAAC,IAAI,CAAC;gBACX,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,aAAa,CAAC,IAG3B;QACC,MAAM,MAAM,GAA8C,IAAI,GAAG,EAAE,CAAC;QAEpE,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,CACR,IAAI,CAAC,EAAE,EACP,mBAAmB,CAAC,mBAAmB,CAAC;gBACtC,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;gBACvC,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CACH,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,MAAM,CAAC,UAAU,CAAC,MAAqB,EAAE,GAAgB;QAC/D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnB,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,eAAe,mBAAmB,CAAC"}