@tech4good/angular-schematics 21.6.0 → 21.7.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 (229) hide show
  1. package/CHANGELOG.md +28 -0
  2. package/README.md +266 -1
  3. package/package.json +34 -7
  4. package/src/component/files/__name@dasherize__/__name@dasherize__.component.spec.ts.template +4 -5
  5. package/src/component/files/__name@dasherize__/__name@dasherize__.component.ts.template +1 -1
  6. package/src/entity/files/__name@dasherize__/__name@dasherize__.mock.ts.template +14 -6
  7. package/src/entity/files/__name@dasherize__/__name@dasherize__.model.ts.template +12 -6
  8. package/src/entity/files/__name@dasherize__/__name@dasherize__.store.ts.template +18 -10
  9. package/src/entity/index.js +4 -49
  10. package/src/entity/index.js.map +1 -1
  11. package/src/guard/files/__name@dasherize__.guard.spec.ts.template +0 -1
  12. package/src/ng-add/files/.github/workflows/angular-github-ci.yml.template +3 -0
  13. package/src/ng-add/files/.gitignore.template +3 -0
  14. package/src/ng-add/files/analytics/datasets.js.template +206 -0
  15. package/src/ng-add/files/analytics/entity_sources.js.template +58 -0
  16. package/src/ng-add/files/analytics/entity_sources.test.js.template +57 -0
  17. package/src/ng-add/files/analytics/lib/api_query.js.template +87 -0
  18. package/src/ng-add/files/analytics/lib/api_query.test.js.template +84 -0
  19. package/src/ng-add/files/analytics/lib/bigquery_query_compatibility.test.js.template +53 -0
  20. package/src/ng-add/files/analytics/lib/dataset_schema.js.template +53 -0
  21. package/src/ng-add/files/analytics/lib/dataset_schema.test.js.template +34 -0
  22. package/src/ng-add/files/analytics/lib/entity_sync.js.template +397 -0
  23. package/src/ng-add/files/analytics/lib/entity_sync.test.js.template +212 -0
  24. package/src/ng-add/files/analytics/lib/identifier_salt.js.template +57 -0
  25. package/src/ng-add/files/analytics/lib/identifier_salt.test.js.template +36 -0
  26. package/src/ng-add/files/analytics/lib/snapshot_files.js.template +46 -0
  27. package/src/ng-add/files/analytics/lib/snapshot_files.test.js.template +67 -0
  28. package/src/ng-add/files/analytics/lib/sqlite.js.template +92 -0
  29. package/src/ng-add/files/analytics/lib/upload_entities.js.template +81 -0
  30. package/src/ng-add/files/analytics/lib/upload_entities.test.js.template +86 -0
  31. package/src/ng-add/files/analytics/proxy.conf.json.template +7 -0
  32. package/src/ng-add/files/analytics/scripts/refresh_snapshot.js.template +518 -0
  33. package/src/ng-add/files/analytics/scripts/start.js.template +88 -0
  34. package/src/ng-add/files/analytics/server/server.js.template +212 -0
  35. package/src/ng-add/files/angular.json.template +80 -1
  36. package/src/ng-add/files/bigquery/queries/active_time_by_route.sql.template +27 -8
  37. package/src/ng-add/files/bigquery/queries/active_user_windows.sql.template +67 -0
  38. package/src/ng-add/files/bigquery/queries/dashboard_route_visits.sql.template +47 -0
  39. package/src/ng-add/files/bigquery/queries/data_quality.sql.template +323 -0
  40. package/src/ng-add/files/bigquery/queries/onboarding_funnel.sql.template +512 -0
  41. package/src/ng-add/files/bigquery/queries/onboarding_stage_observations.sql.template +134 -0
  42. package/src/ng-add/files/bigquery/queries/weekly_retention_cohorts.sql.template +90 -0
  43. package/src/ng-add/files/bigquery/scripts/export_entities.js.template +120 -0
  44. package/src/ng-add/files/bigquery/scripts/init_views.js.template +57 -0
  45. package/src/ng-add/files/bigquery/scripts/run_query.js.template +141 -0
  46. package/src/ng-add/files/bigquery/views/events_flat.sql.template +27 -12
  47. package/src/ng-add/files/bigquery/views/logs_latest.sql.template +16 -3
  48. package/src/ng-add/files/docs-infra/analytics-guide.md.template +270 -25
  49. package/src/ng-add/files/docs-infra/analytics-workbench-guide.md.template +307 -0
  50. package/src/ng-add/files/docs-infra/authentication-architecture.md.template +54 -24
  51. package/src/ng-add/files/docs-infra/email-infrastructure.md.template +43 -0
  52. package/src/ng-add/files/docs-infra/firestore-index-checker.md.template +87 -0
  53. package/src/ng-add/files/docs-infra/infrastructure-guide.md.template +108 -29
  54. package/src/ng-add/files/docs-infra/load-system-architecture.md.template +15 -1
  55. package/src/ng-add/files/docs-infra/querying-strategy.md.template +14 -0
  56. package/src/ng-add/files/docs-infra/stream-system-architecture.md.template +21 -7
  57. package/src/ng-add/files/eslint.config.js.template +22 -3
  58. package/src/ng-add/files/functions/package.json.template +1 -0
  59. package/src/ng-add/files/functions/src/email.ts.template +23 -0
  60. package/src/ng-add/files/jest.config.ts.template +3 -2
  61. package/src/ng-add/files/package.json.template +39 -16
  62. package/src/ng-add/files/projects/analytics/src/app/analytics-api.service.ts.template +130 -0
  63. package/src/ng-add/files/projects/analytics/src/app/app.component.html.template +77 -0
  64. package/src/ng-add/files/projects/analytics/src/app/app.component.scss.template +240 -0
  65. package/src/ng-add/files/projects/analytics/src/app/app.component.ts.template +96 -0
  66. package/src/ng-add/files/projects/analytics/src/app/app.routes.ts.template +11 -0
  67. package/src/ng-add/files/projects/analytics/src/app/dashboard-pages.spec.ts.template +151 -0
  68. package/src/ng-add/files/projects/analytics/src/app/data-quality/data-quality-page/data-quality-page.component.html.template +39 -0
  69. package/src/ng-add/files/projects/analytics/src/app/data-quality/data-quality-page/data-quality-page.component.scss.template +1 -0
  70. package/src/ng-add/files/projects/analytics/src/app/data-quality/data-quality-page/data-quality-page.component.ts.template +95 -0
  71. package/src/ng-add/files/projects/analytics/src/app/engagement/engagement-page/engagement-page.component.html.template +47 -0
  72. package/src/ng-add/files/projects/analytics/src/app/engagement/engagement-page/engagement-page.component.scss.template +1 -0
  73. package/src/ng-add/files/projects/analytics/src/app/engagement/engagement-page/engagement-page.component.ts.template +120 -0
  74. package/src/ng-add/files/projects/analytics/src/app/onboarding/onboarding-page/onboarding-page.component.html.template +40 -0
  75. package/src/ng-add/files/projects/analytics/src/app/onboarding/onboarding-page/onboarding-page.component.scss.template +1 -0
  76. package/src/ng-add/files/projects/analytics/src/app/onboarding/onboarding-page/onboarding-page.component.ts.template +98 -0
  77. package/src/ng-add/files/projects/analytics/src/app/overview/overview-page/overview-page.component.html.template +35 -0
  78. package/src/ng-add/files/projects/analytics/src/app/overview/overview-page/overview-page.component.scss.template +1 -0
  79. package/src/ng-add/files/projects/analytics/src/app/overview/overview-page/overview-page.component.ts.template +84 -0
  80. package/src/ng-add/files/projects/analytics/src/app/routes/routes-page/routes-page.component.html.template +42 -0
  81. package/src/ng-add/files/projects/analytics/src/app/routes/routes-page/routes-page.component.scss.template +1 -0
  82. package/src/ng-add/files/projects/analytics/src/app/routes/routes-page/routes-page.component.ts.template +110 -0
  83. package/src/ng-add/files/projects/analytics/src/app/shared/analytics-utils.ts.template +43 -0
  84. package/src/ng-add/files/projects/analytics/src/app/shared/chart-theme.ts.template +42 -0
  85. package/src/ng-add/files/projects/analytics/src/app/shared/dashboard-layout.scss.template +239 -0
  86. package/src/ng-add/files/projects/analytics/src/app/shared/dashboard-table/dashboard-table.component.html.template +76 -0
  87. package/src/ng-add/files/projects/analytics/src/app/shared/dashboard-table/dashboard-table.component.scss.template +128 -0
  88. package/src/ng-add/files/projects/analytics/src/app/shared/dashboard-table/dashboard-table.component.spec.ts.template +31 -0
  89. package/src/ng-add/files/projects/analytics/src/app/shared/dashboard-table/dashboard-table.component.ts.template +153 -0
  90. package/src/ng-add/files/projects/analytics/src/app/shared/funnel-chart/funnel-chart.component.html.template +16 -0
  91. package/src/ng-add/files/projects/analytics/src/app/shared/funnel-chart/funnel-chart.component.scss.template +63 -0
  92. package/src/ng-add/files/projects/analytics/src/app/shared/funnel-chart/funnel-chart.component.ts.template +52 -0
  93. package/src/ng-add/files/projects/analytics/src/app/shared/metric-card/metric-card.component.html.template +5 -0
  94. package/src/ng-add/files/projects/analytics/src/app/shared/metric-card/metric-card.component.scss.template +56 -0
  95. package/src/ng-add/files/projects/analytics/src/app/shared/metric-card/metric-card.component.spec.ts.template +30 -0
  96. package/src/ng-add/files/projects/analytics/src/app/shared/metric-card/metric-card.component.ts.template +15 -0
  97. package/src/ng-add/files/projects/analytics/src/app/shared/quality-chart/quality-chart.component.html.template +9 -0
  98. package/src/ng-add/files/projects/analytics/src/app/shared/quality-chart/quality-chart.component.scss.template +43 -0
  99. package/src/ng-add/files/projects/analytics/src/app/shared/quality-chart/quality-chart.component.ts.template +62 -0
  100. package/src/ng-add/files/projects/analytics/src/app/shared/route-distribution-chart/route-distribution-chart.component.html.template +9 -0
  101. package/src/ng-add/files/projects/analytics/src/app/shared/route-distribution-chart/route-distribution-chart.component.scss.template +33 -0
  102. package/src/ng-add/files/projects/analytics/src/app/shared/route-distribution-chart/route-distribution-chart.component.ts.template +82 -0
  103. package/src/ng-add/files/projects/analytics/src/app/shared/route-traffic-chart/route-traffic-chart.component.html.template +15 -0
  104. package/src/ng-add/files/projects/analytics/src/app/shared/route-traffic-chart/route-traffic-chart.component.scss.template +45 -0
  105. package/src/ng-add/files/projects/analytics/src/app/shared/route-traffic-chart/route-traffic-chart.component.ts.template +55 -0
  106. package/src/ng-add/files/projects/analytics/src/app/shared/status-message/status-message.component.html.template +18 -0
  107. package/src/ng-add/files/projects/analytics/src/app/shared/status-message/status-message.component.scss.template +45 -0
  108. package/src/ng-add/files/projects/analytics/src/app/shared/status-message/status-message.component.ts.template +15 -0
  109. package/src/ng-add/files/projects/analytics/src/app/vega-chart/vega-chart.component.ts.template +121 -0
  110. package/src/ng-add/files/projects/analytics/src/index.html.template +19 -0
  111. package/src/ng-add/files/projects/analytics/src/main.ts.template +16 -0
  112. package/src/ng-add/files/projects/analytics/src/styles.scss.template +28 -0
  113. package/src/ng-add/files/projects/analytics/tsconfig.app.json.template +13 -0
  114. package/src/ng-add/files/projects/analytics/tsconfig.spec.json.template +15 -0
  115. package/src/ng-add/files/src/app/admin/admin-panel/admin-panel.component.spec.ts.template +4 -5
  116. package/src/ng-add/files/src/app/admin/admin-panel/admin-settings/admin-settings.component.spec.ts.template +4 -5
  117. package/src/ng-add/files/src/app/admin/admin-panel/admin-user-list/admin-user-list.component.spec.ts.template +11 -12
  118. package/src/ng-add/files/src/app/admin/admin-panel/admin-user-list/admin-user-list.component.ts.template +7 -7
  119. package/src/ng-add/files/src/app/admin/admin-panel/admin-user-list/admin-user-table/admin-user-table.component.spec.ts.template +8 -10
  120. package/src/ng-add/files/src/app/admin/admin-panel/admin-user-list/admin-user-table/admin-user-table.component.ts.template +3 -2
  121. package/src/ng-add/files/src/app/app.component.html.template +1 -1
  122. package/src/ng-add/files/src/app/app.component.scss.template +1 -1
  123. package/src/ng-add/files/src/app/app.component.spec.ts.template +4 -5
  124. package/src/ng-add/files/src/app/app.component.ts.template +1 -2
  125. package/src/ng-add/files/src/app/app.config.ts.template +21 -15
  126. package/src/ng-add/files/src/app/auth-routing.spec.ts.template +4 -5
  127. package/src/ng-add/files/src/app/core/analytics/time-analytics.service.spec.ts.template +46 -29
  128. package/src/ng-add/files/src/app/core/analytics/time-analytics.service.ts.template +27 -18
  129. package/src/ng-add/files/src/app/core/auth/auth.providers.spec.ts.template +112 -0
  130. package/src/ng-add/files/src/app/core/auth/auth.providers.ts.template +48 -0
  131. package/src/ng-add/files/src/app/core/auth/auth.service.ts.template +9 -23
  132. package/src/ng-add/files/src/app/core/auth/guards/require-admin.guard.spec.ts.template +3 -14
  133. package/src/ng-add/files/src/app/core/firebase/data.providers.prod.ts.template +21 -0
  134. package/src/ng-add/files/src/app/core/firebase/data.providers.ts.template +13 -0
  135. package/src/ng-add/files/src/app/core/local-storage/session.service.spec.ts.template +43 -0
  136. package/src/ng-add/files/src/app/core/local-storage/session.service.ts.template +7 -0
  137. package/src/ng-add/files/src/app/core/store/app-data.spec.ts.template +76 -0
  138. package/src/ng-add/files/src/app/core/store/auth/auth.mock.ts.template +19 -67
  139. package/src/ng-add/files/src/app/core/store/auth/auth.store.spec.ts.template +102 -12
  140. package/src/ng-add/files/src/app/core/store/auth/auth.store.ts.template +32 -237
  141. package/src/ng-add/files/src/app/core/store/user/user.mock.ts.template +17 -12
  142. package/src/ng-add/files/src/app/core/store/user/user.model.ts.template +6 -7
  143. package/src/ng-add/files/src/app/core/store/user/user.store.ts.template +14 -10
  144. package/src/ng-add/files/src/app/core/store/user-context/user-context.mock.ts.template +20 -8
  145. package/src/ng-add/files/src/app/core/store/user-context/user-context.model.ts.template +5 -6
  146. package/src/ng-add/files/src/app/core/store/user-context/user-context.store.ts.template +14 -10
  147. package/src/ng-add/files/src/app/core/store/user-private/user-private.mock.ts.template +20 -7
  148. package/src/ng-add/files/src/app/core/store/user-private/user-private.model.ts.template +5 -6
  149. package/src/ng-add/files/src/app/core/store/user-private/user-private.store.ts.template +14 -10
  150. package/src/ng-add/files/src/app/core/testing/app-mocks.ts.template +42 -0
  151. package/src/ng-add/files/src/app/first-time/consent/consent.component.html.template +2 -1
  152. package/src/ng-add/files/src/app/first-time/consent/consent.component.scss.template +7 -3
  153. package/src/ng-add/files/src/app/first-time/consent/consent.component.spec.ts.template +31 -11
  154. package/src/ng-add/files/src/app/first-time/consent/consent.component.ts.template +16 -1
  155. package/src/ng-add/files/src/app/first-time/early-access/early-access.component.spec.ts.template +15 -15
  156. package/src/ng-add/files/src/app/first-time/early-access/early-access.component.ts.template +11 -3
  157. package/src/ng-add/files/src/app/first-time/early-access/survey-form/survey-form.component.html.template +2 -1
  158. package/src/ng-add/files/src/app/first-time/early-access/survey-form/survey-form.component.scss.template +7 -3
  159. package/src/ng-add/files/src/app/first-time/early-access/survey-form/survey-form.component.spec.ts.template +20 -6
  160. package/src/ng-add/files/src/app/first-time/early-access/survey-form/survey-form.component.ts.template +2 -0
  161. package/src/ng-add/files/src/app/first-time/early-access/waitlist-view/waitlist-view.component.spec.ts.template +4 -5
  162. package/src/ng-add/files/src/app/first-time/email-link/email-link.component.spec.ts.template +17 -1
  163. package/src/ng-add/files/src/app/first-time/email-link/email-link.component.ts.template +15 -0
  164. package/src/ng-add/files/src/app/first-time/first-time-routing.spec.ts.template +4 -5
  165. package/src/ng-add/files/src/app/first-time/landing/hero/hero.component.ts.template +15 -0
  166. package/src/ng-add/files/src/app/first-time/landing/landing.component.spec.ts.template +2 -0
  167. package/src/ng-add/files/src/app/first-time/login/login.component.spec.ts.template +21 -3
  168. package/src/ng-add/files/src/app/first-time/login/login.component.ts.template +26 -0
  169. package/src/ng-add/files/src/app/first-time/onboarding/onboarding.component.spec.ts.template +4 -2
  170. package/src/ng-add/files/src/app/first-time/onboarding/onboarding.component.ts.template +1 -1
  171. package/src/ng-add/files/src/app/main/account-profile/account-profile.component.spec.ts.template +2 -2
  172. package/src/ng-add/files/src/app/main/account-profile/delete-guest-card/delete-guest-card.component.spec.ts.template +2 -2
  173. package/src/ng-add/files/src/app/main/account-profile/profile-details-card/profile-details-card.component.spec.ts.template +4 -4
  174. package/src/ng-add/files/src/app/main/account-profile/sign-in-methods-card/sign-in-methods-card.component.spec.ts.template +2 -2
  175. package/src/ng-add/files/src/app/main/home/home.component.spec.ts.template +4 -5
  176. package/src/ng-add/files/src/app/main/home/home.component.ts.template +1 -1
  177. package/src/ng-add/files/src/app/shared/guest-warning-bar/guest-warning-bar.component.spec.ts.template +4 -4
  178. package/src/ng-add/files/src/app/shared/navbar/navbar.component.spec.ts.template +2 -2
  179. package/src/ng-add/files/tsconfig.spec.json.template +3 -1
  180. package/src/ng-add/index.js +7 -0
  181. package/src/ng-add/index.js.map +1 -1
  182. package/src/shared/entity-registry.d.ts +8 -0
  183. package/src/shared/entity-registry.js +28 -0
  184. package/src/shared/entity-registry.js.map +1 -0
  185. package/.agents/skills/publish-npm/SKILL.md +0 -37
  186. package/.agents/skills/publish-npm/eval.yaml +0 -32
  187. package/.agents/skills/publish-npm/fixtures/package-v21.json.template +0 -8
  188. package/.husky/commit-msg +0 -1
  189. package/.husky/pre-commit +0 -1
  190. package/.t4g/agent-memory.db +0 -0
  191. package/src/component/index_spec.d.ts +0 -1
  192. package/src/component/index_spec.js +0 -68
  193. package/src/component/index_spec.js.map +0 -1
  194. package/src/entity/index_spec.d.ts +0 -1
  195. package/src/entity/index_spec.js +0 -153
  196. package/src/entity/index_spec.js.map +0 -1
  197. package/src/guard/index_spec.d.ts +0 -1
  198. package/src/guard/index_spec.js +0 -64
  199. package/src/guard/index_spec.js.map +0 -1
  200. package/src/ng-add/files/bigquery/scripts/export_entities.py.template +0 -143
  201. package/src/ng-add/files/bigquery/scripts/run_query.py.template +0 -167
  202. package/src/ng-add/files/src/app/core/firebase/cached-listeners.service.ts.template +0 -500
  203. package/src/ng-add/files/src/app/core/firebase/database.service.ts.template +0 -73
  204. package/src/ng-add/files/src/app/core/firebase/email-link-context.service.spec.ts.template +0 -59
  205. package/src/ng-add/files/src/app/core/firebase/email-link-context.service.ts.template +0 -147
  206. package/src/ng-add/files/src/app/core/firebase/firebase.mock.service.ts.template +0 -453
  207. package/src/ng-add/files/src/app/core/firebase/firebase.service.spec.ts.template +0 -116
  208. package/src/ng-add/files/src/app/core/firebase/firebase.service.ts.template +0 -639
  209. package/src/ng-add/files/src/app/core/firebase/simulate-load.spec.ts.template +0 -104
  210. package/src/ng-add/files/src/app/core/firebase/simulate-stream.spec.ts.template +0 -127
  211. package/src/ng-add/files/src/app/core/firebase/simulation.mock.ts.template +0 -38
  212. package/src/ng-add/files/src/app/core/firebase/stream-multiplexer.ts.template +0 -445
  213. package/src/ng-add/files/src/app/core/logging/logging.service.spec.ts.template +0 -118
  214. package/src/ng-add/files/src/app/core/logging/logging.service.ts.template +0 -168
  215. package/src/ng-add/files/src/app/core/store/app.model.ts.template +0 -21
  216. package/src/ng-add/files/src/app/core/store/app.store.spec.ts.template +0 -920
  217. package/src/ng-add/files/src/app/core/store/app.store.ts.template +0 -1320
  218. package/src/ng-add/files/src/app/core/store/batch-write.firebase.service.ts.template +0 -58
  219. package/src/ng-add/files/src/app/core/store/batch-write.mock.service.ts.template +0 -105
  220. package/src/ng-add/files/src/app/core/store/batch-write.service.ts.template +0 -126
  221. package/src/ng-add/files/src/app/shared/redeployment-warning/redeployment-warning.component.html.template +0 -9
  222. package/src/ng-add/files/src/app/shared/redeployment-warning/redeployment-warning.component.scss.template +0 -46
  223. package/src/ng-add/files/src/app/shared/redeployment-warning/redeployment-warning.component.spec.ts.template +0 -69
  224. package/src/ng-add/files/src/app/shared/redeployment-warning/redeployment-warning.component.ts.template +0 -39
  225. package/src/ng-add/files/src/app/shared/redeployment-warning/redeployment-warning.service.spec.ts.template +0 -122
  226. package/src/ng-add/files/src/app/shared/redeployment-warning/redeployment-warning.service.ts.template +0 -88
  227. package/src/ng-add/index_spec.d.ts +0 -1
  228. package/src/ng-add/index_spec.js +0 -108
  229. package/src/ng-add/index_spec.js.map +0 -1
@@ -0,0 +1,130 @@
1
+ /**
2
+ * Data access layer for the analytics dashboard UI.
3
+ * Fetches dataset rows and status health checks from the local Express backend.
4
+ */
5
+
6
+ import { HttpClient } from '@angular/common/http';
7
+ import { Injectable, computed, inject, signal } from '@angular/core';
8
+ import { BehaviorSubject, Observable, catchError, of, tap, timer } from 'rxjs';
9
+ import { switchMap } from 'rxjs/operators';
10
+
11
+ /** Metadata describing the overall database snapshot */
12
+ export interface SnapshotMetadata {
13
+ snapshot_id: string;
14
+ created_at: string;
15
+ source_project: string;
16
+ git_sha: string;
17
+ schema_version: number;
18
+ query_bundle_hash: string;
19
+ }
20
+
21
+ /** Metadata describing an individual dataset within a snapshot */
22
+ export interface DatasetMetadata {
23
+ dataset_id: string;
24
+ source_query: string;
25
+ query_hash: string;
26
+ grain: string;
27
+ privacy: string;
28
+ row_count: number;
29
+ refresh_duration_ms: number;
30
+ }
31
+
32
+ /** Overall status response returned by `/api/status` */
33
+ export interface AnalyticsStatus {
34
+ available: boolean;
35
+ message?: string;
36
+ snapshot?: SnapshotMetadata;
37
+ datasets: DatasetMetadata[];
38
+ }
39
+
40
+ /** Response payload returned by `/api/datasets/:id` */
41
+ export interface DatasetResponse {
42
+ datasetId: string;
43
+ snapshotId: string;
44
+ grain: string;
45
+ privacy: string;
46
+ rows: Array<Record<string, unknown>>;
47
+ totalRows: number;
48
+ limit: number;
49
+ offset: number;
50
+ }
51
+
52
+ @Injectable({ providedIn: 'root' })
53
+ export class AnalyticsApiService {
54
+ private readonly http = inject(HttpClient);
55
+ readonly reloadSubject = new BehaviorSubject<void>(undefined);
56
+
57
+ /** Latest status response received from the local server. */
58
+ readonly serverStatus = signal<AnalyticsStatus | null>(null);
59
+
60
+ /** Snapshot ID currently loaded and rendered by the dashboard UI. */
61
+ readonly loadedSnapshotId = signal<string | null>(null);
62
+
63
+ /** Reactive signal controlling whether admin/developer traffic is included in analytics queries */
64
+ readonly includeAdmin = signal<boolean>(false);
65
+
66
+ /** Toggles admin traffic inclusion on/off and triggers a dashboard data reload */
67
+ toggleIncludeAdmin(): void {
68
+ this.includeAdmin.update((value) => !value);
69
+ this.reloadSubject.next();
70
+ }
71
+
72
+ /** Evaluates to true when the server has a newer snapshot pointer than what is currently rendered. */
73
+ readonly hasNewSnapshot = computed(() => {
74
+ const serverId = this.serverStatus()?.snapshot?.snapshot_id;
75
+ const loadedId = this.loadedSnapshotId();
76
+ return !!serverId && !!loadedId && serverId !== loadedId;
77
+ });
78
+
79
+ constructor() {
80
+ // Poll for background snapshot refreshes
81
+ timer(0, 15000)
82
+ .pipe(
83
+ switchMap(() => this.status().pipe(catchError(() => of(null)))),
84
+ )
85
+ .subscribe((status) => {
86
+ if (status) {
87
+ this.serverStatus.set(status);
88
+ }
89
+ });
90
+ }
91
+
92
+ /** Fetches status metadata from `/api/status` */
93
+ status(): Observable<AnalyticsStatus> {
94
+ return this.http.get<AnalyticsStatus>('/api/status').pipe(
95
+ tap((status) => {
96
+ if (status.available) {
97
+ this.serverStatus.set(status);
98
+ }
99
+ }),
100
+ );
101
+ }
102
+
103
+ /**
104
+ * Fetches dataset rows and pagination metrics from `/api/datasets/:id`.
105
+ * Automatically appends the current `includeAdmin` toggle state as a query
106
+ * parameter so the server returns the appropriate traffic variant.
107
+ */
108
+ dataset(id: string): Observable<DatasetResponse> {
109
+ const includeAdmin = this.includeAdmin() ? '1' : '0';
110
+ return this.http.get<DatasetResponse>(
111
+ `/api/datasets/${encodeURIComponent(id)}?includeAdmin=${includeAdmin}`,
112
+ );
113
+ }
114
+
115
+ /** Marks a snapshot ID as rendered in the current view */
116
+ markLoaded(snapshotId?: string): void {
117
+ if (snapshotId) {
118
+ this.loadedSnapshotId.set(snapshotId);
119
+ }
120
+ }
121
+
122
+ /** Triggers a dashboard data reload when a new snapshot is detected */
123
+ reload(): void {
124
+ const serverId = this.serverStatus()?.snapshot?.snapshot_id;
125
+ if (serverId) {
126
+ this.loadedSnapshotId.set(serverId);
127
+ }
128
+ this.reloadSubject.next();
129
+ }
130
+ }
@@ -0,0 +1,77 @@
1
+ <mat-sidenav-container class="shell">
2
+ <mat-sidenav
3
+ #sidenav
4
+ class="sidebar"
5
+ [mode]="compact() ? 'over' : 'side'"
6
+ [opened]="!compact()"
7
+ >
8
+ <div class="brand">
9
+ <div class="brand-mark" aria-hidden="true"><span></span></div>
10
+ <div>
11
+ <strong><%= classify(project) %></strong>
12
+ <small>Analytics workbench</small>
13
+ </div>
14
+ </div>
15
+
16
+ <mat-divider></mat-divider>
17
+
18
+ <nav aria-label="Analytics dashboards">
19
+ @for (category of categories; track category) {
20
+ <p class="nav-category">{{ category }}</p>
21
+ <mat-nav-list>
22
+ @for (dashboard of dashboardsFor(category); track dashboard.id) {
23
+ <a
24
+ mat-list-item
25
+ [routerLink]="['/', dashboard.id]"
26
+ routerLinkActive="active-link"
27
+ (click)="compact() ? sidenav.close() : null"
28
+ >
29
+ <span class="nav-dot" aria-hidden="true"></span>
30
+ {{ dashboard.label }}
31
+ </a>
32
+ }
33
+ </mat-nav-list>
34
+ }
35
+ </nav>
36
+
37
+ <div class="sidebar-snapshot-card">
38
+ <div class="snapshot-state">
39
+ <span class="status-light" [class.available]="status()?.available"></span>
40
+ <div class="snapshot-text">
41
+ <strong>{{ snapshotAge() }}</strong>
42
+ <small>{{ snapshotLabel() || 'Waiting for snapshot' }}</small>
43
+ </div>
44
+ </div>
45
+ @if (hasNewSnapshot()) {
46
+ <button mat-stroked-button type="button" (click)="reload()">Reload</button>
47
+ }
48
+ </div>
49
+
50
+ <div class="sidebar-admin-toggle">
51
+ <mat-slide-toggle
52
+ [checked]="includeAdmin()"
53
+ (change)="toggleIncludeAdmin()"
54
+ aria-label="Include Admin Traffic"
55
+ >
56
+ Include Admin Traffic
57
+ </mat-slide-toggle>
58
+ </div>
59
+
60
+ <div class="sidebar-note">
61
+ <span class="privacy-dot"></span>
62
+ Local, computed data only
63
+ </div>
64
+ </mat-sidenav>
65
+
66
+ <mat-sidenav-content>
67
+ <header class="mobile-header">
68
+ <button mat-button type="button" (click)="sidenav.toggle()" aria-label="Open dashboard menu">
69
+ Menu
70
+ </button>
71
+ <span><%= classify(project) %> Analytics</span>
72
+ </header>
73
+ <main>
74
+ <router-outlet></router-outlet>
75
+ </main>
76
+ </mat-sidenav-content>
77
+ </mat-sidenav-container>
@@ -0,0 +1,240 @@
1
+ :host {
2
+ display: block;
3
+ height: 100vh;
4
+ overflow: hidden;
5
+ }
6
+
7
+ .shell {
8
+ height: 100vh;
9
+ background: #f4f5f1;
10
+ }
11
+
12
+ .sidebar {
13
+ width: 264px;
14
+ height: 100%;
15
+ box-sizing: border-box;
16
+ display: flex;
17
+ flex-direction: column;
18
+ border-right: 1px solid #dde0d8;
19
+ background:
20
+ radial-gradient(circle at 0 0, rgba(74, 102, 88, 0.08), transparent 34%),
21
+ #fbfcf8;
22
+ padding: 0 14px 18px;
23
+ }
24
+
25
+ .brand {
26
+ display: flex;
27
+ align-items: center;
28
+ gap: 12px;
29
+ min-height: 82px;
30
+ padding: 0 10px;
31
+
32
+ strong,
33
+ small {
34
+ display: block;
35
+ }
36
+
37
+ strong {
38
+ color: #18231d;
39
+ font-family: Georgia, 'Times New Roman', serif;
40
+ font-size: 19px;
41
+ letter-spacing: -0.01em;
42
+ }
43
+
44
+ small {
45
+ margin-top: 2px;
46
+ color: #748078;
47
+ font-size: 11px;
48
+ font-weight: 650;
49
+ letter-spacing: 0.06em;
50
+ text-transform: uppercase;
51
+ }
52
+ }
53
+
54
+ .brand-mark {
55
+ display: grid;
56
+ width: 35px;
57
+ height: 35px;
58
+ place-items: center;
59
+ border-radius: 10px;
60
+ background: #294c3b;
61
+ box-shadow: 0 7px 18px rgba(24, 54, 39, 0.16);
62
+
63
+ span {
64
+ width: 15px;
65
+ height: 15px;
66
+ border: 2px solid #e8c979;
67
+ border-right-color: transparent;
68
+ border-radius: 50%;
69
+ transform: rotate(-28deg);
70
+ }
71
+ }
72
+
73
+ nav {
74
+ flex: 1;
75
+ overflow-y: auto;
76
+ padding-top: 12px;
77
+ padding-bottom: 12px;
78
+ }
79
+
80
+ .nav-category {
81
+ margin: 19px 12px 5px;
82
+ color: #919991;
83
+ font-size: 10px;
84
+ font-weight: 750;
85
+ letter-spacing: 0.13em;
86
+ text-transform: uppercase;
87
+ }
88
+
89
+ mat-nav-list {
90
+ padding: 0;
91
+ }
92
+
93
+ a[mat-list-item] {
94
+ height: 42px;
95
+ margin: 2px 0;
96
+ border-radius: 9px;
97
+ color: #5c6760;
98
+ font-size: 13px;
99
+ font-weight: 600;
100
+
101
+ &.active-link {
102
+ background: #e5ece5;
103
+ color: #193e2b;
104
+ }
105
+ }
106
+
107
+ .nav-dot {
108
+ display: inline-block;
109
+ width: 5px;
110
+ height: 5px;
111
+ margin: 0 11px 2px 1px;
112
+ border-radius: 50%;
113
+ background: currentColor;
114
+ opacity: 0.55;
115
+ }
116
+
117
+ .sidebar-snapshot-card {
118
+ margin: 12px 0;
119
+ padding: 10px 12px;
120
+ border-radius: 14px;
121
+ border: 1px solid #dde0d8;
122
+ background: #ffffff;
123
+ display: flex;
124
+ align-items: center;
125
+ justify-content: space-between;
126
+ gap: 8px;
127
+ box-shadow: 0 2px 6px rgba(0, 0, 0, 0.03);
128
+
129
+ .snapshot-state {
130
+ display: flex;
131
+ align-items: center;
132
+ gap: 8px;
133
+ min-width: 0;
134
+ }
135
+
136
+ .status-light {
137
+ width: 8px;
138
+ height: 8px;
139
+ border-radius: 50%;
140
+ background: #c2c7c2;
141
+ flex-shrink: 0;
142
+
143
+ &.available {
144
+ background: #4b8c68;
145
+ box-shadow: 0 0 0 3px rgba(75, 140, 104, 0.15);
146
+ }
147
+ }
148
+
149
+ .snapshot-text {
150
+ min-width: 0;
151
+
152
+ strong {
153
+ display: block;
154
+ color: #18231d;
155
+ font-size: 13px;
156
+ font-weight: 700;
157
+ line-height: 1.2;
158
+ }
159
+
160
+ small {
161
+ display: block;
162
+ color: #758078;
163
+ font-size: 11px;
164
+ white-space: nowrap;
165
+ overflow: hidden;
166
+ text-overflow: ellipsis;
167
+ }
168
+ }
169
+
170
+ button {
171
+ flex-shrink: 0;
172
+ font-size: 12px;
173
+ height: 32px;
174
+ line-height: 32px;
175
+ padding: 0 12px;
176
+ border-radius: 16px;
177
+ }
178
+ }
179
+
180
+ .sidebar-admin-toggle {
181
+ margin: 6px 0 12px;
182
+ padding: 8px 12px;
183
+ border-radius: 10px;
184
+ background: rgba(232, 237, 232, 0.5);
185
+ font-size: 12px;
186
+ font-weight: 600;
187
+ color: #36443c;
188
+ }
189
+
190
+ .sidebar-note {
191
+ position: static;
192
+ display: flex;
193
+ align-items: center;
194
+ gap: 8px;
195
+ border-top: 1px solid #e1e4dd;
196
+ padding-top: 15px;
197
+ margin-top: auto;
198
+ color: #758078;
199
+ font-size: 11px;
200
+ }
201
+
202
+ .privacy-dot {
203
+ width: 7px;
204
+ height: 7px;
205
+ border-radius: 50%;
206
+ background: #4b8c68;
207
+ box-shadow: 0 0 0 3px rgba(75, 140, 104, 0.12);
208
+ }
209
+
210
+ mat-sidenav-content {
211
+ height: 100%;
212
+ overflow-y: auto;
213
+ }
214
+
215
+ main {
216
+ min-height: 100%;
217
+ }
218
+
219
+ .mobile-header {
220
+ display: none;
221
+ }
222
+
223
+ @media (max-width: 959px) {
224
+ .mobile-header {
225
+ display: flex;
226
+ position: sticky;
227
+ z-index: 5;
228
+ top: 0;
229
+ align-items: center;
230
+ gap: 12px;
231
+ height: 56px;
232
+ border-bottom: 1px solid #dde0d8;
233
+ background: rgba(251, 252, 248, 0.94);
234
+ padding: 0 14px;
235
+ backdrop-filter: blur(14px);
236
+ color: #263c30;
237
+ font-weight: 700;
238
+ }
239
+ }
240
+
@@ -0,0 +1,96 @@
1
+ /**
2
+ * Root shell for the Angular analytics dashboard app.
3
+ * Renders the header, navigation, and router-outlet.
4
+ */
5
+
6
+ import { BreakpointObserver, Breakpoints } from '@angular/cdk/layout';
7
+ import { ChangeDetectionStrategy, Component, computed, inject } from '@angular/core';
8
+ import { toSignal } from '@angular/core/rxjs-interop';
9
+ import { MatButtonModule } from '@angular/material/button';
10
+ import { MatDividerModule } from '@angular/material/divider';
11
+ import { MatListModule } from '@angular/material/list';
12
+ import { MatSidenavModule } from '@angular/material/sidenav';
13
+ import { MatSlideToggleModule } from '@angular/material/slide-toggle';
14
+ import { RouterLink, RouterLinkActive, RouterOutlet } from '@angular/router';
15
+ import { map, shareReplay } from 'rxjs';
16
+ import { AnalyticsApiService } from './analytics-api.service';
17
+
18
+ @Component({
19
+ selector: 'analytics-root',
20
+ imports: [
21
+ MatButtonModule,
22
+ MatDividerModule,
23
+ MatListModule,
24
+ MatSidenavModule,
25
+ MatSlideToggleModule,
26
+ RouterLink,
27
+ RouterLinkActive,
28
+ RouterOutlet,
29
+ ],
30
+ templateUrl: './app.component.html',
31
+ styleUrl: './app.component.scss',
32
+ changeDetection: ChangeDetectionStrategy.OnPush,
33
+ })
34
+ export class AppComponent {
35
+ private readonly api = inject(AnalyticsApiService);
36
+ private readonly breakpointObserver = inject(BreakpointObserver);
37
+
38
+ readonly dashboards = [
39
+ { id: 'overview', label: 'Overview', category: 'Overview' },
40
+ { id: 'onboarding', label: 'First-time journey', category: 'Web analytics' },
41
+ { id: 'routes', label: 'Route engagement', category: 'Web analytics' },
42
+ { id: 'engagement', label: 'Engagement & retention', category: 'Web analytics' },
43
+ { id: 'data-quality', label: 'Data quality', category: 'Diagnostics' },
44
+ ];
45
+ readonly categories = ['Overview', 'Web analytics', 'Diagnostics'];
46
+
47
+ /** Signal evaluating to latest server status response */
48
+ readonly status = computed(() => this.api.serverStatus());
49
+ /** Signal evaluating to true when a newer snapshot is available on disk */
50
+ readonly hasNewSnapshot = computed(() => this.api.hasNewSnapshot());
51
+ /** Signal evaluating to true when admin traffic is included in metric calculations */
52
+ readonly includeAdmin = computed(() => this.api.includeAdmin());
53
+
54
+ /** Toggles inclusion of developer/admin testing traffic */
55
+ toggleIncludeAdmin(): void {
56
+ this.api.toggleIncludeAdmin();
57
+ }
58
+
59
+ /** Signal tracking mobile/compact viewport breakpoints */
60
+ readonly compact = toSignal(
61
+ this.breakpointObserver.observe([Breakpoints.Handset, Breakpoints.TabletPortrait]).pipe(
62
+ map((result) => result.matches),
63
+ shareReplay({ bufferSize: 1, refCount: true }),
64
+ ),
65
+ { initialValue: false },
66
+ );
67
+
68
+ /** Trigger dashboard data reload */
69
+ reload(): void {
70
+ this.api.reload();
71
+ }
72
+
73
+ /** Formats snapshot timestamp into a human-readable relative age string */
74
+ snapshotAge(): string {
75
+ const createdAt = this.status()?.snapshot?.created_at;
76
+ if (!createdAt) return 'No snapshot';
77
+ const elapsedMs = Date.now() - new Date(createdAt).getTime();
78
+ const minutes = Math.max(0, Math.round(elapsedMs / 60000));
79
+ if (minutes < 60) return `${minutes}m ago`;
80
+ const hours = Math.round(minutes / 60);
81
+ if (hours < 48) return `${hours}h ago`;
82
+ return `${Math.round(hours / 24)}d ago`;
83
+ }
84
+
85
+ /** Formats snapshot label metadata string */
86
+ snapshotLabel(): string {
87
+ const snapshot = this.status()?.snapshot;
88
+ if (!snapshot) return '';
89
+ return `${snapshot.source_project} · schema ${snapshot.schema_version}`;
90
+ }
91
+
92
+ /** Filters dashboards matching a given category */
93
+ dashboardsFor(category: string) {
94
+ return this.dashboards.filter((dashboard) => dashboard.category === category);
95
+ }
96
+ }
@@ -0,0 +1,11 @@
1
+ import { Routes } from '@angular/router';
2
+
3
+ export const routes: Routes = [
4
+ { path: '', pathMatch: 'full', redirectTo: 'overview' },
5
+ { path: 'overview', loadComponent: () => import('./overview/overview-page/overview-page.component').then((m) => m.OverviewPageComponent) },
6
+ { path: 'onboarding', loadComponent: () => import('./onboarding/onboarding-page/onboarding-page.component').then((m) => m.OnboardingPageComponent) },
7
+ { path: 'routes', loadComponent: () => import('./routes/routes-page/routes-page.component').then((m) => m.RoutesPageComponent) },
8
+ { path: 'engagement', loadComponent: () => import('./engagement/engagement-page/engagement-page.component').then((m) => m.EngagementPageComponent) },
9
+ { path: 'data-quality', loadComponent: () => import('./data-quality/data-quality-page/data-quality-page.component').then((m) => m.DataQualityPageComponent) },
10
+ { path: '**', redirectTo: 'overview' },
11
+ ];