@alternative-path/qa-path-mcp 1.0.8 → 1.0.10

package/dist/utils/time.js

@@ -0,0 +1,137 @@
+/**
+ * Timezone helpers for QA Path MCP.
+ *
+ * The backend stores and returns all timestamps in UTC. The browser UI, however,
+ * renders them in the viewer's local timezone, so the same instant can land on a
+ * different calendar day (e.g. 2026-06-16T18:45Z is "17 June 12:15 am" in IST).
+ *
+ * This MCP ships as a local stdio server: the process runs on the same machine as
+ * the browser, so the host's local timezone matches what the UI uses. We therefore
+ * detect the timezone at runtime and use it to (a) annotate returned timestamps with
+ * a local rendering and (b) compute correct UTC bounds for relative-day filters.
+ *
+ * NOTE: if this MCP is ever hosted remotely (a shared server/container), the host
+ * timezone no longer reflects any user and this default must be revisited — the
+ * timezone would then need to be supplied per-request or per-user.
+ */
+/** Fields that carry ISO-8601 UTC timestamps in API responses. Epoch fields (e.g.
+ * automation step `timestamp` numbers) are intentionally excluded. */
+const TIMESTAMP_FIELDS = new Set([
+    "created_at",
+    "updated_at",
+    "last_executed_date",
+    "next_scheduled_run",
+]);
+/** Detect the host's local IANA timezone, falling back to UTC. */
+export function getLocalTimeZone() {
+    try {
+        return Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
+    }
+    catch {
+        return "UTC";
+    }
+}
+/** Offset (in minutes) of `tz` from UTC at the given UTC instant. East of UTC is positive. */
+function offsetMinutesAt(tz, utcMs) {
+    const dtf = new Intl.DateTimeFormat("en-US", {
+        timeZone: tz,
+        hour12: false,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+    });
+    const parts = dtf.formatToParts(new Date(utcMs));
+    const map = {};
+    for (const p of parts)
+        map[p.type] = p.value;
+    // Hour can come back as "24" at midnight in some engines; normalize to 0.
+    const hour = map.hour === "24" ? 0 : Number(map.hour);
+    const asUtc = Date.UTC(Number(map.year), Number(map.month) - 1, Number(map.day), hour, Number(map.minute), Number(map.second));
+    // formatToParts only resolves to seconds, so the source instant's milliseconds
+    // leak in as a fractional minute. Real IANA offsets are whole minutes — round.
+    return Math.round((asUtc - utcMs) / 60000);
+}
+/** Format an offset in minutes as "+05:30" / "-08:00" / "+00:00". */
+function formatOffset(offsetMinutes) {
+    const sign = offsetMinutes < 0 ? "-" : "+";
+    const abs = Math.abs(offsetMinutes);
+    const hh = String(Math.floor(abs / 60)).padStart(2, "0");
+    const mm = String(abs % 60).padStart(2, "0");
+    return `${sign}${hh}:${mm}`;
+}
+/** The local calendar Y/M/D in `tz` for a given UTC instant. */
+function localYmd(tz, utcMs) {
+    const dtf = new Intl.DateTimeFormat("en-CA", {
+        timeZone: tz,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+    });
+    const map = {};
+    for (const p of dtf.formatToParts(new Date(utcMs)))
+        map[p.type] = p.value;
+    return { year: Number(map.year), month1: Number(map.month), day: Number(map.day) };
+}
+/**
+ * Render a UTC timestamp string as an ISO-8601 string in `tz` carrying the offset,
+ * e.g. "2026-06-17T00:15:00+05:30". Returns null for unparseable input.
+ */
+export function formatInTimeZone(isoUtc, tz) {
+    const ms = Date.parse(isoUtc);
+    if (Number.isNaN(ms))
+        return null;
+    const { year, month1, day } = localYmd(tz, ms);
+    const dtf = new Intl.DateTimeFormat("en-US", {
+        timeZone: tz,
+        hour12: false,
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+    });
+    const map = {};
+    for (const p of dtf.formatToParts(new Date(ms)))
+        map[p.type] = p.value;
+    const hour = map.hour === "24" ? "00" : map.hour;
+    const offset = formatOffset(offsetMinutesAt(tz, ms));
+    const yyyy = String(year).padStart(4, "0");
+    const mo = String(month1).padStart(2, "0");
+    const dd = String(day).padStart(2, "0");
+    return `${yyyy}-${mo}-${dd}T${hour}:${map.minute}:${map.second}${offset}`;
+}
+/** A compact timezone descriptor for `_meta`. Date filtering is resolved server-side
+ * from the `timezone` sent on the request, so no client-computed ranges are needed. */
+export function timezoneMeta(tz = getLocalTimeZone(), nowMs = Date.now()) {
+    return {
+        name: tz,
+        offset: formatOffset(offsetMinutesAt(tz, nowMs)),
+        note: "All timestamps from the API are UTC. `*_local` fields render them in this timezone. " +
+            "Date filters use bare calendar dates and are interpreted in this timezone server-side.",
+    };
+}
+/**
+ * Recursively clone `value`, adding a `<field>_local` sibling for every known UTC
+ * timestamp field (see TIMESTAMP_FIELDS). Non-timestamp data is passed through
+ * unchanged. Safe on arrays, plain objects, and primitives.
+ */
+export function enrichTimestamps(value, tz = getLocalTimeZone()) {
+    if (Array.isArray(value)) {
+        return value.map((v) => enrichTimestamps(v, tz));
+    }
+    if (value && typeof value === "object") {
+        const out = {};
+        for (const [key, val] of Object.entries(value)) {
+            out[key] = enrichTimestamps(val, tz);
+            if (TIMESTAMP_FIELDS.has(key) && typeof val === "string" && val.length > 0) {
+                const local = formatInTimeZone(val, tz);
+                if (local)
+                    out[`${key}_local`] = local;
+            }
+        }
+        return out;
+    }
+    return value;
+}
+//# 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

@@ -1,6 +1,6 @@
 {
   "name": "@alternative-path/qa-path-mcp",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "MCP server for QA-Path Test Management System - Manage test cases, modules, components, and subcomponents via Cursor, Claude and VS Code",
   "main": "dist/index.js",
   "type": "module",