Added slash command request classes to :api module

Author: surajkumar

api/src/main/java/com/javadiscord/jdi/core/api/InteractionRequest.java

@@ -0,0 +1,40 @@
+package com.javadiscord.jdi.core.api;
+
+import com.javadiscord.jdi.core.api.builders.command.CommandBuilder;
+import com.javadiscord.jdi.core.api.builders.command.CommandOption;
+
+public class InteractionRequest {
+    private final DiscordResponseParser responseParser;
+    private final long guildId;
+    private final long applicationId;
+
+    public InteractionRequest(
+        DiscordResponseParser responseParser, long guildId, long applicationId
+    ) {
+        this.responseParser = responseParser;
+        this.guildId = guildId;
+        this.applicationId = applicationId;
+    }
+
+    public AsyncResponse<Void> createInteraction(CommandBuilder builder) {
+        return responseParser
+            .callAndParse(Void.class, builder.applicationId(applicationId).build());
+    }
+
+    public AsyncResponse<Void> createSlashCommand(
+        String name,
+        String description,
+        CommandOption... options
+    ) {
+        CommandBuilder builder =
+            new CommandBuilder(
+                name,
+                description
+            );
+        for (CommandOption option : options) {
+            builder.addOption(option);
+        }
+        builder.applicationId(applicationId);
+        return createInteraction(builder);
+    }
+}

api/src/main/java/com/javadiscord/jdi/core/api/builders/command/CommandBuilder.java

@@ -0,0 +1,61 @@
+package com.javadiscord.jdi.core.api.builders.command;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Optional;
+
+import com.javadiscord.jdi.internal.api.application_commands.CreateCommandRequest;
+
+public class CommandBuilder {
+    private final String name;
+    private final CommandOptionType type;
+    private final String description;
+    private final List<CommandOption> options;
+
+    private Optional<Boolean> global;
+
+    private long applicationId;
+    private long guildId;
+
+    public CommandBuilder(
+        String name, String description
+    ) {
+        this.name = name;
+        this.type = CommandOptionType.SUB_COMMAND;
+        this.description = description;
+        this.options = new ArrayList<>();
+        this.global = Optional.empty();
+    }
+
+    public CommandBuilder addOption(CommandOption option) {
+        options.add(option);
+        return this;
+    }
+
+    public CommandBuilder global(boolean global) {
+        this.global = Optional.of(global);
+        return this;
+    }
+
+    public CommandBuilder guildId(long guildId) {
+        this.guildId = guildId;
+        return this;
+    }
+
+    public CommandBuilder applicationId(long applicationId) {
+        this.applicationId = applicationId;
+        return this;
+    }
+
+    public CreateCommandRequest build() {
+        return new CreateCommandRequest(
+            name,
+            type,
+            description,
+            options,
+            global,
+            guildId,
+            applicationId
+        );
+    }
+}

api/src/main/java/com/javadiscord/jdi/core/api/builders/command/CommandOption.java

@@ -0,0 +1,56 @@
+package com.javadiscord.jdi.core.api.builders.command;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public class CommandOption {
+    private final String name;
+    private final String description;
+    private final CommandOptionType type;
+    private boolean required;
+    private final List<CommandOptionChoice> choices;
+
+    public CommandOption(String name, String description, CommandOptionType type) {
+        this(name, description, type, true);
+    }
+
+    public CommandOption(
+        String name, String description, CommandOptionType type, boolean required
+    ) {
+        this.name = name;
+        this.description = description;
+        this.type = type;
+        this.required = required;
+        this.choices = new ArrayList<>();
+    }
+
+    public CommandOption addChoice(String name, String value) {
+        choices.add(new CommandOptionChoice(name, value));
+        return this;
+    }
+
+    public CommandOption setRequired(boolean required) {
+        this.required = required;
+        return this;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public String getDescription() {
+        return description;
+    }
+
+    public CommandOptionType getType() {
+        return type;
+    }
+
+    public boolean isRequired() {
+        return required;
+    }
+
+    public List<CommandOptionChoice> getChoices() {
+        return choices;
+    }
+}

api/src/main/java/com/javadiscord/jdi/core/api/builders/command/CommandOptionChoice.java

@@ -0,0 +1,3 @@
+package com.javadiscord.jdi.core.api.builders.command;
+
+public record CommandOptionChoice(String name, String value) {}

api/src/main/java/com/javadiscord/jdi/core/api/builders/command/CommandOptionType.java

@@ -0,0 +1,38 @@
+package com.javadiscord.jdi.core.api.builders.command;
+
+import com.fasterxml.jackson.annotation.JsonValue;
+
+public enum CommandOptionType {
+    SUB_COMMAND(1),
+    SUB_COMMAND_GROUP(2),
+    STRING(3),
+    INTEGER(4),
+    BOOLEAN(5),
+    USER(6),
+    CHANNEL(7),
+    ROLE(8),
+    MENTIONABLE(9),
+    NUMBER(10),
+    ATTACHMENT(11),
+    ;
+
+    private final int value;
+
+    CommandOptionType(int value) {
+        this.value = value;
+    }
+
+    @JsonValue
+    public int getValue() {
+        return value;
+    }
+
+    public static CommandOptionType fromName(String name) {
+        for (CommandOptionType type : CommandOptionType.values()) {
+            if (type.name().equalsIgnoreCase(name)) {
+                return type;
+            }
+        }
+        throw new IllegalArgumentException("Unknown command option type: " + name);
+    }
+}

api/src/main/java/com/javadiscord/jdi/internal/api/application_commands/CreateCommandRequest.java

@@ -0,0 +1,46 @@
+package com.javadiscord.jdi.internal.api.application_commands;
+
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Optional;
+
+import com.javadiscord.jdi.core.api.builders.command.CommandOption;
+import com.javadiscord.jdi.core.api.builders.command.CommandOptionType;
+import com.javadiscord.jdi.internal.api.DiscordRequest;
+import com.javadiscord.jdi.internal.api.DiscordRequestBuilder;
+
+public record CreateCommandRequest(
+    String name,
+    CommandOptionType type,
+    String description,
+    List<CommandOption> options,
+    Optional<Boolean> global,
+    long guildId,
+    long applicationId
+) implements DiscordRequest {
+
+    @Override
+    public DiscordRequestBuilder create() {
+
+        String path = "/applications/%s/commands".formatted(applicationId);
+
+        if (global.isPresent() && global.get()) {
+            path = "/applications/%s/guilds/%s/commands".formatted(applicationId, guildId);
+        }
+
+        Map<String, Object> body = new HashMap<>();
+        body.put("name", name);
+        body.put("type", type);
+        body.put("description", description);
+
+        if (!options.isEmpty()) {
+            body.put("options", options);
+        }
+
+        return new DiscordRequestBuilder()
+            .post()
+            .body(body)
+            .path(path);
+    }
+}

api/src/main/java/com/javadiscord/jdi/internal/api/application_commands/DeleteCommandRequest.java

@@ -0,0 +1,20 @@
+package com.javadiscord.jdi.internal.api.application_commands;
+
+import java.util.Optional;
+
+import com.javadiscord.jdi.internal.api.DiscordRequest;
+import com.javadiscord.jdi.internal.api.DiscordRequestBuilder;
+
+public record DeleteCommandRequest(
+    long applicationId,
+    Optional<Long> guildId,
+    long commandId
+) implements DiscordRequest {
+
+    @Override
+    public DiscordRequestBuilder create() {
+        // TODO: Implement
+        // https://discord.com/developers/docs/interactions/application-commands#updating-and-deleting-a-command
+        return null;
+    }
+}

api/src/main/java/com/javadiscord/jdi/internal/api/application_commands/EditCommandRequest.java

@@ -0,0 +1,12 @@
+package com.javadiscord.jdi.internal.api.application_commands;
+
+import com.javadiscord.jdi.internal.api.DiscordRequest;
+import com.javadiscord.jdi.internal.api.DiscordRequestBuilder;
+
+public record EditCommandRequest() implements DiscordRequest {
+
+    @Override
+    public DiscordRequestBuilder create() {
+        return null;
+    }
+}

api/src/main/java/com/javadiscord/jdi/internal/api/application_commands/FetchCommandRequest.java

@@ -0,0 +1,12 @@
+package com.javadiscord.jdi.internal.api.application_commands;
+
+import com.javadiscord.jdi.internal.api.DiscordRequest;
+import com.javadiscord.jdi.internal.api.DiscordRequestBuilder;
+
+public record FetchCommandRequest() implements DiscordRequest {
+
+    @Override
+    public DiscordRequestBuilder create() {
+        return null;
+    }
+}

api/src/main/java/com/javadiscord/jdi/internal/api/application_commands/FetchCommandsRequest.java

@@ -0,0 +1,12 @@
+package com.javadiscord.jdi.internal.api.application_commands;
+
+import com.javadiscord.jdi.internal.api.DiscordRequest;
+import com.javadiscord.jdi.internal.api.DiscordRequestBuilder;
+
+public record FetchCommandsRequest() implements DiscordRequest {
+
+    @Override
+    public DiscordRequestBuilder create() {
+        return null;
+    }
+}