Implement dynamic session tabs (#4536)

* Session page redesign

- Link session calendar and session list together
- Add Tanstack react query
- Rewrote /v1/sessions endpoint
- Wrote logic for a generic filter that will allow easier data filtering in the future

* Datapoint endpoint

* Link player session components together

* Load player world times based on selected filters

* AFK time datapoints

* Server occupied datapoint

* Most active gamemode and world

* Small fixes

* Better date picker

* Minor fixes

- Corrected timezone offset calculations in `ServerSessionCalendarCard.tsx`.
- Updated incorrect icons and labels in `SessionAccordion.jsx`.
- Adjusted AFK time percentage calculation in `SessionQueries.java`.
- Modified `ServerRecentSessionsCard.jsx` to remove redundant `isPlayer` prop.
- Improved `DateInputField.tsx` by adding metadata usage and disabling auto-close on selection.

* Fix timezone issues with date picker

* Fix future date reading as 'Today'

* Limit server session query to 10k sessions

* Fix export of sessions endpoint

* Implement datapoint endpoints export

* Fix default datapoint permissions

* Add ServerPie datapoint

* Fix permission issues with datapoint-based graph endpoints

* Fix java date formatter Future dates showing Today

* Add missing license headers

* Fix permission patch when no group has a permission

* Fix Sql.nParameters usage when parameter list is empty

* Create plan_servers_uuid_index

* Use join to server table uuid check instead of inner query

* Fix issues

* Fix wrong exported resources

* Caching implementation for /v1/datapoint and /v1/sessions

* Remove Display_options.Sessions.Show_on_page

* Fix etag issue

* Fix javascript date formatter recent days

* Fix session table export

* Fix date picker buttons overflow on long month names

* Locale loading for DatePicker

Affects issues:
- Close #2742
- Close #4485

Author: AuroraLS3

Plan/api/src/main/java/com/djrapitops/plan/delivery/web/resolver/request/URIQuery.java

@@ -26,6 +26,7 @@
 import java.util.HashMap;
 import java.util.Map;
 import java.util.Optional;
+import java.util.function.Function;
 
 /**
  * Represents URI parameters described with {@code ?param=value&param2=value2} in the URL.
@@ -98,6 +99,10 @@ public Optional<String> get(String key) {
         return Optional.ofNullable(byKey.get(key));
     }
 
+    public <T> Optional<T> get(String key, Function<String, T> function) {
+        return get(key).map(function);
+    }
+
     public String asString() {
         if (byKey.isEmpty()) return "";
 

Plan/build.gradle

@@ -94,7 +94,7 @@ subprojects {
         junitVersion = "6.0.3"
         mockitoVersion = "5.23.0"
         seleniumVersion = "4.41.0"
-        testContainersVersion = "1.21.3"
+        testContainersVersion = "1.21.4"
         awaitilityVersion = "4.3.0"
         swaggerVersion = "2.2.45"
         guavaVersion = "33.5.0-jre"

Plan/bukkit/src/main/java/com/djrapitops/plan/PlanBukkitComponent.java

@@ -18,6 +18,7 @@
 
 import com.djrapitops.plan.addons.placeholderapi.BukkitPlaceholderRegistrar;
 import com.djrapitops.plan.commands.PlanCommand;
+import com.djrapitops.plan.delivery.rendering.json.datapoint.types.DatapointModule;
 import com.djrapitops.plan.gathering.ServerShutdownSave;
 import com.djrapitops.plan.modules.*;
 import com.djrapitops.plan.modules.bukkit.BukkitPlanModule;
@@ -44,6 +45,7 @@
         PlatformAbstractionLayerModule.class,
         FiltersModule.class,
         PlaceholderModule.class,
+        DatapointModule.class,
 
         ServerCommandModule.class,
         BukkitServerPropertiesModule.class,

Plan/bukkit/src/main/java/com/djrapitops/plan/modules/bukkit/BukkitSuperClassBindingModule.java

@@ -59,5 +59,6 @@ public interface BukkitSuperClassBindingModule {
     ServerSensor<World> bindServerSensor(BukkitSensor sensor);
 
     @Binds
+    @SuppressWarnings("java:S1452")
     ServerSensor<?> bindGenericsServerSensor(ServerSensor<World> sensor);
 }

Plan/bungeecord/src/main/java/com/djrapitops/plan/PlanBungeeComponent.java

@@ -17,6 +17,7 @@
 package com.djrapitops.plan;
 
 import com.djrapitops.plan.commands.PlanCommand;
+import com.djrapitops.plan.delivery.rendering.json.datapoint.types.DatapointModule;
 import com.djrapitops.plan.modules.*;
 import com.djrapitops.plan.modules.bungee.*;
 import com.djrapitops.plan.utilities.logging.ErrorLogger;
@@ -39,6 +40,7 @@
         PlatformAbstractionLayerModule.class,
         FiltersModule.class,
         PlaceholderModule.class,
+        DatapointModule.class,
 
         ProxySuperClassBindingModule.class,
         BungeeSuperClassBindingModule.class,

Plan/bungeecord/src/main/java/com/djrapitops/plan/modules/bungee/BungeeSuperClassBindingModule.java

@@ -40,5 +40,6 @@ public interface BungeeSuperClassBindingModule {
     ListenerSystem bindListenerSystem(BungeeListenerSystem listenerSystem);
 
     @Binds
+    @SuppressWarnings("java:S1452")
     ServerSensor<?> bindServerSensor(BungeeSensor sensor);
 }

Plan/common/src/main/java/com/djrapitops/plan/delivery/domain/OutOf.java

@@ -0,0 +1,52 @@
+/*
+ *  This file is part of Player Analytics (Plan).
+ *
+ *  Plan is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU Lesser General Public License v3 as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  Plan is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU Lesser General Public License for more details.
+ *
+ *  You should have received a copy of the GNU Lesser General Public License
+ *  along with Plan. If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.djrapitops.plan.delivery.domain;
+
+import com.djrapitops.plan.delivery.rendering.json.datapoint.Datapoint;
+
+/**
+ * @author AuroraLS3
+ */
+public class OutOf {
+    private final long value;
+    private final long max;
+    private final double percentage;
+    private final Datapoint.FormatType formatType;
+
+    public OutOf(long value, long max, Datapoint.FormatType formatType) {
+        this.value = value;
+        this.max = max;
+        this.formatType = formatType;
+        this.percentage = max != 0L ? value * 1.0 / max : 0.0;
+    }
+
+    public long getValue() {
+        return value;
+    }
+
+    public long getMax() {
+        return max;
+    }
+
+    public double getPercentage() {
+        return percentage;
+    }
+
+    public Datapoint.FormatType getFormatType() {
+        return formatType;
+    }
+}

Plan/common/src/main/java/com/djrapitops/plan/delivery/domain/OutOfCategory.java

@@ -0,0 +1,63 @@
+/*
+ *  This file is part of Player Analytics (Plan).
+ *
+ *  Plan is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU Lesser General Public License v3 as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  Plan is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU Lesser General Public License for more details.
+ *
+ *  You should have received a copy of the GNU Lesser General Public License
+ *  along with Plan. If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.djrapitops.plan.delivery.domain;
+
+import org.jspecify.annotations.Nullable;
+
+import java.util.Map;
+
+/**
+ * @author AuroraLS3
+ */
+public class OutOfCategory {
+
+    private final Map<String, Long> values;
+    private final long max;
+    @Nullable
+    private String category;
+    @Nullable
+    private Double percentage;
+
+    public OutOfCategory(Map<String, Long> values, long max) {
+        this.values = values;
+        this.max = max;
+        long biggest = 0L;
+        for (Map.Entry<String, Long> entry : values.entrySet()) {
+            if (entry.getValue() > biggest) {
+                category = entry.getKey();
+                biggest = entry.getValue();
+                percentage = max != 0L ? biggest / max : 0.0;
+            }
+        }
+    }
+
+    public Map<String, Long> getValues() {
+        return values;
+    }
+
+    public long getMax() {
+        return max;
+    }
+
+    public String getCategory() {
+        return category;
+    }
+
+    public Double getPercentage() {
+        return percentage;
+    }
+}

Plan/common/src/main/java/com/djrapitops/plan/delivery/domain/auth/WebPermission.java

@@ -47,6 +47,7 @@ public enum WebPermission implements Supplier<String>, Lang {
     PAGE_NETWORK_SESSIONS_OVERVIEW("See Session insights"),
     PAGE_NETWORK_SESSIONS_WORLD_PIE("See World Pie graph"),
     PAGE_NETWORK_SESSIONS_SERVER_PIE("See Server Pie graph"),
+    PAGE_NETWORK_SESSIONS_CALENDAR("See Network calendar"),
     PAGE_NETWORK_SESSIONS_LIST("See list of sessions"),
     PAGE_NETWORK_JOIN_ADDRESSES("See Join Addresses -tab"),
     PAGE_NETWORK_JOIN_ADDRESSES_GRAPHS("See Join Address graphs"),
@@ -83,6 +84,7 @@ public enum WebPermission implements Supplier<String>, Lang {
     PAGE_SERVER_SESSIONS("See Sessions tab"),
     PAGE_SERVER_SESSIONS_OVERVIEW("See Session insights"),
     PAGE_SERVER_SESSIONS_WORLD_PIE("See World Pie graph"),
+    PAGE_SERVER_SESSIONS_CALENDAR("See Server calendar"),
     PAGE_SERVER_SESSIONS_LIST("See list of sessions"),
     PAGE_SERVER_JOIN_ADDRESSES("See Join Addresses -tab"),
     PAGE_SERVER_JOIN_ADDRESSES_GRAPHS("See Join Address graphs"),
@@ -116,6 +118,31 @@ public enum WebPermission implements Supplier<String>, Lang {
     PAGE_PLAYER_SERVERS("See Servers -tab"),
     PAGE_PLAYER_PLUGINS("See Plugins -tabs"),
 
+    DATA("Access all data from /v1/dataPoint"),
+    DATA_PLAYER("Access all /v1/dataPoint endpoint player data. Also needs ACCESS_PLAYER or ACCESS_PLAYER_SELF."),
+    DATA_SERVER("Access all /v1/dataPoint endpoint server data"),
+    DATA_NETWORK("Access all /v1/dataPoint endpoint network data"),
+    DATA_PLAYER_PLAYTIME("See Playtime datapoint of players"),
+    DATA_SERVER_PLAYTIME("See Playtime datapoint of servers"),
+    DATA_NETWORK_PLAYTIME("See Playtime datapoint of network"),
+    DATA_PLAYER_AFK_TIME("See AFK datapoint of players"),
+    DATA_SERVER_AFK_TIME("See AFK datapoint of servers"),
+    DATA_NETWORK_AFK_TIME("See AFK datapoint of network"),
+    DATA_SERVER_SERVER_OCCUPIED("See Server occupied -datapoint of servers"),
+    DATA_NETWORK_SERVER_OCCUPIED("See Server occupied -datapoint of network"),
+    DATA_PLAYER_MOST_ACTIVE_GAME_MODE("See Most Active Gamemode -datapoint of players"),
+    DATA_SERVER_MOST_ACTIVE_GAME_MODE("See Most Active Gamemode -datapoint of servers"),
+    DATA_NETWORK_MOST_ACTIVE_GAME_MODE("See Most Active Gamemode -datapoint of network"),
+    DATA_PLAYER_MOST_ACTIVE_WORLD("See Most Active World -datapoint of players"),
+    DATA_SERVER_MOST_ACTIVE_WORLD("See Most Active World -datapoint of servers"),
+    DATA_NETWORK_MOST_ACTIVE_WORLD("See Most Active World -datapoint of network"),
+    DATA_PLAYER_WORLD_PIE("See World Pie -datapoint of players"),
+    DATA_SERVER_WORLD_PIE("See World Pie -datapoint of servers"),
+    DATA_NETWORK_WORLD_PIE("See World Pie -datapoint of network"),
+    DATA_PLAYER_SERVER_PIE("See Server Pie -datapoint of players"),
+    DATA_SERVER_SERVER_PIE("See Server Pie -datapoint of servers"),
+    DATA_NETWORK_SERVER_PIE("See Server Pie -datapoint of network"),
+
     ACCESS("Controls access to pages"),
     ACCESS_PLAYER("Allows accessing any /player pages"),
     ACCESS_PLAYER_SELF("Allows accessing own /player page"),
@@ -145,6 +172,25 @@ public enum WebPermission implements Supplier<String>, Lang {
         this.deprecated = deprecated;
     }
 
+    public static WebPermission[] nonDeprecatedValues() {
+        return Arrays.stream(values())
+                .filter(Predicate.not(WebPermission::isDeprecated))
+                .toArray(WebPermission[]::new);
+    }
+
+    public static Optional<WebPermission> findByPermission(String permission) {
+        String name = StringUtils.upperCase(permission).replace('.', '_');
+        try {
+            return Optional.of(valueOf(name));
+        } catch (IllegalArgumentException noSuchEnum) {
+            return Optional.empty();
+        }
+    }
+
+    public static boolean isDeprecated(String permission) {
+        return findByPermission(permission).map(WebPermission::isDeprecated).orElse(false);
+    }
+
     public String getPermission() {
         return StringUtils.lowerCase(name()).replace('_', '.');
     }
@@ -172,23 +218,4 @@ public String getKey() {
     public String getDefault() {
         return description;
     }
-
-    public static WebPermission[] nonDeprecatedValues() {
-        return Arrays.stream(values())
-                .filter(Predicate.not(WebPermission::isDeprecated))
-                .toArray(WebPermission[]::new);
-    }
-
-    public static Optional<WebPermission> findByPermission(String permission) {
-        String name = StringUtils.upperCase(permission).replace('.', '_');
-        try {
-            return Optional.of(valueOf(name));
-        } catch (IllegalArgumentException noSuchEnum) {
-            return Optional.empty();
-        }
-    }
-
-    public static boolean isDeprecated(String permission) {
-        return findByPermission(permission).map(WebPermission::isDeprecated).orElse(false);
-    }
 }

Plan/common/src/main/java/com/djrapitops/plan/delivery/domain/datatransfer/GenericFilter.java

@@ -0,0 +1,96 @@
+/*
+ *  This file is part of Player Analytics (Plan).
+ *
+ *  Plan is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU Lesser General Public License v3 as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  Plan is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU Lesser General Public License for more details.
+ *
+ *  You should have received a copy of the GNU Lesser General Public License
+ *  along with Plan. If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.djrapitops.plan.delivery.domain.datatransfer;
+
+import com.djrapitops.plan.delivery.web.resolver.request.URIQuery;
+import com.djrapitops.plan.identification.ServerUUID;
+import com.djrapitops.plan.utilities.dev.Untrusted;
+import com.djrapitops.plan.utilities.java.CatchingParsers;
+import org.apache.commons.lang3.StringUtils;
+import org.jspecify.annotations.Nullable;
+
+import java.util.*;
+import java.util.stream.Collectors;
+
+/**
+ * Generic filter that can be constructed from URIQuery.
+ *
+ * @author AuroraLS3
+ */
+public class GenericFilter {
+
+    private final @Nullable Long after;
+    private final @Nullable Long before;
+    private final @Untrusted List<String> serverIdentifiers;
+    private final @Nullable UUID playerUUID;
+    private List<ServerUUID> serverUUIDs;
+
+    public GenericFilter(@Untrusted URIQuery query) {
+        after = query.get("after", CatchingParsers::parseLong)
+                .orElseGet(() -> query.get("afterMillisAgo", CatchingParsers::parseLong)
+                        .map(value -> System.currentTimeMillis() - value)
+                        .orElse(null));
+        before = query.get("before", CatchingParsers::parseLong)
+                .orElseGet(() -> query.get("beforeMillisAgo", CatchingParsers::parseLong)
+                        .map(value -> System.currentTimeMillis() - value)
+                        .orElse(null));
+        serverIdentifiers = query.get("server", s -> StringUtils.split(s, ','))
+                .map(Arrays::asList)
+                .orElse(List.of());
+        serverUUIDs = serverIdentifiers.stream()
+                .map(CatchingParsers::parseServerUUID)
+                .filter(Objects::nonNull)
+                .collect(Collectors.toList());
+        playerUUID = query.get("player", CatchingParsers::parsePlayerUUID).orElse(null);
+    }
+
+    public static GenericFilter of(@Untrusted URIQuery query) {
+        return new GenericFilter(query);
+    }
+
+    public Long getAfter() {
+        return after != null ? after : 0L;
+    }
+
+    public Long getBefore() {
+        return before != null ? before : Long.MAX_VALUE;
+    }
+
+    public List<ServerUUID> getServerUUIDs() {
+        return serverUUIDs;
+    }
+
+    public void setServerUUIDs(List<ServerUUID> serverUUIDs) {
+        this.serverUUIDs = serverUUIDs;
+    }
+
+    public boolean contains(ServerUUID serverUUID) {
+        return serverUUIDs.isEmpty() || serverUUIDs.contains(serverUUID);
+    }
+
+    public @Untrusted List<String> getServerIdentifiers() {
+        return serverIdentifiers;
+    }
+
+    public boolean didAllServerIdentifiersParse() {
+        return serverIdentifiers.size() == serverUUIDs.size();
+    }
+
+    public Optional<UUID> getPlayerUUID() {
+        return Optional.ofNullable(playerUUID);
+    }
+}