react-semaphor 0.1.541 → 0.1.543

package/dist/chunks/metric-comparison-DEwi9uc2.js

@@ -0,0 +1,498 @@
+import { t as g, T as m, a as C } from "./analytics-base-schemas-BFAoRlkU.js";
+import { v as k } from "./validators-DMHTpf7a.js";
+function w(e) {
+  const r = g.safeParse(e);
+  return r.success ? { ok: !0, value: r.data } : {
+    ok: !1,
+    error: {
+      code: m.invalidMetadata,
+      message: "Temporal bucket metadata is invalid.",
+      path: "temporalBucket"
+    }
+  };
+}
+function f(e, r) {
+  if (!e.temporalBucket)
+    return r.metadataRequired ? {
+      ok: !1,
+      error: {
+        code: m.missingMetadata,
+        message: "Activated temporal bucket result is missing metadata.",
+        path: "temporalBucket"
+      }
+    } : { ok: !0 };
+  const o = w(
+    e.temporalBucket
+  );
+  if (!o.ok || !o.value)
+    return o;
+  const n = C(
+    o.value.granularity
+  );
+  return e.dataType !== n ? {
+    ok: !1,
+    error: {
+      code: m.invalidMetadata,
+      message: `${o.value.granularity} temporal buckets require dataType ${n}.`,
+      path: "dataType"
+    }
+  } : o;
+}
+function $(e, r) {
+  var o, n, t, i;
+  return e.granularity === r.granularity && e.calendar.tz === r.calendar.tz && e.calendar.weekStart === r.calendar.weekStart && ((o = e.calendar.fiscalCalendar) == null ? void 0 : o.kind) === ((n = r.calendar.fiscalCalendar) == null ? void 0 : n.kind) && ((t = e.calendar.fiscalCalendar) == null ? void 0 : t.yearStartMonth) === ((i = r.calendar.fiscalCalendar) == null ? void 0 : i.yearStartMonth);
+}
+function I(e, r) {
+  const o = /* @__PURE__ */ new Map();
+  for (const n of e) {
+    if (o.has(n.key))
+      return {
+        ok: !1,
+        error: {
+          code: m.invalidMetadata,
+          message: `Canonical result contains duplicate column key "${n.key}".`,
+          path: "columns"
+        }
+      };
+    if (o.set(n.key, n), n.temporalBucket) {
+      const t = f(n, {
+        metadataRequired: !1
+      });
+      if (!t.ok)
+        return {
+          ok: !1,
+          error: {
+            ...t.error,
+            path: `columns.${n.key}.${t.error.path || "temporalBucket"}`
+          }
+        };
+    }
+  }
+  for (const n of r) {
+    const t = o.get(n.key);
+    if (!t)
+      return {
+        ok: !1,
+        error: {
+          code: m.missingMetadata,
+          message: `Activated temporal bucket result is missing column "${n.key}".`,
+          path: `columns.${n.key}`
+        }
+      };
+    const i = f(t, {
+      metadataRequired: !0
+    });
+    if (!i.ok)
+      return {
+        ok: !1,
+        error: {
+          ...i.error,
+          path: `columns.${n.key}.${i.error.path || "temporalBucket"}`
+        }
+      };
+    if (!i.value || !$(i.value, n.metadata))
+      return {
+        ok: !1,
+        error: {
+          code: m.invalidMetadata,
+          message: `Temporal bucket metadata for column "${n.key}" contradicts the governed query context.`,
+          path: `columns.${n.key}.temporalBucket`
+        }
+      };
+  }
+  return { ok: !0, value: e };
+}
+const h = "higher_is_better", A = {
+  displayMode: "difference",
+  showComparison: !0,
+  indicatorStyle: "arrow_badge",
+  showColor: !0,
+  conditionalLabel: !1
+};
+function y(e) {
+  return k(e) !== null;
+}
+function N(e) {
+  var r, o, n, t;
+  if (((r = e.metricComparison) == null ? void 0 : r.mode) !== "off") {
+    if (((o = e.metricComparison) == null ? void 0 : o.mode) === "explicit")
+      return { source: "explicit", spec: e.metricComparison.spec };
+    if (!((e.inheritGlobalComparison ?? ((n = e.globalDateComparison) == null ? void 0 : n.inheritGlobalComparison)) === !1 || ((t = e.globalDateComparison) == null ? void 0 : t.selection.mode) !== "period"))
+      return {
+        source: "inherited",
+        spec: e.globalDateComparison.selection.spec,
+        ...e.globalDateComparison.owner ? { owner: e.globalDateComparison.owner } : {}
+      };
+  }
+}
+function R(e) {
+  if (e.alias) return e.alias;
+  const r = e.entityName && e.entityName !== "SEMAPHOR_CALCULATED_FIELD" ? e.entityName : void 0, o = r && r !== e.name ? `${r}_` : "";
+  if (e.role !== "metric") return `${o}${e.name}`;
+  let n = e.aggregate || "metric";
+  if (e.expression) {
+    const t = e.expression.match(
+      /^(COUNT|SUM|AVG|MIN|MAX|MEDIAN|DISTINCT)\s*\(/i
+    );
+    n = t ? t[1].toLowerCase() : "expr";
+  } else
+    n = n.toLowerCase();
+  return `${o}${e.name}_${n}`;
+}
+function a(e, r, o) {
+  return o ? { code: e, message: r, path: o } : { code: e, message: r };
+}
+function d(e) {
+  return !!e && typeof e == "object" && !Array.isArray(e);
+}
+function s(e, r, o, n) {
+  Object.keys(e).forEach((t) => {
+    r.includes(t) || n.push(
+      a(
+        "invalid_comparison_spec",
+        `Comparison kind does not accept field "${t}".`,
+        `${o}.${t}`
+      )
+    );
+  });
+}
+function u(e, r, o) {
+  e.alignment !== void 0 && e.alignment !== "calendar" && e.alignment !== "weekday" && o.push(
+    a(
+      "invalid_comparison_spec",
+      'Comparison alignment must be "calendar" or "weekday".',
+      `${r}.alignment`
+    )
+  ), e.toDate !== void 0 && typeof e.toDate != "boolean" && o.push(
+    a(
+      "invalid_comparison_spec",
+      "Comparison toDate must be a boolean.",
+      `${r}.toDate`
+    )
+  );
+}
+function b(e, r, o) {
+  e !== void 0 && (typeof e != "number" || !Number.isSafeInteger(e) || e <= 0) && o.push(
+    a(
+      "invalid_comparison_spec",
+      "Comparison offset must be a positive safe integer.",
+      r
+    )
+  );
+}
+function _(e, r = "comparison") {
+  const o = [];
+  return d(e) ? (e.kind === "previous_period" ? (s(
+    e,
+    ["kind", "offsetPeriods", "alignment", "toDate"],
+    r,
+    o
+  ), b(e.offsetPeriods, `${r}.offsetPeriods`, o), u(e, r, o)) : e.kind === "previous_year" ? (s(
+    e,
+    ["kind", "offsetYears", "alignment", "toDate"],
+    r,
+    o
+  ), b(e.offsetYears, `${r}.offsetYears`, o), u(e, r, o)) : e.kind === "target" ? (s(e, ["kind", "targetValue"], r, o), (typeof e.targetValue != "number" || !Number.isFinite(e.targetValue)) && o.push(
+    a(
+      "invalid_comparison_spec",
+      "Target comparison requires a finite targetValue.",
+      `${r}.targetValue`
+    )
+  )) : o.push(
+    a(
+      "invalid_comparison_spec",
+      "Comparison kind must be previous_period, previous_year, or target.",
+      `${r}.kind`
+    )
+  ), { ok: o.length === 0, errors: o, warnings: [] }) : {
+    ok: !1,
+    errors: [
+      a(
+        "invalid_comparison_spec",
+        "Comparison spec must be an object.",
+        r
+      )
+    ],
+    warnings: []
+  };
+}
+function E(e, r = "comparison") {
+  if (!d(e))
+    return {
+      ok: !1,
+      errors: [
+        a(
+          "invalid_comparison_config",
+          "Comparison config must be an object.",
+          r
+        )
+      ],
+      warnings: []
+    };
+  const o = [];
+  return e.mode === "off" ? s(e, ["mode"], r, o) : e.mode === "explicit" ? (s(e, ["mode", "spec"], r, o), o.push(..._(e.spec, `${r}.spec`).errors)) : o.push(
+    a(
+      "invalid_comparison_config",
+      "Comparison mode must be off or explicit.",
+      `${r}.mode`
+    )
+  ), { ok: o.length === 0, errors: o, warnings: [] };
+}
+function T(e, r = "comparisonSelection") {
+  if (!d(e))
+    return {
+      ok: !1,
+      errors: [
+        a(
+          "invalid_global_date_comparison",
+          "Global Date comparison selection must be an object.",
+          r
+        )
+      ],
+      warnings: []
+    };
+  const o = [];
+  if (e.mode === "off")
+    s(e, ["mode"], r, o);
+  else if (e.mode === "period") {
+    s(e, ["mode", "spec"], r, o);
+    const n = _(e.spec, `${r}.spec`);
+    o.push(...n.errors), d(e.spec) && e.spec.kind === "target" && o.push(
+      a(
+        "invalid_global_date_comparison",
+        "Global Date comparison supports previous_period or previous_year, not target.",
+        `${r}.spec.kind`
+      )
+    );
+  } else
+    o.push(
+      a(
+        "invalid_global_date_comparison",
+        "Global Date comparison mode must be off or period.",
+        `${r}.mode`
+      )
+    );
+  return { ok: o.length === 0, errors: o, warnings: [] };
+}
+function O(e, r = "globalDateComparison") {
+  if (!d(e))
+    return {
+      ok: !1,
+      errors: [
+        a(
+          "invalid_global_date_comparison",
+          "Global Date comparison context must be an object.",
+          r
+        )
+      ],
+      warnings: []
+    };
+  const o = [];
+  return s(
+    e,
+    ["selection", "inheritGlobalComparison", "owner", "referenceTime"],
+    r,
+    o
+  ), o.push(
+    ...T(
+      e.selection,
+      `${r}.selection`
+    ).errors
+  ), e.inheritGlobalComparison !== void 0 && e.inheritGlobalComparison !== !1 && o.push(
+    a(
+      "invalid_global_date_comparison",
+      "inheritGlobalComparison may only be false when present.",
+      `${r}.inheritGlobalComparison`
+    )
+  ), e.owner !== void 0 && (d(e.owner) ? e.owner.kind === "global_date" ? s(e.owner, ["kind"], `${r}.owner`, o) : e.owner.kind === "field_date" ? (s(
+    e.owner,
+    ["kind", "filterId", "label"],
+    `${r}.owner`,
+    o
+  ), (typeof e.owner.filterId != "string" || !e.owner.filterId.trim()) && o.push(
+    a(
+      "invalid_global_date_comparison",
+      "Field Date comparison owner requires a non-empty filterId.",
+      `${r}.owner.filterId`
+    )
+  ), (typeof e.owner.label != "string" || !e.owner.label.trim()) && o.push(
+    a(
+      "invalid_global_date_comparison",
+      "Field Date comparison owner requires a non-empty label.",
+      `${r}.owner.label`
+    )
+  )) : o.push(
+    a(
+      "invalid_global_date_comparison",
+      "Comparison owner kind must be global_date or field_date.",
+      `${r}.owner.kind`
+    )
+  ) : o.push(
+    a(
+      "invalid_global_date_comparison",
+      "Comparison owner must be an object.",
+      `${r}.owner`
+    )
+  )), e.referenceTime !== void 0 && (typeof e.referenceTime != "string" || !y(e.referenceTime)) && o.push(
+    a(
+      "invalid_global_date_comparison",
+      "referenceTime must be a valid ISO date-time string when present.",
+      `${r}.referenceTime`
+    )
+  ), { ok: o.length === 0, errors: o, warnings: [] };
+}
+function G(e) {
+  const { referenceTime: r, ...o } = e;
+  return o;
+}
+function L(e, r = "comparisonPolarity") {
+  return e === "higher_is_better" || e === "lower_is_better" || e === "neutral" ? { ok: !0, errors: [], warnings: [] } : {
+    ok: !1,
+    errors: [
+      a(
+        "invalid_comparison_polarity",
+        "Comparison polarity must be higher_is_better, lower_is_better, or neutral.",
+        r
+      )
+    ],
+    warnings: []
+  };
+}
+function P(e, r = "comparisonPresentation") {
+  if (!d(e))
+    return {
+      ok: !1,
+      errors: [
+        a(
+          "invalid_comparison_presentation",
+          "Comparison presentation must be an object.",
+          r
+        )
+      ],
+      warnings: []
+    };
+  const o = [], n = [
+    "displayMode",
+    "showComparison",
+    "precision",
+    "indicatorStyle",
+    "showColor",
+    "position",
+    "conditionalLabel",
+    "labelName",
+    "conditionalLabels",
+    "colors"
+  ];
+  return Object.keys(e).forEach((i) => {
+    n.includes(i) || o.push(
+      a(
+        "invalid_comparison_presentation",
+        `Comparison presentation does not accept field "${i}".`,
+        `${r}.${i}`
+      )
+    );
+  }), [
+    ["displayMode", ["difference", "percent_change", "both", "ratio"]],
+    ["indicatorStyle", ["arrow_badge", "arrow", "badge", "none"]],
+    ["position", ["left", "right", "top"]]
+  ].forEach(([i, l]) => {
+    e[i] !== void 0 && !l.includes(e[i]) && o.push(
+      a(
+        "invalid_comparison_presentation",
+        `Comparison presentation ${i} is invalid.`,
+        `${r}.${i}`
+      )
+    );
+  }), ["showComparison", "showColor", "conditionalLabel"].forEach((i) => {
+    e[i] !== void 0 && typeof e[i] != "boolean" && o.push(
+      a(
+        "invalid_comparison_presentation",
+        `Comparison presentation ${i} must be a boolean.`,
+        `${r}.${i}`
+      )
+    );
+  }), e.precision !== void 0 && (typeof e.precision != "number" || !Number.isInteger(e.precision) || e.precision < 0 || e.precision > 6) && o.push(
+    a(
+      "invalid_comparison_presentation",
+      "Comparison presentation precision must be an integer from 0 through 6.",
+      `${r}.precision`
+    )
+  ), e.labelName !== void 0 && typeof e.labelName != "string" && o.push(
+    a(
+      "invalid_comparison_presentation",
+      "Comparison presentation labelName must be a string.",
+      `${r}.labelName`
+    )
+  ), ["conditionalLabels", "colors"].forEach((i) => {
+    const l = e[i];
+    if (l !== void 0) {
+      if (!d(l)) {
+        o.push(
+          a(
+            "invalid_comparison_presentation",
+            `Comparison presentation ${i} must be an object.`,
+            `${r}.${i}`
+          )
+        );
+        return;
+      }
+      Object.keys(l).forEach((c) => {
+        ["increase", "decrease", "neutral"].includes(c) || o.push(
+          a(
+            "invalid_comparison_presentation",
+            `Comparison presentation ${i} does not accept field "${c}".`,
+            `${r}.${i}.${c}`
+          )
+        );
+      }), Object.entries(l).forEach(([c, p]) => {
+        p !== void 0 && typeof p != "string" && o.push(
+          a(
+            "invalid_comparison_presentation",
+            `Comparison presentation ${i}.${c} must be a string.`,
+            `${r}.${i}.${c}`
+          )
+        );
+      });
+    }
+  }), { ok: o.length === 0, errors: o, warnings: [] };
+}
+function v(e) {
+  return e === null ? "unknown" : e > 0 ? "increase" : e < 0 ? "decrease" : "no_change";
+}
+function M(e, r) {
+  return e === "unknown" || e === "no_change" || r === "neutral" ? "neutral" : r === "higher_is_better" && e === "increase" || r === "lower_is_better" && e === "decrease" ? "favorable" : "unfavorable";
+}
+function B(e) {
+  const {
+    currentValue: r,
+    comparisonValue: o,
+    polarity: n = h
+  } = e, i = r !== null && o !== null ? r - o : null, l = i !== null && o !== null && o !== 0 ? i / Math.abs(o) : null, c = r !== null && o !== null && o !== 0 ? r / o : null, p = v(i);
+  return {
+    status: o === null ? "insufficient_history" : "available",
+    currentValue: r,
+    comparisonValue: o,
+    delta: i,
+    percentChange: l,
+    ratio: c,
+    direction: p,
+    sentiment: M(p, n)
+  };
+}
+export {
+  A as C,
+  h as D,
+  T as a,
+  N as b,
+  _ as c,
+  E as d,
+  O as e,
+  L as f,
+  P as g,
+  B as h,
+  f as i,
+  I as j,
+  R as r,
+  w as v,
+  G as w
+};