exaroton 1.8.3 → 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.8.3",
+  "version": "1.10.0",
   "description": "exaroton API client",
   "homepage": "https://exaroton.com",
   "main": "index.js",
@@ -11,7 +11,6 @@
     "node": ">=12.0.0"
   },
   "dependencies": {
-    "form-data": "^3.0.1",
     "got": "^11.8.2",
     "ws": "^7.4.5"
   }

package/src/Client.js

@@ -106,15 +106,10 @@ class Client {
     async request(request) {
         request.client = this;
         const url = this.baseURL + request.getEndpoint();
-        const headers = Object.assign({
-            "authorization": "Bearer " + this.#apiToken,
-            "user-agent": this.#userAgent
-        }, request.headers);
 
         let gotOptions = {
             method: request.method,
             retry: 0,
-            headers: headers,
             responseType: request.responseType
         };
 
@@ -122,6 +117,11 @@ class Client {
             gotOptions.body = request.getBody();
         }
 
+        gotOptions.headers = Object.assign({
+            "authorization": "Bearer " + this.#apiToken,
+            "user-agent": this.#userAgent
+        }, request.headers);
+
         let response;
         try {
             if (request.hasOutputStream()) {

package/src/Request/Request.js

@@ -1,4 +1,3 @@
-const FormData = require('form-data');
 const {createReadStream} = require('fs');
 const {createWriteStream} = require("fs");
 
@@ -149,20 +148,8 @@ class Request {
             return this.data;
         }
 
-        let body = new FormData();
-        for (let key in this.data) {
-            if (!this.data.hasOwnProperty(key)) {
-                continue;
-            }
-            if (Array.isArray(this.data[key])) {
-                for (let element of this.data[key]) {
-                    body.append(key + "[]", element);
-                }
-                continue;
-            }
-            body.append(key, this.data[key]);
-        }
-        return body;
+        this.setHeader("content-type", "application/json");
+        return JSON.stringify(this.data);
     }
 
     /**

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/Request/Server/StartServerRequest.js

@@ -2,6 +2,20 @@ const ServerRequest = require('./ServerRequest');
 
 class StartServerRequest extends ServerRequest {
     endpoint = "servers/{id}/start";
+    method = "POST";
+
+    /**
+     * StartServerRequest constructor
+     *
+     * @param {string} id
+     * @param {boolean} useOwnCredits
+     */
+    constructor(id, useOwnCredits = false) {
+        super(id);
+        this.data = {
+            useOwnCredits: useOwnCredits
+        };
+    }
 }
 
 module.exports = StartServerRequest;

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;

package/src/Server/Server.js

@@ -149,11 +149,12 @@ class Server extends EventEmitter {
     /**
      * Start the server
      *
+     * @param {boolean} useOwnCredits
      * @return {Promise<Response>}
      * @throws {RequestError}
      */
-    async start() {
-        return this.#client.request(new StartServerRequest(this.id));
+    async start(useOwnCredits = false) {
+        return this.#client.request(new StartServerRequest(this.id, useOwnCredits));
     }
 
     /**