docs: add docgen tool and generate javadocs for API client classes

flake.nix

@@ -0,0 +1,40 @@
+{
+  description = "Typesense Java client dev shell";
+
+  inputs = {
+    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
+    flake-utils.url = "github:numtide/flake-utils";
+  };
+
+  outputs = { self, nixpkgs, flake-utils }:
+    flake-utils.lib.eachDefaultSystem (system:
+      let
+        pkgs = import nixpkgs {
+          inherit system;
+          config.permittedInsecurePackages = [ "gradle-7.6.6" ];
+        };
+      in {
+        devShells.default = pkgs.mkShell {
+          buildInputs = with pkgs; [
+            jdk17
+            gradle_7
+            jdt-language-server
+          ];
+
+          JDK8_HOME = "${pkgs.jdk8}";
+
+          shellHook = ''
+            export JAVA_HOME=${pkgs.jdk17}
+            echo "Java (jdtls/build runtime):"
+            java -version
+            echo ""
+            echo "Project JDK 8 available at: $JDK8_HOME"
+            echo ""
+            echo "Gradle:"
+            gradle --version | grep '^Gradle'
+            echo ""
+            echo "jdtls: $(command -v jdtls)"
+          '';
+        };
+      });
+}

generator/build.gradle

@@ -0,0 +1,29 @@
+plugins {
+    id 'java'
+    id 'application'
+}
+
+repositories {
+    mavenCentral()
+}
+
+java {
+    sourceCompatibility = JavaVersion.VERSION_1_8
+    targetCompatibility = JavaVersion.VERSION_1_8
+}
+
+dependencies {
+    implementation 'com.github.javaparser:javaparser-core:3.25.10'
+    implementation 'org.yaml:snakeyaml:2.2'
+}
+
+application {
+    mainClass = 'org.typesense.docgen.DocGen'
+}
+
+tasks.named('run') {
+    // Pass spec + wrapper dir via -PspecPath / -PwrapperDir or rely on defaults.
+    def specPath = project.findProperty('specPath') ?: "${rootDir}/../../api-spec/openapi.yml"
+    def wrapperDir = project.findProperty('wrapperDir') ?: "${rootDir}/../src/main/java/org/typesense/api"
+    args = [specPath, wrapperDir]
+}

generator/settings.gradle

@@ -0,0 +1 @@
+rootProject.name = 'typesense-java-docgen'