@contractspec/example.analytics-dashboard 1.57.0 → 1.58.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 (173) hide show
  1. package/dist/browser/dashboard/dashboard.enum.js +34 -0
  2. package/dist/browser/dashboard/dashboard.operation.js +289 -0
  3. package/dist/browser/dashboard/dashboard.presentation.js +197 -0
  4. package/dist/browser/dashboard/dashboard.schema.js +126 -0
  5. package/dist/browser/dashboard/dashboard.test-spec.js +213 -0
  6. package/dist/browser/dashboard/index.js +299 -0
  7. package/dist/browser/dashboard.feature.js +84 -0
  8. package/dist/browser/datasource/posthog-datasource.js +289 -0
  9. package/dist/browser/docs/analytics-dashboard.docblock.js +103 -0
  10. package/dist/browser/docs/index.js +103 -0
  11. package/dist/browser/events.js +81 -0
  12. package/dist/browser/example.js +42 -0
  13. package/dist/browser/handlers/analytics.handlers.js +278 -0
  14. package/dist/browser/handlers/index.js +571 -0
  15. package/dist/browser/handlers/query.handlers.js +294 -0
  16. package/dist/browser/index.js +1677 -0
  17. package/dist/browser/query/index.js +159 -0
  18. package/dist/browser/query/query.enum.js +11 -0
  19. package/dist/browser/query/query.operation.js +154 -0
  20. package/dist/browser/query/query.presentation.js +119 -0
  21. package/dist/browser/query/query.schema.js +70 -0
  22. package/dist/browser/query/query.test-spec.js +113 -0
  23. package/dist/browser/query-engine/index.js +491 -0
  24. package/dist/browser/seeders/index.js +20 -0
  25. package/dist/browser/ui/AnalyticsDashboard.js +394 -0
  26. package/dist/browser/ui/hooks/index.js +69 -0
  27. package/dist/browser/ui/hooks/useAnalyticsData.js +66 -0
  28. package/dist/browser/ui/index.js +671 -0
  29. package/dist/browser/ui/renderers/analytics.markdown.js +275 -0
  30. package/dist/browser/ui/renderers/index.js +275 -0
  31. package/dist/dashboard/dashboard.enum.d.ts +3 -8
  32. package/dist/dashboard/dashboard.enum.d.ts.map +1 -1
  33. package/dist/dashboard/dashboard.enum.js +31 -39
  34. package/dist/dashboard/dashboard.operation.d.ts +444 -450
  35. package/dist/dashboard/dashboard.operation.d.ts.map +1 -1
  36. package/dist/dashboard/dashboard.operation.js +284 -207
  37. package/dist/dashboard/dashboard.presentation.d.ts +3 -8
  38. package/dist/dashboard/dashboard.presentation.d.ts.map +1 -1
  39. package/dist/dashboard/dashboard.presentation.js +193 -85
  40. package/dist/dashboard/dashboard.schema.d.ts +289 -294
  41. package/dist/dashboard/dashboard.schema.d.ts.map +1 -1
  42. package/dist/dashboard/dashboard.schema.js +119 -228
  43. package/dist/dashboard/dashboard.test-spec.d.ts +4 -9
  44. package/dist/dashboard/dashboard.test-spec.d.ts.map +1 -1
  45. package/dist/dashboard/dashboard.test-spec.js +209 -228
  46. package/dist/dashboard/index.d.ts +7 -4
  47. package/dist/dashboard/index.d.ts.map +1 -0
  48. package/dist/dashboard/index.js +299 -4
  49. package/dist/dashboard.feature.d.ts +1 -6
  50. package/dist/dashboard.feature.d.ts.map +1 -1
  51. package/dist/dashboard.feature.js +83 -175
  52. package/dist/datasource/posthog-datasource.d.ts +15 -19
  53. package/dist/datasource/posthog-datasource.d.ts.map +1 -1
  54. package/dist/datasource/posthog-datasource.js +274 -238
  55. package/dist/docs/analytics-dashboard.docblock.d.ts +2 -1
  56. package/dist/docs/analytics-dashboard.docblock.d.ts.map +1 -0
  57. package/dist/docs/analytics-dashboard.docblock.js +45 -56
  58. package/dist/docs/index.d.ts +2 -1
  59. package/dist/docs/index.d.ts.map +1 -0
  60. package/dist/docs/index.js +104 -1
  61. package/dist/events.d.ts +109 -115
  62. package/dist/events.d.ts.map +1 -1
  63. package/dist/events.js +74 -120
  64. package/dist/example.d.ts +2 -6
  65. package/dist/example.d.ts.map +1 -1
  66. package/dist/example.js +41 -55
  67. package/dist/handlers/analytics.handlers.d.ts +110 -109
  68. package/dist/handlers/analytics.handlers.d.ts.map +1 -1
  69. package/dist/handlers/analytics.handlers.js +267 -298
  70. package/dist/handlers/index.d.ts +3 -3
  71. package/dist/handlers/index.d.ts.map +1 -0
  72. package/dist/handlers/index.js +571 -3
  73. package/dist/handlers/query.handlers.d.ts +7 -11
  74. package/dist/handlers/query.handlers.d.ts.map +1 -1
  75. package/dist/handlers/query.handlers.js +292 -7
  76. package/dist/index.d.ts +12 -13
  77. package/dist/index.d.ts.map +1 -0
  78. package/dist/index.js +1678 -14
  79. package/dist/node/dashboard/dashboard.enum.js +34 -0
  80. package/dist/node/dashboard/dashboard.operation.js +289 -0
  81. package/dist/node/dashboard/dashboard.presentation.js +197 -0
  82. package/dist/node/dashboard/dashboard.schema.js +126 -0
  83. package/dist/node/dashboard/dashboard.test-spec.js +213 -0
  84. package/dist/node/dashboard/index.js +299 -0
  85. package/dist/node/dashboard.feature.js +84 -0
  86. package/dist/node/datasource/posthog-datasource.js +289 -0
  87. package/dist/node/docs/analytics-dashboard.docblock.js +103 -0
  88. package/dist/node/docs/index.js +103 -0
  89. package/dist/node/events.js +81 -0
  90. package/dist/node/example.js +42 -0
  91. package/dist/node/handlers/analytics.handlers.js +278 -0
  92. package/dist/node/handlers/index.js +571 -0
  93. package/dist/node/handlers/query.handlers.js +294 -0
  94. package/dist/node/index.js +1677 -0
  95. package/dist/node/query/index.js +159 -0
  96. package/dist/node/query/query.enum.js +11 -0
  97. package/dist/node/query/query.operation.js +154 -0
  98. package/dist/node/query/query.presentation.js +119 -0
  99. package/dist/node/query/query.schema.js +70 -0
  100. package/dist/node/query/query.test-spec.js +113 -0
  101. package/dist/node/query-engine/index.js +491 -0
  102. package/dist/node/seeders/index.js +20 -0
  103. package/dist/node/ui/AnalyticsDashboard.js +394 -0
  104. package/dist/node/ui/hooks/index.js +69 -0
  105. package/dist/node/ui/hooks/useAnalyticsData.js +66 -0
  106. package/dist/node/ui/index.js +671 -0
  107. package/dist/node/ui/renderers/analytics.markdown.js +275 -0
  108. package/dist/node/ui/renderers/index.js +275 -0
  109. package/dist/query/index.d.ts +7 -4
  110. package/dist/query/index.d.ts.map +1 -0
  111. package/dist/query/index.js +159 -4
  112. package/dist/query/query.enum.d.ts +1 -6
  113. package/dist/query/query.enum.d.ts.map +1 -1
  114. package/dist/query/query.enum.js +10 -14
  115. package/dist/query/query.operation.d.ts +148 -154
  116. package/dist/query/query.operation.d.ts.map +1 -1
  117. package/dist/query/query.operation.js +151 -109
  118. package/dist/query/query.presentation.d.ts +2 -7
  119. package/dist/query/query.presentation.d.ts.map +1 -1
  120. package/dist/query/query.presentation.js +116 -56
  121. package/dist/query/query.schema.d.ts +121 -126
  122. package/dist/query/query.schema.d.ts.map +1 -1
  123. package/dist/query/query.schema.js +66 -152
  124. package/dist/query/query.test-spec.d.ts +2 -7
  125. package/dist/query/query.test-spec.d.ts.map +1 -1
  126. package/dist/query/query.test-spec.js +111 -121
  127. package/dist/query-engine/index.d.ts +84 -88
  128. package/dist/query-engine/index.d.ts.map +1 -1
  129. package/dist/query-engine/index.js +489 -188
  130. package/dist/seeders/index.d.ts +4 -8
  131. package/dist/seeders/index.d.ts.map +1 -1
  132. package/dist/seeders/index.js +18 -16
  133. package/dist/ui/AnalyticsDashboard.d.ts +1 -6
  134. package/dist/ui/AnalyticsDashboard.d.ts.map +1 -1
  135. package/dist/ui/AnalyticsDashboard.js +389 -259
  136. package/dist/ui/hooks/index.d.ts +2 -2
  137. package/dist/ui/hooks/index.d.ts.map +1 -0
  138. package/dist/ui/hooks/index.js +69 -4
  139. package/dist/ui/hooks/useAnalyticsData.d.ts +16 -20
  140. package/dist/ui/hooks/useAnalyticsData.d.ts.map +1 -1
  141. package/dist/ui/hooks/useAnalyticsData.js +63 -69
  142. package/dist/ui/index.d.ts +7 -6
  143. package/dist/ui/index.d.ts.map +1 -0
  144. package/dist/ui/index.js +671 -5
  145. package/dist/ui/renderers/analytics.markdown.d.ts +13 -14
  146. package/dist/ui/renderers/analytics.markdown.d.ts.map +1 -1
  147. package/dist/ui/renderers/analytics.markdown.js +266 -254
  148. package/dist/ui/renderers/index.d.ts +2 -2
  149. package/dist/ui/renderers/index.d.ts.map +1 -0
  150. package/dist/ui/renderers/index.js +275 -2
  151. package/package.json +328 -67
  152. package/dist/dashboard/dashboard.enum.js.map +0 -1
  153. package/dist/dashboard/dashboard.operation.js.map +0 -1
  154. package/dist/dashboard/dashboard.presentation.js.map +0 -1
  155. package/dist/dashboard/dashboard.schema.js.map +0 -1
  156. package/dist/dashboard/dashboard.test-spec.js.map +0 -1
  157. package/dist/dashboard.feature.js.map +0 -1
  158. package/dist/datasource/posthog-datasource.js.map +0 -1
  159. package/dist/docs/analytics-dashboard.docblock.js.map +0 -1
  160. package/dist/events.js.map +0 -1
  161. package/dist/example.js.map +0 -1
  162. package/dist/handlers/analytics.handlers.js.map +0 -1
  163. package/dist/handlers/query.handlers.js.map +0 -1
  164. package/dist/query/query.enum.js.map +0 -1
  165. package/dist/query/query.operation.js.map +0 -1
  166. package/dist/query/query.presentation.js.map +0 -1
  167. package/dist/query/query.schema.js.map +0 -1
  168. package/dist/query/query.test-spec.js.map +0 -1
  169. package/dist/query-engine/index.js.map +0 -1
  170. package/dist/seeders/index.js.map +0 -1
  171. package/dist/ui/AnalyticsDashboard.js.map +0 -1
  172. package/dist/ui/hooks/useAnalyticsData.js.map +0 -1
  173. package/dist/ui/renderers/analytics.markdown.js.map +0 -1
@@ -0,0 +1,278 @@
1
+ // src/handlers/analytics.handlers.ts
2
+ import { web } from "@contractspec/lib.runtime-sandbox";
3
+ var { generateId } = web;
4
+ function rowToDashboard(row) {
5
+ return {
6
+ id: row.id,
7
+ projectId: row.projectId,
8
+ organizationId: row.organizationId,
9
+ name: row.name,
10
+ slug: row.slug,
11
+ description: row.description ?? undefined,
12
+ status: row.status,
13
+ refreshInterval: row.refreshInterval,
14
+ isPublic: row.isPublic === 1,
15
+ shareToken: row.shareToken ?? undefined,
16
+ createdAt: new Date(row.createdAt),
17
+ updatedAt: new Date(row.updatedAt)
18
+ };
19
+ }
20
+ function rowToWidget(row) {
21
+ return {
22
+ id: row.id,
23
+ dashboardId: row.dashboardId,
24
+ name: row.name,
25
+ type: row.type,
26
+ gridX: row.gridX,
27
+ gridY: row.gridY,
28
+ gridWidth: row.gridWidth,
29
+ gridHeight: row.gridHeight,
30
+ queryId: row.queryId ?? undefined,
31
+ config: row.config ? JSON.parse(row.config) : undefined,
32
+ createdAt: new Date(row.createdAt),
33
+ updatedAt: new Date(row.updatedAt)
34
+ };
35
+ }
36
+ function rowToQuery(row) {
37
+ return {
38
+ id: row.id,
39
+ projectId: row.projectId,
40
+ organizationId: row.organizationId,
41
+ name: row.name,
42
+ description: row.description ?? undefined,
43
+ type: row.type,
44
+ definition: JSON.parse(row.definition),
45
+ sql: row.sql ?? undefined,
46
+ cacheTtlSeconds: row.cacheTtlSeconds,
47
+ isShared: row.isShared === 1,
48
+ createdAt: new Date(row.createdAt),
49
+ updatedAt: new Date(row.updatedAt)
50
+ };
51
+ }
52
+ function createAnalyticsHandlers(db) {
53
+ async function listDashboards(input) {
54
+ const { projectId, status, search, limit = 20, offset = 0 } = input;
55
+ let whereClause = "WHERE projectId = ?";
56
+ const params = [projectId];
57
+ if (status && status !== "all") {
58
+ whereClause += " AND status = ?";
59
+ params.push(status);
60
+ }
61
+ if (search) {
62
+ whereClause += " AND (name LIKE ? OR description LIKE ?)";
63
+ params.push(`%${search}%`, `%${search}%`);
64
+ }
65
+ const countResult = (await db.query(`SELECT COUNT(*) as count FROM analytics_dashboard ${whereClause}`, params)).rows;
66
+ const total = countResult[0]?.count ?? 0;
67
+ const rows = (await db.query(`SELECT * FROM analytics_dashboard ${whereClause} ORDER BY updatedAt DESC LIMIT ? OFFSET ?`, [...params, limit, offset])).rows;
68
+ return {
69
+ dashboards: rows.map(rowToDashboard),
70
+ total
71
+ };
72
+ }
73
+ async function createDashboard(input, context) {
74
+ const id = generateId("dash");
75
+ const now = new Date().toISOString();
76
+ await db.execute(`INSERT INTO analytics_dashboard (id, projectId, organizationId, name, slug, description, status, refreshInterval, isPublic, createdAt, updatedAt)
77
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
78
+ id,
79
+ context.projectId,
80
+ context.organizationId,
81
+ input.name,
82
+ input.slug,
83
+ input.description ?? null,
84
+ "DRAFT",
85
+ input.refreshInterval ?? "NONE",
86
+ 0,
87
+ now,
88
+ now
89
+ ]);
90
+ const rows = (await db.query(`SELECT * FROM analytics_dashboard WHERE id = ?`, [id])).rows;
91
+ return rowToDashboard(rows[0]);
92
+ }
93
+ async function getDashboard(input) {
94
+ let whereClause = "";
95
+ const params = [];
96
+ if (input.dashboardId) {
97
+ whereClause = "WHERE id = ?";
98
+ params.push(input.dashboardId);
99
+ } else if (input.slug) {
100
+ whereClause = "WHERE slug = ?";
101
+ params.push(input.slug);
102
+ } else if (input.shareToken) {
103
+ whereClause = "WHERE shareToken = ?";
104
+ params.push(input.shareToken);
105
+ } else {
106
+ return null;
107
+ }
108
+ const rows = (await db.query(`SELECT * FROM analytics_dashboard ${whereClause}`, params)).rows;
109
+ return rows[0] ? rowToDashboard(rows[0]) : null;
110
+ }
111
+ async function updateDashboard(dashboardId, updates) {
112
+ const now = new Date().toISOString();
113
+ const setClauses = ["updatedAt = ?"];
114
+ const params = [now];
115
+ if (updates.name !== undefined) {
116
+ setClauses.push("name = ?");
117
+ params.push(updates.name);
118
+ }
119
+ if (updates.description !== undefined) {
120
+ setClauses.push("description = ?");
121
+ params.push(updates.description);
122
+ }
123
+ if (updates.status !== undefined) {
124
+ setClauses.push("status = ?");
125
+ params.push(updates.status);
126
+ }
127
+ if (updates.refreshInterval !== undefined) {
128
+ setClauses.push("refreshInterval = ?");
129
+ params.push(updates.refreshInterval);
130
+ }
131
+ if (updates.isPublic !== undefined) {
132
+ setClauses.push("isPublic = ?");
133
+ params.push(updates.isPublic ? 1 : 0);
134
+ if (updates.isPublic) {
135
+ setClauses.push("shareToken = ?");
136
+ params.push(generateId("share"));
137
+ } else {
138
+ setClauses.push("shareToken = NULL");
139
+ }
140
+ }
141
+ params.push(dashboardId);
142
+ await db.execute(`UPDATE analytics_dashboard SET ${setClauses.join(", ")} WHERE id = ?`, params);
143
+ const rows = (await db.query(`SELECT * FROM analytics_dashboard WHERE id = ?`, [
144
+ dashboardId
145
+ ])).rows;
146
+ return rowToDashboard(rows[0]);
147
+ }
148
+ async function getWidgets(dashboardId) {
149
+ const rows = (await db.query(`SELECT * FROM analytics_widget WHERE dashboardId = ? ORDER BY gridY, gridX`, [dashboardId])).rows;
150
+ return rows.map(rowToWidget);
151
+ }
152
+ async function addWidget(input) {
153
+ const id = generateId("widget");
154
+ const now = new Date().toISOString();
155
+ await db.execute(`INSERT INTO analytics_widget (id, dashboardId, name, type, gridX, gridY, gridWidth, gridHeight, queryId, config, createdAt, updatedAt)
156
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
157
+ id,
158
+ input.dashboardId,
159
+ input.name,
160
+ input.type,
161
+ input.gridX ?? 0,
162
+ input.gridY ?? 0,
163
+ input.gridWidth ?? 6,
164
+ input.gridHeight ?? 4,
165
+ input.queryId ?? null,
166
+ input.config ? JSON.stringify(input.config) : null,
167
+ now,
168
+ now
169
+ ]);
170
+ const rows = (await db.query(`SELECT * FROM analytics_widget WHERE id = ?`, [id])).rows;
171
+ return rowToWidget(rows[0]);
172
+ }
173
+ async function updateWidget(widgetId, updates) {
174
+ const now = new Date().toISOString();
175
+ const setClauses = ["updatedAt = ?"];
176
+ const params = [now];
177
+ if (updates.name !== undefined) {
178
+ setClauses.push("name = ?");
179
+ params.push(updates.name);
180
+ }
181
+ if (updates.gridX !== undefined) {
182
+ setClauses.push("gridX = ?");
183
+ params.push(updates.gridX);
184
+ }
185
+ if (updates.gridY !== undefined) {
186
+ setClauses.push("gridY = ?");
187
+ params.push(updates.gridY);
188
+ }
189
+ if (updates.gridWidth !== undefined) {
190
+ setClauses.push("gridWidth = ?");
191
+ params.push(updates.gridWidth);
192
+ }
193
+ if (updates.gridHeight !== undefined) {
194
+ setClauses.push("gridHeight = ?");
195
+ params.push(updates.gridHeight);
196
+ }
197
+ if (updates.queryId !== undefined) {
198
+ setClauses.push("queryId = ?");
199
+ params.push(updates.queryId ?? null);
200
+ }
201
+ if (updates.config !== undefined) {
202
+ setClauses.push("config = ?");
203
+ params.push(updates.config ? JSON.stringify(updates.config) : null);
204
+ }
205
+ params.push(widgetId);
206
+ await db.execute(`UPDATE analytics_widget SET ${setClauses.join(", ")} WHERE id = ?`, params);
207
+ const rows = (await db.query(`SELECT * FROM analytics_widget WHERE id = ?`, [widgetId])).rows;
208
+ return rowToWidget(rows[0]);
209
+ }
210
+ async function deleteWidget(widgetId) {
211
+ await db.execute(`DELETE FROM analytics_widget WHERE id = ?`, [widgetId]);
212
+ }
213
+ async function listQueries(input) {
214
+ const { projectId, type, isShared, search, limit = 20, offset = 0 } = input;
215
+ let whereClause = "WHERE projectId = ?";
216
+ const params = [projectId];
217
+ if (type && type !== "all") {
218
+ whereClause += " AND type = ?";
219
+ params.push(type);
220
+ }
221
+ if (isShared !== undefined) {
222
+ whereClause += " AND isShared = ?";
223
+ params.push(isShared ? 1 : 0);
224
+ }
225
+ if (search) {
226
+ whereClause += " AND (name LIKE ? OR description LIKE ?)";
227
+ params.push(`%${search}%`, `%${search}%`);
228
+ }
229
+ const countResult = (await db.query(`SELECT COUNT(*) as count FROM analytics_query ${whereClause}`, params)).rows;
230
+ const total = countResult[0]?.count ?? 0;
231
+ const rows = (await db.query(`SELECT * FROM analytics_query ${whereClause} ORDER BY updatedAt DESC LIMIT ? OFFSET ?`, [...params, limit, offset])).rows;
232
+ return {
233
+ queries: rows.map(rowToQuery),
234
+ total
235
+ };
236
+ }
237
+ async function createQuery(input, context) {
238
+ const id = generateId("query");
239
+ const now = new Date().toISOString();
240
+ await db.execute(`INSERT INTO analytics_query (id, projectId, organizationId, name, description, type, definition, sql, cacheTtlSeconds, isShared, createdAt, updatedAt)
241
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
242
+ id,
243
+ context.projectId,
244
+ context.organizationId,
245
+ input.name,
246
+ input.description ?? null,
247
+ input.type,
248
+ JSON.stringify(input.definition),
249
+ input.sql ?? null,
250
+ input.cacheTtlSeconds ?? 300,
251
+ input.isShared ? 1 : 0,
252
+ now,
253
+ now
254
+ ]);
255
+ const rows = (await db.query(`SELECT * FROM analytics_query WHERE id = ?`, [id])).rows;
256
+ return rowToQuery(rows[0]);
257
+ }
258
+ async function getQuery(queryId) {
259
+ const rows = (await db.query(`SELECT * FROM analytics_query WHERE id = ?`, [queryId])).rows;
260
+ return rows[0] ? rowToQuery(rows[0]) : null;
261
+ }
262
+ return {
263
+ listDashboards,
264
+ createDashboard,
265
+ getDashboard,
266
+ updateDashboard,
267
+ getWidgets,
268
+ addWidget,
269
+ updateWidget,
270
+ deleteWidget,
271
+ listQueries,
272
+ createQuery,
273
+ getQuery
274
+ };
275
+ }
276
+ export {
277
+ createAnalyticsHandlers
278
+ };