{"_id":"@bpmn-sdk/operate","_rev":"5-db68c558d64c0ffd4c271a7e367b7e04","name":"@bpmn-sdk/operate","dist-tags":{"latest":"0.0.5"},"versions":{"0.0.1":{"name":"@bpmn-sdk/operate","version":"0.0.1","license":"MIT","_id":"@bpmn-sdk/operate@0.0.1","maintainers":[{"name":"urbanisierung","email":"adam.urban@gmail.com"}],"homepage":"https://github.com/bpmn-sdk/monorepo#readme","bugs":{"url":"https://github.com/bpmn-sdk/monorepo/issues"},"dist":{"shasum":"f788e4d232edc80cfbea7f6fd89e1b21a0eac91e","tarball":"https://registry.npmjs.org/@bpmn-sdk/operate/-/operate-0.0.1.tgz","fileCount":53,"integrity":"sha512-h2pTuHgCMQL271qKZ/qajVM8hNfh+Te0aTwUoGbUhkyo1ItqvFjyLC7Tc9AnsNbR+2jnh30tpfrNfAZWPbBolQ==","signatures":[{"sig":"MEQCIBVScSKPENRTIudY3+W3aXvmrxiOzTc6tfPBXn2608oxAiAEbEDMV83ing+C6TL+O+Xe7tsNrQT0bD6e3x9LeKK3EQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":89399},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"0f1e84e3b1dd1d97177473249f1e887665ce7272","scripts":{"build":"tsc","check":"biome check .","typecheck":"tsc --noEmit"},"_npmUser":{"name":"urbanisierung","email":"adam.urban@gmail.com"},"repository":{"url":"git+https://github.com/bpmn-sdk/monorepo.git","type":"git"},"_npmVersion":"11.6.1","description":"BPMN monitoring and operations frontend package","directories":{},"_nodeVersion":"24.11.0","dependencies":{"@bpmn-sdk/api":"workspace:*","@bpmn-sdk/core":"workspace:*","@bpmn-sdk/canvas":"workspace:*","@bpmn-sdk/plugins":"workspace:*"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/operate_0.0.1_1773172914709_0.24320383617702457","host":"s3://npm-registry-packages-npm-production"}},"0.0.2":{"name":"@bpmn-sdk/operate","version":"0.0.2","keywords":["bpmn","camunda","operate","monitoring","operations","workflow","process-instances","incidents","typescript"],"license":"MIT","_id":"@bpmn-sdk/operate@0.0.2","maintainers":[{"name":"urbanisierung","email":"adam.urban@gmail.com"}],"homepage":"https://github.com/bpmn-sdk/monorepo#readme","bugs":{"url":"https://github.com/bpmn-sdk/monorepo/issues"},"dist":{"shasum":"1f576bf84450284e25f93d7462117af257c7be08","tarball":"https://registry.npmjs.org/@bpmn-sdk/operate/-/operate-0.0.2.tgz","fileCount":55,"integrity":"sha512-YFbDS8WqpfLQDLdS797a6HrkBP3IflkZeBENAW78zX+B9aW7ntfDJLTdrHwMpv3JQ3pe0vdH8/s1Ol2O6IQ8tA==","signatures":[{"sig":"MEUCIQDKt47iE+384zeeNDwDHog1TTLao3ma/hosk0YOiRtOsQIgYpCZA5j4AgJmRmZB06Ly3np3/r224Oai6tBMHBb680s=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bpmn-sdk%2foperate@0.0.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":96751},"main":"./dist/index.js","type":"module","_from":"file:bpmn-sdk-operate-0.0.2.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"build":"tsc","check":"biome check .","typecheck":"tsc --noEmit"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:9a6ee1e1-8db2-4776-a1fb-28025e65a6d7"}},"_resolved":"/tmp/00f3d642df681354e3e7d808a502b18d/bpmn-sdk-operate-0.0.2.tgz","_integrity":"sha512-YFbDS8WqpfLQDLdS797a6HrkBP3IflkZeBENAW78zX+B9aW7ntfDJLTdrHwMpv3JQ3pe0vdH8/s1Ol2O6IQ8tA==","repository":{"url":"git+https://github.com/bpmn-sdk/monorepo.git","type":"git"},"_npmVersion":"11.9.0","description":"Monitoring and operations frontend for Camunda 8 clusters — real-time SSE, zero dependencies","directories":{},"_nodeVersion":"24.14.0","dependencies":{"@bpmn-sdk/api":"0.0.5","@bpmn-sdk/core":"0.0.5","@bpmn-sdk/canvas":"0.0.5","@bpmn-sdk/plugins":"0.0.5"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/operate_0.0.2_1773173858904_0.8886082534357531","host":"s3://npm-registry-packages-npm-production"}},"0.0.3":{"name":"@bpmn-sdk/operate","version":"0.0.3","keywords":["bpmn","camunda","operate","monitoring","operations","workflow","process-instances","incidents","typescript"],"license":"MIT","_id":"@bpmn-sdk/operate@0.0.3","maintainers":[{"name":"urbanisierung","email":"adam.urban@gmail.com"}],"homepage":"https://github.com/bpmn-sdk/monorepo#readme","bugs":{"url":"https://github.com/bpmn-sdk/monorepo/issues"},"dist":{"shasum":"19f5f940459dba0d5cff1a431a52ef5dd0ef0471","tarball":"https://registry.npmjs.org/@bpmn-sdk/operate/-/operate-0.0.3.tgz","fileCount":59,"integrity":"sha512-doVkQJNllLMNB0NdlYvdS2vbyEsA8IE4HMJC1QfVzTnvPaXwDsLPholPssY82RbKpU2kDlD5JsOoJwrMnircHg==","signatures":[{"sig":"MEYCIQDgJ9oNjoKN5tltc10fYcjCzWzhlKZ9T2nP0INm5CLLHAIhANJqIc+/xOxx7o26dc88t0wvG1/Gl7hcTO4P1HOKz9mv","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bpmn-sdk%2foperate@0.0.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":113950},"main":"./dist/index.js","type":"module","_from":"file:bpmn-sdk-operate-0.0.3.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"build":"tsc","check":"biome check .","typecheck":"tsc --noEmit"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:9a6ee1e1-8db2-4776-a1fb-28025e65a6d7"}},"_resolved":"/tmp/2357b9edee833677548cbace0f503aae/bpmn-sdk-operate-0.0.3.tgz","_integrity":"sha512-doVkQJNllLMNB0NdlYvdS2vbyEsA8IE4HMJC1QfVzTnvPaXwDsLPholPssY82RbKpU2kDlD5JsOoJwrMnircHg==","repository":{"url":"git+https://github.com/bpmn-sdk/monorepo.git","type":"git"},"_npmVersion":"11.9.0","description":"Monitoring and operations frontend for Camunda 8 clusters — real-time SSE, zero dependencies","directories":{},"_nodeVersion":"24.14.0","dependencies":{"@bpmn-sdk/ui":"0.0.2","@bpmn-sdk/api":"0.0.6","@bpmn-sdk/core":"0.0.6","@bpmn-sdk/canvas":"0.0.6","@bpmn-sdk/plugins":"0.0.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/operate_0.0.3_1773258777640_0.0408002688327318","host":"s3://npm-registry-packages-npm-production"}},"0.0.4":{"name":"@bpmn-sdk/operate","version":"0.0.4","keywords":["bpmn","camunda","operate","monitoring","operations","workflow","process-instances","incidents","typescript"],"license":"MIT","_id":"@bpmn-sdk/operate@0.0.4","maintainers":[{"name":"urbanisierung","email":"adam.urban@gmail.com"}],"homepage":"https://github.com/bpmn-sdk/monorepo#readme","bugs":{"url":"https://github.com/bpmn-sdk/monorepo/issues"},"dist":{"shasum":"7e065dbfc16d1816f69a53c39823421bf1a031ba","tarball":"https://registry.npmjs.org/@bpmn-sdk/operate/-/operate-0.0.4.tgz","fileCount":71,"integrity":"sha512-r9R9DhlgluTUohYziIicS6A5nCJ39VxEakFJR61mLtb093w02Y4JmBb4KLboGalYf2Vn0yuFR9vXqn9TbcqMLw==","signatures":[{"sig":"MEYCIQDWG9Cqt25g98TyYFiSjcX0S/A3ypSf4ZibgLtnL0NT1QIhAPNzv4idoIfbTqYWq/EEmvDqPzHrbj3ghhHWLkXpqvdj","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bpmn-sdk%2foperate@0.0.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":212400},"main":"./dist/index.js","type":"module","_from":"file:bpmn-sdk-operate-0.0.4.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"build":"tsc","check":"biome check .","typecheck":"tsc --noEmit"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:9a6ee1e1-8db2-4776-a1fb-28025e65a6d7"}},"_resolved":"/tmp/9e3c2ab7efc2348586c0d43449f0bb0b/bpmn-sdk-operate-0.0.4.tgz","_integrity":"sha512-r9R9DhlgluTUohYziIicS6A5nCJ39VxEakFJR61mLtb093w02Y4JmBb4KLboGalYf2Vn0yuFR9vXqn9TbcqMLw==","repository":{"url":"git+https://github.com/bpmn-sdk/monorepo.git","type":"git"},"_npmVersion":"11.9.0","description":"Monitoring and operations frontend for Camunda 8 clusters — real-time SSE, zero dependencies","directories":{},"_nodeVersion":"24.14.0","dependencies":{"@bpmn-sdk/ui":"0.0.3","@bpmn-sdk/api":"0.0.7","@bpmn-sdk/core":"0.0.7","@bpmn-sdk/canvas":"0.0.7","@bpmn-sdk/plugins":"0.0.7"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/operate_0.0.4_1773341678591_0.19061941396314208","host":"s3://npm-registry-packages-npm-production"}},"0.0.5":{"name":"@bpmn-sdk/operate","version":"0.0.5","description":"Monitoring and operations frontend for Camunda 8 clusters — real-time SSE, zero dependencies","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"dependencies":{"@bpmn-sdk/api":"0.0.8","@bpmn-sdk/core":"0.0.8","@bpmn-sdk/canvas":"0.0.8","@bpmn-sdk/plugins":"0.0.8","@bpmn-sdk/ui":"0.0.4"},"keywords":["bpmn","camunda","operate","monitoring","operations","workflow","process-instances","incidents","typescript"],"license":"MIT","publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/bpmn-sdk/monorepo.git"},"scripts":{"build":"tsc","typecheck":"tsc --noEmit","check":"biome check ."},"_id":"@bpmn-sdk/operate@0.0.5","bugs":{"url":"https://github.com/bpmn-sdk/monorepo/issues"},"homepage":"https://github.com/bpmn-sdk/monorepo#readme","_integrity":"sha512-9DtTM0Pj6uPA+neRoEL6FvXOq3sKYDlxwJuZ4qYlF1Hn9Sj0k0VqQT9ps7FPyXeOgIylbFrUfDsLl3WBgnKWLA==","_resolved":"/tmp/3b082ebcaf8517a01b1d8dcc05a3e649/bpmn-sdk-operate-0.0.5.tgz","_from":"file:bpmn-sdk-operate-0.0.5.tgz","_nodeVersion":"24.14.0","_npmVersion":"11.9.0","dist":{"integrity":"sha512-9DtTM0Pj6uPA+neRoEL6FvXOq3sKYDlxwJuZ4qYlF1Hn9Sj0k0VqQT9ps7FPyXeOgIylbFrUfDsLl3WBgnKWLA==","shasum":"680b0e9f327625852d9ebc5f9e48eeeb35c1b46f","tarball":"https://registry.npmjs.org/@bpmn-sdk/operate/-/operate-0.0.5.tgz","fileCount":73,"unpackedSize":243982,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bpmn-sdk%2foperate@0.0.5","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIF8FIrJbqR4dHliSJ5VUa66BtilJKtzgNm8RbWAiD9t2AiEAgY7iKCXSTW2lHuXBg7qQvGjANQ13lnC1o2X2HsYgNOg="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:9a6ee1e1-8db2-4776-a1fb-28025e65a6d7"}},"directories":{},"maintainers":[{"name":"urbanisierung","email":"adam.urban@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/operate_0.0.5_1773428385947_0.5328297571410556"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-10T20:01:54.517Z","modified":"2026-03-13T18:59:46.382Z","0.0.1":"2026-03-10T20:01:54.862Z","0.0.2":"2026-03-10T20:17:39.070Z","0.0.3":"2026-03-11T19:52:57.797Z","0.0.4":"2026-03-12T18:54:38.768Z","0.0.5":"2026-03-13T18:59:46.101Z"},"bugs":{"url":"https://github.com/bpmn-sdk/monorepo/issues"},"license":"MIT","homepage":"https://github.com/bpmn-sdk/monorepo#readme","keywords":["bpmn","camunda","operate","monitoring","operations","workflow","process-instances","incidents","typescript"],"repository":{"type":"git","url":"git+https://github.com/bpmn-sdk/monorepo.git"},"description":"Monitoring and operations frontend for Camunda 8 clusters — real-time SSE, zero dependencies","maintainers":[{"name":"urbanisierung","email":"adam.urban@gmail.com"}],"readme":"<div align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/bpmn-sdk/monorepo/main/doc/logos/logo-2-gateway.svg\" width=\"72\" height=\"72\" alt=\"BPMN SDK logo\">\n  <h1>@bpmn-sdk/operate</h1>\n  <p>Monitoring and operations frontend for Camunda 8 clusters — real-time SSE, zero dependencies</p>\n\n  [![npm](https://img.shields.io/npm/v/@bpmn-sdk/operate?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmn-sdk/operate)\n  [![license](https://img.shields.io/npm/l/@bpmn-sdk/operate?style=flat-square)](https://github.com/bpmn-sdk/monorepo/blob/main/LICENSE)\n  [![typescript](https://img.shields.io/badge/TypeScript-strict-6244d7?style=flat-square&logo=typescript&logoColor=white)](https://github.com/bpmn-sdk/monorepo)\n\n  [Documentation](https://bpmn-sdk-docs.pages.dev) · [GitHub](https://github.com/bpmn-sdk/monorepo) · [Changelog](https://github.com/bpmn-sdk/monorepo/blob/main/packages/operate/CHANGELOG.md)\n</div>\n\n---\n\n## Overview\n\n`@bpmn-sdk/operate` is a zero-dependency monitoring and operations frontend for Camunda 8. Mount it into any HTML element to get a full process monitoring UI — live dashboard, instance browser, incident management, job queue, and user tasks.\n\nIt pairs with the `@bpmn-sdk/proxy` local server, which polls the Camunda REST API server-side and pushes updates via **Server-Sent Events**. The frontend stays clean with no polling timers.\n\nA **mock mode** (`mock: true`) ships fixture data without any running proxy or cluster — useful for demos and local development.\n\n## Features\n\n- **Dashboard** — real-time stats: active instances, open incidents, active jobs, pending tasks\n- **Process Definitions** — deployed process list with name, version, and tenant\n- **Process Instances** — paginated list with state filter (Active / Completed / Terminated)\n- **Instance Detail** — BPMN canvas via `@bpmn-sdk/canvas` with live token-highlight overlay; active elements glow amber, visited elements show green tint\n- **Incidents** — error type, message, process, and resolution state\n- **Jobs** — job type, worker, retries, state, error message\n- **User Tasks** — name, assignee, state, due date, priority\n- **Profile switcher** — header dropdown populated from the proxy `/profiles` endpoint; switches reconnect all SSE streams\n- **Mock/demo mode** — fully self-contained fixture data, no cluster required\n- **SSE architecture** — proxy polls server-side; frontend opens one `EventSource` per view, gets pushed updates\n- **Hash router** — `#/`, `#/instances`, `#/instances/:key`, `#/definitions`, etc.\n- **Themeable** — light / dark / auto via `--bpmn-*` CSS custom properties from `@bpmn-sdk/ui`; theme choice persisted to `localStorage`\n\n## Installation\n\n```sh\nnpm install @bpmn-sdk/operate @bpmn-sdk/proxy\n```\n\n## Quick Start\n\n### Demo mode (no cluster needed)\n\n```typescript\nimport { createOperate } from \"@bpmn-sdk/operate\"\n\ncreateOperate({\n  container: document.getElementById(\"app\")!,\n  mock: true,\n  theme: \"auto\",\n})\n```\n\n### Connected to a real Camunda cluster via proxy\n\n```typescript\nimport { createOperate } from \"@bpmn-sdk/operate\"\n\ncreateOperate({\n  container: document.getElementById(\"app\")!,\n  proxyUrl: \"http://localhost:3033\",   // default\n  profile: \"production\",               // optional, uses active profile if omitted\n  pollInterval: 15_000,                // ms between server-side polls (default: 30 000)\n  theme: \"dark\",\n})\n```\n\nThe proxy must be running (`pnpm proxy`) and have at least one profile configured via the `casen` CLI.\n\n## How it works\n\n```\nBrowser  ──── EventSource ────▶  @bpmn-sdk/proxy  ──── CamundaClient ────▶  Camunda cluster\n         ◀─── SSE events ──────  (polls on interval, pushes results)\n```\n\n1. Each view opens an SSE connection to `/operate/stream?topic=<view>&interval=<ms>`.\n2. The proxy creates a `CamundaClient` using the configured profile's auth credentials.\n3. On each polling tick, the proxy fetches the relevant Camunda data and emits a `{ type: \"data\", payload }` SSE event.\n4. The store updates and the view re-renders.\n\n## API Reference\n\n### `createOperate(options)`\n\n```typescript\ninterface OperateOptions {\n  container: HTMLElement\n  proxyUrl?: string        // default: \"http://localhost:3033\"\n  profile?: string         // profile name; uses active profile if omitted\n  theme?: \"light\" | \"dark\" | \"auto\"  // default: \"auto\"\n  pollInterval?: number    // ms between polls; default: 30 000\n  mock?: boolean           // use built-in fixture data; default: false\n}\n```\n\nReturns an `OperateApi`:\n\n```typescript\ninterface OperateApi {\n  el: HTMLElement\n  setProfile(name: string | null): void\n  setTheme(theme: \"light\" | \"dark\" | \"auto\"): void\n  navigate(path: string): void  // e.g. \"/instances/123456789\"\n  destroy(): void\n}\n```\n\n---\n\n## Related Packages\n\n| Package | Description |\n|---------|-------------|\n| [`@bpmn-sdk/core`](https://www.npmjs.com/package/@bpmn-sdk/core) | BPMN/DMN/Form parser, builder, layout engine |\n| [`@bpmn-sdk/canvas`](https://www.npmjs.com/package/@bpmn-sdk/canvas) | Zero-dependency SVG BPMN viewer |\n| [`@bpmn-sdk/editor`](https://www.npmjs.com/package/@bpmn-sdk/editor) | Full-featured interactive BPMN editor |\n| [`@bpmn-sdk/engine`](https://www.npmjs.com/package/@bpmn-sdk/engine) | Lightweight BPMN process execution engine |\n| [`@bpmn-sdk/feel`](https://www.npmjs.com/package/@bpmn-sdk/feel) | FEEL expression language parser & evaluator |\n| [`@bpmn-sdk/plugins`](https://www.npmjs.com/package/@bpmn-sdk/plugins) | 22 composable canvas plugins |\n| [`@bpmn-sdk/api`](https://www.npmjs.com/package/@bpmn-sdk/api) | Camunda 8 REST API TypeScript client |\n| [`@bpmn-sdk/ascii`](https://www.npmjs.com/package/@bpmn-sdk/ascii) | Render BPMN diagrams as Unicode ASCII art |\n| [`@bpmn-sdk/profiles`](https://www.npmjs.com/package/@bpmn-sdk/profiles) | Shared auth, profile storage, and client factories for CLI & proxy |\n\n## License\n\n[MIT](https://github.com/bpmn-sdk/monorepo/blob/main/LICENSE) © bpmn-sdk\n","readmeFilename":"README.md"}