react-semaphor 0.1.358 → 0.1.360

package/dist/chunks/validation-McK0uXpV.js

@@ -0,0 +1,669 @@
+import { v as x } from "./validators-BnLhuIhd.js";
+import { s as S, c as F, b as A } from "./source-identity-qAmkNtEK.js";
+function M(e) {
+  var r;
+  const t = R(e);
+  return {
+    version: 1,
+    kind: "metric",
+    id: e.id,
+    label: e.label,
+    source: h(e),
+    metrics: t,
+    primaryMetric: P(e, t),
+    dateField: e.dateField ? a(e.dateField, "date") : void 0,
+    timeGrain: e.timeGrain,
+    dimensions: (r = e.dimensions) == null ? void 0 : r.map((i) => a(i, "dimension")),
+    comparison: W(e.comparison),
+    orderBy: e.orderBy ? {
+      field: a(e.orderBy.field),
+      direction: e.orderBy.direction
+    } : void 0,
+    inputs: p(e.inputs),
+    limit: e.limit
+  };
+}
+function T(e) {
+  var r;
+  return {
+    ...M(e),
+    ...e.timeWindow ? { timeWindow: e.timeWindow } : {},
+    ...(r = e.filters) != null && r.length ? { filters: e.filters } : {},
+    ...e.analysis ? { analysis: e.analysis } : {}
+  };
+}
+function le(e) {
+  return {
+    ...e.chartTitle ? { chartTitle: e.chartTitle } : {},
+    ...e.chartType ? { chartType: e.chartType } : {},
+    ...e.driverMode ? { driverMode: e.driverMode } : {},
+    ...e.includePopulation !== void 0 ? { includePopulation: e.includePopulation } : {},
+    ...e.calendarContext ? { calendarContext: e.calendarContext } : {}
+  };
+}
+function P(e, t) {
+  if (!e.primaryMetric)
+    return t[0] || { name: "", role: "measure" };
+  const r = a(e.primaryMetric, "measure"), i = H(r, t), o = i.length === 1 ? i[0] : void 0;
+  return o ? b(r, o) : r;
+}
+function R(e) {
+  const t = [];
+  for (const r of e.metrics.map((i) => a(i, "measure"))) {
+    if (!r.name)
+      continue;
+    const i = t.findIndex(
+      (o) => z(o, r)
+    );
+    if (i === -1) {
+      t.push(r);
+      continue;
+    }
+    t[i] = b(t[i], r);
+  }
+  return t;
+}
+function z(e, t) {
+  return S(e, t) && c(e) === c(t);
+}
+function B(e, t) {
+  return c(t) === c(e);
+}
+function D(e, t) {
+  return t.name !== e.name || e.source && !S(t, e) ? !1 : B(e, t);
+}
+function H(e, t) {
+  const r = t.filter(
+    (i) => D(e, i)
+  );
+  return e.aggregate !== void 0, r;
+}
+function c(e) {
+  return (e.aggregate || "SUM").toUpperCase();
+}
+function b(e, t) {
+  if (e.aggregate && t.aggregate && e.aggregate !== t.aggregate)
+    throw new Error(
+      `Metric "${e.name}" was requested with conflicting aggregate semantics: ${e.aggregate} and ${t.aggregate}.`
+    );
+  return {
+    ...F(e, t),
+    aggregate: e.aggregate || t.aggregate
+  };
+}
+function O(e) {
+  if ("sort" in e)
+    throw new Error(
+      "useSemaphorRecords supports orderBy for a single deterministic sort. Multiple sort clauses are not supported by the analytics protocol yet."
+    );
+  if (!V(e))
+    throw new Error(
+      "useSemaphorRecords needs at least one field."
+    );
+  const t = j(e.fields);
+  return {
+    version: 1,
+    kind: "records",
+    id: e.id,
+    label: e.label,
+    source: h(e),
+    fields: t,
+    dateField: e.dateField ? a(e.dateField, "date") : void 0,
+    timeGrain: e.timeGrain,
+    orderBy: e.orderBy ? {
+      field: a(e.orderBy.field),
+      direction: e.orderBy.direction
+    } : void 0,
+    inputs: p(e.inputs),
+    limit: e.limit
+  };
+}
+function j(e) {
+  return e.map((t) => {
+    const r = a(t);
+    if (!r.role)
+      throw new Error(
+        `useSemaphorRecords field "${r.name}" needs an explicit role.`
+      );
+    return r;
+  });
+}
+function N(e) {
+  return {
+    version: 1,
+    kind: "inputOptions",
+    id: e.id,
+    label: e.label,
+    source: h(e),
+    field: a(e.field, "dimension"),
+    search: e.search,
+    limit: e.limit
+  };
+}
+function q(e) {
+  if ("toAnalyticsInput" in e) {
+    const t = e.toAnalyticsInput();
+    return {
+      inputId: t.inputId,
+      ...t.field ? { field: t.field } : {}
+    };
+  }
+  return {
+    inputId: e.inputId,
+    ...e.field ? { field: e.field } : {}
+  };
+}
+function ce(e) {
+  const t = p(e);
+  return t.length > 0 ? t : void 0;
+}
+function E(e) {
+  return (e || []).map(G);
+}
+function fe(e) {
+  return E(e).filter((t) => t.isActive);
+}
+function ue(e) {
+  return e.kind === "filter" ? {
+    inputId: e.id,
+    kind: e.kind,
+    label: e.label,
+    field: a(e.field, "dimension"),
+    operator: e.operator || "in"
+  } : {
+    inputId: e.id,
+    kind: e.kind,
+    label: e.label
+  };
+}
+function me(e = []) {
+  return e.map(
+    (t) => typeof t == "object" ? t : {
+      label: String(t),
+      value: t
+    }
+  );
+}
+function U(e) {
+  return e == null ? !1 : Array.isArray(e) ? e.length > 0 : typeof e == "string" ? e.trim().length > 0 : !0;
+}
+function G(e) {
+  return "toAnalyticsInput" in e ? e.toAnalyticsInput() : "kind" in e && "isActive" in e ? e : {
+    ...e,
+    kind: "filter",
+    isActive: U(
+      e.value
+    ),
+    value: e.value
+  };
+}
+function h(e) {
+  return e.source;
+}
+function V(e) {
+  var t;
+  return !!((t = e.fields) != null && t.length);
+}
+function a(e, t) {
+  return {
+    ...e,
+    role: e.role || t
+  };
+}
+function p(e) {
+  return (e || []).map(q);
+}
+function W(e) {
+  if (e)
+    return e;
+}
+function K(e, t = {}) {
+  const r = t.pathPrefix || "analysisOptions";
+  if (e === void 0)
+    return { ok: !0 };
+  if (!e || typeof e != "object" || Array.isArray(e))
+    return s(
+      r,
+      "Data App analysis options must be an object."
+    );
+  const i = e, o = {};
+  if (i.chartTitle !== void 0) {
+    if (typeof i.chartTitle != "string")
+      return s(
+        `${r}.chartTitle`,
+        'Data App analysis option "chartTitle" must be a string.'
+      );
+    o.chartTitle = i.chartTitle;
+  }
+  if (i.chartType !== void 0) {
+    if (typeof i.chartType != "string")
+      return s(
+        `${r}.chartType`,
+        'Data App analysis option "chartType" must be a string.'
+      );
+    o.chartType = i.chartType;
+  }
+  if (i.driverMode !== void 0) {
+    if (!L(i.driverMode))
+      return s(
+        `${r}.driverMode`,
+        'Data App analysis option "driverMode" must be absolute_delta, largest_negative, largest_positive, positive_and_negative, or all.'
+      );
+    o.driverMode = i.driverMode;
+  }
+  if (i.includePopulation !== void 0) {
+    if (typeof i.includePopulation != "boolean")
+      return s(
+        `${r}.includePopulation`,
+        'Data App analysis option "includePopulation" must be a boolean.'
+      );
+    o.includePopulation = i.includePopulation;
+  }
+  if (i.calendarContext !== void 0) {
+    const n = J(
+      i.calendarContext,
+      {
+        pathPrefix: `${r}.calendarContext`,
+        validateTimezone: t.validateTimezone
+      }
+    );
+    if (!n.ok)
+      return n;
+    o.calendarContext = n.calendarContext;
+  }
+  return { ok: !0, analysisOptions: o };
+}
+function he(e) {
+  const t = e.hooks.map(
+    (o, n) => Q(o, n, {
+      fieldCatalogs: e.fieldCatalogs || [],
+      requireFieldCatalog: !!e.requireFieldCatalog,
+      validateTimezone: e.validateTimezone
+    })
+  ), r = t.flatMap((o) => o.diagnostics), i = t.map((o) => o.executionResult);
+  return {
+    ok: r.every((o) => o.severity !== "error"),
+    diagnostics: r,
+    hooks: t,
+    intents: t.flatMap((o) => o.intent ? [o.intent] : []),
+    executionResults: i
+  };
+}
+function Q(e, t, r) {
+  const i = `hooks.${t}`;
+  try {
+    const o = X(e), n = ae(e, o), d = x(o), l = [
+      ...d.errors.map(
+        (u) => y(u, {
+          hook: e.hook,
+          hookId: n,
+          pathPrefix: i,
+          severity: "error",
+          intent: o
+        })
+      ),
+      ...d.warnings.map(
+        (u) => y(u, {
+          hook: e.hook,
+          hookId: n,
+          pathPrefix: i,
+          severity: "warning",
+          intent: o
+        })
+      ),
+      ...Y({
+        hookSpec: e,
+        hookId: n,
+        intent: o,
+        pathPrefix: i,
+        fieldCatalogs: r.fieldCatalogs,
+        requireFieldCatalog: r.requireFieldCatalog
+      }),
+      ...te({
+        hookSpec: e,
+        hookId: n,
+        intent: o,
+        pathPrefix: i,
+        validateTimezone: r.validateTimezone
+      })
+    ], $ = ne(d, l);
+    return {
+      hook: e.hook,
+      hookId: n,
+      intent: o,
+      diagnostics: l,
+      executionResult: I({
+        intent: o,
+        validation: $,
+        diagnostics: l
+      })
+    };
+  } catch (o) {
+    const n = {
+      severity: "error",
+      code: "invalid_hook_spec",
+      message: o instanceof Error ? o.message : String(o),
+      path: i,
+      hook: e.hook,
+      hookId: C(e.spec)
+    }, d = w([n]);
+    return {
+      hook: e.hook,
+      hookId: n.hookId,
+      diagnostics: [n],
+      executionResult: I({
+        validation: d,
+        diagnostics: [n]
+      })
+    };
+  }
+}
+function s(e, t) {
+  return {
+    ok: !1,
+    issues: [
+      {
+        code: "invalid_analysis_option",
+        message: t,
+        path: e
+      }
+    ]
+  };
+}
+function L(e) {
+  return e === "absolute_delta" || e === "largest_negative" || e === "largest_positive" || e === "positive_and_negative" || e === "all";
+}
+function J(e, t) {
+  var l;
+  if (!e || typeof e != "object" || Array.isArray(e))
+    return s(
+      t.pathPrefix,
+      'Data App analysis option "calendarContext" must be an object.'
+    );
+  const r = e, i = r.tz, o = r.weekStart, n = r.anchor, d = typeof i == "string" ? ((l = t.validateTimezone) == null ? void 0 : l.call(t, i)) ?? i : null;
+  return d ? typeof o != "number" || !Number.isInteger(o) || o < 0 || o > 6 ? s(
+    `${t.pathPrefix}.weekStart`,
+    'Data App analysis option "calendarContext.weekStart" must be an integer from 0 to 6.'
+  ) : n !== "now" && !(n && typeof n == "object" && !Array.isArray(n) && typeof n.iso == "string") ? s(
+    `${t.pathPrefix}.anchor`,
+    'Data App analysis option "calendarContext.anchor" must be "now" or an object with an iso string.'
+  ) : {
+    ok: !0,
+    calendarContext: {
+      tz: d,
+      weekStart: o,
+      anchor: n
+    }
+  } : s(
+    `${t.pathPrefix}.tz`,
+    'Data App analysis option "calendarContext.tz" must be a valid timezone string.'
+  );
+}
+function X(e) {
+  return e.hook === "useSemaphorMetric" ? M(e.spec) : e.hook === "useSemaphorAnalysis" ? T(e.spec) : e.hook === "useSemaphorRecords" ? O(e.spec) : N(e.spec);
+}
+function Y(e) {
+  if (e.fieldCatalogs.length === 0 && !e.requireFieldCatalog)
+    return [];
+  const t = ie(e.fieldCatalogs, e.intent.source);
+  return t ? [
+    ...Z({
+      ...e,
+      catalog: t
+    }),
+    ...ee({
+      ...e,
+      catalog: t
+    })
+  ] : [
+    {
+      severity: "error",
+      code: "invalid_source_ref",
+      message: `Source ref for ${e.hookSpec.hook} does not match a visible Semaphor source.`,
+      path: `${e.pathPrefix}.spec.source`,
+      hook: e.hookSpec.hook,
+      hookId: e.hookId,
+      intentId: e.intent.id,
+      source: e.intent.source
+    }
+  ];
+}
+function Z(e) {
+  return re(e.intent).flatMap(({ field: t, path: r }) => _(e.catalog, t, e.intent.source) ? [] : [
+    {
+      severity: "error",
+      code: "missing_field",
+      message: `Field "${t.name}" is not visible on the selected Semaphor source.`,
+      path: `${e.pathPrefix}.${r}`,
+      hook: e.hookSpec.hook,
+      hookId: e.hookId,
+      intentId: e.intent.id,
+      source: f(t, e.intent.source),
+      field: t
+    }
+  ]);
+}
+function ee(e) {
+  return ("inputs" in e.intent ? e.intent.inputs || [] : []).flatMap((r, i) => {
+    if (!r.field)
+      return [];
+    const o = f(r.field, e.intent.source);
+    return A(o, e.intent.source) ? _(e.catalog, r.field, e.intent.source) ? [] : [
+      {
+        severity: "error",
+        code: "missing_field",
+        message: `Input "${r.inputId}" references field "${r.field.name}", which is not visible on the selected Semaphor source.`,
+        path: `${e.pathPrefix}.spec.inputs.${i}.field`,
+        hook: e.hookSpec.hook,
+        hookId: e.hookId,
+        intentId: e.intent.id,
+        source: o,
+        field: r.field
+      }
+    ] : [
+      {
+        severity: "error",
+        code: "unsupported_input_filter_composition",
+        message: `Input "${r.inputId}" filters a different Semaphor source than the query. Cross-source Data App inputs are not supported yet.`,
+        path: `${e.pathPrefix}.spec.inputs.${i}.field`,
+        hook: e.hookSpec.hook,
+        hookId: e.hookId,
+        intentId: e.intent.id,
+        source: o,
+        field: r.field
+      }
+    ];
+  });
+}
+function te(e) {
+  if (e.hookSpec.hook !== "useSemaphorAnalysis")
+    return [];
+  const t = K(e.hookSpec.spec, {
+    pathPrefix: `${e.pathPrefix}.spec`,
+    validateTimezone: e.validateTimezone
+  });
+  return t.ok ? [] : t.issues.map((r) => ({
+    severity: "error",
+    code: r.code,
+    message: r.message,
+    path: r.path,
+    hook: e.hookSpec.hook,
+    hookId: e.hookId,
+    intentId: e.intent.id,
+    source: e.intent.source
+  }));
+}
+function re(e) {
+  return e.kind === "metric" ? [
+    ...e.metrics.map((t, r) => ({
+      field: t,
+      path: `spec.metrics.${r}`
+    })),
+    ...e.primaryMetric ? [{ field: e.primaryMetric, path: "spec.primaryMetric" }] : [],
+    ...e.dateField ? [{ field: e.dateField, path: "spec.dateField" }] : [],
+    ...(e.dimensions || []).map((t, r) => ({
+      field: t,
+      path: `spec.dimensions.${r}`
+    })),
+    ...e.orderBy ? [{ field: e.orderBy.field, path: "spec.orderBy.field" }] : [],
+    ...(e.filters || []).map((t, r) => ({
+      field: t.field,
+      path: `spec.filters.${r}.field`
+    }))
+  ] : e.kind === "records" ? [
+    ...e.fields.map((t, r) => ({
+      field: t,
+      path: `spec.fields.${r}`
+    })),
+    ...e.dateField ? [{ field: e.dateField, path: "spec.dateField" }] : [],
+    ...e.orderBy ? [{ field: e.orderBy.field, path: "spec.orderBy.field" }] : []
+  ] : e.kind === "inputOptions" ? [{ field: e.field, path: "spec.field" }] : [];
+}
+function ie(e, t) {
+  return e.find((r) => m(r, t));
+}
+function _(e, t, r) {
+  const i = f(t, r);
+  if (m(e, i))
+    return e.fields.find(
+      (o) => oe(o, t) && m(
+        e,
+        f(o, e.source)
+      )
+    );
+}
+function m(e, t) {
+  return [e.source, ...e.sourceAliases || []].some(
+    (r) => A(r, t)
+  );
+}
+function f(e, t) {
+  return e.source || t;
+}
+function oe(e, t) {
+  const r = g(e.name), i = g(t.name);
+  return !!(r && i && r === i);
+}
+function g(e) {
+  return (e || "").trim().toLowerCase();
+}
+function y(e, t) {
+  return {
+    severity: t.severity,
+    code: e.code || "invalid_analytics_intent",
+    message: e.message,
+    path: e.path ? `${t.pathPrefix}.spec.${e.path}` : t.pathPrefix,
+    hook: t.hook,
+    hookId: t.hookId,
+    intentId: t.intent.id,
+    source: t.intent.source
+  };
+}
+function ne(e, t) {
+  const r = w(t);
+  return {
+    ok: r.ok && e.ok,
+    errors: k([
+      ...e.errors,
+      ...r.errors
+    ]),
+    warnings: k([
+      ...e.warnings,
+      ...r.warnings
+    ]),
+    repairHints: [
+      ...e.repairHints,
+      ...r.repairHints
+    ]
+  };
+}
+function w(e) {
+  const t = e.filter((i) => i.severity === "error").map(v), r = e.filter((i) => i.severity === "warning").map(v);
+  return {
+    ok: t.length === 0,
+    errors: t,
+    warnings: r,
+    repairHints: t.map((i) => {
+      var o, n;
+      return {
+        code: i.code,
+        message: i.message,
+        fieldRole: i.fieldRole,
+        invalidField: (o = i.repairHint) == null ? void 0 : o.invalidField,
+        recommendedNextStep: ((n = i.repairHint) == null ? void 0 : n.recommendedNextStep) || "Update the Data App SDK hook spec to use visible Semaphor source and field refs."
+      };
+    })
+  };
+}
+function v(e) {
+  var t;
+  return {
+    code: e.code,
+    message: e.message,
+    path: e.path,
+    fieldRole: e.code === "invalid_source_ref" ? "source" : void 0,
+    repairHint: {
+      code: e.code,
+      message: e.message,
+      invalidField: (t = e.field) == null ? void 0 : t.name,
+      fieldRole: e.code === "invalid_source_ref" ? "source" : void 0,
+      recommendedNextStep: e.code === "unsupported_input_filter_composition" ? "Use an input field from the same Semaphor source as the query, or split the query into separate source-scoped hooks." : "Update the hook spec to use a visible Semaphor source and field ref."
+    }
+  };
+}
+function k(e) {
+  const t = /* @__PURE__ */ new Set();
+  return e.filter((r) => {
+    const i = `${r.code}:${r.path || ""}:${r.message}`;
+    return t.has(i) ? !1 : (t.add(i), !0);
+  });
+}
+function I(e) {
+  var r, i;
+  const t = e.diagnostics.filter((o) => o.severity === "error");
+  return {
+    intentId: (r = e.intent) == null ? void 0 : r.id,
+    status: t.length ? "failed" : "answered",
+    resultShape: (i = e.intent) == null ? void 0 : i.kind,
+    intent: e.intent,
+    validation: e.validation,
+    coverage: {
+      answeredObligations: t.length ? [] : ["hook_spec_validation"],
+      missingObligations: t.length ? ["hook_spec_validation"] : [],
+      warnings: e.validation.warnings
+    },
+    missingFields: t.filter((o) => o.code === "missing_field").flatMap((o) => {
+      var n;
+      return (n = o.field) != null && n.name ? [o.field.name] : [];
+    }),
+    warnings: e.diagnostics.filter((o) => o.severity === "warning").map((o) => o.message),
+    metadata: {
+      validationKind: "data_app_sdk_hook_spec"
+    }
+  };
+}
+function ae(e, t) {
+  return t.id || C(e.spec);
+}
+function C(e) {
+  if (!e || typeof e != "object" || !("id" in e))
+    return;
+  const t = e.id;
+  return typeof t == "string" && t.trim() ? t : void 0;
+}
+export {
+  le as a,
+  T as b,
+  M as c,
+  O as d,
+  N as e,
+  ue as f,
+  q as g,
+  U as h,
+  ce as i,
+  E as j,
+  K as k,
+  me as n,
+  fe as t,
+  he as v
+};

package/dist/dashboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("../chunks/index-BMQsLAi3.js"),e=require("../chunks/common-types-C73-Ud1-.js");exports.Dashboard=o.Dashboard;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("../chunks/index-Db1XVmfU.js"),e=require("../chunks/common-types-C73-Ud1-.js");exports.Dashboard=o.Dashboard;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;

package/dist/dashboard/index.js

@@ -1,4 +1,4 @@
-import { D as o } from "../chunks/index-Cs6rC7Qx.js";
+import { D as o } from "../chunks/index-CJ2IEuKz.js";
 import { C as s, E as C } from "../chunks/common-types-4bjoIgvm.js";
 export {
   s as CONTROL_CARD_DEFAULT_VALUE,

package/dist/data-app-builder/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-BMQsLAi3.js");exports.DataAppBuilder=e.DataAppBuilder;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-Db1XVmfU.js");exports.DataAppBuilder=e.DataAppBuilder;

package/dist/data-app-builder/index.js

@@ -1,4 +1,4 @@
-import { b as r } from "../chunks/index-Cs6rC7Qx.js";
+import { b as r } from "../chunks/index-CJ2IEuKz.js";
 export {
   r as DataAppBuilder
 };