@bpmnkit/plugins 0.0.19 → 0.0.23

package/dist/config-panel-bpmn/util.d.ts

@@ -5,6 +5,20 @@ export declare function xmlLocalName(qname: string): string;
 export declare function findFlowElement(defs: BpmnDefinitions, id: string): BpmnFlowElement | undefined;
 export declare function updateFlowElement(defs: BpmnDefinitions, id: string, fn: (el: BpmnFlowElement) => BpmnFlowElement): BpmnDefinitions;
 export declare function parseZeebeExtensions(extensionElements: XmlElement[]): ZeebeExtensions;
+/** Parsed `zeebe:loopCharacteristics` extension element from a multi-instance loop. */
+export interface ZeebeLoopCharacteristics {
+    inputCollection: string;
+    inputElement: string;
+    outputCollection?: string;
+    outputElement?: string;
+}
+/** Read `zeebe:loopCharacteristics` from a `multiInstanceLoopCharacteristics` extensionElements list. */
+export declare function parseZeebeLoopCharacteristics(extensionElements: XmlElement[]): ZeebeLoopCharacteristics | undefined;
+/** Build a `zeebe:loopCharacteristics` XmlElement from collection/element options. */
+export declare function buildZeebeLoopCharacteristics(opts: {
+    inputCollection: string;
+    inputElement: string;
+}): XmlElement;
 /** Read the example output JSON string from parsed zeebe extensions. */
 export declare function getExampleOutputJson(ext: ZeebeExtensions): string;
 /**

package/dist/config-panel-bpmn/util.js

@@ -101,6 +101,27 @@ export function parseZeebeExtensions(extensionElements) {
     }
     return ext;
 }
+/** Read `zeebe:loopCharacteristics` from a `multiInstanceLoopCharacteristics` extensionElements list. */
+export function parseZeebeLoopCharacteristics(extensionElements) {
+    const loopEl = extensionElements.find((e) => xmlLocalName(e.name) === "loopCharacteristics");
+    if (!loopEl)
+        return undefined;
+    return {
+        inputCollection: loopEl.attributes.inputCollection ?? "",
+        inputElement: loopEl.attributes.inputElement ?? "",
+        outputCollection: loopEl.attributes.outputCollection,
+        outputElement: loopEl.attributes.outputElement,
+    };
+}
+/** Build a `zeebe:loopCharacteristics` XmlElement from collection/element options. */
+export function buildZeebeLoopCharacteristics(opts) {
+    const attrs = {};
+    if (opts.inputCollection)
+        attrs.inputCollection = opts.inputCollection;
+    if (opts.inputElement)
+        attrs.inputElement = opts.inputElement;
+    return { name: "zeebe:loopCharacteristics", attributes: attrs, children: [] };
+}
 const EXAMPLE_OUTPUT_JSON_KEY = "camundaModeler:exampleOutputJson";
 /** Read the example output JSON string from parsed zeebe extensions. */
 export function getExampleOutputJson(ext) {

package/dist/connector-catalog/builtin-templates.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Static catalog of bpmnkit built-in worker element templates.
+ *
+ * These are always available in the connector catalog regardless of whether
+ * the local proxy is running. They mirror the runtime definitions served by
+ * `GET /worker-templates` on the proxy.
+ */
+import type { ElementTemplate } from "../config-panel-bpmn/template-types.js";
+export declare const BUILTIN_WORKER_TEMPLATES: ElementTemplate[];
+//# sourceMappingURL=builtin-templates.d.ts.map

package/dist/connector-catalog/builtin-templates.js

@@ -0,0 +1,585 @@
+const CLI_ICON = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" width="16" height="16"><rect width="16" height="16" rx="3" fill="#1e1e2e"/><text x="3" y="12" font-family="monospace" font-size="10" fill="#cdd6f4">&gt;_</text></svg>`;
+const LLM_ICON = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" width="16" height="16"><rect width="16" height="16" rx="3" fill="#1e1e2e"/><circle cx="8" cy="8" r="5" fill="none" stroke="#6b9df7" stroke-width="1.5"/><path d="M6 8h4M8 6v4" stroke="#6b9df7" stroke-width="1.5"/></svg>`;
+const FS_ICON = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" width="16" height="16"><rect width="16" height="16" rx="3" fill="#1e1e2e"/><path d="M3 5h10v8H3z" fill="none" stroke="#2dd4bf" stroke-width="1.5"/><path d="M3 5l2-2h4l2 2" fill="none" stroke="#2dd4bf" stroke-width="1.5"/></svg>`;
+const JS_ICON = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" width="16" height="16"><rect width="16" height="16" rx="3" fill="#f59e0b"/><text x="2" y="12" font-family="monospace" font-size="9" font-weight="bold" fill="#1e1e2e">JS</text></svg>`;
+const WATCH_ICON = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" width="16" height="16"><rect width="16" height="16" rx="3" fill="#1e1e2e"/><path d="M3 10V7l5-4 5 4v3" fill="none" stroke="#a78bfa" stroke-width="1.5"/><path d="M5 10h6v4H5z" fill="none" stroke="#a78bfa" stroke-width="1.5"/></svg>`;
+const HTTP_ICON = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" width="16" height="16"><rect width="16" height="16" rx="3" fill="#1e1e2e"/><circle cx="8" cy="8" r="5" fill="none" stroke="#2dd4bf" stroke-width="1.5"/><path d="M3 8h10M8 3c-2 2-2 8 0 10M8 3c2 2 2 8 0 10" stroke="#2dd4bf" stroke-width="1" fill="none"/></svg>`;
+const EMAIL_ICON = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" width="16" height="16"><rect width="16" height="16" rx="3" fill="#1e1e2e"/><rect x="2" y="4" width="12" height="8" rx="1" fill="none" stroke="#f59e0b" stroke-width="1.5"/><path d="M2 5l6 4 6-4" stroke="#f59e0b" stroke-width="1.5" fill="none"/></svg>`;
+export const BUILTIN_WORKER_TEMPLATES = [
+    // ── CLI Worker ────────────────────────────────────────────────────────────
+    {
+        id: "io.bpmnkit.cli",
+        name: "CLI Command",
+        version: 1,
+        description: "Run any shell command. Use {{varName}} to interpolate process variables, {{secrets.NAME}} for secrets.",
+        appliesTo: ["bpmn:ServiceTask"],
+        icon: { contents: CLI_ICON },
+        groups: [
+            { id: "command", label: "Command" },
+            { id: "output", label: "Output" },
+        ],
+        properties: [
+            {
+                id: "taskType",
+                type: "Hidden",
+                value: "io.bpmnkit:cli:1",
+                binding: { type: "zeebe:taskDefinition", property: "type" },
+            },
+            {
+                id: "command",
+                label: "Command",
+                description: "Shell command to run. Use {{varName}} for variables, {{secrets.NAME}} for secrets.",
+                type: "Text",
+                group: "command",
+                constraints: { notEmpty: true },
+                binding: { type: "zeebe:taskHeader", key: "command" },
+            },
+            {
+                id: "cwd",
+                label: "Working directory",
+                description: "Directory to run the command in. Default: home directory (~).",
+                type: "String",
+                optional: true,
+                group: "command",
+                binding: { type: "zeebe:taskHeader", key: "cwd" },
+            },
+            {
+                id: "timeout",
+                label: "Timeout (seconds)",
+                description: "Maximum time to wait before killing the process.",
+                type: "Number",
+                value: 60,
+                group: "command",
+                binding: { type: "zeebe:taskHeader", key: "timeout" },
+            },
+            {
+                id: "ignoreExitCode",
+                label: "Ignore non-zero exit code",
+                description: "Complete the job even when the command exits with a non-zero code.",
+                type: "Boolean",
+                value: false,
+                group: "command",
+                binding: { type: "zeebe:taskHeader", key: "ignoreExitCode" },
+            },
+            {
+                id: "resultVariable",
+                label: "Result variable",
+                description: "Process variable to store { stdout, stderr, exitCode }.",
+                type: "String",
+                value: "cliResult",
+                group: "output",
+                binding: { type: "zeebe:taskHeader", key: "resultVariable" },
+            },
+        ],
+    },
+    // ── LLM Worker ───────────────────────────────────────────────────────────
+    {
+        id: "io.bpmnkit.llm",
+        name: "LLM Prompt",
+        version: 1,
+        description: "Call an AI model (Claude, Copilot, or Gemini) with a prompt.",
+        appliesTo: ["bpmn:ServiceTask"],
+        icon: { contents: LLM_ICON },
+        groups: [
+            { id: "prompt", label: "Prompt" },
+            { id: "model", label: "Model" },
+            { id: "output", label: "Output" },
+        ],
+        properties: [
+            {
+                id: "taskType",
+                type: "Hidden",
+                value: "io.bpmnkit:llm:1",
+                binding: { type: "zeebe:taskDefinition", property: "type" },
+            },
+            {
+                id: "prompt",
+                label: "Prompt",
+                description: "The message to send. Use {{varName}} to include process variable values, or = for a FEEL expression.",
+                type: "Text",
+                feel: "optional",
+                group: "prompt",
+                constraints: { notEmpty: true },
+                binding: { type: "zeebe:input", name: "prompt" },
+            },
+            {
+                id: "system",
+                label: "System prompt",
+                description: "Optional instruction given to the model before the user message.",
+                type: "Text",
+                optional: true,
+                group: "prompt",
+                binding: { type: "zeebe:taskHeader", key: "system" },
+            },
+            {
+                id: "model",
+                label: "Model",
+                description: "Which LLM to use. Auto-detects the first available adapter if not set.",
+                type: "Dropdown",
+                optional: true,
+                group: "model",
+                choices: [
+                    { name: "Auto-detect", value: "" },
+                    { name: "Claude", value: "claude" },
+                    { name: "GitHub Copilot", value: "copilot" },
+                    { name: "Gemini", value: "gemini" },
+                ],
+                binding: { type: "zeebe:taskHeader", key: "model" },
+            },
+            {
+                id: "resultVariable",
+                label: "Result variable",
+                description: "Process variable to store the model's response string.",
+                type: "String",
+                value: "response",
+                group: "output",
+                binding: { type: "zeebe:taskHeader", key: "resultVariable" },
+            },
+        ],
+    },
+    // ── FS Read ───────────────────────────────────────────────────────────────
+    {
+        id: "io.bpmnkit.fs.read",
+        name: "Read File",
+        version: 1,
+        description: "Read a file from the local filesystem into a process variable.",
+        appliesTo: ["bpmn:ServiceTask"],
+        icon: { contents: FS_ICON },
+        groups: [
+            { id: "file", label: "File" },
+            { id: "output", label: "Output" },
+        ],
+        properties: [
+            {
+                id: "taskType",
+                type: "Hidden",
+                value: "io.bpmnkit:fs:read:1",
+                binding: { type: "zeebe:taskDefinition", property: "type" },
+            },
+            {
+                id: "path",
+                label: "File path",
+                description: "Absolute path or ~/relative path. Use = for a FEEL expression.",
+                type: "String",
+                feel: "optional",
+                group: "file",
+                constraints: { notEmpty: true },
+                binding: { type: "zeebe:input", name: "path" },
+            },
+            {
+                id: "resultVariable",
+                label: "Result variable",
+                description: "Process variable to store the file content (string).",
+                type: "String",
+                value: "fileContent",
+                group: "output",
+                binding: { type: "zeebe:taskHeader", key: "resultVariable" },
+            },
+        ],
+    },
+    // ── FS Write ──────────────────────────────────────────────────────────────
+    {
+        id: "io.bpmnkit.fs.write",
+        name: "Write File",
+        version: 1,
+        description: "Write a process variable to a file. Parent directories are created automatically.",
+        appliesTo: ["bpmn:ServiceTask"],
+        icon: { contents: FS_ICON },
+        groups: [{ id: "file", label: "File" }],
+        properties: [
+            {
+                id: "taskType",
+                type: "Hidden",
+                value: "io.bpmnkit:fs:write:1",
+                binding: { type: "zeebe:taskDefinition", property: "type" },
+            },
+            {
+                id: "path",
+                label: "File path",
+                description: "Absolute path or ~/relative path to write. Use = for a FEEL expression.",
+                type: "String",
+                feel: "optional",
+                group: "file",
+                constraints: { notEmpty: true },
+                binding: { type: "zeebe:input", name: "path" },
+            },
+            {
+                id: "content",
+                label: "Content",
+                description: "The string content to write. Use = for a FEEL expression.",
+                type: "String",
+                feel: "optional",
+                group: "file",
+                constraints: { notEmpty: true },
+                binding: { type: "zeebe:input", name: "content" },
+            },
+        ],
+    },
+    // ── FS Append ─────────────────────────────────────────────────────────────
+    {
+        id: "io.bpmnkit.fs.append",
+        name: "Append to File",
+        version: 1,
+        description: "Append content to a file. Creates the file if it does not exist.",
+        appliesTo: ["bpmn:ServiceTask"],
+        icon: { contents: FS_ICON },
+        groups: [{ id: "file", label: "File" }],
+        properties: [
+            {
+                id: "taskType",
+                type: "Hidden",
+                value: "io.bpmnkit:fs:append:1",
+                binding: { type: "zeebe:taskDefinition", property: "type" },
+            },
+            {
+                id: "path",
+                label: "File path",
+                description: "Absolute path or ~/relative path to append to.",
+                type: "String",
+                feel: "optional",
+                group: "file",
+                constraints: { notEmpty: true },
+                binding: { type: "zeebe:input", name: "path" },
+            },
+            {
+                id: "content",
+                label: "Content",
+                description: "The string content to append.",
+                type: "String",
+                feel: "optional",
+                group: "file",
+                constraints: { notEmpty: true },
+                binding: { type: "zeebe:input", name: "content" },
+            },
+        ],
+    },
+    // ── FS List ───────────────────────────────────────────────────────────────
+    {
+        id: "io.bpmnkit.fs.list",
+        name: "List Directory",
+        version: 1,
+        description: "List files in a directory. Returns an array of filenames.",
+        appliesTo: ["bpmn:ServiceTask"],
+        icon: { contents: FS_ICON },
+        groups: [
+            { id: "directory", label: "Directory" },
+            { id: "output", label: "Output" },
+        ],
+        properties: [
+            {
+                id: "taskType",
+                type: "Hidden",
+                value: "io.bpmnkit:fs:list:1",
+                binding: { type: "zeebe:taskDefinition", property: "type" },
+            },
+            {
+                id: "path",
+                label: "Directory path",
+                description: "Absolute path or ~/relative path to list.",
+                type: "String",
+                feel: "optional",
+                group: "directory",
+                constraints: { notEmpty: true },
+                binding: { type: "zeebe:input", name: "path" },
+            },
+            {
+                id: "resultVariable",
+                label: "Result variable",
+                description: "Process variable to store the file list (string array).",
+                type: "String",
+                value: "files",
+                group: "output",
+                binding: { type: "zeebe:taskHeader", key: "resultVariable" },
+            },
+        ],
+    },
+    // ── JS Eval ───────────────────────────────────────────────────────────────
+    {
+        id: "io.bpmnkit.js",
+        name: "JavaScript Expression",
+        version: 1,
+        description: "Evaluate a JavaScript expression. All process variables are available via the `variables` object.",
+        appliesTo: ["bpmn:ServiceTask"],
+        icon: { contents: JS_ICON },
+        groups: [
+            { id: "expression", label: "Expression" },
+            { id: "output", label: "Output" },
+        ],
+        properties: [
+            {
+                id: "taskType",
+                type: "Hidden",
+                value: "io.bpmnkit:js:1",
+                binding: { type: "zeebe:taskDefinition", property: "type" },
+            },
+            {
+                id: "expression",
+                label: "Expression",
+                description: "JavaScript expression returning a value. Use `variables.x` to read process variables.",
+                type: "Text",
+                group: "expression",
+                constraints: { notEmpty: true },
+                binding: { type: "zeebe:taskHeader", key: "expression" },
+            },
+            {
+                id: "resultVariable",
+                label: "Result variable",
+                description: "Process variable to store the expression result.",
+                type: "String",
+                value: "result",
+                group: "output",
+                binding: { type: "zeebe:taskHeader", key: "resultVariable" },
+            },
+        ],
+    },
+    // ── File Watch Trigger ────────────────────────────────────────────────────
+    {
+        id: "io.bpmnkit.trigger.file-watch",
+        name: "File Watch Trigger",
+        version: 1,
+        description: "Watch a directory and start a process instance when files are created or changed.",
+        appliesTo: ["bpmn:ServiceTask"],
+        icon: { contents: WATCH_ICON },
+        groups: [
+            { id: "watch", label: "Watch" },
+            { id: "filter", label: "Filter" },
+        ],
+        properties: [
+            {
+                id: "taskType",
+                type: "Hidden",
+                value: "io.bpmnkit:trigger:file-watch:1",
+                binding: { type: "zeebe:taskDefinition", property: "type" },
+            },
+            {
+                id: "watchPath",
+                label: "Watch path",
+                description: "Directory to watch for file changes. Absolute or ~/relative path.",
+                type: "String",
+                group: "watch",
+                constraints: { notEmpty: true },
+                binding: { type: "zeebe:taskHeader", key: "watchPath" },
+            },
+            {
+                id: "events",
+                label: "Events",
+                description: "Which file system events trigger the process.",
+                type: "Dropdown",
+                value: "all",
+                group: "watch",
+                choices: [
+                    { name: "Add or change (all)", value: "all" },
+                    { name: "New files only (add)", value: "add" },
+                    { name: "Modified files only (change)", value: "change" },
+                ],
+                binding: { type: "zeebe:taskHeader", key: "events" },
+            },
+            {
+                id: "glob",
+                label: "File filter (glob)",
+                description: "Only trigger for filenames matching this pattern (e.g. *.md, report_*.csv).",
+                type: "String",
+                optional: true,
+                group: "filter",
+                binding: { type: "zeebe:taskHeader", key: "glob" },
+            },
+        ],
+    },
+    // ── HTTP Scraper ──────────────────────────────────────────────────────────
+    {
+        id: "io.bpmnkit.http.scrape",
+        name: "HTTP Scraper",
+        version: 1,
+        description: "Fetch a URL and extract its text content and title. Returns { html, text, title, statusCode }.",
+        appliesTo: ["bpmn:ServiceTask"],
+        icon: { contents: HTTP_ICON },
+        groups: [
+            { id: "request", label: "Request" },
+            { id: "output", label: "Output" },
+        ],
+        properties: [
+            {
+                id: "taskType",
+                type: "Hidden",
+                value: "io.bpmnkit:http:scrape:1",
+                binding: { type: "zeebe:taskDefinition", property: "type" },
+            },
+            {
+                id: "url",
+                label: "URL",
+                description: "URL to fetch. Use {{varName}} for variables or {{secrets.NAME}} for secrets.",
+                type: "String",
+                feel: "optional",
+                group: "request",
+                constraints: { notEmpty: true },
+                binding: { type: "zeebe:taskHeader", key: "url" },
+            },
+            {
+                id: "timeout",
+                label: "Timeout (seconds)",
+                type: "Number",
+                value: 30,
+                group: "request",
+                binding: { type: "zeebe:taskHeader", key: "timeout" },
+            },
+            {
+                id: "resultVariable",
+                label: "Result variable",
+                description: "Process variable to store { url, html, text, title, statusCode }.",
+                type: "String",
+                value: "scrapeResult",
+                group: "output",
+                binding: { type: "zeebe:taskHeader", key: "resultVariable" },
+            },
+        ],
+    },
+    // ── Email Fetch ───────────────────────────────────────────────────────────
+    {
+        id: "io.bpmnkit.email.fetch",
+        name: "Fetch Emails",
+        version: 1,
+        description: "Fetch emails from an IMAP mailbox. Returns an array of { uid, subject, from, date, body }.",
+        appliesTo: ["bpmn:ServiceTask"],
+        icon: { contents: EMAIL_ICON },
+        groups: [
+            { id: "connection", label: "Connection" },
+            { id: "filter", label: "Filter" },
+            { id: "output", label: "Output" },
+        ],
+        properties: [
+            {
+                id: "taskType",
+                type: "Hidden",
+                value: "io.bpmnkit:email:fetch:1",
+                binding: { type: "zeebe:taskDefinition", property: "type" },
+            },
+            {
+                id: "imapHost",
+                label: "IMAP host",
+                type: "String",
+                group: "connection",
+                constraints: { notEmpty: true },
+                binding: { type: "zeebe:taskHeader", key: "imapHost" },
+            },
+            {
+                id: "imapPort",
+                label: "IMAP port",
+                type: "Number",
+                value: 993,
+                group: "connection",
+                binding: { type: "zeebe:taskHeader", key: "imapPort" },
+            },
+            {
+                id: "imapUser",
+                label: "Username",
+                type: "String",
+                group: "connection",
+                constraints: { notEmpty: true },
+                binding: { type: "zeebe:taskHeader", key: "imapUser" },
+            },
+            {
+                id: "imapPassword",
+                label: "Password",
+                type: "String",
+                group: "connection",
+                constraints: { notEmpty: true },
+                binding: { type: "zeebe:taskHeader", key: "imapPassword" },
+            },
+            {
+                id: "folder",
+                label: "Folder",
+                type: "String",
+                value: "INBOX",
+                group: "filter",
+                binding: { type: "zeebe:taskHeader", key: "folder" },
+            },
+            {
+                id: "limit",
+                label: "Max messages",
+                type: "Number",
+                value: 10,
+                group: "filter",
+                binding: { type: "zeebe:taskHeader", key: "limit" },
+            },
+            {
+                id: "unreadOnly",
+                label: "Unread only",
+                type: "Boolean",
+                value: true,
+                group: "filter",
+                binding: { type: "zeebe:taskHeader", key: "unreadOnly" },
+            },
+            {
+                id: "resultVariable",
+                label: "Result variable",
+                type: "String",
+                value: "emails",
+                group: "output",
+                binding: { type: "zeebe:taskHeader", key: "resultVariable" },
+            },
+        ],
+    },
+    // ── Email Send ────────────────────────────────────────────────────────────
+    {
+        id: "io.bpmnkit.email.send",
+        name: "Send Email",
+        version: 1,
+        description: "Send an email via SMTP. Reads to/subject/body from process variables.",
+        appliesTo: ["bpmn:ServiceTask"],
+        icon: { contents: EMAIL_ICON },
+        groups: [
+            { id: "connection", label: "Connection" },
+            { id: "message", label: "Message" },
+        ],
+        properties: [
+            {
+                id: "taskType",
+                type: "Hidden",
+                value: "io.bpmnkit:email:send:1",
+                binding: { type: "zeebe:taskDefinition", property: "type" },
+            },
+            {
+                id: "smtpHost",
+                label: "SMTP host",
+                type: "String",
+                group: "connection",
+                constraints: { notEmpty: true },
+                binding: { type: "zeebe:taskHeader", key: "smtpHost" },
+            },
+            {
+                id: "smtpPort",
+                label: "SMTP port",
+                type: "Number",
+                value: 587,
+                group: "connection",
+                binding: { type: "zeebe:taskHeader", key: "smtpPort" },
+            },
+            {
+                id: "smtpUser",
+                label: "Username",
+                type: "String",
+                group: "connection",
+                constraints: { notEmpty: true },
+                binding: { type: "zeebe:taskHeader", key: "smtpUser" },
+            },
+            {
+                id: "smtpPassword",
+                label: "Password",
+                type: "String",
+                group: "connection",
+                constraints: { notEmpty: true },
+                binding: { type: "zeebe:taskHeader", key: "smtpPassword" },
+            },
+            {
+                id: "from",
+                label: "From address",
+                description: "Sender address. Defaults to SMTP username.",
+                type: "String",
+                optional: true,
+                group: "message",
+                binding: { type: "zeebe:taskHeader", key: "from" },
+            },
+        ],
+    },
+];
+//# sourceMappingURL=builtin-templates.js.map