exaroton 1.9.0 → 1.10.0

package/README.md

@@ -291,6 +291,40 @@ try {
 }
 ```
 
+#### Config files
+Config files are files that contain server configuration and are shown as forms rather than plain text files in the exaroton panel.
+You can get a config file object by using the `getConfig()` method on a file object.
+Whether a file is a config file can be checked using the `isConfigFile` property.
+
+```js
+let file = server.getFile("server.properties");
+let config = file.getConfig();
+```
+
+#### Get config file options
+```js
+let options = await config.getOptions();
+for(let [key, option] of options) {
+    console.log(key, option.getValue());
+}
+```
+
+#### Update config file options
+```js
+let options = await config.getOptions();
+
+options.get("max-players").setValue(26);
+options.get("pvp").setValue(false);
+
+await config.save();
+```
+
+Options of type `select` or `multiselect` have a list of possible values.
+```js
+let options = await config.getOptions();
+console.log(options.get("difficulty").getOptions());
+```
+
 ### Websocket API
 The websocket API allows a constant connection to our websocket service to receive 
 events in real time without polling (e.g. trying to get the server status every few seconds).
@@ -372,4 +406,4 @@ You can unsubscribe from one, multiple or all streams using the `server.unsubscr
 server.unsubscribe("console");
 server.unsubscribe(["tick", "heap"]);
 server.unsubscribe(); // this disconnects the websocket connection
-```
+```

package/index.js

@@ -4,5 +4,6 @@ module.exports = {
     Software: require('./src/Server/Software'),
     ServerStatus: require('./src/Server/ServerStatus'),
     Request: require('./src/Request/Request'),
-    Response: require('./src/Response/Response')
-}
+    Response: require('./src/Response/Response'),
+    ConfigOptionType: require('./src/Server/Config/ConfigOptionType')
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "exaroton",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "exaroton API client",
   "homepage": "https://exaroton.com",
   "main": "index.js",

package/src/Request/Server/Files/Config/GetConfigFileOptionsRequest.js

@@ -0,0 +1,7 @@
+const FileRequest = require("../FileRequest");
+
+class GetConfigFileOptionsRequest extends FileRequest {
+    endpoint = "servers/{id}/files/config/{path}";
+}
+
+module.exports = GetConfigFileOptionsRequest;

package/src/Request/Server/Files/Config/UpdateConfigFileOptionsRequest.js

@@ -0,0 +1,21 @@
+const FileRequest = require("../FileRequest");
+
+class UpdateConfigFileOptionsRequest extends FileRequest {
+    endpoint = "servers/{id}/files/config/{path}";
+    method = "POST";
+
+    /**
+     * UpdateConfigFileOptionsRequest constructor
+     *
+     * @param {string} id
+     * @param {string} path
+     * @param {Object.<string, string|number|boolean|string[]>} options
+     */
+    constructor(id, path, options) {
+        super(id, path);
+
+        this.data = options;
+    }
+}
+
+module.exports = UpdateConfigFileOptionsRequest;

package/src/Server/Config/Config.js

@@ -0,0 +1,115 @@
+const GetConfigFileOptionsRequest = require("../../Request/Server/Files/Config/GetConfigFileOptionsRequest");
+const UpdateConfigFileOptionsRequest = require("../../Request/Server/Files/Config/UpdateConfigFileOptionsRequest");
+const ConfigOption = require("./ConfigOption");
+
+class Config {
+    /**
+     * @type {File}
+     */
+    #file;
+
+    /**
+     * @type {null|Map<string, ConfigOption>}
+     */
+    #options = null;
+
+    /**
+     * @type {null|Map<string, ConfigOptionValue>}
+     */
+    #originalValues = null;
+
+    /**
+     * @param {File} file
+     */
+    constructor(file) {
+        this.#file = file;
+    }
+
+    /**
+     * @param {Object} object
+     * @return {this}
+     */
+    applyData(object) {
+        this.#options = new Map();
+        this.#originalValues = new Map();
+
+        if (!Array.isArray(object)) {
+            return this;
+        }
+
+        for (const option of object) {
+            if (typeof option !== "object") {
+                continue;
+            }
+
+            let {key, label, type, value, options} = option;
+            if (typeof key !== "string" || typeof label !== "string" || typeof type !== "string" || options && !Array.isArray(options)) {
+                continue;
+            }
+
+            this.#options.set(key, new ConfigOption(key, label, type, value, options));
+            this.#originalValues.set(key, value);
+        }
+        return this;
+    }
+
+    /**
+     * @return {Promise<this>}
+     */
+    async #loadOptions() {
+        const response = await this.#file.getClient().request(new GetConfigFileOptionsRequest(this.#file.getServer().id, this.#file.path));
+        this.applyData(response.getData());
+        return this;
+    }
+
+    /**
+     * @param {boolean} update
+     * @return {Promise<Map<string, ConfigOption>>}
+     */
+    async getOptions(update = false) {
+        if (update || this.#options === null) {
+            await this.#loadOptions();
+        }
+        return this.#options;
+    }
+
+    /**
+     * @param {string} key
+     * @return {Promise<ConfigOption|null>}
+     */
+    async getOption(key) {
+        const options = await this.getOptions();
+        return options.get(key) ?? null;
+    }
+
+    /**
+     * Save all changes made to this config file
+     *
+     * @return {Promise<Response|null>} null if no changes were made
+     */
+    async save() {
+        let updated = false;
+        let changed = {};
+        for (let [key, option] of this.#options) {
+            if (option.getValue() !== this.#originalValues.get(key)) {
+                updated = true;
+                changed[key] = option.getValue();
+            }
+        }
+
+        if (!updated) {
+            return null;
+        }
+
+        let response = await this.#file.getClient().request(
+            new UpdateConfigFileOptionsRequest(this.#file.getServer().id, this.#file.path, changed));
+
+        for (let [key, value] of Object.entries(changed)) {
+            this.#originalValues.set(key, value);
+        }
+
+        return response;
+    }
+}
+
+module.exports = Config;

package/src/Server/Config/ConfigOption.js

@@ -0,0 +1,103 @@
+/**
+ * @typedef {string|number|boolean|string[]} ConfigOptionValue
+ */
+
+class ConfigOption {
+    /**
+     * Key of this config option
+     *
+     * @type {string}
+     */
+    #key;
+
+    /**
+     * Label of this config option
+     *
+     * @type {string}
+     */
+    #label;
+
+    /**
+     * Option type
+     *
+     * @type {string}
+     */
+    #type;
+
+    /**
+     * Current option value
+     *
+     * @type {ConfigOptionValue}
+     */
+    #value;
+
+    /**
+     * Available options for select/multiselect
+     *
+     * @type {string[]|null}
+     */
+    #options;
+
+    /**
+     * ConfigOption constructor
+     *
+     * @param {string} key
+     * @param {string} label
+     * @param {string} type
+     * @param {ConfigOptionValue} value
+     * @param {string[]|null} options
+     */
+    constructor(key, label, type, value, options = null) {
+        this.#key = key;
+        this.#label = label;
+        this.#type = type;
+        this.#value = value;
+        this.#options = options;
+    }
+
+    /**
+     * @return {string}
+     */
+    getKey() {
+        return this.#key;
+    }
+
+    /**
+     * @return {string}
+     */
+    getLabel() {
+        return this.#label;
+    }
+
+    /**
+     * @return {string}
+     */
+    getType() {
+        return this.#type;
+    }
+
+    /**
+     * @return {ConfigOptionValue}
+     */
+    getValue() {
+        return this.#value;
+    }
+
+    /**
+     * @param {ConfigOptionValue} value
+     * @return {ConfigOption}
+     */
+    setValue(value) {
+        this.#value = value;
+        return this;
+    }
+
+    /**
+     * @return {string[]|null}
+     */
+    getOptions() {
+        return this.#options;
+    }
+}
+
+module.exports = ConfigOption;

package/src/Server/Config/ConfigOptionType.js

@@ -0,0 +1,13 @@
+/**
+ * @enum {string}
+ */
+class ConfigOptionType {
+    static STRING = "string";
+    static INTEGER = "number";
+    static FLOAT = "float";
+    static BOOLEAN = "boolean";
+    static MULTI_SELECT = "multiselect";
+    static SELECT = "select";
+}
+
+module.exports = ConfigOptionType;

package/src/Server/File.js

@@ -3,6 +3,7 @@ const GetFileDataRequest = require("../Request/Server/Files/GetFileDataRequest")
 const PutFileDataRequest = require("../Request/Server/Files/PutFileDataRequest");
 const DeleteFileDataRequest = require("../Request/Server/Files/DeleteFileDataRequest");
 const CreateDirectoryRequest = require("../Request/Server/Files/CreateDirectoryRequest");
+const Config = require("./Config/Config");
 
 class File {
     /**
@@ -60,15 +61,20 @@ class File {
     children = null;
 
     /**
-     * @type {{Server}}
+     * @type {Server}
      */
     #server;
 
     /**
-     * @type {{Client}}
+     * @type {Client}
      */
     #client;
 
+    /**
+     * @type {Config|null}
+     */
+    #config = null;
+
     /**
      * @param {string|null} path
      */
@@ -113,7 +119,7 @@ class File {
     /**
      * Set the server
      *
-     * @param server
+     * @param {Server} server
      * @returns {this}
      */
     setServer(server) {
@@ -129,7 +135,7 @@ class File {
     /**
      * Set the API client
      *
-     * @param client
+     * @param {Client} client
      * @returns {this}
      */
     setClient(client) {
@@ -142,6 +148,20 @@ class File {
         return this;
     }
 
+    /**
+     * @return {Client}
+     */
+    getClient() {
+        return this.#client;
+    }
+
+    /**
+     * @return {Server}
+     */
+    getServer() {
+        return this.#server;
+    }
+
     /**
      * Get file information from the API
      *
@@ -251,6 +271,19 @@ class File {
 
         return this.children;
     }
+
+    /**
+     * Get Config object for this file
+     * Only available if the file is a config file
+     *
+     * @return {Config}
+     */
+    getConfig() {
+        if (this.#config === null) {
+            this.#config = new Config(this);
+        }
+        return this.#config;
+    }
 }
 
-module.exports = File;
+module.exports = File;