@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,114 +1,114 @@
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, beforeEach, afterEach } from 'vitest'
6
- import { D1SeedLayoutRepository } from './seed-layout.repository.d1'
7
- import type { FormLayout } from '@beechcms/core'
8
-
9
- function makeMockDb(opts: { firstResult?: unknown; allResults?: unknown[] } = {}) {
10
- const { firstResult = null, allResults = [] } = opts
11
- const runMock = vi.fn().mockResolvedValue({ success: true })
12
- const firstMock = vi.fn().mockResolvedValue(firstResult)
13
- const allMock = vi.fn().mockResolvedValue({ results: allResults })
14
- const bindMock = vi.fn(() => ({ run: runMock, first: firstMock, all: allMock }))
15
- const stmt = { bind: bindMock, run: runMock, first: firstMock, all: allMock }
16
- const prepareMock = vi.fn(() => stmt)
17
- return { db: { prepare: prepareMock } as any, prepareMock, bindMock, runMock, firstMock, allMock }
18
- }
19
-
20
- describe('D1SeedLayoutRepository', () => {
21
- beforeEach(() => {
22
- vi.useFakeTimers()
23
- })
24
-
25
- afterEach(() => {
26
- vi.useRealTimers()
27
- })
28
-
29
- describe('get', () => {
30
- it('returns null when the layout is not found', async () => {
31
- const { db } = makeMockDb({ firstResult: null })
32
- const repo = new D1SeedLayoutRepository(db)
33
- const res = await repo.get('non-existent')
34
- expect(res).toBeNull()
35
- })
36
-
37
- it('returns mapped record when layout is found and layout JSON is parsed', async () => {
38
- const mockLayout: FormLayout = { tabs: [] }
39
- const row = {
40
- slug: 'pages',
41
- layout: JSON.stringify(mockLayout),
42
- updated_at: 123456,
43
- updated_by: 'admin-user',
44
- }
45
- const { db, prepareMock, bindMock } = makeMockDb({ firstResult: row })
46
- const repo = new D1SeedLayoutRepository(db)
47
-
48
- const res = await repo.get('pages')
49
- expect(prepareMock).toHaveBeenCalledWith(expect.stringContaining('SELECT slug, layout, updated_at, updated_by FROM seed_layouts'))
50
- expect(bindMock).toHaveBeenCalledWith('pages')
51
- expect(res).toEqual({
52
- slug: 'pages',
53
- layout: mockLayout,
54
- updatedAt: 123456,
55
- updatedBy: 'admin-user',
56
- })
57
- })
58
- })
59
-
60
- describe('getAllAsMap', () => {
61
- it('returns an empty map when there are no records', async () => {
62
- const { db } = makeMockDb({ allResults: [] })
63
- const repo = new D1SeedLayoutRepository(db)
64
- const map = await repo.getAllAsMap()
65
- expect(map).toBeInstanceOf(Map)
66
- expect(map.size).toBe(0)
67
- })
68
-
69
- it('returns a populated map and skips corrupt JSON rows', async () => {
70
- const allResults = [
71
- { slug: 'pages', layout: JSON.stringify({ tabs: [{ id: 't1', label: 'T1', sections: [] }] }) },
72
- { slug: 'corrupted', layout: '{invalid-json' },
73
- { slug: 'posts', layout: JSON.stringify({ tabs: [{ id: 't2', label: 'T2', sections: [] }] }) },
74
- ]
75
- const { db, prepareMock } = makeMockDb({ allResults })
76
- const repo = new D1SeedLayoutRepository(db)
77
-
78
- const map = await repo.getAllAsMap()
79
- expect(prepareMock).toHaveBeenCalledWith(expect.stringContaining('SELECT slug, layout FROM seed_layouts'))
80
- expect(map.size).toBe(2)
81
- expect(map.get('pages')).toEqual({ tabs: [{ id: 't1', label: 'T1', sections: [] }] })
82
- expect(map.get('posts')).toEqual({ tabs: [{ id: 't2', label: 'T2', sections: [] }] })
83
- expect(map.has('corrupted')).toBe(false)
84
- })
85
- })
86
-
87
- describe('upsert', () => {
88
- it('prepares and binds the correct layout layout JSON and timestamp', async () => {
89
- const mockDate = new Date('2026-06-04T12:00:00Z')
90
- vi.setSystemTime(mockDate)
91
- const expectedTimestamp = Math.floor(mockDate.getTime() / 1000)
92
-
93
- const { db, prepareMock, bindMock } = makeMockDb()
94
- const repo = new D1SeedLayoutRepository(db)
95
-
96
- const layout: FormLayout = { tabs: [{ id: 'tab-1', label: 'Tab 1', sections: [] }] }
97
- await repo.upsert('articles', layout, 'editor-1')
98
-
99
- expect(prepareMock).toHaveBeenCalledWith(expect.stringContaining('INSERT INTO seed_layouts'))
100
- expect(bindMock).toHaveBeenCalledWith('articles', JSON.stringify(layout), expectedTimestamp, 'editor-1')
101
- })
102
- })
103
-
104
- describe('remove', () => {
105
- it('deletes the layout by slug', async () => {
106
- const { db, prepareMock, bindMock } = makeMockDb()
107
- const repo = new D1SeedLayoutRepository(db)
108
-
109
- await repo.remove('products')
110
- expect(prepareMock).toHaveBeenCalledWith(expect.stringContaining('DELETE FROM seed_layouts WHERE slug = ?'))
111
- expect(bindMock).toHaveBeenCalledWith('products')
112
- })
113
- })
114
- })
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, beforeEach, afterEach } from 'vitest'
6
+ import { D1SeedLayoutRepository } from './seed-layout.repository.d1'
7
+ import type { FormLayout } from '@beechcms/core'
8
+
9
+ function makeMockDb(opts: { firstResult?: unknown; allResults?: unknown[] } = {}) {
10
+ const { firstResult = null, allResults = [] } = opts
11
+ const runMock = vi.fn().mockResolvedValue({ success: true })
12
+ const firstMock = vi.fn().mockResolvedValue(firstResult)
13
+ const allMock = vi.fn().mockResolvedValue({ results: allResults })
14
+ const bindMock = vi.fn(() => ({ run: runMock, first: firstMock, all: allMock }))
15
+ const stmt = { bind: bindMock, run: runMock, first: firstMock, all: allMock }
16
+ const prepareMock = vi.fn(() => stmt)
17
+ return { db: { prepare: prepareMock } as any, prepareMock, bindMock, runMock, firstMock, allMock }
18
+ }
19
+
20
+ describe('D1SeedLayoutRepository', () => {
21
+ beforeEach(() => {
22
+ vi.useFakeTimers()
23
+ })
24
+
25
+ afterEach(() => {
26
+ vi.useRealTimers()
27
+ })
28
+
29
+ describe('get', () => {
30
+ it('returns null when the layout is not found', async () => {
31
+ const { db } = makeMockDb({ firstResult: null })
32
+ const repo = new D1SeedLayoutRepository(db)
33
+ const res = await repo.get('non-existent')
34
+ expect(res).toBeNull()
35
+ })
36
+
37
+ it('returns mapped record when layout is found and layout JSON is parsed', async () => {
38
+ const mockLayout: FormLayout = { tabs: [] }
39
+ const row = {
40
+ slug: 'pages',
41
+ layout: JSON.stringify(mockLayout),
42
+ updated_at: 123456,
43
+ updated_by: 'admin-user',
44
+ }
45
+ const { db, prepareMock, bindMock } = makeMockDb({ firstResult: row })
46
+ const repo = new D1SeedLayoutRepository(db)
47
+
48
+ const res = await repo.get('pages')
49
+ expect(prepareMock).toHaveBeenCalledWith(expect.stringContaining('SELECT slug, layout, updated_at, updated_by FROM seed_layouts'))
50
+ expect(bindMock).toHaveBeenCalledWith('pages')
51
+ expect(res).toEqual({
52
+ slug: 'pages',
53
+ layout: mockLayout,
54
+ updatedAt: 123456,
55
+ updatedBy: 'admin-user',
56
+ })
57
+ })
58
+ })
59
+
60
+ describe('getAllAsMap', () => {
61
+ it('returns an empty map when there are no records', async () => {
62
+ const { db } = makeMockDb({ allResults: [] })
63
+ const repo = new D1SeedLayoutRepository(db)
64
+ const map = await repo.getAllAsMap()
65
+ expect(map).toBeInstanceOf(Map)
66
+ expect(map.size).toBe(0)
67
+ })
68
+
69
+ it('returns a populated map and skips corrupt JSON rows', async () => {
70
+ const allResults = [
71
+ { slug: 'pages', layout: JSON.stringify({ tabs: [{ id: 't1', label: 'T1', sections: [] }] }) },
72
+ { slug: 'corrupted', layout: '{invalid-json' },
73
+ { slug: 'posts', layout: JSON.stringify({ tabs: [{ id: 't2', label: 'T2', sections: [] }] }) },
74
+ ]
75
+ const { db, prepareMock } = makeMockDb({ allResults })
76
+ const repo = new D1SeedLayoutRepository(db)
77
+
78
+ const map = await repo.getAllAsMap()
79
+ expect(prepareMock).toHaveBeenCalledWith(expect.stringContaining('SELECT slug, layout FROM seed_layouts'))
80
+ expect(map.size).toBe(2)
81
+ expect(map.get('pages')).toEqual({ tabs: [{ id: 't1', label: 'T1', sections: [] }] })
82
+ expect(map.get('posts')).toEqual({ tabs: [{ id: 't2', label: 'T2', sections: [] }] })
83
+ expect(map.has('corrupted')).toBe(false)
84
+ })
85
+ })
86
+
87
+ describe('upsert', () => {
88
+ it('prepares and binds the correct layout layout JSON and timestamp', async () => {
89
+ const mockDate = new Date('2026-06-04T12:00:00Z')
90
+ vi.setSystemTime(mockDate)
91
+ const expectedTimestamp = Math.floor(mockDate.getTime() / 1000)
92
+
93
+ const { db, prepareMock, bindMock } = makeMockDb()
94
+ const repo = new D1SeedLayoutRepository(db)
95
+
96
+ const layout: FormLayout = { tabs: [{ id: 'tab-1', label: 'Tab 1', sections: [] }] }
97
+ await repo.upsert('articles', layout, 'editor-1')
98
+
99
+ expect(prepareMock).toHaveBeenCalledWith(expect.stringContaining('INSERT INTO seed_layouts'))
100
+ expect(bindMock).toHaveBeenCalledWith('articles', JSON.stringify(layout), expectedTimestamp, 'editor-1')
101
+ })
102
+ })
103
+
104
+ describe('remove', () => {
105
+ it('deletes the layout by slug', async () => {
106
+ const { db, prepareMock, bindMock } = makeMockDb()
107
+ const repo = new D1SeedLayoutRepository(db)
108
+
109
+ await repo.remove('products')
110
+ expect(prepareMock).toHaveBeenCalledWith(expect.stringContaining('DELETE FROM seed_layouts WHERE slug = ?'))
111
+ expect(bindMock).toHaveBeenCalledWith('products')
112
+ })
113
+ })
114
+ })
@@ -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
- /// <reference types="@cloudflare/workers-types" />
6
- import type { ISeedLayoutRepository, SeedLayoutRecord, FormLayout } from '@beechcms/core'
7
-
8
- export class D1SeedLayoutRepository implements ISeedLayoutRepository {
9
- constructor(private readonly db: D1Database) {}
10
-
11
- async get(slug: string): Promise<SeedLayoutRecord | null> {
12
- const row = await this.db
13
- .prepare('SELECT slug, layout, updated_at, updated_by FROM seed_layouts WHERE slug = ? LIMIT 1')
14
- .bind(slug)
15
- .first<{ slug: string; layout: string; updated_at: number; updated_by: string }>()
16
- if (!row) return null
17
- return {
18
- slug: row.slug,
19
- layout: JSON.parse(row.layout) as FormLayout,
20
- updatedAt: row.updated_at,
21
- updatedBy: row.updated_by,
22
- }
23
- }
24
-
25
- async getAllAsMap(): Promise<Map<string, FormLayout>> {
26
- const rs = await this.db
27
- .prepare('SELECT slug, layout FROM seed_layouts')
28
- .all<{ slug: string; layout: string }>()
29
- const map = new Map<string, FormLayout>()
30
- for (const r of (rs.results ?? [])) {
31
- try {
32
- map.set(r.slug, JSON.parse(r.layout) as FormLayout)
33
- } catch {
34
- // skip corrupt row
35
- }
36
- }
37
- return map
38
- }
39
-
40
- async upsert(slug: string, layout: FormLayout, updatedBy: string): Promise<void> {
41
- const json = JSON.stringify(layout)
42
- const now = Math.floor(Date.now() / 1000)
43
- await this.db
44
- .prepare(`
45
- INSERT INTO seed_layouts (slug, layout, updated_at, updated_by)
46
- VALUES (?, ?, ?, ?)
47
- ON CONFLICT(slug) DO UPDATE SET
48
- layout = excluded.layout,
49
- updated_at = excluded.updated_at,
50
- updated_by = excluded.updated_by
51
- `)
52
- .bind(slug, json, now, updatedBy)
53
- .run()
54
- }
55
-
56
- async remove(slug: string): Promise<void> {
57
- await this.db
58
- .prepare('DELETE FROM seed_layouts WHERE slug = ?')
59
- .bind(slug)
60
- .run()
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
+ /// <reference types="@cloudflare/workers-types" />
6
+ import type { ISeedLayoutRepository, SeedLayoutRecord, FormLayout } from '@beechcms/core'
7
+
8
+ export class D1SeedLayoutRepository implements ISeedLayoutRepository {
9
+ constructor(private readonly db: D1Database) {}
10
+
11
+ async get(slug: string): Promise<SeedLayoutRecord | null> {
12
+ const row = await this.db
13
+ .prepare('SELECT slug, layout, updated_at, updated_by FROM seed_layouts WHERE slug = ? LIMIT 1')
14
+ .bind(slug)
15
+ .first<{ slug: string; layout: string; updated_at: number; updated_by: string }>()
16
+ if (!row) return null
17
+ return {
18
+ slug: row.slug,
19
+ layout: JSON.parse(row.layout) as FormLayout,
20
+ updatedAt: row.updated_at,
21
+ updatedBy: row.updated_by,
22
+ }
23
+ }
24
+
25
+ async getAllAsMap(): Promise<Map<string, FormLayout>> {
26
+ const rs = await this.db
27
+ .prepare('SELECT slug, layout FROM seed_layouts')
28
+ .all<{ slug: string; layout: string }>()
29
+ const map = new Map<string, FormLayout>()
30
+ for (const r of (rs.results ?? [])) {
31
+ try {
32
+ map.set(r.slug, JSON.parse(r.layout) as FormLayout)
33
+ } catch {
34
+ // skip corrupt row
35
+ }
36
+ }
37
+ return map
38
+ }
39
+
40
+ async upsert(slug: string, layout: FormLayout, updatedBy: string): Promise<void> {
41
+ const json = JSON.stringify(layout)
42
+ const now = Math.floor(Date.now() / 1000)
43
+ await this.db
44
+ .prepare(`
45
+ INSERT INTO seed_layouts (slug, layout, updated_at, updated_by)
46
+ VALUES (?, ?, ?, ?)
47
+ ON CONFLICT(slug) DO UPDATE SET
48
+ layout = excluded.layout,
49
+ updated_at = excluded.updated_at,
50
+ updated_by = excluded.updated_by
51
+ `)
52
+ .bind(slug, json, now, updatedBy)
53
+ .run()
54
+ }
55
+
56
+ async remove(slug: string): Promise<void> {
57
+ await this.db
58
+ .prepare('DELETE FROM seed_layouts WHERE slug = ?')
59
+ .bind(slug)
60
+ .run()
61
+ }
62
+ }
@@ -1,68 +1,68 @@
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, beforeEach } from 'vitest'
6
- import { getHydratedRegistry, __resetSeedRegistryCache } from './seed-registry-cache'
7
- import type { ISeedRepository, SeedRecord, Seed } from '@beechcms/core'
8
-
9
- const mockSeed: Seed = {
10
- slug: 'posts',
11
- label: 'Posts',
12
- displayNameAlias: 'title',
13
- branches: [{ id: 'br_01', alias: 'title', label: 'Title', type: 'text' }],
14
- }
15
-
16
- function makeRepo(version: number, seeds: Seed[] = [mockSeed]): ISeedRepository & { listActive: ReturnType<typeof vi.fn> } {
17
- return {
18
- listActive: vi.fn().mockResolvedValue(seeds),
19
- listAll: vi.fn().mockResolvedValue([]),
20
- get: vi.fn().mockResolvedValue(null),
21
- upsert: vi.fn().mockResolvedValue(undefined),
22
- softDelete: vi.fn().mockResolvedValue(undefined),
23
- getRegistryVersion: vi.fn().mockResolvedValue(version),
24
- bumpRegistryVersion: vi.fn().mockResolvedValue(version + 1),
25
- }
26
- }
27
-
28
- describe('getHydratedRegistry', () => {
29
- beforeEach(() => __resetSeedRegistryCache())
30
-
31
- it('builds registry on first call and calls listActive once', async () => {
32
- const repo = makeRepo(1)
33
- const { registry } = await getHydratedRegistry(repo)
34
- expect(repo.listActive).toHaveBeenCalledTimes(1)
35
- expect(registry.get('posts')).not.toBeNull()
36
- })
37
-
38
- it('reuses cached registry when version and TTL match', async () => {
39
- const repo = makeRepo(1)
40
- await getHydratedRegistry(repo)
41
- await getHydratedRegistry(repo)
42
- expect(repo.listActive).toHaveBeenCalledTimes(1)
43
- })
44
-
45
- it('rebuilds when version token changes', async () => {
46
- const repo1 = makeRepo(1)
47
- await getHydratedRegistry(repo1)
48
- expect(repo1.listActive).toHaveBeenCalledTimes(1)
49
-
50
- const repo2 = makeRepo(2)
51
- await getHydratedRegistry(repo2)
52
- expect(repo2.listActive).toHaveBeenCalledTimes(1)
53
- })
54
-
55
- it('empty listActive produces empty registry without throwing', async () => {
56
- const repo = makeRepo(1, [])
57
- const { registry } = await getHydratedRegistry(repo)
58
- expect(registry.all()).toHaveLength(0)
59
- expect(registry.get('posts')).toBeNull()
60
- })
61
-
62
- it('backrefMap is returned alongside registry', async () => {
63
- const repo = makeRepo(1)
64
- const { backrefMap } = await getHydratedRegistry(repo)
65
- expect(backrefMap).toBeDefined()
66
- expect(typeof backrefMap).toBe('object')
67
- })
68
- })
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, beforeEach } from 'vitest'
6
+ import { getHydratedRegistry, __resetSeedRegistryCache } from './seed-registry-cache'
7
+ import type { ISeedRepository, SeedRecord, Seed } from '@beechcms/core'
8
+
9
+ const mockSeed: Seed = {
10
+ slug: 'posts',
11
+ label: 'Posts',
12
+ displayNameAlias: 'title',
13
+ branches: [{ id: 'br_01', alias: 'title', label: 'Title', type: 'text' }],
14
+ }
15
+
16
+ function makeRepo(version: number, seeds: Seed[] = [mockSeed]): ISeedRepository & { listActive: ReturnType<typeof vi.fn> } {
17
+ return {
18
+ listActive: vi.fn().mockResolvedValue(seeds),
19
+ listAll: vi.fn().mockResolvedValue([]),
20
+ get: vi.fn().mockResolvedValue(null),
21
+ upsert: vi.fn().mockResolvedValue(undefined),
22
+ softDelete: vi.fn().mockResolvedValue(undefined),
23
+ getRegistryVersion: vi.fn().mockResolvedValue(version),
24
+ bumpRegistryVersion: vi.fn().mockResolvedValue(version + 1),
25
+ }
26
+ }
27
+
28
+ describe('getHydratedRegistry', () => {
29
+ beforeEach(() => __resetSeedRegistryCache())
30
+
31
+ it('builds registry on first call and calls listActive once', async () => {
32
+ const repo = makeRepo(1)
33
+ const { registry } = await getHydratedRegistry(repo)
34
+ expect(repo.listActive).toHaveBeenCalledTimes(1)
35
+ expect(registry.get('posts')).not.toBeNull()
36
+ })
37
+
38
+ it('reuses cached registry when version and TTL match', async () => {
39
+ const repo = makeRepo(1)
40
+ await getHydratedRegistry(repo)
41
+ await getHydratedRegistry(repo)
42
+ expect(repo.listActive).toHaveBeenCalledTimes(1)
43
+ })
44
+
45
+ it('rebuilds when version token changes', async () => {
46
+ const repo1 = makeRepo(1)
47
+ await getHydratedRegistry(repo1)
48
+ expect(repo1.listActive).toHaveBeenCalledTimes(1)
49
+
50
+ const repo2 = makeRepo(2)
51
+ await getHydratedRegistry(repo2)
52
+ expect(repo2.listActive).toHaveBeenCalledTimes(1)
53
+ })
54
+
55
+ it('empty listActive produces empty registry without throwing', async () => {
56
+ const repo = makeRepo(1, [])
57
+ const { registry } = await getHydratedRegistry(repo)
58
+ expect(registry.all()).toHaveLength(0)
59
+ expect(registry.get('posts')).toBeNull()
60
+ })
61
+
62
+ it('backrefMap is returned alongside registry', async () => {
63
+ const repo = makeRepo(1)
64
+ const { backrefMap } = await getHydratedRegistry(repo)
65
+ expect(backrefMap).toBeDefined()
66
+ expect(typeof backrefMap).toBe('object')
67
+ })
68
+ })
@@ -1,49 +1,49 @@
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 { SeedRegistry, buildBackrefMap } from '@beechcms/core'
6
- import type { ISeedRegistry, BackrefMap, Seed, ISeedRepository } from '@beechcms/core'
7
-
8
- interface CachedRegistry {
9
- version: number
10
- builtAt: number
11
- registry: ISeedRegistry
12
- backrefMap: BackrefMap
13
- }
14
-
15
- // Module-level = isolate-level. Survives across requests on the same isolate,
16
- // re-initialised on cold start.
17
- let cache: CachedRegistry | null = null
18
-
19
- // Even if the token read fails, never serve a build older than this.
20
- const TTL_MS = 5_000
21
-
22
- /**
23
- * Returns a fresh-enough { registry, backrefMap }. Reads the version token once per
24
- * request (cheap indexed D1 read); rebuilds from listActive() only when the token
25
- * changed or TTL lapsed.
26
- */
27
- export async function getHydratedRegistry(
28
- repo: ISeedRepository,
29
- ): Promise<{ registry: ISeedRegistry; backrefMap: BackrefMap }> {
30
- const version = await repo.getRegistryVersion()
31
- const now = Date.now()
32
- if (cache && cache.version === version && now - cache.builtAt < TTL_MS) {
33
- return { registry: cache.registry, backrefMap: cache.backrefMap }
34
- }
35
- const seeds = await repo.listActive()
36
- return rebuild(seeds, version, now)
37
- }
38
-
39
- function rebuild(seeds: Seed[], version: number, now: number) {
40
- const registry = new SeedRegistry(seeds)
41
- const backrefMap = buildBackrefMap(seeds)
42
- cache = { version, builtAt: now, registry, backrefMap }
43
- return { registry, backrefMap }
44
- }
45
-
46
- /** Test seam: drop the isolate cache. */
47
- export function __resetSeedRegistryCache(): void {
48
- cache = null
49
- }
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 { SeedRegistry, buildBackrefMap } from '@beechcms/core'
6
+ import type { ISeedRegistry, BackrefMap, Seed, ISeedRepository } from '@beechcms/core'
7
+
8
+ interface CachedRegistry {
9
+ version: number
10
+ builtAt: number
11
+ registry: ISeedRegistry
12
+ backrefMap: BackrefMap
13
+ }
14
+
15
+ // Module-level = isolate-level. Survives across requests on the same isolate,
16
+ // re-initialised on cold start.
17
+ let cache: CachedRegistry | null = null
18
+
19
+ // Even if the token read fails, never serve a build older than this.
20
+ const TTL_MS = 5_000
21
+
22
+ /**
23
+ * Returns a fresh-enough { registry, backrefMap }. Reads the version token once per
24
+ * request (cheap indexed D1 read); rebuilds from listActive() only when the token
25
+ * changed or TTL lapsed.
26
+ */
27
+ export async function getHydratedRegistry(
28
+ repo: ISeedRepository,
29
+ ): Promise<{ registry: ISeedRegistry; backrefMap: BackrefMap }> {
30
+ const version = await repo.getRegistryVersion()
31
+ const now = Date.now()
32
+ if (cache && cache.version === version && now - cache.builtAt < TTL_MS) {
33
+ return { registry: cache.registry, backrefMap: cache.backrefMap }
34
+ }
35
+ const seeds = await repo.listActive()
36
+ return rebuild(seeds, version, now)
37
+ }
38
+
39
+ function rebuild(seeds: Seed[], version: number, now: number) {
40
+ const registry = new SeedRegistry(seeds)
41
+ const backrefMap = buildBackrefMap(seeds)
42
+ cache = { version, builtAt: now, registry, backrefMap }
43
+ return { registry, backrefMap }
44
+ }
45
+
46
+ /** Test seam: drop the isolate cache. */
47
+ export function __resetSeedRegistryCache(): void {
48
+ cache = null
49
+ }