@contractspec/example.analytics-dashboard 1.56.0 → 1.57.0

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.
Files changed (53) hide show
  1. package/dist/dashboard/dashboard.enum.d.ts +4 -4
  2. package/dist/dashboard/dashboard.enum.d.ts.map +1 -1
  3. package/dist/dashboard/dashboard.operation.d.ts +131 -131
  4. package/dist/dashboard/dashboard.operation.d.ts.map +1 -1
  5. package/dist/dashboard/dashboard.presentation.d.ts +4 -4
  6. package/dist/dashboard/dashboard.presentation.d.ts.map +1 -1
  7. package/dist/dashboard/dashboard.schema.d.ts +79 -79
  8. package/dist/dashboard/dashboard.schema.d.ts.map +1 -1
  9. package/dist/dashboard/dashboard.test-spec.d.ts +5 -5
  10. package/dist/dashboard/dashboard.test-spec.d.ts.map +1 -1
  11. package/dist/dashboard.feature.d.ts +0 -1
  12. package/dist/dashboard.feature.d.ts.map +1 -1
  13. package/dist/datasource/posthog-datasource.d.ts +22 -0
  14. package/dist/datasource/posthog-datasource.d.ts.map +1 -0
  15. package/dist/datasource/posthog-datasource.js +254 -0
  16. package/dist/datasource/posthog-datasource.js.map +1 -0
  17. package/dist/docs/analytics-dashboard.docblock.js +1 -0
  18. package/dist/docs/analytics-dashboard.docblock.js.map +1 -1
  19. package/dist/events.d.ts +7 -7
  20. package/dist/events.d.ts.map +1 -1
  21. package/dist/example.d.ts.map +1 -1
  22. package/dist/example.js +1 -2
  23. package/dist/example.js.map +1 -1
  24. package/dist/handlers/analytics.handlers.d.ts +0 -1
  25. package/dist/handlers/analytics.handlers.d.ts.map +1 -1
  26. package/dist/handlers/index.d.ts +2 -1
  27. package/dist/handlers/index.js +2 -1
  28. package/dist/handlers/query.handlers.d.ts +13 -0
  29. package/dist/handlers/query.handlers.d.ts.map +1 -0
  30. package/dist/handlers/query.handlers.js +10 -0
  31. package/dist/handlers/query.handlers.js.map +1 -0
  32. package/dist/index.d.ts +3 -2
  33. package/dist/index.js +2 -1
  34. package/dist/query/query.enum.d.ts +2 -2
  35. package/dist/query/query.enum.d.ts.map +1 -1
  36. package/dist/query/query.operation.d.ts +45 -45
  37. package/dist/query/query.operation.d.ts.map +1 -1
  38. package/dist/query/query.presentation.d.ts +3 -3
  39. package/dist/query/query.presentation.d.ts.map +1 -1
  40. package/dist/query/query.schema.d.ts +34 -34
  41. package/dist/query/query.schema.d.ts.map +1 -1
  42. package/dist/query/query.test-spec.d.ts +3 -3
  43. package/dist/query/query.test-spec.d.ts.map +1 -1
  44. package/dist/query-engine/index.d.ts +3 -1
  45. package/dist/query-engine/index.d.ts.map +1 -1
  46. package/dist/query-engine/index.js +3 -1
  47. package/dist/query-engine/index.js.map +1 -1
  48. package/dist/seeders/index.d.ts.map +1 -1
  49. package/dist/ui/AnalyticsDashboard.d.ts.map +1 -1
  50. package/dist/ui/hooks/useAnalyticsData.d.ts.map +1 -1
  51. package/dist/ui/renderers/analytics.markdown.d.ts +0 -1
  52. package/dist/ui/renderers/analytics.markdown.d.ts.map +1 -1
  53. package/package.json +15 -9
@@ -0,0 +1,254 @@
1
+ //#region src/datasource/posthog-datasource.ts
2
+ var PosthogQueryEngine = class {
3
+ reader;
4
+ defaultLimit;
5
+ constructor(reader, options = {}) {
6
+ this.reader = reader;
7
+ this.defaultLimit = options.defaultLimit ?? 100;
8
+ }
9
+ async execute(definition, params) {
10
+ const startTime = Date.now();
11
+ const validation = this.validateQuery(definition);
12
+ if (!validation.valid) return {
13
+ data: [],
14
+ columns: [],
15
+ rowCount: 0,
16
+ executionTimeMs: Date.now() - startTime,
17
+ cached: false,
18
+ error: validation.errors.join(", ")
19
+ };
20
+ if (!this.reader.queryHogQL) return {
21
+ data: [],
22
+ columns: [],
23
+ rowCount: 0,
24
+ executionTimeMs: Date.now() - startTime,
25
+ cached: false,
26
+ error: "Analytics reader does not support HogQL queries."
27
+ };
28
+ try {
29
+ const result = await this.executeHogQL(definition, params);
30
+ return {
31
+ data: result.data,
32
+ columns: result.columns,
33
+ rowCount: result.rowCount,
34
+ executionTimeMs: Date.now() - startTime,
35
+ cached: false
36
+ };
37
+ } catch (error) {
38
+ return {
39
+ data: [],
40
+ columns: [],
41
+ rowCount: 0,
42
+ executionTimeMs: Date.now() - startTime,
43
+ cached: false,
44
+ error: error instanceof Error ? error.message : "Unknown error"
45
+ };
46
+ }
47
+ }
48
+ validateQuery(definition) {
49
+ const errors = [];
50
+ if (definition.type === "SQL" && !definition.sql) errors.push("SQL query is missing.");
51
+ if (definition.type === "AGGREGATION" && !definition.aggregation) errors.push("Aggregation definition is missing.");
52
+ if (definition.type === "METRIC" && !definition.metricIds?.length) errors.push("Metric IDs are missing.");
53
+ if (definition.type === "CUSTOM" && !definition.custom?.handler) errors.push("Custom handler is missing.");
54
+ return {
55
+ valid: errors.length === 0,
56
+ errors
57
+ };
58
+ }
59
+ async executeHogQL(definition, params) {
60
+ if (!this.reader.queryHogQL) throw new Error("Analytics reader does not support HogQL queries.");
61
+ if (definition.type === "SQL") return mapHogqlResult(await this.reader.queryHogQL({
62
+ query: definition.sql ?? "",
63
+ values: params.parameters ?? {}
64
+ }));
65
+ if (definition.type === "AGGREGATION" && definition.aggregation) {
66
+ const { query, values } = buildAggregationQuery(definition.aggregation, params);
67
+ return mapHogqlResult(await this.reader.queryHogQL({
68
+ query,
69
+ values
70
+ }));
71
+ }
72
+ if (definition.type === "METRIC" && definition.metricIds) {
73
+ const { query, values } = buildMetricQuery(definition.metricIds, params);
74
+ return mapHogqlResult(await this.reader.queryHogQL({
75
+ query,
76
+ values
77
+ }));
78
+ }
79
+ throw new Error("Unsupported query type for PostHog datasource.");
80
+ }
81
+ };
82
+ function createPosthogQueryEngine(reader, options) {
83
+ return new PosthogQueryEngine(reader, options);
84
+ }
85
+ function buildMetricQuery(metricIds, params) {
86
+ const range = resolveDateRange(params);
87
+ const values = {
88
+ dateFrom: range?.from.toISOString(),
89
+ dateTo: range?.to.toISOString()
90
+ };
91
+ const metricClauses = metricIds.map((metricId, index) => {
92
+ values[`metric${index}`] = metricId;
93
+ return `event = {metric${index}}`;
94
+ });
95
+ const whereClauses = [metricClauses.length ? `(${metricClauses.join(" or ")})` : "", range ? "timestamp >= {dateFrom} and timestamp < {dateTo}" : ""].filter(Boolean).join(" and ");
96
+ return {
97
+ query: [
98
+ "select",
99
+ " event as metric,",
100
+ " count() as total",
101
+ "from events",
102
+ whereClauses ? `where ${whereClauses}` : "",
103
+ "group by metric"
104
+ ].filter(Boolean).join("\n"),
105
+ values
106
+ };
107
+ }
108
+ function buildAggregationQuery(aggregation, params) {
109
+ const measures = aggregation.measures.map((measure) => ({
110
+ ...measure,
111
+ expression: buildMeasureExpression(measure.field, measure.aggregation)
112
+ }));
113
+ const dimensions = aggregation.dimensions.map((dimension) => ({
114
+ ...dimension,
115
+ expression: buildDimensionExpression(dimension.field, dimension.type, dimension.granularity)
116
+ }));
117
+ const selections = [...dimensions.map((dimension) => `${dimension.expression} as ${dimension.name}`), ...measures.map((measure) => `${measure.expression} as ${measure.name}`)];
118
+ const values = {};
119
+ const filters = buildFilterClauses(aggregation, params, values);
120
+ const limit = aggregation.limit ?? 100;
121
+ const orderBy = aggregation.orderBy?.length ? `order by ${aggregation.orderBy.map((order) => `${order.field} ${order.direction}`).join(", ")}` : "";
122
+ return {
123
+ query: [
124
+ "select",
125
+ ` ${selections.join(",\n ")}`,
126
+ `from ${aggregation.source}`,
127
+ filters.length ? `where ${filters.join(" and ")}` : "",
128
+ dimensions.length ? `group by ${dimensions.map((d) => d.name).join(", ")}` : "",
129
+ orderBy,
130
+ `limit ${limit}`
131
+ ].filter(Boolean).join("\n"),
132
+ values
133
+ };
134
+ }
135
+ function buildMeasureExpression(field, aggregation) {
136
+ switch (aggregation) {
137
+ case "COUNT": return field === "*" ? "count()" : `count(${field})`;
138
+ case "COUNT_DISTINCT": return `countDistinct(${field})`;
139
+ case "SUM": return `sum(${field})`;
140
+ case "AVG": return `avg(${field})`;
141
+ case "MIN": return `min(${field})`;
142
+ case "MAX": return `max(${field})`;
143
+ default: return `count(${field})`;
144
+ }
145
+ }
146
+ function buildDimensionExpression(field, type, granularity) {
147
+ if (type === "TIME") switch (granularity) {
148
+ case "HOUR": return `toStartOfHour(${field})`;
149
+ case "WEEK": return `toStartOfWeek(${field})`;
150
+ case "MONTH": return `toStartOfMonth(${field})`;
151
+ case "YEAR": return `toStartOfYear(${field})`;
152
+ default: return `toStartOfDay(${field})`;
153
+ }
154
+ return field;
155
+ }
156
+ function buildFilterClauses(aggregation, params, values) {
157
+ const clauses = [];
158
+ const range = resolveDateRange(params);
159
+ if (range) {
160
+ values.dateFrom = range.from.toISOString();
161
+ values.dateTo = range.to.toISOString();
162
+ clauses.push(`timestamp >= {dateFrom} and timestamp < {dateTo}`);
163
+ }
164
+ aggregation.filters?.forEach((filter, index) => {
165
+ const key = `filter${index}`;
166
+ switch (filter.operator) {
167
+ case "eq":
168
+ values[key] = filter.value;
169
+ clauses.push(`${filter.field} = {${key}}`);
170
+ break;
171
+ case "neq":
172
+ values[key] = filter.value;
173
+ clauses.push(`${filter.field} != {${key}}`);
174
+ break;
175
+ case "gt":
176
+ values[key] = filter.value;
177
+ clauses.push(`${filter.field} > {${key}}`);
178
+ break;
179
+ case "gte":
180
+ values[key] = filter.value;
181
+ clauses.push(`${filter.field} >= {${key}}`);
182
+ break;
183
+ case "lt":
184
+ values[key] = filter.value;
185
+ clauses.push(`${filter.field} < {${key}}`);
186
+ break;
187
+ case "lte":
188
+ values[key] = filter.value;
189
+ clauses.push(`${filter.field} <= {${key}}`);
190
+ break;
191
+ case "contains":
192
+ values[key] = filter.value;
193
+ clauses.push(`${filter.field} LIKE '%' || {${key}} || '%'`);
194
+ break;
195
+ case "between":
196
+ if (Array.isArray(filter.value) && filter.value.length >= 2) {
197
+ values[`${key}Start`] = filter.value[0];
198
+ values[`${key}End`] = filter.value[1];
199
+ clauses.push(`${filter.field} BETWEEN {${key}Start} AND {${key}End}`);
200
+ }
201
+ break;
202
+ case "in":
203
+ case "nin":
204
+ if (Array.isArray(filter.value)) {
205
+ const placeholders = [];
206
+ filter.value.forEach((value, valueIndex) => {
207
+ const valueKey = `${key}_${valueIndex}`;
208
+ values[valueKey] = value;
209
+ placeholders.push(`{${valueKey}}`);
210
+ });
211
+ if (placeholders.length) clauses.push(`${filter.field} ${filter.operator === "in" ? "IN" : "NOT IN"} (${placeholders.join(", ")})`);
212
+ }
213
+ break;
214
+ default: break;
215
+ }
216
+ });
217
+ return clauses;
218
+ }
219
+ function resolveDateRange(params) {
220
+ const range = params.dateRange;
221
+ if (!range) return null;
222
+ return {
223
+ from: range.start,
224
+ to: range.end
225
+ };
226
+ }
227
+ function mapHogqlResult(result) {
228
+ if (!Array.isArray(result.results) || !Array.isArray(result.columns)) return {
229
+ data: [],
230
+ columns: [],
231
+ rowCount: 0
232
+ };
233
+ const columns = result.columns.map((name) => ({
234
+ name,
235
+ type: "STRING"
236
+ }));
237
+ const data = result.results.map((row) => {
238
+ if (!Array.isArray(row)) return {};
239
+ const record = {};
240
+ result.columns?.forEach((column, index) => {
241
+ record[column] = row[index];
242
+ });
243
+ return record;
244
+ });
245
+ return {
246
+ data,
247
+ columns,
248
+ rowCount: data.length
249
+ };
250
+ }
251
+
252
+ //#endregion
253
+ export { PosthogQueryEngine, createPosthogQueryEngine };
254
+ //# sourceMappingURL=posthog-datasource.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"posthog-datasource.js","names":[],"sources":["../../src/datasource/posthog-datasource.ts"],"sourcesContent":["import type {\n AnalyticsQueryResult,\n AnalyticsReader,\n} from '@contractspec/lib.contracts/integrations/providers/analytics';\nimport type {\n AggregationDefinition,\n ColumnDefinition,\n IQueryEngine,\n QueryDefinition,\n QueryParameters,\n QueryResult,\n} from '../query-engine';\n\nexport interface PosthogQueryEngineOptions {\n defaultLimit?: number;\n}\n\nexport class PosthogQueryEngine implements IQueryEngine {\n private readonly reader: AnalyticsReader;\n private readonly defaultLimit: number;\n\n constructor(\n reader: AnalyticsReader,\n options: PosthogQueryEngineOptions = {}\n ) {\n this.reader = reader;\n this.defaultLimit = options.defaultLimit ?? 100;\n }\n\n async execute(\n definition: QueryDefinition,\n params: QueryParameters\n ): Promise<QueryResult> {\n const startTime = Date.now();\n const validation = this.validateQuery(definition);\n if (!validation.valid) {\n return {\n data: [],\n columns: [],\n rowCount: 0,\n executionTimeMs: Date.now() - startTime,\n cached: false,\n error: validation.errors.join(', '),\n };\n }\n\n if (!this.reader.queryHogQL) {\n return {\n data: [],\n columns: [],\n rowCount: 0,\n executionTimeMs: Date.now() - startTime,\n cached: false,\n error: 'Analytics reader does not support HogQL queries.',\n };\n }\n\n try {\n const result = await this.executeHogQL(definition, params);\n return {\n data: result.data,\n columns: result.columns,\n rowCount: result.rowCount,\n executionTimeMs: Date.now() - startTime,\n cached: false,\n };\n } catch (error) {\n return {\n data: [],\n columns: [],\n rowCount: 0,\n executionTimeMs: Date.now() - startTime,\n cached: false,\n error: error instanceof Error ? error.message : 'Unknown error',\n };\n }\n }\n\n validateQuery(definition: QueryDefinition): {\n valid: boolean;\n errors: string[];\n } {\n const errors: string[] = [];\n if (definition.type === 'SQL' && !definition.sql) {\n errors.push('SQL query is missing.');\n }\n if (definition.type === 'AGGREGATION' && !definition.aggregation) {\n errors.push('Aggregation definition is missing.');\n }\n if (definition.type === 'METRIC' && !definition.metricIds?.length) {\n errors.push('Metric IDs are missing.');\n }\n if (definition.type === 'CUSTOM' && !definition.custom?.handler) {\n errors.push('Custom handler is missing.');\n }\n return { valid: errors.length === 0, errors };\n }\n\n private async executeHogQL(\n definition: QueryDefinition,\n params: QueryParameters\n ): Promise<{\n data: Record<string, unknown>[];\n columns: ColumnDefinition[];\n rowCount: number;\n }> {\n if (!this.reader.queryHogQL) {\n throw new Error('Analytics reader does not support HogQL queries.');\n }\n if (definition.type === 'SQL') {\n const result = await this.reader.queryHogQL({\n query: definition.sql ?? '',\n values: params.parameters ?? {},\n });\n return mapHogqlResult(result);\n }\n if (definition.type === 'AGGREGATION' && definition.aggregation) {\n const { query, values } = buildAggregationQuery(\n definition.aggregation,\n params\n );\n const result = await this.reader.queryHogQL({ query, values });\n return mapHogqlResult(result);\n }\n if (definition.type === 'METRIC' && definition.metricIds) {\n const { query, values } = buildMetricQuery(definition.metricIds, params);\n const result = await this.reader.queryHogQL({ query, values });\n return mapHogqlResult(result);\n }\n throw new Error('Unsupported query type for PostHog datasource.');\n }\n}\n\nexport function createPosthogQueryEngine(\n reader: AnalyticsReader,\n options?: PosthogQueryEngineOptions\n): IQueryEngine {\n return new PosthogQueryEngine(reader, options);\n}\n\nfunction buildMetricQuery(\n metricIds: string[],\n params: QueryParameters\n): { query: string; values: Record<string, unknown> } {\n const range = resolveDateRange(params);\n const values: Record<string, unknown> = {\n dateFrom: range?.from.toISOString(),\n dateTo: range?.to.toISOString(),\n };\n const metricClauses = metricIds.map((metricId, index) => {\n values[`metric${index}`] = metricId;\n return `event = {metric${index}}`;\n });\n const whereClauses = [\n metricClauses.length ? `(${metricClauses.join(' or ')})` : '',\n range ? 'timestamp >= {dateFrom} and timestamp < {dateTo}' : '',\n ]\n .filter(Boolean)\n .join(' and ');\n\n return {\n query: [\n 'select',\n ' event as metric,',\n ' count() as total',\n 'from events',\n whereClauses ? `where ${whereClauses}` : '',\n 'group by metric',\n ]\n .filter(Boolean)\n .join('\\n'),\n values,\n };\n}\n\nfunction buildAggregationQuery(\n aggregation: AggregationDefinition,\n params: QueryParameters\n): { query: string; values: Record<string, unknown> } {\n const measures = aggregation.measures.map((measure) => ({\n ...measure,\n expression: buildMeasureExpression(measure.field, measure.aggregation),\n }));\n const dimensions = aggregation.dimensions.map((dimension) => ({\n ...dimension,\n expression: buildDimensionExpression(\n dimension.field,\n dimension.type,\n dimension.granularity\n ),\n }));\n const selections = [\n ...dimensions.map(\n (dimension) => `${dimension.expression} as ${dimension.name}`\n ),\n ...measures.map((measure) => `${measure.expression} as ${measure.name}`),\n ];\n const values: Record<string, unknown> = {};\n const filters = buildFilterClauses(aggregation, params, values);\n const limit = aggregation.limit ?? 100;\n const orderBy = aggregation.orderBy?.length\n ? `order by ${aggregation.orderBy\n .map((order) => `${order.field} ${order.direction}`)\n .join(', ')}`\n : '';\n\n return {\n query: [\n 'select',\n ` ${selections.join(',\\n ')}`,\n `from ${aggregation.source}`,\n filters.length ? `where ${filters.join(' and ')}` : '',\n dimensions.length\n ? `group by ${dimensions.map((d) => d.name).join(', ')}`\n : '',\n orderBy,\n `limit ${limit}`,\n ]\n .filter(Boolean)\n .join('\\n'),\n values,\n };\n}\n\nfunction buildMeasureExpression(field: string, aggregation: string): string {\n switch (aggregation) {\n case 'COUNT':\n return field === '*' ? 'count()' : `count(${field})`;\n case 'COUNT_DISTINCT':\n return `countDistinct(${field})`;\n case 'SUM':\n return `sum(${field})`;\n case 'AVG':\n return `avg(${field})`;\n case 'MIN':\n return `min(${field})`;\n case 'MAX':\n return `max(${field})`;\n default:\n return `count(${field})`;\n }\n}\n\nfunction buildDimensionExpression(\n field: string,\n type?: string,\n granularity?: string\n): string {\n if (type === 'TIME') {\n switch (granularity) {\n case 'HOUR':\n return `toStartOfHour(${field})`;\n case 'WEEK':\n return `toStartOfWeek(${field})`;\n case 'MONTH':\n return `toStartOfMonth(${field})`;\n case 'YEAR':\n return `toStartOfYear(${field})`;\n case 'DAY':\n default:\n return `toStartOfDay(${field})`;\n }\n }\n return field;\n}\n\nfunction buildFilterClauses(\n aggregation: AggregationDefinition,\n params: QueryParameters,\n values: Record<string, unknown>\n): string[] {\n const clauses: string[] = [];\n const range = resolveDateRange(params);\n if (range) {\n values.dateFrom = range.from.toISOString();\n values.dateTo = range.to.toISOString();\n clauses.push(`timestamp >= {dateFrom} and timestamp < {dateTo}`);\n }\n\n aggregation.filters?.forEach((filter, index) => {\n const key = `filter${index}`;\n switch (filter.operator) {\n case 'eq':\n values[key] = filter.value;\n clauses.push(`${filter.field} = {${key}}`);\n break;\n case 'neq':\n values[key] = filter.value;\n clauses.push(`${filter.field} != {${key}}`);\n break;\n case 'gt':\n values[key] = filter.value;\n clauses.push(`${filter.field} > {${key}}`);\n break;\n case 'gte':\n values[key] = filter.value;\n clauses.push(`${filter.field} >= {${key}}`);\n break;\n case 'lt':\n values[key] = filter.value;\n clauses.push(`${filter.field} < {${key}}`);\n break;\n case 'lte':\n values[key] = filter.value;\n clauses.push(`${filter.field} <= {${key}}`);\n break;\n case 'contains':\n values[key] = filter.value;\n clauses.push(`${filter.field} LIKE '%' || {${key}} || '%'`);\n break;\n case 'between': {\n if (Array.isArray(filter.value) && filter.value.length >= 2) {\n values[`${key}Start`] = filter.value[0];\n values[`${key}End`] = filter.value[1];\n clauses.push(`${filter.field} BETWEEN {${key}Start} AND {${key}End}`);\n }\n break;\n }\n case 'in':\n case 'nin':\n if (Array.isArray(filter.value)) {\n const placeholders: string[] = [];\n filter.value.forEach((value, valueIndex) => {\n const valueKey = `${key}_${valueIndex}`;\n values[valueKey] = value;\n placeholders.push(`{${valueKey}}`);\n });\n if (placeholders.length) {\n clauses.push(\n `${filter.field} ${filter.operator === 'in' ? 'IN' : 'NOT IN'} (${placeholders.join(\n ', '\n )})`\n );\n }\n }\n break;\n default:\n break;\n }\n });\n return clauses;\n}\n\nfunction resolveDateRange(\n params: QueryParameters\n): { from: Date; to: Date } | null {\n const range = params.dateRange;\n if (!range) return null;\n return { from: range.start, to: range.end };\n}\n\nfunction mapHogqlResult(result: AnalyticsQueryResult): {\n data: Record<string, unknown>[];\n columns: ColumnDefinition[];\n rowCount: number;\n} {\n if (!Array.isArray(result.results) || !Array.isArray(result.columns)) {\n return { data: [], columns: [], rowCount: 0 };\n }\n const columns = result.columns.map((name) => ({\n name,\n type: 'STRING' as const,\n }));\n const data = result.results.map((row) => {\n if (!Array.isArray(row)) return {};\n const record: Record<string, unknown> = {};\n result.columns?.forEach((column, index) => {\n record[column] = row[index];\n });\n return record;\n });\n return {\n data,\n columns,\n rowCount: data.length,\n };\n}\n"],"mappings":"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"}
@@ -39,6 +39,7 @@ registerDocBlocks([
39
39
 
40
40
  - Enforce org scoping for multi-tenant isolation.
41
41
  - Use Feature Flags for beta widgets; Metering to track query volume.
42
+ - PostHog datasource can back query execution via HogQL for dashboard widgets.
42
43
  `
43
44
  },
44
45
  {
@@ -1 +1 @@
1
- {"version":3,"file":"analytics-dashboard.docblock.js","names":[],"sources":["../../src/docs/analytics-dashboard.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst analyticsDashboardDocBlocks: DocBlock[] = [\n {\n id: 'docs.examples.analytics-dashboard',\n title: 'Analytics Dashboard',\n summary:\n 'Multi-tenant analytics with dashboards, widgets, query builder, and scheduled reports built on the Event Bus.',\n kind: 'reference',\n visibility: 'public',\n route: '/docs/examples/analytics-dashboard',\n tags: ['analytics', 'dashboards', 'bi', 'queries'],\n body: `## Entities\n\n- Dashboard, Widget, Query, Report.\n- Widget/query configs stay declarative for regeneration.\n\n## Contracts\n\n- \\`analytics.dashboard.create\\`, \\`analytics.widget.add\\`, \\`analytics.query.execute\\`, \\`analytics.dashboard.get\\`.\n- Metrics can source from Event Bus schemas and Usage/Metering module.\n\n## Events\n\n- dashboard.created/updated, widget.added, report.scheduled/sent.\n- Emitted for audit + notification hooks.\n\n## UI / Presentations\n\n- Dashboard list, dashboard view, query builder, widget gallery.\n- Registered under \\`analytics-dashboard\\` template in Template Registry.\n\n## Notes\n\n- Enforce org scoping for multi-tenant isolation.\n- Use Feature Flags for beta widgets; Metering to track query volume.\n`,\n },\n {\n id: 'docs.examples.analytics-dashboard.goal',\n title: 'Analytics Dashboard — Goal',\n summary: 'Why this template matters and what success looks like.',\n kind: 'goal',\n visibility: 'public',\n route: '/docs/examples/analytics-dashboard/goal',\n tags: ['analytics', 'goal'],\n body: `## Why it matters\n- Give teams a regenerable analytics workspace that stays in sync with Event Bus, Usage/Metering, and presentations.\n- Avoid dashboard drift by keeping schema-first widgets/queries.\n\n## Business/Product goal\n- Deliver tenant-scoped dashboards, governed queries, and scheduled reports with clear ownership and auditability.\n- Enable feature-flagged rollout of new widgets and sampling for cost control.\n\n## Success criteria\n- Dashboards can be regenerated safely from spec changes.\n- Queries/widgets have enforced validation; PII is redacted per policy.`,\n },\n {\n id: 'docs.examples.analytics-dashboard.usage',\n title: 'Analytics Dashboard — Usage',\n summary: 'How to seed, extend, and safely regenerate dashboards.',\n kind: 'usage',\n visibility: 'public',\n route: '/docs/examples/analytics-dashboard/usage',\n tags: ['analytics', 'usage'],\n body: `## Setup\n1) Seed dashboards/widgets (via template registry) to preload sample queries.\n2) Configure org/tenant scope and attach Usage/Metering for cost/sampling controls.\n\n## Extend & regenerate\n1) Add or modify widget/query schemas in the spec (inputs, validation, PII paths).\n2) Regenerate to update UI + API + events; review presentations for redaction.\n3) Use Feature Flags to roll out new widgets or sampling knobs gradually.\n\n## Guardrails\n- Keep all query inputs validated; mark PII paths in policy.\n- Use Audit Trail for report deliveries; Notifications for scheduled sends.`,\n },\n {\n id: 'docs.examples.analytics-dashboard.constraints',\n title: 'Analytics Dashboard — Constraints & Safety',\n summary: 'Internal guardrails for queries, widgets, and regeneration.',\n kind: 'reference',\n visibility: 'internal',\n route: '/docs/examples/analytics-dashboard/constraints',\n tags: ['analytics', 'constraints', 'internal'],\n body: `## Constraints\n- Queries and widgets must declare inputs/validation in spec; no ad-hoc query strings.\n- Regeneration must preserve sampling/windowing semantics; document changes explicitly.\n- Events/usage metrics should remain consistent with Metering/Audit wiring.\n\n## PII & Data\n- Mark PII paths (user ids, emails) in presentations for redaction.\n- Avoid exposing raw query payloads in MCP/web without policy checks.\n\n## Verification\n- Add fixtures for widget/query schema changes and scheduled reports.\n- Run regeneration diff when adjusting query builders; ensure UI/markdown targets updated.\n- Confirm feature-flagged widgets default to safe/off for new tenants.`,\n },\n];\n\nregisterDocBlocks(analyticsDashboardDocBlocks);\n"],"mappings":";;;AAwGA,kBArGgD;CAC9C;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAa;GAAc;GAAM;GAAU;EAClD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;EAyBP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,aAAa,OAAO;EAC3B,MAAM;;;;;;;;;;;EAWP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,aAAa,QAAQ;EAC5B,MAAM;;;;;;;;;;;;EAYP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAa;GAAe;GAAW;EAC9C,MAAM;;;;;;;;;;;;;EAaP;CACF,CAE6C"}
1
+ {"version":3,"file":"analytics-dashboard.docblock.js","names":[],"sources":["../../src/docs/analytics-dashboard.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst analyticsDashboardDocBlocks: DocBlock[] = [\n {\n id: 'docs.examples.analytics-dashboard',\n title: 'Analytics Dashboard',\n summary:\n 'Multi-tenant analytics with dashboards, widgets, query builder, and scheduled reports built on the Event Bus.',\n kind: 'reference',\n visibility: 'public',\n route: '/docs/examples/analytics-dashboard',\n tags: ['analytics', 'dashboards', 'bi', 'queries'],\n body: `## Entities\n\n- Dashboard, Widget, Query, Report.\n- Widget/query configs stay declarative for regeneration.\n\n## Contracts\n\n- \\`analytics.dashboard.create\\`, \\`analytics.widget.add\\`, \\`analytics.query.execute\\`, \\`analytics.dashboard.get\\`.\n- Metrics can source from Event Bus schemas and Usage/Metering module.\n\n## Events\n\n- dashboard.created/updated, widget.added, report.scheduled/sent.\n- Emitted for audit + notification hooks.\n\n## UI / Presentations\n\n- Dashboard list, dashboard view, query builder, widget gallery.\n- Registered under \\`analytics-dashboard\\` template in Template Registry.\n\n## Notes\n\n- Enforce org scoping for multi-tenant isolation.\n- Use Feature Flags for beta widgets; Metering to track query volume.\n- PostHog datasource can back query execution via HogQL for dashboard widgets.\n`,\n },\n {\n id: 'docs.examples.analytics-dashboard.goal',\n title: 'Analytics Dashboard — Goal',\n summary: 'Why this template matters and what success looks like.',\n kind: 'goal',\n visibility: 'public',\n route: '/docs/examples/analytics-dashboard/goal',\n tags: ['analytics', 'goal'],\n body: `## Why it matters\n- Give teams a regenerable analytics workspace that stays in sync with Event Bus, Usage/Metering, and presentations.\n- Avoid dashboard drift by keeping schema-first widgets/queries.\n\n## Business/Product goal\n- Deliver tenant-scoped dashboards, governed queries, and scheduled reports with clear ownership and auditability.\n- Enable feature-flagged rollout of new widgets and sampling for cost control.\n\n## Success criteria\n- Dashboards can be regenerated safely from spec changes.\n- Queries/widgets have enforced validation; PII is redacted per policy.`,\n },\n {\n id: 'docs.examples.analytics-dashboard.usage',\n title: 'Analytics Dashboard — Usage',\n summary: 'How to seed, extend, and safely regenerate dashboards.',\n kind: 'usage',\n visibility: 'public',\n route: '/docs/examples/analytics-dashboard/usage',\n tags: ['analytics', 'usage'],\n body: `## Setup\n1) Seed dashboards/widgets (via template registry) to preload sample queries.\n2) Configure org/tenant scope and attach Usage/Metering for cost/sampling controls.\n\n## Extend & regenerate\n1) Add or modify widget/query schemas in the spec (inputs, validation, PII paths).\n2) Regenerate to update UI + API + events; review presentations for redaction.\n3) Use Feature Flags to roll out new widgets or sampling knobs gradually.\n\n## Guardrails\n- Keep all query inputs validated; mark PII paths in policy.\n- Use Audit Trail for report deliveries; Notifications for scheduled sends.`,\n },\n {\n id: 'docs.examples.analytics-dashboard.constraints',\n title: 'Analytics Dashboard — Constraints & Safety',\n summary: 'Internal guardrails for queries, widgets, and regeneration.',\n kind: 'reference',\n visibility: 'internal',\n route: '/docs/examples/analytics-dashboard/constraints',\n tags: ['analytics', 'constraints', 'internal'],\n body: `## Constraints\n- Queries and widgets must declare inputs/validation in spec; no ad-hoc query strings.\n- Regeneration must preserve sampling/windowing semantics; document changes explicitly.\n- Events/usage metrics should remain consistent with Metering/Audit wiring.\n\n## PII & Data\n- Mark PII paths (user ids, emails) in presentations for redaction.\n- Avoid exposing raw query payloads in MCP/web without policy checks.\n\n## Verification\n- Add fixtures for widget/query schema changes and scheduled reports.\n- Run regeneration diff when adjusting query builders; ensure UI/markdown targets updated.\n- Confirm feature-flagged widgets default to safe/off for new tenants.`,\n },\n];\n\nregisterDocBlocks(analyticsDashboardDocBlocks);\n"],"mappings":";;;AAyGA,kBAtGgD;CAC9C;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAa;GAAc;GAAM;GAAU;EAClD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,aAAa,OAAO;EAC3B,MAAM;;;;;;;;;;;EAWP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,aAAa,QAAQ;EAC5B,MAAM;;;;;;;;;;;;EAYP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAa;GAAe;GAAW;EAC9C,MAAM;;;;;;;;;;;;;EAaP;CACF,CAE6C"}
package/dist/events.d.ts CHANGED
@@ -1,8 +1,8 @@
1
- import * as _contractspec_lib_contracts1 from "@contractspec/lib.contracts";
1
+ import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
2
2
  import * as _contractspec_lib_schema0 from "@contractspec/lib.schema";
3
3
 
4
4
  //#region src/events.d.ts
5
- declare const DashboardCreatedEvent: _contractspec_lib_contracts1.EventSpec<_contractspec_lib_schema0.SchemaModel<{
5
+ declare const DashboardCreatedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
6
6
  dashboardId: {
7
7
  type: _contractspec_lib_schema0.FieldType<string, string>;
8
8
  isOptional: false;
@@ -24,7 +24,7 @@ declare const DashboardCreatedEvent: _contractspec_lib_contracts1.EventSpec<_con
24
24
  isOptional: false;
25
25
  };
26
26
  }>>;
27
- declare const WidgetAddedEvent: _contractspec_lib_contracts1.EventSpec<_contractspec_lib_schema0.SchemaModel<{
27
+ declare const WidgetAddedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
28
28
  widgetId: {
29
29
  type: _contractspec_lib_schema0.FieldType<string, string>;
30
30
  isOptional: false;
@@ -46,7 +46,7 @@ declare const WidgetAddedEvent: _contractspec_lib_contracts1.EventSpec<_contract
46
46
  isOptional: false;
47
47
  };
48
48
  }>>;
49
- declare const QueryCreatedEvent: _contractspec_lib_contracts1.EventSpec<_contractspec_lib_schema0.SchemaModel<{
49
+ declare const QueryCreatedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
50
50
  queryId: {
51
51
  type: _contractspec_lib_schema0.FieldType<string, string>;
52
52
  isOptional: false;
@@ -73,7 +73,7 @@ declare const QueryCreatedEvent: _contractspec_lib_contracts1.EventSpec<_contrac
73
73
  };
74
74
  }>>;
75
75
  declare const AnalyticsDashboardEvents: {
76
- DashboardCreatedEvent: _contractspec_lib_contracts1.EventSpec<_contractspec_lib_schema0.SchemaModel<{
76
+ DashboardCreatedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
77
77
  dashboardId: {
78
78
  type: _contractspec_lib_schema0.FieldType<string, string>;
79
79
  isOptional: false;
@@ -95,7 +95,7 @@ declare const AnalyticsDashboardEvents: {
95
95
  isOptional: false;
96
96
  };
97
97
  }>>;
98
- WidgetAddedEvent: _contractspec_lib_contracts1.EventSpec<_contractspec_lib_schema0.SchemaModel<{
98
+ WidgetAddedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
99
99
  widgetId: {
100
100
  type: _contractspec_lib_schema0.FieldType<string, string>;
101
101
  isOptional: false;
@@ -117,7 +117,7 @@ declare const AnalyticsDashboardEvents: {
117
117
  isOptional: false;
118
118
  };
119
119
  }>>;
120
- QueryCreatedEvent: _contractspec_lib_contracts1.EventSpec<_contractspec_lib_schema0.SchemaModel<{
120
+ QueryCreatedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
121
121
  queryId: {
122
122
  type: _contractspec_lib_schema0.FieldType<string, string>;
123
123
  isOptional: false;
@@ -1 +1 @@
1
- {"version":3,"file":"events.d.ts","names":[],"sources":["../src/events.ts"],"sourcesContent":[],"mappings":";;;;cAwCa,uBAAqB,4BAAA,CAAA,oCAAA;;UAUhC,yBAAA,CAAA;;EAVW,CAAA;EAUX,KAAA,EAAA;;;;;;;EAVgC,CAAA;EAAA,SAAA,EAAA;IAYrB,IAAA,qCAUX,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;;;AAV2B,cAAhB,gBAAgB,EAAA,4BAAA,CAAA,SAAA,2BAAA,WAAA,CAAA;EAAA,QAAA,EAAA;IAYhB,IAAA,EAFX,yBAAA,CAAA,SAYA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;;;6CAV4B,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAAA,CAAA;EAYjB,KAAA,EAAA;IAIZ,IAAA,qCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;cAhBY,mBAAiB,4BAAA,CAAA,oCAAA;;UAU5B,yBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;cAEW;;;YAIZ,yBAAA,CAAA"}
1
+ {"version":3,"file":"events.d.ts","names":[],"sources":["../src/events.ts"],"mappings":";;;;cAwCa,qBAAA,EAAqB,4BAAA,CAAA,SAAA,2BAAA,WAAA;;UAUhC,yBAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;cAEW,gBAAA,EAAgB,4BAAA,CAAA,SAAA,2BAAA,WAAA;;UAU3B,yBAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;cAEW,iBAAA,EAAiB,4BAAA,CAAA,SAAA,2BAAA,WAAA;;UAU5B,yBAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;cAEW,wBAAA;;;YAIZ,yBAAA,CAAA,SAAA"}
@@ -1 +1 @@
1
- {"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";;;cAEM,SAoCJ,4BAAA,CApCW"}
1
+ {"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"mappings":";;;cAEM,OAAA,EAoCJ,4BAAA,CApCW,WAAA"}
package/dist/example.js CHANGED
@@ -51,8 +51,7 @@ const example = defineExample({
51
51
  mcp: { enabled: true }
52
52
  }
53
53
  });
54
- var example_default = example;
55
54
 
56
55
  //#endregion
57
- export { example_default as default };
56
+ export { example as default };
58
57
  //# sourceMappingURL=example.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["import { defineExample } from '@contractspec/lib.contracts';\n\nconst example = defineExample({\n meta: {\n key: 'analytics-dashboard',\n version: '1.0.0',\n title: 'Analytics Dashboard',\n description:\n 'Tenant-scoped dashboards, widgets, query builder, and scheduled reports (spec-first widgets/queries).',\n kind: 'template',\n visibility: 'public',\n stability: 'experimental',\n owners: ['@platform.core'],\n tags: ['analytics', 'dashboards', 'bi', 'queries'],\n },\n docs: {\n rootDocId: 'docs.examples.analytics-dashboard',\n goalDocId: 'docs.examples.analytics-dashboard.goal',\n usageDocId: 'docs.examples.analytics-dashboard.usage',\n constraintsDocId: 'docs.examples.analytics-dashboard.constraints',\n },\n entrypoints: {\n packageName: '@contractspec/example.analytics-dashboard',\n feature: './feature',\n contracts: './contracts',\n presentations: './presentations',\n handlers: './handlers',\n docs: './docs',\n },\n surfaces: {\n templates: true,\n sandbox: {\n enabled: true,\n modes: ['playground', 'specs', 'builder', 'markdown', 'evolution'],\n },\n studio: { enabled: true, installable: true },\n mcp: { enabled: true },\n },\n});\n\nexport default example;\n"],"mappings":";;;AAEA,MAAM,UAAU,cAAc;CAC5B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,iBAAiB;EAC1B,MAAM;GAAC;GAAa;GAAc;GAAM;GAAU;EACnD;CACD,MAAM;EACJ,WAAW;EACX,WAAW;EACX,YAAY;EACZ,kBAAkB;EACnB;CACD,aAAa;EACX,aAAa;EACb,SAAS;EACT,WAAW;EACX,eAAe;EACf,UAAU;EACV,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GACP,SAAS;GACT,OAAO;IAAC;IAAc;IAAS;IAAW;IAAY;IAAY;GACnE;EACD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF,CAAC;AAEF,sBAAe"}
1
+ {"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["import { defineExample } from '@contractspec/lib.contracts';\n\nconst example = defineExample({\n meta: {\n key: 'analytics-dashboard',\n version: '1.0.0',\n title: 'Analytics Dashboard',\n description:\n 'Tenant-scoped dashboards, widgets, query builder, and scheduled reports (spec-first widgets/queries).',\n kind: 'template',\n visibility: 'public',\n stability: 'experimental',\n owners: ['@platform.core'],\n tags: ['analytics', 'dashboards', 'bi', 'queries'],\n },\n docs: {\n rootDocId: 'docs.examples.analytics-dashboard',\n goalDocId: 'docs.examples.analytics-dashboard.goal',\n usageDocId: 'docs.examples.analytics-dashboard.usage',\n constraintsDocId: 'docs.examples.analytics-dashboard.constraints',\n },\n entrypoints: {\n packageName: '@contractspec/example.analytics-dashboard',\n feature: './feature',\n contracts: './contracts',\n presentations: './presentations',\n handlers: './handlers',\n docs: './docs',\n },\n surfaces: {\n templates: true,\n sandbox: {\n enabled: true,\n modes: ['playground', 'specs', 'builder', 'markdown', 'evolution'],\n },\n studio: { enabled: true, installable: true },\n mcp: { enabled: true },\n },\n});\n\nexport default example;\n"],"mappings":";;;AAEA,MAAM,UAAU,cAAc;CAC5B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,iBAAiB;EAC1B,MAAM;GAAC;GAAa;GAAc;GAAM;GAAU;EACnD;CACD,MAAM;EACJ,WAAW;EACX,WAAW;EACX,YAAY;EACZ,kBAAkB;EACnB;CACD,aAAa;EACX,aAAa;EACb,SAAS;EACT,WAAW;EACX,eAAe;EACf,UAAU;EACV,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GACP,SAAS;GACT,OAAO;IAAC;IAAc;IAAS;IAAW;IAAY;IAAY;GACnE;EACD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF,CAAC"}
@@ -1,7 +1,6 @@
1
1
  import { DatabasePort } from "@contractspec/lib.runtime-sandbox";
2
2
 
3
3
  //#region src/handlers/analytics.handlers.d.ts
4
-
5
4
  interface Dashboard {
6
5
  id: string;
7
6
  projectId: string;
@@ -1 +1 @@
1
- {"version":3,"file":"analytics.handlers.d.ts","names":[],"sources":["../../src/handlers/analytics.handlers.ts"],"sourcesContent":[],"mappings":";;;;AAwDa,UA5CI,SAAA,CA4CJ;EACA,EAAA,EAAA,MAAA;EAAI,SAAA,EAAA,MAAA;EAGA,cAAK,EAAA,MAAA;EAOR,IAAA,EAAA,MAAA;EAID,IAAA,EAAA,MAAA;EACA,WAAA,CAAA,EAAA,MAAA;EAAI,MAAA,EAAA,OAAA,GAAA,WAAA,GAAA,UAAA;EAGA,eAAA,EAAA,MAAoB,GAAA,QAAA,GAIjB,cAAS,GAAA,iBAAA,GAAA,MAAA,GAAA,KAAA;EAGZ,QAAA,EAAA,OAAc;EAYd,UAAA,CAAA,EAAA,MAAgB;EAUhB,SAAA,EA3EJ,IA2EI;EAQA,SAAA,EAlFJ,IAkFI;AAKjB;AASiB,UA7FA,MAAA,CA6FiB;EAyGlB,EAAA,EAAA,MAAA;EAA4B,WAAA,EAAA,MAAA;EAKjC,IAAA,EAAA,MAAA;EACE,IAAA,EAAA,YAAA,GAAA,WAAA,GAAA,WAAA,GAAA,YAAA,GAAA,cAAA,GAAA,QAAA,GAAA,OAAA,GAAA,SAAA,GAAA,QAAA,GAAA,KAAA,GAAA,MAAA,GAAA,OAAA;EAAR,KAAA,EAAA,MAAA;EAyCM,KAAA,EAAA,MAAA;EAEE,SAAA,EAAA,MAAA;EAAR,UAAA,EAAA,MAAA;EAoCS,OAAA,CAAA,EAAA,MAAA;EAAR,MAAA,CAAA,EArQK,MAqQL,CAAA,MAAA,EAAA,OAAA,CAAA;EA+BE,SAAA,EAnSK,IAmSL;EADF,SAAA,EAjSO,IAiSP;;AAKO,UAnSI,KAAA,CAmSJ;EAAR,EAAA,EAAA,MAAA;EAqDqD,SAAA,EAAA,MAAA;EAAR,cAAA,EAAA,MAAA;EAchB,IAAA,EAAA,MAAA;EAAyB,WAAA,CAAA,EAAA,MAAA;EAAR,IAAA,EAAA,KAAA,GAAA,QAAA,GAAA,aAAA,GAAA,QAAA;EAqC3C,UAAA,EApYM,MAoYN,CAAA,MAAA,EAAA,OAAA,CAAA;EADF,GAAA,CAAA,EAAA,MAAA;EADO,eAAA,EAAA,MAAA;EAYA,QAAA,EAAA,OAAA;EAAR,SAAA,EA1YQ,IA0YR;EAmD4C,SAAA,EA5bpC,IA4boC;;AASpC,UAlcI,oBAAA,CAkcJ;EAAR,IAAA,EAAA,MAAA;EA8CM,IAAA,EAAA,MAAA;EAEE,WAAA,CAAA,EAAA,MAAA;EAAR,eAAA,CAAA,EA9ee,SA8ef,CAAA,iBAAA,CAAA;;AAiCuC,UA5gB3B,cAAA,CA4gB2B;EAAO,WAAA,EAAA,MAAA;EAuBvC,IAAA,EAAA,MAAA;QAhiBJ;;;;;;WAMG;;UAGM,gBAAA;;;QAGT;cACM;;;;;UAMG,mBAAA;;WAEN;;;;;UAMM,oBAAA;cACH;;;UAIG,gBAAA;;SAER;;;;;;UAOQ,iBAAA;WACN;;;iBAwGK,uBAAA,KAA4B;0BAKjC,wBACN,QAAQ;2BAyCF;;;QAEN,QAAQ;;;;;QAoCP,QAAQ;kDA6BD,QACP,KACE,oFAIH,QAAQ;uCAqDqC,QAAQ;qBAcxB,mBAAiB,QAAQ;4CAmC9C,QACP,KACE,6FAUH,QAAQ;sCAmDoC;uBAQtC,qBACN,QAAQ;uBA8CF;;;QAEN,QAAQ;iCAiC+B,QAAQ;;KAuBxC,iBAAA,GAAoB,kBAAkB"}
1
+ {"version":3,"file":"analytics.handlers.d.ts","names":[],"sources":["../../src/handlers/analytics.handlers.ts"],"mappings":";;;UAYiB,SAAA;EACf,EAAA;EACA,SAAA;EACA,cAAA;EACA,IAAA;EACA,IAAA;EACA,WAAA;EACA,MAAA;EACA,eAAA;EAOA,QAAA;EACA,UAAA;EACA,SAAA,EAAW,IAAA;EACX,SAAA,EAAW,IAAA;AAAA;AAAA,UAGI,MAAA;EACf,EAAA;EACA,WAAA;EACA,IAAA;EACA,IAAA;EAaA,KAAA;EACA,KAAA;EACA,SAAA;EACA,UAAA;EACA,OAAA;EACA,MAAA,GAAS,MAAA;EACT,SAAA,EAAW,IAAA;EACX,SAAA,EAAW,IAAA;AAAA;AAAA,UAGI,KAAA;EACf,EAAA;EACA,SAAA;EACA,cAAA;EACA,IAAA;EACA,WAAA;EACA,IAAA;EACA,UAAA,EAAY,MAAA;EACZ,GAAA;EACA,eAAA;EACA,QAAA;EACA,SAAA,EAAW,IAAA;EACX,SAAA,EAAW,IAAA;AAAA;AAAA,UAGI,oBAAA;EACf,IAAA;EACA,IAAA;EACA,WAAA;EACA,eAAA,GAAkB,SAAA;AAAA;AAAA,UAGH,cAAA;EACf,WAAA;EACA,IAAA;EACA,IAAA,EAAM,MAAA;EACN,KAAA;EACA,KAAA;EACA,SAAA;EACA,UAAA;EACA,OAAA;EACA,MAAA,GAAS,MAAA;AAAA;AAAA,UAGM,gBAAA;EACf,IAAA;EACA,WAAA;EACA,IAAA,EAAM,KAAA;EACN,UAAA,EAAY,MAAA;EACZ,GAAA;EACA,eAAA;EACA,QAAA;AAAA;AAAA,UAGe,mBAAA;EACf,SAAA;EACA,MAAA,GAAS,SAAA;EACT,MAAA;EACA,KAAA;EACA,MAAA;AAAA;AAAA,UAGe,oBAAA;EACf,UAAA,EAAY,SAAA;EACZ,KAAA;AAAA;AAAA,UAGe,gBAAA;EACf,SAAA;EACA,IAAA,GAAO,KAAA;EACP,QAAA;EACA,MAAA;EACA,KAAA;EACA,MAAA;AAAA;AAAA,UAGe,iBAAA;EACf,OAAA,EAAS,KAAA;EACT,KAAA;AAAA;AAAA,iBAuGc,uBAAA,CAAwB,EAAA,EAAI,YAAA;0BAKjC,mBAAA,KACN,OAAA,CAAQ,oBAAA;2BAyCF,oBAAA,EAAoB,OAAA;IAChB,SAAA;IAAmB,cAAA;EAAA,MAC7B,OAAA,CAAQ,SAAA;;IAiCT,WAAA;IACA,IAAA;IACA,UAAA;EAAA,MACE,OAAA,CAAQ,SAAA;yCA4BS,OAAA,EACV,OAAA,CACP,IAAA,CACE,SAAA,2EAIH,OAAA,CAAQ,SAAA;uCAqDqC,OAAA,CAAQ,MAAA;qBAcxB,cAAA,KAAiB,OAAA,CAAQ,MAAA;mCAkCvC,OAAA,EACP,OAAA,CACP,IAAA,CACE,MAAA,uFAUH,OAAA,CAAQ,MAAA;sCAmDoC,OAAA;uBAQtC,gBAAA,KACN,OAAA,CAAQ,iBAAA;uBA8CF,gBAAA,EAAgB,OAAA;IACZ,SAAA;IAAmB,cAAA;EAAA,MAC7B,OAAA,CAAQ,KAAA;iCAiC+B,OAAA,CAAQ,KAAA;AAAA;AAAA,KAuBxC,iBAAA,GAAoB,UAAA,QAAkB,uBAAA"}
@@ -1,2 +1,3 @@
1
1
  import { AddWidgetInput, AnalyticsHandlers, CreateDashboardInput, CreateQueryInput, Dashboard, ListDashboardsInput, ListDashboardsOutput, ListQueriesInput, ListQueriesOutput, Query, Widget, createAnalyticsHandlers } from "./analytics.handlers.js";
2
- export { AddWidgetInput, AnalyticsHandlers, CreateDashboardInput, CreateQueryInput, Dashboard, ListDashboardsInput, ListDashboardsOutput, ListQueriesInput, ListQueriesOutput, Query, Widget, createAnalyticsHandlers };
2
+ import { ExecutePosthogQueryInput, executePosthogQuery } from "./query.handlers.js";
3
+ export { AddWidgetInput, AnalyticsHandlers, CreateDashboardInput, CreateQueryInput, Dashboard, ExecutePosthogQueryInput, ListDashboardsInput, ListDashboardsOutput, ListQueriesInput, ListQueriesOutput, Query, Widget, createAnalyticsHandlers, executePosthogQuery };
@@ -1,3 +1,4 @@
1
1
  import { createAnalyticsHandlers } from "./analytics.handlers.js";
2
+ import { executePosthogQuery } from "./query.handlers.js";
2
3
 
3
- export { createAnalyticsHandlers };
4
+ export { createAnalyticsHandlers, executePosthogQuery };
@@ -0,0 +1,13 @@
1
+ import { QueryDefinition, QueryParameters, QueryResult } from "../query-engine/index.js";
2
+ import { AnalyticsReader } from "@contractspec/lib.contracts/integrations/providers/analytics";
3
+
4
+ //#region src/handlers/query.handlers.d.ts
5
+ interface ExecutePosthogQueryInput {
6
+ definition: QueryDefinition;
7
+ params: QueryParameters;
8
+ reader: AnalyticsReader;
9
+ }
10
+ declare function executePosthogQuery(input: ExecutePosthogQueryInput): Promise<QueryResult>;
11
+ //#endregion
12
+ export { ExecutePosthogQueryInput, executePosthogQuery };
13
+ //# sourceMappingURL=query.handlers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"query.handlers.d.ts","names":[],"sources":["../../src/handlers/query.handlers.ts"],"mappings":";;;;UAQiB,wBAAA;EACf,UAAA,EAAY,eAAA;EACZ,MAAA,EAAQ,eAAA;EACR,MAAA,EAAQ,eAAA;AAAA;AAAA,iBAGY,mBAAA,CACpB,KAAA,EAAO,wBAAA,GACN,OAAA,CAAQ,WAAA"}
@@ -0,0 +1,10 @@
1
+ import { createPosthogQueryEngine } from "../datasource/posthog-datasource.js";
2
+
3
+ //#region src/handlers/query.handlers.ts
4
+ async function executePosthogQuery(input) {
5
+ return createPosthogQueryEngine(input.reader).execute(input.definition, input.params);
6
+ }
7
+
8
+ //#endregion
9
+ export { executePosthogQuery };
10
+ //# sourceMappingURL=query.handlers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"query.handlers.js","names":[],"sources":["../../src/handlers/query.handlers.ts"],"sourcesContent":["import type { AnalyticsReader } from '@contractspec/lib.contracts/integrations/providers/analytics';\nimport type {\n QueryDefinition,\n QueryParameters,\n QueryResult,\n} from '../query-engine';\nimport { createPosthogQueryEngine } from '../datasource/posthog-datasource';\n\nexport interface ExecutePosthogQueryInput {\n definition: QueryDefinition;\n params: QueryParameters;\n reader: AnalyticsReader;\n}\n\nexport async function executePosthogQuery(\n input: ExecutePosthogQueryInput\n): Promise<QueryResult> {\n const engine = createPosthogQueryEngine(input.reader);\n return engine.execute(input.definition, input.params);\n}\n"],"mappings":";;;AAcA,eAAsB,oBACpB,OACsB;AAEtB,QADe,yBAAyB,MAAM,OAAO,CACvC,QAAQ,MAAM,YAAY,MAAM,OAAO"}
package/dist/index.d.ts CHANGED
@@ -1,4 +1,6 @@
1
1
  import { AnalyticsDashboardFeature } from "./dashboard.feature.js";
2
+ import { AggregationDefinition, BasicQueryEngine, ColumnDefinition, CustomQueryDefinition, DimensionDefinition, FilterDefinition, IQueryCache, IQueryEngine, InMemoryQueryCache, MeasureDefinition, OrderByDefinition, QueryDefinition, QueryParameters, QueryResult, createQueryEngine } from "./query-engine/index.js";
3
+ import { PosthogQueryEngine, PosthogQueryEngineOptions, createPosthogQueryEngine } from "./datasource/posthog-datasource.js";
2
4
  import { AddWidgetInput, AnalyticsHandlers, CreateDashboardInput, CreateQueryInput, Dashboard, ListDashboardsInput, ListDashboardsOutput, ListQueriesInput, ListQueriesOutput, Query, Widget, createAnalyticsHandlers } from "./handlers/analytics.handlers.js";
3
5
  import { QueryTypeEnum } from "./query/query.enum.js";
4
6
  import { CreateQueryInputModel, ExecuteQueryInputModel, QueryModel, QueryResultModel } from "./query/query.schema.js";
@@ -8,5 +10,4 @@ import { analyticsDashboardMarkdownRenderer, dashboardListMarkdownRenderer, quer
8
10
  import { AnalyticsDashboard } from "./ui/AnalyticsDashboard.js";
9
11
  import { AnalyticsStats, useAnalyticsData } from "./ui/hooks/useAnalyticsData.js";
10
12
  import "./ui/index.js";
11
- import { AggregationDefinition, BasicQueryEngine, ColumnDefinition, CustomQueryDefinition, DimensionDefinition, FilterDefinition, IQueryCache, IQueryEngine, InMemoryQueryCache, MeasureDefinition, OrderByDefinition, QueryDefinition, QueryParameters, QueryResult, createQueryEngine } from "./query-engine/index.js";
12
- export { AddWidgetInput, AggregationDefinition, AnalyticsDashboard, AnalyticsDashboardFeature, AnalyticsHandlers, AnalyticsStats, BasicQueryEngine, ColumnDefinition, CreateDashboardInput, CreateQueryContract, CreateQueryInput, CreateQueryInputModel, CustomQueryDefinition, Dashboard, DimensionDefinition, ExecuteQueryContract, ExecuteQueryInputModel, FilterDefinition, IQueryCache, IQueryEngine, InMemoryQueryCache, ListDashboardsInput, ListDashboardsOutput, ListQueriesInput, ListQueriesOutput, MeasureDefinition, OrderByDefinition, Query, QueryDefinition, QueryModel, QueryParameters, QueryResult, QueryResultModel, QueryTypeEnum, Widget, analyticsDashboardMarkdownRenderer, createAnalyticsHandlers, createQueryEngine, dashboardListMarkdownRenderer, queryBuilderMarkdownRenderer, useAnalyticsData };
13
+ export { AddWidgetInput, AggregationDefinition, AnalyticsDashboard, AnalyticsDashboardFeature, AnalyticsHandlers, AnalyticsStats, BasicQueryEngine, ColumnDefinition, CreateDashboardInput, CreateQueryContract, CreateQueryInput, CreateQueryInputModel, CustomQueryDefinition, Dashboard, DimensionDefinition, ExecuteQueryContract, ExecuteQueryInputModel, FilterDefinition, IQueryCache, IQueryEngine, InMemoryQueryCache, ListDashboardsInput, ListDashboardsOutput, ListQueriesInput, ListQueriesOutput, MeasureDefinition, OrderByDefinition, PosthogQueryEngine, PosthogQueryEngineOptions, Query, QueryDefinition, QueryModel, QueryParameters, QueryResult, QueryResultModel, QueryTypeEnum, Widget, analyticsDashboardMarkdownRenderer, createAnalyticsHandlers, createPosthogQueryEngine, createQueryEngine, dashboardListMarkdownRenderer, queryBuilderMarkdownRenderer, useAnalyticsData };
package/dist/index.js CHANGED
@@ -8,6 +8,7 @@ import { analyticsDashboardMarkdownRenderer, dashboardListMarkdownRenderer, quer
8
8
  import { useAnalyticsData } from "./ui/hooks/useAnalyticsData.js";
9
9
  import { AnalyticsDashboard } from "./ui/AnalyticsDashboard.js";
10
10
  import "./ui/index.js";
11
+ import { PosthogQueryEngine, createPosthogQueryEngine } from "./datasource/posthog-datasource.js";
11
12
  import { BasicQueryEngine, InMemoryQueryCache, createQueryEngine } from "./query-engine/index.js";
12
13
 
13
- export { AnalyticsDashboard, AnalyticsDashboardFeature, BasicQueryEngine, CreateQueryContract, CreateQueryInputModel, ExecuteQueryContract, ExecuteQueryInputModel, InMemoryQueryCache, QueryModel, QueryResultModel, QueryTypeEnum, analyticsDashboardMarkdownRenderer, createAnalyticsHandlers, createQueryEngine, dashboardListMarkdownRenderer, queryBuilderMarkdownRenderer, useAnalyticsData };
14
+ export { AnalyticsDashboard, AnalyticsDashboardFeature, BasicQueryEngine, CreateQueryContract, CreateQueryInputModel, ExecuteQueryContract, ExecuteQueryInputModel, InMemoryQueryCache, PosthogQueryEngine, QueryModel, QueryResultModel, QueryTypeEnum, analyticsDashboardMarkdownRenderer, createAnalyticsHandlers, createPosthogQueryEngine, createQueryEngine, dashboardListMarkdownRenderer, queryBuilderMarkdownRenderer, useAnalyticsData };
@@ -1,10 +1,10 @@
1
- import * as _contractspec_lib_schema247 from "@contractspec/lib.schema";
1
+ import * as _contractspec_lib_schema0 from "@contractspec/lib.schema";
2
2
 
3
3
  //#region src/query/query.enum.d.ts
4
4
  /**
5
5
  * Query type enum.
6
6
  */
7
- declare const QueryTypeEnum: _contractspec_lib_schema247.EnumType<[string, string, string, string]>;
7
+ declare const QueryTypeEnum: _contractspec_lib_schema0.EnumType<[string, string, string, string]>;
8
8
  //#endregion
9
9
  export { QueryTypeEnum };
10
10
  //# sourceMappingURL=query.enum.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"query.enum.d.ts","names":[],"sources":["../../src/query/query.enum.ts"],"sourcesContent":[],"mappings":";;;;;;AAKa,cAAA,aAKX,EAAA,2BAAA,CALwB,QAAA,CAAA,CAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA"}
1
+ {"version":3,"file":"query.enum.d.ts","names":[],"sources":["../../src/query/query.enum.ts"],"mappings":";;;;;;cAKa,aAAA,EAKX,yBAAA,CALwB,QAAA"}