@0dep/bpmn-extensions 0.1.0 → 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,66 @@
+# Changelog
+
+## Unreleased
+
+## v1.0.0 - 2026-09-20
+
+### Breaking
+
+- ESM only: the CommonJS rollup bundle (`dist/`) is gone. `require('@0dep/bpmn-extensions')` still works through Node's `require(esm)`, so the supported Node range is now `>=22.12` (was `>=22`; 22.0–22.11 CommonJS consumers would need `--experimental-require-module`). `feelin` is no longer bundled — `import` and `require` consumers share the installed copy.
+- `feelin` bumped to v8, which moved FEEL temporal values from luxon to [Temporal](https://tc39.es/proposal-temporal/). A user task `dueDate`/`followUpDate` resolved from a FEEL expression is still an ISO 8601 string, now in feelin's serialization (`2026-09-04T09:00:00Z`, no `.000` milliseconds). Week durations (`P1W`) and mixed-kind duration arithmetic (months + days) are now rejected by feelin instead of silently miscomputed.
+
+### Fixes
+
+- readme: trailing slash on the 0dep.se/run link
+
+## v0.1.1 - 2026-09-16
+
+- set package homepage
+
+## v0.1.0 - 2026-09-13
+
+- require bpmn-elements@>=18.0.25
+- readme toc
+
+## v0.0.6 - 2026-08-30
+
+### Additions
+
+- `TimerEventDefinition` — a bpmn-elements timer event definition that also parses a **cron** `timeCycle` (`0 0 * * *`, as Camunda 8 schedules timer start events) besides ISO 8601 intervals. Install it through the type resolver: `TypeResolver({ ...elements, TimerEventDefinition })`.
+- `extendFn` lifts a timer start event's `timeCycle` onto the behaviour as `scheduledStart`; a process-level timer start event exposes it on its content, so a scheduler can find the flows to start without running them.
+- New peer dependency [`croner`](https://www.npmjs.com/package/croner) (`>= 9`) for cron parsing; kept external in the CJS bundle.
+- Dev: `zeebe-bpmn-moddle` bumped to v2.
+
+## v0.0.5 - 2026-08-24
+
+### Breaking
+
+- stop publishing on activity format queue if there is nothing to format
+
+### Additions
+
+- support task priority and task schedule, published on user task wait message as `priority`, `dueDate` and `followUpDate`
+
+## v0.0.4 - 2026-08-17
+
+- Environment services are in FEEL scope under `services`, callable as functions in every expression (conditions, io mapping, scripts, correlation keys, ...) — e.g. `= services.isEligible(order)`. Unlike functions passed through variables, services survive `getState()`/`recover()`, so they are resume-safe. A variable named `services` shadows the overlay. New exported helper `getFeelScope(environment, localVariables)` builds the scope.
+- `FeelScripts` `getScript` declares `Script | undefined` (bpmn-elements fixed the upstream type).
+
+## v0.0.3 - 2026-07-26
+
+- Message `zeebe:subscription`: the correlation key is resolved on enter and exposed on the waiting element content as `subscription: { message, correlationKey }`, so the embedding application can route an incoming message to the right waiting activity.
+- Fix: a FEEL unary test that is undecidable (evaluates to null) is now false — `evaluateFeelUnaryTest` returns strictly boolean.
+- Types: `FeelExpressions()` declares `isExpression`/`hasExpression`; JSDoc polish in `FeelScripts`.
+- Tests are type-checked against the published type surface (`tsc -p test/tsconfig.json`).
+- Peer `bpmn-elements` floor raised to `>= 18.0.12` — earlier versions could stall or skip extension re-activation when resuming a stopped instance in place.
+
+## v0.0.2 - 2026-06-28
+
+- FEEL (`= ...`) expressions and sequence-flow conditions (`FeelExpressions`); `zeebe:script` script tasks (`FeelScripts`).
+- Service tasks (`zeebe:taskDefinition`) and business rule tasks (`zeebe:calledDecision`) with `resultVariable`.
+- `zeebe:ioMapping` input/output, propagated across call activities and sub processes.
+- Multi-instance `zeebe:loopCharacteristics`: collection, parallel/sequential, `outputCollection` aggregation.
+- User tasks: `zeebe:assignmentDefinition`, `zeebe:formDefinition`; plus `zeebe:taskHeaders` and `zeebe:properties`.
+- Blocking `zeebe:executionListeners`, called as `(elementApi, { retries, headers }, callback)`.
+- Call activities (`zeebe:calledElement`); stop/recover/resume.
+- Dual ESM/CJS build with generated types; peer `bpmn-elements >= 18.0.4`.

package/README.md

@@ -210,7 +210,6 @@ assert.equal(serializer.getActivityById('start').behaviour.scheduledStart, '0 1
 ```sh
 npm test           # mocha (BDD, mocha-cakes-2) + lint + run README examples (texample)
 npm run test:md     # run the README javascript examples with texample
-npm run dist        # bundle the CommonJS build with rollup
 npm run types       # generate types/index.d.ts from JSDoc with dts-buddy
 npm run format      # eslint --fix && prettier --write
 ```
@@ -222,7 +221,7 @@ the engine's `Logger` to the [`debug`](https://www.npmjs.com/package/debug) pack
 
 ## Ecosystem
 
-- [0dep.se/run](https://0dep.se/run) — Run a BPMN diagram in the browser: `bpmn-elements` wired with `@0dep/bpmn-extensions`, drawn with bpmn-js; step through, signal waiting tasks, and drop DMN files for business rule tasks.
+- [0dep.se/run](https://0dep.se/run/) — Run a BPMN diagram in the browser: `bpmn-elements` wired with `@0dep/bpmn-extensions`, drawn with bpmn-js; step through, signal waiting tasks, and drop DMN files for business rule tasks.
 - [bpmn-engine](https://github.com/paed01/bpmn-engine) — BPMN 2.0 execution engine wrapping `bpmn-elements`; the batteries-included way to run, stop, resume, and recover flows.
 - [bpmn-middleware](https://github.com/zerodep/bpmn-middleware) — Express middleware exposing the engine over HTTP, with pluggable state storage.
 - [@onify/flow-extensions](https://github.com/onify/flow-extensions) — Onify Flow extensions for `bpmn-elements`.

package/package.json

@@ -1,21 +1,19 @@
 {
   "name": "@0dep/bpmn-extensions",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "Flow extensions for bpmn-elements: FEEL expressions and the zeebe-namespace BPMN extension elements",
   "type": "module",
-  "module": "src/index.js",
-  "main": "dist/index.js",
+  "main": "src/index.js",
   "types": "./types/index.d.ts",
   "sideEffects": false,
   "exports": {
     ".": {
       "types": "./types/index.d.ts",
-      "require": "./dist/index.js",
-      "import": "./src/index.js"
+      "default": "./src/index.js"
     }
   },
   "engines": {
-    "node": ">=22"
+    "node": ">=22.12"
   },
   "scripts": {
     "test": "mocha",
@@ -24,12 +22,11 @@
     "cov:html": "c8 mocha && c8 report --reporter html",
     "posttest": "npm run toc && npm run lint && npm run test:md && npm run prepack",
     "lint": "eslint . --cache && prettier . --check --cache",
-    "toc": "toc README.md",
+    "toc": "toc -c README.md",
     "posttoc": "prettier --write README.md",
     "format": "eslint . --fix && prettier . --write",
-    "dist": "rollup -c",
     "types": "dts-buddy types/index.d.ts -m @0dep/bpmn-extensions:src/index.js",
-    "prepack": "npm run dist && npm run types"
+    "prepack": "npm run types"
   },
   "keywords": [
     "bpmn",
@@ -45,9 +42,10 @@
     "url": "git+https://github.com/zerodep/bpmn-extensions.git"
   },
   "author": {
-    "name": "Pål Edman",
-    "url": "https://github.com/paed01"
+    "name": "Zerodep AB",
+    "url": "https://0dep.se"
   },
+  "homepage": "https://0dep.se/run/",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -57,7 +55,7 @@
     "croner": ">=9"
   },
   "dependencies": {
-    "feelin": "^7.0.1"
+    "feelin": "^8.1.0"
   },
   "overrides": {
     "mocha": {
@@ -65,10 +63,8 @@
     }
   },
   "devDependencies": {
-    "@0dep/toc": "^1.0.1",
+    "@0dep/toc": "^2.1.0",
     "@eslint/js": "^10.0.1",
-    "@rollup/plugin-commonjs": "^29.0.3",
-    "@rollup/plugin-node-resolve": "^16.0.3",
     "@types/chai": "^5.2.3",
     "@types/mocha": "^10.0.10",
     "@types/node": "^26.1.1",
@@ -85,19 +81,17 @@
     "mocha-cakes-2": "^3.3.0",
     "moddle-context-serializer": "^6.0.1",
     "prettier": "^3.9.1",
-    "rollup": "^4.62.2",
     "texample": "^1.0.2",
     "typescript": "^6.0.3",
     "zeebe-bpmn-moddle": "^2.0.0"
   },
   "files": [
     "src",
-    "dist",
-    "types"
+    "types",
+    "CHANGELOG.md"
   ],
   "c8": {
     "exclude": [
-      "dist",
       "test"
     ]
   }

package/src/extensions/formatters.js

@@ -91,17 +91,17 @@ export class FormatProcess {
 }
 
 /**
- * Resolve a due/follow-up date to an ISO 8601 string. A FEEL temporal result (a luxon
- * DateTime) or a Date is ISO-stringified — content is JSON-serialized on `getState()`, so a
- * string is the shape that survives a recover round trip. Anything else passes through as-is.
+ * Resolve a due/follow-up date to an ISO 8601 string. A FEEL temporal result (a feelin
+ * `FeelDateTime`) or a Date is ISO-stringified via `toJSON()` — content is JSON-serialized on
+ * `getState()`, so a string is the shape that survives a recover round trip. Anything else
+ * passes through as-is.
  * @param {any} value
  * @param {any} scope
  * @returns {string | undefined} Date as iso string
  */
 function resolveDate(value, scope) {
   const resolved = resolveValue(value, scope);
-  if (typeof resolved?.toISO === 'function') return resolved.toISO();
-  if (resolved instanceof Date) return resolved.toISOString();
+  if (typeof resolved?.toJSON === 'function') return resolved.toJSON();
   return resolved;
 }