@contractspec/example.analytics-dashboard 3.9.9 → 3.9.10

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 (112) hide show
  1. package/dist/browser/dashboard/dashboard.enum.js +1 -34
  2. package/dist/browser/dashboard/dashboard.operation.js +1 -289
  3. package/dist/browser/dashboard/dashboard.presentation.js +1 -200
  4. package/dist/browser/dashboard/dashboard.schema.js +1 -126
  5. package/dist/browser/dashboard/dashboard.test-spec.js +1 -213
  6. package/dist/browser/dashboard/index.js +1 -299
  7. package/dist/browser/dashboard.feature.js +1 -683
  8. package/dist/browser/datasource/posthog-datasource.js +4 -289
  9. package/dist/browser/docs/analytics-dashboard.docblock.js +5 -49
  10. package/dist/browser/docs/index.js +5 -49
  11. package/dist/browser/events.js +1 -81
  12. package/dist/browser/example.js +1 -42
  13. package/dist/browser/handlers/analytics.handlers.js +4 -278
  14. package/dist/browser/handlers/index.js +7 -571
  15. package/dist/browser/handlers/query.handlers.js +4 -294
  16. package/dist/browser/index.js +12 -2317
  17. package/dist/browser/query/index.js +1 -159
  18. package/dist/browser/query/query.enum.js +1 -11
  19. package/dist/browser/query/query.operation.js +1 -154
  20. package/dist/browser/query/query.presentation.js +1 -122
  21. package/dist/browser/query/query.schema.js +1 -70
  22. package/dist/browser/query/query.test-spec.js +1 -113
  23. package/dist/browser/query-engine/index.js +4 -491
  24. package/dist/browser/seeders/index.js +2 -20
  25. package/dist/browser/ui/AnalyticsDashboard.js +1 -1115
  26. package/dist/browser/ui/AnalyticsDashboard.widgets.js +1 -94
  27. package/dist/browser/ui/AnalyticsQueriesTable.js +1 -188
  28. package/dist/browser/ui/hooks/index.js +1 -660
  29. package/dist/browser/ui/hooks/useAnalyticsData.js +1 -657
  30. package/dist/browser/ui/index.js +5 -1283
  31. package/dist/browser/ui/renderers/analytics.markdown.js +5 -756
  32. package/dist/browser/ui/renderers/index.js +5 -756
  33. package/dist/browser/visualizations/catalog.js +1 -457
  34. package/dist/browser/visualizations/index.js +1 -611
  35. package/dist/browser/visualizations/specs.breakdown.js +1 -140
  36. package/dist/browser/visualizations/specs.performance.js +1 -198
  37. package/dist/browser/visualizations/widgets.js +1 -595
  38. package/dist/dashboard/dashboard.enum.js +1 -34
  39. package/dist/dashboard/dashboard.operation.js +1 -289
  40. package/dist/dashboard/dashboard.presentation.js +1 -200
  41. package/dist/dashboard/dashboard.schema.js +1 -126
  42. package/dist/dashboard/dashboard.test-spec.js +1 -213
  43. package/dist/dashboard/index.js +1 -299
  44. package/dist/dashboard.feature.js +1 -683
  45. package/dist/datasource/posthog-datasource.js +4 -289
  46. package/dist/docs/analytics-dashboard.docblock.js +5 -49
  47. package/dist/docs/index.js +5 -49
  48. package/dist/events.js +1 -81
  49. package/dist/example.js +1 -42
  50. package/dist/handlers/analytics.handlers.js +4 -278
  51. package/dist/handlers/index.js +7 -571
  52. package/dist/handlers/query.handlers.js +4 -294
  53. package/dist/index.js +12 -2317
  54. package/dist/node/dashboard/dashboard.enum.js +1 -34
  55. package/dist/node/dashboard/dashboard.operation.js +1 -289
  56. package/dist/node/dashboard/dashboard.presentation.js +1 -200
  57. package/dist/node/dashboard/dashboard.schema.js +1 -126
  58. package/dist/node/dashboard/dashboard.test-spec.js +1 -213
  59. package/dist/node/dashboard/index.js +1 -299
  60. package/dist/node/dashboard.feature.js +1 -683
  61. package/dist/node/datasource/posthog-datasource.js +4 -289
  62. package/dist/node/docs/analytics-dashboard.docblock.js +5 -49
  63. package/dist/node/docs/index.js +5 -49
  64. package/dist/node/events.js +1 -81
  65. package/dist/node/example.js +1 -42
  66. package/dist/node/handlers/analytics.handlers.js +4 -278
  67. package/dist/node/handlers/index.js +7 -571
  68. package/dist/node/handlers/query.handlers.js +4 -294
  69. package/dist/node/index.js +12 -2317
  70. package/dist/node/query/index.js +1 -159
  71. package/dist/node/query/query.enum.js +1 -11
  72. package/dist/node/query/query.operation.js +1 -154
  73. package/dist/node/query/query.presentation.js +1 -122
  74. package/dist/node/query/query.schema.js +1 -70
  75. package/dist/node/query/query.test-spec.js +1 -113
  76. package/dist/node/query-engine/index.js +4 -491
  77. package/dist/node/seeders/index.js +2 -20
  78. package/dist/node/ui/AnalyticsDashboard.js +1 -1115
  79. package/dist/node/ui/AnalyticsDashboard.widgets.js +1 -94
  80. package/dist/node/ui/AnalyticsQueriesTable.js +1 -188
  81. package/dist/node/ui/hooks/index.js +1 -660
  82. package/dist/node/ui/hooks/useAnalyticsData.js +1 -657
  83. package/dist/node/ui/index.js +5 -1283
  84. package/dist/node/ui/renderers/analytics.markdown.js +5 -756
  85. package/dist/node/ui/renderers/index.js +5 -756
  86. package/dist/node/visualizations/catalog.js +1 -457
  87. package/dist/node/visualizations/index.js +1 -611
  88. package/dist/node/visualizations/specs.breakdown.js +1 -140
  89. package/dist/node/visualizations/specs.performance.js +1 -198
  90. package/dist/node/visualizations/widgets.js +1 -595
  91. package/dist/query/index.js +1 -159
  92. package/dist/query/query.enum.js +1 -11
  93. package/dist/query/query.operation.js +1 -154
  94. package/dist/query/query.presentation.js +1 -122
  95. package/dist/query/query.schema.js +1 -70
  96. package/dist/query/query.test-spec.js +1 -113
  97. package/dist/query-engine/index.js +4 -491
  98. package/dist/seeders/index.js +2 -20
  99. package/dist/ui/AnalyticsDashboard.js +1 -1115
  100. package/dist/ui/AnalyticsDashboard.widgets.js +1 -94
  101. package/dist/ui/AnalyticsQueriesTable.js +1 -188
  102. package/dist/ui/hooks/index.js +1 -660
  103. package/dist/ui/hooks/useAnalyticsData.js +1 -657
  104. package/dist/ui/index.js +5 -1283
  105. package/dist/ui/renderers/analytics.markdown.js +5 -756
  106. package/dist/ui/renderers/index.js +5 -756
  107. package/dist/visualizations/catalog.js +1 -457
  108. package/dist/visualizations/index.js +1 -611
  109. package/dist/visualizations/specs.breakdown.js +1 -140
  110. package/dist/visualizations/specs.performance.js +1 -198
  111. package/dist/visualizations/widgets.js +1 -595
  112. package/package.json +10 -10
@@ -1,491 +1,4 @@
1
- // src/datasource/posthog-datasource.ts
2
- class PosthogQueryEngine {
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) {
13
- return {
14
- data: [],
15
- columns: [],
16
- rowCount: 0,
17
- executionTimeMs: Date.now() - startTime,
18
- cached: false,
19
- error: validation.errors.join(", ")
20
- };
21
- }
22
- if (!this.reader.queryHogQL) {
23
- return {
24
- data: [],
25
- columns: [],
26
- rowCount: 0,
27
- executionTimeMs: Date.now() - startTime,
28
- cached: false,
29
- error: "Analytics reader does not support HogQL queries."
30
- };
31
- }
32
- try {
33
- const result = await this.executeHogQL(definition, params);
34
- return {
35
- data: result.data,
36
- columns: result.columns,
37
- rowCount: result.rowCount,
38
- executionTimeMs: Date.now() - startTime,
39
- cached: false
40
- };
41
- } catch (error) {
42
- return {
43
- data: [],
44
- columns: [],
45
- rowCount: 0,
46
- executionTimeMs: Date.now() - startTime,
47
- cached: false,
48
- error: error instanceof Error ? error.message : "Unknown error"
49
- };
50
- }
51
- }
52
- validateQuery(definition) {
53
- const errors = [];
54
- if (definition.type === "SQL" && !definition.sql) {
55
- errors.push("SQL query is missing.");
56
- }
57
- if (definition.type === "AGGREGATION" && !definition.aggregation) {
58
- errors.push("Aggregation definition is missing.");
59
- }
60
- if (definition.type === "METRIC" && !definition.metricIds?.length) {
61
- errors.push("Metric IDs are missing.");
62
- }
63
- if (definition.type === "CUSTOM" && !definition.custom?.handler) {
64
- errors.push("Custom handler is missing.");
65
- }
66
- return { valid: errors.length === 0, errors };
67
- }
68
- async executeHogQL(definition, params) {
69
- if (!this.reader.queryHogQL) {
70
- throw new Error("Analytics reader does not support HogQL queries.");
71
- }
72
- if (definition.type === "SQL") {
73
- const result = await this.reader.queryHogQL({
74
- query: definition.sql ?? "",
75
- values: params.parameters ?? {}
76
- });
77
- return mapHogqlResult(result);
78
- }
79
- if (definition.type === "AGGREGATION" && definition.aggregation) {
80
- const { query, values } = buildAggregationQuery(definition.aggregation, params);
81
- const result = await this.reader.queryHogQL({ query, values });
82
- return mapHogqlResult(result);
83
- }
84
- if (definition.type === "METRIC" && definition.metricIds) {
85
- const { query, values } = buildMetricQuery(definition.metricIds, params);
86
- const result = await this.reader.queryHogQL({ query, values });
87
- return mapHogqlResult(result);
88
- }
89
- throw new Error("Unsupported query type for PostHog datasource.");
90
- }
91
- }
92
- function createPosthogQueryEngine(reader, options) {
93
- return new PosthogQueryEngine(reader, options);
94
- }
95
- function buildMetricQuery(metricIds, params) {
96
- const range = resolveDateRange(params);
97
- const values = {
98
- dateFrom: range?.from.toISOString(),
99
- dateTo: range?.to.toISOString()
100
- };
101
- const metricClauses = metricIds.map((metricId, index) => {
102
- values[`metric${index}`] = metricId;
103
- return `event = {metric${index}}`;
104
- });
105
- const whereClauses = [
106
- metricClauses.length ? `(${metricClauses.join(" or ")})` : "",
107
- range ? "timestamp >= {dateFrom} and timestamp < {dateTo}" : ""
108
- ].filter(Boolean).join(" and ");
109
- return {
110
- query: [
111
- "select",
112
- " event as metric,",
113
- " count() as total",
114
- "from events",
115
- whereClauses ? `where ${whereClauses}` : "",
116
- "group by metric"
117
- ].filter(Boolean).join(`
118
- `),
119
- values
120
- };
121
- }
122
- function buildAggregationQuery(aggregation, params) {
123
- const measures = aggregation.measures.map((measure) => ({
124
- ...measure,
125
- expression: buildMeasureExpression(measure.field, measure.aggregation)
126
- }));
127
- const dimensions = aggregation.dimensions.map((dimension) => ({
128
- ...dimension,
129
- expression: buildDimensionExpression(dimension.field, dimension.type, dimension.granularity)
130
- }));
131
- const selections = [
132
- ...dimensions.map((dimension) => `${dimension.expression} as ${dimension.name}`),
133
- ...measures.map((measure) => `${measure.expression} as ${measure.name}`)
134
- ];
135
- const values = {};
136
- const filters = buildFilterClauses(aggregation, params, values);
137
- const limit = aggregation.limit ?? 100;
138
- const orderBy = aggregation.orderBy?.length ? `order by ${aggregation.orderBy.map((order) => `${order.field} ${order.direction}`).join(", ")}` : "";
139
- return {
140
- query: [
141
- "select",
142
- ` ${selections.join(`,
143
- `)}`,
144
- `from ${aggregation.source}`,
145
- filters.length ? `where ${filters.join(" and ")}` : "",
146
- dimensions.length ? `group by ${dimensions.map((d) => d.name).join(", ")}` : "",
147
- orderBy,
148
- `limit ${limit}`
149
- ].filter(Boolean).join(`
150
- `),
151
- values
152
- };
153
- }
154
- function buildMeasureExpression(field, aggregation) {
155
- switch (aggregation) {
156
- case "COUNT":
157
- return field === "*" ? "count()" : `count(${field})`;
158
- case "COUNT_DISTINCT":
159
- return `countDistinct(${field})`;
160
- case "SUM":
161
- return `sum(${field})`;
162
- case "AVG":
163
- return `avg(${field})`;
164
- case "MIN":
165
- return `min(${field})`;
166
- case "MAX":
167
- return `max(${field})`;
168
- default:
169
- return `count(${field})`;
170
- }
171
- }
172
- function buildDimensionExpression(field, type, granularity) {
173
- if (type === "TIME") {
174
- switch (granularity) {
175
- case "HOUR":
176
- return `toStartOfHour(${field})`;
177
- case "WEEK":
178
- return `toStartOfWeek(${field})`;
179
- case "MONTH":
180
- return `toStartOfMonth(${field})`;
181
- case "YEAR":
182
- return `toStartOfYear(${field})`;
183
- case "DAY":
184
- default:
185
- return `toStartOfDay(${field})`;
186
- }
187
- }
188
- return field;
189
- }
190
- function buildFilterClauses(aggregation, params, values) {
191
- const clauses = [];
192
- const range = resolveDateRange(params);
193
- if (range) {
194
- values.dateFrom = range.from.toISOString();
195
- values.dateTo = range.to.toISOString();
196
- clauses.push(`timestamp >= {dateFrom} and timestamp < {dateTo}`);
197
- }
198
- aggregation.filters?.forEach((filter, index) => {
199
- const key = `filter${index}`;
200
- switch (filter.operator) {
201
- case "eq":
202
- values[key] = filter.value;
203
- clauses.push(`${filter.field} = {${key}}`);
204
- break;
205
- case "neq":
206
- values[key] = filter.value;
207
- clauses.push(`${filter.field} != {${key}}`);
208
- break;
209
- case "gt":
210
- values[key] = filter.value;
211
- clauses.push(`${filter.field} > {${key}}`);
212
- break;
213
- case "gte":
214
- values[key] = filter.value;
215
- clauses.push(`${filter.field} >= {${key}}`);
216
- break;
217
- case "lt":
218
- values[key] = filter.value;
219
- clauses.push(`${filter.field} < {${key}}`);
220
- break;
221
- case "lte":
222
- values[key] = filter.value;
223
- clauses.push(`${filter.field} <= {${key}}`);
224
- break;
225
- case "contains":
226
- values[key] = filter.value;
227
- clauses.push(`${filter.field} LIKE '%' || {${key}} || '%'`);
228
- break;
229
- case "between": {
230
- if (Array.isArray(filter.value) && filter.value.length >= 2) {
231
- values[`${key}Start`] = filter.value[0];
232
- values[`${key}End`] = filter.value[1];
233
- clauses.push(`${filter.field} BETWEEN {${key}Start} AND {${key}End}`);
234
- }
235
- break;
236
- }
237
- case "in":
238
- case "nin":
239
- if (Array.isArray(filter.value)) {
240
- const placeholders = [];
241
- filter.value.forEach((value, valueIndex) => {
242
- const valueKey = `${key}_${valueIndex}`;
243
- values[valueKey] = value;
244
- placeholders.push(`{${valueKey}}`);
245
- });
246
- if (placeholders.length) {
247
- clauses.push(`${filter.field} ${filter.operator === "in" ? "IN" : "NOT IN"} (${placeholders.join(", ")})`);
248
- }
249
- }
250
- break;
251
- default:
252
- break;
253
- }
254
- });
255
- return clauses;
256
- }
257
- function resolveDateRange(params) {
258
- const range = params.dateRange;
259
- if (!range)
260
- return null;
261
- return { from: range.start, to: range.end };
262
- }
263
- function mapHogqlResult(result) {
264
- if (!Array.isArray(result.results) || !Array.isArray(result.columns)) {
265
- return { data: [], columns: [], rowCount: 0 };
266
- }
267
- const columns = result.columns.map((name) => ({
268
- name,
269
- type: "STRING"
270
- }));
271
- const data = result.results.map((row) => {
272
- if (!Array.isArray(row))
273
- return {};
274
- const record = {};
275
- result.columns?.forEach((column, index) => {
276
- record[column] = row[index];
277
- });
278
- return record;
279
- });
280
- return {
281
- data,
282
- columns,
283
- rowCount: data.length
284
- };
285
- }
286
-
287
- // src/query-engine/index.ts
288
- class InMemoryQueryCache {
289
- cache = new Map;
290
- async get(key) {
291
- const entry = this.cache.get(key);
292
- if (!entry)
293
- return null;
294
- if (entry.expiresAt < new Date) {
295
- this.cache.delete(key);
296
- return null;
297
- }
298
- return { ...entry.result, cached: true, cachedAt: entry.expiresAt };
299
- }
300
- async set(key, result, ttlSeconds) {
301
- const expiresAt = new Date(Date.now() + ttlSeconds * 1000);
302
- this.cache.set(key, { result, expiresAt });
303
- }
304
- async invalidate(pattern) {
305
- const regex = new RegExp(pattern);
306
- for (const key of this.cache.keys()) {
307
- if (regex.test(key)) {
308
- this.cache.delete(key);
309
- }
310
- }
311
- }
312
- }
313
-
314
- class BasicQueryEngine {
315
- cache;
316
- constructor(cache) {
317
- this.cache = cache ?? new InMemoryQueryCache;
318
- }
319
- async execute(definition, params) {
320
- const startTime = Date.now();
321
- const validation = this.validateQuery(definition);
322
- if (!validation.valid) {
323
- return {
324
- data: [],
325
- columns: [],
326
- rowCount: 0,
327
- executionTimeMs: Date.now() - startTime,
328
- cached: false,
329
- error: validation.errors.join(", ")
330
- };
331
- }
332
- const cacheKey = this.buildCacheKey(definition, params);
333
- const cachedResult = await this.cache.get(cacheKey);
334
- if (cachedResult) {
335
- return cachedResult;
336
- }
337
- let result;
338
- switch (definition.type) {
339
- case "AGGREGATION":
340
- if (!definition.aggregation) {
341
- throw new Error("Aggregation definition is missing");
342
- }
343
- result = await this.executeAggregation(definition.aggregation, params);
344
- break;
345
- case "METRIC":
346
- if (!definition.metricIds) {
347
- throw new Error("Metric IDs are missing");
348
- }
349
- result = await this.executeMetric(definition.metricIds, params);
350
- break;
351
- case "SQL":
352
- if (!definition.sql) {
353
- throw new Error("SQL query is missing");
354
- }
355
- result = await this.executeSql(definition.sql, params);
356
- break;
357
- default:
358
- result = {
359
- data: [],
360
- columns: [],
361
- rowCount: 0,
362
- executionTimeMs: Date.now() - startTime,
363
- cached: false,
364
- error: `Unknown query type: ${definition.type}`
365
- };
366
- }
367
- result.executionTimeMs = Date.now() - startTime;
368
- result.cached = false;
369
- await this.cache.set(cacheKey, result, 300);
370
- return result;
371
- }
372
- validateQuery(definition) {
373
- const errors = [];
374
- if (!definition.type) {
375
- errors.push("Query type is required");
376
- }
377
- switch (definition.type) {
378
- case "SQL":
379
- if (!definition.sql) {
380
- errors.push("SQL query is required for SQL type");
381
- }
382
- break;
383
- case "METRIC":
384
- if (!definition.metricIds || definition.metricIds.length === 0) {
385
- errors.push("Metric IDs are required for METRIC type");
386
- }
387
- break;
388
- case "AGGREGATION":
389
- if (!definition.aggregation) {
390
- errors.push("Aggregation definition is required for AGGREGATION type");
391
- } else {
392
- if (!definition.aggregation.source) {
393
- errors.push("Aggregation source is required");
394
- }
395
- if (!definition.aggregation.measures || definition.aggregation.measures.length === 0) {
396
- errors.push("At least one measure is required");
397
- }
398
- }
399
- break;
400
- }
401
- return { valid: errors.length === 0, errors };
402
- }
403
- buildCacheKey(definition, params) {
404
- return JSON.stringify({ definition, params });
405
- }
406
- async executeAggregation(aggregation, params) {
407
- const columns = [
408
- ...aggregation.dimensions.map((d) => ({
409
- name: d.name,
410
- type: d.type === "NUMBER" ? "NUMBER" : d.type === "TIME" ? "DATE" : "STRING",
411
- label: d.name
412
- })),
413
- ...aggregation.measures.map((m) => ({
414
- name: m.name,
415
- type: "NUMBER",
416
- label: m.name,
417
- format: m.format
418
- }))
419
- ];
420
- const data = this.generateMockData(aggregation, params);
421
- return {
422
- data,
423
- columns,
424
- rowCount: data.length,
425
- executionTimeMs: 0,
426
- cached: false
427
- };
428
- }
429
- async executeMetric(metricIds, _params) {
430
- const data = metricIds.map((id) => ({
431
- metricId: id,
432
- value: Math.random() * 1000,
433
- change: (Math.random() - 0.5) * 20
434
- }));
435
- return {
436
- data,
437
- columns: [
438
- { name: "metricId", type: "STRING" },
439
- { name: "value", type: "NUMBER" },
440
- { name: "change", type: "NUMBER" }
441
- ],
442
- rowCount: data.length,
443
- executionTimeMs: 0,
444
- cached: false
445
- };
446
- }
447
- async executeSql(_sql, _params) {
448
- return {
449
- data: [],
450
- columns: [],
451
- rowCount: 0,
452
- executionTimeMs: 0,
453
- cached: false,
454
- error: "SQL execution not implemented in demo"
455
- };
456
- }
457
- generateMockData(aggregation, params) {
458
- const data = [];
459
- const rowCount = 10;
460
- const timeDimension = aggregation.dimensions.find((d) => d.type === "TIME");
461
- for (let i = 0;i < rowCount; i++) {
462
- const row = {};
463
- for (const dim of aggregation.dimensions) {
464
- if (dim.type === "TIME") {
465
- const date = new Date(params.dateRange?.start ?? new Date);
466
- date.setDate(date.getDate() + i);
467
- row[dim.name] = date.toISOString().split("T")[0];
468
- } else {
469
- row[dim.name] = `${dim.name}_${i % 5}`;
470
- }
471
- }
472
- for (const measure of aggregation.measures) {
473
- const baseValue = timeDimension ? 100 + i * 10 : Math.random() * 1000;
474
- const noise = (Math.random() - 0.5) * 20;
475
- row[measure.name] = Math.round((baseValue + noise) * 100) / 100;
476
- }
477
- data.push(row);
478
- }
479
- return data;
480
- }
481
- }
482
- function createQueryEngine(cache) {
483
- return new BasicQueryEngine(cache);
484
- }
485
- export {
486
- createQueryEngine,
487
- createPosthogQueryEngine,
488
- PosthogQueryEngine,
489
- InMemoryQueryCache,
490
- BasicQueryEngine
491
- };
1
+ class m{reader;defaultLimit;constructor(r,e={}){this.reader=r,this.defaultLimit=e.defaultLimit??100}async execute(r,e){let t=Date.now(),n=this.validateQuery(r);if(!n.valid)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-t,cached:!1,error:n.errors.join(", ")};if(!this.reader.queryHogQL)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-t,cached:!1,error:"Analytics reader does not support HogQL queries."};try{let u=await this.executeHogQL(r,e);return{data:u.data,columns:u.columns,rowCount:u.rowCount,executionTimeMs:Date.now()-t,cached:!1}}catch(u){return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-t,cached:!1,error:u instanceof Error?u.message:"Unknown error"}}}validateQuery(r){let e=[];if(r.type==="SQL"&&!r.sql)e.push("SQL query is missing.");if(r.type==="AGGREGATION"&&!r.aggregation)e.push("Aggregation definition is missing.");if(r.type==="METRIC"&&!r.metricIds?.length)e.push("Metric IDs are missing.");if(r.type==="CUSTOM"&&!r.custom?.handler)e.push("Custom handler is missing.");return{valid:e.length===0,errors:e}}async executeHogQL(r,e){if(!this.reader.queryHogQL)throw Error("Analytics reader does not support HogQL queries.");if(r.type==="SQL"){let t=await this.reader.queryHogQL({query:r.sql??"",values:e.parameters??{}});return y(t)}if(r.type==="AGGREGATION"&&r.aggregation){let{query:t,values:n}=E(r.aggregation,e),u=await this.reader.queryHogQL({query:t,values:n});return y(u)}if(r.type==="METRIC"&&r.metricIds){let{query:t,values:n}=A(r.metricIds,e),u=await this.reader.queryHogQL({query:t,values:n});return y(u)}throw Error("Unsupported query type for PostHog datasource.")}}function Q(r,e){return new m(r,e)}function A(r,e){let t=p(e),n={dateFrom:t?.from.toISOString(),dateTo:t?.to.toISOString()},u=r.map((c,o)=>{return n[`metric${o}`]=c,`event = {metric${o}}`}),s=[u.length?`(${u.join(" or ")})`:"",t?"timestamp >= {dateFrom} and timestamp < {dateTo}":""].filter(Boolean).join(" and ");return{query:["select"," event as metric,"," count() as total","from events",s?`where ${s}`:"","group by metric"].filter(Boolean).join(`
2
+ `),values:n}}function E(r,e){let t=r.measures.map((a)=>({...a,expression:b(a.field,a.aggregation)})),n=r.dimensions.map((a)=>({...a,expression:D(a.field,a.type,a.granularity)})),u=[...n.map((a)=>`${a.expression} as ${a.name}`),...t.map((a)=>`${a.expression} as ${a.name}`)],s={},c=R(r,e,s),o=r.limit??100,l=r.orderBy?.length?`order by ${r.orderBy.map((a)=>`${a.field} ${a.direction}`).join(", ")}`:"";return{query:["select",` ${u.join(`,
3
+ `)}`,`from ${r.source}`,c.length?`where ${c.join(" and ")}`:"",n.length?`group by ${n.map((a)=>a.name).join(", ")}`:"",l,`limit ${o}`].filter(Boolean).join(`
4
+ `),values:s}}function b(r,e){switch(e){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 D(r,e,t){if(e==="TIME")switch(t){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 R(r,e,t){let n=[],u=p(e);if(u)t.dateFrom=u.from.toISOString(),t.dateTo=u.to.toISOString(),n.push("timestamp >= {dateFrom} and timestamp < {dateTo}");return r.filters?.forEach((s,c)=>{let o=`filter${c}`;switch(s.operator){case"eq":t[o]=s.value,n.push(`${s.field} = {${o}}`);break;case"neq":t[o]=s.value,n.push(`${s.field} != {${o}}`);break;case"gt":t[o]=s.value,n.push(`${s.field} > {${o}}`);break;case"gte":t[o]=s.value,n.push(`${s.field} >= {${o}}`);break;case"lt":t[o]=s.value,n.push(`${s.field} < {${o}}`);break;case"lte":t[o]=s.value,n.push(`${s.field} <= {${o}}`);break;case"contains":t[o]=s.value,n.push(`${s.field} LIKE '%' || {${o}} || '%'`);break;case"between":{if(Array.isArray(s.value)&&s.value.length>=2)t[`${o}Start`]=s.value[0],t[`${o}End`]=s.value[1],n.push(`${s.field} BETWEEN {${o}Start} AND {${o}End}`);break}case"in":case"nin":if(Array.isArray(s.value)){let l=[];if(s.value.forEach((a,w)=>{let $=`${o}_${w}`;t[$]=a,l.push(`{${$}}`)}),l.length)n.push(`${s.field} ${s.operator==="in"?"IN":"NOT IN"} (${l.join(", ")})`)}break;default:break}}),n}function p(r){let e=r.dateRange;if(!e)return null;return{from:e.start,to:e.end}}function y(r){if(!Array.isArray(r.results)||!Array.isArray(r.columns))return{data:[],columns:[],rowCount:0};let e=r.columns.map((n)=>({name:n,type:"STRING"})),t=r.results.map((n)=>{if(!Array.isArray(n))return{};let u={};return r.columns?.forEach((s,c)=>{u[s]=n[c]}),u});return{data:t,columns:e,rowCount:t.length}}class h{cache=new Map;async get(r){let e=this.cache.get(r);if(!e)return null;if(e.expiresAt<new Date)return this.cache.delete(r),null;return{...e.result,cached:!0,cachedAt:e.expiresAt}}async set(r,e,t){let n=new Date(Date.now()+t*1000);this.cache.set(r,{result:e,expiresAt:n})}async invalidate(r){let e=new RegExp(r);for(let t of this.cache.keys())if(e.test(t))this.cache.delete(t)}}class g{cache;constructor(r){this.cache=r??new h}async execute(r,e){let t=Date.now(),n=this.validateQuery(r);if(!n.valid)return{data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-t,cached:!1,error:n.errors.join(", ")};let u=this.buildCacheKey(r,e),s=await this.cache.get(u);if(s)return s;let c;switch(r.type){case"AGGREGATION":if(!r.aggregation)throw Error("Aggregation definition is missing");c=await this.executeAggregation(r.aggregation,e);break;case"METRIC":if(!r.metricIds)throw Error("Metric IDs are missing");c=await this.executeMetric(r.metricIds,e);break;case"SQL":if(!r.sql)throw Error("SQL query is missing");c=await this.executeSql(r.sql,e);break;default:c={data:[],columns:[],rowCount:0,executionTimeMs:Date.now()-t,cached:!1,error:`Unknown query type: ${r.type}`}}return c.executionTimeMs=Date.now()-t,c.cached=!1,await this.cache.set(u,c,300),c}validateQuery(r){let e=[];if(!r.type)e.push("Query type is required");switch(r.type){case"SQL":if(!r.sql)e.push("SQL query is required for SQL type");break;case"METRIC":if(!r.metricIds||r.metricIds.length===0)e.push("Metric IDs are required for METRIC type");break;case"AGGREGATION":if(!r.aggregation)e.push("Aggregation definition is required for AGGREGATION type");else{if(!r.aggregation.source)e.push("Aggregation source is required");if(!r.aggregation.measures||r.aggregation.measures.length===0)e.push("At least one measure is required")}break}return{valid:e.length===0,errors:e}}buildCacheKey(r,e){return JSON.stringify({definition:r,params:e})}async executeAggregation(r,e){let t=[...r.dimensions.map((u)=>({name:u.name,type:u.type==="NUMBER"?"NUMBER":u.type==="TIME"?"DATE":"STRING",label:u.name})),...r.measures.map((u)=>({name:u.name,type:"NUMBER",label:u.name,format:u.format}))],n=this.generateMockData(r,e);return{data:n,columns:t,rowCount:n.length,executionTimeMs:0,cached:!1}}async executeMetric(r,e){let t=r.map((n)=>({metricId:n,value:Math.random()*1000,change:(Math.random()-0.5)*20}));return{data:t,columns:[{name:"metricId",type:"STRING"},{name:"value",type:"NUMBER"},{name:"change",type:"NUMBER"}],rowCount:t.length,executionTimeMs:0,cached:!1}}async executeSql(r,e){return{data:[],columns:[],rowCount:0,executionTimeMs:0,cached:!1,error:"SQL execution not implemented in demo"}}generateMockData(r,e){let t=[],n=10,u=r.dimensions.find((s)=>s.type==="TIME");for(let s=0;s<10;s++){let c={};for(let o of r.dimensions)if(o.type==="TIME"){let l=new Date(e.dateRange?.start??new Date);l.setDate(l.getDate()+s),c[o.name]=l.toISOString().split("T")[0]}else c[o.name]=`${o.name}_${s%5}`;for(let o of r.measures){let l=u?100+s*10:Math.random()*1000,a=(Math.random()-0.5)*20;c[o.name]=Math.round((l+a)*100)/100}t.push(c)}return t}}function v(r){return new g(r)}export{v as createQueryEngine,Q as createPosthogQueryEngine,m as PosthogQueryEngine,h as InMemoryQueryCache,g as BasicQueryEngine};
@@ -1,20 +1,2 @@
1
- // src/seeders/index.ts
2
- async function seedAnalyticsDashboard(params) {
3
- const { projectId, db } = params;
4
- const existing = await db.query(`SELECT COUNT(*) as count FROM analytics_dashboard WHERE "projectId" = $1`, [projectId]);
5
- if (existing.rows[0]?.count > 0)
6
- return;
7
- await db.execute(`INSERT INTO analytics_dashboard (id, "projectId", "organizationId", name, slug, description, status)
8
- VALUES ($1, $2, $3, $4, $5, $6, $7)`, [
9
- "dash_1",
10
- projectId,
11
- "org_demo",
12
- "Sales Overview",
13
- "sales-overview",
14
- "Sales performance dashboard",
15
- "PUBLISHED"
16
- ]);
17
- }
18
- export {
19
- seedAnalyticsDashboard
20
- };
1
+ async function o(e){let{projectId:a,db:t}=e;if((await t.query('SELECT COUNT(*) as count FROM analytics_dashboard WHERE "projectId" = $1',[a])).rows[0]?.count>0)return;await t.execute(`INSERT INTO analytics_dashboard (id, "projectId", "organizationId", name, slug, description, status)
2
+ VALUES ($1, $2, $3, $4, $5, $6, $7)`,["dash_1",a,"org_demo","Sales Overview","sales-overview","Sales performance dashboard","PUBLISHED"])}export{o as seedAnalyticsDashboard};