@beechcms/api 0.6.0-preview.1 → 0.6.0-preview.2

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 (222) hide show
  1. package/assets/dashboard/BeechLogo.svg +18 -18
  2. package/assets/dashboard/BeechLogoLIght.svg +48 -48
  3. package/assets/dashboard/assets/chart-BrJFdsGZ.js +39 -0
  4. package/assets/dashboard/assets/index-CIaoMxuB.css +1 -0
  5. package/assets/dashboard/assets/index-wTKgygsg.js +636 -0
  6. package/assets/dashboard/assets/pie-chart-recharts-BEaE1FOE.js +1 -0
  7. package/assets/dashboard/assets/timeseries-chart-recharts-DmWM6imF.js +1 -0
  8. package/assets/dashboard/beechLogoDark.svg +48 -48
  9. package/assets/dashboard/index.html +18 -18
  10. package/assets/dashboard/noResult.svg +42 -42
  11. package/assets/dashboard/sol.svg +3 -3
  12. package/assets/dashboard/undraw_enter_nwx3.svg +36 -36
  13. package/migrations/0000_v040_base.sql +265 -265
  14. package/migrations/0029_automations.sql +14 -14
  15. package/migrations/0030_test_seeds.sql +125 -125
  16. package/package.json +2 -2
  17. package/src/auth/__fixtures__/in-memory-hash-provider.ts +17 -17
  18. package/src/auth/__fixtures__/static-token-service.ts +22 -22
  19. package/src/auth/bcrypt-hash-provider.ts +24 -24
  20. package/src/auth/constants.ts +14 -14
  21. package/src/auth/generate-refresh-token.test.ts +23 -23
  22. package/src/auth/hash-provider.test.ts +55 -55
  23. package/src/auth/jose-token-service.ts +62 -62
  24. package/src/auth/jwt-claims-passthrough.test.ts +87 -87
  25. package/src/auth/login.test.ts +100 -100
  26. package/src/auth/login.ts +78 -78
  27. package/src/auth/refresh.ts +11 -11
  28. package/src/auth/token-service.test.ts +90 -90
  29. package/src/factory.ts +370 -368
  30. package/src/features/automations/__tests__/action-executors.test.ts +255 -255
  31. package/src/features/automations/__tests__/automation-runner.test.ts +196 -196
  32. package/src/features/automations/__tests__/automation-runner.utils.test.ts +60 -60
  33. package/src/features/automations/__tests__/automations.handler.test.ts +264 -264
  34. package/src/features/automations/__tests__/automations.repository.test.ts +163 -163
  35. package/src/features/automations/__tests__/automations.schema.test.ts +224 -224
  36. package/src/features/automations/__tests__/context-resolver.test.ts +126 -126
  37. package/src/features/automations/__tests__/cron-runner.test.ts +267 -267
  38. package/src/features/automations/__tests__/cron-runner.utils.test.ts +144 -144
  39. package/src/features/automations/__tests__/set-variable.executor.test.ts +383 -383
  40. package/src/features/automations/__tests__/template-grammar.test.ts +308 -308
  41. package/src/features/automations/__tests__/webhook.executor.test.ts +142 -142
  42. package/src/features/automations/__tests__/when-evaluator.test.ts +274 -274
  43. package/src/features/automations/__tests__/when-pushdown.test.ts +281 -281
  44. package/src/features/automations/action-executors/create-entry.executor.ts +27 -27
  45. package/src/features/automations/action-executors/edit-field.executor.ts +26 -26
  46. package/src/features/automations/action-executors/index.ts +37 -37
  47. package/src/features/automations/action-executors/send-mail.executor.ts +53 -53
  48. package/src/features/automations/action-executors/set-variable.executor.ts +159 -159
  49. package/src/features/automations/action-executors/webhook.executor.ts +67 -67
  50. package/src/features/automations/automation-runner.ts +85 -85
  51. package/src/features/automations/automation-runner.utils.ts +47 -47
  52. package/src/features/automations/automations.handler.ts +197 -197
  53. package/src/features/automations/automations.schema.ts +177 -177
  54. package/src/features/automations/context-resolver.ts +152 -152
  55. package/src/features/automations/cron-runner.ts +140 -140
  56. package/src/features/automations/cron-runner.utils.ts +44 -44
  57. package/src/features/automations/filter-translation.ts +46 -46
  58. package/src/features/automations/index.ts +16 -16
  59. package/src/features/automations/template-grammar.ts +245 -245
  60. package/src/features/automations/var-access-resolver.ts +140 -140
  61. package/src/features/automations/when-evaluator.ts +87 -87
  62. package/src/features/automations/when-pushdown.ts +57 -57
  63. package/src/features/backrefs/__tests__/backrefs.handler.test.ts +359 -359
  64. package/src/features/backrefs/backrefs.handler.ts +168 -168
  65. package/src/features/backrefs/d1-backref.repository.ts +84 -84
  66. package/src/features/backrefs/index.ts +5 -5
  67. package/src/features/content/constants.ts +16 -16
  68. package/src/features/content/handlers/bulk.handler.ts +185 -185
  69. package/src/features/content/handlers/create.ts +129 -129
  70. package/src/features/content/handlers/delete.ts +62 -62
  71. package/src/features/content/handlers/facets.ts +49 -49
  72. package/src/features/content/handlers/get.ts +120 -120
  73. package/src/features/content/handlers/helpers.test.ts +180 -180
  74. package/src/features/content/handlers/helpers.ts +93 -93
  75. package/src/features/content/handlers/list.ts +174 -174
  76. package/src/features/content/handlers/update.ts +174 -174
  77. package/src/features/content/index.ts +26 -26
  78. package/src/features/dashboard-layout/__tests__/dashboard-layout.handler.test.ts +388 -0
  79. package/src/features/dashboard-layout/dashboard-layout.handler.ts +206 -0
  80. package/src/features/dashboard-layout/index.ts +5 -0
  81. package/src/features/draft/draft.handler.ts +195 -195
  82. package/src/features/draft/draft.middleware.ts +66 -66
  83. package/src/features/draft/index.ts +5 -5
  84. package/src/features/email/email.provider.ts +42 -42
  85. package/src/features/email/email.service.ts +98 -98
  86. package/src/features/email/email.types.ts +119 -119
  87. package/src/features/email/index.ts +33 -33
  88. package/src/features/email/providers/resend.ts +67 -67
  89. package/src/features/email/providers/smtp.ts +55 -55
  90. package/src/features/email/templates/automation-mail.ts +19 -19
  91. package/src/features/email/templates/password-changed.ts +63 -63
  92. package/src/features/email/templates/password-reset.ts +68 -68
  93. package/src/features/email/templates/shell.ts +96 -96
  94. package/src/features/notifications/index.ts +5 -5
  95. package/src/features/notifications/notifications.handler.ts +105 -105
  96. package/src/features/password-reset/index.ts +19 -19
  97. package/src/features/password-reset/request.ts +92 -92
  98. package/src/features/password-reset/reset.ts +102 -102
  99. package/src/features/rotate-field/index.ts +5 -5
  100. package/src/features/rotate-field/rotate-field.handler.ts +132 -132
  101. package/src/features/rotate-field/rotate-field.schema.ts +17 -17
  102. package/src/features/schema/schema.handler.ts +131 -131
  103. package/src/features/seeds/index.ts +5 -5
  104. package/src/features/seeds/seeds.handler.test.ts +1199 -632
  105. package/src/features/seeds/seeds.handler.ts +558 -693
  106. package/src/features/settings/__tests__/settings.handler.test.ts +555 -555
  107. package/src/features/settings/settings.handler.ts +392 -392
  108. package/src/features/setup/index.ts +288 -204
  109. package/src/features/stats/index.ts +5 -5
  110. package/src/features/stats/stats.handler.ts +420 -420
  111. package/src/features/webhooks/index.ts +63 -63
  112. package/src/index.ts +65 -65
  113. package/src/media-utils.ts +82 -82
  114. package/src/middleware/auth-providers.middleware.test.ts +85 -0
  115. package/src/middleware/auth-providers.middleware.ts +45 -45
  116. package/src/middleware/observability.middleware.test.ts +93 -0
  117. package/src/middleware/observability.middleware.ts +70 -70
  118. package/src/middleware/rate-limit.middleware.ts +45 -45
  119. package/src/middleware/repository.middleware.ts +117 -114
  120. package/src/middleware/seed-registry.middleware.test.ts +97 -97
  121. package/src/middleware/seed-registry.middleware.ts +21 -21
  122. package/src/middleware/storage.middleware.ts +25 -25
  123. package/src/middleware.ts +45 -45
  124. package/src/public/access-policy.ts +27 -27
  125. package/src/public/api-key-middleware.ts +57 -57
  126. package/src/public/cache-utils.ts +38 -38
  127. package/src/public/entry-projection.ts +46 -46
  128. package/src/public/idempotency.ts +23 -23
  129. package/src/public/index.ts +16 -16
  130. package/src/public/problem-details.ts +124 -124
  131. package/src/public/public-add.ts +114 -114
  132. package/src/public/public-edit.ts +163 -163
  133. package/src/public/public-errors.ts +19 -19
  134. package/src/public/public-read.ts +63 -63
  135. package/src/public/public-routes.ts +88 -88
  136. package/src/public/query-builder.test.ts +224 -224
  137. package/src/public/query-builder.ts +156 -156
  138. package/src/public/rate-limit-middleware.ts +34 -34
  139. package/src/public/read-list.ts +54 -54
  140. package/src/public/read-single.ts +48 -48
  141. package/src/public/response-builder.ts +30 -30
  142. package/src/public/sanitize.ts +69 -69
  143. package/src/public/slug-utils.ts +18 -18
  144. package/src/rate-limit/cloudflare-rate-limiter.test.ts +30 -30
  145. package/src/rate-limit/cloudflare-rate-limiter.ts +15 -15
  146. package/src/rate-limit/in-memory-rate-limiter.test.ts +37 -37
  147. package/src/rate-limit/in-memory-rate-limiter.ts +17 -17
  148. package/src/rate-limit/no-op-rate-limiter.test.ts +22 -22
  149. package/src/rate-limit/no-op-rate-limiter.ts +11 -11
  150. package/src/search-utils.test.ts +211 -211
  151. package/src/search-utils.ts +213 -213
  152. package/src/search.ts +65 -65
  153. package/src/shared/apply-policies.test.ts +81 -81
  154. package/src/shared/apply-policies.ts +67 -67
  155. package/src/shared/automations.repository.d1.ts +150 -150
  156. package/src/shared/background-notification-service.test.ts +62 -62
  157. package/src/shared/background-notification-service.ts +52 -52
  158. package/src/shared/base.repository.d1.ts +32 -32
  159. package/src/shared/content-utils.test.ts +165 -165
  160. package/src/shared/content-utils.ts +86 -86
  161. package/src/shared/content.repository.d1.test.ts +507 -458
  162. package/src/shared/content.repository.d1.ts +851 -851
  163. package/src/shared/d1-activity-log.repository.test.ts +140 -140
  164. package/src/shared/d1-activity-log.repository.ts +105 -105
  165. package/src/shared/d1-activity-logger.test.ts +86 -86
  166. package/src/shared/d1-activity-logger.ts +67 -67
  167. package/src/shared/d1-analytics.repository.test.ts +78 -78
  168. package/src/shared/d1-analytics.repository.ts +85 -85
  169. package/src/shared/d1-content-scan.repository.test.ts +80 -80
  170. package/src/shared/d1-content-scan.repository.ts +37 -37
  171. package/src/shared/d1-notification.repository.test.ts +128 -128
  172. package/src/shared/d1-notification.repository.ts +118 -118
  173. package/src/shared/d1-password-reset-token.repository.test.ts +81 -81
  174. package/src/shared/d1-password-reset-token.repository.ts +56 -56
  175. package/src/shared/d1-search.repository.test.ts +87 -87
  176. package/src/shared/d1-search.repository.ts +88 -88
  177. package/src/shared/d1-session.repository.test.ts +125 -125
  178. package/src/shared/d1-session.repository.ts +102 -102
  179. package/src/shared/d1-setup-checklist.repository.ts +36 -36
  180. package/src/shared/d1-user.repository.test.ts +151 -151
  181. package/src/shared/d1-user.repository.ts +119 -119
  182. package/src/shared/d1-widget.repository.test.ts +267 -221
  183. package/src/shared/d1-widget.repository.ts +385 -341
  184. package/src/shared/dashboard-layout.repository.d1.test.ts +135 -0
  185. package/src/shared/dashboard-layout.repository.d1.ts +58 -0
  186. package/src/shared/demo-data-sql.ts +216 -54
  187. package/src/shared/demo-data.repository.d1.ts +20 -20
  188. package/src/shared/execution-context-scheduler.ts +13 -13
  189. package/src/shared/fixed-clock.ts +25 -25
  190. package/src/shared/fts-sync.ts +8 -8
  191. package/src/shared/idempotency.repository.d1.test.ts +83 -83
  192. package/src/shared/idempotency.repository.d1.ts +60 -60
  193. package/src/shared/in-memory-activity-logger.ts +19 -19
  194. package/src/shared/in-memory-notification-service.ts +19 -19
  195. package/src/shared/in-memory-seed.repository.ts +58 -51
  196. package/src/shared/media.repository.d1.test.ts +107 -107
  197. package/src/shared/media.repository.d1.ts +68 -68
  198. package/src/shared/qstash-notification-service.test.ts +67 -67
  199. package/src/shared/qstash-notification-service.ts +55 -55
  200. package/src/shared/query-utils.ts +141 -141
  201. package/src/shared/request-utils.ts +26 -26
  202. package/src/shared/schema-mutator.d1.test.ts +142 -0
  203. package/src/shared/schema-mutator.d1.ts +64 -64
  204. package/src/shared/seed-layout.repository.d1.test.ts +114 -114
  205. package/src/shared/seed-layout.repository.d1.ts +62 -62
  206. package/src/shared/seed-registry-cache.test.ts +68 -68
  207. package/src/shared/seed-registry-cache.ts +49 -49
  208. package/src/shared/seed.repository.d1.test.ts +143 -143
  209. package/src/shared/seed.repository.d1.ts +98 -98
  210. package/src/shared/sequential-id-generator.ts +33 -33
  211. package/src/shared/site-settings.repository.d1.ts +53 -53
  212. package/src/shared/storage/factory.ts +41 -41
  213. package/src/shared/storage/s3-bucket.ts +195 -195
  214. package/src/shared/storage-utils.ts +40 -40
  215. package/src/shared/system-stats.repository.d1.test.ts +58 -58
  216. package/src/shared/system-stats.repository.d1.ts +48 -48
  217. package/src/types.ts +90 -87
  218. package/src/upload.ts +198 -198
  219. package/src/widget.test.ts +85 -0
  220. package/src/widget.ts +251 -212
  221. package/assets/dashboard/assets/index-BSjk0Sx9.js +0 -634
  222. package/assets/dashboard/assets/index-kRCYVN2B.css +0 -1
@@ -1,555 +1,555 @@
1
- // SPDX-License-Identifier: BUSL-1.1
2
- // Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
3
- // See LICENSE in the repository root for license terms.
4
-
5
- import { describe, it, expect, vi } from 'vitest'
6
- import { Hono } from 'hono'
7
- import { settingsApp } from '../settings.handler'
8
-
9
- // ---------------------------------------------------------------------------
10
- // Helpers and Mocks
11
- // ---------------------------------------------------------------------------
12
-
13
- function buildApp(mocks: any = {}) {
14
- const app = new Hono()
15
- app.use('*', async (c, next) => {
16
- c.set('siteSettingsRepository', mocks.siteSettingsRepository ?? {
17
- getAll: vi.fn().mockResolvedValue({
18
- siteTitle: 'Beech CMS',
19
- defaultLanguage: 'en',
20
- timezone: 'Europe/Rome',
21
- currency: 'EUR',
22
- companyName: 'Flavio Corp',
23
- companyWebsite: 'https://flavio.corp',
24
- companyAbbreviation: 'FC',
25
- }),
26
- setMany: vi.fn().mockResolvedValue(undefined),
27
- })
28
-
29
- c.set('userRepository', mocks.userRepository ?? {
30
- findById: vi.fn().mockResolvedValue({
31
- id: 'u1',
32
- email: 'test@beechcms.com',
33
- name: 'Test',
34
- surname: 'User',
35
- passwordHash: 'hashed-pwd',
36
- avatarUrl: null,
37
- notificationPreferences: JSON.stringify({
38
- contentCreate: true,
39
- contentUpdate: false,
40
- contentDelete: true,
41
- mediaUpload: true,
42
- }),
43
- }),
44
- emailBelongsToAnotherUser: vi.fn().mockResolvedValue(false),
45
- updateProfile: vi.fn().mockResolvedValue(undefined),
46
- updatePasswordHash: vi.fn().mockResolvedValue(undefined),
47
- updateAvatarUrl: vi.fn().mockResolvedValue(undefined),
48
- updateNotificationPreferences: vi.fn().mockResolvedValue(undefined),
49
- })
50
-
51
- c.set('sessionRepository', mocks.sessionRepository ?? {
52
- listActiveForUser: vi.fn().mockResolvedValue([
53
- { id: 'sess-1', userAgent: 'Mozilla/5.0', expiresAt: 2000000000 },
54
- ]),
55
- revokeById: vi.fn().mockResolvedValue(true),
56
- })
57
-
58
- c.set('activityLogRepository', mocks.activityLogRepository ?? {
59
- list: vi.fn().mockResolvedValue([
60
- {
61
- id: 'log-1',
62
- action: 'create',
63
- entityType: 'post',
64
- entitySlug: 'first-post',
65
- details: { ip: '127.0.0.1' },
66
- createdAt: 1700000000,
67
- },
68
- ]),
69
- })
70
-
71
- c.set('mediaRepository', mocks.mediaRepository ?? {
72
- count: vi.fn().mockResolvedValue(5),
73
- list: vi.fn().mockResolvedValue({
74
- items: [
75
- { key: 'media/img1.png', size: 1024 },
76
- { key: 'media/img2.png', size: 2048 },
77
- ],
78
- }),
79
- })
80
-
81
- c.set('systemStatsRepository', mocks.systemStatsRepository ?? {
82
- getStorageUsage: vi.fn().mockResolvedValue(3072),
83
- })
84
-
85
- c.set('seedRegistry', mocks.seedRegistry ?? {
86
- all: vi.fn().mockReturnValue([{ slug: 'posts' }]),
87
- })
88
-
89
- c.set('contentScanRepository', mocks.contentScanRepository ?? {
90
- getReferencedMediaKeys: vi.fn().mockResolvedValue(new Set(['media/img1.png'])),
91
- })
92
-
93
- c.set('hashProvider', mocks.hashProvider ?? {
94
- verify: vi.fn().mockResolvedValue(true),
95
- hash: vi.fn().mockResolvedValue('new-hashed-pwd'),
96
- })
97
-
98
- c.set('jwtPayload', mocks.jwtPayload ?? { sub: 'u1' })
99
-
100
- c.env = mocks.env ?? {
101
- DATE_FORMAT: 'YYYY-MM-DD',
102
- EMAIL_PROVIDER: 'smtp',
103
- }
104
-
105
- await next()
106
- })
107
-
108
- app.route('/', settingsApp)
109
- return app
110
- }
111
-
112
- // ---------------------------------------------------------------------------
113
- // Tests
114
- // ---------------------------------------------------------------------------
115
-
116
- describe('Settings Handler', () => {
117
- describe('GET /', () => {
118
- it('returns site settings configuration', async () => {
119
- const app = buildApp()
120
- const res = await app.request('/')
121
- expect(res.status).toBe(200)
122
- const body = await res.json() as any
123
- expect(body.siteTitle).toBe('Beech CMS')
124
- expect(body.company.name).toBe('Flavio Corp')
125
- expect(body.dateFormat).toBe('YYYY-MM-DD')
126
- expect(body.features.email).toBe(true)
127
- })
128
- })
129
-
130
- describe('PUT /', () => {
131
- it('returns 400 for invalid JSON', async () => {
132
- const app = buildApp()
133
- const res = await app.request('/', {
134
- method: 'PUT',
135
- headers: { 'Content-Type': 'application/json' },
136
- body: 'not-json',
137
- })
138
- expect(res.status).toBe(400)
139
- const body = await res.json() as any
140
- expect(body.error).toBe('Invalid JSON body')
141
- })
142
-
143
- it('returns 400 for invalid default language', async () => {
144
- const app = buildApp()
145
- const res = await app.request('/', {
146
- method: 'PUT',
147
- headers: { 'Content-Type': 'application/json' },
148
- body: JSON.stringify({ defaultLanguage: 'fr' }),
149
- })
150
- expect(res.status).toBe(400)
151
- const body = await res.json() as any
152
- expect(body.detail).toContain('Invalid default language')
153
- })
154
-
155
- it('returns 400 for invalid company website URL', async () => {
156
- const app = buildApp()
157
- const res = await app.request('/', {
158
- method: 'PUT',
159
- headers: { 'Content-Type': 'application/json' },
160
- body: JSON.stringify({ company: { website: 'not-a-valid-url' } }),
161
- })
162
- expect(res.status).toBe(400)
163
- const body = await res.json() as any
164
- expect(body.detail).toContain('Invalid company website URL')
165
- })
166
-
167
- it('updates site settings and syncs company name to siteTitle if siteTitle is omitted', async () => {
168
- const setManySpy = vi.fn().mockResolvedValue(undefined)
169
- const app = buildApp({
170
- siteSettingsRepository: {
171
- getAll: vi.fn(),
172
- setMany: setManySpy,
173
- },
174
- })
175
-
176
- const res = await app.request('/', {
177
- method: 'PUT',
178
- headers: { 'Content-Type': 'application/json' },
179
- body: JSON.stringify({
180
- defaultLanguage: 'it',
181
- company: {
182
- name: 'New Corp',
183
- website: 'https://newcorp.com',
184
- abbreviation: 'NC',
185
- },
186
- }),
187
- })
188
-
189
- expect(res.status).toBe(200)
190
- expect(setManySpy).toHaveBeenCalledWith({
191
- defaultLanguage: 'it',
192
- companyName: 'New Corp',
193
- companyWebsite: 'https://newcorp.com',
194
- companyAbbreviation: 'NC',
195
- siteTitle: 'New Corp',
196
- })
197
- })
198
-
199
- it('allows resetting company fields by passing null', async () => {
200
- const setManySpy = vi.fn().mockResolvedValue(undefined)
201
- const app = buildApp({
202
- siteSettingsRepository: {
203
- getAll: vi.fn(),
204
- setMany: setManySpy,
205
- },
206
- })
207
-
208
- const res = await app.request('/', {
209
- method: 'PUT',
210
- headers: { 'Content-Type': 'application/json' },
211
- body: JSON.stringify({
212
- company: null,
213
- }),
214
- })
215
-
216
- expect(res.status).toBe(200)
217
- expect(setManySpy).toHaveBeenCalledWith({
218
- companyName: null,
219
- companyWebsite: null,
220
- companyAbbreviation: null,
221
- })
222
- })
223
- })
224
-
225
- describe('GET /me', () => {
226
- it('returns 404 if current user is not found', async () => {
227
- const app = buildApp({
228
- userRepository: {
229
- findById: vi.fn().mockResolvedValue(null),
230
- },
231
- })
232
- const res = await app.request('/me')
233
- expect(res.status).toBe(404)
234
- const body = await res.json() as any
235
- expect(body.error).toBe('User not found')
236
- })
237
-
238
- it('returns current user profile and notification preferences', async () => {
239
- const app = buildApp()
240
- const res = await app.request('/me')
241
- expect(res.status).toBe(200)
242
- const body = await res.json() as any
243
- expect(body.email).toBe('test@beechcms.com')
244
- expect(body.surname).toBe('User')
245
- expect(body.avatarUrl).toContain('gravatar.com')
246
- expect(body.notificationPrefs.contentUpdate).toBe(false)
247
- })
248
- })
249
-
250
- describe('PUT /profile', () => {
251
- it('returns 400 for invalid JSON', async () => {
252
- const app = buildApp()
253
- const res = await app.request('/profile', {
254
- method: 'PUT',
255
- headers: { 'Content-Type': 'application/json' },
256
- body: 'invalid',
257
- })
258
- expect(res.status).toBe(400)
259
- })
260
-
261
- it('returns 400 for invalid email format', async () => {
262
- const app = buildApp()
263
- const res = await app.request('/profile', {
264
- method: 'PUT',
265
- headers: { 'Content-Type': 'application/json' },
266
- body: JSON.stringify({ email: 'invalid-email' }),
267
- })
268
- expect(res.status).toBe(400)
269
- const body = await res.json() as any
270
- expect(body.detail).toBe('Invalid email format')
271
- })
272
-
273
- it('returns 400 if name is too long', async () => {
274
- const app = buildApp()
275
- const res = await app.request('/profile', {
276
- method: 'PUT',
277
- headers: { 'Content-Type': 'application/json' },
278
- body: JSON.stringify({ name: 'A'.repeat(101) }),
279
- })
280
- expect(res.status).toBe(400)
281
- const body = await res.json() as any
282
- expect(body.detail).toContain('Name is too long')
283
- })
284
-
285
- it('returns 400 if surname is too long', async () => {
286
- const app = buildApp()
287
- const res = await app.request('/profile', {
288
- method: 'PUT',
289
- headers: { 'Content-Type': 'application/json' },
290
- body: JSON.stringify({ surname: 'A'.repeat(101) }),
291
- })
292
- expect(res.status).toBe(400)
293
- const body = await res.json() as any
294
- expect(body.detail).toContain('Surname is too long')
295
- })
296
-
297
- it('returns 400 if no fields to update are provided', async () => {
298
- const app = buildApp()
299
- const res = await app.request('/profile', {
300
- method: 'PUT',
301
- headers: { 'Content-Type': 'application/json' },
302
- body: JSON.stringify({}),
303
- })
304
- expect(res.status).toBe(400)
305
- const body = await res.json() as any
306
- expect(body.error).toBe('No fields to update')
307
- })
308
-
309
- it('returns 409 if email is already in use by another user', async () => {
310
- const app = buildApp({
311
- userRepository: {
312
- emailBelongsToAnotherUser: vi.fn().mockResolvedValue(true),
313
- },
314
- })
315
- const res = await app.request('/profile', {
316
- method: 'PUT',
317
- headers: { 'Content-Type': 'application/json' },
318
- body: JSON.stringify({ email: 'taken@beechcms.com' }),
319
- })
320
- expect(res.status).toBe(409)
321
- const body = await res.json() as any
322
- expect(body.detail).toBe('Email address is already in use')
323
- })
324
-
325
- it('updates user profile successfully', async () => {
326
- const updateProfileSpy = vi.fn().mockResolvedValue(undefined)
327
- const app = buildApp({
328
- userRepository: {
329
- emailBelongsToAnotherUser: vi.fn().mockResolvedValue(false),
330
- updateProfile: updateProfileSpy,
331
- },
332
- })
333
- const res = await app.request('/profile', {
334
- method: 'PUT',
335
- headers: { 'Content-Type': 'application/json' },
336
- body: JSON.stringify({ name: 'NewName', surname: 'NewSurname', email: 'new@beechcms.com' }),
337
- })
338
- expect(res.status).toBe(200)
339
- expect(updateProfileSpy).toHaveBeenCalledWith('u1', {
340
- name: 'NewName',
341
- surname: 'NewSurname',
342
- email: 'new@beechcms.com',
343
- })
344
- })
345
- })
346
-
347
- describe('PUT /password', () => {
348
- it('returns 400 if currentPassword or newPassword is missing', async () => {
349
- const app = buildApp()
350
- const res = await app.request('/password', {
351
- method: 'PUT',
352
- headers: { 'Content-Type': 'application/json' },
353
- body: JSON.stringify({ currentPassword: 'pwd' }),
354
- })
355
- expect(res.status).toBe(400)
356
- })
357
-
358
- it('returns 400 if newPassword is too short', async () => {
359
- const app = buildApp()
360
- const res = await app.request('/password', {
361
- method: 'PUT',
362
- headers: { 'Content-Type': 'application/json' },
363
- body: JSON.stringify({ currentPassword: 'pwd', newPassword: 'short' }),
364
- })
365
- expect(res.status).toBe(400)
366
- })
367
-
368
- it('returns 400 if newPassword is too long', async () => {
369
- const app = buildApp()
370
- const res = await app.request('/password', {
371
- method: 'PUT',
372
- headers: { 'Content-Type': 'application/json' },
373
- body: JSON.stringify({ currentPassword: 'pwd', newPassword: 'A'.repeat(129) }),
374
- })
375
- expect(res.status).toBe(400)
376
- })
377
-
378
- it('returns 404 if user is not found', async () => {
379
- const app = buildApp({
380
- userRepository: {
381
- findById: vi.fn().mockResolvedValue(null),
382
- },
383
- })
384
- const res = await app.request('/password', {
385
- method: 'PUT',
386
- headers: { 'Content-Type': 'application/json' },
387
- body: JSON.stringify({ currentPassword: 'pwd', newPassword: 'new-valid-pwd' }),
388
- })
389
- expect(res.status).toBe(404)
390
- })
391
-
392
- it('returns 401 if current password verification fails', async () => {
393
- const app = buildApp({
394
- hashProvider: {
395
- verify: vi.fn().mockResolvedValue(false),
396
- },
397
- })
398
- const res = await app.request('/password', {
399
- method: 'PUT',
400
- headers: { 'Content-Type': 'application/json' },
401
- body: JSON.stringify({ currentPassword: 'pwd', newPassword: 'new-valid-pwd' }),
402
- })
403
- expect(res.status).toBe(401)
404
- })
405
-
406
- it('updates password successfully if current password is correct', async () => {
407
- const updatePasswordHashSpy = vi.fn().mockResolvedValue(undefined)
408
- const app = buildApp({
409
- userRepository: {
410
- findById: vi.fn().mockResolvedValue({ passwordHash: 'old-hash' }),
411
- updatePasswordHash: updatePasswordHashSpy,
412
- },
413
- hashProvider: {
414
- verify: vi.fn().mockResolvedValue(true),
415
- hash: vi.fn().mockResolvedValue('new-hashed-pwd'),
416
- },
417
- })
418
- const res = await app.request('/password', {
419
- method: 'PUT',
420
- headers: { 'Content-Type': 'application/json' },
421
- body: JSON.stringify({ currentPassword: 'pwd', newPassword: 'new-valid-pwd' }),
422
- })
423
- expect(res.status).toBe(200)
424
- expect(updatePasswordHashSpy).toHaveBeenCalledWith('u1', 'new-hashed-pwd')
425
- })
426
- })
427
-
428
- describe('PUT /avatar', () => {
429
- it('updates avatar URL', async () => {
430
- const updateAvatarSpy = vi.fn().mockResolvedValue(undefined)
431
- const app = buildApp({
432
- userRepository: {
433
- updateAvatarUrl: updateAvatarSpy,
434
- },
435
- })
436
- const res = await app.request('/avatar', {
437
- method: 'PUT',
438
- headers: { 'Content-Type': 'application/json' },
439
- body: JSON.stringify({ avatarUrl: 'https://beechcms.com/avatar.png' }),
440
- })
441
- expect(res.status).toBe(200)
442
- expect(updateAvatarSpy).toHaveBeenCalledWith('u1', 'https://beechcms.com/avatar.png')
443
- })
444
- })
445
-
446
- describe('GET /sessions', () => {
447
- it('returns a list of user active sessions', async () => {
448
- const app = buildApp()
449
- const res = await app.request('/sessions')
450
- expect(res.status).toBe(200)
451
- const body = await res.json() as any[]
452
- expect(body).toHaveLength(1)
453
- expect(body[0].id).toBe('sess-1')
454
- })
455
- })
456
-
457
- describe('DELETE /sessions/:id', () => {
458
- it('returns 404 if session to revoke is not found', async () => {
459
- const app = buildApp({
460
- sessionRepository: {
461
- revokeById: vi.fn().mockResolvedValue(false),
462
- },
463
- })
464
- const res = await app.request('/sessions/unknown', {
465
- method: 'DELETE',
466
- })
467
- expect(res.status).toBe(404)
468
- })
469
-
470
- it('revokes session successfully', async () => {
471
- const revokeSpy = vi.fn().mockResolvedValue(true)
472
- const app = buildApp({
473
- sessionRepository: {
474
- revokeById: revokeSpy,
475
- },
476
- })
477
- const res = await app.request('/sessions/sess-1', {
478
- method: 'DELETE',
479
- })
480
- expect(res.status).toBe(200)
481
- expect(revokeSpy).toHaveBeenCalledWith('sess-1', 'u1', expect.any(Number))
482
- })
483
- })
484
-
485
- describe('GET /activity', () => {
486
- it('returns user activity logs in legacy format', async () => {
487
- const app = buildApp()
488
- const res = await app.request('/activity')
489
- expect(res.status).toBe(200)
490
- const body = await res.json() as any[]
491
- expect(body).toHaveLength(1)
492
- expect(body[0].id).toBe('log-1')
493
- expect(body[0].entity_type).toBe('post')
494
- expect(body[0].entity_slug).toBe('first-post')
495
- expect(body[0].details).toBe('{"ip":"127.0.0.1"}')
496
- })
497
- })
498
-
499
- describe('GET /storage', () => {
500
- it('returns storage metrics and orphaned media files', async () => {
501
- const app = buildApp()
502
- const res = await app.request('/storage')
503
- expect(res.status).toBe(200)
504
- const body = await res.json() as any
505
- expect(body.totalBytes).toBe(3072)
506
- expect(body.fileCount).toBe(5)
507
- expect(body.orphans).toHaveLength(1)
508
- expect(body.orphans[0].key).toBe('media/img2.png')
509
- })
510
- })
511
-
512
- describe('GET /notifications', () => {
513
- it('returns user notification preferences', async () => {
514
- const app = buildApp()
515
- const res = await app.request('/notifications')
516
- expect(res.status).toBe(200)
517
- const body = await res.json() as any
518
- expect(body.contentCreate).toBe(true)
519
- expect(body.contentUpdate).toBe(false)
520
- expect(body.contentDelete).toBe(true)
521
- expect(body.mediaUpload).toBe(true)
522
- })
523
- })
524
-
525
- describe('PUT /notifications', () => {
526
- it('updates user notification preferences', async () => {
527
- const updateNotificationSpy = vi.fn().mockResolvedValue(undefined)
528
- const app = buildApp({
529
- userRepository: {
530
- updateNotificationPreferences: updateNotificationSpy,
531
- },
532
- })
533
- const res = await app.request('/notifications', {
534
- method: 'PUT',
535
- headers: { 'Content-Type': 'application/json' },
536
- body: JSON.stringify({
537
- contentCreate: true,
538
- contentUpdate: true,
539
- contentDelete: false,
540
- mediaUpload: false,
541
- }),
542
- })
543
- expect(res.status).toBe(200)
544
- expect(updateNotificationSpy).toHaveBeenCalledWith(
545
- 'u1',
546
- JSON.stringify({
547
- contentCreate: true,
548
- contentUpdate: true,
549
- contentDelete: false,
550
- mediaUpload: false,
551
- })
552
- )
553
- })
554
- })
555
- })
1
+ // SPDX-License-Identifier: BUSL-1.1
2
+ // Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
3
+ // See LICENSE in the repository root for license terms.
4
+
5
+ import { describe, it, expect, vi } from 'vitest'
6
+ import { Hono } from 'hono'
7
+ import { settingsApp } from '../settings.handler'
8
+
9
+ // ---------------------------------------------------------------------------
10
+ // Helpers and Mocks
11
+ // ---------------------------------------------------------------------------
12
+
13
+ function buildApp(mocks: any = {}) {
14
+ const app = new Hono()
15
+ app.use('*', async (c, next) => {
16
+ c.set('siteSettingsRepository', mocks.siteSettingsRepository ?? {
17
+ getAll: vi.fn().mockResolvedValue({
18
+ siteTitle: 'Beech CMS',
19
+ defaultLanguage: 'en',
20
+ timezone: 'Europe/Rome',
21
+ currency: 'EUR',
22
+ companyName: 'Flavio Corp',
23
+ companyWebsite: 'https://flavio.corp',
24
+ companyAbbreviation: 'FC',
25
+ }),
26
+ setMany: vi.fn().mockResolvedValue(undefined),
27
+ })
28
+
29
+ c.set('userRepository', mocks.userRepository ?? {
30
+ findById: vi.fn().mockResolvedValue({
31
+ id: 'u1',
32
+ email: 'test@beechcms.com',
33
+ name: 'Test',
34
+ surname: 'User',
35
+ passwordHash: 'hashed-pwd',
36
+ avatarUrl: null,
37
+ notificationPreferences: JSON.stringify({
38
+ contentCreate: true,
39
+ contentUpdate: false,
40
+ contentDelete: true,
41
+ mediaUpload: true,
42
+ }),
43
+ }),
44
+ emailBelongsToAnotherUser: vi.fn().mockResolvedValue(false),
45
+ updateProfile: vi.fn().mockResolvedValue(undefined),
46
+ updatePasswordHash: vi.fn().mockResolvedValue(undefined),
47
+ updateAvatarUrl: vi.fn().mockResolvedValue(undefined),
48
+ updateNotificationPreferences: vi.fn().mockResolvedValue(undefined),
49
+ })
50
+
51
+ c.set('sessionRepository', mocks.sessionRepository ?? {
52
+ listActiveForUser: vi.fn().mockResolvedValue([
53
+ { id: 'sess-1', userAgent: 'Mozilla/5.0', expiresAt: 2000000000 },
54
+ ]),
55
+ revokeById: vi.fn().mockResolvedValue(true),
56
+ })
57
+
58
+ c.set('activityLogRepository', mocks.activityLogRepository ?? {
59
+ list: vi.fn().mockResolvedValue([
60
+ {
61
+ id: 'log-1',
62
+ action: 'create',
63
+ entityType: 'post',
64
+ entitySlug: 'first-post',
65
+ details: { ip: '127.0.0.1' },
66
+ createdAt: 1700000000,
67
+ },
68
+ ]),
69
+ })
70
+
71
+ c.set('mediaRepository', mocks.mediaRepository ?? {
72
+ count: vi.fn().mockResolvedValue(5),
73
+ list: vi.fn().mockResolvedValue({
74
+ items: [
75
+ { key: 'media/img1.png', size: 1024 },
76
+ { key: 'media/img2.png', size: 2048 },
77
+ ],
78
+ }),
79
+ })
80
+
81
+ c.set('systemStatsRepository', mocks.systemStatsRepository ?? {
82
+ getStorageUsage: vi.fn().mockResolvedValue(3072),
83
+ })
84
+
85
+ c.set('seedRegistry', mocks.seedRegistry ?? {
86
+ all: vi.fn().mockReturnValue([{ slug: 'posts' }]),
87
+ })
88
+
89
+ c.set('contentScanRepository', mocks.contentScanRepository ?? {
90
+ getReferencedMediaKeys: vi.fn().mockResolvedValue(new Set(['media/img1.png'])),
91
+ })
92
+
93
+ c.set('hashProvider', mocks.hashProvider ?? {
94
+ verify: vi.fn().mockResolvedValue(true),
95
+ hash: vi.fn().mockResolvedValue('new-hashed-pwd'),
96
+ })
97
+
98
+ c.set('jwtPayload', mocks.jwtPayload ?? { sub: 'u1' })
99
+
100
+ c.env = mocks.env ?? {
101
+ DATE_FORMAT: 'YYYY-MM-DD',
102
+ EMAIL_PROVIDER: 'smtp',
103
+ }
104
+
105
+ await next()
106
+ })
107
+
108
+ app.route('/', settingsApp)
109
+ return app
110
+ }
111
+
112
+ // ---------------------------------------------------------------------------
113
+ // Tests
114
+ // ---------------------------------------------------------------------------
115
+
116
+ describe('Settings Handler', () => {
117
+ describe('GET /', () => {
118
+ it('returns site settings configuration', async () => {
119
+ const app = buildApp()
120
+ const res = await app.request('/')
121
+ expect(res.status).toBe(200)
122
+ const body = await res.json() as any
123
+ expect(body.siteTitle).toBe('Beech CMS')
124
+ expect(body.company.name).toBe('Flavio Corp')
125
+ expect(body.dateFormat).toBe('YYYY-MM-DD')
126
+ expect(body.features.email).toBe(true)
127
+ })
128
+ })
129
+
130
+ describe('PUT /', () => {
131
+ it('returns 400 for invalid JSON', async () => {
132
+ const app = buildApp()
133
+ const res = await app.request('/', {
134
+ method: 'PUT',
135
+ headers: { 'Content-Type': 'application/json' },
136
+ body: 'not-json',
137
+ })
138
+ expect(res.status).toBe(400)
139
+ const body = await res.json() as any
140
+ expect(body.error).toBe('Invalid JSON body')
141
+ })
142
+
143
+ it('returns 400 for invalid default language', async () => {
144
+ const app = buildApp()
145
+ const res = await app.request('/', {
146
+ method: 'PUT',
147
+ headers: { 'Content-Type': 'application/json' },
148
+ body: JSON.stringify({ defaultLanguage: 'fr' }),
149
+ })
150
+ expect(res.status).toBe(400)
151
+ const body = await res.json() as any
152
+ expect(body.detail).toContain('Invalid default language')
153
+ })
154
+
155
+ it('returns 400 for invalid company website URL', async () => {
156
+ const app = buildApp()
157
+ const res = await app.request('/', {
158
+ method: 'PUT',
159
+ headers: { 'Content-Type': 'application/json' },
160
+ body: JSON.stringify({ company: { website: 'not-a-valid-url' } }),
161
+ })
162
+ expect(res.status).toBe(400)
163
+ const body = await res.json() as any
164
+ expect(body.detail).toContain('Invalid company website URL')
165
+ })
166
+
167
+ it('updates site settings and syncs company name to siteTitle if siteTitle is omitted', async () => {
168
+ const setManySpy = vi.fn().mockResolvedValue(undefined)
169
+ const app = buildApp({
170
+ siteSettingsRepository: {
171
+ getAll: vi.fn(),
172
+ setMany: setManySpy,
173
+ },
174
+ })
175
+
176
+ const res = await app.request('/', {
177
+ method: 'PUT',
178
+ headers: { 'Content-Type': 'application/json' },
179
+ body: JSON.stringify({
180
+ defaultLanguage: 'it',
181
+ company: {
182
+ name: 'New Corp',
183
+ website: 'https://newcorp.com',
184
+ abbreviation: 'NC',
185
+ },
186
+ }),
187
+ })
188
+
189
+ expect(res.status).toBe(200)
190
+ expect(setManySpy).toHaveBeenCalledWith({
191
+ defaultLanguage: 'it',
192
+ companyName: 'New Corp',
193
+ companyWebsite: 'https://newcorp.com',
194
+ companyAbbreviation: 'NC',
195
+ siteTitle: 'New Corp',
196
+ })
197
+ })
198
+
199
+ it('allows resetting company fields by passing null', async () => {
200
+ const setManySpy = vi.fn().mockResolvedValue(undefined)
201
+ const app = buildApp({
202
+ siteSettingsRepository: {
203
+ getAll: vi.fn(),
204
+ setMany: setManySpy,
205
+ },
206
+ })
207
+
208
+ const res = await app.request('/', {
209
+ method: 'PUT',
210
+ headers: { 'Content-Type': 'application/json' },
211
+ body: JSON.stringify({
212
+ company: null,
213
+ }),
214
+ })
215
+
216
+ expect(res.status).toBe(200)
217
+ expect(setManySpy).toHaveBeenCalledWith({
218
+ companyName: null,
219
+ companyWebsite: null,
220
+ companyAbbreviation: null,
221
+ })
222
+ })
223
+ })
224
+
225
+ describe('GET /me', () => {
226
+ it('returns 404 if current user is not found', async () => {
227
+ const app = buildApp({
228
+ userRepository: {
229
+ findById: vi.fn().mockResolvedValue(null),
230
+ },
231
+ })
232
+ const res = await app.request('/me')
233
+ expect(res.status).toBe(404)
234
+ const body = await res.json() as any
235
+ expect(body.error).toBe('User not found')
236
+ })
237
+
238
+ it('returns current user profile and notification preferences', async () => {
239
+ const app = buildApp()
240
+ const res = await app.request('/me')
241
+ expect(res.status).toBe(200)
242
+ const body = await res.json() as any
243
+ expect(body.email).toBe('test@beechcms.com')
244
+ expect(body.surname).toBe('User')
245
+ expect(body.avatarUrl).toContain('gravatar.com')
246
+ expect(body.notificationPrefs.contentUpdate).toBe(false)
247
+ })
248
+ })
249
+
250
+ describe('PUT /profile', () => {
251
+ it('returns 400 for invalid JSON', async () => {
252
+ const app = buildApp()
253
+ const res = await app.request('/profile', {
254
+ method: 'PUT',
255
+ headers: { 'Content-Type': 'application/json' },
256
+ body: 'invalid',
257
+ })
258
+ expect(res.status).toBe(400)
259
+ })
260
+
261
+ it('returns 400 for invalid email format', async () => {
262
+ const app = buildApp()
263
+ const res = await app.request('/profile', {
264
+ method: 'PUT',
265
+ headers: { 'Content-Type': 'application/json' },
266
+ body: JSON.stringify({ email: 'invalid-email' }),
267
+ })
268
+ expect(res.status).toBe(400)
269
+ const body = await res.json() as any
270
+ expect(body.detail).toBe('Invalid email format')
271
+ })
272
+
273
+ it('returns 400 if name is too long', async () => {
274
+ const app = buildApp()
275
+ const res = await app.request('/profile', {
276
+ method: 'PUT',
277
+ headers: { 'Content-Type': 'application/json' },
278
+ body: JSON.stringify({ name: 'A'.repeat(101) }),
279
+ })
280
+ expect(res.status).toBe(400)
281
+ const body = await res.json() as any
282
+ expect(body.detail).toContain('Name is too long')
283
+ })
284
+
285
+ it('returns 400 if surname is too long', async () => {
286
+ const app = buildApp()
287
+ const res = await app.request('/profile', {
288
+ method: 'PUT',
289
+ headers: { 'Content-Type': 'application/json' },
290
+ body: JSON.stringify({ surname: 'A'.repeat(101) }),
291
+ })
292
+ expect(res.status).toBe(400)
293
+ const body = await res.json() as any
294
+ expect(body.detail).toContain('Surname is too long')
295
+ })
296
+
297
+ it('returns 400 if no fields to update are provided', async () => {
298
+ const app = buildApp()
299
+ const res = await app.request('/profile', {
300
+ method: 'PUT',
301
+ headers: { 'Content-Type': 'application/json' },
302
+ body: JSON.stringify({}),
303
+ })
304
+ expect(res.status).toBe(400)
305
+ const body = await res.json() as any
306
+ expect(body.error).toBe('No fields to update')
307
+ })
308
+
309
+ it('returns 409 if email is already in use by another user', async () => {
310
+ const app = buildApp({
311
+ userRepository: {
312
+ emailBelongsToAnotherUser: vi.fn().mockResolvedValue(true),
313
+ },
314
+ })
315
+ const res = await app.request('/profile', {
316
+ method: 'PUT',
317
+ headers: { 'Content-Type': 'application/json' },
318
+ body: JSON.stringify({ email: 'taken@beechcms.com' }),
319
+ })
320
+ expect(res.status).toBe(409)
321
+ const body = await res.json() as any
322
+ expect(body.detail).toBe('Email address is already in use')
323
+ })
324
+
325
+ it('updates user profile successfully', async () => {
326
+ const updateProfileSpy = vi.fn().mockResolvedValue(undefined)
327
+ const app = buildApp({
328
+ userRepository: {
329
+ emailBelongsToAnotherUser: vi.fn().mockResolvedValue(false),
330
+ updateProfile: updateProfileSpy,
331
+ },
332
+ })
333
+ const res = await app.request('/profile', {
334
+ method: 'PUT',
335
+ headers: { 'Content-Type': 'application/json' },
336
+ body: JSON.stringify({ name: 'NewName', surname: 'NewSurname', email: 'new@beechcms.com' }),
337
+ })
338
+ expect(res.status).toBe(200)
339
+ expect(updateProfileSpy).toHaveBeenCalledWith('u1', {
340
+ name: 'NewName',
341
+ surname: 'NewSurname',
342
+ email: 'new@beechcms.com',
343
+ })
344
+ })
345
+ })
346
+
347
+ describe('PUT /password', () => {
348
+ it('returns 400 if currentPassword or newPassword is missing', async () => {
349
+ const app = buildApp()
350
+ const res = await app.request('/password', {
351
+ method: 'PUT',
352
+ headers: { 'Content-Type': 'application/json' },
353
+ body: JSON.stringify({ currentPassword: 'pwd' }),
354
+ })
355
+ expect(res.status).toBe(400)
356
+ })
357
+
358
+ it('returns 400 if newPassword is too short', async () => {
359
+ const app = buildApp()
360
+ const res = await app.request('/password', {
361
+ method: 'PUT',
362
+ headers: { 'Content-Type': 'application/json' },
363
+ body: JSON.stringify({ currentPassword: 'pwd', newPassword: 'short' }),
364
+ })
365
+ expect(res.status).toBe(400)
366
+ })
367
+
368
+ it('returns 400 if newPassword is too long', async () => {
369
+ const app = buildApp()
370
+ const res = await app.request('/password', {
371
+ method: 'PUT',
372
+ headers: { 'Content-Type': 'application/json' },
373
+ body: JSON.stringify({ currentPassword: 'pwd', newPassword: 'A'.repeat(129) }),
374
+ })
375
+ expect(res.status).toBe(400)
376
+ })
377
+
378
+ it('returns 404 if user is not found', async () => {
379
+ const app = buildApp({
380
+ userRepository: {
381
+ findById: vi.fn().mockResolvedValue(null),
382
+ },
383
+ })
384
+ const res = await app.request('/password', {
385
+ method: 'PUT',
386
+ headers: { 'Content-Type': 'application/json' },
387
+ body: JSON.stringify({ currentPassword: 'pwd', newPassword: 'new-valid-pwd' }),
388
+ })
389
+ expect(res.status).toBe(404)
390
+ })
391
+
392
+ it('returns 401 if current password verification fails', async () => {
393
+ const app = buildApp({
394
+ hashProvider: {
395
+ verify: vi.fn().mockResolvedValue(false),
396
+ },
397
+ })
398
+ const res = await app.request('/password', {
399
+ method: 'PUT',
400
+ headers: { 'Content-Type': 'application/json' },
401
+ body: JSON.stringify({ currentPassword: 'pwd', newPassword: 'new-valid-pwd' }),
402
+ })
403
+ expect(res.status).toBe(401)
404
+ })
405
+
406
+ it('updates password successfully if current password is correct', async () => {
407
+ const updatePasswordHashSpy = vi.fn().mockResolvedValue(undefined)
408
+ const app = buildApp({
409
+ userRepository: {
410
+ findById: vi.fn().mockResolvedValue({ passwordHash: 'old-hash' }),
411
+ updatePasswordHash: updatePasswordHashSpy,
412
+ },
413
+ hashProvider: {
414
+ verify: vi.fn().mockResolvedValue(true),
415
+ hash: vi.fn().mockResolvedValue('new-hashed-pwd'),
416
+ },
417
+ })
418
+ const res = await app.request('/password', {
419
+ method: 'PUT',
420
+ headers: { 'Content-Type': 'application/json' },
421
+ body: JSON.stringify({ currentPassword: 'pwd', newPassword: 'new-valid-pwd' }),
422
+ })
423
+ expect(res.status).toBe(200)
424
+ expect(updatePasswordHashSpy).toHaveBeenCalledWith('u1', 'new-hashed-pwd')
425
+ })
426
+ })
427
+
428
+ describe('PUT /avatar', () => {
429
+ it('updates avatar URL', async () => {
430
+ const updateAvatarSpy = vi.fn().mockResolvedValue(undefined)
431
+ const app = buildApp({
432
+ userRepository: {
433
+ updateAvatarUrl: updateAvatarSpy,
434
+ },
435
+ })
436
+ const res = await app.request('/avatar', {
437
+ method: 'PUT',
438
+ headers: { 'Content-Type': 'application/json' },
439
+ body: JSON.stringify({ avatarUrl: 'https://beechcms.com/avatar.png' }),
440
+ })
441
+ expect(res.status).toBe(200)
442
+ expect(updateAvatarSpy).toHaveBeenCalledWith('u1', 'https://beechcms.com/avatar.png')
443
+ })
444
+ })
445
+
446
+ describe('GET /sessions', () => {
447
+ it('returns a list of user active sessions', async () => {
448
+ const app = buildApp()
449
+ const res = await app.request('/sessions')
450
+ expect(res.status).toBe(200)
451
+ const body = await res.json() as any[]
452
+ expect(body).toHaveLength(1)
453
+ expect(body[0].id).toBe('sess-1')
454
+ })
455
+ })
456
+
457
+ describe('DELETE /sessions/:id', () => {
458
+ it('returns 404 if session to revoke is not found', async () => {
459
+ const app = buildApp({
460
+ sessionRepository: {
461
+ revokeById: vi.fn().mockResolvedValue(false),
462
+ },
463
+ })
464
+ const res = await app.request('/sessions/unknown', {
465
+ method: 'DELETE',
466
+ })
467
+ expect(res.status).toBe(404)
468
+ })
469
+
470
+ it('revokes session successfully', async () => {
471
+ const revokeSpy = vi.fn().mockResolvedValue(true)
472
+ const app = buildApp({
473
+ sessionRepository: {
474
+ revokeById: revokeSpy,
475
+ },
476
+ })
477
+ const res = await app.request('/sessions/sess-1', {
478
+ method: 'DELETE',
479
+ })
480
+ expect(res.status).toBe(200)
481
+ expect(revokeSpy).toHaveBeenCalledWith('sess-1', 'u1', expect.any(Number))
482
+ })
483
+ })
484
+
485
+ describe('GET /activity', () => {
486
+ it('returns user activity logs in legacy format', async () => {
487
+ const app = buildApp()
488
+ const res = await app.request('/activity')
489
+ expect(res.status).toBe(200)
490
+ const body = await res.json() as any[]
491
+ expect(body).toHaveLength(1)
492
+ expect(body[0].id).toBe('log-1')
493
+ expect(body[0].entity_type).toBe('post')
494
+ expect(body[0].entity_slug).toBe('first-post')
495
+ expect(body[0].details).toBe('{"ip":"127.0.0.1"}')
496
+ })
497
+ })
498
+
499
+ describe('GET /storage', () => {
500
+ it('returns storage metrics and orphaned media files', async () => {
501
+ const app = buildApp()
502
+ const res = await app.request('/storage')
503
+ expect(res.status).toBe(200)
504
+ const body = await res.json() as any
505
+ expect(body.totalBytes).toBe(3072)
506
+ expect(body.fileCount).toBe(5)
507
+ expect(body.orphans).toHaveLength(1)
508
+ expect(body.orphans[0].key).toBe('media/img2.png')
509
+ })
510
+ })
511
+
512
+ describe('GET /notifications', () => {
513
+ it('returns user notification preferences', async () => {
514
+ const app = buildApp()
515
+ const res = await app.request('/notifications')
516
+ expect(res.status).toBe(200)
517
+ const body = await res.json() as any
518
+ expect(body.contentCreate).toBe(true)
519
+ expect(body.contentUpdate).toBe(false)
520
+ expect(body.contentDelete).toBe(true)
521
+ expect(body.mediaUpload).toBe(true)
522
+ })
523
+ })
524
+
525
+ describe('PUT /notifications', () => {
526
+ it('updates user notification preferences', async () => {
527
+ const updateNotificationSpy = vi.fn().mockResolvedValue(undefined)
528
+ const app = buildApp({
529
+ userRepository: {
530
+ updateNotificationPreferences: updateNotificationSpy,
531
+ },
532
+ })
533
+ const res = await app.request('/notifications', {
534
+ method: 'PUT',
535
+ headers: { 'Content-Type': 'application/json' },
536
+ body: JSON.stringify({
537
+ contentCreate: true,
538
+ contentUpdate: true,
539
+ contentDelete: false,
540
+ mediaUpload: false,
541
+ }),
542
+ })
543
+ expect(res.status).toBe(200)
544
+ expect(updateNotificationSpy).toHaveBeenCalledWith(
545
+ 'u1',
546
+ JSON.stringify({
547
+ contentCreate: true,
548
+ contentUpdate: true,
549
+ contentDelete: false,
550
+ mediaUpload: false,
551
+ })
552
+ )
553
+ })
554
+ })
555
+ })