feat: add MetadataPropertiesProvider foundation

Author: dieppa

core/flamingock-core-commons/src/main/java/io/flamingock/internal/common/core/metadata/FlamingockMetadata.java

@@ -17,19 +17,24 @@
 
 import io.flamingock.internal.common.core.preview.PreviewPipeline;
 
+import java.util.HashMap;
+import java.util.Map;
+
 public class FlamingockMetadata {
 
     private PreviewPipeline pipeline;
     private String setup;
     private String configFile;
+    private Map<String, String> properties;
 
     public FlamingockMetadata() {
     }
 
-    public FlamingockMetadata(PreviewPipeline pipeline, String setup, String configFile) {
+    public FlamingockMetadata(PreviewPipeline pipeline, String setup, String configFile, Map<String, String> properties) {
         this.pipeline = pipeline;
         this.setup = setup;
         this.configFile = configFile;
+        this.properties = properties != null ? properties : new HashMap<>();
     }
 
     public PreviewPipeline getPipeline() {
@@ -56,11 +61,28 @@ public void setPipelineFile(String configFile) {
         this.configFile = configFile;
     }
 
+    public String getConfigFile() {
+        return configFile;
+    }
+
+    public void setConfigFile(String configFile) {
+        this.configFile = configFile;
+    }
+
+    public Map<String, String> getProperties() {
+        return properties;
+    }
+
+    public void setProperties(Map<String, String> properties) {
+        this.properties = properties;
+    }
+
     @Override
     public String toString() {
         return "FlamingockMetadata{" + "pipeline=" + pipeline +
                 ", setup='" + setup + '\'' +
                 ", configFile='" + configFile + '\'' +
+                ", properties=" + properties +
                 '}';
     }
 }

core/flamingock-core-commons/src/main/java/io/flamingock/internal/common/core/metadata/MetadataPropertiesProvider.java

@@ -0,0 +1,25 @@
+/*
+ * Copyright 2025 Flamingock (https://www.flamingock.io)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package io.flamingock.internal.common.core.metadata;
+
+import io.flamingock.internal.common.core.util.LoggerPreProcessor;
+
+import javax.annotation.processing.RoundEnvironment;
+import java.util.Map;
+
+public interface MetadataPropertiesProvider {
+    Map<String, String> getProperties(RoundEnvironment roundEnv, LoggerPreProcessor logger);
+}

core/flamingock-processor/src/main/java/io/flamingock/core/processor/FlamingockAnnotationProcessor.java

@@ -20,6 +20,7 @@
 import io.flamingock.api.annotations.EnableFlamingock;
 import io.flamingock.api.annotations.Stage;
 import io.flamingock.core.processor.util.AnnotationFinder;
+import io.flamingock.core.processor.util.MetadataPropertiesLoader;
 import io.flamingock.core.processor.util.PathResolver;
 import io.flamingock.core.processor.util.ProjectRootDetector;
 import io.flamingock.internal.common.core.preview.CodePreviewChange;
@@ -212,7 +213,8 @@ public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment
         Serializer serializer = new Serializer(processingEnv, logger);
         String setup = flamingockAnnotation.setup().toString();
         String configFile = flamingockAnnotation.configFile();
-        FlamingockMetadata flamingockMetadata = new FlamingockMetadata(pipeline, setup, configFile);
+        Map<String, String> properties = MetadataPropertiesLoader.loadAllProperties(roundEnv, logger);
+        FlamingockMetadata flamingockMetadata = new FlamingockMetadata(pipeline, setup, configFile, properties);
         serializer.serializeFullPipeline(flamingockMetadata);
 
         // Generate summary - count all changes from the final pipeline (code-based + template-based)

core/flamingock-processor/src/main/java/io/flamingock/core/processor/util/MetadataPropertiesLoader.java

@@ -0,0 +1,58 @@
+/*
+ * Copyright 2025 Flamingock (https://www.flamingock.io)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package io.flamingock.core.processor.util;
+
+import io.flamingock.internal.common.core.metadata.MetadataPropertiesProvider;
+import io.flamingock.internal.common.core.util.LoggerPreProcessor;
+
+import java.util.LinkedHashMap;
+import java.util.Map;
+import java.util.Objects;
+import java.util.ServiceLoader;
+import javax.annotation.processing.RoundEnvironment;
+public final class MetadataPropertiesLoader {
+    public static Map<String, String> loadAllProperties(RoundEnvironment roundEnv, LoggerPreProcessor logger) {
+        Map<String, String> result = new LinkedHashMap<>();
+
+        ServiceLoader<MetadataPropertiesProvider> loader =
+                ServiceLoader.load(MetadataPropertiesProvider.class, MetadataPropertiesLoader.class.getClassLoader());
+
+        for (MetadataPropertiesProvider provider : loader) {
+            Map<String, String> props = provider.getProperties(roundEnv, logger);
+            if (props == null || props.isEmpty()) {
+                continue;
+            }
+
+            for (Map.Entry<String, String> entry : props.entrySet()) {
+                String key = entry.getKey();
+                String value = entry.getValue();
+
+                String previous = result.put(key, value);
+                if (previous != null && !Objects.equals(previous, value)) {
+                    String message = String.format("%s overrides key '%s' "
+                                    + "previous value='%s' new value='%s'",
+                            provider.getClass().getName(),
+                            key,
+                            previous,
+                            value);
+                    logger.warn(message);
+                }
+            }
+        }
+
+        return result;
+    }
+}

platform-plugins/flamingock-springboot-integration/src/test/java/io/flamingock/springboot/FlamingockAutoConfigurationTests.java

@@ -96,7 +96,7 @@ void runnerBeanRegisteredWhenSetupAbsent(@TempDir Path dir) throws IOException {
     void runnerBeanNotRegisteredWhenSetupBuilder() throws IOException {
         // replace the supplier so the Condition "sees" BUILDER
         OnFlamingockEnabledCondition.setMetadataSupplier(
-                () -> Optional.of(new FlamingockMetadata(null, "BUILDER", null))
+                () -> Optional.of(new FlamingockMetadata(null, "BUILDER", null, null))
         );
 
         contextEmpty().run(ctx -> assertThat(ctx).doesNotHaveBean("flamingock-runner"));