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

package/src/features/automations/__tests__/template-grammar.test.ts

@@ -1,308 +0,0 @@
-// 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 { describe, it, expect } from 'vitest'
-import { parseTemplateKey } from '../template-grammar'
-import type { ParsedKey, VarStep, InlineCondition } from '../template-grammar'
-
-describe('parseTemplateKey', () => {
-  describe('simple keys', () => {
-    it('returns simple for a plain field name', () => {
-      expect(parseTemplateKey('title')).toEqual<ParsedKey>({ kind: 'simple', path: 'title' })
-    })
-
-    it('returns simple for a dot-path', () => {
-      expect(parseTemplateKey('author.name')).toEqual<ParsedKey>({ kind: 'simple', path: 'author.name' })
-    })
-
-    it('returns simple for _count (legacy)', () => {
-      expect(parseTemplateKey('_count')).toEqual<ParsedKey>({ kind: 'simple', path: '_count' })
-    })
-
-    it('returns null for empty string', () => {
-      expect(parseTemplateKey('')).toBeNull()
-    })
-  })
-
-  describe('two-token sugar: <scope>:<field>', () => {
-    it('defaults to lastone selector for <seedSlug>:<field>', () => {
-      expect(parseTemplateKey('customers:email')).toEqual<ParsedKey>({
-        kind: 'scoped',
-        scope: 'customers',
-        selector: { kind: 'lastone' },
-        op: 'field',
-        field: 'email',
-      })
-    })
-
-    it('defaults to lastone selector for this:<field>', () => {
-      expect(parseTemplateKey('this:email')).toEqual<ParsedKey>({
-        kind: 'scoped',
-        scope: 'this',
-        selector: { kind: 'lastone' },
-        op: 'field',
-        field: 'email',
-      })
-    })
-
-    it('sugar: batch:count → batch:all:count', () => {
-      expect(parseTemplateKey('batch:count')).toEqual<ParsedKey>({
-        kind: 'scoped',
-        scope: 'batch',
-        selector: { kind: 'all' },
-        op: 'count',
-        field: null,
-      })
-    })
-
-    it('sugar: customers:sum → customers:all:sum (aggregate sugar without subfield)', () => {
-      const result = parseTemplateKey('customers:sum')
-      expect(result).toMatchObject({ kind: 'scoped', scope: 'customers', selector: { kind: 'all' }, op: 'sum' })
-    })
-  })
-
-  describe('three-token: <scope>:<selector>:<field>', () => {
-    it('lastone selector', () => {
-      expect(parseTemplateKey('customers:lastone:email')).toEqual<ParsedKey>({
-        kind: 'scoped',
-        scope: 'customers',
-        selector: { kind: 'lastone' },
-        op: 'field',
-        field: 'email',
-      })
-    })
-
-    it('firstone selector', () => {
-      expect(parseTemplateKey('customers:firstone:name')).toEqual<ParsedKey>({
-        kind: 'scoped',
-        scope: 'customers',
-        selector: { kind: 'firstone' },
-        op: 'field',
-        field: 'name',
-      })
-    })
-
-    it('byid selector', () => {
-      expect(parseTemplateKey('customers:byid(c_42):name')).toEqual<ParsedKey>({
-        kind: 'scoped',
-        scope: 'customers',
-        selector: { kind: 'byid', id: 'c_42' },
-        op: 'field',
-        field: 'name',
-      })
-    })
-
-    it('where selector', () => {
-      expect(parseTemplateKey('orders:where(status=paid):total')).toEqual<ParsedKey>({
-        kind: 'scoped',
-        scope: 'orders',
-        selector: { kind: 'where', alias: 'status', value: 'paid' },
-        op: 'field',
-        field: 'total',
-      })
-    })
-
-    it('all:count aggregate', () => {
-      expect(parseTemplateKey('orders:all:count')).toEqual<ParsedKey>({
-        kind: 'scoped',
-        scope: 'orders',
-        selector: { kind: 'all' },
-        op: 'count',
-        field: null,
-      })
-    })
-
-    it('all:sum:<subfield> aggregate', () => {
-      expect(parseTemplateKey('orders:all:sum:total')).toEqual<ParsedKey>({
-        kind: 'scoped',
-        scope: 'orders',
-        selector: { kind: 'all' },
-        op: 'sum',
-        field: 'total',
-      })
-    })
-
-    it('all:avg aggregate', () => {
-      expect(parseTemplateKey('orders:all:avg:amount')).toMatchObject({
-        kind: 'scoped', scope: 'orders', op: 'avg', field: 'amount',
-      })
-    })
-
-    it('all:min aggregate', () => {
-      expect(parseTemplateKey('orders:all:min:price')).toMatchObject({
-        kind: 'scoped', scope: 'orders', op: 'min', field: 'price',
-      })
-    })
-
-    it('all:max aggregate', () => {
-      expect(parseTemplateKey('orders:all:max:score')).toMatchObject({
-        kind: 'scoped', scope: 'orders', op: 'max', field: 'score',
-      })
-    })
-
-    it('all:pluck:<subfield> aggregate', () => {
-      expect(parseTemplateKey('customers:all:pluck:email')).toEqual<ParsedKey>({
-        kind: 'scoped',
-        scope: 'customers',
-        selector: { kind: 'all' },
-        op: 'pluck',
-        field: 'email',
-      })
-    })
-
-    it('batch:all:count', () => {
-      expect(parseTemplateKey('batch:all:count')).toEqual<ParsedKey>({
-        kind: 'scoped',
-        scope: 'batch',
-        selector: { kind: 'all' },
-        op: 'count',
-        field: null,
-      })
-    })
-
-    it('batch:all:pluck:email', () => {
-      expect(parseTemplateKey('batch:all:pluck:email')).toMatchObject({
-        kind: 'scoped', scope: 'batch', op: 'pluck', field: 'email',
-      })
-    })
-  })
-
-  describe('rejection rules', () => {
-    it('returns null when aggregate used without all selector', () => {
-      expect(parseTemplateKey('orders:lastone:sum')).toBeNull()
-    })
-
-    it('returns null when selector token is unrecognised', () => {
-      expect(parseTemplateKey('orders:unknown:field')).toBeNull()
-    })
-
-    it('returns null when there are no field tokens after selector', () => {
-      expect(parseTemplateKey('orders:lastone')).toEqual<ParsedKey>({
-        kind: 'scoped',
-        scope: 'orders',
-        selector: { kind: 'lastone' },
-        op: 'field',
-        field: 'lastone',
-      })
-    })
-
-    it('colons inside parens do not split tokens', () => {
-      const result = parseTemplateKey('customers:byid(ns:id-123):name')
-      expect(result).toMatchObject({
-        kind: 'scoped',
-        scope: 'customers',
-        selector: { kind: 'byid', id: 'ns:id-123' },
-        op: 'field',
-        field: 'name',
-      })
-    })
-  })
-
-  describe('scoped with this scope', () => {
-    it('this:lastone:field', () => {
-      expect(parseTemplateKey('this:lastone:name')).toMatchObject({
-        kind: 'scoped', scope: 'this', selector: { kind: 'lastone' }, op: 'field', field: 'name',
-      })
-    })
-  })
-})
-
-// ── Sprint 07 var_access cases ─────────────────────────────────────────────────
-
-describe('parseTemplateKey — var_access (Sprint 07)', () => {
-  it('1 — ordini.array[a,b].count → var_access with array + agg:count', () => {
-    const result = parseTemplateKey('ordini.array[a,b].count')
-    expect(result).toEqual<ParsedKey>({
-      kind: 'var_access',
-      name: 'ordini',
-      steps: [
-        { type: 'array', ids: ['a', 'b'] },
-        { type: 'agg', op: 'count' },
-      ],
-      conditions: [],
-    })
-  })
-
-  it('2 — ordini.count.(status=paid) → var_access with agg:count + condition', () => {
-    const result = parseTemplateKey('ordini.count.(status=paid)')
-    expect(result).toEqual<ParsedKey>({
-      kind: 'var_access',
-      name: 'ordini',
-      steps: [{ type: 'agg', op: 'count' }],
-      conditions: [{ column: 'status', op: '=', value: 'paid' }],
-    })
-  })
-
-  it('3 — ordini.sum.total.(amount>100) → var_access with agg:sum:total + condition', () => {
-    const result = parseTemplateKey('ordini.sum.total.(amount>100)')
-    expect(result).toEqual<ParsedKey>({
-      kind: 'var_access',
-      name: 'ordini',
-      steps: [{ type: 'agg', op: 'sum', field: 'total' }],
-      conditions: [{ column: 'amount', op: '>', value: '100' }],
-    })
-  })
-
-  it('4 — ordini.firstone.id.(status=paid) → nav + field + condition', () => {
-    const result = parseTemplateKey('ordini.firstone.id.(status=paid)')
-    expect(result).toEqual<ParsedKey>({
-      kind: 'var_access',
-      name: 'ordini',
-      steps: [
-        { type: 'nav', nav: 'firstone' },
-        { type: 'field', name: 'id' },
-      ],
-      conditions: [{ column: 'status', op: '=', value: 'paid' }],
-    })
-  })
-
-  it('5 — ordini.array[a,b].(status=paid).count → array + condition + agg', () => {
-    const result = parseTemplateKey('ordini.array[a,b].(status=paid).count')
-    expect(result).toMatchObject({
-      kind: 'var_access',
-      name: 'ordini',
-      steps: [
-        { type: 'array', ids: ['a', 'b'] },
-        { type: 'agg', op: 'count' },
-      ],
-      conditions: [{ column: 'status', op: '=', value: 'paid' }],
-    })
-  })
-
-  it('6 — cliente.email → falls through to simple (fast path)', () => {
-    const result = parseTemplateKey('cliente.email')
-    expect(result).toEqual<ParsedKey>({ kind: 'simple', path: 'cliente.email' })
-  })
-
-  it('handles multiple inline conditions (AND-chained)', () => {
-    const result = parseTemplateKey('ordini.count.(status=paid).(amount>10)')
-    expect(result).toMatchObject({
-      kind: 'var_access',
-      conditions: [
-        { column: 'status', op: '=', value: 'paid' },
-        { column: 'amount', op: '>', value: '10' },
-      ],
-    })
-  })
-
-  it('handles != operator', () => {
-    const result = parseTemplateKey('ordini.count.(status!=draft)')
-    expect(result).toMatchObject({
-      kind: 'var_access',
-      conditions: [{ column: 'status', op: '!=', value: 'draft' }],
-    })
-  })
-
-  it('handles <= and >= operators', () => {
-    const r1 = parseTemplateKey('ordini.count.(amount<=100)')
-    const r2 = parseTemplateKey('ordini.count.(amount>=50)')
-    expect(r1).toMatchObject({ conditions: [{ op: '<=' }] })
-    expect(r2).toMatchObject({ conditions: [{ op: '>=' }] })
-  })
-
-  it('plain dot-path without special chars stays simple', () => {
-    expect(parseTemplateKey('ordini.count')).toEqual({ kind: 'simple', path: 'ordini.count' })
-    expect(parseTemplateKey('cliente.nome')).toEqual({ kind: 'simple', path: 'cliente.nome' })
-  })
-})

package/src/features/automations/__tests__/webhook.executor.test.ts

@@ -1,142 +0,0 @@
-// 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 { describe, it, expect, vi, beforeEach } from 'vitest'
-import { executeWebhook } from '../action-executors/webhook.executor'
-import type { ResolvedContext } from '../context-resolver'
-
-function makeContext(entry: Record<string, unknown> = {}, event = 'create'): ResolvedContext {
-  return {
-    triggerEntry: entry,
-    lookup(parsed) {
-      if (parsed.kind === 'simple') {
-        const key = parsed.path.startsWith('this.') ? parsed.path.slice(5) : parsed.path
-        if (key === 'trigger_event') return event
-        return entry[key] ?? null
-      }
-      return null
-    },
-  }
-}
-
-const baseContext = makeContext({ id: 'entry-1', title: 'Hello' })
-
-const baseAction = {
-  type: 'webhook' as const,
-  url: 'https://example.com/hook',
-  body_template: '{"static":true}',
-}
-
-function makeOkResponse(status = 200): Response {
-  return { ok: true, status } as unknown as Response
-}
-
-function makeErrorResponse(status: number): Response {
-  return { ok: false, status } as unknown as Response
-}
-
-beforeEach(() => {
-  vi.restoreAllMocks()
-})
-
-describe('executeWebhook', () => {
-  it('signs request when WEBHOOK_SECRET is set', async () => {
-    const fetchSpy = vi.spyOn(globalThis, 'fetch').mockResolvedValue(makeOkResponse())
-
-    await executeWebhook(baseAction, baseContext, { WEBHOOK_SECRET: 'test-secret' })
-
-    expect(fetchSpy).toHaveBeenCalledOnce()
-    const [, init] = fetchSpy.mock.calls[0]
-    const headers = init?.headers as Record<string, string>
-    expect(headers['X-BeechCMS-Signature']).toMatch(/^sha256=[0-9a-f]{64}$/)
-  })
-
-  it('omits signature header and warns once when WEBHOOK_SECRET is absent', async () => {
-    const fetchSpy = vi.spyOn(globalThis, 'fetch').mockResolvedValue(makeOkResponse())
-    const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {})
-
-    await executeWebhook(baseAction, baseContext, {})
-    await executeWebhook(baseAction, baseContext, {})
-
-    const [, init] = fetchSpy.mock.calls[0]
-    const headers = init?.headers as Record<string, string>
-    expect(headers['X-BeechCMS-Signature']).toBeUndefined()
-    expect(warnSpy).toHaveBeenCalledOnce()
-    expect(warnSpy.mock.calls[0][0]).toContain('WEBHOOK_SECRET')
-  })
-
-  it('overwrites user-supplied X-BeechCMS-Signature header with computed value', async () => {
-    const fetchSpy = vi.spyOn(globalThis, 'fetch').mockResolvedValue(makeOkResponse())
-
-    const action = {
-      ...baseAction,
-      headers: { 'X-BeechCMS-Signature': 'sha256=user-supplied-value' },
-    }
-
-    await executeWebhook(action, baseContext, { WEBHOOK_SECRET: 'test-secret' })
-
-    const [, init] = fetchSpy.mock.calls[0]
-    const headers = init?.headers as Record<string, string>
-    expect(headers['X-BeechCMS-Signature']).toMatch(/^sha256=[0-9a-f]{64}$/)
-    expect(headers['X-BeechCMS-Signature']).not.toBe('sha256=user-supplied-value')
-  })
-
-  it('throws with status code when endpoint responds with 500', async () => {
-    vi.spyOn(globalThis, 'fetch').mockResolvedValue(makeErrorResponse(500))
-
-    await expect(executeWebhook(baseAction, baseContext, {}))
-      .rejects.toThrow('500')
-  })
-
-  it('interpolates body_template placeholders before sending', async () => {
-    const fetchSpy = vi.spyOn(globalThis, 'fetch').mockResolvedValue(makeOkResponse())
-
-    const action = { ...baseAction, body_template: '{"event":"{{trigger_event}}","id":"{{id}}"}' }
-    const ctx = makeContext({ id: 'abc-123' }, 'update')
-
-    await executeWebhook(action, ctx, {})
-
-    const [, init] = fetchSpy.mock.calls[0]
-    const body = init?.body as string
-    expect(body).toContain('abc-123')
-    expect(body).toContain('update')
-  })
-
-  it('recalculates HMAC and matches X-BeechCMS-Signature header', async () => {
-    const fetchSpy = vi.spyOn(globalThis, 'fetch').mockResolvedValue(makeOkResponse())
-    const secret = 'verify-secret'
-
-    await executeWebhook(baseAction, baseContext, { WEBHOOK_SECRET: secret })
-
-    const [, init] = fetchSpy.mock.calls[0]
-    const headers = init?.headers as Record<string, string>
-    const sentBody = init?.body as string
-    const sentSig = headers['X-BeechCMS-Signature']
-
-    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(sentBody))
-    const expected = 'sha256=' + Array.from(new Uint8Array(sig))
-      .map((b) => b.toString(16).padStart(2, '0'))
-      .join('')
-
-    expect(sentSig).toBe(expected)
-  })
-
-  it('throws timeout error when fetch takes longer than 8 seconds', async () => {
-    vi.spyOn(globalThis, 'fetch').mockImplementation(() => {
-      const err = new DOMException('The operation was aborted.', 'TimeoutError')
-      return Promise.reject(err)
-    })
-
-    await expect(executeWebhook(baseAction, baseContext, {}))
-      .rejects.toThrow('timed out after 8000ms')
-  })
-})