feat: publis java docs

Author: xavidop

.github/workflows/publish-javadoc.yml

@@ -0,0 +1,39 @@
+# Copyright 2025 Google LLC
+#
+# 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.
+#
+# SPDX-License-Identifier: Apache-2.0
+
+name: Publish Javadoc
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Deploy JavaDoc 🚀
+        uses: MathieuSoysal/Javadoc-publisher.yml@v3.0.2
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          javadoc-branch: gh-pages
+          java-version: 21
+          target-folder: javadoc
+          project: maven
+          custom-command: mvn javadoc:aggregate

pom.xml

@@ -310,6 +310,15 @@
                         <failOnError>false</failOnError>
                         <failOnWarnings>false</failOnWarnings>
                         <quiet>true</quiet>
+                        <show>public</show>
+                        <nohelp>true</nohelp>
+                        <outputDirectory>${project.build.directory}/javadoc</outputDirectory>
+                        <reportOutputDirectory>${project.build.directory}/javadoc</reportOutputDirectory>
+                        <destDir>javadoc</destDir>
+                        <doctitle>Genkit for Java ${project.version} API</doctitle>
+                        <windowtitle>Genkit for Java API</windowtitle>
+                        <source>${java.version}</source>
+                        <encoding>UTF-8</encoding>
                     </configuration>
                     <executions>
                         <execution>
@@ -318,6 +327,17 @@
                                 <goal>jar</goal>
                             </goals>
                         </execution>
+                        <execution>
+                            <id>aggregate</id>
+                            <goals>
+                                <goal>aggregate</goal>
+                            </goals>
+                            <phase>site</phase>
+                            <configuration>
+                                <outputDirectory>${project.basedir}/target/javadoc</outputDirectory>
+                                <reportOutputDirectory>${project.basedir}/target/javadoc</reportOutputDirectory>
+                            </configuration>
+                        </execution>
                     </executions>
                 </plugin>
                 <!-- Spotless for code formatting (Eclipse JDT) -->