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

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

@@ -1,140 +1,140 @@
-// 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
-}
+// 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
+}

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

@@ -1,44 +1,44 @@
-// 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.
-
-export function cronMatches(expression: string | null, scheduledTime: number): boolean {
-  if (!expression) return false
-  const parts = expression.trim().split(/\s+/)
-  if (parts.length !== 5) return false
-
-  const d = new Date(scheduledTime)
-  const actual = [
-    d.getUTCMinutes(),
-    d.getUTCHours(),
-    d.getUTCDate(),
-    d.getUTCMonth() + 1,
-    d.getUTCDay(),
-  ] as const
-
-  return parts.every((field, i) => matchField(field, actual[i]))
-}
-
-function matchField(field: string, value: number): boolean {
-  if (field === '*') return true
-  if (field.includes(',')) {
-    return field.split(',').some((part) => matchField(part, value))
-  }
-  if (field.includes('/')) {
-    const [rangePart, stepPart] = field.split('/')
-    const step = Number(stepPart)
-    if (!Number.isFinite(step) || step <= 0) return false
-    if (rangePart === '*') return value % step === 0
-    if (rangePart.includes('-')) {
-      const [lo, hi] = rangePart.split('-').map(Number)
-      return value >= lo && value <= hi && (value - lo) % step === 0
-    }
-    return false
-  }
-  if (field.includes('-')) {
-    const [lo, hi] = field.split('-').map(Number)
-    return Number.isFinite(lo) && Number.isFinite(hi) && value >= lo && value <= hi
-  }
-  const n = Number(field)
-  return Number.isFinite(n) && n === value
-}
+// 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.
+
+export function cronMatches(expression: string | null, scheduledTime: number): boolean {
+  if (!expression) return false
+  const parts = expression.trim().split(/\s+/)
+  if (parts.length !== 5) return false
+
+  const d = new Date(scheduledTime)
+  const actual = [
+    d.getUTCMinutes(),
+    d.getUTCHours(),
+    d.getUTCDate(),
+    d.getUTCMonth() + 1,
+    d.getUTCDay(),
+  ] as const
+
+  return parts.every((field, i) => matchField(field, actual[i]))
+}
+
+function matchField(field: string, value: number): boolean {
+  if (field === '*') return true
+  if (field.includes(',')) {
+    return field.split(',').some((part) => matchField(part, value))
+  }
+  if (field.includes('/')) {
+    const [rangePart, stepPart] = field.split('/')
+    const step = Number(stepPart)
+    if (!Number.isFinite(step) || step <= 0) return false
+    if (rangePart === '*') return value % step === 0
+    if (rangePart.includes('-')) {
+      const [lo, hi] = rangePart.split('-').map(Number)
+      return value >= lo && value <= hi && (value - lo) % step === 0
+    }
+    return false
+  }
+  if (field.includes('-')) {
+    const [lo, hi] = field.split('-').map(Number)
+    return Number.isFinite(lo) && Number.isFinite(hi) && value >= lo && value <= hi
+  }
+  const n = Number(field)
+  return Number.isFinite(n) && n === value
+}

package/src/features/automations/filter-translation.ts

@@ -1,46 +1,46 @@
-// 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.
-
-/**
- * Shared helper: converts a TriggerCondition into a FilterGroup accepted by
- * ContentRepository.findMany. Used by cron-runner and context-resolver.
- *
- * TODO Sprint 8 (Task 12): when-pushdown.ts will call extractPushdownFilters
- * to convert safe WhenNode predicates to FilterGroup[] for SQL pre-filtering.
- */
-import type { BranchType, FilterGroup, FilterOperator, FilterType, Seed, TriggerCondition } from '@beechcms/core'
-
-const SYSTEM_COLUMNS = new Set(['id', 'slug', 'status', 'created_at', 'updated_at'])
-
-function mapBranchTypeToFilterType(type: BranchType): FilterType {
-  switch (type) {
-    case 'number': return 'number'
-    case 'boolean': return 'boolean'
-    case 'date': return 'date'
-    case 'tags': return 'tags'
-    case 'json': return 'json'
-    default: return 'text'
-  }
-}
-
-function mapOp(op: TriggerCondition['op']): FilterOperator {
-  switch (op) {
-    case 'isempty': return 'is_empty'
-    case 'isnotempty': return 'is_not_empty'
-    default: return op
-  }
-}
-
-export function conditionToFilterGroup(c: TriggerCondition, seed: Seed): FilterGroup {
-  const branch = seed.branches.find((b) => b.alias === c.field)
-  const type: FilterType = branch
-    ? mapBranchTypeToFilterType(branch.type)
-    : SYSTEM_COLUMNS.has(c.field) ? 'system' : 'text'
-
-  return {
-    column: c.field,
-    type,
-    conditions: [{ op: mapOp(c.op), value: c.value as string | number | boolean | null }],
-  }
-}
+// 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.
+
+/**
+ * Shared helper: converts a TriggerCondition into a FilterGroup accepted by
+ * ContentRepository.findMany. Used by cron-runner and context-resolver.
+ *
+ * TODO Sprint 8 (Task 12): when-pushdown.ts will call extractPushdownFilters
+ * to convert safe WhenNode predicates to FilterGroup[] for SQL pre-filtering.
+ */
+import type { BranchType, FilterGroup, FilterOperator, FilterType, Seed, TriggerCondition } from '@beechcms/core'
+
+const SYSTEM_COLUMNS = new Set(['id', 'slug', 'status', 'created_at', 'updated_at'])
+
+function mapBranchTypeToFilterType(type: BranchType): FilterType {
+  switch (type) {
+    case 'number': return 'number'
+    case 'boolean': return 'boolean'
+    case 'date': return 'date'
+    case 'tags': return 'tags'
+    case 'json': return 'json'
+    default: return 'text'
+  }
+}
+
+function mapOp(op: TriggerCondition['op']): FilterOperator {
+  switch (op) {
+    case 'isempty': return 'is_empty'
+    case 'isnotempty': return 'is_not_empty'
+    default: return op
+  }
+}
+
+export function conditionToFilterGroup(c: TriggerCondition, seed: Seed): FilterGroup {
+  const branch = seed.branches.find((b) => b.alias === c.field)
+  const type: FilterType = branch
+    ? mapBranchTypeToFilterType(branch.type)
+    : SYSTEM_COLUMNS.has(c.field) ? 'system' : 'text'
+
+  return {
+    column: c.field,
+    type,
+    conditions: [{ op: mapOp(c.op), value: c.value as string | number | boolean | null }],
+  }
+}

package/src/features/automations/index.ts

@@ -1,16 +1,16 @@
-// 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.
-
-export { AutomationRunner } from './automation-runner'
-export type { AutomationRunnerDeps } from './automation-runner'
-export { runCronAutomations } from './cron-runner'
-export type { CronRunnerDeps } from './cron-runner'
-export { automationsApp } from './automations.handler'
-export {
-  createAutomationSchema,
-  updateAutomationSchema,
-  toggleAutomationSchema,
-  automationActionSchema,
-} from './automations.schema'
-export type { CreateAutomationBody, UpdateAutomationBody } from './automations.schema'
+// 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.
+
+export { AutomationRunner } from './automation-runner'
+export type { AutomationRunnerDeps } from './automation-runner'
+export { runCronAutomations } from './cron-runner'
+export type { CronRunnerDeps } from './cron-runner'
+export { automationsApp } from './automations.handler'
+export {
+  createAutomationSchema,
+  updateAutomationSchema,
+  toggleAutomationSchema,
+  automationActionSchema,
+} from './automations.schema'
+export type { CreateAutomationBody, UpdateAutomationBody } from './automations.schema'