Add sneakyThrow method to OfficeStamperException class

This method encapsulates and throws provided exceptions as an OfficeStamperException. It improves error handling by standardizing the way unexpected errors are thrown and logged. This addition also enhances code readability and maintainability.

engine/src/main/java/pro/verron/officestamper/api/OfficeStamperException.java

@@ -2,8 +2,7 @@
 
 /**
  * OfficeStamperException is a subclass of RuntimeException that represents an exception that can be thrown during the
- * processing of an Office document using the OfficeStamper library
- * .
+ * processing of an Office document using the OfficeStamper library.
  * It provides additional constructors to handle different scenarios.
  */
 public class OfficeStamperException
@@ -51,4 +50,15 @@ public OfficeStamperException(String message, Throwable cause) {
     public OfficeStamperException() {
         super("Unexpected exception");
     }
+
+    /**
+     * Throws an OfficeStamperException encapsulating the provided exception.
+     *
+     * @param exception the exception to be thrown
+     * @return this method does not return a value; it always throws an exception
+     * @throws OfficeStamperException always thrown to indicate an unexpected error.
+     */
+    public static <T> T sneakyThrow(Exception exception) {
+        throw new OfficeStamperException("Unexpected error", exception);
+    }
 }