@tech4good/angular-schematics 20.3.1 → 21.1.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 (146) hide show
  1. package/.agents/skills/publish-npm/SKILL.md +1 -1
  2. package/.agents/skills/publish-npm/eval.yaml +15 -0
  3. package/.agents/skills/publish-npm/fixtures/package-v21.json.template +8 -0
  4. package/.t4g/agent-memory.db +0 -0
  5. package/CHANGELOG.md +71 -0
  6. package/contributing-docs/commit-message.md +3 -6
  7. package/package.json +5 -5
  8. package/src/collection.json +8 -0
  9. package/src/component/files/__name@dasherize__/__name@dasherize__.component.ts.template +1 -3
  10. package/src/component/index_spec.js +57 -4
  11. package/src/component/index_spec.js.map +1 -1
  12. package/src/entity/files/__name@dasherize__/__name@dasherize__.mock.ts.template +15 -1
  13. package/src/entity/index.js +7 -1
  14. package/src/entity/index.js.map +1 -1
  15. package/src/entity/index_spec.js +108 -4
  16. package/src/entity/index_spec.js.map +1 -1
  17. package/src/guard/files/__name@dasherize__.guard.spec.ts.template +45 -0
  18. package/src/guard/files/__name@dasherize__.guard.ts.template +32 -0
  19. package/src/guard/index.d.ts +2 -0
  20. package/src/guard/index.js +38 -0
  21. package/src/guard/index.js.map +1 -0
  22. package/src/guard/index_spec.d.ts +1 -0
  23. package/src/guard/index_spec.js +64 -0
  24. package/src/guard/index_spec.js.map +1 -0
  25. package/src/guard/schema.json +46 -0
  26. package/src/ng-add/files/.firebaserc.template +3 -2
  27. package/src/ng-add/files/.github/workflows/angular-github-ci.yml.template +105 -39
  28. package/src/ng-add/files/.gitignore.template +1 -2
  29. package/src/ng-add/files/angular.json.template +1 -5
  30. package/src/ng-add/files/docs-infra/infrastructure-guide.md.template +390 -0
  31. package/src/ng-add/files/docs-infra/load-system-architecture.md.template +166 -0
  32. package/src/ng-add/files/docs-infra/querying-strategy.md.template +157 -0
  33. package/src/ng-add/files/docs-infra/stream-system-architecture.md.template +283 -0
  34. package/src/ng-add/files/eslint.config.js.template +4 -1
  35. package/src/ng-add/files/firebase.json.template +37 -0
  36. package/src/ng-add/files/firestore.rules.spec.ts.template +221 -0
  37. package/src/ng-add/files/firestore.rules.template +67 -0
  38. package/src/ng-add/files/jest.config.ts.template +6 -1
  39. package/src/ng-add/files/package.json.template +41 -31
  40. package/src/ng-add/files/setup-jest.ts.template +13 -5
  41. package/src/ng-add/files/src/app/admin/admin-panel/admin-panel.component.spec.ts.template +76 -12
  42. package/src/ng-add/files/src/app/admin/admin-panel/admin-panel.component.ts.template +1 -3
  43. package/src/ng-add/files/src/app/admin/admin-panel/admin-settings/admin-settings.component.spec.ts.template +90 -0
  44. package/src/ng-add/files/src/app/admin/admin-panel/admin-settings/admin-settings.component.ts.template +1 -1
  45. package/src/ng-add/files/src/app/admin/admin-panel/admin-user-list/admin-user-counts/admin-count-pill/admin-count-pill.component.spec.ts.template +12 -17
  46. package/src/ng-add/files/src/app/admin/admin-panel/admin-user-list/admin-user-counts/admin-count-pill/admin-count-pill.component.ts.template +2 -4
  47. package/src/ng-add/files/src/app/admin/admin-panel/admin-user-list/admin-user-counts/admin-user-counts.component.spec.ts.template +40 -19
  48. package/src/ng-add/files/src/app/admin/admin-panel/admin-user-list/admin-user-counts/admin-user-counts.component.ts.template +3 -5
  49. package/src/ng-add/files/src/app/admin/admin-panel/admin-user-list/admin-user-list.component.html.template +2 -2
  50. package/src/ng-add/files/src/app/admin/admin-panel/admin-user-list/admin-user-list.component.spec.ts.template +108 -0
  51. package/src/ng-add/files/src/app/admin/admin-panel/admin-user-list/admin-user-list.component.ts.template +11 -11
  52. package/src/ng-add/files/src/app/admin/admin-panel/admin-user-list/admin-user-table/admin-user-table.component.html.template +6 -2
  53. package/src/ng-add/files/src/app/admin/admin-panel/admin-user-list/admin-user-table/admin-user-table.component.spec.ts.template +136 -19
  54. package/src/ng-add/files/src/app/admin/admin-panel/admin-user-list/admin-user-table/admin-user-table.component.ts.template +8 -5
  55. package/src/ng-add/files/src/app/app.component.html.template +1 -1
  56. package/src/ng-add/files/src/app/app.component.scss.template +10 -0
  57. package/src/ng-add/files/src/app/app.component.ts.template +1 -1
  58. package/src/ng-add/files/src/app/app.config.ts.template +11 -11
  59. package/src/ng-add/files/src/app/auth-routing.spec.ts.template +101 -0
  60. package/src/ng-add/files/src/app/core/analytics/log.service.ts.template +5 -8
  61. package/src/ng-add/files/src/app/core/analytics/time-analytics.service.spec.ts.template +140 -0
  62. package/src/ng-add/files/src/app/core/analytics/time-analytics.service.ts.template +25 -7
  63. package/src/ng-add/files/src/app/core/auth/guards/redirect-if-authenticated.guard.ts.template +1 -1
  64. package/src/ng-add/files/src/app/core/auth/guards/require-admin.guard.ts.template +1 -1
  65. package/src/ng-add/files/src/app/core/auth/guards/require-auth-and-consent.guard.ts.template +1 -1
  66. package/src/ng-add/files/src/app/core/auth/guards/require-auth.guard.ts.template +1 -1
  67. package/src/ng-add/files/src/app/core/firebase/cached-listeners.service.ts.template +229 -14
  68. package/src/ng-add/files/src/app/core/firebase/database.service.ts.template +1 -1
  69. package/src/ng-add/files/src/app/core/firebase/firebase.mock.service.ts.template +34 -9
  70. package/src/ng-add/files/src/app/core/firebase/firebase.service.ts.template +4 -4
  71. package/src/ng-add/files/src/app/core/firebase/query-logger.ts.template +11 -0
  72. package/src/ng-add/files/src/app/core/firebase/simulate-load.spec.ts.template +104 -0
  73. package/src/ng-add/files/src/app/core/firebase/simulate-stream.spec.ts.template +127 -0
  74. package/src/ng-add/files/src/app/core/firebase/simulation.mock.ts.template +38 -0
  75. package/src/ng-add/files/src/app/core/firebase/stream-multiplexer.ts.template +443 -0
  76. package/src/ng-add/files/src/app/core/store/app.store.spec.ts.template +920 -0
  77. package/src/ng-add/files/src/app/core/store/app.store.ts.template +303 -137
  78. package/src/ng-add/files/src/app/core/store/auth/auth.mock.ts.template +65 -23
  79. package/src/ng-add/files/src/app/core/store/auth/auth.store.ts.template +68 -67
  80. package/src/ng-add/files/src/app/core/store/user/user.mock.ts.template +46 -0
  81. package/src/ng-add/files/src/app/core/store/user-context/user-context.mock.ts.template +17 -0
  82. package/src/ng-add/files/src/app/core/testing/test-utils.ts.template +26 -0
  83. package/src/ng-add/files/src/app/first-time/consent/consent.component.html.template +3 -3
  84. package/src/ng-add/files/src/app/first-time/consent/consent.component.spec.ts.template +89 -13
  85. package/src/ng-add/files/src/app/first-time/consent/consent.component.ts.template +46 -17
  86. package/src/ng-add/files/src/app/first-time/consent/consent.guard.ts.template +1 -1
  87. package/src/ng-add/files/src/app/first-time/early-access/early-access.component.html.template +5 -63
  88. package/src/ng-add/files/src/app/first-time/early-access/early-access.component.scss.template +1 -94
  89. package/src/ng-add/files/src/app/first-time/early-access/early-access.component.spec.ts.template +150 -14
  90. package/src/ng-add/files/src/app/first-time/early-access/early-access.component.ts.template +15 -42
  91. package/src/ng-add/files/src/app/first-time/early-access/early-access.guard.ts.template +2 -2
  92. package/src/ng-add/files/src/app/first-time/early-access/early-access.model.ts.template +5 -0
  93. package/src/ng-add/files/src/app/first-time/early-access/survey-form/survey-form.component.html.template +42 -0
  94. package/src/ng-add/files/src/app/first-time/early-access/survey-form/survey-form.component.scss.template +96 -0
  95. package/src/ng-add/files/src/app/first-time/early-access/survey-form/survey-form.component.spec.ts.template +37 -0
  96. package/src/ng-add/files/src/app/first-time/early-access/survey-form/survey-form.component.ts.template +63 -0
  97. package/src/ng-add/files/src/app/first-time/early-access/waitlist-view/waitlist-view.component.html.template +16 -0
  98. package/src/ng-add/files/src/app/first-time/early-access/waitlist-view/waitlist-view.component.scss.template +7 -0
  99. package/src/ng-add/files/src/app/first-time/early-access/waitlist-view/waitlist-view.component.spec.ts.template +41 -0
  100. package/src/ng-add/files/src/app/first-time/early-access/waitlist-view/waitlist-view.component.ts.template +26 -0
  101. package/src/ng-add/files/src/app/first-time/first-time-routing.spec.ts.template +123 -0
  102. package/src/ng-add/files/src/app/first-time/landing/hero/hero.component.html.template +11 -4
  103. package/src/ng-add/files/src/app/first-time/landing/hero/hero.component.scss.template +17 -4
  104. package/src/ng-add/files/src/app/first-time/landing/hero/hero.component.ts.template +5 -5
  105. package/src/ng-add/files/src/app/first-time/landing/landing.component.html.template +1 -1
  106. package/src/ng-add/files/src/app/first-time/landing/landing.component.scss.template +0 -1
  107. package/src/ng-add/files/src/app/first-time/landing/landing.component.spec.ts.template +25 -17
  108. package/src/ng-add/files/src/app/first-time/landing/landing.component.ts.template +4 -12
  109. package/src/ng-add/files/src/app/first-time/landing/rotating-quotes/rotating-quotes.component.ts.template +1 -1
  110. package/src/ng-add/files/src/app/first-time/login/login.component.spec.ts.template +36 -16
  111. package/src/ng-add/files/src/app/first-time/login/login.component.ts.template +1 -1
  112. package/src/ng-add/files/src/app/first-time/onboarding/onboarding.component.spec.ts.template +11 -15
  113. package/src/ng-add/files/src/app/first-time/onboarding/onboarding.component.ts.template +1 -3
  114. package/src/ng-add/files/src/app/main/home/home.component.ts.template +1 -3
  115. package/src/ng-add/files/src/app/shared/dev-status-bar/dev-status-bar.component.spec.ts.template +98 -0
  116. package/src/ng-add/files/src/app/shared/dev-status-bar/dev-status-bar.component.ts.template +9 -3
  117. package/src/ng-add/files/src/app/shared/hint-visibility/hint-visibility.directive.spec.ts.template +164 -0
  118. package/src/ng-add/files/src/app/shared/hint-visibility/hint-visibility.directive.ts.template +20 -18
  119. package/src/ng-add/files/src/app/shared/navbar/navbar.component.spec.ts.template +38 -17
  120. package/src/ng-add/files/src/app/shared/navbar/navbar.component.ts.template +1 -1
  121. package/src/ng-add/files/src/app/shared/redeployment-warning/redeployment-warning.component.html.template +1 -1
  122. package/src/ng-add/files/src/app/shared/redeployment-warning/redeployment-warning.component.spec.ts.template +49 -10
  123. package/src/ng-add/files/src/app/shared/redeployment-warning/redeployment-warning.component.ts.template +5 -5
  124. package/src/ng-add/files/src/app/shared/redeployment-warning/redeployment-warning.service.spec.ts.template +86 -0
  125. package/src/ng-add/files/src/app/shared/redeployment-warning/redeployment-warning.service.ts.template +11 -9
  126. package/src/ng-add/files/src/environments/environment.prod.ts.template +1 -0
  127. package/src/ng-add/files/src/environments/environment.test.ts.template +1 -0
  128. package/src/ng-add/files/src/environments/environment.ts.template +2 -8
  129. package/src/ng-add/files/src/styles.scss.template +29 -1
  130. package/src/ng-add/files/tsconfig.app.json.template +6 -6
  131. package/src/ng-add/files/tsconfig.json.template +13 -8
  132. package/src/ng-add/files/tsconfig.spec.json.template +6 -5
  133. package/src/ng-add/index.js +19 -1
  134. package/src/ng-add/index.js.map +1 -1
  135. package/tech4good-angular-schematics-21.0.0.tgz +0 -0
  136. package/src/component/files/__name@dasherize__/__name@dasherize__.animations.ts.template +0 -4
  137. package/src/ng-add/files/src/app/admin/admin-panel/admin-panel.animations.ts.template +0 -4
  138. package/src/ng-add/files/src/app/admin/admin-panel/admin-user-list/admin-user-counts/admin-count-pill/admin-count-pill.animations.ts.template +0 -4
  139. package/src/ng-add/files/src/app/admin/admin-panel/admin-user-list/admin-user-counts/admin-user-counts.animations.ts.template +0 -4
  140. package/src/ng-add/files/src/app/admin/admin-panel/admin-user-list/admin-user-table/admin-user-table.animations.ts.template +0 -4
  141. package/src/ng-add/files/src/app/first-time/consent/consent.animations.ts.template +0 -4
  142. package/src/ng-add/files/src/app/first-time/early-access/early-access.animations.ts.template +0 -10
  143. package/src/ng-add/files/src/app/first-time/landing/hero/hero.animations.ts.template +0 -15
  144. package/src/ng-add/files/src/app/first-time/landing/landing.animations.ts.template +0 -4
  145. package/src/ng-add/files/src/app/first-time/onboarding/onboarding.animations.ts.template +0 -4
  146. package/src/ng-add/files/src/app/main/home/home.animations.ts.template +0 -4
@@ -0,0 +1,221 @@
1
+ /**
2
+ * @jest-environment node
3
+ */
4
+ import {
5
+ assertFails,
6
+ assertSucceeds,
7
+ initializeTestEnvironment,
8
+ RulesTestEnvironment,
9
+ } from '@firebase/rules-unit-testing';
10
+ import { readFileSync } from 'fs';
11
+ import { doc, setDoc, updateDoc, getDoc, deleteDoc, collection, addDoc } from 'firebase/firestore';
12
+
13
+ let testEnv: RulesTestEnvironment;
14
+
15
+ beforeAll(async () => {
16
+ testEnv = await initializeTestEnvironment({
17
+ projectId: 'demo-rules-test',
18
+ firestore: {
19
+ rules: readFileSync('firestore.rules', 'utf8'),
20
+ host: '127.0.0.1',
21
+ port: 8080,
22
+ },
23
+ });
24
+ });
25
+
26
+ afterEach(async () => {
27
+ await testEnv.clearFirestore();
28
+ });
29
+
30
+ afterAll(async () => {
31
+ await testEnv.cleanup();
32
+ });
33
+
34
+ describe('Firestore Security Rules', () => {
35
+ describe('Users Collection', () => {
36
+ it('should allow authenticated users to read profiles, deny unauthenticated', async () => {
37
+ await testEnv.withSecurityRulesDisabled(async (context) => {
38
+ await setDoc(doc(context.firestore(), 'users/alice'), { name: 'Alice' });
39
+ });
40
+ const unauthedDb = testEnv.unauthenticatedContext().firestore();
41
+ await assertFails(getDoc(doc(unauthedDb, 'users/alice')));
42
+ const bobDb = testEnv.authenticatedContext('bob').firestore();
43
+ await assertSucceeds(getDoc(doc(bobDb, 'users/alice')));
44
+ });
45
+
46
+ it('should allow user to create their own profile', async () => {
47
+ const aliceDb = testEnv.authenticatedContext('alice').firestore();
48
+ await assertSucceeds(
49
+ setDoc(doc(aliceDb, 'users/alice'), { name: 'Alice', isAdmin: false })
50
+ );
51
+ });
52
+
53
+ it('should deny user from creating profile with isAdmin=true', async () => {
54
+ const aliceDb = testEnv.authenticatedContext('alice').firestore();
55
+ await assertFails(
56
+ setDoc(doc(aliceDb, 'users/alice'), { name: 'Alice', isAdmin: true })
57
+ );
58
+ });
59
+
60
+ it('should deny user from updating their own isAdmin flag', async () => {
61
+ await testEnv.withSecurityRulesDisabled(async (context) => {
62
+ await setDoc(doc(context.firestore(), 'users/alice'), { name: 'Alice', isAdmin: false });
63
+ });
64
+ const aliceDb = testEnv.authenticatedContext('alice').firestore();
65
+ await assertFails(updateDoc(doc(aliceDb, 'users/alice'), { isAdmin: true }));
66
+ });
67
+
68
+ it('should deny user from modifying adminOverridePaths', async () => {
69
+ await testEnv.withSecurityRulesDisabled(async (context) => {
70
+ await setDoc(doc(context.firestore(), 'users/alice'), { name: 'Alice', adminOverridePaths: [] });
71
+ });
72
+ const aliceDb = testEnv.authenticatedContext('alice').firestore();
73
+ await assertFails(updateDoc(doc(aliceDb, 'users/alice'), { adminOverridePaths: ['some/path'] }));
74
+ });
75
+
76
+ it('should allow user to transition accessState from 01 to 02 and set joinedWaitlistAt', async () => {
77
+ await testEnv.withSecurityRulesDisabled(async (context) => {
78
+ await setDoc(doc(context.firestore(), 'users/alice'), { accessState: '01 - submit interest' });
79
+ });
80
+ const aliceDb = testEnv.authenticatedContext('alice').firestore();
81
+ await assertSucceeds(updateDoc(doc(aliceDb, 'users/alice'), { accessState: '02 - waiting', joinedWaitlistAt: 123456789 }));
82
+ });
83
+
84
+ it('should deny user from transitioning accessState from 02 to 03', async () => {
85
+ await testEnv.withSecurityRulesDisabled(async (context) => {
86
+ await setDoc(doc(context.firestore(), 'users/alice'), { accessState: '02 - waiting' });
87
+ });
88
+ const aliceDb = testEnv.authenticatedContext('alice').firestore();
89
+ await assertFails(updateDoc(doc(aliceDb, 'users/alice'), { accessState: '03 - consent' }));
90
+ });
91
+
92
+ it('should allow admin to transition accessState from 02 to 03', async () => {
93
+ await testEnv.withSecurityRulesDisabled(async (context) => {
94
+ await setDoc(doc(context.firestore(), 'users/admin'), { isAdmin: true });
95
+ await setDoc(doc(context.firestore(), 'users/alice'), { accessState: '02 - waiting' });
96
+ });
97
+ const adminDb = testEnv.authenticatedContext('admin').firestore();
98
+ await assertSucceeds(updateDoc(doc(adminDb, 'users/alice'), { accessState: '03 - consent' }));
99
+ });
100
+
101
+ it('should allow user to transition accessState from 03 to done', async () => {
102
+ await testEnv.withSecurityRulesDisabled(async (context) => {
103
+ await setDoc(doc(context.firestore(), 'users/alice'), { accessState: '03 - consent' });
104
+ });
105
+ const aliceDb = testEnv.authenticatedContext('alice').firestore();
106
+ await assertSucceeds(updateDoc(doc(aliceDb, 'users/alice'), { accessState: 'done' }));
107
+ });
108
+
109
+ it('should deny user from modifying joinedWaitlistAt after it is set', async () => {
110
+ await testEnv.withSecurityRulesDisabled(async (context) => {
111
+ await setDoc(doc(context.firestore(), 'users/alice'), { accessState: '02 - waiting', joinedWaitlistAt: 123 });
112
+ });
113
+ const aliceDb = testEnv.authenticatedContext('alice').firestore();
114
+ await assertFails(updateDoc(doc(aliceDb, 'users/alice'), { joinedWaitlistAt: 456 }));
115
+ });
116
+
117
+ it('should allow user to delete their own profile', async () => {
118
+ await testEnv.withSecurityRulesDisabled(async (context) => {
119
+ await setDoc(doc(context.firestore(), 'users/alice'), { name: 'Alice' });
120
+ });
121
+ const aliceDb = testEnv.authenticatedContext('alice').firestore();
122
+ await assertSucceeds(deleteDoc(doc(aliceDb, 'users/alice')));
123
+ });
124
+
125
+ it('should deny user from deleting another users profile', async () => {
126
+ await testEnv.withSecurityRulesDisabled(async (context) => {
127
+ await setDoc(doc(context.firestore(), 'users/alice'), { name: 'Alice' });
128
+ });
129
+ const bobDb = testEnv.authenticatedContext('bob').firestore();
130
+ await assertFails(deleteDoc(doc(bobDb, 'users/alice')));
131
+ });
132
+
133
+ it('should allow admin to delete another users profile', async () => {
134
+ await testEnv.withSecurityRulesDisabled(async (context) => {
135
+ await setDoc(doc(context.firestore(), 'users/admin'), { isAdmin: true });
136
+ await setDoc(doc(context.firestore(), 'users/alice'), { name: 'Alice' });
137
+ });
138
+ const adminDb = testEnv.authenticatedContext('admin').firestore();
139
+ await assertSucceeds(deleteDoc(doc(adminDb, 'users/alice')));
140
+ });
141
+ });
142
+
143
+ describe('UserContexts Collection', () => {
144
+ it('should allow user to create their own context', async () => {
145
+ const aliceDb = testEnv.authenticatedContext('alice').firestore();
146
+ await assertSucceeds(
147
+ setDoc(doc(aliceDb, 'userContexts/ctx1'), {
148
+ __userId: 'alice',
149
+ })
150
+ );
151
+ });
152
+
153
+ it('should deny user from creating context for someone else', async () => {
154
+ const aliceDb = testEnv.authenticatedContext('alice').firestore();
155
+ await assertFails(
156
+ setDoc(doc(aliceDb, 'userContexts/ctx1'), {
157
+ __userId: 'bob',
158
+ })
159
+ );
160
+ });
161
+
162
+ it('should allow user to read their own context', async () => {
163
+ await testEnv.withSecurityRulesDisabled(async (context) => {
164
+ await setDoc(doc(context.firestore(), 'userContexts/ctx1'), { __userId: 'alice' });
165
+ });
166
+ const aliceDb = testEnv.authenticatedContext('alice').firestore();
167
+ await assertSucceeds(getDoc(doc(aliceDb, 'userContexts/ctx1')));
168
+ });
169
+
170
+ it('should deny user from reading another users context', async () => {
171
+ await testEnv.withSecurityRulesDisabled(async (context) => {
172
+ await setDoc(doc(context.firestore(), 'userContexts/ctx1'), { __userId: 'alice' });
173
+ });
174
+ const bobDb = testEnv.authenticatedContext('bob').firestore();
175
+ await assertFails(getDoc(doc(bobDb, 'userContexts/ctx1')));
176
+ });
177
+
178
+ it('should allow admin to read another users context', async () => {
179
+ await testEnv.withSecurityRulesDisabled(async (context) => {
180
+ await setDoc(doc(context.firestore(), 'users/admin'), { isAdmin: true });
181
+ await setDoc(doc(context.firestore(), 'userContexts/ctx1'), { __userId: 'alice' });
182
+ });
183
+ const adminDb = testEnv.authenticatedContext('admin').firestore();
184
+ await assertSucceeds(getDoc(doc(adminDb, 'userContexts/ctx1')));
185
+ });
186
+
187
+ it('should deny user from transferring their context to another user', async () => {
188
+ await testEnv.withSecurityRulesDisabled(async (context) => {
189
+ await setDoc(doc(context.firestore(), 'userContexts/ctx1'), { __userId: 'alice' });
190
+ });
191
+ const aliceDb = testEnv.authenticatedContext('alice').firestore();
192
+ await assertFails(
193
+ updateDoc(doc(aliceDb, 'userContexts/ctx1'), { __userId: 'bob' })
194
+ );
195
+ });
196
+
197
+ it('should allow user to delete their own context', async () => {
198
+ await testEnv.withSecurityRulesDisabled(async (context) => {
199
+ await setDoc(doc(context.firestore(), 'userContexts/ctx1'), { __userId: 'alice' });
200
+ });
201
+ const aliceDb = testEnv.authenticatedContext('alice').firestore();
202
+ await assertSucceeds(deleteDoc(doc(aliceDb, 'userContexts/ctx1')));
203
+ });
204
+
205
+ it('should deny user from deleting another users context', async () => {
206
+ await testEnv.withSecurityRulesDisabled(async (context) => {
207
+ await setDoc(doc(context.firestore(), 'userContexts/ctx1'), { __userId: 'alice' });
208
+ });
209
+ const bobDb = testEnv.authenticatedContext('bob').firestore();
210
+ await assertFails(deleteDoc(doc(bobDb, 'userContexts/ctx1')));
211
+ });
212
+ });
213
+
214
+ describe('Default Deny', () => {
215
+ it('should deny read/write to unknown collections', async () => {
216
+ const aliceDb = testEnv.authenticatedContext('alice').firestore();
217
+ await assertFails(addDoc(collection(aliceDb, 'unknownCollection'), { foo: 'bar' }));
218
+ await assertFails(getDoc(doc(aliceDb, 'unknownCollection/123')));
219
+ });
220
+ });
221
+ });
@@ -0,0 +1,67 @@
1
+ rules_version = '2';
2
+ service cloud.firestore {
3
+ match /databases/{database}/documents {
4
+
5
+ function isAdmin() {
6
+ return get(/databases/$(database)/documents/users/$(request.auth.uid)).data.isAdmin == true;
7
+ }
8
+
9
+ // ─── Users ───────────────────────────────────────────────────────────
10
+ // Create: only the user themselves (auth.uid == document ID). Users cannot set isAdmin to true.
11
+ // Read: publicly readable (any authenticated user)
12
+ // Update: only the user themselves or admins. Regular users are restricted from modifying state bypasses or sensitive lists.
13
+ // Delete: only the user themselves or admins.
14
+ match /users/{userId} {
15
+ allow create: if request.auth != null
16
+ && request.auth.uid == userId
17
+ && (!('isAdmin' in request.resource.data) || request.resource.data.isAdmin == false || isAdmin());
18
+ allow read: if request.auth != null;
19
+ allow update: if request.auth != null
20
+ && (isAdmin() || (
21
+ request.auth.uid == userId
22
+ // Cannot grant themselves admin privileges
23
+ && (!('isAdmin' in request.resource.data) || request.resource.data.isAdmin == resource.data.isAdmin)
24
+ // Cannot alter adminOverridePaths
25
+ && (!('adminOverridePaths' in request.resource.data) || request.resource.data.adminOverridePaths == resource.data.adminOverridePaths)
26
+ // Must follow accessState transitions if changing accessState
27
+ && (!('accessState' in request.resource.data)
28
+ || request.resource.data.accessState == resource.data.accessState
29
+ || (resource.data.accessState == '01 - submit interest' && request.resource.data.accessState == '02 - waiting')
30
+ || (resource.data.accessState == '03 - consent' && request.resource.data.accessState == 'done')
31
+ )
32
+ // Cannot modify joinedWaitlistAt unless transitioning to waiting
33
+ && (!('joinedWaitlistAt' in request.resource.data)
34
+ || request.resource.data.joinedWaitlistAt == resource.data.joinedWaitlistAt
35
+ || (resource.data.accessState == '01 - submit interest' && request.resource.data.accessState == '02 - waiting')
36
+ )
37
+ ));
38
+ allow delete: if request.auth != null
39
+ && (request.auth.uid == userId || isAdmin());
40
+ }
41
+
42
+ // ─── User Contexts ───────────────────────────────────────────────────
43
+ // Create: only the user themselves (auth.uid == __userId)
44
+ // Read: only the user themselves or admins
45
+ // Update: only the user themselves or admins. Prevent transferring context.
46
+ // Delete: only the user themselves or admins
47
+ match /userContexts/{contextId} {
48
+ allow create: if request.auth != null
49
+ && request.resource.data.__userId == request.auth.uid;
50
+ allow read: if request.auth != null
51
+ && (resource.data.__userId == request.auth.uid || isAdmin());
52
+ allow update: if request.auth != null
53
+ && (isAdmin() || (
54
+ resource.data.__userId == request.auth.uid
55
+ // Prevent users from transferring their userContext to another user
56
+ && (!('__userId' in request.resource.data) || request.resource.data.__userId == resource.data.__userId)
57
+ ));
58
+ allow delete: if request.auth != null
59
+ && (resource.data.__userId == request.auth.uid || isAdmin());
60
+ }
61
+
62
+ // ─── Default deny ────────────────────────────────────────────────────
63
+ // Any collection not explicitly matched above is denied by default.
64
+ // This is Firestore's default behavior, but stating it explicitly
65
+ // ensures new collections aren't accidentally left open.
66
+ }
67
+ }
@@ -56,7 +56,12 @@ const config: Config = {
56
56
  testEnvironment: 'jsdom',
57
57
  setupFilesAfterEnv: ['<rootDir>/setup-jest.ts'],
58
58
  moduleFileExtensions: ['ts', 'js', 'html'],
59
- testPathIgnorePatterns: ['/node_modules/', '/dist/', '<rootDir>/src/environments/environment.test.ts',],
59
+ testPathIgnorePatterns: [
60
+ '/node_modules/',
61
+ '/dist/',
62
+ '<rootDir>/src/environments/environment.test.ts',
63
+ ...(process.env['JEST_RULES'] ? [] : ['<rootDir>/firestore.rules.spec.ts'])
64
+ ],
60
65
  collectCoverageFrom: [
61
66
  'src/app/**/*.ts',
62
67
  '!src/app/**/*.module.ts',
@@ -9,49 +9,53 @@
9
9
  "watch": "ng build --watch --configuration development",
10
10
  "test": "jest",
11
11
  "test:watch": "jest --watch",
12
- "test:coverage": "jest --coverage",
12
+ "test:coverage": "jest --coverage",
13
+ "test:rules": "firebase emulators:exec --only firestore 'JEST_RULES=1 jest firestore.rules.spec.ts'",
13
14
  "lint": "ng lint",
14
15
  "lintfix": "ng lint --fix",
15
- "code-check": "ngc --noEmit && sass src:dist/css-check --no-source-map && rm -rf dist/css-check && npm run lintfix"
16
+ "code-check": "ngc --noEmit && sass src:dist/css-check --no-source-map && rm -rf dist/css-check && npm run lintfix",
17
+ "analyze": "ng build --stats-json && esbuild-visualizer --metadata dist/<%= dasherize(project) %>/stats.json --filename dist/<%= dasherize(project) %>/bundle-analysis.html && open dist/<%= dasherize(project) %>/bundle-analysis.html"
16
18
  },
17
19
  "private": true,
18
20
  "dependencies": {
19
- "@angular/animations": "^20.3.0",
20
- "@angular/cdk": "^20.2.3",
21
- "@angular/common": "^20.3.0",
22
- "@angular/compiler": "^20.3.0",
23
- "@angular/core": "^20.3.0",
24
- "@angular/fire": "^20.0.1",
25
- "@angular/forms": "^20.3.0",
26
- "@angular/material": "^20.2.3",
27
- "@angular/platform-browser": "^20.3.0",
28
- "@angular/platform-browser-dynamic": "^20.3.0",
29
- "@angular/router": "^20.3.0",
30
- "@ngrx/signals": "^20.0.1",
21
+ "@angular/animations": "^21.2.15",
22
+ "@angular/cdk": "^21.2.13",
23
+ "@angular/common": "^21.2.15",
24
+ "@angular/compiler": "^21.2.15",
25
+ "@angular/core": "^21.2.15",
26
+ "@angular/fire": "^21.0.0-rc.0",
27
+ "@angular/forms": "^21.2.15",
28
+ "@angular/material": "^21.2.13",
29
+ "@angular/platform-browser": "^21.2.15",
30
+ "@angular/platform-browser-dynamic": "^21.2.15",
31
+ "@angular/router": "^21.2.15",
32
+ "@ngrx/signals": "^21.1.0",
31
33
  "core-js": "^3.37.1",
32
34
  "cross-fetch": "^4.0.0",
33
35
  "crypto-es": "^2.1.0",
34
36
  "dotenv": "^17.2.2",
35
37
  "eslint": "^9.35.0",
38
+ "firebase": "^12.14.0",
36
39
  "globalthis": "^1.0.4",
37
40
  "proxy-polyfill": "^0.3.2",
38
41
  "rxjs": "~7.8.0",
39
- "tslib": "^2.3.0",
40
- "zone.js": "~0.15.1"
42
+ "tslib": "^2.3.0"
41
43
  },
42
44
  "devDependencies": {
43
- "@angular-devkit/build-angular": "^20.3.2",
44
- "@angular-eslint/builder": "^20.3.0",
45
- "@angular-eslint/eslint-plugin": "^20.3.0",
46
- "@angular-eslint/eslint-plugin-template": "^20.3.0",
47
- "@angular-eslint/schematics": "^20.3.0",
48
- "@angular-eslint/template-parser": "^20.3.0",
49
- "@angular/cli": "^20.3.2",
50
- "@angular/compiler-cli": "^20.3.0",
51
- "@ngx-env/builder": "^20.1.1",
52
- "@tech4good/angular-schematics": "^20.3.1",
45
+ "@angular-eslint/builder": "^21.4.0",
46
+ "@angular-eslint/eslint-plugin": "^21.4.0",
47
+ "@angular-eslint/eslint-plugin-template": "^21.4.0",
48
+ "@angular-eslint/schematics": "^21.4.0",
49
+ "@angular-eslint/template-parser": "^21.4.0",
50
+ "@angular/build": "^21.2.13",
51
+ "@angular/cli": "^21.2.13",
52
+ "@angular/compiler-cli": "^21.2.15",
53
+ "@firebase/rules-unit-testing": "^5.0.1",
54
+ "firebase-tools": "^14.27.0",
55
+ "@ngx-env/builder": "^21.0.1",
56
+ "@tech4good/angular-schematics": "^21.1.0",
53
57
  "@types/estree": "^1.0.0",
54
- "@types/jest": "^29.5.14",
58
+ "@types/jest": "^30.0.0",
55
59
  "@types/node": "^18.19.47",
56
60
  "@typescript-eslint/eslint-plugin": "^8.44.0",
57
61
  "@typescript-eslint/parser": "^8.44.0",
@@ -60,13 +64,19 @@
60
64
  "@testing-library/angular": "^17.3.6",
61
65
  "@testing-library/jest-dom": "^6.6.3",
62
66
  "@testing-library/user-event": "^14.6.1",
67
+ "esbuild-visualizer": "^0.7.0",
63
68
  "eslint-config-google": "^0.14.0",
64
- "jest": "^29.7.0",
65
- "jest-environment-jsdom": "^29.7.0",
66
- "jest-preset-angular": "^14.5.1",
67
- "typescript": "~5.8.3",
69
+ "jest": "^30.4.2",
70
+ "jest-environment-jsdom": "^30.4.1",
71
+ "jest-preset-angular": "^16.1.5",
72
+ "typescript": "~5.9.3",
73
+ "whatwg-fetch": "^3.6.20",
68
74
  "ts-jest": "^29.3.4",
69
75
  "ts-jest-mock-import-meta": "^1.3.0",
70
76
  "ts-node": "^10.9.2"
77
+ },
78
+ "overrides": {
79
+ "firebase": "$firebase",
80
+ "@types/node": "^18.19.47"
71
81
  }
72
82
  }
@@ -1,10 +1,18 @@
1
- import { setupZoneTestEnv } from 'jest-preset-angular/setup-env/zone';
1
+ import 'whatwg-fetch';
2
+ import { setupZonelessTestEnv } from 'jest-preset-angular/setup-env/zoneless';
2
3
  import { TestBed } from '@angular/core/testing';
3
- import { BrowserAnimationsModule } from '@angular/platform-browser/animations';
4
4
  import '@testing-library/jest-dom';
5
5
 
6
- setupZoneTestEnv();
6
+ setupZonelessTestEnv();
7
7
 
8
8
  TestBed.configureTestingModule({
9
- imports: [BrowserAnimationsModule]
10
- });
9
+ });
10
+
11
+ // Intercept console.error to suppress JSDOM CSS parsing errors
12
+ const originalConsoleError = console.error;
13
+ console.error = (...args) => {
14
+ if (args[0] && typeof args[0] === 'object' && args[0].type === 'css parsing') {
15
+ return;
16
+ }
17
+ originalConsoleError(...args);
18
+ };
@@ -1,37 +1,101 @@
1
- import { render } from '@testing-library/angular';
1
+ import { render, screen } from '@testing-library/angular';
2
2
  import userEvent from '@testing-library/user-event';
3
+ import { Router, ActivatedRoute } from '@angular/router';
4
+ import { MatSnackBar } from '@angular/material/snack-bar';
5
+ import { Provider } from '@angular/core';
3
6
 
4
7
  import { AdminPanelComponent } from './admin-panel.component';
5
8
  import { DATABASE_SERVICE } from 'src/app/core/firebase/database.service';
6
9
  import { FirebaseMockService } from 'src/app/core/firebase/firebase.mock.service';
7
- import { BatchWriteMockService } from 'src/app/core/store/batch-write.mock.service';
8
10
  import { BATCH_WRITE_SERVICE } from 'src/app/core/store/batch-write.service';
11
+ import { BatchWriteMockService } from 'src/app/core/store/batch-write.mock.service';
12
+ import { AuthStore } from 'src/app/core/store/auth/auth.store';
13
+ import { AuthLoggedInMockDB } from 'src/app/core/store/auth/auth.mock';
14
+ import { UserStore } from 'src/app/core/store/user/user.store';
15
+ import { UserContextStore } from 'src/app/core/store/user-context/user-context.store';
9
16
 
10
- /** Sets up the testing environment for AdminPanelComponent using render.*/
11
- async function setup() {
17
+ /** Sets up the testing environment for AdminPanelComponent using render. */
18
+ async function setup(providers: Provider[] = [], componentInputs: any = {}) {
12
19
  const user = userEvent.setup();
13
- const checkedSpy = jest.fn();
20
+ const routerMock = {
21
+ navigate: jest.fn(),
22
+ url: '/admin',
23
+ events: { pipe: () => ({ subscribe: () => {} }) },
24
+ };
25
+ const activatedRouteMock = {
26
+ snapshot: {
27
+ paramMap: { get: () => null },
28
+ queryParamMap: { get: () => null },
29
+ },
30
+ };
31
+ const snackBarMock = {
32
+ open: jest.fn(),
33
+ };
14
34
 
15
35
  const view = await render(AdminPanelComponent, {
16
- imports: [],
17
36
  providers: [
37
+ { provide: Router, useValue: routerMock },
38
+ { provide: ActivatedRoute, useValue: activatedRouteMock },
39
+ { provide: MatSnackBar, useValue: snackBarMock },
18
40
  { provide: DATABASE_SERVICE, useClass: FirebaseMockService },
19
41
  { provide: BATCH_WRITE_SERVICE, useClass: BatchWriteMockService },
42
+ { provide: AuthStore, useClass: AuthLoggedInMockDB },
43
+ UserStore,
44
+ UserContextStore,
45
+ ...providers,
20
46
  ],
21
- componentInputs: {},
22
- on: {},
47
+ componentInputs,
23
48
  });
24
49
 
25
50
  return {
26
51
  user,
27
52
  fixture: view.fixture,
28
- rerender: () => view.rerender(), // add component inputs if needed
53
+ routerMock,
54
+ snackBarMock,
55
+ view,
29
56
  };
30
57
  }
31
58
 
32
59
  describe('AdminPanelComponent', () => {
33
- it('should create', async () => {
34
- const { fixture } = await setup();
35
- expect(fixture.componentInstance).toBeTruthy();
60
+ it('should default to users tab and render user list when no tab input is provided', async () => {
61
+ await setup();
62
+
63
+ // Check that the users tab is marked active
64
+ const usersTab = screen.getByRole('button', { name: /users/i });
65
+ expect(usersTab).toHaveClass('active');
66
+
67
+ // AdminUserListComponent is rendered
68
+ expect(screen.getByRole('heading', { name: /Waitlist/i })).toBeVisible();
69
+ expect(screen.queryByRole('heading', { name: /Route Override/i })).not.toBeInTheDocument();
70
+ });
71
+
72
+ it('should display settings tab when settings input is provided', async () => {
73
+ await setup([], { tab: 'settings' });
74
+
75
+ // Check that the settings tab is marked active
76
+ const settingsTab = screen.getByRole('button', { name: /settings/i });
77
+ expect(settingsTab).toHaveClass('active');
78
+
79
+ // AdminSettingsComponent is rendered
80
+ expect(screen.getByRole('heading', { name: /Route Override/i })).toBeVisible();
81
+ expect(screen.queryByRole('heading', { name: /Waitlist/i })).not.toBeInTheDocument();
82
+ });
83
+
84
+ it('should switch tabs and update query params on tab click', async () => {
85
+ const { user, routerMock } = await setup();
86
+
87
+ const settingsTab = screen.getByRole('button', { name: /settings/i });
88
+ await user.click(settingsTab);
89
+
90
+ // Verify local tab state updates to settings
91
+ expect(settingsTab).toHaveClass('active');
92
+ expect(screen.getByRole('heading', { name: /Route Override/i })).toBeVisible();
93
+
94
+ // Verify query param navigation triggered
95
+ expect(routerMock.navigate).toHaveBeenCalledWith([], {
96
+ relativeTo: expect.any(Object),
97
+ queryParams: { tab: 'settings' },
98
+ queryParamsHandling: 'merge',
99
+ });
36
100
  });
37
101
  });
@@ -1,6 +1,5 @@
1
1
  import { Component, ChangeDetectionStrategy, inject, input, linkedSignal } from '@angular/core';
2
2
  import { ActivatedRoute, Router } from '@angular/router';
3
- import { AdminPanelAnimations } from './admin-panel.animations';
4
3
  import { MatIcon } from '@angular/material/icon';
5
4
  import { AdminUserListComponent } from './admin-user-list/admin-user-list.component';
6
5
  import { AdminSettingsComponent } from './admin-settings/admin-settings.component';
@@ -15,9 +14,8 @@ type AdminTab = 'users' | 'settings';
15
14
  @Component({
16
15
  selector: 'app-admin-panel',
17
16
  templateUrl: './admin-panel.component.html',
18
- styleUrls: ['./admin-panel.component.scss'],
17
+ styleUrl: './admin-panel.component.scss',
19
18
  changeDetection: ChangeDetectionStrategy.OnPush,
20
- animations: AdminPanelAnimations,
21
19
  imports: [
22
20
  MatIcon,
23
21
  AdminUserListComponent,
@@ -0,0 +1,90 @@
1
+ import { render, screen } from '@testing-library/angular';
2
+ import userEvent from '@testing-library/user-event';
3
+ import { MatSnackBar } from '@angular/material/snack-bar';
4
+ import { Provider } from '@angular/core';
5
+
6
+ import { AdminSettingsComponent } from './admin-settings.component';
7
+ import { DATABASE_SERVICE } from 'src/app/core/firebase/database.service';
8
+ import { FirebaseMockService } from 'src/app/core/firebase/firebase.mock.service';
9
+ import { BATCH_WRITE_SERVICE } from 'src/app/core/store/batch-write.service';
10
+ import { BatchWriteMockService } from 'src/app/core/store/batch-write.mock.service';
11
+ import { AuthStore } from 'src/app/core/store/auth/auth.store';
12
+ import { AuthLoggedInMockDB } from 'src/app/core/store/auth/auth.mock';
13
+ import { UserStore } from 'src/app/core/store/user/user.store';
14
+ import { USER_DB } from 'src/app/core/store/user/user.mock';
15
+
16
+ /** Sets up the testing environment for AdminSettingsComponent using render. */
17
+ async function setup(providers: Provider[] = []) {
18
+ const user = userEvent.setup();
19
+ const snackBarMock = {
20
+ open: jest.fn(),
21
+ };
22
+
23
+ const view = await render(AdminSettingsComponent, {
24
+ providers: [
25
+ { provide: MatSnackBar, useValue: snackBarMock },
26
+ { provide: DATABASE_SERVICE, useClass: FirebaseMockService },
27
+ { provide: BATCH_WRITE_SERVICE, useClass: BatchWriteMockService },
28
+ { provide: AuthStore, useClass: AuthLoggedInMockDB },
29
+ UserStore,
30
+ ...providers,
31
+ ],
32
+ });
33
+
34
+ return {
35
+ user,
36
+ fixture: view.fixture,
37
+ snackBarMock,
38
+ userStore: view.fixture.debugElement.injector.get(UserStore),
39
+ };
40
+ }
41
+
42
+ describe('AdminSettingsComponent', () => {
43
+ beforeEach(() => {
44
+ // Reset the static mock user overrides
45
+ USER_DB[0].adminOverridePaths = [];
46
+ });
47
+
48
+ it('should render all override routes as inactive by default', async () => {
49
+ await setup();
50
+
51
+ expect(screen.getByRole('heading', { name: /Route Override/i })).toBeVisible();
52
+
53
+ // Verify all toggles show off
54
+ const toggles = screen.getAllByText('toggle_off');
55
+ expect(toggles.length).toBe(4);
56
+ });
57
+
58
+ it('should display active toggle when route path is already overridden', async () => {
59
+ USER_DB[0].adminOverridePaths = ['/consent', '/onboarding'];
60
+ await setup();
61
+
62
+ // Verify 2 toggle on and 2 toggle off
63
+ expect(screen.getAllByText('toggle_on').length).toBe(2);
64
+ expect(screen.getAllByText('toggle_off').length).toBe(2);
65
+ });
66
+
67
+ it('should call userStore update, mutate override paths, and show success snackbar on toggle', async () => {
68
+ const { user, userStore, snackBarMock } = await setup();
69
+
70
+ // Spy on the store update method
71
+ const updateSpy = jest.spyOn(userStore, 'update').mockResolvedValue(undefined as any);
72
+
73
+ // Toggle `/consent` path (second item in list)
74
+ const consentLabel = screen.getByText('/consent');
75
+ const container = consentLabel.closest('.override-route-item');
76
+ const toggle = container!.querySelector('.override-toggle');
77
+
78
+ await user.click(toggle!);
79
+
80
+ // Verify userStore.update called with updated list
81
+ expect(updateSpy).toHaveBeenCalledWith('1', {
82
+ adminOverridePaths: ['/consent'],
83
+ });
84
+
85
+ // Verify snackbar opened
86
+ expect(snackBarMock.open).toHaveBeenCalledWith('Enabled override for /consent', '', { duration: 3000 });
87
+
88
+ updateSpy.mockRestore();
89
+ });
90
+ });