// Hono
app.route("/api/stepflow", createStepflowRoutes(stepflow));

// Express
app.use("/api/stepflow", createStepflowRouter(stepflow));

// Next.js
// Routes are at /api/stepflow/[...path]

curl -X POST https://api.example.com/api/stepflow/trigger/my-workflow \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"userId": "123"}'

curl -X POST https://api.example.com/api/stepflow/trigger/my-workflow \
  -H "Authorization: Bearer your-jwt-token" \
  -H "Content-Type: application/json" \
  -d '{"userId": "123"}'

curl https://api.example.com/api/stepflow/runs/run_123?token=pat_xyz

POST /trigger/{workflowId}

{
  "userId": "user_123",
  "email": "user@example.com"
}

{
  "runId": "run_abc123",
  "publicAccessToken": "pat_xyz789"
}

GET /runs/{runId}

{
  "id": "run_abc123",
  "workflowId": "welcome-user",
  "status": "running",
  "input": {
    "userId": "user_123",
    "email": "user@example.com"
  },
  "steps": [
    {
      "name": "send-welcome",
      "status": "completed",
      "result": { "sent": true }
    },
    {
      "name": "send-followup",
      "status": "pending"
    }
  ],
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:31:00Z"
}

GET /runs/{runId}/stream

event: status
data: {"status":"running","stepName":"send-email"}

event: step
data: {"name":"send-email","status":"completed","result":{"sent":true}}

event: complete
data: {"status":"completed","result":{"success":true}}

POST /notify/{eventId}

{
  "status": "paid",
  "amount": 99.99,
  "transactionId": "txn_456"
}

{
  "success": true
}

GET /health

{
  "status": "ok",
  "timestamp": "2024-01-15T10:30:00Z"
}

{
  "error": "Workflow not found",
  "code": "WORKFLOW_NOT_FOUND"
}