@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,62 +1,62 @@
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 { SignJWT, jwtVerify } from 'jose'
6
- import type { ITokenService, IssueTokenOptions, JwtClaims, IClock } from '@beechcms/core'
7
-
8
- const DEFAULT_TOKEN_TTL_SECONDS = 900
9
- const DEFAULT_ALGORITHM = 'HS256' as const
10
-
11
- export interface JoseTokenServiceConfig {
12
- issuer?: string
13
- audience?: string
14
- algorithm?: 'HS256' | 'HS384' | 'HS512'
15
- }
16
-
17
- export class JoseTokenService implements ITokenService {
18
- private readonly secretBytes: Uint8Array
19
- private readonly config: JoseTokenServiceConfig
20
- private readonly clock: IClock
21
-
22
- constructor(secret: string, config: JoseTokenServiceConfig, clock: IClock) {
23
- this.secretBytes = new TextEncoder().encode(secret)
24
- if (this.secretBytes.length < 32) {
25
- throw new Error('JWT secret must be at least 32 bytes (256-bit)')
26
- }
27
- this.config = config
28
- this.clock = clock
29
- }
30
-
31
- async issue(claims: JwtClaims, options?: IssueTokenOptions): Promise<string> {
32
- const { sub, ...remainingClaims } = claims
33
- const ttlSeconds = options?.ttlSeconds ?? DEFAULT_TOKEN_TTL_SECONDS
34
- const algorithm = this.config.algorithm ?? DEFAULT_ALGORITHM
35
- const issuedAtSeconds = this.clock.nowSeconds()
36
-
37
- let builder = new SignJWT(remainingClaims)
38
- .setProtectedHeader({ alg: algorithm, typ: 'JWT' })
39
- .setSubject(sub)
40
- .setIssuedAt(issuedAtSeconds)
41
- .setExpirationTime(issuedAtSeconds + ttlSeconds)
42
-
43
- if (this.config.issuer) builder = builder.setIssuer(this.config.issuer)
44
- if (this.config.audience) builder = builder.setAudience(this.config.audience)
45
-
46
- return builder.sign(this.secretBytes)
47
- }
48
-
49
- async verify(token: string): Promise<JwtClaims | null> {
50
- try {
51
- const algorithm = this.config.algorithm ?? DEFAULT_ALGORITHM
52
- const { payload } = await jwtVerify(token, this.secretBytes, {
53
- algorithms: [algorithm],
54
- issuer: this.config.issuer,
55
- audience: this.config.audience,
56
- })
57
- return payload as JwtClaims
58
- } catch {
59
- return null
60
- }
61
- }
62
- }
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 { SignJWT, jwtVerify } from 'jose'
6
+ import type { ITokenService, IssueTokenOptions, JwtClaims, IClock } from '@beechcms/core'
7
+
8
+ const DEFAULT_TOKEN_TTL_SECONDS = 900
9
+ const DEFAULT_ALGORITHM = 'HS256' as const
10
+
11
+ export interface JoseTokenServiceConfig {
12
+ issuer?: string
13
+ audience?: string
14
+ algorithm?: 'HS256' | 'HS384' | 'HS512'
15
+ }
16
+
17
+ export class JoseTokenService implements ITokenService {
18
+ private readonly secretBytes: Uint8Array
19
+ private readonly config: JoseTokenServiceConfig
20
+ private readonly clock: IClock
21
+
22
+ constructor(secret: string, config: JoseTokenServiceConfig, clock: IClock) {
23
+ this.secretBytes = new TextEncoder().encode(secret)
24
+ if (this.secretBytes.length < 32) {
25
+ throw new Error('JWT secret must be at least 32 bytes (256-bit)')
26
+ }
27
+ this.config = config
28
+ this.clock = clock
29
+ }
30
+
31
+ async issue(claims: JwtClaims, options?: IssueTokenOptions): Promise<string> {
32
+ const { sub, ...remainingClaims } = claims
33
+ const ttlSeconds = options?.ttlSeconds ?? DEFAULT_TOKEN_TTL_SECONDS
34
+ const algorithm = this.config.algorithm ?? DEFAULT_ALGORITHM
35
+ const issuedAtSeconds = this.clock.nowSeconds()
36
+
37
+ let builder = new SignJWT(remainingClaims)
38
+ .setProtectedHeader({ alg: algorithm, typ: 'JWT' })
39
+ .setSubject(sub)
40
+ .setIssuedAt(issuedAtSeconds)
41
+ .setExpirationTime(issuedAtSeconds + ttlSeconds)
42
+
43
+ if (this.config.issuer) builder = builder.setIssuer(this.config.issuer)
44
+ if (this.config.audience) builder = builder.setAudience(this.config.audience)
45
+
46
+ return builder.sign(this.secretBytes)
47
+ }
48
+
49
+ async verify(token: string): Promise<JwtClaims | null> {
50
+ try {
51
+ const algorithm = this.config.algorithm ?? DEFAULT_ALGORITHM
52
+ const { payload } = await jwtVerify(token, this.secretBytes, {
53
+ algorithms: [algorithm],
54
+ issuer: this.config.issuer,
55
+ audience: this.config.audience,
56
+ })
57
+ return payload as JwtClaims
58
+ } catch {
59
+ return null
60
+ }
61
+ }
62
+ }
@@ -1,87 +1,87 @@
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
- /**
6
- * Sprint 04-pre Part B5 — JWT claims pass-through test.
7
- *
8
- * Verifies that `role` and `surname` claims issued in a JWT token are
9
- * preserved end-to-end through the authMiddleware and available on
10
- * `context.get('jwtPayload')`. Without the JwtClaims unification these
11
- * fields would be type-erased and come back undefined.
12
- */
13
-
14
- import { describe, it, expect } from 'vitest'
15
- import { Hono } from 'hono'
16
- import { SystemClock } from '@beechcms/core'
17
- import type { JwtClaims } from '@beechcms/core'
18
- import { JoseTokenService } from './jose-token-service'
19
- import { authMiddleware } from '../middleware'
20
- import type { Env, Variables } from '../types'
21
-
22
- const TEST_SECRET = 'super-secret-key-used-only-in-the-vitest-suite-min-length'
23
-
24
- describe('JWT claims pass-through (sprint 04-pre)', () => {
25
- const tokenService = new JoseTokenService(TEST_SECRET, {}, SystemClock)
26
-
27
- async function buildApp() {
28
- const app = new Hono<{ Bindings: Env; Variables: Variables }>()
29
-
30
- app.use('*', async (c, next) => {
31
- c.set('tokenService', tokenService)
32
- await next()
33
- })
34
-
35
- app.use('/protected', authMiddleware())
36
-
37
- app.get('/protected', (c) => {
38
- const payload = c.get('jwtPayload')
39
- return c.json(payload)
40
- })
41
-
42
- return app
43
- }
44
-
45
- it('role and surname claims survive the authMiddleware round-trip', async () => {
46
- const app = await buildApp()
47
-
48
- const claims: JwtClaims = {
49
- sub: 'user-123',
50
- email: 'admin@example.com',
51
- name: 'Admin',
52
- surname: 'User',
53
- role: 'admin',
54
- }
55
-
56
- const token = await tokenService.issue(claims)
57
-
58
- const res = await app.request('/protected', {
59
- method: 'GET',
60
- headers: { Authorization: `Bearer ${token}` },
61
- })
62
-
63
- expect(res.status).toBe(200)
64
- const body = await res.json<JwtClaims>()
65
- expect(body.sub).toBe('user-123')
66
- expect(body.role).toBe('admin')
67
- expect(body.surname).toBe('User')
68
- expect(body.email).toBe('admin@example.com')
69
- })
70
-
71
- it('a token without role/surname returns undefined for those fields', async () => {
72
- const app = await buildApp()
73
-
74
- const token = await tokenService.issue({ sub: 'user-456', email: 'plain@example.com' })
75
-
76
- const res = await app.request('/protected', {
77
- method: 'GET',
78
- headers: { Authorization: `Bearer ${token}` },
79
- })
80
-
81
- expect(res.status).toBe(200)
82
- const body = await res.json<JwtClaims>()
83
- expect(body.sub).toBe('user-456')
84
- expect(body.role).toBeUndefined()
85
- expect(body.surname).toBeUndefined()
86
- })
87
- })
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
+ /**
6
+ * Sprint 04-pre Part B5 — JWT claims pass-through test.
7
+ *
8
+ * Verifies that `role` and `surname` claims issued in a JWT token are
9
+ * preserved end-to-end through the authMiddleware and available on
10
+ * `context.get('jwtPayload')`. Without the JwtClaims unification these
11
+ * fields would be type-erased and come back undefined.
12
+ */
13
+
14
+ import { describe, it, expect } from 'vitest'
15
+ import { Hono } from 'hono'
16
+ import { SystemClock } from '@beechcms/core'
17
+ import type { JwtClaims } from '@beechcms/core'
18
+ import { JoseTokenService } from './jose-token-service'
19
+ import { authMiddleware } from '../middleware'
20
+ import type { Env, Variables } from '../types'
21
+
22
+ const TEST_SECRET = 'super-secret-key-used-only-in-the-vitest-suite-min-length'
23
+
24
+ describe('JWT claims pass-through (sprint 04-pre)', () => {
25
+ const tokenService = new JoseTokenService(TEST_SECRET, {}, SystemClock)
26
+
27
+ async function buildApp() {
28
+ const app = new Hono<{ Bindings: Env; Variables: Variables }>()
29
+
30
+ app.use('*', async (c, next) => {
31
+ c.set('tokenService', tokenService)
32
+ await next()
33
+ })
34
+
35
+ app.use('/protected', authMiddleware())
36
+
37
+ app.get('/protected', (c) => {
38
+ const payload = c.get('jwtPayload')
39
+ return c.json(payload)
40
+ })
41
+
42
+ return app
43
+ }
44
+
45
+ it('role and surname claims survive the authMiddleware round-trip', async () => {
46
+ const app = await buildApp()
47
+
48
+ const claims: JwtClaims = {
49
+ sub: 'user-123',
50
+ email: 'admin@example.com',
51
+ name: 'Admin',
52
+ surname: 'User',
53
+ role: 'admin',
54
+ }
55
+
56
+ const token = await tokenService.issue(claims)
57
+
58
+ const res = await app.request('/protected', {
59
+ method: 'GET',
60
+ headers: { Authorization: `Bearer ${token}` },
61
+ })
62
+
63
+ expect(res.status).toBe(200)
64
+ const body = await res.json<JwtClaims>()
65
+ expect(body.sub).toBe('user-123')
66
+ expect(body.role).toBe('admin')
67
+ expect(body.surname).toBe('User')
68
+ expect(body.email).toBe('admin@example.com')
69
+ })
70
+
71
+ it('a token without role/surname returns undefined for those fields', async () => {
72
+ const app = await buildApp()
73
+
74
+ const token = await tokenService.issue({ sub: 'user-456', email: 'plain@example.com' })
75
+
76
+ const res = await app.request('/protected', {
77
+ method: 'GET',
78
+ headers: { Authorization: `Bearer ${token}` },
79
+ })
80
+
81
+ expect(res.status).toBe(200)
82
+ const body = await res.json<JwtClaims>()
83
+ expect(body.sub).toBe('user-456')
84
+ expect(body.role).toBeUndefined()
85
+ expect(body.surname).toBeUndefined()
86
+ })
87
+ })
@@ -1,100 +1,100 @@
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 } from 'vitest'
6
- import { parseLoginBody, validateLoginInput, verifyPassword, DUMMY_PASSWORD_HASH } from './login'
7
- import { InMemoryHashProvider } from './__fixtures__/in-memory-hash-provider'
8
-
9
- describe('parseLoginBody', () => {
10
- it('returns credentials for a valid object body', () => {
11
- expect(parseLoginBody({ email: 'user@test.com', password: 'pass1234' }))
12
- .toEqual({ email: 'user@test.com', password: 'pass1234' })
13
- })
14
-
15
- it('trims leading and trailing whitespace from email', () => {
16
- expect(parseLoginBody({ email: ' user@test.com ', password: 'pass' }))
17
- .toEqual({ email: 'user@test.com', password: 'pass' })
18
- })
19
-
20
- it('returns null for non-object input', () => {
21
- expect(parseLoginBody(null)).toBeNull()
22
- expect(parseLoginBody('string')).toBeNull()
23
- expect(parseLoginBody(42)).toBeNull()
24
- expect(parseLoginBody(undefined)).toBeNull()
25
- })
26
-
27
- it('returns null when email field is missing', () => {
28
- expect(parseLoginBody({ password: 'pass' })).toBeNull()
29
- })
30
-
31
- it('returns null when password field is missing', () => {
32
- expect(parseLoginBody({ email: 'x@x.com' })).toBeNull()
33
- })
34
-
35
- it('returns null when email is an empty string after trimming', () => {
36
- expect(parseLoginBody({ email: ' ', password: 'pass' })).toBeNull()
37
- })
38
-
39
- it('returns null when email is not a string', () => {
40
- expect(parseLoginBody({ email: 42, password: 'pass' })).toBeNull()
41
- })
42
- })
43
-
44
- describe('validateLoginInput', () => {
45
- it('accepts a valid email and an 8-character password', () => {
46
- expect(validateLoginInput('user@test.com', '12345678')).toBe(true)
47
- })
48
-
49
- it('rejects an email without an @ sign', () => {
50
- expect(validateLoginInput('notanemail', 'password123')).toBe(false)
51
- })
52
-
53
- it('rejects an email with nothing before the @', () => {
54
- expect(validateLoginInput('@test.com', 'password123')).toBe(false)
55
- })
56
-
57
- it('rejects an email with no domain extension', () => {
58
- expect(validateLoginInput('user@nodot', 'password123')).toBe(false)
59
- })
60
-
61
- it('rejects a password shorter than 8 characters', () => {
62
- expect(validateLoginInput('user@test.com', '1234567')).toBe(false)
63
- })
64
-
65
- it('rejects a password longer than 128 characters', () => {
66
- expect(validateLoginInput('user@test.com', 'a'.repeat(129))).toBe(false)
67
- })
68
-
69
- it('accepts passwords at the lower boundary (exactly 8 characters)', () => {
70
- expect(validateLoginInput('user@test.com', 'a'.repeat(8))).toBe(true)
71
- })
72
-
73
- it('accepts passwords at the upper boundary (exactly 128 characters)', () => {
74
- expect(validateLoginInput('user@test.com', 'a'.repeat(128))).toBe(true)
75
- })
76
-
77
- it('rejects a password made only of whitespace', () => {
78
- expect(validateLoginInput('user@test.com', ' '.repeat(8))).toBe(false)
79
- })
80
- })
81
-
82
- describe('verifyPassword', () => {
83
- const hashProvider = new InMemoryHashProvider()
84
-
85
- it('returns true when the plaintext matches the stored hash', async () => {
86
- const hash = await hashProvider.hash('mypassword')
87
- expect(await verifyPassword('mypassword', hash, hashProvider)).toBe(true)
88
- })
89
-
90
- it('returns false when the plaintext does not match', async () => {
91
- const hash = await hashProvider.hash('correct')
92
- expect(await verifyPassword('wrong', hash, hashProvider)).toBe(false)
93
- })
94
- })
95
-
96
- describe('DUMMY_PASSWORD_HASH', () => {
97
- it('has bcrypt format so constant-time comparison runs even when no user is found', () => {
98
- expect(DUMMY_PASSWORD_HASH).toMatch(/^\$2[aby]\$\d+\$/)
99
- })
100
- })
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 } from 'vitest'
6
+ import { parseLoginBody, validateLoginInput, verifyPassword, DUMMY_PASSWORD_HASH } from './login'
7
+ import { InMemoryHashProvider } from './__fixtures__/in-memory-hash-provider'
8
+
9
+ describe('parseLoginBody', () => {
10
+ it('returns credentials for a valid object body', () => {
11
+ expect(parseLoginBody({ email: 'user@test.com', password: 'pass1234' }))
12
+ .toEqual({ email: 'user@test.com', password: 'pass1234' })
13
+ })
14
+
15
+ it('trims leading and trailing whitespace from email', () => {
16
+ expect(parseLoginBody({ email: ' user@test.com ', password: 'pass' }))
17
+ .toEqual({ email: 'user@test.com', password: 'pass' })
18
+ })
19
+
20
+ it('returns null for non-object input', () => {
21
+ expect(parseLoginBody(null)).toBeNull()
22
+ expect(parseLoginBody('string')).toBeNull()
23
+ expect(parseLoginBody(42)).toBeNull()
24
+ expect(parseLoginBody(undefined)).toBeNull()
25
+ })
26
+
27
+ it('returns null when email field is missing', () => {
28
+ expect(parseLoginBody({ password: 'pass' })).toBeNull()
29
+ })
30
+
31
+ it('returns null when password field is missing', () => {
32
+ expect(parseLoginBody({ email: 'x@x.com' })).toBeNull()
33
+ })
34
+
35
+ it('returns null when email is an empty string after trimming', () => {
36
+ expect(parseLoginBody({ email: ' ', password: 'pass' })).toBeNull()
37
+ })
38
+
39
+ it('returns null when email is not a string', () => {
40
+ expect(parseLoginBody({ email: 42, password: 'pass' })).toBeNull()
41
+ })
42
+ })
43
+
44
+ describe('validateLoginInput', () => {
45
+ it('accepts a valid email and an 8-character password', () => {
46
+ expect(validateLoginInput('user@test.com', '12345678')).toBe(true)
47
+ })
48
+
49
+ it('rejects an email without an @ sign', () => {
50
+ expect(validateLoginInput('notanemail', 'password123')).toBe(false)
51
+ })
52
+
53
+ it('rejects an email with nothing before the @', () => {
54
+ expect(validateLoginInput('@test.com', 'password123')).toBe(false)
55
+ })
56
+
57
+ it('rejects an email with no domain extension', () => {
58
+ expect(validateLoginInput('user@nodot', 'password123')).toBe(false)
59
+ })
60
+
61
+ it('rejects a password shorter than 8 characters', () => {
62
+ expect(validateLoginInput('user@test.com', '1234567')).toBe(false)
63
+ })
64
+
65
+ it('rejects a password longer than 128 characters', () => {
66
+ expect(validateLoginInput('user@test.com', 'a'.repeat(129))).toBe(false)
67
+ })
68
+
69
+ it('accepts passwords at the lower boundary (exactly 8 characters)', () => {
70
+ expect(validateLoginInput('user@test.com', 'a'.repeat(8))).toBe(true)
71
+ })
72
+
73
+ it('accepts passwords at the upper boundary (exactly 128 characters)', () => {
74
+ expect(validateLoginInput('user@test.com', 'a'.repeat(128))).toBe(true)
75
+ })
76
+
77
+ it('rejects a password made only of whitespace', () => {
78
+ expect(validateLoginInput('user@test.com', ' '.repeat(8))).toBe(false)
79
+ })
80
+ })
81
+
82
+ describe('verifyPassword', () => {
83
+ const hashProvider = new InMemoryHashProvider()
84
+
85
+ it('returns true when the plaintext matches the stored hash', async () => {
86
+ const hash = await hashProvider.hash('mypassword')
87
+ expect(await verifyPassword('mypassword', hash, hashProvider)).toBe(true)
88
+ })
89
+
90
+ it('returns false when the plaintext does not match', async () => {
91
+ const hash = await hashProvider.hash('correct')
92
+ expect(await verifyPassword('wrong', hash, hashProvider)).toBe(false)
93
+ })
94
+ })
95
+
96
+ describe('DUMMY_PASSWORD_HASH', () => {
97
+ it('has bcrypt format so constant-time comparison runs even when no user is found', () => {
98
+ expect(DUMMY_PASSWORD_HASH).toMatch(/^\$2[aby]\$\d+\$/)
99
+ })
100
+ })
package/src/auth/login.ts CHANGED
@@ -1,78 +1,78 @@
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
- /// <reference types="@cloudflare/workers-types" />
6
- import type { IHashProvider } from '@beechcms/core'
7
-
8
- export type LoginCredentials = {
9
- email: string
10
- password: string
11
- }
12
-
13
- /**
14
- * Regex per validare formato email.
15
- * Utilizza classi di caratteri che non si sovrappongono per evitare il backtracking catastrofico (ReDoS).
16
- */
17
- const EMAIL_REGEX = /^[^\s@]+@[^\s@.]+(?:\.[^\s@.]+)+$/
18
- /** Lunghezza massima email secondo standard RFC 5321 */
19
- const MAX_EMAIL_LENGTH = 254
20
-
21
- /** Lunghezza minima password (caratteri) */
22
- const MIN_PASSWORD_LENGTH = 8
23
-
24
- /** Lunghezza massima password (caratteri) - limite ragionevole per evitare DoS */
25
- const MAX_PASSWORD_LENGTH = 128
26
-
27
- /**
28
- * Hash bcrypt dummy valido.
29
- * Usato quando l'utente non esiste per evitare timing attack
30
- * (stesso tempo di risposta che con password errata).
31
- */
32
- export const DUMMY_PASSWORD_HASH =
33
- '$2a$10$SbkRFOafACxVM2ahxerVDu3tSkCXWm29b62WdB.4WGG02Qjsfzni6'
34
-
35
- /**
36
- * Estrae e valida email e password dal body della richiesta.
37
- * @param body - Body grezzo (tipicamente da req.json())
38
- * @returns Oggetto {email, password} se valido, null altrimenti
39
- */
40
- export function parseLoginBody(body: unknown): LoginCredentials | null {
41
- if (body === null || typeof body !== 'object') return null
42
- const obj = body as Record<string, unknown>
43
- const email = obj.email
44
- const password = obj.password
45
- if (typeof email !== 'string' || typeof password !== 'string') return null
46
- if (!email.trim() || !password) return null
47
- return { email: email.trim(), password }
48
- }
49
-
50
- /**
51
- * Verifica che email e password rispettino i formati richiesti.
52
- * @param email - Email da validare (deve contenere @ e punto dopo @)
53
- * @param password - Password (8-128 caratteri)
54
- * @returns true se valido
55
- */
56
- export function validateLoginInput(email: string, password: string): boolean {
57
- return (
58
- email.length <= MAX_EMAIL_LENGTH &&
59
- EMAIL_REGEX.test(email) &&
60
- password.trim().length >= MIN_PASSWORD_LENGTH &&
61
- password.length <= MAX_PASSWORD_LENGTH
62
- )
63
- }
64
-
65
- /**
66
- * Verifica che la password in chiaro corrisponda all'hash salvato.
67
- * @param plainPassword - Password in chiaro
68
- * @param hash - Hash salvato nel DB
69
- * @param hashProvider - Provider usato per la comparazione costante-time
70
- * @returns true se la password è corretta
71
- */
72
- export async function verifyPassword(
73
- plainPassword: string,
74
- hash: string,
75
- hashProvider: IHashProvider
76
- ): Promise<boolean> {
77
- return hashProvider.verify(plainPassword, hash)
78
- }
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
+ /// <reference types="@cloudflare/workers-types" />
6
+ import type { IHashProvider } from '@beechcms/core'
7
+
8
+ export type LoginCredentials = {
9
+ email: string
10
+ password: string
11
+ }
12
+
13
+ /**
14
+ * Regex per validare formato email.
15
+ * Utilizza classi di caratteri che non si sovrappongono per evitare il backtracking catastrofico (ReDoS).
16
+ */
17
+ const EMAIL_REGEX = /^[^\s@]+@[^\s@.]+(?:\.[^\s@.]+)+$/
18
+ /** Lunghezza massima email secondo standard RFC 5321 */
19
+ const MAX_EMAIL_LENGTH = 254
20
+
21
+ /** Lunghezza minima password (caratteri) */
22
+ const MIN_PASSWORD_LENGTH = 8
23
+
24
+ /** Lunghezza massima password (caratteri) - limite ragionevole per evitare DoS */
25
+ const MAX_PASSWORD_LENGTH = 128
26
+
27
+ /**
28
+ * Hash bcrypt dummy valido.
29
+ * Usato quando l'utente non esiste per evitare timing attack
30
+ * (stesso tempo di risposta che con password errata).
31
+ */
32
+ export const DUMMY_PASSWORD_HASH =
33
+ '$2a$10$SbkRFOafACxVM2ahxerVDu3tSkCXWm29b62WdB.4WGG02Qjsfzni6'
34
+
35
+ /**
36
+ * Estrae e valida email e password dal body della richiesta.
37
+ * @param body - Body grezzo (tipicamente da req.json())
38
+ * @returns Oggetto {email, password} se valido, null altrimenti
39
+ */
40
+ export function parseLoginBody(body: unknown): LoginCredentials | null {
41
+ if (body === null || typeof body !== 'object') return null
42
+ const obj = body as Record<string, unknown>
43
+ const email = obj.email
44
+ const password = obj.password
45
+ if (typeof email !== 'string' || typeof password !== 'string') return null
46
+ if (!email.trim() || !password) return null
47
+ return { email: email.trim(), password }
48
+ }
49
+
50
+ /**
51
+ * Verifica che email e password rispettino i formati richiesti.
52
+ * @param email - Email da validare (deve contenere @ e punto dopo @)
53
+ * @param password - Password (8-128 caratteri)
54
+ * @returns true se valido
55
+ */
56
+ export function validateLoginInput(email: string, password: string): boolean {
57
+ return (
58
+ email.length <= MAX_EMAIL_LENGTH &&
59
+ EMAIL_REGEX.test(email) &&
60
+ password.trim().length >= MIN_PASSWORD_LENGTH &&
61
+ password.length <= MAX_PASSWORD_LENGTH
62
+ )
63
+ }
64
+
65
+ /**
66
+ * Verifica che la password in chiaro corrisponda all'hash salvato.
67
+ * @param plainPassword - Password in chiaro
68
+ * @param hash - Hash salvato nel DB
69
+ * @param hashProvider - Provider usato per la comparazione costante-time
70
+ * @returns true se la password è corretta
71
+ */
72
+ export async function verifyPassword(
73
+ plainPassword: string,
74
+ hash: string,
75
+ hashProvider: IHashProvider
76
+ ): Promise<boolean> {
77
+ return hashProvider.verify(plainPassword, hash)
78
+ }