@bpmnkit/connector-gen 0.0.2 → 0.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 urbanisierung
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,92 @@
+<div align="center">
+  <img src="https://raw.githubusercontent.com/bpmnkit/monorepo/main/doc/logos/logo-2-gateway.svg" width="72" height="72" alt="BPMN Kit logo">
+  <h1>@bpmnkit/connector-gen</h1>
+  <p>Generate Camunda REST connector element templates from OpenAPI/Swagger specs</p>
+
+  [![npm](https://img.shields.io/npm/v/@bpmnkit/connector-gen?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmnkit/connector-gen)
+  [![license](https://img.shields.io/npm/l/@bpmnkit/connector-gen?style=flat-square)](https://github.com/bpmnkit/monorepo/blob/main/LICENSE)
+  [![typescript](https://img.shields.io/badge/TypeScript-strict-6244d7?style=flat-square&logo=typescript&logoColor=white)](https://github.com/bpmnkit/monorepo)
+
+  [Website](https://bpmnkit.com) · [Documentation](https://docs.bpmnkit.com) · [GitHub](https://github.com/bpmnkit/monorepo) · [Changelog](https://github.com/bpmnkit/monorepo/blob/main/packages/connector-gen/CHANGELOG.md)
+</div>
+
+---
+
+## 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
+
+```sh
+npm install @bpmnkit/connector-gen
+```
+
+## Quick Start
+
+```typescript
+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`)
+
+```sh
+casen connector generate openapi.yaml --out ./templates/
+```
+
+## API Reference
+
+```typescript
+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`](https://www.npmjs.com/package/@bpmnkit/core) | BPMN/DMN/Form parser, builder, layout engine |
+| [`@bpmnkit/canvas`](https://www.npmjs.com/package/@bpmnkit/canvas) | Zero-dependency SVG BPMN viewer |
+| [`@bpmnkit/editor`](https://www.npmjs.com/package/@bpmnkit/editor) | Full-featured interactive BPMN editor |
+| [`@bpmnkit/engine`](https://www.npmjs.com/package/@bpmnkit/engine) | Lightweight BPMN process execution engine |
+| [`@bpmnkit/feel`](https://www.npmjs.com/package/@bpmnkit/feel) | FEEL expression language parser & evaluator |
+| [`@bpmnkit/plugins`](https://www.npmjs.com/package/@bpmnkit/plugins) | 22 composable canvas plugins |
+| [`@bpmnkit/api`](https://www.npmjs.com/package/@bpmnkit/api) | Camunda 8 REST API TypeScript client |
+| [`@bpmnkit/ascii`](https://www.npmjs.com/package/@bpmnkit/ascii) | Render BPMN diagrams as Unicode ASCII art |
+| [`@bpmnkit/ui`](https://www.npmjs.com/package/@bpmnkit/ui) | Shared design tokens and UI components |
+| [`@bpmnkit/profiles`](https://www.npmjs.com/package/@bpmnkit/profiles) | Shared auth, profile storage, and client factories for CLI & proxy |
+| [`@bpmnkit/operate`](https://www.npmjs.com/package/@bpmnkit/operate) | Monitoring & operations frontend for Camunda clusters |
+| [`@bpmnkit/cli`](https://www.npmjs.com/package/@bpmnkit/cli) | Camunda 8 command-line interface (casen) |
+| [`@bpmnkit/proxy`](https://www.npmjs.com/package/@bpmnkit/proxy) | Local AI bridge and Camunda API proxy server |
+
+## License
+
+[MIT](https://github.com/bpmnkit/monorepo/blob/main/LICENSE) © BPMN Kit — made by [u11g](https://u11g.com)

package/package.json

@@ -1,31 +1,51 @@
 {
-	"name": "@bpmnkit/connector-gen",
-	"version": "0.0.2",
-	"private": false,
-	"type": "module",
-	"exports": {
-		".": {
-			"import": "./dist/index.js",
-			"types": "./dist/index.d.ts"
-		}
-	},
-	"main": "./dist/index.js",
-	"types": "./dist/index.d.ts",
-	"files": ["dist/**/*.js", "dist/**/*.d.ts"],
-	"scripts": {
-		"build": "tsc",
-		"typecheck": "tsc --noEmit",
-		"check": "biome check .",
-		"test": "vitest run"
-	},
-	"dependencies": {
-		"yaml": "^2.7.0"
-	},
-	"description": "Generate Camunda REST connector element templates from OpenAPI/Swagger specs",
-	"keywords": ["camunda", "connector", "openapi", "swagger", "bpmn", "element-template"],
-	"license": "MIT",
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/bpmnkit/monorepo"
-	}
-}
+  "name": "@bpmnkit/connector-gen",
+  "version": "0.0.4",
+  "private": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "LICENSE",
+    "README.md",
+    "dist/**/*.js",
+    "dist/**/*.d.ts"
+  ],
+  "dependencies": {
+    "yaml": "^2.7.0"
+  },
+  "description": "Generate Camunda REST connector element templates from OpenAPI/Swagger specs",
+  "keywords": [
+    "camunda",
+    "connector",
+    "openapi",
+    "swagger",
+    "bpmn",
+    "element-template",
+    "typescript"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bpmnkit/monorepo"
+  },
+  "homepage": "https://bpmnkit.com",
+  "bugs": {
+    "url": "https://github.com/bpmnkit/monorepo/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "check": "biome check .",
+    "test": "vitest run"
+  }
+}