react-semaphor 0.1.328 → 0.1.330

package/dist/analytics-protocol/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=require("../chunks/validators-odlRJblR.js");function o(e){return typeof e=="string"?e.trim().toLowerCase():""}function f(e){return String(e.column_name||e.name||e.qualifiedFieldName||"")}function v(e){return Array.from(new Set([e.column_name,e.name,e.qualifiedFieldName,e.alias].filter(i=>typeof i=="string"&&i.trim().length>0).map(i=>i.trim())))}function m(e){const i=o(e);return i?i.includes("int")||i.includes("numeric")||i.includes("decimal")||i.includes("double")||i.includes("float")||i.includes("number")||i.includes("real")||i.includes("money")?"number":i.includes("timestamp")||i.includes("datetime")||i==="time"||i.startsWith("time ")?"datetime":i.includes("date")?"date":i.includes("bool")?"boolean":"string":"unknown"}function A(e){const i=m(e);return i==="date"||i==="datetime"}function u(e){return A(e.dataType||e.data_type)}function p(e){const i=b(e);return i==="id"||i==="row_id"}function l(e){const i=b(e);return p(e)||i.endsWith("_id")||i.endsWith("_key")||i.endsWith("_number")}function b(e){return o(f(e)||e.name||e.alias).replace(/[^a-z0-9]+/g,"_").replace(/^_+|_+$/g,"")}function g(e,i={}){const n=o(e.role);return n==="metric"||n==="measure"?!i.excludeIdentifiers||!l(e):n==="groupby"||n==="dimension"||n==="date"||n==="id"?!1:m(e.dataType||e.data_type)==="number"&&(!i.excludeIdentifiers||!l(e))}function T(e){return!g(e)&&!u(e)}function F(e){return[e.column_name,e.name,e.label,e.alias,e.qualifiedFieldName].filter(i=>typeof i=="string"&&i.trim().length>0).map(i=>o(i).replace(/[^a-z0-9]+/g," ")).join(" ")}function d(e,i){return i.some(n=>{const t=n.replace(/[.*+?^${}()|[\]\\]/g,"\\$&");return new RegExp(`(^|\\s)${t}(\\s|$)`,"i").test(e)})}function C(e){const i=F(e);if(i)return d(i,["pct","percent","percentage","rate","ratio","share","conversion","retention","churn","growth","margin rate","margin pct","margin percent","margin percentage"])?{type:"percent",minimumFractionDigits:0,maximumFractionDigits:1,percentValueMode:"fraction"}:d(i,["revenue","sales","profit","arr","mrr","gmv","amount","price","cost","spend","expense","budget","income","value","booking","bookings"])?{type:"currency",currency:"USD",minimumFractionDigits:0,maximumFractionDigits:1,compact:!0}:d(i,["count","quantity","orders","order","users","customers","tickets","units","sessions","visits","items","rows"])?{type:"number",minimumFractionDigits:0,maximumFractionDigits:0,compact:!0}:{type:"number",minimumFractionDigits:0,maximumFractionDigits:1,compact:!0}}function D(e){const i=new Set,n=new Set,t=new Set;for(const s of e){if(p(s))continue;const c=v(s);if(c.length!==0){if(u(s)){c.forEach(a=>n.add(a));continue}if(g(s,{excludeIdentifiers:!0})){c.forEach(a=>i.add(a));continue}c.forEach(a=>t.add(a))}}return{validMetricCandidates:Array.from(i).sort(),validDateCandidates:Array.from(n).sort(),validDimensionCandidates:Array.from(t).sort()}}const r={kind:"semantic",domainId:"domain_sales",datasetName:"orders",connectionId:"conn_sales",label:"Orders"},_={revenueKpi:{version:1,kind:"metric",id:"revenue-kpi",label:"Revenue",source:r,metric:"revenue",comparison:{kind:"previous_period"},limit:1},revenueTrend:{version:1,kind:"records",id:"revenue-trend",label:"Revenue trend",source:r,fields:[{name:"order_date",role:"date",dataType:"date",label:"Order Date"}],measures:["revenue"],dateField:{name:"order_date",role:"date",dataType:"date"},timeGrain:"month",limit:100},topCustomersRecords:{version:1,kind:"records",id:"top-customers",label:"Top customers",source:r,fields:[{name:"customer_name",role:"dimension",dataType:"string"},{name:"segment",role:"dimension",dataType:"string"},{name:"revenue",role:"measure",dataType:"number"}],measures:["revenue"],orderBy:{field:"revenue",direction:"desc"},limit:20},regionInputOptions:{version:1,kind:"inputOptions",id:"region-options",label:"Region options",source:r,field:{name:"region",role:"dimension",dataType:"string"},limit:100},previousPeriodRevenueComparison:{version:1,kind:"metric",id:"revenue-previous-period",label:"Revenue previous period comparison",source:r,metric:"revenue",dateField:{name:"order_date",role:"date",dataType:"date"},timeGrain:"week",comparison:{kind:"previous_period"},limit:100},boundedSqlRanking:{version:1,kind:"sql",id:"top-customer-ranking-sql",label:"Top customer ranking SQL",source:{kind:"physical",connectionId:"conn_sales",databaseName:"warehouse",schemaName:"public",tableName:"orders",dialect:"postgres"},sql:"SELECT customer_name, SUM(revenue) AS revenue FROM public.orders GROUP BY customer_name ORDER BY revenue DESC LIMIT 20",limit:20,rationale:"Ranking is SQL-natural because it requires ordering grouped aggregate rows.",fields:[{name:"customer_name",role:"dimension",dataType:"string"},{name:"revenue",role:"measure",dataType:"number"}]}};exports.validateSemaphorAnalyticsIntent=y.validateSemaphorAnalyticsIntent;exports.validateSemaphorDashboardIntent=y.validateSemaphorDashboardIntent;exports.SEMAPHOR_ANALYTICS_INTENT_FIXTURES=_;exports.buildAnalyticsCatalogFieldSummary=D;exports.getAnalyticsCatalogFieldCandidates=v;exports.getAnalyticsCatalogFieldName=f;exports.inferAnalyticsMetricFormat=C;exports.isAnalyticsCatalogDateField=u;exports.isAnalyticsCatalogDimensionField=T;exports.isAnalyticsCatalogMetricField=g;exports.isAnalyticsDateLikeDataType=A;exports.isAnalyticsMetricIdentifierField=l;exports.isAnalyticsTechnicalIdentifierField=p;exports.normalizeAnalyticsCatalogDataType=m;exports.normalizeAnalyticsCatalogName=o;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("../chunks/validators-odlRJblR.js");function s(e){return typeof e=="string"?e.trim().toLowerCase():""}function g(e){return String(e.column_name||e.name||e.qualifiedFieldName||"")}function y(e){return Array.from(new Set([e.column_name,e.name,e.qualifiedFieldName,e.alias].filter(a=>typeof a=="string"&&a.trim().length>0).map(a=>a.trim())))}function u(e){const a=s(e);return a?a.includes("int")||a.includes("numeric")||a.includes("decimal")||a.includes("double")||a.includes("float")||a.includes("number")||a.includes("real")||a.includes("money")?"number":a.includes("timestamp")||a.includes("datetime")||a==="time"||a.startsWith("time ")?"datetime":a.includes("date")?"date":a.includes("bool")?"boolean":"string":"unknown"}function h(e){const a=u(e);return a==="date"||a==="datetime"}function m(e){return h(e.dataType||e.data_type)}function p(e){const a=v(e);return a==="id"||a==="row_id"}function d(e){const a=v(e);return p(e)||a.endsWith("_id")||a.endsWith("_key")||a.endsWith("_number")}function v(e){return s(g(e)||e.name||e.alias).replace(/[^a-z0-9]+/g,"_").replace(/^_+|_+$/g,"")}function f(e,a={}){const t=s(e.role);return t==="metric"||t==="measure"?!a.excludeIdentifiers||!d(e):t==="groupby"||t==="dimension"||t==="date"||t==="id"?!1:u(e.dataType||e.data_type)==="number"&&(!a.excludeIdentifiers||!d(e))}function A(e){return!f(e)&&!m(e)}function S(e){return[e.column_name,e.name,e.label,e.alias,e.qualifiedFieldName].filter(a=>typeof a=="string"&&a.trim().length>0).map(a=>s(a).replace(/[^a-z0-9]+/g," ")).join(" ")}function c(e,a){return a.some(t=>{const i=t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&");return new RegExp(`(^|\\s)${i}(\\s|$)`,"i").test(e)})}function T(e){const a=S(e);if(a)return c(a,["pct","percent","percentage","rate","ratio","share","conversion","retention","churn","growth","margin rate","margin pct","margin percent","margin percentage"])?{type:"percent",minimumFractionDigits:0,maximumFractionDigits:1,percentValueMode:"fraction"}:c(a,["revenue","sales","profit","arr","mrr","gmv","amount","price","cost","spend","expense","budget","income","value","booking","bookings"])?{type:"currency",currency:"USD",minimumFractionDigits:0,maximumFractionDigits:1,compact:!0}:c(a,["count","quantity","orders","order","users","customers","tickets","units","sessions","visits","items","rows"])?{type:"number",minimumFractionDigits:0,maximumFractionDigits:0,compact:!0}:{type:"number",minimumFractionDigits:0,maximumFractionDigits:1,compact:!0}}function k(e){const a=new Set,t=new Set,i=new Set;for(const o of e){if(p(o))continue;const l=y(o);if(l.length!==0){if(m(o)){l.forEach(r=>t.add(r));continue}if(f(o,{excludeIdentifiers:!0})){l.forEach(r=>a.add(r));continue}l.forEach(r=>i.add(r))}}return{validMetricCandidates:Array.from(a).sort(),validDateCandidates:Array.from(t).sort(),validDimensionCandidates:Array.from(i).sort()}}function D(e,a={}){const t=F(e),i={connectionId:a.connectionId,connectionType:e,path:["database","schema","table"],labels:{database:"Database",schema:"Schema",table:"Table"},prefixLevels:["database","schema","table"],dialect:"postgres",supportsFilterClause:!0};return t.includes("postgres")?{...i,prefixLevels:["schema","table"],dialect:"postgres"}:t.includes("mysql")?{...i,prefixLevels:["database","table"],dialect:"mysql",supportsFilterClause:!1}:t.includes("mssql")||t.includes("sqlserver")?{...i,dialect:"mssql",supportsFilterClause:!1}:t.includes("redshift")?{...i,prefixLevels:["schema","table"],dialect:"redshift"}:t.includes("snowflake")?{...i,dialect:"snowflake"}:t.includes("clickhouse")?{connectionId:a.connectionId,connectionType:e,path:["database","table"],labels:{database:"Database",table:"Table"},prefixLevels:["database","table"],dialect:"clickhouse",supportsFilterClause:!1}:t==="s3"||t==="api"?{connectionId:a.connectionId,connectionType:e,path:["table"],labels:{table:t==="api"?"API Table":"File Table"},prefixLevels:["table"],dialect:"duckdb",supportsFilterClause:!0}:t==="googlesheets"||t==="fileupload"?{connectionId:a.connectionId,connectionType:e,path:["table"],labels:{table:"Table"},prefixLevels:["table"],dialect:"postgres",supportsFilterClause:!0}:t==="s3tables"?{...i,labels:{database:"Database",schema:"Namespace",table:"Table"},dialect:"duckdb"}:t==="bigquery"?{...i,labels:{database:"Project",schema:"Dataset",table:"Table"},prefixLevels:["schema","table"],dialect:"bigquery",supportsFilterClause:!1}:i}function I(e){const a=F(e);switch(a){case"mysql":case"bigquery":case"redshift":case"snowflake":case"clickhouse":case"duckdb":case"sqlite":return a;case"mssql":case"sqlserver":return"mssql";case"postgres":case"postgresql":return"postgres";case"semantic":return"semantic";default:return"unknown"}}function q(e){return e.capabilities.prefixLevels.every(a=>!!C(e.source,a))}function _(e){const a=e.quoteIdentifier??N;return e.capabilities.prefixLevels.map(t=>C(e.source,t)).filter(t=>!!t).map(t=>a(t,e.capabilities.dialect)).join(".")}function C(e,a){return a==="database"?e.databaseName:a==="schema"?e.schemaName:e.tableName}function N(e,a){return a==="mysql"||a==="bigquery"||a==="clickhouse"||a==="duckdb"?`\`${e.replace(/`/g,"``")}\``:a==="mssql"?`[${e.replace(/]/g,"]]")}]`:`"${e.replace(/"/g,'""')}"`}function F(e){if(typeof e!="string")return"";const a=[];for(const t of e.trim().toLowerCase())x(t)&&a.push(t);return a.join("")}function x(e){const a=e.charCodeAt(0);return a>=48&&a<=57||a>=97&&a<=122}const n={kind:"semantic",domainId:"domain_sales",datasetName:"orders",connectionId:"conn_sales",label:"Orders"},L={revenueKpi:{version:1,kind:"metric",id:"revenue-kpi",label:"Revenue",source:n,metric:"revenue",comparison:{kind:"previous_period"},limit:1},revenueTrend:{version:1,kind:"records",id:"revenue-trend",label:"Revenue trend",source:n,fields:[{name:"order_date",role:"date",dataType:"date",label:"Order Date"}],measures:["revenue"],dateField:{name:"order_date",role:"date",dataType:"date"},timeGrain:"month",limit:100},topCustomersRecords:{version:1,kind:"records",id:"top-customers",label:"Top customers",source:n,fields:[{name:"customer_name",role:"dimension",dataType:"string"},{name:"segment",role:"dimension",dataType:"string"},{name:"revenue",role:"measure",dataType:"number"}],measures:["revenue"],orderBy:{field:"revenue",direction:"desc"},limit:20},regionInputOptions:{version:1,kind:"inputOptions",id:"region-options",label:"Region options",source:n,field:{name:"region",role:"dimension",dataType:"string"},limit:100},previousPeriodRevenueComparison:{version:1,kind:"metric",id:"revenue-previous-period",label:"Revenue previous period comparison",source:n,metric:"revenue",dateField:{name:"order_date",role:"date",dataType:"date"},timeGrain:"week",comparison:{kind:"previous_period"},limit:100},boundedSqlRanking:{version:1,kind:"sql",id:"top-customer-ranking-sql",label:"Top customer ranking SQL",source:{kind:"physical",connectionId:"conn_sales",databaseName:"warehouse",schemaName:"public",tableName:"orders",dialect:"postgres"},sql:"SELECT customer_name, SUM(revenue) AS revenue FROM public.orders GROUP BY customer_name ORDER BY revenue DESC LIMIT 20",limit:20,rationale:"Ranking is SQL-natural because it requires ordering grouped aggregate rows.",fields:[{name:"customer_name",role:"dimension",dataType:"string"},{name:"revenue",role:"measure",dataType:"number"}]}};exports.validateSemaphorAnalyticsIntent=b.validateSemaphorAnalyticsIntent;exports.validateSemaphorDashboardIntent=b.validateSemaphorDashboardIntent;exports.SEMAPHOR_ANALYTICS_INTENT_FIXTURES=L;exports.buildAnalyticsCatalogFieldSummary=k;exports.buildSemaphorQualifiedSourcePath=_;exports.getAnalyticsCatalogFieldCandidates=y;exports.getAnalyticsCatalogFieldName=g;exports.getSemaphorConnectionCapabilities=D;exports.inferAnalyticsMetricFormat=T;exports.isAnalyticsCatalogDateField=m;exports.isAnalyticsCatalogDimensionField=A;exports.isAnalyticsCatalogMetricField=f;exports.isAnalyticsDateLikeDataType=h;exports.isAnalyticsMetricIdentifierField=d;exports.isAnalyticsTechnicalIdentifierField=p;exports.normalizeAnalyticsCatalogDataType=u;exports.normalizeAnalyticsCatalogName=s;exports.normalizeSemaphorDialect=I;exports.semaphorSourceHasRequiredCoordinates=q;

package/dist/analytics-protocol/index.js

@@ -1,8 +1,8 @@
-import { v as C, a as S } from "../chunks/validators-DDAweCzB.js";
-function d(e) {
+import { v as R, a as z } from "../chunks/validators-DDAweCzB.js";
+function c(e) {
   return typeof e == "string" ? e.trim().toLowerCase() : "";
 }
-function f(e) {
+function h(e) {
   return String(e.column_name || e.name || e.qualifiedFieldName || "");
 }
 function v(e) {
@@ -14,45 +14,45 @@ function v(e) {
         e.qualifiedFieldName,
         e.alias
       ].filter(
-        (n) => typeof n == "string" && n.trim().length > 0
-      ).map((n) => n.trim())
+        (t) => typeof t == "string" && t.trim().length > 0
+      ).map((t) => t.trim())
     )
   );
 }
-function m(e) {
-  const n = d(e);
-  return n ? n.includes("int") || n.includes("numeric") || n.includes("decimal") || n.includes("double") || n.includes("float") || n.includes("number") || n.includes("real") || n.includes("money") ? "number" : n.includes("timestamp") || n.includes("datetime") || n === "time" || n.startsWith("time ") ? "datetime" : n.includes("date") ? "date" : n.includes("bool") ? "boolean" : "string" : "unknown";
+function d(e) {
+  const t = c(e);
+  return t ? t.includes("int") || t.includes("numeric") || t.includes("decimal") || t.includes("double") || t.includes("float") || t.includes("number") || t.includes("real") || t.includes("money") ? "number" : t.includes("timestamp") || t.includes("datetime") || t === "time" || t.startsWith("time ") ? "datetime" : t.includes("date") ? "date" : t.includes("bool") ? "boolean" : "string" : "unknown";
 }
-function b(e) {
-  const n = m(e);
-  return n === "date" || n === "datetime";
+function C(e) {
+  const t = d(e);
+  return t === "date" || t === "datetime";
 }
-function l(e) {
-  return b(e.dataType || e.data_type);
+function m(e) {
+  return C(e.dataType || e.data_type);
 }
 function p(e) {
-  const n = g(e);
-  return n === "id" || n === "row_id";
+  const t = f(e);
+  return t === "id" || t === "row_id";
 }
 function u(e) {
-  const n = g(e);
-  return p(e) || n.endsWith("_id") || n.endsWith("_key") || n.endsWith("_number");
+  const t = f(e);
+  return p(e) || t.endsWith("_id") || t.endsWith("_key") || t.endsWith("_number");
 }
-function g(e) {
-  return d(
-    f(e) || e.name || e.alias
+function f(e) {
+  return c(
+    h(e) || e.name || e.alias
   ).replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
 }
-function y(e, n = {}) {
-  const i = d(e.role);
-  return i === "metric" || i === "measure" ? !n.excludeIdentifiers || !u(e) : i === "groupby" || i === "dimension" || i === "date" || i === "id" ? !1 : m(
+function b(e, t = {}) {
+  const a = c(e.role);
+  return a === "metric" || a === "measure" ? !t.excludeIdentifiers || !u(e) : a === "groupby" || a === "dimension" || a === "date" || a === "id" ? !1 : d(
     e.dataType || e.data_type
-  ) === "number" && (!n.excludeIdentifiers || !u(e));
+  ) === "number" && (!t.excludeIdentifiers || !u(e));
 }
-function _(e) {
-  return !y(e) && !l(e);
+function q(e) {
+  return !b(e) && !m(e);
 }
-function T(e) {
+function k(e) {
   return [
     e.column_name,
     e.name,
@@ -60,21 +60,21 @@ function T(e) {
     e.alias,
     e.qualifiedFieldName
   ].filter(
-    (n) => typeof n == "string" && n.trim().length > 0
+    (t) => typeof t == "string" && t.trim().length > 0
   ).map(
-    (n) => d(n).replace(/[^a-z0-9]+/g, " ")
+    (t) => c(t).replace(/[^a-z0-9]+/g, " ")
   ).join(" ");
 }
-function c(e, n) {
-  return n.some((i) => {
-    const t = i.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-    return new RegExp(`(^|\\s)${t}(\\s|$)`, "i").test(e);
+function l(e, t) {
+  return t.some((a) => {
+    const r = a.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    return new RegExp(`(^|\\s)${r}(\\s|$)`, "i").test(e);
   });
 }
-function F(e) {
-  const n = T(e);
-  if (n)
-    return c(n, [
+function D(e) {
+  const t = k(e);
+  if (t)
+    return l(t, [
       "pct",
       "percent",
       "percentage",
@@ -94,7 +94,7 @@ function F(e) {
       minimumFractionDigits: 0,
       maximumFractionDigits: 1,
       percentValueMode: "fraction"
-    } : c(n, [
+    } : l(t, [
       "revenue",
       "sales",
       "profit",
@@ -117,7 +117,7 @@ function F(e) {
       minimumFractionDigits: 0,
       maximumFractionDigits: 1,
       compact: !0
-    } : c(n, [
+    } : l(t, [
       "count",
       "quantity",
       "orders",
@@ -142,43 +142,178 @@ function F(e) {
       compact: !0
     };
 }
-function D(e) {
-  const n = /* @__PURE__ */ new Set(), i = /* @__PURE__ */ new Set(), t = /* @__PURE__ */ new Set();
-  for (const o of e) {
-    if (p(o))
+function I(e) {
+  const t = /* @__PURE__ */ new Set(), a = /* @__PURE__ */ new Set(), r = /* @__PURE__ */ new Set();
+  for (const s of e) {
+    if (p(s))
       continue;
-    const s = v(o);
-    if (s.length !== 0) {
-      if (l(o)) {
-        s.forEach((r) => i.add(r));
+    const o = v(s);
+    if (o.length !== 0) {
+      if (m(s)) {
+        o.forEach((i) => a.add(i));
         continue;
       }
-      if (y(o, { excludeIdentifiers: !0 })) {
-        s.forEach((r) => n.add(r));
+      if (b(s, { excludeIdentifiers: !0 })) {
+        o.forEach((i) => t.add(i));
         continue;
       }
-      s.forEach((r) => t.add(r));
+      o.forEach((i) => r.add(i));
     }
   }
   return {
-    validMetricCandidates: Array.from(n).sort(),
-    validDateCandidates: Array.from(i).sort(),
-    validDimensionCandidates: Array.from(t).sort()
+    validMetricCandidates: Array.from(t).sort(),
+    validDateCandidates: Array.from(a).sort(),
+    validDimensionCandidates: Array.from(r).sort()
   };
 }
-const a = {
+function S(e, t = {}) {
+  const a = y(e), r = {
+    connectionId: t.connectionId,
+    connectionType: e,
+    path: ["database", "schema", "table"],
+    labels: {
+      database: "Database",
+      schema: "Schema",
+      table: "Table"
+    },
+    prefixLevels: ["database", "schema", "table"],
+    dialect: "postgres",
+    supportsFilterClause: !0
+  };
+  return a.includes("postgres") ? {
+    ...r,
+    prefixLevels: ["schema", "table"],
+    dialect: "postgres"
+  } : a.includes("mysql") ? {
+    ...r,
+    prefixLevels: ["database", "table"],
+    dialect: "mysql",
+    supportsFilterClause: !1
+  } : a.includes("mssql") || a.includes("sqlserver") ? {
+    ...r,
+    dialect: "mssql",
+    supportsFilterClause: !1
+  } : a.includes("redshift") ? {
+    ...r,
+    prefixLevels: ["schema", "table"],
+    dialect: "redshift"
+  } : a.includes("snowflake") ? {
+    ...r,
+    dialect: "snowflake"
+  } : a.includes("clickhouse") ? {
+    connectionId: t.connectionId,
+    connectionType: e,
+    path: ["database", "table"],
+    labels: {
+      database: "Database",
+      table: "Table"
+    },
+    prefixLevels: ["database", "table"],
+    dialect: "clickhouse",
+    supportsFilterClause: !1
+  } : a === "s3" || a === "api" ? {
+    connectionId: t.connectionId,
+    connectionType: e,
+    path: ["table"],
+    labels: {
+      table: a === "api" ? "API Table" : "File Table"
+    },
+    prefixLevels: ["table"],
+    dialect: "duckdb",
+    supportsFilterClause: !0
+  } : a === "googlesheets" || a === "fileupload" ? {
+    connectionId: t.connectionId,
+    connectionType: e,
+    path: ["table"],
+    labels: {
+      table: "Table"
+    },
+    prefixLevels: ["table"],
+    dialect: "postgres",
+    supportsFilterClause: !0
+  } : a === "s3tables" ? {
+    ...r,
+    labels: {
+      database: "Database",
+      schema: "Namespace",
+      table: "Table"
+    },
+    dialect: "duckdb"
+  } : a === "bigquery" ? {
+    ...r,
+    labels: {
+      database: "Project",
+      schema: "Dataset",
+      table: "Table"
+    },
+    prefixLevels: ["schema", "table"],
+    dialect: "bigquery",
+    supportsFilterClause: !1
+  } : r;
+}
+function _(e) {
+  const t = y(e);
+  switch (t) {
+    case "mysql":
+    case "bigquery":
+    case "redshift":
+    case "snowflake":
+    case "clickhouse":
+    case "duckdb":
+    case "sqlite":
+      return t;
+    case "mssql":
+    case "sqlserver":
+      return "mssql";
+    case "postgres":
+    case "postgresql":
+      return "postgres";
+    case "semantic":
+      return "semantic";
+    default:
+      return "unknown";
+  }
+}
+function A(e) {
+  return e.capabilities.prefixLevels.every(
+    (t) => !!g(e.source, t)
+  );
+}
+function x(e) {
+  const t = e.quoteIdentifier ?? F;
+  return e.capabilities.prefixLevels.map((a) => g(e.source, a)).filter((a) => !!a).map((a) => t(a, e.capabilities.dialect)).join(".");
+}
+function g(e, t) {
+  return t === "database" ? e.databaseName : t === "schema" ? e.schemaName : e.tableName;
+}
+function F(e, t) {
+  return t === "mysql" || t === "bigquery" || t === "clickhouse" || t === "duckdb" ? `\`${e.replace(/`/g, "``")}\`` : t === "mssql" ? `[${e.replace(/]/g, "]]")}]` : `"${e.replace(/"/g, '""')}"`;
+}
+function y(e) {
+  if (typeof e != "string")
+    return "";
+  const t = [];
+  for (const a of e.trim().toLowerCase())
+    T(a) && t.push(a);
+  return t.join("");
+}
+function T(e) {
+  const t = e.charCodeAt(0);
+  return t >= 48 && t <= 57 || t >= 97 && t <= 122;
+}
+const n = {
   kind: "semantic",
   domainId: "domain_sales",
   datasetName: "orders",
   connectionId: "conn_sales",
   label: "Orders"
-}, h = {
+}, w = {
   revenueKpi: {
     version: 1,
     kind: "metric",
     id: "revenue-kpi",
     label: "Revenue",
-    source: a,
+    source: n,
     metric: "revenue",
     comparison: { kind: "previous_period" },
     limit: 1
@@ -188,7 +323,7 @@ const a = {
     kind: "records",
     id: "revenue-trend",
     label: "Revenue trend",
-    source: a,
+    source: n,
     fields: [
       { name: "order_date", role: "date", dataType: "date", label: "Order Date" }
     ],
@@ -202,7 +337,7 @@ const a = {
     kind: "records",
     id: "top-customers",
     label: "Top customers",
-    source: a,
+    source: n,
     fields: [
       { name: "customer_name", role: "dimension", dataType: "string" },
       { name: "segment", role: "dimension", dataType: "string" },
@@ -217,7 +352,7 @@ const a = {
     kind: "inputOptions",
     id: "region-options",
     label: "Region options",
-    source: a,
+    source: n,
     field: { name: "region", role: "dimension", dataType: "string" },
     limit: 100
   },
@@ -226,7 +361,7 @@ const a = {
     kind: "metric",
     id: "revenue-previous-period",
     label: "Revenue previous period comparison",
-    source: a,
+    source: n,
     metric: "revenue",
     dateField: { name: "order_date", role: "date", dataType: "date" },
     timeGrain: "week",
@@ -256,19 +391,23 @@ const a = {
   }
 };
 export {
-  h as SEMAPHOR_ANALYTICS_INTENT_FIXTURES,
-  D as buildAnalyticsCatalogFieldSummary,
+  w as SEMAPHOR_ANALYTICS_INTENT_FIXTURES,
+  I as buildAnalyticsCatalogFieldSummary,
+  x as buildSemaphorQualifiedSourcePath,
   v as getAnalyticsCatalogFieldCandidates,
-  f as getAnalyticsCatalogFieldName,
-  F as inferAnalyticsMetricFormat,
-  l as isAnalyticsCatalogDateField,
-  _ as isAnalyticsCatalogDimensionField,
-  y as isAnalyticsCatalogMetricField,
-  b as isAnalyticsDateLikeDataType,
+  h as getAnalyticsCatalogFieldName,
+  S as getSemaphorConnectionCapabilities,
+  D as inferAnalyticsMetricFormat,
+  m as isAnalyticsCatalogDateField,
+  q as isAnalyticsCatalogDimensionField,
+  b as isAnalyticsCatalogMetricField,
+  C as isAnalyticsDateLikeDataType,
   u as isAnalyticsMetricIdentifierField,
   p as isAnalyticsTechnicalIdentifierField,
-  m as normalizeAnalyticsCatalogDataType,
-  d as normalizeAnalyticsCatalogName,
-  C as validateSemaphorAnalyticsIntent,
-  S as validateSemaphorDashboardIntent
+  d as normalizeAnalyticsCatalogDataType,
+  c as normalizeAnalyticsCatalogName,
+  _ as normalizeSemaphorDialect,
+  A as semaphorSourceHasRequiredCoordinates,
+  R as validateSemaphorAnalyticsIntent,
+  z as validateSemaphorDashboardIntent
 };

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

@@ -48,10 +48,20 @@ export declare type AnalyticsMetricFormat = {
 
 export declare function buildAnalyticsCatalogFieldSummary(fields: AnalyticsCatalogField[]): AnalyticsCatalogFieldSummary;
 
+export declare function buildSemaphorQualifiedSourcePath(input: {
+    capabilities: Pick<SemaphorConnectionCapabilities, 'prefixLevels' | 'dialect'>;
+    source: SemaphorSourceCoordinateInput;
+    quoteIdentifier?: (value: string, dialect: SemaphorDialect) => string;
+}): string;
+
 export declare function getAnalyticsCatalogFieldCandidates(field: AnalyticsCatalogField): string[];
 
 export declare function getAnalyticsCatalogFieldName(field: AnalyticsCatalogField): string;
 
+export declare function getSemaphorConnectionCapabilities(connectionType: string | undefined, options?: {
+    connectionId?: string;
+}): SemaphorConnectionCapabilities;
+
 export declare function inferAnalyticsMetricFormat(field: AnalyticsCatalogField): AnalyticsMetricFormat | undefined;
 
 export declare function isAnalyticsCatalogDateField(field: AnalyticsCatalogField): boolean;
@@ -72,6 +82,8 @@ export declare function normalizeAnalyticsCatalogDataType(value: unknown): Analy
 
 export declare function normalizeAnalyticsCatalogName(value: unknown): string;
 
+export declare function normalizeSemaphorDialect(input: string | undefined): SemaphorDialect;
+
 export declare const SEMAPHOR_ANALYTICS_INTENT_FIXTURES: {
     revenueKpi: {
         version: 1;
@@ -217,6 +229,18 @@ export declare const SEMAPHOR_ANALYTICS_INTENT_FIXTURES: {
     };
 };
 
+export declare type SemaphorAnalyticsExecutionResult = {
+    intentId?: string;
+    queryId?: string;
+    status: SemaphorAnalyticsExecutionStatus;
+    result?: SemaphorAnalyticsResult;
+    validation: SemaphorAnalyticsValidationResult;
+    missingFields?: string[];
+    warnings?: string[];
+};
+
+export declare type SemaphorAnalyticsExecutionStatus = 'answered' | 'partial' | 'failed';
+
 export declare type SemaphorAnalyticsFieldRole = 'metric' | 'dateField' | 'dimension' | 'input' | 'source' | 'sql';
 
 export declare type SemaphorAnalyticsIntent = SemaphorMetricIntent | SemaphorRecordsIntent | SemaphorInputOptionsIntent | SemaphorSqlIntent;
@@ -260,6 +284,43 @@ export declare type SemaphorAnalyticsValidationResult = {
     repairHints: SemaphorAnalyticsRepairHint[];
 };
 
+export declare type SemaphorCompiledQuery = {
+    kind: 'config';
+    queryId: string;
+    source: SemaphorSourceRef;
+    cardType: string;
+    connectionId: string;
+    cardConfig: unknown;
+    cardDataSource: unknown;
+    activeFilters?: unknown[];
+    rowLimit: number;
+    analyticsIntent?: SemaphorAnalyticsIntent;
+} | {
+    kind: 'sql';
+    queryId: string;
+    source: Extract<SemaphorSourceRef, {
+        kind: 'physical' | 'sql';
+    }>;
+    connectionId: string;
+    dialect: SemaphorDialect;
+    sql: string;
+    parameters?: Record<string, unknown>;
+    pythonCode?: string;
+    activeFilters?: unknown[];
+    rowLimit: number;
+    analyticsIntent?: SemaphorAnalyticsIntent;
+};
+
+export declare type SemaphorConnectionCapabilities = {
+    connectionId?: string;
+    connectionType?: string;
+    dialect: SemaphorDialect;
+    path: SemaphorSourceLevel[];
+    labels: Partial<Record<SemaphorSourceLevel, string>>;
+    prefixLevels: SemaphorSourceLevel[];
+    supportsFilterClause: boolean;
+};
+
 export declare type SemaphorDashboardIntent = {
     version: SemaphorProtocolVersion;
     kind: 'dashboard';
@@ -285,7 +346,7 @@ export declare type SemaphorDashboardViewIntent = {
     text?: string;
 };
 
-export declare type SemaphorDialect = 'semantic' | 'postgres' | 'mysql' | 'snowflake' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
+export declare type SemaphorDialect = 'semantic' | 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
 
 export declare type SemaphorExperienceIntent = SemaphorDashboardIntent;
 
@@ -416,6 +477,19 @@ export declare type SemaphorRecordsResult = SemaphorAnalyticsResultBase & {
     records: Array<Record<string, unknown>>;
 };
 
+export declare type SemaphorSourceCoordinateInput = {
+    databaseName?: string;
+    schemaName?: string;
+    tableName?: string;
+};
+
+export declare function semaphorSourceHasRequiredCoordinates(input: {
+    capabilities: Pick<SemaphorConnectionCapabilities, 'prefixLevels'>;
+    source: SemaphorSourceCoordinateInput;
+}): boolean;
+
+export declare type SemaphorSourceLevel = 'database' | 'schema' | 'table';
+
 export declare type SemaphorSourceRef = {
     kind: 'semantic';
     domainId: string;
@@ -426,6 +500,7 @@ export declare type SemaphorSourceRef = {
 } | {
     kind: 'physical';
     connectionId: string;
+    connectionType?: string;
     tableName: string;
     databaseName?: string;
     schemaName?: string;

package/dist/types/dashboard-authoring.d.ts

@@ -1854,7 +1854,7 @@ declare type SemaphorDashboardViewIntent = {
     text?: string;
 };
 
-declare type SemaphorDialect = 'semantic' | 'postgres' | 'mysql' | 'snowflake' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
+declare type SemaphorDialect = 'semantic' | 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
 
 declare type SemaphorFieldRef = {
     name: string;
@@ -1955,6 +1955,7 @@ declare type SemaphorSourceRef = {
 } | {
     kind: 'physical';
     connectionId: string;
+    connectionType?: string;
     tableName: string;
     databaseName?: string;
     schemaName?: string;

package/dist/types/data-app-builder.d.ts

@@ -482,7 +482,7 @@ export declare type ReasoningEffort = 'low' | 'medium' | 'high';
 
 declare type SemaphorAnalyticsIntent = SemaphorMetricIntent | SemaphorRecordsIntent | SemaphorInputOptionsIntent | SemaphorSqlIntent;
 
-declare type SemaphorDialect = 'semantic' | 'postgres' | 'mysql' | 'snowflake' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
+declare type SemaphorDialect = 'semantic' | 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
 
 declare type SemaphorFieldRef = {
     name: string;
@@ -559,6 +559,7 @@ declare type SemaphorSourceRef = {
 } | {
     kind: 'physical';
     connectionId: string;
+    connectionType?: string;
     tableName: string;
     databaseName?: string;
     schemaName?: string;

package/dist/types/data-app-sdk.d.ts

@@ -246,7 +246,7 @@ declare type SemaphorDataAppWindowRuntime = {
     };
 };
 
-declare type SemaphorDialect = 'semantic' | 'postgres' | 'mysql' | 'snowflake' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
+declare type SemaphorDialect = 'semantic' | 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
 
 declare type SemaphorFieldRef = {
     name: string;
@@ -323,6 +323,7 @@ declare type SemaphorSourceRef = {
 } | {
     kind: 'physical';
     connectionId: string;
+    connectionType?: string;
     tableName: string;
     databaseName?: string;
     schemaName?: string;

package/dist/types/main.d.ts

@@ -4421,7 +4421,7 @@ export declare const SemaphorContextProvider: ({ children, dashboardProps, }: {
     dashboardProps: DashboardProps;
 }) => JSX.Element;
 
-declare type SemaphorDialect = 'semantic' | 'postgres' | 'mysql' | 'snowflake' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
+declare type SemaphorDialect = 'semantic' | 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
 
 declare type SemaphorFieldRef = {
     name: string;
@@ -4502,6 +4502,7 @@ declare type SemaphorSourceRef = {
 } | {
     kind: 'physical';
     connectionId: string;
+    connectionType?: string;
     tableName: string;
     databaseName?: string;
     schemaName?: string;

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.328",
+  "version": "0.1.330",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",