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,174 +0,0 @@
1
- import { FetchQueryExecutor } from '../../../../src/infrastructure/sanity/executors/FetchQueryExecutor'
2
- import { SanityConfig } from '../../../../src/infrastructure/sanity/interfaces/SanityConfig'
3
-
4
- describe('FetchQueryExecutor', () => {
5
- const baseConfig: SanityConfig = {
6
- projectId: 'proj',
7
- dataset: 'prod',
8
- version: '2021-06-07',
9
- token: 'tok',
10
- }
11
-
12
- let fetchMock: jest.Mock
13
- const originalFetch = global.fetch
14
-
15
- beforeEach(() => {
16
- fetchMock = jest.fn()
17
- global.fetch = fetchMock as any
18
- })
19
-
20
- afterEach(() => {
21
- global.fetch = originalFetch
22
- })
23
-
24
- function makeResponse(body: any, ok = true, status = 200, statusText = 'OK'): Response {
25
- return {
26
- ok,
27
- status,
28
- statusText,
29
- json: async () => body,
30
- } as any
31
- }
32
-
33
- test('posts to non-cached endpoint with default published perspective', async () => {
34
- fetchMock.mockResolvedValue(makeResponse({ result: [], ms: 1, query: 'q' }))
35
- const executor = new FetchQueryExecutor()
36
- await executor.execute({ query: 'q', params: { a: 1 } }, baseConfig)
37
-
38
- expect(fetchMock).toHaveBeenCalledTimes(1)
39
- const [url, options] = fetchMock.mock.calls[0]
40
- expect(url).toBe(
41
- 'https://proj.api.sanity.io/v2021-06-07/data/query/prod?perspective=published'
42
- )
43
- expect(options.method).toBe('POST')
44
- expect(options.headers['Authorization']).toBe('Bearer tok')
45
- expect(options.headers['Content-Type']).toBe('application/json')
46
- expect(options.body).toBe(JSON.stringify({ query: 'q', params: { a: 1 } }))
47
- })
48
-
49
- test('uses apicdn endpoint when useCachedAPI is true', async () => {
50
- fetchMock.mockResolvedValue(makeResponse({ result: [] }))
51
- const executor = new FetchQueryExecutor()
52
- await executor.execute({ query: 'q' }, { ...baseConfig, useCachedAPI: true })
53
-
54
- expect(fetchMock.mock.calls[0][0]).toBe(
55
- 'https://proj.apicdn.sanity.io/v2021-06-07/data/query/prod?perspective=published&query=q'
56
- )
57
- })
58
-
59
- test('uses GET with encoded query when no params and URL under length limit', async () => {
60
- fetchMock.mockResolvedValue(makeResponse({ result: [] }))
61
- const executor = new FetchQueryExecutor()
62
- await executor.execute({ query: '*[_type == "foo"]' }, baseConfig)
63
-
64
- const [url, options] = fetchMock.mock.calls[0]
65
- expect(url).toBe(
66
- 'https://proj.api.sanity.io/v2021-06-07/data/query/prod?perspective=published&query=' +
67
- encodeURIComponent('*[_type == "foo"]')
68
- )
69
- expect(options.method).toBe('GET')
70
- expect(options.headers['Authorization']).toBe('Bearer tok')
71
- expect(options.body).toBeUndefined()
72
- })
73
-
74
- test('falls back to POST when params are provided', async () => {
75
- fetchMock.mockResolvedValue(makeResponse({ result: [] }))
76
- const executor = new FetchQueryExecutor()
77
- await executor.execute({ query: 'q', params: { id: 1 } }, baseConfig)
78
-
79
- const [url, options] = fetchMock.mock.calls[0]
80
- expect(url).toBe(
81
- 'https://proj.api.sanity.io/v2021-06-07/data/query/prod?perspective=published'
82
- )
83
- expect(options.method).toBe('POST')
84
- expect(options.body).toBe(JSON.stringify({ query: 'q', params: { id: 1 } }))
85
- })
86
-
87
- test('falls back to POST when GET URL would exceed length limit', async () => {
88
- fetchMock.mockResolvedValue(makeResponse({ result: [] }))
89
- const executor = new FetchQueryExecutor()
90
- const longQuery = 'a'.repeat(8001)
91
- await executor.execute({ query: longQuery }, baseConfig)
92
-
93
- const [url, options] = fetchMock.mock.calls[0]
94
- expect(url).toBe(
95
- 'https://proj.api.sanity.io/v2021-06-07/data/query/prod?perspective=published'
96
- )
97
- expect(options.method).toBe('POST')
98
- expect(options.body).toBe(JSON.stringify({ query: longQuery }))
99
- })
100
-
101
- test('honours custom perspective', async () => {
102
- fetchMock.mockResolvedValue(makeResponse({ result: [] }))
103
- const executor = new FetchQueryExecutor()
104
- await executor.execute({ query: 'q' }, { ...baseConfig, perspective: 'previewDrafts' })
105
-
106
- expect(fetchMock.mock.calls[0][0]).toContain('perspective=previewDrafts')
107
- })
108
-
109
- test('returns parsed response body on success', async () => {
110
- const body = { result: [{ id: 1 }], ms: 4, query: 'q' }
111
- fetchMock.mockResolvedValue(makeResponse(body))
112
- const executor = new FetchQueryExecutor()
113
- const out = await executor.execute({ query: 'q' }, baseConfig)
114
- expect(out).toEqual(body)
115
- })
116
-
117
- test('throws SanityError using response body message when fetch is not ok', async () => {
118
- fetchMock.mockResolvedValue(
119
- makeResponse({ message: 'GROQ parse error' }, false, 400, 'Bad Request')
120
- )
121
- const executor = new FetchQueryExecutor()
122
- await expect(executor.execute({ query: 'q', params: { a: 1 } }, baseConfig)).rejects.toMatchObject({
123
- message: 'GROQ parse error',
124
- query: 'q',
125
- params: { a: 1 },
126
- })
127
- })
128
-
129
- test('falls back to status/statusText when error body cannot be parsed', async () => {
130
- const response = {
131
- ok: false,
132
- status: 500,
133
- statusText: 'Server Error',
134
- json: async () => {
135
- throw new Error('not json')
136
- },
137
- } as any
138
- fetchMock.mockResolvedValue(response)
139
- const executor = new FetchQueryExecutor()
140
- await expect(executor.execute({ query: 'q' }, baseConfig)).rejects.toMatchObject({
141
- message: 'Sanity API error: 500 - Server Error',
142
- query: 'q',
143
- })
144
- })
145
-
146
- test('wraps thrown network errors as SanityError', async () => {
147
- const networkErr = new Error('connection refused')
148
- fetchMock.mockRejectedValue(networkErr)
149
- const executor = new FetchQueryExecutor()
150
- await expect(executor.execute({ query: 'q' }, baseConfig)).rejects.toMatchObject({
151
- message: 'connection refused',
152
- query: 'q',
153
- originalError: networkErr,
154
- })
155
- })
156
-
157
- test('does not re-wrap an existing SanityError', async () => {
158
- const sanityErr = { message: 'already wrapped', query: 'q' }
159
- fetchMock.mockRejectedValue(sanityErr)
160
- const executor = new FetchQueryExecutor()
161
- await expect(executor.execute({ query: 'q' }, baseConfig)).rejects.toEqual(sanityErr)
162
- })
163
-
164
- test('debug mode logs query and result', async () => {
165
- const logSpy = jest.spyOn(console, 'log').mockImplementation(() => {})
166
- const body = { result: [], ms: 1, query: 'q' }
167
- fetchMock.mockResolvedValue(makeResponse(body))
168
- const executor = new FetchQueryExecutor()
169
- await executor.execute({ query: 'dbg' }, { ...baseConfig, debug: true })
170
- expect(logSpy).toHaveBeenCalledWith('Sanity Query:', 'dbg')
171
- expect(logSpy).toHaveBeenCalledWith('Sanity Results:', body)
172
- logSpy.mockRestore()
173
- })
174
- })
@@ -1,140 +0,0 @@
1
- import { SanityClient } from '../../../../src/infrastructure/sanity/SanityClient'
2
- import { ConfigProvider } from '../../../../src/infrastructure/sanity/interfaces/ConfigProvider'
3
- import { QueryExecutor } from '../../../../src/infrastructure/sanity/interfaces/QueryExecutor'
4
- import { SanityConfig } from '../../../../src/infrastructure/sanity/interfaces/SanityConfig'
5
-
6
- describe('SanityClient', () => {
7
- const config: SanityConfig = {
8
- projectId: 'p',
9
- dataset: 'd',
10
- version: '2021-06-07',
11
- token: 't',
12
- }
13
- let mockConfigProvider: jest.Mocked<ConfigProvider>
14
- let mockExecutor: jest.Mocked<QueryExecutor>
15
- let client: SanityClient
16
-
17
- beforeEach(() => {
18
- mockConfigProvider = {
19
- getConfig: jest.fn().mockReturnValue(config),
20
- }
21
- mockExecutor = {
22
- execute: jest.fn(),
23
- }
24
- client = new SanityClient(mockConfigProvider, mockExecutor)
25
- })
26
-
27
- describe('fetchSingle', () => {
28
- test('returns first item from result array', async () => {
29
- mockExecutor.execute.mockResolvedValue({
30
- result: [{ id: 1 }, { id: 2 }],
31
- ms: 5,
32
- query: 'q',
33
- })
34
- const result = await client.fetchSingle<{ id: number }>('*[_type=="x"]', { a: 1 })
35
- expect(result).toEqual({ id: 1 })
36
- expect(mockExecutor.execute).toHaveBeenCalledWith(
37
- { query: '*[_type=="x"]', params: { a: 1 } },
38
- config
39
- )
40
- })
41
-
42
- test('returns null when result array is empty', async () => {
43
- mockExecutor.execute.mockResolvedValue({ result: [], ms: 1, query: 'q' })
44
- expect(await client.fetchSingle('q')).toBeNull()
45
- })
46
-
47
- test('returns null when result is not an array', async () => {
48
- mockExecutor.execute.mockResolvedValue({ result: { id: 1 } as any, ms: 1, query: 'q' })
49
- expect(await client.fetchSingle('q')).toBeNull()
50
- })
51
-
52
- test('rethrows SanityError unchanged and returns nothing useful', async () => {
53
- const sanityError = { message: 'boom', query: 'q' }
54
- mockExecutor.execute.mockRejectedValue(sanityError)
55
- await expect(client.fetchSingle('q')).rejects.toEqual(sanityError)
56
- })
57
-
58
- test('wraps non-SanityError as SanityError including query and originalError', async () => {
59
- const raw = new Error('network down')
60
- mockExecutor.execute.mockRejectedValue(raw)
61
- await expect(client.fetchSingle('myquery')).rejects.toMatchObject({
62
- message: 'network down',
63
- query: 'myquery',
64
- originalError: raw,
65
- })
66
- })
67
- })
68
-
69
- describe('fetchList', () => {
70
- test('returns result array', async () => {
71
- const data = [{ id: 1 }, { id: 2 }]
72
- mockExecutor.execute.mockResolvedValue({ result: data, ms: 1, query: 'q' })
73
- const result = await client.fetchList('q')
74
- expect(result).toEqual(data)
75
- })
76
-
77
- test('returns empty array when result is null/undefined', async () => {
78
- mockExecutor.execute.mockResolvedValue({ result: null as any, ms: 1, query: 'q' })
79
- expect(await client.fetchList('q')).toEqual([])
80
- })
81
-
82
- test('rethrows existing SanityError', async () => {
83
- const sanityError = { message: 'boom', query: 'q' }
84
- mockExecutor.execute.mockRejectedValue(sanityError)
85
- await expect(client.fetchList('q')).rejects.toEqual(sanityError)
86
- })
87
-
88
- test('wraps non-SanityError as SanityError', async () => {
89
- mockExecutor.execute.mockRejectedValue(new Error('fail'))
90
- await expect(client.fetchList('q')).rejects.toMatchObject({
91
- message: 'fail',
92
- query: 'q',
93
- })
94
- })
95
- })
96
-
97
- describe('executeQuery', () => {
98
- test('returns the raw result', async () => {
99
- mockExecutor.execute.mockResolvedValue({ result: { count: 7 }, ms: 1, query: 'q' })
100
- const result = await client.executeQuery<{ count: number }>('q')
101
- expect(result).toEqual({ count: 7 })
102
- })
103
-
104
- test('returns null when result is missing', async () => {
105
- mockExecutor.execute.mockResolvedValue({ result: null as any, ms: 1, query: 'q' })
106
- expect(await client.executeQuery('q')).toBeNull()
107
- })
108
-
109
- test('rethrows wrapped error on failure', async () => {
110
- mockExecutor.execute.mockRejectedValue(new Error('explode'))
111
- await expect(client.executeQuery('q')).rejects.toMatchObject({
112
- message: 'explode',
113
- query: 'q',
114
- })
115
- })
116
- })
117
-
118
- describe('config caching', () => {
119
- test('loads config once across multiple calls', async () => {
120
- mockExecutor.execute.mockResolvedValue({ result: [], ms: 1, query: 'q' })
121
- await client.fetchList('q1')
122
- await client.fetchList('q2')
123
- await client.fetchSingle('q3')
124
- expect(mockConfigProvider.getConfig).toHaveBeenCalledTimes(1)
125
- })
126
-
127
- test('refreshConfig forces a reload on the next call', async () => {
128
- mockExecutor.execute.mockResolvedValue({ result: [], ms: 1, query: 'q' })
129
- await client.fetchList('q1')
130
- client.refreshConfig()
131
- await client.fetchList('q2')
132
- expect(mockConfigProvider.getConfig).toHaveBeenCalledTimes(2)
133
- })
134
- })
135
-
136
- test('falls back to default providers when none are supplied', () => {
137
- const defaultClient = new SanityClient()
138
- expect(defaultClient).toBeInstanceOf(SanityClient)
139
- })
140
- })
@@ -1,5 +0,0 @@
1
- // Jest Snapshot v1, https://goo.gl/fbAQLP
2
-
3
- exports[`Filters - Async Methods (Integration) Integration & Edge Cases snapshot: admin complete filter 1`] = `"status in ['draft','scheduled','published','archived','unlisted'] && published_on <= "2024-01-15T14:01:00.000Z" && !defined(deprecated_railcontent_id)"`;
4
-
5
- exports[`Filters - Async Methods (Integration) Integration & Edge Cases snapshot: free user complete filter 1`] = `"status in ['scheduled','published'] && ((!defined(permission_v2) || count(permission_v2) == 0)) && published_on <= "2024-01-15T14:01:00.000Z" && !defined(deprecated_railcontent_id)"`;