@tech4good/angular-schematics 21.5.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 (273) hide show
  1. package/CHANGELOG.md +44 -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 +16 -7
  7. package/src/entity/files/__name@dasherize__/__name@dasherize__.model.ts.template +13 -6
  8. package/src/entity/files/__name@dasherize__/__name@dasherize__.store.ts.template +18 -10
  9. package/src/entity/index.js +61 -49
  10. package/src/entity/index.js.map +1 -1
  11. package/src/entity/schema.json +4 -0
  12. package/src/guard/files/__name@dasherize__.guard.spec.ts.template +0 -1
  13. package/src/ng-add/files/.github/workflows/angular-github-ci.yml.template +3 -0
  14. package/src/ng-add/files/.gitignore.template +5 -0
  15. package/src/ng-add/files/analytics/datasets.js.template +206 -0
  16. package/src/ng-add/files/analytics/entity_sources.js.template +58 -0
  17. package/src/ng-add/files/analytics/entity_sources.test.js.template +57 -0
  18. package/src/ng-add/files/analytics/lib/api_query.js.template +87 -0
  19. package/src/ng-add/files/analytics/lib/api_query.test.js.template +84 -0
  20. package/src/ng-add/files/analytics/lib/bigquery_query_compatibility.test.js.template +53 -0
  21. package/src/ng-add/files/analytics/lib/dataset_schema.js.template +53 -0
  22. package/src/ng-add/files/analytics/lib/dataset_schema.test.js.template +34 -0
  23. package/src/ng-add/files/analytics/lib/entity_sync.js.template +397 -0
  24. package/src/ng-add/files/analytics/lib/entity_sync.test.js.template +212 -0
  25. package/src/ng-add/files/analytics/lib/identifier_salt.js.template +57 -0
  26. package/src/ng-add/files/analytics/lib/identifier_salt.test.js.template +36 -0
  27. package/src/ng-add/files/analytics/lib/snapshot_files.js.template +46 -0
  28. package/src/ng-add/files/analytics/lib/snapshot_files.test.js.template +67 -0
  29. package/src/ng-add/files/analytics/lib/sqlite.js.template +92 -0
  30. package/src/ng-add/files/analytics/lib/upload_entities.js.template +81 -0
  31. package/src/ng-add/files/analytics/lib/upload_entities.test.js.template +86 -0
  32. package/src/ng-add/files/analytics/proxy.conf.json.template +7 -0
  33. package/src/ng-add/files/analytics/scripts/refresh_snapshot.js.template +518 -0
  34. package/src/ng-add/files/analytics/scripts/start.js.template +88 -0
  35. package/src/ng-add/files/analytics/server/server.js.template +212 -0
  36. package/src/ng-add/files/angular.json.template +80 -1
  37. package/src/ng-add/files/bigquery/queries/active_time_by_route.sql.template +27 -8
  38. package/src/ng-add/files/bigquery/queries/active_user_windows.sql.template +67 -0
  39. package/src/ng-add/files/bigquery/queries/dashboard_route_visits.sql.template +47 -0
  40. package/src/ng-add/files/bigquery/queries/data_quality.sql.template +323 -0
  41. package/src/ng-add/files/bigquery/queries/onboarding_funnel.sql.template +512 -0
  42. package/src/ng-add/files/bigquery/queries/onboarding_stage_observations.sql.template +134 -0
  43. package/src/ng-add/files/bigquery/queries/weekly_retention_cohorts.sql.template +90 -0
  44. package/src/ng-add/files/bigquery/scripts/export_entities.js.template +120 -0
  45. package/src/ng-add/files/bigquery/scripts/init_views.js.template +57 -0
  46. package/src/ng-add/files/bigquery/scripts/run_query.js.template +141 -0
  47. package/src/ng-add/files/bigquery/views/events_flat.sql.template +27 -12
  48. package/src/ng-add/files/bigquery/views/logs_latest.sql.template +16 -3
  49. package/src/ng-add/files/docs-infra/analytics-guide.md.template +270 -25
  50. package/src/ng-add/files/docs-infra/analytics-workbench-guide.md.template +307 -0
  51. package/src/ng-add/files/docs-infra/authentication-architecture.md.template +300 -0
  52. package/src/ng-add/files/docs-infra/email-infrastructure.md.template +43 -0
  53. package/src/ng-add/files/docs-infra/firestore-index-checker.md.template +87 -0
  54. package/src/ng-add/files/docs-infra/infrastructure-guide.md.template +123 -38
  55. package/src/ng-add/files/docs-infra/load-system-architecture.md.template +15 -1
  56. package/src/ng-add/files/docs-infra/querying-strategy.md.template +14 -0
  57. package/src/ng-add/files/docs-infra/stream-system-architecture.md.template +21 -7
  58. package/src/ng-add/files/eslint.config.js.template +22 -3
  59. package/src/ng-add/files/firebase.json.template +6 -0
  60. package/src/ng-add/files/firestore.indexes.json.template +23 -0
  61. package/src/ng-add/files/firestore.rules.spec.ts.template +84 -15
  62. package/src/ng-add/files/firestore.rules.template +29 -17
  63. package/src/ng-add/files/functions/.gitignore.template +3 -0
  64. package/src/ng-add/files/functions/package.json.template +13 -0
  65. package/src/ng-add/files/functions/src/email.ts.template +23 -0
  66. package/src/ng-add/files/functions/src/index.ts.template +44 -0
  67. package/src/ng-add/files/functions/tsconfig.json.template +13 -0
  68. package/src/ng-add/files/jest.config.ts.template +3 -2
  69. package/src/ng-add/files/package.json.template +41 -16
  70. package/src/ng-add/files/projects/analytics/src/app/analytics-api.service.ts.template +130 -0
  71. package/src/ng-add/files/projects/analytics/src/app/app.component.html.template +77 -0
  72. package/src/ng-add/files/projects/analytics/src/app/app.component.scss.template +240 -0
  73. package/src/ng-add/files/projects/analytics/src/app/app.component.ts.template +96 -0
  74. package/src/ng-add/files/projects/analytics/src/app/app.routes.ts.template +11 -0
  75. package/src/ng-add/files/projects/analytics/src/app/dashboard-pages.spec.ts.template +151 -0
  76. package/src/ng-add/files/projects/analytics/src/app/data-quality/data-quality-page/data-quality-page.component.html.template +39 -0
  77. package/src/ng-add/files/projects/analytics/src/app/data-quality/data-quality-page/data-quality-page.component.scss.template +1 -0
  78. package/src/ng-add/files/projects/analytics/src/app/data-quality/data-quality-page/data-quality-page.component.ts.template +95 -0
  79. package/src/ng-add/files/projects/analytics/src/app/engagement/engagement-page/engagement-page.component.html.template +47 -0
  80. package/src/ng-add/files/projects/analytics/src/app/engagement/engagement-page/engagement-page.component.scss.template +1 -0
  81. package/src/ng-add/files/projects/analytics/src/app/engagement/engagement-page/engagement-page.component.ts.template +120 -0
  82. package/src/ng-add/files/projects/analytics/src/app/onboarding/onboarding-page/onboarding-page.component.html.template +40 -0
  83. package/src/ng-add/files/projects/analytics/src/app/onboarding/onboarding-page/onboarding-page.component.scss.template +1 -0
  84. package/src/ng-add/files/projects/analytics/src/app/onboarding/onboarding-page/onboarding-page.component.ts.template +98 -0
  85. package/src/ng-add/files/projects/analytics/src/app/overview/overview-page/overview-page.component.html.template +35 -0
  86. package/src/ng-add/files/projects/analytics/src/app/overview/overview-page/overview-page.component.scss.template +1 -0
  87. package/src/ng-add/files/projects/analytics/src/app/overview/overview-page/overview-page.component.ts.template +84 -0
  88. package/src/ng-add/files/projects/analytics/src/app/routes/routes-page/routes-page.component.html.template +42 -0
  89. package/src/ng-add/files/projects/analytics/src/app/routes/routes-page/routes-page.component.scss.template +1 -0
  90. package/src/ng-add/files/projects/analytics/src/app/routes/routes-page/routes-page.component.ts.template +110 -0
  91. package/src/ng-add/files/projects/analytics/src/app/shared/analytics-utils.ts.template +43 -0
  92. package/src/ng-add/files/projects/analytics/src/app/shared/chart-theme.ts.template +42 -0
  93. package/src/ng-add/files/projects/analytics/src/app/shared/dashboard-layout.scss.template +239 -0
  94. package/src/ng-add/files/projects/analytics/src/app/shared/dashboard-table/dashboard-table.component.html.template +76 -0
  95. package/src/ng-add/files/projects/analytics/src/app/shared/dashboard-table/dashboard-table.component.scss.template +128 -0
  96. package/src/ng-add/files/projects/analytics/src/app/shared/dashboard-table/dashboard-table.component.spec.ts.template +31 -0
  97. package/src/ng-add/files/projects/analytics/src/app/shared/dashboard-table/dashboard-table.component.ts.template +153 -0
  98. package/src/ng-add/files/projects/analytics/src/app/shared/funnel-chart/funnel-chart.component.html.template +16 -0
  99. package/src/ng-add/files/projects/analytics/src/app/shared/funnel-chart/funnel-chart.component.scss.template +63 -0
  100. package/src/ng-add/files/projects/analytics/src/app/shared/funnel-chart/funnel-chart.component.ts.template +52 -0
  101. package/src/ng-add/files/projects/analytics/src/app/shared/metric-card/metric-card.component.html.template +5 -0
  102. package/src/ng-add/files/projects/analytics/src/app/shared/metric-card/metric-card.component.scss.template +56 -0
  103. package/src/ng-add/files/projects/analytics/src/app/shared/metric-card/metric-card.component.spec.ts.template +30 -0
  104. package/src/ng-add/files/projects/analytics/src/app/shared/metric-card/metric-card.component.ts.template +15 -0
  105. package/src/ng-add/files/projects/analytics/src/app/shared/quality-chart/quality-chart.component.html.template +9 -0
  106. package/src/ng-add/files/projects/analytics/src/app/shared/quality-chart/quality-chart.component.scss.template +43 -0
  107. package/src/ng-add/files/projects/analytics/src/app/shared/quality-chart/quality-chart.component.ts.template +62 -0
  108. package/src/ng-add/files/projects/analytics/src/app/shared/route-distribution-chart/route-distribution-chart.component.html.template +9 -0
  109. package/src/ng-add/files/projects/analytics/src/app/shared/route-distribution-chart/route-distribution-chart.component.scss.template +33 -0
  110. package/src/ng-add/files/projects/analytics/src/app/shared/route-distribution-chart/route-distribution-chart.component.ts.template +82 -0
  111. package/src/ng-add/files/projects/analytics/src/app/shared/route-traffic-chart/route-traffic-chart.component.html.template +15 -0
  112. package/src/ng-add/files/projects/analytics/src/app/shared/route-traffic-chart/route-traffic-chart.component.scss.template +45 -0
  113. package/src/ng-add/files/projects/analytics/src/app/shared/route-traffic-chart/route-traffic-chart.component.ts.template +55 -0
  114. package/src/ng-add/files/projects/analytics/src/app/shared/status-message/status-message.component.html.template +18 -0
  115. package/src/ng-add/files/projects/analytics/src/app/shared/status-message/status-message.component.scss.template +45 -0
  116. package/src/ng-add/files/projects/analytics/src/app/shared/status-message/status-message.component.ts.template +15 -0
  117. package/src/ng-add/files/projects/analytics/src/app/vega-chart/vega-chart.component.ts.template +121 -0
  118. package/src/ng-add/files/projects/analytics/src/index.html.template +19 -0
  119. package/src/ng-add/files/projects/analytics/src/main.ts.template +16 -0
  120. package/src/ng-add/files/projects/analytics/src/styles.scss.template +28 -0
  121. package/src/ng-add/files/projects/analytics/tsconfig.app.json.template +13 -0
  122. package/src/ng-add/files/projects/analytics/tsconfig.spec.json.template +15 -0
  123. package/src/ng-add/files/src/app/admin/admin-panel/admin-panel.component.html.template +3 -1
  124. package/src/ng-add/files/src/app/admin/admin-panel/admin-panel.component.spec.ts.template +10 -13
  125. package/src/ng-add/files/src/app/admin/admin-panel/admin-panel.component.ts.template +2 -0
  126. package/src/ng-add/files/src/app/admin/admin-panel/admin-settings/admin-settings.component.spec.ts.template +4 -5
  127. package/src/ng-add/files/src/app/admin/admin-panel/admin-user-list/admin-user-list.component.spec.ts.template +11 -12
  128. package/src/ng-add/files/src/app/admin/admin-panel/admin-user-list/admin-user-list.component.ts.template +7 -7
  129. 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
  130. package/src/ng-add/files/src/app/admin/admin-panel/admin-user-list/admin-user-table/admin-user-table.component.ts.template +3 -2
  131. package/src/ng-add/files/src/app/app.component.html.template +3 -3
  132. package/src/ng-add/files/src/app/app.component.scss.template +1 -1
  133. package/src/ng-add/files/src/app/app.component.spec.ts.template +4 -5
  134. package/src/ng-add/files/src/app/app.component.ts.template +3 -2
  135. package/src/ng-add/files/src/app/app.config.ts.template +21 -15
  136. package/src/ng-add/files/src/app/app.routes.ts.template +6 -0
  137. package/src/ng-add/files/src/app/auth-routing.spec.ts.template +13 -9
  138. package/src/ng-add/files/src/app/core/analytics/time-analytics.service.spec.ts.template +46 -29
  139. package/src/ng-add/files/src/app/core/analytics/time-analytics.service.ts.template +27 -18
  140. package/src/ng-add/files/src/app/core/auth/auth.providers.spec.ts.template +112 -0
  141. package/src/ng-add/files/src/app/core/auth/auth.providers.ts.template +48 -0
  142. package/src/ng-add/files/src/app/core/auth/auth.service.ts.template +14 -23
  143. package/src/ng-add/files/src/app/core/auth/guards/require-admin.guard.spec.ts.template +27 -0
  144. package/src/ng-add/files/src/app/core/auth/guards/require-admin.guard.ts.template +3 -2
  145. package/src/ng-add/files/src/app/core/auth/guards/require-auth-and-consent.guard.ts.template +7 -2
  146. package/src/ng-add/files/src/app/core/firebase/data.providers.prod.ts.template +21 -0
  147. package/src/ng-add/files/src/app/core/firebase/data.providers.ts.template +13 -0
  148. package/src/ng-add/files/src/app/core/local-storage/session.service.spec.ts.template +43 -0
  149. package/src/ng-add/files/src/app/core/local-storage/session.service.ts.template +7 -0
  150. package/src/ng-add/files/src/app/core/store/app-data.spec.ts.template +76 -0
  151. package/src/ng-add/files/src/app/core/store/auth/auth.mock.ts.template +20 -82
  152. package/src/ng-add/files/src/app/core/store/auth/auth.store.spec.ts.template +217 -0
  153. package/src/ng-add/files/src/app/core/store/auth/auth.store.ts.template +36 -172
  154. package/src/ng-add/files/src/app/core/store/user/user.mock.ts.template +18 -15
  155. package/src/ng-add/files/src/app/core/store/user/user.model.ts.template +7 -8
  156. package/src/ng-add/files/src/app/core/store/user/user.store.ts.template +14 -10
  157. package/src/ng-add/files/src/app/core/store/user-context/user-context.mock.ts.template +20 -8
  158. package/src/ng-add/files/src/app/core/store/user-context/user-context.model.ts.template +5 -6
  159. package/src/ng-add/files/src/app/core/store/user-context/user-context.store.ts.template +14 -10
  160. package/src/ng-add/files/src/app/core/store/user-private/user-private.mock.ts.template +20 -7
  161. package/src/ng-add/files/src/app/core/store/user-private/user-private.model.ts.template +6 -6
  162. package/src/ng-add/files/src/app/core/store/user-private/user-private.store.ts.template +14 -10
  163. package/src/ng-add/files/src/app/core/testing/app-mocks.ts.template +42 -0
  164. package/src/ng-add/files/src/app/first-time/auth-action/auth-action.component.html.template +4 -0
  165. package/src/ng-add/files/src/app/first-time/auth-action/auth-action.component.scss.template +1 -0
  166. package/src/ng-add/files/src/app/first-time/auth-action/auth-action.component.ts.template +38 -0
  167. package/src/ng-add/files/src/app/first-time/consent/consent.component.html.template +2 -1
  168. package/src/ng-add/files/src/app/first-time/consent/consent.component.scss.template +7 -3
  169. package/src/ng-add/files/src/app/first-time/consent/consent.component.spec.ts.template +31 -11
  170. package/src/ng-add/files/src/app/first-time/consent/consent.component.ts.template +16 -1
  171. package/src/ng-add/files/src/app/first-time/consent/consent.guard.ts.template +5 -1
  172. package/src/ng-add/files/src/app/first-time/early-access/early-access.component.spec.ts.template +27 -16
  173. package/src/ng-add/files/src/app/first-time/early-access/early-access.component.ts.template +102 -49
  174. package/src/ng-add/files/src/app/first-time/early-access/early-access.guard.ts.template +5 -1
  175. package/src/ng-add/files/src/app/first-time/early-access/survey-form/survey-form.component.html.template +2 -1
  176. package/src/ng-add/files/src/app/first-time/early-access/survey-form/survey-form.component.scss.template +7 -3
  177. package/src/ng-add/files/src/app/first-time/early-access/survey-form/survey-form.component.spec.ts.template +20 -6
  178. package/src/ng-add/files/src/app/first-time/early-access/survey-form/survey-form.component.ts.template +2 -0
  179. package/src/ng-add/files/src/app/first-time/early-access/waitlist-view/waitlist-view.component.spec.ts.template +4 -5
  180. package/src/ng-add/files/src/app/first-time/email-link/email-link.component.html.template +18 -0
  181. package/src/ng-add/files/src/app/first-time/email-link/email-link.component.scss.template +2 -0
  182. package/src/ng-add/files/src/app/first-time/email-link/email-link.component.spec.ts.template +56 -0
  183. package/src/ng-add/files/src/app/first-time/email-link/email-link.component.ts.template +91 -0
  184. package/src/ng-add/files/src/app/first-time/first-time-routing.spec.ts.template +11 -7
  185. package/src/ng-add/files/src/app/first-time/landing/hero/hero.component.html.template +19 -7
  186. package/src/ng-add/files/src/app/first-time/landing/hero/hero.component.scss.template +51 -0
  187. package/src/ng-add/files/src/app/first-time/landing/hero/hero.component.ts.template +44 -5
  188. package/src/ng-add/files/src/app/first-time/landing/landing.component.html.template +2 -1
  189. package/src/ng-add/files/src/app/first-time/landing/landing.component.scss.template +12 -8
  190. package/src/ng-add/files/src/app/first-time/landing/landing.component.spec.ts.template +33 -10
  191. package/src/ng-add/files/src/app/first-time/landing/landing.component.ts.template +6 -19
  192. package/src/ng-add/files/src/app/first-time/login/login.component.html.template +58 -6
  193. package/src/ng-add/files/src/app/first-time/login/login.component.scss.template +151 -22
  194. package/src/ng-add/files/src/app/first-time/login/login.component.spec.ts.template +30 -32
  195. package/src/ng-add/files/src/app/first-time/login/login.component.ts.template +85 -31
  196. package/src/ng-add/files/src/app/first-time/onboarding/onboarding.component.spec.ts.template +4 -2
  197. package/src/ng-add/files/src/app/first-time/onboarding/onboarding.component.ts.template +1 -1
  198. package/src/ng-add/files/src/app/main/account-profile/account-profile.component.html.template +12 -0
  199. package/src/ng-add/files/src/app/main/account-profile/account-profile.component.scss.template +39 -0
  200. package/src/ng-add/files/src/app/main/account-profile/account-profile.component.spec.ts.template +68 -0
  201. package/src/ng-add/files/src/app/main/account-profile/account-profile.component.ts.template +20 -0
  202. package/src/ng-add/files/src/app/main/account-profile/delete-guest-card/delete-guest-card.component.html.template +24 -0
  203. package/src/ng-add/files/src/app/main/account-profile/delete-guest-card/delete-guest-card.component.scss.template +50 -0
  204. package/src/ng-add/files/src/app/main/account-profile/delete-guest-card/delete-guest-card.component.spec.ts.template +65 -0
  205. package/src/ng-add/files/src/app/main/account-profile/delete-guest-card/delete-guest-card.component.ts.template +59 -0
  206. package/src/ng-add/files/src/app/main/account-profile/guest-deletion-dialog.component.ts.template +51 -0
  207. package/src/ng-add/files/src/app/main/account-profile/profile-details-card/profile-details-card.component.html.template +50 -0
  208. package/src/ng-add/files/src/app/main/account-profile/profile-details-card/profile-details-card.component.scss.template +137 -0
  209. package/src/ng-add/files/src/app/main/account-profile/profile-details-card/profile-details-card.component.spec.ts.template +57 -0
  210. package/src/ng-add/files/src/app/main/account-profile/profile-details-card/profile-details-card.component.ts.template +59 -0
  211. package/src/ng-add/files/src/app/main/account-profile/sign-in-methods-card/sign-in-methods-card.component.html.template +133 -0
  212. package/src/ng-add/files/src/app/main/account-profile/sign-in-methods-card/sign-in-methods-card.component.scss.template +207 -0
  213. package/src/ng-add/files/src/app/main/account-profile/sign-in-methods-card/sign-in-methods-card.component.spec.ts.template +74 -0
  214. package/src/ng-add/files/src/app/main/account-profile/sign-in-methods-card/sign-in-methods-card.component.ts.template +130 -0
  215. package/src/ng-add/files/src/app/main/home/home.component.spec.ts.template +4 -5
  216. package/src/ng-add/files/src/app/main/home/home.component.ts.template +1 -6
  217. package/src/ng-add/files/src/app/shared/guest-warning-bar/guest-warning-bar.component.html.template +15 -0
  218. package/src/ng-add/files/src/app/shared/guest-warning-bar/guest-warning-bar.component.scss.template +79 -0
  219. package/src/ng-add/files/src/app/shared/guest-warning-bar/guest-warning-bar.component.spec.ts.template +59 -0
  220. package/src/ng-add/files/src/app/shared/guest-warning-bar/guest-warning-bar.component.ts.template +44 -0
  221. package/src/ng-add/files/src/app/shared/navbar/navbar.component.html.template +45 -15
  222. package/src/ng-add/files/src/app/shared/navbar/navbar.component.scss.template +103 -19
  223. package/src/ng-add/files/src/app/shared/navbar/navbar.component.spec.ts.template +73 -9
  224. package/src/ng-add/files/src/app/shared/navbar/navbar.component.ts.template +46 -18
  225. package/src/ng-add/files/src/environments/environment.prod.ts.template +1 -0
  226. package/src/ng-add/files/src/environments/environment.test.ts.template +1 -0
  227. package/src/ng-add/files/src/environments/environment.ts.template +1 -1
  228. package/src/ng-add/files/tsconfig.spec.json.template +3 -1
  229. package/src/ng-add/index.js +7 -0
  230. package/src/ng-add/index.js.map +1 -1
  231. package/src/shared/entity-registry.d.ts +8 -0
  232. package/src/shared/entity-registry.js +28 -0
  233. package/src/shared/entity-registry.js.map +1 -0
  234. package/tsconfig.json +2 -2
  235. package/.agents/skills/publish-npm/SKILL.md +0 -37
  236. package/.agents/skills/publish-npm/eval.yaml +0 -32
  237. package/.agents/skills/publish-npm/fixtures/package-v21.json.template +0 -8
  238. package/.husky/commit-msg +0 -1
  239. package/.husky/pre-commit +0 -1
  240. package/.t4g/agent-memory.db +0 -0
  241. package/src/component/index_spec.d.ts +0 -1
  242. package/src/component/index_spec.js +0 -68
  243. package/src/component/index_spec.js.map +0 -1
  244. package/src/entity/index_spec.d.ts +0 -1
  245. package/src/entity/index_spec.js +0 -153
  246. package/src/entity/index_spec.js.map +0 -1
  247. package/src/guard/index_spec.d.ts +0 -1
  248. package/src/guard/index_spec.js +0 -64
  249. package/src/guard/index_spec.js.map +0 -1
  250. package/src/ng-add/files/bigquery/scripts/export_entities.py.template +0 -143
  251. package/src/ng-add/files/bigquery/scripts/run_query.py.template +0 -167
  252. package/src/ng-add/files/src/app/core/firebase/cached-listeners.service.ts.template +0 -494
  253. package/src/ng-add/files/src/app/core/firebase/database.service.ts.template +0 -56
  254. package/src/ng-add/files/src/app/core/firebase/firebase.mock.service.ts.template +0 -366
  255. package/src/ng-add/files/src/app/core/firebase/firebase.service.ts.template +0 -342
  256. package/src/ng-add/files/src/app/core/firebase/simulate-load.spec.ts.template +0 -104
  257. package/src/ng-add/files/src/app/core/firebase/simulate-stream.spec.ts.template +0 -127
  258. package/src/ng-add/files/src/app/core/firebase/simulation.mock.ts.template +0 -38
  259. package/src/ng-add/files/src/app/core/firebase/stream-multiplexer.ts.template +0 -445
  260. package/src/ng-add/files/src/app/core/logging/logging.service.spec.ts.template +0 -118
  261. package/src/ng-add/files/src/app/core/logging/logging.service.ts.template +0 -168
  262. package/src/ng-add/files/src/app/core/store/app.model.ts.template +0 -21
  263. package/src/ng-add/files/src/app/core/store/app.store.spec.ts.template +0 -920
  264. package/src/ng-add/files/src/app/core/store/app.store.ts.template +0 -1317
  265. package/src/ng-add/files/src/app/core/store/batch-write.firebase.service.ts.template +0 -58
  266. package/src/ng-add/files/src/app/core/store/batch-write.mock.service.ts.template +0 -105
  267. package/src/ng-add/files/src/app/core/store/batch-write.service.ts.template +0 -126
  268. package/src/ng-add/files/src/app/shared/redeployment-warning/redeployment-warning.component.html.template +0 -9
  269. package/src/ng-add/files/src/app/shared/redeployment-warning/redeployment-warning.component.scss.template +0 -46
  270. package/src/ng-add/files/src/app/shared/redeployment-warning/redeployment-warning.component.spec.ts.template +0 -69
  271. package/src/ng-add/files/src/app/shared/redeployment-warning/redeployment-warning.component.ts.template +0 -39
  272. package/src/ng-add/files/src/app/shared/redeployment-warning/redeployment-warning.service.spec.ts.template +0 -122
  273. package/src/ng-add/files/src/app/shared/redeployment-warning/redeployment-warning.service.ts.template +0 -88
@@ -1,445 +0,0 @@
1
- import { DestroyRef } from '@angular/core';
2
- import { DatabaseService } from './database.service';
3
- import { entityInQueryResults } from '../store/app.store';
4
- import { getLogger } from '../logging/logging.service';
5
- import { QueryParams, AnyEntity } from '../store/app.model';
6
-
7
- const queryLogger = getLogger('query');
8
-
9
- /**
10
- * StreamMultiplexer optimizes Firestore realtime subscriptions by multiplexing multiple
11
- * independent component requests into a minimal number of batched 'in' queries.
12
- *
13
- * It manages two pools of websockets:
14
- * 1. `batchedListeners`: fully packed 'in' queries (chunks of 30 IDs).
15
- * 2. `singleListeners`: sparse 'in' queries handling newly requested IDs.
16
- *
17
- * It balances stream connection limits with UI rendering performance by maintaining
18
- * sparse streams until a threshold is reached, at which point it automatically triggers
19
- * an `executeSmartRepack` to consolidate streams and free up websocket connections.
20
- *
21
- * It tracks component lifecycles using `DestroyRef` to gracefully tear down streams
22
- * when components are destroyed and their requested IDs become "orphaned".
23
- */
24
- export class StreamMultiplexer<T extends AnyEntity = AnyEntity> {
25
- // Maps a unique query value ID (e.g., a specific user ID) to the set of component DestroyRefs that requested it.
26
- private destroyRefsById = new Map<string, Set<DestroyRef>>();
27
-
28
- // Maps a component's DestroyRef to the set of IDs it requested. This allows us to safely clean up all of a component's
29
- // requested IDs when it is destroyed, even if it called registerIds multiple times.
30
- private idsByDestroyRef = new Map<DestroyRef, Set<string>>();
31
-
32
- // Tracks optimized batches of up to 30 IDs
33
- private batchedListeners: Array<{ ids: string[], unsubscribe: (() => void) | null }> = [];
34
-
35
- // Tracks newly added small groups of IDs that haven't been repacked yet
36
- private singleListeners: Array<{ ids: string[], unsubscribe: (() => void) | null }> = [];
37
-
38
- // Threshold for determining when a batch is "sparse" enough to warrant evaluating a repack operation.
39
- private readonly MAX_ORPHANED_IDS_PER_BATCH = 10;
40
-
41
- // Threshold for determining when we have accumulated enough single listeners to warrant repacking them into a batch.
42
- private readonly MAX_SINGLE_LISTENERS_BEFORE_REPACK = 10;
43
-
44
- constructor(
45
- private collection: string,
46
- private field: string,
47
- private db: DatabaseService,
48
- private store: { handleStreamChanges(entitiesToAdd: T[], entitiesToModify: T[], entitiesToRemove: string[]): void }, // NgRx Signal Store with handleStreamChanges
49
- ) {}
50
-
51
- /**
52
- * Checks if an ID is currently being actively streamed by any component.
53
- */
54
- isIdActive(id: string): boolean {
55
- return this.destroyRefsById.has(id) && this.destroyRefsById.get(id)!.size > 0;
56
- }
57
-
58
- /**
59
- * Registers a list of IDs to be streamed from Firestore.
60
- * Duplicate requests for the same ID are deduplicated.
61
- * Automatically handles teardown when the provided destroyRef fires.
62
- */
63
- registerIds(ids: string[], destroyRef: DestroyRef) {
64
- queryLogger.log(`[StreamMultiplexer] registerIds called with: [${Array.from(ids).join(', ')}]`);
65
- const newIds: string[] = [];
66
-
67
- // We maintain a reverse lookup from DestroyRef -> IDs to easily clean up when the component is destroyed.
68
- let idsForDestroyRef = this.idsByDestroyRef.get(destroyRef);
69
- const isFirstRegistrationForRef = !idsForDestroyRef;
70
-
71
- // Initialize the set if this is the very first time this DestroyRef is calling registerIds()
72
- if (!idsForDestroyRef) {
73
- idsForDestroyRef = new Set();
74
- this.idsByDestroyRef.set(destroyRef, idsForDestroyRef);
75
- }
76
-
77
- ids.forEach((id) => {
78
- // Add the requested ID to the component's tracking set so it can be safely cleaned up later
79
- idsForDestroyRef.add(id);
80
-
81
- // Look up if this exact ID is already being actively streamed by anyone else in the application
82
- let registeredSet = this.destroyRefsById.get(id);
83
- if (!registeredSet) {
84
- // First time this ID has been requested anywhere!
85
- // We create a new Set to track all the specific DestroyRefs that have requested it.
86
- registeredSet = new Set();
87
- this.destroyRefsById.set(id, registeredSet);
88
-
89
- // Track this as a new ID that needs to be streamed
90
- newIds.push(id);
91
- }
92
- registeredSet.add(destroyRef);
93
- });
94
-
95
- // Handle teardown when the component is destroyed
96
- if (isFirstRegistrationForRef) {
97
- destroyRef.onDestroy(() => {
98
- setTimeout(() => {
99
- let triggeredRemove = false;
100
-
101
- // Retrieve the dynamically accumulated set of IDs that were requested by this specific component's DestroyRef.
102
- // By pulling from this Map instead of a closed-over lexical variable, we ensure we clean up ALL IDs
103
- // requested across multiple calls to registerIds() by the same component.
104
- const idsToClean = this.idsByDestroyRef.get(destroyRef);
105
- if (idsToClean) {
106
- queryLogger.log(`[StreamMultiplexer] Component destroyed 5 seconds ago! Releasing its holds on IDs: [${Array.from(idsToClean).join(', ')}]`);
107
- idsToClean.forEach((id) => {
108
- const registeredSet = this.destroyRefsById.get(id);
109
- if (registeredSet && registeredSet.has(destroyRef)) {
110
- // Remove this component's claim to the ID
111
- registeredSet.delete(destroyRef);
112
-
113
- // If no other components are currently listening to this ID,
114
- // completely remove it from the globally active set.
115
- if (registeredSet.size === 0) {
116
- this.destroyRefsById.delete(id);
117
- triggeredRemove = true;
118
- }
119
- }
120
- });
121
-
122
- // Cleanup the tracking Map itself to prevent memory leaks
123
- this.idsByDestroyRef.delete(destroyRef);
124
- }
125
-
126
- if (triggeredRemove) {
127
- this.cleanupEmptyListeners();
128
- if (this.hasBatchWithTooManyOrphans()) {
129
- this.executeSmartRepack();
130
- }
131
- }
132
- }, 5000); // 5-second graceful shutdown period
133
- });
134
- }
135
-
136
- this.checkAndExecuteRepack(newIds);
137
- }
138
-
139
- /**
140
- * Evaluates whether the multiplexer should execute a repack operation.
141
- * A repack is executed if either:
142
- * 1. A new ID request pushes the projected single listener count over the MAX_SINGLE_LISTENERS_BEFORE_REPACK threshold.
143
- * 2. An orphaned batch cleanup check triggered this evaluation.
144
- *
145
- * If new IDs are requested but the threshold is not met, this method simply spins up
146
- * a single sparse stream for those IDs to prioritize immediate UI rendering speed.
147
- *
148
- * @param newIds - Array of newly requested IDs that are not yet streamed.
149
- */
150
- private checkAndExecuteRepack(newIds: string[]) {
151
- if (newIds.length > 0) {
152
- const numNewBatches = Math.ceil(newIds.length / 30);
153
- const projectedSingleListeners = this.singleListeners.length + numNewBatches;
154
-
155
- // If adding these new IDs would push us over the threshold, just execute a repack directly.
156
- // The repack logic will automatically pick up all unstreamed IDs.
157
- if (projectedSingleListeners >= this.MAX_SINGLE_LISTENERS_BEFORE_REPACK) {
158
- this.executeSmartRepack(newIds);
159
- } else {
160
- // Otherwise, spin up a new listener for the newly requested IDs
161
- const newChunks = this.chunkArray(newIds, 30);
162
- const newBatches = this.startNewBatches(newChunks, []);
163
-
164
- // We separate full batches from sparse single listeners
165
- newBatches.forEach((b) => {
166
- if (b.ids.length === 30) {
167
- this.batchedListeners.push(b);
168
- } else {
169
- this.singleListeners.push(b);
170
- }
171
- });
172
- }
173
- }
174
- }
175
-
176
- /**
177
- * Completely tears down all active streams and resets the multiplexer state.
178
- * Useful when the user logs out or the entire parent collection listener is destroyed.
179
- */
180
- teardownAll() {
181
- this.batchedListeners.forEach((b) => {
182
- if (b.unsubscribe) b.unsubscribe();
183
- });
184
- this.batchedListeners = [];
185
-
186
- this.singleListeners.forEach((s) => {
187
- if (s.unsubscribe) s.unsubscribe();
188
- });
189
- this.singleListeners = [];
190
-
191
- this.destroyRefsById.clear();
192
- this.idsByDestroyRef.clear();
193
- }
194
-
195
- /**
196
- * Identifies any listeners (both single and batched) where EVERY SINGLE ID has 0 active holds.
197
- * If an entire stream is completely abandoned, it is immediately unsubscribed and purged to prevent
198
- * dead sockets from hanging around indefinitely.
199
- */
200
- private cleanupEmptyListeners() {
201
- const activeIds = new Set(this.destroyRefsById.keys());
202
-
203
- const emptyBatches = this.batchedListeners.filter((b) => b.ids.every((id) => !activeIds.has(id)));
204
- if (emptyBatches.length > 0) {
205
- queryLogger.log(`[StreamMultiplexer] Purging ${emptyBatches.length} completely empty batched stream(s).`);
206
- emptyBatches.forEach((b) => {
207
- if (b.unsubscribe) {
208
- b.unsubscribe();
209
- b.unsubscribe = null;
210
- }
211
- });
212
- this.batchedListeners = this.batchedListeners.filter((b) => !emptyBatches.includes(b));
213
- }
214
-
215
- const emptySingles = this.singleListeners.filter((s) => s.ids.every((id) => !activeIds.has(id)));
216
- if (emptySingles.length > 0) {
217
- queryLogger.log(`[StreamMultiplexer] Purging ${emptySingles.length} completely empty single stream(s).`);
218
- emptySingles.forEach((s) => {
219
- if (s.unsubscribe) {
220
- s.unsubscribe();
221
- s.unsubscribe = null;
222
- }
223
- });
224
- this.singleListeners = this.singleListeners.filter((s) => !emptySingles.includes(s));
225
- }
226
- }
227
-
228
- /**
229
- * Checks if any of the currently active websocket listeners has too many "orphaned" IDs
230
- * (IDs that are being streamed from Firestore but are no longer requested by any component).
231
- */
232
- private hasBatchWithTooManyOrphans(): boolean {
233
- return this.batchedListeners.some((batch) => {
234
- const orphans = batch.ids.filter((id) => {
235
- const refs = this.destroyRefsById.get(id);
236
- return !refs || refs.size === 0;
237
- }).length;
238
- return orphans >= this.MAX_ORPHANED_IDS_PER_BATCH;
239
- });
240
- }
241
-
242
- /**
243
- * Consolidates sparse streams and tears down bloated batches.
244
- *
245
- * It uses a greedy mathematical algorithm to evaluate "candidate batches" (those with <= 25 active IDs)
246
- * and determine if tearing them down and bundling their active IDs with the single listeners will
247
- * result in a net reduction in the total number of websocket streams.
248
- *
249
- * Note: This method does not check threshold conditions before executing. Callers
250
- * (e.g. checkAndExecuteRepack) must verify that a repack is strictly necessary
251
- * before invoking this method.
252
- *
253
- * @param newIds - Array of newly requested IDs that need to be streamed.
254
- */
255
- private executeSmartRepack(newIds: string[] = []) {
256
- queryLogger.log(`[StreamMultiplexer] Smart Repack Triggered!`);
257
-
258
- const activeIds = new Set(this.destroyRefsById.keys());
259
-
260
- // 1. Gather all single listeners and new IDs into one pool
261
- const singleIds: string[] = [];
262
- this.singleListeners.forEach((s) => singleIds.push(...s.ids.filter((id) => activeIds.has(id))));
263
- singleIds.push(...newIds);
264
-
265
- const S = singleIds.length;
266
-
267
- // 2. Identify sparse batches (<= 25 active IDs) as candidates for mathematical reduction
268
- const candidateBatches = this.batchedListeners
269
- .map((batch) => ({
270
- batch,
271
- activeCount: batch.ids.filter((id) => activeIds.has(id)).length,
272
- }))
273
- .filter((b) => b.activeCount <= 25);
274
-
275
- // 3. Sort candidates ascending so we combine the sparsest batches first
276
- candidateBatches.sort((a, b) => a.activeCount - b.activeCount);
277
-
278
- // Baseline reduction: bundling all single listeners into tight chunks
279
- let bestReduction = S > 0 ? S - Math.ceil(S / 30) : 0;
280
- let bestT: Array<{ ids: string[], unsubscribe: (() => void) | null }> = [];
281
-
282
- let currentA = 0;
283
- const currentT: Array<{ ids: string[], unsubscribe: (() => void) | null }> = [];
284
-
285
- // 4. Greedily evaluate absorbing sparse batches to maximize stream reduction
286
- for (let i = 0; i < candidateBatches.length; i++) {
287
- currentT.push(candidateBatches[i].batch);
288
- currentA += candidateBatches[i].activeCount;
289
-
290
- const newBatchesCount = Math.ceil((S + currentA) / 30);
291
- const reduction = S + currentT.length - newBatchesCount;
292
-
293
- if (reduction > bestReduction) {
294
- bestReduction = reduction;
295
- bestT = [...currentT];
296
- }
297
- }
298
-
299
- // 5. Ensure we also forcibly tear down any bloated batches (>= 10 orphans)
300
- // even if they didn't mathematically reduce the total stream count.
301
- const bloatedBatches = this.batchedListeners.filter((batch) => {
302
- const orphans = batch.ids.filter((id) => !activeIds.has(id)).length;
303
- return orphans >= this.MAX_ORPHANED_IDS_PER_BATCH;
304
- });
305
-
306
- bloatedBatches.forEach((b) => {
307
- if (!bestT.includes(b)) {
308
- bestT.push(b);
309
- }
310
- });
311
-
312
- const batchesToTeardown = bestT;
313
- const singleListenersToTeardown = [...this.singleListeners];
314
-
315
- // 6. Collect all the actively requested IDs from the streams we are about to tear down
316
- const idsToChunk: string[] = [...singleIds];
317
- batchesToTeardown.forEach((b) => {
318
- idsToChunk.push(...b.ids.filter((id) => activeIds.has(id)));
319
- });
320
-
321
- // 7. If there's nothing left to stream, just clean up state and return
322
- if (idsToChunk.length === 0) {
323
- this.finalizeRepackState(batchesToTeardown, singleListenersToTeardown, []);
324
- return;
325
- }
326
-
327
- // 8. Break the collected IDs into optimal chunks of 30 for Firestore 'in' queries
328
- const newChunks = this.chunkArray(idsToChunk, 30);
329
-
330
- // 9. Spin up the new websocket streams, passing the old ones to be torn down only AFTER the new ones emit data
331
- const newBatches = this.startNewBatches(newChunks, [...batchesToTeardown, ...singleListenersToTeardown]);
332
-
333
- // 10. Update our internal tracking arrays to reflect the new state
334
- this.finalizeRepackState(batchesToTeardown, singleListenersToTeardown, newBatches);
335
- }
336
-
337
- /**
338
- * Opens new Firestore snapshot streams for the given chunks of IDs.
339
- *
340
- * @param newChunks - The fully chunked arrays of IDs to stream (max 30 per chunk).
341
- * @param oldBatchesToTeardown - The old websocket listeners that these new chunks are replacing.
342
- * They are only torn down *after* the new stream emits its first
343
- * payload, preventing UI flickering.
344
- */
345
- private startNewBatches(newChunks: string[][], oldBatchesToTeardown: Array<{ ids: string[], unsubscribe: (() => void) | null }>) {
346
- if (newChunks.length > 0) {
347
- queryLogger.log(`[StreamMultiplexer] Opening ${newChunks.length} new websocket stream(s) for chunks:`);
348
- newChunks.forEach((c) => queryLogger.log(` - [${c.join(', ')}]`));
349
- }
350
- const newBatches: Array<{ ids: string[], unsubscribe: (() => void) | null }> = [];
351
-
352
- newChunks.forEach((chunk) => {
353
- let isFirstEmission = true;
354
- const queryParams: QueryParams = chunk.length === 1 ?
355
- [[this.field, '==', chunk[0]]] :
356
- [[this.field, 'in', chunk]];
357
- const unsubscribeBatch = this.db.streamEntitiesChanges<T>(this.collection, queryParams, {}).subscribe((changes) => {
358
- this.patchToStore(changes, queryParams);
359
- if (isFirstEmission) {
360
- isFirstEmission = false;
361
- // Trigger teardown of old sockets that this new socket replaces
362
- this.teardownOldListeners(oldBatchesToTeardown);
363
- }
364
- });
365
- newBatches.push({ ids: chunk, unsubscribe: () => unsubscribeBatch.unsubscribe() });
366
- });
367
- return newBatches;
368
- }
369
-
370
- /**
371
- * Unsubscribes from the old listener sockets to clean up the network connections.
372
- */
373
- private teardownOldListeners(oldBatches: Array<{ ids: string[], unsubscribe: (() => void) | null }>) {
374
- if (oldBatches.length > 0) {
375
- queryLogger.log(`[StreamMultiplexer] Tearing down ${oldBatches.length} old websocket stream(s).`);
376
- oldBatches.forEach((b) => {
377
- queryLogger.log(` - [${b.ids.join(', ')}]`);
378
- if (b.unsubscribe) {
379
- b.unsubscribe();
380
- b.unsubscribe = null;
381
- }
382
- });
383
- }
384
- }
385
-
386
- /**
387
- * Cleans up the multiplexer state arrays by removing the objects for the torn down streams
388
- * and pushing the newly created streams into the correct `batchedListeners` or `singleListeners` array.
389
- */
390
- private finalizeRepackState(
391
- oldBatchesToTeardown: Array<{ ids: string[], unsubscribe: (() => void) | null }>,
392
- oldSingleListenersToTeardown: Array<{ ids: string[], unsubscribe: (() => void) | null }>,
393
- newBatches: Array<{ ids: string[], unsubscribe: (() => void) | null }>,
394
- ) {
395
- this.batchedListeners = this.batchedListeners.filter((b) => !oldBatchesToTeardown.includes(b));
396
- this.singleListeners = this.singleListeners.filter((s) => !oldSingleListenersToTeardown.includes(s));
397
-
398
- newBatches.forEach((b) => {
399
- if (b.ids.length === 30) {
400
- this.batchedListeners.push(b);
401
- } else {
402
- this.singleListeners.push(b);
403
- }
404
- });
405
- }
406
-
407
- /**
408
- * Utility to split an array of IDs into smaller chunks (max 30 for Firestore 'in' queries).
409
- */
410
- private chunkArray(array: string[], size: number): string[][] {
411
- return Array.from({ length: Math.ceil(array.length / size) }, (v, i) => array.slice(i * size, i * size + size));
412
- }
413
-
414
- /**
415
- * Takes the raw DocumentChange payload from Firestore and formats it into
416
- * added/modified/removed arrays that the NgRx Signal Store can easily process.
417
- */
418
- private patchToStore(fbPayload: Array<{ type: string, docData: T }>, queryParams: QueryParams) {
419
- const entitiesToAdd = fbPayload
420
- .filter((dc) => dc.type === 'added' && !dc.docData['_deleted'])
421
- .map((dc) => dc.docData);
422
-
423
- const entitiesToModify = fbPayload
424
- .filter((dc) => dc.type === 'modified' && !dc.docData['_deleted'])
425
- .map((dc) => dc.docData);
426
-
427
- const entitiesToRemove = fbPayload
428
- .filter((dc) => dc.type === 'modified' && dc.docData['_deleted'])
429
- .map((dc) => dc.docData['__id']);
430
-
431
- const entitiesToModify2 = fbPayload
432
- .filter((dc) => dc.type === 'removed' && !entityInQueryResults(dc.docData, queryParams, {}))
433
- .map((dc) => dc.docData);
434
-
435
- const entitiesToRemove2 = fbPayload
436
- .filter((dc) => dc.type === 'removed' && entityInQueryResults(dc.docData, queryParams, {}))
437
- .map((dc) => dc.docData['__id']);
438
-
439
- this.store.handleStreamChanges(
440
- entitiesToAdd,
441
- [...entitiesToModify, ...entitiesToModify2],
442
- [...entitiesToRemove, ...entitiesToRemove2],
443
- );
444
- }
445
- }
@@ -1,118 +0,0 @@
1
- import { TestBed } from '@angular/core/testing';
2
- import { LoggingService, getLogger } from './logging.service';
3
-
4
- describe('LoggingService', () => {
5
- let service: LoggingService;
6
- let consoleLogSpy: jest.SpyInstance;
7
- let consoleWarnSpy: jest.SpyInstance;
8
- let consoleErrorSpy: jest.SpyInstance;
9
-
10
- beforeEach(() => {
11
- localStorage.clear();
12
- consoleLogSpy = jest.spyOn(console, 'log').mockImplementation(() => {});
13
- consoleWarnSpy = jest.spyOn(console, 'warn').mockImplementation(() => {});
14
- consoleErrorSpy = jest.spyOn(console, 'error').mockImplementation(() => {});
15
-
16
- TestBed.configureTestingModule({
17
- providers: [LoggingService],
18
- });
19
- service = TestBed.inject(LoggingService);
20
- });
21
-
22
- afterEach(() => {
23
- jest.restoreAllMocks();
24
- localStorage.clear();
25
- if (typeof window !== 'undefined') {
26
- delete (window as any).debugLogger;
27
- }
28
- });
29
-
30
- it('should be created with logging disabled by default', () => {
31
- expect(service).toBeTruthy();
32
- expect(service.isEnabled()).toBe(false);
33
- });
34
-
35
- it('should register debugLogger on the window object', () => {
36
- expect((window as any).debugLogger).toBe(service);
37
- });
38
-
39
- it('should enable logging and persist it to localStorage', () => {
40
- service.enable();
41
- expect(service.isEnabled()).toBe(true);
42
- expect(localStorage.getItem('debug_logs')).toBe('true');
43
- });
44
-
45
- it('should disable logging and remove it from localStorage', () => {
46
- service.enable();
47
- service.disable();
48
- expect(service.isEnabled()).toBe(false);
49
- expect(localStorage.getItem('debug_logs')).toBeNull();
50
- });
51
-
52
- it('should toggle logging state correctly', () => {
53
- service.toggle();
54
- expect(service.isEnabled()).toBe(true);
55
- service.toggle();
56
- expect(service.isEnabled()).toBe(false);
57
- });
58
-
59
- it('should initialize state from localStorage if present', () => {
60
- localStorage.setItem('debug_logs', 'true');
61
- // Re-create the service to test constructor initialization
62
- const newService = new LoggingService();
63
- expect(newService.isEnabled()).toBe(true);
64
- });
65
-
66
- it('should not log to console if disabled', () => {
67
- service.log('test log');
68
- service.warn('test warn');
69
- service.error('test error');
70
-
71
- expect(consoleLogSpy).not.toHaveBeenCalled();
72
- expect(consoleWarnSpy).not.toHaveBeenCalled();
73
- expect(consoleErrorSpy).not.toHaveBeenCalled();
74
- });
75
-
76
- it('should log to console if enabled', () => {
77
- service.enable();
78
- service.log('test log', { foo: 'bar' });
79
- service.warn('test warn');
80
- service.error('test error');
81
-
82
- expect(consoleLogSpy).toHaveBeenCalledWith('test log', { foo: 'bar' });
83
- expect(consoleWarnSpy).toHaveBeenCalledWith('test warn');
84
- expect(consoleErrorSpy).toHaveBeenCalledWith('test error');
85
- });
86
-
87
- it('should support scoped loggers with namespaces', () => {
88
- const queryLogger = getLogger('query');
89
- const storeLogger = getLogger('store');
90
-
91
- // 1. When disabled
92
- queryLogger.log('query log');
93
- expect(consoleLogSpy).not.toHaveBeenCalled();
94
-
95
- // 2. Enabled generally (all namespaces)
96
- service.enable('true');
97
- queryLogger.log('query log');
98
- storeLogger.log('store log');
99
- expect(consoleLogSpy).toHaveBeenCalledWith('query log');
100
- expect(consoleLogSpy).toHaveBeenCalledWith('store log');
101
- consoleLogSpy.mockClear();
102
-
103
- // 3. Enabled only for 'query'
104
- service.enable('query');
105
- queryLogger.log('query log');
106
- storeLogger.log('store log');
107
- expect(consoleLogSpy).toHaveBeenCalledWith('query log');
108
- expect(consoleLogSpy).not.toHaveBeenCalledWith('store log');
109
- consoleLogSpy.mockClear();
110
-
111
- // 4. Enabled for multiple specific namespaces
112
- service.enable('query,store');
113
- queryLogger.log('query log');
114
- storeLogger.log('store log');
115
- expect(consoleLogSpy).toHaveBeenCalledWith('query log');
116
- expect(consoleLogSpy).toHaveBeenCalledWith('store log');
117
- });
118
- });