@beechcms/api 0.6.0-preview.1 → 0.6.0-preview.2

package/src/features/automations/action-executors/webhook.executor.ts

@@ -1,67 +1,67 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-import type { AutomationAction } from '@beechcms/core'
-import type { ResolvedContext } from '../context-resolver'
-import { interpolate } from '../automation-runner.utils'
-
-type WebhookAction = Extract<AutomationAction, { type: 'webhook' }>
-
-const WEBHOOK_TIMEOUT_MS = 8_000
-
-let warnedNoSecret = false
-
-async function signBody(body: string, secret: string): Promise<string> {
-  const encoder = new TextEncoder()
-  const key = await crypto.subtle.importKey(
-    'raw',
-    encoder.encode(secret),
-    { name: 'HMAC', hash: 'SHA-256' },
-    false,
-    ['sign'],
-  )
-  const sig = await crypto.subtle.sign('HMAC', key, encoder.encode(body))
-  return 'sha256=' + Array.from(new Uint8Array(sig))
-    .map((b) => b.toString(16).padStart(2, '0'))
-    .join('')
-}
-
-export async function executeWebhook(
-  action: WebhookAction,
-  context: ResolvedContext,
-  env: Record<string, string | undefined>,
-): Promise<void> {
-  const body = interpolate(action.body_template ?? '{}', context)
-
-  const secret = env.WEBHOOK_SECRET
-  let signatureHeader: Record<string, string> = {}
-  if (secret) {
-    signatureHeader = { 'X-BeechCMS-Signature': await signBody(body, secret) }
-  } else if (!warnedNoSecret) {
-    warnedNoSecret = true
-    console.warn('[webhook] WEBHOOK_SECRET not set — outgoing webhooks are unsigned')
-  }
-
-  try {
-    const response = await fetch(action.url, {
-      method: action.method ?? 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        ...(action.headers ?? {}),
-        ...signatureHeader,
-      },
-      body,
-      signal: AbortSignal.timeout(WEBHOOK_TIMEOUT_MS),
-    })
-
-    if (!response.ok) {
-      throw new Error(`Webhook ${action.url} responded ${response.status}`)
-    }
-  } catch (err) {
-    if (err instanceof Error && err.name === 'TimeoutError') {
-      throw new Error(`Webhook ${action.url} timed out after ${WEBHOOK_TIMEOUT_MS}ms`)
-    }
-    throw err
-  }
-}
+// SPDX-License-Identifier: BUSL-1.1
+// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
+// See LICENSE in the repository root for license terms.
+
+import type { AutomationAction } from '@beechcms/core'
+import type { ResolvedContext } from '../context-resolver'
+import { interpolate } from '../automation-runner.utils'
+
+type WebhookAction = Extract<AutomationAction, { type: 'webhook' }>
+
+const WEBHOOK_TIMEOUT_MS = 8_000
+
+let warnedNoSecret = false
+
+async function signBody(body: string, secret: string): Promise<string> {
+  const encoder = new TextEncoder()
+  const key = await crypto.subtle.importKey(
+    'raw',
+    encoder.encode(secret),
+    { name: 'HMAC', hash: 'SHA-256' },
+    false,
+    ['sign'],
+  )
+  const sig = await crypto.subtle.sign('HMAC', key, encoder.encode(body))
+  return 'sha256=' + Array.from(new Uint8Array(sig))
+    .map((b) => b.toString(16).padStart(2, '0'))
+    .join('')
+}
+
+export async function executeWebhook(
+  action: WebhookAction,
+  context: ResolvedContext,
+  env: Record<string, string | undefined>,
+): Promise<void> {
+  const body = interpolate(action.body_template ?? '{}', context)
+
+  const secret = env.WEBHOOK_SECRET
+  let signatureHeader: Record<string, string> = {}
+  if (secret) {
+    signatureHeader = { 'X-BeechCMS-Signature': await signBody(body, secret) }
+  } else if (!warnedNoSecret) {
+    warnedNoSecret = true
+    console.warn('[webhook] WEBHOOK_SECRET not set — outgoing webhooks are unsigned')
+  }
+
+  try {
+    const response = await fetch(action.url, {
+      method: action.method ?? 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        ...(action.headers ?? {}),
+        ...signatureHeader,
+      },
+      body,
+      signal: AbortSignal.timeout(WEBHOOK_TIMEOUT_MS),
+    })
+
+    if (!response.ok) {
+      throw new Error(`Webhook ${action.url} responded ${response.status}`)
+    }
+  } catch (err) {
+    if (err instanceof Error && err.name === 'TimeoutError') {
+      throw new Error(`Webhook ${action.url} timed out after ${WEBHOOK_TIMEOUT_MS}ms`)
+    }
+    throw err
+  }
+}

package/src/features/automations/automation-runner.ts

@@ -1,85 +1,85 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-import type {
-  IAutomationRunner,
-  IAutomationRepository,
-  AutomationEventPayload,
-  ContentRepository,
-  Seed,
-  IIdGenerator,
-} from '@beechcms/core'
-import { resolvePath } from './automation-runner.utils'
-import { resolveAutomationContext, type ResolvedContext } from './context-resolver'
-import type { ParsedKey } from './template-grammar'
-import { executeAction } from './action-executors'
-import { evaluateWhen } from './when-evaluator'
-import { resolveVarAccess } from './var-access-resolver'
-
-export interface AutomationRunnerDeps {
-  automationRepository: IAutomationRepository
-  contentRepository: ContentRepository
-  getSeed: (slug: string) => Seed | null
-  idGenerator: IIdGenerator
-  env: Record<string, string | undefined>
-}
-
-function withVariables(base: ResolvedContext, variables: Record<string, unknown>): ResolvedContext {
-  return {
-    triggerEntry: base.triggerEntry,
-    lookup(parsed: ParsedKey, onMissing?: (field: string) => void): unknown {
-      if (parsed.kind === 'simple') {
-        const varVal = resolvePath(variables, parsed.path)
-        if (varVal !== undefined) return varVal
-      } else if (parsed.kind === 'var_access') {
-        return resolveVarAccess(parsed, variables, onMissing)
-      }
-      return base.lookup(parsed, onMissing)
-    },
-  }
-}
-
-export class AutomationRunner implements IAutomationRunner {
-  constructor(private readonly deps: AutomationRunnerDeps) {}
-
-  async run(payload: AutomationEventPayload): Promise<void> {
-    const { seedSlug, event, entry } = payload
-    const seed = this.deps.getSeed(seedSlug)
-    if (!seed) return
-
-    const automations = await this.deps.automationRepository.findActive(seedSlug, event)
-
-    for (const automation of automations) {
-      const resolved = await resolveAutomationContext(automation, entry, [entry])
-
-      // Evaluate conditions with the resolved context (this + batch scopes available).
-      // Variables from set_variable actions are not yet available here; use inline refs
-      // like {{customers:byid({{this.id}}):field}} for cross-seed conditions in v1.
-      if (!evaluateWhen(automation.trigger_conditions, resolved)) continue
-
-      const variables: Record<string, unknown> = {}
-
-      for (const action of automation.actions) {
-        try {
-          await executeAction(action, {
-            entry,
-            env: this.deps.env,
-            repository: this.deps.contentRepository,
-            getSeed: this.deps.getSeed,
-            seed,
-            idGenerator: this.deps.idGenerator,
-            context: withVariables(resolved, variables),
-            variables,
-          })
-        } catch (error) {
-          console.error('[automations] action failed', {
-            automationId: automation.id,
-            actionType: action.type,
-            error,
-          })
-        }
-      }
-    }
-  }
-}
+// SPDX-License-Identifier: BUSL-1.1
+// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
+// See LICENSE in the repository root for license terms.
+
+import type {
+  IAutomationRunner,
+  IAutomationRepository,
+  AutomationEventPayload,
+  ContentRepository,
+  Seed,
+  IIdGenerator,
+} from '@beechcms/core'
+import { resolvePath } from './automation-runner.utils'
+import { resolveAutomationContext, type ResolvedContext } from './context-resolver'
+import type { ParsedKey } from './template-grammar'
+import { executeAction } from './action-executors'
+import { evaluateWhen } from './when-evaluator'
+import { resolveVarAccess } from './var-access-resolver'
+
+export interface AutomationRunnerDeps {
+  automationRepository: IAutomationRepository
+  contentRepository: ContentRepository
+  getSeed: (slug: string) => Seed | null
+  idGenerator: IIdGenerator
+  env: Record<string, string | undefined>
+}
+
+function withVariables(base: ResolvedContext, variables: Record<string, unknown>): ResolvedContext {
+  return {
+    triggerEntry: base.triggerEntry,
+    lookup(parsed: ParsedKey, onMissing?: (field: string) => void): unknown {
+      if (parsed.kind === 'simple') {
+        const varVal = resolvePath(variables, parsed.path)
+        if (varVal !== undefined) return varVal
+      } else if (parsed.kind === 'var_access') {
+        return resolveVarAccess(parsed, variables, onMissing)
+      }
+      return base.lookup(parsed, onMissing)
+    },
+  }
+}
+
+export class AutomationRunner implements IAutomationRunner {
+  constructor(private readonly deps: AutomationRunnerDeps) {}
+
+  async run(payload: AutomationEventPayload): Promise<void> {
+    const { seedSlug, event, entry } = payload
+    const seed = this.deps.getSeed(seedSlug)
+    if (!seed) return
+
+    const automations = await this.deps.automationRepository.findActive(seedSlug, event)
+
+    for (const automation of automations) {
+      const resolved = await resolveAutomationContext(automation, entry, [entry])
+
+      // Evaluate conditions with the resolved context (this + batch scopes available).
+      // Variables from set_variable actions are not yet available here; use inline refs
+      // like {{customers:byid({{this.id}}):field}} for cross-seed conditions in v1.
+      if (!evaluateWhen(automation.trigger_conditions, resolved)) continue
+
+      const variables: Record<string, unknown> = {}
+
+      for (const action of automation.actions) {
+        try {
+          await executeAction(action, {
+            entry,
+            env: this.deps.env,
+            repository: this.deps.contentRepository,
+            getSeed: this.deps.getSeed,
+            seed,
+            idGenerator: this.deps.idGenerator,
+            context: withVariables(resolved, variables),
+            variables,
+          })
+        } catch (error) {
+          console.error('[automations] action failed', {
+            automationId: automation.id,
+            actionType: action.type,
+            error,
+          })
+        }
+      }
+    }
+  }
+}

package/src/features/automations/automation-runner.utils.ts

@@ -1,47 +1,47 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-import type { ResolvedContext } from './context-resolver'
-import { parseTemplateKey } from './template-grammar'
-
-export function interpolate(
-  template: string,
-  context: ResolvedContext,
-  defaultValue = '',
-  onMissing?: (field: string) => void,
-): string {
-  if (!template) return ''
-
-  const replacer = (_: string, key: string) => {
-    const trimmedKey = key.trim()
-    const parsed = parseTemplateKey(trimmedKey)
-    if (!parsed) {
-      if (onMissing) onMissing(trimmedKey)
-      return defaultValue
-    }
-    const val = context.lookup(parsed, onMissing)
-    if (val == null || val === '') {
-      return defaultValue
-    }
-    return String(val)
-  }
-
-  return template.replace(/\{\{\s*([^{}]+?)\s*\}\}/g, replacer)
-}
-
-export function resolvePath(obj: Record<string, unknown>, path: string): unknown {
-  if (path in obj && obj[path] !== undefined) {
-    return obj[path]
-  }
-  const parts = path.split('.')
-  let current: unknown = obj
-  for (const part of parts) {
-    if (current && typeof current === 'object') {
-      current = (current as Record<string, unknown>)[part]
-    } else {
-      return undefined
-    }
-  }
-  return current
-}
+// SPDX-License-Identifier: BUSL-1.1
+// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
+// See LICENSE in the repository root for license terms.
+
+import type { ResolvedContext } from './context-resolver'
+import { parseTemplateKey } from './template-grammar'
+
+export function interpolate(
+  template: string,
+  context: ResolvedContext,
+  defaultValue = '',
+  onMissing?: (field: string) => void,
+): string {
+  if (!template) return ''
+
+  const replacer = (_: string, key: string) => {
+    const trimmedKey = key.trim()
+    const parsed = parseTemplateKey(trimmedKey)
+    if (!parsed) {
+      if (onMissing) onMissing(trimmedKey)
+      return defaultValue
+    }
+    const val = context.lookup(parsed, onMissing)
+    if (val == null || val === '') {
+      return defaultValue
+    }
+    return String(val)
+  }
+
+  return template.replace(/\{\{\s*([^{}]+?)\s*\}\}/g, replacer)
+}
+
+export function resolvePath(obj: Record<string, unknown>, path: string): unknown {
+  if (path in obj && obj[path] !== undefined) {
+    return obj[path]
+  }
+  const parts = path.split('.')
+  let current: unknown = obj
+  for (const part of parts) {
+    if (current && typeof current === 'object') {
+      current = (current as Record<string, unknown>)[part]
+    } else {
+      return undefined
+    }
+  }
+  return current
+}