feat: complete java sdk v0 foundation and typed complement models

Author: javorosas

.gitignore

@@ -0,0 +1,13 @@
+# Build artifacts
+target/
+
+# Local Maven cache override used in this workspace
+.m2/
+
+# IDE files
+.idea/
+*.iml
+.vscode/
+
+# OS files
+.DS_Store

README.md

@@ -2,25 +2,36 @@
 
 Official Java SDK for [Facturapi](https://www.facturapi.io).
 
+[![CI](https://img.shields.io/github/actions/workflow/status/facturapi/facturapi-java/ci.yml?branch=main&style=for-the-badge&label=CI)](https://github.com/facturapi/facturapi-java/actions/workflows/ci.yml)
+[![Maven Central](https://img.shields.io/maven-central/v/io.facturapi/facturapi-java?style=for-the-badge&label=Maven%20Central)](https://central.sonatype.com/artifact/io.facturapi/facturapi-java)
+[![Java](https://img.shields.io/badge/Java-11%2B-ED8B00?style=for-the-badge&logo=openjdk&logoColor=white)](https://openjdk.org/)
+
 ## Requirements
 
 - Java 11+
-- Maven 3.8+
 
 ## Installation
 
+Maven:
+
 ```xml
 <dependency>
   <groupId>io.facturapi</groupId>
   <artifactId>facturapi-java</artifactId>
-  <version>1.0.0</version>
+  <version>0.1.0</version>
 </dependency>
 ```
 
+Gradle:
+
+```gradle
+implementation("io.facturapi:facturapi-java:0.1.0")
+```
+
 ## Quickstart
 
 ```java
-import com.facturapi.Facturapi;
+import io.facturapi.Facturapi;
 import java.util.Map;
 
 Facturapi facturapi = new Facturapi("sk_test_...");
@@ -33,11 +44,19 @@ var customer = facturapi.customers.create(Map.of(
 ), null);
 
 var invoice = facturapi.invoices.create(Map.of(
-  "customer", customer.get("id").asText(),
+  "customer", customer.getId(),
   "items", java.util.List.of(Map.of("quantity", 1, "product", "prod_123"))
 ), null);
+
+System.out.println(invoice.getId());
 ```
 
+## Design
+
+- Inputs use flexible JSON dictionaries (`Map<String, Object>`).
+- Outputs are typed Java models (`Invoice`, `Customer`, `SearchResult<T>`, etc.).
+- Auth uses `Authorization: Bearer <apiKey>`.
+
 ## Configuration
 
 ```java
@@ -46,9 +65,3 @@ Facturapi facturapi = Facturapi.builder("sk_test_...")
   .timeout(java.time.Duration.ofSeconds(20))
   .build();
 ```
-
-## Notes
-
-- Uses `Authorization: Bearer <apiKey>`.
-- Supports custom base URL for integration testing.
-- Includes compatibility aliases (`all`, `del`, `lisLiveApiKeys`).

pom.xml

@@ -5,7 +5,7 @@
 
   <groupId>io.facturapi</groupId>
   <artifactId>facturapi-java</artifactId>
-  <version>1.0.0-SNAPSHOT</version>
+  <version>0.1.0-SNAPSHOT</version>
   <name>facturapi-java</name>
   <description>Official Java SDK for Facturapi</description>
   <url>https://github.com/facturapi/facturapi-java</url>
@@ -22,7 +22,6 @@
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     <jackson.version>2.17.2</jackson.version>
     <junit.version>5.11.0</junit.version>
-    <okhttp.version>4.12.0</okhttp.version>
   </properties>
 
   <dependencies>
@@ -38,12 +37,6 @@
       <version>${junit.version}</version>
       <scope>test</scope>
     </dependency>
-    <dependency>
-      <groupId>com.squareup.okhttp3</groupId>
-      <artifactId>mockwebserver</artifactId>
-      <version>${okhttp.version}</version>
-      <scope>test</scope>
-    </dependency>
   </dependencies>
 
   <build>