@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,267 +1,267 @@
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 type { Automation, IAutomationRepository, ContentRepository, Seed, IIdGenerator } from '@beechcms/core'
7
- import { runCronAutomations } from '../cron-runner'
8
- import type { CronRunnerDeps } from '../cron-runner'
9
-
10
- vi.mock('../action-executors', () => ({
11
- executeAction: vi.fn().mockResolvedValue(undefined),
12
- }))
13
-
14
- import { executeAction } from '../action-executors'
15
- const executeActionMock = executeAction as ReturnType<typeof vi.fn>
16
-
17
- // 2026-05-14T09:00:00Z → minute=0, hour=9, dow=4 (Thursday)
18
- const TICK = new Date('2026-05-14T09:00:00Z').getTime()
19
-
20
- const SEED: Seed = {
21
- slug: 'posts',
22
- label: 'Post',
23
- displayNameAlias: 'title',
24
- branches: [
25
- { id: 'br_01', alias: 'title', type: 'text', label: 'Title' },
26
- { id: 'br_02', alias: 'count', type: 'number', label: 'Count' },
27
- { id: 'br_03', alias: 'published', type: 'boolean', label: 'Published' },
28
- { id: 'br_04', alias: 'publish_date', type: 'date', label: 'Publish Date' },
29
- { id: 'br_05', alias: 'tags_list', type: 'tags', label: 'Tags' },
30
- { id: 'br_06', alias: 'meta_json', type: 'json', label: 'Meta JSON' },
31
- { id: 'br_07', alias: 'body_rich', type: 'richtext', label: 'Body' },
32
- ],
33
- }
34
-
35
- const STUB_ID_GENERATOR: IIdGenerator = {
36
- uuid: () => 'test-uuid',
37
- }
38
-
39
- function makeAutomation(overrides: Partial<Automation> = {}): Automation {
40
- return {
41
- id: 'auto_01',
42
- seed_slug: 'posts',
43
- name: 'every-minute',
44
- enabled: true,
45
- triggers: [{ event: 'cron' as const, cron: '* * * * *' }],
46
- trigger_conditions: null,
47
- actions: [{ type: 'webhook', url: 'https://example.com/hook' }],
48
- created_at: 0,
49
- updated_at: 0,
50
- ...overrides,
51
- }
52
- }
53
-
54
- function makeDeps(overrides: Partial<CronRunnerDeps> = {}): CronRunnerDeps & {
55
- listSpy: ReturnType<typeof vi.fn>
56
- findActiveSpy: ReturnType<typeof vi.fn>
57
- } {
58
- const listSpy = vi.fn().mockResolvedValue({ items: [{ id: 'e1', title: 'Hello' }], total: 1 })
59
- const findActiveSpy = vi.fn().mockResolvedValue([makeAutomation()])
60
-
61
- return {
62
- automationRepository: {
63
- findActive: findActiveSpy,
64
- list: vi.fn(), findById: vi.fn(), create: vi.fn(),
65
- update: vi.fn(), toggle: vi.fn(), delete: vi.fn(),
66
- } as unknown as IAutomationRepository,
67
- contentRepository: { findMany: listSpy } as unknown as ContentRepository,
68
- getSeed: (slug: string) => slug === 'posts' ? SEED : null,
69
- env: {},
70
- idGenerator: STUB_ID_GENERATOR,
71
- listSpy,
72
- findActiveSpy,
73
- ...overrides,
74
- }
75
- }
76
-
77
- describe('runCronAutomations', () => {
78
- beforeEach(() => {
79
- executeActionMock.mockReset()
80
- executeActionMock.mockResolvedValue(undefined)
81
- })
82
-
83
- it('calls findActive with ("*", "cron")', async () => {
84
- const deps = makeDeps()
85
- await runCronAutomations(deps, TICK)
86
- expect(deps.findActiveSpy).toHaveBeenCalledWith('*', 'cron')
87
- })
88
-
89
- it('batch actions (webhook, send_mail) run once per automation with batch context', async () => {
90
- const entries = [{ id: 'e1', title: 'A' }, { id: 'e2', title: 'B' }]
91
- const deps = makeDeps()
92
- deps.listSpy.mockResolvedValue({ items: entries, total: 2 })
93
-
94
- await runCronAutomations(deps, TICK)
95
-
96
- expect(executeActionMock).toHaveBeenCalledTimes(1)
97
- const [, ctx] = executeActionMock.mock.calls[0]
98
- // entry is the first entry (for backwards compat); batch count lives in context
99
- expect(ctx.entry).toMatchObject({ id: 'e1', title: 'A' })
100
- expect(ctx.context).toBeDefined()
101
- })
102
-
103
- it('per-entry actions (edit_field, create_entry) run once per matching entry', async () => {
104
- const entries = [{ id: 'e1' }, { id: 'e2' }]
105
- const deps = makeDeps()
106
- deps.findActiveSpy.mockResolvedValue([makeAutomation({ actions: [{ type: 'edit_field', field: 'title', value: 'updated' }] })])
107
- deps.listSpy.mockResolvedValue({ items: entries, total: 2 })
108
-
109
- await runCronAutomations(deps, TICK)
110
-
111
- expect(executeActionMock).toHaveBeenCalledTimes(2)
112
- expect(executeActionMock.mock.calls[0][1].entry).toMatchObject({ id: 'e1' })
113
- expect(executeActionMock.mock.calls[1][1].entry).toMatchObject({ id: 'e2' })
114
- })
115
-
116
- it('skips non-matching cron expression, runs matching one', async () => {
117
- const matchingAuto = makeAutomation({ id: 'auto_match', triggers: [{ event: 'cron', cron: '* * * * *' }] })
118
- const nonMatchingAuto = makeAutomation({ id: 'auto_skip', triggers: [{ event: 'cron', cron: '30 9 * * *' }] })
119
- const entries = [{ id: 'e1' }, { id: 'e2' }]
120
-
121
- const deps = makeDeps()
122
- deps.findActiveSpy.mockResolvedValue([matchingAuto, nonMatchingAuto])
123
- deps.listSpy.mockResolvedValue({ items: entries, total: 2 })
124
-
125
- await runCronAutomations(deps, TICK)
126
-
127
- // webhook = batch, runs once for the matching automation only
128
- expect(executeActionMock).toHaveBeenCalledTimes(1)
129
- })
130
-
131
- it('passes trigger_conditions as translated filters to repository.findMany', async () => {
132
- const auto = makeAutomation({
133
- trigger_conditions: {
134
- kind: 'group',
135
- op: 'AND',
136
- children: [
137
- { kind: 'predicate', left: { kind: 'ref', key: 'this.title' }, op: 'eq', right: { kind: 'literal', value: 'Hello' } },
138
- ],
139
- },
140
- })
141
- const deps = makeDeps()
142
- deps.findActiveSpy.mockResolvedValue([auto])
143
-
144
- await runCronAutomations(deps, TICK)
145
-
146
- const call = deps.listSpy.mock.calls[0]
147
- const options = call[1]
148
- expect(options.filters).toEqual([
149
- { column: 'title', type: 'text', conditions: [{ op: 'eq', value: 'Hello' }] },
150
- ])
151
- })
152
-
153
- it('maps all branch types, system columns, unknown columns, and special operators correctly', async () => {
154
- const auto = makeAutomation({
155
- trigger_conditions: {
156
- kind: 'group',
157
- op: 'AND',
158
- children: [
159
- { kind: 'predicate', left: { kind: 'ref', key: 'this.count' }, op: 'gt', right: { kind: 'literal', value: 5 } },
160
- { kind: 'predicate', left: { kind: 'ref', key: 'this.published' }, op: 'eq', right: { kind: 'literal', value: true } },
161
- { kind: 'predicate', left: { kind: 'ref', key: 'this.publish_date' }, op: 'isempty' },
162
- { kind: 'predicate', left: { kind: 'ref', key: 'this.tags_list' }, op: 'isnotempty' },
163
- { kind: 'predicate', left: { kind: 'ref', key: 'this.meta_json' }, op: 'eq', right: { kind: 'literal', value: '{}' } },
164
- { kind: 'predicate', left: { kind: 'ref', key: 'this.body_rich' }, op: 'contains', right: { kind: 'literal', value: 'hello' } },
165
- { kind: 'predicate', left: { kind: 'ref', key: 'this.status' }, op: 'eq', right: { kind: 'literal', value: 'draft' } },
166
- { kind: 'predicate', left: { kind: 'ref', key: 'this.unknown_custom' }, op: 'eq', right: { kind: 'literal', value: 'test' } },
167
- ],
168
- },
169
- })
170
- const deps = makeDeps()
171
- deps.findActiveSpy.mockResolvedValue([auto])
172
-
173
- await runCronAutomations(deps, TICK)
174
-
175
- const call = deps.listSpy.mock.calls[0]
176
- expect(call[1].filters).toEqual([
177
- { column: 'count', type: 'number', conditions: [{ op: 'gt', value: 5 }] },
178
- { column: 'published', type: 'boolean', conditions: [{ op: 'eq', value: true }] },
179
- { column: 'publish_date', type: 'date', conditions: [{ op: 'is_empty', value: null }] },
180
- { column: 'tags_list', type: 'tags', conditions: [{ op: 'is_not_empty', value: null }] },
181
- { column: 'meta_json', type: 'json', conditions: [{ op: 'eq', value: '{}' }] },
182
- { column: 'body_rich', type: 'text', conditions: [{ op: 'contains', value: 'hello' }] },
183
- { column: 'status', type: 'system', conditions: [{ op: 'eq', value: 'draft' }] },
184
- { column: 'unknown_custom', type: 'text', conditions: [{ op: 'eq', value: 'test' }] },
185
- ])
186
- })
187
-
188
- it('logs warning and skips when getSeed returns null', async () => {
189
- const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {})
190
- const auto = makeAutomation({ seed_slug: 'unknown' })
191
- const deps = makeDeps()
192
- deps.findActiveSpy.mockResolvedValue([auto])
193
-
194
- await runCronAutomations(deps, TICK)
195
-
196
- expect(executeActionMock).not.toHaveBeenCalled()
197
- expect(warnSpy).toHaveBeenCalledWith('[cron] unknown seed', expect.anything())
198
- warnSpy.mockRestore()
199
- })
200
-
201
- it('continues processing remaining per-entry actions when one entry throws', async () => {
202
- const entries = [{ id: 'e1' }, { id: 'e2' }, { id: 'e3' }]
203
- const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {})
204
- const deps = makeDeps()
205
- deps.findActiveSpy.mockResolvedValue([makeAutomation({ actions: [{ type: 'edit_field', field: 'title', value: 'x' }] })])
206
- deps.listSpy.mockResolvedValue({ items: entries, total: 3 })
207
- executeActionMock
208
- .mockResolvedValueOnce(undefined)
209
- .mockRejectedValueOnce(new Error('boom'))
210
- .mockResolvedValueOnce(undefined)
211
-
212
- await runCronAutomations(deps, TICK)
213
-
214
- expect(executeActionMock).toHaveBeenCalledTimes(3)
215
- expect(errorSpy).toHaveBeenCalledWith('[cron] entry action failed', expect.anything())
216
- errorSpy.mockRestore()
217
- })
218
-
219
- it('logs and continues to next automation when repository.findMany throws', async () => {
220
- const auto1 = makeAutomation({ id: 'auto_01' })
221
- const auto2 = makeAutomation({ id: 'auto_02' })
222
- const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {})
223
- const deps = makeDeps()
224
- deps.findActiveSpy.mockResolvedValue([auto1, auto2])
225
- deps.listSpy
226
- .mockRejectedValueOnce(new Error('db error'))
227
- .mockResolvedValueOnce({ items: [{ id: 'e1' }], total: 1 })
228
-
229
- await runCronAutomations(deps, TICK)
230
-
231
- expect(errorSpy).toHaveBeenCalledWith('[cron] fetch entries failed', expect.anything())
232
- // auto2 still processed (webhook = batch, 1 call)
233
- expect(executeActionMock).toHaveBeenCalledTimes(1)
234
- errorSpy.mockRestore()
235
- })
236
-
237
- it('logs error and returns gracefully when findActive throws', async () => {
238
- const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {})
239
- const deps = makeDeps()
240
- deps.findActiveSpy.mockRejectedValueOnce(new Error('no such table'))
241
-
242
- await expect(runCronAutomations(deps, TICK)).resolves.toBeUndefined()
243
- expect(errorSpy).toHaveBeenCalledWith(
244
- expect.stringContaining('[cron] Failed to fetch automations'),
245
- expect.anything(),
246
- )
247
- expect(executeActionMock).not.toHaveBeenCalled()
248
- errorSpy.mockRestore()
249
- })
250
-
251
- it('resolves quietly with zero calls when no active automations exist', async () => {
252
- const deps = makeDeps()
253
- deps.findActiveSpy.mockResolvedValue([])
254
-
255
- await expect(runCronAutomations(deps, TICK)).resolves.toBeUndefined()
256
- expect(executeActionMock).not.toHaveBeenCalled()
257
- })
258
-
259
- it('skips automation silently when entries list is empty', async () => {
260
- const deps = makeDeps()
261
- deps.listSpy.mockResolvedValue({ items: [], total: 0 })
262
-
263
- await runCronAutomations(deps, TICK)
264
-
265
- expect(executeActionMock).not.toHaveBeenCalled()
266
- })
267
- })
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 type { Automation, IAutomationRepository, ContentRepository, Seed, IIdGenerator } from '@beechcms/core'
7
+ import { runCronAutomations } from '../cron-runner'
8
+ import type { CronRunnerDeps } from '../cron-runner'
9
+
10
+ vi.mock('../action-executors', () => ({
11
+ executeAction: vi.fn().mockResolvedValue(undefined),
12
+ }))
13
+
14
+ import { executeAction } from '../action-executors'
15
+ const executeActionMock = executeAction as ReturnType<typeof vi.fn>
16
+
17
+ // 2026-05-14T09:00:00Z → minute=0, hour=9, dow=4 (Thursday)
18
+ const TICK = new Date('2026-05-14T09:00:00Z').getTime()
19
+
20
+ const SEED: Seed = {
21
+ slug: 'posts',
22
+ label: 'Post',
23
+ displayNameAlias: 'title',
24
+ branches: [
25
+ { id: 'br_01', alias: 'title', type: 'text', label: 'Title' },
26
+ { id: 'br_02', alias: 'count', type: 'number', label: 'Count' },
27
+ { id: 'br_03', alias: 'published', type: 'boolean', label: 'Published' },
28
+ { id: 'br_04', alias: 'publish_date', type: 'date', label: 'Publish Date' },
29
+ { id: 'br_05', alias: 'tags_list', type: 'tags', label: 'Tags' },
30
+ { id: 'br_06', alias: 'meta_json', type: 'json', label: 'Meta JSON' },
31
+ { id: 'br_07', alias: 'body_rich', type: 'richtext', label: 'Body' },
32
+ ],
33
+ }
34
+
35
+ const STUB_ID_GENERATOR: IIdGenerator = {
36
+ uuid: () => 'test-uuid',
37
+ }
38
+
39
+ function makeAutomation(overrides: Partial<Automation> = {}): Automation {
40
+ return {
41
+ id: 'auto_01',
42
+ seed_slug: 'posts',
43
+ name: 'every-minute',
44
+ enabled: true,
45
+ triggers: [{ event: 'cron' as const, cron: '* * * * *' }],
46
+ trigger_conditions: null,
47
+ actions: [{ type: 'webhook', url: 'https://example.com/hook' }],
48
+ created_at: 0,
49
+ updated_at: 0,
50
+ ...overrides,
51
+ }
52
+ }
53
+
54
+ function makeDeps(overrides: Partial<CronRunnerDeps> = {}): CronRunnerDeps & {
55
+ listSpy: ReturnType<typeof vi.fn>
56
+ findActiveSpy: ReturnType<typeof vi.fn>
57
+ } {
58
+ const listSpy = vi.fn().mockResolvedValue({ items: [{ id: 'e1', title: 'Hello' }], total: 1 })
59
+ const findActiveSpy = vi.fn().mockResolvedValue([makeAutomation()])
60
+
61
+ return {
62
+ automationRepository: {
63
+ findActive: findActiveSpy,
64
+ list: vi.fn(), findById: vi.fn(), create: vi.fn(),
65
+ update: vi.fn(), toggle: vi.fn(), delete: vi.fn(),
66
+ } as unknown as IAutomationRepository,
67
+ contentRepository: { findMany: listSpy } as unknown as ContentRepository,
68
+ getSeed: (slug: string) => slug === 'posts' ? SEED : null,
69
+ env: {},
70
+ idGenerator: STUB_ID_GENERATOR,
71
+ listSpy,
72
+ findActiveSpy,
73
+ ...overrides,
74
+ }
75
+ }
76
+
77
+ describe('runCronAutomations', () => {
78
+ beforeEach(() => {
79
+ executeActionMock.mockReset()
80
+ executeActionMock.mockResolvedValue(undefined)
81
+ })
82
+
83
+ it('calls findActive with ("*", "cron")', async () => {
84
+ const deps = makeDeps()
85
+ await runCronAutomations(deps, TICK)
86
+ expect(deps.findActiveSpy).toHaveBeenCalledWith('*', 'cron')
87
+ })
88
+
89
+ it('batch actions (webhook, send_mail) run once per automation with batch context', async () => {
90
+ const entries = [{ id: 'e1', title: 'A' }, { id: 'e2', title: 'B' }]
91
+ const deps = makeDeps()
92
+ deps.listSpy.mockResolvedValue({ items: entries, total: 2 })
93
+
94
+ await runCronAutomations(deps, TICK)
95
+
96
+ expect(executeActionMock).toHaveBeenCalledTimes(1)
97
+ const [, ctx] = executeActionMock.mock.calls[0]
98
+ // entry is the first entry (for backwards compat); batch count lives in context
99
+ expect(ctx.entry).toMatchObject({ id: 'e1', title: 'A' })
100
+ expect(ctx.context).toBeDefined()
101
+ })
102
+
103
+ it('per-entry actions (edit_field, create_entry) run once per matching entry', async () => {
104
+ const entries = [{ id: 'e1' }, { id: 'e2' }]
105
+ const deps = makeDeps()
106
+ deps.findActiveSpy.mockResolvedValue([makeAutomation({ actions: [{ type: 'edit_field', field: 'title', value: 'updated' }] })])
107
+ deps.listSpy.mockResolvedValue({ items: entries, total: 2 })
108
+
109
+ await runCronAutomations(deps, TICK)
110
+
111
+ expect(executeActionMock).toHaveBeenCalledTimes(2)
112
+ expect(executeActionMock.mock.calls[0][1].entry).toMatchObject({ id: 'e1' })
113
+ expect(executeActionMock.mock.calls[1][1].entry).toMatchObject({ id: 'e2' })
114
+ })
115
+
116
+ it('skips non-matching cron expression, runs matching one', async () => {
117
+ const matchingAuto = makeAutomation({ id: 'auto_match', triggers: [{ event: 'cron', cron: '* * * * *' }] })
118
+ const nonMatchingAuto = makeAutomation({ id: 'auto_skip', triggers: [{ event: 'cron', cron: '30 9 * * *' }] })
119
+ const entries = [{ id: 'e1' }, { id: 'e2' }]
120
+
121
+ const deps = makeDeps()
122
+ deps.findActiveSpy.mockResolvedValue([matchingAuto, nonMatchingAuto])
123
+ deps.listSpy.mockResolvedValue({ items: entries, total: 2 })
124
+
125
+ await runCronAutomations(deps, TICK)
126
+
127
+ // webhook = batch, runs once for the matching automation only
128
+ expect(executeActionMock).toHaveBeenCalledTimes(1)
129
+ })
130
+
131
+ it('passes trigger_conditions as translated filters to repository.findMany', async () => {
132
+ const auto = makeAutomation({
133
+ trigger_conditions: {
134
+ kind: 'group',
135
+ op: 'AND',
136
+ children: [
137
+ { kind: 'predicate', left: { kind: 'ref', key: 'this.title' }, op: 'eq', right: { kind: 'literal', value: 'Hello' } },
138
+ ],
139
+ },
140
+ })
141
+ const deps = makeDeps()
142
+ deps.findActiveSpy.mockResolvedValue([auto])
143
+
144
+ await runCronAutomations(deps, TICK)
145
+
146
+ const call = deps.listSpy.mock.calls[0]
147
+ const options = call[1]
148
+ expect(options.filters).toEqual([
149
+ { column: 'title', type: 'text', conditions: [{ op: 'eq', value: 'Hello' }] },
150
+ ])
151
+ })
152
+
153
+ it('maps all branch types, system columns, unknown columns, and special operators correctly', async () => {
154
+ const auto = makeAutomation({
155
+ trigger_conditions: {
156
+ kind: 'group',
157
+ op: 'AND',
158
+ children: [
159
+ { kind: 'predicate', left: { kind: 'ref', key: 'this.count' }, op: 'gt', right: { kind: 'literal', value: 5 } },
160
+ { kind: 'predicate', left: { kind: 'ref', key: 'this.published' }, op: 'eq', right: { kind: 'literal', value: true } },
161
+ { kind: 'predicate', left: { kind: 'ref', key: 'this.publish_date' }, op: 'isempty' },
162
+ { kind: 'predicate', left: { kind: 'ref', key: 'this.tags_list' }, op: 'isnotempty' },
163
+ { kind: 'predicate', left: { kind: 'ref', key: 'this.meta_json' }, op: 'eq', right: { kind: 'literal', value: '{}' } },
164
+ { kind: 'predicate', left: { kind: 'ref', key: 'this.body_rich' }, op: 'contains', right: { kind: 'literal', value: 'hello' } },
165
+ { kind: 'predicate', left: { kind: 'ref', key: 'this.status' }, op: 'eq', right: { kind: 'literal', value: 'draft' } },
166
+ { kind: 'predicate', left: { kind: 'ref', key: 'this.unknown_custom' }, op: 'eq', right: { kind: 'literal', value: 'test' } },
167
+ ],
168
+ },
169
+ })
170
+ const deps = makeDeps()
171
+ deps.findActiveSpy.mockResolvedValue([auto])
172
+
173
+ await runCronAutomations(deps, TICK)
174
+
175
+ const call = deps.listSpy.mock.calls[0]
176
+ expect(call[1].filters).toEqual([
177
+ { column: 'count', type: 'number', conditions: [{ op: 'gt', value: 5 }] },
178
+ { column: 'published', type: 'boolean', conditions: [{ op: 'eq', value: true }] },
179
+ { column: 'publish_date', type: 'date', conditions: [{ op: 'is_empty', value: null }] },
180
+ { column: 'tags_list', type: 'tags', conditions: [{ op: 'is_not_empty', value: null }] },
181
+ { column: 'meta_json', type: 'json', conditions: [{ op: 'eq', value: '{}' }] },
182
+ { column: 'body_rich', type: 'text', conditions: [{ op: 'contains', value: 'hello' }] },
183
+ { column: 'status', type: 'system', conditions: [{ op: 'eq', value: 'draft' }] },
184
+ { column: 'unknown_custom', type: 'text', conditions: [{ op: 'eq', value: 'test' }] },
185
+ ])
186
+ })
187
+
188
+ it('logs warning and skips when getSeed returns null', async () => {
189
+ const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {})
190
+ const auto = makeAutomation({ seed_slug: 'unknown' })
191
+ const deps = makeDeps()
192
+ deps.findActiveSpy.mockResolvedValue([auto])
193
+
194
+ await runCronAutomations(deps, TICK)
195
+
196
+ expect(executeActionMock).not.toHaveBeenCalled()
197
+ expect(warnSpy).toHaveBeenCalledWith('[cron] unknown seed', expect.anything())
198
+ warnSpy.mockRestore()
199
+ })
200
+
201
+ it('continues processing remaining per-entry actions when one entry throws', async () => {
202
+ const entries = [{ id: 'e1' }, { id: 'e2' }, { id: 'e3' }]
203
+ const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {})
204
+ const deps = makeDeps()
205
+ deps.findActiveSpy.mockResolvedValue([makeAutomation({ actions: [{ type: 'edit_field', field: 'title', value: 'x' }] })])
206
+ deps.listSpy.mockResolvedValue({ items: entries, total: 3 })
207
+ executeActionMock
208
+ .mockResolvedValueOnce(undefined)
209
+ .mockRejectedValueOnce(new Error('boom'))
210
+ .mockResolvedValueOnce(undefined)
211
+
212
+ await runCronAutomations(deps, TICK)
213
+
214
+ expect(executeActionMock).toHaveBeenCalledTimes(3)
215
+ expect(errorSpy).toHaveBeenCalledWith('[cron] entry action failed', expect.anything())
216
+ errorSpy.mockRestore()
217
+ })
218
+
219
+ it('logs and continues to next automation when repository.findMany throws', async () => {
220
+ const auto1 = makeAutomation({ id: 'auto_01' })
221
+ const auto2 = makeAutomation({ id: 'auto_02' })
222
+ const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {})
223
+ const deps = makeDeps()
224
+ deps.findActiveSpy.mockResolvedValue([auto1, auto2])
225
+ deps.listSpy
226
+ .mockRejectedValueOnce(new Error('db error'))
227
+ .mockResolvedValueOnce({ items: [{ id: 'e1' }], total: 1 })
228
+
229
+ await runCronAutomations(deps, TICK)
230
+
231
+ expect(errorSpy).toHaveBeenCalledWith('[cron] fetch entries failed', expect.anything())
232
+ // auto2 still processed (webhook = batch, 1 call)
233
+ expect(executeActionMock).toHaveBeenCalledTimes(1)
234
+ errorSpy.mockRestore()
235
+ })
236
+
237
+ it('logs error and returns gracefully when findActive throws', async () => {
238
+ const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {})
239
+ const deps = makeDeps()
240
+ deps.findActiveSpy.mockRejectedValueOnce(new Error('no such table'))
241
+
242
+ await expect(runCronAutomations(deps, TICK)).resolves.toBeUndefined()
243
+ expect(errorSpy).toHaveBeenCalledWith(
244
+ expect.stringContaining('[cron] Failed to fetch automations'),
245
+ expect.anything(),
246
+ )
247
+ expect(executeActionMock).not.toHaveBeenCalled()
248
+ errorSpy.mockRestore()
249
+ })
250
+
251
+ it('resolves quietly with zero calls when no active automations exist', async () => {
252
+ const deps = makeDeps()
253
+ deps.findActiveSpy.mockResolvedValue([])
254
+
255
+ await expect(runCronAutomations(deps, TICK)).resolves.toBeUndefined()
256
+ expect(executeActionMock).not.toHaveBeenCalled()
257
+ })
258
+
259
+ it('skips automation silently when entries list is empty', async () => {
260
+ const deps = makeDeps()
261
+ deps.listSpy.mockResolvedValue({ items: [], total: 0 })
262
+
263
+ await runCronAutomations(deps, TICK)
264
+
265
+ expect(executeActionMock).not.toHaveBeenCalled()
266
+ })
267
+ })