From fa281b046971aaece4f2d620aee821a1a7473eb6 Mon Sep 17 00:00:00 2001
From: jenkinsEdificePublic <sre@edifice.io>
Date: Mon, 16 Feb 2026 16:36:52 +0100
Subject: [PATCH 1/4] chore: prepare next development iteration

---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index b7a7374..334e63f 100644
--- a/pom.xml
+++ b/pom.xml
@@ -12,7 +12,7 @@
 
     <groupId>fr.wseduc</groupId>
     <artifactId>web-utils</artifactId>
-    <version>3.3-SNAPSHOT</version>
+    <version>3.3-develop-b2school-SNAPSHOT</version>
 
     <repositories>
         <repository>

From e1d16d44a76f2f4f42977284e96a4141f9358daa Mon Sep 17 00:00:00 2001
From: vbillard91 <vincent.billard@edifice.io>
Date: Fri, 24 Apr 2026 14:30:52 +0200
Subject: [PATCH 2/4] feat: #COCO-5668 add method to make stateless
 TemplateProcessor

* chore: prepare next development iteration

* chore: prepare next development iteration

*

---------

Co-authored-by: jenkinsEdificePublic <sre@edifice.io>
---
 .../template/FileTemplateProcessor.java       | 14 +++++--
 .../webutils/template/TemplateProcessor.java  | 39 +++++++++++++++----
 2 files changed, 41 insertions(+), 12 deletions(-)

diff --git a/src/main/java/fr/wseduc/webutils/template/FileTemplateProcessor.java b/src/main/java/fr/wseduc/webutils/template/FileTemplateProcessor.java
index 9bd2d87..c2a4401 100644
--- a/src/main/java/fr/wseduc/webutils/template/FileTemplateProcessor.java
+++ b/src/main/java/fr/wseduc/webutils/template/FileTemplateProcessor.java
@@ -82,17 +82,23 @@ public void processTemplate(String resourceName, JsonObject params, Reader r, fi
       this.processTemplateToWriter(resourceName, params, handler);
   }
 
+  public void processTemplate(String resourceName, JsonObject params, Reader r, Map<String, Mustache.Lambda> lambdas, final Handler<Writer> handler)
+  {
+    if(r != null)
+      this.processTemplate(compiler.compile(r), params, lambdas, handler);
+    else
+      this.processTemplateToWriter(resourceName, params, lambdas, handler);
+  }
+
   @Override
   protected void getTemplate(String resourceName, final Handler<Template> handler)
   {
     String path = this.templateFolder + resourceName;
 
     final String p = absolutePath(path);
-    if (this.useCache == true)
-    {
+    if (this.useCache) {
       Template cacheEntry = cache.get(p);
-      if(cacheEntry != null)
-      {
+      if(cacheEntry != null) {
         handler.handle(cacheEntry);
         return;
       }
diff --git a/src/main/java/fr/wseduc/webutils/template/TemplateProcessor.java b/src/main/java/fr/wseduc/webutils/template/TemplateProcessor.java
index 8f5176f..92f1583 100644
--- a/src/main/java/fr/wseduc/webutils/template/TemplateProcessor.java
+++ b/src/main/java/fr/wseduc/webutils/template/TemplateProcessor.java
@@ -93,14 +93,17 @@ public void handle(Writer w)
 
   public void processTemplateToWriter(String templateString, JsonObject params, final Handler<Writer> handler)
   {
-    this.getTemplate(templateString, new Handler<Template>()
-    {
-      @Override
-      public void handle(Template t)
-      {
-        processTemplate(t, params, handler);
-      }
-    });
+    this.getTemplate(templateString, t -> processTemplate(t, params, handler));
+  }
+
+  public void processTemplate(String templateString, JsonObject params, Map<String, Mustache.Lambda> lambdas, final Handler<String> handler)
+  {
+    this.processTemplateToWriter(templateString, params, lambdas, w -> handler.handle(w == null ? null : w.toString()));
+  }
+
+  public void processTemplateToWriter(String templateString, JsonObject params, Map<String, Mustache.Lambda> lambdas, final Handler<Writer> handler)
+  {
+    this.getTemplate(templateString, t -> processTemplate(t, params, lambdas, handler));
   }
 
   protected void processTemplate(Template t, JsonObject params, final Handler<Writer> handler)
@@ -127,6 +130,26 @@ protected void processTemplate(Template t, JsonObject params, final Handler<Writ
       handler.handle(null);
   }
 
+  protected void processTemplate(Template t, JsonObject params, Map<String, Mustache.Lambda> lambdas, final Handler<Writer> handler)
+  {
+    final JsonObject ctxParams = (params == null) ? new JsonObject() : params.copy();
+    final Map<String, Object> ctx = JsonUtils.convertMap(ctxParams);
+    ctx.putAll(lambdas);
+
+    if (t != null) {
+      try {
+        Writer writer = new StringWriter();
+        t.execute(ctx, writer);
+        handler.handle(writer);
+      } catch (Exception e) {
+        log.error(e.getMessage(), e);
+        handler.handle(null);
+      }
+    } else {
+      handler.handle(null);
+    }
+  }
+
   protected void getTemplate(String templateString, final Handler<Template> handler)
   {
     handler.handle(compiler.compile(templateString));

From 75e8701724b750f2f425ac3fdf1edd8a5dade906 Mon Sep 17 00:00:00 2001
From: Vincent Billard <vincent.billard@edifice.io>
Date: Thu, 7 May 2026 15:40:07 +0200
Subject: [PATCH 3/4] feat: #ENABLING-726 add utils to manipulate DTO in
 cotnroller

---
 .../java/fr/wseduc/webutils/Controller.java   | 22 +++++++++++++++++--
 src/main/java/fr/wseduc/webutils/Utils.java   | 12 ++++++++++
 .../wseduc/webutils/http/BaseController.java  |  3 +--
 3 files changed, 33 insertions(+), 4 deletions(-)

diff --git a/src/main/java/fr/wseduc/webutils/Controller.java b/src/main/java/fr/wseduc/webutils/Controller.java
index 584a7eb..cb5625e 100644
--- a/src/main/java/fr/wseduc/webutils/Controller.java
+++ b/src/main/java/fr/wseduc/webutils/Controller.java
@@ -20,7 +20,6 @@
 import fr.wseduc.webutils.http.HttpMethod;
 import fr.wseduc.webutils.http.Renders;
 import fr.wseduc.webutils.http.TraceIdContextHandler;
-import fr.wseduc.webutils.request.AccessLogger;
 import fr.wseduc.webutils.request.AccessLoggerFactory;
 import fr.wseduc.webutils.request.IAccessLogger;
 import fr.wseduc.webutils.request.filter.SecurityHandler;
@@ -33,6 +32,7 @@
 import io.vertx.core.eventbus.EventBus;
 import io.vertx.core.eventbus.Message;
 import io.vertx.core.http.HttpServerRequest;
+import io.vertx.core.json.JsonArray;
 import io.vertx.core.json.JsonObject;
 import org.apache.commons.lang3.time.StopWatch;
 import org.vertx.java.core.http.RouteMatcher;
@@ -44,8 +44,10 @@
 import java.util.*;
 import java.util.Map.Entry;
 import java.util.concurrent.TimeUnit;
+import java.util.function.Function;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
+import java.util.stream.Collectors;
 
 public abstract class Controller extends Renders {
 
@@ -78,7 +80,7 @@ public Controller(Vertx vertx, JsonObject config, RouteMatcher rm,
 	}
 
 	protected void init(Vertx vertx, JsonObject config, RouteMatcher rm,
-	Map<String, SecuredAction> securedActions)
+						Map<String, SecuredAction> securedActions)
 	{
 		super.init(vertx, config);
 		this.rm = rm;
@@ -452,6 +454,22 @@ private String addPathPrefix(String pattern) {
 		return pathPrefix + pattern.trim();
 	}
 
+	/**
+	 * Take a json array of jsonObject, appy the mapper to enforce contract, then serialize the result back to jsonObject
+	 * to be send on the event bus
+	 * @param arr List of JsonObject from database
+	 * @param mapper Mapper to convert / filter JsonObject to a specific T class
+	 * @return JsonArray of serialized T on JsonObject
+	 * @param <T>
+	 */
+	public static <T> JsonArray serializeForBus(JsonArray arr, Function<JsonObject, T> mapper) {
+		return new JsonArray(arr.stream()
+				.map(JsonObject.class::cast)
+				.map(mapper)
+				.map(JsonObject::mapFrom)
+				.collect(Collectors.toList()));
+	}
+
 	public void setAccessLogger(IAccessLogger accessLogger) {
 		this.accessLogger = accessLogger;
 	}
diff --git a/src/main/java/fr/wseduc/webutils/Utils.java b/src/main/java/fr/wseduc/webutils/Utils.java
index 338aab9..62327df 100644
--- a/src/main/java/fr/wseduc/webutils/Utils.java
+++ b/src/main/java/fr/wseduc/webutils/Utils.java
@@ -18,8 +18,10 @@
 
 import fr.wseduc.webutils.eventbus.ResultMessage;
 import io.vertx.core.AsyncResult;
+import io.vertx.core.Future;
 import io.vertx.core.Handler;
 import io.vertx.core.MultiMap;
+import io.vertx.core.Promise;
 import io.vertx.core.eventbus.Message;
 import io.vertx.core.json.JsonArray;
 import io.vertx.core.json.JsonObject;
@@ -28,6 +30,7 @@
 import java.util.List;
 import java.util.Map;
 import java.util.Scanner;
+import java.util.function.Consumer;
 
 public class Utils {
 
@@ -199,4 +202,13 @@ public static Handler<AsyncResult<Message<JsonObject>>> handlerToAsyncHandler(Ha
 		};
 	}
 
+	public static <T> Future<T> eitherToFuture(Consumer<Handler<Either<String, T>>> call) {
+		Promise<T> promise = Promise.promise();
+		call.accept(res -> {
+			if (res.isRight()) promise.complete(res.right().getValue());
+			else promise.fail(res.left().getValue());
+		});
+		return promise.future();
+	}
+
 }
diff --git a/src/main/java/fr/wseduc/webutils/http/BaseController.java b/src/main/java/fr/wseduc/webutils/http/BaseController.java
index 4118bad..1d28cc4 100644
--- a/src/main/java/fr/wseduc/webutils/http/BaseController.java
+++ b/src/main/java/fr/wseduc/webutils/http/BaseController.java
@@ -17,7 +17,6 @@
 package fr.wseduc.webutils.http;
 
 import fr.wseduc.webutils.Controller;
-import fr.wseduc.webutils.Server;
 import fr.wseduc.webutils.security.SecuredAction;
 import io.vertx.core.Future;
 import io.vertx.core.Vertx;
@@ -37,7 +36,7 @@ public BaseController() {
 		this(null, null, null, null);
 	}
 
-	public void init(Vertx vertx, JsonObject config, RouteMatcher rm,
+    public void init(Vertx vertx, JsonObject config, RouteMatcher rm,
 					 Map<String, SecuredAction> securedActions) {
     super.init(vertx, config, rm, securedActions);
 	}

From 55fe4a5ba906aef112ed01104d624fe1b86d6d6a Mon Sep 17 00:00:00 2001
From: Vincent Billard <vincent.billard@edifice.io>
Date: Wed, 13 May 2026 11:35:59 +0200
Subject: [PATCH 4/4] add javadoc on eitherToFuture

---
 src/main/java/fr/wseduc/webutils/Utils.java | 22 +++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/src/main/java/fr/wseduc/webutils/Utils.java b/src/main/java/fr/wseduc/webutils/Utils.java
index 62327df..538b4c4 100644
--- a/src/main/java/fr/wseduc/webutils/Utils.java
+++ b/src/main/java/fr/wseduc/webutils/Utils.java
@@ -202,6 +202,28 @@ public static Handler<AsyncResult<Message<JsonObject>>> handlerToAsyncHandler(Ha
 		};
 	}
 
+	/**
+	 * Bridges a legacy callback-based service method (using {@link Either}) into a Vert.x {@link Future}.
+	 * <p>
+	 * Many service methods in this codebase accept a {@code Handler<Either<String, T>>} as their last
+	 * argument, where a {@link Either.Left} signals failure (with an error message) and a
+	 * {@link Either.Right} signals success (with the result value). This utility wraps such a call
+	 * into a {@link Future} so it can be composed with other async operations.
+	 *
+	 * <pre>{@code
+	 * // Given a service method:
+	 * //   void findUser(String id, Handler<Either<String, JsonObject>> handler)
+	 *
+	 * Utils.eitherToFuture(handler -> userService.findUser(userId, handler))
+	 *     .compose(user -> Utils.eitherToFuture(handler -> roleService.getRoles(user.getString("id"), handler)))
+	 *     .onSuccess(roles -> renderJson(request, roles))
+	 *     .onFailure(err -> renderError(request, err));
+	 * }</pre>
+	 *
+	 * @param call a consumer that invokes the legacy service method, passing along the provided handler
+	 * @param <T>  the type of the success value
+	 * @return a {@link Future} that completes with the right value on success, or fails with the left message on error
+	 */
 	public static <T> Future<T> eitherToFuture(Consumer<Handler<Either<String, T>>> call) {
 		Promise<T> promise = Promise.promise();
 		call.accept(res -> {