@wat-toolbox/wat 0.1.0

package/dist/utils/time.js

@@ -0,0 +1,130 @@
+/**
+ * Time interpretation for the CLI (plan §8).
+ *
+ * A bare `--start "2026-06-09T10:00"` is read as **Europe/Brussels** wall-clock
+ * by default (matching the UI), converted to a UTC instant for the API. Rules:
+ *
+ *   - A value that already carries a UTC `Z` or a numeric offset (`+02:00`,
+ *     `-0500`) is an absolute instant — honored as-is.
+ *   - A bare local value (`YYYY-MM-DDTHH:mm[:ss]`, or with a space) is interpreted
+ *     in the given IANA zone (default Europe/Brussels, override with `--tz`),
+ *     DST-safe, and converted to UTC.
+ *
+ * The CLI prints times back in the SAME zone it accepted, so what a member types
+ * and what they see never disagree. No external dependency: the zone offset is
+ * derived from `Intl.DateTimeFormat`, which is DST-correct.
+ */
+export const DEFAULT_TZ = 'Europe/Brussels';
+/** True when a datetime string carries an explicit offset or `Z` (absolute). */
+export function hasExplicitOffset(value) {
+    const trimmed = value.trim();
+    // Only the TIME portion (after the `T`/space) may carry an offset. A bare
+    // date like `2026-06-09` must NOT be mistaken for one (its `-09` is a month/day
+    // separator, not a `-09:00` offset).
+    const timePart = /[T ](\d{2}:\d{2}(?::\d{2})?)(.*)$/.exec(trimmed);
+    if (!timePart)
+        return false;
+    const suffix = timePart[2];
+    // `Z`, or `+HH`, `+HH:MM`, `+HHMM` (likewise `-`) immediately after the time.
+    return /^([zZ]|[+-]\d{2}(:?\d{2})?)$/.test(suffix);
+}
+/**
+ * Compute the offset (in minutes, east-of-UTC positive) of an IANA time zone at
+ * a given UTC instant. Derived from the difference between the same instant
+ * formatted as the zone's local wall-clock and the UTC wall-clock — DST-safe.
+ */
+function zoneOffsetMinutes(instant, timeZone) {
+    const dtf = new Intl.DateTimeFormat('en-US', {
+        timeZone,
+        hour12: false,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit'
+    });
+    const parts = dtf.formatToParts(instant);
+    const get = (type) => Number(parts.find((p) => p.type === type)?.value);
+    let hour = get('hour');
+    if (hour === 24)
+        hour = 0; // some engines emit 24 for midnight
+    // The wall-clock the zone shows for this instant, expressed as a UTC timestamp.
+    const asUTC = Date.UTC(get('year'), get('month') - 1, get('day'), hour, get('minute'), get('second'));
+    return Math.round((asUTC - instant.getTime()) / 60000);
+}
+/**
+ * Parse the wall-clock fields out of a bare local datetime string.
+ * Accepts `YYYY-MM-DDTHH:mm`, `YYYY-MM-DDTHH:mm:ss`, or a space separator.
+ * Returns null when the shape is not a bare local datetime.
+ */
+function parseLocalParts(value) {
+    const m = /^(\d{4})-(\d{2})-(\d{2})[T ](\d{2}):(\d{2})(?::(\d{2}))?$/.exec(value.trim());
+    if (!m)
+        return null;
+    return {
+        y: Number(m[1]),
+        mo: Number(m[2]),
+        d: Number(m[3]),
+        h: Number(m[4]),
+        mi: Number(m[5]),
+        s: m[6] ? Number(m[6]) : 0
+    };
+}
+/**
+ * Resolve a datetime argument to an absolute instant.
+ *
+ * @param value  the raw `--start` / `--end` / `--from` / `--to` argument
+ * @param tz     the IANA zone for bare local values (default Europe/Brussels)
+ */
+export function parseDateTimeArg(value, tz = DEFAULT_TZ) {
+    const trimmed = value.trim();
+    // 1) Explicit offset / Z → an absolute instant. Honor it as-is.
+    if (hasExplicitOffset(trimmed)) {
+        const date = new Date(trimmed);
+        if (Number.isNaN(date.getTime())) {
+            throw new Error(`Invalid datetime: "${value}"`);
+        }
+        return { date, zone: tz, interpretedLocal: false };
+    }
+    // 2) Bare local datetime → interpret in `tz`.
+    const parts = parseLocalParts(trimmed);
+    if (parts) {
+        // First guess: treat the wall-clock as if it were UTC, then correct by the
+        // zone's offset at that approximate instant (DST-safe to a one-pass refine).
+        const guessUTC = Date.UTC(parts.y, parts.mo - 1, parts.d, parts.h, parts.mi, parts.s);
+        const off1 = zoneOffsetMinutes(new Date(guessUTC), tz);
+        let utcMs = guessUTC - off1 * 60000;
+        // Refine once in case the first guess landed on the wrong side of a DST jump.
+        const off2 = zoneOffsetMinutes(new Date(utcMs), tz);
+        if (off2 !== off1)
+            utcMs = guessUTC - off2 * 60000;
+        return { date: new Date(utcMs), zone: tz, interpretedLocal: true };
+    }
+    // 3) Date-only (`YYYY-MM-DD`) → midnight in `tz`.
+    if (/^\d{4}-\d{2}-\d{2}$/.test(trimmed)) {
+        return parseDateTimeArg(`${trimmed}T00:00:00`, tz);
+    }
+    // 4) Last resort: let the JS engine try (e.g. RFC-ish strings).
+    const date = new Date(trimmed);
+    if (Number.isNaN(date.getTime())) {
+        throw new Error(`Invalid datetime: "${value}"`);
+    }
+    return { date, zone: tz, interpretedLocal: false };
+}
+/** Format an instant as a wall-clock string in the given zone (round-trip display). */
+export function formatInZone(date, tz = DEFAULT_TZ) {
+    const dtf = new Intl.DateTimeFormat('en-GB', {
+        timeZone: tz,
+        hour12: false,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit'
+    });
+    const parts = dtf.formatToParts(date);
+    const get = (type) => parts.find((p) => p.type === type)?.value ?? '';
+    return `${get('year')}-${get('month')}-${get('day')} ${get('hour')}:${get('minute')} (${tz})`;
+}
+//# sourceMappingURL=time.js.map

package/dist/utils/time.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@wat-toolbox/wat",
+  "version": "0.1.0",
+  "description": "wat — book WAT meeting rooms from the terminal. Email-OTP login, API-key auth, dev/prod targeting.",
+  "type": "module",
+  "bin": {
+    "wat": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "cli",
+    "wat",
+    "rooms",
+    "booking",
+    "codika",
+    "otp"
+  ],
+  "author": {
+    "name": "Codika",
+    "email": "team@codika.io",
+    "url": "https://codika.io"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/WATbeta/wat-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/WATbeta/wat-cli/issues"
+  },
+  "homepage": "https://github.com/WATbeta/wat-cli#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "commander": "^12.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}