Merge branch 'release/0.7.1'

zambrovski · zambrovski · commit 18aa7aebd112 · 2026-01-08T09:51:48.000+01:00
diff --git a/.github/workflows/development.yml b/.github/workflows/development.yml
@@ -24,7 +24,7 @@ jobs:
     steps:
       # Checkout the code
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Expose branch name
         run: echo ${{ github.ref }}
diff --git a/.github/workflows/master.yml b/.github/workflows/master.yml
@@ -15,7 +15,7 @@ jobs:
     name: Build and run tests
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       # Setup JDK and .m2/settings.xml
       - name: Set up JDK
diff --git a/.gitignore b/.gitignore
@@ -44,3 +44,4 @@ build/
 ### DEV
 _tmp/
 .repository/
+.claude
diff --git a/README.md b/README.md
@@ -171,7 +171,10 @@ ZEEBE_CLIENT_ID=..
 ZEEBE_CLIENT_SECRET=...
 ```
 
-After starting application, you can either use Open API endpoints or just run the 
+After starting application, you can either use Open API endpoints or just run the
 HTTP client tests using your IntelliJ, located in the example directory.
 
-Don't forget to first deploy the process! Either manually via operate / modeler, or with the HTTP client script: c8-deploy-process.http
+Don't forget to first deploy the process! 
+Either manually via operate / modeler, or with the HTTP client script: 
+c8-deploy-process.http
+
diff --git a/docs/process-engine-worker.md b/docs/process-engine-worker.md
@@ -3,10 +3,10 @@ title: Process Engine Worker
 ---
 
 Process Engine Worker is an independent component built on top of Process Engine API in order to accelerate the development of agnostic workers
-for any process engine supported by Process Engine API in Spring Boot ecosystem. By doing so, it abstracts from specific worker clients and 
+for any process engine supported by Process Engine API in Spring Boot ecosystem. By doing so, it abstracts from specific worker clients and
 API and allows to build universal workers.
 
-First of all add the Process Engine Worker dependency to your projects classpath. In Maven add the following to you `pom.xml`:
+First of all add the Process Engine Worker dependency to your projects classpath. In Maven add the following to your `pom.xml`:
 
 ```xml
 <dependency>
@@ -72,9 +72,22 @@ is a checked exception, in order to comply with Spring behavior of not rolling b
 
 The worker method can be marked transactional by adding Spring or Jakarta EE transactional annotations to the method or to the worker class.
 If the annotation `@org.springframework.transaction.annotation.Transactional` with propagation `REQUIRES`, `REQUIRES_NEW`, `SUPPORTS` and `MANDATORY`
-is used, the library will execute the worker method and the completion of the external task via API in the same transaction. This will lead to 
+is used, the library will execute the worker method and the completion of the external task via API in the same transaction. This will lead to
 a transaction rollback, if the external task can't be completed (e.g. due to a network error).
 
+## Configuration
+
+You can configure the Process Engine Worker by adding the following properties to your `application.properties` or `application.yml`:
+
+```yaml
+dev:
+  bpm-crafters:
+    process-api:
+      worker:
+        registerProcessWorkers: true # Enable or disable automatic worker registration
+        completeTasksBeforeCommit: false # Determines whether tasks are completed before transaction commit
+```
+
 
 
 
diff --git a/examples/camunda7-embedded-starter-transaction/pom.xml b/examples/camunda7-embedded-starter-transaction/pom.xml
@@ -5,7 +5,7 @@
   <parent>
     <groupId>dev.bpm-crafters.process-engine-worker</groupId>
     <artifactId>process-engine-worker-examples</artifactId>
-    <version>0.7.0</version>
+    <version>0.7.1</version>
     <relativePath>../pom.xml</relativePath>
   </parent>
 
@@ -85,7 +85,7 @@
     <dependency>
       <groupId>io.holunda</groupId>
       <artifactId>camunda-platform-7-autologin</artifactId>
-      <version>2025.10.1</version>
+      <version>2025.12.2</version>
     </dependency>
     <dependency>
       <groupId>com.h2database</groupId>
diff --git a/examples/camunda7-remote-starter-native/pom.xml b/examples/camunda7-remote-starter-native/pom.xml
@@ -5,7 +5,7 @@
   <parent>
     <groupId>dev.bpm-crafters.process-engine-worker</groupId>
     <artifactId>process-engine-worker-examples</artifactId>
-    <version>0.7.0</version>
+    <version>0.7.1</version>
     <relativePath>../pom.xml</relativePath>
   </parent>
 
diff --git a/examples/order-fulfillment/pom.xml b/examples/order-fulfillment/pom.xml
@@ -5,7 +5,7 @@
   <parent>
     <groupId>dev.bpm-crafters.process-engine-worker</groupId>
     <artifactId>process-engine-worker-examples</artifactId>
-    <version>0.7.0</version>
+    <version>0.7.1</version>
     <relativePath>../pom.xml</relativePath>
   </parent>
 
@@ -99,7 +99,7 @@
     <dependency>
       <groupId>io.holunda</groupId>
       <artifactId>camunda-platform-7-autologin</artifactId>
-      <version>2025.10.1</version>
+      <version>2025.12.2</version>
     </dependency>
     <dependency>
       <groupId>com.h2database</groupId>
@@ -123,6 +123,18 @@
     <testSourceDirectory>src/test/java</testSourceDirectory>
 
     <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-compiler-plugin</artifactId>
+        <configuration>
+          <annotationProcessorPaths>
+            <path>
+              <groupId>org.projectlombok</groupId>
+              <artifactId>lombok</artifactId>
+            </path>
+          </annotationProcessorPaths>
+        </configuration>
+      </plugin>
       <plugin>
         <groupId>org.jetbrains.kotlin</groupId>
         <artifactId>kotlin-maven-plugin</artifactId>
diff --git a/examples/pom.xml b/examples/pom.xml
@@ -5,7 +5,7 @@
   <parent>
     <groupId>dev.bpm-crafters.process-engine-worker</groupId>
     <artifactId>process-engine-worker-root</artifactId>
-    <version>0.7.0</version>
+    <version>0.7.1</version>
     <relativePath>../pom.xml</relativePath>
   </parent>
 
diff --git a/pom.xml b/pom.xml
@@ -11,7 +11,7 @@
 
   <groupId>dev.bpm-crafters.process-engine-worker</groupId>
   <artifactId>process-engine-worker-root</artifactId>
-  <version>0.7.0</version>
+  <version>0.7.1</version>
   <name>${project.artifactId}</name>
   <description>Process Engine Worker</description>
   <url>https://github.com/bpm-crafters/process-engine-worker/</url>
@@ -46,11 +46,6 @@
         <artifactId>mockito-kotlin</artifactId>
         <version>${mockito.version}</version>
       </dependency>
-      <dependency>
-        <groupId>com.tngtech.archunit</groupId>
-        <artifactId>archunit-junit5</artifactId>
-        <version>${archunit.version}</version>
-      </dependency>
     </dependencies>
   </dependencyManagement>
 
@@ -194,7 +189,7 @@
       <organizationUrl>https://holisticon.de</organizationUrl>
     </developer>
     <developer>
-      <id>__</id>
+      <id>stephanpelikan</id>
       <name>Stephan Pelikan</name>
       <roles>
         <role>Developer</role>
@@ -212,7 +207,7 @@
       <organizationUrl>https://phactum.at</organizationUrl>
     </developer>
     <developer>
-      <id>__</id>
+      <id>dominikhorn93</id>
       <name>Dominik Horn</name>
       <roles>
         <role>Developer</role>
@@ -221,13 +216,22 @@
       <organizationUrl>https://miragon.com</organizationUrl>
     </developer>
     <developer>
-      <id>__</id>
-      <name>Thomas Hinrichs</name>
+      <id>Hafflgav</id>
+      <name>Thomas Heinrichs</name>
       <roles>
         <role>Developer</role>
       </roles>
       <organization>Miragon</organization>
       <organizationUrl>https://miragon.com</organizationUrl>
     </developer>
+    <developer>
+      <id>emaarco</id>
+      <name>Marco Schäck</name>
+      <roles>
+        <role>Developer</role>
+      </roles>
+      <organization>Miragon</organization>
+      <organizationUrl>https://miragon.io</organizationUrl>
+    </developer>
   </developers>
 </project>
diff --git a/spring-boot-starter/pom.xml b/spring-boot-starter/pom.xml
@@ -4,7 +4,7 @@
   <parent>
     <groupId>dev.bpm-crafters.process-engine-worker</groupId>
     <artifactId>process-engine-worker-root</artifactId>
-    <version>0.7.0</version>
+    <version>0.7.1</version>
   </parent>
 
   <artifactId>process-engine-worker-spring-boot-starter</artifactId>
@@ -72,6 +72,11 @@
       <groupId>com.fasterxml.jackson.datatype</groupId>
       <artifactId>jackson-datatype-jsr310</artifactId>
     </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-configuration-processor</artifactId>
+      <optional>true</optional>
+    </dependency>
 
     <!-- Testing -->
     <dependency>
@@ -126,4 +131,33 @@
     </dependency>
   </dependencies>
 
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.jetbrains.kotlin</groupId>
+        <artifactId>kotlin-maven-plugin</artifactId>
+        <executions>
+          <execution>
+            <id>kapt</id>
+            <goals>
+              <goal>kapt</goal>
+            </goals>
+            <configuration>
+              <sourceDirs>
+                <sourceDir>src/main/kotlin</sourceDir>
+              </sourceDirs>
+              <annotationProcessorPaths>
+                <annotationProcessorPath>
+                  <groupId>org.springframework.boot</groupId>
+                  <artifactId>spring-boot-configuration-processor</artifactId>
+                  <version>${spring-boot.version}</version>
+                </annotationProcessorPath>
+              </annotationProcessorPaths>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
+    </plugins>
+  </build>
+
 </project>
diff --git a/spring-boot-starter/src/main/kotlin/dev/bpmcrafters/processengine/worker/FailJobException.kt b/spring-boot-starter/src/main/kotlin/dev/bpmcrafters/processengine/worker/FailJobException.kt
@@ -4,7 +4,7 @@ import java.time.Duration
 
 /**
  * Exception for failing a job.
- * Allows to set the available retries and the backoff time for the retry.
+ * Allows setting the available retries and the backoff time for the retry.
  */
 class FailJobException(
   message: String,
diff --git a/spring-boot-starter/src/main/kotlin/dev/bpmcrafters/processengine/worker/configuration/ProcessEngineWorkerAutoConfiguration.kt b/spring-boot-starter/src/main/kotlin/dev/bpmcrafters/processengine/worker/configuration/ProcessEngineWorkerAutoConfiguration.kt
@@ -6,7 +6,6 @@ import dev.bpmcrafters.processengine.worker.registrar.metrics.ProcessEngineWorke
 import dev.bpmcrafters.processengine.worker.registrar.metrics.ProcessEngineWorkerMetricsNoOp
 import io.micrometer.core.instrument.MeterRegistry
 import org.springframework.boot.autoconfigure.condition.ConditionalOnBean
-import org.springframework.boot.autoconfigure.condition.ConditionalOnClass
 import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean
 import org.springframework.boot.context.properties.EnableConfigurationProperties
 import org.springframework.context.annotation.Bean
@@ -25,11 +24,15 @@ class ProcessEngineWorkerAutoConfiguration {
    */
   @Bean
   @ConditionalOnMissingBean
-  fun defaultJacksonVariableConverter(objectMapper: ObjectMapper): VariableConverter = JacksonVariableConverter(objectMapper = objectMapper)
+  fun defaultJacksonVariableConverter(
+    objectMapper: ObjectMapper,
+  ): VariableConverter = JacksonVariableConverter(
+    objectMapper = objectMapper
+  )
 
   /**
    * Initializes parameter resolver.
-   * If you want to add your own parameter resolver, just create your own parameter resolver and expose it as bean. You might want
+   * If you want to add your own parameter resolver, create your own parameter resolver and expose it as bean. You might want
    * to register your own strategies using the [ParameterResolver.ParameterResolverBuilder#addStrategy] method.
    */
   @Bean
@@ -38,15 +41,15 @@ class ProcessEngineWorkerAutoConfiguration {
 
   /**
    * Initializes result resolver.
-   * If you want to add your own result resolver, just create you own result resolver and expose it as a bean. You might want
-   * to register you own strategy using [ResultResolver.ResultResolverBuilder#addStrategy] method.
+   * If you want to add your own result resolver, create your own result resolver and expose it as a bean.
+   * You might want to register your own strategy using the [ResultResolver.ResultResolverBuilder#addStrategy] method.
    */
   @Bean
   @ConditionalOnMissingBean
   fun defaultResultResolver() = ResultResolver.builder().build()
 
   /**
-   * Micrometer based metrics.
+   * Micrometer-based metrics.
    */
   @Bean
   @ConditionalOnBean(MeterRegistry::class)
diff --git a/spring-boot-starter/src/main/kotlin/dev/bpmcrafters/processengine/worker/configuration/ProcessEngineWorkerDeploymentAutoConfiguration.kt b/spring-boot-starter/src/main/kotlin/dev/bpmcrafters/processengine/worker/configuration/ProcessEngineWorkerDeploymentAutoConfiguration.kt
@@ -32,20 +32,23 @@ class ProcessEngineWorkerDeploymentAutoConfiguration {
   ) = ProcessDeployment(
     resourcePatternResolver = resourcePatternResolver,
     deploymentApi = deploymentApi,
-    processEngineWorkerDeploymentProperties = processEngineWorkerDeploymentProperties
+    deploymentProperties = processEngineWorkerDeploymentProperties
   )
 
   /**
    * Configures a trigger for auto-deployment triggered by application start event.
    */
   @ConditionalOnProperty(
-    prefix = ProcessEngineWorkerDeploymentProperties.PREFIX,
+    prefix = ProcessEngineWorkerDeploymentProperties.DEFAULT_PREFIX,
     name = ["enabled"],
     havingValue = "true",
     matchIfMissing = false
   )
   @Bean
-  fun autoDeploymentOnStartup(processDeployment: ProcessDeployment) =
-    AutoDeploymentOnStartup(processDeployment = processDeployment)
+  fun autoDeploymentOnStartup(
+    processDeployment: ProcessDeployment
+  ) = AutoDeploymentOnStartup(
+    processDeployment = processDeployment
+  )
 
 }
diff --git a/spring-boot-starter/src/main/kotlin/dev/bpmcrafters/processengine/worker/configuration/ProcessEngineWorkerDeploymentProperties.kt b/spring-boot-starter/src/main/kotlin/dev/bpmcrafters/processengine/worker/configuration/ProcessEngineWorkerDeploymentProperties.kt
@@ -1,31 +1,33 @@
 package dev.bpmcrafters.processengine.worker.configuration
 
-import dev.bpmcrafters.processengine.worker.configuration.ProcessEngineWorkerDeploymentProperties.Companion.PREFIX
+import dev.bpmcrafters.processengine.worker.configuration.ProcessEngineWorkerDeploymentProperties.Companion.DEFAULT_PREFIX
 import org.springframework.boot.context.properties.ConfigurationProperties
+import org.springframework.validation.annotation.Validated
 
 /**
  * Configuration properties for the deployment feature.
  */
-@ConfigurationProperties(prefix = PREFIX)
-class ProcessEngineWorkerDeploymentProperties(
+@Validated
+@ConfigurationProperties(prefix = DEFAULT_PREFIX)
+data class ProcessEngineWorkerDeploymentProperties(
   /**
    * Pattern to scan for BPMN resources.
    */
-  val bpmnResourcePattern: String = "classpath*:/**/*.bpmn",
+  var bpmnResourcePattern: String = "classpath*:/**/*.bpmn",
   /**
    * Pattern to scan fo DMN resources.
    */
-  val dmnResourcePattern: String = "classpath*:/**/*.dmn",
+  var dmnResourcePattern: String = "classpath*:/**/*.dmn",
   /**
    * Flag to control if the feature is active, defaults to `false`.
    */
-  val enabled: Boolean = false,
+  var enabled: Boolean = false,
   /**
    * Deployment timeout, defaults to 30 seconds.
    */
-  val deploymentTimeoutInSeconds: Long = 30,
+  var deploymentTimeoutInSeconds: Long = 30,
 ) {
   companion object {
-    const val PREFIX = ProcessEngineWorkerProperties.PREFIX + ".deployment"
+    const val DEFAULT_PREFIX = ProcessEngineWorkerProperties.DEFAULT_PREFIX + ".deployment"
   }
 }
diff --git a/spring-boot-starter/src/main/kotlin/dev/bpmcrafters/processengine/worker/configuration/ProcessEngineWorkerProperties.kt b/spring-boot-starter/src/main/kotlin/dev/bpmcrafters/processengine/worker/configuration/ProcessEngineWorkerProperties.kt
diff --git a/spring-boot-starter/src/main/kotlin/dev/bpmcrafters/processengine/worker/process/AutoDeploymentOnStartup.kt b/spring-boot-starter/src/main/kotlin/dev/bpmcrafters/processengine/worker/process/AutoDeploymentOnStartup.kt
diff --git a/spring-boot-starter/src/main/kotlin/dev/bpmcrafters/processengine/worker/process/ProcessDeployment.kt b/spring-boot-starter/src/main/kotlin/dev/bpmcrafters/processengine/worker/process/ProcessDeployment.kt
diff --git a/spring-boot-starter/src/main/kotlin/dev/bpmcrafters/processengine/worker/registrar/ProcessEngineStarterRegistrar.kt b/spring-boot-starter/src/main/kotlin/dev/bpmcrafters/processengine/worker/registrar/ProcessEngineStarterRegistrar.kt
diff --git a/spring-boot-starter/src/test/kotlin/dev/bpmcrafters/processengine/worker/registrar/ProcessEngineRegistrarRetryTest.kt b/spring-boot-starter/src/test/kotlin/dev/bpmcrafters/processengine/worker/registrar/ProcessEngineRegistrarRetryTest.kt

-Original file line number
+Diff line change
 ### DEV
 _tmp/
 .repository/
 +.claude