Rename gateway customization API to extension API

Rename gateway customization API to extension API

Author: andimarek

README.md

@@ -16,7 +16,7 @@ It works best overall when used together with the feddi Platform. For full docum
 
 - `gateway/engine` - Composition, validation, query planning, and execution
 - `gateway/app` - Spring Boot application that serves the feddi Gateway over HTTP
-- `gateway/customization-api` - Public extension API for integrating custom behavior
+- `gateway/extension-api` - Public extension API for integrating gateway behavior
 - `e2e-tests` - Docker-based end-to-end tests
 - `scripts` - Helper scripts for common local workflows
 
@@ -105,7 +105,7 @@ The feddi Gateway itself recognizes the namespace and forwards its configuration
 
 The default runtime source accepts feddi Gateway definitions through `POST /admin/upload` as multipart form data with a `file` part containing a ZIP archive.
 
-If a custom `FeddiGatewayDefinitionSource` extension is installed and active, ZIP uploads are disabled.
+If an extension-provided `FeddiGatewayDefinitionSource` is installed and active, ZIP uploads are disabled.
 
 Accepted ZIP layouts:
 
@@ -148,7 +148,7 @@ Each subgraph entry must contain:
 - `schema.graphqls`
 - `config.yaml` or `config.yml`
 
-For the built-in subgraph client, `url` is the only consumed subgraph config key. Custom `SubgraphClientFactory` implementations can read additional keys from the same per-subgraph config map.
+For the built-in subgraph client, `url` is the only consumed subgraph config key. Extension-provided `SubgraphClientFactory` implementations can read additional keys from the same per-subgraph config map.
 
 ### Launcher Environment Variables
 
@@ -185,11 +185,11 @@ cd gateway
 ./gradlew :app:integrationTest
 ```
 
-If you run `e2e-tests` directly (without `./scripts/run-e2e-tests.sh`) after changing `feddi-gateway/customization-api`, publish the API to your local Maven repository first so the e2e-tests subproject can resolve it:
+If you run `e2e-tests` directly (without `./scripts/run-e2e-tests.sh`) after changing `feddi-gateway/extension-api`, publish the API to your local Maven repository first so the e2e-tests subproject can resolve it:
 
 ```bash
 cd gateway
-./gradlew :customization-api:publishToMavenLocal
+./gradlew :extension-api:publishToMavenLocal
 cd ../e2e-tests
 ./gradlew test
 ```

e2e-tests/.gitignore

@@ -7,6 +7,6 @@ build
 # Ignore copied feddi Gateway JAR (build artifact)
 docker/feddi-gateway/*.jar
 
-# Ignore copied customizations JARs (build artifacts)
+# Ignore copied extensions JARs (build artifacts)
 docker/feddi-gateway/libs/
 docker/gateway/libs/

e2e-tests/build.gradle

@@ -77,24 +77,19 @@ tasks.register('copyFeddiGatewayJar', Copy) {
     }
 }
 
-// Task to copy the customizations JAR for Docker build
-tasks.register('copyCustomizationsJar', Copy) {
-    description = 'Copies the customizations JAR for Docker build'
-    dependsOn ':customizations:jar'
+// Task to copy the extensions JAR for Docker build
+tasks.register('copyExtensionsJar', Sync) {
+    description = 'Copies the extensions JAR for Docker build'
+    dependsOn ':extensions:jar'
 
-    def customizationsJarDir = file("${projectDir}/customizations/build/libs")
+    def extensionsJarDir = file("${projectDir}/extensions/build/libs")
     def libsDir = file("${projectDir}/docker/feddi-gateway/libs")
 
-    from(customizationsJarDir) {
+    from(extensionsJarDir) {
         include '*.jar'
     }
     into libsDir
-
-    doFirst {
-        // Ensure libs directory exists
-        libsDir.mkdirs()
-    }
 }
 
 // Ensure JARs are copied before running tests
-test.dependsOn copyFeddiGatewayJar, copyCustomizationsJar
+test.dependsOn copyFeddiGatewayJar, copyExtensionsJar

e2e-tests/customizations/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports

@@ -5,7 +5,7 @@ WORKDIR /app
 # Copy the Spring Boot JAR (copied by Gradle copyFeddiGatewayJar task)
 COPY app.jar app.jar
 
-# Copy customizations JAR (if present)
+# Copy extensions JAR (if present)
 COPY libs/ libs/
 
 # Copy feddi-gateway configuration

e2e-tests/docker/feddi-gateway/Dockerfile

@@ -25,8 +25,8 @@ checkstyle {
 }
 
 dependencies {
-    // Depend on the gateway customization API (published to Maven local)
-    implementation 'dev.feddi.federation:customization-api:1.0-SNAPSHOT'
+    // Depend on the gateway extension API (published to Maven local)
+    implementation 'dev.feddi.federation:extension-api:1.0-SNAPSHOT'
 
     // Spring Boot auto-configuration support
     implementation libs.spring.boot.autoconfigure

e2e-tests/customizations/build.gradle e2e-tests/extensions/build.gradlee2e-tests/customizations/build.gradle renamed to e2e-tests/extensions/build.gradle

@@ -1,12 +1,12 @@
-package e2e.customizations;
+package e2e.extensions;
 
 import com.fasterxml.jackson.annotation.JsonProperty;
 
 /**
- * Configuration for the e2e test customization.
+ * Configuration for the e2e test extension.
  * Deserialized from the {@code extensions.e2e} section of feddi-gateway.yml.
  */
-public class E2eCustomizationConfig {
+public class E2eExtensionConfig {
 
     @JsonProperty("timeout-seconds")
     private int timeoutSeconds = 10;

…stomizations/E2eCustomizationConfig.java …a/e2e/extensions/E2eExtensionConfig.javae2e-tests/customizations/src/main/java/e2e/customizations/E2eCustomizationConfig.java renamed to e2e-tests/extensions/src/main/java/e2e/extensions/E2eExtensionConfig.java e2e-tests/customizations/src/main/java/e2e/customizations/E2eCustomizationConfig.java renamed to e2e-tests/extensions/src/main/java/e2e/extensions/E2eExtensionConfig.java

@@ -1,8 +1,8 @@
-package e2e.customizations;
+package e2e.extensions;
 
 import com.fasterxml.jackson.databind.ObjectMapper;
-import dev.feddi.federation.customization.FeddiGatewayRequestContext;
-import dev.feddi.federation.customization.SubgraphClient;
+import dev.feddi.federation.extension.FeddiGatewayRequestContext;
+import dev.feddi.federation.extension.SubgraphClient;
 import graphql.ErrorClassification;
 import graphql.ErrorType;
 import graphql.ExecutionResult;

…stomizations/JavaHttpSubgraphClient.java …e/extensions/JavaHttpSubgraphClient.javae2e-tests/customizations/src/main/java/e2e/customizations/JavaHttpSubgraphClient.java renamed to e2e-tests/extensions/src/main/java/e2e/extensions/JavaHttpSubgraphClient.java e2e-tests/customizations/src/main/java/e2e/customizations/JavaHttpSubgraphClient.java renamed to e2e-tests/extensions/src/main/java/e2e/extensions/JavaHttpSubgraphClient.java

@@ -1,10 +1,10 @@
-package e2e.customizations;
+package e2e.extensions;
 
 import com.fasterxml.jackson.databind.ObjectMapper;
-import dev.feddi.federation.customization.ConfigurableExtension;
-import dev.feddi.federation.customization.SubgraphClient;
-import dev.feddi.federation.customization.SubgraphClientFactory;
-import dev.feddi.federation.customization.SubgraphSettings;
+import dev.feddi.federation.extension.ConfigurableExtension;
+import dev.feddi.federation.extension.SubgraphClient;
+import dev.feddi.federation.extension.SubgraphClientFactory;
+import dev.feddi.federation.extension.SubgraphSettings;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.boot.autoconfigure.AutoConfiguration;
@@ -15,11 +15,11 @@
 import java.time.Duration;
 
 /**
- * Auto-configuration for the custom Java HttpClient-based SubgraphClientFactory.
+ * Auto-configuration for the extension-provided Java HttpClient-based SubgraphClientFactory.
  * Implements {@link ConfigurableExtension} to receive timeout configuration from feddi-gateway.yml.
  */
 @AutoConfiguration
-public class JavaHttpSubgraphClientFactoryAutoConfiguration implements ConfigurableExtension<E2eCustomizationConfig> {
+public class JavaHttpSubgraphClientFactoryAutoConfiguration implements ConfigurableExtension<E2eExtensionConfig> {
 
     private static final Logger logger = LoggerFactory.getLogger(JavaHttpSubgraphClientFactoryAutoConfiguration.class);
 
@@ -31,20 +31,20 @@ public String configNamespace() {
     }
 
     @Override
-    public Class<E2eCustomizationConfig> configType() {
-        return E2eCustomizationConfig.class;
+    public Class<E2eExtensionConfig> configType() {
+        return E2eExtensionConfig.class;
     }
 
     @Override
-    public void onConfigLoaded(E2eCustomizationConfig config) {
+    public void onConfigLoaded(E2eExtensionConfig config) {
         this.timeoutSeconds = config.getTimeoutSeconds();
-        logger.info("[CUSTOM FACTORY] Configured from feddi-gateway.yml: timeout={}s", timeoutSeconds);
+        logger.info("[EXTENSION FACTORY] Configured from feddi-gateway.yml: timeout={}s", timeoutSeconds);
     }
 
     @Bean
     @Primary
     public SubgraphClientFactory javaHttpSubgraphClientFactory() {
-        logger.info("[CUSTOM FACTORY] JavaHttpSubgraphClientFactory LOADED (timeout={}s)", timeoutSeconds);
+        logger.info("[EXTENSION FACTORY] JavaHttpSubgraphClientFactory LOADED (timeout={}s)", timeoutSeconds);
 
         HttpClient httpClient = HttpClient.newBuilder()
             .connectTimeout(Duration.ofSeconds(timeoutSeconds))
@@ -55,7 +55,7 @@ public SubgraphClientFactory javaHttpSubgraphClientFactory() {
             @Override
             public SubgraphClient create(String subgraphName, SubgraphSettings settings) {
                 String url = settings.config().get("url").toString();
-                logger.info("[CUSTOM FACTORY] Creating client for subgraph '{}' at URL: {}",
+                logger.info("[EXTENSION FACTORY] Creating client for subgraph '{}' at URL: {}",
                     subgraphName, url);
                 return new JavaHttpSubgraphClient(httpClient, objectMapper, url, subgraphName);
             }

…graphClientFactoryAutoConfiguration.java …graphClientFactoryAutoConfiguration.javae2e-tests/customizations/src/main/java/e2e/customizations/JavaHttpSubgraphClientFactoryAutoConfiguration.java renamed to e2e-tests/extensions/src/main/java/e2e/extensions/JavaHttpSubgraphClientFactoryAutoConfiguration.java e2e-tests/customizations/src/main/java/e2e/customizations/JavaHttpSubgraphClientFactoryAutoConfiguration.java renamed to e2e-tests/extensions/src/main/java/e2e/extensions/JavaHttpSubgraphClientFactoryAutoConfiguration.java

@@ -1,7 +1,7 @@
-package e2e.customizations;
+package e2e.extensions;
 
-import dev.feddi.federation.customization.DocumentProvider;
-import dev.feddi.federation.customization.FeddiGatewayRequestContext;
+import dev.feddi.federation.extension.DocumentProvider;
+import dev.feddi.federation.extension.FeddiGatewayRequestContext;
 import graphql.ExecutionInput;
 import graphql.GraphqlErrorBuilder;
 import graphql.execution.preparsed.PreparsedDocumentEntry;