react-semaphor 0.1.387 → 0.1.389

package/dist/analytics-protocol/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("../chunks/operators-DrTQsJXv.js"),s=require("../chunks/validators-lWo8m0Q7.js"),o=require("../chunks/analyze-result-contract-CtXfp3nv.js"),i=require("../chunks/catalog-field-grounding-Bnx-3tE0.js"),l=require("../chunks/source-identity-C-xaeE_I.js");function m(e,a={}){const r=c(e),t={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 r.includes("postgres")?{...t,prefixLevels:["schema","table"],dialect:"postgres"}:r.includes("mysql")?{...t,prefixLevels:["database","table"],dialect:"mysql",supportsFilterClause:!1}:r.includes("mssql")||r.includes("sqlserver")?{...t,dialect:"mssql",supportsFilterClause:!1}:r.includes("redshift")?{...t,prefixLevels:["schema","table"],dialect:"redshift"}:r.includes("snowflake")?{...t,dialect:"snowflake"}:r.includes("clickhouse")?{connectionId:a.connectionId,connectionType:e,path:["database","table"],labels:{database:"Database",table:"Table"},prefixLevels:["database","table"],dialect:"clickhouse",supportsFilterClause:!1}:r==="s3"||r==="api"?{connectionId:a.connectionId,connectionType:e,path:["table"],labels:{table:r==="api"?"API Table":"File Table"},prefixLevels:["table"],dialect:"duckdb",supportsFilterClause:!0}:r==="googlesheets"||r==="fileupload"?{connectionId:a.connectionId,connectionType:e,path:["table"],labels:{table:"Table"},prefixLevels:["table"],dialect:"postgres",supportsFilterClause:!0}:r==="s3tables"?{...t,labels:{database:"Database",schema:"Namespace",table:"Table"},dialect:"duckdb"}:r==="bigquery"?{...t,labels:{database:"Project",schema:"Dataset",table:"Table"},prefixLevels:["schema","table"],dialect:"bigquery",supportsFilterClause:!1}:t}function p(e){const a=c(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";default:return"unknown"}}function b(e){return e.capabilities.prefixLevels.every(a=>!!u(e.source,a))}function h(e){const a=e.quoteIdentifier??f;return e.capabilities.prefixLevels.map(r=>u(e.source,r)).filter(r=>!!r).map(r=>a(r,e.capabilities.dialect)).join(".")}function u(e,a){return a==="database"?e.databaseName:a==="schema"?e.schemaName:e.tableName}function f(e,a){return a==="mysql"||a==="bigquery"||a==="clickhouse"||a==="duckdb"?`\`${e.replace(/`/g,"``")}\``:a==="mssql"?`[${e.replace(/]/g,"]]")}]`:`"${e.replace(/"/g,'""')}"`}function c(e){if(typeof e!="string")return"";const a=[];for(const r of e.trim().toLowerCase())y(r)&&a.push(r);return a.join("")}function y(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"},S={revenueKpi:{version:1,kind:"metric",id:"revenue-kpi",label:"Revenue",source:n,measures:[{name:"revenue",role:"measure"}],primaryMeasure:{name:"revenue",role:"measure"},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"},{name:"revenue",role:"measure",dataType:"number"}],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"}],orderBy:{field:{name:"revenue",role:"measure"},direction:"desc"},limit:20},regionInputOptions:{version:1,kind:"inputOptions",id:"region-options",label:"Region options",inputId:"region",source:n,labelField:{name:"region",role:"dimension",dataType:"string"},valueField:{name:"region",role:"dimension",dataType:"string"},limit:100},previousPeriodRevenueComparison:{version:1,kind:"metric",id:"revenue-previous-period",label:"Revenue previous period comparison",source:n,measures:[{name:"revenue",role:"measure"}],primaryMeasure:{name:"revenue",role:"measure"},dateField:{name:"order_date",role:"date",dataType:"date"},timeGrain:"week",comparison:{kind:"previous_period"},limit:100},inboundSupplierConcentration:{version:1,kind:"metric",id:"inbound-supplier-concentration",label:"Inbound supplier concentration",source:n,measures:[{name:"net_tons",role:"measure"},{name:"ticket_value",role:"measure"}],primaryMeasure:{name:"net_tons",role:"measure"},dateField:{name:"ticket_date",role:"date",dataType:"date"},timeWindow:{unit:"month",value:6,anchor:"latest_available"},dimensions:[{name:"supplier_id",role:"dimension",dataType:"number"}],filters:[{field:{name:"direction",role:"dimension",dataType:"string"},operator:"=",values:["Inbound"]}],limit:15},boundedSqlRanking:{version:1,kind:"sql",id:"top-customer-ranking-sql",label:"Top customer ranking SQL",source:{kind:"sql",connectionId:"conn_sales",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.normalizeSemaphorAnalyticsFilterOperator=d.normalizeSemaphorAnalyticsFilterOperator;exports.normalizeSemaphorInputOperator=d.normalizeSemaphorInputOperator;exports.parseSemaphorIsoTimeWindowBoundary=s.parseSemaphorIsoTimeWindowBoundary;exports.validateSemaphorAnalyticsIntent=s.validateSemaphorAnalyticsIntent;exports.validateSemaphorAnalyticsRecoveryPlan=s.validateSemaphorAnalyticsRecoveryPlan;exports.validateSemaphorDashboardIntent=s.validateSemaphorDashboardIntent;exports.validateSemaphorDerivedFieldDefinition=s.validateSemaphorDerivedFieldDefinition;exports.validateSemaphorOperationIntent=s.validateSemaphorOperationIntent;exports.validateSemaphorResultCalculation=s.validateSemaphorResultCalculation;exports.SEMAPHOR_ANALYZE_RESULT_FIELD_CONTRACT=o.SEMAPHOR_ANALYZE_RESULT_FIELD_CONTRACT;exports.getSemaphorAnalyzeResultFieldNames=o.getSemaphorAnalyzeResultFieldNames;exports.isSemaphorAnalyzeResultFieldName=o.isSemaphorAnalyzeResultFieldName;exports.parseSemaphorAnalyzeResult=o.parseSemaphorAnalyzeResult;exports.buildAnalyticsCatalogFieldSummary=i.buildAnalyticsCatalogFieldSummary;exports.getAnalyticsCatalogFieldCandidates=i.getAnalyticsCatalogFieldCandidates;exports.getAnalyticsCatalogFieldName=i.getAnalyticsCatalogFieldName;exports.isAnalyticsCatalogDateField=i.isAnalyticsCatalogDateField;exports.isAnalyticsCatalogDimensionField=i.isAnalyticsCatalogDimensionField;exports.isAnalyticsCatalogMetricField=i.isAnalyticsCatalogMetricField;exports.isAnalyticsDateLikeDataType=i.isAnalyticsDateLikeDataType;exports.isAnalyticsMetricIdentifierField=i.isAnalyticsMetricIdentifierField;exports.isAnalyticsTechnicalIdentifierField=i.isAnalyticsTechnicalIdentifierField;exports.normalizeAnalyticsCatalogDataType=i.normalizeAnalyticsCatalogDataType;exports.normalizeAnalyticsCatalogName=i.normalizeAnalyticsCatalogName;exports.preferSemaphorFieldRefMetadata=l.preferSemaphorFieldRefMetadata;exports.preferSemaphorSourceMetadata=l.preferSemaphorSourceMetadata;exports.semaphorFieldRefsMatch=l.semaphorFieldRefsMatch;exports.semaphorSourceIdentityKey=l.semaphorSourceIdentityKey;exports.semaphorSourcesReferToSameDataset=l.semaphorSourcesReferToSameDataset;exports.SEMAPHOR_ANALYTICS_INTENT_FIXTURES=S;exports.buildSemaphorQualifiedSourcePath=h;exports.getSemaphorConnectionCapabilities=m;exports.normalizeSemaphorDialect=p;exports.semaphorSourceHasRequiredCoordinates=b;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const A=require("../chunks/operators-DrTQsJXv.js"),d=require("../chunks/validators-lWo8m0Q7.js"),b=require("../chunks/analyze-result-contract-CtXfp3nv.js"),o=require("../chunks/catalog-field-grounding-Bnx-3tE0.js"),y=require("../chunks/source-identity-C-xaeE_I.js"),g="semaphor-data-app-codegen-summary/v1";function R(a){return v(a).ok}function v(a){const i=[];if(!a||typeof a!="object")return{ok:!1,issues:["Summary must be an object."]};const e=a;return e.schemaVersion!==g&&i.push(`schemaVersion must be ${g}.`),(typeof e.title!="string"||!e.title.trim())&&i.push("title is required."),Array.isArray(e.sources)||i.push("sources must be an array."),Array.isArray(e.inputs)||i.push("inputs must be an array."),Array.isArray(e.views)||i.push("views must be an array."),Array.isArray(e.filterContracts)||i.push("filterContracts must be an array."),(!e.implementationChecklist||typeof e.implementationChecklist!="object")&&i.push("implementationChecklist must be an object."),e.implementationChecklist&&typeof e.implementationChecklist=="object"&&i.push(...T(e.implementationChecklist)),Array.isArray(e.sources)&&e.sources.forEach((t,r)=>{i.push(...k(t,`sources.${r}`))}),Array.isArray(e.inputs)&&e.inputs.forEach((t,r)=>{i.push(...F(t,`inputs.${r}`))}),Array.isArray(e.views)&&e.views.forEach((t,r)=>{i.push(...$(t,`views.${r}`))}),Array.isArray(e.filterContracts)&&e.filterContracts.forEach((t,r)=>{i.push(...q(t,`filterContracts.${r}`))}),{ok:i.length===0,issues:i}}function k(a,i){const e=s(a);return e?typeof e.sourceKey=="string"&&e.sourceKey.trim()?[]:e.kind==="semantic"&&typeof e.domainId=="string"&&e.domainId.trim()&&(typeof e.datasetName=="string"&&e.datasetName.trim()||typeof e.datasetId=="string"&&e.datasetId.trim())?[]:e.kind==="physical"&&typeof e.tableName=="string"&&e.tableName.trim()&&typeof e.connectionId=="string"&&e.connectionId.trim()?[]:e.kind==="sql"&&typeof e.connectionId=="string"&&e.connectionId.trim()?[]:[`${i} must include sourceKey or a supported source identity.`]:[`${i} must be an object.`]}function T(a){const i=s(a);if(!i)return["implementationChecklist must be an object."];const e=[],t=["requiredDevtools","requiredInputOptions","filterScopeByInput","bindingsByView","validationCommands","browserSmokeChecks"];for(const n of t)n in i||e.push(`implementationChecklist.${n} is required.`);const r=s(i.requiredDevtools);return r?typeof r.mountRootDevtools!="boolean"&&e.push("implementationChecklist.requiredDevtools.mountRootDevtools must be a boolean."):e.push("implementationChecklist.requiredDevtools must be an object."),Array.isArray(i.requiredInputOptions)||e.push("implementationChecklist.requiredInputOptions must be an array."),Array.isArray(i.filterScopeByInput)||e.push("implementationChecklist.filterScopeByInput must be an array."),s(i.bindingsByView)||e.push("implementationChecklist.bindingsByView must be an object."),l(i.validationCommands)||e.push("implementationChecklist.validationCommands must be an array of strings."),l(i.browserSmokeChecks)||e.push("implementationChecklist.browserSmokeChecks must be an array of strings."),e}function F(a,i){const e=s(a);if(!e)return[`${i} must be an object.`];const t=[];return(typeof e.id!="string"||!e.id.trim())&&t.push(`${i}.id is required.`),e.fieldRef&&t.push(...m(e.fieldRef,`${i}.fieldRef`)),t.push(...S(e.optionQuery,`${i}.optionQuery`)),l(e.appliesToViewIds)||t.push(`${i}.appliesToViewIds must be an array of strings.`),e.bindings!==void 0&&!Array.isArray(e.bindings)&&t.push(`${i}.bindings must be an array.`),Array.isArray(e.bindings)&&e.bindings.forEach((r,n)=>{const p=s(r);if(!p){t.push(`${i}.bindings.${n} must be an object.`);return}l(p.appliesToViewIds)||t.push(`${i}.bindings.${n}.appliesToViewIds must be an array of strings.`),t.push(...m(p.fieldRef,`${i}.bindings.${n}.fieldRef`))}),t}function $(a,i){const e=s(a);if(!e)return[`${i} must be an object.`];const t=[];return(typeof e.id!="string"||!e.id.trim())&&t.push(`${i}.id is required.`),Array.isArray(e.fields)?(e.fields.forEach((r,n)=>{t.push(...m(r,`${i}.fields.${n}`))}),t):(_(e)||t.push(`${i}.fields must be an array.`),t)}function q(a,i){const e=s(a);if(!e)return[`${i} must be an object.`];const t=[];if(e.fieldRef&&t.push(...m(e.fieldRef,`${i}.fieldRef`)),(typeof e.inputId!="string"||!e.inputId.trim())&&t.push(`${i}.inputId is required.`),t.push(...S(e.optionQuery,`${i}.optionQuery`)),l(e.appliesToViewIds)||t.push(`${i}.appliesToViewIds must be an array of strings.`),l(e.notAppliedToViewIds)||t.push(`${i}.notAppliedToViewIds must be an array of strings.`),!Array.isArray(e.bindings))t.push(`${i}.bindings must be an array.`);else{const r=l(e.appliesToViewIds)?new Set(e.appliesToViewIds):void 0,n=l(e.notAppliedToViewIds)?new Set(e.notAppliedToViewIds):void 0;e.bindings.forEach((p,f)=>{const u=s(p);if(!u){t.push(`${i}.bindings.${f} must be an object.`);return}typeof u.viewId!="string"||!u.viewId?t.push(`${i}.bindings.${f}.viewId is required.`):(r&&!r.has(u.viewId)&&t.push(`${i}.bindings.${f}.viewId must be included in appliesToViewIds.`),n!=null&&n.has(u.viewId)&&t.push(`${i}.bindings.${f}.viewId must not be listed in notAppliedToViewIds.`)),t.push(...m(u.fieldRef,`${i}.bindings.${f}.fieldRef`))})}return t}function S(a,i){if(a===void 0)return[];const e=s(a);return e?[...h(e.valueFieldRef,`${i}.valueFieldRef`),...h(e.labelFieldRef,`${i}.labelFieldRef`),...h(e.filterFieldRef,`${i}.filterFieldRef`)]:[`${i} must be an object.`]}function _(a){const i=s(a.computation),e=s(a.visualSpec);return(i==null?void 0:i.kind)==="presentation_only"||a.visual==="text_block"||(e==null?void 0:e.visualType)==="text_block"}function h(a,i){return a===void 0?[]:m(a,i)}function m(a,i){const e=s(a);if(!e)return[`${i} must be an object.`];const t=[];return(typeof e.name!="string"||!e.name.trim())&&t.push(`${i}.name is required.`),!e.source&&typeof e.sourceKey!="string"&&t.push(`${i} must include source or sourceKey.`),t}function s(a){return a&&typeof a=="object"&&!Array.isArray(a)?a:void 0}function l(a){return Array.isArray(a)&&a.every(i=>typeof i=="string")}function w(a,i={}){const e=I(a),t={connectionId:i.connectionId,connectionType:a,path:["database","schema","table"],labels:{database:"Database",schema:"Schema",table:"Table"},prefixLevels:["database","schema","table"],dialect:"postgres",supportsFilterClause:!0};return e.includes("postgres")?{...t,prefixLevels:["schema","table"],dialect:"postgres"}:e.includes("mysql")?{...t,prefixLevels:["database","table"],dialect:"mysql",supportsFilterClause:!1}:e.includes("mssql")||e.includes("sqlserver")?{...t,dialect:"mssql",supportsFilterClause:!1}:e.includes("redshift")?{...t,prefixLevels:["schema","table"],dialect:"redshift"}:e.includes("snowflake")?{...t,dialect:"snowflake"}:e.includes("clickhouse")?{connectionId:i.connectionId,connectionType:a,path:["database","table"],labels:{database:"Database",table:"Table"},prefixLevels:["database","table"],dialect:"clickhouse",supportsFilterClause:!1}:e==="s3"||e==="api"?{connectionId:i.connectionId,connectionType:a,path:["table"],labels:{table:e==="api"?"API Table":"File Table"},prefixLevels:["table"],dialect:"duckdb",supportsFilterClause:!0}:e==="googlesheets"||e==="fileupload"?{connectionId:i.connectionId,connectionType:a,path:["table"],labels:{table:"Table"},prefixLevels:["table"],dialect:"postgres",supportsFilterClause:!0}:e==="s3tables"?{...t,labels:{database:"Database",schema:"Namespace",table:"Table"},dialect:"duckdb"}:e==="bigquery"?{...t,labels:{database:"Project",schema:"Dataset",table:"Table"},prefixLevels:["schema","table"],dialect:"bigquery",supportsFilterClause:!1}:t}function D(a){const i=I(a);switch(i){case"mysql":case"bigquery":case"redshift":case"snowflake":case"clickhouse":case"duckdb":case"sqlite":return i;case"mssql":case"sqlserver":return"mssql";case"postgres":case"postgresql":return"postgres";default:return"unknown"}}function E(a){return a.capabilities.prefixLevels.every(i=>!!C(a.source,i))}function N(a){const i=a.quoteIdentifier??O;return a.capabilities.prefixLevels.map(e=>C(a.source,e)).filter(e=>!!e).map(e=>i(e,a.capabilities.dialect)).join(".")}function C(a,i){return i==="database"?a.databaseName:i==="schema"?a.schemaName:a.tableName}function O(a,i){return i==="mysql"||i==="bigquery"||i==="clickhouse"||i==="duckdb"?`\`${a.replace(/`/g,"``")}\``:i==="mssql"?`[${a.replace(/]/g,"]]")}]`:`"${a.replace(/"/g,'""')}"`}function I(a){if(typeof a!="string")return"";const i=[];for(const e of a.trim().toLowerCase())M(e)&&i.push(e);return i.join("")}function M(a){const i=a.charCodeAt(0);return i>=48&&i<=57||i>=97&&i<=122}const c={kind:"semantic",domainId:"domain_sales",datasetName:"orders",connectionId:"conn_sales",label:"Orders"},L={revenueKpi:{version:1,kind:"metric",id:"revenue-kpi",label:"Revenue",source:c,measures:[{name:"revenue",role:"measure"}],primaryMeasure:{name:"revenue",role:"measure"},comparison:{kind:"previous_period"},limit:1},revenueTrend:{version:1,kind:"records",id:"revenue-trend",label:"Revenue trend",source:c,fields:[{name:"order_date",role:"date",dataType:"date",label:"Order Date"},{name:"revenue",role:"measure",dataType:"number"}],dateField:{name:"order_date",role:"date",dataType:"date"},timeGrain:"month",limit:100},topCustomersRecords:{version:1,kind:"records",id:"top-customers",label:"Top customers",source:c,fields:[{name:"customer_name",role:"dimension",dataType:"string"},{name:"segment",role:"dimension",dataType:"string"},{name:"revenue",role:"measure",dataType:"number"}],orderBy:{field:{name:"revenue",role:"measure"},direction:"desc"},limit:20},regionInputOptions:{version:1,kind:"inputOptions",id:"region-options",label:"Region options",inputId:"region",source:c,labelField:{name:"region",role:"dimension",dataType:"string"},valueField:{name:"region",role:"dimension",dataType:"string"},limit:100},previousPeriodRevenueComparison:{version:1,kind:"metric",id:"revenue-previous-period",label:"Revenue previous period comparison",source:c,measures:[{name:"revenue",role:"measure"}],primaryMeasure:{name:"revenue",role:"measure"},dateField:{name:"order_date",role:"date",dataType:"date"},timeGrain:"week",comparison:{kind:"previous_period"},limit:100},inboundSupplierConcentration:{version:1,kind:"metric",id:"inbound-supplier-concentration",label:"Inbound supplier concentration",source:c,measures:[{name:"net_tons",role:"measure"},{name:"ticket_value",role:"measure"}],primaryMeasure:{name:"net_tons",role:"measure"},dateField:{name:"ticket_date",role:"date",dataType:"date"},timeWindow:{unit:"month",value:6,anchor:"latest_available"},dimensions:[{name:"supplier_id",role:"dimension",dataType:"number"}],filters:[{field:{name:"direction",role:"dimension",dataType:"string"},operator:"=",values:["Inbound"]}],limit:15},boundedSqlRanking:{version:1,kind:"sql",id:"top-customer-ranking-sql",label:"Top customer ranking SQL",source:{kind:"sql",connectionId:"conn_sales",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.normalizeSemaphorAnalyticsFilterOperator=A.normalizeSemaphorAnalyticsFilterOperator;exports.normalizeSemaphorInputOperator=A.normalizeSemaphorInputOperator;exports.parseSemaphorIsoTimeWindowBoundary=d.parseSemaphorIsoTimeWindowBoundary;exports.validateSemaphorAnalyticsIntent=d.validateSemaphorAnalyticsIntent;exports.validateSemaphorAnalyticsRecoveryPlan=d.validateSemaphorAnalyticsRecoveryPlan;exports.validateSemaphorDashboardIntent=d.validateSemaphorDashboardIntent;exports.validateSemaphorDerivedFieldDefinition=d.validateSemaphorDerivedFieldDefinition;exports.validateSemaphorOperationIntent=d.validateSemaphorOperationIntent;exports.validateSemaphorResultCalculation=d.validateSemaphorResultCalculation;exports.SEMAPHOR_ANALYZE_RESULT_FIELD_CONTRACT=b.SEMAPHOR_ANALYZE_RESULT_FIELD_CONTRACT;exports.getSemaphorAnalyzeResultFieldNames=b.getSemaphorAnalyzeResultFieldNames;exports.isSemaphorAnalyzeResultFieldName=b.isSemaphorAnalyzeResultFieldName;exports.parseSemaphorAnalyzeResult=b.parseSemaphorAnalyzeResult;exports.buildAnalyticsCatalogFieldSummary=o.buildAnalyticsCatalogFieldSummary;exports.getAnalyticsCatalogFieldCandidates=o.getAnalyticsCatalogFieldCandidates;exports.getAnalyticsCatalogFieldName=o.getAnalyticsCatalogFieldName;exports.isAnalyticsCatalogDateField=o.isAnalyticsCatalogDateField;exports.isAnalyticsCatalogDimensionField=o.isAnalyticsCatalogDimensionField;exports.isAnalyticsCatalogMetricField=o.isAnalyticsCatalogMetricField;exports.isAnalyticsDateLikeDataType=o.isAnalyticsDateLikeDataType;exports.isAnalyticsMetricIdentifierField=o.isAnalyticsMetricIdentifierField;exports.isAnalyticsTechnicalIdentifierField=o.isAnalyticsTechnicalIdentifierField;exports.normalizeAnalyticsCatalogDataType=o.normalizeAnalyticsCatalogDataType;exports.normalizeAnalyticsCatalogName=o.normalizeAnalyticsCatalogName;exports.preferSemaphorFieldRefMetadata=y.preferSemaphorFieldRefMetadata;exports.preferSemaphorSourceMetadata=y.preferSemaphorSourceMetadata;exports.semaphorFieldRefsMatch=y.semaphorFieldRefsMatch;exports.semaphorSourceIdentityKey=y.semaphorSourceIdentityKey;exports.semaphorSourcesReferToSameDataset=y.semaphorSourcesReferToSameDataset;exports.SEMAPHOR_ANALYTICS_INTENT_FIXTURES=L;exports.SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_SCHEMA_VERSION=g;exports.buildSemaphorQualifiedSourcePath=N;exports.getSemaphorConnectionCapabilities=w;exports.isSemaphorDataAppCodegenSummary=R;exports.normalizeSemaphorDialect=D;exports.semaphorSourceHasRequiredCoordinates=E;exports.validateSemaphorDataAppCodegenSummary=v;

package/dist/analytics-protocol/index.js

@@ -1,12 +1,170 @@
-import { a as h, n as v } from "../chunks/operators-C8TxpM4C.js";
-import { p as y, b as S, d as T, e as C, v as I, c as k, a as F } from "../chunks/validators-CHPH6ORs.js";
-import { S as q, g as R, i as _, p as L } from "../chunks/analyze-result-contract-DuhlklhI.js";
-import { j as x, a as N, g as M, c as O, h as z, f as E, i as w, e as P, d as B, b as j, n as Q } from "../chunks/catalog-field-grounding-CJKAqtiC.js";
-import { p as Y, c as G, s as H, a as $, b as K } from "../chunks/source-identity-CN4xiyKJ.js";
-function d(e, a = {}) {
-  const r = n(e), s = {
-    connectionId: a.connectionId,
-    connectionType: e,
+import { a as O, n as V } from "../chunks/operators-C8TxpM4C.js";
+import { p as L, b as M, d as x, e as B, v as P, c as z, a as Q } from "../chunks/validators-CHPH6ORs.js";
+import { S as H, g as U, i as Y, p as G } from "../chunks/analyze-result-contract-DuhlklhI.js";
+import { j as X, a as Z, g as J, c as ee, h as ie, f as se, i as re, e as te, d as ae, b as ne, n as oe } from "../chunks/catalog-field-grounding-CJKAqtiC.js";
+import { p as ue, c as de, s as ce, a as me, b as pe } from "../chunks/source-identity-CN4xiyKJ.js";
+const f = "semaphor-data-app-codegen-summary/v1";
+function T(s) {
+  return g(s).ok;
+}
+function g(s) {
+  const i = [];
+  if (!s || typeof s != "object")
+    return { ok: !1, issues: ["Summary must be an object."] };
+  const e = s;
+  return e.schemaVersion !== f && i.push(
+    `schemaVersion must be ${f}.`
+  ), (typeof e.title != "string" || !e.title.trim()) && i.push("title is required."), Array.isArray(e.sources) || i.push("sources must be an array."), Array.isArray(e.inputs) || i.push("inputs must be an array."), Array.isArray(e.views) || i.push("views must be an array."), Array.isArray(e.filterContracts) || i.push("filterContracts must be an array."), (!e.implementationChecklist || typeof e.implementationChecklist != "object") && i.push("implementationChecklist must be an object."), e.implementationChecklist && typeof e.implementationChecklist == "object" && i.push(
+    ...I(e.implementationChecklist)
+  ), Array.isArray(e.sources) && e.sources.forEach((r, t) => {
+    i.push(...v(r, `sources.${t}`));
+  }), Array.isArray(e.inputs) && e.inputs.forEach((r, t) => {
+    i.push(...A(r, `inputs.${t}`));
+  }), Array.isArray(e.views) && e.views.forEach((r, t) => {
+    i.push(...C(r, `views.${t}`));
+  }), Array.isArray(e.filterContracts) && e.filterContracts.forEach((r, t) => {
+    i.push(
+      ...k(r, `filterContracts.${t}`)
+    );
+  }), { ok: i.length === 0, issues: i };
+}
+function v(s, i) {
+  const e = a(s);
+  return e ? typeof e.sourceKey == "string" && e.sourceKey.trim() ? [] : e.kind === "semantic" && typeof e.domainId == "string" && e.domainId.trim() && (typeof e.datasetName == "string" && e.datasetName.trim() || typeof e.datasetId == "string" && e.datasetId.trim()) ? [] : e.kind === "physical" && typeof e.tableName == "string" && e.tableName.trim() && typeof e.connectionId == "string" && e.connectionId.trim() ? [] : e.kind === "sql" && typeof e.connectionId == "string" && e.connectionId.trim() ? [] : [`${i} must include sourceKey or a supported source identity.`] : [`${i} must be an object.`];
+}
+function I(s) {
+  const i = a(s);
+  if (!i)
+    return ["implementationChecklist must be an object."];
+  const e = [], r = [
+    "requiredDevtools",
+    "requiredInputOptions",
+    "filterScopeByInput",
+    "bindingsByView",
+    "validationCommands",
+    "browserSmokeChecks"
+  ];
+  for (const n of r)
+    n in i || e.push(`implementationChecklist.${n} is required.`);
+  const t = a(i.requiredDevtools);
+  return t ? typeof t.mountRootDevtools != "boolean" && e.push(
+    "implementationChecklist.requiredDevtools.mountRootDevtools must be a boolean."
+  ) : e.push("implementationChecklist.requiredDevtools must be an object."), Array.isArray(i.requiredInputOptions) || e.push(
+    "implementationChecklist.requiredInputOptions must be an array."
+  ), Array.isArray(i.filterScopeByInput) || e.push("implementationChecklist.filterScopeByInput must be an array."), a(i.bindingsByView) || e.push("implementationChecklist.bindingsByView must be an object."), o(i.validationCommands) || e.push(
+    "implementationChecklist.validationCommands must be an array of strings."
+  ), o(i.browserSmokeChecks) || e.push(
+    "implementationChecklist.browserSmokeChecks must be an array of strings."
+  ), e;
+}
+function A(s, i) {
+  const e = a(s);
+  if (!e)
+    return [`${i} must be an object.`];
+  const r = [];
+  return (typeof e.id != "string" || !e.id.trim()) && r.push(`${i}.id is required.`), e.fieldRef && r.push(...d(e.fieldRef, `${i}.fieldRef`)), r.push(...b(e.optionQuery, `${i}.optionQuery`)), o(e.appliesToViewIds) || r.push(`${i}.appliesToViewIds must be an array of strings.`), e.bindings !== void 0 && !Array.isArray(e.bindings) && r.push(`${i}.bindings must be an array.`), Array.isArray(e.bindings) && e.bindings.forEach((t, n) => {
+    const c = a(t);
+    if (!c) {
+      r.push(`${i}.bindings.${n} must be an object.`);
+      return;
+    }
+    o(c.appliesToViewIds) || r.push(
+      `${i}.bindings.${n}.appliesToViewIds must be an array of strings.`
+    ), r.push(
+      ...d(
+        c.fieldRef,
+        `${i}.bindings.${n}.fieldRef`
+      )
+    );
+  }), r;
+}
+function C(s, i) {
+  const e = a(s);
+  if (!e)
+    return [`${i} must be an object.`];
+  const r = [];
+  return (typeof e.id != "string" || !e.id.trim()) && r.push(`${i}.id is required.`), Array.isArray(e.fields) ? (e.fields.forEach((t, n) => {
+    r.push(...d(t, `${i}.fields.${n}`));
+  }), r) : (S(e) || r.push(`${i}.fields must be an array.`), r);
+}
+function k(s, i) {
+  const e = a(s);
+  if (!e)
+    return [`${i} must be an object.`];
+  const r = [];
+  if (e.fieldRef && r.push(
+    ...d(e.fieldRef, `${i}.fieldRef`)
+  ), (typeof e.inputId != "string" || !e.inputId.trim()) && r.push(`${i}.inputId is required.`), r.push(
+    ...b(e.optionQuery, `${i}.optionQuery`)
+  ), o(e.appliesToViewIds) || r.push(`${i}.appliesToViewIds must be an array of strings.`), o(e.notAppliedToViewIds) || r.push(`${i}.notAppliedToViewIds must be an array of strings.`), !Array.isArray(e.bindings))
+    r.push(`${i}.bindings must be an array.`);
+  else {
+    const t = o(e.appliesToViewIds) ? new Set(e.appliesToViewIds) : void 0, n = o(
+      e.notAppliedToViewIds
+    ) ? new Set(e.notAppliedToViewIds) : void 0;
+    e.bindings.forEach((c, m) => {
+      const l = a(c);
+      if (!l) {
+        r.push(`${i}.bindings.${m} must be an object.`);
+        return;
+      }
+      typeof l.viewId != "string" || !l.viewId ? r.push(`${i}.bindings.${m}.viewId is required.`) : (t && !t.has(l.viewId) && r.push(
+        `${i}.bindings.${m}.viewId must be included in appliesToViewIds.`
+      ), n != null && n.has(l.viewId) && r.push(
+        `${i}.bindings.${m}.viewId must not be listed in notAppliedToViewIds.`
+      )), r.push(
+        ...d(
+          l.fieldRef,
+          `${i}.bindings.${m}.fieldRef`
+        )
+      );
+    });
+  }
+  return r;
+}
+function b(s, i) {
+  if (s === void 0)
+    return [];
+  const e = a(s);
+  return e ? [
+    ...p(
+      e.valueFieldRef,
+      `${i}.valueFieldRef`
+    ),
+    ...p(
+      e.labelFieldRef,
+      `${i}.labelFieldRef`
+    ),
+    ...p(
+      e.filterFieldRef,
+      `${i}.filterFieldRef`
+    )
+  ] : [`${i} must be an object.`];
+}
+function S(s) {
+  const i = a(s.computation), e = a(s.visualSpec);
+  return (i == null ? void 0 : i.kind) === "presentation_only" || s.visual === "text_block" || (e == null ? void 0 : e.visualType) === "text_block";
+}
+function p(s, i) {
+  return s === void 0 ? [] : d(s, i);
+}
+function d(s, i) {
+  const e = a(s);
+  if (!e)
+    return [`${i} must be an object.`];
+  const r = [];
+  return (typeof e.name != "string" || !e.name.trim()) && r.push(`${i}.name is required.`), !e.source && typeof e.sourceKey != "string" && r.push(`${i} must include source or sourceKey.`), r;
+}
+function a(s) {
+  return s && typeof s == "object" && !Array.isArray(s) ? s : void 0;
+}
+function o(s) {
+  return Array.isArray(s) && s.every((i) => typeof i == "string");
+}
+function w(s, i = {}) {
+  const e = h(s), r = {
+    connectionId: i.connectionId,
+    connectionType: s,
     path: ["database", "schema", "table"],
     labels: {
       database: "Database",
@@ -17,29 +175,29 @@ function d(e, a = {}) {
     dialect: "postgres",
     supportsFilterClause: !0
   };
-  return r.includes("postgres") ? {
-    ...s,
+  return e.includes("postgres") ? {
+    ...r,
     prefixLevels: ["schema", "table"],
     dialect: "postgres"
-  } : r.includes("mysql") ? {
-    ...s,
+  } : e.includes("mysql") ? {
+    ...r,
     prefixLevels: ["database", "table"],
     dialect: "mysql",
     supportsFilterClause: !1
-  } : r.includes("mssql") || r.includes("sqlserver") ? {
-    ...s,
+  } : e.includes("mssql") || e.includes("sqlserver") ? {
+    ...r,
     dialect: "mssql",
     supportsFilterClause: !1
-  } : r.includes("redshift") ? {
-    ...s,
+  } : e.includes("redshift") ? {
+    ...r,
     prefixLevels: ["schema", "table"],
     dialect: "redshift"
-  } : r.includes("snowflake") ? {
-    ...s,
+  } : e.includes("snowflake") ? {
+    ...r,
     dialect: "snowflake"
-  } : r.includes("clickhouse") ? {
-    connectionId: a.connectionId,
-    connectionType: e,
+  } : e.includes("clickhouse") ? {
+    connectionId: i.connectionId,
+    connectionType: s,
     path: ["database", "table"],
     labels: {
       database: "Database",
@@ -48,19 +206,19 @@ function d(e, a = {}) {
     prefixLevels: ["database", "table"],
     dialect: "clickhouse",
     supportsFilterClause: !1
-  } : r === "s3" || r === "api" ? {
-    connectionId: a.connectionId,
-    connectionType: e,
+  } : e === "s3" || e === "api" ? {
+    connectionId: i.connectionId,
+    connectionType: s,
     path: ["table"],
     labels: {
-      table: r === "api" ? "API Table" : "File Table"
+      table: e === "api" ? "API Table" : "File Table"
     },
     prefixLevels: ["table"],
     dialect: "duckdb",
     supportsFilterClause: !0
-  } : r === "googlesheets" || r === "fileupload" ? {
-    connectionId: a.connectionId,
-    connectionType: e,
+  } : e === "googlesheets" || e === "fileupload" ? {
+    connectionId: i.connectionId,
+    connectionType: s,
     path: ["table"],
     labels: {
       table: "Table"
@@ -68,16 +226,16 @@ function d(e, a = {}) {
     prefixLevels: ["table"],
     dialect: "postgres",
     supportsFilterClause: !0
-  } : r === "s3tables" ? {
-    ...s,
+  } : e === "s3tables" ? {
+    ...r,
     labels: {
       database: "Database",
       schema: "Namespace",
       table: "Table"
     },
     dialect: "duckdb"
-  } : r === "bigquery" ? {
-    ...s,
+  } : e === "bigquery" ? {
+    ...r,
     labels: {
       database: "Project",
       schema: "Dataset",
@@ -86,11 +244,11 @@ function d(e, a = {}) {
     prefixLevels: ["schema", "table"],
     dialect: "bigquery",
     supportsFilterClause: !1
-  } : s;
+  } : r;
 }
-function u(e) {
-  const a = n(e);
-  switch (a) {
+function q(s) {
+  const i = h(s);
+  switch (i) {
     case "mysql":
     case "bigquery":
     case "redshift":
@@ -98,7 +256,7 @@ function u(e) {
     case "clickhouse":
     case "duckdb":
     case "sqlite":
-      return a;
+      return i;
     case "mssql":
     case "sqlserver":
       return "mssql";
@@ -109,46 +267,46 @@ function u(e) {
       return "unknown";
   }
 }
-function c(e) {
-  return e.capabilities.prefixLevels.every(
-    (a) => !!t(e.source, a)
+function F(s) {
+  return s.capabilities.prefixLevels.every(
+    (i) => !!y(s.source, i)
   );
 }
-function m(e) {
-  const a = e.quoteIdentifier ?? l;
-  return e.capabilities.prefixLevels.map((r) => t(e.source, r)).filter((r) => !!r).map((r) => a(r, e.capabilities.dialect)).join(".");
+function _(s) {
+  const i = s.quoteIdentifier ?? R;
+  return s.capabilities.prefixLevels.map((e) => y(s.source, e)).filter((e) => !!e).map((e) => i(e, s.capabilities.dialect)).join(".");
 }
-function t(e, a) {
-  return a === "database" ? e.databaseName : a === "schema" ? e.schemaName : e.tableName;
+function y(s, i) {
+  return i === "database" ? s.databaseName : i === "schema" ? s.schemaName : s.tableName;
 }
-function l(e, a) {
-  return a === "mysql" || a === "bigquery" || a === "clickhouse" || a === "duckdb" ? `\`${e.replace(/`/g, "``")}\`` : a === "mssql" ? `[${e.replace(/]/g, "]]")}]` : `"${e.replace(/"/g, '""')}"`;
+function R(s, i) {
+  return i === "mysql" || i === "bigquery" || i === "clickhouse" || i === "duckdb" ? `\`${s.replace(/`/g, "``")}\`` : i === "mssql" ? `[${s.replace(/]/g, "]]")}]` : `"${s.replace(/"/g, '""')}"`;
 }
-function n(e) {
-  if (typeof e != "string")
+function h(s) {
+  if (typeof s != "string")
     return "";
-  const a = [];
-  for (const r of e.trim().toLowerCase())
-    o(r) && a.push(r);
-  return a.join("");
+  const i = [];
+  for (const e of s.trim().toLowerCase())
+    $(e) && i.push(e);
+  return i.join("");
 }
-function o(e) {
-  const a = e.charCodeAt(0);
-  return a >= 48 && a <= 57 || a >= 97 && a <= 122;
+function $(s) {
+  const i = s.charCodeAt(0);
+  return i >= 48 && i <= 57 || i >= 97 && i <= 122;
 }
-const i = {
+const u = {
   kind: "semantic",
   domainId: "domain_sales",
   datasetName: "orders",
   connectionId: "conn_sales",
   label: "Orders"
-}, p = {
+}, D = {
   revenueKpi: {
     version: 1,
     kind: "metric",
     id: "revenue-kpi",
     label: "Revenue",
-    source: i,
+    source: u,
     measures: [{ name: "revenue", role: "measure" }],
     primaryMeasure: { name: "revenue", role: "measure" },
     comparison: { kind: "previous_period" },
@@ -159,7 +317,7 @@ const i = {
     kind: "records",
     id: "revenue-trend",
     label: "Revenue trend",
-    source: i,
+    source: u,
     fields: [
       { name: "order_date", role: "date", dataType: "date", label: "Order Date" },
       { name: "revenue", role: "measure", dataType: "number" }
@@ -173,7 +331,7 @@ const i = {
     kind: "records",
     id: "top-customers",
     label: "Top customers",
-    source: i,
+    source: u,
     fields: [
       { name: "customer_name", role: "dimension", dataType: "string" },
       { name: "segment", role: "dimension", dataType: "string" },
@@ -188,7 +346,7 @@ const i = {
     id: "region-options",
     label: "Region options",
     inputId: "region",
-    source: i,
+    source: u,
     labelField: { name: "region", role: "dimension", dataType: "string" },
     valueField: { name: "region", role: "dimension", dataType: "string" },
     limit: 100
@@ -198,7 +356,7 @@ const i = {
     kind: "metric",
     id: "revenue-previous-period",
     label: "Revenue previous period comparison",
-    source: i,
+    source: u,
     measures: [{ name: "revenue", role: "measure" }],
     primaryMeasure: { name: "revenue", role: "measure" },
     dateField: { name: "order_date", role: "date", dataType: "date" },
@@ -211,7 +369,7 @@ const i = {
     kind: "metric",
     id: "inbound-supplier-concentration",
     label: "Inbound supplier concentration",
-    source: i,
+    source: u,
     measures: [
       { name: "net_tons", role: "measure" },
       { name: "ticket_value", role: "measure" }
@@ -249,38 +407,41 @@ const i = {
   }
 };
 export {
-  p as SEMAPHOR_ANALYTICS_INTENT_FIXTURES,
-  q as SEMAPHOR_ANALYZE_RESULT_FIELD_CONTRACT,
-  x as buildAnalyticsCatalogFieldSummary,
-  m as buildSemaphorQualifiedSourcePath,
-  N as getAnalyticsCatalogFieldCandidates,
-  M as getAnalyticsCatalogFieldName,
-  R as getSemaphorAnalyzeResultFieldNames,
-  d as getSemaphorConnectionCapabilities,
-  O as isAnalyticsCatalogDateField,
-  z as isAnalyticsCatalogDimensionField,
-  E as isAnalyticsCatalogMetricField,
-  w as isAnalyticsDateLikeDataType,
-  P as isAnalyticsMetricIdentifierField,
-  B as isAnalyticsTechnicalIdentifierField,
-  _ as isSemaphorAnalyzeResultFieldName,
-  j as normalizeAnalyticsCatalogDataType,
-  Q as normalizeAnalyticsCatalogName,
-  h as normalizeSemaphorAnalyticsFilterOperator,
-  u as normalizeSemaphorDialect,
-  v as normalizeSemaphorInputOperator,
-  L as parseSemaphorAnalyzeResult,
-  y as parseSemaphorIsoTimeWindowBoundary,
-  Y as preferSemaphorFieldRefMetadata,
-  G as preferSemaphorSourceMetadata,
-  H as semaphorFieldRefsMatch,
-  c as semaphorSourceHasRequiredCoordinates,
-  $ as semaphorSourceIdentityKey,
-  K as semaphorSourcesReferToSameDataset,
-  S as validateSemaphorAnalyticsIntent,
-  T as validateSemaphorAnalyticsRecoveryPlan,
-  C as validateSemaphorDashboardIntent,
-  I as validateSemaphorDerivedFieldDefinition,
-  k as validateSemaphorOperationIntent,
-  F as validateSemaphorResultCalculation
+  D as SEMAPHOR_ANALYTICS_INTENT_FIXTURES,
+  H as SEMAPHOR_ANALYZE_RESULT_FIELD_CONTRACT,
+  f as SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_SCHEMA_VERSION,
+  X as buildAnalyticsCatalogFieldSummary,
+  _ as buildSemaphorQualifiedSourcePath,
+  Z as getAnalyticsCatalogFieldCandidates,
+  J as getAnalyticsCatalogFieldName,
+  U as getSemaphorAnalyzeResultFieldNames,
+  w as getSemaphorConnectionCapabilities,
+  ee as isAnalyticsCatalogDateField,
+  ie as isAnalyticsCatalogDimensionField,
+  se as isAnalyticsCatalogMetricField,
+  re as isAnalyticsDateLikeDataType,
+  te as isAnalyticsMetricIdentifierField,
+  ae as isAnalyticsTechnicalIdentifierField,
+  Y as isSemaphorAnalyzeResultFieldName,
+  T as isSemaphorDataAppCodegenSummary,
+  ne as normalizeAnalyticsCatalogDataType,
+  oe as normalizeAnalyticsCatalogName,
+  O as normalizeSemaphorAnalyticsFilterOperator,
+  q as normalizeSemaphorDialect,
+  V as normalizeSemaphorInputOperator,
+  G as parseSemaphorAnalyzeResult,
+  L as parseSemaphorIsoTimeWindowBoundary,
+  ue as preferSemaphorFieldRefMetadata,
+  de as preferSemaphorSourceMetadata,
+  ce as semaphorFieldRefsMatch,
+  F as semaphorSourceHasRequiredCoordinates,
+  me as semaphorSourceIdentityKey,
+  pe as semaphorSourcesReferToSameDataset,
+  M as validateSemaphorAnalyticsIntent,
+  x as validateSemaphorAnalyticsRecoveryPlan,
+  B as validateSemaphorDashboardIntent,
+  g as validateSemaphorDataAppCodegenSummary,
+  P as validateSemaphorDerivedFieldDefinition,
+  z as validateSemaphorOperationIntent,
+  Q as validateSemaphorResultCalculation
 };