@beechcms/api 0.5.0 → 0.6.0-preview.2

package/src/features/automations/context-resolver.ts

@@ -1,148 +1,152 @@
-import type { Automation } from '@beechcms/core'
-import type { AutomationContextSelector, ParsedKey } from './template-grammar'
-import { resolvePath } from './automation-runner.utils'
-
-export interface ResolvedContext {
-  lookup(key: ParsedKey, onMissing?: (field: string) => void): unknown
-  triggerEntry: Record<string, unknown> | null
-}
-
-const MAX_PLUCK = 100
-const AGGREGATE_OPS = new Set(['count', 'sum', 'avg', 'min', 'max', 'pluck'])
-
-function applyAggregate(
-  op: string,
-  field: string | null,
-  rows: Array<Record<string, unknown>>,
-  onMissing?: (f: string) => void,
-): unknown {
-  switch (op) {
-    case 'count':
-      return rows.length
-
-    case 'sum': {
-      if (!field) { if (onMissing) onMissing('sum:field'); return 0 }
-      return rows.reduce((acc, r) => {
-        const v = Number(r[field])
-        if (Number.isNaN(v)) { if (onMissing) onMissing(`sum:${field}:NaN`); return acc }
-        return acc + v
-      }, 0)
-    }
-
-    case 'avg': {
-      if (!field || rows.length === 0) { if (onMissing && !field) onMissing('avg:field'); return 0 }
-      const total = rows.reduce((acc, r) => {
-        const v = Number(r[field])
-        if (Number.isNaN(v)) { if (onMissing) onMissing(`avg:${field}:NaN`); return acc }
-        return acc + v
-      }, 0)
-      return rows.length > 0 ? total / rows.length : 0
-    }
-
-    case 'min': {
-      if (!field || rows.length === 0) { if (onMissing && !field) onMissing('min:field'); return null }
-      return rows.reduce<number | null>((acc, r) => {
-        const v = Number(r[field])
-        if (Number.isNaN(v)) return acc
-        return acc === null || v < acc ? v : acc
-      }, null)
-    }
-
-    case 'max': {
-      if (!field || rows.length === 0) { if (onMissing && !field) onMissing('max:field'); return null }
-      return rows.reduce<number | null>((acc, r) => {
-        const v = Number(r[field])
-        if (Number.isNaN(v)) return acc
-        return acc === null || v > acc ? v : acc
-      }, null)
-    }
-
-    case 'pluck': {
-      if (!field) { if (onMissing) onMissing('pluck:field'); return '' }
-      const values = rows.slice(0, MAX_PLUCK).map((r) => String(r[field] ?? ''))
-      const truncated = rows.length > MAX_PLUCK
-      return values.join(', ') + (truncated ? ' …' : '')
-    }
-
-    default:
-      return undefined
-  }
-}
-
-export async function resolveAutomationContext(
-  _automation: Automation,
-  triggerEntry: Record<string, unknown> | null,
-  batchEntries: Array<Record<string, unknown>>,
-): Promise<ResolvedContext> {
-  function lookup(parsed: ParsedKey, onMissing?: (field: string) => void): unknown {
-    if (parsed.kind === 'simple') {
-      if (parsed.path.startsWith('this.')) {
-        const field = parsed.path.slice(5)
-        const val = resolvePath(triggerEntry ?? {}, field)
-        if (val === undefined && onMissing) onMissing(parsed.path)
-        return val
-      }
-      const val = resolvePath(triggerEntry ?? {}, parsed.path)
-      if (val === undefined && onMissing) onMissing(parsed.path)
-      return val
-    }
-
-    if (parsed.kind !== 'scoped') {
-      if (onMissing) onMissing(parsed.kind === 'var_access' ? parsed.name : 'unknown')
-      return undefined
-    }
-
-    const { scope, selector: _selector, op, field } = parsed
-
-    if (scope === 'this') {
-      if (op !== 'field' || !field) { if (onMissing) onMissing(`this.${field}`); return undefined }
-      const val = resolvePath(triggerEntry ?? {}, field)
-      if (val === undefined && onMissing) onMissing(`this.${field}`)
-      return val
-    }
-
-    if (scope === 'batch') {
-      if (op === 'field') {
-        if (!field) { if (onMissing) onMissing('batch.field'); return undefined }
-        const val = resolvePath(batchEntries[0] ?? {}, field)
-        if (val === undefined && onMissing) onMissing(`batch.${field}`)
-        return val
-      }
-      return applyAggregate(op, field, batchEntries, onMissing)
-    }
-
-    if (onMissing) onMissing(scope)
-    return undefined
-  }
-
-  return { lookup, triggerEntry }
-}
-
-export function deriveEntryContext(
-  base: ResolvedContext,
-  entry: Record<string, unknown>,
-): ResolvedContext {
-  return {
-    lookup(parsed: ParsedKey, onMissing?: (field: string) => void): unknown {
-      if (parsed.kind === 'simple') {
-        if (parsed.path.startsWith('this.')) {
-          const field = parsed.path.slice(5)
-          const val = resolvePath(entry, field)
-          if (val === undefined && onMissing) onMissing(parsed.path)
-          return val
-        }
-        const val = resolvePath(entry, parsed.path)
-        if (val === undefined && onMissing) onMissing(parsed.path)
-        return val
-      }
-      if (parsed.kind === 'scoped' && parsed.scope === 'this') {
-        if (parsed.op !== 'field' || !parsed.field) { if (onMissing) onMissing('this.field'); return undefined }
-        const val = resolvePath(entry, parsed.field)
-        if (val === undefined && onMissing) onMissing(`this.${parsed.field}`)
-        return val
-      }
-      return base.lookup(parsed, onMissing)
-    },
-    triggerEntry: entry,
-  }
-}
+// 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 { Automation } from '@beechcms/core'
+import type { AutomationContextSelector, ParsedKey } from './template-grammar'
+import { resolvePath } from './automation-runner.utils'
+
+export interface ResolvedContext {
+  lookup(key: ParsedKey, onMissing?: (field: string) => void): unknown
+  triggerEntry: Record<string, unknown> | null
+}
+
+const MAX_PLUCK = 100
+const AGGREGATE_OPS = new Set(['count', 'sum', 'avg', 'min', 'max', 'pluck'])
+
+function applyAggregate(
+  op: string,
+  field: string | null,
+  rows: Array<Record<string, unknown>>,
+  onMissing?: (f: string) => void,
+): unknown {
+  switch (op) {
+    case 'count':
+      return rows.length
+
+    case 'sum': {
+      if (!field) { if (onMissing) onMissing('sum:field'); return 0 }
+      return rows.reduce((acc, r) => {
+        const v = Number(r[field])
+        if (Number.isNaN(v)) { if (onMissing) onMissing(`sum:${field}:NaN`); return acc }
+        return acc + v
+      }, 0)
+    }
+
+    case 'avg': {
+      if (!field || rows.length === 0) { if (onMissing && !field) onMissing('avg:field'); return 0 }
+      const total = rows.reduce((acc, r) => {
+        const v = Number(r[field])
+        if (Number.isNaN(v)) { if (onMissing) onMissing(`avg:${field}:NaN`); return acc }
+        return acc + v
+      }, 0)
+      return rows.length > 0 ? total / rows.length : 0
+    }
+
+    case 'min': {
+      if (!field || rows.length === 0) { if (onMissing && !field) onMissing('min:field'); return null }
+      return rows.reduce<number | null>((acc, r) => {
+        const v = Number(r[field])
+        if (Number.isNaN(v)) return acc
+        return acc === null || v < acc ? v : acc
+      }, null)
+    }
+
+    case 'max': {
+      if (!field || rows.length === 0) { if (onMissing && !field) onMissing('max:field'); return null }
+      return rows.reduce<number | null>((acc, r) => {
+        const v = Number(r[field])
+        if (Number.isNaN(v)) return acc
+        return acc === null || v > acc ? v : acc
+      }, null)
+    }
+
+    case 'pluck': {
+      if (!field) { if (onMissing) onMissing('pluck:field'); return '' }
+      const values = rows.slice(0, MAX_PLUCK).map((r) => String(r[field] ?? ''))
+      const truncated = rows.length > MAX_PLUCK
+      return values.join(', ') + (truncated ? ' …' : '')
+    }
+
+    default:
+      return undefined
+  }
+}
+
+export async function resolveAutomationContext(
+  _automation: Automation,
+  triggerEntry: Record<string, unknown> | null,
+  batchEntries: Array<Record<string, unknown>>,
+): Promise<ResolvedContext> {
+  function lookup(parsed: ParsedKey, onMissing?: (field: string) => void): unknown {
+    if (parsed.kind === 'simple') {
+      if (parsed.path.startsWith('this.')) {
+        const field = parsed.path.slice(5)
+        const val = resolvePath(triggerEntry ?? {}, field)
+        if (val === undefined && onMissing) onMissing(parsed.path)
+        return val
+      }
+      const val = resolvePath(triggerEntry ?? {}, parsed.path)
+      if (val === undefined && onMissing) onMissing(parsed.path)
+      return val
+    }
+
+    if (parsed.kind !== 'scoped') {
+      if (onMissing) onMissing(parsed.kind === 'var_access' ? parsed.name : 'unknown')
+      return undefined
+    }
+
+    const { scope, selector: _selector, op, field } = parsed
+
+    if (scope === 'this') {
+      if (op !== 'field' || !field) { if (onMissing) onMissing(`this.${field}`); return undefined }
+      const val = resolvePath(triggerEntry ?? {}, field)
+      if (val === undefined && onMissing) onMissing(`this.${field}`)
+      return val
+    }
+
+    if (scope === 'batch') {
+      if (op === 'field') {
+        if (!field) { if (onMissing) onMissing('batch.field'); return undefined }
+        const val = resolvePath(batchEntries[0] ?? {}, field)
+        if (val === undefined && onMissing) onMissing(`batch.${field}`)
+        return val
+      }
+      return applyAggregate(op, field, batchEntries, onMissing)
+    }
+
+    if (onMissing) onMissing(scope)
+    return undefined
+  }
+
+  return { lookup, triggerEntry }
+}
+
+export function deriveEntryContext(
+  base: ResolvedContext,
+  entry: Record<string, unknown>,
+): ResolvedContext {
+  return {
+    lookup(parsed: ParsedKey, onMissing?: (field: string) => void): unknown {
+      if (parsed.kind === 'simple') {
+        if (parsed.path.startsWith('this.')) {
+          const field = parsed.path.slice(5)
+          const val = resolvePath(entry, field)
+          if (val === undefined && onMissing) onMissing(parsed.path)
+          return val
+        }
+        const val = resolvePath(entry, parsed.path)
+        if (val === undefined && onMissing) onMissing(parsed.path)
+        return val
+      }
+      if (parsed.kind === 'scoped' && parsed.scope === 'this') {
+        if (parsed.op !== 'field' || !parsed.field) { if (onMissing) onMissing('this.field'); return undefined }
+        const val = resolvePath(entry, parsed.field)
+        if (val === undefined && onMissing) onMissing(`this.${parsed.field}`)
+        return val
+      }
+      return base.lookup(parsed, onMissing)
+    },
+    triggerEntry: entry,
+  }
+}

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

@@ -1,136 +1,140 @@
-import type {
-  Automation,
-  ContentRepository,
-  FilterGroup,
-  IAutomationRepository,
-  IIdGenerator,
-  Seed,
-} from '@beechcms/core'
-import { cronMatches } from './cron-runner.utils'
-import { executeAction } from './action-executors'
-import { resolveAutomationContext, deriveEntryContext } from './context-resolver'
-import { extractPushdownFilters } from './when-pushdown'
-import { evaluateWhen } from './when-evaluator'
-
-export interface CronRunnerDeps {
-  automationRepository: IAutomationRepository
-  contentRepository: ContentRepository
-  getSeed: (slug: string) => Seed | null
-  env: Record<string, string | undefined>
-  idGenerator: IIdGenerator
-}
-
-// These actions mutate individual entries and must run once per entry.
-// All other actions (send_mail, webhook) run once per automation with a batch context.
-const PER_ENTRY_ACTIONS = new Set(['edit_field', 'create_entry'])
-
-export async function runCronAutomations(
-  deps: CronRunnerDeps,
-  scheduledTime: number,
-): Promise<void> {
-  console.log(`[cron] Starting runCronAutomations at scheduledTime: ${new Date(scheduledTime).toISOString()}`)
-
-  let automations: Automation[]
-  try {
-    automations = await deps.automationRepository.findActive('*', 'cron')
-  } catch (err) {
-    console.error('[cron] Failed to fetch automations — is migration 0029_automations.sql applied?', err)
-    return
-  }
-
-  console.log(`[cron] Found ${automations.length} active cron automation(s)`)
-
-  for (const automation of automations) {
-    const cronTrigger = automation.triggers.find((t) => t.event === 'cron')
-    if (!cronMatches(cronTrigger?.cron ?? null, scheduledTime)) {
-      console.log(`[cron] Skipping "${automation.name}": cron expression "${cronTrigger?.cron}" does not match.`)
-      continue
-    }
-
-    const seed = deps.getSeed(automation.seed_slug)
-    if (!seed) {
-      console.warn('[cron] unknown seed', { automationId: automation.id, seedSlug: automation.seed_slug })
-      continue
-    }
-
-    let entries: Array<Record<string, unknown>> = []
-    try {
-      entries = await fetchMatchingEntries(deps.contentRepository, seed, automation)
-      console.log(`[cron] Fetched ${entries.length} matching entries for automation "${automation.name}"`)
-    } catch (err) {
-      console.error('[cron] fetch entries failed', { automationId: automation.id, err })
-      continue
-    }
-
-    if (entries.length === 0) continue
-
-    // Build the base ResolvedContext once per automation (shared seed-query cache).
-    // triggerEntry = first entry; batchEntries = full SQL-filtered list.
-    const batchResolved = await resolveAutomationContext(
-      automation,
-      entries[0] ?? null,
-      entries,
-    )
-
-    const variables: Record<string, unknown> = {}
-    const baseCtx = {
-      env: deps.env,
-      repository: deps.contentRepository,
-      getSeed: deps.getSeed,
-      seed,
-      idGenerator: deps.idGenerator,
-      variables,
-    }
-
-    for (const action of automation.actions) {
-      if (PER_ENTRY_ACTIONS.has(action.type)) {
-        for (const entry of entries) {
-          // Per-entry: derive a lightweight context whose `this` is the current entry.
-          // Seed-query cache is reused from batchResolved.
-          const entryResolved = deriveEntryContext(batchResolved, entry)
-          // In-memory per-entry condition check (Task 13)
-          if (!evaluateWhen(automation.trigger_conditions, entryResolved)) continue
-          try {
-            await executeAction(action, { ...baseCtx, entry, context: entryResolved })
-          } catch (err) {
-            console.error('[cron] entry action failed', {
-              automationId: automation.id,
-              entryId: entry['id'],
-              actionType: action.type,
-              err,
-            })
-          }
-        }
-      } else {
-        // Batch actions run once per automation with the shared batch context.
-        try {
-          await executeAction(action, { ...baseCtx, entry: entries[0] ?? {}, context: batchResolved })
-        } catch (err) {
-          console.error('[cron] batch action failed', {
-            automationId: automation.id,
-            actionType: action.type,
-            err,
-          })
-        }
-      }
-    }
-  }
-}
-
-async function fetchMatchingEntries(
-  repository: ContentRepository,
-  seed: Seed,
-  automation: Automation,
-): Promise<Array<Record<string, unknown>>> {
-  // Task 12: push down only safe predicates to SQL (this.<field> = literal, AND group only).
-  // OR branches, cross-seed refs, and gte/lte/etc. ops are evaluated in-memory by evaluateWhen().
-  const filters: FilterGroup[] = automation.trigger_conditions
-    ? extractPushdownFilters(automation.trigger_conditions, seed)
-    : []
-  const result = await repository.findMany(seed, {
-    filters,
-    status: null,
-    pagination: { limit: 1000, offset: 0 },
-  })
-  return result.items
-}
+// 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 {
+  Automation,
+  ContentRepository,
+  FilterGroup,
+  IAutomationRepository,
+  IIdGenerator,
+  Seed,
+} from '@beechcms/core'
+import { cronMatches } from './cron-runner.utils'
+import { executeAction } from './action-executors'
+import { resolveAutomationContext, deriveEntryContext } from './context-resolver'
+import { extractPushdownFilters } from './when-pushdown'
+import { evaluateWhen } from './when-evaluator'
+
+export interface CronRunnerDeps {
+  automationRepository: IAutomationRepository
+  contentRepository: ContentRepository
+  getSeed: (slug: string) => Seed | null
+  env: Record<string, string | undefined>
+  idGenerator: IIdGenerator
+}
+
+// These actions mutate individual entries and must run once per entry.
+// All other actions (send_mail, webhook) run once per automation with a batch context.
+const PER_ENTRY_ACTIONS = new Set(['edit_field', 'create_entry'])
+
+export async function runCronAutomations(
+  deps: CronRunnerDeps,
+  scheduledTime: number,
+): Promise<void> {
+  console.log(`[cron] Starting runCronAutomations at scheduledTime: ${new Date(scheduledTime).toISOString()}`)
+
+  let automations: Automation[]
+  try {
+    automations = await deps.automationRepository.findActive('*', 'cron')
+  } catch (err) {
+    console.error('[cron] Failed to fetch automations — is migration 0029_automations.sql applied?', err)
+    return
+  }
+
+  console.log(`[cron] Found ${automations.length} active cron automation(s)`)
+
+  for (const automation of automations) {
+    const cronTrigger = automation.triggers.find((t) => t.event === 'cron')
+    if (!cronMatches(cronTrigger?.cron ?? null, scheduledTime)) {
+      console.log(`[cron] Skipping "${automation.name}": cron expression "${cronTrigger?.cron}" does not match.`)
+      continue
+    }
+
+    const seed = deps.getSeed(automation.seed_slug)
+    if (!seed) {
+      console.warn('[cron] unknown seed', { automationId: automation.id, seedSlug: automation.seed_slug })
+      continue
+    }
+
+    let entries: Array<Record<string, unknown>> = []
+    try {
+      entries = await fetchMatchingEntries(deps.contentRepository, seed, automation)
+      console.log(`[cron] Fetched ${entries.length} matching entries for automation "${automation.name}"`)
+    } catch (err) {
+      console.error('[cron] fetch entries failed', { automationId: automation.id, err })
+      continue
+    }
+
+    if (entries.length === 0) continue
+
+    // Build the base ResolvedContext once per automation (shared seed-query cache).
+    // triggerEntry = first entry; batchEntries = full SQL-filtered list.
+    const batchResolved = await resolveAutomationContext(
+      automation,
+      entries[0] ?? null,
+      entries,
+    )
+
+    const variables: Record<string, unknown> = {}
+    const baseCtx = {
+      env: deps.env,
+      repository: deps.contentRepository,
+      getSeed: deps.getSeed,
+      seed,
+      idGenerator: deps.idGenerator,
+      variables,
+    }
+
+    for (const action of automation.actions) {
+      if (PER_ENTRY_ACTIONS.has(action.type)) {
+        for (const entry of entries) {
+          // Per-entry: derive a lightweight context whose `this` is the current entry.
+          // Seed-query cache is reused from batchResolved.
+          const entryResolved = deriveEntryContext(batchResolved, entry)
+          // In-memory per-entry condition check (Task 13)
+          if (!evaluateWhen(automation.trigger_conditions, entryResolved)) continue
+          try {
+            await executeAction(action, { ...baseCtx, entry, context: entryResolved })
+          } catch (err) {
+            console.error('[cron] entry action failed', {
+              automationId: automation.id,
+              entryId: entry['id'],
+              actionType: action.type,
+              err,
+            })
+          }
+        }
+      } else {
+        // Batch actions run once per automation with the shared batch context.
+        try {
+          await executeAction(action, { ...baseCtx, entry: entries[0] ?? {}, context: batchResolved })
+        } catch (err) {
+          console.error('[cron] batch action failed', {
+            automationId: automation.id,
+            actionType: action.type,
+            err,
+          })
+        }
+      }
+    }
+  }
+}
+
+async function fetchMatchingEntries(
+  repository: ContentRepository,
+  seed: Seed,
+  automation: Automation,
+): Promise<Array<Record<string, unknown>>> {
+  // Task 12: push down only safe predicates to SQL (this.<field> = literal, AND group only).
+  // OR branches, cross-seed refs, and gte/lte/etc. ops are evaluated in-memory by evaluateWhen().
+  const filters: FilterGroup[] = automation.trigger_conditions
+    ? extractPushdownFilters(automation.trigger_conditions, seed)
+    : []
+  const result = await repository.findMany(seed, {
+    filters,
+    status: null,
+    pagination: { limit: 1000, offset: 0 },
+  })
+  return result.items
+}