From c51b209dc40613c99e3c891145d325b72e9f0b11 Mon Sep 17 00:00:00 2001 From: hay-kot Date: Mon, 29 Mar 2021 10:20:15 -0800 Subject: [PATCH] documentation --- frontend/src/api/backup.js | 31 ++++++++++++++++++++++++++----- frontend/src/api/recipe.js | 5 +++++ 2 files changed, 31 insertions(+), 5 deletions(-) diff --git a/frontend/src/api/backup.js b/frontend/src/api/backup.js index 2b00d0d03..5512f512e 100644 --- a/frontend/src/api/backup.js +++ b/frontend/src/api/backup.js @@ -14,25 +14,46 @@ const backupURLs = { }; export default { + /** + * Request all backups available on the server + * @returns {Array} List of Available Backups + */ async requestAvailable() { let response = await apiReq.get(backupURLs.available); return response.data; }, - + /** + * Calls for importing a file on the server + * @param {string} fileName + * @param {object} data + * @returns A report containing status of imported items + */ async import(fileName, data) { let response = await apiReq.post(backupURLs.importBackup(fileName), data); store.dispatch("requestRecentRecipes"); return response; }, - + /** + * Removes a file from the server + * @param {string} fileName + */ async delete(fileName) { await apiReq.delete(backupURLs.deleteBackup(fileName)); }, - - async create(data) { - let response = apiReq.post(backupURLs.createBackup, data); + /** + * Creates a backup on the serve given a set of options + * @param {object} data + * @returns + */ + async create(options) { + let response = apiReq.post(backupURLs.createBackup, options); return response; }, + /** + * Downloads a file from the server. I don't actually think this is used? + * @param {string} fileName + * @returns Download URL + */ async download(fileName) { let response = await apiReq.get(backupURLs.downloadBackup(fileName)); return response.data; diff --git a/frontend/src/api/recipe.js b/frontend/src/api/recipe.js index 225f5a81d..ea81e8910 100644 --- a/frontend/src/api/recipe.js +++ b/frontend/src/api/recipe.js @@ -19,6 +19,11 @@ const recipeURLs = { }; export default { + /** + * Create a Recipe by URL + * @param {String} recipeURL + * @returns {String} Recipe Slug + */ async createByURL(recipeURL) { let response = await apiReq.post(recipeURLs.createByURL, { url: recipeURL,