Website · Documentation · GitHub · Changelog

Overview

casen-worker-http is an official casen CLI plugin that demonstrates the worker plugin pattern. It subscribes to io.camunda.connector.HttpJson:1 jobs and completes each one with live data fetched from the JSONPlaceholder API — useful for quickly testing a Camunda worker setup without writing any integration code.

Installation

casen plugin install casen-worker-http

Usage

Start the worker from the TUI or directly from the command line:

# Interactive TUI
casen http-worker

# CLI foreground mode (Ctrl+C to stop)
casen http-worker start

What it does

For every activated job the worker:

1. Picks a random user ID (1–10) and fetches https://jsonplaceholder.typicode.com/users/{id}
2. Completes the job with the following variables:

| Variable | Source | |---|---| | userId | user.id | | name | user.name | | email | user.email | | city | user.address.city | | company | user.company.name | | inputVariables | Original job variables | | processedAt | ISO 8601 timestamp |

Building your own worker plugin

Use this package as a starting point. The key API is createWorkerCommand from @bpmnkit/cli-sdk:

import { createWorkerCommand, type CasenPlugin } from "@bpmnkit/cli-sdk"

const plugin: CasenPlugin = {
  id: "com.example.my-worker",
  name: "My Worker",
  version: "1.0.0",
  groups: [{
    name: "my-worker",
    description: "Process my-job jobs",
    commands: [createWorkerCommand({
      jobType: "my-job",
      async processJob(job) {
        return { result: "processed", input: job.variables }
      },
    })],
  }],
}
export default plugin

Related Packages

| Package | Description | |---------|-------------| | @bpmnkit/core | BPMN/DMN/Form parser, builder, layout engine | | @bpmnkit/canvas | Zero-dependency SVG BPMN viewer | | @bpmnkit/editor | Full-featured interactive BPMN editor | | @bpmnkit/engine | Lightweight BPMN process execution engine | | @bpmnkit/feel | FEEL expression language parser & evaluator | | @bpmnkit/plugins | 22 composable canvas plugins | | @bpmnkit/api | Camunda 8 REST API TypeScript client | | @bpmnkit/ascii | Render BPMN diagrams as Unicode ASCII art | | @bpmnkit/ui | Shared design tokens and UI components | | @bpmnkit/profiles | Shared auth, profile storage, and client factories for CLI & proxy | | @bpmnkit/operate | Monitoring & operations frontend for Camunda clusters | | @bpmnkit/connector-gen | Generate connector templates from OpenAPI specs | | @bpmnkit/cli | Camunda 8 command-line interface (casen) | | @bpmnkit/proxy | Local AI bridge and Camunda API proxy server | | @bpmnkit/cli-sdk | Plugin authoring SDK for the casen CLI | | @bpmnkit/create-casen-plugin | Scaffold a new casen CLI plugin in seconds | | @bpmnkit/casen-report | HTML reports from Camunda 8 incident and SLA data | | @bpmnkit/casen-worker-ai | AI task worker — classify, summarize, extract, and decide using Claude |

License

MIT © BPMN Kit — made by u11g