react-semaphor 0.1.335 → 0.1.337

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

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const T=require("../chunks/index-BxM99sFL.js"),u=require("react"),P=require("react/jsx-runtime"),K=require("../chunks/validators-x74uYpnG.js");function x(t){var e;return{version:1,kind:"metric",id:t.id,label:t.label,source:k(t),metric:t.metric,metrics:t.metrics,dateField:t.dateField?m(t.dateField,"date"):void 0,timeGrain:t.timeGrain,dimensions:(e=t.dimensions)==null?void 0:e.map(o=>m(o,"dimension")),comparison:L(t.comparison),inputs:g(t.inputs),limit:t.limit}}function R(t){if("sort"in t)throw new Error("useSemaphorRecords supports orderBy for a single deterministic sort. Multiple sort clauses are not supported by the analytics protocol yet.");if(!N(t))throw new Error("useSemaphorRecords needs at least one field, dimension, or measure.");const e=F(t.fields,t.dimensions,t.measures);return{version:1,kind:"records",id:t.id,label:t.label,source:k(t),fields:e,measures:t.measures,dateField:t.dateField?m(t.dateField,"date"):void 0,timeGrain:t.timeGrain,orderBy:t.orderBy,inputs:g(t.inputs),limit:t.limit}}function q(t){return{version:1,kind:"inputOptions",id:t.id,label:t.label,source:k(t),field:m(t.field,"dimension"),search:t.search,limit:t.limit}}function O(t){if("toAnalyticsInput"in t){const e=t.toAnalyticsInput();return{inputId:e.inputId,field:e.field}}return{inputId:t.inputId,field:t.field}}function U(t){const e=g(t);return e.length>0?e:void 0}function M(t){return(t||[]).map(V)}function A(t){return M(t).filter(e=>e.isActive)}function w(t){return t.kind==="filter"?{inputId:t.id,kind:t.kind,label:t.label,field:m(t.field,"dimension"),operator:t.operator||"in",source:t.source}:{inputId:t.id,kind:t.kind,label:t.label}}function $(t=[]){return t.map(e=>typeof e=="object"?e:{label:String(e),value:e})}function S(t){return t==null?!1:Array.isArray(t)?t.length>0:typeof t=="string"?t.trim().length>0:!0}function V(t){return"toAnalyticsInput"in t?t.toAnalyticsInput():"kind"in t&&"isActive"in t?t:{...t,kind:"filter",isActive:S(t.value),value:t.value}}function k(t){if("source"in t&&t.source)return t.source;const e=t.datasetName||t.dataset;if(!e)throw new Error("Semaphor data app source needs datasetName or dataset.");return{kind:"semantic",domainId:t.domainId,datasetName:e,datasetId:t.datasetId,connectionId:t.connectionId,label:t.sourceLabel}}function N(t){var e,o,n;return!!((e=t.fields)!=null&&e.length||(o=t.dimensions)!=null&&o.length||(n=t.measures)!=null&&n.length)}function j(t){return!!(t!=null&&t.length)}function F(t,e,o){const n=[],r=new Set,a=i=>{const l=`${i.role||""}:${i.name}`;r.has(l)||(r.add(l),n.push(i))};return j(t)&&t.map(i=>m(i)).forEach(a),e==null||e.map(i=>m(i,"dimension")).forEach(a),o==null||o.map(i=>m(i,"measure")).forEach(a),n}function m(t,e){return typeof t=="string"?e?{name:t,role:e}:{name:t}:{...t,role:t.role||e}}function g(t){return(t||[]).map(O)}function L(t){if(!(!t||t==="none"))return typeof t=="object"?t:t==="same_period_last_year"?{kind:"previous_year"}:{kind:t}}function B(){return{executeMetric:(t,e)=>y(t,e),executeRecords:(t,e)=>y(t,e),executeInputOptions:(t,e)=>y(t,e)}}async function y(t,e){if(!e.token)throw new Error("SemaphorDataAppProvider needs a token to execute queries.");const o=await fetch(G(e),{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${e.token}`},body:JSON.stringify({intent:t,activeInputs:e.activeInputs,resultShape:t.kind})}),n=await z(o);if(!o.ok||n.error)throw new Error(n.error||`Semaphor Data App execution failed with status ${o.status}.`);return n}async function z(t){const e=await t.text().catch(()=>"");if(!e.trim())return t.ok?{error:"Semaphor Data App execution returned an empty response."}:{};try{return JSON.parse(e)}catch{return t.ok?{error:"Semaphor Data App execution returned invalid JSON.",details:e}:{error:Q(t,e),details:e}}}function Q(t,e){const o=t.statusText?` ${t.statusText}`:"",n=e.replace(/\s+/g," ").trim();return n?`Semaphor Data App execution failed with status ${t.status}${o}: ${n.slice(0,240)}`:`Semaphor Data App execution failed with status ${t.status}${o}.`}function G(t){const e=J(t).replace(/\/+$/,"");return e?e.endsWith("/api")?`${e}/v1/data-app/execute`:`${e}/api/v1/data-app/execute`:"/api/v1/data-app/execute"}function J(t){if(t.apiBaseUrl)return t.apiBaseUrl;if(!t.token)return"";try{return T.jwtDecode(t.token).apiServiceUrl||""}catch{return""}}const D=u.createContext({});function _(){if(!(typeof window>"u"))return window.__SEMAPHOR_DATA_APP_RUNTIME__}function C(){return u.useContext(D)}function W({token:t,apiBaseUrl:e,executor:o,children:n}){var d;const r=_(),a=((d=r==null?void 0:r.authToken)==null?void 0:d.accessToken)||t,i=(r==null?void 0:r.dataApiBaseUrl)||(r==null?void 0:r.apiBaseUrl)||e,l=u.useMemo(()=>B(),[]),s=o||l,p=u.useMemo(()=>({token:a,apiBaseUrl:i,executor:s}),[i,s,a]);return P.jsx(D.Provider,{value:p,children:n})}const I={value:null},H={records:[]},v={options:[]};function X(t){const e=A(t.inputs);try{const o=x(t),n=b(o);return n?{error:n,activeInputs:e,queryKey:c(void 0,e,n),idleData:I}:{intent:o,error:null,activeInputs:e,queryKey:c(o,e),idleData:I}}catch(o){const n=h(o);return{error:n,activeInputs:e,queryKey:c(void 0,e,n),idleData:I}}}function Y(t){const e=A(t.inputs),o=H;try{const n=R(t),r=b(n);return r?{error:r,activeInputs:e,queryKey:c(void 0,e,r),idleData:o}:{intent:n,error:null,activeInputs:e,queryKey:c(n,e),idleData:o}}catch(n){const r=h(n);return{error:r,activeInputs:e,queryKey:c(void 0,e,r),idleData:o}}}function Z(t){try{const e=q(t),o=b(e);return o?{error:o,queryKey:c(void 0,void 0,o),idleData:v}:{intent:e,error:null,queryKey:c(e),idleData:v}}catch(e){const o=h(e);return{error:o,queryKey:c(void 0,void 0,o),idleData:v}}}function h(t){return t instanceof Error?t:new Error(String(t))}function b(t){const e=K.validateSemaphorAnalyticsIntent(t);if(e.ok)return null;const o=e.errors.map(n=>n.path?`${n.code} at ${n.path}: ${n.message}`:`${n.code}: ${n.message}`).join("; ");return new Error(`Invalid Semaphor analytics intent. ${o}`)}function c(t,e,o){return JSON.stringify({intent:t,activeInputs:e,error:o==null?void 0:o.message})}function tt(t){const[e,o]=u.useState(t.defaultValue),n=Object.prototype.hasOwnProperty.call(t,"value"),r=n?t.value:e,a=u.useMemo(()=>$(t.options),[t.options]),i=u.useCallback(s=>{var d;const p=s;(d=t.onValueChange)==null||d.call(t,p),n||o(p)},[n,t]),l=u.useCallback(()=>i(void 0),[i]);return u.useMemo(()=>{const s=w(t);return{id:t.id,kind:t.kind,label:t.label,field:s.field,operator:s.operator,source:s.source,controlRole:t.kind==="control"?t.role:void 0,value:r,options:a,isActive:S(r),setValue:i,clear:l,toAnalyticsInput:()=>({inputId:s.inputId,field:s.field,kind:t.kind,label:t.label,value:r,isActive:S(r),operator:s.operator,source:s.source,controlRole:t.kind==="control"?t.role:void 0})}},[l,a,i,t,r])}function et(t){const e=u.useMemo(()=>X(t),[t]),o=u.useCallback(a=>{var i;return e.intent?(i=a.executor)==null?void 0:i.executeMetric(e.intent,a):void 0},[e.intent]),n=E(e.queryKey,o,e.idleData,e.activeInputs),r=e.error?e.idleData:n.data;return{id:t.id,intent:e.intent,value:(r==null?void 0:r.value)??null,metrics:r==null?void 0:r.metrics,comparisonValue:r==null?void 0:r.comparisonValue,delta:r==null?void 0:r.delta,deltaPercent:r==null?void 0:r.deltaPercent,records:r==null?void 0:r.records,status:e.error?"error":n.status,isLoading:!e.error&&n.status==="loading",error:e.error||n.error}}function rt(t){const e=u.useMemo(()=>Y(t),[t]),o=u.useCallback(a=>{var i;return e.intent?(i=a.executor)==null?void 0:i.executeRecords(e.intent,a):void 0},[e.intent]),n=E(e.queryKey,o,e.idleData,e.activeInputs),r=e.error?e.idleData:n.data;return{id:t.id,intent:e.intent,records:(r==null?void 0:r.records)||[],columns:r==null?void 0:r.columns,rowCount:r==null?void 0:r.rowCount,status:e.error?"error":n.status,isLoading:!e.error&&n.status==="loading",error:e.error||n.error}}function nt(t){const e=u.useMemo(()=>Z(t),[t]),o=u.useCallback(a=>{var i;return e.intent?(i=a.executor)==null?void 0:i.executeInputOptions(e.intent,a):void 0},[e.intent]),n=E(e.queryKey,o,e.idleData),r=e.error?e.idleData:n.data;return{id:t.id,intent:e.intent,options:(r==null?void 0:r.options)||[],status:e.error?"error":n.status,isLoading:!e.error&&n.status==="loading",error:e.error||n.error}}function E(t,e,o,n){const r=C(),a=u.useRef(e),i=u.useRef(n),[l,s]=u.useState({status:"idle",data:o,error:null});return a.current=e,i.current=n,u.useEffect(()=>{let p;try{p=a.current({...r,activeInputs:i.current})}catch(f){s({status:"error",data:o,error:h(f)});return}if(!p){s({status:"idle",data:o,error:null});return}let d=!1;return s(f=>({status:"loading",data:f.data,error:null})),p.then(f=>{d||s({status:"success",data:f,error:null})}).catch(f=>{d||s({status:"error",data:o,error:h(f)})}),()=>{d=!0}},[o,t,r]),l}exports.SemaphorDataAppContext=D;exports.SemaphorDataAppProvider=W;exports.createSemaphorDataAppExecutor=B;exports.hasSemaphorInputValue=S;exports.normalizeSemaphorInputOptions=$;exports.readWindowRuntime=_;exports.toSemaphorActiveInputSnapshots=A;exports.toSemaphorInputBinding=O;exports.toSemaphorInputBindings=U;exports.toSemaphorInputOptionsIntent=q;exports.toSemaphorInputSnapshots=M;exports.toSemaphorInputSpec=w;exports.toSemaphorMetricIntent=x;exports.toSemaphorRecordsIntent=R;exports.useSemaphorDataAppRuntime=C;exports.useSemaphorInput=tt;exports.useSemaphorInputOptions=nt;exports.useSemaphorMetric=et;exports.useSemaphorRecords=rt;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const T=require("../chunks/index-BxM99sFL.js"),u=require("react"),P=require("react/jsx-runtime"),K=require("../chunks/validators-BtFXY3S_.js");function x(t){var e;return{version:1,kind:"metric",id:t.id,label:t.label,source:k(t),metrics:U(t),primaryMetric:t.primaryMetric||t.metrics[0],dateField:t.dateField?m(t.dateField,"date"):void 0,timeGrain:t.timeGrain,dimensions:(e=t.dimensions)==null?void 0:e.map(o=>m(o,"dimension")),comparison:L(t.comparison),inputs:g(t.inputs),limit:t.limit}}function U(t){return Array.from(new Set(t.metrics.filter(e=>typeof e=="string"&&e.trim().length>0)))}function R(t){if("sort"in t)throw new Error("useSemaphorRecords supports orderBy for a single deterministic sort. Multiple sort clauses are not supported by the analytics protocol yet.");if(!j(t))throw new Error("useSemaphorRecords needs at least one field, dimension, or measure.");const e=z(t.fields,t.dimensions,t.measures);return{version:1,kind:"records",id:t.id,label:t.label,source:k(t),fields:e,measures:t.measures,dateField:t.dateField?m(t.dateField,"date"):void 0,timeGrain:t.timeGrain,orderBy:t.orderBy,inputs:g(t.inputs),limit:t.limit}}function q(t){return{version:1,kind:"inputOptions",id:t.id,label:t.label,source:k(t),field:m(t.field,"dimension"),search:t.search,limit:t.limit}}function M(t){if("toAnalyticsInput"in t){const e=t.toAnalyticsInput();return{inputId:e.inputId,field:e.field}}return{inputId:t.inputId,field:t.field}}function N(t){const e=g(t);return e.length>0?e:void 0}function O(t){return(t||[]).map(V)}function A(t){return O(t).filter(e=>e.isActive)}function w(t){return t.kind==="filter"?{inputId:t.id,kind:t.kind,label:t.label,field:m(t.field,"dimension"),operator:t.operator||"in",source:t.source}:{inputId:t.id,kind:t.kind,label:t.label}}function $(t=[]){return t.map(e=>typeof e=="object"?e:{label:String(e),value:e})}function S(t){return t==null?!1:Array.isArray(t)?t.length>0:typeof t=="string"?t.trim().length>0:!0}function V(t){return"toAnalyticsInput"in t?t.toAnalyticsInput():"kind"in t&&"isActive"in t?t:{...t,kind:"filter",isActive:S(t.value),value:t.value}}function k(t){if("source"in t&&t.source)return t.source;const e=t.datasetName||t.dataset;if(!e)throw new Error("Semaphor data app source needs datasetName or dataset.");return{kind:"semantic",domainId:t.domainId,datasetName:e,datasetId:t.datasetId,connectionId:t.connectionId,label:t.sourceLabel}}function j(t){var e,o,n;return!!((e=t.fields)!=null&&e.length||(o=t.dimensions)!=null&&o.length||(n=t.measures)!=null&&n.length)}function F(t){return!!(t!=null&&t.length)}function z(t,e,o){const n=[],r=new Set,a=i=>{const l=`${i.role||""}:${i.name}`;r.has(l)||(r.add(l),n.push(i))};return F(t)&&t.map(i=>m(i)).forEach(a),e==null||e.map(i=>m(i,"dimension")).forEach(a),o==null||o.map(i=>m(i,"measure")).forEach(a),n}function m(t,e){return typeof t=="string"?e?{name:t,role:e}:{name:t}:{...t,role:t.role||e}}function g(t){return(t||[]).map(M)}function L(t){if(!(!t||t==="none"))return typeof t=="object"?t:t==="same_period_last_year"?{kind:"previous_year"}:{kind:t}}function B(){return{executeMetric:(t,e)=>y(t,e),executeRecords:(t,e)=>y(t,e),executeInputOptions:(t,e)=>y(t,e)}}async function y(t,e){if(!e.token)throw new Error("SemaphorDataAppProvider needs a token to execute queries.");const o=await fetch(J(e),{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${e.token}`},body:JSON.stringify({intent:t,activeInputs:e.activeInputs,resultShape:t.kind})}),n=await Q(o);if(!o.ok||n.error)throw new Error(n.error||`Semaphor Data App execution failed with status ${o.status}.`);return n}async function Q(t){const e=await t.text().catch(()=>"");if(!e.trim())return t.ok?{error:"Semaphor Data App execution returned an empty response."}:{};try{return JSON.parse(e)}catch{return t.ok?{error:"Semaphor Data App execution returned invalid JSON.",details:e}:{error:G(t,e),details:e}}}function G(t,e){const o=t.statusText?` ${t.statusText}`:"",n=e.replace(/\s+/g," ").trim();return n?`Semaphor Data App execution failed with status ${t.status}${o}: ${n.slice(0,240)}`:`Semaphor Data App execution failed with status ${t.status}${o}.`}function J(t){const e=W(t).replace(/\/+$/,"");return e?e.endsWith("/api")?`${e}/v1/data-app/execute`:`${e}/api/v1/data-app/execute`:"/api/v1/data-app/execute"}function W(t){if(t.apiBaseUrl)return t.apiBaseUrl;if(!t.token)return"";try{return T.jwtDecode(t.token).apiServiceUrl||""}catch{return""}}const D=u.createContext({});function _(){if(!(typeof window>"u"))return window.__SEMAPHOR_DATA_APP_RUNTIME__}function C(){return u.useContext(D)}function H({token:t,apiBaseUrl:e,executor:o,children:n}){var d;const r=_(),a=((d=r==null?void 0:r.authToken)==null?void 0:d.accessToken)||t,i=(r==null?void 0:r.dataApiBaseUrl)||(r==null?void 0:r.apiBaseUrl)||e,l=u.useMemo(()=>B(),[]),s=o||l,p=u.useMemo(()=>({token:a,apiBaseUrl:i,executor:s}),[i,s,a]);return P.jsx(D.Provider,{value:p,children:n})}const I={value:null},X={records:[]},v={options:[]};function Y(t){const e=A(t.inputs);try{const o=x(t),n=b(o);return n?{error:n,activeInputs:e,queryKey:c(void 0,e,n),idleData:I}:{intent:o,error:null,activeInputs:e,queryKey:c(o,e),idleData:I}}catch(o){const n=h(o);return{error:n,activeInputs:e,queryKey:c(void 0,e,n),idleData:I}}}function Z(t){const e=A(t.inputs),o=X;try{const n=R(t),r=b(n);return r?{error:r,activeInputs:e,queryKey:c(void 0,e,r),idleData:o}:{intent:n,error:null,activeInputs:e,queryKey:c(n,e),idleData:o}}catch(n){const r=h(n);return{error:r,activeInputs:e,queryKey:c(void 0,e,r),idleData:o}}}function tt(t){try{const e=q(t),o=b(e);return o?{error:o,queryKey:c(void 0,void 0,o),idleData:v}:{intent:e,error:null,queryKey:c(e),idleData:v}}catch(e){const o=h(e);return{error:o,queryKey:c(void 0,void 0,o),idleData:v}}}function h(t){return t instanceof Error?t:new Error(String(t))}function b(t){const e=K.validateSemaphorAnalyticsIntent(t);if(e.ok)return null;const o=e.errors.map(n=>n.path?`${n.code} at ${n.path}: ${n.message}`:`${n.code}: ${n.message}`).join("; ");return new Error(`Invalid Semaphor analytics intent. ${o}`)}function c(t,e,o){return JSON.stringify({intent:t,activeInputs:e,error:o==null?void 0:o.message})}function et(t){const[e,o]=u.useState(t.defaultValue),n=Object.prototype.hasOwnProperty.call(t,"value"),r=n?t.value:e,a=u.useMemo(()=>$(t.options),[t.options]),i=u.useCallback(s=>{var d;const p=s;(d=t.onValueChange)==null||d.call(t,p),n||o(p)},[n,t]),l=u.useCallback(()=>i(void 0),[i]);return u.useMemo(()=>{const s=w(t);return{id:t.id,kind:t.kind,label:t.label,field:s.field,operator:s.operator,source:s.source,controlRole:t.kind==="control"?t.role:void 0,value:r,options:a,isActive:S(r),setValue:i,clear:l,toAnalyticsInput:()=>({inputId:s.inputId,field:s.field,kind:t.kind,label:t.label,value:r,isActive:S(r),operator:s.operator,source:s.source,controlRole:t.kind==="control"?t.role:void 0})}},[l,a,i,t,r])}function rt(t){const e=u.useMemo(()=>Y(t),[t]),o=u.useCallback(a=>{var i;return e.intent?(i=a.executor)==null?void 0:i.executeMetric(e.intent,a):void 0},[e.intent]),n=E(e.queryKey,o,e.idleData,e.activeInputs),r=e.error?e.idleData:n.data;return{id:t.id,intent:e.intent,value:(r==null?void 0:r.value)??null,metrics:r==null?void 0:r.metrics,comparisonValue:r==null?void 0:r.comparisonValue,delta:r==null?void 0:r.delta,deltaPercent:r==null?void 0:r.deltaPercent,records:r==null?void 0:r.records,status:e.error?"error":n.status,isLoading:!e.error&&n.status==="loading",error:e.error||n.error}}function nt(t){const e=u.useMemo(()=>Z(t),[t]),o=u.useCallback(a=>{var i;return e.intent?(i=a.executor)==null?void 0:i.executeRecords(e.intent,a):void 0},[e.intent]),n=E(e.queryKey,o,e.idleData,e.activeInputs),r=e.error?e.idleData:n.data;return{id:t.id,intent:e.intent,records:(r==null?void 0:r.records)||[],columns:r==null?void 0:r.columns,rowCount:r==null?void 0:r.rowCount,status:e.error?"error":n.status,isLoading:!e.error&&n.status==="loading",error:e.error||n.error}}function ot(t){const e=u.useMemo(()=>tt(t),[t]),o=u.useCallback(a=>{var i;return e.intent?(i=a.executor)==null?void 0:i.executeInputOptions(e.intent,a):void 0},[e.intent]),n=E(e.queryKey,o,e.idleData),r=e.error?e.idleData:n.data;return{id:t.id,intent:e.intent,options:(r==null?void 0:r.options)||[],status:e.error?"error":n.status,isLoading:!e.error&&n.status==="loading",error:e.error||n.error}}function E(t,e,o,n){const r=C(),a=u.useRef(e),i=u.useRef(n),[l,s]=u.useState({status:"idle",data:o,error:null});return a.current=e,i.current=n,u.useEffect(()=>{let p;try{p=a.current({...r,activeInputs:i.current})}catch(f){s({status:"error",data:o,error:h(f)});return}if(!p){s({status:"idle",data:o,error:null});return}let d=!1;return s(f=>({status:"loading",data:f.data,error:null})),p.then(f=>{d||s({status:"success",data:f,error:null})}).catch(f=>{d||s({status:"error",data:o,error:h(f)})}),()=>{d=!0}},[o,t,r]),l}exports.SemaphorDataAppContext=D;exports.SemaphorDataAppProvider=H;exports.createSemaphorDataAppExecutor=B;exports.hasSemaphorInputValue=S;exports.normalizeSemaphorInputOptions=$;exports.readWindowRuntime=_;exports.toSemaphorActiveInputSnapshots=A;exports.toSemaphorInputBinding=M;exports.toSemaphorInputBindings=N;exports.toSemaphorInputOptionsIntent=q;exports.toSemaphorInputSnapshots=O;exports.toSemaphorInputSpec=w;exports.toSemaphorMetricIntent=x;exports.toSemaphorRecordsIntent=R;exports.useSemaphorDataAppRuntime=C;exports.useSemaphorInput=et;exports.useSemaphorInputOptions=ot;exports.useSemaphorMetric=rt;exports.useSemaphorRecords=nt;

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

@@ -1,8 +1,8 @@
-import { j as $ } from "../chunks/index-CuHybtft.js";
-import { createContext as w, useContext as O, useMemo as p, useState as x, useCallback as h, useRef as b, useEffect as _ } from "react";
+import { j as w } from "../chunks/index-CuHybtft.js";
+import { createContext as $, useContext as O, useMemo as p, useState as x, useCallback as h, useRef as b, useEffect as _ } from "react";
 import { jsx as B } from "react/jsx-runtime";
-import { v as T } from "../chunks/validators-BuaRUBQI.js";
-function K(t) {
+import { v as T } from "../chunks/validators-BOqiGymD.js";
+function M(t) {
   var r;
   return {
     version: 1,
@@ -10,26 +10,35 @@ function K(t) {
     id: t.id,
     label: t.label,
     source: k(t),
-    metric: t.metric,
-    metrics: t.metrics,
+    metrics: K(t),
+    primaryMetric: t.primaryMetric || t.metrics[0],
     dateField: t.dateField ? f(t.dateField, "date") : void 0,
     timeGrain: t.timeGrain,
     dimensions: (r = t.dimensions) == null ? void 0 : r.map((o) => f(o, "dimension")),
-    comparison: Q(t.comparison),
+    comparison: G(t.comparison),
     inputs: g(t.inputs),
     limit: t.limit
   };
 }
+function K(t) {
+  return Array.from(
+    new Set(
+      t.metrics.filter(
+        (r) => typeof r == "string" && r.trim().length > 0
+      )
+    )
+  );
+}
 function C(t) {
   if ("sort" in t)
     throw new Error(
       "useSemaphorRecords supports orderBy for a single deterministic sort. Multiple sort clauses are not supported by the analytics protocol yet."
     );
-  if (!j(t))
+  if (!L(t))
     throw new Error(
       "useSemaphorRecords needs at least one field, dimension, or measure."
     );
-  const r = z(
+  const r = Q(
     t.fields,
     t.dimensions,
     t.measures
@@ -74,17 +83,17 @@ function U(t) {
     field: t.field
   };
 }
-function st(t) {
+function lt(t) {
   const r = g(t);
   return r.length > 0 ? r : void 0;
 }
-function M(t) {
-  return (t || []).map(F);
+function N(t) {
+  return (t || []).map(j);
 }
 function R(t) {
-  return M(t).filter((r) => r.isActive);
+  return N(t).filter((r) => r.isActive);
 }
-function N(t) {
+function V(t) {
   return t.kind === "filter" ? {
     inputId: t.id,
     kind: t.kind,
@@ -98,7 +107,7 @@ function N(t) {
     label: t.label
   };
 }
-function V(t = []) {
+function F(t = []) {
   return t.map(
     (r) => typeof r == "object" ? r : {
       label: String(r),
@@ -109,7 +118,7 @@ function V(t = []) {
 function A(t) {
   return t == null ? !1 : Array.isArray(t) ? t.length > 0 : typeof t == "string" ? t.trim().length > 0 : !0;
 }
-function F(t) {
+function j(t) {
   return "toAnalyticsInput" in t ? t.toAnalyticsInput() : "kind" in t && "isActive" in t ? t : {
     ...t,
     kind: "filter",
@@ -134,19 +143,19 @@ function k(t) {
     label: t.sourceLabel
   };
 }
-function j(t) {
+function L(t) {
   var r, o, n;
   return !!((r = t.fields) != null && r.length || (o = t.dimensions) != null && o.length || (n = t.measures) != null && n.length);
 }
-function L(t) {
+function z(t) {
   return !!(t != null && t.length);
 }
-function z(t, r, o) {
+function Q(t, r, o) {
   const n = [], e = /* @__PURE__ */ new Set(), a = (i) => {
     const s = `${i.role || ""}:${i.name}`;
     e.has(s) || (e.add(s), n.push(i));
   };
-  return L(t) && t.map((i) => f(i)).forEach(a), r == null || r.map((i) => f(i, "dimension")).forEach(a), o == null || o.map((i) => f(i, "measure")).forEach(a), n;
+  return z(t) && t.map((i) => f(i)).forEach(a), r == null || r.map((i) => f(i, "dimension")).forEach(a), o == null || o.map((i) => f(i, "measure")).forEach(a), n;
 }
 function f(t, r) {
   return typeof t == "string" ? r ? { name: t, role: r } : { name: t } : {
@@ -157,11 +166,11 @@ function f(t, r) {
 function g(t) {
   return (t || []).map(U);
 }
-function Q(t) {
+function G(t) {
   if (!(!t || t === "none"))
     return typeof t == "object" ? t : t === "same_period_last_year" ? { kind: "previous_year" } : { kind: t };
 }
-function G() {
+function J() {
   return {
     executeMetric: (t, r) => v(t, r),
     executeRecords: (t, r) => v(t, r),
@@ -171,7 +180,7 @@ function G() {
 async function v(t, r) {
   if (!r.token)
     throw new Error("SemaphorDataAppProvider needs a token to execute queries.");
-  const o = await fetch(W(r), {
+  const o = await fetch(X(r), {
     method: "POST",
     headers: {
       "Content-Type": "application/json",
@@ -182,14 +191,14 @@ async function v(t, r) {
       activeInputs: r.activeInputs,
       resultShape: t.kind
     })
-  }), n = await J(o);
+  }), n = await H(o);
   if (!o.ok || n.error)
     throw new Error(
       n.error || `Semaphor Data App execution failed with status ${o.status}.`
     );
   return n;
 }
-async function J(t) {
+async function H(t) {
   const r = await t.text().catch(() => "");
   if (!r.trim())
     return t.ok ? {
@@ -202,36 +211,36 @@ async function J(t) {
       error: "Semaphor Data App execution returned invalid JSON.",
       details: r
     } : {
-      error: H(t, r),
+      error: W(t, r),
       details: r
     };
   }
 }
-function H(t, r) {
+function W(t, r) {
   const o = t.statusText ? ` ${t.statusText}` : "", n = r.replace(/\s+/g, " ").trim();
   return n ? `Semaphor Data App execution failed with status ${t.status}${o}: ${n.slice(0, 240)}` : `Semaphor Data App execution failed with status ${t.status}${o}.`;
 }
-function W(t) {
-  const r = X(t).replace(/\/+$/, "");
+function X(t) {
+  const r = Y(t).replace(/\/+$/, "");
   return r ? r.endsWith("/api") ? `${r}/v1/data-app/execute` : `${r}/api/v1/data-app/execute` : "/api/v1/data-app/execute";
 }
-function X(t) {
+function Y(t) {
   if (t.apiBaseUrl)
     return t.apiBaseUrl;
   if (!t.token)
     return "";
   try {
-    return $(t.token).apiServiceUrl || "";
+    return w(t.token).apiServiceUrl || "";
   } catch {
     return "";
   }
 }
-const q = w({});
-function Y() {
+const q = $({});
+function Z() {
   if (!(typeof window > "u"))
     return window.__SEMAPHOR_DATA_APP_RUNTIME__;
 }
-function Z() {
+function tt() {
   return O(q);
 }
 function dt({
@@ -240,8 +249,8 @@ function dt({
   executor: o,
   children: n
 }) {
-  var d;
-  const e = Y(), a = ((d = e == null ? void 0 : e.authToken) == null ? void 0 : d.accessToken) || t, i = (e == null ? void 0 : e.dataApiBaseUrl) || (e == null ? void 0 : e.apiBaseUrl) || r, s = p(() => G(), []), u = o || s, c = p(
+  var l;
+  const e = Z(), a = ((l = e == null ? void 0 : e.authToken) == null ? void 0 : l.accessToken) || t, i = (e == null ? void 0 : e.dataApiBaseUrl) || (e == null ? void 0 : e.apiBaseUrl) || r, s = p(() => J(), []), u = o || s, c = p(
     () => ({
       token: a,
       apiBaseUrl: i,
@@ -251,21 +260,21 @@ function dt({
   );
   return /* @__PURE__ */ B(q.Provider, { value: c, children: n });
 }
-const I = { value: null }, tt = { records: [] }, S = { options: [] };
-function rt(t) {
+const I = { value: null }, rt = { records: [] }, S = { options: [] };
+function et(t) {
   const r = R(t.inputs);
   try {
-    const o = K(t), n = D(o);
+    const o = M(t), n = D(o);
     return n ? {
       error: n,
       activeInputs: r,
-      queryKey: l(void 0, r, n),
+      queryKey: d(void 0, r, n),
       idleData: I
     } : {
       intent: o,
       error: null,
       activeInputs: r,
-      queryKey: l(o, r),
+      queryKey: d(o, r),
       idleData: I
     };
   } catch (o) {
@@ -273,25 +282,25 @@ function rt(t) {
     return {
       error: n,
       activeInputs: r,
-      queryKey: l(void 0, r, n),
+      queryKey: d(void 0, r, n),
       idleData: I
     };
   }
 }
-function et(t) {
-  const r = R(t.inputs), o = tt;
+function nt(t) {
+  const r = R(t.inputs), o = rt;
   try {
     const n = C(t), e = D(n);
     return e ? {
       error: e,
       activeInputs: r,
-      queryKey: l(void 0, r, e),
+      queryKey: d(void 0, r, e),
       idleData: o
     } : {
       intent: n,
       error: null,
       activeInputs: r,
-      queryKey: l(n, r),
+      queryKey: d(n, r),
       idleData: o
     };
   } catch (n) {
@@ -299,29 +308,29 @@ function et(t) {
     return {
       error: e,
       activeInputs: r,
-      queryKey: l(void 0, r, e),
+      queryKey: d(void 0, r, e),
       idleData: o
     };
   }
 }
-function nt(t) {
+function ot(t) {
   try {
     const r = P(t), o = D(r);
     return o ? {
       error: o,
-      queryKey: l(void 0, void 0, o),
+      queryKey: d(void 0, void 0, o),
       idleData: S
     } : {
       intent: r,
       error: null,
-      queryKey: l(r),
+      queryKey: d(r),
       idleData: S
     };
   } catch (r) {
     const o = y(r);
     return {
       error: o,
-      queryKey: l(void 0, void 0, o),
+      queryKey: d(void 0, void 0, o),
       idleData: S
     };
   }
@@ -338,27 +347,27 @@ function D(t) {
   ).join("; ");
   return new Error(`Invalid Semaphor analytics intent. ${o}`);
 }
-function l(t, r, o) {
+function d(t, r, o) {
   return JSON.stringify({
     intent: t,
     activeInputs: r,
     error: o == null ? void 0 : o.message
   });
 }
-function lt(t) {
+function ct(t) {
   const [r, o] = x(t.defaultValue), n = Object.prototype.hasOwnProperty.call(t, "value"), e = n ? t.value : r, a = p(
-    () => V(t.options),
+    () => F(t.options),
     [t.options]
   ), i = h(
     (u) => {
-      var d;
+      var l;
       const c = u;
-      (d = t.onValueChange) == null || d.call(t, c), n || o(c);
+      (l = t.onValueChange) == null || l.call(t, c), n || o(c);
     },
     [n, t]
   ), s = h(() => i(void 0), [i]);
   return p(() => {
-    const u = N(t);
+    const u = V(t);
     return {
       id: t.id,
       kind: t.kind,
@@ -386,8 +395,8 @@ function lt(t) {
     };
   }, [s, a, i, t, e]);
 }
-function ct(t) {
-  const r = p(() => rt(t), [t]), o = h(
+function ft(t) {
+  const r = p(() => et(t), [t]), o = h(
     (a) => {
       var i;
       return r.intent ? (i = a.executor) == null ? void 0 : i.executeMetric(r.intent, a) : void 0;
@@ -413,8 +422,8 @@ function ct(t) {
     error: r.error || n.error
   };
 }
-function ft(t) {
-  const r = p(() => et(t), [t]), o = h(
+function mt(t) {
+  const r = p(() => nt(t), [t]), o = h(
     (a) => {
       var i;
       return r.intent ? (i = a.executor) == null ? void 0 : i.executeRecords(r.intent, a) : void 0;
@@ -437,8 +446,8 @@ function ft(t) {
     error: r.error || n.error
   };
 }
-function mt(t) {
-  const r = p(() => nt(t), [t]), o = h(
+function pt(t) {
+  const r = p(() => ot(t), [t]), o = h(
     (a) => {
       var i;
       return r.intent ? (i = a.executor) == null ? void 0 : i.executeInputOptions(r.intent, a) : void 0;
@@ -459,7 +468,7 @@ function mt(t) {
   };
 }
 function E(t, r, o, n) {
-  const e = Z(), a = b(r), i = b(n), [s, u] = x({
+  const e = tt(), a = b(r), i = b(n), [s, u] = x({
     status: "idle",
     data: o,
     error: null
@@ -483,42 +492,42 @@ function E(t, r, o, n) {
       u({ status: "idle", data: o, error: null });
       return;
     }
-    let d = !1;
+    let l = !1;
     return u((m) => ({
       status: "loading",
       data: m.data,
       error: null
     })), c.then((m) => {
-      d || u({ status: "success", data: m, error: null });
+      l || u({ status: "success", data: m, error: null });
     }).catch((m) => {
-      d || u({
+      l || u({
         status: "error",
         data: o,
         error: y(m)
       });
     }), () => {
-      d = !0;
+      l = !0;
     };
   }, [o, t, e]), s;
 }
 export {
   q as SemaphorDataAppContext,
   dt as SemaphorDataAppProvider,
-  G as createSemaphorDataAppExecutor,
+  J as createSemaphorDataAppExecutor,
   A as hasSemaphorInputValue,
-  V as normalizeSemaphorInputOptions,
-  Y as readWindowRuntime,
+  F as normalizeSemaphorInputOptions,
+  Z as readWindowRuntime,
   R as toSemaphorActiveInputSnapshots,
   U as toSemaphorInputBinding,
-  st as toSemaphorInputBindings,
+  lt as toSemaphorInputBindings,
   P as toSemaphorInputOptionsIntent,
-  M as toSemaphorInputSnapshots,
-  N as toSemaphorInputSpec,
-  K as toSemaphorMetricIntent,
+  N as toSemaphorInputSnapshots,
+  V as toSemaphorInputSpec,
+  M as toSemaphorMetricIntent,
   C as toSemaphorRecordsIntent,
-  Z as useSemaphorDataAppRuntime,
-  lt as useSemaphorInput,
-  mt as useSemaphorInputOptions,
-  ct as useSemaphorMetric,
-  ft as useSemaphorRecords
+  tt as useSemaphorDataAppRuntime,
+  ct as useSemaphorInput,
+  pt as useSemaphorInputOptions,
+  ft as useSemaphorMetric,
+  mt as useSemaphorRecords
 };

package/dist/types/analytics-protocol.d.ts

@@ -97,7 +97,8 @@ export declare const SEMAPHOR_ANALYTICS_INTENT_FIXTURES: {
             readonly connectionId: "conn_sales";
             readonly label: "Orders";
         };
-        metric: string;
+        metrics: string[];
+        primaryMetric: string;
         comparison: {
             kind: "previous_period";
         };
@@ -189,7 +190,8 @@ export declare const SEMAPHOR_ANALYTICS_INTENT_FIXTURES: {
             readonly connectionId: "conn_sales";
             readonly label: "Orders";
         };
-        metric: string;
+        metrics: string[];
+        primaryMetric: string;
         dateField: {
             name: string;
             role: "date";
@@ -201,6 +203,46 @@ export declare const SEMAPHOR_ANALYTICS_INTENT_FIXTURES: {
         };
         limit: number;
     };
+    inboundSupplierConcentration: {
+        version: 1;
+        kind: "metric";
+        id: string;
+        label: string;
+        source: {
+            readonly kind: "semantic";
+            readonly domainId: "domain_sales";
+            readonly datasetName: "orders";
+            readonly connectionId: "conn_sales";
+            readonly label: "Orders";
+        };
+        metrics: string[];
+        primaryMetric: string;
+        dateField: {
+            name: string;
+            role: "date";
+            dataType: "date";
+        };
+        timeWindow: {
+            unit: "month";
+            value: number;
+            anchor: "latest_available";
+        };
+        dimensions: {
+            name: string;
+            role: "dimension";
+            dataType: "number";
+        }[];
+        filters: {
+            field: {
+                name: string;
+                role: "dimension";
+                dataType: "string";
+            };
+            operator: "=";
+            value: string;
+        }[];
+        limit: number;
+    };
     boundedSqlRanking: {
         version: 1;
         kind: "sql";
@@ -229,6 +271,17 @@ export declare const SEMAPHOR_ANALYTICS_INTENT_FIXTURES: {
     };
 };
 
+export declare type SemaphorAgentFilterInput = {
+    id?: string;
+    field: string | SemaphorFieldRef;
+    operator?: SemaphorAgentFilterInputOperator;
+    operation?: SemaphorAgentFilterInputOperator | string;
+    value?: unknown;
+    values?: unknown[];
+};
+
+export declare type SemaphorAgentFilterInputOperator = SemaphorAnalyticsFilterOperator | 'equals' | 'eq' | 'not_equals' | 'neq' | 'like' | 'not_like' | 'not in' | 'not contains' | 'not between' | 'is_null' | 'is_not_null' | 'is null' | 'is not null';
+
 export declare type SemaphorAnalyticsExecutionResult = {
     intentId?: string;
     queryId?: string;
@@ -246,6 +299,8 @@ export declare type SemaphorAnalyticsExecutionResult = {
     };
     missingFields?: string[];
     warnings?: string[];
+    relationshipDiagnostics?: SemaphorRelationshipDiagnostics;
+    population?: SemaphorAnalyticsPopulation;
     metadata?: Record<string, unknown>;
 };
 
@@ -253,6 +308,16 @@ export declare type SemaphorAnalyticsExecutionStatus = 'answered' | 'partial' |
 
 export declare type SemaphorAnalyticsFieldRole = 'metric' | 'dateField' | 'dimension' | 'input' | 'source' | 'sql';
 
+export declare type SemaphorAnalyticsFilter = {
+    id?: string;
+    field: SemaphorFieldRef;
+    operator?: SemaphorAnalyticsFilterOperator;
+    value?: unknown;
+    values?: unknown[];
+};
+
+export declare type SemaphorAnalyticsFilterOperator = SemaphorInputOperator | 'not_contains' | 'is_null' | 'is_not_null';
+
 export declare type SemaphorAnalyticsIntent = SemaphorMetricIntent | SemaphorRecordsIntent | SemaphorInputOptionsIntent | SemaphorSqlIntent;
 
 export declare type SemaphorAnalyticsIntentFixtureName = keyof typeof SEMAPHOR_ANALYTICS_INTENT_FIXTURES;
@@ -277,6 +342,11 @@ export declare type SemaphorAnalyticsObligation = {
 
 export declare type SemaphorAnalyticsObligationType = 'record_list' | 'count' | 'trend' | 'comparison' | 'driver_analysis' | 'metric_summary' | 'analysis_table' | 'lookup' | 'unknown';
 
+export declare type SemaphorAnalyticsPopulation = {
+    scope: 'filtered_query';
+    metrics: Record<string, number | string | null>;
+};
+
 export declare type SemaphorAnalyticsRecoveryPlan = {
     version: SemaphorProtocolVersion;
     kind: 'analytics_recovery_plan';
@@ -406,7 +476,7 @@ export declare type SemaphorInputBinding = {
     field?: SemaphorFieldRef;
 };
 
-export declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'between' | '>' | '>=' | '<' | '<=';
+export declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'between' | 'not_between' | '>' | '>=' | '<' | '<=';
 
 export declare type SemaphorInputOptionsIntent = {
     kind: 'inputOptions';
@@ -464,12 +534,15 @@ export declare type SemaphorMetricIntent = {
     version?: SemaphorProtocolVersion;
     id?: string;
     source: SemaphorSourceRef;
-    metric: string;
-    metrics?: string[];
+    metrics: string[];
+    primaryMetric?: string;
+    metricRefs?: SemaphorFieldRef[];
     label?: string;
     dateField?: SemaphorFieldRef;
     timeGrain?: SemaphorTimeGrain;
+    timeWindow?: SemaphorTimeWindow;
     dimensions?: SemaphorFieldRef[];
+    filters?: SemaphorAnalyticsFilter[];
     comparison?: {
         kind: 'previous_period' | 'previous_year' | 'target';
         targetValue?: number;
@@ -557,6 +630,27 @@ export declare type SemaphorRecoveryToolCall = {
     recoveryKind?: 'schema_discovery' | 'query_spec' | 'sql' | 'unsupported';
 };
 
+export declare type SemaphorRelationshipDiagnostics = {
+    status: SemaphorRelationshipDiagnosticStatus;
+    requiredSources?: SemaphorSourceRef[];
+    relationshipsUsed?: string[];
+    missingSources?: string[];
+    warnings?: string[];
+    message?: string;
+    recommendedNextStep?: string;
+    joinPlanSummary?: {
+        baseSource?: SemaphorSourceRef;
+        joinedSources?: SemaphorSourceRef[];
+        joinCount?: number;
+    };
+    fanoutRisk?: {
+        status: 'none' | 'warning' | 'error' | 'unknown';
+        message?: string;
+    };
+};
+
+export declare type SemaphorRelationshipDiagnosticStatus = 'not_required' | 'resolved' | 'missing' | 'ambiguous' | 'fanout_risk' | 'unknown';
+
 export declare type SemaphorSourceCoordinateInput = {
     databaseName?: string;
     schemaName?: string;
@@ -625,7 +719,7 @@ export declare type SemaphorSqlResult = SemaphorAnalyticsResultBase & {
 export declare type SemaphorTimeGrain = 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
 
 export declare type SemaphorTimeWindow = {
-    unit: 'day' | 'month';
+    unit: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
     value: number;
     anchor?: 'now' | 'latest_available';
 };