first commit

docs/api-query.md

@@ -0,0 +1,33 @@
+# Query API
+
+Raw SQL is available via `api.query()` with parameter binding.
+
+## Execute
+
+```java
+int rows = api.query().execute(
+    "UPDATE players SET level = level + 1 WHERE id = ?",
+    java.util.Collections.singletonList(1)
+);
+```
+
+## Query
+
+```java
+List<String> names = api.query().query(
+    "SELECT name FROM players WHERE level >= ?",
+    java.util.Collections.singletonList(10),
+    rs -> rs.getString("name")
+);
+```
+
+## Transactions
+
+```java
+try (Transaction tx = api.beginTransaction()) {
+    tx.execute("UPDATE players SET level = level + 1 WHERE id = ?", java.util.Collections.singletonList(1));
+    tx.commit();
+} catch (Exception ex) {
+    // rollback on error if needed
+}
+```