@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
@@ -1,639 +0,0 @@
1
- import { DOCUMENT } from '@angular/common';
2
- import { Injectable, inject } from '@angular/core';
3
- import { Observable, combineLatest, merge, of, from, pipe } from 'rxjs';
4
- import {
5
- tap,
6
- pluck,
7
- mergeMap,
8
- filter,
9
- takeUntil,
10
- skip,
11
- switchMap,
12
- map,
13
- take,
14
- } from 'rxjs/operators';
15
- import { environment } from '../../../environments/environment';
16
- import {
17
- Firestore,
18
- DocumentSnapshot,
19
- serverTimestamp,
20
- sum,
21
- count,
22
- average,
23
- Timestamp,
24
- getDoc,
25
- getDocs,
26
- doc,
27
- setDoc,
28
- updateDoc,
29
- deleteDoc,
30
- docData,
31
- collection,
32
- collectionData,
33
- collectionChanges,
34
- query,
35
- where,
36
- orderBy,
37
- OrderByDirection,
38
- limit,
39
- startAt,
40
- startAfter,
41
- endAt,
42
- endBefore,
43
- DocumentChange,
44
- increment,
45
- AggregateQuerySnapshot,
46
- AggregateField,
47
- AggregateSpec,
48
- getAggregateFromServer,
49
- getCountFromServer,
50
- writeBatch,
51
- WriteBatch,
52
- } from '@angular/fire/firestore';
53
- import {
54
- Auth,
55
- user,
56
- User,
57
- signInWithPopup,
58
- signOut,
59
- linkWithPopup,
60
- linkWithCredential,
61
- EmailAuthProvider,
62
- isSignInWithEmailLink,
63
- sendSignInLinkToEmail,
64
- signInAnonymously,
65
- signInWithEmailLink,
66
- GoogleAuthProvider,
67
- } from '@angular/fire/auth';
68
- import { QueryParams, QueryOptions, AnyEntity } from '../store/app.model';
69
- import { AuthSession, DatabaseService } from './database.service';
70
- import { Functions, httpsCallable } from '@angular/fire/functions';
71
- import { AccessState, User as AppUser } from '../store/user/user.model';
72
- import { UserPrivate } from '../store/user-private/user-private.model';
73
- import { EmailLinkContextService, EmailLinkFlow } from './email-link-context.service';
74
-
75
- type FirebaseAuthUser = Pick<
76
- User,
77
- | 'uid'
78
- | 'email'
79
- | 'displayName'
80
- | 'photoURL'
81
- | 'isAnonymous'
82
- | 'emailVerified'
83
- | 'providerData'
84
- >;
85
-
86
- /**
87
- * Maps a Firebase Auth `User` instance (or subset) into the application's normalized `AuthSession` model.
88
- *
89
- * Checks both top-level Firebase `User` properties and `providerData` entries to resolve
90
- * available display names, profile avatars, verified email addresses, and enabled sign-in providers.
91
- *
92
- * @param currentUser The raw Firebase Auth user object.
93
- * @returns A normalized `AuthSession` instance for state stores and guards.
94
- */
95
- export function firebaseUserToAuthSession(currentUser: FirebaseAuthUser): AuthSession {
96
- const providerIds = currentUser.providerData.map((provider) => provider.providerId);
97
- const firstProviderWithMeta = currentUser.providerData.find((p) => p.displayName || p.photoURL || p.email);
98
- const displayName = currentUser.displayName || firstProviderWithMeta?.displayName || null;
99
- const photoURL = currentUser.photoURL || firstProviderWithMeta?.photoURL || null;
100
- const email = currentUser.email || firstProviderWithMeta?.email || null;
101
-
102
- return {
103
- uid: currentUser.uid,
104
- email,
105
- displayName,
106
- photoURL,
107
- isAnonymous: currentUser.isAnonymous,
108
- emailVerified: currentUser.emailVerified,
109
- emailLinkEnabled: providerIds.includes(EmailAuthProvider.PROVIDER_ID),
110
- providerIds,
111
- };
112
- }
113
-
114
- @Injectable({
115
- providedIn: 'root',
116
- })
117
- export class FirebaseService implements DatabaseService {
118
- private afAuth = inject(Auth);
119
- private firestore = inject(Firestore);
120
- private user$ = user(this.afAuth);
121
- private functions = inject(Functions);
122
- private document = inject(DOCUMENT);
123
- private emailLinkContext = inject(EmailLinkContextService);
124
-
125
- constructor() {}
126
-
127
- /** Creates a unique Firestore auto-generated ID. */
128
- createId(): string {
129
- // see https://stackoverflow.com/questions/56574593/access-firestore-id-generator-on-the-front-end?noredirect=1&lq=1
130
- // see https://github.com/firebase/firebase-js-sdk/blob/73a586c92afe3f39a844b2be86086fddb6877bb7/packages/firestore/src/util/misc.ts#L36
131
- // Alphanumeric characters
132
- const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
133
- let autoId = '';
134
- for (let i = 0; i < 20; i++) {
135
- autoId += chars.charAt(Math.floor(Math.random() * chars.length));
136
- }
137
- return autoId;
138
- }
139
-
140
- /**
141
- * Returns an observable stream emitting the current `AuthSession` whenever Firebase authentication state changes.
142
- * Emits `null` when signed out.
143
- */
144
- afUser(): Observable<AuthSession | null> {
145
- return from(this.afAuth.authStateReady()).pipe(
146
- switchMap(() => this.user$),
147
- map((currentUser) => currentUser ? firebaseUserToAuthSession(currentUser) : null),
148
- );
149
- }
150
-
151
- /**
152
- * Signs in a user via Google OAuth popup and returns the mapped `AuthSession`.
153
- *
154
- * Forces token initialization before Firestore provisioning to avoid a fresh-login credentials race.
155
- */
156
- async signInWithGoogle(): Promise<AuthSession> {
157
- const result = await signInWithPopup(this.afAuth, new GoogleAuthProvider());
158
- await result.user.getIdToken(true);
159
- return firebaseUserToAuthSession(result.user);
160
- }
161
-
162
- /**
163
- * Creates an anonymous Firebase Auth session.
164
- *
165
- * Forces ID token initialization immediately after creation to prevent race conditions
166
- * with Firestore security rules on fresh sign-ins (especially after deleting a previous guest account).
167
- */
168
- async signInAnonymously(): Promise<AuthSession> {
169
- const result = await signInAnonymously(this.afAuth);
170
- // Force Firebase to establish the new anonymous token before AuthStore
171
- // provisions Firestore data. This is especially important immediately
172
- // after deleting a previous anonymous account.
173
- await result.user.getIdToken(true);
174
- return firebaseUserToAuthSession(result.user);
175
- }
176
-
177
- /**
178
- * Links a Google identity to the currently signed-in Firebase user without changing their UID.
179
- * Preserves existing guest/application data under the current UID.
180
- */
181
- async linkGoogle(): Promise<AuthSession> {
182
- const currentUser = this.afAuth.currentUser;
183
- if (!currentUser) throw new Error('No authenticated user is available to link Google.');
184
- const result = await linkWithPopup(currentUser, new GoogleAuthProvider());
185
- await result.user.getIdToken(true);
186
- return firebaseUserToAuthSession(result.user);
187
- }
188
-
189
- /**
190
- * Dispatches a passwordless email magic link for sign-in or guest upgrading.
191
- *
192
- * Saves flow context into `EmailLinkContextService` before sending the email.
193
- *
194
- * @param email The destination email address.
195
- */
196
- async sendEmailSignInLink(email: string): Promise<void> {
197
- const currentUser = this.afAuth.currentUser;
198
- const flow = currentUser?.isAnonymous ? 'guest-upgrade' : 'sign-in';
199
- await this.sendEmailLink(email, flow, currentUser?.isAnonymous ? currentUser.uid : null);
200
- }
201
-
202
- /**
203
- * Dispatches a passwordless email magic link to attach email-link sign-in to an existing account.
204
- */
205
- async sendEmailLinkForCurrentAccount(): Promise<void> {
206
- const currentUser = this.afAuth.currentUser;
207
- if (!currentUser?.email) throw new Error('An email address is required to enable email-link sign-in.');
208
- await this.sendEmailLink(currentUser.email, 'link-email', currentUser.uid);
209
- }
210
-
211
- /** Retrieves any stored email magic link email address from `EmailLinkContextService`. */
212
- getStoredEmailForEmailLink(): string | null {
213
- return this.emailLinkContext.getEmail();
214
- }
215
-
216
- /**
217
- * Verifies the magic link URL and completes authentication or account linking.
218
- *
219
- * - Handles `sign-in`, `guest-upgrade`, and `link-email` workflows.
220
- * - Enforces same-browser UID validation for upgrade and link flows.
221
- * - Refreshes the Firebase token and clears stored magic link context upon completion.
222
- *
223
- * @param url The full callback URL (containing action code parameters).
224
- * @param email The target email address.
225
- * @returns The updated `AuthSession`.
226
- */
227
- async completeEmailSignInLink(url: string, email: string): Promise<AuthSession> {
228
- if (!isSignInWithEmailLink(this.afAuth, url)) {
229
- throw this.authError('auth/invalid-action-code', 'This sign-in link is not valid.');
230
- }
231
- await this.afAuth.authStateReady();
232
-
233
- const flow = this.getEmailLinkFlow(url);
234
- const currentUser = this.afAuth.currentUser;
235
- const storedUid = this.emailLinkContext.getUid();
236
-
237
- if (flow === 'link-email' || flow === 'guest-upgrade') {
238
- if (!currentUser || currentUser.uid !== storedUid) {
239
- throw this.authError('auth/link-requires-original-session', 'Return to the browser where you started this account upgrade.');
240
- }
241
- const result = await linkWithCredential(currentUser, EmailAuthProvider.credentialWithLink(email, url));
242
- await result.user.getIdToken(true);
243
- this.clearEmailLinkContext();
244
- return firebaseUserToAuthSession(result.user);
245
- }
246
-
247
- try {
248
- const result = await signInWithEmailLink(this.afAuth, email, url);
249
- await result.user.getIdToken(true);
250
- this.clearEmailLinkContext();
251
- return firebaseUserToAuthSession(result.user);
252
- } catch (error) {
253
- const activeUser = this.afAuth.currentUser;
254
- if (activeUser && activeUser.email?.toLowerCase() === email.toLowerCase()) {
255
- await activeUser.getIdToken(true);
256
- this.clearEmailLinkContext();
257
- return firebaseUserToAuthSession(activeUser);
258
- }
259
- throw error;
260
- }
261
- }
262
-
263
- /**
264
- * Calls the `deleteAnonymousAccount` callable Cloud Function to server-delete guest-owned data
265
- * and the anonymous Firebase Auth account.
266
- */
267
- async deleteAnonymousAccount(): Promise<void> {
268
- await httpsCallable<void, void>(this.functions, 'deleteAnonymousAccount')();
269
- }
270
-
271
- /**
272
- * Ensures Firestore `users/{uid}` and `userPrivates/{uid}` profile documents exist for an authenticated user.
273
- *
274
- * Initializes missing profiles with default values (e.g. `accessState: SUBMIT_INTEREST`).
275
- * Updates profile name/photoURL if newly available from an upgraded Google login.
276
- *
277
- * @param session The active authentication session.
278
- * @returns The loaded or updated application user record.
279
- */
280
- async ensureUserProfile(session: AuthSession): Promise<AppUser> {
281
- const existing = await this.getEntity<AppUser>('users', session.uid);
282
- const existingPrivate = await this.getEntity<UserPrivate>('userPrivates', session.uid);
283
-
284
- if (!existing) {
285
- const profileData: AppUser = {
286
- __id: session.uid,
287
- name: session.displayName || session.email || (session.isAnonymous ? 'Guest' : 'Learner'),
288
- isAdmin: false,
289
- consented: false,
290
- accessState: AccessState.SUBMIT_INTEREST,
291
- ...(session.photoURL ? { photoURL: session.photoURL } : {}),
292
- };
293
- await this.addEntity('users', profileData);
294
- } else {
295
- const generatedName =
296
- !existing.name ||
297
- existing.name === 'Guest' ||
298
- existing.name === 'Learner' ||
299
- existing.name === session.email;
300
- const changes = {
301
- ...(generatedName && session.displayName ? { name: session.displayName } : {}),
302
- ...(session.photoURL && existing.photoURL !== session.photoURL ?
303
- { photoURL: session.photoURL } :
304
- {}),
305
- };
306
- if (Object.keys(changes).length > 0) {
307
- await this.updateEntity('users', session.uid, changes);
308
- }
309
- }
310
-
311
- if (session.email) {
312
- if (existingPrivate) {
313
- await this.updateEntity('userPrivates', session.uid, {
314
- email: session.email,
315
- ...(session.emailLinkEnabled !== undefined ? { emailLinkEnabled: session.emailLinkEnabled } : {}),
316
- });
317
- } else {
318
- const privateData: UserPrivate = {
319
- __id: session.uid,
320
- email: session.email,
321
- ...(session.emailLinkEnabled !== undefined ? { emailLinkEnabled: session.emailLinkEnabled } : {}),
322
- };
323
- await this.addEntity('userPrivates', privateData);
324
- }
325
- }
326
-
327
- const updatedProfile = await this.getEntity<AppUser>('users', session.uid);
328
- return (
329
- updatedProfile ||
330
- existing || {
331
- __id: session.uid,
332
- name: session.displayName || session.email || (session.isAnonymous ? 'Guest' : 'Learner'),
333
- isAdmin: false,
334
- consented: false,
335
- accessState: AccessState.SUBMIT_INTEREST,
336
- }
337
- );
338
- }
339
-
340
- /** Signs out the current Firebase user. */
341
- async logout() {
342
- await signOut(this.afAuth);
343
- }
344
-
345
- private actionCodeSettings(flow: EmailLinkFlow) {
346
- const origin = this.document.defaultView?.location.origin;
347
- if (!origin) throw new Error('Email actions require a browser origin.');
348
- return { url: `${origin}/auth/action?flow=${flow}`, handleCodeInApp: true };
349
- }
350
-
351
- private async sendEmailLink(email: string, flow: EmailLinkFlow, uid: string | null): Promise<void> {
352
- const context = { email, flow, uid };
353
- this.emailLinkContext.remember(context);
354
- try {
355
- await sendSignInLinkToEmail(this.afAuth, email, this.actionCodeSettings(flow));
356
- } catch (error) {
357
- this.emailLinkContext.clearIfMatches(context);
358
- throw error;
359
- }
360
- }
361
-
362
- private getEmailLinkFlow(url: string): EmailLinkFlow {
363
- const parsed = new URL(url);
364
- const directFlow = parsed.searchParams.get('flow');
365
- const continueUrl = parsed.searchParams.get('continueUrl');
366
- const nestedFlow = continueUrl ? new URL(continueUrl).searchParams.get('flow') : null;
367
- const flow = directFlow || nestedFlow || this.emailLinkContext.getFlow() || 'sign-in';
368
- return flow === 'guest-upgrade' || flow === 'link-email' ? flow : 'sign-in';
369
- }
370
-
371
- private clearEmailLinkContext(): void {
372
- this.emailLinkContext.clear();
373
- }
374
-
375
- private authError(code: string, message: string): Error & { code: string } {
376
- return Object.assign(new Error(message), { code });
377
- }
378
-
379
- streamEntity<T>(collectionName: string, id: string) {
380
- const docRef = doc(this.firestore, `${collectionName}/${id}`);
381
- return docData(docRef) as Observable<T>;
382
- }
383
-
384
- streamEntities<T>(collectionName, queryParams, queryOptions?) {
385
- const collectionRef = collection(this.firestore, collectionName);
386
- if (queryParams.length === 0 && (!queryOptions || Object.keys(queryOptions).length === 0)) {
387
- return collectionData(collectionRef) as Observable<T[]>;
388
- } else {
389
- return collectionData(
390
- query(collectionRef, ...this.constructQueryListRefMod(queryParams, queryOptions)),
391
- ) as Observable<T[]>;
392
- }
393
- }
394
-
395
- streamEntitiesChanges<T>(
396
- collectionName,
397
- queryParams,
398
- queryOptions?,
399
- ): Observable<
400
- {
401
- type: string;
402
- docData: T;
403
- }[]
404
- > {
405
- let stateChangeObs$;
406
- const collectionRef = collection(this.firestore, collectionName);
407
-
408
- if (queryParams.length === 0 && (!queryOptions || Object.keys(queryOptions).length === 0)) {
409
- stateChangeObs$ = collectionChanges(collectionRef);
410
- } else {
411
- stateChangeObs$ = collectionChanges(
412
- query(collectionRef, ...this.constructQueryListRefMod(queryParams, queryOptions)),
413
- ) as Observable<DocumentChange<T>[]>;
414
- }
415
-
416
- return stateChangeObs$.pipe(
417
- map((changes: DocumentChange<T>[]) => {
418
- return changes.map((dc) => {
419
- const data = dc.doc.data();
420
- const docData = data ? { __id: dc.doc.id, ...data } : ({ __id: dc.doc.id } as unknown as T);
421
- return {
422
- type: dc.type,
423
- docData,
424
- };
425
- });
426
- }),
427
- );
428
- }
429
-
430
- private constructQueryListRefMod(queryParams, queryOptions?) {
431
- // Convert queryParams to queryArray
432
- // Note: firestore supports setting and querying for null, but not
433
- // undefined. We filter out cases where the value is undefined
434
- // to protect against cases when people are doing a nested query
435
- // and some entity does not have a particular field, e.g.
436
- // [['__hashtagId', '==', q.__hashtagId]] when __hashtagId is
437
- // an optional parameter
438
- const queryArray = queryParams
439
- .filter((query) => query[2] !== undefined)
440
- .map((query) => {
441
- const [prop, comp, val] = query;
442
- return where(prop, comp, val);
443
- });
444
-
445
- // Add queryOptions to queryArray
446
- if (queryOptions) {
447
- Object.keys(queryOptions).forEach((queryKey) => {
448
- switch (queryKey) {
449
- case 'orderBy': {
450
- if (Array.isArray(queryOptions.orderBy)) {
451
- if (Array.isArray(queryOptions.orderBy[0])) {
452
- for (const order of queryOptions.orderBy) {
453
- queryArray.push(orderBy(order[0], order[1] as OrderByDirection));
454
- }
455
- } else {
456
- queryArray.push(
457
- orderBy(
458
- queryOptions.orderBy[0] as string,
459
- queryOptions.orderBy[1] as OrderByDirection,
460
- ),
461
- );
462
- }
463
- } else {
464
- queryArray.push(orderBy(queryOptions.orderBy));
465
- }
466
- break;
467
- }
468
- case 'limit':
469
- queryArray.push(limit(queryOptions.limit));
470
- break;
471
-
472
- case 'startAt':
473
- queryArray.push(startAt(queryOptions.startAt));
474
- break;
475
-
476
- case 'startAfter':
477
- queryArray.push(startAfter(queryOptions.startAfter));
478
- break;
479
-
480
- case 'endAt':
481
- queryArray.push(endAt(queryOptions.endAt));
482
- break;
483
-
484
- case 'endBefore':
485
- queryArray.push(endBefore(queryOptions.endBefore));
486
- break;
487
-
488
- default:
489
- break;
490
- }
491
- });
492
- }
493
- return queryArray;
494
- }
495
-
496
- async getEntity<T>(collectionName: string, id: string) {
497
- const docRef = doc(this.firestore, `${collectionName}/${id}`);
498
- const docSnap = (await getDoc(docRef)) as DocumentSnapshot<T, T>;
499
-
500
- if (docSnap.exists()) {
501
- return docSnap.data();
502
- } else {
503
- return null;
504
- }
505
- }
506
-
507
- async getEntities<S>(
508
- collectionName: string,
509
- queryParams: [string, string, any][],
510
- queryOptions?: { [index: string]: any },
511
- ): Promise<S[]> {
512
- const collectionRef = collection(this.firestore, collectionName);
513
- let querySnapshot;
514
- if (queryParams.length === 0 && (!queryOptions || Object.keys(queryOptions).length === 0)) {
515
- querySnapshot = await getDocs(collectionRef);
516
- } else {
517
- querySnapshot = await getDocs(
518
- query(collectionRef, ...this.constructQueryListRefMod(queryParams, queryOptions)),
519
- );
520
- }
521
- const entities = querySnapshot.docs.map((doc) => doc.data());
522
- return entities;
523
- }
524
-
525
- async count(
526
- collectionName: string,
527
- queryParams: QueryParams,
528
- queryOptions?: QueryOptions,
529
- ): Promise<number> {
530
- const collectionRef = collection(this.firestore, collectionName);
531
- let querySnapshot;
532
- if (queryParams.length === 0 && (!queryOptions || Object.keys(queryOptions).length === 0)) {
533
- querySnapshot = await getCountFromServer(collectionRef);
534
- } else {
535
- querySnapshot = await getCountFromServer(
536
- query(collectionRef, ...this.constructQueryListRefMod(queryParams, queryOptions)),
537
- );
538
- }
539
- return querySnapshot.data().count;
540
- }
541
-
542
- /*
543
- * Example of aggregateSpec
544
- * {
545
- * countOfDocs: ['count'],
546
- * totalPopulation: ['sum', 'population'],
547
- * averagePopulation: ['average', 'population'],
548
- * }
549
- */
550
- async aggregate<S extends { [k: string]: number }>(
551
- collectionName: string,
552
- queryParams: QueryParams,
553
- queryOptions: QueryOptions,
554
- aggregateParams: { [K in keyof S]: [string] | [string, string] },
555
- ): Promise<{ [K in keyof S]: number }> {
556
- const collectionRef = collection(this.firestore, collectionName);
557
- let querySnapshot;
558
-
559
- const aggregateSpec: AggregateSpec = {};
560
-
561
- for (const key in aggregateParams) {
562
- if (key === 'count') {
563
- aggregateSpec[key] = count();
564
- } else if (key === 'sum') {
565
- aggregateSpec[key] = sum(aggregateParams[key][1]);
566
- } else if (key === 'average') {
567
- aggregateSpec[key] = average(aggregateParams[key][1]);
568
- }
569
- }
570
-
571
- if (queryParams.length === 0 && (!queryOptions || Object.keys(queryOptions).length === 0)) {
572
- querySnapshot = await getAggregateFromServer(collectionRef, aggregateSpec);
573
- } else {
574
- querySnapshot = await getAggregateFromServer(
575
- query(collectionRef, ...this.constructQueryListRefMod(queryParams, queryOptions)),
576
- aggregateSpec,
577
- );
578
- }
579
- return querySnapshot.data();
580
- }
581
-
582
- async addEntity(collectionName: string, entity: AnyEntity, batch?: WriteBatch) {
583
- const docRef = doc(this.firestore, `${collectionName}/${entity.__id}`);
584
- const entityFinal = Object.assign({}, entity, {
585
- _createdAt: serverTimestamp(),
586
- _updatedAt: serverTimestamp(),
587
- _deleted: false,
588
- });
589
- if (batch) {
590
- return batch.set(docRef, entityFinal);
591
- } else {
592
- return setDoc(docRef, entityFinal);
593
- }
594
- }
595
-
596
- async updateEntity(
597
- collectionName: string,
598
- id: string,
599
- changes: Partial<AnyEntity>,
600
- batch?: WriteBatch,
601
- ) {
602
- const docRef = doc(this.firestore, `${collectionName}/${id}`);
603
- const changesFinal = Object.assign({}, changes, {
604
- _updatedAt: serverTimestamp(),
605
- });
606
- if (batch) {
607
- return batch.update(docRef, changesFinal);
608
- } else {
609
- return updateDoc(docRef, changesFinal);
610
- }
611
- }
612
-
613
- async removeEntity(collectionName: string, id: string, batch?: WriteBatch) {
614
- const docRef = doc(this.firestore, `${collectionName}/${id}`);
615
- // we do soft deletes from client side
616
- const changes = {
617
- _updatedAt: serverTimestamp(),
618
- _deleted: true,
619
- };
620
- if (batch) {
621
- return batch.update(docRef, changes);
622
- } else {
623
- return updateDoc(docRef, changes);
624
- }
625
- }
626
-
627
- async incrementEntityField(collectionName, id, field, delta) {
628
- const docRef = doc(this.firestore, collectionName, id);
629
- const changes = {};
630
- changes[field] = increment(delta);
631
-
632
- return updateDoc(
633
- docRef,
634
- Object.assign({}, changes, {
635
- _updatedAt: serverTimestamp(),
636
- }),
637
- );
638
- }
639
- }