react-semaphor 0.1.541 → 0.1.543

package/dist/chunks/raw-temporal-presentation-D-azM_98.js

@@ -0,0 +1,585 @@
+import "./analytics-base-schemas-BFAoRlkU.js";
+import { r as P } from "./pivot-result-identity-DJhXXcns.js";
+import { r as R, n as M } from "./numeric-presentation-F_-H6VAw.js";
+import "./validators-DMHTpf7a.js";
+import "./matrix-operation-contract-8OIO4gob.js";
+import { v as S } from "./raw-temporal-contract-C51YG48G.js";
+import "zod";
+import { DEFAULT_RESOLVED_VALUE_FORMAT_PREFERENCES as A } from "../value-format-preferences/index.js";
+import { f as E, M as O } from "./pivot-result-lifecycle-DupbRk-R.js";
+import { p as g, r as b, c as q, R as z, v as L } from "./temporal-bucket-D7NBrrtL.js";
+const $ = "SEMAPHOR_CALCULATED_FIELD";
+function j(e, a, t) {
+  if (t && (a === "groupby" || a === "pivotby"))
+    return t;
+  if (a === "metric" && e.name === "*" && !e.expression)
+    return e.alias || "count";
+  if (e.alias) return e.alias;
+  const r = e.entityName && e.entityName !== $ ? e.entityName : void 0;
+  if (e.role === "metric") {
+    let o = e.aggregate || "metric";
+    if (e.expression) {
+      const n = e.expression.match(
+        /^(COUNT|SUM|AVG|MIN|MAX|MEDIAN|DISTINCT)\s*\(/i
+      );
+      o = n ? n[1].toLowerCase() : "expr";
+    } else
+      o = o.toLowerCase();
+    return r && r !== e.name ? `${r}_${e.name}_${o}` : `${e.name}_${o}`;
+  }
+  return r && r !== e.name ? `${r}_${e.name}` : e.name;
+}
+function se(e) {
+  return j(e, "detail");
+}
+function le(e) {
+  const a = e.label;
+  return a && e.labelCount === 1 && (a === e.rawKey || !e.rawKeys.has(a)) ? a : e.rawKey;
+}
+class m extends Error {
+  constructor(a, t, r) {
+    super(`${a}: ${t}`), this.code = a, this.context = r, Object.setPrototypeOf(this, m.prototype), this.name = "RawTemporalPresentationBoundaryError";
+  }
+}
+function k() {
+  return { type: "raw_temporal", presentation: { mode: "auto" } };
+}
+function N(e) {
+  if (e.locale || e.relative || e.timezone && e.timezone !== "auto" || e.sourceTimezone && e.sourceTimezone !== "auto" || e.prefix || e.suffix)
+    throw new m(
+      "invalid_raw_temporal_format",
+      "Activated raw temporal presentation contains unsupported locale, relative-time, timezone, prefix, or suffix settings."
+    );
+}
+function U(e) {
+  const a = e.format;
+  if ((a == null ? void 0 : a.type) === "date" && (N(a), a.pattern))
+    return {
+      type: "raw_temporal",
+      presentation: {
+        mode: "pattern",
+        dialect: "semaphor_tokens",
+        pattern: a.pattern
+      }
+    };
+  if (a)
+    throw new m(
+      "invalid_raw_temporal_format",
+      `Raw temporal detail field "${e.id}" has an incompatible authored format.`,
+      { fieldId: e.id }
+    );
+  if (e.dateFormat === "custom") {
+    if (!e.customFormat)
+      throw new m(
+        "invalid_raw_temporal_format",
+        `Raw temporal detail field "${e.id}" selects a custom pattern but has no customFormat.`,
+        { fieldId: e.id }
+      );
+    return {
+      type: "raw_temporal",
+      presentation: {
+        mode: "pattern",
+        dialect: "semaphor_tokens",
+        pattern: e.customFormat
+      }
+    };
+  }
+  return e.dateFormat ? {
+    type: "raw_temporal",
+    presentation: {
+      mode: "pattern",
+      dialect: "semaphor_tokens",
+      pattern: e.dateFormat
+    }
+  } : k();
+}
+function D(e) {
+  var s;
+  if (e != null && e.useRelativeTime) return;
+  if (!e) return k();
+  if (e.useCustomFormat && !((s = e.customFormat) != null && s.trim()))
+    throw new m(
+      "invalid_raw_temporal_format",
+      "Declared SQL temporal presentation selects a custom pattern but has no customFormat.",
+      { reason: "missing_declared_sql_custom_date_format" }
+    );
+  const a = e.useCustomFormat && e.customFormat ? e.customFormat : e.format, t = e.timezone, r = e.sourceTimezone, o = t && t !== "auto" ? { timezone: t } : void 0, n = {
+    sourceTimezone: r && r !== "auto" ? r : "UTC"
+  };
+  return a ? {
+    type: "raw_temporal",
+    ...o,
+    ...n,
+    presentation: {
+      mode: "pattern",
+      dialect: "date_fns",
+      pattern: a
+    }
+  } : {
+    type: "raw_temporal",
+    ...o,
+    ...n,
+    presentation: { mode: "auto" }
+  };
+}
+function ie(e) {
+  return e === "instant" ? "yyyy-MM-dd'T'HH:mm:ssXXX" : e === "wall_datetime" ? "yyyy-MM-dd'T'HH:mm:ss" : "yyyy-MM-dd";
+}
+function me(e) {
+  L({
+    dialect: "date_fns",
+    pattern: e.pattern,
+    valueKind: e.valueKind
+  });
+}
+function V(e) {
+  const a = D(e.settings);
+  if (!a)
+    throw new m(
+      "invalid_raw_temporal_format",
+      "Relative-time SQL presentation does not have an absolute date preview."
+    );
+  const t = e.valueKind ?? (a.presentation.mode === "pattern" ? "instant" : "date"), r = {
+    kind: "raw_temporal",
+    valueKind: t
+  }, o = e.value ?? (t === "date" ? "2023-05-15" : t === "wall_datetime" ? "2023-05-15T14:30:45" : "2023-05-15T14:30:45Z"), n = g({
+    metadata: r,
+    format: b({
+      format: a,
+      preferences: e.preferences,
+      calendar: { tz: e.calendarTimezone }
+    })
+  })(o);
+  if (!n.ok)
+    throw new m(
+      "invalid_raw_temporal_format",
+      n.diagnostic.message
+    );
+  return n.text;
+}
+function ce(e) {
+  try {
+    return { ok: !0, text: V(e) };
+  } catch (a) {
+    return {
+      ok: !1,
+      message: a instanceof Error ? a.message : "Invalid SQL temporal presentation."
+    };
+  }
+}
+function I(e) {
+  var t;
+  const a = e.effectiveCardConfig ?? e.card.config;
+  return R(e.card, a) === "freeform" && !!((t = e.card.sql) != null && t.trim()) && !M(e.card.python || "").trim();
+}
+function Q(e) {
+  var a, t;
+  return e.type !== "table" && e.type !== "detailTable" || !I({ card: e }) ? !1 : Object.values(
+    ((t = (a = e.preferences) == null ? void 0 : a.tablePrefs) == null ? void 0 : t.columnSettingsMap) || {}
+  ).some(
+    (r) => {
+      var o, n, s;
+      return r.type === "date" && ((o = r.dateFormat) == null ? void 0 : o.useRelativeTime) !== !0 && ((n = r.dateFormat) == null ? void 0 : n.useCustomFormat) === !0 && !((s = r.dateFormat.customFormat) != null && s.trim());
+    }
+  );
+}
+function de(e) {
+  var t, r, o;
+  if (!Q(e)) return e;
+  const a = ((r = (t = e.preferences) == null ? void 0 : t.tablePrefs) == null ? void 0 : r.columnSettingsMap) || {};
+  return {
+    ...e,
+    preferences: {
+      ...e.preferences,
+      tablePrefs: {
+        ...(o = e.preferences) == null ? void 0 : o.tablePrefs,
+        columnSettingsMap: Object.fromEntries(
+          Object.entries(a).map(([n, s]) => {
+            var l, p, i;
+            return [
+              n,
+              s.type === "date" && ((l = s.dateFormat) == null ? void 0 : l.useRelativeTime) !== !0 && ((p = s.dateFormat) == null ? void 0 : p.useCustomFormat) === !0 && !((i = s.dateFormat.customFormat) != null && i.trim()) ? {
+                ...s,
+                dateFormat: {
+                  ...s.dateFormat,
+                  format: "",
+                  useCustomFormat: !1,
+                  customFormat: ""
+                }
+              } : s
+            ];
+          })
+        )
+      }
+    }
+  };
+}
+function B() {
+  return {
+    activatedColumnKeys: /* @__PURE__ */ new Set(),
+    byColumnKey: /* @__PURE__ */ new Map(),
+    byFieldId: /* @__PURE__ */ new Map()
+  };
+}
+function T(e, a) {
+  return e === void 0 ? { kind: "invalid", error: a } : {
+    kind: "invalid",
+    error: e instanceof m ? e : e instanceof z ? new m(
+      e.code,
+      e.message,
+      a.context
+    ) : new m(
+      a.code,
+      e instanceof Error ? e.message : a.message,
+      a.context
+    )
+  };
+}
+function H(e) {
+  var o;
+  if (e.cardType !== "detailTable" || e.resultOwner !== "config")
+    return { kind: "inactive" };
+  if (!e.result) return { kind: "loading" };
+  const { records: a, columns: t, columnKeyMap: r } = e.result;
+  if (!Array.isArray(a) || !Array.isArray(t) || !r)
+    return T(
+      void 0,
+      new m(
+        "missing_raw_temporal_result_contract",
+        "Activated raw temporal detail results require records, columns, and columnKeyMap atomically."
+      )
+    );
+  try {
+    const n = t.filter((d) => d.rawTemporal);
+    if (n.length === 0) return { kind: "inactive" };
+    const s = new Map(
+      (((o = e.effectiveCardConfig) == null ? void 0 : o.detailColumns) || []).map((d) => [
+        d.id,
+        d
+      ])
+    ), l = /* @__PURE__ */ new Map(), p = /* @__PURE__ */ new Map();
+    for (const d of n) {
+      const _ = Array.from(s).flatMap(
+        ([v, x]) => {
+          const C = P(
+            r,
+            v,
+            "detail"
+          );
+          return C && C.role === "detail" && (C.outputKey ?? C.rawKey) === d.key ? [{ field: x, binding: C }] : [];
+        }
+      ), c = _.length === 1 ? _[0] : null;
+      if (!c || typeof c.binding.rawKey != "string" || c.binding.rawKey.trim().length === 0 || c.binding.outputKey !== void 0 && (typeof c.binding.outputKey != "string" || c.binding.outputKey.trim().length === 0))
+        throw new m(
+          "missing_raw_temporal_column_binding",
+          `Raw temporal result column "${d.key}" does not have one valid exact detail result binding.`,
+          { columnKey: d.key }
+        );
+      const { field: u, binding: h } = c, f = h.outputKey ?? h.rawKey, w = S(d, {
+        metadataRequired: !0
+      });
+      if (!w)
+        throw new m(
+          "invalid_raw_temporal_metadata",
+          `Raw temporal result column "${f}" has no metadata.`,
+          { fieldId: u.id, columnKey: f }
+        );
+      const y = b({
+        format: U(u),
+        preferences: e.preferences,
+        calendar: e.calendar
+      }), F = {
+        fieldId: u.id,
+        columnKey: f,
+        metadata: w,
+        format: y,
+        formatValue: g({ metadata: w, format: y })
+      };
+      for (let v = 0; v < a.length; v += 1)
+        if (!Object.prototype.hasOwnProperty.call(a[v], f) || a[v][f] === void 0)
+          throw new m(
+            "missing_raw_temporal_result_contract",
+            `Raw temporal result row ${v} is missing column "${f}".`,
+            { fieldId: u.id, columnKey: f }
+          );
+      l.set(f, F), p.set(u.id, F);
+    }
+    const i = {
+      activatedColumnKeys: new Set(l.keys()),
+      byColumnKey: l,
+      byFieldId: p
+    };
+    return a.length === 0 ? { kind: "loaded_empty", presentation: i } : { kind: "loaded_valid", presentation: i };
+  } catch (n) {
+    return T(
+      n,
+      new m(
+        "invalid_raw_temporal_metadata",
+        "Activated raw temporal result metadata is invalid."
+      )
+    );
+  }
+}
+function X(e) {
+  var r, o, n;
+  const a = e.effectiveCardConfig ?? e.card.config, t = R(
+    e.card,
+    a
+  );
+  if (e.card.type === "detailTable" && t === "config") {
+    const s = !!((r = e.columns) != null && r.some((l) => l.rawTemporal));
+    return s && e.records !== void 0 && !e.columnKeyMap ? {
+      kind: "invalid",
+      error: new m(
+        "missing_raw_temporal_result_contract",
+        "Activated raw temporal detail results require records, columns, and columnKeyMap atomically."
+      )
+    } : e.records !== void 0 && !s ? { kind: "inactive" } : K(
+      H({
+        cardType: e.card.type,
+        resultOwner: t,
+        effectiveCardConfig: a,
+        result: e.records === void 0 || !e.columns || !e.columnKeyMap ? void 0 : {
+          records: e.records,
+          columns: e.columns,
+          columnKeyMap: e.columnKeyMap
+        },
+        preferences: e.preferences,
+        calendar: e.calendar
+      }),
+      e
+    );
+  }
+  return K(
+    G({
+      resultOwner: t,
+      sql: e.card.sql,
+      normalizedPython: M(
+        e.card.python || ""
+      ),
+      records: e.records,
+      columns: e.columns,
+      columnSettings: (n = (o = e.card.preferences) == null ? void 0 : o.tablePrefs) == null ? void 0 : n.columnSettingsMap,
+      preferences: e.preferences,
+      calendar: e.calendar
+    }),
+    e
+  );
+}
+function ue(e) {
+  var r, o, n;
+  const a = e.effectiveCardConfig ?? e.card.config, t = R(
+    e.card,
+    a
+  );
+  return e.card.type === "detailTable" && t === "config" ? !!((r = e.columns) != null && r.some((s) => s.rawTemporal)) : I(e) ? Object.values(
+    ((n = (o = e.card.preferences) == null ? void 0 : o.tablePrefs) == null ? void 0 : n.columnSettingsMap) || {}
+  ).some(
+    (s) => {
+      var l;
+      return s.type === "date" && !((l = s.dateFormat) != null && l.useRelativeTime);
+    }
+  ) : !1;
+}
+function K(e, a) {
+  if (!a.executionSnapshot || e.kind === "inactive" || e.kind === "loading" || e.kind === "invalid")
+    return e;
+  if (!a.dashboardId)
+    return {
+      kind: "invalid",
+      error: new m(
+        "missing_raw_temporal_result_contract",
+        "A dashboard ID is required to resolve the captured raw temporal presentation."
+      )
+    };
+  const t = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Map();
+  for (const o of e.presentation.activatedColumnKeys) {
+    const n = E({
+      snapshot: a.executionSnapshot,
+      scope: {
+        dashboardId: a.dashboardId,
+        cardId: a.card.id,
+        ...a.attachmentIndex !== void 0 ? { attachmentIndex: a.attachmentIndex } : {}
+      },
+      target: { kind: "column", columnKey: o }
+    });
+    if (!n)
+      return {
+        kind: "invalid",
+        error: new O(o)
+      };
+    const s = e.presentation.byColumnKey.get(o);
+    if (!s) continue;
+    const l = {
+      ...s,
+      format: n,
+      formatValue: g({
+        metadata: s.metadata,
+        format: n
+      })
+    };
+    t.set(s.columnKey, l), s.fieldId && r.set(s.fieldId, l);
+  }
+  return {
+    ...e,
+    presentation: {
+      activatedColumnKeys: e.presentation.activatedColumnKeys,
+      byColumnKey: t,
+      byFieldId: r
+    }
+  };
+}
+function G(e) {
+  var t, r;
+  if (e.resultOwner !== "freeform" || !((t = e.sql) != null && t.trim()) || (r = e.normalizedPython) != null && r.trim())
+    return { kind: "inactive" };
+  const a = Object.entries(
+    e.columnSettings || {}
+  ).filter(
+    ([, o]) => {
+      var n;
+      return o.type === "date" && !((n = o.dateFormat) != null && n.useRelativeTime);
+    }
+  );
+  if (a.length === 0) return { kind: "inactive" };
+  if (!e.records) return { kind: "loading" };
+  try {
+    const o = /* @__PURE__ */ new Map(), n = new Set(
+      a.map(([i]) => i)
+    ), s = /* @__PURE__ */ new Map(), l = [...e.columns || []];
+    for (const [i, d] of a) {
+      const _ = D(
+        d.dateFormat
+      );
+      if (!_) continue;
+      const c = q({
+        columnKey: i,
+        values: e.records.map((w) => {
+          if (!Object.prototype.hasOwnProperty.call(w, i))
+            throw new m(
+              "missing_raw_temporal_result_contract",
+              `Declared SQL temporal column "${i}" is absent from a physical result row.`,
+              { columnKey: i }
+            );
+          const y = w[i];
+          return y === null || typeof y == "string" ? y : String(y);
+        })
+      });
+      if (s.set(i, c), c.status !== "classified") continue;
+      let u = l.findIndex(
+        (w) => w.key === i
+      );
+      if (e.columns && u < 0)
+        throw new m(
+          "missing_raw_temporal_result_contract",
+          `Classified SQL temporal column "${i}" is absent from result columns.`,
+          { columnKey: i }
+        );
+      u < 0 && (u = l.length, l.push({
+        key: i,
+        name: i,
+        label: i,
+        role: "dimension",
+        dataType: "string"
+      }));
+      const h = {
+        ...l[u],
+        role: "date",
+        dataType: c.metadata.valueKind === "date" ? "date" : "datetime",
+        rawTemporal: c.metadata
+      };
+      S(h, {
+        metadataRequired: !0
+      }), l[u] = h;
+      const f = b({
+        format: _,
+        preferences: e.preferences,
+        calendar: e.calendar
+      });
+      o.set(i, {
+        columnKey: i,
+        metadata: c.metadata,
+        format: f,
+        formatValue: g({
+          metadata: c.metadata,
+          format: f
+        })
+      });
+    }
+    const p = {
+      ...B(),
+      activatedColumnKeys: n,
+      byColumnKey: o
+    };
+    return e.records.length === 0 ? {
+      kind: "loaded_empty",
+      presentation: p,
+      adaptedColumns: l,
+      sqlClassifications: s
+    } : {
+      kind: "loaded_valid",
+      presentation: p,
+      adaptedColumns: l,
+      sqlClassifications: s
+    };
+  } catch (o) {
+    return T(
+      o,
+      new m(
+        "invalid_raw_temporal_format",
+        "Declared SQL raw temporal presentation is invalid."
+      )
+    );
+  }
+}
+function fe(e) {
+  if (e.value !== null && typeof e.value != "string")
+    return {
+      value: e.value,
+      label: String(e.value),
+      result: {
+        ok: !1,
+        text: String(e.value),
+        diagnostic: {
+          code: "invalid_raw_temporal_value",
+          message: `Raw temporal column "${e.presentation.columnKey}" must contain a string or null.`
+        }
+      }
+    };
+  const a = e.presentation.formatValue(e.value);
+  return { value: e.value, label: a.text, result: a };
+}
+function pe(e) {
+  if (!e.result || typeof e.result != "object") return !1;
+  const a = e.result;
+  if (e.expectedResultOwner !== void 0 && a.resultOwner !== e.expectedResultOwner || !Array.isArray(a.records)) return !1;
+  const t = X({
+    card: e.card,
+    effectiveCardConfig: e.effectiveCardConfig,
+    records: a.records,
+    columns: a.columns,
+    columnKeyMap: a.columnKeyMap,
+    preferences: A,
+    calendar: { tz: "UTC" }
+  });
+  return t.kind === "inactive" || t.kind === "loaded_empty" || t.kind === "loaded_valid";
+}
+export {
+  m as R,
+  se as a,
+  le as b,
+  U as c,
+  D as d,
+  H as e,
+  X as f,
+  ue as g,
+  ie as h,
+  pe as i,
+  ce as j,
+  I as k,
+  de as l,
+  Q as m,
+  fe as p,
+  j as r,
+  me as v
+};