@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,81 +1,85 @@
1
- import type {
2
- IAutomationRunner,
3
- IAutomationRepository,
4
- AutomationEventPayload,
5
- ContentRepository,
6
- Seed,
7
- IIdGenerator,
8
- } from '@beechcms/core'
9
- import { resolvePath } from './automation-runner.utils'
10
- import { resolveAutomationContext, type ResolvedContext } from './context-resolver'
11
- import type { ParsedKey } from './template-grammar'
12
- import { executeAction } from './action-executors'
13
- import { evaluateWhen } from './when-evaluator'
14
- import { resolveVarAccess } from './var-access-resolver'
15
-
16
- export interface AutomationRunnerDeps {
17
- automationRepository: IAutomationRepository
18
- contentRepository: ContentRepository
19
- getSeed: (slug: string) => Seed | null
20
- idGenerator: IIdGenerator
21
- env: Record<string, string | undefined>
22
- }
23
-
24
- function withVariables(base: ResolvedContext, variables: Record<string, unknown>): ResolvedContext {
25
- return {
26
- triggerEntry: base.triggerEntry,
27
- lookup(parsed: ParsedKey, onMissing?: (field: string) => void): unknown {
28
- if (parsed.kind === 'simple') {
29
- const varVal = resolvePath(variables, parsed.path)
30
- if (varVal !== undefined) return varVal
31
- } else if (parsed.kind === 'var_access') {
32
- return resolveVarAccess(parsed, variables, onMissing)
33
- }
34
- return base.lookup(parsed, onMissing)
35
- },
36
- }
37
- }
38
-
39
- export class AutomationRunner implements IAutomationRunner {
40
- constructor(private readonly deps: AutomationRunnerDeps) {}
41
-
42
- async run(payload: AutomationEventPayload): Promise<void> {
43
- const { seedSlug, event, entry } = payload
44
- const seed = this.deps.getSeed(seedSlug)
45
- if (!seed) return
46
-
47
- const automations = await this.deps.automationRepository.findActive(seedSlug, event)
48
-
49
- for (const automation of automations) {
50
- const resolved = await resolveAutomationContext(automation, entry, [entry])
51
-
52
- // Evaluate conditions with the resolved context (this + batch scopes available).
53
- // Variables from set_variable actions are not yet available here; use inline refs
54
- // like {{customers:byid({{this.id}}):field}} for cross-seed conditions in v1.
55
- if (!evaluateWhen(automation.trigger_conditions, resolved)) continue
56
-
57
- const variables: Record<string, unknown> = {}
58
-
59
- for (const action of automation.actions) {
60
- try {
61
- await executeAction(action, {
62
- entry,
63
- env: this.deps.env,
64
- repository: this.deps.contentRepository,
65
- getSeed: this.deps.getSeed,
66
- seed,
67
- idGenerator: this.deps.idGenerator,
68
- context: withVariables(resolved, variables),
69
- variables,
70
- })
71
- } catch (error) {
72
- console.error('[automations] action failed', {
73
- automationId: automation.id,
74
- actionType: action.type,
75
- error,
76
- })
77
- }
78
- }
79
- }
80
- }
81
- }
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 type {
6
+ IAutomationRunner,
7
+ IAutomationRepository,
8
+ AutomationEventPayload,
9
+ ContentRepository,
10
+ Seed,
11
+ IIdGenerator,
12
+ } from '@beechcms/core'
13
+ import { resolvePath } from './automation-runner.utils'
14
+ import { resolveAutomationContext, type ResolvedContext } from './context-resolver'
15
+ import type { ParsedKey } from './template-grammar'
16
+ import { executeAction } from './action-executors'
17
+ import { evaluateWhen } from './when-evaluator'
18
+ import { resolveVarAccess } from './var-access-resolver'
19
+
20
+ export interface AutomationRunnerDeps {
21
+ automationRepository: IAutomationRepository
22
+ contentRepository: ContentRepository
23
+ getSeed: (slug: string) => Seed | null
24
+ idGenerator: IIdGenerator
25
+ env: Record<string, string | undefined>
26
+ }
27
+
28
+ function withVariables(base: ResolvedContext, variables: Record<string, unknown>): ResolvedContext {
29
+ return {
30
+ triggerEntry: base.triggerEntry,
31
+ lookup(parsed: ParsedKey, onMissing?: (field: string) => void): unknown {
32
+ if (parsed.kind === 'simple') {
33
+ const varVal = resolvePath(variables, parsed.path)
34
+ if (varVal !== undefined) return varVal
35
+ } else if (parsed.kind === 'var_access') {
36
+ return resolveVarAccess(parsed, variables, onMissing)
37
+ }
38
+ return base.lookup(parsed, onMissing)
39
+ },
40
+ }
41
+ }
42
+
43
+ export class AutomationRunner implements IAutomationRunner {
44
+ constructor(private readonly deps: AutomationRunnerDeps) {}
45
+
46
+ async run(payload: AutomationEventPayload): Promise<void> {
47
+ const { seedSlug, event, entry } = payload
48
+ const seed = this.deps.getSeed(seedSlug)
49
+ if (!seed) return
50
+
51
+ const automations = await this.deps.automationRepository.findActive(seedSlug, event)
52
+
53
+ for (const automation of automations) {
54
+ const resolved = await resolveAutomationContext(automation, entry, [entry])
55
+
56
+ // Evaluate conditions with the resolved context (this + batch scopes available).
57
+ // Variables from set_variable actions are not yet available here; use inline refs
58
+ // like {{customers:byid({{this.id}}):field}} for cross-seed conditions in v1.
59
+ if (!evaluateWhen(automation.trigger_conditions, resolved)) continue
60
+
61
+ const variables: Record<string, unknown> = {}
62
+
63
+ for (const action of automation.actions) {
64
+ try {
65
+ await executeAction(action, {
66
+ entry,
67
+ env: this.deps.env,
68
+ repository: this.deps.contentRepository,
69
+ getSeed: this.deps.getSeed,
70
+ seed,
71
+ idGenerator: this.deps.idGenerator,
72
+ context: withVariables(resolved, variables),
73
+ variables,
74
+ })
75
+ } catch (error) {
76
+ console.error('[automations] action failed', {
77
+ automationId: automation.id,
78
+ actionType: action.type,
79
+ error,
80
+ })
81
+ }
82
+ }
83
+ }
84
+ }
85
+ }
@@ -1,43 +1,47 @@
1
- import type { ResolvedContext } from './context-resolver'
2
- import { parseTemplateKey } from './template-grammar'
3
-
4
- export function interpolate(
5
- template: string,
6
- context: ResolvedContext,
7
- defaultValue = '',
8
- onMissing?: (field: string) => void,
9
- ): string {
10
- if (!template) return ''
11
-
12
- const replacer = (_: string, key: string) => {
13
- const trimmedKey = key.trim()
14
- const parsed = parseTemplateKey(trimmedKey)
15
- if (!parsed) {
16
- if (onMissing) onMissing(trimmedKey)
17
- return defaultValue
18
- }
19
- const val = context.lookup(parsed, onMissing)
20
- if (val == null || val === '') {
21
- return defaultValue
22
- }
23
- return String(val)
24
- }
25
-
26
- return template.replace(/\{\{\s*([^{}]+?)\s*\}\}/g, replacer)
27
- }
28
-
29
- export function resolvePath(obj: Record<string, unknown>, path: string): unknown {
30
- if (path in obj && obj[path] !== undefined) {
31
- return obj[path]
32
- }
33
- const parts = path.split('.')
34
- let current: unknown = obj
35
- for (const part of parts) {
36
- if (current && typeof current === 'object') {
37
- current = (current as Record<string, unknown>)[part]
38
- } else {
39
- return undefined
40
- }
41
- }
42
- return current
43
- }
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 type { ResolvedContext } from './context-resolver'
6
+ import { parseTemplateKey } from './template-grammar'
7
+
8
+ export function interpolate(
9
+ template: string,
10
+ context: ResolvedContext,
11
+ defaultValue = '',
12
+ onMissing?: (field: string) => void,
13
+ ): string {
14
+ if (!template) return ''
15
+
16
+ const replacer = (_: string, key: string) => {
17
+ const trimmedKey = key.trim()
18
+ const parsed = parseTemplateKey(trimmedKey)
19
+ if (!parsed) {
20
+ if (onMissing) onMissing(trimmedKey)
21
+ return defaultValue
22
+ }
23
+ const val = context.lookup(parsed, onMissing)
24
+ if (val == null || val === '') {
25
+ return defaultValue
26
+ }
27
+ return String(val)
28
+ }
29
+
30
+ return template.replace(/\{\{\s*([^{}]+?)\s*\}\}/g, replacer)
31
+ }
32
+
33
+ export function resolvePath(obj: Record<string, unknown>, path: string): unknown {
34
+ if (path in obj && obj[path] !== undefined) {
35
+ return obj[path]
36
+ }
37
+ const parts = path.split('.')
38
+ let current: unknown = obj
39
+ for (const part of parts) {
40
+ if (current && typeof current === 'object') {
41
+ current = (current as Record<string, unknown>)[part]
42
+ } else {
43
+ return undefined
44
+ }
45
+ }
46
+ return current
47
+ }