test(jdbc): add Hibernate integration smoke tests (#264)

## Summary

Promotes the Hibernate smoke prototype into `libsql-jdbc` as a Failsafe
integration test.

- `HibernateIT` drives the in-tree driver through Hibernate ORM 7.4:
identity-generated keys, scalar mapping, `@ManyToOne` associations, HQL
joins and pagination, repeated inserts, schema validation, and
optimistic locking.
- `HibernateSqldSupport` starts the pinned sqld Testcontainer and
creates the schema through JDBC. Hibernate 7.4's SQLite dialect emits an
untyped identity column for `book`, so its own DDL is not used; the
validator test still reads the schema back through the driver's
`DatabaseMetaData`.
- Optimistic locking coverage:
  - version increment on a successful update;
  - explicit `OPTIMISTIC_FORCE_INCREMENT`;
  - stale detached merge;
  - stale delete;
  - versioned update through a foreign-key association;
  - timestamp-valued `@Version` round-trip and stale merge.
- Stale-write tests assert Hibernate receives an update count of `0`,
throws an optimistic-lock exception, and leaves the stored row
unchanged.
- Test-only dependencies: Hibernate 7.4.13, Testcontainers, and Failsafe
`*IT` wiring. `./mvnw test` stays unit-only.
- The module copies the shared Docker config into `target/docker-config`
and sets `DOCKER_CONFIG` for Failsafe, so sandboxed runs work without a
shell override.

## Driver findings

No driver-level defects surfaced in the covered Hibernate paths.
Generated keys, versioned update/delete counts, timestamp comparisons,
and schema validation all behaved correctly.

## Auto-commit identity

`#83` already tracks the relevant limitation: in auto-commit, a direct
`SELECT last_insert_rowid()` reads a fresh Hrana stream. Hibernate's
`GenerationType.IDENTITY` uses that same query, so this suite keeps
auto-commit disabled (Hibernate's default) and documents the dependency.
No duplicate issue was created.

Refs #83

## Test plan

- [x] `./mvnw -pl libsql-jdbc -am -Dit.test=HibernateIT
-Dtest=NoSuchTest -Dsurefire.failIfNoSpecifiedTests=false verify` — 11
tests pass
- [x] `./mvnw spotless:check`
- [x] `./prototype/hibernate-smoke/run.sh` — 11 prototype tests pass
against a throwaway sqld container

Author: magnusp

libsql-jdbc/pom.xml

@@ -38,6 +38,18 @@
             <version>${flyway.version}</version>
             <scope>test</scope>
         </dependency>
+        <dependency>
+            <groupId>org.hibernate.orm</groupId>
+            <artifactId>hibernate-core</artifactId>
+            <version>${hibernate.version}</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.hibernate.orm</groupId>
+            <artifactId>hibernate-community-dialects</artifactId>
+            <version>${hibernate.version}</version>
+            <scope>test</scope>
+        </dependency>
         <dependency>
             <groupId>org.liquibase</groupId>
             <artifactId>liquibase-core</artifactId>

libsql-jdbc/src/test/java/io/github/magnusp/libsql/jdbc/hibernate/Author.java

@@ -0,0 +1,57 @@
+package io.github.magnusp.libsql.jdbc.hibernate;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.Table;
+import jakarta.persistence.Version;
+
+@Entity
+@Table(name = "author")
+public class Author {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Integer id;
+
+    @Column(nullable = false)
+    private String name;
+
+    private String country;
+
+    @Version
+    private long version;
+
+    protected Author() {}
+
+    public Author(String name, String country) {
+        this.name = name;
+        this.country = country;
+    }
+
+    public Integer getId() {
+        return id;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public String getCountry() {
+        return country;
+    }
+
+    public void setCountry(String country) {
+        this.country = country;
+    }
+
+    public long getVersion() {
+        return version;
+    }
+}

libsql-jdbc/src/test/java/io/github/magnusp/libsql/jdbc/hibernate/Book.java

@@ -0,0 +1,83 @@
+package io.github.magnusp.libsql.jdbc.hibernate;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.FetchType;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.JoinColumn;
+import jakarta.persistence.ManyToOne;
+import jakarta.persistence.Table;
+import jakarta.persistence.Version;
+
+import java.math.BigDecimal;
+
+@Entity
+@Table(name = "book")
+public class Book {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Integer id;
+
+    @ManyToOne(fetch = FetchType.LAZY, optional = false)
+    @JoinColumn(name = "author_id", nullable = false)
+    private Author author;
+
+    @Column(nullable = false)
+    private String title;
+
+    private BigDecimal price;
+
+    @Column(name = "in_print", nullable = false)
+    private boolean inPrint;
+
+    @Version
+    private long version;
+
+    protected Book() {}
+
+    public Book(Author author, String title, BigDecimal price, boolean inPrint) {
+        this.author = author;
+        this.title = title;
+        this.price = price;
+        this.inPrint = inPrint;
+    }
+
+    public Integer getId() {
+        return id;
+    }
+
+    public Author getAuthor() {
+        return author;
+    }
+
+    public String getTitle() {
+        return title;
+    }
+
+    public void setTitle(String title) {
+        this.title = title;
+    }
+
+    public BigDecimal getPrice() {
+        return price;
+    }
+
+    public void setPrice(BigDecimal price) {
+        this.price = price;
+    }
+
+    public boolean isInPrint() {
+        return inPrint;
+    }
+
+    public void setInPrint(boolean inPrint) {
+        this.inPrint = inPrint;
+    }
+
+    public long getVersion() {
+        return version;
+    }
+}