@izara_frontend/remote-endpoint 1.0.2 → 1.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@izara_frontend/remote-endpoint",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "create standard frontend query endpoint",
   "main": "index.js",
   "type": "module",

package/src/remoteEndpoint.js

@@ -3,14 +3,15 @@ import {
 } from "@izaraFrontends/store";
 
 /**
+ * Creates a GET endpoint configuration for fetching an object based on its type.
+ * Retrieves the base URL from the store and constructs a query endpoint with POST method.
  *
- * @param {object} objType
- * @param {string} ojType.serviceTag
- * @param {string} objType.objectType
- *
- * @returns {object} query endpoint object
+ * @param {object} objType - The object type configuration.
+ * @param {string} objType.serviceTag - The service tag identifier.
+ * @param {string} objType.objectType - The object type identifier.
+ * @returns {object|null} Query endpoint object with name, type, and query configuration, or null if invalid.
  */
-export function createGetEndpoint(objType) {
+export function createGetEndpoint(objType, { customCacheKey = {} } = {}) {
   if (!validateObjType(objType)) {
     return null;
   }
@@ -34,11 +35,13 @@ export function createGetEndpoint(objType) {
             headers: headers
           }
         },
+        keepUnusedDataFor: 3600,
         serializeQueryArgs: ({ queryArgs }) => {
           return {
             ...queryArgs?.identifiers,
           };
-        }
+        },
+        ...customCacheKey
       }
     }
   } else {
@@ -48,12 +51,16 @@ export function createGetEndpoint(objType) {
 
 
 /**
+ * Creates a custom query endpoint with configurable URL path, method, and cache key.
+ * Retrieves the base URL from the store based on provided locations array.
  *
- * @param {object} objType
- * @param {string} ojType.serviceTag
- * @param {string} objType.objectType
- *
- * @returns {object} query endpoint object
+ * @param {string[]} baseUrlLocations - Array of strings representing the path to the base URL in the store slice.
+ * @param {string} endpointName - The name of the endpoint.
+ * @param {string} pathParams - The path parameters to append to the base URL.
+ * @param {string} method - The HTTP method (e.g., 'GET', 'POST', 'PUT', 'DELETE').
+ * @param {object} options - Optional configuration.
+ * @param {object} options.customCacheKey - Custom cache key configuration for query caching.
+ * @returns {object|null} Query endpoint object with name, type, and query configuration, or null if base URL not found.
  */
 export function createQueryEndpoint(baseUrlLocations = [], endpointName, pathParams, method, { customCacheKey = {} } = {}) {
   const baseUrl = getBaseUrlFromStoreSlice(baseUrlLocations);
@@ -63,7 +70,7 @@ export function createQueryEndpoint(baseUrlLocations = [], endpointName, pathPar
       name: `${endpointName}`,
       type: "query",
       query: {
-        query: ({ body, headers }) => ({
+        query: ({ body, headers = {} }) => ({
           url: `https://${baseUrl}.execute-api.us-east-2.amazonaws.com/${pathParams}`,
           method: method,
           body: { ...body },
@@ -71,6 +78,7 @@ export function createQueryEndpoint(baseUrlLocations = [], endpointName, pathPar
             ...headers
           }
         }),
+        keepUnusedDataFor: 3600,
         ...customCacheKey
       }
     }
@@ -80,12 +88,14 @@ export function createQueryEndpoint(baseUrlLocations = [], endpointName, pathPar
 }
 
 /**
+ * Creates a mutation endpoint for modifying data with configurable URL path and method.
+ * Retrieves the base URL from the store based on provided locations array.
  *
- * @param {object} objType
- * @param {string} ojType.serviceTag
- * @param {string} objType.objectType
- *
- * @returns {object} mutation endpoint object
+ * @param {string[]} baseUrlLocations - Array of strings representing the path to the base URL in the store slice.
+ * @param {string} endpointName - The name of the endpoint.
+ * @param {string} pathParams - The path parameters to append to the base URL.
+ * @param {string} method - The HTTP method (e.g., 'POST', 'PUT', 'PATCH', 'DELETE').
+ * @returns {object|null} Mutation endpoint object with name, type, and query configuration, or null if base URL not found.
  */
 export function createMutationEndpoint(baseUrlLocations = [], endpointName, pathParams, method) {
   const baseUrl = getBaseUrlFromStoreSlice(baseUrlLocations)
@@ -95,7 +105,7 @@ export function createMutationEndpoint(baseUrlLocations = [], endpointName, path
       name: `${endpointName}`,
       type: "mutation",
       query: {
-        query: (body, headers = {},) => ({
+        query: ({ body, headers = {} }) => ({
           url: `https://${baseUrl}.execute-api.us-east-2.amazonaws.com/${pathParams}`,
           method: method,
           body: { ...body },
@@ -110,6 +120,15 @@ export function createMutationEndpoint(baseUrlLocations = [], endpointName, path
   }
 }
 
+/**
+ * Validates the given object type to ensure it contains valid serviceTag and objectType properties.
+ * Both properties must be non-empty strings after trimming.
+ *
+ * @param {object} objType - The object to validate.
+ * @param {string} objType.serviceTag - The service tag string to validate.
+ * @param {string} objType.objectType - The object type string to validate.
+ * @returns {boolean} True if the object type is valid, otherwise false.
+ */
 function validateObjType(objType) {
   if (objType === null || objType === undefined) {
     return false;
@@ -141,21 +160,27 @@ function validateObjType(objType) {
   }
 }
 
-
+/**
+ * Retrieves the base URL from the store slice based on the provided location path.
+ * Traverses the store's rootConfigSlice following the path specified in baseUrlLocations array.
+ *
+ * @param {string[]} baseUrlLocations - An array of strings representing the path to the base URL in the store slice.
+ * @returns {string|null} The base URL if found, otherwise null.
+ */
 function getBaseUrlFromStoreSlice(baseUrlLocations = []) {
   const storeData = store.getState();
 
   let baseUrl = null;
   let currentSlice = storeData?.rootConfigSlice
 
-  for (const urlLocationIdx = 0; urlLocationIdx < baseUrlLocations.length; urlLocationIdx++) {
+  for (let urlLocationIdx = 0; urlLocationIdx < baseUrlLocations.length; urlLocationIdx++) {
     const baseUrlLocation = baseUrlLocations[urlLocationIdx];
 
     if (currentSlice && typeof (currentSlice) === 'object') {
       if (currentSlice.hasOwnProperty(baseUrlLocation) && urlLocationIdx !== baseUrlLocations.length - 1) {
         currentSlice = currentSlice[baseUrlLocation];
       } else if (currentSlice.hasOwnProperty(baseUrlLocation) && urlLocationIdx === baseUrlLocations.length - 1) {
-        if (typeof (currentSlice[baseUrlLocation] === 'string')) {
+        if (typeof currentSlice[baseUrlLocation] === 'string') {
           baseUrl = currentSlice[baseUrlLocation];
         }
       }