Created a Discord Subscription representation as well as a method for…

src/main/java/net/dv8tion/jda/api/entities/subscription/Subscription.java

@@ -0,0 +1,122 @@
+package net.dv8tion.jda.api.entities.subscription;
+
+import net.dv8tion.jda.internal.JDAImpl;
+import net.dv8tion.jda.internal.utils.EntityString;
+
+import javax.annotation.Nonnull;
+import javax.annotation.Nullable;
+import java.time.OffsetDateTime;
+import java.util.List;
+
+/**
+ * Representation of a Discord Subscription
+ * <br> This class is immutable
+ */
+public class Subscription
+{
+    private final JDAImpl api;
+    private final long id;
+    private final long subscriberId;
+    private final List<Long> skuIDs;
+    private final List<Long> entitlementIDs;
+    private final List<Long> renewalSkuIDs;
+    private final OffsetDateTime currentPeriodStart;
+    private final OffsetDateTime currentPeriodEnd;
+    private final OffsetDateTime canceledAt;
+    private final SubscriptionStatus status;
+
+    public Subscription(@Nonnull final JDAImpl api, final long id, final long subscriberId, @Nonnull final List<Long> skuIDs,
+                        @Nonnull final List<Long> entitlementIDs, @Nullable final List<Long> renewalSkuIDs,
+                        @Nonnull final OffsetDateTime currentPeriodStart, @Nonnull final OffsetDateTime currentPeriodEnd, @Nullable final OffsetDateTime canceledAt,
+                        @Nonnull final SubscriptionStatus status)
+    {
+
+        this.api = api;
+        this.id = id;
+        this.subscriberId = subscriberId;
+        this.skuIDs = skuIDs;
+        this.entitlementIDs = entitlementIDs;
+        this.renewalSkuIDs = renewalSkuIDs;
+        this.currentPeriodStart = currentPeriodStart;
+        this.currentPeriodEnd = currentPeriodEnd;
+        this.canceledAt = canceledAt;
+        this.status = status;
+    }
+
+    public Long getId()
+    {
+        return id;
+    }
+
+    public Long getSubscriberId()
+    {
+        return subscriberId;
+    }
+
+    public List<Long> getSkuIDs()
+    {
+        return skuIDs;
+    }
+
+    public List<Long> getEntitlementIDs()
+    {
+        return entitlementIDs;
+    }
+
+    public List<Long> getRenewalSkuIDs()
+    {
+        return renewalSkuIDs;
+    }
+
+    public OffsetDateTime getCurrentPeriodStart()
+    {
+        return currentPeriodStart;
+    }
+
+    public OffsetDateTime getCurrentPeriodEnd()
+    {
+        return currentPeriodEnd;
+    }
+
+    public OffsetDateTime getCanceledAt()
+    {
+        return canceledAt;
+    }
+
+    public SubscriptionStatus getStatus()
+    {
+        return status;
+    }
+
+
+    public JDAImpl getApi()
+    {
+        return api;
+    }
+
+    @Override
+    public int hashCode()
+    {
+        return Long.hashCode(id);
+    }
+
+    @Override
+    public boolean equals(Object obj)
+    {
+        if(this == obj)
+            return true;
+        if(!(obj instanceof Subscription))
+        {
+            return false;
+        }
+        Subscription other = (Subscription) obj;
+        return other.id == this.id;
+    }
+
+    @Override
+    public String toString(){
+        return new EntityString(this)
+                .addMetadata("id", id)
+                .toString();
+    }
+}

src/main/java/net/dv8tion/jda/api/entities/subscription/SubscriptionStatus.java

@@ -0,0 +1,31 @@
+package net.dv8tion.jda.api.entities.subscription;
+
+import javax.annotation.Nonnull;
+
+/**
+ * Representation of a Discord Subscription Status
+ */
+public enum SubscriptionStatus
+{
+    UNKNOWN(-1),ACTIVE(0), ENDING(1), INACTIVE(2);
+
+    private final int id;
+
+    SubscriptionStatus(int id){
+        this.id = id;
+    }
+
+    @Nonnull
+    public static SubscriptionStatus fromKey(int id){
+        for (SubscriptionStatus status : values()){
+            if(status.id == id){
+                return status;
+            }
+        }
+        return UNKNOWN;
+    }
+
+    public int getId(){
+        return id;
+    }
+}

src/main/java/net/dv8tion/jda/internal/entities/EntityBuilder.java

@@ -48,6 +48,8 @@
 import net.dv8tion.jda.api.entities.messages.MessagePoll;
 import net.dv8tion.jda.api.entities.messages.MessageSnapshot;
 import net.dv8tion.jda.api.entities.sticker.*;
+import net.dv8tion.jda.api.entities.subscription.Subscription;
+import net.dv8tion.jda.api.entities.subscription.SubscriptionStatus;
 import net.dv8tion.jda.api.entities.templates.Template;
 import net.dv8tion.jda.api.entities.templates.TemplateChannel;
 import net.dv8tion.jda.api.entities.templates.TemplateGuild;
@@ -392,7 +394,8 @@ public GuildImpl createGuild(long guildId, DataObject guildJson, TLongObjectMap<
             LOG.error("Guild is missing a SelfMember. GuildId: {}", guildId);
             LOG.debug("Guild is missing a SelfMember. GuildId: {} JSON: \n{}", guildId, guildJson);
             // This is actually a gateway request
-            guildObj.retrieveMembersByIds(api.getSelfUser().getIdLong()).onSuccess(m -> {
+            guildObj.retrieveMembersByIds(api.getSelfUser().getIdLong()).onSuccess(m ->
+            {
                 if (m.isEmpty())
                     LOG.warn("Was unable to recover SelfMember for guild with id {}. This guild might be corrupted!", guildId);
                 else
@@ -2613,6 +2616,42 @@ public Entitlement createEntitlement(DataObject object)
         );
     }
 
+    public Subscription createSubscription(DataObject object)
+    {
+        DataArray skuIDs = object.getArray("sku_ids");
+        DataArray entitlementsIDs = object.getArray("entitlement_ids");
+        DataArray renewalSkuIDs = object.optArray("renewal_sku_ids").orElse(null);
+        OffsetDateTime canceledAt = object.getOffsetDateTime("canceled_at", null);
+
+
+        List<Long> mappedSkuIds = mapDataArrayToLongList(skuIDs);
+        List<Long> mappedEntitlementsIds = mapDataArrayToLongList(entitlementsIDs);
+        List<Long> mappedRenewalSkuIds = Optional.ofNullable(renewalSkuIDs)
+                .map(this::mapDataArrayToLongList)
+                .orElse(null);
+
+
+        return new Subscription(
+                getJDA(),
+                object.getUnsignedLong("id"),
+                object.getUnsignedLong("user_id", 0),
+                mappedSkuIds,
+                mappedEntitlementsIds,
+                mappedRenewalSkuIds,
+                object.getOffsetDateTime("current_period_start"),
+                object.getOffsetDateTime("current_period_end"),
+                canceledAt,
+                SubscriptionStatus.fromKey(object.getInt("status"))
+        );
+    }
+
+    public List<Long> mapDataArrayToLongList(DataArray dataArray)
+    {
+        return IntStream.range(0, dataArray.length())
+                .mapToObj(dataArray::getLong)
+                .collect(Collectors.toList());
+    }
+
     private Map<String, AuditLogChange> changeToMap(Set<AuditLogChange> changesList)
     {
         return changesList.stream().collect(Collectors.toMap(AuditLogChange::getKey, UnaryOperator.identity()));