From 47671b9a121d4f832efbee1712db7cf85aa1cb8c Mon Sep 17 00:00:00 2001 From: Neale Pickett Date: Thu, 7 Sep 2023 16:32:06 -0600 Subject: [PATCH] jsdoc fixes (maybe?) --- theme/moth.mjs | 25 +++++++++---------------- 1 file changed, 9 insertions(+), 16 deletions(-) diff --git a/theme/moth.mjs b/theme/moth.mjs index 26c5552..9369494 100644 --- a/theme/moth.mjs +++ b/theme/moth.mjs @@ -144,7 +144,7 @@ class Puzzle { * Get a resource associated with this puzzle. * * @param {String} filename Attachment/Script to retrieve - * @returns {Promise} + * @returns {Promise.} */ Get(filename) { return this.server.GetContent(this.Category, this.Points, filename) @@ -153,13 +153,6 @@ class Puzzle { /** * MOTH instance state. - * - * @property {Object} Config - * @property {Boolean} Config.Enabled Are points log updates enabled? - * @property {String} Messages Global broadcast messages, in HTML - * @property {Object.} TeamNames Mapping from IDs to team names - * @property {Object.} PointsByCategory Map from category name to open puzzle point values - * @property {Award[]} PointsLog Log of points awarded */ class State { /** @@ -190,7 +183,7 @@ class State { */ this.TeamNames = obj.TeamNames /** Map from category name to puzzle point values - * @type {Object.} */ this.PointsByCategory = obj.Puzzles /** Log of points awarded @@ -277,8 +270,8 @@ class Server { * If body is set, POST will be used instead of GET * * @param {String} path Path to API endpoint - * @param {Object} body Key/Values to send in POST data - * @returns {Promise} Response + * @param {Object.} body Key/Values to send in POST data + * @returns {Promise.} Response */ fetch(path, body) { let url = new URL(path, this.baseUrl) @@ -295,8 +288,8 @@ class Server { * Send a request to a JSend API endpoint. * * @param {String} path Path to API endpoint - * @param {Object} args Key/Values to send in POST - * @returns {Promise} JSend Data + * @param {Object.} args Key/Values to send in POST + * @returns {Promise.} JSend Data */ async call(path, args) { let resp = await this.fetch(path, args) @@ -342,7 +335,7 @@ class Server { * * @param {String} teamId * @param {String} teamName - * @returns {Promise} Success message from server + * @returns {Promise.} Success message from server */ async Register(teamId, teamName) { let data = await this.call("/login", {id: teamId, name: teamName}) @@ -361,7 +354,7 @@ class Server { * @param {String} category Category of puzzle * @param {Number} points Point value of puzzle * @param {String} answer Answer to submit - * @returns {Promise} Was the answer accepted? + * @returns {Promise.} Was the answer accepted? */ async SubmitAnswer(category, points, answer) { await this.call("/answer", {category, points, answer}) @@ -374,7 +367,7 @@ class Server { * @param {String} category Category of puzzle * @param {Number} points Point value of puzzle * @param {String} filename - * @returns {Promise} + * @returns {Promise.} */ GetContent(category, points, filename) { return this.fetch(`/content/${category}/${points}/${filename}`)