react-semaphor 0.1.365 → 0.1.367

package/dist/chunks/{validation-B4_hBuYu.js → validation-CrUjNWby.js}

@@ -1,8 +1,8 @@
-import { v as C } from "./validators-BnLhuIhd.js";
-import { s as S, c as x, b as A } from "./source-identity-qAmkNtEK.js";
+import { n as C, v as x } from "./validators-L0xEXtjf.js";
+import { b as S, c as F, a as A } from "./source-identity-Dj3dryN9.js";
 function b(e) {
   var r;
-  const t = P(e);
+  const t = z(e);
   return {
     version: 1,
     kind: "metric",
@@ -10,7 +10,7 @@ function b(e) {
     label: e.label,
     source: p(e),
     metrics: t,
-    primaryMetric: T(e, 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((o) => a(o, "dimension")),
@@ -23,7 +23,7 @@ function b(e) {
     limit: e.limit
   };
 }
-function F(e) {
+function T(e) {
   var r;
   return {
     ...b(e),
@@ -32,7 +32,7 @@ function F(e) {
     ...e.analysis ? { analysis: e.analysis } : {}
   };
 }
-function le(e) {
+function ce(e) {
   return {
     ...e.chartTitle ? { chartTitle: e.chartTitle } : {},
     ...e.chartType ? { chartType: e.chartType } : {},
@@ -41,13 +41,13 @@ function le(e) {
     ...e.calendarContext ? { calendarContext: e.calendarContext } : {}
   };
 }
-function T(e, t) {
+function P(e, t) {
   if (!e.primaryMetric)
     return t[0] || { name: "", role: "measure" };
-  const r = a(e.primaryMetric, "measure"), o = D(r, t), i = o.length === 1 ? o[0] : void 0;
-  return i ? M(r, i) : r;
+  const r = a(e.primaryMetric, "measure"), o = O(r, t), i = o.length === 1 ? o[0] : void 0;
+  return i ? w(r, i) : r;
 }
-function P(e) {
+function z(e) {
   const t = [];
   for (const r of e.metrics.map((o) => a(o, "measure"))) {
     if (!r.name)
@@ -59,39 +59,40 @@ function P(e) {
       t.push(r);
       continue;
     }
-    t[o] = M(t[o], r);
+    t[o] = w(t[o], r);
   }
   return t;
 }
 function R(e, t) {
-  return S(e, t) && f(e) === f(t);
-}
-function z(e, t) {
-  return f(t) === f(e);
+  return S(e, t) && c(e) === c(t);
 }
 function B(e, t) {
-  return t.name !== e.name || e.source && !S(t, e) ? !1 : z(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 O(e, t) {
   const r = t.filter(
-    (o) => B(e, o)
+    (o) => D(e, o)
   );
   return e.aggregate !== void 0, r;
 }
-function f(e) {
+function c(e) {
   return (e.aggregate || "SUM").toUpperCase();
 }
-function M(e, t) {
+function w(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 {
-    ...x(e, t),
+    ...F(e, t),
     aggregate: e.aggregate || t.aggregate
   };
 }
 function H(e) {
+  var r;
   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."
@@ -100,7 +101,7 @@ function H(e) {
     throw new Error(
       "useSemaphorRecords needs at least one field."
     );
-  const t = O(e.fields);
+  const t = j(e.fields);
   return {
     version: 1,
     kind: "records",
@@ -110,6 +111,8 @@ function H(e) {
     fields: t,
     dateField: e.dateField ? a(e.dateField, "date") : void 0,
     timeGrain: e.timeGrain,
+    ...e.timeWindow ? { timeWindow: e.timeWindow } : {},
+    ...(r = e.filters) != null && r.length ? { filters: e.filters } : {},
     orderBy: e.orderBy ? {
       field: a(e.orderBy.field),
       direction: e.orderBy.direction
@@ -118,7 +121,7 @@ function H(e) {
     limit: e.limit
   };
 }
-function O(e) {
+function j(e) {
   return e.map((t) => {
     const r = a(t);
     if (!r.role)
@@ -128,7 +131,7 @@ function O(e) {
     return r;
   });
 }
-function j(e) {
+function N(e) {
   return {
     version: 1,
     kind: "inputOptions",
@@ -140,7 +143,7 @@ function j(e) {
     limit: e.limit
   };
 }
-function N(e) {
+function E(e) {
   if ("toAnalyticsInput" in e) {
     const t = e.toAnalyticsInput();
     return {
@@ -153,30 +156,34 @@ function N(e) {
     ...e.field ? { field: e.field } : {}
   };
 }
-function ce(e) {
+function ue(e) {
   const t = g(e);
   return t.length > 0 ? t : void 0;
 }
 function q(e) {
   return (e || []).map(U);
 }
-function fe(e) {
+function me(e) {
   return q(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"
-  } : {
+function he(e) {
+  if (e.kind === "filter") {
+    const t = K(e.operator, e.id);
+    return {
+      inputId: e.id,
+      kind: e.kind,
+      label: e.label,
+      field: a(e.field, "dimension"),
+      operator: t || "in"
+    };
+  }
+  return {
     inputId: e.id,
     kind: e.kind,
     label: e.label
   };
 }
-function he(e = []) {
+function pe(e = []) {
   return e.map(
     (t) => typeof t == "object" ? t : {
       label: String(t),
@@ -184,14 +191,14 @@ function he(e = []) {
     }
   );
 }
-function E(e) {
+function W(e) {
   return e == null ? !1 : Array.isArray(e) ? e.length > 0 : typeof e == "string" ? e.trim().length > 0 : !0;
 }
 function U(e) {
   return "toAnalyticsInput" in e ? e.toAnalyticsInput() : "kind" in e && "isActive" in e ? e : {
     ...e,
     kind: "filter",
-    isActive: E(
+    isActive: W(
       e.value
     ),
     value: e.value
@@ -211,13 +218,23 @@ function a(e, t) {
   };
 }
 function g(e) {
-  return (e || []).map(N);
+  return (e || []).map(E);
 }
 function V(e) {
   if (e)
     return e;
 }
-function W(e, t = {}) {
+function K(e, t) {
+  if (e === void 0)
+    return;
+  const r = C(e);
+  if (!r)
+    throw new Error(
+      `useSemaphorInput "${t}" uses unsupported filter operator "${e}".`
+    );
+  return r;
+}
+function Q(e, t = {}) {
   const r = t.pathPrefix || "analysisOptions";
   if (e === void 0)
     return { ok: !0 };
@@ -244,7 +261,7 @@ function W(e, t = {}) {
     i.chartType = o.chartType;
   }
   if (o.driverMode !== void 0) {
-    if (!Q(o.driverMode))
+    if (!L(o.driverMode))
       return s(
         `${r}.driverMode`,
         'Data App analysis option "driverMode" must be absolute_delta, largest_negative, largest_positive, positive_and_negative, or all.'
@@ -260,7 +277,7 @@ function W(e, t = {}) {
     i.includePopulation = o.includePopulation;
   }
   if (o.calendarContext !== void 0) {
-    const n = L(
+    const n = Y(
       o.calendarContext,
       {
         pathPrefix: `${r}.calendarContext`,
@@ -273,9 +290,9 @@ function W(e, t = {}) {
   }
   return { ok: !0, analysisOptions: i };
 }
-function me(e) {
+function ge(e) {
   const t = e.hooks.map(
-    (i, n) => K(i, n, {
+    (i, n) => J(i, n, {
       fieldCatalogs: e.fieldCatalogs || [],
       requireFieldCatalog: !!e.requireFieldCatalog,
       validateTimezone: e.validateTimezone
@@ -289,12 +306,12 @@ function me(e) {
     executionResults: o
   };
 }
-function K(e, t, r) {
+function J(e, t, r) {
   const o = `hooks.${t}`;
   try {
-    const i = X(e), n = ae(e, i), d = C(i), l = [
+    const i = Z(e), n = de(e, i), d = x(i), l = [
       ...d.errors.map(
-        (h) => y(h, {
+        (m) => y(m, {
           hook: e.hook,
           hookId: n,
           pathPrefix: o,
@@ -303,7 +320,7 @@ function K(e, t, r) {
         })
       ),
       ...d.warnings.map(
-        (h) => y(h, {
+        (m) => y(m, {
           hook: e.hook,
           hookId: n,
           pathPrefix: o,
@@ -311,7 +328,7 @@ function K(e, t, r) {
           intent: i
         })
       ),
-      ...Y({
+      ...ee({
         hookSpec: e,
         hookId: n,
         intent: i,
@@ -319,14 +336,14 @@ function K(e, t, r) {
         fieldCatalogs: r.fieldCatalogs,
         requireFieldCatalog: r.requireFieldCatalog
       }),
-      ...te({
+      ...ie({
         hookSpec: e,
         hookId: n,
         intent: i,
         pathPrefix: o,
         validateTimezone: r.validateTimezone
       })
-    ], c = ne(d, l);
+    ], f = se(d, l);
     return {
       hook: e.hook,
       hookId: n,
@@ -334,7 +351,7 @@ function K(e, t, r) {
       diagnostics: l,
       executionResult: I({
         intent: i,
-        validation: c,
+        validation: f,
         diagnostics: l
       })
     };
@@ -346,7 +363,7 @@ function K(e, t, r) {
       path: o,
       hook: e.hook,
       hookId: $(e.spec)
-    }, d = w([n]);
+    }, d = _([n]);
     return {
       hook: e.hook,
       hookId: n.hookId,
@@ -370,24 +387,24 @@ function s(e, t) {
     ]
   };
 }
-function Q(e) {
+function L(e) {
   return e === "absolute_delta" || e === "largest_negative" || e === "largest_positive" || e === "positive_and_negative" || e === "all";
 }
-function J(e) {
+function X(e) {
   return e.trim().length > 0 && !Number.isNaN(Date.parse(e));
 }
-function L(e, t) {
-  var c;
+function Y(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, o = r.tz, i = r.weekStart, n = r.anchor, d = n && typeof n == "object" && !Array.isArray(n) ? n.iso : void 0, l = typeof o == "string" ? ((c = t.validateTimezone) == null ? void 0 : c.call(t, o)) ?? o : null;
+  const r = e, o = r.tz, i = r.weekStart, n = r.anchor, d = n && typeof n == "object" && !Array.isArray(n) ? n.iso : void 0, l = typeof o == "string" ? ((f = t.validateTimezone) == null ? void 0 : f.call(t, o)) ?? o : null;
   return l ? typeof i != "number" || !Number.isInteger(i) || i < 0 || i > 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(
+  ) : n !== "now" && !(typeof d == "string" && X(d)) ? s(
     `${t.pathPrefix}.anchor`,
     'Data App analysis option "calendarContext.anchor" must be "now" or an object with a valid iso string.'
   ) : {
@@ -402,19 +419,19 @@ function L(e, t) {
     'Data App analysis option "calendarContext.tz" must be a valid timezone string.'
   );
 }
-function X(e) {
-  return e.hook === "useSemaphorMetric" ? b(e.spec) : e.hook === "useSemaphorAnalysis" ? F(e.spec) : e.hook === "useSemaphorRecords" ? H(e.spec) : j(e.spec);
+function Z(e) {
+  return e.hook === "useSemaphorMetric" ? b(e.spec) : e.hook === "useSemaphorAnalysis" ? T(e.spec) : e.hook === "useSemaphorRecords" ? H(e.spec) : N(e.spec);
 }
-function Y(e) {
+function ee(e) {
   if (e.fieldCatalogs.length === 0 && !e.requireFieldCatalog)
     return [];
-  const t = ie(e.fieldCatalogs, e.intent.source);
+  const t = ne(e.fieldCatalogs, e.intent.source);
   return t ? [
-    ...Z({
+    ...te({
       ...e,
       catalog: t
     }),
-    ...ee({
+    ...re({
       ...e,
       catalog: t
     })
@@ -431,8 +448,8 @@ function Y(e) {
     }
   ];
 }
-function Z(e) {
-  return re(e.intent).flatMap(({ field: t, path: r }) => _(e.catalog, t, e.intent.source) ? [] : [
+function te(e) {
+  return oe(e.intent).flatMap(({ field: t, path: r }) => M(e.catalog, t, e.intent.source) ? [] : [
     {
       severity: "error",
       code: "missing_field",
@@ -446,12 +463,12 @@ function Z(e) {
     }
   ]);
 }
-function ee(e) {
+function re(e) {
   return ("inputs" in e.intent ? e.intent.inputs || [] : []).flatMap((r, o) => {
     if (!r.field)
       return [];
     const i = u(r.field, e.intent.source);
-    return A(i, e.intent.source) ? _(e.catalog, r.field, e.intent.source) ? [] : [
+    return A(i, e.intent.source) ? M(e.catalog, r.field, e.intent.source) ? [] : [
       {
         severity: "error",
         code: "missing_field",
@@ -478,10 +495,10 @@ function ee(e) {
     ];
   });
 }
-function te(e) {
+function ie(e) {
   if (e.hookSpec.hook !== "useSemaphorAnalysis")
     return [];
-  const t = W(e.hookSpec.spec, {
+  const t = Q(e.hookSpec.spec, {
     pathPrefix: `${e.pathPrefix}.spec`,
     validateTimezone: e.validateTimezone
   });
@@ -496,7 +513,7 @@ function te(e) {
     source: e.intent.source
   }));
 }
-function re(e) {
+function oe(e) {
   return e.kind === "metric" ? [
     ...e.metrics.map((t, r) => ({
       field: t,
@@ -519,23 +536,27 @@ function re(e) {
       path: `spec.fields.${r}`
     })),
     ...e.dateField ? [{ field: e.dateField, path: "spec.dateField" }] : [],
-    ...e.orderBy ? [{ field: e.orderBy.field, path: "spec.orderBy.field" }] : []
+    ...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 === "inputOptions" ? [{ field: e.field, path: "spec.field" }] : [];
 }
-function ie(e, t) {
-  return e.find((r) => m(r, t));
+function ne(e, t) {
+  return e.find((r) => h(r, t));
 }
-function _(e, t, r) {
+function M(e, t, r) {
   const o = u(t, r);
-  if (m(e, o))
+  if (h(e, o))
     return e.fields.find(
-      (i) => oe(i, t) && m(
+      (i) => ae(i, t) && h(
         e,
         u(i, e.source)
       )
     );
 }
-function m(e, t) {
+function h(e, t) {
   return [e.source, ...e.sourceAliases || []].some(
     (r) => A(r, t)
   );
@@ -543,7 +564,7 @@ function m(e, t) {
 function u(e, t) {
   return e.source || t;
 }
-function oe(e, t) {
+function ae(e, t) {
   return !!(e.name && t.name && e.name === t.name);
 }
 function y(e, t) {
@@ -558,8 +579,8 @@ function y(e, t) {
     source: t.intent.source
   };
 }
-function ne(e, t) {
-  const r = w(t);
+function se(e, t) {
+  const r = _(t);
   return {
     ok: r.ok && e.ok,
     errors: k([
@@ -576,7 +597,7 @@ function ne(e, t) {
     ]
   };
 }
-function w(e) {
+function _(e) {
   const t = e.filter((o) => o.severity === "error").map(v), r = e.filter((o) => o.severity === "warning").map(v);
   return {
     ok: t.length === 0,
@@ -641,7 +662,7 @@ function I(e) {
     }
   };
 }
-function ae(e, t) {
+function de(e, t) {
   return t.id || $(e.spec);
 }
 function $(e) {
@@ -651,18 +672,18 @@ function $(e) {
   return typeof t == "string" && t.trim() ? t : void 0;
 }
 export {
-  le as a,
-  F as b,
+  ce as a,
+  T as b,
   b as c,
   H as d,
-  j as e,
-  ue as f,
-  N as g,
-  E as h,
-  ce as i,
+  N as e,
+  he as f,
+  E as g,
+  W as h,
+  ue as i,
   q as j,
-  W as k,
-  he as n,
-  fe as t,
-  me as v
+  Q as k,
+  pe as n,
+  me as t,
+  ge as v
 };

package/dist/chunks/validation-DGl8wnTt.js

@@ -0,0 +1 @@
+"use strict";const M=require("./validators-Dq5X4mp0.js"),c=require("./source-identity-C-xaeE_I.js");function g(e){var r;const t=O(e);return{version:1,kind:"metric",id:e.id,label:e.label,source:y(e),metrics:t,primaryMetric:D(e,t),dateField:e.dateField?a(e.dateField,"date"):void 0,timeGrain:e.timeGrain,dimensions:(r=e.dimensions)==null?void 0:r.map(o=>a(o,"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 w(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 B(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 D(e,t){if(!e.primaryMetric)return t[0]||{name:"",role:"measure"};const r=a(e.primaryMetric,"measure"),o=N(r,t),i=o.length===1?o[0]:void 0;return i?b(r,i):r}function O(e){const t=[];for(const r of e.metrics.map(o=>a(o,"measure"))){if(!r.name)continue;const o=t.findIndex(i=>H(i,r));if(o===-1){t.push(r);continue}t[o]=b(t[o],r)}return t}function H(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 N(e,t){const r=t.filter(o=>q(e,o));return e.aggregate!==void 0,r}function u(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{...c.preferSemaphorFieldRefMetadata(e,t),aggregate:e.aggregate||t.aggregate}}function _(e){var r;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(!K(e))throw new Error("useSemaphorRecords needs at least one field.");const t=E(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,...e.timeWindow?{timeWindow:e.timeWindow}:{},...(r=e.filters)!=null&&r.length?{filters:e.filters}:{},orderBy:e.orderBy?{field:a(e.orderBy.field),direction:e.orderBy.direction}:void 0,inputs:v(e.inputs),limit:e.limit}}function E(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 $(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 C(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 W(e){const t=v(e);return t.length>0?t:void 0}function F(e){return(e||[]).map(Q)}function U(e){return F(e).filter(t=>t.isActive)}function V(e){if(e.kind==="filter"){const t=L(e.operator,e.id);return{inputId:e.id,kind:e.kind,label:e.label,field:a(e.field,"dimension"),operator:t||"in"}}return{inputId:e.id,kind:e.kind,label:e.label}}function G(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 Q(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 K(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(C)}function J(e){if(e)return e}function L(e,t){if(e===void 0)return;const r=M.normalizeSemaphorInputOperator(e);if(!r)throw new Error(`useSemaphorInput "${t}" uses unsupported filter operator "${e}".`);return r}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 o=e,i={};if(o.chartTitle!==void 0){if(typeof o.chartTitle!="string")return s(`${r}.chartTitle`,'Data App analysis option "chartTitle" must be a string.');i.chartTitle=o.chartTitle}if(o.chartType!==void 0){if(typeof o.chartType!="string")return s(`${r}.chartType`,'Data App analysis option "chartType" must be a string.');i.chartType=o.chartType}if(o.driverMode!==void 0){if(!Z(o.driverMode))return s(`${r}.driverMode`,'Data App analysis option "driverMode" must be absolute_delta, largest_negative, largest_positive, positive_and_negative, or all.');i.driverMode=o.driverMode}if(o.includePopulation!==void 0){if(typeof o.includePopulation!="boolean")return s(`${r}.includePopulation`,'Data App analysis option "includePopulation" must be a boolean.');i.includePopulation=o.includePopulation}if(o.calendarContext!==void 0){const n=te(o.calendarContext,{pathPrefix:`${r}.calendarContext`,validateTimezone:t.validateTimezone});if(!n.ok)return n;i.calendarContext=n.calendarContext}return{ok:!0,analysisOptions:i}}function X(e){const t=e.hooks.map((i,n)=>Y(i,n,{fieldCatalogs:e.fieldCatalogs||[],requireFieldCatalog:!!e.requireFieldCatalog,validateTimezone:e.validateTimezone})),r=t.flatMap(i=>i.diagnostics),o=t.map(i=>i.executionResult);return{ok:r.every(i=>i.severity!=="error"),diagnostics:r,hooks:t,intents:t.flatMap(i=>i.intent?[i.intent]:[]),executionResults:o}}function Y(e,t,r){const o=`hooks.${t}`;try{const i=re(e),n=fe(e,i),d=M.validateSemaphorAnalyticsIntent(i),l=[...d.errors.map(m=>I(m,{hook:e.hook,hookId:n,pathPrefix:o,severity:"error",intent:i})),...d.warnings.map(m=>I(m,{hook:e.hook,hookId:n,pathPrefix:o,severity:"warning",intent:i})),...ie({hookSpec:e,hookId:n,intent:i,pathPrefix:o,fieldCatalogs:r.fieldCatalogs,requireFieldCatalog:r.requireFieldCatalog}),...ae({hookSpec:e,hookId:n,intent:i,pathPrefix:o,validateTimezone:r.validateTimezone})],f=ce(d,l);return{hook:e.hook,hookId:n,intent:i,diagnostics:l,executionResult:A({intent:i,validation:f,diagnostics:l})}}catch(i){const n={severity:"error",code:"invalid_hook_spec",message:i instanceof Error?i.message:String(i),path:o,hook:e.hook,hookId:P(e.spec)},d=z([n]);return{hook:e.hook,hookId:n.hookId,diagnostics:[n],executionResult:A({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,o=r.tz,i=r.weekStart,n=r.anchor,d=n&&typeof n=="object"&&!Array.isArray(n)?n.iso:void 0,l=typeof o=="string"?((f=t.validateTimezone)==null?void 0:f.call(t,o))??o:null;return l?typeof i!="number"||!Number.isInteger(i)||i<0||i>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:i,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"?w(e.spec):e.hook==="useSemaphorRecords"?_(e.spec):$(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,o)=>{if(!r.field)return[];const i=h(r.field,e.intent.source);return c.semaphorSourcesReferToSameDataset(i,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.${o}.field`,hook:e.hookSpec.hook,hookId:e.hookId,intentId:e.intent.id,source:i,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.${o}.field`,hook:e.hookSpec.hook,hookId:e.hookId,intentId:e.intent.id,source:i,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.filters||[]).map((t,r)=>({field:t.field,path:`spec.filters.${r}.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 o=h(t,r);if(p(e,o))return e.fields.find(i=>le(i,t)&&p(e,h(i,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){return!!(e.name&&t.name&&e.name===t.name)}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=z(t);return{ok:r.ok&&e.ok,errors:S([...e.errors,...r.errors]),warnings:S([...e.warnings,...r.warnings]),repairHints:[...e.repairHints,...r.repairHints]}}function z(e){const t=e.filter(o=>o.severity==="error").map(k),r=e.filter(o=>o.severity==="warning").map(k);return{ok:t.length===0,errors:t,warnings:r,repairHints:t.map(o=>{var i,n;return{code:o.code,message:o.message,fieldRole:o.fieldRole,invalidField:(i=o.repairHint)==null?void 0:i.invalidField,recommendedNextStep:((n=o.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 S(e){const t=new Set;return e.filter(r=>{const o=`${r.code}:${r.path||""}:${r.message}`;return t.has(o)?!1:(t.add(o),!0)})}function A(e){var r,o;const t=e.diagnostics.filter(i=>i.severity==="error");return{intentId:(r=e.intent)==null?void 0:r.id,status:t.length?"failed":"answered",resultShape:(o=e.intent)==null?void 0:o.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(i=>i.code==="missing_field").flatMap(i=>{var n;return(n=i.field)!=null&&n.name?[i.field.name]:[]}),warnings:e.diagnostics.filter(i=>i.severity==="warning").map(i=>i.message),metadata:{validationKind:"data_app_sdk_hook_spec"}}}function fe(e,t){return t.id||P(e.spec)}function P(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=G;exports.toSemaphorActiveInputSnapshots=U;exports.toSemaphorAnalysisIntent=w;exports.toSemaphorAnalysisQueryOptions=B;exports.toSemaphorInputBinding=C;exports.toSemaphorInputBindings=W;exports.toSemaphorInputOptionsIntent=$;exports.toSemaphorInputSnapshots=F;exports.toSemaphorInputSpec=V;exports.toSemaphorMetricIntent=g;exports.toSemaphorRecordsIntent=_;exports.validateSemaphorDataAppHookSpecs=X;

package/dist/chunks/validators-Dq5X4mp0.js

@@ -0,0 +1 @@
+"use strict";const O=require("./source-identity-C-xaeE_I.js");function q(e){const i=N(e);return B(i)?i:void 0}function N(e){if(typeof e!="string"||e.trim().length===0)return;const i=e.trim().toLowerCase().replace(/_/g," ");switch(i){case"eq":case"equals":case"=":return"=";case"neq":case"not equals":case"not equal":case"!=":return"!=";case"in":return"in";case"not in":return"not_in";case"contains":case"like":return"contains";case"not contains":case"not like":return"not_contains";case"between":return"between";case"not between":return"not_between";case">":case">=":case"<":case"<=":return i;case"is null":return"is_null";case"is not null":return"is_not_null";default:return j(e)?e:void 0}}function B(e){return e==="="||e==="!="||e==="in"||e==="not_in"||e==="contains"||e==="not_contains"||e==="between"||e==="not_between"||e===">"||e===">="||e==="<"||e==="<="}function j(e){return B(e)||e==="not_contains"||e==="is_null"||e==="is_not_null"}function t(e,i,n){return n?{code:e,message:i,path:n}:{code:e,message:i}}function C(e){for(let i=0;i<e.length;i+=1){const n=e[i];if(e.some((o,a)=>a!==i&&R(o,n)))return!1}return!0}function F(e,i){return O.semaphorFieldRefsMatch(e,i)}function R(e,i){return F(e,i)&&y(e)===y(i)}function E(e){return`Metric intent has duplicate metric "${e.name}" with the same aggregate (${y(e)}). Use different aggregates to request both, or remove one entry.`}function U(e,i){return w(e,i).length===1}function P(e,i){return w(e,i).length===1}function w(e,i){return i.filter(o=>G(e,o))}function G(e,i){return L(e,i)?e.source?F(i,e):!0:!1}function L(e,i){return!(i.name!==e.name||e.role!==void 0&&i.role!==void 0&&i.role!==e.role||H(e,i)&&y(i)!==y(e))}function H(e,i){return e.role==="measure"||i.role==="measure"||e.aggregate!==void 0||i.aggregate!==void 0}function y(e){return(e.aggregate||"SUM").toUpperCase()}const V=/^(\d{4})-(\d{2})-(\d{2})$/,Q=/^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2})(?:\.(\d{1,3}))?)?(Z|[+-]\d{2}:\d{2})$/;function v(e){if(typeof e!="string")return null;const i=e.trim(),n=V.exec(i);if(n){const[,g,S,I]=n;return $(g,S,I)?new Date(Date.UTC(Number(g),Number(S)-1,Number(I))):null}const o=Q.exec(i);if(!o)return null;const[,a,r,s,m,c,l="00",,f]=o;if(!$(a,r,s)||!_(m,0,23)||!_(c,0,59)||!_(l,0,59)||!z(f))return null;const h=new Date(i);return Number.isFinite(h.getTime())?h:null}function $(e,i,n){const o=Number(e),a=Number(i),r=Number(n);if(!Number.isInteger(o)||!Number.isInteger(a)||!Number.isInteger(r)||a<1||a>12)return!1;const s=new Date(Date.UTC(o,a-1,r));return s.getUTCFullYear()===o&&s.getUTCMonth()===a-1&&s.getUTCDate()===r}function _(e,i,n){const o=Number(e);return Number.isInteger(o)&&o>=i&&o<=n}function z(e){if(e==="Z")return!0;const i=/^([+-])(\d{2}):(\d{2})$/.exec(e);return!!(i&&_(i[2],0,23)&&_(i[3],0,59))}function d(e){return typeof e=="string"&&e.trim().length>0}function u(e){return!!(e&&typeof e=="object"&&!Array.isArray(e))}function M(e){const i=new Set;for(const n of e){if(i.has(n))return n;i.add(n)}return null}const X=new Set(["SUM","COUNT","AVG","MIN","MAX","MEDIAN","DISTINCT"]);function x(e,i,n){if(!e||typeof e!="object"){n.push(t("missing_source","Analytics intent needs a source.",i));return}if(e.kind==="semantic"){d(e.domainId)||n.push(t("missing_semantic_domain","Semantic source needs a domainId.",`${i}.domainId`)),d(e.datasetName)||n.push(t("missing_dataset_name","Semantic source needs a datasetName.",`${i}.datasetName`));return}if(e.kind==="physical"){d(e.connectionId)||n.push(t("missing_connection_id","Physical source needs a connectionId.",`${i}.connectionId`)),d(e.tableName)||n.push(t("missing_table_name","Physical source needs a tableName.",`${i}.tableName`));return}if(e.kind==="sql"){d(e.connectionId)||n.push(t("missing_connection_id","SQL source needs a connectionId.",`${i}.connectionId`));return}n.push(t("invalid_source_kind","Source kind is not supported.",i))}function p(e,i,n,o={}){if(!e||!u(e)){o.required&&n.push(t("missing_field_ref","Field reference needs a name.",i));return}d(e.name)||n.push(t("missing_field_ref","Field reference needs a name.",`${i}.name`)),e.source!==void 0&&x(e.source,`${i}.source`,n),Y(e.aggregate,`${i}.aggregate`,n)}function Y(e,i,n){e!==void 0&&(typeof e!="string"||!X.has(e))&&n.push(t("invalid_aggregate","Field aggregate must be SUM, COUNT, AVG, MIN, MAX, MEDIAN, or DISTINCT.",i))}function Z(e,i){if(e.analysis===void 0)return;if(!u(e.analysis)){i.push(t("invalid_metric_analysis","Metric analysis must be a structured object.","analysis"));return}if(e.analysis.kind!=="period_change"){i.push(t("invalid_metric_analysis","Metric analysis kind is not supported.","analysis.kind"));return}e.dateField||i.push(t("missing_analysis_date_field","Period-change analysis needs a dateField.","dateField")),e.timeGrain||i.push(t("missing_analysis_time_grain","Period-change analysis needs a timeGrain.","timeGrain")),e.analysis.orderBy!==void 0&&e.analysis.orderBy!=="absolute_change"&&e.analysis.orderBy!=="positive_change"&&e.analysis.orderBy!=="negative_change"&&e.analysis.orderBy!=="period"&&i.push(t("invalid_metric_analysis","Period-change analysis orderBy must be absolute_change, positive_change, negative_change, or period.","analysis.orderBy"));const{timeWindow:n}=e.analysis;n!==void 0&&b(n,"analysis.timeWindow",i)}function b(e,i,n){if(!u(e)){n.push(t("invalid_time_window","Time window must be a structured object.",i));return}if(e.kind!==void 0&&e.kind!=="relative"&&e.kind!=="absolute"&&n.push(t("invalid_time_window","Time window kind must be relative or absolute.",`${i}.kind`)),e.kind==="absolute"){if(d(e.start)||n.push(t("invalid_time_window","Absolute time window start must be a non-empty ISO date or timestamp string.",`${i}.start`)),d(e.end)||n.push(t("invalid_time_window","Absolute time window end must be a non-empty ISO date or timestamp string.",`${i}.end`)),d(e.start)&&d(e.end)){const o=v(e.start),a=v(e.end);o||n.push(t("invalid_time_window","Absolute time window start must be a valid ISO date or timestamp.",`${i}.start`)),a||n.push(t("invalid_time_window","Absolute time window end must be a valid ISO date or timestamp.",`${i}.end`)),o&&a&&o.getTime()>a.getTime()&&n.push(t("invalid_time_window","Absolute time window start must be before or equal to end.",i))}return}e.unit!=="second"&&e.unit!=="minute"&&e.unit!=="hour"&&e.unit!=="day"&&e.unit!=="week"&&e.unit!=="month"&&e.unit!=="quarter"&&e.unit!=="year"&&n.push(t("invalid_time_window","Time window unit must be second, minute, hour, day, week, month, quarter, or year.",`${i}.unit`)),(typeof e.value!="number"||!Number.isFinite(e.value)||e.value<=0)&&n.push(t("invalid_time_window","Time window value must be a positive number.",`${i}.value`)),e.anchor!==void 0&&e.anchor!=="now"&&e.anchor!=="latest_available"&&n.push(t("invalid_time_window","Time window anchor must be now or latest_available.",`${i}.anchor`)),e.completeness!==void 0&&e.completeness!=="include_partial"&&e.completeness!=="complete_periods"&&n.push(t("invalid_time_window","Time window completeness must be include_partial or complete_periods.",`${i}.completeness`))}function k(e,i,n){if(e!==void 0){if(!Array.isArray(e)){n.push(t("invalid_analytics_filters","Analytics filters must be an array.",i));return}e.forEach((o,a)=>{var c;const r=`${i}.${a}`;if(!u(o)){n.push(t("invalid_analytics_filter","Analytics filter must be a structured object.",r));return}const s=o;p(s.field,`${r}.field`,n,{required:!0}),s.scope!==void 0&&s.scope!=="row"&&s.scope!=="aggregate"&&n.push(t("invalid_analytics_filter_scope","Analytics filter scope must be row or aggregate.",`${r}.scope`)),s.scope==="aggregate"&&((c=s.field)==null?void 0:c.role)!==void 0&&s.field.role!=="measure"&&n.push(t("invalid_analytics_filter_scope","Aggregate-scope analytics filters must target a measure field.",`${r}.scope`));const m=s.operator==="is_null"||s.operator==="is_not_null";if(s.operator!==void 0&&s.operator!=="="&&s.operator!=="!="&&s.operator!=="in"&&s.operator!=="not_in"&&s.operator!=="contains"&&s.operator!=="not_contains"&&s.operator!=="between"&&s.operator!=="not_between"&&s.operator!==">"&&s.operator!==">="&&s.operator!=="<"&&s.operator!=="<="&&s.operator!=="is_null"&&s.operator!=="is_not_null"&&n.push(t("invalid_analytics_filter_operator","Analytics filter operator is not supported.",`${r}.operator`)),s.values===void 0&&!m&&n.push(t("missing_analytics_filter_value","Analytics filter needs values unless it is a null check.",r)),m&&s.values!==void 0){n.push(t("invalid_analytics_filter_values","Null-check analytics filters must not include values.",`${r}.values`));return}if(s.values!==void 0&&!Array.isArray(s.values)){n.push(t("invalid_analytics_filter_values","Analytics filter values must be an array when provided.",`${r}.values`));return}if(s.values!==void 0){const l=s.values.length;if(s.operator==="between"||s.operator==="not_between"){l!==2&&n.push(t("invalid_analytics_filter_values","Between analytics filters must include exactly two values.",`${r}.values`));return}(s.operator==="contains"||s.operator==="not_contains"||s.operator==="="||s.operator==="!="||s.operator===">"||s.operator===">="||s.operator==="<"||s.operator==="<="||s.operator===void 0)&&l!==1&&n.push(t("invalid_analytics_filter_values","Scalar analytics filters must include exactly one value. Use in/not_in for multiple values.",`${r}.values`))}})}}function A(e){var o;const i=[],n=[];if(!e||typeof e!="object")return{ok:!1,errors:[t("invalid_analytics_intent","Analytics intent must be a structured object.")],warnings:n,repairHints:[{code:"invalid_analytics_intent",recommendedNextStep:"Send one structured analytics intent object with kind, source, and required fields."}]};if(e.version!==void 0&&e.version!==1&&i.push(t("invalid_version","Analytics intent version must be 1.","version")),x(e.source,"source",i),e.kind==="metric"){const a=Array.isArray(e.metrics)?e.metrics.filter(r=>u(r)&&d(r.name)):[];if(!Array.isArray(e.metrics)||e.metrics.length===0?i.push(t("missing_metric","Metric intent needs at least one metric.","metrics")):e.metrics.some(r=>!u(r)||!d(r.name))&&i.push(t("invalid_metric_list","Metric intent metrics must be an array of field references with names.","metrics")),a.forEach((r,s)=>{p(r,`metrics.${s}`,i,{required:!0})}),a.length>0&&!C(a)){const r=a.find((s,m)=>a.some((c,l)=>l!==m&&R(c,s)));r&&i.push(t("duplicate_metric",E(r),"metrics"))}if(u(e.primaryMetric)&&d(e.primaryMetric.name)&&w(e.primaryMetric,a).length>1&&i.push(t("ambiguous_primary_metric","Metric intent primaryMetric must identify exactly one selected metric.","primaryMetric")),e.primaryMetric!==void 0&&(p(e.primaryMetric,"primaryMetric",i,{required:!0}),u(e.primaryMetric)&&d(e.primaryMetric.name)&&a.length>0&&!U(e.primaryMetric,a)&&i.push(t("invalid_primary_metric","Metric intent primaryMetric must match one metric field reference.","primaryMetric"))),e.dimensions!==void 0&&!Array.isArray(e.dimensions)?i.push(t("invalid_metric_dimensions","Metric intent dimensions must be an array of field references.","dimensions")):Array.isArray(e.dimensions)&&e.dimensions.some(r=>!u(r)||!d(r.name))&&i.push(t("invalid_metric_dimensions","Metric intent dimensions must be an array of field references with names.","dimensions")),e.dateField!==void 0&&p(e.dateField,"dateField",i),e.timeWindow!==void 0&&(b(e.timeWindow,"timeWindow",i),e.dateField||i.push(t("missing_time_window_date_field","Metric timeWindow needs a dateField.","dateField"))),k(e.filters,"filters",i),Array.isArray(e.dimensions)&&e.dimensions.forEach((r,s)=>{p(r,`dimensions.${s}`,i)}),e.orderBy!==void 0){if(!u(e.orderBy))i.push(t("invalid_metric_order_by","Metric intent orderBy must be a structured object.","orderBy"));else if(p(e.orderBy.field,"orderBy.field",i,{required:!0}),e.orderBy.direction!=="asc"&&e.orderBy.direction!=="desc"&&i.push(t("invalid_metric_order_direction","Metric intent orderBy direction must be asc or desc.","orderBy.direction")),u(e.orderBy.field)&&d(e.orderBy.field.name)){const r=[...a,...e.timeGrain&&e.dateField&&u(e.dateField)?[e.dateField]:[],...Array.isArray(e.dimensions)?e.dimensions.filter(s=>u(s)&&d(s.name)):[]];r.length>0&&!P(e.orderBy.field,r)&&i.push(t("invalid_metric_order_by","Metric intent orderBy.field must match one selected metric, grouped dateField, or dimension.","orderBy.field"))}}Z(e,i)}else e.kind==="records"?(!Array.isArray(e.fields)||e.fields.length===0?i.push(t("missing_record_fields","Records intent needs at least one field.","fields")):e.fields.some(a=>!u(a)||!d(a.name))&&i.push(t("invalid_record_fields","Records intent fields must be field references with names.","fields")),Array.isArray(e.fields)&&e.fields.forEach((a,r)=>{p(a,`fields.${r}`,i)}),e.dateField!==void 0&&p(e.dateField,"dateField",i),e.timeWindow!==void 0&&(b(e.timeWindow,"timeWindow",i),e.dateField||i.push(t("missing_time_window_date_field","Records timeWindow needs a dateField.","dateField"))),k(e.filters,"filters",i),Array.isArray(e.filters)&&e.filters.forEach((a,r)=>{u(a)&&a.scope==="aggregate"&&i.push(t("unsupported_record_filter_scope","Records intents support row-scope filters only. Use a metric intent for aggregate-scope filters.",`filters.${r}.scope`))}),e.orderBy!==void 0&&(u(e.orderBy)?(p(e.orderBy.field,"orderBy.field",i,{required:!0}),e.orderBy.direction!=="asc"&&e.orderBy.direction!=="desc"&&i.push(t("invalid_record_order_direction","Records intent orderBy direction must be asc or desc.","orderBy.direction"))):i.push(t("invalid_record_order_by","Records intent orderBy must be a structured object.","orderBy")))):e.kind==="inputOptions"?((!e.field||!d(e.field.name))&&i.push(t("missing_input_options_field","Input options intent needs a field.","field")),p(e.field,"field",i,{required:!0})):e.kind==="sql"?(((o=e.source)==null?void 0:o.kind)!=="sql"&&i.push(t("invalid_sql_source","SQL analytics intent must use a SQL execution source.","source")),d(e.sql)||i.push(t("missing_sql","SQL analytics intent needs SQL text.","sql")),Array.isArray(e.fields)&&e.fields.forEach((a,r)=>{p(a,`fields.${r}`,i)})):i.push(t("invalid_analytics_kind","Analytics kind is not supported.","kind"));return{ok:i.length===0,errors:i,warnings:n,repairHints:K(i)}}function T(e){const i=[],n=[];if(!e||typeof e!="object")return{ok:!1,errors:[t("invalid_operation_intent","Operation intent must be a structured object.")],warnings:n,repairHints:[{code:"invalid_operation_intent",recommendedNextStep:"Send one typed operation intent with version, kind, and required operation fields."}]};if(e.version!==1&&i.push(t("invalid_version","Operation intent version must be 1.","version")),e.kind==="answer_obligations")!Array.isArray(e.obligations)||e.obligations.length===0?i.push(t("missing_obligations","Answer-obligations operation intent needs at least one obligation.","obligations")):e.obligations.forEach((o,a)=>{d(o.id)||i.push(t("missing_obligation_id","Each analytics obligation needs an id.",`obligations.${a}.id`)),d(o.prompt)||i.push(t("missing_obligation_prompt","Each analytics obligation needs a prompt.",`obligations.${a}.prompt`))});else if(e.kind==="dashboard_change"||e.kind==="data_app_change"){if(d(e.instruction)||i.push(t("missing_instruction","Change operation intent needs an instruction.","instruction")),e.analyticsIntent){const o=A(e.analyticsIntent);i.push(...o.errors),n.push(...o.warnings)}}else i.push(t("invalid_operation_kind","Operation intent kind is not supported.","kind"));return{ok:i.length===0,errors:i,warnings:n,repairHints:D(i)}}function J(e){const i=[],n=[];if(!e||typeof e!="object")return{ok:!1,errors:[t("invalid_recovery_plan","Analytics recovery plan must be a structured object.")],warnings:n,repairHints:[{code:"invalid_recovery_plan",recommendedNextStep:"Return a typed recovery plan with operationIntent and plannedToolCalls."}]};e.version!==1&&i.push(t("invalid_version","Recovery plan version must be 1.","version")),e.kind!=="analytics_recovery_plan"&&i.push(t("invalid_recovery_plan_kind","Recovery plan kind must be analytics_recovery_plan.","kind"));const o=T(e.operationIntent);return i.push(...o.errors),n.push(...o.warnings),Array.isArray(e.plannedToolCalls)||i.push(t("invalid_planned_tool_calls","Recovery plan plannedToolCalls must be an array.","plannedToolCalls")),{ok:i.length===0,errors:i,warnings:n,repairHints:D(i)}}function D(e){return e.map(i=>({code:i.code,recommendedNextStep:i.code==="missing_obligations"?"Normalize the user request into one or more typed analytics obligations before recovery planning.":"Correct the operation/recovery contract shape before planning execution."}))}function K(e){return e.map(i=>{switch(i.code){case"missing_source":return{code:i.code,fieldRole:"source",recommendedNextStep:"Provide a semantic, physical, or SQL source before executing analytics."};case"missing_metric":return{code:i.code,fieldRole:"metric",recommendedNextStep:"Choose one exact metric from the grounded schema candidates."};case"missing_record_fields":return{code:i.code,fieldRole:"dimension",recommendedNextStep:"Provide at least one field for the records intent."};case"missing_input_options_field":return{code:i.code,fieldRole:"input",recommendedNextStep:"Provide the exact field whose option values should be listed."};case"missing_sql":return{code:i.code,fieldRole:"sql",recommendedNextStep:"Provide bounded read-only SQL with an explicit outer LIMIT."};case"conflicting_sql":return{code:i.code,fieldRole:"sql",recommendedNextStep:"Use one canonical SQL text location for the intent; prefer top-level sql."};case"missing_semantic_domain":case"missing_dataset_name":case"missing_connection_id":case"missing_table_name":return{code:i.code,fieldRole:"source",recommendedNextStep:"Use grounded catalog metadata to fill the missing source reference."};default:return}}).filter(i=>!!i)}function W(e,i,n,o){if(!e||typeof e!="object"){n.push(t("invalid_view","Dashboard view must be an object.",i));return}if(d(e.title)||n.push(t("missing_view_title","Dashboard view needs a title.",i)),!e.presentation||typeof e.presentation!="object"){n.push(t("missing_presentation","Dashboard view needs a presentation.",`${i}.presentation`));return}if(e.presentation.kind==="text"){d(e.text)||o.push(t("missing_text_content","Text views should include text content.",`${i}.text`));return}if(!e.analytics){n.push(t("missing_view_analytics","Non-text dashboard views need analytics intent.",`${i}.analytics`));return}const a=A(e.analytics);for(const r of a.errors)n.push(t(r.code,r.message,`${i}.analytics${r.path?`.${r.path}`:""}`));for(const r of a.warnings)o.push(t(r.code,r.message,`${i}.analytics${r.path?`.${r.path}`:""}`))}function ee(e){const i=[],n=[];if(!e||typeof e!="object")return{ok:!1,errors:[t("invalid_dashboard_intent","Dashboard intent must be a structured object.")],warnings:n};e.version!==1&&i.push(t("invalid_version","Dashboard intent version must be 1.")),e.kind!=="dashboard"&&i.push(t("invalid_kind","Experience intent kind must be dashboard.")),d(e.title)||i.push(t("missing_title","Dashboard intent needs a title.","title"));const o=Array.isArray(e.inputs)?e.inputs:[],a=M(o.filter(u).map(c=>c.id).filter(c=>typeof c=="string"));a&&i.push(t("duplicate_input_id",`Duplicate input id: ${a}.`,"inputs"));for(const[c,l]of o.entries()){const f=`inputs.${c}`;if(!u(l)){i.push(t("invalid_input","Dashboard input must be an object.",f));continue}d(l.id)||i.push(t("missing_input_id","Input needs an id.",`${f}.id`)),d(l.label)||i.push(t("missing_input_label","Input needs a label.",`${f}.label`)),!l.field||!d(l.field.name)?i.push(t("missing_input_field","Input needs a field.",`${f}.field`)):p(l.field,`${f}.field`,i)}const r=Array.isArray(e.sections)?e.sections:[];r.length===0&&i.push(t("missing_sections","Dashboard intent needs at least one section.","sections"));const s=r.flatMap(c=>c&&typeof c=="object"&&Array.isArray(c.views)?c.views.filter(u).map(l=>l.id).filter(l=>!!l):[]),m=M(s);m&&i.push(t("duplicate_view_id",`Duplicate dashboard view id: ${m}.`,"sections"));for(const[c,l]of r.entries()){const f=`sections.${c}`;if(!l||typeof l!="object"){i.push(t("invalid_section","Dashboard section must be an object.",f));continue}if(d(l.title)||i.push(t("missing_section_title","Dashboard section needs a title.",f)),!Array.isArray(l.views)||l.views.length===0){i.push(t("missing_section_views","Dashboard section needs at least one view.",`${f}.views`));continue}for(const[h,g]of l.views.entries())W(g,`${f}.views.${h}`,i,n)}return{ok:i.length===0,errors:i,warnings:n}}exports.normalizeSemaphorAnalyticsFilterOperator=N;exports.normalizeSemaphorInputOperator=q;exports.parseSemaphorIsoTimeWindowBoundary=v;exports.validateSemaphorAnalyticsIntent=A;exports.validateSemaphorAnalyticsRecoveryPlan=J;exports.validateSemaphorDashboardIntent=ee;exports.validateSemaphorOperationIntent=T;