TypeScript Resource Surface

import { createBrewClient } from '@brew.new/sdk'

const brew = createBrewClient({
  apiKey: process.env.BREW_API_KEY!,
})

const preview = await brew.automations.run({
  automationId: 'auto_abc',
  dry_run: true,
})

const started = await brew.automations.run(
  { automationId: 'auto_abc', scheduledAt: '2026-07-21T15:00:00.000Z' },
  { idempotencyKey: 'launch-auto-abc-2026-07-21' },
)

if ('audienceRunId' in started) {
  await brew.automations.audienceRuns.control({
    audienceRunId: started.audienceRunId,
    action: 'pause',
  })
}

import { createBrewClient } from '@brew.new/sdk'

const brew = createBrewClient({ apiKey: process.env.BREW_API_KEY! })

// 1. Create the trigger (deterministic shape, provider is hardcoded brew_api).
//    Create returns the bare trigger row (HTTP 201).
const trigger = await brew.automations.triggers.create({
  title: 'Subscription Renewed',
  description: 'Fires when a subscription is renewed.',
  payloadSchema: {
    type: 'object',
    fields: [
      { key: 'email', type: 'string', required: true },
      { key: 'plan', type: 'string', required: true },
      { key: 'amount', type: 'int', required: true },
    ],
  },
})

// 2. Pre-mint each email body. These rows are referenced by sendEmail
//    nodes inside the automation graph.
const [welcome, gettingStarted] = await Promise.all([
  brew.emails.generate({
    prompt: 'Thank-you email for a successful renewal.',
  }),
  brew.emails.generate({
    prompt:
      'Getting-started tips for renewed subscribers, focus on the Pro features.',
  }),
])

// 3. Assemble the automation graph; sendEmail nodes reference the
//    pre-minted emailIds + emailVersionIds.
const automation = await brew.automations.create({
  name: 'Renewal welcome flow',
  triggerEventId: trigger.triggerEventId,
  nodes: [
    {
      id: 'trg',
      label: 'On renewal',
      type: 'trigger',
      config: { triggerEventId: trigger.triggerEventId },
    },
    {
      id: 'send_welcome',
      label: 'Welcome',
      type: 'sendEmail',
      config: {
        emailId: welcome.emailId,
        emailVersionId: welcome.emailVersionId,
        domainId: 'dom_brand_primary',
        subject: 'Welcome back, {{firstName | there}}!',
        previewText: 'Quick thanks + 2 things to try first.',
      },
    },
    {
      id: 'wait_2d',
      label: 'Wait 2 days',
      type: 'wait',
      config: { duration: 2, unit: 'days' },
    },
    {
      id: 'send_getting_started',
      label: 'Getting started',
      type: 'sendEmail',
      config: {
        emailId: gettingStarted.emailId,
        emailVersionId: gettingStarted.emailVersionId,
        domainId: 'dom_brand_primary',
        subject: 'Getting started with Pro',
        previewText: 'Three feature tips for your first week.',
      },
    },
  ],
  connections: [
    { from: 'trg', to: 'send_welcome' },
    { from: 'send_welcome', to: 'wait_2d' },
    { from: 'wait_2d', to: 'send_getting_started' },
  ],
})

// 4. Publish (convenience wrapper over patch({ published: true })).
await brew.automations.publish({ automationId: automation.automationId })

// 5. Fire the trigger with a real payload.
const fire = await brew.automations.triggers.fire({
  triggerEventId: trigger.triggerEventId,
  payload: {
    email: 'jane@example.com',
    plan: 'Pro',
    amount: 4200,
  },
  idempotencyKey: 'renewal-jane-2026-04-08',
})
console.log('Started automation runs:', fire.details?.automationRunIds)

// 6. Poll the run lifecycle (reads live under automations.runs).
const { data: runs } = await brew.automations.runs.list({
  automationRunId: fire.details!.automationRunIds[0]!,
  include: 'logs',
})
console.log('Status:', runs[0]!.status)

// Send an email design to a target (write).
const accepted = await brew.emails.send({
  emailId: 'eml_x',
  domainId: 'dom_y',
  audienceId: 'aud_z',
  subject: 'Launch update',
  scheduledAt: '2026-07-01T09:00:00Z',
})

// Pull it back before it goes out (idempotent, already-canceled is a no-op).
const { status } = await brew.sends.cancel(accepted.sendId) // → 'canceled'

// Poll its lifecycle + stats, with the per-recipient event feed inlined (read).
const { data: sends } = await brew.analytics.sends.list({
  sendId: accepted.sendId,
  include: 'events',
})
const send = sends[0]!
console.log(send.status, send.stats?.delivered)
for (const ev of send.events ?? []) {
  console.log(ev.eventType, ev.recipientEmail)
}

// All sends for one design.
const { data: forEmail } = await brew.analytics.sends.list({ emailId: 'eml_x' })

// Fired-trigger instances (the audit trail of every trigger fire).
const instances = await brew.analytics.triggerInstances.list({ triggerEventId: 'tri_signup' })