Implement Permissions API

api/src/main/java/me/lokka30/treasury/api/permission/PermissionsProvider.java

@@ -0,0 +1,28 @@
+/*
+ * This file is/was part of Treasury. To read more information about Treasury such as its licensing, see <https://github.com/ArcanePlugins/Treasury>.
+ */
+
+package me.lokka30.treasury.api.permission;
+
+import java.util.Collection;
+import java.util.UUID;
+import java.util.concurrent.CompletableFuture;
+import me.lokka30.treasury.api.common.response.Response;
+import me.lokka30.treasury.api.permission.node.NodeFactory;
+import me.lokka30.treasury.api.permission.node.holder.NodeHolder;
+import me.lokka30.treasury.api.permission.node.holder.NodeHolderPlayer;
+import org.jetbrains.annotations.NotNull;
+
+public interface PermissionsProvider {
+
+    @NotNull NodeFactory nodeFactory();
+
+    @NotNull CompletableFuture<Response<NodeHolderPlayer>> retrievePlayerNodeHolder(@NotNull UUID uuid);
+
+    @NotNull CompletableFuture<Response<NodeHolder>> retrieveNodeHolder(@NotNull String identifier);
+
+    @NotNull CompletableFuture<Response<Collection<UUID>>> allPlayerNodeHolders();
+
+    @NotNull CompletableFuture<Response<Collection<String>>> allNodeHolders();
+
+}

api/src/main/java/me/lokka30/treasury/api/permission/context/Context.java

@@ -0,0 +1,29 @@
+/*
+ * This file is/was part of Treasury. To read more information about Treasury such as its licensing, see <https://github.com/ArcanePlugins/Treasury>.
+ */
+
+package me.lokka30.treasury.api.permission.context;
+
+import org.jetbrains.annotations.NotNull;
+
+public final class Context {
+
+    private final ContextType type;
+    private final String value;
+
+    Context(@NotNull ContextType type, @NotNull String value) {
+        this.type = type;
+        this.value = value;
+    }
+
+    @NotNull
+    public ContextType type() {
+        return this.type;
+    }
+
+    @NotNull
+    public String value() {
+        return this.value;
+    }
+
+}

api/src/main/java/me/lokka30/treasury/api/permission/context/ContextType.java

@@ -0,0 +1,42 @@
+/*
+ * This file is/was part of Treasury. To read more information about Treasury such as its licensing, see <https://github.com/ArcanePlugins/Treasury>.
+ */
+
+package me.lokka30.treasury.api.permission.context;
+
+import org.jetbrains.annotations.NotNull;
+
+public enum ContextType {
+    GLOBAL,
+    WORLD,
+    SERVER
+    ;
+
+    private static final Context global = new Context(ContextType.GLOBAL, "");
+
+    @NotNull
+    public static Context global() {
+        return global;
+    }
+
+    @NotNull
+    public static Context newContext(@NotNull ContextType type, @NotNull String value) {
+        if (type == GLOBAL) {
+            return global;
+        }
+        if (value.isEmpty()) {
+            throw new IllegalArgumentException("value is empty");
+        }
+        boolean hasSpace = false;
+        for (int i = 0; i < value.length(); i++) {
+            if (Character.isWhitespace(value.charAt(i))) {
+                hasSpace = true;
+                break;
+            }
+        }
+        if (hasSpace) {
+            throw new IllegalArgumentException("Invalid value: value should not contain spaces!");
+        }
+        return new Context(type, value);
+    }
+}

api/src/main/java/me/lokka30/treasury/api/permission/node/Node.java

@@ -0,0 +1,28 @@
+/*
+ * This file is/was part of Treasury. To read more information about Treasury such as its licensing, see <https://github.com/ArcanePlugins/Treasury>.
+ */
+
+package me.lokka30.treasury.api.permission.node;
+
+import me.lokka30.treasury.api.permission.context.Context;
+import me.lokka30.treasury.api.permission.node.type.NodeType;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+public interface Node<Data> {
+
+    @NotNull NodeType<Data> nodeType();
+
+    @NotNull Context context();
+
+    @Nullable Integer weight();
+
+    @NotNull String key();
+
+    @NotNull Data data();
+
+    @NotNull Node<Data> copyWithNewData(
+            @NotNull Context context, @Nullable Integer weight, @NotNull Data data
+    );
+
+}

api/src/main/java/me/lokka30/treasury/api/permission/node/NodeFactory.java

@@ -0,0 +1,49 @@
+/*
+ * This file is/was part of Treasury. To read more information about Treasury such as its licensing, see <https://github.com/ArcanePlugins/Treasury>.
+ */
+
+package me.lokka30.treasury.api.permission.node;
+
+import me.lokka30.treasury.api.common.misc.TriState;
+import me.lokka30.treasury.api.permission.context.Context;
+import me.lokka30.treasury.api.permission.context.ContextType;
+import me.lokka30.treasury.api.permission.node.type.PermissionNode;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+public abstract class NodeFactory {
+
+    @NotNull
+    public PermissionNode createPermissionNode(@NotNull String permission) {
+        return this.createPermissionNode(permission, ContextType.global());
+    }
+
+    public PermissionNode createPermissionNode(
+            @NotNull String permission, @NotNull Context context
+    ) {
+        return this.createPermissionNode(permission, context, (Integer) null);
+    }
+
+    @NotNull
+    public PermissionNode createPermissionNode(
+            @NotNull String permission, @NotNull Context context, @Nullable Integer weight
+    ) {
+        return this.createPermissionNode(permission, context, weight, TriState.UNSPECIFIED);
+    }
+
+    @NotNull
+    public PermissionNode createPermissionNode(
+            @NotNull String permission, @NotNull Context context, @NotNull TriState value
+    ) {
+        return this.createPermissionNode(permission, context, null, value);
+    }
+
+    @NotNull
+    public abstract PermissionNode createPermissionNode(
+            @NotNull String permission,
+            @NotNull Context context,
+            @Nullable Integer weight,
+            @NotNull TriState value
+    );
+
+}

api/src/main/java/me/lokka30/treasury/api/permission/node/holder/NodeHolder.java

@@ -0,0 +1,43 @@
+/*
+ * This file is/was part of Treasury. To read more information about Treasury such as its licensing, see <https://github.com/ArcanePlugins/Treasury>.
+ */
+
+package me.lokka30.treasury.api.permission.node.holder;
+
+import java.util.Collection;
+import java.util.Optional;
+import java.util.concurrent.CompletableFuture;
+import me.lokka30.treasury.api.common.misc.TriState;
+import me.lokka30.treasury.api.common.response.Response;
+import me.lokka30.treasury.api.permission.context.Context;
+import me.lokka30.treasury.api.permission.node.Node;
+import me.lokka30.treasury.api.permission.node.type.NodeType;
+import org.jetbrains.annotations.NotNull;
+
+public interface NodeHolder {
+
+    @NotNull String getIdentifier();
+
+    @NotNull CompletableFuture<Response<Collection<Node<?>>>> allNodes();
+
+    @NotNull <Data> CompletableFuture<Response<Collection<Node<Data>>>> allNodesWithType(@NotNull NodeType<Data> nodeType);
+
+    @NotNull CompletableFuture<Response<Collection<Node<?>>>> allNodesWithContext(@NotNull Context context);
+
+    @NotNull CompletableFuture<Response<TriState>> hasNode(@NotNull Node<?> node);
+
+    @NotNull CompletableFuture<Response<TriState>> hasNode(@NotNull String nodeKey);
+
+    @NotNull <Data> CompletableFuture<Response<Optional<Node<Data>>>> retrieveNodeWithKey(@NotNull String key);
+
+    /**
+     * Retrieves all the {@link Context contexts} this {@code NodeHolder} holds {@link Node nodes}
+     * under.
+     *
+     * @return
+     */
+    @NotNull CompletableFuture<Response<Collection<NodeHolder>>> retrieveHeldContexts();
+
+    @NotNull <Data> CompletableFuture<Response<TriState>> insertOrModifyNode(@NotNull Node<Data> node);
+
+}

api/src/main/java/me/lokka30/treasury/api/permission/node/holder/NodeHolderPlayer.java

@@ -0,0 +1,20 @@
+/*
+ * This file is/was part of Treasury. To read more information about Treasury such as its licensing, see <https://github.com/ArcanePlugins/Treasury>.
+ */
+
+package me.lokka30.treasury.api.permission.node.holder;
+
+import java.util.UUID;
+import org.jetbrains.annotations.NotNull;
+
+public interface NodeHolderPlayer extends NodeHolder {
+
+    @NotNull UUID getUniqueId();
+
+    @Override
+    @NotNull
+    default String getIdentifier() {
+        return this.getUniqueId().toString();
+    }
+
+}

api/src/main/java/me/lokka30/treasury/api/permission/node/type/NodeType.java

@@ -0,0 +1,25 @@
+/*
+ * This file is/was part of Treasury. To read more information about Treasury such as its licensing, see <https://github.com/ArcanePlugins/Treasury>.
+ */
+
+package me.lokka30.treasury.api.permission.node.type;
+
+import me.lokka30.treasury.api.common.misc.TriState;
+import org.jetbrains.annotations.NotNull;
+
+public final class NodeType<Data> {
+
+    public static final NodeType<TriState> PERMISSION = new NodeType<>(TriState.class);
+
+    private final Class<Data> dataClass;
+
+    private NodeType(@NotNull Class<Data> dataClass) {
+        this.dataClass = dataClass;
+    }
+
+    @NotNull
+    public Class<Data> dataClass() {
+        return this.dataClass;
+    }
+
+}

api/src/main/java/me/lokka30/treasury/api/permission/node/type/PermissionNode.java

@@ -0,0 +1,20 @@
+/*
+ * This file is/was part of Treasury. To read more information about Treasury such as its licensing, see <https://github.com/ArcanePlugins/Treasury>.
+ */
+
+package me.lokka30.treasury.api.permission.node.type;
+
+import me.lokka30.treasury.api.common.misc.TriState;
+import me.lokka30.treasury.api.permission.node.Node;
+import me.lokka30.treasury.api.permission.node.type.NodeType;
+import org.jetbrains.annotations.NotNull;
+
+public interface PermissionNode extends Node<TriState> {
+
+    @Override
+    @NotNull
+    default NodeType<TriState> nodeType() {
+        return NodeType.PERMISSION;
+    }
+
+}

api/src/main/java/me/lokka30/treasury/api/permission/node/type/PrefixNode.java

@@ -0,0 +1,6 @@
+package me.lokka30.treasury.api.permission.node.type;
+
+// todo
+public interface PrefixNode {
+
+}

api/src/main/java/me/lokka30/treasury/api/permission/node/type/SuffixNode.java

@@ -0,0 +1,6 @@
+package me.lokka30.treasury.api.permission.node.type;
+
+// todo
+public interface SuffixNode {
+
+}