Add Java module descriptor

Co-authored-by: brunoborges <129743+brunoborges@users.noreply.github.com>

Author: Copilot

config/checkstyle/checkstyle.xml

@@ -11,9 +11,9 @@
     <property name="charset" value="UTF-8"/>
     <property name="severity" value="error"/>
 
-    <!-- Exclude json package, events package, and generated package (self-documenting DTOs) -->
+    <!-- Exclude module descriptor, json package, events package, and generated package (self-documenting DTOs) -->
     <module name="BeforeExecutionExclusionFileFilter">
-        <property name="fileNamePattern" value=".*[\\/](json|events|generated|rpc)[\\/].*\.java$"/>
+        <property name="fileNamePattern" value="(^|.*[\\/])module-info\.java$|.*[\\/](json|events|generated|rpc)[\\/].*\.java$"/>
     </module>
 
     <module name="TreeWalker">

src/main/java/module-info.java

@@ -0,0 +1,22 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+/**
+ * GitHub Copilot SDK for Java.
+ */
+module com.github.copilot.sdk.java {
+    requires transitive com.fasterxml.jackson.annotation;
+    requires com.fasterxml.jackson.core;
+    requires transitive com.fasterxml.jackson.databind;
+    requires com.fasterxml.jackson.datatype.jsr310;
+    requires static com.github.spotbugs.annotations;
+    requires static java.compiler;
+    requires static java.net.http;
+    requires java.logging;
+
+    exports com.github.copilot.sdk;
+    exports com.github.copilot.sdk.generated;
+    exports com.github.copilot.sdk.generated.rpc;
+    exports com.github.copilot.sdk.json;
+}

src/test/java/com/github/copilot/sdk/ModuleDescriptorTest.java

@@ -0,0 +1,28 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+package com.github.copilot.sdk;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import java.lang.module.ModuleDescriptor;
+import org.junit.jupiter.api.Test;
+
+class ModuleDescriptorTest {
+
+    @Test
+    void sdkHasExplicitModuleDescriptor() {
+        Module module = CopilotClient.class.getModule();
+        assertTrue(module.isNamed());
+        assertEquals("com.github.copilot.sdk.java", module.getName());
+
+        ModuleDescriptor descriptor = module.getDescriptor();
+        assertTrue(descriptor.exports().stream().anyMatch(export -> export.source().equals("com.github.copilot.sdk")));
+        assertTrue(descriptor.exports().stream()
+                .anyMatch(export -> export.source().equals("com.github.copilot.sdk.json")));
+        assertTrue(descriptor.requires().stream()
+                .anyMatch(require -> require.name().equals("com.fasterxml.jackson.databind")));
+    }
+}