feat(spec): Add Operation record

Author: thced

src/main/java/com/retailsvc/http/spec/Operation.java

@@ -0,0 +1,13 @@
+package com.retailsvc.http.spec;
+
+import java.util.List;
+import java.util.Map;
+import java.util.Optional;
+
+public record Operation(
+    String operationId,
+    HttpMethod method,
+    PathTemplate path,
+    Optional<RequestBody> requestBody,
+    List<Parameter> parameters,
+    Map<String, Response> responses) {}

src/test/java/com/retailsvc/http/spec/OperationTest.java

@@ -0,0 +1,26 @@
+package com.retailsvc.http.spec;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+import com.retailsvc.http.spec.schema.BooleanSchema;
+import com.retailsvc.http.spec.schema.TypeName;
+import java.util.List;
+import java.util.Map;
+import java.util.Optional;
+import java.util.Set;
+import org.junit.jupiter.api.Test;
+
+class OperationTest {
+  @Test
+  void operationCarriesAllFields() {
+    var path = PathTemplate.compile("/users/{id}");
+    var param =
+        new Parameter(
+            "id", Parameter.Location.PATH, true, new BooleanSchema(Set.of(TypeName.BOOLEAN)));
+    Operation op =
+        new Operation("get-user", HttpMethod.GET, path, Optional.empty(), List.of(param), Map.of());
+    assertThat(op.operationId()).isEqualTo("get-user");
+    assertThat(op.method()).isEqualTo(HttpMethod.GET);
+    assertThat(op.parameters()).hasSize(1);
+  }
+}