@oneuptime/common 12.0.28 → 12.0.30

package/build/dist/Types/API/Route.js.map

@@ -1 +1 @@
-{"version":3,"file":"Route.js","sourceRoot":"","sources":["../../../../Types/API/Route.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,8BAA8B,CAAC;AAE5D,OAAO,gBAAgB,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAc,UAAU,EAAE,MAAM,SAAS,CAAC;AAGjD,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,gBAAgB;IAEjD,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IACD,IAAW,KAAK,CAAC,CAAS;QACxB,MAAM,oBAAoB,GACxB,uCAAuC,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,gBAAgB,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,YAAmB,KAAsB;QACvC,KAAK,EAAE,CAAC;QAdF,WAAM,GAAW,EAAE,CAAC;QAe1B,IAAI,KAAK,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YACpC,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC3B,CAAC;QAED,KAAK,GAAG,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,mEAAmE;QAExG,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;IAEe,MAAM;QACpB,OAAO;YACL,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,KAAK,EAAG,IAAc,CAAC,QAAQ,EAAE;SAClC,CAAC;IACJ,CAAC;IAEM,MAAM,CAAU,QAAQ,CAAC,IAAgB;QAC9C,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,UAAU,CAAC,KAAK,EAAE,CAAC;YACvC,OAAO,IAAI,KAAK,CAAE,IAAI,CAAC,OAAO,CAAY,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,IAAI,gBAAgB,CAAC,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACtE,CAAC;IAEM,QAAQ,CAAC,KAAqB;QACnC,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAEzB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,KAAK,GAAG,GAAG,GAAG,KAAK,CAAC;QACtB,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QAED,IAAI,cAAc,GAAW,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC9C,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACtE,cAAc,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,iCAAiC;QACxF,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,cAAc,CAAC,CAAC,KAAK,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IAEe,QAAQ;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAEM,MAAM,CAAC,UAAU,CAAC,KAAa;QACpC,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAEM,aAAa,CAAC,SAAiB,EAAE,KAAa;QACnD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,MAAM,CAAU,UAAU,CAC/B,KAAkC;QAElC,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;YAED,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC1B,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEM,MAAM,CAAU,YAAY,CAAC,MAAc;QAChD,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,cAAc,CAAC,WAA+B;QACnD,oEAAoE;QAEpE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC;QACpB,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,IAAI,GAAG,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;QAC9C,CAAC;QAED,4BAA4B;QAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAE5D,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
+{"version":3,"file":"Route.js","sourceRoot":"","sources":["../../../../Types/API/Route.ts"],"names":[],"mappings":"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"}

package/build/dist/Types/Calendar/ICalendar.js

@@ -0,0 +1,290 @@
+import BadDataException from "../Exception/BadDataException";
+/*
+ * Zero-dependency RFC 5545 (iCalendar) serializer for subscription feeds.
+ *
+ * Deliberate choices, recorded here because every one of them was a
+ * decision, not an omission:
+ *
+ * - No METHOD. RFC 5546 (iTIP) would require ORGANIZER on a PUBLISH, and
+ *   subscription feeds are not iTIP messages; Google, Apple and Outlook all
+ *   treat a METHOD-less VCALENDAR as a plain calendar, which is what we are.
+ * - DTSTAMP = the feed input's last-modified instant, not "now". Without
+ *   METHOD, RFC 5545 §3.8.7.2 reads DTSTAMP as the last revision, and using
+ *   it makes an unchanged schedule serialize to a byte-identical body so ETags
+ *   and body caches work.
+ * - No VTIMEZONE and no TZID. Every DTSTART/DTEND is an absolute UTC instant
+ *   ("...Z"). The engine already resolves wall-clock rules into instants, the
+ *   client converts to the viewer's zone, and shipping a VTIMEZONE database
+ *   would lag IANA. Wall-clock renderings go in DESCRIPTION instead.
+ * - No VALARM (reminders are delivered by OneUptime's own notification path so
+ *   they honour the user's notification settings), no RRULE (shifts are
+ *   materialised individually so overrides and rotations never desynchronise),
+ *   no CLASS (Outlook maps CLASS:PRIVATE to Private sensitivity and Google to
+ *   private visibility, which blanks a shared team calendar for everyone but
+ *   its owner), no ORGANIZER/ATTENDEE.
+ * - Both REFRESH-INTERVAL;VALUE=DURATION (RFC 7986) and X-PUBLISHED-TTL are
+ *   emitted from the same duration: classic Outlook honours X-PUBLISHED-TTL
+ *   when "Update Limit" is on and never refreshes a feed without it.
+ * - Property order inside VCALENDAR and VEVENT is fixed so equal inputs give
+ *   equal bytes.
+ *
+ * Wire format: CRLF line breaks, content lines folded at 75 octets on UTF-8
+ * character boundaries (RFC 5545 §3.1), TEXT values escaped per §3.3.11.
+ */
+export const ICALENDAR_LINE_BREAK = "\r\n";
+// RFC 5545 §3.1: lines SHOULD NOT be longer than 75 octets, excluding CRLF.
+export const ICALENDAR_MAX_LINE_OCTETS = 75;
+export const ICALENDAR_VERSION = "2.0";
+export var ICalendarEventStatus;
+(function (ICalendarEventStatus) {
+    ICalendarEventStatus["Confirmed"] = "CONFIRMED";
+    ICalendarEventStatus["Tentative"] = "TENTATIVE";
+    ICalendarEventStatus["Cancelled"] = "CANCELLED";
+})(ICalendarEventStatus || (ICalendarEventStatus = {}));
+export var ICalendarTransparency;
+(function (ICalendarTransparency) {
+    ICalendarTransparency["Transparent"] = "TRANSPARENT";
+    ICalendarTransparency["Opaque"] = "OPAQUE";
+})(ICalendarTransparency || (ICalendarTransparency = {}));
+const ISO_8601_DURATION_REGEX = /^P(?:\d+W|(?:\d+D)?(?:T(?:\d+H)?(?:\d+M)?(?:\d+S)?)?)$/;
+// RFC 5545 §3.2: a parameter value holding any of these must be quoted.
+const RESERVED_PARAMETER_CHARACTERS = /[;:,]/;
+export default class ICalendar {
+    static serialize(document) {
+        const lines = [];
+        lines.push("BEGIN:VCALENDAR");
+        lines.push(`VERSION:${ICALENDAR_VERSION}`);
+        lines.push(ICalendar.contentLine("PRODID", document.calendar.productId));
+        lines.push("CALSCALE:GREGORIAN");
+        const calendar = document.calendar;
+        if (calendar.name !== undefined && calendar.name !== "") {
+            lines.push(ICalendar.textLine("NAME", calendar.name));
+        }
+        const displayName = calendar.displayName !== undefined && calendar.displayName !== ""
+            ? calendar.displayName
+            : calendar.name;
+        if (displayName !== undefined && displayName !== "") {
+            lines.push(ICalendar.textLine("X-WR-CALNAME", displayName));
+        }
+        if (calendar.description !== undefined && calendar.description !== "") {
+            lines.push(ICalendar.textLine("X-WR-CALDESC", calendar.description));
+        }
+        if (calendar.timezone !== undefined && calendar.timezone !== "") {
+            lines.push(ICalendar.textLine("X-WR-TIMEZONE", calendar.timezone));
+        }
+        if (calendar.refreshInterval !== undefined) {
+            const duration = ICalendar.validateDuration(calendar.refreshInterval);
+            lines.push(ICalendar.contentLine("REFRESH-INTERVAL", duration, {
+                VALUE: "DURATION",
+            }));
+            lines.push(ICalendar.contentLine("X-PUBLISHED-TTL", duration));
+        }
+        if (calendar.lastModified !== undefined) {
+            lines.push(ICalendar.contentLine("LAST-MODIFIED", ICalendar.formatUtcDateTime(calendar.lastModified)));
+        }
+        for (const event of document.events) {
+            lines.push(...ICalendar.serializeEvent(event));
+        }
+        lines.push("END:VCALENDAR");
+        return (lines
+            .map((line) => {
+            return ICalendar.foldLine(line);
+        })
+            .join(ICALENDAR_LINE_BREAK) + ICALENDAR_LINE_BREAK);
+    }
+    /*
+     * The unfolded content lines of one VEVENT, in the fixed order. Exposed so
+     * tests and callers can inspect a single event without a whole document.
+     */
+    static serializeEvent(event) {
+        if (!event.uid || event.uid.trim() === "") {
+            throw new BadDataException("iCalendar event UID must not be empty");
+        }
+        if (event.end.getTime() <= event.start.getTime()) {
+            throw new BadDataException(`iCalendar event ${event.uid} must end after it starts`);
+        }
+        const lines = [];
+        lines.push("BEGIN:VEVENT");
+        lines.push(ICalendar.textLine("UID", event.uid));
+        lines.push(ICalendar.contentLine("DTSTAMP", ICalendar.formatUtcDateTime(event.dtStamp)));
+        if (event.lastModified !== undefined) {
+            lines.push(ICalendar.contentLine("LAST-MODIFIED", ICalendar.formatUtcDateTime(event.lastModified)));
+        }
+        if (event.sequence !== undefined) {
+            lines.push(ICalendar.contentLine("SEQUENCE", String(ICalendar.validateSequence(event.sequence))));
+        }
+        lines.push(ICalendar.contentLine("DTSTART", ICalendar.formatUtcDateTime(event.start)));
+        lines.push(ICalendar.contentLine("DTEND", ICalendar.formatUtcDateTime(event.end)));
+        lines.push(ICalendar.textLine("SUMMARY", event.summary));
+        if (event.description !== undefined && event.description !== "") {
+            lines.push(ICalendar.textLine("DESCRIPTION", event.description));
+        }
+        if (event.location !== undefined && event.location !== "") {
+            lines.push(ICalendar.textLine("LOCATION", event.location));
+        }
+        if (event.url !== undefined && event.url !== "") {
+            // URI value type: not TEXT-escaped, but never allowed to break the line.
+            lines.push(ICalendar.contentLine("URL", ICalendar.stripLineBreaks(event.url)));
+        }
+        if (event.status !== undefined) {
+            lines.push(ICalendar.contentLine("STATUS", event.status));
+        }
+        if (event.transparency !== undefined) {
+            lines.push(ICalendar.contentLine("TRANSP", event.transparency));
+        }
+        if (event.categories !== undefined && event.categories.length > 0) {
+            lines.push(ICalendar.contentLine("CATEGORIES", event.categories
+                .map((category) => {
+                return ICalendar.escapeText(category);
+            })
+                .join(",")));
+        }
+        lines.push("END:VEVENT");
+        return lines;
+    }
+    /*
+     * RFC 5545 §3.3.11 TEXT escaping: backslash, semicolon and comma are
+     * escaped; a newline becomes the two characters "\n"; carriage returns and
+     * other control characters (which TEXT may not contain) are dropped.
+     */
+    static escapeText(text) {
+        let result = "";
+        for (const char of text) {
+            if (char === "\\") {
+                result += "\\\\";
+            }
+            else if (char === ";") {
+                result += "\\;";
+            }
+            else if (char === ",") {
+                result += "\\,";
+            }
+            else if (char === "\n") {
+                result += "\\n";
+            }
+            else if (char === "\t") {
+                result += char;
+            }
+            else if (ICalendar.isControlCharacter(char)) {
+                continue;
+            }
+            else {
+                result += char;
+            }
+        }
+        return result;
+    }
+    // "YYYYMMDDTHHMMSSZ" — RFC 5545 §3.3.5 form #2, UTC.
+    static formatUtcDateTime(date) {
+        if (!(date instanceof Date) || Number.isNaN(date.getTime())) {
+            throw new BadDataException("iCalendar date is not a valid Date");
+        }
+        const pad = (value) => {
+            return value < 10 ? `0${value}` : String(value);
+        };
+        return (`${date.getUTCFullYear()}${pad(date.getUTCMonth() + 1)}${pad(date.getUTCDate())}` +
+            `T${pad(date.getUTCHours())}${pad(date.getUTCMinutes())}${pad(date.getUTCSeconds())}Z`);
+    }
+    /*
+     * Fold one logical content line at 75 octets (RFC 5545 §3.1). The
+     * continuation lines start with a single space that counts toward their
+     * own 75-octet budget. Never splits inside a UTF-8 multi-byte sequence:
+     * the walk is per code point and each code point's octet length is known.
+     */
+    static foldLine(line) {
+        if (ICalendar.getUtf8OctetLength(line) <= ICALENDAR_MAX_LINE_OCTETS) {
+            return line;
+        }
+        const pieces = [];
+        let current = "";
+        let currentOctets = 0;
+        // The first physical line has the full budget; continuations lose one to the leading space.
+        let budget = ICALENDAR_MAX_LINE_OCTETS;
+        for (const char of line) {
+            const octets = ICalendar.getUtf8OctetLength(char);
+            if (currentOctets + octets > budget) {
+                pieces.push(current);
+                current = "";
+                currentOctets = 0;
+                budget = ICALENDAR_MAX_LINE_OCTETS - 1;
+            }
+            current += char;
+            currentOctets += octets;
+        }
+        if (current !== "") {
+            pieces.push(current);
+        }
+        return pieces.join(`${ICALENDAR_LINE_BREAK} `);
+    }
+    // Reverse of foldLine, for tests and readers: joins continuation lines.
+    static unfold(body) {
+        return body.replace(/\r\n[ \t]/g, "");
+    }
+    static getUtf8OctetLength(text) {
+        var _a;
+        let octets = 0;
+        for (const char of text) {
+            const codePoint = (_a = char.codePointAt(0)) !== null && _a !== void 0 ? _a : 0;
+            if (codePoint < 0x80) {
+                octets += 1;
+            }
+            else if (codePoint < 0x800) {
+                octets += 2;
+            }
+            else if (codePoint < 0x10000) {
+                octets += 3;
+            }
+            else {
+                octets += 4;
+            }
+        }
+        return octets;
+    }
+    /*
+     * "NAME;PARAM=value:value" with the value used verbatim (callers escape
+     * TEXT values themselves or use textLine). Parameter values that contain
+     * characters RFC 5545 §3.2 reserves are quoted; double quotes inside them
+     * are dropped because there is no way to escape them.
+     */
+    static contentLine(name, value, parameters) {
+        var _a;
+        let line = name.toUpperCase();
+        if (parameters) {
+            for (const parameterName of Object.keys(parameters)) {
+                const rawValue = ((_a = parameters[parameterName]) !== null && _a !== void 0 ? _a : "").replace(/"/g, "");
+                const needsQuotes = RESERVED_PARAMETER_CHARACTERS.test(rawValue);
+                line += `;${parameterName.toUpperCase()}=${needsQuotes ? `"${rawValue}"` : rawValue}`;
+            }
+        }
+        return `${line}:${ICalendar.stripLineBreaks(value)}`;
+    }
+    // A TEXT property: the value is escaped per §3.3.11.
+    static textLine(name, value) {
+        return ICalendar.contentLine(name, ICalendar.escapeText(value));
+    }
+    static validateDuration(duration) {
+        const trimmed = duration.trim().toUpperCase();
+        if (!ISO_8601_DURATION_REGEX.test(trimmed) ||
+            trimmed === "P" ||
+            trimmed === "PT") {
+            throw new BadDataException(`iCalendar refresh interval must be an ISO 8601 duration, got "${duration}"`);
+        }
+        return trimmed;
+    }
+    static validateSequence(sequence) {
+        if (!Number.isInteger(sequence) || sequence < 0) {
+            throw new BadDataException(`iCalendar SEQUENCE must be a non-negative integer, got ${sequence}`);
+        }
+        return sequence;
+    }
+    static isControlCharacter(char) {
+        var _a;
+        const codePoint = (_a = char.codePointAt(0)) !== null && _a !== void 0 ? _a : 0;
+        return codePoint < 0x20 || codePoint === 0x7f;
+    }
+    // Line breaks can never appear inside a content line, whatever the value type.
+    static stripLineBreaks(value) {
+        return value.replace(/[\r\n]+/g, "");
+    }
+}
+//# sourceMappingURL=ICalendar.js.map

package/build/dist/Types/Calendar/ICalendar.js.map

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

package/build/dist/Types/Date.js

@@ -135,22 +135,36 @@ class OneUptimeDate {
         date = this.fromString(date);
         return this.getLocalShortMonthName(date);
     }
+    /**
+     * The wall clock `date` reads at in the current timezone - "14:30", or
+     * "2:30 PM" when the caller asks for a 12-hour clock.
+     *
+     * `use12HourFormat` is opt-in rather than defaulted to
+     * `getUserPrefers12HourFormat()`: the chart x-axes in
+     * UI/Components/Charts/Utils/XAxis.ts label ticks with this and are laid out
+     * for the fixed width of a 24-hour reading, so they must keep the clock they
+     * were built against. Surfaces that show a person a timestamp - histogram
+     * ticks and tooltips, span rows - pass
+     * `use12HourFormat: OneUptimeDate.getUserPrefers12HourFormat()` explicitly.
+     */
     static getLocalTimeString(date, options) {
-        var _a, _b;
+        var _a, _b, _c;
         date = this.fromString(date);
         const includeMinutes = (_a = options === null || options === void 0 ? void 0 : options.includeMinutes) !== null && _a !== void 0 ? _a : true;
         const includeSeconds = (_b = options === null || options === void 0 ? void 0 : options.includeSeconds) !== null && _b !== void 0 ? _b : false;
-        const localDate = this.inCurrentTimezone(date);
-        const hours = this.padDatePart(localDate.hours());
-        if (!includeMinutes) {
-            return hours;
+        const use12HourFormat = (_c = options === null || options === void 0 ? void 0 : options.use12HourFormat) !== null && _c !== void 0 ? _c : false;
+        // "HH" and "h" are the zero-padded 24-hour and the bare 12-hour readings.
+        let timeFormat = use12HourFormat ? "h" : "HH";
+        if (includeMinutes) {
+            timeFormat += ":mm";
+            if (includeSeconds) {
+                timeFormat += ":ss";
+            }
         }
-        const minutes = this.padDatePart(localDate.minutes());
-        if (!includeSeconds) {
-            return `${hours}:${minutes}`;
+        if (use12HourFormat) {
+            timeFormat += " A";
         }
-        const seconds = this.padDatePart(localDate.seconds());
-        return `${hours}:${minutes}:${seconds}`;
+        return this.inCurrentTimezone(date).format(timeFormat);
     }
     static getDateAsLocalDayMonthString(date) {
         date = this.fromString(date);
@@ -162,6 +176,29 @@ class OneUptimeDate {
         date = this.fromString(date);
         return `${this.getDateAsLocalDayMonthString(date)}, ${this.getLocalTimeString(date, { includeMinutes: false })}:00`;
     }
+    /**
+     * A compact "Mar 1, 14:30" (or "Mar 1, 2:30 PM") label for one instant, used
+     * where a whole window has to fit on a button - the time range picker above
+     * the metrics, traces and logs explorers, chiefly.
+     *
+     * Both halves follow the user's machine: the wall clock is resolved in the
+     * configured timezone (falling back to the one the browser reports), and the
+     * 12- vs 24-hour choice follows the operating system's clock preference
+     * unless a caller overrides it.
+     */
+    static getDateAsLocalShortDateTimeString(date, options) {
+        var _a;
+        date = this.fromString(date);
+        const use12HourFormat = (_a = options === null || options === void 0 ? void 0 : options.use12HourFormat) !== null && _a !== void 0 ? _a : this.getUserPrefers12HourFormat();
+        let timeFormat = use12HourFormat ? "h:mm" : "HH:mm";
+        if (options === null || options === void 0 ? void 0 : options.includeSeconds) {
+            timeFormat += ":ss";
+        }
+        if (use12HourFormat) {
+            timeFormat += " A";
+        }
+        return this.inCurrentTimezone(date).format(`MMM D, ${timeFormat}`);
+    }
     static getDateAsLocalMonthYearString(date) {
         date = this.fromString(date);
         const month = this.getLocalShortMonthName(date);
@@ -595,6 +632,18 @@ class OneUptimeDate {
         date2 = this.fromString(date2);
         return moment(date1).isSame(date2, "day");
     }
+    /**
+     * Whether the two instants fall on the same calendar day *in the current
+     * timezone*, which is the question a UI is asking when it decides whether a
+     * timestamp needs its date spelled out or a bare clock reading will do.
+     *
+     * `areOnTheSameDay` above answers it in the zone the process happens to run
+     * in. Near midnight those two zones disagree, so asking the wrong one drops
+     * the date from yesterday's buckets and adds it to today's.
+     */
+    static areOnTheSameLocalDay(date1, date2) {
+        return this.inCurrentTimezone(date1).isSame(this.inCurrentTimezone(date2), "day");
+    }
     static areOnTheSameMonth(date1, date2) {
         date1 = this.fromString(date1);
         date2 = this.fromString(date2);
@@ -1034,14 +1083,67 @@ class OneUptimeDate {
     static getCurrentDateAsFormattedString(options) {
         return this.getDateAsFormattedString(new Date(), options);
     }
+    /**
+     * Whether the machine this is running on writes the time of day on a 12-hour
+     * clock, read from the browser's resolved default locale - which browsers
+     * derive from the operating system's language and region, so changing those
+     * changes this. An explicit -u-hc- override on the locale is honoured too.
+     *
+     * Note what this cannot see: the standalone "24-Hour Time" switch macOS and
+     * Windows offer separately from the region. Safari and recent Firefox fold
+     * that into the locale they resolve; Chromium does not. A user who wants a
+     * clock that ignores their region would need an explicit preference stored
+     * alongside the timezone in User Settings - there is none today.
+     *
+     * Asked of Intl rather than inferred from a formatted string. The string
+     * probe below only recognises the Latin "AM"/"PM", so it misread every
+     * 12-hour locale that marks the day period some other way - ko-KR writes
+     * the equivalent of "PM" in Hangul, ar-EG in Arabic script - and served
+     * those users a 24-hour clock against their own convention.
+     */
     static getUserPrefers12HourFormat() {
         if (typeof window === "undefined") {
             // Server-side: default to 12-hour format for user-friendly display
             return true;
         }
-        // Client-side: detect user's preferred time format from browser locale
-        const testDate = new Date();
-        const timeString = testDate.toLocaleTimeString();
+        /*
+         * `hour12` is only reported when the format actually asks for an hour, so
+         * the probe has to request one.
+         */
+        try {
+            /*
+             * Typed structurally rather than as Intl.ResolvedDateTimeFormatOptions:
+             * `hourCycle` only appears on that interface from the ES2021 lib, and
+             * this file has to compile against the older one too.
+             */
+            const resolvedOptions = new Intl.DateTimeFormat(undefined, {
+                hour: "numeric",
+            }).resolvedOptions();
+            if (typeof resolvedOptions.hour12 === "boolean") {
+                return resolvedOptions.hour12;
+            }
+            /*
+             * Older engines report the cycle but not the boolean. h11/h12 are the
+             * two 12-hour cycles; h23/h24 are the 24-hour ones.
+             */
+            if (resolvedOptions.hourCycle) {
+                return (resolvedOptions.hourCycle === "h11" ||
+                    resolvedOptions.hourCycle === "h12");
+            }
+        }
+        catch (_a) {
+            /*
+             * A missing or broken Intl must not take every timestamp in the UI down
+             * with it - fall through to the string probe below.
+             */
+        }
+        /*
+         * Last resort: read a formatted time and look for a day-period marker.
+         * This only recognises the Latin "AM"/"PM" - which is exactly why it is the
+         * fallback and not the primary check, since locales like ko-KR and ar-EG
+         * are 12-hour but mark the day period with characters this cannot see.
+         */
+        const timeString = new Date().toLocaleTimeString();
         return (timeString.toLowerCase().includes("am") ||
             timeString.toLowerCase().includes("pm"));
     }