@oneuptime/common 12.0.8 → 12.0.9

package/build/dist/Types/OnCallDutyPolicy/ScheduleShiftUtil.js

@@ -1,12 +1,40 @@
 import OneUptimeDate from "../Date";
 /*
- * Two coverage segments are considered part of the same continuous shift when
- * the gap between them is below this threshold. LayerUtil starts each following
- * segment exactly one second after the previous one ends, so anything within a
- * couple of minutes is "touching"; anything larger is a genuine off-hours gap
- * (a restriction window closing, a rotation with no fallback layer, etc.).
+ * Why a schedule currently has (or does not have) somebody on call. The four
+ * states are mutually exclusive and ordered by how early the misconfiguration
+ * happens, so a caller can render the most specific remedy it knows about:
+ *
+ * - NoLayers      the schedule has no layers at all -> "add a layer"
+ * - NoUsers       layers exist but nobody is assigned to any of them, so the
+ *                 engine emits zero events and NOBODY is ever on call. This is
+ *                 a permanent 100% gap, not an off-hours one, and it needs its
+ *                 own remedy ("assign users") — telling someone to widen their
+ *                 active hours here would be wrong.
+ * - UncoveredNow  users are assigned and shifts exist, but none covers `now`
+ * - Covered       somebody is on call at this instant
  */
-const CONTIGUITY_TOLERANCE_SECONDS = 90;
+export var ScheduleCoverageStatus;
+(function (ScheduleCoverageStatus) {
+    ScheduleCoverageStatus["NoLayers"] = "NoLayers";
+    ScheduleCoverageStatus["NoUsers"] = "NoUsers";
+    ScheduleCoverageStatus["UncoveredNow"] = "UncoveredNow";
+    ScheduleCoverageStatus["Covered"] = "Covered";
+})(ScheduleCoverageStatus || (ScheduleCoverageStatus = {}));
+/*
+ * Two coverage segments belong to the same continuous shift when the hole
+ * between them is at or below this threshold. LayerUtil starts each following
+ * segment exactly one second after the previous one ends (Layer.ts advances
+ * with addRemoveSeconds(end, 1)) and the multi-layer priority merge leaves
+ * seams of the same ±1s magnitude, so a few seconds of slack is all that is
+ * needed to absorb the engine's own artifacts.
+ *
+ * This used to be 90 seconds, which silently swallowed genuine sub-minute
+ * coverage holes — a schedule whose layers were misaligned by a minute
+ * reported full coverage. Anything above the engine artifact is a real hole and
+ * is now reported; callers that consider very short holes to be display noise
+ * filter them at the render layer (see getCoverageGaps' minimumGapSeconds).
+ */
+const CONTIGUITY_TOLERANCE_SECONDS = 5;
 export default class ScheduleShiftUtil {
     /*
      * Collapse raw coverage events into shifts.
@@ -110,20 +138,24 @@ export default class ScheduleShiftUtil {
      *
      * `shifts` are assumed sorted by start (as returned by groupEventsIntoShifts).
      */
-    static getCoverageGaps(shifts, windowStart, windowEnd) {
+    static getCoverageGaps(shifts, windowStart, windowEnd, options) {
         const gaps = [];
         if (OneUptimeDate.isOnOrAfter(windowStart, windowEnd)) {
             return gaps;
         }
         /*
-         * A gap only "counts" when it is longer than the contiguity tolerance, so
+         * A hole only "counts" as a gap when it is longer than the threshold, so
          * the one-second boundaries LayerUtil leaves between segments never show up
-         * as spurious coverage holes.
+         * as spurious coverage holes. Callers that treat short holes as display
+         * noise (rather than as a misconfiguration worth reporting) raise
+         * minimumGapSeconds instead of relying on the detector to hide them.
          */
+        const minimumGapSeconds = (options === null || options === void 0 ? void 0 : options.minimumGapSeconds) === undefined
+            ? CONTIGUITY_TOLERANCE_SECONDS
+            : options.minimumGapSeconds;
         const isRealGap = (start, end) => {
             return (OneUptimeDate.isAfter(end, start) &&
-                OneUptimeDate.getDifferenceInSeconds(end, start) >
-                    CONTIGUITY_TOLERANCE_SECONDS);
+                OneUptimeDate.getDifferenceInSeconds(end, start) > minimumGapSeconds);
         };
         if (shifts.length === 0) {
             if (isRealGap(windowStart, windowEnd)) {
@@ -155,5 +187,67 @@ export default class ScheduleShiftUtil {
         }
         return gaps;
     }
+    /*
+     * The single source of truth for "does this schedule have anybody on call,
+     * and if not, why not". Every surface that renders coverage derives its state
+     * from here rather than inventing its own condition.
+     *
+     * This exists because the UI used to gate its gap warnings on
+     * `assignedUserCount > 0` — a condition that is exactly INVERTED, since zero
+     * assigned users IS the total-gap state. The one screen that would have said
+     * "nobody is on call" was therefore the one screen that never rendered.
+     * Returning an explicit status makes that class of mistake impossible: a
+     * caller must handle NoUsers, it cannot accidentally fall into "covered".
+     */
+    static getCoverageState(data) {
+        const { current, next } = this.getCurrentAndNextShift(data.shifts, data.now);
+        const gaps = this.getCoverageGaps(data.shifts, data.now, data.windowEnd, { minimumGapSeconds: data.minimumGapSeconds });
+        const uncoveredSeconds = gaps.reduce((total, gap) => {
+            return total + OneUptimeDate.getDifferenceInSeconds(gap.end, gap.start);
+        }, 0);
+        let status = ScheduleCoverageStatus.Covered;
+        if (data.layerCount <= 0) {
+            status = ScheduleCoverageStatus.NoLayers;
+        }
+        else if (data.assignedUserCount <= 0) {
+            status = ScheduleCoverageStatus.NoUsers;
+        }
+        else if (!current) {
+            status = ScheduleCoverageStatus.UncoveredNow;
+        }
+        /*
+         * Test the window's ORDER explicitly rather than inferring it from the sign
+         * of the difference: OneUptimeDate.getDifferenceInSeconds returns an
+         * ABSOLUTE value, so an inverted window (windowEnd before now) yields a
+         * positive windowSeconds. Combined with getCoverageGaps bailing out on such
+         * a window and returning no gaps, the ratio then computed to a confident
+         * 1 — the function whose entire job is to surface missing coverage would
+         * report 100% covered. Fail to 0, never to "everything is fine".
+         */
+        const hasUsableWindow = OneUptimeDate.isBefore(data.now, data.windowEnd);
+        const windowSeconds = hasUsableWindow
+            ? OneUptimeDate.getDifferenceInSeconds(data.windowEnd, data.now)
+            : 0;
+        /*
+         * A schedule with no layers, or with layers but nobody assigned to them,
+         * can never put anyone on call — its coverage is 0 by definition, whatever
+         * shifts a caller happened to pass in. Deriving the ratio purely from those
+         * shifts would let a stale set report "100% covered" next to "no layers
+         * configured".
+         */
+        const canEverCover = status !== ScheduleCoverageStatus.NoLayers &&
+            status !== ScheduleCoverageStatus.NoUsers;
+        const coverageRatio = !hasUsableWindow || !canEverCover
+            ? 0
+            : Math.min(1, Math.max(0, (windowSeconds - uncoveredSeconds) / windowSeconds));
+        return {
+            status,
+            current,
+            next,
+            gaps,
+            uncoveredSeconds,
+            coverageRatio,
+        };
+    }
 }
 //# sourceMappingURL=ScheduleShiftUtil.js.map

package/build/dist/Types/OnCallDutyPolicy/ScheduleShiftUtil.js.map

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

package/build/dist/Types/Permission.js

@@ -853,6 +853,28 @@ var Permission;
     Permission["EditProjectOnCallDutyPolicy"] = "EditProjectOnCallDutyPolicy";
     Permission["DeleteProjectOnCallDutyPolicy"] = "DeleteProjectOnCallDutyPolicy";
     Permission["ReadProjectOnCallDutyPolicy"] = "ReadProjectOnCallDutyPolicy";
+    /*
+     * A project user's own on-call notification configuration - the rules that
+     * decide which of their verified methods a page reaches, and after how long.
+     *
+     * Every other permission in this family gates a resource the project owns.
+     * These two gate rows that belong to an individual member, which is why they
+     * exist separately rather than being folded into
+     * Read/EditProjectOnCallDutyPolicy: a policy says "page the on-call engineer",
+     * but whether that page actually arrives is decided by rows only that engineer
+     * could see or write. An unreachable teammate was therefore diagnosable by
+     * nobody but themselves, and the person carrying the incident had no way to
+     * find out before the page went unanswered.
+     *
+     * Read grants VISIBILITY of another member's rules and of the methods those
+     * rules point at - never the delivery token behind a method (see the column
+     * access control on UserWebhook and UserPush). Edit grants repair of the
+     * rules themselves. Neither grants the ability to add a notification method to
+     * somebody else's account; that asymmetry is deliberate and is explained on
+     * UserNotificationRule.
+     */
+    Permission["ReadProjectUserNotificationRule"] = "ReadProjectUserNotificationRule";
+    Permission["EditProjectUserNotificationRule"] = "EditProjectUserNotificationRule";
     // Resource Permissions (Team Permission)
     Permission["CreateProjectOnCallDutyPolicySchedule"] = "CreateProjectOnCallDutyPolicySchedule";
     Permission["EditProjectOnCallDutyPolicySchedule"] = "EditProjectOnCallDutyPolicySchedule";
@@ -1009,6 +1031,18 @@ var Permission;
     Permission["DeleteNetworkSiteLink"] = "DeleteNetworkSiteLink";
     Permission["EditNetworkSiteLink"] = "EditNetworkSiteLink";
     Permission["ReadNetworkSiteLink"] = "ReadNetworkSiteLink";
+    Permission["CreateNetworkDeviceLink"] = "CreateNetworkDeviceLink";
+    Permission["DeleteNetworkDeviceLink"] = "DeleteNetworkDeviceLink";
+    Permission["EditNetworkDeviceLink"] = "EditNetworkDeviceLink";
+    Permission["ReadNetworkDeviceLink"] = "ReadNetworkDeviceLink";
+    Permission["CreateNetworkDeviceLinkRule"] = "CreateNetworkDeviceLinkRule";
+    Permission["DeleteNetworkDeviceLinkRule"] = "DeleteNetworkDeviceLinkRule";
+    Permission["EditNetworkDeviceLinkRule"] = "EditNetworkDeviceLinkRule";
+    Permission["ReadNetworkDeviceLinkRule"] = "ReadNetworkDeviceLinkRule";
+    Permission["CreateNetworkTopologySuppression"] = "CreateNetworkTopologySuppression";
+    Permission["DeleteNetworkTopologySuppression"] = "DeleteNetworkTopologySuppression";
+    Permission["EditNetworkTopologySuppression"] = "EditNetworkTopologySuppression";
+    Permission["ReadNetworkTopologySuppression"] = "ReadNetworkTopologySuppression";
     Permission["CreateNetworkSiteAssignmentRule"] = "CreateNetworkSiteAssignmentRule";
     Permission["DeleteNetworkSiteAssignmentRule"] = "DeleteNetworkSiteAssignmentRule";
     Permission["EditNetworkSiteAssignmentRule"] = "EditNetworkSiteAssignmentRule";
@@ -5226,6 +5260,38 @@ export class PermissionHelper {
                 isRolePermission: false,
                 group: PermissionGroup.OnCallDutyPolicy,
             },
+            /*
+             * isRolePermission is false on both of these deliberately, and it is not a
+             * stylistic choice. A true value would file them under
+             * getRolePermissionProps(), which is the list every default project role
+             * is built from - so the ability to read and rewrite a colleague's paging
+             * configuration would arrive silently with an existing role rather than
+             * being handed out on purpose. They are granular permissions an
+             * administrator opts into, held by nobody until somebody grants them.
+             *
+             * isAccessControlPermission is false because the rows these gate carry no
+             * label column; there is nothing for a label-scoped grant to narrow, and
+             * claiming otherwise would offer an administrator a scoping control that
+             * silently does nothing.
+             */
+            {
+                permission: Permission.ReadProjectUserNotificationRule,
+                title: "Read User Notification Rules",
+                description: "This permission can read the on-call notification rules of any user in this project, and see which of their notification methods those rules point at. Delivery addresses are shown in a masked form and delivery credentials are never readable.",
+                isAssignableToTenant: true,
+                isAccessControlPermission: false,
+                isRolePermission: false,
+                group: PermissionGroup.OnCallDutyPolicy,
+            },
+            {
+                permission: Permission.EditProjectUserNotificationRule,
+                title: "Edit User Notification Rules",
+                description: "This permission can create, edit and delete the on-call notification rules of any user in this project, in order to repair a member who would otherwise never be paged. It does not permit adding or changing a user's notification methods.",
+                isAssignableToTenant: true,
+                isAccessControlPermission: false,
+                isRolePermission: false,
+                group: PermissionGroup.OnCallDutyPolicy,
+            },
             {
                 permission: Permission.CreateProjectOnCallDutyPolicySchedule,
                 title: "Create On-Call Duty Policy Schedule",
@@ -6965,6 +7031,114 @@ export class PermissionHelper {
                 isRolePermission: false,
                 group: PermissionGroup.Monitor,
             },
+            {
+                permission: Permission.CreateNetworkDeviceLink,
+                title: "Create Network Device Link",
+                description: "This permission can create Network Device Link in this project.",
+                isAssignableToTenant: true,
+                isAccessControlPermission: false,
+                isRolePermission: false,
+                group: PermissionGroup.Monitor,
+            },
+            {
+                permission: Permission.DeleteNetworkDeviceLink,
+                title: "Delete Network Device Link",
+                description: "This permission can delete Network Device Link of this project.",
+                isAssignableToTenant: true,
+                isAccessControlPermission: true,
+                isRolePermission: false,
+                group: PermissionGroup.Monitor,
+            },
+            {
+                permission: Permission.EditNetworkDeviceLink,
+                title: "Edit Network Device Link",
+                description: "This permission can edit Network Device Link of this project.",
+                isAssignableToTenant: true,
+                isAccessControlPermission: true,
+                isRolePermission: false,
+                group: PermissionGroup.Monitor,
+            },
+            {
+                permission: Permission.ReadNetworkDeviceLink,
+                title: "Read Network Device Link",
+                description: "This permission can read Network Device Link of this project.",
+                isAssignableToTenant: true,
+                isAccessControlPermission: true,
+                isRolePermission: false,
+                group: PermissionGroup.Monitor,
+            },
+            {
+                permission: Permission.CreateNetworkDeviceLinkRule,
+                title: "Create Network Device Link Rule",
+                description: "This permission can create Network Device Link Rule in this project.",
+                isAssignableToTenant: true,
+                isAccessControlPermission: false,
+                isRolePermission: false,
+                group: PermissionGroup.Monitor,
+            },
+            {
+                permission: Permission.DeleteNetworkDeviceLinkRule,
+                title: "Delete Network Device Link Rule",
+                description: "This permission can delete Network Device Link Rule of this project.",
+                isAssignableToTenant: true,
+                isAccessControlPermission: true,
+                isRolePermission: false,
+                group: PermissionGroup.Monitor,
+            },
+            {
+                permission: Permission.EditNetworkDeviceLinkRule,
+                title: "Edit Network Device Link Rule",
+                description: "This permission can edit Network Device Link Rule of this project.",
+                isAssignableToTenant: true,
+                isAccessControlPermission: true,
+                isRolePermission: false,
+                group: PermissionGroup.Monitor,
+            },
+            {
+                permission: Permission.ReadNetworkDeviceLinkRule,
+                title: "Read Network Device Link Rule",
+                description: "This permission can read Network Device Link Rule of this project.",
+                isAssignableToTenant: true,
+                isAccessControlPermission: true,
+                isRolePermission: false,
+                group: PermissionGroup.Monitor,
+            },
+            {
+                permission: Permission.CreateNetworkTopologySuppression,
+                title: "Create Network Topology Suppression",
+                description: "This permission can hide nodes from the Network Topology map in this project.",
+                isAssignableToTenant: true,
+                isAccessControlPermission: false,
+                isRolePermission: false,
+                group: PermissionGroup.Monitor,
+            },
+            {
+                permission: Permission.DeleteNetworkTopologySuppression,
+                title: "Delete Network Topology Suppression",
+                description: "This permission can restore hidden nodes to the Network Topology map of this project.",
+                isAssignableToTenant: true,
+                isAccessControlPermission: true,
+                isRolePermission: false,
+                group: PermissionGroup.Monitor,
+            },
+            {
+                permission: Permission.EditNetworkTopologySuppression,
+                title: "Edit Network Topology Suppression",
+                description: "This permission can edit Network Topology Suppression of this project.",
+                isAssignableToTenant: true,
+                isAccessControlPermission: true,
+                isRolePermission: false,
+                group: PermissionGroup.Monitor,
+            },
+            {
+                permission: Permission.ReadNetworkTopologySuppression,
+                title: "Read Network Topology Suppression",
+                description: "This permission can read Network Topology Suppression of this project.",
+                isAssignableToTenant: true,
+                isAccessControlPermission: true,
+                isRolePermission: false,
+                group: PermissionGroup.Monitor,
+            },
             {
                 permission: Permission.CreateNetworkSiteAssignmentRule,
                 title: "Create Network Site Assignment Rule",