bpmn-elements 13.1.2 → 14.0.0

package/README.md

@@ -1,5 +1,4 @@
-bpmn-elements
-=============
+# bpmn-elements
 
 [![Build](https://github.com/paed01/bpmn-elements/actions/workflows/build.yaml/badge.svg)](https://github.com/paed01/bpmn-elements/actions/workflows/build.yaml)[![Coverage Status](https://coveralls.io/repos/github/paed01/bpmn-elements/badge.svg?branch=master)](https://coveralls.io/github/paed01/bpmn-elements?branch=master)
 

package/dist/Context.js

@@ -6,10 +6,10 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = Context;
 var _BpmnIO = _interopRequireDefault(require("./io/BpmnIO.js"));
 var _Environment = _interopRequireDefault(require("./Environment.js"));
-var _ExtensionsMapper = _interopRequireDefault(require("./ExtensionsMapper.js"));
 var _shared = require("./shared.js");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 const kOwner = Symbol.for('owner');
+const kActivated = Symbol.for('activated');
 function Context(definitionContext, environment) {
   environment = environment ? environment.clone() : new _Environment.default();
   return new ContextInstance(definitionContext, environment);
@@ -27,7 +27,7 @@ function ContextInstance(definitionContext, environment, owner) {
   this.sid = sid;
   this.definitionContext = definitionContext;
   this.environment = environment;
-  this.extensionsMapper = new _ExtensionsMapper.default(this);
+  this.extensionsMapper = new ExtensionsMapper(this);
   this.refs = {
     activityRefs: {},
     associationRefs: [],
@@ -192,4 +192,38 @@ ContextInstance.prototype.getActivityParentById = function getActivityParentById
   const activity = this.getActivityById(activityId);
   const parentId = activity.parent.id;
   return this.getProcessById(parentId) || this.getActivityById(parentId);
+};
+function ExtensionsMapper(context) {
+  this.context = context;
+}
+ExtensionsMapper.prototype.get = function get(activity) {
+  return new Extensions(activity, this.context, this._getExtensions());
+};
+ExtensionsMapper.prototype._getExtensions = function getExtensions() {
+  let extensions;
+  if (!(extensions = this.context.environment.extensions)) return [];
+  return Object.values(extensions);
+};
+function Extensions(activity, context, extensions) {
+  const result = this.extensions = [];
+  for (const Extension of extensions) {
+    const extension = Extension(activity, context);
+    if (extension) result.push(extension);
+  }
+  this[kActivated] = false;
+}
+Object.defineProperty(Extensions.prototype, 'count', {
+  get() {
+    return this.extensions.length;
+  }
+});
+Extensions.prototype.activate = function activate(message) {
+  if (this[kActivated]) return;
+  this[kActivated] = true;
+  for (const extension of this.extensions) extension.activate(message);
+};
+Extensions.prototype.deactivate = function deactivate(message) {
+  if (!this[kActivated]) return;
+  this[kActivated] = false;
+  for (const extension of this.extensions) extension.deactivate(message);
 };

package/dist/activity/Activity.js

@@ -14,6 +14,7 @@ var _Errors = require("../error/Errors.js");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 const kActivityDef = Symbol.for('activityDefinition');
 const kConsuming = Symbol.for('consuming');
+const kConsumingRunQ = Symbol.for('run queue consumer');
 const kCounters = Symbol.for('counters');
 const kEventDefinitions = Symbol.for('eventDefinitions');
 const kExec = Symbol.for('exec');
@@ -113,6 +114,8 @@ function Activity(Behaviour, activityDef, context) {
   };
   this[kEventDefinitions] = eventDefinitions && eventDefinitions.map(ed => new ed.Behaviour(this, ed, this.context));
   this[kExtensions] = context.loadExtensions(this);
+  this[kConsuming] = false;
+  this[kConsumingRunQ] = undefined;
 }
 Object.defineProperties(Activity.prototype, {
   counters: {
@@ -239,6 +242,7 @@ Object.defineProperties(Activity.prototype, {
   }
 });
 Activity.prototype.activate = function activate() {
+  if (this[kActivated]) return;
   this[kActivated] = true;
   this.addInboundListeners();
   return this._consumeInbound();
@@ -274,6 +278,7 @@ Activity.prototype.run = function run(runContent) {
   const broker = this.broker;
   broker.publish('run', 'run.enter', content);
   broker.publish('run', 'run.start', (0, _messageHelper.cloneContent)(content));
+  this[kConsuming] = true;
   this._consumeRunQ();
 };
 Activity.prototype.getState = function getState() {
@@ -322,6 +327,7 @@ Activity.prototype.resume = function resume() {
   this.broker.publish('run', 'run.resume', content, {
     persistent: false
   });
+  this[kConsuming] = true;
   this._consumeRunQ();
 };
 Activity.prototype.discard = function discard(discardContent) {
@@ -332,6 +338,7 @@ Activity.prototype.discard = function discard(discardContent) {
   const broker = this.broker;
   broker.getQueue('run-q').purge();
   broker.publish('run', 'run.discard', (0, _messageHelper.cloneContent)(this[kStateMessage].content));
+  this[kConsuming] = true;
   this._consumeRunQ();
 };
 Activity.prototype.addInboundListeners = function addInboundListeners() {
@@ -396,6 +403,7 @@ Activity.prototype._runDiscard = function runDiscard(discardContent) {
     executionId
   });
   this.broker.publish('run', 'run.discard', content);
+  this[kConsuming] = true;
   this._consumeRunQ();
 };
 Activity.prototype._discardRun = function discardRun() {
@@ -404,17 +412,19 @@ Activity.prototype._discardRun = function discardRun() {
   const execution = this[kExec].execution;
   if (execution && !execution.completed) return;
   switch (status) {
+    case 'end':
     case 'executing':
     case 'error':
     case 'discarded':
       return;
   }
   this._deactivateRunConsumers();
-  const message = this[kStateMessage];
-  if (this.extensions) this.extensions.deactivate((0, _messageHelper.cloneMessage)(message));
+  const stateMessage = this[kStateMessage];
+  if (this.extensions) this.extensions.deactivate((0, _messageHelper.cloneMessage)(stateMessage));
   const broker = this.broker;
   broker.getQueue('run-q').purge();
-  broker.publish('run', 'run.discard', (0, _messageHelper.cloneContent)(message.content));
+  broker.publish('run', 'run.discard', (0, _messageHelper.cloneContent)(stateMessage.content));
+  this[kConsuming] = true;
   this._consumeRunQ();
 };
 Activity.prototype._shakeOutbound = function shakeOutbound(sourceMessage) {
@@ -441,13 +451,14 @@ Activity.prototype._consumeInbound = function consumeInbound() {
   if (!this[kActivated]) return;
   if (this.status) return;
   const inboundQ = this.broker.getQueue('inbound-q');
+  const onInbound = this[kMessageHandlers].onInbound;
   if (this[kFlags].isParallelJoin) {
-    return inboundQ.consume(this[kMessageHandlers].onInbound, {
+    return inboundQ.consume(onInbound, {
       consumerTag: '_run-on-inbound',
       prefetch: 1000
     });
   }
-  return inboundQ.consume(this[kMessageHandlers].onInbound, {
+  return inboundQ.consume(onInbound, {
     consumerTag: '_run-on-inbound'
   });
 };
@@ -548,13 +559,17 @@ Activity.prototype._onInboundEvent = function onInboundEvent(routingKey, message
   }
 };
 Activity.prototype._consumeRunQ = function consumeRunQ() {
-  if (this[kConsuming]) return;
-  this[kConsuming] = true;
+  this[kConsumingRunQ] = true;
   this.broker.getQueue('run-q').assertConsumer(this[kMessageHandlers].onRunMessage, {
     exclusive: true,
     consumerTag: '_activity-run'
   });
 };
+Activity.prototype._pauseRunQ = function pauseRunQ() {
+  if (!this[kConsumingRunQ]) return;
+  this[kConsumingRunQ] = false;
+  this.broker.cancel('_activity-run');
+};
 Activity.prototype._onRunMessage = function onRunMessage(routingKey, message, messageProperties) {
   switch (routingKey) {
     case 'run.outbound.discard':
@@ -709,8 +724,9 @@ Activity.prototype._continueRunMessage = function continueRunMessage(routingKey,
         break;
       }
     case 'run.next':
-      this._consumeInbound();
-      break;
+      message.ack();
+      this._pauseRunQ();
+      return this._consumeInbound();
   }
   if (!step) message.ack();
 };
@@ -877,8 +893,7 @@ Activity.prototype._publishEvent = function publishEvent(state, content, propert
   }), {
     ...properties,
     type: state,
-    mandatory: state === 'error',
-    persistent: 'persistent' in properties ? properties.persistent : state !== 'stop'
+    mandatory: state === 'error'
   });
 };
 Activity.prototype._onStop = function onStop(message) {
@@ -886,14 +901,16 @@ Activity.prototype._onStop = function onStop(message) {
   this.stopped = true;
   this[kConsuming] = false;
   const broker = this.broker;
-  broker.cancel('_activity-run');
+  this._pauseRunQ();
   broker.cancel('_activity-api');
   broker.cancel('_activity-execution');
   broker.cancel('_run-on-inbound');
   broker.cancel('_format-consumer');
+  if (this.extensions) this.extensions.deactivate((0, _messageHelper.cloneMessage)(message));
   if (running) {
-    if (this.extensions) this.extensions.deactivate((0, _messageHelper.cloneMessage)(message));
-    this._publishEvent('stop', this._createMessage());
+    this._publishEvent('stop', this._createMessage(), {
+      persistent: false
+    });
   }
 };
 Activity.prototype._consumeApi = function consumeApi() {
@@ -952,7 +969,7 @@ Activity.prototype._getOutboundSequenceFlowById = function getOutboundSequenceFl
 Activity.prototype._deactivateRunConsumers = function _deactivateRunConsumers() {
   const broker = this.broker;
   broker.cancel('_activity-api');
-  broker.cancel('_activity-run');
+  this._pauseRunQ();
   broker.cancel('_activity-execution');
   this[kConsuming] = false;
 };

package/dist/definition/DefinitionExecution.js

@@ -412,7 +412,6 @@ DefinitionExecution.prototype._onProcessMessage = function onProcessMessage(rout
       }
     case 'process.error':
       {
-        // message.ack();
         if (inbound && inbound.length) {
           const calledFrom = inbound[0];
           this._getProcessApi({
@@ -428,6 +427,7 @@ DefinitionExecution.prototype._onProcessMessage = function onProcessMessage(rout
           for (const bp of this[kProcesses].running.slice()) {
             if (bp.id !== childId) bp.stop();
           }
+          Object.assign(this.environment.output, content.output);
           this._complete('error', {
             error: content.error
           });

package/dist/error/Errors.js

@@ -23,7 +23,12 @@ class ActivityError extends Error {
   }
 }
 exports.ActivityError = ActivityError;
-class RunError extends ActivityError {}
+class RunError extends ActivityError {
+  constructor(...args) {
+    super(...args);
+    this.type = 'RunError';
+  }
+}
 exports.RunError = RunError;
 class BpmnError extends Error {
   constructor(description, behaviour = {}, sourceMessage, inner) {

package/dist/eventDefinitions/TimerEventDefinition.js

@@ -5,10 +5,11 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = TimerEventDefinition;
 var _messageHelper = require("../messageHelper.js");
-var _isoDuration = require("../iso-duration.js");
+var _piso = require("@0dep/piso");
 const kStopped = Symbol.for('stopped');
 const kTimerContent = Symbol.for('timerContent');
 const kTimer = Symbol.for('timer');
+const timerTypes = ['timeDuration', 'timeDate', 'timeCycle'];
 function TimerEventDefinition(activity, eventDefinition) {
   const type = this.type = eventDefinition.type || 'TimerEventDefinition';
   this.activity = activity;
@@ -81,7 +82,6 @@ TimerEventDefinition.prototype.execute = function execute(executeMessage) {
   broker.publish('execution', 'execute.timer', (0, _messageHelper.cloneContent)(timerContent));
   broker.publish('event', 'activity.timer', (0, _messageHelper.cloneContent)(timerContent));
   if (this.stopped) return;
-  if (timerContent.timeout === undefined) return this._debug(`waiting for ${timerContent.timerType || 'signal'}`);
   if (timerContent.timeout <= 0) return this._completed();
   const timers = this.environment.timers.register(timerContent);
   const delay = timerContent.timeout;
@@ -191,25 +191,21 @@ TimerEventDefinition.prototype._stop = function stop() {
 };
 TimerEventDefinition.prototype.parse = function parse(timerType, value) {
   let repeat, delay, expireAt;
+  const now = new Date();
   switch (timerType) {
     case 'timeCycle':
     case 'timeDuration':
       {
-        const parsed = (0, _isoDuration.parse)(value);
+        const parsed = new _piso.ISOInterval(value).parse();
         if (parsed.repeat) repeat = parsed.repeat;
-        delay = (0, _isoDuration.toSeconds)(parsed) * 1000;
-        expireAt = new Date(Date.now() + delay);
+        expireAt = parsed.getExpireAt(now, now);
+        delay = expireAt.getTime() - now.getTime();
         break;
       }
     case 'timeDate':
       {
-        const ms = Date.parse(value);
-        if (!isNaN(ms)) {
-          expireAt = new Date(ms);
-          delay = Date.now() - expireAt;
-        } else {
-          throw new TypeError(`invalid timeDate >${value}<`);
-        }
+        expireAt = (0, _piso.getDate)(value);
+        delay = now.getTime() - expireAt;
         break;
       }
   }
@@ -226,28 +222,22 @@ TimerEventDefinition.prototype._getTimers = function getTimers(executeMessage) {
       expireAt: new Date(content.expireAt)
     })
   };
-  let parseErr;
-  for (const t of ['timeDuration', 'timeDate', 'timeCycle']) {
-    if (t in content) result[t] = content[t];else if (t in this) result[t] = this.environment.resolveExpression(this[t], executeMessage);else continue;
+  for (const timerType of timerTypes) {
+    if (timerType in content) result[timerType] = content[timerType];else if (timerType in this) result[timerType] = this.environment.resolveExpression(this[timerType], executeMessage);else continue;
     let expireAtDate, repeat;
-    const timerStr = result[t];
+    const timerStr = result[timerType];
     if (timerStr) {
-      try {
-        const {
-          repeat: parsedRepeat,
-          expireAt: parsedExpireAt
-        } = this.parse(t, timerStr);
-        repeat = parsedRepeat;
-        expireAtDate = parsedExpireAt;
-      } catch (err) {
-        parseErr = err;
-      }
+      const {
+        repeat: parsedRepeat,
+        expireAt: parsedExpireAt
+      } = this.parse(timerType, timerStr);
+      repeat = parsedRepeat;
+      expireAtDate = parsedExpireAt;
     } else {
       expireAtDate = new Date();
     }
-    if (!expireAtDate) continue;
     if (!('expireAt' in result) || result.expireAt > expireAtDate) {
-      result.timerType = t;
+      result.timerType = timerType;
       result.expireAt = expireAtDate;
       result.repeat = repeat;
     }
@@ -259,9 +249,6 @@ TimerEventDefinition.prototype._getTimers = function getTimers(executeMessage) {
   } else if (!Object.keys(result).length) {
     result.timeout = 0;
   }
-  if (!('timeout' in result) && parseErr) {
-    this.logger.warn(`<${this.activity.id}> failed to parse timer: ${parseErr.message}`);
-  }
   if (content.inbound && 'repeat' in content.inbound[0]) {
     result.repeat = content.inbound[0].repeat;
   }

package/dist/getPropertyValue.js

@@ -48,7 +48,6 @@ function executeFn(fn, args, base, fnScope) {
   }
   if (!fnScope) return fn.apply(null, callArguments);
   return function ScopedIIFE() {
-    // eslint-disable-line no-extra-parens
     return fn.apply(this, callArguments);
   }.call(fnScope);
 }
@@ -65,7 +64,7 @@ function splitArguments(args, base, fnScope) {
         argCompleted = true;
       } else if (charPos !== ' ') {
         arg += charPos;
-        if (charPos === '\'' || charPos === '"') {
+        if (charPos === "'" || charPos === '"') {
           insideString = true;
           delimiter = charPos;
         }

package/dist/index.js

@@ -9,6 +9,12 @@ Object.defineProperty(exports, "Activity", {
     return _Activity.default;
   }
 });
+Object.defineProperty(exports, "ActivityError", {
+  enumerable: true,
+  get: function () {
+    return _Errors.ActivityError;
+  }
+});
 Object.defineProperty(exports, "Association", {
   enumerable: true,
   get: function () {
@@ -147,7 +153,6 @@ Object.defineProperty(exports, "Group", {
     return _Dummy.default;
   }
 });
-exports.ISODuration = void 0;
 Object.defineProperty(exports, "InclusiveGateway", {
   enumerable: true,
   get: function () {
@@ -238,6 +243,12 @@ Object.defineProperty(exports, "ReceiveTask", {
     return _ReceiveTask.default;
   }
 });
+Object.defineProperty(exports, "RunError", {
+  enumerable: true,
+  get: function () {
+    return _Errors.RunError;
+  }
+});
 Object.defineProperty(exports, "ScriptTask", {
   enumerable: true,
   get: function () {
@@ -396,8 +407,5 @@ var _TerminateEventDefinition = _interopRequireDefault(require("./eventDefinitio
 var _TimerEventDefinition = _interopRequireDefault(require("./eventDefinitions/TimerEventDefinition.js"));
 var _Transaction = _interopRequireDefault(require("./tasks/Transaction.js"));
 var _Timers = require("./Timers.js");
-var ISODuration = _interopRequireWildcard(require("./iso-duration.js"));
-exports.ISODuration = ISODuration;
-function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
-function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+var _Errors = require("./error/Errors.js");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bpmn-elements",
-  "version": "13.1.2",
+  "version": "14.0.0",
   "description": "Executable workflow elements based on BPMN 2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -33,7 +33,7 @@
   "scripts": {
     "test": "mocha -R @bonniernews/hot-bev -p -t 3000",
     "posttest": "npm run lint && npm run dist",
-    "lint": "eslint . --cache",
+    "lint": "eslint . --cache && prettier . --check --cache",
     "prepack": "npm run dist",
     "cov:html": "c8 -r html -r text mocha -R @bonniernews/hot-bev -p -t 3000",
     "test:lcov": "c8 -r lcov mocha && npm run lint",
@@ -64,27 +64,29 @@
   ],
   "devDependencies": {
     "@aircall/expression-parser": "^1.0.4",
-    "@babel/cli": "^7.23.9",
-    "@babel/core": "^7.23.9",
-    "@babel/preset-env": "^7.23.9",
+    "@babel/cli": "^7.24.1",
+    "@babel/core": "^7.24.4",
+    "@babel/preset-env": "^7.24.4",
     "@babel/register": "^7.23.7",
     "@bonniernews/hot-bev": "^0.4.0",
-    "@types/node": "^16.18.80",
-    "bpmn-moddle": "^8.1.0",
+    "@types/node": "^16.18.95",
+    "bpmn-moddle": "^9.0.1",
     "c8": "^9.1.0",
     "camunda-bpmn-moddle": "^7.0.1",
-    "chai": "^5.0.3",
+    "chai": "^5.1.0",
     "chronokinesis": "^6.0.0",
     "debug": "^4.3.4",
-    "eslint": "^8.56.0",
-    "eslint-plugin-import": "^2.29.1",
-    "got": "^14.2.0",
-    "mocha": "^10.3.0",
+    "eslint": "^9.0.0",
+    "globals": "^15.0.0",
+    "got": "^14.2.1",
+    "mocha": "^10.4.0",
     "mocha-cakes-2": "^3.3.0",
     "moddle-context-serializer": "^4.1.2",
-    "nock": "^13.5.1"
+    "nock": "^13.5.3",
+    "prettier": "^3.2.5"
   },
   "dependencies": {
-    "smqp": "^8.2.2"
+    "@0dep/piso": "^0.1.3",
+    "smqp": "^8.2.4"
   }
 }

package/src/Api.js

@@ -1,13 +1,7 @@
-import {cloneMessage} from './messageHelper.js';
-import {getUniqueId} from './shared.js';
-
-export {
-  ActivityApi,
-  DefinitionApi,
-  ProcessApi,
-  FlowApi,
-  Api,
-};
+import { cloneMessage } from './messageHelper.js';
+import { getUniqueId } from './shared.js';
+
+export { ActivityApi, DefinitionApi, ProcessApi, FlowApi, Api };
 
 function ActivityApi(broker, apiMessage, environment) {
   return new Api('activity', broker, apiMessage, environment);
@@ -30,7 +24,7 @@ function Api(pfx, broker, sourceMessage, environment) {
 
   const apiMessage = cloneMessage(sourceMessage);
 
-  const {id, type, name, executionId} = apiMessage.content;
+  const { id, type, name, executionId } = apiMessage.content;
   this.id = id;
   this.type = type;
   this.name = name;
@@ -45,7 +39,7 @@ function Api(pfx, broker, sourceMessage, environment) {
 }
 
 Api.prototype.cancel = function cancel(message, options) {
-  this.sendApiMessage('cancel', {message}, options);
+  this.sendApiMessage('cancel', { message }, options);
 };
 
 Api.prototype.discard = function discard() {
@@ -53,11 +47,11 @@ Api.prototype.discard = function discard() {
 };
 
 Api.prototype.fail = function fail(error) {
-  this.sendApiMessage('error', {error});
+  this.sendApiMessage('error', { error });
 };
 
 Api.prototype.signal = function signal(message, options) {
-  this.sendApiMessage('signal', {message}, options);
+  this.sendApiMessage('signal', { message }, options);
 };
 
 Api.prototype.stop = function stop() {
@@ -65,18 +59,22 @@ Api.prototype.stop = function stop() {
 };
 
 Api.prototype.resolveExpression = function resolveExpression(expression) {
-  return this.environment.resolveExpression(expression, {
-    fields: this.fields,
-    content: this.content,
-    properties: this.messageProperties,
-  }, this.owner);
+  return this.environment.resolveExpression(
+    expression,
+    {
+      fields: this.fields,
+      content: this.content,
+      properties: this.messageProperties,
+    },
+    this.owner,
+  );
 };
 
 Api.prototype.sendApiMessage = function sendApiMessage(action, content, options) {
   const correlationId = (options && options.correlationId) || getUniqueId(`${this.id || this.messagePrefix}_signal`);
   let key = `${this.messagePrefix}.${action}`;
   if (this.executionId) key += `.${this.executionId}`;
-  this.broker.publish('api', key, this.createMessage(content), {...options, correlationId, type: action});
+  this.broker.publish('api', key, this.createMessage(content), { ...options, correlationId, type: action });
 };
 
 Api.prototype.getPostponed = function getPostponed(...args) {

package/src/Context.js

@@ -1,9 +1,9 @@
 import BpmnIO from './io/BpmnIO.js';
 import Environment from './Environment.js';
-import ExtensionsMapper from './ExtensionsMapper.js';
-import {getUniqueId} from './shared.js';
+import { getUniqueId } from './shared.js';
 
 const kOwner = Symbol.for('owner');
+const kActivated = Symbol.for('activated');
 
 export default function Context(definitionContext, environment) {
   environment = environment ? environment.clone() : new Environment();
@@ -11,7 +11,7 @@ export default function Context(definitionContext, environment) {
 }
 
 function ContextInstance(definitionContext, environment, owner) {
-  const {id = 'Def', name, type = 'context'} = definitionContext;
+  const { id = 'Def', name, type = 'context' } = definitionContext;
   const sid = getUniqueId(id);
   this.id = id;
   this.name = name;
@@ -148,11 +148,11 @@ ContextInstance.prototype.getNewProcessById = function getNewProcessById(process
 };
 
 ContextInstance.prototype.getProcesses = function getProcesses() {
-  return this.definitionContext.getProcesses().map(({id: processId}) => this.getProcessById(processId));
+  return this.definitionContext.getProcesses().map(({ id: processId }) => this.getProcessById(processId));
 };
 
 ContextInstance.prototype.getExecutableProcesses = function getExecutableProcesses() {
-  return this.definitionContext.getExecutableProcesses().map(({id: processId}) => this.getProcessById(processId));
+  return this.definitionContext.getExecutableProcesses().map(({ id: processId }) => this.getProcessById(processId));
 };
 
 ContextInstance.prototype.getMessageFlows = function getMessageFlows(sourceId) {
@@ -180,7 +180,8 @@ ContextInstance.prototype.getDataStoreById = function getDataStoreById(reference
   let dataStore;
   if ((dataStore = this.refs.dataStoreRefs[referenceId])) return dataStore;
 
-  const dataStoreDef = this.definitionContext.getDataStoreById(referenceId) || this.definitionContext.getDataStoreReferenceById(referenceId);
+  const dataStoreDef =
+    this.definitionContext.getDataStoreById(referenceId) || this.definitionContext.getDataStoreReferenceById(referenceId);
   if (!dataStoreDef) return;
 
   dataStore = this.refs.dataStoreRefs[dataStoreDef.id] = new dataStoreDef.Behaviour(dataStoreDef, this);
@@ -189,7 +190,7 @@ ContextInstance.prototype.getDataStoreById = function getDataStoreById(reference
 };
 
 ContextInstance.prototype.getStartActivities = function getStartActivities(filterOptions, scopeId) {
-  const {referenceId, referenceType = 'unknown'} = filterOptions || {};
+  const { referenceId, referenceType = 'unknown' } = filterOptions || {};
   const result = [];
   for (const activity of this.getActivities()) {
     if (!activity.isStart) continue;
@@ -224,3 +225,44 @@ ContextInstance.prototype.getActivityParentById = function getActivityParentById
   const parentId = activity.parent.id;
   return this.getProcessById(parentId) || this.getActivityById(parentId);
 };
+
+function ExtensionsMapper(context) {
+  this.context = context;
+}
+
+ExtensionsMapper.prototype.get = function get(activity) {
+  return new Extensions(activity, this.context, this._getExtensions());
+};
+
+ExtensionsMapper.prototype._getExtensions = function getExtensions() {
+  let extensions;
+  if (!(extensions = this.context.environment.extensions)) return [];
+  return Object.values(extensions);
+};
+
+function Extensions(activity, context, extensions) {
+  const result = (this.extensions = []);
+  for (const Extension of extensions) {
+    const extension = Extension(activity, context);
+    if (extension) result.push(extension);
+  }
+  this[kActivated] = false;
+}
+
+Object.defineProperty(Extensions.prototype, 'count', {
+  get() {
+    return this.extensions.length;
+  },
+});
+
+Extensions.prototype.activate = function activate(message) {
+  if (this[kActivated]) return;
+  this[kActivated] = true;
+  for (const extension of this.extensions) extension.activate(message);
+};
+
+Extensions.prototype.deactivate = function deactivate(message) {
+  if (!this[kActivated]) return;
+  this[kActivated] = false;
+  for (const extension of this.extensions) extension.deactivate(message);
+};