@oneuptime/common 14.0.2 → 14.0.3

package/build/dist/Utils/Incident/IncidentFromAlerts.js

@@ -0,0 +1,306 @@
+import ObjectID from "../../Types/ObjectID";
+import { MAX_ALERTS_PER_INCIDENT_LINK_ACTION } from "../../Types/Incident/IncidentAlertLink";
+/*
+ * The resource lists the incident form supports besides monitors (which come
+ * from each alert's single `monitor`). Exported so the create page and the
+ * tests walk the same list.
+ */
+export const INCIDENT_PREFILL_RESOURCE_KEYS = ["hosts", "kubernetesClusters", "dockerHosts", "podmanHosts", "services"];
+const INCIDENT_PREFILL_LIST_KEYS = [
+    "monitors",
+    ...INCIDENT_PREFILL_RESOURCE_KEYS,
+];
+export default class IncidentFromAlerts {
+    /*
+     * Reads the create page's `alertIds` query parameter: comma separated,
+     * whitespace tolerant, invalid ids dropped, duplicates removed (first one
+     * wins), capped at MAX_ALERTS_PER_INCIDENT_LINK_ACTION.
+     */
+    static parseAlertIdsQueryParam(value) {
+        if (!value) {
+            return { alertIds: [], wasTruncated: false };
+        }
+        const alertIds = [];
+        for (const rawId of value.split(",")) {
+            const id = rawId.trim();
+            if (!id || !ObjectID.isValidUUID(id) || alertIds.includes(id)) {
+                continue;
+            }
+            alertIds.push(id);
+        }
+        return {
+            alertIds: alertIds.slice(0, MAX_ALERTS_PER_INCIDENT_LINK_ACTION),
+            wasTruncated: alertIds.length > MAX_ALERTS_PER_INCIDENT_LINK_ACTION,
+        };
+    }
+    /*
+     * Severities ordered most severe first: ascending `order`, the way the
+     * project's severity settings list them. A severity without an order sorts
+     * after every ordered one; ties keep their input order.
+     */
+    static sortSeveritiesByOrder(severities) {
+        return severities
+            .map((severity, index) => {
+            return { severity, index };
+        })
+            .sort((a, b) => {
+            const aHasOrder = typeof a.severity.order === "number";
+            const bHasOrder = typeof b.severity.order === "number";
+            if (aHasOrder && bHasOrder) {
+                const difference = a.severity.order - b.severity.order;
+                if (difference !== 0) {
+                    return difference;
+                }
+                return a.index - b.index;
+            }
+            if (aHasOrder !== bHasOrder) {
+                return aHasOrder ? -1 : 1;
+            }
+            return a.index - b.index;
+        })
+            .map((entry) => {
+            return entry.severity;
+        });
+    }
+    /*
+     * 0 for the most severe severity, 1 for the next and so on; null when the
+     * id is not one of the given severities.
+     */
+    static getSeverityRank(severityId, severities) {
+        if (!severityId) {
+            return null;
+        }
+        const rank = this.sortSeveritiesByOrder(severities).findIndex((severity) => {
+            return severity.id === severityId;
+        });
+        return rank < 0 ? null : rank;
+    }
+    /*
+     * The alert whose severity ranks highest. Alerts without a known severity
+     * never win over one with a severity; ties go to the alert listed first.
+     * With no known severity anywhere, the first alert.
+     */
+    static getMostSevereAlert(alerts, alertSeverities) {
+        let mostSevere = null;
+        let mostSevereRank = null;
+        for (const alert of alerts) {
+            const rank = this.getSeverityRank(alert.alertSeverityId, alertSeverities);
+            if (!mostSevere) {
+                mostSevere = alert;
+                mostSevereRank = rank;
+                continue;
+            }
+            if (rank === null) {
+                continue;
+            }
+            if (mostSevereRank === null || rank < mostSevereRank) {
+                mostSevere = alert;
+                mostSevereRank = rank;
+            }
+        }
+        return mostSevere;
+    }
+    /*
+     * The incident severity an alert severity corresponds to. An incident
+     * severity with the same name (ignoring case and surrounding spaces) wins;
+     * otherwise the alert severity's rank among the alert severities picks the
+     * incident severity at the same rank, clamped to the least severe one when
+     * the project has fewer incident severities than alert severities.
+     */
+    static mapAlertSeverityToIncidentSeverity(data) {
+        if (!data.alertSeverityId || data.incidentSeverities.length === 0) {
+            return null;
+        }
+        const alertSeverity = data.alertSeverities.find((severity) => {
+            return severity.id === data.alertSeverityId;
+        });
+        if (!alertSeverity) {
+            return null;
+        }
+        const alertSeverityName = (alertSeverity.name || "")
+            .trim()
+            .toLowerCase();
+        if (alertSeverityName) {
+            const sameName = data.incidentSeverities.find((severity) => {
+                return ((severity.name || "").trim().toLowerCase() === alertSeverityName);
+            });
+            if (sameName) {
+                return sameName.id;
+            }
+        }
+        const rank = this.getSeverityRank(alertSeverity.id, data.alertSeverities);
+        if (rank === null) {
+            return null;
+        }
+        const sortedIncidentSeverities = this.sortSeveritiesByOrder(data.incidentSeverities);
+        const target = sortedIncidentSeverities[Math.min(rank, sortedIncidentSeverities.length - 1)];
+        return target ? target.id : null;
+    }
+    /* "Alert #42" / "Alert ALT-42", or "Alert" when the number is unknown. */
+    static getAlertReference(alert) {
+        if (alert.alertNumberWithPrefix) {
+            return `Alert ${alert.alertNumberWithPrefix}`;
+        }
+        if (typeof alert.alertNumber === "number") {
+            return `Alert #${alert.alertNumber}`;
+        }
+        return "Alert";
+    }
+    static buildIncidentPrefill(input) {
+        const alerts = input.alerts;
+        const prefill = {
+            title: "",
+            description: "",
+            incidentSeverityId: undefined,
+            monitors: [],
+            hosts: [],
+            kubernetesClusters: [],
+            dockerHosts: [],
+            podmanHosts: [],
+            services: [],
+            labelIds: [],
+            isPrivate: false,
+        };
+        if (alerts.length === 0) {
+            return prefill;
+        }
+        const mostSevere = this.getMostSevereAlert(alerts, input.alertSeverities);
+        if (alerts.length === 1) {
+            prefill.title = alerts[0].title || "";
+            prefill.description = alerts[0].description || "";
+        }
+        else {
+            prefill.title = (mostSevere === null || mostSevere === void 0 ? void 0 : mostSevere.title) || "";
+            prefill.description = alerts
+                .map((alert) => {
+                return `- ${this.getAlertReference(alert)}: ${alert.title || ""}`.trimEnd();
+            })
+                .join("\n");
+        }
+        prefill.incidentSeverityId =
+            this.mapAlertSeverityToIncidentSeverity({
+                alertSeverityId: mostSevere === null || mostSevere === void 0 ? void 0 : mostSevere.alertSeverityId,
+                alertSeverities: input.alertSeverities,
+                incidentSeverities: input.incidentSeverities,
+            }) || undefined;
+        for (const alert of alerts) {
+            if (alert.monitor) {
+                this.addResource(prefill.monitors, alert.monitor);
+            }
+            for (const key of INCIDENT_PREFILL_RESOURCE_KEYS) {
+                for (const resource of alert[key] || []) {
+                    this.addResource(prefill[key], resource);
+                }
+            }
+            for (const labelId of alert.labelIds || []) {
+                if (labelId && !prefill.labelIds.includes(labelId)) {
+                    prefill.labelIds.push(labelId);
+                }
+            }
+            if (alert.isPrivate) {
+                prefill.isPrivate = true;
+            }
+        }
+        return prefill;
+    }
+    /*
+     * Folds the prefill into the form's initial values without undoing what is
+     * already there (an incident template, say): title, description and
+     * severity only fill blanks, resource and label lists are unioned, and a
+     * private incident stays private. On-call policies are never touched -
+     * declaring an incident from alerts must not page anyone the alerts did
+     * not already page.
+     */
+    static applyPrefillToInitialValues(initialValues, prefill) {
+        const merged = Object.assign({}, initialValues);
+        if (!this.hasText(merged["title"]) && prefill.title) {
+            merged["title"] = prefill.title;
+        }
+        if (!this.hasText(merged["description"]) && prefill.description) {
+            merged["description"] = prefill.description;
+        }
+        if (!this.hasText(merged["incidentSeverity"]) &&
+            prefill.incidentSeverityId) {
+            merged["incidentSeverity"] = prefill.incidentSeverityId;
+        }
+        for (const key of INCIDENT_PREFILL_LIST_KEYS) {
+            const resources = [];
+            for (const existing of this.asArray(merged[key])) {
+                const resource = this.toNamedResource(existing);
+                if (resource) {
+                    this.addResource(resources, resource);
+                }
+            }
+            for (const resource of prefill[key]) {
+                this.addResource(resources, resource);
+            }
+            if (resources.length > 0) {
+                merged[key] = resources;
+            }
+        }
+        const labelIds = [];
+        for (const existing of this.asArray(merged["labels"])) {
+            const id = this.toId(existing);
+            if (id && !labelIds.includes(id)) {
+                labelIds.push(id);
+            }
+        }
+        for (const labelId of prefill.labelIds) {
+            if (!labelIds.includes(labelId)) {
+                labelIds.push(labelId);
+            }
+        }
+        if (labelIds.length > 0) {
+            merged["labels"] = labelIds;
+        }
+        if (prefill.isPrivate) {
+            merged["isPrivate"] = true;
+        }
+        return merged;
+    }
+    static addResource(resources, resource) {
+        if (!resource._id) {
+            return;
+        }
+        const alreadyAdded = resources.some((existing) => {
+            return existing._id === resource._id;
+        });
+        if (!alreadyAdded) {
+            resources.push({ _id: resource._id, name: resource.name || "" });
+        }
+    }
+    static hasText(value) {
+        if (value === null || value === undefined) {
+            return false;
+        }
+        return value.toString().trim().length > 0;
+    }
+    static asArray(value) {
+        return Array.isArray(value) ? value : [];
+    }
+    static toId(value) {
+        var _a;
+        if (typeof value === "string") {
+            return value || null;
+        }
+        if (value && typeof value === "object") {
+            const id = (_a = value["_id"]) !== null && _a !== void 0 ? _a : value["id"];
+            if (id !== null && id !== undefined) {
+                const idString = id.toString();
+                return idString || null;
+            }
+        }
+        return null;
+    }
+    static toNamedResource(value) {
+        const id = this.toId(value);
+        if (!id) {
+            return null;
+        }
+        const name = value && typeof value === "object"
+            ? value["name"]
+            : undefined;
+        return { _id: id, name: typeof name === "string" ? name : "" };
+    }
+}
+//# sourceMappingURL=IncidentFromAlerts.js.map

package/build/dist/Utils/Incident/IncidentFromAlerts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IncidentFromAlerts.js","sourceRoot":"","sources":["../../../../Utils/Incident/IncidentFromAlerts.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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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oneuptime/common",
-  "version": "14.0.2",
+  "version": "14.0.3",
   "description": "",
   "repository": {
     "type": "git",