Events API: use Nessie model API directly and remove DTOs (#9588)

CHANGELOG.md

@@ -12,6 +12,15 @@ as necessary. Empty sections will not end in the release notes.
 
 ### Breaking changes
 
+- The Events API has been redesigned to import the Nessie Model API directly, instead of using
+  specific DTO classes. This change is intended to simplify the API and facilitate consumption of
+  the events. The following classes from the `org.projectnessie.events.api` package have been
+  removed and replaced with their respective model classes from the `org.projectnessie.model`
+  package:
+    - `CommitMeta`
+    - `Content` and its subclasses
+    - `ContentKey`
+    - `Reference` and its subclasses
 - Helm chart: the `service` section has been redesigned to allow for extra services to be defined.
   If you have customized the `service.ports` field, beware that this field is now an array. Also,
   the management port configuration has been moved to a new `managementService` section. And

events/api/build.gradle.kts

@@ -19,13 +19,22 @@ plugins { id("nessie-conventions-server") }
 publishingHelper { mavenName = "Nessie - Events - API" }
 
 dependencies {
+  api(project(":nessie-model"))
 
   // Immutables
   implementation(libs.immutables.builder)
   implementation(libs.immutables.value.annotations)
   annotationProcessor(libs.immutables.value.processor)
 
+  compileOnly(libs.microprofile.openapi)
+  compileOnly(platform(libs.jackson.bom))
+  compileOnly("com.fasterxml.jackson.core:jackson-annotations")
+
   // Testing
   testImplementation(platform(libs.junit.bom))
   testImplementation(libs.bundles.junit.testing)
+
+  testCompileOnly(libs.microprofile.openapi)
+  testCompileOnly(platform(libs.jackson.bom))
+  testCompileOnly("com.fasterxml.jackson.core:jackson-annotations")
 }

events/api/src/main/java/org/projectnessie/events/api/CommitEvent.java

@@ -16,6 +16,7 @@
 package org.projectnessie.events.api;
 
 import org.immutables.value.Value;
+import org.projectnessie.model.CommitMeta;
 
 /**
  * Event that is emitted when a commit is performed. This event is emitted after the commit has been

events/api/src/main/java/org/projectnessie/events/api/ContentEvent.java

@@ -16,6 +16,7 @@
 package org.projectnessie.events.api;
 
 import java.time.Instant;
+import org.projectnessie.model.ContentKey;
 
 /**
  * Event that is emitted when a content is stored (PUT) or removed (DELETE).

events/api/src/main/java/org/projectnessie/events/api/ContentStoredEvent.java

@@ -16,6 +16,7 @@
 package org.projectnessie.events.api;
 
 import org.immutables.value.Value;
+import org.projectnessie.model.Content;
 
 /**
  * Event that is emitted when a content is stored. This event corresponds to a PUT operation in a

events/api/src/main/java/org/projectnessie/events/api/MergeEvent.java

@@ -16,6 +16,7 @@
 package org.projectnessie.events.api;
 
 import org.immutables.value.Value;
+import org.projectnessie.model.Reference;
 
 /**
  * Event that is emitted when a merge is performed. This event is emitted after the merge has been
@@ -30,6 +31,15 @@ default EventType getType() {
     return EventType.MERGE;
   }
 
+  /**
+   * The source reference where the committed operations come from. This is usually a branch, but
+   * not always (e.g. it could be a tag or a detached reference).
+   */
+  Reference getSourceReference();
+
+  /** The hash of the source reference that was merged into the target reference. */
+  String getSourceHash();
+
   /**
    * The hash of the common ancestor of the two merged branches.
    *

events/api/src/main/java/org/projectnessie/events/api/MultiReferenceEvent.java

@@ -15,8 +15,10 @@
  */
 package org.projectnessie.events.api;
 
+import org.projectnessie.model.Reference;
+
 /**
- * Event that affects two references: a source and a target.
+ * Event that affects more than one reference.
  *
  * <p>This type has 2 child interfaces:
  *
@@ -27,12 +29,6 @@
  */
 public interface MultiReferenceEvent extends Event {
 
-  /**
-   * The source reference where the committed operations come from. This is usually a branch, but
-   * not always (e.g. it could be a tag or a detached reference).
-   */
-  Reference getSourceReference();
-
   /**
    * The target reference where the committed operations were applied to.
    *