add message utility class

Author: J4C0B3Y

core/src/main/java/net/j4c0b3y/api/config/ConfigHandler.java

@@ -12,6 +12,7 @@
 import lombok.Getter;
 import lombok.Setter;
 import net.j4c0b3y.api.config.exception.MissingProviderException;
+import net.j4c0b3y.api.config.message.Message;
 import net.j4c0b3y.api.config.provider.TypeProvider;
 import net.j4c0b3y.api.config.provider.impl.*;
 import net.j4c0b3y.api.config.resolver.TypeResolver;
@@ -122,6 +123,7 @@ public ConfigHandler(Logger logger) {
         bind(short.class, new NumberProvider<>(Short::parseShort));
 
         bind(boolean.class, new BooleanProvider());
+        bind(Message.class, new MessageProvider());
     }
 
     /**

core/src/main/java/net/j4c0b3y/api/config/message/Message.java

@@ -0,0 +1,54 @@
+package net.j4c0b3y.api.config.message;
+
+import lombok.Getter;
+
+import java.util.*;
+import java.util.function.Consumer;
+import java.util.function.Function;
+import java.util.function.Predicate;
+
+/**
+ * @author J4C0B3Y
+ * @version ConfigAPI
+ * @since 9/03/2025
+ */
+@Getter
+public class Message {
+    private final List<String> lines;
+    private final boolean initial;
+
+    private Message(Collection<String> lines, boolean initial) {
+        this.lines = new ArrayList<>(lines);
+        this.initial = initial;
+    }
+
+    public static Message of(Collection<String> lines) {
+        return new Message(lines, true);
+    }
+
+    public static Message of(String... lines) {
+        return new Message(Arrays.asList(lines), true);
+    }
+
+    private Message supply(Consumer<List<String>> consumer) {
+        Message message = initial ? new Message(lines, false) : this;
+        consumer.accept(message.lines);
+        return message;
+    }
+
+    public Message map(Function<String, String> mapper) {
+        return supply(lines -> lines.replaceAll(mapper::apply));
+    }
+
+    public Message filter(Predicate<String> filter) {
+        return supply(lines -> lines.removeIf(filter));
+    }
+
+    public Message replace(String target, String replacement) {
+        return map(line -> line.replaceAll(target, replacement));
+    }
+
+    public void send(Consumer<String> consumer) {
+        this.lines.forEach(consumer);
+    }
+}

core/src/main/java/net/j4c0b3y/api/config/provider/impl/MessageProvider.java

@@ -0,0 +1,44 @@
+package net.j4c0b3y.api.config.provider.impl;
+
+import net.j4c0b3y.api.config.message.Message;
+import net.j4c0b3y.api.config.provider.TypeProvider;
+import net.j4c0b3y.api.config.provider.context.LoadContext;
+import net.j4c0b3y.api.config.provider.context.SaveContext;
+
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * @author J4C0B3Y
+ * @version ConfigAPI
+ * @since 9/03/2025
+ */
+public class MessageProvider implements TypeProvider<Message> {
+
+    @Override
+    public Message load(LoadContext context) {
+        if (context.getObject() instanceof Collection) {
+            List<String> parsed = new ArrayList<>();
+
+            for (Object object : (Collection<?>) context.getObject()) {
+                parsed.add(String.valueOf(object));
+            }
+
+            return Message.of(parsed);
+        }
+
+        return Message.of(String.valueOf(context.getObject()));
+    }
+
+    @Override
+    public Object save(SaveContext<Message> context) {
+        Message message = context.getObject();
+
+        if (message.getLines().size() == 1) {
+            return message.getLines().get(0);
+        }
+
+        return message.getLines();
+    }
+}