@beechcms/api 0.5.0 → 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 (225) hide show
  1. package/assets/dashboard/BeechLogo.svg +18 -18
  2. package/assets/dashboard/BeechLogoLIght.svg +48 -48
  3. package/assets/dashboard/Searching.svg +1 -0
  4. package/assets/dashboard/assets/chart-BrJFdsGZ.js +39 -0
  5. package/assets/dashboard/assets/index-CIaoMxuB.css +1 -0
  6. package/assets/dashboard/assets/index-wTKgygsg.js +636 -0
  7. package/assets/dashboard/assets/pie-chart-recharts-BEaE1FOE.js +1 -0
  8. package/assets/dashboard/assets/timeseries-chart-recharts-DmWM6imF.js +1 -0
  9. package/assets/dashboard/beechLogoDark.svg +48 -48
  10. package/assets/dashboard/index.html +18 -18
  11. package/assets/dashboard/noResult.svg +43 -0
  12. package/assets/dashboard/sol.svg +3 -3
  13. package/assets/dashboard/undraw_enter_nwx3.svg +36 -36
  14. package/assets/dashboard/working.svg +1 -0
  15. package/migrations/0000_v040_base.sql +265 -238
  16. package/migrations/0029_automations.sql +14 -14
  17. package/migrations/0030_test_seeds.sql +125 -125
  18. package/package.json +13 -9
  19. package/src/auth/{in-memory-hash-provider.ts → __fixtures__/in-memory-hash-provider.ts} +17 -13
  20. package/src/auth/{static-token-service.ts → __fixtures__/static-token-service.ts} +22 -18
  21. package/src/auth/bcrypt-hash-provider.ts +24 -20
  22. package/src/auth/constants.ts +14 -10
  23. package/src/auth/generate-refresh-token.test.ts +23 -19
  24. package/src/auth/hash-provider.test.ts +55 -46
  25. package/src/auth/jose-token-service.ts +62 -55
  26. package/src/auth/jwt-claims-passthrough.test.ts +87 -0
  27. package/src/auth/login.test.ts +100 -92
  28. package/src/auth/login.ts +78 -74
  29. package/src/auth/refresh.ts +11 -5
  30. package/src/auth/token-service.test.ts +90 -82
  31. package/src/factory.ts +370 -347
  32. package/src/features/automations/__tests__/action-executors.test.ts +255 -268
  33. package/src/features/automations/__tests__/automation-runner.test.ts +196 -192
  34. package/src/features/automations/__tests__/automation-runner.utils.test.ts +60 -56
  35. package/src/features/automations/__tests__/automations.handler.test.ts +264 -260
  36. package/src/features/automations/__tests__/automations.repository.test.ts +163 -159
  37. package/src/features/automations/__tests__/automations.schema.test.ts +224 -134
  38. package/src/features/automations/__tests__/context-resolver.test.ts +126 -122
  39. package/src/features/automations/__tests__/cron-runner.test.ts +267 -263
  40. package/src/features/automations/__tests__/cron-runner.utils.test.ts +144 -140
  41. package/src/features/automations/__tests__/set-variable.executor.test.ts +383 -306
  42. package/src/features/automations/__tests__/template-grammar.test.ts +308 -304
  43. package/src/features/automations/__tests__/webhook.executor.test.ts +142 -0
  44. package/src/features/automations/__tests__/when-evaluator.test.ts +274 -270
  45. package/src/features/automations/__tests__/when-pushdown.test.ts +281 -277
  46. package/src/features/automations/action-executors/create-entry.executor.ts +27 -23
  47. package/src/features/automations/action-executors/edit-field.executor.ts +26 -22
  48. package/src/features/automations/action-executors/index.ts +37 -33
  49. package/src/features/automations/action-executors/send-mail.executor.ts +53 -42
  50. package/src/features/automations/action-executors/set-variable.executor.ts +159 -146
  51. package/src/features/automations/action-executors/webhook.executor.ts +67 -25
  52. package/src/features/automations/automation-runner.ts +85 -81
  53. package/src/features/automations/automation-runner.utils.ts +47 -43
  54. package/src/features/automations/automations.handler.ts +197 -193
  55. package/src/features/automations/automations.schema.ts +177 -160
  56. package/src/features/automations/context-resolver.ts +152 -148
  57. package/src/features/automations/cron-runner.ts +140 -136
  58. package/src/features/automations/cron-runner.utils.ts +44 -40
  59. package/src/features/automations/filter-translation.ts +46 -42
  60. package/src/features/automations/index.ts +16 -12
  61. package/src/features/automations/template-grammar.ts +245 -241
  62. package/src/features/automations/var-access-resolver.ts +140 -136
  63. package/src/features/automations/when-evaluator.ts +87 -83
  64. package/src/features/automations/when-pushdown.ts +57 -53
  65. package/src/features/backrefs/__tests__/backrefs.handler.test.ts +359 -0
  66. package/src/features/backrefs/backrefs.handler.ts +168 -0
  67. package/src/features/backrefs/d1-backref.repository.ts +84 -0
  68. package/src/features/backrefs/index.ts +5 -0
  69. package/src/features/content/constants.ts +16 -10
  70. package/src/features/content/handlers/bulk.handler.ts +185 -0
  71. package/src/features/content/handlers/create.ts +129 -165
  72. package/src/features/content/handlers/delete.ts +62 -87
  73. package/src/features/content/handlers/facets.ts +49 -45
  74. package/src/features/content/handlers/get.ts +120 -116
  75. package/src/features/content/handlers/helpers.test.ts +180 -0
  76. package/src/features/content/handlers/helpers.ts +93 -0
  77. package/src/features/content/handlers/list.ts +174 -88
  78. package/src/features/content/handlers/update.ts +174 -219
  79. package/src/features/content/index.ts +26 -20
  80. package/src/features/dashboard-layout/__tests__/dashboard-layout.handler.test.ts +388 -0
  81. package/src/features/dashboard-layout/dashboard-layout.handler.ts +206 -0
  82. package/src/features/dashboard-layout/index.ts +5 -0
  83. package/src/features/draft/draft.handler.ts +195 -170
  84. package/src/features/draft/draft.middleware.ts +66 -62
  85. package/src/features/draft/index.ts +5 -1
  86. package/src/features/email/email.provider.ts +42 -38
  87. package/src/features/email/email.service.ts +98 -93
  88. package/src/features/email/email.types.ts +119 -108
  89. package/src/features/email/index.ts +33 -29
  90. package/src/features/email/providers/resend.ts +67 -63
  91. package/src/features/email/providers/smtp.ts +55 -0
  92. package/src/features/email/templates/automation-mail.ts +19 -15
  93. package/src/features/email/templates/password-changed.ts +63 -59
  94. package/src/features/email/templates/password-reset.ts +68 -64
  95. package/src/features/email/templates/shell.ts +96 -92
  96. package/src/features/notifications/index.ts +5 -1
  97. package/src/features/notifications/notifications.handler.ts +105 -101
  98. package/src/features/password-reset/index.ts +19 -15
  99. package/src/features/password-reset/request.ts +92 -82
  100. package/src/features/password-reset/reset.ts +102 -92
  101. package/src/features/rotate-field/index.ts +5 -1
  102. package/src/features/rotate-field/rotate-field.handler.ts +132 -128
  103. package/src/features/rotate-field/rotate-field.schema.ts +17 -13
  104. package/src/features/schema/schema.handler.ts +131 -16
  105. package/src/features/seeds/index.ts +5 -0
  106. package/src/features/seeds/seeds.handler.test.ts +1199 -0
  107. package/src/features/seeds/seeds.handler.ts +558 -0
  108. package/src/features/settings/__tests__/settings.handler.test.ts +555 -0
  109. package/src/features/settings/settings.handler.ts +392 -302
  110. package/src/features/setup/index.ts +288 -91
  111. package/src/features/stats/index.ts +5 -1
  112. package/src/features/stats/stats.handler.ts +420 -430
  113. package/src/features/webhooks/index.ts +63 -0
  114. package/src/index.ts +65 -56
  115. package/src/media-utils.ts +82 -78
  116. package/src/middleware/auth-providers.middleware.test.ts +85 -0
  117. package/src/middleware/auth-providers.middleware.ts +45 -32
  118. package/src/middleware/observability.middleware.test.ts +93 -0
  119. package/src/middleware/observability.middleware.ts +70 -52
  120. package/src/middleware/rate-limit.middleware.ts +45 -41
  121. package/src/middleware/repository.middleware.ts +117 -91
  122. package/src/middleware/seed-registry.middleware.test.ts +97 -0
  123. package/src/middleware/seed-registry.middleware.ts +21 -0
  124. package/src/middleware/storage.middleware.ts +25 -21
  125. package/src/middleware.ts +45 -47
  126. package/src/public/access-policy.ts +27 -23
  127. package/src/public/api-key-middleware.ts +57 -53
  128. package/src/public/cache-utils.ts +38 -34
  129. package/src/public/entry-projection.ts +46 -42
  130. package/src/public/idempotency.ts +23 -19
  131. package/src/public/index.ts +16 -12
  132. package/src/public/problem-details.ts +124 -53
  133. package/src/public/public-add.ts +114 -110
  134. package/src/public/public-edit.ts +163 -159
  135. package/src/public/public-errors.ts +19 -15
  136. package/src/public/public-read.ts +63 -59
  137. package/src/public/public-routes.ts +88 -84
  138. package/src/public/query-builder.test.ts +224 -220
  139. package/src/public/query-builder.ts +156 -152
  140. package/src/public/rate-limit-middleware.ts +34 -30
  141. package/src/public/read-list.ts +54 -50
  142. package/src/public/read-single.ts +48 -44
  143. package/src/public/response-builder.ts +30 -26
  144. package/src/public/sanitize.ts +69 -65
  145. package/src/public/slug-utils.ts +18 -14
  146. package/src/rate-limit/cloudflare-rate-limiter.test.ts +30 -26
  147. package/src/rate-limit/cloudflare-rate-limiter.ts +15 -11
  148. package/src/rate-limit/in-memory-rate-limiter.test.ts +37 -33
  149. package/src/rate-limit/in-memory-rate-limiter.ts +17 -13
  150. package/src/rate-limit/no-op-rate-limiter.test.ts +22 -18
  151. package/src/rate-limit/no-op-rate-limiter.ts +11 -7
  152. package/src/search-utils.test.ts +211 -207
  153. package/src/search-utils.ts +213 -209
  154. package/src/search.ts +65 -61
  155. package/src/shared/apply-policies.test.ts +81 -77
  156. package/src/shared/apply-policies.ts +67 -63
  157. package/src/shared/automations.repository.d1.ts +150 -146
  158. package/src/shared/background-notification-service.test.ts +62 -58
  159. package/src/shared/background-notification-service.ts +52 -48
  160. package/src/shared/base.repository.d1.ts +32 -28
  161. package/src/shared/content-utils.test.ts +165 -161
  162. package/src/shared/content-utils.ts +86 -82
  163. package/src/shared/content.repository.d1.test.ts +507 -312
  164. package/src/shared/content.repository.d1.ts +851 -382
  165. package/src/shared/d1-activity-log.repository.test.ts +140 -136
  166. package/src/shared/d1-activity-log.repository.ts +105 -101
  167. package/src/shared/d1-activity-logger.test.ts +86 -82
  168. package/src/shared/d1-activity-logger.ts +67 -63
  169. package/src/shared/d1-analytics.repository.test.ts +78 -74
  170. package/src/shared/d1-analytics.repository.ts +85 -81
  171. package/src/shared/d1-content-scan.repository.test.ts +80 -76
  172. package/src/shared/d1-content-scan.repository.ts +37 -29
  173. package/src/shared/d1-notification.repository.test.ts +128 -124
  174. package/src/shared/d1-notification.repository.ts +118 -114
  175. package/src/shared/d1-password-reset-token.repository.test.ts +81 -77
  176. package/src/shared/d1-password-reset-token.repository.ts +56 -52
  177. package/src/shared/d1-search.repository.test.ts +87 -83
  178. package/src/shared/d1-search.repository.ts +88 -84
  179. package/src/shared/d1-session.repository.test.ts +125 -121
  180. package/src/shared/d1-session.repository.ts +102 -98
  181. package/src/shared/d1-setup-checklist.repository.ts +36 -0
  182. package/src/shared/d1-user.repository.test.ts +151 -147
  183. package/src/shared/d1-user.repository.ts +119 -109
  184. package/src/shared/d1-widget.repository.test.ts +267 -217
  185. package/src/shared/d1-widget.repository.ts +385 -337
  186. package/src/shared/dashboard-layout.repository.d1.test.ts +135 -0
  187. package/src/shared/dashboard-layout.repository.d1.ts +58 -0
  188. package/src/shared/demo-data-sql.ts +216 -0
  189. package/src/shared/demo-data.repository.d1.ts +20 -0
  190. package/src/shared/execution-context-scheduler.ts +13 -9
  191. package/src/shared/fixed-clock.ts +25 -21
  192. package/src/shared/fts-sync.ts +8 -4
  193. package/src/shared/idempotency.repository.d1.test.ts +83 -79
  194. package/src/shared/idempotency.repository.d1.ts +60 -56
  195. package/src/shared/in-memory-activity-logger.ts +19 -15
  196. package/src/shared/in-memory-notification-service.ts +19 -15
  197. package/src/shared/in-memory-seed.repository.ts +58 -0
  198. package/src/shared/media.repository.d1.test.ts +107 -103
  199. package/src/shared/media.repository.d1.ts +68 -64
  200. package/src/shared/qstash-notification-service.test.ts +67 -0
  201. package/src/shared/qstash-notification-service.ts +55 -0
  202. package/src/shared/query-utils.ts +141 -137
  203. package/src/shared/request-utils.ts +26 -22
  204. package/src/shared/schema-mutator.d1.test.ts +142 -0
  205. package/src/shared/schema-mutator.d1.ts +64 -0
  206. package/src/shared/seed-layout.repository.d1.test.ts +114 -0
  207. package/src/shared/seed-layout.repository.d1.ts +62 -0
  208. package/src/shared/seed-registry-cache.test.ts +68 -0
  209. package/src/shared/seed-registry-cache.ts +49 -0
  210. package/src/shared/seed.repository.d1.test.ts +143 -0
  211. package/src/shared/seed.repository.d1.ts +98 -0
  212. package/src/shared/sequential-id-generator.ts +33 -22
  213. package/src/shared/site-settings.repository.d1.ts +53 -0
  214. package/src/shared/storage/factory.ts +41 -40
  215. package/src/shared/storage/s3-bucket.ts +195 -163
  216. package/src/shared/storage-utils.ts +40 -36
  217. package/src/shared/system-stats.repository.d1.test.ts +58 -54
  218. package/src/shared/system-stats.repository.d1.ts +48 -44
  219. package/src/types.ts +90 -67
  220. package/src/upload.ts +198 -187
  221. package/src/widget.test.ts +85 -0
  222. package/src/widget.ts +251 -208
  223. package/assets/dashboard/assets/index-B1mUfgiK.css +0 -1
  224. package/assets/dashboard/assets/index-CHxxc_id.js +0 -629
  225. package/src/shared/storage/r2-binding-bucket.ts +0 -81
@@ -1,263 +1,267 @@
1
- import { describe, it, expect, vi, beforeEach } from 'vitest'
2
- import type { Automation, IAutomationRepository, ContentRepository, Seed, IIdGenerator } from '@beechcms/core'
3
- import { runCronAutomations } from '../cron-runner'
4
- import type { CronRunnerDeps } from '../cron-runner'
5
-
6
- vi.mock('../action-executors', () => ({
7
- executeAction: vi.fn().mockResolvedValue(undefined),
8
- }))
9
-
10
- import { executeAction } from '../action-executors'
11
- const executeActionMock = executeAction as ReturnType<typeof vi.fn>
12
-
13
- // 2026-05-14T09:00:00Z → minute=0, hour=9, dow=4 (Thursday)
14
- const TICK = new Date('2026-05-14T09:00:00Z').getTime()
15
-
16
- const SEED: Seed = {
17
- slug: 'posts',
18
- label: 'Post',
19
- displayNameAlias: 'title',
20
- branches: [
21
- { alias: 'title', type: 'text', label: 'Title' },
22
- { alias: 'count', type: 'number', label: 'Count' },
23
- { alias: 'published', type: 'boolean', label: 'Published' },
24
- { alias: 'publish_date', type: 'date', label: 'Publish Date' },
25
- { alias: 'tags_list', type: 'tags', label: 'Tags' },
26
- { alias: 'meta_json', type: 'json', label: 'Meta JSON' },
27
- { alias: 'body_rich', type: 'richtext', label: 'Body' },
28
- ],
29
- }
30
-
31
- const STUB_ID_GENERATOR: IIdGenerator = {
32
- uuid: () => 'test-uuid',
33
- }
34
-
35
- function makeAutomation(overrides: Partial<Automation> = {}): Automation {
36
- return {
37
- id: 'auto_01',
38
- seed_slug: 'posts',
39
- name: 'every-minute',
40
- enabled: true,
41
- triggers: [{ event: 'cron' as const, cron: '* * * * *' }],
42
- trigger_conditions: null,
43
- actions: [{ type: 'webhook', url: 'https://example.com/hook' }],
44
- created_at: 0,
45
- updated_at: 0,
46
- ...overrides,
47
- }
48
- }
49
-
50
- function makeDeps(overrides: Partial<CronRunnerDeps> = {}): CronRunnerDeps & {
51
- listSpy: ReturnType<typeof vi.fn>
52
- findActiveSpy: ReturnType<typeof vi.fn>
53
- } {
54
- const listSpy = vi.fn().mockResolvedValue({ items: [{ id: 'e1', title: 'Hello' }], total: 1 })
55
- const findActiveSpy = vi.fn().mockResolvedValue([makeAutomation()])
56
-
57
- return {
58
- automationRepository: {
59
- findActive: findActiveSpy,
60
- list: vi.fn(), findById: vi.fn(), create: vi.fn(),
61
- update: vi.fn(), toggle: vi.fn(), delete: vi.fn(),
62
- } as unknown as IAutomationRepository,
63
- contentRepository: { findMany: listSpy } as unknown as ContentRepository,
64
- getSeed: (slug: string) => slug === 'posts' ? SEED : null,
65
- env: {},
66
- idGenerator: STUB_ID_GENERATOR,
67
- listSpy,
68
- findActiveSpy,
69
- ...overrides,
70
- }
71
- }
72
-
73
- describe('runCronAutomations', () => {
74
- beforeEach(() => {
75
- executeActionMock.mockReset()
76
- executeActionMock.mockResolvedValue(undefined)
77
- })
78
-
79
- it('calls findActive with ("*", "cron")', async () => {
80
- const deps = makeDeps()
81
- await runCronAutomations(deps, TICK)
82
- expect(deps.findActiveSpy).toHaveBeenCalledWith('*', 'cron')
83
- })
84
-
85
- it('batch actions (webhook, send_mail) run once per automation with batch context', async () => {
86
- const entries = [{ id: 'e1', title: 'A' }, { id: 'e2', title: 'B' }]
87
- const deps = makeDeps()
88
- deps.listSpy.mockResolvedValue({ items: entries, total: 2 })
89
-
90
- await runCronAutomations(deps, TICK)
91
-
92
- expect(executeActionMock).toHaveBeenCalledTimes(1)
93
- const [, ctx] = executeActionMock.mock.calls[0]
94
- // entry is the first entry (for backwards compat); batch count lives in context
95
- expect(ctx.entry).toMatchObject({ id: 'e1', title: 'A' })
96
- expect(ctx.context).toBeDefined()
97
- })
98
-
99
- it('per-entry actions (edit_field, create_entry) run once per matching entry', async () => {
100
- const entries = [{ id: 'e1' }, { id: 'e2' }]
101
- const deps = makeDeps()
102
- deps.findActiveSpy.mockResolvedValue([makeAutomation({ actions: [{ type: 'edit_field', field: 'title', value: 'updated' }] })])
103
- deps.listSpy.mockResolvedValue({ items: entries, total: 2 })
104
-
105
- await runCronAutomations(deps, TICK)
106
-
107
- expect(executeActionMock).toHaveBeenCalledTimes(2)
108
- expect(executeActionMock.mock.calls[0][1].entry).toMatchObject({ id: 'e1' })
109
- expect(executeActionMock.mock.calls[1][1].entry).toMatchObject({ id: 'e2' })
110
- })
111
-
112
- it('skips non-matching cron expression, runs matching one', async () => {
113
- const matchingAuto = makeAutomation({ id: 'auto_match', triggers: [{ event: 'cron', cron: '* * * * *' }] })
114
- const nonMatchingAuto = makeAutomation({ id: 'auto_skip', triggers: [{ event: 'cron', cron: '30 9 * * *' }] })
115
- const entries = [{ id: 'e1' }, { id: 'e2' }]
116
-
117
- const deps = makeDeps()
118
- deps.findActiveSpy.mockResolvedValue([matchingAuto, nonMatchingAuto])
119
- deps.listSpy.mockResolvedValue({ items: entries, total: 2 })
120
-
121
- await runCronAutomations(deps, TICK)
122
-
123
- // webhook = batch, runs once for the matching automation only
124
- expect(executeActionMock).toHaveBeenCalledTimes(1)
125
- })
126
-
127
- it('passes trigger_conditions as translated filters to repository.findMany', async () => {
128
- const auto = makeAutomation({
129
- trigger_conditions: {
130
- kind: 'group',
131
- op: 'AND',
132
- children: [
133
- { kind: 'predicate', left: { kind: 'ref', key: 'this.title' }, op: 'eq', right: { kind: 'literal', value: 'Hello' } },
134
- ],
135
- },
136
- })
137
- const deps = makeDeps()
138
- deps.findActiveSpy.mockResolvedValue([auto])
139
-
140
- await runCronAutomations(deps, TICK)
141
-
142
- const call = deps.listSpy.mock.calls[0]
143
- const options = call[1]
144
- expect(options.filters).toEqual([
145
- { column: 'title', type: 'text', conditions: [{ op: 'eq', value: 'Hello' }] },
146
- ])
147
- })
148
-
149
- it('maps all branch types, system columns, unknown columns, and special operators correctly', async () => {
150
- const auto = makeAutomation({
151
- trigger_conditions: {
152
- kind: 'group',
153
- op: 'AND',
154
- children: [
155
- { kind: 'predicate', left: { kind: 'ref', key: 'this.count' }, op: 'gt', right: { kind: 'literal', value: 5 } },
156
- { kind: 'predicate', left: { kind: 'ref', key: 'this.published' }, op: 'eq', right: { kind: 'literal', value: true } },
157
- { kind: 'predicate', left: { kind: 'ref', key: 'this.publish_date' }, op: 'isempty' },
158
- { kind: 'predicate', left: { kind: 'ref', key: 'this.tags_list' }, op: 'isnotempty' },
159
- { kind: 'predicate', left: { kind: 'ref', key: 'this.meta_json' }, op: 'eq', right: { kind: 'literal', value: '{}' } },
160
- { kind: 'predicate', left: { kind: 'ref', key: 'this.body_rich' }, op: 'contains', right: { kind: 'literal', value: 'hello' } },
161
- { kind: 'predicate', left: { kind: 'ref', key: 'this.status' }, op: 'eq', right: { kind: 'literal', value: 'draft' } },
162
- { kind: 'predicate', left: { kind: 'ref', key: 'this.unknown_custom' }, op: 'eq', right: { kind: 'literal', value: 'test' } },
163
- ],
164
- },
165
- })
166
- const deps = makeDeps()
167
- deps.findActiveSpy.mockResolvedValue([auto])
168
-
169
- await runCronAutomations(deps, TICK)
170
-
171
- const call = deps.listSpy.mock.calls[0]
172
- expect(call[1].filters).toEqual([
173
- { column: 'count', type: 'number', conditions: [{ op: 'gt', value: 5 }] },
174
- { column: 'published', type: 'boolean', conditions: [{ op: 'eq', value: true }] },
175
- { column: 'publish_date', type: 'date', conditions: [{ op: 'is_empty', value: null }] },
176
- { column: 'tags_list', type: 'tags', conditions: [{ op: 'is_not_empty', value: null }] },
177
- { column: 'meta_json', type: 'json', conditions: [{ op: 'eq', value: '{}' }] },
178
- { column: 'body_rich', type: 'text', conditions: [{ op: 'contains', value: 'hello' }] },
179
- { column: 'status', type: 'system', conditions: [{ op: 'eq', value: 'draft' }] },
180
- { column: 'unknown_custom', type: 'text', conditions: [{ op: 'eq', value: 'test' }] },
181
- ])
182
- })
183
-
184
- it('logs warning and skips when getSeed returns null', async () => {
185
- const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {})
186
- const auto = makeAutomation({ seed_slug: 'unknown' })
187
- const deps = makeDeps()
188
- deps.findActiveSpy.mockResolvedValue([auto])
189
-
190
- await runCronAutomations(deps, TICK)
191
-
192
- expect(executeActionMock).not.toHaveBeenCalled()
193
- expect(warnSpy).toHaveBeenCalledWith('[cron] unknown seed', expect.anything())
194
- warnSpy.mockRestore()
195
- })
196
-
197
- it('continues processing remaining per-entry actions when one entry throws', async () => {
198
- const entries = [{ id: 'e1' }, { id: 'e2' }, { id: 'e3' }]
199
- const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {})
200
- const deps = makeDeps()
201
- deps.findActiveSpy.mockResolvedValue([makeAutomation({ actions: [{ type: 'edit_field', field: 'title', value: 'x' }] })])
202
- deps.listSpy.mockResolvedValue({ items: entries, total: 3 })
203
- executeActionMock
204
- .mockResolvedValueOnce(undefined)
205
- .mockRejectedValueOnce(new Error('boom'))
206
- .mockResolvedValueOnce(undefined)
207
-
208
- await runCronAutomations(deps, TICK)
209
-
210
- expect(executeActionMock).toHaveBeenCalledTimes(3)
211
- expect(errorSpy).toHaveBeenCalledWith('[cron] entry action failed', expect.anything())
212
- errorSpy.mockRestore()
213
- })
214
-
215
- it('logs and continues to next automation when repository.findMany throws', async () => {
216
- const auto1 = makeAutomation({ id: 'auto_01' })
217
- const auto2 = makeAutomation({ id: 'auto_02' })
218
- const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {})
219
- const deps = makeDeps()
220
- deps.findActiveSpy.mockResolvedValue([auto1, auto2])
221
- deps.listSpy
222
- .mockRejectedValueOnce(new Error('db error'))
223
- .mockResolvedValueOnce({ items: [{ id: 'e1' }], total: 1 })
224
-
225
- await runCronAutomations(deps, TICK)
226
-
227
- expect(errorSpy).toHaveBeenCalledWith('[cron] fetch entries failed', expect.anything())
228
- // auto2 still processed (webhook = batch, 1 call)
229
- expect(executeActionMock).toHaveBeenCalledTimes(1)
230
- errorSpy.mockRestore()
231
- })
232
-
233
- it('logs error and returns gracefully when findActive throws', async () => {
234
- const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {})
235
- const deps = makeDeps()
236
- deps.findActiveSpy.mockRejectedValueOnce(new Error('no such table'))
237
-
238
- await expect(runCronAutomations(deps, TICK)).resolves.toBeUndefined()
239
- expect(errorSpy).toHaveBeenCalledWith(
240
- expect.stringContaining('[cron] Failed to fetch automations'),
241
- expect.anything(),
242
- )
243
- expect(executeActionMock).not.toHaveBeenCalled()
244
- errorSpy.mockRestore()
245
- })
246
-
247
- it('resolves quietly with zero calls when no active automations exist', async () => {
248
- const deps = makeDeps()
249
- deps.findActiveSpy.mockResolvedValue([])
250
-
251
- await expect(runCronAutomations(deps, TICK)).resolves.toBeUndefined()
252
- expect(executeActionMock).not.toHaveBeenCalled()
253
- })
254
-
255
- it('skips automation silently when entries list is empty', async () => {
256
- const deps = makeDeps()
257
- deps.listSpy.mockResolvedValue({ items: [], total: 0 })
258
-
259
- await runCronAutomations(deps, TICK)
260
-
261
- expect(executeActionMock).not.toHaveBeenCalled()
262
- })
263
- })
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
+ })