Website · Documentation · GitHub · Changelog

Overview

@bpmnkit/connector-gen parses OpenAPI 3.x and Swagger 2.x specifications and generates Camunda REST connector element templates. Drop in your API spec and get a ready-to-import .json template that wires up request/response mappings automatically.

Features

• OpenAPI 3.x and Swagger 2.x support
• Generates Camunda element templates — REST connector format with input/output mappings
• Endpoint selection — generate all endpoints or filter by path/method
• FEEL expressions — pre-fills input bindings with =variable expressions
• Zero dependencies beyond yaml for YAML parsing

Installation

npm install @bpmnkit/connector-gen

Quick Start

import { generateConnectorTemplates } from "@bpmnkit/connector-gen"
import { readFileSync, writeFileSync } from "node:fs"

const spec = readFileSync("openapi.yaml", "utf8")
const templates = generateConnectorTemplates(spec)

for (const template of templates) {
  writeFileSync(`${template.id}.json`, JSON.stringify(template, null, 2))
  console.log(`Generated: ${template.name}`)
}

CLI usage (via @bpmnkit/cli)

casen connector generate openapi.yaml --out ./templates/

API Reference

function generateConnectorTemplates(
  spec: string,            // YAML or JSON OpenAPI/Swagger spec
  options?: GenerateOptions
): ConnectorTemplate[]

interface GenerateOptions {
  filter?: {
    paths?: string[]       // include only these path prefixes
    methods?: string[]     // e.g. ["get", "post"]
  }
}

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/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 |

License

MIT © BPMN Kit — made by u11g