react-semaphor 0.1.359 → 0.1.361

package/dist/chunks/validation-3nSax_Vs.js

@@ -0,0 +1,672 @@
+import { v as x } from "./validators-BnLhuIhd.js";
+import { s as A, c as F, b } 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: p(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: g(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 ce(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 ? _(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] = _(t[i], r);
+  }
+  return t;
+}
+function z(e, t) {
+  return A(e, t) && f(e) === f(t);
+}
+function B(e, t) {
+  return f(t) === f(e);
+}
+function D(e, t) {
+  return t.name !== e.name || e.source && !A(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 f(e) {
+  return (e.aggregate || "SUM").toUpperCase();
+}
+function _(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 N(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 = O(e.fields);
+  return {
+    version: 1,
+    kind: "records",
+    id: e.id,
+    label: e.label,
+    source: p(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: g(e.inputs),
+    limit: e.limit
+  };
+}
+function O(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 j(e) {
+  return {
+    version: 1,
+    kind: "inputOptions",
+    id: e.id,
+    label: e.label,
+    source: p(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 fe(e) {
+  const t = g(e);
+  return t.length > 0 ? t : void 0;
+}
+function E(e) {
+  return (e || []).map(G);
+}
+function ue(e) {
+  return E(e).filter((t) => t.isActive);
+}
+function me(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 he(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 p(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 g(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 = X(
+      i.calendarContext,
+      {
+        pathPrefix: `${r}.calendarContext`,
+        validateTimezone: t.validateTimezone
+      }
+    );
+    if (!n.ok)
+      return n;
+    o.calendarContext = n.calendarContext;
+  }
+  return { ok: !0, analysisOptions: o };
+}
+function pe(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 = Y(e), n = se(e, o), d = x(o), l = [
+      ...d.errors.map(
+        (m) => v(m, {
+          hook: e.hook,
+          hookId: n,
+          pathPrefix: i,
+          severity: "error",
+          intent: o
+        })
+      ),
+      ...d.warnings.map(
+        (m) => v(m, {
+          hook: e.hook,
+          hookId: n,
+          pathPrefix: i,
+          severity: "warning",
+          intent: o
+        })
+      ),
+      ...Z({
+        hookSpec: e,
+        hookId: n,
+        intent: o,
+        pathPrefix: i,
+        fieldCatalogs: r.fieldCatalogs,
+        requireFieldCatalog: r.requireFieldCatalog
+      }),
+      ...re({
+        hookSpec: e,
+        hookId: n,
+        intent: o,
+        pathPrefix: i,
+        validateTimezone: r.validateTimezone
+      })
+    ], c = ae(d, l);
+    return {
+      hook: e.hook,
+      hookId: n,
+      intent: o,
+      diagnostics: l,
+      executionResult: S({
+        intent: o,
+        validation: c,
+        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: $(e.spec)
+    }, d = C([n]);
+    return {
+      hook: e.hook,
+      hookId: n.hookId,
+      diagnostics: [n],
+      executionResult: S({
+        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) {
+  return e.trim().length > 0 && !Number.isNaN(Date.parse(e));
+}
+function X(e, t) {
+  var c;
+  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 = n && typeof n == "object" && !Array.isArray(n) ? n.iso : void 0, l = typeof i == "string" ? ((c = t.validateTimezone) == null ? void 0 : c.call(t, i)) ?? i : null;
+  return l ? 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" && !(typeof d == "string" && J(d)) ? s(
+    `${t.pathPrefix}.anchor`,
+    'Data App analysis option "calendarContext.anchor" must be "now" or an object with a valid iso string.'
+  ) : {
+    ok: !0,
+    calendarContext: {
+      tz: l,
+      weekStart: o,
+      anchor: n
+    }
+  } : s(
+    `${t.pathPrefix}.tz`,
+    'Data App analysis option "calendarContext.tz" must be a valid timezone string.'
+  );
+}
+function Y(e) {
+  return e.hook === "useSemaphorMetric" ? M(e.spec) : e.hook === "useSemaphorAnalysis" ? T(e.spec) : e.hook === "useSemaphorRecords" ? N(e.spec) : j(e.spec);
+}
+function Z(e) {
+  if (e.fieldCatalogs.length === 0 && !e.requireFieldCatalog)
+    return [];
+  const t = oe(e.fieldCatalogs, e.intent.source);
+  return t ? [
+    ...ee({
+      ...e,
+      catalog: t
+    }),
+    ...te({
+      ...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 ee(e) {
+  return ie(e.intent).flatMap(({ field: t, path: r }) => w(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: u(t, e.intent.source),
+      field: t
+    }
+  ]);
+}
+function te(e) {
+  return ("inputs" in e.intent ? e.intent.inputs || [] : []).flatMap((r, i) => {
+    if (!r.field)
+      return [];
+    const o = u(r.field, e.intent.source);
+    return b(o, e.intent.source) ? w(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 re(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 ie(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 oe(e, t) {
+  return e.find((r) => h(r, t));
+}
+function w(e, t, r) {
+  const i = u(t, r);
+  if (h(e, i))
+    return e.fields.find(
+      (o) => ne(o, t) && h(
+        e,
+        u(o, e.source)
+      )
+    );
+}
+function h(e, t) {
+  return [e.source, ...e.sourceAliases || []].some(
+    (r) => b(r, t)
+  );
+}
+function u(e, t) {
+  return e.source || t;
+}
+function ne(e, t) {
+  const r = y(e.name), i = y(t.name);
+  return !!(r && i && r === i);
+}
+function y(e) {
+  return (e || "").trim().toLowerCase();
+}
+function v(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 ae(e, t) {
+  const r = C(t);
+  return {
+    ok: r.ok && e.ok,
+    errors: I([
+      ...e.errors,
+      ...r.errors
+    ]),
+    warnings: I([
+      ...e.warnings,
+      ...r.warnings
+    ]),
+    repairHints: [
+      ...e.repairHints,
+      ...r.repairHints
+    ]
+  };
+}
+function C(e) {
+  const t = e.filter((i) => i.severity === "error").map(k), r = e.filter((i) => i.severity === "warning").map(k);
+  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 k(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 I(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 S(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 se(e, t) {
+  return t.id || $(e.spec);
+}
+function $(e) {
+  if (!e || typeof e != "object" || !("id" in e))
+    return;
+  const t = e.id;
+  return typeof t == "string" && t.trim() ? t : void 0;
+}
+export {
+  ce as a,
+  T as b,
+  M as c,
+  N as d,
+  j as e,
+  me as f,
+  q as g,
+  U as h,
+  fe as i,
+  E as j,
+  K as k,
+  he as n,
+  ue as t,
+  pe as v
+};

package/dist/chunks/validation-bKtG7HIt.js

@@ -0,0 +1 @@
+"use strict";const B=require("./validators-Cu_w8ZEP.js"),c=require("./source-identity-C-xaeE_I.js");function g(e){var r;const t=H(e);return{version:1,kind:"metric",id:e.id,label:e.label,source:y(e),metrics:t,primaryMetric:O(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:J(e.comparison),orderBy:e.orderBy?{field:a(e.orderBy.field),direction:e.orderBy.direction}:void 0,inputs:v(e.inputs),limit:e.limit}}function b(e){var r;return{...g(e),...e.timeWindow?{timeWindow:e.timeWindow}:{},...(r=e.filters)!=null&&r.length?{filters:e.filters}:{},...e.analysis?{analysis:e.analysis}:{}}}function D(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 O(e,t){if(!e.primaryMetric)return t[0]||{name:"",role:"measure"};const r=a(e.primaryMetric,"measure"),i=E(r,t),o=i.length===1?i[0]:void 0;return o?_(r,o):r}function H(e){const t=[];for(const r of e.metrics.map(i=>a(i,"measure"))){if(!r.name)continue;const i=t.findIndex(o=>N(o,r));if(i===-1){t.push(r);continue}t[i]=_(t[i],r)}return t}function N(e,t){return c.semaphorFieldRefsMatch(e,t)&&u(e)===u(t)}function j(e,t){return u(t)===u(e)}function q(e,t){return t.name!==e.name||e.source&&!c.semaphorFieldRefsMatch(t,e)?!1:j(e,t)}function E(e,t){const r=t.filter(i=>q(e,i));return e.aggregate!==void 0,r}function u(e){return(e.aggregate||"SUM").toUpperCase()}function _(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{...c.preferSemaphorFieldRefMetadata(e,t),aggregate:e.aggregate||t.aggregate}}function w(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(!L(e))throw new Error("useSemaphorRecords needs at least one field.");const t=U(e.fields);return{version:1,kind:"records",id:e.id,label:e.label,source:y(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:v(e.inputs),limit:e.limit}}function U(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 C(e){return{version:1,kind:"inputOptions",id:e.id,label:e.label,source:y(e),field:a(e.field,"dimension"),search:e.search,limit:e.limit}}function $(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 V(e){const t=v(e);return t.length>0?t:void 0}function F(e){return(e||[]).map(K)}function G(e){return F(e).filter(t=>t.isActive)}function Q(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 W(e=[]){return e.map(t=>typeof t=="object"?t:{label:String(t),value:t})}function T(e){return e==null?!1:Array.isArray(e)?e.length>0:typeof e=="string"?e.trim().length>0:!0}function K(e){return"toAnalyticsInput"in e?e.toAnalyticsInput():"kind"in e&&"isActive"in e?e:{...e,kind:"filter",isActive:T(e.value),value:e.value}}function y(e){return e.source}function L(e){var t;return!!((t=e.fields)!=null&&t.length)}function a(e,t){return{...e,role:e.role||t}}function v(e){return(e||[]).map($)}function J(e){if(e)return e}function x(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(!Z(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=te(i.calendarContext,{pathPrefix:`${r}.calendarContext`,validateTimezone:t.validateTimezone});if(!n.ok)return n;o.calendarContext=n.calendarContext}return{ok:!0,analysisOptions:o}}function X(e){const t=e.hooks.map((o,n)=>Y(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 Y(e,t,r){const i=`hooks.${t}`;try{const o=re(e),n=fe(e,o),d=B.validateSemaphorAnalyticsIntent(o),l=[...d.errors.map(m=>I(m,{hook:e.hook,hookId:n,pathPrefix:i,severity:"error",intent:o})),...d.warnings.map(m=>I(m,{hook:e.hook,hookId:n,pathPrefix:i,severity:"warning",intent:o})),...ie({hookSpec:e,hookId:n,intent:o,pathPrefix:i,fieldCatalogs:r.fieldCatalogs,requireFieldCatalog:r.requireFieldCatalog}),...ae({hookSpec:e,hookId:n,intent:o,pathPrefix:i,validateTimezone:r.validateTimezone})],f=ce(d,l);return{hook:e.hook,hookId:n,intent:o,diagnostics:l,executionResult:M({intent:o,validation:f,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:z(e.spec)},d=P([n]);return{hook:e.hook,hookId:n.hookId,diagnostics:[n],executionResult:M({validation:d,diagnostics:[n]})}}}function s(e,t){return{ok:!1,issues:[{code:"invalid_analysis_option",message:t,path:e}]}}function Z(e){return e==="absolute_delta"||e==="largest_negative"||e==="largest_positive"||e==="positive_and_negative"||e==="all"}function ee(e){return e.trim().length>0&&!Number.isNaN(Date.parse(e))}function te(e,t){var f;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=n&&typeof n=="object"&&!Array.isArray(n)?n.iso:void 0,l=typeof i=="string"?((f=t.validateTimezone)==null?void 0:f.call(t,i))??i:null;return l?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"&&!(typeof d=="string"&&ee(d))?s(`${t.pathPrefix}.anchor`,'Data App analysis option "calendarContext.anchor" must be "now" or an object with a valid iso string.'):{ok:!0,calendarContext:{tz:l,weekStart:o,anchor:n}}:s(`${t.pathPrefix}.tz`,'Data App analysis option "calendarContext.tz" must be a valid timezone string.')}function re(e){return e.hook==="useSemaphorMetric"?g(e.spec):e.hook==="useSemaphorAnalysis"?b(e.spec):e.hook==="useSemaphorRecords"?w(e.spec):C(e.spec)}function ie(e){if(e.fieldCatalogs.length===0&&!e.requireFieldCatalog)return[];const t=de(e.fieldCatalogs,e.intent.source);return t?[...oe({...e,catalog:t}),...ne({...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 oe(e){return se(e.intent).flatMap(({field:t,path:r})=>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:h(t,e.intent.source),field:t}])}function ne(e){return("inputs"in e.intent?e.intent.inputs||[]:[]).flatMap((r,i)=>{if(!r.field)return[];const o=h(r.field,e.intent.source);return c.semaphorSourcesReferToSameDataset(o,e.intent.source)?R(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 ae(e){if(e.hookSpec.hook!=="useSemaphorAnalysis")return[];const t=x(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 se(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 de(e,t){return e.find(r=>p(r,t))}function R(e,t,r){const i=h(t,r);if(p(e,i))return e.fields.find(o=>le(o,t)&&p(e,h(o,e.source)))}function p(e,t){return[e.source,...e.sourceAliases||[]].some(r=>c.semaphorSourcesReferToSameDataset(r,t))}function h(e,t){return e.source||t}function le(e,t){const r=k(e.name),i=k(t.name);return!!(r&&i&&r===i)}function k(e){return(e||"").trim().toLowerCase()}function I(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 ce(e,t){const r=P(t);return{ok:r.ok&&e.ok,errors:A([...e.errors,...r.errors]),warnings:A([...e.warnings,...r.warnings]),repairHints:[...e.repairHints,...r.repairHints]}}function P(e){const t=e.filter(i=>i.severity==="error").map(S),r=e.filter(i=>i.severity==="warning").map(S);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 S(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 A(e){const t=new Set;return e.filter(r=>{const i=`${r.code}:${r.path||""}:${r.message}`;return t.has(i)?!1:(t.add(i),!0)})}function M(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 fe(e,t){return t.id||z(e.spec)}function z(e){if(!e||typeof e!="object"||!("id"in e))return;const t=e.id;return typeof t=="string"&&t.trim()?t:void 0}exports.hasSemaphorInputValue=T;exports.normalizeSemaphorAnalysisQueryOptions=x;exports.normalizeSemaphorInputOptions=W;exports.toSemaphorActiveInputSnapshots=G;exports.toSemaphorAnalysisIntent=b;exports.toSemaphorAnalysisQueryOptions=D;exports.toSemaphorInputBinding=$;exports.toSemaphorInputBindings=V;exports.toSemaphorInputOptionsIntent=C;exports.toSemaphorInputSnapshots=F;exports.toSemaphorInputSpec=Q;exports.toSemaphorMetricIntent=g;exports.toSemaphorRecordsIntent=w;exports.validateSemaphorDataAppHookSpecs=X;

package/dist/dashboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("../chunks/index-YZnHD2NF.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-DZ3lq1Pk.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,