@onify/flow-extensions 2.0.0 → 3.0.0

package/CHANGELOG.md

@@ -0,0 +1,31 @@
+Changelog
+=========
+
+# 3.0.0
+
+- Support activity script and expression execution listeners
+- Remove default behaviour of saving activity output even if output is not declared. Output **was** saved to `environment.output._<Activity ID>` if no result variable or output was declared. The reason was that there was no easy way of getting output from SubProcess or a multi-instance task. Now SubProcess output can be defined and multi-instance output can be solved with execution listener
+
+# 2.0.0
+
+- fix resume extension when recovered mid formatting
+- drop node 12 support
+
+# 1.1.0
+
+- allow ISO8601 repeating interval and duration in timeCycle
+
+# 1.0.0
+
+- proper routing keys for end formatting
+
+# 0.1.0
+
+- catch errors when resolving service expression
+- test with bpmn-engine@14
+
+# 0.0.2
+
+- allow expressions in timeCycle
+- test with bpmn-engine@13
+- error message changed in node 16

package/dist/index.js

@@ -6,11 +6,12 @@ Object.defineProperty(exports, "__esModule", {
 exports.extendFn = extendFn;
 exports.extensions = extensions;
 var _cronParser = _interopRequireDefault(require("cron-parser"));
-var _IOProperties = _interopRequireDefault(require("./src/IOProperties"));
-var _IOForm = _interopRequireDefault(require("./src/IOForm"));
-var _Connector = _interopRequireDefault(require("./src/Connector"));
-var _ServiceExpression = _interopRequireDefault(require("./src/ServiceExpression"));
-var _IO = require("./src/IO");
+var _IOProperties = _interopRequireDefault(require("./src/IOProperties.js"));
+var _IOForm = _interopRequireDefault(require("./src/IOForm.js"));
+var _Connector = _interopRequireDefault(require("./src/Connector.js"));
+var _ServiceExpression = _interopRequireDefault(require("./src/ServiceExpression.js"));
+var _IO = require("./src/IO.js");
+var _ExecutionListeners = _interopRequireDefault(require("./src/ExecutionListeners.js"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 const iso8601cycle = /^\s*(R\d+\/)?P\w+/i;
 class FormatError extends Error {
@@ -121,11 +122,68 @@ class OnifyElementExtensions {
     }, {
       consumerTag: '_onify-extension-on-executed'
     });
+    const executionListeners = this.extensions.listeners;
+    if (executionListeners !== null && executionListeners !== void 0 && executionListeners.onStart) {
+      activity.on('start', async elementApi => {
+        formatQ.queueMessage({
+          routingKey: 'run.listener.start'
+        }, {
+          endRoutingKey: 'run.listener.start.complete'
+        }, {
+          persistent: false
+        });
+        try {
+          var format = await executionListeners.execute('start', elementApi);
+        } catch (err) {
+          return broker.publish('format', 'run.listener.start.error', {
+            error: err
+          }, {
+            persistent: false
+          });
+        }
+        broker.publish('format', 'run.listener.start.complete', {
+          ...format
+        }, {
+          persistent: false
+        });
+      }, {
+        consumerTag: '_onify-extension-on-listenerstart'
+      });
+    }
+    if (executionListeners !== null && executionListeners !== void 0 && executionListeners.onEnd) {
+      activity.on('end', async elementApi => {
+        formatQ.queueMessage({
+          routingKey: 'run.listener.end'
+        }, {
+          endRoutingKey: 'run.listener.end.complete'
+        }, {
+          persistent: false
+        });
+        try {
+          var format = await executionListeners.execute('end', elementApi);
+        } catch (err) {
+          return broker.publish('format', 'run.listener.end.error', {
+            error: err
+          }, {
+            persistent: false
+          });
+        }
+        broker.publish('format', 'run.listener.end.complete', {
+          ...format
+        }, {
+          persistent: false
+        });
+      }, {
+        consumerTag: '_onify-extension-on-listenerend'
+      });
+    }
   }
   deactivate() {
     const broker = this.activity.broker;
     broker.cancel('_onify-extension-on-enter');
     broker.cancel('_onify-extension-on-executed');
+    broker.cancel('_onify-extension-on-listenerstart');
+    broker.cancel('_onify-extension-on-listenerend');
   }
   async _formatOnEnter(broker, formatQ, elementApi) {
     formatQ.queueMessage({
@@ -165,14 +223,15 @@ class OnifyElementExtensions {
       Object.assign(elementApi.content, result);
     }
     if (io) {
-      if (io.input?.length) {
+      var _io$input, _io$output;
+      if ((_io$input = io.input) !== null && _io$input !== void 0 && _io$input.length) {
         const input = await io.getInput(this.activity, elementApi);
         Object.assign(result, {
           input
         });
         Object.assign(elementApi.content, result);
       }
-      if (io.output?.length) {
+      if ((_io$output = io.output) !== null && _io$output !== void 0 && _io$output.length) {
         result.assignToOutput = true;
       }
     }
@@ -189,7 +248,7 @@ class OnifyElementExtensions {
       io
     } = this.extensions;
     const result = {};
-    if (io?.output.length) {
+    if (io !== null && io !== void 0 && io.output.length) {
       const output = await io.getOutput(this.activity, elementApi);
       Object.assign(result, {
         output
@@ -222,23 +281,26 @@ class OnifyElementExtensions {
   }
 }
 function getExtensions(element, context) {
+  var _element$behaviour$ex, _ext$values, _ext$fields;
   const result = {
     format: element.type === 'bpmn:Process' ? new FormatProcess(element) : new FormatActivity(element)
   };
   const expression = element.behaviour.expression;
   if (expression) result.Service = _ServiceExpression.default;
-  const extensions = element.behaviour.extensionElements?.values;
+  const extensions = (_element$behaviour$ex = element.behaviour.extensionElements) === null || _element$behaviour$ex === void 0 ? void 0 : _element$behaviour$ex.values;
   if (!extensions) return result;
+  const listeners = new _ExecutionListeners.default(element, context);
+  let listener = 0;
   for (const ext of extensions) {
     switch (ext.$type) {
       case 'camunda:Properties':
-        if (ext.values?.length) result.properties = new _IOProperties.default(element, ext);
+        if ((_ext$values = ext.values) !== null && _ext$values !== void 0 && _ext$values.length) result.properties = new _IOProperties.default(element, ext);
         break;
       case 'camunda:InputOutput':
         result.io = new _IO.InputOutput(element.id, ext, context);
         break;
       case 'camunda:FormData':
-        if (ext.fields?.length) result.form = new _IOForm.default(element, ext);
+        if ((_ext$fields = ext.fields) !== null && _ext$fields !== void 0 && _ext$fields.length) result.form = new _IOForm.default(element, ext);
         break;
       case 'camunda:Connector':
         {
@@ -250,14 +312,18 @@ function getExtensions(element, context) {
           result.Service = _Connector.default.bind(_Connector.default, connectorId, io);
           break;
         }
+      case 'camunda:ExecutionListener':
+        listeners.add(ext, listener++);
+        break;
     }
   }
+  if (listeners.length) result.listeners = listeners;
   return result;
 }
 class FormatActivity {
   constructor(activity) {
     this.activity = activity;
-    this.resultVariable = activity.behaviour.resultVariable || '_' + activity.id;
+    this.resultVariable = activity.behaviour.resultVariable;
     let timeCycles;
     if (activity.eventDefinitions) {
       for (const ed of activity.eventDefinitions.filter(e => e.type === 'bpmn:TimerEventDefinition')) {
@@ -269,6 +335,7 @@ class FormatActivity {
     this.timeCycles = timeCycles;
   }
   resolve(elementApi) {
+    var _documentation$, _user, _groups;
     let user, groups, assigneeValue, description;
     const activity = this.activity;
     const {
@@ -281,7 +348,7 @@ class FormatActivity {
     if (candidateUsers) user = resolveAndSplit(elementApi, candidateUsers);
     if (candidateGroups) groups = resolveAndSplit(elementApi, candidateGroups);
     if (assignee) assigneeValue = elementApi.resolveExpression(assignee);
-    if (documentation) description = documentation[0]?.text;
+    if (documentation) description = (_documentation$ = documentation[0]) === null || _documentation$ === void 0 ? void 0 : _documentation$.text;
     let expireAt;
     let timeCycles = this.timeCycles;
     if (timeCycles) {
@@ -293,14 +360,16 @@ class FormatActivity {
       }
     }
     return {
-      resultVariable: this.resultVariable,
+      ...(this.resultVariable && {
+        resultVariable: this.resultVariable
+      }),
       ...(scheduledStart && activity.parent.type === 'bpmn:Process' && {
         scheduledStart
       }),
-      ...(user?.length && {
+      ...(((_user = user) === null || _user === void 0 ? void 0 : _user.length) && {
         candidateUsers: user
       }),
-      ...(groups?.length && {
+      ...(((_groups = groups) === null || _groups === void 0 ? void 0 : _groups.length) && {
         candidateGroups: groups
       }),
       ...(!elementApi.content.description && description && {
@@ -320,6 +389,7 @@ class FormatProcess {
     this.process = bp;
   }
   resolve(elementApi) {
+    var _documentation$2, _user2, _groups2;
     let user, groups, description;
     const bp = this.process;
     const {
@@ -329,13 +399,12 @@ class FormatProcess {
     } = bp.behaviour;
     if (candidateStarterUsers) user = resolveAndSplit(elementApi, candidateStarterUsers);
     if (candidateStarterGroups) groups = resolveAndSplit(elementApi, candidateStarterGroups);
-    if (documentation) description = documentation[0]?.text;
+    if (documentation) description = (_documentation$2 = documentation[0]) === null || _documentation$2 === void 0 ? void 0 : _documentation$2.text;
     return {
-      resultVariable: this.resultVariable,
-      ...(user?.length && {
+      ...(((_user2 = user) === null || _user2 === void 0 ? void 0 : _user2.length) && {
         candidateStarterUsers: user
       }),
-      ...(groups?.length && {
+      ...(((_groups2 = groups) === null || _groups2 === void 0 ? void 0 : _groups2.length) && {
         candidateStarterGroups: groups
       }),
       ...(!elementApi.content.description && description && {
@@ -353,6 +422,7 @@ function resolveAndSplit(elementApi, str) {
   return resolved.split(',').map(g => g.trim && g.trim().toLowerCase()).filter(Boolean);
 }
 function extendFn(behaviour, context) {
+  var _behaviour$extensionE;
   if (behaviour.$type === 'bpmn:StartEvent' && behaviour.eventDefinitions) {
     const timer = behaviour.eventDefinitions.find(({
       type,
@@ -362,11 +432,21 @@ function extendFn(behaviour, context) {
       scheduledStart: timer.behaviour.timeCycle
     });
   }
-  if (!Array.isArray(behaviour.extensionElements?.values)) return;
-  const inputOutput = behaviour.extensionElements.values.find(el => el.$type === 'camunda:InputOutput');
-  const connector = behaviour.extensionElements.values.find(el => el.$type === 'camunda:Connector');
-  if (inputOutput) registerIOScripts(behaviour.id, context, inputOutput.$type, inputOutput);
-  if (connector) registerIOScripts(behaviour.id, context, connector.$type, connector.inputOutput);
+  if (!Array.isArray((_behaviour$extensionE = behaviour.extensionElements) === null || _behaviour$extensionE === void 0 ? void 0 : _behaviour$extensionE.values)) return;
+  let listener = 0;
+  for (const extension of behaviour.extensionElements.values) {
+    switch (extension.$type) {
+      case 'camunda:InputOutput':
+        registerIOScripts(behaviour.id, context, extension.$type, extension);
+        break;
+      case 'camunda:Connector':
+        registerIOScripts(behaviour.id, context, extension.$type, extension.inputOutput);
+        break;
+      case 'camunda:ExecutionListener':
+        registerListenerScript(behaviour.id, context, extension.$type, extension, listener++);
+        break;
+    }
+  }
 }
 function registerIOScripts(parentId, context, type, ioBehaviour) {
   if (!ioBehaviour) return;
@@ -393,4 +473,22 @@ function registerIOScripts(parentId, context, type, ioBehaviour) {
       })
     });
   }
+}
+function registerListenerScript(parentId, context, type, listener, pos) {
+  const {
+    event,
+    script
+  } = listener;
+  if (!script) return;
+  const id = `${parentId}/${type}/${event}/${pos}`;
+  context.addScript(id, {
+    id,
+    scriptFormat: script.scriptFormat,
+    ...(script.value && {
+      body: script.value
+    }),
+    ...(script.resource && {
+      resource: script.resource
+    })
+  });
 }

package/dist/src/Connector.js

@@ -30,7 +30,7 @@ Connector.prototype.execute = async function execute(...args) {
   }
   async function formatCallback(serviceErr, result) {
     if (serviceErr) return callback(serviceErr);
-    if (!io?.output.length) return callback(null, result);
+    if (!(io !== null && io !== void 0 && io.output.length)) return callback(null, result);
     try {
       const formattedResult = await io.getOutput(activity, {
         ...executionMessage,

package/dist/src/ExecutionListeners.js

@@ -0,0 +1,140 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+class Listener {
+  constructor(activity, context, extension) {
+    this.activity = activity;
+    this.environment = this.activity.environment;
+    this.context = context;
+    this.extension = extension;
+    this.type = extension.$type;
+    this.event = extension.event;
+  }
+  _getScope(message, extend) {
+    const environment = this.environment;
+    const {
+      fields,
+      content,
+      properties
+    } = message;
+    const scope = {
+      ...extend,
+      type: this.type,
+      listener: {
+        event: this.event
+      },
+      fields,
+      content,
+      properties,
+      environment,
+      logger: this.activity.logger
+    };
+    const listenerFields = this._getFields(environment, scope);
+    if (listenerFields) scope.listener.fields = listenerFields;
+    return scope;
+  }
+  _getFields(environment, scope) {
+    const fields = this.extension.fields;
+    if (!(fields !== null && fields !== void 0 && fields.length)) return;
+    const result = {};
+    for (const {
+      name,
+      expression,
+      string
+    } of fields) {
+      result['' + name] = expression ? environment.resolveExpression(expression, scope) : string;
+    }
+    return result;
+  }
+}
+class ScriptListener extends Listener {
+  constructor(activity, context, extension, pos) {
+    super(activity, context, extension);
+    const id = this.id = `${activity.id}/${extension.script.$type}/${this.event}/${pos}`;
+    this._register(context, id, extension.script);
+  }
+  execute(api) {
+    const environment = this.environment;
+    const scope = this._getScope(api, {
+      id: this.id,
+      resolveExpression
+    });
+    const script = this.environment.scripts.getScript(this.extension.scriptFormat, {
+      id: this.id
+    });
+    return new Promise((resolve, reject) => {
+      return script.execute(scope, (err, result) => {
+        if (err) return reject(err);
+        resolve(result);
+      });
+    });
+    function resolveExpression(expression) {
+      return environment.resolveExpression(expression, scope);
+    }
+  }
+  _register(context, id, script) {
+    const {
+      scriptFormat,
+      value,
+      resource
+    } = script;
+    context.environment.scripts.register({
+      id,
+      type: this.type,
+      behaviour: {
+        scriptFormat,
+        ...(value && {
+          script: value
+        }),
+        ...(resource && {
+          resource
+        })
+      }
+    });
+  }
+}
+class ExpressionListener extends Listener {
+  execute(message) {
+    const scope = this._getScope(message);
+    return {
+      expression: this.environment.resolveExpression(this.extension.expression, scope)
+    };
+  }
+}
+class ExecutionListeners {
+  constructor(activity, context) {
+    this.activity = activity;
+    this.context = context;
+    this.listeners = [];
+    this.onStart = false;
+    this.onEnd = false;
+  }
+  get length() {
+    return this.listeners.length;
+  }
+  add(extension, pos) {
+    const {
+      event,
+      script,
+      expression
+    } = extension;
+    if (!script && !expression) return;
+    const list = this.listeners;
+    if (script && (script.value || script.resource)) list.push(new ScriptListener(this.activity, this.context, extension, pos));else if (expression) list.push(new ExpressionListener(this.activity, this.context, extension));
+    if (event === 'start') this.onStart = true;
+    if (event === 'end') this.onEnd = true;
+  }
+  async execute(event, message) {
+    const found = this.listeners.filter(l => l.event === event);
+    const format = {};
+    for (const f of found) {
+      const result = await f.execute(message);
+      if (result !== null && typeof result === 'object') Object.assign(format, result);
+    }
+    return format;
+  }
+}
+exports.default = ExecutionListeners;

package/dist/src/FlowScripts.js

@@ -105,7 +105,7 @@ FlowScripts.prototype.getScript = function getScript(scriptType, {
 function JavaScript(flowName, scriptBody, runContext, options) {
   this.flowName = flowName;
   this._runContext = runContext;
-  this.timeout = options && options.timeout;
+  this.timeout = options === null || options === void 0 ? void 0 : options.timeout;
   try {
     this.script = new _vm.Script(scriptBody, options);
   } catch (err) {
@@ -151,17 +151,22 @@ function JavaScriptResource(flowName, resource, resourceBase, runContext, option
   this[kResources] = resourceBase;
 }
 JavaScriptResource.prototype.execute = async function execute(executionContext, callback) {
+  let resource;
   try {
-    var scriptBody = await _fs.promises.readFile((0, _path.join)(this[kResources], executionContext.resolveExpression(this.resource))); // eslint-disable-line no-var
+    resource = executionContext.resolveExpression(this.resource);
+    var scriptBody = await _fs.promises.readFile((0, _path.join)(this[kResources], resource)); // eslint-disable-line no-var
   } catch (err) {
+    if (err instanceof SyntaxError) {
+      return callback(err);
+    }
     const {
       filename
     } = this.options;
-    return callback(new Error(`${filename}: script resource ${this.resource} not found`));
+    return callback(new Error(`${filename}: script resource ${resource || this.resource} not found`));
   }
   const script = new JavaScript(this.flowName, scriptBody, this._runContext, {
     ...this.options,
-    filename: this.resource
+    filename: `${this.options.filename}/${resource}`
   });
   return script.execute(executionContext, callback);
 };

package/dist/src/IO.js

@@ -167,7 +167,7 @@ class IOScript extends IOBase {
       ...rest
     } = executionMessage;
     const scope = {
-      id: this.scriptId,
+      id: this.id,
       type: this.type,
       name,
       fields,

package/index.js

@@ -1,9 +1,10 @@
 import cronParser from 'cron-parser';
-import IOProperties from './src/IOProperties';
-import IOForm from './src/IOForm';
-import Connector from './src/Connector';
-import ServiceExpression from './src/ServiceExpression';
-import {InputOutput} from './src/IO';
+import IOProperties from './src/IOProperties.js';
+import IOForm from './src/IOForm.js';
+import Connector from './src/Connector.js';
+import ServiceExpression from './src/ServiceExpression.js';
+import {InputOutput} from './src/IO.js';
+import ExtensionListeners from './src/ExecutionListeners.js';
 
 const iso8601cycle = /^\s*(R\d+\/)?P\w+/i;
 
@@ -98,11 +99,41 @@ class OnifyElementExtensions {
 
       broker.publish('format', 'run.end.complete', {...format}, {persistent: false});
     }, {consumerTag: '_onify-extension-on-executed'});
+
+    const executionListeners = this.extensions.listeners;
+    if (executionListeners?.onStart) {
+      activity.on('start', async (elementApi) => {
+        formatQ.queueMessage({routingKey: 'run.listener.start'}, {endRoutingKey: 'run.listener.start.complete'}, {persistent: false});
+
+        try {
+          var format = await executionListeners.execute('start', elementApi);
+        } catch (err) {
+          return broker.publish('format', 'run.listener.start.error', {error: err}, {persistent: false});
+        }
+
+        broker.publish('format', 'run.listener.start.complete', {...format}, {persistent: false});
+      }, {consumerTag: '_onify-extension-on-listenerstart'});
+    }
+    if (executionListeners?.onEnd) {
+      activity.on('end', async (elementApi) => {
+        formatQ.queueMessage({routingKey: 'run.listener.end'}, {endRoutingKey: 'run.listener.end.complete'}, {persistent: false});
+
+        try {
+          var format = await executionListeners.execute('end', elementApi);
+        } catch (err) {
+          return broker.publish('format', 'run.listener.end.error', {error: err}, {persistent: false});
+        }
+
+        broker.publish('format', 'run.listener.end.complete', {...format}, {persistent: false});
+      }, {consumerTag: '_onify-extension-on-listenerend'});
+    }
   }
   deactivate() {
     const broker = this.activity.broker;
     broker.cancel('_onify-extension-on-enter');
     broker.cancel('_onify-extension-on-executed');
+    broker.cancel('_onify-extension-on-listenerstart');
+    broker.cancel('_onify-extension-on-listenerend');
   }
   async _formatOnEnter(broker, formatQ, elementApi) {
     formatQ.queueMessage({routingKey: 'run.enter.format'}, {endRoutingKey: 'run.enter.complete'}, {persistent: false});
@@ -185,6 +216,9 @@ function getExtensions(element, context) {
   const extensions = element.behaviour.extensionElements?.values;
   if (!extensions) return result;
 
+  const listeners = new ExtensionListeners(element, context);
+
+  let listener = 0;
   for (const ext of extensions) {
     switch (ext.$type) {
       case 'camunda:Properties':
@@ -202,16 +236,21 @@ function getExtensions(element, context) {
         result.Service = Connector.bind(Connector, connectorId, io);
         break;
       }
+      case 'camunda:ExecutionListener':
+        listeners.add(ext, listener++);
+        break;
     }
   }
 
+  if (listeners.length) result.listeners = listeners;
+
   return result;
 }
 
 class FormatActivity {
   constructor(activity) {
     this.activity = activity;
-    this.resultVariable = activity.behaviour.resultVariable || '_' + activity.id;
+    this.resultVariable = activity.behaviour.resultVariable;
 
     let timeCycles;
     if (activity.eventDefinitions) {
@@ -252,7 +291,7 @@ class FormatActivity {
     }
 
     return {
-      resultVariable: this.resultVariable,
+      ...(this.resultVariable && {resultVariable: this.resultVariable}),
       ...(scheduledStart && activity.parent.type === 'bpmn:Process' && {scheduledStart}),
       ...(user?.length && {candidateUsers: user}),
       ...(groups?.length && {candidateGroups: groups}),
@@ -281,7 +320,6 @@ class FormatProcess {
     if (documentation) description = documentation[0]?.text;
 
     return {
-      resultVariable: this.resultVariable,
       ...(user?.length && {candidateStarterUsers: user}),
       ...(groups?.length && {candidateStarterGroups: groups}),
       ...(!elementApi.content.description && description && {description: elementApi.resolveExpression(description)}),
@@ -311,11 +349,20 @@ function extendFn(behaviour, context) {
 
   if (!Array.isArray(behaviour.extensionElements?.values)) return;
 
-  const inputOutput = behaviour.extensionElements.values.find((el) => el.$type === 'camunda:InputOutput');
-  const connector = behaviour.extensionElements.values.find((el) => el.$type === 'camunda:Connector');
-
-  if (inputOutput) registerIOScripts(behaviour.id, context, inputOutput.$type, inputOutput);
-  if (connector) registerIOScripts(behaviour.id, context, connector.$type, connector.inputOutput);
+  let listener = 0;
+  for (const extension of behaviour.extensionElements.values) {
+    switch (extension.$type) {
+      case 'camunda:InputOutput':
+        registerIOScripts(behaviour.id, context, extension.$type, extension);
+        break;
+      case 'camunda:Connector':
+        registerIOScripts(behaviour.id, context, extension.$type, extension.inputOutput);
+        break;
+      case 'camunda:ExecutionListener':
+        registerListenerScript(behaviour.id, context, extension.$type, extension, listener++);
+        break;
+    }
+  }
 }
 
 function registerIOScripts(parentId, context, type, ioBehaviour) {
@@ -336,3 +383,16 @@ function registerIOScripts(parentId, context, type, ioBehaviour) {
     });
   }
 }
+
+function registerListenerScript(parentId, context, type, listener, pos) {
+  const {event, script} = listener;
+  if (!script) return;
+
+  const id = `${parentId}/${type}/${event}/${pos}`;
+  context.addScript(id, {
+    id,
+    scriptFormat: script.scriptFormat,
+    ...(script.value && {body: script.value}),
+    ...(script.resource && {resource: script.resource}),
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onify/flow-extensions",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "description": "Onify Flow extensions",
   "module": "index.js",
   "main": "dist/index.js",
@@ -40,7 +40,7 @@
     "@babel/preset-env": "^7.20.2",
     "@babel/register": "^7.18.9",
     "bpmn-elements-8-1": "npm:bpmn-elements@8.1",
-    "bpmn-engine": "^15.1.0",
+    "bpmn-engine": "^15.1.2",
     "bpmn-engine-14": "npm:bpmn-engine@14",
     "bpmn-moddle": "^7.1.3",
     "c8": "^7.12.0",
@@ -48,13 +48,13 @@
     "chai": "^4.3.7",
     "chronokinesis": "^3.1.2",
     "debug": "^4.3.4",
-    "eslint": "^8.27.0",
+    "eslint": "^8.28.0",
     "mocha": "^10.1.0",
     "mocha-cakes-2": "^3.3.0",
     "moddle-context-serializer": "^2.1.0"
   },
   "dependencies": {
-    "cron-parser": "^4.6.0"
+    "cron-parser": "^4.7.0"
   },
   "files": [
     "src",

package/src/ExecutionListeners.js

@@ -0,0 +1,126 @@
+class Listener {
+  constructor(activity, context, extension) {
+    this.activity = activity;
+    this.environment = this.activity.environment;
+    this.context = context;
+    this.extension = extension;
+    this.type = extension.$type;
+    this.event = extension.event;
+  }
+  _getScope(message, extend) {
+    const environment = this.environment;
+
+    const {fields, content, properties} = message;
+    const scope = {
+      ...extend,
+      type: this.type,
+      listener: {
+        event: this.event,
+      },
+      fields,
+      content,
+      properties,
+      environment,
+      logger: this.activity.logger,
+    };
+
+    const listenerFields = this._getFields(environment, scope);
+    if (listenerFields) scope.listener.fields = listenerFields;
+
+    return scope;
+  }
+  _getFields(environment, scope) {
+    const fields = this.extension.fields;
+    if (!fields?.length) return;
+    const result = {};
+    for (const {name, expression, string} of fields) {
+      result['' + name] = expression ? environment.resolveExpression(expression, scope) : string;
+    }
+    return result;
+  }
+}
+
+class ScriptListener extends Listener {
+  constructor(activity, context, extension, pos) {
+    super(activity, context, extension);
+    const id = this.id = `${activity.id}/${extension.script.$type}/${this.event}/${pos}`;
+    this._register(context, id, extension.script);
+  }
+  execute(api) {
+    const environment = this.environment;
+    const scope = this._getScope(api, {id: this.id, resolveExpression});
+    const script = this.environment.scripts.getScript(this.extension.scriptFormat, {id: this.id});
+
+    return new Promise((resolve, reject) => {
+      return script.execute(scope, (err, result) => {
+        if (err) return reject(err);
+        resolve(result);
+      });
+    });
+
+    function resolveExpression(expression) {
+      return environment.resolveExpression(expression, scope);
+    }
+  }
+  _register(context, id, script) {
+    const {
+      scriptFormat,
+      value,
+      resource
+    } = script;
+
+    context.environment.scripts.register({
+      id,
+      type: this.type,
+      behaviour: {
+        scriptFormat,
+        ...(value && {
+          script: value
+        }),
+        ...(resource && {
+          resource
+        })
+      }
+    });
+  }
+}
+
+class ExpressionListener extends Listener {
+  execute(message) {
+    const scope = this._getScope(message);
+    return {expression: this.environment.resolveExpression(this.extension.expression, scope)};
+  }
+}
+
+export default class ExecutionListeners {
+  constructor(activity, context) {
+    this.activity = activity;
+    this.context = context;
+    this.listeners = [];
+    this.onStart = false;
+    this.onEnd = false;
+  }
+  get length() {
+    return this.listeners.length;
+  }
+  add(extension, pos) {
+    const {event, script, expression} = extension;
+    if (!script && !expression) return;
+
+    const list = this.listeners;
+    if (script && (script.value || script.resource)) list.push(new ScriptListener(this.activity, this.context, extension, pos));
+    else if (expression) list.push(new ExpressionListener(this.activity, this.context, extension));
+
+    if (event === 'start') this.onStart = true;
+    if (event === 'end') this.onEnd = true;
+  }
+  async execute(event, message) {
+    const found = this.listeners.filter((l) => l.event === event);
+    const format = {};
+    for (const f of found) {
+      const result = await f.execute(message);
+      if (result !== null && typeof result === 'object') Object.assign(format, result);
+    }
+    return format;
+  }
+}

package/src/IO.js

@@ -153,7 +153,7 @@ class IOScript extends IOBase {
 
     const {fields, content, properties, ...rest} = executionMessage;
     const scope = {
-      id: this.scriptId,
+      id: this.id,
       type: this.type,
       name,
       fields,