Fix group changes via the API not properly invalidating caches (#1534)

api/src/main/java/me/lucko/luckperms/api/LuckPermsApi.java

@@ -26,10 +26,12 @@
 package me.lucko.luckperms.api;
 
 import me.lucko.luckperms.LuckPerms;
+import me.lucko.luckperms.api.caching.CachedData;
 import me.lucko.luckperms.api.context.ContextCalculator;
 import me.lucko.luckperms.api.context.ContextManager;
 import me.lucko.luckperms.api.context.ContextSet;
 import me.lucko.luckperms.api.event.EventBus;
+import me.lucko.luckperms.api.manager.CachedDataManager;
 import me.lucko.luckperms.api.manager.GroupManager;
 import me.lucko.luckperms.api.manager.TrackManager;
 import me.lucko.luckperms.api.manager.UserManager;
@@ -110,6 +112,15 @@ public interface LuckPermsApi {
      */
     @NonNull TrackManager getTrackManager();
 
+    /**
+     * Gets the {@link CachedDataManager}, responsible for managing
+     * {@link CachedData} instances.
+     *
+     * @return the cached data manager
+     * @since 4.5
+     */
+    @NonNull CachedDataManager getCachedDataManager();
+
     /**
      * Schedules the execution of an update task, and returns an encapsulation
      * of the task as a {@link CompletableFuture}.

api/src/main/java/me/lucko/luckperms/api/caching/CachedData.java

@@ -412,6 +412,14 @@ public interface CachedData {
      */
     void invalidateMeta();
 
+    /**
+     * Invalidates all cached {@link PermissionData} and {@link MetaData}
+     * instances.
+     *
+     * @since 4.5
+     */
+    void invalidate();
+
     /**
      * Invalidates all of the underlying Permission calculators.
      *

api/src/main/java/me/lucko/luckperms/api/manager/CachedDataManager.java

@@ -0,0 +1,53 @@
+/*
+ * This file is part of luckperms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package me.lucko.luckperms.api.manager;
+
+import me.lucko.luckperms.api.Group;
+import me.lucko.luckperms.api.User;
+import me.lucko.luckperms.api.caching.CachedData;
+
+/**
+ * Represents an object responsible for managing {@link CachedData} instances.
+ *
+ * @since 4.5
+ */
+public interface CachedDataManager {
+
+    /**
+     * Invalidate the {@link CachedData} instances for all loaded {@link User}s.
+     *
+     * @see CachedData#invalidate()
+     */
+    void invalidateAllUserCaches();
+
+    /**
+     * Invalidate the {@link CachedData} instances for all loaded {@link Group}s.
+     *
+     * @see CachedData#invalidate()
+     */
+    void invalidateAllGroupCaches();
+
+}