poe-api-manager 0.2.2 → 0.2.6

package/lib/modules/poe.ninja/item/itemSubmodules/functions/getData.js

@@ -1,13 +1,28 @@
 const fetchData = require("../../itemFetch/fetchItem");
 const filterProperties = require("../../../../mainfunctions/filter/propertyFilter");
 
+/**
+ * Asynchronously fetches and filters item-related data from a specified URL.
+ *
+ * @param {string} url - The URL to fetch item-related data from.
+ * @param {string} type - The type of item data to fetch.
+ * @param {Array<string>} [requestedProperties] - (Optional) An array of property names to include in the filtered result.
+ * @returns {Promise<Array<Object>|Object>} - A promise that resolves to the fetched or filtered item data.
+ * @throws {Error} - Throws an error if there's an issue fetching or processing the data.
+ */
 async function getData(url, type, requestedProperties) {
   try {
     // Fetch data using the fetchData function
+    /**
+     * @type {Array<Object>|Object} fetchedData - The fetched item data.
+     */
     const fetchedData = await fetchData(url, type);
 
     // If requestedProperties are specified, filter the data based on those properties
     if (requestedProperties) {
+      /**
+       * @type {Array<Object>|Object} result - The filtered item data based on requested properties.
+       */
       const result = filterProperties(fetchedData, requestedProperties);
       return result;
     } else {
@@ -15,6 +30,10 @@ async function getData(url, type, requestedProperties) {
       return fetchedData;
     }
   } catch (error) {
+    /**
+     * Throws an error if there's an issue fetching or processing the item data.
+     * @throws {Error}
+     */
     throw new Error(`Error fetching data: ${error.message}`);
   }
 }

package/lib/modules/poe.ninja/item/itemSubmodules/subModules/BaseTypeModule.js

@@ -1,17 +1,56 @@
 const getData = require("../functions/getData");
 
+/**
+ * Module for retrieving base type item information.
+ * @class
+ */
 class BaseTypeModule {
   #url;
   #type;
+  /**
+   * Creates a new instance of BaseTypeModule.
+   * @constructor
+   * @param {string} url - The URL for fetching base type item information.
+   */
   constructor(url) {
+    /**
+     * @type {string} #url - The URL for fetching base type item information.
+     * @private
+     */
     this.#url = url;
+
+    /**
+     * @type {string} #type - The type of item data (BaseType).
+     * @private
+     */
     this.#type = "BaseType";
   }
 
+  /**
+   * Asynchronously retrieves base type item information.
+   *
+   * @async
+   * @method
+   * @param {Array<string>} requestedProperties - An array of property names to include in the result.
+   * @returns {Promise<Array<Object>>} A promise that resolves to the fetched item data.
+   * @throws {Error} Throws an error if there's an issue with the data fetching process.
+   *
+   */
   async getData(requestedProperties) {
-    return getData(this.#url, this.#type, requestedProperties);
+    try {
+      /**
+       * Calls the getData function to fetch Base Type data.
+       * @type {Promise<Array<Object>>}
+       */
+      return getData(this.#url, this.#type, requestedProperties);
+    } catch (error) {
+      /**
+       * Throws an error if there's an issue fetching or processing the Base Type data.
+       * @throws {Error}
+       */
+      throw new Error(`Error fetching Base Type data: ${error.message}`);
+    }
   }
 }
 
-//export BaseTypeModule;
 module.exports = BaseTypeModule;

package/lib/modules/poe.ninja/item/itemSubmodules/subModules/BeastModule.js

@@ -1,17 +1,56 @@
 const getData = require("../functions/getData");
 
+/**
+ * Module for retrieving information about beasts.
+ * @class
+ */
 class BeastModule {
   #url;
   #type;
+  /**
+   * Creates a new instance of BeastModule.
+   * @constructor
+   * @param {string} url - The URL for fetching beast information.
+   */
   constructor(url) {
+    /**
+     * @type {string} #url - The URL for fetching beast information.
+     * @private
+     */
     this.#url = url;
+
+    /**
+     * @type {string} #type - The type of data (Beast).
+     * @private
+     */
     this.#type = "Beast";
   }
 
+  /**
+   * Asynchronously retrieves beast information.
+   *
+   * @async
+   * @method
+   * @param {Array<string>} requestedProperties - An array of property names to include in the result.
+   * @returns {Promise<Array<Object>>} A promise that resolves to the fetched beast data.
+   * @throws {Error} Throws an error if there's an issue with the data fetching process.
+   *
+   */
   async getData(requestedProperties) {
-    return getData(this.#url, this.#type, requestedProperties);
+    try {
+      /**
+       * Calls the getData function to fetch Beast data.
+       * @type {Promise<Array<Object>>}
+       */
+      return getData(this.#url, this.#type, requestedProperties);
+    } catch (error) {
+      /**
+       * Throws an error if there's an issue fetching or processing the Beast data.
+       * @throws {Error}
+       */
+      throw new Error(`Error fetching Beast data: ${error.message}`);
+    }
   }
 }
 
-//export BeastModule;
 module.exports = BeastModule;

package/lib/modules/poe.ninja/item/itemSubmodules/subModules/BlightRavagedMapModule.js

@@ -1,17 +1,61 @@
 const getData = require("../functions/getData");
 
+/**
+ * Represents a module for fetching data related to Blight Ravaged Maps.
+ *
+ * @class
+ */
 class BlightRavagedMapModule {
+  /**
+   * The URL for fetching data.
+   *
+   * @private
+   * @type {string}
+   */
   #url;
+
+  /**
+   * The type of data (BlightRavagedMap in this case).
+   *
+   * @private
+   * @type {string}
+   */
   #type;
+
+  /**
+   * Creates an instance of BlightRavagedMapModule.
+   *
+   * @param {string} url - The URL to fetch data from.
+   */
   constructor(url) {
     this.#url = url;
     this.#type = "BlightRavagedMap";
   }
 
+  /**
+   * Asynchronously retrieves data based on the specified properties.
+   *
+   * @async
+   * @param {Array<string>} requestedProperties - An array of properties to retrieve.
+   * @returns {Promise<Object>} A promise that resolves to the retrieved data.
+   */
   async getData(requestedProperties) {
-    return getData(this.#url, this.#type, requestedProperties);
+    try {
+      /**
+       * Calls the getData function to fetch BlightRavagedMap data.
+       *
+       * @type {Promise<Array<Object>>}
+       */
+      return getData(this.#url, this.#type, requestedProperties);
+    } catch (error) {
+      /**
+       * Throws an error if there's an issue fetching or processing the BlightRavagedMap data.
+       *
+       * @throws {Error}
+       */
+      throw new Error(`Error fetching BlightRavagedMap data: ${error.message}`);
+    }
   }
 }
 
-//export BlightRavagedMapModule;
 module.exports = BlightRavagedMapModule;

package/lib/modules/poe.ninja/item/itemSubmodules/subModules/BlightedMapModule.js

@@ -1,17 +1,58 @@
 const getData = require("../functions/getData");
 
+/**
+ * Represents a module for fetching data related to Blighted Maps.
+ *
+ * @class
+ */
 class BlightedMapModule {
+  /**
+   * The URL for fetching data.
+   *
+   * @private
+   * @type {string}
+   */
   #url;
+
+  /**
+   * The type of data (BlightedMap in this case).
+   *
+   * @private
+   * @type {string}
+   */
   #type;
+  /**
+   * Creates an instance of BlightedMapModule.
+   *
+   * @param {string} url - The URL to fetch data from.
+   */
   constructor(url) {
     this.#url = url;
     this.#type = "BlightedMap";
   }
 
+  /**
+   * Asynchronously retrieves data based on the specified properties.
+   *
+   * @async
+   * @param {Array<string>} requestedProperties - An array of properties to retrieve.
+   * @returns {Promise<Object>} A promise that resolves to the retrieved data.
+   */
   async getData(requestedProperties) {
-    return getData(this.#url, this.#type, requestedProperties);
+    try {
+      /**
+       * Calls the getData function to fetch BlightedMap data.
+       * @type {Promise<Array<Object>>}
+       */
+      return getData(this.#url, this.#type, requestedProperties);
+    } catch (error) {
+      /**
+       * Throws an error if there's an issue fetching or processing the BlightedMap data.
+       * @throws {Error}
+       */
+      throw new Error(`Error fetching BlightedMap data: ${error.message}`);
+    }
   }
 }
 
-//export BlightedMapModule;
 module.exports = BlightedMapModule;

package/lib/modules/poe.ninja/item/itemSubmodules/subModules/ClusterJewelModule.js

@@ -1,17 +1,61 @@
 const getData = require("../functions/getData");
 
+/**
+ * Represents a module for fetching data related to Cluster Jewels.
+ *
+ * @class
+ */
 class ClusterJewelModule {
+  /**
+   * The URL for fetching data.
+   *
+   * @private
+   * @type {string}
+   */
   #url;
+
+  /**
+   * The type of data (ClusterJewel in this case).
+   *
+   * @private
+   * @type {string}
+   */
   #type;
+
+  /**
+   * Creates an instance of ClusterJewelModule.
+   *
+   * @param {string} url - The URL to fetch data from.
+   */
   constructor(url) {
     this.#url = url;
     this.#type = "ClusterJewel";
   }
 
+  /**
+   * Asynchronously retrieves data based on the specified properties.
+   *
+   * @async
+   * @param {Array<string>} requestedProperties - An array of properties to retrieve.
+   * @returns {Promise<Object>} A promise that resolves to the retrieved data.
+   */
   async getData(requestedProperties) {
-    return getData(this.#url, this.#type, requestedProperties);
+    try {
+      /**
+       * Calls the getData function to fetch ClusterJewel data.
+       *
+       * @type {Promise<Array<Object>>}
+       */
+      return getData(this.#url, this.#type, requestedProperties);
+    } catch (error) {
+      /**
+       * Throws an error if there's an issue fetching or processing the ClusterJewel data.
+       *
+       * @throws {Error}
+       */
+      throw new Error(`Error fetching ClusterJewel data: ${error.message}`);
+    }
   }
 }
 
-//export ClusterJewelModule;
 module.exports = ClusterJewelModule;

package/lib/modules/poe.ninja/item/itemSubmodules/subModules/DeliriumOrbsModule.js

@@ -1,17 +1,61 @@
 const getData = require("../functions/getData");
 
+/**
+ * Represents a module for fetching data related to Delirium Orbs.
+ *
+ * @class
+ */
 class DeliriumOrbsModule {
+  /**
+   * The URL for fetching data.
+   *
+   * @private
+   * @type {string}
+   */
   #url;
+
+  /**
+   * The type of data (DeliriumOrb in this case).
+   *
+   * @private
+   * @type {string}
+   */
   #type;
+
+  /**
+   * Creates an instance of DeliriumOrbsModule.
+   *
+   * @param {string} url - The URL to fetch data from.
+   */
   constructor(url) {
     this.#url = url;
     this.#type = "DeliriumOrb";
   }
 
+  /**
+   * Asynchronously retrieves data based on the specified properties.
+   *
+   * @async
+   * @param {Array<string>} requestedProperties - An array of properties to retrieve.
+   * @returns {Promise<Object>} A promise that resolves to the retrieved data.
+   */
   async getData(requestedProperties) {
-    return getData(this.#url, this.#type, requestedProperties);
+    try {
+      /**
+       * Calls the getData function to fetch DeliriumOrb data.
+       *
+       * @type {Promise<Array<Object>>}
+       */
+      return getData(this.#url, this.#type, requestedProperties);
+    } catch (error) {
+      /**
+       * Throws an error if there's an issue fetching or processing the DeliriumOrb data.
+       *
+       * @throws {Error}
+       */
+      throw new Error(`Error fetching DeliriumOrb data: ${error.message}`);
+    }
   }
 }
 
-//export DeliriumOrbsModule;
 module.exports = DeliriumOrbsModule;

package/lib/modules/poe.ninja/item/itemSubmodules/subModules/DivinationCardModule.js

@@ -1,17 +1,61 @@
 const getData = require("../functions/getData");
 
+/**
+ * Represents a module for fetching data related to Divination Cards.
+ *
+ * @class
+ */
 class DivinationCardModule {
+  /**
+   * The URL for fetching data.
+   *
+   * @private
+   * @type {string}
+   */
   #url;
+
+  /**
+   * The type of data (DivinationCard in this case).
+   *
+   * @private
+   * @type {string}
+   */
   #type;
+
+  /**
+   * Creates an instance of DivinationCardModule.
+   *
+   * @param {string} url - The URL to fetch data from.
+   */
   constructor(url) {
     this.#url = url;
     this.#type = "DivinationCard";
   }
 
+  /**
+   * Asynchronously retrieves data based on the specified properties.
+   *
+   * @async
+   * @param {Array<string>} requestedProperties - An array of properties to retrieve.
+   * @returns {Promise<Object>} A promise that resolves to the retrieved data.
+   */
   async getData(requestedProperties) {
-    return getData(this.#url, this.#type, requestedProperties);
+    try {
+      /**
+       * Calls the getData function to fetch DivinationCard data.
+       *
+       * @type {Promise<Array<Object>>}
+       */
+      return getData(this.#url, this.#type, requestedProperties);
+    } catch (error) {
+      /**
+       * Throws an error if there's an issue fetching or processing the DivinationCard data.
+       *
+       * @throws {Error}
+       */
+      throw new Error(`Error fetching DivinationCard data: ${error.message}`);
+    }
   }
 }
 
-//export DivinationCardModule;
 module.exports = DivinationCardModule;

package/lib/modules/poe.ninja/item/itemSubmodules/subModules/EssenceModule.js

@@ -1,17 +1,61 @@
 const getData = require("../functions/getData");
 
+/**
+ * Represents a module for fetching data related to Essences.
+ *
+ * @class
+ */
 class EssenceModule {
+  /**
+   * The URL for fetching data.
+   *
+   * @private
+   * @type {string}
+   */
   #url;
+
+  /**
+   * The type of data (Essence in this case).
+   *
+   * @private
+   * @type {string}
+   */
   #type;
+
+  /**
+   * Creates an instance of EssenceModule.
+   *
+   * @param {string} url - The URL to fetch data from.
+   */
   constructor(url) {
     this.#url = url;
     this.#type = "Essence";
   }
 
+  /**
+   * Asynchronously retrieves data based on the specified properties.
+   *
+   * @async
+   * @param {Array<string>} requestedProperties - An array of properties to retrieve.
+   * @returns {Promise<Object>} A promise that resolves to the retrieved data.
+   */
   async getData(requestedProperties) {
-    return getData(this.#url, this.#type, requestedProperties);
+    try {
+      /**
+       * Calls the getData function to fetch Essence data.
+       *
+       * @type {Promise<Array<Object>>}
+       */
+      return getData(this.#url, this.#type, requestedProperties);
+    } catch (error) {
+      /**
+       * Throws an error if there's an issue fetching or processing the Essence data.
+       *
+       * @throws {Error}
+       */
+      throw new Error(`Error fetching Essence data: ${error.message}`);
+    }
   }
 }
 
-//export EssenceModule;
 module.exports = EssenceModule;

package/lib/modules/poe.ninja/item/itemSubmodules/subModules/FossilModule.js

@@ -1,17 +1,61 @@
 const getData = require("../functions/getData");
 
+/**
+ * Represents a module for fetching data related to Fossils.
+ *
+ * @class
+ */
 class FossilModule {
+  /**
+   * The URL for fetching data.
+   *
+   * @private
+   * @type {string}
+   */
   #url;
+
+  /**
+   * The type of data (Fossil in this case).
+   *
+   * @private
+   * @type {string}
+   */
   #type;
+
+  /**
+   * Creates an instance of FossilModule.
+   *
+   * @param {string} url - The URL to fetch data from.
+   */
   constructor(url) {
     this.#url = url;
     this.#type = "Fossil";
   }
 
+  /**
+   * Asynchronously retrieves data based on the specified properties.
+   *
+   * @async
+   * @param {Array<string>} requestedProperties - An array of properties to retrieve.
+   * @returns {Promise<Object>} A promise that resolves to the retrieved data.
+   */
   async getData(requestedProperties) {
-    return getData(this.#url, this.#type, requestedProperties);
+    try {
+      /**
+       * Calls the getData function to fetch Fossil data.
+       *
+       * @type {Promise<Array<Object>>}
+       */
+      return getData(this.#url, this.#type, requestedProperties);
+    } catch (error) {
+      /**
+       * Throws an error if there's an issue fetching or processing the Fossil data.
+       *
+       * @throws {Error}
+       */
+      throw new Error(`Error fetching Fossil data: ${error.message}`);
+    }
   }
 }
 
-//export FossilModule;
 module.exports = FossilModule;

package/lib/modules/poe.ninja/item/itemSubmodules/subModules/HelmetEnchantModule.js

@@ -1,17 +1,61 @@
 const getData = require("../functions/getData");
 
+/**
+ * Represents a module for fetching data related to Helmet Enchants.
+ *
+ * @class
+ */
 class HelmetEnchantModule {
+  /**
+   * The URL for fetching data.
+   *
+   * @private
+   * @type {string}
+   */
   #url;
+
+  /**
+   * The type of data (HelmetEnchant in this case).
+   *
+   * @private
+   * @type {string}
+   */
   #type;
+
+  /**
+   * Creates an instance of HelmetEnchantModule.
+   *
+   * @param {string} url - The URL to fetch data from.
+   */
   constructor(url) {
     this.#url = url;
     this.#type = "HelmetEnchant";
   }
 
+  /**
+   * Asynchronously retrieves data based on the specified properties.
+   *
+   * @async
+   * @param {Array<string>} requestedProperties - An array of properties to retrieve.
+   * @returns {Promise<Object>} A promise that resolves to the retrieved data.
+   */
   async getData(requestedProperties) {
-    return getData(this.#url, this.#type, requestedProperties);
+    try {
+      /**
+       * Calls the getData function to fetch HelmetEnchant data.
+       *
+       * @type {Promise<Array<Object>>}
+       */
+      return getData(this.#url, this.#type, requestedProperties);
+    } catch (error) {
+      /**
+       * Throws an error if there's an issue fetching or processing the HelmetEnchant data.
+       *
+       * @throws {Error}
+       */
+      throw new Error(`Error fetching HelmetEnchant data: ${error.message}`);
+    }
   }
 }
 
-//export HelmetEnchantModule;
 module.exports = HelmetEnchantModule;