@oneuptime/common 14.0.13 → 14.0.14

package/build/dist/Types/NotificationRule/OnCallRuleKind.js

@@ -0,0 +1,134 @@
+import NotificationRuleType from "./NotificationRuleType";
+/*
+ * THE FOUR KINDS OF ON-CALL RULE, AND THE ADDRESS OF EACH ONE'S TAB.
+ *
+ * A person keeps on-call notification rules for four kinds of page:
+ * incidents, incident episodes, alerts and alert episodes. They live on one
+ * On-Call Rules page with a tab per kind - in User Settings for your own,
+ * and under Users > (a member) > On-Call for an admin looking at somebody
+ * else's. The address says which tab is open: `?type=alerts`. The first tab,
+ * Incidents, is the bare address, so every tab has exactly one address.
+ *
+ * Everything that sends somebody to fix a rule builds that address from
+ * here: the dashboard's own links (the setup checklist, a policy's readiness
+ * card, a team's compliance page) and the server's emails (the setup
+ * reminder, "you were paged without a notification rule"). The server cannot
+ * import dashboard code, so this lives in Common for both.
+ *
+ * The page used to be four pages, one per kind, at
+ * `user-settings/incident-on-call-rules` and its three siblings. Those
+ * addresses still work: they forward to the tab they named
+ * (MOVED_ON_CALL_RULES_PATHS).
+ */
+var OnCallRuleKind;
+(function (OnCallRuleKind) {
+    OnCallRuleKind["Incidents"] = "incidents";
+    OnCallRuleKind["IncidentEpisodes"] = "incident-episodes";
+    OnCallRuleKind["Alerts"] = "alerts";
+    OnCallRuleKind["AlertEpisodes"] = "alert-episodes";
+})(OnCallRuleKind || (OnCallRuleKind = {}));
+// In tab order. The first is the tab a bare address opens.
+export const ON_CALL_RULE_KINDS = [
+    OnCallRuleKind.Incidents,
+    OnCallRuleKind.IncidentEpisodes,
+    OnCallRuleKind.Alerts,
+    OnCallRuleKind.AlertEpisodes,
+];
+export const DEFAULT_ON_CALL_RULE_KIND = OnCallRuleKind.Incidents;
+// The query parameter that names the open tab.
+export const ON_CALL_RULE_KIND_QUERY_PARAM = "type";
+/*
+ * The page's last path segment: `user-settings/on-call-rules` for your own,
+ * `users/<id>/on-call-rules` for a member's.
+ */
+export const ON_CALL_RULES_PAGE_PATH = "on-call-rules";
+/*
+ * The four pages the tabs replaced, by the last part of their address (the
+ * same in User Settings and under Users > (a member)), and the tab each one
+ * forwards to.
+ */
+export const MOVED_ON_CALL_RULES_PATHS = {
+    "incident-on-call-rules": OnCallRuleKind.Incidents,
+    "incident-episode-on-call-rules": OnCallRuleKind.IncidentEpisodes,
+    "alert-on-call-rules": OnCallRuleKind.Alerts,
+    "alert-episode-on-call-rules": OnCallRuleKind.AlertEpisodes,
+};
+const RULE_TYPE_BY_KIND = {
+    [OnCallRuleKind.Incidents]: NotificationRuleType.ON_CALL_EXECUTED_INCIDENT,
+    [OnCallRuleKind.IncidentEpisodes]: NotificationRuleType.ON_CALL_EXECUTED_INCIDENT_EPISODE,
+    [OnCallRuleKind.Alerts]: NotificationRuleType.ON_CALL_EXECUTED_ALERT,
+    [OnCallRuleKind.AlertEpisodes]: NotificationRuleType.ON_CALL_EXECUTED_ALERT_EPISODE,
+};
+// The rule type every rule on a kind's tab has.
+export const getRuleTypeForOnCallRuleKind = (kind) => {
+    return RULE_TYPE_BY_KIND[kind];
+};
+/*
+ * The tab a rule of this type is on. The two shift rule types ("when I go on
+ * call", "when I go off call") have no tab of their own and are not paged
+ * for an event, so a link about one opens the first tab, as a bare address
+ * does.
+ */
+export const getOnCallRuleKindForRuleType = (ruleType) => {
+    for (const kind of ON_CALL_RULE_KINDS) {
+        if (RULE_TYPE_BY_KIND[kind] === ruleType) {
+            return kind;
+        }
+    }
+    return DEFAULT_ON_CALL_RULE_KIND;
+};
+/*
+ * The tab an address asks for, or null when it asks for none we have: no
+ * parameter, an empty one, or a kind this build does not know (a link from
+ * a newer server, or one typed by hand). Case and surrounding spaces are
+ * forgiven, since people type and paste these.
+ */
+export const readOnCallRuleKind = (value) => {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const normalized = value.trim().toLowerCase();
+    for (const kind of ON_CALL_RULE_KINDS) {
+        if (kind === normalized) {
+            return kind;
+        }
+    }
+    return null;
+};
+/*
+ * The query that opens the page on a kind's tab: { type: "alerts" }, and
+ * nothing for the first tab, whose address is the bare one - the address the
+ * page itself shows once that tab is open.
+ */
+export const getOnCallRuleKindQuery = (kind) => {
+    if (kind === DEFAULT_ON_CALL_RULE_KIND) {
+        return {};
+    }
+    return { [ON_CALL_RULE_KIND_QUERY_PARAM]: kind };
+};
+// The query that opens the page on the tab holding a rule type's rules.
+export const getOnCallRuleKindQueryForRuleType = (ruleType) => {
+    return getOnCallRuleKindQuery(getOnCallRuleKindForRuleType(ruleType));
+};
+// Whether a value is one of the rule types this build knows.
+export const isKnownNotificationRuleType = (value) => {
+    return Object.values(NotificationRuleType).includes(value);
+};
+/*
+ * Where somebody fixes a missing rule of this type, for a link built outside
+ * the dashboard (the server's emails): their own On-Call Rules page in the
+ * project, on the tab that holds the rule type. Null for a rule type this
+ * build has never heard of, which the caller sends to Notification Methods -
+ * the one page that matters for every gap there could ever be.
+ */
+export const getUserSettingsOnCallRulesLink = (data) => {
+    if (!isKnownNotificationRuleType(data.ruleType)) {
+        return null;
+    }
+    return {
+        path: `/${data.projectId}/user-settings/${ON_CALL_RULES_PAGE_PATH}`,
+        query: getOnCallRuleKindQueryForRuleType(data.ruleType),
+    };
+};
+export default OnCallRuleKind;
+//# sourceMappingURL=OnCallRuleKind.js.map

package/build/dist/Types/NotificationRule/OnCallRuleKind.js.map

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

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

@@ -1,6 +1,6 @@
 import BadDataException from "../Exception/BadDataException";
-import { ObjectType } from "../JSON";
 import ObjectID from "../ObjectID";
+import { readMiscDataId } from "./MiscDataId";
 /*
  * The misc data keys, in the order a rule's card lists its responders. They
  * are an escalation rule's own (OnCallDutyPolicyEscalationRuleService
@@ -26,27 +26,6 @@ export const countFirstResponders = (ids) => {
         return count + ids[key].length;
     }, 0);
 };
-/*
- * The id one entry of a list names: a string (what the dashboard sends), an
- * ObjectID (what the API's deserializer makes of { _type: "ObjectID" }), or
- * that JSON itself when a caller inside the server passes it on.
- */
-const readId = (entry) => {
-    if (typeof entry === "string") {
-        return entry.trim() || null;
-    }
-    if (entry instanceof ObjectID) {
-        return entry.toString().trim() || null;
-    }
-    if (entry && typeof entry === "object" && !Array.isArray(entry)) {
-        const record = entry;
-        if (record["_type"] === ObjectType.ObjectID &&
-            typeof record["value"] === "string") {
-            return record["value"].trim() || null;
-        }
-    }
-    return null;
-};
 /**
  * Who a policy create asks to page first, read from its misc data.
  *
@@ -72,7 +51,7 @@ export const readFirstResponderIds = (miscDataProps) => {
             throw new BadDataException(`${key} must be a list of ${RESPONDER_NAMES[key]} ids.`);
         }
         for (const entry of value) {
-            const id = readId(entry);
+            const id = readMiscDataId(entry);
             if (!id || !ObjectID.isValidUUID(id)) {
                 throw new BadDataException(`${key} must be a list of ${RESPONDER_NAMES[key]} ids. ${JSON.stringify(entry instanceof ObjectID ? entry.toString() : entry)} is not one.`);
             }

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

@@ -1 +1 @@
-{"version":3,"file":"FirstResponders.js","sourceRoot":"","sources":["../../../../Types/OnCallDutyPolicy/FirstResponders.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"FirstResponders.js","sourceRoot":"","sources":["../../../../Types/OnCallDutyPolicy/FirstResponders.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,+BAA+B,CAAC;AAE7D,OAAO,QAAQ,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAoC9C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA6B;IAC5D,iBAAiB;IACjB,OAAO;IACP,OAAO;CACR,CAAC;AAEF,0DAA0D;AAC1D,MAAM,eAAe,GAAsC;IACzD,eAAe,EAAE,kBAAkB;IACnC,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,MAAM;CACd,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GACpC,GAAsB,EAAE;IACtB,OAAO,EAAE,eAAe,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACvD,CAAC,CAAC;AAEJ,MAAM,CAAC,MAAM,oBAAoB,GAAuC,CACtE,GAAsB,EACd,EAAE;IACV,OAAO,oBAAoB,CAAC,MAAM,CAChC,CAAC,KAAa,EAAE,GAAsB,EAAU,EAAE;QAChD,OAAO,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,CAAC,EACD,CAAC,CACF,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAEF,CAC9B,aAA4C,EAClB,EAAE;IAC5B,IACE,CAAC,aAAa;QACd,OAAO,aAAa,KAAK,QAAQ;QACjC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAC5B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAsB,yBAAyB,EAAE,CAAC;IAE3D,KAAK,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;QACvC,MAAM,KAAK,GAAY,aAAa,CAAC,GAAG,CAAC,CAAC;QAE1C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,SAAS;QACX,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,gBAAgB,CACxB,GAAG,GAAG,sBAAsB,eAAe,CAAC,GAAG,CAAC,OAAO,CACxD,CAAC;QACJ,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;YAC1B,MAAM,EAAE,GAAkB,cAAc,CAAC,KAAK,CAAC,CAAC;YAEhD,IAAI,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;gBACrC,MAAM,IAAI,gBAAgB,CACxB,GAAG,GAAG,sBAAsB,eAAe,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,SAAS,CACrE,KAAK,YAAY,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CACrD,cAAc,CAChB,CAAC;YACJ,CAAC;YAED,MAAM,UAAU,GAAW,EAAE,CAAC,WAAW,EAAE,CAAC;YAE5C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBACnC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACpD,CAAC,CAAC"}

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

@@ -0,0 +1,30 @@
+import { ObjectType } from "../JSON";
+import ObjectID from "../ObjectID";
+/*
+ * The id one entry of a list of ids in a create request's misc data names:
+ * a string (what the dashboard sends), an ObjectID (what the API's
+ * deserializer makes of { _type: "ObjectID" }), or that JSON itself when a
+ * caller inside the server passes it on. Null for anything else, and for an
+ * empty string.
+ *
+ * Shared by the readers of what a create form asks along with the record:
+ * who a new on-call policy pages first (FirstResponders) and who takes turns
+ * in a new on-call schedule (ScheduleFirstLayer).
+ */
+export const readMiscDataId = (entry) => {
+    if (typeof entry === "string") {
+        return entry.trim() || null;
+    }
+    if (entry instanceof ObjectID) {
+        return entry.toString().trim() || null;
+    }
+    if (entry && typeof entry === "object" && !Array.isArray(entry)) {
+        const record = entry;
+        if (record["_type"] === ObjectType.ObjectID &&
+            typeof record["value"] === "string") {
+            return record["value"].trim() || null;
+        }
+    }
+    return null;
+};
+//# sourceMappingURL=MiscDataId.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MiscDataId.js","sourceRoot":"","sources":["../../../../Types/OnCallDutyPolicy/MiscDataId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,UAAU,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,QAAQ,MAAM,aAAa,CAAC;AAEnC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,cAAc,GAAsC,CAC/D,KAAc,EACC,EAAE;IACjB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;IAC9B,CAAC;IAED,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;IACzC,CAAC;IAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,MAAM,GAAe,KAAmB,CAAC;QAE/C,IACE,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,CAAC,QAAQ;YACvC,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,QAAQ,EACnC,CAAC;YACD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;QACxC,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

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

@@ -0,0 +1,113 @@
+import EventInterval from "../Events/EventInterval";
+import Recurring from "../Events/Recurring";
+import BadDataException from "../Exception/BadDataException";
+import ObjectID from "../ObjectID";
+import { readMiscDataId } from "./MiscDataId";
+import { getDefaultLayerRotation } from "./ScheduleLayerDefaults";
+/*
+ * WHO TAKES TURNS.
+ *
+ * A new on-call schedule used to cover nobody: Create On-Call Schedule asked
+ * for a name, a time zone and a description, and the schedule only put
+ * anyone on call once a layer had been added on its Layers page and people
+ * added to it one at a time. A policy that escalated to it paged no one
+ * meanwhile. Now the create form also asks "Who takes turns?", with the
+ * people picker.
+ *
+ * The picks travel with the create as misc data: the people under
+ * firstLayerUsers (user ids, in the order they take turns) and, when the form
+ * says how long each turn lasts, that rotation under firstLayerRotation (a
+ * Recurring, as a layer's own rotation is written). The server reads them
+ * here and, once the schedule exists, adds its first layer - "Layer 1", on
+ * call from now, handing off once per rotation - with those people in that
+ * order (OnCallDutyPolicyScheduleService.create).
+ *
+ * Nobody picked, or nothing sent (an API caller, Terraform, an import): no
+ * layer, exactly as before.
+ *
+ * React-free and server-safe: the server, the dashboard and their tests read
+ * it.
+ */
+export const SCHEDULE_FIRST_LAYER_USERS_KEY = "firstLayerUsers";
+export const SCHEDULE_FIRST_LAYER_ROTATION_KEY = "firstLayerRotation";
+const EVENT_INTERVALS = Object.values(EventInterval);
+/*
+ * The rotation the create asks the first layer to hand off on. Not sent:
+ * the default, a week. Anything sent that is not a rotation of whole,
+ * positive intervals is refused rather than replaced: the caller asked for
+ * a rotation, and a layer that silently hands off on another one would page
+ * the wrong person.
+ */
+export const readScheduleFirstLayerRotation = (value) => {
+    var _a;
+    if (value === undefined || value === null) {
+        return getDefaultLayerRotation();
+    }
+    const invalid = new BadDataException(`${SCHEDULE_FIRST_LAYER_ROTATION_KEY} must be a rotation: how many hours, days, weeks, months or years each turn lasts.`);
+    if (typeof value !== "object" || Array.isArray(value)) {
+        throw invalid;
+    }
+    let rotation;
+    try {
+        rotation =
+            value instanceof Recurring
+                ? value
+                : Recurring.fromJSON(value);
+    }
+    catch (_b) {
+        throw invalid;
+    }
+    const count = (_a = rotation.intervalCount) === null || _a === void 0 ? void 0 : _a.toNumber();
+    if (!EVENT_INTERVALS.includes(rotation.intervalType) ||
+        typeof count !== "number" ||
+        !Number.isInteger(count) ||
+        count < 1) {
+        throw invalid;
+    }
+    // A copy of its own: the caller's value is left alone.
+    return Recurring.fromJSON(rotation.toJSON());
+};
+/**
+ * Who takes turns in a new schedule, and how long each turn lasts, read from
+ * the create's misc data.
+ *
+ * Returns null when there is nobody: no misc data, no firstLayerUsers, or an
+ * empty list - the schedule is created without layers, as before. Each
+ * person is listed once (compared without case), in the order sent. A list
+ * that holds something other than user ids is refused rather than skipped,
+ * and so is a rotation that is not one (readScheduleFirstLayerRotation): a
+ * caller who asked for people to take turns must not get a schedule that
+ * silently covers nobody.
+ */
+export const readScheduleFirstLayer = (miscDataProps) => {
+    if (!miscDataProps ||
+        typeof miscDataProps !== "object" ||
+        Array.isArray(miscDataProps)) {
+        return null;
+    }
+    // Checked even with nobody to put in the layer: a bad value is a mistake.
+    const rotation = readScheduleFirstLayerRotation(miscDataProps[SCHEDULE_FIRST_LAYER_ROTATION_KEY]);
+    const value = miscDataProps[SCHEDULE_FIRST_LAYER_USERS_KEY];
+    if (value === undefined || value === null) {
+        return null;
+    }
+    if (!Array.isArray(value)) {
+        throw new BadDataException(`${SCHEDULE_FIRST_LAYER_USERS_KEY} must be a list of user ids.`);
+    }
+    const userIds = [];
+    for (const entry of value) {
+        const id = readMiscDataId(entry);
+        if (!id || !ObjectID.isValidUUID(id)) {
+            throw new BadDataException(`${SCHEDULE_FIRST_LAYER_USERS_KEY} must be a list of user ids. ${JSON.stringify(entry instanceof ObjectID ? entry.toString() : entry)} is not one.`);
+        }
+        const normalized = id.toLowerCase();
+        if (!userIds.includes(normalized)) {
+            userIds.push(normalized);
+        }
+    }
+    if (userIds.length === 0) {
+        return null;
+    }
+    return { userIds, rotation };
+};
+//# sourceMappingURL=ScheduleFirstLayer.js.map

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

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

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

@@ -0,0 +1,95 @@
+import OnCallDutyPolicyScheduleLayer from "../../Models/DatabaseModels/OnCallDutyPolicyScheduleLayer";
+import OneUptimeDate from "../Date";
+import EventInterval from "../Events/EventInterval";
+import Recurring from "../Events/Recurring";
+import PositiveNumber from "../PositiveNumber";
+import RestrictionTimes from "./RestrictionTimes";
+/*
+ * A NEW LAYER OF AN ON-CALL SCHEDULE, AS IT STARTS.
+ *
+ * One builder for every layer OneUptime adds on someone's behalf, so they
+ * all start the same way:
+ *
+ *   - the first layer of a schedule created with "Who takes turns?"
+ *     (OnCallDutyPolicyScheduleService.create), and
+ *   - a layer added with "Add Layer" on a schedule's Layers page.
+ *
+ * A new layer:
+ *
+ *   - is on call from now: the first person in it is on call at once;
+ *   - hands off once a week, the rotation most on-call teams run, unless the
+ *     caller picks another;
+ *   - hands off for the first time one rotation after it starts, at the same
+ *     time of day in the schedule's time zone;
+ *   - is on call around the clock (no restriction times).
+ *
+ * Everything can be changed on the layer afterwards. A layer created through
+ * the API with no rotation still gets its column's own default (a day), as it
+ * always did: this is what the product picks, not the API contract.
+ *
+ * Server-safe and React-free: the server, the dashboard and their tests use it.
+ */
+// How long each turn of a new layer lasts, unless someone picks another.
+export const DEFAULT_LAYER_ROTATION_INTERVAL_TYPE = EventInterval.Week;
+export const DEFAULT_LAYER_ROTATION_INTERVAL_COUNT = 1;
+export const getDefaultLayerRotation = () => {
+    const rotation = new Recurring();
+    rotation.intervalType = DEFAULT_LAYER_ROTATION_INTERVAL_TYPE;
+    rotation.intervalCount = new PositiveNumber(DEFAULT_LAYER_ROTATION_INTERVAL_COUNT);
+    return rotation;
+};
+// "Layer 2": the name a layer is given after its place in the schedule.
+export const getLayerName = (position) => {
+    return `Layer ${position}`;
+};
+/*
+ * The name of a layer added at `order`: "Layer <order>", or the next number
+ * up that no layer of the schedule is called yet. The order alone is not
+ * enough: deleting a layer in the middle moves the ones below it up but
+ * leaves their names, so "Layer 3" can still exist on a schedule of two.
+ */
+export const getNewLayerName = (data) => {
+    const taken = new Set(data.existingNames);
+    let position = Math.max(1, Math.floor(data.order) || 1);
+    while (taken.has(getLayerName(position))) {
+        position++;
+    }
+    return getLayerName(position);
+};
+/*
+ * When a layer that starts at `startsAt` first hands off: one rotation
+ * later, counted in calendar units in the schedule's time zone, so a weekly
+ * layer started on a Tuesday at 14:30 hands off the next Tuesday at 14:30 -
+ * across a daylight saving change too. Hourly rotations are counted in
+ * absolute hours, as the layer engine counts them.
+ */
+export const getFirstHandOffTime = (data) => {
+    const rotation = Recurring.fromJSON(data.rotation);
+    const count = Math.max(1, Math.floor(rotation.intervalCount.toNumber()) || 1);
+    return OneUptimeDate.addRemoveCalendarUnits(data.startsAt, Recurring.toCalendarUnit(rotation.intervalType), count, data.timezone || undefined);
+};
+// A new layer, ready to be created (see the note at the top).
+export const buildNewScheduleLayer = (data) => {
+    const startsAt = data.startsAt || OneUptimeDate.getCurrentDate();
+    // A copy: the layer must not share a rotation the caller may change.
+    const rotation = data.rotation
+        ? Recurring.fromJSON(Recurring.fromJSON(data.rotation).toJSON())
+        : getDefaultLayerRotation();
+    const layer = new OnCallDutyPolicyScheduleLayer();
+    layer.onCallDutyPolicyScheduleId = data.onCallDutyPolicyScheduleId;
+    layer.projectId = data.projectId;
+    layer.name = data.name;
+    if (data.order !== undefined) {
+        layer.order = data.order;
+    }
+    layer.startsAt = startsAt;
+    layer.rotation = rotation;
+    layer.handOffTime = getFirstHandOffTime({
+        startsAt: startsAt,
+        rotation: rotation,
+        timezone: data.timezone,
+    });
+    layer.restrictionTimes = RestrictionTimes.getDefault();
+    return layer;
+};
+//# sourceMappingURL=ScheduleLayerDefaults.js.map

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

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

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

@@ -0,0 +1,99 @@
+import OneUptimeDate from "../Date";
+/*
+ * "GET COVER" OPENS ADD USER OVERRIDE WITH THE SHIFT FILLED IN.
+ *
+ * An upcoming shift's "Get cover" link (User Settings > Calendar Feed)
+ * opens the User Overrides page with Add User Override already open: you as
+ * the person away, and the shift's window as when - so the one thing left to
+ * answer is who covers. The window travels as two query parameters on the
+ * page's address, written here by the link and read back here by the page.
+ *
+ * A shift that has already started is covered from now: the pages that
+ * matter are the ones still to come. A window that has ended, or whose end
+ * is not after its start, asks for nothing.
+ *
+ * Pure: the calendar feed card, the User Overrides table, the Add User
+ * Override form and their tests share it.
+ */
+export const USER_OVERRIDE_COVER_STARTS_AT_PARAM = "coverStartsAt";
+export const USER_OVERRIDE_COVER_ENDS_AT_PARAM = "coverEndsAt";
+/*
+ * A time as a form, a link or a shift holds it - a Date, or the ISO string
+ * a date input writes - or null when it is not a real instant yet: empty,
+ * half typed, or not a time at all. The one reader of override times, so
+ * the link, the page and the form's own checks agree on what a time is.
+ */
+export const toUserOverrideTime = (value) => {
+    if (value instanceof Date) {
+        return Number.isNaN(value.getTime()) ? null : value;
+    }
+    if (typeof value !== "string" || !value.trim()) {
+        return null;
+    }
+    // Half-typed text is not a time yet (and would only make moment warn).
+    if (Number.isNaN(Date.parse(value))) {
+        return null;
+    }
+    let date;
+    try {
+        date = OneUptimeDate.fromString(value);
+    }
+    catch (_a) {
+        return null;
+    }
+    return Number.isNaN(date.getTime()) ? null : date;
+};
+/*
+ * The window to cover for a shift from `start` to `end`, as of `now`: from
+ * the start, or from now once it has started, to the end. Null when either
+ * time is not a real one, when the end is not after the start, or when the
+ * shift has ended.
+ */
+export const getUserOverrideCoverWindow = (data) => {
+    const start = toUserOverrideTime(data.start);
+    const end = toUserOverrideTime(data.end);
+    if (!start || !end) {
+        return null;
+    }
+    if (end.getTime() <= start.getTime()) {
+        return null;
+    }
+    if (end.getTime() <= data.now.getTime()) {
+        return null;
+    }
+    return {
+        startsAt: start.getTime() < data.now.getTime() ? new Date(data.now) : start,
+        endsAt: end,
+    };
+};
+// The query parameters that ask the User Overrides page to cover a window.
+export const getUserOverrideCoverQueryParams = (window) => {
+    return {
+        [USER_OVERRIDE_COVER_STARTS_AT_PARAM]: encodeURIComponent(OneUptimeDate.toString(window.startsAt)),
+        [USER_OVERRIDE_COVER_ENDS_AT_PARAM]: encodeURIComponent(OneUptimeDate.toString(window.endsAt)),
+    };
+};
+/*
+ * The window a page's address asks to cover, read with `getParam` (one
+ * query parameter's value by name, or null) as of `now`: a link opened an
+ * hour after it was made covers from then. Null when the address asks for
+ * nothing usable, and the page then opens as it always does.
+ */
+export const readUserOverrideCoverRequest = (data) => {
+    return getUserOverrideCoverWindow({
+        start: data.getParam(USER_OVERRIDE_COVER_STARTS_AT_PARAM),
+        end: data.getParam(USER_OVERRIDE_COVER_ENDS_AT_PARAM),
+        now: data.now,
+    });
+};
+// Whether a page's address carries any part of a cover request.
+export const hasUserOverrideCoverParams = (getParam) => {
+    return [
+        USER_OVERRIDE_COVER_STARTS_AT_PARAM,
+        USER_OVERRIDE_COVER_ENDS_AT_PARAM,
+    ].some((name) => {
+        const value = getParam(name);
+        return value !== null && value !== undefined;
+    });
+};
+//# sourceMappingURL=UserOverrideCoverRequest.js.map

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

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