Verbs

verb
  ├── verb()        → execute (imperative)
  ├── verbing()     → BEFORE hook (present participle)
  ├── verbed()      → AFTER hook (past tense)
  └── verbedBy      → audit trail (passive voice)

import { Contact } from '@headlessly/crm'

// Execute the verb
await Contact.qualify({ id: 'contact_fX9bL5nRd' })

// BEFORE hook — runs before execution
Contact.qualifying(contact => {
  if (!contact.email) throw new Error('Cannot qualify without email')
  return contact
})

// AFTER hook — runs after execution
Contact.qualified((contact, $) => {
  $.Issue.create({
    title: `Follow up with ${contact.name}`,
    contact: contact.$id,
    status: 'Open',
  })
})

// Audit — queryable reverse lookup
const events = await Contact.qualifiedBy('agent_mR4nVkTw')

import { Contact } from '@headlessly/crm'

// Full CRUD conjugation — available on every entity
Contact.creating(contact => { /* validate before create */ })
const created = await Contact.create({ name: 'Alice', stage: 'Lead' })
Contact.created(contact => { /* react after create */ })

Contact.updating((contact, changes) => { /* validate before update */ })
await Contact.update('contact_fX9bL5nRd', { stage: 'Qualified' })
Contact.updated(contact => { /* react after update */ })

Contact.deleting(contact => { /* guard before delete */ })
await Contact.delete('contact_fX9bL5nRd')
Contact.deleted(contact => { /* clean up after delete */ })

import { Noun } from 'digital-objects'

export const Deal = Noun('Deal', {
  name: 'string!',
  value: 'number!',
  stage: 'Prospecting | Qualification | Proposal | Negotiation | Closed | Won | Lost',
  contact: '-> Contact.deals',

  advance: 'Advanced',
  close:   'Closed',
  lose:    'Lost',
  reopen:  'Reopened',
})

import { Contact } from '@headlessly/crm'
import { Subscription } from '@headlessly/billing'

// Reject invalid operations
Contact.qualifying(contact => {
  if (!contact.email) throw new Error('Cannot qualify without email')
  if (!contact.organization) throw new Error('Contact must belong to an organization')
  return contact
})

// Transform before write
Subscription.creating(sub => {
  return { ...sub, startDate: new Date().toISOString() }
})

import { Deal } from '@headlessly/crm'

Deal.closed((deal, $) => {
  // Cross-domain: create a billing subscription
  $.Subscription.create({ plan: 'pro', contact: deal.contact })

  // Cross-domain: update the contact stage
  $.Contact.update(deal.contact, { stage: 'Customer' })

  // Cross-domain: create onboarding content
  $.Content.create({
    title: `Onboarding: ${deal.name}`,
    type: 'Article',
    status: 'Draft',
  })
})

import { $ } from '@headlessly/sdk'

import { Contact } from '@headlessly/crm'

await Contact.qualify({ id: 'contact_fX9bL5nRd' })

await $.Contact.qualify({ id: 'contact_fX9bL5nRd' })

npx @headlessly/cli do Contact.qualify contact_fX9bL5nRd

POST https://crm.headless.ly/~my-startup/Contact/contact_fX9bL5nRd/qualify

{ "type": "Event", "filter": { "type": "Contact.Qualified", "target": "contact_fX9bL5nRd" } }

Handler registered → fn.toString() → stored in DO SQLite
Verb executed      → handler deserialized → runs in-DO → ~0ms latency