fix: resolve javadoc reference errors causing build failures

integration-tests/tomee/src/main/java/io/roastedroot/proxywasm/jaxrs/it/App.java

@@ -13,10 +13,19 @@
 @ApplicationScoped
 public class App {
 
+    /**
+     * Default constructor.
+     */
+    public App() {
+        // Default constructor for CDI
+    }
+
     private static final Gson gson = new Gson();
 
     /**
      * Configures the headerTests PluginFactory.
+     *
+     * @return a configured PluginFactory for header testing
      */
     @Produces
     public PluginFactory headerTests() {

integration-tests/tomee/src/main/java/io/roastedroot/proxywasm/jaxrs/it/Resources.java

@@ -11,6 +11,13 @@
 @Path("/")
 public class Resources {
 
+    /**
+     * Default constructor.
+     */
+    public Resources() {
+        // Default constructor for JAX-RS
+    }
+
     /**
      * Endpoint for testing header manipulation with a shared Wasm plugin instance.
      *

integration-tests/tomee/src/main/webapp/WEB-INF/beans.xml

@@ -3,4 +3,4 @@
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee
                            https://jakarta.ee/xml/ns/jakartaee/beans_4_0.xsd"
-       version="4.0" bean-discovery-mode="all"/>
+       version="4.0" bean-discovery-mode="annotated"/>

pom.xml

@@ -256,6 +256,29 @@
             <annotationProcessorPathsUseDepMgmt>true</annotationProcessorPathsUseDepMgmt>
           </configuration>
         </plugin>
+
+        <plugin>
+          <groupId>org.apache.maven.plugins</groupId>
+          <artifactId>maven-javadoc-plugin</artifactId>
+          <version>${maven-javadoc-plugin.version}</version>
+          <configuration>
+            <doclint>all</doclint>
+            <failOnWarnings>true</failOnWarnings>
+            <source>11</source>
+            <release>${maven.compiler.release}</release>
+            <sourceFileExcludes>
+              <sourceFileExclude>**/internal/**</sourceFileExclude>
+            </sourceFileExcludes>
+          </configuration>
+          <executions>
+            <execution>
+              <id>attach-javadocs</id>
+              <goals>
+                <goal>jar</goal>
+              </goals>
+            </execution>
+          </executions>
+        </plugin>
       </plugins>
     </pluginManagement>
   </build>
@@ -317,31 +340,6 @@
     <profile>
       <id>release</id>
       <build>
-        <pluginManagement>
-          <plugins>
-            <plugin>
-              <groupId>org.apache.maven.plugins</groupId>
-              <artifactId>maven-javadoc-plugin</artifactId>
-              <version>${maven-javadoc-plugin.version}</version>
-              <configuration>
-                <doclint>all</doclint>
-                <source>11</source>
-                <release>${maven.compiler.release}</release>
-                <sourceFileExcludes>
-                  <sourceFileExclude>**/internal/**</sourceFileExclude>
-                </sourceFileExcludes>
-              </configuration>
-              <executions>
-                <execution>
-                  <id>attach-javadocs</id>
-                  <goals>
-                    <goal>jar</goal>
-                  </goals>
-                </execution>
-              </executions>
-            </plugin>
-          </plugins>
-        </pluginManagement>
         <plugins>
           <plugin>
             <groupId>org.apache.maven.plugins</groupId>

proxy-wasm-java-host/src/main/java/io/roastedroot/proxywasm/PluginFactory.java

@@ -26,7 +26,7 @@ public interface PluginFactory {
     /**
      * Creates and returns a new {@link Plugin} instance.
      * Implementations are responsible for all necessary setup, including potentially
-     * loading the WASM module and configuring it using {@link Plugin#builder(com.dylibso.chicory.wasm.WasmModule)}.
+     * loading the WASM module and configuring it using {@link PluginFactory#builder(com.dylibso.chicory.wasm.WasmModule)}.
      *
      * @return A newly created {@link Plugin} instance.
      * @throws Exception If any error occurs during plugin creation (e.g., file loading, WASM instantiation,

proxy-wasm-java-host/src/main/java/io/roastedroot/proxywasm/StartException.java

@@ -3,7 +3,7 @@
 /**
  * Exception thrown when an error occurs during the initialization or startup phase of a Proxy-WASM plugin.
  *
- * <p>This typically happens during the execution of the {@link Plugin.Builder#build()} method,
+ * <p>This typically happens during the execution of the {@link PluginFactory.Builder#build()} method,
  * encompassing issues such as WASM module instantiation failures, errors within the WASM
  * {@code _start} function, or failures during the initial {@code proxy_on_vm_start} or
  * {@code proxy_on_configure} calls within the plugin.

proxy-wasm-jaxrs/src/main/resources/META-INF/beans.xml

@@ -2,7 +2,7 @@
 <beans xmlns="https://jakarta.ee/xml/ns/jakartaee"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/beans_4_0.xsd"
-       version="4.0" bean-discovery-mode="all">
+       version="4.0" bean-discovery-mode="annotated">
     <alternatives>
         <class>io.roastedroot.proxywasm.jaxrs.cdi.ServerAdaptor</class>
     </alternatives>