[AB-30] adding giveaway feature

abstracto-application/abstracto-modules/giveaway/giveaway-int/pom.xml

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>dev.sheldan.abstracto.modules</groupId>
+        <artifactId>giveaway</artifactId>
+        <version>1.5.13-SNAPSHOT</version>
+    </parent>
+
+    <artifactId>giveaway-int</artifactId>
+
+    <dependencies>
+
+        <dependency>
+            <groupId>dev.sheldan.abstracto.scheduling</groupId>
+            <artifactId>scheduling-int</artifactId>
+            <version>${project.version}</version>
+        </dependency>
+    </dependencies>
+
+</project>

abstracto-application/abstracto-modules/giveaway/giveaway-int/src/main/java/dev/sheldan/abstracto/giveaway/config/GiveawayFeatureConfig.java

@@ -0,0 +1,23 @@
+package dev.sheldan.abstracto.giveaway.config;
+
+import dev.sheldan.abstracto.core.config.FeatureConfig;
+import dev.sheldan.abstracto.core.config.FeatureDefinition;
+import dev.sheldan.abstracto.core.config.PostTargetEnum;
+import org.springframework.stereotype.Component;
+
+import java.util.Arrays;
+import java.util.List;
+
+@Component
+public class GiveawayFeatureConfig implements FeatureConfig {
+
+    @Override
+    public FeatureDefinition getFeature() {
+        return GiveawayFeatureDefinition.GIVEAWAY;
+    }
+
+    @Override
+    public List<PostTargetEnum> getRequiredPostTargets() {
+        return Arrays.asList(GiveawayPostTarget.GIVEAWAYS);
+    }
+}

abstracto-application/abstracto-modules/giveaway/giveaway-int/src/main/java/dev/sheldan/abstracto/giveaway/config/GiveawayFeatureDefinition.java

@@ -0,0 +1,15 @@
+package dev.sheldan.abstracto.giveaway.config;
+
+import dev.sheldan.abstracto.core.config.FeatureDefinition;
+import lombok.Getter;
+
+@Getter
+public enum GiveawayFeatureDefinition implements FeatureDefinition {
+    GIVEAWAY("giveaway");
+
+    private String key;
+
+    GiveawayFeatureDefinition(String key) {
+        this.key = key;
+    }
+}

abstracto-application/abstracto-modules/giveaway/giveaway-int/src/main/java/dev/sheldan/abstracto/giveaway/config/GiveawayPostTarget.java

@@ -0,0 +1,15 @@
+package dev.sheldan.abstracto.giveaway.config;
+
+import dev.sheldan.abstracto.core.config.PostTargetEnum;
+import lombok.Getter;
+
+@Getter
+public enum GiveawayPostTarget implements PostTargetEnum {
+    GIVEAWAYS("giveaways");
+
+    private String key;
+
+    GiveawayPostTarget(String key) {
+        this.key = key;
+    }
+}

abstracto-application/abstracto-modules/giveaway/giveaway-int/src/main/java/dev/sheldan/abstracto/giveaway/config/GiveawaySlashCommandNames.java

@@ -0,0 +1,5 @@
+package dev.sheldan.abstracto.giveaway.config;
+
+public class GiveawaySlashCommandNames {
+    public static final String GIVEAWAY = "giveaway";
+}

abstracto-application/abstracto-modules/giveaway/giveaway-int/src/main/java/dev/sheldan/abstracto/giveaway/exception/GiveawayNotFoundException.java

@@ -0,0 +1,15 @@
+package dev.sheldan.abstracto.giveaway.exception;
+
+import dev.sheldan.abstracto.core.exception.AbstractoTemplatableException;
+
+public class GiveawayNotFoundException extends AbstractoTemplatableException {
+    @Override
+    public String getTemplateName() {
+        return "giveaway_not_found_exception";
+    }
+
+    @Override
+    public Object getTemplateModel() {
+        return new Object();
+    }
+}

abstracto-application/abstracto-modules/giveaway/giveaway-int/src/main/java/dev/sheldan/abstracto/giveaway/model/GiveawayCreationRequest.java

@@ -0,0 +1,23 @@
+package dev.sheldan.abstracto.giveaway.model;
+
+import lombok.Builder;
+import lombok.Getter;
+import lombok.Setter;
+import net.dv8tion.jda.api.entities.Member;
+import net.dv8tion.jda.api.entities.channel.middleman.GuildMessageChannel;
+
+import java.time.Duration;
+
+@Builder
+@Getter
+public class GiveawayCreationRequest {
+
+    private Member creator;
+    private Member benefactor;
+    private String title;
+    private String description;
+    private Duration duration;
+    @Setter
+    private GuildMessageChannel targetChannel;
+    private Integer winnerCount;
+}

abstracto-application/abstracto-modules/giveaway/giveaway-int/src/main/java/dev/sheldan/abstracto/giveaway/model/JoinGiveawayPayload.java

@@ -0,0 +1,12 @@
+package dev.sheldan.abstracto.giveaway.model;
+
+import dev.sheldan.abstracto.core.interaction.button.ButtonPayload;
+import lombok.Builder;
+import lombok.Getter;
+
+@Getter
+@Builder
+public class JoinGiveawayPayload implements ButtonPayload {
+    private Long giveawayId;
+    private Long serverId;
+}

abstracto-application/abstracto-modules/giveaway/giveaway-int/src/main/java/dev/sheldan/abstracto/giveaway/model/database/Giveaway.java

@@ -0,0 +1,82 @@
+package dev.sheldan.abstracto.giveaway.model.database;
+
+import dev.sheldan.abstracto.core.models.ServerSpecificId;
+import dev.sheldan.abstracto.core.models.database.AChannel;
+import dev.sheldan.abstracto.core.models.database.AServer;
+import dev.sheldan.abstracto.core.models.database.AUserInAServer;
+import jakarta.persistence.*;
+import lombok.*;
+
+import java.time.Instant;
+import java.util.ArrayList;
+import java.util.List;
+
+@Builder
+@Entity
+@NoArgsConstructor
+@AllArgsConstructor
+@Table(name = "giveaway")
+@Getter
+@Setter
+@EqualsAndHashCode
+public class Giveaway {
+    @Id
+    @EmbeddedId
+    private ServerSpecificId giveawayId;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "creator_user_id", nullable = false)
+    private AUserInAServer creator;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "benefactor_user_id")
+    private AUserInAServer benefactor;
+
+    @Column(name = "title", nullable = false)
+    private String title;
+
+    @Column(name = "description")
+    private String description;
+
+    @Column(name = "component_id")
+    private String componentId;
+
+    @Column(name = "winner_count", nullable = false)
+    private Integer winnerCount;
+
+    @Column(name = "target_date", nullable = false)
+    private Instant targetDate;
+
+    @Column(name = "cancelled", nullable = false)
+    private Boolean cancelled;
+
+    @Column(name = "reminder_trigger_key")
+    private String reminderTriggerKey;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "giveaway_channel_id", nullable = false)
+    private AChannel giveawayChannel;
+
+    @ManyToOne(cascade = {CascadeType.PERSIST, CascadeType.MERGE})
+    @MapsId("serverId")
+    @JoinColumn(name = "server_id", referencedColumnName = "id", nullable = false)
+    private AServer server;
+
+    @Column(name = "message_id", nullable = false)
+    private Long messageId;
+
+    @Column(name = "created", nullable = false, insertable = false, updatable = false)
+    private Instant created;
+
+    @Column(name = "updated", insertable = false, updatable = false)
+    private Instant updated;
+
+    @OneToMany(
+            fetch = FetchType.LAZY,
+            orphanRemoval = true,
+            cascade = {CascadeType.PERSIST, CascadeType.MERGE},
+            mappedBy = "giveaway")
+    @Builder.Default
+    private List<GiveawayParticipant> participants = new ArrayList<>();
+
+}

abstracto-application/abstracto-modules/giveaway/giveaway-int/src/main/java/dev/sheldan/abstracto/giveaway/model/database/GiveawayParticipant.java

@@ -0,0 +1,45 @@
+package dev.sheldan.abstracto.giveaway.model.database;
+
+import dev.sheldan.abstracto.core.models.database.AUserInAServer;
+import dev.sheldan.abstracto.giveaway.model.database.embed.GiveawayParticipationId;
+import jakarta.persistence.*;
+import lombok.*;
+
+import java.time.Instant;
+
+@Builder
+@Entity
+@NoArgsConstructor
+@AllArgsConstructor
+@Table(name = "giveaway_participant")
+@Getter
+@Setter
+@EqualsAndHashCode
+public class GiveawayParticipant {
+    @EmbeddedId
+    @Getter
+    private GiveawayParticipationId id;
+
+    @ManyToOne(cascade = {CascadeType.PERSIST, CascadeType.MERGE}, fetch = FetchType.LAZY)
+    @MapsId("participantId")
+    @JoinColumn(name = "participant_user_in_server_id", nullable = false)
+    private AUserInAServer participant;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumns(
+            {
+                    @JoinColumn(updatable = false, insertable = false, name = "giveaway_id", referencedColumnName = "id"),
+                    @JoinColumn(updatable = false, insertable = false, name = "server_id", referencedColumnName = "server_id")
+            })
+    private Giveaway giveaway;
+
+    @Column(name = "won", nullable = false)
+    private Boolean won;
+
+    @Column(name = "created", nullable = false, insertable = false, updatable = false)
+    private Instant created;
+
+    @Column(name = "updated", insertable = false, updatable = false)
+    private Instant updated;
+
+}

abstracto-application/abstracto-modules/giveaway/giveaway-int/src/main/java/dev/sheldan/abstracto/giveaway/model/database/embed/GiveawayParticipationId.java

@@ -0,0 +1,26 @@
+package dev.sheldan.abstracto.giveaway.model.database.embed;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Embeddable;
+import lombok.*;
+
+import java.io.Serializable;
+
+@Embeddable
+@Getter
+@Setter
+@Builder
+@EqualsAndHashCode
+@NoArgsConstructor
+@AllArgsConstructor
+public class GiveawayParticipationId implements Serializable {
+    @Column(name = "participant_user_in_server_id")
+    private Long participantId;
+
+    @Column(name = "giveaway_id")
+    private Long giveawayId;
+
+    @Column(name = "server_id")
+    private Long serverId;
+
+}

abstracto-application/abstracto-modules/giveaway/giveaway-int/src/main/java/dev/sheldan/abstracto/giveaway/model/template/GiveawayMessageModel.java

@@ -0,0 +1,48 @@
+package dev.sheldan.abstracto.giveaway.model.template;
+
+import dev.sheldan.abstracto.core.models.template.display.MemberDisplay;
+import dev.sheldan.abstracto.giveaway.model.database.Giveaway;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.Setter;
+
+import java.time.Instant;
+import java.util.ArrayList;
+import java.util.List;
+
+@Builder
+@Getter
+@Setter
+public class GiveawayMessageModel {
+    private String title;
+    private String description;
+    private Integer winnerCount;
+    private Long giveawayId;
+    @Builder.Default
+    private Boolean ended = false;
+    @Builder.Default
+    private Boolean cancelled = false;
+    @Builder.Default
+    private Long joinedUserCount = 0L;
+    private MemberDisplay creator;
+    private MemberDisplay benefactor;
+    private Instant targetDate;
+    private String joinComponentId;
+    @Builder.Default
+    private List<MemberDisplay> winners = new ArrayList<>();
+
+    public static GiveawayMessageModel fromGiveaway(Giveaway giveaway) {
+        return GiveawayMessageModel
+                .builder()
+                .title(giveaway.getTitle())
+                .description(giveaway.getDescription())
+                .benefactor(giveaway.getBenefactor() != null ? MemberDisplay.fromAUserInAServer(giveaway.getBenefactor()) : null)
+                .creator(MemberDisplay.fromAUserInAServer(giveaway.getCreator()))
+                .winnerCount(giveaway.getWinnerCount())
+                .joinedUserCount((long) giveaway.getParticipants().size())
+                .joinComponentId(giveaway.getComponentId())
+                .giveawayId(giveaway.getGiveawayId().getId())
+                .targetDate(giveaway.getTargetDate())
+                .build();
+    }
+}

abstracto-application/abstracto-modules/giveaway/giveaway-int/src/main/java/dev/sheldan/abstracto/giveaway/model/template/GiveawayResultMessageModel.java

@@ -0,0 +1,15 @@
+package dev.sheldan.abstracto.giveaway.model.template;
+
+import dev.sheldan.abstracto.core.models.template.display.MemberDisplay;
+import lombok.Builder;
+import lombok.Getter;
+
+import java.util.List;
+
+@Getter
+@Builder
+public class GiveawayResultMessageModel {
+    private String title;
+    private Long messageId;
+    private List<MemberDisplay> winners;
+}

abstracto-application/abstracto-modules/giveaway/giveaway-int/src/main/java/dev/sheldan/abstracto/giveaway/service/GiveawayService.java

@@ -0,0 +1,15 @@
+package dev.sheldan.abstracto.giveaway.service;
+
+import dev.sheldan.abstracto.giveaway.model.GiveawayCreationRequest;
+import dev.sheldan.abstracto.giveaway.model.database.Giveaway;
+import net.dv8tion.jda.api.entities.Member;
+import net.dv8tion.jda.api.entities.channel.middleman.MessageChannel;
+
+import java.util.concurrent.CompletableFuture;
+
+public interface GiveawayService {
+    CompletableFuture<Void> createGiveaway(GiveawayCreationRequest giveawayCreationRequest);
+    CompletableFuture<Void> addGiveawayParticipant(Giveaway giveaway, Member member, MessageChannel messageChannel);
+    CompletableFuture<Void> evaluateGiveaway(Long giveawayId, Long serverId);
+    CompletableFuture<Void> cancelGiveaway(Long giveawayId, Long serverId);
+}

abstracto-application/abstracto-modules/giveaway/giveaway-int/src/main/java/dev/sheldan/abstracto/giveaway/service/management/GiveawayManagementService.java

@@ -0,0 +1,15 @@
+package dev.sheldan.abstracto.giveaway.service.management;
+
+import dev.sheldan.abstracto.core.models.database.AChannel;
+import dev.sheldan.abstracto.core.models.database.AUserInAServer;
+import dev.sheldan.abstracto.giveaway.model.database.Giveaway;
+
+import java.time.Instant;
+import java.util.Optional;
+
+public interface GiveawayManagementService {
+    Giveaway createGiveaway(AUserInAServer creator, AUserInAServer benefactor, AChannel target,
+                            Instant targetDate, String title, String description, Integer winnerCount, Long messageId,
+                            String componentId, Long giveawayId);
+    Optional<Giveaway> loadGiveawayById(Long giveawayId, Long serverId);
+}

abstracto-application/abstracto-modules/giveaway/giveaway-int/src/main/java/dev/sheldan/abstracto/giveaway/service/management/GiveawayParticipantManagementService.java

@@ -0,0 +1,9 @@
+package dev.sheldan.abstracto.giveaway.service.management;
+
+import dev.sheldan.abstracto.core.models.database.AUserInAServer;
+import dev.sheldan.abstracto.giveaway.model.database.Giveaway;
+
+public interface GiveawayParticipantManagementService {
+    void addParticipant(Giveaway giveaway, AUserInAServer aUserInAServer);
+    boolean userIsAlreadyParticipating(Giveaway giveaway, AUserInAServer aUserInAServer);
+}