@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,323 @@
1
+ -- Metric contract: snapshot-time telemetry diagnostics and coverage counts.
2
+ -- Purpose: Make missing identifiers, invalid durations, malformed properties,
3
+ -- identity inconsistencies, cohort exclusions, and expected interaction volume
4
+ -- visible without exposing row-level telemetry.
5
+ -- Grain: One output row per diagnostic metric. Most values are counts over the
6
+ -- current analytics.events_flat view; severity communicates interpretation, not
7
+ -- whether rows were automatically removed from every downstream analysis.
8
+ -- Identity attribution: successful authentication may carry
9
+ -- properties.authenticatedUserId before the route-level user_id changes, so
10
+ -- event_identity coalesces both sources for cohort diagnostics.
11
+ -- Cohort checks: the returning-device and returning-user counts deliberately
12
+ -- mirror the first-time funnel exclusion rules so analysts can distinguish
13
+ -- missing data from intentionally rejected returning traffic.
14
+ -- SQL approach: build reusable identity/follow-up CTEs, create an expected event
15
+ -- vocabulary, FULL OUTER JOIN it with actual counts, then UNION ALL each scalar
16
+ -- diagnostic into the common (metric, value, severity, detail) schema.
17
+
18
+ WITH event_identity AS (
19
+
20
+ SELECT
21
+ device_id,
22
+ user_id,
23
+ COALESCE(
24
+ user_id,
25
+ JSON_VALUE(SAFE.PARSE_JSON(properties), '$.authenticatedUserId')
26
+ ) AS attributed_user_id,
27
+ timestamp AS occurred_at_ms,
28
+ event_type,
29
+ SPLIT(route, '?')[SAFE_OFFSET(0)] AS route_path,
30
+ category,
31
+ action,
32
+ properties
33
+ FROM
34
+ `analytics.events_flat`
35
+ WHERE
36
+ device_id IS NOT NULL
37
+ ),
38
+
39
+ first_known_user_by_device AS (
40
+
41
+ SELECT
42
+ device_id,
43
+ MIN(occurred_at_ms) AS first_known_user_at_ms
44
+ FROM
45
+ event_identity
46
+ WHERE
47
+ attributed_user_id IS NOT NULL
48
+ GROUP BY
49
+ device_id
50
+ ),
51
+
52
+ activation_completed_by_user AS (
53
+
54
+ SELECT
55
+ attributed_user_id AS user_id,
56
+ MIN(occurred_at_ms) AS completed_at_ms
57
+ FROM
58
+ event_identity
59
+ WHERE
60
+ attributed_user_id IS NOT NULL
61
+ AND event_type = 'interaction'
62
+ AND category = 'onboarding'
63
+ AND action = 'consent_submit_result'
64
+ AND JSON_VALUE(SAFE.PARSE_JSON(properties), '$.outcome') = 'success'
65
+ GROUP BY
66
+ user_id
67
+ ),
68
+
69
+ auth_followup_signals AS (
70
+
71
+ SELECT
72
+ auth.user_id,
73
+ auth.authenticated_at_ms,
74
+ auth.access_state,
75
+ completion.completed_at_ms,
76
+ MIN(
77
+ IF(
78
+ event.event_type = 'interaction'
79
+ AND event.category = 'onboarding'
80
+ AND event.action = 'interest_submit_result'
81
+ AND JSON_VALUE(SAFE.PARSE_JSON(event.properties), '$.outcome') = 'success',
82
+ event.occurred_at_ms,
83
+ NULL
84
+ )
85
+ ) AS first_interest_at_ms,
86
+ MIN(
87
+ IF(
88
+ event.event_type = 'interaction'
89
+ AND event.category = 'onboarding'
90
+ AND event.action = 'consent_submit_result'
91
+ AND JSON_VALUE(SAFE.PARSE_JSON(event.properties), '$.outcome') = 'success',
92
+ event.occurred_at_ms,
93
+ NULL
94
+ )
95
+ ) AS first_consent_at_ms,
96
+ MIN(
97
+ IF(
98
+ event.event_type = 'route_visit'
99
+ AND (event.route_path = '/home' OR event.route_path LIKE '/home/%'),
100
+ event.occurred_at_ms,
101
+ NULL
102
+ )
103
+ ) AS first_home_at_ms
104
+ FROM (
105
+ SELECT
106
+ attributed_user_id AS user_id,
107
+ occurred_at_ms AS authenticated_at_ms,
108
+ JSON_VALUE(SAFE.PARSE_JSON(properties), '$.accessState') AS access_state
109
+ FROM
110
+ event_identity
111
+ WHERE
112
+ attributed_user_id IS NOT NULL
113
+ AND event_type = 'interaction'
114
+ AND category = 'onboarding'
115
+ AND action = 'auth_result'
116
+ AND JSON_VALUE(SAFE.PARSE_JSON(properties), '$.outcome') = 'success'
117
+ ) AS auth
118
+ LEFT JOIN
119
+ activation_completed_by_user AS completion
120
+ ON completion.user_id = auth.user_id
121
+ LEFT JOIN
122
+ event_identity AS event
123
+ ON event.attributed_user_id = auth.user_id
124
+ AND event.occurred_at_ms >= auth.authenticated_at_ms
125
+ GROUP BY
126
+ auth.user_id,
127
+ auth.authenticated_at_ms,
128
+ auth.access_state,
129
+ completion.completed_at_ms
130
+ ),
131
+
132
+
133
+ expected_interactions AS (
134
+ -- Explicit zeros are useful: a missing expected action should still appear in
135
+ -- the dashboard rather than disappearing from the GROUP BY result.
136
+ SELECT 'onboarding' AS category, 'auth_attempt' AS action UNION ALL
137
+ SELECT 'onboarding', 'auth_result' UNION ALL
138
+ SELECT 'onboarding', 'interest_submit_attempt' UNION ALL
139
+ SELECT 'onboarding', 'interest_submit_result' UNION ALL
140
+ SELECT 'onboarding', 'consent_submit_attempt' UNION ALL
141
+ SELECT 'onboarding', 'consent_submit_result'
142
+ ),
143
+
144
+ actual_interactions AS (
145
+ SELECT
146
+ category,
147
+ action,
148
+ COUNT(*) AS log_count
149
+ FROM
150
+ event_identity
151
+ WHERE
152
+ event_type = 'interaction'
153
+ AND category IS NOT NULL
154
+ AND action IS NOT NULL
155
+ GROUP BY
156
+ category,
157
+ action
158
+ ),
159
+
160
+ all_interaction_counts AS (
161
+ SELECT
162
+ COALESCE(e.category, a.category) AS category,
163
+ COALESCE(e.action, a.action) AS action,
164
+ COALESCE(a.log_count, 0) AS log_count
165
+ FROM
166
+ expected_interactions AS e
167
+ FULL OUTER JOIN
168
+ actual_interactions AS a
169
+ ON e.category = a.category AND e.action = a.action
170
+ )
171
+
172
+
173
+ SELECT
174
+ 'route visits missing a device id' AS metric,
175
+ COUNTIF(event_type = 'route_visit' AND device_id IS NULL) AS value,
176
+ 'error' AS severity,
177
+ 'These visits cannot participate in de-identified journey analysis.' AS detail
178
+ FROM
179
+ `analytics.events_flat`
180
+
181
+ UNION ALL
182
+
183
+
184
+ SELECT
185
+ 'events missing a session id' AS metric,
186
+ COUNTIF(session_id IS NULL) AS value,
187
+ 'warning' AS severity,
188
+ 'Session-level funnels and latency calculations may undercount these events.' AS detail
189
+ FROM
190
+ `analytics.events_flat`
191
+
192
+ UNION ALL
193
+
194
+
195
+ SELECT
196
+ 'route visits with negative duration' AS metric,
197
+ COUNTIF(
198
+ event_type = 'route_visit'
199
+ AND (total_active_ms < 0 OR total_rest_ms < 0)
200
+ ) AS value,
201
+ 'error' AS severity,
202
+ 'Durations must be non-negative.' AS detail
203
+ FROM
204
+ `analytics.events_flat`
205
+
206
+ UNION ALL
207
+
208
+
209
+ SELECT
210
+ CONCAT(
211
+ 'malformed interaction properties: ',
212
+ COALESCE(category, 'uncategorized'),
213
+ ' / ',
214
+ COALESCE(action, 'unknown action')
215
+ ) AS metric,
216
+ COUNT(*) AS value,
217
+ 'warning' AS severity,
218
+ 'This emitting category/action stored a non-JSON payload; inspect the client instrumentation or treat historical rows as legacy telemetry.' AS detail
219
+ FROM
220
+ `analytics.events_flat`
221
+ WHERE
222
+ event_type = 'interaction'
223
+ AND properties IS NOT NULL
224
+ AND SAFE.PARSE_JSON(properties) IS NULL
225
+ GROUP BY
226
+ category,
227
+ action
228
+
229
+ UNION ALL
230
+
231
+
232
+ SELECT
233
+ 'sessions with multiple user ids' AS metric,
234
+ COUNT(*) AS value,
235
+ 'error' AS severity,
236
+ 'A session ID was associated with multiple distinct user IDs, indicating missing session reset on user change.' AS detail
237
+ FROM (
238
+ SELECT
239
+ session_id
240
+ FROM
241
+ `analytics.events_flat`
242
+ WHERE
243
+ session_id IS NOT NULL
244
+ AND user_id IS NOT NULL
245
+ GROUP BY
246
+ session_id
247
+ HAVING
248
+ COUNT(DISTINCT user_id) > 1
249
+ )
250
+
251
+ UNION ALL
252
+
253
+
254
+ SELECT
255
+ 'returning device visits excluded from acquisition' AS metric,
256
+ (
257
+ SELECT
258
+ COUNT(*)
259
+ FROM
260
+ event_identity AS event
261
+ JOIN
262
+ first_known_user_by_device AS known_user
263
+ USING
264
+ (device_id)
265
+ WHERE
266
+ event.event_type = 'route_visit'
267
+ AND event.route_path IN ('/', '/landing')
268
+ AND event.occurred_at_ms > known_user.first_known_user_at_ms
269
+ ) AS value,
270
+ 'info' AS severity,
271
+ 'Public landing visits on devices already authenticated, correctly filtered out of pre-sign-in acquisition.' AS detail
272
+
273
+ UNION ALL
274
+
275
+
276
+ SELECT
277
+ 'returning user sign-ins excluded from activation' AS metric,
278
+ (
279
+ SELECT
280
+ COUNT(*)
281
+ FROM
282
+ auth_followup_signals AS signals
283
+ WHERE
284
+ COALESCE(signals.access_state, '') = 'done'
285
+ OR (
286
+ signals.completed_at_ms IS NOT NULL
287
+ AND signals.completed_at_ms <= signals.authenticated_at_ms
288
+ )
289
+ OR (
290
+ signals.access_state IS NULL
291
+ AND signals.first_home_at_ms IS NOT NULL
292
+ AND signals.first_interest_at_ms IS NULL
293
+ AND signals.first_consent_at_ms IS NULL
294
+ )
295
+ ) AS value,
296
+ 'info' AS severity,
297
+ 'Authentications by users who already completed activation or reached home directly, correctly filtered out of post-sign-in activation.' AS detail
298
+
299
+ UNION ALL
300
+
301
+
302
+ SELECT
303
+ 'total analytics events' AS metric,
304
+ COUNT(*) AS value,
305
+ 'info' AS severity,
306
+ 'Total rows available in analytics.events_flat at refresh time.' AS detail
307
+ FROM
308
+ `analytics.events_flat`
309
+
310
+ UNION ALL
311
+
312
+
313
+ SELECT
314
+ CONCAT('tracked interaction event count: ', category, ' / ', action) AS metric,
315
+ log_count AS value,
316
+ IF(log_count = 0, 'warning', 'info') AS severity,
317
+ IF(
318
+ log_count = 0,
319
+ '0 logs recorded for this expected interaction event; check if feature is unused or instrumentation is broken.',
320
+ 'Total interaction logs recorded for this category/action.'
321
+ ) AS detail
322
+ FROM
323
+ all_interaction_counts;