@contractspec/example.analytics-dashboard 3.9.12 → 3.9.14
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/browser/dashboard.feature.js +1 -1
- package/dist/browser/example.js +1 -1
- package/dist/browser/index.js +11 -11
- package/dist/dashboard.feature.js +1 -1
- package/dist/example.d.ts +3 -2
- package/dist/example.js +1 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.js +11 -11
- package/dist/node/dashboard.feature.js +1 -1
- package/dist/node/example.js +1 -1
- package/dist/node/index.js +11 -11
- package/package.json +8 -8
|
@@ -1 +1 @@
|
|
|
1
|
-
import{defineVisualization as O}from"@contractspec/lib.contracts-spec/visualizations";var _={key:"analytics.query.execute",version:"1.0.0"},C={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},m=O({meta:{...C,key:"analytics.visualization.channel-mix",title:"Channel Mix",description:"Session distribution across acquisition channels.",goal:"Explain which channels currently drive the largest share of traffic.",context:"Marketing attribution dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"pie",nameDimension:"channel",valueMeasure:"sessions",dimensions:[{key:"channel",label:"Channel",dataPath:"channel",type:"category"}],measures:[{key:"sessions",label:"Sessions",dataPath:"sessions"}],table:{caption:"Sessions by acquisition channel."}}}),G=O({meta:{...C,key:"analytics.visualization.engagement-heatmap",title:"Engagement Heatmap",description:"Average engagement score by weekday and time band.",goal:"Reveal the highest-engagement time windows for product activity.",context:"Usage analytics dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"heatmap",xDimension:"timeBand",yDimension:"weekday",valueMeasure:"engagementScore",dimensions:[{key:"timeBand",label:"Time Band",dataPath:"timeBand",type:"category"},{key:"weekday",label:"Weekday",dataPath:"weekday",type:"category"}],measures:[{key:"engagementScore",label:"Engagement",dataPath:"engagementScore"}],table:{caption:"Engagement score by weekday and time band."}}}),D=O({meta:{...C,key:"analytics.visualization.conversion-funnel",title:"Conversion Funnel",description:"Progression through the main acquisition funnel.",goal:"Show where the product is losing the largest share of prospects.",context:"Growth dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"funnel",nameDimension:"stage",valueMeasure:"users",sort:"descending",dimensions:[{key:"stage",label:"Stage",dataPath:"stage",type:"category"}],measures:[{key:"users",label:"Users",dataPath:"users"}],table:{caption:"Users per conversion stage."}}}),L=O({meta:{...C,key:"analytics.visualization.account-coverage-geo",title:"Account Coverage",description:"High-value accounts plotted on a slippy-map surface.",goal:"Locate where active commercial concentration is strongest.",context:"Territory coverage dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"geo",mode:"slippy-map",variant:"scatter",nameDimension:"city",latitudeDimension:"latitude",longitudeDimension:"longitude",valueMeasure:"accounts",dimensions:[{key:"city",label:"City",dataPath:"city",type:"category"},{key:"latitude",label:"Latitude",dataPath:"latitude",type:"latitude"},{key:"longitude",label:"Longitude",dataPath:"longitude",type:"longitude"}],measures:[{key:"accounts",label:"Accounts",dataPath:"accounts"}],table:{caption:"Account concentration by city."}}});import{defineVisualization as S}from"@contractspec/lib.contracts-spec/visualizations";var K={key:"analytics.query.execute",version:"1.0.0"},Q={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},X=S({meta:{...Q,key:"analytics.visualization.revenue-metric",title:"Revenue Snapshot",description:"Current recurring revenue with prior-period comparison.",goal:"Highlight the headline commercial metric for the dashboard.",context:"Executive revenue overview."},source:{primary:K,resultPath:"data"},visualization:{kind:"metric",measure:"totalRevenue",comparisonMeasure:"priorRevenue",dimensions:[{key:"period",label:"Period",dataPath:"period",type:"time"}],measures:[{key:"totalRevenue",label:"Revenue",dataPath:"totalRevenue",format:"currency"},{key:"priorRevenue",label:"Prior Revenue",dataPath:"priorRevenue",format:"currency"}],sparkline:{dimension:"period",measure:"totalRevenue"},table:{caption:"Revenue trend and prior period values."}}}),N=S({meta:{...Q,key:"analytics.visualization.revenue-trend",title:"Revenue Trend",description:"Monthly revenue progression for the current quarter.",goal:"Track whether revenue growth is accelerating or stalling.",context:"Quarterly commercial dashboard."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"line",xDimension:"date",yMeasures:["revenue"],dimensions:[{key:"date",label:"Month",dataPath:"date",type:"time"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#0f766e"}],thresholds:[{key:"target",value:140000,label:"Target",color:"#dc2626"}],table:{caption:"Monthly revenue values."}}}),W=S({meta:{...Q,key:"analytics.visualization.regional-revenue",title:"Regional Revenue",description:"Revenue split by sales territory.",goal:"Compare the strongest and weakest performing territories.",context:"Territory planning and commercial comparison."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"bar",xDimension:"region",yMeasures:["revenue"],dimensions:[{key:"region",label:"Region",dataPath:"region",type:"category"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#1d4ed8"}],table:{caption:"Revenue by region."}}}),Z=S({meta:{...Q,key:"analytics.visualization.retention-area",title:"Retention Curve",description:"Weekly retention progression across the active cohort.",goal:"Show whether user retention remains above the desired floor.",context:"Product health dashboard."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"area",xDimension:"week",yMeasures:["retentionRate"],dimensions:[{key:"week",label:"Week",dataPath:"week",type:"category"}],measures:[{key:"retentionRate",label:"Retention",dataPath:"retentionRate",format:"percentage",color:"#16a34a"}],thresholds:[{key:"floor",value:0.5,label:"Floor",color:"#f59e0b"}],table:{caption:"Weekly retention rate."}}}),H=S({meta:{...Q,key:"analytics.visualization.pipeline-scatter",title:"Pipeline Velocity",description:"Deal-cycle length against win rate for active accounts.",goal:"Spot outliers where the sales cycle is long but conversion remains weak.",context:"Commercial operations dashboard."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"scatter",xDimension:"cycleDays",yMeasures:["winRate"],dimensions:[{key:"cycleDays",label:"Cycle Days",dataPath:"cycleDays",type:"number"}],measures:[{key:"winRate",label:"Win Rate",dataPath:"winRate",format:"percentage",color:"#7c3aed"},{key:"arr",label:"ARR",dataPath:"arr",format:"currency"}],series:[{key:"pipeline",label:"Accounts",measure:"winRate",type:"scatter",color:"#7c3aed"}],table:{caption:"Sales cycle and win rate per account."}}});import{VisualizationRegistry as p}from"@contractspec/lib.contracts-spec/visualizations";var Y=[X,N,W,Z,H,m,G,D,L],v=new p([...Y]),T=Y.map((x)=>J(x)),A=new Map(Y.map((x)=>[q(x.meta),x])),y={[q(X.meta)]:{data:[{period:"2025-11-01",totalRevenue:112000,priorRevenue:103000},{period:"2025-12-01",totalRevenue:119000,priorRevenue:110000},{period:"2026-01-01",totalRevenue:126500,priorRevenue:116000},{period:"2026-02-01",totalRevenue:133000,priorRevenue:124000},{period:"2026-03-01",totalRevenue:145500,priorRevenue:133000}]},[q(N.meta)]:{data:[{date:"2025-11-01",revenue:112000},{date:"2025-12-01",revenue:119000},{date:"2026-01-01",revenue:126500},{date:"2026-02-01",revenue:133000},{date:"2026-03-01",revenue:145500}]},[q(W.meta)]:{data:[{region:"North America",revenue:210000},{region:"EMEA",revenue:174000},{region:"APAC",revenue:132000},{region:"LATAM",revenue:88000}]},[q(Z.meta)]:{data:[{week:"Week 1",retentionRate:0.71},{week:"Week 2",retentionRate:0.66},{week:"Week 3",retentionRate:0.62},{week:"Week 4",retentionRate:0.58},{week:"Week 5",retentionRate:0.55},{week:"Week 6",retentionRate:0.53}]},[q(H.meta)]:{data:[{cycleDays:18,winRate:0.31,arr:82000},{cycleDays:26,winRate:0.44,arr:65000},{cycleDays:33,winRate:0.27,arr:91000},{cycleDays:14,winRate:0.56,arr:47000},{cycleDays:21,winRate:0.48,arr:59000},{cycleDays:39,winRate:0.22,arr:114000}]},[q(m.meta)]:{data:[{channel:"Direct",sessions:4200},{channel:"Organic Search",sessions:3600},{channel:"Paid Search",sessions:2100},{channel:"Partner",sessions:1400},{channel:"Referral",sessions:900}]},[q(G.meta)]:{data:[{weekday:"Mon",timeBand:"09:00",engagementScore:74},{weekday:"Mon",timeBand:"13:00",engagementScore:82},{weekday:"Tue",timeBand:"09:00",engagementScore:69},{weekday:"Tue",timeBand:"13:00",engagementScore:88},{weekday:"Wed",timeBand:"09:00",engagementScore:77},{weekday:"Wed",timeBand:"13:00",engagementScore:91},{weekday:"Thu",timeBand:"09:00",engagementScore:72},{weekday:"Thu",timeBand:"13:00",engagementScore:86},{weekday:"Fri",timeBand:"09:00",engagementScore:65},{weekday:"Fri",timeBand:"13:00",engagementScore:79}]},[q(D.meta)]:{data:[{stage:"Visited Site",users:12000},{stage:"Started Trial",users:4200},{stage:"Activated Workspace",users:2400},{stage:"Requested Demo",users:980},{stage:"Closed Won",users:310}]},[q(L.meta)]:{data:[{city:"Paris",latitude:48.8566,longitude:2.3522,accounts:48},{city:"London",latitude:51.5072,longitude:-0.1276,accounts:62},{city:"New York",latitude:40.7128,longitude:-74.006,accounts:71},{city:"Toronto",latitude:43.6532,longitude:-79.3832,accounts:36},{city:"Singapore",latitude:1.3521,longitude:103.8198,accounts:29}]}};function J(x){return{key:x.meta.key,version:x.meta.version}}function q(x){return`${x.key}.v${x.version}`}var h={METRIC:J(X),LINE_CHART:J(N),BAR_CHART:J(W),AREA_CHART:J(Z),SCATTER_PLOT:J(H),PIE_CHART:J(m),HEATMAP:J(G),FUNNEL:J(D),MAP:J(L)};function V(x){return[$(x,"widget_revenue_metric","Revenue Snapshot","METRIC",0,0,4,2,{layout:"single",bindings:[B(X,200)]}),$(x,"widget_revenue_trend","Revenue Trend","LINE_CHART",4,0,8,4,{layout:"single",bindings:[B(N)]}),$(x,"widget_regional_revenue","Regional Revenue","BAR_CHART",0,2,6,4,{layout:"single",bindings:[B(W)]}),$(x,"widget_channel_mix","Channel Mix","PIE_CHART",6,2,6,4,{layout:"single",bindings:[B(m)]}),$(x,"widget_retention","Retention Curve","AREA_CHART",0,6,6,4,{layout:"single",bindings:[B(Z)]}),$(x,"widget_pipeline","Pipeline Velocity","SCATTER_PLOT",6,6,6,4,{layout:"single",bindings:[B(H)]}),$(x,"widget_heatmap","Engagement Heatmap","HEATMAP",0,10,8,4,{layout:"single",bindings:[B(G)]}),$(x,"widget_funnel","Conversion Funnel","FUNNEL",8,10,4,4,{layout:"single",bindings:[B(D)]}),$(x,"widget_geo","Account Coverage","MAP",0,14,12,5,{layout:"single",bindings:[B(L,360)]}),$(x,"widget_comparison","Commercial Comparison","EMBED",0,19,12,6,{layout:"comparison",description:"Compare regional distribution, channel balance, and funnel shape.",bindings:[B(W,240),B(m,240),B(D,240)]}),$(x,"widget_timeline","Growth Timeline","EMBED",0,25,12,6,{layout:"timeline",description:"Track revenue and retention over the same reporting cadence.",bindings:[B(N,220),B(Z,220)]})]}function R(x){let j=f(x),U=j.bindings.map((k)=>{let P=A.get(q(k.ref));if(!P)return null;return{key:`${x.id}:${q(k.ref)}`,spec:P,data:k.data,title:k.title??P.meta.title,description:k.description??P.meta.description,height:k.height}}).filter((k)=>Boolean(k));if(!U.length)return null;return{id:x.id,name:x.name,description:j.description,layout:j.layout,gridX:x.gridX,gridY:x.gridY,gridWidth:x.gridWidth,gridHeight:x.gridHeight,bindings:U}}function f(x){if(z(x.config))return x.config;let j=h[x.type];return j?{layout:"single",bindings:[{ref:j,data:y[q(j)]}]}:{layout:"single",bindings:[]}}function B(x,j=280){return{ref:J(x),data:y[q(x.meta)],height:j}}function $(x,j,U,k,P,M,w,I,E){let F=new Date;return{id:j,dashboardId:x,name:U,type:k,gridX:P,gridY:M,gridWidth:w,gridHeight:I,config:E,createdAt:F,updatedAt:F}}function z(x){if(!x||typeof x!=="object")return!1;let j=x;return(j.layout==="single"||j.layout==="comparison"||j.layout==="timeline")&&Array.isArray(j.bindings)}import{defineFeature as b}from"@contractspec/lib.contracts-spec";var kx=b({meta:{key:"analytics-dashboard",version:"1.0.0",title:"Analytics Dashboard",description:"Analytics dashboards with customizable widgets and queries",domain:"analytics",owners:["@analytics-dashboard"],tags:["analytics","dashboards","widgets","queries"],stability:"experimental"},operations:[{key:"analytics.dashboard.create",version:"1.0.0"},{key:"analytics.dashboard.list",version:"1.0.0"},{key:"analytics.dashboard.get",version:"1.0.0"},{key:"analytics.widget.add",version:"1.0.0"},{key:"analytics.query.create",version:"1.0.0"},{key:"analytics.query.execute",version:"1.0.0"}],events:[{key:"analytics.dashboard.created",version:"1.0.0"},{key:"analytics.widget.added",version:"1.0.0"},{key:"analytics.query.created",version:"1.0.0"}],presentations:[{key:"analytics.dashboard.viewList",version:"1.0.0"},{key:"analytics.dashboard.view",version:"1.0.0"},{key:"analytics.dashboard.editor",version:"1.0.0"},{key:"analytics.query.list",version:"1.0.0"},{key:"analytics.query.builder",version:"1.0.0"}],visualizations:[...T],opToPresentation:[{op:{key:"analytics.dashboard.list",version:"1.0.0"},pres:{key:"analytics.dashboard.viewList",version:"1.0.0"}},{op:{key:"analytics.dashboard.get",version:"1.0.0"},pres:{key:"analytics.dashboard.view",version:"1.0.0"}},{op:{key:"analytics.dashboard.create",version:"1.0.0"},pres:{key:"analytics.dashboard.editor",version:"1.0.0"}},{op:{key:"analytics.query.create",version:"1.0.0"},pres:{key:"analytics.query.builder",version:"1.0.0"}}],presentationsTargets:[{key:"analytics.dashboard.viewList",version:"1.0.0",targets:["react","markdown","application/json"]},{key:"analytics.dashboard.view",version:"1.0.0",targets:["react","markdown"]},{key:"analytics.dashboard.editor",version:"1.0.0",targets:["react"]},{key:"analytics.query.builder",version:"1.0.0",targets:["react"]}],capabilities:{requires:[{key:"identity",version:"1.0.0"},{key:"metering",version:"1.0.0"},{key:"audit-trail",version:"1.0.0"}]},telemetry:[{key:"analytics-dashboard.telemetry",version:"1.0.0"}],docs:["docs.examples.analytics-dashboard","docs.examples.analytics-dashboard.goal","docs.examples.analytics-dashboard.usage","docs.examples.analytics-dashboard.constraints"]});export{kx as AnalyticsDashboardFeature};
|
|
1
|
+
import{defineVisualization as O}from"@contractspec/lib.contracts-spec/visualizations";var _={key:"analytics.query.execute",version:"1.0.0"},C={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},m=O({meta:{...C,key:"analytics.visualization.channel-mix",title:"Channel Mix",description:"Session distribution across acquisition channels.",goal:"Explain which channels currently drive the largest share of traffic.",context:"Marketing attribution dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"pie",nameDimension:"channel",valueMeasure:"sessions",dimensions:[{key:"channel",label:"Channel",dataPath:"channel",type:"category"}],measures:[{key:"sessions",label:"Sessions",dataPath:"sessions"}],table:{caption:"Sessions by acquisition channel."}}}),G=O({meta:{...C,key:"analytics.visualization.engagement-heatmap",title:"Engagement Heatmap",description:"Average engagement score by weekday and time band.",goal:"Reveal the highest-engagement time windows for product activity.",context:"Usage analytics dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"heatmap",xDimension:"timeBand",yDimension:"weekday",valueMeasure:"engagementScore",dimensions:[{key:"timeBand",label:"Time Band",dataPath:"timeBand",type:"category"},{key:"weekday",label:"Weekday",dataPath:"weekday",type:"category"}],measures:[{key:"engagementScore",label:"Engagement",dataPath:"engagementScore"}],table:{caption:"Engagement score by weekday and time band."}}}),D=O({meta:{...C,key:"analytics.visualization.conversion-funnel",title:"Conversion Funnel",description:"Progression through the main acquisition funnel.",goal:"Show where the product is losing the largest share of prospects.",context:"Growth dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"funnel",nameDimension:"stage",valueMeasure:"users",sort:"descending",dimensions:[{key:"stage",label:"Stage",dataPath:"stage",type:"category"}],measures:[{key:"users",label:"Users",dataPath:"users"}],table:{caption:"Users per conversion stage."}}}),L=O({meta:{...C,key:"analytics.visualization.account-coverage-geo",title:"Account Coverage",description:"High-value accounts plotted on a slippy-map surface.",goal:"Locate where active commercial concentration is strongest.",context:"Territory coverage dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"geo",mode:"slippy-map",variant:"scatter",nameDimension:"city",latitudeDimension:"latitude",longitudeDimension:"longitude",valueMeasure:"accounts",dimensions:[{key:"city",label:"City",dataPath:"city",type:"category"},{key:"latitude",label:"Latitude",dataPath:"latitude",type:"latitude"},{key:"longitude",label:"Longitude",dataPath:"longitude",type:"longitude"}],measures:[{key:"accounts",label:"Accounts",dataPath:"accounts"}],table:{caption:"Account concentration by city."}}});import{defineVisualization as S}from"@contractspec/lib.contracts-spec/visualizations";var K={key:"analytics.query.execute",version:"1.0.0"},Q={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},X=S({meta:{...Q,key:"analytics.visualization.revenue-metric",title:"Revenue Snapshot",description:"Current recurring revenue with prior-period comparison.",goal:"Highlight the headline commercial metric for the dashboard.",context:"Executive revenue overview."},source:{primary:K,resultPath:"data"},visualization:{kind:"metric",measure:"totalRevenue",comparisonMeasure:"priorRevenue",dimensions:[{key:"period",label:"Period",dataPath:"period",type:"time"}],measures:[{key:"totalRevenue",label:"Revenue",dataPath:"totalRevenue",format:"currency"},{key:"priorRevenue",label:"Prior Revenue",dataPath:"priorRevenue",format:"currency"}],sparkline:{dimension:"period",measure:"totalRevenue"},table:{caption:"Revenue trend and prior period values."}}}),N=S({meta:{...Q,key:"analytics.visualization.revenue-trend",title:"Revenue Trend",description:"Monthly revenue progression for the current quarter.",goal:"Track whether revenue growth is accelerating or stalling.",context:"Quarterly commercial dashboard."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"line",xDimension:"date",yMeasures:["revenue"],dimensions:[{key:"date",label:"Month",dataPath:"date",type:"time"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#0f766e"}],thresholds:[{key:"target",value:140000,label:"Target",color:"#dc2626"}],table:{caption:"Monthly revenue values."}}}),W=S({meta:{...Q,key:"analytics.visualization.regional-revenue",title:"Regional Revenue",description:"Revenue split by sales territory.",goal:"Compare the strongest and weakest performing territories.",context:"Territory planning and commercial comparison."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"bar",xDimension:"region",yMeasures:["revenue"],dimensions:[{key:"region",label:"Region",dataPath:"region",type:"category"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#1d4ed8"}],table:{caption:"Revenue by region."}}}),Z=S({meta:{...Q,key:"analytics.visualization.retention-area",title:"Retention Curve",description:"Weekly retention progression across the active cohort.",goal:"Show whether user retention remains above the desired floor.",context:"Product health dashboard."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"area",xDimension:"week",yMeasures:["retentionRate"],dimensions:[{key:"week",label:"Week",dataPath:"week",type:"category"}],measures:[{key:"retentionRate",label:"Retention",dataPath:"retentionRate",format:"percentage",color:"#16a34a"}],thresholds:[{key:"floor",value:0.5,label:"Floor",color:"#f59e0b"}],table:{caption:"Weekly retention rate."}}}),H=S({meta:{...Q,key:"analytics.visualization.pipeline-scatter",title:"Pipeline Velocity",description:"Deal-cycle length against win rate for active accounts.",goal:"Spot outliers where the sales cycle is long but conversion remains weak.",context:"Commercial operations dashboard."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"scatter",xDimension:"cycleDays",yMeasures:["winRate"],dimensions:[{key:"cycleDays",label:"Cycle Days",dataPath:"cycleDays",type:"number"}],measures:[{key:"winRate",label:"Win Rate",dataPath:"winRate",format:"percentage",color:"#7c3aed"},{key:"arr",label:"ARR",dataPath:"arr",format:"currency"}],series:[{key:"pipeline",label:"Accounts",measure:"winRate",type:"scatter",color:"#7c3aed"}],table:{caption:"Sales cycle and win rate per account."}}});import{VisualizationRegistry as p}from"@contractspec/lib.contracts-spec/visualizations";var Y=[X,N,W,Z,H,m,G,D,L],v=new p([...Y]),T=Y.map((x)=>J(x)),A=new Map(Y.map((x)=>[q(x.meta),x])),y={[q(X.meta)]:{data:[{period:"2025-11-01",totalRevenue:112000,priorRevenue:103000},{period:"2025-12-01",totalRevenue:119000,priorRevenue:110000},{period:"2026-01-01",totalRevenue:126500,priorRevenue:116000},{period:"2026-02-01",totalRevenue:133000,priorRevenue:124000},{period:"2026-03-01",totalRevenue:145500,priorRevenue:133000}]},[q(N.meta)]:{data:[{date:"2025-11-01",revenue:112000},{date:"2025-12-01",revenue:119000},{date:"2026-01-01",revenue:126500},{date:"2026-02-01",revenue:133000},{date:"2026-03-01",revenue:145500}]},[q(W.meta)]:{data:[{region:"North America",revenue:210000},{region:"EMEA",revenue:174000},{region:"APAC",revenue:132000},{region:"LATAM",revenue:88000}]},[q(Z.meta)]:{data:[{week:"Week 1",retentionRate:0.71},{week:"Week 2",retentionRate:0.66},{week:"Week 3",retentionRate:0.62},{week:"Week 4",retentionRate:0.58},{week:"Week 5",retentionRate:0.55},{week:"Week 6",retentionRate:0.53}]},[q(H.meta)]:{data:[{cycleDays:18,winRate:0.31,arr:82000},{cycleDays:26,winRate:0.44,arr:65000},{cycleDays:33,winRate:0.27,arr:91000},{cycleDays:14,winRate:0.56,arr:47000},{cycleDays:21,winRate:0.48,arr:59000},{cycleDays:39,winRate:0.22,arr:114000}]},[q(m.meta)]:{data:[{channel:"Direct",sessions:4200},{channel:"Organic Search",sessions:3600},{channel:"Paid Search",sessions:2100},{channel:"Partner",sessions:1400},{channel:"Referral",sessions:900}]},[q(G.meta)]:{data:[{weekday:"Mon",timeBand:"09:00",engagementScore:74},{weekday:"Mon",timeBand:"13:00",engagementScore:82},{weekday:"Tue",timeBand:"09:00",engagementScore:69},{weekday:"Tue",timeBand:"13:00",engagementScore:88},{weekday:"Wed",timeBand:"09:00",engagementScore:77},{weekday:"Wed",timeBand:"13:00",engagementScore:91},{weekday:"Thu",timeBand:"09:00",engagementScore:72},{weekday:"Thu",timeBand:"13:00",engagementScore:86},{weekday:"Fri",timeBand:"09:00",engagementScore:65},{weekday:"Fri",timeBand:"13:00",engagementScore:79}]},[q(D.meta)]:{data:[{stage:"Visited Site",users:12000},{stage:"Started Trial",users:4200},{stage:"Activated Workspace",users:2400},{stage:"Requested Demo",users:980},{stage:"Closed Won",users:310}]},[q(L.meta)]:{data:[{city:"Paris",latitude:48.8566,longitude:2.3522,accounts:48},{city:"London",latitude:51.5072,longitude:-0.1276,accounts:62},{city:"New York",latitude:40.7128,longitude:-74.006,accounts:71},{city:"Toronto",latitude:43.6532,longitude:-79.3832,accounts:36},{city:"Singapore",latitude:1.3521,longitude:103.8198,accounts:29}]}};function J(x){return{key:x.meta.key,version:x.meta.version}}function q(x){return`${x.key}.v${x.version}`}var h={METRIC:J(X),LINE_CHART:J(N),BAR_CHART:J(W),AREA_CHART:J(Z),SCATTER_PLOT:J(H),PIE_CHART:J(m),HEATMAP:J(G),FUNNEL:J(D),MAP:J(L)};function V(x){return[$(x,"widget_revenue_metric","Revenue Snapshot","METRIC",0,0,4,2,{layout:"single",bindings:[B(X,200)]}),$(x,"widget_revenue_trend","Revenue Trend","LINE_CHART",4,0,8,4,{layout:"single",bindings:[B(N)]}),$(x,"widget_regional_revenue","Regional Revenue","BAR_CHART",0,2,6,4,{layout:"single",bindings:[B(W)]}),$(x,"widget_channel_mix","Channel Mix","PIE_CHART",6,2,6,4,{layout:"single",bindings:[B(m)]}),$(x,"widget_retention","Retention Curve","AREA_CHART",0,6,6,4,{layout:"single",bindings:[B(Z)]}),$(x,"widget_pipeline","Pipeline Velocity","SCATTER_PLOT",6,6,6,4,{layout:"single",bindings:[B(H)]}),$(x,"widget_heatmap","Engagement Heatmap","HEATMAP",0,10,8,4,{layout:"single",bindings:[B(G)]}),$(x,"widget_funnel","Conversion Funnel","FUNNEL",8,10,4,4,{layout:"single",bindings:[B(D)]}),$(x,"widget_geo","Account Coverage","MAP",0,14,12,5,{layout:"single",bindings:[B(L,360)]}),$(x,"widget_comparison","Commercial Comparison","EMBED",0,19,12,6,{layout:"comparison",description:"Compare regional distribution, channel balance, and funnel shape.",bindings:[B(W,240),B(m,240),B(D,240)]}),$(x,"widget_timeline","Growth Timeline","EMBED",0,25,12,6,{layout:"timeline",description:"Track revenue and retention over the same reporting cadence.",bindings:[B(N,220),B(Z,220)]})]}function R(x){let j=z(x),U=j.bindings.map((k)=>{let P=A.get(q(k.ref));if(!P)return null;return{key:`${x.id}:${q(k.ref)}`,spec:P,data:k.data,title:k.title??P.meta.title,description:k.description??P.meta.description,height:k.height}}).filter((k)=>Boolean(k));if(!U.length)return null;return{id:x.id,name:x.name,description:j.description,layout:j.layout,gridX:x.gridX,gridY:x.gridY,gridWidth:x.gridWidth,gridHeight:x.gridHeight,bindings:U}}function z(x){if(f(x.config))return x.config;let j=h[x.type];return j?{layout:"single",bindings:[{ref:j,data:y[q(j)]}]}:{layout:"single",bindings:[]}}function B(x,j=280){return{ref:J(x),data:y[q(x.meta)],height:j}}function $(x,j,U,k,P,M,w,I,E){let F=new Date;return{id:j,dashboardId:x,name:U,type:k,gridX:P,gridY:M,gridWidth:w,gridHeight:I,config:E,createdAt:F,updatedAt:F}}function f(x){if(!x||typeof x!=="object")return!1;let j=x;return(j.layout==="single"||j.layout==="comparison"||j.layout==="timeline")&&Array.isArray(j.bindings)}import{defineFeature as b}from"@contractspec/lib.contracts-spec/features";var kx=b({meta:{key:"analytics-dashboard",version:"1.0.0",title:"Analytics Dashboard",description:"Analytics dashboards with customizable widgets and queries",domain:"analytics",owners:["@analytics-dashboard"],tags:["analytics","dashboards","widgets","queries"],stability:"experimental"},operations:[{key:"analytics.dashboard.create",version:"1.0.0"},{key:"analytics.dashboard.list",version:"1.0.0"},{key:"analytics.dashboard.get",version:"1.0.0"},{key:"analytics.widget.add",version:"1.0.0"},{key:"analytics.query.create",version:"1.0.0"},{key:"analytics.query.execute",version:"1.0.0"}],events:[{key:"analytics.dashboard.created",version:"1.0.0"},{key:"analytics.widget.added",version:"1.0.0"},{key:"analytics.query.created",version:"1.0.0"}],presentations:[{key:"analytics.dashboard.viewList",version:"1.0.0"},{key:"analytics.dashboard.view",version:"1.0.0"},{key:"analytics.dashboard.editor",version:"1.0.0"},{key:"analytics.query.list",version:"1.0.0"},{key:"analytics.query.builder",version:"1.0.0"}],visualizations:[...T],opToPresentation:[{op:{key:"analytics.dashboard.list",version:"1.0.0"},pres:{key:"analytics.dashboard.viewList",version:"1.0.0"}},{op:{key:"analytics.dashboard.get",version:"1.0.0"},pres:{key:"analytics.dashboard.view",version:"1.0.0"}},{op:{key:"analytics.dashboard.create",version:"1.0.0"},pres:{key:"analytics.dashboard.editor",version:"1.0.0"}},{op:{key:"analytics.query.create",version:"1.0.0"},pres:{key:"analytics.query.builder",version:"1.0.0"}}],presentationsTargets:[{key:"analytics.dashboard.viewList",version:"1.0.0",targets:["react","markdown","application/json"]},{key:"analytics.dashboard.view",version:"1.0.0",targets:["react","markdown"]},{key:"analytics.dashboard.editor",version:"1.0.0",targets:["react"]},{key:"analytics.query.builder",version:"1.0.0",targets:["react"]}],capabilities:{requires:[{key:"identity",version:"1.0.0"},{key:"metering",version:"1.0.0"},{key:"audit-trail",version:"1.0.0"}]},telemetry:[{key:"analytics-dashboard.telemetry",version:"1.0.0"}],docs:["docs.examples.analytics-dashboard","docs.examples.analytics-dashboard.goal","docs.examples.analytics-dashboard.usage","docs.examples.analytics-dashboard.constraints"]});export{kx as AnalyticsDashboardFeature};
|
package/dist/browser/example.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{defineExample as
|
|
1
|
+
import{defineExample as f}from"@contractspec/lib.contracts-spec/examples";var g=f({meta:{key:"analytics-dashboard",version:"1.0.0",title:"Analytics Dashboard",description:"Analytics Dashboard example with widgets and query engine for ContractSpec",kind:"template",visibility:"public",stability:"stable",owners:["@contractspec-core"],tags:["package","examples","analytics-dashboard","analytics","dashboard"]},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["playground","specs"]},studio:{enabled:!1,installable:!1},mcp:{enabled:!1}},entrypoints:{packageName:"@contractspec/example.analytics-dashboard"}}),q=g;export{q as default,g as ExamplesAnalyticsDashboardExample};
|
package/dist/browser/index.js
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
|
-
import{defineVisualization as b}from"@contractspec/lib.contracts-spec/visualizations";var s={key:"analytics.query.execute",version:"1.0.0"},i={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},R=b({meta:{...i,key:"analytics.visualization.channel-mix",title:"Channel Mix",description:"Session distribution across acquisition channels.",goal:"Explain which channels currently drive the largest share of traffic.",context:"Marketing attribution dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"pie",nameDimension:"channel",valueMeasure:"sessions",dimensions:[{key:"channel",label:"Channel",dataPath:"channel",type:"category"}],measures:[{key:"sessions",label:"Sessions",dataPath:"sessions"}],table:{caption:"Sessions by acquisition channel."}}}),S=b({meta:{...i,key:"analytics.visualization.engagement-heatmap",title:"Engagement Heatmap",description:"Average engagement score by weekday and time band.",goal:"Reveal the highest-engagement time windows for product activity.",context:"Usage analytics dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"heatmap",xDimension:"timeBand",yDimension:"weekday",valueMeasure:"engagementScore",dimensions:[{key:"timeBand",label:"Time Band",dataPath:"timeBand",type:"category"},{key:"weekday",label:"Weekday",dataPath:"weekday",type:"category"}],measures:[{key:"engagementScore",label:"Engagement",dataPath:"engagementScore"}],table:{caption:"Engagement score by weekday and time band."}}}),_=b({meta:{...i,key:"analytics.visualization.conversion-funnel",title:"Conversion Funnel",description:"Progression through the main acquisition funnel.",goal:"Show where the product is losing the largest share of prospects.",context:"Growth dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"funnel",nameDimension:"stage",valueMeasure:"users",sort:"descending",dimensions:[{key:"stage",label:"Stage",dataPath:"stage",type:"category"}],measures:[{key:"users",label:"Users",dataPath:"users"}],table:{caption:"Users per conversion stage."}}}),g=b({meta:{...i,key:"analytics.visualization.account-coverage-geo",title:"Account Coverage",description:"High-value accounts plotted on a slippy-map surface.",goal:"Locate where active commercial concentration is strongest.",context:"Territory coverage dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"geo",mode:"slippy-map",variant:"scatter",nameDimension:"city",latitudeDimension:"latitude",longitudeDimension:"longitude",valueMeasure:"accounts",dimensions:[{key:"city",label:"City",dataPath:"city",type:"category"},{key:"latitude",label:"Latitude",dataPath:"latitude",type:"latitude"},{key:"longitude",label:"Longitude",dataPath:"longitude",type:"longitude"}],measures:[{key:"accounts",label:"Accounts",dataPath:"accounts"}],table:{caption:"Account concentration by city."}}});import{defineVisualization as T}from"@contractspec/lib.contracts-spec/visualizations";var z={key:"analytics.query.execute",version:"1.0.0"},e={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},x=T({meta:{...e,key:"analytics.visualization.revenue-metric",title:"Revenue Snapshot",description:"Current recurring revenue with prior-period comparison.",goal:"Highlight the headline commercial metric for the dashboard.",context:"Executive revenue overview."},source:{primary:z,resultPath:"data"},visualization:{kind:"metric",measure:"totalRevenue",comparisonMeasure:"priorRevenue",dimensions:[{key:"period",label:"Period",dataPath:"period",type:"time"}],measures:[{key:"totalRevenue",label:"Revenue",dataPath:"totalRevenue",format:"currency"},{key:"priorRevenue",label:"Prior Revenue",dataPath:"priorRevenue",format:"currency"}],sparkline:{dimension:"period",measure:"totalRevenue"},table:{caption:"Revenue trend and prior period values."}}}),f=T({meta:{...e,key:"analytics.visualization.revenue-trend",title:"Revenue Trend",description:"Monthly revenue progression for the current quarter.",goal:"Track whether revenue growth is accelerating or stalling.",context:"Quarterly commercial dashboard."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"line",xDimension:"date",yMeasures:["revenue"],dimensions:[{key:"date",label:"Month",dataPath:"date",type:"time"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#0f766e"}],thresholds:[{key:"target",value:140000,label:"Target",color:"#dc2626"}],table:{caption:"Monthly revenue values."}}}),h=T({meta:{...e,key:"analytics.visualization.regional-revenue",title:"Regional Revenue",description:"Revenue split by sales territory.",goal:"Compare the strongest and weakest performing territories.",context:"Territory planning and commercial comparison."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"bar",xDimension:"region",yMeasures:["revenue"],dimensions:[{key:"region",label:"Region",dataPath:"region",type:"category"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#1d4ed8"}],table:{caption:"Revenue by region."}}}),E=T({meta:{...e,key:"analytics.visualization.retention-area",title:"Retention Curve",description:"Weekly retention progression across the active cohort.",goal:"Show whether user retention remains above the desired floor.",context:"Product health dashboard."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"area",xDimension:"week",yMeasures:["retentionRate"],dimensions:[{key:"week",label:"Week",dataPath:"week",type:"category"}],measures:[{key:"retentionRate",label:"Retention",dataPath:"retentionRate",format:"percentage",color:"#16a34a"}],thresholds:[{key:"floor",value:0.5,label:"Floor",color:"#f59e0b"}],table:{caption:"Weekly retention rate."}}}),I=T({meta:{...e,key:"analytics.visualization.pipeline-scatter",title:"Pipeline Velocity",description:"Deal-cycle length against win rate for active accounts.",goal:"Spot outliers where the sales cycle is long but conversion remains weak.",context:"Commercial operations dashboard."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"scatter",xDimension:"cycleDays",yMeasures:["winRate"],dimensions:[{key:"cycleDays",label:"Cycle Days",dataPath:"cycleDays",type:"number"}],measures:[{key:"winRate",label:"Win Rate",dataPath:"winRate",format:"percentage",color:"#7c3aed"},{key:"arr",label:"ARR",dataPath:"arr",format:"currency"}],series:[{key:"pipeline",label:"Accounts",measure:"winRate",type:"scatter",color:"#7c3aed"}],table:{caption:"Sales cycle and win rate per account."}}});import{VisualizationRegistry as Fr}from"@contractspec/lib.contracts-spec/visualizations";var d=[x,f,h,E,I,R,S,_,g],Yr=new Fr([...d]),Ar=d.map((r)=>Z(r)),tr=new Map(d.map((r)=>[B(r.meta),r])),a={[B(x.meta)]:{data:[{period:"2025-11-01",totalRevenue:112000,priorRevenue:103000},{period:"2025-12-01",totalRevenue:119000,priorRevenue:110000},{period:"2026-01-01",totalRevenue:126500,priorRevenue:116000},{period:"2026-02-01",totalRevenue:133000,priorRevenue:124000},{period:"2026-03-01",totalRevenue:145500,priorRevenue:133000}]},[B(f.meta)]:{data:[{date:"2025-11-01",revenue:112000},{date:"2025-12-01",revenue:119000},{date:"2026-01-01",revenue:126500},{date:"2026-02-01",revenue:133000},{date:"2026-03-01",revenue:145500}]},[B(h.meta)]:{data:[{region:"North America",revenue:210000},{region:"EMEA",revenue:174000},{region:"APAC",revenue:132000},{region:"LATAM",revenue:88000}]},[B(E.meta)]:{data:[{week:"Week 1",retentionRate:0.71},{week:"Week 2",retentionRate:0.66},{week:"Week 3",retentionRate:0.62},{week:"Week 4",retentionRate:0.58},{week:"Week 5",retentionRate:0.55},{week:"Week 6",retentionRate:0.53}]},[B(I.meta)]:{data:[{cycleDays:18,winRate:0.31,arr:82000},{cycleDays:26,winRate:0.44,arr:65000},{cycleDays:33,winRate:0.27,arr:91000},{cycleDays:14,winRate:0.56,arr:47000},{cycleDays:21,winRate:0.48,arr:59000},{cycleDays:39,winRate:0.22,arr:114000}]},[B(R.meta)]:{data:[{channel:"Direct",sessions:4200},{channel:"Organic Search",sessions:3600},{channel:"Paid Search",sessions:2100},{channel:"Partner",sessions:1400},{channel:"Referral",sessions:900}]},[B(S.meta)]:{data:[{weekday:"Mon",timeBand:"09:00",engagementScore:74},{weekday:"Mon",timeBand:"13:00",engagementScore:82},{weekday:"Tue",timeBand:"09:00",engagementScore:69},{weekday:"Tue",timeBand:"13:00",engagementScore:88},{weekday:"Wed",timeBand:"09:00",engagementScore:77},{weekday:"Wed",timeBand:"13:00",engagementScore:91},{weekday:"Thu",timeBand:"09:00",engagementScore:72},{weekday:"Thu",timeBand:"13:00",engagementScore:86},{weekday:"Fri",timeBand:"09:00",engagementScore:65},{weekday:"Fri",timeBand:"13:00",engagementScore:79}]},[B(_.meta)]:{data:[{stage:"Visited Site",users:12000},{stage:"Started Trial",users:4200},{stage:"Activated Workspace",users:2400},{stage:"Requested Demo",users:980},{stage:"Closed Won",users:310}]},[B(g.meta)]:{data:[{city:"Paris",latitude:48.8566,longitude:2.3522,accounts:48},{city:"London",latitude:51.5072,longitude:-0.1276,accounts:62},{city:"New York",latitude:40.7128,longitude:-74.006,accounts:71},{city:"Toronto",latitude:43.6532,longitude:-79.3832,accounts:36},{city:"Singapore",latitude:1.3521,longitude:103.8198,accounts:29}]}};function Z(r){return{key:r.meta.key,version:r.meta.version}}function B(r){return`${r.key}.v${r.version}`}var Rr={METRIC:Z(x),LINE_CHART:Z(f),BAR_CHART:Z(h),AREA_CHART:Z(E),SCATTER_PLOT:Z(I),PIE_CHART:Z(R),HEATMAP:Z(S),FUNNEL:Z(_),MAP:Z(g)};function V(r){return[K(r,"widget_revenue_metric","Revenue Snapshot","METRIC",0,0,4,2,{layout:"single",bindings:[U(x,200)]}),K(r,"widget_revenue_trend","Revenue Trend","LINE_CHART",4,0,8,4,{layout:"single",bindings:[U(f)]}),K(r,"widget_regional_revenue","Regional Revenue","BAR_CHART",0,2,6,4,{layout:"single",bindings:[U(h)]}),K(r,"widget_channel_mix","Channel Mix","PIE_CHART",6,2,6,4,{layout:"single",bindings:[U(R)]}),K(r,"widget_retention","Retention Curve","AREA_CHART",0,6,6,4,{layout:"single",bindings:[U(E)]}),K(r,"widget_pipeline","Pipeline Velocity","SCATTER_PLOT",6,6,6,4,{layout:"single",bindings:[U(I)]}),K(r,"widget_heatmap","Engagement Heatmap","HEATMAP",0,10,8,4,{layout:"single",bindings:[U(S)]}),K(r,"widget_funnel","Conversion Funnel","FUNNEL",8,10,4,4,{layout:"single",bindings:[U(_)]}),K(r,"widget_geo","Account Coverage","MAP",0,14,12,5,{layout:"single",bindings:[U(g,360)]}),K(r,"widget_comparison","Commercial Comparison","EMBED",0,19,12,6,{layout:"comparison",description:"Compare regional distribution, channel balance, and funnel shape.",bindings:[U(h,240),U(R,240),U(_,240)]}),K(r,"widget_timeline","Growth Timeline","EMBED",0,25,12,6,{layout:"timeline",description:"Track revenue and retention over the same reporting cadence.",bindings:[U(f,220),U(E,220)]})]}function j(r){let o=_r(r),n=o.bindings.map(($)=>{let y=tr.get(B($.ref));if(!y)return null;return{key:`${r.id}:${B($.ref)}`,spec:y,data:$.data,title:$.title??y.meta.title,description:$.description??y.meta.description,height:$.height}}).filter(($)=>Boolean($));if(!n.length)return null;return{id:r.id,name:r.name,description:o.description,layout:o.layout,gridX:r.gridX,gridY:r.gridY,gridWidth:r.gridWidth,gridHeight:r.gridHeight,bindings:n}}function _r(r){if(fr(r.config))return r.config;let o=Rr[r.type];return o?{layout:"single",bindings:[{ref:o,data:a[B(o)]}]}:{layout:"single",bindings:[]}}function U(r,o=280){return{ref:Z(r),data:a[B(r.meta)],height:o}}function K(r,o,n,$,y,c,Q,t,G){let L=new Date;return{id:o,dashboardId:r,name:n,type:$,gridX:y,gridY:c,gridWidth:Q,gridHeight:t,config:G,createdAt:L,updatedAt:L}}function fr(r){if(!r||typeof r!=="object")return!1;let o=r;return(o.layout==="single"||o.layout==="comparison"||o.layout==="timeline")&&Array.isArray(o.bindings)}import{defineFeature as hr}from"@contractspec/lib.contracts-spec";var gn=hr({meta:{key:"analytics-dashboard",version:"1.0.0",title:"Analytics Dashboard",description:"Analytics dashboards with customizable widgets and queries",domain:"analytics",owners:["@analytics-dashboard"],tags:["analytics","dashboards","widgets","queries"],stability:"experimental"},operations:[{key:"analytics.dashboard.create",version:"1.0.0"},{key:"analytics.dashboard.list",version:"1.0.0"},{key:"analytics.dashboard.get",version:"1.0.0"},{key:"analytics.widget.add",version:"1.0.0"},{key:"analytics.query.create",version:"1.0.0"},{key:"analytics.query.execute",version:"1.0.0"}],events:[{key:"analytics.dashboard.created",version:"1.0.0"},{key:"analytics.widget.added",version:"1.0.0"},{key:"analytics.query.created",version:"1.0.0"}],presentations:[{key:"analytics.dashboard.viewList",version:"1.0.0"},{key:"analytics.dashboard.view",version:"1.0.0"},{key:"analytics.dashboard.editor",version:"1.0.0"},{key:"analytics.query.list",version:"1.0.0"},{key:"analytics.query.builder",version:"1.0.0"}],visualizations:[...Ar],opToPresentation:[{op:{key:"analytics.dashboard.list",version:"1.0.0"},pres:{key:"analytics.dashboard.viewList",version:"1.0.0"}},{op:{key:"analytics.dashboard.get",version:"1.0.0"},pres:{key:"analytics.dashboard.view",version:"1.0.0"}},{op:{key:"analytics.dashboard.create",version:"1.0.0"},pres:{key:"analytics.dashboard.editor",version:"1.0.0"}},{op:{key:"analytics.query.create",version:"1.0.0"},pres:{key:"analytics.query.builder",version:"1.0.0"}}],presentationsTargets:[{key:"analytics.dashboard.viewList",version:"1.0.0",targets:["react","markdown","application/json"]},{key:"analytics.dashboard.view",version:"1.0.0",targets:["react","markdown"]},{key:"analytics.dashboard.editor",version:"1.0.0",targets:["react"]},{key:"analytics.query.builder",version:"1.0.0",targets:["react"]}],capabilities:{requires:[{key:"identity",version:"1.0.0"},{key:"metering",version:"1.0.0"},{key:"audit-trail",version:"1.0.0"}]},telemetry:[{key:"analytics-dashboard.telemetry",version:"1.0.0"}],docs:["docs.examples.analytics-dashboard","docs.examples.analytics-dashboard.goal","docs.examples.analytics-dashboard.usage","docs.examples.analytics-dashboard.constraints"]});class Qr{reader;defaultLimit;constructor(r,o={}){this.reader=r,this.defaultLimit=o.defaultLimit??100}async execute(r,o){let n=Date.now(),$=this.validateQuery(r);if(!$.valid)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:$.errors.join(", ")};if(!this.reader.queryHogQL)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:"Analytics reader does not support HogQL queries."};try{let y=await this.executeHogQL(r,o);return{data:y.data,columns:y.columns,rowCount:y.rowCount,executionTimeMs:Date.now()-n,cached:!1}}catch(y){return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:y instanceof Error?y.message:"Unknown error"}}}validateQuery(r){let o=[];if(r.type==="SQL"&&!r.sql)o.push("SQL query is missing.");if(r.type==="AGGREGATION"&&!r.aggregation)o.push("Aggregation definition is missing.");if(r.type==="METRIC"&&!r.metricIds?.length)o.push("Metric IDs are missing.");if(r.type==="CUSTOM"&&!r.custom?.handler)o.push("Custom handler is missing.");return{valid:o.length===0,errors:o}}async executeHogQL(r,o){if(!this.reader.queryHogQL)throw Error("Analytics reader does not support HogQL queries.");if(r.type==="SQL"){let n=await this.reader.queryHogQL({query:r.sql??"",values:o.parameters??{}});return kr(n)}if(r.type==="AGGREGATION"&&r.aggregation){let{query:n,values:$}=gr(r.aggregation,o),y=await this.reader.queryHogQL({query:n,values:$});return kr(y)}if(r.type==="METRIC"&&r.metricIds){let{query:n,values:$}=Sr(r.metricIds,o),y=await this.reader.queryHogQL({query:n,values:$});return kr(y)}throw Error("Unsupported query type for PostHog datasource.")}}function Er(r,o){return new Qr(r,o)}function Sr(r,o){let n=Ur(o),$={dateFrom:n?.from.toISOString(),dateTo:n?.to.toISOString()},y=r.map((Q,t)=>{return $[`metric${t}`]=Q,`event = {metric${t}}`}),c=[y.length?`(${y.join(" or ")})`:"",n?"timestamp >= {dateFrom} and timestamp < {dateTo}":""].filter(Boolean).join(" and ");return{query:["select"," event as metric,"," count() as total","from events",c?`where ${c}`:"","group by metric"].filter(Boolean).join(`
|
|
2
|
-
`),values:$}}function
|
|
3
|
-
`)}`,`from ${r.source}`,Q.length?`where ${Q.join(" and ")}`:"",$.length?`group by ${$.map((L)=>L.name).join(", ")}`:"",G,`limit ${
|
|
4
|
-
`),values:c}}function
|
|
5
|
-
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,[
|
|
6
|
-
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,[m,A.dashboardId,A.name,A.type,A.gridX??0,A.gridY??0,A.gridWidth??6,A.gridHeight??4,A.queryId??null,A.config?JSON.stringify(A.config):null,
|
|
7
|
-
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,[D,m.projectId,m.organizationId,A.name,A.description??null,A.type,JSON.stringify(A.definition),A.sql??null,A.cacheTtlSeconds??300,A.isShared?1:0,k,k]);let N=(await r.query("SELECT * FROM analytics_query WHERE id = ?",[D])).rows;return Dr(N[0])}async function Y(A){let m=(await r.query("SELECT * FROM analytics_query WHERE id = ?",[A])).rows;return m[0]?Dr(m[0]):null}return{listDashboards:o,createDashboard:n,getDashboard:$,updateDashboard:y,getWidgets:c,addWidget:Q,updateWidget:t,deleteWidget:G,listQueries:L,createQuery:C,getQuery:Y}}import{defineEnum as lr}from"@contractspec/lib.schema";var or=lr("QueryType",["SQL","METRIC","AGGREGATION","CUSTOM"]);import{defineSchemaModel as mr,ScalarTypeEnum as P}from"@contractspec/lib.schema";var $r=mr({name:"QueryModel",fields:{id:{type:P.String_unsecure(),isOptional:!1},name:{type:P.String_unsecure(),isOptional:!1},description:{type:P.String_unsecure(),isOptional:!0},type:{type:or,isOptional:!1},definition:{type:P.JSON(),isOptional:!1},sql:{type:P.String_unsecure(),isOptional:!0},cacheTtlSeconds:{type:P.Int_unsecure(),isOptional:!1},isShared:{type:P.Boolean(),isOptional:!1},createdAt:{type:P.DateTime(),isOptional:!1}}}),Nr=mr({name:"QueryResultModel",fields:{queryId:{type:P.String_unsecure(),isOptional:!1},data:{type:P.JSON(),isOptional:!1},columns:{type:P.JSON(),isOptional:!1},rowCount:{type:P.Int_unsecure(),isOptional:!1},executionTimeMs:{type:P.Int_unsecure(),isOptional:!1},cachedAt:{type:P.DateTime(),isOptional:!0},error:{type:P.String_unsecure(),isOptional:!0}}}),Pr=mr({name:"CreateQueryInput",fields:{name:{type:P.NonEmptyString(),isOptional:!1},description:{type:P.String_unsecure(),isOptional:!0},type:{type:or,isOptional:!1},definition:{type:P.JSON(),isOptional:!1},sql:{type:P.String_unsecure(),isOptional:!0},metricIds:{type:P.String_unsecure(),isArray:!0,isOptional:!0},cacheTtlSeconds:{type:P.Int_unsecure(),isOptional:!0},isShared:{type:P.Boolean(),isOptional:!0}}}),Gr=mr({name:"ExecuteQueryInput",fields:{queryId:{type:P.String_unsecure(),isOptional:!1},parameters:{type:P.JSON(),isOptional:!0},dateRange:{type:P.JSON(),isOptional:!0},filters:{type:P.JSON(),isOptional:!0},forceRefresh:{type:P.Boolean(),isOptional:!0}}});import{defineCommand as Tr,defineQuery as zr}from"@contractspec/lib.contracts-spec/operations";var Hr=["@example.analytics-dashboard"],er=Tr({meta:{key:"analytics.query.create",version:"1.0.0",stability:"stable",owners:[...Hr],tags:["analytics","query","create"],description:"Create a data query.",goal:"Define reusable data queries.",context:"Query builder."},io:{input:Pr,output:$r},policy:{auth:"user"},sideEffects:{emits:[{key:"analytics.query.created",version:"1.0.0",stability:"stable",owners:[...Hr],tags:["analytics","query","created"],when:"Query created",payload:$r}],audit:["analytics.query.created"]},acceptance:{scenarios:[{key:"create-query-happy-path",given:["User is authenticated"],when:["User submits valid query definition"],then:["Query is created","QueryCreated event is emitted"]}],examples:[{key:"create-sql-query",input:{name:"Monthly Revenue",sql:"SELECT SUM(amount) FROM orders WHERE date >= :startDate"},output:{id:"query-123",name:"Monthly Revenue",type:"sql"}}]}}),jr=zr({meta:{key:"analytics.query.execute",version:"1.0.0",stability:"stable",owners:[...Hr],tags:["analytics","query","execute"],description:"Execute a data query.",goal:"Fetch data for visualizations.",context:"Dashboard rendering."},io:{input:Gr,output:Nr},policy:{auth:"user"},acceptance:{scenarios:[{key:"execute-query-happy-path",given:["Query exists"],when:["User executes query with parameters"],then:["Query results are returned"]}],examples:[{key:"execute-with-params",input:{queryId:"query-123",params:{startDate:"2025-01-01"}},output:{columns:["total"],rows:[{total:50000}],rowCount:1}}]}});class Zr{cache=new Map;async get(r){let o=this.cache.get(r);if(!o)return null;if(o.expiresAt<new Date)return this.cache.delete(r),null;return{...o.result,cached:!0,cachedAt:o.expiresAt}}async set(r,o,n){let $=new Date(Date.now()+n*1000);this.cache.set(r,{result:o,expiresAt:$})}async invalidate(r){let o=new RegExp(r);for(let n of this.cache.keys())if(o.test(n))this.cache.delete(n)}}class qr{cache;constructor(r){this.cache=r??new Zr}async execute(r,o){let n=Date.now(),$=this.validateQuery(r);if(!$.valid)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:$.errors.join(", ")};let y=this.buildCacheKey(r,o),c=await this.cache.get(y);if(c)return c;let Q;switch(r.type){case"AGGREGATION":if(!r.aggregation)throw Error("Aggregation definition is missing");Q=await this.executeAggregation(r.aggregation,o);break;case"METRIC":if(!r.metricIds)throw Error("Metric IDs are missing");Q=await this.executeMetric(r.metricIds,o);break;case"SQL":if(!r.sql)throw Error("SQL query is missing");Q=await this.executeSql(r.sql,o);break;default:Q={data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:`Unknown query type: ${r.type}`}}return Q.executionTimeMs=Date.now()-n,Q.cached=!1,await this.cache.set(y,Q,300),Q}validateQuery(r){let o=[];if(!r.type)o.push("Query type is required");switch(r.type){case"SQL":if(!r.sql)o.push("SQL query is required for SQL type");break;case"METRIC":if(!r.metricIds||r.metricIds.length===0)o.push("Metric IDs are required for METRIC type");break;case"AGGREGATION":if(!r.aggregation)o.push("Aggregation definition is required for AGGREGATION type");else{if(!r.aggregation.source)o.push("Aggregation source is required");if(!r.aggregation.measures||r.aggregation.measures.length===0)o.push("At least one measure is required")}break}return{valid:o.length===0,errors:o}}buildCacheKey(r,o){return JSON.stringify({definition:r,params:o})}async executeAggregation(r,o){let n=[...r.dimensions.map((y)=>({name:y.name,type:y.type==="NUMBER"?"NUMBER":y.type==="TIME"?"DATE":"STRING",label:y.name})),...r.measures.map((y)=>({name:y.name,type:"NUMBER",label:y.name,format:y.format}))],$=this.generateMockData(r,o);return{data:$,columns:n,rowCount:$.length,executionTimeMs:0,cached:!1}}async executeMetric(r,o){let n=r.map(($)=>({metricId:$,value:Math.random()*1000,change:(Math.random()-0.5)*20}));return{data:n,columns:[{name:"metricId",type:"STRING"},{name:"value",type:"NUMBER"},{name:"change",type:"NUMBER"}],rowCount:n.length,executionTimeMs:0,cached:!1}}async executeSql(r,o){return{data:[],columns:[],rowCount:0,executionTimeMs:0,cached:!1,error:"SQL execution not implemented in demo"}}generateMockData(r,o){let n=[],$=10,y=r.dimensions.find((c)=>c.type==="TIME");for(let c=0;c<10;c++){let Q={};for(let t of r.dimensions)if(t.type==="TIME"){let G=new Date(o.dateRange?.start??new Date);G.setDate(G.getDate()+c),Q[t.name]=G.toISOString().split("T")[0]}else Q[t.name]=`${t.name}_${c%5}`;for(let t of r.measures){let G=y?100+c*10:Math.random()*1000,L=(Math.random()-0.5)*20;Q[t.name]=Math.round((G+L)*100)/100}n.push(Q)}return n}}function oo(r){return new qr(r)}import{ComparisonView as pr,TimelineView as wr,VisualizationCard as br,VisualizationGrid as sr}from"@contractspec/lib.design-system";import{jsx as p,jsxs as yr}from"react/jsx-runtime";function Xr({dashboardName:r,widgets:o}){if(!o.length)return yr("div",{className:"rounded-lg border border-dashed p-10 text-center text-muted-foreground",children:['No visualization widgets configured for "',r,'".']});return yr("div",{children:[yr("h3",{className:"mb-4 font-semibold text-lg",children:['Widgets in "',r,'"']}),p(sr,{children:o.map((n)=>p("div",{className:dr(n.gridWidth),children:ir(n)},n.id))})]})}function ir(r){let o=yr("span",{className:"text-muted-foreground text-xs",children:["Position: (",r.gridX,", ",r.gridY,") • ",r.gridWidth,"x",r.gridHeight]});if(r.layout==="comparison")return p(pr,{description:r.description,items:r.bindings.map(($)=>({...$,footer:o})),title:r.name});if(r.layout==="timeline")return p(wr,{description:r.description,items:r.bindings.map(($)=>({...$,footer:o})),title:r.name});let n=r.bindings[0];if(!n)return null;return p(br,{data:n.data,description:r.description??n.description,footer:o,height:n.height,spec:n.spec,title:r.name})}function dr(r){if(r>=12)return"md:col-span-2 xl:col-span-3";if(r>=8)return"xl:col-span-2";if(r>=6)return"md:col-span-2";return""}import{DataTable as ar}from"@contractspec/lib.design-system";import{useContractTable as rn}from"@contractspec/lib.presentation-runtime-react";import{Badge as Jr}from"@contractspec/lib.ui-kit-web/ui/badge";import{HStack as nn,VStack as w}from"@contractspec/lib.ui-kit-web/ui/stack";import{Text as v}from"@contractspec/lib.ui-kit-web/ui/text";import{jsx as q,jsxs as F}from"react/jsx-runtime";var on={SQL:"default",METRIC:"secondary",AGGREGATION:"secondary",CUSTOM:"outline"};function mn(r){return JSON.stringify(r,null,2)}function Kr({queries:r}){let o=rn({data:r,columns:[{id:"query",header:"Query",label:"Query",accessor:(n)=>n.name,cell:({item:n})=>F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:n.name}),F(v,{className:"text-muted-foreground text-xs",children:["Updated ",n.updatedAt.toLocaleDateString()]})]}),size:240,minSize:180,canSort:!0,canPin:!0,canResize:!0},{id:"description",header:"Description",label:"Description",accessor:(n)=>n.description??"",cell:({value:n})=>q(v,{className:"line-clamp-2 text-muted-foreground text-sm",children:String(n||"No description")}),size:300,minSize:220,canSort:!1,canHide:!0,canResize:!0},{id:"type",header:"Type",label:"Type",accessorKey:"type",cell:({value:n})=>q(Jr,{variant:on[String(n)],children:String(n)}),size:150,canSort:!0,canHide:!0,canResize:!0},{id:"cacheTtlSeconds",header:"Cache TTL",label:"Cache TTL",accessorKey:"cacheTtlSeconds",cell:({value:n})=>`${String(n)}s`,align:"right",size:140,canSort:!0,canResize:!0},{id:"isShared",header:"Shared",label:"Shared",accessorKey:"isShared",cell:({value:n})=>q(Jr,{variant:n?"default":"outline",children:n?"Shared":"Private"}),size:140,canSort:!0,canHide:!0,canResize:!0}],initialState:{pagination:{pageIndex:0,pageSize:3},columnVisibility:{description:!1},columnPinning:{left:["query"],right:[]}},renderExpandedContent:(n)=>F(w,{gap:"sm",className:"py-2",children:[F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:"Description"}),q(v,{className:"text-muted-foreground text-sm",children:n.description??"No description"})]}),n.sql?F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:"SQL"}),q("pre",{className:"overflow-auto rounded-md bg-muted/40 p-3 text-xs",children:n.sql})]}):null,F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:"Definition"}),q("pre",{className:"overflow-auto rounded-md bg-muted/40 p-3 text-xs",children:mn(n.definition)})]})]}),getCanExpand:()=>!0});return q(ar,{controller:o,title:"Saved Queries",description:"Client-mode table using the shared ContractSpec controller and renderer.",toolbar:F(nn,{gap:"sm",className:"flex-wrap",children:[F(v,{className:"text-muted-foreground text-sm",children:[r.length," queries"]}),F(v,{className:"text-muted-foreground text-sm",children:[r.filter((n)=>n.isShared).length," shared"]})]}),emptyState:q("div",{className:"rounded-md border border-dashed p-8 text-center text-muted-foreground text-sm",children:"No queries saved"})})}import{useTemplateRuntime as $n}from"@contractspec/lib.example-shared-ui";import{useCallback as Cr,useEffect as yn,useState as u}from"react";function Br(r="local-project"){let{handlers:o}=$n(),n=o.analytics,[$,y]=u([]),[c,Q]=u([]),[t,G]=u(null),[L,C]=u([]),[Y,A]=u(!0),[m,D]=u(null),k=Cr(async()=>{try{A(!0),D(null);let[H,O]=await Promise.all([n.listDashboards({projectId:r,limit:100}),n.listQueries({projectId:r,limit:100})]);if(y(H.dashboards),Q(O.queries),H.dashboards.length>0&&!t){let J=H.dashboards[0];if(J){G(J);let l=await n.getWidgets(J.id);C(l.length>0?l:V(J.id))}}}catch(H){D(H instanceof Error?H:Error("Failed to load analytics"))}finally{A(!1)}},[n,r,t]);yn(()=>{k()},[k]);let N=Cr(async(H)=>{G(H);let O=await n.getWidgets(H.id);C(O.length>0?O:V(H.id))},[n]),W={totalDashboards:$.length,publishedDashboards:$.filter((H)=>H.status==="PUBLISHED").length,totalQueries:c.length,sharedQueries:c.filter((H)=>H.isShared).length};return{dashboards:$,queries:c,selectedDashboard:t,widgets:L,loading:Y,error:m,stats:W,refetch:k,selectDashboard:N}}import{Button as Wr,ErrorState as cn,LoaderBlock as An,StatCard as Mr,StatCardGroup as tn}from"@contractspec/lib.design-system";import{useMemo as kn,useState as Qn}from"react";import{jsx as M,jsxs as X}from"react/jsx-runtime";var Ln={PUBLISHED:"bg-green-100 text-green-700 dark:bg-green-900/30 dark:text-green-400",DRAFT:"bg-gray-100 text-gray-700 dark:bg-gray-900/30 dark:text-gray-400",ARCHIVED:"bg-yellow-100 text-yellow-700 dark:bg-yellow-900/30 dark:text-yellow-400"};function Dn(){let[r,o]=Qn("dashboards"),{dashboards:n,queries:$,selectedDashboard:y,widgets:c,loading:Q,error:t,stats:G,refetch:L,selectDashboard:C}=Br(),Y=[{id:"dashboards",label:"Dashboards",icon:"\uD83D\uDCCA"},{id:"queries",label:"Queries",icon:"\uD83D\uDD0D"}],A=kn(()=>c.map((m)=>j(m)).filter((m)=>Boolean(m)),[c]);if(Q)return M(An,{label:"Loading Analytics..."});if(t)return M(cn,{title:"Failed to load Analytics",description:t.message,onRetry:L,retryLabel:"Retry"});return X("div",{className:"space-y-6",children:[X("div",{className:"flex items-center justify-between",children:[M("h2",{className:"font-bold text-2xl",children:"Analytics Dashboard"}),X(Wr,{onClick:()=>alert("Create dashboard modal"),children:[M("span",{className:"mr-2",children:"+"})," New Dashboard"]})]}),X(tn,{children:[M(Mr,{label:"Dashboards",value:G.totalDashboards,hint:`${G.publishedDashboards} published`}),M(Mr,{label:"Queries",value:G.totalQueries,hint:`${G.sharedQueries} shared`}),M(Mr,{label:"Widgets",value:c.length,hint:"on current dashboard"})]}),M("nav",{className:"flex gap-1 rounded-lg bg-muted p-1",role:"tablist",children:Y.map((m)=>X(Wr,{type:"button",role:"tab","aria-selected":r===m.id,onClick:()=>o(m.id),className:`flex flex-1 items-center justify-center gap-2 rounded-md px-4 py-2 font-medium text-sm transition-colors ${r===m.id?"bg-background text-foreground shadow-sm":"text-muted-foreground hover:text-foreground"}`,children:[M("span",{children:m.icon}),m.label]},m.id))}),X("div",{className:"min-h-[400px]",role:"tabpanel",children:[r==="dashboards"&&X("div",{className:"space-y-6",children:[X("div",{className:"grid gap-4 sm:grid-cols-2 lg:grid-cols-3",children:[n.map((m)=>X("div",{onClick:()=>C(m),className:`cursor-pointer rounded-lg border border-border bg-card p-4 transition-all ${y?.id===m.id?"ring-2 ring-primary":"hover:bg-muted/50"}`,role:"button",tabIndex:0,onKeyDown:(D)=>{if(D.key==="Enter"||D.key===" ")C(m)},children:[X("div",{className:"mb-2 flex items-center justify-between",children:[M("h3",{className:"font-medium",children:m.name}),M("span",{className:`inline-flex rounded-full px-2 py-0.5 font-medium text-xs ${Ln[m.status]??""}`,children:m.status})]}),M("p",{className:"mb-3 text-muted-foreground text-sm",children:m.description}),X("div",{className:"flex items-center justify-between text-muted-foreground text-xs",children:[X("span",{children:["/",m.slug]}),m.isPublic&&M("span",{className:"text-green-600 dark:text-green-400",children:"\uD83C\uDF10 Public"})]})]},m.id)),n.length===0&&M("div",{className:"col-span-full flex h-64 items-center justify-center text-muted-foreground",children:"No dashboards created yet"})]}),y?M(Xr,{dashboardName:y.name,widgets:A}):null]}),r==="queries"&&M(Kr,{queries:$})]})]})}var cr=[{id:"dash-1",name:"Sales Overview",slug:"sales-overview",status:"PUBLISHED",widgetCount:11,viewCount:1250,lastViewedAt:"2026-03-18T12:00:00Z"},{id:"dash-2",name:"User Engagement",slug:"user-engagement",status:"PUBLISHED",widgetCount:8,viewCount:890,lastViewedAt:"2026-03-18T10:00:00Z"}],vr=[{id:"q-1",name:"Monthly Revenue",type:"AGGREGATION",isShared:!0,executionCount:1500},{id:"q-2",name:"User Growth",type:"METRIC",isShared:!0,executionCount:890},{id:"q-3",name:"Product Sales",type:"SQL",isShared:!1,executionCount:340},{id:"q-4",name:"Conversion Funnel",type:"AGGREGATION",isShared:!0,executionCount:450}];function Nn(r){return V(r).map((o)=>j(o)).filter((o)=>Boolean(o))}var Pn={target:"markdown",render:async(r)=>{if(r.source.type!=="component"||r.source.componentKey!=="AnalyticsDashboard")throw Error("analyticsDashboardMarkdownRenderer: not AnalyticsDashboard");let o=cr[0];if(!o)return{mimeType:"text/markdown",body:`# No Dashboards
|
|
1
|
+
import{defineVisualization as b}from"@contractspec/lib.contracts-spec/visualizations";var s={key:"analytics.query.execute",version:"1.0.0"},i={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},R=b({meta:{...i,key:"analytics.visualization.channel-mix",title:"Channel Mix",description:"Session distribution across acquisition channels.",goal:"Explain which channels currently drive the largest share of traffic.",context:"Marketing attribution dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"pie",nameDimension:"channel",valueMeasure:"sessions",dimensions:[{key:"channel",label:"Channel",dataPath:"channel",type:"category"}],measures:[{key:"sessions",label:"Sessions",dataPath:"sessions"}],table:{caption:"Sessions by acquisition channel."}}}),g=b({meta:{...i,key:"analytics.visualization.engagement-heatmap",title:"Engagement Heatmap",description:"Average engagement score by weekday and time band.",goal:"Reveal the highest-engagement time windows for product activity.",context:"Usage analytics dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"heatmap",xDimension:"timeBand",yDimension:"weekday",valueMeasure:"engagementScore",dimensions:[{key:"timeBand",label:"Time Band",dataPath:"timeBand",type:"category"},{key:"weekday",label:"Weekday",dataPath:"weekday",type:"category"}],measures:[{key:"engagementScore",label:"Engagement",dataPath:"engagementScore"}],table:{caption:"Engagement score by weekday and time band."}}}),_=b({meta:{...i,key:"analytics.visualization.conversion-funnel",title:"Conversion Funnel",description:"Progression through the main acquisition funnel.",goal:"Show where the product is losing the largest share of prospects.",context:"Growth dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"funnel",nameDimension:"stage",valueMeasure:"users",sort:"descending",dimensions:[{key:"stage",label:"Stage",dataPath:"stage",type:"category"}],measures:[{key:"users",label:"Users",dataPath:"users"}],table:{caption:"Users per conversion stage."}}}),E=b({meta:{...i,key:"analytics.visualization.account-coverage-geo",title:"Account Coverage",description:"High-value accounts plotted on a slippy-map surface.",goal:"Locate where active commercial concentration is strongest.",context:"Territory coverage dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"geo",mode:"slippy-map",variant:"scatter",nameDimension:"city",latitudeDimension:"latitude",longitudeDimension:"longitude",valueMeasure:"accounts",dimensions:[{key:"city",label:"City",dataPath:"city",type:"category"},{key:"latitude",label:"Latitude",dataPath:"latitude",type:"latitude"},{key:"longitude",label:"Longitude",dataPath:"longitude",type:"longitude"}],measures:[{key:"accounts",label:"Accounts",dataPath:"accounts"}],table:{caption:"Account concentration by city."}}});import{defineVisualization as l}from"@contractspec/lib.contracts-spec/visualizations";var z={key:"analytics.query.execute",version:"1.0.0"},e={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},I=l({meta:{...e,key:"analytics.visualization.revenue-metric",title:"Revenue Snapshot",description:"Current recurring revenue with prior-period comparison.",goal:"Highlight the headline commercial metric for the dashboard.",context:"Executive revenue overview."},source:{primary:z,resultPath:"data"},visualization:{kind:"metric",measure:"totalRevenue",comparisonMeasure:"priorRevenue",dimensions:[{key:"period",label:"Period",dataPath:"period",type:"time"}],measures:[{key:"totalRevenue",label:"Revenue",dataPath:"totalRevenue",format:"currency"},{key:"priorRevenue",label:"Prior Revenue",dataPath:"priorRevenue",format:"currency"}],sparkline:{dimension:"period",measure:"totalRevenue"},table:{caption:"Revenue trend and prior period values."}}}),f=l({meta:{...e,key:"analytics.visualization.revenue-trend",title:"Revenue Trend",description:"Monthly revenue progression for the current quarter.",goal:"Track whether revenue growth is accelerating or stalling.",context:"Quarterly commercial dashboard."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"line",xDimension:"date",yMeasures:["revenue"],dimensions:[{key:"date",label:"Month",dataPath:"date",type:"time"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#0f766e"}],thresholds:[{key:"target",value:140000,label:"Target",color:"#dc2626"}],table:{caption:"Monthly revenue values."}}}),h=l({meta:{...e,key:"analytics.visualization.regional-revenue",title:"Regional Revenue",description:"Revenue split by sales territory.",goal:"Compare the strongest and weakest performing territories.",context:"Territory planning and commercial comparison."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"bar",xDimension:"region",yMeasures:["revenue"],dimensions:[{key:"region",label:"Region",dataPath:"region",type:"category"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#1d4ed8"}],table:{caption:"Revenue by region."}}}),S=l({meta:{...e,key:"analytics.visualization.retention-area",title:"Retention Curve",description:"Weekly retention progression across the active cohort.",goal:"Show whether user retention remains above the desired floor.",context:"Product health dashboard."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"area",xDimension:"week",yMeasures:["retentionRate"],dimensions:[{key:"week",label:"Week",dataPath:"week",type:"category"}],measures:[{key:"retentionRate",label:"Retention",dataPath:"retentionRate",format:"percentage",color:"#16a34a"}],thresholds:[{key:"floor",value:0.5,label:"Floor",color:"#f59e0b"}],table:{caption:"Weekly retention rate."}}}),V=l({meta:{...e,key:"analytics.visualization.pipeline-scatter",title:"Pipeline Velocity",description:"Deal-cycle length against win rate for active accounts.",goal:"Spot outliers where the sales cycle is long but conversion remains weak.",context:"Commercial operations dashboard."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"scatter",xDimension:"cycleDays",yMeasures:["winRate"],dimensions:[{key:"cycleDays",label:"Cycle Days",dataPath:"cycleDays",type:"number"}],measures:[{key:"winRate",label:"Win Rate",dataPath:"winRate",format:"percentage",color:"#7c3aed"},{key:"arr",label:"ARR",dataPath:"arr",format:"currency"}],series:[{key:"pipeline",label:"Accounts",measure:"winRate",type:"scatter",color:"#7c3aed"}],table:{caption:"Sales cycle and win rate per account."}}});import{VisualizationRegistry as Fr}from"@contractspec/lib.contracts-spec/visualizations";var d=[I,f,h,S,V,R,g,_,E],Yr=new Fr([...d]),Ar=d.map((r)=>Z(r)),kr=new Map(d.map((r)=>[B(r.meta),r])),a={[B(I.meta)]:{data:[{period:"2025-11-01",totalRevenue:112000,priorRevenue:103000},{period:"2025-12-01",totalRevenue:119000,priorRevenue:110000},{period:"2026-01-01",totalRevenue:126500,priorRevenue:116000},{period:"2026-02-01",totalRevenue:133000,priorRevenue:124000},{period:"2026-03-01",totalRevenue:145500,priorRevenue:133000}]},[B(f.meta)]:{data:[{date:"2025-11-01",revenue:112000},{date:"2025-12-01",revenue:119000},{date:"2026-01-01",revenue:126500},{date:"2026-02-01",revenue:133000},{date:"2026-03-01",revenue:145500}]},[B(h.meta)]:{data:[{region:"North America",revenue:210000},{region:"EMEA",revenue:174000},{region:"APAC",revenue:132000},{region:"LATAM",revenue:88000}]},[B(S.meta)]:{data:[{week:"Week 1",retentionRate:0.71},{week:"Week 2",retentionRate:0.66},{week:"Week 3",retentionRate:0.62},{week:"Week 4",retentionRate:0.58},{week:"Week 5",retentionRate:0.55},{week:"Week 6",retentionRate:0.53}]},[B(V.meta)]:{data:[{cycleDays:18,winRate:0.31,arr:82000},{cycleDays:26,winRate:0.44,arr:65000},{cycleDays:33,winRate:0.27,arr:91000},{cycleDays:14,winRate:0.56,arr:47000},{cycleDays:21,winRate:0.48,arr:59000},{cycleDays:39,winRate:0.22,arr:114000}]},[B(R.meta)]:{data:[{channel:"Direct",sessions:4200},{channel:"Organic Search",sessions:3600},{channel:"Paid Search",sessions:2100},{channel:"Partner",sessions:1400},{channel:"Referral",sessions:900}]},[B(g.meta)]:{data:[{weekday:"Mon",timeBand:"09:00",engagementScore:74},{weekday:"Mon",timeBand:"13:00",engagementScore:82},{weekday:"Tue",timeBand:"09:00",engagementScore:69},{weekday:"Tue",timeBand:"13:00",engagementScore:88},{weekday:"Wed",timeBand:"09:00",engagementScore:77},{weekday:"Wed",timeBand:"13:00",engagementScore:91},{weekday:"Thu",timeBand:"09:00",engagementScore:72},{weekday:"Thu",timeBand:"13:00",engagementScore:86},{weekday:"Fri",timeBand:"09:00",engagementScore:65},{weekday:"Fri",timeBand:"13:00",engagementScore:79}]},[B(_.meta)]:{data:[{stage:"Visited Site",users:12000},{stage:"Started Trial",users:4200},{stage:"Activated Workspace",users:2400},{stage:"Requested Demo",users:980},{stage:"Closed Won",users:310}]},[B(E.meta)]:{data:[{city:"Paris",latitude:48.8566,longitude:2.3522,accounts:48},{city:"London",latitude:51.5072,longitude:-0.1276,accounts:62},{city:"New York",latitude:40.7128,longitude:-74.006,accounts:71},{city:"Toronto",latitude:43.6532,longitude:-79.3832,accounts:36},{city:"Singapore",latitude:1.3521,longitude:103.8198,accounts:29}]}};function Z(r){return{key:r.meta.key,version:r.meta.version}}function B(r){return`${r.key}.v${r.version}`}var Rr={METRIC:Z(I),LINE_CHART:Z(f),BAR_CHART:Z(h),AREA_CHART:Z(S),SCATTER_PLOT:Z(V),PIE_CHART:Z(R),HEATMAP:Z(g),FUNNEL:Z(_),MAP:Z(E)};function u(r){return[K(r,"widget_revenue_metric","Revenue Snapshot","METRIC",0,0,4,2,{layout:"single",bindings:[U(I,200)]}),K(r,"widget_revenue_trend","Revenue Trend","LINE_CHART",4,0,8,4,{layout:"single",bindings:[U(f)]}),K(r,"widget_regional_revenue","Regional Revenue","BAR_CHART",0,2,6,4,{layout:"single",bindings:[U(h)]}),K(r,"widget_channel_mix","Channel Mix","PIE_CHART",6,2,6,4,{layout:"single",bindings:[U(R)]}),K(r,"widget_retention","Retention Curve","AREA_CHART",0,6,6,4,{layout:"single",bindings:[U(S)]}),K(r,"widget_pipeline","Pipeline Velocity","SCATTER_PLOT",6,6,6,4,{layout:"single",bindings:[U(V)]}),K(r,"widget_heatmap","Engagement Heatmap","HEATMAP",0,10,8,4,{layout:"single",bindings:[U(g)]}),K(r,"widget_funnel","Conversion Funnel","FUNNEL",8,10,4,4,{layout:"single",bindings:[U(_)]}),K(r,"widget_geo","Account Coverage","MAP",0,14,12,5,{layout:"single",bindings:[U(E,360)]}),K(r,"widget_comparison","Commercial Comparison","EMBED",0,19,12,6,{layout:"comparison",description:"Compare regional distribution, channel balance, and funnel shape.",bindings:[U(h,240),U(R,240),U(_,240)]}),K(r,"widget_timeline","Growth Timeline","EMBED",0,25,12,6,{layout:"timeline",description:"Track revenue and retention over the same reporting cadence.",bindings:[U(f,220),U(S,220)]})]}function j(r){let o=_r(r),n=o.bindings.map(($)=>{let y=kr.get(B($.ref));if(!y)return null;return{key:`${r.id}:${B($.ref)}`,spec:y,data:$.data,title:$.title??y.meta.title,description:$.description??y.meta.description,height:$.height}}).filter(($)=>Boolean($));if(!n.length)return null;return{id:r.id,name:r.name,description:o.description,layout:o.layout,gridX:r.gridX,gridY:r.gridY,gridWidth:r.gridWidth,gridHeight:r.gridHeight,bindings:n}}function _r(r){if(fr(r.config))return r.config;let o=Rr[r.type];return o?{layout:"single",bindings:[{ref:o,data:a[B(o)]}]}:{layout:"single",bindings:[]}}function U(r,o=280){return{ref:Z(r),data:a[B(r.meta)],height:o}}function K(r,o,n,$,y,c,Q,k,G){let L=new Date;return{id:o,dashboardId:r,name:n,type:$,gridX:y,gridY:c,gridWidth:Q,gridHeight:k,config:G,createdAt:L,updatedAt:L}}function fr(r){if(!r||typeof r!=="object")return!1;let o=r;return(o.layout==="single"||o.layout==="comparison"||o.layout==="timeline")&&Array.isArray(o.bindings)}import{defineFeature as hr}from"@contractspec/lib.contracts-spec/features";var Vn=hr({meta:{key:"analytics-dashboard",version:"1.0.0",title:"Analytics Dashboard",description:"Analytics dashboards with customizable widgets and queries",domain:"analytics",owners:["@analytics-dashboard"],tags:["analytics","dashboards","widgets","queries"],stability:"experimental"},operations:[{key:"analytics.dashboard.create",version:"1.0.0"},{key:"analytics.dashboard.list",version:"1.0.0"},{key:"analytics.dashboard.get",version:"1.0.0"},{key:"analytics.widget.add",version:"1.0.0"},{key:"analytics.query.create",version:"1.0.0"},{key:"analytics.query.execute",version:"1.0.0"}],events:[{key:"analytics.dashboard.created",version:"1.0.0"},{key:"analytics.widget.added",version:"1.0.0"},{key:"analytics.query.created",version:"1.0.0"}],presentations:[{key:"analytics.dashboard.viewList",version:"1.0.0"},{key:"analytics.dashboard.view",version:"1.0.0"},{key:"analytics.dashboard.editor",version:"1.0.0"},{key:"analytics.query.list",version:"1.0.0"},{key:"analytics.query.builder",version:"1.0.0"}],visualizations:[...Ar],opToPresentation:[{op:{key:"analytics.dashboard.list",version:"1.0.0"},pres:{key:"analytics.dashboard.viewList",version:"1.0.0"}},{op:{key:"analytics.dashboard.get",version:"1.0.0"},pres:{key:"analytics.dashboard.view",version:"1.0.0"}},{op:{key:"analytics.dashboard.create",version:"1.0.0"},pres:{key:"analytics.dashboard.editor",version:"1.0.0"}},{op:{key:"analytics.query.create",version:"1.0.0"},pres:{key:"analytics.query.builder",version:"1.0.0"}}],presentationsTargets:[{key:"analytics.dashboard.viewList",version:"1.0.0",targets:["react","markdown","application/json"]},{key:"analytics.dashboard.view",version:"1.0.0",targets:["react","markdown"]},{key:"analytics.dashboard.editor",version:"1.0.0",targets:["react"]},{key:"analytics.query.builder",version:"1.0.0",targets:["react"]}],capabilities:{requires:[{key:"identity",version:"1.0.0"},{key:"metering",version:"1.0.0"},{key:"audit-trail",version:"1.0.0"}]},telemetry:[{key:"analytics-dashboard.telemetry",version:"1.0.0"}],docs:["docs.examples.analytics-dashboard","docs.examples.analytics-dashboard.goal","docs.examples.analytics-dashboard.usage","docs.examples.analytics-dashboard.constraints"]});class Qr{reader;defaultLimit;constructor(r,o={}){this.reader=r,this.defaultLimit=o.defaultLimit??100}async execute(r,o){let n=Date.now(),$=this.validateQuery(r);if(!$.valid)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:$.errors.join(", ")};if(!this.reader.queryHogQL)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:"Analytics reader does not support HogQL queries."};try{let y=await this.executeHogQL(r,o);return{data:y.data,columns:y.columns,rowCount:y.rowCount,executionTimeMs:Date.now()-n,cached:!1}}catch(y){return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:y instanceof Error?y.message:"Unknown error"}}}validateQuery(r){let o=[];if(r.type==="SQL"&&!r.sql)o.push("SQL query is missing.");if(r.type==="AGGREGATION"&&!r.aggregation)o.push("Aggregation definition is missing.");if(r.type==="METRIC"&&!r.metricIds?.length)o.push("Metric IDs are missing.");if(r.type==="CUSTOM"&&!r.custom?.handler)o.push("Custom handler is missing.");return{valid:o.length===0,errors:o}}async executeHogQL(r,o){if(!this.reader.queryHogQL)throw Error("Analytics reader does not support HogQL queries.");if(r.type==="SQL"){let n=await this.reader.queryHogQL({query:r.sql??"",values:o.parameters??{}});return tr(n)}if(r.type==="AGGREGATION"&&r.aggregation){let{query:n,values:$}=Er(r.aggregation,o),y=await this.reader.queryHogQL({query:n,values:$});return tr(y)}if(r.type==="METRIC"&&r.metricIds){let{query:n,values:$}=gr(r.metricIds,o),y=await this.reader.queryHogQL({query:n,values:$});return tr(y)}throw Error("Unsupported query type for PostHog datasource.")}}function Sr(r,o){return new Qr(r,o)}function gr(r,o){let n=Ur(o),$={dateFrom:n?.from.toISOString(),dateTo:n?.to.toISOString()},y=r.map((Q,k)=>{return $[`metric${k}`]=Q,`event = {metric${k}}`}),c=[y.length?`(${y.join(" or ")})`:"",n?"timestamp >= {dateFrom} and timestamp < {dateTo}":""].filter(Boolean).join(" and ");return{query:["select"," event as metric,"," count() as total","from events",c?`where ${c}`:"","group by metric"].filter(Boolean).join(`
|
|
2
|
+
`),values:$}}function Er(r,o){let n=r.measures.map((L)=>({...L,expression:Ir(L.field,L.aggregation)})),$=r.dimensions.map((L)=>({...L,expression:Vr(L.field,L.type,L.granularity)})),y=[...$.map((L)=>`${L.expression} as ${L.name}`),...n.map((L)=>`${L.expression} as ${L.name}`)],c={},Q=ur(r,o,c),k=r.limit??100,G=r.orderBy?.length?`order by ${r.orderBy.map((L)=>`${L.field} ${L.direction}`).join(", ")}`:"";return{query:["select",` ${y.join(`,
|
|
3
|
+
`)}`,`from ${r.source}`,Q.length?`where ${Q.join(" and ")}`:"",$.length?`group by ${$.map((L)=>L.name).join(", ")}`:"",G,`limit ${k}`].filter(Boolean).join(`
|
|
4
|
+
`),values:c}}function Ir(r,o){switch(o){case"COUNT":return r==="*"?"count()":`count(${r})`;case"COUNT_DISTINCT":return`countDistinct(${r})`;case"SUM":return`sum(${r})`;case"AVG":return`avg(${r})`;case"MIN":return`min(${r})`;case"MAX":return`max(${r})`;default:return`count(${r})`}}function Vr(r,o,n){if(o==="TIME")switch(n){case"HOUR":return`toStartOfHour(${r})`;case"WEEK":return`toStartOfWeek(${r})`;case"MONTH":return`toStartOfMonth(${r})`;case"YEAR":return`toStartOfYear(${r})`;case"DAY":default:return`toStartOfDay(${r})`}return r}function ur(r,o,n){let $=[],y=Ur(o);if(y)n.dateFrom=y.from.toISOString(),n.dateTo=y.to.toISOString(),$.push("timestamp >= {dateFrom} and timestamp < {dateTo}");return r.filters?.forEach((c,Q)=>{let k=`filter${Q}`;switch(c.operator){case"eq":n[k]=c.value,$.push(`${c.field} = {${k}}`);break;case"neq":n[k]=c.value,$.push(`${c.field} != {${k}}`);break;case"gt":n[k]=c.value,$.push(`${c.field} > {${k}}`);break;case"gte":n[k]=c.value,$.push(`${c.field} >= {${k}}`);break;case"lt":n[k]=c.value,$.push(`${c.field} < {${k}}`);break;case"lte":n[k]=c.value,$.push(`${c.field} <= {${k}}`);break;case"contains":n[k]=c.value,$.push(`${c.field} LIKE '%' || {${k}} || '%'`);break;case"between":{if(Array.isArray(c.value)&&c.value.length>=2)n[`${k}Start`]=c.value[0],n[`${k}End`]=c.value[1],$.push(`${c.field} BETWEEN {${k}Start} AND {${k}End}`);break}case"in":case"nin":if(Array.isArray(c.value)){let G=[];if(c.value.forEach((L,C)=>{let Y=`${k}_${C}`;n[Y]=L,G.push(`{${Y}}`)}),G.length)$.push(`${c.field} ${c.operator==="in"?"IN":"NOT IN"} (${G.join(", ")})`)}break;default:break}}),$}function Ur(r){let o=r.dateRange;if(!o)return null;return{from:o.start,to:o.end}}function tr(r){if(!Array.isArray(r.results)||!Array.isArray(r.columns))return{data:[],columns:[],rowCount:0};let o=r.columns.map(($)=>({name:$,type:"STRING"})),n=r.results.map(($)=>{if(!Array.isArray($))return{};let y={};return r.columns?.forEach((c,Q)=>{y[c]=$[Q]}),y});return{data:n,columns:o,rowCount:n.length}}import{defineExample as xr}from"@contractspec/lib.contracts-spec/examples";var Tr=xr({meta:{key:"analytics-dashboard",version:"1.0.0",title:"Analytics Dashboard",description:"Analytics Dashboard example with widgets and query engine for ContractSpec",kind:"template",visibility:"public",stability:"stable",owners:["@contractspec-core"],tags:["package","examples","analytics-dashboard","analytics","dashboard"]},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["playground","specs"]},studio:{enabled:!1,installable:!1},mcp:{enabled:!1}},entrypoints:{packageName:"@contractspec/example.analytics-dashboard"}}),zn=Tr;import{web as lr}from"@contractspec/lib.runtime-sandbox";var{generateId:rr}=lr;function nr(r){return{id:r.id,projectId:r.projectId,organizationId:r.organizationId,name:r.name,slug:r.slug,description:r.description??void 0,status:r.status,refreshInterval:r.refreshInterval,isPublic:r.isPublic===1,shareToken:r.shareToken??void 0,createdAt:new Date(r.createdAt),updatedAt:new Date(r.updatedAt)}}function Lr(r){return{id:r.id,dashboardId:r.dashboardId,name:r.name,type:r.type,gridX:r.gridX,gridY:r.gridY,gridWidth:r.gridWidth,gridHeight:r.gridHeight,queryId:r.queryId??void 0,config:r.config?JSON.parse(r.config):void 0,createdAt:new Date(r.createdAt),updatedAt:new Date(r.updatedAt)}}function Nr(r){return{id:r.id,projectId:r.projectId,organizationId:r.organizationId,name:r.name,description:r.description??void 0,type:r.type,definition:JSON.parse(r.definition),sql:r.sql??void 0,cacheTtlSeconds:r.cacheTtlSeconds,isShared:r.isShared===1,createdAt:new Date(r.createdAt),updatedAt:new Date(r.updatedAt)}}function jn(r){async function o(A){let{projectId:m,status:N,search:t,limit:P=20,offset:W=0}=A,H="WHERE projectId = ?",O=[m];if(N&&N!=="all")H+=" AND status = ?",O.push(N);if(t)H+=" AND (name LIKE ? OR description LIKE ?)",O.push(`%${t}%`,`%${t}%`);let T=(await r.query(`SELECT COUNT(*) as count FROM analytics_dashboard ${H}`,O)).rows[0]?.count??0;return{dashboards:(await r.query(`SELECT * FROM analytics_dashboard ${H} ORDER BY updatedAt DESC LIMIT ? OFFSET ?`,[...O,P,W])).rows.map(nr),total:T}}async function n(A,m){let N=rr("dash"),t=new Date().toISOString();await r.execute(`INSERT INTO analytics_dashboard (id, projectId, organizationId, name, slug, description, status, refreshInterval, isPublic, createdAt, updatedAt)
|
|
5
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,[N,m.projectId,m.organizationId,A.name,A.slug,A.description??null,"DRAFT",A.refreshInterval??"NONE",0,t,t]);let P=(await r.query("SELECT * FROM analytics_dashboard WHERE id = ?",[N])).rows;return nr(P[0])}async function $(A){let m="",N=[];if(A.dashboardId)m="WHERE id = ?",N.push(A.dashboardId);else if(A.slug)m="WHERE slug = ?",N.push(A.slug);else if(A.shareToken)m="WHERE shareToken = ?",N.push(A.shareToken);else return null;let t=(await r.query(`SELECT * FROM analytics_dashboard ${m}`,N)).rows;return t[0]?nr(t[0]):null}async function y(A,m){let N=new Date().toISOString(),t=["updatedAt = ?"],P=[N];if(m.name!==void 0)t.push("name = ?"),P.push(m.name);if(m.description!==void 0)t.push("description = ?"),P.push(m.description);if(m.status!==void 0)t.push("status = ?"),P.push(m.status);if(m.refreshInterval!==void 0)t.push("refreshInterval = ?"),P.push(m.refreshInterval);if(m.isPublic!==void 0)if(t.push("isPublic = ?"),P.push(m.isPublic?1:0),m.isPublic)t.push("shareToken = ?"),P.push(rr("share"));else t.push("shareToken = NULL");P.push(A),await r.execute(`UPDATE analytics_dashboard SET ${t.join(", ")} WHERE id = ?`,P);let W=(await r.query("SELECT * FROM analytics_dashboard WHERE id = ?",[A])).rows;return nr(W[0])}async function c(A){return(await r.query("SELECT * FROM analytics_widget WHERE dashboardId = ? ORDER BY gridY, gridX",[A])).rows.map(Lr)}async function Q(A){let m=rr("widget"),N=new Date().toISOString();await r.execute(`INSERT INTO analytics_widget (id, dashboardId, name, type, gridX, gridY, gridWidth, gridHeight, queryId, config, createdAt, updatedAt)
|
|
6
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,[m,A.dashboardId,A.name,A.type,A.gridX??0,A.gridY??0,A.gridWidth??6,A.gridHeight??4,A.queryId??null,A.config?JSON.stringify(A.config):null,N,N]);let t=(await r.query("SELECT * FROM analytics_widget WHERE id = ?",[m])).rows;return Lr(t[0])}async function k(A,m){let N=new Date().toISOString(),t=["updatedAt = ?"],P=[N];if(m.name!==void 0)t.push("name = ?"),P.push(m.name);if(m.gridX!==void 0)t.push("gridX = ?"),P.push(m.gridX);if(m.gridY!==void 0)t.push("gridY = ?"),P.push(m.gridY);if(m.gridWidth!==void 0)t.push("gridWidth = ?"),P.push(m.gridWidth);if(m.gridHeight!==void 0)t.push("gridHeight = ?"),P.push(m.gridHeight);if(m.queryId!==void 0)t.push("queryId = ?"),P.push(m.queryId??null);if(m.config!==void 0)t.push("config = ?"),P.push(m.config?JSON.stringify(m.config):null);P.push(A),await r.execute(`UPDATE analytics_widget SET ${t.join(", ")} WHERE id = ?`,P);let W=(await r.query("SELECT * FROM analytics_widget WHERE id = ?",[A])).rows;return Lr(W[0])}async function G(A){await r.execute("DELETE FROM analytics_widget WHERE id = ?",[A])}async function L(A){let{projectId:m,type:N,isShared:t,search:P,limit:W=20,offset:H=0}=A,O="WHERE projectId = ?",J=[m];if(N&&N!=="all")O+=" AND type = ?",J.push(N);if(t!==void 0)O+=" AND isShared = ?",J.push(t?1:0);if(P)O+=" AND (name LIKE ? OR description LIKE ?)",J.push(`%${P}%`,`%${P}%`);let Or=(await r.query(`SELECT COUNT(*) as count FROM analytics_query ${O}`,J)).rows[0]?.count??0;return{queries:(await r.query(`SELECT * FROM analytics_query ${O} ORDER BY updatedAt DESC LIMIT ? OFFSET ?`,[...J,W,H])).rows.map(Nr),total:Or}}async function C(A,m){let N=rr("query"),t=new Date().toISOString();await r.execute(`INSERT INTO analytics_query (id, projectId, organizationId, name, description, type, definition, sql, cacheTtlSeconds, isShared, createdAt, updatedAt)
|
|
7
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,[N,m.projectId,m.organizationId,A.name,A.description??null,A.type,JSON.stringify(A.definition),A.sql??null,A.cacheTtlSeconds??300,A.isShared?1:0,t,t]);let P=(await r.query("SELECT * FROM analytics_query WHERE id = ?",[N])).rows;return Nr(P[0])}async function Y(A){let m=(await r.query("SELECT * FROM analytics_query WHERE id = ?",[A])).rows;return m[0]?Nr(m[0]):null}return{listDashboards:o,createDashboard:n,getDashboard:$,updateDashboard:y,getWidgets:c,addWidget:Q,updateWidget:k,deleteWidget:G,listQueries:L,createQuery:C,getQuery:Y}}import{defineEnum as zr}from"@contractspec/lib.schema";var or=zr("QueryType",["SQL","METRIC","AGGREGATION","CUSTOM"]);import{defineSchemaModel as mr,ScalarTypeEnum as D}from"@contractspec/lib.schema";var $r=mr({name:"QueryModel",fields:{id:{type:D.String_unsecure(),isOptional:!1},name:{type:D.String_unsecure(),isOptional:!1},description:{type:D.String_unsecure(),isOptional:!0},type:{type:or,isOptional:!1},definition:{type:D.JSON(),isOptional:!1},sql:{type:D.String_unsecure(),isOptional:!0},cacheTtlSeconds:{type:D.Int_unsecure(),isOptional:!1},isShared:{type:D.Boolean(),isOptional:!1},createdAt:{type:D.DateTime(),isOptional:!1}}}),Pr=mr({name:"QueryResultModel",fields:{queryId:{type:D.String_unsecure(),isOptional:!1},data:{type:D.JSON(),isOptional:!1},columns:{type:D.JSON(),isOptional:!1},rowCount:{type:D.Int_unsecure(),isOptional:!1},executionTimeMs:{type:D.Int_unsecure(),isOptional:!1},cachedAt:{type:D.DateTime(),isOptional:!0},error:{type:D.String_unsecure(),isOptional:!0}}}),Dr=mr({name:"CreateQueryInput",fields:{name:{type:D.NonEmptyString(),isOptional:!1},description:{type:D.String_unsecure(),isOptional:!0},type:{type:or,isOptional:!1},definition:{type:D.JSON(),isOptional:!1},sql:{type:D.String_unsecure(),isOptional:!0},metricIds:{type:D.String_unsecure(),isArray:!0,isOptional:!0},cacheTtlSeconds:{type:D.Int_unsecure(),isOptional:!0},isShared:{type:D.Boolean(),isOptional:!0}}}),Gr=mr({name:"ExecuteQueryInput",fields:{queryId:{type:D.String_unsecure(),isOptional:!1},parameters:{type:D.JSON(),isOptional:!0},dateRange:{type:D.JSON(),isOptional:!0},filters:{type:D.JSON(),isOptional:!0},forceRefresh:{type:D.Boolean(),isOptional:!0}}});import{defineCommand as er,defineQuery as jr}from"@contractspec/lib.contracts-spec/operations";var Hr=["@example.analytics-dashboard"],pr=er({meta:{key:"analytics.query.create",version:"1.0.0",stability:"stable",owners:[...Hr],tags:["analytics","query","create"],description:"Create a data query.",goal:"Define reusable data queries.",context:"Query builder."},io:{input:Dr,output:$r},policy:{auth:"user"},sideEffects:{emits:[{key:"analytics.query.created",version:"1.0.0",stability:"stable",owners:[...Hr],tags:["analytics","query","created"],when:"Query created",payload:$r}],audit:["analytics.query.created"]},acceptance:{scenarios:[{key:"create-query-happy-path",given:["User is authenticated"],when:["User submits valid query definition"],then:["Query is created","QueryCreated event is emitted"]}],examples:[{key:"create-sql-query",input:{name:"Monthly Revenue",sql:"SELECT SUM(amount) FROM orders WHERE date >= :startDate"},output:{id:"query-123",name:"Monthly Revenue",type:"sql"}}]}}),wr=jr({meta:{key:"analytics.query.execute",version:"1.0.0",stability:"stable",owners:[...Hr],tags:["analytics","query","execute"],description:"Execute a data query.",goal:"Fetch data for visualizations.",context:"Dashboard rendering."},io:{input:Gr,output:Pr},policy:{auth:"user"},acceptance:{scenarios:[{key:"execute-query-happy-path",given:["Query exists"],when:["User executes query with parameters"],then:["Query results are returned"]}],examples:[{key:"execute-with-params",input:{queryId:"query-123",params:{startDate:"2025-01-01"}},output:{columns:["total"],rows:[{total:50000}],rowCount:1}}]}});class Zr{cache=new Map;async get(r){let o=this.cache.get(r);if(!o)return null;if(o.expiresAt<new Date)return this.cache.delete(r),null;return{...o.result,cached:!0,cachedAt:o.expiresAt}}async set(r,o,n){let $=new Date(Date.now()+n*1000);this.cache.set(r,{result:o,expiresAt:$})}async invalidate(r){let o=new RegExp(r);for(let n of this.cache.keys())if(o.test(n))this.cache.delete(n)}}class qr{cache;constructor(r){this.cache=r??new Zr}async execute(r,o){let n=Date.now(),$=this.validateQuery(r);if(!$.valid)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:$.errors.join(", ")};let y=this.buildCacheKey(r,o),c=await this.cache.get(y);if(c)return c;let Q;switch(r.type){case"AGGREGATION":if(!r.aggregation)throw Error("Aggregation definition is missing");Q=await this.executeAggregation(r.aggregation,o);break;case"METRIC":if(!r.metricIds)throw Error("Metric IDs are missing");Q=await this.executeMetric(r.metricIds,o);break;case"SQL":if(!r.sql)throw Error("SQL query is missing");Q=await this.executeSql(r.sql,o);break;default:Q={data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:`Unknown query type: ${r.type}`}}return Q.executionTimeMs=Date.now()-n,Q.cached=!1,await this.cache.set(y,Q,300),Q}validateQuery(r){let o=[];if(!r.type)o.push("Query type is required");switch(r.type){case"SQL":if(!r.sql)o.push("SQL query is required for SQL type");break;case"METRIC":if(!r.metricIds||r.metricIds.length===0)o.push("Metric IDs are required for METRIC type");break;case"AGGREGATION":if(!r.aggregation)o.push("Aggregation definition is required for AGGREGATION type");else{if(!r.aggregation.source)o.push("Aggregation source is required");if(!r.aggregation.measures||r.aggregation.measures.length===0)o.push("At least one measure is required")}break}return{valid:o.length===0,errors:o}}buildCacheKey(r,o){return JSON.stringify({definition:r,params:o})}async executeAggregation(r,o){let n=[...r.dimensions.map((y)=>({name:y.name,type:y.type==="NUMBER"?"NUMBER":y.type==="TIME"?"DATE":"STRING",label:y.name})),...r.measures.map((y)=>({name:y.name,type:"NUMBER",label:y.name,format:y.format}))],$=this.generateMockData(r,o);return{data:$,columns:n,rowCount:$.length,executionTimeMs:0,cached:!1}}async executeMetric(r,o){let n=r.map(($)=>({metricId:$,value:Math.random()*1000,change:(Math.random()-0.5)*20}));return{data:n,columns:[{name:"metricId",type:"STRING"},{name:"value",type:"NUMBER"},{name:"change",type:"NUMBER"}],rowCount:n.length,executionTimeMs:0,cached:!1}}async executeSql(r,o){return{data:[],columns:[],rowCount:0,executionTimeMs:0,cached:!1,error:"SQL execution not implemented in demo"}}generateMockData(r,o){let n=[],$=10,y=r.dimensions.find((c)=>c.type==="TIME");for(let c=0;c<10;c++){let Q={};for(let k of r.dimensions)if(k.type==="TIME"){let G=new Date(o.dateRange?.start??new Date);G.setDate(G.getDate()+c),Q[k.name]=G.toISOString().split("T")[0]}else Q[k.name]=`${k.name}_${c%5}`;for(let k of r.measures){let G=y?100+c*10:Math.random()*1000,L=(Math.random()-0.5)*20;Q[k.name]=Math.round((G+L)*100)/100}n.push(Q)}return n}}function Ao(r){return new qr(r)}import{ComparisonView as br,TimelineView as sr,VisualizationCard as ir,VisualizationGrid as dr}from"@contractspec/lib.design-system";import{jsx as p,jsxs as yr}from"react/jsx-runtime";function Xr({dashboardName:r,widgets:o}){if(!o.length)return yr("div",{className:"rounded-lg border border-dashed p-10 text-center text-muted-foreground",children:['No visualization widgets configured for "',r,'".']});return yr("div",{children:[yr("h3",{className:"mb-4 font-semibold text-lg",children:['Widgets in "',r,'"']}),p(dr,{children:o.map((n)=>p("div",{className:rn(n.gridWidth),children:ar(n)},n.id))})]})}function ar(r){let o=yr("span",{className:"text-muted-foreground text-xs",children:["Position: (",r.gridX,", ",r.gridY,") • ",r.gridWidth,"x",r.gridHeight]});if(r.layout==="comparison")return p(br,{description:r.description,items:r.bindings.map(($)=>({...$,footer:o})),title:r.name});if(r.layout==="timeline")return p(sr,{description:r.description,items:r.bindings.map(($)=>({...$,footer:o})),title:r.name});let n=r.bindings[0];if(!n)return null;return p(ir,{data:n.data,description:r.description??n.description,footer:o,height:n.height,spec:n.spec,title:r.name})}function rn(r){if(r>=12)return"md:col-span-2 xl:col-span-3";if(r>=8)return"xl:col-span-2";if(r>=6)return"md:col-span-2";return""}import{DataTable as nn}from"@contractspec/lib.design-system";import{useContractTable as on}from"@contractspec/lib.presentation-runtime-react";import{Badge as Jr}from"@contractspec/lib.ui-kit-web/ui/badge";import{HStack as mn,VStack as w}from"@contractspec/lib.ui-kit-web/ui/stack";import{Text as v}from"@contractspec/lib.ui-kit-web/ui/text";import{jsx as q,jsxs as F}from"react/jsx-runtime";var $n={SQL:"default",METRIC:"secondary",AGGREGATION:"secondary",CUSTOM:"outline"};function yn(r){return JSON.stringify(r,null,2)}function Kr({queries:r}){let o=on({data:r,columns:[{id:"query",header:"Query",label:"Query",accessor:(n)=>n.name,cell:({item:n})=>F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:n.name}),F(v,{className:"text-muted-foreground text-xs",children:["Updated ",n.updatedAt.toLocaleDateString()]})]}),size:240,minSize:180,canSort:!0,canPin:!0,canResize:!0},{id:"description",header:"Description",label:"Description",accessor:(n)=>n.description??"",cell:({value:n})=>q(v,{className:"line-clamp-2 text-muted-foreground text-sm",children:String(n||"No description")}),size:300,minSize:220,canSort:!1,canHide:!0,canResize:!0},{id:"type",header:"Type",label:"Type",accessorKey:"type",cell:({value:n})=>q(Jr,{variant:$n[String(n)],children:String(n)}),size:150,canSort:!0,canHide:!0,canResize:!0},{id:"cacheTtlSeconds",header:"Cache TTL",label:"Cache TTL",accessorKey:"cacheTtlSeconds",cell:({value:n})=>`${String(n)}s`,align:"right",size:140,canSort:!0,canResize:!0},{id:"isShared",header:"Shared",label:"Shared",accessorKey:"isShared",cell:({value:n})=>q(Jr,{variant:n?"default":"outline",children:n?"Shared":"Private"}),size:140,canSort:!0,canHide:!0,canResize:!0}],initialState:{pagination:{pageIndex:0,pageSize:3},columnVisibility:{description:!1},columnPinning:{left:["query"],right:[]}},renderExpandedContent:(n)=>F(w,{gap:"sm",className:"py-2",children:[F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:"Description"}),q(v,{className:"text-muted-foreground text-sm",children:n.description??"No description"})]}),n.sql?F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:"SQL"}),q("pre",{className:"overflow-auto rounded-md bg-muted/40 p-3 text-xs",children:n.sql})]}):null,F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:"Definition"}),q("pre",{className:"overflow-auto rounded-md bg-muted/40 p-3 text-xs",children:yn(n.definition)})]})]}),getCanExpand:()=>!0});return q(nn,{controller:o,title:"Saved Queries",description:"Client-mode table using the shared ContractSpec controller and renderer.",toolbar:F(mn,{gap:"sm",className:"flex-wrap",children:[F(v,{className:"text-muted-foreground text-sm",children:[r.length," queries"]}),F(v,{className:"text-muted-foreground text-sm",children:[r.filter((n)=>n.isShared).length," shared"]})]}),emptyState:q("div",{className:"rounded-md border border-dashed p-8 text-center text-muted-foreground text-sm",children:"No queries saved"})})}import{useTemplateRuntime as cn}from"@contractspec/lib.example-shared-ui";import{useCallback as Cr,useEffect as An,useState as x}from"react";function Br(r="local-project"){let{handlers:o}=cn(),n=o.analytics,[$,y]=x([]),[c,Q]=x([]),[k,G]=x(null),[L,C]=x([]),[Y,A]=x(!0),[m,N]=x(null),t=Cr(async()=>{try{A(!0),N(null);let[H,O]=await Promise.all([n.listDashboards({projectId:r,limit:100}),n.listQueries({projectId:r,limit:100})]);if(y(H.dashboards),Q(O.queries),H.dashboards.length>0&&!k){let J=H.dashboards[0];if(J){G(J);let T=await n.getWidgets(J.id);C(T.length>0?T:u(J.id))}}}catch(H){N(H instanceof Error?H:Error("Failed to load analytics"))}finally{A(!1)}},[n,r,k]);An(()=>{t()},[t]);let P=Cr(async(H)=>{G(H);let O=await n.getWidgets(H.id);C(O.length>0?O:u(H.id))},[n]),W={totalDashboards:$.length,publishedDashboards:$.filter((H)=>H.status==="PUBLISHED").length,totalQueries:c.length,sharedQueries:c.filter((H)=>H.isShared).length};return{dashboards:$,queries:c,selectedDashboard:k,widgets:L,loading:Y,error:m,stats:W,refetch:t,selectDashboard:P}}import{Button as Wr,ErrorState as kn,LoaderBlock as tn,StatCard as Mr,StatCardGroup as Qn}from"@contractspec/lib.design-system";import{useMemo as Ln,useState as Nn}from"react";import{jsx as M,jsxs as X}from"react/jsx-runtime";var Pn={PUBLISHED:"bg-green-100 text-green-700 dark:bg-green-900/30 dark:text-green-400",DRAFT:"bg-gray-100 text-gray-700 dark:bg-gray-900/30 dark:text-gray-400",ARCHIVED:"bg-yellow-100 text-yellow-700 dark:bg-yellow-900/30 dark:text-yellow-400"};function Dn(){let[r,o]=Nn("dashboards"),{dashboards:n,queries:$,selectedDashboard:y,widgets:c,loading:Q,error:k,stats:G,refetch:L,selectDashboard:C}=Br(),Y=[{id:"dashboards",label:"Dashboards",icon:"\uD83D\uDCCA"},{id:"queries",label:"Queries",icon:"\uD83D\uDD0D"}],A=Ln(()=>c.map((m)=>j(m)).filter((m)=>Boolean(m)),[c]);if(Q)return M(tn,{label:"Loading Analytics..."});if(k)return M(kn,{title:"Failed to load Analytics",description:k.message,onRetry:L,retryLabel:"Retry"});return X("div",{className:"space-y-6",children:[X("div",{className:"flex items-center justify-between",children:[M("h2",{className:"font-bold text-2xl",children:"Analytics Dashboard"}),X(Wr,{onClick:()=>alert("Create dashboard modal"),children:[M("span",{className:"mr-2",children:"+"})," New Dashboard"]})]}),X(Qn,{children:[M(Mr,{label:"Dashboards",value:G.totalDashboards,hint:`${G.publishedDashboards} published`}),M(Mr,{label:"Queries",value:G.totalQueries,hint:`${G.sharedQueries} shared`}),M(Mr,{label:"Widgets",value:c.length,hint:"on current dashboard"})]}),M("nav",{className:"flex gap-1 rounded-lg bg-muted p-1",role:"tablist",children:Y.map((m)=>X(Wr,{type:"button",role:"tab","aria-selected":r===m.id,onClick:()=>o(m.id),className:`flex flex-1 items-center justify-center gap-2 rounded-md px-4 py-2 font-medium text-sm transition-colors ${r===m.id?"bg-background text-foreground shadow-sm":"text-muted-foreground hover:text-foreground"}`,children:[M("span",{children:m.icon}),m.label]},m.id))}),X("div",{className:"min-h-[400px]",role:"tabpanel",children:[r==="dashboards"&&X("div",{className:"space-y-6",children:[X("div",{className:"grid gap-4 sm:grid-cols-2 lg:grid-cols-3",children:[n.map((m)=>X("div",{onClick:()=>C(m),className:`cursor-pointer rounded-lg border border-border bg-card p-4 transition-all ${y?.id===m.id?"ring-2 ring-primary":"hover:bg-muted/50"}`,role:"button",tabIndex:0,onKeyDown:(N)=>{if(N.key==="Enter"||N.key===" ")C(m)},children:[X("div",{className:"mb-2 flex items-center justify-between",children:[M("h3",{className:"font-medium",children:m.name}),M("span",{className:`inline-flex rounded-full px-2 py-0.5 font-medium text-xs ${Pn[m.status]??""}`,children:m.status})]}),M("p",{className:"mb-3 text-muted-foreground text-sm",children:m.description}),X("div",{className:"flex items-center justify-between text-muted-foreground text-xs",children:[X("span",{children:["/",m.slug]}),m.isPublic&&M("span",{className:"text-green-600 dark:text-green-400",children:"\uD83C\uDF10 Public"})]})]},m.id)),n.length===0&&M("div",{className:"col-span-full flex h-64 items-center justify-center text-muted-foreground",children:"No dashboards created yet"})]}),y?M(Xr,{dashboardName:y.name,widgets:A}):null]}),r==="queries"&&M(Kr,{queries:$})]})]})}var cr=[{id:"dash-1",name:"Sales Overview",slug:"sales-overview",status:"PUBLISHED",widgetCount:11,viewCount:1250,lastViewedAt:"2026-03-18T12:00:00Z"},{id:"dash-2",name:"User Engagement",slug:"user-engagement",status:"PUBLISHED",widgetCount:8,viewCount:890,lastViewedAt:"2026-03-18T10:00:00Z"}],vr=[{id:"q-1",name:"Monthly Revenue",type:"AGGREGATION",isShared:!0,executionCount:1500},{id:"q-2",name:"User Growth",type:"METRIC",isShared:!0,executionCount:890},{id:"q-3",name:"Product Sales",type:"SQL",isShared:!1,executionCount:340},{id:"q-4",name:"Conversion Funnel",type:"AGGREGATION",isShared:!0,executionCount:450}];function Gn(r){return u(r).map((o)=>j(o)).filter((o)=>Boolean(o))}var Hn={target:"markdown",render:async(r)=>{if(r.source.type!=="component"||r.source.componentKey!=="AnalyticsDashboard")throw Error("analyticsDashboardMarkdownRenderer: not AnalyticsDashboard");let o=cr[0];if(!o)return{mimeType:"text/markdown",body:`# No Dashboards
|
|
8
8
|
|
|
9
|
-
No dashboards available.`};let n=
|
|
10
|
-
`)}}},
|
|
11
|
-
`)}}},
|
|
12
|
-
`)}}};export{B as visualizationRefKey,Br as useAnalyticsData,j as resolveAnalyticsWidget,Z as refOf,
|
|
9
|
+
No dashboards available.`};let n=Gn(o.id),$=n.filter((c)=>c.bindings[0]?.spec.visualization.kind==="metric"),y=[`# ${o.name}`,"","> Contract-backed analytics dashboard overview.","","## Key Metrics",""];for(let c of $){let Q=c.bindings[0];if(!Q)continue;y.push(`- **${c.name}** via \`${Q.spec.meta.key}\``)}y.push(""),y.push("## Visual Blocks"),y.push("");for(let c of n){let Q=c.bindings.map((k)=>k.spec.visualization.kind).join(", ");y.push(`- **${c.name}** (${c.layout}) → ${Q}`)}return y.push(""),y.push("## Dashboard Stats"),y.push(""),y.push("| Metric | Value |"),y.push("|--------|-------|"),y.push(`| Total Dashboards | ${cr.length} |`),y.push(`| Published | ${cr.filter((c)=>c.status==="PUBLISHED").length} |`),y.push(`| Shared Queries | ${vr.filter((c)=>c.isShared).length} |`),{mimeType:"text/markdown",body:y.join(`
|
|
10
|
+
`)}}},Bn={target:"markdown",render:async(r)=>{if(r.source.type!=="component"||r.source.componentKey!=="DashboardList")throw Error("dashboardListMarkdownRenderer: not DashboardList");let o=["# Dashboards","","> Browse and manage analytics dashboards","","| Dashboard | Widgets | Views | Status | Last Viewed |","|-----------|---------|-------|--------|-------------|"];for(let n of cr){let $=n.lastViewedAt?new Date(n.lastViewedAt).toLocaleDateString():"Never",y=n.status==="PUBLISHED"?"\uD83D\uDFE2":"⚫";o.push(`| [${n.name}](/dashboards/${n.slug}) | ${n.widgetCount} | ${n.viewCount.toLocaleString()} | ${y} ${n.status} | ${$} |`)}return{mimeType:"text/markdown",body:o.join(`
|
|
11
|
+
`)}}},Mn={target:"markdown",render:async(r)=>{if(r.source.type!=="component"||r.source.componentKey!=="QueryBuilder")throw Error("queryBuilderMarkdownRenderer: not QueryBuilder");let o=["# Query Builder","","> Create and manage reusable data queries.","","| Query | Type | Shared | Executions |","|-------|------|--------|------------|"];for(let n of vr)o.push(`| ${n.name} | ${n.type} | ${n.isShared?"\uD83C\uDF10":"\uD83D\uDD12"} | ${n.executionCount.toLocaleString()} |`);return o.push(""),o.push("## Visualization Contracts"),o.push(""),o.push("Widgets reference `VisualizationSpec` contracts instead of rendering ad-hoc widget types."),{mimeType:"text/markdown",body:o.join(`
|
|
12
|
+
`)}}};export{B as visualizationRefKey,Br as useAnalyticsData,j as resolveAnalyticsWidget,Z as refOf,Mn as queryBuilderMarkdownRenderer,Bn as dashboardListMarkdownRenderer,Ao as createQueryEngine,Sr as createPosthogQueryEngine,u as createExampleWidgets,jn as createAnalyticsHandlers,Hn as analyticsDashboardMarkdownRenderer,f as RevenueTrendVisualization,I as RevenueMetricVisualization,S as RetentionAreaVisualization,h as RegionalRevenueVisualization,or as QueryTypeEnum,Pr as QueryResultModel,$r as QueryModel,Qr as PosthogQueryEngine,V as PipelineScatterVisualization,Zr as InMemoryQueryCache,Gr as ExecuteQueryInputModel,wr as ExecuteQueryContract,Tr as ExamplesAnalyticsDashboardExample,g as EngagementHeatmapVisualization,Dr as CreateQueryInputModel,pr as CreateQueryContract,_ as ConversionFunnelVisualization,R as ChannelMixVisualization,qr as BasicQueryEngine,d as AnalyticsVisualizationSpecs,kr as AnalyticsVisualizationSpecMap,a as AnalyticsVisualizationSampleData,Yr as AnalyticsVisualizationRegistry,Ar as AnalyticsVisualizationRefs,Vn as AnalyticsDashboardFeature,Dn as AnalyticsDashboard,E as AccountCoverageGeoVisualization};
|
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
// @bun
|
|
2
|
-
import{defineVisualization as O}from"@contractspec/lib.contracts-spec/visualizations";var _={key:"analytics.query.execute",version:"1.0.0"},C={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},m=O({meta:{...C,key:"analytics.visualization.channel-mix",title:"Channel Mix",description:"Session distribution across acquisition channels.",goal:"Explain which channels currently drive the largest share of traffic.",context:"Marketing attribution dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"pie",nameDimension:"channel",valueMeasure:"sessions",dimensions:[{key:"channel",label:"Channel",dataPath:"channel",type:"category"}],measures:[{key:"sessions",label:"Sessions",dataPath:"sessions"}],table:{caption:"Sessions by acquisition channel."}}}),G=O({meta:{...C,key:"analytics.visualization.engagement-heatmap",title:"Engagement Heatmap",description:"Average engagement score by weekday and time band.",goal:"Reveal the highest-engagement time windows for product activity.",context:"Usage analytics dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"heatmap",xDimension:"timeBand",yDimension:"weekday",valueMeasure:"engagementScore",dimensions:[{key:"timeBand",label:"Time Band",dataPath:"timeBand",type:"category"},{key:"weekday",label:"Weekday",dataPath:"weekday",type:"category"}],measures:[{key:"engagementScore",label:"Engagement",dataPath:"engagementScore"}],table:{caption:"Engagement score by weekday and time band."}}}),D=O({meta:{...C,key:"analytics.visualization.conversion-funnel",title:"Conversion Funnel",description:"Progression through the main acquisition funnel.",goal:"Show where the product is losing the largest share of prospects.",context:"Growth dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"funnel",nameDimension:"stage",valueMeasure:"users",sort:"descending",dimensions:[{key:"stage",label:"Stage",dataPath:"stage",type:"category"}],measures:[{key:"users",label:"Users",dataPath:"users"}],table:{caption:"Users per conversion stage."}}}),L=O({meta:{...C,key:"analytics.visualization.account-coverage-geo",title:"Account Coverage",description:"High-value accounts plotted on a slippy-map surface.",goal:"Locate where active commercial concentration is strongest.",context:"Territory coverage dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"geo",mode:"slippy-map",variant:"scatter",nameDimension:"city",latitudeDimension:"latitude",longitudeDimension:"longitude",valueMeasure:"accounts",dimensions:[{key:"city",label:"City",dataPath:"city",type:"category"},{key:"latitude",label:"Latitude",dataPath:"latitude",type:"latitude"},{key:"longitude",label:"Longitude",dataPath:"longitude",type:"longitude"}],measures:[{key:"accounts",label:"Accounts",dataPath:"accounts"}],table:{caption:"Account concentration by city."}}});import{defineVisualization as S}from"@contractspec/lib.contracts-spec/visualizations";var K={key:"analytics.query.execute",version:"1.0.0"},Q={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},X=S({meta:{...Q,key:"analytics.visualization.revenue-metric",title:"Revenue Snapshot",description:"Current recurring revenue with prior-period comparison.",goal:"Highlight the headline commercial metric for the dashboard.",context:"Executive revenue overview."},source:{primary:K,resultPath:"data"},visualization:{kind:"metric",measure:"totalRevenue",comparisonMeasure:"priorRevenue",dimensions:[{key:"period",label:"Period",dataPath:"period",type:"time"}],measures:[{key:"totalRevenue",label:"Revenue",dataPath:"totalRevenue",format:"currency"},{key:"priorRevenue",label:"Prior Revenue",dataPath:"priorRevenue",format:"currency"}],sparkline:{dimension:"period",measure:"totalRevenue"},table:{caption:"Revenue trend and prior period values."}}}),N=S({meta:{...Q,key:"analytics.visualization.revenue-trend",title:"Revenue Trend",description:"Monthly revenue progression for the current quarter.",goal:"Track whether revenue growth is accelerating or stalling.",context:"Quarterly commercial dashboard."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"line",xDimension:"date",yMeasures:["revenue"],dimensions:[{key:"date",label:"Month",dataPath:"date",type:"time"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#0f766e"}],thresholds:[{key:"target",value:140000,label:"Target",color:"#dc2626"}],table:{caption:"Monthly revenue values."}}}),W=S({meta:{...Q,key:"analytics.visualization.regional-revenue",title:"Regional Revenue",description:"Revenue split by sales territory.",goal:"Compare the strongest and weakest performing territories.",context:"Territory planning and commercial comparison."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"bar",xDimension:"region",yMeasures:["revenue"],dimensions:[{key:"region",label:"Region",dataPath:"region",type:"category"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#1d4ed8"}],table:{caption:"Revenue by region."}}}),Z=S({meta:{...Q,key:"analytics.visualization.retention-area",title:"Retention Curve",description:"Weekly retention progression across the active cohort.",goal:"Show whether user retention remains above the desired floor.",context:"Product health dashboard."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"area",xDimension:"week",yMeasures:["retentionRate"],dimensions:[{key:"week",label:"Week",dataPath:"week",type:"category"}],measures:[{key:"retentionRate",label:"Retention",dataPath:"retentionRate",format:"percentage",color:"#16a34a"}],thresholds:[{key:"floor",value:0.5,label:"Floor",color:"#f59e0b"}],table:{caption:"Weekly retention rate."}}}),H=S({meta:{...Q,key:"analytics.visualization.pipeline-scatter",title:"Pipeline Velocity",description:"Deal-cycle length against win rate for active accounts.",goal:"Spot outliers where the sales cycle is long but conversion remains weak.",context:"Commercial operations dashboard."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"scatter",xDimension:"cycleDays",yMeasures:["winRate"],dimensions:[{key:"cycleDays",label:"Cycle Days",dataPath:"cycleDays",type:"number"}],measures:[{key:"winRate",label:"Win Rate",dataPath:"winRate",format:"percentage",color:"#7c3aed"},{key:"arr",label:"ARR",dataPath:"arr",format:"currency"}],series:[{key:"pipeline",label:"Accounts",measure:"winRate",type:"scatter",color:"#7c3aed"}],table:{caption:"Sales cycle and win rate per account."}}});import{VisualizationRegistry as p}from"@contractspec/lib.contracts-spec/visualizations";var Y=[X,N,W,Z,H,m,G,D,L],v=new p([...Y]),T=Y.map((x)=>J(x)),A=new Map(Y.map((x)=>[q(x.meta),x])),y={[q(X.meta)]:{data:[{period:"2025-11-01",totalRevenue:112000,priorRevenue:103000},{period:"2025-12-01",totalRevenue:119000,priorRevenue:110000},{period:"2026-01-01",totalRevenue:126500,priorRevenue:116000},{period:"2026-02-01",totalRevenue:133000,priorRevenue:124000},{period:"2026-03-01",totalRevenue:145500,priorRevenue:133000}]},[q(N.meta)]:{data:[{date:"2025-11-01",revenue:112000},{date:"2025-12-01",revenue:119000},{date:"2026-01-01",revenue:126500},{date:"2026-02-01",revenue:133000},{date:"2026-03-01",revenue:145500}]},[q(W.meta)]:{data:[{region:"North America",revenue:210000},{region:"EMEA",revenue:174000},{region:"APAC",revenue:132000},{region:"LATAM",revenue:88000}]},[q(Z.meta)]:{data:[{week:"Week 1",retentionRate:0.71},{week:"Week 2",retentionRate:0.66},{week:"Week 3",retentionRate:0.62},{week:"Week 4",retentionRate:0.58},{week:"Week 5",retentionRate:0.55},{week:"Week 6",retentionRate:0.53}]},[q(H.meta)]:{data:[{cycleDays:18,winRate:0.31,arr:82000},{cycleDays:26,winRate:0.44,arr:65000},{cycleDays:33,winRate:0.27,arr:91000},{cycleDays:14,winRate:0.56,arr:47000},{cycleDays:21,winRate:0.48,arr:59000},{cycleDays:39,winRate:0.22,arr:114000}]},[q(m.meta)]:{data:[{channel:"Direct",sessions:4200},{channel:"Organic Search",sessions:3600},{channel:"Paid Search",sessions:2100},{channel:"Partner",sessions:1400},{channel:"Referral",sessions:900}]},[q(G.meta)]:{data:[{weekday:"Mon",timeBand:"09:00",engagementScore:74},{weekday:"Mon",timeBand:"13:00",engagementScore:82},{weekday:"Tue",timeBand:"09:00",engagementScore:69},{weekday:"Tue",timeBand:"13:00",engagementScore:88},{weekday:"Wed",timeBand:"09:00",engagementScore:77},{weekday:"Wed",timeBand:"13:00",engagementScore:91},{weekday:"Thu",timeBand:"09:00",engagementScore:72},{weekday:"Thu",timeBand:"13:00",engagementScore:86},{weekday:"Fri",timeBand:"09:00",engagementScore:65},{weekday:"Fri",timeBand:"13:00",engagementScore:79}]},[q(D.meta)]:{data:[{stage:"Visited Site",users:12000},{stage:"Started Trial",users:4200},{stage:"Activated Workspace",users:2400},{stage:"Requested Demo",users:980},{stage:"Closed Won",users:310}]},[q(L.meta)]:{data:[{city:"Paris",latitude:48.8566,longitude:2.3522,accounts:48},{city:"London",latitude:51.5072,longitude:-0.1276,accounts:62},{city:"New York",latitude:40.7128,longitude:-74.006,accounts:71},{city:"Toronto",latitude:43.6532,longitude:-79.3832,accounts:36},{city:"Singapore",latitude:1.3521,longitude:103.8198,accounts:29}]}};function J(x){return{key:x.meta.key,version:x.meta.version}}function q(x){return`${x.key}.v${x.version}`}var h={METRIC:J(X),LINE_CHART:J(N),BAR_CHART:J(W),AREA_CHART:J(Z),SCATTER_PLOT:J(H),PIE_CHART:J(m),HEATMAP:J(G),FUNNEL:J(D),MAP:J(L)};function V(x){return[$(x,"widget_revenue_metric","Revenue Snapshot","METRIC",0,0,4,2,{layout:"single",bindings:[B(X,200)]}),$(x,"widget_revenue_trend","Revenue Trend","LINE_CHART",4,0,8,4,{layout:"single",bindings:[B(N)]}),$(x,"widget_regional_revenue","Regional Revenue","BAR_CHART",0,2,6,4,{layout:"single",bindings:[B(W)]}),$(x,"widget_channel_mix","Channel Mix","PIE_CHART",6,2,6,4,{layout:"single",bindings:[B(m)]}),$(x,"widget_retention","Retention Curve","AREA_CHART",0,6,6,4,{layout:"single",bindings:[B(Z)]}),$(x,"widget_pipeline","Pipeline Velocity","SCATTER_PLOT",6,6,6,4,{layout:"single",bindings:[B(H)]}),$(x,"widget_heatmap","Engagement Heatmap","HEATMAP",0,10,8,4,{layout:"single",bindings:[B(G)]}),$(x,"widget_funnel","Conversion Funnel","FUNNEL",8,10,4,4,{layout:"single",bindings:[B(D)]}),$(x,"widget_geo","Account Coverage","MAP",0,14,12,5,{layout:"single",bindings:[B(L,360)]}),$(x,"widget_comparison","Commercial Comparison","EMBED",0,19,12,6,{layout:"comparison",description:"Compare regional distribution, channel balance, and funnel shape.",bindings:[B(W,240),B(m,240),B(D,240)]}),$(x,"widget_timeline","Growth Timeline","EMBED",0,25,12,6,{layout:"timeline",description:"Track revenue and retention over the same reporting cadence.",bindings:[B(N,220),B(Z,220)]})]}function R(x){let j=f(x),U=j.bindings.map((k)=>{let P=A.get(q(k.ref));if(!P)return null;return{key:`${x.id}:${q(k.ref)}`,spec:P,data:k.data,title:k.title??P.meta.title,description:k.description??P.meta.description,height:k.height}}).filter((k)=>Boolean(k));if(!U.length)return null;return{id:x.id,name:x.name,description:j.description,layout:j.layout,gridX:x.gridX,gridY:x.gridY,gridWidth:x.gridWidth,gridHeight:x.gridHeight,bindings:U}}function f(x){if(z(x.config))return x.config;let j=h[x.type];return j?{layout:"single",bindings:[{ref:j,data:y[q(j)]}]}:{layout:"single",bindings:[]}}function B(x,j=280){return{ref:J(x),data:y[q(x.meta)],height:j}}function $(x,j,U,k,P,M,w,I,E){let F=new Date;return{id:j,dashboardId:x,name:U,type:k,gridX:P,gridY:M,gridWidth:w,gridHeight:I,config:E,createdAt:F,updatedAt:F}}function z(x){if(!x||typeof x!=="object")return!1;let j=x;return(j.layout==="single"||j.layout==="comparison"||j.layout==="timeline")&&Array.isArray(j.bindings)}import{defineFeature as b}from"@contractspec/lib.contracts-spec";var kx=b({meta:{key:"analytics-dashboard",version:"1.0.0",title:"Analytics Dashboard",description:"Analytics dashboards with customizable widgets and queries",domain:"analytics",owners:["@analytics-dashboard"],tags:["analytics","dashboards","widgets","queries"],stability:"experimental"},operations:[{key:"analytics.dashboard.create",version:"1.0.0"},{key:"analytics.dashboard.list",version:"1.0.0"},{key:"analytics.dashboard.get",version:"1.0.0"},{key:"analytics.widget.add",version:"1.0.0"},{key:"analytics.query.create",version:"1.0.0"},{key:"analytics.query.execute",version:"1.0.0"}],events:[{key:"analytics.dashboard.created",version:"1.0.0"},{key:"analytics.widget.added",version:"1.0.0"},{key:"analytics.query.created",version:"1.0.0"}],presentations:[{key:"analytics.dashboard.viewList",version:"1.0.0"},{key:"analytics.dashboard.view",version:"1.0.0"},{key:"analytics.dashboard.editor",version:"1.0.0"},{key:"analytics.query.list",version:"1.0.0"},{key:"analytics.query.builder",version:"1.0.0"}],visualizations:[...T],opToPresentation:[{op:{key:"analytics.dashboard.list",version:"1.0.0"},pres:{key:"analytics.dashboard.viewList",version:"1.0.0"}},{op:{key:"analytics.dashboard.get",version:"1.0.0"},pres:{key:"analytics.dashboard.view",version:"1.0.0"}},{op:{key:"analytics.dashboard.create",version:"1.0.0"},pres:{key:"analytics.dashboard.editor",version:"1.0.0"}},{op:{key:"analytics.query.create",version:"1.0.0"},pres:{key:"analytics.query.builder",version:"1.0.0"}}],presentationsTargets:[{key:"analytics.dashboard.viewList",version:"1.0.0",targets:["react","markdown","application/json"]},{key:"analytics.dashboard.view",version:"1.0.0",targets:["react","markdown"]},{key:"analytics.dashboard.editor",version:"1.0.0",targets:["react"]},{key:"analytics.query.builder",version:"1.0.0",targets:["react"]}],capabilities:{requires:[{key:"identity",version:"1.0.0"},{key:"metering",version:"1.0.0"},{key:"audit-trail",version:"1.0.0"}]},telemetry:[{key:"analytics-dashboard.telemetry",version:"1.0.0"}],docs:["docs.examples.analytics-dashboard","docs.examples.analytics-dashboard.goal","docs.examples.analytics-dashboard.usage","docs.examples.analytics-dashboard.constraints"]});export{kx as AnalyticsDashboardFeature};
|
|
2
|
+
import{defineVisualization as O}from"@contractspec/lib.contracts-spec/visualizations";var _={key:"analytics.query.execute",version:"1.0.0"},C={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},m=O({meta:{...C,key:"analytics.visualization.channel-mix",title:"Channel Mix",description:"Session distribution across acquisition channels.",goal:"Explain which channels currently drive the largest share of traffic.",context:"Marketing attribution dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"pie",nameDimension:"channel",valueMeasure:"sessions",dimensions:[{key:"channel",label:"Channel",dataPath:"channel",type:"category"}],measures:[{key:"sessions",label:"Sessions",dataPath:"sessions"}],table:{caption:"Sessions by acquisition channel."}}}),G=O({meta:{...C,key:"analytics.visualization.engagement-heatmap",title:"Engagement Heatmap",description:"Average engagement score by weekday and time band.",goal:"Reveal the highest-engagement time windows for product activity.",context:"Usage analytics dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"heatmap",xDimension:"timeBand",yDimension:"weekday",valueMeasure:"engagementScore",dimensions:[{key:"timeBand",label:"Time Band",dataPath:"timeBand",type:"category"},{key:"weekday",label:"Weekday",dataPath:"weekday",type:"category"}],measures:[{key:"engagementScore",label:"Engagement",dataPath:"engagementScore"}],table:{caption:"Engagement score by weekday and time band."}}}),D=O({meta:{...C,key:"analytics.visualization.conversion-funnel",title:"Conversion Funnel",description:"Progression through the main acquisition funnel.",goal:"Show where the product is losing the largest share of prospects.",context:"Growth dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"funnel",nameDimension:"stage",valueMeasure:"users",sort:"descending",dimensions:[{key:"stage",label:"Stage",dataPath:"stage",type:"category"}],measures:[{key:"users",label:"Users",dataPath:"users"}],table:{caption:"Users per conversion stage."}}}),L=O({meta:{...C,key:"analytics.visualization.account-coverage-geo",title:"Account Coverage",description:"High-value accounts plotted on a slippy-map surface.",goal:"Locate where active commercial concentration is strongest.",context:"Territory coverage dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"geo",mode:"slippy-map",variant:"scatter",nameDimension:"city",latitudeDimension:"latitude",longitudeDimension:"longitude",valueMeasure:"accounts",dimensions:[{key:"city",label:"City",dataPath:"city",type:"category"},{key:"latitude",label:"Latitude",dataPath:"latitude",type:"latitude"},{key:"longitude",label:"Longitude",dataPath:"longitude",type:"longitude"}],measures:[{key:"accounts",label:"Accounts",dataPath:"accounts"}],table:{caption:"Account concentration by city."}}});import{defineVisualization as S}from"@contractspec/lib.contracts-spec/visualizations";var K={key:"analytics.query.execute",version:"1.0.0"},Q={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},X=S({meta:{...Q,key:"analytics.visualization.revenue-metric",title:"Revenue Snapshot",description:"Current recurring revenue with prior-period comparison.",goal:"Highlight the headline commercial metric for the dashboard.",context:"Executive revenue overview."},source:{primary:K,resultPath:"data"},visualization:{kind:"metric",measure:"totalRevenue",comparisonMeasure:"priorRevenue",dimensions:[{key:"period",label:"Period",dataPath:"period",type:"time"}],measures:[{key:"totalRevenue",label:"Revenue",dataPath:"totalRevenue",format:"currency"},{key:"priorRevenue",label:"Prior Revenue",dataPath:"priorRevenue",format:"currency"}],sparkline:{dimension:"period",measure:"totalRevenue"},table:{caption:"Revenue trend and prior period values."}}}),N=S({meta:{...Q,key:"analytics.visualization.revenue-trend",title:"Revenue Trend",description:"Monthly revenue progression for the current quarter.",goal:"Track whether revenue growth is accelerating or stalling.",context:"Quarterly commercial dashboard."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"line",xDimension:"date",yMeasures:["revenue"],dimensions:[{key:"date",label:"Month",dataPath:"date",type:"time"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#0f766e"}],thresholds:[{key:"target",value:140000,label:"Target",color:"#dc2626"}],table:{caption:"Monthly revenue values."}}}),W=S({meta:{...Q,key:"analytics.visualization.regional-revenue",title:"Regional Revenue",description:"Revenue split by sales territory.",goal:"Compare the strongest and weakest performing territories.",context:"Territory planning and commercial comparison."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"bar",xDimension:"region",yMeasures:["revenue"],dimensions:[{key:"region",label:"Region",dataPath:"region",type:"category"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#1d4ed8"}],table:{caption:"Revenue by region."}}}),Z=S({meta:{...Q,key:"analytics.visualization.retention-area",title:"Retention Curve",description:"Weekly retention progression across the active cohort.",goal:"Show whether user retention remains above the desired floor.",context:"Product health dashboard."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"area",xDimension:"week",yMeasures:["retentionRate"],dimensions:[{key:"week",label:"Week",dataPath:"week",type:"category"}],measures:[{key:"retentionRate",label:"Retention",dataPath:"retentionRate",format:"percentage",color:"#16a34a"}],thresholds:[{key:"floor",value:0.5,label:"Floor",color:"#f59e0b"}],table:{caption:"Weekly retention rate."}}}),H=S({meta:{...Q,key:"analytics.visualization.pipeline-scatter",title:"Pipeline Velocity",description:"Deal-cycle length against win rate for active accounts.",goal:"Spot outliers where the sales cycle is long but conversion remains weak.",context:"Commercial operations dashboard."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"scatter",xDimension:"cycleDays",yMeasures:["winRate"],dimensions:[{key:"cycleDays",label:"Cycle Days",dataPath:"cycleDays",type:"number"}],measures:[{key:"winRate",label:"Win Rate",dataPath:"winRate",format:"percentage",color:"#7c3aed"},{key:"arr",label:"ARR",dataPath:"arr",format:"currency"}],series:[{key:"pipeline",label:"Accounts",measure:"winRate",type:"scatter",color:"#7c3aed"}],table:{caption:"Sales cycle and win rate per account."}}});import{VisualizationRegistry as p}from"@contractspec/lib.contracts-spec/visualizations";var Y=[X,N,W,Z,H,m,G,D,L],v=new p([...Y]),T=Y.map((x)=>J(x)),A=new Map(Y.map((x)=>[q(x.meta),x])),y={[q(X.meta)]:{data:[{period:"2025-11-01",totalRevenue:112000,priorRevenue:103000},{period:"2025-12-01",totalRevenue:119000,priorRevenue:110000},{period:"2026-01-01",totalRevenue:126500,priorRevenue:116000},{period:"2026-02-01",totalRevenue:133000,priorRevenue:124000},{period:"2026-03-01",totalRevenue:145500,priorRevenue:133000}]},[q(N.meta)]:{data:[{date:"2025-11-01",revenue:112000},{date:"2025-12-01",revenue:119000},{date:"2026-01-01",revenue:126500},{date:"2026-02-01",revenue:133000},{date:"2026-03-01",revenue:145500}]},[q(W.meta)]:{data:[{region:"North America",revenue:210000},{region:"EMEA",revenue:174000},{region:"APAC",revenue:132000},{region:"LATAM",revenue:88000}]},[q(Z.meta)]:{data:[{week:"Week 1",retentionRate:0.71},{week:"Week 2",retentionRate:0.66},{week:"Week 3",retentionRate:0.62},{week:"Week 4",retentionRate:0.58},{week:"Week 5",retentionRate:0.55},{week:"Week 6",retentionRate:0.53}]},[q(H.meta)]:{data:[{cycleDays:18,winRate:0.31,arr:82000},{cycleDays:26,winRate:0.44,arr:65000},{cycleDays:33,winRate:0.27,arr:91000},{cycleDays:14,winRate:0.56,arr:47000},{cycleDays:21,winRate:0.48,arr:59000},{cycleDays:39,winRate:0.22,arr:114000}]},[q(m.meta)]:{data:[{channel:"Direct",sessions:4200},{channel:"Organic Search",sessions:3600},{channel:"Paid Search",sessions:2100},{channel:"Partner",sessions:1400},{channel:"Referral",sessions:900}]},[q(G.meta)]:{data:[{weekday:"Mon",timeBand:"09:00",engagementScore:74},{weekday:"Mon",timeBand:"13:00",engagementScore:82},{weekday:"Tue",timeBand:"09:00",engagementScore:69},{weekday:"Tue",timeBand:"13:00",engagementScore:88},{weekday:"Wed",timeBand:"09:00",engagementScore:77},{weekday:"Wed",timeBand:"13:00",engagementScore:91},{weekday:"Thu",timeBand:"09:00",engagementScore:72},{weekday:"Thu",timeBand:"13:00",engagementScore:86},{weekday:"Fri",timeBand:"09:00",engagementScore:65},{weekday:"Fri",timeBand:"13:00",engagementScore:79}]},[q(D.meta)]:{data:[{stage:"Visited Site",users:12000},{stage:"Started Trial",users:4200},{stage:"Activated Workspace",users:2400},{stage:"Requested Demo",users:980},{stage:"Closed Won",users:310}]},[q(L.meta)]:{data:[{city:"Paris",latitude:48.8566,longitude:2.3522,accounts:48},{city:"London",latitude:51.5072,longitude:-0.1276,accounts:62},{city:"New York",latitude:40.7128,longitude:-74.006,accounts:71},{city:"Toronto",latitude:43.6532,longitude:-79.3832,accounts:36},{city:"Singapore",latitude:1.3521,longitude:103.8198,accounts:29}]}};function J(x){return{key:x.meta.key,version:x.meta.version}}function q(x){return`${x.key}.v${x.version}`}var h={METRIC:J(X),LINE_CHART:J(N),BAR_CHART:J(W),AREA_CHART:J(Z),SCATTER_PLOT:J(H),PIE_CHART:J(m),HEATMAP:J(G),FUNNEL:J(D),MAP:J(L)};function V(x){return[$(x,"widget_revenue_metric","Revenue Snapshot","METRIC",0,0,4,2,{layout:"single",bindings:[B(X,200)]}),$(x,"widget_revenue_trend","Revenue Trend","LINE_CHART",4,0,8,4,{layout:"single",bindings:[B(N)]}),$(x,"widget_regional_revenue","Regional Revenue","BAR_CHART",0,2,6,4,{layout:"single",bindings:[B(W)]}),$(x,"widget_channel_mix","Channel Mix","PIE_CHART",6,2,6,4,{layout:"single",bindings:[B(m)]}),$(x,"widget_retention","Retention Curve","AREA_CHART",0,6,6,4,{layout:"single",bindings:[B(Z)]}),$(x,"widget_pipeline","Pipeline Velocity","SCATTER_PLOT",6,6,6,4,{layout:"single",bindings:[B(H)]}),$(x,"widget_heatmap","Engagement Heatmap","HEATMAP",0,10,8,4,{layout:"single",bindings:[B(G)]}),$(x,"widget_funnel","Conversion Funnel","FUNNEL",8,10,4,4,{layout:"single",bindings:[B(D)]}),$(x,"widget_geo","Account Coverage","MAP",0,14,12,5,{layout:"single",bindings:[B(L,360)]}),$(x,"widget_comparison","Commercial Comparison","EMBED",0,19,12,6,{layout:"comparison",description:"Compare regional distribution, channel balance, and funnel shape.",bindings:[B(W,240),B(m,240),B(D,240)]}),$(x,"widget_timeline","Growth Timeline","EMBED",0,25,12,6,{layout:"timeline",description:"Track revenue and retention over the same reporting cadence.",bindings:[B(N,220),B(Z,220)]})]}function R(x){let j=z(x),U=j.bindings.map((k)=>{let P=A.get(q(k.ref));if(!P)return null;return{key:`${x.id}:${q(k.ref)}`,spec:P,data:k.data,title:k.title??P.meta.title,description:k.description??P.meta.description,height:k.height}}).filter((k)=>Boolean(k));if(!U.length)return null;return{id:x.id,name:x.name,description:j.description,layout:j.layout,gridX:x.gridX,gridY:x.gridY,gridWidth:x.gridWidth,gridHeight:x.gridHeight,bindings:U}}function z(x){if(f(x.config))return x.config;let j=h[x.type];return j?{layout:"single",bindings:[{ref:j,data:y[q(j)]}]}:{layout:"single",bindings:[]}}function B(x,j=280){return{ref:J(x),data:y[q(x.meta)],height:j}}function $(x,j,U,k,P,M,w,I,E){let F=new Date;return{id:j,dashboardId:x,name:U,type:k,gridX:P,gridY:M,gridWidth:w,gridHeight:I,config:E,createdAt:F,updatedAt:F}}function f(x){if(!x||typeof x!=="object")return!1;let j=x;return(j.layout==="single"||j.layout==="comparison"||j.layout==="timeline")&&Array.isArray(j.bindings)}import{defineFeature as b}from"@contractspec/lib.contracts-spec/features";var kx=b({meta:{key:"analytics-dashboard",version:"1.0.0",title:"Analytics Dashboard",description:"Analytics dashboards with customizable widgets and queries",domain:"analytics",owners:["@analytics-dashboard"],tags:["analytics","dashboards","widgets","queries"],stability:"experimental"},operations:[{key:"analytics.dashboard.create",version:"1.0.0"},{key:"analytics.dashboard.list",version:"1.0.0"},{key:"analytics.dashboard.get",version:"1.0.0"},{key:"analytics.widget.add",version:"1.0.0"},{key:"analytics.query.create",version:"1.0.0"},{key:"analytics.query.execute",version:"1.0.0"}],events:[{key:"analytics.dashboard.created",version:"1.0.0"},{key:"analytics.widget.added",version:"1.0.0"},{key:"analytics.query.created",version:"1.0.0"}],presentations:[{key:"analytics.dashboard.viewList",version:"1.0.0"},{key:"analytics.dashboard.view",version:"1.0.0"},{key:"analytics.dashboard.editor",version:"1.0.0"},{key:"analytics.query.list",version:"1.0.0"},{key:"analytics.query.builder",version:"1.0.0"}],visualizations:[...T],opToPresentation:[{op:{key:"analytics.dashboard.list",version:"1.0.0"},pres:{key:"analytics.dashboard.viewList",version:"1.0.0"}},{op:{key:"analytics.dashboard.get",version:"1.0.0"},pres:{key:"analytics.dashboard.view",version:"1.0.0"}},{op:{key:"analytics.dashboard.create",version:"1.0.0"},pres:{key:"analytics.dashboard.editor",version:"1.0.0"}},{op:{key:"analytics.query.create",version:"1.0.0"},pres:{key:"analytics.query.builder",version:"1.0.0"}}],presentationsTargets:[{key:"analytics.dashboard.viewList",version:"1.0.0",targets:["react","markdown","application/json"]},{key:"analytics.dashboard.view",version:"1.0.0",targets:["react","markdown"]},{key:"analytics.dashboard.editor",version:"1.0.0",targets:["react"]},{key:"analytics.query.builder",version:"1.0.0",targets:["react"]}],capabilities:{requires:[{key:"identity",version:"1.0.0"},{key:"metering",version:"1.0.0"},{key:"audit-trail",version:"1.0.0"}]},telemetry:[{key:"analytics-dashboard.telemetry",version:"1.0.0"}],docs:["docs.examples.analytics-dashboard","docs.examples.analytics-dashboard.goal","docs.examples.analytics-dashboard.usage","docs.examples.analytics-dashboard.constraints"]});export{kx as AnalyticsDashboardFeature};
|
package/dist/example.d.ts
CHANGED
|
@@ -1,2 +1,3 @@
|
|
|
1
|
-
declare const
|
|
2
|
-
export default
|
|
1
|
+
declare const ExamplesAnalyticsDashboardExample: import("@contractspec/lib.contracts-spec").ExampleSpec;
|
|
2
|
+
export default ExamplesAnalyticsDashboardExample;
|
|
3
|
+
export { ExamplesAnalyticsDashboardExample };
|
package/dist/example.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
// @bun
|
|
2
|
-
import{defineExample as
|
|
2
|
+
import{defineExample as f}from"@contractspec/lib.contracts-spec/examples";var g=f({meta:{key:"analytics-dashboard",version:"1.0.0",title:"Analytics Dashboard",description:"Analytics Dashboard example with widgets and query engine for ContractSpec",kind:"template",visibility:"public",stability:"stable",owners:["@contractspec-core"],tags:["package","examples","analytics-dashboard","analytics","dashboard"]},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["playground","specs"]},studio:{enabled:!1,installable:!1},mcp:{enabled:!1}},entrypoints:{packageName:"@contractspec/example.analytics-dashboard"}}),q=g;export{q as default,g as ExamplesAnalyticsDashboardExample};
|
package/dist/index.d.ts
CHANGED
package/dist/index.js
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
// @bun
|
|
2
|
-
import{defineVisualization as b}from"@contractspec/lib.contracts-spec/visualizations";var s={key:"analytics.query.execute",version:"1.0.0"},i={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},R=b({meta:{...i,key:"analytics.visualization.channel-mix",title:"Channel Mix",description:"Session distribution across acquisition channels.",goal:"Explain which channels currently drive the largest share of traffic.",context:"Marketing attribution dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"pie",nameDimension:"channel",valueMeasure:"sessions",dimensions:[{key:"channel",label:"Channel",dataPath:"channel",type:"category"}],measures:[{key:"sessions",label:"Sessions",dataPath:"sessions"}],table:{caption:"Sessions by acquisition channel."}}}),S=b({meta:{...i,key:"analytics.visualization.engagement-heatmap",title:"Engagement Heatmap",description:"Average engagement score by weekday and time band.",goal:"Reveal the highest-engagement time windows for product activity.",context:"Usage analytics dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"heatmap",xDimension:"timeBand",yDimension:"weekday",valueMeasure:"engagementScore",dimensions:[{key:"timeBand",label:"Time Band",dataPath:"timeBand",type:"category"},{key:"weekday",label:"Weekday",dataPath:"weekday",type:"category"}],measures:[{key:"engagementScore",label:"Engagement",dataPath:"engagementScore"}],table:{caption:"Engagement score by weekday and time band."}}}),_=b({meta:{...i,key:"analytics.visualization.conversion-funnel",title:"Conversion Funnel",description:"Progression through the main acquisition funnel.",goal:"Show where the product is losing the largest share of prospects.",context:"Growth dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"funnel",nameDimension:"stage",valueMeasure:"users",sort:"descending",dimensions:[{key:"stage",label:"Stage",dataPath:"stage",type:"category"}],measures:[{key:"users",label:"Users",dataPath:"users"}],table:{caption:"Users per conversion stage."}}}),g=b({meta:{...i,key:"analytics.visualization.account-coverage-geo",title:"Account Coverage",description:"High-value accounts plotted on a slippy-map surface.",goal:"Locate where active commercial concentration is strongest.",context:"Territory coverage dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"geo",mode:"slippy-map",variant:"scatter",nameDimension:"city",latitudeDimension:"latitude",longitudeDimension:"longitude",valueMeasure:"accounts",dimensions:[{key:"city",label:"City",dataPath:"city",type:"category"},{key:"latitude",label:"Latitude",dataPath:"latitude",type:"latitude"},{key:"longitude",label:"Longitude",dataPath:"longitude",type:"longitude"}],measures:[{key:"accounts",label:"Accounts",dataPath:"accounts"}],table:{caption:"Account concentration by city."}}});import{defineVisualization as T}from"@contractspec/lib.contracts-spec/visualizations";var z={key:"analytics.query.execute",version:"1.0.0"},e={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},x=T({meta:{...e,key:"analytics.visualization.revenue-metric",title:"Revenue Snapshot",description:"Current recurring revenue with prior-period comparison.",goal:"Highlight the headline commercial metric for the dashboard.",context:"Executive revenue overview."},source:{primary:z,resultPath:"data"},visualization:{kind:"metric",measure:"totalRevenue",comparisonMeasure:"priorRevenue",dimensions:[{key:"period",label:"Period",dataPath:"period",type:"time"}],measures:[{key:"totalRevenue",label:"Revenue",dataPath:"totalRevenue",format:"currency"},{key:"priorRevenue",label:"Prior Revenue",dataPath:"priorRevenue",format:"currency"}],sparkline:{dimension:"period",measure:"totalRevenue"},table:{caption:"Revenue trend and prior period values."}}}),f=T({meta:{...e,key:"analytics.visualization.revenue-trend",title:"Revenue Trend",description:"Monthly revenue progression for the current quarter.",goal:"Track whether revenue growth is accelerating or stalling.",context:"Quarterly commercial dashboard."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"line",xDimension:"date",yMeasures:["revenue"],dimensions:[{key:"date",label:"Month",dataPath:"date",type:"time"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#0f766e"}],thresholds:[{key:"target",value:140000,label:"Target",color:"#dc2626"}],table:{caption:"Monthly revenue values."}}}),h=T({meta:{...e,key:"analytics.visualization.regional-revenue",title:"Regional Revenue",description:"Revenue split by sales territory.",goal:"Compare the strongest and weakest performing territories.",context:"Territory planning and commercial comparison."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"bar",xDimension:"region",yMeasures:["revenue"],dimensions:[{key:"region",label:"Region",dataPath:"region",type:"category"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#1d4ed8"}],table:{caption:"Revenue by region."}}}),E=T({meta:{...e,key:"analytics.visualization.retention-area",title:"Retention Curve",description:"Weekly retention progression across the active cohort.",goal:"Show whether user retention remains above the desired floor.",context:"Product health dashboard."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"area",xDimension:"week",yMeasures:["retentionRate"],dimensions:[{key:"week",label:"Week",dataPath:"week",type:"category"}],measures:[{key:"retentionRate",label:"Retention",dataPath:"retentionRate",format:"percentage",color:"#16a34a"}],thresholds:[{key:"floor",value:0.5,label:"Floor",color:"#f59e0b"}],table:{caption:"Weekly retention rate."}}}),I=T({meta:{...e,key:"analytics.visualization.pipeline-scatter",title:"Pipeline Velocity",description:"Deal-cycle length against win rate for active accounts.",goal:"Spot outliers where the sales cycle is long but conversion remains weak.",context:"Commercial operations dashboard."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"scatter",xDimension:"cycleDays",yMeasures:["winRate"],dimensions:[{key:"cycleDays",label:"Cycle Days",dataPath:"cycleDays",type:"number"}],measures:[{key:"winRate",label:"Win Rate",dataPath:"winRate",format:"percentage",color:"#7c3aed"},{key:"arr",label:"ARR",dataPath:"arr",format:"currency"}],series:[{key:"pipeline",label:"Accounts",measure:"winRate",type:"scatter",color:"#7c3aed"}],table:{caption:"Sales cycle and win rate per account."}}});import{VisualizationRegistry as Fr}from"@contractspec/lib.contracts-spec/visualizations";var d=[x,f,h,E,I,R,S,_,g],Yr=new Fr([...d]),Ar=d.map((r)=>Z(r)),tr=new Map(d.map((r)=>[B(r.meta),r])),a={[B(x.meta)]:{data:[{period:"2025-11-01",totalRevenue:112000,priorRevenue:103000},{period:"2025-12-01",totalRevenue:119000,priorRevenue:110000},{period:"2026-01-01",totalRevenue:126500,priorRevenue:116000},{period:"2026-02-01",totalRevenue:133000,priorRevenue:124000},{period:"2026-03-01",totalRevenue:145500,priorRevenue:133000}]},[B(f.meta)]:{data:[{date:"2025-11-01",revenue:112000},{date:"2025-12-01",revenue:119000},{date:"2026-01-01",revenue:126500},{date:"2026-02-01",revenue:133000},{date:"2026-03-01",revenue:145500}]},[B(h.meta)]:{data:[{region:"North America",revenue:210000},{region:"EMEA",revenue:174000},{region:"APAC",revenue:132000},{region:"LATAM",revenue:88000}]},[B(E.meta)]:{data:[{week:"Week 1",retentionRate:0.71},{week:"Week 2",retentionRate:0.66},{week:"Week 3",retentionRate:0.62},{week:"Week 4",retentionRate:0.58},{week:"Week 5",retentionRate:0.55},{week:"Week 6",retentionRate:0.53}]},[B(I.meta)]:{data:[{cycleDays:18,winRate:0.31,arr:82000},{cycleDays:26,winRate:0.44,arr:65000},{cycleDays:33,winRate:0.27,arr:91000},{cycleDays:14,winRate:0.56,arr:47000},{cycleDays:21,winRate:0.48,arr:59000},{cycleDays:39,winRate:0.22,arr:114000}]},[B(R.meta)]:{data:[{channel:"Direct",sessions:4200},{channel:"Organic Search",sessions:3600},{channel:"Paid Search",sessions:2100},{channel:"Partner",sessions:1400},{channel:"Referral",sessions:900}]},[B(S.meta)]:{data:[{weekday:"Mon",timeBand:"09:00",engagementScore:74},{weekday:"Mon",timeBand:"13:00",engagementScore:82},{weekday:"Tue",timeBand:"09:00",engagementScore:69},{weekday:"Tue",timeBand:"13:00",engagementScore:88},{weekday:"Wed",timeBand:"09:00",engagementScore:77},{weekday:"Wed",timeBand:"13:00",engagementScore:91},{weekday:"Thu",timeBand:"09:00",engagementScore:72},{weekday:"Thu",timeBand:"13:00",engagementScore:86},{weekday:"Fri",timeBand:"09:00",engagementScore:65},{weekday:"Fri",timeBand:"13:00",engagementScore:79}]},[B(_.meta)]:{data:[{stage:"Visited Site",users:12000},{stage:"Started Trial",users:4200},{stage:"Activated Workspace",users:2400},{stage:"Requested Demo",users:980},{stage:"Closed Won",users:310}]},[B(g.meta)]:{data:[{city:"Paris",latitude:48.8566,longitude:2.3522,accounts:48},{city:"London",latitude:51.5072,longitude:-0.1276,accounts:62},{city:"New York",latitude:40.7128,longitude:-74.006,accounts:71},{city:"Toronto",latitude:43.6532,longitude:-79.3832,accounts:36},{city:"Singapore",latitude:1.3521,longitude:103.8198,accounts:29}]}};function Z(r){return{key:r.meta.key,version:r.meta.version}}function B(r){return`${r.key}.v${r.version}`}var Rr={METRIC:Z(x),LINE_CHART:Z(f),BAR_CHART:Z(h),AREA_CHART:Z(E),SCATTER_PLOT:Z(I),PIE_CHART:Z(R),HEATMAP:Z(S),FUNNEL:Z(_),MAP:Z(g)};function V(r){return[K(r,"widget_revenue_metric","Revenue Snapshot","METRIC",0,0,4,2,{layout:"single",bindings:[U(x,200)]}),K(r,"widget_revenue_trend","Revenue Trend","LINE_CHART",4,0,8,4,{layout:"single",bindings:[U(f)]}),K(r,"widget_regional_revenue","Regional Revenue","BAR_CHART",0,2,6,4,{layout:"single",bindings:[U(h)]}),K(r,"widget_channel_mix","Channel Mix","PIE_CHART",6,2,6,4,{layout:"single",bindings:[U(R)]}),K(r,"widget_retention","Retention Curve","AREA_CHART",0,6,6,4,{layout:"single",bindings:[U(E)]}),K(r,"widget_pipeline","Pipeline Velocity","SCATTER_PLOT",6,6,6,4,{layout:"single",bindings:[U(I)]}),K(r,"widget_heatmap","Engagement Heatmap","HEATMAP",0,10,8,4,{layout:"single",bindings:[U(S)]}),K(r,"widget_funnel","Conversion Funnel","FUNNEL",8,10,4,4,{layout:"single",bindings:[U(_)]}),K(r,"widget_geo","Account Coverage","MAP",0,14,12,5,{layout:"single",bindings:[U(g,360)]}),K(r,"widget_comparison","Commercial Comparison","EMBED",0,19,12,6,{layout:"comparison",description:"Compare regional distribution, channel balance, and funnel shape.",bindings:[U(h,240),U(R,240),U(_,240)]}),K(r,"widget_timeline","Growth Timeline","EMBED",0,25,12,6,{layout:"timeline",description:"Track revenue and retention over the same reporting cadence.",bindings:[U(f,220),U(E,220)]})]}function j(r){let o=_r(r),n=o.bindings.map(($)=>{let y=tr.get(B($.ref));if(!y)return null;return{key:`${r.id}:${B($.ref)}`,spec:y,data:$.data,title:$.title??y.meta.title,description:$.description??y.meta.description,height:$.height}}).filter(($)=>Boolean($));if(!n.length)return null;return{id:r.id,name:r.name,description:o.description,layout:o.layout,gridX:r.gridX,gridY:r.gridY,gridWidth:r.gridWidth,gridHeight:r.gridHeight,bindings:n}}function _r(r){if(fr(r.config))return r.config;let o=Rr[r.type];return o?{layout:"single",bindings:[{ref:o,data:a[B(o)]}]}:{layout:"single",bindings:[]}}function U(r,o=280){return{ref:Z(r),data:a[B(r.meta)],height:o}}function K(r,o,n,$,y,c,Q,t,G){let L=new Date;return{id:o,dashboardId:r,name:n,type:$,gridX:y,gridY:c,gridWidth:Q,gridHeight:t,config:G,createdAt:L,updatedAt:L}}function fr(r){if(!r||typeof r!=="object")return!1;let o=r;return(o.layout==="single"||o.layout==="comparison"||o.layout==="timeline")&&Array.isArray(o.bindings)}import{defineFeature as hr}from"@contractspec/lib.contracts-spec";var gn=hr({meta:{key:"analytics-dashboard",version:"1.0.0",title:"Analytics Dashboard",description:"Analytics dashboards with customizable widgets and queries",domain:"analytics",owners:["@analytics-dashboard"],tags:["analytics","dashboards","widgets","queries"],stability:"experimental"},operations:[{key:"analytics.dashboard.create",version:"1.0.0"},{key:"analytics.dashboard.list",version:"1.0.0"},{key:"analytics.dashboard.get",version:"1.0.0"},{key:"analytics.widget.add",version:"1.0.0"},{key:"analytics.query.create",version:"1.0.0"},{key:"analytics.query.execute",version:"1.0.0"}],events:[{key:"analytics.dashboard.created",version:"1.0.0"},{key:"analytics.widget.added",version:"1.0.0"},{key:"analytics.query.created",version:"1.0.0"}],presentations:[{key:"analytics.dashboard.viewList",version:"1.0.0"},{key:"analytics.dashboard.view",version:"1.0.0"},{key:"analytics.dashboard.editor",version:"1.0.0"},{key:"analytics.query.list",version:"1.0.0"},{key:"analytics.query.builder",version:"1.0.0"}],visualizations:[...Ar],opToPresentation:[{op:{key:"analytics.dashboard.list",version:"1.0.0"},pres:{key:"analytics.dashboard.viewList",version:"1.0.0"}},{op:{key:"analytics.dashboard.get",version:"1.0.0"},pres:{key:"analytics.dashboard.view",version:"1.0.0"}},{op:{key:"analytics.dashboard.create",version:"1.0.0"},pres:{key:"analytics.dashboard.editor",version:"1.0.0"}},{op:{key:"analytics.query.create",version:"1.0.0"},pres:{key:"analytics.query.builder",version:"1.0.0"}}],presentationsTargets:[{key:"analytics.dashboard.viewList",version:"1.0.0",targets:["react","markdown","application/json"]},{key:"analytics.dashboard.view",version:"1.0.0",targets:["react","markdown"]},{key:"analytics.dashboard.editor",version:"1.0.0",targets:["react"]},{key:"analytics.query.builder",version:"1.0.0",targets:["react"]}],capabilities:{requires:[{key:"identity",version:"1.0.0"},{key:"metering",version:"1.0.0"},{key:"audit-trail",version:"1.0.0"}]},telemetry:[{key:"analytics-dashboard.telemetry",version:"1.0.0"}],docs:["docs.examples.analytics-dashboard","docs.examples.analytics-dashboard.goal","docs.examples.analytics-dashboard.usage","docs.examples.analytics-dashboard.constraints"]});class Qr{reader;defaultLimit;constructor(r,o={}){this.reader=r,this.defaultLimit=o.defaultLimit??100}async execute(r,o){let n=Date.now(),$=this.validateQuery(r);if(!$.valid)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:$.errors.join(", ")};if(!this.reader.queryHogQL)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:"Analytics reader does not support HogQL queries."};try{let y=await this.executeHogQL(r,o);return{data:y.data,columns:y.columns,rowCount:y.rowCount,executionTimeMs:Date.now()-n,cached:!1}}catch(y){return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:y instanceof Error?y.message:"Unknown error"}}}validateQuery(r){let o=[];if(r.type==="SQL"&&!r.sql)o.push("SQL query is missing.");if(r.type==="AGGREGATION"&&!r.aggregation)o.push("Aggregation definition is missing.");if(r.type==="METRIC"&&!r.metricIds?.length)o.push("Metric IDs are missing.");if(r.type==="CUSTOM"&&!r.custom?.handler)o.push("Custom handler is missing.");return{valid:o.length===0,errors:o}}async executeHogQL(r,o){if(!this.reader.queryHogQL)throw Error("Analytics reader does not support HogQL queries.");if(r.type==="SQL"){let n=await this.reader.queryHogQL({query:r.sql??"",values:o.parameters??{}});return kr(n)}if(r.type==="AGGREGATION"&&r.aggregation){let{query:n,values:$}=gr(r.aggregation,o),y=await this.reader.queryHogQL({query:n,values:$});return kr(y)}if(r.type==="METRIC"&&r.metricIds){let{query:n,values:$}=Sr(r.metricIds,o),y=await this.reader.queryHogQL({query:n,values:$});return kr(y)}throw Error("Unsupported query type for PostHog datasource.")}}function Er(r,o){return new Qr(r,o)}function Sr(r,o){let n=Ur(o),$={dateFrom:n?.from.toISOString(),dateTo:n?.to.toISOString()},y=r.map((Q,t)=>{return $[`metric${t}`]=Q,`event = {metric${t}}`}),c=[y.length?`(${y.join(" or ")})`:"",n?"timestamp >= {dateFrom} and timestamp < {dateTo}":""].filter(Boolean).join(" and ");return{query:["select"," event as metric,"," count() as total","from events",c?`where ${c}`:"","group by metric"].filter(Boolean).join(`
|
|
3
|
-
`),values:$}}function
|
|
4
|
-
`)}`,`from ${r.source}`,Q.length?`where ${Q.join(" and ")}`:"",$.length?`group by ${$.map((L)=>L.name).join(", ")}`:"",G,`limit ${
|
|
5
|
-
`),values:c}}function
|
|
6
|
-
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,[
|
|
7
|
-
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,[m,A.dashboardId,A.name,A.type,A.gridX??0,A.gridY??0,A.gridWidth??6,A.gridHeight??4,A.queryId??null,A.config?JSON.stringify(A.config):null,
|
|
8
|
-
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,[D,m.projectId,m.organizationId,A.name,A.description??null,A.type,JSON.stringify(A.definition),A.sql??null,A.cacheTtlSeconds??300,A.isShared?1:0,k,k]);let N=(await r.query("SELECT * FROM analytics_query WHERE id = ?",[D])).rows;return Dr(N[0])}async function Y(A){let m=(await r.query("SELECT * FROM analytics_query WHERE id = ?",[A])).rows;return m[0]?Dr(m[0]):null}return{listDashboards:o,createDashboard:n,getDashboard:$,updateDashboard:y,getWidgets:c,addWidget:Q,updateWidget:t,deleteWidget:G,listQueries:L,createQuery:C,getQuery:Y}}import{defineEnum as lr}from"@contractspec/lib.schema";var or=lr("QueryType",["SQL","METRIC","AGGREGATION","CUSTOM"]);import{defineSchemaModel as mr,ScalarTypeEnum as P}from"@contractspec/lib.schema";var $r=mr({name:"QueryModel",fields:{id:{type:P.String_unsecure(),isOptional:!1},name:{type:P.String_unsecure(),isOptional:!1},description:{type:P.String_unsecure(),isOptional:!0},type:{type:or,isOptional:!1},definition:{type:P.JSON(),isOptional:!1},sql:{type:P.String_unsecure(),isOptional:!0},cacheTtlSeconds:{type:P.Int_unsecure(),isOptional:!1},isShared:{type:P.Boolean(),isOptional:!1},createdAt:{type:P.DateTime(),isOptional:!1}}}),Nr=mr({name:"QueryResultModel",fields:{queryId:{type:P.String_unsecure(),isOptional:!1},data:{type:P.JSON(),isOptional:!1},columns:{type:P.JSON(),isOptional:!1},rowCount:{type:P.Int_unsecure(),isOptional:!1},executionTimeMs:{type:P.Int_unsecure(),isOptional:!1},cachedAt:{type:P.DateTime(),isOptional:!0},error:{type:P.String_unsecure(),isOptional:!0}}}),Pr=mr({name:"CreateQueryInput",fields:{name:{type:P.NonEmptyString(),isOptional:!1},description:{type:P.String_unsecure(),isOptional:!0},type:{type:or,isOptional:!1},definition:{type:P.JSON(),isOptional:!1},sql:{type:P.String_unsecure(),isOptional:!0},metricIds:{type:P.String_unsecure(),isArray:!0,isOptional:!0},cacheTtlSeconds:{type:P.Int_unsecure(),isOptional:!0},isShared:{type:P.Boolean(),isOptional:!0}}}),Gr=mr({name:"ExecuteQueryInput",fields:{queryId:{type:P.String_unsecure(),isOptional:!1},parameters:{type:P.JSON(),isOptional:!0},dateRange:{type:P.JSON(),isOptional:!0},filters:{type:P.JSON(),isOptional:!0},forceRefresh:{type:P.Boolean(),isOptional:!0}}});import{defineCommand as Tr,defineQuery as zr}from"@contractspec/lib.contracts-spec/operations";var Hr=["@example.analytics-dashboard"],er=Tr({meta:{key:"analytics.query.create",version:"1.0.0",stability:"stable",owners:[...Hr],tags:["analytics","query","create"],description:"Create a data query.",goal:"Define reusable data queries.",context:"Query builder."},io:{input:Pr,output:$r},policy:{auth:"user"},sideEffects:{emits:[{key:"analytics.query.created",version:"1.0.0",stability:"stable",owners:[...Hr],tags:["analytics","query","created"],when:"Query created",payload:$r}],audit:["analytics.query.created"]},acceptance:{scenarios:[{key:"create-query-happy-path",given:["User is authenticated"],when:["User submits valid query definition"],then:["Query is created","QueryCreated event is emitted"]}],examples:[{key:"create-sql-query",input:{name:"Monthly Revenue",sql:"SELECT SUM(amount) FROM orders WHERE date >= :startDate"},output:{id:"query-123",name:"Monthly Revenue",type:"sql"}}]}}),jr=zr({meta:{key:"analytics.query.execute",version:"1.0.0",stability:"stable",owners:[...Hr],tags:["analytics","query","execute"],description:"Execute a data query.",goal:"Fetch data for visualizations.",context:"Dashboard rendering."},io:{input:Gr,output:Nr},policy:{auth:"user"},acceptance:{scenarios:[{key:"execute-query-happy-path",given:["Query exists"],when:["User executes query with parameters"],then:["Query results are returned"]}],examples:[{key:"execute-with-params",input:{queryId:"query-123",params:{startDate:"2025-01-01"}},output:{columns:["total"],rows:[{total:50000}],rowCount:1}}]}});class Zr{cache=new Map;async get(r){let o=this.cache.get(r);if(!o)return null;if(o.expiresAt<new Date)return this.cache.delete(r),null;return{...o.result,cached:!0,cachedAt:o.expiresAt}}async set(r,o,n){let $=new Date(Date.now()+n*1000);this.cache.set(r,{result:o,expiresAt:$})}async invalidate(r){let o=new RegExp(r);for(let n of this.cache.keys())if(o.test(n))this.cache.delete(n)}}class qr{cache;constructor(r){this.cache=r??new Zr}async execute(r,o){let n=Date.now(),$=this.validateQuery(r);if(!$.valid)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:$.errors.join(", ")};let y=this.buildCacheKey(r,o),c=await this.cache.get(y);if(c)return c;let Q;switch(r.type){case"AGGREGATION":if(!r.aggregation)throw Error("Aggregation definition is missing");Q=await this.executeAggregation(r.aggregation,o);break;case"METRIC":if(!r.metricIds)throw Error("Metric IDs are missing");Q=await this.executeMetric(r.metricIds,o);break;case"SQL":if(!r.sql)throw Error("SQL query is missing");Q=await this.executeSql(r.sql,o);break;default:Q={data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:`Unknown query type: ${r.type}`}}return Q.executionTimeMs=Date.now()-n,Q.cached=!1,await this.cache.set(y,Q,300),Q}validateQuery(r){let o=[];if(!r.type)o.push("Query type is required");switch(r.type){case"SQL":if(!r.sql)o.push("SQL query is required for SQL type");break;case"METRIC":if(!r.metricIds||r.metricIds.length===0)o.push("Metric IDs are required for METRIC type");break;case"AGGREGATION":if(!r.aggregation)o.push("Aggregation definition is required for AGGREGATION type");else{if(!r.aggregation.source)o.push("Aggregation source is required");if(!r.aggregation.measures||r.aggregation.measures.length===0)o.push("At least one measure is required")}break}return{valid:o.length===0,errors:o}}buildCacheKey(r,o){return JSON.stringify({definition:r,params:o})}async executeAggregation(r,o){let n=[...r.dimensions.map((y)=>({name:y.name,type:y.type==="NUMBER"?"NUMBER":y.type==="TIME"?"DATE":"STRING",label:y.name})),...r.measures.map((y)=>({name:y.name,type:"NUMBER",label:y.name,format:y.format}))],$=this.generateMockData(r,o);return{data:$,columns:n,rowCount:$.length,executionTimeMs:0,cached:!1}}async executeMetric(r,o){let n=r.map(($)=>({metricId:$,value:Math.random()*1000,change:(Math.random()-0.5)*20}));return{data:n,columns:[{name:"metricId",type:"STRING"},{name:"value",type:"NUMBER"},{name:"change",type:"NUMBER"}],rowCount:n.length,executionTimeMs:0,cached:!1}}async executeSql(r,o){return{data:[],columns:[],rowCount:0,executionTimeMs:0,cached:!1,error:"SQL execution not implemented in demo"}}generateMockData(r,o){let n=[],$=10,y=r.dimensions.find((c)=>c.type==="TIME");for(let c=0;c<10;c++){let Q={};for(let t of r.dimensions)if(t.type==="TIME"){let G=new Date(o.dateRange?.start??new Date);G.setDate(G.getDate()+c),Q[t.name]=G.toISOString().split("T")[0]}else Q[t.name]=`${t.name}_${c%5}`;for(let t of r.measures){let G=y?100+c*10:Math.random()*1000,L=(Math.random()-0.5)*20;Q[t.name]=Math.round((G+L)*100)/100}n.push(Q)}return n}}function oo(r){return new qr(r)}import{ComparisonView as pr,TimelineView as wr,VisualizationCard as br,VisualizationGrid as sr}from"@contractspec/lib.design-system";import{jsx as p,jsxs as yr}from"react/jsx-runtime";function Xr({dashboardName:r,widgets:o}){if(!o.length)return yr("div",{className:"rounded-lg border border-dashed p-10 text-center text-muted-foreground",children:['No visualization widgets configured for "',r,'".']});return yr("div",{children:[yr("h3",{className:"mb-4 font-semibold text-lg",children:['Widgets in "',r,'"']}),p(sr,{children:o.map((n)=>p("div",{className:dr(n.gridWidth),children:ir(n)},n.id))})]})}function ir(r){let o=yr("span",{className:"text-muted-foreground text-xs",children:["Position: (",r.gridX,", ",r.gridY,") \u2022 ",r.gridWidth,"x",r.gridHeight]});if(r.layout==="comparison")return p(pr,{description:r.description,items:r.bindings.map(($)=>({...$,footer:o})),title:r.name});if(r.layout==="timeline")return p(wr,{description:r.description,items:r.bindings.map(($)=>({...$,footer:o})),title:r.name});let n=r.bindings[0];if(!n)return null;return p(br,{data:n.data,description:r.description??n.description,footer:o,height:n.height,spec:n.spec,title:r.name})}function dr(r){if(r>=12)return"md:col-span-2 xl:col-span-3";if(r>=8)return"xl:col-span-2";if(r>=6)return"md:col-span-2";return""}import{DataTable as ar}from"@contractspec/lib.design-system";import{useContractTable as rn}from"@contractspec/lib.presentation-runtime-react";import{Badge as Jr}from"@contractspec/lib.ui-kit-web/ui/badge";import{HStack as nn,VStack as w}from"@contractspec/lib.ui-kit-web/ui/stack";import{Text as v}from"@contractspec/lib.ui-kit-web/ui/text";import{jsx as q,jsxs as F}from"react/jsx-runtime";var on={SQL:"default",METRIC:"secondary",AGGREGATION:"secondary",CUSTOM:"outline"};function mn(r){return JSON.stringify(r,null,2)}function Kr({queries:r}){let o=rn({data:r,columns:[{id:"query",header:"Query",label:"Query",accessor:(n)=>n.name,cell:({item:n})=>F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:n.name}),F(v,{className:"text-muted-foreground text-xs",children:["Updated ",n.updatedAt.toLocaleDateString()]})]}),size:240,minSize:180,canSort:!0,canPin:!0,canResize:!0},{id:"description",header:"Description",label:"Description",accessor:(n)=>n.description??"",cell:({value:n})=>q(v,{className:"line-clamp-2 text-muted-foreground text-sm",children:String(n||"No description")}),size:300,minSize:220,canSort:!1,canHide:!0,canResize:!0},{id:"type",header:"Type",label:"Type",accessorKey:"type",cell:({value:n})=>q(Jr,{variant:on[String(n)],children:String(n)}),size:150,canSort:!0,canHide:!0,canResize:!0},{id:"cacheTtlSeconds",header:"Cache TTL",label:"Cache TTL",accessorKey:"cacheTtlSeconds",cell:({value:n})=>`${String(n)}s`,align:"right",size:140,canSort:!0,canResize:!0},{id:"isShared",header:"Shared",label:"Shared",accessorKey:"isShared",cell:({value:n})=>q(Jr,{variant:n?"default":"outline",children:n?"Shared":"Private"}),size:140,canSort:!0,canHide:!0,canResize:!0}],initialState:{pagination:{pageIndex:0,pageSize:3},columnVisibility:{description:!1},columnPinning:{left:["query"],right:[]}},renderExpandedContent:(n)=>F(w,{gap:"sm",className:"py-2",children:[F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:"Description"}),q(v,{className:"text-muted-foreground text-sm",children:n.description??"No description"})]}),n.sql?F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:"SQL"}),q("pre",{className:"overflow-auto rounded-md bg-muted/40 p-3 text-xs",children:n.sql})]}):null,F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:"Definition"}),q("pre",{className:"overflow-auto rounded-md bg-muted/40 p-3 text-xs",children:mn(n.definition)})]})]}),getCanExpand:()=>!0});return q(ar,{controller:o,title:"Saved Queries",description:"Client-mode table using the shared ContractSpec controller and renderer.",toolbar:F(nn,{gap:"sm",className:"flex-wrap",children:[F(v,{className:"text-muted-foreground text-sm",children:[r.length," queries"]}),F(v,{className:"text-muted-foreground text-sm",children:[r.filter((n)=>n.isShared).length," shared"]})]}),emptyState:q("div",{className:"rounded-md border border-dashed p-8 text-center text-muted-foreground text-sm",children:"No queries saved"})})}import{useTemplateRuntime as $n}from"@contractspec/lib.example-shared-ui";import{useCallback as Cr,useEffect as yn,useState as u}from"react";function Br(r="local-project"){let{handlers:o}=$n(),n=o.analytics,[$,y]=u([]),[c,Q]=u([]),[t,G]=u(null),[L,C]=u([]),[Y,A]=u(!0),[m,D]=u(null),k=Cr(async()=>{try{A(!0),D(null);let[H,O]=await Promise.all([n.listDashboards({projectId:r,limit:100}),n.listQueries({projectId:r,limit:100})]);if(y(H.dashboards),Q(O.queries),H.dashboards.length>0&&!t){let J=H.dashboards[0];if(J){G(J);let l=await n.getWidgets(J.id);C(l.length>0?l:V(J.id))}}}catch(H){D(H instanceof Error?H:Error("Failed to load analytics"))}finally{A(!1)}},[n,r,t]);yn(()=>{k()},[k]);let N=Cr(async(H)=>{G(H);let O=await n.getWidgets(H.id);C(O.length>0?O:V(H.id))},[n]),W={totalDashboards:$.length,publishedDashboards:$.filter((H)=>H.status==="PUBLISHED").length,totalQueries:c.length,sharedQueries:c.filter((H)=>H.isShared).length};return{dashboards:$,queries:c,selectedDashboard:t,widgets:L,loading:Y,error:m,stats:W,refetch:k,selectDashboard:N}}import{Button as Wr,ErrorState as cn,LoaderBlock as An,StatCard as Mr,StatCardGroup as tn}from"@contractspec/lib.design-system";import{useMemo as kn,useState as Qn}from"react";import{jsx as M,jsxs as X}from"react/jsx-runtime";var Ln={PUBLISHED:"bg-green-100 text-green-700 dark:bg-green-900/30 dark:text-green-400",DRAFT:"bg-gray-100 text-gray-700 dark:bg-gray-900/30 dark:text-gray-400",ARCHIVED:"bg-yellow-100 text-yellow-700 dark:bg-yellow-900/30 dark:text-yellow-400"};function Dn(){let[r,o]=Qn("dashboards"),{dashboards:n,queries:$,selectedDashboard:y,widgets:c,loading:Q,error:t,stats:G,refetch:L,selectDashboard:C}=Br(),Y=[{id:"dashboards",label:"Dashboards",icon:"\uD83D\uDCCA"},{id:"queries",label:"Queries",icon:"\uD83D\uDD0D"}],A=kn(()=>c.map((m)=>j(m)).filter((m)=>Boolean(m)),[c]);if(Q)return M(An,{label:"Loading Analytics..."});if(t)return M(cn,{title:"Failed to load Analytics",description:t.message,onRetry:L,retryLabel:"Retry"});return X("div",{className:"space-y-6",children:[X("div",{className:"flex items-center justify-between",children:[M("h2",{className:"font-bold text-2xl",children:"Analytics Dashboard"}),X(Wr,{onClick:()=>alert("Create dashboard modal"),children:[M("span",{className:"mr-2",children:"+"})," New Dashboard"]})]}),X(tn,{children:[M(Mr,{label:"Dashboards",value:G.totalDashboards,hint:`${G.publishedDashboards} published`}),M(Mr,{label:"Queries",value:G.totalQueries,hint:`${G.sharedQueries} shared`}),M(Mr,{label:"Widgets",value:c.length,hint:"on current dashboard"})]}),M("nav",{className:"flex gap-1 rounded-lg bg-muted p-1",role:"tablist",children:Y.map((m)=>X(Wr,{type:"button",role:"tab","aria-selected":r===m.id,onClick:()=>o(m.id),className:`flex flex-1 items-center justify-center gap-2 rounded-md px-4 py-2 font-medium text-sm transition-colors ${r===m.id?"bg-background text-foreground shadow-sm":"text-muted-foreground hover:text-foreground"}`,children:[M("span",{children:m.icon}),m.label]},m.id))}),X("div",{className:"min-h-[400px]",role:"tabpanel",children:[r==="dashboards"&&X("div",{className:"space-y-6",children:[X("div",{className:"grid gap-4 sm:grid-cols-2 lg:grid-cols-3",children:[n.map((m)=>X("div",{onClick:()=>C(m),className:`cursor-pointer rounded-lg border border-border bg-card p-4 transition-all ${y?.id===m.id?"ring-2 ring-primary":"hover:bg-muted/50"}`,role:"button",tabIndex:0,onKeyDown:(D)=>{if(D.key==="Enter"||D.key===" ")C(m)},children:[X("div",{className:"mb-2 flex items-center justify-between",children:[M("h3",{className:"font-medium",children:m.name}),M("span",{className:`inline-flex rounded-full px-2 py-0.5 font-medium text-xs ${Ln[m.status]??""}`,children:m.status})]}),M("p",{className:"mb-3 text-muted-foreground text-sm",children:m.description}),X("div",{className:"flex items-center justify-between text-muted-foreground text-xs",children:[X("span",{children:["/",m.slug]}),m.isPublic&&M("span",{className:"text-green-600 dark:text-green-400",children:"\uD83C\uDF10 Public"})]})]},m.id)),n.length===0&&M("div",{className:"col-span-full flex h-64 items-center justify-center text-muted-foreground",children:"No dashboards created yet"})]}),y?M(Xr,{dashboardName:y.name,widgets:A}):null]}),r==="queries"&&M(Kr,{queries:$})]})]})}var cr=[{id:"dash-1",name:"Sales Overview",slug:"sales-overview",status:"PUBLISHED",widgetCount:11,viewCount:1250,lastViewedAt:"2026-03-18T12:00:00Z"},{id:"dash-2",name:"User Engagement",slug:"user-engagement",status:"PUBLISHED",widgetCount:8,viewCount:890,lastViewedAt:"2026-03-18T10:00:00Z"}],vr=[{id:"q-1",name:"Monthly Revenue",type:"AGGREGATION",isShared:!0,executionCount:1500},{id:"q-2",name:"User Growth",type:"METRIC",isShared:!0,executionCount:890},{id:"q-3",name:"Product Sales",type:"SQL",isShared:!1,executionCount:340},{id:"q-4",name:"Conversion Funnel",type:"AGGREGATION",isShared:!0,executionCount:450}];function Nn(r){return V(r).map((o)=>j(o)).filter((o)=>Boolean(o))}var Pn={target:"markdown",render:async(r)=>{if(r.source.type!=="component"||r.source.componentKey!=="AnalyticsDashboard")throw Error("analyticsDashboardMarkdownRenderer: not AnalyticsDashboard");let o=cr[0];if(!o)return{mimeType:"text/markdown",body:`# No Dashboards
|
|
2
|
+
import{defineVisualization as b}from"@contractspec/lib.contracts-spec/visualizations";var s={key:"analytics.query.execute",version:"1.0.0"},i={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},R=b({meta:{...i,key:"analytics.visualization.channel-mix",title:"Channel Mix",description:"Session distribution across acquisition channels.",goal:"Explain which channels currently drive the largest share of traffic.",context:"Marketing attribution dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"pie",nameDimension:"channel",valueMeasure:"sessions",dimensions:[{key:"channel",label:"Channel",dataPath:"channel",type:"category"}],measures:[{key:"sessions",label:"Sessions",dataPath:"sessions"}],table:{caption:"Sessions by acquisition channel."}}}),g=b({meta:{...i,key:"analytics.visualization.engagement-heatmap",title:"Engagement Heatmap",description:"Average engagement score by weekday and time band.",goal:"Reveal the highest-engagement time windows for product activity.",context:"Usage analytics dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"heatmap",xDimension:"timeBand",yDimension:"weekday",valueMeasure:"engagementScore",dimensions:[{key:"timeBand",label:"Time Band",dataPath:"timeBand",type:"category"},{key:"weekday",label:"Weekday",dataPath:"weekday",type:"category"}],measures:[{key:"engagementScore",label:"Engagement",dataPath:"engagementScore"}],table:{caption:"Engagement score by weekday and time band."}}}),_=b({meta:{...i,key:"analytics.visualization.conversion-funnel",title:"Conversion Funnel",description:"Progression through the main acquisition funnel.",goal:"Show where the product is losing the largest share of prospects.",context:"Growth dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"funnel",nameDimension:"stage",valueMeasure:"users",sort:"descending",dimensions:[{key:"stage",label:"Stage",dataPath:"stage",type:"category"}],measures:[{key:"users",label:"Users",dataPath:"users"}],table:{caption:"Users per conversion stage."}}}),E=b({meta:{...i,key:"analytics.visualization.account-coverage-geo",title:"Account Coverage",description:"High-value accounts plotted on a slippy-map surface.",goal:"Locate where active commercial concentration is strongest.",context:"Territory coverage dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"geo",mode:"slippy-map",variant:"scatter",nameDimension:"city",latitudeDimension:"latitude",longitudeDimension:"longitude",valueMeasure:"accounts",dimensions:[{key:"city",label:"City",dataPath:"city",type:"category"},{key:"latitude",label:"Latitude",dataPath:"latitude",type:"latitude"},{key:"longitude",label:"Longitude",dataPath:"longitude",type:"longitude"}],measures:[{key:"accounts",label:"Accounts",dataPath:"accounts"}],table:{caption:"Account concentration by city."}}});import{defineVisualization as l}from"@contractspec/lib.contracts-spec/visualizations";var z={key:"analytics.query.execute",version:"1.0.0"},e={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},I=l({meta:{...e,key:"analytics.visualization.revenue-metric",title:"Revenue Snapshot",description:"Current recurring revenue with prior-period comparison.",goal:"Highlight the headline commercial metric for the dashboard.",context:"Executive revenue overview."},source:{primary:z,resultPath:"data"},visualization:{kind:"metric",measure:"totalRevenue",comparisonMeasure:"priorRevenue",dimensions:[{key:"period",label:"Period",dataPath:"period",type:"time"}],measures:[{key:"totalRevenue",label:"Revenue",dataPath:"totalRevenue",format:"currency"},{key:"priorRevenue",label:"Prior Revenue",dataPath:"priorRevenue",format:"currency"}],sparkline:{dimension:"period",measure:"totalRevenue"},table:{caption:"Revenue trend and prior period values."}}}),f=l({meta:{...e,key:"analytics.visualization.revenue-trend",title:"Revenue Trend",description:"Monthly revenue progression for the current quarter.",goal:"Track whether revenue growth is accelerating or stalling.",context:"Quarterly commercial dashboard."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"line",xDimension:"date",yMeasures:["revenue"],dimensions:[{key:"date",label:"Month",dataPath:"date",type:"time"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#0f766e"}],thresholds:[{key:"target",value:140000,label:"Target",color:"#dc2626"}],table:{caption:"Monthly revenue values."}}}),h=l({meta:{...e,key:"analytics.visualization.regional-revenue",title:"Regional Revenue",description:"Revenue split by sales territory.",goal:"Compare the strongest and weakest performing territories.",context:"Territory planning and commercial comparison."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"bar",xDimension:"region",yMeasures:["revenue"],dimensions:[{key:"region",label:"Region",dataPath:"region",type:"category"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#1d4ed8"}],table:{caption:"Revenue by region."}}}),S=l({meta:{...e,key:"analytics.visualization.retention-area",title:"Retention Curve",description:"Weekly retention progression across the active cohort.",goal:"Show whether user retention remains above the desired floor.",context:"Product health dashboard."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"area",xDimension:"week",yMeasures:["retentionRate"],dimensions:[{key:"week",label:"Week",dataPath:"week",type:"category"}],measures:[{key:"retentionRate",label:"Retention",dataPath:"retentionRate",format:"percentage",color:"#16a34a"}],thresholds:[{key:"floor",value:0.5,label:"Floor",color:"#f59e0b"}],table:{caption:"Weekly retention rate."}}}),V=l({meta:{...e,key:"analytics.visualization.pipeline-scatter",title:"Pipeline Velocity",description:"Deal-cycle length against win rate for active accounts.",goal:"Spot outliers where the sales cycle is long but conversion remains weak.",context:"Commercial operations dashboard."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"scatter",xDimension:"cycleDays",yMeasures:["winRate"],dimensions:[{key:"cycleDays",label:"Cycle Days",dataPath:"cycleDays",type:"number"}],measures:[{key:"winRate",label:"Win Rate",dataPath:"winRate",format:"percentage",color:"#7c3aed"},{key:"arr",label:"ARR",dataPath:"arr",format:"currency"}],series:[{key:"pipeline",label:"Accounts",measure:"winRate",type:"scatter",color:"#7c3aed"}],table:{caption:"Sales cycle and win rate per account."}}});import{VisualizationRegistry as Fr}from"@contractspec/lib.contracts-spec/visualizations";var d=[I,f,h,S,V,R,g,_,E],Yr=new Fr([...d]),Ar=d.map((r)=>Z(r)),kr=new Map(d.map((r)=>[B(r.meta),r])),a={[B(I.meta)]:{data:[{period:"2025-11-01",totalRevenue:112000,priorRevenue:103000},{period:"2025-12-01",totalRevenue:119000,priorRevenue:110000},{period:"2026-01-01",totalRevenue:126500,priorRevenue:116000},{period:"2026-02-01",totalRevenue:133000,priorRevenue:124000},{period:"2026-03-01",totalRevenue:145500,priorRevenue:133000}]},[B(f.meta)]:{data:[{date:"2025-11-01",revenue:112000},{date:"2025-12-01",revenue:119000},{date:"2026-01-01",revenue:126500},{date:"2026-02-01",revenue:133000},{date:"2026-03-01",revenue:145500}]},[B(h.meta)]:{data:[{region:"North America",revenue:210000},{region:"EMEA",revenue:174000},{region:"APAC",revenue:132000},{region:"LATAM",revenue:88000}]},[B(S.meta)]:{data:[{week:"Week 1",retentionRate:0.71},{week:"Week 2",retentionRate:0.66},{week:"Week 3",retentionRate:0.62},{week:"Week 4",retentionRate:0.58},{week:"Week 5",retentionRate:0.55},{week:"Week 6",retentionRate:0.53}]},[B(V.meta)]:{data:[{cycleDays:18,winRate:0.31,arr:82000},{cycleDays:26,winRate:0.44,arr:65000},{cycleDays:33,winRate:0.27,arr:91000},{cycleDays:14,winRate:0.56,arr:47000},{cycleDays:21,winRate:0.48,arr:59000},{cycleDays:39,winRate:0.22,arr:114000}]},[B(R.meta)]:{data:[{channel:"Direct",sessions:4200},{channel:"Organic Search",sessions:3600},{channel:"Paid Search",sessions:2100},{channel:"Partner",sessions:1400},{channel:"Referral",sessions:900}]},[B(g.meta)]:{data:[{weekday:"Mon",timeBand:"09:00",engagementScore:74},{weekday:"Mon",timeBand:"13:00",engagementScore:82},{weekday:"Tue",timeBand:"09:00",engagementScore:69},{weekday:"Tue",timeBand:"13:00",engagementScore:88},{weekday:"Wed",timeBand:"09:00",engagementScore:77},{weekday:"Wed",timeBand:"13:00",engagementScore:91},{weekday:"Thu",timeBand:"09:00",engagementScore:72},{weekday:"Thu",timeBand:"13:00",engagementScore:86},{weekday:"Fri",timeBand:"09:00",engagementScore:65},{weekday:"Fri",timeBand:"13:00",engagementScore:79}]},[B(_.meta)]:{data:[{stage:"Visited Site",users:12000},{stage:"Started Trial",users:4200},{stage:"Activated Workspace",users:2400},{stage:"Requested Demo",users:980},{stage:"Closed Won",users:310}]},[B(E.meta)]:{data:[{city:"Paris",latitude:48.8566,longitude:2.3522,accounts:48},{city:"London",latitude:51.5072,longitude:-0.1276,accounts:62},{city:"New York",latitude:40.7128,longitude:-74.006,accounts:71},{city:"Toronto",latitude:43.6532,longitude:-79.3832,accounts:36},{city:"Singapore",latitude:1.3521,longitude:103.8198,accounts:29}]}};function Z(r){return{key:r.meta.key,version:r.meta.version}}function B(r){return`${r.key}.v${r.version}`}var Rr={METRIC:Z(I),LINE_CHART:Z(f),BAR_CHART:Z(h),AREA_CHART:Z(S),SCATTER_PLOT:Z(V),PIE_CHART:Z(R),HEATMAP:Z(g),FUNNEL:Z(_),MAP:Z(E)};function u(r){return[K(r,"widget_revenue_metric","Revenue Snapshot","METRIC",0,0,4,2,{layout:"single",bindings:[U(I,200)]}),K(r,"widget_revenue_trend","Revenue Trend","LINE_CHART",4,0,8,4,{layout:"single",bindings:[U(f)]}),K(r,"widget_regional_revenue","Regional Revenue","BAR_CHART",0,2,6,4,{layout:"single",bindings:[U(h)]}),K(r,"widget_channel_mix","Channel Mix","PIE_CHART",6,2,6,4,{layout:"single",bindings:[U(R)]}),K(r,"widget_retention","Retention Curve","AREA_CHART",0,6,6,4,{layout:"single",bindings:[U(S)]}),K(r,"widget_pipeline","Pipeline Velocity","SCATTER_PLOT",6,6,6,4,{layout:"single",bindings:[U(V)]}),K(r,"widget_heatmap","Engagement Heatmap","HEATMAP",0,10,8,4,{layout:"single",bindings:[U(g)]}),K(r,"widget_funnel","Conversion Funnel","FUNNEL",8,10,4,4,{layout:"single",bindings:[U(_)]}),K(r,"widget_geo","Account Coverage","MAP",0,14,12,5,{layout:"single",bindings:[U(E,360)]}),K(r,"widget_comparison","Commercial Comparison","EMBED",0,19,12,6,{layout:"comparison",description:"Compare regional distribution, channel balance, and funnel shape.",bindings:[U(h,240),U(R,240),U(_,240)]}),K(r,"widget_timeline","Growth Timeline","EMBED",0,25,12,6,{layout:"timeline",description:"Track revenue and retention over the same reporting cadence.",bindings:[U(f,220),U(S,220)]})]}function j(r){let o=_r(r),n=o.bindings.map(($)=>{let y=kr.get(B($.ref));if(!y)return null;return{key:`${r.id}:${B($.ref)}`,spec:y,data:$.data,title:$.title??y.meta.title,description:$.description??y.meta.description,height:$.height}}).filter(($)=>Boolean($));if(!n.length)return null;return{id:r.id,name:r.name,description:o.description,layout:o.layout,gridX:r.gridX,gridY:r.gridY,gridWidth:r.gridWidth,gridHeight:r.gridHeight,bindings:n}}function _r(r){if(fr(r.config))return r.config;let o=Rr[r.type];return o?{layout:"single",bindings:[{ref:o,data:a[B(o)]}]}:{layout:"single",bindings:[]}}function U(r,o=280){return{ref:Z(r),data:a[B(r.meta)],height:o}}function K(r,o,n,$,y,c,Q,k,G){let L=new Date;return{id:o,dashboardId:r,name:n,type:$,gridX:y,gridY:c,gridWidth:Q,gridHeight:k,config:G,createdAt:L,updatedAt:L}}function fr(r){if(!r||typeof r!=="object")return!1;let o=r;return(o.layout==="single"||o.layout==="comparison"||o.layout==="timeline")&&Array.isArray(o.bindings)}import{defineFeature as hr}from"@contractspec/lib.contracts-spec/features";var Vn=hr({meta:{key:"analytics-dashboard",version:"1.0.0",title:"Analytics Dashboard",description:"Analytics dashboards with customizable widgets and queries",domain:"analytics",owners:["@analytics-dashboard"],tags:["analytics","dashboards","widgets","queries"],stability:"experimental"},operations:[{key:"analytics.dashboard.create",version:"1.0.0"},{key:"analytics.dashboard.list",version:"1.0.0"},{key:"analytics.dashboard.get",version:"1.0.0"},{key:"analytics.widget.add",version:"1.0.0"},{key:"analytics.query.create",version:"1.0.0"},{key:"analytics.query.execute",version:"1.0.0"}],events:[{key:"analytics.dashboard.created",version:"1.0.0"},{key:"analytics.widget.added",version:"1.0.0"},{key:"analytics.query.created",version:"1.0.0"}],presentations:[{key:"analytics.dashboard.viewList",version:"1.0.0"},{key:"analytics.dashboard.view",version:"1.0.0"},{key:"analytics.dashboard.editor",version:"1.0.0"},{key:"analytics.query.list",version:"1.0.0"},{key:"analytics.query.builder",version:"1.0.0"}],visualizations:[...Ar],opToPresentation:[{op:{key:"analytics.dashboard.list",version:"1.0.0"},pres:{key:"analytics.dashboard.viewList",version:"1.0.0"}},{op:{key:"analytics.dashboard.get",version:"1.0.0"},pres:{key:"analytics.dashboard.view",version:"1.0.0"}},{op:{key:"analytics.dashboard.create",version:"1.0.0"},pres:{key:"analytics.dashboard.editor",version:"1.0.0"}},{op:{key:"analytics.query.create",version:"1.0.0"},pres:{key:"analytics.query.builder",version:"1.0.0"}}],presentationsTargets:[{key:"analytics.dashboard.viewList",version:"1.0.0",targets:["react","markdown","application/json"]},{key:"analytics.dashboard.view",version:"1.0.0",targets:["react","markdown"]},{key:"analytics.dashboard.editor",version:"1.0.0",targets:["react"]},{key:"analytics.query.builder",version:"1.0.0",targets:["react"]}],capabilities:{requires:[{key:"identity",version:"1.0.0"},{key:"metering",version:"1.0.0"},{key:"audit-trail",version:"1.0.0"}]},telemetry:[{key:"analytics-dashboard.telemetry",version:"1.0.0"}],docs:["docs.examples.analytics-dashboard","docs.examples.analytics-dashboard.goal","docs.examples.analytics-dashboard.usage","docs.examples.analytics-dashboard.constraints"]});class Qr{reader;defaultLimit;constructor(r,o={}){this.reader=r,this.defaultLimit=o.defaultLimit??100}async execute(r,o){let n=Date.now(),$=this.validateQuery(r);if(!$.valid)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:$.errors.join(", ")};if(!this.reader.queryHogQL)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:"Analytics reader does not support HogQL queries."};try{let y=await this.executeHogQL(r,o);return{data:y.data,columns:y.columns,rowCount:y.rowCount,executionTimeMs:Date.now()-n,cached:!1}}catch(y){return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:y instanceof Error?y.message:"Unknown error"}}}validateQuery(r){let o=[];if(r.type==="SQL"&&!r.sql)o.push("SQL query is missing.");if(r.type==="AGGREGATION"&&!r.aggregation)o.push("Aggregation definition is missing.");if(r.type==="METRIC"&&!r.metricIds?.length)o.push("Metric IDs are missing.");if(r.type==="CUSTOM"&&!r.custom?.handler)o.push("Custom handler is missing.");return{valid:o.length===0,errors:o}}async executeHogQL(r,o){if(!this.reader.queryHogQL)throw Error("Analytics reader does not support HogQL queries.");if(r.type==="SQL"){let n=await this.reader.queryHogQL({query:r.sql??"",values:o.parameters??{}});return tr(n)}if(r.type==="AGGREGATION"&&r.aggregation){let{query:n,values:$}=Er(r.aggregation,o),y=await this.reader.queryHogQL({query:n,values:$});return tr(y)}if(r.type==="METRIC"&&r.metricIds){let{query:n,values:$}=gr(r.metricIds,o),y=await this.reader.queryHogQL({query:n,values:$});return tr(y)}throw Error("Unsupported query type for PostHog datasource.")}}function Sr(r,o){return new Qr(r,o)}function gr(r,o){let n=Ur(o),$={dateFrom:n?.from.toISOString(),dateTo:n?.to.toISOString()},y=r.map((Q,k)=>{return $[`metric${k}`]=Q,`event = {metric${k}}`}),c=[y.length?`(${y.join(" or ")})`:"",n?"timestamp >= {dateFrom} and timestamp < {dateTo}":""].filter(Boolean).join(" and ");return{query:["select"," event as metric,"," count() as total","from events",c?`where ${c}`:"","group by metric"].filter(Boolean).join(`
|
|
3
|
+
`),values:$}}function Er(r,o){let n=r.measures.map((L)=>({...L,expression:Ir(L.field,L.aggregation)})),$=r.dimensions.map((L)=>({...L,expression:Vr(L.field,L.type,L.granularity)})),y=[...$.map((L)=>`${L.expression} as ${L.name}`),...n.map((L)=>`${L.expression} as ${L.name}`)],c={},Q=ur(r,o,c),k=r.limit??100,G=r.orderBy?.length?`order by ${r.orderBy.map((L)=>`${L.field} ${L.direction}`).join(", ")}`:"";return{query:["select",` ${y.join(`,
|
|
4
|
+
`)}`,`from ${r.source}`,Q.length?`where ${Q.join(" and ")}`:"",$.length?`group by ${$.map((L)=>L.name).join(", ")}`:"",G,`limit ${k}`].filter(Boolean).join(`
|
|
5
|
+
`),values:c}}function Ir(r,o){switch(o){case"COUNT":return r==="*"?"count()":`count(${r})`;case"COUNT_DISTINCT":return`countDistinct(${r})`;case"SUM":return`sum(${r})`;case"AVG":return`avg(${r})`;case"MIN":return`min(${r})`;case"MAX":return`max(${r})`;default:return`count(${r})`}}function Vr(r,o,n){if(o==="TIME")switch(n){case"HOUR":return`toStartOfHour(${r})`;case"WEEK":return`toStartOfWeek(${r})`;case"MONTH":return`toStartOfMonth(${r})`;case"YEAR":return`toStartOfYear(${r})`;case"DAY":default:return`toStartOfDay(${r})`}return r}function ur(r,o,n){let $=[],y=Ur(o);if(y)n.dateFrom=y.from.toISOString(),n.dateTo=y.to.toISOString(),$.push("timestamp >= {dateFrom} and timestamp < {dateTo}");return r.filters?.forEach((c,Q)=>{let k=`filter${Q}`;switch(c.operator){case"eq":n[k]=c.value,$.push(`${c.field} = {${k}}`);break;case"neq":n[k]=c.value,$.push(`${c.field} != {${k}}`);break;case"gt":n[k]=c.value,$.push(`${c.field} > {${k}}`);break;case"gte":n[k]=c.value,$.push(`${c.field} >= {${k}}`);break;case"lt":n[k]=c.value,$.push(`${c.field} < {${k}}`);break;case"lte":n[k]=c.value,$.push(`${c.field} <= {${k}}`);break;case"contains":n[k]=c.value,$.push(`${c.field} LIKE '%' || {${k}} || '%'`);break;case"between":{if(Array.isArray(c.value)&&c.value.length>=2)n[`${k}Start`]=c.value[0],n[`${k}End`]=c.value[1],$.push(`${c.field} BETWEEN {${k}Start} AND {${k}End}`);break}case"in":case"nin":if(Array.isArray(c.value)){let G=[];if(c.value.forEach((L,C)=>{let Y=`${k}_${C}`;n[Y]=L,G.push(`{${Y}}`)}),G.length)$.push(`${c.field} ${c.operator==="in"?"IN":"NOT IN"} (${G.join(", ")})`)}break;default:break}}),$}function Ur(r){let o=r.dateRange;if(!o)return null;return{from:o.start,to:o.end}}function tr(r){if(!Array.isArray(r.results)||!Array.isArray(r.columns))return{data:[],columns:[],rowCount:0};let o=r.columns.map(($)=>({name:$,type:"STRING"})),n=r.results.map(($)=>{if(!Array.isArray($))return{};let y={};return r.columns?.forEach((c,Q)=>{y[c]=$[Q]}),y});return{data:n,columns:o,rowCount:n.length}}import{defineExample as xr}from"@contractspec/lib.contracts-spec/examples";var Tr=xr({meta:{key:"analytics-dashboard",version:"1.0.0",title:"Analytics Dashboard",description:"Analytics Dashboard example with widgets and query engine for ContractSpec",kind:"template",visibility:"public",stability:"stable",owners:["@contractspec-core"],tags:["package","examples","analytics-dashboard","analytics","dashboard"]},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["playground","specs"]},studio:{enabled:!1,installable:!1},mcp:{enabled:!1}},entrypoints:{packageName:"@contractspec/example.analytics-dashboard"}}),zn=Tr;import{web as lr}from"@contractspec/lib.runtime-sandbox";var{generateId:rr}=lr;function nr(r){return{id:r.id,projectId:r.projectId,organizationId:r.organizationId,name:r.name,slug:r.slug,description:r.description??void 0,status:r.status,refreshInterval:r.refreshInterval,isPublic:r.isPublic===1,shareToken:r.shareToken??void 0,createdAt:new Date(r.createdAt),updatedAt:new Date(r.updatedAt)}}function Lr(r){return{id:r.id,dashboardId:r.dashboardId,name:r.name,type:r.type,gridX:r.gridX,gridY:r.gridY,gridWidth:r.gridWidth,gridHeight:r.gridHeight,queryId:r.queryId??void 0,config:r.config?JSON.parse(r.config):void 0,createdAt:new Date(r.createdAt),updatedAt:new Date(r.updatedAt)}}function Nr(r){return{id:r.id,projectId:r.projectId,organizationId:r.organizationId,name:r.name,description:r.description??void 0,type:r.type,definition:JSON.parse(r.definition),sql:r.sql??void 0,cacheTtlSeconds:r.cacheTtlSeconds,isShared:r.isShared===1,createdAt:new Date(r.createdAt),updatedAt:new Date(r.updatedAt)}}function jn(r){async function o(A){let{projectId:m,status:N,search:t,limit:P=20,offset:W=0}=A,H="WHERE projectId = ?",O=[m];if(N&&N!=="all")H+=" AND status = ?",O.push(N);if(t)H+=" AND (name LIKE ? OR description LIKE ?)",O.push(`%${t}%`,`%${t}%`);let T=(await r.query(`SELECT COUNT(*) as count FROM analytics_dashboard ${H}`,O)).rows[0]?.count??0;return{dashboards:(await r.query(`SELECT * FROM analytics_dashboard ${H} ORDER BY updatedAt DESC LIMIT ? OFFSET ?`,[...O,P,W])).rows.map(nr),total:T}}async function n(A,m){let N=rr("dash"),t=new Date().toISOString();await r.execute(`INSERT INTO analytics_dashboard (id, projectId, organizationId, name, slug, description, status, refreshInterval, isPublic, createdAt, updatedAt)
|
|
6
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,[N,m.projectId,m.organizationId,A.name,A.slug,A.description??null,"DRAFT",A.refreshInterval??"NONE",0,t,t]);let P=(await r.query("SELECT * FROM analytics_dashboard WHERE id = ?",[N])).rows;return nr(P[0])}async function $(A){let m="",N=[];if(A.dashboardId)m="WHERE id = ?",N.push(A.dashboardId);else if(A.slug)m="WHERE slug = ?",N.push(A.slug);else if(A.shareToken)m="WHERE shareToken = ?",N.push(A.shareToken);else return null;let t=(await r.query(`SELECT * FROM analytics_dashboard ${m}`,N)).rows;return t[0]?nr(t[0]):null}async function y(A,m){let N=new Date().toISOString(),t=["updatedAt = ?"],P=[N];if(m.name!==void 0)t.push("name = ?"),P.push(m.name);if(m.description!==void 0)t.push("description = ?"),P.push(m.description);if(m.status!==void 0)t.push("status = ?"),P.push(m.status);if(m.refreshInterval!==void 0)t.push("refreshInterval = ?"),P.push(m.refreshInterval);if(m.isPublic!==void 0)if(t.push("isPublic = ?"),P.push(m.isPublic?1:0),m.isPublic)t.push("shareToken = ?"),P.push(rr("share"));else t.push("shareToken = NULL");P.push(A),await r.execute(`UPDATE analytics_dashboard SET ${t.join(", ")} WHERE id = ?`,P);let W=(await r.query("SELECT * FROM analytics_dashboard WHERE id = ?",[A])).rows;return nr(W[0])}async function c(A){return(await r.query("SELECT * FROM analytics_widget WHERE dashboardId = ? ORDER BY gridY, gridX",[A])).rows.map(Lr)}async function Q(A){let m=rr("widget"),N=new Date().toISOString();await r.execute(`INSERT INTO analytics_widget (id, dashboardId, name, type, gridX, gridY, gridWidth, gridHeight, queryId, config, createdAt, updatedAt)
|
|
7
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,[m,A.dashboardId,A.name,A.type,A.gridX??0,A.gridY??0,A.gridWidth??6,A.gridHeight??4,A.queryId??null,A.config?JSON.stringify(A.config):null,N,N]);let t=(await r.query("SELECT * FROM analytics_widget WHERE id = ?",[m])).rows;return Lr(t[0])}async function k(A,m){let N=new Date().toISOString(),t=["updatedAt = ?"],P=[N];if(m.name!==void 0)t.push("name = ?"),P.push(m.name);if(m.gridX!==void 0)t.push("gridX = ?"),P.push(m.gridX);if(m.gridY!==void 0)t.push("gridY = ?"),P.push(m.gridY);if(m.gridWidth!==void 0)t.push("gridWidth = ?"),P.push(m.gridWidth);if(m.gridHeight!==void 0)t.push("gridHeight = ?"),P.push(m.gridHeight);if(m.queryId!==void 0)t.push("queryId = ?"),P.push(m.queryId??null);if(m.config!==void 0)t.push("config = ?"),P.push(m.config?JSON.stringify(m.config):null);P.push(A),await r.execute(`UPDATE analytics_widget SET ${t.join(", ")} WHERE id = ?`,P);let W=(await r.query("SELECT * FROM analytics_widget WHERE id = ?",[A])).rows;return Lr(W[0])}async function G(A){await r.execute("DELETE FROM analytics_widget WHERE id = ?",[A])}async function L(A){let{projectId:m,type:N,isShared:t,search:P,limit:W=20,offset:H=0}=A,O="WHERE projectId = ?",J=[m];if(N&&N!=="all")O+=" AND type = ?",J.push(N);if(t!==void 0)O+=" AND isShared = ?",J.push(t?1:0);if(P)O+=" AND (name LIKE ? OR description LIKE ?)",J.push(`%${P}%`,`%${P}%`);let Or=(await r.query(`SELECT COUNT(*) as count FROM analytics_query ${O}`,J)).rows[0]?.count??0;return{queries:(await r.query(`SELECT * FROM analytics_query ${O} ORDER BY updatedAt DESC LIMIT ? OFFSET ?`,[...J,W,H])).rows.map(Nr),total:Or}}async function C(A,m){let N=rr("query"),t=new Date().toISOString();await r.execute(`INSERT INTO analytics_query (id, projectId, organizationId, name, description, type, definition, sql, cacheTtlSeconds, isShared, createdAt, updatedAt)
|
|
8
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,[N,m.projectId,m.organizationId,A.name,A.description??null,A.type,JSON.stringify(A.definition),A.sql??null,A.cacheTtlSeconds??300,A.isShared?1:0,t,t]);let P=(await r.query("SELECT * FROM analytics_query WHERE id = ?",[N])).rows;return Nr(P[0])}async function Y(A){let m=(await r.query("SELECT * FROM analytics_query WHERE id = ?",[A])).rows;return m[0]?Nr(m[0]):null}return{listDashboards:o,createDashboard:n,getDashboard:$,updateDashboard:y,getWidgets:c,addWidget:Q,updateWidget:k,deleteWidget:G,listQueries:L,createQuery:C,getQuery:Y}}import{defineEnum as zr}from"@contractspec/lib.schema";var or=zr("QueryType",["SQL","METRIC","AGGREGATION","CUSTOM"]);import{defineSchemaModel as mr,ScalarTypeEnum as D}from"@contractspec/lib.schema";var $r=mr({name:"QueryModel",fields:{id:{type:D.String_unsecure(),isOptional:!1},name:{type:D.String_unsecure(),isOptional:!1},description:{type:D.String_unsecure(),isOptional:!0},type:{type:or,isOptional:!1},definition:{type:D.JSON(),isOptional:!1},sql:{type:D.String_unsecure(),isOptional:!0},cacheTtlSeconds:{type:D.Int_unsecure(),isOptional:!1},isShared:{type:D.Boolean(),isOptional:!1},createdAt:{type:D.DateTime(),isOptional:!1}}}),Pr=mr({name:"QueryResultModel",fields:{queryId:{type:D.String_unsecure(),isOptional:!1},data:{type:D.JSON(),isOptional:!1},columns:{type:D.JSON(),isOptional:!1},rowCount:{type:D.Int_unsecure(),isOptional:!1},executionTimeMs:{type:D.Int_unsecure(),isOptional:!1},cachedAt:{type:D.DateTime(),isOptional:!0},error:{type:D.String_unsecure(),isOptional:!0}}}),Dr=mr({name:"CreateQueryInput",fields:{name:{type:D.NonEmptyString(),isOptional:!1},description:{type:D.String_unsecure(),isOptional:!0},type:{type:or,isOptional:!1},definition:{type:D.JSON(),isOptional:!1},sql:{type:D.String_unsecure(),isOptional:!0},metricIds:{type:D.String_unsecure(),isArray:!0,isOptional:!0},cacheTtlSeconds:{type:D.Int_unsecure(),isOptional:!0},isShared:{type:D.Boolean(),isOptional:!0}}}),Gr=mr({name:"ExecuteQueryInput",fields:{queryId:{type:D.String_unsecure(),isOptional:!1},parameters:{type:D.JSON(),isOptional:!0},dateRange:{type:D.JSON(),isOptional:!0},filters:{type:D.JSON(),isOptional:!0},forceRefresh:{type:D.Boolean(),isOptional:!0}}});import{defineCommand as er,defineQuery as jr}from"@contractspec/lib.contracts-spec/operations";var Hr=["@example.analytics-dashboard"],pr=er({meta:{key:"analytics.query.create",version:"1.0.0",stability:"stable",owners:[...Hr],tags:["analytics","query","create"],description:"Create a data query.",goal:"Define reusable data queries.",context:"Query builder."},io:{input:Dr,output:$r},policy:{auth:"user"},sideEffects:{emits:[{key:"analytics.query.created",version:"1.0.0",stability:"stable",owners:[...Hr],tags:["analytics","query","created"],when:"Query created",payload:$r}],audit:["analytics.query.created"]},acceptance:{scenarios:[{key:"create-query-happy-path",given:["User is authenticated"],when:["User submits valid query definition"],then:["Query is created","QueryCreated event is emitted"]}],examples:[{key:"create-sql-query",input:{name:"Monthly Revenue",sql:"SELECT SUM(amount) FROM orders WHERE date >= :startDate"},output:{id:"query-123",name:"Monthly Revenue",type:"sql"}}]}}),wr=jr({meta:{key:"analytics.query.execute",version:"1.0.0",stability:"stable",owners:[...Hr],tags:["analytics","query","execute"],description:"Execute a data query.",goal:"Fetch data for visualizations.",context:"Dashboard rendering."},io:{input:Gr,output:Pr},policy:{auth:"user"},acceptance:{scenarios:[{key:"execute-query-happy-path",given:["Query exists"],when:["User executes query with parameters"],then:["Query results are returned"]}],examples:[{key:"execute-with-params",input:{queryId:"query-123",params:{startDate:"2025-01-01"}},output:{columns:["total"],rows:[{total:50000}],rowCount:1}}]}});class Zr{cache=new Map;async get(r){let o=this.cache.get(r);if(!o)return null;if(o.expiresAt<new Date)return this.cache.delete(r),null;return{...o.result,cached:!0,cachedAt:o.expiresAt}}async set(r,o,n){let $=new Date(Date.now()+n*1000);this.cache.set(r,{result:o,expiresAt:$})}async invalidate(r){let o=new RegExp(r);for(let n of this.cache.keys())if(o.test(n))this.cache.delete(n)}}class qr{cache;constructor(r){this.cache=r??new Zr}async execute(r,o){let n=Date.now(),$=this.validateQuery(r);if(!$.valid)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:$.errors.join(", ")};let y=this.buildCacheKey(r,o),c=await this.cache.get(y);if(c)return c;let Q;switch(r.type){case"AGGREGATION":if(!r.aggregation)throw Error("Aggregation definition is missing");Q=await this.executeAggregation(r.aggregation,o);break;case"METRIC":if(!r.metricIds)throw Error("Metric IDs are missing");Q=await this.executeMetric(r.metricIds,o);break;case"SQL":if(!r.sql)throw Error("SQL query is missing");Q=await this.executeSql(r.sql,o);break;default:Q={data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:`Unknown query type: ${r.type}`}}return Q.executionTimeMs=Date.now()-n,Q.cached=!1,await this.cache.set(y,Q,300),Q}validateQuery(r){let o=[];if(!r.type)o.push("Query type is required");switch(r.type){case"SQL":if(!r.sql)o.push("SQL query is required for SQL type");break;case"METRIC":if(!r.metricIds||r.metricIds.length===0)o.push("Metric IDs are required for METRIC type");break;case"AGGREGATION":if(!r.aggregation)o.push("Aggregation definition is required for AGGREGATION type");else{if(!r.aggregation.source)o.push("Aggregation source is required");if(!r.aggregation.measures||r.aggregation.measures.length===0)o.push("At least one measure is required")}break}return{valid:o.length===0,errors:o}}buildCacheKey(r,o){return JSON.stringify({definition:r,params:o})}async executeAggregation(r,o){let n=[...r.dimensions.map((y)=>({name:y.name,type:y.type==="NUMBER"?"NUMBER":y.type==="TIME"?"DATE":"STRING",label:y.name})),...r.measures.map((y)=>({name:y.name,type:"NUMBER",label:y.name,format:y.format}))],$=this.generateMockData(r,o);return{data:$,columns:n,rowCount:$.length,executionTimeMs:0,cached:!1}}async executeMetric(r,o){let n=r.map(($)=>({metricId:$,value:Math.random()*1000,change:(Math.random()-0.5)*20}));return{data:n,columns:[{name:"metricId",type:"STRING"},{name:"value",type:"NUMBER"},{name:"change",type:"NUMBER"}],rowCount:n.length,executionTimeMs:0,cached:!1}}async executeSql(r,o){return{data:[],columns:[],rowCount:0,executionTimeMs:0,cached:!1,error:"SQL execution not implemented in demo"}}generateMockData(r,o){let n=[],$=10,y=r.dimensions.find((c)=>c.type==="TIME");for(let c=0;c<10;c++){let Q={};for(let k of r.dimensions)if(k.type==="TIME"){let G=new Date(o.dateRange?.start??new Date);G.setDate(G.getDate()+c),Q[k.name]=G.toISOString().split("T")[0]}else Q[k.name]=`${k.name}_${c%5}`;for(let k of r.measures){let G=y?100+c*10:Math.random()*1000,L=(Math.random()-0.5)*20;Q[k.name]=Math.round((G+L)*100)/100}n.push(Q)}return n}}function Ao(r){return new qr(r)}import{ComparisonView as br,TimelineView as sr,VisualizationCard as ir,VisualizationGrid as dr}from"@contractspec/lib.design-system";import{jsx as p,jsxs as yr}from"react/jsx-runtime";function Xr({dashboardName:r,widgets:o}){if(!o.length)return yr("div",{className:"rounded-lg border border-dashed p-10 text-center text-muted-foreground",children:['No visualization widgets configured for "',r,'".']});return yr("div",{children:[yr("h3",{className:"mb-4 font-semibold text-lg",children:['Widgets in "',r,'"']}),p(dr,{children:o.map((n)=>p("div",{className:rn(n.gridWidth),children:ar(n)},n.id))})]})}function ar(r){let o=yr("span",{className:"text-muted-foreground text-xs",children:["Position: (",r.gridX,", ",r.gridY,") \u2022 ",r.gridWidth,"x",r.gridHeight]});if(r.layout==="comparison")return p(br,{description:r.description,items:r.bindings.map(($)=>({...$,footer:o})),title:r.name});if(r.layout==="timeline")return p(sr,{description:r.description,items:r.bindings.map(($)=>({...$,footer:o})),title:r.name});let n=r.bindings[0];if(!n)return null;return p(ir,{data:n.data,description:r.description??n.description,footer:o,height:n.height,spec:n.spec,title:r.name})}function rn(r){if(r>=12)return"md:col-span-2 xl:col-span-3";if(r>=8)return"xl:col-span-2";if(r>=6)return"md:col-span-2";return""}import{DataTable as nn}from"@contractspec/lib.design-system";import{useContractTable as on}from"@contractspec/lib.presentation-runtime-react";import{Badge as Jr}from"@contractspec/lib.ui-kit-web/ui/badge";import{HStack as mn,VStack as w}from"@contractspec/lib.ui-kit-web/ui/stack";import{Text as v}from"@contractspec/lib.ui-kit-web/ui/text";import{jsx as q,jsxs as F}from"react/jsx-runtime";var $n={SQL:"default",METRIC:"secondary",AGGREGATION:"secondary",CUSTOM:"outline"};function yn(r){return JSON.stringify(r,null,2)}function Kr({queries:r}){let o=on({data:r,columns:[{id:"query",header:"Query",label:"Query",accessor:(n)=>n.name,cell:({item:n})=>F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:n.name}),F(v,{className:"text-muted-foreground text-xs",children:["Updated ",n.updatedAt.toLocaleDateString()]})]}),size:240,minSize:180,canSort:!0,canPin:!0,canResize:!0},{id:"description",header:"Description",label:"Description",accessor:(n)=>n.description??"",cell:({value:n})=>q(v,{className:"line-clamp-2 text-muted-foreground text-sm",children:String(n||"No description")}),size:300,minSize:220,canSort:!1,canHide:!0,canResize:!0},{id:"type",header:"Type",label:"Type",accessorKey:"type",cell:({value:n})=>q(Jr,{variant:$n[String(n)],children:String(n)}),size:150,canSort:!0,canHide:!0,canResize:!0},{id:"cacheTtlSeconds",header:"Cache TTL",label:"Cache TTL",accessorKey:"cacheTtlSeconds",cell:({value:n})=>`${String(n)}s`,align:"right",size:140,canSort:!0,canResize:!0},{id:"isShared",header:"Shared",label:"Shared",accessorKey:"isShared",cell:({value:n})=>q(Jr,{variant:n?"default":"outline",children:n?"Shared":"Private"}),size:140,canSort:!0,canHide:!0,canResize:!0}],initialState:{pagination:{pageIndex:0,pageSize:3},columnVisibility:{description:!1},columnPinning:{left:["query"],right:[]}},renderExpandedContent:(n)=>F(w,{gap:"sm",className:"py-2",children:[F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:"Description"}),q(v,{className:"text-muted-foreground text-sm",children:n.description??"No description"})]}),n.sql?F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:"SQL"}),q("pre",{className:"overflow-auto rounded-md bg-muted/40 p-3 text-xs",children:n.sql})]}):null,F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:"Definition"}),q("pre",{className:"overflow-auto rounded-md bg-muted/40 p-3 text-xs",children:yn(n.definition)})]})]}),getCanExpand:()=>!0});return q(nn,{controller:o,title:"Saved Queries",description:"Client-mode table using the shared ContractSpec controller and renderer.",toolbar:F(mn,{gap:"sm",className:"flex-wrap",children:[F(v,{className:"text-muted-foreground text-sm",children:[r.length," queries"]}),F(v,{className:"text-muted-foreground text-sm",children:[r.filter((n)=>n.isShared).length," shared"]})]}),emptyState:q("div",{className:"rounded-md border border-dashed p-8 text-center text-muted-foreground text-sm",children:"No queries saved"})})}import{useTemplateRuntime as cn}from"@contractspec/lib.example-shared-ui";import{useCallback as Cr,useEffect as An,useState as x}from"react";function Br(r="local-project"){let{handlers:o}=cn(),n=o.analytics,[$,y]=x([]),[c,Q]=x([]),[k,G]=x(null),[L,C]=x([]),[Y,A]=x(!0),[m,N]=x(null),t=Cr(async()=>{try{A(!0),N(null);let[H,O]=await Promise.all([n.listDashboards({projectId:r,limit:100}),n.listQueries({projectId:r,limit:100})]);if(y(H.dashboards),Q(O.queries),H.dashboards.length>0&&!k){let J=H.dashboards[0];if(J){G(J);let T=await n.getWidgets(J.id);C(T.length>0?T:u(J.id))}}}catch(H){N(H instanceof Error?H:Error("Failed to load analytics"))}finally{A(!1)}},[n,r,k]);An(()=>{t()},[t]);let P=Cr(async(H)=>{G(H);let O=await n.getWidgets(H.id);C(O.length>0?O:u(H.id))},[n]),W={totalDashboards:$.length,publishedDashboards:$.filter((H)=>H.status==="PUBLISHED").length,totalQueries:c.length,sharedQueries:c.filter((H)=>H.isShared).length};return{dashboards:$,queries:c,selectedDashboard:k,widgets:L,loading:Y,error:m,stats:W,refetch:t,selectDashboard:P}}import{Button as Wr,ErrorState as kn,LoaderBlock as tn,StatCard as Mr,StatCardGroup as Qn}from"@contractspec/lib.design-system";import{useMemo as Ln,useState as Nn}from"react";import{jsx as M,jsxs as X}from"react/jsx-runtime";var Pn={PUBLISHED:"bg-green-100 text-green-700 dark:bg-green-900/30 dark:text-green-400",DRAFT:"bg-gray-100 text-gray-700 dark:bg-gray-900/30 dark:text-gray-400",ARCHIVED:"bg-yellow-100 text-yellow-700 dark:bg-yellow-900/30 dark:text-yellow-400"};function Dn(){let[r,o]=Nn("dashboards"),{dashboards:n,queries:$,selectedDashboard:y,widgets:c,loading:Q,error:k,stats:G,refetch:L,selectDashboard:C}=Br(),Y=[{id:"dashboards",label:"Dashboards",icon:"\uD83D\uDCCA"},{id:"queries",label:"Queries",icon:"\uD83D\uDD0D"}],A=Ln(()=>c.map((m)=>j(m)).filter((m)=>Boolean(m)),[c]);if(Q)return M(tn,{label:"Loading Analytics..."});if(k)return M(kn,{title:"Failed to load Analytics",description:k.message,onRetry:L,retryLabel:"Retry"});return X("div",{className:"space-y-6",children:[X("div",{className:"flex items-center justify-between",children:[M("h2",{className:"font-bold text-2xl",children:"Analytics Dashboard"}),X(Wr,{onClick:()=>alert("Create dashboard modal"),children:[M("span",{className:"mr-2",children:"+"})," New Dashboard"]})]}),X(Qn,{children:[M(Mr,{label:"Dashboards",value:G.totalDashboards,hint:`${G.publishedDashboards} published`}),M(Mr,{label:"Queries",value:G.totalQueries,hint:`${G.sharedQueries} shared`}),M(Mr,{label:"Widgets",value:c.length,hint:"on current dashboard"})]}),M("nav",{className:"flex gap-1 rounded-lg bg-muted p-1",role:"tablist",children:Y.map((m)=>X(Wr,{type:"button",role:"tab","aria-selected":r===m.id,onClick:()=>o(m.id),className:`flex flex-1 items-center justify-center gap-2 rounded-md px-4 py-2 font-medium text-sm transition-colors ${r===m.id?"bg-background text-foreground shadow-sm":"text-muted-foreground hover:text-foreground"}`,children:[M("span",{children:m.icon}),m.label]},m.id))}),X("div",{className:"min-h-[400px]",role:"tabpanel",children:[r==="dashboards"&&X("div",{className:"space-y-6",children:[X("div",{className:"grid gap-4 sm:grid-cols-2 lg:grid-cols-3",children:[n.map((m)=>X("div",{onClick:()=>C(m),className:`cursor-pointer rounded-lg border border-border bg-card p-4 transition-all ${y?.id===m.id?"ring-2 ring-primary":"hover:bg-muted/50"}`,role:"button",tabIndex:0,onKeyDown:(N)=>{if(N.key==="Enter"||N.key===" ")C(m)},children:[X("div",{className:"mb-2 flex items-center justify-between",children:[M("h3",{className:"font-medium",children:m.name}),M("span",{className:`inline-flex rounded-full px-2 py-0.5 font-medium text-xs ${Pn[m.status]??""}`,children:m.status})]}),M("p",{className:"mb-3 text-muted-foreground text-sm",children:m.description}),X("div",{className:"flex items-center justify-between text-muted-foreground text-xs",children:[X("span",{children:["/",m.slug]}),m.isPublic&&M("span",{className:"text-green-600 dark:text-green-400",children:"\uD83C\uDF10 Public"})]})]},m.id)),n.length===0&&M("div",{className:"col-span-full flex h-64 items-center justify-center text-muted-foreground",children:"No dashboards created yet"})]}),y?M(Xr,{dashboardName:y.name,widgets:A}):null]}),r==="queries"&&M(Kr,{queries:$})]})]})}var cr=[{id:"dash-1",name:"Sales Overview",slug:"sales-overview",status:"PUBLISHED",widgetCount:11,viewCount:1250,lastViewedAt:"2026-03-18T12:00:00Z"},{id:"dash-2",name:"User Engagement",slug:"user-engagement",status:"PUBLISHED",widgetCount:8,viewCount:890,lastViewedAt:"2026-03-18T10:00:00Z"}],vr=[{id:"q-1",name:"Monthly Revenue",type:"AGGREGATION",isShared:!0,executionCount:1500},{id:"q-2",name:"User Growth",type:"METRIC",isShared:!0,executionCount:890},{id:"q-3",name:"Product Sales",type:"SQL",isShared:!1,executionCount:340},{id:"q-4",name:"Conversion Funnel",type:"AGGREGATION",isShared:!0,executionCount:450}];function Gn(r){return u(r).map((o)=>j(o)).filter((o)=>Boolean(o))}var Hn={target:"markdown",render:async(r)=>{if(r.source.type!=="component"||r.source.componentKey!=="AnalyticsDashboard")throw Error("analyticsDashboardMarkdownRenderer: not AnalyticsDashboard");let o=cr[0];if(!o)return{mimeType:"text/markdown",body:`# No Dashboards
|
|
9
9
|
|
|
10
|
-
No dashboards available.`};let n=
|
|
11
|
-
`)}}},
|
|
12
|
-
`)}}},
|
|
13
|
-
`)}}};export{B as visualizationRefKey,Br as useAnalyticsData,j as resolveAnalyticsWidget,Z as refOf,
|
|
10
|
+
No dashboards available.`};let n=Gn(o.id),$=n.filter((c)=>c.bindings[0]?.spec.visualization.kind==="metric"),y=[`# ${o.name}`,"","> Contract-backed analytics dashboard overview.","","## Key Metrics",""];for(let c of $){let Q=c.bindings[0];if(!Q)continue;y.push(`- **${c.name}** via \`${Q.spec.meta.key}\``)}y.push(""),y.push("## Visual Blocks"),y.push("");for(let c of n){let Q=c.bindings.map((k)=>k.spec.visualization.kind).join(", ");y.push(`- **${c.name}** (${c.layout}) \u2192 ${Q}`)}return y.push(""),y.push("## Dashboard Stats"),y.push(""),y.push("| Metric | Value |"),y.push("|--------|-------|"),y.push(`| Total Dashboards | ${cr.length} |`),y.push(`| Published | ${cr.filter((c)=>c.status==="PUBLISHED").length} |`),y.push(`| Shared Queries | ${vr.filter((c)=>c.isShared).length} |`),{mimeType:"text/markdown",body:y.join(`
|
|
11
|
+
`)}}},Bn={target:"markdown",render:async(r)=>{if(r.source.type!=="component"||r.source.componentKey!=="DashboardList")throw Error("dashboardListMarkdownRenderer: not DashboardList");let o=["# Dashboards","","> Browse and manage analytics dashboards","","| Dashboard | Widgets | Views | Status | Last Viewed |","|-----------|---------|-------|--------|-------------|"];for(let n of cr){let $=n.lastViewedAt?new Date(n.lastViewedAt).toLocaleDateString():"Never",y=n.status==="PUBLISHED"?"\uD83D\uDFE2":"\u26AB";o.push(`| [${n.name}](/dashboards/${n.slug}) | ${n.widgetCount} | ${n.viewCount.toLocaleString()} | ${y} ${n.status} | ${$} |`)}return{mimeType:"text/markdown",body:o.join(`
|
|
12
|
+
`)}}},Mn={target:"markdown",render:async(r)=>{if(r.source.type!=="component"||r.source.componentKey!=="QueryBuilder")throw Error("queryBuilderMarkdownRenderer: not QueryBuilder");let o=["# Query Builder","","> Create and manage reusable data queries.","","| Query | Type | Shared | Executions |","|-------|------|--------|------------|"];for(let n of vr)o.push(`| ${n.name} | ${n.type} | ${n.isShared?"\uD83C\uDF10":"\uD83D\uDD12"} | ${n.executionCount.toLocaleString()} |`);return o.push(""),o.push("## Visualization Contracts"),o.push(""),o.push("Widgets reference `VisualizationSpec` contracts instead of rendering ad-hoc widget types."),{mimeType:"text/markdown",body:o.join(`
|
|
13
|
+
`)}}};export{B as visualizationRefKey,Br as useAnalyticsData,j as resolveAnalyticsWidget,Z as refOf,Mn as queryBuilderMarkdownRenderer,Bn as dashboardListMarkdownRenderer,Ao as createQueryEngine,Sr as createPosthogQueryEngine,u as createExampleWidgets,jn as createAnalyticsHandlers,Hn as analyticsDashboardMarkdownRenderer,f as RevenueTrendVisualization,I as RevenueMetricVisualization,S as RetentionAreaVisualization,h as RegionalRevenueVisualization,or as QueryTypeEnum,Pr as QueryResultModel,$r as QueryModel,Qr as PosthogQueryEngine,V as PipelineScatterVisualization,Zr as InMemoryQueryCache,Gr as ExecuteQueryInputModel,wr as ExecuteQueryContract,Tr as ExamplesAnalyticsDashboardExample,g as EngagementHeatmapVisualization,Dr as CreateQueryInputModel,pr as CreateQueryContract,_ as ConversionFunnelVisualization,R as ChannelMixVisualization,qr as BasicQueryEngine,d as AnalyticsVisualizationSpecs,kr as AnalyticsVisualizationSpecMap,a as AnalyticsVisualizationSampleData,Yr as AnalyticsVisualizationRegistry,Ar as AnalyticsVisualizationRefs,Vn as AnalyticsDashboardFeature,Dn as AnalyticsDashboard,E as AccountCoverageGeoVisualization};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{defineVisualization as O}from"@contractspec/lib.contracts-spec/visualizations";var _={key:"analytics.query.execute",version:"1.0.0"},C={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},m=O({meta:{...C,key:"analytics.visualization.channel-mix",title:"Channel Mix",description:"Session distribution across acquisition channels.",goal:"Explain which channels currently drive the largest share of traffic.",context:"Marketing attribution dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"pie",nameDimension:"channel",valueMeasure:"sessions",dimensions:[{key:"channel",label:"Channel",dataPath:"channel",type:"category"}],measures:[{key:"sessions",label:"Sessions",dataPath:"sessions"}],table:{caption:"Sessions by acquisition channel."}}}),G=O({meta:{...C,key:"analytics.visualization.engagement-heatmap",title:"Engagement Heatmap",description:"Average engagement score by weekday and time band.",goal:"Reveal the highest-engagement time windows for product activity.",context:"Usage analytics dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"heatmap",xDimension:"timeBand",yDimension:"weekday",valueMeasure:"engagementScore",dimensions:[{key:"timeBand",label:"Time Band",dataPath:"timeBand",type:"category"},{key:"weekday",label:"Weekday",dataPath:"weekday",type:"category"}],measures:[{key:"engagementScore",label:"Engagement",dataPath:"engagementScore"}],table:{caption:"Engagement score by weekday and time band."}}}),D=O({meta:{...C,key:"analytics.visualization.conversion-funnel",title:"Conversion Funnel",description:"Progression through the main acquisition funnel.",goal:"Show where the product is losing the largest share of prospects.",context:"Growth dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"funnel",nameDimension:"stage",valueMeasure:"users",sort:"descending",dimensions:[{key:"stage",label:"Stage",dataPath:"stage",type:"category"}],measures:[{key:"users",label:"Users",dataPath:"users"}],table:{caption:"Users per conversion stage."}}}),L=O({meta:{...C,key:"analytics.visualization.account-coverage-geo",title:"Account Coverage",description:"High-value accounts plotted on a slippy-map surface.",goal:"Locate where active commercial concentration is strongest.",context:"Territory coverage dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"geo",mode:"slippy-map",variant:"scatter",nameDimension:"city",latitudeDimension:"latitude",longitudeDimension:"longitude",valueMeasure:"accounts",dimensions:[{key:"city",label:"City",dataPath:"city",type:"category"},{key:"latitude",label:"Latitude",dataPath:"latitude",type:"latitude"},{key:"longitude",label:"Longitude",dataPath:"longitude",type:"longitude"}],measures:[{key:"accounts",label:"Accounts",dataPath:"accounts"}],table:{caption:"Account concentration by city."}}});import{defineVisualization as S}from"@contractspec/lib.contracts-spec/visualizations";var K={key:"analytics.query.execute",version:"1.0.0"},Q={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},X=S({meta:{...Q,key:"analytics.visualization.revenue-metric",title:"Revenue Snapshot",description:"Current recurring revenue with prior-period comparison.",goal:"Highlight the headline commercial metric for the dashboard.",context:"Executive revenue overview."},source:{primary:K,resultPath:"data"},visualization:{kind:"metric",measure:"totalRevenue",comparisonMeasure:"priorRevenue",dimensions:[{key:"period",label:"Period",dataPath:"period",type:"time"}],measures:[{key:"totalRevenue",label:"Revenue",dataPath:"totalRevenue",format:"currency"},{key:"priorRevenue",label:"Prior Revenue",dataPath:"priorRevenue",format:"currency"}],sparkline:{dimension:"period",measure:"totalRevenue"},table:{caption:"Revenue trend and prior period values."}}}),N=S({meta:{...Q,key:"analytics.visualization.revenue-trend",title:"Revenue Trend",description:"Monthly revenue progression for the current quarter.",goal:"Track whether revenue growth is accelerating or stalling.",context:"Quarterly commercial dashboard."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"line",xDimension:"date",yMeasures:["revenue"],dimensions:[{key:"date",label:"Month",dataPath:"date",type:"time"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#0f766e"}],thresholds:[{key:"target",value:140000,label:"Target",color:"#dc2626"}],table:{caption:"Monthly revenue values."}}}),W=S({meta:{...Q,key:"analytics.visualization.regional-revenue",title:"Regional Revenue",description:"Revenue split by sales territory.",goal:"Compare the strongest and weakest performing territories.",context:"Territory planning and commercial comparison."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"bar",xDimension:"region",yMeasures:["revenue"],dimensions:[{key:"region",label:"Region",dataPath:"region",type:"category"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#1d4ed8"}],table:{caption:"Revenue by region."}}}),Z=S({meta:{...Q,key:"analytics.visualization.retention-area",title:"Retention Curve",description:"Weekly retention progression across the active cohort.",goal:"Show whether user retention remains above the desired floor.",context:"Product health dashboard."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"area",xDimension:"week",yMeasures:["retentionRate"],dimensions:[{key:"week",label:"Week",dataPath:"week",type:"category"}],measures:[{key:"retentionRate",label:"Retention",dataPath:"retentionRate",format:"percentage",color:"#16a34a"}],thresholds:[{key:"floor",value:0.5,label:"Floor",color:"#f59e0b"}],table:{caption:"Weekly retention rate."}}}),H=S({meta:{...Q,key:"analytics.visualization.pipeline-scatter",title:"Pipeline Velocity",description:"Deal-cycle length against win rate for active accounts.",goal:"Spot outliers where the sales cycle is long but conversion remains weak.",context:"Commercial operations dashboard."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"scatter",xDimension:"cycleDays",yMeasures:["winRate"],dimensions:[{key:"cycleDays",label:"Cycle Days",dataPath:"cycleDays",type:"number"}],measures:[{key:"winRate",label:"Win Rate",dataPath:"winRate",format:"percentage",color:"#7c3aed"},{key:"arr",label:"ARR",dataPath:"arr",format:"currency"}],series:[{key:"pipeline",label:"Accounts",measure:"winRate",type:"scatter",color:"#7c3aed"}],table:{caption:"Sales cycle and win rate per account."}}});import{VisualizationRegistry as p}from"@contractspec/lib.contracts-spec/visualizations";var Y=[X,N,W,Z,H,m,G,D,L],v=new p([...Y]),T=Y.map((x)=>J(x)),A=new Map(Y.map((x)=>[q(x.meta),x])),y={[q(X.meta)]:{data:[{period:"2025-11-01",totalRevenue:112000,priorRevenue:103000},{period:"2025-12-01",totalRevenue:119000,priorRevenue:110000},{period:"2026-01-01",totalRevenue:126500,priorRevenue:116000},{period:"2026-02-01",totalRevenue:133000,priorRevenue:124000},{period:"2026-03-01",totalRevenue:145500,priorRevenue:133000}]},[q(N.meta)]:{data:[{date:"2025-11-01",revenue:112000},{date:"2025-12-01",revenue:119000},{date:"2026-01-01",revenue:126500},{date:"2026-02-01",revenue:133000},{date:"2026-03-01",revenue:145500}]},[q(W.meta)]:{data:[{region:"North America",revenue:210000},{region:"EMEA",revenue:174000},{region:"APAC",revenue:132000},{region:"LATAM",revenue:88000}]},[q(Z.meta)]:{data:[{week:"Week 1",retentionRate:0.71},{week:"Week 2",retentionRate:0.66},{week:"Week 3",retentionRate:0.62},{week:"Week 4",retentionRate:0.58},{week:"Week 5",retentionRate:0.55},{week:"Week 6",retentionRate:0.53}]},[q(H.meta)]:{data:[{cycleDays:18,winRate:0.31,arr:82000},{cycleDays:26,winRate:0.44,arr:65000},{cycleDays:33,winRate:0.27,arr:91000},{cycleDays:14,winRate:0.56,arr:47000},{cycleDays:21,winRate:0.48,arr:59000},{cycleDays:39,winRate:0.22,arr:114000}]},[q(m.meta)]:{data:[{channel:"Direct",sessions:4200},{channel:"Organic Search",sessions:3600},{channel:"Paid Search",sessions:2100},{channel:"Partner",sessions:1400},{channel:"Referral",sessions:900}]},[q(G.meta)]:{data:[{weekday:"Mon",timeBand:"09:00",engagementScore:74},{weekday:"Mon",timeBand:"13:00",engagementScore:82},{weekday:"Tue",timeBand:"09:00",engagementScore:69},{weekday:"Tue",timeBand:"13:00",engagementScore:88},{weekday:"Wed",timeBand:"09:00",engagementScore:77},{weekday:"Wed",timeBand:"13:00",engagementScore:91},{weekday:"Thu",timeBand:"09:00",engagementScore:72},{weekday:"Thu",timeBand:"13:00",engagementScore:86},{weekday:"Fri",timeBand:"09:00",engagementScore:65},{weekday:"Fri",timeBand:"13:00",engagementScore:79}]},[q(D.meta)]:{data:[{stage:"Visited Site",users:12000},{stage:"Started Trial",users:4200},{stage:"Activated Workspace",users:2400},{stage:"Requested Demo",users:980},{stage:"Closed Won",users:310}]},[q(L.meta)]:{data:[{city:"Paris",latitude:48.8566,longitude:2.3522,accounts:48},{city:"London",latitude:51.5072,longitude:-0.1276,accounts:62},{city:"New York",latitude:40.7128,longitude:-74.006,accounts:71},{city:"Toronto",latitude:43.6532,longitude:-79.3832,accounts:36},{city:"Singapore",latitude:1.3521,longitude:103.8198,accounts:29}]}};function J(x){return{key:x.meta.key,version:x.meta.version}}function q(x){return`${x.key}.v${x.version}`}var h={METRIC:J(X),LINE_CHART:J(N),BAR_CHART:J(W),AREA_CHART:J(Z),SCATTER_PLOT:J(H),PIE_CHART:J(m),HEATMAP:J(G),FUNNEL:J(D),MAP:J(L)};function V(x){return[$(x,"widget_revenue_metric","Revenue Snapshot","METRIC",0,0,4,2,{layout:"single",bindings:[B(X,200)]}),$(x,"widget_revenue_trend","Revenue Trend","LINE_CHART",4,0,8,4,{layout:"single",bindings:[B(N)]}),$(x,"widget_regional_revenue","Regional Revenue","BAR_CHART",0,2,6,4,{layout:"single",bindings:[B(W)]}),$(x,"widget_channel_mix","Channel Mix","PIE_CHART",6,2,6,4,{layout:"single",bindings:[B(m)]}),$(x,"widget_retention","Retention Curve","AREA_CHART",0,6,6,4,{layout:"single",bindings:[B(Z)]}),$(x,"widget_pipeline","Pipeline Velocity","SCATTER_PLOT",6,6,6,4,{layout:"single",bindings:[B(H)]}),$(x,"widget_heatmap","Engagement Heatmap","HEATMAP",0,10,8,4,{layout:"single",bindings:[B(G)]}),$(x,"widget_funnel","Conversion Funnel","FUNNEL",8,10,4,4,{layout:"single",bindings:[B(D)]}),$(x,"widget_geo","Account Coverage","MAP",0,14,12,5,{layout:"single",bindings:[B(L,360)]}),$(x,"widget_comparison","Commercial Comparison","EMBED",0,19,12,6,{layout:"comparison",description:"Compare regional distribution, channel balance, and funnel shape.",bindings:[B(W,240),B(m,240),B(D,240)]}),$(x,"widget_timeline","Growth Timeline","EMBED",0,25,12,6,{layout:"timeline",description:"Track revenue and retention over the same reporting cadence.",bindings:[B(N,220),B(Z,220)]})]}function R(x){let j=f(x),U=j.bindings.map((k)=>{let P=A.get(q(k.ref));if(!P)return null;return{key:`${x.id}:${q(k.ref)}`,spec:P,data:k.data,title:k.title??P.meta.title,description:k.description??P.meta.description,height:k.height}}).filter((k)=>Boolean(k));if(!U.length)return null;return{id:x.id,name:x.name,description:j.description,layout:j.layout,gridX:x.gridX,gridY:x.gridY,gridWidth:x.gridWidth,gridHeight:x.gridHeight,bindings:U}}function f(x){if(z(x.config))return x.config;let j=h[x.type];return j?{layout:"single",bindings:[{ref:j,data:y[q(j)]}]}:{layout:"single",bindings:[]}}function B(x,j=280){return{ref:J(x),data:y[q(x.meta)],height:j}}function $(x,j,U,k,P,M,w,I,E){let F=new Date;return{id:j,dashboardId:x,name:U,type:k,gridX:P,gridY:M,gridWidth:w,gridHeight:I,config:E,createdAt:F,updatedAt:F}}function z(x){if(!x||typeof x!=="object")return!1;let j=x;return(j.layout==="single"||j.layout==="comparison"||j.layout==="timeline")&&Array.isArray(j.bindings)}import{defineFeature as b}from"@contractspec/lib.contracts-spec";var kx=b({meta:{key:"analytics-dashboard",version:"1.0.0",title:"Analytics Dashboard",description:"Analytics dashboards with customizable widgets and queries",domain:"analytics",owners:["@analytics-dashboard"],tags:["analytics","dashboards","widgets","queries"],stability:"experimental"},operations:[{key:"analytics.dashboard.create",version:"1.0.0"},{key:"analytics.dashboard.list",version:"1.0.0"},{key:"analytics.dashboard.get",version:"1.0.0"},{key:"analytics.widget.add",version:"1.0.0"},{key:"analytics.query.create",version:"1.0.0"},{key:"analytics.query.execute",version:"1.0.0"}],events:[{key:"analytics.dashboard.created",version:"1.0.0"},{key:"analytics.widget.added",version:"1.0.0"},{key:"analytics.query.created",version:"1.0.0"}],presentations:[{key:"analytics.dashboard.viewList",version:"1.0.0"},{key:"analytics.dashboard.view",version:"1.0.0"},{key:"analytics.dashboard.editor",version:"1.0.0"},{key:"analytics.query.list",version:"1.0.0"},{key:"analytics.query.builder",version:"1.0.0"}],visualizations:[...T],opToPresentation:[{op:{key:"analytics.dashboard.list",version:"1.0.0"},pres:{key:"analytics.dashboard.viewList",version:"1.0.0"}},{op:{key:"analytics.dashboard.get",version:"1.0.0"},pres:{key:"analytics.dashboard.view",version:"1.0.0"}},{op:{key:"analytics.dashboard.create",version:"1.0.0"},pres:{key:"analytics.dashboard.editor",version:"1.0.0"}},{op:{key:"analytics.query.create",version:"1.0.0"},pres:{key:"analytics.query.builder",version:"1.0.0"}}],presentationsTargets:[{key:"analytics.dashboard.viewList",version:"1.0.0",targets:["react","markdown","application/json"]},{key:"analytics.dashboard.view",version:"1.0.0",targets:["react","markdown"]},{key:"analytics.dashboard.editor",version:"1.0.0",targets:["react"]},{key:"analytics.query.builder",version:"1.0.0",targets:["react"]}],capabilities:{requires:[{key:"identity",version:"1.0.0"},{key:"metering",version:"1.0.0"},{key:"audit-trail",version:"1.0.0"}]},telemetry:[{key:"analytics-dashboard.telemetry",version:"1.0.0"}],docs:["docs.examples.analytics-dashboard","docs.examples.analytics-dashboard.goal","docs.examples.analytics-dashboard.usage","docs.examples.analytics-dashboard.constraints"]});export{kx as AnalyticsDashboardFeature};
|
|
1
|
+
import{defineVisualization as O}from"@contractspec/lib.contracts-spec/visualizations";var _={key:"analytics.query.execute",version:"1.0.0"},C={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},m=O({meta:{...C,key:"analytics.visualization.channel-mix",title:"Channel Mix",description:"Session distribution across acquisition channels.",goal:"Explain which channels currently drive the largest share of traffic.",context:"Marketing attribution dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"pie",nameDimension:"channel",valueMeasure:"sessions",dimensions:[{key:"channel",label:"Channel",dataPath:"channel",type:"category"}],measures:[{key:"sessions",label:"Sessions",dataPath:"sessions"}],table:{caption:"Sessions by acquisition channel."}}}),G=O({meta:{...C,key:"analytics.visualization.engagement-heatmap",title:"Engagement Heatmap",description:"Average engagement score by weekday and time band.",goal:"Reveal the highest-engagement time windows for product activity.",context:"Usage analytics dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"heatmap",xDimension:"timeBand",yDimension:"weekday",valueMeasure:"engagementScore",dimensions:[{key:"timeBand",label:"Time Band",dataPath:"timeBand",type:"category"},{key:"weekday",label:"Weekday",dataPath:"weekday",type:"category"}],measures:[{key:"engagementScore",label:"Engagement",dataPath:"engagementScore"}],table:{caption:"Engagement score by weekday and time band."}}}),D=O({meta:{...C,key:"analytics.visualization.conversion-funnel",title:"Conversion Funnel",description:"Progression through the main acquisition funnel.",goal:"Show where the product is losing the largest share of prospects.",context:"Growth dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"funnel",nameDimension:"stage",valueMeasure:"users",sort:"descending",dimensions:[{key:"stage",label:"Stage",dataPath:"stage",type:"category"}],measures:[{key:"users",label:"Users",dataPath:"users"}],table:{caption:"Users per conversion stage."}}}),L=O({meta:{...C,key:"analytics.visualization.account-coverage-geo",title:"Account Coverage",description:"High-value accounts plotted on a slippy-map surface.",goal:"Locate where active commercial concentration is strongest.",context:"Territory coverage dashboard."},source:{primary:_,resultPath:"data"},visualization:{kind:"geo",mode:"slippy-map",variant:"scatter",nameDimension:"city",latitudeDimension:"latitude",longitudeDimension:"longitude",valueMeasure:"accounts",dimensions:[{key:"city",label:"City",dataPath:"city",type:"category"},{key:"latitude",label:"Latitude",dataPath:"latitude",type:"latitude"},{key:"longitude",label:"Longitude",dataPath:"longitude",type:"longitude"}],measures:[{key:"accounts",label:"Accounts",dataPath:"accounts"}],table:{caption:"Account concentration by city."}}});import{defineVisualization as S}from"@contractspec/lib.contracts-spec/visualizations";var K={key:"analytics.query.execute",version:"1.0.0"},Q={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},X=S({meta:{...Q,key:"analytics.visualization.revenue-metric",title:"Revenue Snapshot",description:"Current recurring revenue with prior-period comparison.",goal:"Highlight the headline commercial metric for the dashboard.",context:"Executive revenue overview."},source:{primary:K,resultPath:"data"},visualization:{kind:"metric",measure:"totalRevenue",comparisonMeasure:"priorRevenue",dimensions:[{key:"period",label:"Period",dataPath:"period",type:"time"}],measures:[{key:"totalRevenue",label:"Revenue",dataPath:"totalRevenue",format:"currency"},{key:"priorRevenue",label:"Prior Revenue",dataPath:"priorRevenue",format:"currency"}],sparkline:{dimension:"period",measure:"totalRevenue"},table:{caption:"Revenue trend and prior period values."}}}),N=S({meta:{...Q,key:"analytics.visualization.revenue-trend",title:"Revenue Trend",description:"Monthly revenue progression for the current quarter.",goal:"Track whether revenue growth is accelerating or stalling.",context:"Quarterly commercial dashboard."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"line",xDimension:"date",yMeasures:["revenue"],dimensions:[{key:"date",label:"Month",dataPath:"date",type:"time"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#0f766e"}],thresholds:[{key:"target",value:140000,label:"Target",color:"#dc2626"}],table:{caption:"Monthly revenue values."}}}),W=S({meta:{...Q,key:"analytics.visualization.regional-revenue",title:"Regional Revenue",description:"Revenue split by sales territory.",goal:"Compare the strongest and weakest performing territories.",context:"Territory planning and commercial comparison."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"bar",xDimension:"region",yMeasures:["revenue"],dimensions:[{key:"region",label:"Region",dataPath:"region",type:"category"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#1d4ed8"}],table:{caption:"Revenue by region."}}}),Z=S({meta:{...Q,key:"analytics.visualization.retention-area",title:"Retention Curve",description:"Weekly retention progression across the active cohort.",goal:"Show whether user retention remains above the desired floor.",context:"Product health dashboard."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"area",xDimension:"week",yMeasures:["retentionRate"],dimensions:[{key:"week",label:"Week",dataPath:"week",type:"category"}],measures:[{key:"retentionRate",label:"Retention",dataPath:"retentionRate",format:"percentage",color:"#16a34a"}],thresholds:[{key:"floor",value:0.5,label:"Floor",color:"#f59e0b"}],table:{caption:"Weekly retention rate."}}}),H=S({meta:{...Q,key:"analytics.visualization.pipeline-scatter",title:"Pipeline Velocity",description:"Deal-cycle length against win rate for active accounts.",goal:"Spot outliers where the sales cycle is long but conversion remains weak.",context:"Commercial operations dashboard."},source:{primary:K,resultPath:"data"},visualization:{kind:"cartesian",variant:"scatter",xDimension:"cycleDays",yMeasures:["winRate"],dimensions:[{key:"cycleDays",label:"Cycle Days",dataPath:"cycleDays",type:"number"}],measures:[{key:"winRate",label:"Win Rate",dataPath:"winRate",format:"percentage",color:"#7c3aed"},{key:"arr",label:"ARR",dataPath:"arr",format:"currency"}],series:[{key:"pipeline",label:"Accounts",measure:"winRate",type:"scatter",color:"#7c3aed"}],table:{caption:"Sales cycle and win rate per account."}}});import{VisualizationRegistry as p}from"@contractspec/lib.contracts-spec/visualizations";var Y=[X,N,W,Z,H,m,G,D,L],v=new p([...Y]),T=Y.map((x)=>J(x)),A=new Map(Y.map((x)=>[q(x.meta),x])),y={[q(X.meta)]:{data:[{period:"2025-11-01",totalRevenue:112000,priorRevenue:103000},{period:"2025-12-01",totalRevenue:119000,priorRevenue:110000},{period:"2026-01-01",totalRevenue:126500,priorRevenue:116000},{period:"2026-02-01",totalRevenue:133000,priorRevenue:124000},{period:"2026-03-01",totalRevenue:145500,priorRevenue:133000}]},[q(N.meta)]:{data:[{date:"2025-11-01",revenue:112000},{date:"2025-12-01",revenue:119000},{date:"2026-01-01",revenue:126500},{date:"2026-02-01",revenue:133000},{date:"2026-03-01",revenue:145500}]},[q(W.meta)]:{data:[{region:"North America",revenue:210000},{region:"EMEA",revenue:174000},{region:"APAC",revenue:132000},{region:"LATAM",revenue:88000}]},[q(Z.meta)]:{data:[{week:"Week 1",retentionRate:0.71},{week:"Week 2",retentionRate:0.66},{week:"Week 3",retentionRate:0.62},{week:"Week 4",retentionRate:0.58},{week:"Week 5",retentionRate:0.55},{week:"Week 6",retentionRate:0.53}]},[q(H.meta)]:{data:[{cycleDays:18,winRate:0.31,arr:82000},{cycleDays:26,winRate:0.44,arr:65000},{cycleDays:33,winRate:0.27,arr:91000},{cycleDays:14,winRate:0.56,arr:47000},{cycleDays:21,winRate:0.48,arr:59000},{cycleDays:39,winRate:0.22,arr:114000}]},[q(m.meta)]:{data:[{channel:"Direct",sessions:4200},{channel:"Organic Search",sessions:3600},{channel:"Paid Search",sessions:2100},{channel:"Partner",sessions:1400},{channel:"Referral",sessions:900}]},[q(G.meta)]:{data:[{weekday:"Mon",timeBand:"09:00",engagementScore:74},{weekday:"Mon",timeBand:"13:00",engagementScore:82},{weekday:"Tue",timeBand:"09:00",engagementScore:69},{weekday:"Tue",timeBand:"13:00",engagementScore:88},{weekday:"Wed",timeBand:"09:00",engagementScore:77},{weekday:"Wed",timeBand:"13:00",engagementScore:91},{weekday:"Thu",timeBand:"09:00",engagementScore:72},{weekday:"Thu",timeBand:"13:00",engagementScore:86},{weekday:"Fri",timeBand:"09:00",engagementScore:65},{weekday:"Fri",timeBand:"13:00",engagementScore:79}]},[q(D.meta)]:{data:[{stage:"Visited Site",users:12000},{stage:"Started Trial",users:4200},{stage:"Activated Workspace",users:2400},{stage:"Requested Demo",users:980},{stage:"Closed Won",users:310}]},[q(L.meta)]:{data:[{city:"Paris",latitude:48.8566,longitude:2.3522,accounts:48},{city:"London",latitude:51.5072,longitude:-0.1276,accounts:62},{city:"New York",latitude:40.7128,longitude:-74.006,accounts:71},{city:"Toronto",latitude:43.6532,longitude:-79.3832,accounts:36},{city:"Singapore",latitude:1.3521,longitude:103.8198,accounts:29}]}};function J(x){return{key:x.meta.key,version:x.meta.version}}function q(x){return`${x.key}.v${x.version}`}var h={METRIC:J(X),LINE_CHART:J(N),BAR_CHART:J(W),AREA_CHART:J(Z),SCATTER_PLOT:J(H),PIE_CHART:J(m),HEATMAP:J(G),FUNNEL:J(D),MAP:J(L)};function V(x){return[$(x,"widget_revenue_metric","Revenue Snapshot","METRIC",0,0,4,2,{layout:"single",bindings:[B(X,200)]}),$(x,"widget_revenue_trend","Revenue Trend","LINE_CHART",4,0,8,4,{layout:"single",bindings:[B(N)]}),$(x,"widget_regional_revenue","Regional Revenue","BAR_CHART",0,2,6,4,{layout:"single",bindings:[B(W)]}),$(x,"widget_channel_mix","Channel Mix","PIE_CHART",6,2,6,4,{layout:"single",bindings:[B(m)]}),$(x,"widget_retention","Retention Curve","AREA_CHART",0,6,6,4,{layout:"single",bindings:[B(Z)]}),$(x,"widget_pipeline","Pipeline Velocity","SCATTER_PLOT",6,6,6,4,{layout:"single",bindings:[B(H)]}),$(x,"widget_heatmap","Engagement Heatmap","HEATMAP",0,10,8,4,{layout:"single",bindings:[B(G)]}),$(x,"widget_funnel","Conversion Funnel","FUNNEL",8,10,4,4,{layout:"single",bindings:[B(D)]}),$(x,"widget_geo","Account Coverage","MAP",0,14,12,5,{layout:"single",bindings:[B(L,360)]}),$(x,"widget_comparison","Commercial Comparison","EMBED",0,19,12,6,{layout:"comparison",description:"Compare regional distribution, channel balance, and funnel shape.",bindings:[B(W,240),B(m,240),B(D,240)]}),$(x,"widget_timeline","Growth Timeline","EMBED",0,25,12,6,{layout:"timeline",description:"Track revenue and retention over the same reporting cadence.",bindings:[B(N,220),B(Z,220)]})]}function R(x){let j=z(x),U=j.bindings.map((k)=>{let P=A.get(q(k.ref));if(!P)return null;return{key:`${x.id}:${q(k.ref)}`,spec:P,data:k.data,title:k.title??P.meta.title,description:k.description??P.meta.description,height:k.height}}).filter((k)=>Boolean(k));if(!U.length)return null;return{id:x.id,name:x.name,description:j.description,layout:j.layout,gridX:x.gridX,gridY:x.gridY,gridWidth:x.gridWidth,gridHeight:x.gridHeight,bindings:U}}function z(x){if(f(x.config))return x.config;let j=h[x.type];return j?{layout:"single",bindings:[{ref:j,data:y[q(j)]}]}:{layout:"single",bindings:[]}}function B(x,j=280){return{ref:J(x),data:y[q(x.meta)],height:j}}function $(x,j,U,k,P,M,w,I,E){let F=new Date;return{id:j,dashboardId:x,name:U,type:k,gridX:P,gridY:M,gridWidth:w,gridHeight:I,config:E,createdAt:F,updatedAt:F}}function f(x){if(!x||typeof x!=="object")return!1;let j=x;return(j.layout==="single"||j.layout==="comparison"||j.layout==="timeline")&&Array.isArray(j.bindings)}import{defineFeature as b}from"@contractspec/lib.contracts-spec/features";var kx=b({meta:{key:"analytics-dashboard",version:"1.0.0",title:"Analytics Dashboard",description:"Analytics dashboards with customizable widgets and queries",domain:"analytics",owners:["@analytics-dashboard"],tags:["analytics","dashboards","widgets","queries"],stability:"experimental"},operations:[{key:"analytics.dashboard.create",version:"1.0.0"},{key:"analytics.dashboard.list",version:"1.0.0"},{key:"analytics.dashboard.get",version:"1.0.0"},{key:"analytics.widget.add",version:"1.0.0"},{key:"analytics.query.create",version:"1.0.0"},{key:"analytics.query.execute",version:"1.0.0"}],events:[{key:"analytics.dashboard.created",version:"1.0.0"},{key:"analytics.widget.added",version:"1.0.0"},{key:"analytics.query.created",version:"1.0.0"}],presentations:[{key:"analytics.dashboard.viewList",version:"1.0.0"},{key:"analytics.dashboard.view",version:"1.0.0"},{key:"analytics.dashboard.editor",version:"1.0.0"},{key:"analytics.query.list",version:"1.0.0"},{key:"analytics.query.builder",version:"1.0.0"}],visualizations:[...T],opToPresentation:[{op:{key:"analytics.dashboard.list",version:"1.0.0"},pres:{key:"analytics.dashboard.viewList",version:"1.0.0"}},{op:{key:"analytics.dashboard.get",version:"1.0.0"},pres:{key:"analytics.dashboard.view",version:"1.0.0"}},{op:{key:"analytics.dashboard.create",version:"1.0.0"},pres:{key:"analytics.dashboard.editor",version:"1.0.0"}},{op:{key:"analytics.query.create",version:"1.0.0"},pres:{key:"analytics.query.builder",version:"1.0.0"}}],presentationsTargets:[{key:"analytics.dashboard.viewList",version:"1.0.0",targets:["react","markdown","application/json"]},{key:"analytics.dashboard.view",version:"1.0.0",targets:["react","markdown"]},{key:"analytics.dashboard.editor",version:"1.0.0",targets:["react"]},{key:"analytics.query.builder",version:"1.0.0",targets:["react"]}],capabilities:{requires:[{key:"identity",version:"1.0.0"},{key:"metering",version:"1.0.0"},{key:"audit-trail",version:"1.0.0"}]},telemetry:[{key:"analytics-dashboard.telemetry",version:"1.0.0"}],docs:["docs.examples.analytics-dashboard","docs.examples.analytics-dashboard.goal","docs.examples.analytics-dashboard.usage","docs.examples.analytics-dashboard.constraints"]});export{kx as AnalyticsDashboardFeature};
|
package/dist/node/example.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{defineExample as
|
|
1
|
+
import{defineExample as f}from"@contractspec/lib.contracts-spec/examples";var g=f({meta:{key:"analytics-dashboard",version:"1.0.0",title:"Analytics Dashboard",description:"Analytics Dashboard example with widgets and query engine for ContractSpec",kind:"template",visibility:"public",stability:"stable",owners:["@contractspec-core"],tags:["package","examples","analytics-dashboard","analytics","dashboard"]},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["playground","specs"]},studio:{enabled:!1,installable:!1},mcp:{enabled:!1}},entrypoints:{packageName:"@contractspec/example.analytics-dashboard"}}),q=g;export{q as default,g as ExamplesAnalyticsDashboardExample};
|
package/dist/node/index.js
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
|
-
import{defineVisualization as b}from"@contractspec/lib.contracts-spec/visualizations";var s={key:"analytics.query.execute",version:"1.0.0"},i={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},R=b({meta:{...i,key:"analytics.visualization.channel-mix",title:"Channel Mix",description:"Session distribution across acquisition channels.",goal:"Explain which channels currently drive the largest share of traffic.",context:"Marketing attribution dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"pie",nameDimension:"channel",valueMeasure:"sessions",dimensions:[{key:"channel",label:"Channel",dataPath:"channel",type:"category"}],measures:[{key:"sessions",label:"Sessions",dataPath:"sessions"}],table:{caption:"Sessions by acquisition channel."}}}),S=b({meta:{...i,key:"analytics.visualization.engagement-heatmap",title:"Engagement Heatmap",description:"Average engagement score by weekday and time band.",goal:"Reveal the highest-engagement time windows for product activity.",context:"Usage analytics dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"heatmap",xDimension:"timeBand",yDimension:"weekday",valueMeasure:"engagementScore",dimensions:[{key:"timeBand",label:"Time Band",dataPath:"timeBand",type:"category"},{key:"weekday",label:"Weekday",dataPath:"weekday",type:"category"}],measures:[{key:"engagementScore",label:"Engagement",dataPath:"engagementScore"}],table:{caption:"Engagement score by weekday and time band."}}}),_=b({meta:{...i,key:"analytics.visualization.conversion-funnel",title:"Conversion Funnel",description:"Progression through the main acquisition funnel.",goal:"Show where the product is losing the largest share of prospects.",context:"Growth dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"funnel",nameDimension:"stage",valueMeasure:"users",sort:"descending",dimensions:[{key:"stage",label:"Stage",dataPath:"stage",type:"category"}],measures:[{key:"users",label:"Users",dataPath:"users"}],table:{caption:"Users per conversion stage."}}}),g=b({meta:{...i,key:"analytics.visualization.account-coverage-geo",title:"Account Coverage",description:"High-value accounts plotted on a slippy-map surface.",goal:"Locate where active commercial concentration is strongest.",context:"Territory coverage dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"geo",mode:"slippy-map",variant:"scatter",nameDimension:"city",latitudeDimension:"latitude",longitudeDimension:"longitude",valueMeasure:"accounts",dimensions:[{key:"city",label:"City",dataPath:"city",type:"category"},{key:"latitude",label:"Latitude",dataPath:"latitude",type:"latitude"},{key:"longitude",label:"Longitude",dataPath:"longitude",type:"longitude"}],measures:[{key:"accounts",label:"Accounts",dataPath:"accounts"}],table:{caption:"Account concentration by city."}}});import{defineVisualization as T}from"@contractspec/lib.contracts-spec/visualizations";var z={key:"analytics.query.execute",version:"1.0.0"},e={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},x=T({meta:{...e,key:"analytics.visualization.revenue-metric",title:"Revenue Snapshot",description:"Current recurring revenue with prior-period comparison.",goal:"Highlight the headline commercial metric for the dashboard.",context:"Executive revenue overview."},source:{primary:z,resultPath:"data"},visualization:{kind:"metric",measure:"totalRevenue",comparisonMeasure:"priorRevenue",dimensions:[{key:"period",label:"Period",dataPath:"period",type:"time"}],measures:[{key:"totalRevenue",label:"Revenue",dataPath:"totalRevenue",format:"currency"},{key:"priorRevenue",label:"Prior Revenue",dataPath:"priorRevenue",format:"currency"}],sparkline:{dimension:"period",measure:"totalRevenue"},table:{caption:"Revenue trend and prior period values."}}}),f=T({meta:{...e,key:"analytics.visualization.revenue-trend",title:"Revenue Trend",description:"Monthly revenue progression for the current quarter.",goal:"Track whether revenue growth is accelerating or stalling.",context:"Quarterly commercial dashboard."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"line",xDimension:"date",yMeasures:["revenue"],dimensions:[{key:"date",label:"Month",dataPath:"date",type:"time"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#0f766e"}],thresholds:[{key:"target",value:140000,label:"Target",color:"#dc2626"}],table:{caption:"Monthly revenue values."}}}),h=T({meta:{...e,key:"analytics.visualization.regional-revenue",title:"Regional Revenue",description:"Revenue split by sales territory.",goal:"Compare the strongest and weakest performing territories.",context:"Territory planning and commercial comparison."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"bar",xDimension:"region",yMeasures:["revenue"],dimensions:[{key:"region",label:"Region",dataPath:"region",type:"category"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#1d4ed8"}],table:{caption:"Revenue by region."}}}),E=T({meta:{...e,key:"analytics.visualization.retention-area",title:"Retention Curve",description:"Weekly retention progression across the active cohort.",goal:"Show whether user retention remains above the desired floor.",context:"Product health dashboard."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"area",xDimension:"week",yMeasures:["retentionRate"],dimensions:[{key:"week",label:"Week",dataPath:"week",type:"category"}],measures:[{key:"retentionRate",label:"Retention",dataPath:"retentionRate",format:"percentage",color:"#16a34a"}],thresholds:[{key:"floor",value:0.5,label:"Floor",color:"#f59e0b"}],table:{caption:"Weekly retention rate."}}}),I=T({meta:{...e,key:"analytics.visualization.pipeline-scatter",title:"Pipeline Velocity",description:"Deal-cycle length against win rate for active accounts.",goal:"Spot outliers where the sales cycle is long but conversion remains weak.",context:"Commercial operations dashboard."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"scatter",xDimension:"cycleDays",yMeasures:["winRate"],dimensions:[{key:"cycleDays",label:"Cycle Days",dataPath:"cycleDays",type:"number"}],measures:[{key:"winRate",label:"Win Rate",dataPath:"winRate",format:"percentage",color:"#7c3aed"},{key:"arr",label:"ARR",dataPath:"arr",format:"currency"}],series:[{key:"pipeline",label:"Accounts",measure:"winRate",type:"scatter",color:"#7c3aed"}],table:{caption:"Sales cycle and win rate per account."}}});import{VisualizationRegistry as Fr}from"@contractspec/lib.contracts-spec/visualizations";var d=[x,f,h,E,I,R,S,_,g],Yr=new Fr([...d]),Ar=d.map((r)=>Z(r)),tr=new Map(d.map((r)=>[B(r.meta),r])),a={[B(x.meta)]:{data:[{period:"2025-11-01",totalRevenue:112000,priorRevenue:103000},{period:"2025-12-01",totalRevenue:119000,priorRevenue:110000},{period:"2026-01-01",totalRevenue:126500,priorRevenue:116000},{period:"2026-02-01",totalRevenue:133000,priorRevenue:124000},{period:"2026-03-01",totalRevenue:145500,priorRevenue:133000}]},[B(f.meta)]:{data:[{date:"2025-11-01",revenue:112000},{date:"2025-12-01",revenue:119000},{date:"2026-01-01",revenue:126500},{date:"2026-02-01",revenue:133000},{date:"2026-03-01",revenue:145500}]},[B(h.meta)]:{data:[{region:"North America",revenue:210000},{region:"EMEA",revenue:174000},{region:"APAC",revenue:132000},{region:"LATAM",revenue:88000}]},[B(E.meta)]:{data:[{week:"Week 1",retentionRate:0.71},{week:"Week 2",retentionRate:0.66},{week:"Week 3",retentionRate:0.62},{week:"Week 4",retentionRate:0.58},{week:"Week 5",retentionRate:0.55},{week:"Week 6",retentionRate:0.53}]},[B(I.meta)]:{data:[{cycleDays:18,winRate:0.31,arr:82000},{cycleDays:26,winRate:0.44,arr:65000},{cycleDays:33,winRate:0.27,arr:91000},{cycleDays:14,winRate:0.56,arr:47000},{cycleDays:21,winRate:0.48,arr:59000},{cycleDays:39,winRate:0.22,arr:114000}]},[B(R.meta)]:{data:[{channel:"Direct",sessions:4200},{channel:"Organic Search",sessions:3600},{channel:"Paid Search",sessions:2100},{channel:"Partner",sessions:1400},{channel:"Referral",sessions:900}]},[B(S.meta)]:{data:[{weekday:"Mon",timeBand:"09:00",engagementScore:74},{weekday:"Mon",timeBand:"13:00",engagementScore:82},{weekday:"Tue",timeBand:"09:00",engagementScore:69},{weekday:"Tue",timeBand:"13:00",engagementScore:88},{weekday:"Wed",timeBand:"09:00",engagementScore:77},{weekday:"Wed",timeBand:"13:00",engagementScore:91},{weekday:"Thu",timeBand:"09:00",engagementScore:72},{weekday:"Thu",timeBand:"13:00",engagementScore:86},{weekday:"Fri",timeBand:"09:00",engagementScore:65},{weekday:"Fri",timeBand:"13:00",engagementScore:79}]},[B(_.meta)]:{data:[{stage:"Visited Site",users:12000},{stage:"Started Trial",users:4200},{stage:"Activated Workspace",users:2400},{stage:"Requested Demo",users:980},{stage:"Closed Won",users:310}]},[B(g.meta)]:{data:[{city:"Paris",latitude:48.8566,longitude:2.3522,accounts:48},{city:"London",latitude:51.5072,longitude:-0.1276,accounts:62},{city:"New York",latitude:40.7128,longitude:-74.006,accounts:71},{city:"Toronto",latitude:43.6532,longitude:-79.3832,accounts:36},{city:"Singapore",latitude:1.3521,longitude:103.8198,accounts:29}]}};function Z(r){return{key:r.meta.key,version:r.meta.version}}function B(r){return`${r.key}.v${r.version}`}var Rr={METRIC:Z(x),LINE_CHART:Z(f),BAR_CHART:Z(h),AREA_CHART:Z(E),SCATTER_PLOT:Z(I),PIE_CHART:Z(R),HEATMAP:Z(S),FUNNEL:Z(_),MAP:Z(g)};function V(r){return[K(r,"widget_revenue_metric","Revenue Snapshot","METRIC",0,0,4,2,{layout:"single",bindings:[U(x,200)]}),K(r,"widget_revenue_trend","Revenue Trend","LINE_CHART",4,0,8,4,{layout:"single",bindings:[U(f)]}),K(r,"widget_regional_revenue","Regional Revenue","BAR_CHART",0,2,6,4,{layout:"single",bindings:[U(h)]}),K(r,"widget_channel_mix","Channel Mix","PIE_CHART",6,2,6,4,{layout:"single",bindings:[U(R)]}),K(r,"widget_retention","Retention Curve","AREA_CHART",0,6,6,4,{layout:"single",bindings:[U(E)]}),K(r,"widget_pipeline","Pipeline Velocity","SCATTER_PLOT",6,6,6,4,{layout:"single",bindings:[U(I)]}),K(r,"widget_heatmap","Engagement Heatmap","HEATMAP",0,10,8,4,{layout:"single",bindings:[U(S)]}),K(r,"widget_funnel","Conversion Funnel","FUNNEL",8,10,4,4,{layout:"single",bindings:[U(_)]}),K(r,"widget_geo","Account Coverage","MAP",0,14,12,5,{layout:"single",bindings:[U(g,360)]}),K(r,"widget_comparison","Commercial Comparison","EMBED",0,19,12,6,{layout:"comparison",description:"Compare regional distribution, channel balance, and funnel shape.",bindings:[U(h,240),U(R,240),U(_,240)]}),K(r,"widget_timeline","Growth Timeline","EMBED",0,25,12,6,{layout:"timeline",description:"Track revenue and retention over the same reporting cadence.",bindings:[U(f,220),U(E,220)]})]}function j(r){let o=_r(r),n=o.bindings.map(($)=>{let y=tr.get(B($.ref));if(!y)return null;return{key:`${r.id}:${B($.ref)}`,spec:y,data:$.data,title:$.title??y.meta.title,description:$.description??y.meta.description,height:$.height}}).filter(($)=>Boolean($));if(!n.length)return null;return{id:r.id,name:r.name,description:o.description,layout:o.layout,gridX:r.gridX,gridY:r.gridY,gridWidth:r.gridWidth,gridHeight:r.gridHeight,bindings:n}}function _r(r){if(fr(r.config))return r.config;let o=Rr[r.type];return o?{layout:"single",bindings:[{ref:o,data:a[B(o)]}]}:{layout:"single",bindings:[]}}function U(r,o=280){return{ref:Z(r),data:a[B(r.meta)],height:o}}function K(r,o,n,$,y,c,Q,t,G){let L=new Date;return{id:o,dashboardId:r,name:n,type:$,gridX:y,gridY:c,gridWidth:Q,gridHeight:t,config:G,createdAt:L,updatedAt:L}}function fr(r){if(!r||typeof r!=="object")return!1;let o=r;return(o.layout==="single"||o.layout==="comparison"||o.layout==="timeline")&&Array.isArray(o.bindings)}import{defineFeature as hr}from"@contractspec/lib.contracts-spec";var gn=hr({meta:{key:"analytics-dashboard",version:"1.0.0",title:"Analytics Dashboard",description:"Analytics dashboards with customizable widgets and queries",domain:"analytics",owners:["@analytics-dashboard"],tags:["analytics","dashboards","widgets","queries"],stability:"experimental"},operations:[{key:"analytics.dashboard.create",version:"1.0.0"},{key:"analytics.dashboard.list",version:"1.0.0"},{key:"analytics.dashboard.get",version:"1.0.0"},{key:"analytics.widget.add",version:"1.0.0"},{key:"analytics.query.create",version:"1.0.0"},{key:"analytics.query.execute",version:"1.0.0"}],events:[{key:"analytics.dashboard.created",version:"1.0.0"},{key:"analytics.widget.added",version:"1.0.0"},{key:"analytics.query.created",version:"1.0.0"}],presentations:[{key:"analytics.dashboard.viewList",version:"1.0.0"},{key:"analytics.dashboard.view",version:"1.0.0"},{key:"analytics.dashboard.editor",version:"1.0.0"},{key:"analytics.query.list",version:"1.0.0"},{key:"analytics.query.builder",version:"1.0.0"}],visualizations:[...Ar],opToPresentation:[{op:{key:"analytics.dashboard.list",version:"1.0.0"},pres:{key:"analytics.dashboard.viewList",version:"1.0.0"}},{op:{key:"analytics.dashboard.get",version:"1.0.0"},pres:{key:"analytics.dashboard.view",version:"1.0.0"}},{op:{key:"analytics.dashboard.create",version:"1.0.0"},pres:{key:"analytics.dashboard.editor",version:"1.0.0"}},{op:{key:"analytics.query.create",version:"1.0.0"},pres:{key:"analytics.query.builder",version:"1.0.0"}}],presentationsTargets:[{key:"analytics.dashboard.viewList",version:"1.0.0",targets:["react","markdown","application/json"]},{key:"analytics.dashboard.view",version:"1.0.0",targets:["react","markdown"]},{key:"analytics.dashboard.editor",version:"1.0.0",targets:["react"]},{key:"analytics.query.builder",version:"1.0.0",targets:["react"]}],capabilities:{requires:[{key:"identity",version:"1.0.0"},{key:"metering",version:"1.0.0"},{key:"audit-trail",version:"1.0.0"}]},telemetry:[{key:"analytics-dashboard.telemetry",version:"1.0.0"}],docs:["docs.examples.analytics-dashboard","docs.examples.analytics-dashboard.goal","docs.examples.analytics-dashboard.usage","docs.examples.analytics-dashboard.constraints"]});class Qr{reader;defaultLimit;constructor(r,o={}){this.reader=r,this.defaultLimit=o.defaultLimit??100}async execute(r,o){let n=Date.now(),$=this.validateQuery(r);if(!$.valid)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:$.errors.join(", ")};if(!this.reader.queryHogQL)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:"Analytics reader does not support HogQL queries."};try{let y=await this.executeHogQL(r,o);return{data:y.data,columns:y.columns,rowCount:y.rowCount,executionTimeMs:Date.now()-n,cached:!1}}catch(y){return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:y instanceof Error?y.message:"Unknown error"}}}validateQuery(r){let o=[];if(r.type==="SQL"&&!r.sql)o.push("SQL query is missing.");if(r.type==="AGGREGATION"&&!r.aggregation)o.push("Aggregation definition is missing.");if(r.type==="METRIC"&&!r.metricIds?.length)o.push("Metric IDs are missing.");if(r.type==="CUSTOM"&&!r.custom?.handler)o.push("Custom handler is missing.");return{valid:o.length===0,errors:o}}async executeHogQL(r,o){if(!this.reader.queryHogQL)throw Error("Analytics reader does not support HogQL queries.");if(r.type==="SQL"){let n=await this.reader.queryHogQL({query:r.sql??"",values:o.parameters??{}});return kr(n)}if(r.type==="AGGREGATION"&&r.aggregation){let{query:n,values:$}=gr(r.aggregation,o),y=await this.reader.queryHogQL({query:n,values:$});return kr(y)}if(r.type==="METRIC"&&r.metricIds){let{query:n,values:$}=Sr(r.metricIds,o),y=await this.reader.queryHogQL({query:n,values:$});return kr(y)}throw Error("Unsupported query type for PostHog datasource.")}}function Er(r,o){return new Qr(r,o)}function Sr(r,o){let n=Ur(o),$={dateFrom:n?.from.toISOString(),dateTo:n?.to.toISOString()},y=r.map((Q,t)=>{return $[`metric${t}`]=Q,`event = {metric${t}}`}),c=[y.length?`(${y.join(" or ")})`:"",n?"timestamp >= {dateFrom} and timestamp < {dateTo}":""].filter(Boolean).join(" and ");return{query:["select"," event as metric,"," count() as total","from events",c?`where ${c}`:"","group by metric"].filter(Boolean).join(`
|
|
2
|
-
`),values:$}}function
|
|
3
|
-
`)}`,`from ${r.source}`,Q.length?`where ${Q.join(" and ")}`:"",$.length?`group by ${$.map((L)=>L.name).join(", ")}`:"",G,`limit ${
|
|
4
|
-
`),values:c}}function
|
|
5
|
-
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,[
|
|
6
|
-
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,[m,A.dashboardId,A.name,A.type,A.gridX??0,A.gridY??0,A.gridWidth??6,A.gridHeight??4,A.queryId??null,A.config?JSON.stringify(A.config):null,
|
|
7
|
-
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,[D,m.projectId,m.organizationId,A.name,A.description??null,A.type,JSON.stringify(A.definition),A.sql??null,A.cacheTtlSeconds??300,A.isShared?1:0,k,k]);let N=(await r.query("SELECT * FROM analytics_query WHERE id = ?",[D])).rows;return Dr(N[0])}async function Y(A){let m=(await r.query("SELECT * FROM analytics_query WHERE id = ?",[A])).rows;return m[0]?Dr(m[0]):null}return{listDashboards:o,createDashboard:n,getDashboard:$,updateDashboard:y,getWidgets:c,addWidget:Q,updateWidget:t,deleteWidget:G,listQueries:L,createQuery:C,getQuery:Y}}import{defineEnum as lr}from"@contractspec/lib.schema";var or=lr("QueryType",["SQL","METRIC","AGGREGATION","CUSTOM"]);import{defineSchemaModel as mr,ScalarTypeEnum as P}from"@contractspec/lib.schema";var $r=mr({name:"QueryModel",fields:{id:{type:P.String_unsecure(),isOptional:!1},name:{type:P.String_unsecure(),isOptional:!1},description:{type:P.String_unsecure(),isOptional:!0},type:{type:or,isOptional:!1},definition:{type:P.JSON(),isOptional:!1},sql:{type:P.String_unsecure(),isOptional:!0},cacheTtlSeconds:{type:P.Int_unsecure(),isOptional:!1},isShared:{type:P.Boolean(),isOptional:!1},createdAt:{type:P.DateTime(),isOptional:!1}}}),Nr=mr({name:"QueryResultModel",fields:{queryId:{type:P.String_unsecure(),isOptional:!1},data:{type:P.JSON(),isOptional:!1},columns:{type:P.JSON(),isOptional:!1},rowCount:{type:P.Int_unsecure(),isOptional:!1},executionTimeMs:{type:P.Int_unsecure(),isOptional:!1},cachedAt:{type:P.DateTime(),isOptional:!0},error:{type:P.String_unsecure(),isOptional:!0}}}),Pr=mr({name:"CreateQueryInput",fields:{name:{type:P.NonEmptyString(),isOptional:!1},description:{type:P.String_unsecure(),isOptional:!0},type:{type:or,isOptional:!1},definition:{type:P.JSON(),isOptional:!1},sql:{type:P.String_unsecure(),isOptional:!0},metricIds:{type:P.String_unsecure(),isArray:!0,isOptional:!0},cacheTtlSeconds:{type:P.Int_unsecure(),isOptional:!0},isShared:{type:P.Boolean(),isOptional:!0}}}),Gr=mr({name:"ExecuteQueryInput",fields:{queryId:{type:P.String_unsecure(),isOptional:!1},parameters:{type:P.JSON(),isOptional:!0},dateRange:{type:P.JSON(),isOptional:!0},filters:{type:P.JSON(),isOptional:!0},forceRefresh:{type:P.Boolean(),isOptional:!0}}});import{defineCommand as Tr,defineQuery as zr}from"@contractspec/lib.contracts-spec/operations";var Hr=["@example.analytics-dashboard"],er=Tr({meta:{key:"analytics.query.create",version:"1.0.0",stability:"stable",owners:[...Hr],tags:["analytics","query","create"],description:"Create a data query.",goal:"Define reusable data queries.",context:"Query builder."},io:{input:Pr,output:$r},policy:{auth:"user"},sideEffects:{emits:[{key:"analytics.query.created",version:"1.0.0",stability:"stable",owners:[...Hr],tags:["analytics","query","created"],when:"Query created",payload:$r}],audit:["analytics.query.created"]},acceptance:{scenarios:[{key:"create-query-happy-path",given:["User is authenticated"],when:["User submits valid query definition"],then:["Query is created","QueryCreated event is emitted"]}],examples:[{key:"create-sql-query",input:{name:"Monthly Revenue",sql:"SELECT SUM(amount) FROM orders WHERE date >= :startDate"},output:{id:"query-123",name:"Monthly Revenue",type:"sql"}}]}}),jr=zr({meta:{key:"analytics.query.execute",version:"1.0.0",stability:"stable",owners:[...Hr],tags:["analytics","query","execute"],description:"Execute a data query.",goal:"Fetch data for visualizations.",context:"Dashboard rendering."},io:{input:Gr,output:Nr},policy:{auth:"user"},acceptance:{scenarios:[{key:"execute-query-happy-path",given:["Query exists"],when:["User executes query with parameters"],then:["Query results are returned"]}],examples:[{key:"execute-with-params",input:{queryId:"query-123",params:{startDate:"2025-01-01"}},output:{columns:["total"],rows:[{total:50000}],rowCount:1}}]}});class Zr{cache=new Map;async get(r){let o=this.cache.get(r);if(!o)return null;if(o.expiresAt<new Date)return this.cache.delete(r),null;return{...o.result,cached:!0,cachedAt:o.expiresAt}}async set(r,o,n){let $=new Date(Date.now()+n*1000);this.cache.set(r,{result:o,expiresAt:$})}async invalidate(r){let o=new RegExp(r);for(let n of this.cache.keys())if(o.test(n))this.cache.delete(n)}}class qr{cache;constructor(r){this.cache=r??new Zr}async execute(r,o){let n=Date.now(),$=this.validateQuery(r);if(!$.valid)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:$.errors.join(", ")};let y=this.buildCacheKey(r,o),c=await this.cache.get(y);if(c)return c;let Q;switch(r.type){case"AGGREGATION":if(!r.aggregation)throw Error("Aggregation definition is missing");Q=await this.executeAggregation(r.aggregation,o);break;case"METRIC":if(!r.metricIds)throw Error("Metric IDs are missing");Q=await this.executeMetric(r.metricIds,o);break;case"SQL":if(!r.sql)throw Error("SQL query is missing");Q=await this.executeSql(r.sql,o);break;default:Q={data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:`Unknown query type: ${r.type}`}}return Q.executionTimeMs=Date.now()-n,Q.cached=!1,await this.cache.set(y,Q,300),Q}validateQuery(r){let o=[];if(!r.type)o.push("Query type is required");switch(r.type){case"SQL":if(!r.sql)o.push("SQL query is required for SQL type");break;case"METRIC":if(!r.metricIds||r.metricIds.length===0)o.push("Metric IDs are required for METRIC type");break;case"AGGREGATION":if(!r.aggregation)o.push("Aggregation definition is required for AGGREGATION type");else{if(!r.aggregation.source)o.push("Aggregation source is required");if(!r.aggregation.measures||r.aggregation.measures.length===0)o.push("At least one measure is required")}break}return{valid:o.length===0,errors:o}}buildCacheKey(r,o){return JSON.stringify({definition:r,params:o})}async executeAggregation(r,o){let n=[...r.dimensions.map((y)=>({name:y.name,type:y.type==="NUMBER"?"NUMBER":y.type==="TIME"?"DATE":"STRING",label:y.name})),...r.measures.map((y)=>({name:y.name,type:"NUMBER",label:y.name,format:y.format}))],$=this.generateMockData(r,o);return{data:$,columns:n,rowCount:$.length,executionTimeMs:0,cached:!1}}async executeMetric(r,o){let n=r.map(($)=>({metricId:$,value:Math.random()*1000,change:(Math.random()-0.5)*20}));return{data:n,columns:[{name:"metricId",type:"STRING"},{name:"value",type:"NUMBER"},{name:"change",type:"NUMBER"}],rowCount:n.length,executionTimeMs:0,cached:!1}}async executeSql(r,o){return{data:[],columns:[],rowCount:0,executionTimeMs:0,cached:!1,error:"SQL execution not implemented in demo"}}generateMockData(r,o){let n=[],$=10,y=r.dimensions.find((c)=>c.type==="TIME");for(let c=0;c<10;c++){let Q={};for(let t of r.dimensions)if(t.type==="TIME"){let G=new Date(o.dateRange?.start??new Date);G.setDate(G.getDate()+c),Q[t.name]=G.toISOString().split("T")[0]}else Q[t.name]=`${t.name}_${c%5}`;for(let t of r.measures){let G=y?100+c*10:Math.random()*1000,L=(Math.random()-0.5)*20;Q[t.name]=Math.round((G+L)*100)/100}n.push(Q)}return n}}function oo(r){return new qr(r)}import{ComparisonView as pr,TimelineView as wr,VisualizationCard as br,VisualizationGrid as sr}from"@contractspec/lib.design-system";import{jsx as p,jsxs as yr}from"react/jsx-runtime";function Xr({dashboardName:r,widgets:o}){if(!o.length)return yr("div",{className:"rounded-lg border border-dashed p-10 text-center text-muted-foreground",children:['No visualization widgets configured for "',r,'".']});return yr("div",{children:[yr("h3",{className:"mb-4 font-semibold text-lg",children:['Widgets in "',r,'"']}),p(sr,{children:o.map((n)=>p("div",{className:dr(n.gridWidth),children:ir(n)},n.id))})]})}function ir(r){let o=yr("span",{className:"text-muted-foreground text-xs",children:["Position: (",r.gridX,", ",r.gridY,") • ",r.gridWidth,"x",r.gridHeight]});if(r.layout==="comparison")return p(pr,{description:r.description,items:r.bindings.map(($)=>({...$,footer:o})),title:r.name});if(r.layout==="timeline")return p(wr,{description:r.description,items:r.bindings.map(($)=>({...$,footer:o})),title:r.name});let n=r.bindings[0];if(!n)return null;return p(br,{data:n.data,description:r.description??n.description,footer:o,height:n.height,spec:n.spec,title:r.name})}function dr(r){if(r>=12)return"md:col-span-2 xl:col-span-3";if(r>=8)return"xl:col-span-2";if(r>=6)return"md:col-span-2";return""}import{DataTable as ar}from"@contractspec/lib.design-system";import{useContractTable as rn}from"@contractspec/lib.presentation-runtime-react";import{Badge as Jr}from"@contractspec/lib.ui-kit-web/ui/badge";import{HStack as nn,VStack as w}from"@contractspec/lib.ui-kit-web/ui/stack";import{Text as v}from"@contractspec/lib.ui-kit-web/ui/text";import{jsx as q,jsxs as F}from"react/jsx-runtime";var on={SQL:"default",METRIC:"secondary",AGGREGATION:"secondary",CUSTOM:"outline"};function mn(r){return JSON.stringify(r,null,2)}function Kr({queries:r}){let o=rn({data:r,columns:[{id:"query",header:"Query",label:"Query",accessor:(n)=>n.name,cell:({item:n})=>F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:n.name}),F(v,{className:"text-muted-foreground text-xs",children:["Updated ",n.updatedAt.toLocaleDateString()]})]}),size:240,minSize:180,canSort:!0,canPin:!0,canResize:!0},{id:"description",header:"Description",label:"Description",accessor:(n)=>n.description??"",cell:({value:n})=>q(v,{className:"line-clamp-2 text-muted-foreground text-sm",children:String(n||"No description")}),size:300,minSize:220,canSort:!1,canHide:!0,canResize:!0},{id:"type",header:"Type",label:"Type",accessorKey:"type",cell:({value:n})=>q(Jr,{variant:on[String(n)],children:String(n)}),size:150,canSort:!0,canHide:!0,canResize:!0},{id:"cacheTtlSeconds",header:"Cache TTL",label:"Cache TTL",accessorKey:"cacheTtlSeconds",cell:({value:n})=>`${String(n)}s`,align:"right",size:140,canSort:!0,canResize:!0},{id:"isShared",header:"Shared",label:"Shared",accessorKey:"isShared",cell:({value:n})=>q(Jr,{variant:n?"default":"outline",children:n?"Shared":"Private"}),size:140,canSort:!0,canHide:!0,canResize:!0}],initialState:{pagination:{pageIndex:0,pageSize:3},columnVisibility:{description:!1},columnPinning:{left:["query"],right:[]}},renderExpandedContent:(n)=>F(w,{gap:"sm",className:"py-2",children:[F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:"Description"}),q(v,{className:"text-muted-foreground text-sm",children:n.description??"No description"})]}),n.sql?F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:"SQL"}),q("pre",{className:"overflow-auto rounded-md bg-muted/40 p-3 text-xs",children:n.sql})]}):null,F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:"Definition"}),q("pre",{className:"overflow-auto rounded-md bg-muted/40 p-3 text-xs",children:mn(n.definition)})]})]}),getCanExpand:()=>!0});return q(ar,{controller:o,title:"Saved Queries",description:"Client-mode table using the shared ContractSpec controller and renderer.",toolbar:F(nn,{gap:"sm",className:"flex-wrap",children:[F(v,{className:"text-muted-foreground text-sm",children:[r.length," queries"]}),F(v,{className:"text-muted-foreground text-sm",children:[r.filter((n)=>n.isShared).length," shared"]})]}),emptyState:q("div",{className:"rounded-md border border-dashed p-8 text-center text-muted-foreground text-sm",children:"No queries saved"})})}import{useTemplateRuntime as $n}from"@contractspec/lib.example-shared-ui";import{useCallback as Cr,useEffect as yn,useState as u}from"react";function Br(r="local-project"){let{handlers:o}=$n(),n=o.analytics,[$,y]=u([]),[c,Q]=u([]),[t,G]=u(null),[L,C]=u([]),[Y,A]=u(!0),[m,D]=u(null),k=Cr(async()=>{try{A(!0),D(null);let[H,O]=await Promise.all([n.listDashboards({projectId:r,limit:100}),n.listQueries({projectId:r,limit:100})]);if(y(H.dashboards),Q(O.queries),H.dashboards.length>0&&!t){let J=H.dashboards[0];if(J){G(J);let l=await n.getWidgets(J.id);C(l.length>0?l:V(J.id))}}}catch(H){D(H instanceof Error?H:Error("Failed to load analytics"))}finally{A(!1)}},[n,r,t]);yn(()=>{k()},[k]);let N=Cr(async(H)=>{G(H);let O=await n.getWidgets(H.id);C(O.length>0?O:V(H.id))},[n]),W={totalDashboards:$.length,publishedDashboards:$.filter((H)=>H.status==="PUBLISHED").length,totalQueries:c.length,sharedQueries:c.filter((H)=>H.isShared).length};return{dashboards:$,queries:c,selectedDashboard:t,widgets:L,loading:Y,error:m,stats:W,refetch:k,selectDashboard:N}}import{Button as Wr,ErrorState as cn,LoaderBlock as An,StatCard as Mr,StatCardGroup as tn}from"@contractspec/lib.design-system";import{useMemo as kn,useState as Qn}from"react";import{jsx as M,jsxs as X}from"react/jsx-runtime";var Ln={PUBLISHED:"bg-green-100 text-green-700 dark:bg-green-900/30 dark:text-green-400",DRAFT:"bg-gray-100 text-gray-700 dark:bg-gray-900/30 dark:text-gray-400",ARCHIVED:"bg-yellow-100 text-yellow-700 dark:bg-yellow-900/30 dark:text-yellow-400"};function Dn(){let[r,o]=Qn("dashboards"),{dashboards:n,queries:$,selectedDashboard:y,widgets:c,loading:Q,error:t,stats:G,refetch:L,selectDashboard:C}=Br(),Y=[{id:"dashboards",label:"Dashboards",icon:"\uD83D\uDCCA"},{id:"queries",label:"Queries",icon:"\uD83D\uDD0D"}],A=kn(()=>c.map((m)=>j(m)).filter((m)=>Boolean(m)),[c]);if(Q)return M(An,{label:"Loading Analytics..."});if(t)return M(cn,{title:"Failed to load Analytics",description:t.message,onRetry:L,retryLabel:"Retry"});return X("div",{className:"space-y-6",children:[X("div",{className:"flex items-center justify-between",children:[M("h2",{className:"font-bold text-2xl",children:"Analytics Dashboard"}),X(Wr,{onClick:()=>alert("Create dashboard modal"),children:[M("span",{className:"mr-2",children:"+"})," New Dashboard"]})]}),X(tn,{children:[M(Mr,{label:"Dashboards",value:G.totalDashboards,hint:`${G.publishedDashboards} published`}),M(Mr,{label:"Queries",value:G.totalQueries,hint:`${G.sharedQueries} shared`}),M(Mr,{label:"Widgets",value:c.length,hint:"on current dashboard"})]}),M("nav",{className:"flex gap-1 rounded-lg bg-muted p-1",role:"tablist",children:Y.map((m)=>X(Wr,{type:"button",role:"tab","aria-selected":r===m.id,onClick:()=>o(m.id),className:`flex flex-1 items-center justify-center gap-2 rounded-md px-4 py-2 font-medium text-sm transition-colors ${r===m.id?"bg-background text-foreground shadow-sm":"text-muted-foreground hover:text-foreground"}`,children:[M("span",{children:m.icon}),m.label]},m.id))}),X("div",{className:"min-h-[400px]",role:"tabpanel",children:[r==="dashboards"&&X("div",{className:"space-y-6",children:[X("div",{className:"grid gap-4 sm:grid-cols-2 lg:grid-cols-3",children:[n.map((m)=>X("div",{onClick:()=>C(m),className:`cursor-pointer rounded-lg border border-border bg-card p-4 transition-all ${y?.id===m.id?"ring-2 ring-primary":"hover:bg-muted/50"}`,role:"button",tabIndex:0,onKeyDown:(D)=>{if(D.key==="Enter"||D.key===" ")C(m)},children:[X("div",{className:"mb-2 flex items-center justify-between",children:[M("h3",{className:"font-medium",children:m.name}),M("span",{className:`inline-flex rounded-full px-2 py-0.5 font-medium text-xs ${Ln[m.status]??""}`,children:m.status})]}),M("p",{className:"mb-3 text-muted-foreground text-sm",children:m.description}),X("div",{className:"flex items-center justify-between text-muted-foreground text-xs",children:[X("span",{children:["/",m.slug]}),m.isPublic&&M("span",{className:"text-green-600 dark:text-green-400",children:"\uD83C\uDF10 Public"})]})]},m.id)),n.length===0&&M("div",{className:"col-span-full flex h-64 items-center justify-center text-muted-foreground",children:"No dashboards created yet"})]}),y?M(Xr,{dashboardName:y.name,widgets:A}):null]}),r==="queries"&&M(Kr,{queries:$})]})]})}var cr=[{id:"dash-1",name:"Sales Overview",slug:"sales-overview",status:"PUBLISHED",widgetCount:11,viewCount:1250,lastViewedAt:"2026-03-18T12:00:00Z"},{id:"dash-2",name:"User Engagement",slug:"user-engagement",status:"PUBLISHED",widgetCount:8,viewCount:890,lastViewedAt:"2026-03-18T10:00:00Z"}],vr=[{id:"q-1",name:"Monthly Revenue",type:"AGGREGATION",isShared:!0,executionCount:1500},{id:"q-2",name:"User Growth",type:"METRIC",isShared:!0,executionCount:890},{id:"q-3",name:"Product Sales",type:"SQL",isShared:!1,executionCount:340},{id:"q-4",name:"Conversion Funnel",type:"AGGREGATION",isShared:!0,executionCount:450}];function Nn(r){return V(r).map((o)=>j(o)).filter((o)=>Boolean(o))}var Pn={target:"markdown",render:async(r)=>{if(r.source.type!=="component"||r.source.componentKey!=="AnalyticsDashboard")throw Error("analyticsDashboardMarkdownRenderer: not AnalyticsDashboard");let o=cr[0];if(!o)return{mimeType:"text/markdown",body:`# No Dashboards
|
|
1
|
+
import{defineVisualization as b}from"@contractspec/lib.contracts-spec/visualizations";var s={key:"analytics.query.execute",version:"1.0.0"},i={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},R=b({meta:{...i,key:"analytics.visualization.channel-mix",title:"Channel Mix",description:"Session distribution across acquisition channels.",goal:"Explain which channels currently drive the largest share of traffic.",context:"Marketing attribution dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"pie",nameDimension:"channel",valueMeasure:"sessions",dimensions:[{key:"channel",label:"Channel",dataPath:"channel",type:"category"}],measures:[{key:"sessions",label:"Sessions",dataPath:"sessions"}],table:{caption:"Sessions by acquisition channel."}}}),g=b({meta:{...i,key:"analytics.visualization.engagement-heatmap",title:"Engagement Heatmap",description:"Average engagement score by weekday and time band.",goal:"Reveal the highest-engagement time windows for product activity.",context:"Usage analytics dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"heatmap",xDimension:"timeBand",yDimension:"weekday",valueMeasure:"engagementScore",dimensions:[{key:"timeBand",label:"Time Band",dataPath:"timeBand",type:"category"},{key:"weekday",label:"Weekday",dataPath:"weekday",type:"category"}],measures:[{key:"engagementScore",label:"Engagement",dataPath:"engagementScore"}],table:{caption:"Engagement score by weekday and time band."}}}),_=b({meta:{...i,key:"analytics.visualization.conversion-funnel",title:"Conversion Funnel",description:"Progression through the main acquisition funnel.",goal:"Show where the product is losing the largest share of prospects.",context:"Growth dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"funnel",nameDimension:"stage",valueMeasure:"users",sort:"descending",dimensions:[{key:"stage",label:"Stage",dataPath:"stage",type:"category"}],measures:[{key:"users",label:"Users",dataPath:"users"}],table:{caption:"Users per conversion stage."}}}),E=b({meta:{...i,key:"analytics.visualization.account-coverage-geo",title:"Account Coverage",description:"High-value accounts plotted on a slippy-map surface.",goal:"Locate where active commercial concentration is strongest.",context:"Territory coverage dashboard."},source:{primary:s,resultPath:"data"},visualization:{kind:"geo",mode:"slippy-map",variant:"scatter",nameDimension:"city",latitudeDimension:"latitude",longitudeDimension:"longitude",valueMeasure:"accounts",dimensions:[{key:"city",label:"City",dataPath:"city",type:"category"},{key:"latitude",label:"Latitude",dataPath:"latitude",type:"latitude"},{key:"longitude",label:"Longitude",dataPath:"longitude",type:"longitude"}],measures:[{key:"accounts",label:"Accounts",dataPath:"accounts"}],table:{caption:"Account concentration by city."}}});import{defineVisualization as l}from"@contractspec/lib.contracts-spec/visualizations";var z={key:"analytics.query.execute",version:"1.0.0"},e={version:"1.0.0",domain:"analytics",stability:"experimental",owners:["@example.analytics-dashboard"],tags:["analytics","dashboard","visualization"]},I=l({meta:{...e,key:"analytics.visualization.revenue-metric",title:"Revenue Snapshot",description:"Current recurring revenue with prior-period comparison.",goal:"Highlight the headline commercial metric for the dashboard.",context:"Executive revenue overview."},source:{primary:z,resultPath:"data"},visualization:{kind:"metric",measure:"totalRevenue",comparisonMeasure:"priorRevenue",dimensions:[{key:"period",label:"Period",dataPath:"period",type:"time"}],measures:[{key:"totalRevenue",label:"Revenue",dataPath:"totalRevenue",format:"currency"},{key:"priorRevenue",label:"Prior Revenue",dataPath:"priorRevenue",format:"currency"}],sparkline:{dimension:"period",measure:"totalRevenue"},table:{caption:"Revenue trend and prior period values."}}}),f=l({meta:{...e,key:"analytics.visualization.revenue-trend",title:"Revenue Trend",description:"Monthly revenue progression for the current quarter.",goal:"Track whether revenue growth is accelerating or stalling.",context:"Quarterly commercial dashboard."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"line",xDimension:"date",yMeasures:["revenue"],dimensions:[{key:"date",label:"Month",dataPath:"date",type:"time"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#0f766e"}],thresholds:[{key:"target",value:140000,label:"Target",color:"#dc2626"}],table:{caption:"Monthly revenue values."}}}),h=l({meta:{...e,key:"analytics.visualization.regional-revenue",title:"Regional Revenue",description:"Revenue split by sales territory.",goal:"Compare the strongest and weakest performing territories.",context:"Territory planning and commercial comparison."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"bar",xDimension:"region",yMeasures:["revenue"],dimensions:[{key:"region",label:"Region",dataPath:"region",type:"category"}],measures:[{key:"revenue",label:"Revenue",dataPath:"revenue",format:"currency",color:"#1d4ed8"}],table:{caption:"Revenue by region."}}}),S=l({meta:{...e,key:"analytics.visualization.retention-area",title:"Retention Curve",description:"Weekly retention progression across the active cohort.",goal:"Show whether user retention remains above the desired floor.",context:"Product health dashboard."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"area",xDimension:"week",yMeasures:["retentionRate"],dimensions:[{key:"week",label:"Week",dataPath:"week",type:"category"}],measures:[{key:"retentionRate",label:"Retention",dataPath:"retentionRate",format:"percentage",color:"#16a34a"}],thresholds:[{key:"floor",value:0.5,label:"Floor",color:"#f59e0b"}],table:{caption:"Weekly retention rate."}}}),V=l({meta:{...e,key:"analytics.visualization.pipeline-scatter",title:"Pipeline Velocity",description:"Deal-cycle length against win rate for active accounts.",goal:"Spot outliers where the sales cycle is long but conversion remains weak.",context:"Commercial operations dashboard."},source:{primary:z,resultPath:"data"},visualization:{kind:"cartesian",variant:"scatter",xDimension:"cycleDays",yMeasures:["winRate"],dimensions:[{key:"cycleDays",label:"Cycle Days",dataPath:"cycleDays",type:"number"}],measures:[{key:"winRate",label:"Win Rate",dataPath:"winRate",format:"percentage",color:"#7c3aed"},{key:"arr",label:"ARR",dataPath:"arr",format:"currency"}],series:[{key:"pipeline",label:"Accounts",measure:"winRate",type:"scatter",color:"#7c3aed"}],table:{caption:"Sales cycle and win rate per account."}}});import{VisualizationRegistry as Fr}from"@contractspec/lib.contracts-spec/visualizations";var d=[I,f,h,S,V,R,g,_,E],Yr=new Fr([...d]),Ar=d.map((r)=>Z(r)),kr=new Map(d.map((r)=>[B(r.meta),r])),a={[B(I.meta)]:{data:[{period:"2025-11-01",totalRevenue:112000,priorRevenue:103000},{period:"2025-12-01",totalRevenue:119000,priorRevenue:110000},{period:"2026-01-01",totalRevenue:126500,priorRevenue:116000},{period:"2026-02-01",totalRevenue:133000,priorRevenue:124000},{period:"2026-03-01",totalRevenue:145500,priorRevenue:133000}]},[B(f.meta)]:{data:[{date:"2025-11-01",revenue:112000},{date:"2025-12-01",revenue:119000},{date:"2026-01-01",revenue:126500},{date:"2026-02-01",revenue:133000},{date:"2026-03-01",revenue:145500}]},[B(h.meta)]:{data:[{region:"North America",revenue:210000},{region:"EMEA",revenue:174000},{region:"APAC",revenue:132000},{region:"LATAM",revenue:88000}]},[B(S.meta)]:{data:[{week:"Week 1",retentionRate:0.71},{week:"Week 2",retentionRate:0.66},{week:"Week 3",retentionRate:0.62},{week:"Week 4",retentionRate:0.58},{week:"Week 5",retentionRate:0.55},{week:"Week 6",retentionRate:0.53}]},[B(V.meta)]:{data:[{cycleDays:18,winRate:0.31,arr:82000},{cycleDays:26,winRate:0.44,arr:65000},{cycleDays:33,winRate:0.27,arr:91000},{cycleDays:14,winRate:0.56,arr:47000},{cycleDays:21,winRate:0.48,arr:59000},{cycleDays:39,winRate:0.22,arr:114000}]},[B(R.meta)]:{data:[{channel:"Direct",sessions:4200},{channel:"Organic Search",sessions:3600},{channel:"Paid Search",sessions:2100},{channel:"Partner",sessions:1400},{channel:"Referral",sessions:900}]},[B(g.meta)]:{data:[{weekday:"Mon",timeBand:"09:00",engagementScore:74},{weekday:"Mon",timeBand:"13:00",engagementScore:82},{weekday:"Tue",timeBand:"09:00",engagementScore:69},{weekday:"Tue",timeBand:"13:00",engagementScore:88},{weekday:"Wed",timeBand:"09:00",engagementScore:77},{weekday:"Wed",timeBand:"13:00",engagementScore:91},{weekday:"Thu",timeBand:"09:00",engagementScore:72},{weekday:"Thu",timeBand:"13:00",engagementScore:86},{weekday:"Fri",timeBand:"09:00",engagementScore:65},{weekday:"Fri",timeBand:"13:00",engagementScore:79}]},[B(_.meta)]:{data:[{stage:"Visited Site",users:12000},{stage:"Started Trial",users:4200},{stage:"Activated Workspace",users:2400},{stage:"Requested Demo",users:980},{stage:"Closed Won",users:310}]},[B(E.meta)]:{data:[{city:"Paris",latitude:48.8566,longitude:2.3522,accounts:48},{city:"London",latitude:51.5072,longitude:-0.1276,accounts:62},{city:"New York",latitude:40.7128,longitude:-74.006,accounts:71},{city:"Toronto",latitude:43.6532,longitude:-79.3832,accounts:36},{city:"Singapore",latitude:1.3521,longitude:103.8198,accounts:29}]}};function Z(r){return{key:r.meta.key,version:r.meta.version}}function B(r){return`${r.key}.v${r.version}`}var Rr={METRIC:Z(I),LINE_CHART:Z(f),BAR_CHART:Z(h),AREA_CHART:Z(S),SCATTER_PLOT:Z(V),PIE_CHART:Z(R),HEATMAP:Z(g),FUNNEL:Z(_),MAP:Z(E)};function u(r){return[K(r,"widget_revenue_metric","Revenue Snapshot","METRIC",0,0,4,2,{layout:"single",bindings:[U(I,200)]}),K(r,"widget_revenue_trend","Revenue Trend","LINE_CHART",4,0,8,4,{layout:"single",bindings:[U(f)]}),K(r,"widget_regional_revenue","Regional Revenue","BAR_CHART",0,2,6,4,{layout:"single",bindings:[U(h)]}),K(r,"widget_channel_mix","Channel Mix","PIE_CHART",6,2,6,4,{layout:"single",bindings:[U(R)]}),K(r,"widget_retention","Retention Curve","AREA_CHART",0,6,6,4,{layout:"single",bindings:[U(S)]}),K(r,"widget_pipeline","Pipeline Velocity","SCATTER_PLOT",6,6,6,4,{layout:"single",bindings:[U(V)]}),K(r,"widget_heatmap","Engagement Heatmap","HEATMAP",0,10,8,4,{layout:"single",bindings:[U(g)]}),K(r,"widget_funnel","Conversion Funnel","FUNNEL",8,10,4,4,{layout:"single",bindings:[U(_)]}),K(r,"widget_geo","Account Coverage","MAP",0,14,12,5,{layout:"single",bindings:[U(E,360)]}),K(r,"widget_comparison","Commercial Comparison","EMBED",0,19,12,6,{layout:"comparison",description:"Compare regional distribution, channel balance, and funnel shape.",bindings:[U(h,240),U(R,240),U(_,240)]}),K(r,"widget_timeline","Growth Timeline","EMBED",0,25,12,6,{layout:"timeline",description:"Track revenue and retention over the same reporting cadence.",bindings:[U(f,220),U(S,220)]})]}function j(r){let o=_r(r),n=o.bindings.map(($)=>{let y=kr.get(B($.ref));if(!y)return null;return{key:`${r.id}:${B($.ref)}`,spec:y,data:$.data,title:$.title??y.meta.title,description:$.description??y.meta.description,height:$.height}}).filter(($)=>Boolean($));if(!n.length)return null;return{id:r.id,name:r.name,description:o.description,layout:o.layout,gridX:r.gridX,gridY:r.gridY,gridWidth:r.gridWidth,gridHeight:r.gridHeight,bindings:n}}function _r(r){if(fr(r.config))return r.config;let o=Rr[r.type];return o?{layout:"single",bindings:[{ref:o,data:a[B(o)]}]}:{layout:"single",bindings:[]}}function U(r,o=280){return{ref:Z(r),data:a[B(r.meta)],height:o}}function K(r,o,n,$,y,c,Q,k,G){let L=new Date;return{id:o,dashboardId:r,name:n,type:$,gridX:y,gridY:c,gridWidth:Q,gridHeight:k,config:G,createdAt:L,updatedAt:L}}function fr(r){if(!r||typeof r!=="object")return!1;let o=r;return(o.layout==="single"||o.layout==="comparison"||o.layout==="timeline")&&Array.isArray(o.bindings)}import{defineFeature as hr}from"@contractspec/lib.contracts-spec/features";var Vn=hr({meta:{key:"analytics-dashboard",version:"1.0.0",title:"Analytics Dashboard",description:"Analytics dashboards with customizable widgets and queries",domain:"analytics",owners:["@analytics-dashboard"],tags:["analytics","dashboards","widgets","queries"],stability:"experimental"},operations:[{key:"analytics.dashboard.create",version:"1.0.0"},{key:"analytics.dashboard.list",version:"1.0.0"},{key:"analytics.dashboard.get",version:"1.0.0"},{key:"analytics.widget.add",version:"1.0.0"},{key:"analytics.query.create",version:"1.0.0"},{key:"analytics.query.execute",version:"1.0.0"}],events:[{key:"analytics.dashboard.created",version:"1.0.0"},{key:"analytics.widget.added",version:"1.0.0"},{key:"analytics.query.created",version:"1.0.0"}],presentations:[{key:"analytics.dashboard.viewList",version:"1.0.0"},{key:"analytics.dashboard.view",version:"1.0.0"},{key:"analytics.dashboard.editor",version:"1.0.0"},{key:"analytics.query.list",version:"1.0.0"},{key:"analytics.query.builder",version:"1.0.0"}],visualizations:[...Ar],opToPresentation:[{op:{key:"analytics.dashboard.list",version:"1.0.0"},pres:{key:"analytics.dashboard.viewList",version:"1.0.0"}},{op:{key:"analytics.dashboard.get",version:"1.0.0"},pres:{key:"analytics.dashboard.view",version:"1.0.0"}},{op:{key:"analytics.dashboard.create",version:"1.0.0"},pres:{key:"analytics.dashboard.editor",version:"1.0.0"}},{op:{key:"analytics.query.create",version:"1.0.0"},pres:{key:"analytics.query.builder",version:"1.0.0"}}],presentationsTargets:[{key:"analytics.dashboard.viewList",version:"1.0.0",targets:["react","markdown","application/json"]},{key:"analytics.dashboard.view",version:"1.0.0",targets:["react","markdown"]},{key:"analytics.dashboard.editor",version:"1.0.0",targets:["react"]},{key:"analytics.query.builder",version:"1.0.0",targets:["react"]}],capabilities:{requires:[{key:"identity",version:"1.0.0"},{key:"metering",version:"1.0.0"},{key:"audit-trail",version:"1.0.0"}]},telemetry:[{key:"analytics-dashboard.telemetry",version:"1.0.0"}],docs:["docs.examples.analytics-dashboard","docs.examples.analytics-dashboard.goal","docs.examples.analytics-dashboard.usage","docs.examples.analytics-dashboard.constraints"]});class Qr{reader;defaultLimit;constructor(r,o={}){this.reader=r,this.defaultLimit=o.defaultLimit??100}async execute(r,o){let n=Date.now(),$=this.validateQuery(r);if(!$.valid)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:$.errors.join(", ")};if(!this.reader.queryHogQL)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:"Analytics reader does not support HogQL queries."};try{let y=await this.executeHogQL(r,o);return{data:y.data,columns:y.columns,rowCount:y.rowCount,executionTimeMs:Date.now()-n,cached:!1}}catch(y){return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:y instanceof Error?y.message:"Unknown error"}}}validateQuery(r){let o=[];if(r.type==="SQL"&&!r.sql)o.push("SQL query is missing.");if(r.type==="AGGREGATION"&&!r.aggregation)o.push("Aggregation definition is missing.");if(r.type==="METRIC"&&!r.metricIds?.length)o.push("Metric IDs are missing.");if(r.type==="CUSTOM"&&!r.custom?.handler)o.push("Custom handler is missing.");return{valid:o.length===0,errors:o}}async executeHogQL(r,o){if(!this.reader.queryHogQL)throw Error("Analytics reader does not support HogQL queries.");if(r.type==="SQL"){let n=await this.reader.queryHogQL({query:r.sql??"",values:o.parameters??{}});return tr(n)}if(r.type==="AGGREGATION"&&r.aggregation){let{query:n,values:$}=Er(r.aggregation,o),y=await this.reader.queryHogQL({query:n,values:$});return tr(y)}if(r.type==="METRIC"&&r.metricIds){let{query:n,values:$}=gr(r.metricIds,o),y=await this.reader.queryHogQL({query:n,values:$});return tr(y)}throw Error("Unsupported query type for PostHog datasource.")}}function Sr(r,o){return new Qr(r,o)}function gr(r,o){let n=Ur(o),$={dateFrom:n?.from.toISOString(),dateTo:n?.to.toISOString()},y=r.map((Q,k)=>{return $[`metric${k}`]=Q,`event = {metric${k}}`}),c=[y.length?`(${y.join(" or ")})`:"",n?"timestamp >= {dateFrom} and timestamp < {dateTo}":""].filter(Boolean).join(" and ");return{query:["select"," event as metric,"," count() as total","from events",c?`where ${c}`:"","group by metric"].filter(Boolean).join(`
|
|
2
|
+
`),values:$}}function Er(r,o){let n=r.measures.map((L)=>({...L,expression:Ir(L.field,L.aggregation)})),$=r.dimensions.map((L)=>({...L,expression:Vr(L.field,L.type,L.granularity)})),y=[...$.map((L)=>`${L.expression} as ${L.name}`),...n.map((L)=>`${L.expression} as ${L.name}`)],c={},Q=ur(r,o,c),k=r.limit??100,G=r.orderBy?.length?`order by ${r.orderBy.map((L)=>`${L.field} ${L.direction}`).join(", ")}`:"";return{query:["select",` ${y.join(`,
|
|
3
|
+
`)}`,`from ${r.source}`,Q.length?`where ${Q.join(" and ")}`:"",$.length?`group by ${$.map((L)=>L.name).join(", ")}`:"",G,`limit ${k}`].filter(Boolean).join(`
|
|
4
|
+
`),values:c}}function Ir(r,o){switch(o){case"COUNT":return r==="*"?"count()":`count(${r})`;case"COUNT_DISTINCT":return`countDistinct(${r})`;case"SUM":return`sum(${r})`;case"AVG":return`avg(${r})`;case"MIN":return`min(${r})`;case"MAX":return`max(${r})`;default:return`count(${r})`}}function Vr(r,o,n){if(o==="TIME")switch(n){case"HOUR":return`toStartOfHour(${r})`;case"WEEK":return`toStartOfWeek(${r})`;case"MONTH":return`toStartOfMonth(${r})`;case"YEAR":return`toStartOfYear(${r})`;case"DAY":default:return`toStartOfDay(${r})`}return r}function ur(r,o,n){let $=[],y=Ur(o);if(y)n.dateFrom=y.from.toISOString(),n.dateTo=y.to.toISOString(),$.push("timestamp >= {dateFrom} and timestamp < {dateTo}");return r.filters?.forEach((c,Q)=>{let k=`filter${Q}`;switch(c.operator){case"eq":n[k]=c.value,$.push(`${c.field} = {${k}}`);break;case"neq":n[k]=c.value,$.push(`${c.field} != {${k}}`);break;case"gt":n[k]=c.value,$.push(`${c.field} > {${k}}`);break;case"gte":n[k]=c.value,$.push(`${c.field} >= {${k}}`);break;case"lt":n[k]=c.value,$.push(`${c.field} < {${k}}`);break;case"lte":n[k]=c.value,$.push(`${c.field} <= {${k}}`);break;case"contains":n[k]=c.value,$.push(`${c.field} LIKE '%' || {${k}} || '%'`);break;case"between":{if(Array.isArray(c.value)&&c.value.length>=2)n[`${k}Start`]=c.value[0],n[`${k}End`]=c.value[1],$.push(`${c.field} BETWEEN {${k}Start} AND {${k}End}`);break}case"in":case"nin":if(Array.isArray(c.value)){let G=[];if(c.value.forEach((L,C)=>{let Y=`${k}_${C}`;n[Y]=L,G.push(`{${Y}}`)}),G.length)$.push(`${c.field} ${c.operator==="in"?"IN":"NOT IN"} (${G.join(", ")})`)}break;default:break}}),$}function Ur(r){let o=r.dateRange;if(!o)return null;return{from:o.start,to:o.end}}function tr(r){if(!Array.isArray(r.results)||!Array.isArray(r.columns))return{data:[],columns:[],rowCount:0};let o=r.columns.map(($)=>({name:$,type:"STRING"})),n=r.results.map(($)=>{if(!Array.isArray($))return{};let y={};return r.columns?.forEach((c,Q)=>{y[c]=$[Q]}),y});return{data:n,columns:o,rowCount:n.length}}import{defineExample as xr}from"@contractspec/lib.contracts-spec/examples";var Tr=xr({meta:{key:"analytics-dashboard",version:"1.0.0",title:"Analytics Dashboard",description:"Analytics Dashboard example with widgets and query engine for ContractSpec",kind:"template",visibility:"public",stability:"stable",owners:["@contractspec-core"],tags:["package","examples","analytics-dashboard","analytics","dashboard"]},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["playground","specs"]},studio:{enabled:!1,installable:!1},mcp:{enabled:!1}},entrypoints:{packageName:"@contractspec/example.analytics-dashboard"}}),zn=Tr;import{web as lr}from"@contractspec/lib.runtime-sandbox";var{generateId:rr}=lr;function nr(r){return{id:r.id,projectId:r.projectId,organizationId:r.organizationId,name:r.name,slug:r.slug,description:r.description??void 0,status:r.status,refreshInterval:r.refreshInterval,isPublic:r.isPublic===1,shareToken:r.shareToken??void 0,createdAt:new Date(r.createdAt),updatedAt:new Date(r.updatedAt)}}function Lr(r){return{id:r.id,dashboardId:r.dashboardId,name:r.name,type:r.type,gridX:r.gridX,gridY:r.gridY,gridWidth:r.gridWidth,gridHeight:r.gridHeight,queryId:r.queryId??void 0,config:r.config?JSON.parse(r.config):void 0,createdAt:new Date(r.createdAt),updatedAt:new Date(r.updatedAt)}}function Nr(r){return{id:r.id,projectId:r.projectId,organizationId:r.organizationId,name:r.name,description:r.description??void 0,type:r.type,definition:JSON.parse(r.definition),sql:r.sql??void 0,cacheTtlSeconds:r.cacheTtlSeconds,isShared:r.isShared===1,createdAt:new Date(r.createdAt),updatedAt:new Date(r.updatedAt)}}function jn(r){async function o(A){let{projectId:m,status:N,search:t,limit:P=20,offset:W=0}=A,H="WHERE projectId = ?",O=[m];if(N&&N!=="all")H+=" AND status = ?",O.push(N);if(t)H+=" AND (name LIKE ? OR description LIKE ?)",O.push(`%${t}%`,`%${t}%`);let T=(await r.query(`SELECT COUNT(*) as count FROM analytics_dashboard ${H}`,O)).rows[0]?.count??0;return{dashboards:(await r.query(`SELECT * FROM analytics_dashboard ${H} ORDER BY updatedAt DESC LIMIT ? OFFSET ?`,[...O,P,W])).rows.map(nr),total:T}}async function n(A,m){let N=rr("dash"),t=new Date().toISOString();await r.execute(`INSERT INTO analytics_dashboard (id, projectId, organizationId, name, slug, description, status, refreshInterval, isPublic, createdAt, updatedAt)
|
|
5
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,[N,m.projectId,m.organizationId,A.name,A.slug,A.description??null,"DRAFT",A.refreshInterval??"NONE",0,t,t]);let P=(await r.query("SELECT * FROM analytics_dashboard WHERE id = ?",[N])).rows;return nr(P[0])}async function $(A){let m="",N=[];if(A.dashboardId)m="WHERE id = ?",N.push(A.dashboardId);else if(A.slug)m="WHERE slug = ?",N.push(A.slug);else if(A.shareToken)m="WHERE shareToken = ?",N.push(A.shareToken);else return null;let t=(await r.query(`SELECT * FROM analytics_dashboard ${m}`,N)).rows;return t[0]?nr(t[0]):null}async function y(A,m){let N=new Date().toISOString(),t=["updatedAt = ?"],P=[N];if(m.name!==void 0)t.push("name = ?"),P.push(m.name);if(m.description!==void 0)t.push("description = ?"),P.push(m.description);if(m.status!==void 0)t.push("status = ?"),P.push(m.status);if(m.refreshInterval!==void 0)t.push("refreshInterval = ?"),P.push(m.refreshInterval);if(m.isPublic!==void 0)if(t.push("isPublic = ?"),P.push(m.isPublic?1:0),m.isPublic)t.push("shareToken = ?"),P.push(rr("share"));else t.push("shareToken = NULL");P.push(A),await r.execute(`UPDATE analytics_dashboard SET ${t.join(", ")} WHERE id = ?`,P);let W=(await r.query("SELECT * FROM analytics_dashboard WHERE id = ?",[A])).rows;return nr(W[0])}async function c(A){return(await r.query("SELECT * FROM analytics_widget WHERE dashboardId = ? ORDER BY gridY, gridX",[A])).rows.map(Lr)}async function Q(A){let m=rr("widget"),N=new Date().toISOString();await r.execute(`INSERT INTO analytics_widget (id, dashboardId, name, type, gridX, gridY, gridWidth, gridHeight, queryId, config, createdAt, updatedAt)
|
|
6
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,[m,A.dashboardId,A.name,A.type,A.gridX??0,A.gridY??0,A.gridWidth??6,A.gridHeight??4,A.queryId??null,A.config?JSON.stringify(A.config):null,N,N]);let t=(await r.query("SELECT * FROM analytics_widget WHERE id = ?",[m])).rows;return Lr(t[0])}async function k(A,m){let N=new Date().toISOString(),t=["updatedAt = ?"],P=[N];if(m.name!==void 0)t.push("name = ?"),P.push(m.name);if(m.gridX!==void 0)t.push("gridX = ?"),P.push(m.gridX);if(m.gridY!==void 0)t.push("gridY = ?"),P.push(m.gridY);if(m.gridWidth!==void 0)t.push("gridWidth = ?"),P.push(m.gridWidth);if(m.gridHeight!==void 0)t.push("gridHeight = ?"),P.push(m.gridHeight);if(m.queryId!==void 0)t.push("queryId = ?"),P.push(m.queryId??null);if(m.config!==void 0)t.push("config = ?"),P.push(m.config?JSON.stringify(m.config):null);P.push(A),await r.execute(`UPDATE analytics_widget SET ${t.join(", ")} WHERE id = ?`,P);let W=(await r.query("SELECT * FROM analytics_widget WHERE id = ?",[A])).rows;return Lr(W[0])}async function G(A){await r.execute("DELETE FROM analytics_widget WHERE id = ?",[A])}async function L(A){let{projectId:m,type:N,isShared:t,search:P,limit:W=20,offset:H=0}=A,O="WHERE projectId = ?",J=[m];if(N&&N!=="all")O+=" AND type = ?",J.push(N);if(t!==void 0)O+=" AND isShared = ?",J.push(t?1:0);if(P)O+=" AND (name LIKE ? OR description LIKE ?)",J.push(`%${P}%`,`%${P}%`);let Or=(await r.query(`SELECT COUNT(*) as count FROM analytics_query ${O}`,J)).rows[0]?.count??0;return{queries:(await r.query(`SELECT * FROM analytics_query ${O} ORDER BY updatedAt DESC LIMIT ? OFFSET ?`,[...J,W,H])).rows.map(Nr),total:Or}}async function C(A,m){let N=rr("query"),t=new Date().toISOString();await r.execute(`INSERT INTO analytics_query (id, projectId, organizationId, name, description, type, definition, sql, cacheTtlSeconds, isShared, createdAt, updatedAt)
|
|
7
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,[N,m.projectId,m.organizationId,A.name,A.description??null,A.type,JSON.stringify(A.definition),A.sql??null,A.cacheTtlSeconds??300,A.isShared?1:0,t,t]);let P=(await r.query("SELECT * FROM analytics_query WHERE id = ?",[N])).rows;return Nr(P[0])}async function Y(A){let m=(await r.query("SELECT * FROM analytics_query WHERE id = ?",[A])).rows;return m[0]?Nr(m[0]):null}return{listDashboards:o,createDashboard:n,getDashboard:$,updateDashboard:y,getWidgets:c,addWidget:Q,updateWidget:k,deleteWidget:G,listQueries:L,createQuery:C,getQuery:Y}}import{defineEnum as zr}from"@contractspec/lib.schema";var or=zr("QueryType",["SQL","METRIC","AGGREGATION","CUSTOM"]);import{defineSchemaModel as mr,ScalarTypeEnum as D}from"@contractspec/lib.schema";var $r=mr({name:"QueryModel",fields:{id:{type:D.String_unsecure(),isOptional:!1},name:{type:D.String_unsecure(),isOptional:!1},description:{type:D.String_unsecure(),isOptional:!0},type:{type:or,isOptional:!1},definition:{type:D.JSON(),isOptional:!1},sql:{type:D.String_unsecure(),isOptional:!0},cacheTtlSeconds:{type:D.Int_unsecure(),isOptional:!1},isShared:{type:D.Boolean(),isOptional:!1},createdAt:{type:D.DateTime(),isOptional:!1}}}),Pr=mr({name:"QueryResultModel",fields:{queryId:{type:D.String_unsecure(),isOptional:!1},data:{type:D.JSON(),isOptional:!1},columns:{type:D.JSON(),isOptional:!1},rowCount:{type:D.Int_unsecure(),isOptional:!1},executionTimeMs:{type:D.Int_unsecure(),isOptional:!1},cachedAt:{type:D.DateTime(),isOptional:!0},error:{type:D.String_unsecure(),isOptional:!0}}}),Dr=mr({name:"CreateQueryInput",fields:{name:{type:D.NonEmptyString(),isOptional:!1},description:{type:D.String_unsecure(),isOptional:!0},type:{type:or,isOptional:!1},definition:{type:D.JSON(),isOptional:!1},sql:{type:D.String_unsecure(),isOptional:!0},metricIds:{type:D.String_unsecure(),isArray:!0,isOptional:!0},cacheTtlSeconds:{type:D.Int_unsecure(),isOptional:!0},isShared:{type:D.Boolean(),isOptional:!0}}}),Gr=mr({name:"ExecuteQueryInput",fields:{queryId:{type:D.String_unsecure(),isOptional:!1},parameters:{type:D.JSON(),isOptional:!0},dateRange:{type:D.JSON(),isOptional:!0},filters:{type:D.JSON(),isOptional:!0},forceRefresh:{type:D.Boolean(),isOptional:!0}}});import{defineCommand as er,defineQuery as jr}from"@contractspec/lib.contracts-spec/operations";var Hr=["@example.analytics-dashboard"],pr=er({meta:{key:"analytics.query.create",version:"1.0.0",stability:"stable",owners:[...Hr],tags:["analytics","query","create"],description:"Create a data query.",goal:"Define reusable data queries.",context:"Query builder."},io:{input:Dr,output:$r},policy:{auth:"user"},sideEffects:{emits:[{key:"analytics.query.created",version:"1.0.0",stability:"stable",owners:[...Hr],tags:["analytics","query","created"],when:"Query created",payload:$r}],audit:["analytics.query.created"]},acceptance:{scenarios:[{key:"create-query-happy-path",given:["User is authenticated"],when:["User submits valid query definition"],then:["Query is created","QueryCreated event is emitted"]}],examples:[{key:"create-sql-query",input:{name:"Monthly Revenue",sql:"SELECT SUM(amount) FROM orders WHERE date >= :startDate"},output:{id:"query-123",name:"Monthly Revenue",type:"sql"}}]}}),wr=jr({meta:{key:"analytics.query.execute",version:"1.0.0",stability:"stable",owners:[...Hr],tags:["analytics","query","execute"],description:"Execute a data query.",goal:"Fetch data for visualizations.",context:"Dashboard rendering."},io:{input:Gr,output:Pr},policy:{auth:"user"},acceptance:{scenarios:[{key:"execute-query-happy-path",given:["Query exists"],when:["User executes query with parameters"],then:["Query results are returned"]}],examples:[{key:"execute-with-params",input:{queryId:"query-123",params:{startDate:"2025-01-01"}},output:{columns:["total"],rows:[{total:50000}],rowCount:1}}]}});class Zr{cache=new Map;async get(r){let o=this.cache.get(r);if(!o)return null;if(o.expiresAt<new Date)return this.cache.delete(r),null;return{...o.result,cached:!0,cachedAt:o.expiresAt}}async set(r,o,n){let $=new Date(Date.now()+n*1000);this.cache.set(r,{result:o,expiresAt:$})}async invalidate(r){let o=new RegExp(r);for(let n of this.cache.keys())if(o.test(n))this.cache.delete(n)}}class qr{cache;constructor(r){this.cache=r??new Zr}async execute(r,o){let n=Date.now(),$=this.validateQuery(r);if(!$.valid)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:$.errors.join(", ")};let y=this.buildCacheKey(r,o),c=await this.cache.get(y);if(c)return c;let Q;switch(r.type){case"AGGREGATION":if(!r.aggregation)throw Error("Aggregation definition is missing");Q=await this.executeAggregation(r.aggregation,o);break;case"METRIC":if(!r.metricIds)throw Error("Metric IDs are missing");Q=await this.executeMetric(r.metricIds,o);break;case"SQL":if(!r.sql)throw Error("SQL query is missing");Q=await this.executeSql(r.sql,o);break;default:Q={data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-n,cached:!1,error:`Unknown query type: ${r.type}`}}return Q.executionTimeMs=Date.now()-n,Q.cached=!1,await this.cache.set(y,Q,300),Q}validateQuery(r){let o=[];if(!r.type)o.push("Query type is required");switch(r.type){case"SQL":if(!r.sql)o.push("SQL query is required for SQL type");break;case"METRIC":if(!r.metricIds||r.metricIds.length===0)o.push("Metric IDs are required for METRIC type");break;case"AGGREGATION":if(!r.aggregation)o.push("Aggregation definition is required for AGGREGATION type");else{if(!r.aggregation.source)o.push("Aggregation source is required");if(!r.aggregation.measures||r.aggregation.measures.length===0)o.push("At least one measure is required")}break}return{valid:o.length===0,errors:o}}buildCacheKey(r,o){return JSON.stringify({definition:r,params:o})}async executeAggregation(r,o){let n=[...r.dimensions.map((y)=>({name:y.name,type:y.type==="NUMBER"?"NUMBER":y.type==="TIME"?"DATE":"STRING",label:y.name})),...r.measures.map((y)=>({name:y.name,type:"NUMBER",label:y.name,format:y.format}))],$=this.generateMockData(r,o);return{data:$,columns:n,rowCount:$.length,executionTimeMs:0,cached:!1}}async executeMetric(r,o){let n=r.map(($)=>({metricId:$,value:Math.random()*1000,change:(Math.random()-0.5)*20}));return{data:n,columns:[{name:"metricId",type:"STRING"},{name:"value",type:"NUMBER"},{name:"change",type:"NUMBER"}],rowCount:n.length,executionTimeMs:0,cached:!1}}async executeSql(r,o){return{data:[],columns:[],rowCount:0,executionTimeMs:0,cached:!1,error:"SQL execution not implemented in demo"}}generateMockData(r,o){let n=[],$=10,y=r.dimensions.find((c)=>c.type==="TIME");for(let c=0;c<10;c++){let Q={};for(let k of r.dimensions)if(k.type==="TIME"){let G=new Date(o.dateRange?.start??new Date);G.setDate(G.getDate()+c),Q[k.name]=G.toISOString().split("T")[0]}else Q[k.name]=`${k.name}_${c%5}`;for(let k of r.measures){let G=y?100+c*10:Math.random()*1000,L=(Math.random()-0.5)*20;Q[k.name]=Math.round((G+L)*100)/100}n.push(Q)}return n}}function Ao(r){return new qr(r)}import{ComparisonView as br,TimelineView as sr,VisualizationCard as ir,VisualizationGrid as dr}from"@contractspec/lib.design-system";import{jsx as p,jsxs as yr}from"react/jsx-runtime";function Xr({dashboardName:r,widgets:o}){if(!o.length)return yr("div",{className:"rounded-lg border border-dashed p-10 text-center text-muted-foreground",children:['No visualization widgets configured for "',r,'".']});return yr("div",{children:[yr("h3",{className:"mb-4 font-semibold text-lg",children:['Widgets in "',r,'"']}),p(dr,{children:o.map((n)=>p("div",{className:rn(n.gridWidth),children:ar(n)},n.id))})]})}function ar(r){let o=yr("span",{className:"text-muted-foreground text-xs",children:["Position: (",r.gridX,", ",r.gridY,") • ",r.gridWidth,"x",r.gridHeight]});if(r.layout==="comparison")return p(br,{description:r.description,items:r.bindings.map(($)=>({...$,footer:o})),title:r.name});if(r.layout==="timeline")return p(sr,{description:r.description,items:r.bindings.map(($)=>({...$,footer:o})),title:r.name});let n=r.bindings[0];if(!n)return null;return p(ir,{data:n.data,description:r.description??n.description,footer:o,height:n.height,spec:n.spec,title:r.name})}function rn(r){if(r>=12)return"md:col-span-2 xl:col-span-3";if(r>=8)return"xl:col-span-2";if(r>=6)return"md:col-span-2";return""}import{DataTable as nn}from"@contractspec/lib.design-system";import{useContractTable as on}from"@contractspec/lib.presentation-runtime-react";import{Badge as Jr}from"@contractspec/lib.ui-kit-web/ui/badge";import{HStack as mn,VStack as w}from"@contractspec/lib.ui-kit-web/ui/stack";import{Text as v}from"@contractspec/lib.ui-kit-web/ui/text";import{jsx as q,jsxs as F}from"react/jsx-runtime";var $n={SQL:"default",METRIC:"secondary",AGGREGATION:"secondary",CUSTOM:"outline"};function yn(r){return JSON.stringify(r,null,2)}function Kr({queries:r}){let o=on({data:r,columns:[{id:"query",header:"Query",label:"Query",accessor:(n)=>n.name,cell:({item:n})=>F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:n.name}),F(v,{className:"text-muted-foreground text-xs",children:["Updated ",n.updatedAt.toLocaleDateString()]})]}),size:240,minSize:180,canSort:!0,canPin:!0,canResize:!0},{id:"description",header:"Description",label:"Description",accessor:(n)=>n.description??"",cell:({value:n})=>q(v,{className:"line-clamp-2 text-muted-foreground text-sm",children:String(n||"No description")}),size:300,minSize:220,canSort:!1,canHide:!0,canResize:!0},{id:"type",header:"Type",label:"Type",accessorKey:"type",cell:({value:n})=>q(Jr,{variant:$n[String(n)],children:String(n)}),size:150,canSort:!0,canHide:!0,canResize:!0},{id:"cacheTtlSeconds",header:"Cache TTL",label:"Cache TTL",accessorKey:"cacheTtlSeconds",cell:({value:n})=>`${String(n)}s`,align:"right",size:140,canSort:!0,canResize:!0},{id:"isShared",header:"Shared",label:"Shared",accessorKey:"isShared",cell:({value:n})=>q(Jr,{variant:n?"default":"outline",children:n?"Shared":"Private"}),size:140,canSort:!0,canHide:!0,canResize:!0}],initialState:{pagination:{pageIndex:0,pageSize:3},columnVisibility:{description:!1},columnPinning:{left:["query"],right:[]}},renderExpandedContent:(n)=>F(w,{gap:"sm",className:"py-2",children:[F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:"Description"}),q(v,{className:"text-muted-foreground text-sm",children:n.description??"No description"})]}),n.sql?F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:"SQL"}),q("pre",{className:"overflow-auto rounded-md bg-muted/40 p-3 text-xs",children:n.sql})]}):null,F(w,{gap:"xs",children:[q(v,{className:"font-medium text-sm",children:"Definition"}),q("pre",{className:"overflow-auto rounded-md bg-muted/40 p-3 text-xs",children:yn(n.definition)})]})]}),getCanExpand:()=>!0});return q(nn,{controller:o,title:"Saved Queries",description:"Client-mode table using the shared ContractSpec controller and renderer.",toolbar:F(mn,{gap:"sm",className:"flex-wrap",children:[F(v,{className:"text-muted-foreground text-sm",children:[r.length," queries"]}),F(v,{className:"text-muted-foreground text-sm",children:[r.filter((n)=>n.isShared).length," shared"]})]}),emptyState:q("div",{className:"rounded-md border border-dashed p-8 text-center text-muted-foreground text-sm",children:"No queries saved"})})}import{useTemplateRuntime as cn}from"@contractspec/lib.example-shared-ui";import{useCallback as Cr,useEffect as An,useState as x}from"react";function Br(r="local-project"){let{handlers:o}=cn(),n=o.analytics,[$,y]=x([]),[c,Q]=x([]),[k,G]=x(null),[L,C]=x([]),[Y,A]=x(!0),[m,N]=x(null),t=Cr(async()=>{try{A(!0),N(null);let[H,O]=await Promise.all([n.listDashboards({projectId:r,limit:100}),n.listQueries({projectId:r,limit:100})]);if(y(H.dashboards),Q(O.queries),H.dashboards.length>0&&!k){let J=H.dashboards[0];if(J){G(J);let T=await n.getWidgets(J.id);C(T.length>0?T:u(J.id))}}}catch(H){N(H instanceof Error?H:Error("Failed to load analytics"))}finally{A(!1)}},[n,r,k]);An(()=>{t()},[t]);let P=Cr(async(H)=>{G(H);let O=await n.getWidgets(H.id);C(O.length>0?O:u(H.id))},[n]),W={totalDashboards:$.length,publishedDashboards:$.filter((H)=>H.status==="PUBLISHED").length,totalQueries:c.length,sharedQueries:c.filter((H)=>H.isShared).length};return{dashboards:$,queries:c,selectedDashboard:k,widgets:L,loading:Y,error:m,stats:W,refetch:t,selectDashboard:P}}import{Button as Wr,ErrorState as kn,LoaderBlock as tn,StatCard as Mr,StatCardGroup as Qn}from"@contractspec/lib.design-system";import{useMemo as Ln,useState as Nn}from"react";import{jsx as M,jsxs as X}from"react/jsx-runtime";var Pn={PUBLISHED:"bg-green-100 text-green-700 dark:bg-green-900/30 dark:text-green-400",DRAFT:"bg-gray-100 text-gray-700 dark:bg-gray-900/30 dark:text-gray-400",ARCHIVED:"bg-yellow-100 text-yellow-700 dark:bg-yellow-900/30 dark:text-yellow-400"};function Dn(){let[r,o]=Nn("dashboards"),{dashboards:n,queries:$,selectedDashboard:y,widgets:c,loading:Q,error:k,stats:G,refetch:L,selectDashboard:C}=Br(),Y=[{id:"dashboards",label:"Dashboards",icon:"\uD83D\uDCCA"},{id:"queries",label:"Queries",icon:"\uD83D\uDD0D"}],A=Ln(()=>c.map((m)=>j(m)).filter((m)=>Boolean(m)),[c]);if(Q)return M(tn,{label:"Loading Analytics..."});if(k)return M(kn,{title:"Failed to load Analytics",description:k.message,onRetry:L,retryLabel:"Retry"});return X("div",{className:"space-y-6",children:[X("div",{className:"flex items-center justify-between",children:[M("h2",{className:"font-bold text-2xl",children:"Analytics Dashboard"}),X(Wr,{onClick:()=>alert("Create dashboard modal"),children:[M("span",{className:"mr-2",children:"+"})," New Dashboard"]})]}),X(Qn,{children:[M(Mr,{label:"Dashboards",value:G.totalDashboards,hint:`${G.publishedDashboards} published`}),M(Mr,{label:"Queries",value:G.totalQueries,hint:`${G.sharedQueries} shared`}),M(Mr,{label:"Widgets",value:c.length,hint:"on current dashboard"})]}),M("nav",{className:"flex gap-1 rounded-lg bg-muted p-1",role:"tablist",children:Y.map((m)=>X(Wr,{type:"button",role:"tab","aria-selected":r===m.id,onClick:()=>o(m.id),className:`flex flex-1 items-center justify-center gap-2 rounded-md px-4 py-2 font-medium text-sm transition-colors ${r===m.id?"bg-background text-foreground shadow-sm":"text-muted-foreground hover:text-foreground"}`,children:[M("span",{children:m.icon}),m.label]},m.id))}),X("div",{className:"min-h-[400px]",role:"tabpanel",children:[r==="dashboards"&&X("div",{className:"space-y-6",children:[X("div",{className:"grid gap-4 sm:grid-cols-2 lg:grid-cols-3",children:[n.map((m)=>X("div",{onClick:()=>C(m),className:`cursor-pointer rounded-lg border border-border bg-card p-4 transition-all ${y?.id===m.id?"ring-2 ring-primary":"hover:bg-muted/50"}`,role:"button",tabIndex:0,onKeyDown:(N)=>{if(N.key==="Enter"||N.key===" ")C(m)},children:[X("div",{className:"mb-2 flex items-center justify-between",children:[M("h3",{className:"font-medium",children:m.name}),M("span",{className:`inline-flex rounded-full px-2 py-0.5 font-medium text-xs ${Pn[m.status]??""}`,children:m.status})]}),M("p",{className:"mb-3 text-muted-foreground text-sm",children:m.description}),X("div",{className:"flex items-center justify-between text-muted-foreground text-xs",children:[X("span",{children:["/",m.slug]}),m.isPublic&&M("span",{className:"text-green-600 dark:text-green-400",children:"\uD83C\uDF10 Public"})]})]},m.id)),n.length===0&&M("div",{className:"col-span-full flex h-64 items-center justify-center text-muted-foreground",children:"No dashboards created yet"})]}),y?M(Xr,{dashboardName:y.name,widgets:A}):null]}),r==="queries"&&M(Kr,{queries:$})]})]})}var cr=[{id:"dash-1",name:"Sales Overview",slug:"sales-overview",status:"PUBLISHED",widgetCount:11,viewCount:1250,lastViewedAt:"2026-03-18T12:00:00Z"},{id:"dash-2",name:"User Engagement",slug:"user-engagement",status:"PUBLISHED",widgetCount:8,viewCount:890,lastViewedAt:"2026-03-18T10:00:00Z"}],vr=[{id:"q-1",name:"Monthly Revenue",type:"AGGREGATION",isShared:!0,executionCount:1500},{id:"q-2",name:"User Growth",type:"METRIC",isShared:!0,executionCount:890},{id:"q-3",name:"Product Sales",type:"SQL",isShared:!1,executionCount:340},{id:"q-4",name:"Conversion Funnel",type:"AGGREGATION",isShared:!0,executionCount:450}];function Gn(r){return u(r).map((o)=>j(o)).filter((o)=>Boolean(o))}var Hn={target:"markdown",render:async(r)=>{if(r.source.type!=="component"||r.source.componentKey!=="AnalyticsDashboard")throw Error("analyticsDashboardMarkdownRenderer: not AnalyticsDashboard");let o=cr[0];if(!o)return{mimeType:"text/markdown",body:`# No Dashboards
|
|
8
8
|
|
|
9
|
-
No dashboards available.`};let n=
|
|
10
|
-
`)}}},
|
|
11
|
-
`)}}},
|
|
12
|
-
`)}}};export{B as visualizationRefKey,Br as useAnalyticsData,j as resolveAnalyticsWidget,Z as refOf,
|
|
9
|
+
No dashboards available.`};let n=Gn(o.id),$=n.filter((c)=>c.bindings[0]?.spec.visualization.kind==="metric"),y=[`# ${o.name}`,"","> Contract-backed analytics dashboard overview.","","## Key Metrics",""];for(let c of $){let Q=c.bindings[0];if(!Q)continue;y.push(`- **${c.name}** via \`${Q.spec.meta.key}\``)}y.push(""),y.push("## Visual Blocks"),y.push("");for(let c of n){let Q=c.bindings.map((k)=>k.spec.visualization.kind).join(", ");y.push(`- **${c.name}** (${c.layout}) → ${Q}`)}return y.push(""),y.push("## Dashboard Stats"),y.push(""),y.push("| Metric | Value |"),y.push("|--------|-------|"),y.push(`| Total Dashboards | ${cr.length} |`),y.push(`| Published | ${cr.filter((c)=>c.status==="PUBLISHED").length} |`),y.push(`| Shared Queries | ${vr.filter((c)=>c.isShared).length} |`),{mimeType:"text/markdown",body:y.join(`
|
|
10
|
+
`)}}},Bn={target:"markdown",render:async(r)=>{if(r.source.type!=="component"||r.source.componentKey!=="DashboardList")throw Error("dashboardListMarkdownRenderer: not DashboardList");let o=["# Dashboards","","> Browse and manage analytics dashboards","","| Dashboard | Widgets | Views | Status | Last Viewed |","|-----------|---------|-------|--------|-------------|"];for(let n of cr){let $=n.lastViewedAt?new Date(n.lastViewedAt).toLocaleDateString():"Never",y=n.status==="PUBLISHED"?"\uD83D\uDFE2":"⚫";o.push(`| [${n.name}](/dashboards/${n.slug}) | ${n.widgetCount} | ${n.viewCount.toLocaleString()} | ${y} ${n.status} | ${$} |`)}return{mimeType:"text/markdown",body:o.join(`
|
|
11
|
+
`)}}},Mn={target:"markdown",render:async(r)=>{if(r.source.type!=="component"||r.source.componentKey!=="QueryBuilder")throw Error("queryBuilderMarkdownRenderer: not QueryBuilder");let o=["# Query Builder","","> Create and manage reusable data queries.","","| Query | Type | Shared | Executions |","|-------|------|--------|------------|"];for(let n of vr)o.push(`| ${n.name} | ${n.type} | ${n.isShared?"\uD83C\uDF10":"\uD83D\uDD12"} | ${n.executionCount.toLocaleString()} |`);return o.push(""),o.push("## Visualization Contracts"),o.push(""),o.push("Widgets reference `VisualizationSpec` contracts instead of rendering ad-hoc widget types."),{mimeType:"text/markdown",body:o.join(`
|
|
12
|
+
`)}}};export{B as visualizationRefKey,Br as useAnalyticsData,j as resolveAnalyticsWidget,Z as refOf,Mn as queryBuilderMarkdownRenderer,Bn as dashboardListMarkdownRenderer,Ao as createQueryEngine,Sr as createPosthogQueryEngine,u as createExampleWidgets,jn as createAnalyticsHandlers,Hn as analyticsDashboardMarkdownRenderer,f as RevenueTrendVisualization,I as RevenueMetricVisualization,S as RetentionAreaVisualization,h as RegionalRevenueVisualization,or as QueryTypeEnum,Pr as QueryResultModel,$r as QueryModel,Qr as PosthogQueryEngine,V as PipelineScatterVisualization,Zr as InMemoryQueryCache,Gr as ExecuteQueryInputModel,wr as ExecuteQueryContract,Tr as ExamplesAnalyticsDashboardExample,g as EngagementHeatmapVisualization,Dr as CreateQueryInputModel,pr as CreateQueryContract,_ as ConversionFunnelVisualization,R as ChannelMixVisualization,qr as BasicQueryEngine,d as AnalyticsVisualizationSpecs,kr as AnalyticsVisualizationSpecMap,a as AnalyticsVisualizationSampleData,Yr as AnalyticsVisualizationRegistry,Ar as AnalyticsVisualizationRefs,Vn as AnalyticsDashboardFeature,Dn as AnalyticsDashboard,E as AccountCoverageGeoVisualization};
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@contractspec/example.analytics-dashboard",
|
|
3
|
-
"version": "3.9.
|
|
3
|
+
"version": "3.9.14",
|
|
4
4
|
"description": "Analytics Dashboard example with widgets and query engine for ContractSpec",
|
|
5
5
|
"types": "./dist/index.d.ts",
|
|
6
6
|
"type": "module",
|
|
@@ -21,21 +21,21 @@
|
|
|
21
21
|
},
|
|
22
22
|
"dependencies": {
|
|
23
23
|
"@contractspec/lib.schema": "3.7.14",
|
|
24
|
-
"@contractspec/lib.contracts-spec": "5.
|
|
25
|
-
"@contractspec/lib.contracts-integrations": "3.8.
|
|
26
|
-
"@contractspec/lib.example-shared-ui": "6.0.
|
|
27
|
-
"@contractspec/lib.design-system": "3.
|
|
28
|
-
"@contractspec/lib.runtime-sandbox": "2.7.
|
|
24
|
+
"@contractspec/lib.contracts-spec": "5.5.0",
|
|
25
|
+
"@contractspec/lib.contracts-integrations": "3.8.13",
|
|
26
|
+
"@contractspec/lib.example-shared-ui": "6.0.22",
|
|
27
|
+
"@contractspec/lib.design-system": "3.11.0",
|
|
28
|
+
"@contractspec/lib.runtime-sandbox": "2.7.15",
|
|
29
29
|
"react": "19.2.0",
|
|
30
30
|
"react-dom": "19.2.0",
|
|
31
|
-
"@contractspec/lib.presentation-runtime-core": "
|
|
31
|
+
"@contractspec/lib.presentation-runtime-core": "5.0.0"
|
|
32
32
|
},
|
|
33
33
|
"devDependencies": {
|
|
34
34
|
"@contractspec/tool.typescript": "3.7.13",
|
|
35
35
|
"typescript": "^5.9.3",
|
|
36
36
|
"@types/react": "^19.2.14",
|
|
37
37
|
"@types/react-dom": "^19.2.2",
|
|
38
|
-
"@contractspec/tool.bun": "3.7.
|
|
38
|
+
"@contractspec/tool.bun": "3.7.15",
|
|
39
39
|
"happy-dom": "^20.8.9"
|
|
40
40
|
},
|
|
41
41
|
"exports": {
|