@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
@@ -0,0 +1,518 @@
1
+ /**
2
+ * Analytics Snapshot Refresh Script
3
+ *
4
+ * Builds a new offline SQLite snapshot database by pulling data from BigQuery
5
+ * and Firestore datasets. Dynamically creates strict SQLite tables, validates
6
+ * types, and records provenance metadata. Uses an atomic write to update the
7
+ * active snapshot pointer (`current.json`).
8
+ *
9
+ * Usage:
10
+ * npm run analytics:refresh
11
+ * node analytics/scripts/refresh_snapshot.js --format json
12
+ */
13
+
14
+ import 'dotenv/config';
15
+ import { BigQuery } from '@google-cloud/bigquery';
16
+ import { applicationDefault, cert, initializeApp } from 'firebase-admin/app';
17
+ import { getFirestore } from 'firebase-admin/firestore';
18
+ import { createHash, randomUUID } from 'node:crypto';
19
+ import { execFileSync } from 'node:child_process';
20
+ import fs from 'node:fs';
21
+ import path from 'node:path';
22
+ import { fileURLToPath } from 'node:url';
23
+ import sqlite3 from 'sqlite3';
24
+ import { datasets } from '../datasets.js';
25
+ import { entityDatasetDefinitions } from '../entity_sources.js';
26
+ import { uploadEntityTable } from '../lib/upload_entities.js';
27
+ import {
28
+ createTableSql,
29
+ quoteIdentifier,
30
+ } from '../lib/dataset_schema.js';
31
+ import { syncEntityDataset } from '../lib/entity_sync.js';
32
+ import { resolveIdentifierSalt } from '../lib/identifier_salt.js';
33
+ import { closeDatabase, exec, get, openDatabase, run } from '../lib/sqlite.js';
34
+ import {
35
+ cleanupFailedSnapshot,
36
+ publishSnapshot,
37
+ } from '../lib/snapshot_files.js';
38
+
39
+ const scriptDirectory = path.dirname(fileURLToPath(import.meta.url));
40
+ const repoRoot = path.resolve(scriptDirectory, '..', '..');
41
+ const applicationProjectId =
42
+ argument('--entity-project') || '<%= dasherize(project) %>';
43
+
44
+
45
+ function argument(flag) {
46
+ const index = process.argv.indexOf(flag);
47
+ return index === -1 ? null : process.argv[index + 1];
48
+ }
49
+
50
+
51
+ function snapshotId() {
52
+ return `${new Date().toISOString().replace(/[:.]/g, '-')}-${randomUUID().slice(0, 8)}`;
53
+ }
54
+
55
+ // Unwraps BigQuery field objects into raw primitive values
56
+ function unwrapBigQueryValue(value) {
57
+ if (
58
+ value &&
59
+ typeof value === 'object' &&
60
+ Object.prototype.hasOwnProperty.call(value, 'value')
61
+ ) {
62
+ return value.value;
63
+ }
64
+ return value;
65
+ }
66
+
67
+ /**
68
+ * @param {any} value
69
+ * @param {object} column
70
+ * @param {string} datasetId
71
+ */
72
+ function normalizeValue(value, column, datasetId) {
73
+ const unwrapped = unwrapBigQueryValue(value);
74
+ if (unwrapped === null || unwrapped === undefined) {
75
+ if (column.primaryKey) {
76
+ throw new Error(`${datasetId}.${column.name} is a primary key but received NULL`);
77
+ }
78
+ return null;
79
+ }
80
+
81
+ if (column.type === 'TEXT') return String(unwrapped);
82
+
83
+ const numeric = Number(unwrapped);
84
+ if (!Number.isFinite(numeric)) {
85
+ throw new Error(`${datasetId}.${column.name} expected ${column.type}, received ${unwrapped}`);
86
+ }
87
+ if (column.type === 'INTEGER' && !Number.isInteger(numeric)) {
88
+ throw new Error(`${datasetId}.${column.name} expected INTEGER, received ${unwrapped}`);
89
+ }
90
+ return numeric;
91
+ }
92
+
93
+
94
+ function csvCell(value) {
95
+ if (value === null || value === undefined) return '';
96
+ const stringValue = String(value);
97
+ return `"${stringValue.replace(/"/g, '""')}"`;
98
+ }
99
+
100
+
101
+ function writeOptionalExport(format, exportDirectory, dataset, rows) {
102
+ if (!format) return;
103
+ fs.mkdirSync(exportDirectory, { recursive: true });
104
+ if (format === 'json') {
105
+ fs.writeFileSync(
106
+ path.join(exportDirectory, `${dataset.id}.json`),
107
+ `${JSON.stringify(rows, null, 2)}\n`,
108
+ 'utf8',
109
+ );
110
+ return;
111
+ }
112
+ if (format === 'csv') {
113
+ const headers = dataset.columns.map((column) => column.name);
114
+ const lines = [
115
+ headers.join(','),
116
+ ...rows.map((row) => headers.map((header) => csvCell(row[header])).join(',')),
117
+ ];
118
+ fs.writeFileSync(
119
+ path.join(exportDirectory, `${dataset.id}.csv`),
120
+ `${lines.join('\n')}\n`,
121
+ 'utf8',
122
+ );
123
+ return;
124
+ }
125
+ throw new Error(`Unsupported --format "${format}". Use csv or json.`);
126
+ }
127
+
128
+
129
+ async function loadDataset(bigquery, dataset, idSalt, excludeAdmin = false) {
130
+ const queryPath = path.join(repoRoot, dataset.sourceQuery);
131
+ const query = fs.readFileSync(queryPath, 'utf8');
132
+ const options = { query };
133
+ if (dataset.adminVariants) {
134
+ options.params = { idSalt, excludeAdmin };
135
+ } else if (dataset.requiresIdSalt) {
136
+ options.params = { idSalt };
137
+ }
138
+
139
+ const startedAt = Date.now();
140
+ const [sourceRows] = await bigquery.query(options);
141
+ const rows = sourceRows.map((sourceRow) => Object.fromEntries(
142
+ dataset.columns.map((column) => {
143
+ if (dataset.adminVariants && column.name === '_includes_admin') {
144
+ return [column.name, null];
145
+ }
146
+ return [
147
+ column.name,
148
+ normalizeValue(sourceRow[column.name], column, dataset.id),
149
+ ];
150
+ }),
151
+ ));
152
+ return {
153
+ rows,
154
+ query,
155
+ durationMs: Date.now() - startedAt,
156
+ };
157
+ }
158
+
159
+
160
+ async function loadEntityDataset(
161
+ firestore,
162
+ cacheDb,
163
+ dataset,
164
+ idSalt,
165
+ forceRebuild,
166
+ ) {
167
+ const definition = entityDatasetDefinitions.get(dataset.entitySource);
168
+ if (!definition) {
169
+ throw new Error(
170
+ `${dataset.id} references unknown entity source "${dataset.entitySource}"`,
171
+ );
172
+ }
173
+ const sourcePath = path.join(repoRoot, 'analytics', 'entity_sources.js');
174
+ const sourceCode = fs.readFileSync(sourcePath, 'utf8');
175
+ const startedAt = Date.now();
176
+ const rows = await syncEntityDataset({
177
+ firestore,
178
+ cacheDb,
179
+ datasetId: dataset.id,
180
+ definition,
181
+ idSalt,
182
+ forceRebuild,
183
+ });
184
+ const normalizedRows = rows.map((sourceRow) => Object.fromEntries(
185
+ dataset.columns.map((column) => [
186
+ column.name,
187
+ normalizeValue(sourceRow[column.name], column, dataset.id),
188
+ ]),
189
+ ));
190
+ return {
191
+ rows: normalizedRows,
192
+ query: [
193
+ `firestore:${dataset.entitySource}`,
194
+ `analysis-version:${definition.analysisVersion}`,
195
+ createHash('sha256').update(sourceCode).digest('hex'),
196
+ ].join('\n'),
197
+ sourceDescription: `analytics/entity_sources.js#${dataset.entitySource}`,
198
+ durationMs: Date.now() - startedAt,
199
+ };
200
+ }
201
+
202
+
203
+ async function initializeAnalyticsViews(bigquery) {
204
+ const viewPaths = [
205
+ path.join(repoRoot, 'bigquery', 'views', 'logs_latest.sql'),
206
+ path.join(repoRoot, 'bigquery', 'views', 'events_flat.sql'),
207
+ ];
208
+ for (const viewPath of viewPaths) {
209
+ const query = fs.readFileSync(viewPath, 'utf8');
210
+ await bigquery.query({ query });
211
+ }
212
+ }
213
+
214
+
215
+ async function warnIfTelemetryExportIsEmpty(bigquery) {
216
+ const [rows] = await bigquery.query({
217
+ query: `
218
+ SELECT COUNT(*) AS raw_rows
219
+ FROM \`analytics.logs_raw_changelog\`
220
+ `,
221
+ });
222
+ const rawRows = Number(rows[0]?.raw_rows?.value ?? rows[0]?.raw_rows ?? 0);
223
+ if (rawRows === 0) {
224
+ console.warn(
225
+ 'No telemetry rows have reached BigQuery yet. If the export extension ' +
226
+ 'was just installed, existing Firestore logs require the one-time ' +
227
+ '@firebaseextensions/fs-bq-import-collection backfill.',
228
+ );
229
+ }
230
+ }
231
+
232
+
233
+ function initializeEntityFirestore(keyFilename) {
234
+ const credential = keyFilename ?
235
+ cert(JSON.parse(fs.readFileSync(keyFilename, 'utf8'))) :
236
+ applicationDefault();
237
+ const app = initializeApp(
238
+ { credential, projectId: applicationProjectId },
239
+ `analytics-entity-sync-${Date.now()}`,
240
+ );
241
+ return getFirestore(app);
242
+ }
243
+
244
+
245
+ async function insertDataset(db, dataset, rows) {
246
+ await exec(db, createTableSql(dataset));
247
+ if (rows.length) {
248
+ const columnNames = dataset.columns.map((column) => column.name);
249
+ const insertSql = [
250
+ `INSERT INTO ${quoteIdentifier(dataset.table)}`,
251
+ `(${columnNames.map(quoteIdentifier).join(', ')})`,
252
+ `VALUES (${columnNames.map(() => '?').join(', ')})`,
253
+ ].join(' ');
254
+ await exec(db, 'BEGIN IMMEDIATE');
255
+ try {
256
+ for (const row of rows) {
257
+ await run(db, insertSql, columnNames.map((columnName) => row[columnName]));
258
+ }
259
+ await exec(db, 'COMMIT');
260
+ } catch (error) {
261
+ await exec(db, 'ROLLBACK');
262
+ throw error;
263
+ }
264
+ }
265
+
266
+ for (const [index, columns] of dataset.indexes.entries()) {
267
+ const indexName = `idx_${dataset.table}_${index + 1}`;
268
+ await exec(
269
+ db,
270
+ `CREATE INDEX ${quoteIdentifier(indexName)} ON ${quoteIdentifier(dataset.table)} ` +
271
+ `(${columns.map(quoteIdentifier).join(', ')})`,
272
+ );
273
+ }
274
+ }
275
+
276
+
277
+ async function main() {
278
+ const projectId = argument('--project') || '<%= dasherize(project) %>-logs';
279
+ const keyFilename = argument('--credentials');
280
+ const entityKeyFilename =
281
+ argument('--entity-credentials') ||
282
+ process.env.ANALYTICS_ENTITY_CREDENTIALS;
283
+ const format = argument('--format');
284
+ const localRoot = path.join(repoRoot, '.local', 'analytics');
285
+ const identifierSalt = resolveIdentifierSalt(localRoot, process.env.ANALYTICS_ID_SALT);
286
+ const rebuildEntityCache =
287
+ process.env.ANALYTICS_REBUILD_ENTITY_CACHE === '1' ||
288
+ process.argv.includes('--rebuild-entity-cache');
289
+ const idSalt = identifierSalt.value;
290
+ const snapshotsDirectory = path.join(localRoot, 'snapshots');
291
+ const id = snapshotId();
292
+ const buildingPath = path.join(snapshotsDirectory, `${id}.building`);
293
+ const snapshotPath = path.join(snapshotsDirectory, `${id}.sqlite`);
294
+ const exportsDirectory = path.join(localRoot, 'exports', id);
295
+ const pointerPath = path.join(localRoot, 'current.json');
296
+ const pointerBuildingPath = `${pointerPath}.building`;
297
+ fs.mkdirSync(snapshotsDirectory, { recursive: true });
298
+ if (identifierSalt.generated) {
299
+ console.log('Generated a private local identifier salt for stable pseudonymous keys.');
300
+ }
301
+
302
+ const bigquery = new BigQuery({
303
+ projectId,
304
+ ...(keyFilename ? { keyFilename } : {}),
305
+ });
306
+ const hasEntityDatasets = datasets.some((dataset) => dataset.entitySource);
307
+ const firestore = hasEntityDatasets ?
308
+ initializeEntityFirestore(entityKeyFilename) :
309
+ null;
310
+ const entityCachePath = path.join(localRoot, 'entity-cache.sqlite');
311
+ let db;
312
+ let entityCacheDb;
313
+
314
+ try {
315
+ process.stdout.write('Updating analytics views... ');
316
+ await initializeAnalyticsViews(bigquery);
317
+ console.log('done');
318
+ await warnIfTelemetryExportIsEmpty(bigquery);
319
+
320
+ db = await openDatabase(
321
+ buildingPath,
322
+ sqlite3.OPEN_READWRITE | sqlite3.OPEN_CREATE | sqlite3.OPEN_FULLMUTEX,
323
+ );
324
+ await exec(db, `
325
+ PRAGMA foreign_keys = ON;
326
+ PRAGMA journal_mode = DELETE;
327
+ CREATE TABLE meta_snapshot (
328
+ snapshot_id TEXT PRIMARY KEY NOT NULL,
329
+ created_at TEXT NOT NULL,
330
+ source_project TEXT NOT NULL,
331
+ git_sha TEXT NOT NULL,
332
+ schema_version INTEGER NOT NULL,
333
+ query_bundle_hash TEXT NOT NULL
334
+ ) STRICT;
335
+ CREATE TABLE meta_dataset (
336
+ dataset_id TEXT PRIMARY KEY NOT NULL,
337
+ source_query TEXT NOT NULL,
338
+ query_hash TEXT NOT NULL,
339
+ grain TEXT NOT NULL,
340
+ privacy TEXT NOT NULL,
341
+ row_count INTEGER NOT NULL,
342
+ refresh_duration_ms INTEGER NOT NULL
343
+ ) STRICT;
344
+ `);
345
+
346
+ const bundleHash = createHash('sha256');
347
+ const datasetResults = [];
348
+
349
+ const selectedDatasets = datasets;
350
+
351
+ if (hasEntityDatasets && !entityCacheDb) {
352
+ entityCacheDb = await openDatabase(
353
+ entityCachePath,
354
+ sqlite3.OPEN_READWRITE | sqlite3.OPEN_CREATE | sqlite3.OPEN_FULLMUTEX,
355
+ );
356
+ }
357
+
358
+ // Phase 1: Entity sync + upload
359
+ const entityDatasets = selectedDatasets.filter((dataset) => dataset.entitySource);
360
+ const entityDatasetResults = {};
361
+ for (const dataset of entityDatasets) {
362
+ process.stdout.write(`Syncing ${dataset.id}... `);
363
+ const result = await loadEntityDataset(
364
+ firestore,
365
+ entityCacheDb,
366
+ dataset,
367
+ idSalt,
368
+ rebuildEntityCache,
369
+ );
370
+ entityDatasetResults[dataset.id] = result;
371
+ console.log(`${result.rows.length} rows`);
372
+
373
+ if (dataset.uploadToBigQuery) {
374
+ process.stdout.write(`Uploading ${dataset.id} to BigQuery... `);
375
+ await uploadEntityTable({
376
+ bigquery,
377
+ datasetId: 'analytics',
378
+ tableName: dataset.table,
379
+ columns: dataset.columns,
380
+ rows: result.rows,
381
+ });
382
+ console.log('done');
383
+ }
384
+ }
385
+
386
+ // Phase 2: BigQuery queries (dual-variant)
387
+ const bqDatasets = selectedDatasets.filter((dataset) => dataset.sourceQuery);
388
+ for (const dataset of bqDatasets) {
389
+ process.stdout.write(`Refreshing ${dataset.id}... `);
390
+ let result;
391
+ if (dataset.adminVariants) {
392
+ const pass1 = await loadDataset(bigquery, dataset, idSalt, false);
393
+ const pass2 = await loadDataset(bigquery, dataset, idSalt, true);
394
+
395
+ const rows1 = pass1.rows.map((row) => ({ ...row, _includes_admin: 1 }));
396
+ const rows2 = pass2.rows.map((row) => ({ ...row, _includes_admin: 0 }));
397
+
398
+ result = {
399
+ rows: [...rows1, ...rows2],
400
+ query: pass1.query,
401
+ durationMs: pass1.durationMs + pass2.durationMs,
402
+ };
403
+ } else {
404
+ result = await loadDataset(bigquery, dataset, idSalt);
405
+ }
406
+
407
+ await insertDataset(db, dataset, result.rows);
408
+ writeOptionalExport(format, exportsDirectory, dataset, result.rows);
409
+
410
+ const queryHash = createHash('sha256').update(result.query).digest('hex');
411
+ bundleHash.update(dataset.id).update(queryHash);
412
+
413
+ await run(
414
+ db,
415
+ `INSERT INTO meta_dataset (
416
+ dataset_id, source_query, query_hash, grain, privacy, row_count, refresh_duration_ms
417
+ ) VALUES (?, ?, ?, ?, ?, ?, ?)`,
418
+ [
419
+ dataset.id,
420
+ dataset.sourceQuery,
421
+ queryHash,
422
+ dataset.grain,
423
+ dataset.privacy,
424
+ result.rows.length,
425
+ result.durationMs,
426
+ ],
427
+ );
428
+ datasetResults.push({ id: dataset.id, rows: result.rows.length });
429
+ console.log(`${result.rows.length} rows`);
430
+ }
431
+
432
+ // Phase 3: Entity datasets (from cache to snapshot)
433
+ for (const dataset of entityDatasets) {
434
+ const result = entityDatasetResults[dataset.id];
435
+ process.stdout.write(`Inserting ${dataset.id} to snapshot... `);
436
+ await insertDataset(db, dataset, result.rows);
437
+ writeOptionalExport(format, exportsDirectory, dataset, result.rows);
438
+
439
+ const queryHash = createHash('sha256').update(result.query).digest('hex');
440
+ bundleHash.update(dataset.id).update(queryHash);
441
+
442
+ await run(
443
+ db,
444
+ `INSERT INTO meta_dataset (
445
+ dataset_id, source_query, query_hash, grain, privacy, row_count, refresh_duration_ms
446
+ ) VALUES (?, ?, ?, ?, ?, ?, ?)`,
447
+ [
448
+ dataset.id,
449
+ result.sourceDescription || dataset.sourceQuery,
450
+ queryHash,
451
+ dataset.grain,
452
+ dataset.privacy,
453
+ result.rows.length,
454
+ result.durationMs,
455
+ ],
456
+ );
457
+ datasetResults.push({ id: dataset.id, rows: result.rows.length });
458
+ console.log(`${result.rows.length} rows`);
459
+ }
460
+
461
+ let gitSha = 'unknown';
462
+ try {
463
+ gitSha = execFileSync('git', ['rev-parse', 'HEAD'], {
464
+ cwd: repoRoot,
465
+ encoding: 'utf8',
466
+ }).trim();
467
+ } catch {
468
+ // Provenance remains useful without requiring the directory to be a Git checkout.
469
+ }
470
+
471
+ const createdAt = new Date().toISOString();
472
+ await run(
473
+ db,
474
+ `INSERT INTO meta_snapshot (
475
+ snapshot_id, created_at, source_project, git_sha, schema_version, query_bundle_hash
476
+ ) VALUES (?, ?, ?, ?, ?, ?)`,
477
+ [id, createdAt, projectId, gitSha, 1, bundleHash.digest('hex')],
478
+ );
479
+
480
+ const integrity = await get(db, 'PRAGMA integrity_check');
481
+ if (!integrity || integrity.integrity_check !== 'ok') {
482
+ throw new Error(`SQLite integrity check failed: ${JSON.stringify(integrity)}`);
483
+ }
484
+ await closeDatabase(db);
485
+ db = null;
486
+ await closeDatabase(entityCacheDb);
487
+ entityCacheDb = null;
488
+
489
+ fs.mkdirSync(localRoot, { recursive: true });
490
+ publishSnapshot({
491
+ buildingPath,
492
+ snapshotPath,
493
+ pointerBuildingPath,
494
+ pointerPath,
495
+ pointer: {
496
+ snapshotId: id,
497
+ path: path.relative(localRoot, snapshotPath),
498
+ createdAt,
499
+ datasets: datasetResults,
500
+ },
501
+ });
502
+
503
+ console.log(`Snapshot ready: ${path.relative(repoRoot, snapshotPath)}`);
504
+ if (format) {
505
+ console.log(`${format.toUpperCase()} exports: ${path.relative(repoRoot, exportsDirectory)}`);
506
+ }
507
+ } catch (error) {
508
+ await closeDatabase(db).catch(() => undefined);
509
+ await closeDatabase(entityCacheDb).catch(() => undefined);
510
+ cleanupFailedSnapshot({ buildingPath, pointerBuildingPath });
511
+ throw error;
512
+ }
513
+ }
514
+
515
+ main().catch((error) => {
516
+ console.error(`Analytics refresh failed: ${error.message}`);
517
+ process.exitCode = 1;
518
+ });
@@ -0,0 +1,88 @@
1
+ /**
2
+ * Analytics Service Launcher
3
+ *
4
+ * Launches both analytics background services concurrently:
5
+ * 1. Backend Data Proxy (`analytics/server/server.js`)
6
+ * 2. Frontend UI Dev Server (`npm run analytics:serve`)
7
+ *
8
+ * Propagates SIGINT/SIGTERM to child processes to prevent
9
+ * rogue background processes from lingering.
10
+ */
11
+
12
+ import { spawn } from 'node:child_process';
13
+ import net from 'node:net';
14
+
15
+ const API_PORT = 4321;
16
+ const UI_PORT = 4320;
17
+ const appName = '<%= classify(project) %>';
18
+ const children = [];
19
+
20
+ let stopping = false;
21
+
22
+ /**
23
+ * @param {number} port
24
+ * @returns {Promise<boolean>}
25
+ */
26
+ function portAvailable(port) {
27
+ return new Promise((resolve) => {
28
+ const probe = net.createServer();
29
+ probe.unref();
30
+ probe.once('error', () => resolve(false));
31
+ probe.listen(port, '127.0.0.1', () => {
32
+ probe.close(() => resolve(true));
33
+ });
34
+ });
35
+ }
36
+
37
+
38
+ async function start() {
39
+ for (const [label, port] of [
40
+ ['data service', API_PORT],
41
+ ['workbench', UI_PORT],
42
+ ]) {
43
+ if (!await portAvailable(port)) {
44
+ console.error(
45
+ `${appName} analytics ${label} port ${port} is already in use. ` +
46
+ 'If the workbench is already running, open it instead; otherwise stop ' +
47
+ 'the previous analytics process and try again.',
48
+ );
49
+ process.exitCode = 1;
50
+ return;
51
+ }
52
+ }
53
+
54
+ children.push(
55
+ spawn(process.execPath, ['analytics/server/server.js'], { stdio: 'inherit' }),
56
+ spawn('npm', ['run', 'analytics:serve'], { stdio: 'inherit' }),
57
+ );
58
+
59
+ for (const child of children) {
60
+ child.on('exit', (code, signal) => {
61
+ if (stopping) return;
62
+ if (code !== 0) {
63
+ console.error(`Analytics process exited unexpectedly (${signal || code}).`);
64
+ }
65
+ stop(code || 0);
66
+ });
67
+ }
68
+
69
+ console.log(`${appName} analytics workbench will open at http://127.0.0.1:${UI_PORT}`);
70
+ }
71
+
72
+ /**
73
+ * @param {number} exitCode
74
+ */
75
+ function stop(exitCode = 0) {
76
+ if (stopping) return;
77
+ stopping = true;
78
+ for (const child of children) {
79
+ if (!child.killed) child.kill('SIGTERM');
80
+ }
81
+ process.exitCode = exitCode;
82
+ }
83
+
84
+ // Trap termination signals (Ctrl+C / kill)
85
+ process.on('SIGINT', () => stop());
86
+ process.on('SIGTERM', () => stop());
87
+
88
+ void start();