musora-content-services 2.167.2 → 2.167.4

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 (140) hide show
  1. package/.agent/decisions/2026-07-20-mu2-1724-songs-lessons-counts.md +33 -0
  2. package/.agent/decisions/2026-07-20-query-builder-tostring.md +37 -0
  3. package/.idea/codeStyles/Project.xml +61 -0
  4. package/.idea/codeStyles/codeStyleConfig.xml +5 -0
  5. package/.idea/modules.xml +8 -0
  6. package/.idea/musora-content-services.iml +8 -0
  7. package/.idea/php.xml +19 -0
  8. package/.idea/prettier.xml +6 -0
  9. package/.idea/vcs.xml +7 -0
  10. package/.yarn/install-state.gz +0 -0
  11. package/CHANGELOG.md +10 -0
  12. package/package.json +2 -1
  13. package/src/contentTypeConfig.js +1 -0
  14. package/src/lib/sanity/query.ts +5 -0
  15. package/src/services/config.js +15 -0
  16. package/src/services/content/artist.ts +1 -3
  17. package/src/services/content/counts.ts +47 -0
  18. package/src/services/content/genre.ts +1 -3
  19. package/src/services/content/instructor.ts +1 -3
  20. package/src/services/multi-user-accounts/multi-user-accounts.ts +1 -0
  21. package/src/services/userActivity.js +2 -0
  22. package/src/version-info.js +1 -0
  23. package/.claude/settings.local.json +0 -53
  24. package/test/initializeTests.js +0 -60
  25. package/test/integration/awards/award-exclusion-handling.test.ts +0 -275
  26. package/test/integration/awards/internal/image-utils.test.ts +0 -86
  27. package/test/integration/content-progress/__mocks__/mocks.ts +0 -104
  28. package/test/integration/content-progress/contentProgress.test.ts +0 -335
  29. package/test/integration/content-progress/e2eOfflineProgress.test.ts +0 -352
  30. package/test/integration/content-progress/e2eProgress.test.ts +0 -612
  31. package/test/integration/content-progress/getters.test.ts +0 -334
  32. package/test/integration/content-progress/helpers.test.ts +0 -263
  33. package/test/integration/content-progress/offlineContentProgress.test.ts +0 -226
  34. package/test/integration/forums.test.ts +0 -209
  35. package/test/integration/infrastructure/FetchRequestExecutor.test.ts +0 -88
  36. package/test/integration/initializeTestDB.ts +0 -80
  37. package/test/integration/learning-paths.test.ts +0 -854
  38. package/test/integration/notifications.test.ts +0 -178
  39. package/test/integration/progress-row/content-card.test.ts +0 -283
  40. package/test/integration/sync/adapters/idb-errors.test.ts +0 -144
  41. package/test/integration/sync/adapters/sqlite-errors.test.ts +0 -173
  42. package/test/integration/sync/fetch.test.ts +0 -224
  43. package/test/integration/sync/repositories/content-likes.test.ts +0 -99
  44. package/test/integration/sync/repositories/practices.test.ts +0 -179
  45. package/test/integration/sync/repositories/progress.test.ts +0 -245
  46. package/test/integration/sync/repositories/user-award-progress.static.test.ts +0 -68
  47. package/test/integration/sync/repositories/user-award-progress.test.ts +0 -387
  48. package/test/integration/sync/store/cross-user-protection.test.ts +0 -217
  49. package/test/integration/sync/store/store-idb.test.ts +0 -180
  50. package/test/integration/sync/store/store.test.ts +0 -361
  51. package/test/integration/user/permissions.test.js +0 -20
  52. package/test/integration/userActivity.test.ts +0 -102
  53. package/test/live/README.md +0 -29
  54. package/test/live/content.test.js +0 -116
  55. package/test/localStorageMock.js +0 -21
  56. package/test/log.js +0 -5
  57. package/test/mockData/award-definitions.js +0 -171
  58. package/test/mockData/mockData_fetchByRailContentIds_one_content.json +0 -35
  59. package/test/mockData/mockData_progress_content.json +0 -182
  60. package/test/mockData/mockData_sanity_progress_content.json +0 -1451
  61. package/test/mockData/mockData_user_practices.json +0 -9
  62. package/test/setupConsole.js +0 -6
  63. package/test/setupNetworkGuard.js +0 -3
  64. package/test/setupTimers.js +0 -13
  65. package/test/unit/HttpClient.test.ts +0 -267
  66. package/test/unit/awards/award-alacarte-observer.test.ts +0 -199
  67. package/test/unit/awards/award-auto-refresh.test.ts +0 -84
  68. package/test/unit/awards/award-calculations.test.ts +0 -34
  69. package/test/unit/awards/award-callbacks.test.ts +0 -144
  70. package/test/unit/awards/award-certificate-display.test.ts +0 -330
  71. package/test/unit/awards/award-collection-edge-cases.test.ts +0 -212
  72. package/test/unit/awards/award-collection-filtering.test.ts +0 -287
  73. package/test/unit/awards/award-completion-flow.test.ts +0 -306
  74. package/test/unit/awards/award-multi-lesson.test.ts +0 -243
  75. package/test/unit/awards/award-observer-integration.test.ts +0 -327
  76. package/test/unit/awards/award-query-messages.test.ts +0 -448
  77. package/test/unit/awards/award-user-collection.test.ts +0 -416
  78. package/test/unit/awards/duplicate-prevention.test.ts +0 -120
  79. package/test/unit/awards/helpers/completion-mock.ts +0 -56
  80. package/test/unit/awards/helpers/index.ts +0 -3
  81. package/test/unit/awards/helpers/mock-setup.ts +0 -79
  82. package/test/unit/awards/helpers/progress-emitter.ts +0 -45
  83. package/test/unit/awards/message-generator.test.ts +0 -162
  84. package/test/unit/content-progress/bubbleTrickle.test.ts +0 -322
  85. package/test/unit/content-progress/helpers.test.ts +0 -329
  86. package/test/unit/content-progress/navigateTo.test.ts +0 -392
  87. package/test/unit/contentLikes.test.ts +0 -62
  88. package/test/unit/contentMetaData.test.ts +0 -58
  89. package/test/unit/dataContext.test.ts +0 -38
  90. package/test/unit/dateUtils.test.ts +0 -188
  91. package/test/unit/endScreen.test.js +0 -712
  92. package/test/unit/eventsAPI.test.ts +0 -159
  93. package/test/unit/imageSRCBuilder.test.ts +0 -37
  94. package/test/unit/imageSRCVerify.test.ts +0 -155
  95. package/test/unit/infrastructure/DefaultHeaderProvider.test.ts +0 -39
  96. package/test/unit/infrastructure/sanity/ContentClient.test.ts +0 -168
  97. package/test/unit/infrastructure/sanity/DefaultConfigProvider.test.ts +0 -93
  98. package/test/unit/infrastructure/sanity/FetchQueryExecutor.test.ts +0 -174
  99. package/test/unit/infrastructure/sanity/SanityClient.test.ts +0 -140
  100. package/test/unit/lib/__snapshots__/filter.test.ts.snap +0 -5
  101. package/test/unit/lib/filter.test.ts +0 -1154
  102. package/test/unit/lib/lastUpdated.test.ts +0 -21
  103. package/test/unit/lib/query.test.ts +0 -1469
  104. package/test/unit/lib/sanity/decorators/base.test.ts +0 -368
  105. package/test/unit/lib/sanity/decorators/navigate-to.test.ts +0 -361
  106. package/test/unit/lib/sanity/decorators/need-access.test.ts +0 -89
  107. package/test/unit/lib/sanity/decorators/need-lifetime-upgrade.test.ts +0 -85
  108. package/test/unit/lib/sanity/decorators/page-type.test.ts +0 -81
  109. package/test/unit/playerSettings.test.ts +0 -73
  110. package/test/unit/progress-row/content-card.test.ts +0 -314
  111. package/test/unit/progress-row/playlist-card.test.ts +0 -104
  112. package/test/unit/progressRows.test.ts +0 -243
  113. package/test/unit/recommendations.test.js +0 -47
  114. package/test/unit/sanityQueryService.test.ts +0 -200
  115. package/test/unit/search.test.ts +0 -44
  116. package/test/unit/sentry.test.ts +0 -62
  117. package/test/unit/services/progress-internal/bubble.test.ts +0 -279
  118. package/test/unit/services/progress.test.ts +0 -396
  119. package/test/unit/streakMessage.test.ts +0 -251
  120. package/test/unit/sync/context.test.ts +0 -51
  121. package/test/unit/sync/effects/logout-warning.test.ts +0 -158
  122. package/test/unit/sync/effects/push-failure-notification.test.ts +0 -196
  123. package/test/unit/sync/errors/sync-errors.test.ts +0 -106
  124. package/test/unit/sync/errors/validators.test.ts +0 -61
  125. package/test/unit/sync/helpers/TestModel.ts +0 -44
  126. package/test/unit/sync/helpers/index.ts +0 -172
  127. package/test/unit/sync/manager.test.ts +0 -303
  128. package/test/unit/sync/models/user-award-progress.test.ts +0 -82
  129. package/test/unit/sync/resolver.test.ts +0 -229
  130. package/test/unit/sync/retry.test.ts +0 -314
  131. package/test/unit/sync/run-scope.test.ts +0 -23
  132. package/test/unit/sync/stale-record-cleanup.test.ts +0 -107
  133. package/test/unit/sync/store/push-coalescer.test.ts +0 -156
  134. package/test/unit/sync/store-configs.test.ts +0 -37
  135. package/test/unit/sync/telemetry/sync-telemetry.test.ts +0 -118
  136. package/test/unit/sync/utils/event-emitter.test.ts +0 -64
  137. package/test/unit/sync/utils/throttle.test.ts +0 -245
  138. package/test/unit/url-builder.test.ts +0 -72
  139. package/test/unit/user/account.test.ts +0 -66
  140. package/test/unit/user/permissions.test.js +0 -191
@@ -1,334 +0,0 @@
1
- import { initializeTestDB } from '../initializeTestDB'
2
- import {
3
- _getAllStartedOrCompleted,
4
- getAllCompleted,
5
- getAllCompletedByIds,
6
- getAllStarted,
7
- getAllStartedOrCompleted,
8
- getById,
9
- getByIds,
10
- getByRecordIds,
11
- getLastInteractedOf,
12
- getProgressDataByIds,
13
- getProgressDataByRecordIds,
14
- getProgressState,
15
- getProgressStateByIds,
16
- getProgressStateByRecordIds,
17
- getResumeTimeSecondsByIds,
18
- getResumeTimeSecondsByRecordIds,
19
- getStartedOrCompletedProgressOnly,
20
- } from '../../../src/services/contentProgress'
21
- import db from '../../../src/services/sync/repository-proxy'
22
-
23
- jest.mock('../../../src/services/sanity.js', () => require('./__mocks__/mocks').mockSanity())
24
- jest.mock('../../../src/services/content-org/learning-paths.ts', () => require('./__mocks__/mocks').mockLearningPaths())
25
- jest.mock('../../../src/services/awards/internal/content-progress-observer', () => require('./__mocks__/mocks').mockContentProgressObserver())
26
- jest.mock('../../../src/services/progress-events', () => require('./__mocks__/mocks').mockProgressEvents())
27
-
28
- const meta = { brand: 'drumeo', type: 'lesson', parent_id: 0 }
29
-
30
- initializeTestDB()
31
-
32
- describe('getById', () => {
33
- test('returns field value when record found', async () => {
34
- await db.contentProgress.recordProgress(100, null, 20, meta, 120, { skipPush: true })
35
- const result = await getById(100, null, 'state', '')
36
- expect(result).toBe('started')
37
- })
38
-
39
- test('returns defaultValue when record not found', async () => {
40
- const result = await getById(999, null, 'state', 'default-val')
41
- expect(result).toBe('default-val')
42
- })
43
-
44
- test('returns defaultValue when contentId is falsy', async () => {
45
- const result = await getById(0, null, 'state', 'fallback')
46
- expect(result).toBe('fallback')
47
- })
48
- })
49
-
50
- describe('getByIds', () => {
51
- test('returns Map with correct values for found ids', async () => {
52
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
53
- await db.contentProgress.recordProgress(300, null, 100, meta, undefined, { skipPush: true })
54
- const result = await getByIds([100, 300], null, 'state', '')
55
- expect(result.get(100)).toBe('started')
56
- expect(result.get(300)).toBe('completed')
57
- })
58
-
59
- test('defaults to defaultValue for missing ids', async () => {
60
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
61
- const result = await getByIds([100, 999], null, 'state', '')
62
- expect(result.get(100)).toBe('started')
63
- expect(result.get(999)).toBe('')
64
- })
65
-
66
- test('returns empty Map for empty array', async () => {
67
- const result = await getByIds([], null, 'state', '')
68
- expect(result.size).toBe(0)
69
- })
70
- })
71
-
72
- describe('getByRecordIds', () => {
73
- test('returns object with correct values for found record ids', async () => {
74
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
75
- await db.contentProgress.recordProgress(300, null, 100, meta, undefined, { skipPush: true })
76
- const result = await getByRecordIds(['100:self:0', '300:self:0'], 'state', '')
77
- expect(result['100:self:0']).toBe('started')
78
- expect(result['300:self:0']).toBe('completed')
79
- })
80
-
81
- test('defaults to defaultValue for missing record id', async () => {
82
- const result = await getByRecordIds(['999:self:0'], 'state', '')
83
- expect(result['999:self:0']).toBe('')
84
- })
85
- })
86
-
87
- describe('getProgressState', () => {
88
- test('returns started for started content', async () => {
89
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
90
- expect(await getProgressState(100)).toBe('started')
91
- })
92
-
93
- test('returns completed for completed content', async () => {
94
- await db.contentProgress.recordProgress(300, null, 100, meta, undefined, { skipPush: true })
95
- expect(await getProgressState(300)).toBe('completed')
96
- })
97
-
98
- test('returns empty string for unknown content', async () => {
99
- expect(await getProgressState(999)).toBe('')
100
- })
101
- })
102
-
103
- describe('getProgressStateByIds', () => {
104
- test('returns Map with correct states for multiple ids', async () => {
105
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
106
- await db.contentProgress.recordProgress(300, null, 100, meta, undefined, { skipPush: true })
107
- const result = await getProgressStateByIds([100, 300])
108
- expect(result.get(100)).toBe('started')
109
- expect(result.get(300)).toBe('completed')
110
- })
111
-
112
- test('defaults to empty string for unknown ids', async () => {
113
- const result = await getProgressStateByIds([999])
114
- expect(result.get(999)).toBe('')
115
- })
116
-
117
- test('returns empty Map for empty array', async () => {
118
- const result = await getProgressStateByIds([])
119
- expect(result.size).toBe(0)
120
- })
121
- })
122
-
123
- describe('getProgressStateByRecordIds', () => {
124
- test('returns correct states by record id', async () => {
125
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
126
- await db.contentProgress.recordProgress(300, null, 100, meta, undefined, { skipPush: true })
127
- const result = await getProgressStateByRecordIds(['100:self:0', '300:self:0'])
128
- expect(result['100:self:0']).toBe('started')
129
- expect(result['300:self:0']).toBe('completed')
130
- })
131
-
132
- test('returns empty string for unknown record id', async () => {
133
- const result = await getProgressStateByRecordIds(['999:self:0'])
134
- expect(result['999:self:0']).toBe('')
135
- })
136
- })
137
-
138
- describe('getResumeTimeSecondsByIds', () => {
139
- test('returns resume time when record has one', async () => {
140
- await db.contentProgress.recordProgress(100, null, 20, meta, 120, { skipPush: true })
141
- const result = await getResumeTimeSecondsByIds([100])
142
- expect(result.get(100)).toBe(120)
143
- })
144
-
145
- test('returns 0 for unknown ids', async () => {
146
- const result = await getResumeTimeSecondsByIds([999])
147
- expect(result.get(999)).toBe(0)
148
- })
149
- })
150
-
151
- describe('getResumeTimeSecondsByRecordIds', () => {
152
- test('returns correct value by record id', async () => {
153
- await db.contentProgress.recordProgress(100, null, 20, meta, 120, { skipPush: true })
154
- const result = await getResumeTimeSecondsByRecordIds(['100:self:0'])
155
- expect(result['100:self:0']).toBe(120)
156
- })
157
-
158
- test('returns 0 for unknown record id', async () => {
159
- const result = await getResumeTimeSecondsByRecordIds(['999:self:0'])
160
- expect(result['999:self:0']).toBe(0)
161
- })
162
- })
163
-
164
- describe('getProgressDataByIds', () => {
165
- test('returns correct shape for seeded content', async () => {
166
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
167
- const result = await getProgressDataByIds([100], null)
168
- expect(result[100].progress).toBe(20)
169
- expect(result[100].status).toBe('started')
170
- expect(typeof result[100].last_update).toBe('number')
171
- })
172
-
173
- test('returns defaults for unknown id', async () => {
174
- const result = await getProgressDataByIds([999], null)
175
- expect(result[999]).toEqual({ last_update: 0, progress: 0, status: '' })
176
- })
177
-
178
- test('normalizes string content ids', async () => {
179
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
180
- const result = await getProgressDataByIds(['100' as any], null)
181
- expect(result[100].progress).toBe(20)
182
- })
183
- })
184
-
185
- describe('getProgressDataByRecordIds', () => {
186
- test('returns correct shape for seeded content', async () => {
187
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
188
- const result = await getProgressDataByRecordIds(['100:self:0'])
189
- expect(result['100:self:0'].progress).toBe(20)
190
- expect(result['100:self:0'].status).toBe('started')
191
- expect(typeof result['100:self:0'].last_update).toBe('number')
192
- })
193
-
194
- test('returns defaults for unknown record id', async () => {
195
- const result = await getProgressDataByRecordIds(['999:self:0'])
196
- expect(result['999:self:0']).toEqual({ last_update: 0, progress: 0, status: '' })
197
- })
198
- })
199
-
200
- describe('getLastInteractedOf', () => {
201
- test('returns a content id from the given list when records exist', async () => {
202
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
203
- await db.contentProgress.recordProgress(200, null, 50, meta, undefined, { skipPush: true })
204
- const result = await getLastInteractedOf([100, 200])
205
- expect([100, 200]).toContain(result)
206
- })
207
-
208
- test('returns undefined when no records match', async () => {
209
- const result = await getLastInteractedOf([999])
210
- expect(result).toBeUndefined()
211
- })
212
- })
213
-
214
- describe('getAllStarted', () => {
215
- test('returns started content ids, not completed', async () => {
216
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
217
- await db.contentProgress.recordProgress(300, null, 100, meta, undefined, { skipPush: true })
218
- const result = await getAllStarted()
219
- expect(result).toContain(100)
220
- expect(result).not.toContain(300)
221
- })
222
-
223
- test('returns empty array when no started content', async () => {
224
- await db.contentProgress.recordProgress(300, null, 100, meta, undefined, { skipPush: true })
225
- expect(await getAllStarted()).toHaveLength(0)
226
- })
227
-
228
- test('respects limit', async () => {
229
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
230
- await db.contentProgress.recordProgress(200, null, 50, meta, undefined, { skipPush: true })
231
- expect(await getAllStarted(1)).toHaveLength(1)
232
- })
233
-
234
- test('onlyIds=false returns objects with content_id', async () => {
235
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
236
- const result = await getAllStarted(null, { onlyIds: false })
237
- expect(result[0]).toHaveProperty('content_id', 100)
238
- })
239
- })
240
-
241
- describe('getAllCompleted', () => {
242
- test('returns completed content ids, not started', async () => {
243
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
244
- await db.contentProgress.recordProgress(300, null, 100, meta, undefined, { skipPush: true })
245
- const result = await getAllCompleted()
246
- expect(result).toContain(300)
247
- expect(result).not.toContain(100)
248
- })
249
-
250
- test('returns empty array when no completed content', async () => {
251
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
252
- expect(await getAllCompleted()).toHaveLength(0)
253
- })
254
-
255
- test('respects limit', async () => {
256
- await db.contentProgress.recordProgress(300, null, 100, meta, undefined, { skipPush: true })
257
- await db.contentProgress.recordProgress(400, null, 100, meta, undefined, { skipPush: true })
258
- expect(await getAllCompleted(1)).toHaveLength(1)
259
- })
260
- })
261
-
262
- describe('getAllCompletedByIds', () => {
263
- test('returns only completed records within given ids', async () => {
264
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
265
- await db.contentProgress.recordProgress(300, null, 100, meta, undefined, { skipPush: true })
266
- await db.contentProgress.recordProgress(400, null, 100, meta, undefined, { skipPush: true })
267
- const result = await getAllCompletedByIds([100, 300, 400])
268
- const completedIds = result.data.map((r: any) => r.content_id)
269
- expect(completedIds).toContain(300)
270
- expect(completedIds).toContain(400)
271
- expect(completedIds).not.toContain(100)
272
- })
273
-
274
- test('returns empty data array when no completed records match', async () => {
275
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
276
- const result = await getAllCompletedByIds([100])
277
- expect(result.data).toHaveLength(0)
278
- })
279
- })
280
-
281
- describe('getAllStartedOrCompleted', () => {
282
- test('returns ids for both started and completed records', async () => {
283
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
284
- await db.contentProgress.recordProgress(300, null, 100, meta, undefined, { skipPush: true })
285
- const result = await getAllStartedOrCompleted()
286
- expect(result).toContain(100)
287
- expect(result).toContain(300)
288
- })
289
-
290
- test('respects limit', async () => {
291
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
292
- await db.contentProgress.recordProgress(300, null, 100, meta, undefined, { skipPush: true })
293
- await db.contentProgress.recordProgress(400, null, 100, meta, undefined, { skipPush: true })
294
- const result = await getAllStartedOrCompleted({ limit: 2 })
295
- expect(result).toHaveLength(2)
296
- })
297
-
298
- test('onlyIds=false returns full record objects', async () => {
299
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
300
- const result = await getAllStartedOrCompleted({ onlyIds: false })
301
- expect(result[0]).toHaveProperty('content_id')
302
- expect(result[0]).toHaveProperty('state')
303
- expect(result[0]).toHaveProperty('progress_percent')
304
- })
305
- })
306
-
307
- describe('_getAllStartedOrCompleted', () => {
308
- test('returns all started and completed records', async () => {
309
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
310
- await db.contentProgress.recordProgress(300, null, 100, meta, undefined, { skipPush: true })
311
- const result = await _getAllStartedOrCompleted()
312
- const ids = result.map((r: any) => r.content_id)
313
- expect(ids).toContain(100)
314
- expect(ids).toContain(300)
315
- })
316
-
317
- test('respects limit', async () => {
318
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
319
- await db.contentProgress.recordProgress(300, null, 100, meta, undefined, { skipPush: true })
320
- await db.contentProgress.recordProgress(400, null, 100, meta, undefined, { skipPush: true })
321
- const result = await _getAllStartedOrCompleted({ limit: 2 })
322
- expect(result).toHaveLength(2)
323
- })
324
- })
325
-
326
- describe('getStartedOrCompletedProgressOnly', () => {
327
- test('returns map of content_id to progress_percent', async () => {
328
- await db.contentProgress.recordProgress(100, null, 20, meta, undefined, { skipPush: true })
329
- await db.contentProgress.recordProgress(300, null, 100, meta, undefined, { skipPush: true })
330
- const result = await getStartedOrCompletedProgressOnly()
331
- expect(result[100]).toBe(20)
332
- expect(result[300]).toBe(100)
333
- })
334
- })
@@ -1,263 +0,0 @@
1
- import { initializeTestDB } from '../initializeTestDB'
2
- import {
3
- bubbleAndTrickleProgressesSafely,
4
- duplicateProgressToALaCarte,
5
- getIdsWhereLastAccessedFromMethod,
6
- getProgressState,
7
- handleLearningPathProgressActions,
8
- } from '../../../src/services/contentProgress'
9
- import { COLLECTION_ID_SELF, COLLECTION_TYPE } from '../../../src/services/sync/models/ContentProgress'
10
- import db from '../../../src/services/sync/repository-proxy'
11
-
12
- jest.mock('../../../src/services/sanity.js', () => require('./__mocks__/mocks').mockSanity())
13
- jest.mock('../../../src/services/content-org/learning-paths.ts', () => require('./__mocks__/mocks').mockLearningPaths())
14
- jest.mock('../../../src/services/awards/internal/content-progress-observer', () => require('./__mocks__/mocks').mockContentProgressObserver())
15
- jest.mock('../../../src/services/progress-events', () => require('./__mocks__/mocks').mockProgressEvents())
16
-
17
- const meta = { brand: 'drumeo', type: 'lesson', parent_id: 0 }
18
- const collectionSelf = { type: COLLECTION_TYPE.SELF, id: COLLECTION_ID_SELF }
19
- const collectionLP = (id: number) => ({ type: COLLECTION_TYPE.LEARNING_PATH, id })
20
-
21
- const ctx = initializeTestDB()
22
-
23
- const flushPromises = async () => {
24
- for (let i = 0; i < 200; i++) {
25
- await new Promise(resolve => setImmediate(resolve))
26
- }
27
- }
28
-
29
- // ─── bubbleAndTrickleProgressesSafely ─────────────────────────────────────────
30
-
31
- describe('bubbleAndTrickleProgressesSafely', () => {
32
- test('non-reset writes records to DB', async () => {
33
- const progresses = { 101: 50, 102: 75 }
34
- const metadata = { 101: meta, 102: meta }
35
- await bubbleAndTrickleProgressesSafely(progresses, collectionSelf, metadata)
36
- expect(await getProgressState(101)).toBe('started')
37
- expect(await getProgressState(102)).toBe('started')
38
- expect(ctx.pushSpies.contentProgress).not.toHaveBeenCalled()
39
- })
40
-
41
- test('non-reset with correct progress values', async () => {
42
- const progresses = { 101: 50 }
43
- const metadata = { 101: meta }
44
- await bubbleAndTrickleProgressesSafely(progresses, collectionSelf, metadata)
45
- const record = await db.contentProgress.getOneProgressByContentId(101, null)
46
- expect(record.data?.progress_percent).toBe(50)
47
- expect(ctx.pushSpies.contentProgress).not.toHaveBeenCalled()
48
- })
49
-
50
- test('non-reset with empty progresses does not create records', async () => {
51
- await bubbleAndTrickleProgressesSafely({}, collectionSelf, {})
52
- const record = await db.contentProgress.getOneProgressByContentId(101, null)
53
- expect(record.data).toBeNull()
54
- expect(ctx.pushSpies.contentProgress).not.toHaveBeenCalled()
55
- })
56
-
57
- test('reset action with all positive values writes records', async () => {
58
- const progresses = { 101: 50, 102: 75 }
59
- const metadata = { 101: meta, 102: meta }
60
- await bubbleAndTrickleProgressesSafely(progresses, collectionSelf, metadata, { isResetAction: true })
61
- expect(await getProgressState(101)).toBe('started')
62
- expect(await getProgressState(102)).toBe('started')
63
- expect(ctx.pushSpies.contentProgress).not.toHaveBeenCalled()
64
- })
65
-
66
- test('reset action with all zero values erases records', async () => {
67
- await db.contentProgress.recordProgress(101, null, 50, meta, undefined, { skipPush: true })
68
- expect(await getProgressState(101)).toBe('started')
69
- await bubbleAndTrickleProgressesSafely({ 101: 0 }, collectionSelf, {}, { isResetAction: true })
70
- expect(await getProgressState(101)).toBe('')
71
- expect(ctx.pushSpies.contentProgress).not.toHaveBeenCalled()
72
- })
73
-
74
- test('reset action with mixed values writes positive and erases zeros', async () => {
75
- await db.contentProgress.recordProgress(101, null, 50, meta, undefined, { skipPush: true })
76
- const metadata = { 102: meta }
77
- await bubbleAndTrickleProgressesSafely({ 101: 0, 102: 60 }, collectionSelf, metadata, { isResetAction: true })
78
- expect(await getProgressState(101)).toBe('')
79
- expect(await getProgressState(102)).toBe('started')
80
- expect(ctx.pushSpies.contentProgress).not.toHaveBeenCalled()
81
- })
82
-
83
- test('collection normalized — null collection writes to SELF', async () => {
84
- const progresses = { 101: 50 }
85
- const metadata = { 101: meta }
86
- await bubbleAndTrickleProgressesSafely(progresses, null as any, metadata)
87
- const record = await db.contentProgress.getOneProgressByContentId(101, null)
88
- expect(record.data?.collection_type).toBe(COLLECTION_TYPE.SELF)
89
- expect(ctx.pushSpies.contentProgress).not.toHaveBeenCalled()
90
- })
91
-
92
- test('bubble lowers parent from 100% to 50% via allowRegression', async () => {
93
- await db.contentProgress.recordProgress(1, null, 100, meta, undefined, { skipPush: true })
94
- expect((await db.contentProgress.getOneProgressByContentId(1, null)).data?.progress_percent).toBe(100)
95
-
96
- await bubbleAndTrickleProgressesSafely({ 1: 50 }, collectionSelf, { 1: meta })
97
-
98
- const record = await db.contentProgress.getOneProgressByContentId(1, null)
99
- expect(record.data?.progress_percent).toBe(50)
100
- expect(ctx.pushSpies.contentProgress).not.toHaveBeenCalled()
101
- })
102
- })
103
-
104
- // ─── handleLearningPathProgressActions ────────────────────────────────────────
105
-
106
- describe('handleLearningPathProgressActions', () => {
107
- const mockLearningPaths = jest.requireMock('../../../src/services/content-org/learning-paths.ts')
108
-
109
- beforeEach(() => {
110
- mockLearningPaths.onLearningPathCompletedActions.mockClear()
111
- })
112
-
113
- test('non-LP collection returns without action', async () => {
114
- await handleLearningPathProgressActions({ 101: 100 }, collectionSelf)
115
- await flushPromises()
116
- expect(mockLearningPaths.onLearningPathCompletedActions).not.toHaveBeenCalled()
117
- expect(ctx.pushSpies.contentProgress).not.toHaveBeenCalled()
118
- })
119
-
120
- test('LP id at 100% calls onLearningPathCompletedActions', async () => {
121
- await handleLearningPathProgressActions({ 200: 100 }, collectionLP(200))
122
- await flushPromises()
123
- expect(mockLearningPaths.onLearningPathCompletedActions).toHaveBeenCalledWith(200)
124
- expect(ctx.pushSpies.contentProgress).not.toHaveBeenCalled()
125
- })
126
-
127
- test('non-LP-id child at 100% does not call onLearningPathCompletedActions', async () => {
128
- await handleLearningPathProgressActions({ 101: 100 }, collectionLP(200))
129
- await flushPromises()
130
- expect(mockLearningPaths.onLearningPathCompletedActions).not.toHaveBeenCalled()
131
- expect(ctx.pushSpies.contentProgress).not.toHaveBeenCalled()
132
- })
133
-
134
- test('LP id at <100% does not call onLearningPathCompletedActions', async () => {
135
- await handleLearningPathProgressActions({ 200: 50 }, collectionLP(200))
136
- await flushPromises()
137
- expect(mockLearningPaths.onLearningPathCompletedActions).not.toHaveBeenCalled()
138
- expect(ctx.pushSpies.contentProgress).not.toHaveBeenCalled()
139
- })
140
-
141
- test('LP id + children at 100% calls onLearningPathCompletedActions once for LP id only', async () => {
142
- await handleLearningPathProgressActions({ 200: 100, 101: 100, 102: 100 }, collectionLP(200))
143
- await flushPromises()
144
- expect(mockLearningPaths.onLearningPathCompletedActions).toHaveBeenCalledTimes(1)
145
- expect(mockLearningPaths.onLearningPathCompletedActions).toHaveBeenCalledWith(200)
146
- expect(ctx.pushSpies.contentProgress).not.toHaveBeenCalled()
147
- })
148
-
149
- test('LP collection duplicates lesson progress to SELF records', async () => {
150
- await handleLearningPathProgressActions({ 101: 50 }, collectionLP(200))
151
- await flushPromises()
152
- const record = await db.contentProgress.getOneProgressByContentId(101, null)
153
- expect(record.data?.progress_percent).toBe(50)
154
- expect(record.data?.collection_type).toBe(COLLECTION_TYPE.SELF)
155
- expect(ctx.pushSpies.contentProgress).not.toHaveBeenCalled()
156
- })
157
- })
158
-
159
- // ─── duplicateProgressToALaCarte ─────────────────────────────────────────────
160
-
161
- describe('duplicateProgressToALaCarte', () => {
162
- test('writes SELF records for a-la-carte collection', async () => {
163
- await duplicateProgressToALaCarte({ 101: 50 }, collectionSelf)
164
- await flushPromises()
165
- const record = await db.contentProgress.getOneProgressByContentId(101, null)
166
- expect(record.data?.collection_type).toBe(COLLECTION_TYPE.SELF)
167
- expect(ctx.pushSpies.contentProgress).not.toHaveBeenCalled()
168
- })
169
-
170
- test('LP collection excludes the LP id itself from duplication', async () => {
171
- await duplicateProgressToALaCarte({ 200: 50, 101: 75 }, collectionLP(200))
172
- await flushPromises()
173
- const lpRecord = await db.contentProgress.getOneProgressByContentId(200, null)
174
- const lessonRecord = await db.contentProgress.getOneProgressByContentId(101, null)
175
- expect(lpRecord.data).toBeNull()
176
- expect(lessonRecord.data?.progress_percent).toBe(75)
177
- expect(ctx.pushSpies.contentProgress).not.toHaveBeenCalled()
178
- })
179
-
180
- test('lower progress than existing is filtered — existing stays unchanged', async () => {
181
- await db.contentProgress.recordProgress(101, null, 80, meta, undefined, { skipPush: true })
182
- await duplicateProgressToALaCarte({ 101: 50 }, collectionSelf)
183
- await flushPromises()
184
- const record = await db.contentProgress.getOneProgressByContentId(101, null)
185
- expect(record.data?.progress_percent).toBe(80)
186
- expect(ctx.pushSpies.contentProgress).not.toHaveBeenCalled()
187
- })
188
-
189
- test('equal progress passes and record is updated', async () => {
190
- await db.contentProgress.recordProgress(101, null, 50, meta, undefined, { skipPush: true })
191
- await duplicateProgressToALaCarte({ 101: 50 }, collectionSelf)
192
- await flushPromises()
193
- const record = await db.contentProgress.getOneProgressByContentId(101, null)
194
- expect(record.data?.progress_percent).toBe(50)
195
- expect(ctx.pushSpies.contentProgress).not.toHaveBeenCalled()
196
- })
197
-
198
- test('empty progresses results in no new records', async () => {
199
- await duplicateProgressToALaCarte({}, collectionSelf)
200
- await flushPromises()
201
- const record = await db.contentProgress.getOneProgressByContentId(101, null)
202
- expect(record.data).toBeNull()
203
- expect(ctx.pushSpies.contentProgress).not.toHaveBeenCalled()
204
- })
205
- })
206
-
207
- // ─── getIdsWhereLastAccessedFromMethod ────────────────────────────────────────
208
-
209
- describe('getIdsWhereLastAccessedFromMethod', () => {
210
- test('returns content_ids from records where last_interacted_a_la_carte is null', async () => {
211
- await db.contentProgress.recordProgress(101, null, 50, meta, undefined, { skipPush: true, accessedDirectly: false })
212
- const result = await getIdsWhereLastAccessedFromMethod([101])
213
- expect(result).toContain(101)
214
- })
215
-
216
- test('returns empty array when no records match', async () => {
217
- const result = await getIdsWhereLastAccessedFromMethod([999])
218
- expect(result).toEqual([])
219
- })
220
-
221
- test('normalizes string content ids before querying', async () => {
222
- await db.contentProgress.recordProgress(101, null, 50, meta, undefined, { skipPush: true, accessedDirectly: false })
223
- const result = await getIdsWhereLastAccessedFromMethod(['101'] as any)
224
- expect(result).toContain(101)
225
- })
226
- })
227
-
228
- // ─── Scenario: LP lesson completion ───────────────────────────────────────────
229
-
230
- describe('Scenario: LP lesson at 100% triggers completion and duplicates to a-la-carte', () => {
231
- const mockLearningPaths = jest.requireMock('../../../src/services/content-org/learning-paths.ts')
232
-
233
- beforeEach(() => {
234
- mockLearningPaths.onLearningPathCompletedActions.mockClear()
235
- })
236
-
237
- test('LP id 200 at 100% calls onLearningPathCompletedActions; lesson at 100% writes SELF record', async () => {
238
- await handleLearningPathProgressActions({ 200: 100, 101: 100 }, collectionLP(200))
239
- await flushPromises()
240
- expect(mockLearningPaths.onLearningPathCompletedActions).toHaveBeenCalledTimes(1)
241
- expect(mockLearningPaths.onLearningPathCompletedActions).toHaveBeenCalledWith(200)
242
- const selfRecord = await db.contentProgress.getOneProgressByContentId(101, null)
243
- expect(selfRecord.data?.progress_percent).toBe(100)
244
- expect(ctx.pushSpies.contentProgress).not.toHaveBeenCalled()
245
- })
246
- })
247
-
248
- describe('Scenario: Offline LP progress skips award check', () => {
249
- const mockLearningPaths = jest.requireMock('../../../src/services/content-org/learning-paths.ts')
250
-
251
- beforeEach(() => {
252
- mockLearningPaths.onLearningPathCompletedActions.mockClear()
253
- })
254
-
255
- test('isOffline=true writes SELF record but skips onLearningPathCompletedActions', async () => {
256
- await handleLearningPathProgressActions({ 101: 100 }, collectionLP(200), { isOffline: true })
257
- await flushPromises()
258
- expect(mockLearningPaths.onLearningPathCompletedActions).not.toHaveBeenCalled()
259
- const selfRecord = await db.contentProgress.getOneProgressByContentId(101, null)
260
- expect(selfRecord.data?.progress_percent).toBe(100)
261
- expect(ctx.pushSpies.contentProgress).not.toHaveBeenCalled()
262
- })
263
- })