@oxygen-agent/cli 1.1011.97 → 1.1011.288

package/node_modules/@oxygen/shared/dist/zoned-time.js

@@ -0,0 +1,81 @@
+/**
+ * Wall-clock time in an IANA time zone, converted to instants DST-correctly.
+ *
+ * Publishing's publish-time contract rides on this on every surface: an ISO
+ * date-time with `Z` or an offset is that exact instant, and one without is
+ * wall-clock time in the post's timezone, read with the offset in force at that
+ * local time. 09:00 Europe/Berlin is 07:00Z in October and 08:00Z in December.
+ */
+const DAY_MS = 24 * 60 * 60 * 1000;
+/**
+ * Is `zone` an IANA time zone this runtime resolves (`Europe/Berlin`, `UTC`)?
+ * A bare offset (`+02:00`) is refused although Intl accepts it: it never moves
+ * for daylight saving, so a schedule kept in it drifts an hour for half the year.
+ */
+export function isValidTimeZone(zone) {
+    const value = zone.trim();
+    if (!value || /^[+-]/.test(value))
+        return false;
+    try {
+        new Intl.DateTimeFormat("en-US", { timeZone: value });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** `timeZone`'s offset from UTC at `instant`, in milliseconds (Berlin in July: 7,200,000). */
+export function zoneOffsetMs(instant, timeZone) {
+    const parts = new Intl.DateTimeFormat("en-US", {
+        timeZone,
+        hourCycle: "h23",
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+    }).formatToParts(instant);
+    const read = (type) => Number(parts.find((part) => part.type === type)?.value ?? 0);
+    const asUtc = Date.UTC(read("year"), read("month") - 1, read("day"), read("hour"), read("minute"), read("second"));
+    return asUtc - Math.floor(instant.getTime() / 1000) * 1000;
+}
+/**
+ * The instant a wall-clock time in `timeZone` names. A time the zone repeats (the
+ * autumn fall-back hour) resolves to its first occurrence; a time it skips (the
+ * spring-forward gap) resolves past the gap by its length, as a clock would read
+ * it: 02:30 Europe/Berlin on 2026-03-29 is 03:30 CEST.
+ */
+export function zonedWallClockToInstant(wall, timeZone) {
+    const asUtc = Date.UTC(wall.year, wall.month - 1, wall.day, wall.hour, wall.minute, wall.second, wall.millisecond);
+    const before = zoneOffsetMs(new Date(asUtc - DAY_MS), timeZone);
+    const after = zoneOffsetMs(new Date(asUtc + DAY_MS), timeZone);
+    // Each offset in force around that day names one candidate; a candidate is real
+    // when the zone maps it back to this same wall-clock time.
+    const real = [...new Set([before, after])]
+        .map((offset) => asUtc - offset)
+        .filter((instant) => zoneOffsetMs(new Date(instant), timeZone) === asUtc - instant)
+        .sort((left, right) => left - right);
+    return new Date(real[0] ?? asUtc - before);
+}
+// YYYY-MM-DD, optionally THH:MM[:SS[.fff]], and nothing after it: no Z, no offset.
+const LOCAL_ISO_DATE_TIME = /^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2})(?::(\d{2})(?:[.,](\d{1,9}))?)?)?$/;
+/**
+ * Parse an ISO date-time: with `Z` or an offset it is that instant; without one
+ * it is wall-clock time in `timeZone` (DST-correct). Null when it names no real
+ * date-time. Anything that is not ISO-shaped keeps `Date`'s own parsing.
+ */
+export function parseDateTimeInZone(value, timeZone) {
+    const text = value.trim();
+    const local = LOCAL_ISO_DATE_TIME.exec(text);
+    if (!local) {
+        const instant = new Date(text);
+        return Number.isFinite(instant.getTime()) ? instant : null;
+    }
+    const [year, month, day, hour, minute, second] = local.slice(1, 7).map((part) => Number(part ?? 0));
+    const millisecond = local[7] ? Math.floor(Number(`0.${local[7]}`) * 1000) : 0;
+    const daysInMonth = new Date(Date.UTC(year, month, 0)).getUTCDate();
+    if (month < 1 || month > 12 || day < 1 || day > daysInMonth || hour > 23 || minute > 59 || second > 59)
+        return null;
+    return zonedWallClockToInstant({ year, month, day, hour, minute, second, millisecond }, timeZone);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxygen-agent/cli",
-  "version": "1.1011.97",
+  "version": "1.1011.288",
   "private": false,
   "license": "UNLICENSED",
   "type": "module",